@jterrats/open-orchestra 0.5.5 → 1.0.1

package/dist/tracker-adapters.d.ts

@@ -0,0 +1,71 @@
+export type TrackerProvider = "github" | "jira" | "gitlab" | "bitbucket";
+export type TrackerAdapterTransport = "cli" | "mcp-skill";
+export type TrackerIssueState = "open" | "in_progress" | "blocked" | "done";
+export interface TrackerAdapterContract {
+    tracker: TrackerProvider;
+    nativeCli: string;
+    mcpSkill: string;
+    operations: Array<"issue-read" | "comment-upsert" | "close">;
+}
+export interface TrackerTransportSelection {
+    tracker: TrackerProvider;
+    transport: TrackerAdapterTransport;
+    reason: string;
+}
+export interface NormalizedTrackerIssue {
+    tracker: TrackerProvider;
+    remoteId: string;
+    url?: string;
+    title: string;
+    body?: string;
+    state?: TrackerIssueState;
+    labels: string[];
+    assignees: string[];
+    acceptanceCriteria: string[];
+    updatedAt?: string;
+}
+export interface TrackerSyncPlan {
+    tracker: TrackerProvider;
+    remoteId: string;
+    taskId: string;
+    action: "create" | "update" | "none" | "conflict";
+    conflicts: string[];
+    mappedFields: string[];
+}
+export declare function listTrackerAdapterContracts(): TrackerAdapterContract[];
+export declare function getTrackerAdapterContract(tracker: string): TrackerAdapterContract;
+export declare function selectTrackerTransport({ tracker, requestedTransport, cliAvailable, mcpSkillAvailable, }: {
+    tracker: string;
+    requestedTransport?: TrackerAdapterTransport;
+    cliAvailable: boolean;
+    mcpSkillAvailable: boolean;
+}): TrackerTransportSelection;
+export declare function normalizeTrackerIssue(input: {
+    tracker: string;
+    remoteId: string | number;
+    url?: unknown;
+    title: unknown;
+    body?: unknown;
+    state?: unknown;
+    labels?: unknown;
+    assignees?: unknown;
+    acceptanceCriteria?: unknown;
+    updatedAt?: unknown;
+}): NormalizedTrackerIssue;
+export declare function defaultTrackerTaskId(issue: NormalizedTrackerIssue): string;
+export declare function trackerIssueTaskFields(issue: NormalizedTrackerIssue): {
+    title: string;
+    backlogItem: string;
+    goal?: string;
+    acceptanceCriteria?: string[];
+    risks?: string[];
+    status?: "pending" | "in_progress" | "blocked" | "done";
+};
+export declare function planTrackerSync(input: {
+    issue: NormalizedTrackerIssue;
+    taskId?: string;
+    existingTask?: {
+        title: string;
+        backlogItem?: string;
+    };
+}): TrackerSyncPlan;

package/dist/tracker-adapters.js

@@ -0,0 +1,186 @@
+const TRACKER_CONTRACTS = [
+    contract("github", "gh", "github-mcp"),
+    contract("jira", "jira", "jira-mcp"),
+    contract("gitlab", "glab", "gitlab-mcp"),
+    contract("bitbucket", "bb", "bitbucket-mcp"),
+];
+export function listTrackerAdapterContracts() {
+    return TRACKER_CONTRACTS.map((item) => ({
+        ...item,
+        operations: [...item.operations],
+    }));
+}
+export function getTrackerAdapterContract(tracker) {
+    const normalized = normalizeTrackerProvider(tracker);
+    const contract = TRACKER_CONTRACTS.find((item) => item.tracker === normalized);
+    if (!contract) {
+        throw new Error(`unsupported tracker: ${tracker}`);
+    }
+    return { ...contract, operations: [...contract.operations] };
+}
+export function selectTrackerTransport({ tracker, requestedTransport, cliAvailable, mcpSkillAvailable, }) {
+    const contract = getTrackerAdapterContract(tracker);
+    if (requestedTransport === "cli") {
+        if (!cliAvailable) {
+            throw new Error(`${contract.tracker} CLI transport requires ${contract.nativeCli}`);
+        }
+        return {
+            tracker: contract.tracker,
+            transport: "cli",
+            reason: `${contract.nativeCli} CLI selected explicitly`,
+        };
+    }
+    if (requestedTransport === "mcp-skill") {
+        if (!mcpSkillAvailable) {
+            throw new Error(`${contract.tracker} MCP skill transport requires ${contract.mcpSkill}`);
+        }
+        return {
+            tracker: contract.tracker,
+            transport: "mcp-skill",
+            reason: `${contract.mcpSkill} selected explicitly`,
+        };
+    }
+    if (cliAvailable) {
+        return {
+            tracker: contract.tracker,
+            transport: "cli",
+            reason: `${contract.nativeCli} CLI available`,
+        };
+    }
+    if (mcpSkillAvailable) {
+        return {
+            tracker: contract.tracker,
+            transport: "mcp-skill",
+            reason: `${contract.nativeCli} unavailable; ${contract.mcpSkill} fallback available`,
+        };
+    }
+    throw new Error(`${contract.tracker} tracker sync requires ${contract.nativeCli} CLI or ${contract.mcpSkill} MCP skill`);
+}
+export function normalizeTrackerIssue(input) {
+    const tracker = normalizeTrackerProvider(input.tracker);
+    const state = normalizeTrackerIssueState(input.state);
+    if (typeof input.title !== "string" || input.title.trim() === "") {
+        throw new Error("tracker issue title is required");
+    }
+    return {
+        tracker,
+        remoteId: String(input.remoteId),
+        ...(typeof input.url === "string" && input.url.trim()
+            ? { url: input.url }
+            : {}),
+        title: input.title,
+        ...(typeof input.body === "string" ? { body: input.body } : {}),
+        ...(state ? { state } : {}),
+        labels: stringArray(input.labels),
+        assignees: stringArray(input.assignees),
+        acceptanceCriteria: stringArray(input.acceptanceCriteria),
+        ...(typeof input.updatedAt === "string" && input.updatedAt.trim()
+            ? { updatedAt: input.updatedAt }
+            : {}),
+    };
+}
+export function defaultTrackerTaskId(issue) {
+    return `${issue.tracker.toUpperCase()}-${issue.remoteId.replace(/[^a-z0-9]+/gi, "-").replace(/^-|-$/g, "")}`;
+}
+export function trackerIssueTaskFields(issue) {
+    const goal = issue.body ? firstSection(issue.body, "User Story") : undefined;
+    return {
+        title: issue.title,
+        backlogItem: issue.url ?? `${issue.tracker}:${issue.remoteId}`,
+        ...(goal ? { goal } : {}),
+        ...(issue.acceptanceCriteria.length > 0
+            ? { acceptanceCriteria: issue.acceptanceCriteria }
+            : {}),
+        ...(issue.labels.length > 0 ? { risks: issue.labels } : {}),
+        ...(issue.state ? { status: trackerStateToTaskStatus(issue.state) } : {}),
+    };
+}
+export function planTrackerSync(input) {
+    const taskId = input.taskId ?? defaultTrackerTaskId(input.issue);
+    const fields = trackerIssueTaskFields(input.issue);
+    if (!input.existingTask) {
+        return {
+            tracker: input.issue.tracker,
+            remoteId: input.issue.remoteId,
+            taskId,
+            action: "create",
+            conflicts: [],
+            mappedFields: mappedTrackerFields(fields),
+        };
+    }
+    const conflicts = [];
+    if (input.existingTask.backlogItem &&
+        input.existingTask.backlogItem !== fields.backlogItem) {
+        conflicts.push(`task ${taskId} is already linked to ${input.existingTask.backlogItem}`);
+    }
+    return {
+        tracker: input.issue.tracker,
+        remoteId: input.issue.remoteId,
+        taskId,
+        action: conflicts.length > 0
+            ? "conflict"
+            : input.existingTask.title === fields.title
+                ? "none"
+                : "update",
+        conflicts,
+        mappedFields: mappedTrackerFields(fields),
+    };
+}
+function contract(tracker, nativeCli, mcpSkill) {
+    return {
+        tracker,
+        nativeCli,
+        mcpSkill,
+        operations: ["issue-read", "comment-upsert", "close"],
+    };
+}
+function normalizeTrackerProvider(tracker) {
+    const normalized = tracker.toLowerCase().trim();
+    if (normalized === "github" ||
+        normalized === "jira" ||
+        normalized === "gitlab" ||
+        normalized === "bitbucket") {
+        return normalized;
+    }
+    throw new Error(`unsupported tracker: ${tracker}`);
+}
+function normalizeTrackerIssueState(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const normalized = value
+        .toLowerCase()
+        .trim()
+        .replace(/[-\s]+/g, "_");
+    if (normalized === "open" ||
+        normalized === "in_progress" ||
+        normalized === "blocked" ||
+        normalized === "done") {
+        return normalized;
+    }
+    return undefined;
+}
+function trackerStateToTaskStatus(state) {
+    if (state === "open")
+        return "pending";
+    return state;
+}
+function stringArray(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === "string")
+        : [];
+}
+function mappedTrackerFields(fields) {
+    return Object.entries(fields)
+        .filter(([, value]) => Array.isArray(value) ? value.length > 0 : value !== undefined)
+        .map(([key]) => key);
+}
+function firstSection(body, heading) {
+    const pattern = new RegExp(`##\\s+${escapeRegExp(heading)}\\s*\\n([\\s\\S]*?)(?=\\n##\\s+|$)`, "i");
+    const match = body.match(pattern);
+    return match?.[1]?.trim();
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=tracker-adapters.js.map

package/dist/tracker-adapters.js.map

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

package/dist/tracker-commands.d.ts

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

package/dist/tracker-commands.js

@@ -0,0 +1,119 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { requireArg } from "./args.js";
+import { removeUndefined, stringOption, targetRootOption, } from "./command-utils.js";
+import { normalizeTaskStatus } from "./constants.js";
+import { resolveWorkspaceWritePath } from "./fs-utils.js";
+import { normalizeTrackerIssue, defaultTrackerTaskId, planTrackerSync, trackerIssueTaskFields, } from "./tracker-adapters.js";
+import { addEvidence, addTask, listTasks, updateTask, } from "./workflow-services.js";
+export async function trackerSyncCommand(options, io) {
+    const root = targetRootOption(options);
+    const tracker = requireArg(options, "tracker");
+    const remoteId = requireArg(options, "remote");
+    const issueFile = stringOption(options["issue-file"]);
+    if (!issueFile) {
+        throw new Error("tracker sync requires --issue-file with normalized tracker issue JSON; live provider runners must inject an adapter");
+    }
+    const payload = await readIssuePayload(root, issueFile);
+    const issue = normalizeTrackerIssue({
+        tracker,
+        remoteId,
+        title: payload.title,
+        url: payload.url,
+        body: payload.body,
+        state: payload.state,
+        labels: payload.labels,
+        assignees: payload.assignees,
+        acceptanceCriteria: payload.acceptanceCriteria,
+        updatedAt: payload.updatedAt,
+    });
+    const tasks = await listTasks(root);
+    const taskId = stringOption(options.task);
+    const effectiveTaskId = taskId ?? undefined;
+    const existing = tasks.find((task) => task.id === (effectiveTaskId ?? defaultTrackerTaskId(issue)) ||
+        task.backlogItem === (issue.url ?? `${issue.tracker}:${issue.remoteId}`));
+    const plan = planTrackerSync({
+        issue,
+        ...(effectiveTaskId ? { taskId: effectiveTaskId } : {}),
+        ...(existing
+            ? {
+                existingTask: {
+                    title: existing.title,
+                    ...(existing.backlogItem
+                        ? { backlogItem: existing.backlogItem }
+                        : {}),
+                },
+            }
+            : {}),
+    });
+    if (plan.action === "conflict") {
+        throw new Error(`tracker sync conflict: ${plan.conflicts.join("; ")}`);
+    }
+    const fields = trackerIssueTaskFields(issue);
+    const ownerRole = stringOption(options.owner) ?? existing?.ownerRole ?? "developer";
+    const status = parseTaskStatus(stringOption(options.status)) ?? fields.status;
+    const taskInput = removeUndefined({
+        id: plan.taskId,
+        title: fields.title,
+        ownerRole,
+        dependencies: existing?.dependencies ?? [],
+        status,
+        backlogItem: fields.backlogItem,
+        goal: fields.goal ?? existing?.goal,
+        acceptanceCriteria: fields.acceptanceCriteria ?? existing?.acceptanceCriteria,
+        risks: fields.risks ?? existing?.risks,
+        qaGate: existing?.qaGate ??
+            defaultQaPlanForImportedExecution(status, issue.tracker, issue.remoteId),
+    });
+    if (!options["dry-run"]) {
+        if (plan.action === "create") {
+            await addTask(taskInput, root);
+            if (status && status !== "pending") {
+                await updateTask({ id: taskInput.id, status }, root);
+            }
+        }
+        else if (plan.action === "update") {
+            await updateTask(taskInput, root);
+        }
+        await addEvidence({
+            task: plan.taskId,
+            role: "developer",
+            type: "report",
+            summary: `${issue.tracker} issue ${issue.remoteId} synchronized from normalized tracker adapter (${plan.action})`,
+        }, root);
+    }
+    const result = {
+        ...plan,
+        dryRun: Boolean(options["dry-run"]),
+        task: taskInput,
+        issue,
+    };
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    io.log(`${plan.tracker} ${plan.remoteId} -> ${plan.taskId}: ${plan.action}`);
+}
+async function readIssuePayload(root, issueFile) {
+    const issuePath = resolveWorkspaceWritePath(root, path.normalize(issueFile));
+    return JSON.parse(await readFile(issuePath, "utf8"));
+}
+function parseTaskStatus(value) {
+    if (!value) {
+        return undefined;
+    }
+    const status = normalizeTaskStatus(value);
+    if (!status) {
+        throw new Error(`invalid task status: ${value}`);
+    }
+    return status;
+}
+function defaultQaPlanForImportedExecution(status, tracker, remoteId) {
+    if (status !== "ready" && status !== "in_progress") {
+        return undefined;
+    }
+    return {
+        plan: `Validate imported ${tracker} issue ${remoteId} against mapped acceptance criteria, regression risk, and synchronization evidence before release.`,
+    };
+}
+//# sourceMappingURL=tracker-commands.js.map

package/dist/tracker-commands.js.map

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

package/dist/types/metrics.d.ts

@@ -8,6 +8,7 @@ export interface EstimateRecord {
     sizingLabel: SizingLabel;
     soloEstimateDays: number;
     aiUnguidedEstimateDays: number;
+    aiGuidedEstimateDays: number;
     confidence: EstimateConfidence;
     declaredBy: string;
     declaredAt: string;
@@ -17,9 +18,18 @@ export interface EstimateInput {
     sizingLabel: SizingLabel;
     soloEstimateDays: number;
     aiUnguidedEstimateDays: number;
+    aiGuidedEstimateDays: number;
     confidence: EstimateConfidence;
     declaredBy: string;
 }
+export interface EstimateCalibration {
+    baselineEstimateDays: number;
+    historicalMedian: number | null;
+    variance: number | null;
+    calibrationNote: string;
+    sampleSize: number;
+    ignored: boolean;
+}
 export interface BenchmarkQualitySignals {
     reviewCount: number;
     blockingReviews: number;
@@ -30,18 +40,30 @@ export interface BenchmarkQualitySignals {
     totalOutputTokens: number;
     estimatedCostUsd: number;
 }
+export interface EffortBreakdown {
+    aiAutonomousMinutes: number;
+    aiSupervisedMinutes: number;
+    aiCalibrationBaselineMinutes: number;
+    humanReviewMinutes: number;
+    humanManualMinutes: number;
+    classification: "ai_autonomous" | "ai_supervised" | "human_manual" | "pending";
+    notes: string[];
+}
 export interface BenchmarkResult {
     taskId: string;
     sizingLabel: SizingLabel;
     soloEstimateDays: number;
     aiUnguidedEstimateDays: number;
-    actualSource: "phase-timeline" | "task-lifecycle" | "none";
+    aiGuidedEstimateDays: number;
+    actualSource: "phase-timeline" | "task-lifecycle" | "task-timestamps" | "none";
     actualDays: number | null;
     actualHours: number | null;
     vsSoloPct: number | null;
     vsAiUnguidedPct: number | null;
+    vsAiGuidedPct: number | null;
     qaIterations: number;
     phaseDurations: BenchmarkPhaseDuration[];
+    effortBreakdown: EffortBreakdown;
     quality: BenchmarkQualitySignals;
     status: "pending" | "complete";
 }
@@ -50,6 +72,7 @@ export interface BenchmarkSummary {
     totalWithActuals: number;
     avgVsSoloPct: number | null;
     avgVsAiUnguidedPct: number | null;
+    avgVsAiGuidedPct: number | null;
 }
 export interface VelocityWeek {
     week: string;
@@ -62,6 +85,7 @@ export interface VelocityReport {
     avgActualDaysPerStory: number | null;
     avgVsSoloPct: number | null;
     avgVsAiUnguidedPct: number | null;
+    avgVsAiGuidedPct: number | null;
     weeks: VelocityWeek[];
     trend: "improving" | "stable" | "declining" | "insufficient_data";
 }

package/dist/types/model-config.d.ts

@@ -52,15 +52,19 @@ export interface ModelProviderError {
     message: string;
     retryable: boolean;
 }
+export interface ProviderFailureDetail {
+    provider: string;
+    code: "provider_error" | "timeout" | "permission_denied" | "policy_blocked";
+    reason: string;
+    retryable: boolean;
+    attempts: number;
+}
 export interface ProviderFallbackResult {
     provider: string;
     model: string;
     response: ModelResponse;
     fallbackUsed: boolean;
-    failedProviders: {
-        provider: string;
-        reason: string;
-    }[];
+    failedProviders: ProviderFailureDetail[];
 }
 export interface ModelProvenanceInput {
     task: string;
@@ -101,7 +105,13 @@ export interface PhaseStructuredOutput {
     decisions: string[];
     evidence: string[];
     handoff: string;
+    noOpRationale?: string;
+    architecturalConcerns?: {
+        inherited: string[];
+        selfImposed: string[];
+    };
     sizing?: string;
+    developerPoints?: number;
 }
 export interface PhaseLlmResult {
     mode: PhaseExecutionMode;
@@ -139,12 +149,43 @@ export interface ProviderRouting {
 export interface WorkflowProvidersConfig {
     defaults: ProviderRouting;
     byRole: Record<string, ProviderRouting>;
+    profiles?: Record<string, ProviderRuntimeProfile>;
+    activeProfile?: string;
 }
 export interface ProviderPolicyConfig {
     allowedProviders?: string[];
     blockedProviders?: string[];
     allowVendorFallbackWithoutApproval?: boolean;
 }
+export interface ProviderRuntimeProfile {
+    description?: string;
+    defaults?: ProviderRouting;
+    byRole: Record<string, ProviderRouting>;
+    budgets?: BudgetPolicy;
+    providerPolicy?: ProviderPolicyConfig;
+    requiredEnv?: string[];
+}
+export interface ProviderRuntimeProfileSummary {
+    name: string;
+    active: boolean;
+    description?: string;
+    roles: string[];
+    defaultProvider?: string;
+    defaultModel?: string;
+    requiredEnv: string[];
+}
+export interface ProviderProfileSmokeCheck {
+    scope: string;
+    provider: string;
+    model: string;
+    status: "pass" | "fail";
+    detail: string;
+}
+export interface ProviderProfileSmokeResult {
+    profile: string;
+    passed: boolean;
+    checks: ProviderProfileSmokeCheck[];
+}
 export interface ProviderCredentialConfig {
     apiKeyFile?: string;
     apiKeyFileEnv?: string;
@@ -202,6 +243,12 @@ export interface WorkflowConfig {
     budgets?: BudgetPolicy;
     workflow?: {
         phaseSequence?: string[];
+        architectureChallenge?: {
+            enabled?: boolean;
+            phase?: string;
+            role?: string;
+            summary?: string;
+        };
         phaseTimeoutMinutes?: number;
         playbooksDir?: string;
         phasePlaybooks?: Record<string, string>;