@rubytech/create-maxy-code 0.1.470 → 0.1.472

package/payload/platform/plugins/ledger/mcp/dist/lib/neo4j.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j.js","sourceRoot":"","sources":["../../src/lib/neo4j.ts"],"names":[],"mappings":"AAAA,OAAO,KAA0B,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,SAAS,YAAY;IACnB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAElE,MAAM,YAAY,GAAG,OAAO,CAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EACxE,wBAAwB,CACzB,CAAC;IAEF,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yCAAyC,YAAY,gCAAgC,CACtF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,6DAA6D;QAC7D,oEAAoE;QACpE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC;QAC/C,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;QACpD,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/ledger/mcp/dist/lib/read.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Task 1771 — every graph read the ledger tools make.
+ *
+ * Kept in one module so the Cypher that defines "the payments on this invoice"
+ * exists once. If the payment read and the census read could disagree about
+ * what counts as a payment, the census would be reconciling against a
+ * different ledger than the one the tools write.
+ */
+import type { Session } from "neo4j-driver";
+import type { InvoiceRead } from "../tools/payment-record.js";
+import type { StatementRows } from "../tools/statement.js";
+import type { LedgerCensusRows } from "../../../../../lib/ledger-core/dist/index.js";
+export declare function readInvoice(session: Session, accountId: string, ref: string): Promise<InvoiceRead | null>;
+/** The op=verify re-read. Deliberately goes back to the graph rather than
+ *  trusting the figure the write path just computed. */
+export declare function verifyOutstanding(session: Session, accountId: string, ref: string): Promise<number>;
+/** Re-stamps paymentStatus on the parent invoice. schema-base.md requires the
+ *  property, so the only way to stop it lying is to keep it a projection of the
+ *  computed outstanding. */
+export declare function setPaymentStatus(session: Session, accountId: string, ref: string, status: "open" | "part-paid" | "paid"): Promise<void>;
+export declare function readStatement(session: Session, accountId: string): Promise<StatementRows>;
+/**
+ * The census rows. Each field answers one no-event failure mode: a payment
+ * that never got its parent edge, a balance property that has reappeared on an
+ * invoice, payments that look like accidental duplicates, and ledger indexes
+ * that are declared in schema.cypher but absent from this database.
+ */
+export declare function readCensus(session: Session, accountId: string): Promise<LedgerCensusRows>;
+//# sourceMappingURL=read.d.ts.map

package/payload/platform/plugins/ledger/mcp/dist/lib/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/lib/read.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAerF,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAgC7B;AAED;wDACwD;AACxD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;4BAE4B;AAC5B,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GACpC,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CA6CxB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAqD3B"}

package/payload/platform/plugins/ledger/mcp/dist/lib/read.js

@@ -0,0 +1,138 @@
+import { LEDGER_INDEX_NAMES, computeOutstanding, } from "../../../../../lib/ledger-core/dist/index.js";
+/** neo4j-driver returns Integer objects for counts; numbers pass through. */
+function toNum(v) {
+    if (typeof v === "number")
+        return v;
+    if (v && typeof v === "object" && "toNumber" in v) {
+        return v.toNumber();
+    }
+    return 0;
+}
+export async function readInvoice(session, accountId, ref) {
+    // Staged WITH: payments collapse to one row before the credit match expands
+    // again, so the two OPTIONAL MATCHes never form a cartesian product that
+    // would double-count both sums.
+    const res = await session.run(`MATCH (i:Invoice|InboundInvoice {accountId: $accountId, confirmationNumber: $ref})
+     OPTIONAL MATCH (i)-[:HAS_PAYMENT]->(p:InvoicePayment)
+     WITH i, collect(DISTINCT p) AS ps
+     OPTIONAL MATCH (i)-[:HAS_CREDIT]->(c:Credit)
+     WITH i, ps, collect(DISTINCT c) AS cs
+     RETURN labels(i) AS labels,
+            i.confirmationNumber AS invoiceId,
+            i.totalPaymentDue AS totalPaymentDue,
+            i.dueDate AS dueDate,
+            [x IN ps | x.amount] AS payments,
+            [x IN ps | x.paymentId] AS paymentIds,
+            [x IN cs | x.amount] AS credits`, { accountId, ref });
+    const rec = res.records[0];
+    if (rec === undefined)
+        return null;
+    const labels = rec.get("labels");
+    return {
+        label: labels.includes("InboundInvoice") ? "InboundInvoice" : "Invoice",
+        invoiceId: rec.get("invoiceId"),
+        totalPaymentDue: toNum(rec.get("totalPaymentDue")),
+        dueDateMs: Date.parse(rec.get("dueDate") ?? "") || 0,
+        payments: rec.get("payments").map(toNum),
+        credits: rec.get("credits").map(toNum),
+        paymentIds: rec.get("paymentIds").filter((x) => x !== null),
+    };
+}
+/** The op=verify re-read. Deliberately goes back to the graph rather than
+ *  trusting the figure the write path just computed. */
+export async function verifyOutstanding(session, accountId, ref) {
+    const invoice = await readInvoice(session, accountId, ref);
+    if (invoice === null)
+        return Number.NaN;
+    return computeOutstanding(invoice.totalPaymentDue, invoice.payments, invoice.credits);
+}
+/** Re-stamps paymentStatus on the parent invoice. schema-base.md requires the
+ *  property, so the only way to stop it lying is to keep it a projection of the
+ *  computed outstanding. */
+export async function setPaymentStatus(session, accountId, ref, status) {
+    await session.run(`MATCH (i:Invoice|InboundInvoice {accountId: $accountId, confirmationNumber: $ref})
+     SET i.paymentStatus = $status`, { accountId, ref, status });
+}
+export async function readStatement(session, accountId) {
+    const res = await session.run(`MATCH (i:Invoice|InboundInvoice {accountId: $accountId})
+     OPTIONAL MATCH (i)-[:HAS_PAYMENT]->(p:InvoicePayment)
+     WITH i, collect(DISTINCT p) AS ps
+     OPTIONAL MATCH (i)-[:HAS_CREDIT]->(c:Credit)
+     WITH i, ps, collect(DISTINCT c) AS cs
+     RETURN labels(i) AS labels, i.confirmationNumber AS ref,
+            i.totalPaymentDue AS totalPaymentDue, i.dueDate AS dueDate,
+            [x IN ps | x.amount] AS payments, [x IN cs | x.amount] AS credits`, { accountId });
+    const receivables = [];
+    const payables = [];
+    for (const rec of res.records) {
+        const outstanding = computeOutstanding(toNum(rec.get("totalPaymentDue")), rec.get("payments").map(toNum), rec.get("credits").map(toNum));
+        // A settled invoice is not part of the open position.
+        if (outstanding <= 0)
+            continue;
+        const row = {
+            ref: rec.get("ref"),
+            dueDateMs: Date.parse(rec.get("dueDate") ?? "") || 0,
+            outstanding,
+        };
+        if (rec.get("labels").includes("InboundInvoice"))
+            payables.push(row);
+        else
+            receivables.push(row);
+    }
+    const cash = await session.run(`MATCH (ce:CashEntry {accountId: $accountId})
+     RETURN ce.direction AS direction, sum(ce.amount) AS total`, { accountId });
+    let cashIn = 0;
+    let cashOut = 0;
+    for (const rec of cash.records) {
+        if (rec.get("direction") === "in")
+            cashIn = toNum(rec.get("total"));
+        else
+            cashOut = toNum(rec.get("total"));
+    }
+    return { receivables, payables, cashIn, cashOut };
+}
+/**
+ * The census rows. Each field answers one no-event failure mode: a payment
+ * that never got its parent edge, a balance property that has reappeared on an
+ * invoice, payments that look like accidental duplicates, and ledger indexes
+ * that are declared in schema.cypher but absent from this database.
+ */
+export async function readCensus(session, accountId) {
+    const counts = await session.run(
+    // OPTIONAL MATCH, not MATCH: with no payments a plain MATCH eliminates the
+    // row, so records[0] is undefined and invoices reports 0 as well. That is
+    // exactly the flat-counts signature the census uses to detect writes that
+    // never landed, so the bug would manufacture its own alarm condition.
+    `MATCH (i:Invoice|InboundInvoice {accountId: $accountId})
+     WITH count(i) AS invoices
+     OPTIONAL MATCH (p:InvoicePayment {accountId: $accountId})
+     RETURN invoices, count(p) AS payments`, { accountId });
+    const orphans = await session.run(`MATCH (p:InvoicePayment {accountId: $accountId})
+     WHERE NOT ( (:Invoice|InboundInvoice)-[:HAS_PAYMENT]->(p) )
+     RETURN count(p) AS orphanPayments`, { accountId });
+    // The forbidden-property check. schema-base.md bans these on the invoice
+    // labels precisely because a stored figure drifts in silence.
+    const stored = await session.run(`MATCH (i:Invoice|InboundInvoice {accountId: $accountId})
+     WHERE i.outstanding IS NOT NULL OR i.balance IS NOT NULL OR i.amountPaid IS NOT NULL
+     RETURN count(i) AS storedBalanceProps`, { accountId });
+    const keys = await session.run(`MATCH (i:Invoice|InboundInvoice {accountId: $accountId})-[:HAS_PAYMENT]->(p:InvoicePayment)
+     RETURN i.confirmationNumber AS invoiceId, p.paymentId AS paymentId,
+            p.amount AS amount, p.date AS date`, { accountId });
+    const indexes = await session.run(`SHOW INDEXES YIELD name RETURN collect(name) AS names`);
+    const live = new Set(indexes.records[0]?.get("names") ?? []);
+    const declaredNotLive = LEDGER_INDEX_NAMES.filter((n) => !live.has(n));
+    return {
+        invoices: toNum(counts.records[0]?.get("invoices")),
+        payments: toNum(counts.records[0]?.get("payments")),
+        orphanPayments: toNum(orphans.records[0]?.get("orphanPayments")),
+        storedBalanceProps: toNum(stored.records[0]?.get("storedBalanceProps")),
+        paymentKeys: keys.records.map((r) => ({
+            invoiceId: r.get("invoiceId") ?? "",
+            paymentId: r.get("paymentId") ?? "",
+            amount: toNum(r.get("amount")),
+            date: r.get("date") ?? "",
+        })),
+        declaredNotLive,
+    };
+}
+//# sourceMappingURL=read.js.map

package/payload/platform/plugins/ledger/mcp/dist/lib/read.js.map

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

package/payload/platform/plugins/ledger/mcp/dist/lib/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Task 1771 — shared shapes for the ledger tools.
+ *
+ * `write` and `read` are injected rather than imported by the tool modules so
+ * the unit tests can exercise the decision logic without loading the Neo4j
+ * driver. `index.ts` passes the real `writeNodeWithEdges` and the real reads.
+ */
+import type { Session } from "neo4j-driver";
+export interface CreatedBy {
+    agent: string;
+    session: string;
+    tool: string;
+}
+export interface GraphRelationship {
+    type: string;
+    direction: "incoming" | "outgoing";
+    targetLabel: string;
+    targetProps: Record<string, unknown>;
+}
+export interface WriteParams {
+    session: Session;
+    labels: string[];
+    props: Record<string, unknown>;
+    relationships: GraphRelationship[];
+    createdBy: CreatedBy;
+}
+export interface WriteResult {
+    nodesCreated?: number;
+    edgesCreated?: number;
+}
+export type WriteFn = (params: WriteParams) => Promise<WriteResult>;
+export interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function ok(text: string): ToolResult;
+export declare function fail(text: string): ToolResult;
+/** Money as the operator typed it, formatted for a reply. */
+export declare function money(n: number): string;
+/** The direction of an invoice, which selects its label. Payments derive their
+ *  own direction from whichever of these two they hang beneath. */
+export type InvoiceDirection = "receivable" | "payable";
+export declare function labelFor(direction: InvoiceDirection): "Invoice" | "InboundInvoice";
+//# sourceMappingURL=types.d.ts.map

package/payload/platform/plugins/ledger/mcp/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAE3C;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAE7C;AAED,6DAA6D;AAC7D,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvC;AAED;mEACmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,SAAS,CAAC;AAExD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,GAAG,gBAAgB,CAElF"}

package/payload/platform/plugins/ledger/mcp/dist/lib/types.js

@@ -0,0 +1,14 @@
+export function ok(text) {
+    return { content: [{ type: "text", text }] };
+}
+export function fail(text) {
+    return { content: [{ type: "text", text }], isError: true };
+}
+/** Money as the operator typed it, formatted for a reply. */
+export function money(n) {
+    return n.toFixed(2);
+}
+export function labelFor(direction) {
+    return direction === "receivable" ? "Invoice" : "InboundInvoice";
+}
+//# sourceMappingURL=types.js.map

package/payload/platform/plugins/ledger/mcp/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AA0CA,MAAM,UAAU,EAAE,CAAC,IAAY;IAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAMD,MAAM,UAAU,QAAQ,CAAC,SAA2B;IAClD,OAAO,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC;AACnE,CAAC"}

package/payload/platform/plugins/ledger/mcp/dist/tools/balance.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Task 1771 — what is still owed on one invoice.
+ *
+ * Every figure here is computed from the invoice's children at read time. None
+ * of them is stored, which is why this tool and the census can never disagree
+ * with each other about the same invoice.
+ */
+import type { Session } from "neo4j-driver";
+import { type ReadFn } from "./payment-record.js";
+import { type ToolResult } from "../lib/types.js";
+export interface BalanceParams {
+    session: Session;
+    read: ReadFn;
+    accountId: string;
+    invoiceRef: string;
+}
+export declare function balance(params: BalanceParams): Promise<ToolResult>;
+//# sourceMappingURL=balance.d.ts.map

package/payload/platform/plugins/ledger/mcp/dist/tools/balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../src/tools/balance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,iBAAiB,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CA8BxE"}

package/payload/platform/plugins/ledger/mcp/dist/tools/balance.js

@@ -0,0 +1,23 @@
+import { computeOutstanding } from "../../../../../lib/ledger-core/dist/index.js";
+import { fail, money, ok } from "../lib/types.js";
+export async function balance(params) {
+    const { session, read, accountId, invoiceRef } = params;
+    const invoice = await read(session, accountId, invoiceRef);
+    if (invoice === null) {
+        // Reporting zero for an unknown reference would read as "nothing owed",
+        // which is the opposite of "I could not find it".
+        return fail(`[ledger] op=reject reason=unknown-invoice ref=${invoiceRef} — no invoice or bill with that reference on this account.`);
+    }
+    const applied = invoice.payments.reduce((a, b) => a + b, 0);
+    const credited = invoice.credits.reduce((a, b) => a + b, 0);
+    const outstanding = computeOutstanding(invoice.totalPaymentDue, invoice.payments, invoice.credits);
+    const kind = invoice.label === "Invoice" ? "Invoice" : "Bill";
+    return ok([
+        `${kind} ${invoiceRef}`,
+        `Total: ${money(invoice.totalPaymentDue)}`,
+        `Paid: ${money(applied)} across ${invoice.payments.length} payment(s)`,
+        `Credits: ${money(credited)}`,
+        `Outstanding: ${money(outstanding)}`,
+    ].join("\n"));
+}
+//# sourceMappingURL=balance.js.map

package/payload/platform/plugins/ledger/mcp/dist/tools/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../src/tools/balance.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAElF,OAAO,EAAmB,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AASnE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAqB;IACjD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAExD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,wEAAwE;QACxE,kDAAkD;QAClD,OAAO,IAAI,CACT,iDAAiD,UAAU,4DAA4D,CACxH,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,kBAAkB,CACpC,OAAO,CAAC,eAAe,EACvB,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,OAAO,CAChB,CAAC;IACF,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IAE9D,OAAO,EAAE,CACP;QACE,GAAG,IAAI,IAAI,UAAU,EAAE;QACvB,UAAU,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE;QAC1C,SAAS,KAAK,CAAC,OAAO,CAAC,WAAW,OAAO,CAAC,QAAQ,CAAC,MAAM,aAAa;QACtE,YAAY,KAAK,CAAC,QAAQ,CAAC,EAAE;QAC7B,gBAAgB,KAAK,CAAC,WAAW,CAAC,EAAE;KACrC,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/ledger/mcp/dist/tools/cash-record.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Task 1771 — a movement of money attached to no invoice.
+ *
+ * Bank charges, a cash sale, drawings, a refund. `:CashEntry` is the one
+ * ledger label that stores its own `direction`, because unlike an
+ * `:InvoicePayment` it has no parent invoice to derive it from.
+ */
+import type { Session } from "neo4j-driver";
+import { type CreatedBy, type ToolResult, type WriteFn } from "../lib/types.js";
+export interface CashRecordParams {
+    session: Session;
+    write: WriteFn;
+    accountId: string;
+    createdBy: CreatedBy;
+    direction: "in" | "out";
+    amount: number;
+    date: string;
+    description: string;
+    counterparty?: string;
+    /** schema-base.md declares COUNTERPARTY to both :Person and :Organization.
+     *  Defaulting everything to Organization would file a person under the
+     *  business list and split their identity across two labels. */
+    counterpartyType?: "person" | "organization";
+}
+export declare function cashRecord(params: CashRecordParams): Promise<ToolResult>;
+//# sourceMappingURL=cash-record.d.ts.map

package/payload/platform/plugins/ledger/mcp/dist/tools/cash-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cash-record.d.ts","sourceRoot":"","sources":["../../src/tools/cash-record.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,UAAU,EACf,KAAK,OAAO,EAIb,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,IAAI,GAAG,KAAK,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;oEAEgE;IAChE,gBAAgB,CAAC,EAAE,QAAQ,GAAG,cAAc,CAAC;CAC9C;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuD9E"}

package/payload/platform/plugins/ledger/mcp/dist/tools/cash-record.js

@@ -0,0 +1,33 @@
+import { cashEntryIdFor } from "../lib/ids.js";
+import { fail, money, ok, } from "../lib/types.js";
+export async function cashRecord(params) {
+    const { session, write, accountId, createdBy, direction, amount, date, description, counterparty, counterpartyType, } = params;
+    const text = description.trim();
+    if (text === "") {
+        return fail("[ledger] op=reject reason=blank-description — a cash entry with no description is unauditable later. Nothing was written.");
+    }
+    if (!(amount > 0)) {
+        return fail(`[ledger] op=reject reason=non-positive-amount amount=${amount} — direction carries the sign, so the amount is always positive. Nothing was written.`);
+    }
+    const entryId = cashEntryIdFor(accountId, direction, amount, date, text);
+    const relationships = counterparty === undefined || counterparty.trim() === ""
+        ? []
+        : [
+            {
+                type: "COUNTERPARTY",
+                direction: "outgoing",
+                targetLabel: counterpartyType === "person" ? "Person" : "Organization",
+                targetProps: { accountId, name: counterparty.trim() },
+            },
+        ];
+    const result = await write({
+        session,
+        labels: ["CashEntry"],
+        props: { accountId, entryId, direction, amount, date, description: text },
+        relationships,
+        createdBy,
+    });
+    console.error(`[ledger] op=write tool=cash-record entryId=${entryId} direction=${direction} amount=${money(amount)} nodesCreated=${result.nodesCreated ?? 0} edgesCreated=${result.edgesCreated ?? 0}`);
+    return ok(`Recorded ${money(amount)} ${direction === "in" ? "received" : "paid out"} on ${date}: ${text}.`);
+}
+//# sourceMappingURL=cash-record.js.map

package/payload/platform/plugins/ledger/mcp/dist/tools/cash-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cash-record.js","sourceRoot":"","sources":["../../src/tools/cash-record.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAKL,IAAI,EACJ,KAAK,EACL,EAAE,GACH,MAAM,iBAAiB,CAAC;AAkBzB,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAwB;IACvD,MAAM,EACJ,OAAO,EACP,KAAK,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,MAAM,EACN,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,gBAAgB,GACjB,GAAG,MAAM,CAAC;IAEX,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,OAAO,IAAI,CACT,2HAA2H,CAC5H,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QAClB,OAAO,IAAI,CACT,wDAAwD,MAAM,uFAAuF,CACtJ,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAEzE,MAAM,aAAa,GACjB,YAAY,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE;QACtD,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE;gBACE,IAAI,EAAE,cAAc;gBACpB,SAAS,EAAE,UAAU;gBACrB,WAAW,EAAE,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc;gBACtE,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,EAAE;aACtD;SACF,CAAC;IAER,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QACzB,OAAO;QACP,MAAM,EAAE,CAAC,WAAW,CAAC;QACrB,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;QACzE,aAAa;QACb,SAAS;KACV,CAAC,CAAC;IAEH,OAAO,CAAC,KAAK,CACX,8CAA8C,OAAO,cAAc,SAAS,WAAW,KAAK,CAAC,MAAM,CAAC,iBAAiB,MAAM,CAAC,YAAY,IAAI,CAAC,iBAAiB,MAAM,CAAC,YAAY,IAAI,CAAC,EAAE,CACzL,CAAC;IAEF,OAAO,EAAE,CACP,YAAY,KAAK,CAAC,MAAM,CAAC,IAAI,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,OAAO,IAAI,KAAK,IAAI,GAAG,CACjG,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/ledger/mcp/dist/tools/invoice-record.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Task 1771 — raise a receivable invoice, or record a payable bill.
+ *
+ * One tool for both directions because they are the same document seen from
+ * two sides; the required `direction` selects `:Invoice` or `:InboundInvoice`.
+ * Nothing here stores what is owed: `totalPaymentDue` is the face value of the
+ * bill and outstanding is computed on read from the payment and credit
+ * children.
+ */
+import type { Session } from "neo4j-driver";
+import { type CreatedBy, type InvoiceDirection, type ToolResult, type WriteFn } from "../lib/types.js";
+export interface InvoiceRecordParams {
+    session: Session;
+    write: WriteFn;
+    accountId: string;
+    createdBy: CreatedBy;
+    direction: InvoiceDirection;
+    /** The invoice or bill reference. Natural key with accountId. */
+    confirmationNumber: string;
+    /** Who owes it (receivable) or who is owed (payable). */
+    counterparty: string;
+    totalPaymentDue: number;
+    dueDate: string;
+    description?: string;
+}
+export declare function invoiceRecord(params: InvoiceRecordParams): Promise<ToolResult>;
+//# sourceMappingURL=invoice-record.d.ts.map

package/payload/platform/plugins/ledger/mcp/dist/tools/invoice-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-record.d.ts","sourceRoot":"","sources":["../../src/tools/invoice-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,OAAO,EAKb,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,iEAAiE;IACjE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4DpF"}

package/payload/platform/plugins/ledger/mcp/dist/tools/invoice-record.js

@@ -0,0 +1,40 @@
+import { fail, labelFor, money, ok, } from "../lib/types.js";
+export async function invoiceRecord(params) {
+    const { session, write, accountId, createdBy, direction, confirmationNumber, counterparty, totalPaymentDue, dueDate, description, } = params;
+    const ref = confirmationNumber.trim();
+    if (ref === "") {
+        return fail("[ledger] op=reject reason=blank-reference — an invoice needs a reference to be found by later.");
+    }
+    if (!(totalPaymentDue > 0)) {
+        return fail(`[ledger] op=reject reason=non-positive-total total=${totalPaymentDue} — an invoice for nothing is not an invoice. Nothing was written.`);
+    }
+    const label = labelFor(direction);
+    const isPayable = direction === "payable";
+    const props = {
+        accountId,
+        confirmationNumber: ref,
+        totalPaymentDue,
+        paymentStatus: "open",
+        dueDate,
+    };
+    // The two labels name their counterparty differently: schema-base.md requires
+    // `supplier` on InboundInvoice and `customer` on Invoice.
+    if (isPayable)
+        props.supplier = counterparty;
+    else
+        props.customer = counterparty;
+    if (description !== undefined)
+        props.description = description;
+    const relationships = [
+        {
+            type: isPayable ? "FROM_SUPPLIER" : "BILLED_TO",
+            direction: "outgoing",
+            targetLabel: "Organization",
+            targetProps: { accountId, name: counterparty },
+        },
+    ];
+    const result = await write({ session, labels: [label], props, relationships, createdBy });
+    console.error(`[ledger] op=write tool=invoice-record ref=${ref} label=${label} total=${money(totalPaymentDue)} nodesCreated=${result.nodesCreated ?? 0} edgesCreated=${result.edgesCreated ?? 0}`);
+    return ok(`Recorded ${label === "Invoice" ? "invoice" : "bill"} ${ref} for ${counterparty}, ${money(totalPaymentDue)} due ${dueDate}. Outstanding is computed from payments, not stored.`);
+}
+//# sourceMappingURL=invoice-record.js.map

package/payload/platform/plugins/ledger/mcp/dist/tools/invoice-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-record.js","sourceRoot":"","sources":["../../src/tools/invoice-record.ts"],"names":[],"mappings":"AAUA,OAAO,EAML,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,EAAE,GACH,MAAM,iBAAiB,CAAC;AAiBzB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAA2B;IAC7D,MAAM,EACJ,OAAO,EACP,KAAK,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,OAAO,EACP,WAAW,GACZ,GAAG,MAAM,CAAC;IAEX,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACf,OAAO,IAAI,CACT,gGAAgG,CACjG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CACT,sDAAsD,eAAe,mEAAmE,CACzI,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,SAAS,KAAK,SAAS,CAAC;IAE1C,MAAM,KAAK,GAA4B;QACrC,SAAS;QACT,kBAAkB,EAAE,GAAG;QACvB,eAAe;QACf,aAAa,EAAE,MAAM;QACrB,OAAO;KACR,CAAC;IACF,8EAA8E;IAC9E,0DAA0D;IAC1D,IAAI,SAAS;QAAE,KAAK,CAAC,QAAQ,GAAG,YAAY,CAAC;;QACxC,KAAK,CAAC,QAAQ,GAAG,YAAY,CAAC;IACnC,IAAI,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAE/D,MAAM,aAAa,GAAwB;QACzC;YACE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW;YAC/C,SAAS,EAAE,UAAU;YACrB,WAAW,EAAE,cAAc;YAC3B,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE;SAC/C;KACF,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;IAE1F,OAAO,CAAC,KAAK,CACX,6CAA6C,GAAG,UAAU,KAAK,UAAU,KAAK,CAAC,eAAe,CAAC,iBAAiB,MAAM,CAAC,YAAY,IAAI,CAAC,iBAAiB,MAAM,CAAC,YAAY,IAAI,CAAC,EAAE,CACpL,CAAC;IAEF,OAAO,EAAE,CACP,YAAY,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,QAAQ,YAAY,KAAK,KAAK,CAAC,eAAe,CAAC,QAAQ,OAAO,sDAAsD,CAChL,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/ledger/mcp/dist/tools/payment-record.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Task 1771 — apply a payment or a credit to an invoice.
+ *
+ * One code path for both because a credit reduces what is owed exactly as a
+ * payment does; they differ in provenance, not arithmetic, and splitting them
+ * would mean two places to get the over-application rule wrong.
+ *
+ * The lifecycle here is the point of the task. `op=write` proves only that the
+ * write was issued. `op=verify` re-reads outstanding from the graph afterwards
+ * and compares it against what the arithmetic predicted; a mismatch is reported
+ * as an error rather than swallowed, because a ledger that silently disagrees
+ * with itself is worse than one that refuses.
+ */
+import type { Session } from "neo4j-driver";
+import { type CreatedBy, type ToolResult, type WriteFn } from "../lib/types.js";
+/** What a resolved invoice looks like to this tool. */
+export interface InvoiceRead {
+    label: "Invoice" | "InboundInvoice";
+    invoiceId: string;
+    totalPaymentDue: number;
+    dueDateMs: number;
+    payments: number[];
+    credits: number[];
+    paymentIds: string[];
+}
+export type ReadFn = (session: Session, accountId: string, ref: string) => Promise<InvoiceRead | null>;
+/** Re-reads outstanding straight from the graph after the write. */
+export type VerifyFn = (session: Session, accountId: string, ref: string) => Promise<number>;
+/** Re-stamps the parent's paymentStatus from the recomputed outstanding. */
+export type SetStatusFn = (session: Session, accountId: string, ref: string, status: "open" | "part-paid" | "paid") => Promise<void>;
+export interface PaymentRecordParams {
+    session: Session;
+    read: ReadFn;
+    write: WriteFn;
+    verify: VerifyFn;
+    setStatus: SetStatusFn;
+    accountId: string;
+    createdBy: CreatedBy;
+    invoiceRef: string;
+    amount: number;
+    date: string;
+    paymentType: string;
+    kind: "payment" | "credit";
+}
+export declare function paymentRecord(params: PaymentRecordParams): Promise<ToolResult>;
+//# sourceMappingURL=payment-record.d.ts.map

package/payload/platform/plugins/ledger/mcp/dist/tools/payment-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-record.d.ts","sourceRoot":"","sources":["../../src/tools/payment-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EACL,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,OAAO,EAIb,MAAM,iBAAiB,CAAC;AAEzB,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,MAAM,MAAM,GAAG,CACnB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;AAEjC,oEAAoE;AACpE,MAAM,MAAM,QAAQ,GAAG,CACrB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,CACxB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,KAClC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC5B;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8HpF"}

package/payload/platform/plugins/ledger/mcp/dist/tools/payment-record.js

@@ -0,0 +1,68 @@
+import { applyPayment, computeOutstanding } from "../../../../../lib/ledger-core/dist/index.js";
+import { creditIdFor, paymentIdFor } from "../lib/ids.js";
+import { fail, money, ok, } from "../lib/types.js";
+export async function paymentRecord(params) {
+    const { session, read, write, verify, setStatus, accountId, createdBy, invoiceRef, amount, date, paymentType, kind, } = params;
+    const started = Date.now();
+    const isCredit = kind === "credit";
+    const invoice = await read(session, accountId, invoiceRef);
+    if (invoice === null) {
+        console.error(`[ledger] op=reject tool=payment-record ref=${invoiceRef} reason=unknown-invoice`);
+        return fail(`[ledger] op=reject reason=unknown-invoice ref=${invoiceRef} — no invoice or bill with that reference on this account. Nothing was written.`);
+    }
+    console.error(`[ledger] op=resolve tool=payment-record ref=${invoiceRef} found=true label=${invoice.label} totalPaymentDue=${money(invoice.totalPaymentDue)}`);
+    // A credit reduces a receivable. An InboundInvoice is money we owe; reducing
+    // it is a supplier credit note, which is a different document and not in
+    // scope, so refuse rather than write a Credit the reader cannot interpret.
+    if (isCredit && invoice.label === "InboundInvoice") {
+        console.error(`[ledger] op=reject tool=payment-record ref=${invoiceRef} reason=credit-on-payable`);
+        return fail(`[ledger] op=reject reason=credit-on-payable ref=${invoiceRef} — credits apply to invoices you raised, not to bills you received. Nothing was written.`);
+    }
+    const outcome = applyPayment(invoice.totalPaymentDue, invoice.payments, invoice.credits, amount);
+    const outstandingBefore = computeOutstanding(invoice.totalPaymentDue, invoice.payments, invoice.credits);
+    if (!outcome.accepted) {
+        console.error(`[ledger] op=reject tool=payment-record ref=${invoiceRef} reason=over-application amount=${money(amount)} remaining=${money(outcome.remaining)}`);
+        return fail(`[ledger] op=reject reason=over-application ref=${invoiceRef} — ${money(amount)} exceeds the ${money(outcome.remaining)} still outstanding. Nothing was written. Record ${money(outcome.remaining)} to settle it, or raise a separate invoice for the excess.`);
+    }
+    console.error(`[ledger] op=arithmetic tool=payment-record ref=${invoiceRef} priorApplied=${money(invoice.payments.reduce((a, b) => a + b, 0))} priorCredits=${money(invoice.credits.reduce((a, b) => a + b, 0))} amount=${money(amount)} outstandingBefore=${money(outstandingBefore)} outstandingAfter=${money(outcome.outstandingAfter)}`);
+    const childId = isCredit
+        ? creditIdFor(accountId, invoice.invoiceId, amount, date)
+        : paymentIdFor(accountId, invoice.invoiceId, amount, date, paymentType);
+    // Direction is NOT stored. Which of the two parent labels this hangs from is
+    // what says whether the money came in or went out.
+    const props = isCredit
+        ? { accountId, creditId: childId, amount, date }
+        : { accountId, invoiceId: invoice.invoiceId, paymentId: childId, amount, date, paymentType };
+    const result = await write({
+        session,
+        labels: [isCredit ? "Credit" : "InvoicePayment"],
+        props,
+        relationships: [
+            {
+                type: isCredit ? "HAS_CREDIT" : "HAS_PAYMENT",
+                direction: "incoming",
+                targetLabel: invoice.label,
+                targetProps: { accountId, confirmationNumber: invoice.invoiceId },
+            },
+        ],
+        createdBy,
+    });
+    console.error(`[ledger] op=write tool=payment-record ref=${invoiceRef} ${isCredit ? "creditId" : "paymentId"}=${childId} nodesCreated=${result.nodesCreated ?? 0} edgesCreated=${result.edgesCreated ?? 0}`);
+    const reRead = await verify(session, accountId, invoiceRef);
+    console.error(`[ledger] op=verify tool=payment-record ref=${invoiceRef} outstandingReRead=${money(reRead)} outstandingAfter=${money(outcome.outstandingAfter)}`);
+    if (reRead !== outcome.outstandingAfter) {
+        console.error(`[ledger] op=exit tool=payment-record ref=${invoiceRef} ranMs=${Date.now() - started} outcome=error`);
+        return fail(`[ledger] op=verify mismatch ref=${invoiceRef} — the write was issued but re-reading the invoice gives ${money(reRead)} outstanding where the arithmetic expected ${money(outcome.outstandingAfter)}. Treat this invoice as unreliable until reconciled; do not record further payments against it.`);
+    }
+    // schema-base.md requires paymentStatus on both invoice labels, so it cannot
+    // simply be dropped the way a stored balance was. Left unmaintained it lies
+    // in exactly the same way: an invoice settled in full would read "open"
+    // forever. Re-stamp it from the figure just verified, so the stored status is
+    // always a projection of the computed one rather than a rival to it.
+    const status = reRead === 0 ? "paid" : "part-paid";
+    await setStatus(session, accountId, invoiceRef, status);
+    console.error(`[ledger] op=status tool=payment-record ref=${invoiceRef} paymentStatus=${status}`);
+    console.error(`[ledger] op=exit tool=payment-record ref=${invoiceRef} ranMs=${Date.now() - started} outcome=applied`);
+    return ok(`Recorded ${money(amount)} ${isCredit ? "credit" : "payment"} against ${invoiceRef}. Outstanding is now ${money(reRead)}, re-read from the graph.`);
+}
+//# sourceMappingURL=payment-record.js.map

package/payload/platform/plugins/ledger/mcp/dist/tools/payment-record.js.map

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

package/payload/platform/plugins/ledger/mcp/dist/tools/reconcile.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Task 1771 — the on-demand form of the ledger census.
+ *
+ * This calls the same `reconcileLedger` as the standing interval in the UI
+ * server. The tool exists so an operator can ask "is the ledger healthy" mid
+ * conversation; the interval exists because a failure that emits no event
+ * cannot wait for someone to ask.
+ */
+import type { Session } from "neo4j-driver";
+import { type LedgerCensusRows } from "../../../../../lib/ledger-core/dist/index.js";
+import { type ToolResult } from "../lib/types.js";
+export type CensusReadFn = (session: Session, accountId: string) => Promise<LedgerCensusRows>;
+export interface ReconcileParams {
+    session: Session;
+    read: CensusReadFn;
+    accountId: string;
+    now: number;
+}
+export declare function reconcile(params: ReconcileParams): Promise<ToolResult>;
+//# sourceMappingURL=reconcile.d.ts.map

package/payload/platform/plugins/ledger/mcp/dist/tools/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/tools/reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,KAAK,UAAU,EAAM,MAAM,iBAAiB,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG,CACzB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAuC5E"}