feat: set up nabledge-1.x knowledge generation infrastructure (#189)

.claude/skills/nabledge-1.2/plugin/CHANGELOG.md

@@ -0,0 +1,7 @@
+# 変更履歴
+
+nabledge-1.2プラグインの主な変更内容を記録しています。
+
+フォーマットは [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) に基づいています。
+
+## [Unreleased]

.claude/skills/nabledge-1.2/plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "nabledge-1.2",
+  "version": "0.1",
+  "description": "Nablarch 1.2 skill for AI-assisted development",
+  "author": {
+    "name": "Nablarch"
+  },
+  "license": "Apache-2.0",
+  "repository": "https://github.com/nablarch/nabledge",
+  "keywords": [
+    "nablarch"
+  ]
+}

.claude/skills/nabledge-1.3/plugin/CHANGELOG.md

@@ -0,0 +1,7 @@
+# 変更履歴
+
+nabledge-1.3プラグインの主な変更内容を記録しています。
+
+フォーマットは [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) に基づいています。
+
+## [Unreleased]

.claude/skills/nabledge-1.3/plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "nabledge-1.3",
+  "version": "0.1",
+  "description": "Nablarch 1.3 skill for AI-assisted development",
+  "author": {
+    "name": "Nablarch"
+  },
+  "license": "Apache-2.0",
+  "repository": "https://github.com/nablarch/nabledge",
+  "keywords": [
+    "nablarch"
+  ]
+}

.claude/skills/nabledge-1.4/plugin/CHANGELOG.md

@@ -0,0 +1,7 @@
+# 変更履歴
+
+nabledge-1.4プラグインの主な変更内容を記録しています。
+
+フォーマットは [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) に基づいています。
+
+## [Unreleased]

.claude/skills/nabledge-1.4/plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "nabledge-1.4",
+  "version": "0.1",
+  "description": "Nablarch 1.4 skill for AI-assisted development",
+  "author": {
+    "name": "Nablarch"
+  },
+  "license": "Apache-2.0",
+  "repository": "https://github.com/nablarch/nabledge",
+  "keywords": [
+    "nablarch"
+  ]
+}

.pr/00190/notes.md

@@ -0,0 +1,53 @@
+# Notes - PR #190
+
+## 2026-03-13
+
+### 現在の作業状況（再開ポイント）
+
+**未コミットの変更ファイル** (`tools/knowledge-creator/` 配下):
+
+| ファイル | 状態 | 内容 |
+|---------|------|------|
+| `mappings/v1.4.json` | modified | `document/` prefix を全パターンに追加、sample/portal パターン追加（ID dedup 修正）、レビュー指摘を反映 |
+| `mappings/v1.3.json` | **new (未追跡)** | single-repo パターン（`1.3_maintain/` をストリップ後のパス） |
+| `mappings/v1.2.json` | **new (未追跡)** | single-repo パターン（`1.2_maintain/` をストリップ後のパス） |
+| `scripts/step2_classify.py` | modified | v1.4用条件分岐: `classify_rst`と`generate_id`でrepoマーカーをrel_pathに残す |
+| `tests/e2e/generate_expected.py` | modified | 同上の修正（E2Eテスト期待値生成用） |
+
+### 次のステップ
+
+1. **E2Eテスト確認**:
+   ```bash
+   cd tools/knowledge-creator
+   python -m pytest tests/e2e/test_e2e.py -k "1.4" -v
+   ```
+2. 通ったら **全バージョン** も確認:
+   ```bash
+   python -m pytest tests/e2e/test_e2e.py -v
+   ```
+3. テスト通過後、全5ファイルをコミット:
+   ```bash
+   git add tools/knowledge-creator/mappings/v1.4.json \
+           tools/knowledge-creator/mappings/v1.3.json \
+           tools/knowledge-creator/mappings/v1.2.json \
+           tools/knowledge-creator/scripts/step2_classify.py \
+           tools/knowledge-creator/tests/e2e/generate_expected.py
+   git commit -m "feat: add v1.4/v1.3/v1.2 mapping files and fix multi-repo path handling"
+   ```
+4. Push して PR #190 のレビューコメントに返信
+
+### 重要な設計判断（絶対に戻さないこと）
+
+**v1.4 multi-repo パス処理**:
+- `step2_classify.py`: v1.4 のみ `rel_path = marker + path[idx + len(marker):]`（`document/`, `workflow/` 等のprefixを保持）
+- v5/v6 の後方互換を保つため `if self.ctx.version == "1.4":` で条件分岐
+- `v1.4.json` のパターンはrepoプレフィックス付き（例: `document/FAQ/batch/`）
+- `v1.2.json` / `v1.3.json` のパターンはプレフィックスなし（single-repo、マーカーストリップ後のパス）
+
+### テストが失敗していた経緯
+
+- 最初: v1.4.json のパターンが `FAQ/batch/`（prefixなし）→ 117ファイル未マッピング
+- 修正1: step2_classify.py でマーカーを保持 + v1.4.json に `document/` prefix 追加
+- 修正2: `sample/portal/src/source/faq/*` のIDデデュップ失敗 → 個別パターン追加
+- 修正3: session-scoped fixture が v1.3.json を要求 → v1.3.json / v1.2.json 新規作成
+- 現状: v1.3.json/v1.2.json 作成済み、テスト実行中（セッション終了のため結果未確認）

README.md

@@ -31,6 +31,25 @@ cp .env.example .env
 # .env を編集して認証情報を設定する
 ```
 
+### 3. Nablarch 1.x ドキュメントのセットアップ（v1.4/1.3/1.2 の知識ファイルを生成する場合）
+
+Nablarch 1.x のドキュメントは GitHub で公開されていないため、ローカルにあるドキュメントディレクトリへのシンボリックリンクを手動で設定する必要があります。
+
+リポジトリルートで以下を実行します（`/path/to/` は実際のローカルパスに置き換えてください）：
+
+```bash
+mkdir -p .lw/nab-official/v1.4 .lw/nab-official/v1.3 .lw/nab-official/v1.2
+ln -s /path/to/1.4_maintain .lw/nab-official/v1.4/1.4_maintain
+ln -s /path/to/1.3_maintain .lw/nab-official/v1.3/1.3_maintain
+ln -s /path/to/1.2_maintain .lw/nab-official/v1.2/1.2_maintain
+```
+
+設定後、knowledge-creator で知識ファイルを生成できます：
+
+```bash
+./tools/knowledge-creator/kc.sh gen 1.4
+```
+
 ## 使い方
 
 ```bash

setup.sh

@@ -98,7 +98,7 @@ sudo apt-get update
 
 # Check if tools are already installed
 TOOLS_MISSING=0
-for tool in libreoffice pdftoppm pandoc jq python3 gh; do
+for tool in libreoffice pdftoppm pandoc jq python3 svn gh; do
     if ! command -v "$tool" &> /dev/null; then
         TOOLS_MISSING=1
         break
@@ -108,8 +108,8 @@ done
 if [ $TOOLS_MISSING -eq 0 ]; then
     print_status ok "System tools already installed"
 else
-    print_status info "Installing LibreOffice, Poppler, Pandoc, jq, Python3..."
-    if sudo apt-get install -y libreoffice poppler-utils pandoc jq python3 python3-venv; then
+    print_status info "Installing LibreOffice, Poppler, Pandoc, jq, Python3, Subversion..."
+    if sudo apt-get install -y libreoffice poppler-utils pandoc jq python3 python3-venv subversion; then
         print_status ok "System tools installed"
     else
         print_status error "Failed to install system tools"
@@ -363,6 +363,41 @@ clone_repos_from_meta() {
 clone_repos_from_meta "6" "$NAB_OFFICIAL_V6_DIR"
 clone_repos_from_meta "5" "$NAB_OFFICIAL_V5_DIR"
 
+# Check Nablarch 1.x symlinks (v1.4/v1.3/v1.2)
+print_header "10. Checking Nablarch 1.x Documentation (v1.4/1.3/1.2)"
+
+V1X_VERSIONS=("1.4:1.4_maintain" "1.3:1.3_maintain" "1.2:1.2_maintain")
+V1X_MISSING=()
+
+for entry in "${V1X_VERSIONS[@]}"; do
+    ver="${entry%%:*}"
+    dir_name="${entry##*:}"
+    link_path=".lw/nab-official/v${ver}/${dir_name}"
+    if [ -e "$link_path" ]; then
+        print_status ok "v${ver}: ${link_path} exists"
+    else
+        V1X_MISSING+=("$ver")
+        print_status warning "v${ver}: ${link_path} not found (skip)"
+    fi
+done
+
+if [ ${#V1X_MISSING[@]} -gt 0 ]; then
+    echo ""
+    echo "  Nablarch 1.x documents are not hosted on GitHub."
+    echo "  To generate knowledge files for v1.4/1.3/1.2, create symlinks manually."
+    echo "  (Claude Code cannot run these commands due to security restrictions on paths outside the repository.)"
+    echo ""
+    echo "  Run the following yourself from the repository root (replace /path/to/ with actual local paths):"
+    echo ""
+    echo "    ln -s /path/to/1.4_maintain .lw/nab-official/v1.4/1.4_maintain"
+    echo "    ln -s /path/to/1.3_maintain .lw/nab-official/v1.3/1.3_maintain"
+    echo "    ln -s /path/to/1.2_maintain .lw/nab-official/v1.2/1.2_maintain"
+    echo ""
+    echo "  Then generate knowledge files:"
+    echo "    ./tools/knowledge-creator/kc.sh gen 1.4"
+    echo ""
+fi
+
 # Final summary
 print_header "Setup Completed Successfully!"
 

tools/knowledge-creator/.cache/v1.2/catalog.json

@@ -0,0 +1,13 @@
+{
+  "version": "1.2",
+  "base_doc_url": "",
+  "generated_at": "",
+  "sources": [
+    {
+      "repo": "local",
+      "branch": "local",
+      "commit": ""
+    }
+  ],
+  "files": []
+}

tools/knowledge-creator/.cache/v1.3/catalog.json

@@ -0,0 +1,13 @@
+{
+  "version": "1.3",
+  "base_doc_url": "",
+  "generated_at": "",
+  "sources": [
+    {
+      "repo": "local",
+      "branch": "local",
+      "commit": ""
+    }
+  ],
+  "files": []
+}

tools/knowledge-creator/.cache/v1.4/catalog.json

@@ -0,0 +1,13 @@
+{
+  "version": "1.4",
+  "base_doc_url": "",
+  "generated_at": "",
+  "sources": [
+    {
+      "repo": "local",
+      "branch": "local",
+      "commit": ""
+    }
+  ],
+  "files": []
+}

tools/knowledge-creator/mappings/v1.2.json

@@ -0,0 +1,53 @@
+{
+  "rst": [
+    {"pattern": "FAQ/batch/", "type": "processing-pattern", "category": "nablarch-batch"},
+    {"pattern": "FAQ/test/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "FAQ/validation/", "type": "component", "category": "libraries"},
+    {"pattern": "FAQ/web/", "type": "processing-pattern", "category": "web-application"},
+    {"pattern": "FAQ/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "TOP/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "fw/handler/", "type": "component", "category": "handlers"},
+    {"pattern": "fw/reader/", "type": "component", "category": "readers"},
+    {"pattern": "fw/core_library/", "type": "component", "category": "libraries"},
+    {"pattern": "fw/common_library/", "type": "component", "category": "libraries"},
+    {"pattern": "fw/02_FunctionDemandSpecifications/", "type": "component", "category": "libraries"},
+    {"pattern": "fw/architectural_pattern/batch", "type": "processing-pattern", "category": "nablarch-batch"},
+    {"pattern": "fw/architectural_pattern/messaging_http", "type": "processing-pattern", "category": "http-messaging"},
+    {"pattern": "fw/architectural_pattern/messaging", "type": "processing-pattern", "category": "mom-messaging"},
+    {"pattern": "fw/architectural_pattern/web_gui", "type": "processing-pattern", "category": "web-application"},
+    {"pattern": "fw/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "guide/05_UnitTestGuide/02_RequestUnitTest/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/05_UnitTestGuide/03_DealUnitTest/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/05_UnitTestGuide/01_ClassUnitTest/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/05_UnitTestGuide/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/06_TestFWGuide/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/08_TestTools/04_JspStaticAnalysis/", "type": "development-tools", "category": "java-static-analysis"},
+    {"pattern": "guide/08_TestTools/05_JavaStaticAnalysis/", "type": "development-tools", "category": "java-static-analysis"},
+    {"pattern": "guide/08_TestTools/", "type": "development-tools", "category": "toolbox"},
+    {"pattern": "guide/02_UnitTestOutline/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/03_DevelopmentStep/", "type": "guide", "category": "web-application"},
+    {"pattern": "guide/04_Explanation_batch/", "type": "guide", "category": "nablarch-batch"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_delayed_receive/", "type": "guide", "category": "mom-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_delayed_send/", "type": "guide", "category": "mom-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_http_real/", "type": "guide", "category": "http-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_http_send_sync/", "type": "guide", "category": "http-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_real/", "type": "guide", "category": "mom-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_send_sync/", "type": "guide", "category": "mom-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/", "type": "guide", "category": "mom-messaging"},
+    {"pattern": "guide/04_Explanation_other/04_Explanation_mail/", "type": "guide", "category": "libraries"},
+    {"pattern": "guide/04_Explanation_other/", "type": "guide", "category": "libraries"},
+    {"pattern": "guide/04_Explanation/", "type": "guide", "category": "web-application"},
+    {"pattern": "guide/20_Appendix/", "type": "guide", "category": "web-application"},
+    {"pattern": "guide/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "sample/portal/src/source/faq/batch/", "type": "processing-pattern", "category": "nablarch-batch"},
+    {"pattern": "sample/portal/src/source/faq/test/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "sample/portal/src/source/faq/validation/", "type": "component", "category": "libraries"},
+    {"pattern": "sample/portal/src/source/faq/web/", "type": "processing-pattern", "category": "web-application"},
+    {"pattern": "sample/portal/src/source/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "sample/portal/doc/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "tool/", "type": "development-tools", "category": "toolbox"}
+  ],
+  "md": {},
+  "xlsx": {},
+  "xlsx_patterns": []
+}

tools/knowledge-creator/mappings/v1.3.json

@@ -0,0 +1,53 @@
+{
+  "rst": [
+    {"pattern": "FAQ/batch/", "type": "processing-pattern", "category": "nablarch-batch"},
+    {"pattern": "FAQ/test/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "FAQ/validation/", "type": "component", "category": "libraries"},
+    {"pattern": "FAQ/web/", "type": "processing-pattern", "category": "web-application"},
+    {"pattern": "FAQ/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "TOP/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "fw/handler/", "type": "component", "category": "handlers"},
+    {"pattern": "fw/reader/", "type": "component", "category": "readers"},
+    {"pattern": "fw/core_library/", "type": "component", "category": "libraries"},
+    {"pattern": "fw/common_library/", "type": "component", "category": "libraries"},
+    {"pattern": "fw/02_FunctionDemandSpecifications/", "type": "component", "category": "libraries"},
+    {"pattern": "fw/architectural_pattern/batch", "type": "processing-pattern", "category": "nablarch-batch"},
+    {"pattern": "fw/architectural_pattern/messaging_http", "type": "processing-pattern", "category": "http-messaging"},
+    {"pattern": "fw/architectural_pattern/messaging", "type": "processing-pattern", "category": "mom-messaging"},
+    {"pattern": "fw/architectural_pattern/web_gui", "type": "processing-pattern", "category": "web-application"},
+    {"pattern": "fw/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "guide/05_UnitTestGuide/02_RequestUnitTest/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/05_UnitTestGuide/03_DealUnitTest/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/05_UnitTestGuide/01_ClassUnitTest/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/05_UnitTestGuide/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/06_TestFWGuide/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/08_TestTools/04_JspStaticAnalysis/", "type": "development-tools", "category": "java-static-analysis"},
+    {"pattern": "guide/08_TestTools/05_JavaStaticAnalysis/", "type": "development-tools", "category": "java-static-analysis"},
+    {"pattern": "guide/08_TestTools/", "type": "development-tools", "category": "toolbox"},
+    {"pattern": "guide/02_UnitTestOutline/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "guide/03_DevelopmentStep/", "type": "guide", "category": "web-application"},
+    {"pattern": "guide/04_Explanation_batch/", "type": "guide", "category": "nablarch-batch"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_delayed_receive/", "type": "guide", "category": "mom-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_delayed_send/", "type": "guide", "category": "mom-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_http_real/", "type": "guide", "category": "http-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_http_send_sync/", "type": "guide", "category": "http-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_real/", "type": "guide", "category": "mom-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/04_Explanation_send_sync/", "type": "guide", "category": "mom-messaging"},
+    {"pattern": "guide/04_Explanation_messaging/", "type": "guide", "category": "mom-messaging"},
+    {"pattern": "guide/04_Explanation_other/04_Explanation_mail/", "type": "guide", "category": "libraries"},
+    {"pattern": "guide/04_Explanation_other/", "type": "guide", "category": "libraries"},
+    {"pattern": "guide/04_Explanation/", "type": "guide", "category": "web-application"},
+    {"pattern": "guide/20_Appendix/", "type": "guide", "category": "web-application"},
+    {"pattern": "guide/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "sample/portal/src/source/faq/batch/", "type": "processing-pattern", "category": "nablarch-batch"},
+    {"pattern": "sample/portal/src/source/faq/test/", "type": "development-tools", "category": "testing-framework"},
+    {"pattern": "sample/portal/src/source/faq/validation/", "type": "component", "category": "libraries"},
+    {"pattern": "sample/portal/src/source/faq/web/", "type": "processing-pattern", "category": "web-application"},
+    {"pattern": "sample/portal/src/source/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "sample/portal/doc/", "type": "about", "category": "about-nablarch"},
+    {"pattern": "tool/", "type": "development-tools", "category": "toolbox"}
+  ],
+  "md": {},
+  "xlsx": {},
+  "xlsx_patterns": []
+}