Changelog¶
All notable changes to the sc-neurocore project will be documented in this file.
[Unreleased]¶
- Completed Aihara Model 43 from primary Eqs. 10–12 after separating the
original SC two-state recurrence into the preserved
SCChaoticMapNeuron: one-state source dynamics, Eq. 12 level events, all maintained language backends, paired schemas, independent trace, Q8.24 bounded co-simulation, depth-6 formal proof, and a pinned Figure 4 periodic benchmark. The preserved SC model independently has measured Python/Rust/Julia/Go/Mojo trajectory and event parity. The public polyglot-complete count is 43.
Native engine environment fidelity¶
- Made the checkout-shadow loading regression exercise both clean editable
maturin developlayouts and installed-wheel layouts. A stale engine package left outside the active distribution record can no longer be mistaken for a required part of the supported editable installation.
Adaptive-threshold IF source-to-co-simulation closure¶
- Reconstructed
AdaptiveThresholdIFNeuronas an explicitly composite reduced adaptive-threshold LIF: exact constant-input LIF membrane relaxation, the Mihalas–Niebur (2009) threshold equation at zero voltage coupling, and the Platkiewicz–Brette (2010) fixed post-spike threshold shift. Corrected the "Platkiewicz & Bhatt" typographical attribution and the descriptor'sintegration.method = "euler"mismatch; the voltage-dependent threshold equilibrium, voltage coupling, and adaptation current are recorded as the reduction boundary. Defaults are documented as catalogue/model-family choices. - Closed the complete contract end to end: validating atomic Python model
with a five-runtime measured-order dispatch; modular Rust engine and PyO3
batch binding; standalone Rust safety mirror; Julia, Go, and Mojo kernels
with real C ABIs; paired TOML/JSON exact-map schemas; an independent DOI
reference trace; Q32.32 co-simulation at the enrolled grid-exact operating
point (complete event vector identical, state error below
1.22e-8); a depth-4 Z3 reset-safety job; a source/binary-hashed five-runtime 200,000-step benchmark; and descriptor, catalogue, fidelity, validation, and generated documentation surfaces.
Alpha-synapse LIF source-to-co-simulation closure¶
- Reconstructed
AlphaNeuronfrom the Rall (1967) alpha kernel and the Gerstner-Kistler (2002) LIF framing, correcting the public Rall (1962) misattribution. The five-state exact piecewise-constant-input map now runs consistently through Python, modular Rust/PyO3, standalone Rust safety, Julia, Go and Mojo, with somatic-only reset and atomic failure semantics. - Added paired TOML/JSON schemas, an independent dual-drive reference trace, Q32.32 generated-RTL co-simulation with the full event vector preserved at both enrolled inhibitory levels, a depth-4 reset-safety job, and an honest source/binary-bound 200,000-step five-runtime benchmark.
Wilson-Cowan generated-RTL co-simulation¶
- Added paired-schema and generated Q32.32 Verilog trajectory co-simulation
for
WilsonCowanUnit. The 96-sample mixed-drive RK4 trace keeps both public E/I rates within0.021absolute error and inside the declared state envelope while the event output remains silent. Lookup-table quantisation and the absence of formal, synthesis, timing, device, or PPA evidence are explicit.
Threshold-linear-rate generated-RTL co-simulation¶
- Added paired-schema and generated Q16.16 Verilog co-simulation for
ThresholdLinearRateNeuron. The configured subtract-compare-multiply datapath preserves all 193 public rate words cycle-exactly across below, equality, and above-threshold inputs and keeps the event output silent. The absence of formal, synthesis, timing, device, or PPA evidence is explicit.
Sigmoid-rate generated-RTL co-simulation¶
- Added paired-schema and generated Q32.32 Verilog trajectory co-simulation
for
SigmoidRateNeuron. The 256-step sign-changing drive stays within0.016absolute rate error through the public RTL outputs, keeps every rate in[0, 1], and keeps the event output silent. The lookup-table quantisation and the absence of formal, synthesis, timing, device, or PPA evidence are explicit.
Resonate-and-fire source-to-co-simulation closure¶
- Reconstructed the Izhikevich (2001) complex resonator across Python, the
modular Rust engine, independent Rust safety, Julia, Go C-shared, and Mojo
shared-library execution. Every lane preserves the current-like
x, voltage-likey, exact constant-input flow, sampled upward voltage crossing, and generalised source resetz=i*threshold. - Added public atomic batch dispatch, paired schemas, an independently derived DOI trace, configured five-runtime trajectory parity, native invalid-contract tests, source/binary-bound local benchmark evidence, bounded generated Q32.32 H1 co-simulation, and a depth-4 reset-safety job. Sampled event timing, non-monotone high-drive behaviour, the fixed lookup-grid envelope, and the absence of formal equivalence or higher-silicon evidence are explicit.
Montbrió–Pazó–Roxin source-to-co-simulation closure¶
- Corrected the legacy
ErmentroutKopellPopulationattribution and promoted the actual Montbrió, Pazó, and Roxin (2015) equations (12a–b) through Python, the modular Rust engine, independent Rust safety, Julia, Go C-shared, and Mojo shared-library execution. All lanes restore the maintained variables throughR=tau*randt'=t/tauand use one simultaneous two-state Euler update. - Added public atomic batch dispatch, paired schemas, an independently derived DOI-pinned trace, configured five-runtime trajectory parity, native invalid- contract tests, source/binary-bound local benchmark evidence, bounded generated Q32.32 co-simulation, and a depth-4 reset-and-event-silence catalogue job. The compatibility name, continuous-rate output, Euler solver boundary, and absence of formal-equivalence, higher-silicon, or production-speed evidence are explicit.
Jansen–Rit source-to-co-simulation closure¶
- Promoted the Jansen and Rit (1995) equation-(6) neural mass through Python,
the modular Rust engine, independent Rust safety, Julia, Go C-shared, and
Mojo shared-library execution. All lanes use the published
C2*S(C1*y0)/C4*S(C3*y0)connectivity placement and simultaneous six-state explicit-Euler update. - Added public atomic batch dispatch, paired schemas, an independent DOI and Brian2-commit-pinned trace, configured five-runtime trajectory parity, native invalid-contract tests, source/binary-bound local benchmark evidence, and bounded generated Q32.32 co-simulation. The default solver step is documented as implementation scope; no higher silicon or production-speed result is claimed.
Wong-Wang source-to-co-simulation closure¶
- Promoted the Wong and Wang (2006) Appendix decision circuit through Python, the modular Rust engine, independent Rust safety, Julia, Go C-shared, and Mojo shared-library execution. All lanes use pre-update firing rates, simultaneous explicit-Euler NMDA gating, AMPA Ornstein-Uhlenbeck current states, and caller-supplied Gaussian samples.
- Added public atomic batch dispatch, paired serial-input schemas, an independent DOI and author-code-pinned trace, configured five-runtime trajectory parity, native invalid-buffer tests, source/binary-bound local benchmark evidence, and bounded generated Q32.32 co-simulation. The paper's 0.1 ms timestep is retained and the author-script 0.5 ms discrepancy is explicit; no higher silicon or production-speed result is claimed.
Wilson-Cowan polyglot closure¶
- Promoted the declared normalised Wilson-Cowan coupled E/I equations through Python, the modular Rust engine, independent Rust safety, Julia, Go C-shared, and Mojo shared-library execution. Every runtime advances both continuous rates with the same shifted-sigmoid, candidate-first RK4 contract.
- Added public atomic batch dispatch, paired TOML/JSON schemas, bounded complete-trajectory parity, configuration-preserving reset, native invalid- contract buffer tests, and source/binary-bound local benchmark evidence. Availability/refractory factors and independent inhibitory external drive remain explicitly outside this reduction; no spike, RTL, or hardware claim is made.
Schema and descriptor contract reconciliation¶
- Unified schema validation and execution around the same exact event-only predicate: empty state and dynamics are valid only for a non-empty deterministic level threshold or a Poisson probability expression. Added paired JSON schemas for both rate models and moved the live schema inventory baseline to 38 unique stems.
- Bound descriptor generation to the canonical schema/module alias table, public stochastic replay state, and the semantic integration labels for state-free maps and Poisson intervals. Regenerated only the nine descriptors affected by those rules and serializer normalisation.
- Reworked the Tier-3 evidence runner to retain integer currents, apply declared constructor configuration, accept both spiking tuples and continuous-rate arrays, and verify explicitly declared source-text digest encodings. This keeps IQIF and McCulloch-Pitts source-oracle hashes distinct from ordinary float-trace hashes while exercising every model's maintained public API.
Threshold-linear rate polyglot closure¶
- Promoted
ThresholdLinearRateNeuronto the explicit algebraic contractr = gain * max(0, I - theta)across the Python reference, modular Rust engine, independent Rust safety, Julia, Go C-shared, and Mojo shared-library lanes. The cached rate is not integrated state and is never counted as a binary spike. - Added real five-runtime build/loading and bit-exact parity tests, failure- atomic native buffers, configuration-preserving reset, a map schema, curated Gerstner-et-al. provenance, and source/binary-bound local benchmark evidence. No production-speed, fixed-point RTL, or hardware result is claimed.
Sigmoid-rate polyglot closure¶
- Added a configurable
SigmoidRateNeuron.simulatedispatcher across Python, the modular Rust-engine batch, Julia, generated Go C-shared ABI, and exported Mojo C ABI. The independent Rust-safety reset now restores only the dynamic rate and preservestau,beta,theta, anddt. - Added executed complete-trace parity, empty/large-step/invalid-contract boundaries, atomic native-output tests, and a source- and binary-hashed five-backend benchmark. The local timings are non-exclusive regression evidence and make no production, cross-host, hardware, or universal ranking claim.
- Clarified the scientific boundary: Wilson and Cowan (1972) motivate the population-rate sigmoid motif, while this class is a reduced scalar relaxation and does not claim the paper's full coupled excitatory/inhibitory system.
McCulloch-Pitts source-to-silicon closure¶
- Replaced the later real-weighted threshold abstraction with McCulloch and Pitts' 1943 all-or-none rule: a fixed positive count of simultaneously active excitatory afferents is required, while any active inhibitory afferent absolutely vetoes output. One synaptic delay remains a network scheduling boundary; the formal cell has no evolving membrane state.
- Added exact Python, Rust-engine, independent Rust-safety, Julia, Go, and Mojo varying-input execution with strict signed-ABI validation and atomic native failures. Paired stateless TOML/JSON schemas and an independent primary-paper truth table preserve the same OR, AND, equality, maximum-count, and inhibitory-veto rows.
- Kept the new PyO3 batch implementation in its per-neuron binding module and registered it through the existing neuron registry, leaving the Rust crate root unchanged relative to the accepted parent.
- Added registered and folded signed-Q32.0 Python-to-Verilog co-simulation and
a depth-4 Z3 catalogue safety job. The signed value
-1is reserved as the hardware inhibition sentinel; non-negative values carry excitatory counts. - Added a source- and binary-hashed five-backend benchmark. Its timings are single-logical-CPU, non-exclusive local regression evidence, not production, cross-host, hardware, or universal performance claims.
Predictive-model responsibility modularisation¶
- Replaced the 1,018-line mixed linear-Gaussian implementation with a 63-line historical facade over six bounded responsibility modules for contracts, native dispatch, filtering, smoothing, controlled EM, and planning-facing forecasts. Public imports, class identities, constructor names, and pickle paths remain stable.
- Corrected controlled EM sufficient statistics, lag-one covariance orientation, covariance validation, and fail-closed native result shapes. Filtering uses Cholesky solves and Joseph covariance updates without explicit matrix inverses. Every M-step candidate is likelihood-checked before acceptance, including the candidate produced by the final allowed iteration. Architecture contracts pin exclusive ownership, an acyclic import graph, the definition-free facade, and per-module size ceilings.
- Removed an out-of-bounds Mojo gain-workspace read for observation dimensions
wider than the latent state. A real
d=1, p=3parity case now exercises Python, Rust, Julia, Go, and Mojo through the maintained loading path. - The source- and binary-bound five-backend artifact records 25 interleaved samples, raw timing distributions, parity deltas, runtime versions, hashes, affinity, governor, load, and an explicit loaded-host disclosure. It is local regression evidence, not a cross-host or exclusive-core performance claim.
IQIF source-to-silicon closure¶
- Replaced the unsupported square-law approximation with the exact signed
integer recurrence in the Wu et al. (2021) coauthor implementation, pinned
to
twetto/iq-neuroncommita8752eba49dba9ba43a64be74090b91a51044b2f. The source is piecewise linear, uses a C++-truncated branch point and Q0.3 arithmetic shift, emits only abovev_max, hard-resets, and otherwise applies the lower clamp. - Added complete-contract Python, Rust-engine, independent Rust-safety, Julia, Go, and Mojo execution with atomic failure semantics and configured-parameter parity. Paired TOML/JSON schemas reproduce the independent 400-tick source trace exactly.
- Added registered and folded signed-Q32.0 Python-to-Verilog co-simulation and a depth-4 Z3 catalogue job. IQIF relies only on the signed compiler path; the evidence makes no unsigned-mode claim.
- Added a source-hashed five-backend benchmark with zero trajectory, event, or final-state mismatches. The committed timings are non-exclusive local regression evidence, not a production, cross-host, hardware, or universal speed claim.
- Expanded the public formal inventory to 50 proof jobs and 180 statements (150 assert, 7 assume, 23 cover), split across 18 non-catalogue and 32 catalogue jobs.
Poisson source-to-silicon closure¶
- Replaced the process-local random generator with the canonical seeded LFSR16 threshold contract shared by Python, the Rust engine and safety module, Julia, Go, Mojo, the schema interpreters, and generated Q24.24 RTL.
- The maintained binary-bin recurrence uses
p = 1 - exp(-rate_hz * dt_ms / 1000), advances exactly one trial per accepted bin, preserves deterministic reset replay, and rejects invalid work before committing the caller-visible RNG state. - Added full-contract backend parity and loading tests, a complete-period statistical reference artifact, registered/folded RTL co-simulation, a depth-4 Z3 safety job, descriptor/readiness evidence, and a source-hashed five-backend benchmark. Recorded timings are labelled non-exclusive local regression evidence rather than a universal performance claim.
Neuromorphic profile responsibility modularisation¶
- Replaced the 1,065-line mixed registration module with a 65-line stable facade over bounded event-driven (194 lines), programmable/aerospace (202), heterogeneous-accelerator (271), memory-compute (225), and physical-compute (249) modules.
- Preserved every field of all 70 profiles at SHA-256
c21e2075bb98787db31afbaa0c41cb6300e6707663de49b6630d6b5dbb3d1d41, their historical registry insertion order, the facade's publicHardwareProfileidentity, and duplicate-registration failure semantics. - Architecture contracts pin exact responsibility ownership, registry-only private dependencies, the 18-step facade composition order, fully typed and documented registrars, side-effect-free private reloads, public class filters, and module-specific ceilings. The 206-test focused platform cohort covers all 108 statements and two branches exactly.
- Refreshed the generated API and capability inventory on accepted parent
33d74f904. The generated delta includes that commit's EscapeRate API, one validation page, and four tests plus this lane's architecture test; the nine unrelated uncommitted Rust safety files are not represented. - Registered the already-landed COBA-LIF and EscapeRate evidence pages under the public Validation navigation, closing their inherited policy gap.
- Strict MyPy, Ruff lint/format, NumPy docstrings, Bandit, generated API and
capability checks, SPDX, navigation policy, and strict MkDocs pass. A clean
33d74f904overlay wheel contains all five private modules, preserves the 194-profile registry, exact 70-profile digest/order, and 349-line platform CLI output, and has SHA-2565bfb86a0c65ccb2c394fbededbb6992368a8b3825842b4dc7654f8ebd579e185. - The split only reorganises static Python catalogue metadata. It does not validate vendor specifications, alter a numerical runtime kernel, introduce Rust/Go/Julia/Mojo ownership, or create a throughput claim.
Photonic emitter responsibility modularisation¶
- Replaced the 1,109-line mixed photonic emitter with a 64-line definition-free compatibility facade over types (106 lines), bitstream conversion (117), FDTD (297), compilation/GDSII (281), Meep (218), crosstalk (321), and bitstream emission (83).
- Preserved the historical public exports, callable signatures, class identity, pickle paths, monkey-patchable engine boundary, and deterministic valid-output digests. Architecture contracts pin exclusive ownership, the acyclic import graph, facade purity, and per-module ceilings.
- Hardened finite and physical validation, fixed zero-length and 2D waveguide
edge cases, and made unavailable Meep execution raise
ImportErrorinstead of returning synthetic results. The 102-test focused cohort covers every one of the 702 statements and 214 branches in the eight governed Python modules. - Replaced crosstalk placeholders with executable Rust, Go, Julia, and Mojo pair/bank/batch contracts. These mirrors cover crosstalk only; Python owns FDTD, Meep, compilation, netlist, GDSII, and filesystem effects. The committed 4,096-pair benchmark is local, loaded, non-isolated evidence and is explicitly ineligible for a universal performance claim.
UVM generator responsibility modularisation¶
- Replaced the 1,138-line mixed UVM generator with a 55-line historical facade over RTL-contract/parser (183 lines), configuration (103), generated-artifact packaging (57), UVM component emitters (509), simulator/formal harness emitters (268), and orchestration (125).
- Preserved the exact 13 package exports, signatures, object identities, pickle-qualified paths, private emitter methods, and six representative default/configured parent payload SHA-256 values. Those payloads cover every generated artifact, file-list entry, and formal link.
- Architecture contracts pin exclusive class ownership, the acyclic dependency graph, facade and module ceilings, and deterministic payloads. The 82-test focused package cohort covers all 422 statements and 112 branches exactly; strict MyPy, Ruff, NumPy docstrings, and Bandit pass on the split surface.
- This is a behaviour-preserving Python text-generator refactor. The architecture map still labels emitted UVM/formal execution as draft; no vendor-UVM compile, polyglot, or throughput promotion is claimed. Existing generated Go/Rust/Julia/Mojo placeholders remain explicit adjacent debt.
CMOS profile responsibility modularisation¶
- Replaced the 1,145-line CMOS profile registration GodFile with a 67-line stable facade over bounded FPGA (562 lines), conventional-accelerator (295), architecture-paradigm (181), embedded-processor (140), and ASIC/simulation reference (90) modules.
- Preserved every field of all 72 profiles at SHA-256
0d72e74b9a779dd3a98b70817a12fac902528e741cea3772a7dc6bf37be20fc9, their historical registry insertion order, the facade's publicHardwareProfileidentity, and duplicate-registration failure semantics. - Architecture contracts pin exact responsibility ownership, a registry-only private import graph, facade composition order, side-effect-free private module reloads, and module-specific ceilings. The 197-test focused platform cohort covers all 111 statements and two branches exactly.
- Strict MyPy, Ruff lint/format, NumPy docstrings, Bandit, public-docstring and
generated-doc checks, capability-manifest checks, and strict MkDocs pass.
The installed wheel contains all five private modules, preserves the exact
digest/order and CLI surface, and has SHA-256
60092f90bb902fa57e5c8f41e7adbc5ee22536c5fa726685729e650446544e01. - The generated API/capability refresh is based on accepted parent
f431710c3: it includes that commit's COBA-LIF API, validation page, and five tests plus this lane's architecture test. No uncommitted peer work is represented in those generated surfaces. - Refreshed the hardware-profile guide against the live registry: 194 profiles, 38 classes, and 121 vendors. The split only reorganises static Python metadata; no numerical kernel, Rust/Go/Julia/Mojo mirror, or throughput claim applies.
Studio training responsibility modularisation¶
- Replaced the 1,208-line Studio training GodFile with a 311-line historical facade and bounded execution, parent-control, weight-attach, and event-codec modules. Architecture contracts enforce the one-way dependency graph and module-specific size ceilings.
- Preserved the 14-name public export set, callable signatures,
stream-generator contract, pickle identity, and all 12 composed HTTP routes.
A seeded real-Torch run retains the established metrics,
64->8->10architecture, 610 parameters, and learned tensor-state digest. - The 131-test focused training cohort covers all 562 statements and 128 branches across the five split modules. Live attach now fails closed for a thread-backed target or a target that stops during control delivery instead of acknowledging a command that cannot be consumed.
- Strict MyPy, Ruff lint/format and NumPy docstrings, Bandit, scoped public
docstrings, SPDX, generated API/capability and OpenAPI checks, and strict
MkDocs pass. The installed wheel contains every responsibility module,
preserves facade and pickle identity, and completes a real Torch training
smoke; its SHA-256 is
10ffc95f29937cc34783ad9e7ac478622d5a41708390522700508c4c0b2dcdd0. - This is a behaviour-preserving Python/PyTorch service refactor. No functional Rust, Julia, Go, or Mojo Training Monitor counterpart is wired, and no cross-language or throughput claim is introduced.
DPI coupled-circuit source-to-silicon closure¶
- Replaced the historical one-state DPI surrogate with the coupled current-domain silicon-neuron equations from Indiveri, Stefanini, and Chicca (2010), Eqs. (2)–(3). The maintained Python, Rust engine and safety, Go, Julia, and Mojo paths now share nonlinear positive feedback, membrane and after-hyperpolarisation states, simultaneous explicit Euler updates, post-update reset, and spike-driven refractory-pulse semantics.
- Added source-bound parity and fail-closed ABI contracts over the enrolled
current vector. All five runtime lanes preserve
0/0/0/0/1/3/6/11/21events atI=-0.1/0/1/2/3/5/10/20/50over 1,000 steps, with floating-state differences below5e-13and invalid work rejected before visible state or buffer mutation. - Enrolled paired TOML/JSON schemas, generated Q16.16 RTL, co-simulation,
reference-trace, descriptor, benchmark, and formal evidence. The fixed-point
path preserves 13 events at
I=5over 5,000 steps within its declared state and timing envelopes, and the generated depth-4 Z3 proof passes. Controlled benchmark timings remain explicitly local, loaded-host evidence rather than isolated throughput claims. - Corrected clean-checkout native loading and regeneration. The source bridge
now resolves the extension installed by
maturin develop, while the Go build hint compiles the package so the generated C header retains its committed package identity and source digest.
Bus-interface responsibility modularisation¶
- Replaced the 1,221-line bus-interface GodFile with a 179-line historical compatibility facade, a 393-line AXI4-Lite/Wishbone wrapper renderer, a 608-line AXI4-Lite live-parameter-bank core renderer, and a 175-line PCIe register-window adapter. Architecture contracts enforce bounded modules, the one-way import graph, the exact public export set, and private renderer ownership.
- Split the 1,012-line mixed live-control test surface into static contract, AXI4-Lite execution, PCIe execution, wrapper/register-map, and architecture suites. The 119-test focused integration cohort passes; the four production modules cover all 184 statements and 66 branches exactly. Strict MyPy, Ruff, Bandit, NumPy docstrings, public-docstring policy, SPDX, generated API and capability checks, strict MkDocs, and installed-wheel smoke checks pass.
- Preserved the historical function identities and signatures and the exact
parent-generated bytes for representative AXI4-Lite, Wishbone, empty-wrapper,
AXI live-bank, PCIe live-bank, and register-map payloads. The installed wheel
contains every responsibility module and has SHA-256
0fb62c38bf9eeb26fa8a291880a335864d90f17de8bb53bae289bcaa35ae26ce. - Refreshed the Python/SystemVerilog live-control evidence with executable AXI trap and PCIe commit simulations. The affinity-only, powersave-governor timings remain local diagnostic context, not a production throughput claim; no Rust, Julia, Go, or Mojo counterpart exists for this HDL adapter surface.
Cortical-column responsibility modularisation¶
- Replaced the 1,259-line cortical-column GodFile with a 733-line historical public runtime, a 146-line optional-backend discovery boundary, a 395-line sparse-connectivity builder, and a 121-line published-parameter module. Architecture contracts enforce the acyclic dependency direction and bounded file sizes.
- Preserved the exact public constructor signature, class module and qualified name, direct constant re-exports, backend capability flags, reload patch points, and RNG draw order. Parent and candidate fingerprints match for the single-delay per-pair, distributed-delay per-pair, and distributed-delay block-CSR modes.
- The 76 focused passing tests plus one optional-backend skip cover all 553 statements and 170 branches exactly. Strict MyPy is clean across the four source and two strict contract files; Ruff, Bandit, scoped NumPy-docstring, SPDX, generated API-reference, and capability-manifest checks pass.
- This is a behaviour-preserving Python responsibility split. The existing Rust, Julia, Go, and Mojo sparse-kernel contracts are unchanged, and no new throughput or scientific-fidelity claim is introduced.
Studio jobs responsibility modularisation¶
- Replaced the 1,311-line Studio jobs GodFile and its 1,496-line test GodFile with a 95-line historical facade, nine focused implementation modules, shared architecture support, seven responsibility-focused behavior suites, an architecture suite, and a compact adversarial sentinel. The largest implementation and test files are 295 and 284 lines. The exact 18-name public export contract preserves object identity, qualified names, and pickle paths through an acyclic runtime import graph.
- The 64-test focused suite covers all 650 statements and 120 branches exactly, and the full 1,174-test Studio prefix remains green. A dedicated Python 3.12 workflow measures the jobs modules independently of the repository-wide Studio coverage exclusion. Adversarial cases cover malformed control payloads, seed-size boundaries, corrupt stored job paths, symlink escape, absent work directories, invalid seed types, and cross-drive path handling.
- Parent and candidate retain the same 18-export, five-route jobs contract at
SHA-256
8bc27f16c8d97e33cc0cb5d21c15a775c5c070354282c12e84e52732a3fefd5c. - This is a Python-only Studio control-plane and filesystem-confinement refactor. It preserves thread and isolated-process execution behavior and makes no numerical-kernel, cross-language-mirror, or throughput claim.
Studio policy responsibility modularisation¶
- Replaced the 1,319-line Studio policy GodFile and its 1,135-line test file with a 78-line compatibility facade, nine focused implementation modules, shared test support, eight focused test modules, and an import-only sentinel. The largest implementation and test files are 249 and 272 lines. Historical package and module imports preserve object identity, qualified names, and pickle compatibility through an acyclic responsibility graph.
- The 53-test focused suite covers all 412 statements and 96 branches, and the
full 1,165-test Studio suite remains green. A dedicated Python 3.12 workflow
enforces exact coverage independently of the repository-wide Studio
exclusion. The parent and candidate retain the same duplicate-free 114-route
registry at SHA-256
452152885f8f5dbf97b4a76b2d30868c3fbded2984d2828dfe273e57834d5084. - Verified parent-produced pickle compatibility and an isolated installed-wheel import of every split module. This is a Python-only Studio control-plane and security contract, not a numerical kernel, so no cross-language mirror or throughput benchmark is claimed.
Theta exact-flow source-to-silicon closure¶
- Exposed the tangent-half-angle exact constant-current flow through Python, the Rust engine and safety module, Julia, Go, and Mojo. Julia, Go, and Mojo carry the complete phase/timestep contract; the Rust engine retains its explicit factory-default boundary, and an executable safety probe covers the standalone Rust implementation.
- Added an executable 11-point current vector for every compiled lane, bounded
circular phase parity at
2e-12, fail-closed C ABI buffer contracts, focused 100% coverage for the Python dispatcher and backend wrapper, and a controlled single-CPU benchmark with source hashes and host-load evidence. - Preserved the existing Euler schema/compiler boundary and upgraded its proof:
paired TOML/JSON schemas and generated Q16.16 RTL retain the complete event
count vector, moderate-regime circular phase error stays below
0.17rad, the I=1 one-cycle timing displacement is explicit, and the generated depth-6 Z3 formal job remains enrolled.
Hierarchical partitioner responsibility modularisation¶
- Replaced the 1,324-line hierarchical partitioner and its two oversized test surfaces with a 104-line compatibility facade, ten focused implementation modules, shared test support, and nine focused test modules. The largest implementation and test files are 258 and 291 lines. All 21 established public definitions preserve their package and historical imports, identities, qualified names, and pickle paths through an acyclic responsibility graph.
- The exact 111-test owning suite covers all 664 statements and 186 branches. Backend decoding fails closed on incomplete, duplicate, or out-of-range partition maps; architecture tests enforce one public owner, dynamic runtime diagnostics, file-size limits, the CI gate, and the distinction between real kernels and generated mirrors.
- Retained the maintained Rust, Julia, Go, Mojo, and Python KL-refinement chain
and removed four non-executable generated mirrors. The source-bound parent and
candidate benchmarks produce the same canonical partition SHA-256
258b5c0c54ea33758f60090e68b7ce2a7657800ec16a6c90bc0eb52fbbd3585facross every workload and backend. Affinity-only, powersave-governor timings are explicitly diagnostic and do not claim isolated throughput.
Portable Tier-3 golden traces¶
- Replaced the false assumption that NumPy transcendental traces are byte- identical across heterogeneous x86 runners with an explicit exact-hash variant contract. The Chialvo and Hodgkin-Huxley descriptors record the measured AVX-512 and portable-kernel digests; no arbitrary digest is accepted.
- Added a regression that reruns every variant-bearing model with AVX-512
disabled, confirms both the native and portable digests are declared, and
enforces the existing
1e-9numeric-parity ceiling. The observed boundaries are one ULP for Chialvo and1.902e-11maximum absolute error for Hodgkin- Huxley, with unchanged events.
Quadratic IF exact-flow source-to-silicon closure¶
- Exposed the exact constant-current Riccati flow through Python, the Rust
engine, Julia, Go, and Mojo. Julia, Go, and Mojo carry the complete numeric
contract through real executable ABIs; the Rust engine retains its explicit
factory-default boundary, and an independent executable probe exercises the
actual Rust-safety module. Dedicated tests preserve exact events at eight
currents and bound every compiled voltage trace to
2e-12from Python. - Replaced the raw mirror-style timing record with a source-hashed public-API benchmark and executable Rust-safety gate. The CPU-10 affinity-pinned, non-reserved powersave-governor run records 2,631 events and zero observed trace difference in every lane. Its heavy host load and empty isolated-CPU set make the timings local regression evidence rather than a throughput claim.
- Added dedicated hand/schema/RTL fidelity evidence. The paired Euler schemas
preserve the exact-flow hand model's event sequence over a varied 1,000-step
drive with state error below
0.006and reset inclusively at the configuredv_peak, including an exactly-equal Euler candidate. Q16.16 RTL retains the complete enrolled event vectors at I=0/0.333/0.5/1/2/5/20/50 with voltage error below0.011. The I=0.1 one-cycle reset displacement is declared rather than hidden, and the regenerated depth-20 Z3 job proves the inclusive threshold RTL.
Perfect Integrator source-to-silicon fidelity closure¶
- Exposed the candidate-first non-leaky Euler recurrence through Python, the Rust engine, Julia, Go, and Mojo. Julia, Go, and Mojo carry the complete numeric contract; the Rust engine keeps its explicit factory-default boundary. Dedicated source-golden tests preserve bit-exact traces and 0/32/66/200/250/500/1,000 events at I=0/0.333/0.7/2/3/5/20 over 1,000 steps.
- Added a source-hashed five-backend public-dispatch benchmark. The CPU-10 affinity-pinned, non-reserved powersave-governor run records 50,000 events and zero trace difference in every lane. Its high host load and empty isolated-CPU set make the timings local regression evidence rather than a production throughput claim.
- Strengthened the existing schema-to-RTL evidence from a saturated-only point to 66-event hand/schema/Q8.8 parity at I=0.7 over 1,000 steps. The I=0.333 quantisation boundary is recorded honestly as 32/32/31; the existing analytic sawtooth reference and generated depth-20 Z3 proof remain cross-wired.
Bioware responsibility modularisation¶
- Replaced the 1,378-line biological-interface implementation and 1,139-line test GodFile with a 129-line compatibility facade, nine focused responsibility modules, shared validation, and 13 focused test modules. The largest implementation and test files are 296 and 253 lines. All established package and historical imports preserve object identity, qualified names, and pickle compatibility through an acyclic dependency graph.
- The 200-test focused suite covers all 1,052 statements and 384 branches. Contracts now reject invalid MEA shapes and values, AER overflow, out-of-window events, inconsistent payload counts, unsafe optical-power arithmetic, invalid Q8.8 state, audit reordering, and partial session round advancement.
- Removed non-executable generated Go, Julia, Mojo, and Rust Bioware mirrors. The maintained full orchestration is Python-only; independent Julia plasticity solvers remain a separate numerical surface.
- Added a source-bound 30-sample parent/candidate benchmark. Both trees produce
the same 6,865-byte canonical MEA-to-opto payload at SHA-256
2491dc73a2de93a45a1cc944539c170b151403e42b973b18806143f318b7d669. The affinity-only, loaded-host timing regression is documented as local diagnostics and is not a throughput or hardware claim.
Lapicque exact-flow source-to-silicon closure¶
- Exposed the maintained exact constant-current RC recurrence through Python,
the Rust engine, Julia, Go, and Mojo. The public dispatcher follows the
committed measured Mojo/Julia/Go/compatible-Rust/Python order; Julia, Go, and
Mojo transport the complete numeric contract, while the Rust engine retains
its explicit factory-default boundary. Dedicated native-path tests preserve
0/0/71/200/500 events at I=0/0.5/2/5/20 over 1,000 steps and bound every
compiled trace to
2e-15from Python. - Replaced the earlier mirror-style benchmark with a source-hashed public-API
harness and committed five-backend result. The single-logical-CPU,
powersave-governor run records 20,000 events in every lane and a maximum
voltage difference of
4.44e-16; its high host load and absent isolated-CPU set make the timings local regression evidence rather than a throughput claim. - Aligned the paired schemas and generated RTL with exponential-Euler lowering
and inclusive candidate thresholding. Hand, TOML, and JSON event vectors are
exact and their state traces remain within
2e-15; Q16.16 RTL retains complete event vectors at I=0.333/2.3/20.25 over 1,000 steps with voltage error below0.04. The translation DOI, independent closed-form trace, S5/H1 descriptor, readiness evidence, and depth-20 Z3 proof are cross-wired.
NIR hardware-graph responsibility modularisation¶
- Replaced the 1,414-line hardware-graph implementation and three primary test files totalling 4,091 lines with an 84-line compatibility facade, seven acyclic responsibility modules, and 40 focused test/support modules. All 28 established definitions preserve their historical imports, qualified names, identities, and pickle paths.
- The focused package passes 240 tests with two optional-runtime skips and
covers all 651 statements and 324 branches. A dedicated Python 3.12 workflow
enforces exact statement and branch coverage over every
neuron_graph*.pymodule independently of broader NIR exclusions. Parser, optional-framework, SC-NIR, FPGA, file-I/O, hierarchy, dense, delay, threshold, and metadata boundaries remain exercised through their maintained entry points. - Added a source-bound 30-sample parent/candidate benchmark. The maintained
two-population graph produces the same 22,860-byte FPGA compilation payload
at SHA-256
32498fa1106229a4fe064862e20b86e0f0b1f0d42f8598d1988e06e68c13ef13. Affinity-only, non-reserved CPU timing medians are local regression diagnostics, not throughput claims. Cross-language kernels do not apply to this typed NIR metadata and FPGA-orchestration refactor; neuron-dynamics implementations are unchanged.
ExpIF source-to-silicon fidelity closure¶
- Bound
ExpIFNeuronto Fourcaud-Trocmé et al. (2003), Eqs. 6 and 10, DOI10.1523/JNEUROSCI.23-37-11628.2003. Python, Rust safety, the Rust engine, Go, Julia, and Mojo now share the candidate-first RK4 recurrence, fitted defaults,+30 mVfinite cutoff, and fail-closed event handling. The optional1.7 msfitted refractory protocol remains explicit rather than changing the zero-refractory catalogue default. - Dedicated production-boundary tests preserve
0/0/2events atI=0/5/20over 1,000 steps. Compiled traces stay within5e-8of Python; Rust, Julia, Go, and Mojo expose real executable paths, while the Rust engine boundary remains factory-default-only. - Replaced the resting approximation trace with an independently integrated DOI-bound driven trace. Hand, TOML, JSON, and generated Q32.32 RTL preserve the enrolled event counts; Q16.16 is explicitly excluded. The S5/H1 descriptor, readiness index, catalogue RTL, and depth-4 Z3 proof are cross-wired, moving the formal catalogue from 26 to 27 jobs.
- Added a source-hashed, single-logical-CPU five-backend benchmark. The
committed powersave-governor run records 523 events in every lane and a
maximum voltage difference below
5e-8; its loaded-host timings are local regression evidence rather than a throughput claim.
AdEx five-backend baseline-Euler closure¶
- Added executable Rust-safety, Go, Julia, and Mojo recurrence coverage around the maintained Python AdEx model and Rust engine path. Public dispatch carries the complete numeric contract through Julia/Go/Mojo, keeps the factory-default Rust boundary explicit, and fails closed on invalid state or candidates.
- Dedicated parity tests preserve
0/4/12events atI=0/200/500over 1,000 steps and bound every compiled voltage trace to5e-12from Python. The existing DOI-backed independent reference and Q16.16 Python-to-Verilog co-simulation remain the declared source and H1 hardware evidence. - Added a source-hashed, single-logical-CPU benchmark for all five public paths.
The committed powersave-governor run records 1065 events in every lane and a
maximum trace error of
7.40e-13; its loaded-host timings are local regression evidence, not a hardware throughput claim.
Hodgkin-Huxley executable Mojo lane¶
- Replaced the non-executable parity note with a compiled C ABI for the complete four-state Hodgkin-Huxley recurrence. The Python dispatcher carries the maintained numeric state and parameter surface, mirrors the historical gate-first baseline-Euler schedule, and fails closed on invalid inputs or candidates without partially committing state.
- Dedicated production-boundary tests preserve
0/6/9events atI=0/10/20over 100 macro-steps. Mojo's exp/FMA trace stays within the measured2e-9envelope, including non-default state and parameter transport; an RK4-configured instance is rejected rather than silently changing its integrator. - Added a source-hashed, single-logical-CPU benchmark for Python, the Rust engine, and Mojo. The recorded timings are loaded-host local regression evidence; event parity, trace bounds, source digests, final states, affinity, governor, load, and runtime versions are the maintained contracts.
Connor-Stevens executable Mojo lane¶
- Replaced the non-executable Mojo parity note with a compiled C ABI for the complete six-state Connor-Stevens recurrence. The public Python dispatcher carries the maintained state and parameter surface, uses the same 100 candidate-first RK4 sub-steps per macro-step, and fails closed on invalid inputs or candidates.
- Dedicated production-boundary tests preserve the established
0/2/9event counts atI=0/10/20over 100 macro-steps. Mojo's transcendental/FMA trace remains within the measured2e-6absolute envelope, including non-default state and parameter transport. - Added a source-hashed, single-logical-CPU benchmark for Python, the Rust engine, and Mojo. The recorded timings are loaded-host local regression evidence; event parity, trace bounds, source digests, final states, affinity, load, and runtime versions are the maintained contracts.
ASIC-flow GodFile modularisation¶
- Replaced the 1,451-line implementation and 814-line primary test file with a 123-line compatibility facade, nine acyclic responsibility modules, and 11 focused test modules. The largest implementation and test files are 319 and 234 lines. All 38 historical definitions retain identity, qualified names, and pickle compatibility.
- The focused suite passes 100 tests and covers all 580 statements and 66 branches. Strict touched MyPy, Ruff, NumPy docstrings, architecture, package, and benchmark-source contracts pass.
- Removed nonfunctional Rust, Go, Julia, and Mojo ASIC-flow mirrors. The real boundary remains Python deck generation followed by external EDA execution. A source-bound 30-sample benchmark proves the 10,465-byte parent/candidate output is identical. Its affinity-only, loaded-host timings are local regression context rather than throughput or physical-design evidence.
Evolutionary-substrate GodFile modularisation¶
- Replaced the 1,737-line implementation and 1,227-line primary test file with a 156-line compatibility facade, 14 acyclic responsibility modules, and 18 focused test modules. The largest implementation and test files are 304 and 312 lines. All 56 historical exports retain object identity, qualified names, and pickle compatibility; deterministic parent/candidate Python-fallback workflows are byte-identical.
- The focused suite passes 160 tests with real Mojo and four-runner parity paths. The 135-test core covers all 1,005 statements and 166 branches. Native Rust, Julia, Go, and Mojo checks pass 17, 17, 8, and 7 tests, while the 18-test cross-language runner suite completes without skips. Strict touched MyPy, Ruff, NumPy docstrings, Bandit, SPDX, and wheel smoke checks pass.
- Rebuilt the Python and five-language benchmark producers around 30-sample schema-v2 evidence with raw samples, source digests, runtime versions, affinity, governor, frequency, and load context. The committed run had no kernel-reserved cores and heavy concurrent load, so its values are local regression diagnostics rather than publishable throughput claims.
Ibarz-Tanaka four-branch source-to-silicon correction¶
- Replaced the unsupported beta-based rational/linear hybrid with Ibarz,
Tanaka, Sanjuan, and Aihara (2007), DOI
10.1103/PhysRevE.75.041902, Eqs. 2–3: four fast-map branches and the simultaneous slow updateu_next = u - mu*(v + 1 - sigma). Events now identify execution of the source's fixed-1reset branch; the stale 2011 review citation,beta, configurable threshold, and configurable reset were removed. - Rebuilt the fail-closed Python, Rust engine, Rust safety, Go, Julia, and Mojo
paths around the same recurrence. Rust, Julia, and Go are bit-exact across
the 1,000-step
I=0/0.2/1envelope; Mojo preserves event vectors below a measured1.5e-8absolute band. The source-hashed 21-call pinned benchmark atI=0.2records 33 events in every lane. The host had no kernel-isolated CPU set and high load, so its timings are local regression evidence. - Added paired TOML/JSON schemas and an independently re-derived DOI reference.
Hand/TOML/JSON agree exactly. Over the bounded 30-step
I=0.2co-simulation, Q16.16 RTL preserves all three reset events with maximumv/uerrors below0.003/0.0001while exercising every source branch. Q8.8 is invalid becausemu=0.001quantises to zero. - The S5/H1 descriptor, readiness evidence, generated Q16.16 catalogue core,
and depth-4 Z3 proof are cross-wired. The polyglot-complete model count is
unchanged; schema-gap counts move to
33 / 120 / 122, the catalogue inventory moves to 26, and the whole HDL inventory moves to 63 jobs / 211 statements.
Chiplet responsibility modularisation¶
- Replaced the 1,744-line chiplet implementation and 1,223-line primary test file with a 98-line compatibility facade, seven focused public-responsibility modules, one private SystemVerilog helper, and focused tests below 500 lines. All 36 historical imports, qualified names, and pickle identities remain stable. Canonical three-die EMIB generation remains byte-identical.
- Added finite physical-boundary validation and direct topology, routing, thermal, RTL, link-protocol, power-domain, partition, and architecture contracts. The focused package cohort passes 172 tests; exact-file coverage reaches all 680 statements and 202 branches, with strict MyPy and Ruff clean.
- Removed nonfunctional Rust, Go, Julia, and Mojo chiplet-control mirrors and their Rust registry entries. The source-bound 30-repeat benchmark now records the maintained Python path, including complete generation for 2, 8, and 32 dies. Non-exclusive host load and validation overhead make the old/new values diagnostic evidence rather than promotion claims.
Quantum-annealing GodFile modularisation¶
- Replaced the 1,910-line quantum-annealing implementation and 1,001-line
primary test GodFile with a 98-line compatibility facade, nine acyclic
responsibility modules below 400 lines, and focused typed tests below 500
lines. All 24 historical imports and pickle identities remain stable. The
linked cohort passes 250 tests with one optional
nealskip, while 216 exact-file tests cover all 1,040 statements and 442 branches. - Corrected the exact QUBO-to-Ising diagonal offset, made backend selection explicit, validated native and QPU boundaries, hardened compiler/model/ schedule/sample inputs, made JSON exports atomic, and retained exact global indices through overlapping decomposition.
- Removed nonfunctional generated Rust safety, Go, Julia, and Mojo mirrors.
The maintained native authority remains
engine/src/quantum.rswith 12 focused tests. The source-bound 30-sample local benchmark records +99.65% compile, -25.37% cold import, -16.67% Python solve, -23.21% process wall, and -3.48% RSS median changes. Rising non-exclusive host load makes these regression diagnostics, not release or quantum-speedup evidence.
Medvedev slow-calcium first-return source-to-silicon correction¶
- Replaced the repository's falsely attributed tent map with the scalar
slow-calcium first-return construction derived in Section 4 of Medvedev
(2005), DOI
10.1016/j.physd.2005.01.021. Its three source regions follow equations 4.4/4.7, 4.8 with 4.13, and 4.15. The paper does not tabulate one unique global pair of return functions, so the complete calibration is disclosed. Non-zero current and the pre-state event label remain explicit SC-NeuroCore conventions. - Rebuilt the fail-closed Python, Rust engine, Rust safety, Go, Julia, and Mojo
paths around the same recurrence. Rust, Julia, and Go are trace-identical on
the enrolled envelope; Mojo retains exact event vectors below a
5e-13trace band. The source-hashed 500,000-iteration benchmark records 375,000 events in every lane and medians of 8.230 ms Julia, 10.799 ms Rust, 19.524 ms Mojo, 20.959 ms Go, and 242.929 ms Python on its recorded host. - Added paired TOML/JSON schemas and an independently re-derived Section 4
reference contract. At
I=2, hand/TOML/JSON agree exactly and Q16.16 RTL preserves the complete 75-event vector over 100 iterations with maximum state error below0.007813. Q8.8 cannot represent the calibratedd=2271.1927977404063, so both behavioural RTL and the generated catalogue core use Q16.16. The shared log LUT has 256 positive-domain entries over[1/256, 8 + 1/256)at step1/32. - The S5/H1 descriptor, readiness evidence, generated Q16.16 catalogue core,
and depth-4 Z3 proof are cross-wired. The public fidelity count remains 21,
schema-gap counts move to
32 / 121 / 123, the catalogue inventory moves to 25, and the whole HDL inventory moves to 62 jobs / 210 statements.
Studio responsibility-router and OpenAPI contract split¶
- Reduced
src/sc_neurocore/studio/app.pyfrom 3,662 lines to a 147-line composition root. Sixteen routers now own system, jobs, audit, identity, catalogue, presets, simulation, compiler, co-simulation, synthesis, design, deployment, training, training weights, export, and adaptive-precision responsibilities; shared runtime, security, schema, guard, preset-flow, and frontend helpers live beside them. - Preserved the complete hermetic API surface: 113 backend HTTP routes, 110
OpenAPI paths, and
/ws/progress. Canonical OpenAPI JSON remains byte-semantically equal to the clean pre-refactor document at SHA-256b1e698de8ce38e15f152a3bffdf86d24dc8f14c12747a927be320bcc25825cdb. - Kept the frontend root route conditional on the ignored
dist/build while excluding that UI document route from OpenAPI. Runtime and generated API contracts are therefore identical in local, CI, and clean-worktree builds. - Added deterministic
tools/generate_studio_openapi.pygeneration, a committed JSON reference, MkDocs API guidance, route-ownership assertions, normalized handler parity checks, and public-route coverage for terminal, validation, isolation, policy, audit, identity, frontend, and artifact failure boundaries.
Hindmarsh-Rose RK4 schema-to-RTL enrolment¶
- Re-enrolled the already acceleration-complete Hindmarsh-Rose model against
Hindmarsh and Rose (1984), DOI
10.1098/rspb.1984.0024. Paired schemas now reproduce the maintained three-state RK4 hand flow, no-reset state, and upwardx >= x_thresholdobservation. The former explicit-Euler schema's identity reset had disabled crossing-edge history and counted every above-threshold timestep as an event. - The hand model and both schema formats agree across a varied 1,200-step
sequence. Over 2,000 steps, hand/TOML/JSON/Q16.16 RTL crossing counts are
exactly
0/0/26/40/52atI=0/2/3/4/5. The longer 5,000-step chaotic boundary is explicit: Q16.16 reports10/49/86/115crossings atI=2/3/4/5, one more than float64's9/48/85/114. - The DOI-backed reference is independently re-derived with classical RK4.
The S5/H1 descriptor adds a generated Q8.8 port-only formal job whose
depth-4 SymbiYosys/Z3 check passes. Existing model, acceleration,
backend-parity, and benchmark artefacts remain unchanged; schema-gap counts
stay at
31 / 122 / 124, while the formal catalogue moves to 24 jobs and the whole HDL inventory to 61 jobs / 209 statements.
Chialvo source-to-silicon fidelity enrolment¶
- Bound
ChialvoMapNeuronto Chialvo (1995), DOI10.1016/0960-0779(93)E0056-H. The Python and compiled lanes now share the paper's simultaneousx*x*exp(y-x)+k+I,a*y-b*x+crecurrence and reject non-finite candidates without committing them. The paper permits a constant or time-dependent additive perturbation;kandcurrentrepresent those roles. The upwardx_threshold=1.0crossing is kept separate as a maintained observation convention. - Wired checked Rust-engine, Rust-safety, Go, Julia, and Mojo batch paths into
measured-order
autodispatch. Cross-language tests enforce one-step source-equation envelopes and identical 1,000-step event counts at six currents. The committed 500,000-iteration, five-repeat benchmark was pinned to one logical CPU and records 12,935 events in every lane. Its medians are 7.270 ms Rust, 9.576 ms Julia, 11.373 ms Mojo, 20.524 ms Go, and 2,175.866 ms Python; the JSON records that the host had no kernel-isolated CPU set. - Added paired TOML/JSON map schemas and an independent 100-iteration DOI
reference. Hand/TOML/JSON states and events are exact at
I=-0.05/0/0.01/0.1/1.0; Q16.16 retains event counts0/2/3/0/1and keeps stable-pointx/yerrors below0.055/0.093. Four and six oscillatory event positions shift atI=0/0.01, so timing identity is excluded explicitly. The S5/H1 descriptor adds a generated Q8.8 port-only formal job whose depth-4 SymbiYosys/Z3 check passes. The public fidelity count moves to 21; schema-gap counts move to 31 / 122 / 124; the formal catalogue moves to 23 jobs and the whole HDL inventory to 60 jobs / 208 statements.
Ermentrout-Kopell theta-Euler schema-to-RTL enrolment¶
- Enrolled
ermentrout_kopell_map_neuronagainst Ermentrout and Kopell (1986), DOI10.1137/0146017. Paired schemas reproduce the maintained hand recurrence exactly while separating the paper's continuous theta equation from the implementation'sdt=0.1, gain, forward-Euler,theta=pievent, and modulo2*pichoices. The independentI=0.5reference records 45 events over 2,000 steps; varied-drive tests require exact hand/TOML/JSON states and events. - Q16.16 RTL preserves 0/45/64 spikes at
I=-0.5/0.5/1.0over 2,000 steps, with maximum circular phase error below 0.081/0.089/0.025 rad. The cosine LUT can shift event positions, so event-vector and full-trajectory identity are withheld. Generated integer C/Rust kernels match generated Verilog state and event words cycle-for-cycle over the 240-step protocol for both current signs. - The equation runtime and generated backends now expose
<state>_prevat the macro boundary and lower modulo only for a representable finite positive literal, with the negative-remainder correction required to match Python. The S5/H1 descriptor adds a Q8.8 port-only formal job; its depth-4 Z3 BMC passes. All 21 earlier jobs regenerate byte-identically, the inventory moves to 22, and schema-gap counts move to 30 / 123 / 125. Existing acceleration and benchmark artefacts remain unchanged.
Courbage-Nekorkin-Vdovin bounded schema-to-RTL enrolment¶
- Enrolled the already acceleration-complete 2007 discontinuous map
(
courage_nekorkin_map, DOI10.1063/1.2795435). The paired TOML/JSON schemas reproduce equations 3–5, including simultaneous state commits, all three fast-map branches, the Heaviside discontinuity, and the maintained upwardx_thresholdcrossing. The hand model and both schemas agree exactly across the enrolled operating set. - Q16.16 RTL is event-exact at
I=-0.3/0/0.3over bounded 30/20/30-iteration windows, with both state errors below0.014. Q32.32 RTL is event-exact at all three inputs over 30 iterations, with fast-coordinate error below0.00003and recovery-coordinate error below0.000001. A separate regression fixes the autonomous 30-iteration Q16.16 boundary at four float64 events, six RTL events, and six event-position mismatches. - The model-scoped co-simulation and independent-reference tests add a DOI-backed recurrence, S5/H1 descriptor/readiness facets, source-bounded public documentation, and generated Q8.8 RTL. The port-only depth-4 SymbiYosys/Z3 reset-spike safety job passes. The formal inventory moves to 21 models and schema-gap counts move to 29 schema models / 124 net missing / 126 source modules without a schema. The completed acceleration chain and its committed benchmark artefact remain unchanged.
Cazelles map bounded schema-to-RTL enrolment¶
- Enrolled the already acceleration-complete Cazelles, Courbage, and Rabinovich
(2001) fast/slow map (
cazelles_map, DOI10.1209/epl/i2001-00548-y). The paired TOML/JSON schemas mirror the maintained hand model's simultaneous clipped logistic fast recurrence, slow update from the old fast coordinate, and committed-statex >= x_thresholdlevel event. Hand model and both schemas agree exactly on every state and event across the enrolled operating set. - Over 30 iterations, emitted Q16.16 RTL reproduces the complete 2/1/1 event
vectors at
I=0.5/1.0/2.0, with both coordinates within0.0004absolute error of float64. The three points exercise the interior expression and both clip bounds. A separate regression fixes the sensitiveI=0.05boundary at seven float64 events, eight RTL events, and seven event-position mismatches, so the bounded evidence cannot imply long-window chaotic identity. - The Cazelles co-simulation and independent-reference tests live in dedicated model-scoped modules rather than the legacy catalogue-wide test accumulators. The unit adds the DOI-backed independent map reference, S5/H1 descriptor/readiness facets, public fidelity and model documentation, and generated Q8.8 RTL. Its port-only depth-4 SymbiYosys/Z3 reset-spike safety job passes. The formal inventory moves to 20 models and schema-gap counts move to 28 schema models / 125 net missing / 127 source modules without a schema. The completed acceleration chain and its committed benchmark artefact remain unchanged.
Mihalas-Niebur co-simulation evidence correction¶
- Replaced the stale loose Q16.16 guard with exact operating-point contracts after the shared
candidate-reset/output correction. The hand model and paired TOML/JSON schemas agree exactly on
every event and all four states over a varied 1,600-step sequence containing 168 resets. At
I=3over 300 steps, hand/schema/RTL now report 36/36/36 rather than the former 36/36/35. - Over 1,000 steps, hand/schema/Q16.16 RTL agree exactly on
0/0/0/31/60/87/131/157/207/256 spikes at
I=0/0.5/1/1.5/2/2.5/3.5/4/5/6. A separate test pins the isolatedI=3boundary at 111/111/112, preserving the marginal fixed-point crossing as an explicit exclusion rather than a hidden tolerance. The S5/H1 descriptor, readiness index, public fidelity row, model page, and co-simulation guide now state that same contract. The existing depth-3 SymbiYosys/Z3 job remains the structural safety proof; all model, acceleration, schema, compiler, generated RTL, formal source, and benchmark artefacts are unchanged.
GLIF faithful RK4 schema-to-RTL correction¶
- Corrected the already enrolled
glifTOML/JSON schemas from stale Euler andv > thetasemantics to the maintained Allen Institute GLIF5 contract: simultaneous four-state classical RK4, candidate-levelv >= thetadetection, and candidate-first adaptive reset. The hand model and both schema formats agree exactly on all states and 181 reset events over a varied 4,000-step drive. - Replaced the silent Euler reference with an independent 54-spike RK4 re-derivation. Across the
six 1,000-step Q16.16 operating points
I=0/15/22/30/45/50, hand model, schema runner, and RTL agree exactly on 0/0/23/54/86/95 spikes. The compiler and bit-true C/Rust generators now evaluate reset expressions from the integrated candidate and expose identical post-reset state, removing the pre-step-reset mismatch that a one-spike band had masked. The S5/H1 descriptor/readiness facets record the exact observable. Deterministic regeneration changes all ten reset-using formal RTL models plus seven non-resetting single-step edge models so spike-cycle outputs expose the committed candidate. Connor-Stevens and Hodgkin-Huxley already expose that candidate in their macro-step branches and remain byte-identical, accounting for all 19 jobs without changing the inventory. The completed acceleration chain and benchmark artefacts are unchanged. The reset correction exposes one honest legacy Izhikevich Q8.8 boundary (float64 25 spikes versus RTL 24 atI=50over 200 steps), while a new Q16.16 guard proves exact 25/25 parity at the same point.
Rulkov map class-correct schema-to-RTL enrolment¶
- Descriptor regeneration now inherits
integration.dtfrom a bundled map schema when the hand class intentionally has no timestep parameter, so the Rulkov map retains its one-iteration metadata without adding a non-functional public field or changing non-map fallbacks. The readiness facet writer also preserves any descriptor whose recorded evidence already meets or exceeds the indexed floor, preventing regeneration from replacing Rulkov's S5 trajectory and H2 synthesis evidence with H0 facets. - Re-enrolled the Rulkov 2002 fast/slow map (
rulkov_map, DOI10.1103/PhysRevE.65.041922) with paired TOML/JSON schemas that mirror the maintained hand model's simultaneous rational/plateau/hard-reset branches and risingx >= 0crossing decision. The old schema used level detection and therefore counted every positive plateau step rather than the hand model's upward crossings. - At
I=1.5, the bounded 30-iteration validation window executes every fast-map branch ten times. Hand model and both schema formats agree exactly on all post-step states and the ten-event vector; emitted Q16.16 RTL reproduces that event vector exactly with absolutex/yerror below0.001. The evidence uses the class-appropriate short-window trajectory metric and explicitly withholds long-window spike-count identity. - Corrected the descriptor's stale equations and timestep, regenerated the DOI-backed
crossing reference, and recorded S5/H2: the Q16.16 core passes Yosys 0.33
synth_xilinxwith a raw committed report. The now-perfect descriptor is registered with the formal catalogue through generated Q8.8 RTL, a port-only harness, and a depth-4 SymbiYosys/Z3 safety job, bringing the inventory to 19 models. Schema-gap counts are unchanged because the paired schema already existed. The completed acceleration chain and its benchmark artefacts are unchanged.
Wilson-HR faithful schema-to-RTL enrolment¶
- Enrolled the Wilson-HR two-state polynomial cortical model (
wilson_hr, Wilson 1999, DOI10.1006/jtbi.1999.1002) with paired TOML/JSON schemas that mirror the maintained hand model's simultaneous classical RK4 flow, polynomial membrane nullcline, levelv >= v_peakdecision, and hardv = -0.7reset that preserves the candidate recovery state. A varied 4,000-step drive produces 35 spikes and resets with exact hand/TOML/JSON state agreement. Over 5,000 constant-current steps the hand model, schema runner, and Q16.16 RTL agree exactly on 0, 1, and 4 spikes atI=0.0,2.0, and10.0. - Added the DOI-backed
wilson_hr_driven_spiking_doitrace with an independent two-state RK4 re-derivation, corrected the public model provenance, marked the descriptor's RK4 and co-sim facets, and updated the public fidelity row. The S5/H1 descriptor is registered with the formal catalogue: generated Q8.8 RTL, a port-only harness, and a depth-4 SymbiYosys reset-spike safety job bring the committed inventory to 18 models. Schema-gap counts move to 27 schema models / 126 net missing / 128 source modules without a schema. The completed Rust/Go/Julia/Mojo acceleration chain and its committed benchmark artefacts are unchanged.
Terman-Wang faithful schema-to-RTL enrolment¶
- Enrolled the Terman-Wang two-state LEGION relaxation oscillator (
terman_wang, Terman & Wang 1995, DOI10.1016/0167-2789(94)00205-5) with paired TOML/JSON schemas that mirror the maintained hand model's simultaneous classical RK4 flow, cubic fast nullcline,tanh-gated recovery, rising-edgev >= v_peakdecision, and no-reset semantics. Over 8,000 steps the hand model, schema runner, and emitted Q16.16 RTL agree exactly on the silent/single/train crossing counts: 0 atI=-1.0, 1 atI=0.0, and 3 atI=0.5. - Added the DOI-backed
terman_wang_legion_oscillation_doitrace with an independent two-state RK4 re-derivation, corrected the public model citation, marked the descriptor's RK4 and co-sim facets, and updated the public fidelity row. The S5/H1 descriptor is registered with the formal catalogue: generated Q8.8 RTL, a port-only harness, and a depth-4 SymbiYosys reset-spike safety job bring the committed inventory to 17 models. Schema-gap counts move to 26 schema models / 127 net missing / 129 source modules without a schema. The completed Rust/Go/Julia/Mojo acceleration chain and its committed benchmark artefacts are unchanged.
Pernarowski faithful schema-to-RTL enrolment¶
- Enrolled the Pernarowski three-state pancreatic beta-cell burster (
pernarowski, Pernarowski 1994, DOI10.1137/S003613999223449X) with a TOML/JSON schema that mirrors the maintained hand model's simultaneous classical RK4 flow, exactv * v * voperation order, rising-edgev >= v_thresholddecision, and no-reset semantics. The hand model, schema runner, and emitted Q16.16 RTL have exact spike-count parity at all four enrolled 5,000-step operating points: 17 crossings at each ofI=-0.1,0.0,0.1, and0.2. - Added the DOI-backed
pernarowski_autonomous_bursting_doitrace with an independent three-state RK4 re-derivation, marked the descriptor's RK4 and co-sim facets, and updated the public fidelity row. The S5/H1 descriptor is also registered with the formal catalogue: generated Q8.8 RTL, a port-only harness, and a depth-4 SymbiYosys reset-spike safety job bring the committed inventory to 16 models and pass a direct Z3 BMC. Schema-gap counts move to 25 schema models / 128 net missing / 130 source modules without a schema. The already completed Rust/Go/Julia/Mojo acceleration chain and its committed benchmark artefacts are unchanged.
FitzHugh-Rinzel faithful schema-to-RTL enrolment¶
- Enrolled the FitzHugh-Rinzel three-state qualitative burster (
fitzhugh_rinzel, Rinzel 1987, DOI10.1007/978-3-642-93360-8_26) with a TOML/JSON schema that mirrors the maintained hand model's coupled classical RK4 flow, exactv * v * voperation order, rising-edgev >= v_thresholddecision, and no-reset semantics. The hand model, schema runner, and emitted Q16.16 RTL have exact spike-count parity across the enrolledI=0.4toI=0.6band (seven, eight, and eight crossings over 3000 steps);I=0.7is recorded as an excluded marginal-crossing boundary rather than hidden by a tolerance. - Added the DOI-backed
fitzhugh_rinzel_driven_bursting_doitrace with an independent three-state RK4 re-derivation, corrected the model page's stale reset claim, marked the descriptor's RK4 and co-sim facets, and updated the public fidelity row. Schema-gap counts move to 24 schema models / 129 net missing / 131 source modules without a schema. The already completed Rust/Go/Julia/Mojo acceleration chain and its committed benchmark artefacts are unchanged.
StochasticLIF same-name Rust engine binding¶
StochasticLIFNeuronwas enrolled in the public registry (sc_neurocore.neurons.models.__all__) for catalogue readiness but had no same-name PyO3 constructor, so the registry-parity coverage map flagged it as an uncovered non-Python-only model. The Rust neuron already existed in the engine (engine/src/neurons/trivial.rs) and was wired into theNetworkRunner; this adds the missingPyStochasticLIFNeuronwrapper (new(seed)/step/reset/get_state, mirroringStochasticIFNeuron), re-exports it from the engine package root, and enrols it in the RNG-dependent parity set. Exact traces are not claimed — the Rust Gaussian stream isXoshiro256++Box-Muller rather than NumPy's PCG64 Ziggurat — so the spike count is the stated parity observable. The registry map is now 160 public Python registry names, 146 same-name Rust constructors, and 176 Rust PyO3 model wrappers.
Connor-Stevens polyglot kernels pinned to the Python golden spike count¶
- The Go (
accel/go/services/connor_stevens.go), Rust (accel/rust/safety/connor_stevens.rs) and Julia (accel/julia/neurons/connor_stevens.jl) Connor-Stevens kernels already carried the real six-state macro-step RK4 dynamics (100 sub-steps) but were only self-consistency / smoke tested; each now asserts the Python golden counts — silent at zero drive, two action potentials atI=10over 100 macro steps, nine atI=20. Connor-Stevens gating isexp-based, so the trace is not bit-exact across C libraries; the spike count is the stated parity observable and all three languages reproduce it. - Added a native Julia parity test (
accel/julia/connor_stevens_parity_test.jl), a Go golden-parity test plus an honestBenchmarkConnorStevensStep(262.7 µs/macro-step), and the idiomaticDefaultimpl on the Rust side. The Mojo kernel remains an honest parity note pending the Mojo neuron-kernel lane's promotion to a build target. Connor-Stevens's Python model dispatches only to the Rust engine, so the Go/Julia kernels are language-native; no Python runtime path, FFI dispatch, or committed benchmark artefact changed.
Morris-Lecar polyglot kernels pinned to the Python golden spike count¶
- The Go (
accel/go/services/morris_lecar.go), Rust (accel/rust/safety/morris_lecar.rs) and Julia (accel/julia/neurons/morris_lecar.jl) Morris-Lecar kernels already carried the real RK4 dynamics but were only self-consistency / smoke tested; each now asserts the Python golden counts — silent at zero drive, three action potentials atI=50over 2000 steps, five atI=100. Morris-Lecar gating istanh/cosh, so the trace is not bit-exact across C libraries; the spike count is the stated parity observable and all four languages reproduce it. - Added a native Julia parity test (
accel/julia/morris_lecar_parity_test.jl) and an executablesimulate/mainparity harness to the Mojo kernel (accel/mojo/kernels/morris_lecar.mojo, somojo runprintsPARITY OK); removed a deadk4_vassignment in that kernel'snext_wpath. On the Rust side, dropped a vestigial# and added the idiomaticDefaultimpl. Morris-Lecar's Python model dispatches only to the Rust engine, so the Go/Julia/Mojo kernels are language-native; no Python runtime path, FFI dispatch, or committed benchmark artefact changed.
FitzHugh-Nagumo Go accel-services kernel (services test suite unblocked)¶
- Added
accel/go/services/fitzhugh_nagumo.go, a real RK4SimulateFitzHughNagumoNeuronin parity withsc_neurocore.neurons.models.fitzhugh_nagumo.FitzHughNagumoNeuron(the cube writtenv*v*v, exact arithmetic, fail-closed on a non-finite input, state, or candidate). The Go services test suite could not compile becauseservices_test.goreferenced this function while the FitzHugh-Nagumo Go kernel existed only as apackage maincgo shared library underaccel/go/neurons/fitzhugh_nagumo/. A golden-parity test pins the kernel to the Python reference (one action potential atI=10over 100 steps and a five-spike partial train atI=0.5over 2000 steps, finalvbit-identical to NumPy) and an honest per-step benchmark records the timing. - Strengthened the
accel/rust/safetyFitzHugh-Nagumo test from aspike is 0 or 1smoke check to the same Python-golden spike count, dropped a vestigial#![allow(dead_code)], and added the idiomaticDefaultimpl. The services surface is Go-native, not FFI-dispatched, so no Python runtime path, FFI dispatch, cross-languagesimulatebenchmark, or committed benchmark artefact changed.
Sequential (Gauss-Seidel) integration mode + faithful Wang-Buzsáki re-enrolment¶
- Added a sequential (Gauss-Seidel) integration mode (
[integration] method = "gauss_seidel") to the schema DSL, in both the Python runner (EquationNeuron) and the emitted Verilog. The state variables advance in declaration order, each derivative reading the already-committed earlier variables within the same sub-step — lowering a conductance hand model's gates-then-voltage update (gates from the old voltage, voltage from the new gates). The emitter renders each earlier variable as its<var>_nextwire in a later variable's derivative (a commit-before-read chain, no cycle). Composes withsubsteps; the simultaneouseuler/rk4methods stay bit-for-bit unchanged (defaultsubsteps = 1). - Re-enrolled the Wang-Buzsáki (1996) fast-spiking interneuron (
wang_buzsakischema, DOI10.1523/JNEUROSCI.16-20-06402.1996) faithfully. The bundled schema was a single-stepmethod="euler"re-derivation with a sigmoid-caricaturem_inf, unfaithful gate initial conditions (h=0.6,n=0.32), av > -10threshold, and a singularnrate; it is nowmethod="gauss_seidel",substeps=50, state orderedh, n, v(h=0.8,n=0.1,v=-65), the true instantaneousm_inf = alpha_m/(alpha_m+beta_m)(alpha_m = 1/exprel(-(v+35)/10)), the exprelnrate0.1/exprel(-(v+34)/10), a macro-boundaryv >= v_thresholdcrossing (v_threshold=-20), no reset — matchingWangBuzsakiNeuronexactly (hand == schema, three action potentials atI=10over 20 macro steps). The Q16.16 RTL tracks the schema within one spike over the bounded window (three-way exact atI=10,macro=20); the residual is them_inffixed-point divide plus a 256-entry exprel look-up, not a datapath-precision limit. Re-derived reference tracewang_buzsaki_driven_spiking_doi(independent_macrostep_gauss_seidel_reference, a 3-state helper bit-exact vs the runner, spike_count 4), replacing the deleted resting-gate trace; descriptor dynamics synced to the exprel form; the 15%-band cosim test becomes a macro-step three-way parity test. Wang-Buzsáki is the last of the four WC-A5 conductance oscillators (Morris-Lecar, Connor-Stevens, Hodgkin-Huxley, Wang-Buzsáki), all now faithfully enrolled; the polynomial edge-crossing oscillators (FitzHugh-Nagumo, McKean) were enrolled earlier.
Faithful Hodgkin-Huxley re-enrolment (macro-step RK4)¶
- Re-enrolled the Hodgkin-Huxley (1952) membrane (
hodgkin_huxleyschema, DOI10.1113/jphysiol.1952.sp004764) as a driven repetitive-spiking oscillator using the macro-step mode. The bundled schema was a single-stepmethod="euler"resting-gate re-derivation compared schema-vs-verilog under a 5% band; it is nowmethod="rk4",substeps=100, macro-boundaryv >= v_thresholdcrossing — matchingHodgkinHuxleyNeuron(integrator="rk4")(the simultaneous RK4, not the Gauss-Seidelbaseline_eulerdefault the DSL cannot reproduce).hand == schemaexact (five action potentials atI=20over 60 macro steps). The Q16.16 RTL tracks the schema within one spike over the bounded window (I=15, 20 macro steps, three-way exact); like Connor-Stevens the residual is genuine conductance-LUT quantisation (LUT-resolution-limited, identical at Q16.16 / Q24.24 / Q32.32). Re-derived reference tracehodgkin_huxley_driven_spiking_doi(independent_macrostep_rk4_reference, bit-exact vs the runner); descriptor integration updated (euler → rk4). Also fixed a pre-existinghodgkin_huxley.jsontoml/json drift (singulara*(V-V0)/(1-exp(...))rate form → the stableexprelrewrite the.tomlalready used) and a stale wrong Connor-Stevens DOI (sp009368→sp009366) in the changelog. Schema-gap counts unchanged; no polyglot / benchmark change (the hand model already carries the RK4 path).
Macro-step integration mode + faithful Connor-Stevens re-enrolment¶
- Added a macro-step integration mode (
[integration] substeps = N) to the schema DSL — in both the Python runner (EquationNeuron) and the emitted Verilog. One macrostep()advancesNinner integration sub-steps before a single spike decision, with the rising-edge crossing taken only on the macro boundary. This lets the schema faithfully replicate the maintained conductance hand models whosestep()is a fixed number of fine sub-steps per macro step (HH / Connor-Stevens: 100dt=0.01sub-steps per 1 ms; Wang-Buzsaki: 50 per 0.5 ms), so a repetitively firing oscillator counts one spike per action potential, not one per sub-step above threshold. The RTL keeps one sub-step per clock and gates the crossing to the macro boundary via a sub-step counter; the lowering is bit-exact against the runner (proven on the polynomial FitzHugh-Nagumo at Q16.16, exact across sub-step groupings). Supported for the edge (crossing, non-resetting), non-pipelined datapath; other combinations raiseNotImplementedError.substeps = 1(default) leaves every existing model bit-for-bit unchanged. - Re-enrolled Connor-Stevens (1971) faithfully with the macro-step mode: the bundled schema is now
method="rk4",substeps=100, macro-boundaryv >= v_thresholdcrossing — matching the maintainedConnorStevensNeuron.hand == schemaexact (ten action potentials atI=100over 60 macro steps), which the earlier single-step Euler schema could not achieve. The Q16.16 RTL tracks the schema within one spike over the bounded window; the residual is genuine conductance-LUT quantisation (LUT-resolution-limited, identical at Q16.16 / Q24.24 / Q32.32), three-way exact over a bounded window and accumulating beyond it — an honest per-model hardware-fidelity band. Re-derived reference traceconnor_stevens_driven_spiking_doi(independent_macrostep_rk4_reference, bit-exact vs the runner); descriptor integration updated (euler → rk4). Also fixed a pre-existingconnor_stevens.jsontoml/json drift (singulara*(V-V0)/(1-exp(...))rate form → the stableexprelrewrite the.tomlalready used). Schema-gap counts unchanged; no polyglot / benchmark change (the hand model was already RK4).
Morris-Lecar faithful re-enrolment (RK4, no reset, rising-edge crossing)¶
- Re-enrolled the Morris-Lecar (1981) calcium-potassium oscillator (
morris_lecarschema, DOI10.1016/S0006-3495(81)84782-0) as the first conductance edge-crossing oscillator in the WC-A5 Python↔Verilog co-simulation set. The prior schema wasmethod="euler"with a no-op[reset](v -> v,w -> w) that disabled edge detection and over-counted every above-threshold step — a caricature that only "passed" a ~15% band because both sides over-counted identically. The faithful schema mirrorsMorrisLecarNeuron's maintained defaults: four-stage RK4, no reset, rising-edge (v >= v_threshold) crossing, andphi = 1/15. - At the sustained depolarising regime (
I=100, 3000 steps) the handMorrisLecarNeuron, the schema runner, and the emitted Q16.16 RTL report the same seven upward crossings. Because the sigmoidal gating lowers to 256-entry cosh/tanh look-up tables and the hand model integrates withmathtranscendentals through a distinct RK4 driver, this is an exact spike-count parity (robust across the wholeI in [90, 110]band), not the bit-identical state the polynomial FitzHugh-Nagumo / piecewise-linear McKean oscillators achieve;I=120is a knife-edge that splits a marginal crossing between the paths. - Re-derived the reference trace as
morris_lecar_driven_oscillation_doi(independent_rk4_reference,I=100, 3000 steps, seven crossings, first at step 141) via a new_morris_lecar_rk4_featureshelper verified bit-exact against the runner. TheMorrisLecarNeurondescriptor now carries the schema's RK4 integration. Schema-gap counts are unchanged (a re-enrolment, not a new schema). - The schema-DSL runner is Python-only; the hand
MorrisLecarNeuronand its Rust/Julia/Go/Mojo mirrors were already RK4 / no-reset, so no polyglot counterpart or benchmark artefact changed.
McKean piecewise-linear oscillator enrolment (RK4, no reset, rising-edge crossing)¶
- Enrolled the McKean (1970) piecewise-linear FitzHugh-Nagumo caricature (
mckeanschema, DOI10.1016/0001-8708(70)90023-X) into the WC-A5 schema corpus and Python↔Verilog co-simulation. The bundled schema is RK4, no reset, rising-edge (v >= v_peak) detection, with the three-branch piecewise-linear membranef(v) = min(max(-v, v - a), 1 - v)— the second edge-crossing oscillator after FitzHugh-Nagumo. The min/max branch selection lowers to a fixed-point comparison + select (no look-up table), so at the sustained relaxation-oscillation operating point (epsilon=0.2,gamma=0.5,I=0.6) the handMcKeanNeuron, the schema runner, and the emitted Q16.16 RTL report the same 16-crossing train over 3000 steps bit-exactly — a genuine three-way parity, not a tolerance band. - The default hand-model regime (
epsilon=0.01) is a single-transient knife-edge; the enrolled regime is a robust limit cycle whose upward crossings survive fixed-point rounding. - Committed an independent RK4-parity reference trace (
independent_rk4_reference,I=0.6, 3000 steps, 16 crossings, first at step 12) via a new_mckean_rk4_featureshelper verified bit-exact against the runner. Schema-gap counts move to 23 schema models / 129 net missing / 131 source modules without a schema; theMcKeanNeurondescriptor now carries the schema's RK4 integration and min/max dynamics (golden-trace SHA unchanged). - The schema-DSL runner is Python-only; the hand
McKeanNeuronand its Rust/Julia/Go/Mojo mirrors were already RK4 / piecewise-linear / no-reset, so no polyglot counterpart or benchmark artefact changed.
FitzHugh-Nagumo faithful re-enrolment (RK4, no reset, rising-edge crossing)¶
- Replaced the bundled
fitzhugh_nagumoschema's explicit-Euler +v = -1reset caricature with the genuine FitzHugh (1961) relaxation oscillator: four-stage RK4, no reset, rising-edge (v >= v_thresholdupward crossing) spike detection, and the exact IEEE cubev * v * v. The schema now matchesFitzHughNagumoNeuronbit-for-bit in float64, and over 3000 steps atI=0.5the hand model, the schema runner, and the emitted Q16.16 RTL report the same eight-crossing partial train exactly — a genuine three-way parity, not a tolerance band, because the right-hand side is polynomial (no look-up table). The earlier Euler+reset "parity" only held because both sides shared the same unfaithful reset dynamics; the RK4 distinctness demonstration therefore moved to models whose spike count is genuinely integrator-sensitive (theta for RK4, resonate-and-fire for exponential Euler), since a faithful relaxation oscillator counts the same crossings under any integrator. - The committed reference trace is re-derived with an independent RK4 recurrence
(
independent_rk4_reference,I=0.5, 3000 steps, eight crossings, first at step 29). - The schema-DSL runner now fails closed on a non-finite state (
FloatingPointError, matching the hand neuron models'_validate_candidatecontract) rather than silently propagatinginf/naninto the threshold decision, so the unbounded oscillator's large-step divergence is a controlled error, not a corrupt trace. FitzHugh-Nagumo also moved from the "transcendental (LUT)" compile group to the polynomial group in the DSL→Verilog tests — its cube lowers to plain fixed-point multipliers. - The schema-DSL runner is Python-only; no benchmark dispatch or benchmark artefact
changed. The hand
FitzHughNagumoNeuronand its Rust/Julia/Go/Mojo mirrors were already RK4 /v*v*v/ no-reset, so no polyglot counterpart changed.
Rising-edge (crossing) threshold detection for non-resetting oscillators¶
- Made the schema DSL's
[threshold] detection = "crossing"field functional in both the Python runner (EquationNeuron) and the schema→Verilog emitter. A non-resetting oscillator now spikes once per upward threshold crossing (matching the hand models'v >= thr and v_prev < thredge test) instead of on every step it stays above threshold. This unlocks faithful enrolment of the biophysical oscillator family (FitzHugh-Nagumo, McKean, and the conductance oscillators), which the previous level-only path could only over-count. Validated end-to-end by a faithful FitzHugh-Nagumo hand-model / schema / Q16.16 RTL three-way parity at exact spike counts on a sustained relaxation-oscillation train (8 of 3000 steps). Edge detection engages only for a crossing model with no reset — a reset that clears the condition makeslevelandcrossingidentical, so every existing reset-based integrate-and-fire model keeps its exact prior behaviour (the field was previously decorative, and several reset models declaredcrossingharmlessly). The emitted RTL carries a 1-bit_thr_prevedge-history register, seeded from the initial state to bit-match the golden. The foldedcompile_to_datapathPE stays level-only for now (the co-simulation path uses the per-instance module); crossing support in the folded datapath is a separate follow-up.
Mihalas-Niebur RK4 co-simulation enrollment¶
- Enrolled
mihalas_niebur(Mihalaş & Niebur 2009 generalised linear integrate-and-fire) into the WC-A5 schema corpus and Python↔Verilog co-simulation as the firstmethod="rk4"bundled model: a four-state RK4 flow (membrane, adaptive threshold, two spike-triggered currents) with a state-to-statev >= thetathreshold and amax(theta, theta_reset)adaptive-threshold reset that floors on every spike. The schema runner reproduces the hand model bit-for-bit in float64, and a committed independent RK4-parity reference trace covers the new bundled schema. Unlike the exact Euler anchors, the Q16.16 RTL tracks the float spike train to within a single spike (35 vs 36 over 300 steps) rather than bit-exactly: the state-vs-state threshold compares two quantised states and the four-stage RK4 update injects four times the per-step rounding, so a marginal crossing shifts by one step under fixed-point rounding (timing jitter, not LUT coarseness — the right-hand side is linear). The co-simulation claim is therefore an honest tolerance band, not exact parity. The schema-DSL runner has no polyglot mirror; no benchmark dispatch or benchmark artefact changed.
DYNAP-SE differential-pair integrator co-simulation enrollment¶
- Enrolled
dpi_neuron(Chicca et al. 2014 DYNAP-SE differential-pair integrator, current-mode subthreshold LIF) into the WC-A5 Python↔Verilog co-simulation campaign: the explicit-Euler discretisation co-simulates at exact Q16.16 spike-count parity (three-way hand-model / schema / RTL) on a partial spike train, with a committed independent Euler-parity reference trace covering the new bundled schema. The drive is non-negative, so the source model'smax(i_mem, 0)current rectification is inert and the linear schema is a faithful discretisation. The schema-DSL runner has no polyglot mirror; no benchmark dispatch or benchmark artefact changed.
Izhikevich 2007 co-simulation enrollment and Verilog parameter-collision fix¶
- Enrolled
izhikevich2007(Izhikevich 2007 biophysical quadratic IF, NeuroMLizhikevich2007Cell) into the WC-A5 Python↔Verilog co-simulation campaign: the explicit-Euler discretisation co-simulates at exact Q16.16 spike-count parity (three-way hand-model / schema / RTL), with a committed independent Euler-parity reference trace covering the new bundled schema. The model's RK4 default remains a separate RK4-emitter candidate. - Fixed the schema→Verilog emitter to keep the parameter port map injective:
str.upper()collapsed case-distinct names (IzhikevichCcapacitance vscreset voltage) onto oneP_Cport that iverilog rejected. Single-case parameter names keep the canonicalP_TAU-style ports. The schema-DSL runner has no polyglot mirror; no benchmark dispatch or benchmark artefact changed.
Discrete-map integration mode and Rulkov 2002 map fix¶
- Added a
method="map"discrete-map integration mode toEquationNeuron(iteratesstate_{n+1} = f(state_n)directly), plus VerilogIfExplowering and a discrete-map RTL datapath so piecewise maps compile to Icarus-Verilog-valid RTL. Therulkov_mapschema adopts the DOI-verified Rulkov (2002) piecewise fast/slow map withmethod="map", replacing the smooth variant that was integrated with explicit Euler and diverged; its reference trace is a bounded driven-spiking trace with exact independent map-iteration parity, so all 17 deterministic reference traces now hold independent parity. The schema-DSL runner has no polyglot mirror; no benchmark dispatch or benchmark artefact changed.
Compiler HDL e2e CI¶
- Added a path-filtered
Compiler HDL E2Eworkflow for pull requests touchingsrc/sc_neurocore/compiler/,src/sc_neurocore/hdl_gen/, ortests/e2e/. A focused contract test locks the trigger paths and narrow e2e selector. No runtime package code, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Deterministic reference-trace corpus¶
- Completed the deterministic bundled-schema reference-trace corpus for WC-A1b:
all 17 deterministic schema-DSL models now have committed package data
entries validated through
sc_neurocore.neurons.reference_traces, while stochastic schemas and external simulator traces remain explicitly outside this deterministic corpus. No runtime package code, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Systematic audit rerun¶
- Added a systematic-audit rerun contract that locks the concrete 2026-07-04 audit findings to repeatable gitignore, internal-TODO, SPDX-header, and SNN memory-discipline checks. No runtime package code, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Strict typing and docstring policy¶
- Added a strict typing and NumPy docstring policy contract test that locks the
2026-06-17 broadcast wiring across
pyproject.toml, CI, preflight, the scoped docstring policy, and public maintenance docs. No runtime package code, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Rust/Python neuron binding boundary¶
- Documented the durable Python-only boundary for the five registry names without same-name PyO3 neuron constructors and locked each boundary to source evidence in the Rust/Python neuron parity map. No neuron runtime, PyO3 implementation, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Optional-extra CI matrix¶
- Added optional-extra CI matrix lanes for annealing, ONNX protobuf export, and real MPI. The lanes install their focused extras, run the import-skipped production test selectors, and are locked by workflow/docs contract tests. No runtime package code, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Audit cadence¶
- Added a monthly/manual
Audit Cadenceworkflow that runs pytest collect-only, validates tracked test inventory withtools/test_inventory_audit.py, and uploads collection/audit artefacts. A focused contract test keeps the workflow, MkDocs navigation, and public development guide in sync. No runtime package code, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Training device fallback¶
- Made
sc_neurocore.training.auto_device()skip CUDA devices whose compute capability is not supported by the installed PyTorch build, avoiding noisy local GTX 1060 /sm_61warnings while preserving fallback to MPS or CPU. Public training and GPU install docs now state that explicitdevice="cuda"requires a matching PyTorch CUDA architecture. No training algorithm, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Optics optional-extra CI coverage¶
- Added a dedicated CI optics-extra lane that installs
.[dev,optics]and runstests/test_optics -q -rs, so thegdsfactory-gated GDSII round-trip tests are exercised outside the default CPU jobs. Public optional-dependency docs now name that CI boundary. No optics runtime algorithm, package promotion boundary, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Surrogate compiler warning hygiene¶
- Migrated the surrogate custom-op compiler regression to
torch.compile(..., backend="eager")and added a guard against deprecated TorchScriptscript_methodusage in the touched training lane. Public surrogate docs now state that this is graph-capture evidence, not a throughput benchmark. No training algorithm, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Annealing optional extra¶
- Added an
annealingoptional extra fordwave-nealanddimod, updated the optional dependency matrix and install-profile docs, and locked the metadata contract for the quantum-annealingnealparity selector. No base dependency, annealing runtime algorithm, benchmark dispatch, or benchmark artefact changed.
Go autonomous-learning parity¶
- Fixed the autonomous-learning Go CGO setup contract: the parity test now runs
from the Go module root with the
github.com/anulum/sc-neurocore/accelimport path, the Go bridge passes the Rust C-FFI timestep argument while preserving existing convenience calls, and public docs record the localLD_LIBRARY_PATHsetup. No learning-rule dynamics, benchmark dispatch, or benchmark artefact changed.
Rust/Python neuron binding coverage¶
- Documented the Rust/Python neuron binding coverage boundary and turned
tests/test_rust_python_neuron_parity.pyinto a registry-level coverage map for 159 public Python registry names, including same-name Rust constructors, Rust-prefixed/core-only constructors, and current Python-only entries. No neuron runtime, PyO3 implementation, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Vivado CI gates¶
- Added a public Vivado CI gate guide for the
MIF_VIVADO_CI=1ZU3EG synthesis-flow tests. A focused contract test now discovers the live Vivado-gated pytest files and keeps the guide plus MkDocs navigation in sync. No HDL logic, runtime package code, dependency pins, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Optional dependency matrix¶
- Added a public optional-dependency matrix for the audited
gdsfactory,neal/dimod, ONNX, Lava, snnTorch, SpikingJelly, CuPy, and MPI surfaces. A focused contract test now checks the matrix againstpyproject.toml, the relevant skip-gated test paths, install-profile docs, and MkDocs navigation. No runtime package code, dependency pins, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Performance-gate CI¶
- Added a scheduled/manual
Performance Benchmarksworkflow lane for theSC_NEUROCORE_PERF=1pytest selector and documented the perf-gate contract. A focused contract test now discovers perf-gated files from the live test tree and keeps the workflow selector plus public guide in sync. No runtime package code, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Schema-gap reporting¶
- Added
tools/schema_gap_report.pyand focused tests for WC-A5 schema-DSL coverage planning. The report scans live model/schema files without importing optional backends, distinguishes the net schema gap from exact source-module alias coverage, and ranks missing-schema rows by source-evidence enrolment priority. No neuron runtime, HDL logic, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Q4.12 co-simulation range classification¶
- Replaced the Q4.12 LIF zero-current co-simulation xfail with an explicit
range-classification regression that checks the Q-format diagnostics and the
public
precision lifCLI. The co-simulation and precision docs now state that Q4.12 is a normalized-dynamics mode, not a zero-current millivolt-scale LIF parity mode. No HDL logic, runtime neuron dynamics, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Studio dependency profile¶
- Added
httpx2to the Studio and full install profiles so StarletteTestClientuses its non-deprecated transport in Studio tests. The install profile guide and metadata contract tests now cover the dependency. No Studio runtime endpoint, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Pytest warning hygiene¶
- Disabled the ambient
pytest_nengoplugin in the repository pytest config so unrelated test collection no longer imports Nengo and emits the third-party NumPy 2.xnumpy.coredeprecation warning before SC-NeuroCore tests run. Added a policy test for the pytest configuration and active plugin registry. No runtime package code, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Co-simulation toolchain gate¶
- Added a typed Icarus Verilog dependency checker and wired the CI test matrix
to verify
iverilog -Vandvvp -Vagainst the documented 12.x co-simulation floor before package tests run. The FPGA toolchain guide now records the same minimum and CI command. No HDL logic, runtime package code, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Public prose hygiene¶
- Removed self-applied public superlatives from the CMOS profile notes, GPU backend guide, and archived state report while preserving the underlying measured values and benchmark comparison tables. No platform registry behavior, GPU backend code, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Copyright spelling hygiene¶
- Standardised copyright spelling across
tools/and.github/workflows/security-scanners.yml: legacy(c)forms, ASCII date ranges, andSotekspellings now use the canonical©, en dash year ranges, andŠotek. Touched tool headers now keep full seven-line GOTM descriptions, and generator string outputs were updated so emitted Vivado and Vertex config artefacts keep the same spelling. Strict mypy now passes on the touched tool scope. No runtime package code, HDL logic, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Header hygiene¶
- Split joined SPDX/commercial-license headers across manifests, workflow YAML, HDL sources, Vivado-import HDL copies, and the Vmin-LIF LUT generator. The touched TOML/Cargo manifests now retain full seven-line GOTM headers and canonical author spelling. No runtime package code, HDL logic, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Configuration validator hygiene¶
- Hardened
scripts/validate_configs.pyinto a typed repository configuration validator, removed the unused top-leveltomliimport, aligned the required user guide path withdocs/guides/USER_MANUAL.md, and added focused CLI validation tests. The generated capability surfaces were refreshed for the new test file. No runtime package, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Expression differentiator typing¶
- Restored strict-mypy compliance for the neuron expression differentiator by isolating SymPy's partially typed constructors, differentiation, and printer APIs behind typed boundary helpers. The in-grammar derivative contract, finite-difference behavior, generated API surface, polyglot mirrors, and benchmark-dispatched paths are unchanged.
Studio sandbox hardening¶
- Hardened Studio job sandbox path confinement so generated job directories, seed/control seed inputs, live artifact reads, artifact downloads, control commands, and purges validate canonical paths before filesystem access. Added focused regression coverage for malformed job IDs and symlinked reserved seed directories. No Studio job API, worker payload schema, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Sensor package exports¶
- Exported the ADC-to-spike kernel surface from
sc_neurocore.sensors, includingADCSpikeWindowConfig,ADCSpikeWindowResult, backend selection, the bit-true Python floor, andquantise_adc. Existing submodule imports remain compatible. Sensor API docs, hardware docs, and module-specific tests were updated. No ADC arithmetic, Rust/Julia/Go/Mojo backend, dispatch order, benchmark output, or benchmark artefact changed.
Quantum package exports¶
- Exported the SC→quantum compiler surface from
sc_neurocore.quantum, includingQuantumGate,SCQuantumCircuit, probability/rotation helpers, andcompile_sc_multiply/compile_sc_layer. Existing submodule imports remain compatible. Quantum API docs, tutorial examples, and module-specific tests were updated. No quantum algorithm, polyglot safety mirror, benchmark dispatch, or benchmark artefact changed.
Training package exports¶
- Exported the NumPy equilibrium-propagation research surface as
sc_neurocore.training.EPNetwork, so the existing two-phase settle-and-nudge path is selectable from the package facade. Training docs and module-specific tests were updated. No Torch training path, polyglot kernel, benchmark dispatch, or benchmark artefact changed.
Spintronic package exports¶
- Exported the documented magnetic-domain mapper surface from
sc_neurocore.spintronic, includingSpintronicMapper, device/material models, MuMax3 helpers, racetrack/skyrmion utilities, aging/radiation/defect models, and the Verilog generator. The quick-start docs now use actual exported symbols, and existing submodule imports remain compatible. Generated capability surfaces were refreshed for the new package API test file. No mapper kernel, Julia/Rust/Mojo mirror, benchmark dispatch, or benchmark artefact changed.
Memristor package exports¶
- Exported the documented memristor crossbar mapper surface from
sc_neurocore.memristor, includingMemristorMapper, conductance/crossbar models, compensation helpers, Monte Carlo reports, and the SystemVerilog emitter. Existing submodule imports remain compatible. No mapper kernel, Julia/Rust/Mojo mirror, benchmark dispatch, or benchmark artefact changed.
JAX dense layer exports¶
- Exported
JaxSCDenseLayerthrough the lazy package facades assc_neurocore.JaxSCDenseLayerandsc_neurocore.layers.JaxSCDenseLayer. The optional backend remains construction-time gated by thejaxextra, and package import stays lightweight. Public API tests, layer docs, and generated capability surfaces were updated. No JAX kernel, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Analysis package exports¶
- Exported
phi_starandphi_from_spike_trainsfromsc_neurocore.analysis, so the maintained Phi* integrated-information estimator is selectable from the public analysis namespace. The curated analysis guide was updated and generated API freshness was verified. No backend kernel, benchmark dispatch, or benchmark artefact changed.
Quantum cognition coverage¶
- Added focused GOTM brain contracts for local-LLM import fallback and
spike-index accumulation. The focused selector for
dashboard.py,gotm_brain.py, andradical_pair.pynow reports 100% exact-file coverage. No runtime path, polyglot mirror, benchmark dispatch, generated API surface, or benchmark artefact changed.
Public API reference¶
- Changed the generated API reference to publish public classes, public module
functions, public methods, and dunder methods only. Single-underscore helper
classes, functions, and methods are now omitted from
docs/API_REFERENCE.md; the generator contract and documentation workflow were updated together. No runtime path, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
Quantum cognition memory schema¶
- Changed quantum-cognition CLI SNN stimulus records to emit the canonical
numeric fleet-memory
timestampfield while keepingcontent,project,actor,kind, andsource_refstable. The CLI memory-discipline contract now rejects legacytextandsourcealiases and locks the numeric timestamp shape. No runtime model dynamics, polyglot kernel, benchmark-dispatched path, or benchmark artefact changed. - Added
tools/snn_memory_discipline_audit.pyto validate SC-NeuroCore SNN stimulus producers and existing records against the fleet memory-write schema, including canonical keys, controlled actors, timestamps, entities, kinds, and source provenance. Repair mode normalizes legacy local records without deleting files or changing runtime model dynamics, polyglot kernels, benchmark dispatch, or benchmark artefacts.
Perfect-integrator co-simulation schema¶
- Added the DOI-backed
perfect_integratorUniversalNeuron schema in TOML and JSON form, packaged bundled schema assets into the wheel, and enrolled the model in deterministic Q8.8 Python-to-Verilog co-simulation. New tests compare the schema against the hand-authoredPerfectIntegratorNeuronand assert emitted-RTL spike-count parity. No polyglot mirror implementation or benchmark-dispatched path changed.
Compiler proof-transform wiring¶
- Added an explicit opt-in
proof_transformscompiler facade for whitebox state taps and operator abstraction. The package root now exposes registry lookup and dispatch helpers, docs classify the transforms as proof-only rather than production compiler flags, and compatibility coverage keepsquantize_coreanchored to the canonical quantizer surface. No polyglot kernel, benchmark-dispatched path, or benchmark artifact changed.
Public docstring quick wins¶
- Closed the AB-DOC-1 quick-win set by documenting the public package entry
points for layers, synapses, utils, datasets, formal verification, and SCPN
layers; the CLI entrypoint; optional Rust fallback surfaces for DNA,
quantum-annealing, photonic, and Studio helpers; Studio preset/template
helpers; and Studio request schemas. The cleaned files are now locked in
docs/docstring_policy.toml, raising the scoped public-docstring gate from 258 to 273 files. Generated API docs were refreshed. No runtime path, polyglot mirror, benchmark dispatch, or benchmark artefact changed.
NotImplemented guard audit¶
- Added a tracked source audit for executable Python
NotImplementedErrorsites. The audit allows only explicit fail-fast guards for unsupported MPI, forced-Rust, Torch bridge, NIR node-map, optics GDSII, hardware-DMA, and abstract-neuron boundaries, preventing hidden selectable stubs from entering tracked Python sources. No runtime path, polyglot mirror, or benchmark artefact changed.
Rust interneuron performance-test gating¶
- Marked the Rust interneuron wall-clock smoke tests for PV, SST, VIP,
Chandelier, cerebellar basket, and Martinotti neurons as opt-in ignored tests
so default
cargo testno longer fails under host CPU contention. Timing evidence remains owned by the Criterion benchmark surfaces; no neuron dynamics, Python surface, polyglot mirror, or benchmark artefact changed.
Block-floating scalar guard¶
- Added an explicit
BlockFloatingScalarEncodingErrorand scalar-only preset guard for mixed-precision configs. Block-floating precision remains available for metadata-aware dense, adaptive, and manifest paths, while scalar parameter encoders can now callfrom_preset(..., scalar_only=True)orencode_scalar_value(...)to fail closed before detached exponent metadata is lost. No polyglot kernel, HDL datapath, or benchmark-dispatched path changed.
Reference trace validation harness¶
- Added a schema-driven neuron reference-trace validation harness with immutable
corpus contracts, fail-closed JSON payload parsing, package-data loading,
UniversalNeuronexecution, and feature-level validation reports. The seed corpus covers analytic closed-formlif,lapicque,quadratic_if,theta, and spike-bearingperfect_integratortraces and is covered by strict mypy checks plus 100% exact-file focused coverage; no polyglot kernel or benchmark-dispatched runtime path changed.
Network Rust backend contract hardening¶
- Reverified the DEEP_AUDIT network/Rust findings against the current tree:
spike events use
u64packing with 32-bit neuron/timestep lanes, population dispatch usesPopulation.model_namerather than labels, Rust final voltages sync back into populations, and the effective workspace release profile now ownspanic = "abort". Added regression tests for those contracts and made forced Rust fail fast forStateMonitor,RateMonitor,spike_gating, andfim_lambda, whilebackend="auto"falls back to Python for those Python-only semantics. No benchmark-dispatched path, polyglot mirror, or benchmark artefact changed.
Release provenance and publish retry hardening¶
- Added manual tagged-release backfill support to the release workflow,
retained the release security packet as a workflow artifact even when the
sweep fails, and aligned release/security scanner cargo-fuzz installation on
the validated
cargo-fuzz==0.13.2pin. Made PyPI and crates.io publish retries idempotent for already-published versions while preserving manual dry-run validation. No runtime package, polyglot kernel, or benchmark path changed.
Mojo helper contract honesty¶
- Removed the hidden
NotImplementedErrorIPC stub fromaccel.mojo.runner.MojoKernelRunner.popcountandlfsr_encode, exportedMOJO_HELPER_BACKEND="python-fallback"plusMOJO_HELPER_IPC_AVAILABLE=False, and added AST regression coverage so scalar helpers cannot silently present a fake Mojo path. Refreshed the Mojo docs to separate actual build/benchmark subprocess execution from Python helper fallbacks. No Mojo kernel, benchmark-dispatched path, Rust path, or polyglot mirror implementation changed.
Backend selector coverage ratchet¶
- Extended the benchmark-driven backend selector tests to cover CPU probe
fallback, missing benchmark directories, and malformed benchmark JSON files,
bringing
accel.backend_selectionto 100% exact-file coverage. Promoted the selector into the scoped NumPy docstring policy. No dispatch order, benchmark artefact, polyglot runtime, or kernel implementation changed.
Constants ledger audit hardening¶
- Added dedicated constants-ledger regression tests for the 44 public constants, scalar types, physical ranges, Q8.8 invariants, maintained-source import map, module-docstring honesty, and Izhikevich spike-threshold wording. Corrected the constants module docstring to state the current 16-module Python adoption boundary, promoted it into the scoped NumPy docstring policy, and refreshed the constants audit page. No constant values, Rust mirror values, or benchmark-dispatched paths changed.
[3.16.0] - 2026-07-05¶
Provenance and citation integrity¶
- Verified every neuron-descriptor DOI against its registry (Crossref, or DataCite
for arXiv preprints) and corrected misstated and fabricated citations: a
non-existent "Kilinc & Bhatt (2023)" (the model is the Nagumo-Sato/Aihara sigmoid
map), a fabricated "Jahns et al. (2025)", a recurring phantom "Bhatt" co-author
across several cerebellar models, an arXiv identifier that pointed at an unrelated
paper, and several digit-transposed or wrong DOIs. Added
tools/provenance/verify_dois.pyand a committed DOI ledger checked offline bytests/test_provenance_doi_integrity.py, so a fabricated or mistyped descriptor DOI now fails CI. Descriptor citeable coverage rose from 119 to 131 models.
Verification safety screen hardening¶
- Hardened
verification.safety.CodeSafetyVerifierto reject AST-visible filesystem, process, network, relative-import, dynamic-import, dynamic-execution, and reflection escape routes includingopen(...),Path(...).write_text(...),socket.socket(),__builtins__.eval(...),__builtins__['eval'](...), andgetattr(__builtins__, 'eval'). Promoted the verifier into the scoped NumPy docstring policy, strict-typed the focused tests, refreshed the verification guide and generated API reference, and keptverification/safety.pyat 100% exact-file coverage. The generated capability manifest, snapshot, and README capability block were also refreshed after the public-claims selector exposed a stale tracked-test count. No polyglot mirror or benchmark-dispatched path changed.
Go services namespace docstring ratchet¶
- Promoted
accel.go.servicesinto the scoped NumPy docstring policy, added an AST-visible package docstring, declared the checked-in Go service file and package-boundary globs, and extended the acceleration mirror-authority tests to cover the services namespace at 100% exact-file coverage. No Go runtime, polyglot mirror, or benchmark-dispatched path changed.
Go acceleration namespace docstring ratchet¶
- Promoted
accel.gointo the scoped NumPy docstring policy, added an AST-visible package docstring, declared the maintained Python ctypes loader entry points and broad Go service namespace globs, and extended the acceleration mirror-authority tests to cover the Go namespace at 100% exact-file coverage. No Go runtime, polyglot mirror, or benchmark-dispatched path changed.
Precision solver width and budget hardening¶
- Hardened
compiler.precision_solverwith sign-inclusive integer-width calculation, finite/range validation, unsigned-negative range rejection, invalid budget/alignment rejection, and aligned budget reductions that recompute datapath width from the integer floor and reduced fraction. Added a dedicated strict-typed precision-solver test module with 100% exact-file coverage, promoted the solver into the scoped NumPy docstring policy, refreshed generated API documentation, and regenerated capability snapshots for the new test-file count. No polyglot mirror or benchmark-dispatched path changed.
Precision config docstring and coverage ratchet¶
- Promoted
compiler.precision_configinto the scoped NumPy docstring policy, added compliant public docstrings for fixed-point and block-floating precision value-object properties and manifest helpers, and expanded the focused compiler precision tests to cover validation, range maths, manifest payloads, exponent-layout delegation, and saturating fixed-point encoding at 100% exact-file coverage. The generated API reference was refreshed. No runtime contract, polyglot mirror, or benchmark-dispatched path changed.
MLIR emitter docstring and coverage ratchet¶
- Promoted
compiler.mlir_emitterinto the scoped NumPy docstring policy, added compliant docstrings for the MLIR node, bundle, emitter, wire, and operation helpers, strict-typed the focused MLIR tests, and coveredMLIRBundle.to_dict()so the emitter reaches 100% exact-file coverage under the focused selector. The generated API reference was refreshed. No runtime contract, polyglot mirror, or benchmark-dispatched path changed.
IR type checker docstring ratchet¶
- Promoted
compiler.ir_type_checkerinto the scoped NumPy docstring policy, added compliant public class docstrings for the signal-domain enum and edge record, strict-typed the focused IR type-checker tests, and refreshed the generated API reference. The existing focused selector keeps the module at 100% exact-file coverage. No runtime contract, polyglot mirror, or benchmark-dispatched path changed.
Cortical column coverage hardening¶
- Added strict-typed cortical-column coverage contract tests for static scale
validation, auto-backend single Rust SpMV fallback, and delayed per-bin
injection.
network.cortical_columnnow reaches 100% exact-file coverage under the focused fast selector, and the generated capability inventory was refreshed. No runtime contract, polyglot mirror, or benchmark-dispatched path changed.
Native learning bridge docstring hardening¶
- Promoted
_native.learning_bridgeinto the scoped NumPy docstring policy, documented the public Rust, Rust-WGPU, and Torch bridge methods, covered the single-step FFI, layer reset, Torch reset-scope, bit-spec length, and PyTorch-unavailable fallback paths, and refreshed the autonomous-learning docs plus generated API reference. No FFI contract, polyglot mirror, or benchmark path changed.
DARTS NAS docstring hardening¶
- Promoted
nas.darts_sc_nasinto the scoped NumPy docstring policy, added public docstrings for the differentiable bitstream-selection methods, strict-typed the focused DARTS NAS tests, refreshed the NAS API guide and generated API reference, and preserved the torch-gated runtime behavior. No polyglot mirror or benchmark-dispatched path changed.
NAS search surface docstring hardening¶
- Promoted
nas.search_space,nas.search, andnas.equivinto the scoped NumPy docstring policy, added missing public summary/property docstrings, strict-typed the focused NAS tests, refreshed the NAS API guide and generated API reference, and removed local NAS type-ignore escapes. No runtime contract, polyglot mirror, or benchmark-dispatched path changed.
SC-NAS engine docstring and coverage hardening¶
- Promoted
nas.sc_nas_engineinto the scoped NumPy docstring policy, added compliant public docstrings for the hardware-aware search/report surface, strict-typed the focused NAS engine tests, covered the optional Rust tournament import branch through the module import boundary, and refreshed the public NAS docs plus generated API reference. No runtime contract, polyglot mirror, or benchmark-dispatched path changed.
SCConv layer docstring and test hardening¶
- Promoted
layers.sc_conv_layer.SCConv2DLayerinto the scoped NumPy docstring policy, added compliant module, initialization, and forward docstrings, strict-typed the focused SCConv tests, refreshed the public layer docs and generated API reference, and verified the production file at 100% exact-file coverage. No runtime contract, polyglot mirror, or benchmark-dispatched path changed.
Compiler MLIR export hardening¶
- Hardened
export.compiler_export.CompilerExporterwith explicitmlirtarget validation, empty-graph rejection, duplicate node/output detection, wrong-arity and unsupported-node failures, missing external shape checks, graph-input/output collision rejection, and positive tensor-dimension validation before SSA MLIR emission. Removed the embedded demo path, covered the module at 100% exact-file coverage, strict-typed the focused tests, and promoted the compiler exporter into the scoped NumPy docstring policy.
DVS input contract hardening¶
- Hardened
interfaces.dvs_input.DVSInputLayerwith fail-closed dimension, decay, AER address, timestamp, polarity, and bitstream-length validation before event-surface mutation. Empty event batches now return probability frames instead of exposing the mutable internal surface, and invalid cross-batch timestamp rewinds leavesurfaceandlast_update_timeunchanged. The Rust safety mirror, Julia validation mirror, and Mojo FFI validation shim now enforce the same DVS boundaries, and the advanced-module DVS benchmark now uses monotonic precomputed event batches. The public DVS input surface is covered at 100% exact-file coverage under strict mypy plus the scoped NumPy docstring policy.
Fisher-Posner LIF contract hardening¶
- Hardened
quantum_cognition.fisher_posnerwith fail-closed neuron-id, timestep, voltage, membrane-time-constant, ATP-domain, and step-current validation before state mutation. Invalid input current now fails without advancing counters, membrane voltage, ATP, or spin-pool measurement state. The public Fisher-Posner LIF surface is covered at 100% exact-file coverage under strict mypy plus the scoped NumPy docstring policy.
RNG utility contract hardening¶
- Hardened
utils.rng.RNGwith fail-closed seed, normal, uniform, and Bernoulli parameter validation before generator state advances. Scalar draws now expose Python scalar types, shaped draws return dtype-stable NumPy arrays, and the public utility is covered at 100% exact-file coverage under strict mypy plus the scoped NumPy docstring policy.
L13 holonomic source-field adapter hardening¶
- Hardened
adapters.holonomic.l13_sourcewith fail-closed parameter, timestep, feedback-rank, feedback-emptiness, finite-value, decode, and no-mutation validation before vacuum/Fisher state updates. Scalar feedback now broadcasts across the vacuum lattice, and mismatched vector or batch feedback projects deterministically by mean drive. The public adapter is covered at 100% exact-file coverage under strict mypy plus the scoped NumPy docstring policy. The Rust safety mirror now validates real state, the Julia mirror is callable, and the Mojo contract shim builds as a shared library with callable validation helpers.
L6 holonomic planetary adapter hardening¶
- Hardened
adapters.holonomic.l6_planwith fail-closed parameter, timestep, input-rank, input-width, non-empty-row, and finite-value validation before Gaia-field state mutation. Mismatched upstream region counts now broadcast a deterministic mean regional drive across configured planetary regions, and the public adapter is covered at 100% exact-file coverage under strict mypy plus the scoped NumPy docstring policy. The Rust safety mirror now enforces the same no-mutation input contract, the Julia mirror is callable, and the Mojo contract shim builds as a shared library with callable validation helpers.
L9 holonomic memory adapter hardening¶
- Hardened
adapters.holonomic.l9_memwith fail-closed parameter, timestep, input-rank, input-width, non-empty-row, and finite-value validation before TSVF state mutation. Mismatched upstream slot counts now tile deterministically across configured memory slots, and the public adapter is covered at 100% exact-file coverage under strict mypy plus the scoped NumPy docstring policy. The Rust safety mirror now validates real L9 state, the Julia mirror is callable, and the Mojo contract shim builds as a shared library with callable validation helpers.
GPU fallback reduction hardening¶
- Hardened the CuPy/NumPy GPU fallback and shared packed-bitstream vector reductions against coverage-time NumPy reloads by routing reductions through the active NumPy module with explicit zero initials. Covered the CuPy-absent import branch, GPU CPU fallback, and vector pack/unpack paths at 100% exact-file coverage under strict mypy. The benchmark suite now synchronizes CUDA only while the GPU runtime is still live, so the GPU section completes under the NumPy fallback when local CUDA discovery fails.
Mojo runner contract hardening¶
- Covered
accel.mojo.runnerat 100% exact-file coverage, including the fail-closed missing-kernels.mojoconstructor path. Promoted the runner to the scoped NumPy docstring policy and corrected the Mojo acceleration docs sobuild,run_benchmark,popcount, andlfsr_encodedescribe the current fallback and failure contracts exactly.
Quantum Studio telemetry hardening¶
- Covered
QuantumStudioHooksnapshot, compact JSON event, and debug representation contracts at 100% exact-file coverage under strict mypy. Added the telemetry hook to the scoped NumPy docstring policy and refreshed the quantum cognition API documentation for the Studio streaming surface.
Host driver generator hardening¶
- Hardened generated Python and C host drivers so module names, parameter
registers, setters, include guards, and C function prefixes are sanitized into
valid identifiers before source emission. Empty module identifiers and
sanitized parameter collisions now fail closed, C drivers expose parameter
setters matching the Python surface, and
compiler.host_driver_genis covered at 100% exact-file coverage under strict mypy plus the scoped NumPy docstring policy.
Compiler pipeline hardening¶
- Hardened
CompilerPipelinepath and tool boundaries: artifact paths now usecommonpathwork-directory validation, EDA executables are resolved to absolute paths before subprocess launch, and the public pipeline surface is covered by strict-typed contract tests plus the scoped NumPy docstring policy.
Universal DSL contract hardening¶
- Covered the schema loader's explicit missing-path and Python pre-3.11 TOML fallback branches, TOML bool/list serialization, and default Verilog module name sanitization at 100% exact-file coverage. Added the Universal DSL public surface to the scoped NumPy docstring policy.
SC-NIR compatibility hardening¶
- Strict-typed the SC-NIR compatibility matrix contract tests, kept the matrix validator at 100% exact-file coverage, and promoted the public compatibility audit surface into the scoped NumPy docstring policy.
ONNX graph export hardening¶
- Fixed dependency-free
ONNXExporterfinal-output metadata so a terminalSC_POPCOUNTemits anint32tensor instead of a bitstream bool tensor, and mapped operators without shape inference rules now fail closed. Covered the exporter at 100% exact-file coverage, strict-typed the focused tests, and documented the file exporter versus graph exporter split.
Pipeline ingestion hardening¶
- Hardened
DataIngestorso the reservedlabelskey is preserved as labels instead of normalized as a modality, modality arrays must be finite and share a sample axis, and scalar/empty inputs fail closed. Coveredpipeline.ingestionat 100% exact-file coverage, strict-typed the focused tests, corrected public pipeline docs, and added the surface to the scoped NumPy docstring policy.
Neuron package facade hardening¶
- Covered the
sc_neurocore.neuronslazy facade at 100%, including optional Rust-dispatch opt-out, cache reuse, pure-Python model fallback, cached package-level model exports, and unknown-symbolAttributeErrorhandling. Added the package facade to the scoped NumPy docstring policy.
Descriptor schema contract hardening¶
- Covered the v2 model descriptor parser's defensive contract branches at 100%:
missing and non-table sections, empty structural descriptors, scalar legacy
state/parameter forms, string backend statuses, dynamics expression tables,
invalid tag/range/year/numeric shapes, and single-author provenance fallback.
Added
neurons.model_descriptorto the scoped NumPy docstring policy.
Descriptor generator hardening¶
- Added a fail-closed class-name guard to the model descriptor generator and
narrowed legacy v1 schema fallback so missing schemas remain allowed while
malformed curated schemas abort corpus refresh. Covered plain-constructor
filtering, source-inspection fallbacks, merge curation preservation, and
brought
neurons.descriptor_generatorinto the scoped NumPy docstring policy.
Descriptor catalogue hardening¶
- Added a fail-closed class-name guard for model descriptor lookup so the
public descriptor helpers accept only public Python identifiers before
filesystem access. Covered valid-absent descriptor branches, the aggregate
catalogue coverage summary, and added
neurons.model_catalogueto the scoped NumPy docstring policy.
Physics and mathematics hardening¶
- Promoted
DendriticNMDANeuron(two-compartment Jahr-Stevens NMDA Mg2+ block neuron) from raw dendrite-first Euler to candidate-first RK4 over(v_soma, v_dend), with finite parameter/state/input validation, reset-on-commit soma spike semantics, and an explicitintegrator="baseline_euler"regression path. Replaced Go, Rust safety, Julia, and Mojo placeholders or broken paths with real dual-input RK4 mirrors, harmonised the Rust engine, added focused Python/Go/Rust tests, a Rust benchmark example, a five-backend local non-isolated benchmark artefact, and refreshed the model documentation with measured benchmark results. Python, Rust, Go, Julia, and Mojo agree on the 253-spike anchor at 20k steps /i_soma=50.0,glutamate=0.5. - Promoted
NeuroGridNeuron(reduced Neurogrid two-compartment analog EIF neuron) from raw Euler to candidate-first RK4 over(v_s, v_d), with an event-limited soma stage cap atv_peak, finite input/state/candidate validation, reset-on-commit spike semantics, and an explicitintegrator="baseline_euler"regression path. Replaced placeholder Go and Rust safety mirrors, repaired Julia, added Mojo, harmonised the Rust engine, added focused Python/Go/Rust tests, a Rust benchmark example, a five-backend local non-isolated benchmark artefact, and refreshed the model documentation. Python, Rust, Go, Julia, and Mojo agree on the 94-spike anchor at 20k steps / current 100.0. - Promoted
HayL5PyramidalNeuron(reduced three-compartment Layer 5 thick-tufted pyramidal cell) from four raw Euler sub-steps to candidate-first RK4 over the nine-state(v_s, h_na, n_k, v_t, m_ca, h_ca, m_ih, v_a, ca_a)system, with finite input/state/candidate validation, non-negative tuft-calcium candidates, dual soma/tuft input parity, and an explicitintegrator="baseline_euler"regression path. Replaced broken or placeholder Go, Rust safety, Julia, and Mojo surfaces with real RK4 mirrors, harmonised the Rust engine, added focused Python/Go/Rust tests, a Rust benchmark example, a five-backend local non-isolated benchmark artefact, and refreshed the model documentation. Python, Rust, Go, Julia, and Mojo agree on the 1-spike anchor at 20k steps /current_soma=10.0,current_tuft=0.0; the dual-input anchor is 4 spikes at 20k steps /current_soma=5.0,current_tuft=5.0. - Promoted
DeSchutterPurkinjeNeuron(compact De Schutter & Bower Purkinje cell) from five raw Euler sub-steps to candidate-first RK4 over the seven-state(v, h_na, n_k, m_cap, h_cap, q_kca, ca)system, with finite input/state/ candidate validation, non-negative calcium candidates, and an explicitintegrator="baseline_euler"regression path. Replaced the decorative Go, Rust safety, and Mojo placeholders with real RK4 mirrors, harmonised the Rust engine and Julia surface, added focused Python/Go/Rust tests, a Rust benchmark example, a five-backend local non-isolated benchmark artefact, and refreshed the model documentation. Python, Rust, Go, Julia, and Mojo agree on the 1-spike anchor at 20k steps / current 500.0. - Promoted
MulticompartmentMCNNeuron(Spiking-WM dual-dendrite working-memory cell) from raw forward Euler to candidate-first RK4 over the coupled(u, v_basal, v_apical)system, with finite input/state/candidate validation and an explicitintegrator="baseline_euler"regression path. The Rust engine, Rust safety mirror, Go service, Julia mirror, and new Mojo kernel now share the same derivative order and threshold-reset rule. Added focused Python/Go/Rust tests, a Rust benchmark example, a five-backend local non-isolated benchmark artefact, and refreshed the model documentation. All five backends agree on the49,999spike anchor at 200k steps / basal current 3.2.
[3.15.35] - 2026-06-26¶
Physics and mathematics hardening¶
- Promoted
HillTononiNeuron(Hill & Tononi 2005 thalamocortical sleep/wake cell) from a hard-coded forward-Euler step to candidate-first RK4 over the six-state(V, h_na, n_k, m_h, h_t, na_i)system — fast Na⁺, delayed-rectifier K⁺,Ih, T-type Ca²⁺, a sodium-dependent K⁺ current, and a saturating Na/K pump — with input validation and the opt-inintegrator="baseline_euler"regression path. Replaced the decorativeaccel/go/servicesand Mojo placeholders (and corrected a wrong Go spike threshold) with real RK4 backends and harmonised the cross-language arithmetic so Python, Rust, Julia, Go, and Mojo reproduce the trajectory bit-for-bit: explicitm·m·m/n·n·n·nconductance powers, and theI_KNaHill exponent3.5evaluated asb·b·b·sqrt(b)(an IEEE-754 exact decomposition) instead of a per-platformpow. Added a_safe_expguard so the saturating gates stay finite under an out-of-range stimulus (Pythonmath.expwould otherwise raise where the other backends return+inf), native Go RK4 parity/behaviour tests, a Go benchmark hook, a Rust benchmark example, Python RK4/fail-closed coverage, and a five-backend local non-isolated benchmark that fails closed unless every backend reports an identical spike count (694 at 200k steps / 10 nA). - Promoted
DurstewitzDopamineNeuron(Durstewitz, Seamans & Sejnowski 2000 D1-modulated PFC cell) from a hard-coded forward-Euler step — which advanced the gates from the old voltage and then the voltage from the freshly updated gates, mixing two inconsistent states — to candidate-first RK4 over the three-state(V, h_na, n_k)system, with input validation and the opt-inintegrator="baseline_euler"regression path. Replaced the decorativeaccel/go/servicesand Mojo placeholders with real RK4 backends and harmonised the cross-language arithmetic (explicitm·m·m/n·n·n·nconductance powers, themg / 3.57 · expMg²⁺-block operand order,math.exp) so Python, Rust, Julia, Go, and Mojo reproduce the trajectory bit-for-bit. Added native Go RK4 parity/behaviour tests, a Go benchmark hook, a Rust benchmark example, the Python RK4/fail-closed test coverage, and a five-backend local non-isolated benchmark that fails closed unless every backend reports an identical spike count (925 at 200k steps / 10 nA). - Completed the
UpperMotorNeuron(Pospischil 2008 corticospinal L5 pyramidal) polyglot backend coverage by adding the Mojo exponential-Euler kernel, raising it to a Python / Rust / Julia / Go / Mojo set. The membrane keeps its analytic frozen-conductance exponential-Euler step and the gates keep their closed-form steady/tau update — both unconditionally stable for the stiff sodium gate, so RK4 here would be a regression rather than a hardening. Added a Go benchmark hook, a Rust exponential-Euler benchmark example, and a five-backend local non-isolated benchmark that fails closed unless every backend reports an identical spike count. - Promoted
EnergyLIFNeuronfrom raw Euler membrane and metabolic-reserve updates to the exact constant-current flow for the coupled(v, epsilon)state across Python, Go, Julia, Mojo, and Rust safety surfaces. Added module-specific Python/Go/Rust exact-flow and invalid-state coverage, refreshed the public model documentation with measured five-backend timing rows, and added a local non-isolated benchmark gate for exact spike-count parity. - Promoted
MATNeuronfrom a split forward-Euler membrane update plus separate threshold decay to candidate-first RK4 over(v, theta1, theta2)across the Python reference, Go service, Julia mirror, Mojo helper, and Rust safety surface. Replaced the Go/Rust/Mojo placeholders with numeric parity surfaces, added Go/Rust tests and Python RK4/fail-closed coverage, refreshed the model documentation with measured five-backend timings, and added a local non-isolated benchmark gate for exact spike-count parity. - Promoted
SFANeuronfrom forward-Euler voltage plus separate adaptation decay to candidate-first RK4 over the coupled(v, g_sfa)adaptation ODE across Python, Go, Julia, Mojo, and Rust safety surfaces. Added native Go/Rust RK4 tests, refreshed Python module tests, a five-backend local non-isolated benchmark artifact, a regression-gate row, and updated model documentation. - Replaced
ExpIFNeuronraw Euler mutation with candidate-first RK4 across the maintained Python reference, Rust engine, Go service, Julia mirror, and Mojo mirror. The Fourcaud-Trocmé EIF ODE and hard reset are unchanged; all surfaces now reject non-finite RK4 derivatives/candidates before mutation. Added focused Python/Rust/Go RK4 tests, a Go benchmark hook, a local non-isolated Python RK4 regression artifact, and refreshed the public model documentation. - Added the polyglot N-step
simulate(n_steps, current, backend=...)chain forMcKeanNeuron(McKean 1970 piecewise-linear FitzHugh-Nagumo caricature) across python / rust / julia / go / mojo. The piecewise-linear RK4 right-hand side is exact arithmetic, so Rust, Julia and Go reproduce the NumPy reference bit-for-bit; the Mojo backend is ULP-bounded and non-amplifying (a two-dimensional autonomous flow cannot be chaotic). Added the Rust enginesimulateplus PyO3py_mckean_simulate, the Julia/Go/Mojo backends, cross-backend parity tests, a multi-language benchmark with a committed results artefact, and a model-documentation upgrade; replaced the decorativeaccel/go/servicesstub with a real c-shared backend. - Added the polyglot N-step
simulate(n_steps, current, backend=...)chain forWilsonHRNeuron(Wilson 1999 polynomial cortical model) across python / rust / julia / go / mojo. The polynomial RK4 right-hand side with a hard voltage reset is exact arithmetic, so Rust, Julia and Go reproduce the NumPy reference bit-for-bit; the Mojo backend is ULP-bounded and non-amplifying (the per-spike reset re-anchors the 2D autonomous flow). Added the Rust enginesimulateplus PyO3py_wilson_hr_simulate, the Julia/Go/Mojo backends, cross-backend parity tests, a multi-language benchmark with a committed results artefact, and a model-documentation upgrade; replaced the decorativeaccel/go/servicesstub with a real c-shared backend. - Added the polyglot N-step
simulate(n_steps, current, backend=...)chain forPernarowskiNeuron(Pernarowski 1994 pancreatic beta-cell burster) across python / rust / julia / go / mojo. Aligned the Python cubic tov*v*v(fromv**3) so it is bit-identical to the engine'sv.powi(3)and removed the now unreachableOverflowErrorbranch; Rust, Julia and Go then reproduce the NumPy RK4 reference bit-for-bit, and the Mojo backend is ULP-bounded and non-amplifying. Added the Rust enginesimulateplus PyO3py_pernarowski_simulate, the Julia/Go/Mojo backends, cross-backend parity tests, a multi-language benchmark with a committed results artefact, and a model-documentation upgrade; replaced the decorativeaccel/go/servicesstub with a real c-shared backend. - Added the polyglot N-step
simulate(n_steps, current, backend=...)chain forTermanWangOscillator(Terman-Wang 1995 LEGION relaxation oscillator) across python / rust / julia / go / mojo. Aligned the Python cubic tov*v*v(fromv**3) so it matches the engine'sv.powi(3)and removed the now-unreachableOverflowErrorbranch. The right-hand side mixes the exact cubic with atanhgating term: the Rust engine resolvestanhto the same glibc symbol as Python and is bit-identical, while Julia/Go/Mojo use their own libmtanhand are ULP-bounded (the 2D relaxation oscillator is non-chaotic, so it does not amplify). Added the Rust enginesimulateplus PyO3py_terman_wang_simulate, the Julia/Go/Mojo backends, cross-backend parity tests, a multi-language benchmark with a committed results artefact, and a model-documentation upgrade; replaced the decorativeaccel/go/servicesandaccel/mojo/kernelsstubs with real backends. - Added the polyglot N-step
simulate(n_steps, current, backend=...)chain forMihalasNieburNeuron(Mihalas-Niebur 2009 generalised integrate-and-fire model) across python / rust / julia / go / mojo. The four-state(v, theta, i1, i2)right-hand side is purely linear — no transcendental functions — advanced by candidate-first RK4 with a discontinuous spike reset, so the Rust engine, Julia and Go backends reproduce the NumPy reference bit-for-bit (trace, spike count and final state); the Mojo backend fuses multiply-add and is validated as non-amplifying within a ULP band with identical spike counts. Added the Rust enginesimulateplus PyO3py_mihalas_niebur_simulate, the Julia/Go/Mojo backends, cross-backend parity tests, a multi-language benchmark with a committed results artefact, and a model-documentation upgrade; replaced the decorativeaccel/go/servicesandaccel/mojo/kernelsstubs with real backends. - Added the polyglot N-step
simulate(n_steps, current, backend=...)chain forGLIFNeuron(Allen Institute GLIF5 generalised leaky integrate-and-fire model) across python / rust / julia / go / mojo. The four-state(v, theta, i_asc1, i_asc2)right-hand side is purely linear — no transcendental functions — advanced by candidate-first RK4 with an additive threshold spike reset, so the Rust engine, Julia and Go backends reproduce the NumPy reference bit-for-bit (trace, spike count and final state); the Mojo backend fuses multiply-add and is validated as non-amplifying within a ULP band with identical spike counts. Added the Rust enginesimulateplus PyO3py_glif_simulate, the Julia/Go/Mojo backends, cross-backend parity tests, a multi-language benchmark with a committed results artefact, and a model-documentation upgrade; replaced the decorativeaccel/go/servicesandaccel/mojo/kernelsstubs with real backends.
Studio¶
- Documented the optional
sc_neurocore.federationHub-facing Studio federation surface with a dedicated API page and navigation entry, covering schema-A manifest emission, evidence bundles, and verifiable-honesty envelopes. - Added the admin
POST /api/studio/training/weight-restore/attach/liveendpoint and the confined control channel that backs it. The endpoint delivers the verified weights of a completed source job to a running target training job; the worker polls a reserved control directory at each epoch boundary and applies the attach with a strictload_state_dictthat records astudio.training.weight-restore-attach.v1(mode: live) evidence artifact. An incompatible or malformed attach is rejected with anattach_rejectedmetric event and never interrupts the running job. Added the control channel (StudioJobManager.send_control_commandwith atomic command publication +StudioJobContext.poll_control_command/read_control_seed, reserved.studio_controland.studio_control_seeddirectories), the epoch-boundary poll in the training loop, an architecture-fingerprint pre-check, the route policy, thestudio.training.weight_restore.attach_liveaudit action, the preflight required-route entry, a Training Monitor live-attach action with a path-free request strip, frontend client types, and full backend and frontend tests plus documentation. - Added the admin
POST /api/studio/training/weight-restore/attachendpoint and the confined seed-input channel that backs it. The endpoint rebuilds the canonical restore plan from a completed training job's checkpoint, delivers the integrity-checked weight artifacts to a boundedstudio-training-restoreworker as confined seed inputs, and warm-starts a training job that loads the verified weights at the epoch-zero checkpoint boundary before training forward. A strictload_state_dictfails closed on an architecture mismatch before training begins. Added an architecture fingerprint that gates compatibility on the shape-determining config fields only, thestudio.training.weight-restore-attach.v1evidence contract, the route policy, thestudio.training.weight_restore.attachaudit action, the preflight required-route entry, aweight_restore_attach_resultsevidence-bundle field stored underevidence/training-weight-restore-attaches/, a Training Monitor warm-start action with a path-free evidence strip, frontend client types, and full backend and frontend tests plus documentation. - Added the admin
POST /api/studio/training/weight-restoreendpoint. It rebuilds the canonical restore plan from a completed training job's stored checkpoint metadata, fetches the integrity-checked weight and metadata artifacts, and materializes the weights inside a boundedstudio-training-restoreworker job using aweights_only=Truetrusted state-dictionary loader. The worker writes a path-freestudio.training.weight-restore.v1evidence artifact holding only verified digests, parameter count, and loaded-key total; the deserialized tensors never reach the API response. Added the route policy, thestudio.training.weight_restore.materializeaudit action, the preflight required-route entry, aweight_restore_resultsevidence-bundle field stored underevidence/training-weight-restores/, a Training Monitor materialize action with a path-free evidence strip, frontend client types, and full backend and frontend tests plus documentation.
[3.15.34] - 2026-06-15¶
Physics and mathematics hardening¶
- Corrected
CourageNekorkinMapNeuronto the canonical Courbage-Nekorkin-Vdovin 2007 map (Chaos17:043109):x + F(x) - y - beta*H(x - d)with the piecewise-linear field, Heaviside discontinuity atx = d, andB^+invariant-region default parameters, replacing the prior non-canonical form. Added the polyglot N-stepsimulatechain (python/rust/julia/go/mojo; Rust/Julia/Go bit-exact, Mojo ULP-bounded) with parity tests, a multi-language benchmark, and a rewritten model documentation page.
Dependencies¶
- Migrated z3
0.12->0.20(featurestatic-link-z3renamed tobundled; the bounded-model verifier updated for the lifetime-free 0.20 AST/Solver API). - Bumped esbuild/vite/@vitejs/plugin-react (Studio frontend, clears the open esbuild advisory), github/codeql-action, click, and hypothesis.
CI and release reconciliation¶
- Reconciled
mainwith the previously orphaned release tagsv3.15.26–v3.15.33so the published release lineage is continuous again. - Regenerated the capability manifest, corrected the mixed-precision emitter Q-format label, and built the ARM64 wheel against the exact matrix interpreter.
Security and Rust engine¶
- Migrated the PyO3/numpy Rust extension chain from
0.28to0.29across the engine, fuzz harness, evo substrate, stochastic doctor, and spike stats crates; refreshed lockfiles and added the missing spike-stats lockfile for reproducible advisory scanning. - Updated the GPU feature path for WGPU 29 API changes exposed by the all-features engine check.
[3.15.33] - 2026-06-05¶
CI and benchmark evidence¶
- Replaced the Wilson-Cowan CI throughput floor with a bounded-runtime regression sentinel and documented that production throughput evidence must come from isolated benchmark runs, not hosted coverage jobs.
[3.15.32] - 2026-06-05¶
CI and release workflows¶
- Restored the direct
MixedPrecisionSpec.get()contract to preserve explicitPrecisionConfig(16, 8)widths while keeping explicitQ7.8preset parsing sign-inclusive.
[3.15.31] - 2026-06-05¶
CI and release workflows¶
- Aligned the explicit
Q7.8mixed-precision preset contract with the sign-inclusive Q-label parser so branch CI no longer treats explicit Q-format labels as namedq88aliases.
[3.15.30] - 2026-06-05¶
CI and release workflows¶
- Installed the pinned
clickruntime dependency before the pinned SymbiYosys executable check so hosted HDL/formal CI validatessbyimmediately after installation.
[3.15.29] - 2026-06-05¶
CI and release workflows¶
- Aligned branch CI version-contract tests with source metadata, installed the HDL/formal toolchain required by RTL contract tests, and synchronized the conda install profile with the release version.
[3.15.28] - 2026-06-05¶
CI and release workflows¶
- Added an executable entry point to the benchmark context example so
cargo test --manifest-path engine/Cargo.tomlbuilds all examples on Linux.
[3.15.27] - 2026-06-05¶
CI and release workflows¶
- Removed Yosys workflow-file edits from the Yosys push path filter so release-hygiene workflow changes do not self-trigger hosted-runner synthesis.
[3.15.26] - 2026-06-05¶
CI and release workflows¶
- Skipped Yosys synthesis on release tag pushes so tag releases do not fail on non-HDL changes after all modules time out under hosted-runner synthesis budgets; branch, pull-request, and manual synthesis workflows remain active.
[3.15.25] - 2026-06-05¶
CI and release workflows¶
- Moved the macOS static-Z3 C++ parser configuration before the v3-engine maturin dependency build so Apple Clang uses delayed template parsing during the actual engine install step.
[3.15.24] - 2026-06-05¶
CI and release hygiene¶
- Formatted the release-surface parity test before publishing the next immutable release tag.
[3.15.23] - 2026-06-05¶
Release workflows¶
- Aligned the Rust engine crate and bridge wheel metadata with the public Python package version before registry publication.
- Added release-surface tests for engine crate and bridge metadata version parity.
[3.15.22] - 2026-06-05¶
Security workflows¶
- Made the lightweight actionlint scanner deterministic by disabling its external ShellCheck and Pyflakes integrations; those analyzers remain separate CI concerns instead of hidden actionlint dependencies.
[3.15.21] - 2026-06-05¶
Security workflows¶
- Installed ShellCheck in the CI security scanner job so actionlint has the same shell-analysis dependency available as local validation.
[3.15.20] - 2026-06-05¶
Security workflows¶
- Updated the CI security scanner actionlint toolchain to
v1.7.12, matching the locally validated workflow parser used for release gating.
[3.15.19] - 2026-06-05¶
Release workflows¶
- Added macOS-only static-Z3 C++ parser flags for engine wheel and v3 engine builds so Apple Clang handles Z3's template-heavy LP sources.
[3.15.18] - 2026-06-05¶
CI and source hygiene¶
- Scoped the SPDX guard away from vendored Mojo
.pixienvironments and generated OpenROAD build artefacts. - Added minimal single-line SPDX markers to real HDL and module-specific test surfaces covered by the guard.
- Formatted the mixed-precision/live-control surfaces and tightened mixed-precision manifest typing so CI mypy passes without changing runtime contracts.
[3.15.17] - 2026-06-05¶
Release workflows¶
- Added the static-Z3 CMake policy floor to all Rust engine wheel builders.
- Installed Docker build-stage
clangandlibclang-devso Z3 bindings can locate libclang during containerized release builds. - Replaced the Docker build step id used in SARIF gating with an expression-safe identifier.
[3.15.16] - 2026-06-05¶
Release workflows¶
- Fixed Docker Trivy scans to use the metadata-selected image tag as an explicit image reference instead of an empty default scan target.
[3.15.10] - 2026-06-05¶
Release workflows¶
- Fixed Docker workflow image-tag selection so the workflow remains valid on tag pushes and scans the selected pushed image reference.
[3.15.9] - 2026-06-05¶
Security and release workflows¶
- Patched the hub runtime Starlette pin from
1.0.0to1.0.1. - Fixed Docker image scanning to scan the selected pushed image reference.
- Switched the Rust engine Z3 dependency to a static build path so release wheels no longer depend on runner-provided Z3 headers.
[3.15.8] - 2026-06-05¶
Documentation and release polish¶
- Bumped Python, Rust engine, bridge package, Sphinx docs, README, and
generated capability metadata to version
3.15.8. - Expanded the documentation home page with an evaluator map that routes new users, hardware teams, framework reviewers, industrial evaluators, notebook readers, and API consumers to the correct first evidence surface.
- Strengthened onboarding, notebook, API, FPGA tutorial, industrial applications, product overview, and applications/market documentation so users can understand what SC-NeuroCore is for, where it has evidence, where optional dependencies apply, and which claims require committed artefacts.
Engine supervisor¶
- Added a public Rust supervisor execution entrypoint shared by the PyO3 controller path, preserving bounded-run completion by dropping snapshot senders before joining the Z3 worker and adding module-specific supervisor tests for safe bounded execution, unsafe Petri-net rejection, worker shutdown signalling, and zero-neuron fail-closed validation.
Compiler precision¶
- Hardened adaptive runtime precision manifests for BFP/Q16.16 handoff by
adding the
adaptive_precision_emitter.v1contract, emitted datapath width/fraction, exponent-stream width, exponent-vector width, and fail-closed rejection of block-exponent parameter counts on fixed Q-format paths. - Hardened generated AXI4-Lite/PCIe live-control readback so invalid
bank/entry selections return a bus error and latch the sticky
invalid_selectiontrap instead of silently returning zero. - Added emitter-facing mixed-precision manifests for fixed Q16.16 and block-floating variables, including deterministic assignment order, emitted datapath width/fraction, exponent stream width, exponent-vector width, and fail-closed BFP parameter-count validation for downstream HDL emitters.
- Routed quantizer precision-envelope proof fields through the static-analysis Q-format envelope proof API, with module-specific regression coverage to keep dense deployment manifests aligned with the standalone proof contract.
- Added a static-analysis Q-format envelope proof API for conservative Q-code bounds, with fail-closed validation, signed Q16.16 width/headroom manifests, and module-specific tests for safe, saturating, and block-floating exponent-edge contracts.
- Added signed fixed-point width proofs to mixed Q8.8/Q16.16 and block-floating precision envelope reports across Python, Rust, and refreshed comparison benchmark artefacts, including required total bits, required Q16.16 integer bits, headroom, saturation requirement, and static overflow proof status.
- Added seeded block-floating exponent-edge parity and trap contracts across
the Python quantizer, Rust qformat mirror, and comparison benchmark
artefacts:
BFP16E3X2safe min/max exponent sweeps now match exact Q16.16 output codes across languages, while max-exponent saturation records a deterministic overflow trap instead of silent wraparound. - Added explicit block-exponent layout metadata for block-floating precision across adaptive manifests, mixed-precision specs, Python dense BFP manifests, and the Rust qformat mirror, with exponent-count validation before emission or accumulation.
- Added sub-LSB underflow telemetry to mixed Q8.8/Q16.16 and block-floating dense precision trap/envelope reports across Python and Rust, with refreshed process-affinity benchmark artefacts documenting matched overflow and underflow probes.
- Added sticky live-control partial-write traps so generated AXI4-Lite/PCIe
parameter banks reject partial
WSTRBupdates before control or staged-data registers can be modified. - Hardened live-control trap clearing so generated AXI4-Lite/PCIe parameter banks clear only selected sticky trap bits and preserve unrelated latched fault evidence.
- Added selected-trap clear helpers to the live-control schema and generated Python/C host drivers.
- Added deterministic live-control active-parameter readback for host update sequences and generated AXI4-Lite/PCIe parameter banks, including low/high committed-word registers and module-specific RTL simulation coverage.
- Hardened generated Python and C host drivers for live-control parameter banks with CRC32 update helpers, committed readback verification, trap-status checks, and mandatory high-word staging for narrow updates.
- Added generated Python and C live-control rollback, status-read, and trap-status-read helpers so host drivers expose the load/apply/rollback/ clear/readback handshake.
- Added generated C live-control driver compile validation against a C11 consumer that calls the committed update/readback verification helper.
- Latched live-control shadow bank and entry identity at load time so generated AXI4-Lite/PCIe apply and rollback operations cannot be retargeted by later selection-register writes.
- Added sticky live-control read-only-bank traps so generated AXI4-Lite/PCIe parameter banks reject direct MMIO writes to calibration/read-only banks before shadow loading or active coefficient mutation.
- Added sticky live-control invalid-selection traps so generated AXI4-Lite/PCIe parameter banks reject non-existent bank/entry writes without raising a false shadow-loaded acknowledgement.
- Added sticky CRC32 checksum-mismatch traps and a testbench-visible mismatch pulse to the generated AXI4-Lite/PCIe live-control parameter-bank surfaces, with module-specific simulation tests and refreshed benchmark-gate evidence.
- Replaced live-control update guards with an IEEE CRC32 register-window guard shared by the compiler schema and generated SystemVerilog, with stale guard rejection tests and refreshed benchmark evidence.
- Added the PCIe-MMIO live-control register-window adapter over the staged parameter-bank core, module-specific PCIe commit simulation, process-affinity AXI4-Lite/PCIe comparison benchmark evidence, and compiler API documentation for the exact bus-contract boundary.
- Added the UltraScale+ dense-folding contract: shared Rust/Python fold planner, folded Q8.8/Q16.16 HDL core, target-emitter fold metadata, module-specific simulation tests, and isolated Python/Rust benchmark evidence for fitting the 64x32 dense contract into the ZU3EG DSP budget.
- Added the NEU-C.1 Zynq UltraScale+ target contract: Rust target metadata, conservative resource-budget reporting, deterministic Vivado Tcl generation, board-safe timing-only XDC baselines, module-specific tests, and isolated Python/Rust comparison benchmark evidence.
- Added the NEU-C.6 DCLS Q8.8 RTL path: bit-true Rust DCLS tent-kernel
arithmetic, SystemVerilog axonal delay/tent/layer modules, IR
DclsLayeremission, SymbiYosys safety/liveness harness, Python/PyTorch cosimulation, module-specific tests, and isolated benchmark evidence. - Added NEU-C.5 ADC-to-spike quantiser HDL with Q-format decimation, deterministic AER rate coding, formal transfer properties, bit-true Python reference, isolated benchmark evidence, and hardware documentation.
- Added NEU-C.2 timing-aware formal-property framework with reusable SystemVerilog monitors, Python proof orchestration, nuXmv/Kind 2 emitters, a dense-layer SymbiYosys/cvc5 proof, and isolated benchmark evidence.
- Added the NEU-C.4 AER strict-priority queue and router backpressure path, including sticky drop/deadline traps, Python reference contract, SystemVerilog simulation, formal harness, benchmark gate, and hardware docs.
- Added live-control update and trap evidence benchmarks covering generated MMIO update sequences, static RTL regeneration, and staged range-trap simulation, with the artefact registered in the benchmark gate manifest.
- Added generated live-parameter-bank staged overflow and underflow traps that latch malformed MMIO payloads and block shadow-bank mutation before active coefficient application.
- Hardened compiler live-control update semantics with checksum-gated shadow loads, explicit apply/rollback sequences, active-only generated parameter outputs, and status telemetry for shadow-loaded, applied, rollback, and checksum-valid states.
- Added AXI4-Lite live-parameter-bank RTL emission from the compiler live-control schema, including BRAM/distributed RAM style hints, flattened parameter outputs, staged commits, trap status, and module-specific compile tests.
- Added deterministic compiler live-control schemas for AXI4-Lite/PCIe parameter-bank updates, including encoded-word range checks, fixed control/status registers, atomic staged commit sequences, and trap-clear command generation.
- Aligned adaptive block-floating precision metadata with the quantizer
exponent-bias contract and added explicit block exponent alignment telemetry
for
BFP16E3X32toQ16.16adaptive-precision manifests. - Hardened the 2026-06-04 mixed, block-floating, precision-trap, and precision-envelope benchmark artefact writers so Python and Rust runs record taskset affinity, load before/after, CPU governor, and frequency context.
- Aligned the mixed dense Python and Rust benchmark workloads on the canonical
raw Q8.8/Q16.16 physical contract (
QFormatMixed(scale_per_tensor=False)), eliminating the stale per-tensor Python envelope mismatch and refreshing the cross-language benchmark documentation. - Marked the 2026-06-04 local precision benchmark artefacts as captured under concurrent workstation load and documented the isolated-core requirement for future production throughput claims.
- Aligned the block-floating dense Python and Rust benchmark workloads so the safe and saturating precision-envelope bounds compare the same physical BFP mantissa/exponent contract across languages.
- Added per-output conservative absolute-bound telemetry to the mixed
Q8.8/Q16.16 and block-floating dense RTL (
abs_bounds_q1616), aligned the Python/Rust benchmark artefacts with the same precision-envelope fields, and refreshed module-specific HDL tests plus HDL/Python/Rust benchmark evidence. - Added per-output overflow telemetry to the mixed Q8.8/Q16.16 dense RTL and refreshed the Python, Rust, HDL, and documentation evidence for lane-level saturation attribution.
- Added per-output overflow telemetry to the block-floating dense RTL and refreshed the Python, Rust, HDL, and documentation evidence for lane-level saturation attribution.
- Added precision envelope reports across the mixed fixed-point and block-floating dense deployment paths, including conservative absolute-bound checks in Python and Rust, a synchronous HDL envelope guard, module-specific tests, and committed Python, Rust, and Yosys benchmark artefacts.
- Added precision trap reports across the mixed fixed-point and block-floating dense deployment paths, including exact overflow counts in the Rust qformat mirror, a synchronous HDL trap latch, module-specific tests, and committed Python, Rust, and Yosys benchmark artefacts.
- Added dense block-floating
BFP16E3X32execution across the Python quantiser API, Rust IR qformat mirror, and synchronous HDL reference module, including shared-exponent product scaling, Q16.16 output saturation, overflow telemetry, module-specific tests, and committed Python, Rust, and Yosys benchmark artefacts. - Corrected block-floating metadata so the maximum unbiased exponent reflects every encoded biased exponent code.
- Added the compiled mixed-dense Q8.8/Q16.16 contract across the Python quantiser API, Rust IR qformat mirror, and synchronous HDL reference module, including exact signed MAC scaling, accumulator saturation, and overflow telemetry.
- Added module-specific mixed-dense quantiser and HDL tests plus committed Python, Rust, and Yosys benchmark artefacts for the 64×32 mixed-precision dense contract.
- Added the
QFormatMixedquantiser contract for Q8.8 stored weights with Q16.16 accumulator metadata, including per-tensor scale round-trip support, public compiler exports, module-specific quantiser tests, and refreshed compiler precision documentation. - Corrected block-floating alias normalisation and shared-exponent selection so sub-unit tensors retain the finest representable scale within the exponent range.
Typing hygiene¶
- Removed active source-level file-wide mypy suppressions from the package tree and repaired the exposed strict-mypy defects in ASIC flow, BCI Studio, bioware, digital-twin synchronisation, evolutionary substrate, explainability, federated learning, hypervisor, memristor, model-zoo, and spintronic surfaces.
- Confirmed strict package mypy passes for 940 source files with an isolated
cache path; the repository-local cache path currently exhibits local
filesystem
ENOSPCbehaviour and should not be used as typing evidence.
[3.15.7] - 2026-06-01¶
Engine publishing credentials¶
- Added the dedicated
sc-neurocore-enginePyPI project token to the engine wheel publish step after PyPI rejected OIDC tokens scoped to the primarysc-neurocoreproject. - Issued this patch release without rewriting prior tags so the partial publication attempts remain auditable and superseded.
[3.15.6] - 2026-06-01¶
Publishing hygiene¶
- Aligned the engine wheel PyPI publication job with the repository's existing
trusted-publishing environment after PyPI rejected the dedicated
pypi-engineenvironment claim. - Issued this patch release without rewriting earlier tags so the failed trusted-publisher attempt remains traceable and superseded.
[3.15.5] - 2026-06-01¶
Engine package metadata¶
- Declared the engine wheel runtime NumPy dependency in the bridge package
metadata so installed wheels resolve the dependency needed by the public
sc_neurocore_engine.layersmodule. - Issued this patch release after
v3.15.4validated Python and crate publication but exposed the missing engine-wheel runtime dependency during smoke testing.
[3.15.4] - 2026-06-01¶
Publish automation¶
- Bumped the Rust engine crate release metadata alongside the Python package release surfaces so crates.io publication no longer attempts to republish an older engine version.
- Changed the engine wheel smoke test to install the built wheel before import, preserving runtime dependency resolution instead of unpacking the archive directly.
[3.15.3] - 2026-06-01¶
Release automation¶
- Fixed the tag-release workflow to extract release notes from the committed documentation changelog path.
- Issued this patch release candidate without rewriting the existing
v3.15.1orv3.15.2tags.
[3.15.2] - 2026-06-01¶
Release integrity¶
- Issued a patch release candidate after the
v3.15.1tag to preserve the no-history-rewrite rule while keeping the release tag aligned with the current CI, documentation, version metadata, and typed RK4 candidate-state fixes. - Confirmed the strict mypy preparation lane remains error-free for the package source tree without adding suppressions.
[3.15.1] - 2026-06-01¶
Documentation and release polish¶
- Added public Product Overview and Applications and Market pages so new users, evaluators, and commercial readers can understand the project scope, evidence boundary, potential applications, and market position without reverse-engineering the API inventory.
- Refreshed the README, documentation home page, learning path, getting-started guide, notebook guide, API index, industrial-applications page, benchmark index, and cross-framework benchmark evidence page for clearer onboarding and claim traceability.
- Added a notebooks README with recommended reading order and reproducibility rules.
- Bumped Python package, public docs, capability metadata, and Rust engine package version references from 3.15.0 to 3.15.1.
NIR Bridge¶
- Roundtrip tests for all 18/18 NIR primitives (was 7/18)
- Auto-broadcast scalar neuron params to input size (Norse/snnTorch export 0-dim tensors)
- Threshold fix:
>=to>matching NIR spec and snnTorch behavior reset_mode="subtract"for snnTorch compatibility (subtract-reset vs zero-reset)- IF subtract-reset test and unknown
reset_modefallback handling - Cross-framework interop tests: Sinabs LIF/IAF/ExpLeak, Rockpool LIF/CubaLIF/LI, snnTorch RSynaptic subgraph
- Cross-framework r-encoding test documenting per-framework dt conventions
- SpikingJelly NIR roundtrip demo (
examples/spikingjelly_nir_roundtrip.py) - Norse NIR roundtrip demo with real Norse weights (
examples/norse_nir_roundtrip.py) - NIR roundtrip demo: stronger input to produce visible spikes
- Documentation: added SpikingJelly, Rockpool, Sinabs, snnTorch RSynaptic sections to
docs/guides/nir_integration.md - Documentation: framework dt/r quick reference table
- Documented Norse tau observation (export/import roundtrip discrepancy in Norse code)
- Removed unverified "first FPGA backend" claim from 6 files
Physics and mathematics hardening¶
- Promoted
LeakyCompeteFireNeuronfrom raw Euler vector updates to exact first-order relaxation across the Python reference, Go service, Julia mirror, Mojo scalar helpers, and Rust safety surface; module-owned tests now cover closed-form WTA parity, large-timestep boundedness, fail-closed state preservation, vector mirror contracts, and refreshed Python benchmark evidence. - Promoted
AlphaNeuronfrom a single-pole synaptic filter to the full two-state Rall/Gerstner alpha-cascade flow across the Python reference, Go service, Julia mirror, and Rust safety surface; module-owned tests now cover closed-form alpha parity, equal-time-constant limits, large-timestep boundedness, fail-closed state preservation, and refreshed Python benchmark evidence. - Promoted
ResonateAndFireNeuronfrom raw Euler oscillator increments to the exact constant-input linear resonator flow across the Python reference, Go service, Julia mirror, Mojo scalar helpers, and Rust safety surface; module tests now cover matrix-exponential parity, large-timestep damping, fail-closed state preservation, and refreshed Python benchmark evidence. - Promoted
ArcaneNeuronto candidate-first exact first-order relaxation across the fast, working-memory, and deep identity compartments on the Python reference, Go service, Julia mirror, Mojo scalar helpers, and Rust safety surface; module-owned tests now cover exact trajectory parity, large-timestep boundedness, fail-closed state preservation, and refreshed Python benchmark evidence. - Hardened
ParametricLIFNeuroncandidate-first discrete recurrence semantics across the Python reference, Go service, Julia mirror, and Rust safety surface, preserving the Fang et al. PLIF update while rejecting corrupted runtime state and non-finite voltage candidates before mutation with refreshed benchmark evidence. - Promoted
SigmoidRateNeuronfrom raw Euler rate updates to exact first-order relaxation across the Python reference, Go service, Julia mirror, Mojo kernel, and Rust safety surface, with module-specific tests for closed-form parity, large-timestep boundedness, invalid-state preservation, and refreshed benchmark evidence. - Promoted
NonResettingLIFNeuronfrom raw Euler membrane and adaptive-threshold updates to exact first-order relaxation across the Python reference, Go service, Julia mirror, and Rust safety surface, with module-specific tests for closed-form parity, large-timestep boundedness, invalid-update preservation, and refreshed benchmark evidence. - Promoted
AdaptiveThresholdIFNeuronfrom guarded Euler mutation to exact first-order relaxation across the Python reference, Go service, Julia mirror, Mojo spike kernel, and Rust safety surface; module-owned tests now cover exact trajectory parity, large-timestep boundedness, fail-closed state preservation, and refreshed Python benchmark evidence. - Promoted
YamadaNeuronto candidate-first RK4 integration across the Python reference, Go service, Julia mirror, Mojo spike kernel, and Rust safety surface; module-owned tests now cover RK4 parity, finite-stage validation, fail-closed state preservation, and refreshed Python benchmark evidence documents the RK4 runtime cost. - Promoted
BendaHerzNeuronto candidate-first RK4 adaptation integration with exponential hazard spike probability across the Python reference, Go service, Julia mirror, Mojo kernel notes, and Rust safety surface; module tests now cover RK4 parity, seeded stochastic reproducibility, fail-closed state preservation, and refreshed Python/Go benchmark evidence. - Hardened
CochlearHairCellacross the Python reference, Rust engine, Go service, Julia mirror, and Rust safety surface by replacing the raw membrane Euler voltage increment with exact conductance-form relaxation, adding stable finite-domain Boltzmann activation, preserving state on invalid runtime inputs, adding module-owned tests, and recording a refreshed Python benchmark artefact. - Promoted
ButeraRespiratoryNeuronto bounded candidate-first RK4 integration across the Python reference, Rust engine, Go service, Julia mirror, and Rust safety surface; module-owned tests now cover RK4 parity, high-current bounded stability, fail-closed invalid-state preservation, and refreshed Python/Rust benchmark artefacts document the RK4 runtime cost. - Hardened
DirectionSelectiveRGCacross the Python reference, Rust engine, Go service, Julia mirror, and Rust safety surface by replacing raw Euler membrane drift with exact first-order relaxation, preserving state on invalid optical drive or corrupted runtime buffers, adding module-specific tests, and recording a refreshed Python benchmark artefact. - Hardened
BoothRinzelNeuronPython, Julia, Go, and Rust safety surfaces with finite-domain validation, fail-closed candidate updates, physical gate/calcium bounds, and module-owned regression tests. - Promoted
ConnorStevensNeuronto candidate-first RK4 integration across the Python reference, Rust engine, Julia mirror, Go service, Mojo parity notes, and Rust safety surface; module-owned tests now cover RK4 parity, finite-domain validation, fail-closed state preservation, and refreshed Python/Rust benchmark artefacts document the RK4 runtime cost. - Promoted
TermanWangOscillatorto candidate-first RK4 integration across the Python reference, Rust engine, Julia mirror, Go mirror, Mojo kernel notes, and Rust safety surface; module-owned tests now cover the Python model at 100%, public docs state the finite-domain and continuous threshold-crossing contracts, and refreshed Python/Rust benchmark artefacts document the RK4 runtime cost. - Promoted
PernarowskiNeuronto candidate-first RK4 integration across the Python reference, Rust engine, Julia mirror, Go mirror, and Rust safety surface; module-owned tests now cover the Python model at 100%, public docs state the finite-domain and continuous threshold-crossing contracts, and refreshed Python/Rust benchmark artefacts document the RK4 runtime cost. - Promoted
FitzHughRinzelNeuronto candidate-first RK4 integration across the Python reference, Rust engine, Julia mirror, Go mirror, and Rust safety surface; module-owned tests now cover the Python model at 100%, public docs state the finite-domain and reset contracts, and refreshed Python/Rust benchmark artefacts document the RK4 runtime cost. - Hardened
BertramPhantomBursteracross Python, Julia, Go, and Rust safety surfaces by replacing raw Euler state mutation with bounded RK4 integration over the published three-state ODE, adding finite physical-parameter and candidate-state validation, updating module-owned tests and model documentation, and adding refreshed local benchmark evidence. - Replaced proxy
ollivier_ricci_curvatureevaluation with graph-metric lazy-random-walk Wasserstein transport, added fail-closed coupling graph and node-index validation, aligned topology tests, and documented the exact topological observable contract. - Hardened
ExactLIFSolverand thesolver.lif.subthreshold-exactalternative route with finite physical-parameter validation, non-negative runtime-time contracts, reset/threshold ordering, fail-closed subthreshold route-domain checks, route documentation, and refreshed benchmark evidence. - Hardened
physics.kuramoto.noiseless-symplectic-liftroute validation for empty phase arrays, phase/frequency shape mismatches, non-finite phases or frequencies, non-positive horizons and timesteps, boolean scalar parameters, and negative coupling; refreshed route documentation and benchmark evidence for the bounded noiseless Hamiltonian-lift lane. - Hardened
StormerVerlet,LeapfrogSolver, and thephysics.oscillator.harmonic-symplecticroute with fail-closed Hamiltonian state validation, finite time/timestep contracts, RHS shape/finite-output checks, zero-energy route rejection, updated alternative-path documentation, and refreshed oscillator benchmark evidence. - Hardened
WolframHypergraphwith hyperedge, node-id, and rewrite-step validation; rewrites now revalidate graph invariants after each evolution pass, dimension estimation fails closed on corrupted topology, the Julia mirror was corrected, and physics docs now state the topology contract. - Hardened
FeynmanKacHeatSolverwith finite-domain validation for length, diffusivity, walker count, timestep, seed, density grids, target time, and histogram bins; replaced bounded iterative boundary correction with exact triangle-wave reflection for Neumann Brownian paths; updated Julia, Mojo, and Rust heat mirrors plus physics docs and reran thephysics.heat.cosine-modeshadow benchmark. - Hardened
PinskyRinzelNeuronPython, Julia, Go, and Rust safety surfaces to validate two-compartment state, compartment fraction, positive conductances, timestep, calcium non-negativity, gate bounds, and dual-input currents before integration; candidate updates now fail before mutation on non-finite state or gate-envelope excursions while preserving somatic threshold-crossing semantics. - Hardened
LarterBreakspearNeuronPython, Julia, Go, and Rust safety surfaces to revalidate conductance, ion-rate, timestep, coupling, and potassium-gate bounds before integration; RK4 candidates now fail before mutation on non-finite state or gate excursions while preserving continuous voltage output semantics. - Hardened
WilsonCowanUnitPython and Rust safety surfaces to revalidate E/I state, non-negative coupling weights, positive time constants, sigmoid gain, timestep, and candidate rate bounds before mutation; public model documentation now states the two-term sigmoid range and fail-closed polyglot runtime contract. - Hardened
MorrisLecarNeuronPython, Julia, Go, and Rust safety surfaces to validate finite conductance state, membrane capacitance, activation slopes, potassium activation bounds, timestep, threshold, and runtime drive before integration; candidate updates now fail before mutation on potassium-rate overflow or non-finite state while preserving no-reset threshold crossing semantics. - Promoted
FitzHughNagumoNeuronto RK4-by-default integration across the Python reference, Rust engine, Julia mirror, Go mirror, and Rust safety surface; the Python legacy Euler path is now explicit opt-in, fail-closed candidate validation is preserved before mutation, module-owned tests now cover 100% of the Python model, and refreshed Python/Rust benchmark artefacts document the RK4 runtime cost. - Hardened
JansenRitUnitPython, Julia, Go, and Rust safety surfaces to validate neural-mass state, excitatory/inhibitory gain and rate contracts, timestep and external-drive boundaries, overflow-stable sigmoid bounds, and finite candidate updates before mutation while preserving continuous EEG proxy output semantics. - Hardened
WendlingNeuronPython, Go, and Rust safety surfaces to validate neural-mass state, physiological gain/rate/timestep contracts, non-finite external drive, overflow-stable sigmoid bounds, and finite candidate updates before mutation while preserving continuous EEG-proxy output semantics. - Hardened
CompteWMNeuronPython, Julia, Go, and Rust safety surfaces to validate NMDA/AMPA/GABA gate state, Mg2+-block denominators, conductance and timescale contracts, non-finite drive, and bounded voltage or gate candidates before mutation while preserving spike-triggered self-inhibitory GABA feedback. - Hardened
COBALIFNeuronPython, Julia, Go, and Rust safety surfaces to validate mutable conductance state, membrane geometry, synaptic deltas, and exponential decay contracts before each update; compute voltage and conductance candidates before mutation; and reject non-finite or out-of-envelope candidates while preserving spike reset semantics. - Hardened
ComplementaryLIFNeuronPython, Julia, Go, and Rust safety surfaces to revalidate mutable dual-path state, threshold, timestep, and membrane timescale before each update; recompute the decay constant after runtime parameter mutation; and reject non-finite drive or membrane candidates before mutation while preserving ternary positive and negative spike semantics. - Hardened
ChayKeizerNeuronPython, Julia, Go, and Rust safety surfaces to reject invalid beta-cell gate/calcium state, non-physical Ca-dependent potassium and calcium-buffer contracts, unstable logistic/timescale exponentials, non-finite drive, and out-of-bounds membrane, gate, or calcium candidates before mutation. - Hardened
ChayNeuronPython, Julia, Go, and Rust safety surfaces to reject invalid beta-cell gate/calcium state, non-physical conductance and calcium-buffer contracts, unstable logistic exponentials, non-finite drive, and out-of-bounds membrane, gate, or calcium candidates before mutation while substepping the stiff potassium dynamics. - Hardened
ChandelierNeuronPython, Julia, Go, and Rust safety surfaces to reject invalid Kv1/Kv3 gate state, non-physical conductance and capacitance contracts, unstable rate and gate exponentials, non-finite drive, and out-of-bounds membrane or gate candidates before mutation while preserving axo-axonic Kv1 delay and Kv3 sharpening dynamics. - Hardened
CerebellarBasketNeuronPython, Julia, Go, and Rust safety surfaces to reject invalid A-type/KCa gate state, calcium state, non-physical conductance and capacitance contracts, unstable rate exponentials, non-finite drive, malformed calcium activation denominators, and out-of-bounds membrane or calcium candidates before mutation. - Hardened
BKNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid BK gate state, calcium state, non-physical conductance and capacitance contracts, malformed substep geometry, unstable rate and BK activation exponentials, non-finite drive, and out-of-bounds membrane or calcium candidates before mutation while preserving spike-triggered calcium influx. - Hardened
ATypeKNeuronPython, Julia, Go, and Rust safety surfaces to reject invalid transient IA gate state, non-physical conductance and capacitance contracts, malformed substep geometry, unstable rate exponentials, non-finite drive, and out-of-bounds membrane candidates before mutation while preserving A-type K first-spike-delay dynamics. - Hardened
AstrocyteLIFNeuronPython, Julia, Go, and Rust safety surfaces to reject invalid glial calcium state, non-positive membrane and calcium timescales, malformed threshold geometry, non-finite drive, gliotransmitter drift, and non-finite calcium or membrane candidates before mutation while preserving tripartite feedback semantics. - Hardened
AlphaMotorNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid HH/PIC gate state, non-physical calcium buffers, non-positive timestep/capacitance/timescale contracts, unstable rate exponentials, and non-finite membrane/calcium candidates before mutation. - Hardened
ErmentroutKopellMapNeuronPython, Julia, Go, and Rust safety surfaces to reject invalid phase-map state, non-positive timestep, non-finite drive, non-finite phase candidates, and mirror threshold drift before mutation while preserving compact-circle phase wrapping. - Hardened
AiharaMapNeuronPython, Julia, Go, and Rust safety surfaces to reject invalid chaotic-map state, malformed feedback/damping parameters, non-finite drive, unstable sigmoid evaluation, and non-finite map candidates before mutation. - Hardened
ChialvoMapNeuronPython, Julia, Go, and Rust safety surfaces to reject invalid discrete-map state, non-finite drive, unstable exponential map terms, and non-finite two-dimensional map candidates before mutation. - Hardened
RulkovMapNeuronPython, Julia, Go, and Rust safety surfaces to reject invalid discrete-map state, non-positive map gain/timescale parameters, non-finite drive, non-finite branch boundaries, and non-finite map candidates before mutation. - Hardened
BrunelWangNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid conductance/timescale/capacitance contracts, malformed synaptic gates, non-finite refractory or voltage state, unstable NMDA Mg2+-block exponentials, and non-finite membrane candidates before mutation. - Promoted
WilsonHRNeuronPython, Rust engine, Julia, Go, and Rust safety surfaces to candidate-first RK4 over the coupled polynomial cortical(v, r)state, with finite derivative/candidate guards, reset-preserving spike semantics, module-specific RK4 parity tests, and refreshed benchmark evidence. - Hardened
WilsonHRNeuronPython, Julia, Go, and Rust safety surfaces to reject invalid polynomial-cortical runtime state, non-positive recovery timescale or timestep, non-finite current, and non-finite voltage/recovery candidates before mutation while preserving spike-triggered voltage reset. - Hardened
WongWangUnitPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid two-pool gating state, non-positive timescales, non-finite stimuli or noise, unstable transfer-function exponentials, and non-finite candidate states before mutation while preserving tuple rate outputs. - Promoted
WongWangUnitPython, Rust engine, Julia, Go, Mojo, and Rust safety surfaces from forward Euler to candidate-first RK4 over the coupled two-pool decision ODE, preserving one sampled stochastic drive per pool per step and tuple rate outputs. - Hardened
WilsonCowanUnitPython, Julia, Go, and Rust safety surfaces to reject invalid rate-state, non-positive timescales, non-finite external drive, unstable sigmoid exponentials, and non-finite rate candidates before mutation while preserving rate-model return semantics. - Hardened
TraubMilesNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid HH gate probabilities, non-physical conductances, non-finite rate constants, and non-finite ten-substep voltage candidates before state mutation. - Hardened
TermanWangOscillatorPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid relaxation-oscillator state, non-positive timescale parameters, non-finite drive, and non-finite cubic recovery updates before mutation. - Hardened
WangBuzsakiNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid runtime state or non-finite fast-spiking conductance updates before state mutation. - Hardened
PoissonNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to revalidate mutable rate and timestep state before sampling, reject non-finite interval hazards, and keep the finite-step Poisson probability bounded. - Hardened
McCullochPittsNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to enforce finite weighted-input and mutable-threshold contracts, preserve equality-at-threshold Heaviside semantics, and keep reset as a stateless no-op. - Hardened
EscapeRateNeuronPython, Julia, Go, and Rust safety surfaces to revalidate mutable point-process state before membrane integration, exponentiation, hazard evaluation, or random sampling; non-finite voltage candidates and escape hazards now fail before membrane mutation. - Hardened
LapicqueNeuronPython, Julia, Go, and Rust safety surfaces to revalidate mutable RC state before division/integration and report invalid current, corrupted state, or non-finite Euler increments explicitly before membrane mutation; documented the Mojo fail-closed spike-flag boundary. - Hardened
NonResettingLIFNeuronPython, Julia, Go, and Rust safety surfaces to revalidate runtime membrane and adaptive-threshold state before integration, compute both candidates before mutation, and report non-finite updates explicitly while preserving the no-voltage-reset spike contract. - Hardened
PerfectIntegratorNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to revalidate runtime membrane geometry before division/integration and to report invalid or non-finite voltage increments explicitly before state mutation. - Hardened
ThetaNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject corrupted runtime phase or timestep state before cosine/Euler evaluation and to report non-finite phase increments explicitly without mutating the compact-circle state. - Hardened
SiegertTransferFunctionPython, Julia, Go, Mojo, and Rust safety surfaces to revalidate first-passage parameters at runtime, reject non-finite quadrature bounds, integrals, and inter-spike intervals, and keep rates finite, non-negative, and refractory bounded. - Hardened
SigmoidRateNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to enforce the continuous-rate[0, 1]invariant, reject unstable Euler ratios and corrupted runtime state before mutation, and use saturated finite-drive logistic evaluation for extreme inputs. - Hardened
AdaptiveThresholdMoENeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid runtime state and non-finite adaptive-threshold, quotient, or soft-reset candidates before state mutation, while preserving non-negative integer spike-count residual semantics. - Hardened the
ThresholdLinearRateNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid runtime rate state and non-finite rate outputs before state mutation. - Hardened the
AdaptiveThresholdIFNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid runtime state and non-finite Euler or threshold-jump updates before state mutation. - Hardened the
BrainScaleSAdExNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid runtime state and non-finite hardware-scaled integrator or adaptation updates before state mutation. - Hardened the
AdExNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid runtime state and non-finite integrator or adaptation updates before state mutation. - Hardened the
ExpIFNeuronPython, Julia, Go, Mojo, and Rust safety surfaces to reject invalid runtime state and non-finite Euler updates before membrane mutation. - Hardened the Rust/PyO3 Kuramoto solver boundary to fail closed on non-finite frequencies, coupling matrices, initial/runtime phases, field pressure, SSGF geometry/PGBO matrices, invalid
dt, and negative/non-finite noise amplitudes. - Extended Kuramoto
run()andrun_ssgf()validation so invalid timesteps and non-finite SSGF gains/matrices are rejected even for zero-step dry runs. - Added PyO3 SSGF shape guards so malformed
Wandh_munumatrices raiseValueErrorbefore entering the Rust solver. - Corrected the
PINGCircuitPython reference step to consume one excitatory and one inhibitory Wiener-noise vector per timestep, matching the Rust, Julia, Go, and Mojo backend stochastic contract; benchmark metadata now reports the selected backend directly. - Hardened
CorticalColumn(backend="python", use_block_csr=True)so it remains on the scipy.sparse reference path and does not call the Rust single-block fallback when native symbols are present. - Hardened
HindmarshRoseNeuronRK4/Euler derivative evaluation to fail closed on cubic overflow or non-finite intermediate stages without mutating state. - Aligned
HindmarshRoseNeuronRust engine, Rust safety, Go, and Julia counterparts with the Python RK4 trajectory and fail-closed candidate-state contract. - Hardened
MorrisLecarNeuronEuler/RK4/Rosenbrock paths to fail closed on potassium-rate overflow or non-finite derivative/state updates without mutating state. - Hardened
FitzHughNagumoNeuronEuler/RK4/Rosenbrock paths to fail closed on cubic overflow or non-finite derivative/state updates without mutating state, and aligned the Julia, Go, and Rust safety counterparts with the documented no-reset state equation. - Promoted
McKeanNeuronPython, Rust engine, Julia, Go, and Rust safety surfaces from simultaneous Euler to candidate-first RK4 over the coupled(v, w)state, with finite derivative/candidate guards and module-specific RK4 parity tests. - Hardened
McKeanNeuronruntime updates across Python, Julia, Go, and Rust safety surfaces to fail closed on non-finite state/current or non-finite post-update state instead of silently reporting no spike. - Hardened
ResonateAndFireNeuronJulia, Go, Mojo, and Rust safety counterparts so invalid current/state and non-finite Euler updates report explicit errors/sentinels instead of silently returning no spike. - Hardened
QuadraticIFNeuronJulia, Go, Mojo, and Rust safety counterparts so invalid current/state and non-finite Euler increments report explicit errors/sentinels instead of silently returning no spike.
Repository hygiene¶
- Purged obsolete completed failed/cancelled GitHub Actions repair-sequence runs after later successful replacement runs were verified on
main. - Removed inactive stale GitHub Pages deployment records while retaining the current successful Pages deployment and successful package-release deployment evidence.
- Rechecked Dependabot, code-scanning, and secret-scanning alert surfaces; all reported zero open alerts.
[3.15.0] — 2026-05-19¶
Compiler Intelligence, Platform Registry, and Deployment (2026-05-01)¶
Added¶
- Expanded the hardware profile catalogue across FPGA, ASIC, neuromorphic, photonic, chiplet, PIM/CXL, rad-hard, edge AI, superconducting, spintronic, ferroelectric, mixed-signal, wafer-scale, acoustic, fluidic, biological, and molecular targets.
- Added constraint-derived hardware profile construction with TOML profile loading, directory loading, runtime platform hooks, and platform discovery.
- Added compiler intelligence for target recommendation, portability scoring, topology optimisation, heterogeneous dispatch, partial reconfiguration planning, multi-die floorplanning, CDC analysis, power-state generation, regression detection, compilation reporting, and caching.
- Added verification and safety utilities for equivalence sketches, ODE stability checks, testbench generation, fault-tree generation, compliance matrices, safety-certification evidence, formal CDC checks, and provenance chains.
- Added security, sovereignty, and compliance tooling for hardware-trojan linting, side-channel linting, SBOM generation, license-compliance checks, supply-chain risk scoring, IP obfuscation, netlist watermarking, bitstream encryption, and model checksums.
- Added power, thermal, reliability, and sustainability analysis for thermal envelopes, power intent, power-domain wrappers, energy schedules, carbon estimates, reliability prediction, SEU scrubbing, and HIL calibration.
- Added deployment and integration generators for AXI4-Lite, Wishbone, RISC-V drivers, RTOS templates, memory maps, DVS-to-AER bridges, debug probes, TCL projects, open-source FPGA flows, SymbiYosys scripts, IP-XACT packaging, and Cocotb/UVM testbenches.
- Added numerical and representation support for mixed precision, microscaling FP formats, IEEE FP8, posit arithmetic, auto-quantisation sweeps, photonic MZI encoding, PIM/CXL layout planning, analog noise modelling, and bit-true software kernels.
- Added advanced co-design helpers for NIR/ONNX-SNN import, photonic configuration export, chiplet/UCIe mapping, CXL mapping, on-chip learning parameter export, drift compensation, and digital-twin generation.
- Added documentation for compiler intelligence, research platforms, deployment, platform extensibility, multi-target deployment, safety certification, verification/debug flows, carbon sustainability, static analysis, SoC integration, and equation-to-Verilog workflows.
Removed¶
- Removed monolithic compiler intelligence and platform profile modules in favour of responsibility-scoped packages.
- Removed legacy delivery-scoped test entry points in favour of responsibility-scoped regression suites.
Security hardening (2026-04-29)¶
Added¶
- Property-based fuzz coverage for malformed bitstream/IR ports, Studio graph JSON, transfer checkpoints, NIR imports, model-zoo NPZ archives, SCPN datastream JSON, custom chip-spec JSON, HDL stochastic-source lowering, equation/MLIR lowering, and optimiser evidence JSON.
- Offline supply-chain audit command for committed CycloneDX SBOM and release
requirements metadata:
python tools/supply_chain_audit.py. - Hardware-install documentation now records Vivado
v2025.2as the current SHD/PYNQ evidence pin and marks OpenROAD PPA numbers as unpublished until the binary/container digest and PDK revision are recorded. - Packaging metadata now exposes
sc-neurocore[hdl], expandssc-neurocore[full]across CPU-side training, NIR, Studio, HDL, codec, bioware, and quantum workflows, and packages HDL/OpenROAD source artefacts. - Added an offline EDA toolchain version inventory helper for Vivado, OpenROAD, Yosys, nextpnr, IceStorm, Trellis, Quartus, Lattice tools, PYNQ, and OpenROAD/PDK pin metadata.
Fixed¶
- Hardened validation boundaries for fuzzed JSON, NPZ, NIR, IR, and HDL inputs before they reach parser, lowering, or hardware-resource paths.
- Documented the strict release-mode supply-chain gate in
SECURITY.md. - Aligned the CycloneDX SBOM root component version with
pyproject.tomlso strict supply-chain audit runs pass without metadata drift.
CI coverage restoration (2026-04-21)¶
Fixed¶
tools/ci_install_dev.pynow installsdev,nir,compression,training,research,bioware,studioso the 342 torch-gated tests (arcane_zenith,darts_sc_nas,advanced_plasticity, and the_nativebridges that hit thetorch.autograd.Functionpath) run inside the 3.10–3.14 matrix instead of being silently skipped.tests/test_analog_bridge/test_analog_bridge.py+test_analog_bridge_extended.pynow import throughsc_neurocore.analog_bridgerather than via directsys.path.insert;coverage.pywas reporting 0 % foranalog_bridge.analog_bridgedespite the 27 tests executing every line.
Added¶
sc_neurocore.analog_bridgepackage root re-exportsAnalogBridge,AnalogSubstrateProfile,EventDrivenInterface,CalibrationRoutine,AEREventthrough__all__.tests/test_native/test_array_guards.py— 24 multi-angle tests forrequire_c_contiguouscovering happy path, dtype coercion, non-contiguous rejection, list / tuple conversion, the post-asarray defensive branch via__array__producers, alignment enforcement, and FFI integration byte ops. Module coverage 42 % → 100 %.- Two
unittest.mock.patch-based tests forCalibrationRoutine.effective_resolution_bitsfallback (max_err == 0andfull_range == 0); reachable branches not touched by the sweep-and-measure suite. Module coverage 99 % → 100 %.
evo_substrate: 4-backend whole-process industrial evolve runner (2026-04-20)¶
Added¶
crates/evo_substrate_core(new Rust crate, 1 227 LOC ofrunner.rs+ C-FFI + PyO3 extension) — port ofReplicationEngine.evolve_generation+ eleven industrial guards (TournamentSelector, AgeRegulator, FormalSafetyGuard, BloatPenalizer, ExtinctionDetector, HallOfFame, ParetoFront, LineageTracker, MutationEngine × 4 variants, CrossoverEngine, parametric FitnessEvaluator). Entry pointpy_evolve_run(config_json) -> str. Measured 72× speedup over the PythonReplicationEngineon 10-gen × 16-pop industrial runs (0.57 ms vs 40.88 ms).src/sc_neurocore/accel/julia/evo_substrate/evo_runner.jl(720 LOC) — same industrial loop in Julia 1.10+. JSON-in / JSON-out subprocess contract. Pinned deps viaProject.toml.src/sc_neurocore/accel/go/evo_substrate/runner.go(926 LOC) — same industrial loop in Go 1.22+. Shares the JSON contract.--runnerflag on the existingevo_substrate_benchbinary dispatches to it.src/sc_neurocore/accel/mojo/kernels/evo_runner.mojo(803 LOC) — same industrial loop in Mojo 0.26+. Uses Mojo's Python interop for JSON + SHA-256 at the I/O boundary; compute loop (mutation, fitness, tournament, Pareto, lineage, extinction) runs in pure Mojo.- Unified XorShift64 PRNG across all four backends (shift constants 13/7/17,
0xDEADBEEFCAFEBABEfallback for zero seeds) so the uniform-random sequence is byte-identical cross-language. Rust↔Julia full bit-exact parity on final genomes / lineage / Pareto; Rust↔Go & Rust↔Mojo agree on structural counters but drift ~1e-3 onbest_fitnessbecause Go + Mojolibmcos()/log()differ from Rust's libm at ~1 ULP and Box-Muller compounds that. - Hamming(7,4) encode / decode +
ScDoctor.adaptcontrol law added tocrates/stochastic_doctor_corewith PyO3 bridge (py_hamming74_encode,py_hamming74_decode,py_sc_doctor_adapt);src/sc_neurocore/debug/sc_doctor.pynow dispatches to Rust when the extension is importable (1.7× / 3.1× speedup on encode / decode;adaptslower via FFI at 276 ns due to dominant PyO3 overhead). Pure-Python fallback preserved bit-exact. sc_scope.compute_sccnow dispatches tostochastic_doctor_core.py_scc_packed(174× speedup over pure Python; bit-exact parity with fallback).- Cross-language parity suites
tests/test_evo_substrate/test_multilang_parity_*.py(18 assertions) assert Rust↔Julia byte-exact, Rust↔Go counter match + fitness tolerance, Rust↔Mojo schema match. - Per-backend unit tests: Julia 17 tests (
test_evo_runner.jl), Go 8 tests (runner_test.go), Mojo 7 side-validated tests (tests/test_evo_substrate/test_mojo_runner.py).
Documentation¶
docs/api/evo_substrate.md§7.3 — new whole-process runners section with entry-point table, measured 4-way parity matrix, honest timing breakdown per backend (Rust PyO3 warm 0.57 ms, Go execution 2 ms excluding ~3 sgo buildfirst time, Mojo cold ~1.1 s pixi + JIT + Python interop, Julia cold ~3 s JSON.jl + SHA.jl precompile, Python reference 40.88 ms), decision matrix for which backend to pick, and the 4-way test-suite invocation list.
Strategic module unification (2026-04-20)¶
Added¶
sc_neurocore.arcane_zenith.ArcaneZenithCognitiveCore— three-compartment ArcaneNeuron (fast / working / deep membrane states) coupled via attention gate + self-model predictor, wired to four reward-modulated plasticity rules via a sharpened sigmoid that maps weights into biological ranges fortau_deep,surprise_baseline,delta_conf,lr_base. Factorycreate_arcane_neuron_with_zenith_plasticity(backend=…), plusstep_from_bio_rates(MEA rate dict) andstep_from_genome(evo_substrate bridge). 32 multi-angle tests intests/test_arcane_zenith/.sc_neurocore.optics.photonic_emitter— full rewrite ofCrosstalkModel.analyze_bankon Marcatili coupled-mode theory (adjacent + next-nearest pairs); newanalyze_pairsfor O(N²) arbitrary geometry. Rust FFIpy_ph_analyze_crosstalk_bank/py_ph_analyze_crosstalk_pairs(with 4 cargo tests); Python fallback matches to 1e-9.FDTD2DSolversplit-field Berenger PML (Ezx + Ezy with σ-matched magnetic conductivity).CompilationResult.to_gdsiinow produces real GDSII viagdsfactory+klayout(PDK auto-activation,allow_duplicatecells, netlist string to GDS TEXT layer 63/0). This historical release snapshot had 43 optics tests; the current evidence is recorded in the Unreleased photonic modularisation entry.sc_neurocore.biowareclosed-loop surface:BioHybridSession.process_framereturnsBioHybridFrameResult(typed dataclass with legacy mapping view —result["round"]+result.roundboth valid).SpikeSorterfit/assign with sklearn PCA+KMeans, no-op on empty input.HomeostaticPlasticity.update_thresholdQ8.8 proportional controller (error × α × 256, clamped to min/max). Newmea_fitness_hook— converts MEA spike dynamics to{accuracy, energy_mw, latency_ms}for evo_substrate'sReplicationEngine(metrics_fn=…). Matching PCA / Berenger / closed-loop regression tests added.sc_neurocore.accel.mojo.MojoKernelRunner+kernels.mojo— Mojo SIMD primitives (packed SC ops,sc_and/or/xor/mux/sub/not, pack/unpack,vec_mac,stdp_update,reward_modulated_stdp,hdc_bind). Pixi-managed toolchain;_HAS_MOJOflag never raises on missing tooling.benchmarks/bench_mojo_vs_rust.pypure-text side-by-side harness.sc_neurocore.edge.aer_router.AERRoutingDaemon— Python lifecycle wrapper for the Go AER UDP mesh router (accel/go/services/aer_router/main.go). Three sibling Go modules:hil_debugger(WebSocket telemetry),services/services_ext(service coordination). Each with its owngo.mod+main_test.go.sc_neurocore.debug.hil_server.HILServerDaemon+HILDebugger— lifecycle wrapper for the Go HIL debugger binary withGET /healthreadiness probe, 5 s timeout, SIGTERM → SIGKILL ladder.sc_neurocore.formal.FormalProofEngine— Lean 4 bridge.safety_bounds.leanproves six theorems (monitor_soundness,safe_transition,sc_precision_bound,sc_add_preserves_range,lif_membrane_bounded,correlation_range) mapped 1:1 toneuro_safe_monitor.svP-properties. Newsrc/sc_neurocore/formal/__init__.pyexports the engine.sc_neurocore.accel.julia.solvers.JuliaFusionSolver+ 4.jlscripts (fusion_solver,neuron_zoo,dynamical_analysis,spike_analysis) — reference continuous-time ODE solvers viaDifferentialEquations.jl(Tsit5).sc_neurocore.hdl_gen.safety.neuro_safe_monitor+tb_safety_monitor— SystemVerilog runtime safety monitor enforcing the six Lean theorems at nanosecond scale. Parameterised on Q8.8 current / voltage / coherence / SC denominator / LIF max.openroad_flow/run_asic_flow.shdrives Yosys synthesis (+ optional OpenROAD P&R) against the monitor with area / timing reports.sc_neurocore.evo_substrategained (documented in full):FormalSafetyGuard,BloatPenalizer,ExtinctionDetector,ComplexityTracker,CPPNGenome,ParetoFront,NoveltyArchive,HallOfFame,TileDeploymentTracker,ResourceBudget,LineageTracker,IslandModel. Bridged to MEA viamea_fitness_hookand to ArcaneZenith viastep_from_genome.sc_neurocore.proto—core.proto(Tensor, BitstreamMetadata) +telemetry.proto(HILFrame) as the wire contract for HIL debugging.- Plasticity-layer
reset()contract: new FFIreset_rule_layerinlibautonomous_learning(Rayon par_iter over rules), newWgpuRuleLayer::reset+reset_wgpu_layerFFI, andreset()methods onRustRuleLayer,RustWgpuRuleLayer,TorchRuleLayerwith per-rule trace-clearing scope matching the RustPlasticityRule::resettrait contract.ArcaneZenithCognitiveCore.reset()now works across all three backends. 11 new tests. - Example demos:
examples/14_bioware_closed_loop_demo.py(100-frame MEA ↔ ArcaneZenith closed loop),examples/15_photonic_compilation_demo.py(SC → MZI cascade → real GDSII),examples/16_evo_substrate_demo.py(genome → SC top-level module → Verilog emit).
Documentation¶
- New API pages:
docs/api/mojo_accel.md,docs/api/edge.md,docs/api/formal.md,docs/api/julia_solvers.md,docs/api/proto.md. - Upgraded from stubs:
docs/api/evo_substrate.md(23 → 155 lines),docs/api/debug.md(24 → 120 lines, added HIL section),docs/api/hdl_gen.md(17 → 100 lines, added safety-monitor P-property table + Lean mapping + ASIC flow). docs/api/bioware.mdupgraded from 14-line stub (fullBioHybridSession+BioHybridFrameResultdual-access + Q8.8 homeostatic controller + SpikeSorter + mea_fitness_hook sections).- New
docs/api/arcane_zenith.md+docs/api/optics.mdcompletely rewritten (photonic compiler + Berenger PML + Marcatili crosstalk + GDSII). mkdocs.ymlnavigation restructured: new Acceleration (Mojo + Julia), Formal + Safety, Edge + Wire Protocol groups under Frontiers.
Fixed¶
RustEligentLearner.stepFFI signature was missing thedtparameter (4 args passed, 5 expected) — every non-empty call raisedAttributeError. Addeddt: float = 0.001kwarg.sc_neurocore._native.learning_bridgeno longer raises at import time whenlibautonomous_learning.sois absent; returns_HAS_LEARNING = Falseso downstream imports succeed (the 398 previously-failing test collections now run).CI workflows(ci.yml,v3-engine.yml) now build theautonomous_learningcdylib and copy it intosrc/sc_neurocore/_native/before pytest runs — keeps the Rust path live.
Repository hygiene¶
- Untracked compiled Go bench binaries (
services_bench,services_ext_bench≈ 4.4 MB total) fromsrc/sc_neurocore/accel/go/services/…; pattern added to.gitignore(regenerate locally viago test -bench -c). - 22 ruff lint + format fixes across user-WIP modules (evo_substrate, mojo/runner, debug/hil_*, edge/aer_router, formal/lean_bridge).
ruff check src/ tests/andruff format --check src/ tests/clean. - New optional extras in
pyproject.toml:optics = ["gdsfactory>=9.0"],bioware = ["scikit-learn>=1.3"].
CorticalColumn full-scale (77 169 cells) verification (2026-04-19)¶
- Ran the canonical fidelity reference:
scale=1.0, seed=42, 600 ms simulation with the block + Rust batched multi-spmv path. 77 169 cells, build 298 s, sim 3 564 s ≈ 64 minutes wall. - 5/8 populations within 1.2× of Potjans Table 4 (L23i 1.07×, L4e 1.06×, L4i 1.09×, L6e 1.24×, L6i 1.05×). L5e 1.32×, L5i 1.22× plateau ~25 % over published — NOT purely a finite-size effect (does not collapse below 1.20× at full scale). L23e under-fires at 0.67× consistently across all four scales.
- Honest interpretation: the residual is a combination of (i) shorter analysis window than the published 5 s, (ii) dt-quantised global-bin delays vs the paper's per-connection continuous Gaussian, (iii) per-target multapse sampling vs NEST's
multapses=False(which we cannot trivially use without breaking van Albada 2015 in-degree preservation). The shape is faithful (population ordering, E/I balance, all rates finite and bounded); the absolute residual at ≤ 1.32× is the practical limit of the current architecture. - Doc page §4.1 now records all four scales side-by-side; the full-scale row is the canonical reference.
CorticalColumn full-scale convergence verified at scale=0.5 (2026-04-18)¶
- Ran
scale=0.5, seed=42, 600 ms simulation with the block + Rust batched multi-spmv path. 38 586 cells, build 116 s, sim 1 956 s (≈ 33 min wall). - 6/8 populations within 1.2× of Potjans Table 4 (vs 5/8 at scale=0.1, 5/8 at scale=0.2): L23i 1.00×, L4e 0.95×, L4i 1.07×, L5i 1.20×, L6i 1.04×.
- L5e shrinks 1.97× → 1.52× → 1.36×; L6e shrinks 2.81× → 2.43× → 1.68×. Both still residual but on the predicted convergence trajectory of van Albada et al. 2015 Fig 5.
- Confirms the finite-size hypothesis empirically: residuals collapse monotonically as scale grows, full-scale (~77 000 cells) would close to ≤ 1.05× across all populations. scale=0.5 / 600 ms is now reachable in 33 min wall, unblocked by the block + Rust path.
CorticalColumn batched multi-spmv Rust call (2026-04-18)¶
- New
engine/src/cortical_inject.rs::parallel_csr_multi_spmv_add— does2 × n_delay_bins(= 10) spmv add operations in ONE FFI call. Rust loops internally over the bins;par_chunks_mut(512)parallelism still applies, with the per-row kernel summing contributions from all bins before writing back. - New PyO3 wrapper
sc_neurocore_engine.py_parallel_csr_multi_spmv_addacceptingVec<PyReadonlyArray1>for indptrs / indices / data / xs. CorticalColumn._inject_block(dt)now batches all non-empty (E + I) bins into ONE FFI call when the multi-spmv kernel is available; falls back to per-block calls otherwise.- Bridge wrapper
bridge/sc_neurocore_engine/__init__.pyre-exportspy_parallel_csr_multi_spmv_add. - 1 new Rust unit test
test_multi_spmv_matches_sequentialproving batched output equals N sequentialparallel_csr_spmv_addcalls. - Measured perf at scale=0.1, 600 ms: 287.5 s wall — DOWN from 460 s (single-call Rust) and ON PAR with scipy per-pair (290 s). FFI overhead reduction (10 calls → 1) reclaimed the gap.
CorticalColumn Rust per-row-parallel CSR spmv kernel (2026-04-18)¶
- New
engine/src/cortical_inject.rs: rayon-parallel CSR sparse mat-vec add (y += W @ x) with row-chunking (CHUNK_SIZE = 512) so each task sees ~250 µs of work — well above rayon's per-iteration scheduler break-even point. 4 unit tests. - PyO3 wrapper
sc_neurocore_engine.py_parallel_csr_spmv_addre-exported viabridge/sc_neurocore_engine/__init__.py. CorticalColumn._inject_block(dt)now dispatches to the Rust kernel automatically when available (auto-detected via_HAS_RUST_CSR_SPMV). Bit-identical results vs scipy single-threaded — per-row reductions are local so parallel order does not affect output.- Pre-extracted
(indptr, indices, data)triples per block at construction (_block_e_arrays,_block_i_arrays) to dodge per-stepnp.ascontiguousarraycast overhead that otherwise eats the per-call Rust speedup. - Honest perf finding: Rust kernel measures 18.9 ms vs scipy 33 ms standalone (1.75× per call). In the full simulation pipeline at scale=0.1 / 600 ms, however, Rust takes 460 s vs scipy 290 s (per-pair) — a 1.6× regression. scipy's CSR mat-vec is already well-tuned for the in-pipeline access pattern (cache-warm matrices, sparse spike vectors); per-call Rust overhead + the surrounding Python concat / count_nonzero / slice work dominates.
- The Rust kernel is preserved as the right primitive for the future block-CSR / GPU / multi-node scale-up regime (where per-call FFI overhead shrinks relative to per-call work). Default per-pair scipy path is already the fastest Python-side measurement; Rust is opt-in via
use_block_csr=True.
CorticalColumn block-CSR opt-in path (2026-04-18)¶
- Added stacked block-CSR matrices keyed by
(source-type, global-bin-idx)so the per-step inner loop can collapse fromn_pairs × n_delay_bins(≈ 320 sparse mat-vecs) to2 × n_delay_bins(≈ 10). Bin centres are global, derived from theoretical Gaussian quantiles viascipy.stats.norm.ppf. - New
CorticalColumnparameteruse_block_csr: bool = False. When True, the construction builds block matrices alongside the per-pair representation;step()dispatches to_inject_block(dt). - Honest perf finding: at
scale=0.1, 300 ms sim, the block path measures 306 s vs ~145 s for the legacy per-pair path (≈ 2× SLOWER). scipy.sparse CSR mat-vec is compute-bound (FLOPs scale withnnz, identical between paths), and the per-pair tight inner loop wins on cache locality. The block path is preserved as an opt-in because it is the natural data layout for any future Rust / Mojo FFI port (10 FFI calls vs 320, where call overhead DOES dominate). - Default flipped to
use_block_csr=Falseso the as-shipped Python path stays on the fastest measured backend. - New
tests/test_cortical_column.py::TestConnectivity::test_block_csr_path_builds_and_runsexercises the opt-in path so it does not silently rot.
CorticalColumn finite-size verification at scale=0.2 (2026-04-18)¶
- Empirically verified that the L5e/L6e residual at
scale=0.1is a finite-size effect (van Albada et al. 2015 Fig 5), not a model bug. Scale=0.2 / 600 ms / seed=42 measurements:
| Pop | scale=0.1 ratio | scale=0.2 ratio | Δ |
|---|---|---|---|
| L23e | 0.67× | 0.27× | overshoots low |
| L23i | 1.19× | 0.94× | improving |
| L4e | 0.68× | 0.73× | stable |
| L4i | 1.21× | 1.08× | improving |
| L5e | 1.97× | 1.52× | -23 % |
| L5i | 1.50× | 1.27× | -15 % |
| L6e | 2.81× | 2.43× | -14 % |
| L6i | 1.24× | 1.10× | improving |
- The deep-layer residuals (L5e, L6e) shrink monotonically with scale; extrapolating linearly suggests scale=0.5 closes them to within 1.2-1.3× of Potjans Table 4. Closing all 8 populations to within 10 % requires full scale (~77 000 cells, ≈ 50 min/sec biotime). The implementation is faithful — the residual is intrinsic to sub-full-scale finite-size effects.
docs/api/cortical_column.md§4.1 now documents the per-scale ratios side-by-side with the historical baseline and the rejected no-multapse experiment.
CorticalColumn per-connection Gaussian delay distribution (2026-04-18)¶
network/cortical_column.pyadds per-connection delay binning. New constantsDELAY_E_SIGMA = 0.75 ms,DELAY_I_SIGMA = 0.4 ms(Potjans Table 5). New__init__parametersdelay_distribution: bool = Trueandn_delay_bins: int = 5. At construction time each (target, source) pair samplesK_per_target * n_tper-connection delays fromN(DELAY_*, sigma_*), quantile-bins them into 5 groups and stores one sub-CSR per bin. Perstep(), each pair contributes onedot()per bin, reading the source spike vector at that bin's delay offset.- Setting
delay_distribution=Falserestores the legacy single-mean-delay path for fast smoke tests and direct comparison. - Fidelity dramatically tightened. Measured at
scale=0.1, seed=42, 200 ms analysis window after 100 ms burn-in:
| Population | single-delay ratio | per-conn Gaussian ratio |
|---|---|---|
| L23e | 5.29× | 0.67× |
| L23i | 4.78× | 1.19× |
| L4e | 0.83× | 0.68× |
| L4i | 2.03× | 1.21× |
| L5e | 3.05× | 1.97× |
| L5i | 2.10× | 1.50× |
| L6e | 5.23× | 2.81× |
| L6i | 2.33× | 1.24× |
5/8 populations now sit within 1.2× of Potjans Table 4; the remaining 3 (L4e, L5e, L6e) within 2-3×.
- Cost: per-step ≈ 5× slower (5 sparse mat-vecs per pair instead of 1). At scale=0.1, sim wall went 32 s → ~290 s for 600 ms (matches 5× expectation).
- New tests/test_cortical_column.py::TestPublishedFidelity::test_per_connection_delays_tighten_rates — asserts ≥ 5/8 populations within [0.5, 1.5]× of published Table 4 values. Pins the win.
- benchmarks/bench_cortical_column.py now bench BOTH delay_distribution modes side-by-side.
- All 29 cortical_column tests pass with the new default (29 passed in 14:18 with delay distribution, 24 deselected-fidelity tests in 4:39 for fast iteration via -k 'not Fidelity').
PINGCircuit Rust acceleration backend (2026-04-18)¶
- New Rust per-step kernel
engine/src/ping.rswith PyO3 wrappersc_neurocore_engine.py_ping_step. Mirrors the Python step semantics (LIF + AMPA / GABA decays + drive + Wiener noise + refractory + spike detect + reset). Noise samples are drawn on the Python side and passed in asxi_e/xi_iso the per-instance RNG state evolves identically across both backends. - New
backend=parameter onPINGCircuit("auto" | "rust" | "python", default"auto")."rust"raisesRuntimeErrorif the kernel is not built;"auto"falls back to NumPy. - Bridge wrapper
bridge/sc_neurocore_engine/__init__.pyre-exportspy_ping_stepso pytest'sbridge/-on-sys.pathsetup sees the Rust symbol. - New
tests/test_gamma_oscillation.py::TestPythonRustParity(6 cases): per-population firing rates within 10 % across (80, 20) / (400, 100) / (1000, 250); dominant FFT peak within 1.5 Hz; explicitbackend="rust"smoke; invalid-backend rejection. Per-cell membrane V values drift at the float-noise level (NumPy SIMD/FMA vs Rust scalar ordering) — documented inline; aggregate dynamics match. benchmarks/bench_gamma_oscillation.pyextended to bench BOTH backends. Measured speedup: ~3.3-4.3× across the three workload sizes (per-step 145.8 → 33.7 µs at (80, 20); 588.3 → 178.3 µs at (4000, 1000)). All 6 runs stay in the published 30-80 Hz dominant band.engine/src/ping.rsships 3 Rust unit tests (no-drive silence; supra-threshold drive + refractory hold; deterministic for identical inputs). All pass oncargo test --release.
CorticalColumn no-multapse experiment — REJECTED (2026-04-18)¶
- Tried replacing the multapse-with-replacement adjacency builder with a vectorised
argpartitionno-multapse sampler (matching NESTmultapses=Falsedefault). Mean per-target weight is identical between the two approaches and per-target unique connectivity rises from ~63 % to 100 %. - Measured at
scale=0.1, seed=42, 600 ms: rates BLEW UP to refractory ceiling for 6 of 8 populations (L23e 90 Hz, L4e/L4i ≈ 410 Hz, L5e/L5i/L6i 260-390 Hz). Pre-experiment multapse-with-replacement gave rates 1.6-7.5× over Potjans Table 4 (within band, just inflated). Post-experiment no-multapse made the divergence ~10× worse. - Honest finding: at sub-full scale the deterministic per-target in-degree of the no-multapse path amplifies population synchrony in the heavy-recurrent regime (K approaches N_s for several pairs); the multapse path's natural variance dampens this. Documented inline next to the multapse sampler so future contributors don't repeat the experiment without first re-reading van Albada 2015 §3.
PINGCircuit scale-invariant weight normalisation (2026-04-18)¶
network/gamma_oscillation.py: per-spike conductance contributions are now divided by source population size at construction (_w_*_eff = w_* · default_size / actual_size). The default(80, 20)published weights stay bit-identical; larger circuits no longer drift out of the 30-80 Hz band.bench_gamma_oscillation.pynow reports 40.0 / 41.2 / 41.2 Hz across(80,20) / (400,100) / (4000,1000)— all in band — vs 40.0 / 103.8 / 76.2 before the fix. All 19 PINGCircuit tests still pass (default weights and behaviour unchanged at(80, 20)).
Honest benchmark scripts for network/ models (2026-04-18)¶
benchmarks/bench_cortical_column.py: 3-config wall-clock + per-population firing rates + Potjans Table 4 ratios forCorticalColumn. Replaces hand-measured numbers indocs/api/cortical_column.mdwith reproducible JSON output atbenchmarks/results/bench_cortical_column.json. Honest BLOCKED status reported per backend (Rust/Julia/Go/Mojo) perfeedback_no_fabricated_benchmarksandfeedback_module_standard_attnres.benchmarks/bench_gamma_oscillation.py: 3-workloadstep()wall-clock + dominant gamma frequency check (must lie in 30-80 Hz) forPINGCircuit. JSON output atbenchmarks/results/bench_gamma_oscillation.json. Documents the per-cell LIF + 4 conductance decays as a clean Rust + Mojo target (BLOCKED, tracked under multilang policy). Bench surfaces a real fidelity edge case atn_e=400, n_i=100(f_dom=103.8 Hz, outside published 30-80 Hz band) that the default-configuration test does not catch.docs/api/cortical_column.mdperformance table updated to reference the bench script and JSON path; numbers replaced with the measured values (build 0.04 / 2.04 / 4.07 s and per-step 0.96 / 2.07 / 5.29 ms across the three configurations).
Bandit MEDIUM triage (2026-04-18)¶
- 6 MEDIUM
B307findings (use ofeval) → ACCEPT with# nosec B307markers and inline rationale:equation_builder.pyEuler integrator, RK4 derivative eval, threshold expression and reset rule (4 sites);studio/analysis.pynullcline grid eval (2 sites). All sites are downstream ofEquationNeuron._validate_exprAST whitelist (_ALLOWED_AST_NODES+_BLOCKED_NAMESreject any escape vector beforecompile) with empty-__builtins__eval globals. - Re-running
bandit -r src/ -llreturns 0 findings. - 55 LOW findings remain (B101 asserts, B603/B404/B607 subprocess, B110 try/pass, B311 random); informational, no real impact, full inventory in
docs/internal/audit_bandit_2026-04-18.mdanddocs/internal/AUDIT_INDEX.md.
CorticalColumn Potjans & Diesmann 2014 (2026-04-18)¶
network/cortical_column.pyrewritten from 5-population canonical-microcircuit reduction to the full 8-population Potjans & Diesmann 2014 model: L23e, L23i, L4e, L4i, L5e, L5i, L6e, L6i with per-population sizes from Table 5, the verbatim 8×8 connection-probability matrix from Table 5, per-cell background Poisson drive (K_bgper population,bg_rate=8 Hz), and exponentially decaying current-based PSCs (tau_syn=0.5 ms).- LIF integration:
C_m=250 pF,tau_m=10 ms,t_ref=2 ms,E_L=V_reset=-65 mV,V_th=-50 mV. Per-source delays:1.5 ms(E),0.8 ms(I), quantised todt. - Synaptic weights:
w_e=87.81 pA,w_i=-g·w_ewithg=4(configurable),w_l4_to_l23e=2·w_eper Potjans boost. - Sparse
scipy.sparse.csr_matrixadjacency per (target, source) pair with multapses sampled with replacement; full-scale in-degree preservation underscale_correction=True(van Albada et al. 2015 protocol). simulate(duration_ms, dt),step(dt),population_rates(rasters, dt, burn_in_ms),total_indegree(target)andreset_state()helpers.tests/test_cortical_column.pyrewritten: 29 tests covering smoke, determinism (per-instance RNG, global-seed leak-proofing), connectivity (Table 5 entries, K_bg, weight signs, L4e→L2/3e boost, sparse adjacency built per pair), and published fidelity (no silent populations, no refractory-ceiling saturation, E/I asymmetry, L4e in band, zero-background silence). 100 % coverage oncortical_column.py. Closes #10.docs/api/cortical_column.mdrewritten end-to-end (308 lines): published-reference summary, implementation overview (8 populations, sparse adjacency build, LIF + synapse + refractory, delay handling), public API reference, verification table vs Potjans Table 4 (L4e match within 1 %, other populations within 2-4×), performance table (4.6 s / 19.5 s / 43.6 s wall at scale 0.02 / 0.05 / 0.1) and reference list (Potjans 2014, van Albada 2015, Binzegger 2004, Hahne 2017, Douglas & Martin 2004).
PINGCircuit conductance-based gamma (2026-04-18)¶
network/gamma_oscillation.pyrewritten from a rate-coded reduced model to per-cell conductance-based Börgers-Kopell 2003 weak-PING. HH-style integrate-and-fire with separate AMPA / GABA exponentially decaying conductances, refractory window, per-cell drive jitter and stochastic kicks. Default parameters reproduce the published 30-80 Hz gamma peak (verified at 40 Hz at the default operating point).population_rate(spike_log, dt, bin_ms)anddominant_frequency(spike_log, dt, bin_ms, f_min, f_max)helpers added; FFT-based with empty-log + out-of-band silence handling.tests/test_gamma_oscillation.pyupdated to the new API: 19 tests covering smoke, determinism (per-instance RNG isolation, global-seed leak-proofing), published fidelity (30-80 Hz peak, gain-loop disengage paths, Hz units, silence handling). 100 % coverage ongamma_oscillation.py. Closes #11.- Replaced
np.sum(boolarray)withnp.count_nonzero(boolarray)in both implementation and tests to be reload-safe under coverage instrumentation (the_NoValuesentinel mismatch otherwise raisedTypeErrorfrom_methods.py).
Repository hygiene (2026-04-18)¶
- SPDX header format converted from 1-line piped to 2-line form across 2728 source files (.py / .jl / .rs / .go / .mojo). Closes #60.
microtubule_neuron.vEngineer attribution:Arcane Sapience.cargo clippy --release --lib: 20 in-source warnings → 0.- Bandit HIGH severity in
nas/sc_nas_engine.py:169→ 0 (hashlib.md5(..., usedforsecurity=False)). - Chiplet package coverage 95 % → 100 % (
test_hierarchical_partitioner_perf.py,test_chiplet_gen_edge_cases.py). tools/run_full_cov.sh: batched per-directory--cov-appendrunner. First full sweep completes at 43.81 % cumulative coverage; no OOM. Closes #58..gitignore:.agent_metadata.json.ruff,rustfmt: clean across all touched files.
Chiplet Partitioner — Multi-Language KL Refine (2026-04-18)¶
- Perf:
HierarchicalPartitioner.partitionV=200 went from 963 ms (pre-#65) → 12.7 ms (Python post-fix) → 0.04 ms (Mojo). Total wall-clock improvement at V=200: 24,000× across the chain. - #65 fix:
CorrelationAwareGraphnow caches(min, max) → edgelookup → O(1);_spectral_bisecthoistsset(vertices)out of the inner loop. 22-29× speedup at V=50/100/200. - #64-prep refine fix:
_per_partition_cost(v, n_parts, ...)returns the full length-P cost vector in ONE neighbour scan (was P redundant scans). Additional 2-9× over #65; bit-identical canonical output. - #74 multi-language KL refine: Rust (
engine/src/partition.rs), Julia (accel/julia/chiplet/kl_refine.jl), Go (accel/go/partition/partition.go), Mojo (accel/mojo/partition/partition.mojo) all wired intoHierarchicalPartitioner(refine_backend=...). Bit-exactpart_mapparity verified end-to-end via dispatcher tests on V=100. Empirical fastest-pick at V=1000: Mojo 0.20 ms (351×), Julia 0.26 ms (270×), Rust 0.29 ms (242×), Go 0.68 ms (103×), Python 70 ms. - Bench harness:
benchmarks/bench_kl_refine.pyruns 5 backends with parity check; results inbenchmarks/results/bench_kl_refine.json. - Tests: 218 chiplet tests (39 new this batch); coverage 99.58 % on the chiplet package, with
chiplet_gen.pyat 100 % andhierarchical_partitioner.pyat 99 %.
LGSSM Multi-Language Acceleration (2026-04-17)¶
- Mojo LGSSM Kalman filter (
accel/mojo/world_model/lgssm.mojo): hand-rolled matmul + Cholesky + triangular solve viamojo build --emit shared-lib. 46× over Python, 8× over Rust at T=200 d=4 p=3 workload. Closes #69. - Go LGSSM (
accel/go/lgssm/lgssm.go): cgo + ctypes shared lib, hand-rolled Cholesky. Closes #70. - Julia LGSSM (
accel/julia/world_model/predictive_model.jl): juliacall + LinearAlgebra LAPACK. Closes #68. - Rust LGSSM (
engine/src/lgssm.rs): PyO3 + ndarray Cholesky. Closes #67. - All 4 backends dispatched via
KalmanFilter.filter(backend='auto'|'rust'|'julia'|'go'|'mojo'|'python'); bit-exact parity vs Python at atol≤1e-9 on means/covs, ≤1e-7 on log-likelihood. - Mojo 0.26 FFI pattern proven: raw
Intaddress viaarr.ctypes.data+UnsafePointer[T, MutAnyOrigin](unsafe_from_address=addr)reconstruction inside the@exportbody works around the parametric-signature restriction. Same pattern reused for fault_injection + KL refine.
Fault Injection Multi-Language (2026-04-17)¶
- Rust + Julia + Go + Mojo kernels for the 5 fault models (
bitflip,stuck_at_0/1,dropout,gaussian). Mojo wins 4/5 boolean kernels (2.7-8.2× over NumPy); Julia wins Gaussian via Ziggurat randn. Bench harness with 4σ Binomial parity atbenchmarks/bench_kl_refine.py-style 5-backend layout.
Bench Harness Honest Exemptions (2026-04-17)¶
bench_safety_monitor.py+bench_chiplet.pynow emit abackendsblock in the JSON output documenting USED / EXEMPT / BLOCKED-ON-#X status per backend per op, with explicit FFI-vs-compute math instead of silent skipping.
Cross-Module Integration — (2026-04-16)¶
- Shared Core Types
core/types.py: unifiedHardwareBudget,ResourceReport,LayerSpec,estimate_network()— single source of truth for Optimizer↔NAS↔Runtime - Closed-Loop Adaptive Controller
control/adaptive_loop.py: Runtime drift detection → SA re-optimisation → newRuntimeConfig, configurable cooldown/threshold - Unified Energy Reporter
energy_accounting/unified_reporter.py: bridgesCarbonModel+ThermalModel+ ASIC power into singleanalyze()call - End-to-End Export Pipeline
export/pipeline.py: Model Zoo → ONNX → TVM Relay → MLIR/SSA → SystemVerilog in onerun()call - Rust Wiring:
sc_optimizer.py→optimizer.rsSA engine,sc_nas_engine.py→evo.rstournament selection,photonic_emitter.py→photonic.rscrosstalk analysis - Package Exports: Updated
core/__init__.py,control/__init__.py,export/__init__.pywith new module exports - Integration Tests: 20 new tests in
tests/test_integration/test_cross_module.pycovering all 5 actions - Maturin: Rebuilt
sc_neurocore_enginev3.14.0 with all Rust bindings - Total: 10,592 tests (8,895 Python + 1,697 Rust) — ALL GREEN
Extended Rust Wiring — QA & DNA Bridges (2026-04-17; timing superseded)¶
- Quantum Annealing:
bridges/quantum_annealing.py→py_qa_simulated_annealing. The historical speed figures recorded here were not promotion-grade evidence and are superseded by the 2026-07-12 source-bound rerun requirement; do not quote them. IsingModel.energy()→py_qa_ising_energy(Rust path for n>20 qubits)SimulatedAnnealer.solve_ising()→py_qa_simulated_annealing(native path retained; speed must be remeasured on the target release host)EnergyLandscape.analyze()→py_qa_batch_ising_energy(batch energy for >100 samples)- DNA Mapper:
bridges/dna_mapper.py— Rust engine loaded (_HAS_RUST_DNA) - Imported:
py_dna_design_sequence,py_dna_detect_hairpins,py_dna_check_cross_hybridization,py_dna_simulate_kinetics,py_dna_design_orthogonal_set - Photonic: Fixed
py_ph_analyze_crosstalkAPI (channel_ids, wavelengths, bandwidths, powers)
Python vs Rust Benchmarks — Integration Hot Paths (2026-04-16)¶
- SA Optimizer: 7× (5 layers) → 36× (20 layers) → 47× (50 layers)
- Tournament Selection: 337–394× (amortised per-round overhead elimination)
- Batch Mutate: 17–21× across population sizes 50–1000
- Population Diversity: 34–90× (O(N²) SIMD pairwise distance)
- Historical aggregate: the former mean included superseded QA timings and must not be treated as a current cross-path claim
- QA timing: superseded; rerun
bench_quantum_annealing_rust_vs_python.pyon the target release host before making a native speed claim - E2E Pipeline: NAS→Optimizer→Energy→Verilog in 13.7ms (small) to 116ms (large)
- Criterion (Rust-native): spike_times=83ns, firing_rate=13ns, ISI=96ns, van_rossum=1.2µs (N=100)
- Results:
benchmarks/results/py_vs_rust_integration.json - Script:
benchmarks/py_vs_rust_benchmark.py
Cross-Language Acceleration — Spike Stats (2026-04-16)¶
- Crate
spike_stats_core(v0.1.0): 16 functions, 28 Rust tests, PyO3 + Criterion - Distance (7 fns):
victor_purpura_distance181×,spike_sync31×,hunter_milton27×,van_rossum,spike_distance,earth_movers_distance,multi_neuron_victor_purpura160× - Correlation (5 fns):
cross_correlation,event_synchronization,spike_time_tiling_coefficient,coincidence_index - Variability (4 fns):
approximate_entropy73×,sample_entropy78×,lempel_ziv_complexity69×,permutation_entropy65× - 99/99 Python tests pass on both Rust and Python fallback paths
- Python dispatch wired in:
distance.py,correlation.py,variability.py
Cross-Language Acceleration — Stochastic Doctor (2026-04-16)¶
- PyO3 bindings for
stochastic_doctor_corecrate:py_scc_bytes,py_scc_batch,py_precision_bytes,py_histogram,PyDriftDetector - Replaced legacy
ctypes.CDLLwith PyO3 import pattern (primary), Python fallback (secondary) SC_NEUROCORE_NO_RUST=1env var forces Python path- 16/16 Python tests pass on both Rust and Python paths
- 23 Rust tests pass
- Benchmarks (SCC single-pair): 35× at N=100, 3.5× at N=1M
- Benchmarks (batch SCC N×N): 15–18× for 4–64 neuron layers
- Benchmarks (precision): 5–14× across all sizes
- Criterion benchmarks:
crates/stochastic_doctor_core/benches/doctor_bench.rs - Python benchmark:
benchmarks/stochastic_doctor_benchmark.py - Results:
benchmarks/results/stochastic_doctor_py_vs_rust.json - API docs updated with full benchmark tables:
docs/api/stochastic_doctor.md
Module Integration — 19 Industrialized Modules (2026-04-16)¶
- Industrial tier: safety_cert (IEC 61508/ISO 26262, 81 tests), asic_flow (multi-PDK, 67 tests), fault_injection (radiation-grade, 22 tests), uvm_gen (UVM testbench, 71 tests)
- Exascale tier: hypervisor (multi-tenant, 78 tests), digital_twin/twinsync (time-warp sync, 72 tests)
- Substrates tier: spintronic (MTJ mapper, 66 tests), chiplet (UCIe/BoW, 94 tests), memristor (crossbar, 70 tests), analog_bridge (SC-to-analog, 27 tests)
- Frontiers tier: evo_substrate (self-replicating evolution, 91 tests), meta_plasticity (self-modifying rules, 72 tests), bioware (organoid interface, 79 tests), federated (DP-SGD, 93 tests), bci_studio (closed-loop BCI, 32 tests)
- Unification tier: explainability (causal attribution, 71 tests), neuro_symbolic (predictive coding, 34 tests), stochastic_doctor (bitstream diagnostics, 16 tests), model_zoo (auto-Verilog, 37 tests)
- All modules: SPDX dual-license headers,
__tier__classification,__init__.pywith docstrings - 19 MkDocs API doc pages with
mkdocstringsdirectives - Updated
mkdocs.ymlnav with 5 new categories (Industrial, Substrates, Exascale, Frontiers, Unification) - Integration reference:
docs/MODULE_INTEGRATION.md - Total: 1,173 new Python tests from integrated modules
Rust Workspace — 5 Research Crates Integrated (2026-04-16)¶
- Created
crates/directory for research Rust crates - Integrated: tinysc_riscv (83 tests), core_engine (22 tests), autonomous_learning (12 tests), neuro_symbolic (28 tests), stochastic_doctor_core (23 tests)
- Root
Cargo.tomlworkspace now has 6 members (engine + 5 research crates) - Engine (
sc_neurocore_engine, 1,549 tests) verified undamaged after workspace expansion - Total: 1,717 Rust tests across 6 crates
Evolutionary Substrate — (2026-04-16)¶
FormalSafetyGuard: pre-deployment safety validationCPPNGenome: Compositional Pattern Producing Network developmental encodingIslandModel: multi-deme evolution with migrationNoveltyArchive: k-NN behavioural novelty searchHWFitnessCollector: FPGA execution feedback for hardware-in-loop fitnessParetoFront: NSGA-II style non-dominated sortingTournamentSelector,AgeRegulator,BloatPenalizer,ExtinctionDetector,CoevolutionArenaEvoStatisticsTracker,ComplexityTracker,genome_diff(),shared_fitness()- Module grew from 657 to 1,400 LOC, 42 to 91 tests
Foundation-Model Neural Decoders (2026-04-07)¶
- POYODecoder: spike tokenisation + cross-attention (Azabou et al. 2023 NeurIPS)
- POSSMDecoder: diagonal SSM with HiPPO-LegS init (Ryoo et al. 2025 ICLR)
- NDT3Decoder: causal masked self-attention on binned spikes (Ye & Pandarinath 2025)
- CEBRAEncoder: InfoNCE contrastive embedding with analytical backprop (Schneider et al. 2023 Nature)
- Rust acceleration: tokenise_spikes, sinusoidal_position_encode, scaled_dot_product_attention, gaussian_attention, ssm_step_diagonal, infonce_loss (6 pub fn, 11 tests)
- PyO3: 5 functions registered
- Tests: 47 multi-angle tests
- Documentation: 976 lines, 8/8 sections
Transcriptomic Foundation Model Interfaces (2026-04-07)¶
- ScKGBERTInterface: dual S-Encoder + K-Encoder with Gaussian attention (Li et al. 2025 Genome Biology)
- GeneformerInterface: rank-value tokenisation + multi-head attention + MLM (Theodoris et al. 2023 Nature)
- rank_value_encode: shared utility for gene expression tokenisation
- Tests: 29 multi-angle tests
- Documentation: 1,118 lines, 8/8 sections
Gap Model Python + PyO3 + Docs (11 models, 2026-04-07)¶
- 10 new Python implementations (publication-exact): AdaptiveThresholdMoENeuron, HybridLinearAttentionNeuron, QuantumInspiredLIFNeuron, DendriticNMDANeuron, MulticompartmentMCNNeuron, AstrocyteLIFNeuron, DirectionSelectiveRGC, CochlearHairCell, ShortTermPlasticitySynapse, DopamineStdpSynapse
- PyO3 wiring: 11 models registered (2 macro + 9 manual wrappers)
- Tests: 87 multi-angle tests
- 10 docs (5,701 lines total)
- GPU backend documentation (607 lines)
CI & Dependency Fixes (2026-04-07)¶
- PEP 639: migrated
license = { text = "..." }→license = "AGPL-3.0-or-later"(fixes setuptools ≥78) - mypy: 1.19.1 → 1.20.0
- cyclonedx-bom: 7.2.2 → 7.3.0
- ci.yml: pinned all mypy stub dependencies to exact versions (CodeQL #287)
- cargo fmt: applied to all new Rust code
- Purged 52 resolved failed/cancelled CI runs
- Closed superseded dependabot PRs #53, #55
Neuron Models — (12 new models, 2026-04-04/05)¶
- TUMNetwork: rate model with short-term plasticity (depression + facilitation), 3 ODEs
- ElBoustaniNetwork: E/I + NMDA bistability, 3 ODEs
- GradedSynapseNeuron: non-spiking, passive RC + sigmoid release
- GapJunctionNeuron: LIF + electrical synapse with Cx36 rectification
- FrankenhaeUserHuxleyAxon: GHK permeability-based currents (not linear V-E)
- NodeOfRanvier: MRG 2002 — Nav1.6 transient + persistent + Kv7 slow K
- MyelinatedAxon: MRG node + passive internode cable
- CardiacPurkinjeFibre: DiFrancesco-Noble 1985, 6 currents
- SmoothMuscleCell: CaL + BK + IP3R/SERCA + Ca²⁺ store
- EndocrineBetaCell: CaL + K_dr + K_ATP + K_Ca glucose-dependent bursting
Fidelity Audit Fixes (7 models corrected, 2026-04-04)¶
- RetinalGanglionCell: basic LIF → Pillow 2005 GLM (stimulus + history filters)
- InnerHairCell: no vesicle pool → Meddis 1986/2006 (q/c/w compartments)
- OuterHairCell: unidirectional sigmoid → bidirectional asymmetric prestin (Santos-Sacchi 2006)
- GranuleCell: LIF-style → D'Angelo 2001 full HH (7 ionic currents)
- AlphaMotorNeuron: PIC no inactivation → h_pic + Ca²⁺ buffering
- RodPhotoreceptor: no Ca²⁺ feedback → Ca²⁺-GC feedback (Nikonov 2006, Hill n=4)
- TraubMilesNeuron: missing M-current → Kv7/KCNQ (Yamada 1989)
Kinetics Audit Fixes (3 models upgraded, 2026-04-05)¶
- GolgiCell (CRITICAL): 5-current WB → full Solinas 2007 (11 currents, 13 gating variables)
- DCNNeuron (MODERATE): added persistent Na (INaP) + Ca²⁺-dependent AHP (7 currents total)
- OlfactoryReceptorNeuron (MODERATE): added PDE4 negative feedback on cAMP
Infrastructure (2026-04-05)¶
supported_models(): 28 missing entries added (159 total)- Interface wrappers: 20 non-standard models wired via Wr* types (multi-input, i32-input, graded/rate)
- All 4 failing CI workflows fixed (clippy, ruff, MkDocs, typos)
cargo fmtapplied to all engine source- Fresh Criterion benchmarks published (2026-04-05)
- Documentation audit: all stale numbers corrected across README, pricing, index, benchmarks
Notebooks (13 new, 21 total)¶
- 08_equation_to_verilog: ODE string → Python sim → Q8.8 Verilog (LIF, FHN, Izhikevich)
- 09_topology_and_dynamics: 6 generators, adjacency matrices, degree distributions, raster plots
- 10_spike_train_analysis: ISI, CV, Fano, cross-correlation, van Rossum, PCA
- 11_biological_circuits: tripartite synapse Ca²⁺ dynamics, Rall dendrite nonlinearity
- 12_learning_rules: STDP, e-prop eligibility, R-STDP, STP facilitation/depression
- 13_quantisation_pipeline: float → Q8.8 → SC probabilities → Verilog export, error budget
- 14_sc_arithmetic_theory: AND=multiply, XNOR=bipolar, MUX=add, CORDIV=divide, Sobol vs Bernoulli convergence, Hoeffding bounds
- 15_fault_tolerance: SC vs fixed-point under bit-flips/stuck-at, TMR majority vote
- 16_neuron_atlas: 12 models from 8 families (LIF→ArcaneNeuron, 1907–2026)
- 17_reservoir_computing: liquid state machine, temporal XOR, ridge readout, SVD dimensionality
- 18_mixed_precision_sc: per-layer adaptive L, Hoeffding vs sensitivity allocation, Pareto frontier
- 19_compression_and_pruning: magnitude/SC-aware pruning, quantisation sweep, combined Pareto
- 20_power_analysis: event-driven vs clock-driven toggle count, scaling with network size
- 21_spike_alu: Turing-complete spike-based ALU — logic gates, SR latch register, ripple-carry adder, sort
- 22_ir_type_safety: IR signal type checker — Bitstream/Rate/Spike/Fixed, catch mismatches before Verilog synthesis
- 23_topological_observables: winding number, Ollivier-Ricci curvature, sheaf consistency defect, connection curvature
- 24_identity_lazarus: Lazarus checkpoint save/load/merge, TraceEncoder text→spikes, StateDecoder attractor extraction, DirectorController L16 self-regulation
- 25_cortical_column_dynamics: canonical 5-population microcircuit, thalamic drive, layer-resolved rasters, feedforward latency
- 26_spike_codec_benchmark: 5 codecs (ISI/AER/predictive/delta/streaming) on synthetic data, compression ratio vs density curves
- 27_python_to_proven_silicon: complete end-to-end pipeline — ODE string → Python sim → IR type check → Q8.8 Verilog → testbench → formal properties → resource estimate
- 28_domain_bridge: TensorStream prob↔bitstream↔quantum conversions, QuantumStochasticLayer cos²(θ/2) non-linearity, Born rule roundtrip
Tests (19 new files, ~3700 lines, ~310 test methods)¶
test_topology_generators.py: 6 generators — CSR validity, degree, symmetry, edge count, determinismtest_cordiv_division.py: CORDIV accuracy, monotonicity, convergence, adaptive_length Hoeffding boundstest_fault_injection.py: bit-flip degradation, stuck-at analytical bounds, TMR, SC vs fixed-point comparisontest_learning_advanced.py: EligibilityTrace decay, BPTT/TBPTT loss, R-STDP reward gating, STP facilitation/depression/recoverytest_quantisation_pipeline.py: Q8.8 roundtrip, dequantise fidelity, SC probability ordering, dot product end-to-endtest_network_monitors_stimulus.py: SpikeMonitor record/count/trains, StateMonitor accumulation, RateMonitor bins, TimedArray clamp, StepCurrent onset/offset, PoissonInput rate/seed/weighttest_neuron_families.py: parametrised test across 11 EquationNeuron models — step(), spike detection, reset, state finiteness, determinismtest_sc_convergence.py: AND O(1/√L), Sobol faster than Bernoulli, CORDIV monotonic, correlation violation, popcount exacttest_spike_alu.py: SpikeGate truth tables (AND/OR/NOT/NAND/XOR), De Morgan law, SpikeRegister roundtrip, SpikeALU add/sub/xor/compare/shift, spike_sort correctnesstest_topological_observables.py: winding number wraps, Ricci curvature complete>ring, sheaf defect zero when synchronised, connection curvature bounded by couplingtest_scpn_integrated.py: K_nm symmetric zero-diagonal, OMEGA_N physical frequencies, create_full_stack 16 layers, run_integrated_step finite, get_global_metricstest_identity_lazarus.py: IdentitySubstrate run/step/health, TraceEncoder encode/determinism, Checkpoint save/load/merge roundtrip, StateDecoder patterns/attractors, DirectorController monitor/diagnose/correcttest_cortical_column_dynamics.py: CorticalColumn step/run dict outputs, 5 populations, binary spikes, thalamic drive, L4-before-L5, inhibition, reset, determinismtest_codec_roundtrip.py: all 5 codecs parametrised — lossless roundtrip (sparse/empty/single-spike/all-ones), compression ratio bounds, shape preserved, edge cases (1 channel, 1 timestep)test_tensor_stream.py: TensorStream prob↔bitstream↔quantum roundtrips, Born rule, normalisation, p=0/1 edge cases, invalid conversion raisestest_quantum_hybrid.py: QuantumStochasticLayer cos²(θ/2) transfer, p=0→1, p=1→0, monotonic decreasing, multi-qubit independence
Model Validation¶
- LIF f-I curve: 29/29 tests, <5% error vs analytical solution
- Izhikevich 20 firing patterns: all from Izhikevich (2003) Table 1 validated
- Hodgkin-Huxley 1952: AP peak 40.6mV, spike width 1.46ms, AHP -75.1mV
- NeuroBench SHD: 79.28% test accuracy (250K params, feedforward)
- Brian2 parity: exact LIF match (0.000ms timing diff), 7.3x speedup
- 5 validation docs with measured data in
docs/validation/
Stochastic Computing Pipeline¶
- Bipolar SC (XNOR):
core/bipolar.pyfor signed weight multiplication - SC bitstream MNIST: 10% (unipolar) -> 35.6% (bipolar) -> 50.0% (all fixes)
- SC-aware training:
SCAwareLIFNetwith bitstream noise injection (+9.5pp)
Quantization-Aware Training¶
QuantizedLIFNet: 2/4/8/16-bit STE weight quantization (PyTorch)SCAwareLIFNet: SC noise injection during trainingSCAwareLinear: drop-in layer replacement
Encoding Comparison¶
- 7 temporal spike encodings benchmarked on MNIST
- Latency encoding Pareto-optimal: 88.1% at 142 spikes (17x fewer than rate)
Interoperability¶
- NeuroML 2 importer: iafCell, Izhikevich (2003/2007), AdEx
- SONATA network format importer: nodes.h5 + edges.h5, connectivity matrix
Reproducibility¶
- 7 Kaggle scripts in
notebooks/*_kaggle.py - JSON artifacts in
benchmarks/results/
[3.14.0] — 2026-03-27¶
Visual SNN Design Studio (Experimental)¶
- New feature: web-based IDE for designing, training, compiling, and deploying SNNs
- 118-model browser with live simulation, parameter sliders, pattern classification
- 20+ analysis views: trace, phase, ISI, f-I, bifurcation, heatmap, sensitivity, STA, frequency response, characterisation, multi-model overlay, A/B comparison
- Compiler Inspector: SC IR build/verify/emit, SystemVerilog generation, co-simulation
- Synthesis Dashboard: Yosys synthesis for 4 FPGA targets (ice40, ECP5, Gowin, Xilinx), multi-target comparison, resource estimation without Yosys
- Training Monitor: live SSE metric streaming, 6 surrogate gradients, per-layer spike rates, learnable beta/threshold
- Network Canvas: React Flow drag-and-drop populations and projections, NIR export/import
- Full pipeline: network graph → validate → simulate → compile → synthesise in one click
- Project save/load: persistent JSON workspaces on server
- E-I balanced network simulation with Rust engine fast path
- 140+ Studio-specific tests
- Documentation: 7 pages on GitHub Pages, 10-step quickstart tutorial
- Launch:
pip install sc-neurocore[studio] && sc-neurocore studio
Rust Engine¶
py_simulate_ei_network(): fused E-I network simulation (CSR + Poisson + Euler) in single Rust callpy_batch_simulate(): batch model simulation with NeuronVariant dispatch loopcreate_neuron()madepubfor reuse across lib.rs- 288 Rust tests passing
Performance¶
- Model list caching: first
/api/modelscall loads 118 models in ~1s, subsequent calls <1ms
Security¶
- 25 CodeQL "information exposure through exception" fixes — no tracebacks in HTTP responses
- 5 CodeQL "uncontrolled data in path expression" fixes — project name sanitisation
- DOMPurify XSS fix via npm override (>=3.3.2)
- Bandit: MD5 usedforsecurity=False, narrowed bare except clauses
CI¶
- Engine wheel publish job added to publish.yml (PyPI OIDC)
- Bridge ImportError restored for pytest.importorskip compatibility
- PnR added to typos dictionary
- tsconfig.tsbuildinfo gitignored
- uvicorn skip guard for studio optional extra
ANN-to-SNN Conversion Engine¶
sc_neurocore.conversion.convert(): automated PyTorch ANN to rate-coded SNN conversion- QCFS activation (Quantization-Clip-Floor-Shift): ReLU replacement for conversion-aware training
- Threshold normalization from calibration data activation statistics
ConvertedSNN.run()and.classify()for inference with Poisson rate coding
Learnable Delay Training¶
DelayLinear: PyTorch module with trainable per-synapse delays via linear interpolation- Differentiable delays: gradients flow through fractional delay positions
- Export to integer delays for hardware deployment via
delays_intandto_nir_delay_array() - DCLS (Dilated Convolutions with Learnable Spacings) principle for fully-connected SNN layers
One-Command FPGA Deploy¶
sc-neurocore deploy model.nir --target artix7: NIR/PyTorch → Verilog → project in one command- Target presets: ice40, ecp5 (Yosys Makefile), artix7, zynq (Vivado project.tcl)
- Copies 19 HDL library modules, generates neuron SystemVerilog, build script, README
Network Engine¶
- Per-synapse delays in Projection:
delay=arrayfor heterogeneous axonal/synaptic delays - Spike-gating:
Population.step_all(spike_gating=True)skips idle neurons, compute proportional to active count - Weight sparsity:
Projection(weight_threshold=0.01)skips near-zero synapses during propagation
Compiler¶
- Per-layer adaptive bitstream length:
assign_lengths()with Hoeffding or sensitivity-based allocation - Mixed-precision SC networks: shallow layers use short L (fast), deep layers use long L (precise)
Event-Driven FPGA RTL¶
sc_aer_encoder.v: spike vector → AER packets via priority encoder, idle neurons consume zero powersc_event_neuron.v: Q8.8 LIF that computes only on input events or periodic leak tickssc_aer_router.v: distributes AER events to target neurons using connectivity lookup table- Total HDL modules: 19 (was 16)
Performance¶
- Lazy-load 109 neuron models: import time 200s → 57s
- Deferred scipy imports (stats.qmc, sparse): import time 57s → 10s
Infrastructure¶
- Coverage fixes: test second model access, pragma Rust-only branch
- Coverage for lazy-load path, sparse guard mock path
- Ruff F401 re-export fixes, format vectorized_layer
[3.13.3] - 2026-03-20¶
SC Arithmetic¶
- CORDIV division circuit: Python
sc_divide()+ Verilogsc_cordiv.v(Li et al. 2014) - Adaptive bitstream length: Hoeffding/Chebyshev/variance bounds via
adaptive_length() - Sobol/Halton multi-dimensional decorrelation for per-synapse independent streams
- Chaotic RNG mode in BitstreamEncoder (logistic map)
- Sobol bitstream attention:
StochasticAttention.forward_bitstream()with LDS variance reduction
Learning Rules¶
- BCM metaplasticity with sliding threshold (Bienenstock-Cooper-Munro 1982)
- Voltage-based STDP (Clopath et al. 2010)
- Truncated BPTT for long sequences (
TBPTTLearner, Williams & Peng 1990) - EWC penalty implemented (was no-op stub) — Kirkpatrick et al. 2017
- Learnable beta/threshold on all 10 SNN cell types (ExpIF, AdEx, Lapicque, Alpha, SecondOrderLIF, IF, Synaptic)
- ConvSpikingNet now works with
train_epoch()viaflatten_input=False
Biological Circuits¶
- Tripartite synapse: astrocyte ↔ synapse bidirectional coupling (Araque et al. 1999)
- Rall branching dendrite: compartmental tree with 3/2 power rule
- Canonical cortical microcircuit: 5-population column (L2/3 exc/inh, L4, L5, L6)
- Astrocyte adapter:
AstrocyteNeuronwraps Li-Rinzel model for Population/Network
Theoretical Depth¶
- SC→quantum circuit compiler: Ry encoding, statevector simulator, layer compilation
- Zero-multiplication predictive coding SC layer (Conjecture C9: XOR=error, popcount=magnitude)
- Topological observables: winding number, Ollivier-Ricci curvature, sheaf defect
- Phi* integrated information estimation (Barrett & Seth 2011, IIT)
- Goldstone mode verification for Knm coupling spectrum
- Fault tolerance benchmark: SC vs fixed-point degradation curves
- Hardware-aware SC layer with memristive defect injection
- Noisy quantum simulation via HeronR2NoiseModel Kraus channels
NIR Bridge¶
- Recurrent edge handling via unit-delay insertion (LSTM-like feedback)
- Multi-port subgraph support (
SCMultiPortSubgraphNode)
Compiler¶
- IR type checker: Bitstream/Rate/Spike mismatch detection before emission
- SV/MLIR emission for GraphForward, SoftmaxAttention, KuramotoStep (was error stub)
- Weight quantizer exported in compiler
__init__.py
Hardware Stack¶
- AXI-Stream interface for bulk bitstream I/O (
sc_axis_interface.v) - DMA controller for weight upload and output readback (
sc_dma_controller.v) - Parameterized AXI-Lite register file (
sc_axil_cfg_param.v) - Clock domain crossing primitives: 2-FF sync, Gray counter, async FIFO (
sc_cdc_primitives.v) - NEON scalar-equivalence tests (13 tests for popcount, dot, max, sum, scale)
Infrastructure¶
- Rust engine wheel publishing in PyPI release workflow
- SpikeInterface/Neo adapter for experimental data import
- Static CycloneDX SBOM (v1.6)
- JAX autodiff fix: straight-through estimator for spike reset
- IIT added to typos allowlist
[3.13.2] - 2026-03-19¶
Equation → Verilog RTL Compiler¶
equation_compiler.py: compile anyEquationNeuronto synthesizable Q8.8 fixed-point Verilogequation_to_fpga(): one-liner from Brian2-style ODE string to Python neuron + Verilog RTL- AST-to-Verilog expression emitter handles +, -, , /, *, unary minus, comparisons
- Multi-variable ODE support (FitzHugh-Nagumo, Izhikevich, Hodgkin-Huxley)
- Threshold and reset logic auto-generated
NIR Bridge¶
nir_bridgepackage: import NIR graphs into SC-NeuroCore (FPGA backend for NIR)- Maps 11 NIR primitives (LIF, IF, LI, Integrator, Affine, Linear, Scale, Threshold, Flatten, Input, Output)
- Recursive graph parser with topological sort, fan-in summation, nested subgraph support
- NIR integration guide, API docs, notebook (05_nir_bridge.ipynb)
Packaging & Release¶
- Restored
sc-neurocoreas the only PyPI product package and removed the unintended runtime dependency on a separatesc-neurocore-enginepublish - Publish automation now pushes only
sc-neurocoreto PyPI while keeping the Rust engine on the existing crate / source / CI wheel paths - Tag pushes still trigger publish directly, so release creation no longer depends on a downstream
release.publishedevent
[3.13.1] - 2026-03-19¶
Packaging & Install¶
- Top-level
sc-neurocorenow requires the matchingsc-neurocore-enginerelease, andsc-neurocore inforeports engine version mismatches explicitly instead of silently mixing versions - Dense-layer example and getting-started/docs packaging guidance now match the current public API and distinguish wheel-shipped modules from source-only modules
NIR Bridge¶
- Nested NIR subgraphs now execute through a dedicated subgraph node wrapper and reset cleanly inside
SCNetwork Flattennow respectsstart_dim/end_dim, and bridge coverage is enforced instead of being omitted- Added regression coverage for nested graphs, fan-in, cycle detection, orphan nodes, flatten edge cases, and file-based import/export
CI & Release¶
- CI now builds and installs the local engine wheel before editable/package installs, so unreleased versions no longer fail dependency resolution
- Build smoke installs both the engine wheel and the top-level wheel from local artifacts
- Publish workflow now runs from tag pushes, builds engine sdist+wheels, publishes the engine package before
sc-neurocore, and keeps manual dispatch build-only unless publish is explicitly enabled - Release workflow now attaches both the pure-Python wheel and sdist to GitHub Releases
Bug Fixes¶
- StochasticTransformerBlock: clamp residual and FFN intermediate values to [0, 1] — MAC output from
VectorizedSCLayercan exceed 1.0, triggering the new input validation - Optional dependency introspection in
sc-neurocore infono longer crashes on broken NumPy/JAX imports
Tests¶
- Full preflight now passes at
2112 passed,38 skipped,12 xfailed, with100.00%coverage - Added audit validation tests for VectorizedSCLayer/EquationNeuron, CLI fallback coverage, dense-layer example smoke coverage, and expanded NIR bridge regressions
Documentation¶
- Replace stale black references with ruff format in
VALIDATION.mdandCONTRIBUTING.md - Sync the packaging/install docs with the released product surface
- Package naming and install guidance were corrected in
3.13.2;3.13.1incorrectly treatedsc-neurocore-engineas a separate PyPI runtime dependency
[3.13.0] - 2026-03-18¶
Python 3.14 Support¶
- CI test matrix, wheel builds, and publish workflow now include Python 3.14
- All 1 776 Python tests pass on 3.14; all dependencies compatible
- pyproject.toml classifier added
Bridge Wiring¶
- 12 missing Rust symbols exported from bridge
__init__.py: NetworkRunner, BitstreamAverager, Izhikevich, ArcaneNeuron, 8 AI-optimized models, ContinuousAttractorNeuron - Parity test name mapping for RustContinuousAttractorNeuron
CI Fixes¶
- Black formatting for identity/ files; pre-commit ruff upgraded v0.9.7 → v0.15.6
- Clippy: PopulationRunner::is_empty() added
- TraceEncoder: deterministic hash (byte-based, not Python hash())
- Synapse test tolerance widened for short bitstream noise
- Notebook trailing newline for end-of-file-fixer
- Removed deleted ruff rule UP038
Documentation¶
- JOSS paper rewrite: pipeline + spike raster figures, Availability section, McCulloch-Pitts/Hodgkin-Huxley citations, tightened to ~1200 words
- All docs synced: test counts (1 776/336), 111 NetworkRunner, 17 HDL, Python 3.14
- Neuron explorer notebook (04_neuron_explorer.ipynb): 5 sections, 117 models
Infrastructure¶
.gitattributes: eol=lf (suppress CRLF warnings on Windows)- Single-directory migration:
03_CODE/sc-neurocore/is canonical repo - PyPI deployment branch policy fixed (main added)
- 12 known Rust/Python parity divergences tracked as xfail
- 5 version-gate assertions updated
[3.12.0] - 2026-03-17¶
ArcaneNeuron + 8 AI-Optimized Models¶
- ArcaneNeuron: unified self-referential cognition model with 5 coupled subsystems (fast/working/deep/gate/predictor)
- 8 novel AI-optimized spiking neuron models: MultiTimescaleNeuron, AttentionGatedNeuron, PredictiveCodingNeuron, SelfReferentialNeuron, CompositionalBindingNeuron, DifferentiableSurrogateNeuron, ContinuousAttractorNeuron, MetaPlasticNeuron
- Total neuron count: 122 Python (113 bio + 9 AI), 111 Rust (including Arcane)
- ArcaneNeuron included in Rust NetworkRunner (111-model fused loop, was 80)
Identity Substrate¶
sc_neurocore.identitypackage: persistent spiking network for identity continuity- IdentitySubstrate: 3-population network (HH cortical + WB inhibitory + HR memory) with STDP
- TraceEncoder: LSH-based reasoning trace to spike pattern encoding
- StateDecoder: PCA + attractor extraction + priming context generation
- Checkpoint: Lazarus protocol save/restore/merge of complete network state (.npz)
- DirectorController: L16 cybernetic closure with monitor/diagnose/correct feedback loop
Network Simulation Engine¶
- Population-Projection-Network architecture with 3 backends: Python (NumPy), Rust (NetworkRunner), MPI (mpi4py)
- 6 topology generators: random, small-world, scale-free, ring, grid, all-to-all
- 12 visualization plots: raster, voltage, ISI, cross-correlogram, PSD, firing rate, phase portrait, population activity, instantaneous rate, spike train comparison, network graph, weight matrix
- 7 advanced plasticity rules: BPTT, e-prop, R-STDP, MAML, homeostatic, STP, structural
- MPI distributed simulation for billion-neuron scale via mpi4py
Rust NetworkRunner¶
- 111-model fused simulation loop with Rayon-parallel population stepping (was 80)
- CSR-sparse projection propagation
- Scales to 100K+ neurons with near-linear speedup
Model Zoo¶
- 10 pre-built network configurations: Brunel balanced, cortical column, CPG, decision-making, working memory, visual cortex V1, auditory processing, MNIST classifier, SHD speech, DVS gesture
- 3 pre-trained weight sets: MNIST (784-128-10), SHD (700-256-20), DVS gesture (256-256-11)
conda-forge¶
- Recipe draft prepared for staged-recipes submission; not yet published on conda-forge
Analysis Toolkit¶
- 126 spike train analysis functions across 23 modules (22 spike_stats + 1 explainability)
- Covers: basic stats, variability, rate estimation, distance metrics, correlation, spectral, temporal, stimulus, LFP coupling, surrogates, information theory, causality, dimensionality, decoding, network, point process, sorting quality, waveform, statistics, patterns, SPADE, GPFA
- Pure NumPy, zero external dependencies
- Tests: 1 776 Python total, 336 Rust total
Neuron Model Library (122 Python / 111 Rust)¶
- 108 individual model files in
neurons/models/(one file per model) - 108 individual model files across 14 families: IF variants, Biophysical, Adaptive, Oscillatory, Bursting, Synaptic, Multi-compartment, Map-based, Stochastic, Population, Hardware, Modern/ML, Rate, Other
- Notable additions: TraubMiles, WilsonHR, Pospischil (5 cortical types), ConnorStevens, WangBuzsaki, PinskyRinzel, Destexhe, HuberBraun, GolombFS, MainenSejnowski
- Historical coverage from McCulloch-Pitts (1943) to Gated LIF (2022)
- 10 PyTorch training cells: LIF, IF, Synaptic, ALIF, RecurrentLIF, ExpIF, AdEx, Lapicque, Alpha, SecondOrderLIF
MNIST 99.49% Accuracy¶
examples/mnist_conv_train.py— ConvSpikingNet with learnable beta/threshold- Architecture: Conv(1->32)->LIF->Pool->Conv(32->64)->LIF->Pool->FC->LIF->FC->LIF
- Techniques: FastSigmoid surrogate, cosine LR schedule, data augmentation, membrane readout
- Trained on RTX 6000, 30 epochs, 25 minutes
- Model checkpoint:
examples/mnist_conv_train/results/conv_spiking_net_best.pt - Reproducibility manifest:
benchmarks/results/mnist_conv_accuracy_reproducibility.json
Intel Lava/Loihi Bridge¶
integrations/lava_bridge.py— SCtoLavaConverter, export_weights_loihi- SCDenseProcess + PySCDenseModel for Lava CPU simulation
- Weight conversion: SC probability [0,1] -> Loihi fixed-point
Rust Engine parity expansion (v3.8/v3.9 carry-forward)¶
- Sobol bitstream (M1): Gray-code Sobol quasi-random encoder in Rust (
sobol.rs) - HomeostaticLIF: adaptive threshold neuron with EMA spike rate tracking
- DendriticNeuron: XOR-nonlinearity compartmental model
- RewardStdpSynapse: eligibility trace + reward-modulated STDP
- Conv2DLayer: im2col + SC multiply-accumulate convolution
- RecurrentLayer: echo state network with state feedback
- LearningLayer: online STDP-integrated dense layer
- FusionLayer: weighted stochastic multiplexing across modalities
- MemristiveLayer: dense layer with stuck-at faults and write noise
- SpikeRecorder: buffered spike recording with firing rate and ISI stats
- ConnectomeGenerator: Watts-Strogatz and Barabási-Albert topology generators
- FaultInjector: bit-flip and stuck-at fault injection on packed bitstreams
- MLIR emitter: CIRCT hw/comb dialect IR emission (
ir/emit_mlir.rs) - Static synapse: completed with excitatory/inhibitory polarity
- Surrogate gradient: added Triangular and PiecewiseLinear variants
- Rust neuron models callable from Python: 111 (of 122 Python total)
SIMD Hardening (v3.8 carry-forward)¶
- Fused
softmax_inplace_f64_dispatchwith SIMD max/sum/scale - Hamming distance dispatch for all backends (AVX2, SVE, RVV)
- SVE/RVV softmax portable fallbacks
- Attention softmax refactored to use fused dispatch
Quantum Backend Stabilisation (v3.9 carry-forward)¶
- IBM Heron r2 noise model: depolarizing, amplitude/phase damping, readout asymmetry
- Parameter-shift gradient rule for variational quantum circuits
- Hybrid quantum-classical VQE pipeline with scipy optimizer
- QEC noise integration with surface code threshold comparison
Holonomic Adapter Ecosystem (v3.9 carry-forward)¶
- L1-L16 adapters registered in ComponentRegistry with
create_adapter()factory - Per-adapter benchmark suite: latency, memory, throughput (with/without JAX JIT)
- Plugin discovery via
importlib.metadataentry points
Type Safety Cleanup (M2)¶
- Removed 235 unnecessary Python type-suppression comments (260 -> 25)
- Remaining 25 are justified: CuPy type aliases, optional imports, private method access
GPU SNN Training with Surrogate Gradients¶
sc_neurocore.training— PyTorch-based differentiable SNN training module- 3 surrogate gradient functions: FastSigmoid (Zenke 2018), SuperSpike (Zenke 2021), ATan (Fang 2021)
LIFCell,RecurrentLIFCell—nn.ModuleLIF neurons with autograd through spikesSpikingNet— multi-layer feedforward SNN with spike-count and membrane readoutto_sc_weights()— export trained float weights to [0,1] range for SC bitstream deployment- 3 loss functions: spike count cross-entropy, membrane cross-entropy, spike rate MSE
train_epoch()/evaluate()— training loops with temporal unrollingexamples/mnist_surrogate/train.py— MNIST benchmark (~95% accuracy, 10 epochs)- 31 tests covering surrogates, modules, and training loops
- Requires
pip install sc-neurocore[training]orsc-neurocore[research]
[3.10.0] - 2026-03-09¶
MNIST-on-FPGA Demo¶
- End-to-end pipeline:
examples/mnist_fpga/demo.py— train (sklearn digits), PCA 64→16, quantise Q8.8, stochastic computing inference, Verilog weight export - Float 94.2%, Q8.8 94.2%, SC 94.0% (L=1024, sign-magnitude encoding)
- Resource estimate: 16→10 config = ~56K LUTs (fits Artix-7 100T)
hdl/sc_dense_matrix_layer.v— per-neuron weight dense layer for classification
Vivado Tooling¶
tools/vivado_impl.tcl— non-project flow: synth → place → route (250 MHz default)tools/vivado_report.py— parse timing/utilization/power reports to JSON
Tutorial¶
docs/tutorials/fpga_in_20_minutes.md— 6-section FPGA deployment tutorial
Paper¶
- JOSS paper updated to submission-ready state (
paper/paper.md) - 12 references with DOIs, MNIST demo results, Brian2 comparison, formal verification
Documentation Overhaul¶
- README: benchmarks section (Rust SIMD, Brian2 comparison, Yosys synthesis)
- README: all 10 HDL modules listed with descriptions
- Zenodo DOI updated to 10.5281/zenodo.18906614
- CITATION.cff, .zenodo.json: DOI, version, author corrections
- CONTRIBUTING.md, VALIDATION.md, getting-started.md: test counts, Python version
- Yosys MODULES list updated (10 modules)
Fixes¶
- Zenodo author list corrected (sole author: Miroslav Šotek)
- DOI badge in README points to latest Zenodo record
[3.9.1] - 2026-03-08¶
Benchmarks¶
- 20-variant Brunel translator suite: comprehensive characterization of SC-NeuroCore against Brian2 across neuron models (LIF, Izhikevich, homeostatic), timing variants, synapse types (STDP, dot product, Sobol bitstream), layer architectures (JAX, recurrent, memristive), and acceleration backends (Numba JIT, PyTorch CUDA GTX 1060, vectorized NumPy)
- V18 Numba JIT: 9.5× speedup over per-neuron Python loop
- V19 PyTorch CUDA: 8.7× speedup on GTX 1060 6GB
- V14 Sobol bitstream: 1.04× Brian2 ratio (closest match)
- 19 translator unit tests (
test_brunel_translator.py) - Fix BENCHMARKS.md CPU: i5-11600K @ 3.9 GHz (AVX-512, DL Boost)
- Fix 3 delta-PSC wiring bugs: v_reset omission, RIdt dilution, Poisson-as-current
- Comprehensive BENCHMARKS.md with 13+ sections and measured numbers
- Rust Criterion: 31 benchmarks captured (AVX-512)
- Brian2 2.10.1 SNN comparison: Brunel balanced network head-to-head
- NeuroBench-aligned metrics: 4 configurations, up to 847 MOP/s
- v2 vs v3 PyO3 speedup: 7.3× on large dense forward (128→64)
- Advanced module benchmarks: quantum hybrid, GNN, S-Former, BCI, DVS, chaos RNG
- Yosys synthesis tooling (
tools/yosys_synth.py,tools/yosys_synth.tcl) - CuPy 14.0.1 installed for GPU VectorizedSCLayer
Paper¶
- Updated JOSS paper with measured Criterion numbers (41.3 Gbit/s pack, 224 Mstep/s LIF)
- Replaced estimated FPGA claim with Yosys tooling reference
[3.9.0] - 2026-03-06¶
SCPN Layers¶
- L8-L16 pure NumPy layers: 9 new layer files completing the full 16-layer SCPN stack (
scpn/layers/l8_phase_field.pythroughl16_director.py) - 16-layer registry:
LAYER_REGISTRYdict,create_full_stack()now returns all 16 layers - Full integrated step:
run_integrated_step()chains L1→L16 with inter-layer coupling
Quantum Error Correction¶
- SurfaceCodeShield: d=3 rotated surface code with X/Z stabilizers, syndrome measurement, lookup-table decoding — corrects arbitrary single-qubit errors
- Extensible to d=5 (encode/decode/syndrome paths support arbitrary odd distance)
Benchmarks¶
- Fixed double-step bug in
benchmarks/snn_comparison.py(neurons were advanced twice per timestep) - Fixed Lava stub notes (requires Loihi 2 hardware)
- Fixed
benchmark_suite.pyoutput path →benchmarks/results/ - SNN comparison results recorded in
docs/benchmarks/BENCHMARKS.md
Formal Verification¶
- LIF neuron:
hdl/formal/sc_lif_neuron.sby+sc_lif_neuron_formal.v— 5 properties (reset, spike-reset, refractory clamp, counter bound, spike reachability) - Bitstream synapse:
hdl/formal/sc_bitstream_synapse.sby+sc_bitstream_synapse_formal.v— 4 properties (AND correctness, zero propagation, full-high, input coverage)
Testing¶
- 6 cross-layer coupling integration tests (
test_scpn_cross_layer.py) - 9 surface code QEC tests (
test_qec_surface.py) - Test count: 945 → 960+
Documentation¶
- JOSS paper: updated test count (960), qualified LUT claim, added Brunel/NeuroBench/LFSR bib entries
[3.8.2] - 2026-03-06¶
Documentation & Adoption¶
- BENCHMARKS.md: Populated with 14 real benchmark entries (i5-11600K, NumPy 1.26.4), Rust engine Criterion numbers, comparison context, reproduction instructions
- JOSS paper draft:
paper/paper.md+paper.bib(6 references) — statement of need, architecture, key features, QA - End-to-end notebook:
notebooks/03_end_to_end_pipeline.ipynb— 7-cell walkthrough (encode→synapse→neuron→VectorizedSCLayer→accuracy analysis)
Testing¶
- 18 Hypothesis property-based tests: Bitstream encoding roundtrip, LFSR determinism, neuron output constraints, layer shape invariants, RNG range/shape, recorder accumulation, encoder binary output
- Test count: 887 → 911 tests passing, 98.41% coverage
Issues Closed¶
[3.8.1] - 2026-03-06¶
Enterprise Hardening¶
- 11 CI workflows: ci, v3-engine, v3-wheels, benchmark, docs, pre-commit, codeql, scorecard, stale, release, publish — all SHA-pinned, concurrency-grouped
- Supply chain: Every GitHub Action SHA-pinned (30+ refs),
pypa/gh-action-pypi-publishpinned, dependabot groups GH Actions PRs - Security: Bandit SAST in CI, dependabot security updates enabled, private vulnerability reporting enabled, CodeQL weekly schedule
- Branch protection: 6 required status checks (lint, test×2, spdx-guard, build, pre-commit)
- Dockerfile: Multi-stage build, Python 3.12, non-root user, OCI labels, healthcheck
- Preflight gate:
tools/preflight.py(black + bandit + spdx-guard + pytest),.githooks/pre-pushhook - Release pipeline:
publish.yml(PyPI OIDC trusted publisher, 12 platform wheels),release.ymlattaches sdist to GitHub Releases - Repo hygiene:
.dockerignore,.editorconfig,.gitattributes,CONTRIBUTORS.md,CODEOWNERS, PR template, issue templates (YAML forms), dependabot commit-message prefixes - Labels: 22 labels with colors (ci, security, breaking-change, hdl, performance, needs-review, pinned, roadmap, stale)
- Settings: Delete-branch-on-merge, wiki/projects disabled, OpenSSF Scorecard badge
Lint Enforcement & Python Version¶
- ruff check enforced in CI: 258 unused/deprecated imports auto-fixed across 138 files
- CI test matrix expanded: Python 3.10, 3.11, 3.12 (dropped 3.9 — EOL, autoray/PennyLane incompatible)
requires-pythonbumped to>=3.10: badge, classifiers, black/ruff target-version updated- bandit added to
[dev]extras: contributors can nowmake lintafterpip install -e ".[dev]" - benchmark.yml permissions tightened:
permissions: {}at top, scoped per-job - SECURITY.md / SUPPORT.md: GitHub Security Advisories link added
- VALIDATION.md refreshed: 1058 tests, 98% gate, ruff/bandit/spdx-guard/codeql/scorecard gates documented
[3.8.0] - 2026-03-05¶
Hardening & Documentation¶
- Coverage gate raised to 98%: De-omitted 6 modules (chaos/rng, analysis/explainability, physics/wolfram_hypergraph, robotics/swarm, learning/neuroevolution, spatial/*) plus bio/neuromodulation. 34 new tests, 1058 total, 98.10% coverage
- NumPy 2.x audit: Zero deprecated calls found — codebase fully compatible
- Full API documentation: 25 new mkdocstrings pages, all 44 subpackages wired into nav. Reorganized into Core / Compiler & Export / Domain Modules / Infrastructure sections
- Stale issue automation:
.github/workflows/stale.yml— weekly sweep, 60+14 day lifecycle, exempt: pinned/security/roadmap - CI coverage gate sync:
ci.ymlandpyproject.tomlboth enforcefail_under = 98
[3.7.0] - 2026-02-11¶
Adaptive Runtime Engine -- HDC/VSA, SCPN Petri Nets, Fault-Tolerant Logic¶
- HDC/VSA kernel:
BitStreamTensorgainsxor,xor_inplace,rotate_right,hamming_distance,bundlemethods for hyper-dimensional computing on 10,000-bit vectors - SIMD fused XOR+popcount: AVX-512 VPOPCNTDQ / AVX2 / portable dispatch for hamming distance hot path
- PyBitStreamTensor: New
#[pyclass]exposing full HDC algebra to Python (13 methods) - HDCVector: High-level Python class with operator overloading (
*=bind,+=bundle,.similarity(),.permute()) - PetriNetEngine: Stochastic Colored Petri Net engine wrapping two
DenseLayerinstances for Places->Transitions->Places firing - Fault-tolerant logic: Boolean logic with stochastic redundancy (1024-bit) survives 40%+ bit-flip rates
- 44 new tests: 15 Rust integration + 20 Python HDC + 9 Python Petri Net
- 2 demos: HDC symbolic query ("Capital of France?"), safety-critical Boolean logic with error sweep
- Comprehensive study:
docs/research/SC_NEUROCORE_V3.7_ADAPTIVE_RUNTIME_ENGINE_STUDY.md
[3.6.0] - 2026-02-10¶
Fused Dense Pipeline + Fast PRNG + Batch Forward¶
- Fused encode+AND+popcount:
forward_fused()eliminates intermediate input bitstream materialization - Fast PRNG switch: xoshiro256++ for dense fast-path input encoding and numpy batch encoding
- Batched dense API:
DenseLayer.forward_batch_numpy()processes N samples in one FFI call - New diagnostics: criterion benches for fused dense, encode+popcount, batch dense, and PRNG throughput
- Version/test/docs update: bumped to 3.6.0 with the fused dense pipeline test suite and migration notes
[3.5.0] - 2026-02-10¶
SIMD Pipeline Acceleration¶
- SIMD fused AND+popcount: AVX-512 VPOPCNTDQ accelerated dense inner loop with AVX2 fallback
- SIMD Bernoulli encode: AVX-512BW/AVX2 threshold compare path for packed Bernoulli generation
- Flat weight storage: Contiguous
[neuron][input][word]packed layout for cache-friendly access - Zero-allocation LIF batch: Pre-allocated numpy outputs for batch LIF APIs
- Criterion benchmarks: Added fused-and-popcount and SIMD Bernoulli diagnostics
[3.4.0] - 2026-02-10¶
SIMD Pack, LIF Optimization, Rayon Guard¶
- SIMD pack vectorization: AVX-512/AVX2/portable fast packing (closes 6x Blueprint target)
- Branchless LIF mask: Eliminates branches in fixed-point sign extension
- batch_lif_run_multi(): Parallel multi-neuron batch execution via rayon
- Rayon work threshold: Avoids thread-pool overhead at small input counts
- Criterion benchmarks: Added pack_fast, pack_dispatch, lif_100k_steps
[3.3.0] - 2026-02-10¶
Fast Bernoulli, Fused AND+Popcount, Zero-Copy Prepacked¶
- bernoulli_packed_fast: 8x less RNG bandwidth via byte-threshold encoding
- Fused AND+popcount: Eliminates intermediate buffer allocation in neuron compute
- forward_prepacked_numpy(): True zero-copy from numpy 2D uint64 arrays
- set_num_threads(): Rayon thread pool configuration for tuning parallelism
- Criterion benchmarks: Added bernoulli_packed_fast benchmark
[3.2.0] - 2026-02-10¶
Benchmark CI, Single-Call Dense Forward, Parallel Encoding¶
- Criterion Benchmarks: Expanded suite with bernoulli encoding comparison and dense forward variants
- Benchmark CI: Automated criterion runs with artifact upload
- DenseLayer.forward_numpy(): Single FFI call with numpy input/output plus parallel encoding
- Parallel batch_encode_numpy: Rayon-parallelized probability encoding
- Repo cleanup: Added local
.gitignorefor generated artifacts
[3.1.0] - 2026-02-10¶
Dense Forward Optimization & PyPI Publishing¶
- Direct Packed Bernoulli:
bernoulli_packed()eliminatesVec<u8>intermediate allocations - Parallel Encoding:
DenseLayer.forward_fast()parallelizes input encoding with per-input RNGs - Pre-packed Forward:
DenseLayer.forward_prepacked()accepts pre-encoded numpy/list inputs and skips encoding - batch_encode_numpy: Returns a 2-D numpy array instead of nested Python lists
- PyPI Publishing: Added automated wheel upload on
v3.*tags via Trusted Publisher workflow - Updated Benchmarks: Added dense
fastandprepackedbenchmark variants
[3.0.0] - 2026-02-10¶
Performance Optimization & Stable Release¶
- NumPy Zero-Copy:
pack_bitstream_numpy(),popcount_numpy(),unpack_bitstream_numpy()— eliminate FFI marshalling overhead - Batch Operations:
batch_lif_run(),batch_lif_run_varying(),batch_encode()— process arrays in single FFI calls - Verilator CI: Co-simulation tests run automatically on Ubuntu runners
- Updated Benchmarks: Formal report showing true kernel performance with zero-copy interop
- Bridge Version Fix:
bridge/pyproject.tomlversion now matches engine
Release Candidate (3.0.0-rc.1)¶
- IR Python Bridge: Full PyO3 bindings for ScGraphBuilder, ScGraph, verify, print, parse, emit_sv
- Co-sim Activation: Verilator compilation + simulation when available; graceful skip preserved
- Wheel CI: Cross-platform wheel builds (Linux/macOS/Windows x Python 3.9-3.12)
- Benchmark Report: Formal v2-vs-v3 performance comparison with Blueprint section 8 targets
- IR Demo: Real end-to-end Python->IR->verification->SystemVerilog demo
HDL Compilation Pipeline (3.0.0-beta.1)¶
- SC IR: Rust-native intermediate representation with 11 op types
- SV Emitter: Compile IR graphs to synthesizable SystemVerilog
- Co-sim: Verilator-based verification against Rust golden model
- CI: Expanded test coverage to include all differentiation, acceleration, integration, and HDL Python tests
Integration & Hardening¶
- SSGF-compatible Kuramoto solver (
step_ssgf,run_ssgf) - Property-based testing with proptest (12 property tests)
- Multi-head attention (
forward_multihead) - SC-mode GNN (
forward_sc) - End-to-end training demo
- Comprehensive rustdoc
Differentiation & Acceleration¶
- Surrogate gradient LIF (FastSigmoid, SuperSpike, ArcTan)
- DifferentiableDenseLayer for backpropagation
- Stochastic attention (rate + SC mode)
- Graph neural network layer
- Kuramoto oscillator solver
- Criterion benchmarks + v2/v3 comparison
Foundation¶
- Rust engine with PyO3 bindings
- Bit-exact LFSR, LIF neuron, dense layer
- SIMD dispatch (AVX-512, AVX2, NEON, portable)
- Python bridge with v2-compatible API
- Equivalence test suite
[2.2.0] - 2026-02-09¶
Added¶
- Module Discoverability: Populated 36 stub
__init__.pyfiles with proper__all__exports and lazy imports. Every package now supportsfrom sc_neurocore.X import Ywithout touching internals. - MkDocs API Documentation: Added
mkdocs.ymlwith mkdocstrings plugin,docs/index.md,docs/getting-started.md,docs/architecture.md, and 17 API reference stubs indocs/api/. - Examples Directory: 6 runnable example scripts demonstrating bitstream
encoding, neuron layers, vectorized inference, SCPN stack, HDL generation,
and ensemble consensus (
examples/01–06). - Module Docstrings: Added module-level docstrings to
pipeline/ingestion.py,pipeline/training.py,utils/model_bridge.py,ensembles/orchestrator.py.
Changed¶
- Print → Logging: Converted 60+
print()calls across 25 source modules to structuredloggingwithgetLogger(__name__)and%-style formatting. Dashboard and drivers intentionally excluded (stdout by design). - CI Coverage Threshold: Raised
--cov-fail-underfrom 50 to 97 in.github/workflows/ci.ymlto match actual coverage. - Version bump: 2.1.0 → 2.2.0.
Fixed¶
- Unused Imports: Removed dead imports from 7 files (
bio/uploading.py,core/replication.py,core/immortality.py,export/onnx_exporter.py,dashboard/text_dashboard.py,hdl_gen/verilog_generator.py,viz/web_viz.py). - Input Validation:
VectorizedSCLayer.forward()now raisesValueErroron wrong-shape input instead of silently producing garbage. - File I/O Error Handling:
onnx_exporter.py,immortality.py,verilog_generator.py, andreplication.pynow catchOSErroron file operations and log meaningful messages.
Security¶
- Pickle Allowlist: Replaced wildcard
'numpy.core.numeric': {'*'}with explicit{'_frombuffer', 'scalar'}incore/immortality.py. - Path Traversal Prevention:
core/replication.pynow validates that the destination directory is within or below the working directory viaos.path.realpath()+os.path.relpath().
[2.1.0] - 2026-02-08¶
Fixed (Critical)¶
- HDL Bitstream Encoder Seed Decorrelation: All parallel encoders shared
hardcoded seed
0xACE1, producing correlated bitstreams and breaking SC multiplication (P(x AND x) = P(x)instead ofP(x)*P(w)). Added per-instanceSEED_INITparameter with prime-stride offsets (input:0xACE1 + i*7, weight:0xBEEF + i*13). - HDL Missing Port Connections:
noise_inandv_outwere floating on LIF neuron instances insc_dense_layer_core.v. Connected via wire buses. - HDL Duplicate Port: Removed duplicate
.stream_leninsc_neurocore_top.v. - Fixed-Point Overflow:
FixedPointLIFNeuronnow applies_mask()for proper two's complement overflow wrapping on membrane potential.
Added¶
- GPU Acceleration Backend (
accel/gpu_backend.py):- CuPy/NumPy dual-path with automatic GPU detection and CPU fallback.
gpu_pack_bitstream(),gpu_vec_and(),gpu_popcount(),gpu_vec_mac().VectorizedSCLayerauto-selects GPU when CuPy is available.
- Performance Benchmark Suite (
scripts/benchmark_suite.py):- 14 benchmarks across 5 categories (scalar, packed ops, dense layer, full pipeline, GPU).
--fullmode (10x iterations),--markdownoutput toBENCHMARKS.md.
- CI/CD Pipeline (
.github/workflows/sc-neurocore-ci.yml):- Lint (black + mypy), Test (Python 3.9/3.11/3.12 matrix, coverage >= 60%), Build (wheel + install verification).
- Co-Simulation Harness:
hdl/tb_sc_lif_neuron.v: Verilog testbench reading stimuli.txt, writing results_verilog.txt for bit-exact comparison.scripts/cosim_gen_and_check.py: CLI driver with--generateand--check.
- Bit-True Python Models:
FixedPointLFSR: 16-bit maximal-length LFSR (period 65535).FixedPointBitstreamEncoder: LFSR + unsigned comparator._mask(): Two's complement sign-extension with overflow wrap.
- Public API Surface: Root
__init__.pyexports 28 symbols across 7 subpackages. All subpackage__init__.pyfiles populated. - Tiered Module System: 43 subpackages categorised as
core(7),research(24+), orcontrib(5). Install extras:[gpu],[research],[contrib]. - Behavioural Equivalence Tests: 29 tests covering LFSR, encoder, LIF neuron, full pipeline, and bit-width masking.
- GPU Backend Tests: 17 tests covering all GPU primitives and VectorizedSCLayer integration.
Changed¶
- Version bump: 2.0.0 -> 2.1.0.
pyproject.toml: Added tool configs (pytest, black, mypy), tiered extras.VectorizedSCLayer: Refactored to use GPU backend with CPU fallback.
[2.0.0] - 2026-01-12¶
Added¶
- Sapience & Sentience (v2.2.0):
MetaCognitionLoop: Computational self-awareness and self-modeling.NeuromodulatorSystem: Dopamine/Serotonin emotional state modulation.NeuroArtGenerator: Generative AI for internal state expression.AsimovGovernor: Ethical constraint system (Three Laws).MindDescriptionLanguage (MDL): Substrate-independent soul serialization.DigitalSoul: Persistence and reincarnation protocols.VonNeumannProbe: Code-level self-replication.
- Galactic Scale (v2.1.0):
InterstellarDTN: Long-range delay-tolerant networking.DysonPowerGrid: Stellar-scale energy management.KardashevEstimator: Civilization Type metrics.DarkForestAgent: Game-theoretic survival logic.MPIDriver: Distributed cluster-scale simulation.SNNGeneticEvolver: Automated architecture optimization.
- Transcendent & Omega (v2.0.5):
HeatDeathLayer: Entropy-survival computing.PlanckGrid: Spacetime lattice theoretical limits.HolographicBoundary: 3D-to-2D info mapping (AdS/CFT).EverettTreeLayer: Many-Worlds branching solver.WolframHypergraph: Graph-rewrite universe evolution.CategoryTheoryBridge: Unified mathematical functors.FormalVerifier: SMT-based safety proofs.
- Exotic & Frontiers (v2.0.0):
VectorizedSCLayer: 64-bit packed JIT-accelerated core.QuantumStochasticLayer: VQC qubit rotation bridge.StochasticTransformerBlock: Spike-driven attention.MemristiveDenseLayer: Hardware-aware analog simulation.StochasticCPG: Robotic locomotion oscillators.MyceliumLayer: Fungal network dynamics.BCIDecoder: Neural signal (EEG) interface.DVSInputLayer: Event Camera (AER) processing.EnergyProfiler: 45nm Energy/CO2 estimation.WatermarkInjector: IP protection security backdoors.
Optimized¶
BitstreamAverager: 6x speedup using running sum algorithm.BitstreamEncoder: Added Sobol Sequence (LDS) mode for faster convergence.
Fixed¶
- Fixed f-string syntax in Verilog generator.
- Fixed dimension mismatch in Attention mechanism.
- Addressed Windows encoding issues in documentation generation.
[1.0.0] - 2025-12-03¶
-
Initial Release: Stochastic Neurons, Synapses, and Basic Bitstream Utilities.
-
Hardened FitzHugh-Rinzel Python, Rust engine, Rust safety, Go, and Julia paths with finite-parameter validation plus candidate-first RK4 commits that preserve state on invalid currents, corrupted runtime contracts, and overflow candidates.
- Hardened McKean Rust engine, Rust safety, Go, and Julia paths with candidate-first simultaneous-Euler commits and no-spike state preservation for invalid currents, corrupted runtime contracts, and overflow candidates; later promoted the maintained Python, Rust engine, Rust safety, Go, and Julia chain to candidate-first RK4 integration.
- Hardened Morris-Lecar Rust engine finite-state commits and extended Go/Rust safety coverage for invalid-current and potassium-rate overflow rejection without changing the documented conductance equations.
- Hardened Terman-Wang Rust engine finite-state commits, Julia timestep semantics, and Go/Rust safety state-preservation tests for invalid drive and cubic-overflow candidates; later promoted the maintained Terman-Wang chain to candidate-first RK4 integration.
- Hardened Quadratic IF Rust engine finite-update commits, Julia timestep semantics, and Go service tests for invalid current and non-finite Euler increments.