@wirecat/cli-core 0.580.0 → 0.582.0

package/CHANGELOG.md

@@ -5,6 +5,38 @@ Notable changes to `@wirecat/cli-core` (`@wirecat/cli-messaging` up to 0.261.0,
 minor version may break callers, and says how under "Changed — may break callers". `pnpm docs:check` checks the
 shape of this file.
 
+## 0.582.0 — 05.11.2026
+
+### Added
+
+- **`knowledge.updateOrganization(organization, { name })` renames an organization**, given as `organization:<id>` or
+  by its id; its kind and scope stay. An agent's rename is a proposal for the owner: the `organization_rename`
+  proposal kind and `proposeOrganizationRename(store, { organization, name }, by, reason?)`. It shows in `review` as
+  an `organization` row (`rename organization:3 to ...`); confirming it renames, rejecting it changes nothing. No
+  schema change.
+
+### Fixed
+
+- **`knowledge.organizations` answers a `name:` term.** `ORGANIZATIONS_QUERY` listed `name`, but the store had no
+  column for it, so `organizations list name:acme` failed. The match ignores case in any script, and `name:*acme*`
+  finds a name that holds a word.
+
+## 0.581.0 — 05.11.2026
+
+### Added
+
+- **`review --holder` gives the findings key.** A host that mounts its findings command (`MailMount.findings`)
+  gets a `mail-findings.add` step with `key` before the acknowledge step, so an agent copies the key instead of
+  building it from the cursor. The text answer names it too.
+
+### Fixed
+
+- **A run after `messages reset` can stage its findings.** The reset counts on the mark (`resets`), and the findings
+  key of a mark moved back is `<holder>:<through_id>-r<resets>`, such as `mail-triage:277352-r1`. The runs after a
+  reset reached the through id of a batch staged before it and were refused (`mail-findings.key-used`), so their
+  mark stayed. Keys of marks never moved back keep their shape, and the same review still gives the same key, so
+  a retry of one run stages nothing twice.
+
 ## 0.580.0 — 05.11.2026
 
 ### Added

package/dist/mail/cli/index.d.ts

@@ -15,6 +15,8 @@ export interface MailMount {
     acknowledge?: string;
     /** `null`: the host mounts no thread read, so a review offers none. */
     conversation?: string | null;
+    /** The host's command that stages a findings batch with `--key`; `review --holder` then gives that key as a step. */
+    findings?: string;
     /** In snake_case, as a step names it: memo's `source`, with `email:<account>`. */
     mailbox?: {
         option: string;

package/dist/mail/cli/review.js

@@ -1,7 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
 import { defineQuery } from "@wirecat/cli-base/query";
-import { defineSteps, stepOf } from "@wirecat/cli-base/standards";
+import { defineSteps, MAX_NEXT_STEPS, stepOf, } from "@wirecat/cli-base/standards";
 import { Command } from "commander";
 import { environmentOf, outputFor } from "../../cli/context.js";
 import { LOCAL_READ } from "../../cli/effects.js";
@@ -36,7 +36,18 @@ export const MAIL_REVIEW_QUERY = defineQuery({
 /** The mail review's steps where a host mounted them; a host lists them beside its own so its step checks know them. */
 export const mailReviewSteps = (mount = {}) => {
     const mailbox = mount.mailbox ? [{ name: mount.mailbox.option, required: true }] : [];
+    const findings = mount.findings
+        ? [
+            {
+                id: "mail-findings.add",
+                command: mount.findings,
+                args: [{ name: "key", required: true }, ...mailbox],
+                why: "stage what these emails ask under this key, before acknowledging them",
+            },
+        ]
+        : [];
     return defineSteps([
+        ...findings,
         {
             id: "mail-messages.acknowledge",
             command: mount.acknowledge ?? "messages acknowledge",
@@ -197,7 +208,12 @@ const holderReview = async (command, mail, holder, query) => {
     const step = stepsFor(mail.mount, mailbox);
     const answer = reviewAnswer(found, mailbox, true, step);
     const skipped = Object.entries(read.skipped).filter(([, count]) => count > 0);
-    answer.next = [...step("mail-messages.acknowledge", { holder, cursor: read.cursor }), ...(answer.next ?? [])];
+    const stage = read.findingsKey === undefined ? [] : step("mail-findings.add", { key: read.findingsKey });
+    answer.next = [
+        ...stage,
+        ...step("mail-messages.acknowledge", { holder, cursor: read.cursor }),
+        ...(answer.next ?? []),
+    ].slice(0, MAX_NEXT_STEPS);
     answer.missing = [
         ...(answer.missing ?? []),
         ...(read.held > 0 ? [{ field: "items", why: `${read.held} partial emails held until they are whole` }] : []),
@@ -217,7 +233,7 @@ const holderReview = async (command, mail, holder, query) => {
     const output = outputFor(command);
     renderAnswer(command, output, answer, () => {
         output.renderer.note(read.mark
-            ? `${holder}: past ${read.mark.throughId}; acknowledge with --cursor ${read.cursor}${read.more ? "; more after these" : ""}`
+            ? `${holder}: past ${read.mark.throughId}; findings key ${read.findingsKey}; acknowledge with --cursor ${read.cursor}${read.more ? "; more after these" : ""}`
             : `${holder} has no mark yet: it starts from now — acknowledge with --cursor ${read.cursor}`);
         return emails.map((hit) => `${hitText(hit)}${markText(marks.get(hit.id), hit.excerptOnly)}\n`).join("");
     });

package/dist/mail/findings.d.ts

@@ -131,7 +131,10 @@ export interface MailOrderUpdateFinding extends Cited {
 export type MailFinding = MailTaskFinding | MailFactFinding | MailTaskUpdateFinding | MailMemoryFinding | MailLinkFinding | MailNewContactFinding | MailInvoiceFinding | MailPaymentFinding | MailOrderFinding | MailOrderUpdateFinding;
 export interface MailFindingsInput {
     schemaVersion: 1;
-    /** `<holder>:<through_id>`: one batch per run of a holder over the mail it was given. */
+    /**
+     * `<holder>:<through_id>`, with `-r<resets>` after the owner moved the mark back: one batch per run of a holder over
+     * the mail it was given. `review --holder` gives it.
+     */
     key: string;
     extractor: string;
     findings: MailFinding[];

package/dist/mail/findings.js

@@ -347,8 +347,9 @@ const one = (raw, ids) => {
  * The shape of a mail findings batch: 1–30 findings, each citing 1–8 `msg:email/…` references with fingerprints.
  * What needs the store — the fingerprints, partial mail, the per-sender cap, the targets — the store checks.
  */
-const KEY = /^[a-z0-9][a-z0-9-]{0,39}:[1-9]\d*$/;
-const KEY_SHAPE = "a mail findings key is <holder>:<through_id>, such as mail-triage:9123456";
+const KEY = /^[a-z0-9][a-z0-9-]{0,39}:[1-9]\d*(-r[1-9]\d*)?$/;
+const KEY_SHAPE = "a mail findings key is the one `review --holder` gave: <holder>:<through_id>, and -r<resets> after a reset, " +
+    "such as mail-triage:9123456 or mail-triage:9123456-r1";
 export const validateMailFindings = (input) => {
     const batch = validateBatch(input, RULES, MAIL_FINDINGS_PER_RUN, one);
     if (!KEY.test(batch.key))

package/dist/mail/marks.d.ts

@@ -22,6 +22,8 @@ export interface MailMark {
     suspicious: number[];
     read: number;
     skipped: Record<SkipReason, number>;
+    /** How often the owner moved the mark back: a findings key names it, so a run after a reset never reuses one. */
+    resets: number;
     /** ms. */
     updatedAt: number;
 }
@@ -30,6 +32,12 @@ export declare const markOf: (store: MessageStore, mailbox: AccountKey, holder:
 export declare const marksOf: (store: MessageStore, mailbox: AccountKey) => Promise<MailMark[]>;
 /** The mark's state, as a cursor `acknowledge` takes back: the last id read, and when it was read. */
 export declare const cursorOf: (throughId: number, readAt: number) => string;
+/**
+ * The findings key of one run: `<holder>:<through_id>`, and `-r<resets>` once the owner moved the mark back, so the
+ * runs after a reset never reach a key a batch staged before it holds. The same review gives the same key: a retry
+ * of one run stages nothing twice.
+ */
+export declare const findingsKeyOf: (holder: string, throughId: number, resets: number) => string;
 /** A bulk email that is not surely a newsletter: the holder gets its subject and first lines only. */
 export interface BulkExcerpt {
     email: StoredHit;
@@ -45,6 +53,8 @@ export interface MarkRead {
     excerpts: BulkExcerpt[];
     /** What `acknowledge --cursor` takes once the holder is done with these. */
     cursor: string;
+    /** The key a findings batch over these emails takes; `undefined` while nothing is stored to read. */
+    findingsKey: string | undefined;
     /** More is stored after this batch: read again after acknowledging. */
     more: boolean;
     held: number;

package/dist/mail/marks.js

@@ -39,6 +39,7 @@ const parsed = (holder, value, at) => {
             suspicious: Array.isArray(saved.suspicious) ? saved.suspicious.filter((id) => typeof id === "number") : [],
             read: saved.read ?? 0,
             skipped: { ...noneSkipped(), ...saved.skipped },
+            resets: typeof saved.resets === "number" ? saved.resets : 0,
             updatedAt: at,
         };
     }
@@ -80,6 +81,12 @@ const verdict = (email, now) => {
 };
 /** The mark's state, as a cursor `acknowledge` takes back: the last id read, and when it was read. */
 export const cursorOf = (throughId, readAt) => `${throughId}.${readAt}`;
+/**
+ * The findings key of one run: `<holder>:<through_id>`, and `-r<resets>` once the owner moved the mark back, so the
+ * runs after a reset never reach a key a batch staged before it holds. The same review gives the same key: a retry
+ * of one run stages nothing twice.
+ */
+export const findingsKeyOf = (holder, throughId, resets) => `${holder}:${throughId}${resets > 0 ? `-r${resets}` : ""}`;
 const parseCursor = (cursor) => {
     const match = /^(\d+)\.(\d+)$/.exec(cursor.trim());
     if (!match)
@@ -140,10 +147,14 @@ const examine = async (store, mailbox, holder, { now = Date.now(), limit = MARK_
         skipped: noneSkipped(),
         mark: saved,
     };
+    const keyed = (throughId) => ({
+        cursor: cursorOf(throughId, now),
+        findingsKey: throughId > 0 ? findingsKeyOf(holder, throughId, saved?.resets ?? 0) : undefined,
+    });
     if (!account)
-        return { ...empty, cursor: cursorOf(0, now) };
+        return { ...empty, ...keyed(0) };
     if (!saved)
-        return { ...empty, cursor: cursorOf(await store.mail.newestEmailId(account.id), now) };
+        return { ...empty, ...keyed(await store.mail.newestEmailId(account.id)) };
     const mark = after === undefined ? saved : { ...saved, throughId: after, held: [], suspicious: [] };
     const found = await store.mail.emailsAfter(account.id, mark.throughId, limit + 1, [...mark.held, ...mark.suspicious]);
     // Mail a running sync stored is read once that sync ended: it files bulk mail only at its end.
@@ -179,7 +190,7 @@ const examine = async (store, mailbox, holder, { now = Date.now(), limit = MARK_
         wanted: wanted.sort((a, b) => a - b),
         sorted: new Map([...sorted].filter(([, one]) => one.verdict === "excerpt")),
         oldestStoredAt,
-        cursor: cursorOf(batch.at(-1)?.id ?? mark.throughId, now),
+        ...keyed(batch.at(-1)?.id ?? mark.throughId),
         more: newer.length > batch.length,
         held,
         skipped,
@@ -312,6 +323,7 @@ export const acknowledgeMark = async (store, mailbox, holder, cursor, now = Date
         suspicious: [...new Set(suspicious)].sort((a, b) => a - b).slice(-MOST_HELD),
         read,
         skipped,
+        resets: mark?.resets ?? 0,
     };
     await store.sync.setSyncState(mailbox, key, JSON.stringify(next));
     return { holder, ...next, updatedAt: now };
@@ -397,6 +409,7 @@ export const rewindMark = async (store, mailbox, holder, to, { now = Date.now(),
         suspicious: mark.suspicious.filter((id) => id <= through),
         read: mark.read,
         skipped: mark.skipped,
+        resets: mark.resets + 1,
     };
     if (!dry)
         await store.sync.setSyncState(mailbox, key, JSON.stringify(next));

package/dist/services/index.d.ts

@@ -188,7 +188,7 @@ export { type PackageUpgradeOutcome, type PackageUpgradePorts, type PackageUpgra
 export { type PersonMeetingContext, type PersonMeetingContextItem, type PersonMeetingContextOptions, type PersonMeetingReadStore, personMeetingContext, } from "./person-meeting-context.js";
 export { privatePeopleService } from "./private-people.js";
 export { approveAsTask, type ProposalTaskStore, proposalSource } from "./proposal-tasks.js";
-export { type Decided, type Decision, emptyProposalRegistry, FACT_SUMMARIES, ORGANIZATION_ADD_KIND, type OrganizationProposal, type ProposalFilter, type ProposalKind, type ProposalRegistry, type ProposalRow, parseProposalIds, proposalRegistry, proposeOrganization, } from "./proposals/index.js";
+export { type Decided, type Decision, emptyProposalRegistry, FACT_SUMMARIES, ORGANIZATION_ADD_KIND, ORGANIZATION_RENAME_KIND, type OrganizationProposal, type OrganizationRenameProposal, type ProposalFilter, type ProposalKind, type ProposalRegistry, type ProposalRow, parseProposalIds, proposalRegistry, proposeOrganization, proposeOrganizationRename, } from "./proposals/index.js";
 export type { RetentionQuery, RetentionService } from "./retention.js";
 export { retentionService } from "./retention.js";
 export { RESOURCES_SEARCHED, type SearchAllFound, type SearchAllItem, type SearchAllMessenger, type SearchAllRequest, type SearchedResource, searchAll, } from "./search-all.js";

package/dist/services/index.js

@@ -146,7 +146,7 @@ export { upgradePackage, } from "./package-upgrade.js";
 export { personMeetingContext, } from "./person-meeting-context.js";
 export { privatePeopleService } from "./private-people.js";
 export { approveAsTask, proposalSource } from "./proposal-tasks.js";
-export { emptyProposalRegistry, FACT_SUMMARIES, ORGANIZATION_ADD_KIND, parseProposalIds, proposalRegistry, proposeOrganization, } from "./proposals/index.js";
+export { emptyProposalRegistry, FACT_SUMMARIES, ORGANIZATION_ADD_KIND, ORGANIZATION_RENAME_KIND, parseProposalIds, proposalRegistry, proposeOrganization, proposeOrganizationRename, } from "./proposals/index.js";
 export { retentionService } from "./retention.js";
 export { RESOURCES_SEARCHED, searchAll, } from "./search-all.js";
 export { RESOURCES_SEARCHED_WITH_MEETINGS, searchAllIncludingMeetings, searchAllWithMeetings, } from "./search-all-meetings.js";

package/dist/services/proposals/index.d.ts

@@ -1,5 +1,5 @@
 export { parseProposalIds } from "./ids.js";
 export { FACT_SUMMARIES } from "./kinds/findings.js";
-export { ORGANIZATION_ADD_KIND, type OrganizationProposal, proposeOrganization } from "./kinds/organization.js";
+export { ORGANIZATION_ADD_KIND, ORGANIZATION_RENAME_KIND, type OrganizationProposal, type OrganizationRenameProposal, proposeOrganization, proposeOrganizationRename, } from "./kinds/organization.js";
 export { emptyProposalRegistry, proposalRegistry } from "./registry.js";
 export type { Decided, Decision, ProposalFilter, ProposalKind, ProposalRegistry, ProposalRow } from "./types.js";

package/dist/services/proposals/index.js

@@ -1,4 +1,4 @@
 export { parseProposalIds } from "./ids.js";
 export { FACT_SUMMARIES } from "./kinds/findings.js";
-export { ORGANIZATION_ADD_KIND, proposeOrganization } from "./kinds/organization.js";
+export { ORGANIZATION_ADD_KIND, ORGANIZATION_RENAME_KIND, proposeOrganization, proposeOrganizationRename, } from "./kinds/organization.js";
 export { emptyProposalRegistry, proposalRegistry } from "./registry.js";

package/dist/services/proposals/kinds/organization.d.ts

@@ -1,11 +1,18 @@
 import type { Author, MessageStore, Organization, ProposedAction } from "../../../store/index.js";
 import type { ProposalKind } from "../types.js";
 export declare const ORGANIZATION_ADD_KIND = "organization_add";
+export declare const ORGANIZATION_RENAME_KIND = "organization_rename";
 export interface OrganizationProposal {
     name: string;
     kind: Organization["kind"];
     scope?: Organization["scope"];
 }
+export interface OrganizationRenameProposal {
+    organization: string;
+    name: string;
+}
 /** An agent's new organization waits as a stored proposal; the organization exists only once it is confirmed. */
 export declare const proposeOrganization: (store: Pick<MessageStore, "proposedActions">, input: OrganizationProposal, by: Author, reason?: string) => Promise<ProposedAction>;
+/** An agent's rename waits as a stored proposal too; the organization keeps its name until it is confirmed. */
+export declare const proposeOrganizationRename: (store: Pick<MessageStore, "proposedActions">, input: OrganizationRenameProposal, by: Author, reason?: string) => Promise<ProposedAction>;
 export declare const organizationKind: (store: Pick<MessageStore, "proposedActions" | "knowledge">) => ProposalKind;

package/dist/services/proposals/kinds/organization.js

@@ -1,16 +1,19 @@
 import { proposerOfAction } from "../../../store/index.js";
 import { actionStatus, kept, pushed, storedStatus } from "./shared.js";
 export const ORGANIZATION_ADD_KIND = "organization_add";
+export const ORGANIZATION_RENAME_KIND = "organization_rename";
 const rowOf = (action) => {
+    const renamed = action.kind === ORGANIZATION_RENAME_KIND;
     const { name, kind } = action.payload;
+    const { organization } = action.payload;
     return {
         id: action.id,
         kind: "organization",
         status: actionStatus(action.status),
         project: null,
-        subject: `organization:new`,
+        subject: renamed ? organization : "organization:new",
         object: null,
-        summary: `add ${kind} ${name}`,
+        summary: renamed ? `rename ${organization} to ${name}` : `add ${kind} ${name}`,
         proposedBy: proposerOfAction(action),
         reason: action.reason,
         evidence: [],
@@ -27,13 +30,20 @@ export const proposeOrganization = (store, input, by, reason) => store.proposedA
     payload: input,
     ...(reason === undefined ? {} : { reason }),
 });
+/** An agent's rename waits as a stored proposal too; the organization keeps its name until it is confirmed. */
+export const proposeOrganizationRename = (store, input, by, reason) => store.proposedActions.propose({
+    kind: ORGANIZATION_RENAME_KIND,
+    by,
+    payload: input,
+    ...(reason === undefined ? {} : { reason }),
+});
 export const organizationKind = (store) => ({
     kind: "organization",
-    stored: [ORGANIZATION_ADD_KIND],
+    stored: [ORGANIZATION_ADD_KIND, ORGANIZATION_RENAME_KIND],
     list: async (filter) => {
         const status = storedStatus(filter);
         const actions = await store.proposedActions.list({
-            kinds: [ORGANIZATION_ADD_KIND],
+            kinds: [ORGANIZATION_ADD_KIND, ORGANIZATION_RENAME_KIND],
             ...(status === undefined ? {} : { status }),
             ...pushed(filter),
         });
@@ -45,7 +55,14 @@ export const organizationKind = (store) => ({
             await store.proposedActions.reject(id, by, reason);
             return { id, kind: "organization", status: "rejected", made: [] };
         }
-        const { name, kind, scope } = (await store.proposedActions.get(id)).payload;
+        const action = await store.proposedActions.get(id);
+        if (action.kind === ORGANIZATION_RENAME_KIND) {
+            const { organization, name } = action.payload;
+            const renamed = await store.knowledge.updateOrganization(organization, { name });
+            await store.proposedActions.approve(id, by, { organization: renamed.ref });
+            return { id, kind: "organization", status: "confirmed", made: [] };
+        }
+        const { name, kind, scope } = action.payload;
         const made = await store.knowledge.addOrganization({ name, kind, ...(scope === undefined ? {} : { scope }) });
         await store.proposedActions.approve(id, by, { organization: made.ref });
         return { id, kind: "organization", status: "confirmed", made: [made.ref] };

package/dist/store/knowledge-query.js

@@ -6,7 +6,13 @@ export const ORGANIZATIONS_QUERY = {
     backend: "sql",
     fields: queryFieldsOf(organization, {
         native: ["id", "kind", "scope", "created_at"],
-        examples: { id: "id:1", kind: "kind:company", scope: "scope:work", created_at: "created_at>=2026-01-01" },
+        examples: {
+            id: "id:1",
+            kind: "kind:company",
+            name: "name:*acme*",
+            scope: "scope:work",
+            created_at: "created_at>=2026-01-01",
+        },
     }),
 };
 export const PROJECTS_QUERY = {

package/dist/store/sqlite/knowledge.d.ts

@@ -5,6 +5,7 @@ import { type MeetingProjectsStore } from "./meeting-projects.js";
 import type { Author } from "./memories.js";
 import { type Link } from "./notes.js";
 import type { StoreContext } from "./open.js";
+import { type OrganizationsStore } from "./organizations.js";
 import type { ProposedAction } from "./proposed-actions.js";
 import { type KnowledgeRelation, type LinkDecision, type RelateInput, type RelationUpdate, type Scored } from "./relation-proposals.js";
 import type { TagCreationOptions } from "./tag-creation.js";
@@ -100,7 +101,7 @@ export interface Reminder {
     receipt: string | null;
 }
 export type LabelledType = "note" | "document" | "person" | "organization" | "project" | "task" | "meeting" | "folder";
-export interface KnowledgeStore extends VocabularyStore, MeetingProjectsStore {
+export interface KnowledgeStore extends VocabularyStore, MeetingProjectsStore, OrganizationsStore {
     taskIds(key: AccountKey, options?: {
         state?: "open" | "done" | "dismissed";
         limit?: number;
@@ -159,7 +160,6 @@ export interface KnowledgeStore extends VocabularyStore, MeetingProjectsStore {
         name: string;
         scope?: Organization["scope"];
     }): Promise<Organization>;
-    organizations(query?: QueryAst): Promise<Organization[]>;
     /** A project; its key is made from the name when none is given. */
     addProject(input: {
         name: string;

package/dist/store/sqlite/knowledge.js

@@ -14,6 +14,7 @@ import { linkKind, RELATION_KINDS } from "./link-kinds.js";
 import { meetingProjectsStoreOver } from "./meeting-projects.js";
 import { holdingText } from "./note-index.js";
 import { insertLink, linkOf } from "./notes.js";
+import { organizationOf, organizationsStoreOver } from "./organizations.js";
 import { queryFilter } from "./query-filter.js";
 import { relationOf, relationProposalsOver, } from "./relation-proposals.js";
 import { addTags as addThingTags, canonicalTagNamed, createTag, labelsOf, liveTagging, removeTags as removeThingTags, setMainTopic, } from "./tags.js";
@@ -205,14 +206,6 @@ export const knowledgeStoreOver = (context) => {
             throw new CliError("not_found", "no annotation with that id");
         return found;
     };
-    const organizationOf = (row) => ({
-        id: String(row.id),
-        ref: `organization:${row.id}`,
-        kind: row.kind,
-        name: String(row.name),
-        scope: row.scope,
-        createdAt: iso(row.created_at),
-    });
     const projectOf = (row) => ({
         id: String(row.id),
         ref: `project:${row.id}`,
@@ -294,6 +287,7 @@ export const knowledgeStoreOver = (context) => {
     const tagsOf = (list) => [...new Set(list.map(canonicalTagName))];
     return {
         ...vocabularyStoreOver(context),
+        ...organizationsStoreOver(context),
         ...meetingProjectsStoreOver(context),
         taskIds: async (key, options = {}) => {
             const { limit, offset } = bounded(options.limit, options.offset);
@@ -445,19 +439,6 @@ export const knowledgeStoreOver = (context) => {
                 .get(oneOf(kind, ORGANIZATION_KINDS, "an organization's kind"), textOf(name, 200), oneOf(scope, SCOPES, "a scope"), at, at);
             return organizationOf(row);
         },
-        organizations: async (query) => {
-            const where = query &&
-                queryFilter(query, {
-                    id: { type: "kw", sql: "CAST(id AS TEXT)" },
-                    kind: { type: "enum", sql: "kind" },
-                    scope: { type: "enum", sql: "scope" },
-                    created_at: { type: "time", sql: "created_at" },
-                });
-            return database
-                .prepare(`SELECT * FROM organizations WHERE deleted_at IS NULL${where ? ` AND (${where.sql})` : ""} ORDER BY name, id LIMIT 500`)
-                .all(...(where?.params ?? []))
-                .map(organizationOf);
-        },
         addProject: async ({ name, key, type = "other", organization, scope = "personal", description }) => write(database, () => {
             const title = textOf(name, 200);
             const organizationId = organization === undefined

package/dist/store/sqlite/organizations.d.ts

@@ -0,0 +1,14 @@
+import { type QueryAst } from "@wirecat/cli-base/query";
+import type { Organization } from "./knowledge.js";
+import type { StoreContext } from "./open.js";
+type Row = Record<string, unknown>;
+export declare const organizationOf: (row: Row) => Organization;
+export interface OrganizationsStore {
+    organizations(query?: QueryAst): Promise<Organization[]>;
+    /** Renames an organization given as `organization:<id>` or by its id; its kind and scope stay. */
+    updateOrganization(organization: string, input: {
+        name: string;
+    }): Promise<Organization>;
+}
+export declare const organizationsStoreOver: ({ database, now }: StoreContext) => OrganizationsStore;
+export {};

package/dist/store/sqlite/organizations.js

@@ -0,0 +1,48 @@
+import { CliError } from "@wirecat/cli-base";
+import { evaluate, walkQuery } from "@wirecat/cli-base/query";
+import { ORGANIZATIONS_QUERY } from "../knowledge-query.js";
+import { queryFilter } from "./query-filter.js";
+import { thingOf } from "./things.js";
+import { write } from "./transaction.js";
+export const organizationOf = (row) => ({
+    id: String(row.id),
+    ref: `organization:${row.id}`,
+    kind: row.kind,
+    name: String(row.name),
+    scope: row.scope,
+    createdAt: new Date(Number(row.created_at)).toISOString(),
+});
+export const organizationsStoreOver = ({ database, now }) => ({
+    organizations: async (query) => {
+        // `lower()` folds ASCII only and an organization has no folded copy, so a name filter runs on the rows.
+        if (query && walkQuery(query.root).some((node) => node.field === "name"))
+            return database.prepare("SELECT * FROM organizations WHERE deleted_at IS NULL ORDER BY name, id").all()
+                .map(organizationOf)
+                .filter((one) => evaluate(query, ORGANIZATIONS_QUERY.fields, { ...one, created_at: one.createdAt }))
+                .slice(0, 500);
+        const where = query &&
+            queryFilter(query, {
+                id: { type: "kw", sql: "CAST(id AS TEXT)" },
+                kind: { type: "enum", sql: "kind" },
+                scope: { type: "enum", sql: "scope" },
+                created_at: { type: "time", sql: "created_at" },
+            });
+        return database
+            .prepare(`SELECT * FROM organizations WHERE deleted_at IS NULL${where ? ` AND (${where.sql})` : ""} ORDER BY name, id LIMIT 500`)
+            .all(...(where?.params ?? []))
+            .map(organizationOf);
+    },
+    updateOrganization: async (organization, { name }) => write(database, () => {
+        const title = name.trim();
+        if (!title || title.length > 200)
+            throw new CliError("validation_error", "text takes 1–200 characters");
+        const thing = thingOf(database, organization.includes(":") ? organization : `organization:${organization}`);
+        const row = thing?.type === "organization" &&
+            database
+                .prepare("UPDATE organizations SET name = ?, updated_at = ? WHERE id = ? AND deleted_at IS NULL RETURNING *")
+                .get(title, now(), thing.id);
+        if (!row)
+            throw new CliError("not_found", `no organization ${organization}`);
+        return organizationOf(row);
+    }),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.580.0",
+  "version": "0.582.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",