haops_preview_project_protocol
Preview project protocol without persisting changes. Verify that template and skill configurations resolve correctly before applying updates.
Instructions
Dry-run the composed-protocol resolver for a project role — returns the assembled manifest as if PUT had been applied, WITHOUT persisting. Use BEFORE haops_update_protocol to verify that the new templateId / skillsConfig combo resolves correctly and has no warnings.
When called with no optional params, previews the current protocol settings (useful for a sanity-check without triggering a version bump).
The response shape mirrors haops_read_protocol (mode, coreContent/body, skillRefs, warnings). The server adds preview: true to distinguish the response from a real read.
Requires ENABLE_COMPOSED_PROTOCOLS=true on the server. Returns 404 when the feature flag is off (the route looks absent, by design) — surface this as "Composed protocols feature is disabled" to the user.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | If true, return the raw JSON envelope verbatim instead of the formatted text summary (default: false). | |
| role | Yes | Agent role to resolve the protocol for. | |
| templateId | No | Optional. UUID of the role template to resolve against. When omitted, the project's current templateId is used. | |
| projectSlug | Yes | URL slug of the target project (e.g. "fdev", "knf"). | |
| customContent | No | Optional. Custom markdown appended after the template body. Leave unset to use the project's current customContent. | |
| enabledSkillIds | No | Optional. UUIDs of skills to enable in the preview (merged with template defaults). Leave unset to use the project's current enabledSkillIds. | |
| disabledSkillIds | No | Optional. UUIDs of skills to disable in the preview. Leave unset to use the project's current disabledSkillIds. |