@unisonlabs/sixminute-admin 0.1.608-next → 0.1.610-next

package/README.md

@@ -58,10 +58,17 @@ sixminute-admin research export --env production --tenant tenant_... --from 2026
 sixminute-admin activity-type list --env production --tenant tenant_...
 sixminute-admin member list --env production --tenant tenant_...
 sixminute-admin matters import --env production --tenant tenant_... --from-file matters.json
+sixminute-admin matter list --env production --tenant tenant_... --all
+sixminute-admin matter edit --env production --tenant tenant_... --matter matter_... --name "Example Holding: lease review"
+sixminute-admin matter archive --env production --tenant tenant_... --matter matter_...
+sixminute-admin client edit --env production --tenant tenant_... --client client_... --external-ref C-101
 sixminute-admin connector status --env production --firm tenant_...
 sixminute-admin audit --env production --limit 20
 ```
 
 `sixminute-admin --help` lists every command, with the warnings on the destructive ones.
-`client create`, `matter create` and `matters import` work only on a firm marked internal (our own).
+Creating, editing and archiving clients and matters, and `matters import`, work only on a firm
+marked internal (our own). Archive is the delete: the row and its entries stay, and an archived
+matter leaves the pickers; nothing deletes a client or a matter. A client is archived only once
+none of its matters is open: archive the matters first.
 `sixminute-admin --version` prints the version and the API commit it was built from.

package/dist/sixminute-admin.mjs

@@ -21,7 +21,7 @@ import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
 
 // tools/admin/src/build-info.ts
-var BUILT = { version: "0.1.608-next", commit: "b4feeba888b88d7044085c3b07dee4d6f515a4e0", surface: "e80083c611d5d5e0" };
+var BUILT = { version: "0.1.610-next", commit: "7e589dae1055faaac0407d389ef7f333e3b84aec", surface: "e738440f007ffca1" };
 
 // tools/admin/src/run.ts
 import { rmSync as rmSync3 } from "node:fs";
@@ -6712,12 +6712,31 @@ is required; without one every command answers 403.
 
   sixminute-admin client create --env <env> --tenant tenant_... --name "Example Holding" [--external-ref C-100] [--id client_...] [--json]
         Creates one client. A name already in use is refused.
-  sixminute-admin client list --env <env> --tenant tenant_... [--json]
-        Every client of the firm with its id, which matter create takes.
+  sixminute-admin client list --env <env> --tenant tenant_... [--all] [--json]
+        Every client of the firm with its id, which matter create takes, and
+        whether it is active or archived. Archived clients are left out
+        unless --all.
+  sixminute-admin client edit --env <env> --tenant tenant_... --client client_... [--name "..."] [--external-ref R] [--active true|false] [--json]
+        Changes only the fields given; at least one is required. A name
+        already in use is refused.
+  sixminute-admin client archive --env <env> --tenant tenant_... --client client_... [--json]
+  sixminute-admin client unarchive --env <env> --tenant tenant_... --client client_... [--json]
+        Sets the client inactive, or active again.
   sixminute-admin matter create --env <env> --tenant tenant_... --client client_... --name "Example Holding: general advice" \\
         [--number 2026-0001] [--description "..."] [--external-ref R] [--billable true|false] [--temporary true|false] [--id matter_...] [--json]
         Creates one matter under a client of the firm. --number is the firm's
         matter number, unique within the client. An unknown client is refused.
+  sixminute-admin matter list --env <env> --tenant tenant_... [--client client_...] [--all] [--json]
+        Every matter of the firm, or of one client: id, number, active or
+        archived, client and name. Archived matters are left out unless --all.
+  sixminute-admin matter edit --env <env> --tenant tenant_... --matter matter_... \\
+        [--name "..."] [--number N] [--description "..."] [--external-ref R] [--active true|false] [--json]
+        Changes only the fields given; at least one is required. A matter
+        belongs to one client for life, so there is no --client.
+  sixminute-admin matter archive --env <env> --tenant tenant_... --matter matter_... [--json]
+  sixminute-admin matter unarchive --env <env> --tenant tenant_... --matter matter_... [--json]
+        Sets the matter inactive, or active again. A temporary matter with
+        entries on it is refused: move the entries first.
   sixminute-admin matters import --env <env> --tenant tenant_... --from-file tools/admin/examples/matters-import.json [--json]
         Clients with their matters, from a document: the file IS the body of
         POST /v1/matters/import, checked against its schema before anything is
@@ -6725,10 +6744,14 @@ is required; without one every command answers 403.
         missing rows are created and known rows corrected, so running the same
         file again changes nothing. Prints how many were created, updated and
         left alone.
-        client create, matter create and matters import WORK ONLY ON AN INTERNAL
-        FIRM, one marked with tenant internal set: a real firm's clients and
-        matters come from its practice system. Any other firm is refused, exit 2,
-        and nothing is written.
+        The client and matter create, edit, archive and unarchive commands and
+        matters import WORK ONLY ON AN INTERNAL FIRM, one marked with tenant
+        internal set: a real firm's clients and matters come from its practice
+        system. Any other firm is refused, exit 2, and nothing is written.
+        Archive is the delete: it keeps the row and every entry on it, and an
+        archived matter leaves the pickers. client archive refuses while the
+        client has an open matter, and prints the matter archive line for each
+        one. Nothing here deletes a client or a matter.
 
   sixminute-admin member list --env <env> --tenant tenant_... [--json]
         The firm's members and its pending invitations.
@@ -6800,7 +6823,8 @@ var BOOLEAN_FLAGS = new Set([
   "required",
   "proposed",
   "confirm",
-  "password-stdin"
+  "password-stdin",
+  "all"
 ]);
 function parseFlags(argv, offset) {
   const values = new Map;
@@ -6971,8 +6995,8 @@ async function runAdmin(argv, deps) {
     return runMember(run2, subcommand);
   if (group === "client")
     return runClient(run2, subcommand);
-  if (group === "matter" && subcommand === "create")
-    return runMatterCreate(run2);
+  if (group === "matter")
+    return runMatter(run2, subcommand);
   if (group === "matters" && subcommand === "import")
     return runMattersImport(run2);
   if (group === "tier" && subcommand === "set")
@@ -7457,7 +7481,34 @@ async function readMatterSets(firm, matterId) {
     since = page.next_cursor;
   }
 }
-var CLIENT_PAGE = 2000;
+var PULL_PAGE = 2000;
+async function pullAll(run2, tenant, path, row) {
+  const rows = [];
+  let since = null;
+  let head = null;
+  for (;; ) {
+    const query = since === null ? `?limit=${PULL_PAGE}` : `?limit=${PULL_PAGE}&since=${enc(since)}`;
+    const answer = await call(run2.api, "GET", tenantPath(tenant, `${path}${query}`));
+    head ??= actingHead(tenant, answer);
+    const page = pullResultSchema(row).parse(expectOk(answer));
+    rows.push(...page.rows);
+    if (page.next_cursor === null)
+      return { rows, head };
+    since = page.next_cursor;
+  }
+}
+var stateOf = (row) => row.active ? "active" : "archived";
+function countLine(noun, shown, hidden) {
+  return `${shown} ${noun}(s)${hidden === 0 ? "" : `; ${hidden} archived not shown, --all lists them`}`;
+}
+function patchOf(fields, schema, flagNames) {
+  const body = definedFields(fields);
+  if (Object.keys(body).length === 0)
+    throw new AdminUsageError(`nothing to change: give at least one of ${flagNames}`);
+  checkBody(schema, body);
+  return body;
+}
+var clientLine = (c) => `client        ${c.id}  ${stateOf(c)}  ${c.name}${c.external_ref === null ? "" : `  ref ${c.external_ref}`}`;
 async function runClient(run2, subcommand) {
   const { flags } = run2;
   const tenant = required(flags, "tenant", "the firm the client belongs to");
@@ -7478,50 +7529,95 @@ async function runClient(run2, subcommand) {
     ]);
   }
   if (subcommand === "list") {
-    const clients = [];
-    let since = null;
-    let head = null;
-    for (;; ) {
-      const query = since === null ? `?limit=${CLIENT_PAGE}` : `?limit=${CLIENT_PAGE}&since=${enc(since)}`;
-      const answer = await call(run2.api, "GET", tenantPath(tenant, `/clients${query}`));
-      head ??= actingHead(tenant, answer);
-      const page = pullResultSchema(ClientSchema).parse(expectOk(answer));
-      clients.push(...page.rows);
-      if (page.next_cursor === null)
-        break;
-      since = page.next_cursor;
-    }
+    const { rows, head } = await pullAll(run2, tenant, "/clients", ClientSchema);
+    const clients = switched(flags, "all") ? rows : rows.filter((c) => c.active);
     return render(run2, { clients }, [
       head,
-      `${clients.length} client(s)`,
-      ...clients.map((c) => `  ${c.id}  ${c.name}${c.external_ref === null ? "" : `  ref ${c.external_ref}`}${c.active ? "" : "  (inactive)"}`)
+      countLine("client", clients.length, rows.length - clients.length),
+      ...clients.map((c) => `  ${c.id}  ${stateOf(c)}  ${c.name}${c.external_ref === null ? "" : `  ref ${c.external_ref}`}`)
     ]);
   }
+  if (subcommand === "edit" || subcommand === "archive" || subcommand === "unarchive") {
+    const id = required(flags, "client", "which client_... to change (client list --all prints them)");
+    const body = subcommand === "edit" ? patchOf({ name: optional(flags, "name"), external_ref: optional(flags, "external-ref"), active: booleanOf(flags, "active") }, ClientPatchSchema, "--name, --external-ref, --active") : { active: subcommand === "unarchive" };
+    if (body["active"] === false) {
+      const { rows } = await pullAll(run2, tenant, "/matters", MatterSchema);
+      const open = rows.filter((m) => m.client_id === id && m.active);
+      if (open.length > 0) {
+        throw new AdminUsageError(`${id} still has ${open.length} open matter(s), which stay pickable while they are open; archive them first:
+` + open.map((m) => `  sixminute-admin matter archive --env ${run2.environment.name} --tenant ${tenant} --matter ${m.id}  (${m.name})`).join(`
+`));
+      }
+    }
+    const answer = await call(run2.api, "PATCH", tenantPath(tenant, `/clients/${enc(id)}`), body);
+    if (answer.status !== 200)
+      return refused(run2, answer, [actingHead(tenant, answer)]);
+    const client = ClientSchema.parse(answer.body);
+    return render(run2, { client }, [actingHead(tenant, answer), clientLine(client)]);
+  }
   throw new AdminUsageError(`unknown command: client ${subcommand ?? ""}`.trim());
 }
-async function runMatterCreate(run2) {
+var matterLines = (m) => [
+  `matter        ${m.id}  ${m.code ?? "no number"}  ${stateOf(m)}  ${m.name}`,
+  `client        ${m.client_id}`
+];
+async function runMatter(run2, subcommand) {
   const { flags } = run2;
   const tenant = required(flags, "tenant", "the firm the matter belongs to");
-  const body = definedFields({
-    id: optional(flags, "id"),
-    client_id: required(flags, "client", "the client_... the matter is under (client list prints them)"),
-    name: required(flags, "name", "what the matter is called"),
-    code: optional(flags, "number"),
-    description: optional(flags, "description"),
-    external_ref: optional(flags, "external-ref"),
-    billable: booleanOf(flags, "billable"),
-    temporary: booleanOf(flags, "temporary")
-  });
-  checkBody(MatterInputSchema, body);
-  const answer = await call(run2.api, "POST", tenantPath(tenant, "/matters"), body);
-  if (answer.status !== 201)
-    return refused(run2, answer, [actingHead(tenant, answer)]);
-  const matter = MatterSchema.parse(answer.body);
-  return render(run2, { matter }, [
-    actingHead(tenant, answer),
-    `matter        ${matter.id}  ${matter.code ?? "no number"}  ${matter.name}`,
-    `client        ${matter.client_id}`
-  ]);
+  if (subcommand === "create") {
+    const body = definedFields({
+      id: optional(flags, "id"),
+      client_id: required(flags, "client", "the client_... the matter is under (client list prints them)"),
+      name: required(flags, "name", "what the matter is called"),
+      code: optional(flags, "number"),
+      description: optional(flags, "description"),
+      external_ref: optional(flags, "external-ref"),
+      billable: booleanOf(flags, "billable"),
+      temporary: booleanOf(flags, "temporary")
+    });
+    checkBody(MatterInputSchema, body);
+    const answer = await call(run2.api, "POST", tenantPath(tenant, "/matters"), body);
+    if (answer.status !== 201)
+      return refused(run2, answer, [actingHead(tenant, answer)]);
+    const matter = MatterSchema.parse(answer.body);
+    return render(run2, { matter }, [
+      actingHead(tenant, answer),
+      `matter        ${matter.id}  ${matter.code ?? "no number"}  ${matter.name}`,
+      `client        ${matter.client_id}`
+    ]);
+  }
+  if (subcommand === "list") {
+    const client = optional(flags, "client");
+    if (client !== undefined)
+      checkBody(MatterSchema.pick({ client_id: true }), { client_id: client });
+    const { rows, head } = await pullAll(run2, tenant, "/matters", MatterSchema);
+    const ofClient = client === undefined ? rows : rows.filter((m) => m.client_id === client);
+    const matters = switched(flags, "all") ? ofClient : ofClient.filter((m) => m.active);
+    return render(run2, { matters }, [
+      head,
+      countLine("matter", matters.length, ofClient.length - matters.length),
+      ...matters.map((m) => `  ${m.id}  ${m.code ?? "no number"}  ${stateOf(m)}  ${m.client_id}  ${m.name}`)
+    ]);
+  }
+  if (subcommand === "edit" || subcommand === "archive" || subcommand === "unarchive") {
+    const id = required(flags, "matter", "which matter_... to change (matter list --all prints them)");
+    if (subcommand === "edit" && flags.values.has("client")) {
+      throw new AdminUsageError("--client is not taken on matter edit: a matter belongs to one client for life; create a new matter under the other client");
+    }
+    const body = subcommand === "edit" ? patchOf({
+      name: optional(flags, "name"),
+      code: optional(flags, "number"),
+      description: optional(flags, "description"),
+      external_ref: optional(flags, "external-ref"),
+      active: booleanOf(flags, "active")
+    }, MatterPatchSchema, "--name, --number, --description, --external-ref, --active") : { active: subcommand === "unarchive" };
+    const answer = await call(run2.api, "PATCH", tenantPath(tenant, `/matters/${enc(id)}`), body);
+    if (answer.status !== 200)
+      return refused(run2, answer, [actingHead(tenant, answer)]);
+    const matter = MatterSchema.parse(answer.body);
+    return render(run2, { matter }, [actingHead(tenant, answer), ...matterLines(matter)]);
+  }
+  throw new AdminUsageError(`unknown command: matter ${subcommand ?? ""}`.trim());
 }
 async function runMattersImport(run2) {
   const { flags } = run2;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unisonlabs/sixminute-admin",
-  "version": "0.1.608-next",
+  "version": "0.1.610-next",
   "description": "Sixminute operator tool: the admin commands of the Sixminute API, run with your own operator sign-in.",
   "license": "UNLICENSED",
   "repository": {