claude-flow-novice 2.15.2 → 2.15.4

package/dist/lib/skill-content-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/skill-content-manager.ts"],"sourcesContent":["/**\r\n * Skill Content Manager\r\n *\r\n * Manages standardized skill content storage, organization, and versioning\r\n * Enforces directory structure, validates required files, tracks versions\r\n *\r\n * @module skill-content-manager\r\n * @version 1.0.0\r\n */\r\n\r\nimport { join, basename, dirname } from 'path';\r\nimport { stat, readdir, access, chmod, readFile, writeFile, mkdir } from 'fs/promises';\r\nimport { constants } from 'fs';\r\nimport { StandardError } from './errors.js';\r\nimport {\r\n  SkillFrontmatter,\r\n  ParsedSkillDocument,\r\n  parseFrontmatter,\r\n  validateFrontmatter,\r\n  parseAndValidate,\r\n  updateFrontmatter,\r\n  createSkillDocument\r\n} from './skill-frontmatter-parser.js';\r\nimport {\r\n  calculateFileHash,\r\n  getCommitMetadata,\r\n  getVersionHistory,\r\n  commitFile,\r\n  hasUncommittedChanges,\r\n  verifyContentIntegrity,\r\n  getFileCreationDate,\r\n  getFileModificationDate,\r\n  GitCommitMetadata,\r\n  VersionHistoryEntry\r\n} from './skill-git-integration.js';\r\n\r\n/**\r\n * Required files in skill directory\r\n */\r\nexport const REQUIRED_SKILL_FILES = [\r\n  'SKILL.md',\r\n  'execute.sh',\r\n  'test.sh',\r\n  'validate.sh',\r\n  'package.json'\r\n] as const;\r\n\r\n/**\r\n * Skill directory structure validation result\r\n */\r\nexport interface SkillStructureValidation {\r\n  valid: boolean;\r\n  skillName: string;\r\n  skillPath: string;\r\n  missingFiles: string[];\r\n  invalidPermissions: string[];\r\n  errors: string[];\r\n  warnings: string[];\r\n}\r\n\r\n/**\r\n * Complete skill metadata including git info\r\n */\r\nexport interface SkillMetadata extends SkillFrontmatter {\r\n  skillPath: string;\r\n  contentHash: string;\r\n  gitMetadata?: GitCommitMetadata;\r\n  versionHistory?: VersionHistoryEntry[];\r\n  hasUncommittedChanges?: boolean;\r\n  fileCreated?: string;\r\n  fileModified?: string;\r\n}\r\n\r\n/**\r\n * Skill update options\r\n */\r\nexport interface SkillUpdateOptions {\r\n  autoCommit?: boolean;\r\n  commitMessage?: string;\r\n  updateTimestamp?: boolean;\r\n  validateStructure?: boolean;\r\n}\r\n\r\n/**\r\n * Skill content manager error\r\n */\r\nexport class SkillContentError extends StandardError {\r\n  constructor(message: string, public readonly context?: Record<string, unknown>) {\r\n    super('SKILL_CONTENT_ERROR', message, context);\r\n    this.name = 'SkillContentError';\r\n  }\r\n}\r\n\r\n/**\r\n * Validate skill directory structure\r\n *\r\n * @param skillPath - Path to skill directory\r\n * @returns Validation result with details\r\n */\r\nexport async function validateSkillStructure(\r\n  skillPath: string\r\n): Promise<SkillStructureValidation> {\r\n  const skillName = basename(skillPath);\r\n  const missingFiles: string[] = [];\r\n  const invalidPermissions: string[] = [];\r\n  const errors: string[] = [];\r\n  const warnings: string[] = [];\r\n\r\n  try {\r\n    // Check if directory exists\r\n    const dirStat = await stat(skillPath);\r\n    if (!dirStat.isDirectory()) {\r\n      errors.push(`${skillPath} is not a directory`);\r\n      return {\r\n        valid: false,\r\n        skillName,\r\n        skillPath,\r\n        missingFiles,\r\n        invalidPermissions,\r\n        errors,\r\n        warnings\r\n      };\r\n    }\r\n  } catch (error) {\r\n    errors.push(`Skill directory does not exist: ${skillPath}`);\r\n    return {\r\n      valid: false,\r\n      skillName,\r\n      skillPath,\r\n      missingFiles,\r\n      invalidPermissions,\r\n      errors,\r\n      warnings\r\n    };\r\n  }\r\n\r\n  // Check required files\r\n  for (const fileName of REQUIRED_SKILL_FILES) {\r\n    const filePath = join(skillPath, fileName);\r\n\r\n    try {\r\n      await access(filePath, constants.F_OK);\r\n\r\n      // Check execute permission for .sh files\r\n      if (fileName.endsWith('.sh')) {\r\n        try {\r\n          await access(filePath, constants.X_OK);\r\n        } catch {\r\n          invalidPermissions.push(fileName);\r\n          errors.push(`${fileName} is not executable`);\r\n        }\r\n      }\r\n    } catch {\r\n      missingFiles.push(fileName);\r\n      errors.push(`Required file missing: ${fileName}`);\r\n    }\r\n  }\r\n\r\n  // Validate SKILL.md frontmatter if exists\r\n  const skillMdPath = join(skillPath, 'SKILL.md');\r\n  try {\r\n    await access(skillMdPath, constants.F_OK);\r\n    const content = await readFile(skillMdPath, 'utf-8');\r\n\r\n    try {\r\n      const parsed = parseFrontmatter(content);\r\n      const validation = validateFrontmatter(parsed.frontmatter);\r\n\r\n      if (!validation.valid) {\r\n        errors.push(...validation.errors);\r\n      }\r\n\r\n      warnings.push(...validation.warnings);\r\n    } catch (error) {\r\n      errors.push(`SKILL.md frontmatter error: ${error instanceof Error ? error.message : String(error)}`);\r\n    }\r\n  } catch {\r\n    // Already reported as missing file\r\n  }\r\n\r\n  return {\r\n    valid: errors.length === 0,\r\n    skillName,\r\n    skillPath,\r\n    missingFiles,\r\n    invalidPermissions,\r\n    errors,\r\n    warnings\r\n  };\r\n}\r\n\r\n/**\r\n * Fix skill file permissions\r\n *\r\n * @param skillPath - Path to skill directory\r\n * @returns Array of files that were fixed\r\n */\r\nexport async function fixSkillPermissions(skillPath: string): Promise<string[]> {\r\n  const fixed: string[] = [];\r\n\r\n  for (const fileName of REQUIRED_SKILL_FILES) {\r\n    if (fileName.endsWith('.sh')) {\r\n      const filePath = join(skillPath, fileName);\r\n\r\n      try {\r\n        await access(filePath, constants.F_OK);\r\n        await chmod(filePath, 0o755); // rwxr-xr-x\r\n        fixed.push(fileName);\r\n      } catch {\r\n        // File doesn't exist, skip\r\n      }\r\n    }\r\n  }\r\n\r\n  return fixed;\r\n}\r\n\r\n/**\r\n * Load skill metadata with git integration\r\n *\r\n * @param skillPath - Path to skill directory\r\n * @param includeHistory - Include version history (default: false)\r\n * @returns Complete skill metadata\r\n */\r\nexport async function loadSkillMetadata(\r\n  skillPath: string,\r\n  includeHistory: boolean = false\r\n): Promise<SkillMetadata> {\r\n  const skillMdPath = join(skillPath, 'SKILL.md');\r\n\r\n  try {\r\n    // Read and parse SKILL.md\r\n    const content = await readFile(skillMdPath, 'utf-8');\r\n    const parsed = parseAndValidate(content);\r\n\r\n    // Calculate content hash\r\n    const contentHash = calculateFileHash(skillMdPath);\r\n\r\n    // Get git metadata (graceful fallback if not in git repo)\r\n    let gitMetadata: GitCommitMetadata | undefined;\r\n    let versionHistory: VersionHistoryEntry[] | undefined;\r\n    let hasChanges: boolean | undefined;\r\n    let fileCreated: string | undefined;\r\n    let fileModified: string | undefined;\r\n\r\n    try {\r\n      gitMetadata = await getCommitMetadata(skillMdPath);\r\n      hasChanges = await hasUncommittedChanges(skillMdPath);\r\n      fileCreated = await getFileCreationDate(skillMdPath);\r\n      fileModified = await getFileModificationDate(skillMdPath);\r\n\r\n      if (includeHistory) {\r\n        versionHistory = await getVersionHistory(skillMdPath);\r\n      }\r\n    } catch {\r\n      // Not in git repo or no git history - continue without git data\r\n    }\r\n\r\n    return {\r\n      ...parsed.frontmatter,\r\n      skillPath,\r\n      contentHash: await contentHash,\r\n      gitMetadata,\r\n      versionHistory,\r\n      hasUncommittedChanges: hasChanges,\r\n      fileCreated,\r\n      fileModified\r\n    };\r\n  } catch (error) {\r\n    throw new SkillContentError(\r\n      `Failed to load skill metadata from ${skillPath}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Update skill frontmatter\r\n *\r\n * @param skillPath - Path to skill directory\r\n * @param updates - Partial frontmatter updates\r\n * @param options - Update options\r\n * @returns Updated skill metadata\r\n */\r\nexport async function updateSkillFrontmatter(\r\n  skillPath: string,\r\n  updates: Partial<SkillFrontmatter>,\r\n  options: SkillUpdateOptions = {}\r\n): Promise<SkillMetadata> {\r\n  const {\r\n    autoCommit = false,\r\n    commitMessage,\r\n    updateTimestamp = true,\r\n    validateStructure = true\r\n  } = options;\r\n\r\n  const skillMdPath = join(skillPath, 'SKILL.md');\r\n\r\n  try {\r\n    // Validate structure first if requested\r\n    if (validateStructure) {\r\n      const validation = await validateSkillStructure(skillPath);\r\n      if (!validation.valid) {\r\n        throw new SkillContentError('Skill structure validation failed', {\r\n          errors: validation.errors\r\n        });\r\n      }\r\n    }\r\n\r\n    // Read current content\r\n    const currentContent = await readFile(skillMdPath, 'utf-8');\r\n\r\n    // Update frontmatter\r\n    const updatedContent = updateFrontmatter(currentContent, updates);\r\n\r\n    // Write updated content\r\n    await writeFile(skillMdPath, updatedContent, 'utf-8');\r\n\r\n    // Auto-commit if requested\r\n    if (autoCommit) {\r\n      const message = commitMessage || `Update ${basename(skillPath)} frontmatter`;\r\n      await commitFile(skillMdPath, message);\r\n    }\r\n\r\n    // Return updated metadata\r\n    return await loadSkillMetadata(skillPath);\r\n  } catch (error) {\r\n    throw new SkillContentError(\r\n      `Failed to update skill frontmatter for ${skillPath}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Create new skill directory with standard structure\r\n *\r\n * @param parentDir - Parent directory for skills\r\n * @param skillName - Name of skill to create\r\n * @param frontmatter - Initial frontmatter\r\n * @param content - Initial SKILL.md content\r\n * @returns Created skill metadata\r\n */\r\nexport async function createSkill(\r\n  parentDir: string,\r\n  skillName: string,\r\n  frontmatter: SkillFrontmatter,\r\n  content: string = ''\r\n): Promise<SkillMetadata> {\r\n  const skillPath = join(parentDir, skillName);\r\n\r\n  try {\r\n    // Create skill directory\r\n    await mkdir(skillPath, { recursive: true });\r\n\r\n    // Create SKILL.md\r\n    const skillMdPath = join(skillPath, 'SKILL.md');\r\n    const skillDocument = createSkillDocument(frontmatter, content);\r\n    await writeFile(skillMdPath, skillDocument, 'utf-8');\r\n\r\n    // Create placeholder files\r\n    const executeSh = `#!/bin/bash\r\n# ${frontmatter.name} - Execution Script\r\n# Version: ${frontmatter.version}\r\n\r\nset -euo pipefail\r\n\r\necho \"Executing ${frontmatter.name}...\"\r\n# Add implementation here\r\n`;\r\n\r\n    const testSh = `#!/bin/bash\r\n# ${frontmatter.name} - Test Script\r\n# Version: ${frontmatter.version}\r\n\r\nset -euo pipefail\r\n\r\necho \"Testing ${frontmatter.name}...\"\r\n# Add tests here\r\n`;\r\n\r\n    const validateSh = `#!/bin/bash\r\n# ${frontmatter.name} - Validation Script\r\n# Version: ${frontmatter.version}\r\n\r\nset -euo pipefail\r\n\r\necho \"Validating ${frontmatter.name}...\"\r\n# Add validation here\r\n`;\r\n\r\n    const packageJson = {\r\n      name: skillName,\r\n      version: frontmatter.version,\r\n      description: frontmatter.description,\r\n      scripts: {\r\n        execute: './execute.sh',\r\n        test: './test.sh',\r\n        validate: './validate.sh'\r\n      }\r\n    };\r\n\r\n    await writeFile(join(skillPath, 'execute.sh'), executeSh, 'utf-8');\r\n    await writeFile(join(skillPath, 'test.sh'), testSh, 'utf-8');\r\n    await writeFile(join(skillPath, 'validate.sh'), validateSh, 'utf-8');\r\n    await writeFile(join(skillPath, 'package.json'), JSON.stringify(packageJson, null, 2), 'utf-8');\r\n\r\n    // Fix permissions\r\n    await fixSkillPermissions(skillPath);\r\n\r\n    // Return metadata\r\n    return await loadSkillMetadata(skillPath);\r\n  } catch (error) {\r\n    throw new SkillContentError(\r\n      `Failed to create skill ${skillName}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Scan directory for all skills\r\n *\r\n * @param skillsDir - Path to skills directory\r\n * @returns Array of skill paths\r\n */\r\nexport async function scanSkills(skillsDir: string): Promise<string[]> {\r\n  try {\r\n    const entries = await readdir(skillsDir, { withFileTypes: true });\r\n    const skillPaths: string[] = [];\r\n\r\n    for (const entry of entries) {\r\n      if (entry.isDirectory()) {\r\n        const skillPath = join(skillsDir, entry.name);\r\n        const skillMdPath = join(skillPath, 'SKILL.md');\r\n\r\n        try {\r\n          await access(skillMdPath, constants.F_OK);\r\n          skillPaths.push(skillPath);\r\n        } catch {\r\n          // Not a valid skill directory, skip\r\n        }\r\n      }\r\n    }\r\n\r\n    return skillPaths.sort();\r\n  } catch (error) {\r\n    throw new SkillContentError(\r\n      `Failed to scan skills directory ${skillsDir}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Verify skill content integrity\r\n *\r\n * @param skillPath - Path to skill directory\r\n * @param expectedHash - Expected content hash\r\n * @returns True if content matches expected hash\r\n */\r\nexport async function verifySkillIntegrity(\r\n  skillPath: string,\r\n  expectedHash: string\r\n): Promise<boolean> {\r\n  const skillMdPath = join(skillPath, 'SKILL.md');\r\n  return await verifyContentIntegrity(skillMdPath, expectedHash);\r\n}\r\n"],"names":["join","basename","stat","readdir","access","chmod","readFile","writeFile","mkdir","constants","StandardError","parseFrontmatter","validateFrontmatter","parseAndValidate","updateFrontmatter","createSkillDocument","calculateFileHash","getCommitMetadata","getVersionHistory","commitFile","hasUncommittedChanges","verifyContentIntegrity","getFileCreationDate","getFileModificationDate","REQUIRED_SKILL_FILES","SkillContentError","message","context","name","validateSkillStructure","skillPath","skillName","missingFiles","invalidPermissions","errors","warnings","dirStat","isDirectory","push","valid","error","fileName","filePath","F_OK","endsWith","X_OK","skillMdPath","content","parsed","validation","frontmatter","Error","String","length","fixSkillPermissions","fixed","loadSkillMetadata","includeHistory","contentHash","gitMetadata","versionHistory","hasChanges","fileCreated","fileModified","updateSkillFrontmatter","updates","options","autoCommit","commitMessage","updateTimestamp","validateStructure","currentContent","updatedContent","createSkill","parentDir","recursive","skillDocument","executeSh","version","testSh","validateSh","packageJson","description","scripts","execute","test","validate","JSON","stringify","scanSkills","skillsDir","entries","withFileTypes","skillPaths","entry","sort","verifySkillIntegrity","expectedHash"],"mappings":"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"}

package/dist/lib/skill-frontmatter-parser.js

@@ -0,0 +1,237 @@
+/**
+ * Skill Frontmatter Parser
+ *
+ * Parses and validates YAML frontmatter in SKILL.md files
+ * Supports semantic versioning and comprehensive metadata tracking
+ *
+ * @module skill-frontmatter-parser
+ * @version 1.0.0
+ */ import * as yaml from 'js-yaml';
+import { StandardError } from './errors.js';
+/**
+ * Frontmatter parser error
+ */ export class FrontmatterParseError extends StandardError {
+    context;
+    constructor(message, context){
+        super('FRONTMATTER_PARSE_ERROR', message, context), this.context = context;
+        this.name = 'FrontmatterParseError';
+    }
+}
+/**
+ * Frontmatter validation error
+ */ export class FrontmatterValidationError extends StandardError {
+    errors;
+    constructor(message, errors){
+        super('FRONTMATTER_VALIDATION_ERROR', message, {
+            errors
+        }), this.errors = errors;
+        this.name = 'FrontmatterValidationError';
+    }
+}
+/**
+ * Semantic version regex pattern
+ */ const SEMVER_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+/**
+ * Valid skill status values
+ */ const VALID_STATUSES = [
+    'draft',
+    'approved',
+    'staging',
+    'deployed',
+    'deprecated'
+];
+/**
+ * Parse SKILL.md content and extract frontmatter
+ *
+ * @param content - Raw SKILL.md file content
+ * @returns Parsed document with frontmatter and content
+ * @throws FrontmatterParseError if parsing fails
+ */ export function parseFrontmatter(content) {
+    // Extract frontmatter block
+    const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+    if (!frontmatterMatch) {
+        throw new FrontmatterParseError('No frontmatter block found. SKILL.md must start with YAML frontmatter enclosed in ---');
+    }
+    const [, frontmatterYaml, markdownContent] = frontmatterMatch;
+    // Parse YAML
+    let frontmatter;
+    try {
+        frontmatter = yaml.load(frontmatterYaml);
+    } catch (error) {
+        throw new FrontmatterParseError('Failed to parse YAML frontmatter', {
+            error: error instanceof Error ? error.message : String(error),
+            yaml: frontmatterYaml.substring(0, 200)
+        });
+    }
+    // Validate structure
+    if (!frontmatter || typeof frontmatter !== 'object') {
+        throw new FrontmatterParseError('Frontmatter must be a valid YAML object');
+    }
+    return {
+        frontmatter: frontmatter,
+        content: markdownContent.trim(),
+        raw: content
+    };
+}
+/**
+ * Validate frontmatter against schema
+ *
+ * @param frontmatter - Frontmatter object to validate
+ * @returns Validation result with errors and warnings
+ */ export function validateFrontmatter(frontmatter) {
+    const errors = [];
+    const warnings = [];
+    // Required fields
+    if (!frontmatter.name || typeof frontmatter.name !== 'string') {
+        errors.push('Field "name" is required and must be a string');
+    }
+    if (!frontmatter.version || typeof frontmatter.version !== 'string') {
+        errors.push('Field "version" is required and must be a string');
+    } else if (!SEMVER_PATTERN.test(frontmatter.version)) {
+        errors.push(`Field "version" must be valid semantic version (e.g., 1.0.0), got: ${frontmatter.version}`);
+    }
+    if (!Array.isArray(frontmatter.tags)) {
+        errors.push('Field "tags" is required and must be an array');
+    } else if (frontmatter.tags.length === 0) {
+        warnings.push('Field "tags" is empty, consider adding tags for categorization');
+    } else if (!frontmatter.tags.every((tag)=>typeof tag === 'string')) {
+        errors.push('All tags must be strings');
+    }
+    if (!frontmatter.status) {
+        errors.push('Field "status" is required');
+    } else if (!VALID_STATUSES.includes(frontmatter.status)) {
+        errors.push(`Field "status" must be one of: ${VALID_STATUSES.join(', ')}, got: ${frontmatter.status}`);
+    }
+    if (!frontmatter.author || typeof frontmatter.author !== 'string') {
+        errors.push('Field "author" is required and must be a string');
+    }
+    if (!frontmatter.description || typeof frontmatter.description !== 'string') {
+        errors.push('Field "description" is required and must be a string');
+    } else if (frontmatter.description.length < 10) {
+        warnings.push('Field "description" is very short, consider adding more detail');
+    }
+    // Optional fields validation
+    if (frontmatter.dependencies !== undefined) {
+        if (!Array.isArray(frontmatter.dependencies)) {
+            errors.push('Field "dependencies" must be an array if provided');
+        } else if (!frontmatter.dependencies.every((dep)=>typeof dep === 'string')) {
+            errors.push('All dependencies must be strings');
+        }
+    }
+    if (frontmatter.created !== undefined && typeof frontmatter.created !== 'string') {
+        errors.push('Field "created" must be a string (ISO date) if provided');
+    }
+    if (frontmatter.updated !== undefined && typeof frontmatter.updated !== 'string') {
+        errors.push('Field "updated" must be a string (ISO date) if provided');
+    }
+    // Date validation
+    if (frontmatter.created) {
+        const createdDate = new Date(frontmatter.created);
+        if (isNaN(createdDate.getTime())) {
+            errors.push(`Field "created" is not a valid date: ${frontmatter.created}`);
+        }
+    }
+    if (frontmatter.updated) {
+        const updatedDate = new Date(frontmatter.updated);
+        if (isNaN(updatedDate.getTime())) {
+            errors.push(`Field "updated" is not a valid date: ${frontmatter.updated}`);
+        }
+        // Check if updated is after created
+        if (frontmatter.created) {
+            const createdDate = new Date(frontmatter.created);
+            const updatedDate = new Date(frontmatter.updated);
+            if (updatedDate < createdDate) {
+                errors.push('Field "updated" cannot be before "created"');
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+/**
+ * Parse and validate SKILL.md content
+ *
+ * @param content - Raw SKILL.md file content
+ * @returns Parsed and validated document
+ * @throws FrontmatterValidationError if validation fails
+ */ export function parseAndValidate(content) {
+    const parsed = parseFrontmatter(content);
+    const validation = validateFrontmatter(parsed.frontmatter);
+    if (!validation.valid) {
+        throw new FrontmatterValidationError('Frontmatter validation failed', validation.errors);
+    }
+    return parsed;
+}
+/**
+ * Serialize frontmatter to YAML string
+ *
+ * @param frontmatter - Frontmatter object to serialize
+ * @returns YAML string representation
+ */ export function serializeFrontmatter(frontmatter) {
+    return yaml.dump(frontmatter, {
+        indent: 2,
+        lineWidth: 100,
+        noRefs: true,
+        sortKeys: false
+    });
+}
+/**
+ * Update frontmatter in SKILL.md content
+ *
+ * @param content - Original SKILL.md content
+ * @param updates - Partial frontmatter updates
+ * @returns Updated SKILL.md content
+ */ export function updateFrontmatter(content, updates) {
+    const parsed = parseFrontmatter(content);
+    const updated = {
+        ...parsed.frontmatter,
+        ...updates
+    };
+    // Update timestamp
+    updated.updated = new Date().toISOString().split('T')[0];
+    const yamlString = serializeFrontmatter(updated);
+    return `---\n${yamlString}---\n${parsed.content}`;
+}
+/**
+ * Create new SKILL.md content with frontmatter
+ *
+ * @param frontmatter - Frontmatter object
+ * @param content - Markdown content
+ * @returns Complete SKILL.md content
+ */ export function createSkillDocument(frontmatter, content) {
+    // Validate before creating
+    const validation = validateFrontmatter(frontmatter);
+    if (!validation.valid) {
+        throw new FrontmatterValidationError('Cannot create skill document with invalid frontmatter', validation.errors);
+    }
+    const yamlString = serializeFrontmatter(frontmatter);
+    return `---\n${yamlString}---\n${content}`;
+}
+/**
+ * Extract frontmatter summary for display
+ *
+ * @param frontmatter - Frontmatter object
+ * @returns Human-readable summary
+ */ export function getFrontmatterSummary(frontmatter) {
+    return `${frontmatter.name} v${frontmatter.version} [${frontmatter.status}]`;
+}
+/**
+ * Compare two versions using semantic versioning
+ *
+ * @param version1 - First version string
+ * @param version2 - Second version string
+ * @returns -1 if v1 < v2, 0 if equal, 1 if v1 > v2
+ */ export function compareVersions(version1, version2) {
+    const v1Parts = version1.split('.').map(Number);
+    const v2Parts = version2.split('.').map(Number);
+    for(let i = 0; i < 3; i++){
+        if (v1Parts[i] > v2Parts[i]) return 1;
+        if (v1Parts[i] < v2Parts[i]) return -1;
+    }
+    return 0;
+}
+
+//# sourceMappingURL=skill-frontmatter-parser.js.map

package/dist/lib/skill-frontmatter-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/skill-frontmatter-parser.ts"],"sourcesContent":["/**\r\n * Skill Frontmatter Parser\r\n *\r\n * Parses and validates YAML frontmatter in SKILL.md files\r\n * Supports semantic versioning and comprehensive metadata tracking\r\n *\r\n * @module skill-frontmatter-parser\r\n * @version 1.0.0\r\n */\r\n\r\nimport * as yaml from 'js-yaml';\r\nimport { StandardError } from './errors.js';\r\n\r\n/**\r\n * Skill status lifecycle stages\r\n */\r\nexport type SkillStatus = 'draft' | 'approved' | 'staging' | 'deployed' | 'deprecated';\r\n\r\n/**\r\n * Skill frontmatter schema\r\n */\r\nexport interface SkillFrontmatter {\r\n  name: string;\r\n  version: string;\r\n  tags: string[];\r\n  status: SkillStatus;\r\n  author: string;\r\n  description: string;\r\n  dependencies?: string[];\r\n  created?: string;\r\n  updated?: string;\r\n\r\n  // Optional extended metadata\r\n  complexity?: 'Low' | 'Medium' | 'High';\r\n  keywords?: string[];\r\n  triggers?: string[];\r\n  performance_targets?: Record<string, number | string>;\r\n}\r\n\r\n/**\r\n * Parsed frontmatter with content\r\n */\r\nexport interface ParsedSkillDocument {\r\n  frontmatter: SkillFrontmatter;\r\n  content: string;\r\n  raw: string;\r\n}\r\n\r\n/**\r\n * Frontmatter validation result\r\n */\r\nexport interface ValidationResult {\r\n  valid: boolean;\r\n  errors: string[];\r\n  warnings: string[];\r\n}\r\n\r\n/**\r\n * Frontmatter parser error\r\n */\r\nexport class FrontmatterParseError extends StandardError {\r\n  constructor(message: string, public readonly context?: Record<string, unknown>) {\r\n    super('FRONTMATTER_PARSE_ERROR', message, context);\r\n    this.name = 'FrontmatterParseError';\r\n  }\r\n}\r\n\r\n/**\r\n * Frontmatter validation error\r\n */\r\nexport class FrontmatterValidationError extends StandardError {\r\n  constructor(message: string, public readonly errors: string[]) {\r\n    super('FRONTMATTER_VALIDATION_ERROR', message, { errors });\r\n    this.name = 'FrontmatterValidationError';\r\n  }\r\n}\r\n\r\n/**\r\n * Semantic version regex pattern\r\n */\r\nconst SEMVER_PATTERN = /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$/;\r\n\r\n/**\r\n * Valid skill status values\r\n */\r\nconst VALID_STATUSES: SkillStatus[] = ['draft', 'approved', 'staging', 'deployed', 'deprecated'];\r\n\r\n/**\r\n * Parse SKILL.md content and extract frontmatter\r\n *\r\n * @param content - Raw SKILL.md file content\r\n * @returns Parsed document with frontmatter and content\r\n * @throws FrontmatterParseError if parsing fails\r\n */\r\nexport function parseFrontmatter(content: string): ParsedSkillDocument {\r\n  // Extract frontmatter block\r\n  const frontmatterMatch = content.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n([\\s\\S]*)$/);\r\n\r\n  if (!frontmatterMatch) {\r\n    throw new FrontmatterParseError('No frontmatter block found. SKILL.md must start with YAML frontmatter enclosed in ---');\r\n  }\r\n\r\n  const [, frontmatterYaml, markdownContent] = frontmatterMatch;\r\n\r\n  // Parse YAML\r\n  let frontmatter: unknown;\r\n  try {\r\n    frontmatter = yaml.load(frontmatterYaml);\r\n  } catch (error) {\r\n    throw new FrontmatterParseError(\r\n      'Failed to parse YAML frontmatter',\r\n      {\r\n        error: error instanceof Error ? error.message : String(error),\r\n        yaml: frontmatterYaml.substring(0, 200)\r\n      }\r\n    );\r\n  }\r\n\r\n  // Validate structure\r\n  if (!frontmatter || typeof frontmatter !== 'object') {\r\n    throw new FrontmatterParseError('Frontmatter must be a valid YAML object');\r\n  }\r\n\r\n  return {\r\n    frontmatter: frontmatter as SkillFrontmatter,\r\n    content: markdownContent.trim(),\r\n    raw: content\r\n  };\r\n}\r\n\r\n/**\r\n * Validate frontmatter against schema\r\n *\r\n * @param frontmatter - Frontmatter object to validate\r\n * @returns Validation result with errors and warnings\r\n */\r\nexport function validateFrontmatter(frontmatter: SkillFrontmatter): ValidationResult {\r\n  const errors: string[] = [];\r\n  const warnings: string[] = [];\r\n\r\n  // Required fields\r\n  if (!frontmatter.name || typeof frontmatter.name !== 'string') {\r\n    errors.push('Field \"name\" is required and must be a string');\r\n  }\r\n\r\n  if (!frontmatter.version || typeof frontmatter.version !== 'string') {\r\n    errors.push('Field \"version\" is required and must be a string');\r\n  } else if (!SEMVER_PATTERN.test(frontmatter.version)) {\r\n    errors.push(`Field \"version\" must be valid semantic version (e.g., 1.0.0), got: ${frontmatter.version}`);\r\n  }\r\n\r\n  if (!Array.isArray(frontmatter.tags)) {\r\n    errors.push('Field \"tags\" is required and must be an array');\r\n  } else if (frontmatter.tags.length === 0) {\r\n    warnings.push('Field \"tags\" is empty, consider adding tags for categorization');\r\n  } else if (!frontmatter.tags.every(tag => typeof tag === 'string')) {\r\n    errors.push('All tags must be strings');\r\n  }\r\n\r\n  if (!frontmatter.status) {\r\n    errors.push('Field \"status\" is required');\r\n  } else if (!VALID_STATUSES.includes(frontmatter.status)) {\r\n    errors.push(`Field \"status\" must be one of: ${VALID_STATUSES.join(', ')}, got: ${frontmatter.status}`);\r\n  }\r\n\r\n  if (!frontmatter.author || typeof frontmatter.author !== 'string') {\r\n    errors.push('Field \"author\" is required and must be a string');\r\n  }\r\n\r\n  if (!frontmatter.description || typeof frontmatter.description !== 'string') {\r\n    errors.push('Field \"description\" is required and must be a string');\r\n  } else if (frontmatter.description.length < 10) {\r\n    warnings.push('Field \"description\" is very short, consider adding more detail');\r\n  }\r\n\r\n  // Optional fields validation\r\n  if (frontmatter.dependencies !== undefined) {\r\n    if (!Array.isArray(frontmatter.dependencies)) {\r\n      errors.push('Field \"dependencies\" must be an array if provided');\r\n    } else if (!frontmatter.dependencies.every(dep => typeof dep === 'string')) {\r\n      errors.push('All dependencies must be strings');\r\n    }\r\n  }\r\n\r\n  if (frontmatter.created !== undefined && typeof frontmatter.created !== 'string') {\r\n    errors.push('Field \"created\" must be a string (ISO date) if provided');\r\n  }\r\n\r\n  if (frontmatter.updated !== undefined && typeof frontmatter.updated !== 'string') {\r\n    errors.push('Field \"updated\" must be a string (ISO date) if provided');\r\n  }\r\n\r\n  // Date validation\r\n  if (frontmatter.created) {\r\n    const createdDate = new Date(frontmatter.created);\r\n    if (isNaN(createdDate.getTime())) {\r\n      errors.push(`Field \"created\" is not a valid date: ${frontmatter.created}`);\r\n    }\r\n  }\r\n\r\n  if (frontmatter.updated) {\r\n    const updatedDate = new Date(frontmatter.updated);\r\n    if (isNaN(updatedDate.getTime())) {\r\n      errors.push(`Field \"updated\" is not a valid date: ${frontmatter.updated}`);\r\n    }\r\n\r\n    // Check if updated is after created\r\n    if (frontmatter.created) {\r\n      const createdDate = new Date(frontmatter.created);\r\n      const updatedDate = new Date(frontmatter.updated);\r\n      if (updatedDate < createdDate) {\r\n        errors.push('Field \"updated\" cannot be before \"created\"');\r\n      }\r\n    }\r\n  }\r\n\r\n  return {\r\n    valid: errors.length === 0,\r\n    errors,\r\n    warnings\r\n  };\r\n}\r\n\r\n/**\r\n * Parse and validate SKILL.md content\r\n *\r\n * @param content - Raw SKILL.md file content\r\n * @returns Parsed and validated document\r\n * @throws FrontmatterValidationError if validation fails\r\n */\r\nexport function parseAndValidate(content: string): ParsedSkillDocument {\r\n  const parsed = parseFrontmatter(content);\r\n  const validation = validateFrontmatter(parsed.frontmatter);\r\n\r\n  if (!validation.valid) {\r\n    throw new FrontmatterValidationError(\r\n      'Frontmatter validation failed',\r\n      validation.errors\r\n    );\r\n  }\r\n\r\n  return parsed;\r\n}\r\n\r\n/**\r\n * Serialize frontmatter to YAML string\r\n *\r\n * @param frontmatter - Frontmatter object to serialize\r\n * @returns YAML string representation\r\n */\r\nexport function serializeFrontmatter(frontmatter: SkillFrontmatter): string {\r\n  return yaml.dump(frontmatter, {\r\n    indent: 2,\r\n    lineWidth: 100,\r\n    noRefs: true,\r\n    sortKeys: false\r\n  });\r\n}\r\n\r\n/**\r\n * Update frontmatter in SKILL.md content\r\n *\r\n * @param content - Original SKILL.md content\r\n * @param updates - Partial frontmatter updates\r\n * @returns Updated SKILL.md content\r\n */\r\nexport function updateFrontmatter(\r\n  content: string,\r\n  updates: Partial<SkillFrontmatter>\r\n): string {\r\n  const parsed = parseFrontmatter(content);\r\n  const updated = { ...parsed.frontmatter, ...updates };\r\n\r\n  // Update timestamp\r\n  updated.updated = new Date().toISOString().split('T')[0];\r\n\r\n  const yamlString = serializeFrontmatter(updated);\r\n  return `---\\n${yamlString}---\\n${parsed.content}`;\r\n}\r\n\r\n/**\r\n * Create new SKILL.md content with frontmatter\r\n *\r\n * @param frontmatter - Frontmatter object\r\n * @param content - Markdown content\r\n * @returns Complete SKILL.md content\r\n */\r\nexport function createSkillDocument(\r\n  frontmatter: SkillFrontmatter,\r\n  content: string\r\n): string {\r\n  // Validate before creating\r\n  const validation = validateFrontmatter(frontmatter);\r\n  if (!validation.valid) {\r\n    throw new FrontmatterValidationError(\r\n      'Cannot create skill document with invalid frontmatter',\r\n      validation.errors\r\n    );\r\n  }\r\n\r\n  const yamlString = serializeFrontmatter(frontmatter);\r\n  return `---\\n${yamlString}---\\n${content}`;\r\n}\r\n\r\n/**\r\n * Extract frontmatter summary for display\r\n *\r\n * @param frontmatter - Frontmatter object\r\n * @returns Human-readable summary\r\n */\r\nexport function getFrontmatterSummary(frontmatter: SkillFrontmatter): string {\r\n  return `${frontmatter.name} v${frontmatter.version} [${frontmatter.status}]`;\r\n}\r\n\r\n/**\r\n * Compare two versions using semantic versioning\r\n *\r\n * @param version1 - First version string\r\n * @param version2 - Second version string\r\n * @returns -1 if v1 < v2, 0 if equal, 1 if v1 > v2\r\n */\r\nexport function compareVersions(version1: string, version2: string): number {\r\n  const v1Parts = version1.split('.').map(Number);\r\n  const v2Parts = version2.split('.').map(Number);\r\n\r\n  for (let i = 0; i < 3; i++) {\r\n    if (v1Parts[i] > v2Parts[i]) return 1;\r\n    if (v1Parts[i] < v2Parts[i]) return -1;\r\n  }\r\n\r\n  return 0;\r\n}\r\n"],"names":["yaml","StandardError","FrontmatterParseError","message","context","name","FrontmatterValidationError","errors","SEMVER_PATTERN","VALID_STATUSES","parseFrontmatter","content","frontmatterMatch","match","frontmatterYaml","markdownContent","frontmatter","load","error","Error","String","substring","trim","raw","validateFrontmatter","warnings","push","version","test","Array","isArray","tags","length","every","tag","status","includes","join","author","description","dependencies","undefined","dep","created","updated","createdDate","Date","isNaN","getTime","updatedDate","valid","parseAndValidate","parsed","validation","serializeFrontmatter","dump","indent","lineWidth","noRefs","sortKeys","updateFrontmatter","updates","toISOString","split","yamlString","createSkillDocument","getFrontmatterSummary","compareVersions","version1","version2","v1Parts","map","Number","v2Parts","i"],"mappings":"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"}

package/dist/lib/skill-git-integration.js

@@ -0,0 +1,275 @@
+/**
+ * Skill Git Integration
+ *
+ * Manages version tracking, content hashing, and git metadata for skills
+ * Provides atomic updates with rollback capabilities
+ *
+ * @module skill-git-integration
+ * @version 1.0.0
+ */ import { exec } from 'child_process';
+import { promisify } from 'util';
+import { createHash } from 'crypto';
+import { readFile } from 'fs/promises';
+import { StandardError } from './errors.js';
+const execAsync = promisify(exec);
+/**
+ * Git integration error
+ */ export class GitIntegrationError extends StandardError {
+    context;
+    constructor(message, context){
+        super('GIT_INTEGRATION_ERROR', message, context), this.context = context;
+        this.name = 'GitIntegrationError';
+    }
+}
+/**
+ * Calculate SHA256 hash of file content
+ *
+ * @param content - File content string
+ * @returns SHA256 hash in hexadecimal
+ */ export function calculateContentHash(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Calculate SHA256 hash of file
+ *
+ * @param filePath - Path to file
+ * @returns SHA256 hash in hexadecimal
+ */ export async function calculateFileHash(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return calculateContentHash(content);
+    } catch (error) {
+        throw new GitIntegrationError(`Failed to calculate file hash for ${filePath}`, {
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+/**
+ * Check if a path is in a git repository
+ *
+ * @param filePath - Path to check
+ * @returns True if in git repository
+ */ export async function isGitRepository(filePath) {
+    try {
+        await execAsync('git rev-parse --is-inside-work-tree', {
+            cwd: filePath
+        });
+        return true;
+    } catch  {
+        return false;
+    }
+}
+/**
+ * Get git commit metadata for a file
+ *
+ * @param filePath - Path to file
+ * @param commitRef - Git commit reference (default: HEAD)
+ * @returns Commit metadata
+ */ export async function getCommitMetadata(filePath, commitRef = 'HEAD') {
+    try {
+        const { stdout } = await execAsync(`git log -1 --format="%H%n%an%n%ae%n%ai%n%s" ${commitRef} -- "${filePath}"`);
+        const [hash, author, email, date, message] = stdout.trim().split('\n');
+        if (!hash) {
+            throw new GitIntegrationError('No git history found for file', {
+                filePath
+            });
+        }
+        return {
+            hash,
+            author,
+            email,
+            date,
+            message: message || 'No commit message'
+        };
+    } catch (error) {
+        throw new GitIntegrationError(`Failed to get git metadata for ${filePath}`, {
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+/**
+ * Get version history for a skill file
+ *
+ * @param filePath - Path to SKILL.md file
+ * @param limit - Maximum number of entries (default: 10)
+ * @returns Array of version history entries
+ */ export async function getVersionHistory(filePath, limit = 10) {
+    try {
+        // Get commit history
+        const { stdout } = await execAsync(`git log -${limit} --format="%H" -- "${filePath}"`);
+        const commits = stdout.trim().split('\n').filter(Boolean);
+        const history = [];
+        for (const commitHash of commits){
+            try {
+                // Get file content at this commit
+                const { stdout: content } = await execAsync(`git show ${commitHash}:"${filePath}"`);
+                // Get commit metadata
+                const metadata = await getCommitMetadata(filePath, commitHash);
+                // Calculate content hash
+                const contentHash = calculateContentHash(content);
+                // Extract version from content (if available in frontmatter)
+                const versionMatch = content.match(/version:\s*["']?([0-9.]+)["']?/);
+                const version = versionMatch ? versionMatch[1] : 'unknown';
+                history.push({
+                    version,
+                    commit: metadata,
+                    contentHash,
+                    timestamp: metadata.date,
+                    filePath
+                });
+            } catch (error) {
+                continue;
+            }
+        }
+        return history;
+    } catch (error) {
+        throw new GitIntegrationError(`Failed to get version history for ${filePath}`, {
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+/**
+ * Stage and commit a file with atomic operation
+ *
+ * @param filePath - Path to file to commit
+ * @param message - Commit message
+ * @returns Git operation result
+ */ export async function commitFile(filePath, message) {
+    try {
+        // Stage file
+        await execAsync(`git add "${filePath}"`);
+        // Commit
+        const { stdout } = await execAsync(`git commit -m "${message}"`);
+        // Get commit hash
+        const { stdout: hashOutput } = await execAsync('git rev-parse HEAD');
+        const commitHash = hashOutput.trim();
+        return {
+            success: true,
+            commitHash
+        };
+    } catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+/**
+ * Rollback file to previous commit
+ *
+ * @param filePath - Path to file to rollback
+ * @param commitRef - Git commit reference to rollback to (default: HEAD~1)
+ * @returns Git operation result
+ */ export async function rollbackFile(filePath, commitRef = 'HEAD~1') {
+    try {
+        // Checkout file from previous commit
+        await execAsync(`git checkout ${commitRef} -- "${filePath}"`);
+        // Commit the rollback
+        const message = `Rollback ${filePath} to ${commitRef}`;
+        return await commitFile(filePath, message);
+    } catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+/**
+ * Check if file has uncommitted changes
+ *
+ * @param filePath - Path to file
+ * @returns True if file has uncommitted changes
+ */ export async function hasUncommittedChanges(filePath) {
+    try {
+        const { stdout } = await execAsync(`git status --porcelain "${filePath}"`);
+        return stdout.trim().length > 0;
+    } catch (error) {
+        throw new GitIntegrationError(`Failed to check git status for ${filePath}`, {
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+/**
+ * Get current git branch
+ *
+ * @returns Current branch name
+ */ export async function getCurrentBranch() {
+    try {
+        const { stdout } = await execAsync('git rev-parse --abbrev-ref HEAD');
+        return stdout.trim();
+    } catch (error) {
+        throw new GitIntegrationError('Failed to get current branch', {
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+/**
+ * Get file diff between two commits
+ *
+ * @param filePath - Path to file
+ * @param commitRef1 - First commit reference
+ * @param commitRef2 - Second commit reference (default: HEAD)
+ * @returns Diff output
+ */ export async function getFileDiff(filePath, commitRef1, commitRef2 = 'HEAD') {
+    try {
+        const { stdout } = await execAsync(`git diff ${commitRef1} ${commitRef2} -- "${filePath}"`);
+        return stdout;
+    } catch (error) {
+        throw new GitIntegrationError(`Failed to get diff for ${filePath}`, {
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+/**
+ * Verify content integrity using git hash
+ *
+ * @param filePath - Path to file
+ * @param expectedHash - Expected content hash
+ * @returns True if content matches expected hash
+ */ export async function verifyContentIntegrity(filePath, expectedHash) {
+    try {
+        const actualHash = await calculateFileHash(filePath);
+        return actualHash === expectedHash;
+    } catch (error) {
+        throw new GitIntegrationError(`Failed to verify content integrity for ${filePath}`, {
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+/**
+ * Get file creation date from git history
+ *
+ * @param filePath - Path to file
+ * @returns ISO date string of first commit
+ */ export async function getFileCreationDate(filePath) {
+    try {
+        const { stdout } = await execAsync(`git log --diff-filter=A --follow --format="%ai" -- "${filePath}" | tail -1`);
+        if (!stdout.trim()) {
+            throw new GitIntegrationError('No creation date found in git history', {
+                filePath
+            });
+        }
+        return new Date(stdout.trim()).toISOString();
+    } catch (error) {
+        throw new GitIntegrationError(`Failed to get creation date for ${filePath}`, {
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+/**
+ * Get file last modification date from git history
+ *
+ * @param filePath - Path to file
+ * @returns ISO date string of last commit
+ */ export async function getFileModificationDate(filePath) {
+    try {
+        const metadata = await getCommitMetadata(filePath);
+        return new Date(metadata.date).toISOString();
+    } catch (error) {
+        throw new GitIntegrationError(`Failed to get modification date for ${filePath}`, {
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+
+//# sourceMappingURL=skill-git-integration.js.map

package/dist/lib/skill-git-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/skill-git-integration.ts"],"sourcesContent":["/**\r\n * Skill Git Integration\r\n *\r\n * Manages version tracking, content hashing, and git metadata for skills\r\n * Provides atomic updates with rollback capabilities\r\n *\r\n * @module skill-git-integration\r\n * @version 1.0.0\r\n */\r\n\r\nimport { exec } from 'child_process';\r\nimport { promisify } from 'util';\r\nimport { createHash } from 'crypto';\r\nimport { readFile } from 'fs/promises';\r\nimport { StandardError } from './errors.js';\r\n\r\nconst execAsync = promisify(exec);\r\n\r\n/**\r\n * Git commit metadata\r\n */\r\nexport interface GitCommitMetadata {\r\n  hash: string;\r\n  author: string;\r\n  email: string;\r\n  date: string;\r\n  message: string;\r\n}\r\n\r\n/**\r\n * Version history entry\r\n */\r\nexport interface VersionHistoryEntry {\r\n  version: string;\r\n  commit: GitCommitMetadata;\r\n  contentHash: string;\r\n  timestamp: string;\r\n  filePath: string;\r\n}\r\n\r\n/**\r\n * Git operation result\r\n */\r\nexport interface GitOperationResult {\r\n  success: boolean;\r\n  commitHash?: string;\r\n  error?: string;\r\n}\r\n\r\n/**\r\n * Git integration error\r\n */\r\nexport class GitIntegrationError extends StandardError {\r\n  constructor(message: string, public readonly context?: Record<string, unknown>) {\r\n    super('GIT_INTEGRATION_ERROR', message, context);\r\n    this.name = 'GitIntegrationError';\r\n  }\r\n}\r\n\r\n/**\r\n * Calculate SHA256 hash of file content\r\n *\r\n * @param content - File content string\r\n * @returns SHA256 hash in hexadecimal\r\n */\r\nexport function calculateContentHash(content: string): string {\r\n  return createHash('sha256').update(content).digest('hex');\r\n}\r\n\r\n/**\r\n * Calculate SHA256 hash of file\r\n *\r\n * @param filePath - Path to file\r\n * @returns SHA256 hash in hexadecimal\r\n */\r\nexport async function calculateFileHash(filePath: string): Promise<string> {\r\n  try {\r\n    const content = await readFile(filePath, 'utf-8');\r\n    return calculateContentHash(content);\r\n  } catch (error) {\r\n    throw new GitIntegrationError(\r\n      `Failed to calculate file hash for ${filePath}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Check if a path is in a git repository\r\n *\r\n * @param filePath - Path to check\r\n * @returns True if in git repository\r\n */\r\nexport async function isGitRepository(filePath: string): Promise<boolean> {\r\n  try {\r\n    await execAsync('git rev-parse --is-inside-work-tree', {\r\n      cwd: filePath\r\n    });\r\n    return true;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Get git commit metadata for a file\r\n *\r\n * @param filePath - Path to file\r\n * @param commitRef - Git commit reference (default: HEAD)\r\n * @returns Commit metadata\r\n */\r\nexport async function getCommitMetadata(\r\n  filePath: string,\r\n  commitRef: string = 'HEAD'\r\n): Promise<GitCommitMetadata> {\r\n  try {\r\n    const { stdout } = await execAsync(\r\n      `git log -1 --format=\"%H%n%an%n%ae%n%ai%n%s\" ${commitRef} -- \"${filePath}\"`\r\n    );\r\n\r\n    const [hash, author, email, date, message] = stdout.trim().split('\\n');\r\n\r\n    if (!hash) {\r\n      throw new GitIntegrationError('No git history found for file', { filePath });\r\n    }\r\n\r\n    return {\r\n      hash,\r\n      author,\r\n      email,\r\n      date,\r\n      message: message || 'No commit message'\r\n    };\r\n  } catch (error) {\r\n    throw new GitIntegrationError(\r\n      `Failed to get git metadata for ${filePath}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Get version history for a skill file\r\n *\r\n * @param filePath - Path to SKILL.md file\r\n * @param limit - Maximum number of entries (default: 10)\r\n * @returns Array of version history entries\r\n */\r\nexport async function getVersionHistory(\r\n  filePath: string,\r\n  limit: number = 10\r\n): Promise<VersionHistoryEntry[]> {\r\n  try {\r\n    // Get commit history\r\n    const { stdout } = await execAsync(\r\n      `git log -${limit} --format=\"%H\" -- \"${filePath}\"`\r\n    );\r\n\r\n    const commits = stdout.trim().split('\\n').filter(Boolean);\r\n    const history: VersionHistoryEntry[] = [];\r\n\r\n    for (const commitHash of commits) {\r\n      try {\r\n        // Get file content at this commit\r\n        const { stdout: content } = await execAsync(\r\n          `git show ${commitHash}:\"${filePath}\"`\r\n        );\r\n\r\n        // Get commit metadata\r\n        const metadata = await getCommitMetadata(filePath, commitHash);\r\n\r\n        // Calculate content hash\r\n        const contentHash = calculateContentHash(content);\r\n\r\n        // Extract version from content (if available in frontmatter)\r\n        const versionMatch = content.match(/version:\\s*[\"']?([0-9.]+)[\"']?/);\r\n        const version = versionMatch ? versionMatch[1] : 'unknown';\r\n\r\n        history.push({\r\n          version,\r\n          commit: metadata,\r\n          contentHash,\r\n          timestamp: metadata.date,\r\n          filePath\r\n        });\r\n      } catch (error) {\r\n        // Skip commits where file doesn't exist\r\n        continue;\r\n      }\r\n    }\r\n\r\n    return history;\r\n  } catch (error) {\r\n    throw new GitIntegrationError(\r\n      `Failed to get version history for ${filePath}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Stage and commit a file with atomic operation\r\n *\r\n * @param filePath - Path to file to commit\r\n * @param message - Commit message\r\n * @returns Git operation result\r\n */\r\nexport async function commitFile(\r\n  filePath: string,\r\n  message: string\r\n): Promise<GitOperationResult> {\r\n  try {\r\n    // Stage file\r\n    await execAsync(`git add \"${filePath}\"`);\r\n\r\n    // Commit\r\n    const { stdout } = await execAsync(`git commit -m \"${message}\"`);\r\n\r\n    // Get commit hash\r\n    const { stdout: hashOutput } = await execAsync('git rev-parse HEAD');\r\n    const commitHash = hashOutput.trim();\r\n\r\n    return {\r\n      success: true,\r\n      commitHash\r\n    };\r\n  } catch (error) {\r\n    return {\r\n      success: false,\r\n      error: error instanceof Error ? error.message : String(error)\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Rollback file to previous commit\r\n *\r\n * @param filePath - Path to file to rollback\r\n * @param commitRef - Git commit reference to rollback to (default: HEAD~1)\r\n * @returns Git operation result\r\n */\r\nexport async function rollbackFile(\r\n  filePath: string,\r\n  commitRef: string = 'HEAD~1'\r\n): Promise<GitOperationResult> {\r\n  try {\r\n    // Checkout file from previous commit\r\n    await execAsync(`git checkout ${commitRef} -- \"${filePath}\"`);\r\n\r\n    // Commit the rollback\r\n    const message = `Rollback ${filePath} to ${commitRef}`;\r\n    return await commitFile(filePath, message);\r\n  } catch (error) {\r\n    return {\r\n      success: false,\r\n      error: error instanceof Error ? error.message : String(error)\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Check if file has uncommitted changes\r\n *\r\n * @param filePath - Path to file\r\n * @returns True if file has uncommitted changes\r\n */\r\nexport async function hasUncommittedChanges(filePath: string): Promise<boolean> {\r\n  try {\r\n    const { stdout } = await execAsync(`git status --porcelain \"${filePath}\"`);\r\n    return stdout.trim().length > 0;\r\n  } catch (error) {\r\n    throw new GitIntegrationError(\r\n      `Failed to check git status for ${filePath}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Get current git branch\r\n *\r\n * @returns Current branch name\r\n */\r\nexport async function getCurrentBranch(): Promise<string> {\r\n  try {\r\n    const { stdout } = await execAsync('git rev-parse --abbrev-ref HEAD');\r\n    return stdout.trim();\r\n  } catch (error) {\r\n    throw new GitIntegrationError(\r\n      'Failed to get current branch',\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Get file diff between two commits\r\n *\r\n * @param filePath - Path to file\r\n * @param commitRef1 - First commit reference\r\n * @param commitRef2 - Second commit reference (default: HEAD)\r\n * @returns Diff output\r\n */\r\nexport async function getFileDiff(\r\n  filePath: string,\r\n  commitRef1: string,\r\n  commitRef2: string = 'HEAD'\r\n): Promise<string> {\r\n  try {\r\n    const { stdout } = await execAsync(\r\n      `git diff ${commitRef1} ${commitRef2} -- \"${filePath}\"`\r\n    );\r\n    return stdout;\r\n  } catch (error) {\r\n    throw new GitIntegrationError(\r\n      `Failed to get diff for ${filePath}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Verify content integrity using git hash\r\n *\r\n * @param filePath - Path to file\r\n * @param expectedHash - Expected content hash\r\n * @returns True if content matches expected hash\r\n */\r\nexport async function verifyContentIntegrity(\r\n  filePath: string,\r\n  expectedHash: string\r\n): Promise<boolean> {\r\n  try {\r\n    const actualHash = await calculateFileHash(filePath);\r\n    return actualHash === expectedHash;\r\n  } catch (error) {\r\n    throw new GitIntegrationError(\r\n      `Failed to verify content integrity for ${filePath}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Get file creation date from git history\r\n *\r\n * @param filePath - Path to file\r\n * @returns ISO date string of first commit\r\n */\r\nexport async function getFileCreationDate(filePath: string): Promise<string> {\r\n  try {\r\n    const { stdout } = await execAsync(\r\n      `git log --diff-filter=A --follow --format=\"%ai\" -- \"${filePath}\" | tail -1`\r\n    );\r\n\r\n    if (!stdout.trim()) {\r\n      throw new GitIntegrationError('No creation date found in git history', { filePath });\r\n    }\r\n\r\n    return new Date(stdout.trim()).toISOString();\r\n  } catch (error) {\r\n    throw new GitIntegrationError(\r\n      `Failed to get creation date for ${filePath}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Get file last modification date from git history\r\n *\r\n * @param filePath - Path to file\r\n * @returns ISO date string of last commit\r\n */\r\nexport async function getFileModificationDate(filePath: string): Promise<string> {\r\n  try {\r\n    const metadata = await getCommitMetadata(filePath);\r\n    return new Date(metadata.date).toISOString();\r\n  } catch (error) {\r\n    throw new GitIntegrationError(\r\n      `Failed to get modification date for ${filePath}`,\r\n      { error: error instanceof Error ? error.message : String(error) }\r\n    );\r\n  }\r\n}\r\n"],"names":["exec","promisify","createHash","readFile","StandardError","execAsync","GitIntegrationError","message","context","name","calculateContentHash","content","update","digest","calculateFileHash","filePath","error","Error","String","isGitRepository","cwd","getCommitMetadata","commitRef","stdout","hash","author","email","date","trim","split","getVersionHistory","limit","commits","filter","Boolean","history","commitHash","metadata","contentHash","versionMatch","match","version","push","commit","timestamp","commitFile","hashOutput","success","rollbackFile","hasUncommittedChanges","length","getCurrentBranch","getFileDiff","commitRef1","commitRef2","verifyContentIntegrity","expectedHash","actualHash","getFileCreationDate","Date","toISOString","getFileModificationDate"],"mappings":"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"}