@blamechris/repo-memory 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -2
- package/dist/indexer/project-map.d.ts +3 -0
- package/dist/indexer/project-map.d.ts.map +1 -1
- package/dist/indexer/project-map.js +14 -4
- package/dist/indexer/project-map.js.map +1 -1
- package/dist/server.js +69 -1
- package/dist/server.js.map +1 -1
- package/dist/tools/batch-file-summaries.d.ts +13 -0
- package/dist/tools/batch-file-summaries.d.ts.map +1 -0
- package/dist/tools/batch-file-summaries.js +25 -0
- package/dist/tools/batch-file-summaries.js.map +1 -0
- package/dist/tools/get-related-files.d.ts +13 -0
- package/dist/tools/get-related-files.d.ts.map +1 -0
- package/dist/tools/get-related-files.js +139 -0
- package/dist/tools/get-related-files.js.map +1 -0
- package/dist/tools/search-by-purpose.d.ts +14 -0
- package/dist/tools/search-by-purpose.d.ts.map +1 -0
- package/dist/tools/search-by-purpose.js +50 -0
- package/dist/tools/search-by-purpose.js.map +1 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -20,7 +20,7 @@ Add to your Claude Code MCP settings:
|
|
|
20
20
|
"mcpServers": {
|
|
21
21
|
"repo-memory": {
|
|
22
22
|
"command": "npx",
|
|
23
|
-
"args": ["-y", "repo-memory"]
|
|
23
|
+
"args": ["-y", "@blamechris/repo-memory"]
|
|
24
24
|
}
|
|
25
25
|
}
|
|
26
26
|
}
|
|
@@ -28,7 +28,7 @@ Add to your Claude Code MCP settings:
|
|
|
28
28
|
|
|
29
29
|
### Manual
|
|
30
30
|
```bash
|
|
31
|
-
npm install -g repo-memory
|
|
31
|
+
npm install -g @blamechris/repo-memory
|
|
32
32
|
repo-memory # starts MCP server on stdio
|
|
33
33
|
```
|
|
34
34
|
|
|
@@ -46,6 +46,9 @@ repo-memory # starts MCP server on stdio
|
|
|
46
46
|
| `get_task_context` | Task state and explored files |
|
|
47
47
|
| `mark_explored` | Mark file as explored for task |
|
|
48
48
|
| `get_token_report` | Token usage telemetry report |
|
|
49
|
+
| `get_related_files` | Find related files ranked by relevance |
|
|
50
|
+
| `batch_file_summaries` | Get summaries for multiple files at once |
|
|
51
|
+
| `search_by_purpose` | Search files by purpose/exports keywords |
|
|
49
52
|
|
|
50
53
|
## How It Works
|
|
51
54
|
|
|
@@ -68,6 +71,22 @@ MCP Server (stdio transport)
|
|
|
68
71
|
└── Persistence Layer (SQLite with WAL mode)
|
|
69
72
|
```
|
|
70
73
|
|
|
74
|
+
## Performance
|
|
75
|
+
|
|
76
|
+
Benchmarks measured on synthetic TypeScript projects with realistic imports and class structures:
|
|
77
|
+
|
|
78
|
+
| Scenario | Files | Raw Size | Summary Size | Compression | Cache Hit Rate | Tokens Saved | Speed |
|
|
79
|
+
|----------|-------|----------|--------------|-------------|----------------|--------------|-------|
|
|
80
|
+
| Explore project | 10 | 11.7 KB | 3.3 KB | 3.6x | 100% | ~2,100 | 3.7 ms/file |
|
|
81
|
+
| Explore project | 50 | 58.0 KB | 16.2 KB | 3.6x | 100% | ~10,700 | 0.7 ms/file |
|
|
82
|
+
| Explore project | 100 | 116.1 KB | 32.3 KB | 3.6x | 100% | ~21,500 | 0.4 ms/file |
|
|
83
|
+
| Explore project | 200 | 233.4 KB | 65.7 KB | 3.6x | 100% | ~42,900 | 0.3 ms/file |
|
|
84
|
+
| Incremental change | 200 | 233.4 KB | 65.7 KB | 3.6x | 100% | ~42,900 | 0.3 ms/file |
|
|
85
|
+
|
|
86
|
+
**Key takeaway:** ~3.6x compression ratio at all scales. A 200-file project exploration saves ~43,000 tokens. Sub-millisecond per file on cached reads.
|
|
87
|
+
|
|
88
|
+
Run benchmarks yourself: `npm run benchmark`
|
|
89
|
+
|
|
71
90
|
## Development
|
|
72
91
|
|
|
73
92
|
```bash
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"project-map.d.ts","sourceRoot":"","sources":["../../src/indexer/project-map.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"project-map.d.ts","sourceRoot":"","sources":["../../src/indexer/project-map.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AA8ID,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,UAAU,CAAC,CAWrB"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { readFile } from 'node:fs/promises';
|
|
1
|
+
import { readFile, stat } from 'node:fs/promises';
|
|
2
2
|
import { join, dirname, basename, extname } from 'node:path';
|
|
3
3
|
import { scanProject } from './scanner.js';
|
|
4
4
|
import { summarizeFile } from './summarizer.js';
|
|
@@ -8,12 +8,18 @@ async function getSummaries(projectRoot, files) {
|
|
|
8
8
|
const cache = new CacheStore(projectRoot);
|
|
9
9
|
const entries = [];
|
|
10
10
|
for (const relativePath of files) {
|
|
11
|
+
const absolutePath = join(projectRoot, relativePath);
|
|
11
12
|
const cached = cache.getEntry(relativePath);
|
|
12
13
|
if (cached?.summary) {
|
|
13
|
-
|
|
14
|
+
try {
|
|
15
|
+
const stats = await stat(absolutePath);
|
|
16
|
+
entries.push({ relativePath, summary: cached.summary, size: stats.size, lastModified: stats.mtimeMs });
|
|
17
|
+
}
|
|
18
|
+
catch {
|
|
19
|
+
entries.push({ relativePath, summary: cached.summary, size: 0, lastModified: 0 });
|
|
20
|
+
}
|
|
14
21
|
continue;
|
|
15
22
|
}
|
|
16
|
-
const absolutePath = join(projectRoot, relativePath);
|
|
17
23
|
let contents;
|
|
18
24
|
try {
|
|
19
25
|
contents = await readFile(absolutePath, 'utf-8');
|
|
@@ -24,7 +30,8 @@ async function getSummaries(projectRoot, files) {
|
|
|
24
30
|
const summary = summarizeFile(relativePath, contents);
|
|
25
31
|
const hash = hashContents(contents);
|
|
26
32
|
cache.setEntry(relativePath, hash, summary);
|
|
27
|
-
|
|
33
|
+
const stats = await stat(absolutePath);
|
|
34
|
+
entries.push({ relativePath, summary, size: stats.size, lastModified: stats.mtimeMs });
|
|
28
35
|
}
|
|
29
36
|
return entries;
|
|
30
37
|
}
|
|
@@ -71,6 +78,9 @@ function buildTree(entries, rootName, maxDepth) {
|
|
|
71
78
|
dir.files.push({
|
|
72
79
|
name: basename(entry.relativePath),
|
|
73
80
|
purpose: entry.summary.purpose,
|
|
81
|
+
confidence: entry.summary.confidence,
|
|
82
|
+
size: entry.size,
|
|
83
|
+
lastModified: entry.lastModified,
|
|
74
84
|
});
|
|
75
85
|
}
|
|
76
86
|
function computeFileCounts(node) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"project-map.js","sourceRoot":"","sources":["../../src/indexer/project-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"project-map.js","sourceRoot":"","sources":["../../src/indexer/project-map.ts"],"names":[],"mappings":"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"}
|
package/dist/server.js
CHANGED
|
@@ -10,9 +10,14 @@ import { invalidateCache } from './tools/invalidate.js';
|
|
|
10
10
|
import { getDependencyGraphTool } from './tools/get-dependency-graph.js';
|
|
11
11
|
import { createTaskTool, getTaskContext, markExploredTool } from './tools/task-context.js';
|
|
12
12
|
import { getTokenReport } from './tools/get-token-report.js';
|
|
13
|
+
import { getRelatedFiles } from './tools/get-related-files.js';
|
|
14
|
+
import { batchFileSummaries } from './tools/batch-file-summaries.js';
|
|
15
|
+
import { searchByPurpose } from './tools/search-by-purpose.js';
|
|
16
|
+
import { runGC } from './cache/gc.js';
|
|
17
|
+
import { SessionManager } from './memory/session.js';
|
|
13
18
|
const server = new McpServer({
|
|
14
19
|
name: 'repo-memory',
|
|
15
|
-
version: '0.
|
|
20
|
+
version: '0.2.0',
|
|
16
21
|
});
|
|
17
22
|
server.registerTool('get_file_summary', {
|
|
18
23
|
title: 'Get File Summary',
|
|
@@ -185,9 +190,72 @@ server.registerTool('get_token_report', {
|
|
|
185
190
|
content: [{ type: 'text', text: JSON.stringify(report, null, 2) }],
|
|
186
191
|
};
|
|
187
192
|
});
|
|
193
|
+
server.registerTool('batch_file_summaries', {
|
|
194
|
+
title: 'Batch File Summaries',
|
|
195
|
+
description: 'Get cached summaries for multiple files in one call. More efficient than calling get_file_summary repeatedly.',
|
|
196
|
+
inputSchema: {
|
|
197
|
+
paths: z.array(z.string()).describe('Array of file paths relative to project root'),
|
|
198
|
+
},
|
|
199
|
+
}, async ({ paths }) => {
|
|
200
|
+
const projectRoot = process.cwd();
|
|
201
|
+
const result = await batchFileSummaries(projectRoot, paths);
|
|
202
|
+
return {
|
|
203
|
+
content: [{ type: 'text', text: JSON.stringify(result) }],
|
|
204
|
+
};
|
|
205
|
+
});
|
|
206
|
+
server.registerTool('get_related_files', {
|
|
207
|
+
title: 'Get Related Files',
|
|
208
|
+
description: 'Returns files related to the given file, ranked by dependency proximity and relevance. Useful for finding what else to look at when exploring a file.',
|
|
209
|
+
inputSchema: {
|
|
210
|
+
path: z.string().describe('File path relative to project root'),
|
|
211
|
+
limit: z.number().optional().describe('Max results (default: 10)'),
|
|
212
|
+
task_id: z.string().optional().describe('Task ID for context-aware ranking'),
|
|
213
|
+
},
|
|
214
|
+
}, async ({ path, limit, task_id }) => {
|
|
215
|
+
const projectRoot = process.cwd();
|
|
216
|
+
const result = await getRelatedFiles(projectRoot, path, { limit, taskId: task_id });
|
|
217
|
+
return {
|
|
218
|
+
content: [{ type: 'text', text: JSON.stringify(result) }],
|
|
219
|
+
};
|
|
220
|
+
});
|
|
221
|
+
server.registerTool('search_by_purpose', {
|
|
222
|
+
title: 'Search By Purpose',
|
|
223
|
+
description: 'Search cached file summaries by keyword. Matches against file purpose, exports, and declarations. Requires files to have been previously summarized.',
|
|
224
|
+
inputSchema: {
|
|
225
|
+
query: z.string().describe('Search keywords (e.g., "database", "auth middleware", "validation")'),
|
|
226
|
+
limit: z.number().optional().describe('Max results (default: 20)'),
|
|
227
|
+
},
|
|
228
|
+
}, async ({ query, limit }) => {
|
|
229
|
+
const projectRoot = process.cwd();
|
|
230
|
+
const result = searchByPurpose(projectRoot, query, limit);
|
|
231
|
+
return {
|
|
232
|
+
content: [{ type: 'text', text: JSON.stringify(result) }],
|
|
233
|
+
};
|
|
234
|
+
});
|
|
188
235
|
async function main() {
|
|
189
236
|
const transport = new StdioServerTransport();
|
|
190
237
|
await server.connect(transport);
|
|
238
|
+
const projectRoot = process.cwd();
|
|
239
|
+
// Auto-start session
|
|
240
|
+
const sessionManager = new SessionManager(projectRoot);
|
|
241
|
+
const session = sessionManager.startSession({ source: 'mcp-connect' });
|
|
242
|
+
process.stderr.write(`Session started: ${session.id}\n`);
|
|
243
|
+
// End session on exit
|
|
244
|
+
const cleanup = () => {
|
|
245
|
+
try {
|
|
246
|
+
sessionManager.endSession(session.id);
|
|
247
|
+
}
|
|
248
|
+
catch {
|
|
249
|
+
// ignore errors during cleanup
|
|
250
|
+
}
|
|
251
|
+
};
|
|
252
|
+
process.on('SIGINT', cleanup);
|
|
253
|
+
process.on('SIGTERM', cleanup);
|
|
254
|
+
process.on('beforeExit', cleanup);
|
|
255
|
+
// Run GC in background on startup (non-blocking)
|
|
256
|
+
runGC(projectRoot).catch((err) => {
|
|
257
|
+
process.stderr.write(`GC warning: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
258
|
+
});
|
|
191
259
|
}
|
|
192
260
|
main().catch((error) => {
|
|
193
261
|
const message = error instanceof Error ? (error.stack ?? error.message) : String(error);
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { type FileSummaryResult } from './get-file-summary.js';
|
|
2
|
+
export interface BatchFileSummariesResult {
|
|
3
|
+
results: FileSummaryResult[];
|
|
4
|
+
totalFiles: number;
|
|
5
|
+
cacheHits: number;
|
|
6
|
+
cacheMisses: number;
|
|
7
|
+
errors: Array<{
|
|
8
|
+
path: string;
|
|
9
|
+
error: string;
|
|
10
|
+
}>;
|
|
11
|
+
}
|
|
12
|
+
export declare function batchFileSummaries(projectRoot: string, paths: string[]): Promise<BatchFileSummariesResult>;
|
|
13
|
+
//# sourceMappingURL=batch-file-summaries.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"batch-file-summaries.d.ts","sourceRoot":"","sources":["../../src/tools/batch-file-summaries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG/E,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,wBAAwB,CAAC,CAoBnC"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { getFileSummary } from './get-file-summary.js';
|
|
2
|
+
import { validatePath } from '../utils/validate-path.js';
|
|
3
|
+
export async function batchFileSummaries(projectRoot, paths) {
|
|
4
|
+
const results = [];
|
|
5
|
+
const errors = [];
|
|
6
|
+
let cacheHits = 0;
|
|
7
|
+
let cacheMisses = 0;
|
|
8
|
+
for (const rawPath of paths) {
|
|
9
|
+
try {
|
|
10
|
+
const validPath = validatePath(projectRoot, rawPath);
|
|
11
|
+
const result = await getFileSummary(projectRoot, validPath);
|
|
12
|
+
results.push(result);
|
|
13
|
+
if (result.fromCache)
|
|
14
|
+
cacheHits++;
|
|
15
|
+
else
|
|
16
|
+
cacheMisses++;
|
|
17
|
+
}
|
|
18
|
+
catch (error) {
|
|
19
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
20
|
+
errors.push({ path: rawPath, error: message });
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
return { results, totalFiles: paths.length, cacheHits, cacheMisses, errors };
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=batch-file-summaries.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"batch-file-summaries.js","sourceRoot":"","sources":["../../src/tools/batch-file-summaries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA0B,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAUzD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,KAAe;IAEf,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,MAAM,MAAM,GAA2C,EAAE,CAAC;IAC1D,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,IAAI,MAAM,CAAC,SAAS;gBAAE,SAAS,EAAE,CAAC;;gBAC7B,WAAW,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AAC/E,CAAC"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export interface RelatedFilesResult {
|
|
2
|
+
path: string;
|
|
3
|
+
relatedFiles: Array<{
|
|
4
|
+
path: string;
|
|
5
|
+
score: number;
|
|
6
|
+
relationship: string;
|
|
7
|
+
}>;
|
|
8
|
+
}
|
|
9
|
+
export declare function getRelatedFiles(projectRoot: string, relativePath: string, options?: {
|
|
10
|
+
limit?: number;
|
|
11
|
+
taskId?: string;
|
|
12
|
+
}): Promise<RelatedFilesResult>;
|
|
13
|
+
//# sourceMappingURL=get-related-files.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-related-files.d.ts","sourceRoot":"","sources":["../../src/tools/get-related-files.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,KAAK,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,kBAAkB,CAAC,CAmH7B"}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
import { readFile } from 'node:fs/promises';
|
|
2
|
+
import { join, dirname } from 'node:path';
|
|
3
|
+
import { DependencyGraph } from '../graph/dependency-graph.js';
|
|
4
|
+
import { scanProject } from '../indexer/scanner.js';
|
|
5
|
+
import { validatePath } from '../utils/validate-path.js';
|
|
6
|
+
import { rankFiles } from '../cache/ranking.js';
|
|
7
|
+
import { getTaskContext } from '../tools/task-context.js';
|
|
8
|
+
export async function getRelatedFiles(projectRoot, relativePath, options) {
|
|
9
|
+
const validated = validatePath(projectRoot, relativePath);
|
|
10
|
+
const limit = options?.limit ?? 10;
|
|
11
|
+
// Build the dependency graph
|
|
12
|
+
const graph = new DependencyGraph(projectRoot);
|
|
13
|
+
const files = await scanProject(projectRoot);
|
|
14
|
+
for (const file of files) {
|
|
15
|
+
if (!file.endsWith('.ts') &&
|
|
16
|
+
!file.endsWith('.js') &&
|
|
17
|
+
!file.endsWith('.tsx') &&
|
|
18
|
+
!file.endsWith('.jsx') &&
|
|
19
|
+
!file.endsWith('.mjs') &&
|
|
20
|
+
!file.endsWith('.cjs')) {
|
|
21
|
+
continue;
|
|
22
|
+
}
|
|
23
|
+
try {
|
|
24
|
+
const contents = await readFile(join(projectRoot, file), 'utf-8');
|
|
25
|
+
graph.updateFile(file, contents);
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
28
|
+
// Skip unreadable files
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
// The graph may store paths with .js extension (from import specifiers) while
|
|
32
|
+
// actual files have .ts extension. Query both variants to get complete results.
|
|
33
|
+
const variants = getPathVariants(validated);
|
|
34
|
+
// Get direct dependencies and dependents across all path variants
|
|
35
|
+
const dependencies = new Set();
|
|
36
|
+
const dependents = new Set();
|
|
37
|
+
for (const v of variants) {
|
|
38
|
+
for (const d of graph.getDependencies(v))
|
|
39
|
+
dependencies.add(d);
|
|
40
|
+
for (const d of graph.getDependents(v))
|
|
41
|
+
dependents.add(d);
|
|
42
|
+
}
|
|
43
|
+
// Get transitive dependencies (depth 2) for "transitive-dependency" classification
|
|
44
|
+
const transitiveDeps = new Set();
|
|
45
|
+
const transitiveDependents = new Set();
|
|
46
|
+
for (const v of variants) {
|
|
47
|
+
for (const d of graph.getTransitiveDependencies(v, 2))
|
|
48
|
+
transitiveDeps.add(d);
|
|
49
|
+
for (const d of graph.getTransitiveDependents(v, 2))
|
|
50
|
+
transitiveDependents.add(d);
|
|
51
|
+
}
|
|
52
|
+
// Determine same-directory files
|
|
53
|
+
const fileDir = dirname(validated);
|
|
54
|
+
const sameDirFiles = new Set(files.filter((f) => f !== validated && dirname(f) === fileDir));
|
|
55
|
+
// Collect all candidate related files (excluding the file itself)
|
|
56
|
+
const candidates = new Set();
|
|
57
|
+
for (const d of dependencies)
|
|
58
|
+
candidates.add(d);
|
|
59
|
+
for (const d of dependents)
|
|
60
|
+
candidates.add(d);
|
|
61
|
+
for (const d of transitiveDeps)
|
|
62
|
+
candidates.add(d);
|
|
63
|
+
for (const d of transitiveDependents)
|
|
64
|
+
candidates.add(d);
|
|
65
|
+
for (const d of sameDirFiles)
|
|
66
|
+
candidates.add(d);
|
|
67
|
+
// Remove the file itself (all variants)
|
|
68
|
+
for (const v of variants)
|
|
69
|
+
candidates.delete(v);
|
|
70
|
+
if (candidates.size === 0) {
|
|
71
|
+
return { path: validated, relatedFiles: [] };
|
|
72
|
+
}
|
|
73
|
+
// Classify relationships
|
|
74
|
+
const relationshipMap = new Map();
|
|
75
|
+
for (const c of candidates) {
|
|
76
|
+
if (dependencies.has(c)) {
|
|
77
|
+
relationshipMap.set(c, 'imports');
|
|
78
|
+
}
|
|
79
|
+
else if (dependents.has(c)) {
|
|
80
|
+
relationshipMap.set(c, 'imported-by');
|
|
81
|
+
}
|
|
82
|
+
else if (transitiveDeps.has(c) || transitiveDependents.has(c)) {
|
|
83
|
+
relationshipMap.set(c, 'transitive-dependency');
|
|
84
|
+
}
|
|
85
|
+
else if (sameDirFiles.has(c)) {
|
|
86
|
+
relationshipMap.set(c, 'same-directory');
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
// Get task context for ranking if taskId provided
|
|
90
|
+
let exploredFiles = [];
|
|
91
|
+
let flaggedFiles = [];
|
|
92
|
+
if (options?.taskId) {
|
|
93
|
+
try {
|
|
94
|
+
const ctx = getTaskContext(projectRoot, options.taskId);
|
|
95
|
+
exploredFiles = ctx.exploredFiles.map((f) => f.filePath);
|
|
96
|
+
flaggedFiles = ctx.exploredFiles
|
|
97
|
+
.filter((f) => f.status === 'flagged')
|
|
98
|
+
.map((f) => f.filePath);
|
|
99
|
+
}
|
|
100
|
+
catch {
|
|
101
|
+
// Task not found — proceed without context
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
// Rank candidates
|
|
105
|
+
const candidateArray = [...candidates];
|
|
106
|
+
const ranked = rankFiles(candidateArray, {
|
|
107
|
+
projectRoot,
|
|
108
|
+
exploredFiles,
|
|
109
|
+
flaggedFiles,
|
|
110
|
+
graph,
|
|
111
|
+
limit,
|
|
112
|
+
});
|
|
113
|
+
const relatedFiles = ranked.map((r) => ({
|
|
114
|
+
path: r.path,
|
|
115
|
+
score: r.score,
|
|
116
|
+
relationship: relationshipMap.get(r.path) ?? 'same-directory',
|
|
117
|
+
}));
|
|
118
|
+
return { path: validated, relatedFiles };
|
|
119
|
+
}
|
|
120
|
+
/** Get path variants to handle .ts/.js extension mismatch in the dependency graph. */
|
|
121
|
+
function getPathVariants(filePath) {
|
|
122
|
+
const variants = [filePath];
|
|
123
|
+
if (filePath.endsWith('.ts')) {
|
|
124
|
+
variants.push(filePath.replace(/\.ts$/, '.js'));
|
|
125
|
+
}
|
|
126
|
+
else if (filePath.endsWith('.tsx')) {
|
|
127
|
+
variants.push(filePath.replace(/\.tsx$/, '.js'));
|
|
128
|
+
variants.push(filePath.replace(/\.tsx$/, '.jsx'));
|
|
129
|
+
}
|
|
130
|
+
else if (filePath.endsWith('.js')) {
|
|
131
|
+
variants.push(filePath.replace(/\.js$/, '.ts'));
|
|
132
|
+
variants.push(filePath.replace(/\.js$/, '.tsx'));
|
|
133
|
+
}
|
|
134
|
+
else if (filePath.endsWith('.jsx')) {
|
|
135
|
+
variants.push(filePath.replace(/\.jsx$/, '.tsx'));
|
|
136
|
+
}
|
|
137
|
+
return variants;
|
|
138
|
+
}
|
|
139
|
+
//# sourceMappingURL=get-related-files.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-related-files.js","sourceRoot":"","sources":["../../src/tools/get-related-files.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export interface SearchResult {
|
|
2
|
+
path: string;
|
|
3
|
+
purpose: string;
|
|
4
|
+
matchedOn: string[];
|
|
5
|
+
exports: string[];
|
|
6
|
+
confidence: string;
|
|
7
|
+
}
|
|
8
|
+
export interface SearchByPurposeResult {
|
|
9
|
+
query: string;
|
|
10
|
+
results: SearchResult[];
|
|
11
|
+
totalCached: number;
|
|
12
|
+
}
|
|
13
|
+
export declare function searchByPurpose(projectRoot: string, query: string, limit?: number): SearchByPurposeResult;
|
|
14
|
+
//# sourceMappingURL=search-by-purpose.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"search-by-purpose.d.ts","sourceRoot":"","sources":["../../src/tools/search-by-purpose.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,qBAAqB,CA2DvB"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { CacheStore } from '../cache/store.js';
|
|
2
|
+
export function searchByPurpose(projectRoot, query, limit) {
|
|
3
|
+
const store = new CacheStore(projectRoot);
|
|
4
|
+
const allEntries = store.getAllEntries();
|
|
5
|
+
const effectiveLimit = limit ?? 20;
|
|
6
|
+
const queryTerms = query.toLowerCase().split(/\s+/).filter(Boolean);
|
|
7
|
+
const results = [];
|
|
8
|
+
for (const entry of allEntries) {
|
|
9
|
+
if (!entry.summary)
|
|
10
|
+
continue;
|
|
11
|
+
const matchedOn = [];
|
|
12
|
+
let score = 0;
|
|
13
|
+
const purpose = entry.summary.purpose.toLowerCase();
|
|
14
|
+
const purposeMatches = queryTerms.filter(term => purpose.includes(term));
|
|
15
|
+
if (purposeMatches.length > 0) {
|
|
16
|
+
matchedOn.push('purpose');
|
|
17
|
+
score += purposeMatches.length * 3; // purpose matches weighted highest
|
|
18
|
+
}
|
|
19
|
+
const exportsLower = entry.summary.exports.map(e => e.toLowerCase());
|
|
20
|
+
const exportMatches = queryTerms.filter(term => exportsLower.some(exp => exp.includes(term)));
|
|
21
|
+
if (exportMatches.length > 0) {
|
|
22
|
+
matchedOn.push('exports');
|
|
23
|
+
score += exportMatches.length * 2;
|
|
24
|
+
}
|
|
25
|
+
const declsLower = entry.summary.topLevelDeclarations.map(d => d.toLowerCase());
|
|
26
|
+
const declMatches = queryTerms.filter(term => declsLower.some(decl => decl.includes(term)));
|
|
27
|
+
if (declMatches.length > 0) {
|
|
28
|
+
matchedOn.push('declarations');
|
|
29
|
+
score += declMatches.length;
|
|
30
|
+
}
|
|
31
|
+
if (matchedOn.length > 0) {
|
|
32
|
+
results.push({
|
|
33
|
+
path: entry.path,
|
|
34
|
+
purpose: entry.summary.purpose,
|
|
35
|
+
matchedOn,
|
|
36
|
+
exports: entry.summary.exports,
|
|
37
|
+
confidence: entry.summary.confidence,
|
|
38
|
+
score,
|
|
39
|
+
});
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
// Sort by score descending
|
|
43
|
+
results.sort((a, b) => b.score - a.score);
|
|
44
|
+
return {
|
|
45
|
+
query,
|
|
46
|
+
results: results.slice(0, effectiveLimit).map(({ score: _score, ...rest }) => rest),
|
|
47
|
+
totalCached: allEntries.filter(e => e.summary).length,
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
//# sourceMappingURL=search-by-purpose.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"search-by-purpose.js","sourceRoot":"","sources":["../../src/tools/search-by-purpose.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@blamechris/repo-memory",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "MCP server that gives AI coding agents persistent memory about your codebase",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/server.js",
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
"lint": "eslint --no-error-on-unmatched-pattern 'src/**/*.ts' 'tests/**/*.ts'",
|
|
24
24
|
"format": "prettier --write 'src/**/*.ts' '*.json' '*.mjs' && prettier --write 'tests/**/*.ts' 2>/dev/null || true",
|
|
25
25
|
"prepublishOnly": "npm run typecheck && npm run lint && npm run test && npm run build",
|
|
26
|
-
"benchmark": "tsx tests/benchmarks/run-benchmarks.ts"
|
|
26
|
+
"benchmark": "npx tsx tests/benchmarks/run-benchmarks.ts"
|
|
27
27
|
},
|
|
28
28
|
"keywords": [
|
|
29
29
|
"mcp",
|