Skip to content

Roadmap

Raul Montoya Cardenas edited this page Jul 29, 2026 · 2 revisions

Roadmap and status

Grounded in docs/src/roadmap.md and package state at c9ff99c.

Current state

TemporalFocus is a real, usable routing library still mid-extraction:

Already solid:

  • spike-density scoring
  • EMA surprise
  • momentum term in the formula
  • configurable inhibition + defaults for any n_regions
  • diagnostics
  • stress-aware adapt_leak!
  • save_state / load_state!
  • Documenter + Pages
  • dual MIT/Apache

Cleanup targets

1. Naming

Package is TemporalFocus, but NERO aliases (NeroOrchestrator, nero_diagnostics, NERO_*) remain. Acceptable for compatibility; likely not final.

2. Defaults

Source defaults use neutral Region1Region4. Some narrative docs still mention older Attention/FFN/Memory/Output example labels — prefer code + this wiki.

3. Stress adaptation

adapt_leak! is generic via stress_adapter; default percent-scale [0,100] kept for compatibility.

4. Configuration surface

α/β/γ and floors are still module-level constants. Per-router scoring knobs are a natural next step (tracked in open work such as LIM-230 / GH#24 on a branch — not merged on this tip).

Inhibition is already per-router via inhibition_matrix=.

5. Documentation growth

Useful future docs: adapter guides for reservoirs, spike-rate normalization design notes, long-run stability notes, more worked layouts.

Long-term direction

Keep TemporalFocus small:

  • clean generalized naming
  • explicit ownership boundaries
  • neutral defaults
  • configurable routing/inhibition policies
  • clear interop with SNN/reservoir siblings
  • docs that track both current behavior and intended evolution

It should stay a routing/relevance library, not a monolithic platform.

What landed recently (relative to early extraction)

Area Tracking / notes
Interop freeze LIM-228 / GH#14
Inhibition matrix LIM-229 / GH#23
Documenter deploy LIM-231 / GH#25
adapt_leak! generalization LIM-233 / GH#27
Checkpointing LIM-234 / GH#28
Worked examples GH#26 / related PRs
CI cache bump #38 (c9ff99c)

Last updated: July 29, 2026 Updated by: Grok Build: Grok 4.5 Package tip reference: c9ff99c (main)

Clone this wiki locally