Skip to content

feat: add memory explanation tools and workflow safety gates#38

Merged
tryweb merged 5 commits intomainfrom
feat/why-this-memory-explanation
Mar 29, 2026
Merged

feat: add memory explanation tools and workflow safety gates#38
tryweb merged 5 commits intomainfrom
feat/why-this-memory-explanation

Conversation

@tryweb
Copy link
Copy Markdown
Owner

@tryweb tryweb commented Mar 29, 2026

Summary

  • add user-facing memory explanation capability (memory_why, memory_explain_recall) with store-side explanation factors
  • add unit + e2e coverage for explanation flows and stabilize e2e via deterministic mock embeddings
  • archive OpenSpec change why-this-memory-explanation and harden workflow docs/skills with shared Git Safety Gate

Verification

  • docker compose exec opencode-dev npm run release:check
  • docker compose exec opencode-dev npm run test:e2e

Notes

  • release precondition now becomes "merge this PR to main" before release branch/tag steps

tryweb added 5 commits March 29, 2026 09:24
- Add MemoryExplanation and RecallFactors types to src/types.ts
- Add explainMemory method to MemoryStore with recency, citation, scope factors
- Add memory_why tool for explaining specific memory recall
- Add memory_explain_recall tool for explaining last recall operation
- Track last recall session for explanation retrieval
- Add unit tests for explanation functionality

Changelog: user-facing
- Add E2E tests for memory_why tool (valid and invalid ID)
- Add E2E tests for memory_explain_recall tool (with and without prior recall)

Changelog: user-facing
Use an in-process mock embedding server in e2e to remove external Ollama dependency and keep memory explanation flow fully verifiable in container and local runs.
Archive completed BL-013 spec-driven change and materialize the finalized capability spec under openspec/specs/why-this-memory after passing archive validation.
- add Phase 0 Git Safety Gate to backlog-to-openspec and release-workflow
- unify no-stash policy and add failure-mode remediation tables
- align development workflow docs with branch safety and unmerged feature checks
@tryweb tryweb merged commit caaca0a into main Mar 29, 2026
9 checks passed
@tryweb tryweb deleted the feat/why-this-memory-explanation branch March 29, 2026 02:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant