@wirecat/cli-core 0.584.0 → 0.585.0

package/CHANGELOG.md

@@ -7,6 +7,17 @@ shape of this file.
 
 ## Unreleased
 
+## 0.585.0 — 06.11.2026
+
+### Added
+
+- **Deals in the store (store version 52).** `store.deals` keeps the owner's sales pipelines (`pipelines`,
+  `pipeline_stages`, made by the owner only) and the deals in them (table `opportunities`, ref `deal:<id>`): title,
+  organization, project, stage, status `open`, `won` or `lost` kept apart from the stage, the expected amount in minor
+  units with its currency, the expected close day and the day it closed. The people on a deal are `related-to` links
+  with a role (`owner`, `contact`, `decision-maker`). The owner's deal is confirmed at once; an agent's is a `deal`
+  proposal only the owner decides. Only the owner moves a deal, within its own pipeline, or closes it.
+
 ## 0.584.0 — 06.11.2026
 
 ### Added

package/dist/cli/messenger/store-maintenance-command.d.ts

@@ -3,9 +3,9 @@ import type { CacheDatabase } from "../../store/driver.js";
 import type { Messenger } from "./context.js";
 /** `doctor`'s short summary of the store. Must answer for a broken file, so an error is a field. */
 export declare const storeSummary: (env: NodeJS.ProcessEnv) => Promise<{
+    error?: undefined;
     path: string;
     exists: boolean;
-    error?: undefined;
 } | {
     path: string;
     exists: boolean;

package/dist/domain/deals.d.ts

@@ -0,0 +1,20 @@
+import type { FinanceReview } from "./finance.js";
+/** Whether a deal ended, kept apart from the stage it stands in. */
+export declare const DEAL_STATUSES: readonly ["open", "won", "lost"];
+/** The part a person plays on a deal: the owner's side runs it, the client's side talks or decides. */
+export declare const DEAL_ROLES: readonly ["owner", "contact", "decision-maker"];
+export type DealStatus = (typeof DEAL_STATUSES)[number];
+export type DealRole = (typeof DEAL_ROLES)[number];
+export interface DealTitleFields {
+    id: number;
+    title: string;
+    stage: string;
+    amount: number | null;
+    currency: string | null;
+    status: DealStatus;
+    review: FinanceReview;
+}
+/** "Site redesign · Proposal, 500 000.00 RUB": a ref summary's title, which `refLabel` prefixes. */
+export declare const dealLine: (deal: DealTitleFields) => string;
+/** "Deal Site redesign · Proposal, 500 000.00 RUB (won)". */
+export declare const dealTitle: (deal: DealTitleFields) => string;

package/dist/domain/deals.js

@@ -0,0 +1,15 @@
+import { moneyLabel } from "./money.js";
+/** Whether a deal ended, kept apart from the stage it stands in. */
+export const DEAL_STATUSES = ["open", "won", "lost"];
+/** The part a person plays on a deal: the owner's side runs it, the client's side talks or decides. */
+export const DEAL_ROLES = ["owner", "contact", "decision-maker"];
+/** "Site redesign · Proposal, 500 000.00 RUB": a ref summary's title, which `refLabel` prefixes. */
+export const dealLine = (deal) => {
+    const money = deal.amount === null || deal.currency === null ? "" : `, ${moneyLabel(deal.amount, deal.currency)}`;
+    const notes = [deal.status === "open" ? null : deal.status, deal.review === "confirmed" ? null : deal.review]
+        .filter(Boolean)
+        .join(", ");
+    return `${deal.title} · ${deal.stage}${money}${notes ? ` (${notes})` : ""}`;
+};
+/** "Deal Site redesign · Proposal, 500 000.00 RUB (won)". */
+export const dealTitle = (deal) => `Deal ${dealLine(deal)}`;

package/dist/domain/ref-summaries.js

@@ -52,6 +52,7 @@ const WORDS = {
     invoice: "Invoice",
     payment: "Payment",
     order: "Order",
+    deal: "Deal",
     email: "Email",
     email_thread: "Email thread",
     unknown: "Unknown",

package/dist/domain/references.d.ts

@@ -33,7 +33,7 @@ export type Reference = {
  * Things named by their store id (a task also by its key or the task package's id). `entity` is the name
  * before organizations and projects: it still parses, so an old file's reference resolves as not found.
  */
-export declare const SIMPLE_REFERENCES: readonly ["note", "document", "person", "organization", "project", "task", "memory", "fact", "bot", "event", "invoice", "payment", "order", "entity"];
+export declare const SIMPLE_REFERENCES: readonly ["note", "document", "person", "organization", "project", "task", "memory", "fact", "bot", "event", "invoice", "payment", "order", "deal", "entity"];
 export type SimpleReference = (typeof SIMPLE_REFERENCES)[number];
 export type RefKindName = Exclude<Reference["type"], "entity">;
 export interface RefKindSpec<R extends Reference = Reference> {

package/dist/domain/references.js

@@ -19,6 +19,7 @@ export const SIMPLE_REFERENCES = [
     "invoice",
     "payment",
     "order",
+    "deal",
     "entity",
 ];
 const malformed = (text, shape) => new CliError("validation_error", `"${singleLine(text)}" is not a reference — expected ${shape}`, {

package/dist/errors/reasons.js

@@ -203,6 +203,14 @@ const OTHERS = [
     validation("money.amount", "the amount is not a decimal string in the currency's scale"),
     validation("money.currency", "the currency is not one the store keeps money in"),
     validation("money.quantity", "the quantity is not a decimal above 0"),
+    validation("deal.closed", "a won, lost, rejected or deleted deal does not move or close again"),
+    validation("deal.field", "a field of the deal is not valid"),
+    ["deal.owner-only", "permission_error", "only the owner moves or closes a deal, or makes a pipeline"],
+    validation("deal.ref", "the reference names no deal"),
+    validation("deal.stage", "no stage of that name, or a stage name more than one pipeline has"),
+    validation("pipeline.duplicate", "a pipeline of that name is already stored"),
+    validation("pipeline.field", "a pipeline needs a name and at least one stage, each named once"),
+    ["pipeline.not-found", "not_found", "no stored pipeline has that name"],
     validation("order.duplicate", "the shop's order with this number is already stored; change its status instead"),
     validation("order.proposed", "the shop's order with this number already waits for the owner in a findings batch"),
     validation("order.field", "a field of the order is not valid"),

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { bareCheck, type CheckWords, checkWords } from "./domain/checks.js";
 export type { CounterField, CounterObservation, CounterObservations, CounterState } from "./domain/counters.js";
 export { COUNTER_FIELDS, counterValue, observedCounters } from "./domain/counters.js";
+export { DEAL_ROLES, DEAL_STATUSES, type DealRole, type DealStatus } from "./domain/deals.js";
 export { FINANCE_REVIEWS, type FinanceReview, INVOICE_DIRECTIONS, INVOICE_STATUSES, type InvoiceDirection, type InvoiceStatus, MONEY_DIRECTIONS, type MoneyDirection, } from "./domain/finance.js";
 export { type FormattedText, type HtmlFormatting, type MarkdownFormatting, type TextSpan, validateFormattedText, } from "./domain/formatting.js";
 export { formatLocator, isLocator, type MessageLocator, parseLocator } from "./domain/locator.js";

package/dist/index.js

@@ -1,5 +1,6 @@
 export { bareCheck, checkWords } from "./domain/checks.js";
 export { COUNTER_FIELDS, counterValue, observedCounters } from "./domain/counters.js";
+export { DEAL_ROLES, DEAL_STATUSES } from "./domain/deals.js";
 export { FINANCE_REVIEWS, INVOICE_DIRECTIONS, INVOICE_STATUSES, MONEY_DIRECTIONS, } from "./domain/finance.js";
 export { validateFormattedText, } from "./domain/formatting.js";
 export { formatLocator, isLocator, parseLocator } from "./domain/locator.js";

package/dist/meetings/mcp/index.d.ts

@@ -38,7 +38,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -54,11 +53,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -76,11 +75,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -102,6 +101,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -188,7 +188,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -204,11 +203,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -226,11 +225,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -252,6 +251,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -338,7 +338,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -354,11 +353,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -376,11 +375,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -402,6 +401,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -488,7 +488,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -504,11 +503,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -526,11 +525,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -552,6 +551,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -638,7 +638,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -654,11 +653,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -676,11 +675,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -702,6 +701,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;

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

@@ -0,0 +1,4 @@
+import type { MessageStore } from "../../../store/index.js";
+import type { ProposalKind } from "../types.js";
+/** An agent's deal, by its own ref (`deal:12`) as orders are; only the owner decides it. */
+export declare const dealKind: (store: Pick<MessageStore, "deals">) => ProposalKind;

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

@@ -0,0 +1,32 @@
+import { kept, proposerOfAuthor, pushed } from "./shared.js";
+const rowOf = (deal) => ({
+    id: deal.ref,
+    kind: "deal",
+    status: deal.review,
+    project: deal.project,
+    subject: deal.ref,
+    object: deal.organization?.ref ?? null,
+    summary: `Deal ${deal.summary}`,
+    proposedBy: proposerOfAuthor(deal.author),
+    reason: deal.reason,
+    evidence: [],
+    score: null,
+    signals: null,
+    parts: null,
+    createdAt: deal.createdAt,
+});
+/** An agent's deal, by its own ref (`deal:12`) as orders are; only the owner decides it. */
+export const dealKind = (store) => ({
+    kind: "deal",
+    prefix: "deal",
+    list: async (filter) => {
+        const status = filter.status ?? "proposed";
+        const deals = await store.deals.list({ ...pushed(filter), ...(status === "all" ? {} : { review: status }) });
+        return kept(deals.map(rowOf), filter);
+    },
+    get: async (id) => rowOf(await store.deals.get(id)),
+    decide: async (id, { confirm, by, reason }) => {
+        const deal = confirm ? await store.deals.confirm(id, by, reason) : await store.deals.reject(id, by, reason);
+        return { id, kind: "deal", status: confirm ? "confirmed" : "rejected", made: confirm ? [deal.ref] : [] };
+    },
+});

package/dist/services/proposals/registry.js

@@ -1,6 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { mayDecide } from "../../store/decisions.js";
 import { actionKind } from "./kinds/action.js";
+import { dealKind } from "./kinds/deals.js";
 import { factKind } from "./kinds/fact.js";
 import { invoiceKind, paymentKind } from "./kinds/finance.js";
 import { findingsKind } from "./kinds/findings.js";
@@ -135,6 +136,7 @@ export const proposalRegistry = (store) => {
         invoiceKind(store),
         paymentKind(store),
         orderKind(store),
+        dealKind(store),
         organizationKind(store),
         memoryKind(store),
         findingsKind(store),

package/dist/store/index.d.ts

@@ -34,6 +34,7 @@ export type { BotUpdate, BotUpdateStore } from "./sqlite/bot-updates.js";
 export type { CatalogActor, CatalogEntry, CatalogInput, CatalogQuery, CatalogStore } from "./sqlite/catalog.js";
 export { CATALOG_QUERY } from "./sqlite/catalog.js";
 export type { ChatMetadata } from "./sqlite/chats.js";
+export type { Deal, DealFilter, DealInput, DealPerson, DealsStore, Pipeline, PipelineStage, } from "./sqlite/deals.js";
 export type { Email, EmailAddress, EmailAttachment, EmailFacts, EmailFilter, EmailInput, EmailInThread, EmailLocationInput, EmailRecipient, EmailRef, EmailThread, EmailVectorHit, FolderEmail, Mailbox, MailboxInput, MailFilter, MailStore, PartialEmail, SenderScore, ThreadDetails, ThreadSave, } from "./sqlite/emails.js";
 export { EVENT_FIELDS, type EventChunkToEmbed, type EventHit, type EventQuery, type EventSearch, type NearestEvent, } from "./sqlite/event-search.js";
 export type { EvidenceSource } from "./sqlite/evidence-sources.js";

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

@@ -0,0 +1,104 @@
+import { type DealRole, type DealStatus } from "../../domain/deals.js";
+import { type FinanceReview } from "../../domain/finance.js";
+import { type Decider } from "../decisions.js";
+import { type ProposedByFilter } from "./actors.js";
+import { type Party, type Reviewed, type Written } from "./finance.js";
+import { type Author } from "./memories.js";
+import type { StoreContext } from "./open.js";
+export interface PipelineStage {
+    name: string;
+    position: number;
+    /** Open deals standing in it, the owner's and agents' not rejected. */
+    open: number;
+}
+export interface Pipeline {
+    name: string;
+    stages: PipelineStage[];
+    createdAt: string;
+}
+export interface DealPerson extends Party {
+    role: DealRole;
+}
+export interface Deal extends Reviewed {
+    id: string;
+    ref: string;
+    title: string;
+    /** One line with stage, amount and status, as a list or the review inbox prints it. */
+    summary: string;
+    pipeline: string;
+    stage: string;
+    status: DealStatus;
+    organization: Party | null;
+    /** Both `null` when no amount is expected yet. */
+    currency: string | null;
+    amount: string | null;
+    /** `YYYY-MM-DD`: the day it is expected to close. */
+    closeDate: string | null;
+    /** `YYYY-MM-DD`: the day it was won or lost. */
+    closedDate: string | null;
+    /** Why it was won or lost, as the owner said when closing it. */
+    closedReason: string | null;
+    people: DealPerson[];
+}
+export interface DealInput extends Written {
+    title: string;
+    /** A stage's name; `pipeline` names its pipeline when more than one has a stage of that name. */
+    stage: string;
+    pipeline?: string;
+    organization?: string;
+    /** A decimal string in `currency`; give both or neither. */
+    amount?: string;
+    currency?: string;
+    closeDate?: string;
+    people?: {
+        person: string;
+        role: DealRole;
+    }[];
+}
+export interface DealFilter {
+    status?: DealStatus;
+    /** A stage's or pipeline's name, in any letter case. */
+    stage?: string;
+    pipeline?: string;
+    project?: string;
+    organization?: string;
+    review?: FinanceReview;
+    proposedBy?: ProposedByFilter;
+    /** 1–500, 100 by default; newest written first. */
+    limit?: number;
+}
+/**
+ * The owner's sales pipelines and the deals in them. The owner's deal is confirmed at once; an agent's waits as
+ * proposed for him, and only he decides it. Only the owner makes a pipeline, moves a deal or closes it.
+ */
+export interface DealsStore {
+    addPipeline(input: {
+        name: string;
+        stages: string[];
+        by: Author;
+    }): Promise<Pipeline>;
+    pipelines(): Promise<Pipeline[]>;
+    add(input: DealInput): Promise<Deal>;
+    get(reference: string): Promise<Deal>;
+    list(filter?: DealFilter): Promise<Deal[]>;
+    /** To another stage of the deal's own pipeline. */
+    move(reference: string, input: {
+        stage: string;
+        by: Author;
+    }): Promise<Deal>;
+    /** `date` is the day it closed, today when left out. */
+    close(reference: string, input: {
+        status: Exclude<DealStatus, "open">;
+        date?: string;
+        reason?: string;
+        by: Author;
+    }): Promise<Deal>;
+    confirm(reference: string, by: Decider, reason?: string): Promise<Deal>;
+    reject(reference: string, by: Decider, reason?: string): Promise<Deal>;
+}
+type DealOperations = {
+    [K in keyof DealsStore]: DealsStore[K] extends (...args: infer A) => Promise<infer R> ? (...args: A) => R : never;
+};
+export declare const dealOperationsOver: (context: StoreContext) => DealOperations;
+export declare const dealsStoreOver: (context: StoreContext) => DealsStore;
+export {};