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

package/dist/__tests__/handshake-dormancy.test.js

@@ -0,0 +1,207 @@
+import { describe, expect, test } from 'vitest';
+import { relative, sep } from 'path';
+import { __test } from '../commands/handshake.js';
+describe('WP-426 E3 setupAuthoringPath precedence', () => {
+    test('authoringPath (relative to .productbrain) wins', () => {
+        expect(__test.setupAuthoringPath('/repo', { entryId: 'SETUP-FOO', name: 'Foo Bar', assetKind: 'skill', authoringPath: 'skills/my-foo.md' }))
+            .toBe('/repo/.productbrain/skills/my-foo.md');
+    });
+    test('null authoringPath falls back to name-derivation (unchanged)', () => {
+        expect(__test.setupAuthoringPath('/repo', { entryId: 'SETUP-FOO', name: 'Foo Bar', assetKind: 'skill', authoringPath: null }))
+            .toBe('/repo/.productbrain/skills/Foo Bar.md');
+    });
+});
+test('WP-426 E3 relative authoringPath is POSIX under .productbrain/, never absolute', () => {
+    expect(relative('/repo/.productbrain', '/repo/.productbrain/skills/foo.md').split(sep).join('/')).toBe('skills/foo.md');
+});
+import { mkdtempSync, writeFileSync, existsSync, readFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+const MARKER = __test.MARKER;
+function tmpFile(content, name = 'Foo.md') {
+    const p = join(mkdtempSync(join(tmpdir(), 'wp426-')), name);
+    writeFileSync(p, content);
+    return p;
+}
+describe('WP-426 E4 renameSurfaceForDormancy', () => {
+    test('renames a marked .md projection to .md.dormant', () => {
+        const p = tmpFile(`# x\n${MARKER}\n`);
+        expect(__test.renameSurfaceForDormancy(p)).toBe('renamed');
+        expect(existsSync(p)).toBe(false);
+        expect(existsSync(`${p}.dormant`)).toBe(true);
+    });
+    test('renames a marked .mdc projection', () => {
+        const p = tmpFile(`# x\n${MARKER}\n`, 'Foo.mdc');
+        expect(__test.renameSurfaceForDormancy(p)).toBe('renamed');
+        expect(existsSync(`${p}.dormant`)).toBe(true);
+    });
+    test('skips a file without the auto-gen MARKER (never touch user files)', () => {
+        const p = tmpFile('# hand-authored\n');
+        expect(__test.renameSurfaceForDormancy(p)).toBe('skipped');
+        expect(existsSync(p)).toBe(true);
+    });
+    test('idempotent: already-dormant when source gone + .dormant present', () => {
+        const p = tmpFile(`# x\n${MARKER}\n`);
+        __test.renameSurfaceForDormancy(p);
+        expect(__test.renameSurfaceForDormancy(p)).toBe('already-dormant');
+    });
+    test('legacy marker-only file still renames (not gated on marker write)', () => {
+        const p = tmpFile(`# x\n${MARKER}\n<!-- pb-status: dormant -->\n`);
+        expect(__test.renameSurfaceForDormancy(p)).toBe('renamed');
+    });
+    // Codex P1: when both the live file and a .dormant exist, an edited (divergent) .dormant
+    // must NOT be force-deleted — preserve it and report 'drift' instead of overwriting.
+    test('preserves an edited .dormant (divergent body) and reports drift instead of overwriting', () => {
+        const p = tmpFile(`# live\n${MARKER}\n`);
+        writeFileSync(`${p}.dormant`, `# USER EDITED DORMANT\n${MARKER}\n<!-- pb-status: dormant -->\n`);
+        expect(__test.renameSurfaceForDormancy(p)).toBe('drift');
+        expect(existsSync(p), 'live file preserved').toBe(true);
+        expect(existsSync(`${p}.dormant`), 'edited .dormant preserved').toBe(true);
+        expect(readFileSync(`${p}.dormant`, 'utf8')).toContain('USER EDITED DORMANT');
+    });
+    test('replaces a matching .dormant (same body) — safe, no data loss', () => {
+        const p = tmpFile(`# same\n${MARKER}\n`);
+        writeFileSync(`${p}.dormant`, `# same\n${MARKER}\n<!-- pb-status: dormant -->\n`);
+        expect(__test.renameSurfaceForDormancy(p)).toBe('replaced');
+        expect(existsSync(p), 'live file renamed away').toBe(false);
+        expect(existsSync(`${p}.dormant`)).toBe(true);
+    });
+});
+// WP-426 doneWhen #10: perimeter is containment-based (perimeter.ts:128-130),
+// not extension-gated — lock that .dormant targets pass under a surface dir.
+describe('WP-426 E4 perimeter accepts .dormant', () => {
+    test('.md.dormant / .mdc.dormant under a surface dir do not throw', async () => {
+        const { assertSetupWritePath } = await import('../setup/perimeter.js');
+        const manifest = { surfaces: ['.codex', '.cursor', '.claude'] };
+        expect(() => assertSetupWritePath('/repo/.cursor/rules/Foo.mdc.dormant', manifest, { cwd: '/repo' })).not.toThrow();
+        expect(() => assertSetupWritePath('/repo/.codex/skills/Foo.md.dormant', manifest, { cwd: '/repo' })).not.toThrow();
+    });
+});
+// WP-426 doneWhen #10 + Codex P1 (traversal rejection): a malicious authoringPath like
+// '../../etc/passwd' (or an absolute path) is probed via existsSync/readFileSync in the
+// writeback loop BEFORE any assertSetupWritePath write guard runs. The write-time guard is
+// therefore insufficient — setupAuthoringPath itself must reject traversal/absolute values
+// and fall back to the safe name-derived path under .productbrain/, never returning a path
+// that escapes the tree.
+describe('WP-426 E3 traversal rejection in setupAuthoringPath', () => {
+    test("`..` traversal authoringPath falls back to the safe name-derived path", () => {
+        const resolved = __test.setupAuthoringPath('/repo', {
+            entryId: 'X',
+            name: 'X',
+            assetKind: 'skill',
+            authoringPath: '../../etc/passwd',
+        });
+        expect(resolved).toBe('/repo/.productbrain/skills/X.md');
+    });
+    test('absolute authoringPath falls back to the safe name-derived path', () => {
+        const resolved = __test.setupAuthoringPath('/repo', {
+            entryId: 'X',
+            name: 'X',
+            assetKind: 'skill',
+            authoringPath: '/etc/passwd',
+        });
+        expect(resolved).toBe('/repo/.productbrain/skills/X.md');
+    });
+    test('a contained nested authoringPath is still honored', () => {
+        const resolved = __test.setupAuthoringPath('/repo', {
+            entryId: 'X',
+            name: 'X',
+            assetKind: 'skill',
+            authoringPath: 'skills/nested/x.md',
+        });
+        expect(resolved).toBe('/repo/.productbrain/skills/nested/x.md');
+    });
+    // Codex P2: containment is not enough — only kind-appropriate <dir>/**/*.md is honored.
+    test.each([
+        ['bare directory', 'skills'],
+        ['internal sync file', '.authoring-sync.json'],
+        ['internal manifest', 'manifest.yaml'],
+        ['non-markdown under kind dir', 'skills/foo.txt'],
+        ['wrong-kind dir for a skill', 'rules/foo.md'],
+    ])('%s falls back to the safe name-derived path', (_label, authoringPath) => {
+        const resolved = __test.setupAuthoringPath('/repo', {
+            entryId: 'X',
+            name: 'X',
+            assetKind: 'skill',
+            authoringPath,
+        });
+        expect(resolved).toBe('/repo/.productbrain/skills/X.md');
+    });
+});
+import { DORMANT_MARKER } from '../commands/handshake.js';
+// Codex P2: dormant registries are read via .includes() before the dormant loop's
+// per-file try/catch, so loadAuthoringSyncState must coerce malformed values to a
+// string[] (fail open) rather than letting a bad .authoring-sync.json abort handshake.
+describe('WP-426 E4 loadAuthoringSyncState registry coercion', () => {
+    function stateDir(json) {
+        const dir = mkdtempSync(join(tmpdir(), 'wp426-state-'));
+        writeFileSync(join(dir, '.authoring-sync.json'), json);
+        return dir;
+    }
+    test('coerces non-array dormantRenamed/dormantReactivated to []', () => {
+        const dir = stateDir(JSON.stringify({ version: 1, assets: {}, dormantRenamed: { bad: true }, dormantReactivated: 'oops' }));
+        const state = __test.loadAuthoringSyncState(dir);
+        expect(state.dormantRenamed).toEqual([]);
+        expect(state.dormantReactivated).toEqual([]);
+        // The coerced arrays must be safe to call .includes() on (the real failure mode).
+        expect(state.dormantRenamed?.includes('x')).toBe(false);
+        expect(state.dormantReactivated?.includes('x')).toBe(false);
+    });
+    test('keeps only string entries from a mixed array', () => {
+        const dir = stateDir(JSON.stringify({ version: 1, assets: {}, dormantRenamed: ['a/b.md', 42, null, 'c/d.md'] }));
+        expect(__test.loadAuthoringSyncState(dir).dormantRenamed).toEqual(['a/b.md', 'c/d.md']);
+    });
+    test('preserves a well-formed registry', () => {
+        const dir = stateDir(JSON.stringify({ version: 1, assets: {}, dormantRenamed: ['x.md'], dormantReactivated: ['y.md'] }));
+        const state = __test.loadAuthoringSyncState(dir);
+        expect(state.dormantRenamed).toEqual(['x.md']);
+        expect(state.dormantReactivated).toEqual(['y.md']);
+    });
+});
+describe('WP-426 E4 restoreSurfaceFromDormant', () => {
+    test('removes orphan .dormant when body matches the fresh projection', () => {
+        const fresh = tmpFile(`# x\n${MARKER}\n`);
+        writeFileSync(`${fresh}.dormant`, `# x\n${MARKER}\n${DORMANT_MARKER}\n`);
+        expect(__test.restoreSurfaceFromDormant(fresh)).toBe('restored');
+        expect(existsSync(`${fresh}.dormant`)).toBe(false);
+    });
+    test('removes orphan even when only the auto-gen TIMESTAMP differs', () => {
+        const fresh = tmpFile(`<!-- auto-generated by pb handshake — 2026-05-23T10:00:00Z -->\n# x\n${MARKER}\n`);
+        writeFileSync(`${fresh}.dormant`, `<!-- auto-generated by pb handshake — 2026-01-01T00:00:00Z -->\n# x\n${MARKER}\n${DORMANT_MARKER}\n`);
+        expect(__test.restoreSurfaceFromDormant(fresh)).toBe('restored');
+    });
+    test('preserves + signals drift when edited while dormant', () => {
+        const fresh = tmpFile(`# fresh\n${MARKER}\n`);
+        writeFileSync(`${fresh}.dormant`, `# USER EDITED\n${MARKER}\n${DORMANT_MARKER}\n`);
+        expect(__test.restoreSurfaceFromDormant(fresh)).toBe('orphan-drift');
+        expect(existsSync(`${fresh}.dormant`)).toBe(true);
+    });
+    test('skips when no .dormant sibling', () => {
+        expect(__test.restoreSurfaceFromDormant(tmpFile(`# x\n${MARKER}\n`))).toBe('skipped');
+    });
+    // WP-426 E4 Domain Expert fix: .dormant present but live file absent (surface-filtered run)
+    // → must return 'skipped' and leave the .dormant in place. Absence of the live file is NOT
+    // evidence of a user edit; it means the write loop didn't run for this surface this cycle.
+    test('skips and preserves .dormant when .dormant exists but live file is absent (surface-filtered run)', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'wp426-absent-'));
+        const livePath = join(dir, 'Foo.md');
+        const dormantPath = `${livePath}.dormant`;
+        // .dormant exists, but the live file was never written this run (surface-filtered)
+        writeFileSync(dormantPath, `# Foo\n${MARKER}\n${DORMANT_MARKER}\n`);
+        expect(existsSync(livePath)).toBe(false);
+        expect(__test.restoreSurfaceFromDormant(livePath)).toBe('skipped');
+        // .dormant must still be present — not removed
+        expect(existsSync(dormantPath)).toBe(true);
+    });
+    // Codex P2: a live file WITHOUT the auto-gen MARKER is a user-owned/forked file the write
+    // loop did not reproject this run — restoreSurfaceFromDormant must not reconcile against it
+    // (no wrongful delete, no false drift). Leave the .dormant untouched.
+    test('skips and preserves .dormant when the live file is forked (no auto-gen MARKER)', () => {
+        const fresh = tmpFile('# user-owned fork, no marker\n');
+        // .dormant body differs from the fork → would be flagged as orphan-drift if not gated.
+        writeFileSync(`${fresh}.dormant`, `# Foo\n${MARKER}\nDormant body.\n${DORMANT_MARKER}\n`);
+        expect(__test.restoreSurfaceFromDormant(fresh)).toBe('skipped');
+        expect(existsSync(`${fresh}.dormant`), 'forked live file must not trigger .dormant cleanup').toBe(true);
+    });
+});
+//# sourceMappingURL=handshake-dormancy.test.js.map

package/dist/__tests__/handshake-dormancy.test.js.map

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

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

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

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

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

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

@@ -0,0 +1,67 @@
+/**
+ * formatHandshakeReport — user-owned files are NOT drift (TEN-2150).
+ *
+ * A marker-less file at an adapter path is the user's own file. handshake leaves
+ * it untouched and lists it under "Skipped:" benignly. The report must NOT render
+ * it as a "forked adapter blocked sync" warning, must NOT claim a draft TEN was
+ * logged, and must NOT count it as user-owned drift.
+ *
+ * These tests feed the report the legacy drift shape (the data that USED to fire
+ * the warning) so they fail RED against the old formatter and stand as regression
+ * guards after the fix removes that code path.
+ */
+import { describe, expect, it } from 'vitest';
+import { formatHandshakeReport } from '../formatters/handshake.js';
+function baseReport(overrides = {}) {
+    return {
+        filesWritten: ['AGENTS.md'],
+        filesSkipped: [
+            { path: 'CLAUDE.md', reason: 'user-owned — left untouched (pb won\'t overwrite your file)' },
+        ],
+        matchedEntries: [],
+        searchQueries: [],
+        repo: { name: 'test-repo', detectedStack: [], repoSlug: null },
+        ...overrides,
+    };
+}
+describe('formatHandshakeReport — user-owned files are not drift (TEN-2150)', () => {
+    it('never renders a "forked adapter blocked sync" warning for user-owned files', () => {
+        // `driftConflicts` is the pre-fix shape that triggered the warning. Post-fix
+        // there is no code path that can emit it.
+        const out = formatHandshakeReport(baseReport({ driftConflicts: ['CLAUDE.md'] }));
+        expect(out).not.toContain('forked adapter');
+        expect(out).not.toContain('blocked sync');
+        expect(out).not.toContain('logged as draft TEN');
+        // Case-insensitive: the old warning emitted capital-U "Use --force to overwrite".
+        expect(out.toLowerCase()).not.toContain('--force to overwrite');
+    });
+    it('omits the user-owned bucket from the drift report entirely (TEN-2150)', () => {
+        // Force the drift report to render (it only shows when a PB-managed bucket is
+        // non-zero) while also listing user-owned skips. The report must show only the
+        // two PB-managed buckets — no user-owned row, regardless of how many are skipped.
+        const out = formatHandshakeReport(baseReport({ managedCleanCount: 2, userOwnedSkipped: ['CLAUDE.md', 'AGENTS.md'] }));
+        expect(out).toContain('Drift report (2 buckets):');
+        expect(out).toContain('PB-managed-clean:');
+        expect(out).not.toMatch(/user-owned:/);
+    });
+});
+describe('formatHandshakeReport — preview statuses would-augment + needs-attention (TEN-2155)', () => {
+    it('renders would-augment and needs-attention statuses', () => {
+        const out = formatHandshakeReport({
+            filesWritten: [], filesSkipped: [], matchedEntries: [], searchQueries: [],
+            repo: { name: 'r', detectedStack: [] },
+            preview: true,
+            previewPlan: [
+                { path: 'CLAUDE.md', status: 'would-augment' },
+                { path: 'AGENTS.md', status: 'needs-attention' },
+            ],
+        });
+        expect(out).toContain('CLAUDE.md');
+        expect(out).toMatch(/would augment/i);
+        expect(out).toMatch(/malformed PB region/);
+        expect(out).toMatch(/1 would augment/);
+        expect(out).toContain('✚'); // would-augment symbol
+        expect(out).toMatch(/1 need attention/);
+    });
+});
+//# sourceMappingURL=handshake-formatter.test.js.map

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

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