@productbrain/cli 0.1.0-beta.5 → 0.1.0-beta.5060

package/dist/__tests__/skill-vocabulary.test.js

@@ -0,0 +1,192 @@
+/**
+ * Skill vocabulary fixture tests — WP-436 S3.
+ *
+ * 4 skill files × 3 workspace presets = 12 fixture assertions.
+ *
+ * Each test renders a tokenized skill file content through replaceVocabTokens
+ * with the given workspace preset and asserts:
+ *   1. No un-tokenized noun-form "bet" / "Bet" / "bets" / "Bets" remains
+ *      outside exclusions (code fences, inline code, already-tokenized lines).
+ *   2. No raw {{vocab:...}} token survives (resolver is exhaustive).
+ *   3. The rendered content contains the expected singular label for the preset.
+ *
+ * Workspace presets (methodology-neutral):
+ *   - Shape Up: singular=Bet, plural=Bets, verb_start=shape, verb_complete=ship
+ *   - Generic:  singular=Initiative, plural=Initiatives, verb_start=start, verb_complete=complete
+ *   - Linear:   singular=Issue, plural=Issues, verb_start=begin, verb_complete=archive
+ *
+ * Chain: WP-436 S3, STD-253, DEC-1021.
+ */
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { describe, expect, it } from 'vitest';
+import { replaceVocabTokens } from '../lib/canonicalRefs.js';
+// ── Helpers ───────────────────────────────────────────────────────────────────
+const PB_SKILLS_DIR = join(new URL('../../../..', import.meta.url).pathname, '.productbrain', 'skills');
+function readSkill(name) {
+    return readFileSync(join(PB_SKILLS_DIR, `${name}.md`), 'utf8');
+}
+// ── Workspace presets ─────────────────────────────────────────────────────────
+const PRESETS = {
+    'Shape Up': {
+        collectionLabels: {
+            work_package: {
+                singular: 'Bet',
+                plural: 'Bets',
+                verb_start: 'shape',
+                verb_complete: 'ship',
+                verb_archive: 'archive',
+            },
+        },
+    },
+    'Generic': {
+        collectionLabels: {
+            work_package: {
+                singular: 'Initiative',
+                plural: 'Initiatives',
+                verb_start: 'start',
+                verb_complete: 'complete',
+                verb_archive: 'close',
+            },
+        },
+    },
+    'Linear': {
+        collectionLabels: {
+            work_package: {
+                singular: 'Issue',
+                plural: 'Issues',
+                verb_start: 'begin',
+                verb_complete: 'archive',
+                verb_archive: 'archive',
+            },
+        },
+    },
+};
+// ── Assertion helpers ─────────────────────────────────────────────────────────
+/**
+ * Check that no raw {{vocab:...}} token survives in the rendered output.
+ * The resolver should replace ALL tokens.
+ */
+function assertNoRawTokens(rendered, description) {
+    const rawTokens = rendered.match(/\{\{vocab:[a-z_]+\.[a-z_]+\}\}/g) ?? [];
+    expect(rawTokens, `${description}: found raw {{vocab:...}} tokens after render: ${rawTokens.join(', ')}`).toHaveLength(0);
+}
+/**
+ * Check that no un-tokenized noun-form "bet" remains in prose (outside code fences and inline code).
+ *
+ * This replicates the verify-no-noun-bet exclusion logic inline.
+ * Note: after render, what we are checking is the OUTPUT — rendered prose that should use
+ * the workspace label (e.g. "Bet", "Initiative", "Issue") — NOT the raw token. So we only
+ * need to confirm no lowercase "bet"/"bets" remain that are NOT the resolved label.
+ *
+ * For the Shape Up preset where singular="Bet", the rendered text will contain "Bet" naturally.
+ * For Generic/Linear, "Bet" should NOT appear (it was replaced by Initiative/Issue).
+ */
+function assertNoUnresolved(rendered, preset, ctx) {
+    const singular = ctx.collectionLabels?.work_package?.singular ?? '';
+    const plural = ctx.collectionLabels?.work_package?.plural ?? '';
+    // If the preset maps to "Bet"/"Bets" (Shape Up), then rendered "Bet" is expected.
+    // Otherwise, we check that "bet" / "Bet" doesn't appear in prose outside inline code.
+    if (singular === 'Bet') {
+        // Shape Up: resolved labels are "Bet"/"Bets" (capital) — those are expected in prose.
+        // What MUST NOT appear: LOWERCASE noun-form "bet"/"bets"/possessives — that signals a
+        // token-rewrite miss (since resolved labels for this preset are always capital).
+        // Strip code fences + inline code first so legitimate `bet-XXX-short-name` etc. don't trip us.
+        const strippedForCheck = stripCodeSpans(stripFences(rendered));
+        expect(strippedForCheck, `${preset}: lowercase noun-form 'bet'/'bets' in prose = unresolved leak`)
+            .not.toMatch(/\bbet(s|'s|s')?\b(?!-)/);
+        return;
+    }
+    // For non-Shape Up presets: no "Bet" (capital) should appear in prose (it was replaced).
+    // Strip code fences + inline code before checking.
+    const strippedFences = stripFences(rendered);
+    const strippedAll = stripCodeSpans(strippedFences);
+    // Check for any remaining {{vocab:...}} already handled above.
+    // Check that prose noun-form "Bet" is gone (replaced by singular/plural preset label).
+    const betMatches = strippedAll.match(/\b[Bb]et(s|'s|s')?\b(?!-)/g) ?? [];
+    expect(betMatches, `${preset}: found un-resolved noun-form "bet" in prose: ${betMatches.join(', ')}`).toHaveLength(0);
+}
+function stripFences(text) {
+    // Remove code fence blocks (```...``` and ~~~~...~~~~)
+    return text.replace(/```[\s\S]*?```/g, ' ').replace(/~{4,}[\s\S]*?~{4,}/g, ' ');
+}
+function stripCodeSpans(text) {
+    // Remove inline backtick spans
+    return text.replace(/`[^`]+`/g, ' ');
+}
+// ── Fixture: Source file content (tokenized) loaded once ─────────────────────
+const SHAPING_SRC = readSkill('shaping');
+const PHASING_SRC = readSkill('phasing');
+const REVIEW_SRC = readSkill('implementation-review');
+const DEFECT_REVIEW_SRC = readSkill('defect-driven-review');
+// ── 4×3 tests ─────────────────────────────────────────────────────────────────
+const SKILL_FIXTURES = [
+    { name: 'shaping', src: SHAPING_SRC },
+    { name: 'phasing', src: PHASING_SRC },
+    { name: 'implementation-review', src: REVIEW_SRC },
+    { name: 'defect-driven-review', src: DEFECT_REVIEW_SRC },
+];
+for (const { name: skillName, src } of SKILL_FIXTURES) {
+    describe(`skill: ${skillName}`, () => {
+        for (const [presetName, ctx] of Object.entries(PRESETS)) {
+            it(`renders correctly under preset: ${presetName}`, () => {
+                const rendered = replaceVocabTokens(src, ctx);
+                const description = `${skillName} × ${presetName}`;
+                // 1. No raw {{vocab:...}} tokens survive
+                assertNoRawTokens(rendered, description);
+                // 2. Resolved content contains the workspace singular label (confirms resolution worked)
+                const singular = ctx.collectionLabels?.work_package?.singular ?? '';
+                expect(rendered, `${description}: rendered output should contain workspace singular label "${singular}"`).toContain(singular);
+                // 3. No un-resolved noun-form "bet" in prose (for non-Shape Up presets)
+                assertNoUnresolved(rendered, presetName, ctx);
+            });
+        }
+    });
+}
+// ── Additional: verify source file IS tokenized (has {{vocab:...}} tokens) ───
+describe('source files are tokenized', () => {
+    it('shaping.md contains vocab tokens', () => {
+        expect(SHAPING_SRC).toContain('{{vocab:work_package.');
+    });
+    it('phasing.md contains vocab tokens', () => {
+        expect(PHASING_SRC).toContain('{{vocab:work_package.');
+    });
+    it('implementation-review.md contains vocab tokens', () => {
+        expect(REVIEW_SRC).toContain('{{vocab:work_package.');
+    });
+    it('defect-driven-review.md contains vocab tokens', () => {
+        expect(DEFECT_REVIEW_SRC).toContain('{{vocab:work_package.');
+    });
+});
+// ── Additional: verb-form preset assertion ─────────────────────────────────────
+//
+// shaping.md has one verb-form token: {{vocab:work_package.verb_start}} (from "shape a bet")
+// in the YAML triggers block. "ship a bet" was not literal text in any skill — so
+// verb_complete tokens only appear where we explicitly test with a custom fixture.
+describe('verb-form resolution across presets', () => {
+    it('Shape Up: verb_start resolves to "shape" (trigger line in shaping.md)', () => {
+        const rendered = replaceVocabTokens(SHAPING_SRC, PRESETS['Shape Up']);
+        // The trigger line was "- shape a bet" → "- {{vocab:work_package.verb_start}} a {{vocab:work_package.singular}}"
+        // After render with Shape Up: "- shape a Bet"
+        expect(rendered).toContain('shape a Bet');
+    });
+    it('Generic: verb_start resolves to "start" (trigger line in shaping.md)', () => {
+        const rendered = replaceVocabTokens(SHAPING_SRC, PRESETS['Generic']);
+        // After render with Generic: "- start a Initiative"
+        expect(rendered).toContain('start a Initiative');
+    });
+    it('Linear: verb_start resolves to "begin" (trigger line in shaping.md)', () => {
+        const rendered = replaceVocabTokens(SHAPING_SRC, PRESETS['Linear']);
+        // verb_start="begin" for Linear
+        // The "shape a bet" trigger → "begin a Issue"
+        expect(rendered).toContain('begin a Issue');
+    });
+    it('verb_complete inline fixture: each preset resolves correctly', () => {
+        // No "ship a bet" literal appeared in skills, so test verb_complete via an inline fixture.
+        const fixture = 'To {{vocab:work_package.verb_complete}} a {{vocab:work_package.singular}}, all slices must pass review.';
+        expect(replaceVocabTokens(fixture, PRESETS['Shape Up'])).toBe('To ship a Bet, all slices must pass review.');
+        expect(replaceVocabTokens(fixture, PRESETS['Generic'])).toBe('To complete a Initiative, all slices must pass review.');
+        expect(replaceVocabTokens(fixture, PRESETS['Linear'])).toBe('To archive a Issue, all slices must pass review.');
+    });
+});
+//# sourceMappingURL=skill-vocabulary.test.js.map

package/dist/__tests__/skill-vocabulary.test.js.map

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

package/dist/__tests__/spinner-labels.test.d.ts

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

package/dist/__tests__/spinner-labels.test.d.ts.map

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

package/dist/__tests__/spinner-labels.test.js

@@ -0,0 +1,23 @@
+/**
+ * spinnerLabel — unit tests.
+ * WP-303 Slice 2: Ambient Feedback (Spinners).
+ *
+ * Verifies the MCP function name -> friendly label mapping.
+ */
+import { describe, expect, it } from 'vitest';
+import { spinnerLabel } from '../lib/client.js';
+describe('spinnerLabel', () => {
+    it('maps known MCP functions to friendly labels', () => {
+        expect(spinnerLabel('orient')).toBe('Loading workspace overview');
+        expect(spinnerLabel('entries.get')).toBe('Loading entry');
+        expect(spinnerLabel('capture-quick')).toBe('Capturing to Chain');
+        expect(spinnerLabel('agent.startSession')).toBe('Starting session');
+    });
+    it('generates a fallback label for unknown functions', () => {
+        expect(spinnerLabel('some.unknown.tool')).toBe('Loading some unknown tool');
+    });
+    it('handles simple function names in fallback', () => {
+        expect(spinnerLabel('foobar')).toBe('Loading foobar');
+    });
+});
+//# sourceMappingURL=spinner-labels.test.js.map

package/dist/__tests__/spinner-labels.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-labels.test.js","sourceRoot":"","sources":["../../src/__tests__/spinner-labels.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAClE,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1D,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjE,MAAM,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/state.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for resolveSetupState() and detectRenderTier().
+ * WP-325 S1 — foundation module, four stage paths + three render tier paths.
+ */
+export {};
+//# sourceMappingURL=state.test.d.ts.map

package/dist/__tests__/state.test.d.ts.map

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

package/dist/__tests__/state.test.js

@@ -0,0 +1,117 @@
+/**
+ * Unit tests for resolveSetupState() and detectRenderTier().
+ * WP-325 S1 — foundation module, four stage paths + three render tier paths.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { resolveSetupState, detectRenderTier } from '../lib/state.js';
+vi.mock('../lib/config.js', () => ({
+    getConfigSafe: vi.fn(),
+}));
+vi.mock('../lib/workspace-probe.js', () => ({
+    probeWorkspace: vi.fn(),
+}));
+vi.mock('../lib/session.js', () => ({
+    readSession: vi.fn(),
+}));
+vi.mock('../lib/runner.js', () => ({
+    isJsonMode: vi.fn(),
+}));
+import { getConfigSafe } from '../lib/config.js';
+import { probeWorkspace } from '../lib/workspace-probe.js';
+import { readSession } from '../lib/session.js';
+import { isJsonMode } from '../lib/runner.js';
+const mockGetConfigSafe = vi.mocked(getConfigSafe);
+const mockProbeWorkspace = vi.mocked(probeWorkspace);
+const mockReadSession = vi.mocked(readSession);
+const mockIsJsonMode = vi.mocked(isJsonMode);
+beforeEach(() => {
+    vi.resetAllMocks();
+});
+// ---------------------------------------------------------------------------
+// resolveSetupState — four stage paths
+// ---------------------------------------------------------------------------
+describe('resolveSetupState', () => {
+    it('returns unconfigured when no API key is present', async () => {
+        mockGetConfigSafe.mockReturnValue({
+            ok: false,
+            kind: 'missing-key',
+            reason: 'no key',
+            guidance: 'Run `pb login`.',
+            nextCommand: 'pb login',
+        });
+        const state = await resolveSetupState();
+        expect(state.stage).toBe('unconfigured');
+        expect(state.nextAction).toBe('pb login');
+        expect(state.missingSteps.length).toBeGreaterThan(0);
+        expect(mockProbeWorkspace).not.toHaveBeenCalled();
+    });
+    it('S5: preserves a repo-pin diagnosis and repair command', async () => {
+        mockGetConfigSafe.mockReturnValue({
+            ok: false,
+            kind: 'profile-pin',
+            reason: 'This repo is pinned to profile "deleted-workspace".',
+            guidance: 'Run `pb profile use --local <profile>` to fix the repo pin.',
+            nextCommand: 'pb profile use --local <profile>',
+        });
+        const state = await resolveSetupState();
+        expect(state.stage).toBe('unconfigured');
+        expect(state.missingSteps).toEqual(['This repo is pinned to profile "deleted-workspace".']);
+        expect(state.nextAction).toBe('pb profile use --local <profile>');
+        expect(mockProbeWorkspace).not.toHaveBeenCalled();
+    });
+    it('returns authenticated when key is present but workspace is unreachable', async () => {
+        mockGetConfigSafe.mockReturnValue({ ok: true, apiKey: 'key', siteUrl: 'https://test.convex.site' });
+        mockProbeWorkspace.mockResolvedValue(null);
+        const state = await resolveSetupState();
+        expect(state.stage).toBe('authenticated');
+        expect(state.nextAction).toBe('pb connect');
+        expect(mockReadSession).not.toHaveBeenCalled();
+    });
+    it('returns workspace-bound when connected but no active session', async () => {
+        mockGetConfigSafe.mockReturnValue({ ok: true, apiKey: 'key', siteUrl: 'https://test.convex.site' });
+        mockProbeWorkspace.mockResolvedValue({ name: 'Test WS', entryCount: 42 });
+        mockReadSession.mockReturnValue(null);
+        const state = await resolveSetupState();
+        expect(state.stage).toBe('workspace-bound');
+        expect(state.workspaceName).toBe('Test WS');
+        expect(state.entryCount).toBe(42);
+        expect(state.sessionActive).toBe(false);
+        expect(state.nextAction).toBe('pb session start');
+    });
+    it('returns active when key + workspace + session are all present', async () => {
+        mockGetConfigSafe.mockReturnValue({ ok: true, apiKey: 'key', siteUrl: 'https://test.convex.site' });
+        mockProbeWorkspace.mockResolvedValue({ name: 'Test WS', entryCount: 99 });
+        mockReadSession.mockReturnValue({ sessionId: 'sess-1', workspaceId: 'ws-1', workspaceName: 'Test WS', startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [] });
+        const state = await resolveSetupState();
+        expect(state.stage).toBe('active');
+        expect(state.sessionActive).toBe(true);
+        expect(state.workspaceName).toBe('Test WS');
+        expect(state.entryCount).toBe(99);
+        expect(state.missingSteps).toHaveLength(0);
+        expect(state.nextAction).toBe('pb orient -b');
+    });
+});
+// ---------------------------------------------------------------------------
+// detectRenderTier — three render paths
+// ---------------------------------------------------------------------------
+describe('detectRenderTier', () => {
+    const originalIsTTY = process.stdout.isTTY;
+    afterEach(() => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, writable: true });
+    });
+    it('returns json when isJsonMode() is true', () => {
+        mockIsJsonMode.mockReturnValue(true);
+        expect(detectRenderTier()).toBe('json');
+    });
+    it('returns plain when not a TTY and not json mode', () => {
+        mockIsJsonMode.mockReturnValue(false);
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        expect(detectRenderTier()).toBe('plain');
+    });
+    it('returns ink when TTY and not json mode', () => {
+        mockIsJsonMode.mockReturnValue(false);
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        expect(detectRenderTier()).toBe('ink');
+    });
+});
+//# sourceMappingURL=state.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.test.js","sourceRoot":"","sources":["../../src/__tests__/state.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE;CACvB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;CACxB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC;IAClC,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE;CACrB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;CACpB,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,iBAAiB,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACnD,MAAM,kBAAkB,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AACrD,MAAM,eAAe,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAC/C,MAAM,cAAc,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAE7C,UAAU,CAAC,GAAG,EAAE;IACd,EAAE,CAAC,aAAa,EAAE,CAAC;AACrB,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,iBAAiB,CAAC,eAAe,CAAC;YAChC,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,iBAAiB;YAC3B,WAAW,EAAE,UAAU;SACxB,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC;QAExC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,iBAAiB,CAAC,eAAe,CAAC;YAChC,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,qDAAqD;YAC7D,QAAQ,EAAE,6DAA6D;YACvE,WAAW,EAAE,kCAAkC;SACZ,CAAC,CAAC;QAEvC,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC;QAExC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,qDAAqD,CAAC,CAAC,CAAC;QAC5F,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAClE,MAAM,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,iBAAiB,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,0BAA0B,EAAsC,CAAC,CAAC;QACxI,kBAAkB,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE3C,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC;QAExC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,iBAAiB,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,0BAA0B,EAAsC,CAAC,CAAC;QACxI,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1E,eAAe,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAEtC,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC;QAExC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,iBAAiB,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,0BAA0B,EAAsC,CAAC,CAAC;QACxI,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1E,eAAe,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,sBAAsB,EAAE,eAAe,EAAE,EAAE,EAAoC,CAAC,CAAC;QAElM,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC;QAExC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAE9E,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAE3C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,cAAc,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,cAAc,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/strip.test.d.ts

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

package/dist/__tests__/strip.test.d.ts.map

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

package/dist/__tests__/strip.test.js

@@ -0,0 +1,164 @@
+/**
+ * stripConvexInternals / stripControlChars — unit tests.
+ * BET-181 Slice 0: TEN-340 (Convex internal exposure), DEC-299 (JSON-default output).
+ * BET-269 C3: terminal escaping (stripControlChars).
+ *
+ * Verifies: removes _id and _creationTime, preserves entryId and all other fields,
+ * handles nested objects and arrays, does not mutate input; stripControlChars strips
+ * ANSI/control characters (including carriage return) while preserving \n and \t.
+ */
+import { describe, expect, it } from 'vitest';
+import { stripConvexInternals, stripControlChars } from '../lib/strip.js';
+describe('stripConvexInternals', () => {
+    it('removes _id from a flat object', () => {
+        const input = { _id: 'j57abc', entryId: 'BET-181', name: 'Test' };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        expect(result).toHaveProperty('entryId', 'BET-181');
+        expect(result).toHaveProperty('name', 'Test');
+    });
+    it('removes _creationTime from a flat object', () => {
+        const input = { _creationTime: 1700000000000, entryId: 'BET-181', name: 'Test' };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_creationTime');
+        expect(result).toHaveProperty('entryId', 'BET-181');
+    });
+    it('removes both _id and _creationTime simultaneously', () => {
+        const input = {
+            _id: 'j57abc',
+            _creationTime: 1700000000000,
+            entryId: 'BET-181',
+            name: 'Test',
+            status: 'active',
+        };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        expect(result).not.toHaveProperty('_creationTime');
+        expect(result).toEqual({ entryId: 'BET-181', name: 'Test', status: 'active' });
+    });
+    it('preserves entryId (human-readable) unconditionally', () => {
+        const input = { _id: 'sys1', _creationTime: 123, entryId: 'DEC-299' };
+        const result = stripConvexInternals(input);
+        expect(result).toHaveProperty('entryId', 'DEC-299');
+    });
+    it('preserves all other fields untouched', () => {
+        const input = {
+            _id: 'sys1',
+            name: 'My entry',
+            status: 'draft',
+            collectionSlug: 'work-packages',
+            data: { description: 'hello' },
+        };
+        const result = stripConvexInternals(input);
+        expect(result).toEqual({
+            name: 'My entry',
+            status: 'draft',
+            collectionSlug: 'work-packages',
+            data: { description: 'hello' },
+        });
+    });
+    it('recursively strips _id and _creationTime from nested objects', () => {
+        const input = {
+            entryId: 'BET-181',
+            relations: [
+                { _id: 'rel1', _creationTime: 111, type: 'part_of', otherEntryId: 'INI-1' },
+            ],
+            data: {
+                _id: 'should-be-removed',
+                description: 'keep this',
+            },
+        };
+        const result = stripConvexInternals(input);
+        // Top level
+        expect(result).toHaveProperty('entryId', 'BET-181');
+        // Nested in array
+        const rel = result.relations[0];
+        expect(rel).not.toHaveProperty('_id');
+        expect(rel).not.toHaveProperty('_creationTime');
+        expect(rel).toHaveProperty('type', 'part_of');
+        expect(rel).toHaveProperty('otherEntryId', 'INI-1');
+        // Nested in object
+        const data = result.data;
+        expect(data).not.toHaveProperty('_id');
+        expect(data).toHaveProperty('description', 'keep this');
+    });
+    it('handles arrays of objects', () => {
+        const input = [
+            { _id: 'a', entryId: 'BET-1', name: 'Bet 1' },
+            { _id: 'b', _creationTime: 999, entryId: 'TEN-1', name: 'Tension 1' },
+        ];
+        const result = stripConvexInternals(input);
+        expect(result).toHaveLength(2);
+        expect(result[0]).not.toHaveProperty('_id');
+        expect(result[0]).toHaveProperty('entryId', 'BET-1');
+        expect(result[1]).not.toHaveProperty('_id');
+        expect(result[1]).not.toHaveProperty('_creationTime');
+        expect(result[1]).toHaveProperty('entryId', 'TEN-1');
+    });
+    it('handles null values without error', () => {
+        const result = stripConvexInternals(null);
+        expect(result).toBeNull();
+    });
+    it('handles primitive values (string, number, boolean) as pass-through', () => {
+        expect(stripConvexInternals('hello')).toBe('hello');
+        expect(stripConvexInternals(42)).toBe(42);
+        expect(stripConvexInternals(true)).toBe(true);
+    });
+    it('does not mutate the input object', () => {
+        const input = { _id: 'sys1', entryId: 'BET-1', name: 'Test' };
+        const inputCopy = { ...input };
+        stripConvexInternals(input);
+        expect(input).toEqual(inputCopy);
+    });
+    it('handles empty objects and arrays', () => {
+        expect(stripConvexInternals({})).toEqual({});
+        expect(stripConvexInternals([])).toEqual([]);
+    });
+    it('handles deeply nested structures', () => {
+        const input = {
+            _id: 'top',
+            level1: {
+                _id: 'l1',
+                level2: {
+                    _id: 'l2',
+                    _creationTime: 123,
+                    value: 'deep',
+                },
+            },
+        };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        const r = result;
+        expect(r.level1).not.toHaveProperty('_id');
+        expect(r.level1.level2).not.toHaveProperty('_id');
+        expect(r.level1.level2).not.toHaveProperty('_creationTime');
+        expect(r.level1.level2['value']).toBe('deep');
+    });
+});
+describe('stripControlChars', () => {
+    it('strips CSI ANSI escape sequences (e.g. bold/color codes)', () => {
+        expect(stripControlChars('\x1b[1mMallory\x1b[0m')).toBe('Mallory');
+    });
+    it('strips OSC ANSI escape sequences (e.g. terminal title changes)', () => {
+        expect(stripControlChars('before\x1b]0;evil title\x07after')).toBe('beforeafter');
+    });
+    it('strips bare control characters (e.g. NUL, BEL)', () => {
+        expect(stripControlChars('a\x00b\x07c')).toBe('abc');
+    });
+    // Late-fix consolidation round 1 (PRRT_kwDORS4ils6Y0pz3, P1): the control-char class
+    // originally jumped \x0b\x0c straight to \x0e-\x1f, deliberately skipping \x0d (carriage
+    // return) alongside \x09 (tab) and \x0a (newline) — but unlike tab/newline, a bare \r moves
+    // the terminal cursor to column zero, letting the remaining attacker-controlled text overwrite
+    // or spoof the start of the line. \r carries no legitimate multiline-formatting use the way
+    // \n does, so it belongs in the stripped set.
+    it('strips carriage return (\\r) — a bare CR can overwrite/spoof the start of a terminal line', () => {
+        expect(stripControlChars('hello\rworld')).toBe('helloworld');
+    });
+    it('preserves newline (\\n) and tab (\\t) — legitimate multiline formatting', () => {
+        expect(stripControlChars('line1\nline2\tindented')).toBe('line1\nline2\tindented');
+    });
+    it('returns falsy input unchanged (empty string)', () => {
+        expect(stripControlChars('')).toBe('');
+    });
+});
+//# sourceMappingURL=strip.test.js.map

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

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

package/dist/__tests__/surface-profiles.test.d.ts

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

package/dist/__tests__/surface-profiles.test.d.ts.map

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