@skillcdn/console 0.4.2 → 0.4.3

package/src/components/decision-form.tsx

@@ -1,6 +1,7 @@
-import { type FormEvent, useMemo, useState } from "react";
+import { type ClipboardEvent, type FormEvent, useMemo, useState } from "react";
 import {
   MAX_BODY_LENGTH,
+  MAX_FILES_PER_DECISION,
   MAX_OPTION_LABEL_LENGTH,
   MAX_OPTIONS,
   MAX_QUESTION_LENGTH,
@@ -10,14 +11,17 @@ import {
   type RestTask,
 } from "../api.js";
 import { useWords } from "../i18n/index.js";
+import { isPicture, placing, unusedName } from "./files.js";
 import { Picker, type PickerSearch } from "./picker.js";
 import { type TaskSearch, taskLabel } from "./task-form.js";
-import { Button, PersonChip, personName } from "./ui.js";
+import { Button, formatBytes, PersonChip, personName } from "./ui.js";
 
 // Raising a decision: the question, what a person needs to know, the options to choose from,
 // and who is to answer (ADR-0042): the person raising it, unless they name another of the
 // project. The task it is about is the page's, when raised from a task; otherwise it is found
-// by searching the board a page at a time (ADR-0037), never picked from the board whole.
+// by searching the board a page at a time (ADR-0037), never picked from the board whole. The
+// files put on the decision (ADR-0055) are chosen or pasted here, a pasted picture placed in
+// the context where pictures are read, as a comment's are.
 
 export interface DecisionFormProps {
   /** The task it is about from the start, when raised from a task's page; the field is not shown then. */
@@ -30,7 +34,8 @@ export interface DecisionFormProps {
   readonly me?: RestPerson | undefined;
   readonly busy?: boolean | undefined;
   readonly error?: string | undefined;
-  readonly onSubmit: (input: RestDecisionInput) => void;
+  /** Called with the decision as the API takes it, and the files put on it (ADR-0055), none when none were chosen. */
+  readonly onSubmit: (input: RestDecisionInput, files: readonly File[]) => void;
   readonly onCancel?: (() => void) | undefined;
 }
 
@@ -59,20 +64,61 @@ export function DecisionForm(props: DecisionFormProps) {
   const [about, setAbout] = useState<RestTask | undefined>(undefined);
   const [options, setOptions] = useState<readonly string[]>(["", ""]);
   const [decider, setDecider] = useState<RestPerson | undefined>(props.me);
+  const [files, setFiles] = useState<readonly File[]>([]);
   const findDeciders = useMemo(() => peopleSearch(props.deciders ?? []), [props.deciders]);
 
   const labels = options.map((option) => option.trim()).filter((option) => option.length > 0);
   const ready = question.trim().length > 0 && labels.length >= MIN_OPTIONS;
 
+  const add = (chosen: readonly File[]): File[] => {
+    const added: File[] = [];
+    let held = files;
+    for (const file of chosen) {
+      if (held.length >= MAX_FILES_PER_DECISION) {
+        break;
+      }
+      const name = unusedName(
+        file.name,
+        held.map((kept) => kept.name),
+      );
+      const kept = name === file.name ? file : new File([file], name, { type: file.type });
+      held = [...held, kept];
+      added.push(kept);
+    }
+    setFiles(held);
+    return added;
+  };
+
+  // A picture pasted into the context goes with the decision, placed where pictures are read.
+  const paste = (event: ClipboardEvent<HTMLTextAreaElement>) => {
+    const pasted = [...event.clipboardData.files].filter((file) => isPicture(file.type));
+    if (pasted.length === 0) {
+      return;
+    }
+    event.preventDefault();
+    const added = add(pasted);
+    if (added.length > 0) {
+      setBody((current) =>
+        placing(
+          current,
+          added.map((file) => file.name),
+        ),
+      );
+    }
+  };
+
   const submit = (event: FormEvent) => {
     event.preventDefault();
-    props.onSubmit({
-      question: question.trim(),
-      body,
-      options: labels.map((label) => ({ label })),
-      taskId: props.taskId ?? about?.id ?? null,
-      ...(decider === undefined || decider.id === props.me?.id ? {} : { deciderId: decider.id }),
-    });
+    props.onSubmit(
+      {
+        question: question.trim(),
+        body,
+        options: labels.map((label) => ({ label })),
+        taskId: props.taskId ?? about?.id ?? null,
+        ...(decider === undefined || decider.id === props.me?.id ? {} : { deciderId: decider.id }),
+      },
+      files,
+    );
   };
 
   return (
@@ -96,8 +142,43 @@ export function DecisionForm(props: DecisionFormProps) {
           rows={4}
           placeholder={form.contextPlaceholder}
           onChange={(event) => setBody(event.target.value)}
+          onPaste={paste}
         />
       </label>
+      <div className="sc-field">
+        <span className="sc-field-label">{form.files}</span>
+        {files.length > 0 && (
+          <ul className="sc-chosen-files" aria-label={form.files}>
+            {files.map((file) => (
+              <li key={file.name} className="sc-chosen-file">
+                <span>{file.name}</span> <span className="sc-muted">{formatBytes(file.size)}</span>{" "}
+                <Button
+                  variant="ghost"
+                  size="sm"
+                  aria-label={form.removeFile(file.name)}
+                  onClick={() => setFiles((current) => current.filter((held) => held !== file))}
+                >
+                  ×
+                </Button>
+              </li>
+            ))}
+          </ul>
+        )}
+        <label className="sc-button sc-button-ghost sc-button-sm sc-file-choice">
+          {form.chooseFiles}
+          <input
+            className="sc-file-input"
+            type="file"
+            multiple
+            disabled={props.busy === true || files.length >= MAX_FILES_PER_DECISION}
+            onChange={(event) => {
+              add([...(event.target.files ?? [])]);
+              event.target.value = "";
+            }}
+          />
+        </label>
+        <p className="sc-field-hint">{form.filesHint}</p>
+      </div>
       {props.taskId === undefined && props.findTasks !== undefined && (
         <div className="sc-field">
           <span className="sc-field-label">{form.about}</span>

package/src/components/decision-list.tsx

@@ -6,13 +6,16 @@ import {
   MAX_OPTION_LABEL_LENGTH,
   type RestAnswerInput,
   type RestDecision,
+  type RestDecisionFile,
   type RestDecisionPatch,
   type RestTask,
 } from "../api.js";
 import { useWords } from "../i18n/index.js";
+import { isPicture, namedFile, placed } from "./files.js";
 import { Markdown } from "./markdown.js";
 import { Pager, pageOf, RECORD_PAGE_SIZE } from "./paged.js";
-import { Badge, Button, cx, PersonChip, personName, Time } from "./ui.js";
+import { Lightbox, PictureThumb, usePicture } from "./pictures.js";
+import { Badge, Button, cx, formatBytes, PersonChip, personName, Time } from "./ui.js";
 
 // The decisions: the ones that wait, each a card with the way to answer it, since they are what
 // a person came for; and the ones answered, the record, a row each, since they are read back
@@ -31,6 +34,8 @@ export interface DecisionCardProps {
   readonly href?: string | undefined;
   /** The project the decision is in, named where a page shows the decisions of several. */
   readonly project?: React.ReactNode;
+  /** Where a file put on the decision is read, by its id (ADR-0055); left out, the files are named and not linked. */
+  readonly fileHref?: ((fileId: string) => string) | undefined;
   /** Called with the person's answer. Left out, a waiting decision cannot be answered here. */
   readonly onAnswer?: ((decision: RestDecision, input: RestAnswerInput) => void) | undefined;
   /** Called to grow the record, with what followed. Left out, it cannot be written here. */
@@ -255,6 +260,20 @@ export function DecisionCard(props: DecisionCardProps) {
   const words = useWords();
   const { decision, task } = props;
   const answered = decision.answer !== null;
+  // The files put on the decision (ADR-0055): a picture the context names by its file name is
+  // shown where the text puts it; the rest follow the context, pictures in place and
+  // everything else as a link.
+  const files = decision.files ?? [];
+  const pictures = usePicture();
+  const hrefOf = (file: RestDecisionFile) => props.fileHref?.(file.id);
+  const named = (source: string): string | undefined => {
+    const name = namedFile(source);
+    const file = files.find(
+      (candidate) => candidate.file.name === name && isPicture(candidate.file.contentType),
+    );
+    return file === undefined ? undefined : hrefOf(file);
+  };
+  const following = files.filter((file) => !placed(decision.body, file.file.name));
 
   return (
     <article id={decision.id} className={cx("sc-decision", answered && "sc-decision-answered")}>
@@ -289,7 +308,53 @@ export function DecisionCard(props: DecisionCardProps) {
       {decision.body.length > 0 && (
         <section className="sc-decision-section" aria-label={words.decisions.context}>
           <h4 className="sc-decision-label">{words.decisions.context}</h4>
-          <Markdown source={decision.body} docHref={props.docHref} />
+          <Markdown
+            source={decision.body}
+            docHref={props.docHref}
+            fileSrc={named}
+            onOpenPicture={pictures.open}
+          />
+        </section>
+      )}
+      {following.length > 0 && (
+        <section className="sc-decision-section" aria-label={words.decisions.files}>
+          <h4 className="sc-decision-label">{words.decisions.files}</h4>
+          <ul className="sc-decision-files">
+            {following.map((attached) => {
+              const href = hrefOf(attached);
+              const { file } = attached;
+              if (href !== undefined && isPicture(file.contentType)) {
+                return (
+                  <li key={attached.id} className="sc-decision-picture">
+                    <PictureThumb
+                      picture={{
+                        src: href,
+                        alt: words.decisions.picture(file.name),
+                        name: file.name,
+                        size: file.size,
+                      }}
+                      onOpen={pictures.open}
+                    />
+                    <span className="sc-muted">
+                      {file.name}, {formatBytes(file.size)}
+                    </span>
+                  </li>
+                );
+              }
+              return (
+                <li key={attached.id}>
+                  {href === undefined ? (
+                    <span>{file.name}</span>
+                  ) : (
+                    <a href={href} rel="nofollow ugc">
+                      {file.name}
+                    </a>
+                  )}{" "}
+                  <span className="sc-muted">{formatBytes(file.size)}</span>
+                </li>
+              );
+            })}
+          </ul>
         </section>
       )}
       {decision.answer !== null ? (
@@ -322,6 +387,7 @@ export function DecisionCard(props: DecisionCardProps) {
           busy={props.busy}
         />
       )}
+      <Lightbox picture={pictures.shown} onClose={pictures.close} />
     </article>
   );
 }
@@ -332,6 +398,8 @@ export interface DecisionListProps {
   readonly tasks: ReadonlyMap<string, RestTask>;
   readonly taskHref?: ((task: RestTask) => string) | undefined;
   readonly docHref?: ((path: string) => string) | undefined;
+  /** Where a file put on a decision is read, by its id (ADR-0055). */
+  readonly fileHref?: ((fileId: string) => string) | undefined;
   /** Where each decision's own page is. */
   readonly decisionHref?: ((decision: RestDecision) => string) | undefined;
   /** The page of the record shown, from 1, and where each page is (ADR-0010); left out, the record turns its pages in place. */
@@ -465,6 +533,7 @@ export function DecisionList(props: DecisionListProps) {
       task={decision.taskId === null ? undefined : props.tasks.get(decision.taskId)}
       taskHref={props.taskHref}
       docHref={props.docHref}
+      fileHref={props.fileHref}
       href={props.decisionHref?.(decision)}
       onAnswer={props.onAnswer}
       onUpdate={props.onUpdate}

package/src/components/my-decisions.tsx

@@ -27,6 +27,8 @@ export interface MyDecisionsProps {
   /** The decisions the person asked of someone else: waiting and answered. */
   readonly raised: DecisionsPage;
   readonly decisionHref: (projectKey: string, decisionId: string) => string;
+  /** Where a file put on a decision is read, by its project's key and its id (ADR-0055). */
+  readonly fileHref?: ((projectKey: string, fileId: string) => string) | undefined;
   /** Called with the person's answer on a decision of theirs, in its project. Left out, a waiting decision is answered on its own page. */
   readonly onAnswer?:
     | ((projectKey: string, decision: RestDecision, input: RestAnswerInput) => void)
@@ -67,7 +69,7 @@ function More(props: {
 export function MyDecisions(props: MyDecisionsProps) {
   const words = useWords();
   const own = words.myDecisions;
-  const { onAnswer } = props;
+  const { onAnswer, fileHref } = props;
   const waiting = props.addressed.items.filter(({ decision }) => decision.answer === null);
   const asked = props.raised.items.filter(({ decision }) => decision.answer === null);
   const record = [...props.addressed.items, ...props.raised.items]
@@ -80,6 +82,7 @@ export function MyDecisions(props: MyDecisionsProps) {
       decision={item.decision}
       href={props.decisionHref(item.project.key, item.decision.id)}
       project={<InProject project={item.project} />}
+      fileHref={fileHref === undefined ? undefined : (fileId) => fileHref(item.project.key, fileId)}
       onAnswer={
         answerable && onAnswer !== undefined
           ? (decision, input) => onAnswer(item.project.key, decision, input)

package/src/components/task-view.tsx

@@ -83,7 +83,8 @@ export interface TaskViewProps {
   readonly error?: string | undefined;
   readonly onChange: (task: RestTask, patch: RestTaskInput) => void;
   readonly onMove: (task: RestTask, state: TaskState) => void;
-  readonly onRaiseDecision: (input: RestDecisionInput) => void;
+  /** Called with a decision raised about the task, and the files put on it (ADR-0055). */
+  readonly onRaiseDecision: (input: RestDecisionInput, files: readonly File[]) => void;
   readonly onAnswer: (decision: RestDecision, input: RestAnswerInput) => void;
   /** Called to grow a decision's record with what followed. */
   readonly onUpdateDecision?:

package/src/console.tsx

@@ -356,6 +356,14 @@ function useFollowLinks(navigation: Navigation): void {
 }
 
 /** The key of the project a route is on, or nothing. */
+/** The files chosen or pasted on a page, as the client sends them: each by its name, its bytes and its type where the browser knows one. */
+const uploadsOf = (files: readonly File[]): FileUpload[] =>
+  files.map((file) => ({
+    name: file.name,
+    bytes: file,
+    ...(file.type === "" ? {} : { contentType: file.type }),
+  }));
+
 const projectOf = (route: Route): string | undefined =>
   "project" in route ? route.project : undefined;
 
@@ -863,9 +871,9 @@ function TaskPage(props: {
         })
       }
       onMove={(target, state) => void act(() => data.actions.updateTask(target.id, { state }))}
-      onRaiseDecision={(input) =>
+      onRaiseDecision={(input, files) =>
         void act(async () => {
-          await data.actions.raiseDecision(input);
+          await data.actions.raiseDecision(input, uploadsOf(files));
           navigation.replace(here);
         })
       }
@@ -889,14 +897,7 @@ function TaskPage(props: {
       }
       onComment={(draft) =>
         void act(async () => {
-          await data.actions.comment(task.id, {
-            body: draft.body,
-            files: draft.files.map((file) => ({
-              name: file.name,
-              bytes: file,
-              ...(file.type === "" ? {} : { contentType: file.type }),
-            })),
-          });
+          await data.actions.comment(task.id, { body: draft.body, files: uploadsOf(draft.files) });
           setComments(await taskComments(task.id));
         })
       }
@@ -1311,6 +1312,7 @@ function ProjectPage(props: {
           tasks={tasksById}
           taskHref={href}
           docHref={toDoc}
+          fileHref={(fileId) => projectPath(key, "files", fileId)}
           decisionHref={(decision) => decisionHref(key, decision.id)}
           page={route.page}
           pageHref={(page) => decisionsHref(key, page)}
@@ -1337,9 +1339,9 @@ function ProjectPage(props: {
             deciders={data.members.map((member) => member.person)}
             me={data.me?.person ?? undefined}
             busy={busy}
-            onSubmit={(input: RestDecisionInput) =>
+            onSubmit={(input: RestDecisionInput, files: readonly File[]) =>
               void act(async () => {
-                const made = await data.actions.raiseDecision(input);
+                const made = await data.actions.raiseDecision(input, uploadsOf(files));
                 navigation.replace(decisionHref(key, made.id));
               })
             }
@@ -1366,6 +1368,7 @@ function ProjectPage(props: {
             task={decision.taskId === null ? undefined : tasksById.get(decision.taskId)}
             taskHref={href}
             docHref={toDoc}
+            fileHref={(fileId) => projectPath(key, "files", fileId)}
             onAnswer={onAnswer}
             onUpdate={onUpdate}
             busy={busy}
@@ -2301,6 +2304,7 @@ function MyDecisionsPage(props: { readonly data: ConsoleData }) {
           addressed={{ items: addressed.items, more: addressed.more, onMore: addressed.readMore }}
           raised={{ items: raised.items, more: raised.more, onMore: raised.readMore }}
           decisionHref={decisionHref}
+          fileHref={(projectKey, fileId) => projectPath(projectKey, "files", fileId)}
           onAnswer={onAnswer}
           busy={busy || addressed.busy || raised.busy}
         />
@@ -2575,6 +2579,7 @@ export function createConsole(config: ConsoleConfig = {}): ConsoleApp {
   const languages = config.languages ?? DEFAULT_LANGUAGES;
   const pages = config.pages ?? [];
 
+  // biome-ignore lint/correctness/noComponentHookFactories: createConsole runs once, when a console is built, never during a render; App is that console's one root component, closing over its config.
   function App(props: { readonly initialPath?: string | undefined }) {
     const { location, navigation } = useNavigation(props.initialPath);
     useFollowLinks(navigation);
@@ -2659,6 +2664,7 @@ export function createConsole(config: ConsoleConfig = {}): ConsoleApp {
           href: PATHS.decisions,
           label: words.nav.myDecisions,
           current: route.name === "my-decisions",
+          count: data.me?.decisions?.waiting,
         },
         {
           href: PATHS.people,

package/src/data.ts

@@ -125,7 +125,8 @@ export interface ConsoleActions {
     page: { readonly limit: number; readonly offset: number },
     signal?: AbortSignal,
   ): Promise<RestGoals>;
-  raiseDecision(input: RestDecisionInput): Promise<RestDecision>;
+  /** Raises a decision in the project; with `files`, the files put on it (ADR-0055). */
+  raiseDecision(input: RestDecisionInput, files?: readonly FileUpload[]): Promise<RestDecision>;
   answerDecision(id: string, input: RestAnswerInput): Promise<RestDecision>;
   /** Answers a decision of any project the person may see, by its project's key: for the person's own page of decisions (ADR-0042). */
   answerDecisionIn(projectKey: string, id: string, input: RestAnswerInput): Promise<RestDecision>;
@@ -382,6 +383,20 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
 
   const reload = useCallback(() => setGeneration((current) => current + 1), []);
 
+  /**
+   * Asks again who is signed in, for what moves with the board: the decisions waiting for the
+   * person, said beside My decisions. What fails stays as it was.
+   */
+  const refreshMe = useCallback(
+    async (signal?: AbortSignal) => {
+      const answer = await client.me(signal);
+      if (signal?.aborted !== true) {
+        setMe(answer);
+      }
+    },
+    [client],
+  );
+
   /** Loads the workspace's lists again. What fails stays as it was. */
   const refreshWorkspace = useCallback(
     async (signal?: AbortSignal) => {
@@ -571,6 +586,11 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
           if (event.kind.startsWith("project.")) {
             refreshWorkspace(signal).catch(() => undefined);
           }
+          // A decision raised or answered here may be one of the person's own: the count beside
+          // My decisions follows it.
+          if (event.kind.startsWith("decision.")) {
+            refreshMe(signal).catch(() => undefined);
+          }
         }, RELOAD_DELAY_MS);
       };
       for (const kind of EVENT_KINDS) {
@@ -584,7 +604,7 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
       source?.close();
       setLive(false);
     };
-  }, [client, projectKey, signedIn, generation, refreshProject, refreshWorkspace]);
+  }, [client, projectKey, signedIn, generation, refreshProject, refreshWorkspace, refreshMe]);
 
   const actions = useMemo<ConsoleActions>(() => {
     /** The project the page is on, for an action that needs one. */
@@ -684,16 +704,19 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
         scope().tasks({ archived: false, ...searchWordsOf(query), ...page }, signal),
       findGoals: (query, page, signal) =>
         scope().goals({ open: true, ...searchWordsOf(query), ...page }, signal),
-      async raiseDecision(input) {
-        const decision = await scope().raiseDecision(input);
-        await refreshProject();
+      async raiseDecision(input, files) {
+        const decision = await scope().raiseDecision(input, files);
+        await Promise.all([refreshProject(), refreshMe().catch(() => undefined)]);
+        return decision;
+      },
+      async answerDecisionIn(projectKey, id, input) {
+        const decision = await client.project(projectKey).answerDecision(id, input);
+        await refreshMe().catch(() => undefined);
         return decision;
       },
-      answerDecisionIn: (projectKey, id, input) =>
-        client.project(projectKey).answerDecision(id, input),
       async answerDecision(id, input) {
         const decision = await scope().answerDecision(id, input);
-        await refreshProject();
+        await Promise.all([refreshProject(), refreshMe().catch(() => undefined)]);
         return decision;
       },
       async updateDecision(id, patch) {
@@ -834,7 +857,7 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
         setLoaded(false);
       },
     };
-  }, [client, projectKey, refreshProject, refreshWorkspace]);
+  }, [client, projectKey, refreshProject, refreshWorkspace, refreshMe]);
 
   return {
     me,

package/src/i18n/en.ts

@@ -548,6 +548,8 @@ export const en = {
     about: "about",
     answeredBy: "answered",
     context: "Context",
+    files: "Files",
+    picture: (name: string) => `The picture ${name}`,
     whatFollowed: "What followed",
     nothingWritten: "Nothing written yet.",
     outcomePlaceholder: "What was done with the answer, and what came of it, in Markdown.",
@@ -557,6 +559,11 @@ export const en = {
       question: "Question",
       context: "Context",
       contextPlaceholder: "What a person needs to know to answer, in Markdown.",
+      files: "Files",
+      chooseFiles: "Add files",
+      filesHint:
+        "A picture pasted or chosen here goes with the decision; ![words](its name) places it in the context.",
+      removeFile: (name: string) => `Take ${name} out`,
       about: "About",
       noTask: "No task in particular",
       decider: "Who decides",

package/src/i18n/ko.ts

@@ -489,6 +489,8 @@ export const ko: Messages = {
     about: "관련 작업:",
     answeredBy: "답변",
     context: "맥락",
+    files: "파일",
+    picture: (name) => `그림 ${name}`,
     whatFollowed: "그 뒤에 일어난 일",
     nothingWritten: "아직 적힌 것이 없습니다.",
     outcomePlaceholder: "답변으로 무엇을 했고 무엇이 됐는지, Markdown으로.",
@@ -498,6 +500,11 @@ export const ko: Messages = {
       question: "질문",
       context: "맥락",
       contextPlaceholder: "답하려면 알아야 할 것, Markdown으로.",
+      files: "파일",
+      chooseFiles: "파일 추가",
+      filesHint:
+        "여기에 붙여 넣거나 고른 그림은 결정과 함께 올라갑니다. ![설명](파일 이름)으로 맥락에 넣을 수 있습니다.",
+      removeFile: (name) => `${name} 빼기`,
       about: "관련 작업",
       noTask: "특정 작업 없음",
       decider: "결정할 사람",

package/src/limits.ts

@@ -33,6 +33,8 @@ export const MAX_ARTIFACTS_PER_RUN = 50;
 /** How many comments one task carries, and how many files one comment carries, together within `MAX_FILE_BYTES`. */
 export const MAX_COMMENTS_PER_TASK = 500;
 export const MAX_FILES_PER_COMMENT = 10;
+/** How many files one decision carries, put on it when it is raised (ADR-0055), together within `MAX_FILE_BYTES`. */
+export const MAX_FILES_PER_DECISION = 10;
 /** A file a run hands in: how many bytes, and its name, one line without a path. */
 export const MAX_FILE_BYTES = 10 * 1024 * 1024;
 export const MAX_FILE_NAME_LENGTH = 200;

package/src/plugin/context.ts

@@ -255,7 +255,12 @@ export interface PluginWorkspace {
 export interface DecisionAsk {
   readonly question: string;
   readonly body?: string;
-  readonly options: readonly { readonly label: string }[];
+  /**
+   * The options, each a label and optionally a key (spelled as a plugin's key is, each once),
+   * which the answered event carries back as `optionKey`, so that the plugin reads the answer
+   * without comparing labels.
+   */
+  readonly options: readonly { readonly label: string; readonly key?: string }[];
   /** Who is to answer: a person who may work in the project; the project's owners when left out. */
   readonly deciderId?: string;
   readonly taskId?: string;