@aperant/framework 0.6.2

package/dist/__tests__/cli-contract-author-skill.test.js

@@ -0,0 +1,86 @@
+/**
+ * smoke-author-skill.test.ts — C30 integration coverage for the author-skill
+ * command (C4).
+ *
+ * Exercises:
+ *   - happy: author-skill <name> --framework-root <tmpdir> writes SKILL.md
+ *            and a structural test file, returning an ok envelope.
+ *   - error: author-skill invoked with no <name> argument exits non-zero.
+ *   - error: author-skill refuses to overwrite an existing skill dir.
+ *
+ * Uses a per-test tmpdir as the --framework-root so the real framework tree
+ * is never touched.
+ */
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { runCli } from './integration/helpers/run-cli';
+describe('author-skill', () => {
+    let fwRoot;
+    beforeEach(() => {
+        fwRoot = mkdtempSync(join(tmpdir(), 'smoke-author-skill-'));
+        mkdirSync(join(fwRoot, 'skills'), { recursive: true });
+        mkdirSync(join(fwRoot, 'src', '__tests__'), { recursive: true });
+    });
+    afterEach(() => {
+        if (fwRoot && existsSync(fwRoot)) {
+            rmSync(fwRoot, { recursive: true, force: true });
+        }
+    });
+    it('author-skill happy: scaffolds SKILL.md + structural test in a fresh framework root', () => {
+        // happy: author-skill <name> writes SKILL.md + test file, returns ok envelope
+        const r = runCli([
+            'author-skill',
+            'demo',
+            '--description',
+            'demo skill',
+            '--framework-root',
+            fwRoot,
+        ]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('ok');
+        expect(parsed.command).toBe('author-skill');
+        expect(parsed.dry_run).toBe(false);
+        expect(parsed.skill_path).toBe(join(fwRoot, 'skills', 'apt-demo', 'SKILL.md'));
+        expect(parsed.test_path).toBe(join(fwRoot, 'src', '__tests__', 'apt-demo-skill-structure.test.ts'));
+        const skill = readFileSync(parsed.skill_path, 'utf-8');
+        expect(skill).toContain('name: apt:demo');
+        expect(skill).toContain('<objective>');
+        expect(skill).toContain('</objective>');
+        expect(skill).toContain('<process>');
+        const test = readFileSync(parsed.test_path, 'utf-8');
+        expect(test).toContain("describe('apt:demo SKILL.md structure'");
+        expect(test).toContain("'skills/apt-demo/SKILL.md'");
+    });
+    it('author-skill error: fails when name argument is missing', () => {
+        // error: author-skill with no <name> arg exits non-zero with usage
+        const r = runCli(['author-skill']);
+        expect(r.status).not.toBe(0);
+        expect(r.stdout + r.stderr).toMatch(/Usage: apt-tools author-skill/);
+    });
+    it('author-skill error: refuses to overwrite an existing skill dir', () => {
+        // error: second invocation with the same name exits non-zero
+        const first = runCli([
+            'author-skill',
+            'dup',
+            '--description',
+            'first',
+            '--framework-root',
+            fwRoot,
+        ]);
+        expect(first.status).toBe(0);
+        const second = runCli([
+            'author-skill',
+            'dup',
+            '--description',
+            'second',
+            '--framework-root',
+            fwRoot,
+        ]);
+        expect(second.status).not.toBe(0);
+        expect(second.stdout + second.stderr).toMatch(/already exists/);
+    });
+});
+//# sourceMappingURL=cli-contract-author-skill.test.js.map

package/dist/__tests__/cli-contract-author-skill.test.js.map

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

package/dist/__tests__/cli-contract-bootstrap.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * smoke-bootstrap.test.ts — C30 integration coverage for the
+ * `bootstrap` command (C47).
+ *
+ * Exercises:
+ *   - happy: bootstrap detect on an empty dir returns status:ok with mode:greenfield
+ *   - happy: bootstrap run scaffolds PROJECT.md and derives .aperant/product-context.json
+ *   - error: bootstrap without a subcommand exits non-zero with a usage message
+ *   - error: bootstrap derive-sidecar on a dir without PROJECT.md exits non-zero
+ */
+export {};
+//# sourceMappingURL=cli-contract-bootstrap.test.d.ts.map

package/dist/__tests__/cli-contract-bootstrap.test.d.ts.map

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

package/dist/__tests__/cli-contract-bootstrap.test.js

@@ -0,0 +1,68 @@
+/**
+ * smoke-bootstrap.test.ts — C30 integration coverage for the
+ * `bootstrap` command (C47).
+ *
+ * Exercises:
+ *   - happy: bootstrap detect on an empty dir returns status:ok with mode:greenfield
+ *   - happy: bootstrap run scaffolds PROJECT.md and derives .aperant/product-context.json
+ *   - error: bootstrap without a subcommand exits non-zero with a usage message
+ *   - error: bootstrap derive-sidecar on a dir without PROJECT.md exits non-zero
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { makeFixtureProject } from './integration/helpers/make-fixture-project';
+import { runCli } from './integration/helpers/run-cli';
+describe('bootstrap', () => {
+    let fx;
+    beforeEach(() => {
+        // Plain fixture — bootstrap runs against raw project dirs, not initialized ones.
+        fx = makeFixtureProject({ withState: false, withConfig: false, withGitRepo: false });
+    });
+    afterEach(() => fx.cleanup());
+    it('bootstrap detect happy: empty dir classifies as greenfield with mode + signals', () => {
+        // happy: bootstrap detect on a pristine directory
+        const r = runCli(['bootstrap', 'detect', fx.root]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('ok');
+        expect(parsed.command).toBe('bootstrap-detect');
+        expect(parsed.mode).toBe('greenfield');
+        expect(parsed.signals).toBeDefined();
+        expect(parsed.recon).toBeDefined();
+    });
+    it('bootstrap run happy: scaffolds PROJECT.md and derives sidecar in one shot', () => {
+        // happy: bootstrap run end-to-end
+        const r = runCli(['bootstrap', 'run', fx.root]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('ok');
+        expect(parsed.command).toBe('bootstrap-run');
+        expect(parsed.scaffold?.status).toBe('ok');
+        expect(parsed.sidecar?.status).toBe('ok');
+        expect(existsSync(join(fx.root, 'PROJECT.md'))).toBe(true);
+        expect(existsSync(join(fx.root, '.aperant', 'product-context.json'))).toBe(true);
+        // Sidecar is a valid JSON object with required schema fields.
+        const sidecar = JSON.parse(readFileSync(join(fx.root, '.aperant', 'product-context.json'), 'utf-8'));
+        expect(sidecar).toHaveProperty('productName');
+        expect(sidecar).toHaveProperty('productDescription');
+        expect(sidecar).toHaveProperty('targetAudience');
+        expect(sidecar).toHaveProperty('features');
+        expect(sidecar._meta.source).toBe('PROJECT.md');
+    });
+    it('bootstrap error: omitting the subcommand prints a usage message and exits non-zero', () => {
+        // error: no subcommand
+        const r = runCli(['bootstrap']);
+        expect(r.status).not.toBe(0);
+        const parsed = r.json();
+        expect(parsed.error).toMatch(/Usage: apt-tools bootstrap/);
+    });
+    it('bootstrap derive-sidecar error: missing PROJECT.md fails with actionable error', () => {
+        // error: derive-sidecar on a dir without PROJECT.md
+        const r = runCli(['bootstrap', 'derive-sidecar', fx.root]);
+        expect(r.status).not.toBe(0);
+        const parsed = r.json();
+        expect(parsed.error).toMatch(/PROJECT\.md does not exist/);
+    });
+});
+//# sourceMappingURL=cli-contract-bootstrap.test.js.map

package/dist/__tests__/cli-contract-bootstrap.test.js.map

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

package/dist/__tests__/cli-contract-coverage-check.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * cli-contract-coverage-check.test.ts — Layer 2 contract test for
+ * `coverage-check` + the deprecated `nyquist` alias (subtask 13). Migrated
+ * from src/__tests__/integration/smoke-coverage-check.test.ts via `git mv`
+ * so the existing fixture-based subprocess walks (spec.md detection,
+ * task-dir heuristic, nyquist alias) keep their argv parity. Per-branch
+ * Layer 1 coverage moves to cmd-pure/coverage-check.test.ts.
+ */
+export {};
+//# sourceMappingURL=cli-contract-coverage-check.test.d.ts.map

package/dist/__tests__/cli-contract-coverage-check.test.d.ts.map

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

package/dist/__tests__/cli-contract-coverage-check.test.js

@@ -0,0 +1,153 @@
+/**
+ * cli-contract-coverage-check.test.ts — Layer 2 contract test for
+ * `coverage-check` + the deprecated `nyquist` alias (subtask 13). Migrated
+ * from src/__tests__/integration/smoke-coverage-check.test.ts via `git mv`
+ * so the existing fixture-based subprocess walks (spec.md detection,
+ * task-dir heuristic, nyquist alias) keep their argv parity. Per-branch
+ * Layer 1 coverage moves to cmd-pure/coverage-check.test.ts.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { runCli } from './integration/helpers/run-cli';
+function makeSpecFixture() {
+    const dir = mkdtempSync(join(tmpdir(), 'apt-c30-cc-'));
+    const spec = [
+        '# Spec',
+        '',
+        '## Acceptance Criteria',
+        '',
+        '- [ ] User can login',
+        '- [ ] User can logout',
+        '',
+    ].join('\n');
+    writeFileSync(join(dir, 'spec.md'), spec);
+    const plan = {
+        task: 'fixture',
+        subtasks: [
+            {
+                id: '1',
+                title: 'Build login flow',
+                files: ['login.ts'],
+                dependencies: [],
+                status: 'pending',
+                verification: 'pnpm test login',
+            },
+            {
+                id: '2',
+                title: 'Build logout flow',
+                files: ['logout.ts'],
+                dependencies: ['1'],
+                status: 'pending',
+                verification: 'pnpm test logout',
+            },
+        ],
+    };
+    writeFileSync(join(dir, 'implementation_plan.json'), JSON.stringify(plan, null, 2));
+    return dir;
+}
+function makeTaskDirFixture() {
+    const projectRoot = mkdtempSync(join(tmpdir(), 'apt-c30-cc-td-'));
+    const taskDir = join(projectRoot, '.aperant', 'tasks', 'fixture-task');
+    mkdirSync(taskDir, { recursive: true });
+    writeFileSync(join(taskDir, 'spec.md'), ['# Feature', '', '## Acceptance Criteria', '', '1. User can do', '2. User can undo', ''].join('\n'));
+    writeFileSync(join(taskDir, 'implementation_plan.json'), JSON.stringify({
+        task: 'fixture',
+        subtasks: [
+            { id: '1', title: 'do', files: ['do.ts'], dependencies: [], verification: 'test' },
+            { id: '2', title: 'undo', files: ['undo.ts'], dependencies: ['1'], verification: 'test' },
+        ],
+    }));
+    return { projectRoot, taskDir };
+}
+describe('coverage-check', () => {
+    it('coverage-check validate happy: emits command=coverage-validate with valid fixture', () => {
+        // happy: coverage-check validate against a fixture with criteria + subtasks
+        const dir = makeSpecFixture();
+        try {
+            const r = runCli(['coverage-check', 'validate', dir]);
+            expect(r.status).toBe(0);
+            const parsed = r.json();
+            expect(parsed.command).toBe('coverage-validate');
+            expect(['ok', 'incomplete']).toContain(parsed.status);
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    });
+    it('coverage-check validate happy: task-dir heuristic discovers sibling spec.md', () => {
+        // happy: coverage-check validate auto-finds spec.md next to plan
+        const { projectRoot, taskDir } = makeTaskDirFixture();
+        try {
+            const r = runCli([
+                'coverage-check',
+                'validate',
+                projectRoot,
+                '--plan',
+                join(taskDir, 'implementation_plan.json'),
+            ]);
+            expect(r.status).toBe(0);
+            const parsed = r.json();
+            expect(parsed.spec_path).toBe(join(taskDir, 'spec.md'));
+            expect(parsed.criteria_count).toBe(2);
+        }
+        finally {
+            rmSync(projectRoot, { recursive: true, force: true });
+        }
+    });
+    it('coverage-check validate error: zero criteria returns status=incomplete', () => {
+        // error: coverage-check validate with no criteria at all returns incomplete
+        const dir = mkdtempSync(join(tmpdir(), 'apt-c30-cc-empty-'));
+        try {
+            writeFileSync(join(dir, 'implementation_plan.json'), JSON.stringify({ subtasks: [] }));
+            const r = runCli(['coverage-check', 'validate', dir]);
+            expect(r.status).toBe(0);
+            const parsed = r.json();
+            expect(parsed.status).toBe('incomplete');
+            expect(parsed.reason).toBe('no-criteria-found');
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    });
+    it('coverage-check error: unknown subcommand', () => {
+        // error: coverage-check nosuch
+        const dir = mkdtempSync(join(tmpdir(), 'apt-c30-cc-err-'));
+        try {
+            const r = runCli(['coverage-check', 'nosuch', dir]);
+            expect(r.status).not.toBe(0);
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    });
+});
+describe('nyquist (deprecated alias)', () => {
+    it('nyquist happy: still runs and prints deprecation warning', () => {
+        // happy: nyquist validate still works
+        const dir = makeSpecFixture();
+        try {
+            const r = runCli(['nyquist', 'validate', dir]);
+            expect(r.status).toBe(0);
+            const parsed = r.json();
+            expect(parsed.command).toBe('coverage-validate');
+            expect(r.stderr).toMatch(/deprecated/i);
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    });
+    it('nyquist error: unknown subcommand', () => {
+        // error: nyquist nosuch
+        const dir = mkdtempSync(join(tmpdir(), 'apt-c30-ny-err-'));
+        try {
+            const r = runCli(['nyquist', 'nosuch', dir]);
+            expect(r.status).not.toBe(0);
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=cli-contract-coverage-check.test.js.map

package/dist/__tests__/cli-contract-coverage-check.test.js.map

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

package/dist/__tests__/cli-contract-create-docs.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * cli-contract-create-docs.test.ts — Layer 2 subprocess contract for cmdCreateDocs
+ * (renamed from smoke-create-docs.test.ts via `git mv` in subtask 15 — preserves
+ * blame).
+ *
+ * In-process branch coverage for cmdCreateDocs lives in cmd-pure/create-docs.test.ts.
+ * This file retains a slim subprocess test set that gates the argv → JSON
+ * envelope → file-write contract end-to-end (render-nav writes README.md).
+ */
+export {};
+//# sourceMappingURL=cli-contract-create-docs.test.d.ts.map

package/dist/__tests__/cli-contract-create-docs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-contract-create-docs.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cli-contract-create-docs.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/cli-contract-create-docs.test.js

@@ -0,0 +1,75 @@
+/**
+ * cli-contract-create-docs.test.ts — Layer 2 subprocess contract for cmdCreateDocs
+ * (renamed from smoke-create-docs.test.ts via `git mv` in subtask 15 — preserves
+ * blame).
+ *
+ * In-process branch coverage for cmdCreateDocs lives in cmd-pure/create-docs.test.ts.
+ * This file retains a slim subprocess test set that gates the argv → JSON
+ * envelope → file-write contract end-to-end (render-nav writes README.md).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { makeFixtureProject } from './integration/helpers/make-fixture-project';
+import { runCli } from './integration/helpers/run-cli';
+describe('create-docs — CLI contract (subprocess)', () => {
+    let fx;
+    beforeEach(() => {
+        fx = makeFixtureProject({ withState: false, withConfig: false, withGitRepo: false });
+    });
+    afterEach(() => fx.cleanup());
+    function plantInputs() {
+        writeFileSync(join(fx.root, 'PROJECT.md'), '# Fixture Project\n\n## What This Is\n\nA fixture.\n\n## Personas\n\nSee .aperant/personas.json\n');
+        mkdirSync(join(fx.root, '.aperant'), { recursive: true });
+        writeFileSync(join(fx.root, '.aperant', 'personas.json'), JSON.stringify({
+            schema_version: 1,
+            team_id: 'framework-local',
+            project_id: 'local:test',
+            canonical_source: 'local',
+            personas: [
+                {
+                    id: 'maya',
+                    team_id: 'framework-local',
+                    project_id: 'local:test',
+                    ui_json: JSON.stringify({ name: 'Maya', tier: 'primary' }),
+                    origin: 'local-discovery',
+                    source_fingerprint: 'fw:maya:0',
+                    canonical_source: 'local',
+                    local_modified_at: Date.now(),
+                    created_at: Date.now(),
+                    updated_at: Date.now(),
+                },
+            ],
+        }));
+        const featuresDir = join(fx.root, '.aperant', 'features');
+        mkdirSync(featuresDir, { recursive: true });
+        writeFileSync(join(featuresDir, 'REGISTRY.md'), '# Feature Registry\n\nLast scanned: 2026-04-22 (fixture)\n');
+        writeFileSync(join(featuresDir, 'terminals.json'), JSON.stringify({
+            area: 'terminals',
+            route: '/terminal',
+            features: [
+                {
+                    id: 'terminals-spawn',
+                    name: 'Spawn Terminal',
+                    wired: true,
+                    sub_features: [{ id: 'terminals-spawn-cli', name: 'CLI flag', wired: true }],
+                },
+            ],
+        }));
+    }
+    it('argv → JSON envelope → README.md materialized (render-nav happy path)', () => {
+        // One contract assertion: bytes flow argv → spawn → JSON stdout → exit
+        // code, AND the cmd's atomicWriteText side effect lands on disk in the
+        // spawned process. Branch logic lives in cmd-pure/create-docs.test.ts.
+        plantInputs();
+        const r = runCli(['create-docs', 'render-nav', fx.root]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.command).toBe('create-docs-render-nav');
+        expect(parsed.written).toBe(true);
+        expect(existsSync(join(fx.root, 'docs', 'product', 'README.md'))).toBe(true);
+        const nav = readFileSync(join(fx.root, 'docs', 'product', 'README.md'), 'utf-8');
+        expect(nav.toLowerCase()).toContain('maya');
+    });
+});
+//# sourceMappingURL=cli-contract-create-docs.test.js.map

package/dist/__tests__/cli-contract-create-docs.test.js.map

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

package/dist/__tests__/cli-contract-design-lint.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * smoke-design-lint.test.ts — C30 integration coverage for `design-lint`.
+ *
+ * Exercises:
+ *   - happy: point design-lint at a clean HTML file with the scaffold
+ *            DESIGN.md — expect status:ok, zero violations, exit 0.
+ *   - error: a file containing "John Doe" violates the
+ *            no-placeholder-names rule — exit non-zero, violation present.
+ */
+export {};
+//# sourceMappingURL=cli-contract-design-lint.test.d.ts.map

package/dist/__tests__/cli-contract-design-lint.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-contract-design-lint.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cli-contract-design-lint.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/cli-contract-design-lint.test.js

@@ -0,0 +1,48 @@
+/**
+ * smoke-design-lint.test.ts — C30 integration coverage for `design-lint`.
+ *
+ * Exercises:
+ *   - happy: point design-lint at a clean HTML file with the scaffold
+ *            DESIGN.md — expect status:ok, zero violations, exit 0.
+ *   - error: a file containing "John Doe" violates the
+ *            no-placeholder-names rule — exit non-zero, violation present.
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { makeFixtureProject } from './integration/helpers/make-fixture-project';
+import { runCli } from './integration/helpers/run-cli';
+// __dirname is src/__tests__/ (post-S16 git mv from src/__tests__/integration/).
+// SCAFFOLD_PATH is 2 levels up: src → packages/framework → templates/DESIGN.md
+const SCAFFOLD_PATH = resolve(__dirname, '..', '..', 'templates', 'DESIGN.md');
+const SCAFFOLD = readFileSync(SCAFFOLD_PATH, 'utf8');
+describe('design-lint', () => {
+    let fx;
+    beforeEach(() => {
+        fx = makeFixtureProject({ runInit: true });
+    });
+    afterEach(() => fx.cleanup());
+    it('design-lint happy: clean HTML + scaffold DESIGN.md returns status:ok', () => {
+        // happy: clean file with no anti-patterns
+        const designFile = fx.writeFile('DESIGN.md', SCAFFOLD);
+        const target = fx.writeFile('clean.html', '<div>Hello, world.</div>');
+        const r = runCli(['design-lint', '--design-file', designFile, target]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('ok');
+        expect(parsed.command).toBe('design-lint');
+        expect(parsed.violations).toEqual([]);
+        expect(parsed.summary).toMatch(/0 violation/);
+    });
+    it('design-lint error: violating HTML exits non-zero with violations', () => {
+        // error: known anti-pattern (placeholder name) in the target
+        const designFile = fx.writeFile('DESIGN.md', SCAFFOLD);
+        const target = fx.writeFile('bad.html', '<p>Hello, John Doe.</p>');
+        const r = runCli(['design-lint', '--design-file', designFile, target]);
+        expect(r.status).not.toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('error');
+        expect(parsed.violations.some((v) => v.rule_id === 'no-placeholder-names')).toBe(true);
+    });
+});
+//# sourceMappingURL=cli-contract-design-lint.test.js.map

package/dist/__tests__/cli-contract-design-lint.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-contract-design-lint.test.js","sourceRoot":"","sources":["../../src/__tests__/cli-contract-design-lint.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAA;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAA;AAEtD,iFAAiF;AACjF,+EAA+E;AAC/E,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;AAC9E,MAAM,QAAQ,GAAG,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;AAEpD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC5B,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,sEAAsE,EAAE,GAAG,EAAE;QAC/E,0CAA0C;QAC1C,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QACtD,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAA;QACrE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;QACtE,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,aAAa,CAAC,CAAA;QAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC3E,6DAA6D;QAC7D,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QACtD,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAA;QAClE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;QACtE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,EAGjB,CAAA;QACJ,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACvF,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/cli-contract-design-scan.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * smoke-design-scan.test.ts — C30 integration coverage for the design-scan
+ * command (C27).
+ *
+ * Exercises:
+ *   - happy: design-scan on a fixture project writes tokens.json and returns
+ *            a status:ok envelope.
+ *   - error: design-scan invoked with no project-dir argument exits non-zero.
+ */
+export {};
+//# sourceMappingURL=cli-contract-design-scan.test.d.ts.map

package/dist/__tests__/cli-contract-design-scan.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-contract-design-scan.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cli-contract-design-scan.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/cli-contract-design-scan.test.js

@@ -0,0 +1,41 @@
+/**
+ * smoke-design-scan.test.ts — C30 integration coverage for the design-scan
+ * command (C27).
+ *
+ * Exercises:
+ *   - happy: design-scan on a fixture project writes tokens.json and returns
+ *            a status:ok envelope.
+ *   - error: design-scan invoked with no project-dir argument exits non-zero.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { makeFixtureProject } from './integration/helpers/make-fixture-project';
+import { runCli } from './integration/helpers/run-cli';
+describe('design-scan', () => {
+    let fx;
+    beforeEach(() => {
+        fx = makeFixtureProject({ runInit: true });
+    });
+    afterEach(() => fx.cleanup());
+    it('design-scan happy: writes tokens.json and returns an ok envelope', () => {
+        // happy: design-scan <project> with a UI source file present
+        fx.writeFile('Button.tsx', 'export const B = () => <div className="bg-slate-900 p-4">hi</div>');
+        const outPath = join(fx.root, 'tokens.json');
+        const r = runCli(['design-scan', fx.root, '--out', outPath]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('ok');
+        expect(parsed.command).toBe('design-scan');
+        expect(parsed.written).toBe(outPath);
+        const written = JSON.parse(readFileSync(outPath, 'utf-8'));
+        expect(written.version).toBe(1);
+        expect(written.colors.tailwind).toContain('slate-900');
+    });
+    it('design-scan error: missing project-dir argument', () => {
+        // error: design-scan with no args exits non-zero
+        const r = runCli(['design-scan']);
+        expect(r.status).not.toBe(0);
+    });
+});
+//# sourceMappingURL=cli-contract-design-scan.test.js.map

package/dist/__tests__/cli-contract-design-scan.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-contract-design-scan.test.js","sourceRoot":"","sources":["../../src/__tests__/cli-contract-design-scan.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,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,4CAA4C,CAAA;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAA;AAEtD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC5B,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,kEAAkE,EAAE,GAAG,EAAE;QAC3E,6DAA6D;QAC7D,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,mEAAmE,CAAC,CAAA;QAC/F,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QAC5D,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,EAAwD,CAAA;QAC7E,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAC1C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAEpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAGxD,CAAA;QACD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAC1D,iDAAiD;QACjD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,CAAA;QACjC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/cli-contract-design-synthesize.test.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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).
+ */
+export {};
+//# sourceMappingURL=cli-contract-design-synthesize.test.d.ts.map

package/dist/__tests__/cli-contract-design-synthesize.test.d.ts.map

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