@nac3/forge-cli 0.2.0-alpha.1

package/dist/reader/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Document reader subsystem -- type surface.
+ *
+ * The reader takes a document (txt / md / pdf / docx / html / rtf
+ * / epub / csv / xlsx / source code) and exposes a voice-driven
+ * interface to navigate, read aloud, search, recap, and bookmark.
+ *
+ * Pipeline:
+ *   1. detect format -> pick parser.
+ *   2. parser produces a NormalisedDocument (sections + paragraphs
+ *      + non-text blocks like tables / code / images).
+ *   3. ReaderSession holds playback state (position, paused or
+ *      reading, current bookmark) + a rolling 5-minute buffer of
+ *      what was just read for recap.
+ *   4. Chat tools + voice intent routing drive the session.
+ *
+ * Pure types this slice. State machine + registry + parsers
+ * land in the following slices.
+ *
+ * ASCII-only.
+ */
+/** Document format identifiers. Open string union so future
+ *  formats slot in without breaking existing sessions. */
+export type DocFormat = 'txt' | 'md' | 'pdf' | 'docx' | 'html' | 'rtf' | 'epub' | 'csv' | 'xlsx' | 'source' | string;
+/** A leaf chunk of text the reader plays one at a time. */
+export interface TextBlock {
+    kind: 'paragraph' | 'heading' | 'list_item' | 'quote' | 'caption';
+    /** 1-based heading level when kind=heading (otherwise 0). */
+    level: number;
+    /** Plain text contents. */
+    text: string;
+    /** Stable id within the document (assigned by the parser).
+     *  Used for seek + bookmarks. */
+    id: string;
+}
+/** A non-text block the reader announces but does not read by
+ *  default. The user can ask for it explicitly. */
+export interface NonTextBlock {
+    kind: 'table' | 'code' | 'image' | 'figure' | 'formula';
+    /** Stable id. */
+    id: string;
+    /** A human-readable summary the reader speaks when it lands on
+     *  the block, e.g. "tabla con 5 columnas y 12 filas". */
+    summary: string;
+    /** When `kind`='code', the language hint when known. */
+    language?: string;
+    /** Lazy-loaded content the user can request. The parser can
+     *  pre-compute or leave it null and resolve on demand. */
+    content?: string;
+}
+export type Block = TextBlock | NonTextBlock;
+/** Section is a heading + the list of blocks under it. */
+export interface Section {
+    /** Stable id. */
+    id: string;
+    /** Heading text. Empty string when the section has no heading
+     *  (e.g. the top-of-document section). */
+    heading: string;
+    /** 1-based level (1 = h1). 0 when no heading. */
+    level: number;
+    /** All blocks belonging to this section, in document order. */
+    blocks: Block[];
+}
+/** The normalised document a parser returns. */
+export interface NormalisedDocument {
+    /** Path-friendly identifier for the document (slugified
+     *  filename). */
+    id: string;
+    /** Original filename + format. */
+    filename: string;
+    format: DocFormat;
+    /** Total byte count of the source. Informational. */
+    bytes: number;
+    /** Document title. From the format's metadata or the first
+     *  heading. */
+    title: string;
+    /** Author / creator when known. */
+    author?: string;
+    /** Language hint (BCP-47). */
+    language?: string;
+    /** Tree of sections in document order. */
+    sections: Section[];
+}
+/** A single reader session -- one document, one playback state. */
+export interface ReaderSession {
+    doc: NormalisedDocument;
+    /** Current block id under the cursor. The reader plays this
+     *  block next when resumed. */
+    cursor_block_id: string;
+    /** State of playback. */
+    state: 'idle' | 'reading' | 'paused' | 'searching';
+    /** User-set bookmarks keyed by name. */
+    bookmarks: Record<string, string>;
+    /** Last N text blocks already spoken, kept in order. Used by
+     *  the recap tool to re-narrate the recent context. The limit
+     *  is enforced in the playback module. */
+    recent_spoken: string[];
+    /** Playback speed multiplier. 1.0 = normal. */
+    speed: number;
+}
+/** Result of seeking. */
+export interface SeekResult {
+    ok: boolean;
+    /** New cursor block id when ok, else null. */
+    new_cursor: string | null;
+    /** Reason when !ok (voice-readable). */
+    reason?: string;
+}
+/** Search hit. */
+export interface SearchHit {
+    block_id: string;
+    section_id: string;
+    section_heading: string;
+    /** Snippet of the block centered on the match. */
+    snippet: string;
+    /** Character offset of the match within the block. */
+    offset: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/reader/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reader/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;0DAC0D;AAC1D,MAAM,MAAM,SAAS,GACjB,KAAK,GACL,IAAI,GACJ,KAAK,GACL,MAAM,GACN,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,GACN,QAAQ,GACR,MAAM,CAAC;AAEX,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IAClE,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb;qCACiC;IACjC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;mDACmD;AACnD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxD,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX;6DACyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;8DAC0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,KAAK,GAAG,SAAS,GAAG,YAAY,CAAC;AAE7C,0DAA0D;AAC1D,MAAM,WAAW,OAAO;IACtB,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX;8CAC0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC;qBACiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd;mBACe;IACf,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,kBAAkB,CAAC;IACxB;mCAC+B;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IACnD,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;;8CAE0C;IAC1C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yBAAyB;AACzB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,8CAA8C;IAC9C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kBAAkB;AAClB,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/reader/types.js

@@ -0,0 +1,23 @@
+/**
+ * Document reader subsystem -- type surface.
+ *
+ * The reader takes a document (txt / md / pdf / docx / html / rtf
+ * / epub / csv / xlsx / source code) and exposes a voice-driven
+ * interface to navigate, read aloud, search, recap, and bookmark.
+ *
+ * Pipeline:
+ *   1. detect format -> pick parser.
+ *   2. parser produces a NormalisedDocument (sections + paragraphs
+ *      + non-text blocks like tables / code / images).
+ *   3. ReaderSession holds playback state (position, paused or
+ *      reading, current bookmark) + a rolling 5-minute buffer of
+ *      what was just read for recap.
+ *   4. Chat tools + voice intent routing drive the session.
+ *
+ * Pure types this slice. State machine + registry + parsers
+ * land in the following slices.
+ *
+ * ASCII-only.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/reader/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reader/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/ship/run.d.ts

@@ -0,0 +1,26 @@
+export type StepName = 'validate' | 'license' | 'test' | 'build';
+export interface ShipStep {
+    name: StepName;
+    ok: boolean;
+    skipped: boolean;
+    detail: string;
+    /** ms duration of this step. */
+    ms: number;
+}
+export interface ShipResult {
+    steps: ShipStep[];
+    ok: boolean;
+}
+export interface ShipOptions {
+    projectRoot: string;
+    skipTests: boolean;
+    /** Test injection point. Defaults to spawn-based runner. */
+    runProcess?: (cmd: string, args: string[], cwd: string) => Promise<ProcessResult>;
+}
+export interface ProcessResult {
+    code: number;
+    stdoutTail: string;
+    stderrTail: string;
+}
+export declare function runShip(opts: ShipOptions): Promise<ShipResult>;
+//# sourceMappingURL=run.d.ts.map

package/dist/ship/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/ship/run.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAK,QAAQ,CAAC;IAClB,EAAE,EAAO,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAG,MAAM,CAAC;IAChB,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,EAAE,EAAK,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAI,OAAO,CAAC;IACrB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CACnF;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA8DpE"}

package/dist/ship/run.js

@@ -0,0 +1,123 @@
+/**
+ * Yujin Forge -- ship gate runner.
+ *
+ * Coordinates the pre-deploy gate:
+ *   1. validate (--strict) -- structural sanity
+ *   2. license check       -- paid OR trial-active
+ *   3. npm test            -- runs `npm test --silent` in the project
+ *   4. npm run build       -- vite/tsc/etc as the project defines
+ *
+ * Each step yields a ShipStep result. The pipeline stops on the
+ * first failure unless --skip-tests is set (in which case step 3
+ * is skipped but still recorded). The caller (the ship command)
+ * renders results + sets process.exitCode.
+ *
+ * Process execution is delegated to a runner injected as a
+ * parameter so tests can stub child_process without spawning
+ * real processes.
+ */
+import { spawn } from 'node:child_process';
+import { validateProject } from '../validate/index.js';
+import { loadLicense, isAuthorized, isPaidSeat } from '../license/index.js';
+export async function runShip(opts) {
+    const steps = [];
+    const exec = opts.runProcess ?? defaultRunProcess;
+    // 1. validate
+    const t1 = Date.now();
+    const v = await validateProject({ projectRoot: opts.projectRoot, strict: true });
+    steps.push({
+        name: 'validate',
+        ok: v.ok,
+        skipped: false,
+        detail: summariseValidate(v),
+        ms: Date.now() - t1,
+    });
+    if (!v.ok)
+        return { steps, ok: false };
+    // 2. license
+    const t2 = Date.now();
+    const lic = await loadLicense();
+    const licOk = isAuthorized(lic);
+    steps.push({
+        name: 'license',
+        ok: licOk,
+        skipped: false,
+        detail: summariseLicense(lic),
+        ms: Date.now() - t2,
+    });
+    if (!licOk)
+        return { steps, ok: false };
+    // 3. test
+    if (opts.skipTests) {
+        steps.push({
+            name: 'test', ok: true, skipped: true,
+            detail: 'skipped (--skip-tests)',
+            ms: 0,
+        });
+    }
+    else {
+        const t3 = Date.now();
+        const r = await exec('npm', ['test', '--silent'], opts.projectRoot);
+        steps.push({
+            name: 'test',
+            ok: r.code === 0,
+            skipped: false,
+            detail: r.code === 0 ? 'passed' : 'failed: ' + tailLine(r.stderrTail || r.stdoutTail),
+            ms: Date.now() - t3,
+        });
+        if (r.code !== 0)
+            return { steps, ok: false };
+    }
+    // 4. build
+    const t4 = Date.now();
+    const b = await exec('npm', ['run', 'build', '--silent'], opts.projectRoot);
+    steps.push({
+        name: 'build',
+        ok: b.code === 0,
+        skipped: false,
+        detail: b.code === 0 ? 'passed' : 'failed: ' + tailLine(b.stderrTail || b.stdoutTail),
+        ms: Date.now() - t4,
+    });
+    if (b.code !== 0)
+        return { steps, ok: false };
+    return { steps, ok: true };
+}
+function summariseValidate(v) {
+    if (v.ok && v.findings.length === 0)
+        return 'clean';
+    const errs = v.findings.filter((f) => f.severity === 'error').length;
+    const warns = v.findings.filter((f) => f.severity === 'warn').length;
+    return errs + ' error(s), ' + warns + ' warning(s)';
+}
+function summariseLicense(lic) {
+    if (isPaidSeat(lic))
+        return 'paid seat (' + (lic.seat?.email ?? 'machine-bound') + ')';
+    if (lic.status === 'trial' && lic.trial) {
+        return 'trial -- ' + lic.trial.daysLeft + ' day(s) left';
+    }
+    return 'no active license or trial';
+}
+function tailLine(s) {
+    const lines = s.trim().split(/\r?\n/).filter((l) => l.length > 0);
+    return lines[lines.length - 1] ?? '';
+}
+async function defaultRunProcess(cmd, args, cwd) {
+    return new Promise((resolve) => {
+        let stdoutBuf = '';
+        let stderrBuf = '';
+        // shell:true on Windows so 'npm' resolves to npm.cmd. Safe
+        // because cmd + args are not user-supplied here.
+        const child = spawn(cmd, args, { cwd, shell: process.platform === 'win32' });
+        child.stdout?.on('data', (chunk) => { stdoutBuf += String(chunk); if (stdoutBuf.length > 8192)
+            stdoutBuf = stdoutBuf.slice(-8192); });
+        child.stderr?.on('data', (chunk) => { stderrBuf += String(chunk); if (stderrBuf.length > 8192)
+            stderrBuf = stderrBuf.slice(-8192); });
+        child.on('close', (code) => resolve({
+            code: code ?? 1,
+            stdoutTail: stdoutBuf,
+            stderrTail: stderrBuf,
+        }));
+        child.on('error', () => resolve({ code: 1, stdoutTail: '', stderrTail: 'failed to spawn ' + cmd }));
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/ship/run.js.map

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

package/dist/template/index.d.ts

@@ -0,0 +1,50 @@
+export interface TemplateContext {
+    projectSlug: string;
+    projectName: string;
+    licenseRef: string;
+}
+export interface ScaffoldOptions {
+    /** Template id under templates/ (e.g. 'react-app'). */
+    templateName: string;
+    /** Absolute path of the target directory. */
+    targetDir: string;
+    /** Substitution values. */
+    ctx: TemplateContext;
+    /**
+     * If true, refuse to write into a non-empty target dir.
+     * If false, overwrite existing files (no merge, no rename).
+     */
+    refuseIfNonEmpty: boolean;
+}
+export interface ScaffoldResult {
+    files: string[];
+}
+/**
+ * Resolve the absolute path of the bundled templates directory.
+ *
+ * Works in three runtimes:
+ *   - tsx dev: src/commands/new.ts -> ../../templates/
+ *   - tsc out: dist/commands/new.js -> ../../templates/
+ *   - npm pkg: node_modules/.../dist/commands/new.js -> same
+ *
+ * Exported so tests can override via templatesDirForTest() when
+ * exercising the scaffolder against a controlled fixture.
+ */
+export declare function defaultTemplatesDir(): string;
+export declare function scaffold(opts: ScaffoldOptions, templatesDir?: string): Promise<ScaffoldResult>;
+export declare function applyTokens(input: string, ctx: TemplateContext): string;
+/**
+ * Title-case a slug for the human-readable project name.
+ *   "my-todos" -> "My Todos"
+ *   "yujin-koe" -> "Yujin Koe"
+ */
+export declare function titleCaseFromSlug(slug: string): string;
+/**
+ * Validate a project slug. NAC + npm conventions:
+ *   - lowercase
+ *   - alphanumeric + dash
+ *   - 3..40 chars
+ *   - must start with a letter
+ */
+export declare function isValidSlug(slug: string): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/template/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/template/index.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,GAAG,EAAE,eAAe,CAAC;IACrB;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAYpG;AAoED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,MAAM,CAKvE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/template/index.js

@@ -0,0 +1,140 @@
+/**
+ * Yujin Forge -- template engine.
+ *
+ * Reads a starter template from the package's templates/<name>/
+ * directory, applies token substitution, and writes the materialised
+ * project to a target directory.
+ *
+ * Tokens (case-sensitive, matched literally):
+ *
+ *   %%PROJECT_SLUG%%      slug passed to `yf new <slug>`
+ *   %%PROJECT_NAME%%      human-friendly name (default = title-cased slug)
+ *   %%LICENSE_REF%%       license reference (paid seat token or 'trial')
+ *
+ * Binary files (images, archives, fonts) are passed through
+ * unchanged. The text-vs-binary detection is extension-based --
+ * cheap, deterministic, and avoids partial reads that would break
+ * UTF-8 substitution.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Files we touch as UTF-8 text + substitute tokens in. */
+const TEXT_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.json', '.md', '.css', '.html', '.txt',
+    '.yml', '.yaml', '.toml', '.lock',
+    '.gitignore', '.npmrc', '.env', '.env.example',
+]);
+/**
+ * Resolve the absolute path of the bundled templates directory.
+ *
+ * Works in three runtimes:
+ *   - tsx dev: src/commands/new.ts -> ../../templates/
+ *   - tsc out: dist/commands/new.js -> ../../templates/
+ *   - npm pkg: node_modules/.../dist/commands/new.js -> same
+ *
+ * Exported so tests can override via templatesDirForTest() when
+ * exercising the scaffolder against a controlled fixture.
+ */
+export function defaultTemplatesDir() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, '..', '..', 'templates');
+}
+export async function scaffold(opts, templatesDir) {
+    const root = templatesDir ?? defaultTemplatesDir();
+    const src = path.join(root, opts.templateName);
+    await assertTemplateExists(src, opts.templateName);
+    await assertTargetWritable(opts.targetDir, opts.refuseIfNonEmpty);
+    await fs.mkdir(opts.targetDir, { recursive: true });
+    const written = [];
+    await walkAndCopy(src, opts.targetDir, opts.ctx, written);
+    written.sort();
+    return { files: written };
+}
+async function assertTemplateExists(dir, name) {
+    try {
+        const stat = await fs.stat(dir);
+        if (!stat.isDirectory()) {
+            throw new Error(`template '${name}' is not a directory at ${dir}`);
+        }
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error(`template '${name}' not found (looked in ${dir})`);
+        }
+        throw err;
+    }
+}
+async function assertTargetWritable(dir, refuseIfNonEmpty) {
+    let entries;
+    try {
+        entries = await fs.readdir(dir);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+    if (refuseIfNonEmpty && entries.length > 0) {
+        throw new Error(`target directory ${dir} is not empty (use --force to overwrite, or pick a different --dir)`);
+    }
+}
+async function walkAndCopy(srcDir, destDir, ctx, written) {
+    const entries = await fs.readdir(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(srcDir, entry.name);
+        const destPath = path.join(destDir, entry.name);
+        if (entry.isDirectory()) {
+            await fs.mkdir(destPath, { recursive: true });
+            await walkAndCopy(srcPath, destPath, ctx, written);
+            continue;
+        }
+        if (entry.isFile()) {
+            const ext = path.extname(entry.name);
+            const isText = TEXT_EXTENSIONS.has(ext) || isDotConfig(entry.name);
+            if (isText) {
+                const raw = await fs.readFile(srcPath, 'utf-8');
+                await fs.writeFile(destPath, applyTokens(raw, ctx), 'utf-8');
+            }
+            else {
+                await fs.copyFile(srcPath, destPath);
+            }
+            written.push(destPath);
+        }
+    }
+}
+function isDotConfig(name) {
+    // Cover dotfiles without a recognised extension (.gitignore,
+    // .npmrc, .env, .env.example etc).
+    return name.startsWith('.') && !name.includes('.', 1);
+}
+export function applyTokens(input, ctx) {
+    return input
+        .replace(/%%PROJECT_SLUG%%/g, ctx.projectSlug)
+        .replace(/%%PROJECT_NAME%%/g, ctx.projectName)
+        .replace(/%%LICENSE_REF%%/g, ctx.licenseRef);
+}
+/**
+ * Title-case a slug for the human-readable project name.
+ *   "my-todos" -> "My Todos"
+ *   "yujin-koe" -> "Yujin Koe"
+ */
+export function titleCaseFromSlug(slug) {
+    return slug
+        .split(/[-_]+/)
+        .filter((part) => part.length > 0)
+        .map((part) => part[0].toUpperCase() + part.slice(1).toLowerCase())
+        .join(' ');
+}
+/**
+ * Validate a project slug. NAC + npm conventions:
+ *   - lowercase
+ *   - alphanumeric + dash
+ *   - 3..40 chars
+ *   - must start with a letter
+ */
+export function isValidSlug(slug) {
+    return /^[a-z][a-z0-9-]{2,39}$/.test(slug);
+}
+//# sourceMappingURL=index.js.map

package/dist/template/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/template/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,2DAA2D;AAC3D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IACvC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IACjC,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc;CAC/C,CAAC,CAAC;AA0BH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAqB,EAAE,YAAqB;IACzE,MAAM,IAAI,GAAG,YAAY,IAAI,mBAAmB,EAAE,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAE/C,MAAM,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,oBAAoB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAElE,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,EAAE,CAAC;IACf,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,GAAW,EAAE,IAAY;IAC3D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,2BAA2B,GAAG,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,0BAA0B,GAAG,GAAG,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,GAAW,EAAE,gBAAyB;IACxE,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QAC7D,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,oBAAoB,GAAG,qEAAqE,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,MAAc,EACd,OAAe,EACf,GAAoB,EACpB,OAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnE,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAChD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACvC,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,6DAA6D;IAC7D,mCAAmC;IACnC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,GAAoB;IAC7D,OAAO,KAAK;SACT,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,WAAW,CAAC;SAC7C,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,WAAW,CAAC;SAC7C,OAAO,CAAC,kBAAkB,EAAG,GAAG,CAAC,UAAU,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI;SACR,KAAK,CAAC,OAAO,CAAC;SACd,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACnE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/ui/colors.d.ts

@@ -0,0 +1,13 @@
+export declare const c: {
+    success: (s: string) => string;
+    warn: (s: string) => string;
+    error: (s: string) => string;
+    info: (s: string) => string;
+    brand: (s: string) => string;
+    kanji: (s: string) => string;
+    dim: (s: string) => string;
+    code: (s: string) => string;
+};
+/** Print a header with the Forge kanji brand mark. */
+export declare function header(line: string): void;
+//# sourceMappingURL=colors.d.ts.map

package/dist/ui/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/ui/colors.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,CAAC;iBACC,MAAM;cACN,MAAM;eACN,MAAM;cACN,MAAM;eACN,MAAM;eACN,MAAM;aACN,MAAM;cACN,MAAM;CACpB,CAAC;AAEF,sDAAsD;AACtD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGzC"}

package/dist/ui/colors.js

@@ -0,0 +1,26 @@
+/**
+ * Yujin Forge -- color helpers for CLI output.
+ *
+ * Centralised so the entire CLI uses the same palette + the same
+ * "supports color?" detection. Wraps kleur but adds two niceties:
+ *
+ *   - dim() preserves italics on terminals that support them
+ *   - kanji() uses the warm-gold accent for the brand mark
+ */
+import kleur from 'kleur';
+export const c = {
+    success: (s) => kleur.green(s),
+    warn: (s) => kleur.yellow(s),
+    error: (s) => kleur.red(s),
+    info: (s) => kleur.cyan(s),
+    brand: (s) => kleur.blue().bold(s),
+    kanji: (s) => kleur.yellow().bold(s),
+    dim: (s) => kleur.gray(s),
+    code: (s) => kleur.gray('`') + kleur.white(s) + kleur.gray('`'),
+};
+/** Print a header with the Forge kanji brand mark. */
+export function header(line) {
+    // U+58F0 -- "voice" kanji used as the brand mark across Yujin.
+    console.log(c.kanji('声') + '  ' + c.brand(line));
+}
+//# sourceMappingURL=colors.js.map

package/dist/ui/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/ui/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,CAAC,GAAG;IACf,OAAO,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACtC,IAAI,EAAK,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACvC,KAAK,EAAI,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,IAAI,EAAK,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,KAAK,EAAI,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,KAAK,EAAI,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,GAAG,EAAM,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,IAAI,EAAK,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;CAC3E,CAAC;AAEF,sDAAsD;AACtD,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,+DAA+D;IAC/D,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/validate/index.d.ts

@@ -0,0 +1,19 @@
+export type Severity = 'error' | 'warn';
+export interface Finding {
+    severity: Severity;
+    code: string;
+    message: string;
+}
+export interface ValidateReport {
+    project_root: string;
+    findings: Finding[];
+    ok: boolean;
+}
+export interface ValidateOptions {
+    /** Project root to validate. */
+    projectRoot: string;
+    /** If true, treat warnings as errors. */
+    strict?: boolean;
+}
+export declare function validateProject(opts: ValidateOptions): Promise<ValidateReport>;
+//# sourceMappingURL=index.d.ts.map

package/dist/validate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAExC,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AASD,wBAAsB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAgBpF"}