Skip to main content

Crate aria_operator

Crate aria_operator 

Source
Expand description

Closed operator JSON over the Aria telemetry transform.

Each catalog binary is a distinct crate that includes its own spec.json and calls run_spec. AriA is the underlying transformer in every binary: Φ is not copied, it is linked.

Structs§

HarnessRequest
What a PCVC worker sends on stdin. Field names are camelCase to match the harness’s Pydantic aliases; unknown fields are rejected (closed model).
HarnessResult
Bindings a harness re-checks on the way back (driver.py field list).
OperatorEnvelope
Closed operator JSON. Unknown fields are never written.
OperatorGraph
Grammar position of this operator’s return — a deterministic function of the frozen catalog, never of the payload. Carried on the wire so any graph consumer (Obsidian, PCVC, a queue) renders the result as-is instead of re-deriving the grammar. “Node vs rel vs property” is class; the common/uncommon split is shape.
OperatorNode
One typed node on the operator envelope.
OperatorRel
One typed relationship on the operator envelope.
OperatorSpec
One catalog operator. Frozen into each crate’s spec.json.
OrganizeReport
What the node determined from the host payload before pruning. Workers use this to know depth, token count, and which binaries to ask.
RunOpts
Options a binary or test may pin. Defaults match aria node.
WorkRequest
JSON command the nervous-system gateway accepts.
WorkResponse
Compiled results. Zero Trust: no Trust/Use/Goal keys.
WorkerEndpoint
How a Mode 4 worker invokes one catalog binary.

Enums§

HarnessError
Validation failures a harness treats as protocol errors (non-zero exit).
OperatorError
Operator-layer failure. Never a Trust write.

Constants§

CATALOG_JSON
Frozen catalog shipped with this crate (560 rows: 535 research/host + 25 map mixers).
DEFAULT_OUTPUT_LIMIT
Default stdout budget — matches PCVC’s _OUTPUT_BYTES (64 KiB).
DISPATCH_JSON
Slim PCVC spawn table (M7 / E9): 560 rows, no graph block.
ENVELOPE_KEYS
Canonical serialized key order of every envelope (all 560 operators emit this shape; members marked ? are omitted when empty/none). Workers prune from this list — the shape is the same for every operator, so pruning is one operation, never per-binary (𝔸T6 uniform shape).
HARNESS_CAPABILITY
The one closed capability this node registers.
HARNESS_REQUEST_V1
Request schema tag (stable; additive changes bump the suffix).
HARNESS_RESULT_V1
Result schema tag.
OPERATOR_ENVELOPE_V1
Schema tag for the operator envelope (Binary Repository v1 / sheet 09).
OPERATOR_SCHEMA_VERSION
Closed envelope semver carried on every operator document.
WORK_V1
Schema tag for a compiled work response.

Functions§

bin_exit
ExitCode wrapper for callers that prefer the std type.
bin_main
CLI entry used by every generated [[bin]]. Returns a process exit code.
callback_results
Filter a projection set down to envelopes a PCVC worker or Neo4j driver can consume. Dump scoring still uses the unfiltered run_many set.
cast_lexicon
Phrase (lowercase, spaces) → catalog tags in catalog order.
cast_tags
Closed-vocabulary tags found in this record’s 00c fields. Catalog order.
catalog
Frozen catalog (560 rows). Parsed once per process.
commands_json
Hosted command list — what Aria compiles against.
dispatch_json
aria-dispatch-v1: the descriptor PCVC’s registry / policy layer pins. Everything is a function of the frozen catalog plus this executable’s identity, so the harness can record exact hashes (Mode 4 step 5).
endpoint_by_binary_id
Point a worker at a BIN.* work definition.
endpoint_by_operator
Point a worker at a catalog operator name (PEOPLE, TAG.PERSON_FOUNDER, …).
endpoint_by_package
Point a worker at a cargo package (aria-telemetry-people).
execute_harness
Execute one harness request. Never panics; engine rejections become a limitation result (still bound, still exit 0) — the harness decides.
execute_work
Execute a JSON work request.
family_residuals
Residual + DEEP_TAG specs whose parent is this family operator (E10).
harness_lane
Full stdin → stdout lane. Returns (exit code, stdout bytes); stderr is never written. Protocol errors (unparseable/unbound request) exit 2 with a JSON error object so the harness sees why without a stderr channel.
looks_like_work_command
True if a JSON value looks like a work command rather than a raw payload.
organize_slop
Read the payload the way 00c does. No Φ. No new nodes.
run_binary
Gateway entry: run any catalog binary by BIN.* id.
run_many
One Φ, N projections. Hosted command lists compile through this.
run_spec
Run the Aria transform and project this crate’s closed operator JSON.
serve
Bind and serve forever. Returns only on bind failure.
serve_background
Same as serve but returns the bound address and runs the accept loop on a background thread — the seam the load test uses.
spec_by_id
Look up one catalog row by BIN.* (interned, O(1)).
spec_by_operator
Look up one catalog row by operator name (PEOPLE, TAG.PERSON_FOUNDER, …).
spec_by_package
Look up one catalog row by cargo package.
specs_for_tag
Research binaries that declare this exact anchor tag.
tag_phrase
Catalog tag → lowercase phrase the lexicon matches (PERSON_FOUNDER → founder).
token_stat
(weight, height) of one grammar token: kind, rel type, tag, property key.
uncast_fields
Designated single-value fields whose text produced zero lexicon hits.
wave_height
Wave ladder height (sheet 12 wave column): A→1, B→2, C→3, D→4.
work_main
Process entry for work. Returns an exit code.