@aperant/framework 0.6.2 → 0.6.3

package/dist/__tests__/design-validate.test.js

@@ -1,231 +0,0 @@
-/**
- * design-validate.test.ts — C2 DESIGN.md validator tests.
- *
- * Covers validateDesignMarkdown() on inline fixtures + the shipped scaffold:
- *   - scaffold: passes with zero errors, zero warnings (template is canonical)
- *   - missing frontmatter: fails with "missing YAML frontmatter" error
- *   - malformed YAML: fails with parse-error message
- *   - missing meta: fails citing meta
- *   - missing tokens.colors.accent: fails citing tokens.colors.accent
- *   - extra unknown keys: allowed (passthrough schema)
- *   - body missing "## Color Palette": warns, stays ok
- */
-import { readFileSync } from 'node:fs';
-import { dirname, resolve as resolvePath } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { describe, expect, it } from 'vitest';
-import { extractDesignFrontmatter, validateDesignMarkdown } from '../cli/design/validate.mjs';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const SCAFFOLD_PATH = resolvePath(__dirname, '..', '..', 'templates', 'DESIGN.md');
-const MINIMAL_GOOD = `---
-meta:
-  name: "Test"
-  version: "0.1.0"
-  updated: "2026-04-16"
-tokens:
-  colors:
-    bg: "#000000"
-    surface: "#111111"
-    accent: "#7C5CFF"
-    text: "#FFFFFF"
-    border: "#222222"
-  typography:
-    families:
-      primary: "Inter"
-    scale:
-      - "14px"
-      - "16px"
-      - "20px"
-  spacing:
-    - "4px"
-    - "8px"
----
-
-# Design System
-
-## 2. Color Palette
-
-notes
-
-## 3. Typography
-
-notes
-`;
-const NO_FRONTMATTER = `# Design System
-
-No frontmatter at all.
-`;
-const MALFORMED_YAML = `---
-meta:
-  name: "Test
-  version: "0.1.0"
-  updated: 2026-04-16
----
-
-# Design System
-`;
-const MISSING_META = `---
-tokens:
-  colors:
-    bg: "#000"
-    surface: "#111"
-    accent: "#7C5CFF"
-    text: "#FFF"
-    border: "#222"
-  typography:
-    families:
-      primary: "Inter"
-    scale: ["14px", "16px", "20px"]
-  spacing: ["4px", "8px"]
----
-
-# Design System
-`;
-const MISSING_ACCENT = `---
-meta:
-  name: "Test"
-  version: "0.1.0"
-  updated: "2026-04-16"
-tokens:
-  colors:
-    bg: "#000"
-    surface: "#111"
-    text: "#FFF"
-    border: "#222"
-  typography:
-    families:
-      primary: "Inter"
-    scale: ["14px", "16px", "20px"]
-  spacing: ["4px", "8px"]
----
-
-# Design System
-`;
-// NOTE: meta is .strict() by design — extras under meta are rejected so
-// identity fields don't silently typo.  Extras at root, under tokens, and
-// inside nested records (colors, components, motion) are allowed via
-// .passthrough() so future tools can extend the schema without forking.
-const WITH_EXTRA_KEYS = `---
-meta:
-  name: "Test"
-  version: "0.1.0"
-  updated: "2026-04-16"
-tokens:
-  colors:
-    bg: "#000"
-    surface: "#111"
-    accent: "#7C5CFF"
-    text: "#FFF"
-    border: "#222"
-    brandPurple: "#7C5CFF"
-  typography:
-    families:
-      primary: "Inter"
-    scale: ["14px", "16px", "20px"]
-  spacing: ["4px", "8px"]
-experimental:
-  newFeatureBlock: true
----
-
-# Design System
-
-## 2. Color Palette
-
-notes
-
-## 3. Typography
-
-notes
-`;
-const MINIMAL_NO_BODY_SECTIONS = `---
-meta:
-  name: "Test"
-  version: "0.1.0"
-  updated: "2026-04-16"
-tokens:
-  colors:
-    bg: "#000"
-    surface: "#111"
-    accent: "#7C5CFF"
-    text: "#FFF"
-    border: "#222"
-  typography:
-    families:
-      primary: "Inter"
-    scale: ["14px", "16px", "20px"]
-  spacing: ["4px", "8px"]
----
-
-# Design System
-
-Just a heading, no numbered sections.
-`;
-describe('validateDesignMarkdown', () => {
-    it('passes on the shipped scaffold template with zero errors and zero warnings', () => {
-        const text = readFileSync(SCAFFOLD_PATH, 'utf8');
-        const result = validateDesignMarkdown(text);
-        expect(result.ok).toBe(true);
-        expect(result.errors).toEqual([]);
-        expect(result.warnings).toEqual([]);
-    });
-    it('passes on a minimal good document', () => {
-        const result = validateDesignMarkdown(MINIMAL_GOOD);
-        expect(result.ok).toBe(true);
-        expect(result.errors).toEqual([]);
-    });
-    it('fails when frontmatter is missing entirely', () => {
-        const result = validateDesignMarkdown(NO_FRONTMATTER);
-        expect(result.ok).toBe(false);
-        expect(result.errors.some((e) => e.includes('missing YAML frontmatter'))).toBe(true);
-    });
-    it('fails when frontmatter YAML is malformed', () => {
-        const result = validateDesignMarkdown(MALFORMED_YAML);
-        expect(result.ok).toBe(false);
-        expect(result.errors.some((e) => e.includes('YAML parse error') || e.includes('missing YAML frontmatter'))).toBe(true);
-    });
-    it('fails when meta is missing', () => {
-        const result = validateDesignMarkdown(MISSING_META);
-        expect(result.ok).toBe(false);
-        expect(result.errors.some((e) => e.includes('meta'))).toBe(true);
-    });
-    it('fails when tokens.colors.accent is missing', () => {
-        const result = validateDesignMarkdown(MISSING_ACCENT);
-        expect(result.ok).toBe(false);
-        expect(result.errors.some((e) => e.includes('tokens.colors.accent'))).toBe(true);
-    });
-    it('allows extra unknown fields (passthrough schema)', () => {
-        const result = validateDesignMarkdown(WITH_EXTRA_KEYS);
-        expect(result.ok).toBe(true);
-        expect(result.errors).toEqual([]);
-    });
-    it('warns but passes when body is missing the Color Palette / Typography sections', () => {
-        const result = validateDesignMarkdown(MINIMAL_NO_BODY_SECTIONS);
-        expect(result.ok).toBe(true);
-        expect(result.errors).toEqual([]);
-        expect(result.warnings.some((w) => w.includes('Color Palette'))).toBe(true);
-        expect(result.warnings.some((w) => w.includes('Typography'))).toBe(true);
-    });
-    it('returns ok:false on empty or non-string input', () => {
-        expect(validateDesignMarkdown('').ok).toBe(false);
-        // @ts-expect-error — explicit non-string input for runtime guard test
-        expect(validateDesignMarkdown(null).ok).toBe(false);
-    });
-});
-describe('extractDesignFrontmatter', () => {
-    it('returns the parsed object on a well-formed document', () => {
-        const fm = extractDesignFrontmatter(MINIMAL_GOOD);
-        expect(fm).not.toBeNull();
-        expect(fm.meta.name).toBe('Test');
-    });
-    it('returns null when there is no frontmatter', () => {
-        expect(extractDesignFrontmatter(NO_FRONTMATTER)).toBeNull();
-    });
-    it('returns null on malformed YAML', () => {
-        expect(extractDesignFrontmatter(MALFORMED_YAML)).toBeNull();
-    });
-    it('returns null on empty input', () => {
-        expect(extractDesignFrontmatter('')).toBeNull();
-    });
-});
-//# sourceMappingURL=design-validate.test.js.map

package/dist/__tests__/design-validate.test.js.map

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

package/dist/__tests__/detached-spawn-wrapper.test.d.ts

@@ -1,17 +0,0 @@
-/**
- * detached-spawn-wrapper.test.ts — review iteration coverage.
- *
- * The wrapper script (writeWrapperScript) is the only thing keeping the
- * detached install child honest about its exit code. A regression in the
- * wrapper would silently wedge task state in `running`, so we lock in the
- * behavior here:
- *
- *   1. POSIX shebang and executable bit are set.
- *   2. `cd` failure does not run the install command in the parent's cwd
- *      (confused-deputy hazard).
- *   3. `cd` failure still invokes `--finalize` so state.json transitions
- *      out of `running`.
- *   4. Arguments with single quotes are safely escaped.
- */
-export {};
-//# sourceMappingURL=detached-spawn-wrapper.test.d.ts.map

package/dist/__tests__/detached-spawn-wrapper.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"detached-spawn-wrapper.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/detached-spawn-wrapper.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/__tests__/detached-spawn-wrapper.test.js

@@ -1,160 +0,0 @@
-/**
- * detached-spawn-wrapper.test.ts — review iteration coverage.
- *
- * The wrapper script (writeWrapperScript) is the only thing keeping the
- * detached install child honest about its exit code. A regression in the
- * wrapper would silently wedge task state in `running`, so we lock in the
- * behavior here:
- *
- *   1. POSIX shebang and executable bit are set.
- *   2. `cd` failure does not run the install command in the parent's cwd
- *      (confused-deputy hazard).
- *   3. `cd` failure still invokes `--finalize` so state.json transitions
- *      out of `running`.
- *   4. Arguments with single quotes are safely escaped.
- */
-import { execFileSync } from 'node:child_process';
-import { chmodSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync, } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
-import { writeWrapperScript } from '../cli/install/detached-spawn.mjs';
-/**
- * Create a fake apt-tools binary that appends its argv to a marker file
- * so the tests can assert the wrapper invoked --finalize correctly. The
- * wrapper invokes the binary via `node <path>` so we write an ESM .mjs
- * that Node can exec directly.
- */
-function makeFakeAptTools(path, markerPath) {
-    const body = [
-        '#!/usr/bin/env node',
-        'import { writeFileSync } from "node:fs"',
-        'const args = process.argv.slice(2).join(" ")',
-        `writeFileSync(${JSON.stringify(markerPath)}, args)`,
-        'process.exit(0)',
-        '',
-    ].join('\n');
-    writeFileSync(path, body, { mode: 0o755 });
-    chmodSync(path, 0o755);
-}
-describe('writeWrapperScript — POSIX wrapper correctness', () => {
-    let tmp;
-    beforeEach(() => {
-        tmp = mkdtempSync(join(tmpdir(), 'apt-wrap-'));
-    });
-    afterEach(() => {
-        rmSync(tmp, { recursive: true, force: true });
-    });
-    it('writes an executable POSIX shebang', () => {
-        if (process.platform === 'win32')
-            return;
-        const scriptPath = join(tmp, 'wrap.sh');
-        writeWrapperScript({
-            scriptPath,
-            cwd: tmp,
-            cmd: ['true'],
-            aptToolsPath: '/bin/true',
-            taskId: 't1',
-            ecosystem: 'pnpm',
-            projectDir: tmp,
-            shellWrapper: null,
-        });
-        const body = readFileSync(scriptPath, 'utf-8');
-        expect(body.startsWith('#!/bin/sh')).toBe(true);
-        const stat = statSync(scriptPath);
-        expect((stat.mode & 0o111) !== 0).toBe(true);
-    });
-    it('cd-failure path still calls the finalize aptTools binary', () => {
-        if (process.platform === 'win32')
-            return;
-        // Point cwd at a directory that does NOT exist. The wrapper must
-        // never run the install command AND still call the finalize binary
-        // so state.json is updated with exit=1.
-        const scriptPath = join(tmp, 'wrap.sh');
-        const finalizeMarker = join(tmp, 'finalize-was-called.txt');
-        const installMarker = join(tmp, 'install-was-run.txt');
-        const nonExistent = join(tmp, 'no-such-dir');
-        const fakeAptTools = join(tmp, 'fake-apt-tools.mjs');
-        makeFakeAptTools(fakeAptTools, finalizeMarker);
-        // Use `touch` as the install command — if the wrapper ran it despite
-        // cd failure, installMarker would appear.
-        writeWrapperScript({
-            scriptPath,
-            cwd: nonExistent,
-            cmd: ['touch', installMarker],
-            aptToolsPath: fakeAptTools,
-            taskId: 't1',
-            ecosystem: 'pnpm',
-            projectDir: tmp,
-            shellWrapper: null,
-        });
-        let exitCode = 0;
-        try {
-            execFileSync('/bin/sh', [scriptPath], { encoding: 'utf-8' });
-        }
-        catch (err) {
-            exitCode = err.status ?? 1;
-        }
-        // cd failed → wrapper exits non-zero.
-        expect(exitCode).toBe(1);
-        // Finalize binary WAS called (so state.json will be updated).
-        const finalizeBody = readFileSync(finalizeMarker, 'utf-8');
-        expect(finalizeBody).toMatch(/--exit-code\s+1/);
-        expect(finalizeBody).toMatch(/--task\s+t1/);
-        expect(finalizeBody).toMatch(/--ecosystem\s+pnpm/);
-        // Install command was NOT run (touch marker absent).
-        expect(existsSync(installMarker)).toBe(false);
-    });
-    it('escapes single quotes in cwd / cmd / taskId safely', () => {
-        if (process.platform === 'win32')
-            return;
-        // cwd, aptToolsPath, projectDir, taskId, ecosystem all get single-quote
-        // wrapped in the POSIX script. A single quote embedded in any of these
-        // MUST not break script parsing.
-        const scriptPath = join(tmp, 'wrap.sh');
-        const cwdWithQuote = join(tmp, "has'quote");
-        mkdirSync(cwdWithQuote, { recursive: true });
-        const finalizeMarker = join(tmp, 'final.txt');
-        const fakeAptTools = join(tmp, 'fake.mjs');
-        makeFakeAptTools(fakeAptTools, finalizeMarker);
-        writeWrapperScript({
-            scriptPath,
-            cwd: cwdWithQuote,
-            cmd: ['true'],
-            aptToolsPath: fakeAptTools,
-            taskId: 't1',
-            ecosystem: 'pnpm',
-            projectDir: tmp,
-            shellWrapper: null,
-        });
-        // Script must still run without a syntax error (finalize marker must exist).
-        execFileSync('/bin/sh', [scriptPath], { encoding: 'utf-8' });
-        expect(existsSync(finalizeMarker)).toBe(true);
-    });
-    it('runs install command when cd succeeds', () => {
-        if (process.platform === 'win32')
-            return;
-        const scriptPath = join(tmp, 'wrap.sh');
-        const installMarker = join(tmp, 'install-ran.txt');
-        const finalizeMarker = join(tmp, 'finalize.txt');
-        const fakeAptTools = join(tmp, 'fake-apt.mjs');
-        makeFakeAptTools(fakeAptTools, finalizeMarker);
-        writeWrapperScript({
-            scriptPath,
-            cwd: tmp,
-            cmd: ['touch', installMarker],
-            aptToolsPath: fakeAptTools,
-            taskId: 't1',
-            ecosystem: 'pnpm',
-            projectDir: tmp,
-            shellWrapper: null,
-        });
-        execFileSync('/bin/sh', [scriptPath], { encoding: 'utf-8' });
-        // Install ran → marker exists.
-        expect(statSync(installMarker).isFile()).toBe(true);
-        // Finalize was called with exit=0.
-        const finalize = readFileSync(finalizeMarker, 'utf-8');
-        expect(finalize).toMatch(/--exit-code\s+0/);
-    });
-});
-//# sourceMappingURL=detached-spawn-wrapper.test.js.map

package/dist/__tests__/detached-spawn-wrapper.test.js.map

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

package/dist/__tests__/dispatch-table.test.d.ts

@@ -1,10 +0,0 @@
-/**
- * dispatch-table.test.ts — D-02 (c) DISPATCH map sanity check (subtask 5).
- *
- * Asserts that EVERY top-level subcommand named in the help baseline
- * (cli-baseline-help.txt) resolves to a DISPATCH entry. This is the
- * dispatch-typo regression gate: a missing entry would silently route to
- * `Unknown command` and break a published skill.
- */
-export {};
-//# sourceMappingURL=dispatch-table.test.d.ts.map

package/dist/__tests__/dispatch-table.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispatch-table.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dispatch-table.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/dispatch-table.test.js

@@ -1,57 +0,0 @@
-/**
- * dispatch-table.test.ts — D-02 (c) DISPATCH map sanity check (subtask 5).
- *
- * Asserts that EVERY top-level subcommand named in the help baseline
- * (cli-baseline-help.txt) resolves to a DISPATCH entry. This is the
- * dispatch-typo regression gate: a missing entry would silently route to
- * `Unknown command` and break a published skill.
- */
-import { readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-import { describe, expect, it } from 'vitest';
-import { DISPATCH } from '../cli/dispatch.mjs';
-const HELP_BASELINE = resolve(__dirname, '__fixtures__/cli-baseline-help.txt');
-/**
- * Top-level subcommands derived from the help baseline. Subcommands that are
- * actually flags-on-a-parent ("config upgrade-gitignore", "audit privacy",
- * "task create", "lock claim", "tokens record", etc.) are NOT separate
- * dispatch entries — they're subcommands routed inside the parent cmdX.
- *
- * Everything else (the bare command word at start-of-line on `Commands:`)
- * MUST be in DISPATCH.
- */
-function extractTopLevelCommands() {
-    const help = readFileSync(HELP_BASELINE, 'utf-8');
-    const out = new Set();
-    for (const line of help.split('\n')) {
-        // Help body lines that introduce a command begin with "  <word>" — i.e.
-        // 2 spaces, then a non-space token, then either a space or a newline.
-        const m = /^ {2}([a-z][a-z0-9-]*)(?:\s|$)/.exec(line);
-        if (!m)
-            continue;
-        const tok = m[1];
-        // Filter known flag tokens that are NOT cmds: skip "Flags:" header words.
-        if (tok === 'all' || tok === 'flags')
-            continue;
-        out.add(tok);
-    }
-    return out;
-}
-describe('DISPATCH table — D-02 (c) subtask 5', () => {
-    const helpCmds = extractTopLevelCommands();
-    it('extracts ≥40 top-level subcommands from the help baseline (sanity check)', () => {
-        expect(helpCmds.size).toBeGreaterThanOrEqual(40);
-    });
-    for (const cmd of helpCmds) {
-        it(`DISPATCH has an entry for "${cmd}"`, () => {
-            expect(DISPATCH[cmd], `Missing DISPATCH entry for "${cmd}" — every help-listed subcommand must be routable.`).toBeDefined();
-            expect(typeof DISPATCH[cmd]).toBe('function');
-        });
-    }
-    it('every DISPATCH entry has a function value (no orphan keys)', () => {
-        for (const [cmd, handler] of Object.entries(DISPATCH)) {
-            expect(typeof handler, `DISPATCH["${cmd}"] is not a function`).toBe('function');
-        }
-    });
-});
-//# sourceMappingURL=dispatch-table.test.js.map

package/dist/__tests__/dispatch-table.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispatch-table.test.js","sourceRoot":"","sources":["../../src/__tests__/dispatch-table.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE9C,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,oCAAoC,CAAC,CAAA;AAE9E;;;;;;;;GAQG;AACH,SAAS,uBAAuB;IAC/B,MAAM,IAAI,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IACjD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAA;IAC7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,wEAAwE;QACxE,sEAAsE;QACtE,MAAM,CAAC,GAAG,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrD,IAAI,CAAC,CAAC;YAAE,SAAQ;QAChB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAChB,0EAA0E;QAC1E,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO;YAAE,SAAQ;QAC9C,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACb,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACpD,MAAM,QAAQ,GAAG,uBAAuB,EAAE,CAAA;IAE1C,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QACnF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,EAAE,CAAC,8BAA8B,GAAG,GAAG,EAAE,GAAG,EAAE;YAC7C,MAAM,CACL,QAAQ,CAAC,GAAG,CAAC,EACb,+BAA+B,GAAG,oDAAoD,CACtF,CAAC,WAAW,EAAE,CAAA;YACf,MAAM,CAAC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC9C,CAAC,CAAC,CAAA;IACH,CAAC;IAED,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACrE,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,MAAM,CAAC,OAAO,OAAO,EAAE,aAAa,GAAG,sBAAsB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAChF,CAAC;IACF,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/dispatch-wrap.test.d.ts

@@ -1,21 +0,0 @@
-/**
- * dispatch-wrap.test.ts — D-02 (c) wrap() adapter tests (subtask 5,
- * post-S20 shape).
- *
- * Verifies the two happy-path return shapes (JSON envelope, RAW-TEXT) and
- * the ≥7 fail-fast cases for non-conforming shapes — including `undefined`,
- * which used to be the legacy-tolerance branch and is now a hard error
- * (Codex pass 2 revision A + subtask 20).
- *
- * The RAW-TEXT shape was added in subtask 15 (originally planned for
- * subtask 20) so cmds emitting non-JSON content (template, effects list,
- * consistency check --format human, statusline plain, precompact-hook,
- * init TTY mode) can carry an exit code without calling process.exit()
- * inside the cmd body.
- *
- * Strategy: wrap() calls process.exit + process.stdout.write. We use the
- * runCmd harness from D-05 to trap those calls and assert on stdout / the
- * captured exit code.
- */
-export {};
-//# sourceMappingURL=dispatch-wrap.test.d.ts.map

package/dist/__tests__/dispatch-wrap.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispatch-wrap.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dispatch-wrap.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}