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

kbPipeline.publishIfReady

Publish snapshot if ready (all approvals satisfied).

  • Type: operation (command)
  • Version: 1.0.0
  • Stability: experimental
  • Owners: @examples
  • Tags: knowledge, pipeline, publishing
  • File: packages/examples/kb-update-pipeline/src/operations/pipeline.ts
    • field.key.label
    kbPipeline.publishIfReady
    field.version.label
    1.0.0
    field.type.label
    operation (command)
    field.title.label
    kbPipeline.publishIfReady
    field.description.label

    Publish snapshot if ready (all approvals satisfied).

  • Type: operation (command)
  • Version: 1.0.0
  • Stability: experimental
  • Owners: @examples
  • Tags: knowledge, pipeline, publishing
  • File: packages/examples/kb-update-pipeline/src/operations/pipeline.ts
    • field.tags.label
    knowledge,pipeline,publishing
    field.owners.label
    @examples
    field.stability.label
    experimental

    Publish snapshot if ready (all approvals satisfied).

    Goal

    Prevent publishing until all required approvals exist.

    Context

    Called by job or UI to attempt publish.

    Source Definition

    import { defineCommand } from '@lssm-tech/lib.contracts-spec';
import { defineSchemaModel, ScalarTypeEnum } from '@lssm-tech/lib.schema';
import {
	ChangeCandidateModel,
	ReviewDecisionEnum,
	ReviewTaskModel,
} from '../entities/models';

export const KbPipelinePublishIfReadyContract = defineCommand({
	meta: {
		key: 'kbPipeline.publishIfReady',
		version: '1.0.0',
		stability: 'experimental',
		owners: ['@examples'],
		tags: ['knowledge', 'pipeline', 'publishing'],
		description: 'Publish snapshot if ready (all approvals satisfied).',
		goal: 'Prevent publishing until all required approvals exist.',
		context: 'Called by job or UI to attempt publish.',
	},
	io: {
		input: PublishIfReadyInput,
		output: PublishIfReadyOutput,
		errors: {
			NOT_READY: {
				description: 'Publishing is blocked because approvals are incomplete',
				http: 409,
				gqlCode: 'NOT_READY',
				when: 'there are open review tasks or unapproved rule versions',
			},
		},
	},
	policy: { auth: 'user' },
});