recall-mcp-v3 3.7.4 → 3.9.0

package/dist/__tests__/api-get-token.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tests for the `getToken()` resolution in api.ts.
+ *
+ * Exercises:
+ *   - Auth store wins over env var when both are set.
+ *   - Env var used as fallback when auth store absent.
+ *   - Corrupt auth store logs once + falls through to env (does not throw).
+ *   - Missing both paths throws with an actionable error.
+ *   - Result is memoized: subsequent calls don't re-read the filesystem.
+ *   - "No token found" is also memoized so we don't hammer stderr on retries.
+ *
+ * `getToken` itself is not exported, but every request-making function calls
+ * it before issuing a fetch. We use `saveSession`'s code path by mocking the
+ * network layer — any call that reaches `fetch` has already resolved the
+ * token. The `__resetTokenCache` export is the test seam.
+ */
+export {};
+//# sourceMappingURL=api-get-token.test.d.ts.map

package/dist/__tests__/api-get-token.test.d.ts.map

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

package/dist/__tests__/api-get-token.test.js

@@ -0,0 +1,195 @@
+/**
+ * Tests for the `getToken()` resolution in api.ts.
+ *
+ * Exercises:
+ *   - Auth store wins over env var when both are set.
+ *   - Env var used as fallback when auth store absent.
+ *   - Corrupt auth store logs once + falls through to env (does not throw).
+ *   - Missing both paths throws with an actionable error.
+ *   - Result is memoized: subsequent calls don't re-read the filesystem.
+ *   - "No token found" is also memoized so we don't hammer stderr on retries.
+ *
+ * `getToken` itself is not exported, but every request-making function calls
+ * it before issuing a fetch. We use `saveSession`'s code path by mocking the
+ * network layer — any call that reaches `fetch` has already resolved the
+ * token. The `__resetTokenCache` export is the test seam.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { __resetTokenCache, getTokenSource, RecallApiError } from '../api.js';
+import { writeAuthStore } from '../auth/auth-store.js';
+// ---------------------------------------------------------------------------
+// Fixture: the encryption layer and /v1/keys/team endpoint are mocked so we
+// can isolate the token-resolution behavior from everything downstream.
+// ---------------------------------------------------------------------------
+vi.mock('../crypto.js', () => ({
+    encrypt: vi.fn().mockReturnValue('encrypted'),
+    decrypt: vi.fn().mockReturnValue('decrypted'),
+    isEncrypted: vi.fn().mockReturnValue(false),
+    safeDecrypt: vi.fn().mockReturnValue(''),
+    normalizeToString: vi.fn((s) => s),
+}));
+// ---------------------------------------------------------------------------
+// readAuthStoreSync resolves its path via process.env at call time, so each
+// test points RECALL_AUTH_DIR at its own tmp dir and resets the cache.
+// ---------------------------------------------------------------------------
+let tmp;
+let originalEnv;
+beforeEach(() => {
+    tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'recall-gettoken-'));
+    originalEnv = {
+        token: process.env.RECALL_API_TOKEN,
+        authDir: process.env.RECALL_AUTH_DIR,
+    };
+    // Start each test with a clean slate.
+    delete process.env.RECALL_API_TOKEN;
+    process.env.RECALL_AUTH_DIR = path.join(tmp, 'recall');
+    __resetTokenCache();
+    vi.restoreAllMocks();
+});
+afterEach(() => {
+    if (originalEnv.token !== undefined) {
+        process.env.RECALL_API_TOKEN = originalEnv.token;
+    }
+    else {
+        delete process.env.RECALL_API_TOKEN;
+    }
+    if (originalEnv.authDir !== undefined) {
+        process.env.RECALL_AUTH_DIR = originalEnv.authDir;
+    }
+    else {
+        delete process.env.RECALL_AUTH_DIR;
+    }
+    fs.rmSync(tmp, { recursive: true, force: true });
+    __resetTokenCache();
+});
+async function writeStore(token) {
+    await writeAuthStore({
+        token,
+        issued_at: '2026-04-23T00:00:00.000Z',
+        api_base: 'https://api-v3.recall.team',
+        client_version: '3.9.0',
+    }, process.env);
+}
+// Helper to force a call through getToken + observe the token it attached
+// to the request. We shim global fetch so no real network call happens.
+async function captureTokenViaFetch() {
+    const fetchSpy = vi
+        .spyOn(globalThis, 'fetch')
+        .mockImplementation(() => Promise.resolve(new Response(JSON.stringify({
+        hasAccess: true,
+        encryptionKey: 'k',
+        keyVersion: 1,
+        teamId: 't',
+        teamName: 'tt',
+        teamSlug: 'ts',
+        tier: 'free',
+    }), { status: 200, headers: { 'Content-Type': 'application/json' } })));
+    const { getTeamKey, clearKeyCache } = await import('../api.js');
+    clearKeyCache();
+    try {
+        await getTeamKey();
+    }
+    catch {
+        // If getToken throws NO_TOKEN the fetch was never called — that's valid
+        // in the "no token found" test which asserts by catching the error.
+    }
+    const call = fetchSpy.mock.calls[0];
+    if (!call)
+        return null;
+    const init = call[1];
+    const auth = init?.headers?.['Authorization'];
+    return auth?.replace(/^Bearer\s+/, '') ?? null;
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('getToken: auth store precedence', () => {
+    it('prefers the auth store over RECALL_API_TOKEN when both are set', async () => {
+        await writeStore('rcl_from_store');
+        process.env.RECALL_API_TOKEN = 'rcl_from_env';
+        const tokenUsed = await captureTokenViaFetch();
+        expect(tokenUsed).toBe('rcl_from_store');
+        expect(getTokenSource()).toBe('auth_store');
+    });
+    it('falls back to RECALL_API_TOKEN when the auth store is absent', async () => {
+        process.env.RECALL_API_TOKEN = 'rcl_from_env_only';
+        const tokenUsed = await captureTokenViaFetch();
+        expect(tokenUsed).toBe('rcl_from_env_only');
+        expect(getTokenSource()).toBe('env');
+    });
+    it('uses the auth store even when the env var is empty string', async () => {
+        await writeStore('rcl_store_only');
+        process.env.RECALL_API_TOKEN = '';
+        const tokenUsed = await captureTokenViaFetch();
+        expect(tokenUsed).toBe('rcl_store_only');
+        expect(getTokenSource()).toBe('auth_store');
+    });
+});
+describe('getToken: error handling', () => {
+    it('throws NO_TOKEN when neither store nor env is present', async () => {
+        const { getTeamKey, clearKeyCache } = await import('../api.js');
+        clearKeyCache();
+        await expect(getTeamKey()).rejects.toMatchObject({
+            name: 'RecallApiError',
+            code: 'NO_TOKEN',
+            status: 401,
+        });
+    });
+    it('the NO_TOKEN error message suggests both `auth` and the env var', async () => {
+        const { getTeamKey, clearKeyCache } = await import('../api.js');
+        clearKeyCache();
+        await expect(getTeamKey()).rejects.toThrow(/recall-mcp-v3 auth/);
+        await expect(getTeamKey()).rejects.toThrow(/RECALL_API_TOKEN/);
+    });
+    it('falls through to env on a corrupt auth store and logs once', async () => {
+        const dir = path.join(tmp, 'recall');
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, 'auth.json'), 'not valid json {{{');
+        process.env.RECALL_API_TOKEN = 'rcl_env_rescue';
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const tokenUsed = await captureTokenViaFetch();
+        expect(tokenUsed).toBe('rcl_env_rescue');
+        expect(getTokenSource()).toBe('env');
+        expect(consoleSpy).toHaveBeenCalledTimes(1);
+        expect(consoleSpy.mock.calls[0][0]).toMatch(/auth store/i);
+    });
+    it('corrupt store + no env throws NO_TOKEN but still only logs the corruption once', async () => {
+        const dir = path.join(tmp, 'recall');
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, 'auth.json'), '{corrupt');
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const { getTeamKey, clearKeyCache } = await import('../api.js');
+        clearKeyCache();
+        await expect(getTeamKey()).rejects.toBeInstanceOf(RecallApiError);
+        // Second call should NOT re-log: the "no token" outcome is memoized.
+        await expect(getTeamKey()).rejects.toBeInstanceOf(RecallApiError);
+        expect(consoleSpy).toHaveBeenCalledTimes(1);
+    });
+});
+describe('getToken: memoization', () => {
+    it('does not re-read the auth store on subsequent calls', async () => {
+        // Observation: delete the auth store after the first call. If the token
+        // cache is working, the second call still returns the first token; if
+        // the second call re-read the file, it would fall through to env (unset)
+        // and throw NO_TOKEN.
+        await writeStore('rcl_memo_test');
+        const first = await captureTokenViaFetch();
+        expect(first).toBe('rcl_memo_test');
+        fs.rmSync(path.join(tmp, 'recall'), { recursive: true, force: true });
+        const second = await captureTokenViaFetch();
+        expect(second).toBe('rcl_memo_test');
+    });
+    it('__resetTokenCache forces a fresh read (test seam works)', async () => {
+        await writeStore('rcl_first');
+        expect(await captureTokenViaFetch()).toBe('rcl_first');
+        await writeStore('rcl_second');
+        // Without reset, the old token is memoized.
+        expect(await captureTokenViaFetch()).toBe('rcl_first');
+        __resetTokenCache();
+        expect(await captureTokenViaFetch()).toBe('rcl_second');
+    });
+});
+//# sourceMappingURL=api-get-token.test.js.map

package/dist/__tests__/api-get-token.test.js.map

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

package/dist/__tests__/repo-override-save-log.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for explicit `repo` param override on saveSession and logDecision.
+ *
+ * When a developer's git remote (e.g., raydawg88/stoodio-v2) doesn't match
+ * the enrolled Recall repo name (e.g., defendersoftheinternet/stoodio-v2),
+ * the explicit `repo` param lets the caller specify the correct name.
+ *
+ * Mirrors the existing test patterns in get-context-repo-resolution.test.ts.
+ */
+export {};
+//# sourceMappingURL=repo-override-save-log.test.d.ts.map

package/dist/__tests__/repo-override-save-log.test.d.ts.map

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

package/dist/__tests__/repo-override-save-log.test.js

@@ -0,0 +1,352 @@
+/**
+ * Tests for explicit `repo` param override on saveSession and logDecision.
+ *
+ * When a developer's git remote (e.g., raydawg88/stoodio-v2) doesn't match
+ * the enrolled Recall repo name (e.g., defendersoftheinternet/stoodio-v2),
+ * the explicit `repo` param lets the caller specify the correct name.
+ *
+ * Mirrors the existing test patterns in get-context-repo-resolution.test.ts.
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+// Configurable mocks
+const mockExecSync = vi.fn();
+// Mock api module
+vi.mock('../api.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        resolveRepo: vi.fn(),
+        resolveRepoFromGraph: vi.fn().mockResolvedValue(null),
+        fetchTeamGraph: vi.fn().mockResolvedValue(null),
+        getTeamKey: vi.fn().mockResolvedValue('mock-key'),
+        getCachedTier: vi.fn().mockReturnValue('team'),
+        listRepos: vi.fn().mockResolvedValue([]),
+        saveSessionAsync: vi.fn().mockResolvedValue({ id: 'sess_test123' }),
+        logDecision: vi.fn().mockResolvedValue({ id: 'dec_test123' }),
+    };
+});
+vi.mock('../transcript-finder.js', () => ({
+    findCurrentTranscript: vi.fn().mockReturnValue(null),
+    readTranscriptFile: vi.fn().mockReturnValue(null),
+}));
+vi.mock('../preprocessor.js', () => ({
+    preprocessTranscript: vi.fn().mockResolvedValue({
+        content: 'test transcript',
+        stats: { originalSize: 100, processedSize: 50, messagesExtracted: 5, errorsFound: 0, toolCallsLogged: 2 },
+    }),
+}));
+// Mock child_process — delegates to configurable mockExecSync
+vi.mock('child_process', () => ({
+    execSync: (...args) => mockExecSync(...args),
+}));
+// Mock fs
+vi.mock('fs', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        readdirSync: vi.fn().mockReturnValue([]),
+        existsSync: vi.fn().mockReturnValue(false),
+    };
+});
+import * as api from '../api.js';
+import { saveSession, logDecision } from '../tools.js';
+// Helper: set up resolveRepoFromGraph to return a valid resolved repo
+function mockResolvedRepo() {
+    vi.mocked(api.resolveRepoFromGraph).mockResolvedValue({
+        repoId: 'repo-123',
+        teamId: 'team-456',
+        teamSlug: 'myteam',
+        encryptionKey: 'mock-key',
+        tier: 'pro',
+    });
+}
+describe('saveSession with explicit repo param', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // Default: not in a git repo
+        mockExecSync.mockImplementation(() => {
+            throw new Error('fatal: not a git repository');
+        });
+    });
+    // =========================================================================
+    // Happy path: explicit repo resolves correctly
+    // =========================================================================
+    describe('valid repo param', () => {
+        it('should save session using the specified repo, skipping filesystem detection', async () => {
+            mockResolvedRepo();
+            const result = await saveSession({
+                repo: 'defendersoftheinternet/stoodio-v2',
+                summary: 'Wired contact form',
+            });
+            expect(result.isError).toBe(false);
+            // Should NOT try to read git config
+            expect(mockExecSync).not.toHaveBeenCalled();
+            // Should resolve with the explicit repo name
+            expect(api.resolveRepoFromGraph).toHaveBeenCalledWith('defendersoftheinternet/stoodio-v2');
+        });
+        it('should NOT call listRepos when repo param is provided', async () => {
+            mockResolvedRepo();
+            await saveSession({
+                repo: 'defendersoftheinternet/stoodio-v2',
+                summary: 'Test session',
+            });
+            expect(api.listRepos).not.toHaveBeenCalled();
+        });
+        it('should trim whitespace from repo param', async () => {
+            mockResolvedRepo();
+            await saveSession({
+                repo: '  defendersoftheinternet/stoodio-v2  ',
+                summary: 'Test session',
+            });
+            expect(api.resolveRepoFromGraph).toHaveBeenCalledWith('defendersoftheinternet/stoodio-v2');
+        });
+        it('should take priority over projectPath when both are provided', async () => {
+            mockResolvedRepo();
+            await saveSession({
+                repo: 'defendersoftheinternet/stoodio-v2',
+                projectPath: '/some/other/project',
+                summary: 'Test session',
+            });
+            // repo param wins — filesystem detection never called
+            expect(mockExecSync).not.toHaveBeenCalled();
+            expect(api.resolveRepoFromGraph).toHaveBeenCalledWith('defendersoftheinternet/stoodio-v2');
+        });
+    });
+    // =========================================================================
+    // Invalid format
+    // =========================================================================
+    describe('invalid repo format', () => {
+        it('should reject repo without slash (no owner/repo format)', async () => {
+            const result = await saveSession({
+                repo: 'just-a-name',
+                summary: 'Test session',
+            });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Invalid repo format');
+            expect(result.content[0].text).toContain('owner/repo');
+        });
+    });
+    // =========================================================================
+    // Empty/whitespace repo falls through to filesystem
+    // =========================================================================
+    describe('empty repo param', () => {
+        it('should fall through to filesystem when repo is empty string', async () => {
+            vi.mocked(api.listRepos).mockResolvedValue(['stoodiohq/recall-v3']);
+            const result = await saveSession({ repo: '', summary: 'Test' });
+            // Should hit the filesystem path (which fails in our mock) then list repos
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('stoodiohq/recall-v3');
+            expect(api.resolveRepoFromGraph).not.toHaveBeenCalled();
+        });
+        it('should fall through to filesystem when repo is whitespace only', async () => {
+            vi.mocked(api.listRepos).mockResolvedValue(['stoodiohq/recall-v3']);
+            const result = await saveSession({ repo: '   ', summary: 'Test' });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('stoodiohq/recall-v3');
+            expect(api.resolveRepoFromGraph).not.toHaveBeenCalled();
+        });
+    });
+    // =========================================================================
+    // Error handling: REPO_NOT_ENROLLED
+    // =========================================================================
+    describe('repo not enrolled', () => {
+        it('should return NOT_ENROLLED with available repos when repo not found', async () => {
+            vi.mocked(api.resolveRepoFromGraph).mockResolvedValue(null);
+            vi.mocked(api.resolveRepo).mockRejectedValue(new api.RecallApiError('Repo not enrolled', 'REPO_NOT_ENROLLED', 404));
+            vi.mocked(api.listRepos).mockResolvedValue([
+                'stoodiohq/recall-v3',
+                'raydawg88/scratch-golf-site',
+            ]);
+            const result = await saveSession({
+                repo: 'raydawg88/nonexistent-repo',
+                summary: 'Test',
+            });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('raydawg88/nonexistent-repo');
+            expect(result.content[0].text).toContain('stoodiohq/recall-v3');
+        });
+        it('should return skip-all message when repo not found and no repos configured', async () => {
+            vi.mocked(api.resolveRepoFromGraph).mockResolvedValue(null);
+            vi.mocked(api.resolveRepo).mockRejectedValue(new api.RecallApiError('Repo not enrolled', 'REPO_NOT_ENROLLED', 404));
+            vi.mocked(api.listRepos).mockResolvedValue([]);
+            const result = await saveSession({
+                repo: 'raydawg88/nonexistent-repo',
+                summary: 'Test',
+            });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text.toLowerCase()).toMatch(/skip.*all.*recall.*tools/i);
+        });
+    });
+    // =========================================================================
+    // Error handling: auth
+    // =========================================================================
+    describe('auth errors', () => {
+        it('should handle auth errors on repo param path', async () => {
+            vi.mocked(api.resolveRepoFromGraph).mockRejectedValue(new api.RecallApiError('Unauthorized', 'UNAUTHORIZED', 401));
+            const result = await saveSession({
+                repo: 'raydawg88/my-project',
+                summary: 'Test',
+            });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Authentication failed');
+        });
+    });
+    // =========================================================================
+    // Backward compatibility: no repo param still works via filesystem
+    // =========================================================================
+    describe('backward compatibility (no repo param)', () => {
+        it('should still resolve from git remote when no repo param', async () => {
+            mockExecSync.mockImplementation((cmd) => {
+                if (typeof cmd === 'string' && cmd.includes('remote.origin.url')) {
+                    return 'git@github.com:stoodiohq/recall-v3.git\n';
+                }
+                if (typeof cmd === 'string' && cmd.includes('rev-parse --abbrev-ref')) {
+                    return 'main\n';
+                }
+                return '';
+            });
+            mockResolvedRepo();
+            const result = await saveSession({ summary: 'Test session' });
+            expect(result.isError).toBe(false);
+            // Should call git to detect the repo
+            expect(mockExecSync).toHaveBeenCalled();
+            expect(api.resolveRepoFromGraph).toHaveBeenCalledWith('stoodiohq/recall-v3');
+        });
+    });
+});
+describe('logDecision with explicit repo param', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // Default: not in a git repo
+        mockExecSync.mockImplementation(() => {
+            throw new Error('fatal: not a git repository');
+        });
+    });
+    // =========================================================================
+    // Happy path: explicit repo resolves correctly
+    // =========================================================================
+    describe('valid repo param', () => {
+        it('should log decision using the specified repo, skipping filesystem detection', async () => {
+            mockResolvedRepo();
+            const result = await logDecision({
+                repo: 'defendersoftheinternet/stoodio-v2',
+                decision: 'Use Cloudflare Worker for contact form',
+                reasoning: 'Site is on Cloudflare Pages, simplest path',
+            });
+            expect(result.isError).toBe(false);
+            expect(result.content[0].text).toContain('Decision logged successfully');
+            // Should NOT try to read git config
+            expect(mockExecSync).not.toHaveBeenCalled();
+            expect(api.resolveRepoFromGraph).toHaveBeenCalledWith('defendersoftheinternet/stoodio-v2');
+        });
+        it('should trim whitespace from repo param', async () => {
+            mockResolvedRepo();
+            await logDecision({
+                repo: '  defendersoftheinternet/stoodio-v2  ',
+                decision: 'Test',
+                reasoning: 'Test',
+            });
+            expect(api.resolveRepoFromGraph).toHaveBeenCalledWith('defendersoftheinternet/stoodio-v2');
+        });
+        it('should take priority over projectPath when both are provided', async () => {
+            mockResolvedRepo();
+            await logDecision({
+                repo: 'defendersoftheinternet/stoodio-v2',
+                projectPath: '/some/other/project',
+                decision: 'Test',
+                reasoning: 'Test',
+            });
+            expect(mockExecSync).not.toHaveBeenCalled();
+            expect(api.resolveRepoFromGraph).toHaveBeenCalledWith('defendersoftheinternet/stoodio-v2');
+        });
+    });
+    // =========================================================================
+    // Invalid format
+    // =========================================================================
+    describe('invalid repo format', () => {
+        it('should reject repo without slash', async () => {
+            const result = await logDecision({
+                repo: 'just-a-name',
+                decision: 'Test',
+                reasoning: 'Test',
+            });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Invalid repo format');
+            expect(result.content[0].text).toContain('owner/repo');
+        });
+    });
+    // =========================================================================
+    // Empty repo falls through to filesystem
+    // =========================================================================
+    describe('empty repo param', () => {
+        it('should fall through to filesystem when repo is empty string', async () => {
+            const result = await logDecision({
+                repo: '',
+                decision: 'Test',
+                reasoning: 'Test',
+            });
+            // No git repo in mock, so it should error
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Could not determine repository');
+        });
+    });
+    // =========================================================================
+    // Error handling: REPO_NOT_ENROLLED
+    // =========================================================================
+    describe('repo not enrolled', () => {
+        it('should return NOT_ENROLLED with available repos', async () => {
+            vi.mocked(api.resolveRepoFromGraph).mockResolvedValue(null);
+            vi.mocked(api.resolveRepo).mockRejectedValue(new api.RecallApiError('Repo not enrolled', 'REPO_NOT_ENROLLED', 404));
+            vi.mocked(api.listRepos).mockResolvedValue([
+                'stoodiohq/recall-v3',
+            ]);
+            const result = await logDecision({
+                repo: 'raydawg88/nonexistent-repo',
+                decision: 'Test',
+                reasoning: 'Test',
+            });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('raydawg88/nonexistent-repo');
+        });
+    });
+    // =========================================================================
+    // Auth errors
+    // =========================================================================
+    describe('auth errors', () => {
+        it('should handle auth errors', async () => {
+            vi.mocked(api.resolveRepoFromGraph).mockRejectedValue(new api.RecallApiError('Unauthorized', 'UNAUTHORIZED', 401));
+            const result = await logDecision({
+                repo: 'raydawg88/my-project',
+                decision: 'Test',
+                reasoning: 'Test',
+            });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Authentication failed');
+        });
+    });
+    // =========================================================================
+    // Backward compatibility
+    // =========================================================================
+    describe('backward compatibility (no repo param)', () => {
+        it('should still resolve from git remote when no repo param', async () => {
+            mockExecSync.mockImplementation((cmd) => {
+                if (typeof cmd === 'string' && cmd.includes('remote.origin.url')) {
+                    return 'git@github.com:stoodiohq/recall-v3.git\n';
+                }
+                if (typeof cmd === 'string' && cmd.includes('rev-parse --abbrev-ref')) {
+                    return 'main\n';
+                }
+                return '';
+            });
+            mockResolvedRepo();
+            const result = await logDecision({
+                decision: 'Use Workers',
+                reasoning: 'Cloudflare stack',
+            });
+            expect(result.isError).toBe(false);
+            expect(mockExecSync).toHaveBeenCalled();
+            expect(api.resolveRepoFromGraph).toHaveBeenCalledWith('stoodiohq/recall-v3');
+        });
+    });
+});
+//# sourceMappingURL=repo-override-save-log.test.js.map

package/dist/__tests__/repo-override-save-log.test.js.map

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

package/dist/api.d.ts

@@ -2,7 +2,8 @@
  * Recall API Client
  *
  * HTTP client for the Recall v3 API with encryption support.
- * - Reads token from RECALL_API_TOKEN environment variable
+ * - Reads token from the local auth store (written by `recall-mcp-v3 auth`);
+ *   falls back to RECALL_API_TOKEN env var for legacy installs.
  * - Fetches team encryption key from API
  * - Encrypts content before sending, decrypts after receiving
  */
@@ -45,6 +46,10 @@ declare class RecallApiError extends Error {
     status: number;
     constructor(message: string, code: string, status: number);
 }
+/** Test-only hook so suites can reset the cached token between runs. */
+export declare function __resetTokenCache(): void;
+/** Exposed for debugging / heartbeat telemetry. */
+export declare function getTokenSource(): 'auth_store' | 'env' | null;
 /**
  * Fetch the team encryption key from API.
  * Caches the key in memory for the duration of the process.