@claudexor/orchestrator 2.1.2 → 3.0.0

package/dist/continuity-facts.js

@@ -0,0 +1,100 @@
+/**
+ * Continuity FACTS (INV-137): the I/O-bearing helpers that feed the pure packet
+ * builder (`continuity.ts`) — the active-plan pointer, the git workspace anchor,
+ * and the cached-or-fresh LLM summary resolution. Split out of the orchestrator
+ * so the engine's chat surface stays under the readability ratchet; each is a
+ * free function taking explicit, already-resolved inputs (no orchestrator
+ * `this`), so they are directly unit-testable.
+ */
+import { join } from "node:path";
+import { PlanQuestionsArtifact, derivePlanReadiness, } from "@claudexor/schema";
+import { readTextSafe } from "@claudexor/util";
+import { readThreadSummary, revParse, statusPorcelain, writeThreadSummary, } from "@claudexor/workspace";
+import { planContinuation, } from "./continuity.js";
+import { summarizeThreadPrefix } from "./continuity-summary.js";
+/** The thread's most recent readable plan pointer (INV-137 packet section). */
+export function activePlanPointer(priorTurns, store) {
+    for (let i = priorTurns.length - 1; i >= 0; i -= 1) {
+        const runId = priorTurns[i].runId;
+        if (!runId)
+            continue;
+        const finalDir = store.runPaths(runId).finalDir;
+        const planText = readTextSafe(join(finalDir, "plan.md"));
+        if (!planText || !planText.trim())
+            continue;
+        const questions = readTextSafe(join(finalDir, "questions.json"));
+        let readiness = "unverified";
+        if (questions) {
+            try {
+                readiness = derivePlanReadiness(PlanQuestionsArtifact.parse(JSON.parse(questions))).state;
+            }
+            catch {
+                readiness = "unverified";
+            }
+        }
+        return { path: join(finalDir, "plan.md"), readiness, planRunId: runId };
+    }
+    return null;
+}
+/** HEAD sha + dirty file count for the packet's workspace anchor. Best-effort:
+ * a non-git or unborn tree yields a null sha / zero dirty count, never a throw. */
+export async function workspaceAnchor(repoRoot) {
+    let headSha = null;
+    try {
+        headSha = await revParse(repoRoot, "HEAD");
+    }
+    catch {
+        headSha = null;
+    }
+    let dirtyCount = 0;
+    try {
+        dirtyCount = (await statusPorcelain(repoRoot)).split("\n").filter((l) => l.trim()).length;
+    }
+    catch {
+        dirtyCount = 0;
+    }
+    return { headSha, dirtyCount };
+}
+/**
+ * Resolve the cached-or-fresh LLM summary for a packet's collapsed prefix
+ * (INV-137, V9c). Returns the summary to inject, or null when the packet does
+ * not collapse, no adapter is available, or summarization fails/times out — in
+ * every null case the caller keeps the mechanical one-liner collapse. Owns its
+ * OWN try/catch: a summary failure must never drop the whole packet.
+ */
+export async function resolveContinuitySummary(inputs) {
+    if (!inputs.threadId)
+        return null;
+    try {
+        const plan = planContinuation(inputs.req);
+        // Only a budget-forced collapse needs a summary; nothing to collapse → skip.
+        if (plan.kind !== "packet" || !plan.summaryUpToTurnId)
+            return null;
+        const { threadId, projectRoot } = inputs;
+        const upToTurnId = plan.summaryUpToTurnId;
+        // Cache hit: reuse until the collapse boundary (upToTurnId) advances.
+        const cached = readThreadSummary(projectRoot, threadId, upToTurnId);
+        if (cached)
+            return { upToTurnId, text: cached };
+        if (!inputs.adapter)
+            return null;
+        const text = await summarizeThreadPrefix({
+            adapter: inputs.adapter,
+            turns: plan.collapsedPrefix,
+            cwd: inputs.cwd,
+            env: inputs.laneEnv,
+            credentialProfile: inputs.credentialProfile,
+            authPreference: inputs.authPreference,
+            envInheritance: inputs.envInheritance,
+            signal: inputs.signal,
+        });
+        if (!text)
+            return null;
+        writeThreadSummary(projectRoot, threadId, upToTurnId, text);
+        return { upToTurnId, text };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=continuity-facts.js.map

package/dist/continuity-facts.js.map

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

package/dist/continuity-summary.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Bounded inline continuation summariser (INV-137, V9c).
+ *
+ * When a continuation packet must collapse an older prefix and no fresh cached
+ * summary covers it, the orchestrator runs ONE bounded read-only summarisation
+ * pass over the collapsed turns — ask-mode intent, the thread's primary harness,
+ * the lane's own credential route + scoped home, a hard timeout, and a single
+ * turn. Success replaces the mechanical one-liner collapse with real prose;
+ * failure/timeout/unavailable falls back to the one-liners (which always work).
+ *
+ * This is deliberately NOT a run: it opens no run dir, records no native
+ * session, and emits no run events — it must never masquerade as a user turn.
+ * It reuses the same credential-profile + scoped-home + env-inheritance route a
+ * real read-only thread turn uses, so it authenticates identically and consumes
+ * quota honestly (the disclosure's `summarized` flag already tells the user the
+ * prefix was condensed).
+ */
+import { type CredentialProfile } from "@claudexor/schema";
+import { type HarnessAdapter } from "@claudexor/core";
+import type { ContinuityTurn } from "./continuity.js";
+/** Default wall-clock ceiling for one inline summary pass. */
+export declare const SUMMARY_TIMEOUT_MS = 60000;
+export interface SummaryRunParams {
+    adapter: HarnessAdapter;
+    /** The collapsed older-prefix turns to summarise (oldest → newest). */
+    turns: ContinuityTurn[];
+    /** Read-only working directory (the thread's execution root). */
+    cwd: string;
+    /** Scoped lane-home env so the pass authenticates on the lane's own account. */
+    env: Record<string, string>;
+    /** Resolved credential profile for the lane (null = engine default ladder). */
+    credentialProfile: CredentialProfile | null;
+    authPreference: "subscription" | "api_key" | "auto";
+    envInheritance: "mirror_native" | "clean";
+    /** Upper bound on the pass; the caller's run signal aborts it too. */
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Run one bounded summary pass. Returns the summary text, or null on any
+ * failure/timeout/empty answer (the caller then keeps the mechanical collapse).
+ * Never throws.
+ */
+export declare function summarizeThreadPrefix(params: SummaryRunParams): Promise<string | null>;
+//# sourceMappingURL=continuity-summary.d.ts.map

package/dist/continuity-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuity-summary.d.ts","sourceRoot":"","sources":["../src/continuity-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAMzC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,cAAc,CAAC;IACxB,uEAAuE;IACvE,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,+EAA+E;IAC/E,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,cAAc,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC;IACpD,cAAc,EAAE,eAAe,GAAG,OAAO,CAAC;IAC1C,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA2BD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmD5F"}

package/dist/continuity-summary.js

@@ -0,0 +1,113 @@
+/**
+ * Bounded inline continuation summariser (INV-137, V9c).
+ *
+ * When a continuation packet must collapse an older prefix and no fresh cached
+ * summary covers it, the orchestrator runs ONE bounded read-only summarisation
+ * pass over the collapsed turns — ask-mode intent, the thread's primary harness,
+ * the lane's own credential route + scoped home, a hard timeout, and a single
+ * turn. Success replaces the mechanical one-liner collapse with real prose;
+ * failure/timeout/unavailable falls back to the one-liners (which always work).
+ *
+ * This is deliberately NOT a run: it opens no run dir, records no native
+ * session, and emits no run events — it must never masquerade as a user turn.
+ * It reuses the same credential-profile + scoped-home + env-inheritance route a
+ * real read-only thread turn uses, so it authenticates identically and consumes
+ * quota honestly (the disclosure's `summarized` flag already tells the user the
+ * prefix was condensed).
+ */
+import { HarnessRunSpec, } from "@claudexor/schema";
+import { AnswerAssembly } from "@claudexor/core";
+/** Default wall-clock ceiling for one inline summary pass. */
+export const SUMMARY_TIMEOUT_MS = 60_000;
+/** Bytes of each collapsed turn fed to the summariser (prompt + output halves). */
+const PER_TURN_INPUT_BYTES = 4 * 1024;
+/** Bytes retained from the summary answer. */
+const MAX_SUMMARY_BYTES = 8 * 1024;
+function boundBytes(text, maxBytes) {
+    const buf = Buffer.from(text, "utf8");
+    if (buf.length <= maxBytes)
+        return text;
+    return `${buf.subarray(0, maxBytes).toString("utf8")}…`;
+}
+/** Render the collapsed prefix as the summariser's input transcript. */
+function transcript(turns) {
+    return turns
+        .map((t, i) => {
+        const prompt = boundBytes(t.prompt.trim(), PER_TURN_INPUT_BYTES / 2);
+        const output = t.outputText.trim()
+            ? boundBytes(t.outputText.trim(), PER_TURN_INPUT_BYTES / 2)
+            : "(no recorded answer)";
+        return `Turn ${i + 1}\nUser: ${prompt}\nAssistant: ${output}`;
+    })
+        .join("\n\n");
+}
+const SUMMARY_INSTRUCTION = "You are handing this conversation off to a successor agent that has NOT seen it. " +
+    "Summarize the earlier turns below for that agent: the decisions reached, the current " +
+    "state of the work, and the open items still to do. Be concise and factual — no preamble, " +
+    "no questions, no tool calls. Output only the summary.";
+/**
+ * Run one bounded summary pass. Returns the summary text, or null on any
+ * failure/timeout/empty answer (the caller then keeps the mechanical collapse).
+ * Never throws.
+ */
+export async function summarizeThreadPrefix(params) {
+    if (params.turns.length === 0)
+        return null;
+    const timeoutMs = params.timeoutMs ?? SUMMARY_TIMEOUT_MS;
+    const abort = new AbortController();
+    const onOuterAbort = () => abort.abort();
+    if (params.signal) {
+        if (params.signal.aborted)
+            return null;
+        params.signal.addEventListener("abort", onOuterAbort, { once: true });
+    }
+    const timer = setTimeout(() => abort.abort(), timeoutMs);
+    timer.unref?.();
+    const answer = new AnswerAssembly();
+    try {
+        const spec = HarnessRunSpec.parse({
+            session_id: `continuity-summary-${Date.now()}`,
+            intent: "explain",
+            prompt: `${SUMMARY_INSTRUCTION}\n\n---\n\n${transcript(params.turns)}`,
+            cwd: params.cwd,
+            access: "readonly",
+            external_context_policy: "off",
+            tool_permission_policy: { web: "off", allow: [], deny: [] },
+            model_hint: null,
+            effort_hint: null,
+            max_turns: 1,
+            auth_preference: params.authPreference === "auto" ? undefined : params.authPreference,
+            credential_profile: params.credentialProfile,
+            // A fresh pass: never resume — this is a side computation, not a lane turn.
+            resume_session_id: null,
+            env_inheritance: params.envInheritance,
+            evidence_policy: "stream_only",
+            env: params.env,
+            attachments: [],
+            browser: null,
+            stream_deltas: false,
+            extra: { abortSignal: abort.signal },
+        });
+        for await (const raw of params.adapter.run(spec)) {
+            if (abort.signal.aborted)
+                return null;
+            const event = raw;
+            if (event.type === "error")
+                return null;
+            if (event.type === "message")
+                answer.observe(event);
+        }
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+        params.signal?.removeEventListener("abort", onOuterAbort);
+    }
+    if (abort.signal.aborted)
+        return null;
+    const text = answer.text().trim();
+    return text ? boundBytes(text, MAX_SUMMARY_BYTES) : null;
+}
+//# sourceMappingURL=continuity-summary.js.map

package/dist/continuity-summary.js.map

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

package/dist/continuity.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Continuation-packet builder (INV-137, V9b) — PURE.
+ *
+ * A lane is a (thread, harness, profile) triple. When a turn runs on a lane
+ * whose checkpoint lags the thread head — a lane switch (A→B→A) or a gap — the
+ * new lane has no native memory of the missed turns, so the engine hydrates it
+ * with a bounded MECHANICAL continuation packet: recent delta turns verbatim,
+ * older ones collapsed to one-line entries when the budget is exceeded, plus
+ * the active plan pointer and a workspace anchor.
+ *
+ * When the budget forces a collapse, a cached LLM summary (V9c) can REPLACE the
+ * collapsed one-liners with real prose: the caller runs `planContinuation` to
+ * learn which older turns would collapse (and their boundary turn id — the
+ * summary cache key), resolves a summary for that prefix (cache hit or a bounded
+ * inline summarization pass), and passes it back as `cachedSummary`. The
+ * mechanical one-liner collapse is ALWAYS the fallback, so a missing/failed
+ * summary never loses information. Either way `summarized` stays true (the
+ * verbatim prefix was condensed); the packet text itself discloses which form
+ * was used.
+ *
+ * This module takes fully-resolved structured data (the daemon supplies thread
+ * facts; the orchestrator reads prior outputs + git anchor) and returns the
+ * disclosure + the packet body. No I/O, no clock — trivially unit-testable.
+ */
+/** Per delta turn: verbatim budget (user prompt + primary output). */
+export declare const PER_TURN_BUDGET_BYTES: number;
+/** Whole-packet verbatim budget; older turns collapse past this. */
+export declare const TOTAL_BUDGET_BYTES: number;
+/** One-line collapsed entry keeps this many chars of each field. */
+export declare const COLLAPSE_PREFIX_CHARS = 200;
+export interface ContinuityTurn {
+    /** Turn id (checkpoint math keys off this). */
+    id: string;
+    /** The user's message for the turn (already redacted). */
+    prompt: string;
+    /** The turn's primary output text (final/answer.md), "" when none. */
+    outputText: string;
+}
+export interface ContinuityLane {
+    harness: string;
+    profileId: string | null;
+}
+export interface ContinuityPlanPointer {
+    /** Absolute path to the approved plan.md the packet points at. */
+    path: string;
+    /** derivePlanReadiness state: ready | needs_answers | unverified. */
+    readiness: string;
+    planRunId: string;
+}
+export interface ContinuityAnchor {
+    headSha: string | null;
+    dirtyCount: number;
+}
+export interface ContinuityRequest {
+    /** This turn's resolved lane. */
+    lane: ContinuityLane;
+    /** All prior turns of the thread, in order (EXCLUDES the current turn). */
+    priorTurns: ContinuityTurn[];
+    /** The last turn id this lane has seen, or null when the lane never ran. */
+    laneCheckpointTurnId: string | null;
+    /** True when the lane can resume its OWN native vendor session in place. */
+    nativeResumeAvailable: boolean;
+    /** The lane that produced the prior head turn, when known (for laneSwitchedFrom). */
+    priorHeadLane: ContinuityLane | null;
+    /** Active plan pointer to append, when any. */
+    activePlan: ContinuityPlanPointer | null;
+    /** Workspace anchor to append, when available. */
+    anchor: ContinuityAnchor | null;
+    /**
+     * A resolved LLM summary of the collapsed older prefix (V9c). Applied ONLY
+     * when the packet actually collapses AND `upToTurnId` equals the plan's
+     * `summaryUpToTurnId` (the collapse boundary) — otherwise ignored and the
+     * mechanical one-liner collapse renders. Absent = mechanical fallback.
+     */
+    cachedSummary?: ResolvedSummary | null;
+}
+/** A summary of the collapsed older prefix, keyed by its boundary turn id. */
+export interface ResolvedSummary {
+    /** The id of the LAST turn the summary covers (the collapse boundary). */
+    upToTurnId: string;
+    /** The summary prose to render in place of the collapsed one-liners. */
+    text: string;
+}
+/**
+ * The mechanical collapse plan for a request — WHICH delta turns are carried and
+ * which would collapse under the budget — computed WITHOUT rendering so the
+ * caller can resolve a summary for the collapsed prefix before building the
+ * packet. Pure and cheap (the same math `buildContinuation` uses internally).
+ */
+export interface ContinuityPlan {
+    kind: "native_resume" | "packet" | "fresh";
+    /** All delta turns this lane must be told about (after its checkpoint). */
+    delta: ContinuityTurn[];
+    /** The oldest delta turns that collapse under the budget (empty = none). */
+    collapsedPrefix: ContinuityTurn[];
+    /** Boundary turn id — the summary cache key; null when nothing collapses. */
+    summaryUpToTurnId: string | null;
+}
+export interface ContinuityDisclosureResult {
+    kind: "native_resume" | "packet" | "fresh";
+    packetTurns: number;
+    summarized: boolean;
+    laneSwitchedFrom: ContinuityLane | null;
+}
+export interface ContinuityResult {
+    disclosure: ContinuityDisclosureResult;
+    /** The THREAD.md packet body, or null when no packet is delivered. */
+    packetMarkdown: string | null;
+}
+/**
+ * Compute the mechanical collapse plan for a lane WITHOUT rendering: the caller
+ * uses `summaryUpToTurnId` to look up / generate a summary for the collapsed
+ * prefix, then feeds it back via `req.cachedSummary` to `buildContinuation`.
+ * Pure; matches `buildContinuation`'s own collapse math exactly.
+ */
+export declare function planContinuation(req: ContinuityRequest): ContinuityPlan;
+/** Compute the continuity disclosure + packet body for a resolved lane. */
+export declare function buildContinuation(req: ContinuityRequest): ContinuityResult;
+//# sourceMappingURL=continuity.d.ts.map

package/dist/continuity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuity.d.ts","sourceRoot":"","sources":["../src/continuity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,QAAW,CAAC;AAC9C,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,QAAY,CAAC;AAC5C,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,2EAA2E;IAC3E,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,4EAA4E;IAC5E,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,4EAA4E;IAC5E,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qFAAqF;IACrF,aAAa,EAAE,cAAc,GAAG,IAAI,CAAC;IACrC,+CAA+C;IAC/C,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACzC,kDAAkD;IAClD,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CACxC;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3C,2EAA2E;IAC3E,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,4EAA4E;IAC5E,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,cAAc,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,0BAA0B,CAAC;IACvC,sEAAsE;IACtE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAmKD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,GAAG,cAAc,CAgBvE;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG,gBAAgB,CA6C1E"}

package/dist/continuity.js

@@ -0,0 +1,220 @@
+/**
+ * Continuation-packet builder (INV-137, V9b) — PURE.
+ *
+ * A lane is a (thread, harness, profile) triple. When a turn runs on a lane
+ * whose checkpoint lags the thread head — a lane switch (A→B→A) or a gap — the
+ * new lane has no native memory of the missed turns, so the engine hydrates it
+ * with a bounded MECHANICAL continuation packet: recent delta turns verbatim,
+ * older ones collapsed to one-line entries when the budget is exceeded, plus
+ * the active plan pointer and a workspace anchor.
+ *
+ * When the budget forces a collapse, a cached LLM summary (V9c) can REPLACE the
+ * collapsed one-liners with real prose: the caller runs `planContinuation` to
+ * learn which older turns would collapse (and their boundary turn id — the
+ * summary cache key), resolves a summary for that prefix (cache hit or a bounded
+ * inline summarization pass), and passes it back as `cachedSummary`. The
+ * mechanical one-liner collapse is ALWAYS the fallback, so a missing/failed
+ * summary never loses information. Either way `summarized` stays true (the
+ * verbatim prefix was condensed); the packet text itself discloses which form
+ * was used.
+ *
+ * This module takes fully-resolved structured data (the daemon supplies thread
+ * facts; the orchestrator reads prior outputs + git anchor) and returns the
+ * disclosure + the packet body. No I/O, no clock — trivially unit-testable.
+ */
+/** Per delta turn: verbatim budget (user prompt + primary output). */
+export const PER_TURN_BUDGET_BYTES = 8 * 1024;
+/** Whole-packet verbatim budget; older turns collapse past this. */
+export const TOTAL_BUDGET_BYTES = 24 * 1024;
+/** One-line collapsed entry keeps this many chars of each field. */
+export const COLLAPSE_PREFIX_CHARS = 200;
+function bytes(text) {
+    return Buffer.byteLength(text, "utf8");
+}
+/** Truncate to at most `maxBytes` UTF-8 bytes on a safe char boundary. */
+function boundBytes(text, maxBytes) {
+    if (bytes(text) <= maxBytes)
+        return text;
+    // Buffer slice can split a multi-byte scalar; back off a few bytes until valid.
+    const buf = Buffer.from(text, "utf8").subarray(0, maxBytes);
+    for (let trim = 0; trim <= 3 && trim <= buf.length; trim += 1) {
+        try {
+            const decoded = new TextDecoder("utf-8", { fatal: true }).decode(trim === 0 ? buf : buf.subarray(0, buf.length - trim));
+            return `${decoded}\n…[truncated]`;
+        }
+        catch {
+            /* prefix ended inside a scalar; back off */
+        }
+    }
+    return `${buf.toString("utf8")}\n…[truncated]`;
+}
+function oneLine(text) {
+    const flat = text.replace(/\s+/g, " ").trim();
+    return flat.length > COLLAPSE_PREFIX_CHARS ? `${flat.slice(0, COLLAPSE_PREFIX_CHARS)}…` : flat;
+}
+/** Delta turns for this lane: everything AFTER the checkpoint (all prior when
+ * the lane never ran / has no reachable native session to trust). */
+function deltaTurns(req) {
+    // Without a reachable native session the lane starts blank — carry the whole
+    // prior conversation regardless of any stale checkpoint.
+    if (!req.nativeResumeAvailable)
+        return req.priorTurns;
+    if (!req.laneCheckpointTurnId)
+        return req.priorTurns;
+    const idx = req.priorTurns.findIndex((t) => t.id === req.laneCheckpointTurnId);
+    // Checkpoint not among the retained prior turns → carry everything (safe).
+    return idx < 0 ? req.priorTurns : req.priorTurns.slice(idx + 1);
+}
+function verbatimEntry(turn, index) {
+    const prompt = boundBytes(turn.prompt.trim(), PER_TURN_BUDGET_BYTES / 2);
+    const output = turn.outputText.trim()
+        ? boundBytes(turn.outputText.trim(), PER_TURN_BUDGET_BYTES / 2)
+        : "_(no recorded output)_";
+    return `### Turn ${index + 1}\n\n**User asked:**\n\n${prompt}\n\n**The assistant answered:**\n\n${output}\n`;
+}
+function collapsedEntry(turn, index) {
+    const prompt = oneLine(turn.prompt) || "(empty)";
+    const output = turn.outputText.trim() ? oneLine(turn.outputText) : "(no recorded output)";
+    return `- Turn ${index + 1} — user: ${prompt} · assistant: ${output}`;
+}
+/**
+ * How many of the OLDEST delta turns collapse to one-liners: grow the collapsed
+ * prefix from the oldest until the verbatim total fits the budget. Pure — the
+ * single owner of the collapse decision (both `planContinuation` and
+ * `renderPacket` read it, so the boundary the caller summarizes is exactly the
+ * boundary the packet renders).
+ */
+function collapseCount(delta) {
+    const verbatim = delta.map((t, i) => verbatimEntry(t, i));
+    let collapsed = 0;
+    const totalBytes = () => delta.reduce((sum, t, i) => sum + bytes(i < collapsed ? collapsedEntry(t, i) : verbatim[i]), 0);
+    while (collapsed < delta.length && totalBytes() > TOTAL_BUDGET_BYTES) {
+        collapsed += 1;
+    }
+    return collapsed;
+}
+/**
+ * Assemble the packet body from delta turns, collapsing the OLDEST turns while
+ * the verbatim total exceeds the budget. When a `summary` covering the collapse
+ * boundary is supplied it REPLACES the one-liners with real prose; otherwise the
+ * mechanical one-liner collapse renders (always works). Returns the body and
+ * whether any collapse happened (`summarized`).
+ */
+function renderPacket(delta, activePlan, anchor, summary) {
+    const collapsedCount = collapseCount(delta);
+    const summarized = collapsedCount > 0;
+    const boundaryTurnId = collapsedCount > 0 ? delta[collapsedCount - 1].id : null;
+    // A summary applies only when it covers the EXACT collapse boundary — a stale
+    // summary (boundary moved since it was cached) falls back to one-liners.
+    const usableSummary = summary && boundaryTurnId && summary.upToTurnId === boundaryTurnId ? summary : null;
+    const parts = [
+        "# Thread continuation packet",
+        "",
+        "You are continuing an existing Claudexor conversation on a new lane. The earlier turns below did not run on this lane's native session — read them before answering the new prompt at the end of your instructions.",
+        "",
+    ];
+    if (summarized) {
+        parts.push(usableSummary
+            ? "> The oldest turns are condensed into the cached conversation summary below; the most recent turns are verbatim."
+            : "> The older turns are condensed to one-line entries below (a cached conversation summary was unavailable for this turn). The most recent turns are verbatim.", "");
+    }
+    if (usableSummary) {
+        parts.push("## Earlier conversation (summary)", "", usableSummary.text.trim(), "", "## Recent turns", "");
+        for (let i = collapsedCount; i < delta.length; i += 1) {
+            parts.push(verbatimEntry(delta[i], i));
+        }
+    }
+    else {
+        parts.push("## Earlier turns", "");
+        const collapsedLines = [];
+        for (let i = 0; i < delta.length; i += 1) {
+            if (i < collapsedCount) {
+                collapsedLines.push(collapsedEntry(delta[i], i));
+            }
+            else {
+                if (collapsedLines.length > 0) {
+                    parts.push(...collapsedLines, "");
+                    collapsedLines.length = 0;
+                }
+                parts.push(verbatimEntry(delta[i], i));
+            }
+        }
+        if (collapsedLines.length > 0)
+            parts.push(...collapsedLines, "");
+    }
+    if (activePlan) {
+        parts.push("## Active plan", "", `The thread's approved plan is at: ${activePlan.path} (readiness: ${activePlan.readiness}). Re-read it as needed.`, "");
+    }
+    if (anchor) {
+        parts.push("## Workspace anchor", "", `HEAD ${anchor.headSha ?? "(unborn)"} · ${anchor.dirtyCount} file(s) with uncommitted changes at the start of this turn.`, "");
+    }
+    return {
+        body: parts
+            .join("\n")
+            .replace(/\n{3,}/g, "\n\n")
+            .trimEnd() + "\n",
+        summarized,
+    };
+}
+/**
+ * Compute the mechanical collapse plan for a lane WITHOUT rendering: the caller
+ * uses `summaryUpToTurnId` to look up / generate a summary for the collapsed
+ * prefix, then feeds it back via `req.cachedSummary` to `buildContinuation`.
+ * Pure; matches `buildContinuation`'s own collapse math exactly.
+ */
+export function planContinuation(req) {
+    if (req.priorTurns.length === 0) {
+        return { kind: "fresh", delta: [], collapsedPrefix: [], summaryUpToTurnId: null };
+    }
+    const delta = deltaTurns(req);
+    if (delta.length === 0) {
+        return { kind: "native_resume", delta: [], collapsedPrefix: [], summaryUpToTurnId: null };
+    }
+    const collapsed = collapseCount(delta);
+    const collapsedPrefix = delta.slice(0, collapsed);
+    return {
+        kind: "packet",
+        delta,
+        collapsedPrefix,
+        summaryUpToTurnId: collapsed > 0 ? delta[collapsed - 1].id : null,
+    };
+}
+/** Compute the continuity disclosure + packet body for a resolved lane. */
+export function buildContinuation(req) {
+    const laneSwitchedFrom = req.priorHeadLane &&
+        (req.priorHeadLane.harness !== req.lane.harness ||
+            (req.priorHeadLane.profileId ?? null) !== (req.lane.profileId ?? null))
+        ? req.priorHeadLane
+        : null;
+    // Nothing before this turn → the thread's first move on any lane.
+    if (req.priorTurns.length === 0) {
+        return {
+            disclosure: { kind: "fresh", packetTurns: 0, summarized: false, laneSwitchedFrom: null },
+            packetMarkdown: null,
+        };
+    }
+    const delta = deltaTurns(req);
+    if (delta.length === 0) {
+        // The lane's own native session already holds everything up to the head.
+        return {
+            disclosure: {
+                kind: "native_resume",
+                packetTurns: 0,
+                summarized: false,
+                laneSwitchedFrom: null,
+            },
+            packetMarkdown: null,
+        };
+    }
+    const { body, summarized } = renderPacket(delta, req.activePlan, req.anchor, req.cachedSummary ?? null);
+    return {
+        disclosure: {
+            kind: "packet",
+            packetTurns: delta.length,
+            summarized,
+            laneSwitchedFrom,
+        },
+        packetMarkdown: body,
+    };
+}
+//# sourceMappingURL=continuity.js.map

package/dist/continuity.js.map

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

package/dist/contract-gates.d.ts

@@ -1,14 +1,13 @@
 import type { AccessProfile, GateResult, ProjectConfig, TaskContract, TestCommandGrant, TestCommandInvocation } from "@claudexor/schema";
 import type { GateSpec } from "@claudexor/review";
 type GateCommands = TaskContract["tests"]["commands"];
-/** Merge the three command authorities once and attach external grants only
- * to versioned project commands. Spec/operator commands are explicit input. */
+/** Merge the command authorities once and attach external grants only
+ * to versioned project commands. Operator commands are explicit input. */
 export declare function resolveContractGates(input: {
     repoRoot: string;
     effectiveAccess: AccessProfile;
     config: ProjectConfig;
     trustGrants: TestCommandGrant[];
-    specCommands: TestCommandInvocation[];
     operatorCommands: TestCommandInvocation[];
     projectCommands: TestCommandInvocation[];
 }): {