@productbrain/cli 0.1.0-beta.95 → 0.1.0-beta.951

package/dist/setup/__tests__/coach-traces.test.js

@@ -0,0 +1,189 @@
+/**
+ * Cross-model coach validation harness — WP-431 S4 (doneWhen #16).
+ *
+ * Mock harness chosen for cross-model validation per TEN-1962 — deterministic,
+ * runs in CI without API keys. Live trace via dev-only Cursor Desktop documented
+ * separately if needed. The harness does NOT call any model; it simulates the
+ * criteria-progression loop encoded in `.productbrain/skills/pb-setup.md`
+ * Phase 3 and asserts convergence within 3 turns OR correct fallback to the
+ * FLO-72 Path C wizard (DEC-991).
+ *
+ * The fixture set covers cross-model behaviour by encoding three response
+ * shapes that any reasonable instruction-following model produces — the user's
+ * answer is the variable, the agent's response loop is the constant. The
+ * skill body is the universal SSOT (DEC-997); this harness exercises it.
+ */
+import { describe, expect, it } from 'vitest';
+/**
+ * Criteria check (verbatim from `.productbrain/skills/pb-setup.md` Phase 3):
+ *   "answer mentions a verb + a thing they do regularly".
+ *
+ * The criteria predicate keeps the test honest: it deterministically maps a
+ * user utterance to met/not-met. The tokeniser is intentionally simple — the
+ * skill text says "verb + thing", and that's what we look for.
+ */
+const VERB_HINTS = [
+    'ship',
+    'shipping',
+    'fix',
+    'fixing',
+    'write',
+    'writing',
+    'review',
+    'reviewing',
+    'build',
+    'building',
+    'integrate',
+    'integrating',
+    'design',
+    'designing',
+    'debug',
+    'debugging',
+    'refactor',
+    'refactoring',
+    'document',
+    'documenting',
+];
+const THING_HINTS = [
+    'feature',
+    'features',
+    'bug',
+    'bugs',
+    'copy',
+    'integration',
+    'integrations',
+    'review',
+    'reviews',
+    'issue',
+    'issues',
+    'doc',
+    'docs',
+    'api',
+    'apis',
+    'endpoint',
+    'endpoints',
+    'workflow',
+    'workflows',
+    'page',
+    'pages',
+    'rule',
+    'rules',
+];
+function meetsCriteria(answer) {
+    const lower = answer.toLowerCase();
+    const hasVerb = VERB_HINTS.some((v) => new RegExp(`\\b${v}\\b`).test(lower));
+    const hasThing = THING_HINTS.some((t) => new RegExp(`\\b${t}\\b`).test(lower));
+    return hasVerb && hasThing;
+}
+/**
+ * Run the coach loop encoded in pb-setup.md against a scripted user.
+ *
+ * Loop (verbatim from the skill):
+ *   1. Ask the open question.
+ *   2. If answer meets criteria -> progress.
+ *   3. If vague, ask one follow-up.
+ *   4. If 2 follow-ups don't yield, fall back to wizard (DEC-991).
+ *
+ * Convergence target (doneWhen #16): within 3 turns. Three turns means: the
+ * open question + at most two follow-ups. After the third turn without
+ * criteria-met, the agent MUST fall back to the wizard.
+ */
+function runCoachLoop(turns) {
+    const trace = [];
+    let followUps = 0;
+    for (let i = 0; i < turns.length; i++) {
+        const turn = turns[i];
+        const met = meetsCriteria(turn.user);
+        trace.push({ turn: i + 1, user: turn.user, met });
+        if (met) {
+            return {
+                state: 'criteria-met',
+                turnsUsed: i + 1,
+                finalAnswer: turn.user,
+                trace,
+            };
+        }
+        followUps += 1;
+        if (followUps >= 2) {
+            // Skill behaviour: "if 2 follow-ups don't yield, suggest a default
+            // catalog and let them pick (DEC-991 fallback path)".
+            return {
+                state: 'wizard-fallback',
+                turnsUsed: i + 1,
+                finalAnswer: turn.user,
+                trace,
+            };
+        }
+    }
+    // Out of scripted turns without convergence — treat as wizard-fallback so
+    // the test surfaces a faulty fixture rather than silently passing.
+    return {
+        state: 'wizard-fallback',
+        turnsUsed: turns.length,
+        finalAnswer: turns[turns.length - 1]?.user ?? '',
+        trace,
+    };
+}
+describe('Phase 3 coach loop — cross-model trace harness (TEN-1962)', () => {
+    it('Scenario A — happy path (specific answer, 1 turn)', () => {
+        const turns = [
+            { user: 'Mostly shipping new features for our SvelteKit app.' },
+        ];
+        const outcome = runCoachLoop(turns);
+        expect(outcome.state).toBe('criteria-met');
+        expect(outcome.turnsUsed).toBe(1);
+        expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
+    });
+    it('Scenario B — vague then specific (follow-up, 2 turns)', () => {
+        const turns = [
+            { user: 'I dunno, various stuff.' },
+            { user: 'Last week I spent the most time fixing customer bugs.' },
+        ];
+        const outcome = runCoachLoop(turns);
+        expect(outcome.state).toBe('criteria-met');
+        expect(outcome.turnsUsed).toBe(2);
+        expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
+    });
+    it('Scenario C — 2 vague turns triggers wizard fallback (DEC-991 path)', () => {
+        const turns = [
+            { user: 'Just code, you know how it is.' },
+            { user: 'Stuff. Things. The usual.' },
+        ];
+        const outcome = runCoachLoop(turns);
+        expect(outcome.state).toBe('wizard-fallback');
+        expect(outcome.turnsUsed).toBe(2);
+        // Convergence to a deterministic outcome (criteria-met OR wizard) within
+        // the 3-turn budget defends KEY-32 generalisation across surfaces.
+        expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
+    });
+    it('Scenario D — marketing copy answer (non-engineering domain, criteria still met)', () => {
+        const turns = [
+            { user: 'I write marketing copy and review pages from the design team.' },
+        ];
+        const outcome = runCoachLoop(turns);
+        expect(outcome.state).toBe('criteria-met');
+        expect(outcome.turnsUsed).toBe(1);
+    });
+    it('Scenario E — every fixture converges within the 3-turn budget', () => {
+        // Roll-up assertion across all scenarios so a future fixture addition that
+        // exceeds the budget surfaces here as a single named failure.
+        const fixtures = [
+            [{ user: 'Mostly shipping new features for our SvelteKit app.' }],
+            [
+                { user: 'I dunno, various stuff.' },
+                { user: 'Last week I spent the most time fixing customer bugs.' },
+            ],
+            [
+                { user: 'Just code, you know how it is.' },
+                { user: 'Stuff. Things. The usual.' },
+            ],
+            [{ user: 'I write marketing copy and review pages from the design team.' }],
+        ];
+        for (const turns of fixtures) {
+            const outcome = runCoachLoop(turns);
+            expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
+            expect(['criteria-met', 'wizard-fallback']).toContain(outcome.state);
+        }
+    });
+});
+//# sourceMappingURL=coach-traces.test.js.map

package/dist/setup/__tests__/coach-traces.test.js.map

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

package/dist/setup/__tests__/setup-commands.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setup-commands.test.d.ts.map

package/dist/setup/__tests__/setup-commands.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-commands.test.d.ts","sourceRoot":"","sources":["../../../src/setup/__tests__/setup-commands.test.ts"],"names":[],"mappings":""}

package/dist/setup/__tests__/setup-commands.test.js

@@ -0,0 +1,177 @@
+/**
+ * WP-431 S3 — CLI surface-detect + manifest-writer + setup-state tests.
+ *
+ * Uses real temp directories so the perimeter guard, atomic rename, and YAML
+ * round-trip are exercised end-to-end. Convex queries / mutations are mocked
+ * at the kernelCall boundary.
+ */
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { detectSurfaces, unionSurfaces } from '../detect-surfaces.js';
+import { readManifestSurfaces, writeManifestSurfaces, } from '../manifest-writer.js';
+import { runSetupDetectSurfaces } from '../../commands/setup-detect-surfaces.js';
+let scratch;
+let originalCwd;
+function freshScratch() {
+    return mkdtempSync(join(tmpdir(), 'pb-setup-s3-'));
+}
+beforeEach(() => {
+    originalCwd = process.cwd();
+    scratch = freshScratch();
+    process.chdir(scratch);
+});
+afterEach(() => {
+    process.chdir(originalCwd);
+    rmSync(scratch, { recursive: true, force: true });
+});
+describe('detectSurfaces()', () => {
+    it('returns [] for an empty repo', async () => {
+        const result = await detectSurfaces(scratch);
+        expect(result).toEqual([]);
+    });
+    it('detects claude when .claude/ exists', async () => {
+        mkdirSync(join(scratch, '.claude'));
+        const result = await detectSurfaces(scratch);
+        expect(result).toContain('claude');
+        expect(result).not.toContain('cursor');
+    });
+    it('detects claude + cursor when both directories exist', async () => {
+        mkdirSync(join(scratch, '.claude'));
+        mkdirSync(join(scratch, '.cursor'));
+        const result = await detectSurfaces(scratch);
+        expect(result).toContain('claude');
+        expect(result).toContain('cursor');
+    });
+    it('detects copilot via .github/copilot-instructions.md', async () => {
+        mkdirSync(join(scratch, '.github'), { recursive: true });
+        writeFileSync(join(scratch, '.github', 'copilot-instructions.md'), '# instructions\n');
+        const result = await detectSurfaces(scratch);
+        expect(result).toContain('copilot');
+    });
+    it('detects codex via .codex/ directory', async () => {
+        mkdirSync(join(scratch, '.codex'));
+        const result = await detectSurfaces(scratch);
+        expect(result).toContain('codex');
+    });
+    it('detects codex via AGENTS.md fallback', async () => {
+        writeFileSync(join(scratch, 'AGENTS.md'), '# agents\n');
+        const result = await detectSurfaces(scratch);
+        expect(result).toContain('codex');
+    });
+});
+describe('unionSurfaces()', () => {
+    it('union-merges existing and detected (sorted, deduped)', () => {
+        expect(unionSurfaces(['copilot'], ['claude'])).toEqual(['claude', 'copilot']);
+    });
+    it('preserves existing when nothing new is detected (forward-only)', () => {
+        expect(unionSurfaces(['cursor'], [])).toEqual(['cursor']);
+    });
+    it('skips empty / non-string entries defensively', () => {
+        // intentionally pass an empty string to confirm it is dropped
+        expect(unionSurfaces(['claude', ''], ['cursor'])).toEqual(['claude', 'cursor']);
+    });
+});
+describe('writeManifestSurfaces()', () => {
+    it('STD-234 perimeter is invoked before any disk write', async () => {
+        // Verify the writer routes through assertSetupWritePath. We assert the
+        // observable behaviour: writeManifestSurfaces does write to .productbrain/
+        // (which the perimeter explicitly allows) and never to a path outside it.
+        const result = await writeManifestSurfaces(scratch, ['claude']);
+        expect(result.path).toContain('.productbrain/manifest.yaml');
+        expect(result.path).not.toContain('..');
+    });
+    it('writes a fresh manifest when none exists', async () => {
+        const result = await writeManifestSurfaces(scratch, ['claude']);
+        expect(result.written).toBe(true);
+        expect(existsSync(result.path)).toBe(true);
+        const raw = readFileSync(result.path, 'utf8');
+        expect(raw).toContain('surfaces:');
+        expect(raw).toContain('- claude');
+    });
+    it('preserves other top-level manifest keys when replacing surfaces', async () => {
+        const pbDir = join(scratch, '.productbrain');
+        mkdirSync(pbDir, { recursive: true });
+        writeFileSync(join(pbDir, 'manifest.yaml'), 'version: "0.1"\nmaterialize: observe\nadopted:\n  - rule-a\n');
+        await writeManifestSurfaces(scratch, ['claude']);
+        const raw = readFileSync(join(pbDir, 'manifest.yaml'), 'utf8');
+        expect(raw).toContain('version: "0.1"');
+        expect(raw).toContain('materialize: observe');
+        expect(raw).toContain('- rule-a');
+        expect(raw).toContain('- claude');
+    });
+    it('round-trip: write then read returns the same surfaces', async () => {
+        await writeManifestSurfaces(scratch, ['claude', 'cursor']);
+        expect(readManifestSurfaces(scratch).sort()).toEqual(['claude', 'cursor']);
+    });
+    it('idempotent: second call with same surfaces is a no-op (written=false)', async () => {
+        await writeManifestSurfaces(scratch, ['claude']);
+        const second = await writeManifestSurfaces(scratch, ['claude']);
+        expect(second.written).toBe(false);
+    });
+    it('atomic: tmp file is cleaned up when rename throws (orig left untouched)', async () => {
+        const pbDir = join(scratch, '.productbrain');
+        mkdirSync(pbDir, { recursive: true });
+        const manifestPath = join(pbDir, 'manifest.yaml');
+        writeFileSync(manifestPath, 'version: "0.1"\nsurfaces:\n  - copilot\n');
+        // Make the destination a directory — renameSync(file, dirPath) fails on most
+        // platforms, exercising the catch+unlink path in writeManifestSurfaces.
+        rmSync(manifestPath);
+        mkdirSync(manifestPath); // now a dir, not a file
+        await expect(writeManifestSurfaces(scratch, ['claude'])).rejects.toThrow();
+        rmSync(manifestPath, { recursive: true, force: true });
+        // tmp file should have been cleaned up by the catch block.
+        expect(existsSync(`${manifestPath}.tmp`)).toBe(false);
+    });
+});
+describe('runSetupDetectSurfaces()', () => {
+    it('empty repo → manifest unchanged, surfaces empty', async () => {
+        const result = await runSetupDetectSurfaces({ cwd: scratch });
+        expect(result.detected).toEqual([]);
+        expect(result.union).toEqual([]);
+        // a fresh empty repo with no markers writes a fresh manifest with surfaces:[].
+        // Subsequent runs are no-ops; first run records the empty state explicitly.
+        const second = await runSetupDetectSurfaces({ cwd: scratch });
+        expect(second.manifestUpdated).toBe(false);
+    });
+    it('repo with .claude/ only → surfaces:[claude]', async () => {
+        mkdirSync(join(scratch, '.claude'));
+        const result = await runSetupDetectSurfaces({ cwd: scratch });
+        expect(result.detected).toEqual(['claude']);
+        expect(result.union).toEqual(['claude']);
+        expect(result.manifestUpdated).toBe(true);
+    });
+    it('repo with .claude + .cursor → surfaces sorted [claude, cursor]', async () => {
+        mkdirSync(join(scratch, '.claude'));
+        mkdirSync(join(scratch, '.cursor'));
+        const result = await runSetupDetectSurfaces({ cwd: scratch });
+        expect(result.union).toEqual(['claude', 'cursor']);
+    });
+    it('pre-existing surfaces:[copilot] + new .claude/ → union sorted', async () => {
+        const pbDir = join(scratch, '.productbrain');
+        mkdirSync(pbDir, { recursive: true });
+        writeFileSync(join(pbDir, 'manifest.yaml'), 'version: "0.1"\nsurfaces:\n  - copilot\n');
+        mkdirSync(join(scratch, '.claude'));
+        const result = await runSetupDetectSurfaces({ cwd: scratch });
+        expect(result.union).toEqual(['claude', 'copilot']);
+        expect(result.newlyAdded).toEqual(['claude']);
+    });
+    it('idempotent: second run after no FS changes is a manifest no-op', async () => {
+        mkdirSync(join(scratch, '.claude'));
+        await runSetupDetectSurfaces({ cwd: scratch });
+        const second = await runSetupDetectSurfaces({ cwd: scratch });
+        expect(second.manifestUpdated).toBe(false);
+        expect(second.union).toEqual(['claude']);
+    });
+    it('STD-235 forward-only: pre-existing surfaces survive when marker is absent', async () => {
+        const pbDir = join(scratch, '.productbrain');
+        mkdirSync(pbDir, { recursive: true });
+        writeFileSync(join(pbDir, 'manifest.yaml'), 'version: "0.1"\nsurfaces:\n  - cursor\n');
+        // No .cursor/ directory in scratch
+        const result = await runSetupDetectSurfaces({ cwd: scratch });
+        expect(result.union).toContain('cursor');
+        expect(result.union).not.toEqual([]);
+    });
+});
+//# sourceMappingURL=setup-commands.test.js.map

package/dist/setup/__tests__/setup-commands.test.js.map

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

package/dist/setup/__tests__/state-machine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=state-machine.test.d.ts.map

package/dist/setup/__tests__/state-machine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.test.d.ts","sourceRoot":"","sources":["../../../src/setup/__tests__/state-machine.test.ts"],"names":[],"mappings":""}