@skillcdn/console 0.1.13 → 0.1.15

package/src/data.ts

@@ -20,16 +20,23 @@ import {
   type RestGoal,
   type RestGoalInput,
   type RestGoalPatch,
+  type RestListing,
+  type RestListingInput,
   type RestMe,
   type RestMember,
   type RestMemberInput,
   type RestMemberPatch,
   type RestMePatch,
+  type RestOrganization,
   type RestPerson,
   type RestPersonPatch,
+  type RestPersonWork,
   type RestProject,
   type RestProjectInput,
   type RestProjectPatch,
+  type RestProjectRules,
+  type RestRules,
+  type RestRulesInput,
   type RestRun,
   type RestSkills,
   type RestTask,
@@ -83,6 +90,12 @@ export interface ConsoleActions {
   createCategory(input: RestCategoryInput): Promise<RestCategory>;
   updateCategory(key: string, patch: RestCategoryPatch): Promise<RestCategory>;
   removeCategory(key: string): Promise<void>;
+  /** The workspace's rules (ADR-0023), read when the page asks; written and put away by an administrator. */
+  rules(signal?: AbortSignal): Promise<RestRules>;
+  writeRules(input: RestRulesInput): Promise<RestRules>;
+  archiveRules(): Promise<RestRules>;
+  /** The rules that hold in the project the page is on: the workspace's, and what the project adds. */
+  projectRules(signal?: AbortSignal): Promise<RestProjectRules>;
   /** A folder's pages and folders, or the pages a search finds, in the project the page is on. */
   documents(filter?: DocumentFilter, signal?: AbortSignal): Promise<RestDocuments>;
   document(path: string, signal?: AbortSignal): Promise<RestDocument>;
@@ -92,8 +105,12 @@ export interface ConsoleActions {
   documentVersions(path: string, signal?: AbortSignal): Promise<RestVersions>;
   documentVersion(path: string, number: number, signal?: AbortSignal): Promise<RestVersion>;
   attachDocumentFile(path: string, input: FileUpload): Promise<RestDocument>;
-  /** Changes what a person is; for an administrator. */
+  /** Changes what a person is, or whether they are in; for an administrator. */
   updatePerson(id: string, patch: RestPersonPatch): Promise<RestPerson>;
+  /** Lets a login in (ADR-0022); for an administrator. */
+  createListing(input: RestListingInput): Promise<RestListing>;
+  /** Takes a listing away that nobody signed in with; for an administrator. */
+  removeListing(id: string): Promise<void>;
   /** Keeps the person's own choice of language (ADR-0012). */
   updateMe(patch: RestMePatch): Promise<RestMe>;
   /** Marks a run that will not come back as abandoned. */
@@ -107,6 +124,8 @@ export interface ConsoleActions {
   connectRequest(code: string, signal?: AbortSignal): Promise<RestConnectRequest>;
   approveConnection(code: string, input: RestTokenInput): Promise<RestConnectRequest>;
   denyConnection(code: string): Promise<void>;
+  /** Another person's plate: for an administrator, or an owner of a project they are in. */
+  personWork(personId: string, signal?: AbortSignal): Promise<RestPersonWork>;
   /** The tokens of another person, and the way to take one away: for an administrator. */
   personTokens(personId: string, signal?: AbortSignal): Promise<RestTokens>;
   revokePersonToken(personId: string, tokenId: string): Promise<void>;
@@ -122,7 +141,12 @@ export interface ConsoleData {
   readonly loaded: boolean;
   /** The projects the person may see, by name. */
   readonly projects: readonly RestProject[];
+  /** Everyone of the workspace, those in first, the deactivated last (ADR-0022). */
   readonly people: readonly RestPerson[];
+  /** The logins let in that nobody has signed in with yet. */
+  readonly listed: readonly RestListing[];
+  /** The organization at the git host that says who is in, where the deployment names one. */
+  readonly organization: RestOrganization | null;
   /** The categories tasks are sorted into, by name. */
   readonly categories: readonly RestCategory[];
   /** The tokens of whoever is signed in, newest first. */
@@ -184,6 +208,8 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
   const [loaded, setLoaded] = useState(false);
   const [projects, setProjects] = useState<readonly RestProject[]>([]);
   const [people, setPeople] = useState<readonly RestPerson[]>([]);
+  const [listed, setListed] = useState<readonly RestListing[]>([]);
+  const [organization, setOrganization] = useState<RestOrganization | null>(null);
   const [categories, setCategories] = useState<readonly RestCategory[]>([]);
   const [tokens, setTokens] = useState<readonly RestToken[]>([]);
   const [project, setProject] = useState<RestProject | undefined>(undefined);
@@ -216,6 +242,8 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
       }
       setProjects(nextProjects.items);
       setPeople(nextPeople.items);
+      setListed(nextPeople.listed);
+      setOrganization(nextPeople.organization);
       setCategories(nextCategories.items);
     },
     [client],
@@ -345,7 +373,13 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
             setSkills(answer);
           }
         })
-        .catch(() => undefined);
+        .catch(() => {
+          // No answer at all is said on the page as the deployment being out of reach,
+          // rather than waited for.
+          if (!signal.aborted) {
+            setSkills({ address: null, source: "", page: null, status: "unavailable", items: [] });
+          }
+        });
       if (typeof EventSource === "undefined") {
         return;
       }
@@ -494,6 +528,15 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
         await refreshWorkspace();
         return person;
       },
+      async createListing(input) {
+        const listing = await client.createListing(input);
+        await refreshWorkspace();
+        return listing;
+      },
+      async removeListing(id) {
+        await client.removeListing(id);
+        await refreshWorkspace();
+      },
       async updateMe(patch) {
         const answer = await client.updateMe(patch);
         setMe(answer);
@@ -526,9 +569,14 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
         await client.revokeToken(id);
         setTokens((current) => current.filter((token) => token.id !== id));
       },
+      rules: (signal) => client.rules(signal),
+      writeRules: (input) => client.writeRules(input),
+      archiveRules: () => client.archiveRules(),
+      projectRules: (signal) => scope().rules(signal),
       connectRequest: (code, signal) => client.connectRequest(code, signal),
       approveConnection: (code, input) => client.approveConnection(code, input),
       denyConnection: (code) => client.denyConnection(code),
+      personWork: (personId, signal) => client.personWork(personId, signal),
       personTokens: (personId, signal) => client.personTokens(personId, signal),
       revokePersonToken: (personId, tokenId) => client.revokePersonToken(personId, tokenId),
       async signOut() {
@@ -545,6 +593,8 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
     loaded,
     projects,
     people,
+    listed,
+    organization,
     categories,
     tokens,
     project,

package/src/dates.ts

@@ -113,6 +113,17 @@ export function weekdays(firstDay = 1): number[] {
   return Array.from({ length: 7 }, (_, index) => ((firstDay - 1 + index) % 7) + 1);
 }
 
+/** The seven days of the week `day` is in, from the day the week begins on (1 for Monday, 7 for Sunday). */
+export function weekOf(day: string, firstDay = 1): string[] {
+  const date = dateOf(day);
+  if (Number.isNaN(date.getTime())) {
+    return [];
+  }
+  const weekday = date.getDay() === 0 ? 7 : date.getDay();
+  const first = addDays(day, -((weekday - firstDay + 7) % 7));
+  return Array.from({ length: 7 }, (_, index) => addDays(first, index));
+}
+
 /** A day as people read one in a language: the month and the day, with the year when it is not this year's. */
 export function formatDay(day: string, language?: string, now: Date = new Date()): string {
   const date = dateOf(day);
@@ -126,6 +137,23 @@ export function formatDay(day: string, language?: string, now: Date = new Date()
   });
 }
 
+/** A stretch of days as people read one: from a day to a day, with the year. */
+export function formatDays(from: string, to: string, language?: string): string {
+  const start = dateOf(from);
+  const end = dateOf(to);
+  if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime())) {
+    return `${from} - ${to}`;
+  }
+  const format = new Intl.DateTimeFormat(language, {
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+  });
+  return typeof format.formatRange === "function"
+    ? format.formatRange(start, end)
+    : `${format.format(start)} - ${format.format(end)}`;
+}
+
 /** A month as people read one: the month and the year. */
 export function formatMonth(month: string, language?: string): string {
   const date = dateOf(`${month}-01`);

package/src/i18n/en.ts

@@ -2,9 +2,12 @@ import type { SignInFailure } from "../routes.js";
 import type {
   CategoryColor,
   GoalState,
+  MembershipSource,
   PersonRole,
+  PersonStatus,
   ProjectRole,
   ProjectVisibility,
+  ProviderKey,
   RunStatus,
   TaskPriority,
   TaskState,
@@ -37,6 +40,7 @@ export const en = {
       urgent: "Urgent",
     } satisfies Record<TaskPriority, string>,
     role: { admin: "Administrator", member: "Member" } satisfies Record<PersonRole, string>,
+    status: { active: "Active", deactivated: "Deactivated" } satisfies Record<PersonStatus, string>,
     projectRole: { owner: "Owner", member: "Member" } satisfies Record<ProjectRole, string>,
     visibility: {
       workspace: "Everyone of the workspace",
@@ -95,6 +99,8 @@ export const en = {
     nobody: "Nobody",
     nothing: "Nothing",
     language: "Language",
+    copy: "Copy",
+    copied: "Copied",
     showMore: (n: number, of: number) => `Show ${n} more of ${of}`,
   },
 
@@ -103,7 +109,6 @@ export const en = {
     work: "My work",
     people: "People",
     agents: "Agents",
-    categories: "Categories",
     board: "Board",
     roadmap: "Roadmap",
     calendar: "Calendar",
@@ -143,13 +148,13 @@ export const en = {
   projects: {
     title: "Projects",
     newProject: "New project",
-    lead: "A project holds its board, its documents, its skills and its people. What you may see and change is decided per project: an owner configures it, a member works on it.",
     empty: {
       title: "No projects yet",
       body: "Make the first one: what it is for, and who is in it. Or ask an owner to add you to theirs.",
     },
     list: "Projects",
     private: "Private",
+    public: "Open to everyone",
     decisionsWaiting: (n: number) => `${count(n, "decision", "decisions")} waiting`,
     form: {
       aria: "New project",
@@ -161,7 +166,11 @@ export const en = {
       descriptionPlaceholder: "What the project is for, in a sentence or two.",
       whoIsMember: "Who is a member",
       skillsAddress: "Skills address",
-      skillsAddressPlaceholder: "/gh/<owner>/<repo>, or empty for the organization's",
+      skillsAddressPlaceholder: "/gh/<owner>/<repo>",
+      skillsAddressHint: (address: string | null) =>
+        address === null
+          ? "Left empty, the project has no skills: the console names no address for the organization's."
+          : `Left empty, the organization's: ${address}`,
       symbol: "Mark",
       image: "Image",
       imageRemove: "Remove the image",
@@ -172,11 +181,6 @@ export const en = {
     members: {
       title: "Members",
       list: "Members",
-      leadWorkspace:
-        "Everyone of the workspace is a member of this project; those listed here are its owners and the people named besides.",
-      leadPrivate: "Only those listed here are in this project.",
-      leadRoles:
-        "An owner configures the project; a member works on it. A workspace administrator is an owner of every project.",
       since: "since",
       roleOf: (name: string) => `Role of ${name}`,
       addAria: "Add a member",
@@ -193,13 +197,9 @@ export const en = {
     settings: {
       title: "Settings",
       aria: "Project settings",
-      leadBefore: "The key, ",
-      leadAfter:
-        ", is what addresses and the command say, and does not change. The skills address names a repository served by SkillCDN; empty, the organization's skills are shown.",
-      onlyOwner: {
-        title: "Only an owner may change the project",
-        body: "Ask one of its owners, or a workspace administrator.",
-      },
+      edit: "Edit the project",
+      organizationsSkills: (address: string) => `The organization's: ${address}`,
+      noSkills: "None: the console names no address for the organization's.",
     },
   },
 
@@ -305,8 +305,6 @@ export const en = {
     waiting: "Waiting",
     answered: "Answered",
     record: "The record",
-    recordLead:
-      "Every decision answered, newest first: what was asked, what was chosen, by whom. Open one for its context, its rationale and what followed.",
     openRecord: "Open",
     waitingForPerson: "Waiting for a person.",
     options: "Options",
@@ -337,10 +335,8 @@ export const en = {
 
   calendar: {
     title: "Calendar",
-    lead: "The tasks on their days: planned from a start to a due day, a task lies across them; due on a day alone, it sits on it. One with no day waits at the bottom to be given one.",
     grid: "The month",
     legend: { title: "Category colours" },
-    startsOnly: "Starts that day, with no due day yet",
     previous: "The month before",
     next: "The month after",
     thisMonth: "This month",
@@ -349,9 +345,15 @@ export const en = {
     nothingOverdue: "Nothing is overdue.",
     unscheduled: "No day set",
     allScheduled: "Every open task has a day.",
+    week: {
+      title: "The week",
+      previous: "The week before",
+      next: "The week after",
+      thisWeek: "This week",
+      nothing: "Nothing is planned this week.",
+    },
     workload: {
       title: "Who has what",
-      lead: "The open tasks of each person, and what of them is late or due within the week.",
       person: "Person",
       open: "Open",
       inProgress: "In progress",
@@ -363,7 +365,6 @@ export const en = {
 
   roadmap: {
     title: "Roadmap",
-    lead: "What the project works towards: each goal with the day it is meant to be reached by, and how far its tasks are. Progress is read from the board as it stands.",
     setGoal: "Set a goal",
     setGoalAria: "Set a goal",
     editAria: "Change the goal",
@@ -402,7 +403,6 @@ export const en = {
 
   work: {
     title: "My work",
-    lead: "What is on your plate across your projects: the open tasks assigned to you, by the day they are due, and the decisions that wait for a person.",
     loading: "Loading your work",
     couldNotLoad: "Your work could not be loaded.",
     empty: {
@@ -420,8 +420,6 @@ export const en = {
 
   categories: {
     title: "Categories",
-    lead: "The kinds of work tasks are sorted into, the same in every project. A task carries one, the board is narrowed by one, and an administrator keeps the list.",
-    onlyAdmin: "An administrator adds, changes and removes them; everyone else reads them here.",
     list: "Categories",
     add: "Add a category",
     addAria: "Add a category",
@@ -429,7 +427,6 @@ export const en = {
       title: "No categories",
       body: "An administrator adds the first one here.",
     },
-    inUse: "A category tasks are sorted into cannot be removed until they are moved out of it.",
     form: {
       name: "Name",
       key: "Key",
@@ -442,6 +439,39 @@ export const en = {
     colorOf: (key: string) => `Colour of ${key}`,
   },
 
+  settings: {
+    title: "Settings",
+    categories: "Categories",
+    manageCategories: "Manage the categories",
+    skills: "Skills",
+    skillsSource: "Served by SkillCDN at",
+    skillsAddress: "The organization's skills",
+    noSkillsAddress: "No address: each project names its own, or has none.",
+    skillsFromConfiguration:
+      "Set by whoever runs the console, in its configuration: the deployment the skills are read through, and the organization's address.",
+  },
+
+  rules: {
+    title: "Rules",
+    loading: "Loading the rules",
+    reference:
+      "The console's own rules hold here until an administrator writes the organization's. They change with the console's version.",
+    writeOrganizations: "Write the organization's rules",
+    useReference: "Reset to the console's rules",
+    read: "Read the rules",
+    none: "This project adds no rules of its own; the workspace's hold.",
+    write: "Write this project's rules",
+    projectRules: "This project's rules",
+    workspaceRules: "The workspace's rules",
+    onWorkspaceSettings: "Changed on the workspace's Settings page.",
+    form: {
+      body: "Rules",
+      hint: (max: number) =>
+        `Markdown, up to ${max} characters, read by every agent before it works here: which skills to load first, where the work lives, the pages, what may be decided alone, how to report. {language} stands for the language of the person the agent works for. Nothing secret, such as a token or a password.`,
+      save: "Save the rules",
+    },
+  },
+
   feed: {
     title: "What happened",
     list: "What happened",
@@ -486,6 +516,10 @@ export const en = {
     event: {
       personJoined: () => "joined the board",
       roleChanged: (login: string, role: string) => `made ${login} ${role}`,
+      personListed: (login: string) => `added ${login}`,
+      personUnlisted: (login: string) => `took ${login} off the list`,
+      personDeactivated: (login: string) => `deactivated ${login}`,
+      personReactivated: (login: string) => `reactivated ${login}`,
       projectCreated: (project: string) => `made the project ${project}`,
       projectUpdated: (fields: string, project: string) =>
         `changed ${fields} of the project ${project}`,
@@ -543,10 +577,11 @@ export const en = {
       title: "No skills address yet",
       body: "This console has no address for the organization's skills. Whoever runs it names a repository served by SkillCDN in its configuration.",
     },
-    servedBy: "The organization's skills, served by",
+    servedBy: "Served by",
     at: "at",
-    howLoaded:
-      ". An agent loads one through its SkillCDN connection; a person reads it at its page.",
+    connect:
+      "An agent reads these through its own MCP connection to this address, which a person makes once:",
+    connectLink: "how, on the address's page at SkillCDN",
     status: {
       indexing: "SkillCDN is still indexing the repository. Look again in a moment.",
       failed: "SkillCDN could not index the repository. What it found is on the address's page.",
@@ -624,12 +659,44 @@ export const en = {
   people: {
     title: "People",
     list: "People",
-    lead: "Everyone who has signed in. An administrator configures the workspace and says what each person is; a member works in the projects they are in. What a person may do, their agents may do.",
     roleOf: (name: string) => `Role of ${name}`,
+    letIn: "Add a person",
+    letInAria: "Add a person",
+    notSignedIn: "Added, not signed in yet",
+    deactivated: "Deactivated",
+    deactivate: "Deactivate",
+    reactivate: "Reactivate",
+    leftOrganization: "Left the organization",
+    source: {
+      organization: "Of the organization",
+      domain: "Of the domain",
+      listed: "Added by an administrator",
+    } satisfies Record<MembershipSource, string>,
+    at: { gh: "at GitHub", google: "at Google" } satisfies Record<ProviderKey, string>,
+    organization: (name: string) => `The organization ${name} at GitHub says who is in.`,
+    organizationRead: "Last read",
+    organizationNotRead: "Not read yet.",
+    form: {
+      login: "Login, or address",
+      provider: "Signs in with",
+      byShape: "As the login reads",
+      hint: "A login at GitHub, or an address at Google. Whoever signs in with that account is in.",
+      submit: "Add",
+    },
+    work: "Work",
+    workOf: (name: string) => `Work of ${name}`,
+    loadingWork: "Loading the work",
+    couldNotLoadWork: "The work could not be loaded.",
+    noWork: {
+      title: (name: string) => `Nothing is assigned to ${name}`,
+      body: "An open task assigned to them, in a project you may see, shows up here.",
+    },
+    notOverseen: {
+      title: "Not yours to see",
+      body: "An administrator sees everyone's work; an owner sees the work of the people in their projects.",
+    },
     agents: "Agents",
     agentsOf: (name: string) => `Agents of ${name}`,
-    agentsLead: (name: string) =>
-      `What works here as ${name}, each with a token of its own. Disconnecting one takes its token away at once.`,
     loadingAgents: "Loading the agents",
     noAgent: "No agent is connected",
     onlyAdmin: {
@@ -642,7 +709,6 @@ export const en = {
     title: "Agents",
     makeByHand: "Make a token by hand",
     makeAria: "Make a token",
-    lead: "What works here as you: each agent you connected, with a token of its own that nobody sees. What you may do, it may do; disconnect it here when that is over. A script or a console of your own holds a token the same way, made by hand.",
     empty: {
       title: "No agent is connected yet",
       body: "Tell your agent to connect to this console, as below, and it shows up here.",
@@ -664,8 +730,6 @@ export const en = {
     fresh: {
       ready: (name: string) => `The token "${name}" is ready`,
       copyNow: "Copy it now: it is shown this once, and the console keeps only its hash.",
-      copy: "Copy",
-      copied: "Copied",
       useIt:
         "Sign the console command in with it, present it as a bearer token to the REST API, or give it to a console or a script of your own.",
       removeWhenDone: "It does not expire, so remove it here once it is no longer needed.",
@@ -677,7 +741,6 @@ export const en = {
   connect: {
     title: "Connect an agent",
     aria: "Connect",
-    lead: "Your agent showed you a code when it was told to connect to this console. Type it here, and say whether the agent may work as you.",
     codeAria: "The code",
     codeLabel: "The code your agent showed",
     continue: "Continue",
@@ -712,11 +775,9 @@ export const en = {
       title: "Connecting an agent",
       tellYourAgent: "Tell your agent, in its own chat:",
       quote: (origin: string) =>
-        `Install @skillcdn/console from npm, run console login --url ${origin}, and tell me the address and the code it shows.`,
+        `Run these two commands, and tell me the address and the code the second shows:\nnpm install -g @skillcdn/console\nconsole login --url ${origin}`,
       doesTheRest:
         "An agent that can run commands does the rest: it installs the command, connects, and shows you an address with a code.",
-      thenApprove:
-        "Open the address, signed in here, check that the page shows the same code, give the agent a name, and approve. From then on the agent works here as you, within what you may do; disconnect it on this page when that is over. The token it holds is never shown to anyone, you included.",
       byHand: "By hand, where no agent runs the command for you:",
     },
   },