@nac3/forge-cli 0.2.0-alpha.59z.121 → 0.2.0-alpha.59z.158

package/dist/bin/yf.js

@@ -57,6 +57,15 @@ import { registerGraphCommand } from '../commands/graph.js';
 import { registerMcpCommand } from '../commands/mcp.js';
 import { registerNac3Command } from '../commands/nac3.js';
 import { registerAgentCommand } from '../commands/agent.js';
+/* `yf director` CLI removed (redesign/sumi-forge 2026-06-05): the
+ * build-side multi-agent orchestrator is gone. The Director +
+ * Analyst + Coder + Tester + Scaffolder agent roles were the wrong
+ * consumer of the agentic infrastructure. The infrastructure
+ * itself (bridge, runtime, store, runner, iterative_step,
+ * delegate, real_step_factory, cli_real) survives as a library
+ * for product-side agents -- agents the generated software
+ * dispatches on the user's machine. See
+ * docs/PAPER_SUMI_VS_AGENTIC.md for the rationale. */
 import { VERSION } from '../version.js';
 export function buildProgram() {
     const program = new Command();

package/dist/bin/yf.js.map

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

package/dist/chat/claude_cli.d.ts

@@ -0,0 +1,42 @@
+import { type ClaudeChatRequest, type ClaudeChatResponse } from './claude.js';
+export interface ClaudeCliClientOptions {
+    /** Override the `claude` binary path. Defaults to "claude" (PATH-resolved). */
+    binary?: string;
+    /** Additional directories to grant tool access to via --add-dir. */
+    addDirs?: string[];
+    /** Allow-list of tools (passed verbatim to --allowed-tools). When
+     *  unset, all default tools are allowed (bypassPermissions is on). */
+    allowedTools?: string[];
+    /** Permission mode: 'bypassPermissions' (default, autopilot) |
+     *  'default' (interactive). */
+    permissionMode?: 'bypassPermissions' | 'default';
+    /** Default model: 'sonnet' | 'opus' | 'haiku' | model ID. */
+    model?: string;
+    /** Hard cap on total subprocess wall-clock. Default 30 min. */
+    timeoutMs?: number;
+}
+export declare class ClaudeCliClient {
+    private readonly opts;
+    constructor(opts?: ClaudeCliClientOptions);
+    /** Convenience for callers (and tests) that want to know what
+     *  binary + flags will run before spawning. */
+    buildArgs(req: ClaudeChatRequest): string[];
+    chat(req: ClaudeChatRequest): Promise<ClaudeChatResponse>;
+}
+/** Probe `claude -p` once with a trivial prompt. Useful as a
+ *  pre-flight before launching a long-running orchestration: a fresh
+ *  failure here (binary missing, not logged in, rate limit window
+ *  exhausted) is much cheaper to detect than to discover mid-sprint.
+ *
+ *  Returns the rate-limit info from the system init event so the
+ *  caller can decide whether the 5-hour window has room for the
+ *  upcoming workload. */
+export declare function probeClaudeCli(opts?: ClaudeCliClientOptions): Promise<{
+    ok: boolean;
+    apiKeySource?: string;
+    model?: string;
+    rateLimitStatus?: string;
+    resetsAt?: number;
+    error?: string;
+}>;
+//# sourceMappingURL=claude_cli.d.ts.map

package/dist/chat/claude_cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude_cli.d.ts","sourceRoot":"","sources":["../../src/chat/claude_cli.ts"],"names":[],"mappings":"AA0CA,OAAO,EAAoC,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEhH,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;0EACsE;IACtE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;mCAC+B;IAC/B,cAAc,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACjD,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA4ED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAInB;gBAEU,IAAI,GAAE,sBAA2B;IAW7C;mDAC+C;IAC/C,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,EAAE;IAsBrC,IAAI,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA4IhE;AAED;;;;;;;yBAOyB;AACzB,wBAAsB,cAAc,CAAC,IAAI,GAAE,sBAA2B,GAAG,OAAO,CAAC;IAC/E,EAAE,EAAgB,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAK,MAAM,CAAC;IACzB,KAAK,CAAC,EAAY,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAS,MAAM,CAAC;IACzB,KAAK,CAAC,EAAY,MAAM,CAAC;CAC1B,CAAC,CAkDD"}

package/dist/chat/claude_cli.js

@@ -0,0 +1,299 @@
+/**
+ * Yujin Forge -- Claude Code CLI subprocess client.
+ *
+ * Drop-in alternative to `ClaudeClient` that routes every chat turn
+ * through the `claude -p` binary instead of the Anthropic HTTP API.
+ * Billing flows against the user's Claude Code subscription
+ * (`apiKeySource: "none"`) instead of the Console balance.
+ *
+ * Trade-offs vs ClaudeClient (the HTTP path):
+ *
+ *  * The `claude -p` subprocess owns the tool-use loop. The caller's
+ *    `tools` + `runTool` are ignored; the subprocess uses Claude
+ *    Code's native tool surface (Read, Edit, Write, Bash, Glob, Grep,
+ *    Task, plus any MCP servers configured in the user's
+ *    `~/.claude/config`). This is intentional: for build-side
+ *    workflows (the redesign/sumi-forge target), the native tools are
+ *    strictly more efficient than text-routed NAC3 invokes.
+ *
+ *  * Each `chat()` call spawns one subprocess. Latency is dominated
+ *    by the subprocess startup (~500 ms-1 s) on top of the LLM turn.
+ *    The output is parsed from the JSONL stream the binary writes to
+ *    stdout when invoked with `--output-format stream-json --verbose`.
+ *
+ *  * Token + cost accounting comes from the `result` event the binary
+ *    emits at the end of the run. Those values reflect what the user
+ *    subscription consumed; they are reported back as `tokensIn` /
+ *    `tokensOut` for parity with ClaudeClient, with the qualification
+ *    that under subscription billing the marginal $ cost is zero.
+ *
+ *  * Multi-turn conversation history is concatenated into a single
+ *    prompt the subprocess sees on stdin. The subprocess does not
+ *    receive a structured `messages[]` array; the convention is the
+ *    same role-tagged format the Anthropic SDK uses internally
+ *    (User: / Assistant:).
+ *
+ *  * No truncation detection: the subprocess does not report stop
+ *    reasons in a comparable way. The `truncation` field of the
+ *    response is left undefined.
+ *
+ * ASCII-only.
+ */
+import { spawn } from 'node:child_process';
+import { ClaudeApiError } from './claude.js';
+/** Convert ChatMessage[] -> single prompt string for `claude -p`.
+ *  Role-tagged, oldest first. The user's final message is the active
+ *  turn the subprocess responds to. */
+function flattenMessages(messages) {
+    if (messages.length === 0)
+        return '';
+    const lines = [];
+    for (const m of messages) {
+        if (m.hidden)
+            continue;
+        const role = m.role === 'assistant' ? 'Assistant' : 'User';
+        lines.push(role + ': ' + m.content);
+    }
+    return lines.join('\n\n');
+}
+export class ClaudeCliClient {
+    opts;
+    constructor(opts = {}) {
+        this.opts = {
+            binary: opts.binary ?? 'claude',
+            permissionMode: opts.permissionMode ?? 'bypassPermissions',
+            timeoutMs: opts.timeoutMs ?? 30 * 60 * 1000,
+            addDirs: opts.addDirs ?? [],
+            allowedTools: opts.allowedTools ?? [],
+            ...(opts.model ? { model: opts.model } : {}),
+        };
+    }
+    /** Convenience for callers (and tests) that want to know what
+     *  binary + flags will run before spawning. */
+    buildArgs(req) {
+        const args = ['-p', '--output-format', 'stream-json', '--verbose'];
+        if (this.opts.permissionMode === 'bypassPermissions') {
+            args.push('--dangerously-skip-permissions');
+        }
+        if (this.opts.model) {
+            args.push('--model', this.opts.model);
+        }
+        else if (req.model) {
+            args.push('--model', req.model);
+        }
+        if (req.system && req.system.trim().length > 0) {
+            args.push('--append-system-prompt', req.system);
+        }
+        if (this.opts.allowedTools.length > 0) {
+            args.push('--allowed-tools', this.opts.allowedTools.join(' '));
+        }
+        for (const dir of this.opts.addDirs) {
+            args.push('--add-dir', dir);
+        }
+        return args;
+    }
+    async chat(req) {
+        const prompt = flattenMessages(req.messages);
+        const args = this.buildArgs(req);
+        /* Spawn the subprocess and feed the prompt on stdin so we are not
+         * bounded by the command-line length limit (~32 KB on Windows for
+         * a single argument). */
+        return await new Promise((resolve, reject) => {
+            const child = spawn(this.opts.binary, args, {
+                stdio: ['pipe', 'pipe', 'pipe'],
+                windowsHide: true,
+            });
+            const events = [];
+            let stdoutBuf = '';
+            let stderrBuf = '';
+            const finalize = (err) => {
+                clearTimeout(timer);
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                /* Walk the events tail-first: the `result` event is the final
+                 * authoritative summary. */
+                let resultEvent;
+                const assistantTexts = [];
+                let model = this.opts.model ?? req.model ?? 'claude-code-cli';
+                let apiKeySource = '';
+                for (const ev of events) {
+                    if (ev.type === 'result' && resultEvent === undefined) {
+                        resultEvent = ev;
+                    }
+                    else if (ev.type === 'assistant') {
+                        const msg = ev.message;
+                        const blocks = msg?.content ?? [];
+                        for (const b of blocks) {
+                            if (b.type === 'text' && typeof b.text === 'string') {
+                                assistantTexts.push(b.text);
+                            }
+                        }
+                        if (msg?.model)
+                            model = msg.model;
+                    }
+                    else if (ev.type === 'system') {
+                        const sys = ev;
+                        if (sys.subtype === 'init' && sys.apiKeySource) {
+                            apiKeySource = sys.apiKeySource;
+                        }
+                        if (sys.subtype === 'init' && sys.model)
+                            model = sys.model;
+                    }
+                }
+                if (!resultEvent) {
+                    reject(new ClaudeApiError('claude -p produced no result event', 500));
+                    return;
+                }
+                if (resultEvent.is_error || resultEvent.subtype !== 'success') {
+                    reject(new ClaudeApiError('claude -p reported error: ' + (resultEvent.api_error_status ?? resultEvent.subtype), 502));
+                    return;
+                }
+                const text = resultEvent.result ?? assistantTexts.join('');
+                const u = resultEvent.usage ?? {};
+                const tokensIn = (u.input_tokens ?? 0)
+                    + (u.cache_creation_input_tokens ?? 0)
+                    + (u.cache_read_input_tokens ?? 0);
+                const tokensOut = u.output_tokens ?? 0;
+                resolve({
+                    text,
+                    tokensIn,
+                    tokensOut,
+                    model,
+                    toolRounds: [],
+                });
+                /* apiKeySource carries a signal worth surfacing: if it is
+                 * `"none"`, the call billed against the Claude Code
+                 * subscription. If it is `"api_key"` or similar, the user
+                 * environment overrode the auth and the call billed against
+                 * Console. Callers can inspect this via the model field for
+                 * now; a richer envelope can be added when needed. */
+                void apiKeySource;
+            };
+            const timer = setTimeout(() => {
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch { /* ignore */ }
+                finalize(new ClaudeApiError('claude -p timed out after ' + this.opts.timeoutMs + 'ms', 504));
+            }, this.opts.timeoutMs);
+            child.stdout.setEncoding('utf-8');
+            child.stdout.on('data', (chunk) => {
+                stdoutBuf += chunk;
+                let idx;
+                while ((idx = stdoutBuf.indexOf('\n')) >= 0) {
+                    const line = stdoutBuf.slice(0, idx).trim();
+                    stdoutBuf = stdoutBuf.slice(idx + 1);
+                    if (line.length === 0)
+                        continue;
+                    try {
+                        const ev = JSON.parse(line);
+                        events.push(ev);
+                    }
+                    catch {
+                        /* Non-JSON line -- ignore. The subprocess sometimes
+                         * writes occasional progress lines that are not part of
+                         * the JSONL stream. */
+                    }
+                }
+            });
+            child.stderr.setEncoding('utf-8');
+            child.stderr.on('data', (chunk) => {
+                stderrBuf += chunk;
+            });
+            child.on('error', (err) => {
+                finalize(new ClaudeApiError('claude -p spawn failed: ' + err.message + (stderrBuf ? ' (stderr: ' + stderrBuf.slice(0, 500) + ')' : ''), 500));
+            });
+            child.on('close', (code) => {
+                if (code !== 0 && events.length === 0) {
+                    finalize(new ClaudeApiError('claude -p exited ' + code + ' with no output' + (stderrBuf ? ' (stderr: ' + stderrBuf.slice(0, 500) + ')' : ''), 500));
+                    return;
+                }
+                finalize(null);
+            });
+            try {
+                child.stdin.write(prompt);
+                child.stdin.end();
+            }
+            catch (err) {
+                finalize(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+    }
+}
+/** Probe `claude -p` once with a trivial prompt. Useful as a
+ *  pre-flight before launching a long-running orchestration: a fresh
+ *  failure here (binary missing, not logged in, rate limit window
+ *  exhausted) is much cheaper to detect than to discover mid-sprint.
+ *
+ *  Returns the rate-limit info from the system init event so the
+ *  caller can decide whether the 5-hour window has room for the
+ *  upcoming workload. */
+export async function probeClaudeCli(opts = {}) {
+    return await new Promise((resolve) => {
+        const args = ['-p', '--output-format', 'stream-json', '--verbose', 'ok?'];
+        const child = spawn(opts.binary ?? 'claude', args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        let buf = '';
+        const out = {};
+        const timer = setTimeout(() => {
+            try {
+                child.kill('SIGKILL');
+            }
+            catch { /* ignore */ }
+            resolve({ ok: false, error: 'probe timed out after 60s' });
+        }, 60_000);
+        child.stdout.setEncoding('utf-8');
+        child.stdout.on('data', (chunk) => {
+            buf += chunk;
+            let idx;
+            while ((idx = buf.indexOf('\n')) >= 0) {
+                const line = buf.slice(0, idx).trim();
+                buf = buf.slice(idx + 1);
+                if (!line)
+                    continue;
+                try {
+                    const ev = JSON.parse(line);
+                    if (ev.type === 'system' && ev.subtype === 'init') {
+                        if (ev.apiKeySource)
+                            out.apiKeySource = ev.apiKeySource;
+                        if (ev.model)
+                            out.model = ev.model;
+                    }
+                    else if (ev.type === 'rate_limit_event' && ev.rate_limit_info) {
+                        if (ev.rate_limit_info.status)
+                            out.rateLimitStatus = ev.rate_limit_info.status;
+                        if (ev.rate_limit_info.resetsAt)
+                            out.resetsAt = ev.rate_limit_info.resetsAt;
+                    }
+                }
+                catch { /* ignore */ }
+            }
+        });
+        child.on('error', (err) => {
+            clearTimeout(timer);
+            resolve({ ok: false, error: 'spawn failed: ' + err.message });
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            const result = {
+                ok: code === 0,
+            };
+            if (out.apiKeySource)
+                result.apiKeySource = out.apiKeySource;
+            if (out.model)
+                result.model = out.model;
+            if (out.rateLimitStatus)
+                result.rateLimitStatus = out.rateLimitStatus;
+            if (out.resetsAt)
+                result.resetsAt = out.resetsAt;
+            if (code !== 0)
+                result.error = 'exit ' + code;
+            resolve(result);
+        });
+    });
+}
+//# sourceMappingURL=claude_cli.js.map

package/dist/chat/claude_cli.js.map

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

package/dist/chat/graph_snapshot.d.ts

@@ -0,0 +1,38 @@
+export interface GraphSnapshotNode {
+    id: string;
+    kind: string;
+    label?: string;
+}
+export interface FetcherResult {
+    ok: boolean;
+    nodes: GraphSnapshotNode[];
+}
+export type SnapshotFetcher = (project_slug: string) => Promise<FetcherResult>;
+export interface BuildOpts {
+    project_slug: string;
+    fetcher: SnapshotFetcher;
+    /** Cap on the rendered text. When a kind's nodes would overflow
+     *  the budget, the list is truncated with "... +N more". */
+    max_tokens?: number;
+    /** TTL for the per-slug cache. Default 300s (5 min). */
+    ttl_ms?: number;
+    /** Override Date.now for deterministic tests. */
+    clock?: () => number;
+}
+export interface GraphSnapshotResult {
+    /** Whether the fetcher succeeded. ok=true with text="" means
+     *  "fetched, but no nodes yet" (empty project / fresh ingest). */
+    ok: boolean;
+    text: string;
+    hash: string;
+    nodes: GraphSnapshotNode[];
+    cached: boolean;
+}
+export declare function _resetSnapshotCacheForTests(): void;
+/**
+ * Build the snapshot section for a project, with per-slug hash cache.
+ * Failure mode: graceful -- never throws.
+ */
+export declare function buildGraphSnapshotSection(opts: BuildOpts): Promise<GraphSnapshotResult>;
+export declare function filterSnapshotForRole(snapshot: GraphSnapshotResult, role: string): string;
+//# sourceMappingURL=graph_snapshot.d.ts.map

package/dist/chat/graph_snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph_snapshot.d.ts","sourceRoot":"","sources":["../../src/chat/graph_snapshot.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAM,MAAM,CAAC;IACf,IAAI,EAAI,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAK,OAAO,CAAC;IACf,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAE/E,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAO,eAAe,CAAC;IAC9B;gEAC4D;IAC5D,UAAU,CAAC,EAAG,MAAM,CAAC;IACrB,wDAAwD;IACxD,MAAM,CAAC,EAAO,MAAM,CAAC;IACrB,iDAAiD;IACjD,KAAK,CAAC,EAAQ,MAAM,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC;sEACkE;IAClE,EAAE,EAAM,OAAO,CAAC;IAChB,IAAI,EAAI,MAAM,CAAC;IACf,IAAI,EAAI,MAAM,CAAC;IACf,KAAK,EAAG,iBAAiB,EAAE,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;CACjB;AA8BD,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AA6DD;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgC7F;AAcD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBzF"}

package/dist/chat/graph_snapshot.js

@@ -0,0 +1,159 @@
+/**
+ * Project graph snapshot (Director sprint phase II, slice 11).
+ *
+ * Compact panoramic view of the project graph that the chat
+ * system prompt + every agent run receive every turn. Refresh is
+ * hash-based: when the rendered text didn't change, the cached
+ * string is reused without any system-prompt drift cost.
+ *
+ * This is the structural complement to the existing per-intent
+ * relevance injection in semantic_graph_inject.ts. The chat
+ * gets BOTH: this snapshot above (panorama) + the relevance
+ * section below (zoom). Agents only get this snapshot, filtered
+ * by their role -- they have no "user message" to rank against.
+ *
+ * Failure mode: graceful. If the fetcher returns ok=false or
+ * throws, the section is "" and the chat / agent continues
+ * without it.
+ *
+ * ASCII-only.
+ */
+import crypto from 'node:crypto';
+/* The kinds we render, in order. New worker-side kinds appear
+ * under "other" so the snapshot is forward-compatible. */
+const KIND_ORDER = [
+    { key: 'entity', label: 'entities' },
+    { key: 'endpoint', label: 'endpoints' },
+    { key: 'component', label: 'components' },
+    { key: 'utility', label: 'utilities' },
+    { key: 'agent', label: 'agents' },
+    { key: 'doctrine', label: 'doctrines' },
+    { key: 'template', label: 'templates' },
+];
+const FOOTER = [
+    '',
+    'When you reference a primitive from this snapshot, USE that ID.',
+    'Do NOT reinvent. For full schema of one primitive, call',
+    'yujin.semantic-graph.get({id}).',
+].join('\n');
+const CACHE = new Map();
+export function _resetSnapshotCacheForTests() {
+    CACHE.clear();
+}
+/** Approximate token budget into char budget (4 chars/token). */
+function tokenBudgetToChars(tokens) {
+    return tokens * 4;
+}
+function renderSnapshot(nodes, maxTokens, hash, fetchedAt) {
+    if (nodes.length === 0)
+        return '';
+    const lines = [];
+    /* Header carries the hash + a human time so the LLM (and a
+     * developer reading the prompt log) can tell at a glance when
+     * the snapshot was last refreshed. */
+    const ts = new Date(fetchedAt).toISOString().slice(11, 19);
+    lines.push('PROJECT GRAPH SNAPSHOT (fresh at ' + ts + ' UTC; hash ' + hash.slice(0, 8) + '):');
+    lines.push('');
+    const charBudget = Math.max(200, tokenBudgetToChars(maxTokens));
+    /* Reserve room for the footer + the header lines. */
+    let charsLeft = charBudget - FOOTER.length - lines.join('\n').length;
+    for (const { key, label } of KIND_ORDER) {
+        const kindNodes = nodes.filter((n) => n.kind === key);
+        if (kindNodes.length === 0)
+            continue;
+        const labels = kindNodes.map((n) => n.label || n.id);
+        /* Pad header label to a fixed width for alignment when read in
+         * raw text. */
+        const padded = (label + '          ').slice(0, 14);
+        let row = '  ' + padded + labels.join(', ');
+        if (row.length + 1 > charsLeft) {
+            /* Truncate the list, append "... +N more" so the LLM knows
+             * there are more nodes than rendered. */
+            const head = [];
+            let used = ('  ' + padded).length;
+            let kept = 0;
+            for (const lab of labels) {
+                const grow = head.length === 0 ? lab.length : 2 + lab.length;
+                if (used + grow + 12 > charsLeft)
+                    break;
+                head.push(lab);
+                used += grow;
+                kept += 1;
+            }
+            const remainder = labels.length - kept;
+            row = '  ' + padded + head.join(', ') + (remainder > 0 ? ', ... +' + remainder + ' more' : '');
+        }
+        lines.push(row);
+        charsLeft -= (row.length + 1);
+        if (charsLeft < 40)
+            break;
+    }
+    lines.push(FOOTER);
+    return lines.join('\n');
+}
+function hashNodes(nodes) {
+    /* Stable hash: sort by id+kind so reordering does not produce
+     * a fake mutation. */
+    const sorted = nodes.map((n) => n.kind + ':' + n.id).sort();
+    return crypto.createHash('sha256').update(sorted.join('\n')).digest('hex');
+}
+/**
+ * Build the snapshot section for a project, with per-slug hash cache.
+ * Failure mode: graceful -- never throws.
+ */
+export async function buildGraphSnapshotSection(opts) {
+    const slug = opts.project_slug;
+    const maxTk = opts.max_tokens ?? 400;
+    const ttl = opts.ttl_ms ?? 300_000;
+    const now = (opts.clock ?? Date.now)();
+    const cached = CACHE.get(slug);
+    if (cached && (now - cached.fetched_at) < ttl) {
+        return {
+            ok: true,
+            text: cached.text,
+            hash: cached.hash,
+            nodes: cached.nodes,
+            cached: true,
+        };
+    }
+    let fetched;
+    try {
+        fetched = await opts.fetcher(slug);
+    }
+    catch {
+        return { ok: false, text: '', hash: '', nodes: [], cached: false };
+    }
+    if (!fetched.ok) {
+        return { ok: false, text: '', hash: '', nodes: [], cached: false };
+    }
+    const hash = hashNodes(fetched.nodes);
+    const text = renderSnapshot(fetched.nodes, maxTk, hash, now);
+    CACHE.set(slug, { text, hash, nodes: fetched.nodes, fetched_at: now });
+    return { ok: true, text, hash, nodes: fetched.nodes, cached: false };
+}
+/* ============================================================
+ * Per-agent role filter.
+ * ============================================================ */
+const ROLE_KINDS = {
+    director: ['entity', 'endpoint', 'component', 'utility', 'agent', 'doctrine', 'template'],
+    analyst: ['entity', 'endpoint', 'doctrine'],
+    coder: ['component', 'utility', 'doctrine', 'template'],
+    tester: ['endpoint', 'doctrine'],
+    scaffolder: ['doctrine'],
+};
+export function filterSnapshotForRole(snapshot, role) {
+    const allowed = ROLE_KINDS[role];
+    /* Unknown role -> render the full set of nodes so a freshly
+     * added agent role still receives panorama. The maintainer can
+     * tighten the subset later by adding a ROLE_KINDS row. */
+    const nodes = allowed
+        ? snapshot.nodes.filter((n) => allowed.includes(n.kind))
+        : snapshot.nodes;
+    if (nodes.length === 0)
+        return '';
+    const hash = snapshot.hash || hashNodes(nodes);
+    const fakeNow = Date.now();
+    const body = renderSnapshot(nodes, 600, hash, fakeNow);
+    return body.replace(/PROJECT GRAPH SNAPSHOT \(fresh at[^)]+\):/, 'PROJECT GRAPH SNAPSHOT (filtered for ' + role + '):');
+}
+//# sourceMappingURL=graph_snapshot.js.map

package/dist/chat/graph_snapshot.js.map

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