@zenalexa/unicli 0.222.0 → 0.222.2

package/dist/engine/delivery/planner.js

@@ -0,0 +1,322 @@
+/**
+ * @owner   src/engine/delivery/planner.ts
+ * @does    Evaluates objective attempts against evidence gates and selects the next delivery action.
+ * @needs   src/engine/delivery/types.ts
+ * @feeds   future objective-level delivery command, repair bridge, and run/session adapters.
+ * @breaks  Throws no errors; malformed or exhausted state is surfaced as blocked, exhausted, or inconclusive assessment.
+ * @invariants permission/auth blocks never become repair actions; strategy switching skips exhausted strategies.
+ * @side-effects none
+ * @perf    O(strategies + attempts + gates) per assessment.
+ * @concurrency pure and reentrant.
+ * @test    tests/unit/engine-delivery.test.ts
+ * @stability experimental
+ * @since   2026-05-24
+ */
+const DEFAULT_EVIDENCE_GATES = [
+    { kind: "run_completed" },
+];
+const ADAPTER_DRIFT_CODES = new Set([
+    "selector_miss",
+    "stale_ref",
+    "ref_not_found",
+    "ambiguous",
+]);
+const AUTH_CODES = new Set(["auth_required", "not_authenticated"]);
+const OUTPUT_CONTRACT_CODES = new Set([
+    "invalid_input",
+    "schema_mismatch",
+    "shape_mismatch",
+]);
+const TRANSIENT_CODES = new Set([
+    "network_error",
+    "rate_limited",
+    "upstream_error",
+    "api_error",
+]);
+export function assessDeliveryState(input) {
+    const strategies = enabledStrategies(input.strategies);
+    const currentAttempt = latestAttempt(input.attempts);
+    if (!currentAttempt) {
+        const firstStrategy = strategies[0];
+        return {
+            objective_id: input.objective.id,
+            status: firstStrategy ? "ready" : "blocked",
+            next_action: firstStrategy ? "run_strategy" : "inspect_failure",
+            gates: [],
+            ...(firstStrategy ? { next_strategy_id: firstStrategy.id } : {}),
+        };
+    }
+    const gates = evaluateDeliveryGates(input.objective, currentAttempt);
+    if (gates.length > 0 && gates.every((gate) => gate.passed)) {
+        return {
+            objective_id: input.objective.id,
+            status: "delivered",
+            next_action: "stop",
+            gates,
+            current_attempt_id: currentAttempt.id,
+            current_strategy_id: currentAttempt.strategy_id,
+        };
+    }
+    const currentStrategy = strategies.find((strategy) => strategy.id === currentAttempt.strategy_id);
+    const diagnosis = diagnoseDeliveryAttempt(currentAttempt, gates);
+    return planRecovery({
+        objective: input.objective,
+        attempts: input.attempts,
+        strategies,
+        currentAttempt,
+        currentStrategy,
+        gates,
+        diagnosis,
+    });
+}
+export function evaluateDeliveryGates(objective, attempt) {
+    return evidenceGates(objective).map((gate) => evaluateDeliveryGate(gate, attempt));
+}
+function planRecovery(input) {
+    const nextStrategy = nextAvailableStrategy(input.objective, input.attempts, input.strategies, input.currentAttempt.strategy_id);
+    const isGlobalExhausted = hasGlobalAttemptBudgetExhausted(input.objective, input.attempts);
+    const isCurrentStrategyExhausted = hasStrategyAttemptBudgetExhausted(input.objective, input.attempts, input.currentAttempt.strategy_id);
+    const base = {
+        objective_id: input.objective.id,
+        gates: input.gates,
+        current_attempt_id: input.currentAttempt.id,
+        current_strategy_id: input.currentAttempt.strategy_id,
+        diagnosis: input.diagnosis,
+    };
+    if (input.diagnosis.code === "permission_denied") {
+        return { ...base, status: "blocked", next_action: "request_permission" };
+    }
+    if (input.diagnosis.code === "auth_required") {
+        return { ...base, status: "blocked", next_action: "request_auth" };
+    }
+    if (isGlobalExhausted) {
+        return exhaustedAssessment(base, input.currentAttempt, input.currentStrategy);
+    }
+    if (isCurrentStrategyExhausted && nextStrategy) {
+        return {
+            ...base,
+            status: "needs_retry",
+            next_action: "switch_strategy",
+            next_strategy_id: nextStrategy.id,
+            hypothesis: createHypothesis({
+                action: "switch_strategy",
+                diagnosis: input.diagnosis,
+                attempt: input.currentAttempt,
+                strategy: nextStrategy,
+            }),
+        };
+    }
+    if (input.diagnosis.repairable) {
+        return {
+            ...base,
+            status: "needs_repair",
+            next_action: "repair_adapter",
+            hypothesis: createHypothesis({
+                action: "repair_adapter",
+                diagnosis: input.diagnosis,
+                attempt: input.currentAttempt,
+                strategy: input.currentStrategy,
+            }),
+        };
+    }
+    if (input.diagnosis.retryable && !isCurrentStrategyExhausted) {
+        return {
+            ...base,
+            status: "needs_retry",
+            next_action: "retry_strategy",
+            next_strategy_id: input.currentAttempt.strategy_id,
+            hypothesis: createHypothesis({
+                action: "retry_strategy",
+                diagnosis: input.diagnosis,
+                attempt: input.currentAttempt,
+                strategy: input.currentStrategy,
+            }),
+        };
+    }
+    if (nextStrategy) {
+        return {
+            ...base,
+            status: "needs_retry",
+            next_action: "switch_strategy",
+            next_strategy_id: nextStrategy.id,
+        };
+    }
+    return exhaustedAssessment(base, input.currentAttempt, input.currentStrategy);
+}
+function exhaustedAssessment(base, attempt, strategy) {
+    const diagnosis = base.diagnosis?.code === "strategy_exhausted"
+        ? base.diagnosis
+        : {
+            code: "strategy_exhausted",
+            reason: "No remaining enabled strategy can satisfy the objective.",
+            repairable: false,
+            retryable: false,
+        };
+    return {
+        ...base,
+        status: "exhausted",
+        next_action: "inspect_failure",
+        diagnosis,
+        hypothesis: createHypothesis({
+            action: "inspect_failure",
+            diagnosis,
+            attempt,
+            strategy,
+        }),
+    };
+}
+export function diagnoseDeliveryAttempt(attempt, gates) {
+    const error = attempt.error;
+    const errorCode = error?.code;
+    const permissionDenied = attempt.summary.runtime_permission_denied;
+    if (permissionDenied || errorCode === "permission_denied") {
+        return {
+            code: "permission_denied",
+            reason: "Runtime policy denied access to a required resource.",
+            repairable: false,
+            retryable: false,
+            ...(error?.adapter_path ? { adapter_path: error.adapter_path } : {}),
+            ...(typeof error?.step === "number" ? { step: error.step } : {}),
+            ...(error?.suggestion ? { suggestion: error.suggestion } : {}),
+        };
+    }
+    if (errorCode && AUTH_CODES.has(errorCode)) {
+        return {
+            code: "auth_required",
+            reason: "The operation needs authenticated state before it can proceed.",
+            repairable: false,
+            retryable: false,
+            ...(error?.adapter_path ? { adapter_path: error.adapter_path } : {}),
+            ...(typeof error?.step === "number" ? { step: error.step } : {}),
+            ...(error?.suggestion ? { suggestion: error.suggestion } : {}),
+        };
+    }
+    if (errorCode && ADAPTER_DRIFT_CODES.has(errorCode)) {
+        return {
+            code: "adapter_drift",
+            reason: "The adapter path no longer matches the live software surface.",
+            repairable: Boolean(error.adapter_path),
+            retryable: error.retryable !== false,
+            ...(error.adapter_path ? { adapter_path: error.adapter_path } : {}),
+            ...(typeof error.step === "number" ? { step: error.step } : {}),
+            ...(error.suggestion ? { suggestion: error.suggestion } : {}),
+        };
+    }
+    if (errorCode && OUTPUT_CONTRACT_CODES.has(errorCode)) {
+        return {
+            code: "output_contract_mismatch",
+            reason: "The latest result did not match the expected output contract.",
+            repairable: Boolean(error.adapter_path),
+            retryable: error.retryable !== false,
+            ...(error.adapter_path ? { adapter_path: error.adapter_path } : {}),
+            ...(typeof error.step === "number" ? { step: error.step } : {}),
+            ...(error.suggestion ? { suggestion: error.suggestion } : {}),
+        };
+    }
+    if (errorCode && TRANSIENT_CODES.has(errorCode)) {
+        return {
+            code: "transient_upstream",
+            reason: "The run failed on a transient upstream or transport condition.",
+            repairable: false,
+            retryable: error.retryable !== false,
+            ...(error.adapter_path ? { adapter_path: error.adapter_path } : {}),
+            ...(typeof error.step === "number" ? { step: error.step } : {}),
+            ...(error.suggestion ? { suggestion: error.suggestion } : {}),
+        };
+    }
+    if (gates.some((gate) => !gate.passed)) {
+        return {
+            code: "evidence_gate_failed",
+            reason: "The run completed without enough evidence to prove delivery.",
+            repairable: false,
+            retryable: true,
+        };
+    }
+    return {
+        code: "unknown_failure",
+        reason: "The attempt did not satisfy the objective and has no known diagnosis.",
+        repairable: false,
+        retryable: error?.retryable === true,
+        ...(error?.adapter_path ? { adapter_path: error.adapter_path } : {}),
+        ...(typeof error?.step === "number" ? { step: error.step } : {}),
+        ...(error?.suggestion ? { suggestion: error.suggestion } : {}),
+    };
+}
+function evaluateDeliveryGate(gate, attempt) {
+    switch (gate.kind) {
+        case "run_completed":
+            return {
+                name: "run_completed",
+                kind: gate.kind,
+                passed: attempt.summary.status === "completed",
+                expected: "completed",
+                actual: attempt.summary.status,
+            };
+        case "min_evidence_count":
+            return {
+                name: "min_evidence_count",
+                kind: gate.kind,
+                passed: attempt.summary.evidence_count >= gate.min,
+                expected: gate.min,
+                actual: attempt.summary.evidence_count,
+            };
+        case "required_evidence_type": {
+            const actual = attempt.summary.evidence_by_type[gate.evidence_type] ?? 0;
+            const expected = gate.min ?? 1;
+            return {
+                name: `evidence_type:${gate.evidence_type}`,
+                kind: gate.kind,
+                passed: actual >= expected,
+                expected,
+                actual,
+            };
+        }
+    }
+}
+function createHypothesis(input) {
+    const target = input.diagnosis.adapter_path ?? input.strategy?.adapter_path;
+    return {
+        id: `${input.attempt.id}:${input.diagnosis.code}:${input.action}`,
+        diagnosis_code: input.diagnosis.code,
+        action: input.action,
+        reason: input.diagnosis.suggestion ?? input.diagnosis.reason,
+        ...(input.strategy ? { strategy_id: input.strategy.id } : {}),
+        ...(target ? { target } : {}),
+        ...(input.strategy?.verify_command
+            ? { verify_command: input.strategy.verify_command }
+            : {}),
+    };
+}
+function evidenceGates(objective) {
+    return objective.evidence_gates && objective.evidence_gates.length > 0
+        ? objective.evidence_gates
+        : DEFAULT_EVIDENCE_GATES;
+}
+function latestAttempt(attempts) {
+    const sorted = [...attempts].sort((left, right) => left.ordinal - right.ordinal);
+    return sorted[sorted.length - 1];
+}
+function enabledStrategies(strategies) {
+    return [...strategies]
+        .filter((strategy) => strategy.enabled !== false)
+        .sort((left, right) => {
+        const priority = left.priority - right.priority;
+        return priority === 0 ? left.id.localeCompare(right.id) : priority;
+    });
+}
+function nextAvailableStrategy(objective, attempts, strategies, currentStrategyId) {
+    return strategies.find((strategy) => strategy.id !== currentStrategyId &&
+        !hasStrategyAttemptBudgetExhausted(objective, attempts, strategy.id));
+}
+function hasGlobalAttemptBudgetExhausted(objective, attempts) {
+    const maxAttempts = objective.attempt_budget?.max_attempts;
+    return typeof maxAttempts === "number" && attempts.length >= maxAttempts;
+}
+function hasStrategyAttemptBudgetExhausted(objective, attempts, strategyId) {
+    const maxAttempts = objective.attempt_budget?.max_attempts_per_strategy;
+    if (typeof maxAttempts !== "number")
+        return false;
+    return (attempts.filter((attempt) => attempt.strategy_id === strategyId).length >=
+        maxAttempts);
+}
+//# sourceMappingURL=planner.js.map

package/dist/engine/delivery/planner.js.map

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

package/dist/engine/delivery/repair.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @owner   src/engine/delivery/repair.ts
+ * @does    Compiles delivery repair assessments into bounded adapter repair candidates.
+ * @needs   src/engine/delivery/types.ts, src/engine/user-home.ts, node:path, node:url
+ * @feeds   future repair command bridge and delivery operator surfaces.
+ * @breaks  Over-broad candidate creation can turn auth, policy, or transient failures into unsafe code edits.
+ * @invariants candidates require repair_adapter action, repairable diagnosis, owned adapter path, attempt id, strategy id, and verify command.
+ * @side-effects none
+ * @perf    O(1) over a completed delivery trajectory.
+ * @concurrency pure and reentrant.
+ * @test    tests/unit/engine-delivery-repair.test.ts
+ * @stability experimental
+ * @since   2026-05-24
+ */
+import type { DeliveryRepairCandidate, DeliveryTrajectory } from "./types.js";
+export declare function deliveryRepairCandidateFromTrajectory(trajectory: DeliveryTrajectory): DeliveryRepairCandidate | undefined;
+//# sourceMappingURL=repair.d.ts.map

package/dist/engine/delivery/repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../../src/engine/delivery/repair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgB9E,wBAAgB,qCAAqC,CACnD,UAAU,EAAE,kBAAkB,GAC7B,uBAAuB,GAAG,SAAS,CA2CrC"}

package/dist/engine/delivery/repair.js

@@ -0,0 +1,86 @@
+/**
+ * @owner   src/engine/delivery/repair.ts
+ * @does    Compiles delivery repair assessments into bounded adapter repair candidates.
+ * @needs   src/engine/delivery/types.ts, src/engine/user-home.ts, node:path, node:url
+ * @feeds   future repair command bridge and delivery operator surfaces.
+ * @breaks  Over-broad candidate creation can turn auth, policy, or transient failures into unsafe code edits.
+ * @invariants candidates require repair_adapter action, repairable diagnosis, owned adapter path, attempt id, strategy id, and verify command.
+ * @side-effects none
+ * @perf    O(1) over a completed delivery trajectory.
+ * @concurrency pure and reentrant.
+ * @test    tests/unit/engine-delivery-repair.test.ts
+ * @stability experimental
+ * @since   2026-05-24
+ */
+import { dirname, isAbsolute, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { userHome } from "../user-home.js";
+const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
+const PACKAGE_ADAPTERS_ROOT = resolve(MODULE_DIR, "..", "..", "..", "src", "adapters");
+export function deliveryRepairCandidateFromTrajectory(trajectory) {
+    const assessment = trajectory.assessment;
+    const diagnosis = assessment.diagnosis;
+    const nextExperiment = trajectory.next_experiment;
+    if (assessment.status !== "needs_repair" ||
+        assessment.next_action !== "repair_adapter" ||
+        nextExperiment?.action !== "repair_adapter" ||
+        diagnosis?.repairable !== true) {
+        return undefined;
+    }
+    const adapterPath = diagnosis.adapter_path ?? nextExperiment.target;
+    const verifyCommand = nextExperiment.verify_command ?? assessment.hypothesis?.verify_command;
+    const attemptId = assessment.current_attempt_id;
+    const strategyId = assessment.current_strategy_id;
+    if (!attemptId ||
+        !strategyId ||
+        !verifyCommand ||
+        !adapterPath ||
+        !isAdapterFilePath(adapterPath)) {
+        return undefined;
+    }
+    const reason = assessment.hypothesis?.reason ?? diagnosis.suggestion ?? diagnosis.reason;
+    return {
+        schema_version: "1",
+        objective_id: trajectory.objective_id,
+        attempt_id: attemptId,
+        strategy_id: strategyId,
+        adapter_path: adapterPath,
+        verify_command: verifyCommand,
+        diagnosis_code: diagnosis.code,
+        reason,
+        ...(nextExperiment.command ? { command: nextExperiment.command } : {}),
+        ...(typeof diagnosis.step === "number" ? { step: diagnosis.step } : {}),
+        ...(diagnosis.suggestion ? { suggestion: diagnosis.suggestion } : {}),
+    };
+}
+function isAdapterFilePath(path) {
+    const expandedPath = expandHome(path.trim());
+    const normalizedPath = expandedPath.replaceAll("\\", "/");
+    const hasAdapterExtension = normalizedPath.endsWith(".yaml") || normalizedPath.endsWith(".ts");
+    if (!hasAdapterExtension ||
+        normalizedPath.endsWith(".test.ts") ||
+        hasParentSegment(normalizedPath)) {
+        return false;
+    }
+    if (isRelativePackageAdapterPath(normalizedPath))
+        return true;
+    const absolutePath = resolve(expandedPath);
+    const userAdaptersRoot = resolve(userHome(), ".unicli", "adapters");
+    return (isPathInsideRoot(absolutePath, PACKAGE_ADAPTERS_ROOT) ||
+        isPathInsideRoot(absolutePath, userAdaptersRoot));
+}
+function expandHome(path) {
+    return path.startsWith("~/") ? resolve(userHome(), path.slice(2)) : path;
+}
+function hasParentSegment(path) {
+    return path.split("/").includes("..");
+}
+function isRelativePackageAdapterPath(path) {
+    const relativePath = path.startsWith("./") ? path.slice(2) : path;
+    return !isAbsolute(relativePath) && relativePath.startsWith("src/adapters/");
+}
+function isPathInsideRoot(path, root) {
+    const relation = relative(root, path);
+    return (relation.length > 0 && !relation.startsWith("..") && !isAbsolute(relation));
+}
+//# sourceMappingURL=repair.js.map

package/dist/engine/delivery/repair.js.map

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

package/dist/engine/delivery/session.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @owner   src/engine/delivery/session.ts
+ * @does    Adapts recorded session run events into delivery attempts.
+ * @needs   src/engine/session/query.ts, src/engine/session/types.ts, src/engine/delivery/types.ts
+ * @feeds   src/engine/delivery/trajectory.ts and future run-record driven delivery commands.
+ * @breaks  Missing structured error extraction hides repairable adapter failures from the delivery trajectory.
+ * @invariants latest structured AgentError wins; malformed error payloads are ignored, not fabricated.
+ * @side-effects none
+ * @perf    O(events) scan; allocates one summary and optional error object.
+ * @concurrency pure and reentrant.
+ * @test    tests/unit/engine-delivery-session.test.ts
+ * @stability experimental
+ * @since   2026-05-24
+ */
+import type { DeliveryAttempt, DeliveryAttemptFromRunEventsInput } from "./types.js";
+export declare function deliveryAttemptFromRunEvents(input: DeliveryAttemptFromRunEventsInput): DeliveryAttempt;
+//# sourceMappingURL=session.d.ts.map

package/dist/engine/delivery/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/engine/delivery/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,iCAAiC,EAClC,MAAM,YAAY,CAAC;AAEpB,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iCAAiC,GACvC,eAAe,CAgBjB"}

package/dist/engine/delivery/session.js

@@ -0,0 +1,78 @@
+/**
+ * @owner   src/engine/delivery/session.ts
+ * @does    Adapts recorded session run events into delivery attempts.
+ * @needs   src/engine/session/query.ts, src/engine/session/types.ts, src/engine/delivery/types.ts
+ * @feeds   src/engine/delivery/trajectory.ts and future run-record driven delivery commands.
+ * @breaks  Missing structured error extraction hides repairable adapter failures from the delivery trajectory.
+ * @invariants latest structured AgentError wins; malformed error payloads are ignored, not fabricated.
+ * @side-effects none
+ * @perf    O(events) scan; allocates one summary and optional error object.
+ * @concurrency pure and reentrant.
+ * @test    tests/unit/engine-delivery-session.test.ts
+ * @stability experimental
+ * @since   2026-05-24
+ */
+import { summarizeRunEvents } from "../session/query.js";
+export function deliveryAttemptFromRunEvents(input) {
+    const runId = input.run_id ??
+        input.events[0]?.metadata.run_id ??
+        input.events[0]?.run_id ??
+        input.id;
+    const summary = summarizeRunEvents(input.events, { runId });
+    const error = extractLatestAgentError(input.events);
+    return {
+        id: input.id,
+        ordinal: input.ordinal,
+        strategy_id: input.strategy_id,
+        run_id: summary.run_id,
+        summary,
+        ...(error ? { error } : {}),
+    };
+}
+function extractLatestAgentError(events) {
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = events[index];
+        const error = agentErrorFromValue(event.data?.error) ??
+            agentErrorFromValue(agentEnvelopeError(event.data?.envelope));
+        if (error)
+            return error;
+    }
+    return undefined;
+}
+function agentEnvelopeError(envelope) {
+    if (!isRecord(envelope))
+        return undefined;
+    return envelope.error;
+}
+function agentErrorFromValue(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (typeof value.code !== "string" || typeof value.message !== "string") {
+        return undefined;
+    }
+    return {
+        code: value.code,
+        message: value.message,
+        ...(typeof value.adapter_path === "string"
+            ? { adapter_path: value.adapter_path }
+            : {}),
+        ...(typeof value.step === "number" && Number.isFinite(value.step)
+            ? { step: value.step }
+            : {}),
+        ...(typeof value.suggestion === "string"
+            ? { suggestion: value.suggestion }
+            : {}),
+        ...(typeof value.retryable === "boolean"
+            ? { retryable: value.retryable }
+            : {}),
+        ...(Array.isArray(value.alternatives)
+            ? {
+                alternatives: value.alternatives.filter((entry) => typeof entry === "string"),
+            }
+            : {}),
+    };
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=session.js.map

package/dist/engine/delivery/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/engine/delivery/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAOzD,MAAM,UAAU,4BAA4B,CAC1C,KAAwC;IAExC,MAAM,KAAK,GACT,KAAK,CAAC,MAAM;QACZ,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM;QAChC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM;QACvB,KAAK,CAAC,EAAE,CAAC;IACX,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO;QACP,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAkB;IACjD,KAAK,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,KAAK,GACT,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;YACtC,mBAAmB,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAiB;IAC3C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC;AACxB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;YACxC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE;YACtC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YAC/D,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;YACtB,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;YACtC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;YAClC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS;YACtC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE;YAChC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;YACnC,CAAC,CAAC;gBACE,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM,CACrC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CACtD;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/engine/delivery/trajectory.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @owner   src/engine/delivery/trajectory.ts
+ * @does    Converts delivery state into a reviewable experiment trajectory with observations, hypotheses, and the next executable experiment.
+ * @needs   src/engine/delivery/planner.ts, src/engine/delivery/types.ts
+ * @feeds   future delivery ledgers, repair bridge, and operator CLI summaries.
+ * @breaks  Trajectory output becomes misleading if assessment statuses stop mapping to verification and failure classifications.
+ * @invariants non-active assessments never produce next executable experiments.
+ * @side-effects none
+ * @perf    O(attempts log attempts + strategies + gates) per trajectory.
+ * @concurrency pure and reentrant.
+ * @test    tests/unit/engine-delivery-trajectory.test.ts
+ * @stability experimental
+ * @since   2026-05-24
+ */
+import type { DeliveryTrajectory, DeliveryTrajectoryInput } from "./types.js";
+export declare function buildDeliveryTrajectory(input: DeliveryTrajectoryInput): DeliveryTrajectory;
+//# sourceMappingURL=trajectory.d.ts.map

package/dist/engine/delivery/trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../../src/engine/delivery/trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EAOV,kBAAkB,EAClB,uBAAuB,EAGxB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,uBAAuB,GAC7B,kBAAkB,CAgCpB"}