New authoring has one source format: PackDescriptor. Start in Pack Studio or
use the same Draft APIs; do not use a kind: ResourcePack compatibility document.
contract_version: 2
coordinate: { pack: acme/review, version: 1.0.0 }
tier: domain
name: Review workforce
description: One accountable review workflow
icon: lucide:badge-check
components:
- key: review
summary: Terminal review contract
declaration:
kind: workflow
definition:
name: Review
description: Accept a reviewed result
icon: lucide:badge-check
start: done
states:
done:
name: Done
description: Result accepted
icon: lucide:circle-check
state_group: done
completion: completed
transitions: []
Add dependencies as exact locked Pack coordinates and reference imported members
with author references. Add only resource_type, workflow, automation,
agent, or environment component declarations. A Solution also needs a non-empty installation
default_roots, and every selection default must satisfy its min/max bounds.
Draft-to-release path
- Create a Draft with
POST /api/pack-studio/drafts. - Save a revision at
/api/pack-studio/drafts/{draft_id}/revisionswith the expected head, message, and complete descriptor. - Validate at
/validate. Resolve every contract, dependency-closure, owner-admission, installation, Bootstrap, and runtime-interaction error. - Inspect the revision diff, request review, and approve the exact Draft head.
- Publish the approved head. Workforce canonicalizes compact JSON, signs immutable bytes, and projects the verified tier into Registry metadata.
- Import the complete exact closure, then adopt only the explicit roots the Project needs. Configure credentials and Environment activations separately.
Exact retry converges through Draft heads, content addresses, Registry immutability, and import idempotency. Any validation failure terminates before publication or installation; fix the Draft and create a new revision rather than editing released bytes.