@skillcdn/console 0.3.2 → 0.4.1

package/src/i18n/ko.ts

@@ -93,6 +93,7 @@ export const ko: Messages = {
   nav: {
     projects: "프로젝트",
     work: "내 작업",
+    myDecisions: "내 결정",
     people: "사람들",
     agents: "에이전트",
     board: "보드",
@@ -118,7 +119,13 @@ export const ko: Messages = {
 
   signIn: {
     lead: "AI 에이전트로 이뤄진 조직에 합류하세요.",
-    continueWith: (provider) => `${provider}로 계속`,
+    signInWith: (provider) => `${provider}로 로그인`,
+    going: (provider) => `${provider}로 가는 중…`,
+    admits: {
+      organization: (name) => `GitHub 조직 ${name}의 멤버가 로그인할 수 있습니다.`,
+      domains: (domains) => `${domains} 계정이 로그인할 수 있습니다.`,
+      listed: "관리자가 추가한 사람이 로그인할 수 있습니다.",
+    },
     nobody: {
       title: "아직 아무도 로그인할 수 없습니다",
       body: "이 콘솔에는 로그인이 설정되어 있지 않습니다. 운영자가 deploy/README.md에 따라 설정합니다.",
@@ -137,6 +144,8 @@ export const ko: Messages = {
     empty: {
       title: "아직 프로젝트가 없습니다",
       body: "첫 프로젝트를 만드세요. 무엇을 위한 것인지, 누가 함께하는지. 또는 소유자에게 추가를 요청하세요.",
+      bodyMember:
+        "프로젝트는 관리자가 만듭니다. 관리자에게 첫 프로젝트를, 또는 소유자에게 추가를 요청하세요.",
     },
     list: "프로젝트",
     private: "비공개",
@@ -239,8 +248,11 @@ export const ko: Messages = {
     menu: "작업 메뉴",
     decisions: (n) => `결정 ${n}건`,
     decisionsTitle: "사람을 기다리는 결정",
+    unfold: (column) => `${column} 펼치기`,
+    fold: (column) => `${column} 접기`,
     filters: {
       aria: "보드 좁혀 보기",
+      words: "제목, 번호, 사람",
       everyone: "모두",
       mine: "내 작업",
       anyCategory: "모든 카테고리",
@@ -340,6 +352,8 @@ export const ko: Messages = {
     record: "기록",
     openRecord: "열기",
     waitingForPerson: "사람을 기다리는 중입니다.",
+    waitingFor: (name) => `${name}의 답을 기다리는 중입니다.`,
+    peopleLabel: (asker, decider) => `올린 사람 ${asker}, 답할 사람 ${decider}`,
     options: "선택지",
     notePlaceholder: "덧붙일 말이 있다면",
     own: "직접 입력",
@@ -362,6 +376,9 @@ export const ko: Messages = {
       contextPlaceholder: "답하려면 알아야 할 것, Markdown으로.",
       about: "관련 작업",
       noTask: "특정 작업 없음",
+      decider: "결정할 사람",
+      deciderPlaceholder: "지정하지 않으면 본인",
+      me: "(나)",
       options: "선택지",
       option: (n) => `선택지 ${n}`,
       addOption: "선택지 추가",
@@ -369,6 +386,23 @@ export const ko: Messages = {
     },
   },
 
+  myDecisions: {
+    title: "내 결정",
+    loading: "내 결정을 불러오는 중",
+    couldNotLoad: "내 결정을 불러올 수 없습니다.",
+    empty: {
+      title: "내 결정이 없습니다",
+      body: "내게 온 결정과 내가 다른 사람에게 올린 결정이 여기에 모입니다. 내가 올린 결정은 내 에이전트가 올린 것을 포함합니다.",
+    },
+    waiting: "내 답을 기다리는 중",
+    noneWaiting: "내 답을 기다리는 결정이 없습니다.",
+    raised: "내가 다른 사람에게 올린 결정",
+    noneRaised: "다른 사람에게 올린 결정이 없습니다.",
+    answered: "답변됨",
+    noneAnswered: "아직 답한 결정이 없습니다.",
+    more: "더 보기",
+  },
+
   calendar: {
     title: "캘린더",
     grid: "이 달",
@@ -381,6 +415,11 @@ export const ko: Messages = {
     nothingOverdue: "기한이 지난 작업이 없습니다.",
     unscheduled: "날짜 없음",
     allScheduled: "열린 작업마다 날짜가 있습니다.",
+    more: (n) => `${n}개 더`,
+    fewer: "접기",
+    onDay: (day) => `${day}의 작업`,
+    nothingOnDay: "이 날에 잡힌 작업이 없습니다.",
+    close: "닫기",
     week: {
       title: "이 주",
       previous: "이전 주",
@@ -389,7 +428,7 @@ export const ko: Messages = {
       nothing: "이 주에 잡힌 작업이 없습니다.",
     },
     workload: {
-      title: "누가 무엇을",
+      title: "담당자별 작업 현황",
       person: "사람",
       open: "열림",
       inProgress: "진행 중",
@@ -471,8 +510,8 @@ export const ko: Messages = {
     thisWeek: "이번 주 마감",
     later: "그 뒤",
     noDay: "날짜 없음",
-    decisions: "사람을 기다리는 결정",
-    noDecisions: "기다리는 결정이 없습니다.",
+    decisions: "내 답을 기다리는 결정",
+    noDecisions: "내 답을 기다리는 결정이 없습니다.",
     inProject: (project) => `${project}에서`,
   },
 
@@ -632,6 +671,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}을(를) 보관했습니다`,
@@ -757,6 +798,7 @@ export const ko: Messages = {
     version: (n) => `v${n}`,
     versionWord: "버전",
     writtenBy: "작성:",
+    author: "작성",
     versionOf: (n, of) => `버전 ${n} / ${of}`,
     showLatest: "최신 버전 보기",
     archivedNotice: "이 페이지는 보관됐습니다. 폴더와 검색에서 빠지고, 쓸 수 없습니다.",
@@ -769,6 +811,8 @@ export const ko: Messages = {
     decisionPrefix: "결정: ",
     files: "파일",
     fileToAttach: "첨부할 파일",
+    chooseFile: "파일 선택",
+    noFileChosen: "선택된 파일 없음",
     labelPlaceholder: "파일 이름 대신 부를 이름",
     attach: "첨부",
     by: "첨부:",
@@ -808,6 +852,8 @@ export const ko: Messages = {
       domain: "도메인의 계정",
       listed: "관리자가 추가함",
     },
+    ofOrganization: (name) => `${name} 조직의 구성원`,
+    ofDomain: (domain) => `${domain} 도메인의 계정`,
     at: { gh: "GitHub", google: "Google" },
     organization: (name) => `GitHub 조직 ${name}이(가) 구성원을 정합니다.`,
     organizationRead: "마지막으로 읽음",

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,
@@ -207,6 +209,7 @@ export {
   formatBytes,
   formatInstant,
   GoalStateBadge,
+  LinkButton,
   PersonChip,
   PRIORITY_LABELS,
   PriorityBadge,

package/src/limits.ts

@@ -79,3 +79,17 @@ export const MAX_PROJECT_SYMBOL_LENGTH = 8;
 export const MAX_PROJECT_ICON_BYTES = 512 * 1024;
 /** How many items a listing answers with when none is asked for, and the most one may ask for. */
 export const DEFAULT_PAGE_LIMIT = 50;
+/**
+ * How many projects one workspace holds, how many tasks, goals, decisions and pages one project
+ * holds, and how many runs one task carries, those put away included: bounds a runaway script
+ * meets and real work does not.
+ */
+export const MAX_PROJECTS_PER_WORKSPACE = 500;
+export const MAX_TASKS_PER_PROJECT = 20_000;
+export const MAX_GOALS_PER_PROJECT = 1_000;
+export const MAX_DECISIONS_PER_PROJECT = 20_000;
+export const MAX_DOCUMENTS_PER_PROJECT = 5_000;
+export const MAX_RUNS_PER_TASK = 500;
+/** How many streams of the live feed one person holds at once, across their tabs, and how many one process of the console holds for everyone. */
+export const MAX_STREAMS_PER_PERSON = 20;
+export const MAX_STREAMS = 1_000;

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

@@ -9,6 +9,8 @@ export const REST_ROUTES = {
   me: "/api/v1/me",
   /** The token a request is made with, for it to give itself up. */
   meToken: "/api/v1/me/token",
+  /** A picture from elsewhere, fetched by the console for a page (ADR-0048); `?src=` names it. */
+  pictures: "/api/v1/pictures",
   /** The workspace's settings (ADR-0035), changed by an administrator; read through `me`. */
   workspace: "/api/v1/workspace",
   /** The SkillCDN token the organization's pack is read with (ADR-0036), an administrator's; `/connect` under it connects one with a code. */
@@ -27,8 +29,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

@@ -167,6 +167,18 @@ export const restProviderSchema = z.object({
   key: z.enum(PROVIDER_KEYS),
   /** What people read on the button. */
   label: z.string(),
+  /**
+   * Who this way in lets in, for the line under the button: the organization at the git host
+   * whose members are in, the Workspace domains whose accounts are, or neither, where only the
+   * logins an administrator listed get in. Answered from 0.4.1; read as optional, so that a
+   * console built on this package reads an older console's answer.
+   */
+  admits: z.optional(
+    z.object({
+      organization: z.nullable(z.string()),
+      domains: z.array(z.string()),
+    }),
+  ),
 });
 export type RestProvider = z.infer<typeof restProviderSchema>;
 
@@ -652,6 +664,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. */
@@ -690,9 +704,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 they work on, and the decisions that wait for a person, 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.
+ * 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 })),
@@ -701,6 +715,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
@@ -722,6 +747,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>;
 
@@ -779,8 +806,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. */
@@ -1079,9 +1107,10 @@ export const restPackConnectStartedSchema = z.object({
 export type RestPackConnectStarted = z.infer<typeof restPackConnectStartedSchema>;
 
 /**
- * `GET .../pack-token/connect`: how the connection stands. Nothing asked; waiting for the
- * person, with what they were shown; connected, the token kept and the project as it stands; or
- * ended short of a token, and why.
+ * `GET .../pack-token/connect` and `POST .../pack-token/connect/claim`: how the connection
+ * stands. Nothing asked; waiting for the person, with what they were shown; connected, which
+ * only the claim answers (ADR-0046), the token kept and the project as it stands; or ended
+ * short of a token, and why.
  */
 const packConnectNone = z.object({ status: z.literal("none") });
 const packConnectPending = z.object({
@@ -1103,7 +1132,7 @@ export const restPackConnectSchema = z.union([
 ]);
 export type RestPackConnect = z.infer<typeof restPackConnectSchema>;
 
-/** `GET /api/v1/workspace/pack-token/connect`: the same, for the workspace's token, with the workspace as it stands once connected. */
+/** `GET /api/v1/workspace/pack-token/connect` and `POST .../connect/claim`: the same, for the workspace's token, with the workspace as it stands once connected. */
 export const restWorkspacePackConnectSchema = z.union([
   packConnectNone,
   packConnectPending,