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

package/dist/docs/doctrine/testing-policy.md

@@ -0,0 +1,211 @@
+# Testing policy (Forge product principle)
+
+**Lock date:** 2026-06-04. Replaces the earlier draft
+`tdd-first.md` which proposed TDD-first universally.
+
+Pablo's review: TDD-first as a universal product principle has
+more downsides than upsides. The cost is real (tokens, latency,
+arquitectural lock-in, frustrated UX, ambiguous specs) and only
+pays off in a narrow slice (backends + middleware + finance +
+regulatory + external integrations). For the majority of Forge
+projects (UI / dashboards / CRUDs / demos / glue), TDD-first
+slows down iteration without adding value.
+
+This doctrine sets the new rule.
+
+## The rule
+
+1. **Tests are required POST-implementation for every change**
+   that lands in a Forge-managed project. The default order is:
+   spec -> code -> tests -> scaffold-with-gate.
+2. **TDD-first is opt-in**, not default. It applies when the
+   slice falls into the **TDD-first scope** (see below).
+3. **The scaffold gate** requires the test suite to be green
+   before writing to disk, regardless of order. The order
+   determines WHEN tests are authored, not whether they exist.
+
+## TDD-first scope (the narrow slice)
+
+Only these domains warrant test-first:
+
+- **APIs / backend endpoints with public contract**. The
+  request/response shape is the most stable thing about the
+  feature; the implementation will rewrite.
+- **Data transformers / validators / parsers** where input
+  -> output is the whole point.
+- **Financial / regulatory / mathematical logic** (tax calc,
+  retention, currency conversion, legal rules). The test
+  is the spec.
+- **External-service integrations** (Stripe webhook, Polar,
+  OAuth, NAC bridges to MCP). Tests capture "this payload
+  produces this effect" which is the only stable contract
+  when the provider changes internals.
+
+The Analyst marks the spec extraction with `tdd_first: true`
+when:
+
+- The plan contains `endpoints` AND no `components`.
+- OR any extraction tag matches /financial|tax|regulatory|
+  integration|webhook|validator|transformer/i.
+- OR the user explicitly passes `--tdd` to `yf spec extract`.
+
+When `tdd_first: false` (default), the Tester slot runs AFTER
+the Coder. When true, the Tester slot runs BEFORE the Coder.
+
+## TDD-first explicitly NOT for
+
+- UI / frontend / drag-drop / animations / layout.
+- Glue code / scripts / one-off transforms.
+- Demos / prototypes / spikes (always `--mode=spike`).
+- Stateful interactive surfaces (games, audio, sensor).
+- Generated code from templates (Next.js scaffolds, etc.) --
+  the template has its own tests; user-added features follow
+  the default order.
+
+Trying to TDD any of the above is fiction-writing. The tests
+end up tautological (matching implementation) or vacuous
+(asserting things that are trivially true). Forge will not
+force users into that.
+
+## Order of the 5 Director agents (canonical)
+
+The Tester is NOT a single-shot slot -- it is re-entrant. It
+runs at every checkpoint where the suite needs to be authored
+or verified. In TDD-first, that's twice. In code-first, that's
+once. The diagram below names the runs explicitly.
+
+### TDD-first mode (Analyst tags `tdd_first: true`)
+
+```
+Director (orchestrator)
+  |
+  v
+Analyst   -- extract spec + tag tdd_first=true
+  |
+  v
+Tester #1 -- write the test suite (RED). Suite fails because
+             no code exists yet.
+  |
+  v
+Coder     -- implement until the suite turns green. Iterates
+             with the brain until red->green or max iter cap.
+  |
+  v
+Tester #2 -- verify green + add edge-case pass (3 boundary
+             tests). If any test still red after edge pass,
+             back to Coder (capped by max iter).
+  |
+  v
+Scaffolder -- apply to disk ONLY when Tester #2 reports
+              all-green (happy + edge cases).
+```
+
+### Code-first mode (Analyst tags `tdd_first: false`, the default)
+
+```
+Director (orchestrator)
+  |
+  v
+Analyst   -- extract spec + tag tdd_first=false
+  |
+  v
+Coder     -- implement straight from the plan.
+  |
+  v
+Tester    -- write the test suite POST-implementation +
+             verify green + edge-case pass.
+  |
+  v
+Scaffolder -- apply to disk ONLY when Tester reports
+              all-green.
+```
+
+In both modes, the **last Tester pass before Scaffolder is the
+hard gate**. The flag `tdd_first` decides whether there is also
+a FIRST Tester pass that writes red. The Scaffolder gate
+(green-required) is identical in both modes.
+
+The bridge ACL stays the same regardless of mode:
+`Director.can_call = [Analyst, Tester, Coder, Scaffolder]`
+and each worker accepts only from Director. Mode is encoded
+in the messages, not in the topology.
+
+## The scaffold gate (regardless of order)
+
+`Scaffolder` refuses to write to disk when:
+
+- The Tester report does not exist for the slice.
+- Any test in the new suite is red.
+
+The gate is enforced in `src/chat/spec_scaffold.ts`. Test
+runner auto-detected from `package.json` / `pyproject.toml` /
+etc.
+
+## Loop protection (when iterating to green)
+
+If the Coder iterates more than `agent.director.max_iters_to_green`
+times (default 5) without turning the test suite green, the
+agent stops and reports the failure to the Director, which
+opens an R8 modal with three options for the user:
+
+1. Mark suite as accepted-red (the user knows the tests are
+   wrong; accept the implementation as-is). Audit-logged.
+2. Re-extract spec (back to Analyst with clarification).
+3. Cancel the slice.
+
+This is the answer to "what does the agent do when it cannot
+turn red into green". No silent application. No infinite
+iteration.
+
+## Mitigations against test pathologies
+
+Even POST-implementation testing can produce bad suites if
+left to the Tester LLM alone. Required mitigations:
+
+- **Contract framing in Tester system prompt**: the prompt
+  explicitly says "tests assert CONTRACT (input -> output,
+  effect on world), NOT implementation. Internal refactors
+  should not break a well-written test."
+- **Edge-case pass**: after the happy-path tests are green,
+  the Tester runs a second pass generating 3 edge cases
+  (nulls, empty, boundary, error). Adds them to the suite.
+  Coder iterates again.
+- **No mocking-of-self**: tests cannot mock the function
+  they are testing. Mocking external deps (network, fs) is
+  allowed.
+- **Tester report includes coverage line + branch %.**
+  Below configurable threshold (default 80% line, 70%
+  branch) is logged as a warning, not a block.
+
+## What this doctrine covers + does NOT cover
+
+This doctrine covers **functional correctness via tests**.
+It does NOT cover:
+
+- **UX quality** -- panel review, manual walkthroughs.
+- **Accessibility** -- separate doctrine `accessibility.md`
+  + `yujin.a11y.*` verbs.
+- **Performance** -- separate (future doctrine, not blocking).
+- **Security** -- separate.
+- **Design / aesthetic** -- not testable by code.
+
+"100% E2E tests passed" in the Director objective means
+"functional contract passes". Other quality dimensions are
+gated separately or via human review.
+
+## How Sumi enforces this on Forge itself (dogfood)
+
+Sumi-self ships every Forge slice with tests. The order
+follows the same rule:
+
+- Backend / middleware / integration slice -> TDD-first
+  (test then code). The bridge.ts slice was this kind, and
+  the bug found by the test is the evidence the order paid
+  off there.
+- UI / panel / cosmetic slice -> code-first then test. The
+  legal modal opacity fix, the audit log preview, the
+  Limites alignment -- all of these were code-first because
+  the shape was visual and exploratory.
+
+Sumi decides the order per slice. The graph rule #12 reflects
+this.

package/dist/nac3/approval_queue.d.ts

@@ -13,6 +13,14 @@ export interface PendingApproval {
      *  re-enter runNac3Invoke / runForgeTool from the endpoint. */
     legacy_run: (n: string, a: Record<string, unknown>, c: ToolContext) => Promise<ToolResult>;
     created_at: number;
+    /** Director sprint -- when the approval was emitted by an agent
+     *  via the nac3_invoke path inside an iterative step, the bridge
+     *  carries the agent slug here so the eventual approve/reject
+     *  endpoint can fire a `agent_run_paused_resolved` SSE event +
+     *  the panel SVG can clear the amber dashed marker. Optional
+     *  because chat-side approvals (sidebar voice / human dispatch
+     *  directo) do NOT carry an agent slug. */
+    agent_slug?: string;
 }
 /** Push a pending approval and return the trace_id. */
 export declare function enqueueApproval(p: PendingApproval): void;

package/dist/nac3/approval_queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approval_queue.d.ts","sourceRoot":"","sources":["../../src/nac3/approval_queue.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,EAAE,WAAW,CAAC;IACjB;;gCAE4B;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;mEAC+D;IAC/D,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3F,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAGxD;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CASnE;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAQpE;AAED,2BAA2B;AAC3B,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AA0BD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxE"}
+{"version":3,"file":"approval_queue.d.ts","sourceRoot":"","sources":["../../src/nac3/approval_queue.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,EAAE,WAAW,CAAC;IACjB;;gCAE4B;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;mEAC+D;IAC/D,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3F,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;+CAM2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAGxD;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CASnE;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAQpE;AAED,2BAA2B;AAC3B,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AA0BD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxE"}

package/dist/nac3/approval_queue.js.map

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

package/dist/nac3/internal_manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal_manifest.d.ts","sourceRoot":"","sources":["../../src/nac3/internal_manifest.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,SAAS,GACT,mBAAmB,GACnB,aAAa,GACb,eAAe,GACf,oBAAoB,CAAC;AAEzB,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,KAAK,GACL,YAAY,GACZ,SAAS,GACT,SAAS,GACT,cAAc,GACd,KAAK,CAAC;AAEV,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;QAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB;;;4BAGwB;IACxB,YAAY,EAAE,OAAO,GAAG,QAAQ,CAAC;IACjC;;;;;;qCAMiC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AA6xDD,wBAAgB,QAAQ,IAAI,YAAY,CAOvC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAGzD;AAED;gEACgE;AAChE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAO9D;AAED;;;uDAGuD;AACvD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAgCzF;AAED;;sEAEsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,MAAM,EAAE,CAO/D"}
+{"version":3,"file":"internal_manifest.d.ts","sourceRoot":"","sources":["../../src/nac3/internal_manifest.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,SAAS,GACT,mBAAmB,GACnB,aAAa,GACb,eAAe,GACf,oBAAoB,CAAC;AAEzB,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,KAAK,GACL,YAAY,GACZ,SAAS,GACT,SAAS,GACT,cAAc,GACd,KAAK,CAAC;AAEV,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;QAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB;;;4BAGwB;IACxB,YAAY,EAAE,OAAO,GAAG,QAAQ,CAAC;IACjC;;;;;;qCAMiC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAw9DD,wBAAgB,QAAQ,IAAI,YAAY,CAOvC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAGzD;AAED;gEACgE;AAChE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAO9D;AAED;;;uDAGuD;AACvD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAgCzF;AAED;;sEAEsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,MAAM,EAAE,CAO/D"}

package/dist/nac3/internal_manifest.js

@@ -1538,6 +1538,32 @@ const VERBS = [
         visible: false,
         handler_side: 'server',
     },
+    {
+        id: 'office.excel.update-cell',
+        role: 'action',
+        action: 'update_cell',
+        label: 'Actualizar una celda en un Excel',
+        description: 'Mutate ONE cell in an existing .xlsx / .xls workbook without '
+            + 'rewriting the rest of the file. Use this when the user '
+            + 'wants to fix a single value (e.g. "set B2 of Sheet1 to '
+            + '500") -- otherwise office.excel.write replaces the entire '
+            + 'workbook. The cell address follows A1 notation; the sheet '
+            + 'defaults to the first sheet. CSV not supported (use write).',
+        schema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Existing workbook path (xlsx or xls).', minLength: 1, maxLength: 500 },
+                sheet: { type: 'string', description: 'Sheet name. Default first sheet.', maxLength: 100 },
+                cell: { type: 'string', description: 'A1-notation address (e.g. "B2", "AA10").', minLength: 2, maxLength: 10 },
+                value: { type: 'string', description: 'New cell value -- string / number / boolean / null are all accepted at the dispatcher level (the JSON-schema "type:string" here is the manifest-stub minimum; the handler discriminates the JS type at runtime).' },
+            },
+            required: ['path', 'cell'],
+        },
+        policy: 'project-root-gated',
+        side_effects: ['filesystem'],
+        visible: false,
+        handler_side: 'server',
+    },
     {
         id: 'office.excel.append-sheet',
         role: 'action',
@@ -1722,6 +1748,158 @@ const VERBS = [
         visible: false,
         handler_side: 'panel',
     },
+    /* ============================================================
+     * YUJIN DESIGN SYSTEM (Director sprint phase II slice 12)
+     *
+     * Six verbs that surface the default front-end design system
+     * to the Coder + Analyst + Director. The package lives in
+     * yujin-design-system/ at the repo root; the resolver in
+     * src/design/yujin_design_resolver.ts provides the data.
+     *
+     * See docs/doctrine/default-design-system.md for the rule
+     * (Yujin DS is the Forge default; override via R8 modal).
+     * ============================================================ */
+    {
+        id: 'yujin.design.list-templates',
+        role: 'query',
+        action: 'list_templates',
+        label: 'Listar componentes del Yujin Design System',
+        description: 'Return the catalog of Yujin Design System components '
+            + '(card, modal, sidebar, view, button, input, form-field, '
+            + 'table, kanban-card, ...). 30 components grouped by '
+            + 'category (surface / control / display / data). Use '
+            + 'before writing ANY UI so you splice the Yujin template '
+            + 'instead of hand-rolling.',
+        schema: { type: 'object', properties: {}, required: [] },
+        policy: 'unrestricted',
+        side_effects: ['none'],
+        visible: false,
+        handler_side: 'server',
+    },
+    {
+        id: 'yujin.design.get-template',
+        role: 'query',
+        action: 'get_template',
+        label: 'Traer un componente del Yujin DS',
+        description: 'Return one component template: { slug, category, '
+            + 'nac3_id, html, css, variants, props, token_refs }. The '
+            + 'html carries NAC-3 attrs; the css uses --tokens only.',
+        schema: {
+            type: 'object',
+            properties: {
+                slug: { type: 'string', description: 'Component slug, e.g. "card", "modal", "button".', minLength: 1, maxLength: 40 },
+            },
+            required: ['slug'],
+        },
+        policy: 'unrestricted',
+        side_effects: ['none'],
+        visible: false,
+        handler_side: 'server',
+    },
+    {
+        id: 'yujin.design.list-sumie',
+        role: 'query',
+        action: 'list_sumie',
+        label: 'Listar iconos sumi-e disponibles',
+        description: 'Return the catalog of 170 sumi-e icons. Optional `tag` '
+            + 'filter (nature, finance, sales, support, manufacturing, '
+            + 'quality, hr, marketing, platform, ai, mobile, comms, '
+            + 'document, geo, weather, animal, etc).',
+        schema: {
+            type: 'object',
+            properties: {
+                tag: { type: 'string', description: 'Optional domain tag filter.', maxLength: 30 },
+            },
+            required: [],
+        },
+        policy: 'unrestricted',
+        side_effects: ['none'],
+        visible: false,
+        handler_side: 'server',
+    },
+    {
+        id: 'yujin.design.get-icon',
+        role: 'query',
+        action: 'get_icon',
+        label: 'Traer un icono sumi-e por slug',
+        description: 'Return the inline SVG (40x40, stroke=currentColor) for '
+            + 'the sumi-e icon identified by slug. Use only icons from '
+            + 'this catalog; do NOT import third-party icon libraries.',
+        schema: {
+            type: 'object',
+            properties: {
+                slug: { type: 'string', description: 'Sumi-e icon slug.', minLength: 1, maxLength: 40 },
+            },
+            required: ['slug'],
+        },
+        policy: 'unrestricted',
+        side_effects: ['none'],
+        visible: false,
+        handler_side: 'server',
+    },
+    {
+        id: 'yujin.design.tokens',
+        role: 'query',
+        action: 'tokens',
+        label: 'Traer los tokens DTCG del Yujin DS',
+        description: 'Return the full DTCG W3C tokens.json tree (colors, '
+            + 'typography, spacing, radius, shadow). Use to reference '
+            + '--color-* / --font-* / --space-* in CSS; do NOT '
+            + 'hardcode hex / px / font names.',
+        schema: { type: 'object', properties: {}, required: [] },
+        policy: 'unrestricted',
+        side_effects: ['none'],
+        visible: false,
+        handler_side: 'server',
+    },
+    {
+        id: 'yujin.agent.delegate',
+        role: 'action',
+        action: 'delegate_to_agent',
+        label: 'Delegar trabajo a otro agente via bridge',
+        description: 'Director sprint slice 15d. Send a payload to another '
+            + 'agent (must be in your can_call whitelist) via the '
+            + 'inter-agent bridge + wait for its run result. The bridge '
+            + 'cap + loop detector apply. Use when you (the agent) need '
+            + 'another role to do something (Director delegates extraction '
+            + 'to Analyst, etc).',
+        schema: {
+            type: 'object',
+            properties: {
+                to_slug: { type: 'string', description: 'Target agent slug (kebab-case).', minLength: 1, maxLength: 60 },
+                payload: { type: 'string', description: 'The work request. Becomes the target trigger_reason.', minLength: 1, maxLength: 4000 },
+                tokens_used: { type: 'number', description: 'Approx tokens spent producing the payload. Used by the bridge cap.' },
+            },
+            required: ['to_slug', 'payload'],
+        },
+        policy: 'unrestricted',
+        side_effects: ['none'],
+        visible: false,
+        handler_side: 'server',
+    },
+    {
+        id: 'yujin.design.override',
+        role: 'action',
+        action: 'override_design_system',
+        label: 'Override del design system default (R8 modal)',
+        description: 'Persist a per-tenant override away from Yujin Design '
+            + 'System. The user must EXPLICITLY ask ("usa shadcn", '
+            + '"use Material"). Opens an R8 modal; on approve, the '
+            + 'override stays in tenant_config.design_override + '
+            + 'subsequent turns honor the new system.',
+        schema: {
+            type: 'object',
+            properties: {
+                system_id: { type: 'string', description: 'Override id, e.g. "shadcn", "material", "tailwind-only".', minLength: 1, maxLength: 60 },
+                reason: { type: 'string', description: 'Why the user wants to override Yujin DS.', minLength: 1, maxLength: 300 },
+            },
+            required: ['system_id', 'reason'],
+        },
+        policy: 'approval-required',
+        side_effects: ['filesystem'],
+        visible: false,
+        handler_side: 'server',
+    },
 ];
 /* ============================================================
  * Public API