@jterrats/open-orchestra 0.3.1 → 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/sprint-metrics.d.ts

@@ -0,0 +1,9 @@
+import type { CalibrationReport, SprintRecord, SprintVelocity, SprintVelocityReport } from "./types.js";
+export declare const SPRINTS_FILE = "sprints.jsonl";
+export declare function sprintsPath(root: string): string;
+export declare function startSprint(root: string, sprintId: string, taskIds: string[]): Promise<SprintRecord>;
+export declare function closeSprint(root: string, sprintId: string): Promise<SprintRecord>;
+export declare function listSprints(root: string): Promise<SprintRecord[]>;
+export declare function computeSprintVelocity(root: string, sprintId: string): Promise<SprintVelocity>;
+export declare function velocityTrend(root: string, limit: number): Promise<SprintVelocityReport>;
+export declare function calibrationReport(root: string): Promise<CalibrationReport>;

package/dist/sprint-metrics.js

@@ -0,0 +1,203 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { appendJsonLine, resolveWorkflowPath } from "./fs-utils.js";
+import { appendEvent } from "./workspace.js";
+import { computeBenchmark, listEstimates } from "./benchmark.js";
+export const SPRINTS_FILE = "sprints.jsonl";
+const POINTS_BY_SIZE = { xs: 1, s: 2, m: 3, l: 5, xl: 8 };
+const CALIBRATION_BIAS_THRESHOLD_PCT = 30;
+const CALIBRATION_MIN_STORIES = 3;
+export function sprintsPath(root) {
+    return resolveWorkflowPath(root, SPRINTS_FILE);
+}
+export async function startSprint(root, sprintId, taskIds) {
+    if (taskIds.length === 0) {
+        throw new Error("--tasks requires at least one task id");
+    }
+    const existing = await listSprints(root);
+    const latest = existing.find((sprint) => sprint.id === sprintId);
+    if (latest?.status === "active") {
+        throw new Error(`sprint already active: ${sprintId}`);
+    }
+    const now = new Date().toISOString();
+    const record = {
+        id: sprintId,
+        taskIds,
+        status: "active",
+        startedAt: now,
+        closedAt: null,
+    };
+    await appendJsonLine(sprintsPath(root), record);
+    await appendEvent(root, {
+        type: "SPRINT_STARTED",
+        actor: "pm",
+        summary: `Sprint started: ${sprintId}`,
+        metadata: { sprintId, taskIds },
+    });
+    return record;
+}
+export async function closeSprint(root, sprintId) {
+    const latest = (await listSprints(root)).find((sprint) => sprint.id === sprintId);
+    if (!latest) {
+        throw new Error(`sprint not found: ${sprintId}`);
+    }
+    if (latest.status === "closed") {
+        return latest;
+    }
+    const record = {
+        ...latest,
+        status: "closed",
+        closedAt: new Date().toISOString(),
+    };
+    await appendJsonLine(sprintsPath(root), record);
+    await appendEvent(root, {
+        type: "SPRINT_CLOSED",
+        actor: "pm",
+        summary: `Sprint closed: ${sprintId}`,
+        metadata: { sprintId, taskIds: record.taskIds },
+    });
+    return record;
+}
+export async function listSprints(root) {
+    const file = sprintsPath(root);
+    if (!existsSync(file))
+        return [];
+    const lines = (await readFile(file, "utf8"))
+        .split("\n")
+        .filter((line) => line.trim() !== "");
+    const latest = new Map();
+    for (const line of lines) {
+        const sprint = JSON.parse(line);
+        latest.set(sprint.id, sprint);
+    }
+    return [...latest.values()].sort((a, b) => a.startedAt.localeCompare(b.startedAt));
+}
+export async function computeSprintVelocity(root, sprintId) {
+    const sprint = (await listSprints(root)).find((item) => item.id === sprintId);
+    if (!sprint) {
+        throw new Error(`sprint not found: ${sprintId}`);
+    }
+    const completed = [];
+    for (const taskId of sprint.taskIds) {
+        const benchmark = await computeBenchmark(root, taskId).catch(() => null);
+        if (benchmark?.status === "complete" && benchmark.actualDays !== null) {
+            completed.push(benchmark);
+        }
+    }
+    return {
+        sprintId,
+        taskIds: sprint.taskIds,
+        storiesCompleted: completed.length,
+        pointsCompleted: completed.reduce((sum, story) => sum + POINTS_BY_SIZE[story.sizingLabel], 0),
+    };
+}
+export async function velocityTrend(root, limit) {
+    const closed = (await listSprints(root))
+        .filter((sprint) => sprint.status === "closed")
+        .slice(-limit);
+    const sprints = [];
+    for (const sprint of closed) {
+        sprints.push(await computeSprintVelocity(root, sprint.id));
+    }
+    return {
+        sprints,
+        trend: computeTrend(sprints.map((s) => s.pointsCompleted)),
+    };
+}
+export async function calibrationReport(root) {
+    const estimates = await listEstimates(root);
+    const byRole = new Map();
+    for (const estimate of estimates) {
+        const benchmark = await computeBenchmark(root, estimate.taskId).catch(() => null);
+        if (benchmark?.status !== "complete" || benchmark.actualDays === null) {
+            continue;
+        }
+        const current = byRole.get(estimate.declaredBy) ?? {
+            declaredTotal: 0,
+            actualTotal: 0,
+            errorPctTotal: 0,
+            stories: 0,
+        };
+        const errorPct = ((benchmark.actualDays - estimate.soloEstimateDays) /
+            estimate.soloEstimateDays) *
+            100;
+        byRole.set(estimate.declaredBy, {
+            declaredTotal: current.declaredTotal + estimate.soloEstimateDays,
+            actualTotal: current.actualTotal + benchmark.actualDays,
+            errorPctTotal: current.errorPctTotal + errorPct,
+            stories: current.stories + 1,
+        });
+    }
+    const roles = [];
+    for (const [role, stats] of byRole) {
+        const avgErrorPct = Math.round(stats.errorPctTotal / stats.stories);
+        const bias = calibrationBias(stats.stories, avgErrorPct);
+        const lessonRecorded = bias === "over" || bias === "under";
+        if (lessonRecorded) {
+            await recordCalibrationLesson(root, role, bias, avgErrorPct);
+        }
+        roles.push({
+            role,
+            stories: stats.stories,
+            avgDeclaredDays: round(stats.declaredTotal / stats.stories),
+            avgActualDays: round(stats.actualTotal / stats.stories),
+            avgErrorPct,
+            bias,
+            lessonRecorded,
+        });
+    }
+    return { roles: roles.sort((a, b) => a.role.localeCompare(b.role)) };
+}
+async function recordCalibrationLesson(root, role, bias, avgErrorPct) {
+    const eventsPath = resolveWorkflowPath(root, "events.jsonl");
+    const content = existsSync(eventsPath)
+        ? await readFile(eventsPath, "utf8")
+        : "";
+    const signature = `calibration:${role}:${bias}`;
+    if (content.includes(signature)) {
+        return;
+    }
+    await appendEvent(root, {
+        type: "LESSON_RECORDED",
+        actor: "system",
+        summary: `Calibration lesson recorded for ${role}`,
+        metadata: {
+            signature,
+            role,
+            bias,
+            avgErrorPct,
+            recommendation: bias === "under"
+                ? "Increase future estimates or split stories before commitment."
+                : "Reduce future estimates or raise confidence thresholds before commitment.",
+        },
+    });
+}
+function calibrationBias(stories, avgErrorPct) {
+    if (stories < CALIBRATION_MIN_STORIES)
+        return "insufficient_data";
+    if (avgErrorPct > CALIBRATION_BIAS_THRESHOLD_PCT)
+        return "under";
+    if (avgErrorPct < -CALIBRATION_BIAS_THRESHOLD_PCT)
+        return "over";
+    return "balanced";
+}
+function computeTrend(points) {
+    if (points.length < 3)
+        return "insufficient_data";
+    const half = Math.floor(points.length / 2);
+    const firstHalf = average(points.slice(0, half));
+    const secondHalf = average(points.slice(-half));
+    const delta = secondHalf - firstHalf;
+    if (delta > firstHalf * 0.1)
+        return "improving";
+    if (delta < -firstHalf * 0.1)
+        return "declining";
+    return "stable";
+}
+function average(values) {
+    return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+function round(value) {
+    return Math.round(value * 100) / 100;
+}
+//# sourceMappingURL=sprint-metrics.js.map

package/dist/sprint-metrics.js.map

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

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":"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"}