@jterrats/open-orchestra 0.4.0 → 0.4.2-beta.1

package/dist/metrics-commands.js

@@ -0,0 +1,123 @@
+import { requireArg } from "./args.js";
+import { computeBenchmark, recordEstimate, summarizeBenchmark, } from "./benchmark.js";
+import { stringOption } from "./command-utils.js";
+import { SIZING_LABELS } from "./types.js";
+const CONFIDENCE_LEVELS = ["low", "medium", "high"];
+export async function estimateCommand(options, io) {
+    const cwd = process.cwd();
+    const taskId = requireArg(options, "task");
+    const sizingRaw = requireArg(options, "sizing");
+    const soloDays = numberOption(options["solo-days"], 0);
+    const aiDays = numberOption(options["ai-unguided-days"], 0);
+    const confidence = (stringOption(options.confidence) ??
+        "medium");
+    const declaredBy = stringOption(options["declared-by"]) ?? "pm";
+    if (!SIZING_LABELS.includes(sizingRaw)) {
+        throw new Error(`--sizing must be one of: ${SIZING_LABELS.join(", ")}`);
+    }
+    if (!CONFIDENCE_LEVELS.includes(confidence)) {
+        throw new Error(`--confidence must be one of: ${CONFIDENCE_LEVELS.join(", ")}`);
+    }
+    if (soloDays <= 0)
+        throw new Error(`--solo-days must be > 0`);
+    if (aiDays <= 0)
+        throw new Error(`--ai-unguided-days must be > 0`);
+    const record = await recordEstimate(cwd, {
+        taskId,
+        sizingLabel: sizingRaw,
+        soloEstimateDays: soloDays,
+        aiUnguidedEstimateDays: aiDays,
+        confidence,
+        declaredBy,
+    });
+    if (options.json) {
+        io.log(JSON.stringify(record, null, 2));
+        return;
+    }
+    io.log(`Estimate recorded for ${taskId} [${record.id}]`);
+    io.log(`  Sizing:      ${record.sizingLabel}`);
+    io.log(`  Solo:        ${record.soloEstimateDays}d`);
+    io.log(`  AI-unguided: ${record.aiUnguidedEstimateDays}d`);
+    io.log(`  Confidence:  ${record.confidence}`);
+    io.log(`  Declared by: ${record.declaredBy}`);
+}
+export async function benchmarkCommand(options, io) {
+    const cwd = process.cwd();
+    if (options.summary) {
+        const summary = await summarizeBenchmark(cwd);
+        if (options.json) {
+            io.log(JSON.stringify(summary, null, 2));
+            return;
+        }
+        if (summary.stories.length === 0) {
+            io.log("No estimates recorded yet. Use: orchestra estimate --task <id> ...");
+            return;
+        }
+        const header = `${"Story".padEnd(14)} ${"Size".padEnd(4)} ${"Solo".padEnd(6)} ${"AI".padEnd(6)} ${"Actual".padEnd(8)} ${"vs Solo".padEnd(8)} ${"vs AI".padEnd(8)} ${"QA".padEnd(4)} ${"Rev".padEnd(4)} ${"Blk".padEnd(4)} ${"Ev".padEnd(4)} ${"Les"}`;
+        io.log(header);
+        io.log("─".repeat(header.length));
+        for (const story of summary.stories) {
+            const actual = story.actualDays !== null ? `${story.actualDays}d` : "pending";
+            const vsSolo = story.vsSoloPct !== null
+                ? `${story.vsSoloPct > 0 ? "+" : ""}${story.vsSoloPct}%`
+                : "—";
+            const vsAi = story.vsAiUnguidedPct !== null
+                ? `${story.vsAiUnguidedPct > 0 ? "+" : ""}${story.vsAiUnguidedPct}%`
+                : "—";
+            io.log(`${story.taskId.padEnd(14)} ${story.sizingLabel.padEnd(4)} ${`${story.soloEstimateDays}d`.padEnd(6)} ${`${story.aiUnguidedEstimateDays}d`.padEnd(6)} ${actual.padEnd(8)} ${vsSolo.padEnd(8)} ${vsAi.padEnd(8)} ${String(story.qaIterations).padEnd(4)} ${String(story.quality.reviewCount).padEnd(4)} ${String(story.quality.blockingReviews).padEnd(4)} ${String(story.quality.evidenceCount).padEnd(4)} ${story.quality.lessonCount}`);
+        }
+        if (summary.totalWithActuals > 0) {
+            io.log("");
+            io.log(`Avg savings vs solo:        ${summary.avgVsSoloPct}%`);
+            io.log(`Avg savings vs AI-unguided: ${summary.avgVsAiUnguidedPct}%`);
+            io.log(`Stories with actuals:       ${summary.totalWithActuals}/${summary.stories.length}`);
+        }
+        return;
+    }
+    const taskId = requireArg(options, "task");
+    const result = await computeBenchmark(cwd, taskId);
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    io.log(`Benchmark: ${taskId}  [${result.status}]`);
+    io.log(`  Sizing:      ${result.sizingLabel}`);
+    io.log(`  Solo:        ${result.soloEstimateDays}d  (declared)`);
+    io.log(`  AI-unguided: ${result.aiUnguidedEstimateDays}d  (declared)`);
+    io.log(`  Actual:      ${result.actualDays !== null ? `${result.actualDays}d` : "pending — run not complete"}`);
+    if (result.vsSoloPct !== null) {
+        const sign = result.vsSoloPct > 0 ? "+" : "";
+        io.log(`  vs Solo:     ${sign}${result.vsSoloPct}%`);
+        io.log(`  vs AI:       ${result.vsAiUnguidedPct !== null ? `${result.vsAiUnguidedPct > 0 ? "+" : ""}${result.vsAiUnguidedPct}%` : "—"}`);
+    }
+    io.log(`  QA loops:    ${result.qaIterations}`);
+    if (result.phaseDurations.length > 0) {
+        io.log(`  Phase durations:`);
+        for (const phase of result.phaseDurations) {
+            const duration = phase.durationMs !== null
+                ? `${Math.round(phase.durationMs / 1000)}s`
+                : "pending";
+            io.log(`    - ${phase.phase}: ${duration}`);
+        }
+    }
+    io.log(`  Reviews:     ${result.quality.reviewCount} (${result.quality.blockingReviews} blocking)`);
+    io.log(`  Evidence:    ${result.quality.evidenceCount} artifacts`);
+    io.log(`  Gate blocks: ${result.quality.gateBlockCount}`);
+    io.log(`  Lessons:     ${result.quality.lessonCount}`);
+    if (result.quality.totalInputTokens > 0 ||
+        result.quality.totalOutputTokens > 0) {
+        io.log(`  Tokens:      ${result.quality.totalInputTokens}in / ${result.quality.totalOutputTokens}out`);
+        io.log(`  Cost:        $${result.quality.estimatedCostUsd}`);
+    }
+}
+function numberOption(value, fallback) {
+    if (typeof value !== "string" || value.trim() === "") {
+        return fallback;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`invalid number: ${value}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=metrics-commands.js.map

package/dist/metrics-commands.js.map

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

package/dist/model-commands.d.ts

@@ -0,0 +1,13 @@
+import type { CliIo, CliOptions } from "./types.js";
+export declare function usageCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function budgetCheckCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function approvalsListCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function approvalsShowCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function approvalsApproveCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function approvalsRejectCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function configShowCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function modelProvidersCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function modelSetRoleCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function modelProvenanceAddCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function modelProvenanceListCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function modelCompleteFakeCommand(options: CliOptions, io: CliIo): Promise<void>;

package/dist/model-commands.js

@@ -0,0 +1,216 @@
+import { requireArg } from "./args.js";
+import { parseCsv, removeUndefined, stringOption, } from "./command-utils.js";
+import { approveApproval, checkBudgetEstimatePreflight, checkUsageBudget, completeWithProviderFallback, getUsageReport, getWorkflowConfig, listApprovals, listConfiguredModelProviders, listModelProvenance, recordModelProvenance, rejectApproval, setRoleModelProvider, showApproval, } from "./workflow-services.js";
+export async function usageCommand(options, io) {
+    const report = await getUsageReport(stringOption(options.task));
+    if (options.json) {
+        io.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    io.log(renderUsageReport(report));
+}
+export async function budgetCheckCommand(options, io) {
+    const estimatedCostUsd = stringOption(options["estimate-cost"]);
+    if (estimatedCostUsd) {
+        const result = await checkBudgetEstimatePreflight(requireArg(options, "task"), numberOption(estimatedCostUsd, 0));
+        if (options.json) {
+            io.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            io.log(renderBudgetCheck(result.budget));
+            for (const warning of result.warnings) {
+                io.log(`WARNING: ${warning.scope} estimatedCostUsd is ${warning.actual}/${warning.limit} (${warning.thresholdPercent}% threshold)`);
+            }
+        }
+        if (!result.passed) {
+            throw new Error("budget check failed");
+        }
+        return;
+    }
+    const result = await checkUsageBudget(stringOption(options.task));
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        io.log(renderBudgetCheck(result));
+    }
+    if (!result.passed) {
+        throw new Error("budget check failed");
+    }
+}
+export async function approvalsListCommand(options, io) {
+    const approvals = await listApprovals(stringOption(options.task));
+    if (options.json) {
+        io.log(JSON.stringify(approvals, null, 2));
+        return;
+    }
+    if (approvals.length === 0) {
+        io.log("No approvals");
+        return;
+    }
+    for (const approval of approvals) {
+        io.log(`${approval.id} [${approval.status}] ${approval.taskId ?? "no-task"} ${approval.artifact}`);
+    }
+}
+export async function approvalsShowCommand(options, io) {
+    const approval = await showApproval(requireArg(options, "id"));
+    if (options.json) {
+        io.log(JSON.stringify(approval, null, 2));
+        return;
+    }
+    io.log(approval.content);
+}
+export async function approvalsApproveCommand(options, io) {
+    const approval = await approveApproval(parseApprovalDecision(options));
+    io.log(`Approved ${approval.id}`);
+}
+export async function approvalsRejectCommand(options, io) {
+    const approval = await rejectApproval(parseApprovalDecision(options));
+    io.log(`Rejected ${approval.id}`);
+}
+export async function configShowCommand(options, io) {
+    const config = await getWorkflowConfig();
+    if (options.json) {
+        io.log(JSON.stringify(config, null, 2));
+        return;
+    }
+    io.log(`Tools: ${Object.keys(config.tools ?? {}).length}`);
+    io.log(`Role routes: ${Object.keys(config.providers?.byRole ?? {}).length}`);
+}
+export async function modelProvidersCommand(options, io) {
+    const providers = await listConfiguredModelProviders();
+    if (options.json) {
+        io.log(JSON.stringify(providers, null, 2));
+        return;
+    }
+    if (providers.length === 0) {
+        io.log("No configured model providers");
+        return;
+    }
+    for (const provider of providers) {
+        io.log(`${provider.scope}: ${provider.provider}/${provider.model} (${provider.timeoutMs}ms)`);
+    }
+}
+export async function modelSetRoleCommand(options, io) {
+    const role = requireArg(options, "role");
+    const routing = parseProviderRouting(options);
+    await setRoleModelProvider(role, routing);
+    io.log(`Configured model provider for ${role}`);
+}
+export async function modelProvenanceAddCommand(options, io) {
+    const record = await recordModelProvenance({
+        task: requireArg(options, "task"),
+        role: requireArg(options, "role"),
+        provider: requireArg(options, "provider"),
+        model: requireArg(options, "model"),
+        promptId: requireArg(options, "prompt-id"),
+        responseId: requireArg(options, "response-id"),
+        inputTokens: numberOption(options["input-tokens"], 0),
+        outputTokens: numberOption(options["output-tokens"], 0),
+        estimatedCostUsd: numberOption(options["estimated-cost-usd"], 0),
+        finishReason: requireArg(options, "finish-reason"),
+    });
+    io.log(`Recorded model provenance ${record.responseId}`);
+}
+export async function modelProvenanceListCommand(options, io) {
+    const records = await listModelProvenance(stringOption(options.task));
+    if (options.json) {
+        io.log(JSON.stringify(records, null, 2));
+        return;
+    }
+    if (records.length === 0) {
+        io.log("No model provenance");
+        return;
+    }
+    for (const record of records) {
+        io.log(`${record.task} ${record.role} ${record.provider}/${record.model} ${record.responseId}`);
+    }
+}
+export async function modelCompleteFakeCommand(options, io) {
+    const result = await completeWithProviderFallback({
+        provider: requireArg(options, "provider"),
+        model: requireArg(options, "model"),
+        fallbacks: parseCsv(options.fallbacks),
+        maxTokens: 0,
+        maxCostUsd: 0,
+        timeoutMs: 30000,
+        retries: 0,
+        requiredCapabilities: [],
+    }, requireArg(options, "prompt"), removeUndefined({
+        failingProviders: parseCsv(options["fail-provider"]),
+        taskId: stringOption(options.task),
+        role: stringOption(options.role) ?? "parent",
+    }));
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    io.log(`Fake completion used ${result.provider}/${result.model} fallback=${String(result.fallbackUsed)}`);
+}
+function parseProviderRouting(options) {
+    return {
+        provider: requireArg(options, "provider"),
+        model: requireArg(options, "model"),
+        fallbacks: parseCsv(options.fallbacks),
+        maxTokens: numberOption(options["max-tokens"], 0),
+        maxCostUsd: numberOption(options["max-cost-usd"], 0),
+        timeoutMs: numberOption(options["timeout-ms"], 30000),
+        retries: numberOption(options.retries, 0),
+        requiredCapabilities: parseCsv(options.capabilities),
+    };
+}
+function parseApprovalDecision(options) {
+    return {
+        id: requireArg(options, "id"),
+        approver: requireArg(options, "approver"),
+        rationale: requireArg(options, "rationale"),
+    };
+}
+function numberOption(value, fallback) {
+    if (typeof value !== "string" || value.trim() === "") {
+        return fallback;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`invalid number: ${value}`);
+    }
+    return parsed;
+}
+function renderUsageReport(report) {
+    return [
+        `Usage${report.taskId ? ` for ${report.taskId}` : ""}`,
+        `- Requests: ${report.totals.requests}`,
+        `- Input tokens: ${report.totals.inputTokens}`,
+        `- Output tokens: ${report.totals.outputTokens}`,
+        `- Total tokens: ${report.totals.totalTokens}`,
+        `- Estimated cost USD: ${report.totals.estimatedCostUsd}`,
+        "",
+        "By role:",
+        ...usageLines(report.byRole),
+        "",
+        "By provider:",
+        ...usageLines(report.byProvider),
+    ].join("\n");
+}
+function renderBudgetCheck(result) {
+    return [
+        `Budget check${result.taskId ? ` for ${result.taskId}` : ""}: ${result.passed ? "passed" : "failed"}`,
+        `- Applied budgets: ${result.appliedBudgets.length > 0
+            ? result.appliedBudgets.join(", ")
+            : "none"}`,
+        `- Requests: ${result.usage.totals.requests}`,
+        `- Total tokens: ${result.usage.totals.totalTokens}`,
+        `- Estimated cost USD: ${result.usage.totals.estimatedCostUsd}`,
+        "",
+        "Violations:",
+        ...(result.violations.length === 0
+            ? ["- none"]
+            : result.violations.map((violation) => `- ${violation.scope} ${violation.metric}: ${violation.actual} > ${violation.limit}`)),
+    ].join("\n");
+}
+function usageLines(items) {
+    return items.length === 0
+        ? ["- none"]
+        : items.map((item) => `- ${item.key}: ${item.requests} requests, ${item.totalTokens} tokens, $${item.estimatedCostUsd}`);
+}
+//# sourceMappingURL=model-commands.js.map

package/dist/model-commands.js.map

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

package/dist/notifications.d.ts

@@ -5,6 +5,18 @@ export interface GatePauseNotificationInput {
     transitionKey: string;
     reviewArtifact: string;
 }
+export type WorkflowNotificationKind = "done" | "failed" | "qa_retry" | "critical_blocking_review";
+export interface WorkflowLifecycleNotificationInput {
+    root: string;
+    taskId: string;
+    kind: WorkflowNotificationKind;
+    runId?: string;
+    phase?: string;
+    actor?: string;
+    detail: string;
+    artifact?: string;
+    idempotencyKey?: string;
+}
 export interface NotificationTransports {
     postSlack?: (webhookUrl: string, body: SlackPayload) => Promise<void>;
     commentOnIssue?: (issue: string, body: string) => Promise<void>;
@@ -16,6 +28,17 @@ interface GatePauseMessage {
     reviewArtifact: string;
     resumeCommand: string;
 }
+interface WorkflowLifecycleMessage {
+    taskId: string;
+    taskTitle: string;
+    kind: WorkflowNotificationKind;
+    headline: string;
+    detail: string;
+    runId?: string;
+    phase?: string;
+    actor?: string;
+    artifact?: string;
+}
 interface SlackPayload {
     text: string;
     blocks: Array<{
@@ -27,5 +50,7 @@ interface SlackPayload {
     }>;
 }
 export declare function notifyGatePaused(input: GatePauseNotificationInput, transports?: NotificationTransports): Promise<NotificationChannelResult[]>;
+export declare function notifyWorkflowLifecycle(input: WorkflowLifecycleNotificationInput, transports?: NotificationTransports): Promise<NotificationChannelResult[]>;
 export declare function buildGatePauseMessage(input: GatePauseNotificationInput): Promise<GatePauseMessage>;
+export declare function buildWorkflowLifecycleMessage(input: WorkflowLifecycleNotificationInput): Promise<WorkflowLifecycleMessage>;
 export {};