musubi-sdd 6.2.1 → 6.3.0

package/src/enterprise/rollback-manager.js

@@ -1,10 +1,10 @@
 /**
  * Rollback Manager
- * 
+ *
  * Supports rollback to previous state with cleanup.
- * 
+ *
  * Requirement: IMP-6.2-008-02
- * 
+ *
  * @module enterprise/rollback-manager
  */
 
@@ -19,7 +19,7 @@ const ROLLBACK_LEVEL = {
   FILE: 'file',
   COMMIT: 'commit',
   STAGE: 'stage',
-  SPRINT: 'sprint'
+  SPRINT: 'sprint',
 };
 
 /**
@@ -30,7 +30,7 @@ const ROLLBACK_STATUS = {
   IN_PROGRESS: 'in-progress',
   COMPLETED: 'completed',
   FAILED: 'failed',
-  CANCELLED: 'cancelled'
+  CANCELLED: 'cancelled',
 };
 
 /**
@@ -41,7 +41,7 @@ const WORKFLOW_STAGE = {
   DESIGN: 'design',
   TASKS: 'tasks',
   IMPLEMENT: 'implement',
-  VALIDATE: 'validate'
+  VALIDATE: 'validate',
 };
 
 /**
@@ -59,7 +59,7 @@ class RollbackManager {
       maxHistory: config.maxHistory || 50,
       requireConfirmation: config.requireConfirmation !== false,
       gitEnabled: config.gitEnabled !== false,
-      ...config
+      ...config,
     };
 
     this.rollbackHistory = [];
@@ -82,7 +82,7 @@ class RollbackManager {
       description: options.description || '',
       files: [],
       gitRef: null,
-      metadata: options.metadata || {}
+      metadata: options.metadata || {},
     };
 
     // Capture current state
@@ -114,20 +114,20 @@ class RollbackManager {
       try {
         const content = await fs.readFile(filePath, 'utf-8');
         const stats = await fs.stat(filePath);
-        
+
         backups.push({
           path: filePath,
           content,
           mode: stats.mode,
           mtime: stats.mtime.toISOString(),
-          size: stats.size
+          size: stats.size,
         });
       } catch (error) {
         // File doesn't exist or can't be read
         backups.push({
           path: filePath,
           exists: false,
-          error: error.message
+          error: error.message,
         });
       }
     }
@@ -154,8 +154,9 @@ class RollbackManager {
    * @returns {Promise<Object>} Rollback result
    */
   async rollback(checkpointId, options = {}) {
-    const checkpoint = this.checkpoints.get(checkpointId) || await this.loadCheckpoint(checkpointId);
-    
+    const checkpoint =
+      this.checkpoints.get(checkpointId) || (await this.loadCheckpoint(checkpointId));
+
     if (!checkpoint) {
       throw new Error(`Checkpoint not found: ${checkpointId}`);
     }
@@ -169,7 +170,7 @@ class RollbackManager {
       level: checkpoint.level,
       beforeState: null,
       changes: [],
-      options
+      options,
     };
 
     // Require confirmation if enabled
@@ -178,7 +179,7 @@ class RollbackManager {
         ...rollback,
         status: ROLLBACK_STATUS.PENDING,
         requiresConfirmation: true,
-        checkpoint: this.summarizeCheckpoint(checkpoint)
+        checkpoint: this.summarizeCheckpoint(checkpoint),
       };
     }
 
@@ -187,9 +188,7 @@ class RollbackManager {
 
       // Capture current state before rollback
       if (checkpoint.files.length > 0) {
-        rollback.beforeState = await this.captureFiles(
-          checkpoint.files.map(f => f.path)
-        );
+        rollback.beforeState = await this.captureFiles(checkpoint.files.map(f => f.path));
       }
 
       // Perform rollback based on level
@@ -334,7 +333,7 @@ class RollbackManager {
    */
   cancelRollback(rollbackId) {
     const rollback = this.rollbackHistory.find(r => r.id === rollbackId);
-    
+
     if (!rollback) {
       throw new Error(`Rollback not found: ${rollbackId}`);
     }
@@ -402,7 +401,7 @@ class RollbackManager {
       stage: checkpoint.stage,
       description: checkpoint.description,
       fileCount: checkpoint.files.length,
-      hasGitRef: !!checkpoint.gitRef
+      hasGitRef: !!checkpoint.gitRef,
     };
   }
 
@@ -413,10 +412,10 @@ class RollbackManager {
    */
   async saveCheckpoint(checkpoint) {
     await this.ensureStorageDir();
-    
+
     const fileName = `checkpoint-${checkpoint.id}.json`;
     const filePath = path.join(this.config.storageDir, fileName);
-    
+
     await fs.writeFile(filePath, JSON.stringify(checkpoint, null, 2), 'utf-8');
     return filePath;
   }
@@ -429,7 +428,7 @@ class RollbackManager {
   async loadCheckpoint(id) {
     const fileName = `checkpoint-${id}.json`;
     const filePath = path.join(this.config.storageDir, fileName);
-    
+
     try {
       const content = await fs.readFile(filePath, 'utf-8');
       const checkpoint = JSON.parse(content);
@@ -447,10 +446,10 @@ class RollbackManager {
    */
   async saveRollback(rollback) {
     await this.ensureStorageDir();
-    
+
     const fileName = `rollback-${rollback.id}.json`;
     const filePath = path.join(this.config.storageDir, fileName);
-    
+
     await fs.writeFile(filePath, JSON.stringify(rollback, null, 2), 'utf-8');
     return filePath;
   }
@@ -479,7 +478,7 @@ class RollbackManager {
    */
   generateReport(rollbackId) {
     const rollback = this.rollbackHistory.find(r => r.id === rollbackId);
-    
+
     if (!rollback) {
       throw new Error(`Rollback not found: ${rollbackId}`);
     }
@@ -526,10 +525,10 @@ class RollbackManager {
    */
   async deleteCheckpoint(checkpointId) {
     this.checkpoints.delete(checkpointId);
-    
+
     const fileName = `checkpoint-${checkpointId}.json`;
     const filePath = path.join(this.config.storageDir, fileName);
-    
+
     try {
       await fs.unlink(filePath);
       return true;
@@ -580,5 +579,5 @@ module.exports = {
   createRollbackManager,
   ROLLBACK_LEVEL,
   ROLLBACK_STATUS,
-  WORKFLOW_STAGE
+  WORKFLOW_STAGE,
 };

package/src/enterprise/tech-article.js

@@ -1,10 +1,10 @@
 /**
  * Tech Article Generator
- * 
+ *
  * Generates publication-ready technical articles for various platforms.
- * 
+ *
  * Requirement: IMP-6.2-006-02
- * 
+ *
  * @module enterprise/tech-article
  */
 
@@ -19,7 +19,7 @@ const PLATFORM = {
   ZENN: 'zenn',
   MEDIUM: 'medium',
   DEVTO: 'devto',
-  GENERIC: 'generic'
+  GENERIC: 'generic',
 };
 
 /**
@@ -31,7 +31,7 @@ const ARTICLE_TYPE = {
   ANNOUNCEMENT: 'announcement',
   COMPARISON: 'comparison',
   HOW_TO: 'how-to',
-  CASE_STUDY: 'case-study'
+  CASE_STUDY: 'case-study',
 };
 
 /**
@@ -49,7 +49,7 @@ class TechArticleGenerator {
       defaultLanguage: config.defaultLanguage || 'ja',
       includeTableOfContents: config.includeTableOfContents !== false,
       includeFrontMatter: config.includeFrontMatter !== false,
-      ...config
+      ...config,
     };
 
     this.templates = this.loadTemplates();
@@ -62,37 +62,38 @@ class TechArticleGenerator {
   loadTemplates() {
     return {
       [PLATFORM.QIITA]: {
-        frontMatter: (meta) => `---
+        frontMatter: meta => `---
 title: "${meta.title}"
 tags: [${meta.tags.map(t => `"${t}"`).join(', ')}]
 private: false
 ---`,
         codeBlock: (lang, code) => `\`\`\`${lang}\n${code}\n\`\`\``,
         note: (text, type = 'info') => `:::note ${type}\n${text}\n:::`,
-        link: (text, url) => `[${text}](${url})`
+        link: (text, url) => `[${text}](${url})`,
       },
       [PLATFORM.ZENN]: {
-        frontMatter: (meta) => `---
+        frontMatter: meta => `---
 title: "${meta.title}"
 emoji: "${meta.emoji || '📝'}"
 type: "${meta.articleType || 'tech'}"
 topics: [${meta.tags.map(t => `"${t}"`).join(', ')}]
 published: true
 ---`,
-        codeBlock: (lang, code, filename) => filename 
-          ? `\`\`\`${lang}:${filename}\n${code}\n\`\`\``
-          : `\`\`\`${lang}\n${code}\n\`\`\``,
+        codeBlock: (lang, code, filename) =>
+          filename
+            ? `\`\`\`${lang}:${filename}\n${code}\n\`\`\``
+            : `\`\`\`${lang}\n${code}\n\`\`\``,
         note: (text, type = 'info') => `:::message ${type === 'warn' ? 'alert' : ''}\n${text}\n:::`,
-        link: (text, url) => `[${text}](${url})`
+        link: (text, url) => `[${text}](${url})`,
       },
       [PLATFORM.MEDIUM]: {
         frontMatter: () => '', // Medium doesn't use front matter
         codeBlock: (lang, code) => `\`\`\`${lang}\n${code}\n\`\`\``,
-        note: (text) => `> **Note:** ${text}`,
-        link: (text, url) => `[${text}](${url})`
+        note: text => `> **Note:** ${text}`,
+        link: (text, url) => `[${text}](${url})`,
       },
       [PLATFORM.DEVTO]: {
-        frontMatter: (meta) => `---
+        frontMatter: meta => `---
 title: "${meta.title}"
 published: true
 description: "${meta.description || ''}"
@@ -100,20 +101,21 @@ tags: ${meta.tags.slice(0, 4).join(', ')}
 cover_image: ${meta.coverImage || ''}
 ---`,
         codeBlock: (lang, code) => `\`\`\`${lang}\n${code}\n\`\`\``,
-        note: (text, type = 'info') => `{% ${type === 'warn' ? 'warning' : type} %}\n${text}\n{% end${type === 'warn' ? 'warning' : type} %}`,
-        link: (text, url) => `[${text}](${url})`
+        note: (text, type = 'info') =>
+          `{% ${type === 'warn' ? 'warning' : type} %}\n${text}\n{% end${type === 'warn' ? 'warning' : type} %}`,
+        link: (text, url) => `[${text}](${url})`,
       },
       [PLATFORM.GENERIC]: {
-        frontMatter: (meta) => `---
+        frontMatter: meta => `---
 title: "${meta.title}"
 date: "${meta.date || new Date().toISOString()}"
 author: "${meta.author || 'MUSUBI SDD'}"
 tags: [${meta.tags.map(t => `"${t}"`).join(', ')}]
 ---`,
         codeBlock: (lang, code) => `\`\`\`${lang}\n${code}\n\`\`\``,
-        note: (text) => `> **Note:** ${text}`,
-        link: (text, url) => `[${text}](${url})`
-      }
+        note: text => `> **Note:** ${text}`,
+        link: (text, url) => `[${text}](${url})`,
+      },
     };
   }
 
@@ -135,7 +137,7 @@ tags: [${meta.tags.map(t => `"${t}"`).join(', ')}]
       date: new Date().toISOString(),
       emoji: content.emoji || '📝',
       articleType: content.articleType || ARTICLE_TYPE.TUTORIAL,
-      coverImage: content.coverImage || ''
+      coverImage: content.coverImage || '',
     };
 
     const sections = [];
@@ -186,7 +188,9 @@ tags: [${meta.tags.map(t => `"${t}"`).join(', ')}]
               sections.push(example.description);
               sections.push('');
             }
-            sections.push(template.codeBlock(example.language || 'javascript', example.code, example.filename));
+            sections.push(
+              template.codeBlock(example.language || 'javascript', example.code, example.filename)
+            );
             sections.push('');
           }
         }
@@ -259,7 +263,7 @@ tags: [${meta.tags.map(t => `"${t}"`).join(', ')}]
       filePath,
       platform,
       wordCount: this.countWords(article),
-      readingTime: this.estimateReadingTime(article)
+      readingTime: this.estimateReadingTime(article),
     };
   }
 
@@ -278,7 +282,7 @@ tags: [${meta.tags.map(t => `"${t}"`).join(', ')}]
       sections: this.generateExperimentSections(experimentReport),
       benchmarks: this.extractBenchmarks(experimentReport),
       conclusion: options.conclusion || this.generateExperimentConclusion(experimentReport),
-      references: options.references || []
+      references: options.references || [],
     };
 
     return this.generate(content, options);
@@ -291,9 +295,11 @@ tags: [${meta.tags.map(t => `"${t}"`).join(', ')}]
    */
   generateExperimentIntroduction(report) {
     const summary = report.summary || {};
-    return `本記事では、${report.metadata?.title || 'テスト'}の実験結果を報告します。` +
-           `合計${summary.total || 0}件のテストを実行し、` +
-           `${summary.passRate || '0%'}のパス率を達成しました。`;
+    return (
+      `本記事では、${report.metadata?.title || 'テスト'}の実験結果を報告します。` +
+      `合計${summary.total || 0}件のテストを実行し、` +
+      `${summary.passRate || '0%'}のパス率を達成しました。`
+    );
   }
 
   /**
@@ -315,14 +321,14 @@ tags: [${meta.tags.map(t => `"${t}"`).join(', ')}]
 | 失敗 | ${report.summary?.failed || 0} |
 | スキップ | ${report.summary?.skipped || 0} |
 | パス率 | ${report.summary?.passRate || '0%'} |
-      `.trim()
+      `.trim(),
     });
 
     // Metrics section (if available)
     if (report.metrics && Object.keys(report.metrics).length > 0) {
       sections.push({
         title: 'メトリクス',
-        content: this.formatMetricsSection(report.metrics)
+        content: this.formatMetricsSection(report.metrics),
       });
     }
 
@@ -330,7 +336,7 @@ tags: [${meta.tags.map(t => `"${t}"`).join(', ')}]
     if (report.observations && report.observations.length > 0) {
       sections.push({
         title: '観察結果',
-        content: report.observations.map(o => `- ${o}`).join('\n')
+        content: report.observations.map(o => `- ${o}`).join('\n'),
       });
     }
 
@@ -376,11 +382,11 @@ tags: [${meta.tags.map(t => `"${t}"`).join(', ')}]
    */
   extractBenchmarks(report) {
     const benchmarks = {};
-    
+
     if (report.metrics?.performance) {
       Object.assign(benchmarks, report.metrics.performance);
     }
-    
+
     if (report.summary?.duration) {
       benchmarks['Total Duration'] = `${report.summary.duration}ms`;
     }
@@ -505,5 +511,5 @@ module.exports = {
   TechArticleGenerator,
   createTechArticleGenerator,
   PLATFORM,
-  ARTICLE_TYPE
+  ARTICLE_TYPE,
 };

package/src/generators/design.js

@@ -36,7 +36,7 @@ class DesignGenerator {
    * @returns {Promise<object>} Result with path
    */
   async init(feature, options = {}) {
-    const outputDir = path.join(this.rootDir, options.output || 'docs/design');
+    const outputDir = path.join(this.rootDir, options.output || 'storage/design');
     await fs.ensureDir(outputDir);
 
     const fileName = `${this.slugify(feature)}.md`;
@@ -90,7 +90,7 @@ class DesignGenerator {
    * @returns {Promise<string[]>} List of design file paths
    */
   async findDesignFiles() {
-    const patterns = ['docs/design/**/*.md', 'docs/design/*.md', 'design/**/*.md', 'design/*.md'];
+    const patterns = ['storage/design/**/*.md', 'storage/design/*.md', 'design/**/*.md', 'design/*.md'];
 
     const files = [];
     for (const pattern of patterns) {
@@ -605,7 +605,7 @@ Service --> Repository
     const matrix = [];
 
     // Find requirement files
-    const reqFiles = await glob('docs/requirements/**/*.md', {
+    const reqFiles = await glob('storage/specs/**/*.md', {
       cwd: this.rootDir,
       absolute: true,
     });

package/src/generators/requirements.js

@@ -32,7 +32,7 @@ class RequirementsGenerator {
    * @returns {Promise<object>} Result with path
    */
   async init(feature, options = {}) {
-    const outputDir = path.join(this.rootDir, options.output || 'docs/requirements');
+    const outputDir = path.join(this.rootDir, options.output || 'storage/specs');
     await fs.ensureDir(outputDir);
 
     const fileName = `${this.slugify(feature)}.md`;
@@ -87,8 +87,10 @@ class RequirementsGenerator {
    */
   async findRequirementsFiles() {
     const patterns = [
-      'docs/requirements/**/*.md',
-      'docs/requirements/*.md',
+      'storage/specs/**/*-requirements.md',
+      'storage/specs/*-requirements.md',
+      'storage/specs/**/*.md',
+      'storage/specs/*.md',
       'requirements/**/*.md',
       'requirements/*.md',
     ];

package/src/generators/tasks.js

@@ -19,7 +19,7 @@ class TasksGenerator {
    * Initialize task breakdown document
    */
   async init(feature, options = {}) {
-    const outputDir = path.join(this.workspaceRoot, options.output || 'docs/tasks');
+    const outputDir = path.join(this.workspaceRoot, options.output || 'storage/tasks');
     await fs.ensureDir(outputDir);
 
     const fileName = this.slugify(feature) + '.md';
@@ -45,7 +45,7 @@ class TasksGenerator {
    * Find all task breakdown files
    */
   async findTaskFiles() {
-    const patterns = ['docs/tasks/**/*.md', 'tasks/**/*.md'];
+    const patterns = ['storage/tasks/**/*.md', 'tasks/**/*.md'];
 
     const files = [];
     for (const pattern of patterns) {

package/src/integrations/platforms.js

@@ -616,7 +616,7 @@ This project uses **MUSUBI** (Ultimate Specification Driven Development).
 
 ### Learn More
 
-- [MUSUBI Documentation](https://github.com/nahisaho/musubi)
+- [MUSUBI Documentation](https://github.com/nahisaho/MUSUBI)
 
 ---
 

package/src/templates/agents/claude-code/CLAUDE.md

@@ -289,7 +289,7 @@ npx musubi-sdd <command>
 
 ## Learn More
 
-- [MUSUBI Documentation](https://github.com/your-org/musubi)
+- [MUSUBI Documentation](https://github.com/nahisaho/MUSUBI)
 - [Constitutional Governance](steering/rules/constitution.md)
 - [8-Stage SDD Workflow](steering/rules/workflow.md)
 - [EARS Format Guide](steering/rules/ears-format.md)