@open-agent-toolkit/cli 0.2.9 → 0.2.11

package/assets/skills/explainer-kit/styles/clean-neutral.json

@@ -0,0 +1,77 @@
+{
+  "name": "clean-neutral",
+  "defaultMode": "light",
+  "modes": {
+    "light": {
+      "surface": {
+        "canvas": "#f4f6f9",
+        "panel": "#ffffff",
+        "elevated": "#eef1f5"
+      },
+      "ink": { "primary": "#16202e", "muted": "#4a5568", "inverse": "#ffffff" },
+      "accent": { "primary": "#2f56c9", "secondary": "#0e7180" },
+      "status": {
+        "success": "#157a54",
+        "warning": "#965108",
+        "danger": "#bd3a2c",
+        "info": "#2f56c9"
+      },
+      "diagramSeries": ["#2f56c9", "#965108", "#0e7180", "#6a4fc4"]
+    },
+    "dark": {
+      "surface": {
+        "canvas": "#111827",
+        "panel": "#1f2937",
+        "elevated": "#374151"
+      },
+      "ink": { "primary": "#f9fafb", "muted": "#d1d5db", "inverse": "#111827" },
+      "accent": { "primary": "#93c5fd", "secondary": "#5eead4" },
+      "status": {
+        "success": "#86efac",
+        "warning": "#fde047",
+        "danger": "#fca5a5",
+        "info": "#93c5fd"
+      },
+      "diagramSeries": ["#93c5fd", "#fde047", "#5eead4", "#c4b5fd"]
+    }
+  },
+  "typography": {
+    "sans": ["system-ui", "-apple-system", "BlinkMacSystemFont", "sans-serif"],
+    "serif": ["ui-serif", "Georgia", "serif"],
+    "mono": ["ui-monospace", "SFMono-Regular", "Consolas", "monospace"],
+    "scale": {
+      "caption": "0.875rem",
+      "body": "1rem",
+      "title": "1.5rem",
+      "display": "2.25rem"
+    },
+    "lineHeight": { "caption": 1.4, "body": 1.6, "title": 1.25, "display": 1.1 }
+  },
+  "spacing": {
+    "unit": 4,
+    "scale": { "xs": 4, "sm": 8, "md": 16, "lg": 24, "xl": 40 }
+  },
+  "geometry": { "radius": { "sm": 4, "md": 8, "lg": 12 }, "borderWidth": 1 },
+  "elevation": {
+    "shadows": {
+      "low": "0 1px 2px rgb(22 32 46 / 0.08)",
+      "high": "0 12px 28px rgb(22 32 46 / 0.16)"
+    }
+  },
+  "density": "comfortable",
+  "motion": {
+    "enabled": true,
+    "durationMs": { "fast": 120, "normal": 200, "slow": 320 },
+    "easing": {
+      "standard": "ease",
+      "emphasized": "cubic-bezier(0.2, 0, 0, 1)"
+    },
+    "reducedMotion": "disable-nonessential"
+  },
+  "diagrams": {
+    "lineWidth": 2,
+    "nodeGap": 32,
+    "arrowStyle": "straight",
+    "labelTreatment": "boxed"
+  }
+}

package/assets/skills/explainer-kit/styles/dark-edgy.json

@@ -0,0 +1,77 @@
+{
+  "name": "dark-edgy",
+  "defaultMode": "dark",
+  "modes": {
+    "light": {
+      "surface": {
+        "canvas": "#f3f5f7",
+        "panel": "#ffffff",
+        "elevated": "#e6eaee"
+      },
+      "ink": { "primary": "#17202b", "muted": "#4f5c6d", "inverse": "#0d1117" },
+      "accent": { "primary": "#4eb4b9", "secondary": "#4f91ad" },
+      "status": {
+        "success": "#9fd68a",
+        "warning": "#f0b878",
+        "danger": "#ff9aa2",
+        "info": "#7ddce0"
+      },
+      "diagramSeries": ["#397a98", "#8d591d", "#4e872f", "#7654a8"]
+    },
+    "dark": {
+      "surface": {
+        "canvas": "#0d1117",
+        "panel": "#161b22",
+        "elevated": "#1c232c"
+      },
+      "ink": { "primary": "#d9e0e8", "muted": "#aeb8c7", "inverse": "#0d1117" },
+      "accent": { "primary": "#7ddce0", "secondary": "#6fb7d8" },
+      "status": {
+        "success": "#9fd68a",
+        "warning": "#f0b878",
+        "danger": "#ff9aa2",
+        "info": "#7ddce0"
+      },
+      "diagramSeries": ["#7ddce0", "#f0b878", "#6fb7d8", "#c4a4f0"]
+    }
+  },
+  "typography": {
+    "sans": ["system-ui", "-apple-system", "BlinkMacSystemFont", "sans-serif"],
+    "serif": ["ui-serif", "Georgia", "serif"],
+    "mono": ["ui-monospace", "SFMono-Regular", "Consolas", "monospace"],
+    "scale": {
+      "caption": "0.8125rem",
+      "body": "0.9375rem",
+      "title": "1.375rem",
+      "display": "2rem"
+    },
+    "lineHeight": { "caption": 1.35, "body": 1.5, "title": 1.2, "display": 1.1 }
+  },
+  "spacing": {
+    "unit": 3,
+    "scale": { "xs": 3, "sm": 6, "md": 12, "lg": 18, "xl": 30 }
+  },
+  "geometry": { "radius": { "sm": 2, "md": 4, "lg": 8 }, "borderWidth": 1 },
+  "elevation": {
+    "shadows": {
+      "low": "0 1px 2px rgb(0 0 0 / 0.22)",
+      "high": "0 12px 30px rgb(0 0 0 / 0.38)"
+    }
+  },
+  "density": "compact",
+  "motion": {
+    "enabled": true,
+    "durationMs": { "fast": 100, "normal": 180, "slow": 280 },
+    "easing": {
+      "standard": "ease",
+      "emphasized": "cubic-bezier(0.2, 0.8, 0.2, 1)"
+    },
+    "reducedMotion": "disable-nonessential"
+  },
+  "diagrams": {
+    "lineWidth": 2,
+    "nodeGap": 24,
+    "arrowStyle": "straight",
+    "labelTreatment": "boxed"
+  }
+}

package/assets/skills/explainer-kit/styles/navy-ocean.json

@@ -0,0 +1,82 @@
+{
+  "name": "navy-ocean",
+  "defaultMode": "dark",
+  "modes": {
+    "light": {
+      "surface": {
+        "canvas": "#f4f7fb",
+        "panel": "#ffffff",
+        "elevated": "#e5ebf3"
+      },
+      "ink": { "primary": "#142033", "muted": "#46566d", "inverse": "#ffffff" },
+      "accent": { "primary": "#2867a8", "secondary": "#177583" },
+      "status": {
+        "success": "#187452",
+        "warning": "#92500b",
+        "danger": "#b83c32",
+        "info": "#2867a8"
+      },
+      "diagramSeries": ["#2867a8", "#92500b", "#177583", "#694eb5"]
+    },
+    "dark": {
+      "surface": {
+        "canvas": "#0e1420",
+        "panel": "#161d2b",
+        "elevated": "#1e2635"
+      },
+      "ink": { "primary": "#e7ecf3", "muted": "#aeb9c8", "inverse": "#0e1420" },
+      "accent": { "primary": "#77abec", "secondary": "#4cb8c4" },
+      "status": {
+        "success": "#5cc79a",
+        "warning": "#e3a54e",
+        "danger": "#e2857a",
+        "info": "#77abec"
+      },
+      "diagramSeries": ["#77abec", "#e3a54e", "#4cb8c4", "#a98fe0"]
+    }
+  },
+  "typography": {
+    "sans": ["system-ui", "-apple-system", "BlinkMacSystemFont", "sans-serif"],
+    "serif": ["Charter", "Bitstream Charter", "Georgia", "serif"],
+    "mono": ["ui-monospace", "SFMono-Regular", "Consolas", "monospace"],
+    "scale": {
+      "caption": "0.875rem",
+      "body": "1.0625rem",
+      "title": "1.75rem",
+      "display": "2.75rem"
+    },
+    "lineHeight": {
+      "caption": 1.45,
+      "body": 1.65,
+      "title": 1.18,
+      "display": 1.05
+    }
+  },
+  "spacing": {
+    "unit": 5,
+    "scale": { "xs": 5, "sm": 10, "md": 20, "lg": 30, "xl": 48 }
+  },
+  "geometry": { "radius": { "sm": 4, "md": 8, "lg": 12 }, "borderWidth": 1 },
+  "elevation": {
+    "shadows": {
+      "low": "0 1px 3px rgb(0 0 0 / 0.18)",
+      "high": "0 16px 36px rgb(0 0 0 / 0.28)"
+    }
+  },
+  "density": "comfortable",
+  "motion": {
+    "enabled": true,
+    "durationMs": { "fast": 140, "normal": 240, "slow": 380 },
+    "easing": {
+      "standard": "ease-out",
+      "emphasized": "cubic-bezier(0.16, 1, 0.3, 1)"
+    },
+    "reducedMotion": "disable-nonessential"
+  },
+  "diagrams": {
+    "lineWidth": 2,
+    "nodeGap": 36,
+    "arrowStyle": "curved",
+    "labelTreatment": "boxed"
+  }
+}

package/assets/skills/explainer-kit/templates/deck-shell.html

@@ -118,6 +118,20 @@
         outline: 2px solid var(--accent);
         outline-offset: 2px;
       }
+      .deck-progress {
+        position: fixed;
+        z-index: 4;
+        inset: auto 0 0;
+        height: 0.25rem;
+        background: var(--panel);
+      }
+      .deck-progress__bar {
+        display: block;
+        width: 0;
+        height: 100%;
+        background: var(--accent);
+        transition: width 180ms ease;
+      }
       html:not(.js) .deck {
         display: block;
         height: auto;
@@ -139,6 +153,17 @@
         .deck {
           scroll-behavior: auto;
         }
+        .deck-progress__bar {
+          transition: none;
+        }
+      }
+      @media (max-height: 42rem) {
+        .slide {
+          padding-block: 1.5rem 4rem;
+        }
+        .slide__content {
+          overflow-y: auto;
+        }
       }
       @media print {
         .deck {
@@ -166,6 +191,9 @@
         .deck-controls {
           display: none;
         }
+        .deck-progress {
+          display: none;
+        }
       }
     </style>
   </head>
@@ -183,21 +211,43 @@
         →
       </button>
     </nav>
+    <div
+      class="deck-progress"
+      id="deck-progress"
+      role="progressbar"
+      aria-label="Slide progress"
+      aria-valuemin="1"
+    >
+      <span class="deck-progress__bar"></span>
+    </div>
     <script>
       (() => {
         const deck = document.querySelector('.deck');
         const slides = [...document.querySelectorAll('.slide')];
         const counter = document.querySelector('#deck-counter');
+        const progress = document.querySelector('#deck-progress');
+        const progressBar = progress.querySelector('.deck-progress__bar');
+        const previous = document.querySelector('[data-direction="-1"]');
+        const next = document.querySelector('[data-direction="1"]');
+        const reducedMotion = matchMedia(
+          '(prefers-reduced-motion: reduce)',
+        ).matches;
         let current = 0;
 
         const update = (index) => {
           current = Math.max(0, Math.min(slides.length - 1, index));
           counter.textContent = `${current + 1} / ${slides.length}`;
+          progress.setAttribute('aria-valuemax', String(slides.length));
+          progress.setAttribute('aria-valuenow', String(current + 1));
+          progressBar.style.width = `${((current + 1) / slides.length) * 100}%`;
+          previous.disabled = current === 0;
+          next.disabled = current === slides.length - 1;
+          history.replaceState(null, '', `#slide-${current + 1}`);
         };
         const go = (index) => {
           update(index);
           slides[current]?.scrollIntoView({
-            behavior: 'smooth',
+            behavior: reducedMotion ? 'auto' : 'smooth',
             block: 'nearest',
             inline: 'start',
           });
@@ -226,7 +276,12 @@
           { root: deck, threshold: 0.6 },
         );
         slides.forEach((slide) => observer.observe(slide));
-        update(0);
+        const requested = location.hash.match(/^#slide-(\d+)$/);
+        go(requested ? Number(requested[1]) - 1 : 0);
+        addEventListener('hashchange', () => {
+          const match = location.hash.match(/^#slide-(\d+)$/);
+          if (match) go(Number(match[1]) - 1);
+        });
       })();
     </script>
   </body>

package/assets/skills/oat-explainer-kit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-explainer-kit
-version: 1.0.0
+version: 1.0.1
 description: Use when building project explainers or recaps from OAT configuration, state, and lifecycle artifacts.
 disable-model-invocation: false
 user-invocable: true
@@ -69,14 +69,20 @@ artifact is required. An explicit supplied fact-base path bypasses artifact
 federation and is passed through as `factBase.mode: supplied`.
 
 Unattended project runs pass `approved-oat-artifacts` provenance to the core's
-content-approval seam and never prompt. Federated runs still require an
-explicit provider-neutral critic callback. In-process callers may supply
-`critic` (or `coreOptions.critic` for compatibility); JSON/CLI callers supply
-`criticModulePath` naming a module whose `critic` export implements the same
-provider-neutral request/result contract. Supply exactly one critic seam.
-Approval provenance does not bypass fact reconciliation. Do not read private
-presets, vault files, provider configuration, or ambient destination
-configuration.
+content-approval seam and never prompt. Every unattended run also requires
+exactly one provider-neutral author seam: in-process callers supply `author`,
+while JSON/CLI callers supply `authorModulePath` naming a module with an
+`author` function export. The adapter validates and resolves that executable
+input before passing it to `core.runExplainer`; callbacks and module paths never
+enter the persisted run request.
+
+Federated runs still require an explicit provider-neutral critic callback.
+In-process callers may supply `critic` (or `coreOptions.critic` for
+compatibility); JSON/CLI callers supply `criticModulePath` naming a module whose
+`critic` export implements the same provider-neutral request/result contract.
+Supply exactly one critic seam. Approval provenance does not bypass fact
+reconciliation. Do not read private presets, vault files, provider
+configuration, or ambient destination configuration.
 
 ## Progress Indicators (User-Facing)
 

package/assets/skills/oat-explainer-kit/references/config-contract.md

@@ -9,8 +9,9 @@ constructing an `explainer-kit.run-request/v1`.
 
 | Key                                    | Stored scopes       | Built-in default |
 | -------------------------------------- | ------------------- | ---------------- |
-| `explainers.defaults.palette`          | local, shared, user | `neutral`        |
-| `explainers.defaults.visualProfile`    | local, shared, user | `clean`          |
+| `explainers.defaults.style`            | local, shared, user | `clean-neutral`  |
+| `explainers.defaults.palette`          | local, shared, user | unset            |
+| `explainers.defaults.visualProfile`    | local, shared, user | unset            |
 | `explainers.defaults.themeBundlePath`  | local, shared       | unset            |
 | `explainers.publish.provider`          | shared              | unset            |
 | `explainers.publish.s3Uri`             | shared              | unset            |
@@ -20,7 +21,7 @@ constructing an `explainer-kit.run-request/v1`.
 | `workflow.explainers.projectExplainer` | local, shared, user | `ask`            |
 | `workflow.explainers.projectRecap`     | local, shared, user | `ask`            |
 
-Explicit runtime inputs may override these ten keys for one invocation. They
+Explicit runtime inputs may override these eleven keys for one invocation. They
 do not write config. Recipe, slug, fact-base path, output root, per-run art
 direction, and private wrapper lanes are invocation inputs rather than config
 keys and are rejected from the runtime config-override map.
@@ -33,9 +34,13 @@ path follows the same repository confinement; a local absolute path may point
 outside the repository. Runtime paths follow the local rule. User config cannot
 set a theme bundle path.
 
-When a theme bundle path is present it replaces named palette and visual-profile
-selection and produces a warning. The adapter passes the resolved canonical
-path as `theme.suppliedBundlePath`.
+The four curated styles are `clean-neutral`, `business-corporate`,
+`navy-ocean`, and `dark-edgy`. A theme bundle path has highest precedence,
+followed by an explicit style. Legacy palette and visual-profile fields remain
+accepted as an advanced compatibility path and produce deprecation warnings.
+When no source explicitly configures any selection, the adapter leaves the
+request theme empty so the core records its visible `clean-neutral` fallback
+warning. The adapter passes a resolved bundle as `theme.suppliedBundlePath`.
 
 ## Publish block
 

package/assets/skills/oat-explainer-kit/references/lifecycle-contract.md

@@ -71,6 +71,19 @@ On a stale-write conflict, the caller must re-read state, resolve precedence
 again, and decide whether a write is still required. It must not retry the old
 record blindly.
 
+## Unattended author execution
+
+Every unattended adapter run must provide exactly one provider-neutral author
+seam. In-process callers pass `author`; JSON-only and official CLI callers put
+`authorModulePath` in the adapter context, naming a module whose `author` export
+is a function. Missing module files, invalid exports, and direct-plus-module
+conflicts fail at the adapter boundary.
+
+The resolved callback is passed only as the `author` option to
+`core.runExplainer`. It is never copied into `ExplainerRunRequestV1`,
+`run-request.json`, or another retained data contract. Interactive runs may
+omit an author and retain their existing reviewed-source path.
+
 ## Tracked-run finalization
 
 `planTrackedRunFinalization(request, context)` is the shared command planner for

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

@@ -246,22 +246,18 @@ function commitCommands(paths, subject) {
 }
 
 function immutablePackagePaths(manifest) {
-  const paths = [
-    manifest.source?.factBasePath,
-    'source/fact-base.md',
-    ...(manifest.artifacts ?? []).map(({ contentPath }) => contentPath),
-    manifest.theme?.path,
-    ...(manifest.artifacts ?? [])
-      .filter(
-        ({ status, renderedPath }) =>
-          status === 'built' && typeof renderedPath === 'string',
-      )
-      .map(({ renderedPath }) => renderedPath),
-  ];
-  if (paths.some((path) => typeof path !== 'string' || path.length === 0)) {
+  if (
+    !manifest.immutableHashes ||
+    typeof manifest.immutableHashes !== 'object' ||
+    Array.isArray(manifest.immutableHashes)
+  ) {
+    throw new Error('Manifest does not identify immutable package hashes.');
+  }
+  const paths = Object.keys(manifest.immutableHashes);
+  if (paths.length === 0) {
     throw new Error('Manifest does not identify a complete immutable package.');
   }
-  return [...new Set(paths)];
+  return paths;
 }
 
 function resolveRunPath(runRoot, path) {

package/assets/skills/oat-explainer-kit/scripts/resolve-config.mjs

@@ -7,6 +7,7 @@ import { resolveSourceAwarePath } from './resolve-paths.mjs';
 const execFileAsync = promisify(execFile);
 
 export const EXPLAINER_CONFIG_KEYS = Object.freeze([
+  'explainers.defaults.style',
   'explainers.defaults.palette',
   'explainers.defaults.visualProfile',
   'explainers.defaults.themeBundlePath',
@@ -22,6 +23,12 @@ export const EXPLAINER_CONFIG_KEYS = Object.freeze([
 const CONFIG_KEY_SET = new Set(EXPLAINER_CONFIG_KEYS);
 const SOURCES = new Set(['local', 'shared', 'user', 'env', 'default']);
 const PREFERENCES = new Set(['always', 'ask', 'never']);
+const STYLES = new Set([
+  'clean-neutral',
+  'business-corporate',
+  'navy-ocean',
+  'dark-edgy',
+]);
 
 export async function resolveExplainerConfig({
   repoRoot,
@@ -54,6 +61,22 @@ export async function resolveExplainerConfig({
   const bundlePath = nullableString(
     values['explainers.defaults.themeBundlePath'],
   );
+  const style = nullableString(values['explainers.defaults.style']);
+  if (style && !STYLES.has(style)) {
+    throw new Error(
+      'explainers.defaults.style must name a curated explainer style.',
+    );
+  }
+  const palette = nullableString(values['explainers.defaults.palette']);
+  const visualProfile = nullableString(
+    values['explainers.defaults.visualProfile'],
+  );
+  const hasLegacySelection = palette !== null || visualProfile !== null;
+  if (hasLegacySelection) {
+    warnings.push(
+      'Palette and visual profile configuration is deprecated; use explainers.defaults.style.',
+    );
+  }
   if (bundlePath) {
     theme.suppliedBundlePath = await resolveSourceAwarePath({
       repoRoot,
@@ -61,19 +84,35 @@ export async function resolveExplainerConfig({
       source: sources['explainers.defaults.themeBundlePath'],
       field: 'explainers.defaults.themeBundlePath',
     });
-    if (
-      nullableString(values['explainers.defaults.palette']) ||
-      nullableString(values['explainers.defaults.visualProfile'])
-    ) {
+    if (style || palette || visualProfile) {
       warnings.push(
-        'explainers.defaults.themeBundlePath overrides configured palette and visual profile.',
+        'explainers.defaults.themeBundlePath overrides configured style, palette, and visual profile.',
       );
     }
   } else {
-    theme.palette =
-      nullableString(values['explainers.defaults.palette']) ?? 'neutral';
-    theme.visualProfile =
-      nullableString(values['explainers.defaults.visualProfile']) ?? 'clean';
+    const explicitStyle =
+      style && sources['explainers.defaults.style'] !== 'default'
+        ? style
+        : null;
+    if (explicitStyle) {
+      theme.style = explicitStyle;
+    }
+    if (palette) {
+      theme.palette = palette;
+    }
+    if (visualProfile) {
+      theme.visualProfile = visualProfile;
+    }
+    if (explicitStyle && hasLegacySelection) {
+      warnings.push(
+        'explainers.defaults.style wins over deprecated palette and visual profile configuration.',
+      );
+    }
+    if (!explicitStyle && !hasLegacySelection) {
+      warnings.push(
+        'No explicit explainer style is configured; the core will default to clean-neutral.',
+      );
+    }
   }
 
   const publish = resolvePublish(values);
@@ -215,6 +254,11 @@ function normalizeRuntimeValue(key, value) {
   if (key === 'explainers.publish.provider' && normalized !== 's3-static') {
     throw new Error(`${key} runtime override must be s3-static.`);
   }
+  if (key === 'explainers.defaults.style' && !STYLES.has(normalized)) {
+    throw new Error(
+      `${key} runtime override must name a curated explainer style.`,
+    );
+  }
   if (key.startsWith('workflow.explainers.') && !PREFERENCES.has(normalized)) {
     throw new Error(`${key} runtime override must be always, ask, or never.`);
   }

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

@@ -32,6 +32,8 @@ export async function runOatExplainer({
   defaultMode,
   renderStrategy,
   retainRawArtDirection = false,
+  author,
+  authorModulePath,
   critic,
   criticModulePath,
   coreOptions = {},
@@ -108,6 +110,12 @@ export async function runOatExplainer({
     throw error;
   }
 
+  const lifecycleAuthor = await resolveLifecycleAuthor({
+    author,
+    authorModulePath,
+    coreOptions,
+    mode: request.mode,
+  });
   const lifecycleCritic = await resolveLifecycleCritic({
     critic,
     criticModulePath,
@@ -115,6 +123,7 @@ export async function runOatExplainer({
   });
   const result = await core.runExplainer(request, {
     ...coreOptions,
+    ...(lifecycleAuthor && { author: lifecycleAuthor }),
     ...(lifecycleCritic && { critic: lifecycleCritic }),
     ...(bound.sourceLoader && { sourceLoader: bound.sourceLoader }),
     reviewedSource: bound.reviewedSource,
@@ -136,6 +145,65 @@ export async function runOatExplainer({
   };
 }
 
+async function resolveLifecycleAuthor({
+  author,
+  authorModulePath,
+  coreOptions,
+  mode,
+}) {
+  if (coreOptions?.author !== undefined) {
+    throw new TypeError(
+      'coreOptions.author is not supported at the OAT adapter boundary; supply author directly.',
+    );
+  }
+  if (author !== undefined && typeof author !== 'function') {
+    throw new TypeError('author must be a function when supplied.');
+  }
+  if (author !== undefined && authorModulePath !== undefined) {
+    throw new Error(
+      'Supply only one provider-neutral author callback or author module entry point.',
+    );
+  }
+
+  if (author === undefined && authorModulePath === undefined) {
+    if (mode === 'unattended') {
+      const error = new Error(
+        'Unattended OAT explainer runs require exactly one provider-neutral author callback or author module entry point.',
+      );
+      error.code = 'E_AUTHOR_REQUIRED';
+      throw error;
+    }
+    return null;
+  }
+  if (authorModulePath === undefined) {
+    return author;
+  }
+  if (
+    typeof authorModulePath !== 'string' ||
+    authorModulePath.trim().length === 0
+  ) {
+    throw new TypeError('authorModulePath must be a non-empty path.');
+  }
+
+  let authorModule;
+  try {
+    authorModule = await import(
+      pathToFileURL(resolve(authorModulePath.trim())).href
+    );
+  } catch (cause) {
+    throw new Error(
+      `Unable to load provider-neutral author module at ${authorModulePath}.`,
+      { cause },
+    );
+  }
+  if (typeof authorModule.author !== 'function') {
+    throw new TypeError(
+      'Provider-neutral author module must export an author function.',
+    );
+  }
+  return authorModule.author;
+}
+
 async function resolveLifecycleCritic({
   critic,
   criticModulePath,