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

package/dist/commands/director.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `yf director <spec>` (Director closure pendiente 2).
+ *
+ * Single-entry CLI that combines:
+ *   1. Spec ingest (read file -> recordIngest).
+ *   2. Director dispatch (via runAgent + factory or stub).
+ *
+ * Without --real: ingests + reports doc_id (smoke).
+ * With --real: also dispatches the live LLM step.
+ *
+ * Supported file formats: txt + md as plain UTF-8. Other formats
+ * (pdf, docx) follow-up via the reader registry.
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+import { type StepFn } from '../agents/runner.js';
+import type { AgentDefinition } from '../agents/types.js';
+import { type Runtime } from '../agents/runtime.js';
+export interface RegisterDirectorCommandDeps {
+    makeRealStep?: (opts: {
+        def: AgentDefinition;
+        trigger_reason: string;
+        project_root: string;
+        project_name: string;
+        forge_version: string;
+        /** Yuemail-dogfood fix #7: pass a Runtime so the Director's
+         *  yujin.agent.delegate calls reach delegateToAgent + dispatch
+         *  the target agent. Without this, the delegate callback in
+         *  real_step_factory.ts stays undefined and every delegate
+         *  invocation falls back to runNac3Invoke, which has no
+         *  handler for agent.delegate and returns err. */
+        runtime?: Runtime;
+    }) => Promise<StepFn>;
+}
+export declare function registerDirectorCommand(program: Command, deps?: RegisterDirectorCommandDeps): void;
+//# sourceMappingURL=director.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"director.d.ts","sourceRoot":"","sources":["../../src/commands/director.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE,MAAM,WAAW,2BAA2B;IAC1C,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;QACvB;;;;;0DAKkD;QAClD,OAAO,CAAC,EAAQ,OAAO,CAAC;KACzB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvB;AAsED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,2BAAgC,GAAG,IAAI,CAgNtG"}

package/dist/commands/director.js

@@ -0,0 +1,290 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { getAgentDefinition } from '../agents/store.js';
+import { runAgent } from '../agents/runner.js';
+import { recordIngest } from '../chat/ingest_session.js';
+import { createRuntime } from '../agents/runtime.js';
+function fileExtToFormat(filename) {
+    const ext = path.extname(filename).toLowerCase();
+    if (ext === '.md' || ext === '.markdown')
+        return 'markdown';
+    if (ext === '.txt')
+        return 'markdown'; /* parse as markdown */
+    if (ext === '.pdf')
+        return 'pdf';
+    if (ext === '.docx')
+        return 'docx';
+    return 'markdown'; /* best-effort default */
+}
+function buildDocFromText(filename, text) {
+    /* deterministic doc_id from file content -- 8-char sha1 hex slug. */
+    const hash = crypto.createHash('sha1').update(filename + ':' + text).digest('hex').slice(0, 12);
+    const slug = path.basename(filename).replace(/[^a-zA-Z0-9._-]/g, '-').slice(0, 60);
+    const id = slug + '-' + hash;
+    /* Split into sections per top-level heading. Fallback: one
+     * section with the whole text as a single paragraph block. */
+    const lines = text.split(/\r?\n/);
+    const sections = [];
+    let curHeading = '';
+    let curLevel = 0;
+    let curBlocks = [];
+    let sectionIdx = 0;
+    function flush() {
+        if (curBlocks.length === 0 && !curHeading)
+            return;
+        sections.push({
+            id: 'sec-' + sectionIdx,
+            heading: curHeading,
+            level: curLevel,
+            blocks: curBlocks.length > 0
+                ? curBlocks.map((b) => ({ kind: 'paragraph', text: b }))
+                : [],
+        });
+        sectionIdx += 1;
+        curHeading = '';
+        curLevel = 0;
+        curBlocks = [];
+    }
+    for (const l of lines) {
+        const m = /^(#{1,6})\s+(.+)$/.exec(l.trim());
+        if (m) {
+            flush();
+            curHeading = m[2].trim();
+            curLevel = m[1].length;
+            continue;
+        }
+        if (l.trim().length > 0) {
+            curBlocks.push(l.trim());
+        }
+        else if (curBlocks.length > 0) {
+            /* blank line -> next paragraph boundary; leave for next non-blank. */
+        }
+    }
+    flush();
+    if (sections.length === 0) {
+        sections.push({
+            id: 'sec-0', heading: '', level: 0,
+            blocks: [{ kind: 'paragraph', text }],
+        });
+    }
+    return {
+        id,
+        filename: path.basename(filename),
+        format: fileExtToFormat(filename),
+        bytes: Buffer.byteLength(text, 'utf-8'),
+        title: sections[0].heading || path.basename(filename),
+        sections,
+    };
+}
+export function registerDirectorCommand(program, deps = {}) {
+    program.command('director')
+        .description('Single-entry orchestrator: ingest a spec + dispatch the Director. Default is a smoke run (ingest only). Pass --real to fire the live LLM step.')
+        .argument('<spec>', 'path to a spec file (.md / .txt; pdf/docx follow-up)')
+        .option('--reason <r>', 'override the auto-generated trigger reason')
+        .option('--real', 'use the real LLM step (slice 15e factory) -- requires anthropic_api_key')
+        .option('--json', 'emit JSON instead of human-readable summary')
+        .action(async (specPath, opts) => {
+        /* Step 1: read + ingest the spec. */
+        let text;
+        try {
+            text = await fs.readFile(path.resolve(specPath), 'utf-8');
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error('Failed to read spec at ' + JSON.stringify(specPath) + ': ' + msg);
+            process.exitCode = 1;
+            return;
+        }
+        const doc = buildDocFromText(specPath, text);
+        const session = recordIngest(doc);
+        /* Yuemail-dogfood fix #17: include the spec content in the
+         *  Director's trigger_reason so the LLM has the actual
+         *  requirements in its first turn. Without this, the
+         *  Director only sees "spec doc_id=..." + the CLI --reason
+         *  flag and starts asking the operator for a spec instead
+         *  of delegating. The doc_id reference is kept in the
+         *  header so the Director can quote it when delegating. */
+        const userReason = opts.reason || '';
+        const triggerReason = '## Task: orchestrate the implementation of the following spec.\n'
+            + (userReason ? ('Operator note: ' + userReason + '\n\n') : '\n')
+            + 'Spec doc_id: ' + session.doc_id + '\n'
+            + 'Spec path: ' + specPath + '\n\n'
+            + '--- BEGIN SPEC ---\n'
+            + text
+            + '\n--- END SPEC ---\n\n'
+            + 'Per your YUEMAIL-DOGFOOD MANDATE: your first tool call MUST be '
+            + 'yujin.agent.delegate({to_slug:"analyst", payload:<the spec above + "extract structured plan + tdd_first flag">, tokens_used:<n>}). '
+            + 'Do NOT ask the operator for a spec -- it is included verbatim above.';
+        /* Step 2: ensure the Director is registered. */
+        const def = await getAgentDefinition('director');
+        if (!def) {
+            console.error('Director agent is not installed. Run `yf agent install --defaults` first.');
+            process.exitCode = 1;
+            return;
+        }
+        /* Step 3: dispatch the Director. */
+        let stepFn;
+        let runtimeForDelegate;
+        if (opts.real) {
+            /* Yuemail-dogfood fix #7 + #12 + #13: construct a
+             *  Runtime up-front so yujin.agent.delegate has a
+             *  dispatcher to call. The default runner adapter inside
+             *  runtime.ts passes (slug, reason) to runAgent, which
+             *  expects (def, opts) -- so sub-agents end up running
+             *  with a broken adapter, the run fails immediately, and
+             *  the Director sees ok=false from the delegate.
+             *
+             *  Fix #12: inject a runner that, given a slug, loads
+             *  the agent definition + builds a real LLM step via
+             *  makeRealStep + runs the agent through runAgent with
+             *  the correct shape. This is what makes a delegated
+             *  Analyst / Coder / Tester / Scaffolder run with the
+             *  actual Claude API instead of a no-op stub.
+             *
+             *  Fix #13: actually CALL start() on the runtime. The
+             *  initial Fix #7 comment said "no start() needed for
+             *  one-shot CLI" which was wrong: runtime.ts:325 and
+             *  :413 throw "runtime not started -- call start() first"
+             *  inside dispatchAgent + dispatchAgentSoft if running is
+             *  false. Without start(), every delegate raises that
+             *  error and the Director falls back to inline. */
+            const projectCwd = process.cwd();
+            runtimeForDelegate = createRuntime({
+                runner: async (subSlug, subReason) => {
+                    const subDef = await getAgentDefinition(subSlug);
+                    if (!subDef) {
+                        throw new Error('delegate target agent not installed: ' + subSlug);
+                    }
+                    const { makeRealStep } = await import('../agents/cli_real.js');
+                    const subStep = await makeRealStep({
+                        def: subDef,
+                        trigger_reason: subReason,
+                        project_root: projectCwd,
+                        project_name: 'Director CLI (delegate)',
+                        forge_version: 'cli',
+                        /* The sub-agent does not own a sub-runtime; it
+                         *  is a leaf in this dispatch path. If a sub-
+                         *  agent itself invokes agent.delegate, that
+                         *  call will go through runtime.dispatchAgent
+                         *  on the SAME runtime instance -- so the
+                         *  director's runtime is sufficient for the
+                         *  whole tree. */
+                        runtime: runtimeForDelegate,
+                    });
+                    const { runAgent } = await import('../agents/runner.js');
+                    return runAgent(subDef, {
+                        trigger_kind: 'manual',
+                        trigger_reason: subReason,
+                        step: subStep,
+                        persist: true,
+                        /* Cap sub-agents at 20 iterations -- same as the
+                         *  Director itself. Prevents a single delegated
+                         *  worker from runawaying the budget. */
+                        max_iterations: 50,
+                    });
+                },
+            });
+            /* Yuemail-dogfood fix #13: start the runtime BEFORE the
+             *  director step is built. runtime.ts gates dispatchAgent
+             *  on `running` and throws "runtime not started" if it
+             *  is invoked before start(). The dispatch loop is on a
+             *  setTimeout that unrefs itself, so node will still
+             *  exit cleanly when stop() is called at the end. */
+            runtimeForDelegate.start();
+            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,
+                    ...(args.runtime ? { runtime: args.runtime } : {}),
+                    /* Yuemail-dogfood fix #18: 8192 cap for the Director.
+                     *  The spec inlined in trigger_reason (~9 KB) + graph
+                     *  snapshot + R-strict mandate + system prompt easily
+                     *  burn the 4096 default on a single turn of textual
+                     *  acknowledgement before the LLM emits its first
+                     *  tool_use block. Sub-agents stay at the default. */
+                    max_tokens: 8192,
+                });
+            });
+            try {
+                stepFn = await builder({
+                    def, trigger_reason: triggerReason,
+                    project_root: process.cwd(), project_name: 'Director CLI', forge_version: 'cli',
+                    ...(runtimeForDelegate ? { runtime: runtimeForDelegate } : {}),
+                });
+            }
+            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 {
+            stepFn = async () => ({
+                text: 'cli stub: ingest of "' + session.doc_id + '" recorded. Pass --real to dispatch Claude.',
+                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: true,
+            /* alpha.59z.156 E2E lesson -- the runner default
+             * max_iterations=100 lets a chatty Director burn ~200k
+             * tokens / >$5 before any human notices. Cap at 20 for
+             * the CLI single-entry path; users running through the
+             * panel keep the original 100 via runtime.dispatchAgent
+             * which doesn't override this.
+             *
+             * Yuemail-dogfood fix #19: cap raised from 20 -> 40.
+             * Sprint #10 exit-2'd at iter 20 with 27 tool calls and
+             * an in-flight scaffolder roundtrip. A full TDD cycle
+             * needs ~5 delegates per slice (analyst once + 3 slices
+             * x [coder, scaffolder, tester]) so 20 is a hair short.
+             * 40 still bounds blast radius -- at ~$0.4/iter via fix
+             * #20 loop discipline, max sprint cost is ~$16. */
+            max_iterations: 40,
+        });
+        if (opts.json) {
+            console.log(JSON.stringify({ doc_id: session.doc_id, run }, null, 2));
+            process.exitCode = run.status === 'succeeded' ? 0 : 2;
+            return;
+        }
+        console.log('Spec ingested:');
+        console.log('  Doc ID:       ' + session.doc_id);
+        console.log('  Title:        ' + doc.title);
+        console.log('  Sections:     ' + doc.sections.length);
+        console.log('  Bytes:        ' + doc.bytes);
+        console.log('');
+        console.log('Director run:');
+        console.log('  Run ID:       ' + run.id);
+        console.log('  Status:       ' + run.status + (run.kill_reason ? ' (' + run.kill_reason + ')' : ''));
+        console.log('  Trigger:      ' + run.trigger_reason);
+        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('  Last reply:   ' + run.last_reply_summary);
+        }
+        /* Yuemail-dogfood fix #13: stop the runtime we started so
+         *  node can exit cleanly without waiting for the (unref'd)
+         *  tick timer to drain. Best-effort -- never throw. */
+        if (runtimeForDelegate) {
+            try {
+                await runtimeForDelegate.stop();
+            }
+            catch { /* ignore */ }
+        }
+        process.exitCode = run.status === 'succeeded' ? 0 : 2;
+    });
+}
+//# sourceMappingURL=director.js.map

package/dist/commands/director.js.map

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

package/dist/core/pilot_setup.d.ts

@@ -1,9 +1,22 @@
+export declare function detectExistingProject(projectRoot: string): Promise<boolean>;
 export interface PilotSetupState {
     pilot_completed: boolean;
     target_pending: boolean;
     mode_pending: boolean;
 }
-/** Read the current pilot setup state. */
+/** Read the current pilot setup state.
+ *
+ *  Three branches:
+ *  1. `yujin.forge.json` exists -> trust the persisted `pilot_completed`.
+ *  2. No `yujin.forge.json`, but workspace IS an existing project (has
+ *     `package.json`/`Cargo.toml`/etc) -> auto-skip warmup
+ *     (`pilot_completed: true`). The user is opening Forge against a
+ *     real codebase and wants Forge to start by discovering it, not
+ *     by asking target/mode.
+ *  3. No `yujin.forge.json` and workspace is empty / greenfield ->
+ *     trigger the warmup prompt (`pilot_completed: false`). This is
+ *     the `yf new` path.
+ */
 export declare function readPilotState(projectRoot: string): Promise<PilotSetupState>;
 /** Mark Pilot setup as completed (also bumps the persisted
  *  yujin.forge.json with default values if any are missing). */

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

@@ -1 +1 @@
-{"version":3,"file":"pilot_setup.d.ts","sourceRoot":"","sources":["../../src/core/pilot_setup.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAG,OAAO,CAAC;IACzB,YAAY,EAAK,OAAO,CAAC;CAC1B;AAED,0CAA0C;AAC1C,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAgBlF;AAED;gEACgE;AAChE,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;gCAEgC;AAChC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAqBlE;AAED;;;;;;2DAM2D;AAC3D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,MAAM,GAClB;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAAA;CAAE,CAkBrE"}
+{"version":3,"file":"pilot_setup.d.ts","sourceRoot":"","sources":["../../src/core/pilot_setup.ts"],"names":[],"mappings":"AAyDA,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUjF;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAG,OAAO,CAAC;IACzB,YAAY,EAAK,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAqBlF;AAED;gEACgE;AAChE,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;gCAEgC;AAChC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAqBlE;AAED;;;;;;2DAM2D;AAC3D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,MAAM,GAClB;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAAA;CAAE,CAkBrE"}

package/dist/core/pilot_setup.js

@@ -20,7 +20,63 @@
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 const CONFIG = 'yujin.forge.json';
-/** Read the current pilot setup state. */
+/** Heuristic: detect whether `projectRoot` already contains an
+ *  existing project. If it does, we skip the first-run Pilot setup
+ *  (target/mode questions) because they are not relevant when the
+ *  user is opening Forge against an existing codebase (bug fix,
+ *  refactor, deploy, code review, doc gen, etc).
+ *
+ *  An "existing project" is detected by the presence of ANY of the
+ *  common dependency manifest files. Greenfield workspaces (empty
+ *  dir or just a prompt.txt) do NOT match, so they still get the
+ *  pilot setup -- preserving the F-series default for `yf new`.
+ *
+ *  Added 2026-06-06 after the behavior-matrix run revealed that
+ *  cloned existing repos were being misclassified as greenfield and
+ *  intercepted by the warmup template, yielding "warmup-only" turns
+ *  where Forge promised to read the codebase but only asked the two
+ *  questions instead. */
+const PROJECT_INDICATORS = [
+    'package.json',
+    'pyproject.toml',
+    'requirements.txt',
+    'Cargo.toml',
+    'go.mod',
+    'composer.json',
+    'Gemfile',
+    'mix.exs',
+    'pom.xml',
+    'build.gradle',
+    'build.gradle.kts',
+    'CMakeLists.txt',
+    'Makefile',
+    'pubspec.yaml',
+];
+export async function detectExistingProject(projectRoot) {
+    for (const indicator of PROJECT_INDICATORS) {
+        try {
+            await fs.access(path.join(projectRoot, indicator));
+            return true;
+        }
+        catch {
+            /* try next */
+        }
+    }
+    return false;
+}
+/** Read the current pilot setup state.
+ *
+ *  Three branches:
+ *  1. `yujin.forge.json` exists -> trust the persisted `pilot_completed`.
+ *  2. No `yujin.forge.json`, but workspace IS an existing project (has
+ *     `package.json`/`Cargo.toml`/etc) -> auto-skip warmup
+ *     (`pilot_completed: true`). The user is opening Forge against a
+ *     real codebase and wants Forge to start by discovering it, not
+ *     by asking target/mode.
+ *  3. No `yujin.forge.json` and workspace is empty / greenfield ->
+ *     trigger the warmup prompt (`pilot_completed: false`). This is
+ *     the `yf new` path.
+ */
 export async function readPilotState(projectRoot) {
     try {
         const raw = await fs.readFile(path.join(projectRoot, CONFIG), 'utf-8');
@@ -36,6 +92,11 @@ export async function readPilotState(projectRoot) {
         };
     }
     catch {
+        /* No config file. Decide between greenfield and existing-project. */
+        const existing = await detectExistingProject(projectRoot);
+        if (existing) {
+            return { pilot_completed: true, target_pending: false, mode_pending: false };
+        }
         return { pilot_completed: false, target_pending: true, mode_pending: true };
     }
 }

package/dist/core/pilot_setup.js.map

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

package/dist/design/yujin_design_resolver.d.ts

@@ -0,0 +1,77 @@
+export interface DesignManifest {
+    name: string;
+    version: string;
+    description: string;
+    tokens: {
+        file: string;
+        format: string;
+        css: string;
+        count: number;
+    };
+    components: {
+        dir: string;
+        index: string;
+        count: number;
+        format: string;
+    };
+    icons: {
+        sumie: {
+            dir: string;
+            index: string;
+            count: number;
+            format: string;
+            tags: string[];
+        };
+        kanji: {
+            wordmarks: Record<string, string>;
+            single_chars: Record<string, string>;
+        };
+    };
+    fonts: {
+        primary: {
+            family: string;
+            source: string;
+            url: string;
+        };
+        japanese: {
+            family: string;
+            source: string;
+            url: string;
+        };
+        monospace: {
+            family: string;
+            source: string;
+            url: string;
+        };
+        policy: string;
+    };
+}
+export interface ComponentTemplate {
+    slug: string;
+    category: string;
+    nac3_id: string;
+    description: string;
+    html: string;
+    css: string;
+    variants: string[];
+    props: string[];
+    token_refs: string[];
+    sumie_icon_hint: string | null;
+}
+export interface SumieIcon {
+    slug: string;
+    tags: string[];
+    file: string;
+}
+export interface ResolverOpts {
+    /** Override the package root for tests. */
+    dir?: string;
+}
+export declare function getManifest(opts?: ResolverOpts): Promise<DesignManifest | null>;
+export declare function listTemplates(opts?: ResolverOpts): Promise<ComponentTemplate[]>;
+export declare function getTemplate(slug: string, opts?: ResolverOpts): Promise<ComponentTemplate | null>;
+export declare function getTokens(opts?: ResolverOpts): Promise<unknown | null>;
+export declare function listSumie(filterTag: string | null, opts?: ResolverOpts): Promise<SumieIcon[]>;
+export declare function getSumieSvg(slug: string, opts?: ResolverOpts): Promise<string | null>;
+export declare function _resetDesignCacheForTests(): void;
+//# sourceMappingURL=yujin_design_resolver.d.ts.map

package/dist/design/yujin_design_resolver.d.ts.map

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