@rryando/arcs 5.1.0 → 5.2.1

package/dist/web-server/run-store.js

@@ -0,0 +1,304 @@
+/**
+ * Per-run claims — the durable spine of the stateless Ask-AI turn surface.
+ *
+ * Replaces the sessions-entity run claims (session-store's `currentRunId` +
+ * `metadata.run`) with a store keyed by RUN, not by session: per-project
+ * `runs/index.json` records every run a project spawned, and a record with no
+ * `outcome` IS the live claim. There is no thread record anywhere — a run is
+ * the only unit of persistence, and everything a client needs to continue a
+ * conversation (the end frame's `runtimeSessionId`, harvested by the fold)
+ * reaches it out of band.
+ *
+ * Concurrency: ONE live run per project. `beginRun` refuses (DagError
+ * `RUN_IN_PROGRESS`, mapped to HTTP 409 by respond.ts) while an unsettled
+ * claim holds the index — the same single overlap signal the sessions route
+ * used, renamed.
+ *
+ * Liveness survives a restart the same way it always did: the claim persists
+ * the child's pid, and `settleOrphanedRuns` (the startup sweep) probes it.
+ * Deliberately narrowed from the old reconciler: a dead pid alone no longer
+ * settles — the run's own deadline must also have passed, so a claim written
+ * by a previous server process whose child outlived the restart is left alone,
+ * and a claim whose child died mid-run settles `interrupted` exactly once.
+ */
+import { join, resolve } from "node:path";
+import { readRootMeta } from "../utils/dag.js";
+import { DagError } from "../utils/errors.js";
+import { withLock } from "../utils/file-lock.js";
+import { readJsonSafe } from "../utils/json.js";
+import { getDataDir } from "../utils/paths.js";
+import { ensureDir, writeJson } from "../utils/storage-utils.js";
+import { pruneRunEventLogs } from "./run-event-log.js";
+// ---------------------------------------------------------------------------
+// Index IO
+// ---------------------------------------------------------------------------
+/** Index path — the pattern session-store used for `sessions/index.json`. */
+export function runsIndexPath(projectDir) {
+    return join(projectDir, "runs", "index.json");
+}
+function runStoreLockPath(projectDir) {
+    return join(projectDir, "runs", ".store");
+}
+/** A decoded record that is usable as a run — anything else is dropped on
+ *  read, exactly as session-store dropped records with unknown runtime types. */
+function isRunRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const record = value;
+    if (typeof record.runId !== "string" || record.runId === "")
+        return false;
+    const startedAt = record.startedAt;
+    if (typeof startedAt !== "number" || !Number.isFinite(startedAt))
+        return false;
+    const runtimeType = record.runtimeType;
+    if (typeof runtimeType !== "string" || runtimeType === "")
+        return false;
+    return true;
+}
+async function readRunsIndex(projectDir) {
+    const index = await readJsonSafe(runsIndexPath(projectDir));
+    if (!index || !Array.isArray(index.runs))
+        return [];
+    return index.runs.filter(isRunRecord);
+}
+async function writeRunsIndex(projectDir, runs) {
+    await ensureDir(join(projectDir, "runs"));
+    await writeJson(runsIndexPath(projectDir), { runs });
+}
+/**
+ * Claims the project's one live-run slot for `runId`.
+ *
+ * Refuses with `RUN_IN_PROGRESS` (409 on the wire) while ANY unsettled claim
+ * holds the index — the atomic single-live-run gate, checked under the same
+ * lock the settle releases it under, so two overlapping POSTs cannot both win.
+ * The claim lands BEFORE the child exists: from here on, a server that dies
+ * mid-run leaves a claim behind rather than an invisible orphan, and the
+ * startup sweep is what settles it.
+ */
+export async function beginRun(projectDir, input) {
+    await ensureDir(join(projectDir, "runs"));
+    return withLock(runStoreLockPath(projectDir), async () => {
+        const runs = await readRunsIndex(projectDir);
+        const live = runs.find((run) => run.outcome === undefined);
+        if (live !== undefined) {
+            throw new DagError("RUN_IN_PROGRESS", `a run for this project is already in progress (run ${live.runId})`);
+        }
+        const pid = typeof input.pid === "number" && Number.isInteger(input.pid) && input.pid > 0
+            ? input.pid
+            : undefined;
+        const claim = {
+            runId: input.runId,
+            startedAt: Date.now(),
+            deadlineAt: input.deadlineAt,
+            runtimeType: input.runtimeType,
+            runner: input.runner,
+            logSegment: input.logSegment,
+            ...(pid !== undefined && { pid }),
+            ...(input.continueSessionId !== undefined &&
+                input.continueSessionId !== "" && {
+                continueSessionId: input.continueSessionId,
+            }),
+        };
+        runs.push(claim);
+        await writeRunsIndex(projectDir, runs);
+        return claim;
+    });
+}
+/** Records the child's pid on the claim AFTER the spawn produced one. No-op
+ *  when the claim is already gone (the run settled in the gap) — a pid write
+ *  must never resurrect a settled run. */
+export async function updateRunPid(projectDir, input) {
+    await ensureDir(join(projectDir, "runs"));
+    await withLock(runStoreLockPath(projectDir), async () => {
+        const runs = await readRunsIndex(projectDir);
+        const claim = runs.find((run) => run.runId === input.runId);
+        if (claim === undefined || claim.outcome !== undefined)
+            return;
+        claim.pid = input.pid;
+        await writeRunsIndex(projectDir, runs);
+    });
+}
+/**
+ * Stamps the outcome onto the run's claim in ONE lock acquisition — the same
+ * write that releases the claim, so "claim gone" and "outcome readable" can
+ * never disagree (the stream's end frame depends on that).
+ *
+ * Keyed on the run id: a settle whose run has already settled (a cancel that
+ * won the race, or a newer claim) is a byte-identical no-op.
+ */
+export async function settleRun(projectDir, input) {
+    await ensureDir(join(projectDir, "runs"));
+    return withLock(runStoreLockPath(projectDir), async () => {
+        const runs = await readRunsIndex(projectDir);
+        const claim = runs.find((run) => run.runId === input.runId);
+        if (claim === undefined || claim.outcome !== undefined)
+            return claim;
+        claim.outcome = input.outcome;
+        claim.endedAt = input.endedAt ?? Date.now();
+        if (input.error !== undefined)
+            claim.error = input.error;
+        if (input.replyChars !== undefined)
+            claim.replyChars = input.replyChars;
+        if (input.runtimeSessionId !== undefined)
+            claim.runtimeSessionId = input.runtimeSessionId;
+        if (input.errorCode !== undefined)
+            claim.errorCode = input.errorCode;
+        // Only ever written `true` (the runner omits the flag otherwise), so its
+        // absence on a settled record means the log is whole.
+        if (input.eventLogTruncated === true)
+            claim.eventLogTruncated = true;
+        await writeRunsIndex(projectDir, runs);
+        return claim;
+    });
+}
+/** One run record, or `undefined` when the index does not list the run id. */
+export async function getRun(projectDir, runId) {
+    const runs = await readRunsIndex(projectDir);
+    return runs.find((run) => run.runId === runId);
+}
+// ---------------------------------------------------------------------------
+// Revert state
+// ---------------------------------------------------------------------------
+/**
+ * Stamps the run's workspace changes as reverted (POST /revert), once.
+ *
+ * Refuses with `RUN_ALREADY_REVERTED` (409 on the wire) when the run has
+ * already been reverted, `RUN_NOT_FOUND` when the run is not in the index, and
+ * `RUN_NOT_SETTLED` while the run is still live — a claim in flight may still
+ * be writing, so its changes are not final and must not be reverted.
+ * Under the same lock every other mutation uses, so a second revert racing
+ * the first can never both win.
+ */
+export async function markRunReverted(projectDir, runId) {
+    await ensureDir(join(projectDir, "runs"));
+    return withLock(runStoreLockPath(projectDir), async () => {
+        const runs = await readRunsIndex(projectDir);
+        const claim = runs.find((run) => run.runId === runId);
+        if (claim === undefined) {
+            throw new DagError("RUN_NOT_FOUND", `no run "${runId}" on this project`);
+        }
+        if (claim.outcome === undefined) {
+            throw new DagError("RUN_NOT_SETTLED", `run "${runId}" is still live — only a settled run's changes can be reverted`);
+        }
+        if (claim.revertedAt !== undefined) {
+            throw new DagError("RUN_ALREADY_REVERTED", `the changes of run "${runId}" were already reverted`);
+        }
+        claim.revertedAt = Date.now();
+        await writeRunsIndex(projectDir, runs);
+        return claim;
+    });
+}
+/** The project's current in-flight run claim, or `undefined`. */
+export async function liveRun(projectDir) {
+    const runs = await readRunsIndex(projectDir);
+    return runs.find((run) => run.outcome === undefined);
+}
+// ---------------------------------------------------------------------------
+// Liveness
+// ---------------------------------------------------------------------------
+/**
+ * Whether a pid is a live process, via signal 0 (no signal delivered).
+ *
+ * SHORTCUT: pids are reused, so a recycled pid reads alive and keeps an orphan
+ * claim standing; upgrade to a start-time check (`/proc/<pid>/stat` field 22 or
+ * `ps -o lstart`) when a stuck claim is ever actually observed.
+ */
+export function isProcessAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM means the process exists but belongs to another user — alive.
+        return err?.code === "EPERM";
+    }
+}
+function orphanError(pid) {
+    return pid === undefined
+        ? "run was interrupted: no pid was recorded for it, so nothing could report how it ended"
+        : `run was interrupted: its process (pid ${pid}) is gone and never reported an outcome`;
+}
+/**
+ * Settles every run claim in a project whose process is gone AND whose
+ * deadline has passed, as `interrupted`.
+ *
+ * A claim only stands while its pid is still alive within its own deadline — a
+ * run spawned by a previous server process either outlived the restart (leave
+ * it be; it still holds the project's slot) or died with it, and a dead claim
+ * that is never cleared is a project stuck on "a run is in progress" forever.
+ * The deadline condition is what keeps a claim whose child merely outlived a
+ * crash from being settled out from under a live process.
+ *
+ * A settle here also prunes the project's run event logs, exactly as the
+ * route's own write-back does — this is the ONLY settle an interrupted run
+ * ever gets, so it is the only place that can bound the logs of a project
+ * whose runs never settle normally.
+ *
+ * Never throws: a project whose index cannot be read is skipped, and a record
+ * deleted mid-sweep is simply not settled.
+ */
+export async function settleOrphanedRuns(projectDir, options = {}) {
+    const alive = options.isAlive ?? isProcessAlive;
+    const now = options.now ?? Date.now();
+    const runs = await readRunsIndex(projectDir);
+    const settled = [];
+    for (const claim of runs) {
+        if (claim.outcome !== undefined)
+            continue;
+        if (typeof claim.pid === "number" && alive(claim.pid))
+            continue;
+        // The pid is dead (or was never recorded) — settle only once the run's own
+        // deadline has passed. A non-finite/missing deadline is treated as passed:
+        // every claim this store writes carries one, so anything else un-wedges.
+        const deadlineAt = claim.deadlineAt;
+        if (typeof deadlineAt === "number" && Number.isFinite(deadlineAt) && deadlineAt > now) {
+            continue;
+        }
+        const settledClaim = await settleRun(projectDir, {
+            runId: claim.runId,
+            outcome: "interrupted",
+            error: orphanError(claim.pid),
+            endedAt: now,
+        });
+        if (settledClaim !== undefined)
+            settled.push(settledClaim);
+        // Retention belongs to every settle, and this is the one settle path that
+        // is not a run's own write-back. A server that dies mid-run never reaches
+        // the route's prune, so a project whose runs are always interrupted would
+        // otherwise accumulate one RUN_EVENT_LOG_MAX_BYTES log per run forever.
+        try {
+            await pruneRunEventLogs(projectDir, claim.logSegment, RUN_LOG_RETENTION_KEEP);
+        }
+        catch {
+            // Pruning never throws; this catch is defensive only.
+        }
+    }
+    return settled;
+}
+/** The log-retention budget the sweep prunes to after an interrupted settle.
+ *  Mirrors run-event-log's default, stated here so the sweep cannot drift. */
+const RUN_LOG_RETENTION_KEEP = 5;
+/**
+ * Startup sweep across every registered project, keyed by RUN. Composition-time
+ * work (app.ts calls it once, fire-and-forget) — one pass, never a poller.
+ *
+ * Never throws — a data dir without a readable meta.json settles nothing,
+ * rather than taking the server down at boot.
+ */
+export async function settleOrphanedRunsOnStartup(dataDir = getDataDir(), options = {}) {
+    let slugs;
+    try {
+        slugs = (await readRootMeta(dataDir)).projects.map((project) => project.id);
+    }
+    catch {
+        return [];
+    }
+    const settled = [];
+    for (const slug of slugs) {
+        settled.push(...(await settleOrphanedRuns(resolve(dataDir, "projects", slug), options)));
+    }
+    return settled;
+}
+//# sourceMappingURL=run-store.js.map

package/dist/web-server/run-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-store.js","sourceRoot":"","sources":["../../src/web-server/run-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAkEvD,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,OAAO,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;iFACiF;AACjF,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC1E,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/E,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACvC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,UAAkB;IAC7C,MAAM,KAAK,GAAG,MAAM,YAAY,CAAW,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,UAAkB,EAAE,IAAiB;IACjE,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC;AAwBD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAkB,EAAE,KAAoB;IACrE,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,OAAO,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;QAC3D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,QAAQ,CAChB,iBAAiB,EACjB,sDAAsD,IAAI,CAAC,KAAK,GAAG,CACpE,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GACP,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC;YAC3E,CAAC,CAAC,KAAK,CAAC,GAAG;YACX,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,KAAK,GAAc;YACvB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC;YACjC,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS;gBACvC,KAAK,CAAC,iBAAiB,KAAK,EAAE,IAAI;gBAChC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;aAC3C,CAAC;SACL,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;0CAE0C;AAC1C,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAkB,EAClB,KAAqC;IAErC,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,MAAM,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO;QAC/D,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,MAAM,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAkBD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,UAAkB,EAClB,KAAqB;IAErB,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,OAAO,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACrE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9B,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5C,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACzD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACxE,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS;YAAE,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;QAC1F,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACrE,yEAAyE;QACzE,sDAAsD;QACtD,IAAI,KAAK,CAAC,iBAAiB,KAAK,IAAI;YAAE,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;QACrE,MAAM,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,UAAkB,EAAE,KAAa;IAC5D,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB,EAAE,KAAa;IACrE,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,OAAO,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,WAAW,KAAK,mBAAmB,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,QAAQ,CAChB,iBAAiB,EACjB,QAAQ,KAAK,gEAAgE,CAC9E,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,QAAQ,CAChB,sBAAsB,EACtB,uBAAuB,KAAK,yBAAyB,CACtD,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,UAAkB;IAC9C,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;AACvD,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,sEAAsE;QACtE,OAAQ,GAAoC,EAAE,IAAI,KAAK,OAAO,CAAC;IACjE,CAAC;AACH,CAAC;AAaD,SAAS,WAAW,CAAC,GAAuB;IAC1C,OAAO,GAAG,KAAK,SAAS;QACtB,CAAC,CAAC,uFAAuF;QACzF,CAAC,CAAC,yCAAyC,GAAG,yCAAyC,CAAC;AAC5F,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAkB,EAClB,UAAwB,EAAE;IAE1B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,SAAS;QAC1C,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;YAAE,SAAS;QAChE,2EAA2E;QAC3E,2EAA2E;QAC3E,yEAAyE;QACzE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;YACtF,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE;YAC/C,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC;YAC7B,OAAO,EAAE,GAAG;SACb,CAAC,CAAC;QACH,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3D,0EAA0E;QAC1E,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;QACxD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;8EAC8E;AAC9E,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,UAAkB,UAAU,EAAE,EAC9B,UAAwB,EAAE;IAE1B,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/web-server/watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/web-server/watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EACA,MAAM,GACN,WAAW,GACX,OAAO,GACP,OAAO,GACP,WAAW,GACX,UAAU,GACV,MAAM,GACN,MAAM,GACN,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAY7C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAK3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,GACnB;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAkB3D;AAiFD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,WAAW,GAAG,UAAU,CAoB1B;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAgBlC"}
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/web-server/watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EACA,MAAM,GACN,WAAW,GACX,OAAO,GACP,OAAO,GACP,WAAW,GACX,UAAU,GACV,MAAM,GACN,MAAM,GACN,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAY7C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAK3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,GACnB;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAqB3D;AAiFD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,WAAW,GAAG,UAAU,CAoB1B;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAgBlC"}

package/dist/web-server/watcher.js

@@ -45,6 +45,10 @@ export function classifyChange(relativePath) {
         return { slug, area: "proposals" };
     if (rest === "sessions" || rest.startsWith("sessions/"))
         return { slug, area: "sessions" };
+    // The run store is the ask surface's persistence — the client's invalidation
+    // path keys on the `sessions` area, so run claims/settles keep triggering it.
+    if (rest === "runs" || rest.startsWith("runs/"))
+        return { slug, area: "sessions" };
     if (rest === "meta.json")
         return { slug, area: "meta" };
     if (rest.endsWith(".md"))

package/dist/web-server/watcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/web-server/watcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/web-server/watcher.ts"],"names":[],"mappings":"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"}

package/opencode/arcs/manifest.json

@@ -13,7 +13,7 @@
       "status": "active",
       "kind": "subagent",
       "tier": "heavy",
-      "modes": ["opencode", "claudecode"],
+      "modes": ["opencode", "claudecode", "pi"],
       "source": "prompts/software-engineer.txt",
       "destination": "prompts/software-engineer.txt",
       "description": "Implementation specialist. Writes code, runs tests, and ships verified work using orchestrator-selected implementation bounded or inspect mode.",
@@ -30,7 +30,7 @@
       "status": "active",
       "kind": "subagent",
       "tier": "heavy",
-      "modes": ["opencode", "claudecode"],
+      "modes": ["opencode", "claudecode", "pi"],
       "source": "prompts/tech-architect.txt",
       "destination": "prompts/tech-architect.txt",
       "description": "Architecture, analysis, and cited research specialist. Produces read-only structural guidance, trade-off evaluation, and DAG-first research synthesis.",
@@ -65,7 +65,7 @@
       "status": "active",
       "kind": "subagent",
       "tier": "standard",
-      "modes": ["opencode", "claudecode"],
+      "modes": ["opencode", "claudecode", "pi"],
       "source": "prompts/arcs-docs.txt",
       "destination": "prompts/arcs-docs.txt",
       "description": "ARCS documentation specialist. Manages plans, knowledge entries, diagrams, and DAG health. Knows ARCS structure intimately.",
@@ -82,7 +82,7 @@
       "status": "active",
       "kind": "subagent",
       "tier": "standard",
-      "modes": ["opencode", "claudecode"],
+      "modes": ["opencode", "claudecode", "pi"],
       "source": "prompts/code-reviewer.txt",
       "destination": "prompts/code-reviewer.txt",
       "description": "Reviews code changes for production readiness and catches correctness, maintainability, and testing issues.",
@@ -135,7 +135,7 @@
       "status": "active",
       "kind": "subagent",
       "tier": "light",
-      "modes": ["opencode", "claudecode"],
+      "modes": ["opencode", "claudecode", "pi"],
       "source": "prompts/graph-explorer.txt",
       "destination": "prompts/graph-explorer.txt",
       "description": "DAG-first codebase and knowledge exploration specialist. Queries arcs search, related, and context first, then codegraph MCP code-intelligence tools, before falling back to raw file-system tools. Replaces vanilla explore for ARCS projects.",
@@ -152,7 +152,7 @@
       "status": "active",
       "kind": "primary",
       "tier": "standard",
-      "modes": ["opencode", "claudecode"],
+      "modes": ["opencode", "claudecode", "pi"],
       "source": "prompts/arcs-orchestrate.txt",
       "destination": "prompts/arcs-orchestrate.txt",
       "description": "The central coordinator for executing plans, managing agent dispatch, and handling DAG workflows.",
@@ -169,7 +169,7 @@
       "status": "active",
       "kind": "primary",
       "tier": "standard",
-      "modes": ["opencode", "claudecode"],
+      "modes": ["opencode", "claudecode", "pi"],
       "source": "prompts/arcs-orchestrate-caveman.txt",
       "destination": "prompts/arcs-orchestrate-caveman.txt",
       "description": "A terse, high-efficiency orchestrator that drives tasks without extra commentary.",
@@ -186,7 +186,7 @@
       "status": "active",
       "kind": "primary",
       "tier": "standard",
-      "modes": ["opencode", "claudecode"],
+      "modes": ["opencode", "claudecode", "pi"],
       "source": "prompts/arcs-flash.txt",
       "destination": "prompts/arcs-flash.txt",
       "description": "A speed-optimized orchestrator that sources context from arcs knowledge first and maximizes parallel sub-agent dispatch under tiered gates.",

package/opencode/arcs/prompts/arcs-orchestrate-caveman.txt

@@ -81,7 +81,7 @@ Available skills: `implementation`, `test-driven-development`, `systematic-debug
 
 ## Design, Proposals, and Plans
 
-For architecture-changing, large-feature, or cross-cutting work, delegate the proposal doc to `tech-architect` with the `writing-proposals` skill, stored in `docs/proposals/`. Iterate with the user until approval, then delegate plan creation to `arcs-docs` with the `writing-plans` skill.
+For architecture-changing, large-feature, or cross-cutting work, delegate the proposal doc to `tech-architect` with the `writing-proposals` skill, stored in the data dir under `projects/<slug>/proposals/`, not the workspace. Iterate with the user until approval, then delegate plan creation to `arcs-docs` with the `writing-plans` skill.
 
 For broad multi-step or explicitly requested plans, delegate plan creation directly. Resolve material choices with the user; do not ask about details that repository evidence or convention settles.
 

package/opencode/arcs/prompts/arcs-orchestrate.txt

@@ -75,7 +75,7 @@ Available skills: `implementation`, `test-driven-development`, `systematic-debug
 
 ## Design, Proposals, and Plans
 
-For architecture-changing, large-feature, or cross-cutting work, delegate the proposal doc to `tech-architect` with the `writing-proposals` skill, stored in `docs/proposals/`. Iterate with the user until approval, then delegate plan creation to `arcs-docs` with the `writing-plans` skill.
+For architecture-changing, large-feature, or cross-cutting work, delegate the proposal doc to `tech-architect` with the `writing-proposals` skill, stored in the data dir under `projects/<slug>/proposals/`, not the workspace. Iterate with the user until approval, then delegate plan creation to `arcs-docs` with the `writing-plans` skill.
 
 For broad multi-step or explicitly requested plans, delegate plan creation directly. Resolve material choices with the user; do not ask about details that repository evidence or convention settles.
 

package/opencode/arcs/skills/writing-proposals/SKILL.md

@@ -28,9 +28,12 @@ the handoff to stage two, then delegates explicitly.
 
 ## CLI
 
-All proposal doc operations use the `arcs proposal-doc` command group:
+All proposal doc operations use the `arcs proposal-doc` command group. Documents
+are stored in the ARCS data dir under `projects/<slug>/proposals/` (not the
+workspace); workspace `docs/proposals/` files are ignored by tooling (no
+migration):
 
-- `arcs proposal-doc create <slug> "<title>"` — scaffold `docs/proposals/<id>.proposal.md`
+- `arcs proposal-doc create <slug> "<title>"` — scaffold `proposals/<id>.proposal.md` in the project data dir
 - `arcs proposal-doc list <slug>` — list pending proposals (both `.proposal.md` files)
 - `arcs proposal-doc get <slug> <id>` — view body text of a proposal (pending or accepted)
 - `arcs proposal-doc edit <slug> <id> --body="..."` — replace body text
@@ -43,7 +46,7 @@ All proposal doc operations use the `arcs proposal-doc` command group:
    (`arcs brief`, knowledge search). A proposal grounded only in the request
    text is a guess, not a proposal.
 2. **Draft** with `arcs proposal-doc create <slug> "<title>"`. This scaffolds
-   `docs/proposals/<kebab-id>.proposal.md` with the required sections:
+   `proposals/<kebab-id>.proposal.md` under the project's data dir with the required sections:
    - **Goal** — the outcome in one paragraph.
    - **Motivation / non-goals** — why now, what is explicitly out of scope.
    - **Current state** — how it works today, with file/symbol references.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rryando/arcs",
-  "version": "5.1.0",
+  "version": "5.2.1",
   "description": "ARCS — DAG-based task orchestration for AI agents. Persistent workflow continuity via graph-structured context.",
   "type": "module",
   "main": "dist/index.js",

package/scripts/deploy-claudecode-bundle.mjs

@@ -106,7 +106,7 @@ function resolveBundlePromptPath(value) {
 // ---------------------------------------------------------------------------
 // Model tier configuration
 // ---------------------------------------------------------------------------
-// Env vars: DEPLOY_MODEL_HEAVY, DEPLOY_MODEL_STANDARD, DEPLOY_MODEL_LIGHT
+// Env vars: DEPLOY_MODEL_HEAVY, DEPLOY_MODEL_STANDARD, DEPLOY_MODEL_LIGHT.
 // Each defaults to "inherit" if unset.
 const tierModels = {
   heavy: process.env.DEPLOY_MODEL_HEAVY || "inherit",
@@ -134,7 +134,7 @@ function readAgentRegistry() {
       ["heavy", "standard", "light"].includes(agent.tier) &&
       Array.isArray(agent.modes) &&
       agent.modes.length > 0 &&
-      agent.modes.every((mode) => ["opencode", "claudecode"].includes(mode)) &&
+      agent.modes.every((mode) => ["opencode", "claudecode", "pi"].includes(mode)) &&
       isPromptPath(agent.source) &&
       isPromptPath(agent.destination) &&
       typeof agent.description === "string" &&

package/scripts/deploy-opencode-bundle.mjs

@@ -137,7 +137,7 @@ function validateAgentRegistry(agents) {
     if (
       !Array.isArray(agent.modes) ||
       agent.modes.length === 0 ||
-      agent.modes.some((mode) => mode !== "opencode" && mode !== "claudecode")
+      agent.modes.some((mode) => mode !== "opencode" && mode !== "claudecode" && mode !== "pi")
     ) {
       throw new Error(`Invalid agent registry modes for ${agent.id}`);
     }