@farmslot/agent-runtime 0.3.1 → 0.5.0

package/dist/execution-template/snapshot.js

@@ -0,0 +1,46 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+export function sha256Text(text) {
+    return createHash('sha256').update(text).digest('hex');
+}
+export function executionTemplateReference(entry, renderedMarkdown) {
+    const declaredVersion = entry.frontmatter?.version;
+    return {
+        id: entry.id,
+        sourceId: entry.sourceId,
+        flow: entry.flow,
+        ...(entry.runMode ? { runMode: entry.runMode } : {}),
+        platforms: entry.platforms,
+        labels: entry.labels,
+        relativePath: entry.relativePath,
+        ...(entry.sourceRevision ? { sourceRevision: entry.sourceRevision } : {}),
+        ...(entry.sourceDirty === undefined ? {} : { sourceDirty: entry.sourceDirty }),
+        ...(declaredVersion == null || declaredVersion === ''
+            ? {}
+            : { version: String(declaredVersion) }),
+        sha256: entry.sha256,
+        ...(renderedMarkdown === undefined ? {} : { renderedSha256: sha256Text(renderedMarkdown) }),
+    };
+}
+export function readExecutionTemplateSnapshot(entry) {
+    const markdown = readFileSync(entry.path, 'utf8');
+    if (sha256Text(markdown) !== entry.sha256) {
+        throw new Error(`Execution template "${entry.id}" changed after catalog resolution. Refresh the catalog and select it again.`);
+    }
+    return { markdown, reference: executionTemplateReference(entry) };
+}
+export function materializeExecutionTemplate(entry, outputPath) {
+    const destination = path.resolve(outputPath);
+    if (existsSync(destination)) {
+        throw new Error(`Execution-template destination already exists: ${destination}`);
+    }
+    const snapshot = readExecutionTemplateSnapshot(entry);
+    mkdirSync(path.dirname(destination), { recursive: true });
+    writeFileSync(destination, snapshot.markdown, { encoding: 'utf8', flag: 'wx' });
+    return {
+        path: destination,
+        reference: executionTemplateReference(entry, snapshot.markdown),
+    };
+}
+//# sourceMappingURL=snapshot.js.map

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

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

package/dist/execution-template/source-config.d.ts

@@ -0,0 +1,19 @@
+import type { ProjectExecutionTemplatesConfig, UnavailableExecutionTemplateSource } from '@farmslot/protocol';
+import type { ExecutionTemplateSource } from './types.js';
+export type { UnavailableExecutionTemplateSource } from '@farmslot/protocol';
+export interface ResolvedExecutionTemplateSources {
+    sources: ExecutionTemplateSource[];
+    unavailable: UnavailableExecutionTemplateSource[];
+}
+export interface ResolveConfiguredExecutionTemplateSourcesOptions {
+    projectPackRoot: string;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function executionTemplateSourceRevision(root: string): string | undefined;
+export declare function executionTemplateSourceDirty(root: string): boolean | undefined;
+/**
+ * Resolve optional configured sources only when catalog options are requested.
+ * Missing roots are diagnostics, not project-load failures.
+ */
+export declare function resolveConfiguredExecutionTemplateSources(config: ProjectExecutionTemplatesConfig | undefined, options: ResolveConfiguredExecutionTemplateSourcesOptions): ResolvedExecutionTemplateSources;
+//# sourceMappingURL=source-config.d.ts.map

package/dist/execution-template/source-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-config.d.ts","sourceRoot":"","sources":["../../src/execution-template/source-config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,+BAA+B,EAC/B,kCAAkC,EACnC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,YAAY,EAAE,kCAAkC,EAAE,MAAM,oBAAoB,CAAC;AAE7E,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,WAAW,EAAE,kCAAkC,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,gDAAgD;IAC/D,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAUD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQhF;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAO9E;AAeD;;;GAGG;AACH,wBAAgB,yCAAyC,CACvD,MAAM,EAAE,+BAA+B,GAAG,SAAS,EACnD,OAAO,EAAE,gDAAgD,GACxD,gCAAgC,CAoDlC"}

package/dist/execution-template/source-config.js

@@ -0,0 +1,90 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, realpathSync, statSync } from 'node:fs';
+import path from 'node:path';
+function isWithin(base, candidate) {
+    const relative = path.relative(base, candidate);
+    return (relative === '' ||
+        (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative)));
+}
+export function executionTemplateSourceRevision(root) {
+    const result = spawnSync('git', ['-C', root, 'rev-parse', 'HEAD'], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    if (result.status !== 0)
+        return undefined;
+    const revision = result.stdout.trim();
+    return /^[0-9a-f]{40}$/i.test(revision) ? revision : undefined;
+}
+export function executionTemplateSourceDirty(root) {
+    const result = spawnSync('git', ['-C', root, 'status', '--porcelain', '--', '.'], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    if (result.status !== 0)
+        return undefined;
+    return result.stdout.trim().length > 0;
+}
+function configuredRoot(source, options) {
+    if (typeof source.root.env === 'string') {
+        const value = (options.env ?? process.env)[source.root.env]?.trim();
+        if (!value)
+            return { reason: 'missing-environment' };
+        if (!path.isAbsolute(value))
+            return { reason: 'invalid-root' };
+        return { path: value };
+    }
+    return { path: path.resolve(options.projectPackRoot, source.root.projectPath) };
+}
+/**
+ * Resolve optional configured sources only when catalog options are requested.
+ * Missing roots are diagnostics, not project-load failures.
+ */
+export function resolveConfiguredExecutionTemplateSources(config, options) {
+    const resolved = [];
+    const unavailable = [];
+    for (const source of config?.sources ?? []) {
+        const rootResult = configuredRoot(source, options);
+        if (!rootResult.path) {
+            unavailable.push({ id: source.id, reason: rootResult.reason ?? 'invalid-root' });
+            continue;
+        }
+        if (!existsSync(rootResult.path) || !statSync(rootResult.path).isDirectory()) {
+            unavailable.push({ id: source.id, reason: 'missing-root' });
+            continue;
+        }
+        const canonicalRoot = realpathSync(rootResult.path);
+        if ('projectPath' in source.root &&
+            !isWithin(realpathSync(options.projectPackRoot), canonicalRoot)) {
+            unavailable.push({ id: source.id, reason: 'invalid-root' });
+            continue;
+        }
+        const scanPath = path.resolve(canonicalRoot, source.subpath ?? '.');
+        if (!isWithin(canonicalRoot, scanPath)) {
+            unavailable.push({ id: source.id, reason: 'invalid-root' });
+            continue;
+        }
+        if (!existsSync(scanPath) || !statSync(scanPath).isDirectory()) {
+            unavailable.push({ id: source.id, reason: 'missing-root' });
+            continue;
+        }
+        const canonicalScanPath = realpathSync(scanPath);
+        if (!isWithin(canonicalRoot, canonicalScanPath)) {
+            unavailable.push({ id: source.id, reason: 'invalid-root' });
+            continue;
+        }
+        const sourceRevision = executionTemplateSourceRevision(canonicalScanPath);
+        const sourceDirty = executionTemplateSourceDirty(canonicalScanPath);
+        resolved.push({
+            id: source.id,
+            kind: source.kind,
+            root: canonicalScanPath,
+            layout: 'flow-tree',
+            ...(source.domains ? { domains: source.domains } : {}),
+            ...(sourceRevision ? { sourceRevision } : {}),
+            ...(sourceDirty === undefined ? {} : { sourceDirty }),
+        });
+    }
+    return { sources: resolved, unavailable };
+}
+//# sourceMappingURL=source-config.js.map

package/dist/execution-template/source-config.js.map

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

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

@@ -1,7 +1,8 @@
 /** Shared Markdown execution-template catalog (ADR-049). */
+import type { ExecutionTemplateDefault, ExecutionTemplateReference, ExecutionTemplateRunMode } from '@farmslot/protocol';
 export type ExecutionTemplateSourceKind = 'custom' | 'project' | 'workspace' | 'user' | 'package' | 'fallback';
 export type ExecutionTemplateLayout = 'flow-tree' | 'worker-flat';
-export type ExecutionRunMode = 'autonomous' | 'interactive' | 'validation';
+export type ExecutionRunMode = ExecutionTemplateRunMode;
 export interface ExecutionTemplateSource {
     /** Stable source label for catalogs / shadowing (e.g. project:farmslot-farm). */
     id: string;
@@ -9,10 +10,17 @@ export interface ExecutionTemplateSource {
     /** Absolute directory to scan. */
     root: string;
     layout: ExecutionTemplateLayout;
+    /** Exact domains supplied by source configuration. */
+    domains?: string[];
+    /** Git revision of the source root when available. */
+    sourceRevision?: string;
+    /** True when the source checkout had uncommitted changes. */
+    sourceDirty?: boolean;
 }
 export interface ExecutionTemplateFrontmatter {
     id?: string;
     title?: string;
+    description?: string;
     flow?: string;
     version?: string | number;
     runMode?: ExecutionRunMode;
@@ -23,6 +31,7 @@ export interface ExecutionTemplateFrontmatter {
 export interface ExecutionTemplateEntry {
     id: string;
     title: string;
+    description?: string;
     flow: string;
     version: string;
     runMode: ExecutionRunMode | null;
@@ -32,16 +41,43 @@ export interface ExecutionTemplateEntry {
     relativePath: string;
     sourceId: string;
     sourceKind: ExecutionTemplateSourceKind;
+    /** SHA-256 of the source Markdown before rendering. */
+    sha256: string;
+    sourceRevision?: string;
+    sourceDirty?: boolean;
     /** Present when a higher-precedence source already claimed this id. */
     shadowedBy?: string;
     frontmatter: ExecutionTemplateFrontmatter | null;
     heading: string | null;
 }
+export interface SelectExecutionTemplateOptions {
+    sources: ExecutionTemplateSource[];
+    flow: string;
+    platform: string;
+    runMode: ExecutionRunMode;
+    domain?: string;
+    explicitId?: string;
+    defaults?: ExecutionTemplateDefault[];
+}
+export type ListCompatibleExecutionTemplatesOptions = Omit<SelectExecutionTemplateOptions, 'explicitId' | 'defaults'>;
+export type ExecutionTemplateSelectionReason = 'explicit' | 'configured-default' | 'single-domain-candidate' | 'single-general-candidate';
+export interface SelectedExecutionTemplate {
+    entry: ExecutionTemplateEntry;
+    reason: ExecutionTemplateSelectionReason;
+    reference: ExecutionTemplateReference;
+}
+export type ExecutionTemplateSelectionErrorCode = 'ambiguous' | 'missing-or-incompatible' | 'no-compatible-template';
+export declare class ExecutionTemplateSelectionError extends Error {
+    readonly code: ExecutionTemplateSelectionErrorCode;
+    constructor(code: ExecutionTemplateSelectionErrorCode, message: string);
+}
 export interface ListExecutionTemplatesOptions {
     sources: ExecutionTemplateSource[];
     flow?: string;
     runMode?: ExecutionRunMode;
     platform?: string;
+    /** Keep general templates plus templates for this exact domain. */
+    domain?: string;
     /** Include shadowed duplicates (default true for list diagnostics). */
     includeShadowed?: boolean;
 }
@@ -61,6 +97,7 @@ export interface CreateExecutionTemplateOptions {
     runMode?: ExecutionRunMode;
     platforms?: string[];
     title?: string;
+    description?: string;
     force?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/execution-template/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,oBAAoB,CAAC;AAE5B,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,wBAAwB,CAAC;AAExD,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;IAChC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,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,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,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,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,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,8BAA8B;IAC7C,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACvC;AAED,MAAM,MAAM,uCAAuC,GAAG,IAAI,CACxD,8BAA8B,EAC9B,YAAY,GAAG,UAAU,CAC1B,CAAC;AAEF,MAAM,MAAM,gCAAgC,GACxC,UAAU,GACV,oBAAoB,GACpB,yBAAyB,GACzB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,MAAM,EAAE,gCAAgC,CAAC;IACzC,SAAS,EAAE,0BAA0B,CAAC;CACvC;AAED,MAAM,MAAM,mCAAmC,GAC3C,WAAW,GACX,yBAAyB,GACzB,wBAAwB,CAAC;AAE7B,qBAAa,+BAAgC,SAAQ,KAAK;aAEtC,IAAI,EAAE,mCAAmC;gBAAzC,IAAI,EAAE,mCAAmC,EACzD,OAAO,EAAE,MAAM;CAKlB;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,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,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,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/execution-template/types.js

@@ -1,3 +1,8 @@
-/** Shared Markdown execution-template catalog (ADR-049). */
-export {};
+export class ExecutionTemplateSelectionError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ExecutionTemplateSelectionError';
+    }
+}
 //# sourceMappingURL=types.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/execution-template/types.ts"],"names":[],"mappings":"AAAA,4DAA4D"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/execution-template/types.ts"],"names":[],"mappings":"AAqGA,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IACxD,YACkB,IAAyC,EACzD,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAqC;QAIzD,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/agent-runtime",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,7 +16,8 @@
     "./scripts/mark-checklist-step.cjs": "./scripts/mark-checklist-step.cjs",
     "./scripts/checklist-target.cjs": "./scripts/checklist-target.cjs",
     "./scripts/worker-terminal-contract.cjs": "./scripts/worker-terminal-contract.cjs",
-    "./scripts/check-task-artifact-contract.mjs": "./scripts/check-task-artifact-contract.mjs"
+    "./scripts/check-task-artifact-contract.mjs": "./scripts/check-task-artifact-contract.mjs",
+    "./scripts/execution-template-cli.mjs": "./scripts/execution-template-cli.mjs"
   },
   "scripts": {
     "typecheck": "yarn workspace @farmslot/protocol build && tsc --noEmit --project tsconfig.json",
@@ -31,7 +32,7 @@
     "prepublishOnly": "node ../../scripts/quality/check-farmslot-package-readiness.mjs --publish --packages @farmslot/agent-runtime"
   },
   "dependencies": {
-    "@farmslot/protocol": "0.12.0"
+    "@farmslot/protocol": "0.15.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

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

@@ -166,6 +166,12 @@ function isStringArray(value) {
   return Array.isArray(value) && value.every((entry) => typeof entry === 'string');
 }
 
+function isNonEmptyStringArray(value) {
+  return (
+    isStringArray(value) && value.length > 0 && value.every((entry) => entry.trim().length > 0)
+  );
+}
+
 function isRecipeQualityArtifactFallback(value) {
   if (!isRecord(value)) return false;
   if (value.version !== 1) return false;
@@ -289,8 +295,9 @@ function addRef(refs, value) {
 }
 
 function validateRecipeQualityArtifact() {
-  const text = readText('artifacts/recipe-quality.json');
-  if (!text) return;
+  const relPath = 'artifacts/recipe-quality.json';
+  if (!fileExists(relPath)) return;
+  const text = readText(relPath) ?? '';
   let artifact;
   try {
     artifact = JSON.parse(text);
@@ -325,6 +332,7 @@ function validateRecipeDocumentArtifact() {
     `${packageRoot}/artifact-manifest.json`,
     'recipe-run/artifact-manifest.json',
   );
+  const summary = readJsonArtifact(`${packageRoot}/summary.json`, 'recipe-run/summary.json');
   const trace = readJsonArtifact(`${packageRoot}/trace.json`, 'recipe-run/trace.json');
   const recipeResolution = readJsonArtifact(
     `${packageRoot}/recipe-resolution.json`,
@@ -349,6 +357,7 @@ function validateRecipeDocumentArtifact() {
   const result = sharedRecipeArtifactPackageValidator({
     recipe,
     manifest,
+    summary,
     trace,
     recipeResolution,
     resolvedRecipes,
@@ -379,8 +388,8 @@ function resolvedRecipeArtifactPath(digest) {
 }
 
 function readJsonArtifact(relPath, label) {
-  const text = readText(relPath);
-  if (!text) return undefined;
+  if (!fileExists(relPath)) return undefined;
+  const text = readText(relPath) ?? '';
   try {
     return JSON.parse(text);
   } catch (error) {
@@ -459,8 +468,9 @@ function listArtifactPaths(root) {
 }
 
 function parseManifest() {
-  const text = readText('artifacts/evidence-manifest.json');
-  if (!text) return null;
+  const relPath = 'artifacts/evidence-manifest.json';
+  if (!fileExists(relPath)) return null;
+  const text = readText(relPath) ?? '';
   let manifest;
   try {
     manifest = JSON.parse(text);
@@ -570,32 +580,97 @@ function parseManifest() {
   return { manifest, refs };
 }
 
+let terminalContract;
+if (contractPath && terminalCommand && existsSync(contractPath)) {
+  try {
+    terminalContract = JSON.parse(readFileSync(contractPath, 'utf8'));
+  } catch (error) {
+    issues.push(`${contractPath}: invalid worker terminal contract JSON (${error.message})`);
+  }
+}
+const isSelfReviewTerminal = terminalContract?.flowType === 'self-review';
 const hasRecipe = fileExists('artifacts/recipe.json');
-validateRecipeDocumentArtifact();
-if (
-  hasRecipe &&
-  flags.has('--require-recipe-quality-if-recipe') &&
-  !fileExists('artifacts/recipe-quality.json')
-) {
-  issues.push('recipe.json exists but artifacts/recipe-quality.json is missing');
-}
-if (
-  hasRecipe &&
-  flags.has('--require-recipe-coverage-if-recipe') &&
-  !fileExists('artifacts/recipe-coverage.md')
-) {
-  issues.push('recipe.json exists but artifacts/recipe-coverage.md is missing');
-}
-validateRecipeQualityArtifact();
-
-const parsed = parseManifest();
-const coverage = readText('artifacts/recipe-coverage.md');
-if (coverage && /\|\s*(visual|mixed)\s*\|/i.test(coverage)) {
-  const refCount = parsed?.refs?.size ?? 0;
-  if (refCount === 0)
-    issues.push(
-      'recipe-coverage.md declares visual/mixed proof but evidence-manifest has no media references',
-    );
+
+// A reviewer must be able to report ISSUES when worker-owned proof is invalid.
+// Its terminal gate validates only the reviewer-owned feedback artifact below;
+// contribution and fix flows still validate the complete proof package.
+if (!isSelfReviewTerminal) {
+  const hasRecipeDecision = fileExists('artifacts/recipe-decision.json');
+  const recipeDecisionText = readText('artifacts/recipe-decision.json');
+  if (hasRecipeDecision) {
+    try {
+      const decision = JSON.parse(recipeDecisionText);
+      if (!isRecord(decision)) {
+        issues.push('artifacts/recipe-decision.json: expected object');
+      } else {
+        if (decision.version !== 1) {
+          issues.push('artifacts/recipe-decision.json.version: expected 1');
+        }
+        if (typeof decision.required !== 'boolean') {
+          issues.push('artifacts/recipe-decision.json.required: expected boolean');
+        }
+        if (typeof decision.reason !== 'string' || !decision.reason.trim()) {
+          issues.push('artifacts/recipe-decision.json.reason: expected non-empty string');
+        }
+        if (!isNonEmptyStringArray(decision.actionsChecked)) {
+          issues.push(
+            'artifacts/recipe-decision.json.actionsChecked: expected non-empty string array',
+          );
+        }
+        if (!isNonEmptyStringArray(decision.claims)) {
+          issues.push('artifacts/recipe-decision.json.claims: expected non-empty string array');
+        }
+        if (decision.recipePath !== undefined && decision.recipePath !== 'artifacts/recipe.json') {
+          issues.push(
+            'artifacts/recipe-decision.json.recipePath: expected artifacts/recipe.json when set',
+          );
+        }
+        if (decision.required === true && !hasRecipe) {
+          issues.push(
+            'artifacts/recipe-decision.json requires a recipe but artifacts/recipe.json is missing',
+          );
+        }
+        if (decision.required === false && hasRecipe) {
+          issues.push(
+            'artifacts/recipe-decision.json says recipe is not required but artifacts/recipe.json exists',
+          );
+        }
+        if (decision.required === true && decision.recipePath !== 'artifacts/recipe.json') {
+          issues.push(
+            'artifacts/recipe-decision.json.recipePath: required recipes must declare artifacts/recipe.json',
+          );
+        }
+      }
+    } catch (error) {
+      issues.push(`artifacts/recipe-decision.json: invalid JSON (${error.message})`);
+    }
+  }
+  validateRecipeDocumentArtifact();
+  if (
+    hasRecipe &&
+    flags.has('--require-recipe-quality-if-recipe') &&
+    !fileExists('artifacts/recipe-quality.json')
+  ) {
+    issues.push('recipe.json exists but artifacts/recipe-quality.json is missing');
+  }
+  if (
+    hasRecipe &&
+    flags.has('--require-recipe-coverage-if-recipe') &&
+    !fileExists('artifacts/recipe-coverage.md')
+  ) {
+    issues.push('recipe.json exists but artifacts/recipe-coverage.md is missing');
+  }
+  validateRecipeQualityArtifact();
+
+  const parsed = parseManifest();
+  const coverage = readText('artifacts/recipe-coverage.md');
+  if (coverage && /\|\s*(visual|mixed)\s*\|/i.test(coverage)) {
+    const refCount = parsed?.refs?.size ?? 0;
+    if (refCount === 0)
+      issues.push(
+        'recipe-coverage.md declares visual/mixed proof but evidence-manifest has no media references',
+      );
+  }
 }
 
 if (flags.has('--require-learnings')) {
@@ -605,8 +680,12 @@ if (flags.has('--require-learnings')) {
   }
 }
 
-if (contractPath && existsSync(contractPath) && terminalCommand) {
-  const contract = JSON.parse(readFileSync(contractPath, 'utf8'));
+if (contractPath && terminalCommand && !existsSync(contractPath)) {
+  issues.push(`${contractPath}: explicit worker terminal contract missing`);
+} else if (terminalContract && terminalCommand) {
+  const contract = isSelfReviewTerminal
+    ? { ...terminalContract, whenPresent: [] }
+    : terminalContract;
   const expanded = expandedArtifactsForCommand(contract, terminalCommand, fileExists);
   for (const artifactPath of expanded.artifacts) {
     if (flags.has('--skip-learnings') && artifactPath === 'artifacts/learnings.md') continue;

package/scripts/checklist-target.cjs

@@ -12,6 +12,7 @@ const ROLE_SIGNAL_SUFFIX = '-SIGNAL.json';
 const SELF_REVIEW_CHECKLIST = 'SELF-REVIEW.md';
 const SELF_REVIEW_FIX_CHECKLIST = 'SELF-REVIEW-FIX.md';
 const CI_FIX_CHECKLIST = 'CI-FIX.md';
+const WORKER_TERMINAL_CONTRACT_INPUT = path.join('inputs', 'worker-terminal-contract.json');
 
 function signalFileForChecklist(checklistBasename) {
   if (
@@ -36,6 +37,17 @@ function targetForChecklistBasename(checklistBasename) {
   };
 }
 
+function terminalContractInputForChecklist(checklistBasename) {
+  if (
+    checklistBasename === TASK_PROGRESS_MARKDOWN ||
+    checklistBasename === INTERACTIVE_CHECKLIST_MARKDOWN
+  ) {
+    return WORKER_TERMINAL_CONTRACT_INPUT;
+  }
+  const base = checklistBasename.replace(/\.md$/i, '');
+  return path.join('inputs', `worker-terminal-contract.${base}.json`);
+}
+
 function defaultWorkerTarget(taskDir) {
   const checklist = fs.existsSync(path.join(taskDir, INTERACTIVE_CHECKLIST_MARKDOWN))
     ? INTERACTIVE_CHECKLIST_MARKDOWN
@@ -201,6 +213,7 @@ module.exports = {
   taskDirRelPath,
   signalFileForChecklist,
   targetForChecklistBasename,
+  terminalContractInputForChecklist,
   defaultWorkerTarget,
   manifestModeTeachingError,
   readManifest,