pi-daddy 0.26.1 → 0.27.0

package/dist/work-run.js

@@ -0,0 +1,102 @@
+import { randomUUID, createHash } from "node:crypto";
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { setTimeout as wait } from "node:timers/promises";
+import { createControlJournal, controlJournal } from "./control-journal.js";
+import { composeStepTask, HANDOFF_MAX_BYTES } from "./chain.js";
+import { splitBudget } from "./fanout.js";
+import { workSetup } from "./work-setup.js";
+/** Finite DAG scheduler only. Execution, grants, cancellation, deadlines and observation remain original-owner operations. */
+export async function runWorkSetup(input) {
+    const setup = workSetup(input.setup), split = splitBudget(input.budget, setup.tasks.length);
+    if (!split.ok)
+        throw Error(split.reason);
+    if (!/^[a-f0-9]{64}$/.test(input.selectionDigest))
+        throw Error("exact selected work digest required");
+    const order = input.priorities ?? setup.tasks.map(t => t.id);
+    if (order.length !== setup.tasks.length || new Set(order).size !== order.length || order.some(id => !setup.tasks.some(t => t.id === id)))
+        throw Error("priority must name each task exactly once");
+    const binding = await createControlJournal(input.directory, { version: "work-run-v1", runId: input.orderId ?? randomUUID(), selectionDigest: input.selectionDigest, setup, policyPin: input.policyPin ?? null });
+    const journal = controlJournal(binding), outcomes = new Map();
+    const tasks = order.map(id => ({ id, state: "waiting", executionId: null, resultPath: null, resultDigest: null, reason: null }));
+    const running = new Map();
+    let persistenceFailure;
+    const publish = () => { try {
+        input.onUpdate?.(tasks.map(t => ({ ...t })));
+    }
+    catch { /* display is not execution */ } };
+    const record = (task) => journal.transaction(async (_events, append) => append({ type: "task", ...task }));
+    while (tasks.some(t => t.state === "waiting") || running.size) {
+        for (const row of tasks.filter(t => t.state === "waiting")) {
+            const spec = setup.tasks.find(t => t.id === row.id);
+            if (input.signal?.aborted || persistenceFailure || spec.dependencies.some(d => ["failed", "blocked"].includes(tasks.find(t => t.id === d).state))) {
+                row.state = "blocked";
+                row.reason = input.signal?.aborted ? "Cancelled before admission" : persistenceFailure ? "Result/control persistence failed; no further admission" : "A dependency did not finish successfully";
+                try {
+                    await record(row);
+                }
+                catch (error) {
+                    persistenceFailure ??= error;
+                }
+                continue;
+            }
+            if (input.admissionOpen?.() === false || running.size >= setup.maxParallel || !spec.dependencies.every(d => tasks.find(t => t.id === d).state === "finished"))
+                continue;
+            row.state = "running";
+            const pending = (async () => {
+                try {
+                    const previous = spec.dependencies.map(d => `${d}\n${outcomes.get(d).text}`).join("\n\n");
+                    if (Buffer.byteLength(previous) > HANDOFF_MAX_BYTES)
+                        throw Error("Complete predecessor output exceeds the 32 KiB handoff bound; dependent work was not launched");
+                    await record(row);
+                    const outcome = await input.execute(spec, composeStepTask(spec.outcome, spec.dependencies.length ? previous : undefined), split.perChild, async (executionId) => { row.executionId = executionId; await record(row); publish(); });
+                    outcomes.set(spec.id, outcome);
+                    if (Buffer.byteLength(outcome.text) > 1024 * 1024)
+                        throw Error("original child result exceeds retention bound");
+                    const bytes = Buffer.from(outcome.text), file = `${spec.id}.txt`;
+                    await writeFile(join(binding.directory, file), bytes, { mode: 0o600, flag: "wx" });
+                    row.resultPath = join(binding.directory, file);
+                    row.resultDigest = createHash("sha256").update(bytes).digest("hex");
+                    row.state = outcome.ok && !outcome.control && !outcome.truncated ? "finished" : "failed";
+                    row.reason = row.state === "finished" ? null : outcome.reason ?? (outcome.control ? "Observation/control failed" : outcome.truncated ? "Output truncated" : "Attempt failed");
+                }
+                catch (error) {
+                    row.state = "failed";
+                    row.reason = String(error);
+                }
+                try {
+                    await record(row);
+                }
+                catch (error) {
+                    persistenceFailure ??= error;
+                    row.state = "failed";
+                    row.reason = `Control acknowledgement unknown: ${String(error)}`;
+                }
+                publish();
+            })().finally(() => running.delete(row.id));
+            running.set(row.id, pending);
+            publish();
+        }
+        publish();
+        if (running.size)
+            await Promise.race(running.values());
+        else if (tasks.some(t => t.state === "waiting"))
+            await wait(100, undefined, { signal: input.signal }).catch(error => { if (!input.signal?.aborted)
+                throw error; });
+    }
+    // No detached promises, restart relaunch, refund or retry. Original children have all settled here.
+    if (persistenceFailure)
+        throw Error(`Work results may exist but control persistence failed: ${String(persistenceFailure)}`);
+    return { binding, tasks, acceptance: "not-assessed" };
+}
+export async function inspectWorkRun(binding) {
+    workSetup(binding.initial.setup);
+    if (binding.initial.version !== "work-run-v1")
+        throw Error("unsupported work run");
+    const rows = new Map();
+    for (const event of (await controlJournal(binding).read()).events)
+        if (event.type === "task")
+            rows.set(String(event.id), event);
+    return { binding, tasks: binding.initial.setup.tasks.map(t => rows.get(t.id) ?? { id: t.id, state: "waiting", executionId: null, resultPath: null, resultDigest: null, reason: "No launch acknowledgement; do not infer or retry" }), acceptance: "not-assessed" };
+}
+//# sourceMappingURL=work-run.js.map

package/dist/work-run.js.map

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

package/dist/work-setup.d.ts

@@ -0,0 +1,40 @@
+import { type RevisionRef, type WorkRevisionEvent, type WorkSnapshotEvent, type WorkFrozen } from "./work-ledger.ts";
+import { type DeclaredWorkState } from "./work-command.ts";
+import { type IntentSelection } from "./intent-control.ts";
+import type { WorkPresentation } from "./daily-panel.ts";
+export declare const WORK_EFFORTS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+export interface WorkTaskSetup {
+    id: string;
+    outcome: string;
+    agent: string | null;
+    model: string;
+    thinking: typeof WORK_EFFORTS[number];
+    dependencies: string[];
+}
+export interface WorkSetup {
+    version: "work-setup-v1";
+    id: string;
+    outcome: string;
+    maxParallel: number;
+    tasks: WorkTaskSetup[];
+}
+export interface RecordedWorkSetup {
+    version: "recorded-work-setup-v1";
+    setup: WorkSetup;
+    state: DeclaredWorkState;
+    tasks: {
+        id: string;
+        obligation: RevisionRef;
+    }[];
+    events: WorkFrozen<WorkRevisionEvent | WorkSnapshotEvent>[];
+}
+export declare function workSetup(input: WorkSetup): WorkSetup;
+/** Author first, append through P01, then select separately at an explicit owner boundary. */
+export declare function recordWorkSetup(cwd: string, value: WorkSetup, mode?: "new" | "revise" | "alternative", expected?: DeclaredWorkState | null): Promise<RecordedWorkSetup>;
+export declare function loadWorkSetup(state: DeclaredWorkState): Promise<RecordedWorkSetup | null>;
+/** Caller must own a quiescent session, with no running daily host. No active order is rebound. */
+export declare function selectRecordedWork(recorded: RecordedWorkSetup, expected: IntentSelection | null): Promise<DeclaredWorkState>;
+export declare function listWorkSetups(cwd: string): Promise<RecordedWorkSetup[]>;
+export declare function workSetupForSelection(cwd: string, selection: IntentSelection): Promise<RecordedWorkSetup | null>;
+export declare function workPresentation(state: DeclaredWorkState): Promise<WorkPresentation | null>;
+//# sourceMappingURL=work-setup.d.ts.map

package/dist/work-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-setup.d.ts","sourceRoot":"","sources":["../src/work-setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAA6E,KAAK,WAAW,EAAqB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnN,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,eAAO,MAAM,YAAY,sEAAuE,CAAC;AACjG,MAAM,WAAW,aAAa;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE;AAClK,MAAM,WAAW,SAAS;IAAG,OAAO,EAAE,eAAe,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE;AACjI,MAAM,WAAW,iBAAiB;IAAG,OAAO,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,WAAW,CAAA;KAAE,EAAE,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,EAAE,CAAA;CAAE;AAMnO,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAiBrD;AAGD,8FAA8F;AAC9F,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,GAAE,KAAK,GAAG,QAAQ,GAAG,aAAqB,EAAE,QAAQ,GAAE,iBAAiB,GAAG,IAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8C1L;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAc/F;AACD,mGAAmG;AACnG,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,CASlI;AACD,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAW9E;AACD,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAKtH;AACD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAOjG"}

package/dist/work-setup.js

@@ -0,0 +1,174 @@
+import { createHash } from "node:crypto";
+import { readFile, readdir } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { appendWorkLedgerEventOnce, buildWorkRevisionEvent, buildWorkSnapshotEvent } from "./work-ledger.js";
+import { resolveWorkSnapshotText } from "./work-ledger-snapshot.js";
+import { loadDeclaredWork } from "./work-command.js";
+import { withFileLock } from "./file-lock.js";
+import { intentKey } from "./intent-control.js";
+import { privateDirectory, projectProductDirectory, readProductJson, writeProductJson } from "./product-files.js";
+export const WORK_EFFORTS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+const hash = (value) => createHash("sha256").update(value).digest("hex");
+const keys = (value, expected) => { if (!value || typeof value !== "object" || Object.keys(value).sort().join() !== expected.sort().join())
+    throw Error("unsupported work setup fields"); };
+const id = (value) => typeof value === "string" && /^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$/.test(value);
+const text = (value) => typeof value === "string" && value.trim().length > 0 && Buffer.byteLength(value) <= 8192;
+const ref = (r) => ({ kind: r.kind, id: r.id, revision: r.revision, digest: r.digest });
+export function workSetup(input) {
+    const s = JSON.parse(JSON.stringify(input));
+    keys(s, ["version", "id", "outcome", "maxParallel", "tasks"]);
+    if (s.version !== "work-setup-v1" || !id(s.id) || !text(s.outcome) || !Number.isInteger(s.maxParallel) || s.maxParallel < 1 || s.maxParallel > 8 || !Array.isArray(s.tasks) || !s.tasks.length || s.tasks.length > 8)
+        throw Error("work setup requires 1–8 tasks and parallel limit 1–8");
+    const seen = new Set();
+    for (const task of s.tasks) {
+        keys(task, ["id", "outcome", "agent", "model", "thinking", "dependencies"]);
+        if (!id(task.id) || seen.has(task.id) || !text(task.outcome) || !(task.agent === null || typeof task.agent === "string" && /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.test(task.agent)) || typeof task.model !== "string" || !/^[A-Za-z0-9._-]+\/[A-Za-z0-9._:/@+-]+$/.test(task.model) || task.model.length > 128 || !WORK_EFFORTS.includes(task.thinking) || !Array.isArray(task.dependencies) || new Set(task.dependencies).size !== task.dependencies.length || task.dependencies.some(d => !id(d) || d === task.id))
+            throw Error("invalid task, model/effort or dependency; no profile fallback");
+        seen.add(task.id);
+    }
+    const done = new Set();
+    while (done.size < s.tasks.length) {
+        const eligible = s.tasks.filter(t => !done.has(t.id) && t.dependencies.every(d => done.has(d)));
+        if (!eligible.length)
+            throw Error("dependencies contain a cycle or missing task");
+        eligible.forEach(t => done.add(t.id));
+    }
+    return s;
+}
+const setupPath = (state) => join(dirname(state.statePath), "work-setups", `${state.selectedSnapshot.snapshot.digest}.json`);
+/** Author first, append through P01, then select separately at an explicit owner boundary. */
+export async function recordWorkSetup(cwd, value, mode = "new", expected = null) {
+    const setup = workSetup(value), root = join(resolve(cwd), ".pi"), statePath = join(root, "work-current.json");
+    await projectProductDirectory(root);
+    await privateDirectory(join(root, "work-setups"));
+    return withFileLock(statePath, "work setup", async () => {
+        const current = await loadDeclaredWork(statePath);
+        if (intentKey(current?.selectedSnapshot ?? null) !== intentKey(expected?.selectedSnapshot ?? null))
+            throw Error("work selection changed; reopen setup");
+        if (mode !== "new" && !current)
+            throw Error("select existing work before recording a revision");
+        const original = mode !== "new" ? await loadWorkSetup(current) : null;
+        if (mode !== "new" && (!original || original.setup.tasks.length !== setup.tasks.length || original.setup.tasks.some(t => !setup.tasks.some(n => n.id === t.id && intentKey([...n.dependencies].sort()) === intentKey([...t.dependencies].sort())))))
+            throw Error("topology changes require a new work setup; no live entity expansion");
+        const revisions = current && mode !== "new" ? resolveWorkSnapshotText(await readFile(current.ledgerPath, "utf8"), current.selectedSnapshot) : null;
+        const token = hash(intentKey({ setup, mode, from: mode === "new" ? null : current?.selectedSnapshot })).slice(0, 24), prefix = mode === "new" ? `work:${setup.id}:${token.slice(0, 8)}` : current.scope.id.replace(/:scope$/, "");
+        // Preparation is durable before the first append, so an interrupted exact retry retains timestamps/identities.
+        const preparedPath = join(root, "work-setups", `pending-${token}.json`);
+        const prepared = await readProductJson(preparedPath);
+        if (prepared && (Object.keys(prepared).join() !== "now" || !Number.isFinite(Date.parse(prepared.now))))
+            throw Error("invalid retained setup preparation");
+        const now = new Date(prepared?.now ?? Date.now());
+        if (!prepared)
+            await writeProductJson(preparedPath, { now: now.toISOString() });
+        const events = [];
+        const build = (kind, entityId, content, parent, dependencies = [], policy = null) => {
+            const prior = revisions && [revisions.scope, ...revisions.revisions].find(r => r.kind === kind && r.id === entityId);
+            const event = buildWorkRevisionEvent({ eventId: `${prefix}:${token}:${kind}:${events.length}`, now, revision: { kind, id: entityId, revision: prior ? prior.revision + 1 : 1, predecessor: prior ? ref(prior) : null, scopeId: `${prefix}:scope`, contentDigest: hash(intentKey(content)), parent, dependencies, ownerId: prior?.ownerId ?? "local-operator", permittedEffects: prior ? [...prior.permittedEffects] : [], policy } });
+            events.push(event);
+            return ref(event.payload.revision);
+        };
+        const scope = mode === "alternative" ? current.scope : build("scope", `${prefix}:scope`, setup, null);
+        const policy = mode === "new" ? build("policy", `${prefix}:policy`, { acceptance: "independent-review-required" }, null) : current.policy;
+        const intent = build("goal", mode === "new" ? `${prefix}:goal` : current.intent.id, setup, scope);
+        const tasks = [];
+        while (tasks.length < setup.tasks.length) {
+            for (const task of setup.tasks) {
+                if (tasks.some(t => t.id === task.id) || !task.dependencies.every(d => tasks.some(t => t.id === d)))
+                    continue;
+                const entityId = original?.tasks.find(t => t.id === task.id)?.obligation.id ?? `${prefix}:${task.id}`;
+                const obligation = build("obligation", entityId, task, intent, task.dependencies.map(d => tasks.find(t => t.id === d).obligation), policy);
+                tasks.push({ id: task.id, obligation });
+            }
+        }
+        const ordered = setup.tasks.map(t => tasks.find(x => x.id === t.id));
+        const snapshot = buildWorkSnapshotEvent({ eventId: `${prefix}:${token}:snapshot`, now, snapshot: { snapshotId: `${prefix}:${token}:selected`, scope, revisions: [policy, intent, ...ordered.map(t => t.obligation)], bindings: ordered.map(t => ({ intent, obligation: t.obligation, artifact: null, policy })) } });
+        events.push(snapshot);
+        const state = { version: "pi-daddy-declared-work-v1", id: setup.id, outcomeDigest: hash(setup.outcome.trim()), ledgerPath: join(root, "work.jsonl"), statePath, grantLedgerPath: null, selectedSnapshot: { snapshot: { id: snapshot.payload.snapshot.snapshotId, digest: snapshot.payload.snapshot.digest }, event: { eventId: snapshot.eventId, digest: snapshot.digest } }, scope, intent, obligation: ordered[0].obligation, policy };
+        const result = { version: "recorded-work-setup-v1", setup, state, tasks: ordered, events };
+        const path = setupPath(state), previous = await readProductJson(path);
+        if (previous && intentKey(previous) !== intentKey(result))
+            throw Error("recorded setup identity conflict");
+        if (!previous)
+            await writeProductJson(path, result);
+        for (const event of events)
+            await appendWorkLedgerEventOnce({ path: state.ledgerPath, grantLedgerPath: null }, event);
+        await loadWorkSetup(state);
+        return result;
+    });
+}
+export async function loadWorkSetup(state) {
+    const value = await readProductJson(setupPath(state));
+    if (!value)
+        return null;
+    keys(value, ["version", "setup", "state", "tasks", "events"]);
+    const setup = workSetup(value.setup);
+    if (value.version !== "recorded-work-setup-v1" || intentKey(value.state.selectedSnapshot) !== intentKey(state.selectedSnapshot) || value.state.ledgerPath !== state.ledgerPath || value.state.statePath !== state.statePath || hash(setup.outcome.trim()) !== value.state.outcomeDigest || !Array.isArray(value.tasks) || value.tasks.length !== setup.tasks.length)
+        throw Error("work setup selection mismatch");
+    const resolved = resolveWorkSnapshotText(await readFile(state.ledgerPath, "utf8"), state.selectedSnapshot);
+    if (resolved.scopeState !== "valid" || !resolved.snapshot || hash(intentKey(setup)) !== resolved.revisions.find(r => r.digest === value.state.intent.digest)?.contentDigest)
+        throw Error("recorded work labels are stale or mismatched");
+    if (intentKey(resolved.snapshot.scope) !== intentKey(value.state.scope) || !resolved.snapshot.bindings.some(b => intentKey(b.intent) === intentKey(value.state.intent) && intentKey(b.policy) === intentKey(value.state.policy) && intentKey(b.obligation) === intentKey(state.obligation)))
+        throw Error("work state is not an exact selected binding");
+    for (const task of setup.tasks) {
+        const binding = value.tasks.find(t => t.id === task.id), revision = resolved.revisions.find(r => r.digest === binding?.obligation.digest);
+        if (!binding || !revision || revision.contentDigest !== hash(intentKey(task)) || !resolved.snapshot.bindings.some(b => intentKey(b.obligation) === intentKey(binding.obligation)))
+            throw Error("task configuration is not bound to selected work");
+    }
+    return value;
+}
+/** Caller must own a quiescent session, with no running daily host. No active order is rebound. */
+export async function selectRecordedWork(recorded, expected) {
+    const state = recorded.state;
+    return withFileLock(state.statePath, "select work", async () => {
+        const current = await loadDeclaredWork(state.statePath);
+        if (intentKey(current?.selectedSnapshot ?? null) !== intentKey(expected))
+            throw Error("selection changed; no work selected");
+        if (!await loadWorkSetup(state))
+            throw Error("recorded setup missing");
+        const { statePath: _path, ...stored } = state;
+        await writeProductJson(state.statePath, stored, true);
+        return state;
+    });
+}
+export async function listWorkSetups(cwd) {
+    const root = join(resolve(cwd), ".pi", "work-setups");
+    let files;
+    try {
+        files = await readdir(root);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    if (files.length > 256)
+        throw Error("work setup history bound exceeded");
+    const results = [];
+    for (const file of files.filter(f => /^[a-f0-9]{64}\.json$/.test(f)).sort()) {
+        const value = await readProductJson(join(root, file));
+        if (value?.state?.statePath !== join(resolve(cwd), ".pi", "work-current.json") || file !== `${value.state.selectedSnapshot.snapshot.digest}.json`)
+            throw Error("invalid work setup history");
+        results.push((await loadWorkSetup(value.state)));
+    }
+    return results;
+}
+export async function workSetupForSelection(cwd, selection) {
+    const path = join(resolve(cwd), ".pi", "work-setups", `${selection.snapshot.digest}.json`), value = await readProductJson(path);
+    if (!value)
+        return null;
+    if (value.state?.statePath !== join(resolve(cwd), ".pi", "work-current.json") || intentKey(value.state.selectedSnapshot) !== intentKey(selection))
+        throw Error("recorded selection labels mismatch");
+    return loadWorkSetup(value.state);
+}
+export async function workPresentation(state) {
+    const setup = await loadWorkSetup(state);
+    if (setup)
+        return { outcome: setup.setup.outcome, obligations: setup.tasks.map(t => { const spec = setup.setup.tasks.find(s => s.id === t.id); return { digest: t.obligation.digest, outcome: spec.outcome, agent: spec.agent ?? "No-tool agent", dependencies: spec.dependencies }; }) };
+    const value = await readProductJson(join(dirname(state.statePath), "work-outcomes", `${state.outcomeDigest}.json`));
+    if (!value)
+        return null;
+    if (Object.keys(value).join() !== "outcome" || typeof value.outcome !== "string" || hash(value.outcome.trim()) !== state.outcomeDigest)
+        throw Error("declared outcome digest mismatch");
+    return { outcome: value.outcome, obligations: [{ digest: state.obligation.digest, outcome: value.outcome }] };
+}
+//# sourceMappingURL=work-setup.js.map

package/dist/work-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-setup.js","sourceRoot":"","sources":["../src/work-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,sBAAsB,EAAwG,MAAM,kBAAkB,CAAC;AACnN,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAA0B,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAwB,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGlH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAU,CAAC;AAIjG,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjF,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,QAAkB,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;IAAE,MAAM,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9M,MAAM,EAAE,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3G,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AAC1H,MAAM,GAAG,GAAG,CAAC,CAA4D,EAAe,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAChK,MAAM,UAAU,SAAS,CAAC,KAAgB;IACxC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAc,CAAC;IACzD,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,CAAC,OAAO,KAAK,eAAe,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1R,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,wCAAwC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,YAAY,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAChkB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChG,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,MAAM,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClF,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AACD,MAAM,SAAS,GAAG,CAAC,KAAwB,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,OAAO,CAAC,CAAC;AAEhJ,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,KAAgB,EAAE,OAAyC,KAAK,EAAE,WAAqC,IAAI;IAC5J,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAC9G,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAAC,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IACvF,OAAO,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,SAAS,CAAC,OAAO,EAAE,gBAAgB,IAAI,IAAI,CAAC,KAAK,SAAS,CAAC,QAAQ,EAAE,gBAAgB,IAAI,IAAI,CAAC;YAAE,MAAM,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACxJ,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC,OAAO;YAAE,MAAM,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAChG,MAAM,QAAQ,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,OAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvE,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAAE,MAAM,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACxU,MAAM,SAAS,GAAG,OAAO,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,uBAAuB,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnJ,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnO,+GAA+G;QAC/G,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,YAAY,CAA2B,CAAC;QAC/E,IAAI,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,MAAM,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC1J,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,MAAM,gBAAgB,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAChF,MAAM,MAAM,GAAwD,EAAE,CAAC;QACvE,MAAM,KAAK,GAAG,CAAC,IAA0B,EAAE,QAAgB,EAAE,OAAgB,EAAE,MAA0B,EAAE,eAA8B,EAAE,EAAE,SAA6B,IAAI,EAAe,EAAE;YAC7L,MAAM,KAAK,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,KAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;YACtH,MAAM,KAAK,GAAG,sBAAsB,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACta,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAC,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzD,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,OAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,MAAM,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACvG,MAAM,MAAM,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,MAAM,SAAS,EAAE,EAAE,UAAU,EAAE,6BAA6B,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAQ,CAAC,MAAM,CAAC;QAC3I,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,OAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACnG,MAAM,KAAK,GAA+B,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACzC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;oBAAE,SAAS;gBAC9G,MAAM,QAAQ,GAAG,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACtG,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAE,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC5I,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAE,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,KAAK,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,KAAK,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrT,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtB,MAAM,KAAK,GAAsB,EAAE,OAAO,EAAE,2BAA2B,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAC5b,MAAM,MAAM,GAAsB,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC9G,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QACtE,IAAI,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC;YAAE,MAAM,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC3G,IAAI,CAAC,QAAQ;YAAE,MAAM,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpD,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,MAAM,yBAAyB,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QACtH,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;QAAC,OAAO,MAAM,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAwB;IAC1D,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,CAA6B,CAAC;IAClF,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,OAAO,KAAK,wBAAwB,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAClZ,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC3G,IAAI,QAAQ,CAAC,UAAU,KAAK,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa;QAAE,MAAM,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACzO,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAAE,MAAM,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACxV,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1I,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAAE,MAAM,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACrP,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AACD,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAA2B,EAAE,QAAgC;IACpG,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC7B,OAAO,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,SAAS,CAAC,OAAO,EAAE,gBAAgB,IAAI,IAAI,CAAC,KAAK,SAAS,CAAC,QAAQ,CAAC;YAAE,MAAM,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC7H,IAAI,CAAC,MAAM,aAAa,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACvE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;QAC9C,MAAM,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAAC,OAAO,KAAK,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IACtD,IAAI,KAAe,CAAC;IAAC,IAAI,CAAC;QAAC,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;IAC3J,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACzE,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5E,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAsB,CAAC;QAC3E,IAAI,KAAK,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,mBAAmB,CAAC,IAAI,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,OAAO;YAAE,MAAM,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC7L,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAW,EAAE,SAA0B;IACjF,MAAM,IAAI,GAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAC,KAAK,EAAC,aAAa,EAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,OAAO,CAAC,EAAC,KAAK,GAAC,MAAM,eAAe,CAAC,IAAI,CAA2B,CAAC;IAClJ,IAAG,CAAC,KAAK;QAAC,OAAO,IAAI,CAAC;IACtB,IAAG,KAAK,CAAC,KAAK,EAAE,SAAS,KAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAC,KAAK,EAAC,mBAAmB,CAAC,IAAE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAG,SAAS,CAAC,SAAS,CAAC;QAAC,MAAM,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC3L,OAAO,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAwB;IAC7D,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,eAAe,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3R,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC,aAAa,OAAO,CAAC,CAA+B,CAAC;IAClJ,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,aAAa;QAAE,MAAM,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACxL,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AAChH,CAAC"}

package/extensions/daily-dashboard-session.ts

@@ -7,6 +7,8 @@ import { ENV_DASHBOARD_HOST_SOCKET } from "../src/dashboard-host-transport.ts";
 import { startDailyDashboardHost } from "../src/daily-dashboard-host.ts";
 import type { DeclaredWorkState } from "../src/work-command.ts";
 import type { OrdinaryChildren } from "../src/ordinary-children.ts";
+import { learningHarness, loadLearningConnection } from "../src/learning-connection.ts";
+import { readProductJson } from "../src/product-files.ts";
 
 const BRIDGE=Symbol.for("skill-harness.dashboard-host.v1"),idPattern=/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
 export function dailyDashboardPaths(cwd:string,id:string,home=homedir(),uid=process.getuid?.()??0){const key=createHash("sha256").update(`${cwd}\0${id}`).digest("hex");return {directory:join(home,".local","state","pi-daddy","hosts",key.slice(0,16)),socketDirectory:join("/tmp",`pi-daddy-${uid}`),socketPath:join("/tmp",`pi-daddy-${uid}`,`host-${key.slice(0,20)}.sock`)};}
@@ -18,22 +20,29 @@ export async function preparePrivateHostRoot(root:string):Promise<void>{
 }
 
 export function createDailyDashboardSession(input:{ordinary:()=>OrdinaryChildren;declared:()=>DeclaredWorkState|undefined;rebind:(state:DeclaredWorkState)=>void;cwd:()=>string;env:Record<string,string|undefined>;author:string;home?:string}){
- let current:null|Awaited<ReturnType<typeof startDailyDashboardHost>>=null,publishedSocket:string|undefined,closing:null|{present:true;closing:true;evidenceDigest:string;expiresAt:number}=null;
+ let ended=false,current:null|Awaited<ReturnType<typeof startDailyDashboardHost>>=null,publishedSocket:string|undefined,closing:null|{present:true;closing:true;evidenceDigest:string;expiresAt:number}=null;
  return Object.freeze({
+  get running(){return current!==null;},
+  async frame(){if(!current)throw Error("Start /grants host first");return current.host.frame();},
+  async choose(key:string,binding?:{tip:string;requestDigest:string}){if(!current)throw Error("Start /grants host first");if(binding)return current.host.humanAction(key,binding);const frame=await current.host.frame(),action=frame.actions.find(a=>a.key===key);if(!action)throw Error("Action unavailable at the current boundary");return current.host.humanAction(key,{tip:frame.tip,requestDigest:action.requestDigest});},
   async run(target:string){
+   if(ended)throw Error("Original Pi session has ended; no host replacement or control recovery");
+   if(!target)target=`daily-${randomUUID().slice(0,8)}`;
    if(target==="stop"){
     if(!current)return "daily host is not running";await current.close();current=null;closing=null;if(publishedSocket&&input.env[ENV_DASHBOARD_HOST_SOCKET]===publishedSocket)delete input.env[ENV_DASHBOARD_HOST_SOCKET];publishedSocket=undefined;return "daily host stopped; no child was cancelled";
    }
-   if(target==="closing"){if(!current)throw Error("daily host is not running");const expiresAt=Date.now()+120_000;closing={present:true,closing:true,evidenceDigest:createHash("sha256").update(`${input.cwd()}\0${expiresAt}\0${randomUUID()}`).digest("hex"),expiresAt};return "explicit closing presence recorded for two minutes; pause new dispatch and finish/cancel active attempts, then choose prepare-case-cards in the dashboard. No card is counted as delivered until visibly acknowledged.";}
+   if(target==="closing"){if(!current)throw Error("daily host is not running");const expiresAt=Date.now()+120_000;closing={present:true,closing:true,evidenceDigest:createHash("sha256").update(`${input.cwd()}\0${expiresAt}\0${randomUUID()}`).digest("hex"),expiresAt};return "explicit closing presence recorded for two minutes; pause new dispatch and finish/cancel active attempts, then choose Prepare retained case cards in the dashboard. No card is counted as delivered until visibly acknowledged.";}
    if(!idPattern.test(target))throw Error("usage — /grants host <fresh-id> | closing | stop");if(current)throw Error("daily host already running in this session; use closing or stop");
-   const declared=input.declared();if(!declared)throw Error("declare current work first with pi-daddy work add, then reload");
+   const declared=input.declared();if(!declared)throw Error("declare current work first with /grants work new");
    const home=input.home??homedir(),paths=dailyDashboardPaths(input.cwd(),target,home),root=join(home,".local","state","pi-daddy","hosts");await preparePrivateHostRoot(root);await mkdir(paths.socketDirectory,{recursive:true,mode:0o700});
    try{await lstat(paths.directory);throw Error(`host ID ${target} already has preserved state; choose a fresh host ID (the existing state was not opened, deleted or reused)`);}catch(error){if((error as NodeJS.ErrnoException).code!=="ENOENT")throw error;}
-   const bridge=(globalThis as Record<PropertyKey,unknown>)[BRIDGE];if(!bridge)throw Error("loaded skill-harness extension bridge unavailable; load the candidate skill-harness extension in this Pi session");
-   try{current=await startDailyDashboardHost({id:target,cwd:input.cwd(),directory:paths.directory,socketPath:paths.socketPath,declared,ordinary:input.ordinary(),harness:adoptDashboardHarnessBridge(bridge) as never,author:input.author,presence:()=>closing,onDeclaredWorkChanged:input.rebind});}catch(error){if((error as NodeJS.ErrnoException).code==="EEXIST")throw Error(`host ID ${target} could not start because state already exists; choose a fresh host ID. Existing state was preserved.`);throw error;}
+   const bridge=(globalThis as Record<PropertyKey,unknown>)[BRIDGE];if(!bridge)throw Error("loaded skill-harness extension bridge unavailable; load the skill-harness extension in this Pi session");
+   const harness=adoptDashboardHarnessBridge(bridge),savedLearning=await readProductJson(join(input.cwd(),".pi","learning-workspace.json")),learning=savedLearning?await loadLearningConnection(input.cwd(),declared,learningHarness(harness),input.author):null;
+   try{current=await startDailyDashboardHost({id:target,cwd:input.cwd(),directory:paths.directory,socketPath:paths.socketPath,declared,ordinary:input.ordinary(),harness,author:input.author,...(learning?{learning:learning.connection}:{}),presence:()=>closing,onDeclaredWorkChanged:input.rebind});}catch(error){if((error as NodeJS.ErrnoException).code==="EEXIST")throw Error(`host ID ${target} could not start because state already exists; choose a fresh host ID. Existing state was preserved.`);throw error;}
    publishedSocket=current.socketPath;input.env[ENV_DASHBOARD_HOST_SOCKET]=publishedSocket;
-   return `daily host started at ${publishedSocket}; current declared work/facts were captured. Run /grants dashboard, then use only its listed pause/resume/refresh/cancel/scope/priority/alternative action keys. Runtime remains unaccepted.`;
+   return `daily host started at ${publishedSocket}; current declared work/facts were captured. Run /grants dashboard for numbered actions or /grants work for work setup. Runtime remains unaccepted.`;
   },
-  async close(){if(current)await current.close();if(publishedSocket&&input.env[ENV_DASHBOARD_HOST_SOCKET]===publishedSocket)delete input.env[ENV_DASHBOARD_HOST_SOCKET];current=null;closing=null;publishedSocket=undefined;}
+  /** Called only when the original Pi session ends; no hold release or effect reconciliation. */
+  async close(){ended=true;if(current)await current.endSession();if(publishedSocket&&input.env[ENV_DASHBOARD_HOST_SOCKET]===publishedSocket)delete input.env[ENV_DASHBOARD_HOST_SOCKET];current=null;closing=null;publishedSocket=undefined;}
  });
 }

package/extensions/execute-child.ts

@@ -94,7 +94,7 @@ async function executeChildBody(input: {
   childId: string;
   executionId: string;
   parentExecutionId: string | null;
-  toolCallId?: string;
+  toolCallId?: string; declaredWork?: GrantsSession["declaredWork"];
   cwd: string;
   preparedWorkspace?: PreparedWorkspace;
   signal?: AbortSignal;
@@ -128,7 +128,7 @@ async function executeChildBody(input: {
     }
   }
   const workAttempt = await beginDeclaredWorkAttempt({
-    session, plan, childId, executionId, parentExecutionId, toolCallId: input.toolCallId,
+    session, plan, childId, executionId, parentExecutionId, toolCallId: input.toolCallId, declaredWork: input.declaredWork,
     preparedWorkspace, configuredTimeoutMs, startedAt,
   });
 

package/extensions/grants-command.ts

@@ -76,12 +76,12 @@ export interface GrantsCommandContext {
 const PREVIEW_LIMIT = 12;
 
 /** The verbs `/grants` answers to. Anything else is refused rather than silently treated as no verb. */
-const KNOWN_SUBCOMMANDS: readonly string[] = ["init", "host", "variants", "dashboard", "ledger", "approvals", "revoke"];
+const KNOWN_SUBCOMMANDS: readonly string[] = ["work", "learning", "init", "host", "variants", "dashboard", "ledger", "approvals", "revoke"];
 
 export const grantsCommand = {
   description:
     "Show this session's capability grant, delegation depth, and known agent-type ceilings; " +
-    "/grants host <fresh-id>|stop | /grants variants | /grants dashboard | /grants approvals | /grants ledger | /grants revoke <key>|--all",
+    "/grants work (setup/run/results) | /grants learning | /grants host [fresh-id]|stop | /grants dashboard | /grants approvals | /grants ledger",
 handler: async (args: string, ctx: any) => {
     // Everything this command may see, named in one place. Previously these were whatever happened to be in
     // the enclosing closure — which is how a diagnostic came to disagree with the enforcer (R-28).

package/extensions/grants.ts

@@ -48,6 +48,8 @@ import { defaultDashboardPaths, offerDashboardHandshake, openDashboardCommand }
 import { associateOrdinaryHost, ordinaryChildrenFor } from "../src/ordinary-children.ts";
 import { loadDeclaredWork } from "../src/work-command.ts";
 import { createDailyDashboardSession } from "./daily-dashboard-session.ts";
+import { createWorkSession } from "./work-session.ts";
+import { createLearningSession } from "./learning-session.ts";
 import { replacePublishedDailyWork, type PublishedDailyWork } from "./daily-work-session.ts";
 export default function (pi: ExtensionAPI) {
   // The path pi loads as the extension, so a child granted `tool:delegate` can be started with `-e <this>`.
@@ -70,6 +72,8 @@ export default function (pi: ExtensionAPI) {
   // dispatch surface; afterwards this callback refreshes their model-facing spawnable-definition text.
   const delegation = { refreshSpawnable: () => {} };
   const publishedDailyWork: PublishedDailyWork = {};
+  const workSession=createWorkSession(session,dailyHost,()=>replacePublishedDailyWork(process.env,publishedDailyWork,session.declaredWork));
+  const learningSession=createLearningSession(dailyHost);
 
   pi.on("session_start", async (_event, ctx) => {
     // Real SDK contexts always supply SessionManager. The fallback keeps lightweight wiring fixtures
@@ -253,7 +257,7 @@ export default function (pi: ExtensionAPI) {
    * installed here for the reason R-62 gives: it would turn pi's "interrupt this turn" into "exit pi".
    */
   pi.on("session_shutdown", async () => {
-    await dailyHost.close().catch(() => undefined);
+    await workSession.close(); await dailyHost.close().catch(() => undefined);
   });
 
   pi.on("agent_settled", async () => {
@@ -349,7 +353,7 @@ export default function (pi: ExtensionAPI) {
     ...grantsCommand,
     // Built per invocation and spelled out field by field, rather than passing the session whole: what a
     // read-only diagnostic may see is a decision, and `GrantsCommandContext` is where it is recorded.
-    handler: (args, ctx) =>
+    handler: (args, ctx) => /^learning(?:\s|$)/.test(args.trim()) ? learningSession.run(args.trim().slice(8).trim(),ctx).catch(error=>{ctx.ui.notify(String(error),"error");}) : /^work(?:\s|$)/.test(args.trim()) ? workSession.run(args.trim().slice(4).trim(),ctx).catch(error=>{ctx.ui.notify(String(error),"error");}) :
       grantsCommand.handler(args, {
         ...ctx,
         grants: {

package/extensions/learning-outcome-session.ts

@@ -0,0 +1,38 @@
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { inspectWorkRun, type WorkRunInitial } from "../src/work-run.ts";
+import type { ControlBinding } from "../src/control-journal.ts";
+import { readProductJson } from "../src/product-files.ts";
+import { readDailySnapshot } from "../src/daily-view-input.ts";
+import { experimentHash } from "../src/experiment-contract.ts";
+import type { LearningHarness, LearningWorkspace } from "../src/learning-connection.ts";
+import type { DeclaredWorkState } from "../src/work-command.ts";
+import type { ProductionObservation } from "../src/vendor/adoption.ts";
+
+/** Link actual later-run bytes/pin; only an explicit independent human supplies outcome labels. */
+export async function linkLatestWorkOutcome(ctx: ExtensionCommandContext, state: DeclaredWorkState, workspace: LearningWorkspace, harness: LearningHarness) {
+  const binding = await readProductJson(join(ctx.cwd, ".pi", "work-last-run.json")) as ControlBinding<WorkRunInitial> | null;
+  if (!binding) throw Error("No retained later bounded order is available");
+  const run = await inspectWorkRun(binding), pin = binding.initial.policyPin;
+  if (!pin?.adoptionId) throw Error("This run was not pinned to an adoption. It cannot establish an adopted outcome.");
+  const comparisons = workspace.inspect(Date.now()).comparisons.filter(c => c.state !== "deferred" && workspace.preparedAdoption(c.name)?.id === pin.adoptionId);
+  if(!comparisons.length)throw Error("No ready learning comparison matches this run's actual adoption pin. Reconnect original evidence before linking outcomes.");
+  const labels = comparisons.map((c, i) => `${i + 1}. ${c.title}`), picked = await ctx.ui.select("Observed adoption", labels), comparison = comparisons[labels.indexOf(picked ?? "")]; if (!comparison) return;
+  const rows = run.tasks.filter(t => t.resultPath && t.resultDigest), tasks = rows.map((t, i) => `${i + 1}. ${t.id}: ${t.state}`), selected = await ctx.ui.select("Actual retained output", tasks), row = rows[tasks.indexOf(selected ?? "")]; if (!row) return;
+  if (row.resultPath !== join(binding.directory, `${row.id}.txt`)) throw Error("retained result path changed");
+  const source = await readDailySnapshot(row.resultPath, 1024 * 1024);
+  if (source.status !== "read" || source.sha256 !== row.resultDigest) throw Error("retained output missing or mismatched");
+  await ctx.ui.editor("Complete retained output (controls escaped; editor edits discarded)", new TextDecoder("utf8", { fatal: true }).decode(source.bytes).replace(/[\p{Cc}\p{Cf}]/gu, c => c === "\n" || c === "\t" ? c : `\\u${c.charCodeAt(0).toString(16).padStart(4,"0")}`));
+  const outcomes = ["Unknown / not independently judged", "Independently confirmed success", "Independently confirmed defect"], outcome = await ctx.ui.select("Observed quality — runtime success is not a label", outcomes); if (!outcome) return;
+  const note = await ctx.ui.editor("Independent observation note / evidence (do not infer acceptance)", ""); if (!note?.trim()) return;
+  if (!await ctx.ui.confirm("Retain this scoped observation?", "This records an explicit human observation of these exact later-work bytes. Acceptance remains absent. It does not calibrate a detector, certify held-out improvement or trigger rollback.")) return;
+  const root = workspace.configuration().archiveRoot;
+  const artifact = harness.retainArchiveSource(root, { sourceId: `later-output-${source.sha256.slice(0,24)}`, parser: { id: "producer-work-output", version: "1" }, retention: "exact", bytes: source.bytes }).manifestId;
+  const evidence = harness.retainArchiveSource(root, { sourceId: `later-observation-${randomUUID()}`, parser: { id: "producer-work-observation", version: "1" }, retention: "exact", bytes: Buffer.from(JSON.stringify({ run: binding.initial, task: row, note, author: workspace.configuration().author })) }).manifestId;
+  const input: ProductionObservation = { id: `work-observation-${experimentHash({run:binding.initial.runId,task:row.id,note,outcome}).slice(0,24)}`, adoptionId: pin.adoptionId, candidateDigest: pin.candidateDigest, scopeDigest: pin.scopeDigest, originalRequirementDigest: binding.initial.selectionDigest, currentRequirementDigest: state.selectedSnapshot.snapshot.digest, outcome: outcomes.indexOf(outcome) === 1 ? "success" : outcomes.indexOf(outcome) === 2 ? "confirmed-defect" : "unknown", acceptanceDigest: null, acceptedArtifactDigest: null, observedArtifactDigest: source.sha256, evidence: [artifact, evidence] };
+  const preview = workspace.previewObservation(comparison.name, input);
+  if (!await ctx.ui.confirm("Confirm classified outcome", JSON.stringify(preview.classification))) return;
+  const retained = workspace.observe(comparison.name, input, [preview.digest]);
+  ctx.ui.notify(`Observed outcome retained (${retained.manifestId.slice(0,12)}). No acceptance, calibration or automatic rollback inferred.`, "info");
+}

package/extensions/learning-session.ts

@@ -0,0 +1,59 @@
+import { randomUUID } from "node:crypto";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { mkdir } from "node:fs/promises";
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { adoptDashboardHarnessBridge } from "../src/dashboard-harness.ts";
+import { learningHarness, bindLearningConnection, loadLearningConnection, learningScopeDigest, type LearningUI } from "../src/learning-connection.ts";
+import { loadDeclaredWork } from "../src/work-command.ts";
+import { privateDirectory } from "../src/product-files.ts";
+import { workPolicyMenu } from "./work-policy-session.ts";
+import { linkLatestWorkOutcome } from "./learning-outcome-session.ts";
+import type { createDailyDashboardSession } from "./daily-dashboard-session.ts";
+
+/** Normal human-only entrypoint: delegates canonical learning decisions to the loaded harness wizard. */
+export function createLearningSession(host: ReturnType<typeof createDailyDashboardSession>) {
+  let busy = false;
+  return { async run(_verb: string, ctx: ExtensionCommandContext) {
+    if (busy) throw Error("A learning dialog is already open");
+    if (!ctx.hasUI) throw Error("Open /grants learning in interactive Pi");
+    busy = true;
+    try {
+      const declared = await loadDeclaredWork(join(ctx.cwd, ".pi", "work-current.json"));
+      if (!declared) throw Error("Declare work with /grants work first so learning has an exact scope");
+      const bridge = (globalThis as Record<PropertyKey, unknown>)[Symbol.for("skill-harness.dashboard-host.v1")];
+      const h = learningHarness(adoptDashboardHarnessBridge(bridge));
+      let connected: Awaited<ReturnType<typeof loadLearningConnection>> = null;
+      try { connected = await loadLearningConnection(ctx.cwd, declared, h, "local-operator"); }
+      catch (error) { ctx.ui.notify(String(error), "warning"); }
+      const menu = ["Open cases, comparisons, trust and outcomes", "Create learning workspace for selected work", "Connect existing learning workspace", "Adoption / rollback for next orders", "Retain current work for learning", "Link observed result from latest adopted order"];
+      const choice = await ctx.ui.select(connected ? "Learning — deliberate review (not earned automatic exposure)" : "Learning not connected", connected ? menu : menu.slice(1, 3));
+      if (!choice) return;
+      if ([menu[1], menu[2]].includes(choice)) {
+        if (host.running && !await ctx.ui.confirm("Reconnect learning after stopping the current host?", "Old host evidence is preserved. No child is cancelled. Start /grants host again after configuration.")) return;
+        if (host.running) await host.run("stop");
+        let directory: string;
+        if (choice === menu[1]) {
+          if (!await ctx.ui.confirm("Enable scoped learning retention?", "Case/comparison/trust decisions and explicitly selected output artifacts will be retained privately. No model is called; no quality, calibration or authority is invented.")) return;
+          const root = join(homedir(), ".local", "state", "pi-daddy", "learning"); await mkdir(root, { recursive: true, mode: 0o700 }); await privateDirectory(root);
+          const instance = join(root, randomUUID()); await privateDirectory(instance);
+          directory = join(instance, "workspace");
+          h.createLearningWorkspace(directory, { archiveRoot: join(instance, "archive"), scopeDigest: learningScopeDigest(declared), population: `work:${learningScopeDigest(declared).slice(0, 32)}`, author: "local-operator" });
+        } else { const path = await ctx.ui.input("Existing learning workspace directory"); if (!path) return; directory = path.trim(); }
+        await bindLearningConnection(ctx.cwd, declared, directory, h, "local-operator");
+        connected = await loadLearningConnection(ctx.cwd, declared, h, "local-operator");
+        ctx.ui.notify("Learning connected to exact work scope. Start /grants host to show it in Herdr.", "info");
+      }
+      if (!connected) throw Error("Connect learning first");
+      if (choice === menu[5]) { await linkLatestWorkOutcome(ctx, declared, connected.workspace, h); return; }
+      if (choice === menu[3]) { await workPolicyMenu(ctx, declared, connected.workspace, h); return; }
+      if (choice === menu[4]) {
+        if (!host.running) throw Error("Start /grants host first; it captures and binds the current work case batch through the existing archive policy");
+        await host.choose("refresh-current-work"); ctx.ui.notify("Current work retained. Open Learning for real case readiness; this is not a defect label.", "info"); return;
+      }
+      const ui: LearningUI = { select: (title, choices) => ctx.ui.select(title, choices), input: (title, initial) => ctx.ui.input(title, initial), editor: (title, text) => ctx.ui.editor(title, text), confirm: (title, detail) => ctx.ui.confirm(title, detail), notify: (text, level) => ctx.ui.notify(text, level ?? "info") };
+      await h.runLearningWizard({ directory: connected.connection.directory, cwd: ctx.cwd, ui });
+      if (host.running) ctx.ui.notify("Learning saved. If you changed trust configuration, stop/start /grants host explicitly to bind it; attention is not reset.", "info");
+    } finally { busy = false; }
+  } };
+}