musubix 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nahisaho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,201 @@
+# MUSUBIX - ニューロシンボリックAI統合システム
+
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
+[![Build](https://img.shields.io/badge/build-passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
+[![Tests](https://img.shields.io/badge/tests-16%20passed-brightgreen)](https://github.com/nahisaho/MUSUBIX)
+
+> MUSUBI × YATA 統合による次世代AIコーディングシステム
+
+## 概要
+
+MUSUBIXは、**ニューラル（LLM）** と **シンボリック（知識グラフ）** 推論を統合した革新的なAIコーディングシステムです。MUSUBI SDDの方法論とYATAの知識グラフ推論を組み合わせ、高品質なソフトウェア開発を支援します。
+
+### 特徴
+
+- 🧠 **ニューロシンボリック統合** - LLMの創造性とYATA知識グラフの厳密性を融合
+- 📋 **EARS形式要件分析** - 自然言語から正式な要件への変換・検証
+- 🎨 **設計パターン推奨** - コンテキストに基づくC4モデル・ADR生成
+- ✅ **テスト駆動開発** - Test-First原則による品質保証
+- 🔗 **完全なトレーサビリティ** - 要件からコードまでの追跡可能性
+- 💬 **一問一答形式ヒアリング** - 対話的な要件定義サポート
+- 🌐 **多言語対応（i18n）** - 日本語・英語対応
+- 🔒 **セキュリティスキャン** - 脆弱性検出・認証管理
+
+## アーキテクチャ
+
+```mermaid
+flowchart TB
+    subgraph MUSUBIX["MUSUBIX System"]
+        subgraph Packages["Packages"]
+            Core["@nahisaho/musubix-core"]
+            MCP["@nahisaho/musubix-mcp-server"]
+            YATA["@nahisaho/musubix-yata-client"]
+        end
+        
+        Core <--> MCP
+        MCP <--> YATA
+        
+        subgraph Integration["Neuro-Symbolic Integration"]
+            NSI["LLM Creativity + Knowledge Graph Precision"]
+        end
+        
+        Core --> Integration
+        MCP --> Integration
+        YATA --> Integration
+    end
+```
+
+## プロジェクト構造
+
+| パス | 説明 |
+|------|------|
+| `packages/core/` | コアライブラリ（56モジュール） |
+| `packages/core/auth/` | 認証・認可 |
+| `packages/core/cli/` | CLIインターフェース |
+| `packages/core/codegen/` | コード生成・解析 |
+| `packages/core/design/` | 設計パターン・C4モデル |
+| `packages/core/error/` | エラーハンドリング |
+| `packages/core/explanation/` | 説明生成・可視化 |
+| `packages/core/requirements/` | 要件分析・分解 |
+| `packages/core/traceability/` | トレーサビリティ |
+| `packages/core/types/` | 型定義 |
+| `packages/core/utils/` | ユーティリティ |
+| `packages/core/validators/` | EARS検証 |
+| `packages/mcp-server/` | MCPサーバー（34 tools, 3 prompts） |
+| `packages/yata-client/` | YATA クライアント |
+| `steering/` | プロジェクトメモリ |
+| `storage/` | 仕様書・成果物 |
+| `templates/` | テンプレート |
+| `docs/` | ドキュメント |
+
+## 要件
+
+- Node.js >= 20.0.0
+- npm >= 10.0.0
+- TypeScript >= 5.3
+
+## インストール
+
+### npm/npx（推奨）
+
+```bash
+# グローバルインストール
+npm install -g musubix
+
+# npx で直接実行
+npx musubix init
+npx musubix --help
+
+# MCPサーバー起動
+npx @nahisaho/musubix-mcp-server
+npx musubix-mcp --transport stdio
+```
+
+### スコープ付きパッケージ
+
+```bash
+# 個別パッケージのインストール
+npm install @nahisaho/musubix-core
+npm install @nahisaho/musubix-mcp-server
+npm install @nahisaho/musubix-yata-client
+```
+
+### ソースからビルド
+
+```bash
+git clone https://github.com/nahisaho/MUSUBIX.git
+cd MUSUBIX
+npm install
+npm run build
+```
+
+## 開発
+
+\`\`\`bash
+# ビルド
+npm run build
+
+# テスト実行
+npm test
+
+# リント
+npm run lint
+
+# 型チェック
+npm run type-check
+\`\`\`
+
+## 主要機能
+
+### 要件定義（Article II準拠）
+
+- **EARS検証**: Easy Approach to Requirements Syntax パターン検証
+- **一問一答ヒアリング**: 対話形式での要件収集
+- **要件分解**: 大きな要件を実装単位に分解
+- **関連要件検索**: 類似・依存要件の自動検出
+
+### 設計生成（Article III準拠）
+
+- **C4モデル生成**: Context/Container/Component/Code図
+- **ADR生成**: Architecture Decision Records
+- **パターン検出**: デザインパターンの自動検出・推奨
+- **SOLID検証**: SOLID原則準拠チェック
+
+### コード生成・検証
+
+- **静的解析**: 品質メトリクス・複雑度計算
+- **セキュリティスキャン**: 脆弱性検出
+- **テスト生成**: ユニット・統合テスト生成
+- **カバレッジレポート**: テストカバレッジ計測
+
+### MCPサーバー
+
+34個のツールと3つのプロンプトを提供:
+
+\`\`\`bash
+# MCPサーバー起動
+npx @nahisaho/musubix-mcp-server
+\`\`\`
+
+## ドキュメント
+
+| 文書 | 説明 |
+|------|------|
+| [要件定義書](storage/specs/REQ-MUSUBIX-001.md) | EARS形式の機能・非機能要件 |
+| [設計書](storage/specs/DES-MUSUBIX-001.md) | C4モデル・ADRベースの設計 |
+| [タスク定義書](storage/specs/TSK-MUSUBIX-001.md) | 56タスクのスプリント計画 |
+| [APIリファレンス](docs/API-REFERENCE.md) | 公開API仕様 |
+
+## 憲法（9条）
+
+MUSUBIXは以下の9条の憲法に準拠しています：
+
+1. **Specification First** - 要件が先、実装は後
+2. **Design Before Code** - 設計が先、コードは後  
+3. **Single Source of Truth** - プロジェクトメモリが正
+4. **Traceability** - 要件〜コードの追跡可能性
+5. **Incremental Progress** - 小さく頻繁にデリバリー
+6. **Decision Documentation** - 決定はADRで記録
+7. **Quality Gates** - フェーズ検証必須
+8. **User-Centric** - ユーザー価値を文書化
+9. **Continuous Learning** - 振り返りと改善
+
+## ライセンス
+
+MIT License - 詳細は [LICENSE](LICENSE) を参照
+
+## 作者
+
+nahisaho
+
+## 変更履歴
+
+[CHANGELOG.md](CHANGELOG.md) を参照
+
+---
+
+**文書ID**: README  
+**バージョン**: 1.0.0  
+**最終更新**: 2026-01-02

package/README.md

@@ -0,0 +1,203 @@
+# MUSUBIX - Neuro-Symbolic AI Integration System
+
+[![CI](https://github.com/nahisaho/MUSUBIX/actions/workflows/ci.yml/badge.svg)](https://github.com/nahisaho/MUSUBIX/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@nahisaho/musubix-core.svg)](https://www.npmjs.com/package/@nahisaho/musubix-core)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
+
+> Next-generation AI Coding System powered by MUSUBI × YATA Integration
+
+**[日本語版 README](README.ja.md)**
+
+## Overview
+
+MUSUBIX is an innovative AI coding system that integrates **Neural (LLM)** and **Symbolic (Knowledge Graph)** reasoning. It combines MUSUBI SDD methodology with YATA knowledge graph reasoning to support high-quality software development.
+
+### Features
+
+- 🧠 **Neuro-Symbolic Integration** - Fusion of LLM creativity and YATA knowledge graph precision
+- 📋 **EARS Requirements Analysis** - Conversion and validation from natural language to formal requirements
+- 🎨 **Design Pattern Recommendations** - Context-based C4 model and ADR generation
+- ✅ **Test-Driven Development** - Quality assurance through Test-First principles
+- 🔗 **Complete Traceability** - Tracking from requirements to code
+- 💬 **Interactive Q&A Hearing** - Dialogue-based requirements gathering support
+- 🌐 **Internationalization (i18n)** - Japanese and English support
+- 🔒 **Security Scanning** - Vulnerability detection and authentication management
+
+## Architecture
+
+```mermaid
+flowchart TB
+    subgraph MUSUBIX["MUSUBIX System"]
+        subgraph Packages["Packages"]
+            Core["@nahisaho/musubix-core"]
+            MCP["@nahisaho/musubix-mcp-server"]
+            YATA["@nahisaho/musubix-yata-client"]
+        end
+        
+        Core <--> MCP
+        MCP <--> YATA
+        
+        subgraph Integration["Neuro-Symbolic Integration"]
+            NSI["LLM Creativity + Knowledge Graph Precision"]
+        end
+        
+        Core --> Integration
+        MCP --> Integration
+        YATA --> Integration
+    end
+```
+
+## Project Structure
+
+| Path | Description |
+|------|-------------|
+| `packages/core/` | Core library (56 modules) |
+| `packages/core/auth/` | Authentication & Authorization |
+| `packages/core/cli/` | CLI Interface |
+| `packages/core/codegen/` | Code Generation & Analysis |
+| `packages/core/design/` | Design Patterns & C4 Models |
+| `packages/core/error/` | Error Handling |
+| `packages/core/explanation/` | Explanation Generation & Visualization |
+| `packages/core/requirements/` | Requirements Analysis & Decomposition |
+| `packages/core/traceability/` | Traceability |
+| `packages/core/types/` | Type Definitions |
+| `packages/core/utils/` | Utilities |
+| `packages/core/validators/` | EARS Validation |
+| `packages/mcp-server/` | MCP Server (34 tools, 3 prompts) |
+| `packages/yata-client/` | YATA Client |
+| `steering/` | Project Memory |
+| `storage/` | Specifications & Artifacts |
+| `templates/` | Templates |
+| `docs/` | Documentation |
+
+## Requirements
+
+- Node.js >= 20.0.0
+- npm >= 10.0.0
+- TypeScript >= 5.3
+
+## Installation
+
+### npm/npx (Recommended)
+
+```bash
+# Global installation
+npm install -g musubix
+
+# Run directly with npx
+npx musubix init
+npx musubix --help
+
+# Start MCP Server
+npx @nahisaho/musubix-mcp-server
+npx musubix-mcp --transport stdio
+```
+
+### Scoped Packages
+
+```bash
+# Install individual packages
+npm install @nahisaho/musubix-core
+npm install @nahisaho/musubix-mcp-server
+npm install @nahisaho/musubix-yata-client
+```
+
+### Build from Source
+
+```bash
+git clone https://github.com/nahisaho/MUSUBIX.git
+cd MUSUBIX
+npm install
+npm run build
+```
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Lint
+npm run lint
+
+# Type check
+npm run type-check
+```
+
+## Key Features
+
+### Requirements Definition (Article II Compliant)
+
+- **EARS Validation**: Easy Approach to Requirements Syntax pattern validation
+- **Interactive Q&A Hearing**: Dialogue-based requirements gathering
+- **Requirements Decomposition**: Breaking down large requirements into implementation units
+- **Related Requirements Search**: Automatic detection of similar and dependent requirements
+
+### Design Generation (Article III Compliant)
+
+- **C4 Model Generation**: Context/Container/Component/Code diagrams
+- **ADR Generation**: Architecture Decision Records
+- **Pattern Detection**: Automatic detection and recommendation of design patterns
+- **SOLID Validation**: SOLID principle compliance checking
+
+### Code Generation & Verification
+
+- **Static Analysis**: Quality metrics and complexity calculation
+- **Security Scanning**: Vulnerability detection
+- **Test Generation**: Unit and integration test generation
+- **Coverage Reporting**: Test coverage measurement
+
+### MCP Server
+
+Provides 34 tools and 3 prompts:
+
+```bash
+# Start MCP Server
+npx @nahisaho/musubix-mcp-server
+```
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Requirements Specification](storage/specs/REQ-MUSUBIX-001.md) | EARS format functional/non-functional requirements |
+| [Design Document](storage/specs/DES-MUSUBIX-001.md) | C4 model and ADR-based design |
+| [Task Definition](storage/specs/TSK-MUSUBIX-001.md) | 56 tasks sprint plan |
+| [API Reference](docs/API-REFERENCE.md) | Public API specification |
+
+## Constitutional Articles (9 Articles)
+
+MUSUBIX adheres to the following 9 constitutional articles:
+
+1. **Specification First** - Requirements before implementation
+2. **Design Before Code** - Design before coding
+3. **Single Source of Truth** - Project memory is authoritative
+4. **Traceability** - Tracking from requirements to code
+5. **Incremental Progress** - Small, frequent deliveries
+6. **Decision Documentation** - Decisions recorded as ADRs
+7. **Quality Gates** - Phase validation required
+8. **User-Centric** - Document user value
+9. **Continuous Learning** - Retrospectives and improvements
+
+## License
+
+MIT License - See [LICENSE](LICENSE) for details
+
+## Author
+
+nahisaho
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md)
+
+---
+
+**Document ID**: README  
+**Version**: 1.0.0  
+**Last Updated**: 2026-01-02

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "musubix",
+  "version": "1.0.0",
+  "description": "Neuro-Symbolic AI Coding System - MUSUBI × YATA Integration",
+  "type": "module",
+  "workspaces": [
+    "packages/*"
+  ],
+  "bin": {
+    "musubix": "./packages/core/bin/musubix.js",
+    "musubix-mcp": "./packages/mcp-server/bin/musubix-mcp.js"
+  },
+  "files": [
+    "packages/*/dist",
+    "packages/*/bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build --workspaces --if-present",
+    "test": "vitest run",
+    "test:unit": "vitest run --dir packages/*/src/__tests__",
+    "test:integration": "vitest run --dir packages/*/__tests__",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint packages/*/src --ext .ts",
+    "lint:fix": "eslint packages/*/src --ext .ts --fix",
+    "clean": "npm run clean --workspaces --if-present",
+    "typecheck": "npm run typecheck --workspaces --if-present",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nahisaho/MUSUBIX.git"
+  },
+  "keywords": [
+    "ai",
+    "neuro-symbolic",
+    "coding-assistant",
+    "mcp",
+    "musubi",
+    "yata"
+  ],
+  "author": "nahisaho",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.13.0",
+    "@typescript-eslint/parser": "^6.13.0",
+    "eslint": "^8.55.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.16"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.25.1",
+    "@nahisaho/musubix-core": "^1.0.0",
+    "@nahisaho/musubix-mcp-server": "^1.0.0",
+    "@nahisaho/musubix-yata-client": "^1.0.0"
+  }
+}

package/packages/core/bin/musubix.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * MUSUBIX CLI Entry Point
+ * 
+ * @see REQ-ARC-002 - CLI Interface
+ * 
+ * Usage:
+ *   npx @musubix/core
+ *   npx musubix
+ *   musubix <command> [options]
+ */
+
+import { createProgram } from '../dist/cli/base.js';
+import { registerCommands } from '../dist/cli/commands/index.js';
+
+const program = createProgram();
+registerCommands(program);
+program.parse();

package/packages/mcp-server/bin/musubix-mcp.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+/**
+ * MUSUBIX MCP Server Entry Point
+ * 
+ * Starts the MCP server for AI platform integration.
+ * 
+ * @see REQ-INT-102 - MCP Server
+ * 
+ * Usage:
+ *   npx @musubix/mcp-server
+ *   musubix-mcp --transport stdio
+ *   musubix-mcp --transport sse --port 8080
+ */
+
+import { startServer, VERSION } from '../dist/index.js';
+import { parseArgs } from 'node:util';
+
+const options = {
+  transport: {
+    type: 'string',
+    short: 't',
+    default: 'stdio'
+  },
+  port: {
+    type: 'string',
+    short: 'p',
+    default: '3000'
+  },
+  help: {
+    type: 'boolean',
+    short: 'h',
+    default: false
+  },
+  version: {
+    type: 'boolean',
+    short: 'v',
+    default: false
+  }
+};
+
+const { values } = parseArgs({ options, allowPositionals: true });
+
+if (values.help) {
+  console.log(`
+MUSUBIX MCP Server - Model Context Protocol Server for AI Platforms
+
+Usage:
+  musubix-mcp [options]
+
+Options:
+  -t, --transport <type>  Transport type: stdio | sse (default: stdio)
+  -p, --port <port>       Port for SSE transport (default: 3000)
+  -h, --help              Show this help message
+  -v, --version           Show version
+
+Examples:
+  musubix-mcp                          # Start with stdio transport
+  musubix-mcp -t sse -p 8080           # Start SSE server on port 8080
+  npx @musubix/mcp-server              # Run via npx
+`);
+  process.exit(0);
+}
+
+if (values.version) {
+  console.log(`@musubix/mcp-server v${VERSION}`);
+  process.exit(0);
+}
+
+// Start the MCP server
+startServer({
+  transport: values.transport,
+  port: parseInt(values.port, 10)
+});