@jterrats/open-orchestra 0.4.0 → 0.4.1

package/dist/sprint-commands.js

@@ -0,0 +1,120 @@
+import { requireArg } from "./args.js";
+import { computeVelocity } from "./benchmark.js";
+import { computeSprintBurndown, renderBurndownAscii } from "./burndown.js";
+import { calibrationReport, closeSprint, startSprint, velocityTrend, } from "./sprint-metrics.js";
+export async function velocityCommand(options, io) {
+    const cwd = process.cwd();
+    if (typeof options.sprints === "string") {
+        const limit = Number(options.sprints);
+        if (!Number.isInteger(limit) || limit <= 0) {
+            throw new Error("--sprints must be a positive integer");
+        }
+        const report = await velocityTrend(cwd, limit);
+        if (options.json) {
+            io.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        io.log(`Sprint Velocity Report`);
+        io.log(`  Trend: ${report.trend}`);
+        for (const sprint of report.sprints) {
+            io.log(`  ${sprint.sprintId}  ${sprint.storiesCompleted} stories  ${sprint.pointsCompleted} pts`);
+        }
+        return;
+    }
+    const report = await computeVelocity(cwd);
+    if (options.json) {
+        io.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    io.log(`Velocity Report`);
+    io.log(`  Stories completed: ${report.totalStoriesCompleted}`);
+    io.log(`  Points completed:  ${report.totalPointsCompleted}`);
+    io.log(`  Avg actual days:   ${report.avgActualDaysPerStory !== null ? report.avgActualDaysPerStory + "d" : "n/a"}`);
+    io.log(`  vs Solo estimate:  ${report.avgVsSoloPct !== null ? report.avgVsSoloPct + "%" : "n/a"}`);
+    io.log(`  vs AI estimate:    ${report.avgVsAiUnguidedPct !== null ? report.avgVsAiUnguidedPct + "%" : "n/a"}`);
+    io.log(`  Trend:             ${report.trend}`);
+    if (report.weeks.length > 0) {
+        io.log(`\nWeekly breakdown:`);
+        for (const week of report.weeks) {
+            io.log(`  ${week.week}  ${week.storiesCompleted} stories  ${week.pointsCompleted} pts`);
+        }
+    }
+}
+export async function sprintCommand(subcommand, options, io) {
+    const cwd = process.cwd();
+    if (subcommand === "start") {
+        const id = requireArg(options, "id");
+        const taskIds = requireArg(options, "tasks")
+            .split(",")
+            .map((taskId) => taskId.trim())
+            .filter(Boolean);
+        const sprint = await startSprint(cwd, id, taskIds);
+        if (options.json) {
+            io.log(JSON.stringify(sprint, null, 2));
+            return;
+        }
+        io.log(`Sprint started: ${sprint.id} (${sprint.taskIds.length} tasks)`);
+        return;
+    }
+    if (subcommand === "close") {
+        const id = requireArg(options, "id");
+        const sprint = await closeSprint(cwd, id);
+        if (options.json) {
+            io.log(JSON.stringify(sprint, null, 2));
+            return;
+        }
+        io.log(`Sprint closed: ${sprint.id}`);
+        return;
+    }
+    throw new Error(`unknown sprint command: ${subcommand ?? ""}`.trim());
+}
+export async function calibrationCommand(options, io) {
+    const report = await calibrationReport(process.cwd());
+    const roleFilter = typeof options.role === "string" ? options.role : null;
+    const filtered = roleFilter
+        ? { roles: report.roles.filter((role) => role.role === roleFilter) }
+        : report;
+    if (options.json) {
+        io.log(JSON.stringify(filtered, null, 2));
+        return;
+    }
+    io.log(`Calibration Report`);
+    for (const role of filtered.roles) {
+        io.log(`  ${role.role}  stories=${role.stories}  declared=${role.avgDeclaredDays}d  actual=${role.avgActualDays}d  error=${role.avgErrorPct}%  bias=${role.bias}`);
+    }
+}
+export async function burndownCommand(options, io) {
+    const cwd = process.cwd();
+    const sprintTaskIds = requireArg(options, "sprint")
+        .split(",")
+        .map((taskId) => taskId.trim())
+        .filter(Boolean);
+    if (sprintTaskIds.length === 0) {
+        throw new Error(`--sprint requires at least one task id`);
+    }
+    const series = await computeSprintBurndown(cwd, sprintTaskIds);
+    if (options.json) {
+        io.log(JSON.stringify(series, null, 2));
+        return;
+    }
+    for (const warning of series.warnings)
+        io.log(`⚠ ${warning}`);
+    if (series.totalPoints === 0) {
+        io.log("No points to chart — record estimates first with: orchestra estimate --task <id> ...");
+        return;
+    }
+    io.log(`Sprint burndown  total=${series.totalPoints} pts  tasks=${series.sprintTaskIds.length}`);
+    io.log("");
+    io.log(renderBurndownAscii(series));
+    io.log("");
+    io.log("Task breakdown:");
+    for (const task of series.taskBreakdown) {
+        const architectPoints = task.architectPoints !== null ? `arch=${task.architectPoints}` : "arch=—";
+        const developerPoints = task.developerPoints !== null ? `dev=${task.developerPoints}` : "dev=—";
+        const done = task.completedAt
+            ? `done ${task.completedAt.slice(0, 10)}`
+            : "pending";
+        io.log(`  ${task.taskId.padEnd(14)} ${architectPoints.padEnd(10)} ${developerPoints.padEnd(10)} resolved=${task.resolvedPoints}  ${done}`);
+    }
+}
+//# sourceMappingURL=sprint-commands.js.map

package/dist/sprint-commands.js.map

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

package/dist/telemetry-commands.d.ts

@@ -0,0 +1,7 @@
+import type { CliIo, CliOptions } from "./types.js";
+export declare function telemetryStatusCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function telemetryEnableCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function telemetryExportCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function telemetrySubmitCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function telemetryEvalDatasetCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function telemetryDisableCommand(options: CliOptions, io: CliIo): Promise<void>;

package/dist/telemetry-commands.js

@@ -0,0 +1,82 @@
+import { requireArg } from "./args.js";
+import { stringOption } from "./command-utils.js";
+import { disableTelemetryConsent, enableTelemetryConsent, exportTelemetryDataset, exportTelemetryEvalDataset, getTelemetryConsent, parseTelemetryLevel, requiresSensitiveTelemetryOptIn, submitTelemetryDataset, } from "./telemetry.js";
+export async function telemetryStatusCommand(options, io) {
+    const telemetry = await getTelemetryConsent();
+    if (options.json) {
+        io.log(JSON.stringify(telemetry, null, 2));
+        return;
+    }
+    io.log("Telemetry: " + (telemetry.enabled ? "enabled" : "off"));
+    io.log("Level: " + telemetry.level);
+    io.log("Policy: " + telemetry.policyVersion);
+}
+export async function telemetryEnableCommand(options, io) {
+    const level = parseTelemetryLevel(stringOption(options.level) ?? "metadata");
+    if (requiresSensitiveTelemetryOptIn(level) && !options["confirm-sensitive"]) {
+        throw new Error("prompt-sample and eval-dataset telemetry require --confirm-sensitive");
+    }
+    const telemetry = await enableTelemetryConsent({
+        level,
+        actor: stringOption(options.actor) ?? "user",
+    });
+    if (options.json) {
+        io.log(JSON.stringify(telemetry, null, 2));
+        return;
+    }
+    io.log("Telemetry enabled at level " + telemetry.level);
+}
+export async function telemetryExportCommand(options, io) {
+    const result = await exportTelemetryDataset({
+        dryRun: Boolean(options["dry-run"]),
+    });
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    io.log((result.dryRun ? "Telemetry export dry run" : "Telemetry exported") +
+        ": " +
+        result.recordCount +
+        " record(s)");
+    if (result.file) {
+        io.log("File: " + result.file);
+    }
+}
+export async function telemetrySubmitCommand(options, io) {
+    const result = await submitTelemetryDataset({
+        file: requireArg(options, "file"),
+        endpoint: requireArg(options, "endpoint"),
+    });
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    io.log("Telemetry submission recorded: " + result.fileHash);
+}
+export async function telemetryEvalDatasetCommand(options, io) {
+    const result = await exportTelemetryEvalDataset({
+        dryRun: Boolean(options["dry-run"]),
+    });
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    io.log((result.dryRun ? "Eval dataset dry run" : "Eval dataset exported") +
+        ": " +
+        result.recordCount +
+        " record(s)");
+    if (result.file) {
+        io.log("File: " + result.file);
+    }
+}
+export async function telemetryDisableCommand(options, io) {
+    const telemetry = await disableTelemetryConsent({
+        actor: stringOption(options.actor) ?? "user",
+    });
+    if (options.json) {
+        io.log(JSON.stringify(telemetry, null, 2));
+        return;
+    }
+    io.log("Telemetry disabled");
+}
+//# sourceMappingURL=telemetry-commands.js.map

package/dist/telemetry-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-commands.js","sourceRoot":"","sources":["../src/telemetry-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAmB,EACnB,EAAS;IAET,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC9C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,EAAE,CAAC,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,EAAE,CAAC,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAmB,EACnB,EAAS;IAET,MAAM,KAAK,GAAG,mBAAmB,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC;IAC7E,IAAI,+BAA+B,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC;QAC7C,KAAK;QACL,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM;KAC7C,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,6BAA6B,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;QAC1C,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;KACpC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CACJ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,oBAAoB,CAAC;QACjE,IAAI;QACJ,MAAM,CAAC,WAAW;QAClB,YAAY,CACf,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,EAAE,CAAC,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;QAC1C,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;QACjC,QAAQ,EAAE,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC;KAC1C,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,iCAAiC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC;QAC9C,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;KACpC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CACJ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,uBAAuB,CAAC;QAChE,IAAI;QACJ,MAAM,CAAC,WAAW;QAClB,YAAY,CACf,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,EAAE,CAAC,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAmB,EACnB,EAAS;IAET,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC;QAC9C,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM;KAC7C,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAC/B,CAAC"}

package/dist/tool-commands.d.ts

@@ -0,0 +1,3 @@
+import type { CliIo, CliOptions } from "./types.js";
+export declare function diagramsLintCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function mcpOAuthProxyEvaluateCommand(options: CliOptions, io: CliIo): Promise<void>;

package/dist/tool-commands.js

@@ -0,0 +1,67 @@
+import { requireArg } from "./args.js";
+import { removeUndefined, stringOption } from "./command-utils.js";
+import { lintMermaidDiagram, recordDiagramLintEvidence, } from "./diagram-validation.js";
+import { evaluateMcpOAuthProxy, } from "./mcp-oauth-proxy.js";
+export async function diagramsLintCommand(options, io) {
+    const result = await lintMermaidDiagram({
+        filePath: requireArg(options, "file"),
+    });
+    const evidence = stringOption(options.task)
+        ? await recordDiagramLintEvidence({
+            taskId: stringOption(options.task) ?? "",
+            result,
+        })
+        : undefined;
+    const output = removeUndefined({ result, evidence });
+    if (options.json) {
+        io.log(JSON.stringify(output, null, 2));
+    }
+    else {
+        io.log(result.valid ? "Mermaid diagram valid" : "Mermaid diagram invalid");
+        if (result.installHint) {
+            io.log(result.installHint);
+        }
+        if (evidence) {
+            io.log("Created " + evidence.artifact);
+        }
+    }
+    if (!result.valid) {
+        throw new Error("diagram lint failed");
+    }
+}
+export async function mcpOAuthProxyEvaluateCommand(options, io) {
+    const evaluation = evaluateMcpOAuthProxy(removeUndefined({
+        enabled: Boolean(options.enable),
+        mode: parseMcpProxyMode(stringOption(options.mode) ?? "stdio-proxy"),
+        serverUrl: requireArg(options, "server-url"),
+        tokenStorage: parseMcpSecretStorage(stringOption(options["token-storage"]) ?? "keychain"),
+        tokenPath: stringOption(options["token-path"]),
+        refreshWindowSeconds: Number(stringOption(options["refresh-window"]) ?? 300),
+        approvedBy: options.approve
+            ? (stringOption(options.approver) ?? "local-user")
+            : undefined,
+    }));
+    if (options.json) {
+        io.log(JSON.stringify(evaluation, null, 2));
+        return;
+    }
+    io.log(evaluation.approved
+        ? "MCP proxy plan approved"
+        : "MCP proxy plan has risks");
+    for (const risk of evaluation.risks) {
+        io.log("RISK: " + risk);
+    }
+}
+function parseMcpProxyMode(value) {
+    if (["stdio-proxy", "direct-http", "tool-native-oauth"].includes(value)) {
+        return value;
+    }
+    throw new Error("unknown MCP proxy mode: " + value);
+}
+function parseMcpSecretStorage(value) {
+    if (["keychain", "libsecret", "windows-credential", "secure-file"].includes(value)) {
+        return value;
+    }
+    throw new Error("unknown MCP secret storage: " + value);
+}
+//# sourceMappingURL=tool-commands.js.map

package/dist/tool-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-commands.js","sourceRoot":"","sources":["../src/tool-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,qBAAqB,GAGtB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;QACtC,QAAQ,EAAE,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;KACtC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC;QACzC,CAAC,CAAC,MAAM,yBAAyB,CAAC;YAC9B,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;YACxC,MAAM;SACP,CAAC;QACJ,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;QAC3E,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,EAAE,CAAC,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAAmB,EACnB,EAAS;IAET,MAAM,UAAU,GAAG,qBAAqB,CACtC,eAAe,CAAC;QACd,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAChC,IAAI,EAAE,iBAAiB,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC;QACpE,SAAS,EAAE,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC;QAC5C,YAAY,EAAE,qBAAqB,CACjC,YAAY,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,UAAU,CACrD;QACD,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC9C,oBAAoB,EAAE,MAAM,CAC1B,YAAY,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,IAAI,GAAG,CAC/C;QACD,UAAU,EAAE,OAAO,CAAC,OAAO;YACzB,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC;YAClD,CAAC,CAAC,SAAS;KACd,CAAC,CACH,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CACJ,UAAU,CAAC,QAAQ;QACjB,CAAC,CAAC,yBAAyB;QAC3B,CAAC,CAAC,0BAA0B,CAC/B,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,EAAE,CAAC,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,CAAC,aAAa,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,KAAqB,CAAC;IAC/B,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,IACE,CAAC,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,aAAa,CAAC,CAAC,QAAQ,CACrE,KAAK,CACN,EACD,CAAC;QACD,OAAO,KAAyB,CAAC;IACnC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,KAAK,CAAC,CAAC;AAC1D,CAAC"}

package/dist/types.d.ts

@@ -5,6 +5,8 @@ export type EvidenceType = "command" | "file" | "screenshot" | "trace" | "video"
 export type SkillLoadBudget = "small" | "normal" | "large";
 export type SkillRenderTarget = "generic" | "claude" | "cursor" | "codex" | "vscode" | "windsurf";
 export type RuntimeAdapterKind = "llm" | "ide" | "cli";
+export type RuntimeExecutionId = "claude-cli" | "codex-cli" | "cursor-cli" | "vscode-agent" | "windsurf-agent" | "generic-runtime";
+export type RuntimeDelegationMode = "runtime-native" | "brief-only";
 export interface RuntimeAdapter {
     target: SkillRenderTarget;
     label: string;
@@ -15,6 +17,82 @@ export interface RuntimeAdapter {
     supportsImports: boolean;
     guidance: string;
 }
+export interface RuntimeExecutionCapabilities {
+    nonInteractive: boolean;
+    promptInjection: boolean;
+    structuredOutput: boolean;
+    fileEdits: boolean;
+    testExecution: boolean;
+    evidenceReturn: boolean;
+    requiresTty: boolean;
+    requiresUserApproval: boolean;
+    resumeSession: boolean;
+}
+export interface RuntimeSubagentCapabilities {
+    runtimeNative: boolean;
+    parallel: boolean;
+    namedRoles: boolean;
+    forkedContext: boolean;
+    structuredHandoff: boolean;
+    fileOwnership: boolean;
+    requiresParentApproval: boolean;
+}
+export interface RuntimeExecutionAdapter {
+    id: RuntimeExecutionId;
+    target: SkillRenderTarget;
+    label: string;
+    kind: RuntimeAdapterKind;
+    summary: string;
+    execution: RuntimeExecutionCapabilities;
+    subagents: RuntimeSubagentCapabilities;
+    briefOnlyFallback: boolean;
+    directProviderApiAllowed: false;
+    guidance: string;
+}
+export interface RuntimeExecutorConfig {
+    executor?: RuntimeExecutionId;
+}
+export interface RuntimeDelegationPolicy {
+    mode: RuntimeDelegationMode;
+    allowDirectProviderApi: boolean;
+}
+export interface RuntimeExecutionPolicy {
+    defaults?: RuntimeExecutorConfig;
+    byRole: Record<string, RuntimeExecutorConfig>;
+    byTask: Record<string, RuntimeExecutorConfig>;
+    delegation: RuntimeDelegationPolicy;
+}
+export interface RuntimeSelection {
+    taskId: string;
+    role: string;
+    runtime: RuntimeExecutionAdapter;
+    source: "explicit" | "task" | "role" | "default" | "fallback";
+    directProviderApiAllowed: false;
+}
+export interface RuntimeDelegationAssignment {
+    role: string;
+    paths: string[];
+    allowedCommands: string[];
+    expectedArtifacts: string[];
+}
+export interface RuntimeBrief {
+    taskId: string;
+    runtime: RuntimeExecutionId;
+    artifact: string;
+    content: string;
+    mode: "brief-only";
+    directProviderApiAllowed: false;
+}
+export interface RuntimeDelegationPacket {
+    taskId: string;
+    runtime: RuntimeExecutionId;
+    artifact: string;
+    content: string;
+    mode: RuntimeDelegationMode;
+    directProviderApiAllowed: false;
+    assignments: RuntimeDelegationAssignment[];
+    requiresApproval: boolean;
+}
 export type WorkspaceClassificationKind = "project" | "advisory" | "unsafe" | "unknown";
 export type WorkspaceWritePolicy = "allow" | "confirm_required" | "blocked";
 export interface WorkspaceClassification {
@@ -408,6 +486,7 @@ export interface WorkflowConfig {
     github?: GitHubConfig;
     notifications?: NotificationsConfig;
     providerPolicy?: ProviderPolicyConfig;
+    runtimePolicy?: RuntimeExecutionPolicy;
     staticAnalysis: {
         preCommit: {
             required: boolean;

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAm6BA,MAAM,CAAC,MAAM,aAAa,GAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAogCA,MAAM,CAAC,MAAM,aAAa,GAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC"}

package/docs/runtime-llm-flow.md

@@ -116,6 +116,50 @@ optionally `ANTHROPIC_BASE_URL` for an HTTPS-compatible endpoint. It uses
 Claude Messages API responses are normalized through text content rather than
 OpenAI-style JSON schema response formatting.
 
+## Runtime Execution
+
+Runtime execution is separate from model provider routing. `ModelProvider`
+adapters call vendor APIs directly and therefore require provider API keys.
+Runtime execution adapters prepare work for an already-authenticated runtime
+such as Claude CLI, Codex CLI, Cursor, VS Code, or Windsurf.
+
+Use runtime execution when the user wants the active CLI/IDE agent to perform
+the work and does not want Orchestra to call OpenAI, Anthropic, or another
+vendor API directly:
+
+```bash
+node bin/orchestra.js runtime adapters --json
+node bin/orchestra.js runtime brief --task STORY-001 --runtime claude-cli
+node bin/orchestra.js runtime delegate-plan --task STORY-001 --runtime claude-cli --roles architect,developer,qa
+node bin/orchestra.js runtime handoff --task STORY-001 --runtime claude-cli --artifact .agent-workflow/runs/STORY-001-runtime-claude-cli-delegation.md
+```
+
+Runtime briefs and delegation packets are written under `.agent-workflow/runs/`
+and record provenance events. They are brief-only control artifacts in this
+release; Orchestra does not launch arbitrary runtime processes or silently fall
+back to vendor APIs.
+
+Runtime policy can force executor selection without API keys:
+
+```json
+{
+  "runtimePolicy": {
+    "defaults": { "executor": "generic-runtime" },
+    "byRole": { "developer": { "executor": "codex-cli" } },
+    "byTask": { "STORY-001": { "executor": "claude-cli" } },
+    "delegation": {
+      "mode": "runtime-native",
+      "allowDirectProviderApi": false
+    }
+  }
+}
+```
+
+If a runtime does not support native subagents, Orchestra renders a delegation
+packet in `brief-only` mode and requires user approval before any other
+execution strategy. Direct provider API calls remain forbidden by runtime
+execution packets.
+
 Provider policy can restrict real adapters with `allowedProviders` and
 `blockedProviders`. Cross-vendor fallback is blocked by default; enable
 `allowVendorFallbackWithoutApproval` only after recording the required approval
@@ -133,6 +177,8 @@ budget fallback.
   an OpenAI adapter for the Responses API, and an Anthropic adapter for the
   Claude Messages API. Additional vendors need explicit implementation and
   approval.
+- Runtime execution adapters render briefs and delegation packets, but they do
+  not yet launch external CLI/IDE processes non-interactively.
 - It records delegation decisions, but it does not automatically spawn
   subagents yet.
 - Parallel independent CLI commands are expected to work, but dependent commands

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jterrats/open-orchestra",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "bin": {
     "orchestra": "bin/orchestra.js"