@sanity/ailf 3.5.1 → 3.7.0

package/dist/_vendor/ailf-core/types/generalized-task.d.ts

@@ -341,3 +341,26 @@ export interface CustomTaskDefinition extends TaskCommonFields {
  * when authoring tasks.
  */
 export type GeneralizedTaskDefinition = LiteracyTaskDefinition | MCPServerTaskDefinition | AgentHarnessTaskDefinition | KnowledgeProbeTaskDefinition | CustomTaskDefinition;
+/**
+ * The subset of task modes that can be authored as `ailf.task` documents in
+ * the Content Lake (Sanity Studio). Today exactly `"literacy"`.
+ *
+ * Expanding this set is a deliberate decision: execution-bound fields
+ * (filesystem handles, local commands, sandbox config, module paths) cannot
+ * round-trip through Content Lake, so not every mode belongs here. Adding a
+ * mode requires a new or superseding ADR and a coordinated schema update
+ * across the domain type, Studio schema, and `ContentLakeTaskSource` adapter
+ * per the `ailf-schema-sync` skill.
+ *
+ * @see docs/decisions/D0038-content-lake-authorable-task-modes.md
+ */
+export type ContentLakeAuthorableMode = "literacy";
+/**
+ * The slice of `GeneralizedTaskDefinition` authorable in the Content Lake,
+ * derived mechanically from `ContentLakeAuthorableMode`. Used as the return
+ * type of `ContentLakeTaskSource` so the adapter's mode literal is
+ * type-checked against the boundary rather than a loose cast.
+ */
+export type ContentLakeAuthorableTask = Extract<GeneralizedTaskDefinition, {
+    mode: ContentLakeAuthorableMode;
+}>;

package/dist/_vendor/ailf-core/types/index.d.ts

@@ -25,7 +25,7 @@ export type { VariableDeclaration, VariableEnvelope, VariableProvenance, Variabl
 export type { EvalTrace, ToolCallCategory, ToolCallRecord, TraceEvent, TraceSpan, TraceTokenUsage, } from "./trace.js";
 export type { ArtifactId, AssociationAxis, AssociationValues, Brand, EntryKey, Err, FixtureId, IdValidationError, NewReportId, Ok, ProviderId, PromptId, Result, ResultId, RubricId, RunFingerprint, RunId, SuiteId, TaskId, TaskSlug, TraceId, } from "./branded-ids.js";
 export { err, fixtureId, generateRunId, ok, providerId, resultId, runId, suiteId, taskId, traceId, } from "./branded-ids.js";
-export type { AgentHarnessTaskDefinition, CustomTaskDefinition, GeneralizedAssertionDefinition, GeneralizedDocRef, GeneralizedTaskDefinition, GeneralizedTemplatedAssertion, GeneralizedValueAssertion, IdDocRef, KnowledgeProbeTaskDefinition, LiteracyTaskDefinition, MCPServerTaskDefinition, PathDocRef, PerspectiveDocRef, RubricRef, SlugDocRef, TaskCommonFields, TaskDifficulty, TaskOptions, TaskProviderConfig, TaskStatus, } from "./generalized-task.js";
+export type { AgentHarnessTaskDefinition, ContentLakeAuthorableMode, ContentLakeAuthorableTask, CustomTaskDefinition, GeneralizedAssertionDefinition, GeneralizedDocRef, GeneralizedTaskDefinition, GeneralizedTemplatedAssertion, GeneralizedValueAssertion, IdDocRef, KnowledgeProbeTaskDefinition, LiteracyTaskDefinition, MCPServerTaskDefinition, PathDocRef, PerspectiveDocRef, RubricRef, SlugDocRef, TaskCommonFields, TaskDifficulty, TaskOptions, TaskProviderConfig, TaskStatus, } from "./generalized-task.js";
 type DocumentRef = _DocumentRef;
 /** Aggregated retrieval metrics for a feature area */
 export interface AreaRetrievalMetrics {

package/dist/adapters/task-sources/content-lake-task-source.d.ts

@@ -2,13 +2,18 @@
  * Adapter: Load task definitions from the Sanity Content Lake.
  *
  * Fetches ailf.task documents via GROQ and maps them to
- * GeneralizedTaskDefinition (LiteracyTaskDefinition variant).
- * The pipeline never knows which adapter loaded the tasks.
+ * `ContentLakeAuthorableTask` — the subset of `GeneralizedTaskDefinition`
+ * authorable in Studio per D0038. Today that subset is exactly the
+ * literacy variant.
+ *
+ * The pipeline never knows which adapter loaded the tasks; the
+ * `TaskSource` port widens the return type back to
+ * `GeneralizedTaskDefinition[]`.
  *
  * Wired in the composition root as the default task source.
  *
  * @see packages/core/src/ports/task-source.ts — TaskSource port
- * @see docs/archive/exec-plans/tasks-as-content/phase-2-pipeline-integration.md
+ * @see docs/decisions/D0038-content-lake-authorable-task-modes.md
  */
 import type { SanityClient } from "@sanity/client";
 import type { FilterOptions, GeneralizedTaskDefinition, TaskSource } from "../../_vendor/ailf-core/index.d.ts";

package/dist/adapters/task-sources/content-lake-task-source.js

@@ -2,14 +2,20 @@
  * Adapter: Load task definitions from the Sanity Content Lake.
  *
  * Fetches ailf.task documents via GROQ and maps them to
- * GeneralizedTaskDefinition (LiteracyTaskDefinition variant).
- * The pipeline never knows which adapter loaded the tasks.
+ * `ContentLakeAuthorableTask` — the subset of `GeneralizedTaskDefinition`
+ * authorable in Studio per D0038. Today that subset is exactly the
+ * literacy variant.
+ *
+ * The pipeline never knows which adapter loaded the tasks; the
+ * `TaskSource` port widens the return type back to
+ * `GeneralizedTaskDefinition[]`.
  *
  * Wired in the composition root as the default task source.
  *
  * @see packages/core/src/ports/task-source.ts — TaskSource port
- * @see docs/archive/exec-plans/tasks-as-content/phase-2-pipeline-integration.md
+ * @see docs/decisions/D0038-content-lake-authorable-task-modes.md
  */
+import { ContentLakeAuthorableTaskSchema } from "./repo-schemas.js";
 // ---------------------------------------------------------------------------
 // GROQ query — fetches ailf.task documents with resolved references
 // ---------------------------------------------------------------------------
@@ -47,11 +53,15 @@ const TASKS_QUERY = /* groq */ `
   && (!defined($tags) || count((tags)[@ in $tags]) > 0)
 ] | order(coalesce(area->areaId.current, featureArea->areaId.current) asc, id.current asc) {
   "taskId": id.current,
-  // Coalesce current and legacy field names so documents created before
-  // the schema rename are still readable.
+  // The coalesce on title preserves back-compat: older documents that used
+  // the description field as the task label (before title was required)
+  // still read cleanly. New documents have title and description as
+  // distinct fields.
   "title": coalesce(title, description),
+  description,
   "areaId": coalesce(area->areaId.current, featureArea->areaId.current),
   "promptText": coalesce(promptText, taskPrompt),
+  status,
   docCoverage,
   "contextDocs": coalesce(contextDocs, canonicalDocs)[] {
     refType,
@@ -86,9 +96,25 @@ export class ContentLakeTaskSource {
         }
         const definitions = [];
         for (const entry of raw) {
-            const mapped = mapToLiteracyTask(entry);
+            const mapped = mapToAuthorableTask(entry);
             if (!mapped)
                 continue;
+            // Runtime gate (W0073): every mapped task must satisfy the domain
+            // schema before it flows into the pipeline. Throws loudly on drift so
+            // a Studio document that strays from GeneralizedTaskDefinition
+            // surfaces at load time rather than corrupting downstream state.
+            const parsed = ContentLakeAuthorableTaskSchema.safeParse(mapped);
+            if (!parsed.success) {
+                const issues = parsed.error.issues
+                    .slice(0, 5)
+                    .map((i) => `  [${i.path.join(".")}]: ${i.message}`)
+                    .join("\n");
+                const more = parsed.error.issues.length > 5
+                    ? `\n  …and ${parsed.error.issues.length - 5} more issue(s)`
+                    : "";
+                throw new Error(`ContentLakeTaskSource: ailf.task "${mapped.id}" failed domain ` +
+                    `schema validation:\n${issues}${more}`);
+            }
             definitions.push(mapped);
         }
         if (definitions.length === 0 && !filter) {
@@ -115,14 +141,14 @@ function buildGroqParams(filter) {
 // Mapping: Content Lake → LiteracyTaskDefinition
 // ---------------------------------------------------------------------------
 /**
- * Map a Content Lake ailf.task document directly to a LiteracyTaskDefinition.
+ * Map a Content Lake ailf.task document to a `ContentLakeAuthorableTask`.
  *
  * Returns null if the document is missing required fields (taskId,
  * title, areaId, promptText). These are required by the
  * Studio schema, but defensive coding handles edge cases (drafts,
  * partially-created documents, etc.).
  */
-function mapToLiteracyTask(raw) {
+function mapToAuthorableTask(raw) {
     // Required fields — skip malformed documents
     if (!raw.taskId || !raw.title || !raw.areaId || !raw.promptText) {
         return null;
@@ -172,6 +198,8 @@ function mapToLiteracyTask(raw) {
         referenceSolution: "",
         ...(baseline ? { baseline } : {}),
         ...(raw.tags?.length ? { tags: raw.tags } : {}),
+        ...(raw.status ? { status: raw.status } : {}),
+        ...(raw.description ? { description: raw.description } : {}),
     };
 }
 /**

package/dist/adapters/task-sources/index.d.ts

@@ -1,6 +1,6 @@
 export { CompositeTaskSource } from "./composite-task-source.js";
 export { ContentLakeTaskSource } from "./content-lake-task-source.js";
-export { CanonicalTaskFileSchema, CanonicalTaskSchema, CURATED_ASSERTION_TYPES, detectLegacyFieldNames, parseCanonicalTaskFile, parseRepoConfig, RepoConfigSchema, RUBRIC_TEMPLATE_NAMES, type CanonicalTask, type CuratedAssertionType, type RepoConfig, type RubricTemplateName, } from "./repo-schemas.js";
+export { CanonicalTaskFileSchema, CanonicalTaskSchema, ContentLakeAuthorableTaskSchema, CURATED_ASSERTION_TYPES, detectLegacyFieldNames, parseCanonicalTaskFile, parseRepoConfig, RepoConfigSchema, RUBRIC_TEMPLATE_NAMES, type CanonicalTask, type ContentLakeAuthorableTaskParsed, type CuratedAssertionType, type RepoConfig, type RubricTemplateName, } from "./repo-schemas.js";
 export { RepoTaskSource } from "./repo-task-source.js";
 export { detectTriggerContext, resolveTrigger, type ResolvedTrigger, type TriggerContext, } from "./repo-trigger.js";
 export { formatValidationResult, validateCanonicalTasks, type ValidationMessage, type ValidationResult, } from "./repo-validation.js";

package/dist/adapters/task-sources/index.js

@@ -1,6 +1,6 @@
 export { CompositeTaskSource } from "./composite-task-source.js";
 export { ContentLakeTaskSource } from "./content-lake-task-source.js";
-export { CanonicalTaskFileSchema, CanonicalTaskSchema, CURATED_ASSERTION_TYPES, detectLegacyFieldNames, parseCanonicalTaskFile, parseRepoConfig, RepoConfigSchema, RUBRIC_TEMPLATE_NAMES, } from "./repo-schemas.js";
+export { CanonicalTaskFileSchema, CanonicalTaskSchema, ContentLakeAuthorableTaskSchema, CURATED_ASSERTION_TYPES, detectLegacyFieldNames, parseCanonicalTaskFile, parseRepoConfig, RepoConfigSchema, RUBRIC_TEMPLATE_NAMES, } from "./repo-schemas.js";
 export { RepoTaskSource } from "./repo-task-source.js";
 export { detectTriggerContext, resolveTrigger, } from "./repo-trigger.js";
 export { formatValidationResult, validateCanonicalTasks, } from "./repo-validation.js";