# Autoresearch Goal Contract

`omagy autoresearch-goal` is the Omagy adaptation of the OMX
professor-critic research goal wrapper.

## Boundary

- Omagy does not assume a stable native agy goal API.
- The workflow source of truth is `.omagy/goals/autoresearch/<slug>/`.
- State declares `source:"omagy"`, `agy_goal_adapter:"artifact"`, and
  `native_goal_parity:false`.
- `--host-goal-json` is optional reconciliation only. It never replaces Omagy
  artifacts as the durable state owner.

## Artifacts

- `mission.json`: topic, rubric, status, adapter metadata, artifact paths.
- `rubric.md`: professor-critic rubric text.
- `ledger.jsonl`: append-only event log.
- `completion.json`: latest professor-critic verdict and final completion
  evidence.

## Commands

- `create`: initialize mission/rubric/ledger.
- `start`: mark created missions in progress and emit model-facing handoff.
- `verdict`: record `pass`, `fail`, or `blocked` professor-critic outcome.
- `complete`: require the latest verdict to be `pass`; optionally reconcile a
  complete host goal snapshot.
- `status`: print mission and completion state.

## Completion Rule

Completion is blocked unless `completion.json` records:

```json
{
  "verdict": "pass",
  "passed": true
}
```

When `--host-goal-json` is provided, the snapshot must have a matching objective
and `status:"complete"`. When no host snapshot exists, artifact-backed Omagy
state remains authoritative.