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

package/dist/__tests__/conversation.test.js

@@ -0,0 +1,113 @@
+/**
+ * WP-479 E2 (client half) — conversation identity resolution + normalization.
+ *
+ * Done-when criteria tested:
+ *   1. Priority order: explicit override > PB_CONVERSATION_ID > CLAUDE_CODE_SESSION_ID >
+ *      CURSOR_CONVERSATION_ID > CODEX_TUI_SESSION_LOG_PATH > null.
+ *   2. Normalization: ids over 128 chars, or containing any char outside [A-Za-z0-9._-], are
+ *      replaced with their sha256 hex digest — never truncated (join-key stability).
+ *   3. CODEX_TUI_SESSION_LOG_PATH (a filesystem path, always containing "/") is always hashed.
+ *   4. No identity signal at all resolves to null (legacy path).
+ */
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { createHash } from 'crypto';
+import { resolveConversationId, normalizeConversationId } from '../lib/conversation.js';
+const ENV_KEYS = [
+    'PB_CONVERSATION_ID',
+    'CLAUDE_CODE_SESSION_ID',
+    'CURSOR_CONVERSATION_ID',
+    'CODEX_TUI_SESSION_LOG_PATH',
+];
+const savedEnv = {};
+beforeEach(() => {
+    for (const key of ENV_KEYS) {
+        savedEnv[key] = process.env[key];
+        delete process.env[key];
+    }
+});
+afterEach(() => {
+    for (const key of ENV_KEYS) {
+        if (savedEnv[key] === undefined)
+            delete process.env[key];
+        else
+            process.env[key] = savedEnv[key];
+    }
+});
+function sha256(s) {
+    return createHash('sha256').update(s).digest('hex');
+}
+describe('resolveConversationId() — priority order', () => {
+    it('returns null when no signal is present at all (legacy path)', () => {
+        expect(resolveConversationId()).toBeNull();
+    });
+    it('detects PB_CONVERSATION_ID when nothing else is set', () => {
+        process.env.PB_CONVERSATION_ID = 'conv-abc';
+        expect(resolveConversationId()).toBe('conv-abc');
+    });
+    it('detects CLAUDE_CODE_SESSION_ID when PB_CONVERSATION_ID is absent', () => {
+        process.env.CLAUDE_CODE_SESSION_ID = 'claude-sess-1';
+        expect(resolveConversationId()).toBe('claude-sess-1');
+    });
+    it('detects CURSOR_CONVERSATION_ID when the two above are absent', () => {
+        process.env.CURSOR_CONVERSATION_ID = 'cursor-conv-1';
+        expect(resolveConversationId()).toBe('cursor-conv-1');
+    });
+    it('hashes CODEX_TUI_SESSION_LOG_PATH when it is the only signal', () => {
+        process.env.CODEX_TUI_SESSION_LOG_PATH = '/tmp/codex/session-log-1.jsonl';
+        expect(resolveConversationId()).toBe(sha256('/tmp/codex/session-log-1.jsonl'));
+    });
+    it('PB_CONVERSATION_ID wins over every other env channel', () => {
+        process.env.PB_CONVERSATION_ID = 'winner';
+        process.env.CLAUDE_CODE_SESSION_ID = 'loser-1';
+        process.env.CURSOR_CONVERSATION_ID = 'loser-2';
+        process.env.CODEX_TUI_SESSION_LOG_PATH = '/tmp/loser-3';
+        expect(resolveConversationId()).toBe('winner');
+    });
+    it('CLAUDE_CODE_SESSION_ID wins over CURSOR_CONVERSATION_ID and CODEX', () => {
+        process.env.CLAUDE_CODE_SESSION_ID = 'winner';
+        process.env.CURSOR_CONVERSATION_ID = 'loser-1';
+        process.env.CODEX_TUI_SESSION_LOG_PATH = '/tmp/loser-2';
+        expect(resolveConversationId()).toBe('winner');
+    });
+    it('CURSOR_CONVERSATION_ID wins over CODEX', () => {
+        process.env.CURSOR_CONVERSATION_ID = 'winner';
+        process.env.CODEX_TUI_SESSION_LOG_PATH = '/tmp/loser';
+        expect(resolveConversationId()).toBe('winner');
+    });
+    it('an explicit override wins over every env channel (the --conversation flag seam)', () => {
+        process.env.PB_CONVERSATION_ID = 'env-value';
+        expect(resolveConversationId('flag-value')).toBe('flag-value');
+    });
+    it('an empty-string / whitespace-only explicit override is ignored, falling through to env', () => {
+        process.env.PB_CONVERSATION_ID = 'env-value';
+        expect(resolveConversationId('   ')).toBe('env-value');
+        expect(resolveConversationId('')).toBe('env-value');
+    });
+});
+describe('normalizeConversationId() — join-key safety', () => {
+    it('leaves a short, safe-charset id untouched', () => {
+        expect(normalizeConversationId('abc-123.DEF_456')).toBe('abc-123.DEF_456');
+    });
+    it('hashes an id over 128 chars — never truncates (no slice-collision risk)', () => {
+        const long = 'a'.repeat(129);
+        expect(normalizeConversationId(long)).toBe(sha256(long));
+        // A 128-char id (the boundary) stays untouched.
+        const boundary = 'a'.repeat(128);
+        expect(normalizeConversationId(boundary)).toBe(boundary);
+    });
+    it('hashes an id containing a path separator (path-escape closed, Pass 5)', () => {
+        const traversal = '../../etc/passwd';
+        expect(normalizeConversationId(traversal)).toBe(sha256(traversal));
+    });
+    it('hashes an id containing any other unsafe char (space, colon, slash, etc.)', () => {
+        expect(normalizeConversationId('has space')).toBe(sha256('has space'));
+        expect(normalizeConversationId('has:colon')).toBe(sha256('has:colon'));
+        expect(normalizeConversationId('has/slash')).toBe(sha256('has/slash'));
+    });
+    it('two distinct long ids that would collide under slice() hash to different values', () => {
+        const idA = 'x'.repeat(200) + 'AAA';
+        const idB = 'x'.repeat(200) + 'BBB';
+        expect(normalizeConversationId(idA)).not.toBe(normalizeConversationId(idB));
+    });
+});
+//# sourceMappingURL=conversation.test.js.map

package/dist/__tests__/conversation.test.js.map

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

package/dist/__tests__/entry-formatter.test.d.ts

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

package/dist/__tests__/entry-formatter.test.d.ts.map

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

package/dist/__tests__/entry-formatter.test.js

@@ -0,0 +1,129 @@
+/**
+ * formatEntry — honest attestation qualifier on the `pb get` Verification line (WP-A T8).
+ * Chain: attestation-model spec §5 (connectors never re-derive), §11 (rollout: optional fields).
+ */
+import { describe, it, expect } from 'vitest';
+import { formatEntry } from '../formatters/entry.js';
+function baseEntry(overrides = {}) {
+    return {
+        entryId: 'TEN-1',
+        name: 'Example entry',
+        canonicalKey: 'tension',
+        collectionSlug: 'tensions',
+        status: 'active',
+        ...overrides,
+    };
+}
+describe('formatEntry — bracket shows the collection, not the semantic type (WP-771 S1b)', () => {
+    it('prints collectionSlug in the bracket, never canonicalKey', () => {
+        const output = formatEntry(baseEntry({ canonicalKey: 'tension', collectionSlug: 'tensions' }));
+        expect(output).toContain('[tensions]');
+        expect(output).not.toContain('[tension]');
+    });
+    it('falls back to "—" when collectionSlug is absent (old server, spec §11-style rollout)', () => {
+        const output = formatEntry(baseEntry({ collectionSlug: null }));
+        expect(output).toContain('[—]');
+    });
+    // WP-771 S1b round 2 (Codex P2, PRRT_kwDORS4ils6lGWJs): the header renders as ONE terminal
+    // line, but stripControlChars deliberately keeps \x0a (strip.ts:41) — a collection slug with
+    // an embedded newline must not forge an extra line here.
+    it('sanitizes an embedded newline in collectionSlug instead of forging an extra line', () => {
+        const output = formatEntry(baseEntry({ collectionSlug: 'tensions\nFAKE LINE: nothing to see here' }));
+        expect(output.split('\n')).not.toContain('FAKE LINE: nothing to see here');
+        expect(output).toContain('[tensions FAKE LINE: nothing to see here]');
+    });
+});
+describe('formatEntry — Verification line', () => {
+    it('shows the honest qualifier when verifiedBy + attestation are present', () => {
+        const output = formatEntry(baseEntry({
+            verificationStatus: 'verified',
+            verifiedBy: 'agent for Randy Hereman',
+            attestation: { strength: 'delegated' },
+        }));
+        expect(output).toContain('Verification: verified — by agent for Randy Hereman (delegated)');
+    });
+    it('falls back to the bare form when verifiedBy + attestation are absent (old server, spec §11)', () => {
+        const output = formatEntry(baseEntry({
+            verificationStatus: 'verified',
+        }));
+        expect(output).toContain('Verification: verified');
+        expect(output).not.toContain('Verification: verified —');
+    });
+    it('unverified entry is rendered unchanged, with no attestation suffix', () => {
+        const output = formatEntry(baseEntry({
+            verificationStatus: 'unverified',
+        }));
+        expect(output).toContain('Verification: unverified');
+        expect(output).not.toContain('Verification: unverified —');
+    });
+    // Final-review Fix 1: the pre-branch legacy corpus (no legs, no marker → basis
+    // 'legacy-unclassified', spec §7.1) must never render "— by <false founder name>
+    // (delegated)" — the server ships the resolved legacy string in verifiedBy.
+    it('renders the honest legacy qualifier when basis is not attested', () => {
+        const output = formatEntry(baseEntry({
+            verificationStatus: 'verified',
+            verifiedBy: 'legacy — unclassified',
+            attestation: { strength: 'delegated', basis: 'legacy-unclassified' },
+        }));
+        expect(output).toContain('Verification: verified (legacy — unclassified)');
+        expect(output).not.toContain('— by legacy — unclassified');
+    });
+});
+// WP-D (attestation spec §7.2): the ledger stays append-only — the false history
+// sentence stays as written; the server-derived qualifier renders BESIDE it.
+describe('formatEntry — History legacy qualifier', () => {
+    it('renders the server-shipped qualifier beside a legacy verified event', () => {
+        const output = formatEntry(baseEntry({
+            history: [
+                {
+                    timestamp: Date.UTC(2026, 2, 1),
+                    event: 'verified',
+                    changedBy: 'Randy Hereman',
+                    note: 'Entry verified by Randy Hereman',
+                    legacyQualifier: 'legacy record — reads as delegated (assumed delegated — never attributed)',
+                },
+            ],
+        }));
+        // The original sentence is preserved…
+        expect(output).toContain('Entry verified by Randy Hereman');
+        // …and the honest qualifier renders beside it.
+        expect(output).toContain('[legacy record — reads as delegated (assumed delegated — never attributed)]');
+    });
+    it('adds no qualifier when the server ships none (genuine attestation / old server)', () => {
+        const output = formatEntry(baseEntry({
+            history: [
+                { timestamp: Date.UTC(2026, 6, 1), event: 'verified', changedBy: 'agent:sess1', note: 'Entry verified by agent for Randy Hereman' },
+            ],
+        }));
+        expect(output).toContain('Entry verified by agent for Randy Hereman');
+        expect(output).not.toContain('[legacy');
+    });
+});
+// WP-753 O5b fix round 1 (item 2): a regression test that the imported kernel formatter (ONE
+// judged core, shared with MCP and the browser Rail) still renders the four canonical CLI
+// sentences (ids: true, the CLI default — a terminal user pastes them into a repair command).
+// Wording ruling revised in fix round 3 (item 7) — see kernel/organisationalAuthority/
+// ownerLine.test.ts for the same strings pinned at the source. DEC-1793 (RULE-632) deleted the
+// `default`/`overflow`/`unavailable` kinds and their cases; `none` replaces them.
+describe('formatEntry — Owner line (WP-753 O5b, kernel-sourced formatOwnerLine)', () => {
+    it('renders all four owner kinds with the CLI-canonical strings', () => {
+        const cases = [
+            [{ kind: 'one', team: { name: 'Product Team' }, role: { name: 'Team Lead' } }, 'Owner: Team Lead in Product Team'],
+            [{ kind: 'none' }, 'Owner: none'],
+            [{ kind: 'many', count: 3, truncated: false }, 'Owner: conflicting — 3 owners recorded'],
+            [{ kind: 'dangling', teamId: 't1', roleId: 'r1' }, "Owner: couldn't be resolved — the owning team or role is archived (team t1, role r1)"],
+        ];
+        for (const [owner, expected] of cases) {
+            expect(formatEntry(baseEntry({ owner }))).toContain(expected);
+        }
+    });
+    it('dangling with both names available leads with the names, ids still appended (CLI keeps ids)', () => {
+        const output = formatEntry(baseEntry({ owner: { kind: 'dangling', teamId: 't1', roleId: 'r1', team: { name: 'Dead Team' }, role: { name: 'Dead Role' } } }));
+        expect(output).toContain("Owner: couldn't be resolved — Dead Role in Dead Team is archived (team t1, role r1)");
+    });
+    it('dangling with only the role surviving leads with the role alone (WP-753 O5b fix round 3, addendum b)', () => {
+        const output = formatEntry(baseEntry({ owner: { kind: 'dangling', teamId: 't1', roleId: 'r1', role: { name: 'Dead Role' } } }));
+        expect(output).toContain("Owner: couldn't be resolved — role Dead Role is archived (team t1, role r1)");
+    });
+});
+//# sourceMappingURL=entry-formatter.test.js.map

package/dist/__tests__/entry-formatter.test.js.map

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

package/dist/__tests__/entry-preflight.test.d.ts

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

package/dist/__tests__/entry-preflight.test.d.ts.map

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

package/dist/__tests__/entry-preflight.test.js

@@ -0,0 +1,58 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { runEntryPreflight } from '../commands/entryPreflight.js';
+import { kernelCall } from '../lib/client.js';
+vi.mock('../lib/client.js', () => ({ kernelCall: vi.fn().mockResolvedValue({ checks: [], requiredFields: [], notice: '' }) }));
+vi.mock('../lib/config.js', () => ({ getConfigOrGuide: vi.fn().mockResolvedValue({}) }));
+let captured;
+vi.mock('../lib/runner.js', () => ({
+    runCliCommand: async ({ fn, formatPretty }) => {
+        const value = await fn();
+        captured = formatPretty?.(value);
+        return value;
+    },
+}));
+afterEach(() => { vi.clearAllMocks(); captured = undefined; });
+describe('entry preflight links', () => {
+    it('preserves mixed relationship types in one preflight request', async () => {
+        await runEntryPreflight({ collection: 'work-packages', link: ['validates:KR-1', 'commits_to:STR-1'] });
+        expect(kernelCall).toHaveBeenCalledWith('chain.preflightEntry', expect.objectContaining({ links: [{ entryId: 'KR-1', type: 'validates' }, { entryId: 'STR-1', type: 'commits_to' }] }));
+    });
+    it('preserves the existing bare-ID form and explicit type overrides', async () => {
+        await runEntryPreflight({ collection: 'work-packages', link: ['KR-1', 'informs:KR-2'], linkType: 'validates' });
+        expect(kernelCall).toHaveBeenCalledWith('chain.preflightEntry', expect.objectContaining({ links: [{ entryId: 'KR-1', type: 'validates' }, { entryId: 'KR-2', type: 'informs' }] }));
+    });
+    it.each(['KR-1', ':KR-1', 'validates:'])('refuses incomplete link %s before transport', async (link) => {
+        await expect(runEntryPreflight({ collection: 'work-packages', link: [link] })).rejects.toThrow('Use --link');
+        expect(kernelCall).not.toHaveBeenCalled();
+    });
+    /**
+     * The connector renders the same preflight (packages/mcp-server/src/lib/createEntryPreviewResult.ts,
+     * `renderEntryPreflight`) and its own test pins these EXACT lines: a reader must never have to
+     * guess whether a line stops acceptance, merely failed to complete, or is deferred to the write
+     * door — and the two surfaces must not disagree about the same check.
+     */
+    it('marks what blocks, what is unverified and what is checked later, byte for byte', async () => {
+        vi.mocked(kernelCall).mockResolvedValue({
+            checks: [
+                { id: 'relation:validates:min1', status: 'satisfied', blocking: true, message: 'validates: selected links satisfy the configured requirement.' },
+                { id: 'krsPerObjectiveCap:ws', status: 'missing', blocking: true, message: 'Key Result: 3 accepted of 3.' },
+                { id: 'outcome-context', status: 'missing', blocking: false, message: 'Accepted parent context is missing or incomplete.' },
+                { id: 'capacity-scan', status: 'incomplete', blocking: true, message: 'Capacity check incomplete: not all parent links could be checked.' },
+                { id: 'link-target:informs:KR-9', status: 'not_checked', blocking: false, message: 'KR-9 could not be resolved now; target existence and relation policy are checked at capture.' },
+            ],
+            requiredFields: ['Metric', 'Target'],
+            notice: 'Semantic alignment has not been assessed by this check.',
+        });
+        await runEntryPreflight({ collection: 'work-packages' });
+        expect(captured).toBe([
+            'validates: selected links satisfy the configured requirement.',
+            'Blocked: Key Result: 3 accepted of 3.',
+            'Accepted parent context is missing or incomplete.',
+            'Unverified: Capacity check incomplete: not all parent links could be checked.',
+            'Checked later: KR-9 could not be resolved now; target existence and relation policy are checked at capture.',
+            'Required information: Metric, Target.',
+            'Semantic alignment has not been assessed by this check.',
+        ].join('\n'));
+    });
+});
+//# sourceMappingURL=entry-preflight.test.js.map

package/dist/__tests__/entry-preflight.test.js.map

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

package/dist/__tests__/entryAccept-batch.test.d.ts

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

package/dist/__tests__/entryAccept-batch.test.d.ts.map

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