mirror of https://github.com/allaunthefox/Research-Stack.git synced 2026-07-31 03:05:21 +00:00

Brandon Schneider c0641ea875 integrate stashed changes: math model data updates + 4 receipt dirs + container config

- Update 3-Mathematical-Models JSON datasets (NUVMAP index, mass proofs,
  math_centric_samples, math_raw_summary, math_self_discovered +1.5M lines,
  structural_discovery, unified_9pattern_samples, unknown_discovery_report)
- Add adjacent_coprime_classification receipt (Lean proof + manifest)
- Add codebase-memory-receipt (Rust crate + manifests)
- Add desi_model_projection receipt (Lean proofs + manifest)
- Add deterministic_build_receipt (Lean build proof)
- Add Containerfile, run-container.sh, cupfox-config.nix
- Restore .github assets and changes.zip

2026-05-17 12:03:19 -05:00

3.4 KiB

Raw Blame History

Research Stack Receipt: Persistent Codebase Memory (2026-05-13)

Agent: Hermes (Nous Research self-adaptive agent)

Task: Persistent multi-domain codebase memory without Python

Summary

Built a FAMM-based persistent codebase memory system that lets Hermes remember the full project structure between sessions, without retraining or rescanning.

Architecture (Rust crate)

4-Infrastructure/shim/codebase-memory/
  Cargo.toml            -- Rust crate manifest (serde, sha2, walkdir)
  src/lib.rs            -- Public exports
  src/types.rs          -- Q16_16, CodeDomain (7), CodeCell, DomainBank,
                           DomainScarField, DualMapMemory, 6 tests
  src/adapter.rs        -- CodebaseMemoryAdapter with observe/commit/query_all
  src/main.rs           -- Binary: load_for_hermes(project_root, persist_path)
  hermes_integration_manifest.json  -- Agent contract

Key Types

Q16_16: Fixed-point arithmetic matching Lean Q16_16
CodeDomain: 7 domains (0-Core through 6-Docs)
CodeCell: Artifact path, type, data, delay (staleness), delay_mass (uncertainty), version_hash
DomainBank: 1000-cell FAMM bank with thermal budget (5000), current stress, heatsink_halt
DualMapMemory: ahead (speculative) + behind (committed) + per-domain scar differentials

Operations

observe(domain, path, type, data, delay, mass)
- Finds or allocates cell in ahead map
- Updates version_hash from SHA-256
- If content changed: adds scar to ahead_scar
- Emits MemoryAccessReceipt
commit_if_admissible(domain)
- Computes |ahead_total - behind_total|
- If |Delta| <= epsilon: copies ahead -> behind, admits
- Else: holds (receipt says "blocked")
- Emits MemoryAccessReceipt
advance_epoch()
- Commits all domains in one epoch cycle
query_all(pattern)
- Searches all domains for artifact path substring
- Returns HashMap<domain, Vec>
load_for_hermes(root, .hermes/codebase_memory.json)
- Scans all 7 domain directories
- Observes every file with artifact_type from extension
- Saves to JSON, then loads back via serde
- This is the Hermes startup path

Receipt Verification

cargo check: PASS
cargo test (6 tests):
- test_q16_16_basic: PASS
- test_code_domain_all: PASS
- test_artifact_type_from_ext: PASS
- test_domain_bank: PASS
- test_memory_state: PASS
- test_dual_map_commit: PASS

Lean Modules (Quarantined)

Three Lean modules were written as formal spec but quarantined from lake build because they have field notation issues with KnowledgeCell / CodeCell shadowing FAMMCell. They can be re-enabled when the naming collision is resolved.

Semantics/CodebaseMemory.lean -- types + thermal management + pruning
Semantics/CodebaseFSDU.lean -- dual-map scar differentials
Semantics/CodebaseReceipt.lean -- MemoryAccessReceipt + observer/provider pairs

Quarantine Log

2026-05-13 02:30 -- quarantined CodebaseMemory.lean, CodebaseFSDU.lean, CodebaseReceipt.lean
2026-05-13 02:30 -- deleted codebase_memory_adapter.py (Python disallowed per AGENTS.md)
2026-05-13 02:35 -- built Rust codebase-memory crate

Promotion Gate

Status: CANDIDATE
Next: Observer/Provider receipt audit to advance to REVIEWED

Answer SHA-256

echo -n "codebase_memory_manifest_2026_05_13" | sha256sum
# (runtime-computed)

-- Research Stack Team

3.4 KiB Raw Blame History