@aperant/framework 0.6.2

package/dist/__tests__/integration/smoke-design-synthesize.test.js

@@ -0,0 +1,232 @@
+/**
+ * smoke-design-synthesize.test.ts — principle-#9 SEAM coverage (C44 subtask 5).
+ *
+ * The test is a SEAM test — it proves the plumbing (product_context flows
+ * through the prompt render → llmClient.generateText → validator → result)
+ * works end-to-end. The actual quality of a real model's output is not
+ * enforced here; that's a dogfooding concern (see overview.md §10.6).
+ *
+ * Setup:
+ *   - A: developer-tools product (DevLogs, targetAudience "developers")
+ *   - B: children's-learning product (LearnBuddy, targetAudience "children and parents")
+ *   - shared taste + tokens — the ONLY axis that differs is product_context
+ *
+ * Deterministic fake llmClient:
+ *   Parses the rendered prompt for the productContext slot, detects audience
+ *   keywords, returns a valid DESIGN.md whose tokens.colors.bg + accent +
+ *   typography.scale vary by audience. This proves that differing inputs
+ *   produce differing outputs — the principle-#9 plumbing claim.
+ *
+ * Third run: productContext null (backward compatibility — spec AC #6).
+ */
+import { describe, expect, it } from 'vitest';
+import { parse as parseYaml } from 'yaml';
+import { synthesizeDesignMd } from '../../cli/design/synthesize.mjs';
+import { extractDesignFrontmatter, validateDesignMarkdown } from '../../cli/design/validate.mjs';
+const DEV_CONTEXT = {
+    productName: 'DevLogs',
+    productDescription: 'CLI log analyzer for senior backend engineers.',
+    targetAudience: 'developers',
+    features: [
+        { id: 'regex', name: 'regex filtering', description: 'pattern match' },
+        { id: 'json', name: 'json parsing', description: '' },
+        { id: 'k6', name: 'k6 integration', description: '' },
+    ],
+};
+const KIDS_CONTEXT = {
+    productName: 'LearnBuddy',
+    productDescription: 'Interactive reading app for ages 5-8.',
+    targetAudience: 'children and parents',
+    features: [
+        { id: 'phonics', name: 'phonics games', description: '' },
+        { id: 'library', name: 'storybook library', description: '' },
+        { id: 'badges', name: 'progress badges', description: '' },
+    ],
+};
+const SHARED_TASTE = { direction: 'enterprise-clean', density: 'comfortable' };
+const SHARED_TOKENS = {
+    colors: { bg: '#ffffff', accent: '#7C5CFF' },
+    typography: { scale: ['14px', '16px', '20px'] },
+};
+/**
+ * Build a valid DESIGN.md tailored to the audience declared in the
+ * rendered prompt. This is the deterministic fake — it lets us prove the
+ * plumbing carries product_context through and that different audiences
+ * can produce different frontmatter token values.
+ */
+function buildFakeDesignMd(input) {
+    // Look only inside the `## product_context` slot block so the fixture
+    // doesn't accidentally match the audience keywords that appear in the
+    // static "principle #9 enforcement" system prose. Slot headers are
+    // `## {slot_name}` per the prompt template; the block ends at the next
+    // `## ` heading.
+    const prompt = input.prompt;
+    // Capture from `## product_context\n` up to the next slot header
+    // (`## {slot}` or `# Output contract` — both start at column 0). No $
+    // fallback: without it the non-greedy quantifier honors the explicit
+    // section boundary even across blank lines.
+    const slotMatch = prompt.match(/## product_context\n([\s\S]*?)\n(?:## |# )/);
+    const slotBody = slotMatch?.[1] ?? '';
+    const isChildren = /children/i.test(slotBody);
+    const isDevelopers = /developers/i.test(slotBody);
+    let bg = '#FFFFFF';
+    let accent = '#7C5CFF';
+    let base = '16px';
+    let density = 'comfortable';
+    if (isDevelopers) {
+        bg = '#101014';
+        accent = '#7C5CFF';
+        base = '13px';
+        density = 'dense';
+    }
+    else if (isChildren) {
+        bg = '#FFF9F0';
+        accent = '#FF7A59';
+        base = '18px';
+        density = 'generous';
+    }
+    return `---
+meta:
+  name: "Fake Synthesis Output"
+  version: "0.1.0"
+  updated: "2026-04-19"
+  description: "Deterministic fake for SEAM tests. Audience-driven tokens — ${density}."
+tokens:
+  colors:
+    bg: "${bg}"
+    surface: "#16161D"
+    accent: "${accent}"
+    text: "#F5F5F7"
+    border: "#2A2A32"
+  typography:
+    families:
+      primary: "Inter"
+    scale:
+      - "${base}"
+      - "20px"
+      - "24px"
+  spacing:
+    - "4px"
+    - "8px"
+---
+
+# Design System — Fake
+
+## 2. Color Palette
+
+notes
+
+## 3. Typography
+
+notes
+`;
+}
+describe('design synthesis — principle #9 SEAM (C44)', () => {
+    const fakeClient = {
+        generateText: async (input) => ({
+            text: buildFakeDesignMd(input),
+            model: 'fake-seam-v1',
+        }),
+    };
+    it('developer-tools vs children-learning produce materially different frontmatter tokens', async () => {
+        const [devRes, kidsRes] = await Promise.all([
+            synthesizeDesignMd({
+                productContext: DEV_CONTEXT,
+                taste: SHARED_TASTE,
+                observedTokens: SHARED_TOKENS,
+                referenceDesignMd: null,
+                styleSeed: null,
+                llmClient: fakeClient,
+            }),
+            synthesizeDesignMd({
+                productContext: KIDS_CONTEXT,
+                taste: SHARED_TASTE,
+                observedTokens: SHARED_TOKENS,
+                referenceDesignMd: null,
+                styleSeed: null,
+                llmClient: fakeClient,
+            }),
+        ]);
+        // Both outputs validate clean.
+        expect(validateDesignMarkdown(devRes.text).ok).toBe(true);
+        expect(validateDesignMarkdown(kidsRes.text).ok).toBe(true);
+        // provenance lists product_context as populated in both runs.
+        expect(devRes.provenance.inputs).toContain('product_context');
+        expect(kidsRes.provenance.inputs).toContain('product_context');
+        // Principle #9 claim — audience differs → tokens differ.
+        const devFm = extractDesignFrontmatter(devRes.text);
+        const kidsFm = extractDesignFrontmatter(kidsRes.text);
+        expect(devFm).not.toBeNull();
+        expect(kidsFm).not.toBeNull();
+        if (!devFm || !kidsFm)
+            throw new Error('expected both frontmatters to parse');
+        // At least ONE of {bg, accent, scale[0]} must differ — the plumbing claim.
+        const diffs = [
+            devFm.tokens.colors.bg !== kidsFm.tokens.colors.bg,
+            devFm.tokens.colors.accent !== kidsFm.tokens.colors.accent,
+            devFm.tokens.typography.scale[0] !== kidsFm.tokens.typography.scale[0],
+        ];
+        expect(diffs.some(Boolean)).toBe(true);
+    });
+    it('backward compat: productContext null + taste/tokens still produces a valid DESIGN.md', async () => {
+        const result = await synthesizeDesignMd({
+            productContext: null,
+            taste: SHARED_TASTE,
+            observedTokens: SHARED_TOKENS,
+            referenceDesignMd: null,
+            styleSeed: null,
+            llmClient: fakeClient,
+        });
+        expect(validateDesignMarkdown(result.text).ok).toBe(true);
+        // product_context is NOT in the populated inputs list for this run.
+        expect(result.provenance.inputs).not.toContain('product_context');
+        // taste and observed_tokens ARE.
+        expect(result.provenance.inputs).toContain('taste');
+        expect(result.provenance.inputs).toContain('observed_tokens');
+    });
+    it('prompt actually carries product_context through to the client (no silent drop)', async () => {
+        let capturedPrompt = '';
+        const capturingClient = {
+            generateText: async (input) => {
+                capturedPrompt = input.prompt;
+                return { text: buildFakeDesignMd(input), model: 'capturing' };
+            },
+        };
+        await synthesizeDesignMd({
+            productContext: DEV_CONTEXT,
+            taste: SHARED_TASTE,
+            observedTokens: SHARED_TOKENS,
+            referenceDesignMd: null,
+            styleSeed: null,
+            llmClient: capturingClient,
+        });
+        // Seeing the product name + audience in the rendered prompt proves the
+        // slot-fill pipeline is wiring product_context in (not silently
+        // dropping it like an upstream bug would).
+        expect(capturedPrompt).toContain('DevLogs');
+        expect(capturedPrompt).toContain('developers');
+        // And (not provided) holds for the unpopulated slots.
+        expect(capturedPrompt).toContain('(not provided)');
+    });
+    it('frontmatter parses as YAML and contains the declared audience-driven differences', async () => {
+        // Defense in depth: make sure the test helper is actually exercising
+        // the two branches it claims to exercise. We hand-build prompts that
+        // mimic the `## product_context\n{...}` slot shape the template emits.
+        const dev = buildFakeDesignMd({
+            system: '',
+            prompt: '## product_context\n{"targetAudience": "developers"}\n\n## taste\nsomething',
+        });
+        const kids = buildFakeDesignMd({
+            system: '',
+            prompt: '## product_context\n{"targetAudience": "children"}\n\n## taste\nsomething',
+        });
+        const devFm = extractDesignFrontmatter(dev);
+        const kidsFm = extractDesignFrontmatter(kids);
+        expect(devFm.tokens.colors.bg).not.toBe(kidsFm.tokens.colors.bg);
+        expect(devFm.tokens.typography.scale[0]).not.toBe(kidsFm.tokens.typography.scale[0]);
+        // Belt-and-suspenders: the parsed frontmatter matches a fresh parse.
+        const reparsed = parseYaml(dev.match(/^---\n([\s\S]*?)\n---\n/)?.[1] ?? '');
+        expect(reparsed.tokens.colors.bg).toBe(devFm.tokens.colors.bg);
+    });
+});
+//# sourceMappingURL=smoke-design-synthesize.test.js.map

package/dist/__tests__/integration/smoke-design-synthesize.test.js.map

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

package/dist/__tests__/integration/smoke-design-template.test.d.ts

@@ -0,0 +1,23 @@
+/**
+ * smoke-design-template.test.ts — C42 integration coverage for the four
+ * `apt-tools design-template` subcommands.
+ *
+ * Mirrors the shape of smoke-design-validate.test.ts. Each case spawns the
+ * real CLI via runCli and asserts on the JSON envelope + exit code.
+ *
+ * Cases (spec R5):
+ *   1. list happy: returns status:ok, count >= 60, includes apple/linear/
+ *      vercel/paper/bento
+ *   2. show happy: show apple returns status:ok + frontmatter.meta.name
+ *   3. show error: show <bad-slug> exits non-zero with status:error
+ *   4. add happy: add paper --project-dir <tmp> writes DESIGN.md + the
+ *      file passes a follow-up design-validate
+ *   5. add error: second add without --force returns status:error, exit 1
+ *   6. add force: second add with --force succeeds (overwritten: true)
+ *   7. submit error: invalid candidate returns status:error; fixture library
+ *      dir stays empty of the new slug
+ *   8. submit happy: valid candidate copied into fixture library dir,
+ *      envelope returns slug + copied_to + provenance_path
+ */
+export {};
+//# sourceMappingURL=smoke-design-template.test.d.ts.map

package/dist/__tests__/integration/smoke-design-template.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-design-template.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-design-template.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/__tests__/integration/smoke-design-template.test.js

@@ -0,0 +1,203 @@
+/**
+ * smoke-design-template.test.ts — C42 integration coverage for the four
+ * `apt-tools design-template` subcommands.
+ *
+ * Mirrors the shape of smoke-design-validate.test.ts. Each case spawns the
+ * real CLI via runCli and asserts on the JSON envelope + exit code.
+ *
+ * Cases (spec R5):
+ *   1. list happy: returns status:ok, count >= 60, includes apple/linear/
+ *      vercel/paper/bento
+ *   2. show happy: show apple returns status:ok + frontmatter.meta.name
+ *   3. show error: show <bad-slug> exits non-zero with status:error
+ *   4. add happy: add paper --project-dir <tmp> writes DESIGN.md + the
+ *      file passes a follow-up design-validate
+ *   5. add error: second add without --force returns status:error, exit 1
+ *   6. add force: second add with --force succeeds (overwritten: true)
+ *   7. submit error: invalid candidate returns status:error; fixture library
+ *      dir stays empty of the new slug
+ *   8. submit happy: valid candidate copied into fixture library dir,
+ *      envelope returns slug + copied_to + provenance_path
+ */
+import { copyFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join, resolve as resolvePath } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { makeFixtureProject } from './helpers/make-fixture-project';
+import { runCli } from './helpers/run-cli';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// __dirname → packages/framework/src/__tests__/integration/ → ../../../templates/design-library
+const REPO_LIBRARY_DIR = resolvePath(__dirname, '..', '..', '..', 'templates', 'design-library');
+/** A tmpdir containing 2-3 copied library entries — hermetic for submit tests. */
+function makeFixtureLibrary(slugs) {
+    const root = mkdtempSync(join(tmpdir(), 'apt-c42-smoke-'));
+    for (const slug of slugs) {
+        const src = resolvePath(REPO_LIBRARY_DIR, slug);
+        const dst = resolvePath(root, slug);
+        mkdirSync(dst, { recursive: true });
+        copyFileSync(resolvePath(src, 'DESIGN.md'), resolvePath(dst, 'DESIGN.md'));
+        if (existsSync(resolvePath(src, 'provenance.yaml'))) {
+            copyFileSync(resolvePath(src, 'provenance.yaml'), resolvePath(dst, 'provenance.yaml'));
+        }
+    }
+    return {
+        root,
+        cleanup: () => {
+            try {
+                rmSync(root, { recursive: true, force: true });
+            }
+            catch {
+                /* best-effort */
+            }
+        },
+    };
+}
+describe('design-template CLI', () => {
+    let fx;
+    beforeEach(() => {
+        fx = makeFixtureProject({ runInit: true });
+    });
+    afterEach(() => fx.cleanup());
+    it('list happy: status:ok, count >= 60, includes apple/linear/vercel/paper/bento', () => {
+        // Default library-dir resolves to the shipped templates/design-library
+        const r = runCli(['design-template', 'list']);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('ok');
+        expect(parsed.command).toBe('design-template');
+        expect(parsed.count).toBeGreaterThanOrEqual(60);
+        const slugs = parsed.entries.map((e) => e.slug);
+        expect(slugs).toContain('apple');
+        expect(slugs).toContain('linear');
+        expect(slugs).toContain('vercel');
+        expect(slugs).toContain('paper');
+        expect(slugs).toContain('bento');
+        const apple = parsed.entries.find((e) => e.slug === 'apple');
+        expect(apple?.origin).toBe('first-party');
+    });
+    it('show happy: apple returns status:ok + frontmatter.meta.name', () => {
+        const r = runCli(['design-template', 'show', 'apple']);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('ok');
+        expect(parsed.slug).toBe('apple');
+        expect(parsed.frontmatter.meta.name).toBeTruthy();
+        expect(parsed.provenance.origin).toBe('first-party');
+    });
+    it('show error: bad slug exits non-zero with status:error', () => {
+        const r = runCli(['design-template', 'show', 'not-a-real-slug']);
+        expect(r.status).not.toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('error');
+        expect(parsed.error).toMatch(/not-a-real-slug|not found/);
+    });
+    it('add happy: creates DESIGN.md that passes a follow-up design-validate', () => {
+        const target = join(fx.root, 'sub');
+        const r = runCli(['design-template', 'add', 'paper', '--project-dir', target]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('ok');
+        expect(parsed.overwritten).toBe(false);
+        expect(existsSync(parsed.to)).toBe(true);
+        // follow-up: design-validate on the generated file
+        const v = runCli(['design-validate', parsed.to]);
+        expect(v.status).toBe(0);
+    });
+    it('add error: second call without --force returns status:error', () => {
+        const target = join(fx.root, 'sub2');
+        runCli(['design-template', 'add', 'paper', '--project-dir', target]);
+        const r2 = runCli(['design-template', 'add', 'paper', '--project-dir', target]);
+        expect(r2.status).not.toBe(0);
+        const parsed = r2.json();
+        expect(parsed.status).toBe('error');
+        expect(parsed.code).toBe('EEXIST_DEST');
+    });
+    it('add force: second call with --force succeeds with overwritten:true', () => {
+        const target = join(fx.root, 'sub3');
+        runCli(['design-template', 'add', 'paper', '--project-dir', target]);
+        const r2 = runCli(['design-template', 'add', 'paper', '--project-dir', target, '--force']);
+        expect(r2.status).toBe(0);
+        const parsed = r2.json();
+        expect(parsed.status).toBe('ok');
+        expect(parsed.overwritten).toBe(true);
+    });
+    it('submit error: invalid candidate DESIGN.md returns status:error and does NOT copy', () => {
+        const fxLib = makeFixtureLibrary(['paper']);
+        try {
+            const candPath = join(fx.root, 'candidate.md');
+            const INVALID = [
+                '---',
+                'meta:',
+                '  name: "Bad"',
+                '  version: "0.1.0"',
+                '  updated: "2026-04-19"',
+                'tokens:',
+                '  colors:',
+                '    bg: "#000"',
+                '    surface: "#111"',
+                // intentionally missing accent
+                '    text: "#FFF"',
+                '    border: "#222"',
+                '  typography:',
+                '    families:',
+                '      primary: "Inter"',
+                '    scale: ["14px", "16px", "20px"]',
+                '  spacing: ["4px", "8px"]',
+                '---',
+                '',
+                '# bad',
+            ].join('\n');
+            writeFileSync(candPath, INVALID);
+            const r = runCli([
+                'design-template',
+                'submit',
+                candPath,
+                '--as',
+                'baddie',
+                '--library-dir',
+                fxLib.root,
+            ]);
+            expect(r.status).not.toBe(0);
+            const parsed = r.json();
+            expect(parsed.status).toBe('error');
+            expect(parsed.error).toMatch(/validation/i);
+            expect(parsed.validation_errors?.some((e) => e.includes('accent'))).toBe(true);
+            // Fixture library dir never grew a `baddie` slug
+            expect(existsSync(join(fxLib.root, 'baddie'))).toBe(false);
+        }
+        finally {
+            fxLib.cleanup();
+        }
+    });
+    it('submit happy: valid candidate copied into the fixture library dir', () => {
+        const fxLib = makeFixtureLibrary(['paper']);
+        try {
+            const candPath = join(fx.root, 'candidate.md');
+            const VALID = readFileSync(resolvePath(REPO_LIBRARY_DIR, 'paper', 'DESIGN.md'), 'utf8');
+            writeFileSync(candPath, VALID);
+            const r = runCli([
+                'design-template',
+                'submit',
+                candPath,
+                '--as',
+                'community-paper',
+                '--library-dir',
+                fxLib.root,
+            ]);
+            expect(r.status).toBe(0);
+            const parsed = r.json();
+            expect(parsed.status).toBe('ok');
+            expect(parsed.slug).toBe('community-paper');
+            expect(existsSync(parsed.copied_to)).toBe(true);
+            expect(existsSync(parsed.provenance_path)).toBe(true);
+            const prov = readFileSync(parsed.provenance_path, 'utf8');
+            expect(prov).toMatch(/origin:\s*community/);
+        }
+        finally {
+            fxLib.cleanup();
+        }
+    });
+});
+//# sourceMappingURL=smoke-design-template.test.js.map

package/dist/__tests__/integration/smoke-design-template.test.js.map

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

package/dist/__tests__/integration/smoke-design-validate.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * smoke-design-validate.test.ts — C30 integration coverage for the
+ * design-validate command (C2).
+ *
+ * Exercises:
+ *   - happy: design-validate on a valid DESIGN.md returns a status:ok envelope
+ *            with zero errors.
+ *   - error: design-validate on a DESIGN.md with missing tokens.colors.accent
+ *            exits non-zero and reports the schema violation.
+ */
+export {};
+//# sourceMappingURL=smoke-design-validate.test.d.ts.map

package/dist/__tests__/integration/smoke-design-validate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-design-validate.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-design-validate.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

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

@@ -0,0 +1,98 @@
+/**
+ * smoke-design-validate.test.ts — C30 integration coverage for the
+ * design-validate command (C2).
+ *
+ * Exercises:
+ *   - happy: design-validate on a valid DESIGN.md returns a status:ok envelope
+ *            with zero errors.
+ *   - error: design-validate on a DESIGN.md with missing tokens.colors.accent
+ *            exits non-zero and reports the schema violation.
+ */
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { makeFixtureProject } from './helpers/make-fixture-project';
+import { runCli } from './helpers/run-cli';
+const VALID_DESIGN = `---
+meta:
+  name: "Fixture"
+  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 — Fixture
+
+## 2. Color Palette
+
+notes
+
+## 3. Typography
+
+notes
+`;
+const INVALID_DESIGN = `---
+meta:
+  name: "Fixture"
+  version: "0.1.0"
+  updated: "2026-04-16"
+tokens:
+  colors:
+    bg: "#000000"
+    surface: "#111111"
+    text: "#FFFFFF"
+    border: "#222222"
+  typography:
+    families:
+      primary: "Inter"
+    scale: ["14px", "16px", "20px"]
+  spacing: ["4px", "8px"]
+---
+
+# Design System — Fixture
+`;
+describe('design-validate', () => {
+    let fx;
+    beforeEach(() => {
+        fx = makeFixtureProject({ runInit: true });
+    });
+    afterEach(() => fx.cleanup());
+    it('design-validate happy: valid DESIGN.md returns status:ok with zero errors', () => {
+        // happy: design-validate on a schema-compliant DESIGN.md
+        const target = join(fx.root, 'DESIGN.md');
+        writeFileSync(target, VALID_DESIGN, 'utf8');
+        const r = runCli(['design-validate', target]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('ok');
+        expect(parsed.command).toBe('design-validate');
+        expect(parsed.errors).toEqual([]);
+    });
+    it('design-validate error: DESIGN.md missing tokens.colors.accent exits non-zero', () => {
+        // error: design-validate on a DESIGN.md that's missing a required field
+        const target = join(fx.root, 'DESIGN.md');
+        writeFileSync(target, INVALID_DESIGN, 'utf8');
+        const r = runCli(['design-validate', target]);
+        expect(r.status).not.toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('error');
+        expect(parsed.errors.some((e) => e.includes('tokens.colors.accent'))).toBe(true);
+    });
+});
+//# sourceMappingURL=smoke-design-validate.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-design-validate.test.js","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-design-validate.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE1C,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCpB,CAAA;AAED,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;CAmBtB,CAAA;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAChC,IAAI,EAAyC,CAAA;IAC7C,UAAU,CAAC,GAAG,EAAE;QACf,EAAE,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IACF,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;IAE7B,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACpF,yDAAyD;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;QACzC,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;QAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAA;QAC7C,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,EAKjB,CAAA;QACJ,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACvF,wEAAwE;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;QACzC,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,CAAA;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAA;QAC7C,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,EAAwC,CAAA;QAC7D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/integration/smoke-docs-audit.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * smoke-docs-audit.test.ts — C30 integration coverage for `apt-tools docs-audit` (C33).
+ */
+export {};
+//# sourceMappingURL=smoke-docs-audit.test.d.ts.map

package/dist/__tests__/integration/smoke-docs-audit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-docs-audit.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-docs-audit.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/integration/smoke-docs-audit.test.js

@@ -0,0 +1,28 @@
+/**
+ * smoke-docs-audit.test.ts — C30 integration coverage for `apt-tools docs-audit` (C33).
+ */
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { makeFixtureProject } from './helpers/make-fixture-project';
+import { runCli } from './helpers/run-cli';
+describe('docs-audit', () => {
+    let fx;
+    beforeEach(() => {
+        fx = makeFixtureProject({ runInit: true });
+    });
+    afterEach(() => fx.cleanup());
+    it('docs-audit happy: returns ok on a clean tree', () => {
+        // happy: docs-audit with --dry-run returns empty findings/patch_plan
+        const r = runCli(['docs-audit', fx.root, '--dry-run', '--format', 'json']);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('ok');
+        expect(Array.isArray(parsed.findings)).toBe(true);
+        expect(Array.isArray(parsed.patch_plan)).toBe(true);
+    });
+    it('docs-audit error: rejects missing project-dir argument', () => {
+        // error: docs-audit without a project dir
+        const r = runCli(['docs-audit']);
+        expect(r.status).not.toBe(0);
+    });
+});
+//# sourceMappingURL=smoke-docs-audit.test.js.map

package/dist/__tests__/integration/smoke-docs-audit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-docs-audit.test.js","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-docs-audit.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE1C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC3B,IAAI,EAAyC,CAAA;IAC7C,UAAU,CAAC,GAAG,EAAE;QACf,EAAE,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IACF,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;IAE7B,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACvD,qEAAqE;QACrE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;QAC1E,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,EAAkE,CAAA;QACvF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QACjE,0CAA0C;QAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAA;QAChC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}