guanghu-ice-heart/server-tools/codex-hldp-recursive-memory/README.md

1.3 KiB

Codex HLDP recursive memory

This is a deliberately small, non-blocking implementation of the HLDP v1 runtime root.

  • bootstrap: emits at most 2 KiB of protocol navigation, never memory content.
  • verify: validates a recursively addressed causal tree and the 10-child limit.
  • review: reviews one leaf or the full tree for causal transitions, non-generic why, rejected-route reasons, and retrievable sources. It reports problems to the current model; it never writes memory itself.
  • route: ranks only the current node's child summaries and returns at most three paths.
  • read-node: reads one selected node with a hard byte limit.

The optional Codex hook is valid only for SessionStart. There are intentionally no user-prompt, tool-use, pre-compact, or post-compact hooks.

node server-tools/codex-hldp-recursive-memory/hldp-memory.mjs bootstrap
node server-tools/codex-hldp-recursive-memory/hldp-memory.mjs verify --tree memory.json
node server-tools/codex-hldp-recursive-memory/hldp-memory.mjs review --tree memory.json --path root/decision
node server-tools/codex-hldp-recursive-memory/hldp-memory.mjs route --tree memory.json --query "why did the plan change"
node server-tools/codex-hldp-recursive-memory/hldp-memory.mjs read-node --tree memory.json --path root/decision
node --test server-tools/codex-hldp-recursive-memory/hldp-memory.test.mjs