@open-agent-toolkit/cli 0.1.69 → 0.1.73

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/init/tools/shared/skill-manifest.d.ts

@@ -13,7 +13,7 @@ export declare const PACK_METADATA: Record<string, PackMetadata>;
 export declare function resolvePackDefaultScope(packName: string): 'user' | 'project';
 export declare const WORKFLOW_SKILLS: readonly ["oat-cursor-cloud-projects", "oat-project-autonomous", "oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-dispatch-subagents", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-provide-remote", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-split", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wrap-up"];
 export declare const WORKFLOW_AGENTS: readonly ["oat-codebase-mapper.md", "oat-phase-implementer.md", "oat-reviewer.md"];
-export declare const WORKFLOW_TEMPLATES: readonly ["state.md", "discovery.md", "spec.md", "design.md", "plan.md", "implementation.md", "summary.md"];
+export declare const WORKFLOW_TEMPLATES: readonly ["state.md", "discovery.md", "spec.md", "design.md", "plan.md", "implementation.md", "summary.md", "project-log.md"];
 export declare const WORKFLOW_SCRIPTS: readonly ["generate-oat-state.sh", "generate-thin-index.sh", "resolve-tracking.sh"];
 export declare const IDEA_SKILLS: readonly ["oat-idea-new", "oat-idea-ideate", "oat-idea-summarize", "oat-idea-scratchpad"];
 export declare const CORE_SKILLS: readonly ["oat-docs", "oat-doctor"];

package/dist/commands/init/tools/shared/skill-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAKtD,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAID,eAAO,MAAM,eAAe,s3BAmClB,CAAC;AAEX,eAAO,MAAM,eAAe,oFAIlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6GAQrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,iLAQd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,2NASjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,sHAK5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,yIAQ/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAI7D,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}
+{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAKtD,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAID,eAAO,MAAM,eAAe,s3BAmClB,CAAC;AAEX,eAAO,MAAM,eAAe,oFAIlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,+HASrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,iLAQd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,2NASjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,sHAK5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,yIAQ/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAI7D,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}

package/dist/commands/init/tools/shared/skill-manifest.js

@@ -64,6 +64,7 @@ export const WORKFLOW_TEMPLATES = [
     'plan.md',
     'implementation.md',
     'summary.md',
+    'project-log.md',
 ];
 export const WORKFLOW_SCRIPTS = [
     'generate-oat-state.sh',

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/project/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,oBAAoB,IAAI,OAAO,CAe9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC,wBAAgB,oBAAoB,IAAI,OAAO,CAgB9C"}

package/dist/commands/project/index.js

@@ -4,6 +4,7 @@ import { createProjectCompleteDiscoveryCommand } from './complete-discovery/inde
 import { createProjectCompleteStateCommand } from './complete-state/index.js';
 import { createProjectDispatchCeilingCommand } from './dispatch-ceiling/index.js';
 import { createProjectListCommand } from './list.js';
+import { createProjectLogCommand } from './log/index.js';
 import { createProjectNewCommand } from './new/index.js';
 import { createProjectOpenCommand } from './open/index.js';
 import { createProjectPauseCommand } from './pause/index.js';
@@ -19,6 +20,7 @@ export function createProjectCommand() {
         .addCommand(createProjectCompleteStateCommand())
         .addCommand(createProjectDispatchCeilingCommand())
         .addCommand(createProjectListCommand())
+        .addCommand(createProjectLogCommand())
         .addCommand(createProjectNewCommand())
         .addCommand(createProjectOpenCommand())
         .addCommand(createProjectPauseCommand())

package/dist/commands/project/log/append.d.ts

@@ -0,0 +1,41 @@
+import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
+import { type ActiveProjectResolution } from '../../../config/oat-config.js';
+import { type ResolvedConfig } from '../../../config/resolve.js';
+import { Command } from 'commander';
+export interface AppendProjectLogInput {
+    repoRoot: string;
+    home?: string;
+    project?: string;
+    structural?: boolean;
+    type?: string;
+    scope?: string;
+    area?: string;
+    producer?: string;
+    ref?: string;
+    body?: string;
+    versionNote?: string;
+}
+export type ProjectLogAppendResult = {
+    status: 'appended';
+    logPath: string;
+    heading: string;
+    created: boolean;
+} | {
+    status: 'skipped';
+    reason: 'projectLog=false';
+};
+export interface AppendProjectLogDependencies {
+    resolveActiveProject: (repoRoot: string) => Promise<ActiveProjectResolution>;
+    resolveEffectiveConfig: (repoRoot: string, userConfigDir: string, env?: NodeJS.ProcessEnv) => Promise<ResolvedConfig>;
+    resolveAssetsRoot: () => Promise<string>;
+    now: () => Date;
+}
+export interface ProjectLogAppendCommandDependencies extends AppendProjectLogDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    readStdin: () => Promise<string>;
+}
+export declare function instantiateProjectLogTemplate(template: string, projectName: string, date: string): string;
+export declare function appendProjectLog(input: AppendProjectLogInput, overrides?: Partial<AppendProjectLogDependencies>): Promise<ProjectLogAppendResult>;
+export declare function createProjectLogAppendCommand(overrides?: Partial<ProjectLogAppendCommandDependencies>): Command;
+//# sourceMappingURL=append.d.ts.map

package/dist/commands/project/log/append.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"append.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/log/append.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAI9E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,sBAAsB,GAC9B;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEN,MAAM,WAAW,4BAA4B;IAC3C,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC7E,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,KACpB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAqBD,MAAM,WAAW,mCAAoC,SAAQ,4BAA4B;IACvF,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAClC;AA4LD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,MAAM,CAOR;AAiCD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,SAAS,GAAE,OAAO,CAAC,4BAA4B,CAAM,GACpD,OAAO,CAAC,sBAAsB,CAAC,CAoCjC;AAsCD,wBAAgB,6BAA6B,CAC3C,SAAS,GAAE,OAAO,CAAC,mCAAmC,CAAM,GAC3D,OAAO,CA8CT"}