@open-agent-toolkit/cli 0.2.25 → 0.2.27

package/assets/skills/oat-explainer-kit/scripts/run.mjs

@@ -12,7 +12,7 @@ import {
 } from './resolve-config.mjs';
 import { resolveExplainerOutputRoot } from './resolve-paths.mjs';
 
-const MINIMUM_CORE_VERSION = '2.0.0';
+export const MINIMUM_CORE_VERSION = '2.0.3';
 const ADAPTER_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 
 export async function runOatExplainer({
@@ -32,10 +32,18 @@ export async function runOatExplainer({
   defaultMode,
   renderStrategy,
   retainRawArtDirection = false,
+  planSet,
+  planSetModulePath,
   author,
   authorModulePath,
   critic,
   criticModulePath,
+  browserSession,
+  browserSessionModulePath,
+  browserProbe,
+  browserProbeModulePath,
+  visualCritic,
+  visualCriticModulePath,
   coreOptions = {},
 }) {
   const compatibility = await checkCoreCompatibility({
@@ -54,6 +62,14 @@ export async function runOatExplainer({
     error.compatibility = compatibility;
     throw error;
   }
+  if (!supportsAdaptiveSetPlanning(compatibility.installedVersion)) {
+    const error = new Error(
+      `Installed explainer-kit ${compatibility.installedVersion} does not provide adaptive set planning. Run \`oat tools update --pack utility --scope user\`.`,
+    );
+    error.code = 'E_CORE_INCOMPATIBLE';
+    error.compatibility = compatibility;
+    throw error;
+  }
 
   const resolvedConfig = await resolveExplainerConfig({
     repoRoot,
@@ -73,6 +89,7 @@ export async function runOatExplainer({
   const projectRoot = resolve(repoRoot, activeProject);
   const bound = await bindProjectSources({
     projectRoot,
+    repoRoot,
     recipe,
     suppliedFactBasePath,
   });
@@ -115,16 +132,53 @@ export async function runOatExplainer({
     authorModulePath,
     coreOptions,
   });
+  const lifecycleSetPlanner = await resolveLifecycleSetPlanner({
+    planSet,
+    planSetModulePath,
+    coreOptions,
+    required: recipe === 'project-recap' && mode === 'unattended',
+  });
   const lifecycleCritic = await resolveLifecycleCritic({
     critic,
     criticModulePath,
     coreOptions,
   });
+  const reviewProvidersRequired =
+    recipe === 'project-recap' && mode === 'unattended';
+  const lifecycleBrowserSession = await resolveLifecycleBrowserSession({
+    core,
+    browserSession,
+    browserSessionModulePath,
+    browserProbe,
+    browserProbeModulePath,
+    coreOptions,
+    required: reviewProvidersRequired,
+  });
+  const lifecycleVisualCritic = await resolveLifecycleVisualCritic({
+    visualCritic,
+    visualCriticModulePath,
+    coreOptions,
+    required: reviewProvidersRequired,
+  });
+  assertDistinctProviderRoles({
+    author: lifecycleAuthor,
+    factCritic: lifecycleCritic,
+    browserProbe: lifecycleBrowserSession?.probe,
+    visualCritic: lifecycleVisualCritic,
+  });
   const result = await core.runExplainer(request, {
     ...coreOptions,
+    ...(lifecycleSetPlanner && { planSet: lifecycleSetPlanner }),
     ...(lifecycleAuthor && { author: lifecycleAuthor }),
     ...(lifecycleCritic && { critic: lifecycleCritic }),
+    ...(lifecycleBrowserSession && {
+      browserSession: lifecycleBrowserSession,
+    }),
+    ...(lifecycleVisualCritic && { visualCritic: lifecycleVisualCritic }),
     ...(bound.sourceLoader && { sourceLoader: bound.sourceLoader }),
+    ...(bound.sourceProvenance && {
+      sourceProvenance: bound.sourceProvenance,
+    }),
     reviewedSource: bound.reviewedSource,
   });
   const criticContractError = result?.errors?.find(
@@ -145,6 +199,74 @@ export async function runOatExplainer({
   };
 }
 
+export function supportsAdaptiveSetPlanning(version) {
+  if (typeof version !== 'string') return false;
+  const match = version.match(/^(\d+)\.(\d+)\.(\d+)(?:-|$)/);
+  if (!match) return false;
+  const [major, minor, patch] = match.slice(1).map(Number);
+  return (
+    major === 2 &&
+    (minor > 0 ||
+      (minor === 0 && patch >= Number(MINIMUM_CORE_VERSION.split('.')[2])))
+  );
+}
+
+async function resolveLifecycleSetPlanner({
+  planSet,
+  planSetModulePath,
+  coreOptions,
+  required,
+}) {
+  if (coreOptions?.planSet !== undefined) {
+    throw new TypeError(
+      'coreOptions.planSet is not supported at the OAT adapter boundary; supply planSet directly.',
+    );
+  }
+  if (planSet !== undefined && typeof planSet !== 'function') {
+    throw new TypeError('planSet must be a function when supplied.');
+  }
+  if (planSet !== undefined && planSetModulePath !== undefined) {
+    throw new Error(
+      'Supply only one provider-neutral set planner callback or set planner module entry point.',
+    );
+  }
+  if (planSet === undefined && planSetModulePath === undefined) {
+    if (!required) return null;
+    const error = new Error(
+      'Unattended OAT project recaps require exactly one provider-neutral set planner callback or set planner module entry point.',
+    );
+    error.code = 'E_SET_PLANNER_REQUIRED';
+    throw error;
+  }
+  if (planSetModulePath === undefined) {
+    return planSet;
+  }
+  if (
+    typeof planSetModulePath !== 'string' ||
+    planSetModulePath.trim().length === 0
+  ) {
+    throw new TypeError('planSetModulePath must be a non-empty path.');
+  }
+
+  let plannerModule;
+  try {
+    plannerModule = await import(
+      pathToFileURL(resolve(planSetModulePath.trim())).href
+    );
+  } catch (cause) {
+    throw new Error(
+      `Unable to load provider-neutral set planner module at ${planSetModulePath}.`,
+      { cause },
+    );
+  }
+  if (typeof plannerModule.planSet !== 'function') {
+    throw new TypeError(
+      'Provider-neutral set planner module must export a planSet function.',
+    );
+  }
+  return plannerModule.planSet;
+}
+
 async function resolveLifecycleAuthor({
   author,
   authorModulePath,
@@ -255,7 +377,7 @@ async function resolveLifecycleCritic({
   if (!callback) {
     return null;
   }
-  return async (request) => {
+  const wrapped = async (request) => {
     const result = await callback(request);
     if (
       !result ||
@@ -273,6 +395,206 @@ async function resolveLifecycleCritic({
     }
     return result;
   };
+  return markProviderIdentity(wrapped, callback);
+}
+
+async function resolveLifecycleBrowserSession({
+  core,
+  browserSession,
+  browserSessionModulePath,
+  browserProbe,
+  browserProbeModulePath,
+  coreOptions,
+  required,
+}) {
+  if (coreOptions?.browserProbe !== undefined) {
+    throw new TypeError(
+      'coreOptions.browserProbe is not supported at the OAT adapter boundary; supply browserSession directly.',
+    );
+  }
+  if (browserProbe !== undefined || browserProbeModulePath !== undefined) {
+    throw new TypeError(
+      'Bare browserProbe callbacks are not supported at the OAT adapter boundary; supply a branded browserSession created by createBrowserProbeSession().',
+    );
+  }
+  if (coreOptions?.browserSession !== undefined) {
+    throw new TypeError(
+      'coreOptions.browserSession is not supported at the OAT adapter boundary; supply browserSession directly.',
+    );
+  }
+  if (browserSession !== undefined && browserSessionModulePath !== undefined) {
+    throw new Error(
+      'Supply only one browser session descriptor or browser session module entry point.',
+    );
+  }
+  let resolvedSession = browserSession;
+  if (browserSessionModulePath !== undefined) {
+    if (
+      typeof browserSessionModulePath !== 'string' ||
+      browserSessionModulePath.trim().length === 0
+    ) {
+      throw new TypeError('browserSessionModulePath must be a non-empty path.');
+    }
+    let sessionModule;
+    try {
+      sessionModule = await import(
+        pathToFileURL(resolve(browserSessionModulePath.trim())).href
+      );
+    } catch (cause) {
+      throw new Error(
+        `Unable to load browser session module at ${browserSessionModulePath}.`,
+        { cause },
+      );
+    }
+    resolvedSession = sessionModule.browserSession;
+  }
+  if (!resolvedSession) {
+    if (!required) return null;
+    const error = new Error(
+      'Unattended OAT project recaps require exactly one branded launched-Chromium browser session descriptor or browser session module entry point.',
+    );
+    error.code = 'E_BROWSER_PROBE_REQUIRED';
+    throw error;
+  }
+  if (typeof core.assertBrowserProbeSession !== 'function') {
+    const error = new Error(
+      'Compatible explainer-kit does not export browser session validation.',
+    );
+    error.code = 'E_CORE_INCOMPATIBLE';
+    throw error;
+  }
+  try {
+    return core.assertBrowserProbeSession(resolvedSession, {
+      allowFixture: !required,
+    });
+  } catch (cause) {
+    const error = new Error(
+      `Browser session validation failed: ${cause?.message ?? String(cause)}`,
+      { cause },
+    );
+    error.code = 'E_BROWSER_PROBE_REQUIRED';
+    throw error;
+  }
+}
+
+async function resolveLifecycleVisualCritic({
+  visualCritic,
+  visualCriticModulePath,
+  coreOptions,
+  required,
+}) {
+  if (coreOptions?.visualCritic !== undefined) {
+    throw new TypeError(
+      'coreOptions.visualCritic is not supported at the OAT adapter boundary; supply visualCritic directly.',
+    );
+  }
+  const callback = await resolveProviderCallback({
+    callback: visualCritic,
+    modulePath: visualCriticModulePath,
+    exportName: 'visualCritic',
+    label: 'visual critic',
+  });
+  if (!callback) {
+    if (!required) return null;
+    const error = new Error(
+      'Unattended OAT project recaps require exactly one provider-neutral visual critic callback or visual critic module entry point.',
+    );
+    error.code = 'E_VISUAL_CRITIC_REQUIRED';
+    throw error;
+  }
+  const wrapped = async (request, evidenceInput) => {
+    const result = await callback(request, evidenceInput);
+    if (
+      !result ||
+      typeof result !== 'object' ||
+      result.schemaVersion !== 'explainer-kit.visual-review-result/v1' ||
+      typeof result.reviewId !== 'string' ||
+      !/^[a-z0-9][a-z0-9._-]*$/.test(result.reviewId) ||
+      result.requestId !== request?.requestId ||
+      result.requestHash !== request?.requestHash ||
+      typeof result.reviewedAt !== 'string' ||
+      Number.isNaN(Date.parse(result.reviewedAt)) ||
+      !['pass', 'correct', 'fail'].includes(result.disposition) ||
+      !Array.isArray(result.artifactIds) ||
+      result.artifactIds.length !== request?.renderedArtifacts?.length ||
+      result.artifactIds.some(
+        (artifactId, index) =>
+          artifactId !== request.renderedArtifacts[index]?.artifactId,
+      ) ||
+      !Array.isArray(result.findings) ||
+      result.findings.some((finding) => !finding || typeof finding !== 'object')
+    ) {
+      throw new Error(
+        'Provider-neutral visual critic result does not match the visual review result contract.',
+      );
+    }
+    return result;
+  };
+  return markProviderIdentity(wrapped, callback);
+}
+
+async function resolveProviderCallback({
+  callback,
+  modulePath,
+  exportName,
+  label,
+}) {
+  if (callback !== undefined && typeof callback !== 'function') {
+    throw new TypeError(`${exportName} must be a function when supplied.`);
+  }
+  if (callback !== undefined && modulePath !== undefined) {
+    throw new Error(
+      `Supply only one provider-neutral ${label} callback or ${label} module entry point.`,
+    );
+  }
+  if (modulePath === undefined) return callback ?? null;
+  if (typeof modulePath !== 'string' || modulePath.trim().length === 0) {
+    throw new TypeError(`${exportName}ModulePath must be a non-empty path.`);
+  }
+  let providerModule;
+  try {
+    providerModule = await import(
+      pathToFileURL(resolve(modulePath.trim())).href
+    );
+  } catch (cause) {
+    throw new Error(
+      `Unable to load provider-neutral ${label} module at ${modulePath}.`,
+      { cause },
+    );
+  }
+  if (typeof providerModule[exportName] !== 'function') {
+    throw new TypeError(
+      `Provider-neutral ${label} module must export a ${exportName} function.`,
+    );
+  }
+  return providerModule[exportName];
+}
+
+const PROVIDER_IDENTITY = Symbol('oat-explainer-provider-identity');
+
+function markProviderIdentity(wrapper, callback) {
+  Object.defineProperty(wrapper, PROVIDER_IDENTITY, { value: callback });
+  return wrapper;
+}
+
+function providerIdentity(callback) {
+  return callback?.[PROVIDER_IDENTITY] ?? callback;
+}
+
+function assertDistinctProviderRoles(callbacks) {
+  const entries = Object.entries(callbacks).filter(([, callback]) => callback);
+  for (let left = 0; left < entries.length; left += 1) {
+    for (let right = left + 1; right < entries.length; right += 1) {
+      if (
+        providerIdentity(entries[left][1]) ===
+        providerIdentity(entries[right][1])
+      ) {
+        throw new Error(
+          `Provider roles ${entries[left][0]} and ${entries[right][0]} must use distinct callback identities.`,
+        );
+      }
+    }
+  }
 }
 
 async function readManifest(result, request) {

package/assets/skills/oat-project-autonomous/references/gate-inventory.md

@@ -233,7 +233,7 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `oat-project-design/references/selective-review-pass.md`       | `d4956192b82e -> DES-06`; `7d6e1f926ecb -> DES-06`; `04f918a5fcac -> DES-07`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | `oat-project-plan/SKILL.md`                                    | `5eb3949f32e1 -> NG`; `64a08153bb9e -> NG`; `655d61df0a8f -> NG`; `56b37486f09d -> PLAN-01`; `cf317c17c586 -> PLAN-02`; `781643b0f2c3 -> NG`; `01fd7cca8253 -> PLAN-04`; `7bc7fa3f2cbb -> NG`; `da28ce0a5f2e -> NG`; `e334f94c4d35 -> NG`; `1fa55762c038 -> NG`; `c0935b5484a2 -> NG`; `6008163054f8 -> PLAN-05`; `571271f4d71b -> PLAN-06`; `746b760289e4 -> PLAN-06`; `de195590ff83 -> NG`; `49640510829a -> PLAN-07`; `4bef7afa7a71 -> PLAN-08`; `e5886632533e -> PLAN-08`; `4cfe1df14372 -> NG`; `d116c97a500c -> PLAN-10`; `aa62facff547 -> PLAN-10`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> PLAN-11`; `1734b2c85c5d -> NG`; `b4af2220eb91 -> PLAN-11`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | `oat-project-import-plan/SKILL.md`                             | `f7ca8635452f -> NG`; `c2e5fa410069 -> NG`; `655d61df0a8f -> NG`; `dceff5cc04b5 -> NG`; `1af4957a1af2 -> IMPORT-01`; `45b699c1c0b5 -> IMPORT-01`; `ba6d120791c1 -> IMPORT-01`; `070ebc5259af -> IMPORT-03`; `c11552696e2e -> IMPORT-03`; `cfe661966baf -> IMPORT-04`; `baa91c0a0bf8 -> NG`; `e364e84b2702 -> NG`; `39031985a945 -> IMPORT-06`; `f106aa29a217 -> IMPORT-07`; `65038450aee3 -> IMPORT-07`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> IMPORT-09`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| `oat-project-implement/SKILL.md`                               | `18980f6bc1a6 -> NG`; `ffb3af0ba8ef -> NG`; `e0355c7a05e9 -> IMPLEMENT-11+IMPLEMENT-13+IMPLEMENT-16`; `6296f41ae11c -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> IMPLEMENT-01`; `8ce8a09feca4 -> NG`; `bd0cb4988188 -> NG`; `28af4ee0055d -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `oat-project-implement/SKILL.md`                               | `18980f6bc1a6 -> NG`; `e0355c7a05e9 -> IMPLEMENT-11+IMPLEMENT-13+IMPLEMENT-16`; `6296f41ae11c -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> IMPLEMENT-01`; `8ce8a09feca4 -> NG`; `bd0cb4988188 -> NG`; `28af4ee0055d -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | `oat-project-implement/references/completion-and-closeout.md`  | `f7dab9c1f96c -> IMPLEMENT-12`; `c69c17a069a8 -> IMPLEMENT-14`; `a97fa5634a68 -> IMPLEMENT-14`; `3af58881811c -> IMPLEMENT-14`; `4203e1f49d0f -> IMPLEMENT-14`; `c3bd2458a3d3 -> IMPLEMENT-13`; `95b5eafc070d -> IMPLEMENT-13`; `25ecbe9c998b -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f6f24fd71da4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f18283bc1cf9 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `2c1ffc4a82dd -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `3454a07aa843 -> IMPLEMENT-16`; `0d86e2098cfb -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d5fe597d266f -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `55a152e944c1 -> IMPLEMENT-16`; `effac7cbd573 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d2a34d8b148 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d27462aaed26 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d52ecb17268 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `5b91aabe3757 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `fd0ad919f702 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `63bf28df1474 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a4ed471dbc78 -> IMPLEMENT-16`; `6b7a64cec6e5 -> IMPLEMENT-16`; `0a4fdba0ebc0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a5033c2aada5 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `e77609eddba0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `351156e8dde4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `51d45bd2bbd1 -> IMPLEMENT-16`; `f7796ffcc804 -> IMPLEMENT-16`; `990d730cb494 -> IMPLEMENT-16`; `6ed28bb7d384 -> IMPLEMENT-16`; `8b7d4b5bcf1b -> IMPLEMENT-16`; `88aad500e6e9 -> IMPLEMENT-16`; `877e3e3f9eda -> IMPLEMENT-16`; `fc03c97f834e -> IMPLEMENT-16`; `12939a3da5e0 -> IMPLEMENT-16`; `bdb418335a88 -> IMPLEMENT-16`; `fba97e596ebd -> IMPLEMENT-16`; `3d0b5e2f14f0 -> IMPLEMENT-17`; `87f1424a8692 -> NG`; `6b1ec05182f0 -> IMPLEMENT-11`; `e6d696a27c91 -> NG`; `c77f8ccb52ad -> NG`; `48de2614c0ba -> IMPLEMENT-11`; `32d53f5212e5 -> IMPLEMENT-11`; `7cdb4a9c57b7 -> IMPLEMENT-11`; `16ffc0aa099b -> IMPLEMENT-11`; `d6868ea10b3f -> IMPLEMENT-11`; `4f05ff5567be -> IMPLEMENT-11`; `c70b47ae7a6d -> IMPLEMENT-11`; `5fafd093b58e -> NG`; `567d43ab0c2e -> NG`; `21ceaf7e658a -> NG`; `249427a9f475 -> NG`; `8a7ec13a9b7c -> NG`; `9aeb7fce2012 -> IMPLEMENT-18`; `f11a7cdda220 -> IMPLEMENT-18`; `4523ac029152 -> NG`; `6e87b08c4046 -> NG`; `baa6052c7f0a -> IMPLEMENT-18`; `27d3fad116b1 -> IMPLEMENT-18`; `2cfbeb4388a5 -> IMPLEMENT-18`; `c56ea56a56db -> NG`; `43e2e3c1380d -> IMPLEMENT-17`; `b49690277fb5 -> NG`; `df12304d6a36 -> NG`; `52eacac11fef -> IMPLEMENT-17`; `60092df6b17b -> IMPLEMENT-17`; `361872c6b00e -> IMPLEMENT-17`; `d2bc711a75fb -> IMPLEMENT-17` |
 | `oat-project-implement/references/dispatch-and-dry-run.md`     | `21b85f5e4daa -> IMPLEMENT-08`; `74c92b32bb2a -> IMPLEMENT-08`; `8efd2d0517ab -> IMPLEMENT-09`; `461ed9b3e495 -> IMPLEMENT-09`; `b5ad64fd744d -> NG`; `14ce436cfffa -> NG`; `043ca36da3e2 -> NG`; `a23e45c1dc8d -> NG`; `498143bb41a7 -> NG`; `4fe3eb179023 -> NG`; `7f75485e5a33 -> NG`; `8ec3a96df029 -> NG`; `16c3f96e758d -> NG`; `5915c41fe058 -> NG`; `f51e43eeac56 -> NG`; `fd41c25623cb -> NG`; `58a932ed6453 -> NG`; `4718bd3ce12d -> NG`; `58c444a2126b -> NG`; `2df3adae4120 -> NG`; `e75df892b55c -> NG`; `8ba5dbd2a0d8 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | `oat-project-implement/references/docs/autonomy-contract.md`   | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

package/assets/skills/oat-project-document/references/docs/autonomy-contract.md

@@ -233,7 +233,7 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `oat-project-design/references/selective-review-pass.md`       | `d4956192b82e -> DES-06`; `7d6e1f926ecb -> DES-06`; `04f918a5fcac -> DES-07`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | `oat-project-plan/SKILL.md`                                    | `5eb3949f32e1 -> NG`; `64a08153bb9e -> NG`; `655d61df0a8f -> NG`; `56b37486f09d -> PLAN-01`; `cf317c17c586 -> PLAN-02`; `781643b0f2c3 -> NG`; `01fd7cca8253 -> PLAN-04`; `7bc7fa3f2cbb -> NG`; `da28ce0a5f2e -> NG`; `e334f94c4d35 -> NG`; `1fa55762c038 -> NG`; `c0935b5484a2 -> NG`; `6008163054f8 -> PLAN-05`; `571271f4d71b -> PLAN-06`; `746b760289e4 -> PLAN-06`; `de195590ff83 -> NG`; `49640510829a -> PLAN-07`; `4bef7afa7a71 -> PLAN-08`; `e5886632533e -> PLAN-08`; `4cfe1df14372 -> NG`; `d116c97a500c -> PLAN-10`; `aa62facff547 -> PLAN-10`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> PLAN-11`; `1734b2c85c5d -> NG`; `b4af2220eb91 -> PLAN-11`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | `oat-project-import-plan/SKILL.md`                             | `f7ca8635452f -> NG`; `c2e5fa410069 -> NG`; `655d61df0a8f -> NG`; `dceff5cc04b5 -> NG`; `1af4957a1af2 -> IMPORT-01`; `45b699c1c0b5 -> IMPORT-01`; `ba6d120791c1 -> IMPORT-01`; `070ebc5259af -> IMPORT-03`; `c11552696e2e -> IMPORT-03`; `cfe661966baf -> IMPORT-04`; `baa91c0a0bf8 -> NG`; `e364e84b2702 -> NG`; `39031985a945 -> IMPORT-06`; `f106aa29a217 -> IMPORT-07`; `65038450aee3 -> IMPORT-07`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> IMPORT-09`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| `oat-project-implement/SKILL.md`                               | `18980f6bc1a6 -> NG`; `ffb3af0ba8ef -> NG`; `e0355c7a05e9 -> IMPLEMENT-11+IMPLEMENT-13+IMPLEMENT-16`; `6296f41ae11c -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> IMPLEMENT-01`; `8ce8a09feca4 -> NG`; `bd0cb4988188 -> NG`; `28af4ee0055d -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `oat-project-implement/SKILL.md`                               | `18980f6bc1a6 -> NG`; `e0355c7a05e9 -> IMPLEMENT-11+IMPLEMENT-13+IMPLEMENT-16`; `6296f41ae11c -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> IMPLEMENT-01`; `8ce8a09feca4 -> NG`; `bd0cb4988188 -> NG`; `28af4ee0055d -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | `oat-project-implement/references/completion-and-closeout.md`  | `f7dab9c1f96c -> IMPLEMENT-12`; `c69c17a069a8 -> IMPLEMENT-14`; `a97fa5634a68 -> IMPLEMENT-14`; `3af58881811c -> IMPLEMENT-14`; `4203e1f49d0f -> IMPLEMENT-14`; `c3bd2458a3d3 -> IMPLEMENT-13`; `95b5eafc070d -> IMPLEMENT-13`; `25ecbe9c998b -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f6f24fd71da4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f18283bc1cf9 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `2c1ffc4a82dd -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `3454a07aa843 -> IMPLEMENT-16`; `0d86e2098cfb -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d5fe597d266f -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `55a152e944c1 -> IMPLEMENT-16`; `effac7cbd573 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d2a34d8b148 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d27462aaed26 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d52ecb17268 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `5b91aabe3757 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `fd0ad919f702 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `63bf28df1474 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a4ed471dbc78 -> IMPLEMENT-16`; `6b7a64cec6e5 -> IMPLEMENT-16`; `0a4fdba0ebc0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a5033c2aada5 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `e77609eddba0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `351156e8dde4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `51d45bd2bbd1 -> IMPLEMENT-16`; `f7796ffcc804 -> IMPLEMENT-16`; `990d730cb494 -> IMPLEMENT-16`; `6ed28bb7d384 -> IMPLEMENT-16`; `8b7d4b5bcf1b -> IMPLEMENT-16`; `88aad500e6e9 -> IMPLEMENT-16`; `877e3e3f9eda -> IMPLEMENT-16`; `fc03c97f834e -> IMPLEMENT-16`; `12939a3da5e0 -> IMPLEMENT-16`; `bdb418335a88 -> IMPLEMENT-16`; `fba97e596ebd -> IMPLEMENT-16`; `3d0b5e2f14f0 -> IMPLEMENT-17`; `87f1424a8692 -> NG`; `6b1ec05182f0 -> IMPLEMENT-11`; `e6d696a27c91 -> NG`; `c77f8ccb52ad -> NG`; `48de2614c0ba -> IMPLEMENT-11`; `32d53f5212e5 -> IMPLEMENT-11`; `7cdb4a9c57b7 -> IMPLEMENT-11`; `16ffc0aa099b -> IMPLEMENT-11`; `d6868ea10b3f -> IMPLEMENT-11`; `4f05ff5567be -> IMPLEMENT-11`; `c70b47ae7a6d -> IMPLEMENT-11`; `5fafd093b58e -> NG`; `567d43ab0c2e -> NG`; `21ceaf7e658a -> NG`; `249427a9f475 -> NG`; `8a7ec13a9b7c -> NG`; `9aeb7fce2012 -> IMPLEMENT-18`; `f11a7cdda220 -> IMPLEMENT-18`; `4523ac029152 -> NG`; `6e87b08c4046 -> NG`; `baa6052c7f0a -> IMPLEMENT-18`; `27d3fad116b1 -> IMPLEMENT-18`; `2cfbeb4388a5 -> IMPLEMENT-18`; `c56ea56a56db -> NG`; `43e2e3c1380d -> IMPLEMENT-17`; `b49690277fb5 -> NG`; `df12304d6a36 -> NG`; `52eacac11fef -> IMPLEMENT-17`; `60092df6b17b -> IMPLEMENT-17`; `361872c6b00e -> IMPLEMENT-17`; `d2bc711a75fb -> IMPLEMENT-17` |
 | `oat-project-implement/references/dispatch-and-dry-run.md`     | `21b85f5e4daa -> IMPLEMENT-08`; `74c92b32bb2a -> IMPLEMENT-08`; `8efd2d0517ab -> IMPLEMENT-09`; `461ed9b3e495 -> IMPLEMENT-09`; `b5ad64fd744d -> NG`; `14ce436cfffa -> NG`; `043ca36da3e2 -> NG`; `a23e45c1dc8d -> NG`; `498143bb41a7 -> NG`; `4fe3eb179023 -> NG`; `7f75485e5a33 -> NG`; `8ec3a96df029 -> NG`; `16c3f96e758d -> NG`; `5915c41fe058 -> NG`; `f51e43eeac56 -> NG`; `fd41c25623cb -> NG`; `58a932ed6453 -> NG`; `4718bd3ce12d -> NG`; `58c444a2126b -> NG`; `2df3adae4120 -> NG`; `e75df892b55c -> NG`; `8ba5dbd2a0d8 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | `oat-project-implement/references/docs/autonomy-contract.md`   | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

package/assets/skills/oat-project-implement/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-implement
-version: 2.2.2
+version: 2.2.3
 description: Use when plan.md is ready for execution. Dispatches one phase implementer per phase, owns independent phase review and bounded fix routing, and supports plan-declared worktree-isolated parallel phases.
 oat_gateable: true
 argument-hint: '[--retry-limit <N>] [--dry-run]'
@@ -19,16 +19,14 @@ Execute the implementation plan task-by-task with full state tracking.
 
 ## Shared Subagent Dispatch Contract
 
-Before resolving or launching any phase implementer, optional nested worker,
-fix continuation, or reviewer, read and follow
-`.agents/skills/oat-project-dispatch-subagents/SKILL.md`. The project adapter
-resolves lifecycle scope and then requires
-`.agents/skills/oat-dispatch-subagents/SKILL.md` for provider-neutral
-selection, recovery, and evidence. This explicit two-skill load is mandatory;
-do not rely on ambient skill discovery. This implementation skill retains
-lifecycle sequencing, verification, integration, and approval-aware final
-closeout.
-Correctness must not require a provider restart or hot reload.
+Before resolving or launching a phase implementer, optional child, fix, or
+reviewer, read `.agents/skills/oat-project-dispatch-subagents/SKILL.md`, then
+`.agents/skills/oat-dispatch-subagents/SKILL.md`. The former resolves lifecycle
+scope; the latter owns provider-neutral selection, recovery, and evidence.
+Display structured resolver notices before every implementation, fix, or
+reviewer launch. Runtime disclosure uses the effective resolved target, never
+the bundled recommendation version. This explicit load is mandatory, and
+correctness must not require a provider restart or hot reload.
 
 Read
 `.agents/skills/subagent-orchestration/references/model-selection-principles.md`.

package/assets/skills/oat-project-implement/references/dispatch-and-dry-run.md

@@ -157,7 +157,7 @@ Use the CLI resolver as the source of truth. The command name remains
 policy:
 
 ```bash
-oat project dispatch-ceiling resolve --provider <active-provider> --preflight --report-scope implementation-preflight --report-action implementation --json
+oat project dispatch-ceiling resolve --provider <active-provider> --preflight --task-class <task-class> [--task-effort <codex-preferred-effort>] --report-scope implementation-preflight --report-action implementation --json
 ```
 
 If `oat` is not in PATH, run the same command through
@@ -317,9 +317,11 @@ report context:
 - review: `--report-scope <phase-or-review-scope> --report-action review`
 
 Require `dispatchReport.schemaVersion: 1` in the completed resolver JSON before
-dispatch. Consume the report as the human/audit source: render the versioned
-block with `formatDispatchReport(dispatchReport)` semantics, and derive the
-formal compatibility line only through
+dispatch. Surface every structured entry in `dispatchReport.notices`, then
+render the versioned block with `formatDispatchReport(dispatchReport)`
+semantics, before the implementation, fix, or reviewer launch. Consume the
+report as the human/audit source, and derive the formal compatibility line only
+through
 `formatDispatchStamp(dispatchReport)` / `toDispatchStampRecord(dispatchReport)`.
 Never hand-assemble a second `Dispatch:` schema from policy labels, role names,
 candidate strings, or target names.
@@ -329,6 +331,10 @@ The exact provider invocation remains authoritative in
 the report does not replace or weaken target-pinned dispatch. Add independently
 observed runtime identity to `dispatchReport.runtimeIdentity` only when such an
 observation exists. Requested/configured controls are not runtime observation.
+Runtime disclosure must use the effective resolved target in that completed
+response. Never infer runtime controls or eligibility from
+`recommendationVersion`, which identifies only the bundled recommendation that
+was adopted.
 For gate-originated review, keep `dispatchReport.gateInvocation`, existing
 work-producer `diversity`, and reviewer `runtimeIdentity` as three distinct
 facts; producer stamps or self-report never overwrite configured invocation.
@@ -369,8 +375,9 @@ requested; never silently downgrade to it.
 6. For managed capped phase-implementer/fix dispatch, choose an exact
    configured candidate and use the exact-candidate branch, not the
    preferred-selection branch. For implementation, call
-   `oat project dispatch-ceiling resolve --provider codex --role implementer --ceiling-tier <project-or-phase-tier> --candidate-model <model> --candidate-effort <effort> --escalation-level <route-level> --report-scope <phase-id> --report-action implementation --json`.
+   `oat project dispatch-ceiling resolve --provider codex --role implementer --ceiling-tier <project-or-phase-tier> --candidate-model <model> --candidate-effort <effort> --task-class <task-class> --task-effort <preferred-effort> --escalation-level <route-level> --report-scope <phase-id> --report-action implementation --json`.
    For a bounded fix, use the same phase target with
+   the same `--task-class` and `--task-effort` classification provenance and
    `--report-scope <phase-or-fix-scope> --report-action fix`. Read
    `providers.codex.dispatchArgs.variant` and
    `providers.codex.selection.target`; never reuse a cap-only variant.
@@ -406,8 +413,9 @@ Claude rules:
   - Capped managed policy: target the configured policy cap directly.
   - Managed `Uncapped` or inherit/default: no reviewer target exists; omit `model` and log inherited/default model behavior.
 - For managed capped phase-implementer/fix dispatch, call
-  `oat project dispatch-ceiling resolve --provider claude --role implementer --ceiling-tier <project-or-phase-tier> --candidate-model <model> --orchestrator-tier <current-orchestrator-tier> --escalation-level <route-level> --report-scope <phase-id> --report-action implementation --json`.
-  For bounded fixes, reuse the exact phase target with a bounded fix scope.
+  `oat project dispatch-ceiling resolve --provider claude --role implementer --ceiling-tier <project-or-phase-tier> --candidate-model <model> --task-class <task-class> --orchestrator-tier <current-orchestrator-tier> --escalation-level <route-level> --report-scope <phase-id> --report-action implementation --json`.
+  For bounded fixes, reuse the exact phase target and task classification with a
+  bounded fix scope.
   For review dispatch, call the resolver with
   `--role reviewer --report-scope <phase-or-review-scope> --report-action review --json`
   and no candidate flags. Read `providers.claude.dispatchArgs.model` and pass it
@@ -443,8 +451,9 @@ Cursor rules:
   task-class resolution independently arrives there; reaching it because no
   candidate was selected is a defect.
 - For managed capped phase-implementer/fix dispatch, call
-  `oat project dispatch-ceiling resolve --provider cursor --role implementer --ceiling-tier <project-or-phase-tier> --candidate-model <opaque-model> --report-scope <phase-id> --report-action implementation --json`.
-  For bounded fixes, reuse the exact phase target with a bounded fix scope.
+  `oat project dispatch-ceiling resolve --provider cursor --role implementer --ceiling-tier <project-or-phase-tier> --candidate-model <opaque-model> --task-class <task-class> --report-scope <phase-id> --report-action implementation --json`.
+  For bounded fixes, reuse the exact phase target and task classification with a
+  bounded fix scope.
 - Require `providers.cursor.dispatchArgs.variant` and launch that exact
   resolver-selected native agent type first. Native acceptance plus the
   complete launcher payload is configured invocation evidence; it does not