ticket: use base32 project record ids

This commit is contained in:
2026-06-09 22:10:47 +09:00
parent 0803bc3725
commit 4203988d74
798 changed files with 477 additions and 105 deletions
+39
View File
@@ -0,0 +1,39 @@
---
title: "Docs: refresh stale architecture and operation docs"
state: "closed"
created_at: "2026-05-30T06:28:52Z"
updated_at: "2026-05-30T06:39:41Z"
---
## Background
Read-only docs audit Pod `docs-stale-audit-20260530` reported that several high-level docs still describe older protocol/session/tool/TUI behavior. The stale content is concentrated in architecture, compaction, TUI keybindings, and older plan documents.
The current authoritative sources are the code, `work-items/`, `KNOWN_ISSUES.md`, `AGENTS.md`, and git history. `docs/report/` remains historical observations, not current spec authority.
## Scope
Update or clearly demote stale docs so readers do not mistake old plans for current behavior:
- `docs/architecture.md`
- Refresh Protocol Method/Event overview.
- Refresh session persistence description for current `session_id` / `segment_id` / `SegmentOrigin` / Pod metadata split.
- Refresh built-in tools description beyond only file tools.
- Clarify the coarse `1 Pod = 1 process = 1 session` statement after Pod metadata / session / segment separation.
- `docs/compaction.md`
- Refresh compact/session/segment descriptions to match current session-store and segment semantics.
- `docs/tui-keybindings.md`
- Refresh `Ctrl-R` behavior and current command/queue/completion controls.
- `docs/plan/llm_presistence.md`
- Mark as superseded/archival or replace with current-session persistence pointers.
- `docs/plan/ai-maintainer.md`
- Replace old `TODO.md` / `tickets/` authority language with current `tickets.sh` + `work-items/` operation.
## Acceptance criteria
- High-priority stale claims from the docs audit are either corrected or explicitly marked historical/superseded.
- Updated docs consistently describe current Pod metadata vs session-store vs runtime registry responsibilities at a high level.
- Updated docs do not claim `TODO.md` / legacy `tickets/` are the active work-item authority.
- Updated docs do not claim `Ctrl-R` is removed; TUI keybindings reflect current behavior sufficiently for users.
- No generated report/history document is rewritten as if it were current spec authority.
- `./tickets.sh doctor` and `git diff --check` pass.
+1
View File
@@ -0,0 +1 @@
docs stale audit の高優先指摘を反映し、architecture / compaction / TUI keybindings / system-prompt-template / plan docs を現行の protocol・session-store/pod-store・work-items 運用に合わせて更新した。旧 llm persistence / maintainer work item plan は superseded/historical と明示。検証は ./tickets.sh doctor と git diff --check。
+53
View File
@@ -0,0 +1,53 @@
<!-- event: create author: tickets.sh at: 2026-05-30T06:28:52Z -->
## Created
Created by tickets.sh create.
---
<!-- event: plan author: hare at: 2026-05-30T06:29:24Z -->
## Plan
Implementation plan:
1. Read the current target docs and authoritative code/type definitions.
2. Update high-level docs in-place, keeping edits scoped to stale claims rather than broad prose rewrites.
3. Mark superseded plan docs clearly when replacing them would be larger than useful.
4. Validate with `./tickets.sh doctor` and `git diff --check`.
5. Review the resulting diff against the audit findings before closing.
---
<!-- event: implementation_report author: hare at: 2026-05-30T06:39:11Z -->
## Implementation report
Implementation report:
- Refreshed `docs/architecture.md` for current protocol categories, session-store vs pod-store responsibilities, profile/manifest input, scope delegation, and current built-in tool categories.
- Updated `docs/compaction.md` to describe same-session segment rotation and `SegmentStart.compacted_from` instead of the old new-SessionId model.
- Rewrote `docs/tui-keybindings.md` around current command mode, queued input behavior, completion, task pane, and `Ctrl-R` rewind picker behavior.
- Marked `docs/plan/llm_presistence.md` as superseded and replaced old implementation details with current-session persistence pointers.
- Refreshed `docs/plan/ai-maintainer.md` and `docs/plan/maintainer-work-items.md` so current `tickets.sh` + `work-items/` authority replaces old `TODO.md` / legacy `tickets/` assumptions.
- Updated `docs/system-prompt-template.md` for current segment log naming (`ensure_segment_head`, `SegmentStart`) while fixing nearby stale session terminology.
Validation:
- `./tickets.sh doctor`
- `git diff --check`
- grep sweep for the high-priority stale phrases from the audit; remaining hits are historical reports/ref docs or explicit superseded notes.
---
<!-- event: close author: hare at: 2026-05-30T06:39:41Z status: closed -->
## Closed
docs stale audit の高優先指摘を反映し、architecture / compaction / TUI keybindings / system-prompt-template / plan docs を現行の protocol・session-store/pod-store・work-items 運用に合わせて更新した。旧 llm persistence / maintainer work item plan は superseded/historical と明示。検証は ./tickets.sh doctor と git diff --check。
---