@jterrats/open-orchestra 1.0.15 → 1.0.17

package/dist/report-model.d.ts

@@ -0,0 +1,22 @@
+export type ReportSectionKind = "summary" | "findings" | "decisions" | "risks" | "evidence" | "nextSteps";
+export type ReportItemSeverity = "info" | "low" | "medium" | "high" | "critical";
+export interface ReportItem {
+    id: string;
+    text: string;
+    severity?: ReportItemSeverity;
+    owner?: string;
+    status?: string;
+}
+export interface ReportSection {
+    id: string;
+    kind: ReportSectionKind;
+    title: string;
+    body?: string;
+    items?: ReportItem[];
+}
+export interface ReportDocument {
+    id: string;
+    title: string;
+    summary: string;
+    sections: ReportSection[];
+}

package/dist/report-model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=report-model.js.map

package/dist/report-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-model.js","sourceRoot":"","sources":["../src/report-model.ts"],"names":[],"mappings":""}

package/dist/report-render-markdown.d.ts

@@ -0,0 +1 @@
+export declare function renderReportMarkdown(payload: unknown): string;

package/dist/report-render-markdown.js

@@ -0,0 +1,40 @@
+import { validateReportDocumentPayload } from "./report-schema.js";
+export function renderReportMarkdown(payload) {
+    const report = validateReportDocumentPayload(payload);
+    return [
+        `# ${escapeMarkdown(report.title)}`,
+        "",
+        escapeMarkdown(report.summary),
+        "",
+        ...report.sections.flatMap(renderSection),
+    ]
+        .join("\n")
+        .trimEnd()
+        .concat("\n");
+}
+function renderSection(section) {
+    return [
+        `## ${escapeMarkdown(section.title)}`,
+        "",
+        ...(section.body ? [escapeMarkdown(section.body), ""] : []),
+        ...renderItems(section.items ?? []),
+    ];
+}
+function renderItems(items) {
+    if (items.length === 0)
+        return [];
+    return [...items.map(renderItem), ""];
+}
+function renderItem(item) {
+    const metadata = [
+        item.severity ? `severity: ${item.severity}` : "",
+        item.status ? `status: ${item.status}` : "",
+        item.owner ? `owner: ${item.owner}` : "",
+    ].filter(Boolean);
+    const suffix = metadata.length > 0 ? ` (${metadata.join(", ")})` : "";
+    return `- ${escapeMarkdown(item.text)}${suffix}`;
+}
+function escapeMarkdown(value) {
+    return value.replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+//# sourceMappingURL=report-render-markdown.js.map

package/dist/report-render-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-render-markdown.js","sourceRoot":"","sources":["../src/report-render-markdown.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,MAAM,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IACtD,OAAO;QACL,KAAK,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QACnC,EAAE;QACF,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC;QAC9B,EAAE;QACF,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC;KAC1C;SACE,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,EAAE;SACT,MAAM,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,OAAsB;IAC3C,OAAO;QACL,MAAM,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACrC,EAAE;QACF,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAmB;IACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,IAAgB;IAClC,MAAM,QAAQ,GAAG;QACf,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;QACjD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;QAC3C,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;KACzC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,OAAO,KAAK,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC"}

package/dist/report-schema.d.ts

@@ -0,0 +1,2 @@
+import type { ReportDocument } from "./report-model.js";
+export declare function validateReportDocumentPayload(payload: unknown): ReportDocument;

package/dist/report-schema.js

@@ -0,0 +1,109 @@
+import { assertNoStructuredOutputIssues, } from "./structured-output-validation.js";
+const SECTION_KINDS = [
+    "summary",
+    "findings",
+    "decisions",
+    "risks",
+    "evidence",
+    "nextSteps",
+];
+const ITEM_SEVERITIES = [
+    "info",
+    "low",
+    "medium",
+    "high",
+    "critical",
+];
+export function validateReportDocumentPayload(payload) {
+    const issues = [];
+    if (!isObjectMap(payload)) {
+        fail(issues, "$", "must be a report object");
+        assertNoStructuredOutputIssues("report", issues);
+        throw new Error("unreachable report validation state");
+    }
+    validateReportRoot(payload, issues);
+    assertNoStructuredOutputIssues("report", issues);
+    return payload;
+}
+function validateReportRoot(value, issues) {
+    requireString(value, "id", "$", issues);
+    requireString(value, "title", "$", issues);
+    requireString(value, "summary", "$", issues);
+    validateSections(value.sections, issues);
+}
+function validateSections(value, issues) {
+    if (!Array.isArray(value) || value.length === 0) {
+        fail(issues, "$.sections", "must be a non-empty array");
+        return;
+    }
+    const ids = new Set();
+    value.forEach((section, index) => validateSection(section, index, ids, issues));
+}
+function validateSection(value, index, ids, issues) {
+    const path = `$.sections[${index}]`;
+    if (!isObjectMap(value))
+        return fail(issues, path, "must be an object");
+    const id = requireString(value, "id", path, issues);
+    if (id && ids.has(id))
+        fail(issues, `${path}.id`, "must be unique");
+    if (id)
+        ids.add(id);
+    requireEnum(value, "kind", path, SECTION_KINDS, issues);
+    requireString(value, "title", path, issues);
+    optionalString(value, "body", path, issues);
+    validateItems(value.items, `${path}.items`, issues);
+}
+function validateItems(value, path, issues) {
+    if (value === undefined)
+        return;
+    if (!Array.isArray(value))
+        return fail(issues, path, "must be an array when provided");
+    const ids = new Set();
+    value.forEach((item, index) => validateItem(item, `${path}[${index}]`, ids, issues));
+}
+function validateItem(value, path, ids, issues) {
+    if (!isObjectMap(value))
+        return fail(issues, path, "must be an object");
+    const id = requireString(value, "id", path, issues);
+    if (id && ids.has(id))
+        fail(issues, `${path}.id`, "must be unique within section");
+    if (id)
+        ids.add(id);
+    requireString(value, "text", path, issues);
+    optionalString(value, "owner", path, issues);
+    optionalString(value, "status", path, issues);
+    optionalEnum(value, "severity", path, ITEM_SEVERITIES, issues);
+}
+function isObjectMap(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireString(value, key, path, issues) {
+    const field = value[key];
+    if (typeof field === "string" && field.trim() !== "")
+        return field;
+    fail(issues, `${path}.${key}`, "must be a non-empty string");
+    return undefined;
+}
+function optionalString(value, key, path, issues) {
+    if (value[key] !== undefined && typeof value[key] !== "string") {
+        fail(issues, `${path}.${key}`, "must be a string when provided");
+    }
+}
+function requireEnum(value, key, path, allowed, issues) {
+    const field = value[key];
+    if (typeof field === "string" && allowed.includes(field))
+        return;
+    fail(issues, `${path}.${key}`, `must be one of: ${allowed.join(", ")}`);
+}
+function optionalEnum(value, key, path, allowed, issues) {
+    const field = value[key];
+    if (field === undefined)
+        return;
+    if (typeof field === "string" && allowed.includes(field))
+        return;
+    fail(issues, `${path}.${key}`, `must be one of: ${allowed.join(", ")}`);
+}
+function fail(issues, path, message) {
+    issues.push({ path, message });
+}
+//# sourceMappingURL=report-schema.js.map

package/dist/report-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-schema.js","sourceRoot":"","sources":["../src/report-schema.ts"],"names":[],"mappings":"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"}

package/dist/rule-catalog.d.ts

@@ -0,0 +1,33 @@
+import type { SkillRenderTarget } from "./types.js";
+export interface RuleDefinition {
+    id: string;
+    title: string;
+    summary: string;
+    canonicalPath: string;
+    renderedPaths?: Partial<Record<SkillRenderTarget, string>>;
+    roles: string[];
+    capabilities: string[];
+    triggers: string[];
+    riskAreas: string[];
+}
+export interface RuleSelectionInput {
+    role: string;
+    capabilities?: string[];
+    signals?: string[];
+    target?: SkillRenderTarget;
+}
+export interface RuleSelection {
+    rule: RuleDefinition;
+    path: string;
+    score: number;
+    rationale: string[];
+}
+export declare const DEFAULT_RULE_TARGET: SkillRenderTarget;
+export declare const defaultRuleCatalog: RuleDefinition[];
+export declare const ROLE_RULE_IDS: Record<string, string[]>;
+export declare function listRuleDefinitions(): RuleDefinition[];
+export declare function getRuleDefinition(id: string): RuleDefinition | undefined;
+export declare function rulePathForTarget(rule: RuleDefinition, target?: SkillRenderTarget): string;
+export declare function rulePathsForIds(ids: string[], target?: SkillRenderTarget): string[];
+export declare function rulePathsForRole(role: string, target?: SkillRenderTarget): string[];
+export declare function selectRulesForRuntime(input: RuleSelectionInput): RuleSelection[];

package/dist/rule-catalog.js

@@ -0,0 +1,215 @@
+export const DEFAULT_RULE_TARGET = "generic";
+export const defaultRuleCatalog = [
+    {
+        id: "semantic-code",
+        title: "Semantic Code",
+        summary: "Code should be readable by intent through domain names, narrow types, and clear module boundaries.",
+        canonicalPath: "rules/development/semantic-code.md",
+        roles: ["developer", "qa", "sdet", "devops", "architect"],
+        capabilities: ["implementation", "code", "automation", "review"],
+        triggers: [
+            "code",
+            "implementation",
+            "refactor",
+            "script",
+            "test",
+            "automation",
+        ],
+        riskAreas: ["maintainability", "quality"],
+    },
+    {
+        id: "development-engineering",
+        title: "Development Engineering",
+        summary: "Stack-agnostic implementation standards for service, integration, async, and testable code.",
+        canonicalPath: "rules/development-engineering.mdc",
+        renderedPaths: { cursor: "rules/development-engineering.mdc" },
+        roles: ["developer", "architect"],
+        capabilities: ["implementation", "code", "architecture-review"],
+        triggers: [
+            "service",
+            "integration",
+            "entry point",
+            "async",
+            "implementation",
+        ],
+        riskAreas: ["maintainability", "integration", "performance"],
+    },
+    {
+        id: "dry-clean-code",
+        title: "DRY Clean Code",
+        summary: "Duplication, naming, hardcoded data, and readability standards.",
+        canonicalPath: "rules/dry-clean-code.mdc",
+        renderedPaths: { cursor: "rules/dry-clean-code.mdc" },
+        roles: ["developer"],
+        capabilities: ["implementation", "code"],
+        triggers: ["duplication", "hardcoded", "helper", "refactor"],
+        riskAreas: ["maintainability"],
+    },
+    {
+        id: "module-boundaries",
+        title: "Module Boundaries",
+        summary: "Domain, service, adapter, and entry-point boundary rules.",
+        canonicalPath: "rules/module-boundaries.mdc",
+        renderedPaths: { cursor: "rules/module-boundaries.mdc" },
+        roles: ["developer", "architect"],
+        capabilities: ["implementation", "architecture-review"],
+        triggers: ["domain", "service", "adapter", "boundary", "god file"],
+        riskAreas: ["architecture", "maintainability"],
+    },
+    {
+        id: "testing-discipline",
+        title: "Testing Discipline",
+        summary: "Unit, integration, E2E, and evidence expectations.",
+        canonicalPath: "rules/testing-discipline.mdc",
+        renderedPaths: { cursor: "rules/testing-discipline.mdc" },
+        roles: ["developer", "qa", "sdet"],
+        capabilities: ["test", "testing", "automation", "qa-evidence"],
+        triggers: ["test", "unit", "e2e", "playwright", "coverage", "qa"],
+        riskAreas: ["quality"],
+    },
+    {
+        id: "delivery-quality-gates",
+        title: "Delivery Quality Gates",
+        summary: "Definition of ready, definition of done, evidence, and release gate rules.",
+        canonicalPath: "rules/delivery-quality-gates.mdc",
+        renderedPaths: { cursor: "rules/delivery-quality-gates.mdc" },
+        roles: ["qa", "sdet", "release_manager"],
+        capabilities: ["qa-evidence", "release"],
+        triggers: ["gate", "release", "evidence", "handoff", "go no-go"],
+        riskAreas: ["quality", "release", "governance"],
+    },
+    {
+        id: "agent-collaboration",
+        title: "Agent Collaboration",
+        summary: "Handoff, review, and cross-role collaboration rules.",
+        canonicalPath: "rules/agent-collaboration.mdc",
+        renderedPaths: { cursor: "rules/agent-collaboration.mdc" },
+        roles: ["qa", "product_owner", "architect", "developer"],
+        capabilities: ["workflow-discipline", "auditability"],
+        triggers: ["handoff", "review", "phase", "collaboration"],
+        riskAreas: ["governance"],
+    },
+    {
+        id: "architecture-decisions",
+        title: "Architecture Decisions",
+        summary: "Architecture decision, ADR, trade-off, and technical boundary rules.",
+        canonicalPath: "rules/architecture-decisions.mdc",
+        renderedPaths: { cursor: "rules/architecture-decisions.mdc" },
+        roles: ["architect"],
+        capabilities: ["architecture-review"],
+        triggers: ["architecture", "adr", "decision", "trade off"],
+        riskAreas: ["architecture", "maintainability"],
+    },
+    {
+        id: "release-rollback",
+        title: "Release Rollback",
+        summary: "Release, rollback, monitoring, and go/no-go rules.",
+        canonicalPath: "rules/release-rollback.mdc",
+        renderedPaths: { cursor: "rules/release-rollback.mdc" },
+        roles: ["release_manager"],
+        capabilities: ["release", "deployment", "rollback"],
+        triggers: ["release", "rollback", "deploy", "publish"],
+        riskAreas: ["release"],
+    },
+];
+export const ROLE_RULE_IDS = {
+    developer: [
+        "semantic-code",
+        "development-engineering",
+        "dry-clean-code",
+        "module-boundaries",
+        "testing-discipline",
+    ],
+    qa: [
+        "semantic-code",
+        "testing-discipline",
+        "delivery-quality-gates",
+        "agent-collaboration",
+    ],
+    sdet: [
+        "semantic-code",
+        "testing-discipline",
+        "delivery-quality-gates",
+        "agent-collaboration",
+    ],
+    architect: [
+        "semantic-code",
+        "architecture-decisions",
+        "module-boundaries",
+        "development-engineering",
+    ],
+    devops: ["semantic-code", "development-engineering"],
+    release_manager: ["release-rollback", "delivery-quality-gates"],
+};
+export function listRuleDefinitions() {
+    return defaultRuleCatalog.map(cloneRule);
+}
+export function getRuleDefinition(id) {
+    const rule = defaultRuleCatalog.find((candidate) => candidate.id === id);
+    return rule ? cloneRule(rule) : undefined;
+}
+export function rulePathForTarget(rule, target = DEFAULT_RULE_TARGET) {
+    return rule.renderedPaths?.[target] ?? rule.canonicalPath;
+}
+export function rulePathsForIds(ids, target = DEFAULT_RULE_TARGET) {
+    return ids
+        .map((id) => getRuleDefinition(id))
+        .filter((rule) => Boolean(rule))
+        .map((rule) => rulePathForTarget(rule, target));
+}
+export function rulePathsForRole(role, target = DEFAULT_RULE_TARGET) {
+    return rulePathsForIds(ROLE_RULE_IDS[role] ?? [], target);
+}
+export function selectRulesForRuntime(input) {
+    const role = input.role;
+    const capabilities = new Set((input.capabilities ?? []).map(normalize));
+    const signalText = normalize((input.signals ?? []).join(" "));
+    const roleRuleIds = new Set(ROLE_RULE_IDS[role] ?? []);
+    return defaultRuleCatalog
+        .map((rule) => {
+        const rationale = [];
+        let score = 0;
+        if (roleRuleIds.has(rule.id) || rule.roles.includes(role)) {
+            score += 3;
+            rationale.push(`role match: ${role}`);
+        }
+        const matchedCapabilities = rule.capabilities.filter((capability) => capabilities.has(normalize(capability)));
+        if (matchedCapabilities.length > 0) {
+            score += matchedCapabilities.length;
+            rationale.push(`capability match: ${matchedCapabilities.join(", ")}`);
+        }
+        const matchedTriggers = rule.triggers.filter((trigger) => signalText.includes(normalize(trigger)));
+        if (matchedTriggers.length > 0) {
+            score += matchedTriggers.length * 2;
+            rationale.push(`signal match: ${matchedTriggers.join(", ")}`);
+        }
+        return {
+            rule: cloneRule(rule),
+            path: rulePathForTarget(rule, input.target),
+            score,
+            rationale,
+        };
+    })
+        .filter((selection) => selection.score > 0)
+        .sort((left, right) => right.score - left.score || left.rule.id.localeCompare(right.rule.id));
+}
+function cloneRule(rule) {
+    const clone = {
+        ...rule,
+        roles: rule.roles.slice(),
+        capabilities: rule.capabilities.slice(),
+        triggers: rule.triggers.slice(),
+        riskAreas: rule.riskAreas.slice(),
+    };
+    if (rule.renderedPaths) {
+        clone.renderedPaths = { ...rule.renderedPaths };
+    }
+    return clone;
+}
+function normalize(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, " ")
+        .trim();
+}
+//# sourceMappingURL=rule-catalog.js.map

package/dist/rule-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-catalog.js","sourceRoot":"","sources":["../src/rule-catalog.ts"],"names":[],"mappings":"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"}

package/dist/runtime-bootstrap.js

@@ -37,12 +37,20 @@ export function renderRuntimeBootstrap(target = "generic") {
         "```",
         "orchestra estimate --task <ID> --sizing <xs|s|m|l|xl> --solo-days <N> --ai-unguided-days <N> --ai-guided-days <N>",
         "```",
+        "Do not run `orchestra workflow run` until this estimate is recorded; an unestimated task signals incomplete planning.",
         "",
         "### Step 3 — Run the autonomous workflow",
         "```",
         "orchestra workflow run --task <ID> --gates phase",
         "```",
         "The workflow sequences PM → PO → Architect → Developer → QA → Release.",
+        "Execution mode is selected from sizing when no explicit `--phase-execution` is provided:",
+        "- `xs` (1 point): `single-agent` so all phases run inline without spawn overhead.",
+        "- `s` (2–3 points): `single-agent` by default; use `subagents` when the work is separable.",
+        "- `m`, `l`, `xl`: `subagents` so phase work is isolated and reviewable.",
+        "For xs/s tasks, prefer `orchestra workflow run --task <ID> --gates phase --phase-execution single-agent` when you need to be explicit. The parent agent still produces handoffs, evidence, and reviews for every phase.",
+        "The agent (Claude Code) is responsible for executing every phase in sequence — acting as PM, then PO, then Architect, then Developer, then QA, then Release — before marking work complete.",
+        'Never pass `--from-phase`, `--skip-phases`, or any phase-shortcut flag. If a phase seems irrelevant, record a bypass rationale with `orchestra validate --pre-run --task <ID> --bypass --bypass-rationale "..."` instead.',
         "Gates pause at `po→architect` and `qa→release` for human review.",
         "The architect phase requires a sizing decision before proceeding:",
         "```",
@@ -61,6 +69,7 @@ export function renderRuntimeBootstrap(target = "generic") {
         "```",
         "orchestra workflow run --task <ID> --resume <run-id>",
         "```",
+        "At a `po→architect` or `qa→release` gate, stop work, surface the handoff artifact to the user, and wait for explicit approval before resuming — do not self-approve or continue autonomously.",
         "Gate approval is not automatic. Before approving `po→architect`, verify the GitHub issue or Orchestra task has user-validated acceptance criteria, non-goals, assumptions, priority, and sizing context.",
         "Before approving `qa→release`, verify real implementation evidence exists: changed files, exact validation commands, test results, QA findings, BA/PO acceptance, and Architect review when technical contracts changed.",
         "If a generated handoff says `Acceptance Criteria: none`, treat it as incomplete. Pull criteria from the linked issue/task, record a review finding, and do not approve release until the gap is fixed or explicitly risk-accepted.",
@@ -69,6 +78,7 @@ export function renderRuntimeBootstrap(target = "generic") {
         "```",
         "orchestra benchmark --task <ID>",
         "```",
+        "A task is not complete until `orchestra benchmark` has run. Do not close the task or mark it done beforehand.",
         "",
         "## Active Work",
         "- At session start, run `orchestra health --json` before implementation or file edits.",
@@ -76,12 +86,13 @@ export function renderRuntimeBootstrap(target = "generic") {
         "- For the active task, run context, delegation, plan, skills, protocol, and workflow render commands.",
         "- Run `orchestra validate --pre-run --task <ID> --json` before implementation; resolve missing estimate, workflow run, evidence, or review checks.",
         '- If a user accepts a smaller/advisory path, record it with `orchestra validate --pre-run --task <ID> --bypass --bypass-rationale "..."`.',
+        "- After `orchestra workflow run` completes a phase or reports a pending action, immediately run `orchestra runtime parent-actions --task <ID> --json` and dispatch any actionable `claude-agent-request` items before continuing.",
         ...recurringPreflightLines(target),
         "",
         "## Runtime-Native Background Spawn",
         "- When a workflow phase returns `completionMode=detached`, keep the parent conversation available and do not block on the child unless the user explicitly asks to wait.",
         "- After `orchestra workflow run` reports a pending parent runtime action, immediately inspect `orchestra runtime parent-actions --task <ID> --json` and consume safe actions supported by the active runtime.",
-        "- Codex parent runtimes should call `spawn_agent` for `codex-spawn-agent` actions using the `promptArtifact`, then record `spawned` with the returned agent id.",
+        ...codexSpawnHint(target),
         "- Do not auto-consume actions when the user explicitly asked to pause, when the action is queued, or when the runtime/tool is unavailable or unsafe.",
         "- Use `orchestra runtime spawn-request --task <ID> --role <role> --phase <phase> --run-id <run-id>` to render the assignment packet.",
         "- Record child state with `orchestra runtime spawn-lifecycle --session <session-id> --status <spawned|active|completed|failed> --agent-id <id>`.",
@@ -154,15 +165,29 @@ function bootstrapCommandIds() {
         "summary",
     ]);
 }
+function codexSpawnHint(target) {
+    if (target === "codex") {
+        return [
+            "- Codex parent runtimes should call `spawn_agent` for `codex-spawn-agent` actions using the `promptArtifact`, then record `spawned` with the returned agent id.",
+        ];
+    }
+    return [];
+}
 function recurringPreflightLines(target) {
-    if (target !== "codex") {
-        return [];
+    if (target === "codex") {
+        return [
+            "- Codex recurring preflight: before each new work block and after any context shift, compaction, resume, interruption, or role handoff, rerun `orchestra health --json`, `orchestra task list --json --status pending,blocked,in_progress`, and `orchestra validate --pre-run --task <ID> --json`.",
+            "- Treat `activeOrchestraContext: false` or non-empty `missingActiveContext` from pre-run validation as a drift warning; reload the task context and resume/register the workflow before editing files.",
+            "- Codex has no native recurring hook in this project, so this managed guidance and validation command are the fallback enforcement mechanism.",
+        ];
+    }
+    if (target === "claude") {
+        return [
+            "- Claude recurring preflight: after each phase completes, after a subagent returns, and after any context compaction or session resume, rerun `orchestra health --json` and `orchestra validate --pre-run --task <ID> --json` before continuing.",
+            "- Treat a non-empty `missingActiveContext` or missing workflow run as a signal to re-register or resume the workflow before editing files.",
+        ];
     }
-    return [
-        "- Codex recurring preflight: before each new work block and after any context shift, compaction, resume, interruption, or role handoff, rerun `orchestra health --json`, `orchestra task list --json --status pending,blocked,in_progress`, and `orchestra validate --pre-run --task <ID> --json`.",
-        "- Treat `activeOrchestraContext: false` or non-empty `missingActiveContext` from pre-run validation as a drift warning; reload the task context and resume/register the workflow before editing files.",
-        "- Codex has no native recurring hook in this project, so this managed guidance and validation command are the fallback enforcement mechanism.",
-    ];
+    return [];
 }
 function targetNote(target) {
     const adapter = getRuntimeAdapter(target);

package/dist/runtime-bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-bootstrap.js","sourceRoot":"","sources":["../src/runtime-bootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-bootstrap.js","sourceRoot":"","sources":["../src/runtime-bootstrap.ts"],"names":[],"mappings":"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"}

package/dist/runtime-capacity-policy.d.ts

@@ -0,0 +1,38 @@
+import type { RuntimeCapacityScope, RuntimeCapacityUnit, RuntimeQuotaPolicy, RuntimeScheduleReasonCode, RuntimeScheduleRequest } from "./types.js";
+export type RuntimeCapacityMode = "local" | "saas";
+export declare const LOCAL_RUNTIME_CAPACITY_SCOPE: RuntimeCapacityScope;
+export declare const DEFAULT_RUNTIME_CAPACITY_UNIT: RuntimeCapacityUnit;
+export declare const DEFAULT_RUNTIME_QUOTA_POLICY: RuntimeQuotaPolicy;
+export interface RuntimeCapacityCounters {
+    active: RuntimeScheduleRequest[];
+    queued: RuntimeScheduleRequest[];
+}
+export interface RuntimeCapacityValidation {
+    valid: boolean;
+    scope: RuntimeCapacityScope;
+    reasonCode?: RuntimeScheduleReasonCode;
+    userSafeReason?: string;
+}
+export interface RuntimeCapacityLimitEvaluation {
+    allowed: boolean;
+    reasonCode?: RuntimeScheduleReasonCode;
+    userSafeReason?: string;
+}
+export declare function normalizeRuntimeScheduleRequest(request: RuntimeScheduleRequest, mode: RuntimeCapacityMode, defaultScope?: RuntimeCapacityScope): RuntimeCapacityValidation;
+export declare function evaluateRuntimeCapacityLimits({ request, scope, counters, platformPolicy, tenantPolicy, workspacePolicy, }: {
+    request: RuntimeScheduleRequest;
+    scope: RuntimeCapacityScope;
+    counters: RuntimeCapacityCounters;
+    platformPolicy: RuntimeQuotaPolicy;
+    tenantPolicy: RuntimeQuotaPolicy;
+    workspacePolicy: RuntimeQuotaPolicy;
+}): RuntimeCapacityLimitEvaluation;
+export declare function canQueueRuntimeCapacity({ request, scope, counters, platformPolicy, tenantPolicy, workspacePolicy, }: {
+    request: RuntimeScheduleRequest;
+    scope: RuntimeCapacityScope;
+    counters: RuntimeCapacityCounters;
+    platformPolicy: RuntimeQuotaPolicy;
+    tenantPolicy: RuntimeQuotaPolicy;
+    workspacePolicy: RuntimeQuotaPolicy;
+}): RuntimeCapacityLimitEvaluation;
+export declare function queueReasonForLimit(reasonCode: RuntimeScheduleReasonCode): RuntimeScheduleReasonCode;