@aperant/framework 0.6.2

package/dist/__tests__/audit-privacy.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * C35 — apt-tools audit privacy + visibility-signals tests.
+ *
+ * Covers:
+ *   (a) privacy on a clean repo (no tracked .aperant/) → status=ok, exit 0.
+ *   (b) privacy with tracked team.json under policy=solo → violation with
+ *       share.team.roster=false reason + untrackCommand, exit 2.
+ *   (c) privacy with tracked tasks/42/spec.md under policy=team → violation
+ *       (share.tasks=false).
+ *   (d) --scrub adds scrub.command + checklist + warning; never runs
+ *       filter-repo.
+ *   (e) visibility-signals on a repo with public origin + team config →
+ *       publicRemote.isPublic=true, teamEnabled=true, digestsEnabled=true.
+ *   (f) visibility-signals flags bypassedByShare when a gitignore allow rule
+ *       is not authorized by the current policy.
+ */
+export {};
+//# sourceMappingURL=audit-privacy.test.d.ts.map

package/dist/__tests__/audit-privacy.test.d.ts.map

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

package/dist/__tests__/audit-privacy.test.js

@@ -0,0 +1,152 @@
+/**
+ * C35 — apt-tools audit privacy + visibility-signals tests.
+ *
+ * Covers:
+ *   (a) privacy on a clean repo (no tracked .aperant/) → status=ok, exit 0.
+ *   (b) privacy with tracked team.json under policy=solo → violation with
+ *       share.team.roster=false reason + untrackCommand, exit 2.
+ *   (c) privacy with tracked tasks/42/spec.md under policy=team → violation
+ *       (share.tasks=false).
+ *   (d) --scrub adds scrub.command + checklist + warning; never runs
+ *       filter-repo.
+ *   (e) visibility-signals on a repo with public origin + team config →
+ *       publicRemote.isPublic=true, teamEnabled=true, digestsEnabled=true.
+ *   (f) visibility-signals flags bypassedByShare when a gitignore allow rule
+ *       is not authorized by the current policy.
+ */
+import { execFileSync, spawnSync } from 'node:child_process';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { describe, expect, it } from 'vitest';
+const APT_TOOLS = resolve(__dirname, '..', '..', 'bin', 'apt-tools.mjs');
+function makeRepo() {
+    const dir = mkdtempSync(join(tmpdir(), 'apt-audit-'));
+    execFileSync('git', ['init', '-q'], { cwd: dir });
+    execFileSync('git', ['config', 'user.email', 't@t.t'], { cwd: dir });
+    execFileSync('git', ['config', 'user.name', 't'], { cwd: dir });
+    mkdirSync(join(dir, '.aperant'), { recursive: true });
+    return dir;
+}
+function runAudit(dir, args) {
+    // apt-tools audit <subcommand> <project-dir> [flags]
+    const [subcommand, ...extra] = args;
+    const result = spawnSync('node', [APT_TOOLS, 'audit', subcommand, dir, ...extra], {
+        encoding: 'utf-8',
+    });
+    return { stdout: result.stdout, exitCode: result.status ?? -1 };
+}
+describe('C35 — audit privacy', () => {
+    it('returns status=ok and exit 0 on a clean repo', () => {
+        const dir = makeRepo();
+        const { stdout, exitCode } = runAudit(dir, ['privacy']);
+        const parsed = JSON.parse(stdout);
+        expect(parsed.status).toBe('ok');
+        expect(parsed.violations).toEqual([]);
+        expect(parsed.untrackCommand).toBe(null);
+        expect(exitCode).toBe(0);
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('reports violation + exit 2 when team.json is tracked under policy=solo', () => {
+        const dir = makeRepo();
+        writeFileSync(join(dir, '.aperant', 'team.json'), '{"enabled": true}');
+        execFileSync('git', ['add', '-f', '.aperant/team.json'], { cwd: dir });
+        execFileSync('git', ['commit', '-m', 'seed', '-q'], { cwd: dir });
+        const { stdout, exitCode } = runAudit(dir, ['privacy']);
+        const parsed = JSON.parse(stdout);
+        expect(parsed.status).toBe('violations-found');
+        expect(parsed.violations).toContainEqual(expect.objectContaining({
+            path: '.aperant/team.json',
+            reason: 'share.team.roster=false',
+            class: 'shared-source',
+        }));
+        expect(parsed.untrackCommand).toContain('git rm --cached');
+        expect(parsed.untrackCommand).toContain('.aperant/team.json');
+        expect(exitCode).toBe(2);
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('reports violation for tasks/*/spec.md under policy=team (share.tasks=false)', () => {
+        const dir = makeRepo();
+        mkdirSync(join(dir, '.aperant', 'tasks', '42'), { recursive: true });
+        writeFileSync(join(dir, '.aperant', 'tasks', '42', 'spec.md'), '# spec');
+        writeFileSync(join(dir, '.aperant', 'config.json'), JSON.stringify({ share: { visibility: 'team' } }));
+        execFileSync('git', ['add', '-f', '.aperant/tasks/42/spec.md'], { cwd: dir });
+        execFileSync('git', ['commit', '-m', 'seed', '-q'], { cwd: dir });
+        const { stdout, exitCode } = runAudit(dir, ['privacy']);
+        const parsed = JSON.parse(stdout);
+        expect(parsed.policy.visibility).toBe('team');
+        expect(parsed.violations).toContainEqual(expect.objectContaining({
+            path: '.aperant/tasks/42/spec.md',
+            reason: 'share.tasks=false',
+            class: 'shared-source',
+        }));
+        expect(exitCode).toBe(2);
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('--scrub adds filter-repo command + checklist + warning, never executes', () => {
+        const dir = makeRepo();
+        writeFileSync(join(dir, '.aperant', 'team.json'), '{}');
+        execFileSync('git', ['add', '-f', '.aperant/team.json'], { cwd: dir });
+        execFileSync('git', ['commit', '-m', 'seed', '-q'], { cwd: dir });
+        const { stdout, exitCode } = runAudit(dir, ['privacy', '--scrub']);
+        const parsed = JSON.parse(stdout);
+        expect(parsed.scrub).toBeTruthy();
+        expect(parsed.scrub.command).toContain('git filter-repo');
+        expect(parsed.scrub.command).toContain('--invert-paths');
+        expect(parsed.scrub.command).toContain('.aperant/team.json');
+        expect(parsed.scrub.checklist.length).toBeGreaterThan(3);
+        expect(parsed.scrub.warning.toLowerCase()).toContain('destructive');
+        expect(exitCode).toBe(2);
+        // Repo history still intact — filter-repo never ran.
+        const log = execFileSync('git', ['log', '--oneline'], { cwd: dir, encoding: 'utf-8' });
+        expect(log).toContain('seed');
+        rmSync(dir, { recursive: true, force: true });
+    });
+});
+describe('C35 — audit visibility-signals', () => {
+    it('returns the documented JSON shape with digestsEnabled + public remote', () => {
+        const dir = makeRepo();
+        execFileSync('git', ['remote', 'add', 'origin', 'https://github.com/acme/x.git'], {
+            cwd: dir,
+        });
+        writeFileSync(join(dir, '.aperant', 'config.json'), JSON.stringify({
+            share: { visibility: 'team' },
+            digests: { enabled: true },
+        }));
+        writeFileSync(join(dir, '.aperant', 'team.json'), '{"enabled": true}');
+        writeFileSync(join(dir, '.aperant', '.gitignore'), '*\n!team.json\n!roadmap/\n');
+        const { stdout, exitCode } = runAudit(dir, ['visibility-signals']);
+        const parsed = JSON.parse(stdout);
+        expect(exitCode).toBe(0);
+        expect(parsed.status).toBe('ok');
+        expect(parsed.publicRemote.isPublic).toBe(true);
+        expect(parsed.publicRemote.host).toBe('github.com');
+        expect(parsed.teamEnabled).toBe(true);
+        expect(parsed.digestsEnabled).toBe(true);
+        expect(parsed.currentPolicy.visibility).toBe('team');
+        expect(parsed.existingGitignore.exists).toBe(true);
+        expect(parsed.existingGitignore.allowsAny).toContain('!team.json');
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('flags bypassedByShare when a gitignore allow rule is not authorized by policy', () => {
+        const dir = makeRepo();
+        // Solo policy — default — but the gitignore allows team.json.
+        writeFileSync(join(dir, '.aperant', 'config.json'), JSON.stringify({}));
+        writeFileSync(join(dir, '.aperant', '.gitignore'), '*\n!team.json\n!decisions/\n');
+        const { stdout } = runAudit(dir, ['visibility-signals']);
+        const parsed = JSON.parse(stdout);
+        const bypassed = parsed.existingGitignore.bypassedByShare.map((b) => b.rule);
+        expect(bypassed).toContain('!team.json');
+        expect(bypassed).toContain('!decisions/');
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('returns isPublic=false when no remote is configured', () => {
+        const dir = makeRepo();
+        const { stdout } = runAudit(dir, ['visibility-signals']);
+        const parsed = JSON.parse(stdout);
+        expect(parsed.publicRemote.isPublic).toBe(false);
+        expect(parsed.publicRemote.url).toBe(null);
+        rmSync(dir, { recursive: true, force: true });
+    });
+});
+//# sourceMappingURL=audit-privacy.test.js.map

package/dist/__tests__/audit-privacy.test.js.map

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

package/dist/__tests__/bin-path-resolve.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * bin-path-resolve.test.ts — D-03 backward-compat unit test.
+ *
+ * Verifies the 5-step fallback chain in `resolveAptToolsBin(projectDir)` per
+ * spec §6 subtask 4. Each scenario uses an isolated tmp dir + cleanup; no
+ * test pollutes the real workspace.
+ */
+export {};
+//# sourceMappingURL=bin-path-resolve.test.d.ts.map

package/dist/__tests__/bin-path-resolve.test.d.ts.map

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

package/dist/__tests__/bin-path-resolve.test.js

@@ -0,0 +1,76 @@
+/**
+ * bin-path-resolve.test.ts — D-03 backward-compat unit test.
+ *
+ * Verifies the 5-step fallback chain in `resolveAptToolsBin(projectDir)` per
+ * spec §6 subtask 4. Each scenario uses an isolated tmp dir + cleanup; no
+ * test pollutes the real workspace.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { resolveAptToolsBin } from '../cli/util/bin-path.mjs';
+describe('resolveAptToolsBin — D-03 5-step fallback chain', () => {
+    const SAVED_OVERRIDE = process.env.APT_TOOLS_BIN_PATH;
+    let tmpRoot;
+    beforeEach(() => {
+        // Always clear the env override at the start of each test; individual
+        // cases that exercise it set it inside the test body and the afterEach
+        // restores the saved value on teardown.
+        delete process.env.APT_TOOLS_BIN_PATH;
+        tmpRoot = mkdtempSync(join(tmpdir(), 'apt-bin-path-'));
+    });
+    afterEach(() => {
+        try {
+            rmSync(tmpRoot, { recursive: true, force: true });
+        }
+        catch {
+            /* best-effort */
+        }
+        if (SAVED_OVERRIDE === undefined)
+            delete process.env.APT_TOOLS_BIN_PATH;
+        else
+            process.env.APT_TOOLS_BIN_PATH = SAVED_OVERRIDE;
+    });
+    it('MONOREPO — returns the in-tree apt-tools.mjs when packages/framework/bin/ exists', () => {
+        const monorepoBin = join(tmpRoot, 'packages', 'framework', 'bin', 'apt-tools.mjs');
+        mkdirSync(join(tmpRoot, 'packages', 'framework', 'bin'), { recursive: true });
+        writeFileSync(monorepoBin, '#!/usr/bin/env node\n');
+        // process.argv[1] in vitest is NOT apt-tools.mjs, so step 2 is skipped
+        // and step 3 (monorepo) wins.
+        const got = resolveAptToolsBin(tmpRoot);
+        expect(got).toBe(resolve(monorepoBin));
+    });
+    it('CONSUMER INSTALL — returns .aperant/deps path when monorepo path absent', () => {
+        const consumerBin = join(tmpRoot, '.aperant', 'deps', 'node_modules', '@aperant', 'framework', 'bin', 'apt-tools.mjs');
+        mkdirSync(join(tmpRoot, '.aperant', 'deps', 'node_modules', '@aperant', 'framework', 'bin'), {
+            recursive: true,
+        });
+        writeFileSync(consumerBin, '#!/usr/bin/env node\n');
+        const got = resolveAptToolsBin(tmpRoot);
+        expect(got).toBe(resolve(consumerBin));
+    });
+    it("PATH FALLBACK — returns the literal 'apt-tools' when no path resolves", () => {
+        // tmpRoot is empty; neither monorepo nor consumer-install path exists;
+        // argv[1] under vitest does not end with apt-tools.mjs.
+        const got = resolveAptToolsBin(tmpRoot);
+        expect(got).toBe('apt-tools');
+    });
+    it('ENV OVERRIDE — APT_TOOLS_BIN_PATH wins regardless of which other paths exist', () => {
+        // Even with the monorepo path present, the env override takes precedence.
+        const monorepoBin = join(tmpRoot, 'packages', 'framework', 'bin', 'apt-tools.mjs');
+        mkdirSync(join(tmpRoot, 'packages', 'framework', 'bin'), { recursive: true });
+        writeFileSync(monorepoBin, '#!/usr/bin/env node\n');
+        process.env.APT_TOOLS_BIN_PATH = '/x/y/z';
+        expect(resolveAptToolsBin(tmpRoot)).toBe('/x/y/z');
+    });
+    it('ENV OVERRIDE — empty-string is treated as not-set (falls through to next step)', () => {
+        const monorepoBin = join(tmpRoot, 'packages', 'framework', 'bin', 'apt-tools.mjs');
+        mkdirSync(join(tmpRoot, 'packages', 'framework', 'bin'), { recursive: true });
+        writeFileSync(monorepoBin, '#!/usr/bin/env node\n');
+        process.env.APT_TOOLS_BIN_PATH = '';
+        // Empty override is ignored; monorepo wins.
+        expect(resolveAptToolsBin(tmpRoot)).toBe(resolve(monorepoBin));
+    });
+});
+//# sourceMappingURL=bin-path-resolve.test.js.map

package/dist/__tests__/bin-path-resolve.test.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * bootstrap-cli.test.ts — end-to-end smoke coverage for the
+ * `apt-tools bootstrap` CLI command (C47).
+ *
+ * Spawns the real CLI entrypoint via node + bin/apt-tools.mjs in a tmp dir
+ * and asserts the JSON envelope. This catches registration drift
+ * (dispatcher case wired) + real I/O behavior (atomic write lands the
+ * sidecar) + subcommand contracts.
+ */
+export {};
+//# sourceMappingURL=bootstrap-cli.test.d.ts.map

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

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

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

@@ -0,0 +1,181 @@
+/**
+ * bootstrap-cli.test.ts — end-to-end smoke coverage for the
+ * `apt-tools bootstrap` CLI command (C47).
+ *
+ * Spawns the real CLI entrypoint via node + bin/apt-tools.mjs in a tmp dir
+ * and asserts the JSON envelope. This catches registration drift
+ * (dispatcher case wired) + real I/O behavior (atomic write lands the
+ * sidecar) + subcommand contracts.
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const FRAMEWORK_ROOT = resolve(__dirname, '..', '..');
+const CLI = join(FRAMEWORK_ROOT, 'bin', 'apt-tools.mjs');
+function runCli(args) {
+    const res = spawnSync(process.execPath, [CLI, ...args], {
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    let json = null;
+    // The CLI occasionally emits non-JSON log prefixes (HOOK_ warnings, etc.) —
+    // try the stdout as a whole first, then line-scan for a JSON object.
+    try {
+        json = JSON.parse(res.stdout);
+    }
+    catch {
+        const lines = res.stdout.split('\n');
+        for (let i = lines.length - 1; i >= 0; i--) {
+            const trimmed = lines[i].trim();
+            if (trimmed.startsWith('{')) {
+                try {
+                    json = JSON.parse(lines.slice(i).join('\n'));
+                    break;
+                }
+                catch {
+                    /* keep scanning */
+                }
+            }
+        }
+    }
+    return { status: res.status, stdout: res.stdout, stderr: res.stderr, json };
+}
+let root;
+beforeEach(() => {
+    root = mkdtempSync(join(tmpdir(), 'apt-c47-cli-'));
+});
+afterEach(() => {
+    try {
+        rmSync(root, { recursive: true, force: true });
+    }
+    catch {
+        /* best-effort */
+    }
+});
+describe('apt-tools bootstrap — end-to-end CLI', () => {
+    it('detect → emits an ok envelope with mode + signals + recon', () => {
+        const res = runCli(['bootstrap', 'detect', root]);
+        expect(res.status).toBe(0);
+        expect(res.json?.status).toBe('ok');
+        expect(res.json?.command).toBe('bootstrap-detect');
+        expect(res.json?.mode).toBe('greenfield'); // empty dir → greenfield
+        expect(res.json?.signals).toBeDefined();
+        expect(res.json?.rationale).toBeDefined();
+        expect(res.json?.recon).toBeDefined();
+    });
+    it('detect --force-brownfield overrides the heuristic', () => {
+        const out = runCli(['bootstrap', 'detect', root, '--force-brownfield']);
+        expect(out.status).toBe(0);
+        expect(out.json?.mode).toBe('brownfield');
+        expect(out.json?.detected_mode).toBe('greenfield');
+        expect(out.json?.override).toBe('user-forced brownfield');
+    });
+    it('scaffold writes PROJECT.md from the template', () => {
+        const res = runCli(['bootstrap', 'scaffold', root]);
+        expect(res.status).toBe(0);
+        expect(res.json?.status).toBe('ok');
+        expect(existsSync(join(root, 'PROJECT.md'))).toBe(true);
+        const body = readFileSync(join(root, 'PROJECT.md'), 'utf-8');
+        expect(body).toMatch(/## What This Is/);
+        expect(body).toMatch(/## Core Value/);
+        expect(body).toMatch(/## Scope/);
+        expect(body).toMatch(/## Context/);
+        expect(body).toMatch(/## Personas/);
+        expect(body).toMatch(/## Constraints/);
+        expect(body).toMatch(/## Key Decisions/);
+    });
+    it('scaffold refuses to overwrite an existing PROJECT.md without --force', () => {
+        writeFileSync(join(root, 'PROJECT.md'), '# Existing\n', 'utf-8');
+        const res = runCli(['bootstrap', 'scaffold', root]);
+        expect(res.status).toBe(0);
+        expect(res.json?.status).toBe('skipped');
+        // Unchanged.
+        expect(readFileSync(join(root, 'PROJECT.md'), 'utf-8')).toBe('# Existing\n');
+    });
+    it('scaffold --force overwrites the existing PROJECT.md', () => {
+        writeFileSync(join(root, 'PROJECT.md'), '# Existing\n', 'utf-8');
+        const res = runCli(['bootstrap', 'scaffold', root, '--force']);
+        expect(res.status).toBe(0);
+        expect(res.json?.status).toBe('ok');
+        expect(readFileSync(join(root, 'PROJECT.md'), 'utf-8')).toMatch(/## What This Is/);
+    });
+    it('derive-sidecar writes .aperant/product-context.json from PROJECT.md', () => {
+        writeFileSync(join(root, 'PROJECT.md'), [
+            '# Aperant',
+            '## What This Is',
+            '**Aperant** — agentic IDE for the full lifecycle.',
+            '## Core Value',
+            'From idea to production.',
+            '## Scope',
+            '### In',
+            '- Plan',
+            '- Execute',
+            '### Out',
+            '- Hosting',
+            '## Context',
+            'Two-founder team.',
+            '## Personas',
+            'Senior developers.',
+            '## Constraints',
+            '- TypeScript strict',
+            '## Key Decisions',
+            '- PROJECT.md is the source of truth',
+            '',
+        ].join('\n'), 'utf-8');
+        const res = runCli(['bootstrap', 'derive-sidecar', root]);
+        expect(res.status).toBe(0);
+        expect(res.json?.status).toBe('ok');
+        const sidecarPath = join(root, '.aperant', 'product-context.json');
+        expect(existsSync(sidecarPath)).toBe(true);
+        const sidecar = JSON.parse(readFileSync(sidecarPath, 'utf-8'));
+        expect(sidecar.productName).toBe('Aperant');
+        expect(sidecar.productDescription).toMatch(/idea to production/i);
+        expect(Array.isArray(sidecar.features)).toBe(true);
+        expect(sidecar.features.length).toBe(2);
+        expect(sidecar.scopeIn).toEqual(['Plan', 'Execute']);
+        expect(sidecar.scopeOut).toEqual(['Hosting']);
+        expect(sidecar._meta.source).toBe('PROJECT.md');
+    });
+    it('derive-sidecar fails when PROJECT.md is missing', () => {
+        const res = runCli(['bootstrap', 'derive-sidecar', root]);
+        expect(res.status).toBe(1);
+        expect(res.json?.error).toMatch(/PROJECT\.md does not exist/);
+    });
+    it('run on an empty greenfield dir scaffolds and derives sidecar in one shot', () => {
+        const res = runCli(['bootstrap', 'run', root]);
+        expect(res.status).toBe(0);
+        expect(res.json?.status).toBe('ok');
+        expect(res.json?.mode).toBe('greenfield');
+        // Scaffold produced PROJECT.md.
+        expect(existsSync(join(root, 'PROJECT.md'))).toBe(true);
+        // Sidecar produced product-context.json (the template PROJECT.md still
+        // derives a valid-shape sidecar even with placeholder text).
+        expect(existsSync(join(root, '.aperant', 'product-context.json'))).toBe(true);
+        const scaffold = res.json?.scaffold;
+        const sidecar = res.json?.sidecar;
+        expect(scaffold?.status).toBe('ok');
+        expect(sidecar?.status).toBe('ok');
+    });
+    it('run honors --skip-sidecar when the user wants PROJECT.md only', () => {
+        const res = runCli(['bootstrap', 'run', root, '--skip-sidecar']);
+        expect(res.status).toBe(0);
+        expect(existsSync(join(root, 'PROJECT.md'))).toBe(true);
+        expect(existsSync(join(root, '.aperant', 'product-context.json'))).toBe(false);
+        expect(res.json?.sidecar).toBeNull();
+    });
+    it('emits a helpful usage line when the subcommand is omitted', () => {
+        const res = runCli(['bootstrap']);
+        expect(res.status).toBe(1);
+        expect(res.json?.error).toMatch(/Usage: apt-tools bootstrap/);
+    });
+    it('rejects conflicting force flags', () => {
+        const res = runCli(['bootstrap', 'detect', root, '--force-greenfield', '--force-brownfield']);
+        expect(res.status).toBe(1);
+        expect(res.json?.error).toMatch(/mutually exclusive/);
+    });
+});
+//# sourceMappingURL=bootstrap-cli.test.js.map

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

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

package/dist/__tests__/bootstrap-detect-mode.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * bootstrap-detect-mode.test.ts — D-03 compound heuristic coverage (C47).
+ *
+ * Pins the three-gate rule: greenfield requires all three of
+ *   (source_file_count < 10) AND (no README) AND (commit_count ≤ 2 | no git)
+ * Every other combination is brownfield.
+ */
+export {};
+//# sourceMappingURL=bootstrap-detect-mode.test.d.ts.map

package/dist/__tests__/bootstrap-detect-mode.test.d.ts.map

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

package/dist/__tests__/bootstrap-detect-mode.test.js

@@ -0,0 +1,113 @@
+/**
+ * bootstrap-detect-mode.test.ts — D-03 compound heuristic coverage (C47).
+ *
+ * Pins the three-gate rule: greenfield requires all three of
+ *   (source_file_count < 10) AND (no README) AND (commit_count ≤ 2 | no git)
+ * Every other combination is brownfield.
+ */
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { detectMode } from '../cli/bootstrap/detect-mode.mjs';
+let root;
+beforeEach(() => {
+    root = mkdtempSync(join(tmpdir(), 'apt-c47-detect-'));
+});
+afterEach(() => {
+    try {
+        rmSync(root, { recursive: true, force: true });
+    }
+    catch {
+        /* best-effort */
+    }
+});
+/** Create N source files under `dir/src/` with .ts extension. */
+function seedSources(dir, n) {
+    mkdirSync(join(dir, 'src'), { recursive: true });
+    for (let i = 0; i < n; i++) {
+        writeFileSync(join(dir, 'src', `file-${i}.ts`), `export const f${i} = ${i}\n`, 'utf-8');
+    }
+}
+function initGitWithCommits(dir, count) {
+    execFileSync('git', ['init'], { cwd: dir, stdio: 'ignore' });
+    execFileSync('git', ['config', 'user.email', 'test@example.com'], { cwd: dir, stdio: 'ignore' });
+    execFileSync('git', ['config', 'user.name', 'Test User'], { cwd: dir, stdio: 'ignore' });
+    execFileSync('git', ['config', 'commit.gpgsign', 'false'], { cwd: dir, stdio: 'ignore' });
+    for (let i = 0; i < count; i++) {
+        writeFileSync(join(dir, `commit-marker-${i}.txt`), `n=${i}`, 'utf-8');
+        execFileSync('git', ['add', '.'], { cwd: dir, stdio: 'ignore' });
+        execFileSync('git', ['commit', '-m', `commit ${i}`], { cwd: dir, stdio: 'ignore' });
+    }
+}
+describe('detectMode — D-03 compound heuristic', () => {
+    it('classifies a brand-new empty project as greenfield', () => {
+        const res = detectMode(root);
+        expect(res.mode).toBe('greenfield');
+        expect(res.signals.sourceFileCount).toBe(0);
+        expect(res.signals.hasReadme).toBe(false);
+        expect(res.signals.hasGit).toBe(false);
+        expect(res.signals.commitCount).toBe(0);
+    });
+    it('classifies a tiny git repo with a stub scaffold as greenfield', () => {
+        seedSources(root, 3);
+        initGitWithCommits(root, 1);
+        const res = detectMode(root);
+        expect(res.mode).toBe('greenfield');
+        expect(res.signals.sourceFileCount).toBe(3);
+        expect(res.signals.commitCount).toBe(1);
+    });
+    it('classifies a project with a README as brownfield even when small', () => {
+        writeFileSync(join(root, 'README.md'), '# My Project\n', 'utf-8');
+        seedSources(root, 2);
+        const res = detectMode(root);
+        expect(res.mode).toBe('brownfield');
+        expect(res.signals.hasReadme).toBe(true);
+    });
+    it('classifies a large-code-no-README repo as brownfield', () => {
+        seedSources(root, 15);
+        const res = detectMode(root);
+        expect(res.mode).toBe('brownfield');
+        expect(res.signals.sourceFileCount).toBeGreaterThanOrEqual(10);
+    });
+    it('classifies a repo with many commits as brownfield even when source is small', () => {
+        seedSources(root, 2);
+        initGitWithCommits(root, 5);
+        const res = detectMode(root);
+        expect(res.mode).toBe('brownfield');
+        expect(res.signals.commitCount).toBe(5);
+    });
+    it('treats exactly 10 source files as brownfield (boundary)', () => {
+        seedSources(root, 10);
+        const res = detectMode(root);
+        // 10 is NOT < 10, so the low-source-count gate fails → brownfield.
+        expect(res.mode).toBe('brownfield');
+        expect(res.signals.sourceFileCount).toBe(10);
+    });
+    it('treats exactly 2 commits as greenfield (boundary inclusive)', () => {
+        seedSources(root, 3);
+        initGitWithCommits(root, 2);
+        const res = detectMode(root);
+        expect(res.mode).toBe('greenfield');
+        expect(res.signals.commitCount).toBe(2);
+    });
+    it('ignores node_modules and vendored folders in source counting', () => {
+        seedSources(root, 3); // 3 real sources in src/
+        // Seed a ton of "sources" under node_modules — these must not count.
+        mkdirSync(join(root, 'node_modules', 'fake-lib'), { recursive: true });
+        for (let i = 0; i < 50; i++) {
+            writeFileSync(join(root, 'node_modules', 'fake-lib', `n-${i}.ts`), `export const n${i} = ${i}\n`, 'utf-8');
+        }
+        const res = detectMode(root);
+        expect(res.mode).toBe('greenfield');
+        expect(res.signals.sourceFileCount).toBe(3);
+    });
+    it('produces a rationale line per D-03 gate', () => {
+        const res = detectMode(root);
+        expect(res.rationale.length).toBeGreaterThanOrEqual(4);
+        // The compound line is always last.
+        expect(res.rationale[res.rationale.length - 1]).toContain('compound → ');
+    });
+});
+//# sourceMappingURL=bootstrap-detect-mode.test.js.map