takt 0.15.0 → 0.16.0

package/README.md

@@ -366,7 +366,7 @@ movements:
     policy: coding
     knowledge: architecture
     edit: true
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Implementation complete
         next: review
@@ -590,6 +590,16 @@ interactive_preview_movements: 3  # Movement previews in interactive mode (0-10,
 #   coder: codex             # Run coder on Codex
 #   ai-antipattern-reviewer: claude  # Keep reviewers on Claude
 
+# Provider-specific permission profiles (optional)
+# Priority: project override → global override → project default → global default → required_permission_mode (floor)
+# provider_profiles:
+#   codex:
+#     default_permission_mode: full
+#     movement_permission_overrides:
+#       ai_review: readonly
+#   claude:
+#     default_permission_mode: edit
+
 # API Key configuration (optional)
 # Can be overridden by environment variables TAKT_ANTHROPIC_API_KEY / TAKT_OPENAI_API_KEY / TAKT_OPENCODE_API_KEY
 anthropic_api_key: sk-ant-...  # For Claude (Anthropic)
@@ -739,7 +749,7 @@ movements:
   - name: implement
     persona: coder
     edit: true
-    permission_mode: edit
+    required_permission_mode: edit
     pass_previous_response: true
     rules:
       - condition: Complete
@@ -808,7 +818,7 @@ Special `next` values: `COMPLETE` (success), `ABORT` (failure)
 | `allowed_tools` | - | List of tools agent can use (Read, Glob, Grep, Edit, Write, Bash, etc.) |
 | `provider` | - | Override provider for this movement (`claude`, `codex`, or `opencode`) |
 | `model` | - | Override model for this movement |
-| `permission_mode` | - | Permission mode: `readonly`, `edit`, `full` (provider-independent) |
+| `required_permission_mode` | - | Required minimum permission mode: `readonly`, `edit`, `full` (acts as floor; actual mode resolved via `provider_profiles`) |
 | `provider_options` | - | Provider-specific options (e.g. `codex.network_access`, `opencode.network_access`) |
 | `output_contracts` | - | Output contract definitions for report files |
 | `quality_gates` | - | AI directives for movement completion requirements |

package/builtins/en/config.yaml

@@ -1,91 +1,92 @@
-# TAKT Global Configuration
+# TAKT global configuration sample
 # Location: ~/.takt/config.yaml
 
-# ── Basic ──
-
-# Language (en | ja)
+# ---- Core ----
 language: en
-
-# Default piece when no piece is specified
 default_piece: default
-
-# Log level (debug | info | warn | error)
 log_level: info
 
-# ── Provider & Model ──
-
-# Provider runtime (claude | codex)
+# ---- Provider ----
+# provider: claude | codex | opencode | mock
 provider: claude
 
-# Default model (optional)
-# Claude: opus, sonnet, haiku
-# Codex: gpt-5.2-codex, gpt-5.1-codex, etc.
+# Model (optional)
+# Claude examples: opus, sonnet, haiku
+# Codex examples: gpt-5.2-codex, gpt-5.1-codex
+# OpenCode format: provider/model
 # model: sonnet
 
-# Per-persona provider override (optional)
-# Override provider for specific personas. Others use the global provider.
+# Per-persona provider override
 # persona_providers:
 #   coder: codex
-
-# ── API Keys ──
-# Optional. Environment variables take priority:
-#   TAKT_ANTHROPIC_API_KEY, TAKT_OPENAI_API_KEY
-
+#   reviewer: claude
+
+# Provider-specific movement permission policy
+# Priority:
+# 1) project provider_profiles override
+# 2) global provider_profiles override
+# 3) project provider_profiles default
+# 4) global provider_profiles default
+# 5) movement.required_permission_mode (minimum floor)
+# provider_profiles:
+#   codex:
+#     default_permission_mode: full
+#     movement_permission_overrides:
+#       ai_review: readonly
+#   claude:
+#     default_permission_mode: edit
+
+# Provider-specific runtime options
+# provider_options:
+#   codex:
+#     network_access: true
+#   claude:
+#     sandbox:
+#       allow_unsandboxed_commands: true
+
+# ---- API Keys ----
+# Environment variables take priority:
+# TAKT_ANTHROPIC_API_KEY / TAKT_OPENAI_API_KEY / TAKT_OPENCODE_API_KEY
 # anthropic_api_key: ""
 # openai_api_key: ""
+# opencode_api_key: ""
 
-# ── Execution ──
-
-# Worktree (shared clone) directory (default: ../{clone-name} relative to project)
-# worktree_dir: ~/takt-worktrees
-
-# Auto-create PR after worktree execution (default: prompt in interactive mode)
-# auto_pr: false
-
-# Prevent macOS idle sleep during execution using caffeinate (default: false)
-# prevent_sleep: false
-
-# Runtime environment defaults (applies to all pieces unless piece_config.runtime overrides)
+# ---- Runtime ----
+# Global runtime preparation (piece_config.runtime overrides this)
 # runtime:
 #   prepare:
 #     - gradle
 #     - node
 
-# ── Parallel Execution (takt run) ──
+# ---- Execution ----
+# worktree_dir: ~/takt-worktrees
+# auto_pr: false
+# prevent_sleep: false
 
-# Number of tasks to run concurrently (1 = sequential, max: 10)
+# ---- Run Loop ----
 # concurrency: 1
-
-# Polling interval in ms for picking up new tasks (100-5000, default: 500)
 # task_poll_interval_ms: 500
-
-# ── Interactive Mode ──
-
-# Number of movement previews shown in interactive mode (0 to disable, max: 10)
 # interactive_preview_movements: 3
-
-# Branch name generation strategy (romaji: fast default | ai: slow)
 # branch_name_strategy: romaji
 
-# ── Output ──
-
-# Notification sounds (default: true)
-# notification_sound: true
-
-# Minimal output for CI - suppress AI output (default: false)
+# ---- Output ----
 # minimal_output: false
-
-# ── Builtin Pieces ──
-
-# Enable builtin pieces (default: true)
+# notification_sound: true
+# notification_sound_events:
+#   iteration_limit: true
+#   piece_complete: true
+#   piece_abort: true
+#   run_complete: true
+#   run_abort: true
+# observability:
+#   provider_events: true
+
+# ---- Builtins ----
 # enable_builtin_pieces: true
-
-# Exclude specific builtins from loading
 # disabled_builtins:
 #   - magi
 
-# ── Pipeline Mode (--pipeline) ──
-
+# ---- Pipeline ----
 # pipeline:
 #   default_branch_prefix: "takt/"
 #   commit_message_template: "feat: {title} (#{issue})"
@@ -94,14 +95,11 @@ provider: claude
 #     {issue_body}
 #     Closes #{issue}
 
-# ── Preferences ──
-
-# Custom paths for preference files
+# ---- Preferences ----
 # bookmarks_file: ~/.takt/preferences/bookmarks.yaml
 # piece_categories_file: ~/.takt/preferences/piece-categories.yaml
 
-# ── Debug ──
-
+# ---- Debug ----
 # debug:
 #   enabled: false
 #   log_file: ~/.takt/logs/debug.log

package/builtins/en/pieces/backend-cqrs.yaml

@@ -219,7 +219,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Fix complete
         next: reviewers

package/builtins/en/pieces/backend.yaml

@@ -216,7 +216,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Fix complete
         next: reviewers

package/builtins/en/pieces/coding.yaml

@@ -51,7 +51,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Implementation complete
         next: reviewers
@@ -132,7 +132,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Fix complete
         next: reviewers

package/builtins/en/pieces/default.yaml

@@ -82,7 +82,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Implementation complete
         next: ai_review
@@ -142,7 +142,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: AI issues fixed
         next: ai_review
@@ -234,7 +234,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Fix complete
         next: reviewers

package/builtins/en/pieces/e2e-test.yaml

@@ -85,7 +85,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Test implementation complete
         next: ai_review
@@ -145,7 +145,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: AI issues fixed
         next: ai_review
@@ -212,7 +212,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Fix complete
         next: review_test

package/builtins/en/pieces/expert-cqrs.yaml

@@ -254,7 +254,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Fix complete
         next: reviewers

package/builtins/en/pieces/expert.yaml

@@ -251,7 +251,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Fix complete
         next: reviewers

package/builtins/en/pieces/frontend.yaml

@@ -235,7 +235,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Fix complete
         next: reviewers

package/builtins/en/pieces/minimal.yaml

@@ -25,7 +25,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     instruction: implement
     rules:
       - condition: Implementation complete
@@ -106,7 +106,7 @@ movements:
           - Bash
           - WebSearch
           - WebFetch
-        permission_mode: edit
+        required_permission_mode: edit
         rules:
           - condition: AI Reviewer's issues fixed
           - condition: No fix needed (verified target files/spec)
@@ -126,7 +126,7 @@ movements:
           - Bash
           - WebSearch
           - WebFetch
-        permission_mode: edit
+        required_permission_mode: edit
         rules:
           - condition: Supervisor's issues fixed
           - condition: Cannot proceed, insufficient info
@@ -151,7 +151,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: AI Reviewer's issues fixed
         next: reviewers
@@ -175,7 +175,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Supervisor's issues fixed
         next: reviewers

package/builtins/en/pieces/passthrough.yaml

@@ -25,7 +25,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Task complete
         next: COMPLETE

package/builtins/en/pieces/review-fix-minimal.yaml

@@ -25,7 +25,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     instruction: implement
     rules:
       - condition: Implementation complete
@@ -106,7 +106,7 @@ movements:
           - Bash
           - WebSearch
           - WebFetch
-        permission_mode: edit
+        required_permission_mode: edit
         rules:
           - condition: AI Reviewer's issues fixed
           - condition: No fix needed (verified target files/spec)
@@ -126,7 +126,7 @@ movements:
           - Bash
           - WebSearch
           - WebFetch
-        permission_mode: edit
+        required_permission_mode: edit
         rules:
           - condition: Supervisor's issues fixed
           - condition: Cannot proceed, insufficient info
@@ -151,7 +151,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: AI Reviewer's issues fixed
         next: reviewers
@@ -175,7 +175,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Supervisor's issues fixed
         next: reviewers

package/builtins/en/pieces/structural-reform.yaml

@@ -226,7 +226,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     instruction: implement
     rules:
       - condition: Implementation complete
@@ -309,7 +309,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Fix complete
         next: reviewers

package/builtins/en/pieces/unit-test.yaml

@@ -85,7 +85,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Test implementation complete
         next: ai_review
@@ -145,7 +145,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: AI issues fixed
         next: ai_review
@@ -212,7 +212,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: Fix complete
         next: review_test

package/builtins/ja/config.yaml

@@ -1,91 +1,92 @@
-# TAKT グローバル設定
+# TAKT グローバル設定サンプル
 # 配置場所: ~/.takt/config.yaml
 
-# ── 基本設定 ──
-
-# 言語 (en | ja)
+# ---- 基本 ----
 language: ja
-
-# デフォルトピース（指定なし時に使用）
 default_piece: default
-
-# ログレベル (debug | info | warn | error)
 log_level: info
 
-# ── プロバイダー & モデル ──
-
-# プロバイダー (claude | codex)
+# ---- プロバイダー ----
+# provider: claude | codex | opencode | mock
 provider: claude
 
-# デフォルトモデル（オプション）
-# Claude: opus, sonnet, haiku
-# Codex: gpt-5.2-codex, gpt-5.1-codex など
+# モデル（任意）
+# Claude 例: opus, sonnet, haiku
+# Codex 例: gpt-5.2-codex, gpt-5.1-codex
+# OpenCode 形式: provider/model
 # model: sonnet
 
-# ペルソナ単位のプロバイダー上書き（オプション）
-# 特定ペルソナだけプロバイダーを変更。未指定のペルソナはグローバル設定を使用。
+# ペルソナ別プロバイダー上書き
 # persona_providers:
 #   coder: codex
-
-# ── APIキー ──
-# オプション。環境変数が優先:
-#   TAKT_ANTHROPIC_API_KEY, TAKT_OPENAI_API_KEY
-
+#   reviewer: claude
+
+# プロバイダー別 movement 権限ポリシー
+# 優先順:
+# 1) project provider_profiles override
+# 2) global provider_profiles override
+# 3) project provider_profiles default
+# 4) global provider_profiles default
+# 5) movement.required_permission_mode（下限補正）
+# provider_profiles:
+#   codex:
+#     default_permission_mode: full
+#     movement_permission_overrides:
+#       ai_review: readonly
+#   claude:
+#     default_permission_mode: edit
+
+# プロバイダー別ランタイムオプション
+# provider_options:
+#   codex:
+#     network_access: true
+#   claude:
+#     sandbox:
+#       allow_unsandboxed_commands: true
+
+# ---- API キー ----
+# 環境変数が優先:
+# TAKT_ANTHROPIC_API_KEY / TAKT_OPENAI_API_KEY / TAKT_OPENCODE_API_KEY
 # anthropic_api_key: ""
 # openai_api_key: ""
+# opencode_api_key: ""
 
-# ── 実行設定 ──
-
-# ワークツリー（shared clone）ディレクトリ（デフォルト: プロジェクトの ../{clone-name}）
-# worktree_dir: ~/takt-worktrees
-
-# ワークツリー実行後に自動PR作成（デフォルト: 対話モードで確認）
-# auto_pr: false
-
-# macOS のアイドルスリープを防止（デフォルト: false）
-# prevent_sleep: false
-
-# 実行時ランタイム環境のデフォルト（piece_config.runtime があればそちらを優先）
+# ---- ランタイム ----
+# グローバルなランタイム準備（piece_config.runtime があればそちらを優先）
 # runtime:
 #   prepare:
 #     - gradle
 #     - node
 
-# ── 並列実行 (takt run) ──
+# ---- 実行 ----
+# worktree_dir: ~/takt-worktrees
+# auto_pr: false
+# prevent_sleep: false
 
-# タスクの同時実行数（1 = 逐次実行、最大: 10）
+# ---- Run Loop ----
 # concurrency: 1
-
-# 新規タスクのポーリング間隔 ms（100-5000、デフォルト: 500）
 # task_poll_interval_ms: 500
-
-# ── 対話モード ──
-
-# ムーブメントプレビューの表示数（0 で無効、最大: 10）
 # interactive_preview_movements: 3
-
-# ブランチ名の生成方式（romaji: 高速デフォルト | ai: 低速）
 # branch_name_strategy: romaji
 
-# ── 出力 ──
-
-# 通知音（デフォルト: true）
-# notification_sound: true
-
-# CI 向け最小出力 - AI 出力を抑制（デフォルト: false）
+# ---- 出力 ----
 # minimal_output: false
-
-# ── ビルトインピース ──
-
-# ビルトインピースの有効化（デフォルト: true）
+# notification_sound: true
+# notification_sound_events:
+#   iteration_limit: true
+#   piece_complete: true
+#   piece_abort: true
+#   run_complete: true
+#   run_abort: true
+# observability:
+#   provider_events: true
+
+# ---- Builtins ----
 # enable_builtin_pieces: true
-
-# 特定のビルトインを除外
 # disabled_builtins:
 #   - magi
 
-# ── パイプラインモード (--pipeline) ──
-
+# ---- Pipeline ----
 # pipeline:
 #   default_branch_prefix: "takt/"
 #   commit_message_template: "feat: {title} (#{issue})"
@@ -94,14 +95,11 @@ provider: claude
 #     {issue_body}
 #     Closes #{issue}
 
-# ── プリファレンス ──
-
-# プリファレンスファイルのカスタムパス
+# ---- Preferences ----
 # bookmarks_file: ~/.takt/preferences/bookmarks.yaml
 # piece_categories_file: ~/.takt/preferences/piece-categories.yaml
 
-# ── デバッグ ──
-
+# ---- Debug ----
 # debug:
 #   enabled: false
 #   log_file: ~/.takt/logs/debug.log

package/builtins/ja/pieces/backend-cqrs.yaml

@@ -219,7 +219,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: 修正が完了した
         next: reviewers

package/builtins/ja/pieces/backend.yaml

@@ -216,7 +216,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: 修正が完了した
         next: reviewers

package/builtins/ja/pieces/coding.yaml

@@ -51,7 +51,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: 実装完了
         next: reviewers
@@ -132,7 +132,7 @@ movements:
       - Bash
       - WebSearch
       - WebFetch
-    permission_mode: edit
+    required_permission_mode: edit
     rules:
       - condition: 修正完了
         next: reviewers