workflow-agent-cli 2.11.0 → 2.13.0

package/README.md

@@ -67,7 +67,7 @@ yarn add -D workflow-agent-cli
 > pnpm workflow-agent setup
 > ```
 
-On install (npm/yarn) or after running setup (pnpm), **31 workflow scripts** are automatically added to your `package.json`:
+On install (npm/yarn) or after running setup (pnpm), **38 workflow scripts** are automatically added to your `package.json`:
 
 ```json
 {
@@ -94,6 +94,7 @@ On install (npm/yarn) or after running setup (pnpm), **31 workflow scripts** are
     "workflow:learn:record": "workflow-agent learn:record",
     "workflow:learn:list": "workflow-agent learn:list",
     "workflow:learn:apply": "workflow-agent learn:apply",
+    "workflow:learn:publish": "workflow-agent learn:publish",
     "workflow:learn:sync": "workflow-agent learn:sync",
     "workflow:learn:config": "workflow-agent learn:config",
     "workflow:learn:deprecate": "workflow-agent learn:deprecate",

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

@@ -336,6 +336,7 @@ var WORKFLOW_SCRIPTS = {
   "workflow:learn:record": "workflow-agent learn:record",
   "workflow:learn:list": "workflow-agent learn:list",
   "workflow:learn:apply": "workflow-agent learn:apply",
+  "workflow:learn:publish": "workflow-agent learn:publish",
   "workflow:learn:sync": "workflow-agent learn:sync",
   "workflow:learn:config": "workflow-agent learn:config",
   "workflow:learn:deprecate": "workflow-agent learn:deprecate",
@@ -384,6 +385,7 @@ var SCRIPT_CATEGORIES = {
     "workflow:learn:record",
     "workflow:learn:list",
     "workflow:learn:apply",
+    "workflow:learn:publish",
     "workflow:learn:sync",
     "workflow:learn:config",
     "workflow:learn:deprecate",
@@ -699,4 +701,4 @@ export {
   installMandatoryTemplates,
   updateTemplates
 };
-//# sourceMappingURL=chunk-L2STT7MN.js.map
+//# sourceMappingURL=chunk-RIEMQEMP.js.map

package/dist/chunk-RIEMQEMP.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: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: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-L2STT7MN.js";
+} from "../chunk-RIEMQEMP.js";
 import {
   autoFixConfigFile,
   validateScopeDefinitions
@@ -5807,6 +5807,155 @@ async function learnConfigCommand(options) {
     );
   }
 }
+async function learnPublishCommand(patternId, options) {
+  const cwd = getWorkspacePath();
+  const store = new PatternStore2(cwd);
+  const makePrivate = options.private ?? false;
+  const actionWord = makePrivate ? "private" : "public";
+  const emoji = makePrivate ? "\u{1F512}" : "\u{1F310}";
+  console.log(chalk16.cyan(`
+${emoji} Mark Pattern(s) ${actionWord}
+`));
+  if (options.all) {
+    const fixesResult = await store.listFixPatterns({});
+    const blueprintsResult = await store.listBlueprints({});
+    const allFixes = fixesResult.success && fixesResult.data ? fixesResult.data : [];
+    const allBlueprints = blueprintsResult.success && blueprintsResult.data ? blueprintsResult.data : [];
+    const fixesToUpdate = allFixes.filter((p13) => p13.isPrivate !== makePrivate);
+    const blueprintsToUpdate = allBlueprints.filter(
+      (p13) => p13.isPrivate !== makePrivate
+    );
+    const totalToUpdate = fixesToUpdate.length + blueprintsToUpdate.length;
+    if (totalToUpdate === 0) {
+      console.log(
+        chalk16.yellow(`  All patterns are already ${actionWord}. Nothing to do.`)
+      );
+      return;
+    }
+    console.log(
+      chalk16.white(
+        `  Found ${totalToUpdate} pattern(s) to mark as ${actionWord}:`
+      )
+    );
+    console.log(chalk16.dim(`    Fix Patterns: ${fixesToUpdate.length}`));
+    console.log(chalk16.dim(`    Blueprints: ${blueprintsToUpdate.length}`));
+    if (!options.yes) {
+      const confirmed = await p11.confirm({
+        message: `Mark all ${totalToUpdate} patterns as ${actionWord}?`,
+        initialValue: false
+      });
+      if (p11.isCancel(confirmed) || !confirmed) {
+        p11.cancel("Cancelled");
+        return;
+      }
+    }
+    let successCount = 0;
+    let failCount = 0;
+    for (const pattern2 of fixesToUpdate) {
+      const result2 = await store.saveFixPattern({
+        ...pattern2,
+        isPrivate: makePrivate,
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      if (result2.success) {
+        successCount++;
+      } else {
+        failCount++;
+      }
+    }
+    for (const blueprint of blueprintsToUpdate) {
+      const result2 = await store.saveBlueprint({
+        ...blueprint,
+        isPrivate: makePrivate,
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      if (result2.success) {
+        successCount++;
+      } else {
+        failCount++;
+      }
+    }
+    console.log(
+      chalk16.green(`
+\u2705 Updated ${successCount} pattern(s) to ${actionWord}`)
+    );
+    if (failCount > 0) {
+      console.log(chalk16.red(`\u274C Failed to update ${failCount} pattern(s)`));
+    }
+    return;
+  }
+  if (!patternId) {
+    console.log(chalk16.red("\u274C Pattern ID is required"));
+    console.log(
+      chalk16.dim("  Usage: workflow learn:publish <patternId> [--private]")
+    );
+    console.log(
+      chalk16.dim("         workflow learn:publish --all [--private]")
+    );
+    process.exit(1);
+  }
+  let patternType = "fix";
+  let pattern = await store.getFixPattern(patternId);
+  if (!pattern.success || !pattern.data) {
+    const bpResult = await store.getBlueprint(patternId);
+    if (bpResult.success && bpResult.data) {
+      pattern = bpResult;
+      patternType = "blueprint";
+    } else {
+      console.log(chalk16.red(`
+\u274C Pattern not found: ${patternId}`));
+      console.log(
+        chalk16.dim("  Use 'workflow learn:list' to see available patterns")
+      );
+      process.exit(1);
+    }
+  }
+  const currentStatus = pattern.data.isPrivate ? "private" : "public";
+  if (pattern.data.isPrivate === makePrivate) {
+    console.log(
+      chalk16.yellow(`  Pattern is already ${actionWord}. Nothing to do.`)
+    );
+    console.log(chalk16.dim(`  Name: ${pattern.data.name}`));
+    return;
+  }
+  console.log(chalk16.white(`  Pattern: ${pattern.data.name}`));
+  console.log(chalk16.dim(`  Type: ${patternType}`));
+  console.log(chalk16.dim(`  Current: ${currentStatus} \u2192 ${actionWord}`));
+  if (!options.yes) {
+    const confirmed = await p11.confirm({
+      message: `Mark this pattern as ${actionWord}?`,
+      initialValue: true
+    });
+    if (p11.isCancel(confirmed) || !confirmed) {
+      p11.cancel("Cancelled");
+      return;
+    }
+  }
+  const updatedPattern = {
+    ...pattern.data,
+    isPrivate: makePrivate,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  let result;
+  if (patternType === "fix") {
+    result = await store.saveFixPattern(updatedPattern);
+  } else {
+    result = await store.saveBlueprint(updatedPattern);
+  }
+  if (result.success) {
+    console.log(chalk16.green(`
+\u2705 Pattern marked as ${actionWord}`));
+    if (!makePrivate) {
+      console.log(
+        chalk16.dim("  Run 'workflow learn:sync --push' to upload to registry")
+      );
+    }
+  } else {
+    console.log(chalk16.red(`
+\u274C Failed: ${result.error}`));
+    process.exit(1);
+  }
+}
 async function learnDeprecateCommand(patternId, reason) {
   const cwd = getWorkspacePath();
   const store = new PatternStore2(cwd);
@@ -6394,6 +6543,7 @@ program.command("learn:apply <patternId>").description("Apply a pattern to the c
 program.command("learn:sync").description("Sync patterns with remote registry").option("--push", "Push local patterns to registry").option("--pull", "Pull patterns from registry").option("--dry-run", "Preview without syncing").action(learnSyncCommand);
 program.command("learn:config").description("Configure learning settings").option("--enable-sync", "Enable pattern sync").option("--disable-sync", "Disable pattern sync").option("--enable-telemetry", "Enable anonymous telemetry").option("--disable-telemetry", "Disable telemetry").option("--reset-id", "Reset contributor ID").option("--show", "Show current configuration").action(learnConfigCommand);
 program.command("learn:deprecate <patternId> <reason>").description("Deprecate an outdated pattern").argument("<patternId>", "Pattern ID to deprecate").argument("<reason>", "Reason for deprecation").action(learnDeprecateCommand);
+program.command("learn:publish [patternId]").description("Mark pattern(s) as public for syncing").option("--private", "Mark as private instead of public").option("--all", "Apply to all patterns").option("-y, --yes", "Skip confirmation prompts").action(learnPublishCommand);
 program.command("learn:stats").description("Show learning statistics").action(learnStatsCommand);
 program.command("solution:capture").description("Capture a solution pattern from working code").option("--name <name>", "Solution name").option("--description <desc>", "Solution description").option(
   "--category <cat>",