# Glossary

## Millrace

An open-source, filesystem-backed runtime for long-running autonomous agent work.

## `millrace_ai`

The importable Python package namespace.

## `millrace`

The installed CLI command.

## `python -m millrace_ai`

The module entrypoint form for invoking the CLI from source or a Python environment.

## Workspace runtime root

The runtime-owned subtree under:

```text
<workspace>/millrace-agents/
```

## Task document

A canonical markdown work document under `millrace-agents/tasks/` representing execution work.

## Spec document

A canonical markdown work document under `millrace-agents/specs/` representing planning-owned or planning-derived specification work.

## Incident document

A canonical markdown work document under `millrace-agents/incidents/` representing planning-side incident or remediation intake.

## Execution plane

The plane that owns the shipped execution loop and stages such as `builder`, `checker`, `fixer`, `doublechecker`, `updater`, `troubleshooter`, and `consultant`.

## Planning plane

The plane that owns the shipped planning loop and stages such as `planner`, `manager`, `mechanic`, `auditor`, and `arbiter`.

## `execution.standard`

The shipped built-in execution loop id.

## `planning.standard`

The shipped built-in planning loop id.

## `default_codex`

The shipped canonical mode that binds all shipped stages to the built-in `codex_cli` adapter.

## `default_pi`

The shipped canonical mode that binds all shipped stages to the built-in `pi_rpc` adapter.

## `standard_plain`

A compatibility alias that resolves to `default_codex`.

## `CompiledRunPlan`

The frozen runtime plan produced by compile. It records the selected mode and loops, materialized node bindings, entry surfaces, transition data, and completion behavior.

## `compiled_plan_id`

A deterministic identifier derived from the effective compiled structure.

## `compile_diagnostics.json`

The persisted diagnostic output of the latest compile attempt.

## `StageRunRequest`

The runtime request object that describes one stage run, including the frozen node execution contract.

## `RunnerRawResult`

The raw adapter result returned from a stage execution before runtime-owned normalization and result application.

## `codex_cli`

The built-in Codex CLI adapter.

## `pi_rpc`

The built-in Pi RPC adapter.

## Entry point

A markdown instruction file deployed under `millrace-agents/entrypoints/` and attached to a stage node during compile.

## Required skills

Stage-core advisory skill paths frozen into the compiled node plan.

## Attached skills

Optional additional advisory skill paths attached at compile time.

## Runtime snapshot

The runtime-owned persisted state in `millrace-agents/state/runtime_snapshot.json`, used by status and control surfaces.

## Recovery counters

Persisted retry and escalation counters in `millrace-agents/state/recovery_counters.json`.

## Status markers

Markdown files under `millrace-agents/state/` that expose the active or latest terminal stage marker on the execution and planning planes.

## Run directory

A per-run artifact directory under `millrace-agents/runs/<run-id>/`.

## Arbiter

The planning-stage closure path that activates when backlog drain and lineage readiness make a closure target eligible.

## Closure target

Runtime-owned closure state for a root lineage, stored under `millrace-agents/arbiter/targets/<root_spec_id>.json`.

## Root lineage

The root spec and root idea identity carried across work documents through `root_spec_id` and `root_idea_id`.

## Mailbox control

The daemon-safe control path used for commands such as pause, resume, stop, retry-active, and reload-config when a daemon owns the workspace.

## `millrace doctor`

The integrity and health-check command for workspace, lock, and resolved runtime posture diagnostics.