@farmslot/agent-runtime 0.1.1 → 0.3.0

package/dist/execution-template/resolve.js

@@ -0,0 +1,126 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { inferTemplateMetadata } from './infer.js';
+const SOURCE_KIND_RANK = {
+    custom: 0,
+    project: 1,
+    workspace: 2,
+    user: 3,
+    package: 4,
+    fallback: 5,
+};
+function listMarkdownFiles(root, layout) {
+    if (!existsSync(root) || !statSync(root).isDirectory())
+        return [];
+    const out = [];
+    if (layout === 'worker-flat') {
+        for (const entry of readdirSync(root, { withFileTypes: true })) {
+            if (entry.isFile() && entry.name.endsWith('.md')) {
+                out.push(path.join(root, entry.name));
+            }
+        }
+        return out.sort((a, b) => a.localeCompare(b));
+    }
+    // flow-tree: <root>/<flow>/*.md (one level under each flow dir)
+    for (const flowEntry of readdirSync(root, { withFileTypes: true })) {
+        if (!flowEntry.isDirectory())
+            continue;
+        const flowDir = path.join(root, flowEntry.name);
+        for (const fileEntry of readdirSync(flowDir, { withFileTypes: true })) {
+            if (fileEntry.isFile() && fileEntry.name.endsWith('.md')) {
+                out.push(path.join(flowDir, fileEntry.name));
+            }
+        }
+    }
+    return out.sort((a, b) => a.localeCompare(b));
+}
+function matchesFilters(entry, options) {
+    if (options.flow && entry.flow !== options.flow)
+        return false;
+    if (options.runMode && entry.runMode !== options.runMode)
+        return false;
+    if (options.platform) {
+        const platforms = entry.platforms;
+        if (!platforms.includes('*') && !platforms.includes(options.platform))
+            return false;
+    }
+    return true;
+}
+/**
+ * List execution templates across sources.
+ * Higher-precedence kinds win when ids collide; losers are marked `shadowedBy`.
+ */
+export function listExecutionTemplates(options) {
+    const includeShadowed = options.includeShadowed !== false;
+    // Same-kind ties break by CALLER order (the order sources were provided),
+    // not alphabetical ids — the caller's ordering is the intent.
+    const sources = options.sources
+        .map((source, callerIndex) => ({ source, callerIndex }))
+        .sort((a, b) => {
+        const rank = SOURCE_KIND_RANK[a.source.kind] - SOURCE_KIND_RANK[b.source.kind];
+        if (rank !== 0)
+            return rank;
+        return a.callerIndex - b.callerIndex;
+    })
+        .map(({ source }) => source);
+    const winners = new Map();
+    const shadowed = [];
+    // Shadowing resolves BEFORE filters: a filtered-out winner must not let a
+    // lower-precedence duplicate become effective through the filter.
+    for (const source of sources) {
+        for (const absolutePath of listMarkdownFiles(source.root, source.layout)) {
+            const relativePath = path.relative(source.root, absolutePath);
+            const text = readFileSync(absolutePath, 'utf8');
+            const entry = inferTemplateMetadata({
+                absolutePath,
+                relativePath,
+                source,
+                text,
+            });
+            const existing = winners.get(entry.id);
+            if (!existing) {
+                winners.set(entry.id, entry);
+                continue;
+            }
+            shadowed.push({ ...entry, shadowedBy: existing.sourceId });
+        }
+    }
+    const result = [...winners.values()].filter((entry) => matchesFilters(entry, options));
+    if (includeShadowed) {
+        result.push(...shadowed.filter((entry) => matchesFilters(entry, options)));
+    }
+    return result.sort((a, b) => {
+        if (a.flow !== b.flow)
+            return a.flow.localeCompare(b.flow);
+        if (Boolean(a.shadowedBy) !== Boolean(b.shadowedBy))
+            return a.shadowedBy ? 1 : -1;
+        return a.id.localeCompare(b.id);
+    });
+}
+/** Convenience: build a project worker-flat source. */
+export function projectWorkerTemplateSource(projectName, projectTemplatesDir) {
+    return {
+        id: `project:${projectName}`,
+        kind: 'project',
+        root: path.join(projectTemplatesDir, 'worker'),
+        layout: 'worker-flat',
+    };
+}
+/** Convenience: build a package flow-tree source (e.g. recipe-cook references/templates). */
+export function packageFlowTreeTemplateSource(packageId, templatesRoot) {
+    return {
+        id: `package:${packageId}`,
+        kind: 'package',
+        root: templatesRoot,
+        layout: 'flow-tree',
+    };
+}
+export function customTemplateSource(customId, root, layout = 'flow-tree') {
+    return {
+        id: `custom:${customId}`,
+        kind: 'custom',
+        root,
+        layout,
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/execution-template/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/execution-template/resolve.ts"],"names":[],"mappings":"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"}

package/dist/execution-template/types.d.ts

@@ -0,0 +1,66 @@
+/** Shared Markdown execution-template catalog (ADR-049). */
+export type ExecutionTemplateSourceKind = 'custom' | 'project' | 'workspace' | 'user' | 'package' | 'fallback';
+export type ExecutionTemplateLayout = 'flow-tree' | 'worker-flat';
+export type ExecutionRunMode = 'autonomous' | 'interactive' | 'validation';
+export interface ExecutionTemplateSource {
+    /** Stable source label for catalogs / shadowing (e.g. project:farmslot-farm). */
+    id: string;
+    kind: ExecutionTemplateSourceKind;
+    /** Absolute directory to scan. */
+    root: string;
+    layout: ExecutionTemplateLayout;
+}
+export interface ExecutionTemplateFrontmatter {
+    id?: string;
+    title?: string;
+    flow?: string;
+    version?: string | number;
+    runMode?: ExecutionRunMode;
+    platforms?: string[];
+    labels?: string[];
+    [key: string]: unknown;
+}
+export interface ExecutionTemplateEntry {
+    id: string;
+    title: string;
+    flow: string;
+    version: string;
+    runMode: ExecutionRunMode | null;
+    platforms: string[];
+    labels: string[];
+    path: string;
+    relativePath: string;
+    sourceId: string;
+    sourceKind: ExecutionTemplateSourceKind;
+    /** Present when a higher-precedence source already claimed this id. */
+    shadowedBy?: string;
+    frontmatter: ExecutionTemplateFrontmatter | null;
+    heading: string | null;
+}
+export interface ListExecutionTemplatesOptions {
+    sources: ExecutionTemplateSource[];
+    flow?: string;
+    runMode?: ExecutionRunMode;
+    platform?: string;
+    /** Include shadowed duplicates (default true for list diagnostics). */
+    includeShadowed?: boolean;
+}
+export interface LintIssue {
+    path: string;
+    severity: 'error' | 'warning';
+    message: string;
+}
+export interface LintExecutionTemplatesResult {
+    ok: boolean;
+    issues: LintIssue[];
+    filesChecked: number;
+}
+export interface CreateExecutionTemplateOptions {
+    path: string;
+    flow?: string;
+    runMode?: ExecutionRunMode;
+    platforms?: string[];
+    title?: string;
+    force?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/execution-template/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/execution-template/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,MAAM,MAAM,2BAA2B,GACnC,QAAQ,GACR,SAAS,GACT,WAAW,GACX,MAAM,GACN,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,aAAa,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;AAE3E,MAAM,WAAW,uBAAuB;IACtC,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,2BAA2B,CAAC;IAClC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,uBAAuB,CAAC;CACjC;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,2BAA2B,CAAC;IACxC,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACjD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/execution-template/types.js

@@ -0,0 +1,3 @@
+/** Shared Markdown execution-template catalog (ADR-049). */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/execution-template/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/execution-template/types.ts"],"names":[],"mappings":"AAAA,4DAA4D"}

package/dist/index.d.ts

@@ -4,5 +4,6 @@ export declare const AGENT_RUNTIME_SCRIPT_EXPORTS: {
     readonly workerTerminalContract: "@farmslot/agent-runtime/scripts/worker-terminal-contract.cjs";
     readonly checkTaskArtifactContract: "@farmslot/agent-runtime/scripts/check-task-artifact-contract.mjs";
 };
+export * from './execution-template/index.js';
 export * from './recipe-quality.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAE/D,eAAO,MAAM,4BAA4B;;;;CAI/B,CAAC;AAEX,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAE/D,eAAO,MAAM,4BAA4B;;;;CAI/B,CAAC;AAEX,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -4,5 +4,6 @@ export const AGENT_RUNTIME_SCRIPT_EXPORTS = {
     workerTerminalContract: '@farmslot/agent-runtime/scripts/worker-terminal-contract.cjs',
     checkTaskArtifactContract: '@farmslot/agent-runtime/scripts/check-task-artifact-contract.mjs',
 };
+export * from './execution-template/index.js';
 export * from './recipe-quality.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE/D,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,iBAAiB,EAAE,yDAAyD;IAC5E,sBAAsB,EAAE,8DAA8D;IACtF,yBAAyB,EAAE,kEAAkE;CACrF,CAAC;AAEX,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE/D,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,iBAAiB,EAAE,yDAAyD;IAC5E,sBAAsB,EAAE,8DAA8D;IACtF,yBAAyB,EAAE,kEAAkE;CACrF,CAAC;AAEX,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/agent-runtime",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,7 +20,7 @@
   },
   "scripts": {
     "typecheck": "yarn workspace @farmslot/protocol build && tsc --noEmit --project tsconfig.json",
-    "test": "node test/mark-checklist-step.test.cjs && node test/checklist-target-sync.test.mjs && node test/package-exports.test.cjs && node test/check-task-artifact-contract.test.cjs && node test/recipe-quality-builder.test.cjs",
+    "test": "node test/mark-checklist-step.test.cjs && node test/checklist-target-sync.test.mjs && node test/package-exports.test.cjs && node test/check-task-artifact-contract.test.cjs && node test/recipe-quality-builder.test.cjs && node ../../scripts/quality/run-tsx-tests.mjs --cwd . --tsconfig tsconfig.json src/execution-template",
     "format": "prettier --write --ignore-path ../../.prettierignore .",
     "format:check": "prettier --check --ignore-path ../../.prettierignore .",
     "lint": "eslint \"src/**/*.ts\"",
@@ -31,12 +31,13 @@
     "prepublishOnly": "node ../../scripts/quality/check-farmslot-package-readiness.mjs --publish --packages @farmslot/agent-runtime"
   },
   "dependencies": {
-    "@farmslot/protocol": ">=0.7.4"
+    "@farmslot/protocol": "0.11.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "eslint": "^10.3.0",
     "prettier": "^3.8.3",
+    "tsx": "^4.19.0",
     "typescript": "^5.6.0"
   },
   "repository": {
@@ -66,7 +67,8 @@
     "dist/**/*.d.ts.map",
     "dist/**/*.js.map",
     "scripts/**/*.cjs",
-    "scripts/**/*.mjs"
+    "scripts/**/*.mjs",
+    "scripts/execution-template-cli.mjs"
   ],
   "publishConfig": {
     "access": "public"

package/scripts/check-task-artifact-contract.mjs

@@ -1,22 +1,84 @@
 #!/usr/bin/env node
-import { existsSync, readFileSync, statSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 const require = createRequire(import.meta.url);
 const { expandedArtifactsForCommand } = require('./worker-terminal-contract.cjs');
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const workspaceProtocolRoot = path.resolve(packageRoot, '../protocol');
+
+function isMissingWorkspaceProtocolBuild(error, output) {
+  return (
+    error?.code === 'ERR_MODULE_NOT_FOUND' &&
+    path.basename(path.dirname(packageRoot)) === 'packages' &&
+    existsSync(path.join(workspaceProtocolRoot, 'package.json')) &&
+    !existsSync(path.join(workspaceProtocolRoot, output))
+  );
+}
 
 let sharedRecipeQualityValidator = null;
+let sharedRecipeDocumentValidator = null;
+let sharedRecipeArtifactPackageValidator = null;
+let sharedResolvedRecipeArtifactPath = null;
+// Keep the source-checkout fallback pinned to the canonical Recipe v1 schema.
+const RECIPE_SCHEMA_URL = 'https://farmslot.io/schemas/recipe-v1.schema.json';
 try {
-  ({ isRecipeQualityArtifact: sharedRecipeQualityValidator } =
-    await import('@farmslot/protocol/contracts/recipes'));
+  const qualityProtocol = await import('@farmslot/protocol/contracts/recipes');
+  if (typeof qualityProtocol.isRecipeQualityArtifact !== 'function') {
+    throw new Error('installed @farmslot/protocol does not export isRecipeQualityArtifact');
+  }
+  sharedRecipeQualityValidator = qualityProtocol.isRecipeQualityArtifact;
 } catch (error) {
+  if (!isMissingWorkspaceProtocolBuild(error, 'dist/contracts/recipes.js')) throw error;
   // Source checkouts run this script before @farmslot/protocol has emitted dist/.
   // Keep strict local validation instead of downgrading to the historical loose gate.
   if (process.env.FARMSLOT_DEBUG_AGENT_RUNTIME) {
     console.warn(`[agent-runtime] using local RecipeQualityArtifact fallback: ${error.message}`);
   }
 }
+let recipeProtocol = null;
+try {
+  recipeProtocol = await import('@farmslot/protocol/recipe');
+} catch (error) {
+  if (!isMissingWorkspaceProtocolBuild(error, 'dist/recipe/index.js')) throw error;
+  // Source checkouts can run before @farmslot/protocol has emitted dist/.
+  // Keep strict local validation until the shared validator is available.
+  if (process.env.FARMSLOT_DEBUG_AGENT_RUNTIME) {
+    console.warn(`[agent-runtime] using local Recipe v1 fallback: ${error.message}`);
+  }
+}
+if (recipeProtocol) {
+  for (const api of [
+    'validateRecipeDocument',
+    'validateRecipeArtifactPackage',
+    'resolvedRecipeArtifactPath',
+  ]) {
+    if (typeof recipeProtocol[api] !== 'function') {
+      throw new Error(`installed @farmslot/protocol does not export ${api}`);
+    }
+  }
+  const compatibilityProbe = recipeProtocol.validateRecipeDocument({
+    $schema: RECIPE_SCHEMA_URL,
+    description: 'Validate the canonical Recipe v1 envelope.',
+    workflow: {
+      entry: 'done',
+      nodes: { done: { action: 'end', status: 'pass' } },
+    },
+  });
+  const incompatibleFinding = compatibilityProbe?.findings?.find(
+    (finding) => finding?.severity === 'error',
+  );
+  if (incompatibleFinding) {
+    throw new Error(
+      `installed @farmslot/protocol rejects canonical Recipe v1 (${incompatibleFinding.code})`,
+    );
+  }
+  sharedRecipeDocumentValidator = recipeProtocol.validateRecipeDocument;
+  sharedRecipeArtifactPackageValidator = recipeProtocol.validateRecipeArtifactPackage;
+  sharedResolvedRecipeArtifactPath = recipeProtocol.resolvedRecipeArtifactPath;
+}
 
 const taskDir = process.argv[2];
 const rawArgs = process.argv.slice(3);
@@ -66,15 +128,34 @@ const allowedOmitKeys = new Set(['file', 'reason']);
 
 function fileExists(rel) {
   try {
-    return statSync(path.join(taskDir, rel)).isFile();
-  } catch {
+    return statSync(resolveTaskArtifactPath(rel)).isFile();
+  } catch (error) {
+    if (!isMissingPathError(error)) throw error;
     return false;
   }
 }
 
 function readText(rel) {
-  const p = path.join(taskDir, rel);
-  return existsSync(p) ? readFileSync(p, 'utf8') : null;
+  try {
+    return readFileSync(resolveTaskArtifactPath(rel), 'utf8');
+  } catch (error) {
+    if (!isMissingPathError(error)) throw error;
+    return null;
+  }
+}
+
+function isMissingPathError(error) {
+  return error && typeof error === 'object' && error.code === 'ENOENT';
+}
+
+function resolveTaskArtifactPath(rel) {
+  const root = realpathSync(taskDir);
+  const candidate = realpathSync(path.resolve(taskDir, rel));
+  const relative = path.relative(root, candidate);
+  if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+    throw new Error(`${rel} resolves outside the task directory`);
+  }
+  return candidate;
 }
 
 function isRecord(value) {
@@ -116,7 +197,7 @@ function isRecipeQualityArtifactFallback(value) {
   if (fields.project != null && typeof fields.project !== 'string') return false;
   if (
     fields.flow_type != null &&
-    !['fix-bug', 'review-pr', 'dev', 'pr-complete', 'merge-main'].includes(fields.flow_type)
+    !['fix-bug', 'review-pr', 'dev', 'pr-complete', 'update-branch'].includes(fields.flow_type)
   )
     return false;
   if (fields.task_type != null && typeof fields.task_type !== 'string') return false;
@@ -226,6 +307,166 @@ function validateRecipeQualityArtifact() {
   }
 }
 
+function validateRecipeDocumentArtifact() {
+  const authoredRecipe = readJsonArtifact('artifacts/recipe.json', 'recipe.json');
+  if (authoredRecipe === undefined) return;
+  validateRecipeDocumentValue(authoredRecipe, 'recipe.json', { skipRecipeCallResolution: true });
+
+  const packageRoot = 'artifacts/recipe-run';
+  const recipe = readJsonArtifact(`${packageRoot}/recipe.json`, 'recipe-run/recipe.json');
+  if (recipe === undefined) {
+    issues.push('artifacts/recipe-run/recipe.json is missing');
+    return;
+  }
+  if (canonicalJson(authoredRecipe) !== canonicalJson(recipe)) {
+    issues.push('artifacts/recipe-run/recipe.json does not match artifacts/recipe.json');
+  }
+  const manifest = readJsonArtifact(
+    `${packageRoot}/artifact-manifest.json`,
+    'recipe-run/artifact-manifest.json',
+  );
+  const recipeResolution = readJsonArtifact(
+    `${packageRoot}/recipe-resolution.json`,
+    'recipe-run/recipe-resolution.json',
+  );
+  const resolvedRecipes = {};
+  if (isRecord(recipeResolution) && Array.isArray(recipeResolution.dependencies)) {
+    for (const dependency of recipeResolution.dependencies) {
+      if (!isRecord(dependency)) continue;
+      const artifact = resolvedRecipeArtifactPath(dependency.digest);
+      if (!artifact) continue;
+      const document = readJsonArtifact(`${packageRoot}/${artifact}`, `recipe-run/${artifact}`);
+      if (document !== undefined) resolvedRecipes[String(dependency.digest)] = document;
+    }
+  }
+  if (sharedRecipeArtifactPackageValidator) {
+    const result = sharedRecipeArtifactPackageValidator({
+      recipe,
+      manifest,
+      recipeResolution,
+      resolvedRecipes,
+      artifactPaths: listArtifactPaths(path.join(taskDir, packageRoot)),
+    });
+    for (const finding of result.findings) {
+      if (finding.severity === 'error') {
+        issues.push(`${finding.code} ${finding.path}: ${finding.message}`);
+      }
+    }
+    return;
+  }
+  if (manifest === undefined) issues.push('artifact-manifest.json is missing');
+  if (recipeResolution === undefined) issues.push('recipe-resolution.json is missing');
+  const externalRecipeIds = new Set(
+    isRecord(recipeResolution) && Array.isArray(recipeResolution.dependencies)
+      ? recipeResolution.dependencies
+          .filter(isRecord)
+          .map((dependency) => dependency.ref)
+          .filter((ref) => typeof ref === 'string')
+      : [],
+  );
+  validateRecipeDocumentValue(recipe, 'recipe.json', { externalRecipeIds });
+  for (const [digest, document] of Object.entries(resolvedRecipes)) {
+    validateRecipeDocumentValue(document, `resolved recipe ${digest}`, { externalRecipeIds });
+  }
+}
+
+function canonicalJson(value) {
+  if (Array.isArray(value)) return `[${value.map(canonicalJson).join(',')}]`;
+  if (isRecord(value)) {
+    return `{${Object.entries(value)
+      .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+      .map(([key, entry]) => `${JSON.stringify(key)}:${canonicalJson(entry)}`)
+      .join(',')}}`;
+  }
+  return JSON.stringify(value);
+}
+
+function resolvedRecipeArtifactPath(digest) {
+  if (sharedResolvedRecipeArtifactPath) return sharedResolvedRecipeArtifactPath(digest);
+  if (typeof digest !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(digest)) return undefined;
+  return `resolved-recipes/${digest.slice('sha256:'.length)}.recipe.json`;
+}
+
+function readJsonArtifact(relPath, label) {
+  const text = readText(relPath);
+  if (!text) return undefined;
+  try {
+    return JSON.parse(text);
+  } catch (error) {
+    issues.push(`${label}: invalid JSON: ${error.message}`);
+    return undefined;
+  }
+}
+
+function validateRecipeDocumentValue(recipe, label, options) {
+  if (sharedRecipeDocumentValidator) {
+    const result = sharedRecipeDocumentValidator(recipe, options);
+    for (const finding of result.findings) {
+      if (finding.severity === 'error') {
+        issues.push(`${label}: ${finding.code} ${finding.path}: ${finding.message}`);
+      }
+    }
+    return;
+  }
+  if (!isRecord(recipe)) {
+    issues.push(`${label}: expected object`);
+    return;
+  }
+  const allowedRootFields = new Set([
+    '$schema',
+    'title',
+    'description',
+    'paramsSchema',
+    'proofTargets',
+    'workflow',
+  ]);
+  for (const field of Object.keys(recipe)) {
+    if (!allowedRootFields.has(field))
+      issues.push(`${label}: unsupported top-level field ${field}`);
+  }
+  if (recipe.$schema !== RECIPE_SCHEMA_URL) {
+    issues.push(`${label}: $schema must equal ${RECIPE_SCHEMA_URL}`);
+  }
+  if (typeof recipe.description !== 'string' || !recipe.description.trim()) {
+    issues.push(`${label}: description must be a non-empty string`);
+  }
+  if (!isRecord(recipe.workflow)) {
+    issues.push(`${label}: workflow is required`);
+    return;
+  }
+  const workflow = recipe.workflow;
+  if (typeof workflow.entry !== 'string' || !workflow.entry.trim()) {
+    issues.push(`${label}: workflow.entry must be a non-empty string`);
+  }
+  if (!isRecord(workflow.nodes) || Object.keys(workflow.nodes).length === 0) {
+    issues.push(`${label}: workflow.nodes must be a non-empty object`);
+    return;
+  }
+  for (const [nodeId, node] of Object.entries(workflow.nodes)) {
+    if (!isRecord(node) || typeof node.action !== 'string' || !node.action.trim()) {
+      issues.push(`${label}: workflow.nodes.${nodeId}.action must be a non-empty string`);
+      continue;
+    }
+    if (node.action !== 'end' && (typeof node.intent !== 'string' || !node.intent.trim())) {
+      issues.push(`${label}: workflow.nodes.${nodeId}.intent must be a non-empty string`);
+    }
+  }
+}
+
+function listArtifactPaths(root) {
+  if (!existsSync(root)) return [];
+  const paths = [];
+  const visit = (dir, prefix) => {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+      if (entry.isDirectory()) visit(path.join(dir, entry.name), relative);
+      else if (entry.isFile()) paths.push(relative);
+    }
+  };
+  visit(root, '');
+  return paths.sort();
+}
+
 function parseManifest() {
   const text = readText('artifacts/evidence-manifest.json');
   if (!text) return null;
@@ -339,6 +580,7 @@ function parseManifest() {
 }
 
 const hasRecipe = fileExists('artifacts/recipe.json');
+validateRecipeDocumentArtifact();
 if (
   hasRecipe &&
   flags.has('--require-recipe-quality-if-recipe') &&