fix(backend): robustness pass — spawn leak, timeouts, workspace fail-loud, 409 order, respond guard

Audit findings 4.1-4.6.

- spawnFor: a rejected configure/start no longer leaks a registered runtime
  with a live Pi child (identity-checked teardown + rethrow); every later
  start used to hit "session runtime already active".
- ThtRunner.run: default 60s timeout on every tht child (SIGKILL backstop),
  120s for DWH-touching calls (sql preview/export, search pack); a dropped
  VPN mid-call no longer wedges the HTTP request forever.
- configArg: a NAMED workspace whose yaml is missing now throws instead of
  silently falling back to the default config (operations were silently
  targeting the wrong workspace).
- resume: the finalized/archived 409 is evaluated BEFORE the alreadyActive
  fast-path — the manifest is the truth even with a lingering runtime.
- ollamaEnsure: exit-0 with non-JSON stdout is a failed check, not ok:true.
- SessionBridge.respond: only the response matching the pending descriptor
  is forwarded to Pi; stale/duplicate submissions return 409 instead of
  being sent with the current gate's RPC id.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-20 01:37:20 +02:00
co-authored by Claude Fable 5
parent 2958b32fd5
commit f772ef9dca
7 changed files with 92 additions and 34 deletions
+34 -15
View File
@@ -44,12 +44,15 @@ export class ThtRunner {
withPrincipal(principal: PrincipalContext): ThtRunner { return new ThtRunner(this.cfg, principal); }
/**
* Resolve the `-c <config>` args. If `workspace` is given AND a matching
* `workspaces/<workspace>.yaml` exists under harnessDir, select it; otherwise
* fall back to the default configPath.
* Resolve the `-c <config>` args. A named workspace MUST exist: silently falling
* back to the default config would point every operation at the wrong workspace
* (wrong DB, wrong sessions dir) — fail loud instead.
*/
private configArg(workspace?: string): string[] {
if (workspace && existsSync(join(this.cfg.harnessDir, "workspaces", `${workspace}.yaml`))) {
if (workspace) {
if (!existsSync(join(this.cfg.harnessDir, "workspaces", `${workspace}.yaml`))) {
throw new Error(`workspace non trovato: workspaces/${workspace}.yaml (harness: ${this.cfg.harnessDir})`);
}
return ["-c", `workspaces/${workspace}.yaml`];
}
return ["-c", this.cfg.configPath];
@@ -64,8 +67,14 @@ export class ThtRunner {
return [...args, ...this.configArg(workspace)];
}
// Every route awaits these children; without a ceiling, one hung DWH/vector call
// (dropped VPN mid-connect) wedges its HTTP request forever. Session/file commands
// get the default; DWH-touching commands pass a wider explicit budget.
static readonly DEFAULT_TIMEOUT_MS = 60_000;
static readonly DWH_TIMEOUT_MS = 120_000;
run(
args: string[], workspace?: string, timeoutMs?: number,
args: string[], workspace?: string, timeoutMs: number = ThtRunner.DEFAULT_TIMEOUT_MS,
): Promise<{ code: number; stdout: string; stderr: string }> {
return new Promise((resolve) => {
const env: NodeJS.ProcessEnv = { ...process.env };
@@ -100,8 +109,8 @@ export class ThtRunner {
});
}
private async json<T>(args: string[], workspace?: string): Promise<T> {
const { code, stdout, stderr } = await this.run(args, workspace);
private async json<T>(args: string[], workspace?: string, timeoutMs?: number): Promise<T> {
const { code, stdout, stderr } = await this.run(args, workspace, timeoutMs);
if (code !== 0) throw new Error(`tht ${args.join(" ")} exit ${code}: ${stderr.trim()}`);
return JSON.parse(stdout) as T;
}
@@ -135,7 +144,7 @@ export class ThtRunner {
/** Build and persist the deterministic F1 retrieval pack for a new session. */
async searchPack(question: string, sessionId: string, workspace?: string): Promise<void> {
const args = ["search", "pack", question, "--session", sessionId];
const { code, stderr } = await this.run(args, workspace);
const { code, stderr } = await this.run(args, workspace, ThtRunner.DWH_TIMEOUT_MS);
if (code !== 0) throw new Error(`tht ${args.join(" ")} exit ${code}: ${stderr.trim()}`);
}
@@ -169,11 +178,13 @@ export class ThtRunner {
rows: unknown[][];
execution_ms: number;
truncated: boolean;
}>(a, workspace);
}>(a, workspace, ThtRunner.DWH_TIMEOUT_MS);
}
async sqlExport(id: string, workspace?: string) {
const { code, stdout, stderr } = await this.run(["sql", "export", "--session", id], workspace);
const { code, stdout, stderr } = await this.run(
["sql", "export", "--session", id], workspace, ThtRunner.DWH_TIMEOUT_MS,
);
if (code !== 0) throw new Error(`tht sql export exit ${code}: ${stderr.trim()}`);
return { path: stdout.trim() };
}
@@ -197,17 +208,25 @@ export class ThtRunner {
}
async ollamaEnsure(workspace: string, timeoutSec: number): Promise<OllamaEnsureResult> {
// Process budget wider than the CLI's own --timeout so the CLI reports its
// failure itself; SIGKILL is only the backstop for a wedged child.
const { code, stdout, stderr } = await this.run(
["ollama", "ensure", "--json", "--timeout", String(timeoutSec)],
workspace,
timeoutSec * 1000 + 30_000,
);
let parsed: Partial<OllamaEnsureResult> = {};
try { parsed = JSON.parse(stdout.trim() || "{}"); } catch { /* leave {} */ }
if (code === 0) return { ok: true, ...parsed };
let parsed: Partial<OllamaEnsureResult> | null = null;
try { parsed = JSON.parse(stdout.trim()); } catch { /* not JSON */ }
// Exit 0 with unparseable output is NOT a verified readiness: --json promises
// pristine JSON, so treat the violation as a failed check, never as ok.
if (code === 0 && parsed !== null) return { ok: true, ...parsed };
if (code === 0) {
return { ok: false, error: `tht ollama ensure: output non-JSON: ${stdout.trim().slice(0, 200)}` };
}
return {
ok: false,
stage: parsed.stage,
error: parsed.error ?? (stderr.trim() || `tht ollama ensure exit ${code}`),
stage: parsed?.stage,
error: parsed?.error ?? (stderr.trim() || `tht ollama ensure exit ${code}`),
};
}
}