@telora/daemon 0.22.181 → 0.22.189

package/dist/loops/llm-client.js

@@ -1,27 +1,7 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
 // Pinned by: packages/daemon/src/loops/loop-llm-client.test.ts
 // PINNED-BY-END
-/**
- * LLM client for loop data updates and PRD/loop differential evaluation.
- *
- * Runs ONE model call per focus per cycle by spawning the `claude` CLI in print
- * mode -- the same pattern as `verify/de-restatement.ts` -- so it
- * rides the operator's existing Claude Code auth and needs NO Anthropic API key,
- * org LLM secret, or any other key beyond what the spawned agent teams already
- * use. (Previously this did a raw fetch to api.anthropic.com with an x-api-key
- * header; when no key was configured the call returned null and the differential
- * loop / PRD steward froze -- exactly the gap this client now closes.)
- *
- * Capture: a `--print` one-shot session produces NO OTLP rows (the OTLP exporter
- * only fires for long-lived interactive sessions), so loop-layer token/cost spend
- * would otherwise be invisible to agent_telemetry_metrics. We parse the usage
- * block off the print-mode JSON (`--output-format json`) and buffer a telemetry
- * metric row on the same writer the OTLP receiver feeds, so loop spend lands in
- * agent_telemetry_metrics too -- the same capture path as the audit assessor
- * (spawn/lifecycle.ts buildAuditMetricRow).
- */
-import { spawn } from 'node:child_process';
-import { trackChildProcess } from '../spawn/worker-registry.js';
+import { invokeOneShotModel } from '../spawn/one-shot-model.js';
 import { bufferMetric } from '../otlp/telemetry-writer.js';
 import { createLogger } from '../shell/log.js';
 const log = createLogger({ module: 'Loop' });
@@ -37,7 +17,6 @@ const log = createLogger({ module: 'Loop' });
  * from total_cost_usd).
  */
 const DEFAULT_MODEL = 'claude-sonnet-4-6';
-const DEFAULT_TIMEOUT_MS = 2 * 60 * 1000;
 /**
  * Per-model-family pricing in USD per 1M tokens. Used only as a FALLBACK when
  * the print-mode JSON does not carry total_cost_usd; Claude Code normally
@@ -124,93 +103,27 @@ export function buildLoopMetricRow(params) {
 // Default model invocation: spawn the `claude` CLI in print mode
 // ---------------------------------------------------------------------------
 /**
- * Parse a `claude --print --output-format json` stdout payload into a
- * LoopModelResult. Returns text:null on unparseable / empty output so the
- * caller degrades gracefully (the loop skips a cycle rather than crashing).
+ * Default model invocation: the shared one-shot wrapper (spawn/one-shot-model.ts)
+ * mapped onto LoopModelResult. Rides Claude Code auth -- no key wiring. The
+ * model tag is whatever the CLI reported (its init event, else the modelUsage
+ * key); only when it reported neither does the caller apply DEFAULT_MODEL.
+ * Rejects with ModelUnavailable when the model could not be reached; callLoopLLM
+ * treats that as a skipped cycle, never as an answer.
  */
-function parsePrintJson(stdout) {
-    const trimmed = stdout.trim();
-    if (trimmed === '')
-        return { text: null };
-    let parsed;
-    try {
-        parsed = JSON.parse(trimmed);
-    }
-    catch {
-        return { text: null };
-    }
-    // Prefer the explicit top-level model id; fall back to the first modelUsage
-    // key. Only when neither is present does the caller apply DEFAULT_MODEL -- so
-    // the telemetry tag reflects the real model whenever the CLI reports it.
-    const model = typeof parsed.model === 'string' && parsed.model !== ''
-        ? parsed.model
-        : parsed.modelUsage && typeof parsed.modelUsage === 'object'
-            ? Object.keys(parsed.modelUsage)[0]
-            : undefined;
+async function invokeClaudeCli(systemPrompt, userMessage, opts) {
+    const result = await invokeOneShotModel(systemPrompt, userMessage, {
+        label: 'loop-llm',
+        ...(opts.claudeBin !== undefined ? { claudeBin: opts.claudeBin } : {}),
+        ...(opts.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
+        ...(opts.spawnFn !== undefined ? { spawnFn: opts.spawnFn } : {}),
+    });
     return {
-        text: typeof parsed.result === 'string' ? parsed.result : null,
-        usage: parsed.usage,
-        model,
-        costUsd: typeof parsed.total_cost_usd === 'number' ? parsed.total_cost_usd : null,
+        text: result.text === '' ? null : result.text,
+        ...(result.usage ? { usage: result.usage } : {}),
+        ...(result.model ? { model: result.model } : {}),
+        costUsd: result.costUsd ?? null,
     };
 }
-/**
- * Default model invocation: spawn the `claude` CLI in print mode with JSON
- * output and return the parsed result. Rides Claude Code auth -- no key wiring.
- */
-function invokeClaudeCli(systemPrompt, userMessage, opts) {
-    const claudeBin = opts.claudeBin ?? 'claude';
-    const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    const spawnFn = opts.spawnFn ?? ((cmd, args, sopts) => spawn(cmd, args, sopts));
-    const args = [
-        '--print',
-        '--output-format', 'json',
-        '--no-session-persistence',
-        '--system-prompt', systemPrompt,
-    ];
-    return new Promise((resolve, reject) => {
-        let child;
-        try {
-            child = spawnFn(claudeBin, args, { stdio: ['pipe', 'pipe', 'pipe'] });
-        }
-        catch (err) {
-            reject(new Error(`loop-llm spawn failed: ${err.message}`));
-            return;
-        }
-        // Register so a graceful stop reaps this one-shot if the loop eval is still running.
-        trackChildProcess(child, 'loop-llm');
-        let stdout = '';
-        let stderr = '';
-        child.stdout?.on('data', (chunk) => { stdout += chunk.toString('utf8'); });
-        child.stderr?.on('data', (chunk) => { stderr += chunk.toString('utf8'); });
-        const timer = setTimeout(() => {
-            try {
-                child.kill('SIGKILL');
-            }
-            catch { /* ignore */ }
-        }, timeoutMs);
-        child.on('error', (err) => {
-            clearTimeout(timer);
-            reject(new Error(`loop-llm spawn error: ${err.message}`));
-        });
-        child.on('close', (code) => {
-            clearTimeout(timer);
-            if (code !== 0) {
-                reject(new Error(`loop-llm exited ${code}: ${stderr.slice(-2000)}`));
-                return;
-            }
-            resolve(parsePrintJson(stdout));
-        });
-        try {
-            child.stdin?.write(userMessage);
-            child.stdin?.end();
-        }
-        catch (err) {
-            clearTimeout(timer);
-            reject(new Error(`loop-llm stdin write failed: ${err.message}`));
-        }
-    });
-}
 // ---------------------------------------------------------------------------
 // LLM call
 // ---------------------------------------------------------------------------

package/dist/loops/llm-client.js.map

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

package/dist/nexus/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nexus/index.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;GAYG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nexus/index.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC"}

package/dist/nexus/index.js

@@ -2,7 +2,8 @@
 // Pinned by: packages/daemon/src/nexus/nexus-e2e.test.ts,
 //   packages/daemon/src/nexus/nexus-escalation-bridge.test.ts,
 //   packages/daemon/src/nexus/nexus-incoming.test.ts, packages/daemon/src/nexus/nexus-intake.test.ts,
-//   packages/daemon/src/nexus/nexus-return.test.ts
+//   packages/daemon/src/nexus/nexus-return.test.ts,
+//   packages/daemon/src/nexus/release-order-capability.test.ts
 // PINNED-BY-END
 /**
  * Nexus subsystem barrel (cross-product request intake / routing / return).

package/dist/nexus/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nexus/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,0DAA0D;AAC1D,+DAA+D;AAC/D,sGAAsG;AACtG,mDAAmD;AACnD,gBAAgB;AAEhB;;;;;;;;;;;;GAYG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nexus/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,0DAA0D;AAC1D,+DAA+D;AAC/D,sGAAsG;AACtG,oDAAoD;AACpD,+DAA+D;AAC/D,gBAAgB;AAEhB;;;;;;;;;;;;GAYG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC"}

package/dist/nexus/intake-prompt-sections.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The sections the Nexus intake scoping prompt is composed from.
+ *
+ * Extracted from intake-spawn.ts because the composer would otherwise cross the
+ * 100-line function ceiling. Each function here returns TEXT; none of them is
+ * the contract. What the scoping agent actually receives is whatever
+ * buildIntakeScopingPrompt concatenates, which is why every regression test in
+ * this area asserts on the COMPOSED prompt and not on these return values --
+ * a section can be correct and never reach the agent.
+ *
+ * @module nexus/intake-prompt-sections
+ */
+import type { IntakeObservation } from './intake.js';
+/**
+ * The observation the requester carried: the undesired effect they asked to
+ * have cleared, and the causes upstream of it in THEIR tree.
+ *
+ * Returns the EMPTY STRING when there is no observation -- an endpoint-typed
+ * request, or one raised from an MCP that predates source nodes. Deliberately
+ * not a "(none supplied)" placeholder: a placeholder is content, and a scoping
+ * agent handed content will scope against it. Absence must read as absence.
+ */
+export declare function renderObservationSection(observation: IntakeObservation | null | undefined): string;
+/**
+ * The ordered scoping steps.
+ *
+ * TWO corrections live in this order, from two different focuses, and they are
+ * independent -- do not collapse either back.
+ *
+ * WHAT the CRT is built FROM. Step 3 used to read "set the FRT goal /
+ * desired-effect FROM the acceptance contract". That single clause produced tree
+ * 24a042b1: the contract named a mechanism (detect the collision, refuse it at
+ * the merge), the tree was built downward from it, the CRT correctly found the
+ * real root -- both branches claim the same numbers -- and then declared that
+ * root out of reach CITING the contract. Three commits landed and the cause was
+ * never touched. So the CRT is built from the OBSERVATION, injections go at the
+ * ROOT, and the contract is applied afterwards as the BAR the derived future
+ * must clear.
+ *
+ * WHEN the focus is armed. The arm used to be step 1, before the tree existed.
+ * An arm covers exactly the effects the anchored deliveries' injections target
+ * AT THE INSTANT IT LANDS, so arming first covers nothing and strands every
+ * later delivery at 'planning'. It is now the LAST step, after the tree, the
+ * deliveries and the second materialize. What keeps a second scoping agent from
+ * spawning is the first materialize STAMP, not the arm -- which is why that
+ * stamp stays at step 2, long before the focus is armed.
+ *
+ * The restatement paragraph in step 3 is not advice: the database REFUSES an arm
+ * that covers an undesired effect stating no future, naming the unstated nodes.
+ * A prompt that omitted it would send every scoping agent into that refusal.
+ */
+export declare function renderScopingSteps(params: {
+    requestId: string;
+    title: string;
+    targetProductId: string;
+    roleId: string;
+    marker: string;
+    hasObservation: boolean;
+}): string;
+/**
+ * The two rules that keep the contract from becoming a wall.
+ *
+ * Both exist because of one observed run. The CRT found the real root and
+ * declared it out of reach, citing acceptance-contract item 3; the return
+ * channel (a question entry) existed the whole time and was never used. So the
+ * prompt now names the return channel as the ACT to take, and forbids the
+ * contract as an out-of-reach reason outright.
+ */
+export declare function renderContractRules(requestId: string, hasObservation: boolean): string;
+//# sourceMappingURL=intake-prompt-sections.d.ts.map

package/dist/nexus/intake-prompt-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake-prompt-sections.d.ts","sourceRoot":"","sources":["../../src/nexus/intake-prompt-sections.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAyB,MAAM,aAAa,CAAC;AAS5E;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CA8BlG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;CACzB,GAAG,MAAM,CA6BT;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,CA4BtF"}

package/dist/nexus/intake-prompt-sections.js

@@ -0,0 +1,145 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: none -- no test imports this module directly (baselined; see lint:pinned-by)
+// PINNED-BY-END
+/** One observation node as a prompt line: what it says, and what backs it. */
+function renderNode(node, label) {
+    const lines = [`- ${label} (#${node.seq}, ${node.nodeType}): ${node.statement}`];
+    if (node.evidence)
+        lines.push(`  evidence: ${node.evidence}`);
+    return lines;
+}
+/**
+ * The observation the requester carried: the undesired effect they asked to
+ * have cleared, and the causes upstream of it in THEIR tree.
+ *
+ * Returns the EMPTY STRING when there is no observation -- an endpoint-typed
+ * request, or one raised from an MCP that predates source nodes. Deliberately
+ * not a "(none supplied)" placeholder: a placeholder is content, and a scoping
+ * agent handed content will scope against it. Absence must read as absence.
+ */
+export function renderObservationSection(observation) {
+    if (!observation)
+        return '';
+    const lines = [
+        `## The observation (what the REQUESTER sees -- build your CRT from THIS)`,
+        ``,
+        `This request was born from an undesired effect in the requesting product's`,
+        `reality tree, not from prose. The effect and its upstream causes travel with`,
+        `the request so you never have to read back into their tree.`,
+        ``,
+        ...renderNode(observation.sourceNode, 'The effect this request asks to have cleared'),
+    ];
+    if (observation.sourceNode.frtStatement) {
+        lines.push(`  its stated future (this IS the acceptance contract below): ${observation.sourceNode.frtStatement}`);
+    }
+    if (observation.upstreamCauses.length > 0) {
+        lines.push(``, `Upstream causes in the requester's tree, nearest first:`);
+        for (const cause of observation.upstreamCauses)
+            lines.push(...renderNode(cause, 'cause'));
+    }
+    else {
+        lines.push(``, `The requester recorded no upstream causes: in their tree this effect is a root.`);
+    }
+    if (observation.truncated) {
+        lines.push(``, `NOTE: this fragment was truncated at a size cap -- the requester's tree has`, `more upstream than is shown. Treat what is here as a starting point, not as`, `the complete causal picture.`);
+    }
+    lines.push(``);
+    return lines.join('\n');
+}
+/**
+ * The ordered scoping steps.
+ *
+ * TWO corrections live in this order, from two different focuses, and they are
+ * independent -- do not collapse either back.
+ *
+ * WHAT the CRT is built FROM. Step 3 used to read "set the FRT goal /
+ * desired-effect FROM the acceptance contract". That single clause produced tree
+ * 24a042b1: the contract named a mechanism (detect the collision, refuse it at
+ * the merge), the tree was built downward from it, the CRT correctly found the
+ * real root -- both branches claim the same numbers -- and then declared that
+ * root out of reach CITING the contract. Three commits landed and the cause was
+ * never touched. So the CRT is built from the OBSERVATION, injections go at the
+ * ROOT, and the contract is applied afterwards as the BAR the derived future
+ * must clear.
+ *
+ * WHEN the focus is armed. The arm used to be step 1, before the tree existed.
+ * An arm covers exactly the effects the anchored deliveries' injections target
+ * AT THE INSTANT IT LANDS, so arming first covers nothing and strands every
+ * later delivery at 'planning'. It is now the LAST step, after the tree, the
+ * deliveries and the second materialize. What keeps a second scoping agent from
+ * spawning is the first materialize STAMP, not the arm -- which is why that
+ * stamp stays at step 2, long before the focus is armed.
+ *
+ * The restatement paragraph in step 3 is not advice: the database REFUSES an arm
+ * that covers an undesired effect stating no future, naming the unstated nodes.
+ * A prompt that omitted it would send every scoping agent into that refusal.
+ */
+export function renderScopingSteps(params) {
+    const { requestId, title, targetProductId, roleId, marker, hasObservation } = params;
+    const step3 = hasObservation
+        ? [
+            `3. telora_reality_tree create on the focus, then author the CRT FROM THE OBSERVATION above -- in this order:`,
+            `   a. Bring the observation into THIS product's terms: the requester's effect and its upstream causes become entities and undesired effects in your tree, carrying the evidence that travelled with them. You are not copying their tree; you are stating, in your product's causal terms, what produces the effect they see.`,
+            `   b. Create the MIRROR of the requested undesired effect: one node whose statement is the requester's effect and which carries their evidence. This is the node the whole request is judged against, so it must exist as its own node.`,
+            `   c. Wire the causes, then keep asking "and what causes THAT?" until you reach roots inside this product -- something your team can act on. The effect the requester named is a SYMPTOM in your tree; it is almost never where the injection goes.`,
+            `   d. Place your injections at the ROOTS you found. Not at the items the acceptance contract lists: those describe a future, and an injection is an act. Draw a \`targets\` edge from each injection to the node(s) it flips.`,
+            `   e. derive_frt, then read the derived cascade AGAINST the acceptance contract. The contract is the BAR -- does the future your injections produce clear it? If not, the plan is short, not the contract wrong.`,
+            `   The contract tells you what must become TRUE. It does not tell you where the tree starts, which mechanism to build, or what is beyond reach.`,
+        ]
+        : [
+            `3. telora_reality_tree create on the focus, then author the CRT: capture the undesired effects this request implies in THIS product, wire their causes down to roots you can act on, and place injections at those roots, drawing a \`targets\` edge from each injection to the node(s) it flips. Then derive_frt and read the derived cascade against the acceptance contract as the BAR it must clear. This request carries no observation (it is endpoint-typed, or was raised before requests carried one), so the contract is all you have to judge against -- but it is still a bar on the future, never a description of the tree to build.`,
+        ];
+    return [
+        `## Steps (do these in order, verifying each with a follow-up read)`,
+        `1. telora_product_focus create -- name the focus from the request title ("${title}"), productId = ${targetProductId}. The description MUST include, verbatim, the marker line "${marker}" AND the full acceptance contract above (so any follow-up team has the goal even if the tree is not yet built). Leave assignedAgentRoleId UNSET here -- the arm is the last step, not the first.`,
+        `2. telora_product_request materialize -- requestId = ${requestId}, materializedFocusId = <the focus id you created>. Do this NOW, immediately after the focus exists -- BEFORE building the tree or deliveries, and long before the arm. This stamps the focus back on the request (accepted -> in_progress) so it leaves the intake-pending set and a second scoping agent can never be spawned for it. The stamp is what guarantees that -- not the arm, which has not happened yet. If your run crashes after this point, the per-request focus already exists and the normal loop finishes scoping it; if it crashed before this point, the idempotency check above reuses the focus.`,
+        ...step3,
+        `   RESTATEMENT IS REQUIRED ON EVERY INJECTION TARGET: each undesired effect an injection targets MUST carry a non-blank frtStatement -- the future that node reads as once this work lands -- together with its frtNodeType (what the node becomes: desired_effect). Set both with telora_reality_tree_node update (frtStatement + frtNodeType) on EVERY target, then re-read the nodes and confirm not one of them is blank.`,
+        `   This is not decoration, and it is not optional. The arm in step 5 is REFUSED BY THE DATABASE when any undesired effect it covers states no future: the call fails with an "arm_criteria_required:" error that NAMES the unstated nodes, because an arm that covers an unstated effect would stamp a bar nobody wrote down. If you see that refusal, state the futures it names and issue the arm again -- do not work around it, and do not skip the arm.`,
+        `4. telora_product_delivery create -- decompose the work into one or more deliveries, EACH anchored to an injection (injectionNodeId) and carrying a workFacing label ("outward" for new ground / a capability not had before, "inward" for improving existing ground). Scope deliveries by the phases the work naturally has. These MUST exist and be injection-anchored BEFORE the arm in step 5: an arm covers exactly the effects the deliveries' injections target at the instant it lands, so arming an empty or tree-less focus covers nothing and strands everything you scope afterwards at 'planning'.`,
+        `   Then call telora_product_request materialize ONCE MORE with the SAME materializedFocusId, plus materializedDeliveryId = <the representative delivery id>${hasObservation ? `, plus mirroredNodeId = <the id of the mirror node you created in step 3b>` : ''}. The request is already in_progress at this point, which is fine -- materialize is idempotent for the same focus and just records the delivery the return-path loop watches to resolve this request when it reaches done.${hasObservation ? ` Recording the mirror is what lets this call check that your plan actually reaches the effect the requester observed; a plan whose injections do not flip that node is not a plan for this request.` : ''}`,
+        `5. telora_product_focus update to set assignedAgentRoleId = ${roleId} so the spawn loop will pick the focus up (no dead-letter). Do this LAST, after the tree and the anchored deliveries exist and after the second materialize, so the arm you request covers stated effects. This arm is NOT you judging your own scoping ready -- an agent does not arm its own focus. It is the human go-signal that the accepted intake request DURABLY DELEGATED to this flow (accepting the request IS the go-signal), which is why you may issue it at all, and it goes here, last, so that delegated go-signal lands on a focus whose effects are stated. Declare it in the same call: pass armNote = "durably-delegated arm: accepted intake request ${requestId}".`,
+        ``,
+        `Then STOP. Do NOT begin implementing the deliveries -- the armed focus runs the normal differential loop after you exit.`,
+    ].join('\n');
+}
+/**
+ * The two rules that keep the contract from becoming a wall.
+ *
+ * Both exist because of one observed run. The CRT found the real root and
+ * declared it out of reach, citing acceptance-contract item 3; the return
+ * channel (a question entry) existed the whole time and was never used. So the
+ * prompt now names the return channel as the ACT to take, and forbids the
+ * contract as an out-of-reach reason outright.
+ */
+export function renderContractRules(requestId, hasObservation) {
+    if (!hasObservation)
+        return '';
+    return [
+        `## When your tree and the contract disagree`,
+        ``,
+        `You will sometimes find that the root cause your CRT reaches is NOT what the`,
+        `contract's wording addresses, or that the contract names a MECHANISM your tree`,
+        `says will not clear the effect. That is a normal and useful finding: the`,
+        `requester wrote from where the pain was felt; you are looking at where it comes`,
+        `from. It is not a reason to stop, and it is not a reason to scope their`,
+        `mechanism instead.`,
+        ``,
+        `Do this:`,
+        `- SEND IT BACK. telora_product_request send, requestId = ${requestId}, entryType = "question",`,
+        `  content = the root you found, the evidence for it, and what you intend to scope`,
+        `  toward instead. Name the disagreement plainly.`,
+        `- KEEP GOING. The question is not a gate on your own work. Do not wait for an`,
+        `  answer, do not park the focus, and do not hold the materialize call. Scope`,
+        `  toward the EFFECT the requester observed, using the root you actually found.`,
+        ``,
+        `And one prohibition, because this is exactly how the last request failed:`,
+        `- An out-of-reach declaration on an undesired effect may NOT cite the acceptance`,
+        `  contract as its reason. "The contract does not mention this" is not a boundary`,
+        `  on your reach -- it is a disagreement, and a disagreement goes back through the`,
+        `  question channel above. Out of reach means YOUR PRODUCT cannot act on it, and`,
+        `  that claim stands on what your product can do, never on what the requester wrote.`,
+        ``,
+    ].join('\n');
+}
+//# sourceMappingURL=intake-prompt-sections.js.map

package/dist/nexus/intake-prompt-sections.js.map

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

package/dist/nexus/intake-spawn.d.ts

@@ -1,27 +1,63 @@
+/**
+ * Nexus intake scoping-agent spawn.
+ *
+ * Spawns a short-lived, single-purpose Claude Code agent that authors a focus
+ * from an accepted cross-product request -- the work the materialize edge
+ * handler structurally could not do. The agent is seeded with the request + its
+ * acceptanceContract and the role UUID to assign; its sole job is:
+ *
+ *   1. telora_product_focus create  -- a per-request focus named from the request,
+ *      left UN-ARMED (no assignedAgentRoleId).
+ *   2. telora_product_request materialize -- stamp the new focus back on the
+ *      request so it leaves the intake-pending set (accepted -> in_progress) and
+ *      a second scoping agent can never be spawned. The stamp, not the arm, is
+ *      the anti-double-spawn guarantee.
+ *   3. telora_reality_tree create + author nodes/edges -- the acceptanceContract
+ *      becomes the goal / desired-effect the tree drives toward, and EVERY node
+ *      an injection targets is restated (frtStatement + frtNodeType). The arm at
+ *      step 5 is refused outright when one of its covered effects states no
+ *      future, so the restatement is a precondition of the arm, not a polish
+ *      step -- and the prompt says so, because the prompt is the only thing that
+ *      reaches the agent doing the authoring.
+ *   4. telora_product_delivery create -- injection-anchored deliveries, then
+ *      materialize once more to record the representative delivery.
+ *   5. telora_product_focus update -- assign the intake role LAST, so the arm
+ *      covers the effects the anchored deliveries state. Arming first covers
+ *      nothing and strands every later delivery at 'planning'.
+ *   6. exit.
+ *
+ * THE PROCESS MACHINERY LIVES IN `spawn/one-shot-scoping-spawn.ts` and is
+ * SHARED with the PRD frontier's scoping agent: the one-shot `--print` Claude
+ * Code process, prompt passed as a CLI arg, cleaned env, the kill timeout, the
+ * fire-and-forget resolve-on-'spawn' contract (the agent runs for minutes, so
+ * the daemon poll loop is never blocked) and the close/error logging. What
+ * stays here is what is genuinely intake's: the PURE prompt builder below, and
+ * the `intake_scoping_started_at` in-flight guard its caller stamps -- that
+ * stamp, never the returned promise, is what prevents a re-spawn until the
+ * staleness window.
+ */
 import type { DaemonConfig } from '../types/index.js';
 import type { IntakePendingRequest } from './intake.js';
-/** Kill the scoping agent if it has not exited within this window (15 minutes). */
+import { type ScopingSpawnSeam } from '../spawn/one-shot-scoping-spawn.js';
+/**
+ * Kill the scoping agent if it has not exited within this window (15 minutes).
+ *
+ * An alias of the shared one-shot timeout, kept under its original name because
+ * DEFAULT_INTAKE_STALE_MS is documented and tested as strictly greater than it
+ * (`nexus-intake.test.ts`) -- the relation is intake's, the number is shared.
+ */
 export declare const INTAKE_SCOPING_TIMEOUT_MS: number;
+export type { ScopingSpawnSeam };
 /**
  * Build the scoping prompt seeded with the request + acceptanceContract + the
  * role to assign. Pure (string) so it is unit-tested without spawning a process.
  */
 export declare function buildIntakeScopingPrompt(req: IntakePendingRequest, roleId: string): string;
-/** Injectable process spawn seam (overridable in tests). */
-export interface ScopingSpawnSeam {
-    spawnProcess: (command: string, args: string[], cwd: string, env: NodeJS.ProcessEnv) => {
-        pid?: number;
-        on: (event: string, cb: (arg?: unknown) => void) => void;
-        stdin?: {
-            end: () => void;
-        } | null;
-    };
-}
 /**
  * Spawn the intake scoping agent for one accepted request. Resolves once the
  * process has SPAWNED (fire-and-forget -- the agent runs for minutes); rejects
- * only if the process fails to spawn. The close/error handlers log the outcome
- * and the kill timeout bounds a hung agent.
+ * only if the process fails to spawn. The shared seam logs the outcome and its
+ * kill timeout bounds a hung agent.
  */
 export declare function spawnScopingAgent(config: DaemonConfig, req: IntakePendingRequest, roleId: string, seam?: ScopingSpawnSeam): Promise<void>;
 //# sourceMappingURL=intake-spawn.d.ts.map

package/dist/nexus/intake-spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intake-spawn.d.ts","sourceRoot":"","sources":["../../src/nexus/intake-spawn.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAMxD,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAsC1F;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK;QACtF,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;QACzD,KAAK,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,IAAI,CAAA;SAAE,GAAG,IAAI,CAAC;KACpC,CAAC;CACH;AAOD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,oBAAoB,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,gBAA8B,GACnC,OAAO,CAAC,IAAI,CAAC,CA4Df"}
+{"version":3,"file":"intake-spawn.d.ts","sourceRoot":"","sources":["../../src/nexus/intake-spawn.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,oCAAoC,CAAC;AAU5C;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,QAA2B,CAAC;AAIlE,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAmD1F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,oBAAoB,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAWf"}