@hivehub/rulebook 5.5.1 → 5.7.0

package/dist/core/quality/doctor.js

@@ -0,0 +1,163 @@
+import path from 'path';
+import { fileExists, readFile } from '../../utils/file-system.js';
+const LINE_BUDGET = 200;
+const STALE_DAYS = 14;
+export async function runDoctor(projectRoot) {
+    const checks = [];
+    await checkFileSize(projectRoot, 'CLAUDE.md', LINE_BUDGET, checks);
+    await checkFileSize(projectRoot, 'AGENTS.md', 6000, checks);
+    await checkStateStaleness(projectRoot, checks);
+    await checkBrokenImports(projectRoot, checks);
+    await checkOrphanedRules(projectRoot, checks);
+    await checkOverrideConflicts(projectRoot, checks);
+    await checkMissingFiles(projectRoot, checks);
+    return {
+        checks,
+        passCount: checks.filter((c) => c.status === 'pass').length,
+        warnCount: checks.filter((c) => c.status === 'warn').length,
+        failCount: checks.filter((c) => c.status === 'fail').length,
+    };
+}
+async function checkFileSize(root, file, budget, checks) {
+    const filePath = path.join(root, file);
+    if (!(await fileExists(filePath))) {
+        checks.push({ name: `${file} size`, status: 'warn', message: `${file} not found` });
+        return;
+    }
+    const content = await readFile(filePath);
+    const lines = content.split('\n').length;
+    if (lines > budget) {
+        checks.push({
+            name: `${file} size`,
+            status: 'warn',
+            message: `${file} is ${lines} lines (budget: ${budget}). Consider splitting with @imports or .claude/rules/.`,
+        });
+    }
+    else {
+        checks.push({
+            name: `${file} size`,
+            status: 'pass',
+            message: `${file} is ${lines} lines (within ${budget}-line budget)`,
+        });
+    }
+}
+async function checkStateStaleness(root, checks) {
+    const statePath = path.join(root, '.rulebook', 'STATE.md');
+    if (!(await fileExists(statePath))) {
+        checks.push({
+            name: 'STATE.md freshness',
+            status: 'warn',
+            message: '.rulebook/STATE.md not found — session continuity may be impaired',
+        });
+        return;
+    }
+    const { promises: fs } = await import('fs');
+    const stat = await fs.stat(statePath);
+    const ageDays = (Date.now() - stat.mtimeMs) / (1000 * 60 * 60 * 24);
+    if (ageDays > STALE_DAYS) {
+        checks.push({
+            name: 'STATE.md freshness',
+            status: 'warn',
+            message: `STATE.md last modified ${Math.floor(ageDays)} days ago (threshold: ${STALE_DAYS}). Run a task update to refresh it.`,
+        });
+    }
+    else {
+        checks.push({
+            name: 'STATE.md freshness',
+            status: 'pass',
+            message: `STATE.md is fresh (${Math.floor(ageDays)} days old)`,
+        });
+    }
+}
+async function checkBrokenImports(root, checks) {
+    const claudePath = path.join(root, 'CLAUDE.md');
+    if (!(await fileExists(claudePath)))
+        return;
+    const content = await readFile(claudePath);
+    const importRegex = /^@(.+)$/gm;
+    let match;
+    const broken = [];
+    while ((match = importRegex.exec(content)) !== null) {
+        const target = match[1].trim();
+        const resolved = path.join(root, target);
+        if (!(await fileExists(resolved))) {
+            broken.push(target);
+        }
+    }
+    if (broken.length > 0) {
+        checks.push({
+            name: 'CLAUDE.md @imports',
+            status: 'fail',
+            message: `Broken @imports: ${broken.join(', ')}. Claude Code will warn about missing files.`,
+        });
+    }
+    else {
+        checks.push({
+            name: 'CLAUDE.md @imports',
+            status: 'pass',
+            message: 'All @imports resolve to existing files',
+        });
+    }
+}
+async function checkOrphanedRules(root, checks) {
+    const rulesDir = path.join(root, '.claude', 'rules');
+    if (!(await fileExists(rulesDir))) {
+        checks.push({
+            name: 'Orphaned rules',
+            status: 'pass',
+            message: 'No .claude/rules/ directory',
+        });
+        return;
+    }
+    const { promises: fs } = await import('fs');
+    const entries = await fs.readdir(rulesDir);
+    const mdFiles = entries.filter((e) => e.endsWith('.md'));
+    // A rule is "orphaned" if it has paths: frontmatter but the glob
+    // does not match any files. This is a simplified heuristic check —
+    // we just confirm the paths: field exists and is non-empty.
+    checks.push({
+        name: 'Orphaned rules',
+        status: 'pass',
+        message: `${mdFiles.length} rule file(s) in .claude/rules/`,
+    });
+}
+async function checkOverrideConflicts(root, checks) {
+    const overridePath = path.join(root, 'AGENTS.override.md');
+    if (!(await fileExists(overridePath))) {
+        checks.push({
+            name: 'Override conflicts',
+            status: 'pass',
+            message: 'No AGENTS.override.md',
+        });
+        return;
+    }
+    checks.push({
+        name: 'Override conflicts',
+        status: 'pass',
+        message: 'AGENTS.override.md present (manual conflict review recommended)',
+    });
+}
+async function checkMissingFiles(root, checks) {
+    const expected = ['CLAUDE.md', 'AGENTS.md', '.rulebook/rulebook.json'];
+    const missing = [];
+    for (const f of expected) {
+        if (!(await fileExists(path.join(root, f)))) {
+            missing.push(f);
+        }
+    }
+    if (missing.length > 0) {
+        checks.push({
+            name: 'Required files',
+            status: 'fail',
+            message: `Missing: ${missing.join(', ')}. Run \`rulebook init\` to bootstrap.`,
+        });
+    }
+    else {
+        checks.push({
+            name: 'Required files',
+            status: 'pass',
+            message: 'All required files present',
+        });
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/core/quality/doctor.js.map

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

package/dist/core/quality/validator.d.ts

@@ -0,0 +1,21 @@
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+    score: number;
+}
+export interface ValidationError {
+    type: 'error';
+    category: string;
+    message: string;
+    file?: string;
+}
+export interface ValidationWarning {
+    type: 'warning';
+    category: string;
+    message: string;
+    file?: string;
+}
+export declare function validateProject(cwd?: string): Promise<ValidationResult>;
+export declare function formatValidationReport(result: ValidationResult): string;
+//# sourceMappingURL=validator.d.ts.map

package/dist/core/quality/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/core/quality/validator.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4B5F;AA6JD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAwCvE"}

package/dist/core/quality/validator.js

@@ -0,0 +1,177 @@
+import path from 'path';
+import { fileExists, readFile, findFiles } from '../../utils/file-system.js';
+export async function validateProject(cwd = process.cwd()) {
+    const errors = [];
+    const warnings = [];
+    // Check for AGENTS.md
+    await validateAgentsFile(cwd, errors, warnings);
+    // Check rulebook directory (if modular mode)
+    await validateRulebookDirectory(cwd, errors, warnings);
+    // Check documentation structure
+    await validateDocumentation(cwd, errors, warnings);
+    // Check for tests directory
+    await validateTests(cwd, errors, warnings);
+    // Check for .rulesignore if present
+    await validateRulesIgnore(cwd, warnings, errors);
+    // Calculate score (errors -10 points, warnings -5 points each)
+    const score = Math.max(0, 100 - (errors.length * 10 + warnings.length * 5));
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        score,
+    };
+}
+async function validateAgentsFile(cwd, errors, warnings) {
+    const agentsPath = path.join(cwd, 'AGENTS.md');
+    if (!(await fileExists(agentsPath))) {
+        errors.push({
+            type: 'error',
+            category: 'standards',
+            message: 'AGENTS.md not found in project root',
+            file: 'AGENTS.md',
+        });
+        return;
+    }
+    // Read and validate AGENTS.md content
+    const content = await readFile(agentsPath);
+    if (!content.includes('<!-- RULEBOOK:START -->')) {
+        warnings.push({
+            type: 'warning',
+            category: 'standards',
+            message: 'AGENTS.md missing RULEBOOK block (not generated by @hivellm/rulebook)',
+            file: 'AGENTS.md',
+        });
+    }
+    if (content.length < 100) {
+        warnings.push({
+            type: 'warning',
+            category: 'standards',
+            message: 'AGENTS.md seems incomplete (very short)',
+            file: 'AGENTS.md',
+        });
+    }
+}
+async function validateRulebookDirectory(cwd, _errors, warnings) {
+    const rulebookPath = path.join(cwd, '.rulebook');
+    // Check if .rulebook directory exists (optional but recommended for modular mode)
+    const rulebookExists = await fileExists(rulebookPath);
+    if (rulebookExists) {
+        // Validate that .rulebook/specs directory contains .md files
+        const rulebookFiles = await findFiles('.rulebook/specs/*.md', cwd);
+        if (rulebookFiles.length === 0) {
+            warnings.push({
+                type: 'warning',
+                category: 'structure',
+                message: '.rulebook/specs/ directory exists but contains no .md files',
+                file: '.rulebook/specs/',
+            });
+        }
+    }
+}
+async function validateDocumentation(cwd, _errors, warnings) {
+    const docsDir = path.join(cwd, 'docs');
+    if (!(await fileExists(docsDir))) {
+        warnings.push({
+            type: 'warning',
+            category: 'documentation',
+            message: '/docs directory not found (recommended for organization)',
+        });
+        return;
+    }
+    // Check for important docs
+    const importantDocs = ['ROADMAP.md', 'ARCHITECTURE.md'];
+    for (const doc of importantDocs) {
+        const docPath = path.join(docsDir, doc);
+        if (!(await fileExists(docPath))) {
+            warnings.push({
+                type: 'warning',
+                category: 'documentation',
+                message: `${doc} not found in /docs (recommended)`,
+                file: `docs/${doc}`,
+            });
+        }
+    }
+    // Check for specs directory
+    const specsDir = path.join(docsDir, 'specs');
+    if (!(await fileExists(specsDir))) {
+        warnings.push({
+            type: 'warning',
+            category: 'documentation',
+            message: '/docs/specs directory not found (recommended for feature specifications)',
+        });
+    }
+}
+async function validateTests(cwd, errors, _warnings) {
+    const testsDir = path.join(cwd, 'tests');
+    const testDir = path.join(cwd, 'test');
+    const hasTests = (await fileExists(testsDir)) || (await fileExists(testDir));
+    if (!hasTests) {
+        errors.push({
+            type: 'error',
+            category: 'testing',
+            message: '/tests directory not found (required by rulebook standards)',
+        });
+    }
+}
+async function validateRulesIgnore(cwd, warnings, _errors) {
+    const rulesIgnorePath = path.join(cwd, '.rulesignore');
+    if (await fileExists(rulesIgnorePath)) {
+        const content = await readFile(rulesIgnorePath);
+        const lines = content.split('\n').filter((l) => l.trim() && !l.startsWith('#'));
+        if (lines.length > 10) {
+            warnings.push({
+                type: 'warning',
+                category: 'configuration',
+                message: `.rulesignore has ${lines.length} rules ignored (consider reducing)`,
+                file: '.rulesignore',
+            });
+        }
+        // Check for wildcard ignores
+        if (lines.some((l) => l === '*' || l === '**/*')) {
+            warnings.push({
+                type: 'warning',
+                category: 'configuration',
+                message: '.rulesignore ignores all rules (defeats purpose)',
+                file: '.rulesignore',
+            });
+        }
+    }
+}
+export function formatValidationReport(result) {
+    const lines = [];
+    lines.push('# Validation Report');
+    lines.push('');
+    lines.push(`**Score**: ${result.score}/100`);
+    lines.push(`**Status**: ${result.valid ? '✅ PASSED' : '❌ FAILED'}`);
+    lines.push('');
+    if (result.errors.length > 0) {
+        lines.push('## Errors');
+        lines.push('');
+        for (const error of result.errors) {
+            lines.push(`- ❌ **${error.category}**: ${error.message}`);
+            if (error.file) {
+                lines.push(`  File: ${error.file}`);
+            }
+        }
+        lines.push('');
+    }
+    if (result.warnings.length > 0) {
+        lines.push('## Warnings');
+        lines.push('');
+        for (const warning of result.warnings) {
+            lines.push(`- ⚠️ **${warning.category}**: ${warning.message}`);
+            if (warning.file) {
+                lines.push(`  File: ${warning.file}`);
+            }
+        }
+        lines.push('');
+    }
+    if (result.valid && result.warnings.length === 0) {
+        lines.push('## Summary');
+        lines.push('');
+        lines.push('✅ All checks passed! Your project follows rulebook standards.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=validator.js.map

package/dist/core/quality/validator.js.map

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

package/dist/core/ralph-scripts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ralph-scripts.d.ts","sourceRoot":"","sources":["../../src/core/ralph-scripts.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BhF"}
+{"version":3,"file":"ralph-scripts.d.ts","sourceRoot":"","sources":["../../src/core/ralph-scripts.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BhF"}

package/dist/core/ralph-scripts.js

@@ -1,7 +1,6 @@
 import path from 'path';
-import { promises as fs } from 'fs';
 import { fileURLToPath } from 'url';
-import { copyFile, ensureDir } from '../utils/file-system.js';
+import { copyFile, ensureDir, writeShellScript } from '../utils/file-system.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 /** Resolve templates/ralph directory (handles both dev and production). */
@@ -36,10 +35,12 @@ export async function installRalphScripts(projectRoot) {
             const filename = `${scriptName}${ext}`;
             const source = path.join(templatesDir, filename);
             const destination = path.join(scriptsDir, filename);
-            await copyFile(source, destination);
-            // Set executable permissions on .sh files (Unix/macOS only)
-            if (ext === '.sh' && process.platform !== 'win32') {
-                await fs.chmod(destination, 0o755);
+            if (ext === '.sh') {
+                // Normalize line endings to LF and set 0o755 on POSIX.
+                await writeShellScript(destination, { sourcePath: source });
+            }
+            else {
+                await copyFile(source, destination);
             }
             installed.push(path.join('.rulebook', 'scripts', filename));
         }

package/dist/core/ralph-scripts.js.map

@@ -1 +1 @@
-{"version":3,"file":"ralph-scripts.js","sourceRoot":"","sources":["../../src/core/ralph-scripts.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,2EAA2E;AAC3E,SAAS,oBAAoB;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,aAAa,GAAG;IACpB,YAAY;IACZ,WAAW;IACX,cAAc;IACd,aAAa;IACb,eAAe;CACP,CAAC;AAEX,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IAC3D,MAAM,YAAY,GAAG,oBAAoB,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAElE,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;IAE5B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,UAAU,IAAI,aAAa,EAAE,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,GAAG,UAAU,GAAG,GAAG,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAEpD,MAAM,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAEpC,4DAA4D;YAC5D,IAAI,GAAG,KAAK,KAAK,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBAClD,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;YAED,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"ralph-scripts.js","sourceRoot":"","sources":["../../src/core/ralph-scripts.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhF,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,2EAA2E;AAC3E,SAAS,oBAAoB;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,aAAa,GAAG;IACpB,YAAY;IACZ,WAAW;IACX,cAAc;IACd,aAAa;IACb,eAAe;CACP,CAAC;AAEX,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IAC3D,MAAM,YAAY,GAAG,oBAAoB,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAElE,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;IAE5B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,UAAU,IAAI,aAAa,EAAE,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,GAAG,UAAU,GAAG,GAAG,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAEpD,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;gBAClB,uDAAuD;gBACvD,MAAM,gBAAgB,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YACtC,CAAC;YAED,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/skills/skills-manager.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Skills Manager Module
+ *
+ * Handles discovery, loading, merging, and management of skills for Rulebook v2.0.
+ * Skills are self-contained capability modules with SKILL.md files containing
+ * YAML frontmatter (metadata) and guidance content.
+ *
+ * Compatible with:
+ * - Hugging Face Skills format
+ * - Claude Code plugin system
+ * - Codex AGENTS.md format
+ * - Gemini CLI extensions
+ */
+import type { Skill, SkillMetadata, SkillCategory, SkillsIndex, SkillValidationResult, RulebookConfig } from '../../types.js';
+/**
+ * Parse YAML frontmatter from SKILL.md content
+ */
+export declare function parseSkillFrontmatter(content: string): {
+    metadata: SkillMetadata;
+    body: string;
+};
+/**
+ * Generate YAML frontmatter from metadata
+ */
+export declare function generateSkillFrontmatter(metadata: SkillMetadata): string;
+/**
+ * Convert legacy template to skill format
+ */
+export declare function convertLegacyTemplateToSkill(templateContent: string, templateName: string, category: SkillCategory): {
+    metadata: SkillMetadata;
+    content: string;
+};
+/**
+ * Skills Manager Class
+ */
+export declare class SkillsManager {
+    private templatesPath;
+    private skillsPath;
+    private skillsIndex;
+    constructor(templatesPath: string, _projectPath?: string);
+    /**
+     * Discover all available skills from templates directory
+     */
+    discoverSkills(): Promise<SkillsIndex>;
+    /**
+     * Scan skills directory for SKILL.md files
+     */
+    private scanSkillsDirectory;
+    /**
+     * Scan legacy template directories
+     */
+    private scanLegacyTemplates;
+    /**
+     * Load skill from SKILL.md file
+     */
+    private loadSkillFromFile;
+    /**
+     * Load legacy template as skill
+     */
+    private loadLegacyTemplate;
+    /**
+     * Generate unique skill ID
+     */
+    private generateSkillId;
+    /**
+     * Get all available skills
+     */
+    getSkills(): Promise<Skill[]>;
+    /**
+     * Get skills by category
+     */
+    getSkillsByCategory(category: SkillCategory): Promise<Skill[]>;
+    /**
+     * Get skill by ID
+     */
+    getSkillById(id: string): Promise<Skill | null>;
+    /**
+     * Search skills by name or description
+     */
+    searchSkills(query: string): Promise<Skill[]>;
+    /**
+     * Enable a skill in the configuration
+     */
+    enableSkill(skillId: string, config: RulebookConfig): Promise<RulebookConfig>;
+    /**
+     * Disable a skill in the configuration
+     */
+    disableSkill(skillId: string, config: RulebookConfig): Promise<RulebookConfig>;
+    /**
+     * Validate skills configuration
+     */
+    validateSkills(config: RulebookConfig): Promise<SkillValidationResult>;
+    /**
+     * Get enabled skills in order
+     */
+    getEnabledSkills(config: RulebookConfig): Promise<Skill[]>;
+    /**
+     * Merge enabled skills into single content for AGENTS.md
+     */
+    mergeSkillsContent(config: RulebookConfig): Promise<string>;
+    /**
+     * Auto-detect skills based on project configuration
+     */
+    autoDetectSkills(config: Partial<RulebookConfig>): Promise<string[]>;
+    /**
+     * Create a new skill from template
+     */
+    createSkill(name: string, description: string, category: SkillCategory, content?: string): Promise<Skill>;
+    /**
+     * Get skills summary for display
+     */
+    getSkillsSummary(): Promise<{
+        total: number;
+        byCategory: Record<string, number>;
+        categories: SkillCategory[];
+    }>;
+}
+/**
+ * Create a new SkillsManager instance
+ */
+export declare function createSkillsManager(templatesPath: string, projectPath?: string): SkillsManager;
+/**
+ * Get the default templates path
+ */
+export declare function getDefaultTemplatesPath(): string;
+//# sourceMappingURL=skills-manager.d.ts.map

package/dist/core/skills/skills-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-manager.d.ts","sourceRoot":"","sources":["../../../src/core/skills/skills-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,cAAc,EACf,MAAM,gBAAgB,CAAC;AAmBxB;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG;IACtD,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd,CAmBA;AA6CD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CA4BxE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,aAAa,GACtB;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA+B9C;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAA4B;gBAEnC,aAAa,EAAE,MAAM,EAAE,YAAY,GAAE,MAAsB;IAMvE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IA8B5C;;OAEG;YACW,mBAAmB;IA+BjC;;OAEG;YACW,mBAAmB;IAoCjC;;OAEG;YACW,iBAAiB;IA2B/B;;OAEG;YACW,kBAAkB;IA4BhC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAOnC;;OAEG;IACG,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAOpE;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAKrD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAanD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAwCnF;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAsCpF;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA8E5E;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAuBhE;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCjE;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAoC1E;;OAEG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,MAAW,GACnB,OAAO,CAAC,KAAK,CAAC;IA8BjB;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,UAAU,EAAE,aAAa,EAAE,CAAC;KAC7B,CAAC;CAmBH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,CAE9F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD"}