@planu/cli 1.2.0 → 1.4.0

package/dist/engine/sweep-issue-generator.js

@@ -0,0 +1,140 @@
+// engine/sweep-issue-generator.ts — Pure functions for SPEC-379 Sweep AI Integration
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { parseFrontmatter } from './frontmatter-parser.js';
+import { extractSection, extractListItems } from './validator/extractors.js';
+const SPECS_DIR = 'planu/specs';
+/**
+ * Find the spec directory for a given specId inside projectPath/planu/specs.
+ * Returns null if not found.
+ */
+async function findSpecDir(specId, projectPath) {
+    const specsRoot = join(projectPath, SPECS_DIR);
+    let entries;
+    try {
+        entries = await readdir(specsRoot);
+    }
+    catch {
+        return null;
+    }
+    const prefix = specId.toUpperCase() + '-';
+    const dir = entries.find((e) => e.toUpperCase().startsWith(prefix));
+    if (!dir) {
+        return null;
+    }
+    return join(specsRoot, dir);
+}
+/**
+ * Read a list of affected files from technical.md.
+ * Returns empty array when technical.md is missing or has no list items.
+ */
+async function readAffectedFilesForSweep(specDir) {
+    const techPath = join(specDir, 'technical.md');
+    let raw;
+    try {
+        raw = await readFile(techPath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const section = extractSection(raw, 'affected files', 'archivos afectados');
+    return section ? extractListItems(section) : extractListItems(raw);
+}
+/**
+ * Build the GitHub issue body for Sweep AI.
+ */
+export function buildSweepIssueBody(specId, specSlug, title, description, criteria, affectedFiles) {
+    const criteriaLines = criteria.length > 0
+        ? criteria.map((c) => `- [ ] ${c}`).join('\n')
+        : '- [ ] See spec.md for acceptance criteria';
+    const filesSection = affectedFiles.length > 0
+        ? ['## Affected Files', '', ...affectedFiles.map((f) => `- \`${f}\``), ''].join('\n')
+        : '';
+    return [
+        `## Spec: ${title}`,
+        ``,
+        description || `Implementation of ${specId}.`,
+        ``,
+        `## Acceptance Criteria`,
+        criteriaLines,
+        ``,
+        filesSection,
+        `---`,
+        `Spec: ${specId} | [View in Planu](planu/specs/${specSlug}/spec.md)`,
+    ]
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+/**
+ * Generate and optionally create a GitHub issue for Sweep AI.
+ */
+export async function createSweepIssue(specId, projectPath, githubRepo, dryRun) {
+    const specDir = await findSpecDir(specId, projectPath);
+    if (!specDir) {
+        throw new Error(`Spec directory for ${specId} not found in ${join(projectPath, SPECS_DIR)}. ` +
+            `Ensure the spec exists and follows the SPEC-NNN-slug naming convention.`);
+    }
+    const specMdPath = join(specDir, 'spec.md');
+    let specContent;
+    try {
+        specContent = await readFile(specMdPath, 'utf-8');
+    }
+    catch {
+        throw new Error(`spec.md not found in ${specDir}.`);
+    }
+    const { metadata, body } = parseFrontmatter(specContent);
+    const title = typeof metadata.title === 'string' ? metadata.title : specId;
+    const description = typeof metadata.description === 'string' ? metadata.description : '';
+    const acSection = extractSection(body, 'acceptance criteria', 'criterios de aceptaci');
+    const criteria = acSection ? extractListItems(acSection) : [];
+    const affectedFiles = await readAffectedFilesForSweep(specDir);
+    // Extract the folder name (slug) from the specDir path for the footer link
+    const specSlug = specDir.split('/').pop() ?? specId;
+    const issueBody = buildSweepIssueBody(specId, specSlug, title, description, criteria, affectedFiles);
+    const issueTitle = `feat(${specId}): ${title}`;
+    if (dryRun) {
+        return { body: issueBody, dryRun: true, issueTitle };
+    }
+    // Create the actual GitHub issue using gh CLI
+    const escapedBody = issueBody.replace(/"/g, '\\"').replace(/`/g, '\\`');
+    const cmd = `gh issue create --repo "${githubRepo}" --title "${issueTitle}" --label sweep --body "${escapedBody}"`;
+    let issueUrl;
+    try {
+        issueUrl = execSync(cmd, { encoding: 'utf-8' }).trim();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to create GitHub issue: ${msg}. ` +
+            `Ensure gh is installed, authenticated, and the 'sweep' label exists on the repo.`, { cause: err });
+    }
+    return { issueUrl, body: issueBody, dryRun: false, issueTitle };
+}
+/**
+ * Check whether gh CLI is installed and if the sweep label exists on the repo.
+ */
+export function checkSweepStatus(githubRepo) {
+    try {
+        const out = execSync('which gh', { encoding: 'utf-8' }).trim();
+        if (out.length === 0) {
+            return { ghInstalled: false, sweepLabelExists: false, githubRepo };
+        }
+    }
+    catch {
+        return { ghInstalled: false, sweepLabelExists: false, githubRepo };
+    }
+    if (!githubRepo) {
+        return { ghInstalled: true, sweepLabelExists: false, githubRepo };
+    }
+    let sweepLabelExists;
+    try {
+        const labels = execSync(`gh label list --repo "${githubRepo}"`, { encoding: 'utf-8' });
+        sweepLabelExists = labels.toLowerCase().includes('sweep');
+    }
+    catch {
+        sweepLabelExists = false;
+    }
+    return { ghInstalled: true, sweepLabelExists, githubRepo };
+}
+//# sourceMappingURL=sweep-issue-generator.js.map

package/dist/engine/sweep-issue-generator.js.map

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

package/dist/engine/web-fetcher/docs-intelligence.d.ts

@@ -0,0 +1,8 @@
+import type { StructuredDocsResult } from '../../types/index.js';
+export declare function extractStructuredDocs(html: string, tech: string): StructuredDocsResult;
+export declare function buildFallbackResult(tech: string): StructuredDocsResult;
+export declare function fetchDocsBatch(techs: string[], options?: {
+    timeout?: number;
+    concurrency?: number;
+}): Promise<Map<string, StructuredDocsResult>>;
+//# sourceMappingURL=docs-intelligence.d.ts.map

package/dist/engine/web-fetcher/docs-intelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-intelligence.d.ts","sourceRoot":"","sources":["../../../src/engine/web-fetcher/docs-intelligence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA+DjE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAwCtF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAatE;AA4BD,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAwB5C"}

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"}