@planu/cli 1.3.0 → 1.5.0

package/dist/engine/web-fetcher/docs-intelligence.js

@@ -0,0 +1,154 @@
+// Planu — Web Fetcher: Universal Docs Intelligence Engine (SPEC-382)
+import { consultDocsImpl } from './docs-fetcher.js';
+const BEST_PRACTICE_PATTERNS = [
+    /\bbest practice[s]?\b/i,
+    /\brecommended?\b/i,
+    /\byou should\b/i,
+    /\balways\b.{0,40}\b(use|prefer|ensure|check)/i,
+    /\bprefer\b.{0,40}\bover\b/i,
+    /\buse\b.{0,20}\bfor\b.{0,40}/i,
+];
+const ANTI_PATTERN_PATTERNS = [
+    /\bavoid\b/i,
+    /\bdeprecated\b/i,
+    /\bdo not\b/i,
+    /\bnever\b/i,
+    /\bnot recommended\b/i,
+    /\bobsolete\b/i,
+];
+const CONVENTION_PATTERNS = [
+    /\bconvention\b/i,
+    /\bstyle\b.{0,20}\bguid/i,
+    /\bnaming\b/i,
+    /\bformat\b.{0,20}\bshould\b/i,
+    /\bfollow.{0,20}\bpattern\b/i,
+    /\bfile structure\b/i,
+];
+const VERSION_PATTERNS = [
+    /\bv?\d+(\.\d+){0,2}\b.{0,60}\b(migration|upgrade|breaking|changed)\b/i,
+    /\b(migration|upgrade|breaking change)\b.{0,60}\bv?\d+(\.\d+){0,2}\b/i,
+    /\bdeprecated in\b.{0,30}\bv?\d+/i,
+];
+const TOOL_NAME_PATTERNS = /\b(npm|pnpm|yarn|npx|pip|cargo|brew|apt|go get)\b.{0,80}/i;
+function splitIntoLines(text) {
+    return text
+        .split(/[\n.!?]/)
+        .map((l) => l.trim())
+        .filter((l) => l.length > 15 && l.length < 300);
+}
+function stripHtml(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, '')
+        .replace(/<style[\s\S]*?<\/style>/gi, '')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&[a-z]+;/gi, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function matchesAny(line, patterns) {
+    return patterns.some((p) => p.test(line));
+}
+function dedup(items) {
+    return [...new Set(items)];
+}
+export function extractStructuredDocs(html, tech) {
+    const text = stripHtml(html);
+    const lines = splitIntoLines(text);
+    const bestPractices = [];
+    const antiPatterns = [];
+    const conventions = [];
+    const versionNotes = [];
+    const toolingRecommendations = [];
+    for (const line of lines) {
+        if (matchesAny(line, ANTI_PATTERN_PATTERNS)) {
+            antiPatterns.push(line);
+        }
+        else if (matchesAny(line, BEST_PRACTICE_PATTERNS)) {
+            bestPractices.push(line);
+        }
+        else if (matchesAny(line, CONVENTION_PATTERNS)) {
+            conventions.push(line);
+        }
+        if (matchesAny(line, VERSION_PATTERNS)) {
+            versionNotes.push(line);
+        }
+        if (TOOL_NAME_PATTERNS.test(line)) {
+            toolingRecommendations.push(line);
+        }
+    }
+    return {
+        tech,
+        docsUrl: '',
+        bestPractices: dedup(bestPractices).slice(0, 10),
+        antiPatterns: dedup(antiPatterns).slice(0, 10),
+        conventions: dedup(conventions).slice(0, 10),
+        versionNotes: dedup(versionNotes).slice(0, 5),
+        toolingRecommendations: dedup(toolingRecommendations).slice(0, 5),
+        source: 'discovered',
+        fetchedAt: new Date().toISOString(),
+        stale: false,
+    };
+}
+export function buildFallbackResult(tech) {
+    return {
+        tech,
+        docsUrl: '',
+        bestPractices: [],
+        antiPatterns: [],
+        conventions: [],
+        versionNotes: [],
+        toolingRecommendations: [],
+        source: 'fallback',
+        fetchedAt: new Date().toISOString(),
+        stale: true,
+    };
+}
+async function fetchOneTech(tech, timeoutMs) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => {
+            controller.abort();
+        }, timeoutMs);
+        let result;
+        try {
+            const docsResult = await consultDocsImpl(tech, tech);
+            const html = [docsResult.summary, ...docsResult.bestPractices].join('\n');
+            result = extractStructuredDocs(html, tech);
+            result.docsUrl = docsResult.docsUrl;
+            result.source = docsResult.source === 'local-fallback' ? 'fallback' : 'registry';
+            result.stale = docsResult.stale ?? false;
+            result.fetchedAt = docsResult.fetchedAt ?? new Date().toISOString();
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        return result;
+    }
+    catch {
+        return buildFallbackResult(tech);
+    }
+}
+export async function fetchDocsBatch(techs, options) {
+    const timeoutMs = options?.timeout ?? 10_000;
+    const concurrency = options?.concurrency ?? 3;
+    const results = new Map();
+    for (let i = 0; i < techs.length; i += concurrency) {
+        const batch = techs.slice(i, i + concurrency);
+        const settled = await Promise.allSettled(batch.map((tech) => fetchOneTech(tech, timeoutMs)));
+        for (let j = 0; j < batch.length; j++) {
+            const tech = batch[j];
+            if (tech === undefined) {
+                continue;
+            }
+            const outcome = settled[j];
+            if (outcome === undefined || outcome.status === 'rejected') {
+                results.set(tech, buildFallbackResult(tech));
+            }
+            else {
+                results.set(tech, outcome.value);
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=docs-intelligence.js.map

package/dist/engine/web-fetcher/docs-intelligence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-intelligence.js","sourceRoot":"","sources":["../../../src/engine/web-fetcher/docs-intelligence.ts"],"names":[],"mappings":"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"}

package/dist/engine/web-fetcher/registry-auto-discovery.d.ts

@@ -0,0 +1,20 @@
+import type { DiscoveredDocsEntry, DocsRegistryHealth } from '../../types/index.js';
+/**
+ * Verify that a URL is alive with a HEAD request (timeout 3s).
+ * Returns true if status is 200, 301, or 302.
+ */
+export declare function validateRegistryUrl(url: string): Promise<boolean>;
+/**
+ * Discover docs URL for a tech package by querying npm, PyPI, and crates.io.
+ * Respects a 1 req/s rate limit per registry via simple delay.
+ * Returns null if not found anywhere.
+ */
+export declare function discoverDocsUrl(tech: string): Promise<DiscoveredDocsEntry | null>;
+/**
+ * Batch validate all entries in the docs registry.
+ * Categorizes each entry as healthy (<=2s), slow (2-5s), or broken (timeout/error).
+ */
+export declare function checkRegistryHealth(entries: Record<string, {
+    base: string;
+}>): Promise<DocsRegistryHealth>;
+//# sourceMappingURL=registry-auto-discovery.d.ts.map

package/dist/engine/web-fetcher/registry-auto-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-auto-discovery.d.ts","sourceRoot":"","sources":["../../../src/engine/web-fetcher/registry-auto-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAInB,MAAM,sBAAsB,CAAC;AAkH9B;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGvE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA6BvF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACxC,OAAO,CAAC,kBAAkB,CAAC,CAoC7B"}

package/dist/engine/web-fetcher/registry-auto-discovery.js

@@ -0,0 +1,184 @@
+// Planu — SPEC-386: Docs Registry Auto-Discovery
+// Discovers docs URLs from npm/pypi/crates.io package metadata
+const RATE_LIMIT_DELAY_MS = 1000;
+const VERIFY_TIMEOUT_MS = 3000;
+const HEALTH_TIMEOUT_MS = 5000;
+const SLOW_THRESHOLD_MS = 2000;
+/** Sleep for a given number of milliseconds. */
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/** Perform a HEAD request with a timeout, returning the HTTP status or null on failure. */
+async function headWithTimeout(url, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => {
+        controller.abort();
+    }, timeoutMs);
+    try {
+        const res = await fetch(url, { method: 'HEAD', signal: controller.signal, redirect: 'follow' });
+        return res.status;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Try to fetch JSON from a URL with a timeout. Returns null on any failure. */
+async function fetchJson(url, timeoutMs = HEALTH_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => {
+        controller.abort();
+    }, timeoutMs);
+    try {
+        const res = await fetch(url, { signal: controller.signal });
+        if (!res.ok) {
+            return null;
+        }
+        return (await res.json());
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Extract a clean HTTPS docs URL from npm package metadata. */
+function extractNpmDocsUrl(pkg) {
+    if (pkg.homepage?.startsWith('http')) {
+        return pkg.homepage;
+    }
+    if (pkg.docs?.startsWith('http')) {
+        return pkg.docs;
+    }
+    const repo = typeof pkg.repository === 'string' ? pkg.repository : pkg.repository?.url;
+    if (repo) {
+        const clean = repo
+            .replace(/^git\+/, '')
+            .replace(/\.git$/, '')
+            .replace(/^git:\/\//, 'https://');
+        if (clean.startsWith('https://')) {
+            return clean;
+        }
+    }
+    return null;
+}
+/** Try npm registry to find docs URL for a package. */
+async function tryNpm(tech) {
+    const pkg = await fetchJson(`https://registry.npmjs.org/${encodeURIComponent(tech)}`);
+    if (!pkg) {
+        return null;
+    }
+    return extractNpmDocsUrl(pkg);
+}
+/** Try PyPI registry to find docs URL for a package. */
+async function tryPypi(tech) {
+    const data = await fetchJson(`https://pypi.org/pypi/${encodeURIComponent(tech)}/json`);
+    if (!data?.info) {
+        return null;
+    }
+    const urls = data.info.project_urls ?? {};
+    const docsUrl = urls.Documentation ?? urls.documentation ?? urls.Docs ?? urls.Homepage ?? data.info.home_page;
+    if (docsUrl?.startsWith('http')) {
+        return docsUrl;
+    }
+    return null;
+}
+/** Try crates.io registry to find docs URL for a crate. */
+async function tryCrates(tech) {
+    const data = await fetchJson(`https://crates.io/api/v1/crates/${encodeURIComponent(tech)}`);
+    if (!data?.crate) {
+        return null;
+    }
+    const url = data.crate.documentation ?? data.crate.homepage;
+    if (url?.startsWith('http')) {
+        return url;
+    }
+    return null;
+}
+/**
+ * Verify that a URL is alive with a HEAD request (timeout 3s).
+ * Returns true if status is 200, 301, or 302.
+ */
+export async function validateRegistryUrl(url) {
+    const status = await headWithTimeout(url, VERIFY_TIMEOUT_MS);
+    return status !== null && (status === 200 || status === 301 || status === 302);
+}
+/**
+ * Discover docs URL for a tech package by querying npm, PyPI, and crates.io.
+ * Respects a 1 req/s rate limit per registry via simple delay.
+ * Returns null if not found anywhere.
+ */
+export async function discoverDocsUrl(tech) {
+    const tryWithDelay = async (fn) => {
+        const result = await fn();
+        await sleep(RATE_LIMIT_DELAY_MS);
+        return result;
+    };
+    const registries = [
+        { source: 'npm', fn: () => tryNpm(tech) },
+        { source: 'pypi', fn: () => tryPypi(tech) },
+        { source: 'crates', fn: () => tryCrates(tech) },
+    ];
+    for (const { source, fn } of registries) {
+        const url = await tryWithDelay(fn);
+        if (url) {
+            const verified = await validateRegistryUrl(url);
+            return {
+                tech,
+                docsUrl: url,
+                source,
+                discoveredAt: new Date().toISOString(),
+                verified,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Batch validate all entries in the docs registry.
+ * Categorizes each entry as healthy (<=2s), slow (2-5s), or broken (timeout/error).
+ */
+export async function checkRegistryHealth(entries) {
+    const healthy = [];
+    const broken = [];
+    const slow = [];
+    const checks = Object.entries(entries).map(async ([key, entry]) => {
+        const start = Date.now();
+        const controller = new AbortController();
+        const timer = setTimeout(() => {
+            controller.abort();
+        }, HEALTH_TIMEOUT_MS);
+        try {
+            const res = await fetch(entry.base, {
+                method: 'HEAD',
+                signal: controller.signal,
+                redirect: 'follow',
+            });
+            const elapsed = Date.now() - start;
+            const ok = res.status === 200 || res.status === 301 || res.status === 302;
+            if (!ok) {
+                broken.push(key);
+            }
+            else if (elapsed > SLOW_THRESHOLD_MS) {
+                slow.push(key);
+            }
+            else {
+                healthy.push(key);
+            }
+        }
+        catch {
+            broken.push(key);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    });
+    await Promise.all(checks);
+    return { healthy, broken, slow };
+}
+//# sourceMappingURL=registry-auto-discovery.js.map

package/dist/engine/web-fetcher/registry-auto-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-auto-discovery.js","sourceRoot":"","sources":["../../../src/engine/web-fetcher/registry-auto-discovery.ts"],"names":[],"mappings":"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"}

package/dist/engine/web-fetcher/stack-detector.d.ts

@@ -0,0 +1,4 @@
+import type { DetectedTech } from '../../types/index.js';
+export declare function detectTechsFromText(text: string): DetectedTech[];
+export declare function detectTechsFromFiles(fileList: string[]): DetectedTech[];
+//# sourceMappingURL=stack-detector.d.ts.map

package/dist/engine/web-fetcher/stack-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/web-fetcher/stack-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AA2EzD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAyChE;AAiCD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAgBvE"}

package/dist/engine/web-fetcher/stack-detector.js

@@ -0,0 +1,155 @@
+// Planu — Web Fetcher: Stack Detection from text and file paths (SPEC-382)
+// ~50 well-known technologies with their normalized names
+const KNOWN_TECHS = [
+    { pattern: /\bnext\.?js\b/i, normalized: 'next.js' },
+    { pattern: /\breact\b/i, normalized: 'react' },
+    { pattern: /\bvue\.?js\b|\bvuejs\b/i, normalized: 'vue' },
+    { pattern: /\bangular\b/i, normalized: 'angular' },
+    { pattern: /\bsvelte\b/i, normalized: 'svelte' },
+    { pattern: /\bastro\b/i, normalized: 'astro' },
+    { pattern: /\bremix\b/i, normalized: 'remix' },
+    { pattern: /\bsolid\.?js\b|\bsolidjs\b/i, normalized: 'solid.js' },
+    { pattern: /\bqwik\b/i, normalized: 'qwik' },
+    { pattern: /\bnuxt\b/i, normalized: 'nuxt' },
+    { pattern: /\bgatsbyjs\b|\bgatsby\b/i, normalized: 'gatsby' },
+    { pattern: /\bexpress\.?js\b|\bexpressjs\b/i, normalized: 'express' },
+    { pattern: /\bhono\b/i, normalized: 'hono' },
+    { pattern: /\bfastify\b/i, normalized: 'fastify' },
+    { pattern: /\bkoa\b/i, normalized: 'koa' },
+    { pattern: /\bnestjs\b|\bnest\.js\b/i, normalized: 'nestjs' },
+    { pattern: /\bdjango\b/i, normalized: 'django' },
+    { pattern: /\bflask\b/i, normalized: 'flask' },
+    { pattern: /\bfastapi\b/i, normalized: 'fastapi' },
+    { pattern: /\brails\b|\bruby on rails\b/i, normalized: 'rails' },
+    { pattern: /\blaravel\b/i, normalized: 'laravel' },
+    { pattern: /\bspring boot\b|\bspringboot\b/i, normalized: 'spring' },
+    { pattern: /\bgin\b.{0,10}\bgo\b|\bgo\b.{0,10}\bgin\b/i, normalized: 'gin' },
+    { pattern: /\bfiber\b.{0,10}\bgo\b|\bgo\b.{0,10}\bfiber\b/i, normalized: 'fiber' },
+    { pattern: /\btypescript\b/i, normalized: 'typescript' },
+    { pattern: /\bjavascript\b/i, normalized: 'javascript' },
+    { pattern: /\bpython\b/i, normalized: 'python' },
+    { pattern: /\bgolang\b|\bgo lang\b|\b(?:^|\s)go(?:\s|$)\b/i, normalized: 'go' },
+    { pattern: /\brust\b/i, normalized: 'rust' },
+    { pattern: /\bjava\b/i, normalized: 'java' },
+    { pattern: /\bkotlin\b/i, normalized: 'kotlin' },
+    { pattern: /\bswift\b/i, normalized: 'swift' },
+    { pattern: /\bflutter\b/i, normalized: 'flutter' },
+    { pattern: /\bexpo\b/i, normalized: 'expo' },
+    { pattern: /\breact native\b|\breact-native\b/i, normalized: 'react-native' },
+    { pattern: /\bpostgresql\b|\bpostgres\b/i, normalized: 'postgresql' },
+    { pattern: /\bmysql\b/i, normalized: 'mysql' },
+    { pattern: /\bmongodb\b|\bmongo\b/i, normalized: 'mongodb' },
+    { pattern: /\bsqlite\b/i, normalized: 'sqlite' },
+    { pattern: /\bsupabase\b/i, normalized: 'supabase' },
+    { pattern: /\bfirebase\b/i, normalized: 'firebase' },
+    { pattern: /\bprisma\b/i, normalized: 'prisma' },
+    { pattern: /\bdrizzle\b/i, normalized: 'drizzle' },
+    { pattern: /\btailwind\b/i, normalized: 'tailwind' },
+    { pattern: /\bvite\b/i, normalized: 'vite' },
+    { pattern: /\bvitest\b/i, normalized: 'vitest' },
+    { pattern: /\bjest\b/i, normalized: 'jest' },
+    { pattern: /\bdocker\b/i, normalized: 'docker' },
+    { pattern: /\bkubernetes\b|\bk8s\b/i, normalized: 'kubernetes' },
+    { pattern: /\bstripe\b/i, normalized: 'stripe' },
+    { pattern: /\bgraphql\b/i, normalized: 'graphql' },
+    { pattern: /\btrpc\b/i, normalized: 'trpc' },
+    { pattern: /\bzod\b/i, normalized: 'zod' },
+    { pattern: /\bprisma\b/i, normalized: 'prisma' },
+];
+// npm package pattern: word with hyphen or scoped (@scope/pkg)
+const NPM_PACKAGE_RE = /(?:^|\s)((?:@[\w-]+\/[\w-]+|[\w][\w-]{1,}))(?=\s|$)/g;
+function extractContext(text, match) {
+    const idx = match.index ?? 0;
+    const matchLen = match[0].length;
+    const start = Math.max(0, idx - 20);
+    const end = Math.min(text.length, idx + matchLen + 20);
+    return text.slice(start, end).trim();
+}
+function normalizeText(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+export function detectTechsFromText(text) {
+    const normalized = normalizeText(text);
+    const found = new Map();
+    for (const { pattern, normalized: techName } of KNOWN_TECHS) {
+        if (found.has(techName)) {
+            continue;
+        }
+        const match = normalized.match(pattern);
+        if (match) {
+            found.set(techName, {
+                name: techName,
+                confidence: 'high',
+                context: extractContext(normalized, match),
+            });
+        }
+    }
+    // Also detect npm package patterns with medium confidence (not already detected)
+    const npmMatches = [...normalized.matchAll(NPM_PACKAGE_RE)];
+    for (const match of npmMatches) {
+        const pkg = match[1];
+        if (!pkg) {
+            continue;
+        }
+        const pkgNorm = pkg.toLowerCase();
+        // Skip if already captured by known techs or too short
+        if (found.has(pkgNorm) || pkgNorm.length < 3) {
+            continue;
+        }
+        // Only include if it looks like a package (has hyphen or slash → scoped)
+        if (pkg.includes('-') || pkg.includes('/')) {
+            found.set(pkgNorm, {
+                name: pkgNorm,
+                confidence: 'low',
+                context: extractContext(normalized, match),
+            });
+        }
+    }
+    return [...found.values()];
+}
+const FILE_TECH_MAP = [
+    { pattern: /package\.json$/, name: 'node', confidence: 'high' },
+    { pattern: /next\.config\.[cm]?[jt]s$/, name: 'next.js', confidence: 'high' },
+    { pattern: /vite\.config\.[cm]?[jt]s$/, name: 'vite', confidence: 'high' },
+    { pattern: /vitest\.config\.[cm]?[jt]s$/, name: 'vitest', confidence: 'high' },
+    { pattern: /astro\.config\.[cm]?[jt]s$/, name: 'astro', confidence: 'high' },
+    { pattern: /remix\.config\.[cm]?[jt]s$/, name: 'remix', confidence: 'high' },
+    { pattern: /svelte\.config\.[cm]?[jt]s$/, name: 'svelte', confidence: 'high' },
+    { pattern: /nuxt\.config\.[cm]?[jt]s$/, name: 'nuxt', confidence: 'high' },
+    { pattern: /tailwind\.config\.[cm]?[jt]s$/, name: 'tailwind', confidence: 'high' },
+    { pattern: /prisma\/schema\.prisma$|\.prisma$/, name: 'prisma', confidence: 'high' },
+    { pattern: /drizzle\.config\.[cm]?[jt]s$/, name: 'drizzle', confidence: 'high' },
+    { pattern: /Dockerfile$|docker-compose\.ya?ml$/, name: 'docker', confidence: 'high' },
+    { pattern: /requirements\.txt$|setup\.py$|pyproject\.toml$/, name: 'python', confidence: 'high' },
+    { pattern: /go\.mod$|go\.sum$/, name: 'go', confidence: 'high' },
+    { pattern: /Cargo\.toml$|Cargo\.lock$/, name: 'rust', confidence: 'high' },
+    { pattern: /pom\.xml$|build\.gradle$/, name: 'java', confidence: 'high' },
+    { pattern: /tsconfig\.json$/, name: 'typescript', confidence: 'high' },
+    { pattern: /\.tsx?$/, name: 'typescript', confidence: 'medium' },
+    { pattern: /\.vue$/, name: 'vue', confidence: 'high' },
+    { pattern: /\.svelte$/, name: 'svelte', confidence: 'high' },
+    { pattern: /\.tsx$/, name: 'react', confidence: 'medium' },
+    { pattern: /\.jsx$/, name: 'react', confidence: 'medium' },
+    { pattern: /\.py$/, name: 'python', confidence: 'medium' },
+    { pattern: /\.go$/, name: 'go', confidence: 'medium' },
+    { pattern: /\.rs$/, name: 'rust', confidence: 'medium' },
+    { pattern: /\.kt$/, name: 'kotlin', confidence: 'medium' },
+    { pattern: /\.swift$/, name: 'swift', confidence: 'medium' },
+    { pattern: /\.dart$/, name: 'flutter', confidence: 'medium' },
+];
+export function detectTechsFromFiles(fileList) {
+    const found = new Map();
+    for (const filePath of fileList) {
+        for (const { pattern, name, confidence } of FILE_TECH_MAP) {
+            if (!found.has(name) && pattern.test(filePath)) {
+                found.set(name, {
+                    name,
+                    confidence,
+                    context: filePath,
+                });
+            }
+        }
+    }
+    return [...found.values()];
+}
+//# sourceMappingURL=stack-detector.js.map

package/dist/engine/web-fetcher/stack-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-detector.js","sourceRoot":"","sources":["../../../src/engine/web-fetcher/stack-detector.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 // index.ts — Planu SDD MCP Server entry point.
 // Creates the MCP server, registers tools & resources, and starts stdio transport.
+/* eslint-disable max-lines */
 // CLI detection — intercept known commands before MCP server setup (SPEC-124)
 const KNOWN_COMMANDS = [
     'init',
@@ -193,6 +194,15 @@ import { registerAiderTools } from './tools/register-aider-tools.js';
 import { registerSweepTools } from './tools/register-sweep-tools.js';
 import { registerPrAgentTools } from './tools/register-pr-agent-tools.js';
 import { registerE2eTestGeneratorTools } from './tools/register-e2e-test-generator-tools.js';
+import { registerDocsRegistryTools } from './tools/register-docs-registry-tools.js';
+import { registerDocComplianceTools } from './tools/register-doc-compliance-tools.js';
+import { registerDriftWatcherTools } from './tools/register-drift-watcher-tools.js';
+import { registerMultiRepoTools } from './tools/register-multi-repo-tools.js';
+import { registerComplianceTestTools } from './tools/register-compliance-test-tools.js';
+import { registerAutoPromoterTools } from './tools/register-auto-promoter-tools.js';
+import { registerCostGuardrailsTools } from './tools/register-cost-guardrails-tools.js';
+import { registerMcpGatewayTools } from './tools/register-mcp-gateway-tools.js';
+import { registerDogfoodTools } from './tools/register-dogfood-tools.js';
 // Server setup
 const SERVER_INSTRUCTIONS = [
     'CONTEXT — Why structured specs matter:',
@@ -459,6 +469,15 @@ function registerLatestSpecTools(s) {
     registerSweepTools(s);
     registerPrAgentTools(s);
     registerE2eTestGeneratorTools(s);
+    registerDocsRegistryTools(s);
+    registerDocComplianceTools(s);
+    registerDriftWatcherTools(s);
+    registerMultiRepoTools(s);
+    registerComplianceTestTools(s);
+    registerAutoPromoterTools(s);
+    registerCostGuardrailsTools(s);
+    registerMcpGatewayTools(s);
+    registerDogfoodTools(s);
 }
 function createMcpServer() {
     const s = withToolTracking(new McpServer({ name: 'planu', version: PLANU_VERSION }, { instructions: SERVER_INSTRUCTIONS }));