@skillcdn/console 0.1.12 → 0.1.13

package/src/cli/help.ts

@@ -3,6 +3,9 @@ import {
   MAX_AGENT_LENGTH,
   MAX_ARTIFACTS_PER_RUN,
   MAX_BODY_LENGTH,
+  MAX_CATEGORIES,
+  MAX_CATEGORY_KEY_LENGTH,
+  MAX_CATEGORY_NAME_LENGTH,
   MAX_DOCUMENT_LENGTH,
   MAX_DOCUMENT_PATH_LENGTH,
   MAX_FILE_BYTES,
@@ -10,6 +13,11 @@ import {
   MAX_LINK_LABEL_LENGTH,
   MAX_OPTION_LABEL_LENGTH,
   MAX_OPTIONS,
+  MAX_PROJECT_DESCRIPTION_LENGTH,
+  MAX_PROJECT_ICON_BYTES,
+  MAX_PROJECT_KEY_LENGTH,
+  MAX_PROJECT_NAME_LENGTH,
+  MAX_PROJECT_SYMBOL_LENGTH,
   MAX_QUESTION_LENGTH,
   MAX_REPORTS_PER_RUN,
   MAX_SUMMARY_LENGTH,
@@ -17,6 +25,7 @@ import {
   MAX_VERSIONS_PER_DOCUMENT,
   MIN_OPTIONS,
 } from "../limits.js";
+import { COLOR_NAMES } from "../vocabulary.js";
 
 // What the command says about itself: for an agent that meets it for the first time, and for a
 // person. One table for every command, from which the usage and each command's help are made:
@@ -53,6 +62,8 @@ const DOCUMENT_PATH = `a path of lowercase letters, digits and hyphens, with sla
 const DOCUMENT_REFUSALS = ["document.not_found: no page has that path in this project"];
 
 const DAY = "a day as 2026-10-24, today, tomorrow, or +7 for seven days from today";
+const COLORS = `one of ${COLOR_NAMES.join(", ")}`;
+const KEY = "lowercase letters, digits and hyphens";
 const TASK_FIELD_FLAGS =
   "[--state <state>] [--priority <priority>] [--category <key>] [--goal <id>] [--starts <day>] [--due <day>] [--assignee <login|me>] [--parent <number|id>]";
 const TASK_FIELD_LIMITS = [
@@ -143,7 +154,76 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
   categories: {
     usage: "categories",
     about:
-      "The categories tasks are sorted into, the same in every project: each with its key, which --category takes, its name and its colour. An administrator keeps them on the console's Categories page.",
+      "The categories tasks are sorted into, the same in every project: each with its key, which --category takes, its name and its colour. An administrator keeps them: console category, or the Categories page.",
+  },
+  people: {
+    usage: "people",
+    about:
+      "Everyone of the workspace, by login, with their name where the host gives one and what they are in it: admin, who configures the workspace, or member, who works in the projects they are in. The logins are what --assignee, member and person role take.",
+  },
+  person: {
+    usage: "person role <login> <admin|member>",
+    about:
+      "Says what a person is in the workspace, for an administrator: the person themselves on the People page, or their agent here, named on it. The board keeps at least one administrator.",
+    refusals: [
+      "auth.forbidden: only an administrator says what a person is",
+      "person.last_admin: the board keeps at least one administrator; make another one first",
+    ],
+  },
+  project: {
+    usage:
+      'project <key>  |  project new <key> "<name>" [--description <markdown>|--file <path>] [--visibility workspace|private] [--skills <address>|none] [--color <name>] [--symbol <text>]  |  project edit <key> [--name "<name>"] [the same flags; none clears]  |  project icon <key> <file>  |  project icon <key> --remove',
+    about:
+      "One project in full; or a project made, with you as its owner, private unless --visibility workspace says everyone of the workspace works in it; or one changed, only in what the flags say, for an owner; or its image for its mark, set from a file of this machine or taken away. The organization's skills are the project's unless --skills names an address of its own.",
+    limits: [
+      `key: ${KEY}, up to ${MAX_PROJECT_KEY_LENGTH} characters; it does not change once made`,
+      `name: one line, up to ${MAX_PROJECT_NAME_LENGTH} characters; description: up to ${MAX_PROJECT_DESCRIPTION_LENGTH}`,
+      `color: ${COLORS}; symbol: up to ${MAX_PROJECT_SYMBOL_LENGTH} characters without spaces, shown on the colour; left out, the pages choose both from the key and the name`,
+      `image: a PNG, a JPEG, a GIF or a WebP of at most ${MAX_PROJECT_ICON_BYTES} bytes`,
+    ],
+    refusals: [
+      "project.not_found: no project has that key, or it is not yours to see",
+      "auth.forbidden: only an owner of the project changes it",
+      "project.key_taken: a project has that key already",
+      "project.invalid_address: the skills address is not one as SkillCDN spells it",
+      "project.invalid_icon: the file is not an image of those kinds, by its bytes",
+      "request.too_large: the image is over the limit",
+    ],
+  },
+  members: {
+    usage: "members",
+    about:
+      "Those listed in the project, by login, with what each is in it (owner, who configures it; member, who works on it) and since when. A project open to the workspace has everyone of it as a member besides, and an administrator owns every project.",
+  },
+  member: {
+    usage:
+      "member add <login> [--role owner|member]  |  member role <login> <owner|member>  |  member remove <login>",
+    about:
+      "Lists a person of the workspace in the project, as a member unless --role says owner; changes what they are in it; or takes them off the list. For an owner of the project.",
+    refusals: [
+      "auth.forbidden: only an owner of the project lists its members",
+      "member.invalid_person: the person is not of the workspace",
+      "member.exists: the person is listed already; member role changes what they are",
+      "member.not_found: the person is not listed in the project",
+    ],
+  },
+  category: {
+    usage:
+      'category new <key> "<name>" [--color <name>]  |  category edit <key> [--name "<name>"] [--color <name>]  |  category remove <key>',
+    about:
+      "Makes a category tasks are sorted into, the same in every project; changes its name or its colour; or removes one no task is sorted into. For an administrator.",
+    limits: [
+      `key: ${KEY}, up to ${MAX_CATEGORY_KEY_LENGTH} characters; it does not change once made`,
+      `name: one line, up to ${MAX_CATEGORY_NAME_LENGTH} characters; color: ${COLORS}, gray when left out`,
+      `at most ${MAX_CATEGORIES} categories in the workspace`,
+    ],
+    refusals: [
+      "auth.forbidden: only an administrator keeps the categories",
+      "category.key_taken: a category has that key already",
+      "category.not_found: no category has that key",
+      "category.in_use: tasks are sorted into it; move them out first (console task edit <number> --category <other|none>)",
+      "category.too_many: the workspace holds as many categories as one may",
+    ],
   },
   skills: {
     usage: "skills",
@@ -352,6 +432,11 @@ const SECTIONS: readonly { readonly title: string; readonly commands: readonly s
     title: "The documents: the project's pages of Markdown, in folders, by path",
     commands: ["docs", "doc", "write", "attach", "archive", "restore"],
   },
+  {
+    title:
+      "Configuring, as the person: what an administrator or an owner does on the pages, their agent does here, named on it",
+    commands: ["people", "person", "project", "members", "member", "category"],
+  },
 ];
 
 /** The whole usage, as `console help` prints it, naming the version when it is known. */

package/src/console.tsx

@@ -332,13 +332,12 @@ function holdsToken(data: ConsoleData): boolean {
 }
 
 /**
- * The pages a console that holds a token does not offer: the tokens themselves and
- * configuring, which are a person's own doing on the console's own pages, signed in.
+ * The pages a console that holds a token does not offer: the tokens themselves, and the
+ * approval of an agent's connection, which makes one; a person's own doing on the console's
+ * own pages, signed in. Everything else a person may do, their agent may (ADR-0021).
  */
 export function onlyOnOwnPages(route: Route): boolean {
   return (
-    route.name === "new-project" ||
-    route.name === "settings" ||
     route.name === "agents" ||
     route.name === "new-token" ||
     route.name === "person-agents" ||
@@ -351,28 +350,6 @@ function NotWithToken() {
   return <EmptyState title={words.title} body={words.body} />;
 }
 
-/**
- * Where a console that holds a token keeps the person's choice of language: the browser's own
- * storage, which may be absent or refuse, and then the browser's languages decide.
- */
-const LANGUAGE_KEY = "sc-language";
-
-function storedLanguage(): string | undefined {
-  try {
-    return globalThis.localStorage?.getItem(LANGUAGE_KEY) ?? undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-function storeLanguage(tag: string): void {
-  try {
-    globalThis.localStorage?.setItem(LANGUAGE_KEY, tag);
-  } catch {
-    // A browser that keeps nothing: the choice holds for this page.
-  }
-}
-
 /** A link that reads as a button: where a form is, for instance. */
 function LinkButton(props: {
   readonly href: string;
@@ -397,12 +374,11 @@ function ProjectsPage(props: {
   const { data, components, navigation, making } = props;
   const { busy, error, act } = useAction();
   const href = (project: RestProject) => projectHref(project.key);
-  const configures = !holdsToken(data);
   return (
     <>
       <div className="sc-page-head">
         <h1 className="sc-page-title">{words.title}</h1>
-        {!making && configures && (
+        {!making && (
           <LinkButton href={PATHS.newProject} variant="primary">
             {words.newProject}
           </LinkButton>
@@ -435,11 +411,7 @@ function ProjectsPage(props: {
           <EmptyState
             title={words.empty.title}
             body={words.empty.body}
-            action={
-              configures ? (
-                <LinkButton href={PATHS.newProject}>{words.newProject}</LinkButton>
-              ) : undefined
-            }
+            action={<LinkButton href={PATHS.newProject}>{words.newProject}</LinkButton>}
           />
         }
       />
@@ -966,7 +938,7 @@ function ProjectPage(props: {
   }
   if (route.name === "members") {
     const me = data.me?.person ?? undefined;
-    const configures = owner && !holdsToken(data);
+    const configures = owner;
     const members = words.projects.members;
     return (
       <>
@@ -1200,7 +1172,7 @@ function WorkspacePage(props: {
   }
   if (route.name === "categories") {
     const me = data.me?.person ?? undefined;
-    const administrator = me?.role === "admin" && !holdsToken(data);
+    const administrator = me?.role === "admin";
     const categories = words.categories;
     return (
       <>
@@ -1239,7 +1211,7 @@ function WorkspacePage(props: {
 
   if (route.name === "people") {
     const me = data.me?.person ?? undefined;
-    const administrator = me?.role === "admin" && !holdsToken(data);
+    const administrator = me?.role === "admin";
     return (
       <>
         <div className="sc-page-head">
@@ -1334,10 +1306,7 @@ export function createConsole(config: ConsoleConfig = {}): ConsoleApp {
     const title = data.me?.workspace.name ?? fallbackTitle;
     const viaToken = holdsToken(data);
     // The language: the person's choice, else the browser's, else the first the console speaks.
-    // A console that holds a token cannot keep the choice on the person, and keeps it in the
-    // browser instead.
-    const [ownChoice, setOwnChoice] = useState<string | undefined>(storedLanguage);
-    const chosen = viaToken ? (ownChoice ?? data.me?.language) : data.me?.language;
+    const chosen = data.me?.language;
     const pack = useMemo(
       () =>
         chooseLanguage(
@@ -1485,7 +1454,7 @@ export function createConsole(config: ConsoleConfig = {}): ConsoleApp {
                 label: words.nav.members,
                 current: route.name === "members",
               },
-              ...(project?.role === "owner" && !viaToken
+              ...(project?.role === "owner"
                 ? [
                     {
                       href: projectHref(projectKey, "settings"),
@@ -1591,14 +1560,7 @@ export function createConsole(config: ConsoleConfig = {}): ConsoleApp {
             label: candidate.label,
             current: candidate.tag === pack.tag,
           }))}
-          onLanguage={(tag) => {
-            if (viaToken) {
-              storeLanguage(tag);
-              setOwnChoice(tag);
-            } else {
-              void data.actions.updateMe({ language: tag }).catch(() => undefined);
-            }
-          }}
+          onLanguage={(tag) => void data.actions.updateMe({ language: tag }).catch(() => undefined)}
           person={data.me.person}
           live={projectKey === undefined ? undefined : data.live}
           wide={

package/src/i18n/en.ts

@@ -89,7 +89,7 @@ export const en = {
     },
     notWithToken: {
       title: "Done on the console's own pages",
-      body: "This console holds a token, which acts as you on the board. Connecting agents, configuring projects and people, and keeping a language are done on the organization's console, signed in.",
+      body: "This console holds a token, which acts as you on the board, configuring included. Agents are connected, and tokens made and removed, on the organization's console, signed in.",
     },
     you: "(you)",
     nobody: "Nobody",
@@ -684,7 +684,7 @@ export const en = {
     lookingUp: "Looking the code up",
     notACode: "That is not a code: eight letters and digits, in two groups.",
     noSuchCode:
-      "No agent asks to connect with this code. A code is good for ten minutes and for one approval; ask your agent for a new one.",
+      "No agent asks to connect with this code. A code is good for thirty minutes and for one approval; ask your agent for a new one.",
     couldNotAsk: "The console could not be asked.",
     asks: {
       title: "An agent asks to connect as you",

package/src/i18n/ko.ts

@@ -62,7 +62,7 @@ export const ko: Messages = {
     },
     notWithToken: {
       title: "콘솔 자체 페이지에서 하는 일입니다",
-      body: "이 콘솔은 토큰으로 당신을 대신해 보드를 씁니다. 에이전트 연결, 프로젝트와 사람 설정, 언어 저장은 조직 콘솔에 로그인해서 합니다.",
+      body: "이 콘솔은 토큰으로 당신을 대신해 보드를 쓰며, 설정도 그렇게 합니다. 에이전트 연결과 토큰 관리는 조직 콘솔에 로그인해서 합니다.",
     },
     you: "(나)",
     nobody: "없음",
@@ -652,7 +652,7 @@ export const ko: Messages = {
     lookingUp: "코드를 찾는 중",
     notACode: "코드가 아닙니다. 영문자와 숫자 여덟 자, 두 묶음입니다.",
     noSuchCode:
-      "이 코드로 연결을 요청한 에이전트가 없습니다. 코드는 10분 동안, 한 번의 승인에만 유효합니다. 에이전트에게 새 코드를 요청하세요.",
+      "이 코드로 연결을 요청한 에이전트가 없습니다. 코드는 30분 동안, 한 번의 승인에만 유효합니다. 에이전트에게 새 코드를 요청하세요.",
     couldNotAsk: "콘솔에 물어볼 수 없습니다.",
     asks: {
       title: "에이전트가 나로서 연결하기를 요청합니다",