@wirecat/cli-core 0.581.0 → 0.582.0

package/CHANGELOG.md

@@ -5,7 +5,21 @@ 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.
 
-## Unreleased
+## 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
 

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.581.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",