musubix 1.1.6 → 1.1.8

package/AGENTS.md

@@ -276,7 +276,92 @@ npx musubix codegen generate <design.md> --output src/
 
 ---
 
-## 📚 ドキュメント
+## � 学習済みベストプラクティス（v1.1.7 NEW!）
+
+Project-07 Medical Clinic、Project-08 Property Rentalの実装から学習したパターンです。
+
+### コードパターン
+
+| ID | 名称 | 概要 | 信頼度 |
+|----|------|------|--------|
+| BP-CODE-001 | Entity Input DTO | エンティティ作成にInput DTOオブジェクトを使用 | 95% |
+| BP-CODE-002 | Date-based ID Format | PREFIX-YYYYMMDD-NNN形式でIDを生成 | 90% |
+| BP-CODE-003 | Value Objects | ドメイン概念にValue Objectを使用 | 90% |
+
+**Entity Input DTO例**:
+```typescript
+// ✅ 推奨: Input DTOを使用
+interface CreatePatientInput {
+  name: PersonName;
+  dateOfBirth: Date;
+  contact: ContactInfo;
+}
+function createPatient(input: CreatePatientInput): Patient { ... }
+
+// ❌ 非推奨: 複数パラメータ
+function createPatient(name: PersonName, dob: Date, contact: ContactInfo): Patient
+```
+
+### 設計パターン
+
+| ID | 名称 | 概要 | 信頼度 |
+|----|------|------|--------|
+| BP-DESIGN-001 | Status Transition Map | 有効なステータス遷移をMapで定義 | 95% |
+| BP-DESIGN-002 | Repository Async Pattern | 将来のDB移行に備えてasync化 | 85% |
+| BP-DESIGN-003 | Service Layer with DI | リポジトリをDIしたService層 | 90% |
+
+**Status Transition Map例**:
+```typescript
+const validStatusTransitions: Record<Status, Status[]> = {
+  draft: ['active'],
+  active: ['renewed', 'terminated', 'expired'],
+  renewed: [],
+  terminated: [],
+  expired: ['renewed'],
+};
+```
+
+### テストパターン
+
+| ID | 名称 | 概要 | 信頼度 |
+|----|------|------|--------|
+| BP-TEST-001 | Test Counter Reset | beforeEachでIDカウンターをリセット | 95% |
+| BP-TEST-002 | Verify API Before Test | テスト前にAPIシグネチャを確認 | 80% |
+| BP-TEST-003 | Vitest ESM Configuration | Vitest + TypeScript ESM構成 | 85% |
+
+**Test Counter Reset例**:
+```typescript
+// Entity側でresetXxxCounter()を提供
+export function resetPatientCounter(): void { patientCounter = 0; }
+
+// テスト側でbeforeEachでリセット
+beforeEach(() => {
+  resetPatientCounter();
+  resetAppointmentCounter();
+});
+```
+
+### CLIでベストプラクティスを表示
+
+```bash
+# 全ベストプラクティス表示
+npx musubix learn best-practices
+
+# カテゴリ別フィルタ
+npx musubix learn best-practices --category code
+npx musubix learn best-practices --category design
+npx musubix learn best-practices --category test
+
+# 高信頼度パターンのみ
+npx musubix learn best-practices --high-confidence
+
+# Markdown出力
+npx musubix learn best-practices --format markdown
+```
+
+---
+
+## �📚 ドキュメント
 
 | ドキュメント | 説明 |
 |-------------|------|
@@ -314,6 +399,6 @@ npx musubix codegen generate <design.md> --output src/
 ---
 
 **Agent**: GitHub Copilot / Claude
-**Last Updated**: 2026-01-04
-**Version**: 1.1.4
+**Last Updated**: 2026-01-05
+**Version**: 1.1.7
 **Repository**: https://github.com/nahisaho/MUSUBIX

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musubix",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "Neuro-Symbolic AI Coding System - MUSUBI × YATA Integration",
   "type": "module",
   "workspaces": [
@@ -19,9 +19,11 @@
     "docs/",
     "steering/",
     "templates/",
-    ".github/"
+    ".github/",
+    "scripts/"
   ],
   "scripts": {
+    "postinstall": "node scripts/postinstall.js",
     "build": "npm run build --workspaces --if-present",
     "test": "vitest run",
     "test:unit": "vitest run --dir packages/*/src/__tests__",

package/scripts/postinstall.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+/**
+ * MUSUBIX Postinstall Script
+ * 
+ * Copies .github/ and AGENTS.md to the project root after npm install.
+ * This enables GitHub Copilot and other AI agents to use MUSUBIX prompts and skills.
+ */
+
+import { existsSync, cpSync, copyFileSync, mkdirSync } from 'fs';
+import { dirname, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Source: where musubix is installed (node_modules/musubix)
+const packageRoot = resolve(__dirname, '..');
+
+// Target: project root (where npm install was run)
+// When installed as dependency: process.env.INIT_CWD points to project root
+// When running in musubix repo itself: skip
+const projectRoot = process.env.INIT_CWD || process.cwd();
+
+// Skip if we're in the musubix package itself
+if (projectRoot === packageRoot || projectRoot.includes('node_modules/musubix')) {
+  console.log('musubix: Skipping postinstall (running in package directory)');
+  process.exit(0);
+}
+
+const sourceGithub = join(packageRoot, '.github');
+const sourceAgents = join(packageRoot, 'AGENTS.md');
+const targetGithub = join(projectRoot, '.github');
+const targetAgents = join(projectRoot, 'AGENTS.md');
+
+let copied = false;
+
+// Copy .github directory
+if (existsSync(sourceGithub)) {
+  // Only copy musubix-specific files, don't overwrite existing .github
+  const musubixPrompts = join(sourceGithub, 'prompts');
+  const musubixSkills = join(sourceGithub, 'skills');
+  const musubixAgents = join(sourceGithub, 'AGENTS.md');
+
+  // Create .github if not exists
+  if (!existsSync(targetGithub)) {
+    mkdirSync(targetGithub, { recursive: true });
+  }
+
+  // Copy prompts
+  if (existsSync(musubixPrompts)) {
+    const targetPrompts = join(targetGithub, 'prompts');
+    if (!existsSync(targetPrompts)) {
+      mkdirSync(targetPrompts, { recursive: true });
+    }
+    cpSync(musubixPrompts, targetPrompts, { recursive: true, force: false });
+    console.log('musubix: Copied .github/prompts/');
+    copied = true;
+  }
+
+  // Copy skills
+  if (existsSync(musubixSkills)) {
+    const targetSkills = join(targetGithub, 'skills');
+    if (!existsSync(targetSkills)) {
+      mkdirSync(targetSkills, { recursive: true });
+    }
+    cpSync(musubixSkills, targetSkills, { recursive: true, force: false });
+    console.log('musubix: Copied .github/skills/');
+    copied = true;
+  }
+
+  // Copy .github/AGENTS.md
+  if (existsSync(musubixAgents)) {
+    const targetGithubAgents = join(targetGithub, 'AGENTS.md');
+    if (!existsSync(targetGithubAgents)) {
+      copyFileSync(musubixAgents, targetGithubAgents);
+      console.log('musubix: Copied .github/AGENTS.md');
+      copied = true;
+    }
+  }
+}
+
+// Copy AGENTS.md to project root
+if (existsSync(sourceAgents) && !existsSync(targetAgents)) {
+  copyFileSync(sourceAgents, targetAgents);
+  console.log('musubix: Copied AGENTS.md');
+  copied = true;
+}
+
+if (copied) {
+  console.log('musubix: AI agent configuration files installed successfully!');
+  console.log('musubix: GitHub Copilot can now use MUSUBIX SDD prompts and skills.');
+} else {
+  console.log('musubix: Configuration files already exist, skipping.');
+}