@jterrats/open-orchestra 0.5.5 → 1.0.1

package/dist/delivery-dashboard-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=delivery-dashboard-types.js.map

package/dist/delivery-dashboard-types.js.map

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

package/dist/delivery-dashboard.d.ts

@@ -0,0 +1,8 @@
+import type { DeliveryDashboard, DeliveryDashboardOptions } from "./delivery-dashboard-types.js";
+import type { CliOptions } from "./types.js";
+export declare function buildDeliveryDashboard(root: string): Promise<DeliveryDashboard>;
+export declare function writeDeliveryDashboard(root: string, options?: DeliveryDashboardOptions): Promise<{
+    dashboard: DeliveryDashboard;
+    outputPath?: string;
+}>;
+export declare function dashboardOptions(options: CliOptions): DeliveryDashboardOptions;

package/dist/delivery-dashboard.js

@@ -0,0 +1,124 @@
+import { spawnSync } from "node:child_process";
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { listAutonomousRuns } from "./autonomous-workflow.js";
+import { computeBenchmark, listEstimates } from "./benchmark.js";
+import { chartData, effortMetrics } from "./delivery-dashboard-charts.js";
+import { renderDeliveryDashboardHtml } from "./delivery-dashboard-html.js";
+import { ensureDir, exists, resolveWorkflowPath, resolveWorkspaceWritePath, } from "./fs-utils.js";
+import { loadWorkspace, readEvents } from "./workspace.js";
+import { getUsageReport } from "./workflow-services.js";
+const DEFAULT_OUTPUT = "docs/dashboard.html";
+export async function buildDeliveryDashboard(root) {
+    await assertDashboardState(root);
+    const [workspace, runs, events, estimates, usage] = await Promise.all([
+        loadWorkspace(root),
+        listAutonomousRuns(root),
+        readEvents(root),
+        listEstimates(root),
+        getUsageReport(undefined, root),
+    ]);
+    const benchmarks = await Promise.all(estimates.map((estimate) => computeBenchmark(root, estimate.taskId)));
+    return {
+        project: {
+            name: await projectName(root),
+            root,
+            generatedAt: new Date().toISOString(),
+        },
+        metrics: {
+            tasks: taskMetrics(workspace.tasks, benchmarks, runs.length),
+            effort: effortMetrics(benchmarks.map((story) => story.effortBreakdown)),
+            evidence: evidenceMetrics(events),
+        },
+        charts: chartData(workspace.tasks, benchmarks, runs, events),
+        stories: benchmarks.map((benchmark) => ({
+            taskId: benchmark.taskId,
+            status: benchmark.status,
+            sizingLabel: benchmark.sizingLabel,
+            actualHours: benchmark.actualHours,
+            classification: benchmark.effortBreakdown.classification,
+            effort: effortMetrics([benchmark.effortBreakdown]),
+        })),
+        usage,
+    };
+}
+export async function writeDeliveryDashboard(root, options = {}) {
+    const dashboard = await buildDeliveryDashboard(root);
+    if ((options.format ?? "html") === "json") {
+        return { dashboard };
+    }
+    const outputPath = resolveWorkspaceWritePath(root, options.output ?? DEFAULT_OUTPUT);
+    await ensureDir(path.dirname(outputPath));
+    await writeFile(outputPath, renderDeliveryDashboardHtml(dashboard), "utf8");
+    if (options.open)
+        openFile(outputPath);
+    return { dashboard, outputPath };
+}
+export function dashboardOptions(options) {
+    const format = typeof options.format === "string" ? options.format : "html";
+    if (format !== "html" && format !== "json") {
+        throw new Error("--format must be html or json");
+    }
+    return {
+        ...(typeof options.output === "string" ? { output: options.output } : {}),
+        format,
+        open: Boolean(options.open),
+        recalculateEffort: Boolean(options["recalculate-effort"]),
+    };
+}
+async function assertDashboardState(root) {
+    const required = ["tasks.json", "events.jsonl", "workflow-runs.jsonl"];
+    const missing = [];
+    for (const file of required) {
+        if (!(await exists(resolveWorkflowPath(root, file))))
+            missing.push(file);
+    }
+    if (missing.length > 0) {
+        throw new Error(`dashboard requires initialized workflow state: ${missing.join(", ")}`);
+    }
+}
+async function projectName(root) {
+    const packagePath = path.join(root, "package.json");
+    if (await exists(packagePath)) {
+        const pkg = JSON.parse(await readFile(packagePath, "utf8"));
+        if (pkg.name)
+            return pkg.name;
+    }
+    return path.basename(root);
+}
+function taskMetrics(tasks, benchmarks, workflowRuns) {
+    const done = tasks.filter((task) => task.status === "done").length;
+    const completedBenchmarks = benchmarks.filter((story) => story.actualHours !== null);
+    const avgCycleHours = completedBenchmarks.length > 0
+        ? roundHours(completedBenchmarks.reduce((sum, story) => sum + (story.actualHours ?? 0), 0) / completedBenchmarks.length)
+        : null;
+    return {
+        total: tasks.length,
+        done,
+        claimed: tasks.filter((task) => ["in_progress", "review", "approved"].includes(task.status)).length,
+        open: tasks.filter((task) => task.status !== "done").length,
+        completionPct: tasks.length > 0 ? Math.round((done / tasks.length) * 100) : 0,
+        avgCycleHours,
+        workflowRuns,
+    };
+}
+function evidenceMetrics(events) {
+    return {
+        count: events.filter((event) => event.type === "EVIDENCE_ADDED").length,
+        decisions: events.filter((event) => event.type === "DECISION_RECORDED")
+            .length,
+    };
+}
+function openFile(filePath) {
+    const command = process.platform === "darwin"
+        ? "open"
+        : process.platform === "win32"
+            ? "cmd"
+            : "xdg-open";
+    const args = process.platform === "win32" ? ["/c", "start", "", filePath] : [filePath];
+    spawnSync(command, args, { stdio: "ignore" });
+}
+function roundHours(value) {
+    return Math.round(value * 100) / 100;
+}
+//# sourceMappingURL=delivery-dashboard.js.map

package/dist/delivery-dashboard.js.map

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

package/dist/doc-sync.d.ts

@@ -0,0 +1,25 @@
+import type { PromptRegistryFileName } from "./prompt-registry.js";
+export interface DocSyncAuditOptions {
+    root?: string;
+    taskId?: string;
+    strict?: boolean;
+}
+export interface DocSyncPromptIssue {
+    severity: "warning" | "error";
+    path: string;
+    register: PromptRegistryFileName;
+    message: string;
+    recommendation: string;
+}
+export interface DocSyncLessonSuggestion {
+    path: string;
+    reason: string;
+    command: string;
+}
+export interface DocSyncAuditReport {
+    valid: boolean;
+    changedPaths: string[];
+    promptIssues: DocSyncPromptIssue[];
+    lessonSuggestions: DocSyncLessonSuggestion[];
+}
+export declare function auditDocSync(options?: DocSyncAuditOptions): Promise<DocSyncAuditReport>;

package/dist/doc-sync.js

@@ -0,0 +1,79 @@
+import { hasPromptRegistryCoverage, readPromptRegistryEntries, readRelevantPromptRegistryChangedPaths, } from "./prompt-registry-validation.js";
+export async function auditDocSync(options = {}) {
+    const root = options.root ?? process.cwd();
+    const changedPaths = (await readRelevantPromptRegistryChangedPaths(root))
+        .filter(isDocumentationSyncPath)
+        .sort();
+    const entries = await readPromptRegistryEntries(root);
+    const promptIssues = changedPaths.flatMap((changedPath) => expectedDocSyncRegisters(changedPath).flatMap((register) => {
+        const registerEntries = entries.get(register) ?? [];
+        if (hasPromptRegistryCoverage(registerEntries, changedPath))
+            return [];
+        return [
+            buildPromptIssue({
+                changedPath,
+                register,
+                strict: options.strict ?? false,
+            }),
+        ];
+    }));
+    const lessonSuggestions = changedPaths.flatMap((changedPath) => lessonSuggestionForPath({
+        changedPath,
+        entries: expectedDocSyncRegisters(changedPath).flatMap((register) => entries.get(register) ?? []),
+        ...(options.taskId ? { taskId: options.taskId } : {}),
+    }));
+    return {
+        valid: !promptIssues.some((issue) => issue.severity === "error"),
+        changedPaths,
+        promptIssues,
+        lessonSuggestions,
+    };
+}
+function buildPromptIssue({ changedPath, register, strict, }) {
+    return {
+        severity: strict ? "error" : "warning",
+        path: changedPath,
+        register,
+        message: `doc-sync missing prompt registry coverage for ${changedPath}`,
+        recommendation: `Run orchestra prompts update --artifact "${changedPath}" --paths "${changedPath}" --register ${register.replace(".md", "")}`,
+    };
+}
+function lessonSuggestionForPath({ changedPath, entries, taskId, }) {
+    const matchedEntries = entries.filter((entry) => entry.includes(changedPath));
+    const hasRepeatedWork = matchedEntries.some((entry) => {
+        const iterations = /^- \*\*Iterations:\*\*\s+(\d+)$/m.exec(entry)?.[1];
+        return Number(iterations ?? "0") > 1;
+    });
+    if (!hasRepeatedWork)
+        return [];
+    const taskFlag = taskId ? ` --task ${taskId}` : "";
+    return [
+        {
+            path: changedPath,
+            reason: "This documentation artifact has multiple prompt iterations; capture a lesson if the change corrected a repeatable drift, missed evidence, or unclear architecture wording.",
+            command: `orchestra lessons assist${taskFlag} --role technical_writer --operation doc-sync --failed-action "repeat documentation correction for ${changedPath}" --error-signature "documentation rework pattern" --root-cause "<why the drift happened>" --fix "<what changed>" --prevention "<how to avoid it next time>" --applies-to "documentation,doc-sync" --verified-by "<validation command or review>"`,
+        },
+    ];
+}
+function isDocumentationSyncPath(path) {
+    const normalized = path.toLowerCase();
+    return (normalized === "readme.md" ||
+        normalized === "changelog.md" ||
+        normalized.startsWith("docs/") ||
+        normalized.startsWith("site/") ||
+        normalized.includes("architecture") ||
+        normalized.includes("diagram") ||
+        normalized.includes("mermaid") ||
+        normalized.endsWith(".mmd"));
+}
+function expectedDocSyncRegisters(path) {
+    const normalized = path.toLowerCase();
+    if (normalized.includes("architecture") ||
+        normalized.includes("diagram") ||
+        normalized.includes("mermaid") ||
+        normalized.endsWith(".mmd")) {
+        return ["diagrams.md"];
+    }
+    return ["docs.md"];
+}
+//# sourceMappingURL=doc-sync.js.map

package/dist/doc-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-sync.js","sourceRoot":"","sources":["../src/doc-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,sCAAsC,GACvC,MAAM,iCAAiC,CAAC;AA8BzC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAA+B,EAAE;IAEjC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3C,MAAM,YAAY,GAAG,CAAC,MAAM,sCAAsC,CAAC,IAAI,CAAC,CAAC;SACtE,MAAM,CAAC,uBAAuB,CAAC;SAC/B,IAAI,EAAE,CAAC;IACV,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CACxD,wBAAwB,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QACzD,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,yBAAyB,CAAC,eAAe,EAAE,WAAW,CAAC;YAAE,OAAO,EAAE,CAAC;QACvE,OAAO;YACL,gBAAgB,CAAC;gBACf,WAAW;gBACX,QAAQ;gBACR,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;aAChC,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IACF,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAC7D,uBAAuB,CAAC;QACtB,WAAW;QACX,OAAO,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC,OAAO,CACpD,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAC1C;QACD,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CACH,CAAC;IACF,OAAO;QACL,KAAK,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC;QAChE,YAAY;QACZ,YAAY;QACZ,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,EACxB,WAAW,EACX,QAAQ,EACR,MAAM,GAKP;IACC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACtC,IAAI,EAAE,WAAW;QACjB,QAAQ;QACR,OAAO,EAAE,iDAAiD,WAAW,EAAE;QACvE,cAAc,EAAE,4CAA4C,WAAW,cAAc,WAAW,gBAAgB,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE;KAC9I,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,EAC/B,WAAW,EACX,OAAO,EACP,MAAM,GAKP;IACC,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QACpD,MAAM,UAAU,GAAG,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvE,OAAO,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,eAAe;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,OAAO;QACL;YACE,IAAI,EAAE,WAAW;YACjB,MAAM,EACJ,4KAA4K;YAC9K,OAAO,EAAE,2BAA2B,QAAQ,sGAAsG,WAAW,mPAAmP;SACjZ;KACF,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAY;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,CACL,UAAU,KAAK,WAAW;QAC1B,UAAU,KAAK,cAAc;QAC7B,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC;QAC9B,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC;QAC9B,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC;QACnC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC9B,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC9B,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC5B,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAY;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,IACE,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC;QACnC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC9B,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC9B,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC3B,CAAC;QACD,OAAO,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,SAAS,CAAC,CAAC;AACrB,CAAC"}

package/dist/effort-classification.d.ts

@@ -0,0 +1,7 @@
+import type { EstimateRecord, EffortBreakdown } from "./types/metrics.js";
+import type { AutonomousRun, BenchmarkPhaseDuration } from "./types/workflow-run.js";
+export declare function pendingEffortBreakdown(estimate: EstimateRecord): EffortBreakdown;
+export declare function manualEffortBreakdown(estimate: EstimateRecord, timing: {
+    hours: number;
+}): EffortBreakdown;
+export declare function workflowEffortBreakdown(estimate: EstimateRecord, run: AutonomousRun, phaseDurations: BenchmarkPhaseDuration[]): EffortBreakdown;

package/dist/effort-classification.js

@@ -0,0 +1,72 @@
+export function pendingEffortBreakdown(estimate) {
+    return {
+        aiAutonomousMinutes: 0,
+        aiSupervisedMinutes: 0,
+        aiCalibrationBaselineMinutes: daysToMinutes(estimate.aiUnguidedEstimateDays),
+        humanReviewMinutes: 0,
+        humanManualMinutes: 0,
+        classification: "pending",
+        notes: [
+            "No completed run or task lifecycle duration exists yet.",
+            "AI calibration baseline comes from the declared ai-unguided estimate.",
+        ],
+    };
+}
+export function manualEffortBreakdown(estimate, timing) {
+    return {
+        aiAutonomousMinutes: 0,
+        aiSupervisedMinutes: 0,
+        aiCalibrationBaselineMinutes: daysToMinutes(estimate.aiUnguidedEstimateDays),
+        humanReviewMinutes: 0,
+        humanManualMinutes: roundMinutes(timing.hours * 60),
+        classification: "human_manual",
+        notes: [
+            "No completed workflow phase evidence was found, so lifecycle duration is classified as human manual effort.",
+            "AI calibration baseline comes from the declared ai-unguided estimate.",
+        ],
+    };
+}
+export function workflowEffortBreakdown(estimate, run, phaseDurations) {
+    const phaseMinutes = roundMinutes(phaseDurations.reduce((sum, phase) => sum + (phase.durationMs ?? 0), 0) /
+        1000 /
+        60);
+    const humanReviewMinutes = gateReviewMinutes(run);
+    const isAutonomous = run.gates === "none";
+    return {
+        aiAutonomousMinutes: isAutonomous ? phaseMinutes : 0,
+        aiSupervisedMinutes: isAutonomous ? 0 : phaseMinutes,
+        aiCalibrationBaselineMinutes: daysToMinutes(estimate.aiUnguidedEstimateDays),
+        humanReviewMinutes,
+        humanManualMinutes: 0,
+        classification: isAutonomous ? "ai_autonomous" : "ai_supervised",
+        notes: [
+            isAutonomous
+                ? "Workflow ran without human phase gates; phase time is classified as ai_autonomous."
+                : "Workflow used human phase gates; phase time is classified as ai_supervised and gate approval time is human_review.",
+            "Gate mode controls supervision checkpoints, not whether project rules, skills, and playbooks were available.",
+            "AI calibration baseline comes from the declared ai-unguided estimate.",
+        ],
+    };
+}
+function gateReviewMinutes(run) {
+    const totalMs = run.phases.reduce((sum, phase, index) => {
+        if (!phase.gateId || !phase.completedAt)
+            return sum;
+        const reviewEnd = phase.approvedAt ?? run.phases[index + 1]?.startedAt;
+        if (!reviewEnd)
+            return sum;
+        const started = new Date(phase.completedAt).getTime();
+        const ended = new Date(reviewEnd).getTime();
+        if (!Number.isFinite(started) || !Number.isFinite(ended))
+            return sum;
+        return sum + Math.max(0, ended - started);
+    }, 0);
+    return roundMinutes(totalMs / 1000 / 60);
+}
+function daysToMinutes(days) {
+    return Math.round(days * 24 * 60);
+}
+function roundMinutes(minutes) {
+    return Math.round(minutes * 100) / 100;
+}
+//# sourceMappingURL=effort-classification.js.map

package/dist/effort-classification.js.map

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

package/dist/extension-commands.d.ts

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

package/dist/extension-commands.js

@@ -0,0 +1,40 @@
+import { discoverExtensions } from "./extensions.js";
+export async function extensionsListCommand(options, io) {
+    const extensions = await discoverExtensions();
+    if (options.json) {
+        io.log(JSON.stringify(extensions, null, 2));
+        return;
+    }
+    if (extensions.length === 0) {
+        io.log("No extensions discovered");
+        return;
+    }
+    for (const extension of extensions) {
+        io.log(`${extension.manifest?.id ?? extension.path}: ${extension.valid ? "valid" : "invalid"}`);
+    }
+}
+export async function extensionsValidateCommand(options, io) {
+    const extensions = await discoverExtensions();
+    const result = {
+        valid: extensions.every((extension) => extension.valid),
+        extensions,
+    };
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        io.log(result.valid ? "Extensions valid" : "Extensions invalid");
+        for (const extension of extensions) {
+            for (const error of extension.errors) {
+                io.log(`ERROR ${extension.path}: ${error}`);
+            }
+            for (const warning of extension.warnings) {
+                io.log(`WARN ${extension.path}: ${warning}`);
+            }
+        }
+    }
+    if (!result.valid) {
+        throw new Error("extensions validation failed");
+    }
+}
+//# sourceMappingURL=extension-commands.js.map

package/dist/extension-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-commands.js","sourceRoot":"","sources":["../src/extension-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAmB,EACnB,EAAS;IAET,MAAM,UAAU,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC9C,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,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,EAAE,CAAC,GAAG,CACJ,GAAG,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,SAAS,CAAC,IAAI,KACzC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAC9B,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAmB,EACnB,EAAS;IAET,MAAM,UAAU,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC;QACvD,UAAU;KACX,CAAC;IACF,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,kBAAkB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;QACjE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;gBACrC,EAAE,CAAC,GAAG,CAAC,SAAS,SAAS,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;YAC9C,CAAC;YACD,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACzC,EAAE,CAAC,GAAG,CAAC,QAAQ,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/extensions.d.ts

@@ -0,0 +1,22 @@
+export type ExtensionPoint = "skill" | "tracker-adapter" | "provider-adapter" | "phase-playbook" | "refresh-target";
+export interface ExtensionManifest {
+    id: string;
+    name: string;
+    version: string;
+    compatibility: {
+        orchestra: string;
+    };
+    extensionPoints: ExtensionPoint[];
+    entry?: string;
+    capabilities?: string[];
+    riskAreas?: string[];
+}
+export interface ExtensionValidationResult {
+    valid: boolean;
+    manifest?: ExtensionManifest;
+    path: string;
+    errors: string[];
+    warnings: string[];
+}
+export declare function discoverExtensions(root?: string): Promise<ExtensionValidationResult[]>;
+export declare function validateExtensionManifest(extensionPath: string): Promise<ExtensionValidationResult>;

package/dist/extensions.js

@@ -0,0 +1,126 @@
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+import { readJson, resolveWorkflowPath } from "./fs-utils.js";
+export async function discoverExtensions(root = process.cwd()) {
+    const base = resolveWorkflowPath(root, "extensions");
+    let entries;
+    try {
+        entries = await readdir(base);
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const entry of entries.sort()) {
+        results.push(await validateExtensionManifest(path.join(base, entry)));
+    }
+    return results;
+}
+export async function validateExtensionManifest(extensionPath) {
+    const manifestPath = path.join(extensionPath, "manifest.json");
+    const errors = [];
+    const warnings = [];
+    const raw = await readJson(manifestPath, {});
+    const manifest = normalizeManifest(raw);
+    validateRequiredFields(raw, errors);
+    validateExtensionId(raw.id, errors);
+    validateExtensionPoints(raw.extensionPoints, errors);
+    validateCompatibility(raw.compatibility, warnings);
+    validateEntryPath(raw.entry, errors);
+    if (manifest.extensionPoints.includes("provider-adapter")) {
+        warnings.push("provider-adapter extensions are metadata-only until runtime provider loading is stabilized");
+    }
+    return {
+        valid: errors.length === 0,
+        manifest,
+        path: manifestPath,
+        errors,
+        warnings,
+    };
+}
+function normalizeManifest(raw) {
+    return {
+        id: stringValue(raw.id),
+        name: stringValue(raw.name),
+        version: stringValue(raw.version),
+        compatibility: {
+            orchestra: stringValue(isRecord(raw.compatibility) ? raw.compatibility.orchestra : undefined),
+        },
+        extensionPoints: Array.isArray(raw.extensionPoints)
+            ? raw.extensionPoints.filter(isExtensionPoint)
+            : [],
+        ...(typeof raw.entry === "string" ? { entry: raw.entry } : {}),
+        ...(Array.isArray(raw.capabilities)
+            ? { capabilities: raw.capabilities.filter(isString) }
+            : {}),
+        ...(Array.isArray(raw.riskAreas)
+            ? { riskAreas: raw.riskAreas.filter(isString) }
+            : {}),
+    };
+}
+function validateRequiredFields(raw, errors) {
+    for (const field of [
+        "id",
+        "name",
+        "version",
+        "compatibility",
+        "extensionPoints",
+    ]) {
+        if (!(field in raw))
+            errors.push(`manifest missing ${field}`);
+    }
+    if (!isRecord(raw.compatibility) || !isString(raw.compatibility.orchestra)) {
+        errors.push("manifest compatibility.orchestra is required");
+    }
+}
+function validateExtensionId(value, errors) {
+    if (!isString(value) || !/^[a-z0-9][a-z0-9._-]{1,62}$/i.test(value)) {
+        errors.push("manifest id must be 2-63 characters using letters, numbers, dots, underscores, or dashes");
+    }
+}
+function validateExtensionPoints(value, errors) {
+    if (!Array.isArray(value) || value.length === 0) {
+        errors.push("manifest extensionPoints must include at least one extension point");
+        return;
+    }
+    const invalid = value.filter((item) => !isExtensionPoint(item));
+    if (invalid.length > 0) {
+        errors.push(`unsupported extension point(s): ${invalid.join(", ")}`);
+    }
+}
+function validateCompatibility(value, warnings) {
+    const orchestra = isRecord(value) ? stringValue(value.orchestra) : "";
+    if (!orchestra)
+        return;
+    if (!/^(\^|>=)?(0\.5|1\.0)/.test(orchestra)) {
+        warnings.push(`compatibility.orchestra ${orchestra} is outside the documented 0.5/1.0 contract range`);
+    }
+}
+function validateEntryPath(value, errors) {
+    if (value === undefined)
+        return;
+    if (!isString(value)) {
+        errors.push("manifest entry must be a relative path");
+        return;
+    }
+    if (path.isAbsolute(value) || value.split(/[\\/]/).includes("..")) {
+        errors.push("manifest entry must stay inside the extension directory");
+    }
+}
+function isExtensionPoint(value) {
+    return (value === "skill" ||
+        value === "tracker-adapter" ||
+        value === "provider-adapter" ||
+        value === "phase-playbook" ||
+        value === "refresh-target");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isString(value) {
+    return typeof value === "string" && value.trim() !== "";
+}
+function stringValue(value) {
+    return isString(value) ? value : "";
+}
+//# sourceMappingURL=extensions.js.map

package/dist/extensions.js.map

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

package/dist/gemini-provider.d.ts

@@ -1,13 +1,10 @@
+import { type ModelProviderRuntimeOptions } from "./provider-utils.js";
 import type { ModelProvider, ModelProviderCapabilities, ModelRequest, ModelResponse } from "./types.js";
 export declare class GeminiModelProvider implements ModelProvider {
     readonly id = "gemini";
     readonly capabilities: ModelProviderCapabilities;
-    private readonly fetchFn;
-    private readonly env;
-    constructor({ fetchFn, env, }?: {
-        fetchFn?: typeof fetch;
-        env?: NodeJS.ProcessEnv;
-    });
+    private readonly runtime;
+    constructor(options?: ModelProviderRuntimeOptions);
     complete(request: ModelRequest): Promise<ModelResponse>;
     private sendRequest;
 }

package/dist/gemini-provider.js

@@ -1,26 +1,17 @@
-import { apiKeyFromEnvFile, joinUrlPath, numberFrom, stringFrom, } from "./provider-utils.js";
+import { apiKeyFromEnvFile, joinUrlPath, modelProviderCapabilities, modelProviderRuntime, numberFrom, stringFrom, } from "./provider-utils.js";
 export class GeminiModelProvider {
     id = "gemini";
-    capabilities = {
-        streaming: false,
-        tools: false,
-        vision: false,
-        jsonMode: true,
-        maxContextTokens: 0,
-        timeoutMs: 30000,
-    };
-    fetchFn;
-    env;
-    constructor({ fetchFn = fetch, env = process.env, } = {}) {
-        this.fetchFn = fetchFn;
-        this.env = env;
+    capabilities = modelProviderCapabilities();
+    runtime;
+    constructor(options = {}) {
+        this.runtime = modelProviderRuntime(options);
     }
     async complete(request) {
-        const apiKey = geminiApiKey(this.env);
+        const apiKey = geminiApiKey(this.runtime.env);
         if (!apiKey) {
             throw new Error("GEMINI_API_KEY is required for provider gemini");
         }
-        const endpoint = geminiGenerateContentEndpoint(this.env.GEMINI_BASE_URL, request.model);
+        const endpoint = geminiGenerateContentEndpoint(this.runtime.env.GEMINI_BASE_URL, request.model);
         const response = await this.sendRequest(endpoint, apiKey, request, geminiRequestBody(request));
         const finalResponse = response.status === 403 && request.jsonMode
             ? await this.sendRequest(endpoint, apiKey, request, geminiRequestBody(request, { responseMimeType: false }))
@@ -42,7 +33,7 @@ export class GeminiModelProvider {
         };
     }
     async sendRequest(endpoint, apiKey, request, body) {
-        return this.fetchFn(endpoint, {
+        return this.runtime.fetchFn(endpoint, {
             method: "POST",
             headers: {
                 "x-goog-api-key": apiKey,