specforge-mcp 0.11.0 → 0.12.0

package/dist/tools/learn.test.js

@@ -0,0 +1,123 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('../i18n/index.js', () => ({
+    t: vi.fn((key) => `t:${key}`),
+    ti: vi.fn((_key, params) => `translated:${JSON.stringify(params)}`),
+}));
+vi.mock('../storage/index.js', () => ({
+    patternStore: {
+        listPatterns: vi.fn(),
+        addPattern: vi.fn(),
+        incrementPatternUsage: vi.fn(),
+    },
+    knowledgeStore: {
+        getKnowledge: vi.fn(),
+    },
+}));
+import { handleLearn } from './learn.js';
+import { patternStore, knowledgeStore } from '../storage/index.js';
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+describe('handleLearn', () => {
+    it('should return error when project not found', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue(null);
+        const result = await handleLearn({
+            projectId: 'proj-123',
+            type: 'architecture',
+            pattern: 'Use repository pattern',
+        });
+        expect(result.isError).toBe(true);
+    });
+    it('should create new pattern successfully', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({});
+        vi.mocked(patternStore.listPatterns).mockResolvedValue([]);
+        vi.mocked(patternStore.addPattern).mockResolvedValue(undefined);
+        const result = await handleLearn({
+            projectId: 'proj-123',
+            type: 'architecture',
+            pattern: 'Use repository pattern',
+        });
+        expect(result.isError).toBeUndefined();
+        expect(result.content).toHaveLength(2);
+        const parsed = JSON.parse(result.content[1].text);
+        expect(parsed.action).toBe('created');
+        expect(parsed.type).toBe('architecture');
+        expect(parsed.pattern).toBe('Use repository pattern');
+        expect(parsed.totalPatterns).toBe(1);
+        expect(patternStore.addPattern).toHaveBeenCalled();
+    });
+    it('should increment usage count for duplicate pattern', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({});
+        vi.mocked(patternStore.listPatterns).mockResolvedValue([
+            {
+                id: 'PAT-ARC-123',
+                projectId: 'proj-123',
+                type: 'architecture',
+                pattern: 'Use repository pattern',
+                source: 'user-defined',
+                learnedAt: '2024-01-01',
+                confidence: 0.8,
+                usageCount: 3,
+            },
+        ]);
+        vi.mocked(patternStore.incrementPatternUsage).mockResolvedValue({
+            usageCount: 4,
+        });
+        const result = await handleLearn({
+            projectId: 'proj-123',
+            type: 'architecture',
+            pattern: 'Use repository pattern',
+        });
+        expect(result.isError).toBeUndefined();
+        const parsed = JSON.parse(result.content[1].text);
+        expect(parsed.action).toBe('incremented');
+        expect(parsed.usageCount).toBe(4);
+        expect(patternStore.addPattern).not.toHaveBeenCalled();
+    });
+    it('should use default source when not provided', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({});
+        vi.mocked(patternStore.listPatterns).mockResolvedValue([]);
+        vi.mocked(patternStore.addPattern).mockResolvedValue(undefined);
+        await handleLearn({
+            projectId: 'proj-123',
+            type: 'convention',
+            pattern: 'Use camelCase',
+        });
+        const addCall = vi.mocked(patternStore.addPattern).mock.calls[0];
+        const savedPattern = addCall[1];
+        expect(savedPattern.source).toBe('user-defined');
+    });
+    it('should use custom source when provided', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({});
+        vi.mocked(patternStore.listPatterns).mockResolvedValue([]);
+        vi.mocked(patternStore.addPattern).mockResolvedValue(undefined);
+        await handleLearn({
+            projectId: 'proj-123',
+            type: 'quality',
+            pattern: 'Always write tests',
+            source: 'code-review',
+        });
+        const addCall = vi.mocked(patternStore.addPattern).mock.calls[0];
+        const savedPattern = addCall[1];
+        expect(savedPattern.source).toBe('code-review');
+    });
+    it('should build pattern summary correctly', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({});
+        vi.mocked(patternStore.listPatterns).mockResolvedValue([
+            { type: 'architecture', pattern: 'Layered' },
+            { type: 'architecture', pattern: 'Repository' },
+            { type: 'convention', pattern: 'CamelCase' },
+        ]);
+        vi.mocked(patternStore.addPattern).mockResolvedValue(undefined);
+        const result = await handleLearn({
+            projectId: 'proj-123',
+            type: 'stack',
+            pattern: 'Use TypeScript',
+        });
+        const parsed = JSON.parse(result.content[1].text);
+        expect(parsed.patternsByType.architecture).toBe(2);
+        expect(parsed.patternsByType.convention).toBe(1);
+        expect(parsed.patternsByType.stack).toBe(1);
+    });
+});
+//# sourceMappingURL=learn.test.js.map

package/dist/tools/learn.test.js.map

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

package/dist/tools/list-specs.test.d.ts

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

package/dist/tools/list-specs.test.d.ts.map

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

package/dist/tools/list-specs.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('../i18n/index.js', () => ({
+    ti: vi.fn((_key, params) => `translated:${JSON.stringify(params)}`),
+}));
+vi.mock('../storage/index.js', () => ({
+    specStore: {
+        listSpecs: vi.fn(),
+    },
+    knowledgeStore: {
+        getKnowledge: vi.fn(),
+    },
+}));
+import { handleListSpecs } from './list-specs.js';
+import { specStore, knowledgeStore } from '../storage/index.js';
+const makeSpec = (overrides = {}) => ({
+    id: 'SPEC-001',
+    title: 'Test Spec',
+    type: 'feature',
+    scope: 'feature',
+    status: 'draft',
+    difficulty: 3,
+    risk: 'medium',
+    target: 'fullstack',
+    tags: ['test'],
+    gitBranch: 'feat/spec-001-test',
+    estimation: {
+        devHours: 8,
+        reviewHours: 2,
+        totalCostUsd: 500,
+        recommendedModel: 'sonnet',
+        tokenOptimization: { mode: 'local' },
+    },
+    createdAt: '2024-01-01',
+    updatedAt: '2024-01-02',
+    ...overrides,
+});
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+describe('handleListSpecs', () => {
+    it('should return error when project not found', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue(null);
+        const result = await handleListSpecs({ projectId: 'proj-123' });
+        expect(result.isError).toBe(true);
+    });
+    it('should list all specs without filters', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({});
+        vi.mocked(specStore.listSpecs).mockResolvedValue([
+            makeSpec({ id: 'SPEC-001', status: 'draft', type: 'feature' }),
+            makeSpec({ id: 'SPEC-002', status: 'approved', type: 'bugfix' }),
+        ]);
+        const result = await handleListSpecs({ projectId: 'proj-123' });
+        expect(result.isError).toBeUndefined();
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.count).toBe(2);
+        expect(parsed.totalCount).toBe(2);
+        expect(parsed.specs).toHaveLength(2);
+        expect(parsed.filters.status).toBe('all');
+        expect(parsed.filters.type).toBe('all');
+    });
+    it('should filter by status', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({});
+        vi.mocked(specStore.listSpecs).mockResolvedValue([
+            makeSpec({ id: 'SPEC-001', status: 'draft', type: 'feature' }),
+            makeSpec({ id: 'SPEC-002', status: 'approved', type: 'bugfix' }),
+        ]);
+        const result = await handleListSpecs({ projectId: 'proj-123', status: 'draft' });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.count).toBe(1);
+        expect(parsed.specs[0].id).toBe('SPEC-001');
+    });
+    it('should filter by type', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({});
+        vi.mocked(specStore.listSpecs).mockResolvedValue([
+            makeSpec({ id: 'SPEC-001', status: 'draft', type: 'feature' }),
+            makeSpec({ id: 'SPEC-002', status: 'approved', type: 'bugfix' }),
+        ]);
+        const result = await handleListSpecs({ projectId: 'proj-123', type: 'bugfix' });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.count).toBe(1);
+        expect(parsed.specs[0].id).toBe('SPEC-002');
+    });
+    it('should return empty list when no specs', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({});
+        vi.mocked(specStore.listSpecs).mockResolvedValue([]);
+        const result = await handleListSpecs({ projectId: 'proj-123' });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.count).toBe(0);
+        expect(parsed.specs).toHaveLength(0);
+        expect(parsed.summary.totalDevHours).toBe(0);
+    });
+    it('should calculate aggregated estimation totals', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({});
+        vi.mocked(specStore.listSpecs).mockResolvedValue([
+            makeSpec({ estimation: { devHours: 8, reviewHours: 2, totalCostUsd: 500 } }),
+            makeSpec({ estimation: { devHours: 16, reviewHours: 4, totalCostUsd: 1000 } }),
+        ]);
+        const result = await handleListSpecs({ projectId: 'proj-123' });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.summary.totalDevHours).toBe(24);
+        expect(parsed.summary.totalReviewHours).toBe(6);
+        expect(parsed.summary.totalCostUsd).toBe(1500);
+    });
+    it('should handle errors gracefully', async () => {
+        vi.mocked(knowledgeStore.getKnowledge).mockRejectedValue(new Error('Storage fail'));
+        const result = await handleListSpecs({ projectId: 'proj-123' });
+        expect(result.isError).toBe(true);
+    });
+});
+//# sourceMappingURL=list-specs.test.js.map

package/dist/tools/list-specs.test.js.map

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

package/dist/tools/manage-context.test.d.ts

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

package/dist/tools/manage-context.test.d.ts.map

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

package/dist/tools/manage-context.test.js

@@ -0,0 +1,359 @@
+// Tests for handleManageContext
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('../i18n/index.js', () => ({
+    t: (key) => key,
+    ti: (key, vars) => `${key}:${JSON.stringify(vars)}`,
+}));
+vi.mock('../storage/base-store.js', () => ({
+    projectDataDir: (projectId) => `data/projects/${projectId}`,
+}));
+vi.mock('node:fs/promises', () => ({
+    readFile: vi.fn(),
+    writeFile: vi.fn(),
+    readdir: vi.fn(),
+    unlink: vi.fn(),
+    mkdir: vi.fn(),
+}));
+import { handleManageContext } from './manage-context.js';
+import { readFile, writeFile, readdir, unlink, mkdir } from 'node:fs/promises';
+const mockReadFile = vi.mocked(readFile);
+const mockWriteFile = vi.mocked(writeFile);
+const mockReaddir = vi.mocked(readdir);
+const mockUnlink = vi.mocked(unlink);
+const mockMkdir = vi.mocked(mkdir);
+beforeEach(() => {
+    vi.clearAllMocks();
+    mockMkdir.mockResolvedValue(undefined);
+    mockWriteFile.mockResolvedValue(undefined);
+    mockUnlink.mockResolvedValue(undefined);
+});
+describe('handleManageContext', () => {
+    // === save action ===
+    it('should error when save called without key', async () => {
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'save',
+            content: 'hello',
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('key');
+    });
+    it('should error when save called without content', async () => {
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'save',
+            key: 'test-note',
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('content');
+    });
+    it('should save a context note successfully', async () => {
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'save',
+            key: 'meeting-notes',
+            content: '# Meeting Notes\nDiscussed architecture.',
+        });
+        expect(result.isError).toBeUndefined();
+        const data = JSON.parse(result.content[0].text);
+        expect(data.action).toBe('save');
+        expect(data.key).toBe('meeting-notes');
+        expect(mockWriteFile).toHaveBeenCalledTimes(2); // .md and .meta.json
+        expect(mockMkdir).toHaveBeenCalled();
+    });
+    it('should save with TTL when ttlDays provided', async () => {
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'save',
+            key: 'temp-note',
+            content: 'Temporary content',
+            ttlDays: 7,
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.action).toBe('save');
+        // Verify meta includes expiresAt
+        const metaCall = mockWriteFile.mock.calls.find((c) => c[0].includes('.meta.json'));
+        expect(metaCall).toBeDefined();
+        const meta = JSON.parse(metaCall[1]);
+        expect(meta.expiresAt).toBeDefined();
+    });
+    // === load action ===
+    it('should error when load called without key', async () => {
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'load',
+        });
+        expect(result.isError).toBe(true);
+    });
+    it('should load a context note', async () => {
+        mockReadFile.mockImplementation(((path) => {
+            if (path.endsWith('.md')) {
+                return Promise.resolve('# Notes\nSome content');
+            }
+            if (path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({ key: 'notes', createdAt: '2025-01-01' }));
+            }
+            return Promise.reject(new Error('not found'));
+        }));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'load',
+            key: 'notes',
+        });
+        expect(result.isError).toBeUndefined();
+        const data = JSON.parse(result.content[0].text);
+        expect(data.action).toBe('load');
+        expect(data.content).toContain('Some content');
+    });
+    it('should return error when note not found on load', async () => {
+        mockReadFile.mockRejectedValue(new Error('ENOENT'));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'load',
+            key: 'nonexistent',
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('not found');
+    });
+    it('should delete and return error for expired note on load', async () => {
+        const expiredDate = new Date(Date.now() - 86400000).toISOString();
+        mockReadFile.mockImplementation(((path) => {
+            if (path.endsWith('.md')) {
+                return Promise.resolve('old content');
+            }
+            if (path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({
+                    key: 'expired',
+                    createdAt: '2025-01-01',
+                    expiresAt: expiredDate,
+                }));
+            }
+            return Promise.reject(new Error('not found'));
+        }));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'load',
+            key: 'expired',
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('expired');
+        expect(mockUnlink).toHaveBeenCalled();
+    });
+    // === list action ===
+    it('should list context notes', async () => {
+        mockReaddir.mockResolvedValue(['note1.md', 'note2.md', 'note1.meta.json']);
+        mockReadFile.mockImplementation(((path) => {
+            if (path.endsWith('.md')) {
+                return Promise.resolve('# Title\nContent here');
+            }
+            if (path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({ key: 'note', createdAt: '2025-01-01' }));
+            }
+            return Promise.reject(new Error('not found'));
+        }));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'list',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.action).toBe('list');
+        expect(data.notes.length).toBeGreaterThan(0);
+    });
+    it('should return empty list when no notes', async () => {
+        mockReaddir.mockRejectedValue(new Error('ENOENT'));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'list',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.notes).toHaveLength(0);
+    });
+    // === delete action ===
+    it('should error when delete called without key', async () => {
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'delete',
+        });
+        expect(result.isError).toBe(true);
+    });
+    it('should delete a note', async () => {
+        mockReadFile.mockResolvedValue(JSON.stringify({ key: 'old-note', createdAt: '2025-01-01' }));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'delete',
+            key: 'old-note',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.action).toBe('delete');
+        expect(mockUnlink).toHaveBeenCalled();
+    });
+    it('should return error when deleting non-existent note', async () => {
+        mockReadFile.mockRejectedValue(new Error('not found'));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'delete',
+            key: 'nonexistent',
+        });
+        expect(result.isError).toBe(true);
+    });
+    // === cleanup action ===
+    it('should clean up expired notes', async () => {
+        const expiredDate = new Date(Date.now() - 86400000).toISOString();
+        mockReaddir.mockResolvedValue(['expired.md', 'valid.md']);
+        mockReadFile.mockImplementation(((path) => {
+            if (path.includes('expired') && path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({
+                    key: 'expired',
+                    createdAt: '2025-01-01',
+                    expiresAt: expiredDate,
+                }));
+            }
+            if (path.includes('valid') && path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({ key: 'valid', createdAt: '2025-01-01' }));
+            }
+            return Promise.reject(new Error('not found'));
+        }));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'cleanup',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.action).toBe('cleanup');
+        expect(data.message).toContain('removed');
+    });
+    // === list: skip expired notes ===
+    it('should skip expired notes in list', async () => {
+        const expiredDate = new Date(Date.now() - 86400000).toISOString();
+        const validDate = new Date(Date.now() + 86400000).toISOString();
+        mockReaddir.mockResolvedValue(['expired.md', 'valid.md']);
+        mockReadFile.mockImplementation(((path) => {
+            if (path.includes('expired') && path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({
+                    key: 'expired',
+                    createdAt: '2025-01-01',
+                    expiresAt: expiredDate,
+                }));
+            }
+            if (path.includes('valid') && path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({
+                    key: 'valid',
+                    createdAt: '2025-06-01',
+                    expiresAt: validDate,
+                }));
+            }
+            if (path.endsWith('.md')) {
+                return Promise.resolve('# Valid note content');
+            }
+            return Promise.reject(new Error('not found'));
+        }));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'list',
+        });
+        const data = JSON.parse(result.content[0].text);
+        // Expired note should be skipped, only valid note remains
+        expect(data.notes).toHaveLength(1);
+        expect(data.notes[0].key).toBe('valid');
+    });
+    // === list: content preview fallback when file read fails ===
+    it('should show fallback preview when content file read fails', async () => {
+        mockReaddir.mockResolvedValue(['broken.md']);
+        mockReadFile.mockImplementation(((path) => {
+            if (path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({ key: 'broken', createdAt: '2025-01-01' }));
+            }
+            // .md file always fails
+            return Promise.reject(new Error('read error'));
+        }));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'list',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.notes).toHaveLength(1);
+        expect(data.notes[0].preview).toBe('(unable to read)');
+    });
+    // === list: sort comparator for unknown timestamps ===
+    it('should sort notes with unknown createdAt to the end', async () => {
+        mockReaddir.mockResolvedValue(['old.md', 'unknown.md', 'recent.md']);
+        mockReadFile.mockImplementation(((path) => {
+            if (path.includes('old') && path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({ key: 'old', createdAt: '2024-01-01' }));
+            }
+            if (path.includes('unknown') && path.endsWith('.meta.json')) {
+                // No meta file -> createdAt will be 'unknown'
+                return Promise.reject(new Error('no meta'));
+            }
+            if (path.includes('recent') && path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({ key: 'recent', createdAt: '2025-06-01' }));
+            }
+            if (path.endsWith('.md')) {
+                return Promise.resolve('some content');
+            }
+            return Promise.reject(new Error('not found'));
+        }));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'list',
+        });
+        const data = JSON.parse(result.content[0].text);
+        // Notes with known dates come first (newest first), unknown last
+        const keys = data.notes.map((n) => n.key);
+        expect(keys[keys.length - 1]).toBe('unknown');
+    });
+    it('should sort when first note has unknown createdAt', async () => {
+        mockReaddir.mockResolvedValue(['a.md', 'b.md']);
+        mockReadFile.mockImplementation(((path) => {
+            if (path.includes('/a') && path.endsWith('.meta.json')) {
+                return Promise.reject(new Error('no meta'));
+            }
+            if (path.includes('/b') && path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({ key: 'b-note', createdAt: '2025-06-01' }));
+            }
+            if (path.endsWith('.md')) {
+                return Promise.resolve('content');
+            }
+            return Promise.reject(new Error('not found'));
+        }));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'list',
+        });
+        const data = JSON.parse(result.content[0].text);
+        // The note with a known date should come first
+        expect(data.notes[0].createdAt).not.toBe('unknown');
+    });
+    // === list: preview truncation for long content (lines 92-94) ===
+    it('should truncate preview to 120 chars with ellipsis for long content', async () => {
+        const longLine = 'A'.repeat(200);
+        mockReaddir.mockResolvedValue(['long-note.md']);
+        mockReadFile.mockImplementation(((path) => {
+            if (path.endsWith('.meta.json')) {
+                return Promise.resolve(JSON.stringify({ key: 'long-note', createdAt: '2025-01-01' }));
+            }
+            if (path.endsWith('.md')) {
+                return Promise.resolve(longLine);
+            }
+            return Promise.reject(new Error('not found'));
+        }));
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'list',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.notes).toHaveLength(1);
+        // Preview should be truncated: 117 chars + '...'
+        expect(data.notes[0].preview.length).toBe(120);
+        expect(data.notes[0].preview).toMatch(/\.\.\.$/);
+    });
+    // === unknown action ===
+    it('should return error for unknown action', async () => {
+        const result = await handleManageContext({
+            projectId: 'proj-1',
+            action: 'unknown',
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('Unknown action');
+    });
+});
+//# sourceMappingURL=manage-context.test.js.map