preflight-mcp 0.2.1 → 0.2.2
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/dist/server.js +29 -4
- package/package.json +1 -1
package/dist/server.js
CHANGED
|
@@ -100,7 +100,7 @@ export async function startServer() {
|
|
|
100
100
|
startHttpServer(cfg);
|
|
101
101
|
const server = new McpServer({
|
|
102
102
|
name: 'preflight-mcp',
|
|
103
|
-
version: '0.2.
|
|
103
|
+
version: '0.2.2',
|
|
104
104
|
description: 'Create evidence-based preflight bundles for repositories (docs + code) with SQLite FTS search.',
|
|
105
105
|
}, {
|
|
106
106
|
capabilities: {
|
|
@@ -265,9 +265,34 @@ export async function startServer() {
|
|
|
265
265
|
server.registerTool('preflight_read_file', {
|
|
266
266
|
title: 'Read bundle file(s)',
|
|
267
267
|
description: 'Read file(s) from bundle. Two modes: ' +
|
|
268
|
-
'(1) Omit "file" param → returns ALL key files
|
|
269
|
-
'(2) Provide "file" param → returns that specific file
|
|
270
|
-
'Use when: "查看bundle", "show bundle", "read overview", "bundle概览", "项目信息", "读取依赖图"
|
|
268
|
+
'(1) Omit "file" param → returns ALL key files in one call. ' +
|
|
269
|
+
'(2) Provide "file" param → returns that specific file. ' +
|
|
270
|
+
'Use when: "查看bundle", "show bundle", "read overview", "bundle概览", "项目信息", "读取依赖图".\n\n' +
|
|
271
|
+
'📁 **Bundle Structure:**\n' +
|
|
272
|
+
'```\n' +
|
|
273
|
+
'bundle-{id}/\n' +
|
|
274
|
+
'├── manifest.json # Bundle metadata (JSON)\n' +
|
|
275
|
+
'├── OVERVIEW.md # Project overview\n' +
|
|
276
|
+
'├── START_HERE.md # Entry points guide\n' +
|
|
277
|
+
'├── AGENTS.md # AI agent instructions\n' +
|
|
278
|
+
'├── analysis/\n' +
|
|
279
|
+
'│ └── FACTS.json # Static analysis facts (JSON) - use this tool to read\n' +
|
|
280
|
+
'├── deps/\n' +
|
|
281
|
+
'│ └── dependency-graph.json # Import graph (JSON) - generated by preflight_evidence_dependency_graph\n' +
|
|
282
|
+
'├── trace/\n' +
|
|
283
|
+
'│ ├── trace.sqlite3 # Trace links DB - query via preflight_trace_query\n' +
|
|
284
|
+
'│ └── trace.json # Trace links export (JSON) - use this tool to read\n' +
|
|
285
|
+
'├── indexes/\n' +
|
|
286
|
+
'│ └── search.sqlite3 # FTS5 index - query via preflight_search_bundle\n' +
|
|
287
|
+
'└── repos/{owner}/{repo}/\n' +
|
|
288
|
+
' ├── raw/ # Original files\n' +
|
|
289
|
+
' └── norm/ # Normalized source code\n' +
|
|
290
|
+
'```\n\n' +
|
|
291
|
+
'**File Access Methods:**\n' +
|
|
292
|
+
'- JSON files (FACTS.json, dependency-graph.json, trace.json, manifest.json): Use THIS tool\n' +
|
|
293
|
+
'- SQLite DBs (search.sqlite3): Use preflight_search_bundle\n' +
|
|
294
|
+
'- SQLite DBs (trace.sqlite3): Use preflight_trace_query/preflight_trace_upsert\n' +
|
|
295
|
+
'- Source code in repos/: Use THIS tool with path like "repos/owner/repo/norm/src/file.ts"',
|
|
271
296
|
inputSchema: {
|
|
272
297
|
bundleId: z.string().describe('Bundle ID to read.'),
|
|
273
298
|
file: z.string().optional().describe('Specific file to read (e.g., "deps/dependency-graph.json"). If omitted, returns all key files including dependency graph if exists.'),
|