@skillcdn/console 0.3.2 → 0.4.0

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

@@ -27,8 +27,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

@@ -652,6 +652,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 +692,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 +703,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 +735,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 +794,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. */