@open-agent-toolkit/cli 0.1.66 → 0.1.72

package/dist/commands/gate/route.d.ts

@@ -0,0 +1,22 @@
+import type { CommandContext, GlobalOptions } from '../../app/command-context.js';
+import { Command } from 'commander';
+export type GateRoute = 'inline' | 'delegate-sync' | 'refuse';
+export interface GateRouteDecision {
+    route: GateRoute;
+    reason: string;
+}
+interface GateRouteInput {
+    expectRuntime: string;
+    expectModel: string;
+    canAwait: boolean;
+    env: NodeJS.ProcessEnv;
+}
+interface GateRouteCommandDependencies {
+    processEnv: NodeJS.ProcessEnv;
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    cliRoot?: string;
+}
+export declare function resolveGateRoute(input: GateRouteInput): GateRouteDecision;
+export declare function createGateRouteCommand(dependencies: GateRouteCommandDependencies): Command;
+export {};
+//# sourceMappingURL=route.d.ts.map

package/dist/commands/gate/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/commands/gate/route.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,eAAe,GAAG,QAAQ,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,cAAc;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,UAAU,4BAA4B;IACpC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAkCD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CAyDzE;AAoBD,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,4BAA4B,GACzC,OAAO,CAgDT"}

package/dist/commands/gate/route.js

@@ -0,0 +1,109 @@
+import { writeFileSync } from 'node:fs';
+import { readGlobalOptions } from '../shared/shared.utils.js';
+import { Command } from 'commander';
+import { currentGateCliRoot } from './branch-local-cli.js';
+const PROVIDER_MARKERS = [
+    { runtime: 'claude', keys: ['CLAUDECODE'] },
+    { runtime: 'cursor', keys: ['CURSOR_AGENT'] },
+    { runtime: 'codex', keys: ['CODEX_THREAD_ID', 'CODEX_SESSION_ID'] },
+];
+const PROVIDER_MODEL_EVIDENCE_KEYS = {
+    claude: ['ANTHROPIC_MODEL', 'CLAUDE_MODEL'],
+    cursor: ['CURSOR_MODEL'],
+    codex: ['CODEX_MODEL'],
+};
+function nonEmptyEnvValue(env, key) {
+    const value = env[key]?.trim();
+    return value ? value : undefined;
+}
+function fallbackRoute(canAwait, reason) {
+    return canAwait
+        ? { route: 'delegate-sync', reason }
+        : { route: 'refuse', reason };
+}
+export function resolveGateRoute(input) {
+    const expectedRuntime = input.expectRuntime.trim().toLowerCase();
+    const expectedModel = input.expectModel.trim();
+    const activeMarkers = PROVIDER_MARKERS.flatMap(({ keys, runtime }) => {
+        const activeKeys = keys.filter((key) => nonEmptyEnvValue(input.env, key));
+        return activeKeys.length > 0 ? [{ keys: activeKeys, runtime }] : [];
+    });
+    const expectedRuntimeMarker = activeMarkers.find(({ runtime }) => runtime === expectedRuntime);
+    if (!expectedRuntimeMarker && activeMarkers.length !== 1) {
+        return fallbackRoute(input.canAwait, activeMarkers.length === 0
+            ? 'No provider runtime marker is available; inline reviewer identity is ambiguous.'
+            : `Multiple provider runtime markers are present (${activeMarkers.flatMap(({ keys }) => keys).join(', ')}), but none identifies expected runtime ${expectedRuntime}.`);
+    }
+    if (!expectedRuntimeMarker) {
+        const activeRuntime = activeMarkers[0].runtime;
+        return fallbackRoute(input.canAwait, `Provider runtime marker identifies ${activeRuntime}, not expected runtime ${expectedRuntime}.`);
+    }
+    const providerModelEvidenceKeys = expectedRuntime in PROVIDER_MODEL_EVIDENCE_KEYS
+        ? PROVIDER_MODEL_EVIDENCE_KEYS[expectedRuntime]
+        : [];
+    const modelEvidence = providerModelEvidenceKeys.flatMap((key) => {
+        const value = nonEmptyEnvValue(input.env, key);
+        return value ? [{ key, value }] : [];
+    });
+    const enforceExpectedModel = expectedModel !== 'unknown' && expectedModel !== 'provider-default';
+    const contradictoryModel = enforceExpectedModel
+        ? modelEvidence.find(({ value }) => value !== expectedModel)
+        : undefined;
+    if (contradictoryModel) {
+        return fallbackRoute(input.canAwait, `Model evidence ${contradictoryModel.key}=${contradictoryModel.value} contradicts expected model ${expectedModel}.`);
+    }
+    return {
+        route: 'inline',
+        reason: modelEvidence.length > 0
+            ? `Provider runtime marker matches expected runtime ${expectedRuntime}; available model evidence matches ${expectedModel}.`
+            : `Provider runtime marker matches expected runtime ${expectedRuntime}; model evidence is unavailable.`,
+    };
+}
+function parseRequiredOption(value, name) {
+    const parsed = value?.trim();
+    if (!parsed) {
+        throw new Error(`${name} must be a non-empty string.`);
+    }
+    return parsed;
+}
+function parseCanAwait(value) {
+    if (value === 'true') {
+        return true;
+    }
+    if (value === 'false') {
+        return false;
+    }
+    throw new Error('--can-await must be true or false.');
+}
+export function createGateRouteCommand(dependencies) {
+    return new Command('route')
+        .description('Choose a headless-safe reviewer execution route')
+        .requiredOption('--expect-runtime <runtime>', 'Expected reviewer runtime from gate invocation metadata')
+        .requiredOption('--expect-model <model>', 'Expected reviewer model from gate invocation metadata')
+        .requiredOption('--can-await <boolean>', 'Whether the host can synchronously await a delegated reviewer')
+        .option('--json', 'Print the route decision as JSON')
+        .action((options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        const expectedRuntime = parseRequiredOption(options.expectRuntime, '--expect-runtime');
+        const decision = resolveGateRoute({
+            expectRuntime: expectedRuntime,
+            expectModel: parseRequiredOption(options.expectModel, '--expect-model'),
+            canAwait: parseCanAwait(options.canAwait),
+            env: dependencies.processEnv,
+        });
+        if (context.json) {
+            const envelope = {
+                ...decision,
+                cliRoot: dependencies.cliRoot ?? currentGateCliRoot(),
+            };
+            const receiptPath = dependencies.processEnv.OAT_GATE_ROUTE_RECEIPT_PATH;
+            if (receiptPath) {
+                writeFileSync(receiptPath, `${JSON.stringify({ ...envelope, runtime: expectedRuntime })}\n`, { mode: 0o600 });
+            }
+            context.logger.json(envelope);
+        }
+        else {
+            context.logger.info(`${decision.route}: ${decision.reason}`);
+        }
+    });
+}

package/dist/commands/project/dispatch-ceiling/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/dispatch-ceiling/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAa9B,OAAO,EAUL,KAAK,uBAAuB,EAY7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAsBzB,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAiC5C,UAAU,2BAA2B;IACnC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC7E,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAi/ED,wBAAgB,mCAAmC,CACjD,SAAS,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACnD,OAAO,CAkGT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/dispatch-ceiling/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAa9B,OAAO,EAUL,KAAK,uBAAuB,EAY7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAsBzB,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAiC5C,UAAU,2BAA2B;IACnC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC7E,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAqmFD,wBAAgB,mCAAmC,CACjD,SAAS,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACnD,OAAO,CAkGT"}

package/dist/commands/project/dispatch-ceiling/index.js

@@ -1243,9 +1243,58 @@ async function resolveCodexProviderDefaultEffort(repoRoot, context, dependencies
     }
     return 'unknown';
 }
-function blockMessage(provider) {
-    const label = providerLabel(provider);
-    return `BLOCKED: ${label} dispatch policy is unresolved in non-interactive mode.\nSet workflow.dispatchPolicy.mode/workflow.dispatchPolicy.policy, workflow.dispatchCeiling.providers.${provider}, oat_dispatch_policy, or legacy oat_dispatch_ceiling.`;
+function mergeEffectiveDispatchMatrix(resolvedConfig) {
+    const merged = {};
+    const layers = [
+        resolvedConfig.user.workflow?.dispatchCeiling?.providers,
+        resolvedConfig.shared.workflow?.dispatchCeiling?.providers,
+        resolvedConfig.local.workflow?.dispatchCeiling?.providers,
+    ];
+    for (const providers of layers) {
+        for (const [provider, value] of Object.entries(providers ?? {})) {
+            const previous = merged[provider];
+            merged[provider] =
+                typeof value === 'object' &&
+                    value !== null &&
+                    !Array.isArray(value) &&
+                    typeof previous === 'object' &&
+                    previous !== null &&
+                    !Array.isArray(previous)
+                    ? { ...previous, ...value }
+                    : value;
+        }
+    }
+    return merged;
+}
+function inspectLadderCompleteness(matrix) {
+    const missingCells = [];
+    for (const provider of ['codex', 'claude', 'cursor']) {
+        const providerValue = matrix[provider];
+        for (const tier of VALID_DISPATCH_MATRIX_TIERS) {
+            const cell = typeof providerValue === 'object' &&
+                providerValue !== null &&
+                !Array.isArray(providerValue)
+                ? providerValue[tier]
+                : undefined;
+            if (cell === undefined ||
+                !isWorkflowDispatchCandidateLadder(cell) ||
+                cell.candidates.length === 0) {
+                missingCells.push(`${provider}.${tier}`);
+            }
+        }
+    }
+    return { complete: missingCells.length === 0, missingCells };
+}
+function unresolvedMessage(reason, missingCells) {
+    const policyFix = 'set `oat_dispatch_policy` in project state (normally at plan time) or select Inherit Host Defaults';
+    const ladderFix = `adopt a dispatch matrix${missingCells.length > 0 ? `; missing cells: ${missingCells.join(', ')}` : ''}`;
+    if (reason === 'policy') {
+        return `BLOCKED: project dispatch policy is unresolved; ${policyFix}.`;
+    }
+    if (reason === 'ladder') {
+        return `BLOCKED: dispatch ladder is unresolved; ${ladderFix}.`;
+    }
+    return `BLOCKED: project dispatch policy and dispatch ladder are unresolved; ${policyFix}; ${ladderFix}.`;
 }
 function isNonInteractiveEnv(env) {
     return env['OAT_NON_INTERACTIVE'] === '1';
@@ -1260,6 +1309,9 @@ async function resolveDispatchCeiling(context, dependencies, options) {
         dependencies.resolveEffectiveConfig(repoRoot, userConfigDir, dependencies.processEnv),
         resolveProjectPath(repoRoot, dependencies, options),
     ]);
+    const effectiveMatrix = mergeEffectiveDispatchMatrix(resolvedConfig);
+    const ladderCompleteness = inspectLadderCompleteness(effectiveMatrix);
+    const reportedMatrix = Object.keys(effectiveMatrix).length > 0 ? effectiveMatrix : null;
     const providerDefaultEffort = provider === 'codex'
         ? await resolveCodexProviderDefaultEffort(repoRoot, context, dependencies)
         : 'not-applicable';
@@ -1267,6 +1319,8 @@ async function resolveDispatchCeiling(context, dependencies, options) {
     const preferredValue = normalizePreferredValue(provider, options.preferred);
     const ceilingTier = normalizeCeilingTier(options.ceilingTier, role);
     const escalationLevel = normalizeEscalationLevel(options.escalationLevel);
+    const policyResolution = readResolvedConfigCeiling(provider, resolvedConfig) ??
+        (await resolveProjectStateCeiling(provider, projectPath, dependencies));
     const resolvedValue = await resolveCeilingValue(provider, resolvedConfig, projectPath, dependencies, escalationLevel, role, preferredValue, requestedCandidate, ceilingTier);
     for (const warning of resolvedValue?.warnings ?? []) {
         context.logger.warn(warning);
@@ -1299,21 +1353,35 @@ async function resolveDispatchCeiling(context, dependencies, options) {
                     projectPath,
                     providerDefaultEffort,
                     matrix: resolvedValue.matrix,
+                    ladderCompleteness,
                     providers,
                     message: managedCodexDepthBlockMessage(scope, depth),
                 };
             }
         }
+        const activeTier = policyTier(resolvedValue.policy);
+        const activeCell = activeTier
+            ? resolveProviderMatrixCellDefinition(provider, activeTier, resolvedConfig, resolvedValue.matrix)
+            : null;
+        const activeLadderMissing = options.preflight === true &&
+            resolvedValue.mode === 'managed' &&
+            activeTier !== null &&
+            (activeCell === null ||
+                !isWorkflowDispatchCandidateLadder(activeCell.cell) ||
+                activeCell.cell.candidates.length === 0);
         const incompleteManagedPreflight = options.preflight === true &&
             resolvedValue.mode === 'managed' &&
-            providerResolution.mode === 'advisory' &&
-            providerResolution.selection.target?.crossHarness !== true &&
-            providerResolution.selection.selectionMode !== 'no-review-target';
+            (activeLadderMissing ||
+                (providerResolution.mode === 'advisory' &&
+                    providerResolution.selection.target?.crossHarness !== true &&
+                    providerResolution.selection.selectionMode !== 'no-review-target'));
         if (incompleteManagedPreflight) {
             const shouldBlock = options.nonInteractive === true ||
                 isNonInteractiveEnv(dependencies.processEnv) ||
                 (!context.interactive && !context.json);
-            const message = shouldBlock ? blockMessage(provider) : undefined;
+            const message = shouldBlock
+                ? unresolvedMessage('ladder', ladderCompleteness.missingCells)
+                : undefined;
             return {
                 status: shouldBlock ? 'blocked' : 'unresolved',
                 provider,
@@ -1325,7 +1393,11 @@ async function resolveDispatchCeiling(context, dependencies, options) {
                 unresolved: true,
                 projectPath,
                 providerDefaultEffort,
-                matrix: resolvedValue.matrixCompatibility ?? resolvedValue.matrix,
+                matrix: resolvedValue.matrixCompatibility ??
+                    resolvedValue.matrix ??
+                    reportedMatrix,
+                ladderCompleteness,
+                unresolvedReason: 'ladder',
                 providers,
                 message,
             };
@@ -1341,26 +1413,38 @@ async function resolveDispatchCeiling(context, dependencies, options) {
             unresolved: false,
             projectPath,
             providerDefaultEffort,
-            matrix: resolvedValue.matrixCompatibility ?? resolvedValue.matrix,
+            matrix: resolvedValue.matrixCompatibility ??
+                resolvedValue.matrix ??
+                reportedMatrix,
+            ladderCompleteness,
             providers,
         };
     }
     const shouldBlock = options.nonInteractive === true ||
         isNonInteractiveEnv(dependencies.processEnv) ||
         (options.preflight === true && !context.interactive && !context.json);
-    const message = shouldBlock ? blockMessage(provider) : undefined;
+    const unresolvedReason = policyResolution
+        ? 'ladder'
+        : ladderCompleteness.complete
+            ? 'policy'
+            : 'both';
+    const message = shouldBlock
+        ? unresolvedMessage(unresolvedReason, ladderCompleteness.missingCells)
+        : undefined;
     return {
         status: shouldBlock ? 'blocked' : 'unresolved',
         provider,
-        value: null,
-        policyMode: null,
-        policy: null,
-        source: null,
-        preset: null,
+        value: policyResolution?.value ?? null,
+        policyMode: policyResolution?.mode ?? null,
+        policy: policyResolution?.policy ?? null,
+        source: policyResolution?.source ?? null,
+        preset: policyResolution?.preset ?? null,
         unresolved: true,
         projectPath,
         providerDefaultEffort,
-        matrix: null,
+        matrix: reportedMatrix,
+        ladderCompleteness,
+        unresolvedReason,
         providers,
         message,
     };

package/dist/commands/review/latest.d.ts

@@ -13,6 +13,7 @@ export interface LatestReview {
 export interface FindLatestReviewOptions {
     repoRoot: string;
     projectPath?: string | null;
+    actionableProjectOnly?: boolean;
 }
 interface ReviewLatestDependencies {
     buildCommandContext: (options: GlobalOptions) => CommandContext;

package/dist/commands/review/latest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"latest.d.ts","sourceRoot":"","sources":["../../../src/commands/review/latest.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AAQD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,UAAU,wBAAwB;IAChC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACnE;AAsID,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAqF9B;AA+CD,wBAAgB,yBAAyB,CACvC,SAAS,GAAE,OAAO,CAAC,wBAAwB,CAAM,GAChD,OAAO,CAkBT"}
+{"version":3,"file":"latest.d.ts","sourceRoot":"","sources":["../../../src/commands/review/latest.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AASD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,UAAU,wBAAwB;IAChC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACnE;AAgOD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkG9B;AAmDD,wBAAgB,yBAAyB,CACvC,SAAS,GAAE,OAAO,CAAC,wBAAwB,CAAM,GAChD,OAAO,CA2BT"}

package/dist/commands/review/latest.js

@@ -77,9 +77,11 @@ async function readReviewCandidate(repoRoot, relativePath, kind, priority, archi
         return null;
     }
     const scope = getFrontmatterField(frontmatter, 'oat_review_scope') ?? '';
+    const reviewType = getFrontmatterField(frontmatter, 'oat_review_type') ?? 'code';
     return {
         path: relativePath,
         scope,
+        reviewType,
         generatedAt,
         kind,
         archived,
@@ -89,6 +91,62 @@ async function readReviewCandidate(repoRoot, relativePath, kind, priority, archi
         priority,
     };
 }
+function parseReviewLedgerEvents(planContent) {
+    const heading = /^## Reviews[ \t]*\r?$/m.exec(planContent);
+    if (!heading) {
+        return [];
+    }
+    const remaining = planContent.slice(heading.index + heading[0].length);
+    const nextHeadingIndex = remaining.search(/^##(?!#)[ \t]+\S.*\r?$/m);
+    const section = nextHeadingIndex === -1 ? remaining : remaining.slice(0, nextHeadingIndex);
+    return section
+        .split('\n')
+        .filter((line) => line.trim().startsWith('|'))
+        .slice(2)
+        .map((line) => line
+        .split('|')
+        .slice(1, -1)
+        .map((cell) => cell.trim()))
+        .filter((cells) => cells.length === 5)
+        .map(([scope = '', type = '', status = '', , artifact = '']) => ({
+        scope,
+        type,
+        status,
+        artifact,
+    }));
+}
+async function correlateProjectActionability(repoRoot, projectPath, candidates) {
+    let planContent;
+    try {
+        planContent = await readFile(join(repoRoot, projectPath, 'plan.md'), 'utf8');
+    }
+    catch (error) {
+        if (typeof error === 'object' &&
+            error !== null &&
+            'code' in error &&
+            error.code === 'ENOENT') {
+            return candidates;
+        }
+        throw error;
+    }
+    const events = parseReviewLedgerEvents(planContent);
+    if (events.length === 0) {
+        return candidates;
+    }
+    return candidates.map((candidate) => {
+        if (candidate.kind !== 'project' || candidate.archived) {
+            return candidate;
+        }
+        const artifact = normalizeToPosixPath(relative(projectPath, candidate.path));
+        const matchingEvent = events.find((event) => event.scope.toLowerCase() === candidate.scope.toLowerCase() &&
+            event.type.toLowerCase() === candidate.reviewType.toLowerCase() &&
+            normalizeToPosixPath(event.artifact) === artifact);
+        return {
+            ...candidate,
+            actionable: matchingEvent?.status.toLowerCase() === 'received',
+        };
+    });
+}
 function sortReviewCandidates(a, b) {
     if (a.generatedTime !== b.generatedTime) {
         return b.generatedTime - a.generatedTime;
@@ -116,34 +174,45 @@ export async function findLatestReview(options) {
             priority: 0,
             archived: false,
             actionable: true,
+        });
+        if (!options.actionableProjectOnly) {
+            scanTargets.push({
+                dir: `${projectPath}/reviews/archived`,
+                kind: 'project',
+                priority: 1,
+                archived: true,
+                actionable: false,
+            });
+        }
+    }
+    if (!options.actionableProjectOnly) {
+        scanTargets.push({
+            dir: '.oat/repo/reviews',
+            kind: 'adhoc',
+            priority: 2,
+            archived: false,
+            actionable: true,
         }, {
-            dir: `${projectPath}/reviews/archived`,
-            kind: 'project',
-            priority: 1,
-            archived: true,
-            actionable: false,
+            dir: '.oat/projects/local/orphan-reviews',
+            kind: 'adhoc',
+            priority: 3,
+            archived: false,
+            actionable: true,
         });
     }
-    scanTargets.push({
-        dir: '.oat/repo/reviews',
-        kind: 'adhoc',
-        priority: 2,
-        archived: false,
-        actionable: true,
-    }, {
-        dir: '.oat/projects/local/orphan-reviews',
-        kind: 'adhoc',
-        priority: 3,
-        archived: false,
-        actionable: true,
-    });
-    const candidates = (await Promise.all(scanTargets.map(async (target) => {
+    let candidates = (await Promise.all(scanTargets.map(async (target) => {
         const files = await listMarkdownFiles(options.repoRoot, target.dir);
         return Promise.all(files.map((file) => readReviewCandidate(options.repoRoot, file, target.kind, target.priority, target.archived, target.actionable)));
     })))
         .flat()
-        .filter((candidate) => candidate !== null)
-        .sort(sortReviewCandidates);
+        .filter((candidate) => candidate !== null);
+    if (projectPath) {
+        candidates = await correlateProjectActionability(options.repoRoot, projectPath, candidates);
+    }
+    if (options.actionableProjectOnly) {
+        candidates = candidates.filter((candidate) => candidate.actionable);
+    }
+    candidates.sort(sortReviewCandidates);
     const latest = candidates[0];
     if (!latest) {
         return null;
@@ -168,7 +237,11 @@ async function runReviewLatest(context, options, dependencies) {
     try {
         const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
         const projectPath = await resolveProjectPath(repoRoot, options.project, dependencies);
-        const result = await findLatestReview({ repoRoot, projectPath });
+        const result = await findLatestReview({
+            repoRoot,
+            projectPath,
+            actionableProjectOnly: options.actionableProject,
+        });
         if (context.json) {
             context.logger.json(result ?? EMPTY_RESULT);
         }
@@ -196,6 +269,7 @@ export function createReviewLatestCommand(overrides = {}) {
     return new Command('latest')
         .description('Find the most recent OAT review artifact')
         .option('--project <path>', 'Project path to scan in addition to ad-hoc review locations')
+        .option('--actionable-project', 'Scan only active project reviews, excluding archived and ad-hoc history')
         .action(async (options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
         await runReviewLatest(context, options, dependencies);

package/dist/config/oat-config.d.ts

@@ -35,6 +35,9 @@ export type WorkflowDispatchPolicyMode = 'managed' | 'inherit';
 export type WorkflowManagedDispatchPolicy = 'economy' | 'balanced' | 'high' | 'frontier' | 'uncapped';
 export type GateOnFailure = 'block' | 'prompt' | 'warn';
 export type GateAvoid = 'same-family' | 'same-runtime' | 'none';
+export declare const MIN_GATE_TIMEOUT_MS = 1000;
+export declare const MAX_GATE_TIMEOUT_MS = 14400000;
+export declare function isValidGateTimeoutMs(value: unknown): value is number;
 export interface WorkflowDispatchCeiling {
     preset?: WorkflowDispatchCeilingPreset;
     recommendationVersion?: string;
@@ -66,12 +69,17 @@ export interface ExecTarget {
     hostDetectionCommand?: string[];
     availabilityCommand?: string[];
     priority: number;
+    timeoutMs?: number;
 }
 export type ExecTargetConfig = Partial<ExecTarget>;
 export interface WorkflowGatesConfig {
     execTargets?: Record<string, ExecTargetConfig | null>;
     skills?: Record<string, GateConfig | null>;
 }
+export interface WorkflowGateTimeouts {
+    code?: number;
+    artifact?: number;
+}
 export interface OatWorkflowConfig {
     hillCheckpointDefault?: WorkflowHillCheckpointDefault;
     archiveOnComplete?: boolean;
@@ -84,6 +92,7 @@ export interface OatWorkflowConfig {
     designMode?: WorkflowDesignMode;
     dispatchPolicy?: WorkflowDispatchPolicy;
     dispatchCeiling?: WorkflowDispatchCeiling;
+    gateTimeouts?: WorkflowGateTimeouts;
     gates?: WorkflowGatesConfig;
 }
 export declare const VALID_CODEX_DISPATCH_CEILINGS: readonly WorkflowCodexDispatchCeiling[];

package/dist/config/oat-config.d.ts.map

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

package/dist/config/oat-config.js

@@ -6,6 +6,14 @@ import { normalizeToPosixPath, validateRealPathWithinScope } from '../fs/paths.j
 import { normalizeDispatchMatrix, } from './dispatch-matrix.js';
 import { parseJsonConfig } from './json.js';
 export { VALID_DISPATCH_MATRIX_TIERS, isCodexMaterializedRouteTarget, isWorkflowDispatchCandidateLadder, isWorkflowDispatchFallbackRoute, toWorkflowDispatchCandidateLadder, validateDispatchRouteTarget, } from './dispatch-matrix.js';
+export const MIN_GATE_TIMEOUT_MS = 1_000;
+export const MAX_GATE_TIMEOUT_MS = 14_400_000;
+export function isValidGateTimeoutMs(value) {
+    return (typeof value === 'number' &&
+        Number.isInteger(value) &&
+        value >= MIN_GATE_TIMEOUT_MS &&
+        value <= MAX_GATE_TIMEOUT_MS);
+}
 const VALID_HILL_CHECKPOINT_DEFAULTS = ['every', 'final'];
 const VALID_POST_IMPLEMENT_LEGACY_SEQUENCES = ['wait', 'summary', 'pr', 'docs-pr'];
 const VALID_POST_IMPLEMENT_STEPS = [
@@ -206,6 +214,9 @@ function normalizeExecTarget(value) {
             target.priority = value.priority;
         }
     }
+    if (isValidGateTimeoutMs(value.timeoutMs)) {
+        target.timeoutMs = value.timeoutMs;
+    }
     const hostDetectionCommand = normalizeArgv(value.hostDetectionCommand);
     if (hostDetectionCommand !== undefined) {
         target.hostDetectionCommand = hostDetectionCommand;
@@ -323,6 +334,18 @@ function normalizeWorkflowConfig(parsed) {
             next.dispatchCeiling = dispatchCeiling;
         }
     }
+    if (isRecord(parsed.gateTimeouts)) {
+        const gateTimeouts = {};
+        if (isValidGateTimeoutMs(parsed.gateTimeouts.code)) {
+            gateTimeouts.code = parsed.gateTimeouts.code;
+        }
+        if (isValidGateTimeoutMs(parsed.gateTimeouts.artifact)) {
+            gateTimeouts.artifact = parsed.gateTimeouts.artifact;
+        }
+        if (Object.keys(gateTimeouts).length > 0) {
+            next.gateTimeouts = gateTimeouts;
+        }
+    }
     if (isRecord(parsed.gates)) {
         const gates = {};
         const execTargets = normalizeRecordMap(parsed.gates.execTargets, normalizeExecTarget);

package/dist/config/resolve.js

@@ -235,6 +235,7 @@ function mergeExecTargetLayer(targets, layer) {
                 hostDetectionCommand: override.hostDetectionCommand ?? existing.hostDetectionCommand,
                 availabilityCommand: override.availabilityCommand ?? existing.availabilityCommand,
                 priority: override.priority ?? existing.priority,
+                timeoutMs: override.timeoutMs ?? existing.timeoutMs,
             });
             continue;
         }
@@ -268,6 +269,9 @@ function cloneExecTarget(target) {
     if (target.models) {
         next.models = [...target.models];
     }
+    if (target.timeoutMs !== undefined) {
+        next.timeoutMs = target.timeoutMs;
+    }
     return next;
 }
 function toCompleteExecTarget(target) {
@@ -294,6 +298,9 @@ function toCompleteExecTarget(target) {
     if (isValidStringList(target.models)) {
         completeTarget.models = target.models.map((model) => model.trim());
     }
+    if (target.timeoutMs !== undefined) {
+        completeTarget.timeoutMs = target.timeoutMs;
+    }
     return completeTarget;
 }
 function mergeExecTargetInvocation(existing, override) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.1.66",
+  "version": "0.1.72",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -34,7 +34,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.1.66"
+    "@open-agent-toolkit/control-plane": "0.1.72"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",