@skillcdn/console 0.1.16 → 0.1.18

package/src/i18n/en.ts

@@ -249,8 +249,6 @@ export const en = {
     raiseDecision: "Raise a decision",
     nothingMore: "Nothing more was written about it.",
     links: "Links",
-    runs: "Runs",
-    decisions: "Decisions",
     history: "What happened",
     subtasks: "Subtasks",
     partOfIt: "Part of it",
@@ -387,16 +385,33 @@ 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.",
+    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 +553,8 @@ export const en = {
       taskCreated: (task: string) => `wrote ${task}`,
       taskMoved: (task: string, from: string, to: string) => `moved ${task} from ${from} to ${to}`,
       taskUpdated: (fields: string, task: string) => `changed ${fields} of ${task}`,
+      taskCommented: (task: string, excerpt: string | undefined) =>
+        `commented on ${task}${excerpt === undefined || excerpt === "" ? "" : `: ${excerpt}`}`,
       decisionRaised: (question: string) => `asked: ${question}`,
       decisionAnswered: (question: string, option: string) => `answered "${question}": ${option}`,
       decisionUpdated: (fields: string, question: string) =>
@@ -571,6 +588,20 @@ export const en = {
     label: (agent: string, name: string) => `${agent} for ${name}`,
   },
 
+  comments: {
+    title: "Discussion",
+    empty: "Nothing was said yet.",
+    one: "Comment",
+    write: "Write a comment",
+    placeholder: "A word in the discussion, in Markdown.",
+    files: "Files",
+    chooseFiles: "Add files",
+    hint: "A picture pasted or chosen here goes with the comment; ![words](its name) places it in the text.",
+    removeFile: (name: string) => `Take ${name} out`,
+    picture: (name: string) => `The picture ${name}`,
+    label: (name: string) => `A comment by ${name}`,
+  },
+
   skills: {
     loading: "Loading the skills",
     list: "Skills",
@@ -720,6 +751,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

@@ -218,8 +218,6 @@ export const ko: Messages = {
     raiseDecision: "결정 요청",
     nothingMore: "더 적힌 내용이 없습니다.",
     links: "링크",
-    runs: "실행",
-    decisions: "결정",
     history: "일어난 일",
     subtasks: "하위 작업",
     partOfIt: "하위 작업",
@@ -356,16 +354,33 @@ export const ko: Messages = {
     inProgress: (n) => `${n}개 진행 중`,
     noTasks: "아직 이 목표를 향한 작업이 없습니다.",
     tasks: "작업",
+    category: "카테고리",
+    noCategory: "카테고리 없음",
+    starts: "시작일",
+    noStart: "시작일 없음",
     target: "목표일",
     noTarget: "목표일 없음",
     setBy: "세운 사람",
     state: "상태",
     nothingMore: "더 적힌 내용이 없습니다.",
+    timeline: {
+      title: "달별 로드맵",
+      legend: "카테고리 색",
+      earlier: "한 달 앞으로",
+      later: "한 달 뒤로",
+      thisMonth: "이번 달",
+      today: "오늘",
+      nothing: "이 기간에 잡힌 목표가 없습니다.",
+      noDays: "날짜 없음",
+    },
     form: {
       title: "제목",
       body: "달성의 의미",
       bodyPlaceholder: "목표를 이루면 무엇이 참이 되는지, Markdown으로.",
       state: "상태",
+      category: "카테고리",
+      noCategory: "카테고리 없음",
+      startsOn: "시작일",
       dueOn: "목표일",
       set: "목표 세우기",
     },
@@ -504,6 +519,8 @@ export const ko: Messages = {
       taskCreated: (task) => `${task}을(를) 썼습니다`,
       taskMoved: (task, from, to) => `${task}을(를) ${from}에서 ${to}(으)로 옮겼습니다`,
       taskUpdated: (fields, task) => `${task}의 ${fields}을(를) 바꿨습니다`,
+      taskCommented: (task, excerpt) =>
+        `${task}에 댓글을 남겼습니다${excerpt === undefined || excerpt === "" ? "" : `: ${excerpt}`}`,
       decisionRaised: (question) => `질문했습니다: ${question}`,
       decisionAnswered: (question, option) => `"${question}"에 답했습니다: ${option}`,
       decisionUpdated: (fields, question) => `결정 "${question}"의 ${fields}을(를) 썼습니다`,
@@ -536,6 +553,20 @@ export const ko: Messages = {
     label: (agent, name) => `${name}을(를) 위한 ${agent}`,
   },
 
+  comments: {
+    title: "논의",
+    empty: "아직 아무 말도 없습니다.",
+    one: "댓글 남기기",
+    write: "댓글 쓰기",
+    placeholder: "논의에 보탤 말을 마크다운으로.",
+    files: "파일",
+    chooseFiles: "파일 추가",
+    hint: "여기에 붙여 넣거나 고른 그림은 댓글과 함께 올라갑니다. ![설명](파일 이름)으로 본문에 넣을 수 있습니다.",
+    removeFile: (name) => `${name} 빼기`,
+    picture: (name) => `그림 ${name}`,
+    label: (name) => `${name}의 댓글`,
+  },
+
   skills: {
     loading: "스킬을 불러오는 중",
     list: "스킬",
@@ -684,6 +715,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

@@ -26,6 +26,18 @@ export {
   workloadOf,
 } from "./components/calendar.js";
 export { CategoryList, type CategoryListProps } from "./components/categories.js";
+export {
+  CommentCard,
+  type CommentCardProps,
+  type CommentDraft,
+  CommentForm,
+  type CommentFormProps,
+  isPicture,
+  TaskThread,
+  type TaskThreadProps,
+  type ThreadItem,
+  threadOf,
+} from "./components/comments.js";
 export {
   ConnectApproval,
   type ConnectApprovalProps,
@@ -88,6 +100,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,
@@ -218,6 +237,7 @@ export {
   projectHref,
   projectSettingsHref,
   type Route,
+  roadmapHref,
   settingsHref,
   signInFailureOf,
   type TaskFormKind,

package/src/limits.ts

@@ -28,6 +28,9 @@ export const MAX_SUMMARY_LENGTH = 2000;
 /** How many reports, and how many artifacts, one run may carry. */
 export const MAX_REPORTS_PER_RUN = 500;
 export const MAX_ARTIFACTS_PER_RUN = 50;
+/** How many comments one task carries, and how many files one comment carries, together within `MAX_FILE_BYTES`. */
+export const MAX_COMMENTS_PER_TASK = 500;
+export const MAX_FILES_PER_COMMENT = 10;
 /** A file a run hands in: how many bytes, and its name, one line without a path. */
 export const MAX_FILE_BYTES = 10 * 1024 * 1024;
 export const MAX_FILE_NAME_LENGTH = 200;

package/src/router.ts

@@ -59,7 +59,8 @@ 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 }
   | {
       readonly name: "goal";
@@ -345,7 +346,11 @@ 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 {
@@ -455,6 +460,12 @@ 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`;
 }

package/src/rules.ts

@@ -23,7 +23,7 @@ export const REFERENCE_RULES = [
   "",
   "## Start here, every time",
   "",
-  "1. These rules come with the task: `console take` prints them under it, and `console rules` reads them any time. Read them before anything is made. The task says where the work is and what it links to; `console task <number>` shows a task in full, with its plan, its decisions and the runs on it, without taking it. How the board is worked is the skill working-the-board, shipped with the command (`console skills` says where it is); these rules say what this organization asks, not how the command works.",
+  "1. These rules come with the task: `console take` prints them under it, and `console rules` reads them any time. Read them before anything is made. The task says where the work is and what it links to; `console task <number>` shows a task in full, with its plan, its decisions, the runs on it and the discussion on it, without taking it. How the board is worked is the skill working-the-board, shipped with the command (`console skills` says where it is); these rules say what this organization asks, not how the command works.",
   "2. Act as the person whose token the command holds, and no further. What they may not do, the console refuses; that step goes back to them in a report, never around them.",
   "",
   "## The organization's skills",
@@ -44,7 +44,7 @@ export const REFERENCE_RULES = [
   "",
   "## Reports",
   "",
-  "Report at the milestones, not every step: what was found, what was done, what is next, in words for people; a problem as a problem, with what it blocks. What people read on the board, the reports, the questions and their options, the tasks and the pages, is written in {language}. A task's title says what is to be done, in plain words that stand on their own; what it refers to, a milestone, a commit, a page, goes in the body, linked where it can be. The result goes in a last report or is handed in as a link or a file, with the check that ran and its result; a check that did not run is said to be not run.",
+  "Report at the milestones, not every step: what was found, what was done, what is next, in words for people; a problem as a problem, with what it blocks. What people read on the board, the reports, the questions and their options, the tasks and the pages, is written in {language}. A task's title says what is to be done, in plain words that stand on their own; what it refers to, a milestone, a commit, a page, goes in the body, linked where it can be. The result goes in a last report or is handed in as a link or a file, with the check that ran and its result; a check that did not run is said to be not run. A report is the run's record; a word to the task's people, an answer to what they asked in its comments, a question that is not a decision, a remark, is a comment on the task (`console comment`), and what they put in a comment is read with `console file`.",
   "",
   "## What never happens",
   "",

package/src/schemas.ts

@@ -196,6 +196,13 @@ export const restMeSchema = z.object({
   /** The language the person chose for the pages (ADR-0012), or `null` for the browser's. */
   language: z.nullable(languageTag),
   signIn: z.array(restProviderSchema),
+  /**
+   * The console's version and the range of command versions it takes, as npm spells one
+   * (ADR-0025): what a console of a person's own compares the package it was built on with.
+   * Every console answers it from 0.1.18; read as optional, so that a command or a console
+   * built on this package still reads an older console's answer, and says it is older.
+   */
+  console: z.optional(z.object({ version: z.string(), clientRange: z.string() })),
 });
 export type RestMe = z.infer<typeof restMeSchema>;
 
@@ -485,6 +492,12 @@ export const restGoalSchema = z.object({
   /** Markdown: what reaching the goal means. Shown as text or rendered to elements, never as HTML. */
   body: z.string(),
   state: z.enum(GOAL_STATES),
+  /** The category the goal is sorted into, as the workspace keeps it, or `null` (ADR-0026). */
+  category: z.nullable(
+    z.object({ key: z.string(), name: z.string(), color: z.enum(CATEGORY_COLORS) }),
+  ),
+  /** The plan (ADR-0026): the day the work towards the goal is meant to begin, or `null`. */
+  startsOn: z.nullable(day),
   /** The day the goal is meant to be reached by, or `null`. */
   dueOn: z.nullable(day),
   createdBy: restPersonSchema,
@@ -505,6 +518,9 @@ export const restGoalInputSchema = z.object({
   body: z.optional(body),
   /** Left out: `planned`. */
   state: z.optional(z.enum(GOAL_STATES)),
+  /** The key of a category of the workspace, or `null` for none. */
+  category: z.optional(z.nullable(categoryKey)),
+  startsOn: z.optional(z.nullable(day)),
   dueOn: z.optional(z.nullable(day)),
 });
 export type RestGoalInput = z.infer<typeof restGoalInputSchema>;
@@ -514,6 +530,8 @@ export const restGoalPatchSchema = z.object({
   title: z.optional(line(MAX_TITLE_LENGTH)),
   body: z.optional(body),
   state: z.optional(z.enum(GOAL_STATES)),
+  category: z.optional(z.nullable(categoryKey)),
+  startsOn: z.optional(z.nullable(day)),
   dueOn: z.optional(z.nullable(day)),
 });
 export type RestGoalPatch = z.infer<typeof restGoalPatchSchema>;
@@ -647,8 +665,10 @@ export const restEventDataSchema = z.object({
   status: z.optional(z.enum(RUN_STATUSES)),
   /** For `run.handed_in`: what the artifact is called. */
   label: z.optional(z.string()),
-  /** For `run.reported`: the first words of the report. */
+  /** For `run.reported` and `task.commented`: the first words of what was written. */
   excerpt: z.optional(z.string()),
+  /** For `task.commented`: how many files came with it. */
+  files: z.optional(z.int()),
 });
 export type RestEventData = z.infer<typeof restEventDataSchema>;
 
@@ -740,6 +760,34 @@ export type RestRun = z.infer<typeof restRunSchema>;
 export const restRunsSchema = z.object({ items: z.array(restRunSchema), more: z.boolean() });
 export type RestRuns = z.infer<typeof restRunsSchema>;
 
+/** A file put in a comment, kept as a run's file is; its bytes are at `projectPath(key, "files", <id>)`. */
+export const restCommentFileSchema = z.object({
+  id: uuid,
+  file: restFileSchema,
+});
+export type RestCommentFile = z.infer<typeof restCommentFileSchema>;
+
+/**
+ * A word in the discussion on a task (ADR-0024): by a person, or by their agent, with the
+ * files put in it. Never rewritten: a mistake is corrected in the next one.
+ */
+export const restCommentSchema = z.object({
+  id: uuid,
+  taskId: uuid,
+  author: restPersonSchema,
+  /** The agent the author wrote through, or `null` when a person wrote it themselves. */
+  agent: z.nullable(z.string()),
+  /** Markdown. A picture among the files is placed in it as `![words](its name)`. */
+  body: z.string(),
+  files: z.array(restCommentFileSchema),
+  createdAt: instant,
+});
+export type RestComment = z.infer<typeof restCommentSchema>;
+
+/** `GET .../tasks/<id>/comments`: the discussion on a task, oldest first, whole. */
+export const restCommentsSchema = z.object({ items: z.array(restCommentSchema) });
+export type RestComments = z.infer<typeof restCommentsSchema>;
+
 /** `GET .../events?after=`: what happened after that number, oldest first. */
 export const restEventsSchema = z.object({
   items: z.array(restEventSchema),
@@ -761,6 +809,8 @@ export const restTokenSchema = z.object({
   expiresAt: z.nullable(instant),
   /** When it was last presented, or `null` if never. */
   lastUsedAt: z.nullable(instant),
+  /** The version of the command that last presented it (`0.1.18`), or `null` when the last to present it named none. */
+  client: z.nullable(z.string()),
 });
 export type RestToken = z.infer<typeof restTokenSchema>;
 
@@ -1032,6 +1082,15 @@ export const restReportInputSchema = z.object({
 });
 export type RestReportInput = z.infer<typeof restReportInputSchema>;
 
+/**
+ * What `POST .../tasks/<id>/comments` is sent as JSON: the word, in Markdown. As a form, the
+ * part `body` says the same and the parts `file` carry the files; then the body may be blank.
+ */
+export const restCommentInputSchema = z.object({
+  body,
+});
+export type RestCommentInput = z.infer<typeof restCommentInputSchema>;
+
 /** What `POST .../runs/<id>/artifacts` is sent: a link to what was made. */
 export const restArtifactInputSchema = z.object({
   url,