v0.3.1 — Bounded transcript delta recovery

v0.3.1

This patch protects confirmed state from the narrow gap between the last HANDOFF write and an abrupt Codex compaction.

Added

• Schema v4 pending records use awaiting_recovery and retain the HANDOFF last-write anchor, pre-compaction turn, capture time, project/session scope and transcript evidence pointer.
• get-transcript-delta.ps1 deterministically returns only user/assistant messages after the recorded HANDOFF write and through pending capture time, capped at 12 messages and 12000 characters by default.
• Compact recovery now requires bounded delta reconciliation before closure, even when HANDOFF passes its structural check.
• Schema v4 closure requires -DeltaChecked and records estimated turn count, critical updates found, whether HANDOFF changed, sources, repairs and final HANDOFF hash.
• Schema v3 awaiting_extraction records remain readable and closable.
• Installer and uninstaller manage the new delta reader; isolated regression covers missed last-minute state, bounds, closure enforcement and legacy compatibility.

Deliberate product boundary

Codex Memory Guard remains a lightweight, deterministic task-continuity layer. Semantic freshness across Git, releases, issues and every conversation turn, plus Codex memories, OpenViking, Trellis, vector databases, hybrid retrieval, cloud storage and custom MCP backends, were considered but are not implemented or required. There is currently no backend adapter contract. Optional memory systems may be layered alongside Guard later, but core HANDOFF recovery must continue to work offline.

Verification status

PowerShell parsing, the full isolated regression suite and Codex skill validation passed. Real Codex lifecycle compact validation remains openly tracked in Issue #6 and is not claimed as complete in this release; any findings will ship as an incremental patch.

v0.3.0 — Scoped multi-task memory workflow

v0.3.0

Codex Memory Guard v0.3 将恢复模型收缩为“一项目一份 HANDOFF，多活跃任务共存”，并补齐压缩前校验、压缩后恢复、作用域隔离和待处理记录闭环。

主要变化

• 一个项目只维护一份 HANDOFF.md，不限制活跃任务数量；完整 backlog 交给 GitHub Issues 或现有任务系统。
• 每个活跃任务只保留背景、已验证状态、一个下一步，以及可选 Issue/Spec、关键文件和 Session ID 证据索引。
• 多任务 HANDOFF 建议 1000–2000 个中文字符，3000 字符硬上限；兼容旧版单目标格式。
• Hook 仅对含 MEMORY_WORKFLOW.md 的项目生效，增加项目、会话和 HANDOFF 路径作用域校验，防止跨项目串线。
• PreCompact 使用 schema v3 记录确定性检查结果；SessionStart(compact) 优先恢复短 HANDOFF，信息不足时才局部检索 transcript。
• 新增 close-pending.ps1，记录 processed_at、使用来源、修复状态、已解决问题及最终 HANDOFF 哈希。
• 新增 cleanup-pending.ps1；默认只预览，只有显式 -Apply 才清理超过保留期且已处理的记录。
• 补齐生命周期状态、安装/卸载合并行为、完整 README 与隔离回归测试。

验证

发布前完整 scripts/test.ps1 回归通过：初始化幂等、多任务/旧格式验证、作用域隔离、未启用项目 no-op、ready/recovery-required、closure、cleanup、安装与卸载均通过。

边界

本 Skill 不阻止 Codex 自动压缩，也不承诺聊天信息无损保存；它不做语义摘要、向量数据库或全量 transcript 注入。真实 Codex compact 端到端验证继续在 Issue #6 跟踪。

v0.2.1

v0.2.1

• Evaluate task relevance before expected duration with a lightweight boundary state machine.
• Validate HANDOFF deterministically before compaction and record schema v2 evidence metadata.
• Resume directly from ready checkpoints; require targeted transcript repair for invalid checkpoints.
• Install and remove the validator together with the Hook.
• Expand isolated regression coverage for both recovery branches and scoped installation.

The Hook still does not semantically summarize transcripts. Confirmed critical state remains write-through; pre-compaction validation and post-compaction repair are the fallback.

Codex Memory Guard v0.2.0

Codex task-boundary and selective compaction-recovery release.

Highlights:

• Suggests a separate Codex task only for genuinely independent sustained goals.
• Persists confirmed critical state immediately and verifies it by read-back.
• Creates HANDOFF, DECISIONS, LESSONS, and date-memory layers while loading them selectively.
• Enforces a 1500-character HANDOFF hard limit with a validator.
• Restores from short HANDOFF first and searches transcript fragments only when needed.
• Safely installs one managed global AGENTS policy block without replacing user rules.
• Keeps Hook installation idempotent and uninstall scoped to this Skill.

Limitations:

• Does not prevent Codex compaction.
• Does not promise lossless retention of every chat detail.
• New Hook handlers must still be reviewed and trusted through /hooks.

Validation:

• Skill structure and PowerShell syntax passed.
• Isolated E2E passed for initialization, Hook lifecycle, selective recovery, HANDOFF limit, global AGENTS merge, repeated install, and scoped uninstall.

Codex Memory Guard v0.1.0

Initial public release. Includes Markdown memory layers, idempotent project initialization, synchronous PreCompact and compact-resume hooks, safe hook merging, uninstall support, and an isolated smoke test.