@planu/cli 1.3.0 → 1.4.0

package/dist/config/license-plans.json

@@ -409,7 +409,10 @@
     "review_pr_against_spec",
     "pr_agent_status",
     "generate_e2e_tests",
-    "e2e_test_status"
+    "e2e_test_status",
+    "validate_docs_registry",
+    "discover_docs_url",
+    "doc_compliance_report"
   ],
   "alwaysAllowed": [
     "activate_license",

package/dist/engine/doc-compliance-checker.d.ts

@@ -0,0 +1,23 @@
+import type { DocComplianceReport, DocComplianceIssue, StructuredDocsResult } from '../types/index.js';
+export type { DocComplianceReport, DocComplianceIssue };
+/**
+ * Checks if any anti-pattern from official docs appears in spec content.
+ * Returns a DocComplianceIssue for each match found.
+ */
+export declare function detectAntiPatterns(tech: string, docsResult: StructuredDocsResult, specContent: string): DocComplianceIssue[];
+/**
+ * Identifies best practices from official docs that are NOT covered in the spec.
+ * Returns a list of missing best practice descriptions.
+ */
+export declare function detectMissingBestPractices(tech: string, docsResult: StructuredDocsResult, specContent: string): DocComplianceIssue[];
+/**
+ * Calculates a compliance score 0-100 based on issues found.
+ * High severity issues cost more points.
+ */
+export declare function calculateComplianceScore(issues: DocComplianceIssue[], totalChecks: number): number;
+/**
+ * Main entry point: checks a spec file against official documentation.
+ * Reads the spec file, detects techs, fetches docs, and checks for issues.
+ */
+export declare function checkDocCompliance(specPath: string, specId: string): Promise<DocComplianceReport>;
+//# sourceMappingURL=doc-compliance-checker.d.ts.map

package/dist/engine/doc-compliance-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-compliance-checker.d.ts","sourceRoot":"","sources":["../../src/engine/doc-compliance-checker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAK3B,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;AAExD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,GAClB,kBAAkB,EAAE,CA0BtB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,GAClB,kBAAkB,EAAE,CA6BtB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,EAAE,EAC5B,WAAW,EAAE,MAAM,GAClB,MAAM,CAQR;AAYD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,CAwF9B"}

package/dist/engine/doc-compliance-checker.js

@@ -0,0 +1,168 @@
+// engine/doc-compliance-checker.ts — SPEC-385
+// Checks a spec against official documentation for anti-patterns and missing best practices.
+import { readFile } from 'node:fs/promises';
+import { detectTechsFromText } from './web-fetcher/stack-detector.js';
+import { fetchDocsBatch } from './web-fetcher/docs-intelligence.js';
+/**
+ * Checks if any anti-pattern from official docs appears in spec content.
+ * Returns a DocComplianceIssue for each match found.
+ */
+export function detectAntiPatterns(tech, docsResult, specContent) {
+    const issues = [];
+    const lower = specContent.toLowerCase();
+    for (const ap of docsResult.antiPatterns) {
+        // Extract key terms from the anti-pattern description (first 5 words)
+        const keyTerms = ap
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, ' ')
+            .split(/\s+/)
+            .filter((w) => w.length > 3)
+            .slice(0, 5);
+        const matchCount = keyTerms.filter((term) => lower.includes(term)).length;
+        if (matchCount >= 2) {
+            issues.push({
+                tech,
+                issueType: 'anti-pattern',
+                description: ap,
+                source: docsResult.docsUrl,
+                severity: 'high',
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Identifies best practices from official docs that are NOT covered in the spec.
+ * Returns a list of missing best practice descriptions.
+ */
+export function detectMissingBestPractices(tech, docsResult, specContent) {
+    const issues = [];
+    const lower = specContent.toLowerCase();
+    for (const bp of docsResult.bestPractices.slice(0, 5)) {
+        const keyTerms = bp
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, ' ')
+            .split(/\s+/)
+            .filter((w) => w.length > 3)
+            .slice(0, 5);
+        if (keyTerms.length === 0) {
+            continue;
+        }
+        const matchCount = keyTerms.filter((term) => lower.includes(term)).length;
+        // If fewer than 1/3 of key terms appear, best practice is likely missing
+        if (matchCount < Math.max(1, Math.ceil(keyTerms.length / 3))) {
+            issues.push({
+                tech,
+                issueType: 'missing-best-practice',
+                description: `Missing: ${bp}`,
+                source: docsResult.docsUrl,
+                severity: 'medium',
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Calculates a compliance score 0-100 based on issues found.
+ * High severity issues cost more points.
+ */
+export function calculateComplianceScore(issues, totalChecks) {
+    if (totalChecks === 0) {
+        return 100;
+    }
+    const penalty = issues.reduce((sum, issue) => {
+        return sum + (issue.severity === 'high' ? 15 : issue.severity === 'medium' ? 8 : 3);
+    }, 0);
+    return Math.max(0, Math.min(100, 100 - penalty));
+}
+/**
+ * Extracts spec title from frontmatter or first heading.
+ */
+function extractSpecTitle(specContent, fallback) {
+    const titleMatch = /^title:\s*"?([^"\n]+)"?/m.exec(specContent) ??
+        /^#\s+(?:SPEC-\d+[:\s]+)?(.+)/m.exec(specContent);
+    return titleMatch?.[1]?.trim() ?? fallback;
+}
+/**
+ * Main entry point: checks a spec file against official documentation.
+ * Reads the spec file, detects techs, fetches docs, and checks for issues.
+ */
+export async function checkDocCompliance(specPath, specId) {
+    // Read spec content
+    let specContent;
+    let specTitle;
+    try {
+        specContent = await readFile(specPath, 'utf-8');
+        specTitle = extractSpecTitle(specContent, specId);
+    }
+    catch {
+        // fallback to specId as search text
+        specContent = specId;
+        specTitle = specId;
+    }
+    // Detect technologies
+    const detected = detectTechsFromText(specContent);
+    const techs = detected
+        .filter((t) => t.confidence === 'high' || t.confidence === 'medium')
+        .map((t) => t.name)
+        .slice(0, 6);
+    if (techs.length === 0) {
+        return {
+            specId,
+            specTitle,
+            checkedAt: new Date().toISOString(),
+            techs: [],
+            issues: [],
+            bestPracticesCovered: [],
+            complianceScore: 100,
+            summary: 'No technologies detected in spec — skipping doc compliance check.',
+        };
+    }
+    // Fetch docs for detected techs
+    const docsMap = await fetchDocsBatch(techs, { timeout: 5_000, concurrency: 3 });
+    // Run checks
+    const allIssues = [];
+    const bestPracticesCovered = [];
+    let totalChecks = 0;
+    for (const [tech, docsResult] of docsMap) {
+        if (docsResult.source === 'fallback') {
+            continue;
+        }
+        const antiPatternIssues = detectAntiPatterns(tech, docsResult, specContent);
+        const missingBpIssues = detectMissingBestPractices(tech, docsResult, specContent);
+        allIssues.push(...antiPatternIssues);
+        allIssues.push(...missingBpIssues);
+        totalChecks += docsResult.antiPatterns.length + docsResult.bestPractices.slice(0, 5).length;
+        // Track covered best practices
+        const lower = specContent.toLowerCase();
+        for (const bp of docsResult.bestPractices.slice(0, 5)) {
+            const keyTerms = bp
+                .toLowerCase()
+                .replace(/[^a-z0-9\s]/g, ' ')
+                .split(/\s+/)
+                .filter((w) => w.length > 3)
+                .slice(0, 5);
+            const matchCount = keyTerms.filter((term) => lower.includes(term)).length;
+            if (matchCount >= Math.max(1, Math.ceil(keyTerms.length / 3))) {
+                bestPracticesCovered.push(`[${tech}] ${bp.slice(0, 80)}`);
+            }
+        }
+    }
+    const complianceScore = calculateComplianceScore(allIssues, totalChecks);
+    const highIssues = allIssues.filter((i) => i.severity === 'high').length;
+    const mediumIssues = allIssues.filter((i) => i.severity === 'medium').length;
+    const summary = allIssues.length === 0
+        ? `Spec is fully compliant with official docs for: ${techs.join(', ')}.`
+        : `Found ${highIssues} high + ${mediumIssues} medium issues against official docs for: ${techs.join(', ')}.`;
+    return {
+        specId,
+        specTitle,
+        checkedAt: new Date().toISOString(),
+        techs,
+        issues: allIssues,
+        bestPracticesCovered,
+        complianceScore,
+        summary,
+    };
+}
+//# sourceMappingURL=doc-compliance-checker.js.map

package/dist/engine/doc-compliance-checker.js.map

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

package/dist/engine/skill-generator/sections-docs.d.ts

@@ -0,0 +1,13 @@
+import type { StructuredDocsResult } from '../../types/index.js';
+/**
+ * Builds a "Official Documentation References" markdown section for a skill.
+ * Includes best practices, anti-patterns, and tooling from official docs.
+ * Returns empty string if no useful data (source is 'fallback').
+ */
+export declare function buildDocAwareSection(tech: string, docs: StructuredDocsResult): string;
+/**
+ * Builds doc-aware sections for multiple techs.
+ * Returns concatenated sections, skipping empty ones (fallback sources).
+ */
+export declare function buildDocAwareSections(docsMap: Map<string, StructuredDocsResult>): string;
+//# sourceMappingURL=sections-docs.d.ts.map

package/dist/engine/skill-generator/sections-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections-docs.d.ts","sourceRoot":"","sources":["../../../src/engine/skill-generator/sections-docs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAwCrF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,MAAM,CAexF"}

package/dist/engine/skill-generator/sections-docs.js

@@ -0,0 +1,59 @@
+// engine/skill-generator/sections-docs.ts — SPEC-384
+// Builds an official documentation section for generated skills.
+/**
+ * Builds a "Official Documentation References" markdown section for a skill.
+ * Includes best practices, anti-patterns, and tooling from official docs.
+ * Returns empty string if no useful data (source is 'fallback').
+ */
+export function buildDocAwareSection(tech, docs) {
+    if (docs.source === 'fallback') {
+        return '';
+    }
+    const lines = [`## ${tech} — Official Documentation`];
+    if (docs.docsUrl) {
+        lines.push(``, `> Source: ${docs.docsUrl}`);
+    }
+    if (docs.bestPractices.length > 0) {
+        lines.push('', '### Best Practices');
+        for (const bp of docs.bestPractices.slice(0, 5)) {
+            lines.push(`- ${bp}`);
+        }
+    }
+    if (docs.antiPatterns.length > 0) {
+        lines.push('', '### Anti-Patterns to Avoid');
+        for (const ap of docs.antiPatterns.slice(0, 3)) {
+            lines.push(`- ⚠️ ${ap}`);
+        }
+    }
+    if (docs.toolingRecommendations.length > 0) {
+        lines.push('', '### Recommended Tooling');
+        for (const tool of docs.toolingRecommendations.slice(0, 3)) {
+            lines.push(`- ${tool}`);
+        }
+    }
+    if (docs.versionNotes.length > 0) {
+        lines.push('', '### Version Notes');
+        for (const note of docs.versionNotes.slice(0, 2)) {
+            lines.push(`- ${note}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Builds doc-aware sections for multiple techs.
+ * Returns concatenated sections, skipping empty ones (fallback sources).
+ */
+export function buildDocAwareSections(docsMap) {
+    const sections = [];
+    for (const [tech, docs] of docsMap) {
+        const section = buildDocAwareSection(tech, docs);
+        if (section) {
+            sections.push(section);
+        }
+    }
+    if (sections.length === 0) {
+        return '';
+    }
+    return ['', '---', '', '## Official Documentation References', '', ...sections].join('\n');
+}
+//# sourceMappingURL=sections-docs.js.map

package/dist/engine/skill-generator/sections-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections-docs.js","sourceRoot":"","sources":["../../../src/engine/skill-generator/sections-docs.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,iEAAiE;AAIjE;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,IAA0B;IAC3E,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,MAAM,IAAI,2BAA2B,CAAC,CAAC;IAEhE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,oBAAoB,CAAC,CAAC;QACrC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,4BAA4B,CAAC,CAAC;QAC7C,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,yBAAyB,CAAC,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA0C;IAC9E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,sCAAsC,EAAE,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7F,CAAC"}

package/dist/engine/skill-generator/skills-content.d.ts

@@ -1,6 +1,6 @@
 import type { AgentPlatform, SkillFile, ProjectKnowledge, PlatformConfig } from '../../types/index.js';
 export declare function generateProjectRulesSkill(config: PlatformConfig, name: string, description: string, knowledge: ProjectKnowledge): SkillFile;
-export declare function generateDomainSkill(config: PlatformConfig, name: string, description: string, knowledge: ProjectKnowledge, specContent?: string): SkillFile;
+export declare function generateDomainSkill(config: PlatformConfig, name: string, description: string, knowledge: ProjectKnowledge, specContent?: string, docSection?: string): SkillFile;
 export declare function generateWorkflowSkill(config: PlatformConfig, name: string, description: string, knowledge: ProjectKnowledge): SkillFile;
 export declare function generateConventionSkill(config: PlatformConfig, name: string, description: string, knowledge: ProjectKnowledge): SkillFile;
 export declare function generateSddWorkflowSkillContent(knowledge: ProjectKnowledge): string;

package/dist/engine/skill-generator/skills-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-content.d.ts","sourceRoot":"","sources":["../../../src/engine/skill-generator/skills-content.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAC1B,SAAS,CA4BX;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,SAAS,CAuCX;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAC1B,SAAS,CAgCX;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAC1B,SAAS,CA0BX;AAED,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CA2BnF;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,SAAS,EAAE,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAkCR"}
+{"version":3,"file":"skills-content.d.ts","sourceRoot":"","sources":["../../../src/engine/skill-generator/skills-content.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAC1B,SAAS,CA4BX;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,WAAW,CAAC,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,GAClB,SAAS,CAwCX;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAC1B,SAAS,CAgCX;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAC1B,SAAS,CA0BX;AAED,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CA2BnF;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,SAAS,EAAE,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAkCR"}

package/dist/engine/skill-generator/skills-content.js

@@ -24,10 +24,10 @@ export function generateProjectRulesSkill(config, name, description, knowledge)
         : config.rulesFile;
     return { path, content, format: config.format };
 }
-export function generateDomainSkill(config, name, description, knowledge, specContent) {
+export function generateDomainSkill(config, name, description, knowledge, specContent, docSection) {
     const slug = name.toLowerCase().replace(/\s+/g, '-');
     const agentSlug = `${slug}-agent`;
-    const content = [
+    const baseContent = [
         `# ${name}`,
         '',
         description,
@@ -59,6 +59,7 @@ export function generateDomainSkill(config, name, description, knowledge, specCo
         `- **Orchestration**: See \`scripts/orchestrate-${slug}.sh\` (generated alongside this skill)`,
         '- The sub-agent handles subtask delegation; this skill manages commit, tracking, pipeline',
     ].join('\n');
+    const content = docSection ? `${baseContent}\n\n${docSection}` : baseContent;
     const path = config.skillsDir ? `${config.skillsDir}${slug}.md` : `skills/${slug}.md`;
     return { path, content, format: 'markdown' };
 }

package/dist/engine/skill-generator/skills-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills-content.js","sourceRoot":"","sources":["../../../src/engine/skill-generator/skills-content.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills-content.js","sourceRoot":"","sources":["../../../src/engine/skill-generator/skills-content.ts"],"names":[],"mappings":"AAAA,wDAAwD;AASxD,MAAM,UAAU,yBAAyB,CACvC,MAAsB,EACtB,IAAY,EACZ,WAAmB,EACnB,SAA2B;IAE3B,MAAM,OAAO,GAAG;QACd,KAAK,IAAI,EAAE;QACX,EAAE;QACF,WAAW;QACX,EAAE;QACF,UAAU;QACV,eAAe,SAAS,CAAC,QAAQ,EAAE;QACnC,gBAAgB,SAAS,CAAC,SAAS,IAAI,MAAM,EAAE;QAC/C,eAAe,SAAS,CAAC,QAAQ,EAAE;QACnC,mBAAmB,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE;QACnD,EAAE;QACF,UAAU;QACV,EAAE;QACF,GAAG,SAAS,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;QAClE,EAAE;QACF,WAAW;QACX,EAAE;QACF,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,cAAc,EAAE,CAC5E;KACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS;QAC3B,CAAC,CAAC,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK;QACpE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;IAErB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAsB,EACtB,IAAY,EACZ,WAAmB,EACnB,SAA2B,EAC3B,WAAoB,EACpB,UAAmB;IAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,GAAG,IAAI,QAAQ,CAAC;IAClC,MAAM,WAAW,GAAG;QAClB,KAAK,IAAI,EAAE;QACX,EAAE;QACF,WAAW;QACX,EAAE;QACF,YAAY;QACZ,yBAAyB,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,SAAS,IAAI,QAAQ,WAAW;QACzF,EAAE;QACF,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE;QACpC,WAAW,IAAI,EAAE;QACjB,EAAE;QACF,WAAW;QACX,EAAE;QACF,yFAAyF;QACzF,uFAAuF;QACvF,6EAA6E;QAC7E,uEAAuE;QACvE,6EAA6E;QAC7E,EAAE;QACF,eAAe;QACf,EAAE;QACF,6CAA6C;QAC7C,0CAA0C;QAC1C,6BAA6B;QAC7B,qCAAqC;QACrC,EAAE;QACF,uBAAuB;QACvB,EAAE;QACF,6EAA6E,SAAS,OAAO;QAC7F,kDAAkD,IAAI,wCAAwC;QAC9F,2FAA2F;KAC5F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,WAAW,OAAO,UAAU,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC;IAEtF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAsB,EACtB,IAAY,EACZ,WAAmB,EACnB,SAA2B;IAE3B,MAAM,OAAO,GAAG;QACd,KAAK,IAAI,EAAE;QACX,EAAE;QACF,WAAW;QACX,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,uDAAuD;QACvD,2DAA2D;QAC3D,yCAAyC;QACzC,2CAA2C;QAC3C,8CAA8C;QAC9C,0CAA0C;QAC1C,EAAE;QACF,aAAa;QACb,EAAE;QACF,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,SAAS,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,EAAE;QACtE,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,SAAS,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE;QACnE,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,mBAAmB,SAAS,CAAC,YAAY,IAAI;KAC9C;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS;QAC3B,CAAC,CAAC,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK;QACpE,CAAC,CAAC,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC;IAE3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,MAAsB,EACtB,IAAY,EACZ,WAAmB,EACnB,SAA2B;IAE3B,MAAM,OAAO,GAAG;QACd,KAAK,IAAI,EAAE;QACX,EAAE;QACF,WAAW;QACX,EAAE;QACF,gBAAgB;QAChB,EAAE;QACF,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5E,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,eAAe,SAAS,CAAC,cAAc,CAAC,UAAU,EAAE;QACpD,EAAE;QACF,GAAG,SAAS,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,EAAE;QACF,uBAAuB;QACvB,EAAE;QACF,GAAG,SAAS,CAAC,cAAc,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;KACnE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS;QAC3B,CAAC,CAAC,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK;QACpE,CAAC,CAAC,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC;IAE3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,SAA2B;IACzE,OAAO;QACL,sBAAsB;QACtB,EAAE;QACF,+DAA+D;QAC/D,EAAE;QACF,gBAAgB;QAChB,EAAE;QACF,6EAA6E;QAC7E,EAAE;QACF,UAAU;QACV,EAAE;QACF,kEAAkE;QAClE,gEAAgE;QAChE,sEAAsE;QACtE,uFAAuF;QACvF,4DAA4D;QAC5D,gEAAgE;QAChE,4DAA4D;QAC5D,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,eAAe,SAAS,CAAC,QAAQ,EAAE;QACnC,gBAAgB,SAAS,CAAC,SAAS,IAAI,MAAM,EAAE;QAC/C,mBAAmB,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE;QACnD,YAAY,SAAS,CAAC,YAAY,EAAE;KACrC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAAuB,EACvB,MAAsB,EACtB,KAAkB,EAClB,SAAkB;IAElB,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,YAAY,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IACpD,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,YAAY,CAAC,IAAI,CAAC,sCAAsC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC/B,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;IAC9F,CAAC;SAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;IAC1F,CAAC;SAAM,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;QACjC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAChD,YAAY,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;QAC7F,YAAY,CAAC,IAAI,CACf,kFAAkF,CACnF,CAAC;QACF,YAAY,CAAC,IAAI,CACf,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/engine/skill-generator/skills.d.ts

@@ -1,3 +1,4 @@
 export { generateProjectRulesSkill, generateDomainSkill, generateWorkflowSkill, generateConventionSkill, generateSddWorkflowSkillContent, buildInstallInstructions, } from './skills-content.js';
 export { generateOrchestrationScript } from './skills-orchestration.js';
+export { buildDocAwareSection, buildDocAwareSections } from './sections-docs.js';
 //# sourceMappingURL=skills.d.ts.map

package/dist/engine/skill-generator/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/engine/skill-generator/skills.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/engine/skill-generator/skills.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/engine/skill-generator/skills.js

@@ -2,4 +2,5 @@
 // Split for file-size compliance (400L limit).
 export { generateProjectRulesSkill, generateDomainSkill, generateWorkflowSkill, generateConventionSkill, generateSddWorkflowSkillContent, buildInstallInstructions, } from './skills-content.js';
 export { generateOrchestrationScript } from './skills-orchestration.js';
+export { buildDocAwareSection, buildDocAwareSections } from './sections-docs.js';
 //# sourceMappingURL=skills.js.map

package/dist/engine/skill-generator/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/engine/skill-generator/skills.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,+CAA+C;AAE/C,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/engine/skill-generator/skills.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,+CAA+C;AAE/C,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/engine/skill-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-generator.d.ts","sourceRoot":"","sources":["../../src/engine/skill-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EAEnB,gBAAgB,EAChB,YAAY,EAEZ,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAyB3B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAI1E;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,eAAe,GAAG,cAAc,GAAG,UAAU,GAAG,YAAY,EACvE,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAwC9B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,gBAAgB,EAC3B,YAAY,CAAC,EAAE,YAAY,EAC3B,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC,GACL,OAAO,CAAC,mBAAmB,CAAC,CAgH9B"}
+{"version":3,"file":"skill-generator.d.ts","sourceRoot":"","sources":["../../src/engine/skill-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EAEnB,gBAAgB,EAChB,YAAY,EAEZ,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAyB3B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAI1E;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,eAAe,GAAG,cAAc,GAAG,UAAU,GAAG,YAAY,EACvE,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAmE9B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,gBAAgB,EAC3B,YAAY,CAAC,EAAE,YAAY,EAC3B,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC,GACL,OAAO,CAAC,mBAAmB,CAAC,CAgH9B"}

package/dist/engine/skill-generator.js

@@ -29,11 +29,30 @@ export async function generateSkill(platform, skillType, name, description, know
         case 'project-rules':
             files.push(generateProjectRulesSkill(config, name, description, knowledge));
             break;
-        case 'domain-skill':
-            files.push(generateDomainSkill(config, name, description, knowledge, specContent));
+        case 'domain-skill': {
+            let docSection = '';
+            try {
+                const { detectTechsFromText } = await import('./web-fetcher/stack-detector.js');
+                const { fetchDocsBatch } = await import('./web-fetcher/docs-intelligence.js');
+                const { buildDocAwareSections } = await import('./skill-generator/sections-docs.js');
+                const detected = detectTechsFromText(`${name} ${description}`);
+                const techNames = detected
+                    .filter((t) => t.confidence === 'high' || t.confidence === 'medium')
+                    .map((t) => t.name)
+                    .slice(0, 4);
+                if (techNames.length > 0) {
+                    const docsMap = await fetchDocsBatch(techNames, { timeout: 3_000, concurrency: 2 });
+                    docSection = buildDocAwareSections(docsMap);
+                }
+            }
+            catch {
+                // Silent fallback — doc enrichment is best-effort
+            }
+            files.push(generateDomainSkill(config, name, description, knowledge, specContent, docSection || undefined));
             // 3-layer automation: include orchestration script for implementation skills
             files.push(_generateOrchestrationScript(name, knowledge));
             break;
+        }
         case 'workflow':
             files.push(generateWorkflowSkill(config, name, description, knowledge));
             break;

package/dist/engine/skill-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-generator.js","sourceRoot":"","sources":["../../src/engine/skill-generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-generator.js","sourceRoot":"","sources":["../../src/engine/skill-generator.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,4EAA4E;AAa5E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,+BAA+B,IAAI,gCAAgC,EACnE,6BAA6B,GAC9B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,+BAA+B,EAC/B,wBAAwB,EACxB,2BAA2B,IAAI,4BAA4B,GAC5D,MAAM,6BAA6B,CAAC;AAErC,8DAA8D;AAC9D,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE1E,qBAAqB;AAErB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAuB,EACvB,SAAuE,EACvE,IAAY,EACZ,WAAmB,EACnB,SAA2B,EAC3B,WAAoB;IAEpB,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,QAAQ;YACR,KAAK,EAAE,EAAE;YACT,mBAAmB,EAAE,aAAa,QAAQ,yBAAyB;YACnE,OAAO,EAAE,qBAAqB,QAAQ,EAAE;SACzC,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,eAAe;YAClB,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;YAC5E,MAAM;QACR,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,IAAI,UAAU,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;gBAChF,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;gBAC9E,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;gBACrF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;gBAC/D,MAAM,SAAS,GAAG,QAAQ;qBACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,IAAI,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC;qBACnE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;qBAClB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACf,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;oBACpF,UAAU,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,kDAAkD;YACpD,CAAC;YACD,KAAK,CAAC,IAAI,CACR,mBAAmB,CACjB,MAAM,EACN,IAAI,EACJ,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,IAAI,SAAS,CACxB,CACF,CAAC;YACF,6EAA6E;YAC7E,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;YAC1D,MAAM;QACR,CAAC;QACD,KAAK,UAAU;YACb,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;YACxE,MAAM;QACR,KAAK,YAAY;YACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;YAC1E,MAAM;IACV,CAAC;IAED,MAAM,mBAAmB,GAAG,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAEzF,OAAO;QACL,QAAQ;QACR,KAAK;QACL,mBAAmB;QACnB,OAAO,EAAE,aAAa,SAAS,WAAW,IAAI,SAAS,MAAM,CAAC,IAAI,GAAG;KACtE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAuB,EACvB,SAA2B,EAC3B,YAA2B,EAC3B,UAOI,EAAE;IAEN,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,QAAQ;YACR,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,MAAM,EAAE,UAAU,EAAE;YAC9E,eAAe,EAAE,EAAE;YACnB,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,EAAE;YACd,iBAAiB,EAAE,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,MAAM,EACJ,mBAAmB,GAAG,IAAI,EAC1B,kBAAkB,GAAG,IAAI,EACzB,cAAc,GAAG,IAAI,EACrB,eAAe,GAAG,IAAI,EACtB,WAAW,GAAG,EAAE,EAChB,iBAAiB,GAAG,EAAE,GACvB,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,mBAAmB;IACnB,QAAQ,CAAC,IAAI,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC,CAAC;IACtD,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE3B,qBAAqB;IACrB,IAAI,mBAAmB,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,CAAC;QACnD,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAED,cAAc;IACd,IAAI,kBAAkB,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC;QAClD,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,gBAAgB;IAChB,IAAI,cAAc,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9C,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,iBAAiB;IACjB,IAAI,eAAe,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/C,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,0BAA0B;IAC1B,IAAI,YAAY,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC,CAAC;QACtD,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAED,oEAAoE;IACpE,MAAM,cAAc,GAAG,gCAAgC,CAAC,QAAQ,CAAC,CAAC;IAClE,IAAI,cAAc,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9B,UAAU,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,mDAAmD;IACnD,MAAM,aAAa,GAAG,6BAA6B,CAAC,iBAAiB,CAAC,CAAC;IACvE,IAAI,aAAa,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7B,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IAED,eAAe;IACf,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,cAAc;YACrB,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,QAAiB,EAAE,CAAC,CAAC;SAC7E,CAAC,CAAC;QACH,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,YAAY,GAAG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAExE,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,MAAM,CAAC,SAAS;QACtB,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;IAEF,MAAM,eAAe,GAAgB,EAAE,CAAC;IAExC,qEAAqE;IACrE,IAAI,QAAQ,KAAK,aAAa,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACnD,eAAe,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,GAAG,MAAM,CAAC,SAAS,iBAAiB;YAC1C,OAAO,EAAE,+BAA+B,CAAC,SAAS,CAAC;YACnD,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ;QACR,SAAS;QACT,eAAe;QACf,UAAU;QACV,UAAU;QACV,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

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