@arbidocs/cli 0.4.83 → 0.4.85

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## v0.4.85
+
+[compare changes](https://github.com/arbicity/ARBI-frontend/compare/v0.4.83...HEAD)
+
+### 🚀 Enhancements
+
+- **cli:** Tag kinds in arbi tags create, list, show and matrix ([6c7331ee9](https://github.com/arbicity/ARBI-frontend/commit/6c7331ee9))
+- **blocks:** Mail kit (ConnectedMailbox, ConnectedMailComposer) shared by the app and hosts ([3c854536e](https://github.com/arbicity/ARBI-frontend/commit/3c854536e))
+- **tags:** Flat issues with per-kind fields; the tag list is the table ([2194bb4d0](https://github.com/arbicity/ARBI-frontend/commit/2194bb4d0))
+
+### 🩹 Fixes
+
+- **recording:** Overlay video captions in the lower half of the frame ([1ea3d58bc](https://github.com/arbicity/ARBI-frontend/commit/1ea3d58bc))
+- **tags:** An issue in a list shows its evidence, not an empty rows table ([34e71de7b](https://github.com/arbicity/ARBI-frontend/commit/34e71de7b))
+- **personas:** Overlay think-aloud captions in the lower half of the frame ([7b22e8609](https://github.com/arbicity/ARBI-frontend/commit/7b22e8609))
+- **blocks:** Start AI-first workflow runs and never skip a failed step by default ([#1572](https://github.com/arbicity/ARBI-frontend/pull/1572))
+- **client:** Type the password-change calls against the current schema ([498b0d1da](https://github.com/arbicity/ARBI-frontend/commit/498b0d1da))
+
+### 💅 Refactors
+
+- **tags:** Stop sending kind_to_children ([c9bac43a9](https://github.com/arbicity/ARBI-frontend/commit/c9bac43a9))
+
+### 🏡 Chore
+
+- Update OpenAPI schema ([f2437789f](https://github.com/arbicity/ARBI-frontend/commit/f2437789f))
+- Measure only the markdown chunk in its size budget ([48a4aeda8](https://github.com/arbicity/ARBI-frontend/commit/48a4aeda8))
+
+### ✅ Tests
+
+- **tags:** An issue in a list shows no rows table ([5e629e1a7](https://github.com/arbicity/ARBI-frontend/commit/5e629e1a7))
+
+### 🤖 CI
+
+- Run the full @arbidocs/blocks unit suite in the Test job ([c6fcbabd0](https://github.com/arbicity/ARBI-frontend/commit/c6fcbabd0))
+- Move the blocks suite to its own path-filtered job ([a97af75bd](https://github.com/arbicity/ARBI-frontend/commit/a97af75bd))
+
 ## v0.4.83
 
 [compare changes](https://github.com/arbicity/ARBI-frontend/compare/v0.4.81...HEAD)

package/SKILL.md

@@ -61,7 +61,7 @@ Scripting notes:
 
 ## For Automations / AI Agents
 
-- **Structured output (`--json`)**: supported on `status`, `config show`, `health`, `models`, `workspaces`, `workspace users`, `workspace current`, `docs`, `convo` (or `convo list`), `tags` (or `tags list`), `contacts` (or `contacts list`), `find`, `settings get`, `task list` / `task status` / `task result`, `agent list`, `session list`, `dm list`, `notifications list`, `local ls` / `local find` / `local cat` / `local tree`, `update --check`, `register --non-interactive`, `ask -b`, `upload`, `watch`, `workflow list` / `create` / `run` / `update`, `run start` / `run steps` / `run step`, `tags create` / `tags fields` / `tags matrix`, `project set` / `show` / `events`, `usage conversation` / `usage project`. Use it whenever parsing output. `docs` also supports `--csv`, `--ids`, and `--count`. `arbi ask --json` without `-b` errors out — streaming mode is prose, not JSON; pass `-b` to get a background task ID, then `arbi task result --json`.
+- **Structured output (`--json`)**: supported on `status`, `config show`, `health`, `models`, `workspaces`, `workspace users`, `workspace current`, `docs`, `convo` (or `convo list`), `tags` (or `tags list`), `tags show`, `contacts` (or `contacts list`), `find`, `settings get`, `task list` / `task status` / `task result`, `agent list`, `session list`, `dm list`, `notifications list`, `local ls` / `local find` / `local cat` / `local tree`, `update --check`, `register --non-interactive`, `ask -b`, `upload`, `watch`, `workflow list` / `create` / `run` / `update`, `run start` / `run steps` / `run step`, `tags create` / `tags fields` / `tags list --links`, `tag-kinds list` / `show` / `set-fields`, `project set` / `show` / `events`, `usage conversation` / `usage project`. Use it whenever parsing output. `docs` also supports `--csv`, `--ids`, and `--count`. `arbi ask --json` without `-b` errors out — streaming mode is prose, not JSON; pass `-b` to get a background task ID, then `arbi task result --json`.
 - **Human table output is lossy**: table rows may contain status glyphs (`●`, `🟩`, etc.) and emoji, and column widths truncate content. Never parse tables — always pass `--json`.
 - **Exit codes**:
   - `0` success
@@ -95,8 +95,10 @@ All document list/search/meta commands support machine-readable output. Prefer `
 - **Per-doc**: `arbi doc get <id...>` returns full JSON (no flag needed). `arbi doc delete <id...>` and `arbi doc update <id> '<json>'` take IDs directly.
 - **Upload by URL**: `arbi doc upload-url <url> --json`.
 - **Download**: `arbi download <id> -o <path>` writes the file; `-o -` streams raw bytes to stdout; `--json` emits a `{doc_id, path, bytes, filename}` metadata line after writing.
-- **Tags**: `arbi tags list --json`, `arbi tags create <name> -t <type> [--parent <tag>]`, `arbi tags delete <id>`.
-- **Tag fields and the matrix**: a tag can carry typed fields (`text`, `number`, `date`, `checkbox`, `select`, `person`); a child tag inherits its parent's, so a parent's fields are the columns of its children. `arbi tags fields <tag>` shows a tag's fields and values; `--define '<json>'` (or a `.json`/`.yaml` file of `[{name, type, options}]`) sets its own fields (a field defined again by name keeps its values; ones left out are dropped unless `--keep-others`); `--set name=value` (repeatable, `name=` clears) sets values, checked against the fields and a select's options. `arbi tags matrix --parent <tag>` (or `--tag <tag>` repeated) prints rows = tags, columns = fields, then DOCS and FACTS counts, gaps marked `—` and listed; `--json` adds each row's newest documents and facts (`--links <n>`). Tags are taken by id or unique name.
+- **Tags**: `arbi tags list [--kind <kind>] [--parent <tag>] [--links [n]] --json`, `arbi tags show <tag> [--json]`, `arbi tags create <name> -t <type> [--kind <kind>] [--parent <tag>] [--set name=value]`, `arbi tags delete <id>`.
+- **Tag kinds**: every tag has a `kind`: `label`, `annotation`, `search`, `issue`, `person` or `organisation` (shown in the KIND column of `tags list`, in `tags show`, and as `kind` in `--json`). `tags create --kind issue` makes an issue (without `--kind`: from the type, checkbox → label; never from a parent); `tags list --kind <kind>` filters by it; an unknown kind is refused with the list of kinds. Issues, people and organisations are flat: no `--parent` (refused), and nothing nests under one. Parents are for label hierarchies (`tags list --parent <tag>` lists a label's children).
+- **Kind fields (the columns)**: each kind has one field list per workspace (its issue fields, its person fields …; types `text`, `number`, `date`, `checkbox`, `select`, `person`); each tag holds its own values. `arbi tag-kinds [list] [--json]` shows every kind's fields, `arbi tag-kinds show <kind>` one kind's (people and organisations start with built-in Position, Organisation, Role, Comment / Role, Comment). `arbi tag-kinds set-fields <kind> '<json>'` (or a `.json`/`.yaml` file of `[{name, type, options}]`) sets them in full: a field named again (any case) keeps its id and values, a type cannot change, ones left out are removed unless `--keep-others`.
+- **Values and the table**: `arbi tags fields <tag>` shows a tag's values for its kind's fields; `--set name=value` (repeatable, `name=` clears) sets them, checked against the kind's fields and a select's options (`tags create … --set` too). `arbi tags list --kind issue --links` prints the table: a row per tag, the kind's fields as columns, then DOCS, FACTS and THREADS counts, gaps marked `—` and listed; with `--json` each tag carries `field_values` and `links` (its newest documents with notes, facts and threads, up to `--links <n>`, default 50, plus the counts). Tags are taken by id or unique name.
 - **Doctags** (tag↔doc link): `arbi doctags create <tag-id> <doc-id...>` / `arbi doctags delete <tag-id> <doc-id...>`.
 - **Retrieve only**: `arbi find <query> --json` returns raw retrieval results without running the LLM.
 - **Exit codes**: 0 on success (including clean skips), 1 on error. Errors print to stderr.

package/dist/index.js

@@ -3695,7 +3695,7 @@ function getLatestVersion(skipCache = false) {
   }
 }
 function getCurrentVersion() {
-  return "0.4.83";
+  return "0.4.85";
 }
 function readChangelog(fromVersion, toVersion) {
   try {
@@ -3748,17 +3748,17 @@ function showChangelog(fromVersion, toVersion) {
 async function checkForUpdates(autoUpdate) {
   try {
     const latest = getLatestVersion();
-    if (!latest || latest === "0.4.83") return;
+    if (!latest || latest === "0.4.85") return;
     if (autoUpdate) {
       warn(`
-Your arbi version is out of date (${"0.4.83"} \u2192 ${latest}). Updating...`);
+Your arbi version is out of date (${"0.4.85"} \u2192 ${latest}). Updating...`);
       child_process.execSync("npm install -g @arbidocs/cli@latest", { stdio: "inherit" });
-      showChangelog("0.4.83", latest);
+      showChangelog("0.4.85", latest);
       console.log(`Updated to ${latest}.`);
     } else {
       warn(
         `
-Your arbi version is out of date (${"0.4.83"} \u2192 ${latest}).
+Your arbi version is out of date (${"0.4.85"} \u2192 ${latest}).
 Run "arbi update" to upgrade, or "arbi update auto" to always stay up to date.`
       );
     }
@@ -3790,10 +3790,10 @@ function markNagShown(latest) {
 function hintUpdateOnError() {
   try {
     const cached = readCache();
-    if (!cached || cached.latest === "0.4.83") return;
+    if (!cached || cached.latest === "0.4.85") return;
     if (!shouldShowNag(cached.latest)) return;
     warn(
-      `Your arbi version is out of date (${"0.4.83"} \u2192 ${cached.latest}). Run "arbi update".`
+      `Your arbi version is out of date (${"0.4.85"} \u2192 ${cached.latest}). Run "arbi update".`
     );
     markNagShown(cached.latest);
   } catch {
@@ -8519,16 +8519,16 @@ function parseFieldDefinitions(arg) {
     try {
       value = JSON.parse(trimmed);
     } catch (err) {
-      throw new Error(`--define is not valid JSON: ${err.message}`);
+      throw new Error(`Fields are not valid JSON: ${err.message}`);
     }
   } else if (fs7.existsSync(arg)) value = readStructured(arg);
   else
     throw new Error(
-      `--define takes JSON (e.g. '[{"name":"budget","type":"number"}]') or a .json/.yaml file; no file "${arg}"`
+      `Fields are JSON (e.g. '[{"name":"Status","type":"text"}]') or a .json/.yaml file; no file "${arg}"`
     );
   const list = isRecord(value) ? value.fields : value;
   if (!Array.isArray(list))
-    throw new Error('--define: expected a list of fields, or an object with a "fields" list');
+    throw new Error('Fields: expected a list of fields, or an object with a "fields" list');
   const problems = [];
   const names = /* @__PURE__ */ new Set();
   const out = list.map((raw, i) => {
@@ -8580,7 +8580,7 @@ function parseFieldValues(pairs, fields) {
     const field = fields.find((f) => f.name.toLowerCase() === name.toLowerCase() || f.id === name);
     if (!field)
       throw new Error(
-        `No field "${name}" on this tag. Its fields: ${fields.map((f) => f.name).join(", ") || "(none: add some with --define)"}`
+        `No field "${name}" for this kind. Its fields: ${fields.map((f) => f.name).join(", ") || "(none: add some with arbi tag-kinds set-fields)"}`
       );
     if (value.trim() === "") out[field.name] = null;
     else if (field.type === "select" && field.options?.length) {
@@ -8598,35 +8598,36 @@ function formatFieldValue(value) {
   if (typeof value === "object") return JSON.stringify(value);
   return String(value);
 }
-function fieldRows(tag) {
-  return (tag.fields ?? []).map((f) => ({
+var fieldType = (f) => f.type === "select" && f.options?.length ? `select: ${f.options.join("|")}` : f.type;
+function fieldRows(tag, fields) {
+  return fields.map((f) => ({
     id: f.id,
     name: f.name,
-    type: f.type === "select" && f.options?.length ? `select: ${f.options.join("|")}` : f.type,
-    value: formatFieldValue(tag.field_values?.[f.id]),
-    from: f.tag_ext_id === tag.external_id ? "own" : `inherited (${f.tag_ext_id})`
+    type: fieldType(f),
+    value: formatFieldValue(tag.field_values?.[f.id])
   }));
 }
-function matrixTable(matrix) {
-  const columns = sdk.tags.tagMatrixColumns(matrix);
-  const headers = ["TAG", ...columns.map((c) => c.name.toUpperCase()), "DOCS", "FACTS"];
+function tagTable(tags, columns) {
+  const headers = ["TAG", ...columns.map((c) => c.name.toUpperCase()), "DOCS", "FACTS", "THREADS"];
   const rows = [];
   const gaps = [];
-  for (const row of matrix.rows ?? []) {
-    const has = new Set((row.tag.fields ?? []).map((f) => f.id));
-    const cells = columns.map(
-      (c) => has.has(c.id) ? formatFieldValue(row.tag.field_values?.[c.id]) : "n/a"
-    );
+  for (const tag of tags) {
+    const links = tag.links;
+    const docs = links?.doc_count ?? 0;
+    const facts = links?.fact_count ?? 0;
+    const threads = links?.thread_count ?? 0;
+    const cells = columns.map((c) => formatFieldValue(tag.field_values?.[c.id]));
     rows.push([
-      row.tag.name,
+      tag.name,
       ...cells,
-      row.doc_count ? String(row.doc_count) : GAP,
-      row.fact_count ? String(row.fact_count) : GAP
+      docs ? String(docs) : GAP,
+      facts ? String(facts) : GAP,
+      threads ? String(threads) : GAP
     ]);
-    const missing = columns.filter((c, i) => has.has(c.id) && cells[i] === GAP).map((c) => c.name);
-    if (!row.doc_count) missing.push("documents");
-    if (!row.fact_count) missing.push("facts");
-    if (missing.length) gaps.push(`${row.tag.name}: no ${missing.join(", no ")}`);
+    const missing = columns.filter((_, i) => cells[i] === GAP).map((c) => c.name);
+    if (!docs) missing.push("documents");
+    if (!facts) missing.push("facts");
+    if (missing.length) gaps.push(`${tag.name}: no ${missing.join(", no ")}`);
   }
   return { headers, rows, gaps };
 }
@@ -8639,7 +8640,39 @@ function renderTable(headers, rows, max = 28) {
   return [line(headers), ...rows.map(line)];
 }
 
+// src/tag-kinds.ts
+var KINDS = {
+  label: true,
+  annotation: true,
+  search: true,
+  issue: true,
+  person: true,
+  organisation: true
+};
+var TAG_KINDS = Object.keys(KINDS);
+function parseTagKind(value, flag = "--kind") {
+  const kind = value.trim().toLowerCase();
+  if (!TAG_KINDS.includes(kind))
+    throw new Error(`${flag} must be one of ${TAG_KINDS.join(", ")} (got "${value}")`);
+  return kind;
+}
+function tagDetails(tag, parentName, fields = []) {
+  const type = tag.tag_type?.type ?? "";
+  const rows = [
+    ["Kind:", tag.kind],
+    ["Type:", type],
+    ["Shared:", tag.shared ? "yes" : "no"],
+    ["Documents:", String(tag.doctag_count ?? 0)]
+  ];
+  if (tag.parent_ext_id)
+    rows.push(["Parent:", parentName ? `${parentName} (${tag.parent_ext_id})` : tag.parent_ext_id]);
+  if (tag.instruction) rows.push(["Instruction:", tag.instruction]);
+  for (const f of fields) rows.push([`${f.name}:`, formatFieldValue(tag.field_values?.[f.id])]);
+  return rows;
+}
+
 // src/commands/tags.ts
+var KIND_LIST = TAG_KINDS.join(", ");
 async function resolveTag(arbi, selector) {
   const res = resolveByIdOrName(await sdk.tags.listTags(arbi), selector);
   if (!res.ok) failResolveAndExit("Tag", selector, res);
@@ -8661,23 +8694,52 @@ async function fetchTagChoices(arbi) {
   };
 }
 function registerTagsCommand(program2) {
-  const tags = program2.command("tags").description("Tags: list, create, delete, update, share, unshare, rename, fields, matrix");
-  tags.command("list").description("List tags in the active workspace").option("-w, --workspace <id>", "Workspace ID (defaults to selected workspace)").option("--json", "Output as JSON").action(
+  const tags = program2.command("tags").description("Tags: list, show, create, delete, update, share, unshare, rename, fields");
+  tags.command("list").description(
+    "List tags in the active workspace; with --links, as a table: the kind\u2019s fields as columns, then document, fact and thread counts, gaps marked \u2014"
+  ).option("-w, --workspace <id>", "Workspace ID (defaults to selected workspace)").option("-k, --kind <kind>", `Only tags of this kind (${KIND_LIST})`).option("--parent <tag>", "Only this tag\u2019s children (id or name; a label hierarchy)").option(
+    "--links [n]",
+    "The table: each tag\u2019s values for its kind\u2019s fields and its documents, facts and threads (with --json: the newest n of each, default 50)"
+  ).option("--json", "Output as JSON").action(
     (opts) => runAction(async () => {
+      const kind = opts.kind === void 0 ? void 0 : parseTagKind(opts.kind);
+      const linksLimit = typeof opts.links === "string" ? Number(opts.links) : void 0;
+      if (linksLimit !== void 0 && (!Number.isInteger(linksLimit) || linksLimit < 0))
+        throw new Error("--links takes a whole number");
       const { arbi } = await resolveWorkspace(opts.workspace);
-      const data = await sdk.tags.listTags(arbi);
+      const parent = opts.parent ? await resolveTag(arbi, opts.parent) : void 0;
+      const data = await sdk.tags.listTags(arbi, {
+        ...kind ? { kind } : {},
+        ...parent ? { parentId: parent.external_id } : {},
+        ...opts.links ? { include: ["links"], linksLimit } : {}
+      });
       if (opts.json) {
         printJson(data);
         return;
       }
       if (data.length === 0) {
-        process.stderr.write("No tags found.\n");
+        process.stderr.write(
+          kind ? `No ${kind} tags. Add one: arbi tags create <name> --kind ${kind}
+` : "No tags found.\n"
+        );
+        return;
+      }
+      if (opts.links) {
+        const columns = kind ? (await sdk.tags.getTagKind(arbi, kind)).fields : [];
+        const table = tagTable(data, columns);
+        for (const line of renderTable(table.headers, table.rows)) console.log(line);
+        if (table.gaps.length) {
+          console.log("");
+          dim("Gaps:");
+          for (const g of table.gaps) dim(`  ${g}`);
+        }
         return;
       }
       printTable(
         [
           { header: "ID", width: 24, value: (r) => r.external_id },
           { header: "NAME", width: 24, value: (r) => r.name },
+          { header: "KIND", width: 13, value: (r) => r.kind ?? "" },
           {
             header: "TYPE",
             width: 12,
@@ -8691,12 +8753,43 @@ function registerTagsCommand(program2) {
       );
     })()
   );
+  tags.command("show <tag>").description(
+    "A tag's details: kind, type, sharing, documents, parent, instruction and its values for its kind's fields"
+  ).option("-w, --workspace <id>", "Workspace ID (defaults to selected workspace)").option("--json", "Output as JSON").action(
+    (selector, opts) => runAction(async () => {
+      const { arbi } = await resolveWorkspace(opts.workspace);
+      const all = await sdk.tags.listTags(arbi);
+      const res = resolveByIdOrName(all, selector);
+      if (!res.ok) failResolveAndExit("Tag", selector, res);
+      const tag = res.item;
+      if (opts.json) {
+        printJson(tag);
+        return;
+      }
+      const parent = all.find((t) => t.external_id === tag.parent_ext_id);
+      const { fields } = await sdk.tags.getTagKind(arbi, tag.kind);
+      bold(`${tag.name} (${tag.external_id})`);
+      for (const [key, value] of tagDetails(tag, parent?.name, fields)) label(key, value);
+    })()
+  );
   tags.command("create [name]").description("Create a new tag (interactive form if no name given)").option("-w, --workspace <id>", "Workspace ID (defaults to selected workspace)").option(
     "-t, --type <type>",
     "Tag type (checkbox, text, number, select, folder, search, date, assistant)",
     "checkbox"
-  ).option("-i, --instruction <text>", "Tag instruction").option("--shared", "Make tag shared", false).option("--parent <tag>", "Make it a child of this tag (id or name): it inherits its fields").option("--json", "Output as JSON").action(
+  ).option("-i, --instruction <text>", "Tag instruction").option("--shared", "Make tag shared", false).option(
+    "--parent <tag>",
+    "Make it a child of this tag (id or name; labels only: issues, people and organisations are flat)"
+  ).option(
+    "-k, --kind <kind>",
+    `What it is (${KIND_LIST}). Default: from the type (checkbox: label)`
+  ).option(
+    "--set <name=value>",
+    "A value for one of the kind's fields (repeatable), e.g. --set Status=Open",
+    collect,
+    []
+  ).option("--json", "Output as JSON").action(
     (name, opts) => runAction(async () => {
+      const kind = opts.kind === void 0 ? void 0 : parseTagKind(opts.kind);
       const { arbi } = await resolveWorkspace(opts.workspace);
       const parent = opts.parent ? await resolveTag(arbi, opts.parent) : void 0;
       const interactive = !name;
@@ -8715,6 +8808,13 @@ function registerTagsCommand(program2) {
       ]);
       const instruction = interactive ? opts.instruction ?? (await promptInput("Instruction (optional)", false) || null) : opts.instruction ?? null;
       const shared = interactive ? opts.shared || await promptConfirm("Shared?", false) : opts.shared ?? false;
+      const fieldValues = opts.set.length ? parseFieldValues(
+        opts.set,
+        (await sdk.tags.getTagKind(
+          arbi,
+          kind ?? (tagType === "checkbox" ? "label" : "annotation")
+        )).fields
+      ) : null;
       const data = await sdk.tags.createTag(arbi, {
         name,
         tagType: {
@@ -8723,14 +8823,16 @@ function registerTagsCommand(program2) {
         },
         instruction,
         shared,
-        parentId: parent?.external_id ?? null
+        parentId: parent?.external_id ?? null,
+        kind: kind ?? null,
+        fieldValues
       });
       if (opts.json) {
         printJson(data);
         return;
       }
       success(
-        `Created: ${data.name} (${ref(data.external_id)})${parent ? ` under ${parent.name}` : ""}`
+        `Created: ${data.name} (${ref(data.external_id)}) [${data.kind}]${parent ? ` under ${parent.name}` : ""}`
       );
     })()
   );
@@ -8797,41 +8899,24 @@ function registerTagsCommand(program2) {
     })()
   );
   tags.command("fields <tag>").description(
-    "Show a tag's fields and values; --define its own fields (a child inherits its parent's), --set values"
-  ).option(
-    "--define <json|file>",
-    `Its own field definitions: JSON or a .json/.yaml file, e.g. '[{"name":"budget","type":"number"},{"name":"risk","type":"select","options":["low","high"]}]'. A field defined again by name keeps its values; ones left out are dropped unless --keep-others`
-  ).option("--keep-others", "With --define: keep its other own fields").option("--set <name=value>", "Set a field value (repeatable; name= clears it)", collect, []).option("--json", "Output as JSON").action(
+    "Show a tag's values for its kind's fields; --set them. The fields themselves: arbi tag-kinds"
+  ).option("--set <name=value>", "Set a field value (repeatable; name= clears it)", collect, []).option("--json", "Output as JSON").action(
     (selector, opts) => runAction(async () => {
-      const defs = opts.define ? parseFieldDefinitions(opts.define) : void 0;
       const { arbi } = await resolveWorkspace();
       let tag = await resolveTag(arbi, selector);
-      if (defs || opts.set.length) {
-        const fields = defs ? sdk.tags.mergeTagFieldDefinitions(tag, defs, { keepOthers: !!opts.keepOthers }) : void 0;
-        const known = fields ? [
-          ...(tag.fields ?? []).filter((f) => f.tag_ext_id !== tag.external_id),
-          ...fields.map((f) => ({
-            id: f.id ?? "",
-            name: f.name,
-            type: f.type,
-            options: f.options ?? null,
-            tag_ext_id: tag.external_id
-          }))
-        ] : tag.fields ?? [];
-        const values = opts.set.length ? parseFieldValues(opts.set, known) : void 0;
-        tag = await sdk.tags.updateTagFields(arbi, tag.external_id, { fields, values });
-      }
+      const { fields } = await sdk.tags.getTagKind(arbi, tag.kind);
+      if (opts.set.length)
+        tag = await sdk.tags.setTagValues(arbi, tag.external_id, parseFieldValues(opts.set, fields));
       if (opts.json) {
         printJson(tag);
         return;
       }
-      if (defs || opts.set.length)
-        success(`Updated the fields of ${tag.name} (${ref(tag.external_id)})`);
+      if (opts.set.length) success(`Updated the values of ${tag.name} (${ref(tag.external_id)})`);
       else bold(`${tag.name} (${tag.external_id})`);
-      const rows = fieldRows(tag);
+      const rows = fieldRows(tag, fields);
       if (!rows.length) {
         dim(
-          `No fields. Define some: arbi tags fields ${tag.external_id} --define '[{"name":"budget","type":"number"}]'`
+          `No ${tag.kind} fields. Add some: arbi tag-kinds set-fields ${tag.kind} '[{"name":"Status","type":"text"}]'`
         );
         return;
       }
@@ -8839,55 +8924,87 @@ function registerTagsCommand(program2) {
         [
           { header: "FIELD", width: 22, value: (r) => r.name },
           { header: "TYPE", width: 24, value: (r) => r.type },
-          { header: "VALUE", width: 28, value: (r) => r.value },
-          { header: "DEFINED", width: 30, value: (r) => r.from }
+          { header: "VALUE", width: 40, value: (r) => r.value }
         ],
         rows
       );
     })()
   );
-  tags.command("matrix").description(
-    "Tags as a table: rows are a parent's children (--parent) or the given tags (--tag), columns their fields, then document and fact counts; gaps marked \u2014"
-  ).option("--parent <tag>", "Rows are this tag\u2019s children (id or name)").option("--tag <tag>", "A row (id or name; repeatable, in this order)", collect, []).option("--links <n>", "Most documents and facts listed per row (JSON)").option("--json", "Output as JSON").action(
+  tags.allowUnknownOption(true).allowExcessArguments(true).action(async () => {
+    const tail = tags.args ?? [];
+    await tags.commands.find((c) => c.name() === "list").parseAsync(tail, { from: "user" });
+  });
+}
+var KIND_LIST2 = TAG_KINDS.join(", ");
+function printSchema(schema) {
+  bold(`${schema.kind}${schema.is_default ? " (built-in fields)" : ""}`);
+  if (!schema.fields.length) {
+    dim(
+      `  No fields. Add some: arbi tag-kinds set-fields ${schema.kind} '[{"name":"Status","type":"select","options":["Open","Closed"]}]'`
+    );
+    return;
+  }
+  printTable(
+    [
+      { header: "ID", width: 12, value: (r) => r.id },
+      { header: "FIELD", width: 24, value: (r) => r.name },
+      { header: "TYPE", width: 32, value: (r) => r.type }
+    ],
+    schema.fields.map((f) => ({ id: f.id, name: f.name, type: fieldType(f) }))
+  );
+}
+function registerTagKindsCommand(program2) {
+  const kinds = program2.command("tag-kinds").description(
+    "Tag kinds' fields in the workspace (the columns of a table of a kind's tags): list, show, set-fields"
+  );
+  kinds.command("list").description("Every kind's fields in the active workspace").option("--json", "Output as JSON").action(
     (opts) => runAction(async () => {
-      if (!opts.parent === !opts.tag.length)
-        throw new Error("Pass --parent <tag>, or one or more --tag <tag>");
-      const links = opts.links === void 0 ? void 0 : Number(opts.links);
-      if (links !== void 0 && (!Number.isInteger(links) || links < 0))
-        throw new Error("--links must be a whole number");
       const { arbi } = await resolveWorkspace();
-      const all = await sdk.tags.listTags(arbi);
-      const pick = (selector) => {
-        const res = resolveByIdOrName(all, selector);
-        if (!res.ok) failResolveAndExit("Tag", selector, res);
-        return res.item;
-      };
-      const selection = opts.parent ? { parentId: pick(opts.parent).external_id } : { tagIds: opts.tag.map((t) => pick(t).external_id) };
-      const matrix = await sdk.tags.getTagMatrix(arbi, selection, links);
+      const all = await sdk.tags.listTagKinds(arbi);
       if (opts.json) {
-        printJson(matrix);
-        return;
-      }
-      const table = matrixTable(matrix);
-      if (matrix.parent) bold(`${matrix.parent.name} (${matrix.parent.external_id})`);
-      if (!table.rows.length) {
-        process.stderr.write(
-          opts.parent ? `No child tags. Add one: arbi tags create <name> --parent ${opts.parent}
-` : "No tags.\n"
-        );
+        printJson(all);
         return;
       }
-      for (const line of renderTable(table.headers, table.rows)) console.log(line);
-      if (table.gaps.length) {
+      for (const schema of all) {
+        printSchema(schema);
         console.log("");
-        dim("Gaps:");
-        for (const g of table.gaps) dim(`  ${g}`);
       }
     })()
   );
-  tags.allowUnknownOption(true).allowExcessArguments(true).action(async () => {
-    const tail = tags.args ?? [];
-    await tags.commands.find((c) => c.name() === "list").parseAsync(tail, { from: "user" });
+  kinds.command("show <kind>").description(`A kind's fields (${KIND_LIST2})`).option("--json", "Output as JSON").action(
+    (kindArg, opts) => runAction(async () => {
+      const kind = parseTagKind(kindArg, "kind");
+      const { arbi } = await resolveWorkspace();
+      const schema = await sdk.tags.getTagKind(arbi, kind);
+      if (opts.json) printJson(schema);
+      else printSchema(schema);
+    })()
+  );
+  kinds.command("set-fields <kind> <fields>").description(
+    `Set a kind's fields: JSON or a .json/.yaml file of [{name, type, options}], e.g. '[{"name":"Status","type":"select","options":["Open","Closed"]},{"name":"Owner","type":"person"}]'. A field named again (any case) keeps its id and values; ones left out are removed unless --keep-others`
+  ).option("--keep-others", "Keep the kind\u2019s other fields (after the given ones)").option("--json", "Output as JSON").action(
+    (kindArg, fieldsArg, opts) => runAction(async () => {
+      const kind = parseTagKind(kindArg, "kind");
+      const wanted = parseFieldDefinitions(fieldsArg);
+      const { arbi } = await resolveWorkspace();
+      const current = await sdk.tags.getTagKind(arbi, kind);
+      const schema = await sdk.tags.updateTagKind(
+        arbi,
+        kind,
+        sdk.tags.mergeKindFieldDefinitions(current.fields, wanted, {
+          keepOthers: !!opts.keepOthers
+        })
+      );
+      if (opts.json) {
+        printJson(schema);
+        return;
+      }
+      success(`Set the ${kind} fields`);
+      printSchema(schema);
+    })()
+  );
+  kinds.action(async () => {
+    await kinds.commands.find((c) => c.name() === "list").parseAsync([], { from: "user" });
   });
 }
 init_prompts();
@@ -11955,7 +12072,7 @@ console.info = (...args) => {
   _origInfo(...args);
 };
 var program = new commander.Command();
-program.name("arbi").description("ARBI CLI \u2014 interact with ARBI from the terminal").version("0.4.83").showHelpAfterError(true).showSuggestionAfterError(true);
+program.name("arbi").description("ARBI CLI \u2014 interact with ARBI from the terminal").version("0.4.85").showHelpAfterError(true).showSuggestionAfterError(true);
 registerConfigCommand(program);
 registerLoginCommand(program);
 registerRegisterCommand(program);
@@ -11972,6 +12089,7 @@ registerWatchCommand(program);
 registerContactsCommand(program);
 registerDmCommand(program);
 registerTagsCommand(program);
+registerTagKindsCommand(program);
 registerTimelineCommand(program);
 registerDoctagsCommand(program);
 registerConversationsCommand(program);