@skillcdn/console 0.1.9 → 0.1.10

package/src/index.ts

@@ -4,7 +4,24 @@
 // a script that wants none of the pages. The styles are `@skillcdn/console/console.css`.
 
 export * from "./api.js";
-export { Board, type BoardProps, TaskCard } from "./components/board.js";
+export {
+  Board,
+  BoardFilters,
+  type BoardFiltersProps,
+  type BoardProps,
+  byDue,
+  filterTasks,
+  TaskCard,
+} from "./components/board.js";
+export {
+  Calendar,
+  type CalendarProps,
+  Workload,
+  type WorkloadProps,
+  type WorkloadRow,
+  workloadOf,
+} from "./components/calendar.js";
+export { CategoryList, type CategoryListProps } from "./components/categories.js";
 export {
   ConnectApproval,
   type ConnectApprovalProps,
@@ -19,6 +36,8 @@ export {
   type DecisionCardProps,
   DecisionList,
   type DecisionListProps,
+  DecisionLog,
+  type DecisionLogProps,
 } from "./components/decision-list.js";
 export {
   DocumentCrumbs,
@@ -36,6 +55,14 @@ export {
   type FolderViewProps,
 } from "./components/documents.js";
 export { describeEvent, EventFeed, type EventFeedProps } from "./components/event-feed.js";
+export {
+  GoalForm,
+  type GoalFormProps,
+  GoalList,
+  type GoalListProps,
+  GoalView,
+  type GoalViewProps,
+} from "./components/goals.js";
 export { Markdown, type MarkdownProps } from "./components/markdown.js";
 export { PeopleList, type PeopleListProps } from "./components/people.js";
 export {
@@ -69,6 +96,7 @@ export {
 export { SignIn, type SignInProps } from "./components/sign-in.js";
 export { SkillList, type SkillListProps } from "./components/skills.js";
 export { TaskForm, type TaskFormProps } from "./components/task-form.js";
+export { TaskList, type TaskListProps } from "./components/task-list.js";
 export { TaskView, type TaskViewProps } from "./components/task-view.js";
 export {
   NewToken,
@@ -83,13 +111,18 @@ export {
   Badge,
   Button,
   Callout,
+  CategoryBadge,
   cx,
+  Day,
+  DueBadge,
   EmptyState,
   formatBytes,
   formatInstant,
+  GoalStateBadge,
   PersonChip,
   PRIORITY_LABELS,
   PriorityBadge,
+  ProgressBar,
   ROLE_LABELS,
   RoleBadge,
   Spinner,
@@ -97,6 +130,7 @@ export {
   StateBadge,
   Time,
 } from "./components/ui.js";
+export { WorkList, type WorkListProps } from "./components/work.js";
 export { ConnectPage, type ConnectPageProps } from "./connect-page.js";
 export {
   type ConsoleApp,
@@ -106,6 +140,24 @@ export {
   DEFAULT_COMPONENTS,
 } from "./console.js";
 export { type ConsoleActions, type ConsoleData, useConsoleData } from "./data.js";
+export {
+  addDays,
+  addMonths,
+  dateOf,
+  dayOf,
+  daysBetween,
+  firstDayOfWeek,
+  formatDay,
+  formatMonth,
+  formatWeekday,
+  type GridDay,
+  isDay,
+  isMonth,
+  monthGrid,
+  monthOf,
+  today,
+  weekdays,
+} from "./dates.js";
 export { DocsPage, type DocsPageProps } from "./docs-page.js";
 export {
   chooseLanguage,
@@ -120,14 +172,19 @@ export {
   useWords,
 } from "./i18n/index.js";
 export {
+  type BoardFilter,
+  boardHref,
+  calendarHref,
   connectHref,
   type DocsView,
   decisionHref,
   docHref,
+  goalHref,
   matchRoute,
   movedFrom,
   type Navigation,
   newDecisionHref,
+  newGoalHref,
   newTaskHref,
   PATHS,
   type ProjectPage,

package/src/limits.ts

@@ -59,3 +59,8 @@ export const MAX_VERSIONS_PER_DOCUMENT = 500;
 export const MAX_FILES_PER_DOCUMENT = 50;
 /** The words a search of the documents takes. */
 export const MAX_SEARCH_LENGTH = 200;
+/** A category of tasks (ADR-0019): its key, what the command and filters say, and its name. */
+export const MAX_CATEGORY_KEY_LENGTH = 40;
+export const MAX_CATEGORY_NAME_LENGTH = 60;
+/** How many categories one workspace may have: a vocabulary, not a tag cloud. */
+export const MAX_CATEGORIES = 50;

package/src/router.ts

@@ -1,10 +1,12 @@
 import { isFolderPath, isSignInFailure, SIGN_IN_PARAM, type SignInFailure } from "./api.js";
+import { isMonth } from "./dates.js";
 
 // The addresses of the default console (ADR-0010): the router is a function from a URL to a
 // route, and the hrefs below are its inverse. A project's pages live under `/projects/<key>`,
 // the word the REST API uses; an address names what it shows (a task by its number, a decision
-// by its id, a document by its path), every form has one, and the query says how a page is
-// shown (`?edit`, `?ask`, `?new`, `?version=`, `?q=`). The old addresses are taken to the new.
+// by its id, a document by its path, a goal by its id), every form has one, and the query says
+// how a page is shown (`?edit`, `?ask`, `?new`, `?version=`, `?q=`, `?month=`, and the board's
+// filters). The old addresses are taken to the new.
 
 /** How a task's page is shown: as it is, or with one of its forms open. */
 export type TaskFormKind = "edit" | "ask";
@@ -16,10 +18,22 @@ export type DocsView =
   | { readonly kind: "edit" }
   | { readonly kind: "search"; readonly q: string };
 
+/**
+ * What the board is narrowed to (ADR-0019), from the query: a category by its key (`""` for
+ * the tasks with none), a goal by its id (`""` for the tasks with none), a person by their id,
+ * or the person's own.
+ */
+export interface BoardFilter {
+  readonly category?: string | undefined;
+  readonly goal?: string | undefined;
+  readonly person?: string | undefined;
+  readonly mine?: boolean | undefined;
+}
+
 export type Route =
   | { readonly name: "projects" }
   | { readonly name: "new-project" }
-  | { readonly name: "board"; readonly project: string }
+  | { readonly name: "board"; readonly project: string; readonly filter: BoardFilter }
   | { readonly name: "new-task"; readonly project: string }
   | {
       readonly name: "task";
@@ -38,6 +52,16 @@ export type Route =
   | { readonly name: "decisions"; readonly project: string }
   | { readonly name: "new-decision"; readonly project: string }
   | { readonly name: "decision"; readonly project: string; readonly id: string }
+  /** The calendar of a project: the month shown, or this one when the address names none. */
+  | { readonly name: "calendar"; readonly project: string; readonly month: string | undefined }
+  | { readonly name: "roadmap"; readonly project: string }
+  | { readonly name: "new-goal"; readonly project: string }
+  | {
+      readonly name: "goal";
+      readonly project: string;
+      readonly id: string;
+      readonly form: "edit" | undefined;
+    }
   | { readonly name: "feed"; readonly project: string }
   | { readonly name: "skills"; readonly project: string }
   | { readonly name: "members"; readonly project: string }
@@ -47,6 +71,10 @@ export type Route =
   | { readonly name: "person-agents"; readonly id: string }
   | { readonly name: "agents" }
   | { readonly name: "new-token" }
+  /** What is on the person's plate across their projects. */
+  | { readonly name: "work" }
+  /** The categories tasks are sorted into; an administrator keeps them here. */
+  | { readonly name: "categories" }
   /** Where a person approves an agent's connection, by the code it showed, or types one. */
   | { readonly name: "connect"; readonly code: string | undefined }
   /** An address that moved: the page takes the person to `to` in its place. */
@@ -54,7 +82,15 @@ export type Route =
   | { readonly name: "not-found" };
 
 /** The pages of a project, after its key. */
-export type ProjectPage = "docs" | "decisions" | "feed" | "skills" | "members" | "settings";
+export type ProjectPage =
+  | "docs"
+  | "decisions"
+  | "calendar"
+  | "roadmap"
+  | "feed"
+  | "skills"
+  | "members"
+  | "settings";
 
 export const PATHS = {
   /** The projects the person may see: the front page. */
@@ -62,11 +98,15 @@ export const PATHS = {
   /** Where a project's pages are: `/projects/<key>`, then the page. */
   project: "/projects",
   newProject: "/projects/new",
+  /** What is on the person's plate, across the projects they may see. */
+  work: "/work",
   people: "/people",
   /** The agents of whoever is signed in, which hold their tokens: their own page. */
   agents: "/agents",
   /** The form for a token made by hand, for a script or a console of one's own. */
   newToken: "/agents/new",
+  /** The categories tasks are sorted into, kept by an administrator. */
+  categories: "/categories",
   /** Where an agent's connection is approved (ADR-0011): `/connect/<code>`, or the code typed. */
   connect: "/connect",
 } as const;
@@ -77,7 +117,7 @@ const NUMBER = /^[1-9][0-9]{0,8}$/;
 /** A code as it may be typed into an address: checked for what it is by the page. */
 const CODE_TEXT = /^[A-Za-z0-9-]{1,16}$/;
 /** The pages of a project that take nothing after their name. */
-const PLAIN_PAGES: readonly Exclude<ProjectPage, "docs">[] = [
+const PLAIN_PAGES: readonly Exclude<ProjectPage, "docs" | "calendar" | "roadmap">[] = [
   "decisions",
   "feed",
   "skills",
@@ -103,6 +143,19 @@ export function movedFrom(pathname: string): string | undefined {
 const taskFormOf = (params: URLSearchParams): TaskFormKind | undefined =>
   params.has("edit") ? "edit" : params.has("ask") ? "ask" : undefined;
 
+/** The board's filters, as the query names them; a value that is not one is left out. */
+const boardFilterOf = (params: URLSearchParams): BoardFilter => {
+  const category = params.get("category");
+  const goal = params.get("goal");
+  const person = params.get("person");
+  return {
+    ...(category !== null && (category === "" || PROJECT_KEY.test(category)) ? { category } : {}),
+    ...(goal !== null && (goal === "" || UUID.test(goal)) ? { goal } : {}),
+    ...(person !== null && UUID.test(person) ? { person } : {}),
+    ...(params.has("mine") ? { mine: true } : {}),
+  };
+};
+
 /** The view the query asks for at a path, or nothing for one the path cannot be shown as. */
 const docsViewOf = (params: URLSearchParams, path: string): DocsView | undefined => {
   const q = params.get("q");
@@ -137,6 +190,9 @@ export function matchRoute(pathname: string, search = ""): Route {
   if (path === PATHS.newProject) {
     return { name: "new-project" };
   }
+  if (path === PATHS.work) {
+    return { name: "work" };
+  }
   if (path === PATHS.people) {
     return { name: "people" };
   }
@@ -146,6 +202,9 @@ export function matchRoute(pathname: string, search = ""): Route {
   if (path === PATHS.newToken) {
     return { name: "new-token" };
   }
+  if (path === PATHS.categories) {
+    return { name: "categories" };
+  }
   if (path === PATHS.connect) {
     return { name: "connect", code: undefined };
   }
@@ -167,7 +226,7 @@ export function matchRoute(pathname: string, search = ""): Route {
     return NOT_FOUND;
   }
   if (page === undefined) {
-    return { name: "board", project };
+    return { name: "board", project, filter: boardFilterOf(params) };
   }
   if (page === "docs") {
     // The rest of the path is the document's, or a folder's, or nothing for the root.
@@ -205,9 +264,27 @@ export function matchRoute(pathname: string, search = ""): Route {
     }
     return UUID.test(third) ? { name: "decision", project, id: third } : NOT_FOUND;
   }
+  if (page === "roadmap" && third !== undefined) {
+    if (third === "new") {
+      return { name: "new-goal", project };
+    }
+    return UUID.test(third)
+      ? { name: "goal", project, id: third, form: params.has("edit") ? "edit" : undefined }
+      : NOT_FOUND;
+  }
   if (third !== undefined) {
     return NOT_FOUND;
   }
+  if (page === "calendar") {
+    const month = params.get("month");
+    if (month !== null && !isMonth(month)) {
+      return NOT_FOUND;
+    }
+    return { name: "calendar", project, month: month ?? undefined };
+  }
+  if (page === "roadmap") {
+    return { name: "roadmap", project };
+  }
   const found = PLAIN_PAGES.find((candidate) => candidate === page);
   return found === undefined ? NOT_FOUND : { name: found, project };
 }
@@ -228,6 +305,25 @@ export function projectHref(key: string, page?: ProjectPage): string {
   return page === undefined ? base : `${base}/${page}`;
 }
 
+/** Where a project's board is, narrowed as the filter says; the plain board for an empty one. */
+export function boardHref(key: string, filter: BoardFilter = {}): string {
+  const parts: string[] = [];
+  // An empty value means "none": it keeps its sign; "mine" is a flag and has no value.
+  if (filter.category !== undefined) {
+    parts.push(`category=${encodeURIComponent(filter.category)}`);
+  }
+  if (filter.goal !== undefined) {
+    parts.push(`goal=${encodeURIComponent(filter.goal)}`);
+  }
+  if (filter.person !== undefined) {
+    parts.push(`person=${encodeURIComponent(filter.person)}`);
+  }
+  if (filter.mine === true) {
+    parts.push("mine");
+  }
+  return parts.length === 0 ? projectHref(key) : `${projectHref(key)}?${parts.join("&")}`;
+}
+
 /** Where a task is written: the form. */
 export function newTaskHref(key: string): string {
   return `${PATHS.project}/${key}/tasks/new`;
@@ -249,6 +345,23 @@ export function decisionHref(key: string, id: string): string {
   return `${PATHS.project}/${key}/decisions/${id}`;
 }
 
+/** Where a project's calendar is, on a month, or on this one when none is named. */
+export function calendarHref(key: string, month?: string): string {
+  const base = projectHref(key, "calendar");
+  return month === undefined ? base : `${base}?month=${month}`;
+}
+
+/** Where a goal is set: the form. */
+export function newGoalHref(key: string): string {
+  return `${PATHS.project}/${key}/roadmap/new`;
+}
+
+/** Where one goal is read, or changed. */
+export function goalHref(key: string, id: string, form?: "edit"): string {
+  const base = `${PATHS.project}/${key}/roadmap/${id}`;
+  return form === undefined ? base : `${base}?${form}`;
+}
+
 /**
  * Where a document of a project is read, or a folder of them listed (`""` for the root), and
  * how: a form, a version, or a search over all of them.

package/src/routes.ts

@@ -17,8 +17,17 @@ export const REST_ROUTES = {
   tokens: "/api/v1/tokens",
   /** Connecting an agent (ADR-0011): begun as nobody, approved by a person, claimed by the command. */
   connect: "/api/v1/connect",
+  /** The categories tasks are sorted into (ADR-0019): the workspace's vocabulary, kept by an administrator. */
+  categories: "/api/v1/categories",
+  /** What is on the asker's plate across the projects they may see: their open tasks, and the decisions waiting. */
+  work: "/api/v1/work",
 } as const;
 
+/** The REST path of one category, by its key. */
+export function categoryPath(key: string): string {
+  return `${REST_ROUTES.categories}/${encodeURIComponent(key)}`;
+}
+
 /** Where the command claims the token of a connection, with its secret. */
 export const CLAIM_PATH = `${REST_ROUTES.connect}/claim`;
 
@@ -44,6 +53,7 @@ export const PROJECT_COLLECTIONS = [
   "skills",
   "members",
   "docs",
+  "goals",
 ] as const;
 
 export type ProjectCollection = (typeof PROJECT_COLLECTIONS)[number];

package/src/schemas.ts

@@ -7,6 +7,8 @@ import { isDocumentPath } from "./documents.js";
 import {
   MAX_AGENT_LENGTH,
   MAX_BODY_LENGTH,
+  MAX_CATEGORY_KEY_LENGTH,
+  MAX_CATEGORY_NAME_LENGTH,
   MAX_DOCUMENT_LENGTH,
   MAX_DOCUMENT_PATH_LENGTH,
   MAX_FILE_NAME_LENGTH,
@@ -32,7 +34,9 @@ import {
 import { hasForbiddenCodePoint } from "./text.js";
 import {
   ARTIFACT_KINDS,
+  CATEGORY_COLORS,
   EVENT_KINDS,
+  GOAL_STATES,
   LINK_SOURCES,
   PERSON_ROLES,
   PROJECT_ROLES,
@@ -70,6 +74,8 @@ const url = z.string().check(z.trim(), z.maxLength(MAX_URL_LENGTH), z.url({ prot
 const uuid = z.uuid();
 /** An ISO 8601 instant, as the server writes it. */
 const instant = z.iso.datetime();
+/** A calendar day (`2026-10-20`): a plan is made in days, wherever the people are (ADR-0019). */
+const day = z.iso.date();
 const count = z.int().check(z.nonnegative());
 
 /** A person of the workspace, as the pages show them. Nothing here is a secret. */
@@ -230,6 +236,48 @@ export const restTaskLinkSchema = z.object({
 });
 export type RestTaskLink = z.infer<typeof restTaskLinkSchema>;
 
+/**
+ * A category's key: what the command and the filters say, as a project's key is. Lowercase
+ * letters, digits and hyphens; immutable once the category is made.
+ */
+const categoryKey = z
+  .string()
+  .check(
+    z.maxLength(MAX_CATEGORY_KEY_LENGTH),
+    z.regex(/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/, "must be lowercase letters, digits and hyphens"),
+  );
+
+/** A category tasks are sorted into (ADR-0019): the workspace's own word for a kind of work. */
+export const restCategorySchema = z.object({
+  key: categoryKey,
+  name: z.string(),
+  /** One of the names the pages paint a category in. */
+  color: z.enum(CATEGORY_COLORS),
+  createdAt: instant,
+  updatedAt: instant,
+});
+export type RestCategory = z.infer<typeof restCategorySchema>;
+
+/** `GET /api/v1/categories`: the workspace's categories, by name. */
+export const restCategoriesSchema = z.object({ items: z.array(restCategorySchema) });
+export type RestCategories = z.infer<typeof restCategoriesSchema>;
+
+/** What `POST /api/v1/categories` is sent, by an administrator: the key, the name, and a colour or the plain one. */
+export const restCategoryInputSchema = z.object({
+  key: categoryKey,
+  name: line(MAX_CATEGORY_NAME_LENGTH),
+  /** Left out: `gray`. */
+  color: z.optional(z.enum(CATEGORY_COLORS)),
+});
+export type RestCategoryInput = z.infer<typeof restCategoryInputSchema>;
+
+/** What `PATCH /api/v1/categories/<key>` is sent: only what changes; the key does not. */
+export const restCategoryPatchSchema = z.object({
+  name: z.optional(line(MAX_CATEGORY_NAME_LENGTH)),
+  color: z.optional(z.enum(CATEGORY_COLORS)),
+});
+export type RestCategoryPatch = z.infer<typeof restCategoryPatchSchema>;
+
 export const restTaskSchema = z.object({
   id: uuid,
   /** The task's number in its project, the one people say out loud. */
@@ -243,6 +291,18 @@ export const restTaskSchema = z.object({
   assignee: z.nullable(restPersonSchema),
   /** The task this one is part of, or `null`. */
   parentId: z.nullable(uuid),
+  /** The category the task is sorted into, as the workspace keeps it, or `null`. */
+  category: z.nullable(
+    z.object({ key: z.string(), name: z.string(), color: z.enum(CATEGORY_COLORS) }),
+  ),
+  /** The goal of the project's roadmap the task works towards, or `null`. */
+  goalId: z.nullable(uuid),
+  /** The plan (ADR-0019): the day the work is meant to begin, and the day it is due, each or `null`. */
+  startsOn: z.nullable(day),
+  dueOn: z.nullable(day),
+  /** What happened: when the task was first moved past ready, and when it was moved to done; each or `null`. The board keeps both. */
+  startedAt: z.nullable(instant),
+  doneAt: z.nullable(instant),
   links: z.array(restTaskLinkSchema),
   /** How many decisions about this task wait for a person. */
   openDecisions: count,
@@ -270,6 +330,13 @@ export const restTaskInputSchema = z.object({
   priority: z.optional(z.enum(TASK_PRIORITIES)),
   assigneeId: z.optional(z.nullable(uuid)),
   parentId: z.optional(z.nullable(uuid)),
+  /** The key of a category of the workspace, or `null` for none. */
+  category: z.optional(z.nullable(categoryKey)),
+  /** A goal of the project, or `null` for none. */
+  goalId: z.optional(z.nullable(uuid)),
+  /** The plan, in days; the due day is not before the start. */
+  startsOn: z.optional(z.nullable(day)),
+  dueOn: z.optional(z.nullable(day)),
   links: z.optional(z.array(taskLinkInput).check(z.maxLength(MAX_LINKS))),
 });
 export type RestTaskInput = z.infer<typeof restTaskInputSchema>;
@@ -282,10 +349,68 @@ export const restTaskPatchSchema = z.object({
   priority: z.optional(z.enum(TASK_PRIORITIES)),
   assigneeId: z.optional(z.nullable(uuid)),
   parentId: z.optional(z.nullable(uuid)),
+  category: z.optional(z.nullable(categoryKey)),
+  goalId: z.optional(z.nullable(uuid)),
+  startsOn: z.optional(z.nullable(day)),
+  dueOn: z.optional(z.nullable(day)),
   links: z.optional(z.array(taskLinkInput).check(z.maxLength(MAX_LINKS))),
 });
 export type RestTaskPatch = z.infer<typeof restTaskPatchSchema>;
 
+/** How many tasks a goal has in each state: what its progress is read from, live. */
+export const restTaskCountsSchema = z.object({
+  idea: count,
+  ready: count,
+  in_progress: count,
+  in_review: count,
+  done: count,
+  dropped: count,
+});
+export type RestTaskCounts = z.infer<typeof restTaskCountsSchema>;
+
+/**
+ * A goal of a project's roadmap (ADR-0019): what the project works towards, with the day it is
+ * meant to be reached by, and how far the tasks under it are.
+ */
+export const restGoalSchema = z.object({
+  id: uuid,
+  title: z.string(),
+  /** Markdown: what reaching the goal means. Shown as text or rendered to elements, never as HTML. */
+  body: z.string(),
+  state: z.enum(GOAL_STATES),
+  /** The day the goal is meant to be reached by, or `null`. */
+  dueOn: z.nullable(day),
+  createdBy: restPersonSchema,
+  /** The tasks that work towards it, counted by state. */
+  taskCounts: restTaskCountsSchema,
+  createdAt: instant,
+  updatedAt: instant,
+});
+export type RestGoal = z.infer<typeof restGoalSchema>;
+
+/** `GET /api/v1/projects/<key>/goals`: the roadmap, the active goals first. */
+export const restGoalsSchema = z.object({ items: z.array(restGoalSchema) });
+export type RestGoals = z.infer<typeof restGoalsSchema>;
+
+/** What `POST /api/v1/projects/<key>/goals` is sent: the title, and the rest with defaults. */
+export const restGoalInputSchema = z.object({
+  title: line(MAX_TITLE_LENGTH),
+  body: z.optional(body),
+  /** Left out: `planned`. */
+  state: z.optional(z.enum(GOAL_STATES)),
+  dueOn: z.optional(z.nullable(day)),
+});
+export type RestGoalInput = z.infer<typeof restGoalInputSchema>;
+
+/** What `PATCH /api/v1/projects/<key>/goals/<id>` is sent: only what changes. */
+export const restGoalPatchSchema = z.object({
+  title: z.optional(line(MAX_TITLE_LENGTH)),
+  body: z.optional(body),
+  state: z.optional(z.enum(GOAL_STATES)),
+  dueOn: z.optional(z.nullable(day)),
+});
+export type RestGoalPatch = z.infer<typeof restGoalPatchSchema>;
+
 export const restDecisionOptionSchema = z.object({
   /** What an answer names: stable for the life of the decision. */
   id: z.string(),
@@ -328,6 +453,19 @@ export type RestDecision = z.infer<typeof restDecisionSchema>;
 export const restDecisionsSchema = z.object({ items: z.array(restDecisionSchema) });
 export type RestDecisions = z.infer<typeof restDecisionsSchema>;
 
+/** The project a thing on a person's plate belongs to, named for the page to say and link it. */
+const projectRef = z.object({ key: projectKey, name: z.string() });
+
+/**
+ * `GET /api/v1/work`: what is on the asker's plate across the projects they may see (ADR-0019):
+ * the open tasks assigned to them, and the decisions that wait for a person, each with its project.
+ */
+export const restWorkSchema = z.object({
+  tasks: z.array(z.object({ project: projectRef, task: restTaskSchema })),
+  decisions: z.array(z.object({ project: projectRef, decision: restDecisionSchema })),
+});
+export type RestWork = z.infer<typeof restWorkSchema>;
+
 /** What `POST /api/v1/projects/<key>/decisions` is sent: the question, its context, and the options. */
 export const restDecisionInputSchema = z.object({
   question: line(MAX_QUESTION_LENGTH),
@@ -363,7 +501,7 @@ export type RestAnswerInput = z.infer<typeof restAnswerInputSchema>;
 export const restEventDataSchema = z.object({
   number: z.optional(z.int()),
   title: z.optional(z.string()),
-  /** For `task.updated`, `project.updated` and `decision.updated`: which fields changed. */
+  /** For `task.updated`, `project.updated`, `goal.updated` and `decision.updated`: which fields changed. */
   fields: z.optional(z.array(z.string())),
   /** For the events about a document: its path, and the version written. */
   path: z.optional(z.string()),
@@ -406,6 +544,8 @@ export const restEventSchema = z.object({
   runId: z.nullable(uuid),
   /** The document it is about, or `null`. */
   documentId: z.nullable(uuid),
+  /** The goal it is about, or `null`. */
+  goalId: z.nullable(uuid),
   data: restEventDataSchema,
   createdAt: instant,
 });