@skillcdn/console 0.1.15 → 0.1.16

package/dist/rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"rules.js","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,+FAA+F;AAC/F,2FAA2F;AAC3F,4FAA4F;AAC5F,2FAA2F;AAC3F,0FAA0F;AAC1F,mFAAmF;AAEnF,uGAAuG;AACvG,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC;AAElC,wCAAwC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,kCAAkC;IAClC,EAAE;IACF,mUAAmU;IACnU,EAAE;IACF,2BAA2B;IAC3B,EAAE;IACF,2fAA2f;IAC3f,4KAA4K;IAC5K,EAAE;IACF,8BAA8B;IAC9B,EAAE;IACF,uxBAAuxB;IACvxB,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,sRAAsR;IACtR,EAAE;IACF,wBAAwB;IACxB,EAAE;IACF,mZAAmZ;IACnZ,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,kTAAkT;IAClT,EAAE;IACF,YAAY;IACZ,EAAE;IACF,wbAAwb;IACxb,EAAE;IACF,uBAAuB;IACvB,EAAE;IACF,qaAAqa;IACra,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,sGAAsG;AACtG,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,yBAAyB;IACzB,EAAE;IACF,6DAA6D;IAC7D,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,cAAc;IACd,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,YAAY;IACZ,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,eAAe,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,0BAA0B,GAAG,YAAY,CAAC;AAEvD,6GAA6G;AAC7G,MAAM,cAAc,GAAG,qCAAqC,CAAC;AAE7D,2GAA2G;AAC3G,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAC3F,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,QAAmC;IACzE,MAAM,IAAI,GAAG,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,+FAA+F;AAC/F,2FAA2F;AAC3F,4FAA4F;AAC5F,2FAA2F;AAC3F,0FAA0F;AAC1F,mFAAmF;AAEnF,uGAAuG;AACvG,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC;AAElC,wCAAwC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,kCAAkC;IAClC,EAAE;IACF,mUAAmU;IACnU,EAAE;IACF,2BAA2B;IAC3B,EAAE;IACF,2fAA2f;IAC3f,4KAA4K;IAC5K,EAAE;IACF,8BAA8B;IAC9B,EAAE;IACF,uxBAAuxB;IACvxB,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,sRAAsR;IACtR,EAAE;IACF,wBAAwB;IACxB,EAAE;IACF,mZAAmZ;IACnZ,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,kTAAkT;IAClT,EAAE;IACF,YAAY;IACZ,EAAE;IACF,omBAAomB;IACpmB,EAAE;IACF,uBAAuB;IACvB,EAAE;IACF,qaAAqa;IACra,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,sGAAsG;AACtG,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,yBAAyB;IACzB,EAAE;IACF,6DAA6D;IAC7D,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,cAAc;IACd,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,YAAY;IACZ,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,eAAe,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,0BAA0B,GAAG,YAAY,CAAC;AAEvD,6GAA6G;AAC7G,MAAM,cAAc,GAAG,qCAAqC,CAAC;AAE7D,2GAA2G;AAC3G,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAC3F,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,QAAmC;IACzE,MAAM,IAAI,GAAG,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC"}

package/docs/specs/cli.md

@@ -46,7 +46,7 @@ The board is a project's ([ADR-0008](../adr/0008-a-workspace-holds-projects-and-
 | `skills` | `GET .../skills` | the project's skills, or the organization's: each with its description and the URI an agent loads it by through its own SkillCDN connection; or why there are none to show; where a person connects an agent that has no connection to the address, and where the console's own skills are on this machine, when the command knows |
 | `rules` | `GET .../rules`, or `GET /api/v1/rules` without a project named, and `GET /api/v1/me` | the rules that hold, as they read for the person (`{language}` is the language they chose, or the task's) ([ADR-0023](../adr/0023-the-rules-of-a-board-are-pages-the-workspace-and-its-projects-keep-read-first-by-every-agent.md)): the workspace's, the console's own until an administrator writes the organization's, with its version and who wrote it when written; then this project's own, or that it adds none |
 | `rules write --body <markdown>\|--file <path>\|-\|none [--workspace] [--base <version>]` | `PUT .../docs/rules` or `POST .../docs/rules/archive`; with `--workspace`, `PUT /api/v1/rules` or `POST /api/v1/rules/archive` | the version written, that the console's own rules sent as they are wrote nothing, or that the rules are put away; for an owner of the project, or an administrator for the workspace's |
-| `take <number\|id> [--agent <name>]` | `GET .../tasks/<ref>`, then `POST .../runs`, then `GET .../rules` and `GET /api/v1/me` | the run that began, the task in full, the rules that hold as they read for the person, and what to do next; a run open on the task is taken over ([ADR-0020](../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)) |
+| `take <number\|id> [--agent <name>]` | `GET .../tasks/<ref>`, then `POST .../runs`, then `GET .../rules`, `GET /api/v1/me` and `GET .../tasks/<ref>` again | the run that began, the task in full as it stands taken, the rules that hold as they read for the person, and what to do next; a run open on the task is taken over, and that is said when it happened ([ADR-0020](../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)) |
 | `report <markdown>`, `report --file <path>`, `report -` | `POST .../runs/<id>/reports` | how many reports the run carries |
 | `hand-in <https url \| file path> [--label <words>]` | `POST .../runs/<id>/artifacts` for a link; `POST .../runs/<id>/files` for a file, sent as a form with its name and its media type by extension | how many artifacts |
 | `ask "<question>" --option "<label>" ... [--body <markdown>\|--file <path>] [--wait <seconds>]` | `POST .../decisions` with `runId`, then `GET .../decisions/<id>?wait=` | the decision raised, its options; then the answer, or that it still waits |

package/docs/specs/rest.md

@@ -155,7 +155,7 @@ The project, as the asker sees it. A patch, for an owner, signed in or with a to
 
 ### `POST /api/v1/projects/<key>/icon`, `DELETE .../icon` and `GET .../icon`
 
-The project's own image for its mark, in place of the symbol on the colour. `POST`, for an owner, takes a form with a part called `file`: a PNG, a JPEG, a GIF or a WebP of at most `MAX_PROJECT_ICON_BYTES`, known by its first bytes and never by what the form says of it (`project.invalid_icon`; `request.too_large`). The bytes are kept by their hash, the project is answered with its `icon`, and the board hears `project.updated` with `fields: ["icon"]`; the same image again writes nothing. `DELETE` takes the image away and answers the project. `GET`, for whoever may see the project, answers the bytes with their type, the hash as `ETag` and `Cache-Control: private, max-age=86400`, or `304` to a matching `If-None-Match`; a project without an image is `project.no_icon`. The pages read it at `projectIconPath(key, icon)`, which carries the hash as a version.
+The project's own image for its mark, in place of the symbol on the colour. `POST`, for an owner, takes a form with a part called `file`: a PNG, a JPEG, a GIF or a WebP of at most `MAX_PROJECT_ICON_BYTES`, known by its first bytes and never by what the form says of it (`project.invalid_icon`; `request.too_large`). The bytes are kept by their hash, the project is answered with its `icon`, and the board hears `project.updated` with `fields: ["icon"]`; the same image again writes nothing. `DELETE` takes the image away and answers the project. `GET`, for whoever may see the project, answers the bytes with their type, the hash as `ETag` and `Cache-Control: private, max-age=86400, immutable`, since the address the pages read it at carries the hash, or `304` to a matching `If-None-Match`; a project without an image is `project.no_icon`. The pages read it at `projectIconPath(key, icon)`, which carries the hash as a version.
 
 ### `GET /api/v1/projects/<key>/members` and `POST /api/v1/projects/<key>/members`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillcdn/console",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "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/src/cli/cli.ts

@@ -974,17 +974,26 @@ const take: Command = async (args, io) => {
     ...(agent === undefined ? {} : { agent }),
   });
   // The rules come with the run, as they read for the person: everything from here acts
-  // within them (ADR-0023).
-  const [ruling, me] = await Promise.all([project.rules(), session.client.me()]);
+  // within them (ADR-0023); the task is read again, as it stands now that it is taken.
+  const [ruling, me, taken] = await Promise.all([
+    project.rules(),
+    session.client.me(),
+    project.task(ref),
+  ]);
+  // Taking a task with a run open on it ends that run (ADR-0020): said when it happened.
+  const tookOver =
+    found.openRuns > 0
+      ? " A run that was open on it is over now: the board cannot know whether its agent still ran, so taking it was deciding."
+      : "";
   const rules = {
     workspace: forPerson(ruling.workspace, me.language),
     project: forPerson(ruling.project, me.language),
   };
-  answer(io, session, { run, task: found, rules }, () =>
+  answer(io, session, { run, task: taken, rules }, () =>
     [
-      `Run ${run.id} began on #${found.number} ${found.title}, as "${run.agent}" for ${run.person.login}. The task is in progress and theirs. A run that was open on it is over now: the board cannot know whether its agent still ran, so taking it was deciding.`,
+      `Run ${run.id} began on #${found.number} ${found.title}, as "${run.agent}" for ${run.person.login}. The task is in progress and theirs.${tookOver}`,
       "",
-      formatTask(found),
+      formatTask(taken),
       "",
       formatRules(rules),
       "",

package/src/cli/help.ts

@@ -126,7 +126,7 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
     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), the decisions about it and the runs on it; 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).",
     limits: [
-      `title: one line, up to ${MAX_TITLE_LENGTH} characters`,
+      `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,
     ],

package/src/components/calendar.tsx

@@ -1,10 +1,17 @@
-import type { ReactNode, SyntheticEvent } from "react";
-import { OPEN_TASK_STATES, type RestCategory, type RestPerson, type RestTask } from "../api.js";
+import { type ReactNode, type SyntheticEvent, useState } from "react";
+import {
+  OPEN_TASK_STATES,
+  type RestCategory,
+  type RestGoal,
+  type RestPerson,
+  type RestTask,
+} from "../api.js";
 import {
   addDays,
   addMonths,
   daysBetween,
   firstDayOfWeek,
+  formatDay,
   formatDays,
   formatMonth,
   formatWeekday,
@@ -16,15 +23,16 @@ import {
   weekOf,
 } from "../dates.js";
 import { useLanguage, useWords } from "../i18n/index.js";
-import { Avatar, cx, PersonChip, personName } from "./ui.js";
+import { Avatar, CategoryBadge, cx, PersonChip, personName, StateBadge, Time } from "./ui.js";
 
 // The calendar of a project (ADR-0019): the month as a grid, or one week on its own. A task
 // planned from a start to a due day lies across its days as a bar, in a lane of its own within
 // each week so that the bars of one week never cross; a task with one day alone, a due day or
 // a start, sits on that day as a dot. On a project's calendar the person who has a task stands
 // before its title, since the days hold several people's work. Who has what says whether the
-// work is on its days. Takes its data as props and nothing from the network; the month or the
-// week shown is the address's (ADR-0010).
+// work is on its days. The task under the pointer is shown in full within its item, with the
+// facts its own page lists, above or below it where there is more room. Takes its data as props
+// and nothing from the network; the month or the week shown is the address's (ADR-0010).
 
 const isOpen = (task: RestTask): boolean => OPEN_TASK_STATES.includes(task.state);
 
@@ -40,6 +48,8 @@ export interface CalendarProps {
   readonly today?: string | undefined;
   /** The workspace's categories, for the legend to say what the colours mean. */
   readonly categories?: readonly RestCategory[] | undefined;
+  /** The project's goals, so that the task under the pointer is shown with its goal's title. */
+  readonly goals?: readonly RestGoal[] | undefined;
   readonly taskHref: (task: RestTask) => string;
   /** Where the calendar is on another month. */
   readonly monthHref: (month: string) => string;
@@ -131,6 +141,174 @@ const tone = (task: RestTask, now: string): string =>
     isOpen(task) && task.dueOn !== null && task.dueOn < now && "sc-calendar-late",
   );
 
+/** Where the card of the item under the pointer goes: the side with more room, kept within the window. */
+export interface TipPlace {
+  readonly side: "above" | "below";
+  /** How far the card moves from the item's left edge, in pixels, to stay within the window: zero or less. */
+  readonly shift: number;
+}
+
+/** What the card may grow to, in pixels: 20rem at the usual root size, as the style says. */
+const TIP_WIDTH = 320;
+/** What stays between the card and the window's edge, in pixels. */
+const TIP_MARGIN = 8;
+
+/**
+ * Places the card beside an item, from the item's box and the window's size, both in pixels from
+ * the window's top left corner: above the item where the room above is at least the room below,
+ * else below it, and moved left where it would otherwise leave the window on the right.
+ */
+export function placeTip(
+  item: { readonly top: number; readonly bottom: number; readonly left: number },
+  window: { readonly width: number; readonly height: number },
+): TipPlace {
+  const side = item.top >= window.height - item.bottom ? "above" : "below";
+  const left = Math.max(TIP_MARGIN, Math.min(item.left, window.width - TIP_WIDTH - TIP_MARGIN));
+  return { side, shift: Math.min(0, left - item.left) };
+}
+
+/** The item the pointer is on: a task on a day, since a bar has an item on each of its days, and where its card goes. */
+interface Pointed {
+  readonly task: RestTask;
+  readonly day: string;
+  readonly place: TipPlace;
+}
+
+/** The item under the pointer, measured as the pointer arrives, since only the browser knows where it is. */
+function usePointed(): [
+  Pointed | null,
+  (task: RestTask, day: string, item: HTMLElement) => void,
+  () => void,
+] {
+  const [pointed, setPointed] = useState<Pointed | null>(null);
+  const point = (task: RestTask, day: string, item: HTMLElement): void =>
+    setPointed({
+      task,
+      day,
+      place: placeTip(item.getBoundingClientRect(), {
+        width: window.innerWidth,
+        height: window.innerHeight,
+      }),
+    });
+  const leave = (): void => setPointed(null);
+  return [pointed, point, leave];
+}
+
+export interface TaskTipProps {
+  readonly task: RestTask;
+  /** The project's goals, so that the task's goal is named by its title; without them the row is left out. */
+  readonly goals?: readonly RestGoal[] | undefined;
+  readonly place: TipPlace;
+}
+
+/**
+ * The task under the pointer in full: its number and its title, then the facts its own page lists
+ * beside the text, those that are set. Lies within the item it belongs to, above or below it, and
+ * out of the accessible tree: the item's text is the title, and the facts are on the task's page.
+ */
+export function TaskTip(props: TaskTipProps) {
+  const words = useWords();
+  const { tag } = useLanguage();
+  const { task, place } = props;
+  const goal = props.goals?.find((candidate) => candidate.id === task.goalId);
+  const day = (value: string): string => formatDay(value, tag);
+  return (
+    <div
+      className={cx(
+        "sc-task-tip",
+        place.side === "above" ? "sc-task-tip-above" : "sc-task-tip-below",
+      )}
+      style={{ left: place.shift }}
+      aria-hidden="true"
+    >
+      <p className="sc-task-tip-title">
+        #{task.number} {task.title}
+      </p>
+      <dl className="sc-task-tip-facts">
+        <div>
+          <dt>{words.task.state}</dt>
+          <dd>
+            <StateBadge state={task.state} />
+          </dd>
+        </div>
+        <div>
+          <dt>{words.task.form.priority}</dt>
+          <dd>{words.vocabulary.priority[task.priority]}</dd>
+        </div>
+        {task.category !== null && (
+          <div>
+            <dt>{words.task.category}</dt>
+            <dd>
+              <CategoryBadge category={task.category} />
+            </dd>
+          </div>
+        )}
+        {goal !== undefined && (
+          <div>
+            <dt>{words.task.goal}</dt>
+            <dd>{goal.title}</dd>
+          </div>
+        )}
+        <div>
+          <dt>{words.task.owner}</dt>
+          <dd>
+            <PersonChip person={task.owner} />
+          </dd>
+        </div>
+        <div>
+          <dt>{words.task.assignee}</dt>
+          <dd>
+            {task.assignee === null ? (
+              <span className="sc-muted">{words.common.nobody}</span>
+            ) : (
+              <PersonChip person={task.assignee} />
+            )}
+          </dd>
+        </div>
+        {(task.startsOn !== null || task.dueOn !== null) && (
+          <div>
+            <dt>{words.task.plan}</dt>
+            <dd>
+              {words.task.planned(
+                task.startsOn === null ? undefined : day(task.startsOn),
+                task.dueOn === null ? undefined : day(task.dueOn),
+              )}
+            </dd>
+          </div>
+        )}
+        {task.startedAt !== null && (
+          <div>
+            <dt>{words.task.started}</dt>
+            <dd>
+              <Time iso={task.startedAt} />
+            </dd>
+          </div>
+        )}
+        {task.doneAt !== null && (
+          <div>
+            <dt>{words.task.done}</dt>
+            <dd>
+              <Time iso={task.doneAt} />
+            </dd>
+          </div>
+        )}
+        <div>
+          <dt>{words.task.written}</dt>
+          <dd>
+            <Time iso={task.createdAt} />
+          </dd>
+        </div>
+        <div>
+          <dt>{words.task.changed}</dt>
+          <dd>
+            <Time iso={task.updatedAt} />
+          </dd>
+        </div>
+      </dl>
+    </div>
+  );
+}
+
 interface WeekRowProps {
   readonly week: readonly GridDay[];
   readonly segments: readonly WeekSegment[];
@@ -142,26 +320,30 @@ interface WeekRowProps {
   readonly markOf?: ((task: RestTask) => ReactNode) | undefined;
   /** Whether the person who has a task stands before its title, where the days hold several people's work. */
   readonly people?: boolean | undefined;
-}
-
-/**
- * Marks an item whose title its line cut short, or which shows none (a bar on its later days),
- * so that the tip it carries in `data-tip` is shown at once while the pointer is on it. Measured
- * as the pointer arrives, since only the browser knows where the line ended.
- */
-function reveal(event: SyntheticEvent<HTMLElement>): void {
-  const item = event.currentTarget;
-  const title = item.querySelector(".sc-calendar-task-title");
-  item.toggleAttribute("data-clipped", title === null || title.scrollWidth > title.clientWidth);
+  /** The item under the pointer, shown in full within that item, or none. */
+  readonly pointed: Pointed | null;
+  /** The project's goals, so that the item under the pointer names its goal; none across projects. */
+  readonly goals?: readonly RestGoal[] | undefined;
+  /** The pointer, or the focus, arrived on a task's item on a day. */
+  readonly onPoint: (task: RestTask, day: string, item: HTMLElement) => void;
+  /** It left. */
+  readonly onLeave: () => void;
 }
 
 /** One week as a row of cells: the bars across the days in their lanes, then the tasks on each day. */
 function WeekRow(props: WeekRowProps) {
   const { week, segments, now } = props;
-  const tip = (task: RestTask): string =>
-    props.people === true && task.assignee !== null
-      ? `#${task.number} ${task.title} \u00B7 ${personName(task.assignee)}`
-      : `#${task.number} ${task.title}`;
+  const pointing = (task: RestTask, day: string) => ({
+    onMouseEnter: (event: SyntheticEvent<HTMLElement>) =>
+      props.onPoint(task, day, event.currentTarget),
+    onMouseLeave: props.onLeave,
+    onFocus: (event: SyntheticEvent<HTMLElement>) => props.onPoint(task, day, event.currentTarget),
+    onBlur: props.onLeave,
+  });
+  const tipIn = (task: RestTask, day: string): ReactNode =>
+    props.pointed !== null && props.pointed.task.id === task.id && props.pointed.day === day ? (
+      <TaskTip task={task} goals={props.goals} place={props.pointed.place} />
+    ) : null;
   const who = (task: RestTask): ReactNode =>
     props.people === true && task.assignee !== null ? (
       <Avatar person={task.assignee} size="xs" />
@@ -199,12 +381,9 @@ function WeekRow(props: WeekRowProps) {
                   segment.from === column && segment.begins && "sc-calendar-bar-begins",
                   segment.to === column && segment.ends && "sc-calendar-bar-ends",
                   tone(task, now),
-                  "sc-tip",
                 )}
                 href={props.taskHref(task)}
-                data-tip={tip(task)}
-                onMouseEnter={reveal}
-                onFocus={reveal}
+                {...pointing(task, cell.day)}
               >
                 {segment.from === column && (
                   <>
@@ -213,6 +392,7 @@ function WeekRow(props: WeekRowProps) {
                     <span className="sc-calendar-task-title">{task.title}</span>
                   </>
                 )}
+                {tipIn(task, cell.day)}
               </a>
             );
           })}
@@ -221,11 +401,9 @@ function WeekRow(props: WeekRowProps) {
             return (
               <a
                 key={task.id}
-                className={cx("sc-calendar-task", tone(task, now), "sc-tip")}
+                className={cx("sc-calendar-task", tone(task, now))}
                 href={props.taskHref(task)}
-                data-tip={tip(task)}
-                onMouseEnter={reveal}
-                onFocus={reveal}
+                {...pointing(task, cell.day)}
               >
                 {mark === undefined || mark === null ? (
                   <span
@@ -239,6 +417,7 @@ function WeekRow(props: WeekRowProps) {
                 )}
                 {who(task)}
                 <span className="sc-calendar-task-title">{task.title}</span>
+                {tipIn(task, cell.day)}
               </a>
             );
           })}
@@ -251,6 +430,7 @@ function WeekRow(props: WeekRowProps) {
 export function Calendar(props: CalendarProps) {
   const words = useWords().calendar;
   const { tag } = useLanguage();
+  const [pointed, point, leave] = usePointed();
   const now = props.today ?? todayOf();
   const firstDay = firstDayOfWeek(tag);
   const weeks = monthGrid(props.month, firstDay);
@@ -310,6 +490,10 @@ export function Calendar(props: CalendarProps) {
               on={on}
               now={now}
               taskHref={props.taskHref}
+              pointed={pointed}
+              goals={props.goals}
+              onPoint={point}
+              onLeave={leave}
               people
             />
           ))}
@@ -349,6 +533,7 @@ export interface WeekProps {
 export function Week(props: WeekProps) {
   const words = useWords().calendar.week;
   const { tag } = useLanguage();
+  const [pointed, point, leave] = usePointed();
   const now = props.today ?? todayOf();
   const firstDay = firstDayOfWeek(tag);
   const days = weekOf(props.day ?? now, firstDay);
@@ -400,6 +585,9 @@ export function Week(props: WeekProps) {
             now={now}
             taskHref={props.taskHref}
             markOf={props.markOf}
+            pointed={pointed}
+            onPoint={point}
+            onLeave={leave}
           />
         </tbody>
       </table>

package/src/components/projects.tsx

@@ -25,7 +25,10 @@ import {
 import { useWords } from "../i18n/index.js";
 import { Badge, Button, cx, PersonChip, personName, Time } from "./ui.js";
 
-/** A project's mark: its symbol on its colour, so that projects tell apart at a glance. */
+/**
+ * A project's mark: its symbol on its colour, so that projects tell apart at a glance; its own
+ * image over the symbol where it has one, so that the mark is never empty while the image loads.
+ */
 export function ProjectMark(props: {
   readonly project: {
     readonly key: string;
@@ -53,11 +56,8 @@ export function ProjectMark(props: {
       )}
       aria-hidden="true"
     >
-      {src === undefined ? (
-        projectSymbolOf(props.project)
-      ) : (
-        <img className="sc-mark-image" src={src} alt="" />
-      )}
+      {projectSymbolOf(props.project)}
+      {src !== undefined && <img className="sc-mark-image" src={src} alt="" />}
     </span>
   );
 }

package/src/components/task-form.tsx

@@ -96,6 +96,7 @@ export function TaskForm(props: TaskFormProps) {
         <input
           className="sc-input"
           value={title}
+          placeholder={form.titlePlaceholder}
           maxLength={MAX_TITLE_LENGTH}
           required
           onChange={(event) => setTitle(event.target.value)}

package/src/console.tsx

@@ -677,6 +677,7 @@ function ProjectPage(props: {
           month={month}
           today={now}
           categories={data.categories}
+          goals={data.goals}
           taskHref={href}
           monthHref={(wanted) => calendarHref(key, wanted, route.filter)}
         />

package/src/i18n/en.ts

@@ -131,7 +131,7 @@ export const en = {
   },
 
   signIn: {
-    lead: "The board of the work, the agents at it, what they did, and the decisions that wait for a person.",
+    lead: "Join an organization made of AI agents.",
     continueWith: (provider: string) => `Continue with ${provider}`,
     nobody: {
       title: "Nobody can sign in here yet",
@@ -269,6 +269,7 @@ export const en = {
     done: "Done",
     form: {
       title: "Title",
+      titlePlaceholder: "What is to be done, in plain words that stand on their own.",
       body: "Body",
       bodyPlaceholder: "What is to be done, in Markdown.",
       state: "State",
@@ -299,7 +300,7 @@ export const en = {
       body: "It may belong to another project, or the link is wrong.",
     },
     empty: {
-      title: "Nothing waits for a person",
+      title: "No decision waits for a person",
       body: "A decision raised from a task, or from here, shows up on this page.",
     },
     waiting: "Waiting",

package/src/i18n/ko.ts

@@ -101,7 +101,7 @@ export const ko: Messages = {
   },
 
   signIn: {
-    lead: "할 일의 보드, 일하는 에이전트, 그들이 한 일, 그리고 사람을 기다리는 결정.",
+    lead: "AI 에이전트로 이뤄진 조직에 합류하세요.",
     continueWith: (provider) => `${provider}로 계속`,
     nobody: {
       title: "아직 아무도 로그인할 수 없습니다",
@@ -238,6 +238,7 @@ export const ko: Messages = {
     done: "완료",
     form: {
       title: "제목",
+      titlePlaceholder: "무엇을 할지, 제목만 보고도 알 수 있게.",
       body: "본문",
       bodyPlaceholder: "무엇을 할지, Markdown으로.",
       state: "상태",
@@ -268,7 +269,7 @@ export const ko: Messages = {
       body: "다른 프로젝트의 것이거나, 링크가 잘못됐습니다.",
     },
     empty: {
-      title: "사람을 기다리는 것이 없습니다",
+      title: "사람을 기다리는 결정이 없습니다",
       body: "작업에서, 또는 여기서 요청한 결정이 이 페이지에 나타납니다.",
     },
     waiting: "대기 중",

package/src/rules.ts

@@ -44,7 +44,7 @@ export const REFERENCE_RULES = [
   "",
   "## Reports",
   "",
-  "Report at the milestones, not every step: what was found, what was done, what is next, in words for people; a problem as a problem, with what it blocks. What people read on the board, the reports, the questions and their options, the tasks and the pages, is written in {language}. The result goes in a last report or is handed in as a link or a file, with the check that ran and its result; a check that did not run is said to be not run.",
+  "Report at the milestones, not every step: what was found, what was done, what is next, in words for people; a problem as a problem, with what it blocks. What people read on the board, the reports, the questions and their options, the tasks and the pages, is written in {language}. A task's title says what is to be done, in plain words that stand on their own; what it refers to, a milestone, a commit, a page, goes in the body, linked where it can be. The result goes in a last report or is handed in as a link or a file, with the check that ran and its result; a check that did not run is said to be not run.",
   "",
   "## What never happens",
   "",