@aperant/framework 0.6.2

package/dist/__tests__/integration/smoke-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 './helpers/make-fixture-project';
+import { runCli } from './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=smoke-bootstrap.test.js.map

package/dist/__tests__/integration/smoke-bootstrap.test.js.map

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

package/dist/__tests__/integration/smoke-coverage-check.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * smoke-coverage-check.test.ts — C30 integration coverage for
+ * coverage-check + the deprecated nyquist alias.
+ *
+ * Ports packages/framework/test/coverage-check.test.mjs and
+ * coverage-check-alias.test.mjs to vitest.
+ */
+export {};
+//# sourceMappingURL=smoke-coverage-check.test.d.ts.map

package/dist/__tests__/integration/smoke-coverage-check.test.d.ts.map

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

package/dist/__tests__/integration/smoke-coverage-check.test.js

@@ -0,0 +1,152 @@
+/**
+ * smoke-coverage-check.test.ts — C30 integration coverage for
+ * coverage-check + the deprecated nyquist alias.
+ *
+ * Ports packages/framework/test/coverage-check.test.mjs and
+ * coverage-check-alias.test.mjs to vitest.
+ */
+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 './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=smoke-coverage-check.test.js.map

package/dist/__tests__/integration/smoke-coverage-check.test.js.map

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

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

@@ -0,0 +1,14 @@
+/**
+ * smoke-create-docs.test.ts — C30 integration coverage for the
+ * `create-docs` command (C49).
+ *
+ * Exercises:
+ *   - happy: create-docs plan on a dir with PROJECT.md + personas.json + features registry
+ *     returns a structured envelope with the planned output tree
+ *   - happy: create-docs render-nav materializes docs/product/README.md with tier-grouped TOC
+ *   - error: create-docs without a subcommand exits non-zero with a usage message
+ *   - error: create-docs run on a dir missing the features registry exits non-zero with
+ *     status: needs-scan
+ */
+export {};
+//# sourceMappingURL=smoke-create-docs.test.d.ts.map

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

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

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

@@ -0,0 +1,142 @@
+/**
+ * smoke-create-docs.test.ts — C30 integration coverage for the
+ * `create-docs` command (C49).
+ *
+ * Exercises:
+ *   - happy: create-docs plan on a dir with PROJECT.md + personas.json + features registry
+ *     returns a structured envelope with the planned output tree
+ *   - happy: create-docs render-nav materializes docs/product/README.md with tier-grouped TOC
+ *   - error: create-docs without a subcommand exits non-zero with a usage message
+ *   - error: create-docs run on a dir missing the features registry exits non-zero with
+ *     status: needs-scan
+ */
+import { existsSync, mkdirSync, readFileSync, 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';
+describe('create-docs', () => {
+    let fx;
+    beforeEach(() => {
+        fx = makeFixtureProject({ withState: false, withConfig: false, withGitRepo: false });
+    });
+    afterEach(() => fx.cleanup());
+    function plantInputs() {
+        // PROJECT.md — minimal vision + scope
+        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');
+        // personas.json — one primary, one tertiary
+        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(),
+                },
+                {
+                    id: 'ops',
+                    team_id: 'framework-local',
+                    project_id: 'local:test',
+                    ui_json: JSON.stringify({ name: 'Ops', tier: 'tertiary' }),
+                    origin: 'local-discovery',
+                    source_fingerprint: 'fw:ops:1',
+                    canonical_source: 'local',
+                    local_modified_at: Date.now(),
+                    created_at: Date.now(),
+                    updated_at: Date.now(),
+                },
+            ],
+        }));
+        // features registry — one wired area
+        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('create-docs plan happy: returns structured planned output tree when inputs present', () => {
+        // happy: create-docs plan with all three inputs present
+        plantInputs();
+        const r = runCli(['create-docs', 'plan', fx.root]);
+        expect(r.status).toBe(0);
+        // TST-004: assert plan shape (StructurePlan), not just existence.
+        const parsed = r.json();
+        expect(parsed.command).toBe('create-docs-plan');
+        expect(parsed.plan).toBeDefined();
+        const plan = parsed.plan;
+        // totals: must have numeric area + documentation counts
+        expect(typeof plan.totals.areas).toBe('number');
+        expect(typeof plan.totals.features_documented).toBe('number');
+        // personas: array with id + tier fields
+        expect(Array.isArray(plan.personas)).toBe(true);
+        expect(plan.personas.length).toBeGreaterThan(0);
+        expect(typeof plan.personas[0].tier).toBe('string');
+        // areas: array of area objects with features lists
+        expect(Array.isArray(plan.areas)).toBe(true);
+    });
+    it('create-docs render-nav happy: materializes docs/product/README.md navigation index', () => {
+        // happy: render-nav writes the README.md navigation index
+        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');
+        // Tier-grouped TOC should include the primary persona
+        expect(nav.toLowerCase()).toContain('maya');
+    });
+    it('create-docs error: omitting the subcommand prints a usage message and exits non-zero', () => {
+        // error: no subcommand — dispatcher should reject with usage
+        const r = runCli(['create-docs']);
+        expect(r.status).not.toBe(0);
+        const parsed = r.json();
+        // Accept either a top-level error string or a status:error envelope
+        const errorText = parsed.error ?? parsed.message ?? '';
+        expect(errorText).toMatch(/create-docs|Usage/i);
+    });
+    it('create-docs run error: missing features registry reports status needs-scan', () => {
+        // error: run with PROJECT.md + personas.json but NO features registry.
+        // create-docs cmdRun calls composePlanEnvelope which checks the registry
+        // and emits status:'needs-scan' when it is missing (exits 0 with a
+        // machine-readable envelope, not a hard error exit). We assert the
+        // specific expected status, not a 3-way OR that passes on any crash.
+        writeFileSync(join(fx.root, 'PROJECT.md'), '# Fixture\n\n## What This Is\n\nFixture.\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: [],
+        }));
+        const r = runCli(['create-docs', 'run', fx.root]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed?.command).toBe('create-docs-run');
+        expect(parsed?.status).toBe('needs-scan');
+    });
+});
+//# sourceMappingURL=smoke-create-docs.test.js.map

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

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

package/dist/__tests__/integration/smoke-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=smoke-design-lint.test.d.ts.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * 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 './helpers/make-fixture-project';
+import { runCli } from './helpers/run-cli';
+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=smoke-design-lint.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-design-lint.test.js","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-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,gCAAgC,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE1C,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;AACpF,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__/integration/smoke-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=smoke-design-scan.test.d.ts.map

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

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

package/dist/__tests__/integration/smoke-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 './helpers/make-fixture-project';
+import { runCli } from './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=smoke-design-scan.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-design-scan.test.js","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-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,gCAAgC,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE1C,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__/integration/smoke-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=smoke-design-synthesize.test.d.ts.map

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

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