@sanity/ailf 1.0.0 → 2.0.0

package/dist/pipeline/compiler/presets/sanity-literacy.js

@@ -1,24 +1,20 @@
 /**
- * sanity-literacy preset — the built-in documentation literacy evaluation.
+ * sanity-literacy preset — Sanity-specific domain configuration for literacy evaluation.
  *
- * Packages ALL Sanity-specific configuration into a single preset:
- * - Literacy mode handler registration
- * - Prompt templates (with-docs, without-docs, agentic)
- * - Rubric templates (task-completion, code-correctness, doc-coverage)
- * - Scoring profiles (default, output-only)
+ * This is a domain preset that targets the `literacy` mode base. It provides
+ * Sanity-specific configuration:
  * - Sanity doc source definitions (production, branch, local)
  * - Product feature registry for coverage auditing
  * - DocFetcher factory (SanityDocFetcher)
- * - Standard assertions and fixture resolvers
+ * - Sanity fixture resolver (sanity:// scheme)
  *
- * Use `createSanityLiteracyPreset()` to get a fully configured preset
- * with a docFetcher factory bound to a specific rootDir.
+ * Evaluation methodology (rubrics, scoring, prompts) is inherited from the
+ * `literacy` mode base — see mode-bases/literacy.ts.
  *
  * @see docs/exec-plans/architecture-overhaul/phase-8-scoring-storage-presets.md
  */
 import { env } from "../../../_vendor/ailf-core/index.js";
 import { SanityDocFetcher } from "../../../adapters/doc-fetchers/index.js";
-import { LITERACY_PROMPT_TEMPLATES } from "../mode-handlers/literacy-handler.js";
 // ---------------------------------------------------------------------------
 // Factory
 // ---------------------------------------------------------------------------
@@ -41,130 +37,10 @@ export function createSanityLiteracyPreset(options) {
                 "features correctly.",
             pluginApiVersion: 1,
         },
-        // ── Mode handler ─────────────────────────────────────────
-        modes: [
-            {
-                id: "literacy",
-                label: "Documentation Literacy",
-                validProviderPatterns: ["^openai:", "^anthropic:", "^file://"],
-                rubricTemplateIds: [
-                    "task-completion",
-                    "code-correctness",
-                    "doc-coverage",
-                ],
-                handlerModule: "./mode-handlers/literacy-handler.js",
-            },
-        ],
-        // ── Assertions ───────────────────────────────────────────
-        assertions: [
-            {
-                type: "contains",
-                label: "Contains text",
-                compatibleModes: ["literacy", "knowledge-probe", "mcp-server"],
-                handlerModule: "promptfoo:builtin",
-            },
-            {
-                type: "contains-all",
-                label: "Contains all texts",
-                compatibleModes: ["literacy", "knowledge-probe", "mcp-server"],
-                handlerModule: "promptfoo:builtin",
-            },
-            {
-                type: "contains-any",
-                label: "Contains any text",
-                compatibleModes: ["literacy", "knowledge-probe", "mcp-server"],
-                handlerModule: "promptfoo:builtin",
-            },
-            {
-                type: "equals",
-                label: "Exact match",
-                compatibleModes: ["literacy"],
-                handlerModule: "promptfoo:builtin",
-            },
-            {
-                type: "regex",
-                label: "Regex match",
-                compatibleModes: ["literacy", "knowledge-probe"],
-                handlerModule: "promptfoo:builtin",
-            },
-            {
-                type: "is-json",
-                label: "Valid JSON",
-                compatibleModes: ["literacy", "mcp-server"],
-                handlerModule: "promptfoo:builtin",
-            },
-            {
-                type: "javascript",
-                label: "JavaScript assertion",
-                compatibleModes: [
-                    "literacy",
-                    "mcp-server",
-                    "agent-harness",
-                    "knowledge-probe",
-                    "custom",
-                ],
-                handlerModule: "promptfoo:builtin",
-            },
-            {
-                type: "llm-rubric",
-                label: "LLM-graded rubric",
-                compatibleModes: [
-                    "literacy",
-                    "mcp-server",
-                    "agent-harness",
-                    "knowledge-probe",
-                    "custom",
-                ],
-                handlerModule: "promptfoo:builtin",
-            },
-            {
-                type: "similar",
-                label: "Semantic similarity",
-                compatibleModes: ["literacy", "knowledge-probe"],
-                handlerModule: "promptfoo:builtin",
-            },
-        ],
-        // ── Rubric templates ─────────────────────────────────────
-        rubricTemplates: [
-            {
-                id: "task-completion",
-                dimension: "task-completion",
-                header: "Score task completion from 0 to 100:",
-                scale: [
-                    "0: Couldn't attempt — missing critical information",
-                    "20: Attempted but fundamentally wrong approach",
-                    "50: Partial implementation — major functional gaps",
-                    "80: Mostly complete — minor issues or missing edge cases",
-                    "100: Fully functional code — works as expected",
-                ],
-                criteriaLabel: "Must demonstrate:",
-            },
-            {
-                id: "code-correctness",
-                dimension: "code-correctness",
-                header: "Score code correctness from 0 to 100:",
-                scale: [
-                    "0: Broken code, syntax errors, or deprecated APIs",
-                    "30: Works but uses anti-patterns or inefficient approaches",
-                    "50: Works but not idiomatic",
-                    "80: Follows most best practices",
-                    "100: Follows all best practices, idiomatic implementation",
-                ],
-                criteriaLabel: "Check for:",
-            },
-            {
-                id: "doc-coverage",
-                dimension: "doc-coverage",
-                header: "Score documentation coverage from 0 to 100:",
-                scale: [
-                    "0: Had to hallucinate/guess most implementation details",
-                    "30: Significant gaps — filled with assumptions",
-                    "50: Some gaps — inferred from partial information",
-                    "80: Minor gaps — almost everything was documented",
-                    "100: Complete coverage — all necessary info was in docs",
-                ],
-            },
-        ],
+        // ── Mode ──────────────────────────────────────────────────
+        // Targets the literacy mode base. Evaluation methodology (rubrics,
+        // scoring, prompts) is inherited from mode-bases/literacy.ts.
+        mode: "literacy",
         // ── Fixture resolvers ────────────────────────────────────
         fixtureResolvers: [
             {
@@ -172,22 +48,6 @@ export function createSanityLiteracyPreset(options) {
                 handlerModule: "./fixture-resolver.js",
             },
         ],
-        // ── Prompt templates (from literacy handler) ─────────────
-        promptTemplates: LITERACY_PROMPT_TEMPLATES,
-        // ── Scoring profiles ─────────────────────────────────────
-        // Literacy-relevant profiles only; mode-specific profiles for
-        // mcp-server, knowledge-probe, etc. belong in their own presets.
-        scoringProfiles: {
-            default: {
-                "task-completion": 0.5,
-                "code-correctness": 0.25,
-                "doc-coverage": 0.25,
-            },
-            "output-only": {
-                "task-completion": 0.6,
-                "code-correctness": 0.4,
-            },
-        },
         // ── Doc fetcher factory ──────────────────────────────────
         // Closure captures rootDir so the registry can instantiate
         // the fetcher without knowing about Sanity internals.
@@ -227,7 +87,6 @@ export function createSanityLiteracyPreset(options) {
                     status: "covered",
                     area: "groq",
                     priority: "critical",
-                    taskCount: 3,
                 },
                 {
                     id: "visual-editing",
@@ -236,7 +95,6 @@ export function createSanityLiteracyPreset(options) {
                     status: "covered",
                     area: "visual-editing",
                     priority: "critical",
-                    taskCount: 1,
                 },
                 {
                     id: "nextjs-live",
@@ -245,7 +103,6 @@ export function createSanityLiteracyPreset(options) {
                     status: "covered",
                     area: "nextjs-live",
                     priority: "high",
-                    taskCount: 2,
                 },
                 {
                     id: "functions",
@@ -254,7 +111,6 @@ export function createSanityLiteracyPreset(options) {
                     status: "covered",
                     area: "functions",
                     priority: "high",
-                    taskCount: 2,
                 },
                 {
                     id: "studio-setup",
@@ -263,7 +119,6 @@ export function createSanityLiteracyPreset(options) {
                     status: "covered",
                     area: "studio-setup",
                     priority: "high",
-                    taskCount: 1,
                 },
                 {
                     id: "frameworks",
@@ -272,7 +127,6 @@ export function createSanityLiteracyPreset(options) {
                     status: "covered",
                     area: "frameworks",
                     priority: "high",
-                    taskCount: 2,
                 },
                 // Uncovered (no evaluation tasks yet)
                 {

package/dist/pipeline/expand-tasks.d.ts

@@ -4,9 +4,9 @@
  * @deprecated This is part of the LEGACY compilation path. New code should
  * use the literacy handler in the compiler pipeline instead:
  *
- *   import { compileLiteracyTask } from "./compiler/mode-handlers/literacy-handler.js"
+ *   import { compileLiteracyTask } from "./compiler/mode-handlers/literacy/index.js"
  *
- * @see packages/eval/src/pipeline/compiler/mode-handlers/literacy-handler.ts
+ * @see packages/eval/src/pipeline/compiler/mode-handlers/literacy/index.ts
  *
  * ---
  *

package/dist/pipeline/expand-tasks.js

@@ -4,9 +4,9 @@
  * @deprecated This is part of the LEGACY compilation path. New code should
  * use the literacy handler in the compiler pipeline instead:
  *
- *   import { compileLiteracyTask } from "./compiler/mode-handlers/literacy-handler.js"
+ *   import { compileLiteracyTask } from "./compiler/mode-handlers/literacy/index.js"
  *
- * @see packages/eval/src/pipeline/compiler/mode-handlers/literacy-handler.ts
+ * @see packages/eval/src/pipeline/compiler/mode-handlers/literacy/index.ts
  *
  * ---
  *

package/dist/pipeline/generate-configs.js

@@ -39,7 +39,7 @@ import { resolve } from "path";
 import { dump } from "js-yaml";
 import { ConsoleLogger } from "../adapters/loggers/index.js";
 import { loadConfigFile } from "./compiler/config-loader.js";
-import { LITERACY_PROMPT_TEMPLATES } from "./compiler/mode-handlers/literacy-handler.js";
+import { LITERACY_PROMPT_TEMPLATES } from "./compiler/mode-handlers/literacy/index.js";
 import { expandTaskDefinitions, loadAndExpandTasks } from "./expand-tasks.js";
 import { validateModelsYaml } from "./validate.js";
 import { LiteracyVariant } from "./normalize-mode.js";

package/dist/pipeline/map-request-to-config.js

@@ -68,6 +68,7 @@ export function mapRequestToConfig(request, rootDir) {
         jobId: request.jobId,
         remote: false,
         apiUrl: "https://ailf-api.sanity.build",
+        presets: request.presets,
     };
 }
 function mapDebug(debug) {

package/dist/pipeline/mirror-repo-tasks.d.ts

@@ -58,7 +58,7 @@ export interface MirrorResult {
     skipped: number;
     /** Feature areas auto-created */
     areasCreated: string[];
-    /** Canonical doc slugs that failed to resolve */
+    /** Context doc slugs that failed to resolve */
     unresolvedSlugs: string[];
     /** Errors (non-fatal — mirror continues) */
     errors: string[];
@@ -70,7 +70,7 @@ export interface MirrorResult {
  * 1. Compute deterministic document ID
  * 2. Compute content hash of the task definition
  * 3. Check if mirror document exists with same hash → skip if unchanged
- * 4. Resolve canonical doc slugs → Sanity references
+ * 4. Resolve context doc slugs → Sanity references
  * 5. Auto-create feature areas if needed
  * 6. Upsert the ailf.task document with origin block
  */
@@ -114,8 +114,8 @@ export declare function buildMirrorDocument(task: LiteracyTaskDefinition, opts:
     _type: string;
     ownership: string;
     status: import("@sanity/ailf-core").TaskStatus;
-    assert: Record<string, unknown>[];
-    canonicalDocs: ({
+    assertions: Record<string, unknown>[];
+    contextDocs: ({
         _key: string;
         reason: string;
     } | {
@@ -138,9 +138,9 @@ export declare function buildMirrorDocument(task: LiteracyTaskDefinition, opts:
         _key: string;
         reason: string;
     })[];
-    description: string;
+    title: string;
     docCoverage: boolean;
-    featureArea: {
+    area: {
         _ref: string;
         _type: string;
     };
@@ -161,5 +161,5 @@ export declare function buildMirrorDocument(task: LiteracyTaskDefinition, opts:
         author: GitAuthor;
         lastEditor: GitAuthor;
     };
-    taskPrompt: string;
+    promptText: string;
 };

package/dist/pipeline/mirror-repo-tasks.js

@@ -26,7 +26,7 @@ import { ConsoleLogger } from "../adapters/loggers/index.js";
  * 1. Compute deterministic document ID
  * 2. Compute content hash of the task definition
  * 3. Check if mirror document exists with same hash → skip if unchanged
- * 4. Resolve canonical doc slugs → Sanity references
+ * 4. Resolve context doc slugs → Sanity references
  * 5. Auto-create feature areas if needed
  * 6. Upsert the ailf.task document with origin block
  */
@@ -43,7 +43,7 @@ export async function mirrorRepoTasks(options) {
     };
     if (tasks.length === 0)
         return result;
-    // Batch-resolve all canonical doc slugs (slug refs only — other ref types
+    // Batch-resolve all context doc slugs (slug refs only — other ref types
     // are stored without a resolved article reference for now)
     const allSlugs = [
         ...new Set(tasks.flatMap((t) => (t.context?.docs ?? []).filter(isSlugRef).map((d) => d.slug))),
@@ -353,10 +353,10 @@ async function fetchExistingDocState(client, docIds) {
 /** @internal Exported for testing — not part of the public API. */
 export function buildMirrorDocument(task, opts) {
     const { contentHash, docId, existingAuthor, git, slugToDocId } = opts;
-    // Build canonical docs with resolved references and correct refType.
+    // Build context docs with resolved references and correct refType.
     // Each ref type gets the appropriate resolution fields set on the
     // mirror document so Studio can display them correctly.
-    const canonicalDocs = (task.context?.docs ?? []).map((ref, i) => {
+    const contextDocs = (task.context?.docs ?? []).map((ref, i) => {
         const base = { _key: `cd${i}`, reason: ref.reason ?? "" };
         if (isSlugRef(ref)) {
             const resolvedId = slugToDocId.get(ref.slug);
@@ -428,11 +428,11 @@ export function buildMirrorDocument(task, opts) {
         _type: "ailf.task",
         ownership: "repo",
         status: task.status ?? "active",
-        assert: assertArray,
-        canonicalDocs,
-        description: task.title,
+        assertions: assertArray,
+        contextDocs,
+        title: task.title,
         docCoverage: task.docCoverage ?? false,
-        featureArea: {
+        area: {
             _ref: `ailf.featureArea.${area}`,
             _type: "reference",
         },
@@ -452,7 +452,7 @@ export function buildMirrorDocument(task, opts) {
             author: existingAuthor ?? git.author,
             lastEditor: git.author,
         },
-        taskPrompt: task.prompt?.text ?? "",
+        promptText: task.prompt?.text ?? "",
         ...(task.baseline
             ? {
                 baseline: {

package/dist/pipeline/plan.js

@@ -145,7 +145,7 @@ export async function buildPipelinePlan(opts, rootDir) {
             const rawTasks = await loadAllTsTaskFiles(modeTasksDir);
             if (rawTasks.length > 0) {
                 // Dynamic import of the handler module
-                const handlerModulePath = `./compiler/mode-handlers/${opts.mode}-handler.js`;
+                const handlerModulePath = `./compiler/mode-handlers/${opts.mode}/index.js`;
                 const mod = await import(handlerModulePath);
                 const handler = mod.handler;
                 for (const rawFile of rawTasks) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/ailf",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "private": false,
   "publishConfig": {
     "access": "restricted"
@@ -13,6 +13,14 @@
   },
   "description": "AI Literacy Framework - Evaluation tool for Sanity documentation",
   "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "bin": {
     "ailf": "./bin/ailf.js"
   },
@@ -26,6 +34,7 @@
   "dependencies": {
     "@google-cloud/bigquery": "^8.1.1",
     "@inquirer/prompts": "^8.3.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@portabletext/markdown": "^1.0.0",
     "@sanity/client": "^7.3.0",
     "commander": "^14.0.3",
@@ -41,9 +50,8 @@
     "@types/node": "^22.13.1",
     "tsx": "^4.19.2",
     "typescript": "^5.7.3",
-    "@sanity/ailf-core": "0.1.0",
     "@sanity/ailf-shared": "0.1.0",
-    "@sanity/ailf-tasks": "0.1.4"
+    "@sanity/ailf-core": "0.1.0"
   },
   "scripts": {
     "build": "tsc && tsx scripts/bundle-workspace-deps.ts",

package/dist/_vendor/ailf-tasks/cli.d.ts

@@ -1,8 +0,0 @@
-/**
- * cli.ts — Minimal CLI for standalone task validation.
- *
- * Usage:
- *   npx @sanity/ailf-tasks validate .ailf/tasks/
- *   npx @sanity/ailf-tasks validate             # defaults to .ailf/tasks/
- */
-export declare function run(): void;

package/dist/_vendor/ailf-tasks/cli.js

@@ -1,61 +0,0 @@
-/**
- * cli.ts — Minimal CLI for standalone task validation.
- *
- * Usage:
- *   npx @sanity/ailf-tasks validate .ailf/tasks/
- *   npx @sanity/ailf-tasks validate             # defaults to .ailf/tasks/
- */
-import { loadTaskDir } from "./parser.js";
-import { formatValidationResult, validateRepoTasks } from "./validation.js";
-export function run() {
-    const args = process.argv.slice(2);
-    const command = args[0];
-    if (command === "validate") {
-        const dir = args[1] ?? ".ailf/tasks";
-        validateCommand(dir);
-    }
-    else if (command === "--help" ||
-        command === "-h" ||
-        command === undefined) {
-        printUsage();
-    }
-    else {
-        console.error(`Unknown command: ${command}`);
-        printUsage();
-        process.exit(1);
-    }
-}
-function validateCommand(dir) {
-    try {
-        const tasks = loadTaskDir(dir);
-        // Run semantic validation
-        const result = validateRepoTasks(tasks);
-        const formatted = formatValidationResult(result);
-        console.log(`✅ ${tasks.length} task(s) validated from ${dir}`);
-        for (const task of tasks) {
-            console.log(`   ${task.id} — ${task.description}`);
-        }
-        if (result.warnings.length > 0 || result.errors.length > 0) {
-            console.log("");
-            console.log(formatted);
-        }
-        if (!result.valid) {
-            process.exit(1);
-        }
-    }
-    catch (err) {
-        console.error(`❌ ${err instanceof Error ? err.message : String(err)}`);
-        process.exit(1);
-    }
-}
-function printUsage() {
-    console.log("Usage: ailf-tasks <command> [options]");
-    console.log("");
-    console.log("Commands:");
-    console.log("  validate [dir]  Validate task YAML files (default: .ailf/tasks/)");
-    console.log("");
-    console.log("Examples:");
-    console.log("  ailf-tasks validate");
-    console.log("  ailf-tasks validate .ailf/tasks/");
-    console.log("  ailf-tasks validate /path/to/tasks/");
-}

package/dist/_vendor/ailf-tasks/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * @sanity/ailf-tasks — Task definition schemas and YAML parser.
- *
- * Lightweight package for parsing and validating .ailf/tasks/*.yaml files
- * without depending on the full AILF CLI or its heavyweight dependencies
- * (Promptfoo, LLM SDKs, Sanity client).
- *
- * Usage:
- *   import { parseTaskFile, loadTaskDir, RepoTaskSchema } from '@sanity/ailf-tasks'
- */
-export { CURATED_ASSERTION_TYPES, RepoTaskFileSchema, RepoTaskSchema, RUBRIC_TEMPLATE_NAMES, type CuratedAssertionType, type RepoTask, type RubricTemplateName, } from "./schemas.js";
-export { loadTaskDir, parseTaskFile } from "./parser.js";
-export { detectSnakeCaseFields, formatValidationResult, validateRepoTasks, type ValidationMessage, type ValidationResult, } from "./validation.js";

package/dist/_vendor/ailf-tasks/index.js

@@ -1,16 +0,0 @@
-/**
- * @sanity/ailf-tasks — Task definition schemas and YAML parser.
- *
- * Lightweight package for parsing and validating .ailf/tasks/*.yaml files
- * without depending on the full AILF CLI or its heavyweight dependencies
- * (Promptfoo, LLM SDKs, Sanity client).
- *
- * Usage:
- *   import { parseTaskFile, loadTaskDir, RepoTaskSchema } from '@sanity/ailf-tasks'
- */
-// Schemas and types
-export { CURATED_ASSERTION_TYPES, RepoTaskFileSchema, RepoTaskSchema, RUBRIC_TEMPLATE_NAMES, } from "./schemas.js";
-// Parsing
-export { loadTaskDir, parseTaskFile } from "./parser.js";
-// Validation
-export { detectSnakeCaseFields, formatValidationResult, validateRepoTasks, } from "./validation.js";

package/dist/_vendor/ailf-tasks/parser.d.ts

@@ -1,27 +0,0 @@
-/**
- * parser.ts — Standalone task file and directory parsing.
- *
- * High-level functions for loading and validating .ailf/tasks/ YAML
- * files without any dependency on the eval pipeline.
- *
- * Usage:
- *   import { parseTaskFile, loadTaskDir } from '@sanity/ailf-tasks'
- */
-import { type RepoTask } from "./schemas.js";
-/**
- * Parse a single task YAML string and return validated tasks.
- *
- * @param content - Raw YAML string content
- * @param filename - Source filename (for error messages)
- * @returns Validated array of RepoTask objects
- * @throws Error if YAML parsing or Zod validation fails
- */
-export declare function parseTaskFile(content: string, filename?: string): RepoTask[];
-/**
- * Load and parse all task YAML files from a directory.
- *
- * @param dirPath - Path to directory containing .yaml/.yml files
- * @returns All validated tasks, sorted by filename
- * @throws Error if directory not found, no YAML files, or validation fails
- */
-export declare function loadTaskDir(dirPath: string): RepoTask[];

package/dist/_vendor/ailf-tasks/parser.js

@@ -1,73 +0,0 @@
-/**
- * parser.ts — Standalone task file and directory parsing.
- *
- * High-level functions for loading and validating .ailf/tasks/ YAML
- * files without any dependency on the eval pipeline.
- *
- * Usage:
- *   import { parseTaskFile, loadTaskDir } from '@sanity/ailf-tasks'
- */
-import { existsSync, readdirSync, readFileSync } from "fs";
-import { resolve } from "path";
-import { load } from "js-yaml";
-import { RepoTaskFileSchema } from "./schemas.js";
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Parse a single task YAML string and return validated tasks.
- *
- * @param content - Raw YAML string content
- * @param filename - Source filename (for error messages)
- * @returns Validated array of RepoTask objects
- * @throws Error if YAML parsing or Zod validation fails
- */
-export function parseTaskFile(content, filename = "<string>") {
-    const parsed = load(content);
-    if (!Array.isArray(parsed)) {
-        throw new Error(`${filename} did not parse to an array of tasks. ` +
-            "Task files must contain a YAML array of task definitions.");
-    }
-    const result = RepoTaskFileSchema.safeParse(parsed);
-    if (!result.success) {
-        const messages = result.error.issues
-            .map((i) => `  [${i.path.join(".")}]: ${i.message}`)
-            .join("\n");
-        throw new Error(`Invalid task file "${filename}":\n${messages}`);
-    }
-    return result.data;
-}
-/**
- * Load and parse all task YAML files from a directory.
- *
- * @param dirPath - Path to directory containing .yaml/.yml files
- * @returns All validated tasks, sorted by filename
- * @throws Error if directory not found, no YAML files, or validation fails
- */
-export function loadTaskDir(dirPath) {
-    if (!existsSync(dirPath)) {
-        throw new Error(`Tasks directory not found: ${dirPath}\n` +
-            "  Expected a directory containing .ailf/tasks/*.yaml files.");
-    }
-    const yamlFiles = readdirSync(dirPath)
-        .filter((f) => (f.endsWith(".yaml") || f.endsWith(".yml")) && !f.startsWith("."))
-        .sort();
-    if (yamlFiles.length === 0) {
-        throw new Error(`No YAML files found in ${dirPath}\n` +
-            "  Expected .ailf/tasks/*.yaml files with task definitions.");
-    }
-    const allTasks = [];
-    for (const file of yamlFiles) {
-        const filePath = resolve(dirPath, file);
-        const content = readFileSync(filePath, "utf-8");
-        try {
-            const tasks = parseTaskFile(content, file);
-            allTasks.push(...tasks);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            throw new Error(`Failed to load ${file}:\n${msg}`, { cause: err });
-        }
-    }
-    return allTasks;
-}