@mulmoclaude/accounting-plugin 0.1.0

package/dist/server/snapshotCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotCache.d.ts","sourceRoot":"","sources":["../../src/server/snapshotCache.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,cAAc,EAAgB,aAAa,EAAE,MAAM,YAAY,CAAC;AA2B9E;;;oEAGoE;AACpE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA8BvH;AAED;;;6BAG6B;AAC7B,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CASvH;AAED;;sDAEsD;AACtD,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAExI;AAED;;eAEe;AACf,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAOhH;AA4HD;;;uEAGuE;AACvE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAShG;AAED;;;mDAGmD;AACnD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpE;AAED;;;;2DAI2D;AAC3D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOlD;AAED;2DAC2D;AAC3D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAWA;AAED;;mEAEmE;AACnE,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC,CAUlE"}

package/dist/server/timeSeries.d.ts

@@ -0,0 +1,47 @@
+import type { Account, JournalEntry } from "./types.js";
+import { type FiscalYearEnd, TIME_SERIES_GRANULARITIES, TIME_SERIES_METRICS, type TimeSeriesGranularity, type TimeSeriesMetric } from "../shared";
+export { TIME_SERIES_GRANULARITIES, TIME_SERIES_METRICS };
+export type { TimeSeriesGranularity, TimeSeriesMetric };
+export interface Bucket {
+    /** Inclusive YYYY-MM-DD lower bound. */
+    from: string;
+    /** Inclusive YYYY-MM-DD upper bound. */
+    to: string;
+    /** Chart x-axis label. Format depends on granularity:
+     *  "YYYY-MM" / "FY{endYear}-Q{1..4}" / "FY{endYear}". For fiscal
+     *  years that don't align with the calendar year (Q1/Q2/Q3 books)
+     *  the FY is named by its END calendar year — matches Japanese
+     *  "令和7年度" convention (Apr 2025 - Mar 2026 = FY2026). */
+    label: string;
+}
+export interface TimeSeriesPoint {
+    label: string;
+    from: string;
+    to: string;
+    /** Single number, natural-sign per metric. Revenue and net income
+     *  positive when income exceeds expense; expense reported as a
+     *  positive cost; account balance follows the account's display
+     *  sign (assets debit-positive, liabilities/equity credit-positive). */
+    value: number;
+}
+/** Walk inclusive `[from, to]` and return every bucket that overlaps
+ *  it, ordered ascending by `from`. The first bucket is the one
+ *  CONTAINING `from` — it can extend earlier than `from`; the last
+ *  bucket is the one CONTAINING `to` — it can extend past `to`. The
+ *  caller's response echoes the input range so the LLM can label the
+ *  chart truthfully ("Revenue Apr 2025 – Sep 2026" even though the
+ *  outermost buckets cover Apr-Jun 2025 and Jul-Sep 2026). */
+export declare function bucketize(input: {
+    from: string;
+    to: string;
+    granularity: TimeSeriesGranularity;
+    fiscalYearEnd: FiscalYearEnd;
+}): Bucket[];
+export declare function buildTimeSeries(input: {
+    buckets: readonly Bucket[];
+    entries: readonly JournalEntry[];
+    accounts: readonly Account[];
+    metric: TimeSeriesMetric;
+    accountCode?: string;
+}): TimeSeriesPoint[];
+//# sourceMappingURL=timeSeries.d.ts.map

package/dist/server/timeSeries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeSeries.d.ts","sourceRoot":"","sources":["../../src/server/timeSeries.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EAEL,KAAK,aAAa,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,CAAC;AAC1D,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,CAAC;AAExD,MAAM,WAAW,MAAM;IACrB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX;;;;6DAIyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX;;;4EAGwE;IACxE,KAAK,EAAE,MAAM,CAAC;CACf;AA8GD;;;;;;8DAM8D;AAC9D,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,qBAAqB,CAAC;IAAC,aAAa,EAAE,aAAa,CAAA;CAAE,GAAG,MAAM,EAAE,CAazI;AAkED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,eAAe,EAAE,CAapB"}

package/dist/server/types.d.ts

@@ -0,0 +1,134 @@
+import type { SupportedCountryCode, FiscalYearEnd } from "../shared";
+export declare const ACCOUNT_TYPES: readonly ["asset", "liability", "equity", "income", "expense"];
+export type AccountType = (typeof ACCOUNT_TYPES)[number];
+/** B/S accounts (assets / liabilities / equity). Used by opening
+ *  balance validation: opening entries reference balance-sheet
+ *  accounts only. */
+export declare const BALANCE_SHEET_ACCOUNT_TYPES: readonly AccountType[];
+export interface Account {
+    /** Stable identifier the journal lines reference. Typically a
+     *  numeric string ("1000" / "2000" …) but free-form is allowed
+     *  so the user can adopt their existing numbering. */
+    code: string;
+    name: string;
+    type: AccountType;
+    /** Optional free-form note (tax bucket, parent group, …). Not
+     *  interpreted by the engine — passes through verbatim. */
+    note?: string;
+    /** Soft-delete flag. When `false`, the account is hidden from
+     *  entry/ledger dropdowns but stays visible in Manage Accounts
+     *  and historical entries — accounting integrity requires that
+     *  a code referenced by a journal line never disappears. Omitted
+     *  (treated as active) by default to keep the JSON files clean
+     *  for books created before this field existed. */
+    active?: boolean;
+}
+export interface BookSummary {
+    id: string;
+    name: string;
+    /** ISO 4217 (e.g. "USD" / "JPY"). Single-currency per book — no
+     *  cross-book aggregation. */
+    currency: string;
+    /** ISO 3166-1 alpha-2 country code (e.g. "US" / "JP" / "GB").
+     *  Identifies the tax jurisdiction the book is kept under so the
+     *  Accounting role can give country-aware advice (Japanese T-number
+     *  under インボイス制度, EU VAT ID, GSTIN, ABN, etc.). Constrained
+     *  to `SupportedCountryCode` (the curated list shared with the UI
+     *  dropdown and the LLM tool's JSON-schema enum) so a typo from any
+     *  ingress path is rejected at the service layer rather than silently
+     *  persisted. Optional for backward compatibility with books created
+     *  before the field was introduced; the UI prompts existing books
+     *  to set it. */
+    country?: SupportedCountryCode;
+    /** Which calendar-quarter end is the book's fiscal year end:
+     *    Q1 → March 31, Q2 → June 30, Q3 → September 30, Q4 → December 31.
+     *  Drives the UI's "current quarter / current year" date-range
+     *  shortcuts. Optional in the persisted shape for backward
+     *  compatibility with books written before this field existed —
+     *  read-side code treats the absent value as Q4 via
+     *  `resolveFiscalYearEnd`. New books require it at the create
+     *  boundary; the default is Q4. */
+    fiscalYearEnd?: FiscalYearEnd;
+    createdAt: string;
+}
+export interface AccountingConfig {
+    books: BookSummary[];
+}
+export type JournalEntryKind = "normal" | "opening" | "void" | "void-marker";
+export interface JournalLine {
+    accountCode: string;
+    /** Use exactly one of debit / credit per line, both as positive
+     *  numbers. The engine treats them as separate fields rather than
+     *  a single signed amount so the input matches a standard
+     *  bookkeeping form. */
+    debit?: number;
+    credit?: number;
+    /** Per-line memo (the entry-level memo lives on JournalEntry). */
+    memo?: string;
+    /** Counterparty's tax-authority-issued registration ID for this
+     *  line — Japanese 適格請求書発行事業者登録番号 (T-number), EU
+     *  VAT identification number, UK VAT registration number, India
+     *  GSTIN, Australia ABN, etc. Required for input-tax-credit
+     *  eligibility under the Japanese インボイス制度 (effective
+     *  2023-10-01) and equivalent regimes elsewhere. Free-form string;
+     *  format validation belongs upstream (per-jurisdiction). */
+    taxRegistrationId?: string;
+}
+export interface JournalEntry {
+    /** Globally unique within a book — ULID-style; ordering by id
+     *  reproduces creation order. */
+    id: string;
+    /** Calendar date the entry is booked for (YYYY-MM-DD). The month
+     *  part decides which `journal/YYYY-MM.jsonl` file the entry lives
+     *  in; entries can be for any past / future date. */
+    date: string;
+    kind: JournalEntryKind;
+    lines: JournalLine[];
+    /** Entry-level memo. */
+    memo?: string;
+    /** When `kind === "void-marker"`: id of the entry being voided.
+     *  When `kind === "void"`: the system-generated reverse entry
+     *  references the original via this field. */
+    voidedEntryId?: string;
+    /** Reason supplied by the user when voiding. */
+    voidReason?: string;
+    /** When this entry was posted via the "edit" flow (void-then-add),
+     *  this is the id of the entry it replaces. The void + new-entry
+     *  pair is *not* atomic on the server — the client issues two
+     *  sequential calls — but recording the link here makes the
+     *  edit chain queryable later (e.g. "what corrected entry X?"). */
+    replacesEntryId?: string;
+    /** ISO timestamp the entry was appended to the journal — the
+     *  authoritative "when did this hit the books" clock. Distinct
+     *  from `date`, which is the user-visible booking date. */
+    createdAt: string;
+}
+/** Aggregated balance per account at a point in time. The signed
+ *  number is debit − credit; downstream display logic converts to
+ *  natural sign per account type (assets debit-positive, liabilities
+ *  credit-positive). */
+export interface AccountBalance {
+    accountCode: string;
+    /** Σ debit − Σ credit across all entries up to and including the
+     *  snapshot's period end. */
+    netDebit: number;
+}
+export interface MonthSnapshot {
+    /** "YYYY-MM" — the closing month covered. */
+    period: string;
+    /** Closing balances at end of `period`. */
+    balances: AccountBalance[];
+    /** ISO timestamp the snapshot file was written. */
+    builtAt: string;
+}
+/** Period selector for reports. Either a single closing month or a
+ *  date range. Always inclusive on both ends. */
+export type ReportPeriod = {
+    kind: "month";
+    period: string;
+} | {
+    kind: "range";
+    from: string;
+    to: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAErE,eAAO,MAAM,aAAa,gEAAiE,CAAC;AAC5F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;qBAEqB;AACrB,eAAO,MAAM,2BAA2B,EAAE,SAAS,WAAW,EAAqC,CAAC;AAEpG,MAAM,WAAW,OAAO;IACtB;;0DAEsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB;+DAC2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;uDAKmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb;kCAC8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;;;qBASiB;IACjB,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B;;;;;;;uCAOmC;IACnC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB;;;4BAGwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;iEAM6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B;qCACiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX;;yDAEqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;kDAE8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;uEAImE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;+DAE2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;wBAGwB;AACxB,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB;iCAC6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;iDACiD;AACjD,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC"}