@nahisaho/katashiro 2.1.2 → 2.2.0

package/AGENTS.md

@@ -26,6 +26,75 @@
 
 ---
 
+## ⚠️ 重要: TypeScriptコード生成・実行ワークフロー
+
+DeepResearchやその他の機能でTypeScriptコードを生成・実行する際は、**必ず以下のワークフローに従ってください**。
+
+### 必須ワークフロー
+
+```
+1. コード生成
+   ↓
+2. TypeScript型チェック（tsc --noEmit）
+   ↓
+3. エラーがあれば修正
+   ↓
+4. 実行
+```
+
+### 実行前チェックリスト
+
+生成したTypeScriptコードを実行する前に、以下を確認してください：
+
+#### 1. Result型APIのチェック
+```typescript
+// ❌ 間違い - WebScraper.scrape()はResult型を返す
+const page = await scraper.scrape(url);
+console.log(page.content);  // エラー！
+
+// ✅ 正しい
+const page = await scraper.scrape(url);
+if (isOk(page)) {
+  console.log(page.value.content);
+}
+```
+
+#### 2. 直接値APIのチェック
+```typescript
+// ❌ 間違い - TextAnalyzer.analyze()は直接オブジェクトを返す
+const analysis = await analyzer.analyze(text);
+if (isOk(analysis)) {  // エラー！isOk()は不要
+  console.log(analysis.value.keywords);
+}
+
+// ✅ 正しい
+const analysis = await analyzer.analyze(text);
+console.log(analysis.keywords);
+```
+
+#### 3. 型チェックコマンド
+```bash
+# 生成したファイルの型チェック
+npx tsc --noEmit your-script.ts
+
+# エラーがあれば修正してから実行
+npx tsx your-script.ts
+```
+
+### AIエージェントへの指示
+
+**DeepResearch実行時のワークフロー**:
+
+1. **コード生成**: KATASHIROのAPIを使用してTypeScriptコードを生成
+2. **型チェック**: `npx tsc --noEmit` でコンパイルエラーをチェック
+3. **エラー修正**: 型エラーがあれば、このドキュメントの「戻り値の型について」セクションを参照して修正
+4. **実行**: エラーがなくなってから `npx tsx` で実行
+5. **結果確認**: 実行結果を確認し、必要に応じて修正
+
+**重要**: 型チェックをスキップしてはいけません。Result型と直接値の混同は最も一般的なエラーです。
+
+---
+
 ## 🔄 課題解決ワークフロー
 
 ### ステップ1: 課題の分析

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nahisaho/katashiro",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "KATASHIRO - VS Code Agent Mode向け情報収集・分析・生成システム（オールインワンパッケージ）",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -114,6 +114,11 @@
       "default": "./dist/workspace.js"
     }
   },
+  "scripts": {
+    "build": "tsc",
+    "test": "echo \"No tests for meta package\"",
+    "postinstall": "node scripts/postinstall.js"
+  },
   "keywords": [
     "katashiro",
     "vscode",
@@ -157,10 +162,5 @@
   },
   "engines": {
     "node": ">=20.0.0"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "echo \"No tests for meta package\"",
-    "postinstall": "node scripts/postinstall.js"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-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.