@shirokuma-library/shirokuma-docs 0.1.0-alpha.10

package/README.md

@@ -0,0 +1,346 @@
+# shirokuma-docs
+
+Next.js + TypeScript プロジェクト向けのドキュメント自動生成 CLI。Claude Code スキル同梱。
+
+[English](README.en.md)
+
+## インストール
+
+### 推奨: インストーラスクリプト（sudo 不要）
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash
+```
+
+言語を事前に指定する場合:
+
+```bash
+# 日本語
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash -s -- --lang ja
+
+# 英語
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash -s -- --lang en
+```
+
+`~/.local/` にインストールされます。Claude Code ユーザーは `~/.local/bin` が PATH に含まれているため追加設定不要です。
+
+### npm / pnpm でグローバルインストール
+
+```bash
+# npm
+npm install -g @shirokuma-library/shirokuma-docs
+
+# pnpm
+pnpm add -g @shirokuma-library/shirokuma-docs
+```
+
+### インストール確認
+
+```bash
+shirokuma-docs --version
+# => 0.1.0-alpha.1
+```
+
+## はじめかた
+
+### 1. 初期化
+
+```bash
+cd /path/to/your/project
+shirokuma-docs init --with-skills --with-rules --lang ja
+```
+
+`shirokuma-docs.config.yaml` の作成、プラグインのインストール、`.claude/rules/shirokuma/` へのルールデプロイを一括で実行します。
+
+### 2. 設定ファイルのカスタマイズ
+
+`shirokuma-docs.config.yaml` を開き、自分のプロジェクト構成に合わせてパスを編集します:
+
+```yaml
+project:
+  name: "MyProject"           # プロジェクト名
+  description: "..."
+
+typedoc:
+  entryPoints:
+    - "./src/lib/actions"      # ソースコードのパスに変更
+    - "./src/db/schema"
+  tsconfig: "./tsconfig.json"
+
+schema:
+  sources:
+    - path: "./src/db/schema"  # Drizzle ORM スキーマのパス
+```
+
+**Drizzle ORM を使わない場合**は `schema` セクションをまるごと削除してください。
+`deps`、`testCases`、`lintDocs` 等のオプションセクションも不要なら削除できます。`generate` 実行時は設定されたセクションのみ動作します。
+
+### 3. GitHub Project セットアップ
+
+```bash
+# Project 作成 + フィールド設定を一括実行
+shirokuma-docs projects create-project --title "プロジェクト名" --lang ja
+```
+
+以下は GitHub API の制限により手動設定が必要です:
+
+| 項目 | 設定場所 |
+|------|---------|
+| Discussion カテゴリ（Handovers, ADR, Knowledge, Research） | リポジトリ Settings → Discussions |
+| Project ワークフロー（Item closed → Done, PR merged → Done） | Project Settings → Workflows |
+
+<details>
+<summary>AI に委任する場合（コピペ用）</summary>
+
+まず手動で初期化を実行し、スキルとルールを有効にします:
+
+```bash
+cd /path/to/your/project
+shirokuma-docs init --with-skills --with-rules --lang ja
+```
+
+新しい Claude Code セッションを開始し、以下を貼り付けてください:
+
+```
+このプロジェクトの初期セットアップを行ってください。
+
+1. shirokuma-docs projects create-project --title "{プロジェクト名}" --lang ja を実行
+2. shirokuma-docs.config.yaml をプロジェクト構成に合わせて編集
+3. 以下の手動設定が必要な項目を案内:
+   - GitHub Discussion カテゴリの作成（Handovers, ADR, Knowledge, Research）
+   - GitHub Project ワークフローの有効化（Item closed → Done, PR merged → Done）
+```
+
+</details>
+
+### 4. ドキュメント生成
+
+```bash
+# 全コマンド一括実行
+shirokuma-docs generate
+
+# 個別実行
+shirokuma-docs test-cases -p .
+shirokuma-docs deps -p .
+shirokuma-docs portal -p .
+```
+
+### 5. Claude Code との連携
+
+新しい Claude Code セッションを開始するとスキルが利用可能になります（例: `/working-on-issue #42`）。
+
+詳細は[はじめかたガイド](docs/guide/getting-started.md)を参照してください。
+
+## アップグレード
+
+```bash
+# ステップ 1: CLI を更新
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash
+# または: npm update -g @shirokuma-library/shirokuma-docs
+
+# ステップ 2: プラグイン・ルール・キャッシュを更新
+cd /path/to/your/project
+shirokuma-docs update
+
+# ステップ 3: 新しい Claude Code セッションを開始
+```
+
+### トラブルシューティング
+
+`shirokuma-docs update` 後にスキルが更新されない場合:
+
+```bash
+# キャッシュを強制リフレッシュ
+claude plugin uninstall shirokuma-skills-ja@shirokuma-library --scope project
+claude plugin install shirokuma-skills-ja@shirokuma-library --scope project
+```
+
+## アンインストール
+
+```bash
+# インストーラスクリプト経由の場合
+rm -f ~/.local/bin/shirokuma-docs
+rm -rf ~/.local/share/shirokuma-docs
+
+# npm 経由の場合
+npm uninstall -g @shirokuma-library/shirokuma-docs
+```
+
+プロジェクトごとのファイルを削除する場合:
+
+```bash
+# ルールと設定ファイルを削除
+rm -rf .claude/rules/shirokuma/
+rm -f shirokuma-docs.config.yaml
+
+# グローバルキャッシュからプラグインを削除
+claude plugin uninstall shirokuma-skills-ja@shirokuma-library --scope project
+claude plugin uninstall shirokuma-hooks@shirokuma-library --scope project
+```
+
+## 機能
+
+### ドキュメント生成（16 コマンド）
+
+| コマンド | 説明 |
+|---------|------|
+| `typedoc` | TypeDoc API ドキュメント |
+| `schema` | Drizzle ORM → DBML/SVG ER図 |
+| `deps` | 依存関係グラフ（dependency-cruiser） |
+| `test-cases` | Jest/Playwright テストケース抽出 |
+| `coverage` | Jest カバレッジダッシュボード |
+| `portal` | ダークテーマ HTML ドキュメントポータル |
+| `search-index` | 全文検索用 JSON インデックス |
+| `overview` | プロジェクト概要ページ |
+| `feature-map` | 機能階層マップ（4層構造） |
+| `link-docs` | API-テスト双方向リンク |
+| `screenshots` | Playwright スクリーンショット生成 |
+| `details` | 各要素の詳細ページ（Screen, Component, Action, Table） |
+| `impact` | 変更影響分析 |
+| `api-tools` | MCP ツールドキュメント |
+| `i18n` | i18n 翻訳ファイルドキュメント |
+| `packages` | モノレポ共有パッケージドキュメント |
+
+### 検証（7 コマンド）
+
+| コマンド | 説明 |
+|---------|------|
+| `lint-tests` | @testdoc コメント品質チェック |
+| `lint-coverage` | 実装-テスト対応チェック |
+| `lint-docs` | ドキュメント構造検証 |
+| `lint-code` | コードアノテーション・構造検証 |
+| `lint-annotations` | アノテーション整合性検証 |
+| `lint-structure` | プロジェクト構造検証 |
+| `lint-workflow` | AI ワークフロー規約検証 |
+
+### GitHub 連携（5 コマンド）
+
+| コマンド | 説明 |
+|---------|------|
+| `issues` | GitHub Issues 管理（Projects フィールド統合） |
+| `projects` | GitHub Projects V2 管理 |
+| `discussions` | GitHub Discussions 管理 |
+| `repo` | リポジトリ情報・ラベル管理 |
+| `discussion-templates` | Discussion テンプレート生成（多言語対応） |
+
+### セッション管理
+
+| コマンド | 説明 |
+|---------|------|
+| `session start` | セッション開始（引き継ぎ + Issues + PRs 一括取得） |
+| `session end` | セッション終了（引き継ぎ保存 + ステータス更新） |
+| `session check` | Issue-Project ステータス整合性チェック（`--fix` で自動修正） |
+
+### 管理・ユーティリティ
+
+| コマンド | 説明 |
+|---------|------|
+| `init` | 設定ファイル初期化（`--with-skills --with-rules` 対応） |
+| `generate` | 全コマンド一括実行 |
+| `update` | スキル・ルール・キャッシュ更新（`update-skills --sync` の短縮形） |
+| `update-skills` | スキル・ルール更新（詳細オプション付き） |
+| `adr` | ADR 管理（GitHub Discussions 連携） |
+| `repo-pairs` | Public/Private リポジトリペア管理 |
+| `github-data` | GitHub データ JSON 生成 |
+| `md` | LLM 最適化 Markdown 管理（build, validate, analyze, lint, list, extract） |
+
+## Claude Code 連携
+
+shirokuma-docs は **shirokuma-skills** プラグイン（EN/JA）を同梱しており、Claude Code 向けのスキル・エージェント・ルールを提供します。
+
+### 主要スキル（全 22 件）
+
+スラッシュコマンドで起動: `/<skill-name>`（例: `/committing-on-issue`、`/working-on-issue #42`）
+
+| カテゴリ | スキル | 用途 |
+|---------|--------|------|
+| **オーケストレーション** | `working-on-issue` | ワークディスパッチャー（エントリポイント） |
+| | `planning-on-issue` | Issue 計画策定 |
+| **セッション** | `starting-session` | 作業セッション開始 |
+| | `ending-session` | セッション終了・引き継ぎ保存 |
+| **開発** | `nextjs-vibe-coding` | Next.js 向け TDD 実装 |
+| | `frontend-designing` | 印象的な UI デザイン |
+| | `codebase-rule-discovery` | パターン発見・規約提案 |
+| | `reviewing-on-issue` | コード / セキュリティレビュー |
+| | `best-practices-researching` | ベストプラクティス調査 |
+| | `claude-config-reviewing` | 設定ファイル品質チェック |
+| **Git / GitHub** | `committing-on-issue` | ステージ・コミット・プッシュ |
+| | `creating-pr-on-issue` | プルリクエスト作成 |
+| | `managing-github-items` | Issue / Discussion 作成 |
+| | `showing-github` | プロジェクトデータ表示 |
+| | `github-project-setup` | プロジェクト初期セットアップ |
+| **設定管理** | `managing-skills` | スキル作成・更新 |
+| | `managing-agents` | エージェント作成・更新 |
+| | `managing-rules` | ルール作成・更新 |
+| | `managing-plugins` | プラグイン作成・更新 |
+| | `managing-output-styles` | 出力スタイル管理 |
+| **その他** | `project-config-generator` | プロジェクト設定ファイル生成 |
+| | `publishing` | repo-pairs 経由のパブリックリリース |
+
+### ルール（全 21 件）
+
+`.claude/rules/shirokuma/` にデプロイ。以下をカバー:
+- Git コミットスタイルとブランチワークフロー
+- GitHub プロジェクトアイテム管理と Discussion 活用
+- Next.js ベストプラクティス（技術スタック、既知の問題、テスト、Tailwind v4）
+- shirokuma-docs CLI 呼び出しとプラグインキャッシュ管理
+- メモリ運用と設定ファイル作成
+
+## 設定ファイル
+
+`shirokuma-docs init` で `shirokuma-docs.config.yaml` が生成されます。各セクションにはインラインコメントで説明が記載されています。
+
+| セクション | 用途 | 必須 |
+|-----------|------|------|
+| `project` | プロジェクト名・説明 | はい |
+| `output` | 出力ディレクトリ | はい |
+| `typedoc` | TypeDoc API ドキュメント | いいえ |
+| `schema` | Drizzle ORM ER図 | いいえ |
+| `deps` | 依存関係グラフ | いいえ |
+| `testCases` | テストケース抽出（Jest/Playwright） | いいえ |
+| `portal` | ドキュメントポータル | いいえ |
+| `lintDocs` / `lintCode` / `lintStructure` | 検証ルール | いいえ |
+| `github` | GitHub Projects / Discussions 連携 | いいえ |
+| `adr` | ADR（Architecture Decision Records） | いいえ |
+
+不要なセクションは削除できます。設定されたセクションのみが有効です。全スキーマは[設定ファイルリファレンス](docs/guide/config.md)を参照してください。
+
+## 出力構造
+
+```
+docs/
+├── portal/
+│   ├── index.html       # ポータルトップページ
+│   ├── viewer.html      # Markdown/DBML/SVG ビューア
+│   └── test-cases.html  # テストケース一覧
+└── generated/
+    ├── api/             # TypeDoc Markdown
+    ├── api-html/        # TypeDoc HTML
+    ├── schema/
+    │   ├── schema.dbml
+    │   └── schema-docs.md
+    ├── dependencies.svg
+    ├── dependencies.html
+    └── test-cases.md
+```
+
+## 動作要件
+
+- **Node.js**: 20.0.0 以上
+- **Claude Code**: スキル・ルール連携に必要
+- **gh CLI**: GitHub コマンドに必要（`gh auth login` 要）
+
+### オプション依存
+
+| ツール | 用途 | インストール |
+|--------|------|-------------|
+| graphviz | 依存関係グラフ SVG | `apt install graphviz` |
+| typedoc | API ドキュメント | `npm i -D typedoc typedoc-plugin-markdown` |
+| dependency-cruiser | 依存関係分析 | `npm i -D dependency-cruiser` |
+| drizzle-dbml-generator | DBML 生成 | `npm i -D drizzle-dbml-generator` |
+
+## ライセンス
+
+MIT
+
+サードパーティライセンスは [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) を参照してください。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,18 @@
+# Third-Party Notices
+
+This project is licensed under the MIT License.
+The following components are licensed under different terms.
+
+## Apache License 2.0
+
+The following files are derived from [anthropics/skills](https://github.com/anthropics/skills)
+(skill-creator), licensed under Apache License 2.0:
+
+- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/scripts/init_skill.py
+- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/scripts/package_skill.py
+- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/scripts/quick_validate.py
+- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/reference-workflows.md
+- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/reference-output-patterns.md
+
+These files have been modified for use in shirokuma-docs.
+See the LICENSE.txt in each managing-skills/scripts directory for the full Apache License 2.0 text.

package/bin/shirokuma-docs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/analyzers/details-test-analysis.d.ts

@@ -0,0 +1,31 @@
+/**
+ * details-test-analysis - テストケース分析
+ *
+ * 要素・モジュールに関連するテストケースを抽出し、
+ * カテゴリ分類とカバレッジ分析を行う。
+ */
+import type { DetailsContext, TestCategory, CategorizedTestCase, TestCoverageAnalysis } from "../commands/details-types.js";
+/**
+ * 要素に関連するテストケースを抽出
+ */
+export declare function findTestCasesForElement(elementName: string, elementPath: string, ctx: DetailsContext): CategorizedTestCase[];
+/**
+ * テスト名からカテゴリを推定
+ */
+export declare function categorizeTest(testName: string, describePath: string): {
+    category: TestCategory;
+    summary: string;
+};
+/**
+ * テスト名から意図を抽出
+ */
+export declare function extractTestIntent(testName: string): string;
+/**
+ * テストカバレッジを分析
+ */
+export declare function analyzeTestCoverage(testCases: CategorizedTestCase[], hasAuth?: boolean, hasDb?: boolean): TestCoverageAnalysis;
+/**
+ * モジュールに関連するテストケースを抽出
+ */
+export declare function findTestCasesForModule(moduleName: string, type: string, ctx: DetailsContext): CategorizedTestCase[];
+//# sourceMappingURL=details-test-analysis.d.ts.map

package/dist/analyzers/details-test-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details-test-analysis.d.ts","sourceRoot":"","sources":["../../src/analyzers/details-test-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAGtC;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,cAAc,GAClB,mBAAmB,EAAE,CAwBvB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAqC7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,mBAAmB,EAAE,EAChC,OAAO,GAAE,OAAe,EACxB,KAAK,GAAE,OAAe,GACrB,oBAAoB,CA+DtB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,cAAc,GAClB,mBAAmB,EAAE,CA+CvB"}

package/dist/analyzers/details-test-analysis.js

@@ -0,0 +1,174 @@
+/**
+ * details-test-analysis - テストケース分析
+ *
+ * 要素・モジュールに関連するテストケースを抽出し、
+ * カテゴリ分類とカバレッジ分析を行う。
+ */
+import { escapeRegExp } from "../utils/sanitize.js";
+/**
+ * 要素に関連するテストケースを抽出
+ */
+export function findTestCasesForElement(elementName, elementPath, ctx) {
+    const results = [];
+    const lowerName = elementName.toLowerCase();
+    for (const tc of ctx.allTestCases) {
+        const descLower = tc.describe.toLowerCase();
+        const fileLower = tc.file.toLowerCase();
+        const isRelevant = descLower.includes(lowerName) ||
+            lowerName.includes(descLower.split(" > ")[0]) ||
+            fileLower.includes(lowerName.replace(/([A-Z])/g, "-$1").toLowerCase());
+        if (isRelevant) {
+            const { category, summary } = categorizeTest(tc.it, tc.describe);
+            results.push({
+                ...tc,
+                category,
+                summary: tc.description || summary,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * テスト名からカテゴリを推定
+ */
+export function categorizeTest(testName, describePath) {
+    const combined = `${describePath.toLowerCase()} ${testName.toLowerCase()}`;
+    // 認証・認可系
+    if (/auth|login|logout|session|permission|role|unauthorized|forbidden|credential|token/.test(combined)) {
+        return { category: "auth", summary: extractTestIntent(testName) };
+    }
+    // エラーハンドリング系
+    if (/throw|error|fail|reject|invalid|exception|catch|not found|404|500/.test(combined)) {
+        if (/valid|schema|required|min|max|format/.test(combined)) {
+            return { category: "validation", summary: extractTestIntent(testName) };
+        }
+        return { category: "error-handling", summary: extractTestIntent(testName) };
+    }
+    // バリデーション系
+    if (/valid|schema|required|min|max|format|type|constraint|sanitize/.test(combined)) {
+        return { category: "validation", summary: extractTestIntent(testName) };
+    }
+    // 境界値・エッジケース系
+    if (/empty|null|undefined|zero|boundary|edge|limit|overflow|special|unicode/.test(combined)) {
+        return { category: "edge-case", summary: extractTestIntent(testName) };
+    }
+    // 統合テスト系
+    if (/integration|e2e|end.to.end|workflow|scenario/.test(combined)) {
+        return { category: "integration", summary: extractTestIntent(testName) };
+    }
+    // 正常系（デフォルト）
+    if (/should|return|create|update|delete|get|fetch|render|display|show/.test(combined)) {
+        return { category: "happy-path", summary: extractTestIntent(testName) };
+    }
+    return { category: "other", summary: extractTestIntent(testName) };
+}
+/**
+ * テスト名から意図を抽出
+ */
+export function extractTestIntent(testName) {
+    const shouldMatch = testName.match(/should\s+(.+?)(?:\s+when\s+(.+))?$/i);
+    if (shouldMatch) {
+        const action = shouldMatch[1];
+        const condition = shouldMatch[2];
+        return condition ? `${action}（${condition}の場合）` : action;
+    }
+    return testName;
+}
+/**
+ * テストカバレッジを分析
+ */
+export function analyzeTestCoverage(testCases, hasAuth = false, hasDb = false) {
+    const byCategory = {
+        "happy-path": [],
+        "error-handling": [],
+        auth: [],
+        validation: [],
+        "edge-case": [],
+        integration: [],
+        other: [],
+    };
+    for (const tc of testCases) {
+        byCategory[tc.category].push(tc);
+    }
+    const missingPatterns = [];
+    const recommendations = [];
+    if (byCategory["happy-path"].length === 0) {
+        missingPatterns.push("正常系テスト");
+        recommendations.push("基本的な正常系テストを追加してください");
+    }
+    if (byCategory["error-handling"].length === 0) {
+        missingPatterns.push("エラーハンドリングテスト");
+        recommendations.push("エラー発生時の挙動をテストしてください");
+    }
+    if (hasAuth && byCategory.auth.length === 0) {
+        missingPatterns.push("認証・認可テスト");
+        recommendations.push("未認証/権限不足時のテストを追加してください");
+    }
+    if (hasDb && byCategory["edge-case"].length === 0) {
+        missingPatterns.push("境界値テスト");
+        recommendations.push("空データ、存在しないID等のエッジケースをテストしてください");
+    }
+    // スコア計算
+    let score = 0;
+    const weights = {
+        "happy-path": 30,
+        "error-handling": 25,
+        auth: hasAuth ? 20 : 0,
+        validation: 15,
+        "edge-case": 10,
+        integration: 5,
+        other: 0,
+    };
+    for (const [cat, weight] of Object.entries(weights)) {
+        if (byCategory[cat].length > 0) {
+            score += weight;
+        }
+    }
+    if (testCases.length >= 5)
+        score = Math.min(score + 10, 100);
+    if (testCases.length >= 10)
+        score = Math.min(score + 10, 100);
+    return {
+        totalTests: testCases.length,
+        byCategory,
+        missingPatterns,
+        coverageScore: score,
+        recommendations,
+    };
+}
+/**
+ * モジュールに関連するテストケースを抽出
+ */
+export function findTestCasesForModule(moduleName, type, ctx) {
+    const results = [];
+    const lowerName = moduleName.toLowerCase();
+    const pathPatterns = [];
+    const escaped = escapeRegExp(lowerName);
+    switch (type) {
+        case "action":
+            pathPatterns.push(new RegExp(`/lib/actions/${escaped}\\.test\\.ts$`, "i"), new RegExp(`/__tests__/lib/actions/${escaped}\\.test\\.ts$`, "i"), new RegExp(`/actions/${escaped}\\.test\\.ts$`, "i"));
+            break;
+        case "component":
+            pathPatterns.push(new RegExp(`/components/${escaped}\\.test\\.tsx?$`, "i"), new RegExp(`/__tests__/components/${escaped}\\.test\\.tsx?$`, "i"), new RegExp(`/components/.*${escaped}.*\\.test\\.tsx?$`, "i"));
+            break;
+        case "screen":
+            pathPatterns.push(new RegExp(`/e2e/${escaped}\\.spec\\.ts$`, "i"), new RegExp(`/${escaped}\\.spec\\.ts$`, "i"));
+            break;
+        default:
+            break;
+    }
+    for (const tc of ctx.allTestCases) {
+        const matchesPath = pathPatterns.some((pattern) => pattern.test(tc.file));
+        const matchesDescribe = tc.describe.toLowerCase().includes(lowerName);
+        if (matchesPath || matchesDescribe) {
+            const { category, summary } = categorizeTest(tc.it, tc.describe);
+            results.push({
+                ...tc,
+                category,
+                summary: tc.description || summary,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=details-test-analysis.js.map

package/dist/analyzers/details-test-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"details-test-analysis.js","sourceRoot":"","sources":["../../src/analyzers/details-test-analysis.ts"],"names":[],"mappings":"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"}

package/dist/analyzers/feature-map-builder.d.ts

@@ -0,0 +1,20 @@
+/**
+ * feature-map ビルダー
+ *
+ * 解析済みの FeatureMapItem 配列から FeatureMap 構造体を構築する。
+ * アイテムをフィーチャー別にグループ化し、適切な型に変換する。
+ */
+import type { ScreenItem, ComponentItem, ActionItem, TableItem, ModuleItem, FeatureGroup, TypeItem, UtilityItem, FeatureMap, FeatureMapItem } from "../commands/feature-map-types.js";
+/**
+ * Feature Map を構築
+ */
+export declare function buildFeatureMap(items: FeatureMapItem[], moduleDescriptions?: Map<string, string>, moduleTypes?: Map<string, TypeItem[]>, moduleUtilities?: Map<string, UtilityItem[]>): FeatureMap;
+/**
+ * アイテムを適切な構造に変換
+ */
+export declare function convertItem(item: FeatureMapItem): ScreenItem | ComponentItem | ActionItem | ModuleItem | TableItem;
+/**
+ * グループにアイテムを追加
+ */
+export declare function addToGroup(group: FeatureGroup, type: FeatureMapItem["type"], item: ScreenItem | ComponentItem | ActionItem | ModuleItem | TableItem): void;
+//# sourceMappingURL=feature-map-builder.d.ts.map

package/dist/analyzers/feature-map-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-map-builder.d.ts","sourceRoot":"","sources":["../../src/analyzers/feature-map-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,UAAU,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,cAAc,EACf,MAAM,kCAAkC,CAAC;AAE1C;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EAAE,EACvB,kBAAkB,GAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAa,EACnD,WAAW,GAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAa,EAChD,eAAe,GAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAa,GACtD,UAAU,CAmEZ;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,cAAc,GACnB,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CA6DlE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAC5B,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GACrE,IAAI,CAkBN"}