preflight-mcp 0.1.7 → 0.1.8

package/dist/bundle/githubArchive.js

@@ -7,7 +7,7 @@ function nowIso() {
 }
 function githubHeaders(cfg) {
     const headers = {
-        'User-Agent': 'preflight-mcp/0.1.7',
+        'User-Agent': 'preflight-mcp/0.1.8',
         Accept: 'application/vnd.github+json',
     };
     if (cfg.githubToken) {

package/dist/bundle/paths.js

@@ -25,6 +25,7 @@ export function getBundlePaths(storageDir, bundleId) {
     validateBundleId(bundleId);
     const rootDir = path.join(storageDir, bundleId);
     const indexesDir = path.join(rootDir, 'indexes');
+    const depsDir = path.join(rootDir, 'deps');
     return {
         bundleId,
         rootDir,
@@ -36,6 +37,8 @@ export function getBundlePaths(storageDir, bundleId) {
         searchDbPath: path.join(indexesDir, 'search.sqlite3'),
         reposDir: path.join(rootDir, 'repos'),
         librariesDir: path.join(rootDir, 'libraries'),
+        depsDir,
+        depsGraphPath: path.join(depsDir, 'dependency-graph.json'),
     };
 }
 export function repoRootDir(paths, owner, repo) {

package/dist/context7/client.js

@@ -20,7 +20,7 @@ export async function connectContext7(cfg) {
             maxRetries: 1,
         },
     });
-    const client = new Client({ name: 'preflight-context7', version: '0.1.7' });
+    const client = new Client({ name: 'preflight-context7', version: '0.1.8' });
     await client.connect(transport);
     return {
         client,

package/dist/errors.js

@@ -46,7 +46,8 @@ export class BundleNotFoundError extends PreflightError {
             ? '\nUse preflight_list_bundles to see available bundles.'
             : `\nHint: bundleId must be a UUID (e.g., 025c6dcb-1234-5678-9abc-def012345678).\n` +
                 `      "${bundleId}" looks like a displayName, not a bundleId.\n` +
-                `      Use preflight_list_bundles to find the correct bundleId.`;
+                `      Use preflight_list_bundles to find the correct bundleId.\n` +
+                `      DO NOT automatically create a new bundle - ASK the user first!`;
         super(`Bundle not found: ${bundleId}${hint}`, 'BUNDLE_NOT_FOUND', {
             context: { bundleId },
         });

package/dist/evidence/dependencyGraph.js

@@ -21,6 +21,8 @@ export const DependencyGraphInputSchema = {
             .describe('Optional symbol name (function/class). If omitted, graph is file-level.'),
     }).optional().describe('Target file/symbol to analyze. If omitted, generates a GLOBAL dependency graph of all code files in the bundle. ' +
         'Global mode shows import relationships between all files but may be truncated for large projects.'),
+    force: z.boolean().default(false).describe('If true, regenerate the dependency graph even if cached. ' +
+        'Global mode results are cached in the bundle; use force=true to refresh.'),
     options: z
         .object({
         maxFiles: z.number().int().min(1).max(500).default(200),
@@ -200,6 +202,24 @@ export async function generateDependencyGraph(cfg, rawArgs) {
     }
     const paths = getBundlePathsForId(storageDir, args.bundleId);
     const manifest = await readManifest(paths.manifestPath);
+    // Global mode: check for cached result (unless force=true)
+    const isGlobalMode = !args.target;
+    if (isGlobalMode && !args.force) {
+        try {
+            const cached = await fs.readFile(paths.depsGraphPath, 'utf8');
+            const parsed = JSON.parse(cached);
+            // Add note that this is from cache
+            parsed.signals.warnings = parsed.signals.warnings || [];
+            parsed.signals.warnings.unshift({
+                code: 'from_cache',
+                message: `Loaded from cache (generated at ${parsed.meta.generatedAt}). Use force=true to regenerate.`,
+            });
+            return parsed;
+        }
+        catch {
+            // Cache miss - generate fresh
+        }
+    }
     const limits = {
         maxFiles: args.options.maxFiles,
         maxNodes: args.options.maxNodes,
@@ -248,7 +268,7 @@ export async function generateDependencyGraph(cfg, rawArgs) {
     const bundleFileUri = (p) => toBundleFileUri({ bundleId: args.bundleId, relativePath: p });
     // Global mode: no target specified
     if (!args.target) {
-        return generateGlobalDependencyGraph({
+        const result = await generateGlobalDependencyGraph({
             cfg,
             args,
             paths,
@@ -265,6 +285,15 @@ export async function generateDependencyGraph(cfg, rawArgs) {
             addEdge,
             bundleFileUri,
         });
+        // Save to cache
+        try {
+            await fs.mkdir(paths.depsDir, { recursive: true });
+            await fs.writeFile(paths.depsGraphPath, JSON.stringify(result, null, 2));
+        }
+        catch {
+            // Ignore cache write errors
+        }
+        return result;
     }
     const targetFile = args.target.file.replaceAll('\\', '/');
     const targetRepo = parseRepoNormPath(targetFile);

package/dist/server.js

@@ -100,7 +100,7 @@ export async function startServer() {
     startHttpServer(cfg);
     const server = new McpServer({
         name: 'preflight-mcp',
-        version: '0.1.7',
+        version: '0.1.8',
         description: 'Create evidence-based preflight bundles for repositories (docs + code) with SQLite FTS search.',
     }, {
         capabilities: {
@@ -380,7 +380,7 @@ export async function startServer() {
     });
     server.registerTool('preflight_create_bundle', {
         title: 'Create bundle',
-        description: 'Create a new bundle from GitHub repos or local directories (or update an existing one if ifExists=updateExisting). Use when: "index this repo", "create bundle for", "add repo to preflight", "索引这个仓库", "创建bundle", "添加GitHub项目", "学习这个项目". NOTE: If the bundle contains code files, consider asking user if they want to generate dependency graph (preflight_evidence_dependency_graph) or establish trace links (preflight_trace_upsert).',
+        description: 'Create a new bundle from GitHub repos or local directories. IMPORTANT: Only call this tool when the user EXPLICITLY asks to create/index a repo. Do NOT automatically create bundles when search fails or bundle is not found - ASK the user first! Use when user says: "index this repo", "create bundle for", "创建bundle", "添加GitHub项目". If ifExists=updateExisting, updates an existing bundle.',
         inputSchema: CreateBundleInputSchema,
         outputSchema: {
             // Normal completion fields
@@ -793,11 +793,10 @@ export async function startServer() {
     });
     server.registerTool('preflight_evidence_dependency_graph', {
         title: 'Evidence: dependency graph (callers + imports)',
-        description: 'Generate an evidence-based dependency graph. Two modes: ' +
-            '(1) TARGET MODE: provide target.file to analyze a specific file\'s imports and callers. ' +
-            '(2) GLOBAL MODE: omit target to generate a project-wide import graph of all code files. ' +
-            'For target mode, file path must be bundle-relative: repos/{owner}/{repo}/norm/{path}. ' +
-            'Use preflight_search_bundle to find file paths, or check OVERVIEW.md.',
+        description: 'Generate an evidence-based dependency graph. IMPORTANT: Before running, ASK the user which bundle and which file/mode they want! ' +
+            'Two modes: (1) TARGET MODE: analyze a specific file (provide target.file). (2) GLOBAL MODE: project-wide graph (omit target). ' +
+            'Do NOT automatically choose bundle or mode - confirm with user first! ' +
+            'File path must be bundle-relative: repos/{owner}/{repo}/norm/{path}.',
         inputSchema: DependencyGraphInputSchema,
         outputSchema: {
             meta: z.any(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "preflight-mcp",
-"version": "0.1.7",
+"version": "0.1.8",
   "description": "MCP server that creates evidence-based preflight bundles for GitHub repositories and library docs.",
   "type": "module",
   "license": "MIT",