@nac3/forge-cli 0.2.0-alpha.1

package/dist/commands/scenarios.js

@@ -0,0 +1,304 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { c, header } from '../ui/colors.js';
+import { emitPlaywright, emitMaestro, } from '../nac3/scenario_dsl.js';
+const SCENARIOS_DIR = 'tests/scenarios';
+const WEB_OUT_DIR = 'tests/visual/generated';
+const RN_OUT_DIR = 'tests/mobile/generated';
+export function registerScenariosCommand(program) {
+    program
+        .command('scenarios:emit')
+        .description('Emit Playwright (web) + Maestro (RN) suites from tests/scenarios/*.yujin.yaml')
+        .option('--json', 'emit a JSON report instead of human text')
+        .action(async (opts) => {
+        await runEmit(opts);
+    });
+}
+async function runEmit(opts) {
+    const root = process.cwd();
+    const dir = path.join(root, SCENARIOS_DIR);
+    let files = [];
+    try {
+        files = (await fs.readdir(dir)).filter((f) => f.endsWith('.yujin.yaml'));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({ ok: false, error: msg }) + '\n');
+        }
+        else {
+            console.error(c.error(msg));
+        }
+        process.exitCode = 1;
+        return;
+    }
+    await fs.mkdir(path.join(root, WEB_OUT_DIR), { recursive: true });
+    await fs.mkdir(path.join(root, RN_OUT_DIR), { recursive: true });
+    const emitted = [];
+    const skipped = [];
+    for (const fname of files) {
+        const abs = path.join(dir, fname);
+        let scenario;
+        try {
+            const yaml = await fs.readFile(abs, 'utf-8');
+            scenario = parseYaml(yaml);
+        }
+        catch (err) {
+            skipped.push({ file: fname, error: err instanceof Error ? err.message : String(err) });
+            continue;
+        }
+        const slug = path.basename(fname, '.yujin.yaml');
+        const webOut = path.join(root, WEB_OUT_DIR, slug + '.spec.ts');
+        const rnOut = path.join(root, RN_OUT_DIR, slug + '.flow.yaml');
+        try {
+            await fs.writeFile(webOut, emitPlaywright(scenario), 'utf-8');
+            await fs.writeFile(rnOut, emitMaestro(scenario), 'utf-8');
+            emitted.push({ scenario: scenario.name, slug, web: webOut, rn: rnOut });
+        }
+        catch (err) {
+            skipped.push({ file: fname, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ ok: skipped.length === 0, emitted, skipped }, null, 2) + '\n');
+        if (skipped.length > 0)
+            process.exitCode = 1;
+        return;
+    }
+    header('Yujin Forge -- scenarios:emit');
+    console.log('');
+    for (const e of emitted) {
+        console.log(c.success('+') + ' ' + e.scenario + c.dim(' (' + e.slug + ')'));
+        console.log('  ' + c.dim('web: ') + path.relative(root, e.web));
+        console.log('  ' + c.dim('rn:  ') + path.relative(root, e.rn));
+    }
+    if (skipped.length > 0) {
+        console.log('');
+        console.log(c.warn('Skipped ' + skipped.length + ' file(s):'));
+        for (const s of skipped) {
+            console.log('  ' + s.file + ' -- ' + s.error.slice(0, 120));
+        }
+        process.exitCode = 1;
+    }
+    else {
+        console.log('');
+        console.log(c.dim('Emitted ' + emitted.length + ' scenario(s) to web + rn targets.'));
+    }
+}
+/* ============================================================
+ * Tiny YAML subset parser.
+ *
+ * We intentionally avoid `js-yaml` to keep the package dep
+ * surface flat for the SQ 0.11 vault. The grammar we accept:
+ *
+ *   name: string                # quoted or unquoted
+ *   url:  string
+ *   tags: [a, b, c]            # inline array of strings
+ *   stubs:
+ *     - url: '...'
+ *       method: GET
+ *       status: 200
+ *       response: { ok: true }  # any inline JSON literal
+ *   flow:
+ *     - tap: '...'
+ *     - typeText: '...'
+ *       into: '...'
+ *     - assertVisible: '...'
+ *     - assertHidden: '...'
+ *     - assertText: '...'
+ *       in: '...'
+ *     - waitMs: 250
+ *     - screenshot: '...'
+ *
+ * Anything more elaborate (anchors, multi-line strings, refs)
+ * goes through a richer parser at NAC3.4 polish time.
+ *
+ * ASCII-only on the source.
+ * ============================================================ */
+function parseYaml(yaml) {
+    /* Strip comments. */
+    const cleaned = yaml.split('\n').map((line) => {
+        const hash = line.indexOf('#');
+        if (hash < 0)
+            return line;
+        /* Only strip if # is not inside quotes -- crude heuristic:
+           check if the # is preceded by an odd number of single
+           or double quotes. */
+        const before = line.slice(0, hash);
+        const sq = (before.match(/'/g) || []).length;
+        const dq = (before.match(/"/g) || []).length;
+        if (sq % 2 !== 0 || dq % 2 !== 0)
+            return line;
+        return before;
+    }).join('\n');
+    /* Tokenise into indent-aware tree. */
+    const lines = cleaned.split('\n').map((l) => l.replace(/\s+$/, ''));
+    const top = {};
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (line === undefined || /^\s*$/.test(line)) {
+            i += 1;
+            continue;
+        }
+        if (line.startsWith(' ')) {
+            i += 1;
+            continue;
+        }
+        const m = line.match(/^([a-zA-Z_][a-zA-Z0-9_]*)\s*:\s*(.*)$/);
+        if (!m) {
+            i += 1;
+            continue;
+        }
+        const key = m[1];
+        const rest = m[2];
+        if (rest.length > 0) {
+            top[key] = parseInlineValue(rest);
+            i += 1;
+        }
+        else {
+            /* Block follows; collect indented lines. */
+            const block = [];
+            i += 1;
+            while (i < lines.length && lines[i] !== undefined && (/^\s/.test(lines[i]) || lines[i] === '')) {
+                block.push(lines[i]);
+                i += 1;
+            }
+            top[key] = parseBlock(block);
+        }
+    }
+    if (typeof top.name !== 'string') {
+        throw new Error('scenario YAML: missing `name`');
+    }
+    if (!Array.isArray(top.flow)) {
+        throw new Error('scenario YAML: missing `flow:` array');
+    }
+    return {
+        name: top.name,
+        ...(typeof top.url === 'string' ? { url: top.url } : {}),
+        ...(Array.isArray(top.tags) ? { tags: top.tags } : {}),
+        ...(Array.isArray(top.stubs) ? { stubs: top.stubs } : {}),
+        flow: top.flow,
+    };
+}
+function parseInlineValue(s) {
+    const trimmed = s.trim();
+    if (trimmed === '')
+        return '';
+    /* Inline array. */
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        const inner = trimmed.slice(1, -1).trim();
+        if (!inner)
+            return [];
+        return inner.split(',').map((p) => parseInlineValue(p.trim()));
+    }
+    /* Inline JSON object. */
+    if (trimmed.startsWith('{') || (trimmed.startsWith('[') && /^\[.*\]$/.test(trimmed))) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch { /* fall through */ }
+    }
+    /* Quoted string. */
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"'))
+        || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    /* Number. */
+    if (/^-?\d+(\.\d+)?$/.test(trimmed))
+        return Number(trimmed);
+    /* Boolean / null. */
+    if (trimmed === 'true')
+        return true;
+    if (trimmed === 'false')
+        return false;
+    if (trimmed === 'null')
+        return null;
+    return trimmed;
+}
+function parseBlock(lines) {
+    if (lines.length === 0)
+        return [];
+    /* Detect if it's an array (each non-empty line starts with `-`). */
+    const isArray = lines.some((l) => /^\s*-\s/.test(l));
+    if (isArray)
+        return parseArrayBlock(lines);
+    return parseMapBlock(lines);
+}
+function parseArrayBlock(lines) {
+    const items = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (/^\s*$/.test(line)) {
+            i += 1;
+            continue;
+        }
+        const m = line.match(/^(\s*)-\s+(.*)$/);
+        if (!m) {
+            i += 1;
+            continue;
+        }
+        const itemIndent = m[1].length;
+        const first = m[2];
+        /* Collect any lines indented further than itemIndent + 2. */
+        const itemLines = [];
+        /* If the first token is `key: value`, treat the item as a
+           map with that key as the seed. */
+        const kvMatch = first.match(/^([a-zA-Z_][a-zA-Z0-9_]*)\s*:\s*(.*)$/);
+        if (kvMatch) {
+            itemLines.push(' '.repeat(itemIndent + 2) + kvMatch[1] + ': ' + kvMatch[2]);
+        }
+        else {
+            itemLines.push(' '.repeat(itemIndent + 2) + first);
+        }
+        i += 1;
+        while (i < lines.length && lines[i] !== undefined && /^\s/.test(lines[i])
+            && (lines[i].length - lines[i].trimStart().length) > itemIndent) {
+            itemLines.push(lines[i]);
+            i += 1;
+        }
+        /* Re-dedent and parse the item. */
+        const minIndent = Math.min(...itemLines.filter((l) => l.trim()).map((l) => l.length - l.trimStart().length));
+        const dedented = itemLines.map((l) => l.slice(minIndent));
+        items.push(parseMapBlock(dedented));
+    }
+    return items;
+}
+function parseMapBlock(lines) {
+    const out = {};
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (/^\s*$/.test(line)) {
+            i += 1;
+            continue;
+        }
+        const indent = line.length - line.trimStart().length;
+        const m = line.trim().match(/^([a-zA-Z_][a-zA-Z0-9_]*)\s*:\s*(.*)$/);
+        if (!m) {
+            i += 1;
+            continue;
+        }
+        const key = m[1];
+        const rest = m[2];
+        if (rest.length > 0) {
+            out[key] = parseInlineValue(rest);
+            i += 1;
+        }
+        else {
+            /* Collect deeper-indented block. */
+            const block = [];
+            i += 1;
+            while (i < lines.length && lines[i] !== undefined && lines[i].trim() !== ''
+                && (lines[i].length - lines[i].trimStart().length) > indent) {
+                const stripped = lines[i].slice(indent + 2);
+                block.push(stripped);
+                i += 1;
+            }
+            out[key] = parseBlock(block);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=scenarios.js.map

package/dist/commands/scenarios.js.map

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

package/dist/commands/ship.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `yf ship` -- gated deploy. Runs the pipeline:
+ *
+ *   validate -> license -> test -> build
+ *
+ * Stops on first failure; reports per-step ok / detail / ms.
+ * --skip-tests skips step 3 (CI runs the tests in a separate job).
+ * --target hooks the deploy step (deferred; the dist/ from step 4
+ * is emitted regardless).
+ */
+import type { Command } from 'commander';
+export interface ShipOptions {
+    target?: string;
+    skipTests?: boolean;
+    cwd?: string;
+}
+export declare function registerShipCommand(program: Command): void;
+//# sourceMappingURL=ship.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ship.d.ts","sourceRoot":"","sources":["../../src/commands/ship.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqC1D"}

package/dist/commands/ship.js

@@ -0,0 +1,41 @@
+import path from 'node:path';
+import { c, header } from '../ui/colors.js';
+import { runShip } from '../ship/run.js';
+export function registerShipCommand(program) {
+    program
+        .command('ship')
+        .description('Run the deploy gate (validate + license + tests + build) and emit dist/.')
+        .option('-t, --target <name>', 'deploy target hook (default: static)', 'static')
+        .option('--skip-tests', 'skip the test gate (NOT for production)')
+        .option('--cwd <path>', 'project root (default: current directory)')
+        .action(async (opts) => {
+        const projectRoot = opts.cwd ? path.resolve(opts.cwd) : process.cwd();
+        header('Yujin Forge -- ship');
+        console.log('');
+        console.log('  Project: ' + c.dim(projectRoot));
+        console.log('  Target:  ' + (opts.target ?? 'static'));
+        console.log('');
+        const result = await runShip({
+            projectRoot,
+            skipTests: !!opts.skipTests,
+        });
+        for (const step of result.steps) {
+            const mark = step.skipped
+                ? c.dim('-')
+                : (step.ok ? c.success('✓') : c.error('✗'));
+            const ms = step.ms > 0 ? c.dim('(' + step.ms + 'ms)') : '';
+            console.log('  ' + mark + ' ' + step.name + '  ' + step.detail + ' ' + ms);
+        }
+        console.log('');
+        if (result.ok) {
+            console.log(c.success('Ship gate passed. dist/ is ready to deploy.'));
+            console.log(c.dim('Deploy hook for target=' + (opts.target ?? 'static')
+                + ' lands in the milestone: yf ship gate (2026-11).'));
+        }
+        else {
+            console.log(c.error('Ship gate failed. Fix the first failing step above + retry.'));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=ship.js.map

package/dist/commands/ship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.js","sourceRoot":"","sources":["../../src/commands/ship.ts"],"names":[],"mappings":"AAWA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAQzC,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0EAA0E,CAAC;SACvF,MAAM,CAAC,qBAAqB,EAAE,sCAAsC,EAAE,QAAQ,CAAC;SAC/E,MAAM,CAAC,cAAc,EAAS,yCAAyC,CAAC;SACxE,MAAM,CAAC,cAAc,EAAS,2CAA2C,CAAC;SAC1E,MAAM,CAAC,KAAK,EAAE,IAAiB,EAAE,EAAE;QAClC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACtE,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAC3B,WAAW;YACX,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS;SAC5B,CAAC,CAAC;QAEH,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO;gBACvB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;gBACZ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,yBAAyB,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC;kBACnE,kDAAkD,CAAC,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC,CAAC;YACpF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/test.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `yf test` -- run the project's test corpus.
+ *
+ * Day-1 contract: shells out to the appropriate npm script in
+ * the project directory. The auto-generated corpus gen (the part
+ * that emits test files from a manifest) lands as a separate
+ * 'yf generate tests' command in a future milestone.
+ *
+ * Script routing:
+ *   --unit  -> npm run test:unit  (or npm test if absent)
+ *   --e2e   -> npm run test:e2e
+ *   (none)  -> npm test
+ *
+ * --watch and --filter are passed through as extra args:
+ *   yf test --watch                -> npm test -- --watch
+ *   yf test --filter 'todos'       -> npm test -- --filter todos
+ *
+ * Inherits stdio so the user sees test output live.
+ */
+import type { Command } from 'commander';
+export interface TestOptions {
+    unit?: boolean;
+    e2e?: boolean;
+    watch?: boolean;
+    filter?: string;
+    cwd?: string;
+}
+export declare function registerTestCommand(program: Command): void;
+//# sourceMappingURL=test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4B1D"}

package/dist/commands/test.js

@@ -0,0 +1,62 @@
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import { c, header } from '../ui/colors.js';
+export function registerTestCommand(program) {
+    program
+        .command('test')
+        .description('Run the project test corpus (npm test in the project directory).')
+        .option('--unit', 'run only the unit suite (npm run test:unit)')
+        .option('--e2e', 'run only the e2e suite (npm run test:e2e)')
+        .option('--watch', 'rerun on file changes (passed through to the runner)')
+        .option('-f, --filter <pattern>', 'filter by test name (passed through)')
+        .option('--cwd <path>', 'project root (default: current directory)')
+        .action(async (opts) => {
+        const projectRoot = opts.cwd ? path.resolve(opts.cwd) : process.cwd();
+        header('Yujin Forge -- test');
+        console.log('');
+        console.log('  Project: ' + c.dim(projectRoot));
+        const { script, scriptArgs } = chooseScript(opts);
+        console.log('  Command: ' + c.dim('npm ' + scriptArgs.join(' ')));
+        console.log('');
+        // Pass-through inherit-stdio so the test runner output goes
+        // straight to the terminal. We exit with the child's code.
+        const code = await runInherit('npm', scriptArgs, projectRoot);
+        if (code !== 0) {
+            console.log('');
+            console.log(c.error('Tests failed (' + script + ' exit code ' + code + ').'));
+            process.exitCode = code;
+        }
+    });
+}
+function chooseScript(opts) {
+    const extras = [];
+    if (opts.filter)
+        extras.push('--filter', opts.filter);
+    if (opts.watch)
+        extras.push('--watch');
+    if (opts.e2e) {
+        return { script: 'test:e2e', scriptArgs: extras.length === 0
+                ? ['run', 'test:e2e']
+                : ['run', 'test:e2e', '--', ...extras] };
+    }
+    if (opts.unit) {
+        return { script: 'test:unit', scriptArgs: extras.length === 0
+                ? ['run', 'test:unit']
+                : ['run', 'test:unit', '--', ...extras] };
+    }
+    return { script: 'test', scriptArgs: extras.length === 0
+            ? ['test']
+            : ['test', '--', ...extras] };
+}
+function runInherit(cmd, args, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn(cmd, args, {
+            cwd,
+            stdio: 'inherit',
+            shell: process.platform === 'win32',
+        });
+        child.on('close', (code) => resolve(code ?? 1));
+        child.on('error', () => resolve(1));
+    });
+}
+//# sourceMappingURL=test.js.map

package/dist/commands/test.js.map

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

package/dist/commands/tunnel.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `yf tunnel` -- manage the Cloudflare Tunnel to the local
+ * panel (PLAN connectivity).
+ *
+ * Subcommands:
+ *   yf tunnel start [--port N] [--ephemeral]
+ *   yf tunnel status
+ *
+ * The tunnel runs in the background as long as the spawn
+ * is alive; `yf chat` itself can also auto-start a tunnel
+ * when paid mode is active (future slice).
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export interface TunnelOptions {
+    port?: string;
+    ephemeral?: boolean;
+    json?: boolean;
+}
+export declare function registerTunnelCommand(program: Command): void;
+//# sourceMappingURL=tunnel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.d.ts","sourceRoot":"","sources":["../../src/commands/tunnel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB5D"}

package/dist/commands/tunnel.js

@@ -0,0 +1,77 @@
+import { c, header } from '../ui/colors.js';
+import { startTunnel, resolveCloudflared, readTunnelToken, } from '../core/cf_tunnel.js';
+export function registerTunnelCommand(program) {
+    const root = program
+        .command('tunnel')
+        .description('Manage the Cloudflare Tunnel that exposes your local panel (paid mode).');
+    root
+        .command('start')
+        .description('Start a tunnel session in the foreground (Ctrl-C to stop).')
+        .option('-p, --port <n>', 'local port to expose (default 4849)', '4849')
+        .option('--ephemeral', 'use try.cloudflare.com (random URL, no token needed)')
+        .option('--json', 'emit JSON when the URL is ready')
+        .action(async (opts) => { await runStart(opts); });
+    root
+        .command('status')
+        .description('Check if cloudflared is installed + if a token is configured.')
+        .option('--json', 'emit JSON')
+        .action(async (opts) => { await runStatus(opts); });
+}
+async function runStart(opts) {
+    const port = parseInt(opts.port ?? '4849', 10);
+    if (!opts.json) {
+        header('Yujin Forge -- tunnel start');
+        console.log('');
+        console.log('  port:      ' + port);
+        console.log('  ephemeral: ' + (opts.ephemeral ? 'yes' : 'no'));
+        console.log('  Press Ctrl-C to stop.');
+        console.log('');
+    }
+    let handle;
+    try {
+        handle = await startTunnel({ port, ephemeral: opts.ephemeral });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (opts.json)
+            process.stdout.write(JSON.stringify({ ok: false, error: msg }) + '\n');
+        else
+            console.error(c.error(msg));
+        process.exitCode = 1;
+        return;
+    }
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ ok: true, url: handle.publicUrl }) + '\n');
+    }
+    else {
+        console.log(c.success('Tunnel ready: ') + c.brand(handle.publicUrl));
+    }
+    /* Wire stdin / signals so Ctrl-C cleans up the spawn. */
+    const cleanup = async () => {
+        await handle.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+    /* Keep alive until the cloudflared process exits. */
+    await new Promise((resolve) => handle.process.once('exit', () => resolve()));
+}
+async function runStatus(opts) {
+    const bin = await resolveCloudflared();
+    const tokenSlot = await readTunnelToken();
+    const status = {
+        cloudflared_installed: !!bin,
+        cloudflared_path: bin,
+        tunnel_token_configured: !!tokenSlot,
+        /* The token VALUE is never returned -- only "configured". */
+    };
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ ok: true, ...status }, null, 2) + '\n');
+        return;
+    }
+    header('Yujin Forge -- tunnel status');
+    console.log('');
+    console.log('  cloudflared:    ' + (bin ? c.success(bin) : c.warn('not installed')));
+    console.log('  tunnel token:   ' + (tokenSlot ? c.success('configured in vault') : c.dim('absent (will use ephemeral)')));
+}
+//# sourceMappingURL=tunnel.js.map

package/dist/commands/tunnel.js.map

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

package/dist/commands/validate.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `yf validate [path]` -- static project structure check.
+ *
+ * Prints findings (errors + warnings) and exits non-zero when any
+ * error is present (or any warning under --strict). Designed to
+ * be cheap enough for a pre-commit hook -- no compile, no install.
+ */
+import type { Command } from 'commander';
+export interface ValidateOptions {
+    strict?: boolean;
+    json?: boolean;
+}
+export declare function registerValidateCommand(program: Command): void;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+C9D"}