Merge pull request #771 from nrslib/release/v0.43.0

Release v0.43.0

Author: nrslib

CHANGELOG.md

@@ -6,6 +6,32 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.43.0] - 2026-05-29
+
+### Added
+
+- Image attachments (experimental, #751). Images can now flow through TAKT end to end. In interactive mode you can paste an image straight into the prompt — TAKT decodes terminal inline-image (OSC 1337) sequences into a pending attachment — and `takt add` plus retries carry image attachments with the task spec, so the agent receives the images alongside the text instruction. Works in assistant / passthrough / quiet / retry input modes, with a 10 MB per-image limit. Still under verification — behavior may change.
+- `takt resume` command for direct runs (#759). A direct (one-shot, non-queued) run that fails or aborts can now be resumed with `takt resume`, which finds the latest failed/aborted direct run and continues it instead of starting over. Resume reuses the existing run directory, and a dedicated scoring prompt decides how to re-enter the workflow.
+- Command quality gates (#761). Step `quality_gates` now accept machine-executed `type: command` entries in addition to AI directive strings. A command gate runs after an agent step completes and passes only when the command exits with code `0`; on failure TAKT feeds the command metadata, cwd, exit code (or timeout / output-limit details), the output log path, and bounded sanitized stdout/stderr back into the same agent step for another attempt. Workflow-YAML command gates require `workflow_command_gates.custom_scripts: true` in config. `system` and `workflow_call` steps do not accept `quality_gates`.
+- `frontend-maintenance` builtin workflow (experimental). A workflow for modifying existing frontend products rather than greenfield builds, shipping maintenance-scoped plan / implement / write-tests / fix / supervise instructions, an `existing-system` knowledge facet, an `existing-system-respect` policy that enforces respecting current conventions, and a `maintenance-scope` output contract. Experimental — it can currently be heavier-handed than intended, so treat it as a starting point for existing-product changes and tune to your codebase.
+- Coding review added to the default peer review. The builtin `default-peer-review` workflow now includes a coding-review sub-step backed by a new `coding-reviewer` persona, a `review-coding` instruction, and a `coding-review` output contract, so general code quality is reviewed alongside the existing specialist reviewers.
+
+### Changed
+
+- Review facets hardened against scope creep across the fix ↔ review loop (en + ja). The review baseline is now anchored to the task's base — every reviewer evaluates the entire cumulative diff from the merge-base, not just the increment from the most recent iteration. This stops unrequested changes that slipped in during earlier iterations (unrelated comment deletions, renames, reformatting, weakened tests) from being missed once the diff narrows to the latest fix. The `ai-antipattern` scope-creep check was made cumulative-diff based, and review and React facet guidance was refined alongside.
+
+### Fixed
+
+- `claude-terminal` prompt detection now works with Claude Code v2.1 (#766, refs #765). The tail-line regex required the prompt row to be exactly `❯` / `❱` / `>`, but v2.1 renders it as `❯ Try "..."`, so `waitForClaudeInputReady` never matched and timed out after 60 s. The pattern was relaxed to accept any prompt character followed by whitespace or end-of-line, while the busy-state gate still prevents false positives.
+- Codex `Reconnecting...` is no longer treated as a fatal error (#767). A transient `Reconnecting... N/5` event from the Codex SDK was surfaced as a final `provider_error` and aborted the whole workflow; it is now handled as a recoverable reconnect and retried.
+- `team_leader` part timeouts no longer abort the run (#764). When a worker part hit `part_timeout` or a feedback failure, `TeamLeaderRunner` aborted immediately; a timeout fallback now keeps the run going, and the decomposition instructions and facets were tuned so the leader is less likely to create one oversized part.
+- Parallel review aggregation no longer fails the whole step when a single reviewer errors (#770). A `provider_error` in one reviewer's Phase 1 during a parallel `reviewers` step previously broke aggregation even when the other reviewers completed; `ParallelRunner` terminal-status handling was fixed so the step aggregates correctly.
+- `review-fix-takt-default` now routes supervisor findings correctly. Findings raised by the review-fix supervisor were not routed back into the fix loop as intended; the workflow rules were corrected.
+
+### Internal
+
+- Added a three-phase step model tutorial to the docs (#735).
+
 ## [0.42.0] - 2026-05-20
 
 ### Added

docs/CHANGELOG.ja.md

@@ -6,6 +6,32 @@
 
 フォーマットは [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) に基づいています。
 
+## [0.43.0] - 2026-05-29
+
+### Added
+
+- 画像添付に対応（実験的, #751）。画像を TAKT 全体で受け渡しできるようになった。対話モードではプロンプトに画像を直接ペーストでき（ターミナルのインライン画像 OSC 1337 シーケンスを保留中の添付としてデコードする）、`takt add` や再実行ではタスク仕様とともに画像添付が引き継がれ、エージェントはテキスト指示と一緒に画像を受け取る。assistant / passthrough / quiet / retry の各入力モードで動作し、1 画像あたり 10 MB の上限がある。動作確認中の実験的機能であり、挙動は変わる可能性がある
+- ダイレクト run 向けの `takt resume` コマンドを追加 (#759)。失敗・中断したダイレクト（ワンショット・キュー外）run を `takt resume` で再開できるようになった。直近の失敗 / 中断したダイレクト run を探して、最初からやり直すのではなく続きから再開する。再開時は既存の run ディレクトリを再利用し、専用のスコアリングプロンプトがワークフローへの再入方法を判断する
+- コマンド品質ゲートを追加 (#761)。ステップの `quality_gates` が、AI 指示の文字列に加えて、機械実行される `type: command` エントリを受け付けるようになった。コマンドゲートはエージェントステップ完了後に実行され、コマンドが終了コード `0` で終わった場合のみ通過する。失敗時は、コマンドのメタデータ・cwd・終了コード（またはタイムアウト / 出力上限の詳細）・出力ログのパス・上限付きでサニタイズした stdout/stderr を同じエージェントステップに差し戻して再試行させる。ワークフロー YAML のコマンドゲートを使うには設定で `workflow_command_gates.custom_scripts: true` が必要。`system` / `workflow_call` ステップは `quality_gates` を受け付けない
+- ビルトインワークフロー `frontend-maintenance` を追加（実験的）。新規構築ではなく既存フロントエンドプロダクトの改修に向けたワークフローで、保守スコープの plan / implement / write-tests / fix / supervise インストラクション、`existing-system` ナレッジファセット、既存の規約を尊重させる `existing-system-respect` ポリシー、`maintenance-scope` 出力契約を同梱する。現状はやや過剰に動くことがあるため、既存プロダクト改修の出発点として使い、コードベースに合わせて調整することを推奨する実験的ワークフロー
+- デフォルトのピアレビューに coding review を追加。ビルトインの `default-peer-review` ワークフローに、新しい `coding-reviewer` ペルソナ・`review-coding` インストラクション・`coding-review` 出力契約に基づく coding-review サブステップが加わり、既存の専門レビューワと並んで一般的なコード品質もレビューされるようになった
+
+### Changed
+
+- レビュー系ファセットを fix ↔ review ループでのスコープクリープに強くした（en + ja）。レビューの基準点をタスクのベースに固定し、各レビューワは直前イテレーションの増分ではなく merge-base からの累積差分全体を評価するようにした。これにより、過去のイテレーションで紛れ込んだ要求外の変更（無関係なコメント削除・リネーム・再フォーマット・テストの弱体化など）が、差分が直近の fix に狭まったときに見逃される問題を防ぐ。`ai-antipattern` のスコープクリープ検証を累積差分ベースに変更し、あわせて review と React のファセットガイダンスを精緻化した
+
+### Fixed
+
+- `claude-terminal` のプロンプト検出が Claude Code v2.1 で動作するようにした (#766, refs #765)。末尾行の正規表現がプロンプト行を厳密に `❯` / `❱` / `>` と一致させる必要があったが、v2.1 は `❯ Try "..."` のように描画するため `waitForClaudeInputReady` が一致せず 60 秒でタイムアウトしていた。プロンプト文字の後に空白または行末が続くものを受け付けるようパターンを緩和しつつ、busy 状態のゲートで誤検知を防いでいる
+- Codex の `Reconnecting...` を致命的エラーとして扱わないようにした (#767)。Codex SDK の一時的な `Reconnecting... N/5` イベントが最終的な `provider_error` として表面化し、ワークフロー全体を abort させていたが、回復可能な再接続として扱い retry するようにした
+- `team_leader` の part タイムアウトで run が abort しないようにした (#764)。worker part が `part_timeout` や feedback failure に達すると `TeamLeaderRunner` が即座に abort していたが、タイムアウト fallback で run を継続させ、さらに leader が巨大な単一 part を作りにくくなるよう分解インストラクションとファセットを調整した
+- 並列レビューの集約が、1 つのレビューワのエラーでステップ全体を失敗させないようにした (#770)。並列 `reviewers` ステップで 1 レビューワの Phase 1 が `provider_error` になると、他のレビューワが完了していても集約が壊れていたが、`ParallelRunner` の terminal-status 処理を修正して正しく集約するようにした
+- `review-fix-takt-default` がスーパーバイザの findings を正しくルーティングするようにした。review-fix スーパーバイザが挙げた findings が意図通りに fix ループへ戻されていなかったため、ワークフローのルールを修正した
+
+### Internal
+
+- 三段階ステップモデルのチュートリアルをドキュメントに追加 (#735)
+
 ## [0.42.0] - 2026-05-20
 
 ### Added

docs/builtin-catalog.ja.md

@@ -32,6 +32,7 @@ TAKT に同梱されているすべてのビルトイン workflow と persona 
 | | `dual-mini` | ミニデュアル workflow: plan -> implement -> 並列レビュー (AI antipattern + expert supervisor)。フロントエンド＋バックエンドナレッジ注入付き。 |
 | | `dual-cqrs-mini` | ミニ CQRS+ES デュアル workflow: plan -> implement -> 並列レビュー (AI antipattern + expert supervisor)。CQRS+ES ナレッジ注入付き。 |
 | 🎨 フロントエンド | `frontend` | フロントエンド特化開発 workflow。React/Next.js に焦点を当てたレビューとナレッジ注入付き。 |
+| | `frontend-maintenance` | （実験的）既存プロダクト改修向けのフロントエンド workflow。現行の規約を尊重し変更をスコープ内に収める、保守スコープの plan/implement/test/fix/supervise。現状はやや過剰に動くことがあるため、出発点として使い調整する。 |
 | ⚙️ バックエンド | `backend` | バックエンド特化開発 workflow。バックエンド、セキュリティ、QA エキスパートレビュー付き。 |
 | | `backend-cqrs` | CQRS+ES 特化バックエンド開発 workflow。CQRS+ES、セキュリティ、QA エキスパートレビュー付き。 |
 | 🔧 デュアル | `dual` | フロントエンド＋バックエンド開発 workflow: architecture、frontend、security、QA レビューと修正ループ付き。 |

docs/builtin-catalog.md

@@ -32,6 +32,7 @@ Organized by category.
 | | `dual-mini` | Mini dual workflow: plan -> implement -> parallel review (AI antipattern + expert supervisor) with frontend + backend knowledge injection. |
 | | `dual-cqrs-mini` | Mini CQRS+ES dual workflow: plan -> implement -> parallel review (AI antipattern + expert supervisor) with CQRS+ES knowledge injection. |
 | 🎨 Frontend | `frontend` | Frontend-specialized development workflow with React/Next.js focused reviews and knowledge injection. |
+| | `frontend-maintenance` | (Experimental) Frontend workflow for modifying existing products: maintenance-scoped plan/implement/test/fix/supervise that respects current conventions and keeps changes within scope. Can be heavy-handed today — use as a starting point and tune. |
 | ⚙️ Backend | `backend` | Backend-specialized development workflow with backend, security, and QA expert reviews. |
 | | `backend-cqrs` | CQRS+ES-specialized backend development workflow with CQRS+ES, security, and QA expert reviews. |
 | 🔧 Dual | `dual` | Frontend + backend development workflow: architecture, frontend, security, QA reviews with fix loops. |

docs/cli-reference.ja.md

@@ -265,6 +265,14 @@ takt workflow doctor sample-flow
 takt workflow doctor .takt/workflows/sample-flow.yaml
 ```
 
+### takt resume
+
+直近の失敗・中断したダイレクト（ワンショット）run を再開します。完了しなかった最新のダイレクト run を探し、最初からやり直すのではなく既存の run ディレクトリを再利用して止まったところから続行します。
+
+```bash
+takt resume
+```
+
 ### takt clear
 
 エージェントの会話セッションをクリア（状態のリセット）します。

docs/cli-reference.md

@@ -265,6 +265,14 @@ takt workflow doctor sample-flow
 takt workflow doctor .takt/workflows/sample-flow.yaml
 ```
 
+### takt resume
+
+Resume the latest failed or aborted direct (one-shot) run. Finds the most recent direct run that did not complete and continues it from where it stopped, reusing the existing run directory instead of starting over.
+
+```bash
+takt resume
+```
+
 ### takt clear
 
 Clear agent conversation sessions (reset state).

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "takt",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "description": "TAKT: TAKT Agent Koordination Topology - AI Agent Workflow Orchestration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",