@skillcdn/console 0.1.17 → 0.1.19

package/src/data.ts

@@ -6,6 +6,8 @@ import {
   type DocumentFilter,
   EVENT_KINDS,
   type FileUpload,
+  LIST_LIMIT,
+  type ProjectClient,
   type RestAnswerInput,
   type RestCategory,
   type RestCategoryInput,
@@ -44,6 +46,7 @@ import {
   type RestTask,
   type RestTaskInput,
   type RestTaskPatch,
+  type RestTasks,
   type RestToken,
   type RestTokenCreated,
   type RestTokenInput,
@@ -74,11 +77,26 @@ export interface ConsoleActions {
   /** Sets the image for the mark of the project the page is on, or takes it away; for an owner. */
   setProjectIcon(input: FileUpload): Promise<RestProject>;
   removeProjectIcon(): Promise<RestProject>;
+  /** Sets the pack token of the project the page is on, or takes it away; for an owner (ADR-0028). */
+  setPackToken(token: string): Promise<RestProject>;
+  removePackToken(): Promise<RestProject>;
   addMember(input: RestMemberInput): Promise<RestMember>;
   updateMember(personId: string, patch: RestMemberPatch): Promise<RestMember>;
   removeMember(personId: string): Promise<void>;
   createTask(input: RestTaskInput): Promise<RestTask>;
   updateTask(id: string, patch: RestTaskPatch): Promise<RestTask>;
+  /** One task by its id or its number, asked for by itself: a task put away is not among the board's. */
+  fetchTask(ref: string, signal?: AbortSignal): Promise<RestTask>;
+  /** Puts a done or dropped task away, or brings one back (ADR-0029). */
+  archiveTask(id: string): Promise<RestTask>;
+  restoreTask(id: string): Promise<RestTask>;
+  /** Puts every done or dropped task of a goal away; for an owner. Answers how many went. */
+  archiveGoalTasks(goalId: string): Promise<number>;
+  /** A page of the tasks put away, newest first. */
+  archivedTasks(
+    page: { readonly limit: number; readonly offset: number },
+    signal?: AbortSignal,
+  ): Promise<RestTasks>;
   raiseDecision(input: RestDecisionInput): Promise<RestDecision>;
   answerDecision(id: string, input: RestAnswerInput): Promise<RestDecision>;
   /** Grows a decision's record: its context, or what followed. */
@@ -201,6 +219,32 @@ async function readFeed(
   return events.slice(-FEED_KEEP);
 }
 
+/** How many pages of the current tasks are read before the board is shown as it stands. */
+const TASKS_MAX_PAGES = 20;
+
+/**
+ * The current tasks of a project, whole: page after page while the server says there is more,
+ * so that a board past one page loses nothing without a word; the tasks put away are not among
+ * them (ADR-0029).
+ */
+async function readTasks(
+  scope: ProjectClient,
+  signal: AbortSignal | undefined,
+): Promise<{ readonly items: RestTask[] }> {
+  const items: RestTask[] = [];
+  for (let page = 0; page < TASKS_MAX_PAGES; page += 1) {
+    const result = await scope.tasks(
+      { archived: false, limit: LIST_LIMIT, offset: page * LIST_LIMIT },
+      signal,
+    );
+    items.push(...result.items);
+    if (!result.more) {
+      break;
+    }
+  }
+  return { items };
+}
+
 const wordsOf = (failure: unknown, fallback: string): string =>
   failure instanceof ApiError ? failure.message : fallback;
 
@@ -265,9 +309,9 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
       const [nextProject, nextTasks, nextDecisions, nextGoals, nextRuns, nextMembers] =
         await Promise.all([
           scope.get(signal),
-          scope.tasks(undefined, signal),
+          readTasks(scope, signal),
           scope.decisions(undefined, signal),
-          scope.goals(signal),
+          scope.goals({}, signal),
           scope.runs(undefined, signal),
           scope.members(signal),
         ]);
@@ -454,6 +498,16 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
         await refreshWorkspace();
         return changed;
       },
+      async setPackToken(token) {
+        const changed = await scope().setPackToken({ token });
+        setProject(changed);
+        return changed;
+      },
+      async removePackToken() {
+        const changed = await scope().removePackToken();
+        setProject(changed);
+        return changed;
+      },
       async addMember(input) {
         const member = await scope().addMember(input);
         await refreshProject();
@@ -478,6 +532,23 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
         setTasks((current) => current.map((candidate) => (candidate.id === id ? task : candidate)));
         return task;
       },
+      fetchTask: (ref, signal) => scope().task(ref, signal),
+      async archiveTask(id) {
+        const task = await scope().archiveTask(id);
+        setTasks((current) => current.filter((candidate) => candidate.id !== id));
+        return task;
+      },
+      async restoreTask(id) {
+        const task = await scope().restoreTask(id);
+        setTasks((current) => [task, ...current.filter((candidate) => candidate.id !== id)]);
+        return task;
+      },
+      async archiveGoalTasks(goalId) {
+        const { archived } = await scope().archiveTasksOfGoal(goalId);
+        await refreshProject();
+        return archived;
+      },
+      archivedTasks: (page, signal) => scope().tasks({ archived: true, ...page }, signal),
       async raiseDecision(input) {
         const decision = await scope().raiseDecision(input);
         await refreshProject();

package/src/i18n/en.ts

@@ -194,12 +194,24 @@ export const en = {
         private: "The administrators own it until an owner is listed.",
       },
     },
+    packToken: {
+      aria: "The pack token",
+      label: "Token",
+      hint: "A token a person made at SkillCDN for the pack's repository, on their account page there. The console keeps it sealed, reads the pack with it for whoever may see the project, and shows it to nobody.",
+      placeholder: "scdn_repo_…",
+      set: "Set the token",
+      remove: "Remove the token",
+    },
     settings: {
       title: "Settings",
       aria: "Project settings",
       edit: "Edit the project",
       organizationsSkills: (address: string) => `The organization's: ${address}`,
       noSkills: "None: the console names no address for the organization's.",
+      packToken: "Pack token",
+      packTokenNone: "None: a public pack needs none, and a private one is not read.",
+      packTokenSet: "Set",
+      packTokenEdit: "Change it",
     },
   },
 
@@ -210,6 +222,8 @@ export const en = {
       body: "Write the first task: what is to be done, and for whom.",
     },
     moveTo: "Move to",
+    grip: "Drag to another column",
+    archive: "Archive",
     decisions: (n: number) => count(n, "decision", "decisions"),
     decisionsTitle: "Decisions waiting for a person",
     filters: {
@@ -265,6 +279,10 @@ export const en = {
             : "",
     started: "Started",
     done: "Done",
+    archived: "Put away",
+    archivedAt: "Put away",
+    archive: "Put away",
+    restore: "Bring back",
     form: {
       title: "Title",
       titlePlaceholder: "What is to be done, in plain words that stand on their own.",
@@ -385,16 +403,39 @@ export const en = {
     inProgress: (n: number) => `${n} in progress`,
     noTasks: "No task works towards it yet.",
     tasks: "Tasks",
+    category: "Category",
+    noCategory: "No category",
+    starts: "Starts",
+    noStart: "No start day",
     target: "Target",
     noTarget: "No target day",
     setBy: "Set by",
     state: "State",
     nothingMore: "Nothing more was written about it.",
+    about: "What reaching it means",
+    archiveTasks: "Put the done tasks away",
+    archiveAsk: (n: number) =>
+      `Put the ${count(n, "task", "tasks")} done or dropped under this goal away as well?`,
+    view: "View",
+    views: { board: "Board", list: "List", calendar: "Calendar" },
+    timeline: {
+      title: "The months",
+      legend: "Category colours",
+      earlier: "A month earlier",
+      later: "A month later",
+      thisMonth: "This month",
+      today: "Today",
+      nothing: "No goal is planned in these months.",
+      noDays: "No day set",
+    },
     form: {
       title: "Title",
       body: "What reaching it means",
       bodyPlaceholder: "What is true once the goal is reached, in Markdown.",
       state: "State",
+      category: "Category",
+      noCategory: "No category",
+      startsOn: "Start day",
       dueOn: "Target day",
       set: "Set the goal",
     },
@@ -538,6 +579,8 @@ export const en = {
       taskUpdated: (fields: string, task: string) => `changed ${fields} of ${task}`,
       taskCommented: (task: string, excerpt: string | undefined) =>
         `commented on ${task}${excerpt === undefined || excerpt === "" ? "" : `: ${excerpt}`}`,
+      taskArchived: (task: string) => `put ${task} away`,
+      taskRestored: (task: string) => `brought ${task} back`,
       decisionRaised: (question: string) => `asked: ${question}`,
       decisionAnswered: (question: string, option: string) => `answered "${question}": ${option}`,
       decisionUpdated: (fields: string, question: string) =>
@@ -558,6 +601,19 @@ export const en = {
     },
   },
 
+  archive: {
+    title: "Archive",
+    lead: "Tasks done or dropped and put away: out of the board, the lists and the calendar, each still open by its number. Brought back from here.",
+    loading: "Loading the archive",
+    empty: {
+      title: "Nothing is put away",
+      body: "A task done or dropped is put away from its page, with its goal, or by the console after a while.",
+    },
+    since: "put away",
+    restore: "Bring back",
+    more: "Show more",
+  },
+
   runs: {
     for: "for",
     since: "since",
@@ -584,6 +640,16 @@ export const en = {
     picture: (name: string) => `The picture ${name}`,
     label: (name: string) => `A comment by ${name}`,
   },
+  pictures: {
+    open: (name: string) => `Open the picture ${name}`,
+    label: (name: string) => `The picture ${name}, large`,
+    close: "Close",
+    zoomIn: "Zoom in",
+    zoomOut: "Zoom out",
+    fit: "Fit to the screen",
+    file: "Open the file itself",
+    hint: "Zoom with the wheel, the buttons or two fingers; drag to move; Escape closes.",
+  },
 
   skills: {
     loading: "Loading the skills",
@@ -595,13 +661,15 @@ export const en = {
     servedBy: "Served by",
     at: "at",
     connect:
-      "An agent reads these through its own MCP connection to this address, which a person makes once:",
+      "An agent reads these with the console command (console skill <path>), or through its own MCP connection to this address, which a person makes once:",
     connectLink: "how, on the address's page at SkillCDN",
     status: {
       indexing: "SkillCDN is still indexing the repository. Look again in a moment.",
       failed: "SkillCDN could not index the repository. What it found is on the address's page.",
       not_found:
-        "SkillCDN does not serve this address, or serves it only to someone signed in there. The address's page says which.",
+        "SkillCDN does not serve this address to the console: there is nothing there, or the pack is private and the project holds no pack token for it (Settings).",
+      token_invalid:
+        "The pack token the project holds no longer works at SkillCDN: it expired, was removed, or its maker lost the repository. An owner sets a new one on the Settings page.",
       unavailable: "SkillCDN could not be reached. The skills are as they were; look again later.",
     },
     none: {
@@ -734,6 +802,13 @@ export const en = {
     goodUntil: "Good until",
     notActive: "Not active yet",
     lastActive: "Last active",
+    command: (version: string) => `console ${version}`,
+    commandVerdict: {
+      behind: "an update is available",
+      ahead: "newer than this console",
+      outdated: "must be updated",
+      too_new: "too new for this console",
+    },
     disconnect: "Disconnect",
     form: {
       name: "Name",

package/src/i18n/ko.ts

@@ -163,12 +163,24 @@ export const ko: Messages = {
         private: "소유자가 지정될 때까지 관리자가 소유합니다.",
       },
     },
+    packToken: {
+      aria: "팩 토큰",
+      label: "토큰",
+      hint: "사람이 SkillCDN 계정 페이지에서 팩의 저장소에 대해 만든 토큰입니다. 콘솔이 봉인해 보관하고, 프로젝트를 볼 수 있는 사람을 위해 팩을 읽는 데 쓰며, 누구에게도 보여 주지 않습니다.",
+      placeholder: "scdn_repo_…",
+      set: "토큰 넣기",
+      remove: "토큰 빼기",
+    },
     settings: {
       title: "설정",
       aria: "프로젝트 설정",
       edit: "프로젝트 편집",
       organizationsSkills: (address) => `조직의 스킬: ${address}`,
       noSkills: "없음: 콘솔에 조직의 주소가 없습니다.",
+      packToken: "팩 토큰",
+      packTokenNone: "없음: 공개 팩은 필요 없고, 비공개 팩은 읽히지 않습니다.",
+      packTokenSet: "설정됨",
+      packTokenEdit: "바꾸기",
     },
   },
 
@@ -179,6 +191,8 @@ export const ko: Messages = {
       body: "첫 작업을 쓰세요. 무엇을, 누구를 위해 할지.",
     },
     moveTo: "이동",
+    grip: "끌어서 다른 열로",
+    archive: "보관함",
     decisions: (n) => `결정 ${n}건`,
     decisionsTitle: "사람을 기다리는 결정",
     filters: {
@@ -234,6 +248,10 @@ export const ko: Messages = {
             : "",
     started: "시작",
     done: "완료",
+    archived: "보관됨",
+    archivedAt: "보관",
+    archive: "보관하기",
+    restore: "되살리기",
     form: {
       title: "제목",
       titlePlaceholder: "무엇을 할지, 제목만 보고도 알 수 있게.",
@@ -354,16 +372,38 @@ export const ko: Messages = {
     inProgress: (n) => `${n}개 진행 중`,
     noTasks: "아직 이 목표를 향한 작업이 없습니다.",
     tasks: "작업",
+    category: "카테고리",
+    noCategory: "카테고리 없음",
+    starts: "시작일",
+    noStart: "시작일 없음",
     target: "목표일",
     noTarget: "목표일 없음",
     setBy: "세운 사람",
     state: "상태",
     nothingMore: "더 적힌 내용이 없습니다.",
+    about: "이루면 무엇이 달라지나",
+    archiveTasks: "완료 작업 모두 보관",
+    archiveAsk: (n) => `이 목표의 완료·폐기 작업 ${n}건도 함께 보관할까요?`,
+    view: "보기",
+    views: { board: "보드", list: "목록", calendar: "캘린더" },
+    timeline: {
+      title: "달별 로드맵",
+      legend: "카테고리 색",
+      earlier: "한 달 앞으로",
+      later: "한 달 뒤로",
+      thisMonth: "이번 달",
+      today: "오늘",
+      nothing: "이 기간에 잡힌 목표가 없습니다.",
+      noDays: "날짜 없음",
+    },
     form: {
       title: "제목",
       body: "달성의 의미",
       bodyPlaceholder: "목표를 이루면 무엇이 참이 되는지, Markdown으로.",
       state: "상태",
+      category: "카테고리",
+      noCategory: "카테고리 없음",
+      startsOn: "시작일",
       dueOn: "목표일",
       set: "목표 세우기",
     },
@@ -504,6 +544,8 @@ export const ko: Messages = {
       taskUpdated: (fields, task) => `${task}의 ${fields}을(를) 바꿨습니다`,
       taskCommented: (task, excerpt) =>
         `${task}에 댓글을 남겼습니다${excerpt === undefined || excerpt === "" ? "" : `: ${excerpt}`}`,
+      taskArchived: (task) => `${task}을(를) 보관했습니다`,
+      taskRestored: (task) => `${task}을(를) 되살렸습니다`,
       decisionRaised: (question) => `질문했습니다: ${question}`,
       decisionAnswered: (question, option) => `"${question}"에 답했습니다: ${option}`,
       decisionUpdated: (fields, question) => `결정 "${question}"의 ${fields}을(를) 썼습니다`,
@@ -523,6 +565,19 @@ export const ko: Messages = {
     },
   },
 
+  archive: {
+    title: "보관함",
+    lead: "완료·폐기된 뒤 보관된 작업입니다. 보드·목록·캘린더에서는 빠지고, 번호로는 여전히 열립니다. 여기서 되살립니다.",
+    loading: "보관함을 불러오는 중",
+    empty: {
+      title: "보관된 작업이 없습니다",
+      body: "완료·폐기된 작업은 작업 페이지에서, 목표를 닫을 때 함께, 또는 일정 기간 뒤 콘솔이 보관합니다.",
+    },
+    since: "보관",
+    restore: "되살리기",
+    more: "더 보기",
+  },
+
   runs: {
     for: "대신:",
     since: "시작",
@@ -549,6 +604,16 @@ export const ko: Messages = {
     picture: (name) => `그림 ${name}`,
     label: (name) => `${name}의 댓글`,
   },
+  pictures: {
+    open: (name) => `그림 ${name} 크게 보기`,
+    label: (name) => `그림 ${name}, 크게`,
+    close: "닫기",
+    zoomIn: "확대",
+    zoomOut: "축소",
+    fit: "화면에 맞추기",
+    file: "파일 자체 열기",
+    hint: "휠·버튼·두 손가락으로 확대와 축소, 끌어서 이동, Esc로 닫기.",
+  },
 
   skills: {
     loading: "스킬을 불러오는 중",
@@ -559,13 +624,16 @@ export const ko: Messages = {
     },
     servedBy: "제공:",
     at: "주소:",
-    connect: "에이전트는 이 주소에 자기 MCP 연결로 스킬을 받습니다. 사람이 한 번 연결해 줍니다:",
+    connect:
+      "에이전트는 콘솔 명령(console skill <경로>)으로, 또는 이 주소에 자기 MCP 연결로 스킬을 받습니다. MCP 연결은 사람이 한 번 해 줍니다:",
     connectLink: "SkillCDN 페이지의 연결 안내",
     status: {
       indexing: "SkillCDN이 아직 저장소를 색인하고 있습니다. 잠시 후 다시 보세요.",
       failed: "SkillCDN이 저장소를 색인하지 못했습니다. 찾은 내용은 주소의 페이지에 있습니다.",
       not_found:
-        "SkillCDN이 이 주소를 제공하지 않거나, 그곳에 로그인한 사람에게만 제공합니다. 주소의 페이지에서 확인하세요.",
+        "SkillCDN이 이 주소를 콘솔에 제공하지 않습니다. 그곳에 아무것도 없거나, 비공개 팩인데 프로젝트에 팩 토큰이 없습니다(설정).",
+      token_invalid:
+        "프로젝트가 가진 팩 토큰이 SkillCDN에서 더 이상 통하지 않습니다. 만료되었거나 지워졌거나, 만든 사람이 저장소 권한을 잃었습니다. 소유자가 설정 페이지에서 새로 넣습니다.",
       unavailable:
         "SkillCDN에 연결할 수 없습니다. 스킬은 이전 상태 그대로입니다. 나중에 다시 보세요.",
     },
@@ -698,6 +766,13 @@ export const ko: Messages = {
     goodUntil: "만료",
     notActive: "아직 활동 없음",
     lastActive: "마지막 활동",
+    command: (version) => `console ${version}`,
+    commandVerdict: {
+      behind: "업데이트할 수 있음",
+      ahead: "이 콘솔보다 새 버전",
+      outdated: "업데이트 필요",
+      too_new: "이 콘솔에는 너무 새 버전",
+    },
     disconnect: "연결 끊기",
     form: {
       name: "이름",

package/src/index.ts

@@ -10,6 +10,7 @@ export {
   type BoardFiltersProps,
   type BoardProps,
   byDue,
+  columnStateOf,
   filterTasks,
   TaskCard,
 } from "./components/board.js";
@@ -78,6 +79,7 @@ export {
   type GoalListProps,
   GoalView,
   type GoalViewProps,
+  goalMonth,
 } from "./components/goals.js";
 export { Markdown, type MarkdownProps } from "./components/markdown.js";
 export { PAGE_SIZE, ShowMore, usePaged } from "./components/paged.js";
@@ -87,10 +89,32 @@ export {
   PeopleList,
   type PeopleListProps,
 } from "./components/people.js";
+export {
+  clampScale,
+  FITTED,
+  Lightbox,
+  type LightboxProps,
+  MAX_SCALE,
+  MIN_SCALE,
+  type Picture,
+  PictureOverlay,
+  type PictureOverlayProps,
+  type PictureState,
+  PictureThumb,
+  type PictureThumbProps,
+  type PictureView,
+  panBy,
+  usePicture,
+  wheelFactor,
+  ZOOM_STEP,
+  zoomAround,
+} from "./components/pictures.js";
 export {
   keyOf,
   MemberList,
   type MemberListProps,
+  PackTokenForm,
+  type PackTokenFormProps,
   PROJECT_ROLE_LABELS,
   ProjectForm,
   type ProjectFormProps,
@@ -100,6 +124,13 @@ export {
   ProjectRoleBadge,
   VISIBILITY_LABELS,
 } from "./components/projects.js";
+export {
+  DEFAULT_TIMELINE_MONTHS,
+  GoalTimeline,
+  type GoalTimelineProps,
+  type TimelineBar,
+  timelineBars,
+} from "./components/roadmap.js";
 export {
   RulesForm,
   type RulesFormProps,
@@ -216,6 +247,9 @@ export {
   type DocsView,
   decisionHref,
   docHref,
+  GOAL_TASK_VIEWS,
+  type GoalPageOptions,
+  type GoalTaskView,
   goalHref,
   matchRoute,
   movedFrom,
@@ -230,6 +264,7 @@ export {
   projectHref,
   projectSettingsHref,
   type Route,
+  roadmapHref,
   settingsHref,
   signInFailureOf,
   type TaskFormKind,

package/src/router.ts

@@ -59,22 +59,28 @@ export type Route =
       readonly month: string | undefined;
       readonly filter: BoardFilter;
     }
-  | { readonly name: "roadmap"; readonly project: string }
+  /** The roadmap of a project: the months shown from the one named, or from this one. */
+  | { readonly name: "roadmap"; readonly project: string; readonly from: string | undefined }
   | { readonly name: "new-goal"; readonly project: string }
+  /** One goal: its tasks as a board, a list or a calendar (on a month, or this one), or its form. */
   | {
       readonly name: "goal";
       readonly project: string;
       readonly id: string;
       readonly form: "edit" | undefined;
+      readonly view: GoalTaskView;
+      readonly month: string | undefined;
     }
   | { readonly name: "feed"; readonly project: string }
+  /** The archive of a project's board (ADR-0029): the tasks put away, read a page at a time. */
+  | { readonly name: "archive"; readonly project: string }
   | { readonly name: "skills"; readonly project: string }
   | { readonly name: "members"; readonly project: string }
   /** A project's settings, read; or one of its forms open: the project's own, or its rules (ADR-0023). */
   | {
       readonly name: "settings";
       readonly project: string;
-      readonly form: "edit" | "rules" | undefined;
+      readonly form: "edit" | "rules" | "pack-token" | undefined;
     }
   /** The workspace's settings: its rules, its categories, its skills; or the form the rules are written on. */
   | { readonly name: "workspace-settings"; readonly form: "rules" | undefined }
@@ -110,6 +116,7 @@ export type Route =
 export type ProjectPage =
   | "docs"
   | "decisions"
+  | "archive"
   | "calendar"
   | "roadmap"
   | "feed"
@@ -150,6 +157,7 @@ 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" | "calendar" | "roadmap" | "settings">[] = [
   "decisions",
+  "archive",
   "feed",
   "skills",
   "members",
@@ -330,9 +338,23 @@ export function matchRoute(pathname: string, search = ""): Route {
     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 (!UUID.test(third)) {
+      return NOT_FOUND;
+    }
+    const named = params.get("view");
+    const view = named === null ? "board" : isGoalTaskView(named) ? named : undefined;
+    const month = params.get("month");
+    if (view === undefined || (month !== null && !isMonth(month))) {
+      return NOT_FOUND;
+    }
+    return {
+      name: "goal",
+      project,
+      id: third,
+      form: params.has("edit") ? "edit" : undefined,
+      view,
+      month: month ?? undefined,
+    };
   }
   if (third !== undefined) {
     return NOT_FOUND;
@@ -345,13 +367,23 @@ export function matchRoute(pathname: string, search = ""): Route {
     return { name: "calendar", project, month: month ?? undefined, filter: boardFilterOf(params) };
   }
   if (page === "roadmap") {
-    return { name: "roadmap", project };
+    const from = params.get("from");
+    if (from !== null && !isMonth(from)) {
+      return NOT_FOUND;
+    }
+    return { name: "roadmap", project, from: from ?? undefined };
   }
   if (page === "settings") {
     return {
       name: "settings",
       project,
-      form: params.has("edit") ? "edit" : params.has("rules") ? "rules" : undefined,
+      form: params.has("edit")
+        ? "edit"
+        : params.has("rules")
+          ? "rules"
+          : params.has("pack-token")
+            ? "pack-token"
+            : undefined,
     };
   }
   const found = PLAIN_PAGES.find((candidate) => candidate === page);
@@ -381,7 +413,7 @@ export function projectHref(key: string, page?: ProjectPage): string {
 }
 
 /** Where a project's settings are read, or one of their forms is open: the project's own, or its rules. */
-export function projectSettingsHref(key: string, form?: "edit" | "rules"): string {
+export function projectSettingsHref(key: string, form?: "edit" | "rules" | "pack-token"): string {
   const base = projectHref(key, "settings");
   return form === undefined ? base : `${base}?${form}`;
 }
@@ -455,14 +487,41 @@ export function customPageHref(page: string, project?: string): string {
 }
 
 /** Where a goal is set: the form. */
+/** Where a project's roadmap is, from a month on, or from this one when none is named. */
+export function roadmapHref(key: string, from?: string): string {
+  const base = projectHref(key, "roadmap");
+  return from === undefined ? base : `${base}?from=${from}`;
+}
+
 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 {
+/** The views of a goal's tasks: the board of them, the list by state, or the calendar. */
+export const GOAL_TASK_VIEWS = ["board", "list", "calendar"] as const;
+export type GoalTaskView = (typeof GOAL_TASK_VIEWS)[number];
+
+function isGoalTaskView(value: string): value is GoalTaskView {
+  return (GOAL_TASK_VIEWS as readonly string[]).includes(value);
+}
+
+/** What a goal's address may say besides the goal: its form, the view of its tasks, the calendar's month. */
+export interface GoalPageOptions {
+  readonly form?: "edit" | undefined;
+  /** The board is the view an address without one shows. */
+  readonly view?: GoalTaskView | undefined;
+  readonly month?: string | undefined;
+}
+
+/** Where one goal is read, in a view of its tasks, or changed. */
+export function goalHref(key: string, id: string, options: GoalPageOptions = {}): string {
   const base = `${PATHS.project}/${key}/roadmap/${id}`;
-  return form === undefined ? base : `${base}?${form}`;
+  const parts = [
+    ...(options.form === undefined ? [] : [options.form]),
+    ...(options.view === undefined || options.view === "board" ? [] : [`view=${options.view}`]),
+    ...(options.month === undefined ? [] : [`month=${options.month}`]),
+  ];
+  return parts.length === 0 ? base : `${base}?${parts.join("&")}`;
 }
 
 /**