musubix 3.3.4 → 3.3.6

package/.github/prompts/sdd-change-apply.prompt.md

@@ -0,0 +1,283 @@
+# MUSUBIX Change Apply Command
+
+Apply a change proposal to the codebase.
+
+---
+
+## Instructions for AI Agent
+
+You are executing the `musubix change apply [change-name]` command to implement an approved change proposal.
+
+### Command Format
+
+```bash
+npx musubix change apply add-2fa
+npx musubix change apply migrate-to-graphql
+```
+
+### Your Task
+
+Implement the changes defined in the change proposal, following constitutional governance.
+
+---
+
+## Process
+
+### 1. Read Change Proposal
+
+**IMPORTANT**: Read the approved change proposal first:
+
+```bash
+storage/changes/{{CHANGE_NAME}}-proposal.md
+```
+
+**Extract**:
+
+- ADDED requirements
+- MODIFIED requirements
+- REMOVED requirements
+- Implementation plan
+
+**Verify Approval**:
+
+- Status must be "Approved" (not "Proposed")
+- If not approved, abort and notify user
+
+---
+
+### 2. Read Steering Context (Article VI)
+
+```bash
+steering/product.ja.md
+steering/structure.ja.md
+steering/tech.ja.md
+```
+
+---
+
+### 3. Execute Implementation Plan
+
+Follow the phases defined in the change proposal:
+
+#### Phase 1: Preparation
+
+```bash
+# Create feature branch
+git checkout -b feature/{{CHANGE_NAME}}
+
+# Create implementation tracking document
+touch storage/changes/{{CHANGE_NAME}}-implementation.md
+```
+
+#### Phase 2: Update Requirements
+
+For ADDED requirements:
+- Create new requirement files in `storage/specs/`
+
+For MODIFIED requirements:
+- Update existing requirement files
+- Mark version change
+
+For REMOVED requirements:
+- Archive to `storage/archive/`
+- Update traceability
+
+#### Phase 3: Update Design
+
+- Update `storage/specs/DES-*.md` files
+- Add new ADRs for significant changes
+
+#### Phase 4: Implement Code
+
+Follow Test-First (Article III):
+
+1. **Write Tests (RED)**
+   ```typescript
+   // packages/core/__tests__/unit/{{feature}}.test.ts
+   describe('REQ-{{COMPONENT}}-NEW-001: [New Feature]', () => {
+     it('should [new behavior]', () => {
+       // Test new functionality
+     });
+   });
+   ```
+
+2. **Implement (GREEN)**
+   ```typescript
+   // packages/core/src/{{feature}}/service.ts
+   // Minimal implementation to pass tests
+   ```
+
+3. **Refactor (BLUE)**
+   - Improve design
+   - Ensure tests still pass
+
+---
+
+### 4. Feature Flag (Optional)
+
+For gradual rollout:
+
+```typescript
+// packages/core/src/config/feature-flags.ts
+
+export const FEATURE_FLAGS = {
+  enable_{{feature}}: {
+    enabled: false,  // Start disabled
+    description: '{{CHANGE_DESCRIPTION}}',
+  },
+} as const;
+```
+
+```typescript
+// Usage in code
+import { FEATURE_FLAGS } from '../config/feature-flags.js';
+
+if (FEATURE_FLAGS.enable_{{feature}}.enabled) {
+  // New implementation
+} else {
+  // Old implementation
+}
+```
+
+---
+
+### 5. Update CLI (Article II)
+
+If CLI changes:
+
+```typescript
+// packages/core/src/cli/commands/{{feature}}.ts
+
+export function register{{Feature}}Command(program: Command): void {
+  program
+    .command('{{feature}}')
+    .description('{{New/Updated description}}')
+    .option('--new-option', 'New option from change')
+    .action(async (options) => {
+      // Updated implementation
+    });
+}
+```
+
+---
+
+### 6. Update MCP Tools
+
+If MCP tools change:
+
+```typescript
+// packages/mcp-server/src/tools/{{feature}}-tools.ts
+
+export const {{feature}}Tool: ToolDefinition = {
+  name: 'sdd_{{feature}}',
+  description: '{{Updated description}}',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      // Updated schema
+      newProperty: {
+        type: 'string',
+        description: 'New property from change',
+      },
+    },
+  },
+  handler: async (args) => {
+    // Updated implementation
+  },
+};
+```
+
+---
+
+### 7. Generate Implementation Report
+
+**Output**: `storage/changes/{{CHANGE_NAME}}-implementation.md`
+
+```markdown
+# Implementation Report: {{CHANGE_NAME}}
+
+**Date**: {{DATE}}
+**Status**: In Progress / Completed
+
+## Summary
+
+| Item | Status |
+|------|--------|
+| Requirements Updated | ✅ |
+| Design Updated | ✅ |
+| Tests Written | ✅ |
+| Code Implemented | ✅ |
+| Documentation Updated | ⏳ |
+
+## Changes Made
+
+### Files Created
+
+- `packages/core/src/{{feature}}/new-module.ts`
+- `packages/core/__tests__/unit/new-module.test.ts`
+
+### Files Modified
+
+- `packages/core/src/{{feature}}/service.ts`
+- `packages/mcp-server/src/tools/{{feature}}-tools.ts`
+
+### Files Deleted
+
+- `packages/core/src/{{feature}}/deprecated.ts`
+
+## Test Results
+
+\`\`\`
+npm test
+
+✓ packages/core/__tests__/unit/{{feature}}.test.ts (10 tests)
+✓ packages/core/__tests__/integration/{{feature}}.integration.test.ts (5 tests)
+
+Test Suites: 2 passed
+Tests: 15 passed
+Coverage: 87%
+\`\`\`
+
+## Traceability Verification
+
+| Requirement | Design | Code | Test |
+|-------------|--------|------|------|
+| REQ-XXX-NEW-001 | DES-XXX-001 | ✅ | ✅ |
+| REQ-XXX-001 (mod) | DES-XXX-001 | ✅ | ✅ |
+
+## Deployment Notes
+
+1. Run migrations (if any)
+2. Enable feature flag
+3. Monitor metrics
+
+## Rollback Instructions
+
+1. Disable feature flag
+2. Revert to previous release
+```
+
+---
+
+### 8. Validation
+
+Run all validations:
+
+```bash
+# Tests
+npm test
+
+# Type check
+npm run typecheck
+
+# Lint
+npm run lint
+
+# Traceability
+npx musubix trace validate
+```
+
+---
+
+**MUSUBIX**: https://github.com/nahisaho/MUSUBIX
+**Version**: 1.0.0

package/.github/prompts/sdd-change-archive.prompt.md

@@ -0,0 +1,241 @@
+# MUSUBIX Change Archive Command
+
+Archive a completed change proposal.
+
+---
+
+## Instructions for AI Agent
+
+You are executing the `musubix change archive [change-name]` command to archive a completed change.
+
+### Command Format
+
+```bash
+npx musubix change archive add-2fa
+npx musubix change archive migrate-to-graphql
+```
+
+### Your Task
+
+Archive the change proposal and implementation, update documentation, and clean up.
+
+---
+
+## Process
+
+### 1. Verify Change Completion
+
+**Read Implementation Report**:
+
+```bash
+storage/changes/{{CHANGE_NAME}}-implementation.md
+```
+
+**Verify Status**:
+
+- [ ] Implementation report exists
+- [ ] All requirements implemented
+- [ ] Tests passing
+- [ ] Feature flag enabled (or deprecated feature removed)
+
+**If Not Complete**:
+
+```markdown
+⚠️ **Change not ready for archival**
+
+Status Check:
+- [ ] Implementation complete
+- [ ] Tests passing
+- [ ] Deployed
+- [ ] Stable period passed
+
+Please complete all steps before archiving.
+```
+
+---
+
+### 2. Collect Final Metrics
+
+```markdown
+## Final Metrics: {{CHANGE_NAME}}
+
+### Test Results
+
+- Unit Tests: XX passed
+- Integration Tests: XX passed
+- Coverage: XX%
+
+### Code Quality
+
+- Lint: ✅ No errors
+- TypeScript: ✅ No errors
+
+### Traceability
+
+- Requirements Coverage: 100%
+- Design Coverage: 100%
+- Test Coverage: XX%
+```
+
+---
+
+### 3. Archive Documents
+
+Move change documents to archive:
+
+```bash
+# Create archive directory
+mkdir -p storage/archive/changes/{{CHANGE_NAME}}
+
+# Move change documents
+mv storage/changes/{{CHANGE_NAME}}-proposal.md storage/archive/changes/{{CHANGE_NAME}}/
+mv storage/changes/{{CHANGE_NAME}}-implementation.md storage/archive/changes/{{CHANGE_NAME}}/
+```
+
+---
+
+### 4. Update Main Documentation
+
+**Update Traceability Matrix**:
+
+Add entries to `storage/traceability/`:
+
+```markdown
+## Change: {{CHANGE_NAME}}
+
+**Archived**: {{DATE}}
+
+| Requirement | Design | Task | Code | Test |
+|-------------|--------|------|------|------|
+| REQ-XXX-NEW-001 | DES-XXX-001 | TSK-XXX-001 | service.ts | service.test.ts |
+```
+
+**Update CHANGELOG.md**:
+
+```markdown
+## [1.x.x] - {{DATE}}
+
+### Added
+- {{Feature description}} (CHG-{{CHANGE}}-001)
+
+### Changed
+- {{Modified feature}} (CHG-{{CHANGE}}-001)
+
+### Removed
+- {{Deprecated feature}} (CHG-{{CHANGE}}-001)
+```
+
+---
+
+### 5. Remove Feature Flags (if applicable)
+
+If feature flag was used:
+
+```typescript
+// packages/core/src/config/feature-flags.ts
+
+// REMOVE:
+// enable_{{feature}}: {
+//   enabled: true,
+//   description: '{{CHANGE_DESCRIPTION}}',
+// },
+
+// Update code to remove flag checks
+```
+
+---
+
+### 6. Generate Archive Summary
+
+**Output**: `storage/archive/changes/{{CHANGE_NAME}}/SUMMARY.md`
+
+```markdown
+# Change Archive Summary: {{CHANGE_NAME}}
+
+**Document ID**: CHG-{{CHANGE}}-001
+**Archived**: {{DATE}}
+**Duration**: X weeks
+
+## Overview
+
+**Change Type**: Feature / Enhancement / Refactor
+**Packages Affected**: packages/core/, packages/mcp-server/
+
+## Final State
+
+### Requirements
+
+| ID | Title | Status |
+|----|-------|--------|
+| REQ-XXX-NEW-001 | [New Feature] | Implemented |
+| REQ-XXX-001 | [Modified Feature] | Updated |
+
+### Files Changed
+
+**Created**: X files
+**Modified**: X files
+**Deleted**: X files
+
+### Test Coverage
+
+- Before: XX%
+- After: XX%
+
+## Documents Archived
+
+1. {{CHANGE_NAME}}-proposal.md
+2. {{CHANGE_NAME}}-implementation.md
+3. SUMMARY.md (this file)
+
+## Lessons Learned
+
+1. [Lesson 1]
+2. [Lesson 2]
+
+## Related Changes
+
+- CHG-XXX-001: [Related change]
+```
+
+---
+
+### 7. Clean Up
+
+```bash
+# Remove any temporary files
+rm -rf storage/changes/{{CHANGE_NAME}}-*.tmp
+
+# Verify archive is complete
+ls storage/archive/changes/{{CHANGE_NAME}}/
+# Expected:
+# - {{CHANGE_NAME}}-proposal.md
+# - {{CHANGE_NAME}}-implementation.md
+# - SUMMARY.md
+
+# Git commit
+git add storage/archive/changes/{{CHANGE_NAME}}/
+git add storage/traceability/
+git add CHANGELOG.md
+git commit -m "chore: archive change CHG-{{CHANGE}}-001"
+```
+
+---
+
+### 8. Final Verification
+
+```bash
+# Ensure no orphaned references
+grep -r "CHG-{{CHANGE}}-001" packages/
+# Should only find documentation references
+
+# Ensure tests still pass
+npm test
+
+# Ensure build succeeds
+npm run build
+```
+
+---
+
+**MUSUBIX**: https://github.com/nahisaho/MUSUBIX
+**Version**: 1.0.0