workflow-agent-cli 2.18.1 → 2.19.0

package/dist/{chunk-Q2B25XH2.js → chunk-HFR4MND6.js}

@@ -259,7 +259,7 @@ ${CUSTOM_END_MARKER}
   return content;
 }
 function generateCopilotInstructions(projectRoot, options = {}) {
-  const { force = false, silent = false } = options;
+  const { force: _force = false, silent = false } = options;
   const guidelinesDir = join(projectRoot, "guidelines");
   const githubDir = join(projectRoot, ".github");
   const outputPath = join(githubDir, "copilot-instructions.md");
@@ -705,4 +705,4 @@ export {
   installMandatoryTemplates,
   updateTemplates
 };
-//# sourceMappingURL=chunk-Q2B25XH2.js.map
+//# sourceMappingURL=chunk-HFR4MND6.js.map

package/dist/chunk-HFR4MND6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scripts/copilot-instructions-generator.ts","../src/scripts/workflow-scripts.ts","../src/scripts/template-installer.ts","../src/templates/metadata.ts"],"sourcesContent":["/**\n * Copilot Instructions Generator\n *\n * Generates .github/copilot-instructions.md from the project's guidelines directory.\n * This file serves as the Single Source of Truth for AI agents (GitHub Copilot, Claude, etc.)\n * when working on the codebase.\n *\n * Features:\n * - Reads all markdown files from guidelines/\n * - Extracts key rules and summaries from each guideline\n * - Loads project config from workflow.config.json\n * - Preserves custom user content between markers\n * - Provides links to full guideline documents\n */\n\nimport { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync } from \"fs\";\nimport { join, basename } from \"path\";\n\n// Markers for custom user content that should be preserved on regeneration\nconst CUSTOM_START_MARKER = \"<!-- CUSTOM START -->\";\nconst CUSTOM_END_MARKER = \"<!-- CUSTOM END -->\";\nconst GENERATED_MARKER = \"<!-- AUTO-GENERATED BY WORKFLOW-AGENT - DO NOT EDIT ABOVE THIS LINE -->\";\n\ninterface WorkflowConfig {\n  projectName?: string;\n  scopes?: Array<{ name: string; description: string; emoji?: string }>;\n  enforcement?: string;\n  language?: string;\n}\n\ninterface GuidelineSummary {\n  filename: string;\n  title: string;\n  description: string;\n  keyRules: string[];\n}\n\n/**\n * Extract title from markdown content (first H1)\n */\nfunction extractTitle(content: string): string {\n  const match = content.match(/^#\\s+(.+)$/m);\n  return match ? match[1].trim() : \"Untitled\";\n}\n\n/**\n * Extract description from markdown content (first paragraph after title)\n */\nfunction extractDescription(content: string): string {\n  // Look for content after the first heading, before the next heading or section\n  const lines = content.split(\"\\n\");\n  let foundTitle = false;\n  let description = \"\";\n\n  for (const line of lines) {\n    if (line.startsWith(\"# \")) {\n      foundTitle = true;\n      continue;\n    }\n    if (foundTitle) {\n      // Skip empty lines and blockquotes at start\n      if (line.trim() === \"\" || line.startsWith(\">\")) {\n        if (description) break; // End if we already have content\n        continue;\n      }\n      // Stop at next heading or horizontal rule\n      if (line.startsWith(\"#\") || line.startsWith(\"---\") || line.startsWith(\"##\")) {\n        break;\n      }\n      description += line.trim() + \" \";\n      // Take only first meaningful paragraph\n      if (description.length > 150) break;\n    }\n  }\n\n  return description.trim().slice(0, 200) + (description.length > 200 ? \"...\" : \"\");\n}\n\n/**\n * Extract key rules from markdown content\n * Looks for lists, bold text, and important patterns\n */\nfunction extractKeyRules(content: string, maxRules: number = 5): string[] {\n  const rules: string[] = [];\n\n  // Pattern 1: Look for \"MUST\", \"NEVER\", \"ALWAYS\", \"REQUIRED\" in bold or emphasized\n  const emphasisPatterns = [\n    /\\*\\*(?:MUST|NEVER|ALWAYS|REQUIRED)[^*]+\\*\\*/gi,\n    /(?:^|\\n)\\s*[-*]\\s+\\*\\*[^*]+\\*\\*/gm,\n  ];\n\n  for (const pattern of emphasisPatterns) {\n    const matches = content.match(pattern);\n    if (matches) {\n      for (const match of matches.slice(0, 2)) {\n        const cleaned = match.replace(/\\*\\*/g, \"\").replace(/^[-*]\\s*/, \"\").trim();\n        if (cleaned.length > 10 && cleaned.length < 150 && !rules.includes(cleaned)) {\n          rules.push(cleaned);\n        }\n      }\n    }\n  }\n\n  // Pattern 2: Look for numbered or bulleted rules under headings containing \"Rules\", \"Requirements\", \"Guidelines\"\n  const rulesSectionMatch = content.match(/##\\s+(?:.*(?:Rules?|Requirements?|Guidelines?|Standards?)[^\\n]*)\\n([\\s\\S]*?)(?=\\n##|\\n#|$)/i);\n  if (rulesSectionMatch) {\n    const section = rulesSectionMatch[1];\n    const listItems = section.match(/^\\s*[-*\\d.]+\\s+(.+)$/gm);\n    if (listItems) {\n      for (const item of listItems.slice(0, 3)) {\n        const cleaned = item.replace(/^[-*\\d.]+\\s*/, \"\").trim();\n        if (cleaned.length > 10 && cleaned.length < 150 && !rules.includes(cleaned)) {\n          rules.push(cleaned);\n        }\n      }\n    }\n  }\n\n  // Pattern 3: Look for key points under \"Important\", \"Critical\", \"Key\"\n  const importantMatch = content.match(/(?:Important|Critical|Key|Essential)[:\\s]+([^\\n]+)/gi);\n  if (importantMatch) {\n    for (const match of importantMatch.slice(0, 2)) {\n      const cleaned = match.replace(/^(?:Important|Critical|Key|Essential)[:\\s]+/i, \"\").trim();\n      if (cleaned.length > 10 && cleaned.length < 150 && !rules.includes(cleaned)) {\n        rules.push(cleaned);\n      }\n    }\n  }\n\n  // Fallback: Get first few list items if we don't have enough rules\n  if (rules.length < 2) {\n    const listItems = content.match(/^\\s*[-*]\\s+(.+)$/gm);\n    if (listItems) {\n      for (const item of listItems.slice(0, 3)) {\n        const cleaned = item.replace(/^[-*]\\s*/, \"\").trim();\n        if (cleaned.length > 15 && cleaned.length < 150 && !rules.includes(cleaned)) {\n          rules.push(cleaned);\n        }\n      }\n    }\n  }\n\n  return rules.slice(0, maxRules);\n}\n\n/**\n * Parse a guideline markdown file and extract summary\n */\nfunction parseGuideline(filePath: string): GuidelineSummary | null {\n  try {\n    const content = readFileSync(filePath, \"utf-8\");\n    const filename = basename(filePath);\n\n    // Skip template example and non-guideline files\n    if (filename.startsWith(\"_\") || filename === \"Guidelines.md\") {\n      return null;\n    }\n\n    return {\n      filename,\n      title: extractTitle(content),\n      description: extractDescription(content),\n      keyRules: extractKeyRules(content),\n    };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Load workflow config from project root\n */\nfunction loadWorkflowConfig(projectRoot: string): WorkflowConfig | null {\n  const configPath = join(projectRoot, \"workflow.config.json\");\n  if (!existsSync(configPath)) {\n    return null;\n  }\n\n  try {\n    const content = readFileSync(configPath, \"utf-8\");\n    return JSON.parse(content) as WorkflowConfig;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Extract preserved custom content from existing file\n */\nfunction extractCustomContent(existingContent: string): string | null {\n  const startIndex = existingContent.indexOf(CUSTOM_START_MARKER);\n  const endIndex = existingContent.indexOf(CUSTOM_END_MARKER);\n\n  if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {\n    return existingContent.slice(\n      startIndex + CUSTOM_START_MARKER.length,\n      endIndex\n    ).trim();\n  }\n\n  return null;\n}\n\n/**\n * Generate the copilot-instructions.md content\n */\nfunction generateInstructionsContent(\n  config: WorkflowConfig | null,\n  guidelines: GuidelineSummary[],\n  customContent: string | null\n): string {\n  const projectName = config?.projectName || \"this project\";\n  const scopes = config?.scopes || [];\n\n  let content = `# Copilot Instructions for ${projectName}\n\n> **This file is the Single Source of Truth for AI agents working on this codebase.**\n> It is auto-generated from the \\`guidelines/\\` directory by workflow-agent-cli.\n> Last generated: ${new Date().toISOString().split(\"T\")[0]}\n\n${GENERATED_MARKER}\n\n## Project Overview\n\n`;\n\n  if (config) {\n    content += `- **Project Name**: ${projectName}\\n`;\n    content += `- **Enforcement Level**: ${config.enforcement || \"strict\"}\\n`;\n    if (scopes.length > 0) {\n      content += `- **Available Scopes**: ${scopes.map(s => `\\`${s.name}\\``).join(\", \")}\\n`;\n    }\n    content += \"\\n\";\n  }\n\n  // Add scope reference if available\n  if (scopes.length > 0) {\n    content += `### Valid Scopes for Commits and Branches\n\n| Scope | Description |\n|-------|-------------|\n`;\n    for (const scope of scopes.slice(0, 15)) {\n      content += `| \\`${scope.name}\\` | ${scope.description} |\\n`;\n    }\n    if (scopes.length > 15) {\n      content += `| ... | See workflow.config.json for all ${scopes.length} scopes |\\n`;\n    }\n    content += \"\\n\";\n  }\n\n  // Add guidelines summaries\n  if (guidelines.length > 0) {\n    content += `## Guidelines Summary\n\nThe following guidelines govern development on this project. **Read the linked documents for full details.**\n\n`;\n\n    // Group by importance (mandatory templates first)\n    const mandatoryFiles = [\n      \"AGENT_EDITING_INSTRUCTIONS.md\",\n      \"BRANCHING_STRATEGY.md\",\n      \"TESTING_STRATEGY.md\",\n      \"SINGLE_SOURCE_OF_TRUTH.md\",\n      \"PATTERN_ANALYSIS_WORKFLOW.md\",\n      \"SELF_IMPROVEMENT_MANDATE.md\",\n    ];\n\n    const sortedGuidelines = [...guidelines].sort((a, b) => {\n      const aIndex = mandatoryFiles.indexOf(a.filename);\n      const bIndex = mandatoryFiles.indexOf(b.filename);\n      if (aIndex !== -1 && bIndex !== -1) return aIndex - bIndex;\n      if (aIndex !== -1) return -1;\n      if (bIndex !== -1) return 1;\n      return a.title.localeCompare(b.title);\n    });\n\n    for (const guideline of sortedGuidelines) {\n      content += `### ${guideline.title}\n\n📄 [See full details](../guidelines/${guideline.filename})\n\n${guideline.description}\n\n`;\n      if (guideline.keyRules.length > 0) {\n        content += `**Key Rules:**\n`;\n        for (const rule of guideline.keyRules) {\n          content += `- ${rule}\\n`;\n        }\n        content += \"\\n\";\n      }\n    }\n  }\n\n  // Add quick reference section\n  content += `## Quick Reference\n\n### Branch Naming Convention\n\\`\\`\\`\n<type>/<scope>/<short-description>\n\\`\\`\\`\n\n**Types**: \\`feature\\`, \\`fix\\`, \\`chore\\`, \\`docs\\`, \\`refactor\\`, \\`test\\`, \\`perf\\`\n\n### Commit Message Format\n\\`\\`\\`\n<type>(<scope>): <description>\n\n[optional body]\n\n[optional footer]\n\\`\\`\\`\n\n### Before Making Changes\n1. Read the relevant guideline document in \\`guidelines/\\`\n2. Check for existing patterns in \\`workflow:solution:search\\`\n3. Create an implementation plan for multi-file changes\n4. Ensure tests are added for new functionality\n\n### Before Committing\n1. Run \\`pnpm run workflow:verify\\` to validate all changes\n2. Ensure branch name follows convention\n3. Ensure commit message follows conventional commits format\n\n`;\n\n  // Add custom content section\n  content += `## Project-Specific Instructions\n\n${CUSTOM_START_MARKER}\n${customContent || `\n<!-- \nAdd your project-specific instructions here.\nThis section will be preserved when the file is regenerated.\n\nExamples:\n- Specific coding patterns unique to this project\n- Custom review requirements\n- Domain-specific terminology\n- Team-specific workflows\n-->\n`}\n${CUSTOM_END_MARKER}\n\n---\n\n*This file was generated by [workflow-agent-cli](https://www.npmjs.com/package/workflow-agent-cli). Run \\`pnpm run workflow:generate-instructions\\` to regenerate.*\n`;\n\n  return content;\n}\n\n/**\n * Result of generating copilot instructions\n */\nexport interface GenerateResult {\n  success: boolean;\n  filePath: string | null;\n  guidelinesCount: number;\n  isNew: boolean;\n  preservedCustomContent: boolean;\n  error?: string;\n}\n\n/**\n * Generate .github/copilot-instructions.md from guidelines directory\n *\n * @param projectRoot - Root directory of the project\n * @param options - Generation options\n * @returns Result of the generation\n */\nexport function generateCopilotInstructions(\n  projectRoot: string,\n  options: { force?: boolean; silent?: boolean } = {}\n): GenerateResult {\n  const { force: _force = false, silent = false } = options;\n\n  const guidelinesDir = join(projectRoot, \"guidelines\");\n  const githubDir = join(projectRoot, \".github\");\n  const outputPath = join(githubDir, \"copilot-instructions.md\");\n\n  // Check if guidelines directory exists\n  if (!existsSync(guidelinesDir)) {\n    if (!silent) {\n      // Guidelines don't exist yet - skip silently during postinstall\n    }\n    return {\n      success: false,\n      filePath: null,\n      guidelinesCount: 0,\n      isNew: false,\n      preservedCustomContent: false,\n      error: \"No guidelines directory found. Run 'workflow init' first.\",\n    };\n  }\n\n  // Read all markdown files from guidelines\n  const files = readdirSync(guidelinesDir).filter(f => f.endsWith(\".md\"));\n  if (files.length === 0) {\n    return {\n      success: false,\n      filePath: null,\n      guidelinesCount: 0,\n      isNew: false,\n      preservedCustomContent: false,\n      error: \"No markdown files found in guidelines directory.\",\n    };\n  }\n\n  // Parse each guideline\n  const guidelines: GuidelineSummary[] = [];\n  for (const file of files) {\n    const summary = parseGuideline(join(guidelinesDir, file));\n    if (summary) {\n      guidelines.push(summary);\n    }\n  }\n\n  // Load workflow config\n  const config = loadWorkflowConfig(projectRoot);\n\n  // Check for existing file and extract custom content\n  let customContent: string | null = null;\n  let isNew = true;\n\n  if (existsSync(outputPath)) {\n    isNew = false;\n    const existingContent = readFileSync(outputPath, \"utf-8\");\n    customContent = extractCustomContent(existingContent);\n  }\n\n  // Generate the content\n  const content = generateInstructionsContent(config, guidelines, customContent);\n\n  // Ensure .github directory exists\n  if (!existsSync(githubDir)) {\n    mkdirSync(githubDir, { recursive: true });\n  }\n\n  // Write the file\n  writeFileSync(outputPath, content, \"utf-8\");\n\n  return {\n    success: true,\n    filePath: outputPath,\n    guidelinesCount: guidelines.length,\n    isNew,\n    preservedCustomContent: customContent !== null,\n  };\n}\n\n/**\n * Check if copilot instructions need regeneration\n * (e.g., guidelines have been modified since last generation)\n */\nexport function needsRegeneration(projectRoot: string): boolean {\n  const guidelinesDir = join(projectRoot, \"guidelines\");\n  const outputPath = join(projectRoot, \".github\", \"copilot-instructions.md\");\n\n  if (!existsSync(outputPath)) {\n    return existsSync(guidelinesDir);\n  }\n\n  // For now, always regenerate to ensure latest content\n  // Future: could compare file modification times\n  return true;\n}\n","/**\n * Shared workflow scripts definition\n * Used by postinstall.ts and setup.ts to ensure consistency\n */\n\nexport const WORKFLOW_SCRIPTS = {\n  // Core Commands\n  \"workflow:init\": \"workflow-agent init\",\n  \"workflow:validate\": \"workflow-agent validate\",\n  \"workflow:config\": \"workflow-agent config\",\n  \"workflow:suggest\": \"workflow-agent suggest\",\n  \"workflow:setup\": \"workflow-agent setup\",\n  \"workflow:doctor\": \"workflow-agent doctor\",\n\n  // Scope Commands\n  \"workflow:scope:create\": \"workflow-agent scope:create\",\n  \"workflow:scope:migrate\": \"workflow-agent scope:migrate\",\n\n  // Verification & Auto-Setup\n  \"workflow:verify\": \"workflow-agent verify\",\n  \"workflow:verify:fix\": \"workflow-agent verify --fix\",\n  \"workflow:auto-setup\": \"workflow-agent auto-setup\",\n\n  // Learning System Commands\n  \"workflow:learn\": \"workflow-agent learn:list\",\n  \"workflow:learn:record\": \"workflow-agent learn:record\",\n  \"workflow:learn:list\": \"workflow-agent learn:list\",\n  \"workflow:learn:apply\": \"workflow-agent learn:apply\",\n  \"workflow:learn:publish\": \"workflow-agent learn:publish\",\n  \"workflow:learn:sync\": \"workflow-agent learn:sync\",\n  \"workflow:learn:sync:push\": \"workflow-agent learn:sync --push\",\n  \"workflow:learn:sync:pull\": \"workflow-agent learn:sync --pull\",\n  \"workflow:learn:config\": \"workflow-agent learn:config\",\n  \"workflow:learn:deprecate\": \"workflow-agent learn:deprecate\",\n  \"workflow:learn:stats\": \"workflow-agent learn:stats\",\n\n  // Solution Pattern Commands\n  \"workflow:solution\": \"workflow-agent solution:list\",\n  \"workflow:solution:capture\": \"workflow-agent solution:capture\",\n  \"workflow:solution:search\": \"workflow-agent solution:search\",\n  \"workflow:solution:list\": \"workflow-agent solution:list\",\n  \"workflow:solution:apply\": \"workflow-agent solution:apply\",\n  \"workflow:solution:deprecate\": \"workflow-agent solution:deprecate\",\n  \"workflow:solution:stats\": \"workflow-agent solution:stats\",\n\n  // Advisory Board Commands\n  \"workflow:advisory\": \"workflow-agent advisory\",\n  \"workflow:advisory:quick\": \"workflow-agent advisory --depth quick\",\n  \"workflow:advisory:standard\": \"workflow-agent advisory --depth standard\",\n  \"workflow:advisory:comprehensive\":\n    \"workflow-agent advisory --depth comprehensive\",\n  \"workflow:advisory:executive\": \"workflow-agent advisory --depth executive\",\n  \"workflow:advisory:ci\": \"workflow-agent advisory --ci\",\n\n  // AI Agent Instructions\n  \"workflow:generate-instructions\": \"workflow-agent generate-instructions\",\n\n  // Template Management\n  \"workflow:update-templates\": \"workflow-agent update-templates\",\n  \"workflow:update-templates:force\": \"workflow-agent update-templates --force\",\n\n  // Document Validation\n  \"workflow:docs:validate\": \"workflow-agent docs:validate\",\n  \"workflow:docs:validate:fix\": \"workflow-agent docs:validate --fix\",\n} as const;\n\nexport type WorkflowScriptName = keyof typeof WORKFLOW_SCRIPTS;\n\n/**\n * Script categories for organized console output\n */\nexport const SCRIPT_CATEGORIES = {\n  \"Core Commands\": [\n    \"workflow:init\",\n    \"workflow:validate\",\n    \"workflow:config\",\n    \"workflow:suggest\",\n    \"workflow:setup\",\n    \"workflow:doctor\",\n  ],\n  \"Scope Commands\": [\"workflow:scope:create\", \"workflow:scope:migrate\"],\n  Verification: [\n    \"workflow:verify\",\n    \"workflow:verify:fix\",\n    \"workflow:auto-setup\",\n  ],\n  \"Learning System\": [\n    \"workflow:learn\",\n    \"workflow:learn:record\",\n    \"workflow:learn:list\",\n    \"workflow:learn:apply\",\n    \"workflow:learn:publish\",\n    \"workflow:learn:sync\",\n    \"workflow:learn:sync:push\",\n    \"workflow:learn:sync:pull\",\n    \"workflow:learn:config\",\n    \"workflow:learn:deprecate\",\n    \"workflow:learn:stats\",\n  ],\n  \"Solution Patterns\": [\n    \"workflow:solution\",\n    \"workflow:solution:capture\",\n    \"workflow:solution:search\",\n    \"workflow:solution:list\",\n    \"workflow:solution:apply\",\n    \"workflow:solution:deprecate\",\n    \"workflow:solution:stats\",\n  ],\n  \"Advisory Board\": [\n    \"workflow:advisory\",\n    \"workflow:advisory:quick\",\n    \"workflow:advisory:standard\",\n    \"workflow:advisory:comprehensive\",\n    \"workflow:advisory:executive\",\n    \"workflow:advisory:ci\",\n  ],\n  \"AI Agent Instructions\": [\n    \"workflow:generate-instructions\",\n  ],\n  \"Template Management\": [\n    \"workflow:update-templates\",\n    \"workflow:update-templates:force\",\n  ],\n  \"Document Validation\": [\n    \"workflow:docs:validate\",\n    \"workflow:docs:validate:fix\",\n  ],\n} as const;\n\nexport const TOTAL_SCRIPTS = Object.keys(WORKFLOW_SCRIPTS).length;\n","/**\n * Silent template installer for postinstall and non-interactive contexts\n *\n * This module provides functions to copy mandatory templates without\n * user interaction, suitable for use in postinstall scripts.\n */\n\nimport { existsSync, readFileSync, writeFileSync, mkdirSync } from \"fs\";\nimport { readdirSync } from \"fs\";\nimport { join, basename } from \"path\";\nimport { getMandatoryTemplateFilenames } from \"../templates/metadata.js\";\n\nexport interface InstallTemplatesOptions {\n  /** Force overwrite existing files */\n  force?: boolean;\n  /** Skip if guidelines directory already exists */\n  skipIfExists?: boolean;\n  /** Silent mode - no console output */\n  silent?: boolean;\n  /** Only install mandatory templates (default: true) */\n  mandatoryOnly?: boolean;\n}\n\nexport interface InstallTemplatesResult {\n  success: boolean;\n  installed: string[];\n  skipped: string[];\n  updated: string[];\n  errors: string[];\n  guidelinesExisted: boolean;\n}\n\n/**\n * Get project name from package.json or directory name\n */\nfunction getProjectName(projectRoot: string): string {\n  try {\n    const pkgPath = join(projectRoot, \"package.json\");\n    if (existsSync(pkgPath)) {\n      const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n      return pkg.name || basename(projectRoot);\n    }\n  } catch {\n    // Ignore errors, fall back to directory name\n  }\n  return basename(projectRoot);\n}\n\n/**\n * Simple template variable substitution using {{variable}} syntax\n */\nfunction renderTemplate(\n  template: string,\n  context: Record<string, string>,\n): string {\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (match, key) => {\n    return context[key] ?? match;\n  });\n}\n\n/**\n * Build default template context from project info\n * Uses generic defaults when no workflow.config.json exists\n */\nfunction buildDefaultContext(projectRoot: string): Record<string, string> {\n  const projectName = getProjectName(projectRoot);\n\n  return {\n    projectName,\n    framework: \"unknown\",\n    scopes: \"feat, fix, docs, refactor, test, chore\",\n    scopeList: `- **feat** - New features\n- **fix** - Bug fixes\n- **docs** - Documentation\n- **refactor** - Code refactoring\n- **test** - Testing\n- **chore** - Maintenance`,\n    pathStructure: \"N/A\",\n    enforcement: \"strict\",\n    year: new Date().getFullYear().toString(),\n  };\n}\n\n/**\n * Find the templates directory relative to this module\n * Works in both development and installed contexts\n */\nexport function findTemplatesDirectory(callerDirname: string): string | null {\n  // When installed: dist/scripts/template-installer.js -> ../../templates\n  // Try multiple possible locations\n  const possiblePaths = [\n    join(callerDirname, \"../../templates\"),\n    join(callerDirname, \"../templates\"),\n    join(callerDirname, \"templates\"),\n  ];\n\n  for (const templatePath of possiblePaths) {\n    if (existsSync(templatePath)) {\n      return templatePath;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Install mandatory templates to a project's guidelines directory\n * Designed for non-interactive use (postinstall, CI, etc.)\n */\nexport function installMandatoryTemplates(\n  projectRoot: string,\n  templatesDir: string,\n  options: InstallTemplatesOptions = {},\n): InstallTemplatesResult {\n  const {\n    force = false,\n    skipIfExists = true,\n    silent = false,\n    mandatoryOnly = true,\n  } = options;\n\n  const result: InstallTemplatesResult = {\n    success: true,\n    installed: [],\n    skipped: [],\n    updated: [],\n    errors: [],\n    guidelinesExisted: false,\n  };\n\n  const guidelinesDir = join(projectRoot, \"guidelines\");\n  result.guidelinesExisted = existsSync(guidelinesDir);\n\n  // Skip if guidelines exists and skipIfExists is true\n  if (result.guidelinesExisted && skipIfExists && !force) {\n    if (!silent) {\n      console.log(\"  Guidelines directory already exists, skipping templates\");\n    }\n    return result;\n  }\n\n  // Get list of templates to install\n  const mandatoryFiles = getMandatoryTemplateFilenames();\n\n  // Check templates directory exists\n  if (!existsSync(templatesDir)) {\n    result.success = false;\n    result.errors.push(`Templates directory not found: ${templatesDir}`);\n    return result;\n  }\n\n  // Get available template files\n  let availableFiles: string[];\n  try {\n    availableFiles = readdirSync(templatesDir).filter((f) => f.endsWith(\".md\"));\n  } catch (error) {\n    result.success = false;\n    result.errors.push(`Failed to read templates directory: ${error}`);\n    return result;\n  }\n\n  // Determine which files to install\n  const filesToInstall = mandatoryOnly\n    ? availableFiles.filter((f) => mandatoryFiles.includes(f))\n    : availableFiles;\n\n  if (filesToInstall.length === 0) {\n    result.success = false;\n    result.errors.push(\"No template files found to install\");\n    return result;\n  }\n\n  // Build template context\n  const context = buildDefaultContext(projectRoot);\n\n  // Create guidelines directory\n  try {\n    mkdirSync(guidelinesDir, { recursive: true });\n  } catch (error) {\n    result.success = false;\n    result.errors.push(`Failed to create guidelines directory: ${error}`);\n    return result;\n  }\n\n  // Copy each template\n  for (const filename of filesToInstall) {\n    const sourcePath = join(templatesDir, filename);\n    const destPath = join(guidelinesDir, filename);\n\n    const fileExists = existsSync(destPath);\n\n    // Skip if file exists and not forcing\n    if (fileExists && !force) {\n      result.skipped.push(filename);\n      continue;\n    }\n\n    try {\n      const template = readFileSync(sourcePath, \"utf-8\");\n      const rendered = renderTemplate(template, context);\n      writeFileSync(destPath, rendered, \"utf-8\");\n\n      if (fileExists) {\n        result.updated.push(filename);\n      } else {\n        result.installed.push(filename);\n      }\n    } catch (error) {\n      result.errors.push(`Failed to install ${filename}: ${error}`);\n    }\n  }\n\n  // Log results if not silent\n  if (!silent) {\n    if (result.installed.length > 0) {\n      console.log(\n        `\\n✓ Installed ${result.installed.length} guideline templates:`,\n      );\n      for (const file of result.installed) {\n        console.log(`    - ${file}`);\n      }\n    }\n    if (result.updated.length > 0) {\n      console.log(`\\n✓ Updated ${result.updated.length} guideline templates:`);\n      for (const file of result.updated) {\n        console.log(`    - ${file}`);\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Update templates - reinstall templates with option to force or skip existing\n */\nexport function updateTemplates(\n  projectRoot: string,\n  templatesDir: string,\n  options: { force?: boolean; silent?: boolean } = {},\n): InstallTemplatesResult {\n  return installMandatoryTemplates(projectRoot, templatesDir, {\n    ...options,\n    skipIfExists: false, // Don't skip - we want to update\n    mandatoryOnly: false, // Install all templates during update\n  });\n}\n","/**\n * Template metadata defining mandatory vs optional guidelines\n * and their associated validators for enforcement\n *\n * @fileoverview This module defines which guidelines are mandatory for projects\n * using the workflow agent. Mandatory guidelines MUST be present and cannot be\n * skipped during project initialization.\n *\n * TODO: Ensure all new templates have associated unit tests in metadata.test.ts\n */\n\nexport type TemplateCategory = \"workflow\" | \"documentation\" | \"development\";\n\nexport type ValidatorType =\n  | \"branch-name\"\n  | \"commit-message\"\n  | \"pr-title\"\n  | \"implementation-plan\"\n  | \"test-coverage\"\n  | \"file-exists\";\n\nexport interface TemplateMetadata {\n  /** Template filename */\n  filename: string;\n  /** Human-readable name */\n  displayName: string;\n  /** Whether this template is mandatory (cannot be skipped during init) */\n  mandatory: boolean;\n  /** Category for grouping */\n  category: TemplateCategory;\n  /** Associated validators that enforce this template's rules */\n  validators: ValidatorType[];\n  /** Brief description of what this template covers */\n  description: string;\n}\n\n/**\n * Metadata for all available templates\n * Templates marked as mandatory will be auto-generated during init\n * and checked by the doctor command\n */\nexport const templateMetadata: Record<string, TemplateMetadata> = {\n  \"AGENT_EDITING_INSTRUCTIONS.md\": {\n    filename: \"AGENT_EDITING_INSTRUCTIONS.md\",\n    displayName: \"Agent Editing Instructions\",\n    mandatory: true,\n    category: \"workflow\",\n    validators: [\"implementation-plan\"],\n    description:\n      \"Core rules for AI agents: implementation plans, coding standards, architecture\",\n  },\n  \"BRANCHING_STRATEGY.md\": {\n    filename: \"BRANCHING_STRATEGY.md\",\n    displayName: \"Branching Strategy\",\n    mandatory: true,\n    category: \"workflow\",\n    validators: [\"branch-name\", \"pr-title\"],\n    description:\n      \"Git branch naming conventions, PR requirements, merge policies\",\n  },\n  \"TESTING_STRATEGY.md\": {\n    filename: \"TESTING_STRATEGY.md\",\n    displayName: \"Testing Strategy\",\n    mandatory: true,\n    category: \"development\",\n    validators: [\"test-coverage\"],\n    description:\n      \"Testing pyramid, Vitest/Playwright patterns, when tests are required\",\n  },\n  \"SELF_IMPROVEMENT_MANDATE.md\": {\n    filename: \"SELF_IMPROVEMENT_MANDATE.md\",\n    displayName: \"Self-Improvement Mandate\",\n    mandatory: true,\n    category: \"workflow\",\n    validators: [],\n    description: \"Continuous improvement tracking, changelog requirements\",\n  },\n  \"PATTERN_ANALYSIS_WORKFLOW.md\": {\n    filename: \"PATTERN_ANALYSIS_WORKFLOW.md\",\n    displayName: \"Pattern Analysis Workflow\",\n    mandatory: true,\n    category: \"workflow\",\n    validators: [],\n    description:\n      \"AI agent workflow for analyzing codebases, extracting patterns, and updating the central pattern store\",\n  },\n  \"SINGLE_SOURCE_OF_TRUTH.md\": {\n    filename: \"SINGLE_SOURCE_OF_TRUTH.md\",\n    displayName: \"Single Source of Truth\",\n    mandatory: true,\n    category: \"workflow\",\n    validators: [],\n    description:\n      \"Canonical code locations, service patterns, avoiding duplication\",\n  },\n  \"COMPONENT_LIBRARY.md\": {\n    filename: \"COMPONENT_LIBRARY.md\",\n    displayName: \"Component Library\",\n    mandatory: false,\n    category: \"development\",\n    validators: [],\n    description: \"UI component patterns, design tokens, decision tree\",\n  },\n  \"DEPLOYMENT_STRATEGY.md\": {\n    filename: \"DEPLOYMENT_STRATEGY.md\",\n    displayName: \"Deployment Strategy\",\n    mandatory: false,\n    category: \"development\",\n    validators: [],\n    description: \"Deployment workflow, environments, migrations, rollback\",\n  },\n  \"LIBRARY_INVENTORY.md\": {\n    filename: \"LIBRARY_INVENTORY.md\",\n    displayName: \"Library Inventory\",\n    mandatory: true,\n    category: \"development\",\n    validators: [],\n    description: \"Dependency catalog, approved libraries, new library process\",\n  },\n  \"SCOPE_CREATION_WORKFLOW.md\": {\n    filename: \"SCOPE_CREATION_WORKFLOW.md\",\n    displayName: \"Scope Creation Workflow\",\n    mandatory: false,\n    category: \"workflow\",\n    validators: [],\n    description: \"Workflow for AI agents creating custom scopes\",\n  },\n  \"CUSTOM_SCOPE_TEMPLATE.md\": {\n    filename: \"CUSTOM_SCOPE_TEMPLATE.md\",\n    displayName: \"Custom Scope Template\",\n    mandatory: false,\n    category: \"workflow\",\n    validators: [],\n    description: \"Template for defining custom scope packages\",\n  },\n  \"PROJECT_TEMPLATE_README.md\": {\n    filename: \"PROJECT_TEMPLATE_README.md\",\n    displayName: \"Project Template README\",\n    mandatory: false,\n    category: \"documentation\",\n    validators: [],\n    description: \"Meta-document describing project structure\",\n  },\n  \"Guidelines.md\": {\n    filename: \"Guidelines.md\",\n    displayName: \"Custom Guidelines\",\n    mandatory: false,\n    category: \"documentation\",\n    validators: [],\n    description: \"Placeholder for custom user guidelines\",\n  },\n};\n\n/**\n * Get all mandatory templates\n */\nexport function getMandatoryTemplates(): TemplateMetadata[] {\n  return Object.values(templateMetadata).filter((t) => t.mandatory);\n}\n\n/**\n * Get all optional templates\n */\nexport function getOptionalTemplates(): TemplateMetadata[] {\n  return Object.values(templateMetadata).filter((t) => !t.mandatory);\n}\n\n/**\n * Get templates by category\n */\nexport function getTemplatesByCategory(\n  category: TemplateCategory,\n): TemplateMetadata[] {\n  return Object.values(templateMetadata).filter((t) => t.category === category);\n}\n\n/**\n * Get template metadata by filename\n */\nexport function getTemplateMetadata(\n  filename: string,\n): TemplateMetadata | undefined {\n  return templateMetadata[filename];\n}\n\n/**\n * Check if a template is mandatory\n */\nexport function isTemplateMandatory(filename: string): boolean {\n  return templateMetadata[filename]?.mandatory ?? false;\n}\n\n/**\n * Get mandatory template filenames\n */\nexport function getMandatoryTemplateFilenames(): string[] {\n  return getMandatoryTemplates().map((t) => t.filename);\n}\n"],"mappings":";AAeA,SAAS,cAAc,eAAe,YAAY,aAAa,iBAAiB;AAChF,SAAS,MAAM,gBAAgB;AAG/B,IAAM,sBAAsB;AAC5B,IAAM,oBAAoB;AAC1B,IAAM,mBAAmB;AAmBzB,SAAS,aAAa,SAAyB;AAC7C,QAAM,QAAQ,QAAQ,MAAM,aAAa;AACzC,SAAO,QAAQ,MAAM,CAAC,EAAE,KAAK,IAAI;AACnC;AAKA,SAAS,mBAAmB,SAAyB;AAEnD,QAAM,QAAQ,QAAQ,MAAM,IAAI;AAChC,MAAI,aAAa;AACjB,MAAI,cAAc;AAElB,aAAW,QAAQ,OAAO;AACxB,QAAI,KAAK,WAAW,IAAI,GAAG;AACzB,mBAAa;AACb;AAAA,IACF;AACA,QAAI,YAAY;AAEd,UAAI,KAAK,KAAK,MAAM,MAAM,KAAK,WAAW,GAAG,GAAG;AAC9C,YAAI,YAAa;AACjB;AAAA,MACF;AAEA,UAAI,KAAK,WAAW,GAAG,KAAK,KAAK,WAAW,KAAK,KAAK,KAAK,WAAW,IAAI,GAAG;AAC3E;AAAA,MACF;AACA,qBAAe,KAAK,KAAK,IAAI;AAE7B,UAAI,YAAY,SAAS,IAAK;AAAA,IAChC;AAAA,EACF;AAEA,SAAO,YAAY,KAAK,EAAE,MAAM,GAAG,GAAG,KAAK,YAAY,SAAS,MAAM,QAAQ;AAChF;AAMA,SAAS,gBAAgB,SAAiB,WAAmB,GAAa;AACxE,QAAM,QAAkB,CAAC;AAGzB,QAAM,mBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,EACF;AAEA,aAAW,WAAW,kBAAkB;AACtC,UAAM,UAAU,QAAQ,MAAM,OAAO;AACrC,QAAI,SAAS;AACX,iBAAW,SAAS,QAAQ,MAAM,GAAG,CAAC,GAAG;AACvC,cAAM,UAAU,MAAM,QAAQ,SAAS,EAAE,EAAE,QAAQ,YAAY,EAAE,EAAE,KAAK;AACxE,YAAI,QAAQ,SAAS,MAAM,QAAQ,SAAS,OAAO,CAAC,MAAM,SAAS,OAAO,GAAG;AAC3E,gBAAM,KAAK,OAAO;AAAA,QACpB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAGA,QAAM,oBAAoB,QAAQ,MAAM,6FAA6F;AACrI,MAAI,mBAAmB;AACrB,UAAM,UAAU,kBAAkB,CAAC;AACnC,UAAM,YAAY,QAAQ,MAAM,wBAAwB;AACxD,QAAI,WAAW;AACb,iBAAW,QAAQ,UAAU,MAAM,GAAG,CAAC,GAAG;AACxC,cAAM,UAAU,KAAK,QAAQ,gBAAgB,EAAE,EAAE,KAAK;AACtD,YAAI,QAAQ,SAAS,MAAM,QAAQ,SAAS,OAAO,CAAC,MAAM,SAAS,OAAO,GAAG;AAC3E,gBAAM,KAAK,OAAO;AAAA,QACpB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAGA,QAAM,iBAAiB,QAAQ,MAAM,sDAAsD;AAC3F,MAAI,gBAAgB;AAClB,eAAW,SAAS,eAAe,MAAM,GAAG,CAAC,GAAG;AAC9C,YAAM,UAAU,MAAM,QAAQ,gDAAgD,EAAE,EAAE,KAAK;AACvF,UAAI,QAAQ,SAAS,MAAM,QAAQ,SAAS,OAAO,CAAC,MAAM,SAAS,OAAO,GAAG;AAC3E,cAAM,KAAK,OAAO;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AAGA,MAAI,MAAM,SAAS,GAAG;AACpB,UAAM,YAAY,QAAQ,MAAM,oBAAoB;AACpD,QAAI,WAAW;AACb,iBAAW,QAAQ,UAAU,MAAM,GAAG,CAAC,GAAG;AACxC,cAAM,UAAU,KAAK,QAAQ,YAAY,EAAE,EAAE,KAAK;AAClD,YAAI,QAAQ,SAAS,MAAM,QAAQ,SAAS,OAAO,CAAC,MAAM,SAAS,OAAO,GAAG;AAC3E,gBAAM,KAAK,OAAO;AAAA,QACpB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO,MAAM,MAAM,GAAG,QAAQ;AAChC;AAKA,SAAS,eAAe,UAA2C;AACjE,MAAI;AACF,UAAM,UAAU,aAAa,UAAU,OAAO;AAC9C,UAAM,WAAW,SAAS,QAAQ;AAGlC,QAAI,SAAS,WAAW,GAAG,KAAK,aAAa,iBAAiB;AAC5D,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL;AAAA,MACA,OAAO,aAAa,OAAO;AAAA,MAC3B,aAAa,mBAAmB,OAAO;AAAA,MACvC,UAAU,gBAAgB,OAAO;AAAA,IACnC;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKA,SAAS,mBAAmB,aAA4C;AACtE,QAAM,aAAa,KAAK,aAAa,sBAAsB;AAC3D,MAAI,CAAC,WAAW,UAAU,GAAG;AAC3B,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,UAAU,aAAa,YAAY,OAAO;AAChD,WAAO,KAAK,MAAM,OAAO;AAAA,EAC3B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKA,SAAS,qBAAqB,iBAAwC;AACpE,QAAM,aAAa,gBAAgB,QAAQ,mBAAmB;AAC9D,QAAM,WAAW,gBAAgB,QAAQ,iBAAiB;AAE1D,MAAI,eAAe,MAAM,aAAa,MAAM,WAAW,YAAY;AACjE,WAAO,gBAAgB;AAAA,MACrB,aAAa,oBAAoB;AAAA,MACjC;AAAA,IACF,EAAE,KAAK;AAAA,EACT;AAEA,SAAO;AACT;AAKA,SAAS,4BACP,QACA,YACA,eACQ;AACR,QAAM,cAAc,QAAQ,eAAe;AAC3C,QAAM,SAAS,QAAQ,UAAU,CAAC;AAElC,MAAI,UAAU,8BAA8B,WAAW;AAAA;AAAA;AAAA;AAAA,qBAIrC,oBAAI,KAAK,GAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;AAAA;AAAA,EAExD,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAMhB,MAAI,QAAQ;AACV,eAAW,uBAAuB,WAAW;AAAA;AAC7C,eAAW,4BAA4B,OAAO,eAAe,QAAQ;AAAA;AACrE,QAAI,OAAO,SAAS,GAAG;AACrB,iBAAW,2BAA2B,OAAO,IAAI,OAAK,KAAK,EAAE,IAAI,IAAI,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA,IACnF;AACA,eAAW;AAAA,EACb;AAGA,MAAI,OAAO,SAAS,GAAG;AACrB,eAAW;AAAA;AAAA;AAAA;AAAA;AAKX,eAAW,SAAS,OAAO,MAAM,GAAG,EAAE,GAAG;AACvC,iBAAW,OAAO,MAAM,IAAI,QAAQ,MAAM,WAAW;AAAA;AAAA,IACvD;AACA,QAAI,OAAO,SAAS,IAAI;AACtB,iBAAW,4CAA4C,OAAO,MAAM;AAAA;AAAA,IACtE;AACA,eAAW;AAAA,EACb;AAGA,MAAI,WAAW,SAAS,GAAG;AACzB,eAAW;AAAA;AAAA;AAAA;AAAA;AAOX,UAAM,iBAAiB;AAAA,MACrB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAEA,UAAM,mBAAmB,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,GAAG,MAAM;AACtD,YAAM,SAAS,eAAe,QAAQ,EAAE,QAAQ;AAChD,YAAM,SAAS,eAAe,QAAQ,EAAE,QAAQ;AAChD,UAAI,WAAW,MAAM,WAAW,GAAI,QAAO,SAAS;AACpD,UAAI,WAAW,GAAI,QAAO;AAC1B,UAAI,WAAW,GAAI,QAAO;AAC1B,aAAO,EAAE,MAAM,cAAc,EAAE,KAAK;AAAA,IACtC,CAAC;AAED,eAAW,aAAa,kBAAkB;AACxC,iBAAW,OAAO,UAAU,KAAK;AAAA;AAAA,6CAED,UAAU,QAAQ;AAAA;AAAA,EAEtD,UAAU,WAAW;AAAA;AAAA;AAGjB,UAAI,UAAU,SAAS,SAAS,GAAG;AACjC,mBAAW;AAAA;AAEX,mBAAW,QAAQ,UAAU,UAAU;AACrC,qBAAW,KAAK,IAAI;AAAA;AAAA,QACtB;AACA,mBAAW;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAGA,aAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCX,aAAW;AAAA;AAAA,EAEX,mBAAmB;AAAA,EACnB,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAWlB;AAAA,EACC,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAOjB,SAAO;AACT;AAqBO,SAAS,4BACd,aACA,UAAiD,CAAC,GAClC;AAChB,QAAM,EAAE,OAAO,SAAS,OAAO,SAAS,MAAM,IAAI;AAElD,QAAM,gBAAgB,KAAK,aAAa,YAAY;AACpD,QAAM,YAAY,KAAK,aAAa,SAAS;AAC7C,QAAM,aAAa,KAAK,WAAW,yBAAyB;AAG5D,MAAI,CAAC,WAAW,aAAa,GAAG;AAC9B,QAAI,CAAC,QAAQ;AAAA,IAEb;AACA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,UAAU;AAAA,MACV,iBAAiB;AAAA,MACjB,OAAO;AAAA,MACP,wBAAwB;AAAA,MACxB,OAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAM,QAAQ,YAAY,aAAa,EAAE,OAAO,OAAK,EAAE,SAAS,KAAK,CAAC;AACtE,MAAI,MAAM,WAAW,GAAG;AACtB,WAAO;AAAA,MACL,SAAS;AAAA,MACT,UAAU;AAAA,MACV,iBAAiB;AAAA,MACjB,OAAO;AAAA,MACP,wBAAwB;AAAA,MACxB,OAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAM,aAAiC,CAAC;AACxC,aAAW,QAAQ,OAAO;AACxB,UAAM,UAAU,eAAe,KAAK,eAAe,IAAI,CAAC;AACxD,QAAI,SAAS;AACX,iBAAW,KAAK,OAAO;AAAA,IACzB;AAAA,EACF;AAGA,QAAM,SAAS,mBAAmB,WAAW;AAG7C,MAAI,gBAA+B;AACnC,MAAI,QAAQ;AAEZ,MAAI,WAAW,UAAU,GAAG;AAC1B,YAAQ;AACR,UAAM,kBAAkB,aAAa,YAAY,OAAO;AACxD,oBAAgB,qBAAqB,eAAe;AAAA,EACtD;AAGA,QAAM,UAAU,4BAA4B,QAAQ,YAAY,aAAa;AAG7E,MAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,cAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AAAA,EAC1C;AAGA,gBAAc,YAAY,SAAS,OAAO;AAE1C,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU;AAAA,IACV,iBAAiB,WAAW;AAAA,IAC5B;AAAA,IACA,wBAAwB,kBAAkB;AAAA,EAC5C;AACF;;;AC/bO,IAAM,mBAAmB;AAAA;AAAA,EAE9B,iBAAiB;AAAA,EACjB,qBAAqB;AAAA,EACrB,mBAAmB;AAAA,EACnB,oBAAoB;AAAA,EACpB,kBAAkB;AAAA,EAClB,mBAAmB;AAAA;AAAA,EAGnB,yBAAyB;AAAA,EACzB,0BAA0B;AAAA;AAAA,EAG1B,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,uBAAuB;AAAA;AAAA,EAGvB,kBAAkB;AAAA,EAClB,yBAAyB;AAAA,EACzB,uBAAuB;AAAA,EACvB,wBAAwB;AAAA,EACxB,0BAA0B;AAAA,EAC1B,uBAAuB;AAAA,EACvB,4BAA4B;AAAA,EAC5B,4BAA4B;AAAA,EAC5B,yBAAyB;AAAA,EACzB,4BAA4B;AAAA,EAC5B,wBAAwB;AAAA;AAAA,EAGxB,qBAAqB;AAAA,EACrB,6BAA6B;AAAA,EAC7B,4BAA4B;AAAA,EAC5B,0BAA0B;AAAA,EAC1B,2BAA2B;AAAA,EAC3B,+BAA+B;AAAA,EAC/B,2BAA2B;AAAA;AAAA,EAG3B,qBAAqB;AAAA,EACrB,2BAA2B;AAAA,EAC3B,8BAA8B;AAAA,EAC9B,mCACE;AAAA,EACF,+BAA+B;AAAA,EAC/B,wBAAwB;AAAA;AAAA,EAGxB,kCAAkC;AAAA;AAAA,EAGlC,6BAA6B;AAAA,EAC7B,mCAAmC;AAAA;AAAA,EAGnC,0BAA0B;AAAA,EAC1B,8BAA8B;AAChC;AAOO,IAAM,oBAAoB;AAAA,EAC/B,iBAAiB;AAAA,IACf;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,kBAAkB,CAAC,yBAAyB,wBAAwB;AAAA,EACpE,cAAc;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,mBAAmB;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,qBAAqB;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,kBAAkB;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,yBAAyB;AAAA,IACvB;AAAA,EACF;AAAA,EACA,uBAAuB;AAAA,IACrB;AAAA,IACA;AAAA,EACF;AAAA,EACA,uBAAuB;AAAA,IACrB;AAAA,IACA;AAAA,EACF;AACF;AAEO,IAAM,gBAAgB,OAAO,KAAK,gBAAgB,EAAE;;;AC1H3D,SAAS,cAAAA,aAAY,gBAAAC,eAAc,iBAAAC,gBAAe,aAAAC,kBAAiB;AACnE,SAAS,eAAAC,oBAAmB;AAC5B,SAAS,QAAAC,OAAM,YAAAC,iBAAgB;;;ACgCxB,IAAM,mBAAqD;AAAA,EAChE,iCAAiC;AAAA,IAC/B,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC,qBAAqB;AAAA,IAClC,aACE;AAAA,EACJ;AAAA,EACA,yBAAyB;AAAA,IACvB,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC,eAAe,UAAU;AAAA,IACtC,aACE;AAAA,EACJ;AAAA,EACA,uBAAuB;AAAA,IACrB,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC,eAAe;AAAA,IAC5B,aACE;AAAA,EACJ;AAAA,EACA,+BAA+B;AAAA,IAC7B,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC;AAAA,IACb,aAAa;AAAA,EACf;AAAA,EACA,gCAAgC;AAAA,IAC9B,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC;AAAA,IACb,aACE;AAAA,EACJ;AAAA,EACA,6BAA6B;AAAA,IAC3B,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC;AAAA,IACb,aACE;AAAA,EACJ;AAAA,EACA,wBAAwB;AAAA,IACtB,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC;AAAA,IACb,aAAa;AAAA,EACf;AAAA,EACA,0BAA0B;AAAA,IACxB,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC;AAAA,IACb,aAAa;AAAA,EACf;AAAA,EACA,wBAAwB;AAAA,IACtB,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC;AAAA,IACb,aAAa;AAAA,EACf;AAAA,EACA,8BAA8B;AAAA,IAC5B,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC;AAAA,IACb,aAAa;AAAA,EACf;AAAA,EACA,4BAA4B;AAAA,IAC1B,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC;AAAA,IACb,aAAa;AAAA,EACf;AAAA,EACA,8BAA8B;AAAA,IAC5B,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC;AAAA,IACb,aAAa;AAAA,EACf;AAAA,EACA,iBAAiB;AAAA,IACf,UAAU;AAAA,IACV,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY,CAAC;AAAA,IACb,aAAa;AAAA,EACf;AACF;AAKO,SAAS,wBAA4C;AAC1D,SAAO,OAAO,OAAO,gBAAgB,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS;AAClE;AAqCO,SAAS,gCAA0C;AACxD,SAAO,sBAAsB,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ;AACtD;;;ADlKA,SAAS,eAAe,aAA6B;AACnD,MAAI;AACF,UAAM,UAAUC,MAAK,aAAa,cAAc;AAChD,QAAIC,YAAW,OAAO,GAAG;AACvB,YAAM,MAAM,KAAK,MAAMC,cAAa,SAAS,OAAO,CAAC;AACrD,aAAO,IAAI,QAAQC,UAAS,WAAW;AAAA,IACzC;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAOA,UAAS,WAAW;AAC7B;AAKA,SAAS,eACP,UACA,SACQ;AACR,SAAO,SAAS,QAAQ,kBAAkB,CAAC,OAAO,QAAQ;AACxD,WAAO,QAAQ,GAAG,KAAK;AAAA,EACzB,CAAC;AACH;AAMA,SAAS,oBAAoB,aAA6C;AACxE,QAAM,cAAc,eAAe,WAAW;AAE9C,SAAO;AAAA,IACL;AAAA,IACA,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMX,eAAe;AAAA,IACf,aAAa;AAAA,IACb,OAAM,oBAAI,KAAK,GAAE,YAAY,EAAE,SAAS;AAAA,EAC1C;AACF;AAMO,SAAS,uBAAuB,eAAsC;AAG3E,QAAM,gBAAgB;AAAA,IACpBH,MAAK,eAAe,iBAAiB;AAAA,IACrCA,MAAK,eAAe,cAAc;AAAA,IAClCA,MAAK,eAAe,WAAW;AAAA,EACjC;AAEA,aAAW,gBAAgB,eAAe;AACxC,QAAIC,YAAW,YAAY,GAAG;AAC5B,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAMO,SAAS,0BACd,aACA,cACA,UAAmC,CAAC,GACZ;AACxB,QAAM;AAAA,IACJ,QAAQ;AAAA,IACR,eAAe;AAAA,IACf,SAAS;AAAA,IACT,gBAAgB;AAAA,EAClB,IAAI;AAEJ,QAAM,SAAiC;AAAA,IACrC,SAAS;AAAA,IACT,WAAW,CAAC;AAAA,IACZ,SAAS,CAAC;AAAA,IACV,SAAS,CAAC;AAAA,IACV,QAAQ,CAAC;AAAA,IACT,mBAAmB;AAAA,EACrB;AAEA,QAAM,gBAAgBD,MAAK,aAAa,YAAY;AACpD,SAAO,oBAAoBC,YAAW,aAAa;AAGnD,MAAI,OAAO,qBAAqB,gBAAgB,CAAC,OAAO;AACtD,QAAI,CAAC,QAAQ;AACX,cAAQ,IAAI,2DAA2D;AAAA,IACzE;AACA,WAAO;AAAA,EACT;AAGA,QAAM,iBAAiB,8BAA8B;AAGrD,MAAI,CAACA,YAAW,YAAY,GAAG;AAC7B,WAAO,UAAU;AACjB,WAAO,OAAO,KAAK,kCAAkC,YAAY,EAAE;AACnE,WAAO;AAAA,EACT;AAGA,MAAI;AACJ,MAAI;AACF,qBAAiBG,aAAY,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,KAAK,CAAC;AAAA,EAC5E,SAAS,OAAO;AACd,WAAO,UAAU;AACjB,WAAO,OAAO,KAAK,uCAAuC,KAAK,EAAE;AACjE,WAAO;AAAA,EACT;AAGA,QAAM,iBAAiB,gBACnB,eAAe,OAAO,CAAC,MAAM,eAAe,SAAS,CAAC,CAAC,IACvD;AAEJ,MAAI,eAAe,WAAW,GAAG;AAC/B,WAAO,UAAU;AACjB,WAAO,OAAO,KAAK,oCAAoC;AACvD,WAAO;AAAA,EACT;AAGA,QAAM,UAAU,oBAAoB,WAAW;AAG/C,MAAI;AACF,IAAAC,WAAU,eAAe,EAAE,WAAW,KAAK,CAAC;AAAA,EAC9C,SAAS,OAAO;AACd,WAAO,UAAU;AACjB,WAAO,OAAO,KAAK,0CAA0C,KAAK,EAAE;AACpE,WAAO;AAAA,EACT;AAGA,aAAW,YAAY,gBAAgB;AACrC,UAAM,aAAaL,MAAK,cAAc,QAAQ;AAC9C,UAAM,WAAWA,MAAK,eAAe,QAAQ;AAE7C,UAAM,aAAaC,YAAW,QAAQ;AAGtC,QAAI,cAAc,CAAC,OAAO;AACxB,aAAO,QAAQ,KAAK,QAAQ;AAC5B;AAAA,IACF;AAEA,QAAI;AACF,YAAM,WAAWC,cAAa,YAAY,OAAO;AACjD,YAAM,WAAW,eAAe,UAAU,OAAO;AACjD,MAAAI,eAAc,UAAU,UAAU,OAAO;AAEzC,UAAI,YAAY;AACd,eAAO,QAAQ,KAAK,QAAQ;AAAA,MAC9B,OAAO;AACL,eAAO,UAAU,KAAK,QAAQ;AAAA,MAChC;AAAA,IACF,SAAS,OAAO;AACd,aAAO,OAAO,KAAK,qBAAqB,QAAQ,KAAK,KAAK,EAAE;AAAA,IAC9D;AAAA,EACF;AAGA,MAAI,CAAC,QAAQ;AACX,QAAI,OAAO,UAAU,SAAS,GAAG;AAC/B,cAAQ;AAAA,QACN;AAAA,mBAAiB,OAAO,UAAU,MAAM;AAAA,MAC1C;AACA,iBAAW,QAAQ,OAAO,WAAW;AACnC,gBAAQ,IAAI,SAAS,IAAI,EAAE;AAAA,MAC7B;AAAA,IACF;AACA,QAAI,OAAO,QAAQ,SAAS,GAAG;AAC7B,cAAQ,IAAI;AAAA,iBAAe,OAAO,QAAQ,MAAM,uBAAuB;AACvE,iBAAW,QAAQ,OAAO,SAAS;AACjC,gBAAQ,IAAI,SAAS,IAAI,EAAE;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,gBACd,aACA,cACA,UAAiD,CAAC,GAC1B;AACxB,SAAO,0BAA0B,aAAa,cAAc;AAAA,IAC1D,GAAG;AAAA,IACH,cAAc;AAAA;AAAA,IACd,eAAe;AAAA;AAAA,EACjB,CAAC;AACH;","names":["existsSync","readFileSync","writeFileSync","mkdirSync","readdirSync","join","basename","join","existsSync","readFileSync","basename","readdirSync","mkdirSync","writeFileSync"]}

package/dist/chunk-WXHRDBAB.js

@@ -0,0 +1,466 @@
+// src/cli/commands/sync.ts
+import * as p from "@clack/prompts";
+import chalk from "chalk";
+import {
+  PatternStore,
+  PatternAnonymizer,
+  ContributorManager
+} from "@hawkinside_out/workflow-improvement-tracker";
+
+// src/sync/registry-client.ts
+var DEFAULT_REGISTRY_URL = "https://registry-api-rust.vercel.app";
+var RegistryClient = class {
+  baseUrl;
+  timeout;
+  retries;
+  constructor(options = {}) {
+    this.baseUrl = options.baseUrl || process.env.WORKFLOW_REGISTRY_URL || DEFAULT_REGISTRY_URL;
+    this.baseUrl = this.baseUrl.replace(/\/$/, "");
+    this.timeout = options.timeout ?? 3e4;
+    this.retries = options.retries ?? 3;
+  }
+  /**
+   * Push patterns to the registry
+   *
+   * @param patterns - Array of anonymized patterns to push
+   * @param contributorId - Anonymous contributor ID
+   * @returns Push result with count of pushed/skipped patterns
+   * @throws Error if rate limited or push fails
+   */
+  async push(patterns, contributorId) {
+    const payload = {
+      patterns: patterns.map((p2) => ({
+        id: p2.pattern.id,
+        type: p2.type,
+        data: p2.pattern,
+        hash: p2.hash
+      }))
+    };
+    const response = await this.request(
+      "/api/patterns/push",
+      {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-contributor-id": contributorId
+        },
+        body: JSON.stringify(payload)
+      }
+    );
+    return response;
+  }
+  /**
+   * Pull patterns from the registry
+   *
+   * @param options - Pull options
+   * @returns Array of patterns from the registry
+   */
+  async pull(options = {}) {
+    const params = new URLSearchParams();
+    if (options.type) {
+      params.set("type", options.type);
+    }
+    if (options.limit) {
+      params.set("limit", options.limit.toString());
+    }
+    if (options.offset) {
+      params.set("offset", options.offset.toString());
+    }
+    if (options.since) {
+      params.set("since", options.since);
+    }
+    const queryString = params.toString();
+    const url = `/api/patterns/pull${queryString ? `?${queryString}` : ""}`;
+    return this.request(url, {
+      method: "GET"
+    });
+  }
+  /**
+   * Get a single pattern by ID
+   *
+   * @param patternId - UUID of the pattern
+   * @returns Pattern data or null if not found
+   */
+  async getPattern(patternId) {
+    try {
+      return await this.request(`/api/patterns/${patternId}`, {
+        method: "GET"
+      });
+    } catch (error) {
+      if (error instanceof RegistryError && error.statusCode === 404) {
+        return null;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Check if the registry is available
+   */
+  async healthCheck() {
+    try {
+      await this.request("/api/health", {
+        method: "GET"
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Make an HTTP request to the registry
+   */
+  async request(path, options) {
+    const url = `${this.baseUrl}${path}`;
+    let lastError = null;
+    for (let attempt = 1; attempt <= this.retries; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const response = await fetch(url, {
+          ...options,
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (response.status === 429) {
+          const body = await response.json();
+          throw new RateLimitedException(
+            body.message || "Rate limit exceeded",
+            body.resetAt ?? null,
+            body.remaining ?? 0
+          );
+        }
+        if (!response.ok) {
+          const body = await response.json().catch(() => ({}));
+          throw new RegistryError(
+            body.error || `Request failed with status ${response.status}`,
+            response.status,
+            body
+          );
+        }
+        return await response.json();
+      } catch (error) {
+        lastError = error instanceof Error ? error : new Error(String(error));
+        if (error instanceof RateLimitedException) {
+          throw error;
+        }
+        if (error instanceof RegistryError && error.statusCode >= 400 && error.statusCode < 500) {
+          throw error;
+        }
+        if (attempt < this.retries) {
+          await new Promise(
+            (resolve) => setTimeout(resolve, Math.pow(2, attempt) * 1e3)
+          );
+        }
+      }
+    }
+    throw lastError ?? new Error("Request failed after retries");
+  }
+};
+var RegistryError = class extends Error {
+  constructor(message, statusCode, body) {
+    super(message);
+    this.statusCode = statusCode;
+    this.body = body;
+    this.name = "RegistryError";
+  }
+};
+var RateLimitedException = class extends Error {
+  constructor(message, resetAt, remaining) {
+    super(message);
+    this.resetAt = resetAt;
+    this.remaining = remaining;
+    this.name = "RateLimitedException";
+  }
+  /**
+   * Get human-readable time until rate limit resets
+   */
+  getTimeUntilReset() {
+    if (!this.resetAt) {
+      return "unknown";
+    }
+    const resetTime = new Date(this.resetAt).getTime();
+    const now = Date.now();
+    const diffMs = resetTime - now;
+    if (diffMs <= 0) {
+      return "now";
+    }
+    const minutes = Math.ceil(diffMs / 6e4);
+    if (minutes < 60) {
+      return `${minutes} minute${minutes === 1 ? "" : "s"}`;
+    }
+    const hours = Math.ceil(minutes / 60);
+    return `${hours} hour${hours === 1 ? "" : "s"}`;
+  }
+};
+
+// src/cli/commands/sync.ts
+function getWorkspacePath() {
+  return process.cwd();
+}
+async function syncCommand(options) {
+  const cwd = getWorkspacePath();
+  const contributorManager = new ContributorManager(cwd);
+  p.intro(chalk.bgBlue(" workflow sync "));
+  const config = await contributorManager.getConfig();
+  if (!config.success || !config.data?.syncOptIn) {
+    console.log(chalk.yellow("\n\u26A0\uFE0F Sync is not enabled.\n"));
+    console.log(chalk.dim("  To enable sync, run:"));
+    console.log(chalk.dim("    workflow learn config --enable-sync\n"));
+    console.log(
+      chalk.dim(
+        "  This allows you to share anonymized patterns with the community."
+      )
+    );
+    p.outro(chalk.yellow("Sync not enabled"));
+    process.exit(0);
+  }
+  const syncLearn = options.learn || options.all || !options.solutions && !options.scopes;
+  const syncSolutions = options.solutions || options.all;
+  const syncScopes = options.scopes || options.all;
+  let direction = "both";
+  if (options.push && !options.pull) {
+    direction = "push";
+  } else if (options.pull && !options.push) {
+    direction = "pull";
+  } else if (!options.push && !options.pull) {
+    const choice = await p.select({
+      message: "Sync direction:",
+      options: [
+        { value: "push", label: "\u{1F4E4} Push - Upload local patterns to registry" },
+        { value: "pull", label: "\u{1F4E5} Pull - Download patterns from registry" },
+        { value: "both", label: "\u{1F504} Both - Push then pull" }
+      ]
+    });
+    if (p.isCancel(choice)) {
+      p.cancel("Sync cancelled");
+      process.exit(0);
+    }
+    direction = choice;
+  }
+  if (options.dryRun) {
+    console.log(chalk.yellow("\n\u{1F4CB} DRY-RUN MODE: No changes will be synced\n"));
+  }
+  console.log(chalk.cyan("\n\u{1F4E6} Sync scope:"));
+  if (syncLearn) console.log(chalk.dim("  \u2022 Learning patterns (fixes, blueprints)"));
+  if (syncSolutions) console.log(chalk.dim("  \u2022 Solution patterns"));
+  if (syncScopes) console.log(chalk.dim("  \u2022 Custom scopes"));
+  console.log(chalk.dim(`  \u2022 Direction: ${direction === "both" ? "push + pull" : direction}`));
+  console.log("");
+  const store = new PatternStore(cwd);
+  const anonymizer = new PatternAnonymizer();
+  const { fixes, blueprints, solutions } = await store.getPatternsForSync();
+  const patternsToSync = [];
+  if (syncLearn) {
+    console.log(
+      chalk.dim(
+        `  Found ${fixes.length} fixes, ${blueprints.length} blueprints ready to sync`
+      )
+    );
+    for (const fix of fixes) {
+      const result = anonymizer.anonymizeFixPattern(fix);
+      if (result.success && result.data) {
+        patternsToSync.push({
+          pattern: result.data,
+          type: "fix",
+          originalId: fix.id
+        });
+      }
+    }
+    for (const bp of blueprints) {
+      const result = anonymizer.anonymizeBlueprint(bp);
+      if (result.success && result.data) {
+        patternsToSync.push({
+          pattern: result.data,
+          type: "blueprint",
+          originalId: bp.id
+        });
+      }
+    }
+  }
+  if (syncSolutions) {
+    console.log(
+      chalk.dim(
+        `  Found ${solutions.length} solutions ready to sync`
+      )
+    );
+    for (const solution of solutions) {
+      const result = anonymizer.anonymizeSolution(solution);
+      if (result.success && result.data) {
+        patternsToSync.push({
+          pattern: result.data,
+          type: "solution",
+          originalId: solution.id
+        });
+      }
+    }
+  }
+  if (syncScopes) {
+    console.log(chalk.dim("  Scope sync: Coming soon"));
+  }
+  if (direction === "push" || direction === "both") {
+    console.log(chalk.cyan("\n\u{1F4E4} Pushing patterns...\n"));
+    if (patternsToSync.length === 0) {
+      console.log(chalk.yellow("  No patterns to push\n"));
+    } else {
+      const fixCount = patternsToSync.filter((p2) => p2.type === "fix").length;
+      const bpCount = patternsToSync.filter((p2) => p2.type === "blueprint").length;
+      const solutionCount = patternsToSync.filter((p2) => p2.type === "solution").length;
+      console.log(
+        chalk.dim(
+          `  Ready to push: ${fixCount} fixes, ${bpCount} blueprints, ${solutionCount} solutions`
+        )
+      );
+      if (options.dryRun) {
+        console.log(chalk.yellow("\n  [DRY-RUN] Would push patterns to registry"));
+      } else {
+        const contributorResult = await contributorManager.getOrCreateId();
+        if (!contributorResult.success || !contributorResult.data) {
+          console.log(chalk.red("\n  \u274C Failed to get contributor ID"));
+          process.exit(1);
+        }
+        const registryClient = new RegistryClient();
+        try {
+          console.log(chalk.dim("\n  Connecting to registry..."));
+          const pushResult = await registryClient.push(
+            patternsToSync.map((p2) => ({
+              pattern: p2.pattern,
+              type: p2.type
+            })),
+            contributorResult.data
+          );
+          if (pushResult.pushed > 0) {
+            const pushedFixIds = patternsToSync.filter((p2) => p2.type === "fix").map((p2) => p2.originalId);
+            const pushedBpIds = patternsToSync.filter((p2) => p2.type === "blueprint").map((p2) => p2.originalId);
+            const pushedSolutionIds = patternsToSync.filter((p2) => p2.type === "solution").map((p2) => p2.originalId);
+            if (pushedFixIds.length > 0) {
+              await store.markAsSynced(pushedFixIds, "fix");
+            }
+            if (pushedBpIds.length > 0) {
+              await store.markAsSynced(pushedBpIds, "blueprint");
+            }
+            if (pushedSolutionIds.length > 0) {
+              await store.markAsSynced(pushedSolutionIds, "solution");
+            }
+          }
+          console.log(
+            chalk.green(`
+  \u2705 Pushed ${pushResult.pushed} patterns to registry`)
+          );
+          if (pushResult.skipped > 0) {
+            console.log(
+              chalk.dim(`     (${pushResult.skipped} already existed)`)
+            );
+          }
+          if (pushResult.errors && pushResult.errors.length > 0) {
+            console.log(chalk.yellow(`
+  \u26A0\uFE0F Some patterns had errors:`));
+            for (const err of pushResult.errors) {
+              console.log(chalk.dim(`     - ${err}`));
+            }
+          }
+          console.log(
+            chalk.dim(
+              `
+  Rate limit: ${pushResult.rateLimit.remaining} patterns remaining this hour`
+            )
+          );
+        } catch (error) {
+          if (error instanceof RateLimitedException) {
+            console.log(chalk.red("\n  \u274C Rate limit exceeded"));
+            console.log(
+              chalk.dim(
+                `     Try again in ${error.getTimeUntilReset()}`
+              )
+            );
+          } else if (error instanceof RegistryError) {
+            console.log(chalk.red(`
+  \u274C Registry error: ${error.message}`));
+          } else {
+            console.log(
+              chalk.red(
+                `
+  \u274C Failed to push: ${error instanceof Error ? error.message : String(error)}`
+              )
+            );
+          }
+          process.exit(1);
+        }
+      }
+    }
+  }
+  if (direction === "pull" || direction === "both") {
+    console.log(chalk.cyan("\n\u{1F4E5} Pulling patterns from registry...\n"));
+    if (options.dryRun) {
+      console.log(chalk.yellow("  [DRY-RUN] Would pull patterns from registry"));
+    } else {
+      const registryClient = new RegistryClient();
+      try {
+        console.log(chalk.dim("  Connecting to registry..."));
+        const pullTypes = [];
+        if (syncLearn) {
+          pullTypes.push("fix", "blueprint");
+        }
+        if (syncSolutions) {
+          pullTypes.push("solution");
+        }
+        let totalPatterns = 0;
+        let savedCount = 0;
+        for (const pullType of pullTypes) {
+          const pullResult = await registryClient.pull({
+            type: pullType
+          });
+          totalPatterns += pullResult.patterns.length;
+          for (const pulled of pullResult.patterns) {
+            try {
+              if (pulled.type === "fix" && pulled.data) {
+                await store.saveFixPattern(pulled.data);
+                savedCount++;
+              } else if (pulled.type === "blueprint" && pulled.data) {
+                await store.saveBlueprint(pulled.data);
+                savedCount++;
+              } else if (pulled.type === "solution" && pulled.data) {
+                await store.saveSolution(pulled.data);
+                savedCount++;
+              }
+            } catch {
+            }
+          }
+        }
+        if (totalPatterns === 0) {
+          console.log(chalk.dim("  No new patterns to pull"));
+        } else {
+          console.log(
+            chalk.green(`
+  \u2705 Pulled ${savedCount} patterns from registry`)
+          );
+        }
+      } catch (error) {
+        if (error instanceof RateLimitedException) {
+          console.log(chalk.red("\n  \u274C Rate limit exceeded"));
+          console.log(
+            chalk.dim(
+              `     Try again in ${error.getTimeUntilReset()}`
+            )
+          );
+        } else if (error instanceof RegistryError) {
+          console.log(chalk.red(`
+  \u274C Registry error: ${error.message}`));
+        } else {
+          console.log(
+            chalk.red(
+              `
+  \u274C Failed to pull: ${error instanceof Error ? error.message : String(error)}`
+            )
+          );
+        }
+        process.exit(1);
+      }
+    }
+  }
+  p.outro(chalk.green("Sync complete!"));
+}
+
+export {
+  syncCommand
+};
+//# sourceMappingURL=chunk-WXHRDBAB.js.map

package/dist/chunk-WXHRDBAB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/sync.ts","../src/sync/registry-client.ts"],"sourcesContent":["/**\n * Unified Sync Command\n *\n * Orchestrates syncing of patterns and solutions with the registry.\n * Combines functionality from learn:sync and solution sync.\n *\n * Usage:\n *   workflow sync                      # Interactive sync (prompts for direction)\n *   workflow sync --push               # Push local patterns to registry\n *   workflow sync --pull               # Pull patterns from registry\n *   workflow sync --solutions          # Include solution patterns\n *   workflow sync --learn              # Include learning patterns (default)\n *   workflow sync --scopes             # Sync custom scope packages\n *   workflow sync --all                # Sync everything\n *   workflow sync --dry-run            # Preview without syncing\n */\n\nimport * as p from \"@clack/prompts\";\nimport chalk from \"chalk\";\nimport {\n  PatternStore,\n  PatternAnonymizer,\n  ContributorManager,\n  type FixPattern,\n  type Blueprint,\n  type SolutionPattern,\n} from \"@hawkinside_out/workflow-improvement-tracker\";\nimport {\n  RegistryClient,\n  RateLimitedException,\n  RegistryError,\n} from \"../../sync/registry-client.js\";\n\nexport interface UnifiedSyncOptions {\n  push?: boolean;\n  pull?: boolean;\n  solutions?: boolean;\n  learn?: boolean;\n  scopes?: boolean;\n  all?: boolean;\n  dryRun?: boolean;\n}\n\nfunction getWorkspacePath(): string {\n  return process.cwd();\n}\n\n/**\n * Unified sync command that orchestrates all sync operations\n */\nexport async function syncCommand(options: UnifiedSyncOptions): Promise<void> {\n  const cwd = getWorkspacePath();\n  const contributorManager = new ContributorManager(cwd);\n\n  p.intro(chalk.bgBlue(\" workflow sync \"));\n\n  // Check if sync is enabled\n  const config = await contributorManager.getConfig();\n  if (!config.success || !config.data?.syncOptIn) {\n    console.log(chalk.yellow(\"\\n⚠️ Sync is not enabled.\\n\"));\n    console.log(chalk.dim(\"  To enable sync, run:\"));\n    console.log(chalk.dim(\"    workflow learn config --enable-sync\\n\"));\n    console.log(\n      chalk.dim(\n        \"  This allows you to share anonymized patterns with the community.\",\n      ),\n    );\n    p.outro(chalk.yellow(\"Sync not enabled\"));\n    process.exit(0);\n  }\n\n  // Determine what to sync\n  const syncLearn = options.learn || options.all || (!options.solutions && !options.scopes);\n  const syncSolutions = options.solutions || options.all;\n  const syncScopes = options.scopes || options.all;\n\n  // Determine direction\n  let direction: \"push\" | \"pull\" | \"both\" = \"both\";\n  if (options.push && !options.pull) {\n    direction = \"push\";\n  } else if (options.pull && !options.push) {\n    direction = \"pull\";\n  } else if (!options.push && !options.pull) {\n    // Interactive mode - ask user\n    const choice = await p.select({\n      message: \"Sync direction:\",\n      options: [\n        { value: \"push\", label: \"📤 Push - Upload local patterns to registry\" },\n        { value: \"pull\", label: \"📥 Pull - Download patterns from registry\" },\n        { value: \"both\", label: \"🔄 Both - Push then pull\" },\n      ],\n    });\n\n    if (p.isCancel(choice)) {\n      p.cancel(\"Sync cancelled\");\n      process.exit(0);\n    }\n    direction = choice as \"push\" | \"pull\" | \"both\";\n  }\n\n  if (options.dryRun) {\n    console.log(chalk.yellow(\"\\n📋 DRY-RUN MODE: No changes will be synced\\n\"));\n  }\n\n  // Show what will be synced\n  console.log(chalk.cyan(\"\\n📦 Sync scope:\"));\n  if (syncLearn) console.log(chalk.dim(\"  • Learning patterns (fixes, blueprints)\"));\n  if (syncSolutions) console.log(chalk.dim(\"  • Solution patterns\"));\n  if (syncScopes) console.log(chalk.dim(\"  • Custom scopes\"));\n  console.log(chalk.dim(`  • Direction: ${direction === \"both\" ? \"push + pull\" : direction}`));\n  console.log(\"\");\n\n  const store = new PatternStore(cwd);\n  const anonymizer = new PatternAnonymizer();\n\n  // Get patterns to sync\n  const { fixes, blueprints, solutions } = await store.getPatternsForSync();\n\n  // Filter based on options\n  const patternsToSync: Array<{\n    pattern: FixPattern | Blueprint | SolutionPattern;\n    type: \"fix\" | \"blueprint\" | \"solution\";\n    originalId: string;\n  }> = [];\n\n  if (syncLearn) {\n    console.log(\n      chalk.dim(\n        `  Found ${fixes.length} fixes, ${blueprints.length} blueprints ready to sync`,\n      ),\n    );\n\n    for (const fix of fixes) {\n      const result = anonymizer.anonymizeFixPattern(fix);\n      if (result.success && result.data) {\n        patternsToSync.push({\n          pattern: result.data,\n          type: \"fix\",\n          originalId: fix.id,\n        });\n      }\n    }\n\n    for (const bp of blueprints) {\n      const result = anonymizer.anonymizeBlueprint(bp);\n      if (result.success && result.data) {\n        patternsToSync.push({\n          pattern: result.data,\n          type: \"blueprint\",\n          originalId: bp.id,\n        });\n      }\n    }\n  }\n\n  if (syncSolutions) {\n    console.log(\n      chalk.dim(\n        `  Found ${solutions.length} solutions ready to sync`,\n      ),\n    );\n\n    for (const solution of solutions) {\n      const result = anonymizer.anonymizeSolution(solution);\n      if (result.success && result.data) {\n        patternsToSync.push({\n          pattern: result.data,\n          type: \"solution\",\n          originalId: solution.id,\n        });\n      }\n    }\n  }\n\n  if (syncScopes) {\n    // TODO: Implement scope sync when scope registry is available\n    console.log(chalk.dim(\"  Scope sync: Coming soon\"));\n  }\n\n  // PUSH operation\n  if (direction === \"push\" || direction === \"both\") {\n    console.log(chalk.cyan(\"\\n📤 Pushing patterns...\\n\"));\n\n    if (patternsToSync.length === 0) {\n      console.log(chalk.yellow(\"  No patterns to push\\n\"));\n    } else {\n      const fixCount = patternsToSync.filter((p) => p.type === \"fix\").length;\n      const bpCount = patternsToSync.filter((p) => p.type === \"blueprint\").length;\n      const solutionCount = patternsToSync.filter((p) => p.type === \"solution\").length;\n\n      console.log(\n        chalk.dim(\n          `  Ready to push: ${fixCount} fixes, ${bpCount} blueprints, ${solutionCount} solutions`,\n        ),\n      );\n\n      if (options.dryRun) {\n        console.log(chalk.yellow(\"\\n  [DRY-RUN] Would push patterns to registry\"));\n      } else {\n        // Get contributor ID\n        const contributorResult = await contributorManager.getOrCreateId();\n        if (!contributorResult.success || !contributorResult.data) {\n          console.log(chalk.red(\"\\n  ❌ Failed to get contributor ID\"));\n          process.exit(1);\n        }\n\n        // Push to registry\n        const registryClient = new RegistryClient();\n\n        try {\n          console.log(chalk.dim(\"\\n  Connecting to registry...\"));\n\n          const pushResult = await registryClient.push(\n            patternsToSync.map((p) => ({\n              pattern: p.pattern,\n              type: p.type,\n            })),\n            contributorResult.data,\n          );\n\n          // Mark pushed patterns as synced\n          if (pushResult.pushed > 0) {\n            const pushedFixIds = patternsToSync\n              .filter((p) => p.type === \"fix\")\n              .map((p) => p.originalId);\n            const pushedBpIds = patternsToSync\n              .filter((p) => p.type === \"blueprint\")\n              .map((p) => p.originalId);\n            const pushedSolutionIds = patternsToSync\n              .filter((p) => p.type === \"solution\")\n              .map((p) => p.originalId);\n\n            if (pushedFixIds.length > 0) {\n              await store.markAsSynced(pushedFixIds, \"fix\");\n            }\n            if (pushedBpIds.length > 0) {\n              await store.markAsSynced(pushedBpIds, \"blueprint\");\n            }\n            if (pushedSolutionIds.length > 0) {\n              await store.markAsSynced(pushedSolutionIds, \"solution\");\n            }\n          }\n\n          console.log(\n            chalk.green(`\\n  ✅ Pushed ${pushResult.pushed} patterns to registry`),\n          );\n\n          if (pushResult.skipped > 0) {\n            console.log(\n              chalk.dim(`     (${pushResult.skipped} already existed)`),\n            );\n          }\n\n          if (pushResult.errors && pushResult.errors.length > 0) {\n            console.log(chalk.yellow(`\\n  ⚠️ Some patterns had errors:`));\n            for (const err of pushResult.errors) {\n              console.log(chalk.dim(`     - ${err}`));\n            }\n          }\n\n          console.log(\n            chalk.dim(\n              `\\n  Rate limit: ${pushResult.rateLimit.remaining} patterns remaining this hour`,\n            ),\n          );\n        } catch (error) {\n          if (error instanceof RateLimitedException) {\n            console.log(chalk.red(\"\\n  ❌ Rate limit exceeded\"));\n            console.log(\n              chalk.dim(\n                `     Try again in ${error.getTimeUntilReset()}`,\n              ),\n            );\n          } else if (error instanceof RegistryError) {\n            console.log(chalk.red(`\\n  ❌ Registry error: ${error.message}`));\n          } else {\n            console.log(\n              chalk.red(\n                `\\n  ❌ Failed to push: ${error instanceof Error ? error.message : String(error)}`,\n              ),\n            );\n          }\n          process.exit(1);\n        }\n      }\n    }\n  }\n\n  // PULL operation\n  if (direction === \"pull\" || direction === \"both\") {\n    console.log(chalk.cyan(\"\\n📥 Pulling patterns from registry...\\n\"));\n\n    if (options.dryRun) {\n      console.log(chalk.yellow(\"  [DRY-RUN] Would pull patterns from registry\"));\n    } else {\n      const registryClient = new RegistryClient();\n\n      try {\n        console.log(chalk.dim(\"  Connecting to registry...\"));\n\n        // Pull patterns based on sync options - need to call separately for each type\n        const pullTypes: (\"fix\" | \"blueprint\" | \"solution\")[] = [];\n        if (syncLearn) {\n          pullTypes.push(\"fix\", \"blueprint\");\n        }\n        if (syncSolutions) {\n          pullTypes.push(\"solution\");\n        }\n\n        let totalPatterns = 0;\n        let savedCount = 0;\n\n        for (const pullType of pullTypes) {\n          const pullResult = await registryClient.pull({\n            type: pullType,\n          });\n\n          totalPatterns += pullResult.patterns.length;\n\n          for (const pulled of pullResult.patterns) {\n            try {\n              if (pulled.type === \"fix\" && pulled.data) {\n                await store.saveFixPattern(pulled.data as FixPattern);\n                savedCount++;\n              } else if (pulled.type === \"blueprint\" && pulled.data) {\n                await store.saveBlueprint(pulled.data as Blueprint);\n                savedCount++;\n              } else if (pulled.type === \"solution\" && pulled.data) {\n                await store.saveSolution(pulled.data as SolutionPattern);\n                savedCount++;\n              }\n            } catch {\n              // Pattern might already exist\n            }\n          }\n        }\n\n        if (totalPatterns === 0) {\n          console.log(chalk.dim(\"  No new patterns to pull\"));\n        } else {\n          console.log(\n            chalk.green(`\\n  ✅ Pulled ${savedCount} patterns from registry`),\n          );\n        }\n      } catch (error) {\n        if (error instanceof RateLimitedException) {\n          console.log(chalk.red(\"\\n  ❌ Rate limit exceeded\"));\n          console.log(\n            chalk.dim(\n              `     Try again in ${error.getTimeUntilReset()}`,\n            ),\n          );\n        } else if (error instanceof RegistryError) {\n          console.log(chalk.red(`\\n  ❌ Registry error: ${error.message}`));\n        } else {\n          console.log(\n            chalk.red(\n              `\\n  ❌ Failed to pull: ${error instanceof Error ? error.message : String(error)}`,\n            ),\n          );\n        }\n        process.exit(1);\n      }\n    }\n  }\n\n  p.outro(chalk.green(\"Sync complete!\"));\n}\n","/**\n * Registry Client for pattern sync\n *\n * HTTP client for pushing patterns to and pulling patterns from\n * the community pattern registry.\n */\n\nimport type { FixPattern, Blueprint, SolutionPattern } from \"@hawkinside_out/workflow-improvement-tracker\";\n\n// Default registry URL\nconst DEFAULT_REGISTRY_URL = \"https://registry-api-rust.vercel.app\";\n\n/**\n * Pattern payload for push/pull operations\n */\nexport interface RegistryPattern {\n  id: string;\n  type: \"fix\" | \"blueprint\" | \"solution\";\n  data: Record<string, unknown>;\n  hash?: string;\n  createdAt?: string;\n}\n\n/**\n * Push response from registry\n */\nexport interface PushResponse {\n  status: \"ok\" | \"error\";\n  pushed: number;\n  skipped: number;\n  errors?: string[];\n  rateLimit: {\n    remaining: number;\n    resetAt: string | null;\n  };\n}\n\n/**\n * Pull response from registry\n */\nexport interface PullResponse {\n  patterns: RegistryPattern[];\n  pagination: {\n    offset: number;\n    limit: number;\n    total: number;\n    hasMore: boolean;\n  };\n}\n\n/**\n * Rate limit error details\n */\nexport interface RateLimitError {\n  message: string;\n  resetAt: string | null;\n  remaining: number;\n}\n\n/**\n * Registry client options\n */\nexport interface RegistryClientOptions {\n  /**\n   * Base URL of the registry API\n   * Defaults to https://patterns.workflow-agent.dev\n   * Can be overridden via WORKFLOW_REGISTRY_URL env var\n   */\n  baseUrl?: string;\n\n  /**\n   * Request timeout in milliseconds\n   * Defaults to 30000 (30 seconds)\n   */\n  timeout?: number;\n\n  /**\n   * Number of retry attempts for failed requests\n   * Defaults to 3\n   */\n  retries?: number;\n}\n\n/**\n * Registry Client\n *\n * Handles HTTP communication with the pattern registry API\n */\nexport class RegistryClient {\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n  private readonly retries: number;\n\n  constructor(options: RegistryClientOptions = {}) {\n    // Priority: options > env var > default\n    this.baseUrl =\n      options.baseUrl ||\n      process.env.WORKFLOW_REGISTRY_URL ||\n      DEFAULT_REGISTRY_URL;\n\n    // Ensure no trailing slash\n    this.baseUrl = this.baseUrl.replace(/\\/$/, \"\");\n\n    this.timeout = options.timeout ?? 30000;\n    this.retries = options.retries ?? 3;\n  }\n\n  /**\n   * Push patterns to the registry\n   *\n   * @param patterns - Array of anonymized patterns to push\n   * @param contributorId - Anonymous contributor ID\n   * @returns Push result with count of pushed/skipped patterns\n   * @throws Error if rate limited or push fails\n   */\n  async push(\n    patterns: Array<{\n      pattern: FixPattern | Blueprint | SolutionPattern;\n      type: \"fix\" | \"blueprint\" | \"solution\";\n      hash?: string;\n    }>,\n    contributorId: string,\n  ): Promise<PushResponse> {\n    const payload = {\n      patterns: patterns.map((p) => ({\n        id: p.pattern.id,\n        type: p.type,\n        data: p.pattern as unknown as Record<string, unknown>,\n        hash: p.hash,\n      })),\n    };\n\n    const response = await this.request<PushResponse>(\n      \"/api/patterns/push\",\n      {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"x-contributor-id\": contributorId,\n        },\n        body: JSON.stringify(payload),\n      },\n    );\n\n    return response;\n  }\n\n  /**\n   * Pull patterns from the registry\n   *\n   * @param options - Pull options\n   * @returns Array of patterns from the registry\n   */\n  async pull(options: {\n    type?: \"fix\" | \"blueprint\" | \"solution\";\n    limit?: number;\n    offset?: number;\n    since?: string;\n  } = {}): Promise<PullResponse> {\n    const params = new URLSearchParams();\n\n    if (options.type) {\n      params.set(\"type\", options.type);\n    }\n    if (options.limit) {\n      params.set(\"limit\", options.limit.toString());\n    }\n    if (options.offset) {\n      params.set(\"offset\", options.offset.toString());\n    }\n    if (options.since) {\n      params.set(\"since\", options.since);\n    }\n\n    const queryString = params.toString();\n    const url = `/api/patterns/pull${queryString ? `?${queryString}` : \"\"}`;\n\n    return this.request<PullResponse>(url, {\n      method: \"GET\",\n    });\n  }\n\n  /**\n   * Get a single pattern by ID\n   *\n   * @param patternId - UUID of the pattern\n   * @returns Pattern data or null if not found\n   */\n  async getPattern(patternId: string): Promise<RegistryPattern | null> {\n    try {\n      return await this.request<RegistryPattern>(`/api/patterns/${patternId}`, {\n        method: \"GET\",\n      });\n    } catch (error) {\n      if (error instanceof RegistryError && error.statusCode === 404) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Check if the registry is available\n   */\n  async healthCheck(): Promise<boolean> {\n    try {\n      await this.request<{ status: string }>(\"/api/health\", {\n        method: \"GET\",\n      });\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Make an HTTP request to the registry\n   */\n  private async request<T>(\n    path: string,\n    options: RequestInit,\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    let lastError: Error | null = null;\n\n    for (let attempt = 1; attempt <= this.retries; attempt++) {\n      try {\n        const controller = new AbortController();\n        const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n        const response = await fetch(url, {\n          ...options,\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (response.status === 429) {\n          // Rate limited\n          const body = await response.json() as { message?: string; resetAt?: string | null; remaining?: number };\n          throw new RateLimitedException(\n            body.message || \"Rate limit exceeded\",\n            body.resetAt ?? null,\n            body.remaining ?? 0,\n          );\n        }\n\n        if (!response.ok) {\n          const body = await response.json().catch(() => ({})) as { error?: string };\n          throw new RegistryError(\n            body.error || `Request failed with status ${response.status}`,\n            response.status,\n            body,\n          );\n        }\n\n        return await response.json() as T;\n      } catch (error) {\n        lastError = error instanceof Error ? error : new Error(String(error));\n\n        // Don't retry rate limit errors\n        if (error instanceof RateLimitedException) {\n          throw error;\n        }\n\n        // Don't retry on 4xx errors (except timeout)\n        if (\n          error instanceof RegistryError &&\n          error.statusCode >= 400 &&\n          error.statusCode < 500\n        ) {\n          throw error;\n        }\n\n        // Wait before retrying (exponential backoff)\n        if (attempt < this.retries) {\n          await new Promise((resolve) =>\n            setTimeout(resolve, Math.pow(2, attempt) * 1000)\n          );\n        }\n      }\n    }\n\n    throw lastError ?? new Error(\"Request failed after retries\");\n  }\n}\n\n/**\n * Registry API error\n */\nexport class RegistryError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly body?: unknown,\n  ) {\n    super(message);\n    this.name = \"RegistryError\";\n  }\n}\n\n/**\n * Rate limit exceeded error\n */\nexport class RateLimitedException extends Error {\n  constructor(\n    message: string,\n    public readonly resetAt: string | null,\n    public readonly remaining: number,\n  ) {\n    super(message);\n    this.name = \"RateLimitedException\";\n  }\n\n  /**\n   * Get human-readable time until rate limit resets\n   */\n  getTimeUntilReset(): string {\n    if (!this.resetAt) {\n      return \"unknown\";\n    }\n\n    const resetTime = new Date(this.resetAt).getTime();\n    const now = Date.now();\n    const diffMs = resetTime - now;\n\n    if (diffMs <= 0) {\n      return \"now\";\n    }\n\n    const minutes = Math.ceil(diffMs / 60000);\n    if (minutes < 60) {\n      return `${minutes} minute${minutes === 1 ? \"\" : \"s\"}`;\n    }\n\n    const hours = Math.ceil(minutes / 60);\n    return `${hours} hour${hours === 1 ? \"\" : \"s\"}`;\n  }\n}\n"],"mappings":"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","names":["p","p"]}