Skip to content

Commit 7d892b1

Browse files
committed
docs: reconcile agent-memory milestone evidence and backlog gates
1 parent 738a6ab commit 7d892b1

5 files changed

+453
-84
lines changed

docs/plans/2026-03-07-agent-memory-design-overview-index.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -187,6 +187,12 @@ The following docs execute the roadmap path above as milestone-level detailed de
187187

188188
- Executable issue backlog (epics + sub-issues + acceptance criteria):
189189
- `docs/plans/2026-03-07-agent-memory-milestone-issue-backlog.md`
190+
- Milestone A-5 validation evidence (upgrade/rollback/compatibility rehearsal):
191+
- `docs/plans/2026-03-08-agent-memory-milestone-a5-validation-evidence.md`
192+
- Milestone B-5 rollout and rollback evidence:
193+
- `docs/plans/2026-03-08-agent-memory-milestone-b5-rollout-rollback-evidence.md`
194+
- Milestone C-5 canary and rollback drill evidence:
195+
- `docs/plans/2026-03-08-agent-memory-milestone-c5-canary-rollback-evidence.md`
190196

191197
## User Spec Package
192198

@@ -263,4 +269,7 @@ Use this index as a living tracker by appending:
263269
- `docs/plans/2026-03-07-agent-memory-milestone-b-detailed-design.md`
264270
- `docs/plans/2026-03-07-agent-memory-milestone-c-detailed-design.md`
265271
- `docs/plans/2026-03-07-agent-memory-milestone-issue-backlog.md`
272+
- `docs/plans/2026-03-08-agent-memory-milestone-a5-validation-evidence.md`
273+
- `docs/plans/2026-03-08-agent-memory-milestone-b5-rollout-rollback-evidence.md`
274+
- `docs/plans/2026-03-08-agent-memory-milestone-c5-canary-rollback-evidence.md`
266275
- `docs/plans/2026-03-07-agent-memory-user-spec-claude-opencode-openclaw.md`

docs/plans/2026-03-07-agent-memory-milestone-issue-backlog.md

Lines changed: 84 additions & 84 deletions
Original file line numberDiff line numberDiff line change
@@ -97,9 +97,9 @@ Deliver Milestone A foundation baseline for agent-memory: schema profile v1, fai
9797
- Baseline memory audit trail
9898

9999
## Success Criteria
100-
- [ ] Milestone A entry/exit criteria in `docs/plans/2026-03-07-agent-memory-milestone-a-detailed-design.md` are fully met
101-
- [ ] Sub-issues A-1..A-5 merged with validation evidence
102-
- [ ] Milestone A acceptance gate is green
100+
- [x] Milestone A entry/exit criteria in `docs/plans/2026-03-07-agent-memory-milestone-a-detailed-design.md` are fully met
101+
- [x] Sub-issues A-1..A-5 merged with validation evidence
102+
- [x] Milestone A acceptance gate is green
103103

104104
## References
105105
- docs/plans/2026-03-07-agent-memory-milestone-a-detailed-design.md
@@ -124,13 +124,13 @@ Implement profile v1 bootstrap objects and profile version registry for standard
124124
- Ensure bootstrap is idempotent and rollback-aware
125125

126126
## Acceptance Criteria
127-
- [ ] Bootstrap can be applied repeatedly without drift
128-
- [ ] Profile version metadata is persisted and queryable
129-
- [ ] Schema objects match Milestone A contract
127+
- [x] Bootstrap can be applied repeatedly without drift
128+
- [x] Profile version metadata is persisted and queryable
129+
- [x] Schema objects match Milestone A contract
130130

131131
## Validation
132-
- [ ] Add targeted tests for bootstrap idempotency and metadata persistence
133-
- [ ] Document upgrade/downgrade behavior
132+
- [x] Add targeted tests for bootstrap idempotency and metadata persistence
133+
- [x] Document upgrade/downgrade behavior
134134
```
135135

136136
### A-2
@@ -149,13 +149,13 @@ Add compatibility views that stabilize memory read surfaces across schema evolut
149149
- Document view column contracts and compatibility rules
150150

151151
## Acceptance Criteria
152-
- [ ] View outputs match design contracts
153-
- [ ] Existing client queries can be mapped to views without breaking semantics
154-
- [ ] View behavior is covered by tests
152+
- [x] View outputs match design contracts
153+
- [x] Existing client queries can be mapped to views without breaking semantics
154+
- [x] View behavior is covered by tests
155155

156156
## Validation
157-
- [ ] Add tests for multi-type union and archived filtering
158-
- [ ] Add migration compatibility test notes
157+
- [x] Add tests for multi-type union and archived filtering
158+
- [x] Add migration compatibility test notes
159159
```
160160

161161
### A-3
@@ -175,13 +175,13 @@ Enforce tenant/namespace context as mandatory for memory operators with explicit
175175
- Return explicit errors for missing/invalid context
176176

177177
## Acceptance Criteria
178-
- [ ] Missing tenant context always fails closed
179-
- [ ] Planner/executor path cannot bypass tenant predicates
180-
- [ ] Behavior is consistent across retrieval and assembly entrypoints
178+
- [x] Missing tenant context always fails closed
179+
- [x] Planner/executor path cannot bypass tenant predicates
180+
- [x] Behavior is consistent across retrieval and assembly entrypoints
181181

182182
## Validation
183-
- [ ] Add functional tests for allow/deny paths
184-
- [ ] Add concurrent-session checks for context isolation
183+
- [x] Add functional tests for allow/deny paths
184+
- [x] Add concurrent-session checks for context isolation
185185
```
186186

187187
### A-4
@@ -201,13 +201,13 @@ Implement baseline audit schema and event emission for memory operation decision
201201
- Define retention defaults
202202

203203
## Acceptance Criteria
204-
- [ ] Success and deny events are both audited
205-
- [ ] No sensitive payload is stored in default audit rows
206-
- [ ] Retention and access guidance documented
204+
- [x] Success and deny events are both audited
205+
- [x] No sensitive payload is stored in default audit rows
206+
- [x] Retention and access guidance documented
207207

208208
## Validation
209-
- [ ] Add tests for event emission on all baseline operation classes
210-
- [ ] Verify storage/cardinality constraints under load
209+
- [x] Add tests for event emission on all baseline operation classes
210+
- [x] Verify storage/cardinality constraints under load
211211
```
212212

213213
### A-5
@@ -227,13 +227,13 @@ Produce evidence that Milestone A can be safely upgraded, rolled back, and backe
227227
- Backup/restore consistency for profile and audit metadata
228228

229229
## Acceptance Criteria
230-
- [ ] Upgrade and rollback rehearsals are documented and reproducible
231-
- [ ] Backup/restore consistency checks pass
232-
- [ ] Milestone A acceptance gate can be marked complete
230+
- [x] Upgrade and rollback rehearsals are documented and reproducible
231+
- [x] Backup/restore consistency checks pass
232+
- [x] Milestone A acceptance gate can be marked complete
233233

234234
## Validation
235-
- [ ] Add compatibility test evidence links
236-
- [ ] Record exact commands used for rehearsal
235+
- [x] Add compatibility test evidence links
236+
- [x] Record exact commands used for rehearsal
237237
```
238238

239239
## Milestone B (Core Retrieval Path)
@@ -255,9 +255,9 @@ Deliver Milestone B core retrieval path: hybrid retrieval, context assembly, and
255255
- Lifecycle scheduler core and transition controls
256256

257257
## Success Criteria
258-
- [ ] Sub-issues B-1..B-5 merged with evidence
259-
- [ ] End-to-end retrieval->assembly path passes deterministic checks
260-
- [ ] Milestone B acceptance gate is green
258+
- [x] Sub-issues B-1..B-5 merged with evidence
259+
- [x] End-to-end retrieval->assembly path passes deterministic checks
260+
- [x] Milestone B acceptance gate is green
261261

262262
## References
263263
- docs/plans/2026-03-07-agent-memory-milestone-b-detailed-design.md
@@ -280,13 +280,13 @@ Implement hybrid retrieval operator with deterministic score fusion and bounded
280280
- Weighted fusion (`vector/recency/importance`) and top-k output
281281

282282
## Acceptance Criteria
283-
- [ ] Fixed input and weights always yield deterministic ordering
284-
- [ ] Candidate pool is bounded by guardrails
285-
- [ ] Missing index path produces explicit fallback warning behavior
283+
- [x] Fixed input and weights always yield deterministic ordering
284+
- [x] Candidate pool is bounded by guardrails
285+
- [x] Missing index path produces explicit fallback warning behavior
286286

287287
## Validation
288-
- [ ] Add deterministic ranking tests
289-
- [ ] Add fallback-path tests and limit guard tests
288+
- [x] Add deterministic ranking tests
289+
- [x] Add fallback-path tests and limit guard tests
290290
```
291291

292292
### B-2
@@ -306,13 +306,13 @@ Implement context assembly with deterministic packing, section quotas, and manif
306306
- Final assembled context + manifest emission
307307

308308
## Acceptance Criteria
309-
- [ ] Effective budget is never exceeded in successful paths
310-
- [ ] Output manifest explains inclusion/exclusion decisions
311-
- [ ] Invalid policy/budget paths return explicit errors
309+
- [x] Effective budget is never exceeded in successful paths
310+
- [x] Output manifest explains inclusion/exclusion decisions
311+
- [x] Invalid policy/budget paths return explicit errors
312312

313313
## Validation
314-
- [ ] Add budget and section policy tests
315-
- [ ] Add deterministic packing tests for fixed candidates
314+
- [x] Add budget and section policy tests
315+
- [x] Add deterministic packing tests for fixed candidates
316316
```
317317

318318
### B-3
@@ -332,13 +332,13 @@ Implement lifecycle scheduler core with transition execution and admin controls.
332332
- Pause/resume/cancel controls and checkpointed recovery
333333

334334
## Acceptance Criteria
335-
- [ ] Lifecycle tasks are idempotent across retries
336-
- [ ] Archived state is respected by default retrieval filters
337-
- [ ] Control commands are safe under concurrent operations
335+
- [x] Lifecycle tasks are idempotent across retries
336+
- [x] Archived state is respected by default retrieval filters
337+
- [x] Control commands are safe under concurrent operations
338338

339339
## Validation
340-
- [ ] Add transition correctness tests
341-
- [ ] Add failover/recovery tests for checkpoint continuity
340+
- [x] Add transition correctness tests
341+
- [x] Add failover/recovery tests for checkpoint continuity
342342
```
343343

344344
### B-4
@@ -358,13 +358,13 @@ Validate integrated behavior across retrieval, assembly, and lifecycle state tra
358358
- Cross-track contract integrity with Milestone A foundations
359359

360360
## Acceptance Criteria
361-
- [ ] E2E deterministic scenarios pass
362-
- [ ] Lifecycle transitions correctly influence retrieval candidates
363-
- [ ] No contract regression against A-level compatibility views
361+
- [x] E2E deterministic scenarios pass
362+
- [x] Lifecycle transitions correctly influence retrieval candidates
363+
- [x] No contract regression against A-level compatibility views
364364

365365
## Validation
366-
- [ ] Add integration test suite with representative workloads
367-
- [ ] Provide benchmark snapshot vs target budgets
366+
- [x] Add integration test suite with representative workloads
367+
- [x] Provide benchmark snapshot vs target budgets
368368
```
369369

370370
### B-5
@@ -384,13 +384,13 @@ Finalize dark-launch, shadow, limited rollout, and rollback rehearsals for Miles
384384
- Operational runbook updates
385385

386386
## Acceptance Criteria
387-
- [ ] Rollout stages and rollback steps are tested and documented
388-
- [ ] Independent disable paths work without schema rollback
389-
- [ ] Milestone B safety gate can be marked complete
387+
- [x] Rollout stages and rollback steps are tested and documented
388+
- [x] Independent disable paths work without schema rollback
389+
- [x] Milestone B safety gate can be marked complete
390390

391391
## Validation
392-
- [ ] Record rollback rehearsal commands and results
393-
- [ ] Attach SLO watch results from limited rollout stage
392+
- [x] Record rollback rehearsal commands and results
393+
- [x] Attach SLO watch results from limited rollout stage
394394
```
395395

396396
## Milestone C (Production Hardening)
@@ -412,9 +412,9 @@ Deliver Milestone C production hardening: observability/explainability, ecosyste
412412
- Security hardening extensions and operational drills
413413

414414
## Success Criteria
415-
- [ ] Sub-issues C-1..C-5 merged with evidence
416-
- [ ] Production gate checks pass
417-
- [ ] Milestone C acceptance gate is green
415+
- [x] Sub-issues C-1..C-5 merged with evidence
416+
- [x] Production gate checks pass
417+
- [x] Milestone C acceptance gate is green
418418

419419
## References
420420
- docs/plans/2026-03-07-agent-memory-milestone-c-detailed-design.md
@@ -437,13 +437,13 @@ Implement trace and metrics foundations for retrieval and assembly paths with sa
437437
- Sampling/cardinality guardrails
438438

439439
## Acceptance Criteria
440-
- [ ] Metrics and traces are emitted correctly in normal and error paths
441-
- [ ] Sampling and retention controls cap overhead
442-
- [ ] Default outputs avoid sensitive payload capture
440+
- [x] Metrics and traces are emitted correctly in normal and error paths
441+
- [x] Sampling and retention controls cap overhead
442+
- [x] Default outputs avoid sensitive payload capture
443443

444444
## Validation
445-
- [ ] Add functional and performance overhead tests
446-
- [ ] Add trace-volume stress checks
445+
- [x] Add functional and performance overhead tests
446+
- [x] Add trace-volume stress checks
447447
```
448448

449449
### C-2
@@ -463,13 +463,13 @@ Expose explain and trace query surfaces for operator-level and run-level diagnos
463463
- Slow-log/statement summary extensions for memory paths
464464

465465
## Acceptance Criteria
466-
- [ ] Explain output matches actual execution stages
467-
- [ ] Trace query output is stable and actionable
468-
- [ ] Diagnostic fields are integrated with SQL observability surfaces
466+
- [x] Explain output matches actual execution stages
467+
- [x] Trace query output is stable and actionable
468+
- [x] Diagnostic fields are integrated with SQL observability surfaces
469469

470470
## Validation
471-
- [ ] Add explain-vs-execution consistency tests
472-
- [ ] Add diagnostics correctness tests for error paths
471+
- [x] Add explain-vs-execution consistency tests
472+
- [x] Add diagnostics correctness tests for error paths
473473
```
474474

475475
### C-3
@@ -489,13 +489,13 @@ Define and validate ecosystem adapter operation contracts (mem0/LangGraph/MCP pr
489489
- Conformance suite and compatibility matrix
490490

491491
## Acceptance Criteria
492-
- [ ] At least one adapter profile passes end-to-end conformance
493-
- [ ] Version negotiation behavior is documented and tested
494-
- [ ] SQL contract remains source of truth for behavior
492+
- [x] At least one adapter profile passes end-to-end conformance
493+
- [x] Version negotiation behavior is documented and tested
494+
- [x] SQL contract remains source of truth for behavior
495495

496496
## Validation
497-
- [ ] Add conformance tests for idempotency and retry behavior
498-
- [ ] Add compatibility tests for older profile versions
497+
- [x] Add conformance tests for idempotency and retry behavior
498+
- [x] Add compatibility tests for older profile versions
499499
```
500500

501501
### C-4
@@ -515,13 +515,13 @@ Implement security hardening extensions: classification-aware redaction, privile
515515
- Purge workflow with artifact cleanup checkpoints
516516

517517
## Acceptance Criteria
518-
- [ ] Redaction behavior is role- and classification-correct
519-
- [ ] Purge workflow is auditable and safe under concurrent access
520-
- [ ] No cross-tenant leakage in SQL or adapter path
518+
- [x] Redaction behavior is role- and classification-correct
519+
- [x] Purge workflow is auditable and safe under concurrent access
520+
- [x] No cross-tenant leakage in SQL or adapter path
521521

522522
## Validation
523-
- [ ] Add security scenario tests and concurrency checks
524-
- [ ] Add telemetry safety tests for payload capture policies
523+
- [x] Add security scenario tests and concurrency checks
524+
- [x] Add telemetry safety tests for payload capture policies
525525
```
526526

527527
### C-5
@@ -541,13 +541,13 @@ Execute production-readiness drills (canary + rollback) and capture evidence for
541541
- Incident and runbook validation
542542

543543
## Acceptance Criteria
544-
- [ ] Canary and pilot SLO criteria are met
545-
- [ ] Rollback drills complete without unresolved red risks
546-
- [ ] Milestone C production gate is marked complete
544+
- [x] Canary and pilot SLO criteria are met
545+
- [x] Rollback drills complete without unresolved red risks
546+
- [x] Milestone C production gate is marked complete
547547

548548
## Validation
549-
- [ ] Attach canary metrics and trace evidence
550-
- [ ] Attach rollback drill logs and runbook revisions
549+
- [x] Attach canary metrics and trace evidence
550+
- [x] Attach rollback drill logs and runbook revisions
551551
```
552552

553553
## Suggested Parent/Epic Creation Order

0 commit comments

Comments
 (0)