@skillcdn/console 0.3.1 → 0.4.0

package/src/i18n/en.ts

@@ -121,11 +121,17 @@ export const en = {
       next: "Next page",
       range: (from: number, to: number, of: number) => `${from}-${to} of ${of}`,
     },
+    picker: {
+      nothingFound: "Nothing matches",
+      searching: "Searching",
+      more: "Show more",
+    },
   },
 
   nav: {
     projects: "Projects",
     work: "My work",
+    myDecisions: "My decisions",
     people: "People",
     agents: "Agents",
     board: "Board",
@@ -274,8 +280,11 @@ export const en = {
     menu: "Task menu",
     decisions: (n: number) => count(n, "decision", "decisions"),
     decisionsTitle: "Decisions waiting for a person",
+    unfold: (column: string) => `Open ${column}`,
+    fold: (column: string) => `Fold ${column}`,
     filters: {
       aria: "Narrow the board",
+      words: "Title, number or person",
       everyone: "Everyone",
       mine: "Mine",
       anyCategory: "Any category",
@@ -304,7 +313,7 @@ export const en = {
     },
     partOf: "Part of",
     owner: "Owner",
-    assignee: "Assignee",
+    workers: "Workers",
     written: "Written",
     changed: "Changed",
     state: "State",
@@ -338,8 +347,11 @@ export const en = {
       bodyPlaceholder: "What is to be done, in Markdown.",
       state: "State",
       priority: "Priority",
-      assignee: "Assignee",
+      workers: "Workers",
+      addWorker: "Add a worker",
       partOf: "Part of",
+      searchTasks: "Search by number or title",
+      searchGoals: "Search by title",
       category: "Category",
       noCategory: "No category",
       goal: "Goal",
@@ -372,6 +384,8 @@ export const en = {
     record: "The record",
     openRecord: "Open",
     waitingForPerson: "Waiting for a person.",
+    waitingFor: (name: string) => `Waiting for ${name}.`,
+    peopleLabel: (asker: string, decider: string) => `asked by ${asker}, for ${decider}`,
     options: "Options",
     notePlaceholder: "A word about it, if any",
     own: "Something else",
@@ -394,6 +408,9 @@ export const en = {
       contextPlaceholder: "What a person needs to know to answer, in Markdown.",
       about: "About",
       noTask: "No task in particular",
+      decider: "Who decides",
+      deciderPlaceholder: "You, unless you name someone",
+      me: "(you)",
       options: "Options",
       option: (n: number) => `Option ${n}`,
       addOption: "Add an option",
@@ -401,6 +418,23 @@ export const en = {
     },
   },
 
+  myDecisions: {
+    title: "My decisions",
+    loading: "Loading your decisions",
+    couldNotLoad: "Your decisions could not be loaded.",
+    empty: {
+      title: "No decision is yours",
+      body: "A decision for you, by you or your agent or by someone who named you, and one you asked of someone else, show up here.",
+    },
+    waiting: "Waiting for you",
+    noneWaiting: "Nothing waits for your answer.",
+    raised: "Asked of others",
+    noneRaised: "You have asked nothing of others.",
+    answered: "Answered",
+    noneAnswered: "Nothing answered yet.",
+    more: "Show more",
+  },
+
   calendar: {
     title: "Calendar",
     grid: "The month",
@@ -413,6 +447,11 @@ export const en = {
     nothingOverdue: "Nothing is overdue.",
     unscheduled: "No day set",
     allScheduled: "Every open task has a day.",
+    more: (n: number) => `${n} more`,
+    fewer: "Fewer",
+    onDay: (day: string) => `Tasks on ${day}`,
+    nothingOnDay: "Nothing is on this day.",
+    close: "Close",
     week: {
       title: "The week",
       previous: "The week before",
@@ -425,7 +464,7 @@ export const en = {
       person: "Person",
       open: "Open",
       inProgress: "In progress",
-      dueSoon: "Due in 7 days",
+      dueThisWeek: "Due this week",
       overdue: "Overdue",
       unassigned: "Nobody's yet",
     },
@@ -497,15 +536,15 @@ export const en = {
     loading: "Loading your work",
     couldNotLoad: "Your work could not be loaded.",
     empty: {
-      title: "Nothing is assigned to you",
-      body: "A task assigned to you in any project you may see shows up here.",
+      title: "Nothing is on your plate",
+      body: "A task you work on, in any project you may see, shows up here.",
     },
     overdue: "Overdue",
     thisWeek: "Due this week",
     later: "Later",
     noDay: "No day set",
-    decisions: "Decisions waiting for a person",
-    noDecisions: "No decision waits.",
+    decisions: "Decisions waiting for you",
+    noDecisions: "No decision waits for your answer.",
     inProject: (project: string) => `in ${project}`,
   },
 
@@ -609,7 +648,7 @@ export const en = {
       title: "the title",
       body: "the body",
       priority: "the priority",
-      assigneeId: "the assignee",
+      workers: "the workers",
       parentId: "what it is part of",
       links: "the links",
       name: "the name",
@@ -669,6 +708,8 @@ export const en = {
       runFinished: (task: string) => `finished ${task}`,
       runFailed: (task: string) => `failed on ${task}`,
       runAbandoned: (task: string) => `gave up on ${task}`,
+      runUnheard: (task: string, agent: string) =>
+        `ended the run of ${agent} on ${task}, not heard from for too long`,
       documentWritten: (page: string, version: number | undefined) =>
         `wrote ${page}${version === undefined ? "" : `, version ${version}`}`,
       documentArchived: (page: string) => `archived ${page}`,
@@ -793,6 +834,7 @@ export const en = {
     version: (n: number) => `v${n}`,
     versionWord: "version",
     writtenBy: "written by",
+    author: "Written by",
     versionOf: (n: number, of: number) => `Version ${n} of ${of}`,
     showLatest: "Show the latest",
     archivedNotice: "This page is archived: out of the folders and the search, and not written to.",
@@ -805,6 +847,8 @@ export const en = {
     decisionPrefix: "Decision: ",
     files: "Files",
     fileToAttach: "A file to attach",
+    chooseFile: "Choose a file",
+    noFileChosen: "No file chosen",
     labelPlaceholder: "What to call it, if not its name",
     attach: "Attach",
     by: "by",
@@ -861,8 +905,8 @@ export const en = {
     loadingWork: "Loading the work",
     couldNotLoadWork: "The work could not be loaded.",
     noWork: {
-      title: (name: string) => `Nothing is assigned to ${name}`,
-      body: "An open task assigned to them, in a project you may see, shows up here.",
+      title: (name: string) => `Nothing is on ${name}'s plate`,
+      body: "An open task they work on, in a project you may see, shows up here.",
     },
     notOverseen: {
       title: "Not yours to see",

package/src/i18n/ko.ts

@@ -83,11 +83,17 @@ export const ko: Messages = {
       next: "다음",
       range: (from, to, of) => `${of}건 중 ${from}-${to}`,
     },
+    picker: {
+      nothingFound: "맞는 것이 없습니다",
+      searching: "검색 중",
+      more: "더 보기",
+    },
   },
 
   nav: {
     projects: "프로젝트",
     work: "내 작업",
+    myDecisions: "내 결정",
     people: "사람들",
     agents: "에이전트",
     board: "보드",
@@ -234,8 +240,11 @@ export const ko: Messages = {
     menu: "작업 메뉴",
     decisions: (n) => `결정 ${n}건`,
     decisionsTitle: "사람을 기다리는 결정",
+    unfold: (column) => `${column} 펼치기`,
+    fold: (column) => `${column} 접기`,
     filters: {
       aria: "보드 좁혀 보기",
+      words: "제목, 번호, 사람",
       everyone: "모두",
       mine: "내 작업",
       anyCategory: "모든 카테고리",
@@ -264,7 +273,7 @@ export const ko: Messages = {
     },
     partOf: "상위 작업:",
     owner: "담당자",
-    assignee: "배정",
+    workers: "작업자",
     written: "작성",
     changed: "변경",
     state: "상태",
@@ -298,8 +307,11 @@ export const ko: Messages = {
       bodyPlaceholder: "무엇을 할지, Markdown으로.",
       state: "상태",
       priority: "우선순위",
-      assignee: "배정",
+      workers: "작업자",
+      addWorker: "작업자 추가",
       partOf: "상위 작업",
+      searchTasks: "번호나 제목으로 검색",
+      searchGoals: "제목으로 검색",
       category: "카테고리",
       noCategory: "카테고리 없음",
       goal: "목표",
@@ -332,6 +344,8 @@ export const ko: Messages = {
     record: "기록",
     openRecord: "열기",
     waitingForPerson: "사람을 기다리는 중입니다.",
+    waitingFor: (name) => `${name}의 답을 기다리는 중입니다.`,
+    peopleLabel: (asker, decider) => `올린 사람 ${asker}, 답할 사람 ${decider}`,
     options: "선택지",
     notePlaceholder: "덧붙일 말이 있다면",
     own: "직접 입력",
@@ -354,6 +368,9 @@ export const ko: Messages = {
       contextPlaceholder: "답하려면 알아야 할 것, Markdown으로.",
       about: "관련 작업",
       noTask: "특정 작업 없음",
+      decider: "결정할 사람",
+      deciderPlaceholder: "지정하지 않으면 본인",
+      me: "(나)",
       options: "선택지",
       option: (n) => `선택지 ${n}`,
       addOption: "선택지 추가",
@@ -361,6 +378,23 @@ export const ko: Messages = {
     },
   },
 
+  myDecisions: {
+    title: "내 결정",
+    loading: "내 결정을 불러오는 중",
+    couldNotLoad: "내 결정을 불러올 수 없습니다.",
+    empty: {
+      title: "내 결정이 없습니다",
+      body: "내게 온 결정과 내가 다른 사람에게 올린 결정이 여기에 모입니다. 내가 올린 결정은 내 에이전트가 올린 것을 포함합니다.",
+    },
+    waiting: "내 답을 기다리는 중",
+    noneWaiting: "내 답을 기다리는 결정이 없습니다.",
+    raised: "내가 다른 사람에게 올린 결정",
+    noneRaised: "다른 사람에게 올린 결정이 없습니다.",
+    answered: "답변됨",
+    noneAnswered: "아직 답한 결정이 없습니다.",
+    more: "더 보기",
+  },
+
   calendar: {
     title: "캘린더",
     grid: "이 달",
@@ -373,6 +407,11 @@ export const ko: Messages = {
     nothingOverdue: "기한이 지난 작업이 없습니다.",
     unscheduled: "날짜 없음",
     allScheduled: "열린 작업마다 날짜가 있습니다.",
+    more: (n) => `${n}개 더`,
+    fewer: "접기",
+    onDay: (day) => `${day}의 작업`,
+    nothingOnDay: "이 날에 잡힌 작업이 없습니다.",
+    close: "닫기",
     week: {
       title: "이 주",
       previous: "이전 주",
@@ -381,13 +420,13 @@ export const ko: Messages = {
       nothing: "이 주에 잡힌 작업이 없습니다.",
     },
     workload: {
-      title: "누가 무엇을",
+      title: "담당자별 작업 현황",
       person: "사람",
       open: "열림",
       inProgress: "진행 중",
-      dueSoon: "7일 내 마감",
+      dueThisWeek: "이번 주 마감",
       overdue: "기한 지남",
-      unassigned: "아직 배정 없음",
+      unassigned: "아직 작업자 없음",
     },
   },
 
@@ -456,15 +495,15 @@ export const ko: Messages = {
     loading: "내 작업을 불러오는 중",
     couldNotLoad: "내 작업을 불러올 수 없습니다.",
     empty: {
-      title: "내게 배정된 작업이 없습니다",
-      body: "볼 수 있는 어느 프로젝트에서든 내게 배정된 작업이 여기에 나타납니다.",
+      title: "내가 맡은 작업이 없습니다",
+      body: "볼 수 있는 어느 프로젝트에서든 내가 작업자인 작업이 여기에 나타납니다.",
     },
     overdue: "기한 지남",
     thisWeek: "이번 주 마감",
     later: "그 뒤",
     noDay: "날짜 없음",
-    decisions: "사람을 기다리는 결정",
-    noDecisions: "기다리는 결정이 없습니다.",
+    decisions: "내 답을 기다리는 결정",
+    noDecisions: "내 답을 기다리는 결정이 없습니다.",
     inProject: (project) => `${project}에서`,
   },
 
@@ -567,7 +606,7 @@ export const ko: Messages = {
       title: "제목",
       body: "본문",
       priority: "우선순위",
-      assigneeId: "배정",
+      workers: "작업자",
       parentId: "상위 작업",
       links: "링크",
       name: "이름",
@@ -624,6 +663,8 @@ export const ko: Messages = {
       runFinished: (task) => `${task}을(를) 끝냈습니다`,
       runFailed: (task) => `${task}에 실패했습니다`,
       runAbandoned: (task) => `${task}을(를) 포기했습니다`,
+      runUnheard: (task, agent) =>
+        `${task}의 ${agent} 런을 끝냈습니다. 너무 오래 소식이 없었습니다`,
       documentWritten: (page, version) =>
         `${page}을(를) 썼습니다${version === undefined ? "" : `, 버전 ${version}`}`,
       documentArchived: (page) => `${page}을(를) 보관했습니다`,
@@ -749,6 +790,7 @@ export const ko: Messages = {
     version: (n) => `v${n}`,
     versionWord: "버전",
     writtenBy: "작성:",
+    author: "작성",
     versionOf: (n, of) => `버전 ${n} / ${of}`,
     showLatest: "최신 버전 보기",
     archivedNotice: "이 페이지는 보관됐습니다. 폴더와 검색에서 빠지고, 쓸 수 없습니다.",
@@ -761,6 +803,8 @@ export const ko: Messages = {
     decisionPrefix: "결정: ",
     files: "파일",
     fileToAttach: "첨부할 파일",
+    chooseFile: "파일 선택",
+    noFileChosen: "선택된 파일 없음",
     labelPlaceholder: "파일 이름 대신 부를 이름",
     attach: "첨부",
     by: "첨부:",
@@ -816,8 +860,8 @@ export const ko: Messages = {
     loadingWork: "작업을 불러오는 중",
     couldNotLoadWork: "작업을 불러올 수 없습니다.",
     noWork: {
-      title: (name) => `${name}에게 배정된 작업이 없습니다`,
-      body: "내가 볼 수 있는 프로젝트에서 그 사람에게 배정된 열린 작업이 여기에 나타납니다.",
+      title: (name) => `${name}에게 맡겨진 작업이 없습니다`,
+      body: "내가 볼 수 있는 프로젝트에서 그 사람이 작업자인 열린 작업이 여기에 나타납니다.",
     },
     notOverseen: {
       title: "볼 수 없는 작업입니다",

package/src/index.ts

@@ -11,6 +11,7 @@ export {
   type BoardProps,
   byDue,
   columnStateOf,
+  FOLDED_STATES,
   filterTasks,
   TaskCard,
 } from "./components/board.js";
@@ -82,6 +83,7 @@ export {
   goalMonth,
 } from "./components/goals.js";
 export { Markdown, type MarkdownProps } from "./components/markdown.js";
+export { MyDecisions, type MyDecisionsProps } from "./components/my-decisions.js";
 export {
   PackConnect,
   type PackConnectProps,
@@ -102,6 +104,13 @@ export {
   PeopleList,
   type PeopleListProps,
 } from "./components/people.js";
+export {
+  PICKER_PAGE_LIMIT,
+  Picker,
+  type PickerPage,
+  type PickerProps,
+  type PickerSearch,
+} from "./components/picker.js";
 export {
   clampScale,
   FITTED,
@@ -168,7 +177,14 @@ export {
 } from "./components/shell.js";
 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 {
+  type GoalSearch,
+  goalLabel,
+  TaskForm,
+  type TaskFormProps,
+  type TaskSearch,
+  taskLabel,
+} from "./components/task-form.js";
 export { TaskList, type TaskListProps } from "./components/task-list.js";
 export { TaskView, type TaskViewProps } from "./components/task-view.js";
 export {
@@ -193,6 +209,7 @@ export {
   formatBytes,
   formatInstant,
   GoalStateBadge,
+  LinkButton,
   PersonChip,
   PRIORITY_LABELS,
   PriorityBadge,
@@ -204,6 +221,7 @@ export {
   STATE_LABELS,
   StateBadge,
   Time,
+  Workers,
 } from "./components/ui.js";
 export { WorkList, type WorkListProps } from "./components/work.js";
 export {

package/src/limits.ts

@@ -9,6 +9,8 @@ export const MAX_QUESTION_LENGTH = 500;
 export const MAX_BODY_LENGTH = 20_000;
 /** The links of a task: a repository, a pull request, a document. */
 export const MAX_LINKS = 20;
+/** How many people may be at work on one task at a time (ADR-0037): a crew, not a mailing list. */
+export const MAX_WORKERS = 20;
 export const MAX_LINK_LABEL_LENGTH = 120;
 export const MAX_URL_LENGTH = 2048;
 /** The options of a decision, and how a person words each. */

package/src/router.ts

@@ -21,15 +21,20 @@ export type DocsView =
 /**
  * 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.
+ * the person's own, or words (`q`), as they are typed, each of which a task's title, number,
+ * owner, worker or category must contain.
  */
 export interface BoardFilter {
   readonly category?: string | undefined;
   readonly goal?: string | undefined;
   readonly person?: string | undefined;
   readonly mine?: boolean | undefined;
+  readonly words?: string | undefined;
 }
 
+/** As much of the words as the address keeps: enough for any search, bounded as every input is. */
+const BOARD_WORDS_LENGTH = 200;
+
 export type Route =
   | { readonly name: "projects" }
   | { readonly name: "new-project" }
@@ -100,6 +105,8 @@ export type Route =
   /** What is on the person's plate across their projects. */
   /** What is on the person's plate: a day of the week shown at the top, or today's when the address names none. */
   | { readonly name: "work"; readonly week: string | undefined }
+  /** The decisions addressed to the person (ADR-0042), across the projects they may see. */
+  | { readonly name: "my-decisions" }
   /** 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. */
@@ -136,6 +143,8 @@ export const PATHS = {
   newProject: "/projects/new",
   /** What is on the person's plate, across the projects they may see. */
   work: "/work",
+  /** The decisions addressed to the person (ADR-0042), across the projects they may see. */
+  decisions: "/decisions",
   people: "/people",
   /** The form where an administrator lets someone in by login. */
   newListing: "/people/new",
@@ -187,11 +196,13 @@ const boardFilterOf = (params: URLSearchParams): BoardFilter => {
   const category = params.get("category");
   const goal = params.get("goal");
   const person = params.get("person");
+  const q = params.get("q");
   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 } : {}),
+    ...(q !== null && q.trim() !== "" ? { words: q.slice(0, BOARD_WORDS_LENGTH) } : {}),
   };
 };
 
@@ -239,6 +250,9 @@ export function matchRoute(pathname: string, search = ""): Route {
     const shown = weekShown(params);
     return shown === undefined ? NOT_FOUND : { name: "work", ...shown };
   }
+  if (path === PATHS.decisions) {
+    return { name: "my-decisions" };
+  }
   if (path === PATHS.people) {
     return { name: "people" };
   }
@@ -462,6 +476,9 @@ function filterParts(filter: BoardFilter): string[] {
   if (filter.mine === true) {
     parts.push("mine");
   }
+  if (filter.words !== undefined) {
+    parts.push(`q=${encodeURIComponent(filter.words)}`);
+  }
   return parts;
 }
 

package/src/routes.ts

@@ -27,8 +27,10 @@ export const REST_ROUTES = {
   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. */
+  /** What is on the asker's plate across the projects they may see: their open tasks, and the decisions waiting for them. */
   work: "/api/v1/work",
+  /** The decisions addressed to the asker (ADR-0042) across the projects they may see: the waiting first, then the record. */
+  decisions: "/api/v1/decisions",
   /** The rules of the board (ADR-0023): the console's own until an administrator writes the organization's. */
   rules: "/api/v1/rules",
 } as const;

package/src/rules.ts

@@ -41,7 +41,7 @@ export const REFERENCE_RULES = [
   "",
   "## Decide alone, or ask",
   "",
-  "Alone: how to do what the task settles, which skill to load, what to write on pages, and a commit or a push where the repository's agreement allows it. On the board, with `console ask`: a trade-off the task leaves open, a change of scope or of the plan, anything that costs money, anything that deletes. Answered once, never asked again.",
+  "Alone: how to do what the task settles, which skill to load, what to write on pages, and a commit or a push where the repository's agreement allows it. On the board, with `console ask`: a trade-off the task leaves open, a change of scope or of the plan, anything that costs money, anything that deletes. Answered once, never asked again. A decision is the record of a choice that is a person's to make, wherever they make it: an answer given to you in chat, in a meeting or by changing the task is written on the decision in the person's name (`console answer`), with where it was said, so that the board shows as waiting only what is still open and a run waits on the record, not on memory. Asked what is on a person's plate, or for a briefing, start from the decisions waiting for their answer (`console work`), each with what waits on it and since when, before the tasks.",
   "",
   "## Reports",
   "",

package/src/schemas.ts

@@ -39,6 +39,7 @@ import {
   MAX_TOKEN_DAYS,
   MAX_TOKEN_NAME_LENGTH,
   MAX_URL_LENGTH,
+  MAX_WORKERS,
   MIN_OPTIONS,
 } from "./limits.js";
 import { hasForbiddenCodePoint } from "./text.js";
@@ -480,8 +481,10 @@ export const restTaskSchema = z.object({
   body: z.string(),
   state: z.enum(TASK_STATES),
   priority: z.enum(TASK_PRIORITIES),
+  /** Whose task it is: one person, whoever wrote it. */
   owner: restPersonSchema,
-  assignee: z.nullable(restPersonSchema),
+  /** The people at work on it (ADR-0037), in the order they came to it; `[]` while nobody is. */
+  workers: z.array(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`. */
@@ -530,7 +533,8 @@ export const restTaskInputSchema = z.object({
   body: z.optional(body),
   state: z.optional(z.enum(TASK_STATES)),
   priority: z.optional(z.enum(TASK_PRIORITIES)),
-  assigneeId: z.optional(z.nullable(uuid)),
+  /** The people to be at work on it, each one who may work in the project, in place of those there were; `[]` for nobody. */
+  workerIds: z.optional(z.array(uuid).check(z.maxLength(MAX_WORKERS))),
   parentId: z.optional(z.nullable(uuid)),
   /** The key of a category of the workspace, or `null` for none. */
   category: z.optional(z.nullable(categoryKey)),
@@ -549,7 +553,7 @@ export const restTaskPatchSchema = z.object({
   body: z.optional(body),
   state: z.optional(z.enum(TASK_STATES)),
   priority: z.optional(z.enum(TASK_PRIORITIES)),
-  assigneeId: z.optional(z.nullable(uuid)),
+  workerIds: z.optional(z.array(uuid).check(z.maxLength(MAX_WORKERS))),
   parentId: z.optional(z.nullable(uuid)),
   category: z.optional(z.nullable(categoryKey)),
   goalId: z.optional(z.nullable(uuid)),
@@ -596,8 +600,8 @@ export const restGoalSchema = z.object({
 });
 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) });
+/** `GET /api/v1/projects/<key>/goals`: a page of the roadmap, the active goals first, and whether there is more after it. */
+export const restGoalsSchema = z.object({ items: z.array(restGoalSchema), more: z.boolean() });
 export type RestGoals = z.infer<typeof restGoalsSchema>;
 
 /** What `POST /api/v1/projects/<key>/goals` is sent: the title, and the rest with defaults. */
@@ -648,6 +652,8 @@ export const restDecisionSchema = z.object({
   /** The task's number, when there is a task, or `null`. */
   taskNumber: z.nullable(z.int()),
   raisedBy: restPersonSchema,
+  /** Who is to answer (ADR-0042): the raiser, unless another person of the project was named. */
+  decider: restPersonSchema,
   /** The run that raised it, as the agent asked, or `null` when a person did. */
   run: z.nullable(z.object({ id: uuid, agent: z.string() })),
   /** The answer, with who gave it and when; `null` while the decision waits. */
@@ -686,9 +692,9 @@ const projectRef = z.object({
 
 /**
  * `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; and, for the week on the plate, `closed`, the tasks assigned to them that are done
- * or dropped and not yet put away. Left out by a console older than it.
+ * the open tasks they work on, and the decisions that wait for their answer (ADR-0042), each
+ * with its project; and, for the week on the plate, `closed`, the tasks they work on that are
+ * done or dropped and not yet put away. Left out by a console older than it.
  */
 export const restWorkSchema = z.object({
   tasks: z.array(z.object({ project: projectRef, task: restTaskSchema })),
@@ -697,6 +703,17 @@ export const restWorkSchema = z.object({
 });
 export type RestWork = z.infer<typeof restWorkSchema>;
 
+/**
+ * `GET /api/v1/decisions`: a page of the decisions addressed to the asker (ADR-0042) across the
+ * projects they may see, each with its project: the ones that wait first, oldest first among
+ * them, then the answered, newest first; and whether there is more.
+ */
+export const restMyDecisionsSchema = z.object({
+  items: z.array(z.object({ project: projectRef, decision: restDecisionSchema })),
+  more: z.boolean(),
+});
+export type RestMyDecisions = z.infer<typeof restMyDecisionsSchema>;
+
 /**
  * What `GET /api/v1/people/<id>/work` answers: another person's open tasks, and their closed
  * ones for the week, within the projects the asker may see, for whoever oversees them. No
@@ -718,6 +735,8 @@ export const restDecisionInputSchema = z.object({
   taskId: z.optional(z.nullable(uuid)),
   /** The run that asks, when an agent does: the decision is about its task, and it waits for the answer. */
   runId: z.optional(z.nullable(uuid)),
+  /** Who is to answer (ADR-0042): a person who may work in the project; the asker when left out. */
+  deciderId: z.optional(uuid),
 });
 export type RestDecisionInput = z.infer<typeof restDecisionInputSchema>;
 
@@ -775,8 +794,9 @@ export const restEventDataSchema = z.object({
   name: z.optional(z.string()),
   /** For what an agent did: what it calls itself. */
   agent: z.optional(z.string()),
-  /** For `run.ended`: how. */
+  /** For `run.ended`: how, and, when the console ended the run itself, why (ADR-0041). */
   status: z.optional(z.enum(RUN_STATUSES)),
+  reason: z.optional(z.literal("unheard")),
   /** For `run.handed_in`: what the artifact is called. */
   label: z.optional(z.string()),
   /** For `run.reported` and `task.commented`: the first words of what was written. */