PKPEEK Docs
Docs/Workflows, rules & reference

Catalog lifecycle: draft, review, publish

How every “Publish …” screen works: draft, validation, independent technical review bound to the diff hash, then publish.

PEEK Platform Administrator · PEEK Technical Reviewer

/peek/customers/tenant-a/1-10
Live walkthrough · Catalog lifecycle: draft, review, publish
/peek/customers/tenant-a/1-10
/peek/customers/tenant-a/2-1
/peek/customers/tenant-a/5-2
/peek/customers/tenant-a/6-2

Global catalogs carry no tenant content and never adopt themselves for a tenant — agency adoption is a separate agency command. Ten catalog types share one lifecycle:

Catalog typeScreenPublish capability
capability1.10catalog.publish
role2.1role_catalog.publish
persona2.2persona_catalog.publish
workflow3.4workflow_catalog.publish
document_template3.6template_catalog.publish
si_profile4.2si_profile.publish
agent_template5.2agent_template.publish
connector6.2connector_catalog.publish
experience_template7.2experience_template.publish
component7.5component_catalog.publish

Lifecycle

  1. 1. Save draft

    catalog.save_draft — the preparer edits content; structural validation lists blocking issues and non-blocking notices.

  2. 2. Independent review

    catalog.review — a PEEK Technical Reviewer who did not prepare it approves or returns the exact diff hash.

  3. 3. Publish

    publish_catalog — requires the type’s publish capability and a matching approval; a new version becomes available for agency adoption.

Heads up — Edits after review change the hash and invalidate the approval. Publishing never changes any agency’s adopted configuration.