Merge pull request #1 from justinlietz93/dev

Dev

Author: justinlietz93

.gitignore

@@ -10,4 +10,10 @@ runs/
 *.log
 .DS_Store
 reports
-.arachnid_scans
+.arachnid_scans
+
+# Experiments
+experiments/vdm_rt-main
+experiments/*/vdm_rt-main
+experiments/*/*/vdm_rt-main
+experiments/*/*/*/vdm_rt-main

README.md

@@ -1,6 +1,6 @@
-![Void Dynamics Model Runtime Engine](/assets/vdm-rt_banner.png)
+![Void Dynamics Model Runtime Engine](/assets/vdm-rt_banner-2.png)
 
-# Base Cognitive Engine
+# VDM Cognitive Engine: Base Runtime
 
 This package preserves the headless VDM runtime engine and removes the old frontend, physics harnesses, generated scan reports, corpus data, and accelerator experiments that are not required for the runtime path.
 
@@ -18,7 +18,7 @@ vdm_rt/nexus.py              runtime facade and Nexus host object
 vdm_rt/cli/                  CLI argument definitions
 vdm_rt/control/              headless process-control boundary
 vdm_rt/core/                 retained engine, sparse connectome, ADC, SIE, maps, scouts, memory, signals
-vdm_rt/io/                   runtime transduction, lexicon, and logging adapters
+vdm_rt/io/                   receptor/actuator boundary ports and logging adapters
 vdm_rt/runtime/              loop, stepper, telemetry, phase, checkpointing, status helpers
 vdm_rt/utils/                logging utilities
 vdm_rt/tests/                retained engine/runtime/control/guard tests
@@ -55,10 +55,9 @@ Artifacts land in `runs/<timestamp>/` by default:
 
 ```text
 events.jsonl          structured runtime logs
-utd_events.jsonl      transduction output events
+utd_events.jsonl      explicit motor-event audit records when a motor port emits
 phase.json           optional external control-plane input when present
-state_<step>.h5       checkpoint when --checkpoint-every is enabled and h5py is available
-state_<step>.npz      checkpoint fallback
+state_<step>.h5       checkpoint when --checkpoint-every is enabled
 ```
 
 ## Runtime boundaries
@@ -67,8 +66,8 @@ The retained architecture is deliberately headless:
 
 ```text
 core      numeric/state machinery, SIE, sparse connectome, maps, scouts, memory, signals
-runtime   loop orchestration, per-tick helpers, telemetry, checkpoint/status emission
-io        UTE/UTD, lexicon, logging
+runtime   loop orchestration, per-tick helpers, telemetry, checkpoint/status helpers
+io        UTE/UTD boundary ports and logging
 control   subprocess/process boundary for future clients
 frontend  removed
 ```
@@ -83,19 +82,19 @@ in tracked, operator-visible TOML files under `config/`, split by subsystem so
 the config surface stays readable.
 
 ```text
-config/runtime.toml            cross-cutting loop, event, territory, composer knobs
+config/runtime.toml            cross-cutting loop, event, and territory knobs
 config/launch.toml             command-line launch defaults
 config/sparse_connectome.toml  sparse graph maintenance controls
 config/adc.toml                announcement bus and ADC defaults
-config/stimulus.toml           text-to-connectome stimulation defaults
-config/speech.toml             autonomous speech and B1 detector defaults
+config/stimulus.toml           explicit receptor-node stimulation defaults
+config/b1.toml                 live topology detector defaults
 config/maps.toml               event map and memory/trail view defaults
 config/sie.toml                Self-Improvement Engine runtime defaults
 config/persistence.toml        checkpoint and resume defaults
 config/control.toml            embedded control-plane defaults
 config/learning.toml           optional REVGSP/GDSP adapter controls
 config/scouts.toml             void-walker scout budgets and enable flags
-config/io.toml                 emitters, smoke checks, HTTP status, Redis status
+config/io.toml                 receptor queue, HTTP status, Redis status
 config/logging.toml            JSONL and zip spool limits
 ```
 

assets/vdm-rt_banner-2.png

@@ -57,21 +57,15 @@ def make_parser() -> argparse.ArgumentParser:
     p.add_argument('--bundle-size', dest='bundle_size', type=int, default=config_int("sparse_connectome.bundle_size", 3))
     p.add_argument('--prune-factor', dest='prune_factor', type=float, default=config_float("sparse_connectome.prune_factor", 0.10))
 
-    # Text→connectome stimulation (symbol→group)
-    p.add_argument('--stim-group-size', dest='stim_group_size', type=int, default=config_int("stimulus.group_size", 4))
+    # External receptor stimulation amplitude/decay. Receptor-node selection is not done here.
     p.add_argument('--stim-amp', dest='stim_amp', type=float, default=config_float("stimulus.amp", 0.05))
     p.add_argument('--stim-decay', dest='stim_decay', type=float, default=config_float("stimulus.decay", 0.90))
-    p.add_argument('--stim-max-symbols', dest='stim_max_symbols', type=int, default=config_int("stimulus.max_symbols", 64))
-
-    # Self-speak and topology-spike detection (void-native)
-    p.add_argument('--speak-auto', dest='speak_auto', action='store_true')
-    p.add_argument('--no-speak-auto', dest='speak_auto', action='store_false')
-    p.set_defaults(speak_auto=config_bool("speech.auto", True))
-    p.add_argument('--speak-z', dest='speak_z', type=float, default=config_float("speech.z", 1.0))
-    p.add_argument('--speak-hysteresis', dest='speak_hysteresis', type=float, default=config_float("speech.hysteresis", 1.0))
-    p.add_argument('--speak-cooldown-ticks', dest='speak_cooldown_ticks', type=int, default=config_int("speech.cooldown_ticks", 10))
-    p.add_argument('--speak-valence-thresh', dest='speak_valence_thresh', type=float, default=config_float("speech.valence_threshold", 0.01))
-    p.add_argument('--b1-half-life-ticks', dest='b1_half_life_ticks', type=int, default=config_int("speech.b1.half_life_ticks", 50))
+
+    # Topology-spike detection (void-native, no output authorship)
+    p.add_argument('--b1-z', dest='b1_z', type=float, default=config_float("b1.z", 1.0))
+    p.add_argument('--b1-hysteresis', dest='b1_hysteresis', type=float, default=config_float("b1.hysteresis", 1.0))
+    p.add_argument('--b1-cooldown-ticks', dest='b1_cooldown_ticks', type=int, default=config_int("b1.cooldown_ticks", 10))
+    p.add_argument('--b1-half-life-ticks', dest='b1_half_life_ticks', type=int, default=config_int("b1.half_life_ticks", 50))
 
     # Announcement bus / ADC tuning
     p.add_argument('--bus-capacity', dest='bus_capacity', type=int, default=config_int("bus.capacity", 65536))
@@ -82,10 +76,6 @@ def make_parser() -> argparse.ArgumentParser:
 
     # Engram loader (optional)
     p.add_argument('--load-engram', dest='load_engram', type=str, default=_optional_str("persistence.load_engram"))
-    # Optional embedded control server (disabled by default to avoid duplicate UI)
-    p.add_argument('--control-server', dest='control_server', action='store_true')
-    p.add_argument('--no-control-server', dest='control_server', action='store_false')
-    p.set_defaults(control_server=config_bool("control.server_enabled", False))
     # Allow explicit reuse of an existing run directory (resume), otherwise a new timestamp dir is used
     p.add_argument('--run-dir', dest='run_dir', type=str, default=_optional_str("launch.run_dir"))
 

cli/args.py

@@ -11,17 +11,21 @@ defaults; malformed TOML fails loudly so bad operator input is visible.
 Current files:
 
 - `launch.toml` - command-line launch defaults and run-directory behavior.
-- `runtime.toml` - cross-cutting loop, event, territory, and composer knobs.
+- `runtime.toml` - cross-cutting loop, event, and territory knobs.
 - `sparse_connectome.toml` - sparse graph maintenance controls.
 - `adc.toml` - announcement bus and ADC defaults.
 - `b1.toml` - reserved Void B1 topology-meter defaults; not consumed by the default runtime until B1 ownership is resolved.
-- `stimulus.toml` - text-to-connectome stimulation defaults.
-- `speech.toml` - autonomous speech and B1 detector defaults.
+- `stimulus.toml` - explicit receptor-node stimulation defaults.
+- `b1.toml` - live topology detector defaults.
 - `maps.toml` - event map and memory/trail view defaults.
 - `sie.toml` - Self-Improvement Engine runtime defaults.
 - `persistence.toml` - checkpoint and resume defaults.
 - `control.toml` - embedded control-plane defaults.
 - `learning.toml` - experimental REVGSP/GDSP adapter controls; the default SparseConnectome path does not yet satisfy their required substrate contract.
 - `scouts.toml` - void-walker scout budgets and per-scout enable flags.
-- `io.toml` - emitters, smoke checks, HTTP status, and Redis status output.
-- `logging.toml` - JSONL and zip spool limits.
+- `io.toml` - receptor queue, HTTP status, and Redis status output.
+- `logging.toml` - JSONL and zip spool limits. `events.jsonl` uses the
+  `events_*` limits, names containing `utd` use `utd_*`, and other JSONL files
+  use `log_*`; `roll_check_every = 1` enforces active-file caps after each write.
+  `zip_spool = true` instead selects the zip-buffer strategy and uses
+  `zip_buffer_bytes` and `zip_ring_bytes` for those standard writers.

config/README.md

@@ -1,6 +1,9 @@
-# Reserved B1 topology-meter defaults. These take effect only when VoidB1Meter
-# is wired as a runtime producer.
+# B1 topology detector defaults. These configure the live StreamingZEMA
+# topology-spike detector; they do not trigger text output.
 
 [b1]
 sample_edges = 4096
 half_life_ticks = 50
+z = 1.0
+hysteresis = 1.0
+cooldown_ticks = 10

config/b1.toml

@@ -1,7 +1,4 @@
-# Embedded control-plane defaults.
+# Headless control-plane defaults.
 
 [control]
-server_enabled = false
-server_host = "127.0.0.1"
-server_port = 8765
 feed_file_rate_lps = 20.0

config/control.toml

@@ -1,15 +1,5 @@
 # Runtime IO and optional external status outputs.
 
-[emitters]
-# Empty paths use run-directory defaults.
-utd_out = ""
-enable_thoughts = false
-thought_out = ""
-
-[smoke]
-enable_macros_test = false
-enable_thoughts_test = false
-
 [status_http]
 enabled = false
 host = "127.0.0.1"
@@ -22,8 +12,5 @@ stream_status = "runtime:status"
 status_maxlen = 2000
 
 [ute]
-use_stdin = true
 queue_maxsize = 1024
 poll_max_items = 32
-inbox_poll_seconds = 0.5
-ticker_interval_seconds = 1.0

config/io.toml

@@ -1,11 +1,17 @@
 # Runtime file logging and spool limits.
 
 [logging]
-# Use zip-spooled JSONL writers for bounded disk pressure.
+# Choose the active-file strategy for standard event and UTD writers.
+# true: use zip_buffer_bytes/zip_ring_bytes and append rotated buffers to a zip.
+# false: use the category-specific rolling limits below and archive old lines.
 zip_spool = true
 
 # Rolling JSONL caps, in MiB where the name says mb. Zero line caps mean
-# "unset; use byte caps".
+# "unset; use byte caps". Active files are checked after every write by
+# default, so small diagnostic runs honor these limits immediately.
+#
+# Category selection is filename-based: events.jsonl uses events_*, files whose
+# names contain "utd" use utd_*, and all other JSONL files use log_*.
 events_max_mb = 256
 events_max_lines = 0
 events_archive_segment_mb = 512
@@ -18,8 +24,9 @@ log_max_mb = 128
 log_max_lines = 0
 log_archive_segment_mb = 256
 log_archive_segment_lines = 0
-roll_check_every = 200
+roll_check_every = 1
 
-# Zip spooler byte caps.
+# Zip spooler byte caps. Values are exact positive byte limits; use a small
+# value for a quick local rotation test and a larger value for normal runs.
 zip_buffer_bytes = 1048576
 zip_ring_bytes = 65536

config/logging.toml

@@ -3,7 +3,7 @@
 [persistence]
 checkpoint_every = 0
 checkpoint_keep = 5
-checkpoint_format = "h5"
+checkpoint_format = "h5" # Only supported runtime checkpoint write format.
 
 # Empty means no startup engram load. May be a checkpoint file or a run folder.
 load_engram = ""