@sanity/ailf 2.0.0 → 2.0.1

package/dist/commands/init.d.ts

@@ -6,9 +6,8 @@
  * not live evaluation tasks.
  *
  * TypeScript output (default) uses define* helpers from @sanity/ailf-core
- * for full IDE autocomplete and type checking. YAML output preserves
- * inline comments from the source files. JSON output is a plain
- * serialization of the parsed data.
+ * for full IDE autocomplete and type checking. YAML output serializes the
+ * parsed task data. JSON output is a plain serialization of the parsed data.
  *
  * Usage:
  *   ailf init                        # TypeScript output (default)

package/dist/commands/init.js

@@ -6,9 +6,8 @@
  * not live evaluation tasks.
  *
  * TypeScript output (default) uses define* helpers from @sanity/ailf-core
- * for full IDE autocomplete and type checking. YAML output preserves
- * inline comments from the source files. JSON output is a plain
- * serialization of the parsed data.
+ * for full IDE autocomplete and type checking. YAML output serializes the
+ * parsed task data. JSON output is a plain serialization of the parsed data.
  *
  * Usage:
  *   ailf init                        # TypeScript output (default)
@@ -20,7 +19,7 @@
 import { Command } from "commander";
 import { existsSync, mkdirSync, writeFileSync } from "fs";
 import { resolve, relative } from "path";
-import { ailfConfigData, ailfConfigYaml, ailfConfigTs, taskYamlFiles, taskTsFiles, TASK_FILE_NAMES, TASK_TS_FILE_NAMES, allTaskData, workflowYaml, } from "../_vendor/ailf-core/index.js";
+import { ailfConfigData, ailfConfigYaml, ailfConfigTs, taskYamlFiles, taskTsFiles, TASK_FILE_NAMES, TASK_EXAMPLES, allTaskData, workflowYaml, } from "../_vendor/ailf-core/index.js";
 // ---------------------------------------------------------------------------
 // Command factory
 // ---------------------------------------------------------------------------
@@ -54,6 +53,10 @@ function rel(from, to) {
     const r = relative(from, to);
     return r.startsWith(".") ? r : `./${r}`;
 }
+/** Filter task stems by mode using TASK_EXAMPLES metadata */
+function taskStemsForMode(mode) {
+    return TASK_EXAMPLES.filter((t) => t.mode === mode).map((t) => t.stem);
+}
 // ---------------------------------------------------------------------------
 // Init logic
 // ---------------------------------------------------------------------------
@@ -66,6 +69,11 @@ async function runInit(opts) {
     }
     const format = opts.outputFormat;
     const force = opts.force;
+    if (format === "yaml") {
+        console.warn("  ⚠ --output-format yaml is deprecated. TypeScript (default) is the\n" +
+            "    recommended format — it provides full IDE autocomplete via defineTask().\n" +
+            "    YAML output will be removed in a future release.\n");
+    }
     // Resolve target from the caller's actual working directory
     const callerCwd = process.env.AILF_CALLER_CWD ?? process.cwd();
     const targetDir = resolve(callerCwd, opts.path);
@@ -115,71 +123,52 @@ async function runInit(opts) {
     // 3. Write example tasks to .ailf/tasks/
     const modeFilter = opts.mode;
     const isCustomMode = modeFilter === "custom";
+    // Determine which task stems to write based on mode filter
+    let stemsToWrite;
+    if (isCustomMode) {
+        // Custom mode: write one literacy example as a starting point
+        stemsToWrite = taskStemsForMode("literacy").slice(0, 1);
+    }
+    else if (modeFilter === "literacy") {
+        stemsToWrite = taskStemsForMode("literacy");
+    }
+    else if (modeFilter === "mcp-server") {
+        stemsToWrite = taskStemsForMode("mcp-server");
+    }
+    else if (modeFilter === "knowledge-probe") {
+        stemsToWrite = taskStemsForMode("knowledge-probe");
+    }
+    else {
+        // Default (no --mode): write all tasks
+        stemsToWrite = [...TASK_FILE_NAMES];
+    }
     if (format === "ts") {
-        // TypeScript: *.task.ts files with defineTask helper
-        // Default (no --mode): write literacy examples + draft MCP/probe examples
-        // --mode literacy: only literacy examples
-        // --mode mcp-server: only MCP examples (active, not draft)
-        // --mode custom: only a custom example task
-        if (!modeFilter || modeFilter === "literacy") {
-            for (const stem of TASK_TS_FILE_NAMES) {
-                const taskPath = resolve(tasksDir, `${stem}.task.ts`);
-                const content = taskTsFiles[stem];
-                if (writeIfNew(taskPath, content, force)) {
-                    written.push(rel(targetDir, taskPath));
-                }
-                else {
-                    skipped.push(rel(targetDir, taskPath));
-                }
-            }
-        }
-        // Draft examples for other modes (default init only)
-        if (!modeFilter) {
-            const mcpPath = resolve(tasksDir, "example-mcp-tool-usage.task.ts");
-            if (writeIfNew(mcpPath, MCP_DRAFT_TASK_TS, force)) {
-                written.push(rel(targetDir, mcpPath));
-            }
-            else {
-                skipped.push(rel(targetDir, mcpPath));
-            }
-            const probePath = resolve(tasksDir, "example-knowledge-probe.task.ts");
-            if (writeIfNew(probePath, PROBE_DRAFT_TASK_TS, force)) {
-                written.push(rel(targetDir, probePath));
-            }
-            else {
-                skipped.push(rel(targetDir, probePath));
+        for (const stem of stemsToWrite) {
+            let content = taskTsFiles[stem];
+            if (!content)
+                continue;
+            // For MCP-only init, activate the draft task
+            if (modeFilter === "mcp-server") {
+                content = content.replace('status: "draft",', '// status: "active", // Activated — this task runs in evaluations');
             }
-        }
-        // MCP-only init
-        if (modeFilter === "mcp-server") {
-            const mcpContent = MCP_DRAFT_TASK_TS.replace('status: "draft",', '// status: "active", // Activated — this task runs in evaluations');
-            const mcpPath = resolve(tasksDir, "example-mcp-tool-usage.task.ts");
-            if (writeIfNew(mcpPath, mcpContent, force)) {
-                written.push(rel(targetDir, mcpPath));
+            const fileName = isCustomMode && stem === stemsToWrite[0]
+                ? "example-custom.task.ts"
+                : `${stem}.task.ts`;
+            const taskPath = resolve(tasksDir, fileName);
+            if (writeIfNew(taskPath, content, force)) {
+                written.push(rel(targetDir, taskPath));
             }
             else {
-                skipped.push(rel(targetDir, mcpPath));
-            }
-        }
-        // Custom preset scaffold
-        if (isCustomMode) {
-            const customTaskPath = resolve(tasksDir, "example-custom.task.ts");
-            // Reuse the GROQ literacy task as a starting point
-            if (taskTsFiles[TASK_TS_FILE_NAMES[0]]) {
-                if (writeIfNew(customTaskPath, taskTsFiles[TASK_TS_FILE_NAMES[0]], force)) {
-                    written.push(rel(targetDir, customTaskPath));
-                }
-                else {
-                    skipped.push(rel(targetDir, customTaskPath));
-                }
+                skipped.push(rel(targetDir, taskPath));
             }
         }
     }
     else if (format === "yaml") {
-        // YAML: raw string passthrough (preserves comments)
-        for (const stem of TASK_FILE_NAMES) {
-            const taskPath = resolve(tasksDir, `${stem}.yaml`);
+        for (const stem of stemsToWrite) {
             const content = taskYamlFiles[stem];
+            if (!content)
+                continue;
+            const taskPath = resolve(tasksDir, `${stem}.yaml`);
             if (writeIfNew(taskPath, content, force)) {
                 written.push(rel(targetDir, taskPath));
             }
@@ -193,8 +182,12 @@ async function runInit(opts) {
         const tasks = Array.isArray(allTaskData)
             ? allTaskData
             : [allTaskData];
+        // Build a set of task IDs that match the selected stems
+        const selectedIds = new Set(stemsToWrite.flatMap((s) => TASK_EXAMPLES.filter((t) => t.stem === s).map((t) => t.stem)));
         for (const task of tasks) {
             const taskId = task.id;
+            if (!selectedIds.has(taskId))
+                continue;
             const taskPath = resolve(tasksDir, `${taskId}.json`);
             const content = JSON.stringify([task], null, 2) + "\n";
             if (writeIfNew(taskPath, content, force)) {
@@ -263,8 +256,7 @@ async function runInit(opts) {
     if (format === "ts") {
         console.log();
         console.log(`  💡 TypeScript tasks (${taskExt}) give you full IDE autocomplete`);
-        console.log("     via defineTask() from @sanity/ailf-core. YAML and JSON are");
-        console.log("     also supported — re-run with --output-format yaml if preferred.");
+        console.log("     via defineTask() from @sanity/ailf-core.");
     }
     console.log();
     console.log("  🔑 Retrieve secrets from 1Password (Sanity employees):");
@@ -282,114 +274,8 @@ async function runInit(opts) {
     console.log();
 }
 // ---------------------------------------------------------------------------
-// Draft example templates for non-literacy modes
+// Custom preset scaffold template
 // ---------------------------------------------------------------------------
-const MCP_DRAFT_TASK_TS = `/**
- * Example Task: MCP Server tool-use evaluation (DRAFT).
- *
- * Tests whether an LLM can correctly discover and invoke Sanity MCP server
- * tools. Connects to the hosted Sanity MCP server at https://mcp.sanity.io.
- *
- * Prerequisites:
- *   - A Sanity API token with read access (for token-based auth)
- *   - Or: OAuth authentication will be prompted on first connect
- *
- * Authentication options:
- *   1. Token-based: set SANITY_API_TOKEN env var
- *   2. OAuth: the server prompts for login on first connect
- *
- * Setup: npx sanity@latest mcp configure
- * Docs:  https://www.sanity.io/docs/ai/mcp-server
- *
- * This task is a DRAFT — it won't run unless activated or explicitly targeted.
- * To activate: change status to "active" or remove the status field.
- */
-
-import { defineTask } from "../_vendor/ailf-core/index.js"
-
-export default defineTask({
-  mode: "mcp-server",
-  id: "example-mcp-tool-usage",
-  title: "MCP tool discovery and invocation",
-  description: "Example — tests Sanity MCP server tool-use (draft)",
-  area: "mcp",
-
-  // ── Server configuration ────────────────────────────────────
-  // The Sanity MCP server is hosted remotely at https://mcp.sanity.io.
-  // Authentication via API token header or OAuth.
-  //
-  // For token auth, set SANITY_API_TOKEN in your environment.
-  serverConfig: {
-    transport: "streamable-http",
-    url: "https://mcp.sanity.io",
-    env: {
-      SANITY_API_TOKEN: process.env.SANITY_API_TOKEN ?? "",
-    },
-  },
-
-  prompt: {
-    text: \`Use the available MCP tools to query all documents of type "article"
-in the Sanity dataset. Return the title and slug for each document.
-Limit results to 5 documents.\`,
-  },
-
-  assertions: [
-    {
-      type: "llm-rubric",
-      template: "mcp-input-validation",
-      criteria: [
-        "Correctly identifies the query_documents tool",
-        "Passes a valid GROQ query to filter by document type",
-        "Requests only the needed fields (title, slug)",
-      ],
-    },
-  ],
-
-  status: "draft",
-})
-`;
-const PROBE_DRAFT_TASK_TS = `/**
- * Example Task: Knowledge probe baseline (DRAFT).
- *
- * Tests what the model knows about a topic without providing documentation.
- * Used to establish a baseline for comparison with literacy evaluations.
- * This task is a DRAFT — it won't run unless activated or explicitly targeted.
- *
- * To activate: change status to "active" or remove the status field.
- */
-
-import { defineTask } from "../_vendor/ailf-core/index.js"
-
-export default defineTask({
-  mode: "knowledge-probe",
-  id: "example-knowledge-probe",
-  title: "Model knowledge of GROQ syntax",
-  description: "Example — probes baseline model knowledge (draft)",
-  area: "groq",
-
-  prompt: {
-    text: \`Explain the GROQ query language used by Sanity. Cover:
-1. Basic query syntax and projections
-2. How to filter and sort results
-3. Common patterns for fetching related documents
-Provide working code examples.\`,
-  },
-
-  assertions: [
-    {
-      type: "llm-rubric",
-      template: "task-completion",
-      criteria: [
-        "Demonstrates understanding of GROQ query syntax",
-        "Shows filtering and projection patterns",
-        "Code examples use valid GROQ syntax",
-      ],
-    },
-  ],
-
-  status: "draft",
-})
-`;
 const CUSTOM_PRESET_TS = `/**
  * Custom preset — your domain-specific evaluation configuration.
  *
@@ -401,7 +287,7 @@ const CUSTOM_PRESET_TS = `/**
  * To use a different mode (e.g., "mcp-server"), change the mode field.
  * Available built-in modes: literacy, mcp-server, knowledge-probe, agent-harness.
  *
- * @see https://github.com/sanity-labs/ai-literacy-framework/blob/main/docs/PRESETS.md
+ * @see https://github.com/sanity-labs/ai-literacy-framework/blob/main/docs/presets.md
  */
 
 import { definePreset } from "../_vendor/ailf-core/index.js"

package/dist/commands/pipeline-action.d.ts

@@ -36,6 +36,8 @@ export interface ResolvedOptions {
     noAutoScope: boolean;
     noCache: boolean;
     noRemoteCache: boolean;
+    /** Base directory for user-facing pipeline output artifacts (always resolved). */
+    outputDir: string;
     outputPath?: string;
     perspectiveOverride?: string;
     projectIdOverride?: string;
@@ -57,10 +59,14 @@ export interface ResolvedOptions {
     repoTasksPath?: string;
     taskOption?: string;
     tagOption?: string[];
-    taskSourceType?: "content-lake" | "repo" | "yaml";
+    taskSourceType?: "content-lake" | "repo";
     urlArgs: string[];
     apiUrl: string;
     apiKey?: string;
+    captureEnabled: boolean;
+    captureDir?: string;
+    captureCompress: boolean;
+    captureExtras: boolean;
 }
 /**
  * Pure option resolution — computes ResolvedOptions from CLI flags without

package/dist/commands/pipeline-action.js

@@ -10,7 +10,7 @@
  *
  * @see packages/eval/src/orchestration/ for the step-based pipeline
  */
-import { existsSync, readFileSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { dirname, resolve } from "path";
 import { fileURLToPath } from "url";
 import { classifyUrls } from "../pipeline/classify-url.js";
@@ -209,6 +209,23 @@ export function computeResolvedOptions(opts) {
     const remote = opts.remote || process.env.AILF_REMOTE === "1";
     const apiUrl = opts.apiUrl ?? process.env.AILF_API_URL ?? "https://ailf-api.sanity.build";
     const apiKey = process.env.AILF_API_KEY ?? undefined;
+    // Output directory: explicit flag → repo-task heuristic → default
+    const resolvedRepoTasksPath = opts.repoTasksPath
+        ? resolve(callerCwd, opts.repoTasksPath)
+        : undefined;
+    const resolvedTaskSourceType = resolveTaskSourceType(opts.taskSource);
+    let outputDir;
+    if (opts.outputDir) {
+        outputDir = resolve(callerCwd, opts.outputDir);
+    }
+    else if (resolvedTaskSourceType === "repo" || resolvedRepoTasksPath) {
+        outputDir = resolvedRepoTasksPath
+            ? resolve(resolvedRepoTasksPath, "..", "results", "latest")
+            : resolve(callerCwd, ".ailf", "results", "latest");
+    }
+    else {
+        outputDir = resolve(ROOT, "results", "latest");
+    }
     return {
         allowedOriginArgs,
         apiKey,
@@ -233,6 +250,7 @@ export function computeResolvedOptions(opts) {
         noAutoScope: opts.autoScope === false,
         noCache: !opts.cache,
         noRemoteCache: opts.remoteCache === false,
+        outputDir,
         outputPath: opts.output,
         perspectiveOverride,
         projectIdOverride,
@@ -250,24 +268,25 @@ export function computeResolvedOptions(opts) {
         skipFetch: opts.skipFetch,
         source: opts.source,
         studioOriginOverride,
-        repoTasksPath: opts.repoTasksPath
-            ? resolve(callerCwd, opts.repoTasksPath)
-            : undefined,
+        repoTasksPath: resolvedRepoTasksPath,
         taskOption,
         tagOption,
-        taskSourceType: resolveTaskSourceType(opts.taskSource),
+        taskSourceType: resolvedTaskSourceType,
         urlArgs,
+        captureEnabled: opts.capture || process.env.AILF_CAPTURE === "1",
+        captureDir: opts.captureDir ?? process.env.AILF_CAPTURE_DIR,
+        captureCompress: opts.captureCompress !== false &&
+            process.env.AILF_CAPTURE_COMPRESS !== "0",
+        captureExtras: opts.captureExtras !== false && process.env.AILF_CAPTURE_EXTRAS !== "0",
     };
 }
 /** Resolve and validate the --task-source flag value. */
 function resolveTaskSourceType(raw) {
     if (!raw || raw === "content-lake")
         return undefined; // default — Content Lake
-    if (raw === "yaml")
-        return "yaml";
     if (raw === "repo")
         return "repo";
-    console.error(`❌ Invalid --task-source "${raw}". Must be "yaml", "repo", or "content-lake".`);
+    console.error(`❌ Invalid --task-source "${raw}". Must be "repo" or "content-lake".`);
     process.exit(1);
 }
 // ---------------------------------------------------------------------------
@@ -304,17 +323,26 @@ export async function executePipeline(cliOpts) {
         if (cliOpts.output) {
             config.outputPath = resolve(callerCwd, cliOpts.output);
         }
+        // Output dir: explicit CLI flag → repo-task heuristic → file-config default
+        if (cliOpts.outputDir) {
+            config.outputDir = resolve(callerCwd, cliOpts.outputDir);
+        }
+        else if (config.repoTasksPath) {
+            config.outputDir = resolve(config.repoTasksPath, "..", "results", "latest");
+        }
         // Create AppContext directly from the merged config so adapters
         // (especially taskSource) are wired from the file config's
         // taskSourceType — not from CLI defaults.
+        console.log(`  📂 Output directory: ${config.outputDir}`);
         const ctx = createAppContext(config);
         const pipelineStart = Date.now();
         const steps = buildStepSequence(ctx, pipelineStart);
         const result = await orchestratePipeline(ctx, steps);
-        writePipelineResult(result);
+        writePipelineResult(result, config.outputDir);
         process.exit(result.success ? 0 : 1);
     }
     const o = resolveOptions(cliOpts);
+    console.log(`  📂 Output directory: ${o.outputDir}`);
     // Remote mode — submit to AILF API instead of running locally.
     // Use the caller's working directory (not the package root) because
     // remote mode reads .ailf/tasks/ from the user's repo, not from
@@ -350,7 +378,7 @@ export async function executePipeline(cliOpts) {
     const pipelineStart = Date.now();
     const steps = buildStepSequence(ctx, pipelineStart);
     const result = await orchestratePipeline(ctx, steps);
-    writePipelineResult(result);
+    writePipelineResult(result, o.outputDir);
     process.exit(result.success ? 0 : 1);
 }
 // ---------------------------------------------------------------------------
@@ -362,15 +390,11 @@ export async function executePipeline(cliOpts) {
 function resolveOptions(opts) {
     return computeResolvedOptions(opts);
 }
-function writePipelineResult(result) {
-    const resultFile = resolve(ROOT, "results", "latest", "pipeline-result.json");
-    try {
-        writeFileSync(resultFile, JSON.stringify(result, null, 2));
-        console.log(`  📄 Pipeline result: ${resultFile}\n`);
-    }
-    catch {
-        // results/latest/ may not exist yet — not critical
-    }
+function writePipelineResult(result, outputDir) {
+    mkdirSync(outputDir, { recursive: true });
+    const resultFile = resolve(outputDir, "pipeline-result.json");
+    writeFileSync(resultFile, JSON.stringify(result, null, 2));
+    console.log(`  📄 Pipeline result: ${resultFile}\n`);
 }
 /**
  * Load .ailf/config.yaml if --repo-tasks-path is set and the config file

package/dist/commands/pipeline.d.ts

@@ -5,7 +5,7 @@
  * options object, bridges to process.env for downstream modules, and
  * delegates to runPipeline().
  *
- * @see docs/CLI.md for the full flag reference.
+ * @see docs/cli.md for the full flag reference.
  */
 import { Command } from "commander";
 /**
@@ -37,6 +37,7 @@ export interface PipelineCliOptions {
     mode: string;
     variant?: string;
     output?: string;
+    outputDir?: string;
     promptfooUrl?: string;
     publish?: boolean;
     publishTag?: string;
@@ -63,5 +64,9 @@ export interface PipelineCliOptions {
     url: string[];
     urls: string[];
     apiUrl?: string;
+    capture: boolean;
+    captureDir?: string;
+    captureCompress: boolean;
+    captureExtras: boolean;
 }
 export declare function createPipelineCommand(): Command;

package/dist/commands/pipeline.js

@@ -5,7 +5,7 @@
  * options object, bridges to process.env for downstream modules, and
  * delegates to runPipeline().
  *
- * @see docs/CLI.md for the full flag reference.
+ * @see docs/cli.md for the full flag reference.
  */
 import { Command } from "commander";
 import { LiteracyVariant } from "../pipeline/normalize-mode.js";
@@ -48,11 +48,16 @@ export function createPipelineCommand() {
         .option("--report-project <id>", "Sanity project ID for report store")
         .option("--config <path>", "Load pipeline config from a TS/JS/YAML/JSON file (overrides most CLI flags)")
         .option("-o, --output <path>", "Write PR comment markdown to file")
+        .option("--output-dir <path>", "Base directory for pipeline output artifacts (default: inferred from execution context)")
         .option("--promptfoo-url <url>", "Promptfoo share URL for report")
-        .option("--task-source <type>", "Task definition source: content-lake (default — Sanity Content Lake), repo (repo tasks only, no Content Lake merge), yaml (tasks/*.yaml files, legacy)", "content-lake")
+        .option("--task-source <type>", "Task definition source: content-lake (default — Sanity Content Lake), repo (repo tasks only, no Content Lake merge)", "content-lake")
         .option("--repo-tasks-path <path>", "Path to repo-based task definitions (.ailf/tasks/ directory)")
         .option("--remote", "Submit evaluation to the AILF API instead of running locally", false)
         .option("--api-url <url>", "AILF API base URL (default: https://ailf-api.sanity.build)")
+        .option("--capture", "Enable artifact capture for this run", false)
+        .option("--capture-dir <path>", "Base directory for capture output (default: results/captures/)")
+        .option("--no-capture-compress", "Disable tar.gz compression of captures")
+        .option("--no-capture-extras", "Exclude mode-specific artifacts from captures")
         .action(async (opts) => {
         const { executePipeline } = await import("./pipeline-action.js");
         await executePipeline(opts);

package/dist/commands/pr-comment.js

@@ -20,6 +20,7 @@ export function createPrCommentCommand() {
         try {
             const ctx = createAppContext({
                 rootDir: ROOT,
+                outputDir: resolve(ROOT, "results", "latest"),
                 mode: "literacy",
                 noAutoScope: false,
                 skipFetch: true,

package/dist/commands/publish.js

@@ -87,6 +87,7 @@ async function runPublishCommand(summaryPath, opts) {
         noAutoScope: false,
         noCache: true,
         noRemoteCache: true,
+        outputDir: resolve(ROOT, "results", "latest"),
         publishEnabled: true,
         publishTag: opts.tag,
         readinessEnabled: false,

package/dist/commands/shared/help.js

@@ -74,8 +74,8 @@ Quick Start:
 
 Documentation:
   Repository   https://github.com/sanity-io/ai-literacy-framework
-  CLI Guide    https://github.com/sanity-io/ai-literacy-framework/blob/main/docs/CLI.md
-  Getting Started  https://github.com/sanity-io/ai-literacy-framework/blob/main/docs/GETTING_STARTED.md
+  CLI Guide    https://github.com/sanity-io/ai-literacy-framework/blob/main/docs/cli.md
+  Getting Started  https://github.com/sanity-io/ai-literacy-framework/blob/main/docs/getting-started.md
 
 Run ailf <command> --help for detailed usage of any command.`;
 // ---------------------------------------------------------------------------

package/dist/commands/update-quality-scores.d.ts

@@ -0,0 +1,5 @@
+/**
+ * update-quality-scores command — update QUALITY_SCORE.md from scores.
+ */
+import { Command } from "commander";
+export declare function createUpdateQualityScoresCommand(): Command;

package/dist/commands/update-quality-scores.js

@@ -0,0 +1,20 @@
+/**
+ * update-quality-scores command — update QUALITY_SCORE.md from scores.
+ */
+import { Command } from "commander";
+export function createUpdateQualityScoresCommand() {
+    return new Command("update-quality-scores")
+        .description("Update docs/QUALITY_SCORE.md from score-summary.json")
+        .action(async () => {
+        const { updateQualityScores } = await import("../scripts/update-quality-scores.js");
+        console.log("=== Updating QUALITY_SCORE.md from score-summary.json ===\n");
+        const result = updateQualityScores();
+        if (result.success) {
+            console.log(`  ✅ ${result.message}`);
+        }
+        else {
+            console.error(`  ❌ ${result.message}`);
+            process.exit(1);
+        }
+    });
+}

package/dist/composition-root.d.ts

@@ -13,15 +13,14 @@
  * - After: one factory, one place to change adapter wiring
  *
  * @see packages/core/src/ports/context.ts — AppContext interface
- * @see docs/exec-plans/ports-and-adapters/phase-7-composition-root.md
+ * @see docs/archive/exec-plans/ports-and-adapters/phase-7-composition-root.md
  */
 import { type AppContext, type AssertionRegistration, type ResolvedConfig } from "./_vendor/ailf-core/index.d.ts";
 /**
  * Create a fully wired AppContext from resolved configuration.
  *
  * Every adapter is constructed here and nowhere else (outside of tests).
- * Swapping an adapter (e.g., YamlTaskSource → ContentLakeTaskSource)
- * is a one-line change in this function.
+ * Swapping an adapter is a one-line change in this function.
  */
 export declare function createAppContext(config: ResolvedConfig): AppContext;
 /**