@codemieai/code 0.0.32 → 0.0.34

package/dist/skills/core/types.d.ts

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+/**
+ * Zod schema for skill metadata (frontmatter)
+ */
+export declare const SkillMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    license: z.ZodOptional<z.ZodString>;
+    modes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    compatibility: z.ZodOptional<z.ZodObject<{
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        minVersion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    priority: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * TypeScript interface for skill metadata
+ */
+export type SkillMetadata = z.infer<typeof SkillMetadataSchema>;
+/**
+ * Source type for a skill
+ */
+export type SkillSource = 'global' | 'project' | 'mode-specific';
+/**
+ * Complete skill with metadata, content, and location info
+ */
+export interface Skill {
+    /** Parsed and validated metadata from YAML frontmatter */
+    metadata: SkillMetadata;
+    /** Markdown content (body after frontmatter) */
+    content: string;
+    /** Absolute path to the SKILL.md file */
+    filePath: string;
+    /** Where this skill was discovered from */
+    source: SkillSource;
+    /** Computed priority (source-based + metadata priority) */
+    computedPriority: number;
+}
+/**
+ * Result of parsing a skill file
+ */
+export interface SkillParseResult {
+    skill?: Skill;
+    error?: {
+        filePath: string;
+        message: string;
+        cause?: unknown;
+    };
+}
+/**
+ * Options for skill discovery
+ */
+export interface SkillDiscoveryOptions {
+    /** Working directory (for project-level skills) */
+    cwd?: string;
+    /** Filter by mode (e.g., 'code', 'architect') */
+    mode?: string;
+    /** Filter by agent name */
+    agentName?: string;
+    /** Force cache reload */
+    forceReload?: boolean;
+}
+/**
+ * Validation result for a skill
+ */
+export interface SkillValidationResult {
+    valid: boolean;
+    filePath: string;
+    skillName?: string;
+    errors: string[];
+}
+/**
+ * Configuration for skills in agent config
+ */
+export interface SkillsConfig {
+    /** Enable/disable skill loading */
+    enabled?: boolean;
+    /** Mode for mode-specific skills */
+    mode?: string;
+    /** Auto-reload on file changes (future feature) */
+    autoReload?: boolean;
+}
+/**
+ * Skill pattern detected in a message
+ */
+export interface SkillPattern {
+    /** Skill name (e.g., 'mr', 'commit') */
+    name: string;
+    /** Position in message where pattern starts */
+    position: number;
+    /** Optional arguments after skill name */
+    args?: string;
+    /** Full matched pattern (e.g., '/mr', '/commit -m "fix"') */
+    raw: string;
+}
+/**
+ * Result of pattern matching
+ */
+export interface PatternMatchResult {
+    /** Detected skill patterns */
+    patterns: SkillPattern[];
+    /** Original message */
+    originalMessage: string;
+    /** Whether any patterns were found */
+    hasPatterns: boolean;
+}
+/**
+ * Skill with file inventory
+ */
+export interface SkillWithInventory {
+    /** Base skill metadata and content */
+    skill: Skill;
+    /** Relative file paths (excluding SKILL.md) */
+    files: string[];
+    /** Formatted content ready for prompt injection */
+    formattedContent: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/skills/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAc9B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,0DAA0D;IAC1D,QAAQ,EAAE,aAAa,CAAC;IAExB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,MAAM,EAAE,WAAW,CAAC;IAEpB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yBAAyB;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,+CAA+C;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/skills/core/types.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+/**
+ * Zod schema for skill metadata (frontmatter)
+ */
+export const SkillMetadataSchema = z.object({
+    name: z.string().min(1, 'Skill name is required'),
+    description: z.string().min(1, 'Skill description is required'),
+    version: z.string().optional(),
+    author: z.string().optional(),
+    license: z.string().optional(),
+    modes: z.array(z.string()).optional(),
+    compatibility: z
+        .object({
+        agents: z.array(z.string()).optional(),
+        minVersion: z.string().optional(),
+    })
+        .optional(),
+    priority: z.number().default(0),
+});
+//# sourceMappingURL=types.js.map

package/dist/skills/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/skills/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC;IAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC;SACb,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;SACD,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAChC,CAAC,CAAC"}

package/dist/skills/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Skills System - Public API
+ *
+ * Provides skill discovery, loading, and management for CodeMie agents.
+ */
+export { SkillManager } from './core/SkillManager.js';
+export { SkillDiscovery } from './core/SkillDiscovery.js';
+export type { Skill, SkillMetadata, SkillSource, SkillParseResult, SkillDiscoveryOptions, SkillValidationResult, SkillsConfig, } from './core/types.js';
+export { SkillMetadataSchema } from './core/types.js';
+export { parseFrontmatter, hasFrontmatter, extractMetadata, extractContent, FrontmatterParseError, } from './utils/frontmatter.js';
+export type { FrontmatterResult } from './utils/frontmatter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,YAAY,EACV,KAAK,EACL,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,12 @@
+/**
+ * Skills System - Public API
+ *
+ * Provides skill discovery, loading, and management for CodeMie agents.
+ */
+// Core exports
+export { SkillManager } from './core/SkillManager.js';
+export { SkillDiscovery } from './core/SkillDiscovery.js';
+export { SkillMetadataSchema } from './core/types.js';
+// Utility exports
+export { parseFrontmatter, hasFrontmatter, extractMetadata, extractContent, FrontmatterParseError, } from './utils/frontmatter.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAY1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,kBAAkB;AAClB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/skills/utils/content-loader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Content loader for skill files and inventory
+ *
+ * Loads skill content and builds file inventories for pattern-based invocation.
+ */
+import type { Skill } from '../core/types.js';
+/**
+ * Skill with file inventory
+ */
+export interface SkillWithInventory {
+    /** Base skill metadata and content */
+    skill: Skill;
+    /** Relative file paths (excluding SKILL.md) */
+    files: string[];
+    /** Formatted content ready for prompt injection */
+    formattedContent: string;
+}
+/**
+ * Load a skill with its file inventory
+ *
+ * @param skill - Skill to load inventory for
+ * @returns Skill with file inventory and formatted content
+ */
+export declare function loadSkillWithInventory(skill: Skill): Promise<SkillWithInventory>;
+//# sourceMappingURL=content-loader.d.ts.map

package/dist/skills/utils/content-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-loader.d.ts","sourceRoot":"","sources":["../../../src/skills/utils/content-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,+CAA+C;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AA4BD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,kBAAkB,CAAC,CAe7B"}

package/dist/skills/utils/content-loader.js

@@ -0,0 +1,161 @@
+/**
+ * Content loader for skill files and inventory
+ *
+ * Loads skill content and builds file inventories for pattern-based invocation.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../../utils/logger.js';
+/**
+ * File extensions to include in inventory
+ */
+const INCLUDED_EXTENSIONS = new Set([
+    '.md',
+    '.sh',
+    '.js',
+    '.ts',
+    '.py',
+    '.json',
+    '.yaml',
+    '.yml',
+    '.toml',
+    '.txt',
+]);
+/**
+ * Directories to exclude from inventory
+ */
+const EXCLUDED_DIRS = new Set(['node_modules', '.git', 'dist', 'build']);
+/**
+ * Maximum depth for file scanning (prevent infinite loops)
+ */
+const MAX_DEPTH = 5;
+/**
+ * Load a skill with its file inventory
+ *
+ * @param skill - Skill to load inventory for
+ * @returns Skill with file inventory and formatted content
+ */
+export async function loadSkillWithInventory(skill) {
+    // Get skill directory from SKILL.md path
+    const skillDirectory = path.dirname(skill.filePath);
+    // Build file inventory
+    const files = await buildFileInventory(skillDirectory);
+    // Format content for injection
+    const formattedContent = formatSkillContent(skill, files);
+    return {
+        skill,
+        files,
+        formattedContent,
+    };
+}
+/**
+ * Build file inventory for a skill directory
+ *
+ * @param skillDirectoryPath - Absolute path to skill directory
+ * @returns Array of relative file paths (sorted alphabetically)
+ */
+async function buildFileInventory(skillDirectoryPath) {
+    const files = [];
+    try {
+        // Check if directory exists
+        if (!fs.existsSync(skillDirectoryPath)) {
+            logger.warn(`Skill directory not found: ${skillDirectoryPath}`);
+            return [];
+        }
+        // Scan directory recursively
+        await scanDirectory(skillDirectoryPath, skillDirectoryPath, files, 0);
+        // Sort alphabetically for consistent output
+        files.sort();
+        return files;
+    }
+    catch (error) {
+        logger.warn(`Failed to build file inventory for ${skillDirectoryPath}:`, error);
+        return [];
+    }
+}
+/**
+ * Recursively scan a directory for files
+ *
+ * @param basePath - Base skill directory path
+ * @param currentPath - Current directory being scanned
+ * @param files - Accumulator for discovered files
+ * @param depth - Current recursion depth
+ */
+async function scanDirectory(basePath, currentPath, files, depth) {
+    // Prevent infinite loops
+    if (depth >= MAX_DEPTH) {
+        return;
+    }
+    try {
+        const entries = await fs.promises.readdir(currentPath, {
+            withFileTypes: true,
+        });
+        for (const entry of entries) {
+            const fullPath = path.join(currentPath, entry.name);
+            // Skip hidden files/directories
+            if (entry.name.startsWith('.')) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                // Skip excluded directories
+                if (EXCLUDED_DIRS.has(entry.name)) {
+                    continue;
+                }
+                // Recurse into subdirectory
+                await scanDirectory(basePath, fullPath, files, depth + 1);
+            }
+            else if (entry.isFile()) {
+                // Skip SKILL.md (already loaded)
+                if (entry.name === 'SKILL.md') {
+                    continue;
+                }
+                // Check file extension
+                const ext = path.extname(entry.name);
+                if (INCLUDED_EXTENSIONS.has(ext)) {
+                    // Store relative path
+                    const relativePath = path.relative(basePath, fullPath);
+                    files.push(relativePath);
+                }
+            }
+            // Skip symbolic links (avoid loops)
+        }
+    }
+    catch (error) {
+        // Permission errors or other issues - log and continue
+        logger.debug(`Failed to scan directory ${currentPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Format skill content for prompt injection
+ *
+ * @param skill - Skill to format
+ * @param files - File inventory
+ * @returns Formatted markdown content
+ */
+function formatSkillContent(skill, files) {
+    const parts = [];
+    // Header
+    parts.push(`## Skill: ${skill.metadata.name}`);
+    parts.push('');
+    parts.push(skill.metadata.description);
+    parts.push('');
+    // Skill content
+    parts.push('### SKILL.md Content');
+    parts.push('');
+    parts.push(skill.content);
+    parts.push('');
+    // File inventory (if any)
+    if (files.length > 0) {
+        parts.push('### Available Files');
+        parts.push('');
+        parts.push('The following files are available in this skill directory.');
+        parts.push('Use the Read tool to access their content when needed:');
+        parts.push('');
+        for (const file of files) {
+            parts.push(`- ${file}`);
+        }
+        parts.push('');
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=content-loader.js.map

package/dist/skills/utils/content-loader.js.map

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

package/dist/skills/utils/frontmatter.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Result of parsing frontmatter from a markdown file
+ */
+export interface FrontmatterResult<T = Record<string, unknown>> {
+    /** Parsed metadata from YAML frontmatter */
+    metadata: T;
+    /** Markdown content (body after frontmatter) */
+    content: string;
+}
+/**
+ * Error thrown when frontmatter parsing fails
+ */
+export declare class FrontmatterParseError extends Error {
+    readonly filePath?: string | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, filePath?: string | undefined, cause?: unknown | undefined);
+}
+/**
+ * Parse YAML frontmatter from a markdown file
+ *
+ * Expected format:
+ * ```
+ * ---
+ * key: value
+ * ---
+ * Content here
+ * ```
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Parsed frontmatter metadata and markdown content
+ * @throws FrontmatterParseError if parsing fails
+ */
+export declare function parseFrontmatter<T = Record<string, unknown>>(fileContent: string, filePath?: string): FrontmatterResult<T>;
+/**
+ * Check if a file has valid frontmatter format (non-throwing)
+ *
+ * @param fileContent - Raw file content
+ * @returns true if file has valid frontmatter structure
+ */
+export declare function hasFrontmatter(fileContent: string): boolean;
+/**
+ * Extract just the metadata without validating content
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Parsed metadata
+ * @throws FrontmatterParseError if parsing fails
+ */
+export declare function extractMetadata<T = Record<string, unknown>>(fileContent: string, filePath?: string): T;
+/**
+ * Extract just the content without validating metadata
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Markdown content
+ * @throws FrontmatterParseError if parsing fails
+ */
+export declare function extractContent(fileContent: string, filePath?: string): string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/skills/utils/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/skills/utils/frontmatter.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,4CAA4C;IAC5C,QAAQ,EAAE,CAAC,CAAC;IAEZ,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,QAAQ,CAAC,EAAE,MAAM;aACjB,KAAK,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,iBAAiB,CAAC,CAAC,CAAC,CA8DtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,CAAC,CAGH;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7E"}

package/dist/skills/utils/frontmatter.js

@@ -0,0 +1,114 @@
+import { parse as parseYaml } from 'yaml';
+/**
+ * Error thrown when frontmatter parsing fails
+ */
+export class FrontmatterParseError extends Error {
+    filePath;
+    cause;
+    constructor(message, filePath, cause) {
+        super(message);
+        this.filePath = filePath;
+        this.cause = cause;
+        this.name = 'FrontmatterParseError';
+    }
+}
+/**
+ * Parse YAML frontmatter from a markdown file
+ *
+ * Expected format:
+ * ```
+ * ---
+ * key: value
+ * ---
+ * Content here
+ * ```
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Parsed frontmatter metadata and markdown content
+ * @throws FrontmatterParseError if parsing fails
+ */
+export function parseFrontmatter(fileContent, filePath) {
+    // Trim leading/trailing whitespace
+    const trimmed = fileContent.trim();
+    // Check if file starts with frontmatter delimiter
+    if (!trimmed.startsWith('---')) {
+        throw new FrontmatterParseError('File must start with frontmatter delimiter (---)', filePath);
+    }
+    // Find the closing delimiter
+    const lines = trimmed.split('\n');
+    let closingDelimiterIndex = -1;
+    // Start from line 1 (skip opening ---)
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            closingDelimiterIndex = i;
+            break;
+        }
+    }
+    if (closingDelimiterIndex === -1) {
+        throw new FrontmatterParseError('Missing closing frontmatter delimiter (---)', filePath);
+    }
+    // Extract YAML content (between delimiters)
+    const yamlLines = lines.slice(1, closingDelimiterIndex);
+    const yamlContent = yamlLines.join('\n');
+    // Extract markdown content (after closing delimiter)
+    const contentLines = lines.slice(closingDelimiterIndex + 1);
+    const content = contentLines.join('\n').trim();
+    // Parse YAML
+    let metadata;
+    try {
+        const parsed = parseYaml(yamlContent);
+        // Ensure we got an object
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            throw new Error('Frontmatter must be a YAML object (key-value pairs)');
+        }
+        metadata = parsed;
+    }
+    catch (error) {
+        throw new FrontmatterParseError(`Failed to parse YAML frontmatter: ${error instanceof Error ? error.message : String(error)}`, filePath, error);
+    }
+    return {
+        metadata,
+        content,
+    };
+}
+/**
+ * Check if a file has valid frontmatter format (non-throwing)
+ *
+ * @param fileContent - Raw file content
+ * @returns true if file has valid frontmatter structure
+ */
+export function hasFrontmatter(fileContent) {
+    try {
+        parseFrontmatter(fileContent);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Extract just the metadata without validating content
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Parsed metadata
+ * @throws FrontmatterParseError if parsing fails
+ */
+export function extractMetadata(fileContent, filePath) {
+    const result = parseFrontmatter(fileContent, filePath);
+    return result.metadata;
+}
+/**
+ * Extract just the content without validating metadata
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Markdown content
+ * @throws FrontmatterParseError if parsing fails
+ */
+export function extractContent(fileContent, filePath) {
+    const result = parseFrontmatter(fileContent, filePath);
+    return result.content;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/skills/utils/frontmatter.js.map

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

package/dist/skills/utils/pattern-matcher.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Pattern matcher for skill invocation detection
+ *
+ * Detects /skill-name patterns in user messages and extracts skill names.
+ * Excludes URLs and built-in CLI commands.
+ */
+/**
+ * Skill pattern detected in a message
+ */
+export interface SkillPattern {
+    /** Skill name (e.g., 'mr', 'commit') */
+    name: string;
+    /** Position in message where pattern starts */
+    position: number;
+    /** Optional arguments after skill name */
+    args?: string;
+    /** Full matched pattern (e.g., '/mr', '/commit -m "fix"') */
+    raw: string;
+}
+/**
+ * Result of pattern matching
+ */
+export interface PatternMatchResult {
+    /** Detected skill patterns */
+    patterns: SkillPattern[];
+    /** Original message */
+    originalMessage: string;
+    /** Whether any patterns were found */
+    hasPatterns: boolean;
+}
+/**
+ * Extract skill patterns from a user message
+ *
+ * @param message - User message to scan
+ * @returns Pattern match result with detected skills
+ *
+ * @example
+ * ```typescript
+ * const result = extractSkillPatterns('/mr');
+ * // result.patterns = [{ name: 'mr', position: 0, raw: '/mr' }]
+ *
+ * const result2 = extractSkillPatterns('ensure you can /commit this');
+ * // result2.patterns = [{ name: 'commit', position: 15, args: 'this', raw: '/commit this' }]
+ * ```
+ */
+export declare function extractSkillPatterns(message: string): PatternMatchResult;
+/**
+ * Validate a skill name
+ *
+ * @param name - Skill name to validate
+ * @returns True if valid, false otherwise
+ *
+ * Rules:
+ * - Lowercase letters only
+ * - Can include digits and hyphens
+ * - Must start with a letter
+ * - 1-50 characters
+ */
+export declare function isValidSkillName(name: string): boolean;
+//# sourceMappingURL=pattern-matcher.d.ts.map

package/dist/skills/utils/pattern-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.d.ts","sourceRoot":"","sources":["../../../src/skills/utils/pattern-matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,WAAW,EAAE,OAAO,CAAC;CACtB;AAyBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA8CxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}