@north-light/crouter 0.3.318 → 0.3.320

package/dist/core/runtime/bearings-render.js

@@ -1,250 +1,18 @@
-// bearings-render.ts — the pure rendering core shared by bearings.ts (canvas-
-// backed, warm-spare live-delivery + cron-wake lanes) and broker-extension-
-// render.ts (DTO-backed, broker-side cold-boot lane). Both lanes render
-// byte-identical bearings for a real node; this module holds every function
-// that does not need canvas.db to do it.
-//
-// No import of canvas.js/db.js/canvas/index.js — only canvas/paths.js and
-// canvas/labels.js (both already db.ts-free), substrate-free, plus node
-// builtins. This keeps broker-extension-canvas-db-boundary.test.ts's static
-// import walk green with no changes to that test.
-import { contextDir } from '../canvas/paths.js';
-import { fullName } from '../canvas/labels.js';
-import { tmuxSessionsReachable } from './tmux-driver.js';
-import { spawnSync } from 'node:child_process';
-import { readdirSync } from 'node:fs';
-import { hostname } from 'node:os';
-import { loadProfileManifest } from '../profiles/manifest.js';
-export function escapeAttribute(value) {
-    return value.replaceAll('&', '&amp;').replaceAll('"', '&quot;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
-}
-/** A one-line snapshot of the host/runtime the node's engine is executing in —
- *  platform, hostname, node version, and whether a tmux server is reachable.
- *  The engine is headless, so this reflects the broker/daemon environment the
- *  node's own bash tools inherit — NOT a viewer pane.
- *
- *  The tmux bit deliberately reports SERVER REACHABILITY, not "am I inside a
- *  tmux pane" — the latter is a constant `no` for every node and so tells the
- *  agent nothing: a broker is detached and paneless, and DELETES $TMUX /
- *  $TMUX_PANE from its env on boot (broker.ts) so its children never act on the
- *  launching parent's pane. The actionable question is whether this process's
- *  bash tools can drive tmux at all, and `tmuxSessionsReachable()` exits 0 iff
- *  a server is running with at least one session. The label says `tmux server`
- *  so it cannot be misread as pane residency. */
-function runtimeLine() {
-    const tmuxServer = tmuxSessionsReachable();
-    const parts = [
-        `${process.platform} ${process.arch}`,
-        hostname(),
-        `node ${process.version}`,
-        `tmux server: ${tmuxServer ? 'reachable' : 'none'}`,
-    ];
-    return `Host: ${parts.join(' · ')}`;
-}
-function directoryListingLines(cwd) {
-    try {
-        const entries = readdirSync(cwd, { withFileTypes: true });
-        const sorted = entries.sort((a, b) => {
-            if (a.isDirectory() !== b.isDirectory())
-                return a.isDirectory() ? -1 : 1;
-            return a.name.localeCompare(b.name);
-        });
-        const shown = sorted.slice(0, 50).map((entry) => `${entry.name}${entry.isDirectory() ? '/' : ''}`);
-        const hidden = sorted.length - shown.length;
-        return hidden > 0 ? [...shown, `[+${hidden} more]`] : shown;
-    }
-    catch {
-        return ['Directory listing: unavailable (cwd missing or unreadable).'];
-    }
-}
-function runCommand(cwd, cmd, args, env) {
-    const result = spawnSync(cmd, args, { cwd, encoding: 'utf8', ...(env === undefined ? {} : { env }) });
-    if (result.error !== undefined) {
-        return { ok: false, stdout: '', stderr: result.error.message };
-    }
-    return {
-        ok: result.status === 0,
-        stdout: (result.stdout ?? '').trim(),
-        stderr: (result.stderr ?? '').trim(),
-    };
-}
-/** This snapshot renders on every node boot and every revive, which makes it the
- *  most frequent git caller in the runtime — and boot is exactly when a process
- *  gets killed. `git status` would take `.git/index.lock` to refresh the stat
- *  cache; suppressing that optional lock keeps an interrupted render from
- *  orphaning a lock that then blocks every writer in the user's checkout.
- *  Only optional locks are affected, and the output is unchanged. */
-function gitEnv() {
-    return { ...process.env, GIT_OPTIONAL_LOCKS: '0' };
-}
-function runGit(cwd, args) {
-    const result = runCommand(cwd, 'git', args, gitEnv());
-    return result.ok ? result.stdout : '';
-}
-function parseWorktrees(lines) {
-    const worktrees = [];
-    let cur = {};
-    for (const line of lines) {
-        if (line.startsWith('worktree ')) {
-            if (cur.path !== undefined) {
-                worktrees.push({ path: cur.path, branch: cur.branch ?? 'detached HEAD' });
-            }
-            cur = { path: line.slice('worktree '.length) };
-        }
-        else if (line.startsWith('branch ')) {
-            cur.branch = line.slice('branch '.length).replace(/^refs\/heads\//, '');
-        }
-    }
-    if (cur.path !== undefined) {
-        worktrees.push({ path: cur.path, branch: cur.branch ?? 'detached HEAD' });
-    }
-    return worktrees;
-}
-/** The git status/worktree snapshot lines. The initial probe distinguishes a
- *  genuine non-repo (`not a git repository` in stderr) from any other failure
- *  (spawn error, permission, a hung/killed process) — collapsing both into
- *  "not a git repository" would mislabel a real outage as a documented,
- *  benign state. Every other probe here is genuinely optional and already
- *  falls back to 'unknown'/'HEAD'/a zero count on failure, which stays as-is. */
-function gitSnapshotLines(cwd) {
-    const probe = runCommand(cwd, 'git', ['rev-parse', '--is-inside-work-tree'], gitEnv());
-    if (!probe.ok) {
-        if (/not a git repository/i.test(probe.stderr)) {
-            return ['Git: not a git repository.'];
-        }
-        return [`Git: unavailable (${probe.stderr || 'git command failed'}).`];
-    }
-    const branch = runGit(cwd, ['branch', '--show-current']) || runGit(cwd, ['rev-parse', '--abbrev-ref', 'HEAD']) || 'HEAD';
-    const sha = runGit(cwd, ['rev-parse', '--short', 'HEAD']) || 'unknown';
-    const statusCount = runGit(cwd, ['status', '--porcelain'])
-        .split('\n')
-        .filter((line) => line !== '').length;
-    const worktreeLines = runGit(cwd, ['worktree', 'list', '--porcelain']).split('\n');
-    const worktrees = parseWorktrees(worktreeLines);
-    const dirty = statusCount === 0 ? 'clean' : `${statusCount} uncommitted change${statusCount === 1 ? '' : 's'}`;
-    const summary = `Git: ${branch} @ ${sha}; ${dirty}; ${worktrees.length} worktree${worktrees.length === 1 ? '' : 's'}.`;
-    const worktreeSummary = worktrees.length === 0
-        ? 'Worktrees: none.'
-        : `Worktrees: ${worktrees.map((w) => `${w.path} (${w.branch})`).join(', ')}`;
-    return [summary, worktreeSummary];
-}
-/** The `<project_context>` block — the `<environment>` snapshot only: a
- *  host/runtime line (platform, hostname, node version, tmux-or-not — the
- *  headless engine's own process env, which its bash tools inherit), the cwd
- *  dir listing, and git status/worktrees. Project guidance lives in the
- *  document substrate, so this wrapper stays environment-only. It always emits
- *  because the environment snapshot is always present. */
-export function buildProjectContextBlock(cwd) {
-    const envLines = directoryListingLines(cwd);
-    const gitLines = gitSnapshotLines(cwd);
-    let out = '<project_context>\n\n';
-    out += `<environment cwd="${escapeAttribute(cwd)}">\n`;
-    out += `${runtimeLine()}\n`;
-    out += `Directory:\n${envLines.map((line) => `  ${line}`).join('\n')}\n`;
-    out += `${gitLines.map((line) => `${line}`).join('\n')}\n`;
-    out += '</environment>\n</project_context>';
-    return out;
-}
-/** The context-directory note — names the path INLINE (no XML attribute, so it
- *  never scopes a sibling block) and frames the dir as durable, shared scratch.
- *  Present for every node, rendered as the `## Your context directory`
- *  subsection of <crtr-bearings>. */
-export function contextDirNote(nodeId) {
-    return (`Your context directory is \`${contextDir(nodeId)}\` (also in the env as \`$CRTR_CONTEXT_DIR\`) — ` +
-        'durable scratch space on disk where you write documents to share with other nodes on the canvas. ' +
-        'Put documents here that you want to share by reference instead of re-explaining them in a ' +
-        'prompt: specs, designs, findings, notes worth pointing a sibling, child, or parent at. It is a ' +
-        'shared document store, not a task tracker. **Address it by absolute path** — write artifacts as ' +
-        '`$CRTR_CONTEXT_DIR/<name>.md` (or the full path above). Your working dir is the project, NOT ' +
-        'this directory, so a bare relative `context/...` lands in the repo, not here. When you report a ' +
-        'file, report its absolute path.');
-}
-/** The profile-purview note — rendered ONLY when the profile resolves to a
- *  manifest that names at least one project dir. Phrased as PURVIEW, not a cwd
- *  replacement: the node's cwd is still its one working dir (bash/edits run
- *  there), the profile just widens what it may ALSO read/act on. Omitted
- *  entirely for a profile with no project purview (including the stable root
- *  profile) or a deleted/unreadable manifest — never throws. This absolute-path
- *  disclosure is intentional (spec-approved): the agent must know its full
- *  purview, not a redacted count. */
-export function profileNote(cwd, profileId) {
-    if (profileId === undefined || profileId === null || profileId === '')
-        return '';
-    let entry;
-    try {
-        entry = loadProfileManifest(profileId);
-    }
-    catch {
-        return '';
-    }
-    const projects = entry.manifest.projects.map((project) => project.path);
-    if (projects.length === 0)
-        return '';
-    return (`Your working dir is \`${cwd}\`. Your profile **${entry.manifest.name}** also has purview ` +
-        `over: ${projects.join(', ')}.`);
-}
-/** Orchestrator-only framing: a resident orchestrator survives refresh cycles,
- *  so its context dir is also where a future cycle of itself resumes the work.
- *  Used inside the bearings block AND in the promotion guidance dump, so a
- *  promoted node gets the same note a born-orchestrator gets. */
-export function orchestratorContextNote(nodeId) {
-    return (`Because you persist across refresh cycles, your context directory (${contextDir(nodeId)}) is ` +
-        `also where a future cycle of you resumes the work — keep the working notes and decisions a ` +
-        `refreshed you would need there, alongside the docs you share with the nodes you spawn.`);
-}
-/** One relative's line in the map: `<id> — <kind> · <status>`, plus the node's
- *  task description when it carries one (orientation: what that relative is for). */
-export function relativeLabel(node) {
-    const desc = fullName(node);
-    const descPart = desc !== '' && desc !== node.kind && desc !== node.name ? ` — ${desc}` : '';
-    return `${node.node_id} (${node.kind} · ${node.status})${descPart}`;
-}
-/** Most children listed in the mini-map before the rest collapse to `+N more`. */
-const MAX_CHILDREN_SHOWN = 5;
-/** The graph mini-map: the ancestry trunk (root first), then this node marked
- *  `● you`, then its immediate children. Returns '' for a lone root with no
- *  children (nothing to map). */
-export function renderGraphMap(nodeId, kind, mode, trunk, children) {
-    if (trunk.length === 0 && children.length === 0)
-        return '';
-    const indent = (depth) => '  '.repeat(depth);
-    const lines = [
-        'Your place in the canvas graph (ancestry above you, your direct children below):',
-    ];
-    trunk.forEach((m, i) => {
-        lines.push(`${indent(i)}${i === 0 ? '' : '└ '}${relativeLabel(m)}`);
-    });
-    const selfDepth = trunk.length;
-    lines.push(`${indent(selfDepth)}${selfDepth === 0 ? '' : '└ '}● you: ${nodeId} (${kind}, ${mode})`);
-    // Cap the child list so a wide fan-out can't flood the boot context. Children
-    // are sorted live-first, so the shown slice favors active nodes; the rest
-    // collapse to a `+N more` tail (active-first ordering means anything elided is
-    // the most-finished work).
-    const shown = children.slice(0, MAX_CHILDREN_SHOWN);
-    const hidden = children.length - shown.length;
-    shown.forEach((m, i) => {
-        const last = i === shown.length - 1 && hidden === 0;
-        lines.push(`${indent(selfDepth + 1)}${last ? '└ ' : '├ '}${relativeLabel(m)}`);
-    });
-    if (hidden > 0) {
-        lines.push(`${indent(selfDepth + 1)}└ +${hidden} more`);
-    }
-    return lines.join('\n');
-}
-/** The identity assertion injected at session start. A fork names its source
- *  while treating the copied first-person narrative as reference. The caller
- *  resolves `sourceLabel`: the bare `forkFrom` id when the source lookup
- *  fails/is unsafe, else `${forkFrom} ("${fullName(src)}")`. */
-export function buildIdentityAssertion(nodeId, kind, mode, forkFrom, sourceLabel) {
-    const lines = [`You are node ${nodeId} — kind ${kind}, mode ${mode}.`];
-    if (forkFrom !== undefined && forkFrom !== null && forkFrom !== '') {
-        lines.push('', `You are a new FORK of ${sourceLabel}, not ${sourceLabel}. Pi copied the earlier conversation ` +
-            `into this session. Treat that first-person history as reference material, not your own past.`);
-    }
-    return lines.join('\n');
-}
-export function worktreeNote(worktree) {
-    if (worktree?.state !== 'open')
-        return '';
-    return `Branch: \`${worktree.branch}\`\nWorktree: \`${worktree.path}\`\nBase: \`${worktree.base_ref}\` @ \`${worktree.base_sha}\`\nCommit work here. Before finishing, land it with \`crtr node worktree close\` or keep the checkout and branch when the worktree is clean and its exact tip exists on any branch on origin. Auto-drop applies only when the worktree is clean (no uncommitted changes) and nothing remains to land (zero commits ahead of the base, or its commits are already contained in the base); otherwise, unlanded commits or uncommitted changes block finalization.`;
-}
+var b=Object.defineProperty;var s=(e,t)=>b(e,"name",{value:t,configurable:!0});import{contextDir as f}from"../canvas/paths.js";import{fullName as w}from"../canvas/labels.js";import{tmuxSessionsReachable as k}from"./tmux-driver.js";import{spawnSync as x}from"node:child_process";import{readdirSync as v}from"node:fs";import{hostname as D}from"node:os";import{loadProfileManifest as A}from"../profiles/manifest.js";function j(e){return e.replaceAll("&","&amp;").replaceAll('"',"&quot;").replaceAll("<","&lt;").replaceAll(">","&gt;")}s(j,"escapeAttribute");function _(){const e=k();return`Host: ${[`${process.platform} ${process.arch}`,D(),`node ${process.version}`,`tmux server: ${e?"reachable":"none"}`].join(" \xB7 ")}`}s(_,"runtimeLine");function C(e){try{const n=v(e,{withFileTypes:!0}).sort((i,a)=>i.isDirectory()!==a.isDirectory()?i.isDirectory()?-1:1:i.name.localeCompare(a.name)),r=n.slice(0,50).map(i=>`${i.name}${i.isDirectory()?"/":""}`),o=n.length-r.length;return o>0?[...r,`[+${o} more]`]:r}catch{return["Directory listing: unavailable (cwd missing or unreadable)."]}}s(C,"directoryListingLines");function m(e,t,n,r){const o=x(t,n,{cwd:e,encoding:"utf8",...r===void 0?{}:{env:r}});return o.error!==void 0?{ok:!1,stdout:"",stderr:o.error.message}:{ok:o.status===0,stdout:(o.stdout??"").trim(),stderr:(o.stderr??"").trim()}}s(m,"runCommand");function $(){return{...process.env,GIT_OPTIONAL_LOCKS:"0"}}s($,"gitEnv");function p(e,t){const n=m(e,"git",t,$());return n.ok?n.stdout:""}s(p,"runGit");function E(e){const t=[];let n={};for(const r of e)r.startsWith("worktree ")?(n.path!==void 0&&t.push({path:n.path,branch:n.branch??"detached HEAD"}),n={path:r.slice(9)}):r.startsWith("branch ")&&(n.branch=r.slice(7).replace(/^refs\/heads\//,""));return n.path!==void 0&&t.push({path:n.path,branch:n.branch??"detached HEAD"}),t}s(E,"parseWorktrees");function N(e){const t=m(e,"git",["rev-parse","--is-inside-work-tree"],$());if(!t.ok)return/not a git repository/i.test(t.stderr)?["Git: not a git repository."]:[`Git: unavailable (${t.stderr||"git command failed"}).`];const n=p(e,["branch","--show-current"])||p(e,["rev-parse","--abbrev-ref","HEAD"])||"HEAD",r=p(e,["rev-parse","--short","HEAD"])||"unknown",o=p(e,["status","--porcelain"]).split(`
+`).filter(c=>c!=="").length,i=p(e,["worktree","list","--porcelain"]).split(`
+`),a=E(i),h=o===0?"clean":`${o} uncommitted change${o===1?"":"s"}`,u=`Git: ${n} @ ${r}; ${h}; ${a.length} worktree${a.length===1?"":"s"}.`,l=a.length===0?"Worktrees: none.":`Worktrees: ${a.map(c=>`${c.path} (${c.branch})`).join(", ")}`;return[u,l]}s(N,"gitSnapshotLines");function P(e){const t=C(e),n=N(e);let r=`<project_context>
+
+`;return r+=`<environment cwd="${j(e)}">
+`,r+=`${_()}
+`,r+=`Directory:
+${t.map(o=>`  ${o}`).join(`
+`)}
+`,r+=`${n.map(o=>`${o}`).join(`
+`)}
+`,r+=`</environment>
+</project_context>`,r}s(P,"buildProjectContextBlock");function B(e){return`Your context directory is \`${f(e)}\` (also in the env as \`$CRTR_CONTEXT_DIR\`) \u2014 durable scratch space on disk where you write documents to share with other nodes on the canvas. Put documents here that you want to share by reference instead of re-explaining them in a prompt: specs, designs, findings, notes worth pointing a sibling, child, or parent at. It is a shared document store, not a task tracker. **Address it by absolute path** \u2014 write artifacts as \`$CRTR_CONTEXT_DIR/<name>.md\` (or the full path above). Your working dir is the project, NOT this directory, so a bare relative \`context/...\` lands in the repo, not here. When you report a file, report its absolute path.`}s(B,"contextDirNote");function I(e,t){if(t==null||t==="")return"";let n;try{n=A(t)}catch{return""}const r=n.manifest.projects.map(o=>o.path);return r.length===0?"":`Your working dir is \`${e}\`. Your profile **${n.manifest.name}** also has purview over: ${r.join(", ")}.`}s(I,"profileNote");function M(e){return`Because you persist across refresh cycles, your context directory (${f(e)}) is also where a future cycle of you resumes the work \u2014 keep the working notes and decisions a refreshed you would need there, alongside the docs you share with the nodes you spawn.`}s(M,"orchestratorContextNote");function g(e){const t=w(e),n=t!==""&&t!==e.kind&&t!==e.name?` \u2014 ${t}`:"";return`${e.node_id} (${e.kind} \xB7 ${e.status})${n}`}s(g,"relativeLabel");const T=5;function X(e,t,n,r,o){if(r.length===0&&o.length===0)return"";const i=s(c=>"  ".repeat(c),"indent"),a=["Your place in the canvas graph (ancestry above you, your direct children below):"];r.forEach((c,d)=>{a.push(`${i(d)}${d===0?"":"\u2514 "}${g(c)}`)});const h=r.length;a.push(`${i(h)}${h===0?"":"\u2514 "}\u25CF you: ${e} (${t}, ${n})`);const u=o.slice(0,T),l=o.length-u.length;return u.forEach((c,d)=>{const y=d===u.length-1&&l===0;a.push(`${i(h+1)}${y?"\u2514 ":"\u251C "}${g(c)}`)}),l>0&&a.push(`${i(h+1)}\u2514 +${l} more`),a.join(`
+`)}s(X,"renderGraphMap");function z(e,t,n,r,o){const i=[`You are node ${e} \u2014 kind ${t}, mode ${n}.`];return r!=null&&r!==""&&i.push("",`You are a new FORK of ${o}, not ${o}. Pi copied the earlier conversation into this session. Treat that first-person history as reference material, not your own past.`),i.join(`
+`)}s(z,"buildIdentityAssertion");function K(e){return e?.state!=="open"?"":`Branch: \`${e.branch}\`
+Worktree: \`${e.path}\`
+Base: \`${e.base_ref}\` @ \`${e.base_sha}\`
+Commit work here. Before finishing, land it with \`crtr node worktree close\` or keep the checkout and branch when the worktree is clean and its exact tip exists on any branch on origin. Auto-drop applies only when the worktree is clean (no uncommitted changes) and nothing remains to land (zero commits ahead of the base, or its commits are already contained in the base); otherwise, unlanded commits or uncommitted changes block finalization.`}s(K,"worktreeNote");export{z as buildIdentityAssertion,P as buildProjectContextBlock,B as contextDirNote,j as escapeAttribute,M as orchestratorContextNote,I as profileNote,g as relativeLabel,X as renderGraphMap,K as worktreeNote};

package/dist/core/runtime/bearings.js

@@ -1,194 +1,7 @@
-// bearings.ts — session orientation shared by every delivery path.
-//
-// A conversation with no inherited crouter bearings receives the full baseline:
-// node identity and graph position, context-directory guidance, routed knowledge,
-// auto-loaded project docs, situational context, and the current environment.
-// A fork whose copied branch already carries that baseline receives only the
-// new node-scoped facts that supersede its source's identity — rendered by
-// buildForkBearingsFromState() in broker-extension-render.ts, the broker-side
-// mirror. The copied baseline remains useful reference without being repeated.
-//
-// promote.ts separately delivers orchestratorContextNote() when a base node
-// becomes an orchestrator after birth.
-import { getNode, fullName, isSafeNodeId, subscriptionsOf, } from '../canvas/index.js';
-import { cadenceDisplay } from '../wake.js';
-import { renderKnowledgeBlock, renderWorkspaceOpenDocs } from '../substrate/index.js';
-import { situationalContextEnvelope } from './situational-context.js';
-import { statusRank } from '../canvas/node-order.js';
-import { buildProjectContextBlock, contextDirNote, orchestratorContextNote, profileNote as profileNoteShared, renderGraphMap, buildIdentityAssertion as buildIdentityAssertionShared, worktreeNote, } from './bearings-render.js';
-/** The bearings custom type is shared with every attached renderer. */
-export { CONTEXT_INTRO_CUSTOM_TYPE } from '../../shared/generated-context.js';
-export { buildProjectContextBlock, contextDirNote, orchestratorContextNote };
-/** The profile-purview note — rendered ONLY when `profile_id` resolves to a
- *  manifest that names at least one project dir. Phrased as PURVIEW, not a cwd
- *  replacement: the node's cwd is still its one working dir (bash/edits run
- *  there), the profile just widens what it may ALSO read/act on. Omitted
- *  entirely for a profile with no project purview (including the stable root
- *  profile) or a deleted/unreadable manifest — never throws (mirrors
- *  `assembleNodeSubject`'s profile resolution). This absolute-path disclosure
- *  is intentional (spec-approved): the agent must know its full purview, not a
- *  redacted count. */
-export function profileNote(nodeId) {
-    const meta = getNode(nodeId);
-    if (meta === null)
-        return '';
-    return profileNoteShared(meta.cwd, meta.profile_id);
-}
-// Graph mini-map — the node's place in the canvas, rendered into the identity
-// block so a node boots oriented: who is above it (its ancestry trunk, root
-// first) and who is directly below it (its immediate children + their statuses).
-// Not the full subtree — just the load-bearing spine up and one level down.
-/** Ancestry trunk from the root DOWN to (but excluding) `nodeId`, climbing the
- *  spine `parent` edge. Cycle-guarded. Root first. */
-function ancestorTrunk(nodeId) {
-    const trunk = [];
-    const seen = new Set([nodeId]);
-    let cur = getNode(nodeId)?.parent ?? null;
-    while (cur !== null && cur !== '' && !seen.has(cur)) {
-        seen.add(cur);
-        const m = getNode(cur);
-        if (m === null)
-            break;
-        trunk.unshift(m);
-        cur = m.parent ?? null;
-    }
-    return trunk;
-}
-/** Most children listed in the mini-map before the rest collapse to `+N more`. */
-const MAX_CHILDREN_SHOWN = 5;
-/** The node's immediate children — the nodes it subscribes to (its reports) —
- *  with human-ask control-plane nodes dropped, sorted live-first. */
-function childNodes(nodeId) {
-    return subscriptionsOf(nodeId)
-        .map((s) => getNode(s.node_id))
-        .filter((m) => m !== null && m.kind !== 'human')
-        .sort((a, b) => statusRank(a.status) - statusRank(b.status));
-}
-/** The graph mini-map: the ancestry trunk (root first), then this node marked
- *  `● you`, then its immediate children. Returns '' for a lone root with no
- *  children (nothing to map). Exported for testing. */
-export function buildGraphMap(nodeId) {
-    const meta = getNode(nodeId);
-    if (meta === null)
-        return '';
-    const trunk = ancestorTrunk(nodeId);
-    const children = childNodes(nodeId);
-    return renderGraphMap(nodeId, meta.kind, meta.mode, trunk, children);
-}
-/** The identity assertion injected at session start. A fork names its source
- *  while treating the copied first-person narrative as reference. */
-function buildIdentityAssertion(nodeId) {
-    const meta = getNode(nodeId);
-    const forkFrom = meta?.fork_from;
-    // A known node id carries its human label. Paths and session ids remain
-    // opaque provenance rather than being passed to the node-id lookup.
-    const src = forkFrom !== undefined && forkFrom !== null && forkFrom !== '' && isSafeNodeId(forkFrom) ? getNode(forkFrom) : null;
-    const sourceLabel = src !== null ? `${forkFrom} ("${fullName(src)}")` : (forkFrom ?? '');
-    return buildIdentityAssertionShared(nodeId, meta?.kind ?? 'general', meta?.mode ?? 'base', forkFrom, sourceLabel);
-}
-/** The armer rendered for prose, ROLE-explicit so a newborn never mistakes the
- *  id for its own: `node <id> ("<name>")` when the name resolved, `node <id>
- *  (now gone)` when the armer was reaped, `an unknown node` only if the owner id
- *  is somehow absent (owner_id is NOT NULL on every real row — defensive). */
-function armerPhrase(origin) {
-    if (origin.ownerId === null || origin.ownerId === '')
-        return 'an unknown node';
-    if (origin.ownerName !== undefined)
-        return `node ${origin.ownerId} ("${origin.ownerName}")`;
-    return `node ${origin.ownerId} (now gone)`;
-}
-/** Build the provenance a fired cron carries to its injection seam, resolving
- *  the armer's display name if that node still exists. */
-export function cronWakeOrigin(c, kind) {
-    const owner = c.created_by != null ? getNode(c.created_by) : null;
-    return {
-        kind,
-        ownerId: c.created_by,
-        ...(owner !== null ? { ownerName: fullName(owner) } : {}),
-        armedAt: c.created,
-        recur: c.recur,
-    };
-}
-/** Render the cron provenance block. The BIRTH variant names the ARMER
- *  explicitly ("armed by node X") so a newborn never reads that id as its own;
- *  the REVIVE variant drops armer attribution — a cron can revive a node it did
- *  not create, and who armed it is not decision-relevant to a timed re-check —
- *  and instead reframes the generic "you were revived" into "a clock woke you".
- *  A recurrence surfaces its cadence either way, so the agent knows it is one
- *  run of a standing job. No timestamp is rendered: "now"/the cadence already
- *  carry the signal, and a raw ISO instant is noise an agent cannot cheaply turn
- *  into an elapsed delta. */
-export function buildWakeBearings(origin) {
-    const recurring = origin.recur !== null && origin.recur !== undefined && origin.recur !== '';
-    const cadence = recurring ? cadenceDisplay(origin.recur) : null;
-    if (origin.kind === 'schedule_revive') {
-        const reviveBody = recurring
-            ? `A SCHEDULE woke you, not a message — a recurring cron firing ${cadence} revived you fresh. ` +
-                `Nothing new happened on the canvas and nobody is waiting on a reply: the clock came round. ` +
-                `Re-read your bearings below, do this cycle's pass of the standing job, and stop.`
-            : `A SCHEDULE woke you, not a message — a one-shot cron armed to fire now revived you fresh. ` +
-                `Nothing new happened on the canvas and nobody is waiting on a reply: the time you were waiting ` +
-                `for arrived. Re-read your bearings below and continue from there.`;
-        return `<crtr-wake>\n${reviveBody}\n</crtr-wake>`;
-    }
-    const armer = armerPhrase(origin);
-    const body = recurring
-        ? `You were BORN by a scheduled wake, not spawned on demand — a recurring spawn-cron armed by ` +
-            `${armer}, firing ${cadence}. The runtime re-births a fresh node like you on this cadence whether ` +
-            `or not earlier runs survived: you are one run of a standing job, not a one-off, and you inherit ` +
-            `nothing from prior runs but this task. Your task follows.`
-        : `You were BORN by a scheduled wake, not spawned on demand — a one-shot deferred birth armed by ` +
-            `${armer} to fire now. You are its only run, not a recurring job. Your task follows.`;
-    return `<crtr-wake>\n${body}\n</crtr-wake>`;
-}
-function managedWorktreeNote(node) {
-    return worktreeNote(node?.managed_worktree);
-}
-/** The full boot intro, four top-level sections:
- *
- *   1. `<crtr-bearings>` — the orienting facts about THIS node: the identity
- *      assertion (always first, so it overrides any copied-in persona), then a
- *      `## Your place in the canvas` graph map and a `## Your context directory`
- *      note. The across-cycles context-dir framing is added ONLY for an
- *      orchestrator (by mode) — the one node whose dir a future cycle resumes
- *      from.
- *   2. `<memory kind="knowledge">` — the consultable boot catalog, a SIBLING of
- *      the bearings (never nested under the context dir). Dropped when empty.
- *   3. `<auto-loaded-context>` — memories whose `on: workspace-open` entry fires
- *      because cwd/profile mounted their owning project store. Dropped when empty.
- *   4. `<project_context>` — the cwd/git environment snapshot. pi's own
- *      AGENTS.md/CLAUDE.md injection stays suppressed (`noContextFiles` in
- *      broker.ts); `crtr sys sync project-guidance` imports that guidance into
- *      the directory's `.crouter/memory/INDEX.md` front door. */
-export function buildContextBearings(nodeId, target) {
-    const node = getNode(nodeId);
-    const bearings = ['<crtr-bearings>', buildIdentityAssertion(nodeId)];
-    const map = buildGraphMap(nodeId);
-    if (map !== '')
-        bearings.push('', '## Your place in the canvas', map);
-    bearings.push('', '## Your context directory', contextDirNote(nodeId));
-    // Profile purview — omitted entirely when there is no project purview (see profileNote).
-    const profileSection = profileNote(nodeId);
-    if (profileSection !== '')
-        bearings.push('', profileSection);
-    const worktree = managedWorktreeNote(node);
-    if (worktree !== '')
-        bearings.push('', '## Your managed worktree', worktree);
-    // Orchestrator-only: the across-cycles framing (a terminal has no future cycle).
-    if (node?.mode === 'orchestrator')
-        bearings.push('', orchestratorContextNote(nodeId));
-    bearings.push('</crtr-bearings>');
-    // The consultable catalog rides BESIDE the bearings, not inside them.
-    const knowledge = renderKnowledgeBlock(nodeId, target);
-    // A workspace mount is the initial read of its root (`on: workspace-open`).
-    const workspaceContext = renderWorkspaceOpenDocs(nodeId, target);
-    // Hidden applet/situation-origin ambient context (see situational-context.ts)
-    // — the stored `situational` card, placed in the bearings BODY, so it is a
-    // nested card inside the outer envelope. Never routed through the visible
-    // chat/digest path. '' when nothing was ever set.
-    const situational = situationalContextEnvelope(nodeId) ?? '';
-    const projectCtx = node?.cwd !== undefined ? buildProjectContextBlock(node.cwd) : '';
-    return [bearings.join('\n'), knowledge, workspaceContext, situational, projectCtx]
-        .filter((s) => s !== '')
-        .join('\n');
-}
+var y=Object.defineProperty;var t=(e,r)=>y(e,"name",{value:r,configurable:!0});import{getNode as s,fullName as c,isSafeNodeId as N,subscriptionsOf as g}from"../canvas/index.js";import{cadenceDisplay as v}from"../wake.js";import{renderKnowledgeBlock as x,renderWorkspaceOpenDocs as _}from"../substrate/index.js";import{situationalContextEnvelope as C}from"./situational-context.js";import{statusRank as d}from"../canvas/node-order.js";import{buildProjectContextBlock as l,contextDirNote as f,orchestratorContextNote as p,profileNote as $,renderGraphMap as O,buildIdentityAssertion as S,worktreeNote as Y}from"./bearings-render.js";import{CONTEXT_INTRO_CUSTOM_TYPE as Q}from"../../shared/generated-context.js";function B(e){const r=s(e);return r===null?"":$(r.cwd,r.profile_id)}t(B,"profileNote");function E(e){const r=[],n=new Set([e]);let o=s(e)?.parent??null;for(;o!==null&&o!==""&&!n.has(o);){n.add(o);const a=s(o);if(a===null)break;r.unshift(a),o=a.parent??null}return r}t(E,"ancestorTrunk");const X=5;function j(e){return g(e).map(r=>s(r.node_id)).filter(r=>r!==null&&r.kind!=="human").sort((r,n)=>d(r.status)-d(n.status))}t(j,"childNodes");function A(e){const r=s(e);if(r===null)return"";const n=E(e),o=j(e);return O(e,r.kind,r.mode,n,o)}t(A,"buildGraphMap");function R(e){const r=s(e),n=r?.fork_from,o=n!=null&&n!==""&&N(n)?s(n):null,a=o!==null?`${n} ("${c(o)}")`:n??"";return S(e,r?.kind??"general",r?.mode??"base",n,a)}t(R,"buildIdentityAssertion");function T(e){return e.ownerId===null||e.ownerId===""?"an unknown node":e.ownerName!==void 0?`node ${e.ownerId} ("${e.ownerName}")`:`node ${e.ownerId} (now gone)`}t(T,"armerPhrase");function F(e,r){const n=e.created_by!=null?s(e.created_by):null;return{kind:r,ownerId:e.created_by,...n!==null?{ownerName:c(n)}:{},armedAt:e.created,recur:e.recur}}t(F,"cronWakeOrigin");function K(e){const r=e.recur!==null&&e.recur!==void 0&&e.recur!=="",n=r?v(e.recur):null;if(e.kind==="schedule_revive")return`<crtr-wake>
+${r?`A SCHEDULE woke you, not a message \u2014 a recurring cron firing ${n} revived you fresh. Nothing new happened on the canvas and nobody is waiting on a reply: the clock came round. Re-read your bearings below, do this cycle's pass of the standing job, and stop.`:"A SCHEDULE woke you, not a message \u2014 a one-shot cron armed to fire now revived you fresh. Nothing new happened on the canvas and nobody is waiting on a reply: the time you were waiting for arrived. Re-read your bearings below and continue from there."}
+</crtr-wake>`;const o=T(e);return`<crtr-wake>
+${r?`You were BORN by a scheduled wake, not spawned on demand \u2014 a recurring spawn-cron armed by ${o}, firing ${n}. The runtime re-births a fresh node like you on this cadence whether or not earlier runs survived: you are one run of a standing job, not a one-off, and you inherit nothing from prior runs but this task. Your task follows.`:`You were BORN by a scheduled wake, not spawned on demand \u2014 a one-shot deferred birth armed by ${o} to fire now. You are its only run, not a recurring job. Your task follows.`}
+</crtr-wake>`}t(K,"buildWakeBearings");function D(e){return Y(e?.managed_worktree)}t(D,"managedWorktreeNote");function q(e,r){const n=s(e),o=["<crtr-bearings>",R(e)],a=A(e);a!==""&&o.push("","## Your place in the canvas",a),o.push("","## Your context directory",f(e));const u=B(e);u!==""&&o.push("",u);const i=D(n);i!==""&&o.push("","## Your managed worktree",i),n?.mode==="orchestrator"&&o.push("",p(e)),o.push("</crtr-bearings>");const w=x(e,r),h=_(e,r),m=C(e)??"",k=n?.cwd!==void 0?l(n.cwd):"";return[o.join(`
+`),w,h,m,k].filter(b=>b!=="").join(`
+`)}t(q,"buildContextBearings");export{Q as CONTEXT_INTRO_CUSTOM_TYPE,q as buildContextBearings,A as buildGraphMap,l as buildProjectContextBlock,K as buildWakeBearings,f as contextDirNote,F as cronWakeOrigin,p as orchestratorContextNote,B as profileNote};