preflight-mcp 0.1.6 → 0.1.7

package/dist/bundle/githubArchive.js

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

package/dist/bundle/service.js

@@ -15,6 +15,7 @@ import { analyzeBundleStatic } from './analysis.js';
 import { autoDetectTags, generateDisplayName, generateDescription } from './tagging.js';
 import { bundleCreationLimiter } from '../core/concurrency-limiter.js';
 import { getProgressTracker, calcPercent } from '../jobs/progressTracker.js';
+import { BundleNotFoundError } from '../errors.js';
 const DEDUP_INDEX_FILE = '.preflight-dedup-index.json';
 function sha256Hex(text) {
     return crypto.createHash('sha256').update(text, 'utf8').digest('hex');
@@ -425,7 +426,7 @@ async function validateBundleCompleteness(bundleRoot) {
 export async function assertBundleComplete(cfg, bundleId) {
     const storageDir = await findBundleStorageDir(cfg.storageDirs, bundleId);
     if (!storageDir) {
-        throw new Error(`Bundle not found: ${bundleId}`);
+        throw new BundleNotFoundError(bundleId);
     }
     const bundleRoot = getBundlePaths(storageDir, bundleId).rootDir;
     const { isValid, missingComponents } = await validateBundleCompleteness(bundleRoot);
@@ -1316,7 +1317,7 @@ export async function repairBundle(cfg, bundleId, options) {
     const rebuildOverviewOpt = options?.rebuildOverview ?? true;
     const storageDir = await findBundleStorageDir(cfg.storageDirs, bundleId);
     if (!storageDir) {
-        throw new Error(`Bundle not found: ${bundleId}`);
+        throw new BundleNotFoundError(bundleId);
     }
     const paths = getBundlePaths(storageDir, bundleId);
     const before = await validateBundleCompleteness(paths.rootDir);

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.6' });
+    const client = new Client({ name: 'preflight-context7', version: '0.1.7' });
     await client.connect(transport);
     return {
         client,

package/dist/errors.js

@@ -31,12 +31,23 @@ export class PreflightError extends Error {
         };
     }
 }
+/**
+ * Check if a string looks like a valid UUID v4.
+ */
+function isUuidFormat(id) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id);
+}
 /**
  * Error thrown when a bundle is not found.
  */
 export class BundleNotFoundError extends PreflightError {
     constructor(bundleId) {
-        super(`Bundle not found: ${bundleId}`, 'BUNDLE_NOT_FOUND', {
+        const hint = isUuidFormat(bundleId)
+            ? '\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.`;
+        super(`Bundle not found: ${bundleId}${hint}`, 'BUNDLE_NOT_FOUND', {
             context: { bundleId },
         });
         this.name = 'BundleNotFoundError';

package/dist/server.js

@@ -8,6 +8,7 @@ import { getProgressTracker } from './jobs/progressTracker.js';
 import { readManifest } from './bundle/manifest.js';
 import { safeJoin, toBundleFileUri } from './mcp/uris.js';
 import { wrapPreflightError } from './mcp/errorKinds.js';
+import { BundleNotFoundError } from './errors.js';
 import { searchIndex } from './search/sqliteFts.js';
 import { logger } from './logging/logger.js';
 import { runSearchByTags } from './tools/searchByTags.js';
@@ -99,7 +100,7 @@ export async function startServer() {
     startHttpServer(cfg);
     const server = new McpServer({
         name: 'preflight-mcp',
-        version: '0.1.6',
+        version: '0.1.7',
         description: 'Create evidence-based preflight bundles for repositories (docs + code) with SQLite FTS search.',
     }, {
         capabilities: {
@@ -280,7 +281,7 @@ export async function startServer() {
         try {
             const storageDir = await findBundleStorageDir(cfg.storageDirs, args.bundleId);
             if (!storageDir) {
-                throw new Error(`Bundle not found: ${args.bundleId}`);
+                throw new BundleNotFoundError(args.bundleId);
             }
             const paths = getBundlePathsForId(storageDir, args.bundleId);
             const bundleRoot = paths.rootDir;
@@ -364,7 +365,7 @@ export async function startServer() {
         try {
             const deleted = await clearBundleMulti(cfg.storageDirs, args.bundleId);
             if (!deleted) {
-                throw new Error(`Bundle not found: ${args.bundleId}`);
+                throw new BundleNotFoundError(args.bundleId);
             }
             server.sendResourceListChanged();
             const out = { deleted: true, bundleId: args.bundleId };
@@ -594,7 +595,7 @@ export async function startServer() {
         try {
             const storageDir = await findBundleStorageDir(cfg.storageDirs, args.bundleId);
             if (!storageDir) {
-                throw new Error(`Bundle not found: ${args.bundleId}`);
+                throw new BundleNotFoundError(args.bundleId);
             }
             // checkOnly mode: just check for updates without applying
             if (args.checkOnly) {
@@ -759,7 +760,7 @@ export async function startServer() {
             // Resolve bundle location across storageDirs (more robust than a single effectiveDir).
             const storageDir = await findBundleStorageDir(cfg.storageDirs, args.bundleId);
             if (!storageDir) {
-                throw new Error(`Bundle not found: ${args.bundleId}`);
+                throw new BundleNotFoundError(args.bundleId);
             }
             if (args.ensureFresh) {
                 throw new Error('ensureFresh is deprecated and not supported in this tool. This tool is strictly read-only. ' +

package/package.json

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