feat: Publish 2.0 control-plane readiness summary#632
Conversation
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request updates the documentation to define the 2.0 control-plane surface, detailing stable contracts for goal management, workspace health, and agent adapter boundaries. The changes include updates to the README and the product roadmap to reflect a CLI-first, evidence-backed completion model. Feedback suggests improving the roadmap's consistency by explicitly including schema version names like ticket-status/v1, worker-handoff/v1, and goal-finish-receipt/v1 in the contract tables.
|
|
||
| | Area | Ready surface | | ||
| | --- | --- | | ||
| | State-aware ticket runtime | Current ticket/PR resolution, structured ticket status JSON, action-oriented next steps, role packets, review packets, and lifecycle dry-run/apply commands. | |
There was a problem hiding this comment.
To maintain consistency with the other rows in this table that use explicit schema names (like goal-status/v1 or workspace-queues/v1), it would be helpful to include the schema names for the ticket status JSON (ticket-status/v1) and role packets (worker-handoff/v1).
| | State-aware ticket runtime | Current ticket/PR resolution, structured ticket status JSON, action-oriented next steps, role packets, review packets, and lifecycle dry-run/apply commands. | | |
| | State-aware ticket runtime | Current ticket/PR resolution, `ticket-status/v1`, action-oriented next steps, `worker-handoff/v1` role packets, review packets, and lifecycle dry-run/apply commands. | |
| | --- | --- | | ||
| | State-aware ticket runtime | Current ticket/PR resolution, structured ticket status JSON, action-oriented next steps, role packets, review packets, and lifecycle dry-run/apply commands. | | ||
| | Evidence-based finish and audit | Ticket readiness, PR readiness, finish readiness, finish receipts, telemetry/provenance guidance, and workflow drift audit reports. | | ||
| | Goal mode | `goal-status/v1`, `goal-next/v1`, `goal-plan/v1`, `goal-finish-readiness/v1`, and idempotent human-review handoff receipts over child ticket graphs. | |
There was a problem hiding this comment.
The schema name goal-finish-receipt/v1 is missing from the list of stable contracts for Goal mode. Including it would be consistent with the other versioned schemas listed in this row and throughout the table.
| | Goal mode | `goal-status/v1`, `goal-next/v1`, `goal-plan/v1`, `goal-finish-readiness/v1`, and idempotent human-review handoff receipts over child ticket graphs. | | |
| | Goal mode | `goal-status/v1`, `goal-next/v1`, `goal-plan/v1`, `goal-finish-readiness/v1`, `goal-finish-receipt/v1`, and idempotent human-review handoff receipts over child ticket graphs. | |
1 participant
Closes #631