musubi-sdd 5.1.0 → 5.6.1

package/bin/musubi-trace.js

@@ -723,7 +723,7 @@ program
   .option('--no-gaps', 'Exclude gaps analysis')
   .action(async options => {
     try {
-      const { CoverageReporter, ReportFormat } = require('../src/reporters/coverage-report.js');
+      const { CoverageReporter } = require('../src/reporters/coverage-report.js');
 
       console.log(chalk.bold('\n📊 Generating Coverage Report\n'));
 
@@ -762,7 +762,7 @@ program
   .option('-o, --output <path>', 'Output report path')
   .action(async options => {
     try {
-      const { TraceabilityValidator, Severity } = require('../src/validators/traceability-validator.js');
+      const { TraceabilityValidator } = require('../src/validators/traceability-validator.js');
 
       const validator = new TraceabilityValidator(process.cwd(), {
         thresholds: {
@@ -778,14 +778,18 @@ program
       const result = await validator.validate();
 
       if (options.format === 'json') {
-        const output = JSON.stringify({
-          passed: result.valid,
-          coverage: result.coverage,
-          gaps: result.gaps,
-          violations: result.violations,
-          warnings: result.warnings,
-          timestamp: new Date().toISOString(),
-        }, null, 2);
+        const output = JSON.stringify(
+          {
+            passed: result.valid,
+            coverage: result.coverage,
+            gaps: result.gaps,
+            violations: result.violations,
+            warnings: result.warnings,
+            timestamp: new Date().toISOString(),
+          },
+          null,
+          2
+        );
 
         if (options.output) {
           const fs = require('fs-extra');
@@ -917,14 +921,17 @@ program
           console.log(output);
         }
       } else if (options.format === 'html') {
-        const { TraceabilityMatrixReport, ReportFormat } = require('../src/reporters/traceability-matrix-report.js');
+        const {
+          TraceabilityMatrixReport,
+          ReportFormat,
+        } = require('../src/reporters/traceability-matrix-report.js');
         const reporter = new TraceabilityMatrixReport(process.cwd(), {
           theme: options.theme,
           interactive: true,
         });
-        
+
         const html = await reporter.generate(result, ReportFormat.HTML);
-        
+
         if (options.output) {
           const fs = require('fs-extra');
           await fs.writeFile(options.output, html, 'utf-8');
@@ -935,15 +942,26 @@ program
       } else {
         // Text format
         console.log(chalk.bold('📊 Forward Traceability (Requirements → Tests)'));
-        console.log(chalk.dim(`   Complete: ${result.completeness.forwardComplete}/${result.completeness.forwardTotal} (${result.completeness.forwardPercentage}%)`));
+        console.log(
+          chalk.dim(
+            `   Complete: ${result.completeness.forwardComplete}/${result.completeness.forwardTotal} (${result.completeness.forwardPercentage}%)`
+          )
+        );
         console.log();
 
         console.log(chalk.bold('🔙 Backward Traceability (Tests → Requirements)'));
-        console.log(chalk.dim(`   Complete: ${result.completeness.backwardComplete}/${result.completeness.backwardTotal} (${result.completeness.backwardPercentage}%)`));
+        console.log(
+          chalk.dim(
+            `   Complete: ${result.completeness.backwardComplete}/${result.completeness.backwardTotal} (${result.completeness.backwardPercentage}%)`
+          )
+        );
         console.log();
 
         // Show orphaned items
-        const totalOrphaned = Object.values(result.orphaned).reduce((sum, arr) => sum + arr.length, 0);
+        const totalOrphaned = Object.values(result.orphaned).reduce(
+          (sum, arr) => sum + arr.length,
+          0
+        );
         if (totalOrphaned > 0) {
           console.log(chalk.yellow.bold(`⚠️ Orphaned Items (${totalOrphaned}):`));
           ['requirements', 'design', 'tasks', 'code', 'tests'].forEach(cat => {
@@ -977,11 +995,14 @@ program
     try {
       console.log(chalk.bold('\n📊 Generating HTML Traceability Report\n'));
 
-      const { TraceabilityMatrixReport, ReportFormat } = require('../src/reporters/traceability-matrix-report.js');
+      const {
+        TraceabilityMatrixReport,
+        ReportFormat,
+      } = require('../src/reporters/traceability-matrix-report.js');
       const analyzer = new TraceabilityAnalyzer(process.cwd());
-      
+
       const traceabilityData = await analyzer.analyzeBidirectional();
-      
+
       const reporter = new TraceabilityMatrixReport(process.cwd(), {
         theme: options.theme,
         interactive: options.interactive !== false,
@@ -996,9 +1017,17 @@ program
       console.log(chalk.green(`✓ HTML report generated: ${options.output}`));
       console.log();
       console.log(chalk.dim('Summary:'));
-      console.log(chalk.dim(`  Forward coverage: ${traceabilityData.completeness.forwardPercentage}%`));
-      console.log(chalk.dim(`  Backward coverage: ${traceabilityData.completeness.backwardPercentage}%`));
-      console.log(chalk.dim(`  Orphaned items: ${Object.values(traceabilityData.orphaned).reduce((s, a) => s + a.length, 0)}`));
+      console.log(
+        chalk.dim(`  Forward coverage: ${traceabilityData.completeness.forwardPercentage}%`)
+      );
+      console.log(
+        chalk.dim(`  Backward coverage: ${traceabilityData.completeness.backwardPercentage}%`)
+      );
+      console.log(
+        chalk.dim(
+          `  Orphaned items: ${Object.values(traceabilityData.orphaned).reduce((s, a) => s + a.length, 0)}`
+        )
+      );
       console.log();
 
       process.exit(0);

package/bin/musubi-validate.js

@@ -23,7 +23,6 @@ const {
   createOutputGuardrail,
   createSafetyCheckGuardrail,
   GuardrailChain,
-  SafetyLevel
 } = require('../src/orchestration/guardrails');
 
 const program = new Command();
@@ -130,7 +129,7 @@ program
     try {
       // Get content from argument, file, or stdin
       let inputContent = content;
-      
+
       if (options.file) {
         const fs = require('fs');
         const path = require('path');
@@ -156,20 +155,20 @@ program
       switch (guardrailType) {
         case 'input':
           guardrail = createInputGuardrail('userInput', {
-            sanitize: true
+            sanitize: true,
           });
           break;
-        
+
         case 'output':
           guardrail = createOutputGuardrail(options.redact ? 'redact' : 'safe');
           break;
-        
+
         case 'safety':
           guardrail = createSafetyCheckGuardrail(options.level, {
-            enforceConstitution: options.constitutional
+            enforceConstitution: options.constitutional,
           });
           break;
-        
+
         default:
           console.error(chalk.red(`✗ Unknown guardrail type: ${guardrailType}`));
           process.exit(1);
@@ -200,7 +199,7 @@ program
     try {
       // Get content
       let inputContent = content;
-      
+
       if (options.file) {
         const fs = require('fs');
         const path = require('path');
@@ -223,7 +222,7 @@ program
       const chain = new GuardrailChain({
         name: 'ValidationChain',
         parallel: options.parallel || false,
-        stopOnFirstFailure: options.stopOnFailure || false
+        stopOnFirstFailure: options.stopOnFailure || false,
       });
 
       // Add default guardrails
@@ -252,7 +251,7 @@ program
   .action(async options => {
     try {
       const validator = new ConstitutionValidator(process.cwd());
-      
+
       console.log(chalk.dim('📊 Calculating constitutional compliance score...\n'));
 
       const [constitutionResults, gatesResults, complexityResults] = await Promise.all([
@@ -262,12 +261,15 @@ program
       ]);
 
       // Calculate weighted score
-      const constitutionScore = constitutionResults.passed ? 100 : 
-        Math.max(0, 100 - (constitutionResults.violations?.length || 0) * 10);
-      const gatesScore = gatesResults.passed ? 100 : 
-        Math.max(0, 100 - (gatesResults.violations?.length || 0) * 15);
-      const complexityScore = complexityResults.passed ? 100 : 
-        Math.max(0, 100 - (complexityResults.violations?.length || 0) * 5);
+      const constitutionScore = constitutionResults.passed
+        ? 100
+        : Math.max(0, 100 - (constitutionResults.violations?.length || 0) * 10);
+      const gatesScore = gatesResults.passed
+        ? 100
+        : Math.max(0, 100 - (gatesResults.violations?.length || 0) * 15);
+      const complexityScore = complexityResults.passed
+        ? 100
+        : Math.max(0, 100 - (complexityResults.violations?.length || 0) * 5);
 
       // Weighted average: Constitution 50%, Gates 30%, Complexity 20%
       const overallScore = Math.round(
@@ -284,32 +286,35 @@ program
         breakdown: {
           constitution: { score: constitutionScore, weight: '50%' },
           gates: { score: gatesScore, weight: '30%' },
-          complexity: { score: complexityScore, weight: '20%' }
+          complexity: { score: complexityScore, weight: '20%' },
         },
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
       };
 
       if (options.format === 'json') {
         console.log(JSON.stringify(result, null, 2));
       } else {
-        const scoreBar = '█'.repeat(Math.floor(overallScore / 10)) + 
-                        '░'.repeat(10 - Math.floor(overallScore / 10));
-        
+        const scoreBar =
+          '█'.repeat(Math.floor(overallScore / 10)) +
+          '░'.repeat(10 - Math.floor(overallScore / 10));
+
         console.log(chalk.bold('Constitutional Compliance Score\n'));
         console.log(chalk.bold('━'.repeat(50)));
         console.log(`\n${scoreBar} ${chalk.bold(overallScore)}%\n`);
-        
+
         console.log(chalk.dim('Breakdown:'));
         console.log(`  Constitution (50%): ${constitutionScore}%`);
         console.log(`  Gates (30%):        ${gatesScore}%`);
         console.log(`  Complexity (20%):   ${complexityScore}%`);
-        
+
         console.log('\n' + chalk.bold('━'.repeat(50)));
-        
+
         if (passed) {
           console.log(chalk.bold.green(`\n✓ PASSED (threshold: ${threshold}%)\n`));
         } else {
-          console.log(chalk.bold.red(`\n✗ FAILED (threshold: ${threshold}%, got: ${overallScore}%)\n`));
+          console.log(
+            chalk.bold.red(`\n✗ FAILED (threshold: ${threshold}%, got: ${overallScore}%)\n`)
+          );
         }
       }
 
@@ -508,10 +513,14 @@ function displayGuardrailResults(result, options) {
   if (result.violations && result.violations.length > 0) {
     console.log(chalk.bold.red('Violations:'));
     result.violations.forEach(violation => {
-      const severityIcon = violation.severity === 'error' ? '✗' : 
-                           violation.severity === 'warning' ? '⚠' : 'ℹ';
-      const severityColor = violation.severity === 'error' ? chalk.red :
-                            violation.severity === 'warning' ? chalk.yellow : chalk.blue;
+      const severityIcon =
+        violation.severity === 'error' ? '✗' : violation.severity === 'warning' ? '⚠' : 'ℹ';
+      const severityColor =
+        violation.severity === 'error'
+          ? chalk.red
+          : violation.severity === 'warning'
+            ? chalk.yellow
+            : chalk.blue;
       console.log(severityColor(`  ${severityIcon} [${violation.code}] ${violation.message}`));
     });
     console.log();
@@ -562,7 +571,7 @@ function displayChainResults(result, options) {
 
   // Show individual guardrail results
   console.log(chalk.bold('Individual Results:'));
-  result.results.forEach((r, index) => {
+  result.results.forEach((r, _index) => {
     const icon = r.passed ? chalk.green('✓') : chalk.red('✗');
     console.log(`  ${icon} ${r.guardrailName} (${r.executionTimeMs}ms)`);
   });

package/bin/musubi-workflow.js

@@ -2,9 +2,9 @@
 
 /**
  * MUSUBI Workflow CLI
- * 
+ *
  * Manage workflow state, transitions, and metrics.
- * 
+ *
  * Commands:
  *   init <feature>    - Initialize workflow for a feature
  *   status            - Show current workflow status
@@ -32,7 +32,7 @@ const STAGE_ICONS = {
   testing: '🧪',
   deployment: '🚀',
   monitoring: '📊',
-  retrospective: '🔄'
+  retrospective: '🔄',
 };
 
 /**
@@ -48,9 +48,11 @@ function formatStage(stage) {
  */
 async function showStatus() {
   const state = await engine.getState();
-  
+
   if (!state) {
-    console.log(chalk.yellow('\n⚠️  No active workflow. Use "musubi-workflow init <feature>" to start.'));
+    console.log(
+      chalk.yellow('\n⚠️  No active workflow. Use "musubi-workflow init <feature>" to start.')
+    );
     return;
   }
 
@@ -58,18 +60,18 @@ async function showStatus() {
   console.log(chalk.white(`Feature: ${chalk.cyan(state.feature)}`));
   console.log(chalk.white(`Current Stage: ${formatStage(state.currentStage)}`));
   console.log(chalk.white(`Started: ${new Date(state.startedAt).toLocaleString()}`));
-  
+
   // Show stage progress
   console.log(chalk.bold('\n📈 Stage Progress:\n'));
-  
+
   const allStages = Object.keys(WORKFLOW_STAGES);
   const currentIndex = allStages.indexOf(state.currentStage);
-  
+
   allStages.forEach((stage, index) => {
     const data = state.stages[stage];
     let status = '';
     let color = chalk.gray;
-    
+
     if (data?.status === 'completed') {
       status = `✅ Completed (${data.duration})`;
       color = chalk.green;
@@ -83,7 +85,7 @@ async function showStatus() {
       status = '⏳ Pending';
       color = chalk.gray;
     }
-    
+
     console.log(color(`  ${formatStage(stage).padEnd(25)} ${status}`));
   });
 
@@ -102,18 +104,18 @@ async function showStatus() {
  */
 async function showHistory() {
   const state = await engine.getState();
-  
+
   if (!state || !state.history) {
     console.log(chalk.yellow('\n⚠️  No workflow history available.'));
     return;
   }
 
   console.log(chalk.bold('\n📜 Workflow History\n'));
-  
+
   state.history.forEach(event => {
     const time = new Date(event.timestamp).toLocaleString();
     let desc = '';
-    
+
     switch (event.action) {
       case 'workflow-started':
         desc = `Started workflow for "${event.feature}" at ${formatStage(event.stage)}`;
@@ -132,7 +134,7 @@ async function showHistory() {
       default:
         desc = event.action;
     }
-    
+
     console.log(chalk.white(`  ${chalk.gray(time)} ${desc}`));
   });
 }
@@ -142,9 +144,9 @@ async function showHistory() {
  */
 async function showMetrics() {
   const summary = await engine.getMetricsSummary();
-  
+
   console.log(chalk.bold('\n📊 Workflow Metrics Summary\n'));
-  
+
   if (summary.message) {
     console.log(chalk.yellow(`  ${summary.message}`));
     return;
@@ -154,7 +156,7 @@ async function showMetrics() {
   console.log(chalk.white(`  Completed:           ${summary.completedWorkflows}`));
   console.log(chalk.white(`  Stage Transitions:   ${summary.stageTransitions}`));
   console.log(chalk.white(`  Feedback Loops:      ${summary.feedbackLoops}`));
-  
+
   if (summary.averageDuration) {
     console.log(chalk.white(`  Average Duration:    ${summary.averageDuration}`));
   }
@@ -190,10 +192,7 @@ program
     }
   });
 
-program
-  .command('status')
-  .description('Show current workflow status')
-  .action(showStatus);
+program.command('status').description('Show current workflow status').action(showStatus);
 
 program
   .command('next [stage]')
@@ -232,7 +231,9 @@ program
     try {
       await engine.recordFeedbackLoop(from, to, options.reason);
       await engine.transitionTo(to, `Feedback: ${options.reason}`);
-      console.log(chalk.yellow(`\n🔄 Feedback loop recorded: ${formatStage(from)} → ${formatStage(to)}`));
+      console.log(
+        chalk.yellow(`\n🔄 Feedback loop recorded: ${formatStage(from)} → ${formatStage(to)}`)
+      );
       console.log(chalk.gray(`   Reason: ${options.reason}`));
     } catch (error) {
       console.error(chalk.red(`\n❌ Error: ${error.message}`));
@@ -244,21 +245,25 @@ program
   .command('complete')
   .description('Complete the current workflow')
   .option('-n, --notes <notes>', 'Completion notes')
-  .action(async (options) => {
+  .action(async options => {
     try {
       const summary = await engine.completeWorkflow(options.notes);
-      
+
       console.log(chalk.green('\n✅ Workflow Completed!\n'));
       console.log(chalk.bold('📊 Summary:'));
       console.log(chalk.white(`  Feature:        ${summary.feature}`));
       console.log(chalk.white(`  Total Duration: ${summary.totalDuration}`));
       console.log(chalk.white(`  Stages:         ${summary.stages.length}`));
       console.log(chalk.white(`  Feedback Loops: ${summary.feedbackLoops}`));
-      
+
       if (summary.stages.length > 0) {
         console.log(chalk.bold('\n📈 Stage Breakdown:'));
         summary.stages.forEach(s => {
-          console.log(chalk.white(`  ${formatStage(s.name).padEnd(25)} ${s.duration} (${s.attempts} attempt${s.attempts > 1 ? 's' : ''})`));
+          console.log(
+            chalk.white(
+              `  ${formatStage(s.name).padEnd(25)} ${s.duration} (${s.attempts} attempt${s.attempts > 1 ? 's' : ''})`
+            )
+          );
         });
       }
     } catch (error) {
@@ -267,14 +272,8 @@ program
     }
   });
 
-program
-  .command('history')
-  .description('Show workflow history')
-  .action(showHistory);
+program.command('history').description('Show workflow history').action(showHistory);
 
-program
-  .command('metrics')
-  .description('Show workflow metrics summary')
-  .action(showMetrics);
+program.command('metrics').description('Show workflow metrics summary').action(showMetrics);
 
 program.parse();

package/bin/musubi.js

@@ -95,6 +95,32 @@ aliasFlags.forEach(flag => {
   initCommand.option(`--${flag}`, `Select agent: ${flag}`);
 });
 
+// Add spec option for external specification reference
+initCommand.option(
+  '--spec <source>',
+  'Reference external specification (URL, file path, or git repo)'
+);
+
+// Add reference option for GitHub repository references (can be specified multiple times)
+initCommand.option(
+  '--reference <repo>',
+  'Reference GitHub repository for improvements (can be specified multiple times)',
+  (value, previous) => (previous ? [...previous, value] : [value]),
+  []
+);
+
+// Shorthand aliases for reference
+initCommand.option(
+  '-r, --ref <repo>',
+  'Alias for --reference',
+  (value, previous) => (previous ? [...previous, value] : [value]),
+  []
+);
+
+// Add workspace/monorepo option
+initCommand.option('--workspace', 'Initialize as workspace/monorepo project');
+initCommand.option('--template <name>', 'Use project template (e.g., microservices, clean-arch)');
+
 initCommand.action(async options => {
   const agentKey = detectAgentFromFlags(options);
   const agent = getAgentDefinition(agentKey);
@@ -102,9 +128,20 @@ initCommand.action(async options => {
   console.log(chalk.blue(`Initializing MUSUBI for ${chalk.bold(agent.label)}...`));
   console.log(chalk.gray(`Description: ${agent.description}\n`));
 
-  // Delegate to musubi-init.js with agent info
+  // Merge --reference and --ref options
+  const references = [...(options.reference || []), ...(options.ref || [])];
+
+  // Extract init-specific options
+  const initOptions = {
+    spec: options.spec,
+    workspace: options.workspace,
+    template: options.template,
+    references: references.length > 0 ? references : undefined,
+  };
+
+  // Delegate to musubi-init.js with agent info and options
   const initMain = require('./musubi-init.js');
-  await initMain(agent, agentKey);
+  await initMain(agent, agentKey, initOptions);
 });
 
 // ============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musubi-sdd",
-  "version": "5.1.0",
+  "version": "5.6.1",
   "description": "Ultimate Specification Driven Development Tool with 27 Agents for 7 AI Coding Platforms + MCP Integration (Claude Code, GitHub Copilot, Cursor, Gemini CLI, Windsurf, Codex, Qwen Code)",
   "main": "src/index.js",
   "bin": {