@nac3/forge-cli 0.2.0-alpha.8 → 0.2.1-alpha.60

package/dist/chat/completion_hallucination_detector.d.ts

@@ -0,0 +1,40 @@
+/**
+ * PND-036 -- completion-without-tool-use detector.
+ *
+ * Forge's eco tier sometimes responds with "voy a configurar el
+ * proyecto / procedere a setup / ya he procesado tu solicitud"
+ * WITHOUT invoking any tool. The user then asks 3 times "did you
+ * actually do it?" before the brain admits no work happened.
+ *
+ * This module is a pure heuristic: given a reply text + the count
+ * of tool_uses that occurred in the same turn, decide whether the
+ * reply contains a "hallucinated completion" claim. We use it for:
+ *   1. logging (telemetry).
+ *   2. forcing escalation on the NEXT turn (next-turn-frontier).
+ *   3. (future) flagging the reply with a banner.
+ *
+ * Conservative on purpose: a false positive harms nothing (we just
+ * escalate the next turn); a false negative is back to the bug.
+ *
+ * ASCII-only.
+ */
+export interface HallucinationCheck {
+    /** True when the reply contains a "doing the work" phrase AND
+     *  no tool was invoked in the turn. */
+    is_hallucinated: boolean;
+    /** Substring matched (sliced to 120 chars) for telemetry. */
+    matched_phrase: string;
+    /** True when a refusal phrase was found instead. Surfaced for
+     *  PND-037 (router refusal-aware escalation). */
+    is_refusal: boolean;
+    /** True when a proof token was found (verb id, code block) --
+     *  in that case is_hallucinated is forced to false. */
+    has_proof: boolean;
+    /** alpha.59z.188 PND-038 -- True when "mis disculpas / hubo un
+     *  error / aun estoy en proceso" appear. Leading indicator that
+     *  the tier is over its head; same next-turn-frontier hint
+     *  fires. Independent of is_hallucinated. */
+    is_confused: boolean;
+}
+export declare function checkCompletionHallucination(reply_text: string, tool_uses_in_turn: number): HallucinationCheck;
+//# sourceMappingURL=completion_hallucination_detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion_hallucination_detector.d.ts","sourceRoot":"","sources":["../../src/chat/completion_hallucination_detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA2CH,MAAM,WAAW,kBAAkB;IACjC;2CACuC;IACvC,eAAe,EAAE,OAAO,CAAC;IACzB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB;qDACiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB;2DACuD;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB;;;iDAG6C;IAC7C,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,GACxB,kBAAkB,CAiCpB"}

package/dist/chat/completion_hallucination_detector.js

@@ -0,0 +1,96 @@
+/**
+ * PND-036 -- completion-without-tool-use detector.
+ *
+ * Forge's eco tier sometimes responds with "voy a configurar el
+ * proyecto / procedere a setup / ya he procesado tu solicitud"
+ * WITHOUT invoking any tool. The user then asks 3 times "did you
+ * actually do it?" before the brain admits no work happened.
+ *
+ * This module is a pure heuristic: given a reply text + the count
+ * of tool_uses that occurred in the same turn, decide whether the
+ * reply contains a "hallucinated completion" claim. We use it for:
+ *   1. logging (telemetry).
+ *   2. forcing escalation on the NEXT turn (next-turn-frontier).
+ *   3. (future) flagging the reply with a banner.
+ *
+ * Conservative on purpose: a false positive harms nothing (we just
+ * escalate the next turn); a false negative is back to the bug.
+ *
+ * ASCII-only.
+ */
+/* alpha.59z.188 PND-038 -- "confusion" signals. When the eco brain
+ * says "mis disculpas / hubo un error en la comunicacion / aun
+ * estoy en el proceso", that is a leading indicator that the tier
+ * is over its head. We surface those separately so the chat server
+ * can write the same next-turn frontier hint without forcing a full
+ * hallucination flag. */
+const CONFUSION_PATTERNS = [
+    /\b(?:mis\s+disculpas|disculpa(?:me)?|mil\s+disculpas|perd[oó]n(?:ame)?)\b/i,
+    /\b(?:hubo\s+un\s+error|tuve\s+un\s+error|se\s+produjo\s+un\s+error|error\s+en\s+la\s+comunicaci[oó]n|me\s+confund[ií])\b/i,
+    /\b(?:aun\s+estoy\s+en\s+el\s+proceso|aun\s+no\s+he\s+terminado|todav[ií]a\s+estoy\s+(?:en\s+proceso|configurando|trabajando))\b/i,
+    /\b(?:i\s+apologi[sz]e|my\s+apologies|sorry\s+about\s+that|i\s+got\s+confused|i\s+made\s+(?:an?\s+)?error)\b/i,
+];
+/* Phrases that look like "I did / I am doing the work". Each entry
+ * is checked case-insensitively. Order doesn't matter; we return on
+ * the first match. */
+const ANNOUNCE_PATTERNS = [
+    /\b(?:voy a|procedo a|procedere a|procederé a|empiezo a|comienzo a|inicio|iniciando|configurando|configurare|configuraré|implementando|instalando|deplegando|deployando)\b/i,
+    /\b(?:ya\s+(?:lo\s+)?(?:hice|hecho|cre[eé]|configur[eé]|complet[eé]|ejecut[eé]|proces[eé]|termin[eé])|ya\s+est[aá]\s+(?:listo|configurado|hecho|creado)|lo\s+he\s+(?:hecho|creado|completado|ejecutado|procesado))\b/i,
+    /\b(?:he\s+procesado|he\s+ejecutado|he\s+configurado|he\s+iniciado|he\s+completado|he\s+terminado|he\s+creado)\b/i,
+    /\b(?:proyecto\s+(?:ya\s+)?(?:est[aá]|fue|qued[oó])\s+(?:configurado|creado|listo|inicializado))\b/i,
+    /\b(?:i'?ll\s+(?:configure|setup|set up|create|deploy|install|run|start|process)|i\s+have\s+(?:configured|set up|created|deployed|installed|processed|completed)|i'?m\s+(?:configuring|setting up|creating|deploying|installing|processing))\b/i,
+    /\b(?:done|completed|finished|ready)\.?\s*(?:--|—|:)?\s*(?:the\s+)?(?:project|setup|configuration|install|deploy)\b/i,
+];
+/* If ANY of these "we definitely did real work" phrases appear, we
+ * waive the detector. Used when the brain references a verb by name
+ * (showing it knows what to call) or shows a concrete artifact. */
+const PROOF_PATTERNS = [
+    /\byujin\.[a-z][a-z0-9_-]*\.[a-z][a-z0-9_-]*\b/i, /* "yujin.foo.bar" verb name */
+    /\b(?:nac3_invoke|nac3\.invoke)\b/i,
+    /```/, /* code block -> usually an artifact */
+];
+/* "I cannot do X" / "I don't have the capability" -- this is a
+ * REFUSAL, not a hallucinated completion. We don't flag it here
+ * because it's a different bug (PND-037 router escalation). */
+const REFUSAL_PATTERNS = [
+    /\b(?:no\s+puedo|no\s+tengo\s+(?:la\s+)?capacidad|no\s+puedo\s+mostrar(?:te)?|cannot|can'?t)\b/i,
+];
+export function checkCompletionHallucination(reply_text, tool_uses_in_turn) {
+    const text = (reply_text || '').trim();
+    if (!text) {
+        return { is_hallucinated: false, matched_phrase: '', is_refusal: false, has_proof: false, is_confused: false };
+    }
+    const has_proof = PROOF_PATTERNS.some((re) => re.test(text));
+    let is_refusal = false;
+    let matched_phrase = '';
+    for (const re of REFUSAL_PATTERNS) {
+        const m = re.exec(text);
+        if (m) {
+            is_refusal = true;
+            matched_phrase = m[0].slice(0, 120);
+            break;
+        }
+    }
+    const is_confused = CONFUSION_PATTERNS.some((re) => re.test(text));
+    if (tool_uses_in_turn > 0) {
+        /* Tools actually fired -- whatever the LLM says, it's grounded. */
+        return { is_hallucinated: false, matched_phrase, is_refusal, has_proof, is_confused };
+    }
+    if (has_proof) {
+        return { is_hallucinated: false, matched_phrase, is_refusal, has_proof, is_confused };
+    }
+    for (const re of ANNOUNCE_PATTERNS) {
+        const m = re.exec(text);
+        if (m) {
+            return {
+                is_hallucinated: true,
+                matched_phrase: matched_phrase || m[0].slice(0, 120),
+                is_refusal,
+                has_proof,
+                is_confused,
+            };
+        }
+    }
+    return { is_hallucinated: false, matched_phrase, is_refusal, has_proof, is_confused };
+}
+//# sourceMappingURL=completion_hallucination_detector.js.map

package/dist/chat/completion_hallucination_detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion_hallucination_detector.js","sourceRoot":"","sources":["../../src/chat/completion_hallucination_detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;yBAKyB;AACzB,MAAM,kBAAkB,GAAa;IACnC,4EAA4E;IAC5E,2HAA2H;IAC3H,kIAAkI;IAClI,8GAA8G;CAC/G,CAAC;AAEF;;sBAEsB;AACtB,MAAM,iBAAiB,GAAa;IAClC,4KAA4K;IAC5K,sNAAsN;IACtN,kHAAkH;IAClH,oGAAoG;IACpG,gPAAgP;IAChP,qHAAqH;CACtH,CAAC;AAEF;;mEAEmE;AACnE,MAAM,cAAc,GAAa;IAC/B,gDAAgD,EAAK,+BAA+B;IACpF,mCAAmC;IACnC,KAAK,EAAkD,uCAAuC;CAC/F,CAAC;AAEF;;+DAE+D;AAC/D,MAAM,gBAAgB,GAAa;IACjC,gGAAgG;CACjG,CAAC;AAqBF,MAAM,UAAU,4BAA4B,CAC1C,UAAkB,EAClB,iBAAyB;IAEzB,MAAM,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACjH,CAAC;IACD,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,EAAE,CAAC;YAAC,UAAU,GAAG,IAAI,CAAC;YAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAAC,MAAM;QAAC,CAAC;IAC3E,CAAC;IACD,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;QAC1B,mEAAmE;QACnE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IACxF,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IACxF,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,iBAAiB,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,EAAE,CAAC;YACN,OAAO;gBACL,eAAe,EAAE,IAAI;gBACrB,cAAc,EAAE,cAAc,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBACpD,UAAU;gBACV,SAAS;gBACT,WAAW;aACZ,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AACxF,CAAC"}

package/dist/chat/doctrine_digest.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Doctrine digest (dogfood 2026-06-10).
+ *
+ * Pablo's rule: the doctrines ARE the code-quality guardrails, so
+ * they must be in EVERY system prompt -- short + mandatory -- not
+ * fetched on-demand (the model choosing to discover is exactly how
+ * a guardrail gets skipped). This module renders a condensed,
+ * always-injected block: one mandatory line (the rule essence) per
+ * doctrine, with the full text still available via
+ * yujin.doctrine.discover.
+ *
+ * Parity is enforced by tests/doctrine-digest-parity.test.ts: every
+ * docs/doctrine/<slug>.md MUST have an entry here, or the suite goes
+ * red. (Enumerating the source of truth -- the .md files -- not a
+ * sample. See verification-honesty.md rule 2/3.)
+ *
+ * ASCII-only.
+ */
+export interface DoctrineDigestEntry {
+    /** One or more doctrine slugs this line condenses. */
+    slugs: string[];
+    /** The mandatory rule essence (kept to ~1-3 lines). */
+    rule: string;
+}
+export declare const DOCTRINE_DIGEST: DoctrineDigestEntry[];
+/** All slugs covered by the digest (for the parity test). */
+export declare function digestSlugs(): string[];
+/** Render the always-injected mandatory block for the system prompt.
+ *  Returned as an array of lines to splice into the prompt builder. */
+export declare function buildDoctrineDigestLines(): string[];
+//# sourceMappingURL=doctrine_digest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctrine_digest.d.ts","sourceRoot":"","sources":["../../src/chat/doctrine_digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,eAAe,EAAE,mBAAmB,EA6EhD,CAAC;AAEF,6DAA6D;AAC7D,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED;uEACuE;AACvE,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAenD"}

package/dist/chat/doctrine_digest.js

@@ -0,0 +1,117 @@
+/**
+ * Doctrine digest (dogfood 2026-06-10).
+ *
+ * Pablo's rule: the doctrines ARE the code-quality guardrails, so
+ * they must be in EVERY system prompt -- short + mandatory -- not
+ * fetched on-demand (the model choosing to discover is exactly how
+ * a guardrail gets skipped). This module renders a condensed,
+ * always-injected block: one mandatory line (the rule essence) per
+ * doctrine, with the full text still available via
+ * yujin.doctrine.discover.
+ *
+ * Parity is enforced by tests/doctrine-digest-parity.test.ts: every
+ * docs/doctrine/<slug>.md MUST have an entry here, or the suite goes
+ * red. (Enumerating the source of truth -- the .md files -- not a
+ * sample. See verification-honesty.md rule 2/3.)
+ *
+ * ASCII-only.
+ */
+export const DOCTRINE_DIGEST = [
+    {
+        slugs: ['verification-honesty'],
+        rule: 'a GREEN test is NOT proof -- verify it goes red on the real '
+            + 'regression before claiming it guards; cover EVERY row of a '
+            + 'data/config table, not a sample; claims proportional to what '
+            + 'the code enforces; when reporting, separate VERIFIED '
+            + '(ran/read/reproduced) from BELIEVED (assumed).',
+    },
+    {
+        slugs: ['testing-policy'],
+        rule: 'tests POST-implementation for every change; the scaffold gate '
+            + 'must be green before disk; TDD-first only for backend / '
+            + 'finance / regulatory / integration slices.',
+    },
+    {
+        slugs: ['nac3-attrs'],
+        rule: 'every interactive element carries the 5 data-nac-* attrs (id, role, action, label, hint).',
+    },
+    {
+        slugs: ['accessibility'],
+        rule: 'announce destructive results via yujin.a11y.*; full voice parity, including INSIDE modals (global phrases suspend while a modal is open).',
+    },
+    {
+        slugs: ['gates'],
+        rule: 'owner-approval gates (esp. Gate 13) BLOCK phase advance; never self-approve a gate.',
+    },
+    {
+        slugs: ['workflow', 'workflow-phases'],
+        rule: 'follow the 6-phase / 18-step workflow; persist each step you complete; do not mark a phase done without its evidence.',
+    },
+    {
+        slugs: ['workflow-kinds'],
+        rule: 'THREE workflows: greenfield (new app, 18 steps), corrective (fix a live project), evolutive (extend a live project). Classify + ASK which one; corrective/evolutive are compact and MUST refresh docs; log each transition with yujin.workflow.log-step. Never force greenfield on a live project.',
+    },
+    {
+        slugs: ['g-doc'],
+        rule: 'generated docs + adopter apps use the Yujin HTML look derived from REAL code, not placeholders.',
+    },
+    {
+        slugs: ['explain-results'],
+        rule: 'report results in user prose (what came back + what it means), not raw verb output.',
+    },
+    {
+        slugs: ['safety-refusals'],
+        rule: 'refuse destructive / malicious requests naming the concrete risk; dual-use needs an authorization context.',
+    },
+    {
+        slugs: ['language-sovereignty'],
+        rule: 'the user picks the language; translate the EXPERIENCE (UI, docs, prose), not the protocol (verb ids, code identifiers, established tech jargon).',
+    },
+    {
+        slugs: ['default-design-system'],
+        rule: 'use the Yujin Design System (sumi-e tokens) by default before any custom styling.',
+    },
+    {
+        slugs: ['verb-composition'],
+        rule: 'compose native verbs in dependency order (read before parse, etc.); prefer a yujin.* verb over shell.',
+    },
+    {
+        slugs: ['pizarron'],
+        rule: 'create-tab = canvas content YOU generated; open-file = a disk file; opening a file is NOT saving it.',
+    },
+    {
+        slugs: ['r8-modal'],
+        rule: 'approval-required actions go through the R8 modal -- the modal IS the question.',
+    },
+    {
+        slugs: ['byok-vs-managed', 'cost-router-escalation'],
+        rule: 'BYOK when the user has provider keys, managed otherwise; honor the eco/frontier override; escalate on quality signals.',
+    },
+    {
+        slugs: ['mcp-bridge-lifecycle', 'office-tools', 'expo-eas-builds', 'agent-orchestrator', 'yf-commands', 'lessons-workflow'],
+        rule: 'task-specific guardrails -- discover the matching doctrine when the work touches MCP bridges, office docs (docx/xlsx), Expo/EAS builds, product-side agents, the yf CLI catalog, or the lessons system.',
+    },
+];
+/** All slugs covered by the digest (for the parity test). */
+export function digestSlugs() {
+    return DOCTRINE_DIGEST.flatMap((e) => e.slugs);
+}
+/** Render the always-injected mandatory block for the system prompt.
+ *  Returned as an array of lines to splice into the prompt builder. */
+export function buildDoctrineDigestLines() {
+    const lines = [
+        '=================================================================',
+        'QUALITY DOCTRINES (mandatory -- these are the guardrails)',
+        '=================================================================',
+        '',
+        'Non-optional, every change. Each bullet is the rule; fetch the',
+        'full text with yujin.doctrine.discover({slugs:["<slug>"]}).',
+        '',
+    ];
+    for (const e of DOCTRINE_DIGEST) {
+        lines.push('* ' + e.slugs.join(' / ') + ': ' + e.rule);
+    }
+    lines.push('');
+    return lines;
+}
+//# sourceMappingURL=doctrine_digest.js.map

package/dist/chat/doctrine_digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctrine_digest.js","sourceRoot":"","sources":["../../src/chat/doctrine_digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,MAAM,CAAC,MAAM,eAAe,GAA0B;IACpD;QACE,KAAK,EAAE,CAAC,sBAAsB,CAAC;QAC/B,IAAI,EACF,8DAA8D;cAC5D,6DAA6D;cAC7D,+DAA+D;cAC/D,uDAAuD;cACvD,gDAAgD;KACrD;IACD;QACE,KAAK,EAAE,CAAC,gBAAgB,CAAC;QACzB,IAAI,EACF,gEAAgE;cAC9D,0DAA0D;cAC1D,4CAA4C;KACjD;IACD;QACE,KAAK,EAAE,CAAC,YAAY,CAAC;QACrB,IAAI,EAAE,2FAA2F;KAClG;IACD;QACE,KAAK,EAAE,CAAC,eAAe,CAAC;QACxB,IAAI,EAAE,2IAA2I;KAClJ;IACD;QACE,KAAK,EAAE,CAAC,OAAO,CAAC;QAChB,IAAI,EAAE,qFAAqF;KAC5F;IACD;QACE,KAAK,EAAE,CAAC,UAAU,EAAE,iBAAiB,CAAC;QACtC,IAAI,EAAE,uHAAuH;KAC9H;IACD;QACE,KAAK,EAAE,CAAC,gBAAgB,CAAC;QACzB,IAAI,EAAE,oSAAoS;KAC3S;IACD;QACE,KAAK,EAAE,CAAC,OAAO,CAAC;QAChB,IAAI,EAAE,iGAAiG;KACxG;IACD;QACE,KAAK,EAAE,CAAC,iBAAiB,CAAC;QAC1B,IAAI,EAAE,qFAAqF;KAC5F;IACD;QACE,KAAK,EAAE,CAAC,iBAAiB,CAAC;QAC1B,IAAI,EAAE,4GAA4G;KACnH;IACD;QACE,KAAK,EAAE,CAAC,sBAAsB,CAAC;QAC/B,IAAI,EAAE,kJAAkJ;KACzJ;IACD;QACE,KAAK,EAAE,CAAC,uBAAuB,CAAC;QAChC,IAAI,EAAE,mFAAmF;KAC1F;IACD;QACE,KAAK,EAAE,CAAC,kBAAkB,CAAC;QAC3B,IAAI,EAAE,uGAAuG;KAC9G;IACD;QACE,KAAK,EAAE,CAAC,UAAU,CAAC;QACnB,IAAI,EAAE,sGAAsG;KAC7G;IACD;QACE,KAAK,EAAE,CAAC,UAAU,CAAC;QACnB,IAAI,EAAE,iFAAiF;KACxF;IACD;QACE,KAAK,EAAE,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;QACpD,IAAI,EAAE,wHAAwH;KAC/H;IACD;QACE,KAAK,EAAE,CAAC,sBAAsB,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,aAAa,EAAE,kBAAkB,CAAC;QAC3H,IAAI,EAAE,yMAAyM;KAChN;CACF,CAAC;AAEF,6DAA6D;AAC7D,MAAM,UAAU,WAAW;IACzB,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED;uEACuE;AACvE,MAAM,UAAU,wBAAwB;IACtC,MAAM,KAAK,GAAa;QACtB,mEAAmE;QACnE,2DAA2D;QAC3D,mEAAmE;QACnE,EAAE;QACF,gEAAgE;QAChE,6DAA6D;QAC7D,EAAE;KACH,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC;AACf,CAAC"}

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":"AAwCA,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,CA6EnB;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,177 @@
+/**
+ * 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 { upsertNodes } from '../semantic_graph/store.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 + '...');
+    /* alpha.59z.180 PND-012 slice B -- write to the LOCAL SQLite
+     * store first (BYOK-strict; never touches the worker by default).
+     * When hybrid sync is opted in for this project, ALSO push to
+     * the D1 worker so a future `yf graph sync --pull` on another
+     * laptop sees the same graph. */
+    const nowIso = new Date().toISOString();
+    const localNodes = nodes.map((n) => ({
+        id: n.id,
+        kind: n.kind,
+        name: n.name,
+        ...(n.version ? { version: n.version } : {}),
+        source: n.source,
+        purpose: n.purpose,
+        solves: n.solves,
+        do_not_invent: n.do_not_invent,
+        api_surface: n.api_surface,
+        confidence: n.confidence,
+        weight: n.weight,
+        added_at: nowIso,
+        updated_at: nowIso,
+    }));
+    let added = 0, updated = 0;
+    try {
+        const r = await upsertNodes(opts.project_slug, localNodes);
+        added = r.inserted;
+        updated = r.updated;
+        log('[auto-ingest] local OK added=' + added + ' updated=' + updated);
+    }
+    catch (err) {
+        log('[auto-ingest] local upsert error: ' + (err instanceof Error ? err.message : String(err)));
+        return false;
+    }
+    /* No worker mirror as of alpha.59z.182. The D1 sync path is
+     * parked until PND-016 closes P3 Platform billing decisions.
+     * BYOK plain = 100% local; sync goes under the P3 tier later. */
+    state.slugs[opts.project_slug] = {
+        package_json_mtime_ms: mtimeMs,
+        ingested_at: new Date().toISOString(),
+        lib_count: nodes.length,
+    };
+    await writeState(state);
+    return true;
+}
+/* ----- 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,34 @@
+import type { GraphNode } from '../semantic_graph/types.js';
+export interface ParsedExport {
+    name: string;
+    kind: 'function' | 'const' | 'class' | 'type' | 'interface';
+}
+/** PND-020 Phase 2a -- AST-based extraction. The earlier regex
+ *  implementation is gone; the public shape is preserved so callers
+ *  (including the watcher + the test suite) work unchanged. types
+ *  + interfaces are filtered here too (they aren't runtime
+ *  primitives). For the full picture call extractExportsAst. */
+export declare function extractExports(source: string, fileName?: 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. PND-020 Phase 2a -- uses
+ *  the AST extractor for is_component / is_hook / jsdoc signals. */
+declare function nodesForFile(projectRoot: string, _projectSlug: string, filePath: string): Promise<GraphNode[]>;
+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":"AAmCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAO5D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;CAC7D;AAED;;;;gEAIgE;AAChE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAW,GAAG,YAAY,EAAE,CAIlF;AAED,sDAAsD;AACtD,iBAAS,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;oEACoE;AACpE,iBAAe,YAAY,CACzB,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAC1D,OAAO,CAAC,SAAS,EAAE,CAAC,CAsCtB;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,CAgGzB;AAED,iBAAiB;AACjB,eAAO,MAAM,SAAS;;;CAAqC,CAAC"}