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.

AI index

controlPlane.policy.explain

Explain policy outcomes for an execution or step.

  • Type: operation (query)
  • Version: 1.0.0
  • Tags: policy, audit
  • File: packages/libs/contracts-spec/src/control-plane/queries/controlPlanePolicyExplain.query.ts
    • field.key.label
    controlPlane.policy.explain
    field.version.label
    1.0.0
    field.type.label
    operation (query)
    field.title.label
    controlPlane.policy.explain
    field.description.label

    Explain policy outcomes for an execution or step.

  • Type: operation (query)
  • Version: 1.0.0
  • Tags: policy, audit
  • File: packages/libs/contracts-spec/src/control-plane/queries/controlPlanePolicyExplain.query.ts
    • field.tags.label
    policy,audit
    field.owners.label
    field.stability.label

    Explain policy outcomes for an execution or step.

    Goal

    Make governance decisions auditable and understandable.

    Context

    Used in operator UIs and incident review to inspect verdict rationale.

    Source Definition

    import { ScalarTypeEnum, SchemaModel } from '@lssm-tech/lib.schema';
import { defineQuery } from '../../operations';
import {
	CONTROL_PLANE_DOMAIN,
	CONTROL_PLANE_OWNERS,
	CONTROL_PLANE_STABILITY,
	CONTROL_PLANE_TAGS,
} from '../constants';

export const ControlPlanePolicyExplainQuery = defineQuery({
	meta: {
		key: 'controlPlane.policy.explain',
		title: 'Explain Policy Verdict',
		version: '1.0.0',
		description: 'Explain policy outcomes for an execution or step.',
		goal: 'Make governance decisions auditable and understandable.',
		context:
			'Used in operator UIs and incident review to inspect verdict rationale.',
		domain: CONTROL_PLANE_DOMAIN,
		owners: CONTROL_PLANE_OWNERS,
		tags: [...CONTROL_PLANE_TAGS, 'policy', 'audit'],
		stability: CONTROL_PLANE_STABILITY,
	},
	capability: {
		key: 'control-plane.audit',
		version: '1.0.0',
	},
	io: {
		input: ControlPlanePolicyExplainInput,
		output: ControlPlanePolicyExplainOutput,
	},
	policy: {
		auth: 'admin',
		pii: [],
	},
});