@skillcdn/console 0.1.20 → 0.1.21

package/docs/specs/cli.md

@@ -24,7 +24,7 @@ The board is a project's ([ADR-0008](../adr/0008-a-workspace-holds-projects-and-
 | `login --url <origin> [--agent <name>] [--token-stdin] [--default]` | `POST /api/v1/connect`, then `POST /api/v1/connect/claim` until a person approved, then `GET /api/v1/me` with the token; `DELETE /api/v1/me/token` with the token a repeated login replaces | the address and the code for a person; then who the token is, and whether this is the default console; keeps the login |
 | `logins` | nothing | one line per login: the console, the account, what the token is called, since when, and which is the default; never a token |
 | `logout [--url <origin>] [--account <login>]` | `DELETE /api/v1/me/token` | that the login's token is given up and forgotten, or that the console was out of reach and the token is left to the Agents page |
-| `whoami` | `GET /api/v1/me` | the login, the role, the workspace, the address, and the project this directory works in; then the command's version and where it is installed, the console's version and the range it takes, and the update to make when they differ |
+| `whoami` | `GET /api/v1/me` | the login, the role, the workspace, the address, and the project this directory works in; with a project, where the organization's rules and the skill working-the-board are read; then the command's version and where it is installed, the console's version and the range it takes, and the update to make when they differ |
 | `projects` | `GET /api/v1/projects` | one line per project: key, name, what the person is in it, what waits in it |
 | `use <key> [--url <origin>] [--account <login>]` | `GET /api/v1/projects/<key>` | that the directory works in the project from now on, at which console and as which account where it binds them, and that `console rules` says what its people ask; writes `.skillcdn-console.json` |
 | `work [--person <login>]` | `GET /api/v1/work`, `GET /api/v1/people/<id>/work` | what is on the person's plate across their projects: the open tasks assigned to them, the sooner due first, each with its project; and the decisions waiting. `--person` shows another person's plate, for an administrator or an owner of a project they are in: their open tasks within the projects the asker may see, without the decisions. Needs no project |
@@ -32,7 +32,7 @@ The board is a project's ([ADR-0008](../adr/0008-a-workspace-holds-projects-and-
 | `task <number\|id>` | `GET .../tasks/<ref>`, the decisions about it, the runs on it, `GET .../tasks/<id>/comments` | the task in full, with its plan and its moments, and the discussion on it: each comment whole, with its files and the command that reads each |
 | `task new <title> [--body <markdown>\|--file <path>] [--state <state>] [--priority <priority>] [--category <key>] [--goal <id>] [--starts <day>] [--due <day>] [--assignee <login\|me>] [--parent <number\|id>]` | `POST .../tasks` | the number and the id |
 | `task edit <number\|id> [--title <title>] [--body ...] [the same flags; `none` clears a field]` | `GET .../tasks/<ref>`, then `PATCH .../tasks/<id>` | the task in full, as it is now |
-| `task archive <number\|id>` | `GET .../tasks/<ref>`, then `POST .../tasks/<id>/archive` | the task's line, put away ([ADR-0029](../adr/0029-a-task-done-or-dropped-is-put-away-out-of-the-board-and-open-by-its-number.md)): out of the listings, the board and the calendar, open by its number still; an open task is refused (`task.open`) |
+| `task archive <number\|id>` | `GET .../tasks/<ref>`, then `POST .../tasks/<id>/archive` | the task's line, put away ([ADR-0029](../adr/0029-a-task-done-or-dropped-is-put-away-out-of-the-board-and-open-by-its-number.md)), whatever its state ([ADR-0030](../adr/0030-a-task-is-put-away-from-any-state.md)): out of the listings, the board and the calendar, open by its number still |
 | `task archive --goal <id>` | `POST .../tasks/archive` | how many done or dropped tasks of the goal were put away; for an owner |
 | `task restore <number\|id>` | `GET .../tasks/<ref>`, then `POST .../tasks/<id>/restore` | the task's line, back on the board |
 | `goals [--category <key>] [--state <state>]` | `GET .../goals?category=&state=` | one line per goal of the roadmap: id, state, title, category, the days it starts and is meant to be reached by, how far it is ([ADR-0026](../adr/0026-a-goal-is-planned-in-days-and-sorted-into-a-category-and-the-roadmap-is-read-as-months.md)) |

package/docs/specs/rest.md

@@ -59,7 +59,6 @@ The API is the board as its members see it: the people, the projects, and in eac
 | 409 | `decision.answered` | The decision has an answer already. |
 | 409 | `document.conflict` | The page has moved on since the version the write started from (`baseVersion`), or was written at that path by someone else first. |
 | 409 | `document.archived` | The page is archived: restore it before writing to it or attaching to it. |
-| 409 | `task.open` | The task is open: only one done or dropped is put away ([ADR-0029](../adr/0029-a-task-done-or-dropped-is-put-away-out-of-the-board-and-open-by-its-number.md)). |
 | 409 | `document.too_many_versions`, `document.too_many_files` | The page carries as many versions, or files, as one may (`MAX_VERSIONS_PER_DOCUMENT`, `MAX_FILES_PER_DOCUMENT`). |
 | 409 | `token.too_many` | The person holds as many live tokens as one may (`MAX_TOKENS_PER_PERSON`). |
 | 409 | `connect.approved` | The connection was approved already; the command claims its token. |
@@ -188,7 +187,7 @@ One task, by its id or by its number in the project (`/tasks/7`): the pages hold
 
 ### `POST .../tasks/<id>/archive`, `POST .../tasks/<id>/restore` and `POST /api/v1/projects/<key>/tasks/archive`
 
-Putting a task away, and bringing it back ([ADR-0029](../adr/0029-a-task-done-or-dropped-is-put-away-out-of-the-board-and-open-by-its-number.md)). A task done or dropped is put away by whoever may work in the project, with a session or a token, and brought back the same way: putting away is a moment the board keeps (`archivedAt`), not a state, so the task stays done or dropped, counts toward its goal as before, and keeps its runs, decisions, comments and events; it is out of the listings, the board and the calendar, and open at its own address by id or by number still. An open task is not put away (`task.open`, 409). Each answers the task and writes `task.archived` or `task.restored` with the task's `number` and `title`; what is so already answers the task and writes nothing. `POST .../tasks/archive`, for an owner, takes `{ "goalId" }` and puts every done or dropped task of that goal away at once, one event each, answering `{ "archived": n }`, how many went; a goal with nothing to put away, or that is not the project's, is `0`. The console puts away by itself what was done or dropped and not touched for `TASK_ARCHIVE_AFTER_DAYS` ([deploy/README.md](../../deploy/README.md#environment-contract)), each with a `task.archived` event that names no actor.
+Putting a task away, and bringing it back ([ADR-0029](../adr/0029-a-task-done-or-dropped-is-put-away-out-of-the-board-and-open-by-its-number.md), [ADR-0030](../adr/0030-a-task-is-put-away-from-any-state.md)). A task is put away, whatever its state, by whoever may work in the project, with a session or a token, and brought back the same way: putting away is a moment the board keeps (`archivedAt`), not a state, so the task keeps its state, counts toward its goal as before, and keeps its runs, decisions, comments and events; it is out of the listings, the board and the calendar, and open at its own address by id or by number still. Each answers the task and writes `task.archived` or `task.restored` with the task's `number` and `title`; what is so already answers the task and writes nothing. `POST .../tasks/archive`, for an owner, takes `{ "goalId" }` and puts every done or dropped task of that goal away at once, one event each, answering `{ "archived": n }`, how many went; a goal with nothing to put away, or that is not the project's, is `0`. The console puts away by itself what was done or dropped and not touched for `TASK_ARCHIVE_AFTER_DAYS` ([deploy/README.md](../../deploy/README.md#environment-contract)), each with a `task.archived` event that names no actor.
 
 ### `GET .../tasks/<id or number>/comments` and `POST .../tasks/<id or number>/comments`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillcdn/console",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "What a custom SkillCDN console is built from: the API client and schemas, the components, the composition of the default console, and the console command agents work the board with.",
   "license": "MIT",
   "homepage": "https://github.com/skillcdn/console#readme",

package/skills/working-the-board/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: Needs a shell with the console command on the PATH (npm install -g @skillcdn/console, Node.js 24 or newer), signed in by a person. Nothing else; the command needs no key of its own and the agent never sees a token.
 metadata:
   author: skillcdn
-  version: "1.13"
+  version: "1.14"
 skillcdn:
   translations:
     ko:
@@ -50,7 +50,7 @@ Each phase ends with something on the board. Only phase 4 waits for a person.
 
 ### Phase 1: Read
 
-Told which task, go to phase 2: `console take` prints the rules of the board with the task, and they are read there, once. Choosing one, or checking one before taking it, `console rules` says which tasks to take and what to load, and `console task <number>` shows a task in full, with its plan, the decisions about it, the runs on it and the discussion on it, without taking it. A run open on it means another agent was at it, and may still be: the console cannot tell ([ADR-0020](/docs/adr/0020-the-console-does-not-claim-an-agent-is-at-work-a-run-says-when-it-was-last-heard-from-and-a-new-run-takes-over.md)), so read its reports and when it was last heard from, and take the task only when the person said to, since taking it ends that run as taken over; otherwise say so and stop. A task that is past its due day is still the task; the first report says so, and what the day was for is kept in mind. A task put away once done or dropped ([ADR-0029](/docs/adr/0029-a-task-done-or-dropped-is-put-away-out-of-the-board-and-open-by-its-number.md)) is out of `console tasks` unless `--archived` asks for the archive, and `console task <number>` opens it still. Read what the body links to, with `console doc <path>` for the project's pages and `console skills` for the organization's skills, before anything is made.
+Told which task, go to phase 2: `console take` prints the rules of the board with the task, and they are read there, once. Choosing one, or checking one before taking it, `console rules` says which tasks to take and what to load, and `console task <number>` shows a task in full, with its plan, the decisions about it, the runs on it and the discussion on it, without taking it. A run open on it means another agent was at it, and may still be: the console cannot tell ([ADR-0020](/docs/adr/0020-the-console-does-not-claim-an-agent-is-at-work-a-run-says-when-it-was-last-heard-from-and-a-new-run-takes-over.md)), so read its reports and when it was last heard from, and take the task only when the person said to, since taking it ends that run as taken over; otherwise say so and stop. A task that is past its due day is still the task; the first report says so, and what the day was for is kept in mind. A task put away ([ADR-0029](/docs/adr/0029-a-task-done-or-dropped-is-put-away-out-of-the-board-and-open-by-its-number.md), from any state since [ADR-0030](/docs/adr/0030-a-task-is-put-away-from-any-state.md)) is out of `console tasks` unless `--archived` asks for the archive, and `console task <number>` opens it still. Read what the body links to, with `console doc <path>` for the project's pages and `console skills` for the organization's skills, before anything is made.
 
 ### Phase 2: Take
 

package/src/cli/cli.ts

@@ -844,6 +844,12 @@ const whoami: Command = async (args, io) => {
     () =>
       [
         `${person.login} (${person.role}) at ${me.workspace.name}, ${session.url}${key === undefined ? "; no project named here" : `; project ${key}`}`,
+        // The pack's rules send an agent here first; from here the rules and the skill are the next steps.
+        ...(key === undefined
+          ? []
+          : [
+              "What this organization asks of agents: console rules. How the board is worked: the skill working-the-board, shipped with this command (console skills says where it is).",
+            ]),
         `This command is ${io.version ?? "of a version it does not know"}${io.install === undefined ? "" : `, ${describeInstall(io.install)}`}; ${consoleWords}.`,
         ...(verdict === "behind"
           ? [`A newer command exists. Update it: ${updateWords(io, me.console?.version)}`]

package/src/cli/help.ts

@@ -131,17 +131,13 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
   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>`,
     about:
-      "One task in full, with its plan (category, goal, start and due days), what happened to it (when it was started and done, which the board keeps itself, and when it was put away), the decisions about it, the runs on it and the discussion on it, each comment whole with its files; or a new task written down; or a task changed, only in what the flags say, where none clears a field (priorities: low, normal, high, urgent). archive puts a done or dropped task away (ADR-0029): out of the listings, the board and the calendar, open by its number still; with --goal, every done or dropped task of the goal at once, for an owner. restore brings one back.",
+      "One task in full, with its plan (category, goal, start and due days), what happened to it (when it was started and done, which the board keeps itself, and when it was put away), the decisions about it, the runs on it and the discussion on it, each comment whole with its files; or a new task written down; or a task changed, only in what the flags say, where none clears a field (priorities: low, normal, high, urgent). archive puts a task away, whatever its state (ADR-0029, ADR-0030): out of the listings, the board and the calendar, open by its number still; with --goal, every done or dropped task of the goal at once, for an owner. restore brings one back.",
     limits: [
       `title: one line, up to ${MAX_TITLE_LENGTH} characters, saying what is to be done on its own; what it refers to goes in the body`,
       `body: ${MARKDOWN}`,
       ...TASK_FIELD_LIMITS,
     ],
-    refusals: [
-      "task.not_found: no task has that number or id",
-      "task.open: an open task is not put away; one done or dropped is",
-      ...TASK_FIELD_REFUSALS,
-    ],
+    refusals: ["task.not_found: no task has that number or id", ...TASK_FIELD_REFUSALS],
   },
   goals: {
     usage: "goals [--category <key>] [--state <state>]",
@@ -450,6 +446,8 @@ const preamble = (version: string | undefined): string =>
   `console${version === undefined ? "" : ` ${version}`}: the board of your organization's work with AI agents, from the command line.
 You act as the person whose token you hold; everything you send is shown to people as text.
 The rules of this organization come with the task: console take prints them; console rules reads them any time.
+How the board is worked is the skill working-the-board, installed with this command: console skills prints
+where it is; read it before the first command of a run.
 
 Usage: console <command> [arguments] [--json] [--url <origin>] [--project <key>]
 `;

package/src/components/board.tsx

@@ -18,7 +18,6 @@ import {
 } from "../api.js";
 import { useWords } from "../i18n/index.js";
 import type { BoardFilter } from "../router.js";
-import { OPEN_TASK_STATES } from "../vocabulary.js";
 import { isPlainClick } from "./shell.js";
 import {
   Avatar,
@@ -35,12 +34,13 @@ import {
 // A card says what a person needs at a glance and nothing more: the number and the title, the
 // category, what is due, who is on it, and what blocks it. Whether an agent is at it is not
 // said, since the board cannot know (ADR-0020); the task's page shows its runs. A card is moved
-// to another column by hand: pressed anywhere but on its title and its menu, then dragged, with
-// a mouse at once and under a finger once it has rested a moment, so that a finger that moves
-// at once scrolls as it always did. The card's menu holds the rest: the way to the task's form,
-// and the way to put the task away once it is done or dropped (ADR-0029). The keyboard changes a
-// state on the task's page. The board takes its data as props and nothing from the network;
-// what it is told on a click goes back up.
+// to another column by hand: pressed anywhere but on its menu, its title included, then dragged
+// whole, with a mouse at once and under a finger once it has rested a moment, so that a finger
+// that moves at once scrolls as it always did; a click on the title opens the task as long as the
+// card was not dragged. The card's menu holds the rest: the way to the task's form, and the way to
+// put the task away (ADR-0029, ADR-0030). The keyboard changes a state on the task's page. The
+// board takes its data as props and nothing from the network; what it is told on a click goes
+// back up.
 
 export interface BoardProps {
   readonly tasks: readonly RestTask[];
@@ -57,7 +57,7 @@ export interface BoardProps {
   readonly editHref?: ((task: RestTask) => string) | undefined;
   /** Called when the menu's edit is chosen, to show the form without leaving the page; left out, the link is followed. */
   readonly onEdit?: ((task: RestTask) => void) | undefined;
-  /** Called when a task done or dropped is put away from its card's menu (ADR-0029). Left out, the menu offers nothing of it. */
+  /** Called when a task is put away from its card's menu (ADR-0029, ADR-0030). Left out, the menu offers nothing of it. */
   readonly onArchive?: ((task: RestTask) => void) | undefined;
 }
 
@@ -78,12 +78,21 @@ export function columnStateOf(value: string | null | undefined): TaskState | und
   return TASK_STATES.find((state) => state === value);
 }
 
+interface Point {
+  readonly x: number;
+  readonly y: number;
+}
+
 /** A card on its way to another column. */
 interface Drag {
   readonly task: RestTask;
-  readonly from: { readonly x: number; readonly y: number };
+  readonly from: Point;
   readonly x: number;
   readonly y: number;
+  /** Where on the card it was taken hold of, so that the card moves whole under the pointer. */
+  readonly grip: Point;
+  /** How wide the card is where it stands, so that the one in hand is the same. */
+  readonly width: number;
   /** Whether the card has come loose: the mouse has travelled, or the finger has rested. */
   readonly moving: boolean;
   /** Whether the press is a finger's, which must rest before the card comes loose. */
@@ -97,23 +106,21 @@ export interface TaskCardProps {
   readonly href: string;
   readonly onOpen: (task: RestTask) => void;
   readonly today?: string | undefined;
-  /** Called when the card is pressed anywhere but on its controls, to drag it to another column; left out, the card stays where it is. */
+  /** Called when the card is pressed anywhere but on its menu, to drag it to another column; left out, the card stays where it is. */
   readonly onPress?: ((task: RestTask, event: ReactPointerEvent<HTMLElement>) => void) | undefined;
-  /** Whether the card is on its way to another column. */
+  /** Whether the card is on its way to another column: the one left in its place is faded. */
   readonly dragging?: boolean | undefined;
   /** Where the task is edited; given, the card's menu leads there. */
   readonly editHref?: string | undefined;
   /** Called when the menu's edit is chosen, to show the form without leaving the page; left out, the link is followed. */
   readonly onEdit?: ((task: RestTask) => void) | undefined;
-  /** Called when the task is put away from the card's menu; offered once the task is done or dropped (ADR-0029). */
+  /** Called when the task is put away from the card's menu, whatever its state (ADR-0030). */
   readonly onArchive?: ((task: RestTask) => void) | undefined;
 }
 
 export function TaskCard(props: TaskCardProps) {
   const words = useWords();
   const { task, onPress } = props;
-  const closed = !OPEN_TASK_STATES.includes(task.state);
-  const archive = closed ? props.onArchive : undefined;
   return (
     <article
       className={cx(
@@ -124,12 +131,19 @@ export function TaskCard(props: TaskCardProps) {
       aria-label={`#${task.number} ${task.title}`}
       onPointerDown={onPress === undefined ? undefined : (event) => onPress(task, event)}
     >
-      {(props.editHref !== undefined || archive !== undefined) && (
-        <CardMenu task={task} editHref={props.editHref} onEdit={props.onEdit} onArchive={archive} />
+      {(props.editHref !== undefined || props.onArchive !== undefined) && (
+        <CardMenu
+          task={task}
+          editHref={props.editHref}
+          onEdit={props.onEdit}
+          onArchive={props.onArchive}
+        />
       )}
       <a
         className="sc-card-title"
         href={props.href}
+        // The card is dragged by our own hand, the title included; the browser's drag of a link is not it.
+        draggable={false}
         onClick={(event) => {
           if (isPlainClick(event)) {
             event.preventDefault();
@@ -169,7 +183,8 @@ const MENU_MARGIN = 8;
 /**
  * The card's menu: three dots in its corner, which open the ways a card has beyond being moved,
  * each given by the composition. The menu is rendered over the document, so that no column
- * clips it; a press elsewhere, the escape key, a scroll or a change of the window closes it.
+ * clips it; a press elsewhere, the escape key, a scroll or a change of the window closes it, and
+ * so does the button that opened it.
  */
 function CardMenu(props: {
   readonly task: RestTask;
@@ -194,6 +209,13 @@ function CardMenu(props: {
       right: Math.max(MENU_MARGIN, window.innerWidth - rect.right),
     });
   };
+  /** Whether the focus, or a press, is on the menu or on its button: the menu's own. */
+  const own = useCallback(
+    (target: EventTarget | null): boolean =>
+      target instanceof Node &&
+      (panel.current?.contains(target) === true || button.current?.contains(target) === true),
+    [],
+  );
   useEffect(() => {
     if (!open) {
       return;
@@ -214,14 +236,9 @@ function CardMenu(props: {
     }
     panel.current?.querySelector<HTMLElement>("[role='menuitem']")?.focus({ preventScroll: true });
     const away = (event: PointerEvent) => {
-      const target = event.target;
-      if (
-        target instanceof Node &&
-        (panel.current?.contains(target) === true || button.current?.contains(target) === true)
-      ) {
-        return;
+      if (!own(event.target)) {
+        close();
       }
-      close();
     };
     const key = (event: KeyboardEvent) => {
       if (event.key === "Escape") {
@@ -239,7 +256,7 @@ function CardMenu(props: {
       window.removeEventListener("scroll", close, true);
       window.removeEventListener("resize", close);
     };
-  }, [open, close]);
+  }, [open, close, own]);
   // The arrow keys walk the items, around the ends.
   const walk = (event: ReactKeyboardEvent<HTMLDivElement>) => {
     if (event.key !== "ArrowDown" && event.key !== "ArrowUp") {
@@ -283,9 +300,9 @@ function CardMenu(props: {
             aria-label={`#${task.number} ${task.title}`}
             style={{ top: place.top, right: place.right }}
             onKeyDown={walk}
+            // The focus leaving for anywhere but the menu's own button closes it; the button closes it itself.
             onBlur={(event) => {
-              const next = event.relatedTarget;
-              if (!(next instanceof Node && panel.current?.contains(next) === true)) {
+              if (!own(event.relatedTarget)) {
                 close();
               }
             }}
@@ -340,6 +357,8 @@ export function byDue(a: RestTask, b: RestTask): number {
   return b.number - a.number;
 }
 
+const nothing = () => undefined;
+
 export function Board(props: BoardProps) {
   const words = useWords();
   const { onMove } = props;
@@ -353,10 +372,10 @@ export function Board(props: BoardProps) {
   const loose = useRef(false);
 
   const press = useCallback((task: RestTask, event: ReactPointerEvent<HTMLElement>) => {
-    // The card's own controls, its title and its menu, are pressed for themselves.
+    // The card's menu is pressed for itself; everything else on the card takes hold of it.
     if (
       event.button !== 0 ||
-      (event.target instanceof Element && event.target.closest("a, button") !== null)
+      (event.target instanceof Element && event.target.closest("button") !== null)
     ) {
       return;
     }
@@ -365,14 +384,26 @@ export function Board(props: BoardProps) {
       // The press is the drag's beginning and nothing else: no text is selected on the way.
       event.preventDefault();
     }
+    const rect = event.currentTarget.getBoundingClientRect();
     const from = { x: event.clientX, y: event.clientY };
-    setDrag({ task, from, x: from.x, y: from.y, moving: false, hold, over: undefined });
+    setDrag({
+      task,
+      from,
+      x: from.x,
+      y: from.y,
+      grip: { x: from.x - rect.left, y: from.y - rect.top },
+      width: rect.width,
+      moving: false,
+      hold,
+      over: undefined,
+    });
   }, []);
 
   // While a card is held, the pointer is followed over the whole document: the column under it
   // is marked, the board scrolls when the pointer nears its edge, and the release moves the task.
   // A finger's hold is timed here, and once the card has come loose the page no longer scrolls
-  // under the finger, nor asks for the menu a long press would otherwise bring up.
+  // under the finger, nor asks for the menu a long press would otherwise bring up; the click that
+  // follows a drag opens nothing.
   const held = drag !== null;
   useEffect(() => {
     if (!held) {
@@ -421,8 +452,18 @@ export function Board(props: BoardProps) {
         return { ...before, moving: true, over: columnUnder(before.x, before.y) };
       });
     };
+    const swallow = (event: MouseEvent) => {
+      event.preventDefault();
+      event.stopPropagation();
+    };
     const release = (event: PointerEvent) => {
       const last = current.current;
+      if (loose.current) {
+        // The click the browser sends after the pointer is let go would open the title's task:
+        // it is swallowed, and the ear for it taken down once that moment has passed.
+        window.addEventListener("click", swallow, true);
+        window.setTimeout(() => window.removeEventListener("click", swallow, true), 0);
+      }
       if (last?.moving === true && event.type === "pointerup") {
         const over = columnUnder(event.clientX, event.clientY);
         if (over !== undefined && over !== last.task.state) {
@@ -506,12 +547,24 @@ export function Board(props: BoardProps) {
         );
       })}
       {dragging !== null && (
+        // The card in hand: the whole of it, as wide as where it stands, under the pointer where it was taken hold of.
         <div
           className="sc-drag-ghost"
           aria-hidden="true"
-          style={{ transform: `translate(${dragging.x + 12}px, ${dragging.y + 12}px)` }}
+          style={{
+            width: dragging.width,
+            transform: `translate(${dragging.x - dragging.grip.x}px, ${dragging.y - dragging.grip.y}px)`,
+          }}
         >
-          <span className="sc-card-number">#{dragging.task.number}</span> {dragging.task.title}
+          <TaskCard
+            task={dragging.task}
+            href={props.taskHref(dragging.task)}
+            onOpen={nothing}
+            today={props.today}
+            // The menu too, inert under the pointer, so that the card in hand keeps the shape of the one in its place.
+            editHref={props.editHref?.(dragging.task)}
+            onArchive={props.onArchive}
+          />
         </div>
       )}
     </div>

package/src/components/task-view.tsx

@@ -16,7 +16,7 @@ import type {
 import { formatDay } from "../dates.js";
 import { useLanguage, useWords } from "../i18n/index.js";
 import type { TaskFormKind } from "../router.js";
-import { OPEN_TASK_STATES, TASK_STATES } from "../vocabulary.js";
+import { TASK_STATES } from "../vocabulary.js";
 import { type CommentDraft, TaskThread } from "./comments.js";
 import { DecisionForm } from "./decision-form.js";
 import { EventFeed } from "./event-feed.js";
@@ -354,17 +354,15 @@ export function TaskView(props: TaskViewProps) {
               <a className="sc-button sc-button-secondary" href={props.formHref("ask")}>
                 {words.task.raiseDecision}
               </a>
-              {props.onArchive !== undefined &&
-                task.archivedAt === null &&
-                !OPEN_TASK_STATES.includes(task.state) && (
-                  <Button
-                    variant="secondary"
-                    disabled={props.busy === true}
-                    onClick={() => props.onArchive?.(task)}
-                  >
-                    {words.task.archive}
-                  </Button>
-                )}
+              {props.onArchive !== undefined && task.archivedAt === null && (
+                <Button
+                  variant="secondary"
+                  disabled={props.busy === true}
+                  onClick={() => props.onArchive?.(task)}
+                >
+                  {words.task.archive}
+                </Button>
+              )}
               {props.onRestore !== undefined && task.archivedAt !== null && (
                 <Button
                   variant="secondary"

package/src/console.tsx

@@ -738,7 +738,14 @@ function ProjectPage(props: {
     return (
       <>
         <div className="sc-page-head">
-          <h1 className="sc-page-title">{project.name}</h1>
+          <div className="sc-page-heading">
+            <h1 className="sc-page-title">{project.name}</h1>
+            {project.description.length > 0 && (
+              <p className="sc-page-lead" title={project.description}>
+                {project.description}
+              </p>
+            )}
+          </div>
           <div className="sc-page-actions">
             <LinkButton href={projectHref(key, "archive")}>{words.board.archive}</LinkButton>
             <LinkButton href={newTaskHref(key)} variant="primary">
@@ -746,7 +753,6 @@ function ProjectPage(props: {
             </LinkButton>
           </div>
         </div>
-        {project.description.length > 0 && <p className="sc-lead">{project.description}</p>}
         {error !== undefined && <Callout tone="danger">{error}</Callout>}
         {data.tasks.length > 0 && (
           <BoardFilters

package/src/i18n/en.ts

@@ -605,7 +605,7 @@ export const en = {
     loading: "Loading the archive",
     empty: {
       title: "Nothing is put away",
-      body: "A task done or dropped is put away from its page, with its goal, or by the console after a while.",
+      body: "A task is put away from its page or its card, with its goal once the goal is closed, or by the console a while after it was done or dropped.",
     },
     since: "put away",
     restore: "Bring back",

package/src/i18n/ko.ts

@@ -569,7 +569,7 @@ export const ko: Messages = {
     loading: "보관함을 불러오는 중",
     empty: {
       title: "보관된 작업이 없습니다",
-      body: "완료·폐기된 작업은 작업 페이지에서, 목표를 닫을 때 함께, 또는 일정 기간 뒤 콘솔이 보관합니다.",
+      body: "작업은 작업 페이지나 카드 메뉴에서, 목표를 닫을 때 함께, 또는 완료·폐기된 뒤 일정 기간이 지나면 콘솔이 보관합니다.",
     },
     since: "보관",
     restore: "되살리기",

package/src/rules.ts

@@ -23,8 +23,9 @@ 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, the runs on it and the discussion on it, without taking it. A task put away (archived) once done or dropped is out of the listings and the board, and opens by its number still. 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. A task put away (archived) is out of the listings and the board, and opens by its number still. How the board is worked is the skill working-the-board, shipped with the command: read it before the first command of a run (`console skills` prints 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.",
+  '3. Work given in chat, with no task on the board yet, goes on the board before it is done: write it (`console task new "<title>" --body <markdown>`), tell the person its number, take it (`console take <number>`) and work it as any task, without asking whether to. Until the task is written, the board is only read.',
   "",
   "## The organization's skills",
   "",

package/src/styles/console.css

@@ -718,6 +718,34 @@ table {
   gap: var(--sc-space-2);
 }
 
+/* A page's name with a word about it beside: on one line where the window is wide, so that the
+   head stays low over the board; under the name where it is not. */
+.sc-page-heading {
+  display: flex;
+  flex: 1 1 auto;
+  flex-wrap: wrap;
+  align-items: baseline;
+  min-width: 0;
+  column-gap: var(--sc-space-4);
+  row-gap: var(--sc-space-1);
+}
+
+.sc-page-lead {
+  flex: 1 1 16rem;
+  min-width: 0;
+  margin: 0;
+  color: var(--sc-color-text-muted);
+  font-size: var(--sc-text-sm);
+}
+
+@media (min-width: 60rem) {
+  .sc-page-lead {
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+}
+
 .sc-lead {
   max-width: var(--sc-width-prose);
   margin-bottom: var(--sc-space-5);
@@ -786,6 +814,12 @@ table {
   pointer-events: none;
 }
 
+/* A column's frame stands in front of what scrolls within it: a card scrolling out goes under
+   the lit edge, never over it. The other panes do not scroll, and keep the rim under the content. */
+.sc-column::before {
+  z-index: 1;
+}
+
 .sc-panel {
   margin-bottom: var(--sc-space-5);
   padding: var(--sc-space-5);
@@ -3768,16 +3802,16 @@ table {
   }
 }
 
-/* A card is dragged to another column from anywhere on it but its title and its menu: with a
-   mouse at once, under a finger once it has rested a moment, so that a finger that moves scrolls.
-   The cursor is the standard `move`, which every platform draws itself; the column under the
-   dragged card says it would take it, and a ghost of the card follows the pointer. */
+/* A card is dragged to another column from anywhere on it but its menu, its title included: with
+   a mouse at once, under a finger once it has rested a moment, so that a finger that moves
+   scrolls. The column under the dragged card says it would take it, and the card itself, whole,
+   follows the pointer while a faded one keeps its place. */
 .sc-card {
   position: relative;
 }
 
 .sc-card-movable {
-  cursor: move;
+  cursor: grab;
 }
 
 /* A finger resting on a card is neither selecting its words nor asking for the page's menu. */
@@ -3789,13 +3823,13 @@ table {
 }
 
 .sc-card-dragging {
-  opacity: 0.5;
+  opacity: 0.4;
 }
 
 .sc-board-dragging,
 .sc-board-dragging .sc-card,
 .sc-board-dragging .sc-card * {
-  cursor: move;
+  cursor: grabbing;
   user-select: none;
 }
 
@@ -3828,6 +3862,9 @@ table {
   height: 1rem;
 }
 
+/* Shown on the card under the pointer or with the focus, while the menu is open, and on the card
+   in hand, which is the card as it was hovered: its menu's dots, and the room they take. */
+.sc-drag-ghost .sc-card-menu-button,
 .sc-card:hover .sc-card-menu-button,
 .sc-card:focus-within .sc-card-menu-button,
 .sc-card-menu-button[aria-expanded="true"] {
@@ -3860,12 +3897,18 @@ table {
   z-index: 60;
   display: flex;
   flex-direction: column;
-  min-width: 10rem;
+  min-width: 8rem;
   padding: var(--sc-space-1);
   border: var(--sc-border);
-  border-radius: var(--sc-radius-lg);
+  border-radius: var(--sc-radius-md);
   background: var(--sc-color-bg-inset);
   box-shadow: var(--sc-shadow-stage);
+  font-size: var(--sc-text-sm);
+}
+
+.sc-card-menu .sc-menu-link {
+  padding: calc(var(--sc-space-1) + 1px) var(--sc-space-2);
+  border-radius: var(--sc-radius-sm);
 }
 
 .sc-column-over {
@@ -3878,17 +3921,16 @@ table {
   top: 0;
   left: 0;
   z-index: 50;
-  max-width: 18rem;
-  padding: var(--sc-space-2) var(--sc-space-3);
-  border: 1px solid var(--sc-color-accent);
-  border-radius: var(--sc-radius-lg);
-  background: var(--sc-color-bg-raised);
-  box-shadow: var(--sc-glow);
-  color: var(--sc-color-text);
-  font-size: var(--sc-text-sm);
   pointer-events: none;
 }
 
+.sc-drag-ghost .sc-card {
+  border-color: var(--sc-color-accent);
+  background: var(--sc-color-bg-raised);
+  box-shadow: var(--sc-shadow-stage);
+  transform: scale(1.02);
+}
+
 /* A goal's page reads as the board does: the facts in a row at its head, then a switch between
    the views of its tasks, then the view, which takes the rest of the height as the board does. */
 .sc-goal-page {