@nac3/forge-cli 0.2.0-alpha.9 → 1.0.0

package/dist/core/error_formatter.js

@@ -0,0 +1,155 @@
+/**
+ * F104 -- Renderers for ForgeError surfaces.
+ *
+ * Three surfaces:
+ *   1. CLI stderr: formatForgeErrorCli(err) -> ANSI-coloured block.
+ *   2. Chat panel HTML: formatForgeErrorHtml(err) -> red block with
+ *      copy-cmd button. Safe HTML (escaped).
+ *   3. JSON wire (SSE / HTTP body): formatForgeErrorJson(err) ->
+ *      the ForgeError object itself, ready to JSON.stringify.
+ *
+ * ASCII-only.
+ */
+import { tForLang } from '../i18n/index.js';
+/* ===================================================================
+ * CLI formatter (ANSI colours, stderr-friendly)
+ * ================================================================ */
+function ansi(code, text) {
+    if (!process.stderr.isTTY)
+        return text;
+    return '\x1b[' + code + 'm' + text + '\x1b[0m';
+}
+function severityColour(s) {
+    switch (s) {
+        case 'info': return (t) => ansi('36', t); // cyan
+        case 'warning': return (t) => ansi('33', t); // yellow
+        case 'error': return (t) => ansi('31', t); // red
+        case 'fatal': return (t) => ansi('1;31', t); // bold red
+        default: return (t) => t;
+    }
+}
+function severityLabel(s, lang = 'es') {
+    switch (s) {
+        case 'info': return tForLang(lang, 'error_ui.severity.info');
+        case 'warning': return tForLang(lang, 'error_ui.severity.warning');
+        case 'error': return tForLang(lang, 'error_ui.severity.error');
+        case 'fatal': return tForLang(lang, 'error_ui.severity.fatal');
+        default: return tForLang(lang, 'error_ui.severity.error');
+    }
+}
+/** Format a ForgeError for CLI stderr output.
+ *  @param err   The error.
+ *  @param lang  Optional UI language for the labels. Default 'es'. */
+export function formatForgeErrorCli(err, lang = 'es') {
+    const col = severityColour(err.severity);
+    const sep = ansi('90', '-'.repeat(72)); // dim dashes
+    const head = col('[' + severityLabel(err.severity, lang) + '] ' + err.code);
+    const parts = [];
+    parts.push('');
+    parts.push(sep);
+    parts.push(head);
+    parts.push(sep);
+    parts.push(ansi('1', tForLang(lang, 'error_ui.label.what') + ':') + ' ' + err.what);
+    parts.push(ansi('1', tForLang(lang, 'error_ui.label.why') + ':') + ' ' + err.why);
+    parts.push(ansi('1', tForLang(lang, 'error_ui.label.fix') + ':') + ' ' + err.fix);
+    if (err.cmd) {
+        parts.push('');
+        parts.push(ansi('1', tForLang(lang, 'error_ui.label.cmd') + ':') + ' ' + ansi('32', err.cmd));
+    }
+    if (err.docs_path) {
+        parts.push('');
+        parts.push(ansi('90', tForLang(lang, 'error_ui.label.docs') + ': ' + err.docs_path));
+    }
+    if (typeof err.retry_in_sec === 'number' && err.retry_in_sec > 0) {
+        parts.push('');
+        parts.push(ansi('90', tForLang(lang, 'error_ui.label.retry') + ': ' + err.retry_in_sec + 's'));
+    }
+    parts.push(sep);
+    parts.push('');
+    return parts.join('\n');
+}
+/* ===================================================================
+ * HTML formatter (chat panel, safe)
+ * ================================================================ */
+function htmlEscape(s) {
+    return s.replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+function severityCssClass(s) {
+    switch (s) {
+        case 'info': return 'forge-err forge-err--info';
+        case 'warning': return 'forge-err forge-err--warn';
+        case 'error': return 'forge-err forge-err--error';
+        case 'fatal': return 'forge-err forge-err--fatal';
+        default: return 'forge-err';
+    }
+}
+/** Format a ForgeError as safe HTML for the chat panel. The panel
+ *  is expected to have CSS for .forge-err / .forge-err--{severity}
+ *  / .forge-err__copy-btn etc; this returns ONLY the markup.
+ *  @param err   The error.
+ *  @param lang  Optional UI language for the labels. Default 'es'. */
+export function formatForgeErrorHtml(err, lang = 'es') {
+    const cls = severityCssClass(err.severity);
+    const lvl = severityLabel(err.severity, lang);
+    const parts = [];
+    parts.push('<div class="' + cls + '" data-code="' + htmlEscape(err.code) + '">');
+    parts.push('  <div class="forge-err__head">');
+    parts.push('    <span class="forge-err__severity">' + htmlEscape(lvl) + '</span>');
+    parts.push('    <code class="forge-err__code">' + htmlEscape(err.code) + '</code>');
+    parts.push('  </div>');
+    parts.push('  <dl class="forge-err__body">');
+    parts.push('    <dt>' + htmlEscape(tForLang(lang, 'error_ui.label.what')) + '</dt><dd>' + htmlEscape(err.what) + '</dd>');
+    parts.push('    <dt>' + htmlEscape(tForLang(lang, 'error_ui.label.why')) + '</dt><dd>' + htmlEscape(err.why) + '</dd>');
+    parts.push('    <dt>' + htmlEscape(tForLang(lang, 'error_ui.label.fix')) + '</dt><dd>' + htmlEscape(err.fix) + '</dd>');
+    parts.push('  </dl>');
+    if (err.cmd) {
+        parts.push('  <div class="forge-err__cmd">');
+        parts.push('    <pre><code>' + htmlEscape(err.cmd) + '</code></pre>');
+        parts.push('    <button class="forge-err__copy-btn" data-cmd="' + htmlEscape(err.cmd) + '">' + htmlEscape(tForLang(lang, 'error_ui.copy_btn')) + '</button>');
+        parts.push('  </div>');
+    }
+    if (err.docs_path) {
+        parts.push('  <div class="forge-err__docs">' + htmlEscape(tForLang(lang, 'error_ui.label.docs')) + ': <code>' + htmlEscape(err.docs_path) + '</code></div>');
+    }
+    if (typeof err.retry_in_sec === 'number' && err.retry_in_sec > 0) {
+        parts.push('  <div class="forge-err__retry">' + htmlEscape(tForLang(lang, 'error_ui.label.retry')) + ' ' + err.retry_in_sec + 's</div>');
+    }
+    parts.push('</div>');
+    return parts.join('\n');
+}
+/* ===================================================================
+ * JSON wire format
+ * ================================================================ */
+/** Strip undefined keys for clean JSON serialisation. */
+export function formatForgeErrorJson(err) {
+    const out = {
+        code: err.code,
+        what: err.what,
+        why: err.why,
+        fix: err.fix,
+        severity: err.severity,
+    };
+    if (err.cmd)
+        out.cmd = err.cmd;
+    if (err.docs_path)
+        out.docs_path = err.docs_path;
+    if (typeof err.retry_in_sec === 'number')
+        out.retry_in_sec = err.retry_in_sec;
+    if (err.context && Object.keys(err.context).length > 0)
+        out.context = err.context;
+    return out;
+}
+/* ===================================================================
+ * SSE event helper
+ * ================================================================ */
+/** Serialise a ForgeError as a Server-Sent-Events block.
+ *  Stream consumers should listen for event: forge_error. */
+export function forgeErrorAsSseEvent(err) {
+    return 'event: forge_error\n'
+        + 'data: ' + JSON.stringify(formatForgeErrorJson(err)) + '\n\n';
+}
+//# sourceMappingURL=error_formatter.js.map

package/dist/core/error_formatter.js.map

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

package/dist/core/incomplete_detector.d.ts

@@ -0,0 +1,51 @@
+/**
+ * incomplete_detector.ts -- detects when an eco-tier reply looks
+ * confused / refused / truncated, so handleChat can escalate the
+ * turn to frontier without surfacing the bad reply to the user
+ * (alpha.57).
+ *
+ * The trigger is conservative on purpose. False positives mean
+ * we burn a frontier call when eco was fine; false negatives
+ * mean the user sees Gemini Lite's confused reply. We err on the
+ * "escalate" side only when there is a clear signal.
+ *
+ * Signals scanned:
+ *
+ *   1. Hallucinated-error phrases ("error de mapeo", "tuve un
+ *      error en el workflow", "i had an internal error",
+ *      "perdon, hubo un problema").
+ *   2. Refuse / dodge phrases ("no tengo suficiente informacion",
+ *      "necesito mas contexto para responder", "i need more
+ *      context to help with this", "no puedo procesar este
+ *      pedido", "no puedo ayudarte con eso").
+ *   3. Tool-round errors: any tool_round with is_error=true
+ *      whose error message looks like a schema / args failure
+ *      (typical Gemini misfire). NOT every tool error -- those
+ *      can be legitimate.
+ *   4. Length-vs-complexity mismatch: user prompt >= 120 chars
+ *      AND reply <= 60 chars AND no tool was called. That
+ *      signature reliably catches "I do not understand" replies.
+ *
+ * Output: { incomplete, signals[] }. The caller decides whether
+ * to escalate (it must also check the frontier budget cap).
+ *
+ * Cap: incomplete_detector runs ONLY when the served tier was
+ * eco. We never auto-escalate frontier -> something else.
+ *
+ * ASCII-only.
+ */
+import type { ToolRound } from '../chat/claude.js';
+export interface DetectInput {
+    /** The original user text that triggered the turn. */
+    user_text: string;
+    /** The reply the eco tier produced. */
+    reply_text: string;
+    /** Tool rounds the eco LLM executed during this turn. */
+    tool_rounds?: ToolRound[];
+}
+export interface DetectResult {
+    incomplete: boolean;
+    signals: string[];
+}
+export declare function detectIncomplete(input: DetectInput): DetectResult;
+//# sourceMappingURL=incomplete_detector.d.ts.map

package/dist/core/incomplete_detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incomplete_detector.d.ts","sourceRoot":"","sources":["../../src/core/incomplete_detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAkDD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAsDjE"}

package/dist/core/incomplete_detector.js

@@ -0,0 +1,140 @@
+/**
+ * incomplete_detector.ts -- detects when an eco-tier reply looks
+ * confused / refused / truncated, so handleChat can escalate the
+ * turn to frontier without surfacing the bad reply to the user
+ * (alpha.57).
+ *
+ * The trigger is conservative on purpose. False positives mean
+ * we burn a frontier call when eco was fine; false negatives
+ * mean the user sees Gemini Lite's confused reply. We err on the
+ * "escalate" side only when there is a clear signal.
+ *
+ * Signals scanned:
+ *
+ *   1. Hallucinated-error phrases ("error de mapeo", "tuve un
+ *      error en el workflow", "i had an internal error",
+ *      "perdon, hubo un problema").
+ *   2. Refuse / dodge phrases ("no tengo suficiente informacion",
+ *      "necesito mas contexto para responder", "i need more
+ *      context to help with this", "no puedo procesar este
+ *      pedido", "no puedo ayudarte con eso").
+ *   3. Tool-round errors: any tool_round with is_error=true
+ *      whose error message looks like a schema / args failure
+ *      (typical Gemini misfire). NOT every tool error -- those
+ *      can be legitimate.
+ *   4. Length-vs-complexity mismatch: user prompt >= 120 chars
+ *      AND reply <= 60 chars AND no tool was called. That
+ *      signature reliably catches "I do not understand" replies.
+ *
+ * Output: { incomplete, signals[] }. The caller decides whether
+ * to escalate (it must also check the frontier budget cap).
+ *
+ * Cap: incomplete_detector runs ONLY when the served tier was
+ * eco. We never auto-escalate frontier -> something else.
+ *
+ * ASCII-only.
+ */
+/* All patterns are normalised to lowercase + accent-stripped
+ *  before matching. */
+function norm(s) {
+    return (s || '').normalize('NFD').replace(/[̀-ͯ]/g, '').toLowerCase();
+}
+/* Specific hallucinated-error phrases we have seen Gemini Lite
+ *  emit when it loses the workflow context. */
+const HALLUCINATED_ERRORS = [
+    'error de mapeo',
+    'tuve un error',
+    'i had an internal error',
+    'hubo un problema',
+    'perdon, hubo un problema',
+    'perdon, tuve',
+    'me equivoque al',
+    'voy a corregir el registro',
+    'tuve un error de mapeo',
+    'tuve un fallo',
+    'something went wrong on my side',
+    'i ran into an issue processing',
+];
+/* Refuse / dodge patterns -- the assistant is asking for more
+ *  context instead of using what's already in the conversation. */
+const REFUSE_DODGE = [
+    'necesito mas contexto',
+    'necesito mas informacion',
+    'no tengo suficiente informacion',
+    'no tengo suficiente contexto',
+    'i need more context',
+    'i need additional context',
+    'i do not have enough context',
+    'i do not have enough information',
+    'no puedo procesar este pedido',
+    'no puedo procesar el pedido',
+    'no puedo ayudarte con eso',
+    'i cannot help with this',
+    'i am unable to process',
+];
+function findPhrase(haystack, patterns) {
+    for (const p of patterns) {
+        if (haystack.includes(p))
+            return p;
+    }
+    return null;
+}
+export function detectIncomplete(input) {
+    const signals = [];
+    const userN = norm(input.user_text || '');
+    const replyN = norm(input.reply_text || '');
+    /* 1. Hallucinated errors. */
+    const err = findPhrase(replyN, HALLUCINATED_ERRORS);
+    if (err)
+        signals.push('hallucinated_error[' + err + ']');
+    /* 2. Refuse / dodge. */
+    const dodge = findPhrase(replyN, REFUSE_DODGE);
+    if (dodge)
+        signals.push('refuse_dodge[' + dodge + ']');
+    /* 3. Tool-round error fingerprints. */
+    const rounds = Array.isArray(input.tool_rounds) ? input.tool_rounds : [];
+    let schemaErrors = 0;
+    for (const r of rounds) {
+        if (!r || r.is_error !== true)
+            continue;
+        const result = r.result;
+        let resultText = '';
+        if (typeof result === 'string')
+            resultText = result;
+        else if (result && typeof result === 'object') {
+            try {
+                resultText = JSON.stringify(result);
+            }
+            catch {
+                resultText = '';
+            }
+        }
+        const rn = norm(resultText);
+        if (rn.includes('schema') || rn.includes('invalid args') || rn.includes('required field')
+            || rn.includes('expected') || rn.includes('unknown property')
+            || rn.includes('verb not found') || rn.includes('unknown verb_id')) {
+            schemaErrors += 1;
+        }
+    }
+    if (schemaErrors > 0)
+        signals.push('schema_errors[' + schemaErrors + ']');
+    /* 4. Length-vs-complexity mismatch (NO tool calls + tiny reply
+     *  + long user prompt). Calls are NOT counted as the user
+     *  prompt is the new turn, not the entire history.
+     *
+     *  Why no tool calls: if eco invoked a tool successfully + the
+     *  short reply just says "ok" / "listo", that is fine. The
+     *  problem case is when eco produced a tiny "I cannot do this"
+     *  text reply with no work behind it. */
+    const userLen = (input.user_text || '').length;
+    const replyLen = (input.reply_text || '').length;
+    const usedTools = rounds.length > 0;
+    if (!usedTools && userLen >= 120 && replyLen <= 60) {
+        signals.push('length_mismatch[user=' + userLen + ',reply=' + replyLen + ']');
+    }
+    return {
+        incomplete: signals.length > 0,
+        signals,
+    };
+}
+//# sourceMappingURL=incomplete_detector.js.map

package/dist/core/incomplete_detector.js.map

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

package/dist/core/keys_envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys_envelope.d.ts","sourceRoot":"","sources":["../../src/core/keys_envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,CAAC,EAAE,CAAC,CAAC;IACL;;;8BAG0B;IAC1B,yBAAyB,CAAC,EAAE,aAAa,CAAC;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0BAA0B,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAAC;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB,CAAC,EAAE,eAAe,GAAG,mBAAmB,CAAC;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC9C,uBAAuB,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,CAAC,CAAC;IACL,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAwCD,qBAAa,iBAAkB,SAAQ,KAAK;aACd,IAAI,EAAE,WAAW,GAAG,YAAY;gBAAhC,IAAI,EAAE,WAAW,GAAG,YAAY;CAG7D;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,qBAAqB,EAC9B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAYvB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,CAAC,CA2BhC;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAKxD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAe3D"}
+{"version":3,"file":"keys_envelope.d.ts","sourceRoot":"","sources":["../../src/core/keys_envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmBH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,CAAC,EAAE,CAAC,CAAC;IACL;;;8BAG0B;IAC1B,yBAAyB,CAAC,EAAE,aAAa,CAAC;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0BAA0B,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAAC;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB,CAAC,EAAE,eAAe,GAAG,mBAAmB,CAAC;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC9C,uBAAuB,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,CAAC,CAAC;IACL,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAkCD,qBAAa,iBAAkB,SAAQ,KAAK;aACd,IAAI,EAAE,WAAW,GAAG,YAAY;gBAAhC,IAAI,EAAE,WAAW,GAAG,YAAY;CAG7D;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,qBAAqB,EAC9B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAYvB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,CAAC,CA2BhC;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAKxD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAe3D"}

package/dist/core/keys_envelope.js

@@ -12,10 +12,17 @@
  *
  * ASCII-only. WebCrypto only (Node 20+ / Workers / RN).
  */
+import { pbkdf2 } from '@noble/hashes/pbkdf2.js';
+import { sha256 } from '@noble/hashes/sha2.js';
+import { gcm } from '@noble/ciphers/aes.js';
 const ENC = new TextEncoder();
 const DEC = new TextDecoder();
-const PBKDF2_ITERS = 200_000;
-const KEY_BITS = 256;
+/* PND-095 -- 100k (was 200k). The secret is the high-entropy serverApiKey
+ * (not a low-entropy password), so PBKDF2 stretching adds little real
+ * security here, while 200k froze the Hermes UI ~8s on key sync. 100k
+ * matches the pairing KDF (PND-090). CLI + mobile MUST coincide. */
+const PBKDF2_ITERS = 100_000;
+const KEY_BYTES = 32; /* AES-256 */
 const IV_BYTES = 12;
 const SALT_BYTES = 16;
 const CONTEXT_TAG = 'yf-keys-sync-v1';
@@ -43,10 +50,12 @@ function randomBytes(n) {
     crypto.getRandomValues(out);
     return out;
 }
-async function deriveKey(secret, salt) {
+function deriveKey(secret, salt) {
+    /* The tagged secret keeps this key distinct from the pairing key
+     *  derived from the same secret. PBKDF2-SHA256 -> 32-byte AES key,
+     *  pure JS (runs on Hermes). */
     const taggedSecret = secret + ':' + CONTEXT_TAG;
-    const baseKey = await crypto.subtle.importKey('raw', ENC.encode(taggedSecret), { name: 'PBKDF2' }, false, ['deriveKey']);
-    return crypto.subtle.deriveKey({ name: 'PBKDF2', salt: salt, iterations: PBKDF2_ITERS, hash: 'SHA-256' }, baseKey, { name: 'AES-GCM', length: KEY_BITS }, false, ['encrypt', 'decrypt']);
+    return pbkdf2(sha256, ENC.encode(taggedSecret), salt, { c: PBKDF2_ITERS, dkLen: KEY_BYTES });
 }
 export class KeysEnvelopeError extends Error {
     kind;
@@ -58,14 +67,14 @@ export class KeysEnvelopeError extends Error {
 export async function encryptUserKeys(payload, serverApiKey) {
     const salt = randomBytes(SALT_BYTES);
     const iv = randomBytes(IV_BYTES);
-    const key = await deriveKey(serverApiKey, salt);
+    const key = deriveKey(serverApiKey, salt);
     const plain = ENC.encode(JSON.stringify(payload));
-    const ct = await crypto.subtle.encrypt({ name: 'AES-GCM', iv }, key, plain);
+    const ct = gcm(key, iv).encrypt(plain);
     return {
         v: 1,
         salt: bufToHex(salt),
         iv: bufToHex(iv),
-        ct: bufToHex(new Uint8Array(ct)),
+        ct: bufToHex(ct),
     };
 }
 export async function decryptUserKeys(envelope, serverApiKey) {
@@ -82,10 +91,10 @@ export async function decryptUserKeys(envelope, serverApiKey) {
     catch {
         throw new KeysEnvelopeError('malformed');
     }
-    const key = await deriveKey(serverApiKey, salt);
+    const key = deriveKey(serverApiKey, salt);
     let plain;
     try {
-        plain = await crypto.subtle.decrypt({ name: 'AES-GCM', iv }, key, ct);
+        plain = gcm(key, iv).decrypt(ct);
     }
     catch {
         throw new KeysEnvelopeError('bad_secret');

package/dist/core/keys_envelope.js.map

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

package/dist/core/learnings_client.d.ts

@@ -0,0 +1,104 @@
+/**
+ * F103 HITO 6.2 + 6.3 -- CLI client for the server-side lessons +
+ * doctrines worker.
+ *
+ * Three responsibilities:
+ *   1. Fetch /v1/lessons/active + /v1/doctrines/active from the
+ *      worker on demand.
+ *   2. Cache the responses locally for 5 min to avoid hammering
+ *      the worker on every system-prompt rebuild.
+ *   3. Fall back gracefully:
+ *      a. Worker unreachable -> stale cache (if any) -> embedded
+ *         fallback in dist/docs/doctrine/*.md.
+ *      b. Lessons -- no embedded fallback exists; if both worker
+ *         and cache fail, return empty array (CLI keeps working,
+ *         just without server-side lessons).
+ *
+ * Why local cache aggressive: the system prompt is rebuilt on
+ * every chat turn. Without cache, every turn would HTTP to the
+ * worker, adding ~100-300ms of latency. 5-min cache amortises.
+ *
+ * Why offline fallback: Forge must keep working when the worker
+ * is down. Doctrines have an embedded fallback in dist/. Lessons
+ * are an additive layer; missing them degrades gracefully.
+ *
+ * Cache shape:
+ *   ~/.yujin-forge/cache/lessons.json
+ *   ~/.yujin-forge/cache/doctrines.json
+ *
+ * Each file has { fetched_at: <unix ms>, payload: <server body> }.
+ *
+ * ASCII-only.
+ */
+export interface LessonRow {
+    slug: string;
+    rule_text: string;
+    scenario_json: string;
+    status: 'proposed' | 'active' | 'demoted' | 'archived';
+    evidence_count: number;
+    hit_count: number;
+    last_hit_at: string | null;
+    proposed_at: string;
+    promoted_at: string | null;
+    demoted_at: string | null;
+    rejection_reason: string | null;
+    min_cli_version: string;
+    proposed_by_handle_hash: string;
+    conflicts_with_json: string;
+}
+export interface DoctrineSummary {
+    slug: string;
+    version: number;
+    min_cli_version: string;
+}
+interface CacheEnvelope<T> {
+    fetched_at: number;
+    payload: T;
+    worker_url: string;
+}
+declare function cacheDir(): string;
+declare function workerBaseUrl(): string;
+declare function readCache<T>(file: string): Promise<CacheEnvelope<T> | null>;
+declare function writeCache<T>(file: string, envelope: CacheEnvelope<T>): Promise<void>;
+declare function isFresh(env: CacheEnvelope<unknown>): boolean;
+declare function isStale(env: CacheEnvelope<unknown>): boolean;
+/** Fetch the active lessons from the worker (cached 5 min locally).
+ *  Returns [] if the worker is unreachable AND no stale cache
+ *  exists -- the CLI keeps working, just without lessons. */
+export declare function fetchActiveLessons(opts?: {
+    force?: boolean;
+}): Promise<LessonRow[]>;
+/** Fetch a specific lesson by slug (for demoted lessons accessed
+ *  via yujin.doctrine.discover(learnings/<slug>)). No local cache --
+ *  these are infrequent + always go to the worker. */
+export declare function fetchLessonBySlug(slug: string): Promise<LessonRow | null>;
+/** Report an anonymized hit. Fire-and-forget; failures swallowed.
+ *  Drives LRU eviction on the server side. */
+export declare function reportLessonHit(slug: string): Promise<void>;
+/** Fetch the list of active doctrine slugs + their versions.
+ *  Falls back to the local dist/docs/doctrine/*.md filename list
+ *  when the worker is unreachable. */
+export declare function fetchActiveDoctrines(): Promise<DoctrineSummary[]>;
+/** Fetch the markdown body of a specific doctrine. Worker first,
+ *  filesystem fallback. */
+export declare function fetchDoctrineBySlug(slug: string): Promise<string | null>;
+/** Build the GLOBAL LEARNINGS section to inject into the system
+ *  prompt. Returns empty string when:
+ *   - There are no active lessons.
+ *   - The token budget is exhausted before any lesson fits.
+ *
+ *  Token estimation uses a 4-chars-per-token heuristic; close
+ *  enough for the budget cap. */
+export declare function buildGlobalLearningsSection(opts?: {
+    maxTokens?: number;
+}): Promise<string>;
+export declare const _internal: {
+    cacheDir: typeof cacheDir;
+    workerBaseUrl: typeof workerBaseUrl;
+    readCache: typeof readCache;
+    writeCache: typeof writeCache;
+    isFresh: typeof isFresh;
+    isStale: typeof isStale;
+};
+export {};
+//# sourceMappingURL=learnings_client.d.ts.map

package/dist/core/learnings_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings_client.d.ts","sourceRoot":"","sources":["../../src/core/learnings_client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAWH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,aAAa,CAAC,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iBAAS,QAAQ,IAAI,MAAM,CAE1B;AAED,iBAAS,aAAa,IAAI,MAAM,CAI/B;AAMD,iBAAe,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAO1E;AAED,iBAAe,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpF;AAED,iBAAS,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAErD;AAED,iBAAS,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAErD;AAMD;;6DAE6D;AAC7D,wBAAsB,kBAAkB,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA6B7F;AAED;;sDAEsD;AACtD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAU/E;AAED;8CAC8C;AAC9C,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASjE;AAMD;;sCAEsC;AACtC,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAyBvE;AAED;2BAC2B;AAC3B,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAa9E;AA2BD;;;;;;iCAMiC;AACjC,wBAAsB,2BAA2B,CAAC,IAAI,GAAE;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BvB;AAMD,eAAO,MAAM,SAAS;;;;;;;CAErB,CAAC"}