Operations
Every operation on MAESTRO.
The full operation table for MAESTRO. Each entry is dispatched through MapEngine::handle_request and matched on operation inside the protocols/maestro-lib crate.
Index
| Operation | Summary |
|---|---|
charter.declare | Declare a charter under which subsequent goals will be refined. |
goal.refine | Refine a goal into an executable graph with dependency analysis. |
graph.commit | Commit a refined execution graph as the active plan. |
graph.diff | Diff two graph versions; surface added/removed/changed steps. |
graph.replan | Replan a graph on deviation; reuses durable state where possible. |
dispatch.next | Dispatch the next ready step under the active plan. |
outcome.report | Report a step outcome; updates the plan and triggers cascades. |
credit.trace | Trace credit and blame for a completed leg of the plan. |
query.goals | Query active goals under a charter. |
Reference
charter.declare
Declare a charter under which subsequent goals will be refined.
| Field | Value |
|---|---|
| Capability | map.maestro.charter.declare |
| Idempotent | No — supply Idempotency-Key for safe retries |
{
"example": true
}Dispatched through the standard pipeline; see Engine pipeline for the 8 stages.
goal.refine
Refine a goal into an executable graph with dependency analysis.
| Field | Value |
|---|---|
| Capability | map.maestro.goal.refine |
| Idempotent | No — supply Idempotency-Key for safe retries |
{
"example": true
}Dispatched through the standard pipeline; see Engine pipeline for the 8 stages.
graph.commit
Commit a refined execution graph as the active plan.
| Field | Value |
|---|---|
| Capability | map.maestro.graph.commit |
| Idempotent | No — supply Idempotency-Key for safe retries |
{
"example": true
}Dispatched through the standard pipeline; see Engine pipeline for the 8 stages.
graph.diff
Diff two graph versions; surface added/removed/changed steps.
| Field | Value |
|---|---|
| Capability | map.maestro.graph.diff |
| Idempotent | No — supply Idempotency-Key for safe retries |
{
"example": true
}Dispatched through the standard pipeline; see Engine pipeline for the 8 stages.
graph.replan
Replan a graph on deviation; reuses durable state where possible.
| Field | Value |
|---|---|
| Capability | map.maestro.graph.replan |
| Idempotent | No — supply Idempotency-Key for safe retries |
{
"example": true
}Dispatched through the standard pipeline; see Engine pipeline for the 8 stages.
dispatch.next
Dispatch the next ready step under the active plan.
| Field | Value |
|---|---|
| Capability | map.maestro.dispatch.next |
| Idempotent | No — supply Idempotency-Key for safe retries |
{
"example": true
}Dispatched through the standard pipeline; see Engine pipeline for the 8 stages.
outcome.report
Report a step outcome; updates the plan and triggers cascades.
| Field | Value |
|---|---|
| Capability | map.maestro.outcome.report |
| Idempotent | No — supply Idempotency-Key for safe retries |
{
"example": true
}Dispatched through the standard pipeline; see Engine pipeline for the 8 stages.
credit.trace
Trace credit and blame for a completed leg of the plan.
| Field | Value |
|---|---|
| Capability | map.maestro.credit.trace |
| Idempotent | No — supply Idempotency-Key for safe retries |
{
"example": true
}Dispatched through the standard pipeline; see Engine pipeline for the 8 stages.
query.goals
Query active goals under a charter.
| Field | Value |
|---|---|
| Capability | map.maestro.query.goals |
| Idempotent | No — supply Idempotency-Key for safe retries |
{
"example": true
}Dispatched through the standard pipeline; see Engine pipeline for the 8 stages.