@skillcdn/console 0.1.8 → 0.1.10

package/src/i18n/ko.ts

@@ -27,6 +27,17 @@ export const ko: Messages = {
       failed: "실패",
       abandoned: "중단됨",
     },
+    goalState: { planned: "계획됨", active: "진행 중", done: "달성", dropped: "중단" },
+    categoryColor: {
+      gray: "회색",
+      blue: "파랑",
+      green: "초록",
+      orange: "주황",
+      pink: "분홍",
+      purple: "보라",
+      teal: "청록",
+      yellow: "노랑",
+    },
   },
 
   common: {
@@ -61,9 +72,13 @@ export const ko: Messages = {
 
   nav: {
     projects: "프로젝트",
+    work: "내 작업",
     people: "사람들",
     agents: "에이전트",
+    categories: "카테고리",
     board: "보드",
+    roadmap: "로드맵",
+    calendar: "캘린더",
     docs: "문서",
     decisions: "결정",
     feed: "피드",
@@ -166,7 +181,25 @@ export const ko: Messages = {
     decisionsTitle: "사람을 기다리는 결정",
     agentAtWork: "에이전트 작업 중",
     agentAtWorkTitle: "에이전트가 이 작업을 하고 있습니다",
-    links: (n) => `링크 ${n}개`,
+    agentSince: (agent, since) => `${agent}, ${since}부터 작업 중`,
+    filters: {
+      aria: "보드 좁혀 보기",
+      everyone: "모두",
+      mine: "내 작업",
+      anyCategory: "모든 카테고리",
+      noCategory: "카테고리 없음",
+      anyGoal: "모든 목표",
+      noGoal: "목표 없음",
+      clear: "전체 보기",
+      showing: (n, of) => `작업 ${of}개 중 ${n}개`,
+    },
+    due: {
+      overdue: (days) => `${days}일 지남`,
+      today: "오늘 마감",
+      tomorrow: "내일 마감",
+      inDays: (days) => `${days}일 남음`,
+      on: (day) => `${day} 마감`,
+    },
   },
 
   task: {
@@ -192,6 +225,19 @@ export const ko: Messages = {
     history: "일어난 일",
     subtasks: "하위 작업",
     partOfIt: "하위 작업",
+    category: "카테고리",
+    goal: "목표",
+    plan: "일정",
+    planned: (from, to) =>
+      from !== undefined && to !== undefined
+        ? `${from}부터 ${to}까지`
+        : from !== undefined
+          ? `${from}부터`
+          : to !== undefined
+            ? `${to}까지`
+            : "",
+    started: "시작",
+    done: "완료",
     form: {
       title: "제목",
       body: "본문",
@@ -200,6 +246,12 @@ export const ko: Messages = {
       priority: "우선순위",
       assignee: "배정",
       partOf: "상위 작업",
+      category: "카테고리",
+      noCategory: "카테고리 없음",
+      goal: "목표",
+      noGoal: "목표 없음",
+      startsOn: "시작일",
+      dueOn: "기한",
       links: "링크",
       label: "이름",
       addLink: "링크 추가",
@@ -223,6 +275,10 @@ export const ko: Messages = {
     },
     waiting: "대기 중",
     answered: "답변됨",
+    record: "기록",
+    recordLead:
+      "답변된 모든 결정, 최신순. 무엇을 물었고, 무엇을 골랐고, 누가 골랐는지. 맥락과 근거, 그 뒤에 일어난 일은 각 결정을 열어 봅니다.",
+    openRecord: "열기",
     waitingForPerson: "사람을 기다리는 중입니다.",
     options: "선택지",
     notePlaceholder: "덧붙일 말이 있다면",
@@ -250,6 +306,111 @@ export const ko: Messages = {
     },
   },
 
+  calendar: {
+    title: "캘린더",
+    lead: "작업을 기한일에 놓고 봅니다. 시작일이 있는 작업은 그날부터 보이고, 날짜가 없는 작업은 아래에서 날짜를 기다립니다.",
+    grid: "이 달",
+    previous: "이전 달",
+    next: "다음 달",
+    thisMonth: "이번 달",
+    nothingDue: "이 달에 마감인 작업이 없습니다.",
+    overdue: "기한 지남",
+    nothingOverdue: "기한이 지난 작업이 없습니다.",
+    unscheduled: "날짜 없음",
+    allScheduled: "열린 작업마다 날짜가 있습니다.",
+    starts: "시작",
+    workload: {
+      title: "누가 무엇을",
+      lead: "사람마다 열린 작업과, 그중 늦은 것과 일주일 안에 마감인 것.",
+      person: "사람",
+      open: "열림",
+      inProgress: "진행 중",
+      dueSoon: "7일 내 마감",
+      overdue: "기한 지남",
+      unassigned: "아직 배정 없음",
+    },
+  },
+
+  roadmap: {
+    title: "로드맵",
+    lead: "프로젝트가 향하는 것. 목표마다 달성 목표일과, 그 아래 작업들이 어디까지 왔는지. 진행은 보드의 현재 상태에서 그대로 읽습니다.",
+    setGoal: "목표 세우기",
+    setGoalAria: "목표 세우기",
+    editAria: "목표 바꾸기",
+    one: "목표",
+    all: "모든 목표",
+    empty: {
+      title: "아직 세운 목표가 없습니다",
+      body: "소유자가 첫 목표를 세웁니다. 무엇을, 언제까지. 그 뒤 작업을 그 목표를 향해 씁니다.",
+    },
+    noSuch: {
+      title: "그런 목표가 없습니다",
+      body: "다른 프로젝트의 것이거나, 링크가 잘못됐습니다.",
+    },
+    onlyOwner: {
+      title: "로드맵은 소유자만 세웁니다",
+      body: "프로젝트 소유자나 워크스페이스 관리자에게 요청하세요.",
+    },
+    progress: (done, of) => `작업 ${of}개 중 ${done}개 완료`,
+    inProgress: (n) => `${n}개 진행 중`,
+    noTasks: "아직 이 목표를 향한 작업이 없습니다.",
+    tasks: "작업",
+    target: "목표일",
+    noTarget: "목표일 없음",
+    setBy: "세운 사람",
+    state: "상태",
+    nothingMore: "더 적힌 내용이 없습니다.",
+    form: {
+      title: "제목",
+      body: "달성의 의미",
+      bodyPlaceholder: "목표를 이루면 무엇이 참이 되는지, Markdown으로.",
+      state: "상태",
+      dueOn: "목표일",
+      set: "목표 세우기",
+    },
+  },
+
+  work: {
+    title: "내 작업",
+    lead: "내 프로젝트들에 걸쳐 내게 놓인 일. 내게 배정된 열린 작업을 기한순으로, 그리고 사람을 기다리는 결정.",
+    loading: "내 작업을 불러오는 중",
+    couldNotLoad: "내 작업을 불러올 수 없습니다.",
+    empty: {
+      title: "내게 배정된 작업이 없습니다",
+      body: "볼 수 있는 어느 프로젝트에서든 내게 배정된 작업이 여기에 나타납니다.",
+    },
+    overdue: "기한 지남",
+    thisWeek: "이번 주 마감",
+    later: "그 뒤",
+    noDay: "날짜 없음",
+    decisions: "사람을 기다리는 결정",
+    noDecisions: "기다리는 결정이 없습니다.",
+    inProject: (project) => `${project}에서`,
+  },
+
+  categories: {
+    title: "카테고리",
+    lead: "작업을 나누는 일의 종류이며, 모든 프로젝트에서 같습니다. 작업은 하나를 가지고, 보드는 하나로 좁혀 보며, 관리자가 목록을 관리합니다.",
+    onlyAdmin: "관리자가 추가하고 바꾸고 제거합니다. 다른 사람은 여기서 읽습니다.",
+    list: "카테고리",
+    add: "카테고리 추가",
+    addAria: "카테고리 추가",
+    empty: {
+      title: "카테고리가 없습니다",
+      body: "관리자가 여기서 첫 카테고리를 추가합니다.",
+    },
+    inUse: "작업이 속해 있는 카테고리는 그 작업들을 옮기기 전에는 제거할 수 없습니다.",
+    form: {
+      name: "이름",
+      key: "키",
+      keyHint: "소문자, 숫자, 하이픈. 명령과 필터가 부르는 이름이며 바뀌지 않습니다.",
+      color: "색",
+      add: "추가",
+    },
+    nameOf: (key) => `${key}의 이름`,
+    colorOf: (key) => `${key}의 색`,
+  },
+
   feed: {
     title: "일어난 일",
     list: "일어난 일",
@@ -263,6 +424,8 @@ export const ko: Messages = {
     something: "무언가",
     aQuestion: "질문",
     aFile: "파일",
+    aGoal: "목표",
+    aCategory: "카테고리",
     thePage: (name) => `페이지 ${name}`.trimEnd(),
     role: {
       admin: "관리자",
@@ -282,6 +445,12 @@ export const ko: Messages = {
       visibility: "멤버 범위",
       skillsAddress: "스킬 주소",
       outcome: "그 뒤에 일어난 일",
+      category: "카테고리",
+      goalId: "목표",
+      startsOn: "시작일",
+      dueOn: "기한",
+      state: "상태",
+      color: "색",
     },
     event: {
       personJoined: () => "보드에 들어왔습니다",
@@ -293,6 +462,11 @@ export const ko: Messages = {
       memberChanged: (login, role, project) =>
         `${login}을(를) ${project}의 ${role}(으)로 지정했습니다`,
       memberRemoved: (login, project) => `${login}을(를) ${project}에서 제외했습니다`,
+      categoryCreated: (category) => `카테고리 ${category}을(를) 만들었습니다`,
+      categoryUpdated: (fields, category) => `카테고리 ${category}의 ${fields}을(를) 바꿨습니다`,
+      categoryRemoved: (category) => `카테고리 ${category}을(를) 제거했습니다`,
+      goalCreated: (goal) => `목표 ${goal}을(를) 세웠습니다`,
+      goalUpdated: (fields, goal) => `목표 ${goal}의 ${fields}을(를) 바꿨습니다`,
       taskCreated: (task) => `${task}을(를) 썼습니다`,
       taskMoved: (task, from, to) => `${task}을(를) ${from}에서 ${to}(으)로 옮겼습니다`,
       taskUpdated: (fields, task) => `${task}의 ${fields}을(를) 바꿨습니다`,

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];