@anchrd/intel-contract 0.23.0 → 0.25.0

package/dist/contract/board.d.ts

@@ -1,4 +1,14 @@
 import { z } from "zod";
+/**
+ * The id of the archive column, on every board (D68, #674).
+ *
+ * ⚠️ **It is derived, never stored.** A card sits in it because `nodes.archived_at` is set, and
+ * `board_tasks.status` keeps naming the working column it came from — that is what lets a card
+ * pulled back out land where it was. A configured column may not claim this id; `board_update`
+ * refuses it, because two columns with one id means every card in them lands in whichever the view
+ * draws first.
+ */
+export declare const ARCHIVE_COLUMN_ID = "archived";
 export declare const BoardColumn: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
@@ -14,6 +24,7 @@ export declare const BoardTask: z.ZodObject<{
     startDate: z.ZodNullable<z.ZodISODateTime>;
     dueDate: z.ZodNullable<z.ZodISODateTime>;
     dependsOn: z.ZodNullable<z.ZodString>;
+    parentTaskId: z.ZodNullable<z.ZodString>;
     position: z.ZodNumber;
     archivedAt: z.ZodNullable<z.ZodISODateTime>;
 }, z.core.$strict>;
@@ -43,6 +54,7 @@ export declare const BoardView: z.ZodObject<{
         title: z.ZodString;
         terminal: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
+    archiveVisible: z.ZodBoolean;
     tasks: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
@@ -52,6 +64,7 @@ export declare const BoardView: z.ZodObject<{
         startDate: z.ZodNullable<z.ZodISODateTime>;
         dueDate: z.ZodNullable<z.ZodISODateTime>;
         dependsOn: z.ZodNullable<z.ZodString>;
+        parentTaskId: z.ZodNullable<z.ZodString>;
         position: z.ZodNumber;
         archivedAt: z.ZodNullable<z.ZodISODateTime>;
     }, z.core.$strict>>;
@@ -64,6 +77,7 @@ export declare const BoardUpdateInput: z.ZodObject<{
         title: z.ZodString;
         terminal: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
+    archiveVisible: z.ZodOptional<z.ZodBoolean>;
     idempotencyKey: z.ZodString;
 }, z.core.$strict>;
 export type BoardUpdateInput = z.infer<typeof BoardUpdateInput>;
@@ -76,6 +90,7 @@ export declare const BoardTaskCreateInput: z.ZodObject<{
     startDate: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
     dueDate: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
     dependsOn: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    parentTaskId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     idempotencyKey: z.ZodString;
 }, z.core.$strict>;
 export type BoardTaskCreateInput = z.infer<typeof BoardTaskCreateInput>;
@@ -92,3 +107,28 @@ export declare const BoardTaskUpdateInput: z.ZodObject<{
     idempotencyKey: z.ZodString;
 }, z.core.$strict>;
 export type BoardTaskUpdateInput = z.infer<typeof BoardTaskUpdateInput>;
+export declare const BoardAssignee: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    email: z.ZodEmail;
+    isMachine: z.ZodBoolean;
+}, z.core.$strict>;
+export type BoardAssignee = z.infer<typeof BoardAssignee>;
+export declare const BoardAssigneeSearchInput: z.ZodObject<{
+    boardId: z.ZodString;
+    query: z.ZodString;
+}, z.core.$strict>;
+export type BoardAssigneeSearchInput = z.infer<typeof BoardAssigneeSearchInput>;
+export declare const BoardAssigneeResolveInput: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type BoardAssigneeResolveInput = z.infer<typeof BoardAssigneeResolveInput>;
+export declare const BoardAssigneeList: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        email: z.ZodEmail;
+        isMachine: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type BoardAssigneeList = z.infer<typeof BoardAssigneeList>;

package/dist/contract/board.js

@@ -3,6 +3,16 @@ import { IdempotencyKey, IntelId, IsoDateTime } from "./contract.js";
 // One column of a board. `terminal` is what "done" means here — a rule about the column rather than
 // a magic status name, so an installation may call it "Shipped" or "Abgerechnet" without anything
 // downstream having to know the word.
+/**
+ * The id of the archive column, on every board (D68, #674).
+ *
+ * ⚠️ **It is derived, never stored.** A card sits in it because `nodes.archived_at` is set, and
+ * `board_tasks.status` keeps naming the working column it came from — that is what lets a card
+ * pulled back out land where it was. A configured column may not claim this id; `board_update`
+ * refuses it, because two columns with one id means every card in them lands in whichever the view
+ * draws first.
+ */
+export const ARCHIVE_COLUMN_ID = "archived";
 export const BoardColumn = z.strictObject({
     id: z.string().min(1).max(60).describe("Stable key stored on every task in this column."),
     title: z.string().min(1).max(80).describe("What the column is called on screen."),
@@ -26,6 +36,18 @@ export const BoardTask = z.strictObject({
     startDate: IsoDateTime.nullable(),
     dueDate: IsoDateTime.nullable(),
     dependsOn: IntelId.nullable(),
+    /**
+     * The task this one sits under, or `null` when it sits directly on the board.
+     *
+     * ⚠️ **The hierarchy is the node tree** (`nodes.parent_id`), not a second column here — a task
+     * under a task IS the tree Intel already has, which is why the cycle guard that refuses moving a
+     * node into its own descendant covers this for free.
+     *
+     * ⚠️ **Under a filter this may name a task that is not in the same answer.** `board_get` returns
+     * what matches; a subtask can match while its parent does not. A reader that assumes the parent
+     * is present will lose the row — treat an unknown parent as top level.
+     */
+    parentTaskId: IntelId.nullable(),
     position: z.number(),
     archivedAt: IsoDateTime.nullable(),
 });
@@ -59,6 +81,14 @@ export const BoardView = z.strictObject({
     boardId: IntelId,
     title: z.string().min(1).max(240),
     columns: z.array(BoardColumn),
+    /**
+     * Whether the archive column is drawn (D68, #674).
+     *
+     * ⚠️ It travels even when it is `false`, because the settings dialog needs to draw the switch in
+     * both positions — and because "the column is not in `columns`" has two possible reasons, hidden
+     * and not-yet-supported, which a reader cannot tell apart from the list alone.
+     */
+    archiveVisible: z.boolean(),
     tasks: z.array(BoardTask),
 });
 export const BoardUpdateInput = z.strictObject({
@@ -66,7 +96,13 @@ export const BoardUpdateInput = z.strictObject({
     columns: z
         .array(BoardColumn)
         .min(1)
-        .describe("The complete new column list, in order. Columns are replaced, not merged."),
+        .describe(`The complete new column list, in order. Columns are replaced, not merged. The archive column (\`${ARCHIVE_COLUMN_ID}\`) is not part of this list and cannot be named in it — it is on every board and is only shown or hidden.`),
+    // ⚠️ Shown or hidden, never removed. The archive is the same place on every board; a shelf that
+    // could be dragged between the working columns would be a shelf pretending to be a stage.
+    archiveVisible: z
+        .boolean()
+        .optional()
+        .describe("Whether the archive column is drawn. Omit to leave it as it is."),
     idempotencyKey: IdempotencyKey,
 });
 export const BoardTaskCreateInput = z.strictObject({
@@ -100,6 +136,12 @@ export const BoardTaskCreateInput = z.strictObject({
     dependsOn: IntelId.nullable()
         .default(null)
         .describe("A node this task waits for. Any node, not only another task."),
+    // ⚠️ Creating a subtask is ONE call; moving an existing task under another is `node_update`
+    // with a new `parentId`. Two paths for "where a task sits" would mean two cycle guards, and the
+    // one on the node path is the one that already exists.
+    parentTaskId: IntelId.nullable()
+        .default(null)
+        .describe("The task this one belongs under. It must be on the same board. Omit for a card that sits directly on the board."),
     idempotencyKey: IdempotencyKey,
 });
 // ⚠️ Moving a card IS this call: `status` and `position` together. There is deliberately no
@@ -117,7 +159,12 @@ export const BoardTaskUpdateInput = z.strictObject({
         .max(240)
         .optional()
         .describe("Refused on purpose: a card's title lives on the node. Rename it with node_update."),
-    status: z.string().min(1).max(60).optional().describe("The column to move it to."),
+    status: z
+        .string()
+        .min(1)
+        .max(60)
+        .optional()
+        .describe(`The column to move it to. \`${ARCHIVE_COLUMN_ID}\` is not an ordinary column: it archives the card through the same path as \`node_archive\`, with the same refusals — a card that still has live subtasks is refused. Moving it to any other column while it is archived brings it back.`),
     position: z
         .number()
         .optional()
@@ -141,3 +188,39 @@ export const BoardTaskUpdateInput = z.strictObject({
         .describe("A node this card waits for. `null` clears the dependency."),
     idempotencyKey: IdempotencyKey,
 });
+// ── Who a card can be given to ────────────────────────────────────────────────────────────────
+// D70 (`~/Dev/anchrd/core/DECISIONS.md`): the people offered here are the ones who can actually open
+// THIS board, never everyone who holds an account. The narrower answer is the point, and it is what
+// makes the door safe to offer to anyone who can see the board.
+//
+// ⚠️ `email` travels because two colleagues share a first name more often than a picker can afford,
+// and a list of indistinguishable "Anton" rows is not a picker. It is no wider than what gate hands
+// any signed-in person at `POST /directory/search`; the narrowing this door adds is WHO appears,
+// not WHAT is said about them.
+//
+// `isMachine` travels for the same reason gate carries it: whoever picks an assignee wants to know
+// whether they are handing the card to a colleague or to an agent.
+export const BoardAssignee = z.strictObject({
+    id: IntelId,
+    name: z.string(),
+    email: z.email(),
+    isMachine: z.boolean(),
+});
+export const BoardAssigneeSearchInput = z.strictObject({
+    boardId: IntelId.describe("The board whose people to offer. Only those who can open this board appear, so the same query against two boards can give two different answers."),
+    query: z
+        .string()
+        .describe("What was typed. Under two characters the answer is empty rather than everybody: a single letter is a listing under a different name."),
+});
+// ⚠️ A DIFFERENT question from the one above, and deliberately not board-scoped. This one names
+// people who are ALREADY recorded on a card, so that a circle can carry initials instead of a raw
+// id (`#258`). Someone whose access was withdrawn, or whose account was switched off, still has to
+// be nameable: a card that reads as unassigned is a worse answer than the truth.
+export const BoardAssigneeResolveInput = z.strictObject({
+    ids: z
+        .array(IntelId)
+        .min(1)
+        .max(100)
+        .describe("The ids to name. Ids that cannot be named are absent from the answer rather than reported, and more than a hundred is refused rather than silently shortened."),
+});
+export const BoardAssigneeList = z.strictObject({ items: z.array(BoardAssignee) });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anchrd/intel-contract",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {