agentic-skill-mill 1.0.3

package/dist/core/scaffold.js

@@ -0,0 +1,168 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { AppError } from '../errors/types.js';
+export async function scaffold(options) {
+    const { kind, name, cwd } = options;
+    const warnings = [];
+    // Validate name
+    if (name !== name.toLowerCase()) {
+        throw new AppError(`Name must be lowercase: "${name}"`, 'VALIDATION_ERROR');
+    }
+    if (/\s/.test(name)) {
+        throw new AppError(`Name must not contain spaces: "${name}"`, 'VALIDATION_ERROR');
+    }
+    if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+        throw new AppError(`Name must be lowercase kebab-case: "${name}"`, 'VALIDATION_ERROR');
+    }
+    switch (kind) {
+        case 'command':
+            return scaffoldCommand(name, cwd, warnings);
+        case 'skill':
+            return scaffoldSkill(name, cwd, options.description, warnings);
+        case 'fragment':
+            return scaffoldFragment(name, cwd, options.category ?? 'domain', warnings);
+        default:
+            throw new AppError(`Unknown scaffold kind: "${kind}"`, 'VALIDATION_ERROR');
+    }
+}
+function toPascalCase(kebab) {
+    return kebab.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join('');
+}
+function toCamelCase(kebab) {
+    const pascal = toPascalCase(kebab);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+async function scaffoldCommand(name, cwd, warnings) {
+    const pascal = toPascalCase(name);
+    const camel = toCamelCase(name);
+    const coreContent = `export interface ${pascal}Options {
+  cwd: string;
+}
+
+export interface ${pascal}Result {
+  warnings: string[];
+}
+
+export async function ${camel}(options: ${pascal}Options): Promise<${pascal}Result> {
+  const warnings: string[] = [];
+
+  // TODO: implement domain logic
+
+  return { warnings };
+}
+`;
+    const commandContent = `import { ${camel}, type ${pascal}Options, type ${pascal}Result } from '../../core/${name}.js';
+
+export interface ${pascal}CommandOptions extends ${pascal}Options {
+  json: boolean;
+}
+
+export async function ${camel}Command(
+  options: ${pascal}CommandOptions,
+): Promise<${pascal}Result> {
+  return ${camel}({
+    cwd: options.cwd,
+  });
+}
+`;
+    // Check for existing files
+    const corePath = path.join(cwd, 'src', 'core', `${name}.ts`);
+    const cmdPath = path.join(cwd, 'src', 'cli', 'commands', `${name}.ts`);
+    try {
+        await fs.access(corePath);
+        warnings.push(`Core module already exists: src/core/${name}.ts`);
+    }
+    catch { /* does not exist, good */ }
+    try {
+        await fs.access(cmdPath);
+        warnings.push(`Command wrapper already exists: src/cli/commands/${name}.ts`);
+    }
+    catch { /* does not exist, good */ }
+    return {
+        kind: 'command',
+        name,
+        files: [
+            { path: `src/core/${name}.ts`, content: coreContent, action: 'create' },
+            { path: `src/cli/commands/${name}.ts`, content: commandContent, action: 'create' },
+        ],
+        instructions: [
+            `Wire the command into src/cli/index.ts`,
+            `Export the public API from src/index.ts`,
+            `Run: npm run build && node dist/cli/index.js ${name} --help`,
+        ],
+        warnings,
+    };
+}
+async function scaffoldSkill(name, cwd, description, warnings) {
+    const desc = description ?? `Skill description for ${name}. Update this.`;
+    const skillContent = `---
+name: ${name}
+description: "${desc}"
+---
+
+# ${toPascalCase(name).replace(/([A-Z])/g, ' $1').trim()}
+
+${desc}
+
+---
+
+## Section Name
+
+Direct content here, or use fragment includes:
+
+---
+
+## Another Section
+
+More content.
+`;
+    const skillDir = path.join(cwd, 'skill', 'skills', name);
+    try {
+        await fs.access(skillDir);
+        warnings.push(`Skill directory already exists: skill/skills/${name}/`);
+    }
+    catch { /* does not exist, good */ }
+    return {
+        kind: 'skill',
+        name,
+        files: [
+            { path: `skill/skills/${name}/${name}.md`, content: skillContent, action: 'create' },
+        ],
+        instructions: [
+            `Add skill entry to skill/build/manifest.json`,
+            `Add "${name}" to the SKILLS array in install.sh`,
+            `Run: npm run compile`,
+        ],
+        warnings,
+    };
+}
+async function scaffoldFragment(name, cwd, category, warnings) {
+    const validCategories = ['common', 'domain', 'meta'];
+    if (!validCategories.includes(category)) {
+        warnings.push(`Category "${category}" is non-standard. Conventional categories: ${validCategories.join(', ')}`);
+    }
+    const fragmentContent = `### ${toPascalCase(name).replace(/([A-Z])/g, ' $1').trim()}
+
+Content for the ${name} fragment. Replace this with actual knowledge.
+`;
+    const fragPath = path.join(cwd, 'skill', 'fragments', category, `${name}.md`);
+    try {
+        await fs.access(fragPath);
+        warnings.push(`Fragment already exists: skill/fragments/${category}/${name}.md`);
+    }
+    catch { /* does not exist, good */ }
+    return {
+        kind: 'fragment',
+        name,
+        files: [
+            { path: `skill/fragments/${category}/${name}.md`, content: fragmentContent, action: 'create' },
+        ],
+        instructions: [
+            `Include in a skill source with: {{include:${category}/${name}.md}}`,
+            `Declare in manifest.json under the skill's "fragments" array`,
+            `Run: npm run compile`,
+        ],
+        warnings,
+    };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/core/scaffold.js.map

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

package/dist/core/validate-manifest.d.ts

@@ -0,0 +1,21 @@
+export interface ValidateManifestOptions {
+    manifestPath: string;
+}
+export interface ManifestIssue {
+    severity: 'error' | 'warning';
+    rule: string;
+    message: string;
+}
+export interface ValidateManifestResult {
+    manifestPath: string;
+    valid: boolean;
+    issues: ManifestIssue[];
+    stats: {
+        skills: number;
+        fragments: number;
+        targets: number;
+    };
+    warnings: string[];
+}
+export declare function validateManifest(options: ValidateManifestOptions): Promise<ValidateManifestResult>;
+//# sourceMappingURL=validate-manifest.d.ts.map

package/dist/core/validate-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-manifest.d.ts","sourceRoot":"","sources":["../../src/core/validate-manifest.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAsBD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAmJxG"}

package/dist/core/validate-manifest.js

@@ -0,0 +1,151 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { ConfigError, NotFoundError } from '../errors/types.js';
+const KNOWN_TARGETS = [
+    'claude', 'cursor-rules', 'cursor-skills',
+    'windsurf-rules', 'windsurf-skills', 'opencode', 'codex',
+];
+export async function validateManifest(options) {
+    const { manifestPath } = options;
+    const issues = [];
+    const warnings = [];
+    let raw;
+    try {
+        raw = await fs.readFile(manifestPath, 'utf-8');
+    }
+    catch {
+        throw new NotFoundError('manifest', manifestPath, 'File does not exist or is not readable');
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new ConfigError('Invalid JSON', manifestPath, e instanceof Error ? e : undefined);
+    }
+    // Required top-level keys
+    if (!manifest.targets || !Array.isArray(manifest.targets)) {
+        issues.push({ severity: 'error', rule: 'missing-targets', message: 'Missing or invalid "targets" array' });
+    }
+    if (!manifest.skills || typeof manifest.skills !== 'object') {
+        issues.push({ severity: 'error', rule: 'missing-skills', message: 'Missing or invalid "skills" object' });
+    }
+    if (!manifest.naming_rules || typeof manifest.naming_rules !== 'object') {
+        issues.push({ severity: 'warning', rule: 'missing-naming-rules', message: 'Missing "naming_rules" object' });
+    }
+    if (issues.some(i => i.rule === 'missing-skills')) {
+        return {
+            manifestPath,
+            valid: false,
+            issues,
+            stats: { skills: 0, fragments: 0, targets: 0 },
+            warnings,
+        };
+    }
+    // Validate targets
+    for (const target of manifest.targets ?? []) {
+        if (!KNOWN_TARGETS.includes(target)) {
+            issues.push({
+                severity: 'warning',
+                rule: 'unknown-target',
+                message: `Unknown target "${target}". Known: ${KNOWN_TARGETS.join(', ')}`,
+            });
+        }
+    }
+    const skillRoot = path.dirname(path.dirname(manifestPath));
+    const fragmentsDir = path.join(skillRoot, 'fragments');
+    const allFragments = new Set();
+    // Validate each skill
+    for (const [skillName, skillDef] of Object.entries(manifest.skills)) {
+        // Naming validation
+        if (skillName !== skillName.toLowerCase()) {
+            issues.push({ severity: 'error', rule: 'name-case', message: `Skill name not lowercase: "${skillName}"` });
+        }
+        if (/\s/.test(skillName)) {
+            issues.push({ severity: 'error', rule: 'name-spaces', message: `Skill name contains spaces: "${skillName}"` });
+        }
+        if (manifest.naming_rules?.forbidden_suffixes) {
+            for (const suffix of manifest.naming_rules.forbidden_suffixes) {
+                if (skillName.endsWith(`-${suffix}`) || skillName === suffix) {
+                    issues.push({ severity: 'error', rule: 'name-forbidden-suffix', message: `Skill "${skillName}" uses forbidden suffix "${suffix}"` });
+                }
+            }
+        }
+        // Source file exists
+        if (!skillDef.source) {
+            issues.push({ severity: 'error', rule: 'missing-source', message: `Skill "${skillName}" has no "source" field` });
+        }
+        else {
+            const sourcePath = path.join(skillRoot, skillDef.source);
+            try {
+                await fs.access(sourcePath);
+            }
+            catch {
+                issues.push({ severity: 'error', rule: 'source-not-found', message: `Source file not found: ${skillDef.source}` });
+            }
+        }
+        // Fragments exist
+        if (!Array.isArray(skillDef.fragments)) {
+            issues.push({ severity: 'warning', rule: 'missing-fragments-array', message: `Skill "${skillName}" has no "fragments" array` });
+        }
+        else {
+            for (const frag of skillDef.fragments) {
+                allFragments.add(frag);
+                const fragPath = path.join(fragmentsDir, frag);
+                try {
+                    await fs.access(fragPath);
+                }
+                catch {
+                    issues.push({ severity: 'error', rule: 'fragment-not-found', message: `Fragment not found: ${frag} (declared in "${skillName}")` });
+                }
+            }
+        }
+        // Cross-validate: check source includes match declared fragments
+        if (skillDef.source) {
+            const sourcePath = path.join(skillRoot, skillDef.source);
+            try {
+                const source = await fs.readFile(sourcePath, 'utf-8');
+                const includePattern = /\{\{include:([^}]+)\}\}/g;
+                const actualIncludes = new Set();
+                let match;
+                while ((match = includePattern.exec(source)) !== null) {
+                    actualIncludes.add(match[1].trim());
+                }
+                const declared = new Set(skillDef.fragments ?? []);
+                for (const inc of actualIncludes) {
+                    if (!declared.has(inc)) {
+                        issues.push({
+                            severity: 'error',
+                            rule: 'undeclared-include',
+                            message: `Undeclared fragment in "${skillName}": ${inc} (in source but not in manifest)`,
+                        });
+                    }
+                }
+                for (const dec of declared) {
+                    if (!actualIncludes.has(dec)) {
+                        issues.push({
+                            severity: 'warning',
+                            rule: 'unused-declared-fragment',
+                            message: `Unused declared fragment in "${skillName}": ${dec} (in manifest but not in source)`,
+                        });
+                    }
+                }
+            }
+            catch {
+                // Source not readable; already reported above
+            }
+        }
+    }
+    return {
+        manifestPath,
+        valid: issues.filter(i => i.severity === 'error').length === 0,
+        issues,
+        stats: {
+            skills: Object.keys(manifest.skills).length,
+            fragments: allFragments.size,
+            targets: (manifest.targets ?? []).length,
+        },
+        warnings,
+    };
+}
+//# sourceMappingURL=validate-manifest.js.map

package/dist/core/validate-manifest.js.map

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

package/dist/core/validate-skill.d.ts

@@ -0,0 +1,24 @@
+export interface ValidateSkillOptions {
+    skillPath: string;
+    fragmentsDir?: string;
+}
+export interface SkillIssue {
+    severity: 'error' | 'warning';
+    line: number;
+    rule: string;
+    message: string;
+}
+export interface ValidateSkillResult {
+    skillPath: string;
+    valid: boolean;
+    issues: SkillIssue[];
+    stats: {
+        includes: number;
+        sections: number;
+        wordCount: number;
+    };
+    frontmatter: Record<string, string>;
+    warnings: string[];
+}
+export declare function validateSkill(options: ValidateSkillOptions): Promise<ValidateSkillResult>;
+//# sourceMappingURL=validate-skill.d.ts.map

package/dist/core/validate-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-skill.d.ts","sourceRoot":"","sources":["../../src/core/validate-skill.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA0I/F"}

package/dist/core/validate-skill.js

@@ -0,0 +1,149 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { NotFoundError } from '../errors/types.js';
+export async function validateSkill(options) {
+    const { skillPath } = options;
+    const issues = [];
+    const warnings = [];
+    let content;
+    try {
+        content = await fs.readFile(skillPath, 'utf-8');
+    }
+    catch {
+        throw new NotFoundError('skill source', skillPath);
+    }
+    const lines = content.split('\n');
+    // Parse frontmatter
+    const frontmatter = {};
+    let bodyStart = 0;
+    if (lines[0] === '---') {
+        const endIdx = lines.indexOf('---', 1);
+        if (endIdx === -1) {
+            issues.push({ severity: 'error', line: 1, rule: 'frontmatter-unclosed', message: 'Frontmatter block is never closed' });
+        }
+        else {
+            bodyStart = endIdx + 1;
+            for (let i = 1; i < endIdx; i++) {
+                const colonIdx = lines[i].indexOf(':');
+                if (colonIdx === -1)
+                    continue;
+                const key = lines[i].slice(0, colonIdx).trim();
+                let val = lines[i].slice(colonIdx + 1).trim();
+                if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+                    val = val.slice(1, -1);
+                }
+                frontmatter[key] = val;
+            }
+        }
+    }
+    else {
+        issues.push({ severity: 'error', line: 1, rule: 'missing-frontmatter', message: 'Skill source must start with YAML frontmatter (---)' });
+    }
+    // Required frontmatter fields
+    if (!frontmatter.name) {
+        issues.push({ severity: 'error', line: 1, rule: 'missing-name', message: 'Frontmatter missing required "name" field' });
+    }
+    if (!frontmatter.description) {
+        issues.push({ severity: 'error', line: 1, rule: 'missing-description', message: 'Frontmatter missing required "description" field' });
+    }
+    // Name should be lowercase kebab-case
+    if (frontmatter.name && frontmatter.name !== frontmatter.name.toLowerCase()) {
+        issues.push({ severity: 'error', line: 1, rule: 'name-case', message: `Skill name must be lowercase: "${frontmatter.name}"` });
+    }
+    if (frontmatter.name && /\s/.test(frontmatter.name)) {
+        issues.push({ severity: 'error', line: 1, rule: 'name-spaces', message: `Skill name must not contain spaces: "${frontmatter.name}"` });
+    }
+    // Check body has an H1
+    const bodyLines = lines.slice(bodyStart);
+    const h1Line = bodyLines.findIndex(l => /^# /.test(l));
+    if (h1Line === -1) {
+        issues.push({ severity: 'warning', line: bodyStart + 1, rule: 'missing-h1', message: 'Skill body has no H1 heading' });
+    }
+    // Count sections (H2 headings)
+    let sections = 0;
+    for (let i = 0; i < bodyLines.length; i++) {
+        if (/^## /.test(bodyLines[i])) {
+            sections++;
+        }
+    }
+    if (sections === 0) {
+        issues.push({ severity: 'warning', line: bodyStart + 1, rule: 'no-sections', message: 'Skill body has no ## sections' });
+    }
+    // Collect and validate includes
+    const includePattern = /\{\{include:([^}]+)\}\}/g;
+    let match;
+    const includes = [];
+    for (let i = 0; i < lines.length; i++) {
+        includePattern.lastIndex = 0;
+        while ((match = includePattern.exec(lines[i])) !== null) {
+            includes.push({ path: match[1].trim(), line: i + 1 });
+        }
+    }
+    // Validate fragment files exist if fragmentsDir provided
+    // Default: walk up from skill path to find the fragments dir.
+    // Skills live at skill/skills/<name>/<name>.md, fragments at skill/fragments/
+    const fragmentsDir = options.fragmentsDir ?? findFragmentsDir(skillPath);
+    for (const inc of includes) {
+        const fragPath = path.join(fragmentsDir, inc.path);
+        try {
+            await fs.access(fragPath);
+        }
+        catch {
+            issues.push({
+                severity: 'error',
+                line: inc.line,
+                rule: 'fragment-not-found',
+                message: `Fragment file not found: ${inc.path}`,
+            });
+        }
+    }
+    // Check for duplicate includes
+    const seen = new Map();
+    for (const inc of includes) {
+        const prev = seen.get(inc.path);
+        if (prev !== undefined) {
+            issues.push({
+                severity: 'warning',
+                line: inc.line,
+                rule: 'duplicate-include',
+                message: `Duplicate include: ${inc.path} (first at line ${prev})`,
+            });
+        }
+        else {
+            seen.set(inc.path, inc.line);
+        }
+    }
+    // Word count of the body (excluding frontmatter and include markers)
+    const bodyText = bodyLines.join(' ')
+        .replace(/\{\{include:[^}]+\}\}/g, '')
+        .replace(/[#*`\-|]/g, ' ');
+    const wordCount = bodyText.split(/\s+/).filter(w => w.length > 0).length;
+    return {
+        skillPath,
+        valid: issues.filter(i => i.severity === 'error').length === 0,
+        issues,
+        stats: {
+            includes: includes.length,
+            sections,
+            wordCount,
+        },
+        frontmatter,
+        warnings,
+    };
+}
+function findFragmentsDir(skillPath) {
+    const resolved = path.resolve(skillPath);
+    // Walk up from the skill file to find a directory named "skill" that has a "fragments" child
+    let dir = path.dirname(resolved);
+    for (let i = 0; i < 6; i++) {
+        const candidate = path.join(dir, 'fragments');
+        const parentName = path.basename(dir);
+        if (parentName === 'skill') {
+            return candidate;
+        }
+        dir = path.dirname(dir);
+    }
+    // Fallback: two levels up from skill file
+    return path.join(path.dirname(path.dirname(resolved)), 'fragments');
+}
+//# sourceMappingURL=validate-skill.js.map

package/dist/core/validate-skill.js.map

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

package/dist/errors/types.d.ts

@@ -0,0 +1,19 @@
+export declare class AppError extends Error {
+    code: string;
+    context?: Record<string, unknown> | undefined;
+    constructor(message: string, code?: string, context?: Record<string, unknown> | undefined);
+    toJSON(): Record<string, unknown>;
+}
+export declare class NotFoundError extends AppError {
+    constructor(entity: string, identifier: string, context?: string);
+}
+export declare class CommandError extends AppError {
+    constructor(command: string, exitCode: number, stderr?: string);
+}
+export declare class CacheError extends AppError {
+    constructor(message: string, operation: 'read' | 'write' | 'clear', cause?: Error);
+}
+export declare class ConfigError extends AppError {
+    constructor(message: string, filePath?: string, cause?: Error);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/errors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IAGxB,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFxC,OAAO,EAAE,MAAM,EACR,IAAI,GAAE,MAAwB,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAO1C,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAOjE;AAED,qBAAa,YAAa,SAAQ,QAAQ;gBAEtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM;CAQlB;AAED,qBAAa,UAAW,SAAQ,QAAQ;gBAEpC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EACrC,KAAK,CAAC,EAAE,KAAK;CAQhB;AAED,qBAAa,WAAY,SAAQ,QAAQ;gBAErC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,KAAK;CAQhB"}

package/dist/errors/types.js

@@ -0,0 +1,40 @@
+export class AppError extends Error {
+    code;
+    context;
+    constructor(message, code = 'UNKNOWN_ERROR', context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            context: this.context,
+        };
+    }
+}
+export class NotFoundError extends AppError {
+    constructor(entity, identifier, context) {
+        super(`${entity} not found: ${identifier}${context ? ` in ${context}` : ''}`, 'NOT_FOUND_ERROR', { entity, identifier, context });
+    }
+}
+export class CommandError extends AppError {
+    constructor(command, exitCode, stderr) {
+        super(`Command failed: ${command} (exit code ${exitCode})${stderr ? `: ${stderr}` : ''}`, 'COMMAND_ERROR', { command, exitCode, stderr });
+    }
+}
+export class CacheError extends AppError {
+    constructor(message, operation, cause) {
+        super(`Cache ${operation} failed: ${message}`, 'CACHE_ERROR', { operation, cause: cause?.message });
+    }
+}
+export class ConfigError extends AppError {
+    constructor(message, filePath, cause) {
+        super(filePath ? `Config error in ${filePath}: ${message}` : `Config error: ${message}`, 'CONFIG_ERROR', { filePath, cause: cause?.message });
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/errors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGxB;IACA;IAHT,YACE,OAAe,EACR,OAAe,eAAe,EAC9B,OAAiC;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAA0B;QAC9B,YAAO,GAAP,OAAO,CAA0B;QAGxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YAAY,MAAc,EAAE,UAAkB,EAAE,OAAgB;QAC9D,KAAK,CACH,GAAG,MAAM,eAAe,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACtE,iBAAiB,EACjB,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAChC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YACE,OAAe,EACf,QAAgB,EAChB,MAAe;QAEf,KAAK,CACH,mBAAmB,OAAO,eAAe,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAClF,eAAe,EACf,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAC9B,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,QAAQ;IACtC,YACE,OAAe,EACf,SAAqC,EACrC,KAAa;QAEb,KAAK,CACH,SAAS,SAAS,YAAY,OAAO,EAAE,EACvC,aAAa,EACb,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CACrC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,YACE,OAAe,EACf,QAAiB,EACjB,KAAa;QAEb,KAAK,CACH,QAAQ,CAAC,CAAC,CAAC,mBAAmB,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,iBAAiB,OAAO,EAAE,EACjF,cAAc,EACd,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CACpC,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { validateManifest } from './core/validate-manifest.js';
+export type { ValidateManifestOptions, ValidateManifestResult, ManifestIssue } from './core/validate-manifest.js';
+export { validateSkill } from './core/validate-skill.js';
+export type { ValidateSkillOptions, ValidateSkillResult, SkillIssue } from './core/validate-skill.js';
+export { listProject } from './core/list-project.js';
+export type { ListProjectOptions, ListProjectResult, SkillInfo, FragmentInfo } from './core/list-project.js';
+export { scaffold } from './core/scaffold.js';
+export type { ScaffoldOptions, ScaffoldResult, ScaffoldFile, ScaffoldKind } from './core/scaffold.js';
+export { checkExports } from './core/check-exports.js';
+export type { CheckExportsOptions, CheckExportsResult, CoreModuleInfo, ExportIssue } from './core/check-exports.js';
+export { CacheManager } from './cache/cache-manager.js';
+export type { CacheEntry, CacheStats, CacheOptions } from './cache/cache-manager.js';
+export { AppError, NotFoundError, CommandError, CacheError, ConfigError, } from './errors/types.js';
+export { OutputFormatter } from './cli/output-formatter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAElH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtG,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE7G,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtG,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGpH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGrF,OAAO,EACL,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}