Skip to main content

Module presets

Module presets 

Source
Expand description

§4 “Presets” (docs/composable-harness/COMPOSABLE-HARNESS-DESIGN.md) — P2 of the composable-harness migration (design §5.2, phase P2).

The six reserved built-in presets, compiled in as TOML consts, transcribed faithfully from the design doc’s §4.1-§4.5 TOML blocks (and §4’s intro paragraph for the sixth, supercode-default, which the doc defines by prose rather than a TOML block — S10 fix: “pi-core MINUS {trust, session_tree, session_share, server, plugins}”, not “pi-core plus extras”).

Syntax fix (P2 judgment call). The design doc’s [capabilities.X] { enabled = true, ... } lines combine a TOML table-HEADER and an inline-table VALUE on one line, which is not valid TOML (verified empirically against the toml crate: invalid table header, expected newline). Naively rewriting them as dotted-key assignments (capabilities.X = { ... }) is also unsafe wherever such a line appears after an already-open [capabilities.permissions] table (cc-parity, cx-parity, oc-parity all have this): a dotted key inside an open table is relative to the CURRENT table, so capabilities.permissions.sandbox = {..} written while inside [capabilities.permissions] nests as capabilities.permissions.capabilities.permissions.sandbox, silently corrupting the structure. The transcription below instead expands every [capabilities.X] { k = v, ... } shorthand into the equivalent explicit form — a real [capabilities.X] table header (always root-absolute, never context-relative) followed by k = v lines — which is safe regardless of surrounding context and preserves the exact same resolved structure. Every block below is verified to parse into [HarnessConfig] in this module’s tests, and each preset’s resolved shape is golden-tested against §4.6’s per-preset verdicts in crates/core/tests/composable_presets.rs.

Comments from the design doc are preserved verbatim inside each TOML block for traceability back to the source section.

Constants§

CC_PARITY_TOML
cc-parity — design §4.2.
CX_PARITY_TOML
cx-parity — design §4.3.
OC_PARITY_TOML
oc-parity — design §4.4.
PI_CORE_TOML
pi-core — design §4.1.
RESERVED_PRESET_NAMES
The six reserved built-in preset names (design §4, opening paragraph).
SUPERCODE_DEFAULT_TOML
supercode-default — design §4 intro (S10 fix).
TOKEN_SAVER_TOML
token-saver — design §4.5.

Functions§

lookup
Look up a built-in preset’s compiled-in TOML text by name. Returns None for anything not one of the six RESERVED_PRESET_NAMES — the resolver (configfile.rs §3.5) falls back to treating the name as a file path in that case (user/global layer only, §3.3).