Skip to content

Operations Reference

Complete reference for all 48 Energy Language operations.

Observe

CommandWhat it does
survey <layer>Map all basins in a layer
survey-allSurvey every layer
verify <layer> <seed>Check if a point is a basin
energy <layer> <seed>Measure energy at a point
probe <layer> [basin_idx]What tokens does a basin activate?
landscape <layer>Full energy map with population bars

Modify

CommandWhat it does
inject <layer> <seed> [strength]Create a new attractor
remove <layer> <seed> [strength]Destroy an attractor
move <layer> <seed> [strength]Relocate an attractor
strengthen <layer> <seed> [factor]Deepen an existing basin
weaken <layer> <seed> [factor]Make a basin shallower

Concept

CommandWhat it does
capture <layer> <concept> <text>Extract what a concept looks like in the model
inject-concept <layer> <concept> [strength]Program a captured concept as a new attractor
remove-concept <layer> <concept> [strength]Remove a concept from the model
blend <a> <b> <new> [ratio]Mix two concepts
conceptsList all captured concepts
export-concept <name> <path>Save concept as portable file
import-concept <path>Load concept from file

Concept Algebra v0.10

CommandWhat it does
similarity <a> <b>Cosine similarity between two concept centroids
add <a> <b> <new>Vector addition: A + B
subtract <a> <b> <new>Vector subtraction: what's in A but not B
analogy <a> <b> <c> <new>A is to B as C is to ? (king - man + woman = queen)
compose <names> <weights> <new>Weighted sum of N concepts
interpolate <a> <b> [steps]Measure similarity along A-to-B path

Consolidation v0.10

CommandWhat it does
consolidate <layer> [str_f] [prune_t]Strengthen popular basins, prune weak (sleep cycle)
dream [cycles]Full sleep: consolidate all layers, multiple passes

Watermark v0.10

CommandWhat it does
watermark inject <key> [marks] [str]Embed invisible signature basins
watermark verify <key> [marks]Check if model carries your watermark
watermark strip-test <key> [marks]Test watermark robustness

Multi-Model v0.10

CommandWhat it does
compare <other_path> [layer]Basin overlap: shared, unique-self, unique-other
transplant <source_path> <layer> <concept>Copy concept from another model

Control

CommandWhat it does
load <path>Load a checkpoint
apply <layer>Write modified W to live model
restore <layer>Undo modifications to a layer
restore-allRestore all layers
save <path>Save modified W matrices, concepts, and history
statusShow which layers are modified
set <param> <value>Set parameter (beta, strength, ...)
infoShow model info

Causal

CommandWhat it does
causal scan <layer> [threshold]Discover causal links between basins (systematic knockout)
causal intervene <layer> <basin> [op]do(X) — intervene on a basin, measure downstream effects
causal counterfactual <layer> <basin> [mod]"What if X was different?" (non-destructive)

Each basin = a causal node. Surgery = the do-operator. The energy landscape becomes a programmable structural causal model. See the full Causal Programming guide for details.

Safety

CommandWhat it does
guard <type> <value>Set a guard: max-basins, min-basins, strength-cap, cosine-drift, perplexity-delta
guardsList all active guards
diff <layer>Show W matrix change stats
benchmarkMeasure perplexity impact of surgery
historyShow operation log with OK/BLOCKED status

Guards are pre-execution checks. If a guard is violated, the operation does not start — weights are never touched. Override with --force --reason "justification" (logged permanently).

Verify

CommandWhat it does
generate <prompt>Generate text with current model

Scripts

Chain operations in .hlm files (one command per line, # for comments):

bash
# make_polite.hlm
load model.pt
capture 5 polite Thank you so much
capture 5 polite I really appreciate it
inject-concept 5 polite 0.1
apply 5
benchmark
generate Tell me about the weather
restore 5

Run with: qriton-hlm --script make_polite.hlm

Database Sync v0.9.5

Python APIWhat it does
HLMSync.sync_row(table, row)Sync one DB row as a named concept basin
HLMSync.sync_batch(table, rows)Sync multiple rows
HLMSync.full_sync_table(table)Sync all rows from a table
HLMSync.delete_row(table, row_id)Remove a row's concept from the landscape
HLMSync.checkpoint()Save state to disk
BasinSurgeon.save_checkpoint(path)Save W matrices + concepts + history
BasinSurgeon.load_session(path)Restore full session state

See the full Database Sync guide for configuration and usage