@wirecat/cli-memo 0.131.62 → 0.131.64

package/dist/finance/subscriptions-command.js

@@ -0,0 +1,153 @@
+import { annotate } from "@wirecat/cli-base/commands";
+import { FINANCE_REVIEWS, INVOICE_DIRECTIONS, SUBSCRIPTION_STATUSES } from "@wirecat/cli-core";
+import { LOCAL_READ, LOCAL_WRITE, queryTerms, termField, withQuery } from "@wirecat/cli-core/cli";
+import { answers, itemAnswer } from "../answer.js";
+import { byOption, whoRuns } from "../author.js";
+import { positive } from "../options.js";
+import { pageOf } from "../page.js";
+import { withSources } from "../records/sources.js";
+import { canonicalProject } from "../vocabulary/project.js";
+import { dayOf, today } from "./finance.js";
+import { choice, given, json, needed, optionalChoice, PROPOSES, writeMeta, writtenBy } from "./written.js";
+export const SUBSCRIPTION_QUERY = {
+    entity: "subscription",
+    backend: "native",
+    fields: [
+        termField("status", "enum", "status:active", { values: SUBSCRIPTION_STATUSES }),
+        termField("direction", "enum", "direction:payable", { values: INVOICE_DIRECTIONS }),
+        termField("supplier", "ref", 'supplier:"organization:3"'),
+        termField("customer", "ref", 'customer:"organization:3"'),
+        termField("project", "kw", "project:PMED"),
+        termField("review", "enum", "review:proposed", { values: FINANCE_REVIEWS }),
+        termField("renews", "time", "renews:2026-12-01"),
+    ],
+};
+export const listSubscriptions = async (store, words, limit) => {
+    const terms = queryTerms(words, SUBSCRIPTION_QUERY, "subscriptions list");
+    const project = terms.get("project");
+    const filter = given({
+        status: terms.get("status"),
+        direction: terms.get("direction"),
+        supplier: terms.get("supplier"),
+        customer: terms.get("customer"),
+        review: terms.get("review"),
+        renewsBy: dayOf(terms.get("renews")),
+        project: project === undefined ? undefined : await canonicalProject(store, project),
+    });
+    return pageOf("subscriptions list", limit, (most) => store.subscriptions.list({ ...filter, limit: most }));
+};
+const parts = (command) => command
+    .option("--status <state>", `${SUBSCRIPTION_STATUSES.join(", ")}; trial needs --trial-end-date`)
+    .option("--supplier <party>", "who supplies it: person:<uid> or organization:<id>; you, when you bill it")
+    .option("--customer <party>", "who receives it and pays for it: person:<uid> or organization:<id>; you, when you pay")
+    .option("--product <product>", "the product or service it is for: product:<id>")
+    .option("--contract <contract>", "the contract it runs under: contract:<id>")
+    .option("--every <count-unit>", "how often it is charged: a count and a unit, such as 1-month or 1-year")
+    .option("--start-date <date>", "the first day it runs, YYYY-MM-DD")
+    .option("--trial-end-date <date>", "the day its free trial ends, YYYY-MM-DD");
+const fieldsOf = (options) => given({
+    status: optionalChoice(options.status, SUBSCRIPTION_STATUSES, "--status"),
+    supplier: options.supplier,
+    customer: options.customer,
+    product: options.product,
+    contract: options.contract,
+    every: options.every,
+    startDate: dayOf(options.startDate),
+    trialEndDate: dayOf(options.trialEndDate),
+    endDate: dayOf(options.endDate),
+});
+/** `memo subscriptions`: what the owner bills or pays on a schedule, and its price history. */
+export const subscriptionCommands = (program, streams, env) => {
+    const { run } = answers(program, streams, env);
+    const subscriptions = program
+        .command("subscriptions")
+        .description("subscriptions you bill or pay: who supplies it, who pays, how often, and every price it had; a price is " +
+        "never changed, a new one is added")
+        .summary("subscriptions you bill or pay, and their prices");
+    withQuery(json(annotate(subscriptions.command("list"), { effects: LOCAL_READ })).description("subscriptions, newest first; renews:2026-12-01 lists those that renew by then"), SUBSCRIPTION_QUERY)
+        .option("--limit <n>", "most subscriptions, up to 500", positive, 100)
+        .action((words, { json, limit }) => run(json, (store) => listSubscriptions(store, words, limit)));
+    json(annotate(subscriptions.command("show"), { effects: LOCAL_READ, output: { entity: "subscription" } }))
+        .description("one subscription with its parties, dates, current price and every price it had")
+        .argument("<subscription>", "subscription:<id>")
+        .action((ref, options, command) => run(options.json, async (store) => itemAnswer(await withSources(command, store, await store.subscriptions.get(ref)))));
+    json(writeMeta(parts(annotate(subscriptions.command("add"), {
+        effects: LOCAL_WRITE,
+        output: { entity: "subscription" },
+        literal_after_dashes: true,
+    })).option("--kind <kind>", "receivable (you bill it) or payable (you pay it)")))
+        .description(`record a subscription and its first price; ${PROPOSES}`)
+        .summary("record a subscription; an agent's waits for your review")
+        .argument("<name>", "what it is, such as Hosting")
+        .argument("<amount>", "its price for one period, a decimal such as 990.00")
+        .argument("<currency>", "ISO 4217, such as RUB")
+        .action(async (name, amount, currency, options, command) => {
+        const by = await whoRuns(command, env, {
+            asOwner: options.asOwner,
+            question: "record this subscription as yours?",
+        });
+        await run(options.json, async (store) => {
+            const startDate = dayOf(options.startDate) ?? today();
+            return itemAnswer(await store.subscriptions.add({
+                ...(await writtenBy(store, by, options)),
+                ...fieldsOf(options),
+                name,
+                direction: choice(options.kind, INVOICE_DIRECTIONS, "--kind"),
+                every: needed(options.every, "--every", "how often it is charged, such as 1-month"),
+                startDate,
+                prices: [{ amount, currency, effectiveFrom: startDate }],
+            }));
+        });
+    });
+    json(byOption(parts(annotate(subscriptions.command("update"), { effects: LOCAL_WRITE, output: { entity: "subscription" } }))
+        .option("--title <title>", "its new name")
+        .option("--end-date <date>", "the last day it runs, YYYY-MM-DD")))
+        .description("change a subscription's status, schedule, dates or parties; pause it with --status paused. You change any, an " +
+        "agent only one it proposed that is still proposed. A new price is subscriptions prices add")
+        .summary("change a subscription")
+        .argument("<subscription>", "subscription:<id>")
+        .action(async (ref, options, command) => {
+        const by = await whoRuns(command, env, { asOwner: options.asOwner, question: `change ${ref} as yours?` });
+        await run(options.json, async (store) => itemAnswer(await store.subscriptions.update(ref, { by, ...fieldsOf(options), ...given({ name: options.title }) })));
+    });
+    json(byOption(annotate(subscriptions.command("cancel"), { effects: LOCAL_WRITE, output: { entity: "subscription" } }).option("--occurred-time <time>", "the day it was cancelled, such as 2026-11-01; today when left out")))
+        .description("mark a subscription cancelled on a day; it stays, with its prices")
+        .summary("cancel a subscription")
+        .argument("<subscription>", "subscription:<id>")
+        .action(async (ref, options, command) => {
+        const by = await whoRuns(command, env, { asOwner: options.asOwner, question: `cancel ${ref} as yours?` });
+        await run(options.json, async (store) => itemAnswer(await store.subscriptions.update(ref, {
+            by,
+            status: "cancelled",
+            cancelledDate: dayOf(options.occurredTime) ?? today(),
+        })));
+    });
+    const prices = subscriptions
+        .command("prices")
+        .description("the prices a subscription had, each from a day on; one is never changed, a new one is added")
+        .summary("a subscription's prices");
+    json(byOption(annotate(prices.command("add"), { effects: LOCAL_WRITE, output: { entity: "subscription_price" } })
+        .option("--start-date <date>", "the first day the price holds, YYYY-MM-DD; the subscription's start when left out")
+        .option("--reason <text>", "why an agent proposes it, for the owner who decides")))
+        .description(`add a price from a day on; the earlier ones stay as they were. ${PROPOSES}, and the subscription stays as it is`)
+        .summary("add a subscription's new price")
+        .argument("<subscription>", "subscription:<id>")
+        .argument("<amount>", "the price for one period, a decimal such as 1190.00")
+        .argument("<currency>", "ISO 4217, such as RUB")
+        .action(async (ref, amount, currency, options, command) => {
+        const by = await whoRuns(command, env, {
+            asOwner: options.asOwner,
+            question: `add a price to ${ref} as yours?`,
+        });
+        await run(options.json, async (store) => itemAnswer(await store.subscriptions.addPrice(ref, {
+            by,
+            amount,
+            currency,
+            ...given({
+                effectiveFrom: dayOf(options.startDate),
+                reason: by === "owner" ? undefined : options.reason,
+            }),
+        })));
+    });
+};
+//# sourceMappingURL=subscriptions-command.js.map

package/dist/finance/subscriptions-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions-command.js","sourceRoot":"","sources":["../../src/finance/subscriptions-command.ts"],"names":[],"mappings":"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"}

package/dist/finance/transactions-command.d.ts

@@ -0,0 +1,12 @@
+import type { Streams } from "@wirecat/cli-base";
+import type { MessageStore } from "@wirecat/cli-core/store";
+import type { Command } from "commander";
+export declare const TRANSACTION_QUERY: {
+    readonly entity: "transaction";
+    readonly backend: "native";
+    readonly fields: readonly [import("@wirecat/cli-base/query").FieldSpec, import("@wirecat/cli-base/query").FieldSpec, import("@wirecat/cli-base/query").FieldSpec, import("@wirecat/cli-base/query").FieldSpec, import("@wirecat/cli-base/query").FieldSpec, import("@wirecat/cli-base/query").FieldSpec, import("@wirecat/cli-base/query").FieldSpec];
+};
+export declare const listTransactions: (store: MessageStore, words: readonly string[] | string | undefined, limit?: number) => Promise<import("@wirecat/cli-core/cli").ListBody<unknown>>;
+/** `memo transactions`: what a bank statement says moved, and the categories it is split into. */
+export declare const transactionCommands: (program: Command, streams: Streams, env: NodeJS.ProcessEnv) => void;
+//# sourceMappingURL=transactions-command.d.ts.map

package/dist/finance/transactions-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions-command.d.ts","sourceRoot":"","sources":["../../src/finance/transactions-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAKhD,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,yBAAyB,CAAA;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAUxC,eAAO,MAAM,iBAAiB;qBACpB,aAAa;sBACZ,QAAQ;;CAUe,CAAA;AAElC,eAAO,MAAM,gBAAgB,UACpB,YAAY,SACZ,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,UACrC,MAAM,+DAcf,CAAA;AAUD,kGAAkG;AAClG,eAAO,MAAM,mBAAmB,YAAa,OAAO,WAAW,OAAO,OAAO,MAAM,CAAC,UAAU,KAAG,IA2JhG,CAAA"}

package/dist/finance/transactions-command.js

@@ -0,0 +1,137 @@
+import { annotate } from "@wirecat/cli-base/commands";
+import { FINANCE_REVIEWS, MONEY_DIRECTIONS, TRANSACTION_STATUSES } from "@wirecat/cli-core";
+import { LOCAL_READ, LOCAL_WRITE, queryTerms, termField, withQuery } from "@wirecat/cli-core/cli";
+import { answers, itemAnswer } from "../answer.js";
+import { byOption, whoRuns } from "../author.js";
+import { positive } from "../options.js";
+import { pageOf } from "../page.js";
+import { withSources } from "../records/sources.js";
+import { canonicalProject } from "../vocabulary/project.js";
+import { dayOf, today } from "./finance.js";
+import { choice, given, json, optionalChoice, PROPOSES, writeMeta, writtenBy } from "./written.js";
+export const TRANSACTION_QUERY = {
+    entity: "transaction",
+    backend: "native",
+    fields: [
+        termField("wallet", "ref", 'wallet:"wallet:2"'),
+        termField("direction", "enum", "direction:out", { values: MONEY_DIRECTIONS }),
+        termField("status", "enum", "status:pending", { values: TRANSACTION_STATUSES }),
+        termField("category", "kw", "category:Rent"),
+        termField("project", "kw", "project:PMED"),
+        termField("review", "enum", "review:proposed", { values: FINANCE_REVIEWS }),
+        termField("uncategorized", "bool", "uncategorized:true"),
+    ],
+};
+export const listTransactions = async (store, words, limit) => {
+    const terms = queryTerms(words, TRANSACTION_QUERY, "transactions list");
+    const project = terms.get("project");
+    const filter = given({
+        wallet: terms.get("wallet"),
+        direction: terms.get("direction"),
+        status: terms.get("status"),
+        category: terms.get("category"),
+        review: terms.get("review"),
+        uncategorized: terms.has("uncategorized") ? terms.get("uncategorized") === "true" : undefined,
+        project: project === undefined ? undefined : await canonicalProject(store, project),
+    });
+    return pageOf("transactions list", limit, (most) => store.transactions.list({ ...filter, limit: most }));
+};
+const STATUS_HELP = `${TRANSACTION_STATUSES.join(" or ")}; only a booked one counts in a balance`;
+/** `memo transactions`: what a bank statement says moved, and the categories it is split into. */
+export const transactionCommands = (program, streams, env) => {
+    const { run } = answers(program, streams, env);
+    const transactions = program
+        .command("transactions")
+        .description("money a wallet's statement shows moving in or out, the payment it settles, and the categories it is split into")
+        .summary("money moving in or out of your wallets");
+    withQuery(json(annotate(transactions.command("list"), { effects: LOCAL_READ })).description("transactions, newest first; uncategorized:true lists those not fully split into categories"), TRANSACTION_QUERY)
+        .summary("transactions, newest first")
+        .option("--limit <n>", "most transactions, up to 500", positive, 100)
+        .action((words, { json, limit }) => run(json, (store) => listTransactions(store, words, limit)));
+    json(annotate(transactions.command("show"), { effects: LOCAL_READ, output: { entity: "transaction" } }))
+        .description("one transaction with its wallet, payment, splits and what is not categorized")
+        .argument("<transaction>", "transaction:<id>")
+        .action((ref, options, command) => run(options.json, async (store) => itemAnswer(await withSources(command, store, await store.transactions.get(ref)))));
+    json(writeMeta(annotate(transactions.command("add"), {
+        effects: LOCAL_WRITE,
+        output: { entity: "transaction" },
+        literal_after_dashes: true,
+    })
+        .option("--kind <kind>", "in (money came in) or out (money went out)")
+        .option("--occurred-time <time>", "the day the statement shows, such as 2026-11-01; today when left out")
+        .option("--description <text>", "what the statement says, as it says it")
+        .option("--status <state>", `${STATUS_HELP}; booked when left out`)
+        .option("--payment <payment>", "the payment it settles, same amount, currency and direction: payment:<id>")))
+        .description(`record what a wallet's statement shows moved, in the wallet's currency; ${PROPOSES}`)
+        .summary("record a transaction; an agent's waits for your review")
+        .argument("<wallet>", "wallet:<id>")
+        .argument("<amount>", "a decimal above 0, such as 500.00")
+        .action(async (wallet, amount, options, command) => {
+        const by = await whoRuns(command, env, {
+            asOwner: options.asOwner,
+            question: "record this transaction as yours?",
+        });
+        await run(options.json, async (store) => itemAnswer(await store.transactions.add({
+            ...(await writtenBy(store, by, options)),
+            wallet,
+            amount,
+            direction: choice(options.kind, MONEY_DIRECTIONS, "--kind"),
+            statementDate: dayOf(options.occurredTime) ?? today(),
+            ...given({
+                status: optionalChoice(options.status, TRANSACTION_STATUSES, "--status"),
+                description: options.description,
+                payment: options.payment,
+            }),
+        })));
+    });
+    json(byOption(annotate(transactions.command("update"), { effects: LOCAL_WRITE, output: { entity: "transaction" } })
+        .option("--status <state>", STATUS_HELP)
+        .option("--payment <payment>", "the payment it settles, same amount, currency and direction: payment:<id>")
+        .option("--description <text>", "what the statement says, as it says it")))
+        .description("book a pending transaction, link it to the payment it settles, or fix its text; you change any, an agent only " +
+        "one it proposed that is still proposed")
+        .summary("book a transaction or link it to its payment")
+        .argument("<transaction>", "transaction:<id>")
+        .action(async (ref, options, command) => {
+        const by = await whoRuns(command, env, { asOwner: options.asOwner, question: `change ${ref} as yours?` });
+        await run(options.json, async (store) => itemAnswer(await store.transactions.update(ref, {
+            by,
+            ...given({
+                status: optionalChoice(options.status, TRANSACTION_STATUSES, "--status"),
+                payment: options.payment,
+                description: options.description,
+            }),
+        })));
+    });
+    const splits = transactions
+        .command("splits")
+        .description("the categories a transaction's amount is split into; together never more than the amount, the rest is " +
+        "uncategorized")
+        .summary("a transaction's categories");
+    const WHO = "you split any transaction; an agent only one it proposed that is still proposed";
+    json(byOption(annotate(splits.command("add"), { effects: LOCAL_WRITE, output: { entity: "transaction" } }).option("--project <project>", "the project this part belongs to: its key or project:<id>")))
+        .description(`put part of a transaction's amount under a category; ${WHO}`)
+        .summary("put part of a transaction under a category")
+        .argument("<transaction>", "transaction:<id>")
+        .argument("<amount>", "a decimal above 0, such as 120.00")
+        .argument("<category...>", "the category, in a word or a few, such as Rent")
+        .action(async (ref, amount, words, options, command) => {
+        const by = await whoRuns(command, env, { asOwner: options.asOwner, question: `split ${ref} as yours?` });
+        await run(options.json, async (store) => itemAnswer(await store.transactions.addSplit(ref, {
+            by,
+            amount,
+            category: words.join(" "),
+            ...(options.project === undefined ? {} : { project: await canonicalProject(store, options.project) }),
+        })));
+    });
+    json(byOption(annotate(splits.command("remove"), { effects: LOCAL_WRITE, output: { entity: "transaction" } })))
+        .description(`take a split off a transaction; its amount is uncategorized again. ${WHO}`)
+        .summary("take a split off a transaction")
+        .argument("<transaction>", "transaction:<id>")
+        .argument("<position>", "the split's position, from 1, as transactions show lists it", positive)
+        .action(async (ref, position, options, command) => {
+        const by = await whoRuns(command, env, { asOwner: options.asOwner, question: `change ${ref}'s splits as yours?` });
+        await run(options.json, async (store) => itemAnswer(await store.transactions.removeSplit(ref, { position, by })));
+    });
+};
+//# sourceMappingURL=transactions-command.js.map

package/dist/finance/transactions-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions-command.js","sourceRoot":"","sources":["../../src/finance/transactions-command.ts"],"names":[],"mappings":"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"}

package/dist/finance/wallets-command.d.ts

@@ -0,0 +1,12 @@
+import type { Streams } from "@wirecat/cli-base";
+import type { MessageStore } from "@wirecat/cli-core/store";
+import type { Command } from "commander";
+export declare const WALLET_QUERY: {
+    readonly entity: "wallet";
+    readonly backend: "native";
+    readonly fields: readonly [import("@wirecat/cli-base/query").FieldSpec, import("@wirecat/cli-base/query").FieldSpec];
+};
+export declare const listWallets: (store: MessageStore, words: readonly string[] | string | undefined, limit?: number) => Promise<import("@wirecat/cli-core/cli").ListBody<unknown>>;
+/** `memo wallets`: where the owner's money is, with a balance computed from its confirmed, booked transactions. */
+export declare const walletCommands: (program: Command, streams: Streams, env: NodeJS.ProcessEnv) => void;
+//# sourceMappingURL=wallets-command.d.ts.map

package/dist/finance/wallets-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallets-command.d.ts","sourceRoot":"","sources":["../../src/finance/wallets-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAKhD,OAAO,KAAK,EAAE,YAAY,EAAwB,MAAM,yBAAyB,CAAA;AACjF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AASxC,eAAO,MAAM,YAAY;qBACf,QAAQ;sBACP,QAAQ;;CAKe,CAAA;AAElC,eAAO,MAAM,WAAW,UACf,YAAY,SACZ,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,UACrC,MAAM,+DAQf,CAAA;AAsBD,mHAAmH;AACnH,eAAO,MAAM,cAAc,YAAa,OAAO,WAAW,OAAO,OAAO,MAAM,CAAC,UAAU,KAAG,IAgH3F,CAAA"}

package/dist/finance/wallets-command.js

@@ -0,0 +1,106 @@
+import { annotate } from "@wirecat/cli-base/commands";
+import { WALLET_KINDS } from "@wirecat/cli-core";
+import { LOCAL_READ, LOCAL_WRITE, queryTerms, termField, withQuery } from "@wirecat/cli-core/cli";
+import { answers, itemAnswer } from "../answer.js";
+import { authorOf, byOption, whoRuns } from "../author.js";
+import { positive } from "../options.js";
+import { pageOf } from "../page.js";
+import { sourceAccounts, withSources } from "../records/sources.js";
+import { dayOf } from "./finance.js";
+import { given, json, optionalChoice } from "./written.js";
+export const WALLET_QUERY = {
+    entity: "wallet",
+    backend: "native",
+    fields: [
+        termField("kind", "enum", "kind:card", { values: WALLET_KINDS }),
+        termField("currency", "kw", "currency:RUB"),
+    ],
+};
+export const listWallets = async (store, words, limit) => {
+    const terms = queryTerms(words, WALLET_QUERY, "wallets list");
+    const filter = given({
+        kind: terms.get("kind"),
+        currency: terms.get("currency"),
+    });
+    return pageOf("wallets list", limit, (most) => store.wallets.list({ ...filter, limit: most }));
+};
+/**
+ * An imported wallet's opening balance as its source record gives it: only the owner sets the wallet's own, so until
+ * then `wallets show` prints the source's beside it.
+ */
+const sourceSays = async (store, wallet) => {
+    if (wallet.openingBalance !== null)
+        return null;
+    for (const { provider, account } of await sourceAccounts(store, wallet)) {
+        const [record] = await store.records.list({ provider, account, entity: wallet.ref, limit: 1 });
+        const { opening_balance: balance, opening_date: date } = record?.fields ?? {};
+        if (record && typeof balance === "string")
+            return {
+                openingBalance: balance,
+                openingDate: typeof date === "string" ? date : null,
+                record: `${record.type}:${record.externalId}`,
+                account: `${provider}:${account}`,
+            };
+    }
+    return null;
+};
+/** `memo wallets`: where the owner's money is, with a balance computed from its confirmed, booked transactions. */
+export const walletCommands = (program, streams, env) => {
+    const { run } = answers(program, streams, env);
+    const wallets = program
+        .command("wallets")
+        .description("bank accounts, cards and cash you keep money in, one currency each; a balance is the opening balance plus " +
+        "confirmed, booked transactions, computed each time")
+        .summary("bank accounts, cards and cash, with their balances");
+    withQuery(json(annotate(wallets.command("list"), { effects: LOCAL_READ })).description("wallets with their balances today; kind:card lists the cards"), WALLET_QUERY)
+        .option("--limit <n>", "most wallets, up to 500", positive, 100)
+        .action((words, { json, limit }) => run(json, (store) => listWallets(store, words, limit)));
+    json(annotate(wallets.command("show"), { effects: LOCAL_READ, output: { entity: "wallet" } }).option("--until-time <time>", "the balance up to and including this day, such as 2026-10-31; today when left out"))
+        .description("one wallet with its balance, and beside it what is pending or proposed and not counted yet; for an imported " +
+        "wallet whose opening balance you have not set, source_says gives the one its source sent")
+        .summary("one wallet with its balance and what is pending")
+        .argument("<wallet>", "wallet:<id>")
+        .action((ref, options, command) => run(options.json, async (store) => {
+        const until = dayOf(options.untilTime);
+        const wallet = await store.wallets.get(ref, until === undefined ? {} : { until });
+        return itemAnswer(await withSources(command, store, { ...wallet, sourceSays: await sourceSays(store, wallet) }));
+    }));
+    json(annotate(wallets.command("add"), { effects: LOCAL_WRITE, output: { entity: "wallet" }, literal_after_dashes: true })
+        .option("--kind <kind>", `${WALLET_KINDS.join(", ")}; bank when left out`)
+        .option("--institution <text>", "the bank or other company that holds it, by name"))
+        .description("add a wallet in one currency; anyone adds one directly, and only you set its opening balance, with wallets update")
+        .summary("add a bank account, card or cash wallet")
+        .argument("<name>", "what you call it, such as 'Main card'")
+        .argument("<currency>", "ISO 4217, such as RUB; a bank account in two currencies is two wallets")
+        .action((name, currency, options) => run(options.json, async (store) => itemAnswer(await store.wallets.add({
+        by: authorOf(env),
+        name,
+        currency,
+        ...given({
+            kind: optionalChoice(options.kind, WALLET_KINDS, "--kind"),
+            institution: options.institution,
+        }),
+    }))));
+    json(byOption(annotate(wallets.command("update"), { effects: LOCAL_WRITE, output: { entity: "wallet" } })
+        .option("--title <title>", "its new name")
+        .option("--institution <text>", "the bank or other company that holds it, by name")
+        .option("--opening-balance <decimal>", "what it held on --opening-date, such as 1500.50; only you set it")
+        .option("--opening-date <date>", "the day of the opening balance, YYYY-MM-DD")))
+        .description("rename a wallet, or set the opening balance its balance counts from; the opening balance is yours alone, an " +
+        "agent is refused")
+        .summary("rename a wallet or set its opening balance")
+        .argument("<wallet>", "wallet:<id>")
+        .action(async (ref, options, command) => {
+        const by = await whoRuns(command, env, { asOwner: options.asOwner, question: `change ${ref} as yours?` });
+        await run(options.json, async (store) => itemAnswer(await store.wallets.update(ref, {
+            by,
+            ...given({
+                name: options.title,
+                institution: options.institution,
+                openingBalance: options.openingBalance,
+                openingDate: dayOf(options.openingDate),
+            }),
+        })));
+    });
+};
+//# sourceMappingURL=wallets-command.js.map

package/dist/finance/wallets-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallets-command.js","sourceRoot":"","sources":["../../src/finance/wallets-command.ts"],"names":[],"mappings":"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"}

package/dist/finance/written.d.ts

@@ -0,0 +1,37 @@
+import type { MessageStore } from "@wirecat/cli-core/store";
+import type { Command } from "commander";
+export interface Written {
+    kind?: string;
+    person?: string;
+    organization?: string;
+    title?: string;
+    occurredTime?: string;
+    project?: string;
+    reason?: string;
+    evidence?: string[];
+    asOwner?: boolean;
+    json?: boolean;
+}
+export declare const json: (command: Command) => Command;
+export declare const PROPOSES = "yours is confirmed at once; an agent's waits as proposed for you in memo review";
+export declare const choice: <T extends string>(value: string | undefined, allowed: readonly T[], flag: string) => T;
+export declare const needed: (value: string | undefined, flag: string, what: string) => string;
+export declare const optionalChoice: <T extends string>(value: string | undefined, allowed: readonly T[], flag: string) => T | undefined;
+/** `--auto-renew on`, `--archived off`: the vocabulary's on|off values. */
+export declare const onOff: (value: string | undefined, flag: string) => boolean | undefined;
+/** The parts every finance write shares: who writes it, its project, and an agent's reason. */
+export declare const writtenBy: (store: MessageStore, by: "owner" | {
+    bot: string;
+}, options: Written) => Promise<{
+    by: "owner" | {
+        bot: string;
+    };
+    project?: string | undefined;
+    reason?: string | undefined;
+    evidence?: string[] | undefined;
+}>;
+export declare const party: (command: Command, what: string) => Command;
+export declare const writeMeta: (command: Command) => Command;
+/** Leaves out what the caller did not give, so an update changes only the named fields. */
+export declare const given: <T extends Record<string, unknown>>(fields: T) => { [K in keyof T]?: Exclude<T[K], undefined>; };
+//# sourceMappingURL=written.d.ts.map

package/dist/finance/written.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"written.d.ts","sourceRoot":"","sources":["../../src/finance/written.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKxC,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,eAAO,MAAM,IAAI,YAAa,OAAO,YAAwB,CAAA;AAE7D,eAAO,MAAM,QAAQ,oFAAoF,CAAA;AAEzG,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,MAAM,SAAS,MAAM,GAAG,SAAS,WAAW,SAAS,CAAC,EAAE,QAAQ,MAAM,KAAG,CAIzG,CAAA;AAED,eAAO,MAAM,MAAM,UAAW,MAAM,GAAG,SAAS,QAAQ,MAAM,QAAQ,MAAM,KAAG,MAI9E,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,SACtC,MAAM,GAAG,SAAS,WAChB,SAAS,CAAC,EAAE,QACf,MAAM,KACX,CAAC,GAAG,SAA6E,CAAA;AAEpF,2EAA2E;AAC3E,eAAO,MAAM,KAAK,UAAW,MAAM,GAAG,SAAS,QAAQ,MAAM,KAAG,OAAO,GAAG,SACc,CAAA;AAExF,+FAA+F;AAC/F,eAAO,MAAM,SAAS,UAAiB,YAAY,MAAM,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,WAAW,OAAO;;aAA1B,MAAM;;;;;EAK9E,CAAA;AAEF,eAAO,MAAM,KAAK,YAAa,OAAO,QAAQ,MAAM,YAGuC,CAAA;AAE3F,eAAO,MAAM,SAAS,YAAa,OAAO,YAMvC,CAAA;AAEH,2FAA2F;AAC3F,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,KACyB,GACtF,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,GAC1C,CAAA"}

package/dist/finance/written.js

@@ -0,0 +1,36 @@
+import { CliError } from "@wirecat/cli-base";
+import { byOption } from "../author.js";
+import { jsonOption } from "../options.js";
+import { canonicalProject } from "../vocabulary/project.js";
+export const json = (command) => jsonOption(command);
+export const PROPOSES = "yours is confirmed at once; an agent's waits as proposed for you in memo review";
+export const choice = (value, allowed, flag) => {
+    if (value === undefined || !allowed.includes(value))
+        throw new CliError("validation_error", `${flag} is one of ${allowed.join(", ")}`, { param: flag });
+    return value;
+};
+export const needed = (value, flag, what) => {
+    if (value === undefined || value.trim() === "")
+        throw new CliError("validation_error", `name ${what}: ${flag}`, { param: flag });
+    return value;
+};
+export const optionalChoice = (value, allowed, flag) => (value === undefined ? undefined : choice(value, allowed, flag));
+/** `--auto-renew on`, `--archived off`: the vocabulary's on|off values. */
+export const onOff = (value, flag) => value === undefined ? undefined : choice(value, ["on", "off"], flag) === "on";
+/** The parts every finance write shares: who writes it, its project, and an agent's reason. */
+export const writtenBy = async (store, by, options) => ({
+    by,
+    ...(options.project === undefined ? {} : { project: await canonicalProject(store, options.project) }),
+    ...(by !== "owner" && options.reason !== undefined ? { reason: options.reason } : {}),
+    ...(options.evidence === undefined ? {} : { evidence: options.evidence }),
+});
+export const party = (command, what) => command
+    .option("--person <uid>", `the person ${what}: person:<id>`)
+    .option("--organization <organization>", `the organization ${what}: organization:<id>`);
+export const writeMeta = (command) => byOption(command
+    .option("--project <project>", "the project it belongs to: its key or project:<id>")
+    .option("--reason <text>", "why an agent proposes it, for the owner who decides")
+    .option("--evidence <ref...>", "what shows it, up to 8: msg:, note:, document: or another reference"));
+/** Leaves out what the caller did not give, so an update changes only the named fields. */
+export const given = (fields) => Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));
+//# sourceMappingURL=written.js.map

package/dist/finance/written.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"written.js","sourceRoot":"","sources":["../../src/finance/written.ts"],"names":[],"mappings":"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"}

package/dist/knowledge/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/knowledge/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AA2B1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAoCxC,eAAO,MAAM,iBAAiB,YAAa,OAAO,WAAW,OAAO,OAAO,MAAM,CAAC,UAAU,SA8b3F,CAAA"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/knowledge/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AA2B1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAoCxC,eAAO,MAAM,iBAAiB,YAAa,OAAO,WAAW,OAAO,OAAO,MAAM,CAAC,UAAU,SAqc3F,CAAA"}

package/dist/knowledge/command.js

@@ -186,7 +186,8 @@ export const knowledgeCommands = (program, streams, env) => {
         .argument("<to>", "the person:, organization: or project: it belongs or relates to")
         .option("--json", "print JSON; --json=id,title keeps only those fields")
         .option("--kind <kind>", "member-of or related-to", "member-of")
-        .option("--role <role>", "the role it has there, in a few words, such as cto")
+        .option("--role <role>", "the role it has there; a person's role in an organization or a project is one from its list, " +
+        "such as employee or contributor")
         .option("--reason <text>", "why you think so, in a sentence")
         .action(async (from, to, options, command) => {
         const by = await whoRuns(command, env, { asOwner: options.asOwner, question: "state it as yours?" });
@@ -217,7 +218,7 @@ export const knowledgeCommands = (program, streams, env) => {
         "an agent's change waits for you in memo review")
         .summary("set a relationship's role or a chat's purpose in a project")
         .argument("<id>", "the relationship's id, as relationships list gives it")
-        .option("--role <role>", "the role it has there, in a few words; an empty value clears it")
+        .option("--role <role>", "the role it has there, from the same list as relationships add; an empty value clears it")
         .option("--purpose <purpose>", "what the chat is for in the project: work, sales, support or other")
         .option("--reason <text>", "why, in a sentence")
         .option("--json", "print JSON; --json=id,title keeps only those fields")).action(async (id, options, command) => {