@productbrain/cli 0.1.0-beta.108 → 0.1.0-beta.1087

package/dist/commands/__tests__/connect-handoff.test.js

@@ -0,0 +1,111 @@
+/**
+ * WP-433 S4 — FEAT-1291: Tests for connect-handoff module.
+ *
+ * Contract:
+ * 1. Heuristic table: 5 cases, each asserts exact agent + message strings.
+ * 2. ≤200-char invariant: all 5 messages must be ≤200 characters.
+ * 3. No bare-repo undefined: bare-repo result is never undefined/empty.
+ * 4. detectHandoffMarkers integration: tmpdir with .claude/ → hasClaude=true.
+ */
+import { mkdirSync, rmSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { resolveHandoff, detectHandoffMarkers, HANDOFF_MESSAGE_CLAUDE_OR_CURSOR, HANDOFF_MESSAGE_CLAUDE, HANDOFF_MESSAGE_CURSOR, HANDOFF_MESSAGE_CODEX, HANDOFF_MESSAGE_BARE_REPO, } from '../connect-handoff.js';
+// ── 1. Heuristic table (5 cases) ─────────────────────────────────────────────
+describe('resolveHandoff — heuristic table', () => {
+    it('.claude=Y, .cursor=Y → claude-or-cursor', () => {
+        const result = resolveHandoff({ hasClaude: true, hasCursor: true, hasCodexFile: false });
+        expect(result.agent).toBe('claude-or-cursor');
+        expect(result.message).toBe('Open Claude Code or Cursor in this project and type in chat: Start Product Brain');
+    });
+    it('.claude=Y, .cursor=N → claude', () => {
+        const result = resolveHandoff({ hasClaude: true, hasCursor: false, hasCodexFile: false });
+        expect(result.agent).toBe('claude');
+        expect(result.message).toBe('Open Claude Code in this project and type in chat: Start Product Brain');
+    });
+    it('.claude=N, .cursor=Y → cursor', () => {
+        const result = resolveHandoff({ hasClaude: false, hasCursor: true, hasCodexFile: false });
+        expect(result.agent).toBe('cursor');
+        expect(result.message).toBe('Open Cursor in this project and type in chat: Start Product Brain');
+    });
+    it('.claude=N, .cursor=N, AGENTS.md=Y → codex', () => {
+        const result = resolveHandoff({ hasClaude: false, hasCursor: false, hasCodexFile: true });
+        expect(result.agent).toBe('codex');
+        expect(result.message).toBe('Open Codex CLI in this project and type in chat: Start Product Brain');
+    });
+    it('.claude=N, .cursor=N, AGENTS.md=N → bare-repo', () => {
+        const result = resolveHandoff({ hasClaude: false, hasCursor: false, hasCodexFile: false });
+        expect(result.agent).toBe('bare-repo');
+        expect(result.message).toBe('No AI tool detected in this project. Visit productbrain.io/docs to set one up.');
+    });
+});
+// ── 2. Exhaustiveness: every boolean combination returns a defined HandoffResult ──
+describe('resolveHandoff — every boolean combination returns a defined HandoffResult', () => {
+    it('covers all 2^3 = 8 marker combinations', () => {
+        const bools = [false, true];
+        for (const hasClaude of bools) {
+            for (const hasCursor of bools) {
+                for (const hasCodexFile of bools) {
+                    const result = resolveHandoff({ hasClaude, hasCursor, hasCodexFile });
+                    expect(result.agent).toBeDefined();
+                    expect(result.message.length).toBeGreaterThan(0);
+                }
+            }
+        }
+    });
+});
+// ── 4. ≤200-char invariant ────────────────────────────────────────────────────
+describe('handoff message ≤200-char invariant', () => {
+    const allMessages = [
+        HANDOFF_MESSAGE_CLAUDE_OR_CURSOR,
+        HANDOFF_MESSAGE_CLAUDE,
+        HANDOFF_MESSAGE_CURSOR,
+        HANDOFF_MESSAGE_CODEX,
+        HANDOFF_MESSAGE_BARE_REPO,
+    ];
+    it.each(allMessages)('message is ≤200 chars: "%s"', (msg) => {
+        expect(msg.length).toBeLessThanOrEqual(200);
+    });
+});
+// ── 5. No bare-repo undefined ─────────────────────────────────────────────────
+describe('bare-repo result is never undefined or empty', () => {
+    it('resolveHandoff returns bare-repo with non-empty message when no markers', () => {
+        const result = resolveHandoff({ hasClaude: false, hasCursor: false, hasCodexFile: false });
+        expect(result.agent).toBe('bare-repo');
+        expect(result.message).toBeDefined();
+        expect(result.message.length).toBeGreaterThan(0);
+    });
+});
+// ── 6. detectHandoffMarkers integration ──────────────────────────────────────
+describe('detectHandoffMarkers integration', () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = join(tmpdir(), `pb-handoff-test-${Date.now()}`);
+        mkdirSync(tmp, { recursive: true });
+    });
+    afterEach(() => {
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    it('returns hasClaude=true when .claude/ dir exists', () => {
+        mkdirSync(join(tmp, '.claude'));
+        const markers = detectHandoffMarkers(tmp);
+        expect(markers).toEqual({ hasClaude: true, hasCursor: false, hasCodexFile: false });
+    });
+    it('returns hasCursor=true when .cursor/ dir exists', () => {
+        mkdirSync(join(tmp, '.cursor'));
+        const markers = detectHandoffMarkers(tmp);
+        expect(markers).toEqual({ hasClaude: false, hasCursor: true, hasCodexFile: false });
+    });
+    it('returns hasCodexFile=true when AGENTS.md exists', () => {
+        // Write a minimal file so existsSync resolves it as a file (not dir)
+        writeFileSync(join(tmp, 'AGENTS.md'), '');
+        const markers = detectHandoffMarkers(tmp);
+        expect(markers).toEqual({ hasClaude: false, hasCursor: false, hasCodexFile: true });
+    });
+    it('returns all false when directory is empty', () => {
+        const markers = detectHandoffMarkers(tmp);
+        expect(markers).toEqual({ hasClaude: false, hasCursor: false, hasCodexFile: false });
+    });
+});
+//# sourceMappingURL=connect-handoff.test.js.map

package/dist/commands/__tests__/connect-handoff.test.js.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * WP-433 S5 — `formatDetectSurfacesSummary` pure unit tests.
+ *
+ * Per INS-1420: runSetupDetectSurfaces makes live server calls via getConfigSafe()
+ * and kernelCall. These tests ONLY exercise the pure formatter on hand-crafted
+ * SetupDetectSurfacesResult objects — runSetupDetectSurfaces is never called.
+ *
+ * Test cases:
+ *  1. Bare-repo (zero detected, zero existing) → appends locked guidance question
+ *  2. Normal detect (new surfaces detected) → does NOT append
+ *  3. Idempotent re-run (existing surfaces, zero new) → does NOT append
+ *  4. Server-stamp-error case → surfaces error in summary, does NOT append extra question
+ */
+export {};
+//# sourceMappingURL=setup-detect-surfaces.test.d.ts.map

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

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

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

@@ -0,0 +1,149 @@
+/**
+ * WP-433 S5 — `formatDetectSurfacesSummary` pure unit tests.
+ *
+ * Per INS-1420: runSetupDetectSurfaces makes live server calls via getConfigSafe()
+ * and kernelCall. These tests ONLY exercise the pure formatter on hand-crafted
+ * SetupDetectSurfacesResult objects — runSetupDetectSurfaces is never called.
+ *
+ * Test cases:
+ *  1. Bare-repo (zero detected, zero existing) → appends locked guidance question
+ *  2. Normal detect (new surfaces detected) → does NOT append
+ *  3. Idempotent re-run (existing surfaces, zero new) → does NOT append
+ *  4. Server-stamp-error case → surfaces error in summary, does NOT append extra question
+ */
+import { describe, expect, it } from 'vitest';
+import { formatDetectSurfacesSummary, } from '../setup-detect-surfaces.js';
+const LOCKED_QUESTION = "I don't see Claude Code or Cursor — which AI tool do you use?";
+/** Helper: build a minimal SetupDetectSurfacesResult */
+function makeResult(overrides = {}) {
+    return {
+        detected: [],
+        existing: [],
+        newlyAdded: [],
+        union: [],
+        manifestUpdated: false,
+        manifestPath: '/repo/.productbrain/manifest.json',
+        serverStamp: null,
+        serverStampError: null,
+        ...overrides,
+    };
+}
+describe('formatDetectSurfacesSummary — WP-433 S5 bare-repo guidance', () => {
+    it('bare-repo (zero detected, zero existing) appends locked guidance question', () => {
+        const result = makeResult({
+            detected: [],
+            existing: [],
+            newlyAdded: [],
+            union: [],
+            manifestUpdated: false,
+        });
+        const summary = formatDetectSurfacesSummary(result);
+        expect(summary).toContain(LOCKED_QUESTION);
+        // Confirm the question is on a separate line
+        expect(summary).toContain('\n' + LOCKED_QUESTION);
+    });
+    it('normal detect (new surfaces detected) does NOT append locked question', () => {
+        const result = makeResult({
+            detected: ['claude'],
+            existing: [],
+            newlyAdded: ['claude'],
+            union: ['claude'],
+            manifestUpdated: true,
+            serverStamp: { stamped: true, surfaces: ['claude'] },
+        });
+        const summary = formatDetectSurfacesSummary(result);
+        expect(summary).not.toContain(LOCKED_QUESTION);
+        // Confirm surfaces are mentioned
+        expect(summary).toContain('claude');
+    });
+    it('STD-235 remnant (zero detected, existing surfaces remain in manifest) does NOT append locked question', () => {
+        // Marker dir deleted from disk; STD-235 forward-only keeps the surface in manifest.
+        // Detected is empty but existing is not — guard must NOT trigger bare-repo guidance.
+        const result = makeResult({
+            detected: [],
+            existing: ['claude'],
+            newlyAdded: [],
+            union: ['claude'],
+            manifestUpdated: false,
+        });
+        const summary = formatDetectSurfacesSummary(result);
+        expect(summary).not.toContain(LOCKED_QUESTION);
+        expect(summary).toContain('Detected: none');
+        expect(summary).toContain('Existing: claude');
+    });
+    it('idempotent re-run (existing surfaces, zero new detected) does NOT append locked question', () => {
+        const result = makeResult({
+            detected: ['claude'],
+            existing: ['claude'],
+            newlyAdded: [],
+            union: ['claude'],
+            manifestUpdated: false,
+            serverStamp: { stamped: false, surfaces: ['claude'] },
+        });
+        const summary = formatDetectSurfacesSummary(result);
+        expect(summary).not.toContain(LOCKED_QUESTION);
+        // Existing should appear in summary
+        expect(summary).toContain('claude');
+    });
+    it('server-stamp-error case surfaces the error and does NOT append the locked question', () => {
+        // If detect-surfaces fails at the server stamp but DID find surfaces locally,
+        // the error should appear but the bare-repo question should not.
+        const result = makeResult({
+            detected: ['cursor'],
+            existing: [],
+            newlyAdded: ['cursor'],
+            union: ['cursor'],
+            manifestUpdated: true,
+            serverStamp: null,
+            serverStampError: 'Network timeout connecting to workspace',
+        });
+        const summary = formatDetectSurfacesSummary(result);
+        // Error is surfaced
+        expect(summary).toContain('Server stamp failed: Network timeout connecting to workspace');
+        // Bare-repo question is NOT appended (surfaces were found)
+        expect(summary).not.toContain(LOCKED_QUESTION);
+    });
+    it('bare-repo with server-stamp-error (edge case: zero surfaces + server error) appends locked question', () => {
+        // Zero detected + zero existing → bare-repo. Server stamp would not have been
+        // called (union is empty), but if serverStampError somehow populated, the
+        // bare-repo signal still dominates and the question should appear.
+        const result = makeResult({
+            detected: [],
+            existing: [],
+            newlyAdded: [],
+            union: [],
+            manifestUpdated: false,
+            serverStamp: null,
+            serverStampError: 'Config missing',
+        });
+        const summary = formatDetectSurfacesSummary(result);
+        // Server stamp error is surfaced
+        expect(summary).toContain('Server stamp failed: Config missing');
+        // Bare-repo guidance still applies
+        expect(summary).toContain(LOCKED_QUESTION);
+    });
+    it('summary has correct shape for bare-repo result', () => {
+        const result = makeResult();
+        const summary = formatDetectSurfacesSummary(result);
+        // Base line before the question
+        expect(summary).toMatch(/^Detected: none \(new: none\)\. Existing: none\. Manifest unchanged\./);
+    });
+    it('summary has correct shape for normal detect', () => {
+        const result = makeResult({
+            detected: ['claude', 'cursor'],
+            existing: ['claude'],
+            newlyAdded: ['cursor'],
+            union: ['claude', 'cursor'],
+            manifestUpdated: true,
+            serverStamp: { stamped: true, surfaces: ['claude', 'cursor'] },
+        });
+        const summary = formatDetectSurfacesSummary(result);
+        expect(summary).toContain('Detected: claude, cursor');
+        expect(summary).toContain('new: cursor');
+        expect(summary).toContain('Existing: claude');
+        expect(summary).toContain('Manifest updated.');
+        expect(summary).toContain('Server stamped.');
+        expect(summary).not.toContain(LOCKED_QUESTION);
+    });
+});
+//# sourceMappingURL=setup-detect-surfaces.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,194 @@
+/**
+ * WP-431 S3 — `pb setup-state` and `pb setup` alias tests.
+ *
+ * Mocks kernelCall (gateway boundary) so error/auth/network paths and the
+ * recordInvocation idempotence behaviour are exercised without a real Convex
+ * deployment.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { mkdirSync, mkdtempSync, rmSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { tmpdir } from 'os';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+vi.mock('../../lib/client.js', async () => {
+    class FakeMcpError extends Error {
+        code;
+        constructor(message, code) {
+            super(message);
+            this.name = 'McpError';
+            this.code = code;
+        }
+    }
+    return {
+        kernelCall: vi.fn(),
+        McpError: FakeMcpError,
+    };
+});
+import { runSetupState, fetchSetupState } from '../setup-state.js';
+import { runSetup } from '../setup.js';
+import { kernelCall, McpError } from '../../lib/client.js';
+const mockedKernelCall = vi.mocked(kernelCall);
+let scratch;
+let originalCwd;
+let exitSpy;
+let stdoutSpy;
+let stderrSpy;
+beforeEach(() => {
+    originalCwd = process.cwd();
+    scratch = mkdtempSync(join(tmpdir(), 'pb-setup-state-'));
+    process.chdir(scratch);
+    mockedKernelCall.mockReset();
+    exitSpy = vi.spyOn(process, 'exit').mockImplementation(((_code) => {
+        throw new Error(`__exit:${_code ?? 0}`);
+    }));
+    stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+    stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+});
+afterEach(() => {
+    process.chdir(originalCwd);
+    rmSync(scratch, { recursive: true, force: true });
+    exitSpy.mockRestore();
+    stdoutSpy.mockRestore();
+    stderrSpy.mockRestore();
+});
+const SAMPLE = {
+    phase: 1,
+    role: 'creator',
+    expectedAction: 'declare a surface',
+    reasonForPhase: 'manifest.surfaces empty',
+    isComplete: false,
+    surfaceCapability: 'cli',
+};
+describe('fetchSetupState()', () => {
+    it('returns the typed result from setup.getPbSetupState', async () => {
+        mockedKernelCall.mockResolvedValueOnce(SAMPLE);
+        const result = await fetchSetupState();
+        expect(result).toEqual(SAMPLE);
+        expect(mockedKernelCall).toHaveBeenCalledWith('setup.getPbSetupState', {});
+    });
+});
+describe('runSetupState()', () => {
+    it('writes compact JSON to stdout on success', async () => {
+        mockedKernelCall.mockResolvedValueOnce(SAMPLE);
+        await runSetupState();
+        const written = stdoutSpy.mock.calls.map((c) => String(c[0])).join('');
+        const parsed = JSON.parse(written.trim());
+        expect(parsed).toEqual(SAMPLE);
+    });
+    it('exits 2 on AUTH_REQUIRED', async () => {
+        mockedKernelCall.mockRejectedValueOnce(new McpError('not member', 'AUTHZ_NOT_MEMBER'));
+        await expect(runSetupState()).rejects.toThrow('__exit:2');
+        const stderr = stderrSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(stderr).toContain('AUTH_DENIED');
+    });
+    it('exits 3 on network error (CLIError category=network)', async () => {
+        const { CLIError, ErrorCode } = await import('../../lib/errors.js');
+        mockedKernelCall.mockRejectedValueOnce(new CLIError('Could not reach host.', {
+            code: ErrorCode.NETWORK_UNREACHABLE,
+            category: 'network',
+        }));
+        await expect(runSetupState()).rejects.toThrow('__exit:3');
+    });
+    it('emits JSON to stdout regardless of tty (non-tty path)', async () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, configurable: true });
+        mockedKernelCall.mockResolvedValueOnce(SAMPLE);
+        await runSetupState();
+        const written = stdoutSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(written.trim().startsWith('{')).toBe(true);
+    });
+});
+describe('pb start ≠ pb setup (DEC-995 invariant)', () => {
+    it('runSessionStart is the binding for `pb start`, not runSetup', async () => {
+        const fs = await import('fs');
+        const indexSrc = fs.readFileSync(join(__dirname, '..', '..', 'index.ts'), 'utf8');
+        // pb start dispatches to runSessionStart
+        expect(indexSrc).toContain("args[0] === 'start'");
+        const startSection = indexSrc.split("args[0] === 'start'")[1] ?? '';
+        const closeSection = startSection.split("args[0] === 'close'")[0] ?? '';
+        expect(closeSection).toContain('runSessionStart');
+        expect(closeSection).not.toContain('runSetup(');
+    });
+});
+describe('runSetup() (pb setup alias)', () => {
+    beforeEach(() => {
+        // Default to TTY=true so the human summary is exercised
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+    });
+    it('Phase 1 → triggers detect-surfaces, re-reads state, prints final state', async () => {
+        // WP-433 S2: .claude dir triggers Claude surface detection → stampDetectedSurfaces
+        // is called as a 3rd kernelCall (between recordSetupInvocation and the re-read).
+        mkdirSync(join(scratch, '.claude'));
+        mockedKernelCall
+            .mockResolvedValueOnce({ ...SAMPLE, phase: 1 }) // initial getPbSetupState
+            .mockResolvedValueOnce({ firstSetupInvocationAt: 1, alreadyRecorded: false }) // recordSetupInvocation
+            .mockResolvedValueOnce({ stamped: true, surfaces: ['claude'] }) // stampDetectedSurfaces (WP-433 S2)
+            .mockResolvedValueOnce({ ...SAMPLE, phase: 2 }); // re-read after detect
+        await runSetup({ cwd: scratch });
+        const stdout = stdoutSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(stdout).toContain('"phase":2');
+    });
+    it('Phase 2+ → no auto-detect, prints initial state', async () => {
+        const phase2 = { ...SAMPLE, phase: 2 };
+        mockedKernelCall
+            .mockResolvedValueOnce(phase2)
+            .mockResolvedValueOnce({ firstSetupInvocationAt: 1, alreadyRecorded: true });
+        await runSetup({ cwd: scratch });
+        const calls = mockedKernelCall.mock.calls.map((c) => c[0]);
+        expect(calls.filter((c) => c === 'setup.getPbSetupState')).toHaveLength(1);
+    });
+    it('records invocation exactly once per pb-setup invocation', async () => {
+        const phase2 = { ...SAMPLE, phase: 2 };
+        mockedKernelCall
+            .mockResolvedValueOnce(phase2)
+            .mockResolvedValueOnce({ firstSetupInvocationAt: 1, alreadyRecorded: false });
+        await runSetup({ cwd: scratch });
+        const invocationCalls = mockedKernelCall.mock.calls.filter((c) => c[0] === 'setup.recordSetupInvocation');
+        expect(invocationCalls).toHaveLength(1);
+        expect(invocationCalls[0][1]).toMatchObject({ surfaceCapability: 'cli' });
+    });
+    it('records invocation with chat-only when state.surfaceCapability=chat-only (WP-431 S3 review fix #1)', async () => {
+        // Pre-revision: this test fabricated a `reasonForPhase` string the producer
+        // never emits and asserted that the (now-deleted) `inferSurfaceCapability`
+        // string-greppy heuristic returned 'chat-only'. The heuristic was broken
+        // (producer never emits 'chat-only' in reasonForPhase), so every chat-only
+        // user was silently tagged 'cli'. Post-revision, the resolver surfaces
+        // `surfaceCapability` as a structural field — the CLI reads it directly.
+        const chatOnly = {
+            ...SAMPLE,
+            phase: 3,
+            role: 'creator',
+            reasonForPhase: 'Phase 2 done (surface-skipped per DEC-993); catalogAdoptionCount=0 → Phase 3.',
+            surfaceCapability: 'chat-only',
+        };
+        mockedKernelCall
+            .mockResolvedValueOnce(chatOnly)
+            .mockResolvedValueOnce({ firstSetupInvocationAt: 1, alreadyRecorded: false });
+        await runSetup({ cwd: scratch });
+        const invocationCalls = mockedKernelCall.mock.calls.filter((c) => c[0] === 'setup.recordSetupInvocation');
+        expect(invocationCalls[0][1]).toMatchObject({ surfaceCapability: 'chat-only' });
+    });
+    it('chat-only resolver path: empty manifest + chat-only state → state.surfaceCapability="chat-only" (live resolver)', async () => {
+        // WP-431 S3 review fix #1: assert the actual resolver emits surfaceCapability
+        // structurally. This is a unit-level pin against the *resolver* (not the
+        // CLI handler), so we exercise resolveSetupState directly with a
+        // chat-only input shape that DOES occur in production
+        // (manifest.surfaces=['mcp-only'] is the upstream stamp for chat-only
+        // surfaces per DEC-993).
+        const { resolveSetupState } = await import('../../setup/state-machine.js');
+        const out = resolveSetupState({
+            manifest: { surfaces: ['mcp-only'] },
+            assetCounts: { totalAssets: 0, totalUnimported: 0, hasMore: false },
+            catalogAdoptionCount: 0,
+            confirmedEntryCount: 0,
+            entriesAcrossCollections: 0,
+            retrievalDemoConfirmed: false,
+            workspaceMaterialized: false,
+            userActivated: false,
+            surfaceCapability: 'chat-only',
+        });
+        expect(out.surfaceCapability).toBe('chat-only');
+    });
+});
+//# sourceMappingURL=setup-state.test.js.map

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

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

package/dist/commands/admin/seed.d.ts

@@ -3,6 +3,10 @@
  *
  * Seed metadata is duplicated from `convex/admin/commandManifest.ts` for CLI help
  * and ordering only — behavior is enforced server-side (STD-101).
+ *
+ * WP-433 S1b D13: the 4 substrate-repair migrations + backfill-default-team are
+ * generated from `convex/admin/seed/registry.ts` (single SSOT) into
+ * `seedRegistryEntries.generated.ts`. Run `npm run codegen` to refresh after registry edits.
  */
 import { Command } from 'commander';
 export type SeedCommandMeta = {
@@ -18,9 +22,35 @@ export type SeedCommandMeta = {
  * Order matches `ADMIN_COMMANDS` seed block in commandManifest.ts — dependency order for `seed all`.
  */
 export declare const SEED_COMMAND_ENTRIES: readonly SeedCommandMeta[];
-/** Manifest order for `pb admin seed all`. */
+/**
+ * Manifest order for `pb admin seed all`.
+ *
+ * Includes the static legacy seeds plus the registry-generated runnable entries so
+ * `seed all` exercises the full surface (D13 SSOT).
+ */
 export declare const SEED_MANIFEST_ORDER: readonly string[];
-/** Accept `knowledge` or `seed:knowledge`. */
+/**
+ * Accept short-form or long-form seed op names; return the canonical backend command name.
+ *
+ * Static entries (legacy) are stored as `seed:<slug>` (e.g. `seed:knowledge`).
+ * Registry-generated entries (WP-433 S1b) are stored as bare slugs (e.g.
+ * `seed-system-glossary`) to avoid the double-prefix `seed:seed-*` trap that
+ * arose when slugs like `seed-system-glossary` were naively stored as
+ * `seed:seed-system-glossary`.
+ *
+ * Both forms always return the backend command name (`seed:<bare-slug>`):
+ *   - `'system-glossary'` or `'seed-system-glossary'` → `'seed:seed-system-glossary'`
+ *     would be wrong; instead the bare slug stored in the map IS `seed-system-glossary`
+ *     and the backend command is `seed:seed-system-glossary`.
+ *
+ * Resolution order:
+ *   1. Try `seed:<t>` — covers legacy static entries (`seed:knowledge`) and any input
+ *      that normalises to a key already stored with the `seed:` prefix.
+ *   2. Try bare `<t>` (stripping a leading `seed:` from the input if present) —
+ *      covers registry entries stored without the prefix.
+ *      When found via bare slug, return `seed:<bare>` so the caller always gets a
+ *      backend-compatible command name.
+ */
 export declare function normalizeSeedCommandName(input: string): string;
 /**
  * Build args for seed:backfill-starter with CLI-side validation.

package/dist/commands/admin/seed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../src/commands/admin/seed.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,MAAM,MAAM,eAAe,GAAG;IAC5B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,eAAe,EA+GjD,CAAC;AAIX,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAA4C,CAAC;AAM9F,8CAA8C;AAC9C,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB9D;AAID;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuB1B;AAkBD,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmCzB;AA2FD,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAshBtD"}
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../src/commands/admin/seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCpC,MAAM,MAAM,eAAe,GAAG;IAC5B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,eAAe,EAkHjD,CAAC;AAwBX;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAEhD,CAAC;AAkBF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA4B9D;AAID;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuB1B;AAkBD,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsCzB;AAuRD,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAikBtD"}