@nac3/forge-cli 0.2.0-alpha.4 → 0.2.0-alpha.59z.118

package/dist/chat/claude.js

@@ -27,6 +27,7 @@ import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { configDir } from '../license/index.js';
 import { Vault } from '../vault/store.js';
+import { recordUsage } from '../telemetry/usage.js';
 export class ConfigurationError extends Error {
     constructor(message) {
         super(message);
@@ -46,29 +47,38 @@ export class ClaudeApiError extends Error {
  *
  * Priority order (first match wins):
  *   1. Explicitly injected key (test seam).
- *   2. Vault slot `anthropic` -- the canonical path going
- *      forward.
- *   3. process.env.YUJIN_ANTHROPIC_API_KEY -- legacy env var.
- *   4. process.env.ANTHROPIC_API_KEY -- standard Anthropic env.
- *   5. ~/.yujin-forge/api-key.txt -- legacy file path.
+ *   2. BYOK provider_keys.json (alpha.4+ canonical: `yf keys setup`).
+ *   3. Vault slot `anthropic` (V0.4 path, kept).
+ *   4. process.env.YUJIN_ANTHROPIC_API_KEY (legacy env var).
+ *   5. process.env.ANTHROPIC_API_KEY (standard Anthropic env).
+ *   6. ~/.yujin-forge/api-key.txt (legacy file path).
  *
  * Throws ConfigurationError when nothing is found. The error
- * message lists all the options so the user has a single place
- * to read where to put the key.
+ * message lists the options in current-recommended order so a
+ * fresh user is pointed at `yf keys setup` first.
  *
- * The vault check is short-circuiting: if the slot exists, the
- * env vars and the file are ignored. This makes vault-configured
- * setups deterministic and unaffected by stray env vars.
- *
- * The other three paths stay as back-compat for existing users
- * who already configured Forge via env or file before V0.4
- * landed. They are NOT deprecated -- they keep working
- * indefinitely. The vault is just the recommended path.
+ * The BYOK provider_keys check is the NEW canonical path that
+ * lands with the post-purchase activation flow (the landing
+ * tells the user to run `yf keys setup` after their Polar
+ * subscription is live). The vault slot remains supported for
+ * users who configured Forge pre-BYOK.
  */
 export async function resolveApiKey(injected) {
     if (injected && injected.trim() !== '')
         return injected.trim();
-    /* Vault first. Opens cheaply; the cost is dominated by
+    /* 1. BYOK provider keys -- alpha.44 C1: stored in the encrypted
+       Vault (AES-256-GCM). The legacy plaintext provider_keys.json
+       gets auto-migrated by core/provider_keys.ts on first access. */
+    try {
+        const { getKey } = await import('../core/provider_keys.js');
+        const v = await getKey('anthropic_api_key');
+        if (v && v.trim() !== '')
+            return v.trim();
+    }
+    catch {
+        /* Vault unavailable -- fall through to legacy paths */
+    }
+    /* 2. Vault slot. Opens cheaply; the cost is dominated by
        scrypt derivation (~60ms) which is acceptable for the
        boot of a chat session. */
     try {
@@ -85,10 +95,12 @@ export async function resolveApiKey(injected) {
            env-var setups still work. The vault corruption surfaces
            loudly when they explicitly run `yf vault list` or `set`. */
     }
+    /* 3. + 4. Env vars. */
     const fromEnv = process.env['YUJIN_ANTHROPIC_API_KEY']
         ?? process.env['ANTHROPIC_API_KEY'];
     if (fromEnv && fromEnv.trim() !== '')
         return fromEnv.trim();
+    /* 5. Legacy file. */
     const filePath = path.join(configDir(), 'api-key.txt');
     try {
         const raw = await fs.readFile(filePath, 'utf-8');
@@ -100,14 +112,27 @@ export async function resolveApiKey(injected) {
         if (err.code !== 'ENOENT')
             throw err;
     }
-    throw new ConfigurationError('no Anthropic API key found. Configure one of:\n'
-        + '  - yf vault set anthropic   (recommended)\n'
-        + '  - export YUJIN_ANTHROPIC_API_KEY=sk-ant-...\n'
+    /* alpha.59z.14 F104 -- formatted error with what/why/fix triple.
+     * Importing the formatter lazily because resolveAnthropicKey()
+     * gets called from many code paths; we keep this fn synchronous
+     * by inlining the catalog data here. The CLI formatter wraps
+     * the thrown ConfigurationError instance into a ForgeError at
+     * the boundary (yf doctor / yf chat catch). */
+    const err = new ConfigurationError('no Anthropic API key found. Configure one of:\n'
+        + '  - yf keys set anthropic_api_key  (recommended; encrypted vault slot)\n'
+        + '  - yf keys setup                   (interactive setup; brain + voice)\n'
         + '  - export ANTHROPIC_API_KEY=sk-ant-...\n'
+        + '  - export YUJIN_ANTHROPIC_API_KEY=sk-ant-...\n'
         + '  - write the key to ~/.yujin-forge/api-key.txt');
+    /* Hydrate forge_error via the catalog so the message respects
+     * the active i18n session language (alpha.59z.15). */
+    const { renderForgeError, E_BYOK_KEY_MISSING } = await import('../core/error_catalog.js');
+    err.forge_error = renderForgeError(E_BYOK_KEY_MISSING, {
+        provider: 'anthropic', slot: 'anthropic_api_key', tier: 'frontier',
+    });
+    throw err;
 }
 const DEFAULT_MODEL = 'claude-sonnet-4-6';
-const DEFAULT_MAX_TOOL_ROUNDS = 5;
 export class ClaudeClient {
     apiKey;
     fetchImpl;
@@ -126,7 +151,23 @@ export class ClaudeClient {
         }
         const model = req.model ?? this.defaultModel;
         const maxTokens = req.maxTokens ?? 1024;
-        const maxRounds = req.maxToolRounds ?? DEFAULT_MAX_TOOL_ROUNDS;
+        /* alpha.59c -- max_tool_rounds comes from limits_config (or
+         *  the caller's override). Inside the loop we re-evaluate
+         *  based on the verb family of the first tool the LLM
+         *  invokes so reader-heavy turns get the bigger cap
+         *  automatically. Cap only grows mid-turn, never shrinks. */
+        const { readLimitsConfig, classifyVerbFamily, getMaxToolRoundsForFamily } = await import('../core/limits_config.js');
+        const limits = await readLimitsConfig();
+        const callerSpecifiedCap = req.maxToolRounds !== undefined;
+        /* alpha.59e -- when Danger Zone auto-approve is on, the user
+         *  has opted in to long autonomous chains. Use the higher
+         *  autonomous cap as the BASE. Caller override still wins. */
+        const autonomousMode = limits.danger_zone && limits.danger_zone.auto_approve_all === true;
+        const baseCap = autonomousMode
+            ? limits.max_tool_rounds.autonomous
+            : limits.max_tool_rounds.default;
+        let maxRounds = req.maxToolRounds ?? baseCap;
+        let familyResolved = null;
         /* Seed the conversation with the caller's history. Each round
            appends turns; the loop terminates when the model's
            stop_reason is anything other than 'tool_use'. */
@@ -145,8 +186,26 @@ export class ClaudeClient {
                 max_tokens: maxTokens,
                 messages,
             };
-            if (req.system)
-                body['system'] = req.system;
+            if (req.system) {
+                /* Wrap the system prompt as a cacheable content block.
+                 *  Anthropic prompt caching (5-min TTL) charges 10% on cache
+                 *  hits, 25% on cache writes. Our system prompt is ~3500
+                 *  tokens of mostly-static guidance (PRODUCT_WORKFLOW + SQ
+                 *  digest + tool catalog) plus a small dynamic tail (mode +
+                 *  context). We cache the whole thing as one block -- when
+                 *  the dynamic tail changes (mode flip, new project root),
+                 *  the cache invalidates and the next turn rewrites it; the
+                 *  TTL covers the typical multi-turn session.
+                 *  Minimum cacheable prefix is 1024 tokens for sonnet/opus
+                 *  and 2048 for haiku; our payload exceeds both. */
+                body['system'] = [
+                    {
+                        type: 'text',
+                        text: req.system,
+                        cache_control: { type: 'ephemeral' },
+                    },
+                ];
+            }
             if (req.tools && req.tools.length > 0) {
                 body['tools'] = req.tools.map((t) => ({
                     name: t.name,
@@ -168,26 +227,92 @@ export class ClaudeClient {
                 throw new ClaudeApiError('Claude API ' + resp.status + ': ' + detail.slice(0, 500), resp.status);
             }
             const data = await resp.json();
-            totalTokensIn += data.usage?.input_tokens ?? 0;
-            totalTokensOut += data.usage?.output_tokens ?? 0;
+            const roundIn = data.usage?.input_tokens ?? 0;
+            const roundOut = data.usage?.output_tokens ?? 0;
+            totalTokensIn += roundIn;
+            totalTokensOut += roundOut;
             usedModel = data.model ?? model;
+            /* Best-effort telemetry. Fire-and-forget; failures inside
+               recordUsage are already swallowed. */
+            void recordUsage({
+                kind: req.usageKind ?? 'claude.chat',
+                model: usedModel,
+                tokens_in: roundIn,
+                tokens_out: roundOut,
+                label: req.usageLabel,
+                project_root: req.projectRoot,
+            });
             const blocks = data.content ?? [];
             const textBlocks = blocks.filter((b) => b.type === 'text');
             const toolUses = blocks.filter((b) => b.type === 'tool_use');
             lastText = textBlocks.map((b) => b.text).join('');
             if (toolUses.length === 0 || data.stop_reason !== 'tool_use') {
                 /* No tools called -- return whatever the model said. */
+                /* alpha.59z.14 F104 -- detect truncation: output_tokens
+                 * within TRUNCATION_MARGIN of max_tokens OR provider says
+                 * stop_reason=max_tokens|length. Provider-agnostic
+                 * arithmetic-first per Pablo's design. */
+                const { detectTruncation } = await import('../core/truncation_detector.js');
+                const trunc = detectTruncation({
+                    output_tokens: roundOut,
+                    max_tokens: maxTokens,
+                    stop_reason: data.stop_reason,
+                });
                 return {
                     text: lastText,
                     tokensIn: totalTokensIn,
                     tokensOut: totalTokensOut,
                     model: usedModel,
                     toolRounds,
+                    truncation: trunc.truncated ? {
+                        truncated: true,
+                        reason: trunc.reason,
+                        output_tokens: trunc.output_tokens,
+                        max_tokens: trunc.max_tokens,
+                    } : undefined,
                 };
             }
+            /* alpha.59c -- detect verb family from first tool_use, raise
+             *  cap for reader/search/writer turns. Only grows. */
+            if (familyResolved === null && toolUses.length > 0) {
+                const first = toolUses[0];
+                if (first) {
+                    const firstVerb = first.input.verb_id || first.name || '';
+                    const family = classifyVerbFamily(firstVerb);
+                    familyResolved = family;
+                    /* Only auto-bump the cap when the caller did NOT pin
+                     *  it. Explicit req.maxToolRounds is the caller's
+                     *  contract -- preserving it keeps tests + callers
+                     *  predictable. */
+                    if (!callerSpecifiedCap) {
+                        const familyCap = getMaxToolRoundsForFamily(limits.max_tool_rounds, family);
+                        if (familyCap > maxRounds)
+                            maxRounds = familyCap;
+                    }
+                }
+            }
             if (round === maxRounds) {
-                throw new ClaudeApiError('tool_use loop exhausted (' + maxRounds + ' rounds). Last text: '
-                    + (lastText ? lastText.slice(0, 200) : '(none)'), 429);
+                /* alpha.59c -- graceful exhaustion. Return what we have
+                 *  with a helpful summary instead of throwing. The caller
+                 *  (server.ts handleChat) treats this like any other
+                 *  reply; the panel shows it with a "loop exhausted"
+                 *  badge. */
+                const firstTu = toolUses[0];
+                const lastVerb = firstTu
+                    ? (firstTu.input.verb_id || firstTu.name || 'unknown')
+                    : 'unknown';
+                const summary = (lastText ? lastText + '\n\n' : '') +
+                    '[Alcance el limite de rondas (' + maxRounds + '/' + maxRounds + ') ' +
+                    'en esta tarea (familia=' + (familyResolved ?? 'default') + ', ultimo verbo=' + lastVerb + '). ' +
+                    'Decime "continua" y sigo desde aca, o sube el cap en yf limits set max_tool_rounds.' +
+                    (familyResolved ?? 'default') + ' <N>.]';
+                return {
+                    text: summary,
+                    tokensIn: totalTokensIn,
+                    tokensOut: totalTokensOut,
+                    model: usedModel,
+                    toolRounds,
+                };
             }
             /* Persist the assistant turn (text + tool_use blocks) so
                Anthropic sees the full history on the next round. */

package/dist/chat/claude.js.map

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

package/dist/chat/graph_auto_ingest.d.ts

@@ -0,0 +1,46 @@
+interface IngestStateEntry {
+    package_json_mtime_ms: number;
+    ingested_at: string;
+    lib_count: number;
+}
+interface IngestState {
+    version: 1;
+    slugs: Record<string, IngestStateEntry>;
+}
+declare function statePath(): string;
+declare function readState(): Promise<IngestState>;
+declare function writeState(s: IngestState): Promise<void>;
+/** Fire-and-forget. Never throws. Returns true when the ingest
+ *  ran + completed (regardless of how many nodes), false when
+ *  skipped (no package.json, no change since last ingest, or
+ *  worker error). */
+export declare function maybeAutoIngest(opts: {
+    project_root: string;
+    project_slug: string;
+    /** Optional logger -- defaults to silent. Tests can inject
+     *  a console.log to see what happened. */
+    log?: (msg: string) => void;
+    /** Bypass the env gate (tests). */
+    forceEnabled?: boolean;
+}): Promise<boolean>;
+/** Spawn an ingest (or reuse one in flight for the same slug) +
+ *  return the promise so callers that need to wait for it (e.g.
+ *  GET /api/forge/graph-status on the first panel load) can do
+ *  so. NEVER throws. */
+export declare function startAutoIngest(opts: {
+    project_root: string;
+    project_slug: string;
+    log?: (msg: string) => void;
+}): Promise<boolean>;
+/** Returns the in-flight ingest promise for this slug, or null
+ *  if none is running. Endpoints await with a timeout. */
+export declare function inFlightIngest(project_slug: string): Promise<boolean> | null;
+/** Test seam. */
+export declare const _internal: {
+    statePath: typeof statePath;
+    readState: typeof readState;
+    writeState: typeof writeState;
+    _inFlight: Map<string, Promise<boolean>>;
+};
+export {};
+//# sourceMappingURL=graph_auto_ingest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph_auto_ingest.d.ts","sourceRoot":"","sources":["../../src/chat/graph_auto_ingest.ts"],"names":[],"mappings":"AAuCA,UAAU,gBAAgB;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAY,MAAM,CAAC;IAC9B,SAAS,EAAc,MAAM,CAAC;CAC/B;AACD,UAAU,WAAW;IACnB,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC3C;AAED,iBAAS,SAAS,IAAI,MAAM,CAI3B;AAED,iBAAe,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,CAO/C;AAED,iBAAe,UAAU,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvD;AAED;;;qBAGqB;AACrB,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,YAAY,EAAG,MAAM,CAAC;IACtB,YAAY,EAAG,MAAM,CAAC;IACtB;8CAC0C;IAC1C,GAAG,CAAC,EAAW,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,mCAAmC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,OAAO,CAAC,CA+DnB;AAQD;;;wBAGwB;AACxB,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,YAAY,EAAG,MAAM,CAAC;IACtB,YAAY,EAAG,MAAM,CAAC;IACtB,GAAG,CAAC,EAAW,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC,GAAG,OAAO,CAAC,OAAO,CAAC,CAYnB;AAED;0DAC0D;AAC1D,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAE5E;AAED,iBAAiB;AACjB,eAAO,MAAM,SAAS;;;;;CAAkD,CAAC"}

package/dist/chat/graph_auto_ingest.js

@@ -0,0 +1,162 @@
+/**
+ * Graph auto-ingest on yf chat boot (alpha.59v).
+ *
+ * Per Pablo's directive 2026-06-02: "Si abro yf chat en un
+ * directorio lo entienda como directorio de proyecto y cargue
+ * los graph del mismo automaticamente. A medida que voy
+ * incorporando mas componentes los suma automaticamente al
+ * graph."
+ *
+ * Phase 1 -- package.json deps ingestion at boot:
+ *
+ * 1. On every yf chat boot, resolve projectSlug + read
+ *    package.json mtime.
+ * 2. Look up the cached state for this slug in
+ *    ~/.yujin-forge/cache/graph_ingest_state.json:
+ *      { "<slug>": { "package_json_mtime_ms": N, "ingested_at": ISO,
+ *                    "lib_count": N } }
+ * 3. If the package.json mtime has changed since last_ingest
+ *    (or slug never ingested) -> fire-and-forget background
+ *    ingest via the existing ingestFromPackageJson() +
+ *    /v1/semantic-graph/import endpoint.
+ * 4. Update the cache state on success.
+ *
+ * Failure modes:
+ * - Worker unreachable -> log, swallow (boot continues).
+ * - No package.json -> skip (not all projects are npm).
+ * - No vault key -> swallow (auth failure is OK; the user is
+ *   not yet onboarded).
+ *
+ * Never blocks the boot. Never throws.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { ingestFromPackageJson } from './semantic_graph_ingest.js';
+import { semanticGraphPost } from '../license/hito4_client.js';
+function statePath() {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    const base = process.env.YF_CONFIG_DIR || path.join(home, '.yujin-forge');
+    return path.join(base, 'cache', 'graph_ingest_state.json');
+}
+async function readState() {
+    try {
+        const raw = await fs.readFile(statePath(), 'utf-8');
+        const j = JSON.parse(raw);
+        if (j && j.version === 1 && typeof j.slugs === 'object')
+            return j;
+    }
+    catch { /* missing or malformed -> fresh */ }
+    return { version: 1, slugs: {} };
+}
+async function writeState(s) {
+    const p = statePath();
+    await fs.mkdir(path.dirname(p), { recursive: true });
+    const tmp = p + '.tmp';
+    await fs.writeFile(tmp, JSON.stringify(s, null, 2), 'utf-8');
+    await fs.rename(tmp, p);
+}
+/** Fire-and-forget. Never throws. Returns true when the ingest
+ *  ran + completed (regardless of how many nodes), false when
+ *  skipped (no package.json, no change since last ingest, or
+ *  worker error). */
+export async function maybeAutoIngest(opts) {
+    const log = opts.log ?? (() => undefined);
+    /* Env gate: YF_GRAPH_AUTO_INGEST=0 disables. Default ON. */
+    if (!opts.forceEnabled) {
+        const v = process.env.YF_GRAPH_AUTO_INGEST;
+        if (v === '0' || v === 'false' || v === 'no') {
+            log('[auto-ingest] disabled via YF_GRAPH_AUTO_INGEST=0');
+            return false;
+        }
+    }
+    /* Check package.json mtime. */
+    const pkgPath = path.join(opts.project_root, 'package.json');
+    let mtimeMs;
+    try {
+        const st = await fs.stat(pkgPath);
+        mtimeMs = st.mtimeMs;
+    }
+    catch {
+        log('[auto-ingest] no package.json at ' + opts.project_root + ' -- skip');
+        return false;
+    }
+    /* Compare against cached state. */
+    const state = await readState();
+    const prev = state.slugs[opts.project_slug];
+    if (prev && prev.package_json_mtime_ms === mtimeMs) {
+        log('[auto-ingest] package.json unchanged since last ingest (' + prev.ingested_at + ') -- skip');
+        return false;
+    }
+    /* Ingest. */
+    const nodes = await ingestFromPackageJson({
+        project_root: opts.project_root,
+        project_slug: opts.project_slug,
+    });
+    if (nodes.length === 0) {
+        log('[auto-ingest] package.json has no deps -- skip');
+        return false;
+    }
+    log('[auto-ingest] ingesting ' + nodes.length + ' libs for project_slug=' + opts.project_slug + '...');
+    try {
+        const r = await semanticGraphPost('/v1/semantic-graph/import', {
+            nodes,
+            edges: [],
+            project_slug: opts.project_slug,
+        });
+        if (!r.ok || !r.body || r.body.ok !== true) {
+            log('[auto-ingest] worker rejected (' + r.status + '): ' + (r.body ? JSON.stringify(r.body).slice(0, 200) : 'no body'));
+            return false;
+        }
+        const added = Number(r.body.added ?? 0);
+        const updated = Number(r.body.updated ?? 0);
+        log('[auto-ingest] OK added=' + added + ' updated=' + updated);
+        /* Persist state. */
+        state.slugs[opts.project_slug] = {
+            package_json_mtime_ms: mtimeMs,
+            ingested_at: new Date().toISOString(),
+            lib_count: nodes.length,
+        };
+        await writeState(state);
+        return true;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log('[auto-ingest] error: ' + msg);
+        return false;
+    }
+}
+/* ----- alpha.59v.2 -- in-flight tracking ----- */
+/* Per-process map: project_slug -> Promise<boolean> currently
+ * running. Endpoints that need "graph data is current" can await
+ * this with a timeout before they query the worker. */
+const _inFlight = new Map();
+/** Spawn an ingest (or reuse one in flight for the same slug) +
+ *  return the promise so callers that need to wait for it (e.g.
+ *  GET /api/forge/graph-status on the first panel load) can do
+ *  so. NEVER throws. */
+export function startAutoIngest(opts) {
+    const existing = _inFlight.get(opts.project_slug);
+    if (existing)
+        return existing;
+    const p = (async () => {
+        try {
+            return await maybeAutoIngest(opts);
+        }
+        finally {
+            _inFlight.delete(opts.project_slug);
+        }
+    })();
+    _inFlight.set(opts.project_slug, p);
+    return p;
+}
+/** Returns the in-flight ingest promise for this slug, or null
+ *  if none is running. Endpoints await with a timeout. */
+export function inFlightIngest(project_slug) {
+    return _inFlight.get(project_slug) ?? null;
+}
+/** Test seam. */
+export const _internal = { statePath, readState, writeState, _inFlight };
+//# sourceMappingURL=graph_auto_ingest.js.map

package/dist/chat/graph_auto_ingest.js.map

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

package/dist/chat/graph_component_watcher.d.ts

@@ -0,0 +1,30 @@
+export interface ParsedExport {
+    name: string;
+    kind: 'function' | 'const' | 'class';
+}
+/** Extract top-level exported identifiers from a TS/JS source.
+ *  Returns up to 10 exports per file (cap to avoid explosion on
+ *  barrel files). */
+export declare function extractExports(source: string): ParsedExport[];
+/** Sanitise a file path to a stable graph node id. */
+declare function fileToNodeIdBase(projectRoot: string, fullPath: string): string;
+/** Build node payloads from a file change. */
+declare function nodesForFile(projectRoot: string, projectSlug: string, filePath: string): Promise<Array<Record<string, unknown>>>;
+export interface WatcherHandle {
+    stop: () => Promise<void>;
+}
+/** Start watching the project's source dirs. Returns a handle
+ *  with .stop() to close all watchers on server shutdown.
+ *  NEVER throws. */
+export declare function startComponentWatcher(opts: {
+    project_root: string;
+    project_slug: string;
+    log?: (msg: string) => void;
+}): Promise<WatcherHandle>;
+/** Test seam. */
+export declare const _internal: {
+    fileToNodeIdBase: typeof fileToNodeIdBase;
+    nodesForFile: typeof nodesForFile;
+};
+export {};
+//# sourceMappingURL=graph_component_watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph_component_watcher.d.ts","sourceRoot":"","sources":["../../src/chat/graph_component_watcher.ts"],"names":[],"mappings":"AAkDA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;CACtC;AAED;;qBAEqB;AACrB,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAkB7D;AAED,sDAAsD;AACtD,iBAAS,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED,8CAA8C;AAC9C,iBAAe,YAAY,CACzB,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GACzD,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CA0BzC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;oBAEoB;AACpB,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAU,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,GAAG,OAAO,CAAC,aAAa,CAAC,CAsFzB;AAED,iBAAiB;AACjB,eAAO,MAAM,SAAS;;;CAAqC,CAAC"}