pi-daddy 0.22.0 → 0.24.0

package/dist/work-ledger-validation.js

@@ -0,0 +1,226 @@
+import { isExecutionId } from "./execution-id.js";
+import { canonicalWorkJson, workDigest } from "./work-ledger-json.js";
+import { WorkInputError } from "./work-ledger-types.js";
+const kinds = ["scope", "goal", "node", "obligation", "artifact", "policy"];
+const fail = () => { throw new WorkInputError("WORK_SCHEMA_INVALID"); };
+function require(value) { if (!value)
+    fail(); }
+export function workObject(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return fail();
+    return value;
+}
+function closed(value, keys) {
+    const object = workObject(value);
+    require(Object.keys(object).length === keys.length && keys.every(key => Object.hasOwn(object, key)));
+    return object;
+}
+function id(value) { require(typeof value === "string" && /^[A-Za-z0-9][A-Za-z0-9._:/@+\-]{0,127}$/.test(value)); }
+function digest(value) { require(typeof value === "string" && /^[0-9a-f]{64}$/.test(value)); }
+function integer(value) { require(typeof value === "number" && Number.isSafeInteger(value) && value >= 1); }
+function member(value, values) { require(typeof value === "string" && values.includes(value)); }
+function nullable(value, validate) { if (value !== null)
+    validate(value); }
+function reference(value, allowed = kinds) {
+    const ref = closed(value, ["kind", "id", "revision", "digest"]);
+    member(ref.kind, allowed);
+    id(ref.id);
+    integer(ref.revision);
+    digest(ref.digest);
+}
+function identity(value) {
+    const ref = closed(value, ["id", "digest"]);
+    id(ref.id);
+    digest(ref.digest);
+}
+function eventRef(value) {
+    const ref = closed(value, ["eventId", "digest"]);
+    id(ref.eventId);
+    digest(ref.digest);
+}
+/** Internal validation for the exact out-of-band selectedSnapshot shape; no authority is constructed. */
+export function validateWorkSelection(value) {
+    if (value === null)
+        return;
+    const selected = closed(value, ["snapshot", "event"]);
+    identity(selected.snapshot);
+    eventRef(selected.event);
+}
+function timestamp(value) {
+    require(typeof value === "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(value));
+    require(!value.startsWith("0000") && Number.isFinite(Date.parse(value)) && new Date(value).toISOString() === value);
+}
+/** Builder sorts detached copies; reader refuses noncanonical sets instead of repairing them. */
+function set(value, validate, building, key = canonicalWorkJson) {
+    require(Array.isArray(value));
+    value.forEach(validate);
+    const keyed = value.map(item => ({ item, key: key(item) }));
+    const sorted = [...keyed].sort((a, b) => a.key < b.key ? -1 : a.key > b.key ? 1 : 0);
+    for (let i = 1; i < sorted.length; i++)
+        require(sorted[i - 1].key !== sorted[i].key);
+    if (building)
+        value.splice(0, value.length, ...sorted.map(entry => entry.item));
+    else
+        require(keyed.every((entry, i) => entry.key === sorted[i].key));
+}
+function ownKeys(keys, building) { return building ? keys : [...keys, "digest"]; }
+function revision(value, building) {
+    const r = closed(value, ownKeys(["kind", "id", "revision", "scopeId", "predecessor", "contentDigest",
+        "parent", "dependencies", "ownerId", "permittedEffects", "policy"], building));
+    member(r.kind, kinds);
+    id(r.id);
+    integer(r.revision);
+    id(r.scopeId);
+    id(r.ownerId);
+    digest(r.contentDigest);
+    nullable(r.predecessor, v => reference(v));
+    nullable(r.parent, v => reference(v));
+    nullable(r.policy, v => reference(v, ["policy"]));
+    set(r.dependencies, v => reference(v, ["obligation"]), building);
+    set(r.permittedEffects, id, building, v => v);
+    if (r.revision === 1)
+        require(r.predecessor === null);
+    else {
+        require(r.predecessor !== null);
+        const predecessor = workObject(r.predecessor);
+        require(predecessor.kind === r.kind && predecessor.id === r.id &&
+            predecessor.revision === r.revision - 1);
+    }
+    const noDependencies = r.dependencies.length === 0;
+    if (r.kind === "scope")
+        require(r.scopeId === r.id && r.parent === null && noDependencies && r.policy === null);
+    if (r.kind === "artifact" || r.kind === "policy") {
+        require(r.parent === null && noDependencies && r.policy === null && r.permittedEffects.length === 0);
+    }
+    if (r.kind === "goal" || r.kind === "node" || r.kind === "obligation") {
+        reference(r.parent, r.kind === "goal" ? ["scope", "goal"] : ["goal", "node"]);
+        if (r.kind === "obligation")
+            reference(r.policy, ["policy"]);
+        else
+            require(noDependencies && r.policy === null);
+    }
+    if (!building)
+        digest(r.digest);
+}
+function obligationBinding(value) {
+    const b = closed(value, ["intent", "obligation", "artifact", "policy"]);
+    reference(b.intent, ["goal", "node"]);
+    reference(b.obligation, ["obligation"]);
+    nullable(b.artifact, v => reference(v, ["artifact"]));
+    reference(b.policy, ["policy"]);
+}
+function snapshot(value, building) {
+    const s = closed(value, ownKeys(["snapshotId", "scope", "revisions", "bindings"], building));
+    id(s.snapshotId);
+    reference(s.scope, ["scope"]);
+    set(s.revisions, v => reference(v, kinds.filter(k => k !== "scope")), building);
+    set(s.bindings, obligationBinding, building, v => canonicalWorkJson(workObject(v).obligation));
+    if (!building)
+        digest(s.digest);
+    // Inventory/ancestor/predecessor resolution requires the complete event snapshot, not a guessed head.
+}
+function occurrence(value) {
+    const p = closed(value, ["scope", "obligation", "executionId", "parentExecutionId", "childId", "variantId",
+        "artifact", "provenance", "state", "labels"]);
+    reference(p.scope, ["scope"]);
+    reference(p.obligation, ["obligation"]);
+    require(isExecutionId(p.executionId));
+    require(p.parentExecutionId === null || isExecutionId(p.parentExecutionId));
+    require(p.executionId !== p.parentExecutionId);
+    nullable(p.childId, id);
+    nullable(p.variantId, id);
+    nullable(p.artifact, v => reference(v, ["artifact"]));
+    member(p.provenance, ["declared", "observed"]);
+    member(p.state, ["unknown", "starting", "running", "completed", "failed"]);
+    const labels = closed(p.labels, ["sessionId", "branchLeafId", "toolCallId", "taskId", "workspaceId",
+        "definitionDigest", "configurationDigest", "modelId", "effortId"]);
+    for (const [key, value] of Object.entries(labels))
+        nullable(value, key.endsWith("Digest") ? digest : id);
+}
+function evidence(value) {
+    const e = closed(value, ["id", "digest", "event"]);
+    id(e.id);
+    digest(e.digest);
+    nullable(e.event, eventRef);
+}
+function acceptance(value, building) {
+    const p = closed(value, ["authorityId", "binding"]);
+    id(p.authorityId);
+    acceptanceBinding(p.binding, building);
+}
+function acceptanceBinding(value, building) {
+    const b = closed(value, ["snapshot", "scope", "intent", "obligation", "artifact", "artifactDigest", "policy", "evidence"]);
+    identity(b.snapshot);
+    reference(b.scope, ["scope"]);
+    reference(b.intent, ["goal", "node"]);
+    reference(b.obligation, ["obligation"]);
+    reference(b.artifact, ["artifact"]);
+    digest(b.artifactDigest);
+    reference(b.policy, ["policy"]);
+    set(b.evidence, evidence, building);
+    require(b.evidence.length > 0);
+}
+/** Validate a detached host context. Receipt/availability order and duplicate deliveries have no priority. */
+export function validateWorkContext(value) {
+    const c = closed(value, ["selectedSnapshot", "authority"]);
+    validateWorkSelection(c.selectedSnapshot);
+    if (c.authority === null)
+        return;
+    const a = closed(c.authority, ["snapshot", "decisions", "availability"]);
+    identity(a.snapshot);
+    require(Array.isArray(a.decisions));
+    require(Array.isArray(a.availability));
+    for (const value of a.decisions) {
+        const d = closed(value, ["receiptId", "authorityId", "claim", "binding", "decision"]);
+        id(d.receiptId);
+        id(d.authorityId);
+        eventRef(d.claim);
+        acceptanceBinding(d.binding, false);
+        member(d.decision, ["accept", "reject"]);
+    }
+    for (const value of a.availability) {
+        const row = closed(value, ["kind", "id", "digest", "available"]);
+        member(row.kind, ["artifact", "evidence"]);
+        id(row.id);
+        digest(row.digest);
+        require(typeof row.available === "boolean");
+    }
+}
+function ownDigest(object, building) {
+    const { digest: supplied, ...body } = object;
+    const computed = workDigest(body);
+    if (building)
+        object.digest = computed;
+    else if (supplied !== computed)
+        throw new WorkInputError("WORK_DIGEST_MISMATCH");
+}
+/** All closed shapes/domain checks finish before any own digest is computed or verified. */
+export function validateWorkEvent(value, building = false) {
+    const e = workObject(value);
+    if (e.ledgerVersion !== 4)
+        throw new WorkInputError("WORK_VERSION_UNSUPPORTED");
+    closed(e, ownKeys(["ledgerVersion", "event", "eventId", "ts", "payload"], building));
+    member(e.event, ["work_revision", "work_snapshot", "work_occurrence", "work_acceptance"]);
+    id(e.eventId);
+    timestamp(e.ts);
+    let nested;
+    if (e.event === "work_revision") {
+        nested = workObject(closed(e.payload, ["revision"]).revision);
+        revision(nested, building);
+    }
+    else if (e.event === "work_snapshot") {
+        nested = workObject(closed(e.payload, ["snapshot"]).snapshot);
+        snapshot(nested, building);
+    }
+    else if (e.event === "work_occurrence")
+        occurrence(e.payload);
+    else
+        acceptance(e.payload, building);
+    if (!building)
+        digest(e.digest);
+    if (nested)
+        ownDigest(nested, building);
+    ownDigest(e, building);
+    return e;
+}
+//# sourceMappingURL=work-ledger-validation.js.map

package/dist/work-ledger-validation.js.map

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

package/dist/work-ledger.d.ts

@@ -0,0 +1,43 @@
+import { type WorkAcceptanceEvent, type WorkAcceptancePayload, type WorkFrozen, type WorkIngestion, type WorkLedgerEvent, type WorkOccurrenceEvent, type WorkOccurrencePayload, type WorkRevision, type WorkRevisionEvent, type WorkSnapshot, type WorkSnapshotEvent, type WorkProjectionContext, type WorkProjection, type WorkLedgerInspection } from "./work-ledger-types.ts";
+export * from "./work-ledger-types.ts";
+export declare function buildWorkRevisionEvent(args: {
+    eventId: string;
+    now: Date;
+    revision: Omit<WorkRevision, "digest">;
+}): WorkFrozen<WorkRevisionEvent>;
+export declare function buildWorkSnapshotEvent(args: {
+    eventId: string;
+    now: Date;
+    snapshot: Omit<WorkSnapshot, "digest">;
+}): WorkFrozen<WorkSnapshotEvent>;
+export declare function buildWorkOccurrenceEvent(args: {
+    eventId: string;
+    now: Date;
+    payload: WorkOccurrencePayload;
+}): WorkFrozen<WorkOccurrenceEvent>;
+export declare function buildWorkAcceptanceEvent(args: {
+    eventId: string;
+    now: Date;
+    payload: WorkAcceptancePayload;
+}): WorkFrozen<WorkAcceptanceEvent>;
+/** Diagnostic boundary: retain physical valid deliveries, never rewrite, deduplicate or elect a winner. */
+export declare function parseWorkLedgerText(text: string): WorkFrozen<WorkIngestion>;
+/** Public opt-in projection: strict text, detached host context, exact selection, actual runtime,
+ * then conditional authority binding. No I/O, authenticator, ambient trust or acceptance callback. */
+export declare function projectWorkLedger(text: string, context?: WorkFrozen<WorkProjectionContext>): WorkFrozen<WorkProjection>;
+/** Always opt-in, strict, and detached before the first filesystem await. No environment defaults. */
+export declare function appendWorkLedgerEvent(options: {
+    path: string;
+    grantLedgerPath: string | null;
+}, event: WorkFrozen<WorkLedgerEvent>): Promise<void>;
+/** Explicit controller application seam: exact ID/digest redelivery does not append a second event. */
+export declare function appendWorkLedgerEventOnce(options: {
+    path: string;
+    grantLedgerPath: string | null;
+}, event: WorkFrozen<WorkLedgerEvent>): Promise<void>;
+/** Read-only regular-file inspection; a successful read is not a content-validity or acceptance claim. */
+export declare function inspectWorkLedger(options: {
+    version: 4;
+    path: string;
+}, context?: WorkFrozen<WorkProjectionContext>): Promise<WorkFrozen<WorkLedgerInspection>>;
+//# sourceMappingURL=work-ledger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"work-ledger.d.ts","sourceRoot":"","sources":["../src/work-ledger.ts"],"names":[],"mappings":"AAeA,OAAO,EACW,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EACpE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,mBAAmB,EACnF,KAAK,qBAAqB,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EACxF,KAAK,iBAAiB,EAAsB,KAAK,qBAAqB,EAAE,KAAK,cAAc,EAChC,KAAK,oBAAoB,EACrF,MAAM,wBAAwB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AAmBvC,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;CAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAElJ;AACD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;CAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAElJ;AACD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAA;CAAE,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAE9I;AACD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAA;CAAE,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAE9I;AAaD,2GAA2G;AAC3G,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,CAgB3E;AAED;sGACsG;AACtG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,UAAU,CAAC,qBAAqB,CAA+C,GAAG,UAAU,CAAC,cAAc,CAAC,CA4BpK;AAED,sGAAsG;AACtG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAElJ;AACD,uGAAuG;AACvG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtJ;AAkBD,0GAA0G;AAC1G,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC3E,OAAO,GAAE,UAAU,CAAC,qBAAqB,CAA+C,GAAG,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,CA0CrI"}

package/dist/work-ledger.js

@@ -0,0 +1,225 @@
+/** Opt-in work-v4 evidence. No default emission or built-in acceptance authority. */
+import { isDate } from "node:util/types";
+import { open, stat } from "node:fs/promises";
+import { constants } from "node:fs";
+import { appendLedgerLine, readWorkBytes, closeWorkHandle } from "./ledger-append.js";
+import { workDestination, workFsError, validWorkPath } from "./work-ledger-destination.js";
+import { LockTimeoutError } from "./file-lock.js";
+import { canonicalWorkJson, copyWorkJson, freezeWork, ownWorkFields, parseWorkJson, WORK_EVENT_BYTES, WORK_TEXT_BYTES, WORK_RECORDS, mergeWorkConflicts, } from "./work-ledger-json.js";
+import { validateWorkEvent, validateWorkContext } from "./work-ledger-validation.js";
+import { indexWorkLedgerText, indexWorkReceipts, projectWorkAcceptance } from "./work-ledger-projection.js";
+import { resolveWorkSnapshotText } from "./work-ledger-snapshot.js";
+import { foldWorkOccurrences } from "./work-ledger-occurrences.js";
+import { WorkInputError, WorkLedgerWriteError, } from "./work-ledger-types.js";
+export * from "./work-ledger-types.js";
+function build(args, kind, field) {
+    const fields = ownWorkFields(args);
+    const required = ["eventId", "now", field];
+    if (Object.keys(fields).length !== required.length || required.some(key => !Object.hasOwn(fields, key))) {
+        throw new WorkInputError("WORK_SCHEMA_INVALID");
+    }
+    const now = fields.now.value;
+    if (!isDate(now) || Object.getPrototypeOf(now) !== Date.prototype || Reflect.ownKeys(now).length !== 0 ||
+        !Number.isFinite(Date.prototype.getTime.call(now)))
+        throw new WorkInputError("WORK_SCHEMA_INVALID");
+    const content = copyWorkJson(fields[field].value);
+    const candidate = copyWorkJson({ ledgerVersion: 4, event: kind, eventId: fields.eventId.value,
+        ts: Date.prototype.toISOString.call(now), payload: field === "payload" ? content : { [field]: content } });
+    const event = validateWorkEvent(candidate, true);
+    if (Buffer.byteLength(canonicalWorkJson(event), "utf8") > WORK_EVENT_BYTES)
+        throw new WorkInputError("WORK_LIMIT_EXCEEDED");
+    return freezeWork(event);
+}
+export function buildWorkRevisionEvent(args) {
+    return build(args, "work_revision", "revision");
+}
+export function buildWorkSnapshotEvent(args) {
+    return build(args, "work_snapshot", "snapshot");
+}
+export function buildWorkOccurrenceEvent(args) {
+    return build(args, "work_occurrence", "payload");
+}
+export function buildWorkAcceptanceEvent(args) {
+    return build(args, "work_acceptance", "payload");
+}
+function* lines(text) {
+    let start = 0, line = 1;
+    while (start < text.length) {
+        const end = text.indexOf("\n", start);
+        yield { text: text.slice(start, end === -1 ? text.length : end), line: line++ };
+        if (end === -1)
+            return;
+        start = end + 1;
+    }
+}
+const blank = (text) => /^[ \t\r]*$/.test(text);
+/** Diagnostic boundary: retain physical valid deliveries, never rewrite, deduplicate or elect a winner. */
+export function parseWorkLedgerText(text) {
+    const wholeError = (code) => freezeWork({ events: [], errors: [{ line: null, code }], complete: false });
+    if (typeof text !== "string")
+        return wholeError("WORK_SCHEMA_INVALID");
+    if (Buffer.byteLength(text, "utf8") > WORK_TEXT_BYTES)
+        return wholeError("WORK_LIMIT_EXCEEDED");
+    let records = 0;
+    for (const row of lines(text))
+        if (!blank(row.text) && ++records > WORK_RECORDS)
+            return wholeError("WORK_LIMIT_EXCEEDED");
+    const events = [], errors = [];
+    for (const row of lines(text)) {
+        if (blank(row.text))
+            continue;
+        try {
+            events.push(validateWorkEvent(parseWorkJson(row.text)));
+        }
+        catch (error) {
+            if (!(error instanceof WorkInputError))
+                throw error;
+            errors.push({ line: row.line, code: error.code });
+        }
+    }
+    return freezeWork({ events, errors, complete: errors.length === 0 });
+}
+/** Public opt-in projection: strict text, detached host context, exact selection, actual runtime,
+ * then conditional authority binding. No I/O, authenticator, ambient trust or acceptance callback. */
+export function projectWorkLedger(text, context = { selectedSnapshot: null, authority: null }) {
+    const index = indexWorkLedgerText(text);
+    const errors = [...index.ingestion.errors];
+    let copied = null;
+    try {
+        const value = copyWorkJson(context);
+        validateWorkContext(value);
+        copied = JSON.parse(canonicalWorkJson(value));
+    }
+    catch (error) {
+        if (!(error instanceof WorkInputError))
+            throw error;
+        errors.push({ line: null, code: "WORK_CONTEXT_INVALID" });
+    }
+    errors.sort((a, b) => (a.line ?? Infinity) - (b.line ?? Infinity) || (a.code < b.code ? -1 : a.code > b.code ? 1 : 0));
+    const conflicts = mergeWorkConflicts([
+        ...index.conflictingEvents.map(ref => ({ kind: "event", id: ref.eventId, digests: [ref.digest], affectedObligations: [] })),
+        ...indexWorkReceipts(copied?.authority ?? null).conflicts,
+    ]);
+    const identities = { selectedSnapshot: copied?.selectedSnapshot?.snapshot ?? null, authoritySnapshot: copied?.authority?.snapshot ?? null };
+    function empty(scopeState, problems, retained = conflicts) {
+        return freezeWork({ ...identities, scopeState, progress: null, obligations: [], claims: [], supersededClaims: 0,
+            conflicts: mergeWorkConflicts([...retained, ...conflicts]), problems, errors, runtime: null });
+    }
+    if (errors.length)
+        return empty("unresolved", [{ code: "INPUT_INCOMPLETE", reference: null, affectedObligations: [] }]);
+    const structure = resolveWorkSnapshotText(text, copied.selectedSnapshot);
+    if (structure.scopeState !== "valid")
+        return empty(structure.scopeState, structure.problems, structure.conflicts);
+    const runtime = foldWorkOccurrences(index, structure.snapshot);
+    const acceptance = projectWorkAcceptance(index, structure, copied.authority, runtime);
+    return freezeWork({ ...identities, scopeState: "valid", ...acceptance, errors, runtime: runtime.runtime });
+}
+/** Always opt-in, strict, and detached before the first filesystem await. No environment defaults. */
+export function appendWorkLedgerEvent(options, event) {
+    return appendWorkEvent(options, event, false);
+}
+/** Explicit controller application seam: exact ID/digest redelivery does not append a second event. */
+export function appendWorkLedgerEventOnce(options, event) {
+    return appendWorkEvent(options, event, true);
+}
+async function appendWorkEvent(options, event, once) {
+    const fields = ownWorkFields(options);
+    if (Object.keys(fields).length !== 2 || !Object.hasOwn(fields, "path") || !Object.hasOwn(fields, "grantLedgerPath") || typeof fields.path.value !== "string" ||
+        (fields.grantLedgerPath.value !== null && typeof fields.grantLedgerPath.value !== "string"))
+        throw new WorkInputError("WORK_SCHEMA_INVALID");
+    const path = fields.path.value, grant = fields.grantLedgerPath.value;
+    const candidate = validateWorkEvent(copyWorkJson(event));
+    const canonical = canonicalWorkJson(candidate);
+    if (Buffer.byteLength(canonical, "utf8") > WORK_EVENT_BYTES)
+        throw new WorkInputError("WORK_LIMIT_EXCEEDED");
+    try {
+        const destination = await workDestination(path, grant);
+        await appendLedgerLine({ path: destination.path }, canonical + "\n", destination, once ? { eventId: candidate.eventId, digest: candidate.digest } : undefined);
+    }
+    catch (error) {
+        if (error instanceof LockTimeoutError || workFsError(error))
+            throw new WorkLedgerWriteError("WORK_LEDGER_WRITE_FAILED");
+        throw error;
+    }
+}
+/** Read-only regular-file inspection; a successful read is not a content-validity or acceptance claim. */
+export async function inspectWorkLedger(options, context = { selectedSnapshot: null, authority: null }) {
+    let exists = null;
+    const failure = (code) => freezeWork({
+        version: 4, status: "error", exists, ingestion: null, projection: null, errors: [{ line: null, code }],
+    });
+    const missing = () => freezeWork({ version: 4, status: "missing", exists: false,
+        ingestion: null, projection: null, errors: [] });
+    let path, copied;
+    try {
+        const fields = ownWorkFields(options);
+        if (Object.keys(fields).length !== 2 || !Object.hasOwn(fields, "path") || !Object.hasOwn(fields, "version") || typeof fields.path.value !== "string")
+            throw new WorkInputError("WORK_SCHEMA_INVALID");
+        if (fields.version.value !== 4)
+            throw new WorkInputError("WORK_VERSION_UNSUPPORTED");
+        path = fields.path.value;
+        try {
+            const value = copyWorkJson(context);
+            validateWorkContext(value);
+            copied = value;
+        }
+        catch (error) {
+            if (error instanceof WorkInputError)
+                throw new WorkInputError("WORK_CONTEXT_INVALID");
+            throw error;
+        }
+    }
+    catch (error) {
+        if (error instanceof WorkInputError)
+            return failure(error.code);
+        throw error;
+    }
+    if (!validWorkPath(path))
+        return failure("WORK_INSPECTION_PATH_INVALID");
+    try {
+        let info;
+        try {
+            info = await stat(path);
+        }
+        catch (error) {
+            if (workFsError(error) && error.code === "ENOENT")
+                return missing();
+            throw error;
+        }
+        exists = true;
+        if (!info.isFile())
+            return failure("WORK_INSPECTION_NOT_REGULAR");
+        let handle;
+        try {
+            handle = await open(path, constants.O_RDONLY | constants.O_NONBLOCK);
+        }
+        catch (error) {
+            if (workFsError(error) && error.code === "ENOENT")
+                return missing();
+            throw error;
+        }
+        let failed = false, bytes;
+        try {
+            if (!(await handle.stat()).isFile())
+                return failure("WORK_INSPECTION_NOT_REGULAR");
+            bytes = await readWorkBytes(handle);
+        }
+        catch (error) {
+            failed = true;
+            throw error;
+        }
+        finally {
+            await closeWorkHandle(handle, failed);
+        }
+        const text = bytes.toString("utf8");
+        return freezeWork({ version: 4, status: "read", exists: true, ingestion: parseWorkLedgerText(text), projection: projectWorkLedger(text, copied), errors: [] });
+    }
+    catch (error) {
+        if (error instanceof WorkInputError)
+            return failure(error.code);
+        if (workFsError(error))
+            return failure("WORK_INSPECTION_READ_FAILED");
+        throw error;
+    }
+}
+//# sourceMappingURL=work-ledger.js.map

package/dist/work-ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-ledger.js","sourceRoot":"","sources":["../src/work-ledger.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EACzE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,GACpE,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC5G,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EACL,cAAc,EAIuB,oBAAoB,GAC1D,MAAM,wBAAwB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AAEvC,SAAS,KAAK,CAAC,IAAa,EAAE,IAAmB,EAAE,KAA0C;IAC3F,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QACxG,MAAM,IAAI,cAAc,CAAC,qBAAqB,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC;QAClG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,qBAAqB,CAAC,CAAC;IACxG,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;QAC3F,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7G,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG,gBAAgB;QAAE,MAAM,IAAI,cAAc,CAAC,qBAAqB,CAAC,CAAC;IAC5H,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAA4E;IACjH,OAAO,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,CAAkC,CAAC;AACnF,CAAC;AACD,MAAM,UAAU,sBAAsB,CAAC,IAA4E;IACjH,OAAO,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,CAAkC,CAAC;AACnF,CAAC;AACD,MAAM,UAAU,wBAAwB,CAAC,IAAoE;IAC3G,OAAO,KAAK,CAAC,IAAI,EAAE,iBAAiB,EAAE,SAAS,CAAoC,CAAC;AACtF,CAAC;AACD,MAAM,UAAU,wBAAwB,CAAC,IAAoE;IAC3G,OAAO,KAAK,CAAC,IAAI,EAAE,iBAAiB,EAAE,SAAS,CAAoC,CAAC;AACtF,CAAC;AAED,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAY;IAC1B,IAAI,KAAK,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC;IACxB,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QAChF,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO;QACvB,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AACD,MAAM,KAAK,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEjE,2GAA2G;AAC3G,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,UAAU,GAAG,CAAC,IAA4B,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACjI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,eAAe;QAAE,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAChG,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY;YAAE,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAC1H,MAAM,MAAM,GAAsB,EAAE,EAAE,MAAM,GAAqB,EAAE,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC9B,IAAI,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;QAChE,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,KAAK,YAAY,cAAc,CAAC;gBAAE,MAAM,KAAK,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;AACvE,CAAC;AAED;sGACsG;AACtG,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,UAA6C,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IACtI,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAiC,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzE,IAAI,MAAM,GAA6C,IAAI,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACpC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAA0B,CAAC;IACzE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,cAAc,CAAC;YAAE,MAAM,KAAK,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvH,MAAM,SAAS,GAAG,kBAAkB,CAAC;QACnC,GAAG,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC,CAAC;QACpI,GAAG,iBAAiB,CAAC,MAAM,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC,SAAS;KAC1D,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,IAAI,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC;IAC5I,SAAS,KAAK,CAAC,UAAwC,EAAE,QAA4C,EAAE,WAAgD,SAAS;QAC9J,OAAO,UAAU,CAAC,EAAE,GAAG,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC;YAC7G,SAAS,EAAE,kBAAkB,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACnG,CAAC;IACD,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACxH,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,EAAE,MAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1E,IAAI,SAAS,CAAC,UAAU,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClH,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,QAAS,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACvF,OAAO,UAAU,CAAC,EAAE,GAAG,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAC7G,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,qBAAqB,CAAC,OAAyD,EAAE,KAAkC;IACjI,OAAO,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AACD,uGAAuG;AACvG,MAAM,UAAU,yBAAyB,CAAC,OAAyD,EAAE,KAAkC;IACrI,OAAO,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC;AACD,KAAK,UAAU,eAAe,CAAC,OAAyD,EAAE,KAAkC,EAAE,IAAa;IACzI,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ;QACxJ,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,KAAK,QAAQ,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,qBAAqB,CAAC,CAAC;IACjJ,MAAM,IAAI,GAAW,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAkB,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC;IAC5F,MAAM,SAAS,GAAG,iBAAiB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,gBAAgB;QAAE,MAAM,IAAI,cAAc,CAAC,qBAAqB,CAAC,CAAC;IAC7G,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvD,MAAM,gBAAgB,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,EAAE,SAAS,GAAG,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjK,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAgB,IAAI,WAAW,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,oBAAoB,CAAC,0BAA0B,CAAC,CAAC;QACxH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,0GAA0G;AAC1G,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAqC,EAC3E,UAA6C,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IACxF,IAAI,MAAM,GAAmB,IAAI,CAAC;IAClC,MAAM,OAAO,GAAG,CAAC,IAAsC,EAAoC,EAAE,CAAC,UAAU,CAAC;QACvG,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;KACvG,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAqC,EAAE,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK;QAC/G,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IACnD,IAAI,IAAY,EAAE,MAAyC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ;YAAE,MAAM,IAAI,cAAc,CAAC,qBAAqB,CAAC,CAAC;QACtM,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC;YAAE,MAAM,IAAI,cAAc,CAAC,0BAA0B,CAAC,CAAC;QACrF,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC;YAAC,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAAC,MAAM,GAAG,KAAqD,CAAC;QAAC,CAAC;QACxI,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,KAAK,YAAY,cAAc;gBAAE,MAAM,IAAI,cAAc,CAAC,sBAAsB,CAAC,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;IACvH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,IAAI,KAAK,YAAY,cAAc;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;IACjG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACzE,IAAI,CAAC;QACH,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YAAC,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAChC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,OAAO,EAAE,CAAC;YACpE,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,GAAG,IAAI,CAAC;QACd,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,OAAO,OAAO,CAAC,6BAA6B,CAAC,CAAC;QAClE,IAAI,MAAwC,CAAC;QAC7C,IAAI,CAAC;YAAC,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QAAC,CAAC;QAC7E,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,OAAO,EAAE,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;QACnG,IAAI,MAAM,GAAG,KAAK,EAAE,KAAa,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;gBAAE,OAAO,OAAO,CAAC,6BAA6B,CAAC,CAAC;YACnF,KAAK,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,MAAM,GAAG,IAAI,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;gBACvC,CAAC;YAAC,MAAM,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IACjK,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,WAAW,CAAC,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACtE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/extensions/daily-dashboard-session.ts

@@ -0,0 +1,30 @@
+import { createHash } from "node:crypto";
+import { homedir } from "node:os";
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { adoptDashboardHarnessBridge } from "../src/dashboard-harness.ts";
+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";
+
+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`)};}
+export function createDailyDashboardSession(input:{ordinary:()=>OrdinaryChildren;declared:()=>DeclaredWorkState|undefined;cwd:()=>string;env:Record<string,string|undefined>;author:string}){
+ let current:null|Awaited<ReturnType<typeof startDailyDashboardHost>>=null,publishedSocket:string|undefined;
+ return Object.freeze({
+  async run(target:string){
+   if(target==="stop"){
+    if(!current)return "daily host is not running";await current.close();current=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(!idPattern.test(target))throw Error("usage — /grants host <fresh-id> | stop");if(current)throw Error("daily host already running in this session; stop it before selecting another fresh id");
+   const declared=input.declared();if(!declared)throw Error("declare current work first with pi-daddy work add, then reload");
+   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");
+   const paths=dailyDashboardPaths(input.cwd(),target);await mkdir(join(homedir(),".local","state","pi-daddy","hosts"),{recursive:true,mode:0o700});await mkdir(paths.socketDirectory,{recursive:true,mode:0o700});
+   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});
+   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 action keys. 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;publishedSocket=undefined;}
+ });
+}

package/extensions/daily-work-session.ts

@@ -0,0 +1,20 @@
+import type { DeclaredWorkState } from "../src/work-command.ts";
+import { ENV_DAILY_SELECTION, ENV_DAILY_WORK } from "../src/dashboard-cli.ts";
+
+export interface PublishedDailyWork { work?: string; selection?: string }
+
+/** Replace only values this extension instance published; an operator override is never deleted. */
+export function replacePublishedDailyWork(
+  env: Record<string, string | undefined>,
+  published: PublishedDailyWork,
+  state: Pick<DeclaredWorkState, "ledgerPath" | "selectedSnapshot"> | undefined,
+): void {
+  if (published.work && env[ENV_DAILY_WORK] === published.work) delete env[ENV_DAILY_WORK];
+  if (published.selection && env[ENV_DAILY_SELECTION] === published.selection) delete env[ENV_DAILY_SELECTION];
+  delete published.work; delete published.selection;
+  if (!state) return;
+  published.work = state.ledgerPath;
+  published.selection = JSON.stringify(state.selectedSnapshot);
+  env[ENV_DAILY_WORK] = published.work;
+  env[ENV_DAILY_SELECTION] = published.selection;
+}

package/extensions/delegate-chain.ts

@@ -251,6 +251,7 @@ export function registerChainTool(pi: ExtensionAPI, session: GrantsSession): voi
           signal,
           {
             preApproved: availableForStep,
+            toolCallId: _toolCallId,
             // Only approvals actually offered to this step are attributed or consumed here.
             approvalFacts: chainApprovalFacts(approvalAudit, availableForStep, step.agent ?? DELEGATE_SUBJECT),
             onProgress: (update) => {

package/extensions/delegation-native.ts

@@ -0,0 +1,12 @@
+import { allocateNativeSessionTarget } from "../src/native-session-target.ts";
+import type { GrantsSession } from "./session.ts";
+import type { ExecutionOccurrenceIds } from "./execution-occurrence.ts";
+/** Shared delegate/all/chain host setup, before planning/audit; no tool-schema destination parameter. */
+export async function nativeDelegationContext(session:GrantsSession,ids:ExecutionOccurrenceIds,budget:number|undefined,refused:boolean){
+  let sessionFile:string|undefined,refusal:string|undefined;
+  if(!refused&&session.nativeSessionRoot!==undefined){
+    try{sessionFile=await allocateNativeSessionTarget(session.nativeSessionRoot,ids.executionId);}
+    catch(error){refusal=`native retention target refused (${String(error)})`;}
+  }
+  return {extra:{fanoutBudget:budget,spawnId:ids.parentId,childSpawnId:ids.childId,childExecutionId:ids.executionId,sessionFile},refusal};
+}