@productbrain/cli 0.1.0-beta.108 → 0.1.0-beta.1087

package/dist/__tests__/session-switch.test.js

@@ -0,0 +1,130 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+const mockKernelCall = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    kernelCall: (...a) => mockKernelCall(...a),
+    kernelCallWithSession: vi.fn(),
+}));
+const mockGetConfigOrGuide = vi.fn(async () => ({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' }));
+const mockResolveEffectiveProfile = vi.fn(() => ({ profile: 'p', source: 'local' }));
+const mockReadLocalProjectConfig = vi.fn(() => null);
+vi.mock('../lib/config.js', () => ({
+    getConfigOrGuide: (...a) => mockGetConfigOrGuide(...a),
+    resolveEffectiveProfile: () => mockResolveEffectiveProfile(),
+    readLocalProjectConfig: () => mockReadLocalProjectConfig(),
+    readProjectConfig: vi.fn(() => null),
+    refreshPreviewApiKeyFromDisk: vi.fn(() => 'not-bound'),
+}));
+vi.mock('../lib/profiles.js', () => ({ getActiveProfile: vi.fn(() => 'p') }));
+const mockReadSession = vi.fn();
+const mockWriteSession = vi.fn();
+const mockDiscardSession = vi.fn();
+const mockReadClosedMarker = vi.fn(() => null);
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockReadSession(),
+    writeSession: (...a) => mockWriteSession(...a),
+    clearSession: vi.fn(),
+    discardSession: () => mockDiscardSession(),
+    readClosedMarker: () => mockReadClosedMarker(),
+    sessionFileExists: vi.fn(() => false),
+    addCapturedEntry: vi.fn(),
+}));
+vi.mock('../commands/handshake.js', () => ({ runHandshake: vi.fn(async () => { }) }));
+import { runSessionStart, runSessionClose } from '../commands/session.js';
+describe('runSessionStart switch-backstop', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockGetConfigOrGuide.mockResolvedValue({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' });
+        mockReadClosedMarker.mockReturnValue(null);
+        mockReadLocalProjectConfig.mockReturnValue(null);
+    });
+    it('discards a session whose profile differs from the current effective profile, then starts fresh', async () => {
+        mockReadSession.mockReturnValue({
+            sessionId: 's-old', workspaceId: 'w-old', workspaceName: 'Old',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], profile: 'old',
+        });
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'new', source: 'local' });
+        mockKernelCall.mockImplementation(async (method) => {
+            if (method === 'resolveWorkspace')
+                return { _id: 'w-new', keyId: 'k1' };
+            if (method === 'agent.startSession')
+                return { sessionId: 's-new', workspaceName: 'New', initiatedBy: 'cli', toolsScope: 'rw' };
+            return {};
+        });
+        await runSessionStart({ json: true });
+        expect(mockDiscardSession).toHaveBeenCalled();
+        expect(mockWriteSession).toHaveBeenCalledWith(expect.objectContaining({ sessionId: 's-new', profile: 'new' }));
+    });
+    it('discards and starts fresh on a profile switch in pretty (non-json) mode too', async () => {
+        mockReadSession.mockReturnValue({
+            sessionId: 's-old', workspaceId: 'w-old', workspaceName: 'Old',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], profile: 'old',
+        });
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'new', source: 'local' });
+        mockKernelCall.mockImplementation(async (method) => {
+            if (method === 'resolveWorkspace')
+                return { _id: 'w-new', keyId: 'k1' };
+            if (method === 'agent.startSession')
+                return { sessionId: 's-new', workspaceName: 'New', initiatedBy: 'cli', toolsScope: 'rw' };
+            return {};
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionStart({}); // no json → pretty mode
+            expect(mockDiscardSession).toHaveBeenCalled();
+            expect(mockKernelCall).toHaveBeenCalledWith('agent.startSession', expect.anything());
+            expect(mockWriteSession).toHaveBeenCalledWith(expect.objectContaining({ sessionId: 's-new', profile: 'new' }));
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+    it('preserves alreadyActive for a legacy session with no profile field (no discard)', async () => {
+        mockReadSession.mockReturnValue({
+            sessionId: 's1', workspaceId: 'w1', workspaceName: 'WS',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], // NOTE: no `profile`
+        });
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'new', source: 'local' });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionStart({ json: true });
+            const out = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+            expect(out).toMatch(/alreadyActive/);
+            expect(mockDiscardSession).not.toHaveBeenCalled();
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+    it('keeps alreadyActive when the effective profile is unchanged', async () => {
+        mockReadSession.mockReturnValue({
+            sessionId: 's1', workspaceId: 'w1', workspaceName: 'WS',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], profile: 'same',
+        });
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'same', source: 'local' });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionStart({ json: true });
+            const out = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+            expect(out).toMatch(/alreadyActive/);
+            expect(mockDiscardSession).not.toHaveBeenCalled();
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+});
+describe('runSessionClose --force hint', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockGetConfigOrGuide.mockResolvedValue({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' });
+        mockReadSession.mockReturnValue({
+            sessionId: 's1', workspaceId: 'w1', workspaceName: 'WS',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [],
+        });
+    });
+    it('puts the --force instruction in the error message itself', async () => {
+        mockKernelCall.mockRejectedValue(new Error('Internal server error'));
+        await expect(runSessionClose({})).rejects.toThrow(/pb session close --force/);
+    });
+});
+//# sourceMappingURL=session-switch.test.js.map

package/dist/__tests__/session-switch.test.js.map

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

package/dist/__tests__/setup-ingest.test.js

@@ -51,5 +51,21 @@ assetKind: bundle
             path: '/repo/skills/bundle.md',
         });
     });
+    it('forwards frontmatter id to setup.ingestSetupAsset', async () => {
+        kernelCallMock.mockResolvedValue({ action: 'created', entryId: 'SETUP-SKILL-FM' });
+        fileContents['/repo/.productbrain/skills/local.md'] = `---
+id: SETUP-SKILL-FM
+name: Local
+---
+# Local
+`;
+        await runSetupIngest('.productbrain/skills/local.md');
+        expect(kernelCallMock).toHaveBeenCalledWith('setup.ingestSetupAsset', expect.objectContaining({
+            entryId: 'SETUP-SKILL-LOCAL',
+            frontmatterId: 'SETUP-SKILL-FM',
+            name: 'Local',
+            assetKind: 'skill',
+        }));
+    });
 });
 //# sourceMappingURL=setup-ingest.test.js.map

package/dist/__tests__/setup-ingest.test.js.map

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

package/dist/__tests__/skill-vocabulary.test.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Skill vocabulary fixture tests — WP-436 S3.
+ *
+ * 3 skill files × 3 workspace presets = 9 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.
+ */
+export {};
+//# sourceMappingURL=skill-vocabulary.test.d.ts.map

package/dist/__tests__/skill-vocabulary.test.d.ts.map

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

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

@@ -0,0 +1,187 @@
+/**
+ * Skill vocabulary fixture tests — WP-436 S3.
+ *
+ * 3 skill files × 3 workspace presets = 9 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');
+// ── 3×3 tests ─────────────────────────────────────────────────────────────────
+const SKILL_FIXTURES = [
+    { name: 'shaping', src: SHAPING_SRC },
+    { name: 'phasing', src: PHASING_SRC },
+    { name: 'implementation-review', src: 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.');
+    });
+});
+// ── 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__/update-check.test.d.ts

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

package/dist/__tests__/update-check.test.d.ts.map

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

package/dist/__tests__/update-check.test.js

@@ -0,0 +1,215 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const files = new Map();
+// Controllable npm registry response for resolveLatestVersion's live fetch. `null` => the
+// request yields an empty body (JSON.parse fails) so fetchLatestVersion resolves null.
+let npmResponseVersion = null;
+vi.mock('node:os', () => ({
+    homedir: () => '/mock-home',
+}));
+vi.mock('node:https', () => ({
+    request: (_url, _opts, cb) => {
+        const res = {
+            on: (event, handler) => {
+                if (event === 'data' && npmResponseVersion !== null) {
+                    handler(Buffer.from(JSON.stringify({ version: npmResponseVersion })));
+                }
+                if (event === 'end')
+                    handler();
+                return res;
+            },
+        };
+        cb(res);
+        const req = { on: () => req, setTimeout: () => req, destroy: () => { }, end: () => { } };
+        return req;
+    },
+}));
+vi.mock('node:fs', async () => ({
+    existsSync: (path) => files.has(path),
+    readFileSync: (path) => files.get(path) ?? '',
+    writeFileSync: (path, body) => { files.set(path, body); },
+    mkdirSync: vi.fn(),
+    unlinkSync: (path) => { files.delete(path); },
+    statSync: () => ({ mtimeMs: Date.now() }),
+    readdirSync: () => [...files.keys()].map((p) => p.split('/').pop()),
+    openSync: (path) => { if (files.has(path)) {
+        const e = new Error('EEXIST');
+        e.code = 'EEXIST';
+        throw e;
+    } files.set(path, ''); return 1; },
+    closeSync: vi.fn(),
+}));
+vi.mock('../lib/session.js', () => ({ readSession: () => ({ sessionId: 'sess-test' }) }));
+import { clearPendingUpgradeCache, isNewer, recordServerLatest, readCachedLatestVersion, writeUpgradePendingSentinel, recordNpmLatest, resolveCachedLatest, resolveLatestVersion, checkForUpdate, _resetProcessGuardsForTest, } from '../lib/update-check.js';
+import { setOutputMode } from '../lib/runner.js';
+describe('update-check', () => {
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        _resetProcessGuardsForTest();
+        files.clear();
+        npmResponseVersion = null;
+        process.env = { ...originalEnv };
+        setOutputMode('auto');
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        process.env = { ...originalEnv };
+        setOutputMode('auto');
+        vi.restoreAllMocks();
+    });
+    it('compares prerelease channels by alpha < beta < rc < release', () => {
+        expect(isNewer('0.1.0-beta.32', '0.1.0-beta.108')).toBe(true);
+        expect(isNewer('0.1.0-beta.5', '0.1.0-rc.1')).toBe(true);
+        expect(isNewer('0.1.0-rc.1', '0.1.0-beta.5')).toBe(false);
+        expect(isNewer('0.1.0-rc.1', '0.1.0')).toBe(true);
+    });
+    it('recordServerLatest updates cache silently in JSON mode', () => {
+        setOutputMode('json');
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        recordServerLatest('0.1.0-beta.109');
+        expect(readCachedLatestVersion()).toBe('0.1.0-beta.109');
+        expect(stderrSpy).not.toHaveBeenCalled();
+    });
+    it('PB_NO_VERSION_CHECK disables cache writes and output', () => {
+        process.env.PB_NO_VERSION_CHECK = '1';
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        recordServerLatest('0.1.0-beta.109');
+        expect(readCachedLatestVersion()).toBeNull();
+        expect(stderrSpy).not.toHaveBeenCalled();
+    });
+    it('next startup clears upgrade sentinel and stale update cache', () => {
+        recordServerLatest('0.1.0-beta.109');
+        expect(readCachedLatestVersion()).toBe('0.1.0-beta.109');
+        writeUpgradePendingSentinel();
+        clearPendingUpgradeCache();
+        expect(readCachedLatestVersion()).toBeNull();
+    });
+    it('newest of fresh server/npm wins; server still wins only when it is the highest', () => {
+        recordNpmLatest('0.1.0-beta.140', '0.1.0-beta.109'); // (value, installed)
+        recordServerLatest('0.1.0-beta.130'); // fresh server, but LOWER than npm
+        expect(resolveCachedLatest()).toBe('0.1.0-beta.140'); // npm wins — server no longer masks a newer npm
+    });
+    it('a fresh server that LAGS npm cannot mask the true npm latest (TEN-2199 smoke-walk regression)', () => {
+        // The live failure mode: server header advertises the committed cliVersion.ts value (beta.108),
+        // which trails the run-numbered npm publish (beta.958). Newest-wins must surface 958, not 108.
+        recordNpmLatest('0.1.0-beta.958', '0.1.0-beta.109');
+        recordServerLatest('0.1.0-beta.108'); // fresh but stale-valued, < installed
+        expect(resolveCachedLatest()).toBe('0.1.0-beta.958');
+    });
+    it('server still wins when it is genuinely the newest source', () => {
+        recordNpmLatest('0.1.0-beta.140', '0.1.0-beta.109');
+        recordServerLatest('0.1.0-beta.145'); // fresh server, HIGHER than npm
+        expect(resolveCachedLatest()).toBe('0.1.0-beta.145');
+    });
+    it('npm wins when the server header is stale (>48h)', () => {
+        const realNow = Date.now;
+        recordServerLatest('0.1.0-beta.130');
+        Date.now = () => realNow() + 49 * 60 * 60 * 1000;
+        recordNpmLatest('0.1.0-beta.140', '0.1.0-beta.109');
+        expect(resolveCachedLatest()).toBe('0.1.0-beta.140');
+        Date.now = realNow;
+    });
+    it('npm fallback is isNewer-gated against installed (never records older-or-equal)', () => {
+        recordNpmLatest('0.1.0-beta.1', '0.1.0-beta.109'); // stale tag, older than installed
+        expect(resolveCachedLatest()).toBeNull();
+    });
+    it('prints an update line to stderr in JSON mode (agent), once', () => {
+        setOutputMode('json');
+        recordServerLatest('0.1.0-beta.140');
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        checkForUpdate('0.1.0-beta.109');
+        checkForUpdate('0.1.0-beta.109'); // same session => silent second time
+        expect(stderrSpy).toHaveBeenCalledTimes(1);
+        expect(stderrSpy.mock.calls[0][0]).toContain('pb:');
+        expect(stderrSpy.mock.calls[0][0]).toContain('pb upgrade');
+    });
+    it('prints nothing to stdout (stdout stays bare JSON)', () => {
+        setOutputMode('json');
+        recordServerLatest('0.1.0-beta.140');
+        const stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        checkForUpdate('0.1.0-beta.109');
+        expect(stdoutSpy).not.toHaveBeenCalled();
+    });
+    it('cold cache → no print', () => {
+        setOutputMode('json');
+        const spy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        checkForUpdate('0.1.0-beta.109');
+        expect(spy).not.toHaveBeenCalled();
+    });
+    it('sentinel records the installed version and suppresses re-notify for it', () => {
+        setOutputMode('json');
+        recordServerLatest('0.1.0-beta.140');
+        writeUpgradePendingSentinel('0.1.0-beta.140'); // just installed 140
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        checkForUpdate('0.1.0-beta.140'); // running 140, latest 140 -> no notice
+        expect(stderrSpy).not.toHaveBeenCalled();
+    });
+    it('resolveLatestVersion serves a within-window npm fallback without refetching (P2)', async () => {
+        recordNpmLatest('0.1.0-beta.140', '0.1.0-beta.109'); // fresh (recordedAt = now)
+        npmResponseVersion = '0.1.0-beta.999'; // would win IF a fetch happened
+        const latest = await resolveLatestVersion('0.1.0-beta.109');
+        expect(latest).toBe('0.1.0-beta.140'); // fresh cache used, no network refresh
+    });
+    it('a lone fresh server header still triggers a live npm fetch — server-only cache is not trusted (P1)', async () => {
+        // Normal steady state: authenticated calls write a fresh server header, but the hot path never
+        // populates npm. If the server lags npm (108 vs 958), the live resolver must fetch npm rather
+        // than short-circuit on the server value, or pb doctor/upgrade would resolve the masked 108.
+        recordServerLatest('0.1.0-beta.108'); // fresh server only; no npm cache entry
+        npmResponseVersion = '0.1.0-beta.958'; // live npm is far newer
+        const latest = await resolveLatestVersion('0.1.0-beta.109');
+        expect(latest).toBe('0.1.0-beta.958'); // fetched + surfaced, not the masked server 108
+    });
+    it('resolveLatestVersion revalidates a stale npm fallback via a fresh fetch (P2)', async () => {
+        const realNow = Date.now;
+        recordNpmLatest('0.1.0-beta.140', '0.1.0-beta.109'); // recordedAt = now
+        Date.now = () => realNow() + 25 * 60 * 60 * 1000; // past the 24h npm window
+        npmResponseVersion = '0.1.0-beta.141'; // registry now serves a newer beta
+        try {
+            const latest = await resolveLatestVersion('0.1.0-beta.109');
+            expect(latest).toBe('0.1.0-beta.141'); // refreshed, not the stale 140
+        }
+        finally {
+            Date.now = realNow;
+        }
+    });
+    it('successful revalidation replaces a stale cache even when the live tag is not newer (P2)', async () => {
+        const realNow = Date.now;
+        recordNpmLatest('0.1.0-beta.140', '0.1.0-beta.109'); // seed npm cache at 140
+        Date.now = () => realNow() + 25 * 60 * 60 * 1000; // age it past the 24h window
+        npmResponseVersion = '0.1.0-beta.142'; // registry now points lower than installed
+        try {
+            // Installed is 145 (post-upgrade). The live tag (142) is <= installed, so recordNpmLatest
+            // refuses to overwrite — but the resolver must return the live truth (142), NOT the disproven
+            // stale 140 it would otherwise fall back to.
+            const latest = await resolveLatestVersion('0.1.0-beta.145');
+            expect(latest).toBe('0.1.0-beta.142');
+        }
+        finally {
+            Date.now = realNow;
+        }
+    });
+    it('falls back to a stale cached value only on fetch failure (offline backstop)', async () => {
+        const realNow = Date.now;
+        recordNpmLatest('0.1.0-beta.140', '0.1.0-beta.109');
+        Date.now = () => realNow() + 25 * 60 * 60 * 1000; // stale npm entry
+        npmResponseVersion = null; // registry unreachable → fetch resolves null
+        try {
+            const latest = await resolveLatestVersion('0.1.0-beta.109');
+            expect(latest).toBe('0.1.0-beta.140'); // offline → stale cache is better than nothing
+        }
+        finally {
+            Date.now = realNow;
+        }
+    });
+    it('hot-path resolveCachedLatest still returns a stale npm value (better than nothing)', () => {
+        const realNow = Date.now;
+        recordNpmLatest('0.1.0-beta.140', '0.1.0-beta.109');
+        Date.now = () => realNow() + 100 * 60 * 60 * 1000; // far past every freshness window
+        try {
+            expect(resolveCachedLatest()).toBe('0.1.0-beta.140'); // sync hot path never blocks/forgets
+        }
+        finally {
+            Date.now = realNow;
+        }
+    });
+});
+//# sourceMappingURL=update-check.test.js.map