@jterrats/open-orchestra 1.0.15 → 1.0.17

package/dist/sprint-commands.js

@@ -2,6 +2,10 @@ 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";
+const SPRINT_COMMAND_HANDLERS = {
+    start: startSprintCommand,
+    close: closeSprintCommand,
+};
 export async function velocityCommand(options, io) {
     const cwd = process.cwd();
     if (typeof options.sprints === "string") {
@@ -42,32 +46,39 @@ export async function velocityCommand(options, io) {
     }
 }
 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)`);
+    if (isSprintSubcommand(subcommand)) {
+        await SPRINT_COMMAND_HANDLERS[subcommand](process.cwd(), options, io);
         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}`);
+    throw new Error(`unknown sprint command: ${subcommand ?? ""}`.trim());
+}
+function isSprintSubcommand(subcommand) {
+    return subcommand === "start" || subcommand === "close";
+}
+async function startSprintCommand(cwd, options, io) {
+    const id = requireArg(options, "id");
+    const taskIds = parseSprintTaskIds(requireArg(options, "tasks"));
+    const sprint = await startSprint(cwd, id, taskIds);
+    if (options.json) {
+        io.log(JSON.stringify(sprint, null, 2));
         return;
     }
-    throw new Error(`unknown sprint command: ${subcommand ?? ""}`.trim());
+    io.log(`Sprint started: ${sprint.id} (${sprint.taskIds.length} tasks)`);
+}
+async function closeSprintCommand(cwd, options, io) {
+    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}`);
+}
+function parseSprintTaskIds(tasks) {
+    return tasks
+        .split(",")
+        .map((taskId) => taskId.trim())
+        .filter(Boolean);
 }
 export async function calibrationCommand(options, io) {
     const report = await calibrationReport(process.cwd());

package/dist/sprint-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"sprint-commands.js","sourceRoot":"","sources":["../src/sprint-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,qBAAqB,CAAC;AAG7B,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAmB,EACnB,EAAS;IAET,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QACD,EAAE,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACjC,EAAE,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACnC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,EAAE,CAAC,GAAG,CACJ,KAAK,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,gBAAgB,aAAa,MAAM,CAAC,eAAe,MAAM,CAC1F,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAC1C,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;IAED,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC1B,EAAE,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC/D,EAAE,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC9D,EAAE,CAAC,GAAG,CACJ,wBAAwB,MAAM,CAAC,qBAAqB,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,qBAAqB,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAC7G,CAAC;IACF,EAAE,CAAC,GAAG,CACJ,wBAAwB,MAAM,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAC3F,CAAC;IACF,EAAE,CAAC,GAAG,CACJ,wBAAwB,MAAM,CAAC,kBAAkB,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CACvG,CAAC;IACF,EAAE,CAAC,GAAG,CACJ,wBAAwB,MAAM,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CACnG,CAAC;IACF,EAAE,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAE/C,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,EAAE,CAAC,GAAG,CACJ,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,gBAAgB,aAAa,IAAI,CAAC,eAAe,MAAM,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAA8B,EAC9B,OAAmB,EACnB,EAAS;IAET,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;aACzC,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;aAC9B,MAAM,CAAC,OAAO,CAAC,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QACD,EAAE,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;QACxE,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QACD,EAAE,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,MAAM,QAAQ,GAAG,UAAU;QACzB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE;QACpE,CAAC,CAAC,MAAM,CAAC;IAEX,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IAED,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,EAAE,CAAC,GAAG,CACJ,KAAK,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,OAAO,cAAc,IAAI,CAAC,eAAe,aAAa,IAAI,CAAC,aAAa,YAAY,IAAI,CAAC,WAAW,WAAW,IAAI,CAAC,IAAI,EAAE,CAC3J,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAmB,EACnB,EAAS;IAET,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC;SAChD,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;SAC9B,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC/D,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;IAED,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ;QAAE,EAAE,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAE9D,IAAI,MAAM,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;QAC7B,EAAE,CAAC,GAAG,CACJ,sFAAsF,CACvF,CAAC;QACF,OAAO;IACT,CAAC;IAED,EAAE,CAAC,GAAG,CACJ,0BAA0B,MAAM,CAAC,WAAW,eAAe,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,CACzF,CAAC;IACF,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACX,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IACpC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEX,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,eAAe,GACnB,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC5E,MAAM,eAAe,GACnB,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW;YAC3B,CAAC,CAAC,QAAQ,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;YACzC,CAAC,CAAC,SAAS,CAAC;QACd,EAAE,CAAC,GAAG,CACJ,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CACnI,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"sprint-commands.js","sourceRoot":"","sources":["../src/sprint-commands.ts"],"names":[],"mappings":"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"}

package/dist/structured-output-validation.d.ts

@@ -0,0 +1,9 @@
+export interface StructuredOutputValidationIssue {
+    path: string;
+    message: string;
+}
+export declare class StructuredOutputValidationError extends Error {
+    readonly issues: StructuredOutputValidationIssue[];
+    constructor(kind: string, issues: StructuredOutputValidationIssue[]);
+}
+export declare function assertNoStructuredOutputIssues(kind: string, issues: StructuredOutputValidationIssue[]): void;

package/dist/structured-output-validation.js

@@ -0,0 +1,20 @@
+export class StructuredOutputValidationError extends Error {
+    issues;
+    constructor(kind, issues) {
+        super(formatStructuredOutputError(kind, issues));
+        this.name = "StructuredOutputValidationError";
+        this.issues = issues;
+    }
+}
+export function assertNoStructuredOutputIssues(kind, issues) {
+    if (issues.length > 0) {
+        throw new StructuredOutputValidationError(kind, issues);
+    }
+}
+function formatStructuredOutputError(kind, issues) {
+    const details = issues
+        .map((issue) => `${issue.path}: ${issue.message}`)
+        .join("; ");
+    return `${kind} payload is invalid: ${details}`;
+}
+//# sourceMappingURL=structured-output-validation.js.map

package/dist/structured-output-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output-validation.js","sourceRoot":"","sources":["../src/structured-output-validation.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IAC/C,MAAM,CAAoC;IAEnD,YAAY,IAAY,EAAE,MAAyC;QACjE,KAAK,CAAC,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAC5C,IAAY,EACZ,MAAyC;IAEzC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,+BAA+B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAClC,IAAY,EACZ,MAAyC;IAEzC,MAAM,OAAO,GAAG,MAAM;SACnB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;SACjD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,GAAG,IAAI,wBAAwB,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/dist/transcription-failures.d.ts

@@ -0,0 +1,2 @@
+import type { TranscriptionFailure } from "./transcription-types.js";
+export declare function transcriptionFailure(code: TranscriptionFailure["code"], message: string, field?: string): TranscriptionFailure;

package/dist/transcription-failures.js

@@ -0,0 +1,4 @@
+export function transcriptionFailure(code, message, field) {
+    return field ? { code, message, field } : { code, message };
+}
+//# sourceMappingURL=transcription-failures.js.map

package/dist/transcription-failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcription-failures.js","sourceRoot":"","sources":["../src/transcription-failures.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAClC,IAAkC,EAClC,OAAe,EACf,KAAc;IAEd,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC9D,CAAC"}

package/dist/transcription-media-preflight.d.ts

@@ -0,0 +1,9 @@
+import type { NormalizedTranscriptionRequest, TranscriptionMediaPreflightResult, TranscriptionMediaProbeResult, TranscriptionMediaToolReadiness, TranscriptionReadiness } from "./transcription-types.js";
+export interface TranscriptionMediaPreflightInput {
+    request: NormalizedTranscriptionRequest;
+    workspaceRoot: string;
+    tools: TranscriptionMediaToolReadiness;
+    probe?: TranscriptionMediaProbeResult;
+}
+export declare function evaluateTranscriptionMediaProbeReadiness(tools: TranscriptionMediaToolReadiness): TranscriptionReadiness;
+export declare function preflightTranscriptionMedia(input: TranscriptionMediaPreflightInput): TranscriptionMediaPreflightResult;

package/dist/transcription-media-preflight.js

@@ -0,0 +1,147 @@
+import { realpathSync, statSync } from "node:fs";
+import path from "node:path";
+import { hasSupportedTranscriptionExtension, isSafeTranscriptionSourcePath, isSupportedTranscriptionCodec, } from "./transcription-source-policy.js";
+import { transcriptionFailure as failure } from "./transcription-failures.js";
+const TOOL_WARNING = "Media preflight remains non-destructive until ffmpeg and ffprobe are available.";
+const UNREADABLE_SOURCE_MESSAGE = "Media source must exist as a readable workflow-local file.";
+export function evaluateTranscriptionMediaProbeReadiness(tools) {
+    const failures = mediaToolFailures(tools);
+    if (failures.length === 0) {
+        return { status: "ready", failures: [], warnings: [] };
+    }
+    return {
+        status: "degraded",
+        failures,
+        warnings: [TOOL_WARNING],
+    };
+}
+export function preflightTranscriptionMedia(input) {
+    const { request, workspaceRoot } = input;
+    const warnings = [];
+    const sourcePath = request.source.path?.trim() ?? "";
+    const normalizedRoot = path.resolve(workspaceRoot);
+    const realRoot = realpathSync(normalizedRoot);
+    const resolvedPath = path.resolve(normalizedRoot, sourcePath);
+    const failures = validateWorkflowPath(normalizedRoot, sourcePath, resolvedPath);
+    if (sourcePath &&
+        !hasSupportedTranscriptionExtension(request.source.mediaType, sourcePath)) {
+        failures.push(failure("unsupported_media_extension", "Source extension is not supported for the declared media type.", "source.path"));
+    }
+    const fileSizeBytes = statWorkflowFile(realRoot, resolvedPath, failures);
+    failures.push(...mediaToolFailures(input.tools));
+    if (!input.probe &&
+        input.tools.ffmpegAvailable &&
+        input.tools.ffprobeAvailable) {
+        failures.push(failure("media_probe_failed", "Media probe metadata is required before transcription engine invocation.", "probe"));
+    }
+    const sizeBytes = input.probe?.sizeBytes ?? fileSizeBytes;
+    const durationMs = input.probe?.durationMs;
+    failures.push(...validateProbe(request, input.probe));
+    failures.push(...validatePolicyLimits(request, sizeBytes, durationMs));
+    if (failures.length > 0) {
+        return {
+            ok: false,
+            status: hasOnlyToolFailures(failures) ? "degraded" : "blocked",
+            failures,
+            warnings: mediaToolFailures(input.tools).length === 0
+                ? warnings
+                : [...warnings, TOOL_WARNING],
+        };
+    }
+    return {
+        ok: true,
+        status: "ready",
+        preflight: {
+            sourcePath,
+            resolvedPath,
+            sizeBytes: sizeBytes ?? 0,
+            ...(durationMs === undefined ? {} : { durationMs }),
+            ...(input.probe?.formatName === undefined
+                ? {}
+                : { formatName: input.probe.formatName }),
+            codecs: input.probe?.streams.map((stream) => stream.codecName) ?? [],
+        },
+        failures: [],
+        warnings,
+    };
+}
+function validateWorkflowPath(workspaceRoot, sourcePath, resolvedPath) {
+    const root = path.resolve(workspaceRoot);
+    const failures = [];
+    if (!sourcePath || !isSafeTranscriptionSourcePath(sourcePath)) {
+        failures.push(failure("invalid_source_path", "Media preflight requires a safe workspace-relative source path.", "source.path"));
+    }
+    if (sourcePath && !isPathInsideRoot(root, resolvedPath)) {
+        failures.push(failure("invalid_source_path", "Media preflight source path must resolve inside the workspace.", "source.path"));
+    }
+    return failures;
+}
+function isPathInsideRoot(workspaceRoot, resolvedPath) {
+    const relativePath = path.relative(workspaceRoot, resolvedPath);
+    return (relativePath === "" ||
+        (!relativePath.startsWith("..") && !path.isAbsolute(relativePath)));
+}
+function statWorkflowFile(workspaceRoot, resolvedPath, failures) {
+    try {
+        const file = statSync(resolvedPath);
+        if (!file.isFile()) {
+            failures.push(unreadableFailure());
+            return undefined;
+        }
+        const realPath = realpathSync(resolvedPath);
+        if (!isPathInsideRoot(workspaceRoot, realPath)) {
+            failures.push(failure("invalid_source_path", "Media preflight source path must not resolve through a symlink outside the workspace.", "source.path"));
+            return undefined;
+        }
+        return file.size;
+    }
+    catch {
+        failures.push(unreadableFailure());
+        return undefined;
+    }
+}
+function mediaToolFailures(tools) {
+    const failures = [];
+    if (!tools.ffmpegAvailable) {
+        failures.push(failure("missing_media_probe", "ffmpeg is required for deterministic media preflight.", "tools.ffmpeg"));
+    }
+    if (!tools.ffprobeAvailable) {
+        failures.push(failure("missing_media_probe", "ffprobe is required for deterministic media preflight.", "tools.ffprobe"));
+    }
+    return failures;
+}
+function validateProbe(request, probe) {
+    if (!probe) {
+        return [];
+    }
+    const streams = probe.streams.filter((stream) => stream.type === request.source.mediaType);
+    if (streams.length === 0) {
+        return [
+            failure("unsupported_media_type", "Media probe did not find a stream matching the declared media type.", "probe.streams"),
+        ];
+    }
+    return streams
+        .filter((stream) => !isSupportedTranscriptionCodec(request.source.mediaType, stream.codecName))
+        .map((stream) => failure("unsupported_media_codec", `Codec ${stream.codecName} is not supported for ${stream.type} transcription.`, "probe.streams"));
+}
+function validatePolicyLimits(request, sizeBytes, durationMs) {
+    const failures = [];
+    if (request.policy.maxDurationMs !== undefined &&
+        durationMs !== undefined &&
+        durationMs > request.policy.maxDurationMs) {
+        failures.push(failure("duration_limit_exceeded", "Media duration exceeds transcription policy.", "probe.durationMs"));
+    }
+    if (request.policy.maxFileBytes !== undefined &&
+        sizeBytes !== undefined &&
+        sizeBytes > request.policy.maxFileBytes) {
+        failures.push(failure("file_size_limit_exceeded", "Media size exceeds transcription policy.", "probe.sizeBytes"));
+    }
+    return failures;
+}
+function hasOnlyToolFailures(failures) {
+    return failures.every((entry) => entry.code === "missing_media_probe");
+}
+function unreadableFailure() {
+    return failure("source_file_unreadable", UNREADABLE_SOURCE_MESSAGE, "source.path");
+}
+//# sourceMappingURL=transcription-media-preflight.js.map

package/dist/transcription-media-preflight.js.map

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

package/dist/transcription-request.d.ts

@@ -0,0 +1,13 @@
+import type { NormalizedTranscriptionRequest, TranscriptionPolicy, TranscriptionReadiness, TranscriptionRequest, TranscriptionRuntimeEnvironment, TranscriptionValidationResult } from "./transcription-types.js";
+export declare function defaultTranscriptionPolicy(): TranscriptionPolicy;
+export declare function normalizeTranscriptionRequest(request: TranscriptionRequest): NormalizedTranscriptionRequest;
+export declare function validateTranscriptionRequest(request: TranscriptionRequest): TranscriptionValidationResult;
+export declare function evaluateTranscriptionReadiness(request: NormalizedTranscriptionRequest, environment: TranscriptionRuntimeEnvironment): TranscriptionReadiness;
+export declare function summarizeTranscriptionRedactions(text: string, policyId?: string): {
+    text: string;
+    redactions: {
+        policyId: string;
+        count: number;
+        categories: string[];
+    };
+};

package/dist/transcription-request.js

@@ -0,0 +1,150 @@
+import { redactVaultText } from "./context-vault-redaction.js";
+import { transcriptionFailure as failure } from "./transcription-failures.js";
+import { hasSupportedTranscriptionExtension, isSafeTranscriptionSourcePath, } from "./transcription-source-policy.js";
+export function defaultTranscriptionPolicy() {
+    return {
+        policyId: "local-first-transcription-v1",
+        executionMode: "local",
+        externalProviderAllowed: false,
+        allowedExternalProviders: [],
+        requireConsent: false,
+        retentionClass: "task-evidence",
+        redactionPolicyId: "context-vault-redaction-v1",
+    };
+}
+export function normalizeTranscriptionRequest(request) {
+    const policy = { ...defaultTranscriptionPolicy(), ...request.policy };
+    const engine = normalizeEngine(request.engine, policy);
+    return {
+        ...request,
+        engine,
+        policy,
+        requestedAt: request.requestedAt ?? new Date().toISOString(),
+    };
+}
+export function validateTranscriptionRequest(request) {
+    const normalized = normalizeTranscriptionRequest(request);
+    const failures = [];
+    if (!normalized.taskId.trim()) {
+        failures.push(failure("missing_task", "Task id is required.", "taskId"));
+    }
+    if (!normalized.actor.trim()) {
+        failures.push(failure("missing_actor", "Actor is required.", "actor"));
+    }
+    if (!normalized.source) {
+        failures.push(failure("missing_source", "Source is required.", "source"));
+    }
+    else {
+        failures.push(...validateSource(normalized));
+    }
+    failures.push(...validatePolicy(normalized));
+    failures.push(...validateLimits(normalized));
+    if (failures.length > 0) {
+        return { ok: false, failures };
+    }
+    return { ok: true, request: normalized, failures: [] };
+}
+export function evaluateTranscriptionReadiness(request, environment) {
+    const failures = [];
+    const warnings = [];
+    if (request.engine.executionMode === "local" &&
+        !environment.localEngineAvailable) {
+        failures.push(failure("missing_local_engine", "Local transcription engine is unavailable; external fallback is not automatic.", "engine.executionMode"));
+    }
+    if (request.source.mediaType === "video" &&
+        !environment.mediaProbeAvailable) {
+        failures.push(failure("missing_media_probe", "Video transcription needs local media probe tooling for deterministic metadata.", "source.mediaType"));
+    }
+    if (failures.length > 0) {
+        warnings.push("Request kept local and non-destructive until required tooling is available.");
+        return { status: "degraded", failures, warnings };
+    }
+    return { status: "ready", failures: [], warnings };
+}
+export function summarizeTranscriptionRedactions(text, policyId = defaultTranscriptionPolicy().redactionPolicyId) {
+    const redacted = redactVaultText(text);
+    return {
+        text: redacted.text,
+        redactions: {
+            policyId,
+            count: redacted.count,
+            categories: inferRedactionCategories(text),
+        },
+    };
+}
+function normalizeEngine(engine, policy) {
+    const executionMode = engine?.executionMode ?? policy.executionMode;
+    return {
+        executionMode,
+        provider: engine?.provider ?? (executionMode === "local" ? "local" : ""),
+        model: engine?.model ?? (executionMode === "local" ? "local-default" : ""),
+    };
+}
+function validateSource(request) {
+    const failures = [];
+    const { source } = request;
+    const hasPath = Boolean(source.path?.trim());
+    const hasArtifactId = Boolean(source.artifactId?.trim());
+    if (!hasPath && !hasArtifactId) {
+        failures.push(failure("invalid_source_identity", "Source must provide either a workflow file path or a vault artifact id.", "source"));
+    }
+    if (hasPath && hasArtifactId) {
+        failures.push(failure("invalid_source_identity", "Source must not mix workflow file path and vault artifact id.", "source"));
+    }
+    if (hasPath && !isSafeTranscriptionSourcePath(source.path ?? "")) {
+        failures.push(failure("invalid_source_path", "Source path must be workspace-relative and must not traverse directories.", "source.path"));
+    }
+    if (!["audio", "video"].includes(source.mediaType)) {
+        failures.push(failure("unsupported_media_type", "Source media type must be audio or video.", "source.mediaType"));
+    }
+    if (hasPath &&
+        !hasSupportedTranscriptionExtension(source.mediaType, source.path ?? "")) {
+        failures.push(failure("unsupported_media_extension", "Source extension is not supported for the declared media type.", "source.path"));
+    }
+    return failures;
+}
+function validatePolicy(request) {
+    const failures = [];
+    const { engine, policy } = request;
+    if (engine.executionMode === "external" && !policy.externalProviderAllowed) {
+        failures.push(failure("external_provider_denied", "External transcription providers require explicit policy opt-in.", "policy.externalProviderAllowed"));
+    }
+    if (engine.executionMode === "external" &&
+        policy.externalProviderAllowed &&
+        !policy.allowedExternalProviders.includes(engine.provider)) {
+        failures.push(failure("external_provider_not_allowed", "External transcription provider is not in the policy allowlist.", "engine.provider"));
+    }
+    if (policy.requireConsent &&
+        !["provided", "not_required"].includes(request.consentStatus ?? "missing")) {
+        failures.push(failure("missing_consent", "Transcription requires consent before processing.", "consentStatus"));
+    }
+    return failures;
+}
+function validateLimits(request) {
+    const failures = [];
+    if (request.policy.maxDurationMs !== undefined &&
+        request.source.durationMs !== undefined &&
+        request.source.durationMs > request.policy.maxDurationMs) {
+        failures.push(failure("duration_limit_exceeded", "Source duration exceeds transcription policy.", "source.durationMs"));
+    }
+    if (request.policy.maxFileBytes !== undefined &&
+        request.source.sizeBytes !== undefined &&
+        request.source.sizeBytes > request.policy.maxFileBytes) {
+        failures.push(failure("file_size_limit_exceeded", "Source size exceeds transcription policy.", "source.sizeBytes"));
+    }
+    return failures;
+}
+function inferRedactionCategories(text) {
+    const categories = new Set();
+    if (/\b(?:api[_-]?key|token|secret|password|authorization)\b\s*[:=]/i.test(text)) {
+        categories.add("secret");
+    }
+    if (/\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/i.test(text)) {
+        categories.add("email");
+    }
+    if (/\b(?:\+?\d[\d .-]{7,}\d)\b/.test(text)) {
+        categories.add("phone");
+    }
+    return [...categories].sort();
+}
+//# sourceMappingURL=transcription-request.js.map

package/dist/transcription-request.js.map

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

package/dist/transcription-source-policy.d.ts

@@ -0,0 +1,4 @@
+import type { TranscriptionMediaType } from "./transcription-types.js";
+export declare function hasSupportedTranscriptionExtension(mediaType: TranscriptionMediaType, sourcePath: string): boolean;
+export declare function isSafeTranscriptionSourcePath(value: string): boolean;
+export declare function isSupportedTranscriptionCodec(mediaType: TranscriptionMediaType, codecName: string): boolean;

package/dist/transcription-source-policy.js

@@ -0,0 +1,43 @@
+const AUDIO_CODECS = new Set([
+    "aac",
+    "flac",
+    "mp3",
+    "opus",
+    "pcm_s16le",
+    "pcm_s24le",
+    "vorbis",
+]);
+const AUDIO_EXTENSIONS = new Set([
+    ".aac",
+    ".flac",
+    ".m4a",
+    ".mp3",
+    ".ogg",
+    ".wav",
+]);
+const VIDEO_CODECS = new Set(["av1", "h264", "hevc", "vp8", "vp9"]);
+const VIDEO_EXTENSIONS = new Set([".mkv", ".mov", ".mp4", ".webm"]);
+export function hasSupportedTranscriptionExtension(mediaType, sourcePath) {
+    const extension = extensionOf(sourcePath);
+    return mediaType === "audio"
+        ? AUDIO_EXTENSIONS.has(extension)
+        : VIDEO_EXTENSIONS.has(extension);
+}
+export function isSafeTranscriptionSourcePath(value) {
+    return (value.length > 0 &&
+        !value.startsWith("/") &&
+        !value.startsWith("\\") &&
+        !value.includes("\0") &&
+        !value.split(/[\\/]+/).includes(".."));
+}
+export function isSupportedTranscriptionCodec(mediaType, codecName) {
+    const codec = codecName.trim().toLowerCase();
+    return mediaType === "audio"
+        ? AUDIO_CODECS.has(codec)
+        : VIDEO_CODECS.has(codec);
+}
+function extensionOf(value) {
+    const match = /\.[^./\\]+$/.exec(value.toLowerCase());
+    return match?.[0] ?? "";
+}
+//# sourceMappingURL=transcription-source-policy.js.map

package/dist/transcription-source-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcription-source-policy.js","sourceRoot":"","sources":["../src/transcription-source-policy.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,WAAW;IACX,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC,CAAC;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AACpE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEpE,MAAM,UAAU,kCAAkC,CAChD,SAAiC,EACjC,UAAkB;IAElB,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAC1C,OAAO,SAAS,KAAK,OAAO;QAC1B,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC;QACjC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAa;IACzD,OAAO,CACL,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACtB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QACvB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrB,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,SAAiC,EACjC,SAAiB;IAEjB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,OAAO,SAAS,KAAK,OAAO;QAC1B,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACtD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC"}