@planu/cli 0.94.0 → 0.96.0

package/dist/engine/github/review-dimensions.js

@@ -0,0 +1,253 @@
+// Review dimensions for expert PR analysis (SPEC-303)
+import { parseDiffFiles } from './review-helpers.js';
+import { runDuplication, runComplexity, runDeadCode, runQualityDimensions, } from './quality-dimensions.js';
+export { runQualityDimensions };
+function changedFilePaths(diff) {
+    return diff
+        .split('\n')
+        .filter((l) => l.startsWith('diff --git'))
+        .map((l) => {
+        const m = /b\/(.+)$/.exec(l);
+        return m?.[1] ?? '';
+    })
+        .filter(Boolean);
+}
+// ---------------------------------------------------------------------------
+// Architecture dimension
+// ---------------------------------------------------------------------------
+function runArchitecture(diff) {
+    const findings = [];
+    const files = parseDiffFiles(diff);
+    // Track added line count per file (heuristic for "file > 400 lines")
+    const addedLines = {};
+    for (const file of files) {
+        addedLines[file.path] = (addedLines[file.path] ?? 0) + file.lines.length;
+    }
+    for (const file of files) {
+        const added = addedLines[file.path] ?? 0;
+        if (added > 400) {
+            findings.push({
+                file: file.path,
+                severity: 'warning',
+                category: 'architecture',
+                message: `File adds ${String(added)} lines in this PR (threshold: 400). Consider splitting.`,
+                suggestion: 'Break into smaller modules following single-responsibility principle.',
+            });
+        }
+        for (const { lineNo, content } of file.lines) {
+            if (file.path.endsWith('.ts') || file.path.endsWith('.tsx')) {
+                const importMatch = /^\s*(?:import|export).*from\s+['"](\.[^'"]+)['"]/.exec(content);
+                if (importMatch?.[1]) {
+                    const importPath = importMatch[1];
+                    if (!importPath.endsWith('.js') && !importPath.endsWith('.json')) {
+                        findings.push({
+                            file: file.path,
+                            line: lineNo,
+                            severity: 'warning',
+                            category: 'architecture',
+                            message: `Missing .js extension in import: "${importPath}"`,
+                            suggestion: `Add .js extension: "${importPath}.js"`,
+                        });
+                    }
+                }
+                // Circular-looking imports (file imports from parent with same name)
+                const circularMatch = /^\s*import.*from\s+['"]\.\.\/([^/'"]+)['"]/.exec(content);
+                if (circularMatch?.[1]) {
+                    const importedModule = circularMatch[1];
+                    const currentModule = file.path
+                        .replace(/\.[^.]+$/, '')
+                        .split('/')
+                        .pop() ?? '';
+                    if (importedModule === currentModule) {
+                        findings.push({
+                            file: file.path,
+                            line: lineNo,
+                            severity: 'warning',
+                            category: 'architecture',
+                            message: `Potential circular import: module imports from sibling with same name "${importedModule}"`,
+                            suggestion: 'Review module boundaries to avoid circular dependencies.',
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return findings;
+}
+// ---------------------------------------------------------------------------
+// Security dimension
+// ---------------------------------------------------------------------------
+const SECURITY_PATTERNS = [
+    {
+        pattern: /password\s*[:=]\s*['"][^'"]{1,}['"]/i,
+        message: 'Hardcoded password detected',
+        suggestion: 'Use environment variables for secrets',
+    },
+    {
+        pattern: /api[_-]?key\s*[:=]\s*['"][^'"]{1,}['"]/i,
+        message: 'Hardcoded API key detected',
+        suggestion: 'Use environment variables for secrets',
+    },
+    {
+        pattern: /Bearer\s+[A-Za-z0-9\-._~+/]{20,}/,
+        message: 'Hardcoded Bearer token detected',
+        suggestion: 'Load tokens from environment variables or a secrets manager',
+    },
+    {
+        pattern: /['"`]\s*SELECT\s+.+\s*\+\s*[a-zA-Z_$]/i,
+        message: 'Possible SQL string concatenation — SQL injection risk',
+        suggestion: 'Use parameterized queries or an ORM',
+    },
+    {
+        pattern: /eval\s*\(/,
+        message: 'Use of eval() detected',
+        suggestion: 'Avoid eval(); use safer alternatives like JSON.parse()',
+    },
+    {
+        pattern: /dangerouslySetInnerHTML/,
+        message: 'dangerouslySetInnerHTML usage detected — XSS risk',
+        suggestion: 'Sanitize HTML with DOMPurify before using dangerouslySetInnerHTML',
+    },
+];
+function runSecurity(diff) {
+    const findings = [];
+    const files = parseDiffFiles(diff);
+    for (const file of files) {
+        for (const { lineNo, content } of file.lines) {
+            for (const { pattern, message, suggestion } of SECURITY_PATTERNS) {
+                if (pattern.test(content)) {
+                    findings.push({
+                        file: file.path,
+                        line: lineNo,
+                        severity: 'critical',
+                        category: 'security',
+                        message,
+                        suggestion,
+                    });
+                }
+            }
+        }
+    }
+    return findings;
+}
+// ---------------------------------------------------------------------------
+// Tests dimension
+// ---------------------------------------------------------------------------
+function runTests(diff) {
+    const findings = [];
+    const paths = changedFilePaths(diff);
+    const srcFiles = paths.filter((p) => p.startsWith('src/') && p.endsWith('.ts'));
+    const testFiles = new Set(paths.filter((p) => p.startsWith('tests/')));
+    for (const src of srcFiles) {
+        // src/foo/bar.ts → tests/foo/bar.test.ts
+        const relative = src.slice('src/'.length).replace(/\.ts$/, '');
+        const expected = `tests/${relative}.test.ts`;
+        if (!testFiles.has(expected)) {
+            findings.push({
+                file: src,
+                severity: 'warning',
+                category: 'tests',
+                message: `Source file changed but no corresponding test file found: ${expected}`,
+                suggestion: 'Add or update tests to cover the changed code.',
+            });
+        }
+    }
+    return findings;
+}
+// ---------------------------------------------------------------------------
+// Conventions dimension
+// ---------------------------------------------------------------------------
+function runConventions(diff) {
+    const findings = [];
+    const files = parseDiffFiles(diff);
+    for (const file of files) {
+        if (!file.path.endsWith('.ts') && !file.path.endsWith('.tsx')) {
+            continue;
+        }
+        for (const { lineNo, content } of file.lines) {
+            if (/:\s*any\b/.test(content) && !content.trimStart().startsWith('//')) {
+                findings.push({
+                    file: file.path,
+                    line: lineNo,
+                    severity: 'warning',
+                    category: 'conventions',
+                    message: 'Explicit `any` type used — weakens type safety',
+                    suggestion: 'Replace `any` with a specific type, `unknown`, or a generic.',
+                });
+            }
+        }
+        // Check .github/ files for conventional commit patterns
+        if (file.path.startsWith('.github/')) {
+            for (const { lineNo, content } of file.lines) {
+                if (/commit\s+message/i.test(content) && !/conventional/i.test(content)) {
+                    findings.push({
+                        file: file.path,
+                        line: lineNo,
+                        severity: 'info',
+                        category: 'conventions',
+                        message: 'Commit message check found without conventional-commits enforcement',
+                        suggestion: 'Ensure commitlint with conventional-commits preset is configured.',
+                    });
+                }
+            }
+        }
+    }
+    return findings;
+}
+// ---------------------------------------------------------------------------
+// Spec-drift dimension
+// ---------------------------------------------------------------------------
+function runSpecDrift(diff, context) {
+    if (!context.specId) {
+        return [];
+    }
+    const findings = [];
+    const paths = changedFilePaths(diff);
+    const specSlug = context.specId.toLowerCase().replace(/spec-\d+-?/i, '');
+    const keywords = specSlug.split(/[-_\s]+/).filter((k) => k.length > 2);
+    if (keywords.length === 0) {
+        return [];
+    }
+    for (const filePath of paths) {
+        const lowerPath = filePath.toLowerCase();
+        const matchesSpec = keywords.some((kw) => lowerPath.includes(kw));
+        if (!matchesSpec &&
+            filePath.startsWith('src/') &&
+            !filePath.includes('types/') &&
+            !filePath.includes('index')) {
+            findings.push({
+                file: filePath,
+                severity: 'info',
+                category: 'spec-drift',
+                message: `File may be outside the scope of ${context.specId} (keywords: ${keywords.join(', ')})`,
+                suggestion: 'Verify this change is intentional for this spec, or move to a separate PR.',
+            });
+        }
+    }
+    return findings;
+}
+// ---------------------------------------------------------------------------
+// Main orchestrator
+// ---------------------------------------------------------------------------
+export function runAllDimensions(diff, context) {
+    const dimensions = [
+        ['architecture', () => runArchitecture(diff)],
+        ['security', () => runSecurity(diff)],
+        ['tests', () => runTests(diff)],
+        ['conventions', () => runConventions(diff)],
+        ['spec-drift', () => runSpecDrift(diff, context)],
+        ['duplication', () => runDuplication(diff)],
+        ['complexity', () => runComplexity(diff)],
+        ['dead-code', () => runDeadCode(diff)],
+    ];
+    return Promise.resolve(dimensions.map(([name, fn]) => {
+        const start = Date.now();
+        const findings = fn();
+        return {
+            dimension: name,
+            findings,
+            duration: Date.now() - start,
+        };
+    }));
+}
+//# sourceMappingURL=review-dimensions.js.map

package/dist/engine/github/review-dimensions.js.map

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

package/dist/engine/github/review-helpers.d.ts

@@ -0,0 +1,4 @@
+import type { ReviewFileDiff } from '../../types/github.js';
+/** Parse a git diff string into structured per-file change lists. */
+export declare function parseDiffFiles(diff: string): ReviewFileDiff[];
+//# sourceMappingURL=review-helpers.d.ts.map

package/dist/engine/github/review-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-helpers.d.ts","sourceRoot":"","sources":["../../../src/engine/github/review-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CA+B7D"}

package/dist/engine/github/review-helpers.js

@@ -0,0 +1,31 @@
+/** Parse a git diff string into structured per-file change lists. */
+export function parseDiffFiles(diff) {
+    const files = [];
+    let current = null;
+    let lineNo = 0;
+    for (const line of diff.split('\n')) {
+        if (line.startsWith('diff --git')) {
+            const match = /b\/(.+)$/.exec(line);
+            if (match?.[1]) {
+                current = { path: match[1], lines: [] };
+                files.push(current);
+                lineNo = 0;
+            }
+            continue;
+        }
+        const hunkMatch = /^@@\s+-\d+(?:,\d+)?\s+\+(\d+)/.exec(line);
+        if (hunkMatch?.[1]) {
+            lineNo = Number(hunkMatch[1]);
+            continue;
+        }
+        if (line.startsWith('+') && !line.startsWith('+++')) {
+            current?.lines.push({ lineNo, content: line.slice(1) });
+            lineNo++;
+        }
+        else if (!line.startsWith('-')) {
+            lineNo++;
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=review-helpers.js.map

package/dist/engine/github/review-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-helpers.js","sourceRoot":"","sources":["../../../src/engine/github/review-helpers.ts"],"names":[],"mappings":"AAGA,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,IAAI,OAAO,GAA0B,IAAI,CAAC;IAC1C,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACf,OAAO,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;gBACxC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpB,MAAM,GAAG,CAAC,CAAC;YACb,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACxD,MAAM,EAAE,CAAC;QACX,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/engine/google-workspace-exporter.d.ts

@@ -0,0 +1,22 @@
+import type { SpecSheetEntry } from '../types/index.js';
+/**
+ * Convert spec.md content to Google Docs-compatible markdown.
+ * Adds a header with the spec ID and normalizes heading levels.
+ */
+export declare function specToGoogleDocsFormat(specContent: string, specId: string): string;
+/**
+ * Convert a specs array to Google Sheets-compatible CSV.
+ * Includes a header row with standard column names.
+ */
+export declare function specsToCSV(specs: SpecSheetEntry[]): string;
+/**
+ * Generate a Google Apps Script (.gs) that creates a Google Doc from spec content.
+ * The script can be run from Google Apps Script editor to create or update the Doc.
+ */
+export declare function generateAppsScript(specId: string, specContent: string): string;
+/**
+ * Convert Google Docs exported markdown back to Planu spec format.
+ * Extracts title and description to build a minimal spec.md front matter.
+ */
+export declare function googleDocsToSpec(docsContent: string): string;
+//# sourceMappingURL=google-workspace-exporter.d.ts.map

package/dist/engine/google-workspace-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-workspace-exporter.d.ts","sourceRoot":"","sources":["../../src/engine/google-workspace-exporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAWxD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAkClF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAe1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAyD9E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAkC5D"}

package/dist/engine/google-workspace-exporter.js

@@ -0,0 +1,159 @@
+// engine/google-workspace-exporter.ts — SPEC-310: Google Workspace Sync
+/** CSV-escape a single cell value. */
+function csvCell(value) {
+    const escaped = value.replace(/"/g, '""');
+    if (escaped.includes(',') || escaped.includes('"') || escaped.includes('\n')) {
+        return `"${escaped}"`;
+    }
+    return escaped;
+}
+/**
+ * Convert spec.md content to Google Docs-compatible markdown.
+ * Adds a header with the spec ID and normalizes heading levels.
+ */
+export function specToGoogleDocsFormat(specContent, specId) {
+    const lines = specContent.split('\n');
+    const normalized = [];
+    // Ensure the doc starts with the spec ID as a heading
+    const firstHeading = lines.find((l) => l.startsWith('#'));
+    if (firstHeading?.includes(specId) !== true) {
+        normalized.push(`# ${specId}`);
+        normalized.push('');
+    }
+    let inFrontmatter = false;
+    let frontmatterDone = false;
+    for (const line of lines) {
+        // Skip YAML frontmatter — not Google Docs friendly
+        if (line.trim() === '---' && !frontmatterDone) {
+            if (!inFrontmatter) {
+                inFrontmatter = true;
+                continue;
+            }
+            else {
+                inFrontmatter = false;
+                frontmatterDone = true;
+                continue;
+            }
+        }
+        if (inFrontmatter) {
+            continue;
+        }
+        normalized.push(line);
+    }
+    return normalized.join('\n');
+}
+/**
+ * Convert a specs array to Google Sheets-compatible CSV.
+ * Includes a header row with standard column names.
+ */
+export function specsToCSV(specs) {
+    const header = ['ID', 'Title', 'Status', 'Estimate', 'Risk'];
+    const rows = [header];
+    for (const spec of specs) {
+        rows.push([
+            csvCell(spec.id),
+            csvCell(spec.title),
+            csvCell(spec.status),
+            csvCell(spec.estimate ?? ''),
+            csvCell(spec.risk ?? ''),
+        ]);
+    }
+    return rows.map((row) => row.join(',')).join('\n');
+}
+/**
+ * Generate a Google Apps Script (.gs) that creates a Google Doc from spec content.
+ * The script can be run from Google Apps Script editor to create or update the Doc.
+ */
+export function generateAppsScript(specId, specContent) {
+    // Escape content for embedding in script string literal
+    const escaped = specContent
+        .replace(/\\/g, '\\\\')
+        .replace(/'/g, "\\'")
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '');
+    return [
+        `// Google Apps Script — Planu SPEC-310`,
+        `// Auto-generated for spec: ${specId}`,
+        `// Run this in https://script.google.com to create or update a Google Doc`,
+        ``,
+        `function createSpecDoc_${specId.replace(/-/g, '_')}() {`,
+        `  var title = 'Planu — ${specId}';`,
+        `  var content = '${escaped}';`,
+        ``,
+        `  // Find existing doc or create a new one`,
+        `  var files = DriveApp.getFilesByName(title);`,
+        `  var doc;`,
+        `  if (files.hasNext()) {`,
+        `    doc = DocumentApp.openById(files.next().getId());`,
+        `  } else {`,
+        `    doc = DocumentApp.create(title);`,
+        `  }`,
+        ``,
+        `  var body = doc.getBody();`,
+        `  body.clear();`,
+        ``,
+        `  // Parse and insert content`,
+        `  var lines = content.split('\\n');`,
+        `  for (var i = 0; i < lines.length; i++) {`,
+        `    var line = lines[i];`,
+        `    if (line.startsWith('# ')) {`,
+        `      body.appendParagraph(line.substring(2))`,
+        `           .setHeading(DocumentApp.ParagraphHeading.HEADING1);`,
+        `    } else if (line.startsWith('## ')) {`,
+        `      body.appendParagraph(line.substring(3))`,
+        `           .setHeading(DocumentApp.ParagraphHeading.HEADING2);`,
+        `    } else if (line.startsWith('### ')) {`,
+        `      body.appendParagraph(line.substring(4))`,
+        `           .setHeading(DocumentApp.ParagraphHeading.HEADING3);`,
+        `    } else if (line.length > 0) {`,
+        `      body.appendParagraph(line);`,
+        `    }`,
+        `  }`,
+        ``,
+        `  doc.saveAndClose();`,
+        `  Logger.log('Doc created: ' + doc.getUrl());`,
+        `  return doc.getUrl();`,
+        `}`,
+        ``,
+        `function syncAllSpecs() {`,
+        `  // Entry point for scheduled sync`,
+        `  createSpecDoc_${specId.replace(/-/g, '_')}();`,
+        `}`,
+    ].join('\n');
+}
+/**
+ * Convert Google Docs exported markdown back to Planu spec format.
+ * Extracts title and description to build a minimal spec.md front matter.
+ */
+export function googleDocsToSpec(docsContent) {
+    const lines = docsContent.split('\n');
+    let title = '';
+    let description = '';
+    const bodyLines = [];
+    let titleFound = false;
+    for (const line of lines) {
+        if (!titleFound && line.startsWith('# ')) {
+            title = line.substring(2).trim();
+            titleFound = true;
+            continue;
+        }
+        if (titleFound) {
+            bodyLines.push(line);
+        }
+    }
+    // Extract first paragraph as description
+    const firstParagraphIdx = bodyLines.findIndex((l) => l.trim().length > 0 && !l.startsWith('#'));
+    if (firstParagraphIdx >= 0) {
+        description = bodyLines[firstParagraphIdx]?.trim() ?? '';
+    }
+    const frontmatter = [
+        '---',
+        `title: "${title}"`,
+        `status: draft`,
+        `description: "${description}"`,
+        '---',
+        '',
+    ];
+    return [...frontmatter, ...bodyLines].join('\n');
+}
+//# sourceMappingURL=google-workspace-exporter.js.map

package/dist/engine/google-workspace-exporter.js.map

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

package/dist/engine/skill-registry/builtin-catalog-adapter.d.ts

@@ -0,0 +1,11 @@
+import type { SkillSearchResult, BuiltInSkillEntry } from '../../types/index.js';
+/**
+ * Search built-in skills from the skill catalog.
+ * Returns all matching skills regardless of query for built-in catalog browsing.
+ */
+export declare function searchBuiltInSkills(query: string): SkillSearchResult[];
+/** Get a single built-in skill entry by exact name. Returns undefined if not found. */
+export declare function getBuiltInSkillEntry(name: string): BuiltInSkillEntry | undefined;
+/** Clear the catalog cache (for testing). */
+export declare function clearBuiltInCatalogCache(): void;
+//# sourceMappingURL=builtin-catalog-adapter.d.ts.map

package/dist/engine/skill-registry/builtin-catalog-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-catalog-adapter.d.ts","sourceRoot":"","sources":["../../../src/engine/skill-registry/builtin-catalog-adapter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAgB,MAAM,sBAAsB,CAAC;AAkE/F;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAsBtE;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEhF;AAED,6CAA6C;AAC7C,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/engine/skill-registry/builtin-catalog-adapter.js

@@ -0,0 +1,95 @@
+// engine/skill-registry/builtin-catalog-adapter.ts — SPEC-307: Built-in skill catalog search
+// Searches src/config/skill-catalog.json for built-in skills without network calls.
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let catalogCache = null;
+/** Load the built-in skill catalog from disk (cached after first read). */
+function loadCatalog() {
+    if (catalogCache !== null) {
+        return catalogCache;
+    }
+    // Try compiled path first (dist/config/), then source path (src/config/)
+    const compiledPath = join(__dirname, '../../config/skill-catalog.json');
+    const sourcePath = join(__dirname, '../../../src/config/skill-catalog.json');
+    for (const configPath of [compiledPath, sourcePath]) {
+        let raw;
+        try {
+            raw = readFileSync(configPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        try {
+            const catalog = JSON.parse(raw);
+            catalogCache = catalog.skills.length > 0 ? catalog.skills : [];
+            return catalogCache;
+        }
+        catch {
+            console.warn('[skill_search] skill-catalog.json is corrupted, skipping built-in catalog');
+            return [];
+        }
+    }
+    return [];
+}
+/** Compute a simple relevance score for a built-in skill against a query. */
+function scoreBuiltIn(skill, query) {
+    const q = query.toLowerCase();
+    const nameLower = skill.name.toLowerCase();
+    const descLower = skill.description.toLowerCase();
+    const categoryLower = skill.category.toLowerCase();
+    const tagMatch = skill.tags.some((t) => t.toLowerCase().includes(q));
+    let score = 0;
+    if (nameLower === q) {
+        score += 0.45;
+    }
+    else if (nameLower.includes(q)) {
+        score += 0.3;
+    }
+    if (descLower.includes(q)) {
+        score += 0.15;
+    }
+    if (categoryLower.includes(q)) {
+        score += 0.1;
+    }
+    if (tagMatch) {
+        score += 0.1;
+    }
+    // Small boost for built-in skills to surface them alongside remote results
+    score += 0.02;
+    return Math.min(score, 1);
+}
+/**
+ * Search built-in skills from the skill catalog.
+ * Returns all matching skills regardless of query for built-in catalog browsing.
+ */
+export function searchBuiltInSkills(query) {
+    const catalog = loadCatalog();
+    const q = query.toLowerCase();
+    const results = [];
+    for (const skill of catalog) {
+        const score = scoreBuiltIn(skill, q);
+        // Include if any keyword matches (score > 0.02 means something matched beyond the boost)
+        if (score > 0.03) {
+            results.push({
+                name: skill.name,
+                description: skill.description,
+                source: 'builtin',
+                installCommand: skill.installCommand,
+                tags: skill.tags,
+                relevanceScore: score,
+            });
+        }
+    }
+    return results;
+}
+/** Get a single built-in skill entry by exact name. Returns undefined if not found. */
+export function getBuiltInSkillEntry(name) {
+    return loadCatalog().find((s) => s.name === name);
+}
+/** Clear the catalog cache (for testing). */
+export function clearBuiltInCatalogCache() {
+    catalogCache = null;
+}
+//# sourceMappingURL=builtin-catalog-adapter.js.map

package/dist/engine/skill-registry/builtin-catalog-adapter.js.map

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

package/dist/engine/skill-registry/index.d.ts

@@ -4,4 +4,5 @@ export { searchAnthropicSkills, fetchAnthropicSkillContent, clearAnthropicCache,
 export { searchSkillsSh } from './skillssh-adapter.js';
 export { searchAgentSkills } from './agentskill-adapter.js';
 export { discoverNewRegistries } from './discovery.js';
+export { searchBuiltInSkills, clearBuiltInCatalogCache, getBuiltInSkillEntry, } from './builtin-catalog-adapter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/engine/skill-registry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/skill-registry/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/skill-registry/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC"}

package/dist/engine/skill-registry/index.js

@@ -5,4 +5,5 @@ export { searchAnthropicSkills, fetchAnthropicSkillContent, clearAnthropicCache,
 export { searchSkillsSh } from './skillssh-adapter.js';
 export { searchAgentSkills } from './agentskill-adapter.js';
 export { discoverNewRegistries } from './discovery.js';
+export { searchBuiltInSkills, clearBuiltInCatalogCache, getBuiltInSkillEntry, } from './builtin-catalog-adapter.js';
 //# sourceMappingURL=index.js.map