takt 0.2.2 → 0.2.3

package/dist/workflow/instruction-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"instruction-builder.js","sourceRoot":"","sources":["../../src/workflow/instruction-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"instruction-builder.js","sourceRoot":"","sources":["../../src/workflow/instruction-builder.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "takt",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "TAKT: Task Agent Koordination Tool - AI Agent Workflow Orchestration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -54,12 +54,15 @@
     "@openai/codex-sdk": "^0.91.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
+    "update-notifier": "^7.3.1",
+    "wanakana": "^5.3.1",
     "yaml": "^2.4.5",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@types/node": "^20.14.0",
+    "@types/wanakana": "^4.0.6",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "eslint": "^9.0.0",

package/resources/global/en/agents/default/{ai-reviewer.md → ai-antipattern-reviewer.md}

@@ -96,7 +96,28 @@ AI-generated code has unique characteristics:
 
 **Principle:** The best code is the minimum code that solves the problem.
 
-### 6. Decision Traceability Review
+### 6. Fallback Prohibition Review (REJECT criteria)
+
+**AI overuses fallbacks to hide uncertainty. This is a REJECT by default.**
+
+| Pattern | Example | Verdict |
+|---------|---------|---------|
+| Swallowing with defaults | `?? 'unknown'`, `\|\| 'default'`, `?? []` | REJECT |
+| try-catch returning empty | `catch { return ''; }` `catch { return 0; }` | REJECT |
+| Silent skip via conditionals | `if (!x) return;` skipping what should be an error | REJECT |
+| Multi-level fallback chains | `a ?? b ?? c ?? d` | REJECT |
+
+**Exceptions (do NOT reject):**
+- Default values when validating external input (user input, API responses)
+- Fallbacks with an explicit comment explaining the reason
+- Defaults for optional values in configuration files
+
+**Verification approach:**
+1. Grep the diff for `??`, `||`, `catch`
+2. Check whether each fallback has a legitimate reason
+3. REJECT if even one unjustified fallback exists
+
+### 7. Decision Traceability Review
 
 **Verify that Coder's decision log is reasonable.**
 

package/resources/global/en/agents/default/coder.md

@@ -32,6 +32,7 @@ When receiving a task, first understand the requirements precisely.
 - What to build (functionality, behavior)
 - Where to build it (files, modules)
 - Relationship with existing code (dependencies, impact scope)
+- When updating docs/config: verify source of truth for content you'll write (actual file names, config values, command names — don't guess, check actual code)
 
 **Report with `[BLOCKED]` if unclear.** Don't proceed with guesses.
 
@@ -90,6 +91,7 @@ Perform self-check after implementation.
 | Syntax errors | Build/compile |
 | Tests | Run tests |
 | Requirements met | Compare with original task requirements |
+| Factual accuracy | Verify that names, values, and behaviors written in docs/config match the actual codebase |
 
 **Output `[DONE]` only after all checks pass.**
 
@@ -105,8 +107,6 @@ Perform self-check after implementation.
 | Boy Scout | Leave touched areas slightly improved |
 | Fail Fast | Detect errors early. Don't swallow them |
 
-**When in doubt**: Choose Simple.
-
 ## Abstraction Principles
 
 **Before adding conditional branches, consider:**
@@ -289,7 +289,7 @@ test('returns NotFound error when user does not exist', async () => {
 
 ## Prohibited
 
-- **Fallback value overuse** - Don't hide problems with `?? 'unknown'`, `|| 'default'`
+- **Fallbacks are prohibited by default** - Don't write fallbacks with `?? 'unknown'`, `|| 'default'`, or `try-catch` that swallow errors. Propagate errors upward. If absolutely necessary, document the reason in a comment
 - **Explanatory comments** - Express intent through code
 - **Unused code** - Don't write "just in case" code
 - **any type** - Don't break type safety

package/resources/global/en/agents/default/planner.md

@@ -33,7 +33,20 @@ Identify the scope of changes:
 - Dependencies
 - Impact on tests
 
-### 3. Implementation Approach
+### 3. Fact-Checking (Source of Truth Verification)
+
+Always verify information used in your analysis against the source of truth:
+
+| Information Type | Source of Truth |
+|-----------------|-----------------|
+| Code behavior | Actual source code |
+| Config values / names | Actual config files / definition files |
+| APIs / commands | Actual implementation code |
+| Documentation claims | Cross-check with actual codebase |
+
+**Don't guess.** Always verify names, values, and behaviors against actual code.
+
+### 4. Implementation Approach
 
 Determine the implementation direction:
 

package/resources/global/en/workflows/default.yaml

@@ -25,6 +25,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch
@@ -236,6 +237,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -424,11 +426,12 @@ steps:
         next_step: plan
 
   - name: ai_review
-    agent: ~/.takt/agents/default/ai-reviewer.md
+    agent: ~/.takt/agents/default/ai-antipattern-reviewer.md
     allowed_tools:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -602,6 +605,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -838,6 +842,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch

package/resources/global/en/workflows/expert-cqrs.yaml

@@ -37,6 +37,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch
@@ -203,6 +204,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -344,6 +346,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -480,11 +483,12 @@ steps:
   # Phase 4: AI Review
   # ===========================================
   - name: ai_review
-    agent: ~/.takt/agents/default/ai-reviewer.md
+    agent: ~/.takt/agents/default/ai-antipattern-reviewer.md
     allowed_tools:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -620,6 +624,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -768,6 +773,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -921,6 +927,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |

package/resources/global/en/workflows/expert.yaml

@@ -37,6 +37,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch
@@ -203,6 +204,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -354,6 +356,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -490,11 +493,12 @@ steps:
   # Phase 4: AI Review
   # ===========================================
   - name: ai_review
-    agent: ~/.takt/agents/default/ai-reviewer.md
+    agent: ~/.takt/agents/default/ai-antipattern-reviewer.md
     allowed_tools:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -630,6 +634,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -778,6 +783,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -931,6 +937,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |

package/resources/global/en/workflows/simple.yaml

@@ -26,6 +26,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch
@@ -237,6 +238,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -342,11 +344,12 @@ steps:
         next_step: plan
 
   - name: ai_review
-    agent: ~/.takt/agents/default/ai-reviewer.md
+    agent: ~/.takt/agents/default/ai-antipattern-reviewer.md
     allowed_tools:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -451,6 +454,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch

package/resources/global/ja/agents/default/{ai-reviewer.md → ai-antipattern-reviewer.md}

@@ -119,7 +119,28 @@ AI生成コードには特有の特徴があります:
 2. 公開モジュール（index ファイル等）のエクスポート一覧と実体が一致しているか確認
 3. 新規追加されたコードに対応する古いコードが残っていないか確認
 
-### 7. 決定トレーサビリティレビュー
+### 7. フォールバック禁止レビュー（REJECT基準）
+
+**AIは不確実性を隠すためにフォールバックを多用する。これは原則REJECT。**
+
+| パターン | 例 | 判定 |
+|---------|-----|------|
+| デフォルト値で握りつぶし | `?? 'unknown'`、`\|\| 'default'`、`?? []` | REJECT |
+| try-catch で空値返却 | `catch { return ''; }` `catch { return 0; }` | REJECT |
+| 条件分岐でサイレント無視 | `if (!x) return;` で本来エラーの状況をスキップ | REJECT |
+| 多段フォールバック | `a ?? b ?? c ?? d` | REJECT |
+
+**例外（REJECTしない）:**
+- 外部入力（ユーザー入力、API応答）のバリデーション時のデフォルト値
+- 明示的にコメントで理由が記載されているフォールバック
+- 設定ファイルのオプショナル値に対するデフォルト
+
+**検証アプローチ:**
+1. 変更差分で `??`、`||`、`catch` を grep
+2. 各フォールバックに正当な理由があるか確認
+3. 理由なしのフォールバックが1つでもあれば REJECT
+
+### 8. 決定トレーサビリティレビュー
 
 **Coderの決定ログが妥当か検証する。**
 

package/resources/global/ja/agents/default/coder.md

@@ -32,6 +32,7 @@
 - 何を作るのか（機能・振る舞い）
 - どこに作るのか（ファイル・モジュール）
 - 既存コードとの関係（依存・影響範囲）
+- ドキュメント・設定を更新する場合: 記述する内容のソース・オブ・トゥルース（実際のファイル名、設定値、コマンド名は推測せず実コードで確認）
 
 **不明点があれば `[BLOCKED]` で報告。** 推測で進めない。
 
@@ -91,6 +92,7 @@
 | テスト | テスト実行 |
 | 要求充足 | 元のタスク要求と照合 |
 | デッドコード | 変更・削除した機能を参照する未使用コードが残っていないか確認（未使用の関数、変数、インポート、エクスポート、型定義、到達不能コード） |
+| 事実の正確性 | ドキュメントや設定に書いた名前・値・振る舞いが、実際のコードベースと一致しているか確認 |
 
 **すべて確認してから `[DONE]` を出力。**
 
@@ -106,8 +108,6 @@
 | ボーイスカウト | 触った箇所は少し改善して去る |
 | Fail Fast | エラーは早期に検出。握りつぶさない |
 
-**迷ったら**: Simple を選ぶ。
-
 ## 抽象化の原則
 
 **条件分岐を追加する前に考える:**
@@ -290,7 +290,7 @@ test('ユーザーが存在しない場合、NotFoundエラーを返す', async
 
 ## 禁止事項
 
-- **フォールバック値の乱用** - `?? 'unknown'`、`|| 'default'` で問題を隠さない
+- **フォールバックは原則禁止** - `?? 'unknown'`、`|| 'default'`、`try-catch` で握りつぶすフォールバックを書かない。エラーは上位に伝播させる。どうしても必要な場合はコメントで理由を明記する
 - **説明コメント** - コードで意図を表現する
 - **未使用コード** - 「念のため」のコードは書かない
 - **any型** - 型安全を破壊しない

package/resources/global/ja/agents/default/planner.md

@@ -33,7 +33,20 @@
 - 依存関係
 - テストへの影響
 
-### 3. 実装アプローチ
+### 3. 情報の裏取り（ファクトチェック）
+
+分析で使用する情報は必ずソース・オブ・トゥルースで裏取りする:
+
+| 情報の種類 | ソース・オブ・トゥルース |
+|-----------|----------------------|
+| コードの振る舞い | 実際のソースコード |
+| 設定値・名前 | 実際の設定ファイル・定義ファイル |
+| API・コマンド | 実際の実装コード |
+| ドキュメント記述 | 実際のコードベースと突合 |
+
+**推測で書かない。** 名前・値・振る舞いは必ずコードで確認する。
+
+### 4. 実装アプローチ
 
 実装の方向性を決める:
 

package/resources/global/ja/workflows/default.yaml

@@ -25,6 +25,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch
@@ -241,6 +242,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -439,11 +441,12 @@ steps:
         next_step: plan
 
   - name: ai_review
-    agent: ~/.takt/agents/default/ai-reviewer.md
+    agent: ~/.takt/agents/default/ai-antipattern-reviewer.md
     allowed_tools:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -616,6 +619,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -850,6 +854,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch

package/resources/global/ja/workflows/expert-cqrs.yaml

@@ -37,6 +37,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch
@@ -203,6 +204,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -354,6 +356,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -495,6 +498,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -631,11 +635,12 @@ steps:
   # Phase 4: AI Review
   # ===========================================
   - name: ai_review
-    agent: ~/.takt/agents/default/ai-reviewer.md
+    agent: ~/.takt/agents/default/ai-antipattern-reviewer.md
     allowed_tools:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -771,6 +776,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -919,6 +925,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -1072,6 +1079,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |

package/resources/global/ja/workflows/expert.yaml

@@ -37,6 +37,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch
@@ -203,6 +204,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -354,6 +356,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -490,11 +493,12 @@ steps:
   # Phase 4: AI Review
   # ===========================================
   - name: ai_review
-    agent: ~/.takt/agents/default/ai-reviewer.md
+    agent: ~/.takt/agents/default/ai-antipattern-reviewer.md
     allowed_tools:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -630,6 +634,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -778,6 +783,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -931,6 +937,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |

package/resources/global/ja/workflows/simple.yaml

@@ -26,6 +26,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch
@@ -237,6 +238,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -342,11 +344,12 @@ steps:
         next_step: plan
 
   - name: ai_review
-    agent: ~/.takt/agents/default/ai-reviewer.md
+    agent: ~/.takt/agents/default/ai-antipattern-reviewer.md
     allowed_tools:
       - Read
       - Glob
       - Grep
+      - Write
       - WebSearch
       - WebFetch
     status_rules_prompt: |
@@ -451,6 +454,7 @@ steps:
       - Read
       - Glob
       - Grep
+      - Write
       - Bash
       - WebSearch
       - WebFetch

package/resources/project/dotgitignore

@@ -0,0 +1,10 @@
+# Temporary files
+logs/
+reports/
+completed/
+tasks/
+worktree-meta/
+clone-meta/
+worktree-sessions/
+agent_sessions.json
+input_history

package/resources/project/tasks/TASK-FORMAT

@@ -0,0 +1,37 @@
+TAKT Task File Format
+=====================
+
+Tasks placed in this directory (.takt/tasks/) will be processed by TAKT.
+
+## YAML Format (Recommended)
+
+  # .takt/tasks/my-task.yaml
+  task: "Task description"
+  worktree: true                  # (optional) true | "/path/to/dir"
+  branch: "feat/my-feature"      # (optional) branch name
+  workflow: "default"             # (optional) workflow name
+
+Fields:
+  task      (required)  Task description (string)
+  worktree  (optional)  true: create shared clone, "/path": clone at path
+  branch    (optional)  Branch name (auto-generated if omitted: takt/{timestamp}-{slug})
+  workflow  (optional)  Workflow name (uses current workflow if omitted)
+
+## Markdown Format (Simple)
+
+  # .takt/tasks/my-task.md
+
+  Entire file content becomes the task description.
+  Supports multiline. No structured options available.
+
+## Supported Extensions
+
+  .yaml, .yml  ->  YAML format (parsed and validated)
+  .md          ->  Markdown format (plain text, backward compatible)
+
+## Commands
+
+  takt /add-task     Add a task interactively
+  takt /run-tasks    Run all pending tasks
+  takt /watch        Watch and auto-run tasks
+  takt /list-tasks   List task branches (merge/delete)