DevToolsComponent

The Dev tools section as a Milpa Component: the ledgers the house already writes, read — the agent's sessions with their state and real token cost, the debt signals by kind, the evidence ledger and the declared log's tail; or, when the section's query names a session, that session's timeline. The one prop it reads is `query` — the request's query params the shell hands every active section — and the one key it looks at is `session`: set, the mounted state carries the drill-down (`view: session`); absent, the overview (`view: overview`). The STATE THAT TRAVELS is only `{view, session}` ({@see self::envelope()}): the ledgers are a projection re-read on every mount, never signed and sent back to the browser — an envelope with a thousand rows would be a second copy of the ledger with a signature on it. Read-only in both views: it declares no action and refuses every one, because every mutation of the house is a governed operation, never a button here (greenhouse decisions/0205).

public function __construct(Milpa\Admin\Data\DevToolsSource $source):

Parameters

public static function contract(): Milpa\Live\ValueObjects\ComponentContract

The contract: the request's `query` as its one prop; the state that travels is `{view, session}`; no actions.

public function mount(array $props, Milpa\Live\ValueObjects\ComponentContext $context): Milpa\Live\ValueObjects\StateSnapshot

Mounts with the overview, or with one session's timeline when `query.session` names it. The mounted data carries the whole projection for the renderer; what travels is {@see self::envelope()}.

Parameters

public function handle(Milpa\Live\ValueObjects\InteractionRequest $request): Milpa\Live\ValueObjects\InteractionResult

Refuses every action: the section reads; it never acts.

Parameters

public static function envelope(Milpa\Live\ValueObjects\StateSnapshot $state): Milpa\Live\ValueObjects\StateSnapshot

The state that travels in the signed envelope: `{view, session}` and nothing else — the two facts a re-mount needs ({@see self::propsOf()}), never the rows, the log or the evidence.

Parameters

public static function travels(Milpa\Live\ValueObjects\StateSnapshot $state): bool

Whether a state is the travelling envelope — `{view, session}` and nothing else — as opposed to a mounted state that carries the projection to paint.

Parameters

public static function propsOf(Milpa\Live\ValueObjects\StateSnapshot $carried): array

The props that re-mount the page a carried envelope names — so a renderer handed the travelling `{view, session}` reads the ledgers again instead of painting an envelope that holds none.

Parameters