@skillcdn/console 0.3.1 → 0.4.0

package/src/cli/help.ts

@@ -13,6 +13,7 @@ import {
   MAX_FILES_PER_COMMENT,
   MAX_FILES_PER_DOCUMENT,
   MAX_LINK_LABEL_LENGTH,
+  MAX_NOTE_LENGTH,
   MAX_OPTION_LABEL_LENGTH,
   MAX_OPTIONS,
   MAX_PROJECT_DESCRIPTION_LENGTH,
@@ -23,9 +24,11 @@ import {
   MAX_QUESTION_LENGTH,
   MAX_REPORTS_PER_RUN,
   MAX_RULES_LENGTH,
+  MAX_SEARCH_LENGTH,
   MAX_SUMMARY_LENGTH,
   MAX_TITLE_LENGTH,
   MAX_VERSIONS_PER_DOCUMENT,
+  MAX_WORKERS,
   MIN_OPTIONS,
 } from "../limits.js";
 import { COLOR_NAMES } from "../vocabulary.js";
@@ -84,17 +87,17 @@ const DAY = "a day as 2026-10-24, today, tomorrow, or +7 for seven days from tod
 const COLORS = `one of ${COLOR_NAMES.join(", ")}`;
 const KEY = "lowercase letters, digits and hyphens";
 const TASK_FIELD_FLAGS =
-  "[--state <state>] [--priority <priority>] [--category <key>] [--goal <id>] [--starts <day>] [--due <day>] [--assignee <login|me>] [--parent <number|id>]";
+  "[--state <state>] [--priority <priority>] [--category <key>] [--goal <id>] [--starts <day>] [--due <day>] [--worker <login|me|none>]... [--parent <number|id>]";
 const TASK_FIELD_LIMITS = [
   `starts, due: ${DAY}; the due day is not before the start`,
   "category: the key of one of the workspace's categories (console categories); goal: the id of one of the project's goals (console goals)",
-  "assignee: a login of the workspace, or me; parent: a task of the project",
+  `worker: a login of the workspace, or me; given again, or with commas between, for several, up to ${MAX_WORKERS}, in place of the workers there were; none alone for nobody. parent: a task of the project, by its number or its id; console tasks --search <words> finds one by its title`,
 ];
 const TASK_FIELD_REFUSALS = [
   "task.invalid_category: no category has that key",
   "task.invalid_goal: the goal is not one of this project",
   "task.invalid_dates: the due day is before the start",
-  "task.invalid_assignee: the person may not work in the project",
+  "task.invalid_worker: a person named as a worker may not work in the project",
   "task.invalid_parent: the parent is not a task of the project, or would make a loop",
 ];
 
@@ -145,16 +148,17 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
   work: {
     usage: "work [--person <login>]",
     synopsis:
-      "What is on your plate across your projects: your open tasks, and the decisions waiting.",
+      "What is on your plate across your projects: your open tasks, and the decisions waiting for you.",
     about:
-      "What is on your plate across the projects you may see: the open tasks assigned to you, the sooner due first, each with its project; and the decisions waiting for a person. Needs no project. --person <login> shows another person's plate, for an administrator or for an owner of a project they are in: their open tasks within the projects you may see, without the decisions, which wait for anyone.",
+      "What is on your plate across the projects you may see: the open tasks you work on, the sooner due first, each with its project; and the decisions waiting for your answer (ADR-0042). Needs no project. --person <login> shows another person's plate, for an administrator or for an owner of a project they are in: the open tasks they work on within the projects you may see, without the decisions.",
   },
   tasks: {
     usage:
-      "tasks [--state <state>] [--open] [--mine] [--category <key>] [--goal <id>] [--due <day|today|week|overdue>] [--unassigned] [--archived] [--limit <n>] [--offset <n>]",
+      "tasks [--state <state>] [--open] [--mine] [--category <key>] [--goal <id>] [--due <day|today|week|overdue>] [--unassigned] [--search <words>] [--archived] [--limit <n>] [--offset <n>]",
     synopsis:
-      "The tasks on the board, newest first, narrowed by state, owner, category, goal or due day.",
-    about: `The tasks on the board, newest first: number, state, priority, title, who owns and works on each, its category and its due day, and what waits on it. --open keeps the ones not done or dropped, --mine those assigned to you, --unassigned those assigned to nobody (not with --mine), --category and --goal those sorted into one, --due those due by a day: today, within the week, or overdue (the open ones past their day). The tasks put away (ADR-0029) are left out unless --archived asks for them alone. A page at a time: ${DEFAULT_PAGE_LIMIT} unless --limit says otherwise, from --offset on; a last line says when there is more. States: idea, ready, in_progress, in_review, done, dropped.`,
+      "The tasks on the board, newest first, narrowed by state, worker, category, goal, due day or words of the title.",
+    about: `The tasks on the board, newest first: number, state, priority, title, who owns and who works on each, its category and its due day, and what waits on it. --open keeps the ones not done or dropped, --mine those you work on, --unassigned those nobody works on (not with --mine), --category and --goal those sorted into one, --due those due by a day: today, this week (through its last day, the week beginning as the workspace says, console workspace, or as your language has it), or overdue (the open ones past their day), --search those whose title has every word given, whatever the case, and the task of that number for a number (12 or #12): how a task is found by its title, as a parent or otherwise. The tasks put away (ADR-0029) are left out unless --archived asks for them alone. A page at a time: ${DEFAULT_PAGE_LIMIT} unless --limit says otherwise, from --offset on; a last line says when there is more. States: idea, ready, in_progress, in_review, done, dropped.`,
+    limits: [`search: 1 to ${MAX_SEARCH_LENGTH} characters`],
   },
   task: {
     usage: `task <number|id>  |  task new <title> [--body <markdown>|--file <path>] ${TASK_FIELD_FLAGS}  |  task edit <number|id> [--title <title>] [--body <markdown>|--file <path>] ${TASK_FIELD_FLAGS}  |  task archive <number|id>  |  task archive --goal <id>  |  task restore <number|id>`,
@@ -171,10 +175,11 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
     refusals: ["task.not_found: no task has that number or id", ...TASK_FIELD_REFUSALS],
   },
   goals: {
-    usage: "goals [--category <key>] [--state <state>]",
+    usage:
+      "goals [--category <key>] [--state <state>] [--search <words>] [--limit <n>] [--offset <n>]",
     synopsis: "The roadmap: the project's goals, with their state, their days and how far each is.",
-    about:
-      "The roadmap of the project: its goals, the active first, each with its id, its state (planned, active, done, dropped), its category, the days it starts and is meant to be reached by, and how far it is, counted from the tasks that work towards it. --category keeps those sorted into one, --state those in one state.",
+    about: `The roadmap of the project: its goals, the active first, each with its id, its state (planned, active, done, dropped), its category, the days it starts and is meant to be reached by, and how far it is, counted from the tasks that work towards it. --category keeps those sorted into one, --state those in one state, --search those whose title has every word given, whatever the case: how a goal's id is found for --goal. A page at a time: ${DEFAULT_PAGE_LIMIT} unless --limit says otherwise, from --offset on; a last line says when there is more.`,
+    limits: [`search: 1 to ${MAX_SEARCH_LENGTH} characters`],
   },
   goal: {
     usage:
@@ -206,7 +211,7 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
     usage: "people",
     synopsis: "The people you see, by login, with what each is in the workspace.",
     about:
-      "The people of the workspace you see, by login, with their name where the host gives one and what they are in it: admin, who configures the workspace, or member, who works in the projects they are in; a person taken out is marked deactivated. Everyone, unless the workspace shows a member only the people they share a project with (console workspace says which; an administrator sees everyone). Then, where you see everyone, the logins an administrator let in that nobody has signed in with yet. The logins are what --assignee, member and person take; a login is found exactly, so an owner lists someone the list does not show.",
+      "The people of the workspace you see, by login, with their name where the host gives one and what they are in it: admin, who configures the workspace, or member, who works in the projects they are in; a person taken out is marked deactivated. Everyone, unless the workspace shows a member only the people they share a project with (console workspace says which; an administrator sees everyone). Then, where you see everyone, the logins an administrator let in that nobody has signed in with yet. The logins are what --worker, member and person take; a login is found exactly, so an owner lists someone the list does not show.",
   },
   workspace: {
     usage:
@@ -309,11 +314,11 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
   },
   skills: {
     usage:
-      "skills  |  skills <folder>  |  skills --search <words> [<folder>] [--limit <n>] [--cursor <cursor>]",
+      "skills  |  skills <folder|file>  |  skills --search <words> [<folder>] [--limit <n>] [--cursor <cursor>]",
     synopsis:
-      "The project's pack: its skills; what a folder of it holds; or what words find in it.",
+      "The project's pack: its skills; what a folder of it holds, or a document's outline; or what words find in it.",
     about:
-      "The project's pack, read by the console at the project's address, or the organization's: at a SkillCDN deployment, with the pack token the project holds where the pack is private (ADR-0028), or from a directory on the console's machine for a local address (ADR-0031). Alone: where the pack is and what a client is told of it on connect, then every skill with the path of its SKILL.md and every document, as a connection of your own would list them, and where the console's own skills are on this machine. With a folder (. for the root): what it holds, whole, as browse_repo lays it out for a model: its skills, its folders with what each holds and the README that introduces it, its files. With --search: what the words find, as search_repo does: skills first, with the files of theirs that matched, then documents, in relevance order; words, not meaning, in the language the pack is written in; within the folder when one is named; 10 unless --limit says otherwise, up to 25, and a nextCursor line says when more matched, which --cursor continues. The text is the one an MCP client's model is given, with the reads named as these commands. --json answers with the console's own JSON: what the pack answered, in the shapes of the main repository's REST API, the pages of a folder joined.",
+      "The project's pack, read by the console at the project's address, or the organization's: at a SkillCDN deployment, with the pack token the project holds where the pack is private (ADR-0028), or from a directory on the console's machine for a local address (ADR-0031). Alone: where the pack is and what a client is told of it on connect, then every skill with the path of its SKILL.md and every document, as a connection of your own would list them, and where the console's own skills are on this machine. With a folder (. for the root): what it holds, whole, as browse_repo lays it out for a model: its skills, its folders with what each holds and the README that introduces it, its files. With a file's path: the file's outline, every heading with its level and the offset and limit that read its section with console skill --file, whole; a file that is not Markdown has none. With --search: what the words find, as search_repo does: skills first, with the files of theirs that matched, then documents, each with the sections of it that matched and what reads each, in relevance order; words in the language the pack is written in, and meaning too where the deployment searches by it, which the result then says; within the folder when one is named; 10 unless --limit says otherwise, up to 25, and a nextCursor line says when more matched, which --cursor continues. The text is the one an MCP client's model is given, with the reads named as these commands. --json answers with the console's own JSON: what the pack answered, in the shapes of the main repository's REST API, the pages of a folder or an outline joined.",
     limits: ["search: 1 to 500 characters; limit: 1 to 25"],
     refusals: [
       "status not_found: the pack is not served to the console; private, with no pack token on the project",
@@ -321,11 +326,12 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
     ],
   },
   skill: {
-    usage: "skill <path>  |  skill --file <path>",
+    usage: "skill <path>  |  skill --file <path> [--offset <n>] [--limit <n>]",
     synopsis:
-      "One skill of the pack whole, its rules first; or with --file a file of the pack, or what a folder holds.",
+      "One skill of the pack whole, its rules first; or with --file a file of the pack, one section of it, or what a folder holds.",
     about:
-      "One skill of the project's pack, whole, as load_skill lays it out for a model: the rules of the repository from its root to the nearest manifest, the skill's instructions, the files it includes, then its supporting files and what it refers to; the pages it came in are joined. Read by the console from the pack, with the pack token the project holds where the pack is private, so you need no connection of your own. <path> is the path of the SKILL.md from the repository's root, as console skills lists it, or the URI the pack names it by (skill://<host>/<owner>/<name>/<path>). --file <path> reads a file of the pack instead, whole, as read_repo_file does, or what a folder holds, and takes no skill's path beside it; console skills <folder> shows a folder with more. --json answers with what the pack answered, in the shapes of the main repository's REST API, the pages joined.",
+      "One skill of the project's pack, whole, as load_skill lays it out for a model: the rules of the repository from its root to the nearest manifest, the skill's instructions, the files it includes, then its supporting files and what it refers to; the pages it came in are joined. Read by the console from the pack, with the pack token the project holds where the pack is private, so you need no connection of your own. <path> is the path of the SKILL.md from the repository's root, as console skills lists it, or the URI the pack names it by (skill://<host>/<owner>/<name>/<path>). --file <path> reads a file of the pack instead, whole, as read_repo_file does, or what a folder holds, and takes no skill's path beside it; console skills <folder> shows a folder with more. --offset <n> and --limit <n>, with --file, read one page of the file as asked, from that character on and at most that many characters, as a search or an outline (console skills <file>) names a section, instead of the file whole; the result says where the file continues. --json answers with what the pack answered, in the shapes of the main repository's REST API, the pages joined.",
+    limits: ["offset: 0 or more; limit: 1 to 100000 characters; both with --file"],
     refusals: [
       "status not_found: the pack is not served to the console; private, with no pack token on the project",
       "status token_invalid: the pack token the project holds no longer works; an owner sets a new one",
@@ -389,18 +395,38 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
   },
   ask: {
     usage:
-      'ask "<question>" --option "<label>" --option "<label>" [...] [--body <markdown>|--file <path>] [--wait <seconds>] [--run <id>]',
+      'ask "<question>" --option "<label>" --option "<label>" [...] [--body <markdown>|--file <path>] [--to <login|me>] [--wait <seconds>] [--run <id>]',
     overview:
-      'ask "<question>" --option "<label>" --option "<label>" [...] [--body <markdown>|--file <path>] [--wait <seconds>]',
+      'ask "<question>" --option "<label>" --option "<label>" [...] [--body <markdown>|--file <path>] [--to <login|me>] [--wait <seconds>]',
     synopsis:
       "Raises a decision a person must make, with options, and waits a while for the answer.",
-    about: `Raises a decision a person must make: the question, the options to choose from, and what they need to know. The run waits for the answer. The command waits 60 seconds for it unless --wait says otherwise, and exits with 3 if it is still to come: keep waiting with \`console decision <id> --wait 100\`, within what your shell gives one command. The decision's id is printed as soon as it is raised. The person chooses one of the options, or answers in their own words: the answer then names one more option, their words, marked own; act on it as given. ${ON_THE_RUN}`,
+    about: `Raises a decision a person must make: the question, the options to choose from, and what they need to know. It is for the person you work for unless --to names another of the project, who then finds it among their decisions (ADR-0042); anyone of the project may still answer. The run waits for the answer. The command waits 60 seconds for it unless --wait says otherwise, and exits with 3 if it is still to come: keep waiting with \`console decision <id> --wait 100\`, within what your shell gives one command. The decision's id is printed as soon as it is raised. The person chooses one of the options, or answers in their own words: the answer then names one more option, their words, marked own; act on it as given. ${ON_THE_RUN}`,
     limits: [
       `question: one line, up to ${MAX_QUESTION_LENGTH} characters`,
       `options: ${MIN_OPTIONS} to ${MAX_OPTIONS}, each one line up to ${MAX_OPTION_LABEL_LENGTH} characters`,
       `body: ${MARKDOWN}`,
+      "to: a login of the project, or me",
+    ],
+    refusals: [
+      ...RUN_CHOICE,
+      "decision.invalid_run: the run is not yours, or is over",
+      "decision.invalid_decider: the person named may not work in the project",
+    ],
+  },
+  answer: {
+    usage: 'answer <id> --option <n>|--own "<answer>" [--note <markdown>|--file <path>]',
+    synopsis: "Writes a person's answer on a decision: the option they chose, or their own words.",
+    about:
+      "Writes on the board the answer a person gave: one of the decision's options by its number, or their own words, which become one more option of the decision marked as theirs; and a note about it. The answer is the person's, written in their name through you (ADR-0021): a choice they made in chat, in a meeting or by changing the task is written here, with where and when they made it in the note, so that the record is whole and a run that waited goes on. A decision is answered once; what followed is written with console decision <id> --outcome.",
+    limits: [
+      `own: one line, up to ${MAX_OPTION_LABEL_LENGTH} characters`,
+      `note: Markdown, up to ${MAX_NOTE_LENGTH} characters`,
+    ],
+    refusals: [
+      "decision.not_found: no decision has that id",
+      "decision.answered: the decision has an answer already",
+      "decision.no_such_option: the option is not one of the decision's",
     ],
-    refusals: [...RUN_CHOICE, "decision.invalid_run: the run is not yours, or is over"],
   },
   decision: {
     usage: "decision <id> [--wait <seconds>]  |  decision <id> --outcome <markdown>|--file <path>",
@@ -412,9 +438,9 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
     refusals: ["decision.not_found: no decision has that id"],
   },
   decisions: {
-    usage: "decisions [--open] [--limit <n>] [--offset <n>]",
-    synopsis: "The decisions on the board, the waiting first.",
-    about: `The decisions on the board, the waiting first; --open keeps only those. A page at a time: ${DEFAULT_PAGE_LIMIT} unless --limit says otherwise, from --offset on.`,
+    usage: "decisions [--open] [--mine|--raised] [--limit <n>] [--offset <n>]",
+    synopsis: "The decisions on the board, the waiting first; or your own across the projects.",
+    about: `The decisions on the board, the waiting first; --open keeps only those. --mine lists the decisions addressed to you instead (ADR-0042), and --raised those you asked of someone else, through your agent or yourself, each across the projects you may see with its project's key; neither needs a project. A page at a time: ${DEFAULT_PAGE_LIMIT} unless --limit says otherwise, from --offset on.`,
   },
   finish: {
     usage: 'finish [--summary "<markdown>"|--file <path>] [--run <id>]',
@@ -618,7 +644,18 @@ const SECTIONS: readonly { readonly title: string; readonly commands: readonly s
   },
   {
     title: "Working",
-    commands: ["take", "report", "hand-in", "comment", "file", "ask", "finish", "fail", "abandon"],
+    commands: [
+      "take",
+      "report",
+      "hand-in",
+      "comment",
+      "file",
+      "ask",
+      "answer",
+      "finish",
+      "fail",
+      "abandon",
+    ],
   },
   {
     title: "The documents: the project's pages of Markdown, in folders, by path",

package/src/cli/main.ts

@@ -60,6 +60,7 @@ process.exitCode = await runCli(process.argv.slice(2), {
     exists: existsSync,
   }),
   notices: createNoticeStore(configDir),
+  locale: Intl.DateTimeFormat().resolvedOptions().locale,
   skillsDir: existsSync(skillsDir) ? skillsDir : undefined,
   listen: listenOn,
 });

package/src/cli/pack.ts

@@ -264,11 +264,20 @@ export function joinFolder(
   if (first === undefined || last === undefined) {
     return undefined;
   }
+  // A file's path answers its outline (SkillCDN 0.4), its headings paged as a folder's entries are.
+  const outline =
+    first.outline === undefined
+      ? undefined
+      : {
+          ...first.outline,
+          headings: results.flatMap((result) => result.outline?.headings ?? []),
+        };
   return {
     ...first,
     mount: last.mount,
     entries: results.flatMap((result) => result.entries),
     nextCursor: last.nextCursor,
+    ...(outline === undefined ? {} : { outline }),
   };
 }
 
@@ -304,10 +313,16 @@ export function formatSkillFind(found: RestSkillFind, summary: PackSummary | und
   return renderFindResult(findResultOf(found.read, summary), CONSOLE_WORDS);
 }
 
-/** The pages of a file, as the console answered them, as the file whole; or the folder the path named. */
+/**
+ * The pages of a file, as the console answered them, as the file whole; or the folder the path
+ * named. With `requested`, the one page is a section read as asked (`--offset`, `--limit`): the
+ * result carries the length asked for, so that the renderer says where the file continues rather
+ * than asking for the rest.
+ */
 export function joinFile(
   pages: readonly RestSkillFile[],
   summary: PackSummary,
+  requested?: number,
 ): FileResult | DirectoryResult | undefined {
   const reads = pages.flatMap((page) => (page.read === null ? [] : [page.read]));
   const first = reads[0];
@@ -331,6 +346,7 @@ export function joinFile(
     content: files.map((file) => file.content).join(""),
     nextOffset: closing.nextOffset,
     totalLength: closing.totalLength,
+    ...(requested === undefined ? {} : { requestedLength: requested }),
   };
 }
 

package/src/client.ts

@@ -44,6 +44,7 @@ import {
   type RestMemberPatch,
   type RestMembers,
   type RestMePatch,
+  type RestMyDecisions,
   type RestPackConnect,
   type RestPackConnectStarted,
   type RestPackTokenInput,
@@ -101,6 +102,7 @@ import {
   restMemberSchema,
   restMembersSchema,
   restMeSchema,
+  restMyDecisionsSchema,
   restPackConnectSchema,
   restPackConnectStartedSchema,
   restPeopleSchema,
@@ -214,14 +216,18 @@ export interface Page {
   readonly offset?: number | undefined;
 }
 
-/** What the board is narrowed to: one state, the open ones, a category, a goal, an assignee, or what is due by a day. */
-/** What the roadmap is narrowed by: the goals in one state, or sorted into one category (ADR-0026). */
-export interface GoalFilter {
+/** What the roadmap is narrowed by: the goals in one state, the open ones, those sorted into one category (ADR-0026), or those whose title has some words; and which page of it. */
+export interface GoalFilter extends Page {
   readonly state?: GoalState | undefined;
+  /** True for the goals planned or active; false for the reached and the dropped. */
+  readonly open?: boolean | undefined;
   /** The key of a category of the workspace. */
   readonly category?: string | undefined;
+  /** Words of the title, each found in it whatever the case. */
+  readonly q?: string | undefined;
 }
 
+/** What the board is narrowed to: one state, the open ones, a category, a goal, a worker, what is due by a day, or words of the title; and which page of it. */
 export interface TaskFilter extends Page {
   readonly state?: TaskState | undefined;
   /** True for the tasks not done or dropped; false for the rest. */
@@ -230,10 +236,12 @@ export interface TaskFilter extends Page {
   readonly category?: string | undefined;
   /** The id of a goal. */
   readonly goal?: string | undefined;
-  /** The id of the person the tasks are assigned to. */
-  readonly assignee?: string | undefined;
-  /** True for the tasks assigned to nobody. */
+  /** The id of a person among the workers of the tasks. */
+  readonly worker?: string | undefined;
+  /** True for the tasks with no worker. */
   readonly unassigned?: boolean | undefined;
+  /** Words of the title, each found in it whatever the case; `#12` or `12` finds the task of that number too. */
+  readonly q?: string | undefined;
   /** A day (`2026-10-20`): the tasks due on it or before it. */
   readonly dueBy?: string | undefined;
   /** True for the tasks put away alone (ADR-0029); false, or left out, for the current ones. */
@@ -380,8 +388,7 @@ export interface ProjectClient {
   attachFile(path: string, input: FileUpload): Promise<RestDocument>;
   /** Where the bytes of a file attached to a document are read, by the file's id. */
   documentFileUrl(path: string, fileId: string): string;
-  /** The roadmap (ADR-0019): the goals, the active first, each with its tasks counted by state. */
-  /** The roadmap, or what the filter keeps of it: the active goals first. */
+  /** The roadmap (ADR-0019), or what the filter keeps of it, a page at a time: the active goals first, each with its tasks counted by state. */
   goals(filter?: GoalFilter, signal?: AbortSignal): Promise<RestGoals>;
   goal(id: string, signal?: AbortSignal): Promise<RestGoal>;
   /** Sets a goal; for an owner, with a session or a token. */
@@ -444,8 +451,13 @@ export interface ConsoleClient {
   updateCategory(key: string, patch: RestCategoryPatch): Promise<RestCategory>;
   /** Removes a category no task uses; for an administrator signed in. */
   removeCategory(key: string): Promise<void>;
-  /** 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(signal?: AbortSignal): Promise<RestWork>;
+  /** The decisions addressed to the asker (ADR-0042) across the projects they may see, or with `raised` those they raised for someone else: a page, the waiting first; or only those. */
+  myDecisions(
+    filter?: { readonly open?: boolean; readonly raised?: boolean } & Page,
+    signal?: AbortSignal,
+  ): Promise<RestMyDecisions>;
   /** Another person's plate, within what the asker may see: for an administrator, or an owner of a project they are in. */
   personWork(personId: string, signal?: AbortSignal): Promise<RestPersonWork>;
   /** The tokens of whoever asks. */
@@ -642,9 +654,10 @@ export function createClient(options: ClientOptions = {}): ConsoleClient {
             open: flag(filter.open),
             category: filter.category,
             goal: filter.goal,
-            assignee: filter.assignee,
+            worker: filter.worker,
             unassigned: flag(filter.unassigned),
             dueBy: filter.dueBy,
+            q: filter.q,
             limit: number(filter.limit),
             offset: number(filter.offset),
           }),
@@ -862,7 +875,14 @@ export function createClient(options: ClientOptions = {}): ConsoleClient {
       goals: (filter = {}, signal) =>
         request(
           "GET",
-          withQuery(at("goals"), { state: filter.state, category: filter.category }),
+          withQuery(at("goals"), {
+            state: filter.state,
+            open: flag(filter.open),
+            category: filter.category,
+            q: filter.q,
+            limit: number(filter.limit),
+            offset: number(filter.offset),
+          }),
           undefined,
           restGoalsSchema,
           signal,
@@ -948,6 +968,19 @@ export function createClient(options: ClientOptions = {}): ConsoleClient {
     removeCategory: (key) => request("DELETE", `${base}${categoryPath(key)}`, undefined, undefined),
     work: (signal) =>
       request("GET", `${base}${REST_ROUTES.work}`, undefined, restWorkSchema, signal),
+    myDecisions: (filter = {}, signal) =>
+      request(
+        "GET",
+        withQuery(REST_ROUTES.decisions, {
+          open: flag(filter.open),
+          raised: filter.raised === true ? "true" : undefined,
+          limit: number(filter.limit),
+          offset: number(filter.offset),
+        }),
+        undefined,
+        restMyDecisionsSchema,
+        signal,
+      ),
     personWork: (personId, signal) =>
       request("GET", `${base}${personWorkPath(personId)}`, undefined, restPersonWorkSchema, signal),
     tokens: (signal) =>

package/src/compat.ts

@@ -1,9 +1,10 @@
-// Whether the command and the console go together (ADR-0025). The command names its version on
+// Whether the command and the console go together (ADR-0025, ADR-0038). The command names its version on
 // every request, in the product token of its user-agent; the console answers every request of
 // the API with its own version and the range of command versions it takes, and refuses a
 // command outside the range with `426` and the words to update. One rule for both sides, kept
 // here so that the command and the console read the same one, and narrowed by the console's
-// policy below only, never widened: what the rule promises stays predictable.
+// policy below only, never widened: what the rule promises stays predictable. The command holds
+// the console to a floor of its own the same way (ADR-0038).
 
 /** The product token the command names itself with: `skillcdn-console/<version>`. */
 export const CLIENT_PRODUCT = "skillcdn-console";
@@ -74,15 +75,19 @@ export function inRange(version: Version, range: VersionRange): boolean {
 }
 
 /**
- * The common rule. Before 1.0, a command from the console's own version on and within the
- * console's minor (`^0.1.18`): any release may change the contract until then (ADR-0034), so the
- * console's own version is the floor, and the minor is the line. From 1.0, the console's major
- * and a minor within one of the console's, either way, whatever the patch: a minor adds and a
- * major breaks, as the version promises from then on.
+ * The common rule. Before 1.0, the line: a command and a console of one major.minor go
+ * together whatever the patch, since the minor is SkillCDN's line and a patch is a release of
+ * the console's own (ADR-0034), and a release that changes what passes between them raises the
+ * floors below instead (ADR-0038). From 1.0, the console's major and a minor within one of the
+ * console's, either way, whatever the patch: a minor adds and a major breaks, as the version
+ * promises from then on.
  */
 export function commonRange(server: Version): VersionRange {
   if (server.major === 0) {
-    return { atLeast: server, below: { major: 0, minor: server.minor + 1, patch: 0 } };
+    return {
+      atLeast: { major: 0, minor: server.minor, patch: 0 },
+      below: { major: 0, minor: server.minor + 1, patch: 0 },
+    };
   }
   return {
     atLeast: { major: server.major, minor: Math.max(0, server.minor - 1), patch: 0 },
@@ -103,13 +108,25 @@ export interface ClientPolicy {
   readonly refused?: readonly string[] | undefined;
 }
 
-/** The console's policy today: the common rule as it is. */
-export const CLIENT_POLICY: ClientPolicy = {};
+/**
+ * The console's policy: the oldest command this console answers, raised by the release that
+ * last changed what the command reads or sends (ADR-0038), whose changelog entry begins with
+ * `Breaking:`; `pnpm check` holds it to a version the package has, or is about to have.
+ */
+export const CLIENT_POLICY: ClientPolicy = { atLeast: "0.4.0" };
 
-/** The range of command versions a console of `server` takes: the common rule, narrowed by the policy's floor where that floor is within it. */
-export function clientRange(server: Version, policy: ClientPolicy = CLIENT_POLICY): VersionRange {
-  const common = commonRange(server);
-  const floor = parseVersion(policy.atLeast);
+/**
+ * The oldest console this command works with (ADR-0038): raised by the release that last
+ * changed what the command asks of the console, whose changelog entry begins with `Breaking:`.
+ * The command compares it with the version every answer names and refuses a console below it
+ * itself, naming the command to install instead; `pnpm check` holds it as it holds the
+ * console's floor.
+ */
+export const CONSOLE_AT_LEAST = "0.4.0";
+
+/** `common` from `atLeast` on, where that floor is within it; `common` as it is otherwise. */
+function narrowed(common: VersionRange, atLeast: string | undefined): VersionRange {
+  const floor = parseVersion(atLeast);
   return floor !== undefined &&
     compareVersions(floor, common.atLeast) > 0 &&
     compareVersions(floor, common.below) < 0
@@ -117,6 +134,16 @@ export function clientRange(server: Version, policy: ClientPolicy = CLIENT_POLIC
     : common;
 }
 
+/** The range of command versions a console of `server` takes: the common rule, narrowed by the policy's floor where that floor is within it. */
+export function clientRange(server: Version, policy: ClientPolicy = CLIENT_POLICY): VersionRange {
+  return narrowed(commonRange(server), policy.atLeast);
+}
+
+/** The range of console versions a command of `client` works with: the common rule, narrowed by the command's floor where that floor is within it. */
+export function consoleRange(client: Version, atLeast: string = CONSOLE_AT_LEAST): VersionRange {
+  return narrowed(commonRange(client), atLeast);
+}
+
 /**
  * What a command of one version is to a console of another: within the range and the same
  * (`current`), older (`behind`) or newer (`ahead`), which the console answers; or outside it,
@@ -152,6 +179,28 @@ export function judgeClient(
   return { verdict: order === 0 ? "current" : order < 0 ? "behind" : "ahead", range };
 }
 
+/**
+ * What a console of one version is to a command of another (ADR-0038): within the range the
+ * command works with, the same (`current`), older (`behind`) or newer (`ahead`); below it
+ * (`outdated`), which the command refuses itself, naming the command to install; or beyond it
+ * (`too_new`), which the console refuses the command for.
+ */
+export function judgeConsole(
+  server: Version,
+  client: Version,
+  atLeast: string = CONSOLE_AT_LEAST,
+): ClientJudgement {
+  const range = consoleRange(client, atLeast);
+  if (compareVersions(server, range.atLeast) < 0) {
+    return { verdict: "outdated", range };
+  }
+  if (compareVersions(server, range.below) >= 0) {
+    return { verdict: "too_new", range };
+  }
+  const order = compareVersions(server, client);
+  return { verdict: order === 0 ? "current" : order < 0 ? "behind" : "ahead", range };
+}
+
 /** What the command sends as its user-agent: its product token, and, in a comment, where it runs. */
 export function userAgentOf(version: string, comment?: string): string {
   // A comment holds printable ASCII without parentheses or backslashes; nothing else is said.