@planu/cli 1.2.0 → 1.4.0

package/dist/engine/memory-config-generator.js

@@ -0,0 +1,101 @@
+// Planu — Memory config generator engine (SPEC-375)
+// Generates .claude.json MCP entries for mem0/OpenMemory
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+async function readClaudeJson(configPath) {
+    try {
+        const content = await readFile(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+async function writeClaudeJson(configPath, config) {
+    await writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+export function resolveClaudeJsonPath(projectPath) {
+    return join(projectPath, '.claude.json');
+}
+export function detectMemoryProvider(config) {
+    const servers = config.mcpServers;
+    if (servers === undefined) {
+        return 'none';
+    }
+    const memoryServer = servers.memory;
+    if (memoryServer === undefined) {
+        return 'none';
+    }
+    const args = memoryServer.args;
+    if (!args.includes('@mem0/mcp')) {
+        return 'openmemory';
+    }
+    const apiKey = memoryServer.env?.MEM0_API_KEY;
+    if (apiKey !== undefined && apiKey !== '') {
+        return 'mem0-cloud';
+    }
+    return 'openmemory';
+}
+export async function getMemoryStatus(projectPath) {
+    const configPath = resolveClaudeJsonPath(projectPath);
+    const config = await readClaudeJson(configPath);
+    const provider = detectMemoryProvider(config);
+    return {
+        provider,
+        connected: false,
+        memoryCount: 0,
+        configPath,
+    };
+}
+export async function setupOpenMemory(projectPath) {
+    const configPath = resolveClaudeJsonPath(projectPath);
+    const config = await readClaudeJson(configPath);
+    const memoryServer = {
+        command: 'npx',
+        args: ['-y', '@mem0/mcp'],
+    };
+    const updated = {
+        ...config,
+        mcpServers: {
+            ...(config.mcpServers ?? {}),
+            memory: memoryServer,
+        },
+    };
+    await writeClaudeJson(configPath, updated);
+    return configPath;
+}
+export async function setupMem0Cloud(projectPath, apiKey) {
+    const configPath = resolveClaudeJsonPath(projectPath);
+    const config = await readClaudeJson(configPath);
+    const memoryServer = {
+        command: 'npx',
+        args: ['-y', '@mem0/mcp'],
+        env: { MEM0_API_KEY: apiKey },
+    };
+    const updated = {
+        ...config,
+        mcpServers: {
+            ...(config.mcpServers ?? {}),
+            memory: memoryServer,
+        },
+    };
+    await writeClaudeJson(configPath, updated);
+    return configPath;
+}
+export async function resetMemoryConfig(projectPath) {
+    const configPath = resolveClaudeJsonPath(projectPath);
+    const config = await readClaudeJson(configPath);
+    if (config.mcpServers?.memory === undefined) {
+        return configPath;
+    }
+    const { memory: _removed, ...remainingServers } = config.mcpServers;
+    /* v8 ignore next */
+    void _removed;
+    const updated = {
+        ...config,
+        mcpServers: remainingServers,
+    };
+    await writeClaudeJson(configPath, updated);
+    return configPath;
+}
+//# sourceMappingURL=memory-config-generator.js.map

package/dist/engine/memory-config-generator.js.map

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

package/dist/engine/pr-spec-validator.d.ts

@@ -0,0 +1,25 @@
+import type { CriterionComplianceResult, CriterionStatus, ReviewPrAgainstSpecResult, PrAgentStatusResult } from '../types/index.js';
+/** Extract acceptance criteria from spec.md content (checkbox lines). */
+export declare function extractAcceptanceCriteria(specContent: string): string[];
+/** Resolve spec directory from specId and projectPath. */
+export declare function resolveSpecDir(specId: string, projectPath: string): Promise<string | null>;
+/** Read spec.md content for a given specId. */
+export declare function readSpecContent(specId: string, projectPath: string): Promise<string | null>;
+/** Run `gh pr diff` and return the diff text, or null on failure. */
+export declare function fetchPrDiff(prNumber: number, githubRepo: string): string | null;
+/** Check if a criterion is matched in the diff. */
+export declare function checkCriterion(criterion: string, diff: string): CriterionStatus;
+/** Build compliance results from criteria and diff. */
+export declare function buildComplianceResults(criteria: string[], diff: string): CriterionComplianceResult[];
+/** Calculate compliance score (0-100, rounded integer). */
+export declare function calcComplianceScore(results: CriterionComplianceResult[]): number;
+/** Build the human-readable summary string. */
+export declare function buildSummary(score: number, results: CriterionComplianceResult[], specId: string, prNumber: number): string;
+/** Run the full PR compliance check. */
+export declare function reviewPrAgainstSpec(specId: string, projectPath: string, prNumber: number, githubRepo: string): Promise<ReviewPrAgainstSpecResult | {
+    isError: true;
+    message: string;
+}>;
+/** Check gh CLI installation and PR agent configuration. */
+export declare function checkPrAgentStatus(projectPath: string): PrAgentStatusResult;
+//# sourceMappingURL=pr-spec-validator.d.ts.map

package/dist/engine/pr-spec-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-spec-validator.d.ts","sourceRoot":"","sources":["../../src/engine/pr-spec-validator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,yEAAyE;AACzE,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvE;AAED,0DAA0D;AAC1D,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYhG;AAED,+CAA+C;AAC/C,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUjG;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS/E;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAgB/E;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,EAAE,MAAM,GACX,yBAAyB,EAAE,CAK7B;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,yBAAyB,EAAE,GAAG,MAAM,CAMhF;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,yBAAyB,EAAE,EACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAgBR;AAED,wCAAwC;AACxC,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBzE;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAwC3E"}

package/dist/engine/pr-spec-validator.js

@@ -0,0 +1,172 @@
+// Planu — PR Spec Validator (SPEC-380)
+// Pure functions for validating PR diffs against spec acceptance criteria.
+import { readFile } from 'node:fs/promises';
+import { execSync } from 'node:child_process';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Extract acceptance criteria from spec.md content (checkbox lines). */
+export function extractAcceptanceCriteria(specContent) {
+    const lines = specContent.split('\n');
+    const criteria = [];
+    for (const line of lines) {
+        const match = /^\s*-\s*\[[ xX]?\]\s+(.+)$/.exec(line);
+        if (match?.[1]) {
+            criteria.push(match[1].trim());
+        }
+    }
+    return criteria;
+}
+/** Resolve spec directory from specId and projectPath. */
+export async function resolveSpecDir(specId, projectPath) {
+    const { readdir } = await import('node:fs/promises');
+    const specsBase = join(projectPath, 'planu', 'specs');
+    let entries;
+    try {
+        entries = await readdir(specsBase);
+    }
+    catch {
+        return null;
+    }
+    const upper = specId.toUpperCase();
+    const match = entries.find((e) => e.toUpperCase().startsWith(upper));
+    return match ? join(specsBase, match) : null;
+}
+/** Read spec.md content for a given specId. */
+export async function readSpecContent(specId, projectPath) {
+    const specDir = await resolveSpecDir(specId, projectPath);
+    if (!specDir) {
+        return null;
+    }
+    try {
+        return await readFile(join(specDir, 'spec.md'), 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Run `gh pr diff` and return the diff text, or null on failure. */
+export function fetchPrDiff(prNumber, githubRepo) {
+    try {
+        return execSync(`gh pr diff ${prNumber} --repo ${githubRepo}`, {
+            encoding: 'utf8',
+            timeout: 30000,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/** Check if a criterion is matched in the diff. */
+export function checkCriterion(criterion, diff) {
+    if (!diff.trim()) {
+        return 'unknown';
+    }
+    const words = criterion
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length > 3);
+    if (words.length === 0) {
+        return 'unknown';
+    }
+    const diffLower = diff.toLowerCase();
+    const anyMatch = words.some((w) => diffLower.includes(w));
+    return anyMatch ? 'matched' : 'unmatched';
+}
+/** Build compliance results from criteria and diff. */
+export function buildComplianceResults(criteria, diff) {
+    return criteria.map((criterion) => ({
+        criterion,
+        status: checkCriterion(criterion, diff),
+    }));
+}
+/** Calculate compliance score (0-100, rounded integer). */
+export function calcComplianceScore(results) {
+    if (results.length === 0) {
+        return 0;
+    }
+    const matched = results.filter((r) => r.status === 'matched').length;
+    return Math.round((matched / results.length) * 100);
+}
+/** Build the human-readable summary string. */
+export function buildSummary(score, results, specId, prNumber) {
+    const matched = results.filter((r) => r.status === 'matched').length;
+    const unmatched = results.filter((r) => r.status === 'unmatched').length;
+    const unknown = results.filter((r) => r.status === 'unknown').length;
+    const parts = [
+        `PR #${prNumber} vs ${specId}: ${score}% compliance`,
+        `${matched} matched, ${unmatched} unmatched, ${unknown} unknown out of ${results.length} criteria`,
+    ];
+    if (score === 100) {
+        parts.push('All acceptance criteria appear to be addressed in the diff.');
+    }
+    else if (score >= 70) {
+        parts.push('Most criteria are covered. Review unmatched items before merging.');
+    }
+    else {
+        parts.push('Several criteria are not clearly addressed. Manual review recommended.');
+    }
+    return parts.join('\n');
+}
+/** Run the full PR compliance check. */
+export async function reviewPrAgainstSpec(specId, projectPath, prNumber, githubRepo) {
+    const specContent = await readSpecContent(specId, projectPath);
+    if (!specContent) {
+        return { isError: true, message: `Spec ${specId} not found in ${projectPath}/planu/specs/` };
+    }
+    const diff = fetchPrDiff(prNumber, githubRepo);
+    if (diff === null) {
+        return {
+            isError: true,
+            message: `Failed to fetch PR diff. Ensure 'gh' CLI is installed and authenticated, and that repo '${githubRepo}' and PR #${prNumber} are valid.`,
+        };
+    }
+    const criteria = extractAcceptanceCriteria(specContent);
+    const results = buildComplianceResults(criteria, diff);
+    const complianceScore = calcComplianceScore(results);
+    const summary = buildSummary(complianceScore, results, specId, prNumber);
+    return { specId, prNumber, complianceScore, criteria: results, summary };
+}
+/** Check gh CLI installation and PR agent configuration. */
+export function checkPrAgentStatus(projectPath) {
+    let ghInstalled = false;
+    try {
+        execSync('which gh', { encoding: 'utf8', timeout: 5000 });
+        ghInstalled = true;
+    }
+    catch {
+        // gh not installed
+    }
+    const workflowsDir = join(projectPath, '.github', 'workflows');
+    let prAgentConfigured = false;
+    let configuredTool = null;
+    if (existsSync(workflowsDir)) {
+        try {
+            const files = readdirSync(workflowsDir);
+            for (const file of files) {
+                const filePath = join(workflowsDir, file);
+                try {
+                    const content = readFileSync(filePath, 'utf8');
+                    if (content.includes('qodo')) {
+                        prAgentConfigured = true;
+                        configuredTool = 'qodo';
+                        break;
+                    }
+                    if (content.includes('pr-agent')) {
+                        prAgentConfigured = true;
+                        configuredTool = 'pr-agent';
+                        break;
+                    }
+                }
+                catch {
+                    // skip unreadable file
+                }
+            }
+        }
+        catch {
+            // skip unreadable dir
+        }
+    }
+    return { ghInstalled, prAgentConfigured, configuredTool };
+}
+//# sourceMappingURL=pr-spec-validator.js.map

package/dist/engine/pr-spec-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-spec-validator.js","sourceRoot":"","sources":["../../src/engine/pr-spec-validator.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,2EAA2E;AAE3E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,yEAAyE;AACzE,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,WAAmB;IACtE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,WAAmB;IACvE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,UAAkB;IAC9D,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,cAAc,QAAQ,WAAW,UAAU,EAAE,EAAE;YAC7D,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,IAAY;IAC5D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,SAAS;SACpB,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;AAC5C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,sBAAsB,CACpC,QAAkB,EAClB,IAAY;IAEZ,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAClC,SAAS;QACT,MAAM,EAAE,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC;KACxC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB,CAAC,OAAoC;IACtE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACrE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAC1B,KAAa,EACb,OAAoC,EACpC,MAAc,EACd,QAAgB;IAEhB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACrE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACrE,MAAM,KAAK,GAAa;QACtB,OAAO,QAAQ,OAAO,MAAM,KAAK,KAAK,cAAc;QACpD,GAAG,OAAO,aAAa,SAAS,eAAe,OAAO,mBAAmB,OAAO,CAAC,MAAM,WAAW;KACnG,CAAC;IACF,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;IAC5E,CAAC;SAAM,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,WAAmB,EACnB,QAAgB,EAChB,UAAkB;IAElB,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,MAAM,iBAAiB,WAAW,eAAe,EAAE,CAAC;IAC/F,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,2FAA2F,UAAU,aAAa,QAAQ,aAAa;SACjJ,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,sBAAsB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEzE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC3E,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,CAAC;QACH,QAAQ,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAC/D,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAC9B,IAAI,cAAc,GAAkB,IAAI,CAAC;IAEzC,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;YACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;gBAC1C,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAC/C,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC7B,iBAAiB,GAAG,IAAI,CAAC;wBACzB,cAAc,GAAG,MAAM,CAAC;wBACxB,MAAM;oBACR,CAAC;oBACD,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;wBACjC,iBAAiB,GAAG,IAAI,CAAC;wBACzB,cAAc,GAAG,UAAU,CAAC;wBAC5B,MAAM;oBACR,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,uBAAuB;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC;AAC5D,CAAC"}

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

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

package/dist/engine/sweep-issue-generator.d.ts

@@ -0,0 +1,14 @@
+import type { CreateSweepIssueResult, SweepStatusResult } from '../types/index.js';
+/**
+ * Build the GitHub issue body for Sweep AI.
+ */
+export declare function buildSweepIssueBody(specId: string, specSlug: string, title: string, description: string, criteria: string[], affectedFiles: string[]): string;
+/**
+ * Generate and optionally create a GitHub issue for Sweep AI.
+ */
+export declare function createSweepIssue(specId: string, projectPath: string, githubRepo: string, dryRun: boolean): Promise<CreateSweepIssueResult>;
+/**
+ * Check whether gh CLI is installed and if the sweep label exists on the repo.
+ */
+export declare function checkSweepStatus(githubRepo: string | undefined): SweepStatusResult;
+//# sourceMappingURL=sweep-issue-generator.d.ts.map

package/dist/engine/sweep-issue-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep-issue-generator.d.ts","sourceRoot":"","sources":["../../src/engine/sweep-issue-generator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAwCnF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,aAAa,EAAE,MAAM,EAAE,GACtB,MAAM,CA0BR;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,sBAAsB,CAAC,CA4DjC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAuBlF"}