This release includes 3 breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+14 more
ReleasePort's take
Light signalRelease v4.7.0 cleans up dead models in shared/types.py and adds a --include-orphans flag to the rescan command.
Why it matters: Removal of unused Pydantic models reduces code bloat; the new --include-orphans flag enables comprehensive orphan reattachment during rescans, directly impacting maintenance workflows.
Summary
AI summaryBroad release touches merge, bench, chore, and types.
Changes in this release
| Type | Severity | Summary | CVE |
|---|---|---|---|
| Feature | Medium |
Added --include-orphans flag to rescan for INC6.2 worktree fix. Added --include-orphans flag to rescan for INC6.2 worktree fix. Source: llm_adapter@2026-07-15 Confidence: high |
— |
| Feature | Medium |
Wired identify_derivable_facts into the memify cycle with provenance tagging. Wired identify_derivable_facts into the memify cycle with provenance tagging. Source: llm_adapter@2026-07-15 Confidence: high |
— |
| Performance | Medium |
Memoized parent start‑time signature in session registry, reducing recall path latency from 6.8 ms to 0.07 ms. Memoized parent start‑time signature in session registry, reducing recall path latency from 6.8 ms to 0.07 ms. Source: llm_adapter@2026-07-15 Confidence: high |
— |
| Bugfix | Medium |
Fixed silent foreign‑key violation in memory‑to‑memory links by writing via provenance tags. Fixed silent foreign‑key violation in memory‑to‑memory links by writing via provenance tags. Source: llm_adapter@2026-07-15 Confidence: high |
— |
| Bugfix | Medium |
Resolved linked worktree current‑working‑directory to its parent project's domain and rescanned orphans (296 reattached). Resolved linked worktree current‑working‑directory to its parent project's domain and rescanned orphans (296 reattached). Source: llm_adapter@2026-07-15 Confidence: high |
— |
| Bugfix | Medium |
Aligned checkpoint and session‑log writers to use the canonical transcript stem identity. Aligned checkpoint and session‑log writers to use the canonical transcript stem identity. Source: llm_adapter@2026-07-15 Confidence: high |
— |
| Bugfix | Medium |
Corrected READ_ONLY drift on recall, recall_hierarchical, and drill_down handlers (INC6.1 follow‑up). Corrected READ_ONLY drift on recall, recall_hierarchical, and drill_down handlers (INC6.1 follow‑up). Source: llm_adapter@2026-07-15 Confidence: high |
— |
| Bugfix | Medium |
Aligned memory‑tool descriptions and annotations with the actual implemented code (I6-D8). Aligned memory‑tool descriptions and annotations with the actual implemented code (I6-D8). Source: llm_adapter@2026-07-15 Confidence: high |
— |
| Refactor | Low |
Removed dead ConversationMeta Pydantic model from shared/types.py. Removed dead ConversationMeta Pydantic model from shared/types.py. Source: llm_adapter@2026-07-15 Confidence: high |
— |
| Refactor | Low |
Removed shared/types.py entirely, eliminating 13 dead models. Removed shared/types.py entirely, eliminating 13 dead models. Source: llm_adapter@2026-07-15 Confidence: high |
— |
Full changelog
- release: v4.7.0 — solid-memory campaign wave 1: memify derivation, domain backfill, worktree resolution, honest annotations, dead-code purge
- merge: chore/dead-types-sweep — shared/types.py removed entirely (13 dead models, per-class proof)
- chore: remove dead scaffolding types from shared/types.py
- merge: chore/remove-dead-conversationmeta — dead Pydantic model removed with proof chain
- chore(types): remove dead ConversationMeta
- merge: fix/annotations-deadcode-sources — honest annotations on recall paths, dead session_id field removed, §8 source flags
- docs(sources): honest source annotation for 3 unsourced +0.05 heat bumps + wiki lifecycle thresholds (cfd8e4c3 pattern)
- merge: fix/worktree-domain-resolution — linked worktrees resolve to their parent project's domain + orphan rescan (296 reattached)
- merge: fix/memory-link-fk-violation — memory-to-memory links actually written via provenance tags (swallowed FK bug)
- refactor(scanner,session_extractor): remove dead session_id/sessionId output field (Q2 finding, re-verified)
- feat(backfill): add --include-orphans rescan for INC6.2 worktree fix
- fix(domain-mapping): resolve linked worktree cwd to main repo's domain
- fix(memory): stop the silent FK violation in memory-to-memory links
- fix(handlers): correct READ_ONLY drift on recall/recall_hierarchical/drill_down (INC6.1 follow-up)
- bench: LongMemEval-S G-bench manifest on e4ff0b70 (INC6 wave 1) — MRR 0.9166 / R@10 0.982, guard passed
- merge: fix/memory-domain-backfill — attach domainless memories by internal evidence (INC6.2/I6-D3)
- merge: feat/memify-derivable-facts — wire identify_derivable_facts into memify with tag provenance (INC6.1b)
- merge: fix/tool-descriptions-drift — tool descriptions aligned with reality + anti-drift guard (INC6.1)
- feat(campaign): I6-D3 memory domain backfill — evidence-only, no fabrication
- feat(memify): wire identify_derivable_facts into the memify cycle
- fix(tools): align memory-tool descriptions/annotations with actual code (I6-D8)
- bench: LongMemEval-S non-regression manifest on 773dde01 — MRR 0.9166 / R@10 0.982
- merge: fix/session-id-canonical-alignment — checkpoints/session-log writers use the canonical transcript stem (Q2)
- fix(session-id): align checkpoint/session-log writers on canonical transcript-stem identity
- merge: perf/session-registry-memoize — memoize parent start signature, recall path 6.8ms -> 0.07ms
- perf(session-registry): memoize parent start-time signature per pid
- merge: docs/source-citation-heat-bump — honest §8 source annotation for the citation heat bump
- docs(wiki): source-flag the unsourced +0.05 citation heat bump
- style: ruff format 21 files missed by recent increments (CI Lint gate)
Full Changelog: https://github.com/cdeust/Cortex/compare/v4.6.0...v4.7.0
Breaking Changes
- shared/types.py removed entirely (13 dead models)
- ConversationMeta Pydantic model removed
- session_id/sessionId output field removed from scanner and session_extractor
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About cdeust/Cortex
Persistent memory for Claude Code grounded in computational neuroscience (41 cited papers)
Related context
Beta — feedback welcome: [email protected]