@specforge/cli 0.1.0

package/dist/lib/workflow-definitions.js

@@ -0,0 +1,497 @@
+const CREATION_WORKFLOW = {
+  name: "creation",
+  description: "Create specifications, epics, and tickets with rich context",
+  philosophy: [
+    "One entity at a time - never bulk create",
+    "More context = better AI implementation",
+    "When in doubt, ask the user",
+    "Invest in planning for first-run success"
+  ],
+  steps: [
+    {
+      step: 1,
+      name: "understand_requirements",
+      description: "Gather comprehensive requirements from user",
+      tools: [],
+      tips: [
+        "Ask about the problem being solved",
+        "Understand the target users",
+        "Clarify scope boundaries",
+        "Identify constraints and risks"
+      ]
+    },
+    {
+      step: 2,
+      name: "create_specification",
+      description: "Create specification with full context",
+      tools: ["specification.create"],
+      tips: [
+        "Include background and goals",
+        "Define guardrails (what NOT to do)",
+        "Set codeStandards for consistency",
+        "Add architecture overview"
+      ]
+    },
+    {
+      step: 3,
+      name: "plan_epics",
+      description: "Identify logical phases/groupings, discuss with user",
+      tools: [],
+      tips: [
+        "Break work into cohesive units",
+        "Consider dependencies between phases",
+        "Discuss timeline and priority with user",
+        "Keep epic count manageable (3-7 typical)"
+      ]
+    },
+    {
+      step: 4,
+      name: "create_epic",
+      description: "Create ONE epic with full context",
+      tools: ["epic.create"],
+      tips: [
+        "Define clear objective",
+        "Set scope boundaries",
+        "Include sharedPatterns for consistency",
+        "Add any epic-specific guardrails"
+      ]
+    },
+    {
+      step: 5,
+      name: "plan_tickets",
+      description: "Break epic into tickets, discuss dependencies with user",
+      tools: [],
+      tips: [
+        "Keep tickets small and focused",
+        "Identify clear acceptance criteria",
+        "Map out dependencies before creating",
+        "Discuss complexity with user"
+      ]
+    },
+    {
+      step: 6,
+      name: "create_ticket",
+      description: "Create ONE ticket with full details",
+      tools: ["ticket.create"],
+      tips: [
+        "Write detailed acceptanceCriteria",
+        "Include implementation hints",
+        "Add technicalDetails for complex logic",
+        "Specify files to modify if known"
+      ]
+    },
+    {
+      step: 7,
+      name: "add_dependencies",
+      description: "Link ticket to its dependencies",
+      tools: ["dependency.add"],
+      tips: [
+        "Only add true blocking dependencies",
+        "Avoid circular dependency chains",
+        "Keep dependency graph shallow when possible"
+      ]
+    },
+    {
+      step: 8,
+      name: "repeat",
+      description: "Continue tickets for current epic, then next epic",
+      tools: [],
+      tips: [
+        "Complete all tickets for an epic before moving on",
+        "Review epic completion before starting next",
+        "Adjust estimates as you learn more"
+      ]
+    }
+  ],
+  antiPatterns: [
+    "NEVER use bulk creation - always one at a time",
+    "NEVER skip asking user when details are unclear",
+    "NEVER create tickets without acceptance criteria",
+    "NEVER proceed without understanding dependencies"
+  ]
+};
+const IMPLEMENTATION_WORKFLOW = {
+  name: "implementation",
+  description: "Implement tickets with session management",
+  philosophy: [
+    "Always get full context before starting",
+    "Start session before making changes",
+    "Report progress during implementation",
+    "Validate before completing"
+  ],
+  steps: [
+    {
+      step: 1,
+      name: "get_context",
+      description: "Understand current working context",
+      tools: ["context.working"],
+      tips: [
+        "Check for active sessions",
+        "Note the current specification/epic focus",
+        "Understand what has already been done"
+      ]
+    },
+    {
+      step: 2,
+      name: "check_session",
+      description: "Check if spec has an open session",
+      tools: ["context.working"],
+      tips: [
+        "If session exists, continue with that session ID",
+        "If no session, will start new one after selecting ticket",
+        "Only ONE session per spec at a time"
+      ]
+    },
+    {
+      step: 3,
+      name: "find_work",
+      description: "Find tickets ready to work on",
+      tools: ["workflow.next_actionable"],
+      tips: [
+        "Focus on unblocked tickets",
+        "Consider priority and complexity",
+        "Check if any tickets are already in progress"
+      ]
+    },
+    {
+      step: 4,
+      name: "review_ticket",
+      description: "Get full implementation context",
+      tools: ["context.implementation"],
+      tips: [
+        "Use depth=full for rich context",
+        "Read all related patterns",
+        "Understand acceptance criteria"
+      ]
+    },
+    {
+      step: 5,
+      name: "clarify",
+      description: "Ask user about unclear requirements",
+      tools: [],
+      tips: [
+        "ASK THE USER before proceeding if unclear",
+        "Confirm test environment preference",
+        "Verify any assumptions"
+      ]
+    },
+    {
+      step: 6,
+      name: "start_session",
+      description: "Start or continue implementation session",
+      tools: ["session.start"],
+      tips: [
+        "Session locks the specification",
+        "Prevents concurrent work conflicts",
+        "Tracks your progress and changes"
+      ]
+    },
+    {
+      step: 7,
+      name: "implement",
+      description: "Do the work, report progress",
+      tools: ["session.progress"],
+      tips: [
+        "Follow the patterns from context",
+        "Report meaningful progress updates",
+        "Commit logically grouped changes"
+      ]
+    },
+    {
+      step: 8,
+      name: "validate",
+      description: "Run tests, lint, typecheck",
+      tools: [],
+      tips: [
+        "Run validation as specified in ticket",
+        "Fix any failing tests before completing",
+        "Ensure no regressions"
+      ]
+    },
+    {
+      step: 9,
+      name: "complete_ticket",
+      description: "Complete the ticket with summary",
+      tools: ["session.complete"],
+      tips: [
+        "Include summary of what was done",
+        "Report validation results",
+        "Note any follow-up items"
+      ]
+    },
+    {
+      step: 10,
+      name: "repeat_tickets",
+      description: "Continue with next ticket in epic",
+      tools: ["workflow.next_actionable"],
+      tips: [
+        "Check what tickets are now unblocked",
+        "Continue until epic is complete",
+        "Then proceed to epic completion"
+      ]
+    },
+    {
+      step: 11,
+      name: "epic_review",
+      description: "Review all changes made in epic",
+      tools: ["epic.get"],
+      tips: [
+        "Check all tickets are done",
+        "Review integration between tickets",
+        "Run full test suite for epic scope",
+        "Check for regressions"
+      ]
+    },
+    {
+      step: 12,
+      name: "epic_commit",
+      description: "Create commit for the epic",
+      tools: [],
+      tips: [
+        "Stage all changes from epic tickets",
+        "Write descriptive commit message referencing epic",
+        "Include ticket numbers in commit"
+      ]
+    },
+    {
+      step: 13,
+      name: "next_epic",
+      description: "Move to next epic",
+      tools: ["epic.list", "workflow.next_actionable"],
+      tips: [
+        "Find the next epic to work on",
+        "Repeat from step 3 (find_work)"
+      ]
+    }
+  ],
+  antiPatterns: [
+    "NEVER implement without reading full ticket context",
+    "NEVER skip session.start - it tracks your work",
+    "NEVER complete without running validation",
+    "NEVER assume - ask the user if unclear"
+  ]
+};
+const REVIEW_WORKFLOW = {
+  name: "review",
+  description: "Review tickets for completeness and consistency before implementation",
+  philosophy: [
+    "Catch issues before implementation, not during",
+    "Consistency across all layers (DB, API, types)",
+    "Always ask about test environment preference",
+    "Document findings in ticket notes"
+  ],
+  checklist: [
+    { name: "missing_points", description: "Acceptance criteria complete? Edge cases?" },
+    { name: "blind_spots", description: "Security implications? What could go wrong?" },
+    { name: "auth_patterns", description: "Token handling? Permission checks?" },
+    { name: "db_permissions", description: "Row-level security? Audit requirements?" },
+    { name: "field_naming", description: "DB (snake_case) <-> API (camelCase) <-> Types match?" },
+    { name: "documentation", description: "API docs? README? Architecture docs need update?" },
+    { name: "test_environment", description: "ASK USER: Sandbox or local mocks?" }
+  ],
+  steps: [
+    {
+      step: 1,
+      name: "select_ticket",
+      description: "Choose ticket to review",
+      tools: ["ticket.get", "workflow.next_actionable"],
+      tips: [
+        "Review tickets before they are implemented",
+        "Can review all pending tickets in an epic"
+      ]
+    },
+    {
+      step: 2,
+      name: "load_context",
+      description: "Get full implementation context with patterns",
+      tools: ["context.implementation"],
+      tips: [
+        "Use depth=full for comprehensive review",
+        "Understand the broader context"
+      ]
+    },
+    {
+      step: 3,
+      name: "run_checklist",
+      description: "Go through each review point systematically",
+      tools: [],
+      tips: [
+        "Check each item in the review checklist",
+        "Be thorough - issues found now save time later"
+      ]
+    },
+    {
+      step: 4,
+      name: "identify_gaps",
+      description: "List missing items, inconsistencies, concerns",
+      tools: [],
+      tips: [
+        "Document all findings",
+        "Prioritize by impact",
+        "Note any blocking issues"
+      ]
+    },
+    {
+      step: 5,
+      name: "ask_user",
+      description: "Clarify test environment preference",
+      tools: [],
+      tips: [
+        "ALWAYS ask about test environment",
+        "Sandbox (real services) vs local mocks",
+        "Document the decision"
+      ]
+    },
+    {
+      step: 6,
+      name: "update_ticket",
+      description: "Add findings to ticket notes or update acceptance criteria",
+      tools: ["ticket.update"],
+      tips: [
+        "Add findings to notes field",
+        "Update acceptance criteria if needed",
+        "Mark items that need user input"
+      ]
+    },
+    {
+      step: 7,
+      name: "repeat",
+      description: "Review next ticket",
+      tools: [],
+      tips: [
+        "Continue until all relevant tickets reviewed",
+        "Consider reviewing related tickets together"
+      ]
+    }
+  ],
+  antiPatterns: [
+    "NEVER skip the review checklist",
+    "NEVER assume test environment - always ask user",
+    "NEVER ignore field naming mismatches",
+    "NEVER proceed if auth patterns are unclear"
+  ]
+};
+const FINALIZE_WORKFLOW = {
+  name: "finalize",
+  description: "Verify implementation, mark spec done, and create PR",
+  philosophy: [
+    "All epics must be complete before finalizing",
+    "Run full validation suite before PR",
+    "PR description should tell the full story",
+    "End session cleanly after PR creation"
+  ],
+  prerequisites: [
+    "All epics in specification are done",
+    "All tickets are completed",
+    "All epic commits have been made"
+  ],
+  steps: [
+    {
+      step: 1,
+      name: "verify_completion",
+      description: "Check all epics and tickets are done",
+      tools: ["specification.get", "epic.list"],
+      tips: [
+        "Verify all epics are marked done",
+        "Check all tickets are completed",
+        "Look for any pending dependencies"
+      ]
+    },
+    {
+      step: 2,
+      name: "full_validation",
+      description: "Run complete test suite",
+      tools: [],
+      tips: [
+        "Run: npm test (or equivalent)",
+        "Run: npm run lint",
+        "Run: npm run build",
+        "All must pass before proceeding"
+      ]
+    },
+    {
+      step: 3,
+      name: "integration_review",
+      description: "Review cross-epic integration",
+      tools: [],
+      tips: [
+        "Check APIs work together",
+        "Verify data flows correctly",
+        "Look for regressions from epic interactions"
+      ]
+    },
+    {
+      step: 4,
+      name: "documentation_check",
+      description: "Verify all docs are updated",
+      tools: [],
+      tips: [
+        "API documentation updated",
+        "README changes if needed",
+        "Architecture docs if changed"
+      ]
+    },
+    {
+      step: 5,
+      name: "final_commit",
+      description: "Commit any cleanup changes",
+      tools: [],
+      tips: [
+        "Stage final changes",
+        "Commit with spec reference",
+        "Only if cleanup needed"
+      ]
+    },
+    {
+      step: 6,
+      name: "mark_spec_done",
+      description: "Update specification status",
+      tools: ["specification.update"],
+      tips: [
+        "Set status to done",
+        "This marks the specification complete"
+      ]
+    },
+    {
+      step: 7,
+      name: "create_pr",
+      description: "Create pull request with full context",
+      tools: ["link.pull_request"],
+      tips: [
+        "Title references specification",
+        "Description includes all epics and key tickets",
+        "Link to specification for context",
+        "Request reviewers if configured"
+      ]
+    }
+  ],
+  antiPatterns: [
+    "NEVER create PR with failing tests",
+    "NEVER skip documentation check",
+    "NEVER forget to link PR to specification"
+  ]
+};
+function getWorkflowDefinition(workflowType) {
+  switch (workflowType) {
+    case "creation":
+      return CREATION_WORKFLOW;
+    case "implementation":
+      return IMPLEMENTATION_WORKFLOW;
+    case "review":
+      return REVIEW_WORKFLOW;
+    case "finalize":
+      return FINALIZE_WORKFLOW;
+    default:
+      return null;
+  }
+}
+const WORKFLOW_TYPES = ["creation", "implementation", "review", "finalize"];
+export {
+  CREATION_WORKFLOW,
+  FINALIZE_WORKFLOW,
+  IMPLEMENTATION_WORKFLOW,
+  REVIEW_WORKFLOW,
+  WORKFLOW_TYPES,
+  getWorkflowDefinition
+};
+//# sourceMappingURL=workflow-definitions.js.map

package/dist/lib/workflow-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/workflow-definitions.ts"],"sourcesContent":["// mcp/src/lib/workflow-definitions.ts\n/**\n * Workflow Definitions\n *\n * Contains the workflow definitions as data structures for guiding AI agents\n * through SpecForge workflows.\n */\n\nexport interface WorkflowStep {\n  step: number;\n  name: string;\n  description: string;\n  tools: string[];\n  tips: string[];\n}\n\nexport interface WorkflowDefinition {\n  name: string;\n  description: string;\n  philosophy: string[];\n  steps: WorkflowStep[];\n  antiPatterns: string[];\n}\n\nexport interface ReviewChecklistItem {\n  name: string;\n  description: string;\n}\n\nexport interface ReviewWorkflowDefinition extends WorkflowDefinition {\n  checklist: ReviewChecklistItem[];\n}\n\nexport interface FinalizeWorkflowDefinition extends WorkflowDefinition {\n  prerequisites: string[];\n}\n\nexport const CREATION_WORKFLOW: WorkflowDefinition = {\n  name: 'creation',\n  description: 'Create specifications, epics, and tickets with rich context',\n  philosophy: [\n    'One entity at a time - never bulk create',\n    'More context = better AI implementation',\n    'When in doubt, ask the user',\n    'Invest in planning for first-run success',\n  ],\n  steps: [\n    {\n      step: 1,\n      name: 'understand_requirements',\n      description: 'Gather comprehensive requirements from user',\n      tools: [],\n      tips: [\n        'Ask about the problem being solved',\n        'Understand the target users',\n        'Clarify scope boundaries',\n        'Identify constraints and risks',\n      ],\n    },\n    {\n      step: 2,\n      name: 'create_specification',\n      description: 'Create specification with full context',\n      tools: ['specification.create'],\n      tips: [\n        'Include background and goals',\n        'Define guardrails (what NOT to do)',\n        'Set codeStandards for consistency',\n        'Add architecture overview',\n      ],\n    },\n    {\n      step: 3,\n      name: 'plan_epics',\n      description: 'Identify logical phases/groupings, discuss with user',\n      tools: [],\n      tips: [\n        'Break work into cohesive units',\n        'Consider dependencies between phases',\n        'Discuss timeline and priority with user',\n        'Keep epic count manageable (3-7 typical)',\n      ],\n    },\n    {\n      step: 4,\n      name: 'create_epic',\n      description: 'Create ONE epic with full context',\n      tools: ['epic.create'],\n      tips: [\n        'Define clear objective',\n        'Set scope boundaries',\n        'Include sharedPatterns for consistency',\n        'Add any epic-specific guardrails',\n      ],\n    },\n    {\n      step: 5,\n      name: 'plan_tickets',\n      description: 'Break epic into tickets, discuss dependencies with user',\n      tools: [],\n      tips: [\n        'Keep tickets small and focused',\n        'Identify clear acceptance criteria',\n        'Map out dependencies before creating',\n        'Discuss complexity with user',\n      ],\n    },\n    {\n      step: 6,\n      name: 'create_ticket',\n      description: 'Create ONE ticket with full details',\n      tools: ['ticket.create'],\n      tips: [\n        'Write detailed acceptanceCriteria',\n        'Include implementation hints',\n        'Add technicalDetails for complex logic',\n        'Specify files to modify if known',\n      ],\n    },\n    {\n      step: 7,\n      name: 'add_dependencies',\n      description: 'Link ticket to its dependencies',\n      tools: ['dependency.add'],\n      tips: [\n        'Only add true blocking dependencies',\n        'Avoid circular dependency chains',\n        'Keep dependency graph shallow when possible',\n      ],\n    },\n    {\n      step: 8,\n      name: 'repeat',\n      description: 'Continue tickets for current epic, then next epic',\n      tools: [],\n      tips: [\n        'Complete all tickets for an epic before moving on',\n        'Review epic completion before starting next',\n        'Adjust estimates as you learn more',\n      ],\n    },\n  ],\n  antiPatterns: [\n    'NEVER use bulk creation - always one at a time',\n    'NEVER skip asking user when details are unclear',\n    'NEVER create tickets without acceptance criteria',\n    'NEVER proceed without understanding dependencies',\n  ],\n};\n\nexport const IMPLEMENTATION_WORKFLOW: WorkflowDefinition = {\n  name: 'implementation',\n  description: 'Implement tickets with session management',\n  philosophy: [\n    'Always get full context before starting',\n    'Start session before making changes',\n    'Report progress during implementation',\n    'Validate before completing',\n  ],\n  steps: [\n    {\n      step: 1,\n      name: 'get_context',\n      description: 'Understand current working context',\n      tools: ['context.working'],\n      tips: [\n        'Check for active sessions',\n        'Note the current specification/epic focus',\n        'Understand what has already been done',\n      ],\n    },\n    {\n      step: 2,\n      name: 'check_session',\n      description: 'Check if spec has an open session',\n      tools: ['context.working'],\n      tips: [\n        'If session exists, continue with that session ID',\n        'If no session, will start new one after selecting ticket',\n        'Only ONE session per spec at a time',\n      ],\n    },\n    {\n      step: 3,\n      name: 'find_work',\n      description: 'Find tickets ready to work on',\n      tools: ['workflow.next_actionable'],\n      tips: [\n        'Focus on unblocked tickets',\n        'Consider priority and complexity',\n        'Check if any tickets are already in progress',\n      ],\n    },\n    {\n      step: 4,\n      name: 'review_ticket',\n      description: 'Get full implementation context',\n      tools: ['context.implementation'],\n      tips: [\n        'Use depth=full for rich context',\n        'Read all related patterns',\n        'Understand acceptance criteria',\n      ],\n    },\n    {\n      step: 5,\n      name: 'clarify',\n      description: 'Ask user about unclear requirements',\n      tools: [],\n      tips: [\n        'ASK THE USER before proceeding if unclear',\n        'Confirm test environment preference',\n        'Verify any assumptions',\n      ],\n    },\n    {\n      step: 6,\n      name: 'start_session',\n      description: 'Start or continue implementation session',\n      tools: ['session.start'],\n      tips: [\n        'Session locks the specification',\n        'Prevents concurrent work conflicts',\n        'Tracks your progress and changes',\n      ],\n    },\n    {\n      step: 7,\n      name: 'implement',\n      description: 'Do the work, report progress',\n      tools: ['session.progress'],\n      tips: [\n        'Follow the patterns from context',\n        'Report meaningful progress updates',\n        'Commit logically grouped changes',\n      ],\n    },\n    {\n      step: 8,\n      name: 'validate',\n      description: 'Run tests, lint, typecheck',\n      tools: [],\n      tips: [\n        'Run validation as specified in ticket',\n        'Fix any failing tests before completing',\n        'Ensure no regressions',\n      ],\n    },\n    {\n      step: 9,\n      name: 'complete_ticket',\n      description: 'Complete the ticket with summary',\n      tools: ['session.complete'],\n      tips: [\n        'Include summary of what was done',\n        'Report validation results',\n        'Note any follow-up items',\n      ],\n    },\n    {\n      step: 10,\n      name: 'repeat_tickets',\n      description: 'Continue with next ticket in epic',\n      tools: ['workflow.next_actionable'],\n      tips: [\n        'Check what tickets are now unblocked',\n        'Continue until epic is complete',\n        'Then proceed to epic completion',\n      ],\n    },\n    {\n      step: 11,\n      name: 'epic_review',\n      description: 'Review all changes made in epic',\n      tools: ['epic.get'],\n      tips: [\n        'Check all tickets are done',\n        'Review integration between tickets',\n        'Run full test suite for epic scope',\n        'Check for regressions',\n      ],\n    },\n    {\n      step: 12,\n      name: 'epic_commit',\n      description: 'Create commit for the epic',\n      tools: [],\n      tips: [\n        'Stage all changes from epic tickets',\n        'Write descriptive commit message referencing epic',\n        'Include ticket numbers in commit',\n      ],\n    },\n    {\n      step: 13,\n      name: 'next_epic',\n      description: 'Move to next epic',\n      tools: ['epic.list', 'workflow.next_actionable'],\n      tips: [\n        'Find the next epic to work on',\n        'Repeat from step 3 (find_work)',\n      ],\n    },\n  ],\n  antiPatterns: [\n    'NEVER implement without reading full ticket context',\n    'NEVER skip session.start - it tracks your work',\n    'NEVER complete without running validation',\n    'NEVER assume - ask the user if unclear',\n  ],\n};\n\nexport const REVIEW_WORKFLOW: ReviewWorkflowDefinition = {\n  name: 'review',\n  description: 'Review tickets for completeness and consistency before implementation',\n  philosophy: [\n    'Catch issues before implementation, not during',\n    'Consistency across all layers (DB, API, types)',\n    'Always ask about test environment preference',\n    'Document findings in ticket notes',\n  ],\n  checklist: [\n    { name: 'missing_points', description: 'Acceptance criteria complete? Edge cases?' },\n    { name: 'blind_spots', description: 'Security implications? What could go wrong?' },\n    { name: 'auth_patterns', description: 'Token handling? Permission checks?' },\n    { name: 'db_permissions', description: 'Row-level security? Audit requirements?' },\n    { name: 'field_naming', description: 'DB (snake_case) <-> API (camelCase) <-> Types match?' },\n    { name: 'documentation', description: 'API docs? README? Architecture docs need update?' },\n    { name: 'test_environment', description: 'ASK USER: Sandbox or local mocks?' },\n  ],\n  steps: [\n    {\n      step: 1,\n      name: 'select_ticket',\n      description: 'Choose ticket to review',\n      tools: ['ticket.get', 'workflow.next_actionable'],\n      tips: [\n        'Review tickets before they are implemented',\n        'Can review all pending tickets in an epic',\n      ],\n    },\n    {\n      step: 2,\n      name: 'load_context',\n      description: 'Get full implementation context with patterns',\n      tools: ['context.implementation'],\n      tips: [\n        'Use depth=full for comprehensive review',\n        'Understand the broader context',\n      ],\n    },\n    {\n      step: 3,\n      name: 'run_checklist',\n      description: 'Go through each review point systematically',\n      tools: [],\n      tips: [\n        'Check each item in the review checklist',\n        'Be thorough - issues found now save time later',\n      ],\n    },\n    {\n      step: 4,\n      name: 'identify_gaps',\n      description: 'List missing items, inconsistencies, concerns',\n      tools: [],\n      tips: [\n        'Document all findings',\n        'Prioritize by impact',\n        'Note any blocking issues',\n      ],\n    },\n    {\n      step: 5,\n      name: 'ask_user',\n      description: 'Clarify test environment preference',\n      tools: [],\n      tips: [\n        'ALWAYS ask about test environment',\n        'Sandbox (real services) vs local mocks',\n        'Document the decision',\n      ],\n    },\n    {\n      step: 6,\n      name: 'update_ticket',\n      description: 'Add findings to ticket notes or update acceptance criteria',\n      tools: ['ticket.update'],\n      tips: [\n        'Add findings to notes field',\n        'Update acceptance criteria if needed',\n        'Mark items that need user input',\n      ],\n    },\n    {\n      step: 7,\n      name: 'repeat',\n      description: 'Review next ticket',\n      tools: [],\n      tips: [\n        'Continue until all relevant tickets reviewed',\n        'Consider reviewing related tickets together',\n      ],\n    },\n  ],\n  antiPatterns: [\n    'NEVER skip the review checklist',\n    'NEVER assume test environment - always ask user',\n    'NEVER ignore field naming mismatches',\n    'NEVER proceed if auth patterns are unclear',\n  ],\n};\n\nexport const FINALIZE_WORKFLOW: FinalizeWorkflowDefinition = {\n  name: 'finalize',\n  description: 'Verify implementation, mark spec done, and create PR',\n  philosophy: [\n    'All epics must be complete before finalizing',\n    'Run full validation suite before PR',\n    'PR description should tell the full story',\n    'End session cleanly after PR creation',\n  ],\n  prerequisites: [\n    'All epics in specification are done',\n    'All tickets are completed',\n    'All epic commits have been made',\n  ],\n  steps: [\n    {\n      step: 1,\n      name: 'verify_completion',\n      description: 'Check all epics and tickets are done',\n      tools: ['specification.get', 'epic.list'],\n      tips: [\n        'Verify all epics are marked done',\n        'Check all tickets are completed',\n        'Look for any pending dependencies',\n      ],\n    },\n    {\n      step: 2,\n      name: 'full_validation',\n      description: 'Run complete test suite',\n      tools: [],\n      tips: [\n        'Run: npm test (or equivalent)',\n        'Run: npm run lint',\n        'Run: npm run build',\n        'All must pass before proceeding',\n      ],\n    },\n    {\n      step: 3,\n      name: 'integration_review',\n      description: 'Review cross-epic integration',\n      tools: [],\n      tips: [\n        'Check APIs work together',\n        'Verify data flows correctly',\n        'Look for regressions from epic interactions',\n      ],\n    },\n    {\n      step: 4,\n      name: 'documentation_check',\n      description: 'Verify all docs are updated',\n      tools: [],\n      tips: [\n        'API documentation updated',\n        'README changes if needed',\n        'Architecture docs if changed',\n      ],\n    },\n    {\n      step: 5,\n      name: 'final_commit',\n      description: 'Commit any cleanup changes',\n      tools: [],\n      tips: [\n        'Stage final changes',\n        'Commit with spec reference',\n        'Only if cleanup needed',\n      ],\n    },\n    {\n      step: 6,\n      name: 'mark_spec_done',\n      description: 'Update specification status',\n      tools: ['specification.update'],\n      tips: [\n        'Set status to done',\n        'This marks the specification complete',\n      ],\n    },\n    {\n      step: 7,\n      name: 'create_pr',\n      description: 'Create pull request with full context',\n      tools: ['link.pull_request'],\n      tips: [\n        'Title references specification',\n        'Description includes all epics and key tickets',\n        'Link to specification for context',\n        'Request reviewers if configured',\n      ],\n    },\n  ],\n  antiPatterns: [\n    'NEVER create PR with failing tests',\n    'NEVER skip documentation check',\n    'NEVER forget to link PR to specification',\n  ],\n};\n\n/**\n * Get a workflow definition by type\n */\nexport function getWorkflowDefinition(\n  workflowType: string\n): WorkflowDefinition | ReviewWorkflowDefinition | FinalizeWorkflowDefinition | null {\n  switch (workflowType) {\n    case 'creation':\n      return CREATION_WORKFLOW;\n    case 'implementation':\n      return IMPLEMENTATION_WORKFLOW;\n    case 'review':\n      return REVIEW_WORKFLOW;\n    case 'finalize':\n      return FINALIZE_WORKFLOW;\n    default:\n      return null;\n  }\n}\n\nexport const WORKFLOW_TYPES = ['creation', 'implementation', 'review', 'finalize'] as const;\nexport type WorkflowType = (typeof WORKFLOW_TYPES)[number];\n"],"mappings":"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","names":[]}

package/dist/patterns/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pattern Inheritance Module
+ *
+ * Exports pattern resolution functions for the SpecForge MCP.
+ *
+ * @see MCI-030-05-pattern-inheritance-resolver
+ */
+export { type ResolvedPatterns, type PatternOverride, type PatternOverrideReport, type PatternResolutionInput, resolvePatterns, resolvePatternsWithCache, getPatternOverrides, flattenCodeStandards, flattenSharedPatterns, invalidatePatternCache, invalidateAllPatternCaches, getPatternCacheSize, } from './inheritance.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAE3B,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EAEnB,oBAAoB,EACpB,qBAAqB,EAErB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/patterns/index.js

@@ -0,0 +1,21 @@
+import {
+  resolvePatterns,
+  resolvePatternsWithCache,
+  getPatternOverrides,
+  flattenCodeStandards,
+  flattenSharedPatterns,
+  invalidatePatternCache,
+  invalidateAllPatternCaches,
+  getPatternCacheSize
+} from "./inheritance.js";
+export {
+  flattenCodeStandards,
+  flattenSharedPatterns,
+  getPatternCacheSize,
+  getPatternOverrides,
+  invalidateAllPatternCaches,
+  invalidatePatternCache,
+  resolvePatterns,
+  resolvePatternsWithCache
+};
+//# sourceMappingURL=index.js.map

package/dist/patterns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/patterns/index.ts"],"sourcesContent":["/**\n * Pattern Inheritance Module\n *\n * Exports pattern resolution functions for the SpecForge MCP.\n *\n * @see MCI-030-05-pattern-inheritance-resolver\n */\n\nexport {\n  // Types\n  type ResolvedPatterns,\n  type PatternOverride,\n  type PatternOverrideReport,\n  type PatternResolutionInput,\n  // Main functions\n  resolvePatterns,\n  resolvePatternsWithCache,\n  getPatternOverrides,\n  // Helper functions\n  flattenCodeStandards,\n  flattenSharedPatterns,\n  // Cache management\n  invalidatePatternCache,\n  invalidateAllPatternCaches,\n  getPatternCacheSize,\n} from './inheritance.js';\n"],"mappings":"AAQA;AAAA,EAOE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}