Releases: asuramaya/decepticons
Releases · asuramaya/decepticons
v0.1.3
Added
- CLI:
decepticons --versionflag. - CLI:
decepticons infosubcommand — prints version, install path, and
public surface size. Useful for bug reports and environment diagnosis. - CLI:
decepticons scoresubcommand — fits a model and prints bits/byte
without sampling. - CLI:
decepticons fit --seed Nfor reproducible sampling. python -m decepticonsworks as an alias for thedecepticonsscript.
Changed
- CLI:
fitsubcommand now uses the canonicalByteLatentPredictiveCoder
class name internally instead of the legacyOpenPredictiveCoderalias. - CLI help text for every subcommand now describes what it does.
__all__is now sorted case-insensitively (with__version__pinned
first), so additions land in a predictable place.- Removed stale section-header comments in
__init__.pythat no longer
matched the import order they sat over.
v0.1.2
Docs
- Install section now leads with explicit venv setup (Linux/Windows commands)
and links PEP 668. Previously the venv step was implicit, which tripped up
users on modern Debian/Ubuntu wherepiprefuses to write into the system
Python without a venv.
v0.1.1
Added
decepticons.__version__derived from package metadata.scripts/release.sh— one-command version bump + tag + push.- Release workflow now creates a GitHub Release with notes from
CHANGELOG.md
and attaches the wheel + sdist as release assets. - Release workflow smoke-installs the built wheel and verifies the installed
__version__matches the pushed tag before publishing.
Changed
- Aligned canonical phrasing across README, docs, site, and package metadata:
unified five-pillar list (substrates, memory, gating, routing, readouts),
unified ecosystem labels (kernel · runtime · forensics), unified promotion
rule wording, unified causality-test pitch. pyproject.tomldescription now matches the README/site tagline voice.decepticons.__init__module docstring rewritten to match the canonical
one-line description.decepticons --helpdescription now describes what the CLI does instead of
the generic "Decepticons CLI" placeholder.
Packaging
- README install section now leads with
pip install decepticonsfor end users;
source-install instructions moved under a "for development" heading. - README image and inter-doc links converted to absolute GitHub URLs so the
README renders correctly on PyPI (relative paths break outside GitHub). - Added a PyPI version badge to the README header.
- Added
MANIFEST.inso the sdist shipsCHANGELOG.md,CONTRIBUTING.md,
and.github/workflows/for downstream packagers.
v0.1.0
First public release. Alpha-stage research kernel.
Kernel
- Reusable substrate primitives:
EchoStateSubstrate,DelayLineSubstrate,
LinearMemorySubstrate,OscillatoryMemorySubstrate,MixedMemorySubstrate,
HierarchicalSubstrate, plus thefactoriesconfig-driven dispatch. - Memory primitives:
ExactContextMemory,NgramMemory,
StatisticalBackoffMemory,OnlineCausalMemory, plusExactContextCache
andStatisticalBackoffCacheview layers. - Control surfaces:
ControllerSummary,PredictiveController,
LearnedSegmenter,PathwayGateController,SummaryRouter,
HormoneModulator,PredictiveSurpriseController. - Feature views:
ByteLatentFeatureView,HierarchicalFeatureView,
LinearMemoryFeatureView,SampledMultiscaleReadout,
ProbabilityDiagnostics,bridge_feature_arrays,
BidirectionalContextProbe. - Readouts and experts:
RidgeReadout,FrozenReadoutExpert. - Adapters:
CausalPredictiveAdapter,NoncausalReconstructiveAdapter,
OracleAnalysisAdapter,BridgeExportAdapter,TeacherExportAdapter,
ByteLatentPredictiveCoder. - Causal-bank family:
CausalBankConfig,build_linear_bank,
validate_config,scale_config,learnable_substrate_keys. Substrate
modesfrozen,learnable_decays,learnable_mixing,learned_recurrence,
gated_retention. Optional memory attachment, stacked blocks, selective
scan, banded readouts, byte-to-patch encoding, fast/slow hemispheres,
polynomial expansion, training noise, adaptive regularization. - Runtime:
CausalTrace,FitReport,evaluate_rollout,score_next_step,
evaluate_dataset,evaluate_rollout_curve,evaluate_transfer_probe,
TrainModeConfig,ArtifactAccounting, artifact audits.
Backends
decepticons.models.causal_bank_torch.CausalBankModel— PyTorch
implementation with frozen substrate, selective scan augment, banded readout.
Optional installs:pip install -e ".[torch]".decepticons.models.causal_bank_mlx.CausalBankModel— MLX equivalent.
Optional installs:pip install -e ".[metal]".
CLI
decepticons fit— single-command fit + sample over a UTF-8 corpus.
Verification
tests/test_causality.pyverifies every substrate mode is causal under
perturbation. CI fails if any future-leak is detected.tests/test_dependency_firewall.pyAST-scans the kernel to ensure
decepticons never imports its descendants.