@skillcdn/console 0.4.4 → 0.4.5

package/src/data.ts

@@ -44,6 +44,7 @@ import {
   type RestProjectInput,
   type RestProjectPatch,
   type RestProjectRules,
+  type RestReachedDecision,
   type RestRules,
   type RestRulesInput,
   type RestRulesPlugin,
@@ -53,6 +54,9 @@ import {
   type RestTaskInput,
   type RestTaskPatch,
   type RestTasks,
+  type RestTeam,
+  type RestTeamInput,
+  type RestTeamPatch,
   type RestToken,
   type RestTokenCreated,
   type RestTokenInput,
@@ -148,6 +152,10 @@ export interface ConsoleActions {
     },
     signal?: AbortSignal,
   ): Promise<RestMyDecisions>;
+  /** One decision wherever it is (ADR-0068), with its project and whether the person may answer it, read when the page asks. */
+  reachDecision(id: string, signal?: AbortSignal): Promise<RestReachedDecision>;
+  /** Answers a decision wherever it is, as whoever it reaches (ADR-0068). */
+  answerReachedDecision(id: string, input: RestAnswerInput): Promise<RestDecision>;
   /** The categories tasks are sorted into: kept by an administrator. */
   createCategory(input: RestCategoryInput): Promise<RestCategory>;
   updateCategory(key: string, patch: RestCategoryPatch): Promise<RestCategory>;
@@ -173,6 +181,13 @@ export interface ConsoleActions {
   createListing(input: RestListingInput): Promise<RestListing>;
   /** Takes a listing away that nobody signed in with; for an administrator. */
   removeListing(id: string): Promise<void>;
+  /** The teams (ADR-0073): made, renamed and removed, a person put in or taken out; for an administrator. */
+  createTeam(input: RestTeamInput): Promise<RestTeam>;
+  /** A team is called by its key (ADR-0074), which never changes. */
+  renameTeam(key: string, patch: RestTeamPatch): Promise<RestTeam>;
+  removeTeam(key: string): Promise<void>;
+  addTeamMember(key: string, personId: string): Promise<RestTeam>;
+  removeTeamMember(key: string, personId: string): Promise<RestTeam>;
   /** Keeps the person's language (ADR-0065) or their front page. */
   updateMe(patch: RestMePatch): Promise<RestMe>;
   /** Changes the workspace's settings (ADR-0035); for an administrator. `me` says them from then on. */
@@ -226,6 +241,8 @@ export interface ConsoleData {
   readonly people: readonly RestPerson[];
   /** The logins let in that nobody has signed in with yet. */
   readonly listed: readonly RestListing[];
+  /** The teams of the workspace (ADR-0073), by name, each with the members the person may see. */
+  readonly teams: readonly RestTeam[];
   /** 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. */
@@ -364,6 +381,7 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
   const [projects, setProjects] = useState<readonly RestProject[]>([]);
   const [people, setPeople] = useState<readonly RestPerson[]>([]);
   const [listed, setListed] = useState<readonly RestListing[]>([]);
+  const [teams, setTeams] = useState<readonly RestTeam[]>([]);
   const [organization, setOrganization] = useState<RestOrganization | null>(null);
   const [categories, setCategories] = useState<readonly RestCategory[]>([]);
   const [plugins, setPlugins] = useState<readonly RestPlugin[]>([]);
@@ -403,12 +421,14 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
   /** Loads the workspace's lists again. What fails stays as it was. */
   const refreshWorkspace = useCallback(
     async (signal?: AbortSignal) => {
-      const [nextProjects, nextPeople, nextCategories, nextPlugins] = await Promise.all([
+      const [nextProjects, nextPeople, nextCategories, nextPlugins, nextTeams] = await Promise.all([
         client.projects(signal),
         client.people(signal),
         client.categories(signal),
         // A console without plugins answers none; one older than them answers nothing, which is none too.
         client.plugins(signal).catch(() => ({ items: [], sql: false })),
+        // A console older than teams (ADR-0073) answers nothing, which is no team.
+        client.teams(signal).catch(() => ({ items: [] })),
       ]);
       if (signal?.aborted === true) {
         return;
@@ -416,6 +436,7 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
       setProjects(nextProjects.items);
       setPeople(nextPeople.items);
       setListed(nextPeople.listed);
+      setTeams(nextTeams.items);
       setOrganization(nextPeople.organization);
       setCategories(nextCategories.items);
       setPlugins(nextPlugins.items);
@@ -744,6 +765,12 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
       },
       work: (signal) => client.work(signal),
       myDecisions: (filter, signal) => client.myDecisions(filter, signal),
+      reachDecision: (id, signal) => client.decision(id, signal),
+      async answerReachedDecision(id, input) {
+        const decision = await client.answerDecision(id, input);
+        await refreshMe().catch(() => undefined);
+        return decision;
+      },
       async createCategory(input) {
         const category = await client.createCategory(input);
         setCategories((await client.categories()).items);
@@ -781,6 +808,30 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
         await client.removeListing(id);
         await refreshWorkspace();
       },
+      async createTeam(input) {
+        const team = await client.createTeam(input);
+        await refreshWorkspace();
+        return team;
+      },
+      async renameTeam(key, patch) {
+        const team = await client.renameTeam(key, patch);
+        await refreshWorkspace();
+        return team;
+      },
+      async removeTeam(key) {
+        await client.removeTeam(key);
+        await refreshWorkspace();
+      },
+      async addTeamMember(key, personId) {
+        const team = await client.addTeamMember(key, personId);
+        await refreshWorkspace();
+        return team;
+      },
+      async removeTeamMember(key, personId) {
+        const team = await client.removeTeamMember(key, personId);
+        await refreshWorkspace();
+        return team;
+      },
       async updateMe(patch) {
         const answer = await client.updateMe(patch);
         setMe(answer);
@@ -873,6 +924,7 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
     projects,
     people,
     listed,
+    teams,
     organization,
     categories,
     plugins,

package/src/i18n/en.ts

@@ -207,6 +207,14 @@ export const en = {
     "member.open_project": "The project is open to the workspace, so everyone is already a member.",
     "mount.ref_not_found": "That version of the pack was not found.",
     "mount.repo_not_found": "The pack was not found.",
+    "person.email_taken": "That address is another person's in this workspace.",
+    "team.not_found": "The team was not found.",
+    "team.name_taken": "A team of that name is there already.",
+    "team.key_taken": "A team or a project of that key is there already.",
+    "team.invalid_name": "A team's name is one line of words.",
+    "team.too_many": "The workspace holds as many teams as one may.",
+    "team.invalid_member": "Only an active person of the workspace is put in a team.",
+    "team.not_a_member": "The person is not in the team.",
     "person.invalid_manager":
       "A manager must be another active person, and not one of this person's own team.",
     "person.last_admin": "The workspace needs at least one administrator.",
@@ -229,7 +237,7 @@ export const en = {
     "plugin.unavailable": "The plugin can't be reached right now.",
     "project.invalid_address": "That is not the address of a pack.",
     "project.invalid_icon": "That file can't be used as the project's image.",
-    "project.key_taken": "A project with this key already exists.",
+    "project.key_taken": "A project or a team with this key already exists.",
     "project.no_icon": "The project has no image.",
     "project.not_found": "The project was not found.",
     "project.pack_connect_refused": "SkillCDN refused the connection.",
@@ -324,6 +332,10 @@ export const en = {
       projectsSome: "Some projects",
       settingsForm: "Settings",
       secretSet: (when: string) => `Set ${when}`,
+      secretSealedFrom: (host: string, when: string) => `Received from ${host} ${when}`,
+      secretExpires: (when: string) => `expires ${when}`,
+      secretExpired: (when: string) => `expired ${when}`,
+      secretHosts: (hosts: string) => `Sent to ${hosts} only.`,
       secretUnset: "Not set",
       secretNew: "New value",
       enable: "Enable",
@@ -332,11 +344,24 @@ export const en = {
       rolesNone: "No roles: every member may use it.",
       roleDefault: "Default",
       everyMember: "Every member",
+      roleManagers: "Reporting line",
+      whoeverManages: "Whoever someone reports to",
       grantEveryone: "Everyone",
       grantMembersOf: (project: string) => `Members of ${project}`,
       grantPeople: "People",
       grantProjects: "Members of a project",
       grantWhom: "Grant to…",
+      grantPlugins: "Plugins",
+      grantTeams: "Teams",
+      grantTeam: (team: string) => `The team ${team}`,
+      grantPlugin: (plugin: string) => `The plugin ${plugin}`,
+      asks: "Roles asked of other plugins",
+      asksHint:
+        "Roles of other plugins this plugin asks to hold, to act as itself in them; each is an administrator's to grant, here or when enabling.",
+      askGranted: "Granted",
+      askUngranted: "Not granted",
+      askUnavailable: (plugin: string) => `${plugin} is not enabled; grant it here once it is.`,
+      askGrantNow: "Grant it now",
       grant: "Grant",
       revoke: "Revoke",
       events: "What happened",
@@ -356,9 +381,16 @@ export const en = {
       console: "Console versions",
       consoleRange: (range: string) => `console ${range}`,
       timeZoneHint: "In the workspace's time zone.",
+      keeps: "Kept for",
+      keepsFor: (collection: string, days: number) =>
+        `${collection}: ${days} ${days === 1 ? "day" : "days"}, then removed`,
+      needsTimeZone:
+        "The workspace has no time zone, so this plugin's times of day run on UTC until one is set.",
+      setTimeZone: "Set the time zone",
       addItem: "Add",
       itemPlaceholder: "Type, then add",
       choose: "Choose…",
+      addOne: "Add…",
     },
     /** What stands in for a frame the console has nothing to show in. */
     frameUnavailable: "This can't be shown right now.",
@@ -373,6 +405,16 @@ export const en = {
         name: "Everyone",
         opens: "Reads everyone in the workspace, from its jobs and hooks too.",
       },
+      "people:read:email": {
+        name: "Work email",
+        opens:
+          "Reads the work email of the people it may read, to match them to accounts elsewhere.",
+      },
+      "people:act": {
+        name: "Acting for a person",
+        opens:
+          "Runs a command and answers a decision for a person who did it elsewhere, within what they may do, recorded as theirs through the plugin.",
+      },
       "projects:read": {
         name: "Projects",
         opens: "Reads the projects and members the person may see.",
@@ -941,8 +983,13 @@ export const en = {
     console: "The console",
     as: (agent: string) => `as ${agent}`,
     asTitle: "The agent the person acted through",
+    via: (plugin: string) => `through ${plugin}`,
+    viaTitle: "The plugin that acted for the person",
+    thePlugin: (plugin: string) => `the plugin ${plugin}`,
     aTask: "a task",
     aPlugin: "a plugin",
+    aTeam: "a team",
+    theTeam: (team: string) => `the team ${team}`,
     /** After the sentence of a board's event a plugin caused (ADR-0052). */
     throughPlugin: (plugin: string) => `through the plugin ${plugin}`,
     everyone: "everyone",
@@ -1000,6 +1047,13 @@ export const en = {
       personReactivated: (login: string) => `reactivated ${login}`,
       managerChanged: (login: string, manager: string) => `set ${login}'s manager to ${manager}`,
       managerCleared: (login: string) => `cleared ${login}'s manager`,
+      emailChanged: (login: string) => `changed ${login}'s work email`,
+      emailCleared: (login: string) => `cleared ${login}'s work email`,
+      teamCreated: (team: string) => `made the team ${team}`,
+      teamRenamed: (from: string, team: string) => `renamed the team ${from} to ${team}`,
+      teamRemoved: (team: string) => `deleted the team ${team}`,
+      teamMemberAdded: (login: string, team: string) => `put ${login} in the team ${team}`,
+      teamMemberRemoved: (login: string, team: string) => `took ${login} out of the team ${team}`,
       projectCreated: (project: string) => `made the project ${project}`,
       projectUpdated: (fields: string, project: string) =>
         `changed ${fields} of the project ${project}`,
@@ -1045,6 +1099,8 @@ export const en = {
       pluginConsented: (plugin: string) => `changed the capabilities of the plugin ${plugin}`,
       pluginConfigured: (fields: string, plugin: string) =>
         `changed ${fields} of the plugin ${plugin}`,
+      pluginSealed: (fields: string, plugin: string, host: string) =>
+        `stored ${fields} of the plugin ${plugin}, received from ${host}`,
       pluginGranted: (role: string, who: string, plugin: string) =>
         `gave ${who} the role ${role} in the plugin ${plugin}`,
       pluginRevoked: (role: string, who: string, plugin: string) =>
@@ -1238,7 +1294,17 @@ export const en = {
     role: "Role",
     manager: "Manager",
     managerOf: (name: string) => `Manager of ${name}`,
-    team: "Team",
+    email: "Work email",
+    emailOf: (name: string) => `Work email of ${name}`,
+    emailHint:
+      "Google's at sign-in; written here otherwise. Read by an administrator, the person, and a plugin allowed to.",
+    team: "Direct reports",
+    teams: "Teams",
+    joinTeam: "Add to a team…",
+    joinTeamOf: (name: string) => `Add ${name} to a team`,
+    leaveTeam: (name: string, team: string) => `Take ${name} out of ${team}`,
+    howMany: (count: number) => (count === 1 ? "1 person" : `${count} people`),
+    views: { aria: "People and teams", people: "People", teams: "Teams" },
     nobody: "None",
     letIn: "Add a person",
     letInAria: "Add a person",
@@ -1289,6 +1355,36 @@ export const en = {
     },
   },
 
+  /** The teams of the workspace (ADR-0073), a view of the people page of their own. */
+  teams: {
+    list: "Teams",
+    none: {
+      title: "No teams yet",
+      body: "A team puts people under one name: a plugin finds them by it, and a role of a plugin granted to the team is held by everyone in it.",
+    },
+    members: (count: number) => (count === 1 ? "1 member" : `${count} members`),
+    nobody: "Nobody in it yet.",
+    nameOf: (team: string) => `Name of the team ${team}`,
+    keyTitle:
+      "The team's key: what a grant, a plugin and the command call it by. It never changes.",
+    addMember: "Add a person…",
+    addMemberTo: (team: string) => `Add a person to ${team}`,
+    removeMember: (name: string, team: string) => `Take ${name} out of ${team}`,
+    remove: "Delete team",
+    removeAsk: (team: string) =>
+      `Delete the team ${team}? The roles of plugins granted to it go with it; its people stay.`,
+    newTeam: "New team",
+    newAria: "New team",
+    form: {
+      name: "Team name",
+      key: "Key",
+      keyHint:
+        "Lowercase letters, digits and hyphens: what a grant, a plugin and the command call the team by. No other team and no project has it, and it never changes.",
+      hint: "The name is what people read, and can change; the key stays. People are added on the team's card once it is made.",
+      submit: "Make the team",
+    },
+  },
+
   agents: {
     title: "Agents",
     makeByHand: "Make a token by hand",

package/src/i18n/ko.ts

@@ -163,6 +163,14 @@ export const ko: Messages = {
     "member.open_project": "공개 프로젝트라서 워크스페이스의 모든 사람이 이미 멤버입니다.",
     "mount.ref_not_found": "팩의 그 버전을 찾을 수 없습니다.",
     "mount.repo_not_found": "팩을 찾을 수 없습니다.",
+    "person.email_taken": "이 워크스페이스의 다른 사람이 쓰는 주소입니다.",
+    "team.not_found": "팀을 찾을 수 없습니다.",
+    "team.name_taken": "같은 이름의 팀이 이미 있습니다.",
+    "team.key_taken": "같은 키의 팀이나 프로젝트가 이미 있습니다.",
+    "team.invalid_name": "팀 이름은 한 줄의 글자여야 합니다.",
+    "team.too_many": "워크스페이스가 가질 수 있는 만큼의 팀이 이미 있습니다.",
+    "team.invalid_member": "활성 상태인 워크스페이스의 사람만 팀에 넣을 수 있습니다.",
+    "team.not_a_member": "그 사람은 이 팀에 없습니다.",
     "person.invalid_manager": "본인, 본인의 팀원, 비활성화된 사람은 매니저로 지정할 수 없습니다.",
     "person.last_admin": "관리자가 한 명은 있어야 합니다.",
     "person.not_found": "사람을 찾을 수 없습니다.",
@@ -185,7 +193,7 @@ export const ko: Messages = {
     "plugin.unavailable": "지금은 플러그인을 쓸 수 없습니다.",
     "project.invalid_address": "팩 주소가 아닙니다.",
     "project.invalid_icon": "프로젝트 이미지로 쓸 수 없는 파일입니다.",
-    "project.key_taken": "같은 키의 프로젝트가 이미 있습니다.",
+    "project.key_taken": "같은 키의 프로젝트나 팀이 이미 있습니다.",
     "project.no_icon": "프로젝트에 이미지가 없습니다.",
     "project.not_found": "프로젝트를 찾을 수 없습니다.",
     "project.pack_connect_refused": "SkillCDN이 연결을 거부했습니다.",
@@ -279,6 +287,10 @@ export const ko: Messages = {
       projectsSome: "일부 프로젝트",
       settingsForm: "설정",
       secretSet: (when) => `${when} 설정됨`,
+      secretSealedFrom: (host, when) => `${when} ${host}에서 받아 저장됨`,
+      secretExpires: (when) => `${when} 만료 예정`,
+      secretExpired: (when) => `${when} 만료됨`,
+      secretHosts: (hosts) => `${hosts}에만 보냅니다.`,
       secretUnset: "설정 안 됨",
       secretNew: "새 값",
       enable: "활성화",
@@ -287,11 +299,24 @@ export const ko: Messages = {
       rolesNone: "역할이 없어 모든 멤버가 쓸 수 있습니다.",
       roleDefault: "기본",
       everyMember: "모든 멤버",
+      roleManagers: "보고 라인",
+      whoeverManages: "누군가의 매니저인 사람",
       grantEveryone: "모두",
       grantMembersOf: (project) => `${project}의 멤버`,
       grantPeople: "사람",
       grantProjects: "프로젝트의 멤버",
       grantWhom: "부여할 대상…",
+      grantPlugins: "플러그인",
+      grantTeams: "팀",
+      grantTeam: (team) => `팀 ${team}`,
+      grantPlugin: (plugin) => `플러그인 ${plugin}`,
+      asks: "다른 플러그인에 요청한 역할",
+      asksHint:
+        "이 플러그인이 다른 플러그인에서 자기 이름으로 쓰려고 요청한 역할입니다. 관리자가 여기서, 또는 켤 때 부여합니다.",
+      askGranted: "부여됨",
+      askUngranted: "부여되지 않음",
+      askUnavailable: (plugin) => `${plugin}이(가) 꺼져 있습니다. 켜진 뒤 여기서 부여하세요.`,
+      askGrantNow: "지금 부여",
       grant: "부여",
       revoke: "회수",
       events: "일어난 일",
@@ -310,9 +335,15 @@ export const ko: Messages = {
       console: "콘솔 버전",
       consoleRange: (range) => `콘솔 ${range}`,
       timeZoneHint: "워크스페이스 시간대 기준입니다.",
+      keeps: "보관 기간",
+      keepsFor: (collection, days) => `${collection}: ${days}일이 지나면 삭제`,
+      needsTimeZone:
+        "워크스페이스에 시간대가 없어서, 시간대를 정하기 전까지 이 플러그인의 시각은 UTC 기준으로 실행됩니다.",
+      setTimeZone: "시간대 정하기",
       addItem: "추가",
       itemPlaceholder: "입력한 뒤 추가",
       choose: "선택…",
+      addOne: "추가…",
     },
     frameUnavailable: "지금은 표시할 수 없습니다.",
     capability: {
@@ -322,6 +353,15 @@ export const ko: Messages = {
         name: "모든 사람 읽기",
         opens: "워크스페이스의 모든 사람을 읽습니다. 예약 실행과 훅에서도.",
       },
+      "people:read:email": {
+        name: "업무 이메일",
+        opens: "읽을 수 있는 사람의 업무 이메일을 읽습니다. 다른 서비스의 계정과 맞추는 데 씁니다.",
+      },
+      "people:act": {
+        name: "사람 대신 실행",
+        opens:
+          "다른 곳에서 한 일을 그 사람 대신 실행하고 결정에 답합니다. 그 사람이 할 수 있는 범위 안에서, 플러그인을 거친 것으로 기록됩니다.",
+      },
       "projects:read": {
         name: "프로젝트 읽기",
         opens: "보는 사람이 볼 수 있는 프로젝트와 멤버를 읽습니다.",
@@ -516,7 +556,7 @@ export const ko: Messages = {
     filters: {
       aria: "보드 좁혀 보기",
       words: "제목, 번호, 사람",
-      everyone: "모두",
+      everyone: "모든 사람",
       mine: "내 작업",
       anyCategory: "모든 카테고리",
       noCategory: "카테고리 없음",
@@ -874,8 +914,13 @@ export const ko: Messages = {
     console: "콘솔",
     as: (agent) => `${agent}(으)로`,
     asTitle: "그 사람이 사용한 에이전트",
+    via: (plugin) => `${plugin} 플러그인을 통해`,
+    viaTitle: "그 사람 대신 실행한 플러그인",
+    thePlugin: (plugin) => `플러그인 ${plugin}`,
     aTask: "작업",
     aPlugin: "플러그인",
+    aTeam: "팀",
+    theTeam: (team) => `팀 ${team}`,
     throughPlugin: (plugin) => `플러그인 ${plugin}을(를) 통해`,
     everyone: "모든 구성원",
     membersOf: (project) => `${project}의 구성원`,
@@ -932,6 +977,13 @@ export const ko: Messages = {
       personReactivated: (login) => `${login}을(를) 다시 활성화했습니다`,
       managerChanged: (login, manager) => `${login}의 매니저를 ${manager}(으)로 지정했습니다`,
       managerCleared: (login) => `${login}의 매니저 지정을 해제했습니다`,
+      emailChanged: (login) => `${login}의 업무 이메일을 바꿨습니다`,
+      emailCleared: (login) => `${login}의 업무 이메일을 지웠습니다`,
+      teamCreated: (team) => `팀 ${team}을(를) 만들었습니다`,
+      teamRenamed: (from, team) => `팀 ${from}의 이름을 ${team}(으)로 바꿨습니다`,
+      teamRemoved: (team) => `팀 ${team}을(를) 삭제했습니다`,
+      teamMemberAdded: (login, team) => `${login}을(를) 팀 ${team}에 추가했습니다`,
+      teamMemberRemoved: (login, team) => `${login}을(를) 팀 ${team}에서 뺐습니다`,
       projectCreated: (project) => `프로젝트 ${project}을(를) 만들었습니다`,
       projectUpdated: (fields, project) => `프로젝트 ${project}의 ${fields}을(를) 바꿨습니다`,
       memberAdded: (login, project, role) =>
@@ -973,6 +1025,8 @@ export const ko: Messages = {
       pluginDisabled: (plugin) => `플러그인 ${plugin}을(를) 비활성화했습니다`,
       pluginConsented: (plugin) => `플러그인 ${plugin}의 권한을 바꿨습니다`,
       pluginConfigured: (fields, plugin) => `플러그인 ${plugin}의 ${fields}을(를) 바꿨습니다`,
+      pluginSealed: (fields, plugin, host) =>
+        `플러그인 ${plugin}의 ${fields}을(를) ${host}에서 받아 저장했습니다`,
       pluginGranted: (role, who, plugin) =>
         `${who}에게 플러그인 ${plugin}의 ${role} 역할을 부여했습니다`,
       pluginRevoked: (role, who, plugin) =>
@@ -1164,7 +1218,17 @@ export const ko: Messages = {
     role: "역할",
     manager: "매니저",
     managerOf: (name) => `${name}의 매니저`,
-    team: "팀원",
+    email: "업무 이메일",
+    emailOf: (name) => `${name}의 업무 이메일`,
+    emailHint:
+      "Google 로그인은 로그인 주소가 들어오고, 그 밖은 여기서 적습니다. 관리자, 본인, 권한 있는 플러그인만 읽습니다.",
+    team: "직속 구성원",
+    teams: "팀",
+    joinTeam: "팀 추가…",
+    joinTeamOf: (name) => `${name}을(를) 추가할 팀`,
+    leaveTeam: (name, team) => `${team}에서 ${name} 빼기`,
+    howMany: (count) => `${count}명`,
+    views: { aria: "사람과 팀", people: "사람", teams: "팀" },
     nobody: "없음",
     letIn: "사람 추가",
     letInAria: "사람 추가",
@@ -1213,6 +1277,34 @@ export const ko: Messages = {
     },
   },
 
+  teams: {
+    list: "팀",
+    none: {
+      title: "아직 팀이 없습니다",
+      body: "팀은 사람들을 한 이름으로 묶습니다. 플러그인은 팀 이름으로 사람을 찾고, 팀에 준 플러그인 역할은 그 팀의 모든 사람이 갖습니다.",
+    },
+    members: (count) => `${count}명`,
+    nobody: "아직 아무도 없습니다.",
+    nameOf: (team) => `팀 ${team}의 이름`,
+    keyTitle: "팀의 키: 부여, 플러그인, 명령이 팀을 부르는 이름이며 바뀌지 않습니다.",
+    addMember: "사람 추가…",
+    addMemberTo: (team) => `${team}에 추가할 사람`,
+    removeMember: (name, team) => `${team}에서 ${name} 빼기`,
+    remove: "팀 삭제",
+    removeAsk: (team) =>
+      `팀 ${team}을(를) 삭제할까요? 이 팀에 준 플러그인 역할도 함께 사라지고, 사람들은 그대로 남습니다.`,
+    newTeam: "새 팀",
+    newAria: "새 팀",
+    form: {
+      name: "팀 이름",
+      key: "키",
+      keyHint:
+        "소문자, 숫자, 하이픈. 부여, 플러그인, 명령이 팀을 부르는 이름입니다. 다른 팀이나 프로젝트와 겹칠 수 없고 바뀌지 않습니다.",
+      hint: "이름은 사람이 읽는 것이라 바꿀 수 있고, 키는 바뀌지 않습니다. 사람은 팀을 만든 뒤 팀 카드에서 추가합니다.",
+      submit: "팀 만들기",
+    },
+  },
+
   agents: {
     title: "에이전트",
     makeByHand: "토큰 직접 만들기",

package/src/index.ts

@@ -109,6 +109,10 @@ export {
   type ListingFormProps,
   PeopleList,
   type PeopleListProps,
+  TeamForm,
+  type TeamFormProps,
+  TeamList,
+  type TeamListProps,
 } from "./components/people.js";
 export {
   PICKER_PAGE_LIMIT,
@@ -178,6 +182,12 @@ export {
   type RunListProps,
   RunStatusBadge,
 } from "./components/runs.js";
+export {
+  goalsSearch,
+  listSearch,
+  peopleSearch,
+  projectsSearch,
+} from "./components/searches.js";
 export {
   type Brand,
   isPlainClick,
@@ -212,6 +222,7 @@ export {
   Button,
   Callout,
   CategoryBadge,
+  Chip,
   CopyButton,
   cx,
   Day,

package/src/limits.ts

@@ -48,6 +48,12 @@ export const MAX_FILE_NAME_LENGTH = 200;
 export const MAX_TOKEN_NAME_LENGTH = 80;
 /** A login at a git host, or an address at a Workspace, as an administrator lists one. */
 export const MAX_LOGIN_LENGTH = 254;
+/** A team's name (ADR-0073). */
+export const MAX_TEAM_NAME_LENGTH = 60;
+/** A team's key (ADR-0074), as long as a project's may be: the two are one set of names. */
+export const MAX_TEAM_KEY_LENGTH = 40;
+/** How many teams one workspace may hold. */
+export const MAX_TEAMS = 200;
 /** How long a token may be good for, in days, and how long one is when nothing is said. */
 export const MAX_TOKEN_DAYS = 365;
 export const DEFAULT_TOKEN_DAYS = 90;

package/src/plugin/args.ts

@@ -4,7 +4,7 @@
 // crosses from the plugin's thread to the console is exactly that object.
 import { PluginDefinitionError } from "./definition-error.js";
 import { MAX_PLUGIN_ABOUT_LENGTH, MAX_PLUGIN_OPTIONS } from "./limits.js";
-import { PLUGIN_KEY_PATTERN } from "./manifest.js";
+import { isCalendarDay, PLUGIN_KEY_PATTERN } from "./manifest.js";
 
 export const ARG_TYPES = [
   "text",
@@ -269,7 +269,6 @@ export const arg = {
   },
 };
 
-const DAY = /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])$/;
 const DEFAULT_TEXT_MAX = 2000;
 const DEFAULT_MARKDOWN_MAX = 20_000;
 const DEFAULT_LIST_MAX = 100;
@@ -304,9 +303,8 @@ export function argProblem(
       return undefined;
     }
     case "day":
-      return typeof value === "string" && DAY.test(value)
-        ? undefined
-        : `${name} is not a day as YYYY-MM-DD`;
+      // The shape, and the calendar: February 30 fits the shape and is no day.
+      return isCalendarDay(value) ? undefined : `${name} is not a day as YYYY-MM-DD`;
     case "number": {
       if (typeof value !== "number" || !Number.isFinite(value)) {
         return `${name} is not a number`;
@@ -512,15 +510,22 @@ export function parseArgv(
   return { values };
 }
 
-/** The usage of an argument, as help prints it: `<from>` for a positional, `--to <day>` for a flag, in brackets where optional. */
+/**
+ * The usage of an argument, as help prints it: `<from>` for a positional, `--to <day>` for a
+ * flag, in brackets where optional; a file as `--file <path>`, the flag the command itself takes,
+ * since the command uploads the file first and hands the plugin a handle, never a flag of the
+ * argument's name.
+ */
 export function argUsage(name: string, description: ArgDescription): string {
   const placeholder =
     description.type === "list" ? `${description.of?.type ?? "item"},...` : description.type;
   const form =
-    description.type === "boolean" && !description.positional
-      ? `--${name}`
-      : description.positional
-        ? `<${name}>`
-        : `--${name} <${placeholder}>`;
+    description.type === "file"
+      ? "--file <path>"
+      : description.type === "boolean" && !description.positional
+        ? `--${name}`
+        : description.positional
+          ? `<${name}>`
+          : `--${name} <${placeholder}>`;
   return description.optional ? `[${form}]` : form;
 }