@skillcdn/console 0.1.13 → 0.1.15

package/src/i18n/ko.ts

@@ -18,6 +18,7 @@ export const ko: Messages = {
     },
     priority: { low: "낮음", normal: "보통", high: "높음", urgent: "긴급" },
     role: { admin: "관리자", member: "멤버" },
+    status: { active: "활성", deactivated: "비활성화" },
     projectRole: { owner: "소유자", member: "멤버" },
     visibility: { workspace: "워크스페이스의 모두", private: "목록에 있는 사람만" },
     runStatus: {
@@ -68,6 +69,8 @@ export const ko: Messages = {
     nobody: "없음",
     nothing: "없음",
     language: "언어",
+    copy: "복사",
+    copied: "복사됨",
     showMore: (n, of) => `${of}개 중 ${n}개 더 보기`,
   },
 
@@ -76,7 +79,6 @@ export const ko: Messages = {
     work: "내 작업",
     people: "사람들",
     agents: "에이전트",
-    categories: "카테고리",
     board: "보드",
     roadmap: "로드맵",
     calendar: "캘린더",
@@ -116,13 +118,13 @@ export const ko: Messages = {
   projects: {
     title: "프로젝트",
     newProject: "새 프로젝트",
-    lead: "프로젝트는 보드, 문서, 스킬, 사람들을 가집니다. 무엇을 보고 바꿀 수 있는지는 프로젝트마다 정해집니다. 소유자는 설정하고, 멤버는 일합니다.",
     empty: {
       title: "아직 프로젝트가 없습니다",
       body: "첫 프로젝트를 만드세요. 무엇을 위한 것인지, 누가 함께하는지. 또는 소유자에게 추가를 요청하세요.",
     },
     list: "프로젝트",
     private: "비공개",
+    public: "공개",
     decisionsWaiting: (n) => `결정 ${n}건 대기 중`,
     form: {
       aria: "새 프로젝트",
@@ -133,7 +135,11 @@ export const ko: Messages = {
       descriptionPlaceholder: "이 프로젝트가 무엇을 위한 것인지, 한두 문장으로.",
       whoIsMember: "멤버 범위",
       skillsAddress: "스킬 주소",
-      skillsAddressPlaceholder: "/gh/<owner>/<repo>, 비우면 조직의 스킬",
+      skillsAddressPlaceholder: "/gh/<owner>/<repo>",
+      skillsAddressHint: (address) =>
+        address === null
+          ? "비우면 이 프로젝트에 스킬이 없습니다. 콘솔에 조직의 주소가 없습니다."
+          : `비우면 조직의 스킬: ${address}`,
       symbol: "마크",
       image: "이미지",
       imageRemove: "이미지 지우기",
@@ -144,11 +150,6 @@ export const ko: Messages = {
     members: {
       title: "멤버",
       list: "멤버",
-      leadWorkspace:
-        "워크스페이스의 모두가 이 프로젝트의 멤버입니다. 여기 목록은 소유자와 따로 지정된 사람들입니다.",
-      leadPrivate: "여기 목록에 있는 사람만 이 프로젝트에 속합니다.",
-      leadRoles:
-        "소유자는 프로젝트를 설정하고, 멤버는 프로젝트에서 일합니다. 워크스페이스 관리자는 모든 프로젝트의 소유자입니다.",
       since: "부터",
       roleOf: (name) => `${name}의 역할`,
       addAria: "멤버 추가",
@@ -165,13 +166,9 @@ export const ko: Messages = {
     settings: {
       title: "설정",
       aria: "프로젝트 설정",
-      leadBefore: "키 ",
-      leadAfter:
-        "는 주소와 명령이 부르는 이름이며 바뀌지 않습니다. 스킬 주소는 SkillCDN이 제공하는 저장소를 가리킵니다. 비우면 조직의 스킬이 보입니다.",
-      onlyOwner: {
-        title: "소유자만 프로젝트를 바꿀 수 있습니다",
-        body: "소유자나 워크스페이스 관리자에게 요청하세요.",
-      },
+      edit: "프로젝트 편집",
+      organizationsSkills: (address) => `조직의 스킬: ${address}`,
+      noSkills: "없음: 콘솔에 조직의 주소가 없습니다.",
     },
   },
 
@@ -277,8 +274,6 @@ export const ko: Messages = {
     waiting: "대기 중",
     answered: "답변됨",
     record: "기록",
-    recordLead:
-      "답변된 모든 결정, 최신순. 무엇을 물었고, 무엇을 골랐고, 누가 골랐는지. 맥락과 근거, 그 뒤에 일어난 일은 각 결정을 열어 봅니다.",
     openRecord: "열기",
     waitingForPerson: "사람을 기다리는 중입니다.",
     options: "선택지",
@@ -309,10 +304,8 @@ export const ko: Messages = {
 
   calendar: {
     title: "캘린더",
-    lead: "작업을 날짜 위에 놓고 봅니다. 시작일과 기한이 있는 작업은 그 기간에 걸쳐 놓이고, 기한만 있는 작업은 그날에 놓입니다. 날짜가 없는 작업은 아래에서 날짜를 기다립니다.",
     grid: "이 달",
     legend: { title: "카테고리 색" },
-    startsOnly: "그날 시작, 기한은 아직 없음",
     previous: "이전 달",
     next: "다음 달",
     thisMonth: "이번 달",
@@ -321,9 +314,15 @@ export const ko: Messages = {
     nothingOverdue: "기한이 지난 작업이 없습니다.",
     unscheduled: "날짜 없음",
     allScheduled: "열린 작업마다 날짜가 있습니다.",
+    week: {
+      title: "이 주",
+      previous: "이전 주",
+      next: "다음 주",
+      thisWeek: "이번 주",
+      nothing: "이 주에 잡힌 작업이 없습니다.",
+    },
     workload: {
       title: "누가 무엇을",
-      lead: "사람마다 열린 작업과, 그중 늦은 것과 일주일 안에 마감인 것.",
       person: "사람",
       open: "열림",
       inProgress: "진행 중",
@@ -335,7 +334,6 @@ export const ko: Messages = {
 
   roadmap: {
     title: "로드맵",
-    lead: "프로젝트가 향하는 것. 목표마다 달성 목표일과, 그 아래 작업들이 어디까지 왔는지. 진행은 보드의 현재 상태에서 그대로 읽습니다.",
     setGoal: "목표 세우기",
     setGoalAria: "목표 세우기",
     editAria: "목표 바꾸기",
@@ -374,7 +372,6 @@ export const ko: Messages = {
 
   work: {
     title: "내 작업",
-    lead: "내 프로젝트들에 걸쳐 내게 놓인 일. 내게 배정된 열린 작업을 기한순으로, 그리고 사람을 기다리는 결정.",
     loading: "내 작업을 불러오는 중",
     couldNotLoad: "내 작업을 불러올 수 없습니다.",
     empty: {
@@ -392,8 +389,6 @@ export const ko: Messages = {
 
   categories: {
     title: "카테고리",
-    lead: "작업을 나누는 일의 종류이며, 모든 프로젝트에서 같습니다. 작업은 하나를 가지고, 보드는 하나로 좁혀 보며, 관리자가 목록을 관리합니다.",
-    onlyAdmin: "관리자가 추가하고 바꾸고 제거합니다. 다른 사람은 여기서 읽습니다.",
     list: "카테고리",
     add: "카테고리 추가",
     addAria: "카테고리 추가",
@@ -401,7 +396,6 @@ export const ko: Messages = {
       title: "카테고리가 없습니다",
       body: "관리자가 여기서 첫 카테고리를 추가합니다.",
     },
-    inUse: "작업이 속해 있는 카테고리는 그 작업들을 옮기기 전에는 제거할 수 없습니다.",
     form: {
       name: "이름",
       key: "키",
@@ -413,6 +407,39 @@ export const ko: Messages = {
     colorOf: (key) => `${key}의 색`,
   },
 
+  settings: {
+    title: "설정",
+    categories: "카테고리",
+    manageCategories: "카테고리 관리",
+    skills: "스킬",
+    skillsSource: "SkillCDN 제공 주소",
+    skillsAddress: "조직의 스킬",
+    noSkillsAddress: "주소 없음: 프로젝트마다 자기 주소를 두거나, 두지 않습니다.",
+    skillsFromConfiguration:
+      "콘솔을 운영하는 쪽이 설정으로 정합니다. 스킬을 읽어 오는 배포와 조직의 주소.",
+  },
+
+  rules: {
+    title: "규칙",
+    loading: "규칙을 불러오는 중",
+    reference:
+      "관리자가 조직의 규칙을 쓰기 전까지 콘솔의 기본 규칙이 적용됩니다. 콘솔 버전과 함께 바뀝니다.",
+    writeOrganizations: "조직의 규칙 쓰기",
+    useReference: "콘솔의 기본 규칙으로 초기화",
+    read: "규칙 읽기",
+    none: "이 프로젝트에 더하는 규칙이 없습니다. 워크스페이스의 규칙이 적용됩니다.",
+    write: "이 프로젝트의 규칙 쓰기",
+    projectRules: "이 프로젝트의 규칙",
+    workspaceRules: "워크스페이스의 규칙",
+    onWorkspaceSettings: "워크스페이스 설정에서 바꿉니다.",
+    form: {
+      body: "규칙",
+      hint: (max) =>
+        `Markdown, 최대 ${max}자. 여기서 일하는 모든 에이전트가 먼저 읽습니다. 먼저 불러올 스킬, 일이 있는 곳, 페이지, 혼자 정할 것, 보고 방식. {language}는 에이전트가 대신 일하는 사람의 언어로 바뀝니다. 토큰이나 비밀번호 같은 민감한 정보는 넣지 않습니다.`,
+      save: "규칙 저장",
+    },
+  },
+
   feed: {
     title: "일어난 일",
     list: "일어난 일",
@@ -457,6 +484,10 @@ export const ko: Messages = {
     event: {
       personJoined: () => "보드에 들어왔습니다",
       roleChanged: (login, role) => `${login}을(를) ${role}(으)로 지정했습니다`,
+      personListed: (login) => `${login}을(를) 추가했습니다`,
+      personUnlisted: (login) => `${login}을(를) 목록에서 뺐습니다`,
+      personDeactivated: (login) => `${login}을(를) 비활성화했습니다`,
+      personReactivated: (login) => `${login}을(를) 다시 활성화했습니다`,
       projectCreated: (project) => `프로젝트 ${project}을(를) 만들었습니다`,
       projectUpdated: (fields, project) => `프로젝트 ${project}의 ${fields}을(를) 바꿨습니다`,
       memberAdded: (login, project, role) =>
@@ -511,10 +542,10 @@ export const ko: Messages = {
       title: "아직 스킬 주소가 없습니다",
       body: "이 콘솔에는 조직의 스킬 주소가 없습니다. 운영자가 설정에서 SkillCDN이 제공하는 저장소를 지정합니다.",
     },
-    servedBy: "조직의 스킬. 제공:",
+    servedBy: "제공:",
     at: "주소:",
-    howLoaded:
-      ". 에이전트는 SkillCDN 연결을 통해 스킬을 불러오고, 사람은 해당 페이지에서 읽습니다.",
+    connect: "에이전트는 이 주소에 자기 MCP 연결로 스킬을 받습니다. 사람이 한 번 연결해 줍니다:",
+    connectLink: "SkillCDN 페이지의 연결 안내",
     status: {
       indexing: "SkillCDN이 아직 저장소를 색인하고 있습니다. 잠시 후 다시 보세요.",
       failed: "SkillCDN이 저장소를 색인하지 못했습니다. 찾은 내용은 주소의 페이지에 있습니다.",
@@ -592,12 +623,44 @@ export const ko: Messages = {
   people: {
     title: "사람들",
     list: "사람들",
-    lead: "로그인한 모든 사람. 관리자는 워크스페이스를 설정하고 각 사람의 역할을 정합니다. 멤버는 속한 프로젝트에서 일합니다. 사람이 할 수 있는 일은 그 사람의 에이전트도 할 수 있습니다.",
     roleOf: (name) => `${name}의 역할`,
+    letIn: "사람 추가",
+    letInAria: "사람 추가",
+    notSignedIn: "추가됨, 아직 로그인하지 않음",
+    deactivated: "비활성화됨",
+    deactivate: "비활성화",
+    reactivate: "다시 활성화",
+    leftOrganization: "조직에서 나감",
+    source: {
+      organization: "조직의 구성원",
+      domain: "도메인의 계정",
+      listed: "관리자가 추가함",
+    },
+    at: { gh: "GitHub", google: "Google" },
+    organization: (name) => `GitHub 조직 ${name}이(가) 구성원을 정합니다.`,
+    organizationRead: "마지막으로 읽음",
+    organizationNotRead: "아직 읽지 않았습니다.",
+    form: {
+      login: "로그인 아이디 또는 주소",
+      provider: "로그인 방식",
+      byShape: "아이디 모양대로",
+      hint: "GitHub 아이디나 Google 주소. 그 계정으로 로그인하는 사람이 들어옵니다.",
+      submit: "추가",
+    },
+    work: "작업",
+    workOf: (name) => `${name}의 작업`,
+    loadingWork: "작업을 불러오는 중",
+    couldNotLoadWork: "작업을 불러올 수 없습니다.",
+    noWork: {
+      title: (name) => `${name}에게 배정된 작업이 없습니다`,
+      body: "내가 볼 수 있는 프로젝트에서 그 사람에게 배정된 열린 작업이 여기에 나타납니다.",
+    },
+    notOverseen: {
+      title: "볼 수 없는 작업입니다",
+      body: "관리자는 모든 사람의 작업을, 소유자는 자기 프로젝트에 속한 사람의 작업을 봅니다.",
+    },
     agents: "에이전트",
     agentsOf: (name) => `${name}의 에이전트`,
-    agentsLead: (name) =>
-      `${name}(으)로 여기서 일하는 것들입니다. 각각 고유한 토큰을 가집니다. 연결을 끊으면 토큰이 즉시 사라집니다.`,
     loadingAgents: "에이전트를 불러오는 중",
     noAgent: "연결된 에이전트가 없습니다",
     onlyAdmin: {
@@ -610,7 +673,6 @@ export const ko: Messages = {
     title: "에이전트",
     makeByHand: "토큰 직접 만들기",
     makeAria: "토큰 만들기",
-    lead: "나로서 여기서 일하는 것들입니다. 연결한 각 에이전트는 아무도 볼 수 없는 고유한 토큰을 가집니다. 내가 할 수 있는 일은 에이전트도 할 수 있습니다. 더 쓰지 않으면 여기서 연결을 끊으세요. 내 스크립트나 콘솔도 직접 만든 토큰으로 같은 방식으로 일합니다.",
     empty: {
       title: "아직 연결된 에이전트가 없습니다",
       body: "아래처럼 에이전트에게 이 콘솔에 연결하라고 말하면 여기에 나타납니다.",
@@ -632,8 +694,6 @@ export const ko: Messages = {
     fresh: {
       ready: (name) => `토큰 "${name}"이(가) 준비됐습니다`,
       copyNow: "지금 복사하세요. 이번 한 번만 보이며, 콘솔은 해시만 보관합니다.",
-      copy: "복사",
-      copied: "복사됨",
       useIt:
         "이 토큰으로 console 명령을 로그인시키거나, REST API에 bearer 토큰으로 제시하거나, 내 콘솔이나 스크립트에 주세요.",
       removeWhenDone: "만료되지 않으니, 더 쓰지 않게 되면 여기서 제거하세요.",
@@ -645,7 +705,6 @@ export const ko: Messages = {
   connect: {
     title: "에이전트 연결",
     aria: "연결",
-    lead: "에이전트에게 이 콘솔에 연결하라고 말하면 코드를 보여 줍니다. 그 코드를 여기에 입력하고, 에이전트가 나로서 일해도 되는지 답하세요.",
     codeAria: "코드",
     codeLabel: "에이전트가 보여 준 코드",
     continue: "계속",
@@ -679,11 +738,9 @@ export const ko: Messages = {
       title: "에이전트 연결하기",
       tellYourAgent: "에이전트의 대화창에서 이렇게 말하세요:",
       quote: (origin) =>
-        `npm으로 @skillcdn/console을 설치하고, console login --url ${origin} 을 실행한 뒤 나오는 주소와 코드를 알려줘.`,
+        `이 두 명령을 실행하고, 두 번째 명령이 보여 주는 주소와 코드를 알려 줘:\nnpm install -g @skillcdn/console\nconsole login --url ${origin}`,
       doesTheRest:
         "명령을 실행할 수 있는 에이전트는 나머지를 알아서 합니다. 명령을 설치하고, 연결하고, 코드가 있는 주소를 보여 줍니다.",
-      thenApprove:
-        "여기에 로그인한 채 그 주소를 열고, 페이지에 같은 코드가 보이는지 확인하고, 에이전트에게 이름을 붙이고, 승인하세요. 그때부터 에이전트는 내가 할 수 있는 범위 안에서 나로서 여기서 일합니다. 더 쓰지 않으면 이 페이지에서 연결을 끊으세요. 에이전트가 가진 토큰은 나를 포함해 아무에게도 보이지 않습니다.",
       byHand: "에이전트가 명령을 대신 실행하지 않는다면, 직접:",
     },
   },

package/src/index.ts

@@ -16,6 +16,8 @@ export {
 export {
   Calendar,
   type CalendarProps,
+  Week,
+  type WeekProps,
   type WeekSegment,
   Workload,
   type WorkloadProps,
@@ -67,7 +69,12 @@ export {
 } from "./components/goals.js";
 export { Markdown, type MarkdownProps } from "./components/markdown.js";
 export { PAGE_SIZE, ShowMore, usePaged } from "./components/paged.js";
-export { PeopleList, type PeopleListProps } from "./components/people.js";
+export {
+  ListingForm,
+  type ListingFormProps,
+  PeopleList,
+  type PeopleListProps,
+} from "./components/people.js";
 export {
   keyOf,
   MemberList,
@@ -81,6 +88,12 @@ export {
   ProjectRoleBadge,
   VISIBILITY_LABELS,
 } from "./components/projects.js";
+export {
+  RulesForm,
+  type RulesFormProps,
+  RulesView,
+  type RulesViewProps,
+} from "./components/rules.js";
 export {
   RUN_STATUS_LABELS,
   RunCard,
@@ -116,6 +129,7 @@ export {
   Button,
   Callout,
   CategoryBadge,
+  CopyButton,
   cx,
   Day,
   DueBadge,
@@ -156,6 +170,7 @@ export {
   daysBetween,
   firstDayOfWeek,
   formatDay,
+  formatDays,
   formatMonth,
   formatWeekday,
   type GridDay,
@@ -165,6 +180,7 @@ export {
   monthOf,
   today,
   weekdays,
+  weekOf,
 } from "./dates.js";
 export { DocsPage, type DocsPageProps } from "./docs-page.js";
 export {
@@ -198,11 +214,15 @@ export {
   PATHS,
   type ProjectPage,
   personAgentsHref,
+  personWorkHref,
   projectHref,
+  projectSettingsHref,
   type Route,
+  settingsHref,
   signInFailureOf,
   type TaskFormKind,
   taskHref,
   withoutSignInParam,
+  workHref,
 } from "./router.js";
 export { errorWords, useAction } from "./use-action.js";

package/src/limits.ts

@@ -33,6 +33,8 @@ export const MAX_FILE_BYTES = 10 * 1024 * 1024;
 export const MAX_FILE_NAME_LENGTH = 200;
 /** What a person calls a token: the agent it is for, where it runs. One line. */
 export const MAX_TOKEN_NAME_LENGTH = 80;
+/** A login at a git host, or an address at a Workspace, as an administrator lists one. */
+export const MAX_LOGIN_LENGTH = 254;
 /** How long a token may be good for, in days, and how long one is when nothing is said. */
 export const MAX_TOKEN_DAYS = 365;
 export const DEFAULT_TOKEN_DAYS = 90;
@@ -54,6 +56,8 @@ export const MAX_DOCUMENT_PATH_LENGTH = 200;
 export const MAX_DOCUMENT_SEGMENT_LENGTH = 64;
 /** A document's body: a page of Markdown. */
 export const MAX_DOCUMENT_LENGTH = 64_000;
+/** The rules of a board, the workspace's or a project's (ADR-0023): kept short, since every agent reads them. */
+export const MAX_RULES_LENGTH = 12_000;
 /** How many versions one document keeps, and how many files attach to one. */
 export const MAX_VERSIONS_PER_DOCUMENT = 500;
 export const MAX_FILES_PER_DOCUMENT = 50;

package/src/router.ts

@@ -1,12 +1,12 @@
 import { isFolderPath, isSignInFailure, SIGN_IN_PARAM, type SignInFailure } from "./api.js";
-import { isMonth } from "./dates.js";
+import { isDay, 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, 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 page is shown (`?edit`, `?ask`, `?new`, `?version=`, `?q=`, `?month=`, `?week=`, 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";
@@ -70,14 +70,26 @@ export type Route =
   | { readonly name: "feed"; readonly project: string }
   | { readonly name: "skills"; readonly project: string }
   | { readonly name: "members"; readonly project: string }
-  | { readonly name: "settings"; 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;
+    }
+  /** 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 }
   | { readonly name: "people" }
+  /** The form where an administrator lets someone in by login (ADR-0022). */
+  | { readonly name: "new-listing" }
   /** The agents of one person, for an administrator. */
   | { readonly name: "person-agents"; readonly id: string }
+  /** Another person's plate, for whoever oversees them: a day of the week shown at the top, or today's. */
+  | { readonly name: "person-work"; readonly id: string; readonly week: string | undefined }
   | { readonly name: "agents" }
   | { readonly name: "new-token" }
   /** What is on the person's plate across their projects. */
-  | { readonly name: "work" }
+  /** 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 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. */
@@ -114,12 +126,16 @@ export const PATHS = {
   /** What is on the person's plate, across the projects they may see. */
   work: "/work",
   people: "/people",
+  /** The form where an administrator lets someone in by login. */
+  newListing: "/people/new",
   /** 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. */
+  /** The categories tasks are sorted into, kept by an administrator; reached from the settings. */
   categories: "/categories",
+  /** The workspace's settings: the rules, the categories, the skills (ADR-0023). */
+  settings: "/settings",
   /** Where the pages a console adds of its own are: `/pages/<key>`, and `/projects/<key>/pages/<page>` on a project. */
   pages: "/pages",
   /** Where an agent's connection is approved (ADR-0011): `/connect/<code>`, or the code typed. */
@@ -132,12 +148,11 @@ 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" | "calendar" | "roadmap">[] = [
+const PLAIN_PAGES: readonly Exclude<ProjectPage, "docs" | "calendar" | "roadmap" | "settings">[] = [
   "decisions",
   "feed",
   "skills",
   "members",
-  "settings",
 ];
 const NOT_FOUND: Route = { name: "not-found" };
 
@@ -192,6 +207,12 @@ const docsViewOf = (params: URLSearchParams, path: string): DocsView | undefined
   return { kind: "read" };
 };
 
+/** The week a plate's address names, or none for this week's; a value that is not a day is nobody's address. */
+function weekShown(params: URLSearchParams): { readonly week: string | undefined } | undefined {
+  const week = params.get("week");
+  return week !== null && !isDay(week) ? undefined : { week: week ?? undefined };
+}
+
 export function matchRoute(pathname: string, search = ""): Route {
   const path = pathname.length > 1 ? pathname.replace(/\/+$/, "") : pathname;
   const moved = movedFrom(path);
@@ -206,11 +227,15 @@ export function matchRoute(pathname: string, search = ""): Route {
     return { name: "new-project" };
   }
   if (path === PATHS.work) {
-    return { name: "work" };
+    const shown = weekShown(params);
+    return shown === undefined ? NOT_FOUND : { name: "work", ...shown };
   }
   if (path === PATHS.people) {
     return { name: "people" };
   }
+  if (path === PATHS.newListing) {
+    return { name: "new-listing" };
+  }
   if (path === PATHS.agents) {
     return { name: "agents" };
   }
@@ -220,6 +245,9 @@ export function matchRoute(pathname: string, search = ""): Route {
   if (path === PATHS.categories) {
     return { name: "categories" };
   }
+  if (path === PATHS.settings) {
+    return { name: "workspace-settings", form: params.has("rules") ? "rules" : undefined };
+  }
   if (path === PATHS.connect) {
     return { name: "connect", code: undefined };
   }
@@ -229,9 +257,17 @@ export function matchRoute(pathname: string, search = ""): Route {
   }
   if (path.startsWith(`${PATHS.people}/`)) {
     const [id, page, ...more] = path.slice(PATHS.people.length + 1).split("/");
-    return id !== undefined && UUID.test(id) && page === "agents" && more.length === 0
-      ? { name: "person-agents", id }
-      : NOT_FOUND;
+    if (id === undefined || !UUID.test(id) || more.length > 0) {
+      return NOT_FOUND;
+    }
+    if (page === "agents") {
+      return { name: "person-agents", id };
+    }
+    if (page === "work") {
+      const shown = weekShown(params);
+      return shown === undefined ? NOT_FOUND : { name: "person-work", id, ...shown };
+    }
+    return NOT_FOUND;
   }
   if (path.startsWith(`${PATHS.pages}/`)) {
     const [page, ...more] = path.slice(PATHS.pages.length + 1).split("/");
@@ -311,6 +347,13 @@ export function matchRoute(pathname: string, search = ""): Route {
   if (page === "roadmap") {
     return { name: "roadmap", project };
   }
+  if (page === "settings") {
+    return {
+      name: "settings",
+      project,
+      form: params.has("edit") ? "edit" : params.has("rules") ? "rules" : undefined,
+    };
+  }
   const found = PLAIN_PAGES.find((candidate) => candidate === page);
   return found === undefined ? NOT_FOUND : { name: found, project };
 }
@@ -325,12 +368,29 @@ export function personAgentsHref(personId: string): string {
   return `${PATHS.people}/${personId}/agents`;
 }
 
+/** Where another person's work is seen, with the week of a day at the top, or this week's when none is named. */
+export function personWorkHref(personId: string, week?: string): string {
+  const base = `${PATHS.people}/${personId}/work`;
+  return week === undefined ? base : `${base}?week=${week}`;
+}
+
 /** Where a project's board is, or one of its pages. */
 export function projectHref(key: string, page?: ProjectPage): string {
   const base = `${PATHS.project}/${key}`;
   return page === undefined ? base : `${base}/${page}`;
 }
 
+/** 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 {
+  const base = projectHref(key, "settings");
+  return form === undefined ? base : `${base}?${form}`;
+}
+
+/** Where the workspace's settings are, or the form its rules are written on. */
+export function settingsHref(form?: "rules"): string {
+  return form === undefined ? PATHS.settings : `${PATHS.settings}?${form}`;
+}
+
 /** 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 = filterParts(filter);
@@ -377,6 +437,11 @@ export function decisionHref(key: string, id: string): string {
   return `${PATHS.project}/${key}/decisions/${id}`;
 }
 
+/** Where the person's own work is, with the week of a day at the top, or this week's when none is named. */
+export function workHref(week?: string): string {
+  return week === undefined ? PATHS.work : `${PATHS.work}?week=${week}`;
+}
+
 /** Where a project's calendar is, on a month, or on this one when none is named, narrowed as the filter says. */
 export function calendarHref(key: string, month?: string, filter: BoardFilter = {}): string {
   const base = projectHref(key, "calendar");

package/src/routes.ts

@@ -7,8 +7,12 @@ import type { ProviderKey } from "./vocabulary.js";
 export const REST_ROUTES = {
   /** Who is signed in, what the workspace is called, and whether anyone can sign in. */
   me: "/api/v1/me",
-  /** The people of the workspace: everyone who has signed in. */
+  /** The token a request is made with, for it to give itself up. */
+  meToken: "/api/v1/me/token",
+  /** The people of the workspace: everyone who has signed in, and the logins let in that have not. */
   people: "/api/v1/people",
+  /** The logins an administrator let in (ADR-0022), made and removed by one. */
+  listings: "/api/v1/listings",
   /** The projects the asker may see; the board of each is under its key. */
   projects: "/api/v1/projects",
   /** The workspace's own events, the ones about no project: who joined, who was made what. */
@@ -21,8 +25,15 @@ export const REST_ROUTES = {
   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",
+  /** The rules of the board (ADR-0023): the console's own until an administrator writes the organization's. */
+  rules: "/api/v1/rules",
 } as const;
 
+/** The REST path of the workspace's rules put away, or of their versions. */
+export function rulesPath(part?: "archive" | "versions"): string {
+  return part === undefined ? REST_ROUTES.rules : `${REST_ROUTES.rules}/${part}`;
+}
+
 /** The REST path of one category, by its key. */
 export function categoryPath(key: string): string {
   return `${REST_ROUTES.categories}/${encodeURIComponent(key)}`;
@@ -37,6 +48,11 @@ export function connectPath(code: string, action?: "approve" | "deny"): string {
   return action === undefined ? base : `${base}/${action}`;
 }
 
+/** The REST path of another person's plate: for an administrator, or an owner of a project they are in. */
+export function personWorkPath(personId: string): string {
+  return `${restPath("people", personId)}/work`;
+}
+
 /** The REST path of a person's tokens, or of one of them: for an administrator. */
 export function personTokensPath(personId: string, tokenId?: string): string {
   const base = `${restPath("people", personId)}/tokens`;
@@ -54,6 +70,7 @@ export const PROJECT_COLLECTIONS = [
   "members",
   "docs",
   "goals",
+  "rules",
 ] as const;
 
 export type ProjectCollection = (typeof PROJECT_COLLECTIONS)[number];
@@ -94,8 +111,11 @@ export function signInPath(page: string, failure: SignInFailure): string {
   return `${page}${page.includes("?") ? "&" : "?"}${SIGN_IN_PARAM}=${failure}`;
 }
 
-/** The REST path of one person, token or project: the collection, then the id or the key. */
-export function restPath(collection: "people" | "tokens" | "projects", id: string): string {
+/** The REST path of one person, listing, token or project: the collection, then the id or the key. */
+export function restPath(
+  collection: "people" | "listings" | "tokens" | "projects",
+  id: string,
+): string {
   return `${REST_ROUTES[collection]}/${encodeURIComponent(id)}`;
 }