Repository navigation
docs: PLAN-v0.2.9 — AI Understanding Layer Refactor - #25
Merged
Merged
Conversation
Charter: AI 理解层重构 - 让标题、进展、摘要成为可追溯、可过期、 可校正、可帮助回忆的当前解释。 Locked decisions: - Manual generation only (no auto-trigger in v0.2.9) - Hybrid migration: understanding.json read-only, understanding-v2.json new - Legacy snapshots permanent as "Pre-v0.2.9 baseline" - Adopt AI = pointer move + SelectionEvent (no fake manual artifact) - Rationale: Path A optional separate call, current-only metadata - Desensitization: extend DesensitizeSession narrowly, fail-closed atomic write - Real samples: advisory in v0.2.9, not gate-blocking Internal phasing: P1-P7, single v0.2.9 tag at end. Milestone release gate required before tag (synthetic fixtures must PASS).
Owner
Author
Review checklistReviewers, please verify each of the following:
Merge will not happen until:
|
- SelectionEvent: add previousVersionID alongside targetVersionID for explicit adoption history - LegacyUnderstandingSnapshot.generatedAt: Date -> Date? (legacy data may lack trustworthy generation time) - UnderstandingArtifact.sessionFingerprint: String -> String? (required for .ai/.rule, optional for .manual) - Pre-tag checklist: CHANGELOG step phrased as "before opening the release PR", untethered from gate artifact ordering PLAN-only. No implementation.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Planning document only. No implementation.
Charter
AI 理解层重构 — title, progress, summary become traceable, expirable, correctable, recall-supportive current interpretations of a session.
Locked decisions
Internal phasing
P1 (data model) → P2 (edit/regenerate) → P3 (staleness/history) → P4 (evidence) → P5 (long-session input + prompt) → P6 (desensitization + real samples) → P7 (rationale).
Single `v0.2.9` tag at end. Milestone release gate (synthetic fixtures must PASS) required before tagging.
Workspace
`ClaudeSessionHub_V0.2.9/` (new), based on origin/main at `37b50db`.