feat: 打通 v0.1 runner job 正式路径

src/mgr/postgres-store.ts

@@ -6,7 +6,7 @@ import { redactJson } from "../common/redaction.js";
 import type { BackendProfile, BackendTurnResult, CommandRecord, CommandState, CreateCommandInput, CreateRunInput, EventType, FailureKind, JsonRecord, JsonValue, RunEvent, RunnerRecord, RunRecord, RunStatus, TerminalStatus } from "../common/types.js";
 import { newId, nowIso, stableHash } from "../common/validation.js";
 import type { AgentRunStore, StoreHealth } from "./store.js";
-import { statusFromTerminal } from "./store.js";
+import { commandStateFromTerminal, statusFromTerminal } from "./store.js";
 
 interface PostgresStoreOptions {
   connectionString: string;
@@ -308,6 +308,19 @@ CREATE TABLE IF NOT EXISTS agentrun_schema_migrations (
     return commandFromRow(row);
   }
 
+  async finishCommand(commandId: string, result: Pick<BackendTurnResult, "terminalStatus" | "failureKind" | "failureMessage">): Promise<CommandRecord> {
+    return this.withTransaction(async (client) => {
+      const existing = await client.query("SELECT * FROM agentrun_commands WHERE id = $1 FOR UPDATE", [commandId]);
+      const row = existing.rows[0];
+      if (!row) throw new AgentRunError("schema-invalid", `command ${commandId} was not found`, { httpStatus: 404 });
+      const command = commandFromRow(row);
+      const state = commandStateFromTerminal(result.terminalStatus);
+      const updated = await client.query("UPDATE agentrun_commands SET state = $2, updated_at = $3 WHERE id = $1 RETURNING *", [commandId, state, nowIso()]);
+      await this.appendEventWithLockedRun(client, command.runId, "backend_status", { phase: "command-terminal", commandId, state, terminalStatus: result.terminalStatus, failureKind: result.failureKind });
+      return commandFromRow(updated.rows[0]);
+    });
+  }
+
   async appendEvent(runId: string, type: EventType, payload: JsonRecord): Promise<RunEvent> {
     return this.withTransaction(async (client) => {
       await this.requireRunForUpdate(client, runId);