OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

control-plane.approval

Human approval and rejection gates for execution steps.

  • Type: capability (capability)
  • Version: 1.0.0
  • Tags: approval
  • File: packages/libs/contracts-spec/src/control-plane/capabilities/controlPlaneApproval.capability.ts
  • field.key.label
    control-plane.approval
    field.version.label
    1.0.0
    field.type.label
    capability (capability)
    field.title.label
    control-plane.approval
    field.description.label

    Human approval and rejection gates for execution steps.

  • Type: capability (capability)
  • Version: 1.0.0
  • Tags: approval
  • File: packages/libs/contracts-spec/src/control-plane/capabilities/controlPlaneApproval.capability.ts
  • field.tags.label
    approval
    field.owners.label
    field.stability.label

    Human approval and rejection gates for execution steps.

    Source Definition

    import { defineCapability } from '../../capabilities';
    import {
    	CONTROL_PLANE_DOMAIN,
    	CONTROL_PLANE_OWNERS,
    	CONTROL_PLANE_STABILITY,
    	CONTROL_PLANE_TAGS,
    } from '../constants';
    
    export const ControlPlaneApprovalCapability = defineCapability({
    	meta: {
    		key: 'control-plane.approval',
    		version: '1.0.0',
    		kind: 'integration',
    		title: 'Control Plane Approval',
    		description: 'Human approval and rejection gates for execution steps.',
    		domain: CONTROL_PLANE_DOMAIN,
    		owners: CONTROL_PLANE_OWNERS,
    		tags: [...CONTROL_PLANE_TAGS, 'approval'],
    		stability: CONTROL_PLANE_STABILITY,
    	},
    	requires: [
    		{
    			key: 'control-plane.core',
    			version: '1.0.0',
    			reason: 'Approval decisions are applied on core execution records.',
    		},
    	],
    	provides: [
    		{
    			surface: 'operation',
    			key: 'controlPlane.execution.approve',
    			version: '1.0.0',
    			description: 'Approve a pending step.',
    		},
    		{
    			surface: 'operation',
    			key: 'controlPlane.execution.reject',
    			version: '1.0.0',
    			description: 'Reject a pending step.',
    		},
    		{
    			surface: 'event',
    			key: 'controlPlane.execution.step.blocked',
    			version: '1.0.0',
    			description: 'Step blocked by policy or operator decision.',
    		},
    	],
    });