@productbrain/cli 0.1.0-beta.1282 → 0.1.0-beta.1296

package/dist/lib/startup-resolution-signals.test.js

@@ -0,0 +1,113 @@
+import { describe, expect, it } from 'vitest';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { STARTUP_RESOLUTION_SIGNAL_FIELDS, STARTUP_RESOLUTION_SIGNAL_LIMITS, STARTUP_RESOLUTION_SIGNAL_SOURCE_SURFACES, sanitizeStartupResolutionSignals, } from './startup-resolution-signals.js';
+function loadContract() {
+    return JSON.parse(readFileSync(join(process.cwd(), 'startup-resolution-signals.contract.json'), 'utf8'));
+}
+function loadResolutionFixtures() {
+    return JSON.parse(readFileSync(join(process.cwd(), 'startup-resolution-signals.fixtures.json'), 'utf8'));
+}
+function loadSanitizerCases() {
+    return JSON.parse(readFileSync(join(process.cwd(), 'startup-resolution-signals.sanitizer-cases.json'), 'utf8'));
+}
+describe('StartupResolutionSignals CLI contract', () => {
+    it('matches the shared runtime fixture for fields, caps, and source surfaces', () => {
+        const fixture = loadContract();
+        expect(STARTUP_RESOLUTION_SIGNAL_FIELDS).toEqual(fixture.fields);
+        expect(STARTUP_RESOLUTION_SIGNAL_LIMITS.arrayCaps).toEqual(fixture.arrayCaps);
+        expect(STARTUP_RESOLUTION_SIGNAL_LIMITS.stringCaps).toEqual(fixture.stringCaps);
+        expect(STARTUP_RESOLUTION_SIGNAL_SOURCE_SURFACES).toEqual(fixture.sourceSurface);
+    });
+    it('omits empty values, trims strings, caps arrays, and rejects unsafe paths', () => {
+        const fixture = loadContract();
+        const sanitized = sanitizeStartupResolutionSignals({
+            taskText: ` ${'x'.repeat(fixture.stringCaps.taskText + 10)} `,
+            explicitScope: ' product-design/ux ',
+            changedPaths: [
+                'src//routes/Work.svelte',
+                '~/private.env',
+                '../outside.ts',
+                'config/.env.local',
+                '',
+                ...Array.from({ length: fixture.arrayCaps.changedPaths + 5 }, (_, i) => `packages/cli/src/file-${i}.ts`),
+            ],
+            reviewedArtifactRefs: [
+                ' PR #177 ',
+                '',
+                ...Array.from({ length: fixture.arrayCaps.reviewedArtifactRefs + 5 }, (_, i) => `DEC-${i}`),
+            ],
+            branchName: ' feature/wp462 ',
+            worktreeName: ' wp462-rcrt-activation ',
+            sourceSurface: 'cli',
+            resolverVersion: ' rcrt-v3 ',
+            changeId: ' change-123 ',
+            commitSha: ' abc123 ',
+        });
+        expect(sanitized.taskText).toHaveLength(fixture.stringCaps.taskText);
+        expect(sanitized.explicitScope).toBe('product-design/ux');
+        expect(sanitized.changedPaths).toHaveLength(fixture.arrayCaps.changedPaths);
+        expect(sanitized.changedPaths).toContain('src/routes/Work.svelte');
+        expect(sanitized.changedPaths).not.toContain('~/private.env');
+        expect(sanitized.changedPaths).not.toContain('../outside.ts');
+        expect(sanitized.changedPaths).not.toContain('config/.env.local');
+        expect(sanitized.reviewedArtifactRefs).toHaveLength(fixture.arrayCaps.reviewedArtifactRefs);
+        expect(sanitized.reviewedArtifactRefs?.[0]).toBe('PR #177');
+        expect(sanitized.branchName).toBe('feature/wp462');
+        expect(sanitized.worktreeName).toBe('wp462-rcrt-activation');
+        expect(sanitized.sourceSurface).toBe('cli');
+        expect(sanitized.resolverVersion).toBe('rcrt-v3');
+        expect(sanitized.changeId).toBe('change-123');
+        expect(sanitized.commitSha).toBe('abc123');
+    });
+    it('returns an empty object when callers omit every meaningful signal', () => {
+        expect(sanitizeStartupResolutionSignals({
+            taskText: '',
+            explicitScope: ' ',
+            changedPaths: [''],
+            reviewedArtifactRefs: [],
+            branchName: undefined,
+            worktreeName: null,
+            sourceSurface: 'graphql',
+        })).toEqual({});
+    });
+    it('handles the shared behavioral sanitizer cases identically to the Convex copy (path + surface drift guard)', () => {
+        const cases = loadSanitizerCases();
+        for (const c of cases.paths) {
+            const sanitized = sanitizeStartupResolutionSignals({ changedPaths: [c.input] });
+            if (c.accepted) {
+                expect(sanitized.changedPaths, `path "${c.input}" should be accepted`).toEqual([c.normalized]);
+            }
+            else {
+                expect(sanitized.changedPaths, `path "${c.input}" should be rejected`).toBeUndefined();
+            }
+        }
+        for (const c of cases.sourceSurfaces) {
+            const sanitized = sanitizeStartupResolutionSignals({ sourceSurface: c.input });
+            if (c.accepted) {
+                expect(sanitized.sourceSurface, `surface "${c.input}" should be accepted`).toBe(c.normalized);
+            }
+            else {
+                expect(sanitized.sourceSurface, `surface "${c.input}" should be rejected`).toBeUndefined();
+            }
+        }
+    });
+    it('can sanitize the shared Slice 1 resolver fixtures without importing outside the CLI rootDir', () => {
+        const fixtures = loadResolutionFixtures();
+        expect(Object.keys(fixtures)).toEqual([
+            'reviewTask',
+            'prRef',
+            'entryRef',
+            'workPackageRef',
+            'changedPath',
+            'lowConfidenceUnresolved',
+            'explicitScopeOverride',
+        ]);
+        for (const fixture of Object.values(fixtures)) {
+            expect(sanitizeStartupResolutionSignals(fixture)).not.toEqual({});
+        }
+        expect(fixtures.lowConfidenceUnresolved.expectedRetrievalState).toBe('domain-unresolved');
+        expect(fixtures.explicitScopeOverride.expectedResolutionPreference).toBe('explicit-scope');
+    });
+});
+//# sourceMappingURL=startup-resolution-signals.test.js.map

package/dist/lib/startup-resolution-signals.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productbrain/cli",
-  "version": "0.1.0-beta.1282",
+  "version": "0.1.0-beta.1296",
   "description": "Product Brain — Chain knowledge and write-back CLI",
   "type": "module",
   "bin": {