ticket: update tui composer history persistence

This commit is contained in:
Keisuke Hirata 2026-06-06 08:01:38 +09:00
parent a40627ab9f
commit 7965249e23
No known key found for this signature in database
2 changed files with 31 additions and 7 deletions

View File

@ -7,7 +7,7 @@ kind: task
priority: P2
labels: [tui, composer, history, persistence]
created_at: 2026-06-01T02:11:04Z
updated_at: 2026-06-01T02:11:04Z
updated_at: 2026-06-05T23:01:38Z
assignee: null
legacy_ticket: null
---
@ -20,28 +20,36 @@ TUI composer では上下キーで過去に送信・queue した入力を recall
## Storage decision
永続化先は workspace 配下の `./.insomnia/` ではなく、ユーザー data dir既定では `~/.insomnia`、実装上は既存の data-dir 解決に従う)を使う方針とする。
永続化先は workspace 配下の `./.yoi/` ではなく、ユーザー data dir既定では `~/.yoi`、実装上は既存の data-dir 解決に従う)を使う方針とする。
保存 layout は、canonical workspace path / pwd から作る path-safe key を使って workspace ごとに分ける。デフォルト表示としては次のような形にする。
```text
~/.yoi/<path-to-pwd>/composer-history.json
```
実際の `<path-to-pwd>` は path separator や衝突を安全に扱える encoded key / stable key にしてよいが、metadata には元の workspace path / display name を持たせる。
理由:
- composer input history は個人の操作履歴であり、project-authored asset ではない。
- 入力には secret / private context が混ざり得るため、workspace に書くと git 追跡・共有・公開監査のリスクが上がる。
- `./.insomnia/` は workflow / knowledge / manifest assets など project/workspace 側の明示的な資産に寄せ、生成された個人履歴は user data 側に置く方が境界が明確。
- `./.yoi/` は workflow / knowledge / Ticket records / manifest assets など project/workspace 側の明示的な資産に寄せ、生成された個人履歴は user data 側に置く方が境界が明確。
- 「どの workspace の履歴か」は、user data 側で workspace identitycanonical workspace root / git root などから作る stable keyと display metadata を持てば表現できる。
## Requirements
- 上下キーで呼び出す composer input history を、TUI 再起動後も利用できるよう永続化すること。
- 履歴は workspace ごとに分離すること。別 workspace の入力履歴が通常操作で混ざらないこと。
- 保存先は既存の user data dir 配下にすること。デフォルト表示としては `~/.insomnia` 相当だが、実装は data-dir override / path resolution に従うこと。
- `./.insomnia/` には composer history を作成しないこと。
- 保存先は既存の user data dir 配下にすること。デフォルト表示としては `~/.yoi/<path-to-pwd>/composer-history.json` 相当だが、実装は data-dir override / path resolution に従うこと。
- `./.yoi/` には composer history を作成しないこと。
- 保存 record は、どの workspace の履歴か判別できる metadata / key を持つこと。
- 既存の TUI-local / non-destructive recall semantics を維持すること。
- Pod protocol を変えない。
- transcript / session history を mutate しない。
- recalled input は、ユーザーが再送信するまでは conversation state に影響しない。
- 入力は typed `Segment` vector として保存し、structured input の recall を壊さないこと。
- non-blank input のみ保存し、連続重複を抑止し、履歴件数は bounded にすること。既存挙動の 100 件 bound を尊重する
- non-blank input のみ保存し、連続重複を抑止し、履歴件数は workspace ごとに最大 30 件程度に bound すること
- secret 値が混ざり得る前提で、保存内容を diagnostics / logs / tickets / tests snapshot / model context に不用意に出さないこと。
- 破損した履歴ファイルがあっても TUI startup を致命的に壊さず、必要なら warning と空履歴 fallback にすること。
- 既存の multiline cursor navigation、Up/Down browse、draft restore、edit-on-recall の挙動を regression させないこと。
@ -51,6 +59,7 @@ TUI composer では上下キーで過去に送信・queue した入力を recall
- 同じ workspace で TUI を再起動しても、以前送信した composer input を上下キーで recall できる。
- 別 workspace では履歴が分離される。
- workspace 配下に新しい composer history file が作られない。
- user data dir 配下に workspace-scoped な composer history が保存される。
- user data dir 配下、既定では `~/.yoi/<path-to-pwd>/composer-history.json` 相当の workspace-scoped path に composer history が保存される。
- 保存件数は workspace ごとに最大 30 件程度に bound される。
- Pod session log / Worker history / transcript には、recall 操作だけでは何も追加されない。
- focused test または明確な手動確認手順で、永続化・workspace 分離・既存 recall semantics を検証できる。

View File

@ -4,4 +4,19 @@
Created by tickets.sh create.
---
<!-- event: decision author: hare at: 2026-06-05T23:01:38Z -->
## Decision
Updated based on user direction:
- keep this as the existing `tui-composer-history-persistence` ticket rather than creating a duplicate;
- default user-data shape should be like `~/.yoi/<path-to-pwd>/composer-history.json` using a path-safe/stable workspace key;
- do not create composer history under workspace `./.yoi/`;
- bound persisted recall history to about 30 entries per workspace instead of the older 100-entry note;
- keep typed `Segment` storage, non-destructive recall semantics, and no Pod/session transcript mutation.
---