preflight-mcp 0.1.2 → 0.1.3

package/dist/bundle/githubArchive.js

@@ -1,12 +1,13 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import AdmZip from 'adm-zip';
+import { logger } from '../logging/logger.js';
 function nowIso() {
     return new Date().toISOString();
 }
 function githubHeaders(cfg) {
     const headers = {
-        'User-Agent': 'preflight-mcp/0.1.1',
+        'User-Agent': 'preflight-mcp/0.1.3',
         Accept: 'application/vnd.github+json',
     };
     if (cfg.githubToken) {
@@ -17,36 +18,54 @@ function githubHeaders(cfg) {
 async function ensureDir(p) {
     await fs.mkdir(p, { recursive: true });
 }
-async function fetchJson(url, headers) {
-    const res = await fetch(url, { headers });
-    if (!res.ok) {
-        throw new Error(`GitHub API error ${res.status}: ${res.statusText}`);
+/** Default timeout for GitHub API requests (30 seconds). */
+const DEFAULT_API_TIMEOUT_MS = 30_000;
+/** Default timeout for file downloads (5 minutes). */
+const DEFAULT_DOWNLOAD_TIMEOUT_MS = 5 * 60_000;
+async function fetchJson(url, headers, timeoutMs = DEFAULT_API_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, { headers, signal: controller.signal });
+        if (!res.ok) {
+            throw new Error(`GitHub API error ${res.status}: ${res.statusText}`);
+        }
+        return (await res.json());
+    }
+    finally {
+        clearTimeout(timeoutId);
     }
-    return (await res.json());
 }
-async function downloadToFile(url, headers, destPath) {
-    const res = await fetch(url, { headers, redirect: 'follow' });
-    if (!res.ok) {
-        throw new Error(`Download error ${res.status}: ${res.statusText}`);
+async function downloadToFile(url, headers, destPath, timeoutMs = DEFAULT_DOWNLOAD_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, { headers, redirect: 'follow', signal: controller.signal });
+        if (!res.ok) {
+            throw new Error(`Download error ${res.status}: ${res.statusText}`);
+        }
+        // Use streaming if possible; otherwise fallback to arrayBuffer.
+        const anyRes = res;
+        const body = anyRes.body;
+        await ensureDir(path.dirname(destPath));
+        if (body && typeof body.pipe === 'function') {
+            // Node.js stream
+            const ws = (await import('node:fs')).createWriteStream(destPath);
+            await new Promise((resolve, reject) => {
+                body.pipe(ws);
+                body.on('error', reject);
+                ws.on('error', reject);
+                ws.on('finish', () => resolve());
+            });
+            return;
+        }
+        // Web stream or no stream support.
+        const buf = Buffer.from(await res.arrayBuffer());
+        await fs.writeFile(destPath, buf);
     }
-    // Use streaming if possible; otherwise fallback to arrayBuffer.
-    const anyRes = res;
-    const body = anyRes.body;
-    await ensureDir(path.dirname(destPath));
-    if (body && typeof body.pipe === 'function') {
-        // Node.js stream
-        const ws = (await import('node:fs')).createWriteStream(destPath);
-        await new Promise((resolve, reject) => {
-            body.pipe(ws);
-            body.on('error', reject);
-            ws.on('error', reject);
-            ws.on('finish', () => resolve());
-        });
-        return;
+    finally {
+        clearTimeout(timeoutId);
     }
-    // Web stream or no stream support.
-    const buf = Buffer.from(await res.arrayBuffer());
-    await fs.writeFile(destPath, buf);
 }
 async function extractZip(zipPath, destDir) {
     await ensureDir(destDir);
@@ -77,6 +96,8 @@ export async function downloadAndExtractGitHubArchive(params) {
     await extractZip(zipPath, extractDir);
     const repoRoot = await findSingleTopLevelDir(extractDir);
     // Best-effort cleanup: remove zip file (keep extracted for caller to consume).
-    await fs.rm(zipPath, { force: true }).catch(() => undefined);
+    await fs.rm(zipPath, { force: true }).catch((err) => {
+        logger.debug(`Failed to cleanup zip file ${zipPath} (non-critical)`, err instanceof Error ? err : undefined);
+    });
     return { repoRoot, refUsed, fetchedAt: nowIso() };
 }

package/dist/bundle/overview.js

@@ -1,5 +1,6 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
+import { readFacts } from './facts.js';
 function evidence(p, start, end) {
     return `(evidence: ${p}:${start}-${end})`;
 }
@@ -156,64 +157,241 @@ async function renderContext7LibraryFacts(bundleRootDir, lib) {
     }
     return out;
 }
+/**
+ * Phase 3: Extract project purpose from README.md
+ */
+async function extractProjectPurpose(files) {
+    const readme = files.find(f => f.repoRelativePath.toLowerCase() === 'readme.md');
+    if (!readme)
+        return null;
+    try {
+        const content = await fs.readFile(readme.bundleNormAbsPath, 'utf8');
+        const lines = content.split('\n');
+        // Skip title (first h1)
+        let startIdx = 0;
+        for (let i = 0; i < lines.length; i++) {
+            if (lines[i]?.startsWith('# ')) {
+                startIdx = i + 1;
+                break;
+            }
+        }
+        // Extract first paragraph (non-empty lines until empty line or next heading)
+        const paragraph = [];
+        for (let i = startIdx; i < Math.min(lines.length, startIdx + 20); i++) {
+            const line = lines[i]?.trim() || '';
+            if (!line || line.startsWith('#'))
+                break;
+            paragraph.push(line);
+        }
+        return paragraph.join(' ').trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Phase 3: Format module list for display
+ */
+function formatCoreModules(facts) {
+    if (!facts.modules || facts.modules.length === 0)
+        return [];
+    const coreModules = facts.modules
+        .filter(m => m.role === 'core')
+        .sort((a, b) => b.exports.length - a.exports.length)
+        .slice(0, 10);
+    if (coreModules.length === 0)
+        return [];
+    const lines = [];
+    for (const mod of coreModules) {
+        const shortPath = mod.path.replace(/^repos\/[^\/]+\/[^\/]+\/norm\//, '');
+        lines.push(`- **${shortPath}**`);
+        lines.push(`  - Exports: ${mod.exports.slice(0, 5).join(', ')}${mod.exports.length > 5 ? ` (+${mod.exports.length - 5} more)` : ''}`);
+        lines.push(`  - Complexity: ${mod.complexity}, LOC: ${mod.loc}`);
+        lines.push(`  - Evidence: ${mod.path}:1`);
+    }
+    return lines;
+}
+/**
+ * Phase 3: Format standalone modules for reuse guidance
+ */
+function formatStandaloneModules(facts) {
+    if (!facts.modules || facts.modules.length === 0)
+        return [];
+    const standalone = facts.modules
+        .filter(m => m.standalone && (m.role === 'core' || m.role === 'utility'))
+        .filter(m => m.exports.length > 0)
+        .slice(0, 5);
+    if (standalone.length === 0)
+        return [];
+    const lines = [];
+    for (const mod of standalone) {
+        const shortPath = mod.path.replace(/^repos\/[^\/]+\/[^\/]+\/norm\//, '');
+        lines.push(`- **${shortPath}**`);
+        lines.push(`  - Can be used independently`);
+        lines.push(`  - Exports: ${mod.exports.slice(0, 3).join(', ')}`);
+        lines.push(`  - External deps: ${mod.imports.filter(i => !i.startsWith('.')).slice(0, 3).join(', ') || 'None'}`);
+    }
+    return lines;
+}
 export async function generateOverviewMarkdown(params) {
-    const header = `# OVERVIEW.md - Preflight Bundle ${params.bundleId}
-
-This file is generated. It contains **only factual statements** with evidence pointers into bundle files.
-
-`;
-    const sections = [header];
-    for (const r of params.repos) {
-        sections.push(`## Repo: ${r.repoId}`);
-        const metaFacts = await renderRepoMetaFacts(params.bundleRootDir, r.repoId);
-        if (metaFacts.length) {
-            sections.push('### Snapshot facts');
-            sections.push(...metaFacts);
-        }
-        const nodeFacts = await renderNodePackageFacts(r.files);
-        if (nodeFacts.length) {
-            sections.push('### Node/JS facts');
-            sections.push(...nodeFacts);
-        }
-        const docs = getRepoDocFiles(r.files).slice(0, 50);
-        if (docs.length) {
-            sections.push('### Documentation files (first 50)');
-            for (const d of docs) {
-                sections.push(`- ${d.bundleNormRelativePath}. ${evidence(d.bundleNormRelativePath, 1, 1)}`);
-            }
-        }
-        // Give a small hint about where code lives, without guessing entry points.
-        const codeSamples = r.files
-            .filter((f) => f.kind === 'code')
-            .map((f) => f.repoRelativePath)
-            .filter((p) => p.startsWith('src/') || p.startsWith('lib/'))
-            .slice(0, 10);
-        if (codeSamples.length) {
-            sections.push('### Code paths spotted (sample)');
-            for (const p of codeSamples) {
-                const file = r.files.find((f) => f.repoRelativePath === p);
-                if (!file)
-                    continue;
-                sections.push(`- ${file.bundleNormRelativePath}. ${evidence(file.bundleNormRelativePath, 1, 1)}`);
+    // Load FACTS.json if available
+    const factsPath = path.join(params.bundleRootDir, 'analysis', 'FACTS.json');
+    const facts = await readFacts(factsPath);
+    const sections = [];
+    // Header
+    sections.push(`# ${params.repos[0]?.repoId || 'Project'} - Overview\r\n`);
+    // Phase 3: What is this?
+    if (facts) {
+        sections.push('## What is this?\r\n');
+        // Try to get project purpose from README
+        const allFiles = params.repos.flatMap(r => r.files);
+        const purpose = await extractProjectPurpose(allFiles);
+        if (purpose) {
+            sections.push(`**Purpose**: ${purpose}\r\n`);
+        }
+        // Primary language and frameworks
+        if (facts.languages && facts.languages.length > 0) {
+            const primaryLang = facts.languages[0];
+            if (primaryLang) {
+                sections.push(`**Language**: ${primaryLang.language} (${primaryLang.fileCount} files)\r\n`);
+            }
+        }
+        if (facts.frameworks && facts.frameworks.length > 0) {
+            sections.push(`**Frameworks**: ${facts.frameworks.join(', ')}\r\n`);
+        }
+        // Tech stack (Phase 2)
+        if (facts.techStack) {
+            if (facts.techStack.runtime) {
+                sections.push(`**Runtime**: ${facts.techStack.runtime}\r\n`);
+            }
+            if (facts.techStack.packageManager) {
+                sections.push(`**Package Manager**: ${facts.techStack.packageManager}\r\n`);
             }
         }
         sections.push('');
     }
-    const libs = params.libraries ?? [];
-    if (libs.length) {
-        sections.push('## Context7 libraries');
-        for (const lib of libs) {
-            const facts = await renderContext7LibraryFacts(params.bundleRootDir, lib);
-            sections.push(`### ${lib.input}`);
-            if (facts.length) {
-                sections.push(...facts);
+    // Phase 3: Architecture
+    if (facts) {
+        sections.push('## Architecture\r\n');
+        // Entry points
+        if (facts.entryPoints && facts.entryPoints.length > 0) {
+            sections.push('### Entry Points\r\n');
+            for (const ep of facts.entryPoints.slice(0, 5)) {
+                const shortPath = ep.file.replace(/^repos\/[^\/]+\/[^\/]+\/norm\//, '');
+                sections.push(`- \`${shortPath}\` (${ep.type}). ${evidence(ep.evidence, 1, 1)}\r\n`);
             }
-            else {
-                sections.push('- No library facts available.');
+            sections.push('');
+        }
+        // Phase 2: Architecture patterns
+        if (facts.patterns && facts.patterns.length > 0) {
+            sections.push('### Design Patterns\r\n');
+            for (const pattern of facts.patterns) {
+                sections.push(`- ${pattern}\r\n`);
+            }
+            sections.push('');
+        }
+        // Phase 2: Core modules
+        const coreModuleLines = formatCoreModules(facts);
+        if (coreModuleLines.length > 0) {
+            sections.push('### Core Modules\r\n');
+            sections.push(...coreModuleLines.map(l => l + '\r\n'));
+            sections.push('');
+        }
+    }
+    // Dependencies
+    if (facts && (facts.dependencies.runtime.length > 0 || facts.dependencies.dev.length > 0)) {
+        sections.push('## Dependencies\r\n');
+        if (facts.dependencies.runtime.length > 0) {
+            sections.push(`### Production (${facts.dependencies.runtime.length})\r\n`);
+            for (const dep of facts.dependencies.runtime.slice(0, 15)) {
+                sections.push(`- ${dep.name}${dep.version ? ` ${dep.version}` : ''}\r\n`);
+            }
+            if (facts.dependencies.runtime.length > 15) {
+                sections.push(`- ... and ${facts.dependencies.runtime.length - 15} more\r\n`);
+            }
+            sections.push('');
+        }
+        if (facts.dependencies.dev.length > 0) {
+            sections.push(`### Development (${facts.dependencies.dev.length})\r\n`);
+            for (const dep of facts.dependencies.dev.slice(0, 10)) {
+                sections.push(`- ${dep.name}${dep.version ? ` ${dep.version}` : ''}\r\n`);
+            }
+            if (facts.dependencies.dev.length > 10) {
+                sections.push(`- ... and ${facts.dependencies.dev.length - 10} more\r\n`);
             }
             sections.push('');
         }
     }
+    // Phase 3: How to Reuse
+    if (facts) {
+        const standaloneLines = formatStandaloneModules(facts);
+        if (standaloneLines.length > 0) {
+            sections.push('## How to Reuse\r\n');
+            sections.push('### Standalone Modules\r\n');
+            sections.push('These modules can be extracted and used independently:\r\n\r\n');
+            sections.push(...standaloneLines.map(l => l + '\r\n'));
+            sections.push('');
+        }
+        // Return Phase 3 format directly
+        return sections.join('\n') + '\n';
+    }
+    // Fallback to legacy format if no FACTS
+    {
+        const header = `# OVERVIEW.md - Preflight Bundle ${params.bundleId}\r\n\r\nThis file is generated. It contains **only factual statements** with evidence pointers into bundle files.\r\n\r\n`;
+        sections.splice(0, sections.length); // Clear Phase 3 sections
+        sections.push(header);
+        for (const r of params.repos) {
+            sections.push(`## Repo: ${r.repoId}`);
+            const metaFacts = await renderRepoMetaFacts(params.bundleRootDir, r.repoId);
+            if (metaFacts.length) {
+                sections.push('### Snapshot facts');
+                sections.push(...metaFacts);
+            }
+            const nodeFacts = await renderNodePackageFacts(r.files);
+            if (nodeFacts.length) {
+                sections.push('### Node/JS facts');
+                sections.push(...nodeFacts);
+            }
+            const docs = getRepoDocFiles(r.files).slice(0, 50);
+            if (docs.length) {
+                sections.push('### Documentation files (first 50)');
+                for (const d of docs) {
+                    sections.push(`- ${d.bundleNormRelativePath}. ${evidence(d.bundleNormRelativePath, 1, 1)}`);
+                }
+            }
+            // Give a small hint about where code lives, without guessing entry points.
+            const codeSamples = r.files
+                .filter((f) => f.kind === 'code')
+                .map((f) => f.repoRelativePath)
+                .filter((p) => p.startsWith('src/') || p.startsWith('lib/'))
+                .slice(0, 10);
+            if (codeSamples.length) {
+                sections.push('### Code paths spotted (sample)');
+                for (const p of codeSamples) {
+                    const file = r.files.find((f) => f.repoRelativePath === p);
+                    if (!file)
+                        continue;
+                    sections.push(`- ${file.bundleNormRelativePath}. ${evidence(file.bundleNormRelativePath, 1, 1)}`);
+                }
+            }
+            sections.push('');
+        }
+        const libs = params.libraries ?? [];
+        if (libs.length) {
+            sections.push('## Context7 libraries');
+            for (const lib of libs) {
+                const facts = await renderContext7LibraryFacts(params.bundleRootDir, lib);
+                sections.push(`### ${lib.input}`);
+                if (facts.length) {
+                    sections.push(...facts);
+                }
+                else {
+                    sections.push('- No library facts available.');
+                }
+                sections.push('');
+            }
+        }
+    }
     return sections.join('\n') + '\n';
 }
 export async function writeOverviewFile(targetPath, markdown) {

package/dist/bundle/service.js

@@ -11,7 +11,6 @@ import { writeAgentsMd, writeStartHereMd } from './guides.js';
 import { generateOverviewMarkdown, writeOverviewFile } from './overview.js';
 import { rebuildIndex } from '../search/sqliteFts.js';
 import { ingestContext7Libraries } from './context7.js';
-import { ingestDeepWikiRepo } from './deepwiki.js';
 import { analyzeBundleStatic } from './analysis.js';
 import { autoDetectTags, generateDisplayName, generateDescription } from './tagging.js';
 import { bundleCreationLimiter } from '../core/concurrency-limiter.js';
@@ -26,48 +25,20 @@ function normalizeList(values) {
         .map((s) => s.toLowerCase())
         .sort();
 }
-function normalizeDeepWikiUrl(raw) {
-    const trimmed = raw.trim();
-    try {
-        const u = new URL(trimmed);
-        u.hash = '';
-        // Normalize host and strip trailing slash.
-        u.host = u.host.toLowerCase();
-        u.pathname = u.pathname.replace(/\/+$/g, '');
-        return u.toString();
-    }
-    catch {
-        return trimmed;
-    }
-}
 function canonicalizeCreateInput(input) {
     const repos = input.repos
         .map((r) => {
-        if (r.kind === 'github') {
-            const { owner, repo } = parseOwnerRepo(r.repo);
-            return {
-                kind: 'github',
-                repo: `${owner.toLowerCase()}/${repo.toLowerCase()}`,
-                ref: (r.ref ?? '').trim() || undefined,
-            };
-        }
-        if (r.kind === 'local') {
-            // For de-duplication, treat local imports as equivalent to github imports of the same logical repo/ref.
-            const { owner, repo } = parseOwnerRepo(r.repo);
-            return {
-                kind: 'github',
-                repo: `${owner.toLowerCase()}/${repo.toLowerCase()}`,
-                ref: (r.ref ?? '').trim() || undefined,
-            };
-        }
+        // For de-duplication, treat local imports as equivalent to github imports of the same logical repo/ref.
+        const { owner, repo } = parseOwnerRepo(r.repo);
         return {
-            kind: 'deepwiki',
-            url: normalizeDeepWikiUrl(r.url),
+            kind: 'github',
+            repo: `${owner.toLowerCase()}/${repo.toLowerCase()}`,
+            ref: (r.ref ?? '').trim() || undefined,
         };
     })
         .sort((a, b) => {
-        const ka = a.kind === 'github' ? `github:${a.repo}:${a.ref ?? ''}` : `deepwiki:${a.url}`;
-        const kb = b.kind === 'github' ? `github:${b.repo}:${b.ref ?? ''}` : `deepwiki:${b.url}`;
+        const ka = `github:${a.repo}:${a.ref ?? ''}`;
+        const kb = `github:${b.repo}:${b.ref ?? ''}`;
         return ka.localeCompare(kb);
     });
     return {
@@ -113,8 +84,8 @@ async function writeDedupIndex(storageDir, idx) {
         try {
             await fs.unlink(tmpPath);
         }
-        catch {
-            // Ignore cleanup errors
+        catch (cleanupErr) {
+            logger.debug('Failed to cleanup temp dedup index file (non-critical)', cleanupErr instanceof Error ? cleanupErr : undefined);
         }
         throw err;
     }
@@ -131,8 +102,8 @@ async function updateDedupIndexBestEffort(cfg, fingerprint, bundleId, bundleUpda
             idx.updatedAt = nowIso();
             await writeDedupIndex(storageDir, idx);
         }
-        catch {
-            // best-effort
+        catch (err) {
+            logger.debug(`Failed to update dedup index in ${storageDir} (best-effort)`, err instanceof Error ? err : undefined);
         }
     }
 }
@@ -798,7 +769,8 @@ async function createBundleInternal(cfg, input, options) {
                     notes: [...notes, ...skipped].slice(0, 50),
                 });
             }
-            else if (repoInput.kind === 'local') {
+            else {
+                // Local repository
                 const { owner, repo } = parseOwnerRepo(repoInput.repo);
                 const { files, skipped } = await ingestLocalRepo({
                     cfg,
@@ -812,21 +784,6 @@ async function createBundleInternal(cfg, input, options) {
                 allIngestedFiles.push(...files);
                 reposSummary.push({ kind: 'local', id: `${owner}/${repo}`, source: 'local', notes: skipped.slice(0, 50) });
             }
-            else {
-                // DeepWiki integration: fetch and convert to Markdown.
-                const deepwikiResult = await ingestDeepWikiRepo({
-                    cfg,
-                    bundlePaths: tmpPaths,
-                    url: repoInput.url,
-                });
-                allIngestedFiles.push(...deepwikiResult.files);
-                reposSummary.push({
-                    kind: 'deepwiki',
-                    id: deepwikiResult.summary.repoId,
-                    source: 'deepwiki',
-                    notes: deepwikiResult.summary.notes,
-                });
-            }
         }
         // Context7 libraries (best-effort).
         let librariesSummary;
@@ -901,7 +858,14 @@ async function createBundleInternal(cfg, input, options) {
             repos: reposSummary.map((r) => ({ id: r.id, headSha: r.headSha })),
             libraries: librariesSummary,
         });
-        // Overview (S2: factual-only with evidence pointers).
+        // Generate static facts (FACTS.json) FIRST. This is intentionally non-LLM and safe to keep inside bundles.
+        await generateFactsBestEffort({
+            bundleId,
+            bundleRoot: tmpPaths.rootDir,
+            files: allIngestedFiles,
+            mode: cfg.analysisMode,
+        });
+        // Overview (S2: factual-only with evidence pointers) - generated AFTER FACTS.json
         const perRepoOverviews = reposSummary
             .filter((r) => r.kind === 'github' || r.kind === 'local')
             .map((r) => {
@@ -916,13 +880,6 @@ async function createBundleInternal(cfg, input, options) {
             libraries: librariesSummary,
         });
         await writeOverviewFile(tmpPaths.overviewPath, overviewMd);
-        // Generate static facts (FACTS.json). This is intentionally non-LLM and safe to keep inside bundles.
-        await generateFactsBestEffort({
-            bundleId,
-            bundleRoot: tmpPaths.rootDir,
-            files: allIngestedFiles,
-            mode: cfg.analysisMode,
-        });
         // CRITICAL: Validate bundle completeness BEFORE atomic move
         const validation = await validateBundleCompleteness(tmpPaths.rootDir);
         if (!validation.isValid) {
@@ -978,8 +935,8 @@ async function createBundleInternal(cfg, input, options) {
     }
     finally {
         // Ensure temp directory is cleaned up (double safety)
-        await rmIfExists(tmpPaths.rootDir).catch(() => {
-            // Ignore cleanup errors
+        await rmIfExists(tmpPaths.rootDir).catch((err) => {
+            logger.debug('Failed to cleanup temp bundle directory in finally block (non-critical)', err instanceof Error ? err : undefined);
         });
     }
 }
@@ -1008,19 +965,14 @@ export async function checkForUpdates(cfg, bundleId) {
                 hasUpdates = true;
             details.push({ repoId, currentSha: prev?.headSha, remoteSha, changed });
         }
-        else if (repoInput.kind === 'local') {
+        else {
+            // Local: can't reliably detect whether local files changed without scanning; assume possible update.
             const { owner, repo } = parseOwnerRepo(repoInput.repo);
             const repoId = `${owner}/${repo}`;
-            // We can't reliably detect whether local files changed without scanning; assume possible update.
             const prev = manifest.repos.find((r) => r.id === repoId);
             details.push({ repoId, currentSha: prev?.headSha, changed: true });
             hasUpdates = true;
         }
-        else {
-            // DeepWiki: can't easily detect changes, assume possible update
-            details.push({ repoId: repoInput.url, changed: true });
-            hasUpdates = true;
-        }
     }
     return { hasUpdates, details };
 }
@@ -1122,41 +1074,6 @@ async function scanBundleIndexableFiles(params) {
             });
         }
     }
-    // 3) deepwiki/<owner>/<repo>/norm/** (docs-only)
-    const deepwikiDir = path.join(params.bundleRootDir, 'deepwiki');
-    const dwSt = await statOrNull(deepwikiDir);
-    if (dwSt?.isDirectory()) {
-        // Only walk the norm subtrees.
-        const owners = await fs.readdir(deepwikiDir, { withFileTypes: true });
-        for (const ownerEnt of owners) {
-            if (!ownerEnt.isDirectory())
-                continue;
-            const owner = ownerEnt.name;
-            const ownerDir = path.join(deepwikiDir, owner);
-            const repos = await fs.readdir(ownerDir, { withFileTypes: true });
-            for (const repoEnt of repos) {
-                if (!repoEnt.isDirectory())
-                    continue;
-                const repo = repoEnt.name;
-                const normDir = path.join(ownerDir, repo, 'norm');
-                const normSt = await statOrNull(normDir);
-                if (!normSt?.isDirectory())
-                    continue;
-                for await (const wf of walkFilesNoIgnore(normDir)) {
-                    if (!wf.relPosix.toLowerCase().endsWith('.md'))
-                        continue;
-                    const bundleRel = `deepwiki/${owner}/${repo}/norm/${wf.relPosix}`;
-                    await pushFile({
-                        repoId: `deepwiki:${owner}/${repo}`,
-                        kind: 'doc',
-                        repoRelativePath: wf.relPosix,
-                        bundleRelPosix: bundleRel,
-                        absPath: wf.absPath,
-                    });
-                }
-            }
-        }
-    }
     return { files, totalBytes, skipped };
 }
 export async function repairBundle(cfg, bundleId, options) {
@@ -1319,7 +1236,8 @@ export async function updateBundle(cfg, bundleId, options) {
             allIngestedFiles.push(...files);
             reposSummary.push({ kind: 'github', id: repoId, source, headSha, notes: [...notes, ...skipped].slice(0, 50) });
         }
-        else if (repoInput.kind === 'local') {
+        else {
+            // Local repository
             const { owner, repo } = parseOwnerRepo(repoInput.repo);
             const repoId = `${owner}/${repo}`;
             const { files, skipped } = await ingestLocalRepo({
@@ -1335,23 +1253,6 @@ export async function updateBundle(cfg, bundleId, options) {
             reposSummary.push({ kind: 'local', id: repoId, source: 'local', notes: skipped.slice(0, 50) });
             changed = true;
         }
-        else {
-            // DeepWiki integration: fetch and convert to Markdown.
-            const deepwikiResult = await ingestDeepWikiRepo({
-                cfg,
-                bundlePaths: paths,
-                url: repoInput.url,
-            });
-            allIngestedFiles.push(...deepwikiResult.files);
-            reposSummary.push({
-                kind: 'deepwiki',
-                id: deepwikiResult.summary.repoId,
-                source: 'deepwiki',
-                notes: deepwikiResult.summary.notes,
-            });
-            // Always mark as changed for DeepWiki since we can't easily detect content changes.
-            changed = true;
-        }
     }
     // Context7 libraries (best-effort).
     let librariesSummary;