@telora/daemon 0.21.26 → 0.21.82

package/dist/queries/workflows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/queries/workflows.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAqC,MAAM,aAAa,CAAC;AAO/E;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmBlF;AAED;;;;GAIG;AACH,wBAAsB,qCAAqC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4BjG"}
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/queries/workflows.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAqC,MAAM,mBAAmB,CAAC;AAOrF;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmBlF;AAED;;;;GAIG;AACH,wBAAsB,qCAAqC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4BjG"}

package/dist/queries/worktrees.d.ts

@@ -4,19 +4,19 @@
  * CRUD operations for the focus_worktrees table.
  * Used by the write-through cache in focus-worktree-state.ts.
  */
+import { z } from 'zod';
+import { WorktreeRecordShape } from './schemas.js';
 /**
  * A worktree record from the database.
+ *
+ * DERIVED from WorktreeRecordSchema (queries/schemas.ts) via z.infer, so the
+ * runtime parse schema and this type are ONE definition and cannot drift -- add
+ * a field to WorktreeRecordShape and it flows here. The schema fields matched
+ * the former hand-written interface exactly (both camelCase; productId is the
+ * nullish `string | null | undefined` on an optional key), so no reconciliation
+ * override is needed -- the same clean derivation as FocusIssueInfo.
  */
-export interface WorktreeRecord {
-    id: string;
-    focusId: string;
-    productId?: string | null;
-    worktreePath: string;
-    branchName: string;
-    status: string;
-    createdAt: string;
-    updatedAt: string;
-}
+export type WorktreeRecord = z.infer<typeof WorktreeRecordShape>;
 /**
  * Upsert a worktree record (create or update by focus_id).
  */

package/dist/queries/worktrees.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worktrees.d.ts","sourceRoot":"","sources":["../../src/queries/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAe1B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAOvF"}
+{"version":3,"file":"worktrees.d.ts","sourceRoot":"","sources":["../../src/queries/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,mBAAmB,EAGpB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEjE;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAe1B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAOvF"}

package/dist/queries/worktrees.js.map

@@ -1 +1 @@
-{"version":3,"file":"worktrees.js","sourceRoot":"","sources":["../../src/queries/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAgBtB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAM1C;IACC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,wBAAwB,EACxB,4BAA4B,EAC5B;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE;YACN,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB;KACF,CACF,CAAC;IACF,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAe;IACxD,MAAM,OAAO,CAAC,wBAAwB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,SAAkB;IAC1D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,sBAAsB,EACtB,0BAA0B,EAC1B,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAC/B,CAAC;IACF,OAAO,MAAM,CAAC,SAAS,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"worktrees.js","sourceRoot":"","sources":["../../src/queries/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAEL,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AActB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAM1C;IACC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,wBAAwB,EACxB,4BAA4B,EAC5B;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE;YACN,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB;KACF,CACF,CAAC;IACF,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAe;IACxD,MAAM,OAAO,CAAC,wBAAwB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,SAAkB;IAC1D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,sBAAsB,EACtB,0BAA0B,EAC1B,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAC/B,CAAC;IACF,OAAO,MAAM,CAAC,SAAS,CAAC;AAC1B,CAAC"}

package/dist/reality/realign-apply.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Apply ratified CRT drift proposals to the reality tree.
+ *
+ * Differential Focus Spec: AI surfaces drift proposals; humans ratify; the
+ * loop's realign_crt phase applies ratified-but-not-yet-applied proposals to
+ * the graph and transitions each from `ratified` -> `applied`.
+ *
+ * Per-kind apply paths:
+ *   - update_statement     -- patch node.statement
+ *   - add_node             -- create new CRT node
+ *   - retire_node          -- soft-retire node (cascade handled by edge function)
+ *   - change_node_type     -- update node_type
+ *   - flip_ude_to_de       -- promote UDE -> DE (constrained change_node_type)
+ *   - demote_de_to_ude     -- reverse a DE -> UDE (records a symmetric history snapshot)
+ *
+ * Failures on a single proposal MUST NOT abort the rest -- we collect the
+ * error and continue. The dispatcher only marks_applied on success.
+ *
+ * @module realign-apply
+ */
+import { type RestatementInputs, type RestatementOptions } from '../verify/de-restatement.js';
+/** Local string-literal union -- intentionally not imported from supabase types. */
+export type ProposalKind = 'update_statement' | 'add_node' | 'retire_node' | 'change_node_type' | 'flip_ude_to_de' | 'demote_de_to_ude';
+export interface DriftProposal {
+    id: string;
+    organizationId: string;
+    productId: string;
+    realityTreeId: string;
+    focusId: string | null;
+    nodeId: string | null;
+    proposalKind: ProposalKind;
+    observedState: string;
+    proposedCorrection: string;
+    proposedMetadata: Record<string, unknown> | null;
+    status: 'proposed' | 'ratified' | 'dismissed' | 'applied';
+    createdBySessionId: string | null;
+    ratifiedBy: string | null;
+    ratifiedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Signature of the desired-effect restatement helper (injectable for tests). */
+export type AuthorRestatementFn = (inputs: RestatementInputs, opts?: RestatementOptions) => Promise<string>;
+export interface ApplyRatifiedDeps {
+    callApi?: <T>(action: string, params?: Record<string, unknown>) => Promise<T>;
+    /** Authors a positive desired-effect sentence. Defaults to the de-restatement helper. */
+    authorRestatement?: AuthorRestatementFn;
+}
+export interface ApplyRatifiedResult {
+    applied: number;
+    failed: number;
+    errors: string[];
+}
+/**
+ * Fetch all ratified-but-not-applied drift proposals for the focus and
+ * dispatch each one to its per-kind handler. On handler success, transition
+ * the proposal `ratified` -> `applied`. On handler failure, record the error
+ * and continue with the next proposal.
+ *
+ * Returns counts and accumulated error messages. Never throws on per-proposal
+ * failures; only the initial list call is allowed to propagate a fatal error
+ * (e.g. circuit breaker open) that should stop the whole phase.
+ */
+export declare function applyRatifiedProposals(focusId: string, deps?: ApplyRatifiedDeps): Promise<ApplyRatifiedResult>;
+//# sourceMappingURL=realign-apply.d.ts.map

package/dist/reality/realign-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realign-apply.d.ts","sourceRoot":"","sources":["../../src/reality/realign-apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AAqBrC,oFAAoF;AACpF,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,UAAU,GACV,aAAa,GACb,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjD,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1D,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,iFAAiF;AACjF,MAAM,MAAM,mBAAmB,GAAG,CAChC,MAAM,EAAE,iBAAiB,EACzB,IAAI,CAAC,EAAE,kBAAkB,KACtB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9E,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA8QD;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B"}

package/dist/reality/realign-apply.js

@@ -0,0 +1,302 @@
+/**
+ * Apply ratified CRT drift proposals to the reality tree.
+ *
+ * Differential Focus Spec: AI surfaces drift proposals; humans ratify; the
+ * loop's realign_crt phase applies ratified-but-not-yet-applied proposals to
+ * the graph and transitions each from `ratified` -> `applied`.
+ *
+ * Per-kind apply paths:
+ *   - update_statement     -- patch node.statement
+ *   - add_node             -- create new CRT node
+ *   - retire_node          -- soft-retire node (cascade handled by edge function)
+ *   - change_node_type     -- update node_type
+ *   - flip_ude_to_de       -- promote UDE -> DE (constrained change_node_type)
+ *   - demote_de_to_ude     -- reverse a DE -> UDE (records a symmetric history snapshot)
+ *
+ * Failures on a single proposal MUST NOT abort the rest -- we collect the
+ * error and continue. The dispatcher only marks_applied on success.
+ *
+ * @module realign-apply
+ */
+import { callApi as defaultCallApi } from '../queries/shared.js';
+import { authorRestatement as defaultAuthorRestatement, } from '../verify/de-restatement.js';
+// Legal CRT node types -- mirrored locally to avoid pulling in edge-function code.
+const NODE_TYPES = ['entity', 'undesired_effect', 'desired_effect', 'injection'];
+const VIEW_SCOPES = ['both', 'crt_only', 'frt_only'];
+function isNodeType(value) {
+    return typeof value === 'string' && NODE_TYPES.includes(value);
+}
+function isViewScope(value) {
+    return typeof value === 'string' && VIEW_SCOPES.includes(value);
+}
+/**
+ * Fetch a node's current statement by id. The node CRUD surface has no
+ * get-by-id action, so we list the tree's active nodes and find the match.
+ * Used only by the flip fallback when no proposed_correction was supplied.
+ */
+async function fetchNodeStatement(treeId, nodeId, callApi) {
+    const res = await callApi('reality_tree_node_list', { treeId });
+    const node = (res.items ?? []).find((n) => n.id === nodeId);
+    if (!node)
+        return null;
+    return {
+        statement: typeof node.statement === 'string' ? node.statement : '',
+        evidence: typeof node.evidence === 'string' ? node.evidence : null,
+    };
+}
+/**
+ * update_statement -- patch reality_tree_nodes.statement.
+ *
+ * Requires: nodeId on the proposal. The new statement is taken from
+ * proposed_correction (the canonical narrative correction surfaced by the AI).
+ */
+const handleUpdateStatement = async (proposal, callApi) => {
+    if (!proposal.nodeId) {
+        throw new Error('update_statement: nodeId is required');
+    }
+    const statement = proposal.proposedCorrection?.trim();
+    if (!statement) {
+        throw new Error('update_statement: proposed_correction must be a non-empty string');
+    }
+    await callApi('reality_tree_node_update', {
+        nodeId: proposal.nodeId,
+        statement,
+    });
+};
+/**
+ * add_node -- create a new CRT node from proposed_metadata.
+ *
+ * proposed_metadata must carry { statement, nodeType }. viewScope is
+ * optional and defaults to 'both' (a proposed CRT node is normally visible
+ * in both views unless explicitly restricted).
+ *
+ * Negative-branch wiring: when proposed_metadata carries a `sourceInjectionId`
+ * (the injection that introduces this new UDE -- see `negative-branch.ts`),
+ * after creating the node we wire a causal edge FROM the injection TO the new
+ * node so a ratified negative branch is structurally attached to the injection
+ * that introduced it. Absent sourceInjectionId, no edge is created (the plain
+ * add_node behavior is unchanged).
+ */
+const handleAddNode = async (proposal, callApi) => {
+    const meta = proposal.proposedMetadata ?? {};
+    const statement = meta.statement;
+    if (typeof statement !== 'string' || statement.trim() === '') {
+        throw new Error('add_node: proposed_metadata.statement must be a non-empty string');
+    }
+    const nodeType = meta.nodeType;
+    if (!isNodeType(nodeType)) {
+        throw new Error(`add_node: proposed_metadata.nodeType must be one of ${NODE_TYPES.join(',')}, got ${String(nodeType)}`);
+    }
+    const rawViewScope = meta.viewScope;
+    let viewScope = 'both';
+    if (rawViewScope !== undefined && rawViewScope !== null) {
+        if (!isViewScope(rawViewScope)) {
+            throw new Error(`add_node: proposed_metadata.viewScope must be one of ${VIEW_SCOPES.join(',')}, got ${String(rawViewScope)}`);
+        }
+        viewScope = rawViewScope;
+    }
+    // Negative-branch attachment: wire the injection -> new UDE causal edge.
+    const sourceInjectionId = meta.sourceInjectionId;
+    const createParams = {
+        treeId: proposal.realityTreeId,
+        statement: statement.trim(),
+        nodeType,
+        viewScope,
+    };
+    // Persist the source injection so the node carries the NB provenance signal.
+    if (typeof sourceInjectionId === 'string' && sourceInjectionId !== '') {
+        createParams.sourceInjectionId = sourceInjectionId;
+    }
+    const created = await callApi('reality_tree_node_create', createParams);
+    if (typeof sourceInjectionId === 'string' && sourceInjectionId !== '') {
+        const newNodeId = created?.node?.id;
+        if (typeof newNodeId !== 'string' || newNodeId === '') {
+            throw new Error('add_node: node_create did not return a node id; cannot wire sourceInjectionId edge');
+        }
+        await callApi('reality_tree_edge_create', {
+            treeId: proposal.realityTreeId,
+            fromNodeId: sourceInjectionId,
+            toNodeId: newNodeId,
+            edgeType: 'sufficient',
+        });
+    }
+};
+/**
+ * retire_node -- soft-retire the node. Cascade effects (edge cleanup,
+ * downstream UDE flipping for injection retirement) are owned by the edge
+ * function path; this handler does NOT duplicate them.
+ */
+const handleRetireNode = async (proposal, callApi) => {
+    if (!proposal.nodeId) {
+        throw new Error('retire_node: nodeId is required');
+    }
+    await callApi('reality_tree_node_retire', { nodeId: proposal.nodeId });
+};
+/**
+ * change_node_type -- update reality_tree_nodes.node_type.
+ *
+ * Validates the requested node_type against the legal NODE_TYPES set.
+ */
+const handleChangeNodeType = async (proposal, callApi) => {
+    if (!proposal.nodeId) {
+        throw new Error('change_node_type: nodeId is required');
+    }
+    const meta = proposal.proposedMetadata ?? {};
+    const nodeType = meta.nodeType;
+    if (!isNodeType(nodeType)) {
+        throw new Error(`change_node_type: proposed_metadata.nodeType must be one of ${NODE_TYPES.join(',')}, got ${String(nodeType)}`);
+    }
+    await callApi('reality_tree_node_update', {
+        nodeId: proposal.nodeId,
+        nodeType,
+    });
+};
+/**
+ * flip_ude_to_de -- constrained change_node_type for the canonical
+ * "this used to be undesired, now we observe it as desired (or vice versa)"
+ * realignment. observed_state declares the FROM type and must be UDE or DE;
+ * proposed_metadata.nodeType (or, by convention, the natural flip) is the
+ * TO type and must also be UDE or DE.
+ */
+const handleFlipUdeToDe = async (proposal, callApi, deps) => {
+    if (!proposal.nodeId) {
+        throw new Error('flip_ude_to_de: nodeId is required');
+    }
+    const fromType = proposal.observedState;
+    if (fromType !== 'undesired_effect' && fromType !== 'desired_effect') {
+        throw new Error(`flip_ude_to_de: observed_state (FROM) must be undesired_effect or desired_effect, got ${fromType}`);
+    }
+    const meta = proposal.proposedMetadata ?? {};
+    // Allow caller to provide an explicit target via proposed_metadata.nodeType;
+    // otherwise derive the natural flip from the FROM type.
+    const explicitTarget = meta.nodeType;
+    let toType;
+    if (explicitTarget !== undefined && explicitTarget !== null) {
+        if (!isNodeType(explicitTarget)) {
+            throw new Error(`flip_ude_to_de: proposed_metadata.nodeType must be one of ${NODE_TYPES.join(',')}, got ${String(explicitTarget)}`);
+        }
+        if (explicitTarget !== 'undesired_effect' && explicitTarget !== 'desired_effect') {
+            throw new Error(`flip_ude_to_de: target node_type must be undesired_effect or desired_effect, got ${explicitTarget}`);
+        }
+        toType = explicitTarget;
+    }
+    else {
+        toType = fromType === 'undesired_effect' ? 'desired_effect' : 'undesired_effect';
+    }
+    if (toType === fromType) {
+        throw new Error(`flip_ude_to_de: target node_type must differ from observed_state (${fromType})`);
+    }
+    const updates = {
+        nodeId: proposal.nodeId,
+        nodeType: toType,
+    };
+    // Couple type+text at the source: when flipping a UDE to a desired_effect,
+    // author the positive BASE statement in the same update so the former UDE
+    // never reads negatively. proposed_correction IS that restatement (the
+    // ai-inspection prompt instructs this for flip_ude_to_de); when it is blank
+    // we author it from the node's current UDE text via the helper, so no node
+    // is left with negative DE text via the source path. Base flips are
+    // observation-driven (no resolving injection), so we use observation mode.
+    if (toType === 'desired_effect') {
+        let baseStatement = proposal.proposedCorrection?.trim() ?? '';
+        if (!baseStatement) {
+            const node = await fetchNodeStatement(proposal.realityTreeId, proposal.nodeId, callApi);
+            if (node && node.statement.trim() !== '') {
+                baseStatement = (await deps.authorRestatement({
+                    udeStatement: node.statement,
+                    evidence: node.evidence ?? undefined,
+                })).trim();
+            }
+        }
+        if (baseStatement) {
+            updates.statement = baseStatement;
+        }
+    }
+    await callApi('reality_tree_node_update', updates);
+};
+/**
+ * demote_de_to_ude -- reverse a desired_effect back to an undesired_effect.
+ * The inverse of the UDE->DE flip, for correcting an erroneous or regressed
+ * flip. Routes through the dedicated `reality_tree_node_demote` edge action so
+ * the demote records a symmetric reality_tree_node_history snapshot and clears
+ * the FRT overlay in one place. proposed_correction, when present, is the UDE
+ * statement to restore; proposed_metadata.injectionId, when present, attributes
+ * the history snapshot (else the edge resolves it from the node's flip history).
+ *
+ * Human/agent-triggered only: the audit/propose phase never emits this kind.
+ */
+const handleDemoteDeToUde = async (proposal, callApi) => {
+    if (!proposal.nodeId) {
+        throw new Error('demote_de_to_ude: nodeId is required');
+    }
+    const body = { nodeId: proposal.nodeId };
+    const udeStatement = proposal.proposedCorrection?.trim();
+    if (udeStatement)
+        body.statement = udeStatement;
+    const meta = proposal.proposedMetadata ?? {};
+    if (typeof meta.injectionId === 'string' && meta.injectionId) {
+        body.injectionId = meta.injectionId;
+    }
+    await callApi('reality_tree_node_demote', body);
+};
+const HANDLERS = {
+    update_statement: handleUpdateStatement,
+    add_node: handleAddNode,
+    retire_node: handleRetireNode,
+    change_node_type: handleChangeNodeType,
+    flip_ude_to_de: handleFlipUdeToDe,
+    demote_de_to_ude: handleDemoteDeToUde,
+};
+// ---------------------------------------------------------------------------
+// Dispatcher
+// ---------------------------------------------------------------------------
+/**
+ * Fetch all ratified-but-not-applied drift proposals for the focus and
+ * dispatch each one to its per-kind handler. On handler success, transition
+ * the proposal `ratified` -> `applied`. On handler failure, record the error
+ * and continue with the next proposal.
+ *
+ * Returns counts and accumulated error messages. Never throws on per-proposal
+ * failures; only the initial list call is allowed to propagate a fatal error
+ * (e.g. circuit breaker open) that should stop the whole phase.
+ */
+export async function applyRatifiedProposals(focusId, deps = {}) {
+    const callApi = deps.callApi ?? defaultCallApi;
+    const handlerDeps = {
+        authorRestatement: deps.authorRestatement ?? defaultAuthorRestatement,
+    };
+    const list = await callApi('crt_drift_proposal_list', {
+        focusId,
+        status: 'ratified',
+    });
+    const proposals = list.items ?? [];
+    let applied = 0;
+    let failed = 0;
+    const errors = [];
+    for (const proposal of proposals) {
+        const handler = HANDLERS[proposal.proposalKind];
+        if (!handler) {
+            failed += 1;
+            errors.push(`proposal ${proposal.id}: unknown proposal_kind "${proposal.proposalKind}"`);
+            continue;
+        }
+        try {
+            await handler(proposal, callApi, handlerDeps);
+        }
+        catch (err) {
+            failed += 1;
+            errors.push(`proposal ${proposal.id} (${proposal.proposalKind}): ${err.message}`);
+            continue;
+        }
+        try {
+            await callApi('crt_drift_proposal_mark_applied', { proposalId: proposal.id });
+            applied += 1;
+        }
+        catch (err) {
+            failed += 1;
+            errors.push(`proposal ${proposal.id} mark_applied: ${err.message}`);
+        }
+    }
+    return { applied, failed, errors };
+}
+//# sourceMappingURL=realign-apply.js.map

package/dist/reality/realign-apply.js.map

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

package/dist/reality/reality-pole-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reality-pole-capture.d.ts","sourceRoot":"","sources":["../../src/reality/reality-pole-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAEL,kBAAkB,EAClB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAY3B,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACtE,6EAA6E;IAC7E,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACzD,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,kBAAkB,CAAC;CACzC;AAED,MAAM,WAAW,yBAAyB;IACxC,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAsDD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,uBAAuB,EAC7B,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,yBAAyB,CAAC,CA8BpC"}

package/dist/reality/reality-pole-capture.js

@@ -0,0 +1,114 @@
+/**
+ * Reality-pole capture: the daemon-lifecycle binding that POPULATES each
+ * assertional loop item's durable code anchor from a completed focus's git
+ * footprint. This is the production caller of reality-pole.ts -- without it the
+ * loop_context_code_anchor table stays empty and the context-lock tripwire
+ * (churn + embedding-distance) has no inputs (churned always false, distance
+ * always NULL).
+ *
+ * Runs on focus-team completion (after the status advance, before the merge),
+ * once per focus:
+ *   1. footprint = files the focus branch changed vs the integration base
+ *      (getDeliveryFootprint over the focus worktree -- the focus's cumulative,
+ *      DURABLE footprint, not a single transient delivery).
+ *   2. for each assertional loop item on the focus (documents + answers), upsert
+ *      its anchor to that footprint and embed it edge-side (writeRealityAnchor).
+ *
+ * The footprint is the focus's whole change set: a focus-level loop document is
+ * "about" the code its focus touched, so every focus item anchors to the same
+ * durable file set for v1. Per-delivery sub-scoping is a later refinement (the
+ * scope granularity is part of the still-firming cadence design).
+ *
+ * Embeddings measure ABOUTNESS not agreement -- the reality pole is a distance
+ * reference for the drift tripwire, never a truth oracle. FAIL-OPEN throughout:
+ * a missing anchor only degrades the churn-clock signal; it never wedges
+ * completion.
+ */
+import { getDeliveryFootprint, writeRealityAnchor, } from './reality-pole.js';
+import { callApi as defaultCallApi } from '../queries/shared.js';
+import { createLogger } from '../shell/log.js';
+const log = createLogger({ module: 'reality-pole' });
+/**
+ * Default enumeration of a focus's assertional loop items: documents on the
+ * focus + answers to the focus's questions. Reuses the existing loop list edge
+ * actions (no new endpoint). Fail-open per source -- a failed list yields fewer
+ * anchors, never a thrown completion.
+ */
+async function listFocusAssertionalItems(focusId) {
+    const targets = [];
+    try {
+        const docs = await defaultCallApi('loop_document_list', {
+            entityType: 'focus',
+            entityId: focusId,
+            detail: 'titles',
+            limit: 500,
+        });
+        for (const d of docs.items ?? [])
+            targets.push({ itemType: 'document', itemId: d.id });
+    }
+    catch (err) {
+        log.warn(`[reality-pole] list documents failed for focus ${focusId.slice(0, 8)}: ` +
+            `${err instanceof Error ? err.message : String(err)}`);
+    }
+    try {
+        const questions = await defaultCallApi('loop_question_list', {
+            entityType: 'focus',
+            entityId: focusId,
+            detail: 'titles',
+            limit: 500,
+        });
+        for (const q of questions.items ?? []) {
+            try {
+                const ans = await defaultCallApi('loop_answer_get', {
+                    questionId: q.id,
+                });
+                if (ans.answer?.id)
+                    targets.push({ itemType: 'answer', itemId: ans.answer.id });
+            }
+            catch (err) {
+                // No answer for this question -- skip.
+                log.debug('No answer for this question -- skip', { error: String(err?.message ?? err) });
+            }
+        }
+    }
+    catch (err) {
+        log.warn(`[reality-pole] list answers failed for focus ${focusId.slice(0, 8)}: ` +
+            `${err instanceof Error ? err.message : String(err)}`);
+    }
+    return targets;
+}
+/**
+ * Capture the focus's reality poles: anchor every assertional loop item to the
+ * focus's durable code footprint and embed it. Returns counts for logging.
+ *
+ * Skips entirely when the footprint is empty (no diff vs base -> nothing durable
+ * to anchor to). Each per-item write is fail-open (writeRealityAnchor never
+ * throws), so one bad item never aborts the rest.
+ */
+export async function captureRealityPoles(args, deps = {}) {
+    const getFootprint = deps.getFootprint ?? getDeliveryFootprint;
+    const listItems = deps.listItems ?? listFocusAssertionalItems;
+    const writeAnchor = deps.writeAnchor ?? writeRealityAnchor;
+    const files = getFootprint(args.worktreePath, args.baseBranch);
+    if (files.length === 0) {
+        return { fileCount: 0, itemCount: 0, anchored: 0 };
+    }
+    const items = await listItems(args.focusId);
+    let anchored = 0;
+    for (const item of items) {
+        const res = await writeAnchor({
+            organizationId: args.organizationId,
+            itemType: item.itemType,
+            itemId: item.itemId,
+            files,
+        });
+        if (res.anchorId)
+            anchored++;
+    }
+    if (items.length > 0) {
+        log.info(`[reality-pole] Focus ${args.focusId.slice(0, 8)}: anchored ${anchored}/${items.length} ` +
+            `loop items to ${files.length} footprint file(s).`);
+    }
+    return { fileCount: files.length, itemCount: items.length, anchored };
+}
+//# sourceMappingURL=reality-pole-capture.js.map

package/dist/reality/reality-pole-capture.js.map

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

package/dist/reality/reality-pole.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Reality pole: a loop-context item's anchor to the DURABLE CODE STRUCTURE it
+ * touches (the files a delivery changed) plus an embedding of that footprint.
+ *
+ * Embeddings here measure ABOUTNESS, not agreement: the reality pole is the
+ * code an item is about, used to compute topical DISTANCE (a drift tripwire),
+ * never a truth oracle. Two items pointing at the same files are "near" in this
+ * space whether or not they agree.
+ *
+ * The daemon has NO direct Supabase client and NO access to the embedding API
+ * key. So this module computes the git footprint locally and hands it to ONE
+ * edge action (daemon_loop_anchor_upsert) that upserts the anchor, embeds the
+ * footprint edge-side, and stores the vector. The daemon NEVER embeds directly.
+ */
+import { callApi as defaultCallApi } from '../queries/shared.js';
+/** A loop-context item type that can carry a reality anchor. */
+export type AnchorItemType = 'document' | 'answer';
+/**
+ * Build the embed input string from a footprint's file paths.
+ *
+ * PURE -- no IO. Deterministic: the paths are de-duplicated, sorted, and
+ * newline-joined so the same footprint always yields the same input (and thus
+ * the same reality-pole embedding). Capped to a sane length.
+ *
+ * The embedding of this string is the reality pole -- a measure of what code
+ * the item is ABOUT, for distance/drift, not a measure of correctness.
+ */
+export declare function footprintToEmbedInput(files: string[]): string;
+/**
+ * Get the changed files on the delivery branch vs the base branch.
+ *
+ * Resolves the delivery's diff range through the merge-aware seam
+ * (resolveDeliveryDiffRange -- base...HEAD while ahead, else the recorded/searched
+ * merge range) and runs `git diff --name-only <range>` in the worktree, so a
+ * branch already merged back still reports its footprint. Returns [] on any git
+ * failure or when no attributable range resolves -- NEVER throws.
+ */
+export declare function getDeliveryFootprint(worktreePath: string, baseBranch: string): string[];
+export interface WriteRealityAnchorArgs {
+    organizationId: string;
+    itemType: AnchorItemType;
+    itemId: string;
+    files: string[];
+    sourceDeliveryId?: string;
+}
+export interface WriteRealityAnchorOptions {
+    /** Injectable API caller (for tests). Defaults to the real `callApi`. */
+    callApi?: typeof defaultCallApi;
+}
+export interface WriteRealityAnchorResult {
+    anchorId: string | null;
+    embedded: boolean;
+}
+/**
+ * Write a loop-context item's reality anchor through the edge action.
+ *
+ * Builds the embed input from the footprint (footprintToEmbedInput) and calls
+ * daemon_loop_anchor_upsert, which upserts the anchor row AND embeds the
+ * footprint edge-side. Fail-open: on ANY error returns
+ * { anchorId: null, embedded: false } rather than throwing -- a missing anchor
+ * degrades the churn-clock signal, it never wedges the caller.
+ */
+export declare function writeRealityAnchor(args: WriteRealityAnchorArgs, opts?: WriteRealityAnchorOptions): Promise<WriteRealityAnchorResult>;
+//# sourceMappingURL=reality-pole.d.ts.map

package/dist/reality/reality-pole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reality-pole.d.ts","sourceRoot":"","sources":["../../src/reality/reality-pole.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMjE,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,CAAC;AASnD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAa7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBvF;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAWD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,sBAAsB,EAC5B,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,wBAAwB,CAAC,CAqBnC"}