@sanity/ailf-studio 2.0.3 → 2.1.0

package/dist/index.d.ts

@@ -100,9 +100,9 @@ declare const RunTaskEvaluationAction: DocumentActionComponent;
 /**
  * structure.ts
  *
- * Structure helpers for the `ailf.task` document type. Exposes filtered
- * list views so editors see only active tasks by default and can toggle
- * into draft / paused / archived / all.
+ * Structure helpers for AILF document types. Exposes filtered list views so
+ * editors see only the documents they care about by default, with diagnostic
+ * sub-lists that surface routing/ownership gaps.
  *
  * ## Usage
  *
@@ -118,10 +118,13 @@ declare const RunTaskEvaluationAction: DocumentActionComponent;
  * })
  * ```
  *
- * `ailfStructure` renders a filtered "AILF Tasks" entry in place of the
- * default `ailf.task` list item and preserves every other document type
- * at its Studio default. Consumers who already maintain a custom
- * structure can splice just the list item in via `ailfTaskStructureItem`.
+ * `ailfStructure` renders filtered entries for `ailf.task`, `ailf.team`,
+ * `ailf.featureArea`, and `ailf.report` in place of their default Studio
+ * list items, plus a top-level diagnostic for teams whose channel events
+ * reference unknown event-type strings. Other document types are preserved
+ * at their Studio default via `S.documentTypeListItems().filter(...)`.
+ * Consumers who already maintain a custom structure can splice individual
+ * helpers in via the per-type exports.
  */
 
 /**
@@ -131,9 +134,10 @@ declare const RunTaskEvaluationAction: DocumentActionComponent;
  */
 declare function ailfTaskStructureItem(S: StructureBuilder): ReturnType<StructureBuilder["listItem"]>;
 /**
- * Full structure resolver that replaces the default `ailf.task` entry
- * with the filtered AILF Tasks item and keeps every other document
- * type list item at its Studio default.
+ * Full structure resolver that replaces the default entries for
+ * `ailf.task`, `ailf.team`, `ailf.featureArea`, and `ailf.report` with
+ * filtered AILF views, exposes a top-level unknown-events diagnostic,
+ * and keeps every other document type list item at its Studio default.
  */
 declare const ailfStructure: StructureResolver;
 
@@ -388,7 +392,7 @@ declare const scoreTimelineQuery: string;
  *
  * Used by: ReportDetail view
  */
-declare const reportDetailQuery = "\n  *[_type == \"ailf.report\" && reportId == $reportId][0] {\n    _id,\n    reportId,\n    completedAt,\n    durationMs,\n    tag,\n    title,\n    provenance,\n    summary,\n    \"comparison\": comparison {\n      areas,\n      deltas,\n      generatedAt,\n      improved,\n      mismatched,\n      noiseThreshold,\n      noiseThresholdEmpirical,\n      notEvaluated,\n      regressed,\n      unchanged\n    }\n  }\n";
+declare const reportDetailQuery = "\n  *[_type == \"ailf.report\" && reportId == $reportId][0] {\n    _id,\n    reportId,\n    completedAt,\n    durationMs,\n    tag,\n    title,\n    provenance,\n    \"teamDoc\": *[_type == \"ailf.team\" && slug.current == ^.provenance.owner.team][0]{\n      _id,\n      displayName,\n      status\n    },\n    summary,\n    \"comparison\": comparison {\n      areas,\n      deltas,\n      generatedAt,\n      improved,\n      mismatched,\n      noiseThreshold,\n      noiseThresholdEmpirical,\n      notEvaluated,\n      regressed,\n      unchanged\n    }\n  }\n";
 /**
  * Find all reports that evaluated a specific Sanity document or perspective.
  *
@@ -606,6 +610,35 @@ declare const taskSchema: {
     }, Record<string, unknown>> | undefined;
 };
 
+/**
+ * schema/team.ts
+ *
+ * Sanity document schema for `ailf.team` — a team that owns feature areas,
+ * repos, or task tags, and the notification channels used to route events
+ * to its members.
+ *
+ * The team entity is the routing target for the AILF notification system.
+ * A team owns members (people, identified by email / Sanity user id /
+ * GitHub username) and zero-or-more notification channels (Slack, email,
+ * webhook). Each channel carries a `scope` that says which events the
+ * channel cares about: the team's own areas/repos, all events, or a
+ * specific list of areas/repos/tags.
+ *
+ * Soft enums (member role, event type) are seeded from `@sanity/ailf-shared`
+ * but not closed — teams can introduce custom roles/events without a code
+ * change. The `options.list` provides suggestions; Sanity's `string` field
+ * doesn't enforce the list as a closed enum.
+ */
+declare const teamSchema: {
+    type: "document";
+    name: "ailf.team";
+} & Omit<sanity.DocumentDefinition, "preview"> & {
+    preview?: sanity.PreviewConfig<{
+        displayName: string;
+        slug: string;
+    }, Record<string, unknown>> | undefined;
+};
+
 /**
  * schema/webhook-config.ts
  *
@@ -812,6 +845,20 @@ interface ProvenanceData {
         workflow?: string;
     };
 }
+/**
+ * Resolved `ailf.team` document referenced by `provenance.owner.team`.
+ *
+ * Projected as a peer of `ownerTeam`/`provenance` in `latestReportsQuery`
+ * and `reportDetailQuery` so the dashboard can render the team's
+ * displayName and detect archived/missing teams without a second
+ * roundtrip. `null` when no team doc matches the owner slug (legacy
+ * reports, or a team that has not yet been seeded).
+ */
+interface TeamDocRef {
+    _id: string;
+    displayName: string;
+    status: "active" | "archived";
+}
 /** Shape returned by reportDetailQuery */
 interface ReportDetail {
     _id: string;
@@ -822,6 +869,8 @@ interface ReportDetail {
     reportId: string;
     summary: SummaryData;
     tag: null | string;
+    /** Resolved owner team document (T10) — null when no `ailf.team` doc matches. */
+    teamDoc?: TeamDocRef | null;
     title: null | string;
 }
 /** Shape returned by latestReportsQuery */
@@ -871,6 +920,8 @@ interface ReportListItem {
     scores: ScoreItem[];
     source: string;
     tag: null | string;
+    /** Resolved owner team document (T10) — null when no `ailf.team` doc matches. */
+    teamDoc?: TeamDocRef | null;
     title: null | string;
     /** Target document slugs (when evaluated with --changed-docs) */
     targetDocuments?: null | string[];
@@ -1179,4 +1230,4 @@ interface AilfPluginOptions {
  */
 declare const ailfPlugin: sanity.Plugin<void | AilfPluginOptions>;
 
-export { type AilfPluginOptions, ArchiveTaskAction, AssertionInput, CanonicalDocInput, type ComparisonData, type ContentImpactItem, GraduateToNativeAction, HelpDrawer, HelpProvider, MirrorBanner, type PerModelData, type ProvenanceData, ReleasePicker, type ReportDetail, type ReportListItem, RestoreTaskAction, type RunEvaluationActionOptions, RunTaskEvaluationAction, type ScoreItem, type SummaryData, SyncStatusBadge, type TimelineDataPoint, ailfPlugin, ailfStructure, ailfTaskStructureItem, ailfTool, articleSearchQuery, comparisonPairQuery, contentImpactQuery, createRunEvaluationAction, deriveHelpTopic, distinctAreasQuery, distinctModesQuery, distinctPerspectivesQuery, distinctSourcesQuery, distinctTargetDocumentsQuery, distinctTriggersQuery, evalRequestSchema, featureAreaSchema, findTopic, latestReportsQuery, recentDocumentEvalsQuery, referenceSolutionSchema, reportDetailQuery, reportSchema, scoreTimelineQuery, searchTopics, taskSchema, useHelp, webhookConfigSchema };
+export { type AilfPluginOptions, ArchiveTaskAction, AssertionInput, CanonicalDocInput, type ComparisonData, type ContentImpactItem, GraduateToNativeAction, HelpDrawer, HelpProvider, MirrorBanner, type PerModelData, type ProvenanceData, ReleasePicker, type ReportDetail, type ReportListItem, RestoreTaskAction, type RunEvaluationActionOptions, RunTaskEvaluationAction, type ScoreItem, type SummaryData, SyncStatusBadge, type TimelineDataPoint, ailfPlugin, ailfStructure, ailfTaskStructureItem, ailfTool, articleSearchQuery, comparisonPairQuery, contentImpactQuery, createRunEvaluationAction, deriveHelpTopic, distinctAreasQuery, distinctModesQuery, distinctPerspectivesQuery, distinctSourcesQuery, distinctTargetDocumentsQuery, distinctTriggersQuery, evalRequestSchema, featureAreaSchema, findTopic, latestReportsQuery, recentDocumentEvalsQuery, referenceSolutionSchema, reportDetailQuery, reportSchema, scoreTimelineQuery, searchTopics, taskSchema, teamSchema, useHelp, webhookConfigSchema };

package/dist/index.js

@@ -191,6 +191,17 @@ import {
   useProjectId
 } from "sanity";
 
+// ../shared/dist/event-types.js
+var KNOWN_EVENT_TYPES = [
+  "eval.failed",
+  "eval.completed",
+  "eval.threshold-breached",
+  "eval.score-regressed",
+  "task.created",
+  "task.archived",
+  "area.unowned-tasks"
+];
+
 // ../shared/dist/feature-flags.js
 var FEATURE_FLAGS = {
   showFailureModes: {
@@ -692,7 +703,7 @@ Click into any report for the full breakdown: per-area scores, diagnostics, and
   {
     "id": "weaknesses-recommendations",
     "title": "Weaknesses & Recommendations",
-    "body": "## Understanding weaknesses\n\nThe Issues sub-tab in Diagnostics lists every area or dimension that scored\nbelow threshold. Each weakness entry shows:\n\n- **The feature area** \u2014 Which product feature is affected (e.g., GROQ,\n  Functions, Webhooks).\n- **The bottleneck dimension** \u2014 Which scoring dimension is dragging the area\n  down: task completion, code correctness, or doc coverage.\n- **The score** \u2014 How far below threshold the dimension scored.\n\n## Gap analysis recommendations\n\nWhen an evaluation runs with gap analysis enabled, the dashboard shows\n**prioritized recommendations** \u2014 specific actions ranked by estimated impact.\n\nEach recommendation includes:\n\n- **Failure mode** \u2014 The type of doc problem identified:\n  - `missing-docs` \u2014 The functionality isn't documented at all.\n  - `incorrect-docs` \u2014 The docs contain factual errors.\n  - `outdated-docs` \u2014 The docs describe an old API version or pattern.\n  - `poor-structure` \u2014 The docs exist but are hard to find or understand.\n- **Estimated lift** \u2014 How many score points fixing this gap would add. Based on\n  raising the bottleneck dimension to the median of non-bottleneck dimensions.\n  Conservative estimate \u2014 actual improvement may be higher.\n- **Confidence** \u2014 How sure the analysis is about this diagnosis (high, medium,\n  or low).\n- **Affected tasks** \u2014 Which specific evaluation tasks exposed this gap.\n\n## Low-scoring judgments\n\nBelow the recommendations, you'll find the **grader's explanations** for tests\nthat scored below 70. These are the raw assessments from the grading model\nexplaining exactly what went wrong \u2014 missing API calls, incorrect patterns,\nhallucinated features, etc.\n\nEach judgment shows the task, the dimension, the score, and the grader's natural\nlanguage reason. These are the most granular diagnostic signal available and\noften point directly to the doc section that needs fixing.",
+    "body": "## Understanding weaknesses\n\nThe Issues sub-tab in Diagnostics lists every area or dimension that scored\nbelow threshold. Each weakness entry shows:\n\n- **The feature area** \u2014 Which product feature is affected (e.g., GROQ,\n  Functions, Webhooks).\n- **The bottleneck dimension** \u2014 Which scoring dimension is dragging the area\n  down: task completion, code correctness, or doc coverage.\n- **The score** \u2014 How far below threshold the dimension scored.\n\n## Gap analysis recommendations\n\nWhen an evaluation runs with gap analysis enabled, the dashboard shows\n**prioritized recommendations** \u2014 specific actions ranked by estimated impact.\n\nEach recommendation includes:\n\n- **Failure mode** \u2014 The type of doc problem identified:\n  - `missing-docs` \u2014 The functionality isn't documented at all.\n  - `incorrect-docs` \u2014 The docs contain factual errors.\n  - `outdated-docs` \u2014 The docs describe an old API version or pattern.\n  - `poor-structure` \u2014 The docs exist but are hard to find or understand.\n- **Estimated lift** \u2014 How many score points fixing this gap would add. Based on\n  raising the bottleneck dimension to the median of non-bottleneck dimensions.\n  Conservative estimate \u2014 actual improvement may be higher.\n- **Confidence** \u2014 How sure the analysis is about this diagnosis (high, medium,\n  or low).\n- **Affected tasks** \u2014 Which specific evaluation tasks exposed this gap.\n\n## Diagnosis cards\n\nEvery published report now carries a **diagnosis artifact** \u2014 a set of cards\nproduced by the post-pipeline hook (`ailf interpret`). The Studio diagnosis\npanel renders these cards directly; the dashboard's Recommendations and\nFailure-modes panels migrate to the same source in a follow-up.\n\nThe hook runs by default for every pipeline invocation. To opt out for a single\nrun, pass `--no-summary`; to opt out in CI, set `AILF_INTERPRET_ON_RUN=0` in the\nworkflow env block; to opt out project-wide, set `summary.onRun: never` in\n`.ailf/config.yaml`.\n\n## Low-scoring judgments\n\nBelow the recommendations, you'll find the **grader's explanations** for tests\nthat scored below 70. These are the raw assessments from the grading model\nexplaining exactly what went wrong \u2014 missing API calls, incorrect patterns,\nhallucinated features, etc.\n\nEach judgment shows the task, the dimension, the score, and the grader's natural\nlanguage reason. These are the most granular diagnostic signal available and\noften point directly to the doc section that needs fixing.",
     "source": "docs/help/weaknesses-recommendations.md",
     "related": [
       "interpreting-diagnostics",
@@ -732,6 +743,9 @@ Click into any report for the full breakdown: per-area scores, diagnostics, and
   }
 ];
 
+// ../shared/dist/member-roles.js
+var KNOWN_MEMBER_ROLES = ["lead", "member", "oncall"];
+
 // ../shared/dist/score-grades.js
 var GRADE_BOUNDARIES = {
   good: 80,
@@ -1142,6 +1156,14 @@ var evalRequestSchema = defineType({
       type: "string",
       validation: (rule) => rule.required()
     }),
+    defineField({
+      description: "ailf.job document id this request was dispatched to. Set by the webhook handler when GHA dispatch succeeds; the pipeline orchestrator reads it back to patch this doc on job terminal state.",
+      group: ["optional", "all-fields"],
+      name: "jobId",
+      readOnly: true,
+      title: "Job ID",
+      type: "string"
+    }),
     defineField({
       description: "Links to the resulting ailf.report document's reportId",
       group: ["optional", "all-fields"],
@@ -1194,7 +1216,6 @@ var evalRequestSchema = defineType({
       validation: (rule) => rule.required()
     })
   ],
-  liveEdit: true,
   name: "ailf.evalRequest",
   preview: {
     prepare({ status }) {
@@ -1253,6 +1274,14 @@ var featureAreaSchema = defineType2({
       of: [{ type: "string" }],
       title: "Tags",
       type: "array"
+    }),
+    defineField2({
+      description: "Primary team responsible for this area. Optional; unowned areas surface in a triage view.",
+      group: ["optional", "all-fields"],
+      name: "team",
+      title: "Owning Team",
+      to: [{ type: "ailf.team" }],
+      type: "reference"
     })
   ],
   name: "ailf.featureArea",
@@ -4005,16 +4034,381 @@ var taskSchema = defineType5({
   type: "document"
 });
 
-// src/schema/webhook-config.ts
-import { ALL_FIELDS_GROUP as ALL_FIELDS_GROUP6, defineField as defineField6, defineType as defineType6 } from "sanity";
-var webhookConfigSchema = defineType6({
+// src/schema/team.ts
+import {
+  ALL_FIELDS_GROUP as ALL_FIELDS_GROUP6,
+  defineArrayMember,
+  defineField as defineField6,
+  defineType as defineType6
+} from "sanity";
+var EVENT_TYPE_SUGGESTIONS = KNOWN_EVENT_TYPES.map((value) => ({
+  title: value,
+  value
+}));
+var MEMBER_ROLE_SUGGESTIONS = KNOWN_MEMBER_ROLES.map((value) => ({
+  title: value,
+  value
+}));
+var SCOPE_TYPES = [
+  { title: "Owned (areas + repos)", value: "owned" },
+  { title: "All events", value: "all" },
+  { title: "Specific areas", value: "areas" },
+  { title: "Specific repos", value: "repos" },
+  { title: "Specific tags", value: "tags" }
+];
+var channelScopeField = defineField6({
+  description: "Which events this channel cares about. 'Owned' uses the team's own areas + repos. 'All' receives every event. The remaining variants scope to a specific list of areas, repos, or tags.",
+  fields: [
+    defineField6({
+      description: "Scope discriminator",
+      name: "type",
+      options: {
+        layout: "radio",
+        list: [...SCOPE_TYPES]
+      },
+      title: "Scope Type",
+      type: "string",
+      validation: (rule) => rule.required()
+    }),
+    defineField6({
+      description: "Feature areas this channel listens to",
+      hidden: ({ parent }) => parent?.type !== "areas",
+      name: "areas",
+      of: [
+        defineArrayMember({
+          to: [{ type: "ailf.featureArea" }],
+          type: "reference"
+        })
+      ],
+      title: "Areas",
+      type: "array"
+    }),
+    defineField6({
+      description: "Repository identifiers this channel listens to",
+      hidden: ({ parent }) => parent?.type !== "repos",
+      name: "repos",
+      of: [defineArrayMember({ type: "string" })],
+      title: "Repos",
+      type: "array"
+    }),
+    defineField6({
+      description: "Task tags this channel listens to",
+      hidden: ({ parent }) => parent?.type !== "tags",
+      name: "tags",
+      of: [defineArrayMember({ type: "string" })],
+      title: "Tags",
+      type: "array"
+    })
+  ],
+  initialValue: { type: "owned" },
+  name: "scope",
+  title: "Scope",
+  type: "object"
+});
+var channelPurposeField = defineField6({
+  description: "Short human-readable label describing what this channel is used for (e.g. 'GROQ on-call', 'Visual editing weekly digest').",
+  name: "purpose",
+  title: "Purpose",
+  type: "string"
+});
+var channelEventsField = defineField6({
+  description: "Event types this channel receives. Suggestions come from the known event-type registry, but custom strings are accepted.",
+  name: "events",
+  of: [defineArrayMember({ type: "string" })],
+  options: {
+    layout: "tags",
+    list: EVENT_TYPE_SUGGESTIONS
+  },
+  title: "Events",
+  type: "array"
+});
+var teamMemberMember = defineArrayMember({
+  fields: [
+    defineField6({
+      description: "Email address (preferred routing identity)",
+      name: "email",
+      title: "Email",
+      type: "string",
+      validation: (rule) => rule.email()
+    }),
+    defineField6({
+      description: "Sanity user id (for Studio mentions / permissions)",
+      name: "sanityUserId",
+      title: "Sanity User ID",
+      type: "string"
+    }),
+    defineField6({
+      description: "GitHub username (for PR review routing)",
+      name: "githubUsername",
+      title: "GitHub Username",
+      type: "string"
+    }),
+    defineField6({
+      description: "Human-readable display name",
+      name: "displayName",
+      title: "Display Name",
+      type: "string"
+    }),
+    defineField6({
+      description: "Role within the team. Suggestions come from the known member-role registry, but custom roles are accepted.",
+      name: "role",
+      options: {
+        list: [...MEMBER_ROLE_SUGGESTIONS]
+      },
+      title: "Role",
+      type: "string"
+    }),
+    defineField6({
+      description: "When this member's identity was last verified",
+      name: "lastVerifiedAt",
+      title: "Last Verified At",
+      type: "datetime"
+    })
+  ],
+  name: "teamMember",
+  preview: {
+    prepare({
+      displayName,
+      email,
+      githubUsername,
+      role
+    }) {
+      const name = typeof displayName === "string" && displayName ? displayName : typeof email === "string" && email ? email : typeof githubUsername === "string" && githubUsername ? githubUsername : "(unnamed member)";
+      const handle = typeof email === "string" && email ? email : typeof githubUsername === "string" && githubUsername ? `@${githubUsername}` : "";
+      const subtitle = [typeof role === "string" ? role : "", handle].filter(Boolean).join(" \xB7 ");
+      return { subtitle, title: name };
+    },
+    select: {
+      displayName: "displayName",
+      email: "email",
+      githubUsername: "githubUsername",
+      role: "role"
+    }
+  },
+  title: "Team Member",
+  type: "object",
+  validation: (rule) => rule.custom((m) => {
+    const member = m;
+    if (!member) return true;
+    const hasIdentity = typeof member.email === "string" && member.email.length > 0 || typeof member.sanityUserId === "string" && member.sanityUserId.length > 0 || typeof member.githubUsername === "string" && member.githubUsername.length > 0;
+    return hasIdentity || "At least one of email, Sanity user id, or GitHub username is required";
+  })
+});
+var slackChannelMember = defineArrayMember({
+  fields: [
+    defineField6({
+      description: "Slack channel id (e.g. 'C01ABCDEF'). Must start with 'C' and contain only uppercase letters and digits.",
+      name: "channelId",
+      title: "Channel ID",
+      type: "string",
+      validation: (rule) => rule.required().custom((value) => {
+        if (typeof value !== "string") return "Channel id is required";
+        if (!/^C[A-Z0-9]+$/.test(value)) {
+          return "Must start with 'C' followed by uppercase letters and digits";
+        }
+        return true;
+      })
+    }),
+    defineField6({
+      description: "Human-readable channel name (e.g. '#groq-oncall')",
+      name: "channelName",
+      title: "Channel Name",
+      type: "string"
+    }),
+    channelPurposeField,
+    channelEventsField,
+    channelScopeField
+  ],
+  name: "slackChannel",
+  preview: {
+    prepare({ channelId, channelName, purpose }) {
+      const name = typeof channelName === "string" && channelName ? channelName : typeof channelId === "string" ? channelId : "(slack)";
+      return {
+        subtitle: typeof purpose === "string" && purpose ? purpose : "Slack channel",
+        title: name
+      };
+    },
+    select: {
+      channelId: "channelId",
+      channelName: "channelName",
+      purpose: "purpose"
+    }
+  },
+  title: "Slack Channel",
+  type: "object"
+});
+var emailChannelMember = defineArrayMember({
+  fields: [
+    defineField6({
+      description: "Email addresses that receive notifications on this channel",
+      name: "addresses",
+      of: [defineArrayMember({ type: "string" })],
+      title: "Addresses",
+      type: "array",
+      validation: (rule) => rule.min(1)
+    }),
+    channelPurposeField,
+    channelEventsField,
+    channelScopeField
+  ],
+  name: "emailChannel",
+  preview: {
+    prepare({ addresses, purpose }) {
+      const list = Array.isArray(addresses) ? addresses.filter((a) => typeof a === "string") : [];
+      const first = list[0] ?? "(email)";
+      const more = list.length > 1 ? ` (+${list.length - 1} more)` : "";
+      return {
+        subtitle: typeof purpose === "string" && purpose ? purpose : "Email channel",
+        title: `${first}${more}`
+      };
+    },
+    select: {
+      addresses: "addresses",
+      purpose: "purpose"
+    }
+  },
+  title: "Email Channel",
+  type: "object"
+});
+var webhookChannelMember = defineArrayMember({
+  fields: [
+    defineField6({
+      description: "Logical webhook name resolved at dispatch time. Do not paste raw URLs \u2014 the actual URL is configured outside Studio so secrets stay out of the Content Lake.",
+      name: "logicalName",
+      title: "Logical Name",
+      type: "string",
+      validation: (rule) => rule.required()
+    }),
+    channelPurposeField,
+    channelEventsField,
+    channelScopeField
+  ],
+  name: "webhookChannel",
+  preview: {
+    prepare({ logicalName, purpose }) {
+      return {
+        subtitle: typeof purpose === "string" && purpose ? purpose : "Webhook channel",
+        title: typeof logicalName === "string" && logicalName ? logicalName : "(webhook)"
+      };
+    },
+    select: {
+      logicalName: "logicalName",
+      purpose: "purpose"
+    }
+  },
+  title: "Webhook Channel",
+  type: "object"
+});
+var teamSchema = defineType6({
   groups: [
     { name: "main", title: "Main", default: true },
-    { name: "optional", title: "Optional" },
+    { name: "members", title: "Members" },
+    { name: "ownership", title: "Ownership" },
+    { name: "notifications", title: "Notifications" },
     ALL_FIELDS_GROUP6
   ],
   fields: [
     defineField6({
+      description: "Unique stable identifier (e.g. 'groq-team'). Lowercase alphanumeric with hyphens. Used for cross-document references and routing keys.",
+      group: ["main", "all-fields"],
+      name: "slug",
+      options: {
+        maxLength: 64,
+        source: "displayName"
+      },
+      title: "Slug",
+      type: "slug",
+      validation: (rule) => rule.required().custom((slug) => {
+        if (slug?.current && !/^[a-z0-9][a-z0-9-]*$/.test(slug.current)) {
+          return "Must be lowercase alphanumeric with hyphens (e.g. 'groq-team')";
+        }
+        return true;
+      })
+    }),
+    defineField6({
+      description: "Human-readable team name (e.g. 'GROQ Platform')",
+      group: ["main", "all-fields"],
+      name: "displayName",
+      title: "Display Name",
+      type: "string",
+      validation: (rule) => rule.required().min(1)
+    }),
+    defineField6({
+      description: "What this team owns and how they prefer to be contacted",
+      group: ["main", "all-fields"],
+      name: "description",
+      title: "Description",
+      type: "string"
+    }),
+    defineField6({
+      description: "Lifecycle status. Active teams receive routed notifications; archived teams are preserved for historical references but excluded from default routing.",
+      group: ["main", "all-fields"],
+      initialValue: "active",
+      name: "status",
+      options: {
+        list: [
+          { title: "Active", value: "active" },
+          { title: "Archived", value: "archived" }
+        ]
+      },
+      title: "Status",
+      type: "string",
+      validation: (rule) => rule.required()
+    }),
+    defineField6({
+      description: "People on this team. Each member needs at least one of email, Sanity user id, or GitHub username so the routing layer can resolve them to a real account.",
+      group: ["members", "all-fields"],
+      name: "members",
+      of: [teamMemberMember],
+      title: "Members",
+      type: "array",
+      validation: (rule) => rule.required().min(1)
+    }),
+    defineField6({
+      description: "Repository identifiers this team owns (e.g. 'sanity-io/sanity'). Used by channel scope 'owned' and 'repos'.",
+      group: ["ownership", "all-fields"],
+      name: "repos",
+      of: [defineArrayMember({ type: "string" })],
+      title: "Repos",
+      type: "array"
+    }),
+    defineField6({
+      description: "Notification channels for this team. Each channel carries its own purpose, event subscriptions, and scope.",
+      group: ["notifications", "all-fields"],
+      name: "notifications",
+      of: [slackChannelMember, emailChannelMember, webhookChannelMember],
+      title: "Notification Channels",
+      type: "array"
+    })
+  ],
+  name: "ailf.team",
+  preview: {
+    prepare({ displayName, slug }) {
+      const slugCurrent = slug !== null && typeof slug === "object" && "current" in slug ? slug.current : void 0;
+      return {
+        subtitle: typeof slugCurrent === "string" ? slugCurrent : "",
+        title: typeof displayName === "string" && displayName ? displayName : "Team"
+      };
+    },
+    select: {
+      displayName: "displayName",
+      slug: "slug"
+    }
+  },
+  title: "AILF Team",
+  type: "document"
+});
+
+// src/schema/webhook-config.ts
+import { ALL_FIELDS_GROUP as ALL_FIELDS_GROUP7, defineField as defineField7, defineType as defineType7 } from "sanity";
+var webhookConfigSchema = defineType7({
+  groups: [
+    { name: "main", title: "Main", default: true },
+    { name: "optional", title: "Optional" },
+    ALL_FIELDS_GROUP7
+  ],
+  fields: [
+    defineField7({
       description: "When enabled, publishing articles will automatically trigger AI Literacy evaluations for affected feature areas.",
       group: ["main", "all-fields"],
       initialValue: false,
@@ -4022,7 +4416,7 @@ var webhookConfigSchema = defineType6({
       title: "Evaluate on Publish",
       type: "boolean"
     }),
-    defineField6({
+    defineField7({
       description: "Which evaluation mode to use for webhook-triggered evaluations.",
       group: ["main", "all-fields"],
       initialValue: "baseline",
@@ -4038,7 +4432,7 @@ var webhookConfigSchema = defineType6({
       title: "Evaluation Mode",
       type: "string"
     }),
-    defineField6({
+    defineField7({
       description: "Maximum evaluations per day. Prevents runaway costs from rapid editing.",
       group: ["main", "all-fields"],
       initialValue: 20,
@@ -4047,7 +4441,7 @@ var webhookConfigSchema = defineType6({
       type: "number",
       validation: (rule) => rule.min(1).max(100)
     }),
-    defineField6({
+    defineField7({
       description: "Seconds to wait after the last edit before dispatching. Coalesces rapid edits into a single evaluation.",
       group: ["optional", "all-fields"],
       initialValue: 300,
@@ -4056,7 +4450,7 @@ var webhookConfigSchema = defineType6({
       type: "number",
       validation: (rule) => rule.min(10).max(3600)
     }),
-    defineField6({
+    defineField7({
       description: "Specific feature areas to evaluate. Leave empty to evaluate all affected areas automatically.",
       group: ["optional", "all-fields"],
       name: "areas",
@@ -4064,7 +4458,7 @@ var webhookConfigSchema = defineType6({
       title: "Area Filter",
       type: "array"
     }),
-    defineField6({
+    defineField7({
       description: "Slack webhook URL for notifications about webhook-triggered evaluations.",
       group: ["optional", "all-fields"],
       name: "notifySlack",
@@ -4835,6 +5229,11 @@ var latestReportsQuery = (
     "trigger": provenance.trigger.type,
     "classification": provenance.classification,
     "ownerTeam": provenance.owner.team,
+    "teamDoc": *[_type == "ailf.team" && slug.current == ^.provenance.owner.team][0]{
+      _id,
+      displayName,
+      status
+    },
     "ownerIndividual": provenance.owner.individual,
     "executorType": provenance.executor.type,
     "executorName": provenance.executor.name,
@@ -4917,6 +5316,11 @@ var reportDetailQuery = (
     tag,
     title,
     provenance,
+    "teamDoc": *[_type == "ailf.team" && slug.current == ^.provenance.owner.team][0]{
+      _id,
+      displayName,
+      status
+    },
     summary,
     "comparison": comparison {
       areas,
@@ -15331,7 +15735,7 @@ function ailfTool(options = {}) {
 }
 
 // src/structure.ts
-import { ArchiveIcon as ArchiveIcon2, TaskIcon } from "@sanity/icons";
+import { ArchiveIcon as ArchiveIcon2, TaskIcon, WarningOutlineIcon as WarningOutlineIcon5 } from "@sanity/icons";
 function ailfTaskStructureItem(S) {
   return S.listItem().id("ailfTasks").title("AILF Tasks").icon(TaskIcon).child(
     S.list().id("ailfTasksViews").title("AILF Tasks").items([
@@ -15354,12 +15758,68 @@ function ailfTaskStructureItem(S) {
     ])
   );
 }
+function ailfTeamsStructureItem(S) {
+  return S.listItem().id("ailfTeams").title("Teams").child(
+    S.list().id("ailfTeamsViews").title("Teams").items([
+      S.listItem().id("activeTeams").title("Active teams").child(
+        S.documentTypeList("ailf.team").id("ailfTeamsActive").title("Active teams").apiVersion(API_VERSION).filter('_type == "ailf.team" && status == "active"')
+      ),
+      S.listItem().id("archivedTeams").title("Archived teams").icon(ArchiveIcon2).child(
+        S.documentTypeList("ailf.team").id("ailfTeamsArchived").title("Archived teams").apiVersion(API_VERSION).filter('_type == "ailf.team" && status == "archived"')
+      ),
+      S.divider(),
+      S.listItem().id("allTeams").title("All teams").child(
+        S.documentTypeList("ailf.team").id("ailfTeamsAll").title("All teams")
+      )
+    ])
+  );
+}
+function ailfAreasStructureItem(S) {
+  return S.listItem().id("ailfAreas").title("Areas").child(
+    S.list().id("ailfAreasViews").title("Areas").items([
+      S.listItem().id("allAreas").title("All areas").child(
+        S.documentTypeList("ailf.featureArea").id("ailfAreasAll").title("All areas")
+      ),
+      S.divider(),
+      S.listItem().id("unownedAreas").title("\u26A0 Unowned areas").icon(WarningOutlineIcon5).child(
+        S.documentTypeList("ailf.featureArea").id("ailfAreasUnowned").title("\u26A0 Unowned areas").apiVersion(API_VERSION).filter('_type == "ailf.featureArea" && !defined(team)')
+      )
+    ])
+  );
+}
+function ailfReportsStructureItem(S) {
+  return S.listItem().id("ailfReports").title("Reports").child(
+    S.list().id("ailfReportsViews").title("Reports").items([
+      S.listItem().id("allReports").title("All reports").child(
+        S.documentTypeList("ailf.report").id("ailfReportsAll").title("All reports")
+      ),
+      S.divider(),
+      S.listItem().id("unresolvedTeamReports").title("\u26A0 Reports with unresolved team").icon(WarningOutlineIcon5).child(
+        S.documentList().id("ailfReportsUnresolvedTeam").title("\u26A0 Reports with unresolved team").apiVersion(API_VERSION).filter(
+          `_type == "ailf.report" && defined(provenance.owner.team) && provenance.owner.team != "unknown" && !(provenance.owner.team in *[_type == "ailf.team"].slug.current)`
+        )
+      )
+    ])
+  );
+}
+function ailfChannelsWithUnknownEventsItem(S) {
+  return S.listItem().id("ailfChannelsUnknownEvents").title("\u26A0 Channels with unknown events").icon(WarningOutlineIcon5).child(
+    S.documentList().id("ailfChannelsUnknownEventsList").title("Teams whose channels reference unknown event types").apiVersion(API_VERSION).filter(
+      `_type == "ailf.team" && count(notifications[count(events[!(@ in $known)]) > 0]) > 0`
+    ).params({ known: [...KNOWN_EVENT_TYPES] })
+  );
+}
 var ailfStructure = (S) => S.list().id("root").title("Content").items([
   ailfTaskStructureItem(S),
+  ailfTeamsStructureItem(S),
+  ailfAreasStructureItem(S),
+  ailfReportsStructureItem(S),
+  ailfChannelsWithUnknownEventsItem(S),
   S.divider(),
-  ...S.documentTypeListItems().filter(
-    (listItem) => listItem.getId() !== "ailf.task"
-  )
+  ...S.documentTypeListItems().filter((listItem) => {
+    const id = listItem.getId();
+    return id !== "ailf.task" && id !== "ailf.team" && id !== "ailf.featureArea" && id !== "ailf.report";
+  })
 ]);
 
 // src/actions/RunEvaluationAction.tsx
@@ -15647,6 +16107,7 @@ var ailfPlugin = definePlugin((options) => ({
       referenceSolutionSchema,
       reportSchema,
       taskSchema,
+      teamSchema,
       webhookConfigSchema
     ]
   },
@@ -15690,6 +16151,7 @@ export {
   scoreTimelineQuery,
   searchTopics,
   taskSchema,
+  teamSchema,
   useHelp,
   webhookConfigSchema
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/ailf-studio",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "AI Literacy Framework — Sanity Studio dashboard plugin",
   "type": "module",
   "license": "MIT",
@@ -45,6 +45,7 @@
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.0.0",
+    "groq-js": "^1.30.1",
     "jsdom": "^29.0.2",
     "react": "^19.0.0",
     "sanity": "^5.14.0",
@@ -52,8 +53,8 @@
     "tsx": "^4.19.0",
     "typescript": "5.9.3",
     "vitest": "^4.1.5",
-    "@sanity/ailf-shared": "0.1.0",
-    "@sanity/ailf-core": "0.1.0"
+    "@sanity/ailf-core": "0.1.0",
+    "@sanity/ailf-shared": "0.1.0"
   },
   "dependencies": {
     "prism-react-renderer": "^2.4.0",
@@ -69,9 +70,11 @@
   "scripts": {
     "generate-hooks": "tsx scripts/generate-hooks.ts",
     "migrate-to-private-dataset": "tsx scripts/migrate-to-private-dataset.ts",
+    "seed-teams": "tsx scripts/seed-teams.ts",
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "bench": "vitest bench --run"
   }
 }