@farmslot/agent-runtime 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## Unreleased
 
+## 0.3.0 - 2026-07-24
+
+- Fail artifact validation when the installed protocol rejects the canonical Recipe v1 envelope.
+
+- **BREAKING:** Task artifact checks require Recipe v1 resolution metadata and exact reachable dependency documents.
+- security: resolved dependency reads use digest-derived paths only.
+- Validate authored recipes separately from their executed `artifacts/recipe-run` package.
+
+- fix: worker-template lint now fails templates that omit `./mark` entirely when the resolved contract requires a terminal signal — previously such templates were skipped and produced no author-time issue (mark-less templates stay valid for `requireSignal: false` flows such as interactive pr-complete).
+- fix: builtin `self-review` / `self-review-fix` contracts require the reviewer artifacts the templates actually produce (`artifacts/review-feedback.md` / `artifacts/report.md`) instead of `artifacts/learnings.md`, and the runtime flow-report mapping + heading inference cover both flows — unbreaks `yarn quality:worker-templates`, which was failing on main.
+- fix: recognize CI-fix worker headings as the `ci-fix` flow and lint task-dir `mark --checklist ...` terminal commands, so `CI-FIX-SIGNAL.json` uses the intended report contract.
+- build: declare `tsx` as a devDependency — the execution-template tests run through the workspace-scoped `run-tsx-tests.mjs` runner (`yarn exec tsx`), which cannot resolve an undeclared binary on a clean CI install.
+- feat: add shared Markdown execution-template resolver/lint/new (ADR-049) with `farmslot-agent execution-template` CLI.
+- refactor: rename the branch-maintenance flow `merge-main` → `update-branch` in the worker terminal contract, checklist marker, and task artifact contract.
 - Active-development baseline; add user-facing changes here before release or package publication.
 
 ## 0.2.0 - 2026-07-12

package/bin/farmslot-agent.mjs

@@ -19,6 +19,7 @@ function usage(exitCode = 0) {
     '  recipe-quality build [--input input.json] [--output artifacts/recipe-quality.json]',
     '    (flags override top-level input fields; training fields are merged)',
     '  contract resolve --flow <flow> [--project-config path] [--mode mode]',
+    '  execution-template <list|lint|new> [options]',
   ].join('\n');
   (exitCode === 0 ? console.log : console.error)(text);
   process.exit(exitCode);
@@ -470,6 +471,11 @@ async function main() {
     resolveContract(rest);
   } else if (command === 'recipe-quality' && subcommand === 'build') {
     await buildRecipeQuality(rest);
+  } else if (command === 'execution-template') {
+    runNode(
+      path.join(packageRoot, 'scripts', 'execution-template-cli.mjs'),
+      [subcommand, ...rest].filter((arg) => arg !== undefined),
+    );
   } else {
     usage(2);
   }

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

@@ -0,0 +1,7 @@
+import type { CreateExecutionTemplateOptions } from './types.js';
+/** Create a starter Markdown execution template with minimal optional frontmatter. */
+export declare function createExecutionTemplate(options: CreateExecutionTemplateOptions): {
+    path: string;
+    created: boolean;
+};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/execution-template/create.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,8BAA8B,EAAoB,MAAM,YAAY,CAAC;AAgCnF,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB,CAoDA"}

package/dist/execution-template/create.js

@@ -0,0 +1,63 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { inferFlowFromPath, inferRunModeFromBasename } from './infer.js';
+import { lintExecutionTemplateText } from './lint.js';
+function defaultTitle(flow, runMode) {
+    const modeLabel = runMode ? ` (${runMode})` : '';
+    return `${flow} execution template${modeLabel}`;
+}
+function renderTemplate(input) {
+    const meta = [];
+    if (input.runMode)
+        meta.push(`runMode: ${input.runMode}`);
+    if (input.platforms.length > 0 && !(input.platforms.length === 1 && input.platforms[0] === '*')) {
+        meta.push(`platforms: [${input.platforms.join(', ')}]`);
+    }
+    // No metadata → no frontmatter block: an empty fence pair is pointless and
+    // easy for permissive parsers to misread as an unterminated block.
+    const lines = meta.length > 0 ? ['---', ...meta, '---', ''] : [];
+    lines.push(`# ${input.title}`, '', 'Checklist:', '');
+    lines.push('- [ ] Read the task prompt and confirm acceptance criteria.', '- [ ] Implement the smallest correct change.', '- [ ] Run focused validation and attach evidence under `artifacts/`.', '- [ ] Mark the task complete, blocked, or no-change.', '');
+    return `${lines.join('\n')}\n`;
+}
+/** Create a starter Markdown execution template with minimal optional frontmatter. */
+export function createExecutionTemplate(options) {
+    const absolute = path.resolve(options.path);
+    if (existsSync(absolute) && !options.force) {
+        throw new Error(`refusing to overwrite existing file: ${absolute} (pass force: true)`);
+    }
+    const basename = path.basename(absolute);
+    if (!basename.endsWith('.md')) {
+        throw new Error('template path must end with .md');
+    }
+    // Resolve and cross-check flow BEFORE anything touches the filesystem: the
+    // catalog derives flow from the filename, so a --flow that the filename does
+    // not encode (or contradicts) would create a template that resolves as a
+    // different flow than requested.
+    const fileFlow = inferFlowFromPath(absolute);
+    const flow = options.flow ?? fileFlow;
+    if (!flow) {
+        throw new Error('could not infer flow from the path; use a flow-prefixed filename (dev-autonomous.mobile.md) or a flow directory (fix-bug/core.md)');
+    }
+    if (options.flow && fileFlow && options.flow !== fileFlow) {
+        throw new Error(`requested flow '${options.flow}' contradicts the path's flow '${fileFlow}'; rename the file or drop --flow`);
+    }
+    if (options.flow && !fileFlow) {
+        throw new Error(`the path must encode the flow ('${options.flow}') for the catalog to resolve it — flow-prefixed filename or a ${options.flow}/ directory`);
+    }
+    const runMode = options.runMode ?? inferRunModeFromBasename(basename);
+    const platforms = options.platforms ?? ['*'];
+    const title = options.title ?? defaultTitle(flow, runMode);
+    const body = renderTemplate({ flow, runMode, platforms, title });
+    // Lint the rendered TEXT before writing — a failed creation must leave no
+    // file behind (and must never destroy an existing file via force).
+    const issues = lintExecutionTemplateText(absolute, body).filter((issue) => issue.severity === 'error');
+    if (issues.length > 0) {
+        const detail = issues.map((issue) => issue.message).join('; ');
+        throw new Error(`template would fail lint: ${detail}`);
+    }
+    mkdirSync(path.dirname(absolute), { recursive: true });
+    writeFileSync(absolute, body, 'utf8');
+    return { path: absolute, created: true };
+}
+//# sourceMappingURL=create.js.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execution-template.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution-template.test.d.ts","sourceRoot":"","sources":["../../src/execution-template/execution-template.test.ts"],"names":[],"mappings":""}

package/dist/execution-template/execution-template.test.js

@@ -0,0 +1,340 @@
+import assert from 'node:assert/strict';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import test from 'node:test';
+import { createExecutionTemplate } from './create.js';
+import { parseMarkdownDocument } from './frontmatter.js';
+import { catalogRelativeId, inferFlowFromBasename, inferRunModeFromBasename, inferTemplateMetadata, } from './infer.js';
+import { lintExecutionTemplates, lintExecutionTemplateText } from './lint.js';
+import { customTemplateSource, listExecutionTemplates, packageFlowTreeTemplateSource, projectWorkerTemplateSource, } from './resolve.js';
+function withTemp(fn) {
+    const root = mkdtempSync(join(tmpdir(), 'farmslot-exec-tpl-'));
+    try {
+        fn(root);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+}
+test('inferFlowFromBasename uses longest Farmslot flow prefix', () => {
+    assert.equal(inferFlowFromBasename('fix-bug-autonomous.mobile.md'), 'fix-bug');
+    assert.equal(inferFlowFromBasename('pr-complete-interactive.md'), 'pr-complete');
+    assert.equal(inferFlowFromBasename('dev.md'), 'dev');
+    assert.equal(inferFlowFromBasename('review-pr.md'), 'review-pr');
+    assert.equal(inferFlowFromBasename('notes.md'), null);
+});
+test('inferRunModeFromBasename resolves only explicit mode tokens', () => {
+    // A bare flow name encodes no mode — review-pr/update-branch run interactive
+    // as often as autonomous, so nothing may default here.
+    assert.equal(inferRunModeFromBasename('dev.md'), null);
+    assert.equal(inferRunModeFromBasename('review-pr.md'), null);
+    assert.equal(inferRunModeFromBasename('dev-interactive.md'), 'interactive');
+    assert.equal(inferRunModeFromBasename('dev-autonomous.mobile.md'), 'autonomous');
+    assert.equal(inferRunModeFromBasename('fix-bug-interactive.extension.md'), 'interactive');
+});
+test('self-review-fix resolves as its own prefix, not self-review', () => {
+    assert.equal(inferFlowFromBasename('self-review-fix.md'), 'self-review-fix');
+    assert.equal(inferFlowFromBasename('self-review.md'), 'self-review');
+});
+test('catalog ids collide across worker-flat and flow-tree layouts', () => {
+    // Precedence/shadowing is keyed on id — a project worker-flat override and a
+    // package flow-tree base MUST normalize to the same id.
+    assert.equal(catalogRelativeId('fix-bug.core.md', 'worker-flat'), 'fix-bug/core');
+    assert.equal(catalogRelativeId('fix-bug/core.md', 'flow-tree'), 'fix-bug/core');
+    assert.equal(catalogRelativeId('dev.md', 'worker-flat'), 'dev/default');
+    assert.equal(catalogRelativeId('dev-interactive.md', 'worker-flat'), 'dev/interactive');
+    assert.equal(catalogRelativeId('notes.md', 'worker-flat'), 'notes');
+});
+test('inferTemplateMetadata prefers frontmatter then filename/heading', () => {
+    const meta = inferTemplateMetadata({
+        absolutePath: '/tmp/dev-autonomous.mobile.md',
+        relativePath: 'dev/dev-autonomous.mobile.md',
+        source: {
+            id: 'package:recipe-cook',
+            kind: 'package',
+            root: '/tmp',
+            layout: 'flow-tree',
+        },
+        text: `---
+id: custom-dev-mobile
+title: Custom Dev
+runMode: autonomous
+platforms: [mobile]
+version: 2
+---
+
+# Ignored heading
+
+- [ ] Do the work
+`,
+    });
+    assert.equal(meta.id, 'custom-dev-mobile');
+    assert.equal(meta.title, 'Custom Dev');
+    assert.equal(meta.flow, 'dev');
+    assert.equal(meta.version, '2');
+    assert.equal(meta.runMode, 'autonomous');
+    assert.deepEqual(meta.platforms, ['mobile']);
+});
+test('listExecutionTemplates reports shadowing across project and package sources', () => {
+    withTemp((root) => {
+        const projectWorker = join(root, 'project', 'templates', 'worker');
+        const packageTpl = join(root, 'skills', 'templates');
+        mkdirSync(projectWorker, { recursive: true });
+        mkdirSync(join(packageTpl, 'dev'), { recursive: true });
+        writeFileSync(join(projectWorker, 'dev.md'), '# Legacy Dev\n\n- [ ] Farm step\n', 'utf8');
+        // Same explicit id as legacy mapping would not collide; create a colliding id via frontmatter.
+        writeFileSync(join(packageTpl, 'dev', 'dev-autonomous.mobile.md'), `---
+id: dev/default
+runMode: autonomous
+platforms: [mobile]
+---
+
+# Shared Dev
+
+- [ ] Shared step
+`, 'utf8');
+        const entries = listExecutionTemplates({
+            sources: [
+                projectWorkerTemplateSource('metamask-mobile-farm', join(root, 'project', 'templates')),
+                packageFlowTreeTemplateSource('recipe-cook', packageTpl),
+            ],
+            includeShadowed: true,
+        });
+        const winners = entries.filter((e) => !e.shadowedBy && e.id === 'dev/default');
+        const shadowed = entries.filter((e) => e.shadowedBy && e.id === 'dev/default');
+        assert.equal(winners.length, 1);
+        assert.equal(winners[0]?.sourceKind, 'project');
+        assert.equal(shadowed.length, 1);
+        assert.equal(shadowed[0]?.sourceKind, 'package');
+        assert.equal(shadowed[0]?.shadowedBy, 'project:metamask-mobile-farm');
+    });
+});
+test('lintExecutionTemplates accepts valid checkboxes and rejects fix-ticket / bad boxes', () => {
+    withTemp((root) => {
+        const ok = join(root, 'dev-autonomous.mobile.md');
+        writeFileSync(ok, '# Ok\n\n- [ ] one\n- [x] two\n', 'utf8');
+        const okResult = lintExecutionTemplates(ok);
+        assert.equal(okResult.ok, true);
+        const bad = join(root, 'dev-bad.md');
+        writeFileSync(bad, '# Bad\n\n- [?] broken\nfix-ticket leftover\n', 'utf8');
+        const badResult = lintExecutionTemplates(bad);
+        assert.equal(badResult.ok, false);
+        assert.ok(badResult.issues.some((i) => /fix-ticket/.test(i.message)));
+        assert.ok(badResult.issues.some((i) => /checkbox/.test(i.message)));
+    });
+});
+test('createExecutionTemplate writes lint-clean starter with optional frontmatter', () => {
+    withTemp((root) => {
+        const target = join(root, 'dev', 'dev-autonomous.mobile.md');
+        const created = createExecutionTemplate({
+            path: target,
+            runMode: 'autonomous',
+            platforms: ['mobile'],
+        });
+        assert.equal(created.created, true);
+        const text = readFileSync(target, 'utf8');
+        assert.match(text, /runMode: autonomous/);
+        assert.match(text, /platforms: \[mobile\]/);
+        assert.match(text, /- \[ \] Read the task prompt/);
+        assert.equal(lintExecutionTemplates(target).ok, true);
+    });
+});
+test('custom source outranks package source for the same id', () => {
+    withTemp((root) => {
+        const custom = join(root, 'custom');
+        const pkg = join(root, 'pkg');
+        mkdirSync(join(custom, 'dev'), { recursive: true });
+        mkdirSync(join(pkg, 'dev'), { recursive: true });
+        const body = (label) => `---\nid: shared-dev\n---\n\n# ${label}\n\n- [ ] step\n`;
+        writeFileSync(join(custom, 'dev', 'dev-autonomous.mobile.md'), body('custom'), 'utf8');
+        writeFileSync(join(pkg, 'dev', 'dev-autonomous.mobile.md'), body('package'), 'utf8');
+        const entries = listExecutionTemplates({
+            sources: [
+                packageFlowTreeTemplateSource('recipe-cook', pkg),
+                customTemplateSource('overlay', custom),
+            ],
+        });
+        const winner = entries.find((e) => e.id === 'shared-dev' && !e.shadowedBy);
+        assert.equal(winner?.sourceKind, 'custom');
+        assert.equal(winner?.title, 'custom');
+    });
+});
+test('shadowing resolves before filters — a filtered winner still shadows its duplicate', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'et-filter-'));
+    try {
+        mkdirSync(join(dir, 'proj', 'worker'), { recursive: true });
+        mkdirSync(join(dir, 'pkg', 'dev'), { recursive: true });
+        // Project winner is mobile-only; package duplicate claims extension.
+        writeFileSync(join(dir, 'proj', 'worker', 'dev.md'), '---\nplatforms: [mobile]\n---\n\n# P\n\n- [ ] step\n');
+        writeFileSync(join(dir, 'pkg', 'dev', 'default.md'), '---\nplatforms: [extension]\n---\n\n# S\n\n- [ ] step\n');
+        const entries = listExecutionTemplates({
+            sources: [
+                projectWorkerTemplateSource('p', join(dir, 'proj')),
+                packageFlowTreeTemplateSource('s', join(dir, 'pkg')),
+            ],
+            platform: 'extension',
+        });
+        // The package copy is shadowed by the (filtered-out) project winner — the
+        // filter must not resurrect it as effective.
+        const effective = entries.filter((e) => !e.shadowedBy);
+        assert.equal(effective.length, 0);
+        const shadowedEntry = entries.find((e) => e.shadowedBy);
+        assert.equal(shadowedEntry?.sourceKind, 'package');
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('same-kind precedence follows caller order, not source-id alphabet', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'et-order-'));
+    try {
+        mkdirSync(join(dir, 'zeta', 'dev'), { recursive: true });
+        mkdirSync(join(dir, 'alpha', 'dev'), { recursive: true });
+        writeFileSync(join(dir, 'zeta', 'dev', 'default.md'), '# Z\n\n- [ ] step\n');
+        writeFileSync(join(dir, 'alpha', 'dev', 'default.md'), '# A\n\n- [ ] step\n');
+        const entries = listExecutionTemplates({
+            sources: [
+                customTemplateSource('zeta', join(dir, 'zeta')),
+                customTemplateSource('alpha', join(dir, 'alpha')),
+            ],
+        });
+        const winner = entries.find((e) => e.id === 'dev/default' && !e.shadowedBy);
+        assert.equal(winner?.sourceId, 'custom:zeta');
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('create validates before writing: failure leaves no file and force never destroys', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'et-create-'));
+    try {
+        // Un-prefixed filename with explicit flow: rejected BEFORE write.
+        assert.throws(() => createExecutionTemplate({ path: join(dir, 'evil.md'), flow: 'dev' }), /path must encode the flow/);
+        assert.equal(existsSync(join(dir, 'evil.md')), false);
+        // Contradicting --flow: rejected before write.
+        assert.throws(() => createExecutionTemplate({ path: join(dir, 'dev.md'), flow: 'review-pr' }), /contradicts the path's flow/);
+        assert.equal(existsSync(join(dir, 'dev.md')), false);
+        // force on an invalid request must not destroy the existing file.
+        const keep = join(dir, 'fix-bug.md');
+        writeFileSync(keep, '# keep\n\n- [ ] precious\n');
+        assert.throws(() => createExecutionTemplate({ path: keep, flow: 'dev', force: true }), /contradicts the path's flow/);
+        assert.match(readFileSync(keep, 'utf8'), /precious/);
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('lint rejects traversal-like frontmatter ids and flow/filename contradictions', () => {
+    const bad = lintExecutionTemplateText('/virtual/dev.md', '---\nid: ../../escape\nflow: review-pr\n---\n\n# T\n\n- [ ] step\n');
+    assert.ok(bad.some((i) => /safe catalog id/.test(i.message)));
+    assert.ok(bad.some((i) => /contradicts the path's flow/.test(i.message)));
+});
+test('lint exempts interactive templates from the checkbox requirement', () => {
+    const interactive = lintExecutionTemplateText('/virtual/dev-interactive.md', '# Conversational template\n\nNo checklist by design.\n');
+    assert.equal(interactive.filter((i) => i.severity === 'error').length, 0);
+    const autonomous = lintExecutionTemplateText('/virtual/dev.md', '# Missing checklist\n\nprose only\n');
+    assert.ok(autonomous.some((i) => /no parseable checkbox/.test(i.message)));
+});
+test('lint flags unterminated frontmatter instead of silently treating it as body', () => {
+    const issues = lintExecutionTemplateText('/virtual/dev.md', '---\nrunMode: autonomous\n\n# Heading\n\n- [ ] step\n');
+    assert.ok(issues.some((i) => /unterminated frontmatter/.test(i.message)));
+});
+test('create with no metadata renders without a frontmatter block and round-trips through list', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'et-roundtrip-'));
+    try {
+        mkdirSync(join(dir, 'worker'), { recursive: true });
+        // Bare title: no runMode token in the filename, default platforms — the
+        // generated file must still lint clean and be discoverable.
+        createExecutionTemplate({ path: join(dir, 'worker', 'fix-bug.core.md'), title: 'Round trip' });
+        const text = readFileSync(join(dir, 'worker', 'fix-bug.core.md'), 'utf8');
+        assert.ok(!text.startsWith('---'), 'no empty frontmatter fence pair');
+        const entries = listExecutionTemplates({
+            sources: [projectWorkerTemplateSource('p', dir)],
+        });
+        const entry = entries.find((e) => e.id === 'fix-bug/core');
+        assert.equal(entry?.title, 'Round trip');
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('parser closes an empty frontmatter block', () => {
+    const parsed = parseMarkdownDocument('---\n---\n\n# T\n\n- [ ] step\n');
+    assert.notEqual(parsed.frontmatter, null);
+    assert.equal(parsed.heading, 'T');
+});
+test('flow-tree paths create and lint via the parent flow directory', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'et-flowtree-'));
+    try {
+        mkdirSync(join(dir, 'fix-bug'), { recursive: true });
+        // Basename has no flow prefix — the fix-bug/ directory carries it.
+        createExecutionTemplate({ path: join(dir, 'fix-bug', 'core.md'), title: 'Tree base' });
+        const issues = lintExecutionTemplates(join(dir, 'fix-bug', 'core.md'));
+        assert.equal(issues.ok, true);
+        const entries = listExecutionTemplates({
+            sources: [packageFlowTreeTemplateSource('s', dir)],
+        });
+        assert.equal(entries.find((e) => e.id === 'fix-bug/core')?.title, 'Tree base');
+        // A contradicting --flow still fails against the directory flow.
+        assert.throws(() => createExecutionTemplate({ path: join(dir, 'fix-bug', 'other.md'), flow: 'dev' }), /contradicts the path's flow/);
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('parent flow directory wins over a contradicting basename, and lint flags it', () => {
+    // fix-bug/dev.md must resolve as fix-bug everywhere (catalog parity)…
+    assert.equal(catalogRelativeId('fix-bug/dev.md', 'flow-tree'), 'fix-bug/dev');
+    const issues = lintExecutionTemplateText('/tmp/fix-bug/dev.md', '# T\n\n- [ ] step\n');
+    // …and the misleading name is an authoring error.
+    assert.ok(issues.some((i) => /contradicts the flow directory/.test(i.message)));
+});
+test('mode tokens are exact, not substrings', () => {
+    assert.equal(inferRunModeFromBasename('dev-interactively.md'), null);
+    assert.equal(inferRunModeFromBasename('dev-autonomousness.md'), null);
+});
+test('a line merely starting with --- is not a closing fence', () => {
+    const parsed = parseMarkdownDocument('---\nrunMode: autonomous\n---not-a-fence\n\n# T\n');
+    assert.equal(parsed.frontmatter, null);
+    const issues = lintExecutionTemplateText('/virtual/dev.md', '---\nrunMode: autonomous\n---not-a-fence\n\n# T\n\n- [ ] step\n');
+    assert.ok(issues.some((i) => /unterminated frontmatter/.test(i.message)));
+});
+test('directory lint flags files that canonicalize to the same catalog id', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'et-dup-'));
+    try {
+        writeFileSync(join(dir, 'dev-interactive.md'), '# A\n');
+        writeFileSync(join(dir, 'dev.interactive.md'), '# B\n');
+        const result = lintExecutionTemplates(dir);
+        assert.equal(result.ok, false);
+        assert.ok(result.issues.some((i) => /duplicate catalog id 'dev\/interactive'/.test(i.message)));
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('duplicate detection follows explicit frontmatter ids like the resolver', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'et-dup2-'));
+    try {
+        // Same explicit id in differently-named files: a real collision.
+        writeFileSync(join(dir, 'dev.md'), '---\nid: shared\n---\n\n# A\n\n- [ ] s\n');
+        writeFileSync(join(dir, 'fix-bug.md'), '---\nid: shared\n---\n\n# B\n\n- [ ] s\n');
+        const collision = lintExecutionTemplates(dir);
+        assert.ok(collision.issues.some((i) => /duplicate catalog id 'shared'/.test(i.message)));
+        rmSync(join(dir, 'dev.md'));
+        rmSync(join(dir, 'fix-bug.md'));
+        // Path-colliding names with DIFFERENT explicit ids: not a collision.
+        writeFileSync(join(dir, 'dev-interactive.md'), '---\nid: one\n---\n\n# A\n');
+        writeFileSync(join(dir, 'dev.interactive.md'), '---\nid: two\n---\n\n# B\n');
+        const distinct = lintExecutionTemplates(dir);
+        assert.ok(!distinct.issues.some((i) => /duplicate catalog id/.test(i.message)));
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('a bare CR does not terminate a frontmatter fence', () => {
+    const parsed = parseMarkdownDocument('---\nrunMode: autonomous\n---\rnot-a-fence\n\n# T\n');
+    assert.equal(parsed.frontmatter, null);
+});
+//# sourceMappingURL=execution-template.test.js.map

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

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

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

@@ -0,0 +1,16 @@
+import type { ExecutionRunMode, ExecutionTemplateFrontmatter } from './types.js';
+export interface ParsedMarkdownDocument {
+    frontmatter: ExecutionTemplateFrontmatter | null;
+    body: string;
+    heading: string | null;
+}
+/**
+ * Minimal frontmatter parser for optional execution-template metadata.
+ * Supports `key: value` and `key: [a, b]` only — no nested YAML documents.
+ */
+export declare function parseMarkdownDocument(text: string): ParsedMarkdownDocument;
+export declare function normalizeRunMode(value: unknown): ExecutionRunMode | null;
+export declare function normalizePlatforms(value: unknown): string[] | null;
+export declare function frontmatterRunMode(frontmatter: ExecutionTemplateFrontmatter | null): ExecutionRunMode | null;
+export declare function frontmatterPlatforms(frontmatter: ExecutionTemplateFrontmatter | null): string[] | null;
+//# sourceMappingURL=frontmatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/execution-template/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAIjF,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AA0BD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAgD1E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAIxE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAYlE;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,4BAA4B,GAAG,IAAI,GAC/C,gBAAgB,GAAG,IAAI,CAGzB;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,4BAA4B,GAAG,IAAI,GAC/C,MAAM,EAAE,GAAG,IAAI,CAGjB"}

package/dist/execution-template/frontmatter.js

@@ -0,0 +1,110 @@
+const RUN_MODES = new Set(['autonomous', 'interactive', 'validation']);
+function stripQuotes(value) {
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+function parseScalar(raw) {
+    const value = stripQuotes(raw.trim());
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (/^-?\d+(\.\d+)?$/.test(value))
+        return Number(value);
+    return value;
+}
+function parseInlineArray(raw) {
+    const inner = raw.trim().slice(1, -1).trim();
+    if (!inner)
+        return [];
+    return inner.split(',').map((part) => parseScalar(part.trim()));
+}
+/**
+ * Minimal frontmatter parser for optional execution-template metadata.
+ * Supports `key: value` and `key: [a, b]` only — no nested YAML documents.
+ */
+export function parseMarkdownDocument(text) {
+    const normalized = text.replace(/^\uFEFF/, '');
+    let frontmatter = null;
+    let body = normalized;
+    if (normalized.startsWith('---\n') || normalized.startsWith('---\r\n')) {
+        // The closing fence must be exactly `---` on its own line — a line that
+        // merely STARTS with --- (e.g. `---not-a-fence`) is content, and accepting
+        // it would defeat unterminated-frontmatter detection. Search from 3 (the
+        // opening fence's own newline) so an EMPTY block still closes.
+        let end = -1;
+        for (let from = 3;;) {
+            const candidate = normalized.indexOf('\n---', from);
+            if (candidate === -1)
+                break;
+            const after = normalized.slice(candidate + 4, candidate + 6);
+            // Only EOF, LF, or CRLF terminate the fence — a bare CR is not a line
+            // boundary anywhere else in this parser.
+            if (after === '' || after.startsWith('\n') || after === '\r\n' || after.startsWith('\r\n')) {
+                end = candidate;
+                break;
+            }
+            from = candidate + 1;
+        }
+        if (end !== -1) {
+            const fmBlock = normalized.slice(4, end).replace(/\r/g, '');
+            const rest = normalized.slice(end + '\n---'.length).replace(/^\r?\n/, '');
+            frontmatter = {};
+            for (const line of fmBlock.split('\n')) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith('#'))
+                    continue;
+                const colon = trimmed.indexOf(':');
+                if (colon <= 0)
+                    continue;
+                const key = trimmed.slice(0, colon).trim();
+                const rawValue = trimmed.slice(colon + 1).trim();
+                if (!key)
+                    continue;
+                const value = rawValue.startsWith('[') && rawValue.endsWith(']')
+                    ? parseInlineArray(rawValue)
+                    : parseScalar(rawValue);
+                frontmatter[key] = value;
+            }
+            body = rest;
+        }
+    }
+    const headingMatch = body.match(/^#\s+(.+)$/m);
+    const heading = headingMatch?.[1]?.trim() ?? null;
+    return { frontmatter, body, heading };
+}
+export function normalizeRunMode(value) {
+    if (typeof value !== 'string')
+        return null;
+    const normalized = value.trim().toLowerCase();
+    return RUN_MODES.has(normalized) ? normalized : null;
+}
+export function normalizePlatforms(value) {
+    if (value == null)
+        return null;
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed ? [trimmed] : null;
+    }
+    if (!Array.isArray(value))
+        return null;
+    const platforms = value
+        .filter((item) => typeof item === 'string')
+        .map((item) => item.trim())
+        .filter(Boolean);
+    return platforms.length > 0 ? platforms : null;
+}
+export function frontmatterRunMode(frontmatter) {
+    if (!frontmatter)
+        return null;
+    return normalizeRunMode(frontmatter.runMode ?? frontmatter.run_mode);
+}
+export function frontmatterPlatforms(frontmatter) {
+    if (!frontmatter)
+        return null;
+    return normalizePlatforms(frontmatter.platforms);
+}
+//# sourceMappingURL=frontmatter.js.map