@telora/daemon 0.22.137 → 0.22.144

package/dist/resolvers/shared/reality-tree-arrival.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The canonical arrival verdict, as a prompt consumer reads it.
+ *
+ * `reality_tree_dump` computes arrival server-side (product-api
+ * handlers/reality-tree/tree-crud.ts) by putting every retired injection's
+ * anchored deliveries to the same predicate the verify path uses to refuse a
+ * new unearned promotion. This module does NOT recompute any of that -- it
+ * VALIDATES the returned block and RENDERS it. A second implementation would
+ * give the dashboard and the audit pass two answers to one question.
+ *
+ * Why it must be rendered at all: a retired injection is absent from the
+ * active-node listing the snapshot renders, so a tree whose UDEs were all
+ * promoted by an unearned retirement reads as an empty, finished tree. The
+ * hold is visible ONLY here.
+ *
+ * Every read resolves to one of two states -- a verdict, or UNREADABLE. There
+ * is no third state in which the absence of a verdict renders as nothing: a
+ * verdict nobody could read is not an earned one, and a section that silently
+ * disappears is the failure this module exists to prevent.
+ */
+/** One delivery holding a retirement back, named rather than counted. */
+export interface ArrivalBlockingDelivery {
+    deliveryId: string;
+    deliveryName: string;
+    executionStatus: string | null;
+}
+/** One retired injection whose promotion the work under it has not earned. */
+export interface ArrivalUnearnedRetirement {
+    nodeId: string;
+    seq: number;
+    blockingDeliveries: ArrivalBlockingDelivery[];
+}
+/** The `arrival` block of a `reality_tree_dump` response. */
+export interface TreeArrivalVerdict {
+    allEarned: boolean;
+    examined: number;
+    unearnedRetirements: ArrivalUnearnedRetirement[];
+}
+/** The shape of a dump response this module reads (it reads only `arrival`). */
+export interface RealityTreeDumpResponse {
+    arrival?: unknown;
+}
+/**
+ * The outcome of one tree's arrival read. `unreadable` carries WHY, because a
+ * bare "unknown" tells the assessor only that the line is not green.
+ */
+export type ArrivalRead = {
+    kind: 'verdict';
+    verdict: TreeArrivalVerdict;
+} | {
+    kind: 'unreadable';
+    reason: string;
+};
+/**
+ * Validate a dump response's `arrival` block. A response predating the block,
+ * or carrying a shape this reader cannot trust, is UNREADABLE -- never an
+ * implied "earned". Fails closed on every malformed field.
+ */
+export declare function parseArrivalBlock(payload: unknown): ArrivalRead;
+/**
+ * Render one tree's arrival read for the assessor. Always returns a non-empty
+ * section: there is no input for which arrival silently disappears.
+ */
+export declare function renderArrivalSection(read: ArrivalRead): string;
+/**
+ * The whole-snapshot failure state. The snapshot used to render '' when its
+ * reads threw, which is indistinguishable to the assessor from a focus with no
+ * tree at all -- and therefore from an arrived one.
+ */
+export declare function renderSnapshotReadFailure(reason: string): string;
+//# sourceMappingURL=reality-tree-arrival.d.ts.map

package/dist/resolvers/shared/reality-tree-arrival.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reality-tree-arrival.d.ts","sourceRoot":"","sources":["../../../src/resolvers/shared/reality-tree-arrival.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,yEAAyE;AACzE,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;CAC/C;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,yBAAyB,EAAE,CAAC;CAClD;AAED,gFAAgF;AAChF,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAiC3C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAsB/D;AAkDD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAM9D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQhE"}

package/dist/resolvers/shared/reality-tree-arrival.js

@@ -0,0 +1,129 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/resolvers/shared/reality-tree-arrival.test.ts
+// PINNED-BY-END
+function unreadable(reason) {
+    return { kind: 'unreadable', reason };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function parseBlockingDelivery(value) {
+    if (!isRecord(value))
+        return null;
+    const { deliveryId, deliveryName, executionStatus } = value;
+    if (typeof deliveryId !== 'string' || typeof deliveryName !== 'string')
+        return null;
+    const status = typeof executionStatus === 'string' || executionStatus === null ? executionStatus : null;
+    return { deliveryId, deliveryName, executionStatus: status };
+}
+function parseUnearnedRetirement(value) {
+    if (!isRecord(value))
+        return null;
+    const { nodeId, seq, blockingDeliveries } = value;
+    if (typeof nodeId !== 'string' || typeof seq !== 'number')
+        return null;
+    if (!Array.isArray(blockingDeliveries))
+        return null;
+    const parsed = [];
+    for (const entry of blockingDeliveries) {
+        const delivery = parseBlockingDelivery(entry);
+        if (delivery === null)
+            return null;
+        parsed.push(delivery);
+    }
+    return { nodeId, seq, blockingDeliveries: parsed };
+}
+/**
+ * Validate a dump response's `arrival` block. A response predating the block,
+ * or carrying a shape this reader cannot trust, is UNREADABLE -- never an
+ * implied "earned". Fails closed on every malformed field.
+ */
+export function parseArrivalBlock(payload) {
+    if (!isRecord(payload))
+        return unreadable('the dump response was not an object');
+    const raw = payload.arrival;
+    if (raw === undefined || raw === null) {
+        return unreadable('the dump carried no arrival block (an older deployment, or a partial response)');
+    }
+    if (!isRecord(raw))
+        return unreadable('the arrival block was not an object');
+    if (typeof raw.allEarned !== 'boolean')
+        return unreadable('the arrival block carried no allEarned verdict');
+    if (typeof raw.examined !== 'number')
+        return unreadable('the arrival block carried no examined count');
+    if (!Array.isArray(raw.unearnedRetirements)) {
+        return unreadable('the arrival block carried no unearnedRetirements list');
+    }
+    const findings = [];
+    for (const entry of raw.unearnedRetirements) {
+        const finding = parseUnearnedRetirement(entry);
+        if (finding === null)
+            return unreadable('the arrival block carried a malformed unearned retirement');
+        findings.push(finding);
+    }
+    return {
+        kind: 'verdict',
+        verdict: { allEarned: raw.allEarned, examined: raw.examined, unearnedRetirements: findings },
+    };
+}
+function renderBlockingDelivery(d) {
+    return `${d.deliveryName} (${d.executionStatus ?? 'no execution status'})`;
+}
+function renderNotArrived(verdict) {
+    const lines = [];
+    lines.push('#### Arrival: NOT ARRIVED');
+    lines.push('');
+    lines.push(`${verdict.unearnedRetirements.length} retired injection(s) on this tree were promoted ` +
+        'ahead of the work anchored under them. A retired injection is ABSENT from the active ' +
+        'node listing above, so this hold is visible only here: do not read an empty UDE or ' +
+        'injection list as a finished tree.');
+    for (const finding of verdict.unearnedRetirements) {
+        const blockers = finding.blockingDeliveries.length > 0
+            ? finding.blockingDeliveries.map(renderBlockingDelivery).join(', ')
+            : 'no delivery named (the verdict listed none)';
+        lines.push(`- injection #${finding.seq} -- held by: ${blockers}`);
+    }
+    return lines.join('\n');
+}
+function renderArrived(verdict) {
+    if (verdict.examined === 0) {
+        return ('#### Arrival: no retired injection to examine (0 examined)\n\n' +
+            '_"All earned" over an empty retired set is a true statement about nothing._ It is ' +
+            'not evidence that this tree arrived.');
+    }
+    return (`#### Arrival: every retired promotion earned (${verdict.examined} examined)\n\n` +
+        'No retired injection on this tree was promoted ahead of the delivery anchored under ' +
+        'it, per the canonical server-side verdict.');
+}
+function renderUnreadable(reason) {
+    return ('#### Arrival: UNKNOWN -- READ FAILED\n\n' +
+        `_The canonical arrival verdict could not be read for this tree: ${reason}._ ` +
+        'Treat this tree as NOT ARRIVED. An unread verdict is not an earned one, and nobody ' +
+        'looked must never read the same as nothing there -- do not conclude this focus is ' +
+        'finished on this tree\'s evidence.');
+}
+/**
+ * Render one tree's arrival read for the assessor. Always returns a non-empty
+ * section: there is no input for which arrival silently disappears.
+ */
+export function renderArrivalSection(read) {
+    if (read.kind === 'unreadable')
+        return renderUnreadable(read.reason);
+    if (!read.verdict.allEarned || read.verdict.unearnedRetirements.length > 0) {
+        return renderNotArrived(read.verdict);
+    }
+    return renderArrived(read.verdict);
+}
+/**
+ * The whole-snapshot failure state. The snapshot used to render '' when its
+ * reads threw, which is indistinguishable to the assessor from a focus with no
+ * tree at all -- and therefore from an arrived one.
+ */
+export function renderSnapshotReadFailure(reason) {
+    return ('## Reality Tree Snapshot\n\n' +
+        `_READ FAILED -- the focus's reality tree(s) could not be read: ${reason}._ ` +
+        'This is not an empty tree and not an arrived one: the current graph and its arrival ' +
+        'verdict are both UNKNOWN for this pass. Do not conclude anything about arrival, and ' +
+        'do not treat unseen structure as absent structure.');
+}
+//# sourceMappingURL=reality-tree-arrival.js.map

package/dist/resolvers/shared/reality-tree-arrival.js.map

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

package/dist/testing/fixtures/index.js

@@ -1,5 +1,5 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: 194 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/testing/fixtures/index.ts
+// Pinned by: 197 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/testing/fixtures/index.ts
 // PINNED-BY-END
 /**
  * Build an ActiveFocusRow (a getActiveFocuses row): an active, armed focus with

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telora/daemon",
-  "version": "0.22.137",
+  "version": "0.22.144",
   "description": "Agent orchestration daemon for Telora - spawns and manages Claude Code instances",
   "type": "module",
   "bin": {
@@ -38,7 +38,7 @@
   "//testRunner": "Uses Node.js built-in test runner (node:test) via tsx for TypeScript support. The root package uses Vitest; this is a deliberate choice for the daemon package to avoid framework dependencies. Test files live beside the modules they exercise (owner-directory layout); the runner discovers them recursively.",
   "dependencies": {
     "@telora/daemon-core": "^0.2.98",
-    "@telora/mcp-products": "^0.22.154",
+    "@telora/mcp-products": "^0.22.155",
     "commander": "^14.0.3",
     "yaml": "^2.4.0",
     "zod": "^4.3.6"