@telora/daemon 0.16.33 → 0.16.44

package/dist/resolvers/shared/loop.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Per-delivery injection-bundle helpers shared across the loop.* resolvers
+ * (loop.injection, loop.frt_statement, loop.expected_effects,
+ * loop.upstream_udes, loop.delivery_index) and focus.anchoring_injections.
+ */
+import type { AssemblyContext } from '../../assembly-engine.js';
+/** Maximum BFS depth for upstream UDE walk in loop.upstream_udes. */
+export declare const MAX_UPSTREAM_DEPTH = 3;
+export interface InjectionContextItemBundle {
+    injection: {
+        id: string;
+        statement: string;
+        nodeType: string;
+        injectionStatus: string | null;
+        frtStatement: string | null;
+        frtNodeType: string | null;
+        dissolvesObstacle: string | null;
+        realityTreeId: string;
+        seq: number;
+    };
+    treeName: string;
+    treeId: string;
+    /**
+     * One-line Now->Target per targeted UDE (from the focus coordination map
+     * work): the UDE's current statement and the desired effect it becomes.
+     * reality_tree_injection_context populates this.
+     */
+    nowTargets?: {
+        seq: number;
+        now: string;
+        target: string | null;
+    }[];
+}
+/**
+ * Walk context.deliveryIds, return [deliveryId, injectionId] pairs for those
+ * with non-empty injection links. Empty array on lookup failure.
+ */
+export declare function getDeliveryInjectionPairs(context: AssemblyContext): Promise<Array<{
+    deliveryId: string;
+    deliveryName: string;
+    injectionId: string;
+}>>;
+/**
+ * Fetch a batch of injection nodes by their IDs via reality_tree_injection_context.
+ * Returns a Map keyed by injection node id.
+ */
+export declare function fetchInjectionBundles(injectionIds: string[]): Promise<Map<string, InjectionContextItemBundle>>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/resolvers/shared/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/resolvers/shared/loop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAIhE,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,aAAa,EAAE,MAAM,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;CACpE;AAOD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAOnF;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAUlD"}

package/dist/resolvers/shared/loop.js

@@ -0,0 +1,38 @@
+/**
+ * Per-delivery injection-bundle helpers shared across the loop.* resolvers
+ * (loop.injection, loop.frt_statement, loop.expected_effects,
+ * loop.upstream_udes, loop.delivery_index) and focus.anchoring_injections.
+ */
+import { getFocusDeliveries } from '../../queries/focuses.js';
+import { callApi } from '../../queries/shared.js';
+/** Maximum BFS depth for upstream UDE walk in loop.upstream_udes. */
+export const MAX_UPSTREAM_DEPTH = 3;
+/**
+ * Walk context.deliveryIds, return [deliveryId, injectionId] pairs for those
+ * with non-empty injection links. Empty array on lookup failure.
+ */
+export async function getDeliveryInjectionPairs(context) {
+    const deliveries = await getFocusDeliveries(context.focusId);
+    const wantedIds = new Set(context.deliveryIds);
+    return deliveries
+        .filter((d) => wantedIds.has(d.id))
+        .filter((d) => typeof d.injectionId === 'string' && d.injectionId.length > 0)
+        .map((d) => ({ deliveryId: d.id, deliveryName: d.name, injectionId: d.injectionId }));
+}
+/**
+ * Fetch a batch of injection nodes by their IDs via reality_tree_injection_context.
+ * Returns a Map keyed by injection node id.
+ */
+export async function fetchInjectionBundles(injectionIds) {
+    const out = new Map();
+    if (injectionIds.length === 0)
+        return out;
+    const resp = await callApi('reality_tree_injection_context', {
+        nodeIds: injectionIds,
+    });
+    for (const item of resp.items ?? []) {
+        out.set(item.injection.id, item);
+    }
+    return out;
+}
+//# sourceMappingURL=loop.js.map

package/dist/resolvers/shared/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../../src/resolvers/shared/loop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AA6BpC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAwB;IAExB,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,UAAU;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;SAC5E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAqB,EAAE,CAAC,CAAC,CAAC;AACpG,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAAsB;IAEtB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsC,CAAC;IAC1D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAiC,gCAAgC,EAAE;QAC3F,OAAO,EAAE,YAAY;KACtB,CAAC,CAAC;IACH,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACpC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/resolvers/shared/reality-metrics.d.ts

@@ -0,0 +1,63 @@
+/**
+ * reality_metrics_focus response types shared by reality.metrics and
+ * reality.projections.
+ */
+export interface RealityMetrics {
+    total_deliveries: number;
+    deliveries_planning: number;
+    deliveries_queued: number;
+    deliveries_coding: number;
+    deliveries_verify: number;
+    deliveries_done: number;
+    total_issues: number;
+    issues_todo: number;
+    issues_in_progress: number;
+    issues_done: number;
+    issues_blocked: number;
+    issues_done_7d: number;
+    issues_done_14d: number;
+    issues_done_30d: number;
+    avg_cycle_time_days: number | null;
+    blocked_count: number;
+    avg_blocked_duration_days: number | null;
+    session_count: number;
+    total_agent_cost: number;
+    total_agent_duration_seconds: number;
+    escalation_count: number;
+    last_session_at: string | null;
+    merge_count?: number;
+    merges_7d?: number;
+    merges_30d?: number;
+    last_merge_at?: string | null;
+}
+export interface CompletionProjection {
+    status: string;
+    remainingIssues: number;
+    velocity: number | null;
+    projectedCompletionDate: string | null;
+    daysRemaining: number | null;
+    confidence: number | null;
+    stalledReason?: string;
+    windowDays?: number;
+    completedInWindow?: number;
+}
+export interface CostProjection {
+    status: string;
+    costToDate: number;
+    burnRatePerDay: number;
+    avgCostPerIssue: number | null;
+    remainingIssues: number;
+    completedIssues?: number;
+    projectedRemainingCost: number | null;
+    projectedTotalCost: number | null;
+    windowDays?: number;
+}
+export interface RealityApiResponse {
+    focusId: string;
+    metrics: RealityMetrics | null;
+    projections: {
+        completion: CompletionProjection | null;
+        cost: CostProjection | null;
+    };
+}
+//# sourceMappingURL=reality-metrics.d.ts.map

package/dist/resolvers/shared/reality-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reality-metrics.d.ts","sourceRoot":"","sources":["../../../src/resolvers/shared/reality-metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B,EAAE,MAAM,CAAC;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE;QACX,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAC;QACxC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;KAC7B,CAAC;CACH"}

package/dist/resolvers/shared/reality-metrics.js

@@ -0,0 +1,6 @@
+/**
+ * reality_metrics_focus response types shared by reality.metrics and
+ * reality.projections.
+ */
+export {};
+//# sourceMappingURL=reality-metrics.js.map

package/dist/resolvers/shared/reality-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reality-metrics.js","sourceRoot":"","sources":["../../../src/resolvers/shared/reality-metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

@@ -0,0 +1,51 @@
+/**
+ * Reality-tree row types and dump rendering shared across resolvers
+ * (focus.reality_tree, reality_tree.snapshot, focus.anchoring_injections,
+ * loop.expected_effects, loop.upstream_udes, retired_injections) and external
+ * consumers (ai-inspection-context, verify-restatement, queries/reality-tree).
+ */
+export interface RealityTreeRow {
+    id: string;
+    name: string;
+    description: string | null;
+    focusId: string;
+    status: 'active' | 'archived';
+}
+export interface RealityTreeListResponse {
+    items: RealityTreeRow[];
+    totalCount: number;
+}
+export interface RealityNodeRow {
+    id: string;
+    realityTreeId: string;
+    seq: number;
+    statement: string;
+    nodeType: 'entity' | 'undesired_effect' | 'desired_effect' | 'injection';
+    frtStatement: string | null;
+    frtNodeType: string | null;
+    viewScope: 'both' | 'crt_only' | 'frt_only';
+    status: 'active' | 'retired';
+    injectionStatus: 'proposed' | 'in_progress' | 'realized' | 'verified' | null;
+    dissolvesObstacle: string | null;
+    enablesNodeId: string | null;
+    evidence: string | null;
+}
+export interface RealityEdgeRow {
+    id: string;
+    realityTreeId: string;
+    fromNodeId: string;
+    toNodeId: string;
+    edgeType: 'sufficient' | 'and' | 'derived_from' | 'targets';
+}
+export interface NodeListResponse {
+    items: RealityNodeRow[];
+    totalCount: number;
+}
+export interface EdgeListResponse {
+    items: RealityEdgeRow[];
+    totalCount: number;
+}
+export declare const CRT_DUMP_BUDGET_CHARS = 10000;
+export declare function renderRealityTreeDump(tree: RealityTreeRow, nodes: RealityNodeRow[], edges: RealityEdgeRow[], budgetChars: number): string;
+export declare const FOCUS_REALITY_TREE_EMPTY_STATE: string;
+//# sourceMappingURL=reality-tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reality-tree.d.ts","sourceRoot":"","sources":["../../../src/resolvers/shared/reality-tree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,WAAW,CAAC;IACzE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IAC5C,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,eAAe,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;IAC7E,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,GAAG,KAAK,GAAG,cAAc,GAAG,SAAS,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAAG,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACjF,MAAM,WAAW,gBAAgB;IAAG,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAEjF,eAAO,MAAM,qBAAqB,QAAS,CAAC;AA2D5C,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,cAAc,EAAE,EACvB,KAAK,EAAE,cAAc,EAAE,EACvB,WAAW,EAAE,MAAM,GAClB,MAAM,CAsER;AAED,eAAO,MAAM,8BAA8B,QAG0C,CAAC"}

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

@@ -0,0 +1,125 @@
+/**
+ * Reality-tree row types and dump rendering shared across resolvers
+ * (focus.reality_tree, reality_tree.snapshot, focus.anchoring_injections,
+ * loop.expected_effects, loop.upstream_udes, retired_injections) and external
+ * consumers (ai-inspection-context, verify-restatement, queries/reality-tree).
+ */
+export const CRT_DUMP_BUDGET_CHARS = 10_000;
+const NODE_TYPE_HEADINGS = {
+    entity: 'Entities',
+    undesired_effect: 'Undesired Effects (UDEs)',
+    desired_effect: 'Desired Effects (FRT)',
+    injection: 'Injections (FRT)',
+};
+const NODE_TYPE_ORDER = [
+    'entity',
+    'undesired_effect',
+    'desired_effect',
+    'injection',
+];
+const INJECTION_STATUS_ORDER = [
+    'proposed',
+    'in_progress',
+    'realized',
+    'verified',
+];
+const INJECTION_STATUS_HEADINGS = {
+    proposed: 'Injections - Proposed',
+    in_progress: 'Injections - In Progress',
+    realized: 'Injections - Realized',
+    verified: 'Injections - Verified',
+};
+function renderNodeLine(n, opts = {}) {
+    const tags = [];
+    if (n.injectionStatus && !opts.suppressInjectionStatusTag)
+        tags.push(n.injectionStatus);
+    if (n.viewScope !== 'both')
+        tags.push(n.viewScope);
+    const tagSuffix = tags.length > 0 ? ` [${tags.join(', ')}]` : '';
+    const evidence = n.evidence ? `\n  evidence: ${n.evidence.replace(/\n/g, ' ')}` : '';
+    const dissolves = n.dissolvesObstacle ? `\n  dissolves: ${n.dissolvesObstacle.replace(/\n/g, ' ')}` : '';
+    const frtOverlay = n.frtStatement && n.frtStatement !== n.statement
+        ? `\n  frt: ${n.frtStatement.replace(/\n/g, ' ')}`
+        : '';
+    return `- #${n.seq} ${n.statement}${tagSuffix}${evidence}${dissolves}${frtOverlay}`;
+}
+function renderEdgeLine(e, nodeBySeq) {
+    const from = nodeBySeq.get(e.fromNodeId);
+    const to = nodeBySeq.get(e.toNodeId);
+    const fromRef = from ? `#${from.seq}` : '?';
+    const toRef = to ? `#${to.seq}` : '?';
+    return `- ${fromRef} →[${e.edgeType}]→ ${toRef}`;
+}
+export function renderRealityTreeDump(tree, nodes, edges, budgetChars) {
+    if (nodes.length === 0)
+        return '';
+    const nodeById = new Map();
+    for (const n of nodes)
+        nodeById.set(n.id, n);
+    const sections = [];
+    sections.push(`### Tree: ${tree.name}`);
+    if (tree.description)
+        sections.push(tree.description);
+    const grouped = {
+        entity: [], undesired_effect: [], desired_effect: [], injection: [],
+    };
+    for (const n of nodes)
+        grouped[n.nodeType].push(n);
+    for (const list of Object.values(grouped))
+        list.sort((a, b) => a.seq - b.seq);
+    for (const t of NODE_TYPE_ORDER) {
+        const list = grouped[t];
+        if (list.length === 0)
+            continue;
+        if (t === 'injection') {
+            const byStatus = new Map();
+            const unstatused = [];
+            for (const inj of list) {
+                if (inj.injectionStatus) {
+                    const bucket = byStatus.get(inj.injectionStatus) ?? [];
+                    bucket.push(inj);
+                    byStatus.set(inj.injectionStatus, bucket);
+                }
+                else {
+                    unstatused.push(inj);
+                }
+            }
+            for (const status of INJECTION_STATUS_ORDER) {
+                const bucket = byStatus.get(status);
+                if (!bucket || bucket.length === 0)
+                    continue;
+                sections.push(`\n#### ${INJECTION_STATUS_HEADINGS[status]} (${bucket.length})`);
+                sections.push(bucket.map((n) => renderNodeLine(n, { suppressInjectionStatusTag: true })).join('\n'));
+            }
+            if (unstatused.length > 0) {
+                sections.push(`\n#### Injections - Unstatused (${unstatused.length})`);
+                sections.push(unstatused.map((n) => renderNodeLine(n)).join('\n'));
+            }
+            continue;
+        }
+        sections.push(`\n#### ${NODE_TYPE_HEADINGS[t]} (${list.length})`);
+        sections.push(list.map((n) => renderNodeLine(n)).join('\n'));
+    }
+    if (edges.length > 0) {
+        const causal = edges.filter((e) => e.edgeType === 'sufficient' || e.edgeType === 'and' || e.edgeType === 'targets');
+        if (causal.length > 0) {
+            sections.push(`\n#### Causal Edges (${causal.length})`);
+            sections.push(causal.map((e) => renderEdgeLine(e, nodeById)).join('\n'));
+        }
+    }
+    // Truncate to budget — preserve the heading + at least one section.
+    let acc = '';
+    for (const section of sections) {
+        const candidate = acc.length === 0 ? section : `${acc}\n${section}`;
+        if (candidate.length > budgetChars && acc.length > 0) {
+            acc += '\n\n_(truncated for token budget)_';
+            break;
+        }
+        acc = candidate;
+    }
+    return acc;
+}
+export const FOCUS_REALITY_TREE_EMPTY_STATE = '## Focus Reality Tree\n\n_No active reality tree for this focus._ ' +
+    'The intent-vs-reality graph (CRT + FRT overlays) has not been built yet -- ' +
+    'walk the focus statement and capture UDEs + entities before scoping further work.';
+//# sourceMappingURL=reality-tree.js.map

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

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

package/dist/resolvers/shared/wiki.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Wiki retrieval helpers shared across resolvers (focus.context, wiki.search,
+ * wiki.topic).
+ */
+export interface WikiSearchHit {
+    id: string;
+    slug: string;
+    title: string;
+    summary: string | null;
+    status: 'draft' | 'published' | 'archived';
+    rank: number;
+    updatedAt: string;
+    parentId?: string | null;
+    path?: string;
+}
+export interface WikiPageBody {
+    id: string;
+    slug: string;
+    title: string;
+    summary: string | null;
+    content: string;
+    status: 'draft' | 'published' | 'archived';
+}
+interface WikiAncestorRef {
+    id: string;
+    slug: string;
+    title: string;
+    summary: string | null;
+    path: string;
+    depthFromRoot: number;
+}
+export declare const WIKI_RETRIEVAL_BUDGET_CHARS = 10000;
+export declare function searchWiki(productId: string, query: string, limit?: number): Promise<WikiSearchHit[]>;
+/**
+ * Fetch the deduplicated union of ancestors for a list of hit page ids.
+ * Returns root-first ordering (depthFromRoot ascending). Empty array on
+ * failure or when no ancestors exist (all hits are roots).
+ */
+export declare function fetchAncestorsForHits(productId: string, pageIds: string[]): Promise<WikiAncestorRef[]>;
+/**
+ * Render hits with their content. Performs a context_assemble call -- not
+ * for layered assembly, but to surface page bodies via the same edge
+ * function endpoint used by the human MCP profile. The caller supplies the
+ * queries explicitly.
+ */
+export declare function fetchPageBodies(productId: string, ids: string[]): Promise<Map<string, WikiPageBody>>;
+/**
+ * Render a wiki retrieval section. When `ancestors` is non-empty, prepend a
+ * "Background Context" block (title + summary only, root-first) above the
+ * leaf hits. The ancestors block consumes up to WIKI_ANCESTORS_BUDGET_FRACTION
+ * of the total budget; the rest goes to leaf bodies.
+ *
+ * Design choice: ancestors render as a SEPARATE section above leaves rather
+ * than inline with each hit. Inline duplicates ancestors when multiple hits
+ * share them, and the agent can reason about the topical neighborhood once
+ * rather than per-hit.
+ */
+export declare function renderWikiSection(heading: string, hits: WikiSearchHit[], bodies: Map<string, WikiPageBody>, budgetChars: number, ancestors?: WikiAncestorRef[]): string;
+export {};
+//# sourceMappingURL=wiki.d.ts.map

package/dist/resolvers/shared/wiki.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.d.ts","sourceRoot":"","sources":["../../../src/resolvers/shared/wiki.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAOD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;CAC5C;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAKlD,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAYtG;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,eAAe,EAAE,CAAC,CAY5B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAgBpC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,aAAa,EAAE,EACrB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACjC,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,eAAe,EAAO,GAChC,MAAM,CAyCR"}

package/dist/resolvers/shared/wiki.js

@@ -0,0 +1,122 @@
+/**
+ * Wiki retrieval helpers shared across resolvers (focus.context, wiki.search,
+ * wiki.topic).
+ */
+import { callApi } from '../../queries/shared.js';
+export const WIKI_RETRIEVAL_BUDGET_CHARS = 10_000;
+// Reserve a slice of the budget for the ancestors block. Empirically a few
+// hundred characters per ancestor (title + 1-line summary) is plenty.
+const WIKI_ANCESTORS_BUDGET_FRACTION = 0.25;
+export async function searchWiki(productId, query, limit = 8) {
+    try {
+        const result = await callApi('wiki_search', {
+            productId,
+            query,
+            limit,
+        });
+        return result.pages ?? [];
+    }
+    catch (err) {
+        console.warn(`[assembly-engine] wiki_search failed for query "${query}": ${err.message}`);
+        return [];
+    }
+}
+/**
+ * Fetch the deduplicated union of ancestors for a list of hit page ids.
+ * Returns root-first ordering (depthFromRoot ascending). Empty array on
+ * failure or when no ancestors exist (all hits are roots).
+ */
+export async function fetchAncestorsForHits(productId, pageIds) {
+    if (pageIds.length === 0)
+        return [];
+    try {
+        const result = await callApi('wiki_ancestors_for_pages', {
+            productId,
+            pageIds,
+        });
+        return result.ancestors ?? [];
+    }
+    catch (err) {
+        console.warn(`[assembly-engine] wiki_ancestors_for_pages failed: ${err.message}`);
+        return [];
+    }
+}
+/**
+ * Render hits with their content. Performs a context_assemble call -- not
+ * for layered assembly, but to surface page bodies via the same edge
+ * function endpoint used by the human MCP profile. The caller supplies the
+ * queries explicitly.
+ */
+export async function fetchPageBodies(productId, ids) {
+    const bodies = new Map();
+    if (ids.length === 0)
+        return bodies;
+    for (const id of ids) {
+        try {
+            const result = await callApi('wiki_page_get', {
+                productId,
+                pageId: id,
+            });
+            if (result.page)
+                bodies.set(result.page.id, result.page);
+        }
+        catch (err) {
+            console.warn(`[assembly-engine] wiki_page_get failed for ${id}: ${err.message}`);
+        }
+    }
+    return bodies;
+}
+/**
+ * Render a wiki retrieval section. When `ancestors` is non-empty, prepend a
+ * "Background Context" block (title + summary only, root-first) above the
+ * leaf hits. The ancestors block consumes up to WIKI_ANCESTORS_BUDGET_FRACTION
+ * of the total budget; the rest goes to leaf bodies.
+ *
+ * Design choice: ancestors render as a SEPARATE section above leaves rather
+ * than inline with each hit. Inline duplicates ancestors when multiple hits
+ * share them, and the agent can reason about the topical neighborhood once
+ * rather than per-hit.
+ */
+export function renderWikiSection(heading, hits, bodies, budgetChars, ancestors = []) {
+    if (hits.length === 0)
+        return '';
+    const out = [`## ${heading}`];
+    let used = out[0].length;
+    // Ancestors block. Cumulative budget across the whole block (heading + all
+    // ancestor lines), not per-block — so a deep chain can't sneak past the cap
+    // by keeping each individual line small.
+    if (ancestors.length > 0) {
+        const ancestorBudget = Math.floor(budgetChars * WIKI_ANCESTORS_BUDGET_FRACTION);
+        const lines = ['\n\n### Background Context', ''];
+        let ancestorsUsed = lines[0].length + 1 + lines[1].length; // heading + join separator
+        for (const a of ancestors) {
+            const summary = (a.summary ?? '').trim();
+            const line = summary
+                ? `- **${a.title}** (${a.path}) — ${summary}`
+                : `- **${a.title}** (${a.path})`;
+            const next = lines.length === 2 ? line : '\n' + line;
+            if (ancestorsUsed + next.length > ancestorBudget)
+                break;
+            ancestorsUsed += next.length;
+            lines.push(next);
+        }
+        if (lines.length > 2) {
+            const block = lines.join('\n');
+            out.push(block);
+            used += block.length;
+        }
+    }
+    // Leaf bodies.
+    for (const hit of hits) {
+        const body = bodies.get(hit.id);
+        const content = body?.content?.trim() || hit.summary?.trim() || '';
+        const breadcrumb = hit.path && hit.path !== hit.slug ? `\n*path: ${hit.path}*` : '';
+        const block = `\n\n### ${hit.title}\n*slug: ${hit.slug}*${breadcrumb}\n\n${content || '_No content yet._'}`;
+        if (used + block.length > budgetChars && out.length > 1)
+            break;
+        out.push(block);
+        used += block.length;
+    }
+    return out.join('');
+}
+//# sourceMappingURL=wiki.js.map

package/dist/resolvers/shared/wiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.js","sourceRoot":"","sources":["../../../src/resolvers/shared/wiki.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAqClD,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAClD,2EAA2E;AAC3E,sEAAsE;AACtE,MAAM,8BAA8B,GAAG,IAAI,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB,EAAE,KAAa,EAAE,KAAK,GAAG,CAAC;IAC1E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAqB,aAAa,EAAE;YAC9D,SAAS;YACT,KAAK;YACL,KAAK;SACN,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,mDAAmD,KAAK,MAAO,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACrG,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAiB,EACjB,OAAiB;IAEjB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAmC,0BAA0B,EAAE;YACzF,SAAS;YACT,OAAO;SACR,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,sDAAuD,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7F,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAiB,EACjB,GAAa;IAEb,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAEpC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAyB,eAAe,EAAE;gBACpE,SAAS;gBACT,MAAM,EAAE,EAAE;aACX,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,IAAI;gBAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,8CAA8C,EAAE,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,IAAqB,EACrB,MAAiC,EACjC,WAAmB,EACnB,YAA+B,EAAE;IAEjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,GAAG,GAAa,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;IACxC,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEzB,2EAA2E;IAC3E,4EAA4E;IAC5E,yCAAyC;IACzC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,8BAA8B,CAAC,CAAC;QAChF,MAAM,KAAK,GAAa,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;QAC3D,IAAI,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,2BAA2B;QACtF,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,OAAO;gBAClB,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,IAAI,OAAO,OAAO,EAAE;gBAC7C,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC;YACnC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;YACrD,IAAI,aAAa,GAAG,IAAI,CAAC,MAAM,GAAG,cAAc;gBAAE,MAAM;YACxD,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChB,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IAED,eAAe;IACf,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACnE,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,MAAM,KAAK,GAAG,WAAW,GAAG,CAAC,KAAK,YAAY,GAAG,CAAC,IAAI,IAAI,UAAU,OAAO,OAAO,IAAI,mBAAmB,EAAE,CAAC;QAC5G,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,WAAW,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM;QAC/D,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;IACvB,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC"}

package/dist/resolvers/wiki-search.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wiki-search.d.ts.map

package/dist/resolvers/wiki-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-search.d.ts","sourceRoot":"","sources":["../../src/resolvers/wiki-search.ts"],"names":[],"mappings":""}

package/dist/resolvers/wiki-search.js

@@ -0,0 +1,23 @@
+import { registerSourceResolver } from '../assembly-engine.js';
+import { searchWiki, fetchAncestorsForHits, fetchPageBodies, renderWikiSection, WIKI_RETRIEVAL_BUDGET_CHARS, } from './shared/wiki.js';
+/**
+ * wiki.search(query=...)
+ *
+ * Run a free-text wiki search and return ranked, body-included markdown.
+ * Stage directives use this to pull in topic-specific pages.
+ */
+registerSourceResolver('wiki.search', async (context, params) => {
+    const query = (params.query ?? '').trim();
+    const limit = params.limit ? Math.max(1, parseInt(params.limit, 10)) : 6;
+    if (!query)
+        return '';
+    const hits = await searchWiki(context.productId, query, limit);
+    if (hits.length === 0)
+        return '';
+    const [bodies, ancestors] = await Promise.all([
+        fetchPageBodies(context.productId, hits.map((h) => h.id)),
+        fetchAncestorsForHits(context.productId, hits.map((h) => h.id)),
+    ]);
+    return renderWikiSection(`Wiki: ${query}`, hits, bodies, WIKI_RETRIEVAL_BUDGET_CHARS, ancestors);
+});
+//# sourceMappingURL=wiki-search.js.map

package/dist/resolvers/wiki-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-search.js","sourceRoot":"","sources":["../../src/resolvers/wiki-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,sBAAsB,CAAC,aAAa,EAAE,KAAK,EAAE,OAAwB,EAAE,MAA8B,EAAmB,EAAE;IACxH,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,eAAe,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzD,qBAAqB,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KAChE,CAAC,CAAC;IACH,OAAO,iBAAiB,CAAC,SAAS,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,2BAA2B,EAAE,SAAS,CAAC,CAAC;AACnG,CAAC,CAAC,CAAC"}

package/dist/resolvers/wiki-topic.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wiki-topic.d.ts.map

package/dist/resolvers/wiki-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-topic.d.ts","sourceRoot":"","sources":["../../src/resolvers/wiki-topic.ts"],"names":[],"mappings":""}

package/dist/resolvers/wiki-topic.js

@@ -0,0 +1,29 @@
+import { registerSourceResolver } from '../assembly-engine.js';
+import { callApi } from '../queries/shared.js';
+/**
+ * wiki.topic(slug=...)
+ *
+ * Hard-pin a single wiki page by slug. No retrieval risk -- if the slug
+ * exists, the page is included verbatim. Used by stage directives that
+ * need a specific page (e.g., a security checklist).
+ */
+registerSourceResolver('wiki.topic', async (context, params) => {
+    const slug = (params.slug ?? '').trim();
+    if (!slug)
+        return '';
+    try {
+        const result = await callApi('wiki_page_get', {
+            productId: context.productId,
+            slug,
+        });
+        if (!result.page)
+            return '';
+        const page = result.page;
+        return `## Wiki: ${page.title}\n*slug: ${page.slug}*\n\n${page.content || '_No content yet._'}`;
+    }
+    catch (err) {
+        console.warn(`[assembly-engine] wiki.topic(slug=${slug}) failed: ${err.message}`);
+        return '';
+    }
+});
+//# sourceMappingURL=wiki-topic.js.map

package/dist/resolvers/wiki-topic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-topic.js","sourceRoot":"","sources":["../../src/resolvers/wiki-topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C;;;;;;GAMG;AACH,sBAAsB,CAAC,YAAY,EAAE,KAAK,EAAE,OAAwB,EAAE,MAA8B,EAAmB,EAAE;IACvH,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAgC,eAAe,EAAE;YAC3E,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI;SACL,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,OAAO,YAAY,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,OAAO,IAAI,mBAAmB,EAAE,CAAC;IAClG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,qCAAqC,IAAI,aAAc,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7F,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/resolvers/workflow-stages.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workflow-stages.d.ts.map