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.
Start a harness run for a scenario or suite.
Goal
Launch a bounded, evidence-producing harness session.
Context
Used by agents, QA flows, and evaluation runners.
Source Definition
import { ScalarTypeEnum, SchemaModel } from '@lssm-tech/lib.schema';
import { defineCommand } from '../../operations';
import {
HARNESS_DOMAIN,
HARNESS_OWNERS,
HARNESS_STABILITY,
HARNESS_TAGS,
} from '../constants';
import { HarnessRunStartedEvent } from '../events/harnessRunStarted.event';
import { HarnessRunModel } from '../models';
export const HarnessRunStartCommand = defineCommand({
meta: {
key: 'harness.run.start',
title: 'Start Harness Run',
version: '1.0.0',
description: 'Start a harness run for a scenario or suite.',
goal: 'Launch a bounded, evidence-producing harness session.',
context: 'Used by agents, QA flows, and evaluation runners.',
domain: HARNESS_DOMAIN,
owners: HARNESS_OWNERS,
tags: [...HARNESS_TAGS, 'run', 'start'],
stability: HARNESS_STABILITY,
},
capability: { key: 'harness.execution', version: '1.0.0' },
io: {
input: HarnessRunStartInput,
output: HarnessRunStartOutput,
errors: {
SCENARIO_OR_SUITE_REQUIRED: {
description: 'A scenario or suite key is required.',
http: 400,
when: 'Neither scenarioKey nor suiteKey is provided.',
},
},
},
policy: {
auth: 'user',
pii: [],
},
sideEffects: {
emits: [
{
ref: HarnessRunStartedEvent.meta,
when: 'A new harness run is created and execution begins.',
},
],
},
});