How To Read The JSON

How To Read The JSON

The package returns JSON because agents, CI jobs, and other programs can inspect it reliably.

The Four Status Fields

Field	Plain meaning
accepted	The input envelope passed the checker for this command.
workflow_usable	The report can guide the next workflow step. This is not settlement.
operationally_usable	The report can guide routing under the selected profile.
settled	All scoped finite obligations were discharged. This is often false.

These fields are separate on purpose.

A report can be accepted and useful while still not settled.

Residual And Obligation Fields

Read these before treating any result as complete:

• missing_obligations: work still required.
• residual_ledger: unresolved debt, limits, uncertainty, or assumptions.
• residual_summary: compact summary of unresolved work.
• candidate_only_reasons: why a result stays candidate-only.
• cannot_promote_because: why promotion is blocked.
• settled_blockers: why settled=true is not allowed.
• blockers: command-specific blockers.

Do not remove these fields to make output look cleaner.

Safe Commands

Some reports include safe_commands.

These are display recommendations or inspection hints. They are not permission to execute arbitrary commands.

The package does not run packet content, shell snippets, npm commands, Docker commands, repository mutation commands, or cloud commands from a report.

Good First Reading Order

1. Check accepted.
2. Check workflow_usable or operationally_usable.
3. Check settled.
4. If settled=false, read missing_obligations.
5. Read residual fields.
6. Read candidate-only and blocker fields.
7. Treat task lists and route requests as recommendations for a reviewer or host runtime.

Common Pattern

{
  "accepted": true,
  "workflow_usable": true,
  "settled": false,
  "missing_obligations": ["identity-context", "verifier-route"],
  "candidate_only_reasons": ["external intake cannot reduce phase gaps"]
}

This is useful output. It says the workflow can continue, but the work is not complete.