@wirecat/cli-core 0.555.0 → 0.557.0

package/dist/store/sqlite/schema.js

@@ -1394,6 +1394,104 @@ export const facts = sqliteTable("facts", {
     index("facts_by_author_type_author_id").on(table.authorType, table.authorId),
     index("facts_by_confirmed_by_type_confirmed_by_id").on(table.confirmedByType, table.confirmedById),
 ]);
+/** An invoice the owner issued or received; its total is the sum of its lines, its status follows allocations. */
+export const invoices = sqliteTable("invoices", {
+    id: integer("id").primaryKey(),
+    direction: text("direction").notNull(),
+    number: text("number"),
+    issuerType: text("issuer_type"),
+    issuerId: integer("issuer_id"),
+    counterpartyType: text("counterparty_type").notNull(),
+    counterpartyId: integer("counterparty_id").notNull(),
+    projectId: integer("project_id").references(() => projects.id),
+    currency: text("currency").notNull(),
+    /** Minor units of `currency`. */
+    total: integer("total").notNull(),
+    issueDate: text("issue_date"),
+    dueDate: text("due_date"),
+    status: text("status").notNull(),
+    review: text("review").notNull(),
+    authorType: text("author_type").notNull(),
+    authorId: integer("author_id").notNull(),
+    model: text("model"),
+    confirmedByType: text("confirmed_by_type"),
+    confirmedById: integer("confirmed_by_id"),
+    source: text("source").notNull(),
+    metadata: text("metadata"),
+    createdAt: integer("created_at").notNull(),
+    updatedAt: integer("updated_at").notNull(),
+    deletedAt: integer("deleted_at"),
+}, (table) => [
+    index("invoices_by_issuer_type_issuer_id").on(table.issuerType, table.issuerId),
+    index("invoices_by_counterparty_type_counterparty_id").on(table.counterpartyType, table.counterpartyId),
+    index("invoices_by_project_id").on(table.projectId),
+    index("invoices_by_author_type_author_id").on(table.authorType, table.authorId),
+    index("invoices_by_confirmed_by_type_confirmed_by_id").on(table.confirmedByType, table.confirmedById),
+]);
+export const invoiceLines = sqliteTable("invoice_lines", {
+    id: integer("id").primaryKey(),
+    invoiceId: integer("invoice_id")
+        .notNull()
+        .references(() => invoices.id),
+    position: integer("position").notNull(),
+    description: text("description").notNull(),
+    /** A decimal as text: never a float. */
+    quantity: text("quantity").notNull(),
+    unitPrice: integer("unit_price"),
+    amount: integer("amount").notNull(),
+    createdAt: integer("created_at").notNull(),
+    updatedAt: integer("updated_at").notNull(),
+}, (table) => [unique().on(table.invoiceId, table.position)]);
+/** Money that moved to or from the owner, in minor units of its currency. */
+export const payments = sqliteTable("payments", {
+    id: integer("id").primaryKey(),
+    direction: text("direction").notNull(),
+    payerType: text("payer_type"),
+    payerId: integer("payer_id"),
+    payeeType: text("payee_type"),
+    payeeId: integer("payee_id"),
+    amount: integer("amount").notNull(),
+    currency: text("currency").notNull(),
+    paymentDate: text("payment_date").notNull(),
+    reference: text("reference"),
+    projectId: integer("project_id").references(() => projects.id),
+    review: text("review").notNull(),
+    authorType: text("author_type").notNull(),
+    authorId: integer("author_id").notNull(),
+    model: text("model"),
+    confirmedByType: text("confirmed_by_type"),
+    confirmedById: integer("confirmed_by_id"),
+    source: text("source").notNull(),
+    metadata: text("metadata"),
+    createdAt: integer("created_at").notNull(),
+    updatedAt: integer("updated_at").notNull(),
+    deletedAt: integer("deleted_at"),
+}, (table) => [
+    index("payments_by_payer_type_payer_id").on(table.payerType, table.payerId),
+    index("payments_by_payee_type_payee_id").on(table.payeeType, table.payeeId),
+    index("payments_by_project_id").on(table.projectId),
+    index("payments_by_author_type_author_id").on(table.authorType, table.authorId),
+    index("payments_by_confirmed_by_type_confirmed_by_id").on(table.confirmedByType, table.confirmedById),
+]);
+/** How much of a payment settles an invoice; triggers keep it within both and in one currency. */
+export const paymentAllocations = sqliteTable("payment_allocations", {
+    id: integer("id").primaryKey(),
+    paymentId: integer("payment_id")
+        .notNull()
+        .references(() => payments.id),
+    invoiceId: integer("invoice_id")
+        .notNull()
+        .references(() => invoices.id),
+    amount: integer("amount").notNull(),
+    authorType: text("author_type").notNull(),
+    authorId: integer("author_id").notNull(),
+    createdAt: integer("created_at").notNull(),
+    updatedAt: integer("updated_at").notNull(),
+}, (table) => [
+    unique().on(table.paymentId, table.invoiceId),
+    index("payment_allocations_by_invoice_id").on(table.invoiceId),
+    index("payment_allocations_by_author_type_author_id").on(table.authorType, table.authorId),
+]);
 export const proposedActions = sqliteTable("proposed_actions", {
     id: integer("id").primaryKey(),
     kind: text("kind").notNull(),

package/dist/store/sqlite/task-analysis-marks.d.ts

@@ -0,0 +1,7 @@
+import type { Id } from "../../domain/models.js";
+import type { CacheDatabase } from "../driver.js";
+import type { AccountKey, TaskAnalysisMark, TaskAnalysisMarkWrite } from "../types.js";
+export declare const taskAnalysisMarks: (database: CacheDatabase, account: AccountKey) => TaskAnalysisMark[];
+export declare const taskAnalysisMark: (database: CacheDatabase, account: AccountKey, chatId: Id) => TaskAnalysisMark | undefined;
+/** `checked`: the whole stretch through `checkedThrough` was read just now, by this store's clock. */
+export declare const setTaskAnalysisMark: (database: CacheDatabase, account: AccountKey, { chatId, checked, ...saved }: TaskAnalysisMarkWrite, now: number) => void;

package/dist/store/sqlite/task-analysis-marks.js

@@ -0,0 +1,27 @@
+// In store_settings beside task_rules_until, so backup and restore carry it and it needs no migration.
+const prefixOf = ({ provider, account }) => `task_analysis:${provider}:${account}:`;
+const markOf = (prefix, row) => ({
+    chatId: String(row.key).slice(prefix.length),
+    ...JSON.parse(String(row.value)),
+    at: new Date(Number(row.at)).toISOString(),
+});
+export const taskAnalysisMarks = (database, account) => {
+    const prefix = prefixOf(account);
+    return database
+        .prepare("SELECT key, value, at FROM store_settings WHERE substr(key, 1, ?) = ? ORDER BY at DESC")
+        .all(prefix.length, prefix)
+        .map((row) => markOf(prefix, row));
+};
+export const taskAnalysisMark = (database, account, chatId) => {
+    const prefix = prefixOf(account);
+    const row = database.prepare("SELECT key, value, at FROM store_settings WHERE key = ?").get(prefix + chatId);
+    return row ? markOf(prefix, row) : undefined;
+};
+/** `checked`: the whole stretch through `checkedThrough` was read just now, by this store's clock. */
+export const setTaskAnalysisMark = (database, account, { chatId, checked, ...saved }, now) => {
+    const checkedAt = checked ? new Date(now).toISOString() : taskAnalysisMark(database, account, chatId)?.checkedAt;
+    database
+        .prepare("INSERT INTO store_settings (key, value, at) VALUES (?, ?, ?) " +
+        "ON CONFLICT (key) DO UPDATE SET value = excluded.value, at = excluded.at")
+        .run(prefixOf(account) + chatId, JSON.stringify({ ...saved, checkedAt: checkedAt ?? new Date(now).toISOString() }), now);
+};

package/dist/store/sqlite/things.js

@@ -17,6 +17,8 @@ const REFERABLE = {
     fact: { tombstone: true },
     bot: { tombstone: false },
     event: { tombstone: true },
+    invoice: { tombstone: true },
+    payment: { tombstone: true },
     message: { tombstone: true },
     email: { tombstone: true },
     email_thread: { tombstone: true },

package/dist/store/store.d.ts

@@ -25,6 +25,7 @@ import { type MailStore } from "./sqlite/emails.js";
 import { type EventSearch } from "./sqlite/event-search.js";
 import { type FactsStore } from "./sqlite/facts.js";
 import { type FilesStore } from "./sqlite/files.js";
+import { type FinanceStore } from "./sqlite/finance.js";
 import { type InvolvementStore } from "./sqlite/involvements.js";
 import { type KnowledgeStore } from "./sqlite/knowledge.js";
 import { type MeetingVectors } from "./sqlite/meeting-vectors.js";
@@ -95,6 +96,8 @@ export interface MessageStore {
     /** 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;
+    /** Invoices, payments and their allocations, in exact minor units; an agent's or an import's wait for the owner. */
+    readonly finance: FinanceStore;
     /** What agents concluded: summaries, digests, facts, preferences, each with evidence and a scope. */
     readonly memories: MemoriesStore;
     /** What an agent wants done outside the store, waiting for the owner's approval. */

package/dist/store/store.js

@@ -24,6 +24,7 @@ import { eventSearchOver } from "./sqlite/event-search.js";
 import { evidenceFindingsStoreOver } from "./sqlite/evidence-findings.js";
 import { factsStoreOver } from "./sqlite/facts.js";
 import { filesStoreOver } from "./sqlite/files.js";
+import { financeStoreOver } from "./sqlite/finance.js";
 import { involvementStoreOver } from "./sqlite/involvements.js";
 import { knowledgeStoreOver } from "./sqlite/knowledge.js";
 import { logPruner } from "./sqlite/log-pruning.js";
@@ -110,6 +111,7 @@ const storeOver = (context) => {
         summaries: async (texts, options) => refSummariesOf(context.database, texts, options),
     };
     const facts = once(() => factsStoreOver(context));
+    const finance = once(() => financeStoreOver(context));
     const memories = once(() => memoriesStoreOver(context));
     const proposedActions = once(() => proposedActionsStoreOver(context));
     const agentActions = once(() => agentActionsStoreOver(context, pruneLogsWhenDue));
@@ -210,6 +212,9 @@ const storeOver = (context) => {
         get facts() {
             return facts();
         },
+        get finance() {
+            return finance();
+        },
         get memories() {
             return memories();
         },

package/dist/store/sync.d.ts

@@ -1,6 +1,6 @@
 import type { Id } from "../domain/models.js";
 import type { StoreContext } from "./sqlite/open.js";
-import type { AccountKey, Delta, Range } from "./types.js";
+import type { AccountKey, Delta, Range, TaskAnalysisMark, TaskAnalysisMarkWrite } from "./types.js";
 export interface SyncStore {
     /** What a sync remembered under `name` for this account, and when; a caller encodes a number itself. */
     syncState(key: AccountKey, name: string): Promise<{
@@ -31,5 +31,9 @@ export interface SyncStore {
     /** Where the account's last task-rule pass stopped: the newest store time it read. */
     taskRulesStop(key: AccountKey): Promise<string | null>;
     setTaskRulesStop(key: AccountKey, until: string): Promise<void>;
+    /** Every chat of the account read for tasks, the latest moved first. */
+    taskAnalysisMarks(key: AccountKey): Promise<TaskAnalysisMark[]>;
+    taskAnalysisMark(key: AccountKey, chatId: Id): Promise<TaskAnalysisMark | undefined>;
+    setTaskAnalysisMark(key: AccountKey, mark: TaskAnalysisMarkWrite): Promise<void>;
 }
 export declare const syncStoreOver: (context: StoreContext) => SyncStore;

package/dist/store/sync.js

@@ -2,6 +2,7 @@ import { keysOver } from "./keys.js";
 import * as chatQueries from "./sqlite/chats.js";
 import * as ranges from "./sqlite/ranges.js";
 import * as sync from "./sqlite/sync.js";
+import { setTaskAnalysisMark, taskAnalysisMark, taskAnalysisMarks } from "./sqlite/task-analysis-marks.js";
 import { setTaskRulesStop, taskRulesStop } from "./sqlite/task-rule-stops.js";
 import { write } from "./sqlite/transaction.js";
 export const syncStoreOver = (context) => {
@@ -56,5 +57,8 @@ export const syncStoreOver = (context) => {
         },
         taskRulesStop: async (key) => taskRulesStop(database, key),
         setTaskRulesStop: async (key, until) => setTaskRulesStop(database, key, until, context.now()),
+        taskAnalysisMarks: async (key) => taskAnalysisMarks(database, key),
+        taskAnalysisMark: async (key, chatId) => taskAnalysisMark(database, key, chatId),
+        setTaskAnalysisMark: async (key, mark) => setTaskAnalysisMark(database, key, mark, context.now()),
     };
 };

package/dist/store/types.d.ts

@@ -251,3 +251,28 @@ export interface Range {
     from: number;
     to: number;
 }
+/**
+ * How far a chat's messages were read for tasks: every stored message sent from `from` through `through`, the one
+ * with id `throughId` last. Its own point, so reading a chat, marking it read or another reader's `--new` never
+ * moves it.
+ */
+export interface TaskAnalysisMark {
+    chatId: Id;
+    from: string;
+    through: string;
+    throughId: Id;
+    /** Who moved it last: an agent's name or the owner. */
+    by: string;
+    /**
+     * At `checkedAt` every stored message sent from `from` through `checkedThrough` had been read; one saved or edited
+     * later inside that stretch (history fetched afterwards) was not.
+     */
+    checkedAt: string;
+    checkedThrough: string;
+    /** When it last moved. */
+    at: string;
+}
+/** `checked` stamps `checkedAt` with the store's clock; otherwise the mark keeps its earlier one. */
+export type TaskAnalysisMarkWrite = Omit<TaskAnalysisMark, "at" | "checkedAt"> & {
+    checked: boolean;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.555.0",
+  "version": "0.557.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",

package/parity.json

@@ -735,6 +735,9 @@
       "value": "<on|off>",
       "meaning": "only the owner may change the name and photo"
     },
+    "--open-new": {
+      "meaning": "open a task from a message the chat's task point already passed; without it a read again only updates and closes tasks"
+    },
     "--operation-id": {
       "value": "<id>",
       "meaning": "identify a send or creation attempt; message/poll retries reuse it, while an unknown topic creation must never be repeated"
@@ -2763,6 +2766,12 @@
     "config": {
       "in": "all"
     },
+    "config repair": {
+      "in": "all",
+      "options": {
+        "--dry-run": "all"
+      }
+    },
     "config set": {
       "in": "all",
       "options": {
@@ -4816,6 +4825,12 @@
     "tasks": {
       "in": "all"
     },
+    "tasks acknowledge": {
+      "in": "all",
+      "options": {
+        "--since-time": "all"
+      }
+    },
     "tasks add": {
       "in": "all",
       "options": {
@@ -4825,6 +4840,7 @@
         "--due": "all",
         "--into": "all",
         "--new": "all",
+        "--open-new": "all",
         "--remind-time": "all",
         "--title": "all",
         "--type": {
@@ -4931,6 +4947,13 @@
         "--holder": "all"
       }
     },
+    "tasks review": {
+      "in": "all",
+      "options": {
+        "--limit": "all",
+        "--since-time": "all"
+      }
+    },
     "tasks scan": {
       "in": "all",
       "options": {
@@ -4940,6 +4963,12 @@
     "tasks show": {
       "in": "all"
     },
+    "tasks status": {
+      "in": "all",
+      "options": {
+        "--limit": "all"
+      }
+    },
     "tasks unmerge": {
       "in": "all"
     },

package/skills/follow-ups/SKILL.md

@@ -38,6 +38,26 @@ no message text — read all of it:
 
 Anything not on the agenda waits for its own date. Do not open it.
 
+**Every chat keeps its own point of reading for tasks.** `review --new`, `inbox`, the owner reading on the phone
+and other agents all move their own points, so a message they showed is not yet read for tasks. Work from the
+task point instead:
+
+```sh
+{{command}} tasks status --json                        # per chat: read for tasks through when, how many wait, how many came late
+{{command}} tasks review "<chat>" --json               # the messages after the point, oldest first, and the chat's open tasks
+{{command}} tasks acknowledge "<chat>" <message id>    # after its tasks are opened, updated or closed: the next review starts after it
+```
+
+For each chat with `waiting` above 0: `tasks review`, then open new tasks, update or close the listed `open_tasks`
+the new messages settle, then run the `next` step the answer gives (`tasks acknowledge`). Acknowledge only what you
+finished; a page with `has_more: true` is followed by the next one. A chat with `late` above 0 got older history
+after it was read: `tasks review "<chat>" --since-time <mark.from>` reads the stretch again (up to 1000 messages),
+and acknowledging that read clears it. A read again only updates and closes tasks: `tasks add` refuses a message the
+point already passed (`task.already-read`) unless it is given `--open-new`, which you pass only when the owner asked
+for tasks from that history. When that answer has `has_more: true` it gives no acknowledge step: the stretch
+is too long to read again in one page, so tell the owner and move on. A chat whose history is not stored yet is fetched by `messages sync` first; `tasks review` reads
+only the store.
+
 **History is not work.** A first sync opens no tasks from old messages (`task_first_pass_per_chat`, 0 by
 default) and says how many it held. Do not read old chats looking for tasks. Ask the owner which chats to build,
 then for each: `{{command}} tasks scan "<chat>" --json` lists what would open, and `--yes` opens it. Dig deeper
@@ -103,7 +123,7 @@ stop. The owner sends what they choose.
 
 `{{command}} schedule agent follow-ups claude "<prompt>" --at 08:30` runs this every morning. Then you run
 with the CLI's read-only variable set (`MAX_READ_ONLY=1` for max). The task work above still runs: `tasks scan --yes`,
-`add`, `plan`, `link`, `merge`, `unmerge`, `duplicates reject`, `duplicates defer`, `claim`, `release` and `close`
+`acknowledge`, `add`, `plan`, `link`, `merge`, `unmerge`, `duplicates reject`, `duplicates defer`, `claim`, `release` and `close`
 — but every `tasks close` then waits on the owner as a suggestion, whatever your certainty, and `--as-owner` is
 refused. Everything else that writes is refused, so do not try: every send, reaction and edit; changes to schedules,
 settings, the recipient list or auto-replies; tags, contact notes and aliases, saved searches, `tasks reject`. What you print is the report the owner opens; its first line shows in the desktop
@@ -115,7 +135,7 @@ A recipe is a set of flags, not a new command:
 
 | Recipe | Command |
 |---|---|
-| Morning sweep | `review --new --json`, then `tasks agenda --json` |
+| Morning sweep | `review --new --json`, then `tasks agenda --json`, then `tasks status --json` and a `tasks review` per waiting chat |
 | Weekly quiet-chat pass | `tasks agenda --waiting 3d --within 90d --json` |
 | Groups too, not only people | `tasks agenda "chat_kind:(dialog OR group OR channel)" --json` |
 | Before a call with someone | `tasks list 'chat:"<chat>" state:open' --json`, then `tasks show` each |