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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ShirokumaLibrary
+
+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.en.md

@@ -0,0 +1,308 @@
+# shirokuma-docs
+
+Next.js + TypeScript project documentation generator CLI with bundled Claude Code skills.
+
+[日本語](README.md)
+
+## Installation
+
+### Recommended: Installer Script (No sudo required)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash
+```
+
+To pre-select a language:
+
+```bash
+# Japanese
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash -s -- --lang ja
+
+# English
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash -s -- --lang en
+```
+
+This installs shirokuma-docs to `~/.local/` with a symlink in `~/.local/bin/`. Claude Code users already have `~/.local/bin` in PATH.
+
+### Alternative: npm / pnpm global install
+
+```bash
+# npm
+npm install -g @shirokuma-library/shirokuma-docs
+
+# pnpm
+pnpm add -g @shirokuma-library/shirokuma-docs
+```
+
+### Verify Installation
+
+```bash
+shirokuma-docs --version
+# => 0.1.0-alpha.1
+```
+
+## Getting Started
+
+### 1. Initialize
+
+```bash
+cd /path/to/your/project
+shirokuma-docs init --with-skills --with-rules --lang en
+```
+
+This creates `shirokuma-docs.config.yaml`, installs plugins, and deploys rules to `.claude/rules/shirokuma/`.
+
+### 2. Customize the Config
+
+Open `shirokuma-docs.config.yaml` and edit paths to match your project structure:
+
+```yaml
+project:
+  name: "MyProject"           # Your project name
+  description: "..."
+
+typedoc:
+  entryPoints:
+    - "./src/lib/actions"      # Change to your source paths
+    - "./src/db/schema"
+  tsconfig: "./tsconfig.json"
+
+schema:
+  sources:
+    - path: "./src/db/schema"  # Drizzle ORM schema path
+```
+
+**Don't use Drizzle ORM?** Delete the `schema` section entirely.
+Other optional sections (`deps`, `testCases`, `lintDocs`, etc.) can be removed if not needed — only configured sections run with `generate`.
+
+### 3. Generate Documentation
+
+```bash
+# Run all configured commands
+shirokuma-docs generate
+
+# Or run individually
+shirokuma-docs test-cases -p .
+shirokuma-docs deps -p .
+shirokuma-docs portal -p .
+```
+
+### 4. Start Using with Claude Code
+
+Start a new Claude Code session. Skills will be available as slash commands (e.g., `/working-on-issue #42`).
+
+See [Getting Started Guide](docs/guide/getting-started.md) for detailed setup instructions.
+
+## Upgrade
+
+```bash
+# Step 1: Update CLI
+curl -fsSL https://raw.githubusercontent.com/ShirokumaLibrary/shirokuma-docs/main/install.sh | bash
+# or: npm update -g @shirokuma-library/shirokuma-docs
+
+# Step 2: Update plugins, rules, and cache
+cd /path/to/your/project
+shirokuma-docs update
+
+# Step 3: Start a new Claude Code session
+```
+
+### Troubleshooting
+
+If skills don't update after `shirokuma-docs update`:
+
+```bash
+# Force cache refresh
+claude plugin uninstall shirokuma-skills-en@shirokuma-library --scope project
+claude plugin install shirokuma-skills-en@shirokuma-library --scope project
+```
+
+## Uninstall
+
+```bash
+# If installed via install.sh
+rm -f ~/.local/bin/shirokuma-docs
+rm -rf ~/.local/share/shirokuma-docs
+
+# If installed via npm
+npm uninstall -g @shirokuma-library/shirokuma-docs
+```
+
+To remove per-project files:
+
+```bash
+# Remove deployed rules and config
+rm -rf .claude/rules/shirokuma/
+rm -f shirokuma-docs.config.yaml
+
+# Remove plugins from global cache
+claude plugin uninstall shirokuma-skills-en@shirokuma-library --scope project
+claude plugin uninstall shirokuma-hooks@shirokuma-library --scope project
+```
+
+## Features
+
+### Documentation Generation (16 commands)
+
+| Command | Description |
+|---------|-------------|
+| `typedoc` | TypeDoc API documentation |
+| `schema` | Drizzle ORM to DBML/SVG ER diagrams |
+| `deps` | Dependency graph (dependency-cruiser) |
+| `test-cases` | Jest/Playwright test case extraction |
+| `coverage` | Jest coverage dashboard |
+| `portal` | Dark-themed HTML documentation portal |
+| `search-index` | Full-text search JSON index |
+| `overview` | Project overview page |
+| `feature-map` | Feature hierarchy map (4-layer) |
+| `link-docs` | API-test bidirectional links |
+| `screenshots` | Playwright screenshot generation |
+| `details` | Entity detail pages (Screen, Component, Action, Table) |
+| `impact` | Change impact analysis |
+| `api-tools` | MCP tool documentation |
+| `i18n` | i18n translation file documentation |
+| `packages` | Monorepo shared package documentation |
+
+### Validation (7 commands)
+
+| Command | Description |
+|---------|-------------|
+| `lint-tests` | @testdoc comment quality check |
+| `lint-coverage` | Implementation-test correspondence check |
+| `lint-docs` | Document structure validation |
+| `lint-code` | Code annotation / structure validation |
+| `lint-annotations` | Annotation consistency validation |
+| `lint-structure` | Project structure validation |
+| `lint-workflow` | AI workflow convention validation |
+
+### GitHub Integration (5 commands)
+
+| Command | Description |
+|---------|-------------|
+| `issues` | GitHub Issues management (Projects field integration) |
+| `projects` | GitHub Projects V2 management |
+| `discussions` | GitHub Discussions management |
+| `repo` | Repository info / label management |
+| `discussion-templates` | Discussion form template generation (i18n) |
+
+### Session Management
+
+| Command | Description |
+|---------|-------------|
+| `session start` | Start session (handover + issues + PRs) |
+| `session end` | End session (save handover + status update) |
+| `session check` | Issue-Project status consistency check (`--fix` for auto-repair) |
+
+### Management & Utilities
+
+| Command | Description |
+|---------|-------------|
+| `init` | Initialize config (with `--with-skills --with-rules` support) |
+| `generate` | Run all generation commands |
+| `update` | Update skills, rules, and cache (shorthand for `update-skills --sync`) |
+| `update-skills` | Update skills/rules with detailed options |
+| `adr` | ADR management (GitHub Discussions integration) |
+| `repo-pairs` | Public/Private repository pair management |
+| `github-data` | GitHub data JSON generation |
+| `md` | LLM-optimized Markdown management (build, validate, analyze, lint, list, extract) |
+
+## Claude Code Integration
+
+shirokuma-docs bundles the **shirokuma-skills** plugin (EN/JA), which provides skills, agents, and rules for Claude Code.
+
+### Key Skills (22 total)
+
+Invoke any skill as a slash command: `/<skill-name>` (e.g., `/committing-on-issue`, `/working-on-issue #42`).
+
+| Category | Skill | Purpose |
+|----------|-------|---------|
+| **Orchestration** | `working-on-issue` | Work dispatcher (entry point) |
+| | `planning-on-issue` | Issue planning phase |
+| **Session** | `starting-session` | Start work session |
+| | `ending-session` | End session with handover |
+| **Development** | `nextjs-vibe-coding` | TDD implementation for Next.js |
+| | `frontend-designing` | Distinctive UI design |
+| | `codebase-rule-discovery` | Pattern discovery + convention proposal |
+| | `reviewing-on-issue` | Code / security review |
+| | `best-practices-researching` | Research best practices |
+| | `claude-config-reviewing` | Config file quality check |
+| **Git / GitHub** | `committing-on-issue` | Stage, commit, push |
+| | `creating-pr-on-issue` | Create pull request |
+| | `managing-github-items` | Issue / Discussion creation |
+| | `showing-github` | Display project data / dashboard |
+| | `github-project-setup` | Project initial setup |
+| **Config** | `managing-skills` | Create / update skills |
+| | `managing-agents` | Create / update agents |
+| | `managing-rules` | Create / update rules |
+| | `managing-plugins` | Create / update plugins |
+| | `managing-output-styles` | Manage output styles |
+| **Other** | `project-config-generator` | Generate project config files |
+| | `publishing` | Public release via repo-pairs |
+
+### Rules (21 total)
+
+Deployed to `.claude/rules/shirokuma/`, covering:
+- Git commit style and branch workflow
+- GitHub project item management and Discussion usage
+- Next.js best practices (tech stack, known issues, testing, Tailwind v4)
+- shirokuma-docs CLI usage and plugin cache management
+- Memory operations and config authoring
+
+## Configuration
+
+`shirokuma-docs init` generates `shirokuma-docs.config.yaml` with all available sections. Each section includes inline comments explaining what it does and how to customize it.
+
+| Section | Purpose | Required |
+|---------|---------|----------|
+| `project` | Project name and description | Yes |
+| `output` | Output directories | Yes |
+| `typedoc` | TypeDoc API documentation | No |
+| `schema` | Drizzle ORM ER diagrams | No |
+| `deps` | Dependency graph | No |
+| `testCases` | Test case extraction (Jest/Playwright) | No |
+| `portal` | Documentation portal | No |
+| `lintDocs` / `lintCode` / `lintStructure` | Validation rules | No |
+| `github` | GitHub Projects / Discussions integration | No |
+| `adr` | Architecture Decision Records | No |
+
+Remove any section you don't need — only configured sections are active. See [Configuration Reference](docs/guide/config.md) for the full schema.
+
+## Output Structure
+
+```
+docs/
+├── portal/
+│   ├── index.html       # Portal top page
+│   ├── viewer.html      # Markdown/DBML/SVG viewer
+│   └── test-cases.html  # Test case list
+└── generated/
+    ├── api/             # TypeDoc Markdown
+    ├── api-html/        # TypeDoc HTML
+    ├── schema/
+    │   ├── schema.dbml
+    │   └── schema-docs.md
+    ├── dependencies.svg
+    ├── dependencies.html
+    └── test-cases.md
+```
+
+## Requirements
+
+- **Node.js**: 20.0.0+
+- **Claude Code**: For skills/rules integration
+- **gh CLI**: For GitHub commands (`gh auth login` required)
+
+### Optional Dependencies
+
+| Tool | Purpose | Install |
+|------|---------|---------|
+| graphviz | Dependency graph SVG | `apt install graphviz` |
+| typedoc | API documentation | `npm i -D typedoc typedoc-plugin-markdown` |
+| dependency-cruiser | Dependency analysis | `npm i -D dependency-cruiser` |
+| drizzle-dbml-generator | DBML generation | `npm i -D drizzle-dbml-generator` |
+
+## License
+
+MIT
+
+See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for third-party license information.

package/README.md

@@ -0,0 +1,308 @@
+# 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. ドキュメント生成
+
+```bash
+# 全コマンド一括実行
+shirokuma-docs generate
+
+# 個別実行
+shirokuma-docs test-cases -p .
+shirokuma-docs deps -p .
+shirokuma-docs portal -p .
+```
+
+### 4. 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;AAEtC;;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,CA8CvB"}