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

package/dist/chat/yujin_splash.js

@@ -0,0 +1,147 @@
+/**
+ * Yujin animated logo splash (desktop panel).
+ *
+ * The sumi-e branch draws itself, sakura bloom in the brand palette
+ * (indigo / red / gold / teal), then "Yujin" + the kanji fade up.
+ * Same asset as the CRM login. Shown for a few seconds on panel boot,
+ * then fades out to reveal the app.
+ *
+ * ASCII-only (the kanji is the single exception -- it is the brand).
+ */
+/** The logo SVG markup (viewBox 400x320). Animation is driven by the
+ *  CSS classes in YUJIN_SPLASH_STYLE. */
+export const YUJIN_LOGO_SVG = `<svg id="yujin-logo" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 320" width="400" height="320">
+<g transform="scale(0.85) translate(18,14)">
+<path class="branch" d="M 60 240 Q 110 200,155 168 Q 195 138,235 112 Q 268 88,300 68 Q 325 52,348 40" fill="none" stroke="#1A1815" stroke-width="5.5" stroke-linecap="round" opacity="0.85" style="animation-delay:0.1s"/>
+<path class="branch-ghost" d="M 62 242 Q 112 202,157 170 Q 197 140,237 114" fill="none" stroke="#1A1815" stroke-width="1.8" stroke-linecap="round" opacity="0.10" style="animation-delay:0.2s"/>
+<path class="branch-sec" d="M 155 168 Q 138 148,126 130 Q 115 114,108 98" fill="none" stroke="#2C2927" stroke-width="3" stroke-linecap="round" opacity="0.72" style="animation-delay:1.0s"/>
+<path class="branch-sec" d="M 268 88 Q 276 68,274 50 Q 272 36,266 24" fill="none" stroke="#2C2927" stroke-width="2.5" stroke-linecap="round" opacity="0.65" style="animation-delay:1.1s"/>
+<path class="branch-short" d="M 300 68 Q 316 56,326 42" fill="none" stroke="#2C2927" stroke-width="2" stroke-linecap="round" opacity="0.58" style="animation-delay:1.2s"/>
+<path class="branch-short" d="M 235 112 Q 222 94,215 78" fill="none" stroke="#2C2927" stroke-width="1.8" stroke-linecap="round" opacity="0.52" style="animation-delay:1.15s"/>
+<g transform="translate(108,98) rotate(-18)">
+  <ellipse class="petal" cx="0" cy="-13" rx="6.5" ry="12" fill="#2D3A8C" style="--op:0.83;--r:0deg;animation-delay:1.4s"/>
+  <ellipse class="petal" cx="0" cy="-13" rx="6.5" ry="12" fill="#2D3A8C" transform="rotate(72)" style="--op:0.83;--r:72deg;animation-delay:1.5s"/>
+  <ellipse class="petal" cx="0" cy="-13" rx="6.5" ry="12" fill="#3D4DAA" transform="rotate(144)" style="--op:0.71;--r:144deg;animation-delay:1.6s"/>
+  <ellipse class="petal" cx="0" cy="-13" rx="6.5" ry="12" fill="#2D3A8C" transform="rotate(216)" style="--op:0.76;--r:216deg;animation-delay:1.7s"/>
+  <ellipse class="petal" cx="0" cy="-13" rx="6.5" ry="12" fill="#3D4DAA" transform="rotate(288)" style="--op:0.73;--r:288deg;animation-delay:1.8s"/>
+  <circle class="flower-center" cx="0" cy="0" r="3.8" fill="#F8F7F4" style="--op:0.92;animation-delay:1.85s"/>
+  <circle class="flower-center" cx="0" cy="0" r="1.9" fill="#C2893A" style="--op:0.82;animation-delay:1.9s"/>
+</g>
+<g transform="translate(168,155) rotate(14)">
+  <ellipse class="petal" cx="0" cy="-11" rx="5.8" ry="10.5" fill="#943020" style="--op:0.79;--r:0deg;animation-delay:1.7s"/>
+  <ellipse class="petal" cx="0" cy="-11" rx="5.8" ry="10.5" fill="#B34030" transform="rotate(72)" style="--op:0.71;--r:72deg;animation-delay:1.8s"/>
+  <ellipse class="petal" cx="0" cy="-11" rx="5.8" ry="10.5" fill="#943020" transform="rotate(144)" style="--op:0.76;--r:144deg;animation-delay:1.9s"/>
+  <ellipse class="petal" cx="0" cy="-11" rx="5.8" ry="10.5" fill="#B34030" transform="rotate(216)" style="--op:0.69;--r:216deg;animation-delay:2.0s"/>
+  <ellipse class="petal" cx="0" cy="-11" rx="5.8" ry="10.5" fill="#943020" transform="rotate(288)" style="--op:0.73;--r:288deg;animation-delay:2.1s"/>
+  <circle class="flower-center" cx="0" cy="0" r="3.3" fill="#F8F7F4" style="--op:0.92;animation-delay:2.15s"/>
+  <circle class="flower-center" cx="0" cy="0" r="1.7" fill="#2D3A8C" style="--op:0.76;animation-delay:2.2s"/>
+</g>
+<g transform="translate(215,78) rotate(-33)">
+  <ellipse class="petal" cx="0" cy="-9.5" rx="4.8" ry="9" fill="#5A66E8" style="--op:0.66;--r:0deg;animation-delay:2.0s"/>
+  <ellipse class="petal" cx="0" cy="-9.5" rx="4.8" ry="9" fill="#4A56D8" transform="rotate(72)" style="--op:0.61;--r:72deg;animation-delay:2.1s"/>
+  <ellipse class="petal" cx="0" cy="-9.5" rx="4.8" ry="9" fill="#5A66E8" transform="rotate(144)" style="--op:0.63;--r:144deg;animation-delay:2.2s"/>
+  <ellipse class="petal" cx="0" cy="-9.5" rx="4.8" ry="9" fill="#4A56D8" transform="rotate(216)" style="--op:0.59;--r:216deg;animation-delay:2.3s"/>
+  <ellipse class="petal" cx="0" cy="-9.5" rx="4.8" ry="9" fill="#5A66E8" transform="rotate(288)" style="--op:0.63;--r:288deg;animation-delay:2.4s"/>
+  <circle class="flower-center" cx="0" cy="0" r="2.8" fill="#F8F7F4" style="--op:0.9;animation-delay:2.45s"/>
+  <circle class="flower-center" cx="0" cy="0" r="1.4" fill="#C2893A" style="--op:0.72;animation-delay:2.5s"/>
+</g>
+<g transform="translate(266,24) rotate(8)">
+  <ellipse class="petal" cx="0" cy="-12" rx="6" ry="11" fill="#C2893A" style="--op:0.81;--r:0deg;animation-delay:2.2s"/>
+  <ellipse class="petal" cx="0" cy="-12" rx="6" ry="11" fill="#D4993A" transform="rotate(72)" style="--op:0.73;--r:72deg;animation-delay:2.3s"/>
+  <ellipse class="petal" cx="0" cy="-12" rx="6" ry="11" fill="#C2893A" transform="rotate(144)" style="--op:0.77;--r:144deg;animation-delay:2.4s"/>
+  <ellipse class="petal" cx="0" cy="-12" rx="6" ry="11" fill="#D4993A" transform="rotate(216)" style="--op:0.71;--r:216deg;animation-delay:2.5s"/>
+  <ellipse class="petal" cx="0" cy="-12" rx="6" ry="11" fill="#C2893A" transform="rotate(288)" style="--op:0.75;--r:288deg;animation-delay:2.6s"/>
+  <circle class="flower-center" cx="0" cy="0" r="3.6" fill="#F8F7F4" style="--op:0.92;animation-delay:2.65s"/>
+  <circle class="flower-center" cx="0" cy="0" r="1.8" fill="#943020" style="--op:0.72;animation-delay:2.7s"/>
+</g>
+<g transform="translate(326,42) rotate(-12)">
+  <ellipse class="petal" cx="0" cy="-8.5" rx="4.3" ry="8" fill="#0F6E66" style="--op:0.73;--r:0deg;animation-delay:2.4s"/>
+  <ellipse class="petal" cx="0" cy="-8.5" rx="4.3" ry="8" fill="#1D9E75" transform="rotate(72)" style="--op:0.66;--r:72deg;animation-delay:2.5s"/>
+  <ellipse class="petal" cx="0" cy="-8.5" rx="4.3" ry="8" fill="#0F6E66" transform="rotate(144)" style="--op:0.69;--r:144deg;animation-delay:2.6s"/>
+  <ellipse class="petal" cx="0" cy="-8.5" rx="4.3" ry="8" fill="#1D9E75" transform="rotate(216)" style="--op:0.63;--r:216deg;animation-delay:2.7s"/>
+  <ellipse class="petal" cx="0" cy="-8.5" rx="4.3" ry="8" fill="#0F6E66" transform="rotate(288)" style="--op:0.67;--r:288deg;animation-delay:2.8s"/>
+  <circle class="flower-center" cx="0" cy="0" r="2.6" fill="#F8F7F4" style="--op:0.9;animation-delay:2.85s"/>
+  <circle class="flower-center" cx="0" cy="0" r="1.3" fill="#2D3A8C" style="--op:0.67;animation-delay:2.9s"/>
+</g>
+<g transform="translate(348,40) rotate(-6)">
+  <ellipse class="petal" cx="0" cy="-10.5" rx="5.2" ry="9.5" fill="#2D3A8C" style="--op:0.71;--r:0deg;animation-delay:2.6s"/>
+  <ellipse class="petal" cx="0" cy="-10.5" rx="5.2" ry="9.5" fill="#3D4DAA" transform="rotate(72)" style="--op:0.63;--r:72deg;animation-delay:2.7s"/>
+  <ellipse class="petal" cx="0" cy="-10.5" rx="5.2" ry="9.5" fill="#2D3A8C" transform="rotate(144)" style="--op:0.68;--r:144deg;animation-delay:2.8s"/>
+  <ellipse class="petal" cx="0" cy="-10.5" rx="5.2" ry="9.5" fill="#3D4DAA" transform="rotate(216)" style="--op:0.61;--r:216deg;animation-delay:2.9s"/>
+  <ellipse class="petal" cx="0" cy="-10.5" rx="5.2" ry="9.5" fill="#2D3A8C" transform="rotate(288)" style="--op:0.66;--r:288deg;animation-delay:3.0s"/>
+  <circle class="flower-center" cx="0" cy="0" r="3.2" fill="#F8F7F4" style="--op:0.9;animation-delay:3.05s"/>
+  <circle class="flower-center" cx="0" cy="0" r="1.6" fill="#C2893A" style="--op:0.72;animation-delay:3.1s"/>
+</g>
+<g transform="translate(128,130) rotate(-38)">
+  <ellipse class="petal" cx="0" cy="-6.5" rx="3.2" ry="6.5" fill="#5A66E8" style="--op:0.52;--r:0deg;animation-delay:1.6s"/>
+  <ellipse class="petal" cx="0" cy="-6.5" rx="3.2" ry="6.5" fill="#4A56D8" transform="rotate(90)" style="--op:0.46;--r:90deg;animation-delay:1.65s"/>
+  <circle class="flower-center" cx="0" cy="0" r="1.9" fill="#F8F7F4" style="--op:0.80;animation-delay:1.7s"/>
+</g>
+<g transform="translate(310,60) rotate(18)">
+  <ellipse class="petal" cx="0" cy="-5.5" rx="2.8" ry="5.5" fill="#C2893A" style="--op:0.48;--r:0deg;animation-delay:2.35s"/>
+  <ellipse class="petal" cx="0" cy="-5.5" rx="2.8" ry="5.5" fill="#D4993A" transform="rotate(90)" style="--op:0.42;--r:90deg;animation-delay:2.4s"/>
+  <circle class="flower-center" cx="0" cy="0" r="1.7" fill="#F8F7F4" style="--op:0.75;animation-delay:2.45s"/>
+</g>
+<ellipse class="petal-fallen" cx="90" cy="222" rx="4.5" ry="8.5" fill="#2D3A8C" transform="rotate(-28 90 222)" style="--op:0.17;animation-delay:3.0s"/>
+<ellipse class="petal-fallen" cx="128" cy="236" rx="3.8" ry="7.5" fill="#943020" transform="rotate(16 128 236)" style="--op:0.14;animation-delay:3.1s"/>
+<ellipse class="petal-fallen" cx="192" cy="228" rx="3.2" ry="6.5" fill="#C2893A" transform="rotate(-22 192 228)" style="--op:0.11;animation-delay:3.2s"/>
+<path class="ghost-stroke" d="M 72 252 Q 88 242,105 238" fill="none" stroke="#1A1815" stroke-width="0.7" stroke-linecap="round" opacity="0.09" style="animation-delay:1.3s"/>
+</g>
+<text class="text-main" x="253" y="259" font-family="'Noto Serif JP',Georgia,serif" font-size="90" font-weight="300" fill="#1A1815" opacity="0.88" text-anchor="middle" letter-spacing="-1" style="--op:0.88;animation-delay:3.3s">Yujin</text>
+<line class="deco-line" x1="148" y1="270" x2="358" y2="270" stroke="#2D3A8C" stroke-width="0.6" style="opacity:0.28;animation-delay:3.9s"/>
+<text class="kanji-text" x="253" y="308" font-family="'Noto Serif JP',Georgia,serif" font-size="15" font-weight="300" fill="#615E58" text-anchor="middle" letter-spacing="7" style="--op:0.65;animation-delay:4.1s">友人</text>
+</svg>`;
+/** Keyframes + the per-element draw/bloom classes. Shared by the
+ *  desktop overlay and (inlined) by the mobile WebView. */
+export const YUJIN_LOGO_KEYFRAMES = `
+.branch{stroke-dasharray:600;stroke-dashoffset:600;animation:draw 1.2s cubic-bezier(0.4,0,0.2,1) forwards}
+.branch-sec{stroke-dasharray:200;stroke-dashoffset:200;animation:draw 0.7s cubic-bezier(0.4,0,0.2,1) forwards}
+.branch-ghost{stroke-dasharray:300;stroke-dashoffset:300;animation:draw 1.0s cubic-bezier(0.4,0,0.2,1) forwards}
+.branch-short{stroke-dasharray:100;stroke-dashoffset:100;animation:draw 0.5s cubic-bezier(0.4,0,0.2,1) forwards}
+@keyframes draw{to{stroke-dashoffset:0}}
+@keyframes bloom{0%{opacity:0;transform:scale(0) rotate(var(--r,0deg))}60%{opacity:1;transform:scale(1.15) rotate(var(--r,0deg))}100%{opacity:var(--op,1);transform:scale(1) rotate(var(--r,0deg))}}
+@keyframes petalFade{from{opacity:0}to{opacity:var(--op,1)}}
+@keyframes fadeUp{from{opacity:0;transform:translateY(8px)}to{opacity:var(--op,1);transform:translateY(0)}}
+@keyframes drawLine{from{stroke-dashoffset:210}to{stroke-dashoffset:0}}
+.petal{animation:bloom 0.5s cubic-bezier(0.34,1.56,0.64,1) forwards;opacity:0;transform-origin:0 0}
+.flower-center{animation:petalFade 0.3s ease forwards;opacity:0}
+.text-main{animation:fadeUp 0.8s cubic-bezier(0.16,1,0.3,1) forwards;opacity:0}
+.deco-line{stroke-dasharray:210;stroke-dashoffset:210;animation:drawLine 0.6s cubic-bezier(0.4,0,0.2,1) forwards}
+.kanji-text{animation:fadeUp 0.6s cubic-bezier(0.16,1,0.3,1) forwards;opacity:0}
+.ghost-stroke{stroke-dasharray:80;stroke-dashoffset:80;animation:draw 0.4s ease forwards}
+.petal-fallen{animation:petalFade 0.4s ease forwards;opacity:0}
+`;
+/** Full-screen overlay styles (desktop). Cream washi backdrop +
+ *  fade-out. */
+export const YUJIN_SPLASH_STYLE = `<style id="yf-splash-style">
+#yf-splash{position:fixed;inset:0;z-index:99999;display:flex;align-items:center;justify-content:center;
+  background:radial-gradient(ellipse at 50% 42%, #FBFAF7 0%, #F2EEE4 70%, #EAE4D6 100%);
+  transition:opacity 0.7s ease, visibility 0.7s ease}
+#yf-splash.yf-splash-hide{opacity:0;visibility:hidden;pointer-events:none}
+#yf-splash #yujin-logo{width:min(70vw,440px);height:auto}
+#yf-splash .yf-splash-skip{position:absolute;bottom:26px;left:50%;transform:translateX(-50%);
+  font-family:ui-sans-serif,system-ui,sans-serif;font-size:11px;letter-spacing:2px;color:#9A948A;
+  text-transform:uppercase;cursor:pointer;opacity:0;animation:fadeUp 0.6s ease forwards;animation-delay:4.6s}
+#yf-splash .yf-splash-skip:hover{color:#2D3A8C}
+${YUJIN_LOGO_KEYFRAMES}
+</style>`;
+/** The overlay markup to inject at the top of <body>. Pair with
+ *  YUJIN_SPLASH_STYLE in <head> and SPLASH_FADE_SCRIPT before </body>. */
+export function renderYujinSplash() {
+    return '<div id="yf-splash" data-yf-splash role="presentation">'
+        + YUJIN_LOGO_SVG
+        + '<div class="yf-splash-skip" data-yf-splash-skip>entrar</div>'
+        + '</div>';
+}
+/** Inline JS that fades the splash out after the animation settles,
+ *  or immediately on click. Show-once-per-tab via sessionStorage so a
+ *  reload mid-session is not gated. */
+export const SPLASH_FADE_SCRIPT = `(function(){
+  var s=document.getElementById('yf-splash');if(!s)return;
+  try{ if(sessionStorage.getItem('yf_splash_seen')==='1'){ s.parentNode&&s.parentNode.removeChild(s); return; } }catch(e){}
+  function hide(){ if(!s)return; s.classList.add('yf-splash-hide'); try{sessionStorage.setItem('yf_splash_seen','1');}catch(e){}
+    setTimeout(function(){ s&&s.parentNode&&s.parentNode.removeChild(s); s=null; },750); }
+  var t=setTimeout(hide,4800);
+  s.addEventListener('click',function(){ clearTimeout(t); hide(); });
+})();`;
+//# sourceMappingURL=yujin_splash.js.map

package/dist/chat/yujin_splash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yujin_splash.js","sourceRoot":"","sources":["../../src/chat/yujin_splash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;yCACyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgFvB,CAAC;AAER;2DAC2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;CAiBnC,CAAC;AAEF;gBACgB;AAChB,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;EAUhC,oBAAoB;SACb,CAAC;AAEV;0EAC0E;AAC1E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,yDAAyD;UAC5D,cAAc;UACd,8DAA8D;UAC9D,QAAQ,CAAC;AACf,CAAC;AAED;;uCAEuC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;MAO5B,CAAC"}

package/dist/commands/agent.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `yf agent` CLI (HITO 5 slice 1).
+ *
+ * Subcommands shipped in this slice:
+ *   yf agent list [--status <s>] [--json]   -- list local agents
+ *   yf agent show <slug> [--json]           -- show a single agent
+ *   yf agent doctor [--json]                -- print effective
+ *                                              agent config (every
+ *                                              key + source).
+ *
+ * Subsequent slices add:
+ *   yf agent run <slug>          (slice 2 -- runner)
+ *   yf agent install --defaults  (slice 2 -- default agent seed)
+ *   yf agent delete <slug>       (slice 2 -- soft delete)
+ *   yf agent inbox <slug>        (slice 3 -- bridge)
+ *
+ * All shipped subcommands are read-only -- no agent code runs
+ * until the runner slice lands.
+ */
+import type { Command } from 'commander';
+import { type StepFn } from '../agents/runner.js';
+import type { AgentDefinition } from '../agents/types.js';
+export interface RegisterAgentCommandDeps {
+    makeRealStep?: (opts: {
+        def: AgentDefinition;
+        trigger_reason: string;
+        project_root: string;
+        project_name: string;
+        forge_version: string;
+    }) => Promise<StepFn>;
+}
+export declare function registerAgentCommand(program: Command, deps?: RegisterAgentCommandDeps): void;
+//# sourceMappingURL=agent.d.ts.map

package/dist/commands/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAyB,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAKjF,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QACpB,GAAG,EAAa,eAAe,CAAC;QAChC,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAI,MAAM,CAAC;QACvB,YAAY,EAAI,MAAM,CAAC;QACvB,aAAa,EAAG,MAAM,CAAC;KACxB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,wBAA6B,GAAG,IAAI,CAkRhG"}

package/dist/commands/agent.js

@@ -0,0 +1,281 @@
+import { listAgentDefinitions, getAgentDefinition, filterByStatus, saveAgentDefinition, softDeleteAgent } from '../agents/store.js';
+import { snapshotAgentConfig } from '../agents/config_resolver.js';
+import { DEFAULT_AGENTS } from '../agents/defaults.js';
+import { runAgent } from '../agents/runner.js';
+export function registerAgentCommand(program, deps = {}) {
+    const agent = program.command('agent')
+        .description('Agent orchestrator (HITO 5) -- list, inspect, configure.');
+    agent.command('list')
+        .description('List local agents.')
+        .option('--status <s>', 'filter by status (active|paused|deleted|auto_revoked)')
+        .option('--json', 'emit JSON instead of a table')
+        .action(async (opts) => {
+        let defs = await listAgentDefinitions();
+        if (opts.status) {
+            const want = opts.status;
+            defs = filterByStatus(defs, want);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(defs, null, 2));
+            return;
+        }
+        if (defs.length === 0) {
+            console.log('No agents registered.' + (opts.status ? ' (filter: status=' + opts.status + ')' : ''));
+            console.log('Slice 2 will ship `yf agent install --defaults` to seed brain-matrix-nightly-watcher + web-search.');
+            return;
+        }
+        console.log('  slug                                 status         tier      trigger     description');
+        console.log('  ' + '-'.repeat(96));
+        for (const d of defs) {
+            const slug = d.slug.padEnd(36, ' ').slice(0, 36);
+            const status = d.status.padEnd(14, ' ').slice(0, 14);
+            const tier = d.brain_tier.padEnd(9, ' ').slice(0, 9);
+            const trig = d.trigger.kind.padEnd(11, ' ').slice(0, 11);
+            const desc = (d.description || '').slice(0, 40);
+            console.log('  ' + slug + ' ' + status + ' ' + tier + ' ' + trig + ' ' + desc);
+        }
+        console.log('');
+        console.log('Total: ' + defs.length + ' agent(s).');
+    });
+    agent.command('show')
+        .description('Show a single agent definition.')
+        .argument('<slug>', 'agent slug')
+        .option('--json', 'emit JSON instead of a table')
+        .action(async (slug, opts) => {
+        const def = await getAgentDefinition(slug);
+        if (!def) {
+            console.error('No agent with slug ' + JSON.stringify(slug) + '.');
+            console.error('Run `yf agent list` to see registered slugs.');
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(def, null, 2));
+            return;
+        }
+        console.log('Agent: ' + def.slug);
+        console.log('  Name:        ' + def.name);
+        console.log('  Description: ' + def.description);
+        console.log('  Status:      ' + def.status + (def.revoked_reason ? ' (' + def.revoked_reason + ')' : ''));
+        console.log('  Brain tier:  ' + def.brain_tier);
+        console.log('  Trigger:     ' + def.trigger.kind + ' ' + JSON.stringify(def.trigger.config));
+        console.log('  Created:     ' + new Date(def.created_at).toISOString());
+        console.log('  Updated:     ' + new Date(def.updated_at).toISOString());
+        console.log('');
+        console.log('  can_call:         [' + def.can_call.join(', ') + ']');
+        console.log('  can_be_called_by: [' + def.can_be_called_by.join(', ') + ']');
+        console.log('  allowed_verbs:    ' + (def.allowed_verbs.length === 0 ? '(all from manifest)' : '[' + def.allowed_verbs.join(', ') + ']'));
+        if (def.prompt_addition) {
+            console.log('');
+            console.log('  prompt_addition:');
+            for (const line of def.prompt_addition.split(/\r?\n/)) {
+                console.log('    ' + line);
+            }
+        }
+    });
+    agent.command('install')
+        .description('Install agent definitions. With --defaults, seeds brain-matrix-nightly-watcher + web-search.')
+        .option('--defaults', 'seed the shipped default agents')
+        .option('--force', 'overwrite existing definitions (used with --defaults)')
+        .option('--json', 'emit JSON summary')
+        .action(async (opts) => {
+        if (!opts.defaults) {
+            console.error('install: pass --defaults to seed the shipped defaults.');
+            console.error('Authoring custom agents from a file lands in a later slice.');
+            process.exitCode = 1;
+            return;
+        }
+        const created = [];
+        const skipped = [];
+        const overwritten = [];
+        for (const def of DEFAULT_AGENTS) {
+            const existing = await getAgentDefinition(def.slug);
+            if (existing && !opts.force) {
+                skipped.push(def.slug);
+                continue;
+            }
+            const ok = await saveAgentDefinition(def);
+            if (!ok) {
+                console.error('saveAgentDefinition failed for ' + def.slug);
+                process.exitCode = 1;
+                return;
+            }
+            if (existing)
+                overwritten.push(def.slug);
+            else
+                created.push(def.slug);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ created, overwritten, skipped }, null, 2));
+            return;
+        }
+        if (created.length > 0)
+            console.log('Created:     ' + created.join(', '));
+        if (overwritten.length > 0)
+            console.log('Overwrote:   ' + overwritten.join(', '));
+        if (skipped.length > 0)
+            console.log('Skipped (already present, use --force to overwrite): ' + skipped.join(', '));
+        if (created.length === 0 && overwritten.length === 0 && skipped.length === 0) {
+            console.log('Nothing to do.');
+        }
+    });
+    agent.command('delete')
+        .description('Soft-delete an agent. Moves to ~/.yujin-forge/agents/deleted/<slug>__<ts>/ for the grace period (agent.deletion.grace_period_days).')
+        .argument('<slug>', 'agent slug')
+        .option('--yes', 'skip confirmation (required when not on a TTY)')
+        .option('--json', 'emit JSON summary')
+        .action(async (slug, opts) => {
+        const existing = await getAgentDefinition(slug);
+        if (!existing) {
+            console.error('No agent with slug ' + JSON.stringify(slug) + '.');
+            process.exitCode = 1;
+            return;
+        }
+        if (!opts.yes) {
+            /* Best-effort confirmation. On non-TTY (CI), require --yes. */
+            if (!process.stdin.isTTY) {
+                console.error('Refusing to delete without --yes on a non-TTY.');
+                process.exitCode = 1;
+                return;
+            }
+            process.stdout.write('Delete agent ' + JSON.stringify(slug) + '? (y/N) ');
+            const ok = await new Promise((resolve) => {
+                process.stdin.once('data', (b) => resolve(/^y/i.test(b.toString().trim())));
+                process.stdin.resume();
+            });
+            if (!ok) {
+                console.log('Aborted.');
+                return;
+            }
+        }
+        const moved = await softDeleteAgent(slug);
+        if (!moved) {
+            console.error('softDeleteAgent returned false for ' + slug);
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ slug, deleted: true }, null, 2));
+        }
+        else {
+            console.log('Deleted ' + slug + '. The agent + its runs are in the deleted/ partition.');
+        }
+    });
+    agent.command('run')
+        .description('Run one agent end-to-end. Default: stub step (Director sprint slice 8 lifecycle surface). With --real: live LLM dispatch via the production factory (slice 15e) -- requires anthropic_api_key in the vault.')
+        .argument('<slug>', 'agent slug to run')
+        .option('--reason <r>', 'trigger reason recorded on the AgentRun', 'cli-run')
+        .option('--no-persist', 'do not write the AgentRun to ~/.yujin-forge/agents/by-slug/<slug>/runs/')
+        .option('--json', 'emit JSON instead of human-readable summary')
+        .option('--real', 'use the real LLM step (slice 15e factory) instead of the stub')
+        .action(async (slug, opts) => {
+        const def = await getAgentDefinition(slug);
+        if (!def) {
+            console.error('No agent with slug ' + JSON.stringify(slug) + '. Run `yf agent list` to see registered slugs.');
+            process.exitCode = 1;
+            return;
+        }
+        const triggerReason = opts.reason || 'cli-run';
+        let stepFn;
+        if (opts.real) {
+            /* Live LLM step. Tests inject deps.makeRealStep; production
+             * falls back to the canonical builder that constructs
+             * Claude from the vault + wires the factory. */
+            const builder = deps.makeRealStep ?? (async (args) => {
+                const { makeRealStep } = await import('../agents/cli_real.js');
+                return makeRealStep({
+                    def: args.def,
+                    trigger_reason: args.trigger_reason,
+                    project_root: args.project_root,
+                    project_name: args.project_name,
+                    forge_version: args.forge_version,
+                });
+            });
+            try {
+                stepFn = await builder({
+                    def,
+                    trigger_reason: triggerReason,
+                    project_root: process.cwd(),
+                    project_name: def.name,
+                    forge_version: 'cli',
+                });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error('Failed to build real LLM step: ' + msg);
+                if (err && typeof err === 'object' && err.code === 'no_claude_key') {
+                    console.error('');
+                    console.error('Tip: run `yf keys setup --provider anthropic --key <KEY>` to load a key.');
+                }
+                process.exitCode = 1;
+                return;
+            }
+        }
+        else {
+            /* Stub step -- echoes that the agent ran + returns done.
+             * Default to keep the CLI usable without an API key. */
+            stepFn = async () => ({
+                text: 'cli stub: agent "' + slug + '" lifecycle exercised (no LLM call).',
+                tokens_in: 0,
+                tokens_out: 0,
+                tool_calls: 0,
+                done: true,
+            });
+        }
+        const run = await runAgent(def, {
+            trigger_kind: 'manual',
+            trigger_reason: triggerReason,
+            step: stepFn,
+            persist: opts.persist !== false,
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(run, null, 2));
+            process.exitCode = run.status === 'succeeded' ? 0 : 2;
+            return;
+        }
+        console.log('Run: ' + run.id);
+        console.log('  Slug:       ' + run.slug);
+        console.log('  Status:     ' + run.status + (run.kill_reason ? ' (' + run.kill_reason + ')' : ''));
+        console.log('  Trigger:    ' + run.trigger_kind + ' -- ' + run.trigger_reason);
+        console.log('  Started:    ' + new Date(run.started_at).toISOString());
+        if (run.ended_at)
+            console.log('  Ended:      ' + new Date(run.ended_at).toISOString());
+        console.log('  Tokens:     in=' + run.tokens_in + ' out=' + run.tokens_out);
+        console.log('  Tool calls: ' + run.tool_calls);
+        if (run.last_reply_summary) {
+            console.log('  Reply:      ' + run.last_reply_summary);
+        }
+        if (opts.persist === false) {
+            console.log('');
+            console.log('Note: --no-persist set, this run was NOT written to disk.');
+        }
+        process.exitCode = run.status === 'succeeded' ? 0 : 2;
+    });
+    agent.command('doctor')
+        .description('Print effective agent config (every key + source).')
+        .option('--json', 'emit JSON instead of a table')
+        .action(async (opts) => {
+        const snap = await snapshotAgentConfig();
+        if (opts.json) {
+            console.log(JSON.stringify(snap, null, 2));
+            return;
+        }
+        console.log('Agent orchestrator config (every key, every source)');
+        console.log('');
+        console.log('  key                                              source    value');
+        console.log('  ' + '-'.repeat(80));
+        for (const row of snap) {
+            const k = row.key.padEnd(50, ' ').slice(0, 50);
+            const s = row.source.padEnd(9, ' ');
+            console.log('  ' + k + ' ' + s + ' ' + JSON.stringify(row.value));
+        }
+        console.log('');
+        console.log('Total: ' + snap.length + ' config keys.');
+        console.log('');
+        console.log('Override hierarchy (highest precedence first):');
+        console.log('  1. env: YF_AGENT_<UPPER_SNAKE> = <value>');
+        console.log('  2. user: ~/.yujin-forge/agents/config.json key/value');
+        console.log('  3. default (published in src/agents/config_schema.ts)');
+    });
+}
+//# sourceMappingURL=agent.js.map

package/dist/commands/agent.js.map

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

package/dist/commands/approve.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `yf approve <doc...>` -- Phase IV step 13 of PRODUCT_WORKFLOW.md.
+ *
+ * The unbreakable gate. Forge refuses to proceed to Phase V
+ * (build) until the user has explicitly approved the 3 spec
+ * documents (RFP + arch + design) by their current sha256.
+ *
+ * Usage:
+ *   yf approve rfp                       approve one doc
+ *   yf approve rfp arch design          approve all three (batch)
+ *   yf approve --list                   show approval state
+ *   yf approve --revoke <doc>           revoke an approval
+ *
+ * Approval persists workflow.approvals.<doc> = {
+ *   approved_at:    ISO,
+ *   version_sha256: sha of the spec file at approval time
+ * }
+ *
+ * If the doc file changes after approval, Forge detects the sha
+ * mismatch + treats the approval as stale -- user must re-approve.
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export interface ApproveOptions {
+    cwd?: string;
+    list?: boolean;
+    revoke?: string;
+}
+export declare function runApprove(targets: string[], opts: ApproveOptions): Promise<void>;
+export declare function registerApproveCommand(program: Command): void;
+//# sourceMappingURL=approve.d.ts.map

package/dist/commands/approve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../src/commands/approve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAK,MAAM,CAAC;IAChB,IAAI,CAAC,EAAI,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuGD,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDvF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAc7D"}