npm - @open-agent-toolkit/cli - Versions diffs - 0.2.26 → 0.2.28 - Mend

@open-agent-toolkit/cli 0.2.26 → 0.2.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (76) hide show

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

@@ -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 CHANGED Viewed

@@ -235,9 +235,9 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `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`; `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/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`; `4d6c519131e5 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | `oat-project-implement/references/docs/autonomy-contract.md`   | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `oat-project-implement/references/phase-execution.md`          | `27737e814790 -> NG`; `6dda2b8e62e2 -> IMPLEMENT-10`; `b3197086bb1e -> IMPLEMENT-10`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `oat-project-implement/references/phase-execution.md`          | `27737e814790 -> NG`; `6dda2b8e62e2 -> IMPLEMENT-10`; `b3197086bb1e -> IMPLEMENT-10`; `25f2a6e104ee -> NG`; `4aa21120295f -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | `oat-project-implement/references/plan-and-resume.md`          | `413829d31e32 -> IMPLEMENT-02`; `c7706cd8ad09 -> IMPLEMENT-03`; `a80a948df658 -> IMPLEMENT-03`; `b7ea139780ec -> IMPLEMENT-03+IMPLEMENT-04`; `8d438f2180ba -> IMPLEMENT-03`; `9e72e0518cda -> IMPLEMENT-03`; `3e177a1021e6 -> IMPLEMENT-03+IMPLEMENT-04`; `b59fc9eb9ce3 -> IMPLEMENT-03`; `a2b1d6855283 -> IMPLEMENT-03`; `44351a32e52a -> IMPLEMENT-03`; `b98b022f5523 -> IMPLEMENT-03`; `e9f5b949e214 -> IMPLEMENT-03`; `316fb6d9e980 -> IMPLEMENT-03`; `8b25a2c5c548 -> IMPLEMENT-03`; `1a59b1c0e705 -> IMPLEMENT-03`; `466cd562fc52 -> IMPLEMENT-03`; `083d896978d5 -> IMPLEMENT-03`; `f4ab11c13ae9 -> IMPLEMENT-03`; `7dc17ffcc1c4 -> IMPLEMENT-03`; `f731a90adabd -> IMPLEMENT-04`; `886ac01e7aa9 -> IMPLEMENT-04`; `b715db67df0c -> IMPLEMENT-04`; `2d9f26a539f3 -> IMPLEMENT-10`; `28384dee114f -> IMPLEMENT-05`; `f2591a4978b4 -> NG`; `8290823080b5 -> IMPLEMENT-06`; `f75789bf6c8e -> IMPLEMENT-07`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | `oat-project-document/SKILL.md`                                | `4fc2d8618208 -> NG`; `3f9b0273ba77 -> NG`; `40f8be47affa -> NG`; `3a3c390528f3 -> DOCUMENT-03`; `2a7ba093b315 -> DOCUMENT-02`; `252aabe44db2 -> DOCUMENT-02`; `3751172de299 -> DOCUMENT-02`; `b987a0697ba9 -> DOCUMENT-01`; `a06ff3ca7926 -> NG`; `0d04714ca9fc -> NG`; `f79af01d94c6 -> DOCUMENT-02`; `71634113c348 -> DOCUMENT-02`; `cdb707f5081e -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | `oat-project-document/references/docs/autonomy-contract.md`    | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

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

@@ -235,9 +235,9 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `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`; `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/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`; `4d6c519131e5 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | `oat-project-implement/references/docs/autonomy-contract.md`   | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `oat-project-implement/references/phase-execution.md`          | `27737e814790 -> NG`; `6dda2b8e62e2 -> IMPLEMENT-10`; `b3197086bb1e -> IMPLEMENT-10`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `oat-project-implement/references/phase-execution.md`          | `27737e814790 -> NG`; `6dda2b8e62e2 -> IMPLEMENT-10`; `b3197086bb1e -> IMPLEMENT-10`; `25f2a6e104ee -> NG`; `4aa21120295f -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | `oat-project-implement/references/plan-and-resume.md`          | `413829d31e32 -> IMPLEMENT-02`; `c7706cd8ad09 -> IMPLEMENT-03`; `a80a948df658 -> IMPLEMENT-03`; `b7ea139780ec -> IMPLEMENT-03+IMPLEMENT-04`; `8d438f2180ba -> IMPLEMENT-03`; `9e72e0518cda -> IMPLEMENT-03`; `3e177a1021e6 -> IMPLEMENT-03+IMPLEMENT-04`; `b59fc9eb9ce3 -> IMPLEMENT-03`; `a2b1d6855283 -> IMPLEMENT-03`; `44351a32e52a -> IMPLEMENT-03`; `b98b022f5523 -> IMPLEMENT-03`; `e9f5b949e214 -> IMPLEMENT-03`; `316fb6d9e980 -> IMPLEMENT-03`; `8b25a2c5c548 -> IMPLEMENT-03`; `1a59b1c0e705 -> IMPLEMENT-03`; `466cd562fc52 -> IMPLEMENT-03`; `083d896978d5 -> IMPLEMENT-03`; `f4ab11c13ae9 -> IMPLEMENT-03`; `7dc17ffcc1c4 -> IMPLEMENT-03`; `f731a90adabd -> IMPLEMENT-04`; `886ac01e7aa9 -> IMPLEMENT-04`; `b715db67df0c -> IMPLEMENT-04`; `2d9f26a539f3 -> IMPLEMENT-10`; `28384dee114f -> IMPLEMENT-05`; `f2591a4978b4 -> NG`; `8290823080b5 -> IMPLEMENT-06`; `f75789bf6c8e -> IMPLEMENT-07`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | `oat-project-document/SKILL.md`                                | `4fc2d8618208 -> NG`; `3f9b0273ba77 -> NG`; `40f8be47affa -> NG`; `3a3c390528f3 -> DOCUMENT-03`; `2a7ba093b315 -> DOCUMENT-02`; `252aabe44db2 -> DOCUMENT-02`; `3751172de299 -> DOCUMENT-02`; `b987a0697ba9 -> DOCUMENT-01`; `a06ff3ca7926 -> NG`; `0d04714ca9fc -> NG`; `f79af01d94c6 -> DOCUMENT-02`; `71634113c348 -> DOCUMENT-02`; `cdb707f5081e -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | `oat-project-document/references/docs/autonomy-contract.md`    | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

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

@@ -1,6 +1,6 @@
 ---
 name: oat-project-implement
-version: 2.2.3
+version: 2.2.4
 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]'
@@ -147,9 +147,10 @@ If you catch yourself:
 **Recovery:**
-1. Acknowledge the deviation
-2. Return to current task
-3. Document in implementation.md
+1. Complete pre-commit prevention before writing history.
+2. For post-commit defects, follow `oat_phase_recovery_policy` in
+   `references/phase-execution.md`, preserving history and the exact target.
+3. Record every recovery disposition in `implementation.md`.
 ## Process

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

@@ -306,6 +306,26 @@ an ordered matrix route:
   entry before retrying, up to the last available route entry and within
   `oat_orchestration_retry_limit`.
+#### Phase Recovery Target Continuity
+The route-level advancement above applies only to root-owned review-fix and gate
+loops. It does not apply to implementation recovery after a planned task has
+committed. Implementation recovery must never use route escalation or choose a
+new model, provider, route, or worker. It resumes the accepted phase handle at
+the launcher-owned exact target.
+When the host cannot resume that handle, the lifecycle contract may authorize a
+fresh same-target recovery launch only with the original request ID, unchanged
+target and dispatch axes, durable attempt budget, bounded scope, canonical
+recovery event, and a `continuation_events` link. Exact-target loss, missing
+original-request provenance, or inability to bind the same target stops for
+direction without fallback.
+`oat_phase_recovery_policy` is independent from
+`oat_orchestration_retry_limit`. Review-fix and gate loops keep their existing
+route escalation and retry accounting; the three-cycle review governance cap
+is unchanged.
 #### Dispatch Report V1 contract
 Every implementation, fix, and review resolver invocation MUST pass explicit
@@ -647,6 +667,7 @@ When the skill is invoked with `--dry-run`:
    Project:   {PROJECT_PATH}
    Tier:      {1 | 2}
    Retry:     {N}
+   Phase recovery: default={0-20}; overrides={pNN: 0-20 | none}
    Schedule:
      [1] p01 (sequential)