@open-agent-toolkit/cli 0.2.25 → 0.2.27

package/dist/commands/project/archive/explainer-source-backlinks.d.ts

@@ -0,0 +1,18 @@
+declare const SOURCE_BACKLINK_CONTRACT_VERSION = "explainer-kit.source-backlinks/v1";
+export interface CanonicalSourceBacklink {
+    repository: string;
+    revision: string;
+    path: string;
+    lineRange: {
+        start: number;
+        end: number;
+    };
+    url: string;
+}
+export interface ExplainerSourceBacklinks {
+    SOURCE_BACKLINK_CONTRACT_VERSION: typeof SOURCE_BACKLINK_CONTRACT_VERSION;
+    parseCanonicalGithubBlobUrl: (value: string) => CanonicalSourceBacklink;
+}
+export declare function loadExplainerSourceBacklinks(): Promise<ExplainerSourceBacklinks>;
+export {};
+//# sourceMappingURL=explainer-source-backlinks.d.ts.map

package/dist/commands/project/archive/explainer-source-backlinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainer-source-backlinks.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/explainer-source-backlinks.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,gCAAgC,sCAAsC,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,wBAAwB;IACvC,gCAAgC,EAAE,OAAO,gCAAgC,CAAC;IAC1E,2BAA2B,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,uBAAuB,CAAC;CACzE;AAID,wBAAgB,4BAA4B,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAGhF"}

package/dist/commands/project/archive/explainer-source-backlinks.js

@@ -0,0 +1,27 @@
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { CliError } from '../../../errors/cli-error.js';
+import { resolveAssetsRoot } from '../../../fs/assets.js';
+const SOURCE_BACKLINK_CONTRACT_VERSION = 'explainer-kit.source-backlinks/v1';
+let cachedBacklinks;
+export function loadExplainerSourceBacklinks() {
+    cachedBacklinks ??= loadGeneratedBacklinks();
+    return cachedBacklinks;
+}
+async function loadGeneratedBacklinks() {
+    const assetsRoot = await resolveAssetsRoot();
+    const modulePath = join(assetsRoot, 'skills', 'explainer-kit', 'scripts', 'lib', 'source-backlinks.mjs');
+    let loaded;
+    try {
+        loaded = (await import(pathToFileURL(modulePath).href));
+    }
+    catch (error) {
+        throw new CliError(`Bundled explainer source backlink contract could not be loaded: ${error instanceof Error ? error.message : String(error)}`, 2);
+    }
+    if (loaded.SOURCE_BACKLINK_CONTRACT_VERSION !==
+        SOURCE_BACKLINK_CONTRACT_VERSION ||
+        typeof loaded.parseCanonicalGithubBlobUrl !== 'function') {
+        throw new CliError(`Bundled assets must provide ${SOURCE_BACKLINK_CONTRACT_VERSION}.`, 2);
+    }
+    return loaded;
+}

package/dist/commands/project/archive/push-runner.d.ts

@@ -1,6 +1,6 @@
 import { buildCommandContext, type CommandContext } from '../../../app/command-context.js';
 import { type OatConfig, type OatLocalConfig } from '../../../config/oat-config.js';
-import { resolveArchiveProjectTarget, resolvePrimaryRepoRoot, type ArchiveProjectOnCompletionOptions, type ArchiveProjectOnCompletionResult } from './archive-utils.js';
+import { resolveArchiveProjectTarget, resolvePrimaryRepoRoot, verifySelectedProjectRecapForArchive, type ArchiveProjectOnCompletionOptions, type ArchiveProjectOnCompletionResult } from './archive-utils.js';
 export interface ArchivePushOptions {
     dryRun?: boolean;
     projectRecapRun?: string;
@@ -13,6 +13,7 @@ export interface ProjectArchivePushCommandDependencies {
     resolveProjectsRoot: (repoRoot: string, env: NodeJS.ProcessEnv) => Promise<string>;
     resolvePrimaryRepoRoot: typeof resolvePrimaryRepoRoot;
     resolveArchiveProjectTarget: typeof resolveArchiveProjectTarget;
+    verifySelectedProjectRecapForArchive: typeof verifySelectedProjectRecapForArchive;
     archiveProjectOnCompletion: (options: ArchiveProjectOnCompletionOptions) => Promise<ArchiveProjectOnCompletionResult>;
     processEnv: NodeJS.ProcessEnv;
     timestamp: () => string;

package/dist/commands/project/archive/push-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"push-runner.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/push-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAKL,2BAA2B,EAC3B,sBAAsB,EAEtB,KAAK,iCAAiC,EACtC,KAAK,gCAAgC,EAEtC,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qCAAqC;IACpD,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,2BAA2B,EAAE,OAAO,2BAA2B,CAAC;IAChE,0BAA0B,EAAE,CAC1B,OAAO,EAAE,iCAAiC,KACvC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,SAAS,EAAE,MAAM,MAAM,CAAC;CACzB;AAmBD,wBAAgB,4CAA4C,IAAI,qCAAqC,CAapG;AAkJD,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,qCAAqC,EACnD,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAoEf"}
+{"version":3,"file":"push-runner.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/push-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAKL,2BAA2B,EAC3B,sBAAsB,EACtB,oCAAoC,EAEpC,KAAK,iCAAiC,EACtC,KAAK,gCAAgC,EAEtC,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qCAAqC;IACpD,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,2BAA2B,EAAE,OAAO,2BAA2B,CAAC;IAChE,oCAAoC,EAAE,OAAO,oCAAoC,CAAC;IAClF,0BAA0B,EAAE,CAC1B,OAAO,EAAE,iCAAiC,KACvC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,SAAS,EAAE,MAAM,MAAM,CAAC;CACzB;AAmBD,wBAAgB,4CAA4C,IAAI,qCAAqC,CAcpG;AAkJD,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,qCAAqC,EACnD,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA0Ef"}

package/dist/commands/project/archive/push-runner.js

@@ -4,7 +4,7 @@ import { resolveProjectsRoot } from '../../shared/oat-paths.js';
 import { readOatConfig, readOatLocalConfig, } from '../../../config/oat-config.js';
 import { CliError } from '../../../errors/cli-error.js';
 import { resolveProjectRoot } from '../../../fs/paths.js';
-import { archiveProjectOnCompletion, assertDurableArchiveProjectTarget, buildArchiveSnapshotName, buildProjectArchiveS3Uri, resolveArchiveProjectTarget, resolvePrimaryRepoRoot, } from './archive-utils.js';
+import { archiveProjectOnCompletion, assertDurableArchiveProjectTarget, buildArchiveSnapshotName, buildProjectArchiveS3Uri, resolveArchiveProjectTarget, resolvePrimaryRepoRoot, verifySelectedProjectRecapForArchive, } from './archive-utils.js';
 export function defaultProjectArchivePushCommandDependencies() {
     return {
         buildCommandContext,
@@ -14,6 +14,7 @@ export function defaultProjectArchivePushCommandDependencies() {
         resolveProjectsRoot,
         resolvePrimaryRepoRoot,
         resolveArchiveProjectTarget,
+        verifySelectedProjectRecapForArchive,
         archiveProjectOnCompletion,
         processEnv: process.env,
         timestamp: () => new Date().toISOString(),
@@ -121,6 +122,9 @@ export async function runArchivePushCommand(dependencies, projectPathArg, option
             timestamp: dependencies.timestamp,
         });
         assertDurableArchiveProjectTarget(archiveTarget);
+        if (options.projectRecapRun?.trim()) {
+            await dependencies.verifySelectedProjectRecapForArchive(target.projectPath, options.projectRecapRun.trim());
+        }
         const dryRun = options.dryRun === true || context.dryRun;
         if (dryRun) {
             const report = await buildDryRunReport(dependencies, repoRoot, config, target, archiveTarget);

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;AAmnFD,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;AAkB9B,OAAO,EAUL,KAAK,uBAAuB,EAY7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAyBzB,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;AAkwFD,wBAAgB,mCAAmC,CACjD,SAAS,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACnD,OAAO,CA0GT"}

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

@@ -5,6 +5,7 @@ import { getFrontmatterBlock } from '../../shared/frontmatter.js';
 import { readGlobalOptions } from '../../shared/shared.utils.js';
 import { compileDispatchPolicyPreset, } from '../../../config/dispatch-ceiling-preset.js';
 import { normalizeDispatchMatrix } from '../../../config/dispatch-matrix.js';
+import { effectiveTerminalReviewerTarget, formatDispatchNotices, terminalReviewerNoticeForTarget, } from '../../../config/dispatch-notices.js';
 import { getDispatchPolicyChoices, managedDispatchPolicyValueList, renderDispatchPolicyChoicesMarkdown, } from '../../../config/dispatch-policy-options.js';
 import { resolveActiveProject, VALID_CLAUDE_DISPATCH_CEILINGS, VALID_CODEX_DISPATCH_CEILINGS, VALID_DISPATCH_MATRIX_TIERS, VALID_MANAGED_DISPATCH_POLICIES, isWorkflowDispatchCandidateLadder, isWorkflowDispatchFallbackRoute, toWorkflowDispatchCandidateLadder, validateDispatchRouteTarget, } from '../../../config/oat-config.js';
 import { resolveEffectiveConfig, } from '../../../config/resolve.js';
@@ -21,6 +22,13 @@ const CODEX_VALUES = [
 const CLAUDE_VALUES = [
     ...VALID_CLAUDE_DISPATCH_CEILINGS,
 ];
+const TASK_CLASSES = [
+    'mechanical-recon',
+    'intelligent-recon',
+    'default-implementation',
+    'hard-reasoning',
+    'consequential',
+];
 const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
     resolveProjectRoot,
@@ -925,6 +933,43 @@ function normalizeRequestedCandidate(provider, role, options) {
     }
     return { model };
 }
+function normalizeClassification(provider, role, options) {
+    const hasTaskClass = options.taskClass !== undefined;
+    const hasTaskEffort = options.taskEffort !== undefined;
+    if (!hasTaskClass && !hasTaskEffort) {
+        return {
+            taskClass: null,
+            preferredEffort: null,
+            source: 'not-reported',
+        };
+    }
+    if (role === 'reviewer') {
+        throw new Error('Classification flags are not supported for reviewer routes.');
+    }
+    if (options.reportScope === undefined ||
+        (options.reportAction !== 'implementation' &&
+            options.reportAction !== 'fix')) {
+        throw new Error('Classification flags require --report-scope and an implementation or fix --report-action.');
+    }
+    const taskClassValue = options.taskClass?.trim() ?? '';
+    if (hasTaskClass &&
+        !TASK_CLASSES.includes(taskClassValue)) {
+        throw new Error(`Invalid task class "${taskClassValue}". Valid values: ${TASK_CLASSES.join(', ')}.`);
+    }
+    const taskEffort = options.taskEffort?.trim() ?? '';
+    if (hasTaskEffort && provider !== 'codex') {
+        throw new Error(`--task-effort is only valid for Codex; received ${provider}.`);
+    }
+    if (hasTaskEffort &&
+        !CODEX_VALUES.includes(taskEffort)) {
+        throw new Error(`Invalid Codex task effort "${taskEffort}". Valid values: ${CODEX_VALUES.join(', ')}.`);
+    }
+    return {
+        taskClass: hasTaskClass ? taskClassValue : null,
+        preferredEffort: hasTaskEffort ? taskEffort : null,
+        source: 'caller',
+    };
+}
 function normalizeEscalationLevel(value) {
     if (value === undefined) {
         return 0;
@@ -1337,6 +1382,10 @@ async function resolveDispatchCeiling(context, dependencies, options) {
     const providers = {
         [provider]: providerResolution,
     };
+    const terminalReviewerNotice = role === 'reviewer' || options.preflight === true
+        ? terminalReviewerNoticeForTarget(effectiveTerminalReviewerTarget(provider, providerResolution.target, providerResolution.selection.selectedValue))
+        : null;
+    const notices = terminalReviewerNotice ? [terminalReviewerNotice] : [];
     if (resolvedValue) {
         const requiresManagedCodexDepth = options.preflight === true &&
             provider === 'codex' &&
@@ -1358,6 +1407,7 @@ async function resolveDispatchCeiling(context, dependencies, options) {
                     source: resolvedValue.source,
                     preset: resolvedValue.preset,
                     unresolved: true,
+                    ...(notices.length > 0 ? { notices } : {}),
                     projectPath,
                     providerDefaultEffort,
                     matrix: resolvedValue.matrix,
@@ -1399,6 +1449,7 @@ async function resolveDispatchCeiling(context, dependencies, options) {
                 source: resolvedValue.source,
                 preset: resolvedValue.preset,
                 unresolved: true,
+                ...(notices.length > 0 ? { notices } : {}),
                 projectPath,
                 providerDefaultEffort,
                 matrix: resolvedValue.matrixCompatibility ??
@@ -1419,6 +1470,7 @@ async function resolveDispatchCeiling(context, dependencies, options) {
             source: resolvedValue.source,
             preset: resolvedValue.preset,
             unresolved: false,
+            ...(notices.length > 0 ? { notices } : {}),
             projectPath,
             providerDefaultEffort,
             matrix: resolvedValue.matrixCompatibility ??
@@ -1448,6 +1500,7 @@ async function resolveDispatchCeiling(context, dependencies, options) {
         source: policyResolution?.source ?? null,
         preset: policyResolution?.preset ?? null,
         unresolved: true,
+        ...(notices.length > 0 ? { notices } : {}),
         projectPath,
         providerDefaultEffort,
         matrix: reportedMatrix,
@@ -1657,6 +1710,9 @@ function writeHumanResolution(context, resolution) {
             context.logger.info(`Selected dispatch value: ${providerResolution.selection.selectedValue}`);
         }
     }
+    if (resolution.notices && resolution.notices.length > 0) {
+        context.logger.info(formatDispatchNotices(resolution.notices));
+    }
 }
 function reportRole(action) {
     if (action === 'review') {
@@ -1686,6 +1742,9 @@ function reportControl(axis, dispatchArgs, reason) {
     return { value: null, mechanism: 'base-role', reason };
 }
 function buildResolutionReport(resolution, options) {
+    const requestedClassification = options.taskClass !== undefined || options.taskEffort !== undefined
+        ? normalizeClassification(resolution.provider, normalizeRole(options.role), options)
+        : null;
     const hasScope = options.reportScope !== undefined;
     const hasAction = options.reportAction !== undefined;
     if (!hasScope && !hasAction) {
@@ -1708,11 +1767,40 @@ function buildResolutionReport(resolution, options) {
     if (providerResolution.selection.role !== expectedResolverRole) {
         throw new Error(`Invalid dispatch report action/role context: ${action}/${role} requires resolver role ${expectedResolverRole}, received ${providerResolution.selection.role}.`);
     }
+    const classification = requestedClassification ??
+        normalizeClassification(resolution.provider, providerResolution.selection.role, options);
+    const namedManagedImplementation = resolution.status === 'resolved' &&
+        resolution.policyMode === 'managed' &&
+        VALID_DISPATCH_MATRIX_TIERS.includes(resolution.policy ?? '') &&
+        action !== 'review' &&
+        options.preflight !== true;
+    const notices = [...(resolution.notices ?? [])];
+    if (namedManagedImplementation &&
+        providerResolution.selection.requestedCandidate === null &&
+        providerResolution.selection.preferredValue === null &&
+        providerResolution.selection.selectedValue !== null) {
+        notices.push({
+            code: 'managed-capped-selection-skipped',
+            level: 'warning',
+            message: 'Managed capped implementation/fix dispatch resolved without an exact candidate; pass the provider candidate flags to preserve explicit selection provenance.',
+        });
+    }
+    if (namedManagedImplementation &&
+        providerResolution.selection.requestedCandidate !== null &&
+        classification.taskClass === null) {
+        notices.push({
+            code: 'managed-capped-classification-missing',
+            level: 'warning',
+            message: 'Managed capped implementation/fix dispatch selected an exact candidate without a task class; pass --task-class to preserve classification provenance.',
+        });
+    }
     return buildDispatchReport({
         scope,
         action,
         role,
         resolution,
+        classification,
+        notices,
         requestedControls: {
             model: reportControl(providerResolution.modelAxis, providerResolution.dispatchArgs, 'Derived from the completed resolver model-axis result.'),
             effort: reportControl(providerResolution.effortAxis, providerResolution.dispatchArgs, 'Derived from the completed resolver effort-axis result.'),
@@ -1800,6 +1888,8 @@ export function createProjectDispatchCeilingCommand(overrides = {}) {
         .addOption(new Option('--ceiling-tier <tier>', 'Invocation-only named maximum tier; never persists configuration or project state').choices([...VALID_DISPATCH_MATRIX_TIERS]))
         .option('--candidate-model <model>', 'Exact configured implementer candidate model beneath the named ceiling')
         .option('--candidate-effort <effort>', 'Exact configured Codex candidate effort paired with --candidate-model')
+        .option('--task-class <class>', `Provider-neutral task classification provenance: ${TASK_CLASSES.join(', ')}`)
+        .option('--task-effort <effort>', 'Codex-only task effort classification provenance; does not select a candidate')
         .option('--escalation-level <level>', 'Ordered route entry to select; 0 is the floor and higher values advance through escalation targets')
         .option('--project-path <path>', 'Read project-state policy from an explicit project path')
         .option('--preflight', 'Treat unresolved non-interactive resolution as an implementation block')

package/dist/config/dispatch-notices.d.ts

@@ -0,0 +1,8 @@
+import type { DispatchNotice } from '../providers/identity/dispatch-report.js';
+type TerminalReviewerNoticeSource = 'bundled-recommendation' | 'effective-configuration' | 'runtime';
+export declare function effectiveTerminalReviewerTarget(provider: string, target: unknown, selectedValue: unknown): string | null;
+export declare function terminalReviewerNoticeForTarget(target: string | null | undefined, source?: TerminalReviewerNoticeSource): DispatchNotice | null;
+export declare function terminalReviewerNoticesForMatrix(providers: Record<string, unknown> | null | undefined, source?: Exclude<TerminalReviewerNoticeSource, 'runtime'>): DispatchNotice[];
+export declare function formatDispatchNotices(notices: DispatchNotice[]): string;
+export {};
+//# sourceMappingURL=dispatch-notices.d.ts.map

package/dist/config/dispatch-notices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-notices.d.ts","sourceRoot":"","sources":["../../src/config/dispatch-notices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,KAAK,4BAA4B,GAC7B,wBAAwB,GACxB,yBAAyB,GACzB,SAAS,CAAC;AAmDd,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,OAAO,GACrB,MAAM,GAAG,IAAI,CAYf;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,MAAM,GAAE,4BAAwC,GAC/C,cAAc,GAAG,IAAI,CAgBvB;AAED,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACrD,MAAM,GAAE,OAAO,CACb,4BAA4B,EAC5B,SAAS,CACkB,GAC5B,cAAc,EAAE,CAYlB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAIvE"}

package/dist/config/dispatch-notices.js

@@ -0,0 +1,79 @@
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function candidateTarget(candidate) {
+    if (typeof candidate === 'string') {
+        return candidate;
+    }
+    if (!isRecord(candidate)) {
+        return null;
+    }
+    if (Array.isArray(candidate.route)) {
+        return candidateTarget(candidate.route.at(-1));
+    }
+    return typeof candidate.model === 'string' ? candidate.model : null;
+}
+function terminalTarget(providerValue) {
+    if (typeof providerValue === 'string' || Array.isArray(providerValue)) {
+        return candidateTarget(Array.isArray(providerValue) ? providerValue.at(-1) : providerValue);
+    }
+    if (!isRecord(providerValue)) {
+        return null;
+    }
+    const frontier = providerValue.frontier;
+    if (typeof frontier === 'string' || Array.isArray(frontier)) {
+        return candidateTarget(Array.isArray(frontier) ? frontier.at(-1) : frontier);
+    }
+    if (!isRecord(frontier)) {
+        return null;
+    }
+    const candidates = frontier.candidates;
+    if (Array.isArray(candidates)) {
+        return candidateTarget(candidates.at(-1));
+    }
+    return candidateTarget(frontier);
+}
+function isFableTarget(target) {
+    return /(^|[-_.])fable($|[-_.])/i.test(target);
+}
+export function effectiveTerminalReviewerTarget(provider, target, selectedValue) {
+    const routedTarget = candidateTarget(target);
+    if (routedTarget) {
+        return routedTarget;
+    }
+    if ((provider === 'claude' || provider === 'cursor') &&
+        typeof selectedValue === 'string') {
+        return selectedValue;
+    }
+    return null;
+}
+export function terminalReviewerNoticeForTarget(target, source = 'runtime') {
+    if (!target || !isFableTarget(target)) {
+        return null;
+    }
+    const context = source === 'bundled-recommendation'
+        ? 'bundled recommendation'
+        : source === 'effective-configuration'
+            ? 'effective post-adoption configuration'
+            : 'effective runtime resolution';
+    return {
+        code: 'terminal-reviewer-eligibility',
+        level: 'advisory',
+        message: `Terminal reviewer target ${target} in the ${context} may require model access; the organization is responsible for confirming that its applicable retention policy permits use. OAT does not determine model access or organizational retention eligibility.`,
+    };
+}
+export function terminalReviewerNoticesForMatrix(providers, source = 'effective-configuration') {
+    const notices = [];
+    for (const providerValue of Object.values(providers ?? {})) {
+        const notice = terminalReviewerNoticeForTarget(terminalTarget(providerValue), source);
+        if (notice) {
+            notices.push(notice);
+        }
+    }
+    return notices;
+}
+export function formatDispatchNotices(notices) {
+    return notices
+        .map((notice) => `[${notice.level}] ${notice.code}: ${notice.message}`)
+        .join('\n');
+}

package/dist/config/dispatch-policy-options.d.ts

@@ -1,3 +1,4 @@
+import type { DispatchNotice } from '../providers/identity/dispatch-report.js';
 import { type WorkflowManagedDispatchPolicy } from './oat-config.js';
 export type DispatchPolicyChoiceKind = 'managed-capped' | 'managed-uncapped' | 'inherit' | 'unresolved';
 export interface DispatchPolicyChoice {
@@ -6,6 +7,7 @@ export interface DispatchPolicyChoice {
     kind: DispatchPolicyChoiceKind;
     runtimePolicy: boolean;
     description: string;
+    notices: DispatchNotice[];
     policy?: WorkflowManagedDispatchPolicy;
     providers?: {
         codex: string;

package/dist/config/dispatch-policy-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch-policy-options.d.ts","sourceRoot":"","sources":["../../src/config/dispatch-policy-options.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,kBAAkB,GAClB,SAAS,GACT,YAAY,CAAC;AAEjB,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,wBAAwB,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,6BAA6B,CAAC;IACvC,SAAS,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAqDD,wBAAgB,wBAAwB,IAAI,oBAAoB,EAAE,CAoBjE;AAED,wBAAgB,8BAA8B,CAAC,SAAS,SAAQ,GAAG,MAAM,CAExE;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAOtD;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CASxD;AAYD,wBAAgB,mCAAmC,CACjD,OAAO,yBAA6B,GACnC,MAAM,CASR"}
+{"version":3,"file":"dispatch-policy-options.d.ts","sourceRoot":"","sources":["../../src/config/dispatch-policy-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAU1E,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,kBAAkB,GAClB,SAAS,GACT,YAAY,CAAC;AAEjB,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,wBAAwB,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,6BAA6B,CAAC;IACvC,SAAS,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AA4DD,wBAAgB,wBAAwB,IAAI,oBAAoB,EAAE,CAsBjE;AAED,wBAAgB,8BAA8B,CAAC,SAAS,SAAQ,GAAG,MAAM,CAExE;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAOtD;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CASxD;AAYD,wBAAgB,mCAAmC,CACjD,OAAO,yBAA6B,GACnC,MAAM,CAaR"}

package/dist/config/dispatch-policy-options.js

@@ -1,4 +1,5 @@
 import { dispatchPolicyProviderTargets, } from './dispatch-ceiling-preset.js';
+import { formatDispatchNotices, terminalReviewerNoticeForTarget, } from './dispatch-notices.js';
 import { VALID_MANAGED_DISPATCH_POLICIES, } from './oat-config.js';
 const MANAGED_POLICY_DESCRIPTIONS = {
     economy: 'Managed capped policy for lower-cost implementation and review dispatch.',
@@ -19,14 +20,17 @@ function isCappedManagedPolicy(policy) {
 }
 function managedChoice(policy) {
     if (isCappedManagedPolicy(policy)) {
+        const providers = dispatchPolicyProviderTargets(policy);
+        const terminalNotice = terminalReviewerNoticeForTarget(providers.claude, 'bundled-recommendation');
         return {
             value: policy,
             label: MANAGED_POLICY_LABELS[policy],
             kind: 'managed-capped',
             runtimePolicy: true,
             description: MANAGED_POLICY_DESCRIPTIONS[policy],
+            notices: terminalNotice ? [terminalNotice] : [],
             policy,
-            providers: dispatchPolicyProviderTargets(policy),
+            providers,
         };
     }
     return {
@@ -35,6 +39,7 @@ function managedChoice(policy) {
         kind: 'managed-uncapped',
         runtimePolicy: true,
         description: MANAGED_POLICY_DESCRIPTIONS[policy],
+        notices: [],
         policy,
     };
 }
@@ -47,6 +52,7 @@ export function getDispatchPolicyChoices() {
             kind: 'inherit',
             runtimePolicy: true,
             description: 'OAT does not choose model or effort. Subagents use the current host/provider default behavior, such as parent session model, base Codex role defaults, or provider config.',
+            notices: [],
         },
         {
             value: 'leave-unresolved',
@@ -54,6 +60,7 @@ export function getDispatchPolicyChoices() {
             kind: 'unresolved',
             runtimePolicy: false,
             description: 'Planning records no policy as a planning/preflight deferral. Implementation preflight must block until a policy is configured or explicitly selected.',
+            notices: [],
         },
     ];
 }
@@ -91,6 +98,11 @@ export function renderDispatchPolicyChoicesMarkdown(choices = getDispatchPolicyC
     return [
         'Set the dispatch policy - how OAT should choose subagent model/effort controls.',
         '',
-        ...choices.map((choice, index) => `${index + 1}. ${choice.label} - ${providerSummary(choice)}. ${choice.description}`),
+        ...choices.map((choice, index) => [
+            `${index + 1}. ${choice.label} - ${providerSummary(choice)}. ${choice.description}`,
+            ...(choice.notices.length > 0
+                ? [formatDispatchNotices(choice.notices)]
+                : []),
+        ].join('\n')),
     ].join('\n');
 }

package/dist/providers/identity/dispatch-report.d.ts

@@ -3,6 +3,17 @@ import type { IdentityProvenance } from './provenance.js';
 import type { DispatchAction, DispatchRole, DispatchStampRecord } from './stamp.js';
 export type DispatchReportPolicyStatus = 'resolved' | 'unresolved' | 'blocked';
 export type DispatchReportPolicyMode = 'managed' | 'inherit' | null;
+export type DispatchTaskClass = 'mechanical-recon' | 'intelligent-recon' | 'default-implementation' | 'hard-reasoning' | 'consequential';
+export interface DispatchReportClassification {
+    taskClass: DispatchTaskClass | null;
+    preferredEffort: string | null;
+    source: 'caller' | 'not-reported';
+}
+export interface DispatchNotice {
+    code: 'managed-capped-selection-skipped' | 'managed-capped-classification-missing' | 'terminal-reviewer-eligibility';
+    level: 'warning' | 'advisory';
+    message: string;
+}
 export interface ResolvedDispatchTargetReport {
     harness: string;
     model?: string;
@@ -47,6 +58,7 @@ export interface DispatchReportSelectionInput {
         model: string;
         effort?: string;
     } | null;
+    preferredValue?: string | null;
     candidateTier: WorkflowDispatchMatrixTier | null;
     candidateIndex: number | null;
     ceilingTier: WorkflowDispatchMatrixTier | null;
@@ -92,6 +104,7 @@ export interface DispatchReportV1 {
             model: string;
             effort?: string;
         } | null;
+        preferredValue: string | null;
         candidateTier: WorkflowDispatchMatrixTier | null;
         candidateIndex: number | null;
         ceilingTier: WorkflowDispatchMatrixTier | null;
@@ -102,6 +115,8 @@ export interface DispatchReportV1 {
         selectionBranch: string;
         cellSource: string | null;
     };
+    classification: DispatchReportClassification;
+    notices: DispatchNotice[];
     requestedControls: DispatchRequestedControls;
     configuredDefaults: DispatchConfiguredDefaults;
     gateInvocation: Readonly<DispatchGateInvocation> | null;
@@ -114,6 +129,8 @@ export interface DispatchReportInput {
     resolution: DispatchReportResolution;
     requestedControls: DispatchRequestedControls;
     configuredDefaults: DispatchConfiguredDefaults;
+    classification?: DispatchReportClassification;
+    notices?: DispatchNotice[];
     gateInvocation?: DispatchGateInvocation | null;
     runtimeIdentity?: DispatchRuntimeIdentity;
 }

package/dist/providers/identity/dispatch-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch-report.d.ts","sourceRoot":"","sources":["../../../src/providers/identity/dispatch-report.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dispatch-report.d.ts","sourceRoot":"","sources":["../../../src/providers/identity/dispatch-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,0BAA0B,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;AAC/E,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;AACpE,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAClB,mBAAmB,GACnB,wBAAwB,GACxB,gBAAgB,GAChB,eAAe,CAAC;AAEpB,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,QAAQ,GAAG,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,kCAAkC,GAClC,uCAAuC,GACvC,+BAA+B,CAAC;IACpC,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EACL,qBAAqB,GACrB,mBAAmB,GACnB,WAAW,GACX,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,YAAY,CAAC;IACnB,kBAAkB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9D,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACjD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAC/C,aAAa,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACnD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAAC;IAC5C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,gCAAgC;IAC/C,YAAY,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,SAAS,EAAE,4BAA4B,CAAC;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,0BAA0B,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,wBAAwB,CAAC;IACrC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,cAAc,CAAC;QACvB,IAAI,EAAE,YAAY,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE,0BAA0B,CAAC;QACnC,IAAI,EAAE,wBAAwB,CAAC;QAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,SAAS,EAAE;QACT,kBAAkB,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QAC9D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,aAAa,EAAE,0BAA0B,GAAG,IAAI,CAAC;QACjD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,WAAW,EAAE,0BAA0B,GAAG,IAAI,CAAC;QAC/C,aAAa,EAAE,4BAA4B,GAAG,IAAI,CAAC;QACnD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,mBAAmB,EAAE,4BAA4B,GAAG,IAAI,CAAC;QACzD,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;IACF,cAAc,EAAE,4BAA4B,CAAC;IAC7C,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,kBAAkB,EAAE,0BAA0B,CAAC;IAC/C,cAAc,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC;IACxD,eAAe,EAAE,uBAAuB,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,wBAAwB,CAAC;IACrC,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,kBAAkB,EAAE,0BAA0B,CAAC;IAC/C,cAAc,CAAC,EAAE,4BAA4B,CAAC;IAC9C,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC/C,eAAe,CAAC,EAAE,uBAAuB,CAAC;CAC3C;AAqND,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,GACzB,gBAAgB,CA0DlB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAExE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAmErE;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,GACvB,mBAAmB,CAcrB"}

package/dist/providers/identity/dispatch-report.js

@@ -10,6 +10,11 @@ const NOT_REPORTED_RUNTIME_IDENTITY = {
     provenance: 'unknown',
     confidence: 'not-reported',
 };
+const NOT_REPORTED_CLASSIFICATION = {
+    taskClass: null,
+    preferredEffort: null,
+    source: 'not-reported',
+};
 function cloneTarget(target) {
     return target ? { ...target } : null;
 }
@@ -58,6 +63,7 @@ function orderedReport(report) {
                         : { effort: report.selection.requestedCandidate.effort }),
                 }
                 : null,
+            preferredValue: report.selection.preferredValue,
             candidateTier: report.selection.candidateTier,
             candidateIndex: report.selection.candidateIndex,
             ceilingTier: report.selection.ceilingTier,
@@ -68,6 +74,16 @@ function orderedReport(report) {
             selectionBranch: report.selection.selectionBranch,
             cellSource: report.selection.cellSource,
         },
+        classification: {
+            taskClass: report.classification.taskClass,
+            preferredEffort: report.classification.preferredEffort,
+            source: report.classification.source,
+        },
+        notices: report.notices.map((notice) => ({
+            code: notice.code,
+            level: notice.level,
+            message: notice.message,
+        })),
         requestedControls: {
             model: {
                 value: report.requestedControls.model.value,
@@ -190,6 +206,7 @@ export function buildDispatchReport(input) {
             requestedCandidate: selection.requestedCandidate
                 ? { ...selection.requestedCandidate }
                 : null,
+            preferredValue: selection.preferredValue ?? null,
             candidateTier: selection.candidateTier,
             candidateIndex: selection.candidateIndex,
             ceilingTier: selection.ceilingTier,
@@ -200,6 +217,10 @@ export function buildDispatchReport(input) {
             selectionBranch: selection.selectionBranch,
             cellSource: selection.cellSource,
         },
+        classification: input.classification
+            ? { ...input.classification }
+            : { ...NOT_REPORTED_CLASSIFICATION },
+        notices: (input.notices ?? []).map((notice) => ({ ...notice })),
         requestedControls: {
             model: { ...input.requestedControls.model },
             effort: { ...input.requestedControls.effort },
@@ -242,6 +263,7 @@ export function formatDispatchReport(report) {
         `  Source: ${display(report.policy.source)}`,
         'Selection',
         `  Requested candidate: ${formatCandidate(report.selection.requestedCandidate)}`,
+        `  Legacy preferred value: ${display(report.selection.preferredValue)}`,
         `  Candidate tier / index: ${display(report.selection.candidateTier)} / ${display(report.selection.candidateIndex)}`,
         `  Ceiling tier: ${display(report.selection.ceilingTier)}`,
         `  Ceiling target: ${formatTarget(report.selection.ceilingTarget)}`,
@@ -249,6 +271,14 @@ export function formatDispatchReport(report) {
         `  Exact selected target: ${formatTarget(report.selection.exactSelectedTarget)}`,
         `  Mode / branch: ${report.selection.selectionMode} / ${report.selection.selectionBranch}`,
         `  Cell source: ${display(report.selection.cellSource)}`,
+        'Classification',
+        `  Task class: ${display(report.classification.taskClass)}`,
+        `  Preferred effort: ${display(report.classification.preferredEffort)}`,
+        `  Source: ${report.classification.source}`,
+        'Notices',
+        ...(report.notices.length === 0
+            ? ['  None']
+            : report.notices.map((notice) => `  [${notice.level}] ${notice.code}: ${notice.message}`)),
         'Requested controls',
         formatControl('Model', report.requestedControls.model),
         formatControl('Effort', report.requestedControls.effort),

package/dist/release/public-package-contract.d.ts

@@ -4,14 +4,20 @@ export interface PublicPackageContract {
     role: 'cli' | 'docs-library' | 'support-library';
     requiredMetadataFields: string[];
     requiredPaths: string[];
+    requiredPackedTextFiles: PackedTextFileRequirement[];
     forbiddenPathPatterns: string[];
     versionPolicyAdditionalRoots: string[];
     versionPolicyIgnorePatterns: string[];
 }
+export interface PackedTextFileRequirement {
+    path: string;
+    requiredContents: string[];
+}
 export declare function getPublicPackageContracts(): PublicPackageContract[];
 export declare function findMissingMetadataFields(packageJson: Record<string, unknown>, contract: PublicPackageContract): string[];
 export declare function findMissingPackedPaths(packedPaths: readonly string[], contract: PublicPackageContract): string[];
 export declare function findForbiddenPackedPaths(packedPaths: readonly string[], contract: PublicPackageContract): string[];
+export declare function findMissingPackedTextContents(packedTextFiles: Readonly<Record<string, string>>, contract: PublicPackageContract): string[];
 export declare function findWorkspaceProtocolDependencySpecs(packageJson: Record<string, unknown>): string[];
 export declare function findNonPublicWorkspaceDependencySpecs(packageJson: Record<string, unknown>, publicPackageNames: readonly string[], workspacePackageNames: readonly string[]): string[];
 //# sourceMappingURL=public-package-contract.d.ts.map

package/dist/release/public-package-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-package-contract.d.ts","sourceRoot":"","sources":["../../src/release/public-package-contract.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,cAAc,GAAG,iBAAiB,CAAC;IACjD,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,4BAA4B,EAAE,MAAM,EAAE,CAAC;IACvC,2BAA2B,EAAE,MAAM,EAAE,CAAC;CACvC;AAmHD,wBAAgB,yBAAyB,IAAI,qBAAqB,EAAE,CASnE;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAIV;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAIV;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAMV;AAED,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,EAAE,CAmBV;AAED,wBAAgB,qCAAqC,CACnD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,qBAAqB,EAAE,SAAS,MAAM,EAAE,GACvC,MAAM,EAAE,CA0BV"}
+{"version":3,"file":"public-package-contract.d.ts","sourceRoot":"","sources":["../../src/release/public-package-contract.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,cAAc,GAAG,iBAAiB,CAAC;IACjD,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,uBAAuB,EAAE,yBAAyB,EAAE,CAAC;IACrD,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,4BAA4B,EAAE,MAAM,EAAE,CAAC;IACvC,2BAA2B,EAAE,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AA2KD,wBAAgB,yBAAyB,IAAI,qBAAqB,EAAE,CAenE;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAIV;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAIV;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAMV;AAED,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACjD,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAoBV;AAED,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,EAAE,CAmBV;AAED,wBAAgB,qCAAqC,CACnD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,qBAAqB,EAAE,SAAS,MAAM,EAAE,GACvC,MAAM,EAAE,CA0BV"}