@productbrain/cli 0.1.0-beta.9 → 0.1.0-beta.90

package/dist/__tests__/batch-transformations.test.js

@@ -0,0 +1,263 @@
+/**
+ * BET-270 S1: Batch transformation tests for surface-optimized skill projection.
+ * Tests applyBatchTransformations + generateCodexSkill batch mode + Claude/Cursor unchanged.
+ */
+import { describe, expect, it } from 'vitest';
+import { applyBatchTransformations, generateCodexSkill, generateCursorSkill, generateClaudeRule, generateClaudeSkillRouter, } from '../generators/portable-knowledge.js';
+import { SURFACE_PROFILES } from '../generators/surface-profiles.js';
+describe('applyBatchTransformations', () => {
+    it('strips sub-agent spawn patterns and replaces with inline step instruction', () => {
+        const body = `# My Skill
+
+Do some work.
+Spawn a sub-agent to handle the review.
+Continue with the result.`;
+        const result = applyBatchTransformations(body);
+        expect(result).not.toContain('Spawn a sub-agent');
+        expect(result).toContain('Execute as inline steps within this session.');
+        expect(result).toContain('Do some work.');
+        expect(result).toContain('Continue with the result.');
+    });
+    it('strips SPAWN build sub-agent pattern (uppercase SPAWN)', () => {
+        const body = `# Heading
+
+SPAWN build sub-agent with primer.
+Other content.`;
+        const result = applyBatchTransformations(body);
+        expect(result).not.toContain('SPAWN build sub-agent');
+        expect(result).toContain('Execute as inline steps within this session.');
+    });
+    it('strips SPAWN review sub-agent pattern', () => {
+        const body = `# Heading
+
+SPAWN review sub-agent for verification.
+Done.`;
+        const result = applyBatchTransformations(body);
+        expect(result).not.toContain('SPAWN review sub-agent');
+        expect(result).toContain('Execute as inline steps within this session.');
+    });
+    it('strips "fresh conversation handoff" pattern', () => {
+        const body = `# Heading
+
+Use fresh conversation handoff for next slice.
+Continue.`;
+        const result = applyBatchTransformations(body);
+        expect(result).not.toContain('fresh conversation handoff');
+        expect(result).toContain('Execute as inline steps within this session.');
+    });
+    it('strips user confirmation gates — "Ask the user"', () => {
+        const body = `# Skill
+
+Do work.
+Ask the user before proceeding.
+Continue.`;
+        const result = applyBatchTransformations(body);
+        expect(result).not.toContain('Ask the user');
+        expect(result).toContain('Proceed autonomously. Log decision rationale.');
+        expect(result).toContain('Do work.');
+        expect(result).toContain('Continue.');
+    });
+    it('strips user confirmation gates — "Wait for user input"', () => {
+        const body = `# Skill
+
+Step one done.
+Wait for user input before continuing.
+Step two.`;
+        const result = applyBatchTransformations(body);
+        expect(result).not.toContain('Wait for user input');
+        expect(result).toContain('Proceed autonomously. Log decision rationale.');
+    });
+    it('strips user confirmation gates — "Present gate to user"', () => {
+        const body = `# Skill
+
+Build the feature.
+Present gate to user before merging.
+Merge.`;
+        const result = applyBatchTransformations(body);
+        expect(result).not.toContain('Present gate to user');
+        expect(result).toContain('Proceed autonomously. Log decision rationale.');
+    });
+    it('strips user confirmation gates — "STOP and ask"', () => {
+        const body = `# Skill
+
+Analyze problem.
+STOP and ask the user whether to continue.
+Then proceed.`;
+        const result = applyBatchTransformations(body);
+        expect(result).not.toContain('STOP and ask');
+        expect(result).toContain('Proceed autonomously. Log decision rationale.');
+    });
+    it('adds batch governance header after the first # heading', () => {
+        const body = `# My Skill
+
+Some content here.`;
+        const result = applyBatchTransformations(body);
+        expect(result).toContain('> Batch execution mode: This skill runs autonomously without interactive gates. Decisions are logged, not prompted.');
+        // Header must appear right after the heading
+        const lines = result.split('\n');
+        const headingIdx = lines.findIndex((l) => l.startsWith('# My Skill'));
+        const batchHeaderIdx = lines.findIndex((l) => l.includes('Batch execution mode:'));
+        expect(headingIdx).toBeGreaterThanOrEqual(0);
+        expect(batchHeaderIdx).toBeGreaterThan(headingIdx);
+        expect(batchHeaderIdx - headingIdx).toBeLessThanOrEqual(3);
+    });
+    it('preserves non-interactive content unchanged', () => {
+        const body = `# Clean Skill
+
+This skill has no interactive patterns.
+It describes steps the agent should follow.
+Use grep to find the file.
+Run npm run build.`;
+        const result = applyBatchTransformations(body);
+        expect(result).toContain('This skill has no interactive patterns.');
+        expect(result).toContain('It describes steps the agent should follow.');
+        expect(result).toContain('Use grep to find the file.');
+        expect(result).toContain('Run npm run build.');
+        expect(result).toContain('Batch execution mode:');
+    });
+    it('preserves interactive patterns inside fenced code blocks', () => {
+        const body = `# Skill With Examples
+
+Here is how it works in interactive mode:
+
+\`\`\`
+Spawn a sub-agent to handle the review.
+Ask the user before proceeding.
+Wait for user input.
+\`\`\`
+
+Normal prose outside the fence.
+Spawn a sub-agent for the next step.`;
+        const result = applyBatchTransformations(body);
+        // Patterns inside the code fence must be preserved verbatim
+        expect(result).toContain('Spawn a sub-agent to handle the review.');
+        expect(result).toContain('Ask the user before proceeding.');
+        expect(result).toContain('Wait for user input.');
+        // Pattern outside the code fence must be transformed
+        expect(result).not.toContain('Spawn a sub-agent for the next step.');
+        expect(result).toContain('Execute as inline steps within this session.');
+    });
+    it('preserves patterns inside tilde-fenced code blocks', () => {
+        const body = `# Skill
+
+~~~bash
+Ask the user for confirmation.
+~~~
+
+Ask the user to approve.`;
+        const result = applyBatchTransformations(body);
+        // Inside fence: preserved
+        expect(result).toContain('Ask the user for confirmation.');
+        // Outside fence: transformed
+        expect(result).not.toContain('Ask the user to approve.');
+        expect(result).toContain('Proceed autonomously. Log decision rationale.');
+    });
+    it('does not transform every mention of "user" — only clear interactive gate patterns', () => {
+        const body = `# Skill
+
+The user should be aware of this tradeoff.
+User data must be validated before insert.`;
+        const result = applyBatchTransformations(body);
+        expect(result).toContain('The user should be aware of this tradeoff.');
+        expect(result).toContain('User data must be validated before insert.');
+        expect(result).not.toContain('Proceed autonomously. Log decision rationale.');
+    });
+});
+describe('generateCodexSkill — batch mode (BET-270 S1)', () => {
+    const baseSkill = {
+        name: 'orchestrate',
+        description: 'Orchestrate a bet slice.',
+        triggers: ['orchestrate'],
+        body: `# Orchestrate
+
+Do planning.
+Spawn a sub-agent to execute.
+Ask the user to confirm the plan.
+Finalize.`,
+        sourcePath: '/tmp/.productbrain/skills/orchestrate.md',
+    };
+    it('applies batch transformations when profile.executionModel is batch', () => {
+        const output = generateCodexSkill(baseSkill, SURFACE_PROFILES.codex);
+        expect(output).not.toContain('Spawn a sub-agent');
+        expect(output).not.toContain('Ask the user');
+        expect(output).toContain('Execute as inline steps within this session.');
+        expect(output).toContain('Proceed autonomously. Log decision rationale.');
+        expect(output).toContain('Batch execution mode:');
+    });
+    it('produces CURRENT output (no batch transforms) when profile is undefined — backward compat', () => {
+        const output = generateCodexSkill(baseSkill, undefined);
+        expect(output).toContain('Spawn a sub-agent to execute.');
+        expect(output).toContain('Ask the user to confirm the plan.');
+        expect(output).not.toContain('Batch execution mode:');
+    });
+    it('includes skill name, description, triggers in both modes', () => {
+        const withProfile = generateCodexSkill(baseSkill, SURFACE_PROFILES.codex);
+        const withoutProfile = generateCodexSkill(baseSkill, undefined);
+        for (const output of [withProfile, withoutProfile]) {
+            expect(output).toContain('# orchestrate');
+            expect(output).toContain('Orchestrate a bet slice.');
+            expect(output).toContain('`orchestrate`');
+        }
+    });
+    it('still performs path replacement before batch transforms', () => {
+        const skillWithPath = {
+            ...baseSkill,
+            body: `# Path Skill
+
+Read \`.productbrain/skills/preflight.md\` before starting.
+Ask the user for approval.`,
+        };
+        const output = generateCodexSkill(skillWithPath, SURFACE_PROFILES.codex);
+        expect(output).toContain('.codex/skills/preflight.md');
+        expect(output).not.toContain('.productbrain/skills/preflight.md');
+        expect(output).not.toContain('Ask the user');
+    });
+});
+describe('generateCursorSkill / generateClaudeRule / generateClaudeSkillRouter — profile ignored (BET-270 S1)', () => {
+    const skill = {
+        name: 'test-skill',
+        description: 'Test skill',
+        triggers: ['test'],
+        body: `# Test Skill
+
+Ask the user to confirm.
+Spawn a sub-agent.
+Normal content.`,
+        sourcePath: '/tmp/.productbrain/skills/test-skill.md',
+    };
+    const rule = {
+        name: 'test-rule',
+        description: 'A test rule',
+        autoApply: true,
+        body: '# Rule body\n\nAsk the user to confirm.\nNormal content.',
+        sourcePath: '/tmp/.productbrain/rules/test-rule.md',
+    };
+    it('generateCursorSkill preserves interactive content regardless of profile', () => {
+        const withProfile = generateCursorSkill(skill, SURFACE_PROFILES.cursor);
+        const withCodexProfile = generateCursorSkill(skill, SURFACE_PROFILES.codex);
+        for (const output of [withProfile, withCodexProfile]) {
+            expect(output).toContain('Ask the user to confirm.');
+            expect(output).toContain('Spawn a sub-agent.');
+            expect(output).not.toContain('Batch execution mode:');
+            expect(output).not.toContain('Proceed autonomously');
+        }
+    });
+    it('generateClaudeRule preserves interactive content regardless of profile', () => {
+        const withProfile = generateClaudeRule(rule, SURFACE_PROFILES.claude);
+        const withCodexProfile = generateClaudeRule(rule, SURFACE_PROFILES.codex);
+        for (const output of [withProfile, withCodexProfile]) {
+            expect(output).toContain('Ask the user to confirm.');
+            expect(output).not.toContain('Batch execution mode:');
+            expect(output).not.toContain('Proceed autonomously');
+        }
+    });
+    it('generateClaudeSkillRouter preserves interactive content regardless of profile', () => {
+        const withProfile = generateClaudeSkillRouter([skill], SURFACE_PROFILES.claude);
+        const withCodexProfile = generateClaudeSkillRouter([skill], SURFACE_PROFILES.codex);
+        for (const output of [withProfile, withCodexProfile]) {
+            expect(output).toContain('test-skill');
+            expect(output).toContain('Skill Router');
+        }
+    });
+});
+//# sourceMappingURL=batch-transformations.test.js.map

package/dist/__tests__/batch-transformations.test.js.map

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

package/dist/__tests__/capture.test.js

@@ -1,12 +1,13 @@
 /**
- * pb capture extensions — --link, --json flags.
+ * pb capture extensions — --link, --json flags, WP-319 grounding.
  * TEN-341 test contract: capture --link calls createEntryRelation, capture --json outputs JSON.
+ * WP-319 S3: grounding fires in parallel, fail-open, --suggest-only, --strict, PB_GROUNDING_MODE.
  */
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { runCapture } from '../commands/capture.js';
-const mcpCallWithSessionMock = vi.fn();
+const kernelCallWithSessionMock = vi.fn();
 vi.mock('../lib/client.js', () => ({
-    mcpCallWithSession: (...args) => mcpCallWithSessionMock(...args),
+    kernelCallWithSession: (...args) => kernelCallWithSessionMock(...args),
 }));
 vi.mock('../lib/config.js', () => ({
     getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
@@ -18,17 +19,30 @@ vi.mock('../lib/session.js', () => ({
 }));
 describe('runCapture --link', () => {
     beforeEach(() => {
-        mcpCallWithSessionMock.mockReset();
+        kernelCallWithSessionMock.mockReset();
         mockSession = { sessionId: 'sess-test' };
     });
     it('creates entry then links to target with default relation type', async () => {
-        mcpCallWithSessionMock
-            .mockResolvedValueOnce({ collection: 'tensions', confidence: 0.9, tier: 'high' })
-            .mockResolvedValueOnce({ docId: 'doc-1', entryId: 'TEN-710' })
-            .mockResolvedValueOnce({});
+        // Prefix "TEN:" is extracted → skips classification, routes directly to tensions
+        kernelCallWithSessionMock.mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.resolve([]);
+            if (fn === 'chain.createEntry')
+                return Promise.resolve({ docId: 'doc-1', entryId: 'TEN-710' });
+            if (fn === 'chain.createEntryRelation')
+                return Promise.resolve({});
+            return Promise.resolve({});
+        });
         const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
         await runCapture({ text: 'TEN: missing validation', link: 'BET-151' });
-        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.createEntryRelation', {
+        // Verify classification was skipped (no resolveCollection call)
+        expect(kernelCallWithSessionMock).not.toHaveBeenCalledWith('chain.resolveCollection', expect.anything());
+        // Verify prefix was stripped from entry name and routed to correct collection
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.createEntry', expect.objectContaining({
+            collectionSlug: 'tensions',
+            name: 'missing validation',
+        }));
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.createEntryRelation', {
             fromEntryId: 'TEN-710',
             toEntryId: 'BET-151',
             type: 'surfaces_tension_in',
@@ -36,13 +50,20 @@ describe('runCapture --link', () => {
         writeSpy.mockRestore();
     });
     it('uses custom relation type when --type provided', async () => {
-        mcpCallWithSessionMock
-            .mockResolvedValueOnce({ collection: 'insights', confidence: 0.8, tier: 'high' })
-            .mockResolvedValueOnce({ docId: 'doc-2', entryId: 'INS-50' })
-            .mockResolvedValueOnce({});
+        // Prefix "INS:" is extracted → skips classification, routes directly to insights
+        kernelCallWithSessionMock.mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.resolve([]);
+            if (fn === 'chain.createEntry')
+                return Promise.resolve({ docId: 'doc-2', entryId: 'INS-50' });
+            if (fn === 'chain.createEntryRelation')
+                return Promise.resolve({});
+            return Promise.resolve({});
+        });
         const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
         await runCapture({ text: 'INS: discovered X', link: 'DEC-264', type: 'informed_by' });
-        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.createEntryRelation', {
+        expect(kernelCallWithSessionMock).not.toHaveBeenCalledWith('chain.resolveCollection', expect.anything());
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.createEntryRelation', {
             fromEntryId: 'INS-50',
             toEntryId: 'DEC-264',
             type: 'informed_by',
@@ -52,13 +73,18 @@ describe('runCapture --link', () => {
 });
 describe('runCapture --json', () => {
     beforeEach(() => {
-        mcpCallWithSessionMock.mockReset();
+        kernelCallWithSessionMock.mockReset();
         mockSession = { sessionId: 'sess-test' };
     });
     it('outputs valid JSON with id field and no other stdout', async () => {
-        mcpCallWithSessionMock
-            .mockResolvedValueOnce({ collection: 'tensions', confidence: 0.9, tier: 'high' })
-            .mockResolvedValueOnce({ docId: 'doc-1', entryId: 'TEN-711' });
+        // Prefix "TEN:" is extracted → skips classification
+        kernelCallWithSessionMock.mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.resolve([]);
+            if (fn === 'chain.createEntry')
+                return Promise.resolve({ docId: 'doc-1', entryId: 'TEN-711' });
+            return Promise.resolve({});
+        });
         let stdoutOutput = '';
         const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
             stdoutOutput += String(chunk);
@@ -83,4 +109,269 @@ describe('runCapture --json', () => {
         expect(output).toHaveProperty('confidence');
     });
 });
+describe('runCapture description field routing', () => {
+    beforeEach(() => {
+        kernelCallWithSessionMock.mockReset();
+        mockSession = { sessionId: 'sess-test' };
+    });
+    it('passes description key to createEntry for assumptions (TEN-1258 — remap happens in Convex)', async () => {
+        // The CLI always sends `description` — the Convex write gate remaps it to `belief`
+        // for the assumptions collection (TEN-1258). Verify the CLI routes correctly and
+        // sends the text as description so the Convex remap can fire.
+        kernelCallWithSessionMock.mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.resolve([]);
+            if (fn === 'chain.createEntry')
+                return Promise.resolve({ docId: 'doc-5', entryId: 'ASM-1' });
+            return Promise.resolve({});
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runCapture({ text: 'ASM: users won\'t pay before seeing value' });
+        const createCall = kernelCallWithSessionMock.mock.calls.find(([fn]) => fn === 'chain.createEntry');
+        expect(createCall?.[1]).toMatchObject({
+            collectionSlug: 'assumptions',
+            name: "users won't pay before seeing value",
+            data: { description: "users won't pay before seeing value" },
+        });
+        writeSpy.mockRestore();
+    });
+});
+describe('runCapture classification guard', () => {
+    beforeEach(() => {
+        kernelCallWithSessionMock.mockReset();
+        mockSession = { sessionId: 'sess-test' };
+    });
+    it('throws CLIError when classification requires review', async () => {
+        kernelCallWithSessionMock.mockResolvedValueOnce(null);
+        await expect(runCapture({ text: 'Ambiguous capture' })).rejects.toThrow('Classification needs review before capture can continue.');
+    });
+});
+describe('runCapture date inference', () => {
+    beforeEach(() => {
+        kernelCallWithSessionMock.mockReset();
+        mockSession = { sessionId: 'sess-test' };
+    });
+    it('does not default date to today when no source date is present', async () => {
+        kernelCallWithSessionMock.mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.resolve([]);
+            if (fn === 'chain.resolveCollection')
+                return Promise.resolve({ collection: 'decisions', confidence: 0.9, tier: 'high' });
+            if (fn === 'chain.createEntry')
+                return Promise.resolve({ docId: 'doc-3', entryId: 'DEC-10' });
+            return Promise.resolve({});
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runCapture({ text: 'Decision without explicit source date' });
+        const createCall = kernelCallWithSessionMock.mock.calls.find(([fn]) => fn === 'chain.createEntry');
+        expect(createCall?.[1]).toMatchObject({
+            collectionSlug: 'decisions',
+            data: { description: 'Decision without explicit source date' },
+        });
+        expect((createCall?.[1]).data).not.toHaveProperty('date');
+        writeSpy.mockRestore();
+    });
+    it('uses inferred source date when the capture text includes one', async () => {
+        kernelCallWithSessionMock.mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.resolve([]);
+            if (fn === 'chain.resolveCollection')
+                return Promise.resolve({ collection: 'decisions', confidence: 0.9, tier: 'high' });
+            if (fn === 'chain.createEntry')
+                return Promise.resolve({ docId: 'doc-4', entryId: 'DEC-11' });
+            return Promise.resolve({});
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runCapture({ text: 'Decision from April 1, 2026 steering meeting' });
+        const createCall = kernelCallWithSessionMock.mock.calls.find(([fn]) => fn === 'chain.createEntry');
+        expect((createCall?.[1]).data.date).toBe('2026-04-01');
+        writeSpy.mockRestore();
+    });
+});
+// ---------------------------------------------------------------------------
+// WP-319 S3: Pre-write grounding tests
+// ---------------------------------------------------------------------------
+describe('runCapture WP-319 grounding', () => {
+    const emptyGrounding = { index: 0, related: [], duplicates: [], governance: [], v: 1 };
+    const groundingWithDuplicate = {
+        index: 0,
+        related: [],
+        duplicates: [{ entryId: 'TEN-5', name: 'Similar tension', collectionSlug: 'tensions', matchType: 'possible_duplicate', overlapRatio: 0.9 }],
+        governance: [],
+        v: 1,
+    };
+    beforeEach(() => {
+        kernelCallWithSessionMock.mockReset();
+        mockSession = { sessionId: 'sess-test' };
+        delete process.env.PB_GROUNDING_MODE;
+    });
+    it('fires chain.suggestLinksForCapture in parallel and still calls createEntry', async () => {
+        // Prefix-based route skips classification; grounding fires for TEN prefix
+        kernelCallWithSessionMock
+            .mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.resolve([emptyGrounding]);
+            if (fn === 'chain.createEntry')
+                return Promise.resolve({ docId: 'doc-1', entryId: 'TEN-720' });
+            return Promise.resolve({});
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        await runCapture({ text: 'TEN: grounding test tension' });
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.suggestLinksForCapture', expect.objectContaining({
+            entries: expect.arrayContaining([expect.objectContaining({ name: 'grounding test tension' })]),
+        }));
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.createEntry', expect.anything());
+        writeSpy.mockRestore();
+        stderrSpy.mockRestore();
+    });
+    it('does NOT block capture when grounding call fails', async () => {
+        kernelCallWithSessionMock
+            .mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.reject(new Error('network error'));
+            if (fn === 'chain.createEntry')
+                return Promise.resolve({ docId: 'doc-2', entryId: 'TEN-721' });
+            return Promise.resolve({});
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        // Must not throw — grounding failure is fail-open
+        await expect(runCapture({ text: 'TEN: grounding failure test' })).resolves.toBeUndefined();
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.createEntry', expect.anything());
+        writeSpy.mockRestore();
+        stderrSpy.mockRestore();
+    });
+    it('--suggest-only does NOT call createEntry and outputs grounding data', async () => {
+        // In test env (non-TTY), isJsonMode() returns true → JSON path is taken.
+        kernelCallWithSessionMock
+            .mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.resolve([groundingWithDuplicate]);
+            return Promise.resolve({});
+        });
+        let stdoutOutput = '';
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+            stdoutOutput += String(chunk);
+            return true;
+        });
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        await runCapture({ text: 'TEN: duplicate candidate', suggestOnly: true });
+        expect(kernelCallWithSessionMock).not.toHaveBeenCalledWith('chain.createEntry', expect.anything());
+        // JSON output contains suggestOnly flag and grounding report
+        const jsonLines = stdoutOutput.split('\n').filter((l) => { try {
+            JSON.parse(l);
+            return true;
+        }
+        catch {
+            return false;
+        } });
+        expect(jsonLines).toHaveLength(1);
+        const parsed = JSON.parse(jsonLines[0]);
+        expect(parsed.suggestOnly).toBe(true);
+        expect(parsed.groundingReport).toBeDefined();
+        writeSpy.mockRestore();
+        stderrSpy.mockRestore();
+    });
+    it('--suggest-only with --json outputs machine-readable object without calling createEntry', async () => {
+        kernelCallWithSessionMock
+            .mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.resolve([emptyGrounding]);
+            return Promise.resolve({});
+        });
+        let stdoutOutput = '';
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+            stdoutOutput += String(chunk);
+            return true;
+        });
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        await runCapture({ text: 'TEN: dry run json', json: true, suggestOnly: true });
+        expect(kernelCallWithSessionMock).not.toHaveBeenCalledWith('chain.createEntry', expect.anything());
+        const jsonLines = stdoutOutput.split('\n').filter((l) => { try {
+            JSON.parse(l);
+            return true;
+        }
+        catch {
+            return false;
+        } });
+        expect(jsonLines).toHaveLength(1);
+        const parsed = JSON.parse(jsonLines[0]);
+        expect(parsed.suggestOnly).toBe(true);
+        writeSpy.mockRestore();
+        stderrSpy.mockRestore();
+    });
+    it('banner is suppressed when grounding has no matches (zero-noise floor)', async () => {
+        kernelCallWithSessionMock
+            .mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.resolve([emptyGrounding]);
+            if (fn === 'chain.createEntry')
+                return Promise.resolve({ docId: 'doc-3', entryId: 'TEN-722' });
+            return Promise.resolve({});
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        const stderrLines = [];
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation((chunk) => {
+            stderrLines.push(String(chunk));
+            return true;
+        });
+        await runCapture({ text: 'TEN: no matches tension' });
+        // No "Grounding" banner in stderr when zero matches
+        const groundingInStderr = stderrLines.some((l) => l.includes('Grounding'));
+        expect(groundingInStderr).toBe(false);
+        writeSpy.mockRestore();
+        stderrSpy.mockRestore();
+    });
+    it('PB_GROUNDING_MODE=off skips grounding call entirely', async () => {
+        process.env.PB_GROUNDING_MODE = 'off';
+        kernelCallWithSessionMock
+            .mockImplementation((fn) => {
+            if (fn === 'chain.createEntry')
+                return Promise.resolve({ docId: 'doc-4', entryId: 'TEN-723' });
+            return Promise.resolve({});
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        await runCapture({ text: 'TEN: no grounding env off' });
+        expect(kernelCallWithSessionMock).not.toHaveBeenCalledWith('chain.suggestLinksForCapture', expect.anything());
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.createEntry', expect.anything());
+        delete process.env.PB_GROUNDING_MODE;
+        writeSpy.mockRestore();
+        stderrSpy.mockRestore();
+    });
+    it('--json output stdout is clean (no grounding on stdout)', async () => {
+        kernelCallWithSessionMock
+            .mockImplementation((fn) => {
+            if (fn === 'chain.suggestLinksForCapture')
+                return Promise.resolve([groundingWithDuplicate]);
+            if (fn === 'chain.createEntry')
+                return Promise.resolve({ docId: 'doc-5', entryId: 'TEN-724' });
+            return Promise.resolve({});
+        });
+        let stdoutOutput = '';
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+            stdoutOutput += String(chunk);
+            return true;
+        });
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        await runCapture({ text: 'TEN: json clean stdout', json: true });
+        // Stdout must be exactly one valid JSON line (jq .id must work)
+        const jsonLines = stdoutOutput.split('\n').filter((l) => { try {
+            JSON.parse(l);
+            return true;
+        }
+        catch {
+            return false;
+        } });
+        expect(jsonLines).toHaveLength(1);
+        const parsed = JSON.parse(jsonLines[0]);
+        expect(parsed.id).toBe('TEN-724');
+        // No grounding content in stdout
+        expect(stdoutOutput).not.toContain('Grounding');
+        expect(stdoutOutput).not.toContain('duplicate');
+        writeSpy.mockRestore();
+        stderrSpy.mockRestore();
+    });
+});
 //# sourceMappingURL=capture.test.js.map