yoi/.yoi/tickets/20260609-073047-001/item.md

title	state	created_at	updated_at	assignee	queued_by	queued_at
Ticket と Objective の ID を base32 timestamp 形式に統一する	queued	2026-06-09T07:30:47Z	2026-06-09T10:31:17Z	null	workspace-panel	2026-06-09T10:31:17Z

背景

Ticket identity simplification と Objective record 導入により、Ticket / Objective の canonical ID を共通の短い不透明 ID に揃えたい。

現状:

• Ticket は過去の timestamp + slug 形式から移行中。
• Objective は YYYYMMDD-HHMMSS-001 形式で、秒単位 timestamp + counter を使っている。

望ましい方向:

• ID は title / slug / 内容を含まない。
• lexicographic sort が作成時系列として使える。
• 完全連番は Git branch / workspace 並行作業で衝突しやすいため避ける。
• 秒単位 + -001 ではなく、millisecond timestamp を短い固定幅 text に圧縮する。
• created_at は人間可読な timestamp field として別に持つ。

ゴール

Ticket と Objective の canonical ID を、共通の fixed-width base32 encoded Unix epoch milliseconds 形式に統一する。

要件

• Ticket と Objective の canonical ID 形式を共通化する。
• ID は Unix epoch milliseconds を base32 text にしたものにする。
• alphabet は人間が読み間違えにくいものを使う。
  • 例: Crockford base32 系 0123456789ABCDEFGHJKMNPQRSTVWXYZ。
  • I / L / O など紛らわしい文字は避ける。
• ID は fixed width にする。
  • 例: 9 chars。
  • fixed width により lexicographic sort が chronological sort と一致する。
• ID は title / slug / content words を含まない。
• ID は canonical path component として安全であること。
• created_at は引き続き frontmatter field として持つ。
  • ID は compact primary key。
  • created_at は人間可読な作成時刻。
• updated_at も existing behavior として維持する。

Collision handling

• ID 生成時に同じ workspace 内で path collision が起きた場合、timestamp milliseconds を +1ms して再 encode する。
• 衝突時に -001 / suffix / random tail を付けない。
• +1ms を繰り返して空き ID を探す。
• 生成に使った adjusted timestamp と created_at の関係を明確にする。
  • 推奨: created_at は実作成時刻を保持し、ID は collision-adjusted primary key として扱う。
  • もしくは adjusted timestamp を created_at にも反映する場合は、その理由を明記する。
• 過剰衝突時の bounded error を用意する。

Scope

• 共通 ID allocator/helper を作る。
  • Ticket create path と Objective create path で共有する。
  • 将来の project records にも使える形が望ましい。
• Ticket create / path layout をこの ID 形式に移行する。
• Objective create / path layout をこの ID 形式に移行する。
• Existing Ticket / Objective records を migration する。
• TicketList / TicketShow / Objective list / Objective show / doctor / tests を更新する。
• Relation metadata や Objective linked tickets は、この canonical ID を前提にする。

非目標

• ID から作成時刻を人間が直接読めるようにすること。
  • 必要なら created_at を見る。
• 完全連番 ID。
• title / slug を ID に含めること。
• random UUID を使うこと。
• この Ticket で Ticket relation metadata や Objective の高機能化を実装すること。

受け入れ条件

• Ticket と Objective の新規作成で同じ canonical ID format が使われる。
• ID は fixed-width base32 epoch-milliseconds text で、title/slug を含まない。
• ID の lexicographic sort が作成時系列と一致する。
• 同一 millisecond collision は +1ms retry で解決される。
• created_at と updated_at が frontmatter に残る。
• Existing Ticket / Objective records が新 ID/path に migration される。
• Objective の YYYYMMDD-HHMMSS-001 形式は current format ではなくなる。
• Ticket の old timestamp-slug path / slug-derived identity は current format ではなくなる。
• Tests cover:
  • encoding/decoding or ordering property;
  • collision handling;
  • Ticket create;
  • Objective create;
  • doctor validation;
  • migration-relevant lookup behavior.
• target/debug/yoi ticket doctor, target/debug/yoi objective doctor, focused tests, cargo fmt --check, and git diff --check pass.