workflow-agent-cli 2.13.1 → 2.14.1

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

@@ -338,6 +338,8 @@ var WORKFLOW_SCRIPTS = {
   "workflow:learn:apply": "workflow-agent learn:apply",
   "workflow:learn:publish": "workflow-agent learn:publish",
   "workflow:learn:sync": "workflow-agent learn:sync",
+  "workflow:learn:sync:push": "workflow-agent learn:sync --push",
+  "workflow:learn:sync:pull": "workflow-agent learn:sync --pull",
   "workflow:learn:config": "workflow-agent learn:config",
   "workflow:learn:deprecate": "workflow-agent learn:deprecate",
   "workflow:learn:stats": "workflow-agent learn:stats",
@@ -387,6 +389,8 @@ var SCRIPT_CATEGORIES = {
     "workflow:learn:apply",
     "workflow:learn:publish",
     "workflow:learn:sync",
+    "workflow:learn:sync:push",
+    "workflow:learn:sync:pull",
     "workflow:learn:config",
     "workflow:learn:deprecate",
     "workflow:learn:stats"
@@ -701,4 +705,4 @@ export {
   installMandatoryTemplates,
   updateTemplates
 };
-//# sourceMappingURL=chunk-RIEMQEMP.js.map
+//# sourceMappingURL=chunk-Q2B25XH2.js.map

package/dist/chunk-Q2B25XH2.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 = 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":"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","names":["existsSync","readFileSync","writeFileSync","mkdirSync","readdirSync","join","basename","join","existsSync","readFileSync","basename","readdirSync","mkdirSync","writeFileSync"]}

package/dist/cli/index.js

@@ -31,7 +31,7 @@ import {
   installMandatoryTemplates,
   templateMetadata,
   updateTemplates
-} from "../chunk-RIEMQEMP.js";
+} from "../chunk-Q2B25XH2.js";
 import {
   autoFixConfigFile,
   validateScopeDefinitions
@@ -5232,6 +5232,194 @@ import {
   PatternAnonymizer,
   TelemetryCollector as TelemetryCollector2
 } from "@hawkinside_out/workflow-improvement-tracker";
+
+// src/sync/registry-client.ts
+var DEFAULT_REGISTRY_URL = "https://patterns.workflow-agent.dev";
+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((p13) => ({
+        id: p13.pattern.id,
+        type: p13.type,
+        data: p13.pattern,
+        hash: p13.hash
+      }))
+    };
+    const response = await this.request(
+      "/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 = `/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(`/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("/health", {
+        method: "GET"
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Make an HTTP request to the registry
+   */
+  async request(path3, options) {
+    const url = `${this.baseUrl}${path3}`;
+    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,
+            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(
+            (resolve2) => setTimeout(resolve2, 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/learn.ts
 function getWorkspacePath() {
   return process.cwd();
 }
@@ -5675,37 +5863,213 @@ async function learnSyncCommand(options) {
   );
   if (options.push) {
     console.log(chalk16.cyan("\n\u{1F4E4} Pushing patterns...\n"));
-    let anonymizedFixes = 0;
-    let anonymizedBlueprints = 0;
+    const anonymizedPatterns = [];
     for (const fix of fixes) {
       const result = anonymizer.anonymizeFixPattern(fix);
-      if (result.success) {
-        anonymizedFixes++;
-        if (!options.dryRun) {
-          console.log(chalk16.dim(`  \u2713 Anonymized: ${fix.name}`));
-        }
+      if (result.success && result.data) {
+        anonymizedPatterns.push({
+          pattern: result.data,
+          type: "fix",
+          originalId: fix.id
+        });
+        console.log(chalk16.dim(`  \u2713 Anonymized: ${fix.name}`));
       }
     }
     for (const bp of blueprints) {
       const result = anonymizer.anonymizeBlueprint(bp);
-      if (result.success) {
-        anonymizedBlueprints++;
-        if (!options.dryRun) {
-          console.log(chalk16.dim(`  \u2713 Anonymized: ${bp.name}`));
-        }
+      if (result.success && result.data) {
+        anonymizedPatterns.push({
+          pattern: result.data,
+          type: "blueprint",
+          originalId: bp.id
+        });
+        console.log(chalk16.dim(`  \u2713 Anonymized: ${bp.name}`));
       }
     }
+    const fixCount = anonymizedPatterns.filter((p13) => p13.type === "fix").length;
+    const bpCount = anonymizedPatterns.filter((p13) => p13.type === "blueprint").length;
+    if (anonymizedPatterns.length === 0) {
+      console.log(chalk16.yellow("\n\u26A0\uFE0F No patterns to push"));
+      return;
+    }
     console.log(
-      chalk16.green(
+      chalk16.dim(
         `
-\u2705 Ready to push ${anonymizedFixes} fixes and ${anonymizedBlueprints} blueprints`
+  Ready to push ${fixCount} fixes and ${bpCount} blueprints`
       )
     );
-    console.log(chalk16.dim("  (Registry push not yet implemented)"));
+    if (options.dryRun) {
+      console.log(chalk16.yellow("\n\u{1F4CB} DRY-RUN: Patterns would be pushed (no actual changes)"));
+      return;
+    }
+    const contributorResult = await contributorManager.getOrCreateId();
+    if (!contributorResult.success || !contributorResult.data) {
+      console.log(chalk16.red("\n\u274C Failed to get contributor ID"));
+      return;
+    }
+    const registryClient = new RegistryClient();
+    try {
+      console.log(chalk16.dim("\n  Connecting to registry..."));
+      const pushResult = await registryClient.push(
+        anonymizedPatterns.map((p13) => ({
+          pattern: p13.pattern,
+          type: p13.type
+        })),
+        contributorResult.data
+      );
+      if (pushResult.pushed > 0) {
+        const pushedFixIds = anonymizedPatterns.filter((p13) => p13.type === "fix").map((p13) => p13.originalId);
+        const pushedBpIds = anonymizedPatterns.filter((p13) => p13.type === "blueprint").map((p13) => p13.originalId);
+        if (pushedFixIds.length > 0) {
+          await store.markAsSynced(pushedFixIds, "fix");
+        }
+        if (pushedBpIds.length > 0) {
+          await store.markAsSynced(pushedBpIds, "blueprint");
+        }
+      }
+      console.log(
+        chalk16.green(`
+\u2705 Successfully pushed ${pushResult.pushed} patterns to registry`)
+      );
+      if (pushResult.skipped > 0) {
+        console.log(
+          chalk16.dim(`   (${pushResult.skipped} patterns already existed)`)
+        );
+      }
+      if (pushResult.errors && pushResult.errors.length > 0) {
+        console.log(chalk16.yellow(`
+\u26A0\uFE0F Some patterns had errors:`));
+        for (const err of pushResult.errors) {
+          console.log(chalk16.dim(`   - ${err}`));
+        }
+      }
+      console.log(
+        chalk16.dim(
+          `
+  Rate limit: ${pushResult.rateLimit.remaining} patterns remaining this hour`
+        )
+      );
+    } catch (error) {
+      if (error instanceof RateLimitedException) {
+        console.log(chalk16.red("\n\u274C Rate limit exceeded"));
+        console.log(
+          chalk16.dim(
+            `   Try again in ${error.getTimeUntilReset()}`
+          )
+        );
+      } else if (error instanceof RegistryError) {
+        console.log(chalk16.red(`
+\u274C Registry error: ${error.message}`));
+      } else {
+        console.log(
+          chalk16.red(
+            `
+\u274C Failed to push: ${error instanceof Error ? error.message : String(error)}`
+          )
+        );
+      }
+      process.exit(1);
+    }
   }
   if (options.pull) {
     console.log(chalk16.cyan("\n\u{1F4E5} Pulling patterns from registry...\n"));
-    console.log(chalk16.dim("  (Registry pull not yet implemented)"));
+    if (options.dryRun) {
+      console.log(chalk16.yellow("\u{1F4CB} DRY-RUN: Would pull patterns (no actual changes)\n"));
+      const registryClient2 = new RegistryClient();
+      try {
+        const result = await registryClient2.pull({ limit: 10 });
+        console.log(chalk16.dim(`  Registry has ${result.pagination.total} patterns available`));
+        if (result.patterns.length > 0) {
+          console.log(chalk16.dim("\n  First 10 patterns:"));
+          for (const p13 of result.patterns) {
+            console.log(chalk16.dim(`    - [${p13.type}] ${p13.data.name || p13.id}`));
+          }
+          if (result.pagination.hasMore) {
+            console.log(chalk16.dim(`    ... and ${result.pagination.total - 10} more`));
+          }
+        }
+      } catch (error) {
+        console.log(
+          chalk16.red(
+            `  Failed to connect: ${error instanceof Error ? error.message : String(error)}`
+          )
+        );
+      }
+      return;
+    }
+    const registryClient = new RegistryClient();
+    try {
+      console.log(chalk16.dim("  Connecting to registry..."));
+      let totalPulled = 0;
+      let totalSkipped = 0;
+      let offset = 0;
+      const limit = 50;
+      while (true) {
+        const result = await registryClient.pull({ limit, offset });
+        if (result.patterns.length === 0) {
+          break;
+        }
+        for (const pattern of result.patterns) {
+          let exists = false;
+          if (pattern.type === "fix") {
+            const existingResult = await store.getFixPattern(pattern.id);
+            exists = existingResult.success && !!existingResult.data;
+          } else if (pattern.type === "blueprint") {
+            const existingResult = await store.getBlueprint(pattern.id);
+            exists = existingResult.success && !!existingResult.data;
+          }
+          if (exists) {
+            totalSkipped++;
+            continue;
+          }
+          if (pattern.type === "fix") {
+            const fixData = pattern.data;
+            await store.saveFixPattern({
+              ...fixData,
+              id: pattern.id,
+              source: "community",
+              isPrivate: true
+              // Keep pulled patterns private by default
+            });
+            totalPulled++;
+          } else if (pattern.type === "blueprint") {
+            const bpData = pattern.data;
+            await store.saveBlueprint({
+              ...bpData,
+              id: pattern.id,
+              source: "community",
+              isPrivate: true
+            });
+            totalPulled++;
+          }
+        }
+        if (!result.pagination.hasMore) {
+          break;
+        }
+        offset += limit;
+        console.log(chalk16.dim(`  ... pulled ${offset} patterns so far`));
+      }
+      console.log(
+        chalk16.green(`
+\u2705 Pulled ${totalPulled} new patterns from registry`)
+      );
+      if (totalSkipped > 0) {
+        console.log(chalk16.dim(`   (${totalSkipped} patterns already existed locally)`));
+      }
+    } catch (error) {
+      if (error instanceof RegistryError) {
+        console.log(chalk16.red(`
+\u274C Registry error: ${error.message}`));
+      } else {
+        console.log(
+          chalk16.red(
+            `
+\u274C Failed to pull: ${error instanceof Error ? error.message : String(error)}`
+          )
+        );
+      }
+      process.exit(1);
+    }
   }
   if (!options.push && !options.pull) {
     console.log(