Skip to content

docs(specs): resolve 004-16 spec number collision and edge-strengthening ambiguity - #6663

Merged
bug-ops merged 2 commits into
mainfrom
feat/issue-6636/004-16-spec-number-fix
Jul 27, 2026
Merged

docs(specs): resolve 004-16 spec number collision and edge-strengthening ambiguity#6663
bug-ops merged 2 commits into
mainfrom
feat/issue-6636/004-16-spec-number-fix

Conversation

@bug-ops

@bug-ops bug-ops commented Jul 27, 2026

Copy link
Copy Markdown
Owner

Summary

  • specs/004-memory/004-16-memory-type-aware-retrieval.md and 004-16-shadow-memory-safety.md both claimed the 004-16 slot. Renamed shadow-memory-safety to 004-19 and synced every rustdoc citation across the workspace (26 sites in crates/: MAGE/TrajectoryRiskAccumulator/shadow-memory citations moved to spec 004-19, MemGuard/type-aware-retrieval citations stay at 004-16), plus the Obsidian wikilinks in 004-memory/spec.md and the cross-directory reference in 083-memory-write-consent-gate/spec.md.
  • Added an authoritative statement in specs/004-memory/spec.md resolving which of three coexisting edge-strengthening mechanisms (A-MEM retrieval_count boost, Benna-Fusi dual-rate confidence_fast/confidence_slow, HeLa-Mem Hebbian weight) actually governs graph traversal today, grounded in file:line citations against crates/zeph-memory/src/graph/.

Closes #6636
Closes #6635

Test plan

  • cargo +nightly fmt --check
  • cargo clippy --profile ci --workspace --all-targets --features "desktop,ide,server,chat,pdf,scheduler,testing" -- -D warnings
  • RUSTDOCFLAGS="--deny rustdoc::broken_intra_doc_links" cargo doc --no-deps --workspace --features "desktop,ide,server,chat,pdf,scheduler" (clean, no broken intra-doc links)
  • gitleaks protect --staged --no-banner --redact (no leaks)
  • Full-repo grep confirms zero stray 004-16-shadow-memory-safety references remain
  • All specs/004-memory: three independent edge-strengthening designs coexist with no authoritative statement #6635 citations verified byte-exact against crates/zeph-memory/src/graph/{types,retrieval,activation}.rs

@github-actions github-actions Bot added documentation Improvements or additions to documentation memory zeph-memory crate (SQLite) rust Rust code changes core zeph-core crate size/M Medium PR (51-200 lines) labels Jul 27, 2026
bug-ops added 2 commits July 28, 2026 00:05
…ing ambiguity

specs/004-memory/004-16-memory-type-aware-retrieval.md and
004-16-shadow-memory-safety.md both claimed the 004-16 slot. Renamed
shadow-memory-safety to 004-19 and synced every rustdoc citation across
the workspace (MAGE/TrajectoryRiskAccumulator/shadow-memory sites moved
to spec 004-19; MemGuard/type-aware-retrieval sites stay at 004-16),
including Obsidian wikilinks in 004-memory/spec.md and the cross-directory
reference in 083-memory-write-consent-gate/spec.md.

Also adds an authoritative statement in specs/004-memory/spec.md
resolving which of three coexisting edge-strengthening mechanisms
(A-MEM retrieval_count, Benna-Fusi dual-rate confidence, HeLa-Mem
Hebbian weight) governs real graph traversal today, grounded in
file:line citations against crates/zeph-memory/src/graph/.

Closes #6636
Closes #6635
@bug-ops
bug-ops force-pushed the feat/issue-6636/004-16-spec-number-fix branch from 6e78ff5 to 9a7e513 Compare July 27, 2026 22:05
@bug-ops
bug-ops enabled auto-merge (squash) July 27, 2026 22:05
@bug-ops
bug-ops merged commit 2af0699 into main Jul 27, 2026
43 checks passed
@bug-ops
bug-ops deleted the feat/issue-6636/004-16-spec-number-fix branch July 27, 2026 22:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

core zeph-core crate documentation Improvements or additions to documentation memory zeph-memory crate (SQLite) rust Rust code changes size/M Medium PR (51-200 lines)

Projects

None yet

1 participant