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.

controlPlane.plan.compile

Compile an intent into a deterministic plan DAG.

  • Type: operation (command)
  • Version: 1.0.0
  • Tags: plan
  • File: packages/libs/contracts-spec/src/control-plane/commands/controlPlanePlanCompile.command.ts
  • field.key.label
    controlPlane.plan.compile
    field.version.label
    1.0.0
    field.type.label
    operation (command)
    field.title.label
    controlPlane.plan.compile
    field.description.label

    Compile an intent into a deterministic plan DAG.

  • Type: operation (command)
  • Version: 1.0.0
  • Tags: plan
  • File: packages/libs/contracts-spec/src/control-plane/commands/controlPlanePlanCompile.command.ts
  • field.tags.label
    plan
    field.owners.label
    field.stability.label

    Compile an intent into a deterministic plan DAG.

    Goal

    Prevent freeform tool execution by requiring typed plan compilation.

    Context

    Executed after intent submission to produce executable, traceable steps.

    Source Definition

    export const ControlPlanePlanCompileCommand = defineCommand({
      meta: {
        key: 'controlPlane.plan.compile',
        title: 'Compile Plan',
        version: '1.0.0',
        description: 'Compile an intent into a deterministic plan DAG.',
        goal: 'Prevent freeform tool execution by requiring typed plan compilation.',
        context:
          'Executed after intent submission to produce executable, traceable steps.',
        domain: CONTROL_PLANE_DOMAIN,
        owners: CONTROL_PLANE_OWNERS,
        tags: [...CONTROL_PLANE_TAGS, 'plan'],
        stability: CONTROL_PLANE_STABILITY,
      },
      capability: {
        key: 'control-plane.core',
        version: '1.0.0',
      },
      io: {
        input: ControlPlanePlanCompileInput,
        output: ControlPlanePlanCompileOutput,
        errors: {
          INTENT_NOT_FOUND: {
            description: 'The referenced intent does not exist.',
            http: 404,
            when: 'intentId cannot be resolved for the execution context.',
          },
        },
      },
      policy: {
        auth: 'admin',
        pii: [],
      },
      sideEffects: {
        emits: [
          {
            ref: ControlPlanePlanCompiledEvent.meta,
            when: 'Plan compilation completes with a valid deterministic DAG.',
          },
        ],
      },
    });