@wirecat/cli-core 0.548.0 → 0.550.0

package/dist/store/sqlite/relation-proposals.js

@@ -1,10 +1,23 @@
 import { CliError } from "@wirecat/cli-base";
 import { assertMayDecide, deciderAuthor } from "../decisions.js";
 import { actorOfOrigin, botNamed, ownerPerson } from "./actors.js";
-import { insertLink, linkOf } from "./notes.js";
+import { insertLink, linkOf, purposeOf } from "./notes.js";
 import { proposalOperationsOver, proposerOfAction } from "./proposed-actions.js";
 import { thingOf } from "./things.js";
 import { write } from "./transaction.js";
+export const relationOf = (link) => ({
+    id: link.id,
+    from: link.from,
+    to: String(link.to),
+    kind: link.kind,
+    role: link.role,
+    purpose: link.purpose,
+    evidence: link.evidence,
+    confirmed: link.confirmed,
+    provenance: link.provenance,
+    confidenceCategory: link.confirmed ? "owner-confirmed" : "weak",
+    createdAt: link.createdAt,
+});
 /** `relationship` proposals in `proposed_actions`: an agent's or a rule's, and the rejected ones a scan skips. */
 export const relationProposalsOver = (context) => {
     const { database, now } = context;
@@ -26,6 +39,14 @@ export const relationProposalsOver = (context) => {
             "VALUES ('relationship', ?, ?, ?, ?, 'rejected', ?, ?, ?, ?, ?, ?, ?, ?)")
             .run(from?.type ?? null, from?.id ?? null, JSON.stringify({ from: link.from, to: link.to, kind: link.kind, ...(link.role ? { role: link.role } : {}) }), link.evidence, proposed.type, proposed.id, decided.type, decided.id, at, JSON.stringify({ reason: why.join(": "), link: link.id }), at, at);
     };
+    const applyUpdate = (link, input) => {
+        const changes = changesOf(input);
+        database
+            .prepare("UPDATE links SET role = CASE WHEN ? THEN ? ELSE role END, purpose = CASE WHEN ? THEN ? ELSE purpose END, " +
+            "updated_at = ? WHERE id = ?")
+            .run(Number("role" in changes), changes.role ?? null, Number("purpose" in changes), changes.purpose ?? null, now(), Number(link.id));
+        return linkOf(database, database.prepare("SELECT * FROM links WHERE id = ?").get(Number(link.id)));
+    };
     return {
         /** The same pending pair returns the proposal already held. */
         propose: (from, input, by) => {
@@ -48,6 +69,7 @@ export const relationProposalsOver = (context) => {
                         to: input.to,
                         kind: input.kind,
                         ...(input.role === undefined ? {} : { role: input.role }),
+                        ...(input.purpose === undefined ? {} : { purpose: purposeOf(input.purpose) }),
                         evidence,
                     },
                     ...(input.reason === undefined ? {} : { reason: input.reason }),
@@ -55,6 +77,53 @@ export const relationProposalsOver = (context) => {
             });
         },
         rejected: (link, by, reason) => rejected(link, by, reason),
+        update: (link, input) => write(database, () => applyUpdate(link, input)),
+        proposeUpdate: (link, input, by) => {
+            const changes = changesOf(input);
+            return write(database, () => {
+                const from = thingOf(database, link.from);
+                const held = database
+                    .prepare("SELECT id FROM proposed_actions WHERE kind='relationship_update' AND status='proposed' AND target_type=? " +
+                    "AND target_id=? AND json_extract(payload,'$.relationship')=? AND json_extract(payload,'$.changes')=json(?) " +
+                    "ORDER BY id LIMIT 1")
+                    .get(from?.type ?? null, from?.id ?? null, link.id, JSON.stringify(changes));
+                if (held)
+                    return operations.get(String(held.id));
+                return operations.propose({
+                    kind: "relationship_update",
+                    by,
+                    target: link.from,
+                    payload: {
+                        relationship: link.id,
+                        from: link.from,
+                        to: link.to,
+                        kind: link.kind,
+                        changes,
+                        before: { role: link.role, purpose: link.purpose },
+                    },
+                    ...(input.reason === undefined ? {} : { reason: input.reason }),
+                });
+            });
+        },
+        decideUpdate: (id, decision) => write(database, () => {
+            const proposal = operations.get(id);
+            if (proposal.kind !== "relationship_update")
+                throw new CliError("validation_error", `${id} is a ${proposal.kind} proposal, not a relationship change`);
+            assertMayDecide({ id, proposedBy: proposerOfAction(proposal) }, decision.by, context.decisions);
+            const author = deciderAuthor(decision.by);
+            const reason = decision.reason?.trim() || undefined;
+            if (!decision.confirm)
+                return { proposal: operations.reject(id, author, reason === undefined ? undefined : { reason }), link: null };
+            const payload = proposal.payload;
+            const row = database.prepare("SELECT * FROM links WHERE id = ?").get(Number(payload.relationship));
+            if (!row)
+                throw new CliError("not_found", `relationship ${payload.relationship} is gone`);
+            const link = applyUpdate(linkOf(database, row), payload.changes);
+            return {
+                proposal: operations.approve(id, { relationship: link.id, ...(reason === undefined ? {} : { reason }) }, author),
+                link,
+            };
+        }),
         /**
          * Decides a stored `relationship` or `key_document` proposal in one transaction: the confirmed link and the
          * decision land together or not at all.
@@ -75,6 +144,7 @@ export const relationProposalsOver = (context) => {
                 to: String(key ? payload.project : payload.to),
                 kind: key ? "related-to" : (payload.kind ?? "member-of"),
                 ...(key ? { role: "key" } : payload.role === undefined ? {} : { role: payload.role }),
+                ...(key || payload.purpose === undefined ? {} : { purpose: payload.purpose }),
                 ...(proposal.reason === null ? {} : { evidence: proposal.reason }),
                 ...decidedOrigin(decision.by),
             });
@@ -104,6 +174,23 @@ export const relationProposalsOver = (context) => {
         }),
     };
 };
+/** What a relationship update sets, checked; `null` clears a field and an absent one is left alone. */
+const changesOf = (input) => {
+    const changes = {};
+    if (input.role !== undefined)
+        changes.role = input.role === null ? null : roleOf(input.role);
+    if (input.purpose !== undefined)
+        changes.purpose = input.purpose === null ? null : purposeOf(input.purpose);
+    if (!Object.keys(changes).length)
+        throw new CliError("validation_error", "a relationship update sets a role, a purpose or both");
+    return changes;
+};
+const roleOf = (role) => {
+    const value = role.trim();
+    if (!value || value.length > 200)
+        throw new CliError("validation_error", "a role takes 1–200 characters");
+    return value;
+};
 /** A link an agent confirmed for the owner says so in its provenance. */
 const decidedOrigin = (by) => by === "owner"
     ? { origin: "owner" }

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

@@ -14757,6 +14757,22 @@ export declare const links: import("drizzle-orm/sqlite-core").SQLiteTableWithCol
             identity: undefined;
             generated: undefined;
         }, {}>;
+        purpose: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "links";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
     };
     dialect: 'sqlite';
     isAlias: false;

package/dist/store/sqlite/schema.js

@@ -1475,6 +1475,7 @@ export const links = sqliteTable("links", {
     createdAt: integer("created_at").notNull(),
     author: text("author"),
     updatedAt: integer("updated_at").notNull(),
+    purpose: text("purpose"),
 }, (table) => [
     index("links_unresolved").on(table.targetFolded).where(sql `to_id IS NULL`),
     index("links_by_from_type_from_id").on(table.fromType, table.fromId),

package/dist/store/sqlite/suggested-links.d.ts

@@ -0,0 +1,10 @@
+import type { CacheDatabase } from "../driver.js";
+/** Set by store version 44 and deleted once the move ran. */
+export declare const SUGGESTED_LINKS_TO_MOVE = "suggested_links_to_move";
+/**
+ * Moves the unconfirmed agent and rule links into `proposed_actions` as `relationship` and `key_document`
+ * proposals, with their bot, reason and time, so `links` holds what the owner confirmed. The moved row keeps the
+ * link's provenance under `suggestedLink`, which marks its proposer unverified: only the owner decides it. A
+ * suggestion an older build writes later stays a link, and the proposal kinds still list it.
+ */
+export declare const moveSuggestedLinks: (database: CacheDatabase, now: () => number) => number;

package/dist/store/sqlite/suggested-links.js

@@ -0,0 +1,68 @@
+import { botNamed } from "./actors.js";
+import { linkOf } from "./notes.js";
+import { write } from "./transaction.js";
+/** Set by store version 44 and deleted once the move ran. */
+export const SUGGESTED_LINKS_TO_MOVE = "suggested_links_to_move";
+/**
+ * An agent's `agent:<bot>` or a rule's `rule:<id>` suggestion. A rule becomes the seeded bot `rule`, since the text
+ * does not say which tool ran it; anything else (Drive's editor links) is a record, not a proposal, and stays.
+ */
+const proposerOf = (provenance) => {
+    if (provenance?.startsWith("rule:"))
+        return { name: "rule", kind: "rule" };
+    if (!provenance?.startsWith("agent:"))
+        return undefined;
+    const name = provenance.slice("agent:".length).split(/[\s;]/, 1)[0] ?? "";
+    return { name: name && name.length <= 100 ? name : "agent", kind: "agent" };
+};
+/**
+ * Moves the unconfirmed agent and rule links into `proposed_actions` as `relationship` and `key_document`
+ * proposals, with their bot, reason and time, so `links` holds what the owner confirmed. The moved row keeps the
+ * link's provenance under `suggestedLink`, which marks its proposer unverified: only the owner decides it. A
+ * suggestion an older build writes later stays a link, and the proposal kinds still list it.
+ */
+export const moveSuggestedLinks = (database, now) => {
+    if (!database.prepare("SELECT 1 AS found FROM store_settings WHERE key = ?").get(SUGGESTED_LINKS_TO_MOVE))
+        return 0;
+    return write(database, () => {
+        const rows = database
+            .prepare("SELECT * FROM links WHERE confirmed = 0 AND to_id IS NOT NULL AND kind IN ('member-of', 'related-to') ORDER BY id")
+            .all();
+        const at = now();
+        let moved = 0;
+        for (const row of rows) {
+            const link = linkOf(database, row);
+            const proposer = proposerOf(link.provenance);
+            const key = link.role === "key";
+            if (!proposer || !link.from || !link.to || (key && !link.to.startsWith("project:")))
+                continue;
+            const kind = key ? "key_document" : "relationship";
+            const held = database
+                .prepare("SELECT id FROM proposed_actions WHERE kind = ? AND status = 'proposed' AND target_type = ? AND target_id = ? " +
+                "AND json_extract(payload, ?) = ?")
+                .get(kind, row.from_type, row.from_id, key ? "$.project" : "$.to", link.to);
+            if (!held) {
+                const bot = botNamed(database, proposer.name, at, proposer.kind);
+                const suggestedLink = { id: link.id, provenance: link.provenance };
+                const payload = key
+                    ? { ref: link.from, project: link.to, suggestedLink }
+                    : {
+                        from: link.from,
+                        to: link.to,
+                        kind: link.kind,
+                        ...(link.role === null ? {} : { role: link.role }),
+                        evidence: [],
+                        suggestedLink,
+                    };
+                database
+                    .prepare("INSERT INTO proposed_actions (kind, target_type, target_id, payload, reason, status, proposed_by_type, " +
+                    "proposed_by_id, created_at, updated_at) VALUES (?, ?, ?, ?, ?, 'proposed', ?, ?, ?, ?)")
+                    .run(kind, row.from_type, row.from_id, JSON.stringify(payload), link.evidence, bot.type, bot.id, row.created_at, at);
+            }
+            database.prepare("DELETE FROM links WHERE id = ?").run(Number(row.id));
+            moved += 1;
+        }
+        database.prepare("DELETE FROM store_settings WHERE key = ?").run(SUGGESTED_LINKS_TO_MOVE);
+        return moved;
+    });
+};

package/dist/store/store.d.ts

@@ -1,4 +1,5 @@
 import type { ContextEvidenceReader, ContextIndex, ContextRecordReader } from "../context/evidence.js";
+import type { RefsStore } from "../domain/ref-summaries.js";
 import type { EventStore } from "../meetings/index.js";
 import { type AccountStore } from "./account-store.js";
 import { type AccountsStore } from "./accounts.js";
@@ -91,6 +92,8 @@ export interface MessageStore {
     readonly meetingFindings: MeetingFindingsStore;
     /** Cited facts and follow-ups about one project from stored messages, mail and documents, for review. */
     readonly evidenceFindings: EvidenceFindingsStore;
+    /** What any ref names, a page of them at a time: read once per page, never once per row. */
+    readonly refs: RefsStore;
     readonly facts: FactsStore;
     /** What agents concluded: summaries, digests, facts, preferences, each with evidence and a scope. */
     readonly memories: MemoriesStore;

package/dist/store/store.js

@@ -37,6 +37,7 @@ import { notesStoreOver } from "./sqlite/notes.js";
 import { openStoreContext } from "./sqlite/open-store.js";
 import { projectAnnotationStoreOver } from "./sqlite/project-transfer/store.js";
 import { proposedActionsStoreOver } from "./sqlite/proposed-actions.js";
+import { refSummariesOf } from "./sqlite/ref-summaries.js";
 import * as stems from "./sqlite/stems.js";
 import { taskStoreOver } from "./sqlite/tasks.js";
 import { syncStoreOver } from "./sync.js";
@@ -105,6 +106,9 @@ const storeOver = (context) => {
     const calendar = once(() => ({ ...eventStoreOver(context), ...eventSearchOver(context) }));
     const meetingFindings = once(() => meetingFindingsStoreOver(context));
     const evidenceFindings = once(() => evidenceFindingsStoreOver(context));
+    const refs = {
+        summaries: async (texts, options) => refSummariesOf(context.database, texts, options),
+    };
     const facts = once(() => factsStoreOver(context));
     const memories = once(() => memoriesStoreOver(context));
     const proposedActions = once(() => proposedActionsStoreOver(context));
@@ -199,6 +203,7 @@ const storeOver = (context) => {
         get meetingFindings() {
             return meetingFindings();
         },
+        refs,
         get evidenceFindings() {
             return evidenceFindings();
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.548.0",
+  "version": "0.550.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",
@@ -251,7 +251,7 @@
     "@types/node": "^22.20.5",
     "@types/pngjs": "6.0.5",
     "@vitest/coverage-v8": "^5.0.5",
-    "@wirecat/cli-base": "0.73.0",
+    "@wirecat/cli-base": "0.74.0",
     "@wirecat/cli-core-legacy-tags": "npm:@wirecat/cli-core@0.414.0",
     "commander": "15.0.0",
     "cspell": "10.4.0",
@@ -271,7 +271,7 @@
   },
   "peerDependencies": {
     "@napi-rs/canvas": ">=0.1.69 <2",
-    "@wirecat/cli-base": ">=0.73.0 <0.74.0",
+    "@wirecat/cli-base": ">=0.74.0 <0.75.0",
     "commander": ">=15"
   },
   "bin": {

package/parity.json

@@ -242,6 +242,9 @@
       "value": "<post>",
       "meaning": "comment on this channel post; the comment goes to the post's discussion group"
     },
+    "--compact": {
+      "meaning": "one line per item, built from the same answer as --json, with its paging and next steps as # lines"
+    },
     "--component": {
       "value": "<name>",
       "meaning": "the ranking component whose contributing messages or answer pairs to read"
@@ -1131,6 +1134,7 @@
   },
   "globalOptions": {
     "--brief": "all",
+    "--compact": "all",
     "--debug": "all",
     "--dry-run": "all",
     "--full": "all",