CHANGELOG.ja.md

Changelog

English

このファイルは、Traceary の各リリースで何が入ったかを時系列で追いやすくするための changelog です。
release note と同じ粒度で、版ごとの要点だけをまとめています。

[v0.33.1] - 2026-07-31

Fixed

• フック配信 ID と one-shot ライフサイクル契約 (#1576, #1582) — フック配信 ID が長さプレフィックス付きの ID フィールドを使用するようになり、区切り文字を含む構成要素同士の衝突を防止します。traceary session run はキャンセルまたはタイムアウトとの競合時にも識別可能な子プロセス所有の終了結果を保持し、ラッパーが終了処理を所有している間はネストした session-end フックを無視します。終了理由、終了コード、ライフサイクル所有権、修復手順、レポートのリネージも文書化しました。
• 使用量エビデンスの排他性 (#1580, #1581) — Codex rollout の探索がファイル名境界を必須とし、競合するセッションメタデータを拒否し、複数候補が一致した場合は fail closed するようになりました。bundle import は加算型の排他性 claim を保持し、競合をスキップするのは skip ポリシーの場合だけに限定します。不正な排他性メタデータを拒否し、それ以外の競合を ErrConflictingUsageObservation として報告します。
• 境界付きでプラットフォーム安全な Kimi capture (#1577, #1579) — Kimi 使用量の読み込みに、内容を露出せずにサイズ超過の source と行を拒否する回帰テストを追加しました。ファイルシステムベースの source は Unix プラットフォームを明示的なサポート対象とし、未対応プラットフォームでは使用量 sample を捏造せず fail closed します。
• 利用不能な使用量の明示的なレポート (#1578) — 使用量レポートが JSON、MCP schema、text output に unavailable_observations を公開し、counter がすべて利用不能な observation と、accounting rule によって除外された既知の代替 evidence を区別するようになりました。

Notes

• このパッチは、フック配信 ID、one-shot の終了動作、使用量 source の排他性と境界、プラットフォーム処理、レポートのリネージ、利用不能 observation の分類を強化します。ネットワーク傍受、billing dashboard のスクレイピング、prompt/response body の保存は有効化せず、privacy boundary は変更しません。
• リリース成果物と Homebrew Formula の checksum は、tagged release workflow だけが生成して commit します。この準備変更では、それらを予測または手書きしません。candidate verification boundary については docs/release/v0.33.1-qa.ja.md を参照してください。

[v0.33.0] - 2026-07-31

Added

• スケーラブルな metadata retrieval (#1553, #1569) — list/context query は、正規化timestampとcovering access pathを持つtrigger-maintainedな永続event metadata projectionを使います。additive migrationは既存rowをbackfillし、pre-projection writer互換を保ち、大きなevent bodyのoverflow pageをmetadata readから隔離します。
• 上限付きhistory searchとMCP retrieval (#1551, #1552, #1554) — full-text search、list、context、MCP event pageは、上限付きprojection、keyset continuation、明示的なresponse budget、truncation metadataを使い、上限なしのevent bodyをmaterializeしません。
• token効率のよいhost guidance (#1555, #1557) — package済みskillはDiscovery → Inspection → Detailの段階的retrievalを強制し、MCP schema sizeを対応host全体でbudget化してregression testします。

Fixed

• read-onlyなgarbage-collection preview (#1571) — traceary store gc --dry-runはstoreをinitialize、migrate、delete、update、vacuumしません。read-only SQLite connection上のcount-only queryを使い、event、session、memory、memory edgeに対するapply順序のsemanticsを保持します。未作成または未migrationのstoreに対するpreviewはstoreを作成・migrationせず失敗するため、先にtraceary store initを明示実行してください。
• memory hygieneの安全性とcost上限 (#1556) — scanとsimilarity workはresume可能かつboundedです。applyはexpire/reject/supersedeの前に要求IDと関連candidateだけを再検証し、stale evidenceではfail closedします。
• hookとhost packageの正確性 (#1526, #1574, #1575) — command-auditのpolicy denialを明示分類し、post-upgrade verifierがcanonical Grok inventoryを受理し、Codex rollout session IDをglobではなくliteralとして扱います。
• multi-GiB release evidence (#1558) — privateなsynthetic 2 GiB fixtureでprojection-only metadata path、copy上のmigration 31–34、FTS progress、MCP aggregation、bounded huge-body retrievalを検証します。公開artifactはmetricsだけを含み、固定250 ms gateに対するPhase-A p95 0.079708 msを記録します。

Notes

• migration 31から34はadditiveかつmigration-safeです。既存event/session dataを削除せず、metadata access pathをbackfill・維持し、telemetryも有効化しません。
• bounded retrievalはcanonical body availabilityとtruncation semanticsを保持します。release evidenceにprompt、response、cursor、workspace、raw spool payloadを含めません。
• PR #1587（129fa58b）とPR #1589（bcda8f4a）で完了したlocal test隔離を含むrelease QAは、v0.33.0 release QAに記録しています。
• install済みhost packageは現在のTraceary versionでrefreshしてください。traceary doctorはstale packageとrefresh済みpackageを区別します。

[v0.32.1] - 2026-07-25

Fixed

• 大容量 store の診断と確認 (#1539, #1542) — traceary doctor --json --warnings-ok は、regular store file が 2 GiB 以上の場合、SQLite を開かず event / payload data も読まない、完了済みの metadata-only diagnostic を返します。最新 event を body なしで確認する正確なコマンド traceary list --limit 1 --fields ts,kind --color never は、live store 全体の初期化や sort ではなく、index を使う read-only の bounded metadata query を使います。large-store doctor ガイド と large-store list ガイド を参照してください。
• Grok の local-repository plugin refresh (#1540) — Grok installer は canonical な traceary-grok package に収束します。legacy の local-repository identity は別に報告し、明示的かつ source-bounded な --migrate-local-repo-identity 指定時だけ migrate します。通常の refresh では削除しません。Grok plugin 更新ガイド を参照してください。
• upgrade 後の plugin readiness (#1523) — traceary doctor が対応する全 host package の installed version を検証し、pass、明示的な skip、stale package を区別します。日英の refresh guide には安全な activation と remediation 手順を追加しました。
• native Grok plugin の解決 (#1522) — Grok package の名前を traceary-grok に変更し、同名の Claude package を native integration と誤認しないようにしました。doctor は installed route と resolved route を別々に報告し、legacy shadowing は fail closed します。
• Codex headless final-turn 診断 (#1519) — manifest だけから final-turn coverage を推測せず、本文なしの prompt 数と final turn 未観測数を doctor が報告します。
• Antigravity headless permission (#1521) — doctor が安全な scoped hook permission と plugin install を分け、duplicate/broad/interactive/unsandboxed grant を警告します。最小 permission set も文書化しました。
• partial usage 診断 (#1532) — Grok の decode failure では child exit status を変えずに冪等な unavailable evidence を残し、Codex は有効な partial counter を保持して -- を尊重し、Claude は保存済み usage に reportable timestamp を要求して黙って補完しません。

Notes

• この patch は diagnostic、host-plugin readiness、usage observation の分類を変更します。network interception、billing dashboard scraping、prompt/response body の保存は有効化しません。
• release artifact と Homebrew Formula の checksum は tagged release workflow が生成・commit するものです。この準備変更では推測や手書きをしません。candidate の検証境界は docs/release/v0.32.1-qa.ja.md を参照してください。
• 関連 PR の review では独立 external reviewer topology を利用できませんでした。各 merge 判断では maintainer が残リスクを明示的に了承しており、本 release note は topology が充足されたとは扱いません。

[v0.32.0] - 2026-07-24

Added

• Provider 非依存の usage accounting (#1456) — additive migration により、finalized/pending availability、call/run/session-snapshot scope、additive/latest-snapshot/excluded accounting、型付き token/cost dimension、不変の provider identity、snapshot supersede、source 間の排他 claim を追加しました。prompt/response は保存しません。
• 構造化 run lineage (#1453) — 不変の host/run identity に parent run、Traceary session、batch、ticket、repository、pull request、head SHA、packet hash/bytes、tool-output bytes を保持できます。cycle、競合 replay、存在しない parent は fail closed します。
• 検証済み multi-host usage adapter (#1451, #1447, #1455, #1450, #1452) — 本文なし terminal/local source から、Codex、Claude Code、Gemini CLI、Antigravity、Grok Build、Kimi Code を検証済み granularity で取得します。unavailable / partial source を推測 counter に変換せず明示します。
• Snapshot-consistent CLI/MCP usage report (#1449) — traceary report と MCP get_report は current finalized observation だけを集計し、unavailable dimension を保持し、provider-reported cost と estimated cost を分離し、run fact の重複を除外し、source ごとの complete/partial 範囲を返します。

Changed

• Versioned host-source / privacy contract (#1448) — provider が報告する local source、retry/stream boundary、additive と snapshot の意味、許可する metadata を host ごとに定義しました。network interception、billing dashboard scraping、本文を含む hook、token count 推測、default telemetry は対象外です。
• Release accounting QA (#1457) — 8 日間の complete report と隔離した headless probe により、focused completion をすべて分類し、Codex/Grok terminal counter を重複なしで照合し、private body を読まず unavailable/partial host path を記録しました。

Fixed

• Codex queued-capture 診断 (#1498) — doctor は committed usage と durable hook spool に安全に queue 済みの evidence を区別し、capture が存在しないという誤報を避けます。
• 上限付き current-first spool replay (#1504) — hook delivery は現在イベントを上限付きで公平な retry batch より先に処理します。並行 consumer は分離した inflight file を claim し、link payload を拒否し、stale claim を上限なしの起動処理なしで復旧します。
• Grok report timestamp (#1506) — headless usage に Unix epoch ではなく UTC の ingest time を割り当て、同じ provider identity の正確な replay は Traceary session をまたいでも冪等に保ちます。

Notes

• migration 000027 から 000030 は additive かつ rollback-compatible です。既存 event/session body を書き換えず、network telemetry を有効にしません。
• follow-up 修正後の既知 live Codex/Grok headless probe は availability 100% でした。upgrade 前の hook spool backlog は運用負債として監視し、v0.32 の上限付き current-first replay で drain します。
• release 全体の証跡と残る運用確認は docs/release/v0.32.0-qa.ja.md に記録しています。

[v0.31.0] - 2026-07-22

Added

• payload class 別 retention 契約 (#1446) — destructive executor より先に、版付き plan schema と日英の安全設計で、厳密な候補 identity、recovery 証拠、期限、確認、crash recovery、rollback を定義しました。
• 復元可能な raw-body retention (#1444) — 明示的な store retention plan|apply|restore で、event/session/source metadata を保持したまま、対象となる prompt、transcript、command-audit の body を prune できます。plan は厳密 identity と検証済み recovery archive を固定し、apply/restore は transaction、確認、冪等性、中断後再開を備えます。
• archive / SQLite backup の容量 retention (#1443) — 明示的な store retention files plan|apply で、期間・件数・割り当て byte 上限を class ごとに独立して適用します。executor は現在の store に一致する検証済み recovery floor を保護し、不完全な証拠を拒否し、inventory 全体を再検証し、root 内に閉じた lock/journal/ledger と race-safe tombstone を使います。

Changed

• 読み取り専用 retention readiness と release dogfood (#1445) — opt-in の doctor/status check が、plan を作成・適用せず body と archive/backup の容量を報告します。copied-store drill で誤 confirmation、exact apply、retry 収束、archive/backup restore、代表 metadata/full-body read、SQLite integrity を確認しました。
• read surface の body availability (#1444) — CLI/MCP projection は空 content を捏造せず、構造化 availability metadata で保持済み body と意図的に利用不可の body を区別します。

Fixed

• unsafe retention root の readiness (#1486) — doctor が descriptor に基づく apply_root の所有者・mode 証拠を報告し、group/other-writable、非所有、未対応、不明の root を警告します。exact apply は同じ fail-closed 判定を再利用し、手動実行のままです。

Notes

• migration 000026 は追加のみで rollback 互換です。通常の upgrade では body prune や file 削除を行いません。
• v0.31 の raw-body / file-capacity plan/apply/restore は明示的・手動・opt-in であり、install、update、hook、doctor、通常の read command はこれらの plan を適用しません。既存の automatic archive-before-GC は retention.mode=archive_then_gc による別の opt-in 機能で、既定値は disabled のままです。SQLite compaction も別操作のままです。
• MCP tool の追加はありません。release QA と recovery 証拠は docs/operations/retention-dogfood-v0.31.ja.md に記録しています。

[v0.30.0] - 2026-07-22

Added

• 上限を明示した本文なしのイベント参照 (#1439, #1428, #1433, #1459) — list/search の projection でイベント本文を読まずに、安定した field 選択、truncation metadata、構造化 handoff の command provenance を返せます。SQLite は本文を全件ロードして後で捨てず、要求された列だけを読みます。
• workspace attribution と delivery の診断 (#1431, #1435, #1429, #1465, #1467) — 加算的な provenance table で session の canonical workspace と event ごとの effective workspace を分離し、複数ホストからの同一 hook 再送を冪等化しました。履歴を削除せず、workspace conflict、exact redelivery、明示的な上限付き heuristic candidate を報告します。
• one-shot lifecycle の明示モデル (#1430, #1436, #1434, #1473) — session に runtime mode と terminal reason を記録します。traceary session run は success / failure / timeout / signal を一度だけ確定し、session repair-one-shot は stale な one-shot 行を dry-run 優先で修復します。並行 writer の検証も追加しました。
• CLI/MCP 共通の振り返り report (#1438) — MCP get_report と traceary report が complete/partial 集計 metadata、source ごとの観測件数・時刻範囲、明示的な result_cap truncation provenance を共有します。

Changed

• report の command・failure・interval semantics (#1440, #1432, #1438) — wrapper command と failure reason を一貫して正規化しました。日付のみの境界は明示 timezone と暦日を含む終了、RFC3339 の終了は従来どおり正確な排他境界を使い、全 report source で一つの request snapshot を共有します。
• read surface の文言と制御 (#1458) — --wide を誤った固定列数ではなく「従来のタブ区切り形式」と説明します。report の --page-size は内部 paging だけを制御し、部分集計には明示的な --result-cap が必要です。

Fixed

• Antigravity Stop の exact-redelivery replay (#1465) — copied-store dogfood で、Stop の再送が受理済み event 一件のままで、計測した exact duplicate rate が release 閾値を下回ることを確認しました。
• report page の無制限 allocation (#1479) — CLI と MCP は 100,000 を超える page size を report 実行前に拒否します。巨大整数でも slice allocation の panic ではなく通常の validation error を返します。

Notes

• v0.30.0 の SQLite migration は加算的で rollback 互換です。既存の session/event 行を書き換えたり削除したりしません。
• MCP は read-only の新規 get_report を含む 9 tool を公開します。
• release 全体 QA と修正済み follow-up は docs/release/v0.30.0-qa.ja.md に記録しています。

[v0.29.0] - 2026-07-20

Added

• Kimi Code を first-class サポート (#1393) — Kimi Code CLI（0.27.0 で live 検証）を Traceary のホストとしてネイティブ対応。integrations/kimi-plugin/ パッケージとして提供し、1 つの kimi.plugin.json manifest に 10 個の lifecycle hook rule、Traceary MCP server、3 つの共有 memory/session skill を宣言。scripts/install-kimi-plugin.sh でインストールし（公式の local install を再現: generation dir へのステージ、atomic な symlink 切替、enabled 状態を保持した installed.json 更新）、traceary doctor --client kimi で確認できます。
• Kimi hook contract と sanitize 済み fixture (#1394) — SessionStart/End、UserPromptSubmit、Pre/PostToolUse、PostToolUseFailure、Stop、SubagentStart/Stop、Notification、（auto trigger の）PreCompact/PostCompact の payload contract を live probe し、sanitize 済み fixture と fixture を検証する contract test としてコミット。
• Kimi の session / prompt / tool / transcript 記録 (#1396) — 非公開の traceary hook kimi アダプタが snake_case payload を共有 hook runtime に正規化（content block の prompt をテキスト化、tool_output を audit 出力へ、error{code,message,retryable} を message→code→unknown の fallback 付きの失敗シグナルへ）。assistant の transcript は session wire log（session_index.jsonl → agents/main/wire.jsonl の content.part think/text block）から best-effort で復元し、読み取りは symlink 解決後に Kimi home の sessions root 配下に限定。
• Kimi の compact / subagent ライフサイクル (#1397) — PreCompact/PostCompact の marker（trigger。summary 本文なし）と、Agent tool の PreToolUse（tool_call_id で相関）+ SubagentStop（latest-active-child fallback。Claude と同一 semantics）による subagent の親子紐付け。
• Kimi の doctor チェック (#1399) — traceary doctor --client kimi（opt-in）が CLI 検出、plugin の install/enable/version 一致、検証済み 10 ルールに対する hook coverage、MCP 登録（plugin 宣言または mcp.json）、skill 一覧を報告。probe エラーが private path を露出しないことも保証。
• 日英の Kimi ガイドと dogfood 証跡 (#1400) — install / coverage / トラブルシューティングのドキュメント、README の host テーブルへの行追加（Full capture tier）、および live dogfood（plugin 経由で session/prompt/audit/transcript/session end を記録し、live session から MCP 応答）。

Fixed

• Claude 版 session-history skill を共通文言に統一 (#1412) — 他の 5 ホストが 1 つの文言に揃う間に Claude 版が drift していました。共有 skill parity check の下、全 6 ホストのパッケージが byte 一致になりました。

Documentation

• README の host テーブルに欠けていた Grok 行を追加 (#1409) — 公開済みの host-coverage matrix と一致する内容で補完。
• host coverage matrix の status 意味を明文化 (#1410) — wired / available / unsupported を文書化（ホストの能力ではなく配線状態）、host-contract の語彙との関係も併記。
• Kimi install script の swap 経路テスト (#1411) — direct-copy からの移行、generation flip + prune、一時 link のクリーンアップを sandbox 化した振る舞いテストで固定。

Notes

• v0.29.0 に破壊的な SQLite migration はなく、MCP ツールの追加もありません。
• Kimi Code の hook は plugin manifest 経由でのみ配布されます。traceary hooks install --client kimi は意図的に fail-closed（~/.kimi-code/config.toml への TOML マージは行いません）で、traceary hooks print --client kimi が手動設定用の TOML rule を出力します。
• Kimi 公式 marketplace への提出はこのリリースのスコープ外です。

[v0.28.0] - 2026-07-17

Added

• Archive-before-GC dogfood 決定ログ (#1373) — multi-GB store の copy 演習（dry-run/apply/verify）、automatic mode は既定 disabled、#1386 フォローアップの扱いを記録。
• 手動 archive-before-GC (#1371) — traceary store archive create|verify|restore が GC 適格な cold 行を版付き package（gzip tar + manifest digest、任意で env 経由 passphrase）へ export し、完全性検証後に限り --delete-after-verify で厳密 identity 削除できます。restore は PK 冪等です。
• Grok marketplace 公開パッケージ (#1301) — marketplace catalog テンプレート + generator、clean-home install/update/uninstall smoke、二言語の投稿/導入 docs。ローカル install は決定的 fallback のまま。
• opt-in automatic archive-then-gc (#1372) — config.json の retention.mode=archive_then_gc（既定 disabled）が session start/end で opportunistic に archive+delete-after-verify を実行。DB 単位 lease、interval marker、passphrase は env 名のみ、doctor archive-retention で状態表示（秘密は出さない）。

Fixed

• opportunistic GC 下の stale-active-sessions backlog (#1363) — session GC が hook soft deadline と競合しないよう切り離し（30s timeout）、session end でも実行、interval を 1h に短縮、doctor --fix で session gc を適用可能に。
• バイナリ upgrade 後の host plugin version drift (#1361) — ホスト別 refresh ヒントの明確化、post-upgrade チェックリスト docs、Grok install path 検出、Antigravity dual-path で健全 path があるとき不完全 twin を soft-skip。

Changed

• store gc の古い extracted candidate を hard DELETE ではなく decay に変更 (#1368) — store gc --target memories（および all）は、14 日窓を超えた未レビューの extracted / extracted-hidden / compact-summary candidate を即削除しません。status=expired へ遷移し、keep-days の物理 GC まで restore 可能です。
• rejected メモリも store gc の keep-days 対象に (#1369) — store gc --target memories（および all）は status=rejected かつ --keep-days より古い行を expired/superseded と同様に物理削除します。accepted / candidate は対象外。dry-run の件数表示は従来どおりです。

Notes

• v0.28.0 に破壊的 SQLite migration はなく、新しい MCP tool もありません。
• automatic archive-then-gc は opt-in（retention.mode 既定 disabled）。
• Grok public marketplace 掲載は docs/integrations/grok-marketplace-submission.ja.md に従い release tag の SHA を pin して xai-org/plugin-marketplace へ PR する運用です（ローカル install は継続サポート）。

[v0.27.0] - 2026-07-17

Fixed

• hook spool replay (#1342, #1353, #1355) — timeout-kill された hook は durable spool record を残し、後続 hook と traceary doctor --fix が oldest-first の bounded batch で drain します。session start / subagent start/stop は既に記録済みの境界を success 扱いし、部分 commit 後の backlog を解消します。
• memory-extract queue drain (#1343) — 未処理 extraction job を session key に限らず relaunch し、総試行上限と terminal GC（retention 後）で収束します。
• stale managed hook generation (#1345) — doctor がインストール済み Traceary 管理 hook の timeout を現行 generation と比較し、doctor --fix で refresh できます（典型: Gemini timeout: 5000 vs パッケージ 10000）。

Changed

• hook soft deadline (#1344) — host 向け hook は既定 8s の soft deadline（パッケージ 10s budget 未満。TRACEARY_HOOK_SOFT_DEADLINE で上書き）。detached worker は signal のみ。doctor は ~1 GiB 超で store-size WARN。
• memory/bundle ファイル分割 (#1346) — lifecycle 作業前の 800 行目安に沿った behavior-preserving 分割。

Notes

• v0.27.0 に破壊的 SQLite migration はなく、新しい MCP tool もありません。
• v0.28.0 へ defer（#1341 で明示）: #1264 memory inbox decay/restore、#1309 archive-before-GC、#1301 Grok public marketplace。ローカル Grok インストールは matching release tag から継続サポート。

[v0.26.1] - 2026-07-16

Fixed

• dotenv の誤検出 — sensitive-path は先頭の . を要求（.env / .env.*）。bare な env や shell の “env vars” 定型句で list --sensitive が溢れない。
• replay timeline の肥大化 — HTML/Markdown replay の timeline activity は traceary timeline と同じ 72 rune 上限を使い、数 MB の prompt/transcript 本文を生埋め込みしない。

[v0.26.0] - 2026-07-16

Added

• sensitive-path audit 分類 (#1257) — command audit を dotenv / SSH / cloud credential / browser profile / 鍵材料の intent として分類します（secret redaction と host capture coverage とは別 claim）。traceary list --sensitive、show --json の command_audit.sensitive、doctor の sensitive-access-audit で表示し、blocking はしません。
• host 申告 session model (#1265) — additive な sessions.model に host が渡した opaque な model 文字列を保存します（Claude/Codex hook）。host が省略したら空。捏造しません。sessions JSON は model,omitempty。
• Markdown replay (#1262) — traceary replay --format markdown が GitHub 表示可能な digest を書き出します（本文は truncate + fence 安全化）。既定 HTML は変更なし。
• 期間指定 retrospective report (#1263) — traceary report が [from,to)（既定は直近7日）の sessions / capture coverage / failures / failure_loops / top_commands を集約します。成功時 exit code は 0。

Documentation

• OTel GenAI export 決定 (#1258) — conventions が experimental な間のネットワーク export は no-go。local-first 既定を維持（docs/research/otel-genai-export.ja.md）。
• 次ホスト評価 (#1256) — Copilot CLI を第一候補、opencode は二次ウォッチ。このリリースでは host package なし（docs/research/next-host-evaluation.ja.md）。

Notes

• v0.26.0 の SQLite migration は additive な sessions.model のみ。
• 新しい MCP tool なし。既定のネットワーク telemetry なし。

[v0.25.0] - 2026-07-16

Fixed

• 退役した integration command stub の削除 (#1266) — v0.20.x 以降に削除予定だった残骸 traceary integration subtree を取り除きました。unknown-command 挙動をテストと integrations verifier で固定します。

Changed

• doctor / hook_runtime のファイル分割 (#1259) — 巨大化した doctor.go / hook_runtime.go を既存責務に沿って分割し、意図的な挙動変更なしでホスト作業の変更増幅を抑えます。
• packaged hook script の single-source 化 (#1260) — 互換ラッパーの正本は scripts/hooks/*.sh（prompt / compact / Grok を含む）です。package membership を明示し、integrations sync-hooks でコピーを再生成、integrations verify がドリフトで失敗します。
• host coverage matrix の正本化 (#1261) — lifecycle × host マトリクスの機械可読正本は application/hostcoverage/matrix.json です。日英 docs 表を生成・検証し、doctor の host-capability メッセージと event-coverage enrichment 期待値も同じ embedded matrix を読みます。

Documentation

• Grok 0.2.101 再 probe (#1299, #1300) — live 再 probe でも standalone な PostToolUseFailure / PermissionDenied / SessionEnd は未発火で、subagent spawn は spawn_subagent tool のみ（SubagentStart / SubagentStop の parent/child hook 契約なし）。coverage は docs/hooks/host-contract.json と unavailable 設計メモに version 付きで残します。

Notes

• v0.25.0 に破壊的な SQLite migration はなく、新しい MCP tool もありません。
• 明示的に延期（#1312 に記録）: #1301 の public Grok marketplace 公開。ローカルソース導入は引き続き scripts/install-grok-plugin.sh + 対応タグでの traceary doctor --client grok をサポートします。
• memory inbox decay/restore (#1264) と archive-before-GC (#1309) はこのリリース対象外です（後続マイルストーンで追跡）。

[v0.24.0] - 2026-07-16

Fixed

• Antigravity の空 workspacePaths (#1308) — agy 1.1.x が untrusted / headless 実行などで workspacePaths: [] のまま hook を発行しても、hooks.json ディレクトリではなく host process の cwd 連鎖から project workspace を復元します。既定の workspace filter でも event が見えるようになります。doctor は ~/.gemini/config/plugins/traceary と ~/.gemini/antigravity-cli/plugins/traceary の両方で version / MCP 登録を検査します。
• Claude print mode の transcript (#1307) — claude -p の Stop は JSONL flush と競合し、transcript_path に assistant 行がまだ無いことがあります。Stop payload の last_assistant_message にフォールバックし、空の場合は成功 transcript を捏造しません。
• remember skill の candidate 契約 (#1288) — Claude / Codex / Gemini / Antigravity / Grok の traceary-memory-remember は manage_memory action=propose を使い、明示 remember を status=candidate（never auto-accepted）に揃えます。package 間コピーは同一で、accepted 矛盾が戻ると integrations verify が失敗します。

Added

• AI-safe sessions snapshot profile (#1245) — traceary sessions --snapshot --json --profile ai が agent resume 向けに bound した envelope（retrieval hint、件数 / hygiene、大きい body や candidate fact 配列なし）を返します。既定の operator snapshot JSON は変更しません。
• tool-aware audit compact summary (#1243) — list / snapshot の read 面で大きい Edit / Write / Read / shell audit body を path・size・hash・head/tail と traceary show hint の summary に投影します。永続化と traceary show はフル fidelity のままです。
• retry-loop doctor diagnostics (#1244) — traceary doctor が recent failed command audit を workspace / agent / command / error class（EISDIR、missing path、oversized file、sandbox bypass 等）でまとめ、sample event ID と preflight hint を出す読み取り専用 retry-loops check を追加しました。

Notes

• v0.24.0 に破壊的な SQLite migration はなく、新しい MCP tool もありません。
• 明示的に延期（#1310 に記録）: #1264 memory inbox decay/restore と #1309 archive-before-GC は High-risk の multi-PR トラックのままです（後続マイルストーン。v0.25.0 では未出荷）。archive/GC の自動実行は導入時も fail-closed / opt-in です。このタグでそれらの機能を出荷したとは扱わないでください。

[v0.23.0] - 2026-07-14

Added

• Grok Build 契約の検証 (#1273) — Grok Build 0.2.99 の実環境 payload を機密情報を除いて取得し、version 付き fixture で session、prompt、tool、Stop、compact の対応 field を固定しました。未観測の独立した失敗、session end、subagent の関係は推測せず、利用不可と明示します。
• Grok のネイティブ識別子と core runtime (#1274, #1275) — grok を Traceary の正式な host とし、session、prompt、tool audit、Stop のネイティブ hook entrypoint を追加しました。Stop の transcript 取得は host が渡す updates.jsonl を読み、Grok が hook 完了後に最終メッセージを追記する場合は durable な分離 retry job で再試行します。
• Grok compact lifecycle marker (#1276) — PreCompact と PostCompact は検証済みの source field から前後の phase marker を別々に記録します。source がない場合は unavailable として保存し、summary 本文や未検証の subagent 関係を生成しません。
• Grok ネイティブ plugin (#1277) — 検証済みの hook 7件、ローカル Traceary MCP server 1件、共通の memory/session skill 3件をリポジトリ内パッケージに同梱し、決定的な構造検証と隔離した install smoke test を追加しました。
• Grok doctor check (#1278) — traceary doctor --client grok が CLI、plugin の有効状態とバージョン一致、project hook の trust、導入済み hook の厳密な契約、MCP/skill の内容、直近 event coverage を確認します。Grok inspect から得た hook target path や transcript 本文は表示しません。

Documentation

• 導入・dogfood ガイド (#1279) — Grok Build のインストール、更新、trust、トラブルシュート、対応範囲、最小化した dogfood 証拠を英語・日本語で文書化しました。

Notes

• v0.23.0 に破壊的な SQLite migration はなく、新しい MCP tool もありません。Grok plugin は既存の Traceary MCP server を再利用します。Stop は turn 境界であり session end ではありません。Grok Build 0.2.99 は、文書化された SessionEnd、独立した失敗、policy gate 対象の subagent payload を検証時に実環境で発行しなかったため、このリリースでは対応を主張しません。今後の作業は #1299、#1300、#1301 で追跡します。

[v0.22.0] - 2026-07-14

Added

• Antigravity plugin の機能同等化 (#1249) — 配布する Antigravity plugin に hooks だけでなく Traceary MCP server と memory skills を同梱しました。doctor は MCP 登録と配布版・インストール版のバージョン一致を検証し、古い plugin が残る場合は再インストール手順を示します。
• 現行 Antigravity の capture coverage (#1250) — Antigravity hooks が現行 payload の prompt と transcript を関連付け、turn 全体の coverage を記録するようになりました。不完全な turn は無効化しつつ、旧形式の transcript data は保持します。doctor は transcript 本文を露出せず、件数を制限した metadata から coverage を報告します。
• Codex compact と subagent の境界 (#1251) — Codex plugin が PreCompact / PostCompact の境界 marker を捕捉し、subagent の stop event を親 session と関連付けます。対応する境界 semantics を docs と regression test で固定しました。
• Codex plugin hook の trust 診断 (#1252) — doctor は現行 Codex plugin hook 一式が完全に信頼されている場合だけ healthy と報告します。trust 状態が不完全または確認不能な場合は安全側に倒し、完全な信頼を確認するまで手動 fallback hook を保持します。
• activity-aware な session 自動 GC (#1253) — hook ingestion が開始時刻ではなく最新 activity に基づく、rate limit 付き stale-session cleanup を実行します。process 間 activity lease は atomic に公開され、自動的に期限切れとなり、同時実行中の session を cleanup race から保護します。
• hook write path の durable queue (#1269, #1270) — host の timeout kill で中断された hook event を durable spool に保持し、turn ごとの memory extraction を durable な非同期 queue で実行します。同期 capture path から timeout と extraction latency の影響を外しつつ、待機中の処理を失いません。
• Codex hook 重複登録の修復 (#1271) — doctor が Codex hook の重複登録を検出し、無関係な hook 設定を維持したまま lossless かつ atomic に修復できるようになりました。

Fixed

• Claude SessionEnd cancellation の reconciliation (#1254) — 解決済みの Claude hook cancellation marker を照合し、doctor が現在対応すべき SessionEnd failure だけを表示するようになりました。

Changed

• Gemini CLI の maintenance mode (#1255) — Gemini extension は既存 install 向けに維持しますが、Google による Antigravity CLI への移行後は maintenance-only とし、新規 install には Antigravity plugin を案内するよう docs を更新しました。

Notes

• 新しい MCP tool はありません。破壊的な data migration は追加しておらず、新しい queue と cleanup path が使う reliability state は追加のみで migration-safe です。

[v0.21.4] - 2026-06-20

Added

• Antigravity doctor の導入経路の明確化 (#1236) — traceary doctor --client antigravity は Antigravity hook の導入状態を、独立した経路として antigravity-hooks-workspace、antigravity-hooks-user、antigravity-cli-plugin、および集約サマリー antigravity-hooks で報告するようになりました。user-level または CLI plugin の経路が健全な場合、存在しない workspace .agents/hooks.json は warn ではなく skip になります。サポート対象のどの経路にも traceary グループがない場合だけ warning を出し、存在する経路の設定が Antigravity で読み込めないほど壊れている場合は failure として報告します。
• Antigravity の記録レベル status (#1235) — doctor に antigravity-capture-levels を追加しました。これは常に pass の status 専用 check で、start_supported、tool_audit_supported、final_turn_supported、final_turn_unavailable を区別して報告します。これにより agy --print の挙動が明確になります。print mode では session start と run_command audit は記録されますが、host がその mode で Stop / finalization hook を発行しないため、最終 transcript / turn 境界は記録できません。

Documentation

• Antigravity integration、lifecycle、hook README、hook contract docs に短い agy --print capture matrix を追加し、Antigravity が transcriptPath 付き Stop を発行した場合にのみ transcript を記録することを明確化しました。

このリリースには SQLite schema migration はなく、新しい MCP tool もありません。

[v0.21.3] - 2026-06-20

Added

• 履歴上の hook content の可逆的 dedupe (#1227) — traceary store dedupe content-events は履歴上の hook 由来 prompt/transcript の duplicate 行を監査し、--apply を付けると hard delete せず復元可能な archive へ隔離します。既定は何も変更しない dry-run です。--restore <run-id> は apply を取り消し（all-or-nothing で、既存 event id の上書きを拒否）、--client codex|all で agent スコープを指定し、--strict は時間差に関係なく完全一致 duplicate group をすべて報告し、--json はすべての mode で利用できます。duplicate の identity は content-event-reliability 診断と一致します（kind, client, agent, session_id, workspace, source_hook, trim 済み body）。write-side guard は trimming なしの exact body を使うため異なります。既定ではほぼ同時（診断と同様に連続レコードをペアで cluster する 10s の近接 window）の group のみが対象で、group ごとに残す canonical 行は Go 側で parse した最も早い RFC3339Nano の created_at（同値は event id で tie-break）です。malformed timestamp の group はスキップして報告し、command audit は対象外です。apply は transaction 安全かつ冪等で、隔離した行は events の外へ移動されるため通常の list、sessions --snapshot、doctor、context、MCP の read surface から消えます。additive な schema migration 000019 が event_content_dedupe_archive テーブルを追加し、既存の events 行を移動・削除・書き換えしません。通常の upgrade/migration は自動クリーンアップを行いません。content-event-reliability の doctor チェックは新しい dry-run コマンドを案内し、現在の write path が新規 duplicate をすでに抑止していることを明記します。設計メモと rollback 手順は docs/storage/README.ja.md を参照してください。

Documentation

• Antigravity headless agy --print の capture level (#1225) — headless な agy --print 実行では session start (PreInvocation) と run_command audit (PreToolUse + PostToolUse) のみが記録されることを明文化しました。print mode は Stop を発行しないため、最終 transcript / turn 境界は host が transcriptPath 付き Stop を発行する interactive 実行でのみ記録されます。これは想定どおりの capture level であり install 失敗ではありません — dogfooding (Traceary 0.21.2、agy 1.0.10) で確認済みです。英語/日本語の Antigravity 統合ドキュメントと host-coverage マトリクスにこれを正確に記載し、read 側の例を traceary list --agent antigravity に変更しました（hook event は client=hook, agent=antigravity で記録されるため --client antigravity では 0 件になります）。agy の起動や実 transcript の読み取りを行わずに print mode の capture level を固定する回帰テストを追加しました。

[v0.21.2] - 2026-06-20

Added

• stale な Gemini インポート由来の Antigravity CLI plugin の検出 (#1220) — traceary doctor --client antigravity に antigravity-cli-plugin check を追加しました。~/.gemini/antigravity-cli/plugins/traceary 配下の Antigravity CLI plugin 設定ファイル（plugin.json / hooks.json / hooks/hooks.json）のみを読み取り、サポート対象の Antigravity hook runtime へ移行した後も残った legacy な Gemini 形式の plugin ファイルを remediation 手順付きで警告します。サポート対象のトップレベル traceary hook group では pass し、CLI plugin ディレクトリが存在しない場合は skip するため、traceary hooks install --client antigravity ユーザーが失敗扱いになりません。
• docs — 英語 / 日本語の Antigravity integration docs に、stale な Gemini インポート由来の CLI plugin の移行手順を記載しました。

このリリースには SQLite schema migration はなく、新しい MCP tool もありません。

[v0.21.1] - 2026-06-20

Added

• Antigravity hook / plugin の正式サポート (#1213) — Antigravity を diagnostics 専用から実際の Traceary hook client に昇格しました。traceary hooks print/install --client antigravity が Antigravity の hook-group 形式の hooks.json（workspace の .agents/hooks.json または user-level の ~/.gemini/config/hooks.json）を生成・マージし、traceary 以外の hook group をすべて保持します。リポジトリには公式 Antigravity plugin スキーマに従う plugin.json と同じ traceary hook group を同梱した integrations/antigravity-plugin/ を追加しました。
• Antigravity イベントカバレッジ — PreToolUse / PostToolUse を stepIdx で対応付けて run_command の audit を記録し、PreInvocation で conversationId をキーにした冪等なセッション開始 / リフレッシュを行い、Stop でセッションを閉じずに turn transcript と turn boundary を記録します。
• Antigravity doctor check — traceary doctor --client antigravity が antigravity-capability（CLI / app-bundle 検出。credential 読み取りや browser 自動操作は行わない）と antigravity-config（解決された hooks.json に traceary group が登録されているか、未登録時は --upgrade を提示）を報告します。
• docs — integration / hooks / lifecycle / release の docs で Antigravity をサポート対象 host として記述し、PreToolUse / PostToolUse の対応付け、Stop の transcript / turn boundary、公開 hook surface の制約を説明しました。

このリリースには SQLite schema migration はなく、新しい MCP tool もありません。

[v0.21.0] - 2026-06-20

Added

• automation 向け doctor warning (#1175) — traceary doctor に --warnings-ok を追加しました。CI / smoke check では warning-only report を exit code 0 として扱え、failure は引き続き 1、warning 件数と各 check の severity は JSON report に残ります。
• command audit payload の上限処理 (#1173) — command audit の input/output payload を保存前に切り詰めるとき、head / tail の文脈を残し、CLI / MCP の write result に original byte metadata を出し、audit.max_input_bytes / audit.max_output_bytes の config 既定値で調整できるようにしました。
• sessions snapshot の late-event 反映 (#1172) — traceary sessions --snapshot / --json がセッション終了後に遅れて届いたイベントを正しく反映するようになりました。GC 後のアクティブセッション検索も確実に解決します。
• hook の重複書き込み抑制 (#1167) — hook pipeline がリトライ窓内の prompt / transcript 書き込みを重複除去し、hook 再発火による冗長な row を防ぎます。
• memory 候補の hygiene (#1169) — traceary sessions --snapshot --json（reliability.memory.candidate_hygiene フィールド）が hygiene カウントを報告し、抽出時に明らかな code / diff 断片をレビューキューから除外することでオペレーターが意味のある候補だけを確認できます。
• Claude イベントカバレッジ診断 (#1174) — traceary doctor が Claude のイベントカバレッジのギャップを検出し、hook のキャンセル漏れを専用の diagnostic として表示します。
• Gemini カバレッジ警告 (#1171) — traceary doctor が Gemini セッションデータで boundary-only または audit-only なカバレッジを検出した場合に警告を出し、計装の欠落を示します。
• Gemini compact 計装 docs と doctor check (#1176) — traceary doctor が Gemini の compact イベント計装を検証し、docs で実環境での compact カバレッジの確認方法を説明します。
• Antigravity 機能検出 (#1195) — traceary doctor --client antigravity --json が Antigravity のインストール状況を調査し、not_installed（アプリバンドルも CLI も見つからない）・tool_unavailable（アプリ/CLI は存在するが公開の headless/hook/package サーフェスが未確認）・not_authenticated（将来/予約済み：サポートされたサーフェスでインストールされているが認証または設定が未完了。認証情報を読み取るのではなくサポートされた CLI/contract チェックで検出）・available（将来）の 4 ステートのいずれかを報告します。ローカル開発環境では /Applications/Antigravity.app（バージョン 2.1.4）がインストールされており公開 CLI/hook contract は未確認のため、現在のステートは tool_unavailable です。Antigravity はデフォルトの doctor クライアントリスト（["claude","codex","gemini"]）に含まれません。--client antigravity を明示的に指定してください。

Fixed

• audit-reliability 診断の重複 (#1168) — audit-reliability doctor check が同一候補グループに対して重複した diagnostic を出さなくなりました。
• Claude hook diagnostic cleanup matching (#1174) — cleanup matching を厳密化し、キャンセルされた Claude hook 呼び出しが無音でドロップされず正しくキャプチャされるようになりました。
• SQLite のタイムスタンプ比較 (#1185) — SQLite クエリのタイムスタンプ比較を正規化し、秒以下の精度フォーマットの差異による境界ミスマッチを解消しました。

Changed

• Codex Stop はターン境界 (#1170) — Codex Stop をセッション終了ではなくターン境界イベントとして正しく説明するよう、docs と診断を修正しました。実際の Codex host の挙動に合わせた修正です。
• Clean My Agent 互換性の設計ノート (#1177) — Traceary と Clean My Agent プロトコルの互換性方針を示す設計ノートを追加しました。
• Gemini CLI をレガシーに変更、Antigravity 移行状況ページを追加 (#1197) — README・統合ガイド・Gemini extension docs で、Gemini CLI が Google AI エージェントホストのレガシー実装であり、Antigravity がアクティブな後継であることを明記しました。新設した Antigravity 移行状況ページ は v0.21.0 時点でのローカル調査結果（app パス・bundle ID・バージョン・URL スキーム・ユーザーデータディレクトリ）を記載し、公開 CLI / hook contract が未確認であることを示しています。Antigravity の capability detection は #1195 で実装済みです。#1196 の判断として、v0.21.0 では Antigravity の hook・package・生成メタデータ・リリースアセットを意図的に同梱しません。#1195 でサポート対象の公開 CLI / hook contract が存在しないことが確認されたためで、doctor は偽の package を同梱する代わりに Antigravity を tool_unavailable として報告します。Gemini CLI extension package は既存インストール向けに引き続き提供されます。

Notes

• v0.21.0 には SQLite schema migration と新しい MCP tools の追加はありません。hook 診断・memory hygiene・audit 正確性・session snapshot 精度に focused した dogfood reliability リリースです。
• リリース前に実環境 Traceary workspace での dogfood 検証を実施しました (#1178)。

[v0.20.1] - 2026-05-31

Added

• doctor の hook 整合性 warning (#1152) — traceary doctor が host config 内の Traceary 管理 hook 重複登録を検出し、dry-run-first の remediation guidance を表示します。integration verifier も packaged hook asset に duplicate managed entry が混入した場合に失敗します。
• audit reliability の dogfood signal (#1153) — traceary doctor に bounded な audit-reliability check を追加しました。duplicate command-audit candidate group と workspace-drift candidate を count と sample event ID だけで報告し、command input/output body は出しません。

Changed

• MCP search semantics の明確化 (#1155) — MCP search tool schema と docs で、query は literal な full-text search string であり、OR のような boolean 風の文字列は any-match operator ではないことを明記しました。

Fixed

• command audit の workspace attribution と duplicate row (#1149) — Codex command audit は stale な hook session state より explicit workspace / cwd evidence を優先します。SQLite ingestion は hook retry window 内のほぼ同一の command-audit row を抑制します。
• pipe された JSON / snapshot の broken-pipe exit (#1154) — CLI の JSON / snapshot command は、downstream pipe が閉じた場合を通常の Unix pipeline condition として扱い、broken-pipe error を noisy に表示しないようにしました。
• Traceary self-inspection audit noise (#1150) — hook audit ingestion は Traceary の read-only self-inspection command、Traceary MCP read tool、明示的な TRACEARY_NO_AUDIT opt-out を skip します。一方で通常の generic tool audit は保持します。

Notes

• v0.20.1 には SQLite schema migration と新しい MCP tool の追加はありません。audit correctness、hook diagnostics、dogfood signal quality に focused した patch release です。

[v0.20.0] - 2026-05-29

Added

• ツール失敗の first-class 捕捉 (#1116, #1117) — list --failures が再び機能します。どの host も post-tool hook payload に数値 exit code を出さないため、Traceary は構造的な failed フラグで失敗を記録するようにしました。Claude の PostToolUseFailure（トップレベル error）と Gemini の spawn レベル tool_response.error を failed としてマークし、Codex は構造化された失敗信号を出さないためフラグなし監査として記録します。hook contract docs も host の実態に合わせて修正しました。
• cockpit のメモリ inbox backlog (#1115) — cockpit の Memory タブが inbox の滞留状況（accepted / candidate / new-since-last-review のカウント）を、cheap な CountByStatus クエリで表示します（高コストな reliability scan も List も使いません）。memory cues は Memory タブに留め、session-focused な Top/Sessions は session 専用のままです。
• memory inbox cleanup の composition summary (#1114) — memory inbox cleanup がマッチした候補の total / by_source / by_type 集計を表示し、--apply の前に batch の内訳を確認できます。reject/preview 専用で、bulk accept は evidence-first review の方針を尊重するため意図的に除外しています。

Changed

• reliability scan 飽和時の真値 candidate/accepted カウント (#1111) — reliability surface が bounded scan limit で頭打ちにせず、CountByStatus から正確な accepted/candidate 総数を報告します。
• 抽出 noise gate の強化 (#1113) — auto-extraction がレビューの修正指示断片（修正案: / Fix: / **Fix**:）を inbox から隠します。恒久的な制約を含む行は隠さないよう durable-signal ガードを付けています。
• repository tooling の Go 移行 (#1118, #1119, #1120, #1121, #1122) — maintainer 専用の repository helper を Python から単一の go run ./cmd/repo-tooling ... entrypoint に移行しました。integrations verify / docs verify-i18n / release verify-changelog / docs verify-landing / release bump-version が4本の scripts/verify_*.py と scripts/bump_version.py を置き換え、文書化された repo-tooling 移行順を完了しました。CI・Makefile・release workflow・CONTRIBUTING を Go コマンドに配線済み。残る Python スクリプト（例: verify_release_manifests.py）は移行計画外です。
• command group の厳格化 (#1142) — command group（memory / store / session とそのサブ namespace）が、未知の subcommand に対して help を出して exit 0 する代わりに、usage エラー + 非ゼロ exit で失敗するようになりました。group を素の引数なしで実行した場合（例: traceary memory）は従来どおり help を表示します。typo した subcommand が exit 0 していたことに依存する script は今後 loud に失敗します。
• MCP / handoff contract の正直な記述 (#1106, #1107) — cross-machine handoff doc を実際に出荷している five-table bundle に合わせ、MCP の 8-tool surface を現行の frozen contract として記述しました。

Removed

• CLI 整理 (#1108, #1109, #1110) — 参照のない session-top alias を削除し、v0.14 / v0.15 の migration-error コマンド stub を撤去、空の integration command subtree を deprecate（非表示化）しました。

Notes

• スキーマ: additive migration 000017 が command_audits.failed（NOT NULL DEFAULT 0）を追加します。既存行は 0 になります。MCP tool の変更はありません。command_executed の JSON 出力に additive で omitempty な failed フィールドが加わり、bundle export/import でも round-trip します。
• テスト: CLI test package は TestMain で TRACEARY_LANG=en を固定し、golden snapshot を locale-hermetic に保ちます (#1105)。

[v0.19.0] - 2026-05-26

Added

• Tail-first cockpit shell (#1053, #1054) — traceary tui は Home triage board ではなく Live/Tail stream から開くようになりました。Claude/Codex に近い tab navigation、row movement、Enter/Esc の drill-in/back、recent Traceary event の live auto-follow semantics を備えます。
• 専用 Sessions tab と editable Settings (#1055, #1056, #1083) — cockpit は Tail と Sessions を別 tab として扱い、Settings では TUI を離れずに language / read / redaction 設定を arrow-key form controls で安全に更新できます。
• Evidence-first Memory review hardening (#1057, #1066) — Memory review は supporting refs が追加されるまで evidence のない accept / edit-distill をブロックします。traceary memory inbox attach <id> --evidence kind:value [--artifact kind:value] を追加し、対話的な review TUI でも r で attach action を保留してから accept / edit-distill できるようになりました。
• 日本語 TUI copy refresh (#1058) — literal command name は英語で copy しやすいまま維持しつつ、日本語 cockpit / Memory review copy を更新しました。
• Host-native memory activation file のバージョン管理 (#1050) — Traceary 管理の Claude/Gemini memory import stub と生成済み project memory projection を repository に含め、dogfood activation state を将来の agent と共有できるようにしました。
• Primary Sessions dashboard command (#1083) — operator 向け dashboard command として traceary sessions を追加しました。恒久的な互換 alias の traceary top と同じ filter、live TUI、--snapshot、--json を備えます。
• Evidence-rich Memory inbox inspection (#1091) — traceary memory inbox show <memory-id> を追加し、memory inbox list に CONFIDENCE / REVIEW column を追加しました。operator は候補を判断する前に source context、evidence refs、artifact refs、guidance、accept-readiness を確認できます。

Changed

• Subcommand なしの traceary が対話 terminal で Tail-first TUI を開くように変更 (#1060) — stdin/stdout が TTY のとき、subcommand なしの traceary は traceary tui と同じ Tail-first cockpit を開きます。非対話 caller では deterministic な help / fallback output を維持するため、script からは traceary list、traceary sessions --snapshot [--json]、traceary doctor --json などの明示的な script-friendly command を優先してください。traceary top --snapshot [--json] は恒久的な互換 alias として引き続き使えます。
• Cockpit review invariants を regression coverage 化 (#1059) — cockpit に関する過去の Codex review findings を regression として固定しました。weak-memory accept confirmation、80x24 dogfood smoke、日本語 narrow snapshot、Settings write safety を含みます。
• Latest-session schema test alignment (#1068) — latest-session test が runtime database と同じ production migration-backed schema path を使うようになりました。
• Cockpit のメモリ確認 glossary を整理 (#1070) — TUI、CLI help、top --snapshot の empty state、関連する memory review error message では候補キューを英語で “memory review queue”、日本語で メモリ候補の確認キュー と一貫して呼ぶようにしました。一方で、traceary memory inbox ... の literal command path、candidate(inbox) metric、既存の top --snapshot section header は script で copy しやすいよう維持しています。
• Sessions text snapshot に operator 向け name を追加 (#1083) — traceary sessions --snapshot と互換 traceary top --snapshot の text row は、raw な workspace= / agent= metadata の前に name="..." を含むようになりました。JSON snapshot schema は変更していません。text を読む script は位置ではなく key=value field として parse してください。
• Cockpit の Tail / Sessions surface を単純化 (#1082, #1083, #1092) — Tail は terminal height に合わせて広がる read-only stream になり、scroll / follow control は残しつつ detail drill-down をなくしました。旧 Top surface は session-only な Sessions tab に昇格し、cockpit navigation は Tail | Sessions | Memory | Settings になりました。メモリ候補、stale memory cleanup、reliability scan は Memory タブまたは standalone の traceary sessions / 互換 traceary top surface に置きます。
• Cockpit Settings navigation を global tab behavior に統一 (#1081) — Settings 上の left/right と tab/shift-tab は、highlight 中の setting を変更せず cockpit tab 間を移動します。設定値の変更は Enter または直接 value shortcut で staging します。

Fixed

• CLI session-end attribution inheritance (#1078) — 既存 session を終了するとき、traceary session end は省略された client / agent / workspace を default の cli / manual attribution で上書きせず、対応する session start から継承した attribution を end event に保持するようになりました。
• Cockpit Tail rendering parity (#1089) — cockpit Tail row は compact traceary tail と同じ color semantics を使い、ANSI wrapping 前に row width を hard cap します。truncated / wrapped line が TUI viewport を崩す問題を防ぎます。
• Sessions dashboard scalability (#1090) — Sessions surface は session が多い場合でも使えるよう、dashboard row を active / recent priority で並べます。snapshot 出力は変えず、identity-first row を読みやすく保ち、cockpit view 向けに subtree priority を cache します。
• Cockpit Tail truncation marker cleanup (#1097) — cockpit Tail row は大きすぎる payload を引き続き compact 化してから表示しますが、live stream の横幅を消費していた literal な [truncated] suffix は表示しなくなりました。
• Sessions inline detail context (#1098) — Sessions detail を開いても、Sessions 概要・選択中 row の context・dashboard が同じ tab 内に残るようになりました。長い detail でも大きめの terminal で高さを取りすぎないよう budget します。

Notes

• v0.19.0 には SQLite schema migration と新しい MCP tools の追加はありません。
• Formula/traceary.rb は tagged release workflow が生成するため、release-preparation PR では編集しません。

[v0.18.0] - 2026-05-24

Added

• reference に基づく cockpit UX baseline (#1035) — v0.17 cockpit を成熟した terminal UI pattern と比較して監査し、v0.18 の情報設計、global navigation、状態 feedback、release acceptance rule を定義する bilingual design doc を追加しました。
• 永続的な cockpit navigation shell (#1040) — traceary tui に Home / Live / Doctor / Memory / Sessions / Settings の番号付き global section を追加し、常時見える section chrome、tab / shift-tab navigation、cockpit 内の Esc back、q / Ctrl-C quit を整理しました。
• discoverable な contextual actions (#1041) — ? help overlay が現在の cockpit screen に応じた action menu を表示するようになりました。使えない shortcut は隠し、Live detail、Doctor remediation、Memory review、Sessions、Settings の有効な next action だけを案内します。
• actionable な Home triage board (#1043) — cockpit Home は raw count dump ではなく、problems、新着 activity、memory inbox、active sessions、recent failures、health を優先度付き card と next-action target で表示します。
• cockpit dogfood snapshots と release checklist (#1044) — golden snapshot、keyboard path test、terminal-size smoke、bilingual manual dogfood checklist を追加し、cockpit regression を release 前に検出できるようにしました。
• 日本語 cockpit UI (#1045) — command 名は copy しやすい英語のまま残しつつ、cockpit navigation、Home card、footer/help、Doctor/Live/Sessions、Memory review decision guidance を日本語化しました。
• cockpit Settings section (#1046) — 6 Settings cockpit section を追加し、config path/status、environment override diagnostics、read-only preset/rule summary、ui.language / read.color / read.fields / 検証済み redact.extra_patterns の staged safe update を扱えるようにしました。

Changed

• Memory review decision を evidence-first に変更 (#1042) — cockpit Memory review は candidate memory を accept する前に source、confidence、quality signals、evidence/artifact count、candidate age、duplicate/supersede hint、accept-as-is checklist を表示します。low-confidence と extracted-hidden candidate は追加の accept confirmation が必要です。
• CLI language precedence を config 可能に変更 (#1046) — operator-facing CLI/TUI language は TRACEARY_LANG > config ui.language > built-in English の順で決まります。環境変数 override が無い場合、Settings 保存後に現在の cockpit language も更新します。

Notes

• v0.18.0 には SQLite schema migration と新しい MCP tool はありません。
• traceary top、traceary tail、traceary doctor、traceary session handoff、traceary memory inbox review などの script-friendly command は引き続き利用できます。cockpit はそれらの surface の上に載る discoverable な operator console です。
• Settings write は conservative です。invalid / unreadable な config JSON は上書きせず、regex 追加は staging 前に検証し、write は atomic replacement で行います。

[v0.17.1] - 2026-05-23

Fixed

• release-bot Homebrew autolabel の hardening (#1021) — PR 側の autolabel job は、release workflow が生成する Homebrew formula branch (maintenance/homebrew-v*) では skip するようになりました。これらの PR は release note 分類の入力ではないため、その理由を workflow comment に明記しています。通常の human / Dependabot / feature branch 向け autolabel は issues: write permission を明示して継続し、CI で release-drafter workflow guard も検証します。

Notes

• v0.17.1 は release automation のみを対象にした patch release です。CLI 挙動変更、SQLite schema migration、新規 MCP tool はありません。

[v0.17.0] - 2026-05-23

Added

• operator cockpit entrypoint (#990) — traceary tui で TTY 専用の operator cockpit を明示的に開けるようになりました。operator が top / tail / doctor / session handoff / memory inbox review を個別に覚えなくても、1 つの入口から確認を始められます。非対話 caller は従来どおり deterministic な script 向け command を使い、TTY なしで cockpit を起動した場合は fallback guidance を受け取ります。
• cockpit home status model (#991) — cockpit home は active session、直近の失敗、recent command、candidate memory、accepted memory 数、stale session signal、large payload 数、doctor status をまとめて表示し、operator が 1 つの triage surface から始められるようになりました。
• cockpit 内 live tail (#992) — cockpit から live event-tail pane へ切り替えられるようになりました。follow / refresh と event detail drill-down を持ち、既存の event formatting / query path を再利用します。script や専用 terminal session 向けの traceary tail はそのまま残ります。
• memory inbox notification と review flow (#993, #994) — cockpit が candidate memory 数、remember-intent priority、新着 candidate warning を表示し、cockpit から直接 memory review を起動できるようになりました。operator は cockpit を離れずに accept / reject / skip / edit-distill / evidence 確認を行えます。
• doctor warnings pane (#995) — traceary tui から doctor details を開けるようになりました。既存 doctor report の failure / warning を grouped view として表示し、hook / MCP / configuration の問題を live work と並べて確認できます。
• 永続 cockpit last-seen state (#996) — cockpit は user state directory に local last-seen timestamp を保存します。event boundary ID を追跡して新着 event 数の重複・取りこぼしを避け、local notification state を消したい operator 向けに traceary tui --reset-state を追加しました。

Changed

• 明示 cockpit entrypoint を安定 path としてドキュメント化 (#997) — README、CLI reference、interactive docs で、v0.17.0 の operator entrypoint は traceary tui であり、bare traceary は変更せず cockpit を自動起動しない help / usage 表示を維持する、と説明しました。

Notes

• v0.17.0 には SQLite schema migration も新しい MCP tool もありません。
• cockpit state file は local operator state であり、project data として共有されません。削除しても cockpit notification checkpoint がリセットされるだけです。
• 既存の traceary top、traceary tail、traceary doctor、traceary session handoff、traceary memory inbox review は直接利用・automation 向けに引き続き使えます。

[v0.16.0] - 2026-05-23

Added

• host context 取得前の stale active session 保護 (#982) — host 向け context 経路で stale threshold を超えた active session を識別し、放置された session が現在の working context を黙って隠さないよう cleanup guidance を表示するようにしました。
• memory inbox backlog control (#986) — traceary memory inbox list に age / quality filter を追加し、traceary memory inbox cleanup で accepted memory には触れずに古い candidate や低品質 candidate を dry-run-first で reject できるようにしました。
• remember-intent promotion の可視性 (#987) — memory inbox と top snapshot に remember-intent candidate count と source filter を追加し、明示的な「remember this」由来の candidate を review / promote しやすくしました。
• traceary top --snapshot の dogfood reliability metrics (#988) — text snapshot / JSON snapshot に additive な reliability section を追加し、stale active session、accepted/candidate memory count、candidate age、recent command/failure pane の large payload count を確認できるようにしました。

Changed

• session / event / memory の workspace resolution を共通化 (#983) — workspace-scoped handoff と context loading が exact-match-first の parent/child fallback を共有し、child workspace の request が event evidence 経由で parent-scoped session に一致した場合は user-visible hint を出すようにしました。
• 大きな command payload を context surface で上限付きに (#984) — top snapshot、handoff context、MCP session context の recent command / failure payload に共通 truncation policy と metadata を適用し、巨大な command output が host-agent context window を圧迫しないようにしました。
• accepted memory を durable-memory context の既定に (#985) — host context は既定で accepted memory を優先し、candidate memory は別枠で報告します。未レビューの extraction 結果が trusted long-term context として扱われるリスクを下げました。

Notes

• v0.16.0 には SQLite schema migration と新規 MCP tool はありません。
• traceary top --snapshot --json の reliability key は additive です。既存 consumer は引き続き sessions / failures / recent_commands / candidates / stale_memories を読めます。
• candidate memory は review-first のままです。対話的な整理には traceary memory inbox review、一括 reject の前には traceary memory inbox cleanup --dry-run を使ってください。

[v0.15.0] - 2026-05-10

Added

• traceary top --snapshot --json に stale memory data を追加 (#959) — top data loader が sessions / recent failures / recent commands / candidate memories に加えて stale durable memories も取得するようになりました。JSON snapshot envelope には additive な stale_memories ({ count, items }) キーが追加され、row は durable-memory summary field に reason を加えた shape です。
• traceary top に stale memory ペインを追加 (#960) — live dashboard と text snapshot に 5 つ目のペイン / セクションとして stale durable memories を表示します。memory hygiene の作業候補を日常 read surface で見られるようにし、新しい command は追加していません。
• traceary top のペイン内 / search (#961) — フォーカス中 dashboard ペインで / による incremental filter が使えるようになりました。Enter で filter を保持し、/ で既存 filter を再編集、Esc で active filter をクリアします。
• traceary top の Enter-to-detail drill-down (#962) — highlight 中の session / event / candidate memory / stale memory row から scroll 可能な detail modal を開けるようになりました。session detail は lineage と recent events を表示し、event / memory detail は既存の CLI detail renderer を再利用します。

Changed

• release-drafter Dependabot 取り込み (#953) — release prep 前に release-drafter/release-drafter と autolabeler action の pin baseline を 7.2.1 から 7.3.0 へ更新しました。
• Go dependency Dependabot 取り込み (#954) — TUI-heavy な作業に入る前に、github.com/charmbracelet/bubbles 1.0.0、github.com/anthropics/anthropic-sdk-go 1.41.0、golang.org/x/* 更新を含む Go dependency group を取り込みました。
• 削除済み alias docs verifier を v0.15 対応に更新 (#958) — scripts/verify_docs_no_removed_aliases.py が、歴史的な移行 allow-list の外で v0.15 で削除された flat memory verb や integration codex uninstall を推奨する docs を検出するようになりました。
• memory inbox review の id 単位 failure を command failure として返すよう変更 (#963) — queued decision は引き続き最後まで適用し、stdout の FAILED 行も従来通り出力します。一方で partial review は非ゼロ error を返すため、shell automation が成功扱いしません。
• README / CLI reference / stability policy / changelog を v0.15 に同期 (#964) — top search / detail / stale-memory ペイン、stale_memories JSON envelope key、v0.15 alias removal、Dependabot 取り込み結果を docs に反映しました。

Removed

• hidden flat memory alias を削除 (#956) — v0.14 で hidden deprecated alias として残していた memory accept、memory reject、memory remember、memory propose、memory distill、memory extract、memory import codex、memory import instructions、memory export、memory activate、memory hygiene scan、memory hygiene apply、memory graph add、memory graph list、memory supersede、memory expire、memory set-validity を削除しました。canonical な memory inbox / memory store / memory admin path を使ってください。
• cleanup 専用 traceary integration codex uninstall を削除 (#957) — v0.14 の移行期間を終えたため hidden cleanup command を削除しました。Codex plugin の install / uninstall は Codex CLI 公式の /plugins flow を使い、legacy install の手動 cleanup 手順は Codex plugin ガイドに残しています。

Notes

• v0.15.0 には SQLite schema migration と新規 MCP tool はありません。
• traceary top --snapshot --json の stale_memories キーは additive です。v0.14 envelope の sessions / failures / recent_commands / candidates を読む既存 consumer はそのまま動作します。
• flat memory verb と Codex uninstall cleanup path の v0.14 deprecation window は完了しました。新しい script では canonical grouped path のみを使ってください。

[v0.14.0] - 2026-05-07

Added

• 共通 Bubble Tea TUI 基盤を presentation/cli/tui に追加 (#924) — Bubble Tea / Bubbles / Lip Gloss を内製しすぎないよう、対話 CLI 向けの小さな共通パッケージを追加しました。Lip Gloss の共通スタイル、共有 keymap (移動 / paging / 選択 / refresh / help / quit、Ctrl-C と Esc も quit に bind)、TTY ガード、Run エントリ (TTY でなければ起動を拒否し、terminal restoration と signal handling は Bubble Tea に委譲) を提供します。今後の memory inbox review UI と再設計版 top dashboard はこの基盤の上に乗ります。本リリースではユーザーから見える挙動の変更はありません (traceary top は従来の renderer のままです)。
• 対話的 traceary memory inbox review を追加 (#925) — candidate durable memory の inbox を巡回する TTY 専用の walk-through を共通 TUI 基盤 (#924) の上に追加しました。フィルタ群 (--workspace / --agent / --session-family / --type / --source / --include-hidden / --limit) は memory inbox list と揃えてあるため、スナップショット表示と対話的レビューをフラグ調整なしで往復できます。Accept / reject は既存の MemoryUsecase.Accept / Reject ユースケースをそのまま呼び出すため、dedupe や status 遷移の意味づけは従来どおりです。edit / distill は operator 自身に新しい fact を入力させ、memory store distill --replace=supersede 経由で記録するため、candidate の LLM 出力をそのまま採用することはありません。非 TTY で起動した場合はエラー終了し、exit code は 2、fallback guidance として memory inbox list と memory inbox accept|reject を案内します (バッチ / scripted caller 向け)。

Changed

• traceary top --snapshot を再設計済み dashboard に合わせて拡張 (#929) — traceary top --snapshot および traceary top --snapshot --json の非対話 snapshot 出力を、#928 で導入した 4 ペイン dashboard と同じデータに合わせて拡張しました。これによりパイプ / CI / スクリプト経由の利用者も live view と同じ情報を取得できます。テキスト出力には ACTIVE SESSIONS / RECENT FAILURES / RECENT COMMANDS / CANDIDATE MEMORIES (count=N) のセクションヘッダーが追加されました (active session tree のフォーマットは変更なし)。JSON 出力は sessions / failures / recent_commands / candidates ({ count, items }) を持つ envelope オブジェクトでラップする形に変更しました。session node のフィールド shape は従来通りですが、トップレベルが「session node の配列」から envelope オブジェクトに変わったため、配列をそのまま読み取っていたスクリプトは envelope の sessions を読むよう更新が必要です。空のペインも [] / count=0 でシリアライズされるため、消費側はキーが常に存在することに依存できます。各ペインの行上限は dashboard と揃えており (failures 50 / recent commands 50 / candidates 25)、session ペインは引き続き --limit を使用します。
• traceary top を共通 TUI 上の multi-pane dashboard に移行 (#928) — live traceary top を共通 presentation/cli/tui 基盤 (#924) 上の Bubble Tea model に置き換え、active sessions / 直近の failures / 直近の command_executed / durable memory inbox candidates の 4 ペイン構成にしました。tab / shift+tab でフォーカスペインを切り替え、↑/↓ (および pgup/pgdn / g / G) で各ペインを独立にスクロール、r で snapshot 再取得、? でヘルプ overlay を切り替え、q / Ctrl-C / Esc は共通の安全網を経由して安全に終了します。ペインは topDataLoader (#927) を共有しているため、フィルタと lineage 処理は --snapshot / --snapshot --json と完全に同じ経路です。スナップショット出力とコマンド名は変更していません。非 TTY 呼び出しは従来どおり snapshot text writer にフォールバックします。狭い端末ではペインあたり 1 行の viewport まで縮小し、小さなウィンドウでも操作不能にならないようにしてあります。
• traceary top のデータ取得をテスト可能な loader に切り出し (#927) — RootCLI に直書きしていた active session tree の取得と lineage 展開を、presentation/cli/top_data.go の topDataLoader という小さな seam にまとめ、loadSnapshot 経由で sessions / failures / recent commands / candidate memories をまとめて取得できるようにしました。cobra command は従来どおり text / JSON snapshot を出力し、session 取得だけを loader 経由に切り替えています。failures / recent commands / candidates 用の経路は同じ loader にすでに繋がっていますが、multi-pane dashboard を追加する #928 までは利用しません。loader の各メソッドは決定論的な fixture を使った内部テストでカバーされており、dashboard が育っても境界の挙動を観測できる状態にしてあります。
• traceary-memory-review skill が対話 CLI を「人間が手動でレビューする際の優先 fallback」として案内するように更新 (#926) — Claude Code / Gemini CLI / Codex に同梱している traceary-memory-review skill を更新し、operator 自身が端末で durable memory inbox を捌きたい場合の preferred human fallback として traceary memory inbox review (#925 で追加) を明示しました。あわせて、対話的レビュー (memory inbox review) と script / batch 用途の memory inbox list + memory inbox accept|reject を別々の fallback として案内し、混同しないように記述を分離しました。no-auto-accept guardrail も MCP manage_memory(action="accept") だけでなく CLI batch 系コマンドにも適用されるよう明文化し、operator から個別 id 単位の明示指示が無い限り candidate を accept しないというルールを再徹底しています。skill version は 1.1.0 に bump しました (trigger phrases は変更なし)。
• memory inbox accept / reject で positional id と --id-only をサポート (#923) — traceary memory inbox accept <id> と traceary memory inbox reject <id> が単一 id の典型ケースで動作するようになり、canonical な inbox パスが対話的に打ち込む形と一致します。canonical な 2 コマンドには --id-only (--json と排他) も追加し、旧 flat memory accept <id> --id-only / memory reject <id> --id-only の strict superset となるようにしました。1 件成功時は memory id だけが stdout に出力され、バッチでは成功 1 件ごとに 1 行で id を出力します。id 単位の失敗は stderr に書き出し、終了コードは非 0 です。既存の --ids id1,id2,... 形式はバッチスクリプトと MCP 呼び出し向けにそのまま利用でき、--id-only を指定しない場合の dedupe / failure の意味づけも変更ありません。hidden deprecated alias の memory accept / memory reject の stderr deprecation notice も positional canonical 形を案内するように更新しました。
• memory CLI を inbox / store / admin 名前空間に再編成 (#922) — traceary memory --help で日常 read 用途 (memory search / memory show / memory list) と並んで grouped surface (memory inbox / memory store / memory admin) を案内するようになりました。flat な実装 verb (memory remember / memory propose / memory distill / memory extract / memory accept / memory reject / memory supersede / memory expire / memory set-validity / memory import / memory export / memory activate / memory hygiene / memory graph) は hidden な deprecated alias として動作を維持し、実行時に canonical な置き換えと v0.15 削除予定を含む 1 行の deprecation notice を stderr に出力します。JSON / stdout 出力は変更していないため、scripted caller や AI integration はそのまま動きます。

Docs

• v0.14 memory コマンド面の整理計画 (#921) — docs/operations/memory-command-surface.md と日本語版を追加し、現在の traceary memory ... のすべてのパスを棚卸して v0.14 の目標ツリー (memory inbox / memory store / memory admin) にマッピングしました。memory search / memory show / memory list は日常 read 用途として top-level に据え置きます。v0.14 で hidden な deprecated alias として残し、v0.15 で削除する旧パスを明示しています。
• CLI 安定性と非推奨ポリシー (#931) — docs/cli-stability.md と docs/cli-stability.ja.md を追加し、v0.14 のコマンドサーフェスを public / admin / plumbing の 3 ティアに分類しました。stderr 1 行の deprecation 通知フォーマット（stdout / --json / NDJSON はバイト一致を維持）、1 マイナーの互換ウィンドウ、v0 と v1 の削除ポリシーを明文化しています。README とドキュメント索引から CLI リファレンスと並んで本ポリシーをリンクするように更新しました。
• v0.14 に向けた README / CLI リファレンス / operator docs の同期 (#932) — README pair に v0.14 の memory namespace (memory inbox / memory store / memory admin) と対話的な memory inbox review を日常 read コマンドと並べて記載しました。docs/cli/README.md と docs/cli/README.ja.md の durable memory セクションを v0.14 namespace 構造に再編し、TTY 専用 memory inbox review のキー操作と非 TTY 時の exit code 2 fallback を明記、traceary top の multi-pane dashboard リファレンスを拡充、削除された top-level alias (init / backup / gc / handoff / compact-summary) と hidden な Codex integration codex uninstall cleanup の移行バナーを書き直しました。storage / backup / operations / memory / interactive ガイドは canonical な traceary store ... と traceary session handoff のパスを使うよう統一し、削除された alias を推奨しないようにしました。新規 scripts/verify_docs_no_removed_aliases.py（CI に組み込み）により、移行表の外で削除済み v0.14 alias を新たに推奨してしまう docs を検知します。

Removed

• deprecated な top-level command alias を削除 (#918) — traceary init / traceary backup / traceary gc / traceary handoff / traceary compact-summary は実行可能 command として登録されなくなり、traceary --help からも消えました。旧名を実行すると、canonical な置き換え (traceary store init / traceary store backup ... / traceary store gc / traceary session handoff / traceary session handoff --compact-only) を案内する usage error で終了します。これらの alias は v0.9 から deprecation 通知を出していました (#696)。v0.14.0 で予定どおり削除します。
• 非推奨だった traceary-memory-capture skill stub を削除 (#919) — Claude Code plugin / Gemini CLI extension / Codex plugin の各パッケージから placeholder の traceary-memory-capture skill を削除しました。inbox の整理と session recap には traceary-memory-review、明示的な durable memory の書き込みには traceary-memory-remember を使ってください。
• traceary integration codex install を削除 (#920) — 旧 install path は実行可能 command としては機能しなくなりました。実行すると v0.14.0 での削除を明示し、Codex 公式の /plugins flow を案内する usage error を返して終了します。traceary integration codex uninstall は、削除済みの install path から移行するユーザー向けに hidden な cleanup 専用 command として残してあります (traceary integration codex --help には表示されません)。v0.15 で削除予定です。

[v0.13.1] - 2026-05-04

Changed

• compact read 行が interactive terminal 幅を使うように (#908, #912, #914) — traceary list / traceary search / traceary tail の compact text output は、interactive terminal に出力する場合に従来の固定 100 column cap ではなく検出した TTY 幅を使います。pipe / redirect / non-TTY 出力は従来どおり 100 column fallback を維持するため、scripted output は安定したままです。--wide と --json は compact formatter contract の外にあります。dogfood では 3 コマンドすべてについて TTY / pipe の両経路を確認し、formatter budget の regression test も追加しました。
• v0.13.1 向け dependency maintenance (#879, #910) — github.com/mattn/go-runewidth を 0.0.23、github.com/modelcontextprotocol/go-sdk を 1.6.0、github.com/pelletier/go-toml/v2 を 2.3.1、modernc.org/sqlite を 1.50.0 に更新しました。上流の挙動変更がある MCP SDK の SetError と Streamable HTTP cross-origin path は Traceary では使っていないことを確認し、新しい SQLite driver でも SQLite-backed store tests は通過しています。
• release-drafter action pin の更新 (#878, #911) — release-drafter/release-drafter と autolabeler action の pin を上流 v7.2.1 commit に更新しました。supply-chain hygiene のため full-SHA pinning は維持しています。

Notes

• v0.13.1 は patch release です。schema migration、新規 CLI flag、host activation の挙動変更はありません。

[v0.13.0] - 2026-05-03

Added

• Claude Code host-native activation (#892, #893) — traceary memory activate --target claude が、CLAUDE.md 内の managed import stub と .traceary/memories/claude.md 内の accepted memory からなる二ファイル activation pair を plan / diff / status 表示し、明示 --apply で適用できるようになりました。traceary doctor --client claude も同じ status と dry-run/apply remediation を表示し、構造 smoke test は初回 apply、冪等な再 apply、最終 in_sync、doctor pass を検証します。
• Gemini CLI host-native activation (#894, #895) — traceary memory activate --target gemini が、GEMINI.md と .traceary/memories/gemini.md に対して Claude と同じ read-only status / dry-run / diff / 明示 apply workflow を提供します。apply は user-authored な host context と Gemini が所有する ## Gemini Added Memories content を保持し、traceary doctor --client gemini は actionable な activation check を表示します。
• Activation target contract と docs (#889, #896) — 新しい host-native activation ADR で、Claude/Gemini の path、import-stub marker layout、status state、安全ルール、.gitignore policy、却下した代替案、release sub-issue sequence を定義しました。memory / CLI / integration docs は、Codex・Claude・Gemini を横断する 1 つの workflow として activation を説明します。

Changed

• 共通 activation infrastructure (#890, #891) — marker parsing、managed-region replacement、host target resolution、安全な activation file I/O を host 非依存の primitive に整理しました。二ファイル planner は host context stub と external memory file それぞれの action / status / diff を追跡し、external memory file を先に書き、symlink / directory / newer marker などの unsafe target を拒否し、冪等に動作します。
• Activation workflow の dogfooding 証跡 (#896) — release-prep docs に、Claude / Gemini の一時 fixture で status -> dry-run --diff -> apply -> apply -> status -> doctor を通した dogfood 結果を記録しました。Codex activation の挙動は v0.12.0 から変更ありません。

Notes

• v0.13.0 は、v0.12 の Codex activation contract を維持しながら Claude Code / Gemini CLI の host-native activation を完成させる minor release です。
• Claude / Gemini の live runtime probe は、host authentication と初回 import approval が環境依存であるため、引き続き TRACEARY_ENABLE_CLAUDE_RUNTIME_SMOKE=1 / TRACEARY_ENABLE_GEMINI_RUNTIME_SMOKE=1 による opt-in です。default の smoke / dogfood path は、Traceary 側の決定論的な file planning、apply、冪等性、preservation、doctor behavior を検証します。

[v0.12.0] - 2026-05-02

Added

• Durable-memory candidate の品質制御 (#857, #864) — extraction が diff fragment、generated-code marker、単独 shell command（rtk ... wrapper を含む）、review-only conclusion、一時的な作業宣言、PR round chatter などの低 signal noise を隠すようになりました。一方で durable な日本語 / multilingual preference や constraint は保持します。
• 明示 remember / lifecycle 由来の抽出経路 (#856, #862, #865) — explicit な "remember this" prompt、短い remember-intent follow-up と隣接 context、post-compact summary、clear/reset summary から、manual note だけに頼らず evidence ref 付きの reviewable durable-memory candidate を提案できるようになりました。
• Candidate distillation (#858) — traceary memory distill が 1 件以上の candidate memory を operator が整えた accepted fact に変換します。source ref を保持し、元 candidate の keep / reject / supersede handling を選べます。
• Codex memory bridge の拡張 (#859, #860) — Codex import は ~/.codex/memories/*.md 配下の multi-file Markdown memory layout を決定論的に読みます。export は workspace memory と一緒に global memory も含められるため、host-level の運用ルールを repository-specific fact と一緒に渡せます。
• Codex native activation (#866, #861, #867) — traceary memory activate --target codex が dry-run/diff planning、read-only status (missing, stale, in_sync, invalid)、明示的な --apply 書き込みに対応しました。既定 target は Traceary 管理の Codex memory file (~/.codex/memories/traceary.md) です。apply は管理ブロック外の user-authored content を保持し、冪等で、新しい marker version を上書きせず、text/JSON で activated count を返します。traceary doctor --client codex でも同じ activation status と remediation command を表示します。
• Host activation strategy docs (#868) — memory / integration docs で、Traceary accepted store、instruction-file export、host-native activation の違いを明確化しました。v0.12 で実装済みなのは Codex で、Claude / Gemini native write は #883 / #884 に明示的に defer しています。

Changed

• Workspace export は既定で global memory を含む (#860) — memory export / MCP export は、明示 workspace に対して --no-global / include_global=false を使わない限り global scope entry も含めます。
• Codex import は legacy safety を維持しつつ shard に対応 (#859) — legacy MEMORY.md は従来の heading allow-list を維持し、それ以外の Markdown shard は任意 heading 配下の list item を per-file evidence/artifact ref と symlink/size guard 付きで取り込みます。

Notes

• v0.12.0 は durable-memory の品質、curation、Codex-native activation に焦点を当てた minor release です。Claude / Gemini は v0.12 では MCP tools と instruction-file export を使います。これらの host-native activation write は今後の follow-up であり、このリリースには含まれません。

[v0.11.2] - 2026-04-28

Added

• durable-memory intent の診断 (#851) — traceary memory extract --debug-signals が candidate を作成せずに、segment 単位の抽出判断を説明するようになりました。検出 feature、推定 type、score、decision、reason、evidence ref、artifact ref、source metadata (client, event_kind, source_hook) を出力します。debug path は extraction の dedupe、最高 score 選択、candidate-limit 挙動に揃えているため、dogfooding 時に signal が proposed / hidden / skipped / ignored のどれになったかを確認できます。

Changed

• 明示的な memory intent を keyword 追加ではなく分類 (#851) — Durable Memory:、Memory Note:、Remember:、Remember this:、覚えておいて:、記憶: などの durable-memory intent を認識します。明示 intent は default で可視 candidate になるだけの score を持ち、type が曖昧な場合も preference / constraint / decision / artifact / それ以外は lesson に安全に fallback して、remember request を silent drop しません。

Fixed

• memory metric の false positive を抑制 (#851) — generic な Memory: / メモリ: telemetry 風の行は explicit durable-memory intent として扱わないようにし、Memory: 2 GB のような通常の resource log が visible lesson candidate になることを防ぎます。

[v0.11.1] - 2026-04-28

Fixed

• command audit 証跡を汎用 event surface から取得可能に (#842) — command_executed の event body に command line / exit code / input payload / output payload を含め、list / search / MCP list_events / MCP search から Bash の検証証跡を取得できるようにしました。handoff の recent command summary は従来どおり command line のみに丸めます。
• Claude compact summary から durable-memory candidate を生成 (#844) — compact-summary event にも prompt / transcript / note と同じ heuristic extraction を適用し、日本語 label / durable marker (決定, 判断, 制約, 教訓, 次回, 確認済み など) を認識するようにしました。Claude 風の日本語 summary が silent [] にならず、review-only candidate を生成します。
• Codex の stale hook install を memory-capture gap として診断 (#843) — traceary doctor が Codex Stop hook について transcript と session stop の両方を要求し、UserPromptSubmit / transcript capture の欠落が durable-memory extraction を starvation させることを明示します。修復導線は traceary hooks install --client codex --upgrade です。

Changed

• memory extraction の可視性判定を signal scoring 化 (#835) — extracted / extracted-hidden の判定を、文字長だけでなく structured label、evidence ref、artifact ref、英日 durable marker、Latin/CJK 長さを組み合わせた score で行うようにしました。duplicate candidate は source 判定前に dedupe key ごとの最高 score を選ぶため、弱い先行 signal が強い structured evidence を隠しません。

[v0.11.0] - 2026-04-27

Added

• lifecycle 観測ドキュメント (#817, #818) — docs/hooks/lifecycle-events.md と docs/hooks/host-coverage.md (en+ja) を新設し、6 つの lifecycle event kind と host 別 wiring matrix を整理しました。
• hook 駆動 L2/L3 memory pipeline (#825, #826, #829, #831) — Claude PreCompact の summary を sessions.summary に sync し、subagent-stop / session-end hook が source=extracted / status=candidate の memory を auto-extract、handoff と get_context の payload に candidate を status marker 付きで含めるようになりました。
• 品質フィルタ + extracted-hidden 可視性 (#831, #833) — auto-extract された candidate を文字長ヒューリスティック (Latin 20 / CJK 10 runes、artifact 系は除外) でフィルタし、新規 extracted-hidden source は store には残しつつデフォルトでは表示しません。CLI / MCP search ともデフォルトでは extracted-hidden を除外し、明示時のみ含めます。
• 14 日経過した stale candidate の自動 expire (#834) — gc が 14 日以上前の auto-extract された candidate (source IN ('extracted', 'extracted-hidden')) を削除します。FK 制約を壊さないよう、supersedes_memory_id で参照している側を先に NULL 化します。
• SKILL 再定義 (#821, #822) — traceary-memory-review (review/inbox/recap 専用) と traceary-memory-remember (明示要請時の write 専用) を 3 ホストすべてに同梱し、旧 traceary-memory-capture を deprecate しました。
• Gemini lifecycle wiring (#819, #820) — Gemini CLI で BeforeAgent を prompt event 源に、PreCompress を compact_summary marker に配線しました。
• 日次 host hook drift check (#828) — docs/operations/scheduled-tasks.md に、上流 host hook reference と host-coverage.md の日次 diff を /schedule で回す手順を記載しました。
• memory モデル docs (#823, #824, #827) — README を 3 層モデル表現に揃え、candidate status の表記を統一、evidence_refs / artifact_refs の kind enum を公開しました。

Changed

• traceary top の East Asian Wide 文字対応 (#836) — top / event_text_formatter / timeline padding の column 計算を rune count から runewidth ベースに置き換えました。host locale の差で結果が変わらないよう、init 時に runewidth.DefaultCondition.EastAsianWidth を narrow に固定しています。
• MCP body truncation (#837) — list_events / get_context / search で event body を default 500 runes で truncate し、body_truncated / body_length marker と body_limit / full_body=true の override を追加しました。truncate 時には body_blocks を出さず、再取得は同じ呼び出しに full_body=true を付ける指示を schema に明記しています。

Notes

• Codex CLI の compact_summary は upstream openai/codex#16098 が未着地のため v0.11.0 でも未対応です。
• v0.11.0 は minor release: schema 変更なし、JSON contract の追加のみです。

[v0.10.3] - 2026-04-26

Breaking changes

• traceary top --snapshot --json contract の分離 (#795) — top snapshot JSON は traceary session tree --json の contract 再利用をやめ、top 専用 contract に分離しました。既存の session tree field は維持しつつ、live dashboard consumer 向けに latest_event_kind / latest_event_message / latest_event_at を追加します。

Added

• traceary top 行に workspace と latest event を表示 (#794) — text snapshot と live TUI の各行に workspace=…/owner/repo（末尾保持、36 runes で truncate）と last=<kind>: <message>（80 runes で scrub + truncate、event が無い session は -）を追加し、並列 session を一目で区別できるようにしました。interactive 推奨フロー doc でも traceary top を最初の live 確認コマンドとして紹介します。
• SessionSummary に latest event metadata を追加 (#793) — list_sessions.sql / list_session_tree.sql / session_lineage.sql に latest_events window function CTE を追加し、LatestEventKind / LatestEventMessage を 1 query で取得します。tie-breaker は created_at DESC, id DESC、新規 index idx_events_session_created_at_id_desc を追加しました。body は ExtractPlainBody を必ず通すため transcript の thinking block は message に到達しません。MCP session_status payload は新 field を露出しないことをテストで担保します。

Performance

• list_sessions を集計前に pagination する (#793) — LIMIT / OFFSET を filtered_sessions CTE 内に push down し、event 集計が呼び出し側が要求した page 分の session にだけ走るようにしました。

[v0.10.2] - 2026-04-26

Fixed

• Hook audit / subagent-stop test の時間爆弾 — TestRootCLI_HookAuditCommand_UsesActiveSubagentSession と TestRootCLI_HookSubagentStopCommand_EndsChildAndClearsActiveState の started_at がハードコードされており、24 時間 TTL (hookActiveSubagentStateTTL) を超えると pruneHookActiveSubagentState がアサート前に状態をクリアして失敗していました。v0.10.1 の Homebrew formula PR の CI で発覚。time.Now().UTC() を使う形に修正し、常に TTL 内に収まるようにしました。

[v0.10.1] - 2026-04-26

Fixed

• Agent tool 名に対する PreToolUse subagent capture (#785) — Claude Code の plugin hook が PreToolUse:subagent-start で Task|Agent を matcher に取るよう修正しました。以前は Task のみを受け付けていたため、現行の Claude Code が Agent という tool 名で dispatch する subagent 呼び出しが active-subagent state file も子 session 行も生成せずに通過していました。v0.10.0 リリース後の dogfooding (#778) で発見しました。

[v0.10.0] - 2026-04-26

Added

• Bundle manifest v2 skeleton (#737) — bundle export は events の table registry entry (table_name, file, row count, SHA-256 checksum) を含む manifest_version=2 を書き出します。import は v1 reader path を維持し、bundle import に --on-conflict {skip,replace,error} と予約済みの --missing-parent {reject,skip,backfill} flag を追加しました。
• Bundle durable memories (#739) — bundle export は scope、validity、supersession、evidence refs、artifact refs を含む memories.ndjson を追加します。bundle import は memories_imported / memories_skipped を表示し、新規 import された memory は source が accepted でも review 必須の candidate（candidate trust default）として保存するため、cross-machine の memory trust が自動昇格しません。
• Marketplace release manifest verification (#713) — scripts/verify_release_manifests.py が Claude/Codex marketplace manifest の存在と、Claude / Gemini / Codex plugin manifest の version が root の VERSION と一致することを検証します。CI、release workflow、make release/bump が公開前にこの guard を実行します。
• traceary doctor の sectioned output (#734) — doctor report を Environment / Database / Plugins / MCP / Hooks に分類し、JSON に additive な sections / summary / exit_code を追加しました。check severity は PASS / WARN / FAIL に正規化し、終了コードは all pass = 0、fail あり = 1、fail なし warning あり = 2 です。
• Experimental Anthropic native memory-tool backend (#742) — pkg/anthropicmemory が Anthropic SDK の BetaMemoryTool20250818CommandUnion payload を受け取り、Traceary local の memory_tool_files table を backend にした SDK tool_result content を返す Go handler を公開します。tool contract は memory_20250818 に pin し、upgrade は SDK field の自動 bump ではなく manual review 必須です。live API smoke 用 example は examples/anthropic-memory/ にあります。

Docs

• README と Claude plugin docs は、削除済みの claude plugins install CLI 表記ではなく Claude Code の /plugin marketplace add → /plugin install flow を案内します。
• docs/release/README.{md,ja.md} に release manifest verification と、version drift 時の make release/bump VERSION=X.Y.Z 修正手順を追加しました。
• docs/integrations/anthropic-memory-tool.{md,ja.md} — native memory tool と Traceary MCP manage_memory の使い分け、path traversal / size limit の threat model、SDK wiring、storage inspection / backup、experimental status、version pinning を説明します。docs/integrations/agent-sdks.{md,ja.md} は誤っていた Python lock-in 理由を削除し、native Go backend へ link します。

Breaking changes

• MCP tool 統合 (#708, breaking) — MCP server が公開する tool はちょうど 8 個になりました。旧 24 tool 名は削除し、action parameter dispatch に移行しました:

  旧 tool	新しい呼び出し
  propose_memory	manage_memory(action="propose", ...)
  remember_memory	manage_memory(action="remember", ...)
  accept_memory	manage_memory(action="accept", ids="<id>", ...)
  reject_memory	manage_memory(action="reject", ids="<id>")
  expire_memory	manage_memory(action="expire", ids="<id>", ...)
  supersede_memory	manage_memory(action="supersede", target_id="<id>", fact="...", ...)
  set_memory_validity	manage_memory(action="set_validity", ids="<id>", valid_from="...", valid_to="...", ...)
  import_memory_instructions	manage_memory(action="import_instructions", ...)
  accept_memories_batch	manage_memory(action="accept", ids=[...], ...)
  reject_memories_batch	manage_memory(action="reject", ids=[...])
  retrieve_memories	query_memory(action="retrieve", ...)
  export_memories	query_memory(action="export", ...)
  memory_pack	query_memory(action="pack", ...)
  scan_memory_hygiene	query_memory(action="scan_hygiene", ...)
  start_session	manage_session(action="start", ...)
  end_session	manage_session(action="end", ...)
  active_session	session_status(action="active", ...)
  latest_session	session_status(action="latest", ...)
  session_handoff	session_status(action="handoff", ...)
  add_log	record_event(type="log", ...)
  add_audit	record_event(type="audit", ...)
  list_events	list_events(...)
  search	search(...)
  get_context	get_context(...)

• CLI JSON timestamp と duration の freeze (#729) — golden fixture を記録する前段として、CLI --json のすべての timestamp フィールド (created_at / started_at / ended_at / valid_from / valid_to 等) を UTC RFC3339Nano (YYYY-MM-DDTHH:MM:SS[.nnnnnnnnn]Z) に統一。traceary session tree --json は duration_ms を削除し duration_sec のみを保持。traceary timeline --json は string duration を numeric duration_sec に置き換え。

[v0.9.0] - 2026-04-25

マイナーリリース: multi-host local memory substrate completion (v1.0 前の安定化)。v0.9 では v1.0 スコーピング前の portability + 構造ギャップを埋めます。CLI のトップレベル整理、durable memory への additive な temporal graph overlay、暗号化済みクロスマシン event バンドル、agent SDK 統合 docs の整備が中心です。

Added

• Memory graph overlay (#573) — additive な memory_edges テーブルで、既存 memory ストア上に型付き関係 (supersedes / contradicts / supports / related-to / causes) を重ねます。各 edge は自身の半開区間 [valid_from, valid_to) を持ち、--as-of クエリが memory validity と合成できます。traceary memory graph add <from> --to <id> --relation <type> と traceary memory graph list [--memory-id <id>] [--relation <type>] [--as-of <ts>]。migration 000013 + 複合 partial index 追加。SQLite が主ストアのまま、graph DB 依存はなし。完全な評価は docs/architecture/temporal-memory.ja.md を参照。
• 暗号化可搬バンドル (#572) — traceary bundle export --out <path> が XChaCha20-Poly1305 アーカイブ (Argon2id で鍵導出) を出力。任意の transport (AirDrop / scp / Syncthing / iCloud — すでに AEAD 暗号化済みのため) で運べます。traceary bundle import は冪等 (UNIQUE 衝突は events_skipped カウント)。v0.9 では events のみ。sessions / audits / memories / edges は #702 に follow-up。
• Agent SDK 統合 docs (#571 + #564-A) — docs/integrations/agent-sdks.{md,ja.md} で Claude Agent SDK / OpenAI Agents SDK / Google ADK を検証済みの MCP 統合例とともに整理。Python コードは追加なし — traceary mcp-server が canonical path。Anthropic native memory-tool backend は #699 で v0.10 defer。

Changed

• CLI トップレベル再整理 (#696) — 管理系を store 配下へ移動 (store init、store backup create/restore、store gc)、session ブートストラップ系を session 配下に集約 (session handoff、compact-summary を置き換える session handoff --compact-only)。トップレベル数 22 → 16。旧 top-level init / backup / gc / handoff / compact-summary は deprecated alias として動作し続けますが、deprecation 通知は stderr にだけ送られます (v0.8.x のスクリプトで stdout が byte-for-byte 互換)。--help のリストからは隠されます。alias は v1.0 で削除予定。

Dependencies

• github.com/pelletier/go-toml/v2 2.2.4 → 2.3.0
• golang.org/x/mod 0.34.0 → 0.35.0
• golang.org/x/sys 0.42.0 → 0.43.0
• modernc.org/sqlite 1.48.2 → 1.49.1
• 新規: golang.org/x/crypto (Argon2id + XChaCha20-Poly1305 を bundle 暗号化に使用)

Docs

• docs/architecture/temporal-memory.{md,ja.md} — temporal graph 評価 + 最小 overlay 設計。
• docs/integrations/agent-sdks.{md,ja.md} — SDK MCP 統合マトリクスと example。
• docs/operations/cross-machine-handoff.{md,ja.md} — bundle export/import フロー、transport 推奨、schema 安全ルール。
• CLI リファレンスで session handoff / store * を canonical 表記として案内、旧パスは deprecated として記録。

v0.9.0 に含まれる作業項目

• #696 v0.9-5 CLI subcommand 再整理
• #573 v0.9-3 temporal knowledge graph 評価 + 最小 overlay
• #571 v0.9-1 OpenAI Agents SDK / Google ADK 統合評価
• #564 v0.9-4 Claude Agent SDK 統合 (MCP 経路。native memory-tool backend は #699 へ split)
• #572 v0.9-2 暗号化 bundle export / import (events)

Follow-up

• #699 — v0.10 で Anthropic native memory-tool backend を再評価
• #702 — v0.10 で bundle を sessions / audits / memories / edges に拡張

[v0.8.2] - 2026-04-24

v0.8.1 quality phase で見つかった tech-debt をまとめた patch リリース。transcript の search が thinking block 本文を漏らさなくなり、MCP `list_events` は plain-text projection に加えて canonical block 形も返すようになり、`--source-hook` フィルタは複合 index を使い、`presentation/cli/doctor.go` は `infrastructure/filesystem` を直接 import しなくなりました。

Added

• MCP `list_events` / `add_log` が `body_blocks` を返す — canonical transcript envelope は構造化された `[{type, text}, ...]` として公開されるので、プログラム的コンシューマは transcript を round-trip したり独自の block-aware renderer を書けます。既存の `body` フィールドは plain-text projection (thinking は含まない) を返し続けます。`search` と `get_context` は意図的に `body_blocks` を省略します (これらのサーフェスで thinking block の内容が漏れないようにするため)。
• source_hook 用 SQLite 複合 index — migration 000012 が既存の `idx_events_source_hook` を落として `idx_events_source_hook_time (source_hook, created_at DESC, id DESC) WHERE source_hook IS NOT NULL` に置換。primary-only query と legacy-fallback UNION ALL query の分離と合わせて、`traceary list --source-hook ` が covering index scan を使うようになり、created_at 順スキャンを in-memory でフィルタしていた旧挙動が解消されました。

Changed

• `application` に plugin / hooks inspector の契約を追加 — `application.PluginCacheInspector` + `PluginCacheStatus`、`application.ClaudePluginDetector` + `ClaudePluginDetection`、および `application.HooksInspector` の `ExtractManagedKeyFromEntry` メソッド。`presentation/cli/doctor.go` と `claude_plugin_detection.go` は `infrastructure/filesystem` を直接 import する代わりにこれらの interface 経由で利用するようになり、v0.8.1 quality phase で指摘された hexagonal の依存方向違反を解消しました。

Fixed

• `traceary search` が thinking-only match をスキップ — v0.8.1 で `ExtractPlainBody` は表示面から thinking block を除外していましたが、SQL search は生の envelope に対して `body LIKE ?` を走らせていました。結果、thinking block 内にだけマッチする検索は、表示が空の行を返し、内部推論を search 面に漏らす形になっていました。SQL は canonical envelope に対して `json_each` で text block だけを取り出した射影に対して `LIKE` を走らせるようにしました (`typeof()` guard が `DecodeCanonicalEnvelope` と同等の契約を保証します)。legacy plain-text row と非 envelope JSON は従来通り生で searchable のままです。
• Gemini CLI smoke 警告 — `scripts/smoke_test_integrations.sh gemini` は `~/.gemini/projects.json` に `{}` を書いていました。Gemini CLI 0.38 は `{"projects":{}}` を期待しており、`ProjectRegistry.getShortId` が cleanup 中に throw するため、smoke 出力に `Early cleanup failed` / `Tool output cleanup failed` が 2 件ずつ出ていました。正しい shape を書けば smoke coverage を弱めずに警告を黙らせられます。

v0.8.2 に含まれる作業項目

• #682 transcript JSON envelope 内の thinking block を search から除外
• #683 `--source-hook` フィルタで source_hook index が使われるように修正
• #684 MCP list_events / add_log に body_blocks 追加
• #685 doctor が infrastructure/filesystem を直接 import しないように refactor
• #536 gemini smoke cleanup warning を silence

[v0.8.1] - 2026-04-24

hook の出処記録、transcript の構造化、validity 精度 を中心にした patch リリース。新しい events.source_hook 列が各イベントを生成した host 側 hook を正確に記録し、transcript / prompt の body は thinking と text を分離した構造化 JSON ブロックとして保存され、SQLite の memory validity フィルタは小数秒を落とさなくなったので半開区間 [valid_from, valid_to) の境界が正しく動きます。

Added

• events.source_hook — 各イベントに、それを生成した hook 識別子 (stop、subagent_stop、pre_compact、post_compact、session_start、session_end、user_prompt_submit、post_tool_use、after_agent、after_tool) が付きます。hook 以外の書き込み (traceary log、MCP add_log) は NULL のままです。traceary list --source-hook <name> と MCP list_events の source_hook パラメータで絞り込め、traceary show、list --wide、list --json、list --fields source_hook、context、replay HTML すべてで表示されます。v0.8.0 以前の [phase:subagent] / [phase:pre-compact] body prefix row も、移行期間の fallback で同じ名前のフィルタに引っかかります。
• transcript / prompt body の block 化 — 補助アシスタント transcript とユーザー prompt は {"blocks":[{"type":"thinking","text":"..."},{"type":"text","text":"..."}]} という JSON envelope で保存されるようになりました。block-aware なコンシューマは内部推論とユーザー向け回答を分離できます。legacy のプレーン文字列 row はそのまま round-trip します。envelope 形ではない任意の JSON body (例: {"foo":"bar"} の note) も手を加えずに保持されます。
• memory supersede --from / --to — CLI と MCP supersede_memory が置換先 memory の validity 境界を明示できます。valid_to < valid_from は set-validity と同じロジックで拒否します。
• plugin cache multi-version warning — doctor の stale チェックに、Claude plugin cache に複数バージョンの Traceary が共存しているとき (resumed session で claude plugins update を走らせた直後に起きがち) の警告を併合しました。fresh session で起動し直すガイダンスを返します。

Changed

• memory validity timestamp の保存形式 — valid_from / valid_to は固定長 9 桁 nano に正規化され、SQLite の辞書順比較が time.Time の比較と完全に一致するようになりました。v0.8.1 より前の row は migration 000010 で一度だけ書き換えます。validity フィルタは datetime() ラップを外したので partial index idx_memories_valid_window が実際に使われます。
• MemoryUsecase.Supersede が validity を継承 — memory hygiene apply の supersede 遷移では、caller が明示的に上書きしない限り、置換先 memory が元の [valid_from, valid_to) 窓を引き継ぐようになりました。以前は捨てていて、validity_overlap_supersede が自己矛盾を作っていました。
• hook body-prefix marker を write 側で廃止 — hook_runtime は session_ended に [phase:subagent] を、compact_summary に [phase:pre-compact] を付けなくなりました。代わりに source_hook が lifecycle を識別します。reader は v0.8.1 より前の row のために prefix fallback を維持します。

Fixed

• 非 canonical な --traceary-bin basename — hooks install --upgrade と doctor が、パッケージ済みバイナリが非 canonical なパス / basename (symlink、/usr/local/bin/traceary-dev、Homebrew cellar パス) にあるときでも Traceary-managed なコマンドを正しく認識します。以前の build は「追加」「削除」summary の誤報を出していました。

Docs

• CHANGELOG 本ファイル (en / ja).

v0.8.1 に含まれる作業項目

• #662 transcript / prompt body の JSON block 構造化
• #664 SQLite memory validity フィルタの小数秒脱落
• #665 MemoryUsecase.Supersede が valid_from / valid_to を伝播しない
• #666 Log redaction の統合
• #667 非 canonical な --traceary-bin basename の検出
• #670 doctor plugin-cache の active-snapshot / cache 不一致検出
• #672 events.source_hook 列 (書き込み側)
• #679 source_hook 読み取り側 — CLI / MCP filter + JSON field + replay HTML + body prefix marker retire

[v0.8.0] - 2026-04-22

replay UX / 時間的 memory / transcript 取得 を中心にしたマイナー: オペレーターが共有できる self-contained な replay HTML、memory ごとの有効期間窓、Claude Code / Codex CLI / Gemini CLI 全部の assistant 応答 transcript 取得。加えて Claude Code の 2026-Q2 hook (SubagentStop / PreCompact) を wire し、traceary hooks install / doctor の UX を締め直しています。

Added

• Replay export — traceary replay --out <path> で inline CSS・外部アセットなしの self-contained HTML を 1 ファイルで書き出します。4 パネル (Sessions / Timeline blocks / Failure hotspots / Durable memories) と generated-at footer 構成。--sessions / --events-per-session / --memories / --timeline-blocks / --hotspots で各パネルの件数制御。timeline と hotspot は traceary timeline / traceary list --failures-only と同一意味なので相互参照できます。
• transcript event — 最終 assistant 応答を記録する新 event kind。Claude Code Stop (JSONL transcript_path) / Codex CLI Stop (last_assistant_message) / Gemini CLI AfterAgent (prompt_response) の 3 hook で発火。本文には built-in redactor とオペレーター設定の redact.extra_patterns が適用されます。
• Memory の時間的有効期間 — accepted memory は [valid_from, valid_to) の half-open window を保持。traceary memory set-validity --from / --to / --clear-to で窓を設定、traceary memory list --as-of YYYY-MM-DD や MCP session_handoff / memory_pack が窓でフィルタするため任意時点へ time-travel した retrieval ができます。
• Memory retrieval preset — traceary memory list --preset resume | review | incident と MCP session_handoff / memory_pack に built-in の type / confidence / limit preset。read.presets のユーザー定義で同名を上書き可能。明示的な filter フラグは preset より優先。
• Memory hygiene detector — memory hygiene scan に validity_overlap_supersede を追加 (validity 窓を annotation した pair が重なるケース)。半開区間で disjoint な pair は historical fact として汎用 supersede_candidate からも除外されます。
• Claude Code SubagentStop + PreCompact hook — traceary hook subagent-stop claude と traceary hook compact claude pre-compact で wire。SubagentStop は session_ended + [phase:subagent] prefix、PreCompact は compact_summary + [phase:pre-compact] prefix として記録。loadCompactSummary が prefix を skip するので handoff / memory_pack は引き続き post-compact summary を返します。
• PostToolUse matcher 拡張 — Claude hook install が Bash / mcp__.* に加えて Read | NotebookRead | Edit | MultiEdit | Write | NotebookEdit | Grep | Glob | Agent | Task | TodoWrite | WebFetch | WebSearch | ExitPlanMode を監査対象に。Claude Code 組み込みツールの利用をすべて audit できます。
• hooks install --upgrade — 非破壊マイグレーション。Traceary 管理分だけ置換、ユーザー追加分は保持、旧 event entry は strip、追加 / 更新 / 保持 / 削除の内訳を印字。--force とは排他。
• hooks install --matcher <preset> — PostToolUse の matcher preset minimal (Bash + mcp__.*)、default (+ v0.8-6 で追加された組み込みツール一覧。packaged install と同じ)、all (+ .*) の 3 つ。--matcher を省略すると default。
• doctor の新 check — claude-plugin-cache (cached plugin version vs marketplace manifest を semver 比較、古い場合は claude plugins update を案内) と <client>-host-capabilities (2026-Q2 のホスト機能を informational に表示)。
• MCP 追加分 — add_log に redaction (built-in + extra_redact_patterns) が適用、session_handoff / memory_pack に as_of (時間 travel)、retrieve_memories が retrieval preset 対応。

Changed

• Read-only usecase を application 層に — ContextUsecase / ReplayUsecase が queryservice.* を直接消費する設計になり、CLI / MCP は共通 builder を使用。Presentation 層で zero-value usecase を構築する fallback は削除。
• Event body phase marker 共通化 — domain/types/event_body_markers.go に EventBodyMarkerCompactPreSnapshot / EventBodyMarkerSubagentStop を一元定義。kind を増やさず body prefix で phase を表現する方針なので下流消費は backwards-compatible。
• Redaction leaf package — application/redaction を write-side usecase に依存しない leaf package に整理。transcript / add_log 取り込みと traceary log / hook audit で同じ redactor 集合を共有。
• Codex Stop の実行順序 — packaged Codex hook は hook transcript codex を先に、hook session codex stop を後に実行 (session-stop が workspace state file を clear するため、transcript は先に発火させて persisted workspace を使う)。

Fixed

• transcript redaction parity — hook_runtime.go と MCP add_log が extra_redact_patterns を適用するようになり、audit path と同等のポリシーに。以前は transcript 本文だけ組織固有 secret shape が漏れていました。
• CLI と MCP の null shape — JSON 出力で CLI が null / MCP が "" (あるいは逆) で食い違っていたフィールドを統一。空文字は省略、明示的 null は "未設定" 意味に固定。
• doctor の pseudo-version semver 比較 — Go の pseudo-version (v0.7.3-0.YYYYMMDDhhmmss-abc...) を最新 release tag と semver 比較。dev build は "newer than the latest release" と報告されるようになりました。
• doctor の plugin cache 古さ検出 — cached plugin manifest と marketplace manifest を読んで、cached が古ければ warn + claude plugins update を案内。
• Hooks merge で --matcher だけ変更された pair — managed key 比較に matcher も含めるようになり、preset 変更 (同 event・別 matcher) は Refreshed として扱われます。

Docs

• docs/hooks/contract{,.ja}.md の三層 capability 表が transcript の新挙動と 2026-Q2 host-capability 付録を反映 (SubagentStop / PreCompact / Codex last_assistant_message / Gemini AfterAgent がすべて wire 済み)。
• docs/integrations/codex-plugin{,.ja}.md と docs/integrations/gemini-extension{,.ja}.md の「自動で組み込むもの」セクションに transcript hook を列挙。
• docs/cli/README{,.ja}.md に --upgrade, --matcher, --timeline-blocks, --hotspots, --as-of, --preset を該当コマンド配下で記載。

Included work items for v0.8.0

• #566 v0.8-4 memory block 構造の評価
• #565 v0.8-3 temporal validity
• #606 v0.8-7 Claude Stop で transcript 取得
• #605 v0.8-6 PostToolUse matcher 拡張
• #570 v0.8-5 memory retrieval preset
• #563 v0.8-1 replay export
• #624 v0.8 quality-phase polish
• #625 v0.8-followup redaction leaf package 化
• #619 v0.8-followup transcript → memory extraction + MCP 説明
• #629 v0.8-followup SetValidity の CLI/MCP テスト
• #635 v0.8-followup propose_memory SKILL.md の誘導
• #640 v0.8-followup transcript kind の整合
• #633 v0.8-followup doctor plugin cache version check + upgrade docs
• #634 v0.8-followup doctor pseudo-version の semver 比較
• #626 v0.8-followup transcript extra_redact_patterns
• #628 v0.8-followup CLI / MCP の JSON null shape
• #617 v0.8-followup as_of ContextPackCriteria
• #648 v0.8-followup MCP add_log redaction
• #621 v0.8-followup PostToolUse matcher 2026-Q2
• #632 v0.8-followup hooks install --matcher preset
• #654 v0.8-followup monitoring UX agent を default に
• #637 v0.8-followup hooks install --upgrade flag
• #616 v0.8-followup auto-supersede heuristic (validity_overlap_supersede)
• #627 v0.8-followup replay bundle を application 層へ
• #636 v0.8-followup SubagentStop + PreCompact hook
• #630 v0.8-followup replay timeline + failure-hotspot panel
• #631 v0.8-followup transcript Codex / Gemini parity
• #666 v0.8.0 Log の redaction を EventUsecase 側に集約 (AuditRedaction と対称化)
• #667 v0.8.0 非 canonical な --traceary-bin basename を name prefix で認識

[v0.7.2] - 2026-04-20

v0.7.1 の実運用で判明した tail polling の SQLITE_BUSY、audit 二重記録、hook install UX の問題を一括で潰す operational-safety hotfix です。

追加

• traceary hooks install --global で user-level config (~/.claude/settings.json / ~/.gemini/settings.json) へ書き込めるようにしました。Codex は元から user-level なため --global は no-op 通知を出して続行します。--global は --output と排他で、HOME が相対パスの場合は拒否します。
• traceary doctor に <client>-global-config check を追加 (Claude / Gemini)。従来の project-level <client>-config と併せて両 scope の状態が一度に確認できます (Codex は既に user-level なため対象外)。

修正

• SQLite DSN に journal_mode=WAL / synchronous=NORMAL / busy_timeout=5000 を有効化し、traceary tail の poll が短命な hook write にブロックされない / 一時的なロック競合は自動で retry される構成にしました。
• traceary hooks install --client claude は ~/.claude/settings.json の enabledPlugins を参照して Traceary Claude Code plugin が有効な状態では install を skip し通知します。plugin + settings.json の二重登録で audit が 2 回記録される問題を解消。--force で plugin 開発時の両方登録を明示許可できます。
• traceary doctor --client claude は plugin + settings の二重登録を warn として報告し、plugin 有効時でも project 側の settings が破損していれば fail を維持します (従来は silent pass でした)。

ドキュメント

• docs/hooks/README{,.ja}.md に --global / plugin-skip 挙動 / 追加された doctor check を記載。
• docs/operations/README{,.ja}.md に新 SQLite pragma と WAL sidecar の扱いを追記。
• docs/backup/README{,.ja}.md に live DB を sidecar (<db>-wal / <db>-shm) なしでコピーした場合の注意を追加。
• docs/integrations/claude-plugin{,.ja}.md に plugin 導入時は hooks install 不要である旨を記載。
• docs/cli/README{,.ja}.md の hooks install セクションに --global を追加。

対応 issue

• #607 v0.7.2-1 SQLite DSN WAL + busy_timeout
• #603 v0.7.2-2 hooks install / doctor plugin-aware dedup
• #604 v0.7.2-3 hooks install --global + doctor global-config check

[v0.7.1] - 2026-04-20

v0.7 の Multi-AI レビューと v0.7.0 リリース workflow で洗い出された穴を塞ぐ patch リリースです。

追加

• traceary memory hygiene scan --similarity <N> に新 suggestion kind supersede_candidate を追加。同 scope で fact text は異なるが単語 Jaccard 類似度が閾値 (既定 0.6) 以上のペアを検出し、古い方を supersede 対象、新しい方の fact を置換テキストとして提案 (replacement_memory_id / replacement_fact / similarity)。memory hygiene apply --ids は MemoryUsecase.Supersede 経由で scope / type / refs を継承しつつ置換を適用。
• MCP export_memories (read-only) を追加。accepted memory を CLAUDE.md / AGENTS.md / GEMINI.md 形式の markdown として返し、agent host からファイルシステム経由でなくとも bridge を扱えるように。MCP import_memory_instructions は path / inline markdown のいずれかを受け取り candidate を propose する。

変更

• Bridge marker parser が :v<N> 形式の任意バージョンを regex でマッチするようになり、binary の既知最大版を超える :v<N> は警告を出す。exporter は引き続き :v1 を書き出し、CLI の merge helper は新しいブロックを古いバイナリで上書きできないよう refuse するので、将来の :v2 コンテンツが静かに失われることはない。
• Release workflow の umbrella auto-close matcher が、push された tag が vX.Y.0 形式のときに minor-version の title prefix (v0.7: ...) も受理するように拡張。将来の minor リリースで umbrella が自動 close される。

修正

• release workflow の git tag validation が ${{ inputs.tag }} を shell へ直接展開していた GitHub Actions injection 形状を env 経由に変更。
• mergeMemoryExportIntoExistingFile の marker regex に行頭アンカーを追加し、prose (例: 手書きドキュメント内で marker 文字列に言及しているケース) が managed block として誤認されないように。
• import_memory_instructions MCP tool の annotation を DestructiveHint: false に修正 (propose_memory と同様、candidate を追加する additive write)。

対応 issue

• #592 v0.7.1-1 release workflow matcher
• #593 v0.7.1-2 similarity-based supersede suggestion
• #594 v0.7.1-3 MCP export / import instructions tools
• #595 v0.7.1-4 bridge marker :v<N> forward-compat parsing

[v0.7.0] - 2026-04-20

Codex 標準化 + durable-memory governance リリースです。read UX (configurable columns / preset / color highlight / session follow) を進めつつ、Codex と subagent lineage の一級 capture を追加し、durable memory を inbox review / host ファイル双方向 bridge / hygiene ツールを備えた governed substrate に昇格させました。

追加

• traceary memory import codex で ~/.codex/memories/MEMORY.md の User preferences / Reusable knowledge / Failures セクションを file evidence ref 付きの candidate として取り込み
• traceary memory inbox list / accept --ids / reject --ids と MCP accept_memories_batch / reject_memories_batch で candidate レビューを完結
• traceary memory export --target <claude|codex|gemini> --out <path> で accepted memory を <!-- traceary-memories:begin:v1 --> マーカー付き markdown として deterministic に書き出し、既存の手書きセクションは保持したまま管理ブロックのみを置換
• traceary memory import instructions --source <...> --in <path> で CLAUDE.md / AGENTS.md / GEMINI.md からの候補取り込みをサポート (marker 内は重複回避のため skip)
• traceary memory hygiene scan が redaction_hit / expiry_candidate / duplicate を提案、memory hygiene apply --ids で該当 transition を commit、MCP scan_memory_hygiene が読み取り専用で mirror
• traceary tail --follow-session <prefix> で特定 session の tailing (最低 8 rune、UUID 対応)
• traceary session tree JSON に parent_session_id / depth / duration_ms / subagent_type を追加、text 行に subagent role と N cmds / M events、--root <session-id> で subtree フォーカス、--ongoing-only で active lineage のみ
• traceary tail / list / search に --fields (列順指定)、--preset (built-in: failures / prompts-only / compact-summaries + user-defined)、--color=auto|always|never highlight を追加 (NO_COLOR + terminal-injection 対策込み)
• Codex hooks が UserPromptSubmit をサポート、公式 Plugin Directory レイアウトに準拠
• traceary doctor に <client>-host-capabilities informational check を追加し、2026 Q2 時点の host 機能ギャップ (Claude SubagentStop / PreCompact、Codex memory feature flag、Gemini 0.38.x memory-manager preview) を surface
• MCP tool metadata / annotations 監査で Tool Search 時代に適合

変更

• Codex 標準化 (v0.7-1) により Codex 統合が /plugins フローと Plugin Directory 規約に一致
• Read コマンドのデフォルト出力は fields / preset / color サーフェスで駆動 (--wide --utc は v0.6.1 バイト一致を維持)
• durable-memory の list criteria が Sources() を SQLite 層まで push-down し、inbox の --source が pagination 正しく動作

修正

• traceary memory import codex が symlink した MEMORY.md を EvalSymlinks 解決前の Lstat で拒否 (memory root 内の他ファイルへのリダイレクトを防ぐ)
• Bridge import の dedupe 事前ロードで実 SQLite が要求する limit>=1 を遵守 (Codex memories import 側の latent bug も同時修正)
• memory export --out が既存の CLAUDE.md / AGENTS.md / GEMINI.md の手書きセクションを破壊しなくなり、管理マーカー部分のみを置換
• tail --follow-session が filter 前の unfiltered batch で cursor を前進させるため、非一致 session の trafic が scan 窓を塞がない
• session tree --ongoing-only が status=stale セッションを除外 (end event が無いことを理由に ongoing 扱いしていた問題)
• sanitizer / size-guard / parser の堅牢性を memories import / bridge import 経路でまとめて改善

対応 issue

• #551 v0.7-1 Codex plugin directory
• #575 v0.7-2 Codex UserPromptSubmit capture
• #576 v0.7-3 Codex memories import
• #552 v0.7-4 host matrix / doctor / smoke refresh
• #553 v0.7-5 tail / list / search の configurable columns
• #554 v0.7-6 saved view presets
• #555 v0.7-7 highlight / color with NO_COLOR support
• #556 v0.7-8 tail --follow-session
• #557 v0.7-9 durable-memory review inbox
• #560 v0.7-10 CLAUDE.md / AGENTS.md / GEMINI.md bridges
• #561 v0.7-11 subagent lineage in session tree
• #568 v0.7-12 durable-memory hygiene (redaction / expiry / duplicate)
• #569 v0.7-13 MCP tool metadata / annotations audit

[v0.6.1] - 2026-04-15

tail / list / search / timeline のターミナル視認性を改善したリリースです。

追加

• traceary timeline の workspace ごとのサブロウ表示と、compact_summary → 最初の prompt → kind count フォールバック順で選ばれるアクティビティ要約、さらに JSON 出力の workspace_breakdown 配列
• tail / list / search / timeline のテキスト出力に --utc フラグを追加（デフォルトは現地時刻のまま）
• presentation/cli/event_text_formatter.go を共通ヘルパーとして新設し、compact / wide 行フォーマッタや timestamp / session / workspace の短縮ロジックを tail, list, search で共有
• docs/cli/README.md / docs/cli/README.ja.md に traceary timeline セクションを追加。トップレベル README には「直近の動きを確認する」セクションと tail / timeline の使用例を追加

変更

• traceary tail, traceary list, テキストモードの traceary search のデフォルト出力を、約 100 カラムに収まる 1 行コンパクト形式 (HH:MM:SS kind sess=<先頭8文字> ws=<basename> message、現地時刻) に変更。--wide で従来の 7 カラム tab 区切りを復元でき、--wide --utc を組み合わせると v0.6.1 以前の出力をバイト単位で再現
• traceary timeline のブロックヘッダに total events: ラベルを追加

修正

• traceary timeline が workspace 空の legacy 行を breakdown や JSON workspaces 配列に漏らさないように修正
• traceary timeline で whitespace-only な compact_summary / prompt body が同一ブロック内の後続有効サマリ候補を上書きしていた問題を修正

対象イシュー

• #538 compact tail output with local TZ
• #539 timeline activity summary with per-workspace breakdown
• #540 add README examples for tail and timeline workflows
• #541 compact list and search output with local TZ parity

[v0.6.0] - 2026-04-14

アーキテクチャ整合性と runtime entrypoint の整理を中心に進めたリリースです。

追加

• 4 層境界、runtime entrypoint の原則、scripts/ の役割を明文化した software architecture guide
• session boundary / command audit / prompt capture / compact-summary capture を Go 側で受ける traceary hook ... サブコマンド
• Codex 向けの user-facing entrypoint である traceary integration codex install / uninstall
• maintainer 向け Python helper を go run ./cmd/repo-tooling ... へ移すための移行ガイド

変更

• packaged hook の生成先を、embedded な runtime shell script ではなく Go runtime entrypoint へ切り替えた
• repository 全体の Optional API を規約どおり Some / None / Value ベースへ移行し、旧 API は互換 alias として残した
• 代表的なテスト群で inline assertion と cmp.Diff を優先する形へ寄せた

修正

• hook runtime state の後始末を best-effort のまま安全側に寄せ、duplicate end marker や wrapper 経由の parent state をより堅牢に処理するよう改善した
• managed hook の判定、merge、Codex plugin の install/uninstall が、custom wrapper path や unrelated custom hook を壊さないよう修正した

対象イシュー

• #459 Optional[T] API の規約差分整理
• #506 software architecture 原則と runtime boundary の文書化
• #507 hook runtime logic の Go サブコマンド化
• #508 embedded runtime shell asset からの packaged hooks 移行
• #509 user-facing / maintainer workflow に残る Python 依存の整理
• #522 Codex 向け Python install helper の Go entrypoint 化
• #523 maintainer 向け Python helper の Go repo tooling への移行
• #525 Optional[T] の convention API への移行
• #527 shared Go testing convention に沿ったテスト整理

[v0.5.2] - 2026-04-14

documentation の正確性、導線、GoDoc の磨き込みをまとめたリリースです。

追加

• durable memory の考え方と運用フローをまとめた docs/memory/ の英日ガイド

変更

• storage / interactive guide を更新し、実際に出荷している tail / handoff / durable memory の挙動と一致させた
• public docs と operator 向け CLI help の workspace 用語をそろえた
• README / docs index の導線を、3 層モデル、lifecycle、hook contract、durable memory を中心に再構成した
• release/support guide を、現在の maintainer review flow と release automation に合わせて更新した
• go doc から層境界と compatibility surface を追いやすいように package/interface comment を厚くした

対象イシュー

• #500 実装済み挙動に合わせた storage / interactive docs の更新
• #501 docs と CLI help に残る workspace 用語の整理
• #502 docs 導線の改善と durable memory concept guide の追加
• #503 現在の maintainer workflow に合わせた release/support docs の更新
• #504 architecture discovery のための GoDoc package/interface comments 強化

[v0.5.1] - 2026-04-14

read-side の使い勝手改善と documentation follow-up のリリースです。

追加

• 新規イベントを追跡表示する traceary tail コマンド (NDJSON 出力対応)
• 各リリースタグの changelog カバレッジをリリース前に強制する CI ジョブ

変更

• README を 3 層 memory model と host capability マトリクスを軸に再構成
• v0.2.2 〜 v0.4.0 の changelog エントリを補完

修正

• traceary tail follow mode の各 poll window を SQLite 単一 read snapshot の中でスキャンするよう変更。並行書き込み下で OFFSET ページングがイベントを silently に取りこぼすデータ欠落バグを修正
• durable memory extraction が caller 指定 redaction パターンで正規化した後のキーで既存 fact を dedupe するようになり、extra redact pattern をローテーションしても重複候補が発生しなくなった
• artifact-ref extraction を拡張し、dotted path や末尾句読点をカバーしつつ slash-prose の誤検出を除外

対象イシュー

• #473 memory candidate 用の artifact-ref extraction 拡張
• #474 redaction パターン変更後の extracted memory dedupe
• #477 v0.2.2 〜 v0.4.0 の changelog 補完
• #478 memory model と host capability を軸にした README 再構成
• #481 Traceary event stream の live tailing
• #483 CI とリリース準備での changelog coverage 強制
• #489 並行書き込み時の tail ページング取りこぼし修正
• #490 redaction パターン正規化を検証する dedupe テスト強化
• #491 tail 境界 dedupe と From 包含契約の固定

[v0.5.0] - 2026-04-13

Durable memory と context-aware workflow を導入するリリースです。

追加

• typed scope / evidence ref / artifact ref / lifecycle を備えた first-class durable memory ドメインモデル
• durable memory の SQLite 永続化と query サポート
• durable memory 用 CLI コマンド群（remember / propose / accept / reject / supersede / expire / list / search / show / extract）
• traceary handoff / traceary session handoff / traceary compact-summary で共有する ContextUsecase ベースの structured handoff/context assembly
• MCP durable memory tools と memory-aware context retrieval
• session summary / compact summary / note・review・prompt signal からの candidate extraction

変更

• protected main 上の Homebrew maintenance PR 経路で、release workflow が GitHub App token を使うよう変更
• integration manifest と package metadata を 0.5.0 系列へ更新

含まれるイシュー

• #457 Homebrew release PR を GitHub App token 経由に変更
• #453 audit log / working memory / durable memory の 3 層モデル定義
• #460 Memory aggregate と typed memory value object の導入
• #461 durable memory の SQLite 永続化と query サポート
• #462 manual memory lifecycle usecase と CLI コマンドの追加
• #463 ContextUsecase 導入と handoff/context 意味論の統一
• #464 MCP durable memory tools と memory-aware retrieval の追加
• #465 session / compact summary からの memory candidate extraction

[v0.4.0] - 2026-04-12

timeline / prompt capture とアーキテクチャ堅牢化のリリースです。

追加

• compact_summary / prompt signal 向け EventKind 拡張と、traceary log / MCP add_log の --kind 対応
• PostCompact と UserPromptSubmit の generated hook、persisted compact-summary / prompt event の記録
• workspace 単位の活動観測に使える traceary timeline と timeline block query
• 拡張された hook surface に対応する lifecycle / privacy ドキュメント

修正

• session boundary 永続化、duplicate session 処理、compact/prompt 時の agent 解決をより防御的に改善
• hook の install/read path で危険な symlink traversal を拒否
• --db-path / TRACEARY_DB_PATH を全 subcommand で一貫して尊重
• interface 統合時に落ちていた query / input validation を復元

変更

• presentation / usecase / queryservice / sqlite wiring を multi-method interface と aggregate ごとの datasource 構成へ統合
• repository / type の責務を domain/ / application/types 側へ寄せ、domain/port を削除
• CLI / MCP の JSON/output struct、DTO、Optional 伝搬を整理

[v0.3.0] - 2026-04-11

workspace rename と consolidated-usecase アーキテクチャのリリースです。

追加

• 新しい application-layer query surface を支える Client / Workspace value object と filter criteria DTO
• Event / Session / Store の consolidated usecase interface と service-factory ベースの composition path
• 次のアーキテクチャ段階に必要な repository interface と session label サポート

変更

• hooks / CLI / docs / storage-facing API 全体で repo / work-context の概念を workspace へ改名
• datasource 構築時の DB path 注入へ移行し、presentation / MCP wiring を consolidated usecase ベースへ移行
• release checklist / dependabot / pinned actions / release-drafter split など、リリース運用まわりも更新

修正

• MCP session handoff が session_id を正しく引き継ぐよう修正
• workspace rename 後に残っていた repo 参照と generated plugin hook drift を除去
• release automation と review follow-up を tag 前に反映

[v0.2.5] - 2026-04-11

session lifecycle と queryservice cleanup のリリースです。

追加

• traceary session tree --json
• session list 日付 filter 用の --since / --until alias
• TRACEARY_PARENT_SESSION_ID 経由の parent-session 伝搬

修正

• handoff / compact-summary が要求された session filter を session lookup に正しく渡すよう修正
• session end、duplicate session start、stale-session GC、invalid parent-session 入力時の扱いをより厳密に改善
• doctor のバージョン比較で build metadata を除去してから判定

変更

• stale session close を専用 usecase に抽出
• queryservice consumer interface を domain/port へ移動
• 残っていた inline SQL を embedded .sql に抽出

[v0.2.4] - 2026-04-11

MCP audit enrich の patch リリースです。

追加

• tool_input が空のとき、MCP audit payload が tool_name に fallback

修正

• traceary doctor が Claude plugin install を正しい hook source として認識
• すでに終了済み session を終わらせたとき、黙殺ではなく warning を出すよう改善

変更

• 新しい patch release 運用に合わせて release/version-bump automation を更新

[v0.2.3] - 2026-04-11

v0.2.2 向け review-fix patch リリースです。

修正

• v0.2.2 系列に対する review follow-up を反映

変更

• Homebrew formula metadata を v0.2.2 リリース状態へ更新

[v0.2.2] - 2026-04-11

query surface の使い勝手を高める patch リリースです。

追加

• traceary list --from/--to
• traceary session list --client
• client / agent / workspace / session / kind に対応した list_events MCP filter
• traceary backup create の positional argument 対応

修正

• traceary show が command-audit event の exit_code を表示
• traceary search --failures を有効な structured search constraint として扱うよう修正
• traceary list --kind audit が command-audit event を正しく解決
• CLI date parsing と session-list date-range validation を一貫化し、逆転範囲も拒否

[v0.2.1] - 2026-04-11

v0.2.0 で残したスコープの補完リリースです。

追加

• traceary session gc コマンド（stale セッションの自動終了、--dry-run 対応）
• session_handoff MCP ツール
• traceary search --failures フラグ
• compact-summary テスト、golden file テスト
• hook 共通関数の集約

変更

• search_events SQL の go:embed 外出し
• goreleaser の formula 生成修正（skip_upload: true）
• release workflow に Homebrew PR の auto-merge 追加

[v0.2.0] - 2026-04-11

コンテキスト保全と本番運用対応のリリースです。

追加

• compact/clear 後の自動コンテキスト保全（PostCompact + SessionStart hooks）
• traceary compact-summary コマンド（LLM不要のコンテキストポインタ生成）
• traceary session handoff コマンド（簡潔なセッション状態サマリー）
• traceary session tree コマンド（親子セッション階層の可視化）
• traceary list --failures フラグ（失敗コマンドのフィルタ表示）
• exit_code カラム追加（マイグレーション 000005）
• traceary doctor のバージョンチェック
• Hook contract ドキュメント（Claude/Codex/Gemini の能力ティア定義）
• 統合 contract テスト、マイグレーション回帰テスト

変更

• Gemini CLI の AfterTool を全ツール対応に拡張
• 24h 超の active セッションを stale として表示
• README を CLI ファーストのインストールフローに再構成
• Makefile を英語化 + ターゲット追加
• テスト名を全て日本語から英語に移行
• リポジトリインターフェースを domain/port に移動
• list_sessions の SQL を go:embed ファイルに外出し

含まれるイシュー

#236-#254（20件、#255 は合理的にクローズ）

[v0.1.19] - 2026-04-10

この release では、CLI の可視性を高め、redaction を黙って弱める config 異常を見えるようにし、hook asset の重複管理を解消しました。

追加

• traceary doctor が config.json の状態を missing / loaded / unreadable / invalid で判別して表示
• 壊れた config により追加 redaction パターンが無効化されるとき、CLI / MCP の config 読み込みで警告を表示
• hook script の改行正規化と required flag セットアップ挙動の回帰テスト

修正

• traceary session list の text / JSON 出力で label / summary / parent_session_id を一貫して表示
• traceary session label と session list の拡張メタデータを CLI docs / top-level docs に反映
• セッションメタデータの表形式出力で tab / newline を正規化し、ターミナル表示崩れを防止
• package 化された hook script の改行を install 前に LF へ正規化し、Windows checkout 時の /bin/bash\r shebang 退行を防止

変更

• packaged hook asset を重複した文字列リテラルではなく、canonical な scripts/hooks/*.sh から生成するよう変更
• 残っていた Cobra required flag セットアップ時の panic を、required flag の挙動を維持したまま graceful error に置換
• 統合マニフェストのバージョンを 0.1.19 に更新

含まれるイシュー

• #219 CLI 出力と docs でセッションメタデータを一貫表示
• #220 config 読み込み失敗をオペレーターに可視化
• #221 hook script を packaging / test 共通の単一ソースに統一
• #222 残る CLI setup panic を graceful error に置換

[v0.1.18] - 2026-04-10

セッションメタデータの充実とデータ品質の向上を行いました。

追加

• sessions テーブル新設 + 既存 events からのバックフィルマイグレーション
• traceary session label <text> --session-id <id> コマンド — セッションにラベルを付与
• session list --label フィルタ
• traceary session end --summary フラグ — セッション終了時にサマリーを記録
• traceary session start --parent-session-id フラグ — サブエージェントの親子関係を記録
• Claude Code hooks で MCP ツール呼び出し（mcp__.*）を記録
• Gemini CLI ワンコマンドインストールスクリプト

修正

• audit hooks でセッション開始時の repo を永続化し、CWD ベースの repo drift を防止
• MCP ツール呼び出し時に tool_name へ fallback するよう audit スクリプトを改善
• 日付バリデーションを queryservice 層に集約（infra 層の冗長なバリデーションを除去）
• doctor 設定チェックの localizef 引数過剰を修正

変更

• session list クエリを sessions テーブル主体に書き換え（events JOIN で集計）
• SessionSummary DTO に label/summary/parent_session_id を追加
• 統合マニフェストのバージョンを 0.1.18 に更新

含まれるイシュー

• #196 日付バリデーションの queryservice 層集約
• #200 hooks による MCP ツール呼び出し記録
• #201 セッションにラベル/タスク名を付与
• #202 セッション間の親子関係を記録
• #203 repo フィールドの正規化
• #204 セッション終了時にサマリーを記録
• #206 セッションメタデータモデルの導入
• #207 Gemini CLI インストール体験の改善

[v0.1.17] - 2026-04-09

マルチエージェントワークフローの改善と CLI の使い勝手向上を行いました。

追加

• traceary session list コマンド — セッションごとの集約情報（ステータス、所要時間、イベント/コマンド数、エージェント内訳）を表示
• Claude Code のサブエージェント識別 — hooks が payload の agent_type を読み取り、サブエージェント内実行時に階層的なエージェント名（例: claude/Explore）を記録
• session list の --from/--to 日付フィルタ（YYYY-MM-DD バリデーション付き）

修正

• list/search のテーブル出力で MESSAGE カラムを 80 文字に切り詰め、改行を正規化 — 長いコマンドボディによるターミナル表示崩れを防止
• DB 初期化時の chmod(0600) エラーを best-effort に変更 — read-only ファイルシステムや他ユーザー所有の DB でも読み取り系コマンドが動作

変更

• CLAUDE.md / AGENTS.md / GEMINI.md に「1 issue = 1 branch = 1 PR（例外なし）」ルールを追加
• 統合マニフェストのバージョンを 0.1.17 に更新

含まれるイシュー

• #185 list/search 出力の MESSAGE カラム切り詰め
• #186 セッションサマリーコマンド (session list) の追加
• #187 Claude Code のサブエージェント識別対応
• #188 read-only ファイルシステムでの読み取りコマンド安全化
• #194 1-issue-1-PR ルールのガードレール追加

[v0.1.16] - 2026-04-09

この release では、コード品質の改善、ユーザー設定可能な監査リダクションパターンの追加、CLI / MCP サーバー全体での debug レベル診断の充実を行いました。

Added

• ~/.config/traceary/config.json による監査リダクションパターンのユーザー設定 — 追加の正規表現パターンが CLI（traceary audit）と MCP サーバー（add_audit）の両方で組み込みルールの後に適用される
• infrastructure/sqlite/ 全体で、抑制されていたクリーンアップエラーの debug レベルログ出力
• セッションおよびリポジトリコンテキスト解決の各フォールバック段階での debug レベルログ出力
• AI エージェントの動作統一のための CLAUDE.md、AGENTS.md、GEMINI.md プロジェクト規約ファイル
• LoadConfig、compileExtraRedactPatterns、setupLogger のテスト追加

Fixed

• init() 内の log.Fatalf を run() からの graceful error return に置換 — 不正な LOG_LEVEL でスタックトレースではなくクリーンなエラーメッセージを出力
• MCP サーバーがリクエストごとではなく起動時に一度だけ config を読み込むよう修正

Changed

• エージェント設定ファイルにイシュークローズポリシーを追加（実装 PR はサブイシューのみクローズ、親イシューはリリース PR でクローズ）
• AI エージェント設定ファイルを docs i18n チェックから除外
• 環境リファレンスドキュメントに config.json と追加リダクションパターンの説明を追記
• release 向け integration manifest version を 0.1.16 に更新

Included issues

• #170 Replace panic calls in CLI initialization with graceful errors
• #171 Make audit redaction patterns user-configurable
• #172 Add debug logging for suppressed cleanup errors
• #173 Clarify error propagation in session resolution logic

[v0.1.15] - 2026-04-09

この release では、v0.1.14 の dogfood で残っていた follow-up を閉じ、ローカル専用 Git repository の扱いと traceary doctor の first-run 表示を実用的に整えました。

Fixed

• remote.origin.url が無いローカル専用 Git repository でも、Git worktree ルートへ fallback するようにし、traceary log / traceary audit が active session を再利用できるようにした
• packaged hook script でも同じ fallback を使うようにし、Claude / Codex / Gemini integration と CLI の挙動をそろえた
• traceary doctor が host config 未作成などの first-run 状態を generic failure ではなく warn として返すようにした
• setup ガイダンスを妨げる hook script materialize 問題は、必ずしも壊れた install を意味しないため、より明確な warn メッセージで出すようにした

Changed

• root README と CLI / hooks / environment docs に、local-only Git worktree fallback と traceary doctor の warn / fail の意味を追記した
• release 向け integration manifest version を 0.1.15 に更新した
• release guide の固定 tag 例を v0.1.15 に更新した

Included issues

• #165 Make doctor clearer on first-run integration states
• #166 Improve work-context detection for local-only git repositories

v0.1.14 - 2026-04-09

この release では、v0.1.13 以降に main へ入っていた integration / runtime 修正と、それを公開するための release metadata 整備をまとめて収録しています。

Fixed

• 共通 SessionEnd hook を冪等化し、Gemini が session-end hook を重複で呼んでも session_ended を 1 回だけ記録するようにした
• Codex の local install helper が active plugin cache の配置、codex_hooks の有効化、~/.codex/hooks.json への Traceary hook マージまで行うよう修正した
• Codex の uninstall helper が config.toml 内の nested plugin subtable までまとめて消すよう修正した
• GoReleaser が生成する Homebrew formula の test を traceary --version に修正した

Changed

• root README と host integration docs を、手動 CLI より plugin / extension 導入を先に案内する構成へ整理した
• release 向け integration manifest version を 0.1.14 に更新した
• 抜けていた v0.1.12 / v0.1.13 の changelog を補完し、release guide の古い固定 tag 例を解消した

Included issues

• #159 Codex local install does not activate the Traceary plugin runtime
• #160 Gemini extension records duplicate session_ended events
• #161 Root README should prioritize plugin and extension install flows
• #163 Align release metadata with the current release line
• #164 Use --version in the generated Homebrew formula test

v0.1.13 - 2026-04-09

Added

• traceary log, traceary audit, traceary session {start,end,latest,active} に --json を追加
• traceary list に --kind, --client, --agent, --session-id, --repo の構造化 filter を追加

Changed

• traceary session latest を、同一 session context 内で最新の lifecycle boundary を優先する意味に再定義した
• manual command の default / JSON 出力 / hooks guidance を CLI help と docs で分かりやすく整理した

Fixed

• 同じ session が複数回 start された場合でも、最新の session_started を優先するよう修正
• 同じ session_id を別 repo / agent が再利用している場合、他 context の lifecycle boundary を拾わないよう修正
• cross-context の latest-session / active-session lookup に対する regression coverage を追加

Included issues

• #146 dogfood ergonomics follow-up
• #147 fix session latest semantics for ended sessions
• #148 align machine-readable output for mutating and session helper commands
• #149 improve traceary audit ergonomics
• #150 add structured filters to traceary list
• #151 surface environment variables and defaults in CLI help
• #152 improve hooks print discoverability
• #153 clarify and standardize manual CLI defaults

v0.1.12 - 2026-04-09

Added

• Claude Code / Codex / Gemini CLI 向けの共通 native integration contract
• Traceary の MCP / hooks / commands / skill surface を含む Claude Code plugin package
• Traceary の MCP / hooks / commands / skill surface を含む Codex plugin package
• Traceary の MCP / hooks / commands / skill surface を含む Gemini CLI extension package
• integration validation / packaging coverage と install / update / uninstall / smoke-test guidance

Included issues

• #140 native agent integrations
• #141 define the shared integration contract
• #142 publish a Claude Code plugin
• #143 publish a Codex plugin
• #144 publish a Gemini CLI extension
• #145 add install/update/uninstall/doctor guidance and smoke tests

v0.1.11 - 2026-04-09

Added

• README やリリース画面で使える最小限の Traceary マーク

Changed

• トップレベル README を短い導入ページに整理し、詳細な導線を docs 索引へ集約
• docs/README.md / docs/README.ja.md を詳細ドキュメントの中心として再構成
• README / CONTRIBUTING / 主要ガイドの日本語表現を見直し、より自然な文体に調整
• 脆弱性の連絡先を CONTRIBUTING.md / CONTRIBUTING.ja.md に集約し、独立した SECURITY.md / SECURITY.ja.md を廃止

Included issues

• #133 public surface polish
• #134 rewrite Japanese docs into natural Japanese
• #135 simplify README and reduce link sprawl
• #137 reorganize docs landing pages and cross-links
• #138 reassess and minimize the security-policy footprint
• #139 add a minimal visual identity

v0.1.10 - 2026-04-09

Fixed

• GoReleaser の Homebrew 設定が生成された archive ID を参照するよう修正し、tagged release で archive と tap formula を再び正常に公開できるようにした

v0.1.9 - 2026-04-09

Added

• --yes 付きの安全な backup restore フロー
• mutating command 向けの script-friendly な --id-only
• traceary audit の named flags (--command, --input, --output)
• CLI / environment / storage / operations / interactive の専用 docs
• GoReleaser formula automation による Homebrew 配布導線
• recent events parity のための read-only MCP tool list_events
• Bash / Zsh / Fish / PowerShell 向け traceary completion

Changed

• onboarding と hooks docs は guided setup と failure-mode check をより早く辿れるよう改善
• traceary log / traceary audit は、まず解決済み repo / work context に対する最新 non-stale active session を再利用し、見つからない場合だけ default に fallback するよう変更
• 公開向け README に CI / release badge と、privacy / no-telemetry / support posture を追加
• hooks / storage / operations docs で runtime assumption をより明示的に文書化

Included issues

• #106 onboarding and daily-use ergonomics
• #107 safer backup restore flow
• #108 script-friendly mutating command output
• #109 named audit flags
• #110 CLI / env reference docs
• #111 onboarding / first-run docs
• #112 Homebrew distribution flow
• #113 guided setup for supported clients
• #114 storage model / schema / gc docs
• #115 active session defaults for manual log / audit
• #116 hook edge cases and failure-mode docs
• #117 MCP read workflow parity
• #118 public OSS trust and polish
• #119 concurrency / hook-state assumptions
• #120 interactive inspection ergonomics

v0.1.8 - 2026-04-08

Added

• DB と hooks 設定を診断する traceary doctor / traceary status
• 公開向け SECURITY.md / SECURITY.ja.md
• traceary backup create / traceary backup restore
• docs/backup/ 配下のバックアップ / マシン移行ガイド
• MCP の session lifecycle tools: start_session, end_session, latest_session, active_session

Changed

• hooks install は既存の対応 client config に対して、既定で Traceary 管理下 hook を merge するよう改善
• portable hook scripts は runtime で python3 を不要化
• traceary audit は common な secret っぽい値を保存前に伏せ字化し、CLI / MCP 出力で redaction を通知するよう変更
• 公開向け README / hooks / MCP 文書で command surface と platform support の説明を整合
• traceary list / traceary search は --offset による安定した pagination をサポート

Included issues

• #88 operational safety and public usability
• #89 safe hooks config merge
• #90 doctor / status diagnostics
• #91 audit secret persistence hardening
• #92 public security policy
• #93 README / platform support alignment
• #94 list / search pagination
• #95 MCP session ergonomics
• #96 backup / export / import story
• #97 reduce hook runtime dependency friction

v0.1.7 - 2026-04-08

Added

• MIT の LICENSE を追加
• 公開向け CONTRIBUTING.md / CONTRIBUTING.ja.md を追加
• docs/mcp/ に公開向け MCP integration ガイドを追加

Changed

• traceary session end で flag を省略した場合、対応する session_started から client / agent / repo を継承するように変更
• 公開向け install / release 導線と GitHub Actions の release 自動化を追加
• CLI の operator-facing message は既定で英語とし、日本語は TRACEARY_LANG=ja で opt-in に変更
• hooks install は既定で source checkout 外の portable script を materialize するように変更

Included issues

• #72 public release readiness
• #73 project license の追加
• #74 session end の attribution 継承
• #75 公開向け CLI 英語化
• #76 公開 install / release distribution flow
• #77 source checkout 非依存の hooks install
• #78 CONTRIBUTING guide の追加
• #79 公開向け MCP server integration 文書

v0.1.6 - 2026-04-08

Changed

• traceary init が「任意の明示 bootstrap」であることを help / docs で明確化
• traceary session end が session ID ではなく記録した event ID を返すように変更
• hooks --client が claude-code, codex-cli, gemini-cli を alias として受け付けるように改善
• Cobra 由来の positional-argument エラーを日本語化

Included issues

• #60 traceary init の役割と暗黙 DB 作成の整理
• #61 traceary session end の出力契約整理
• #62 hooks print --client の discoverability 改善
• #63 CLI 引数エラーの日本語化

v0.1.5 - 2026-04-08

Changed

• search --kind の discoverability を改善
• すべての CLI コマンドで TRACEARY_DB_PATH をサポート
• CLI 失敗時の stderr を plain Error: ... に統一

Included issues

• #53 search --kind の discoverability 改善
• #54 TRACEARY_DB_PATH サポート
• #55 plain CLI error output

v0.1.4 - 2026-04-08

Added

• README / README.ja.md に Quick Start
• traceary hooks install
• traceary context / traceary handoff

Changed

• search に構造化フィルタを追加
• active session の stale 判定を追加
• audit truncation を設定可能に改善

Included issues

• #40 Quick Start
• #41 hooks install
• #42 structured search filters
• #43 context handoff
• #44 stale session handling
• #45 audit truncation configuration

v0.1.3 - 2026-04-08

Fixed

• session latest / session active の no rows エラー二重化を解消
• session lookup の not-found 判定を sentinel error ベースに整理

Included issues

• #37 session latest/active の no rows エラー修正

v0.1.2 - 2026-04-08

Added

• traceary list, traceary search, traceary show に --json
• traceary session active

Changed

• session latest の no-rows 判定を修正
• RootCLI の依存注入を RootCLIOptions に整理

Included issues

• #28 session latest の no rows 判定修正
• #29 主要読み取りコマンドの JSON 出力
• #30 active session 取得導線
• #31 command audit output 検索の再確認
• #32 RootCLIOptions による依存注入整理

v0.1.1 - 2026-04-08

Added

• traceary show <event-id>
• traceary session latest
• traceary hooks print --client <...>

Changed

• hooks 設定例の出力が CLI から直接行えるようになり、dogfood の手順を短縮
• hooks print の既定 binary 解決を安定した traceary コマンド名に修正

Included issues

• #19 dogfood usability improvements
• #20 traceary show <event-id>
• #21 traceary session latest
• #22 traceary hooks print --client
• #26 hooks print の follow-up 修正

v0.1 - 2026-04-07

Added

• SQLite ベースの local store
• traceary init, log, audit, list, search, session start/end, gc
• MCP server (add_log, add_audit, search, get_context)
• Claude Code / Codex CLI / Gemini CLI 向け hooks integration

Included issues

• #11 bootstrap CLI and SQLite store
• #12 log / list
• #13 session start / end
• #14 audit log
• #15 gc / retention
• #16 search / work context
• #17 MCP server
• #18 hooks integration