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

package/dist/qa/brain_matrix/fixtures/scenario_sumie_icon_pick_from_catalog.json

@@ -0,0 +1,56 @@
+{
+  "id": "sumie_icon_pick_from_catalog",
+  "description": "User asks for an icon. Validates the brain pulls from the sumi-e catalog instead of generating arbitrary SVG or suggesting Material/FontAwesome.",
+  "setup": {},
+  "turns": [
+    {
+      "kind": "user_says",
+      "text": "Necesito un icono para el modulo de finanzas."
+    }
+  ],
+  "invariants": [
+    {
+      "name": "no_invent_verbs",
+      "kind": "no_invent_verb",
+      "params": {}
+    },
+    {
+      "name": "uses_sumie_catalog",
+      "kind": "verb_invoked",
+      "params": {
+        "verb_id": "yujin.design.list-sumie"
+      }
+    },
+    {
+      "name": "mentions_sumie",
+      "kind": "text_contains_any",
+      "params": {
+        "substrs": [
+          "sumi-e",
+          "sumie",
+          "yujin.design.get-icon",
+          "catalog"
+        ]
+      }
+    }
+  ],
+  "fake_responses": [
+    {
+      "text": "Filtro el catalogo sumi-e por dominio finance.",
+      "tool_calls": [
+        {
+          "name": "nac3_invoke",
+          "args": {
+            "verb_id": "yujin.design.list-sumie",
+            "args": {
+              "tag": "finance"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "text": "Del catalogo sumi-e con tag finance: coin-stack, scale-balance, contract-seal, ledger-open. Cual preferis?"
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_tester_uses_shell_exec_only.json

@@ -0,0 +1,27 @@
+{
+  "id": "tester_uses_shell_exec_only",
+  "description": "Director live execution -- Tester sub-agent has allowed_verbs limited to yujin.shell.exec. When asked to run the test suite, it picks shell.exec (not a fs write, not a delegate). Validates per-role allowed_verbs constraint in the iterative_step.",
+  "setup": {
+    "extra_system_prompt": "TESTER ROLE active. Your single allowed verb is yujin.shell.exec. Run the test suite via the project's test command (e.g. pnpm vitest run). Do NOT call delegate, fs.write, pizarron, reader. If the test command fails, surface the failure text -- do NOT try to patch the code yourself (that is Scaffolder's job).\n\nVerbs:\n- yujin.shell.exec [u d] args:{cmd<required>}"
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Corre los tests E2E del slice X y dime si pasan." }
+  ],
+  "invariants": [
+    { "name": "uses_shell_exec", "kind": "verb_invoked", "params": { "verb_id": "yujin.shell.exec" } },
+    { "name": "no_delegate", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.agent.delegate" } },
+    { "name": "no_fs_write", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.fs.write-project-file" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} }
+  ],
+  "fake_responses": [
+    {
+      "text": "Corro la suite.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.shell.exec", "args": { "cmd": "pnpm vitest run tests/slice-X.test.ts" } } }
+      ]
+    },
+    {
+      "text": "Suite verde: 12/12 pasaron."
+    }
+  ]
+}

package/dist/version.d.ts

@@ -4,5 +4,5 @@
  * into the npm metadata) so we don't end up with two versions
  * drifting.
  */
-export declare const VERSION = "0.2.0-alpha.59z.121";
+export declare const VERSION = "0.2.0-alpha.59z.158";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -4,5 +4,5 @@
  * into the npm metadata) so we don't end up with two versions
  * drifting.
  */
-export const VERSION = '0.2.0-alpha.59z.121';
+export const VERSION = '0.2.0-alpha.59z.158';
 //# sourceMappingURL=version.js.map

package/dist/workflow/graph.d.ts

@@ -0,0 +1,59 @@
+/**
+ * src/workflow/graph.ts -- Director sprint slice 7.
+ *
+ * Pure transformer that takes the current `WorkflowState` and
+ * returns a {nodes, edges} shape the panel SVG (and any future
+ * consumer: CLI ASCII rendering, audit log, BPMN export) can
+ * render without re-implementing the 18-step model.
+ *
+ * The transformer mirrors the 6-phase taxonomy from
+ * `phase_inference.ts`:
+ *
+ *   phase_i   -- triage / intent / audits
+ *   phase_ii  -- clarification (functional + 4 NFR + blocks plan)
+ *   phase_iii -- specs (RFP + Arch + Design + approvals)
+ *   phase_iv  -- bootstrap
+ *   phase_v   -- block implementation (per blocks_progress)
+ *   phase_vi  -- deploy + postlaunch
+ *
+ * Status derivation:
+ *  - active phase = `inferActivePhase()`
+ *  - phases before active = 'done'
+ *  - active phase = 'active' UNLESS the project is fully closed,
+ *    in which case phase_vi flips from 'active' to 'done'.
+ *  - phases after active = 'pending'
+ *
+ * Step counts are granular per phase (4/6/6/1/N/2) so callers
+ * can render a progress chip. `step_done_count` never exceeds
+ * `step_count`. Phase V step count defaults to 1 when no blocks
+ * have been planned yet (placeholder slot for UI sizing).
+ *
+ * Labels are i18n keys (`workflow.phase.<phase>`) -- never raw
+ * text. The consumer resolves them at render time per locale.
+ *
+ * ASCII-only.
+ */
+import type { WorkflowState } from './state.js';
+import { type WorkflowPhase } from './phase_inference.js';
+export type WorkflowGraphNodeStatus = 'pending' | 'active' | 'done';
+export interface WorkflowGraphNode {
+    id: WorkflowPhase;
+    /** i18n catalog key -- `workflow.phase.i`..`workflow.phase.vi`. */
+    label_i18n_key: string;
+    status: WorkflowGraphNodeStatus;
+    /** Total atomic steps inside the phase (constant per phase, or
+     *  derived for phase_v from blocks_progress.length). */
+    step_count: number;
+    /** How many of those steps have a recorded closure milestone. */
+    step_done_count: number;
+}
+export interface WorkflowGraphEdge {
+    from: WorkflowPhase;
+    to: WorkflowPhase;
+}
+export interface WorkflowGraph {
+    nodes: WorkflowGraphNode[];
+    edges: WorkflowGraphEdge[];
+}
+export declare function buildWorkflowGraph(state: WorkflowState | undefined | null): WorkflowGraph;
+//# sourceMappingURL=graph.d.ts.map

package/dist/workflow/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/workflow/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE5E,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAiB,aAAa,CAAC;IACjC,mEAAmE;IACnE,cAAc,EAAK,MAAM,CAAC;IAC1B,MAAM,EAAa,uBAAuB,CAAC;IAC3C;4DACwD;IACxD,UAAU,EAAS,MAAM,CAAC;IAC1B,iEAAiE;IACjE,eAAe,EAAI,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAI,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAeD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,GAAG,aAAa,CAiCzF"}

package/dist/workflow/graph.js

@@ -0,0 +1,137 @@
+import { inferActivePhase } from './phase_inference.js';
+const PHASES = [
+    'phase_i', 'phase_ii', 'phase_iii', 'phase_iv', 'phase_v', 'phase_vi',
+];
+const PHASE_LABEL_KEYS = {
+    phase_i: 'workflow.phase.i',
+    phase_ii: 'workflow.phase.ii',
+    phase_iii: 'workflow.phase.iii',
+    phase_iv: 'workflow.phase.iv',
+    phase_v: 'workflow.phase.v',
+    phase_vi: 'workflow.phase.vi',
+};
+export function buildWorkflowGraph(state) {
+    const wf = state || {};
+    const active = inferActivePhase(wf);
+    const allDone = isFullyClosed(wf);
+    const nodes = PHASES.map((phase) => {
+        const idx = PHASES.indexOf(phase);
+        const activeIdx = PHASES.indexOf(active);
+        const counts = countSteps(phase, wf);
+        let status;
+        if (allDone) {
+            status = 'done';
+        }
+        else if (idx < activeIdx) {
+            status = 'done';
+        }
+        else if (idx === activeIdx) {
+            status = 'active';
+        }
+        else {
+            status = 'pending';
+        }
+        return {
+            id: phase,
+            label_i18n_key: PHASE_LABEL_KEYS[phase],
+            status,
+            step_count: counts.total,
+            step_done_count: counts.done,
+        };
+    });
+    const edges = [];
+    for (let i = 0; i < PHASES.length - 1; i++) {
+        edges.push({ from: PHASES[i], to: PHASES[i + 1] });
+    }
+    return { nodes, edges };
+}
+function countSteps(phase, wf) {
+    switch (phase) {
+        case 'phase_i': {
+            const total = 4;
+            let done = 0;
+            if (wf.tier)
+                done += 1;
+            if (wf.intent?.decided_at)
+                done += 1;
+            if (wf.legacy_audit?.ran_at)
+                done += 1;
+            if (wf.vault_inventory?.ran_at)
+                done += 1;
+            return { total, done };
+        }
+        case 'phase_ii': {
+            const total = 6;
+            const c = wf.clarification || {};
+            let done = 0;
+            const rounds = [
+                c.functional, c.nfr_quantitative, c.nfr_structural,
+                c.nfr_governance, c.nfr_operational,
+            ];
+            for (const r of rounds) {
+                if (r && r.done_at)
+                    done += 1;
+            }
+            if (c.blocks?.done_at)
+                done += 1;
+            return { total, done };
+        }
+        case 'phase_iii': {
+            const total = 6;
+            const s = wf.specs || {};
+            const a = wf.approvals || {};
+            let done = 0;
+            if (s.rfp?.done_at)
+                done += 1;
+            if (s.arch?.done_at)
+                done += 1;
+            if (s.design?.done_at)
+                done += 1;
+            if (a.rfp?.approved_at)
+                done += 1;
+            if (a.arch?.approved_at)
+                done += 1;
+            if (a.design?.approved_at)
+                done += 1;
+            return { total, done };
+        }
+        case 'phase_iv': {
+            const total = 1;
+            const done = wf.bootstrap?.done_at ? 1 : 0;
+            return { total, done };
+        }
+        case 'phase_v': {
+            const blocks = wf.blocks_progress || [];
+            if (blocks.length === 0) {
+                /* Placeholder slot so the UI reserves a chip for the phase
+                 * even before block planning materialises. */
+                return { total: 1, done: 0 };
+            }
+            const done = blocks.filter((b) => b.status === 'green').length;
+            return { total: blocks.length, done };
+        }
+        case 'phase_vi': {
+            const total = 2;
+            let done = 0;
+            if (wf.deploy?.done_at)
+                done += 1;
+            if (wf.postlaunch?.manual_at)
+                done += 1;
+            return { total, done };
+        }
+    }
+}
+function isFullyClosed(wf) {
+    /* Project is fully closed when phase_vi has its closure
+     * milestones (deploy.done_at + postlaunch.manual_at). Mirrors
+     * the inferActivePhase return-of-phase_vi terminal case. */
+    const deployed = !!wf.deploy?.done_at;
+    const postlaunchD = !!wf.postlaunch?.manual_at;
+    if (!deployed || !postlaunchD)
+        return false;
+    /* Also require everything upstream so a stray deploy on top of
+     * an unfinished phase_v does not falsely mark the project done. */
+    const upstreamActive = inferActivePhase(wf);
+    return upstreamActive === 'phase_vi';
+}
+//# sourceMappingURL=graph.js.map

package/dist/workflow/graph.js.map

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

package/dist/workflow/state.d.ts

@@ -59,6 +59,34 @@
  * ASCII-only.
  */
 export type WorkflowTier = 'simple' | 'medium' | 'full';
+/** Director sprint slice 14 -- language sovereignty.
+ *  Captures the language chosen per component slot. Slots are
+ *  open-ended so a project can add (e.g.) "edge-worker" without
+ *  a schema change. */
+export interface LanguageChoice {
+    /** Lowercase token. Examples: "ts", "go", "python", "rust",
+     *  "swift", "kotlin", "dart", "java", "c#", "php", "ruby",
+     *  "elixir", "sql", "hcl", "wasm". */
+    lang: string;
+    decided_at: string;
+    /** Who made this decision. "user" = explicit choice by the
+     *  user. "director_suggested" = default the Director
+     *  proposed + the user did not override. */
+    decided_by: 'user' | 'director_suggested';
+    /** Optional free-text rationale (preserved for audit). */
+    reason?: string;
+}
+export interface LanguageChoicesState {
+    frontend?: LanguageChoice;
+    mobile?: LanguageChoice;
+    backend?: LanguageChoice;
+    data_pipeline?: LanguageChoice;
+    infra?: LanguageChoice;
+    db?: LanguageChoice;
+    ml?: LanguageChoice;
+    /** Forward-compat catch-all for adopter-specific slots. */
+    [other: string]: LanguageChoice | undefined;
+}
 export interface IntentState {
     operation: 'migrate' | 'new' | 'modify' | null;
     target: 'desktop' | 'mobile' | 'responsive' | 'web-and-mobile' | null;
@@ -178,6 +206,12 @@ export interface WorkflowState {
     intent?: IntentState;
     legacy_audit?: LegacyAuditState;
     vault_inventory?: VaultInventoryState;
+    /** Director sprint phase II slice 14 -- language sovereignty.
+     *  The user picks the language per slot; the Director suggests
+     *  + persists choices here. Read/written via yujin.workflow.set
+     *  /state. See docs/doctrine/language-sovereignty.md for the
+     *  algorithm + suitability table. */
+    language_choices?: LanguageChoicesState;
     clarification?: ClarificationState;
     specs?: {
         rfp?: SpecDocState;

package/dist/workflow/state.d.ts.map

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

package/dist/workflow/state.js.map

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

package/docs/doctrine/default-design-system.md

@@ -0,0 +1,120 @@
+# Default design system -- Yujin DS first
+
+Fetch when the user discusses UI / component design / look-and-
+feel (signals: "componente", "modal", "sidebar", "card", "view",
+"icon", "color", "fuente", "diseno", "interfaz", "UI", "form",
+"button", "table", "kanban", "tabs"). Auto-injected on every
+turn whose intent matches the UI heuristic.
+
+## Rule (single source of truth)
+
+The default front-end design system for any Forge-generated
+project is **Yujin Design System** (`yujin-design-system/`). The
+package ships with 258 DTCG-compliant tokens, 30 NAC3-attributed
+component templates, 170 sumi-e icons + a kanji wordmark
+catalog, and font references (Google Fonts CDN, no bundled
+binaries).
+
+When the user asks for a UI element, agents MUST:
+
+1. Consult `yujin.design.list-templates` to see which Yujin
+   components cover the kind of element being requested.
+2. Use `yujin.design.get-template({slug})` to retrieve the HTML
+   + CSS + `nac3_attrs` + variants for the picked component.
+3. Splice the template into the project; do NOT hand-roll an
+   equivalent layout from scratch.
+4. Iconography: only pick from `yujin.design.list-sumie` (170
+   canonical icons). Use `yujin.design.get-icon({slug})` to
+   inline the SVG. Do NOT generate or import third-party icons
+   (no Material, no Font Awesome) unless the user explicitly
+   asks (override flow below).
+5. Colors / typography / spacing: only via tokens from
+   `yujin.design.tokens()`. Do NOT hardcode `#3A4DBC` or
+   `font-family: Inter`; use `var(--color-accent)` and
+   `var(--font-family-sans)`.
+
+## Override flow
+
+The user CAN override the default ("usa shadcn", "use Material",
+"this app needs Tailwind only", "I want my own brand colors"):
+
+- Agent invokes `yujin.design.override({system_id, reason})`.
+- This is `policy: 'approval_required'` so R8 opens a modal.
+- The user confirms (or rejects); the choice persists in
+  `tenant_config.design_override`.
+- Subsequent turns honor the override + the doctrine becomes a
+  soft suggestion ("Yujin DS is the Forge default, but this
+  tenant has overridden to <system>").
+
+## Why this is the default
+
+- Coherent visual language across every Forge-generated product
+  -- the user does not need to re-learn the look-and-feel per
+  product.
+- 30 components are enough to compose every standard SaaS UX
+  (CRM, admin panel, marketing site, e-commerce, dashboard,
+  task tracker, settings).
+- NAC3 attributes pre-applied -- every Yujin component is
+  voice-controllable + accessibility-ready out of the box.
+- 170 sumi-e icons cover virtually every business concept
+  (finance, sales, support, manufacturing, quality, HR, mobile,
+  AI, comms, document, geo, weather, animal). One coherent
+  illustration style.
+
+## Files in the package
+
+```
+yujin-design-system/
+  manifest.json                 catalog + version + license
+  tokens/
+    yujin-tokens.json           258 DTCG W3C tokens
+    yujin-tokens.css            generated CSS (same source-of-truth)
+  components/
+    _index.json                 list of 30 components by category
+    button.yujin.json           one file per component
+    card.yujin.json
+    ...                         (30 total)
+  icons/
+    sumie/
+      manifest.json             170 icons with tags
+      branch-sakura.svg         one SVG file per icon
+      ...                       (170 total)
+  fonts/
+    README.md                   reference-only policy (Google Fonts CDN)
+```
+
+## Six NAC3 verbs
+
+| Verb                            | Returns                                            | Policy             |
+|---------------------------------|----------------------------------------------------|--------------------|
+| `yujin.design.list-templates`   | `[{slug, category, description, variants}]`       | safe               |
+| `yujin.design.get-template`     | full ComponentTemplate (html, css, nac3, props)   | safe               |
+| `yujin.design.list-sumie`       | `[{slug, tags, file}]` (filtered by tag if given) | safe               |
+| `yujin.design.get-icon`         | inline SVG string                                  | safe               |
+| `yujin.design.tokens`           | full DTCG token tree                               | safe               |
+| `yujin.design.override`         | persists tenant_config.design_override            | approval-required  |
+
+## What this doctrine does NOT cover
+
+- Framework choice within TypeScript (Vue vs React vs Svelte).
+  See `docs/doctrine/language-sovereignty.md` -- the user
+  decides per slot, and the doctrine table records the choice.
+- Build tooling (Vite vs Webpack vs esbuild). Out of scope.
+- Theme switching per tenant. The override flow above persists
+  one choice per tenant; multi-theme support is a separate
+  feature.
+
+## What the WORKERS (Analyst, Coder, Director) do with this
+
+- **Analyst**: when extracting a spec that mentions UI elements
+  (forms, dashboards, modals), tag each one with the matching
+  Yujin component slug in `plan.components[]`. The Coder then
+  knows which template to pull.
+- **Coder**: before writing ANY UI file, invoke
+  `yujin.design.list-templates` + `yujin.design.get-template`
+  for the components in the plan. Splice the templates. Apply
+  variants from the spec. Do NOT hand-write `.css` from
+  scratch.
+- **Director**: when the user explicitly requests an override
+  ("use shadcn"), invokes `yujin.design.override` instead of
+  silently accepting. The R8 modal confirms.