e-arveldaja-mcp 0.34.2 → 0.35.0

package/.claude/commands/import-wise.md

@@ -104,12 +104,12 @@ When the preview reports transfer rows held for their counterpart bank account (
 <!-- E_ARVELDAJA_CAPABILITY_CONDITION_START:guided -->
 Capability condition for `guided`: inspect the connected MCP server's advertised tool list before this section. Run this section only when every named tool is advertised: `process_bank_input`, and none of these is advertised: `import_wise_transactions`. Otherwise skip this section and continue with the surrounding workflow. Never call a missing tool to probe capability.
 
-The compact preview returns a `summary`: `summary.counts` (CSV rows, eligible, filtered out, would-create, in/out, skipped, duplicates, auto-matched, already-journalized, errors, needs-review, inter-account, invoice currency fixes; the skip counts are disjoint — an automatic match is counted only under `auto_matched`, so `skipped` = `duplicates` + `auto_matched` + `already_journalized` + other skips), `summary.totals`, `summary.samples`, `summary.warnings` (ownership transfers that could not be auto-verified carry code `wise_transfer_ownership_unverified` and are never silently dropped; automatic matches show at most 3 per code plus a `<code>_more` count, and when the response size limit trims warnings a `warnings_truncated` warning counts the dropped rows per code: tell the owner those counts), `summary.blockers` (never hidden), and `summary.plan_handle`. Transfer rows held for their counterpart bank account are folded into one `wise_transfer_counterpart_unresolved` warning naming the own bank accounts (`counts.needs_review` still counts the rows); it is not a blocker, so the rest of the plan keeps its `plan_handle` and `next_action`. A preview with write commands and open reviews is `needs_review` (it keeps `plan_handle` and `next_action`; resolve or accept the reviews with the owner first); without reviews it is `ready_for_approval`. When nothing is to be written, `summary.status` is `completed` (`needs_review` when reviews or errors remain), the message says "Nothing to approve", and there is no `plan_handle` or `next_action`; to see more automatic matches than the 3 listed, re-run the preview with a narrower `date_from` / `date_to`. The digest is NOT a top-level field here: it is inside the ready-to-run execute call at `summary.next_action.args.approved_command_digest` (next to `summary.next_action.args.plan_handle`).
+The compact preview returns a `summary`: `summary.counts` (CSV rows, eligible, filtered out, would-create, in/out, skipped, duplicates, auto-matched, already-journalized, errors, needs-review, inter-account, invoice currency fixes; the skip counts are disjoint — an automatic match is counted only under `auto_matched`, so `skipped` = `duplicates` + `auto_matched` + `already_journalized` + other skips), `summary.totals`, `summary.samples`, `summary.warnings` (ownership transfers that could not be auto-verified carry code `wise_transfer_ownership_unverified` and are never silently dropped; automatic matches show at most 3 per code plus a `<code>_more` count, and when the response size limit trims warnings a `warnings_truncated` warning counts the dropped rows per code: tell the owner those counts), `summary.blockers` (never hidden), and `summary.plan_handle`. Transfer rows held for their counterpart bank account are folded into one `wise_transfer_counterpart_unresolved` warning naming the own bank accounts (`counts.needs_review` still counts the rows); it is not a blocker, so the rest of the plan keeps its `plan_handle` and `next_action`. A preview with write commands and open reviews that block approval (`counts.blocking_review_count`) is `needs_review` (it keeps `plan_handle` and `next_action`; resolve or accept the reviews with the owner first); otherwise it is `ready_for_approval`. Only `wise_transfer_ownership_unverified` does not block: on approval that transfer is imported as an unconfirmed ordinary bank row, so tell the owner which ones they are before approving. When nothing is to be written, `summary.status` is `completed` (`needs_review` when reviews or errors remain), the message says "Nothing to approve", and there is no `plan_handle` or `next_action`; to see more automatic matches than the 3 listed, re-run the preview with a narrower `date_from` / `date_to`. The digest is NOT a top-level field here: it is inside the ready-to-run execute call at `summary.next_action.args.approved_command_digest` (next to `summary.next_action.args.plan_handle`).
 <!-- E_ARVELDAJA_CAPABILITY_CONDITION_END:guided -->
 <!-- E_ARVELDAJA_CAPABILITY_CONDITION_START:standard -->
 Capability condition for `standard`: inspect the connected MCP server's advertised tool list before this section. Run this section only when every named tool is advertised: `import_wise_transactions`. Otherwise skip this section and continue with the surrounding workflow. Never call a missing tool to probe capability.
 
-The dry run returns top-level `plan_handle` and `approved_command_digest`, a `summary` (`total_csv_rows`, `eligible`, `filtered_out`, `created` = would-create, `skipped`, `error_count`, `inter_account_total`, `needs_review`), `ownership_reviews` (transfers that could not be auto-verified as own-account transfers; never dropped), `transfer_counterpart_unresolved` (only when transfer rows are held: `message`, `unresolved_row_count`, `conflict_row_count`, `candidates[]` with `accounts_dimensions_id` + `label`; the per-row reviews are in `ownership_reviews` with `counterpart_candidate_dimension_ids` and, for a conflict, `evidence_transaction_ids`), `inter_account_reconciliation`, advisory `invoice_currency_fixes`, and `skipped_details`: skipped rows grouped by reason, each group with `count` and up to 5 `sample_ids`; for already-booked rows the ledger id is replaced in the reason by `journal (see records)` / `transaction (see records)` and the group's `records` lists every row's `wise_id` + `record_id`. In a dry run, `execution.skipped` itemises only skips that are not already-booked rows (unsupported directions, dependency skips); `execution.skipped_omitted_already_booked` counts the rest, which are in `skipped_details`. Transfers already booked by a journal are not commands: the dry run lists them in `execution.already_journalized_rows` (`wise_id`, `existing_journal_id`, date, amount, currency, direction; count in `execution.already_journalized_count`, of which `execution.already_journalized_auto_matched_count` are legacy transfers matched automatically; the guided summary counts those under `auto_matched` and the rest under `already_journalized`). `execution.commands` and `command_count` cover only commands that write. An executed run keeps every write command and every skipped row itemised; the already-journalized re-check results are in `inter_account_reconciliation.details`, after the confirmed transfers.
+The dry run returns top-level `plan_handle` and `approved_command_digest`, a `summary` (`total_csv_rows`, `eligible`, `filtered_out`, `created` = would-create, `skipped`, `error_count`, `inter_account_total`, `needs_review`, `blocking_review_count` = the reviews that block approval; every review but `wise_transfer_ownership_unverified` blocks), `ownership_reviews` (transfers that could not be auto-verified as own-account transfers; never dropped), `transfer_counterpart_unresolved` (only when transfer rows are held: `message`, `unresolved_row_count`, `conflict_row_count`, `candidates[]` with `accounts_dimensions_id` + `label`; the per-row reviews are in `ownership_reviews` with `counterpart_candidate_dimension_ids` and, for a conflict, `evidence_transaction_ids`), `inter_account_reconciliation`, advisory `invoice_currency_fixes`, and `skipped_details`: skipped rows grouped by reason, each group with `count` and up to 5 `sample_ids`; for already-booked rows the ledger id is replaced in the reason by `journal (see records)` / `transaction (see records)` and the group's `records` lists every row's `wise_id` + `record_id`. In a dry run, `execution.skipped` itemises only skips that are not already-booked rows (unsupported directions, dependency skips); `execution.skipped_omitted_already_booked` counts the rest, which are in `skipped_details`. Transfers already booked by a journal are not commands: the dry run lists them in `execution.already_journalized_rows` (`wise_id`, `existing_journal_id`, date, amount, currency, direction; count in `execution.already_journalized_count`, of which `execution.already_journalized_auto_matched_count` are legacy transfers matched automatically; the guided summary counts those under `auto_matched` and the rest under `already_journalized`). `execution.commands` and `command_count` cover only commands that write. An executed run keeps every write command and every skipped row itemised; the already-journalized re-check results are in `inter_account_reconciliation.details`, after the confirmed transfers.
 <!-- E_ARVELDAJA_CAPABILITY_CONDITION_END:standard -->
 
 Show main transactions and fee rows that would be created, exact duplicate / skip reasons, whether fees will be auto-confirmed to the chosen dimension, inter-account transfer confirmations or skips, and advisory invoice FX corrections (reported only — the import never changes confirmed purchase invoices).
@@ -139,7 +139,9 @@ When the compact preview does not name the automatically skipped rows, give the
 
 Do not disable Jar skipping unless the user explicitly wants those internal Wise movements imported.
 
-**Ownership re-preview (unverified transfers).** When the preview lists unverified ownership transfers, those are the EXACT unverified transfer IDs. If the user wants any treated as own-account transfers, approve them by re-running the preview with `confirm_own_transfer_ids` set to those exact IDs, in the order presented. That is a NEW preview: it returns a NEW `plan_handle` and NEW `approved_command_digest`, and the previous pair is rejected. Execution requires the approvals to match, in order, the reviewed plan — extra, missing, or reordered ownership decisions invalidate the plan (`wise_transfer_ownership_reapproval_required`) and nothing is created.
+**Transfers to a third party.** A `TRANSFER-*` / `BANK_DETAILS_PAYMENT_RETURN-*` row whose counterpart bank comes only from `inter_account_dimension_id` or the only other bank account (no own-account evidence on any bank), and whose other party (OUT: recipient, IN: sender) is named, is not the company and appears in no configured bank account, is a payment to or from that party, not an own transfer. It is imported as an ordinary unconfirmed bank row (its fee row is still confirmed), with no ownership review, and listed in `transfers_treated_as_payments` (`basis: "automatic"`; guided: a `wise_transfer_treated_as_payment` warning). Every Wise-side hold still applies to it. If the owner says one is an own transfer after all, re-run the preview with its ID in `confirm_own_transfer_ids`. When the owner says an ownership-review transfer is a payment to or from someone else, re-run the preview with its exact ID in `not_own_transfer_ids` (never together with `confirm_own_transfer_ids`; an ID that is not an eligible transfer row of the CSV is refused): it is imported the same way (`basis: "owner"`) and the plan binds the decision. A row held for its counterpart stays held (a separate `not_own_transfer_conflicts_evidence` review reports the conflict), and a row whose own-account evidence decided its counterpart is held with `not_own_transfer_conflicts_evidence`; check those with the owner.
+
+**Ownership re-preview (unverified transfers).** When the preview lists unverified ownership transfers, those are the EXACT unverified transfer IDs. They do not block approval: approved as they are, they are imported as unconfirmed ordinary bank rows. If the user wants any treated as own-account transfers, approve them by re-running the preview with `confirm_own_transfer_ids` set to those exact IDs, in the order presented. That is a NEW preview: it returns a NEW `plan_handle` and NEW `approved_command_digest`, and the previous pair is rejected. Execution requires the approvals to match, in order, the reviewed plan — extra, missing, or reordered ownership decisions invalidate the plan (`wise_transfer_ownership_reapproval_required`) and nothing is created.
 
 **Journal mapping re-preview (`wise_transfer_journal_ambiguous`).** Such a row is held (not imported) because a same-amount journal within one day cannot be told apart from it. Do not pick a candidate journal yourself. Show the owner each candidate from the review (`candidate_journal_ids`; the full review also has `candidates[].counterpart_transaction_id` and `label_source`, which says only where the journal's label came from, not which movement it books). Only when the owner has checked and chosen the journal that books exactly this Wise transfer, re-run the preview with `journalized_transfer_ids` set to exactly the chosen `{ wise_id, journal_id }` pairs. That is a NEW preview with a NEW `plan_handle` and `approved_command_digest`; the previous pair is rejected. Each mapping is validated: report any `wise_transfer_mapping_rejected` or `unused_mapping` review back to the owner; a rejected mapping leaves the row to resolve as if it were unmapped (see its own result). If the owner does not choose, the row stays held.
 **Acknowledgement re-preview (`wise_transfer_journal_ambiguous`, `wise_transfer_journal_existing_elsewhere`, `wise_exact_label_possible_double_booking`).** First check whether a listed journal IS this transfer: then it is already booked (map an ambiguous inter-account candidate with `journalized_transfer_ids`). An acknowledgement is only for journals that are a different movement, because the released row is created and confirmed as a new transaction. When the owner has checked every journal in the review's `required_acknowledgement_ids` and confirms that none of them books this Wise transfer, re-run the preview with `acknowledged_journal_holds` set to `{ wise_id, journal_ids }` listing ALL of them. The row is then imported and confirmed as usual (against its own counterpart account); it is not recorded as already journalized. The exception is `wise_exact_label_possible_double_booking`: there the acknowledged row stays recorded as already journalized by its labelled journal (`journal_id`) and nothing is created for it. A shorter list leaves the row held (`unacknowledged_journal_ids` names the missing journals). An entry that releases nothing (no such row, not a transfer row, not held, or held by a hold an acknowledgement cannot release) is reported as an `unused_acknowledgement` review naming the reason; tell the owner and drop or correct it. That is a NEW preview with a NEW `plan_handle` and digest, the released row is reported in `acknowledged_holds` (guided: a `wise_acknowledged_hold_released` warning), and execute re-checks the acknowledged journals: one that changed, or a new journal, stops the confirm. Counterpart, identity (`wise_transfer_journal_inconsistent`) and untagged-row holds cannot be acknowledged.

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 ## [Unreleased]
 
+## [0.35.0] - 2026-10-30
+
+### Added
+
+- **When a purchase document prints an order or cart number (Ostukorvi nr, Tellimuse nr, Order no), it is saved in the invoice notes, and a bank payment that names it is suggested for that invoice.** Before, a Lux Express ticket whose bank line carried only the cart number never matched its invoice, which has the ticket number. Details: `extractOrderReferences` reads one unspaced value on the label's line; exactly one distinct value writes the notes line `Ostukorvi/tellimuse nr: <value>` on `process_accounting_document` (prepare stores it, create re-applies it, the reading path re-derives it and holds on `packet_changed`), `receipt_batch` and `create_purchase_invoice_from_pdf` (text layer only via `parseDocumentTextLayerOnly`; a failure writes no line and never blocks the booking). Reconcile suggestions list an exact-amount purchase invoice whose number or notes line appears as a whole strong token in the bank description in a separate `document_reference_candidates` group, only at the default threshold (`min_confidence` ≤ 50). Match scores, the best match and automatic confirmation are unchanged.
+- **You can tell the Wise import that a transfer is not to one of your own accounts.** Details: `not_own_transfer_ids` (also on the guided bank facade) imports the listed `TRANSFER-*` / `BANK_DETAILS_PAYMENT_RETURN-*` rows as ordinary unconfirmed rows; an unknown or ineligible ID, or one also in `confirm_own_transfer_ids`, is an error; own-account evidence on another bank holds the row (`not_own_transfer_conflicts_evidence`) instead of ignoring it.
+
+### Fixed
+
+- **A Wise transfer to a person or company that is not you no longer blocks the whole import.** Before, with `inter_account_dimension_id` set, a transfer to e.g. the owner's private account became an own-transfer candidate needing approval, and every other row of the import, card payments included, waited for it. Details: when the counterpart comes only from the fallback (no own-account evidence of any strength), your company name is known, and the receiving (or, for incoming, sending) name is neither your company nor any own bank account's name, the row is imported as an ordinary unconfirmed row and listed in `transfers_treated_as_payments`; duplicate holds and execute-time checks still apply, and such a row is never skipped as an untagged ledger match. An unverified-ownership review no longer blocks approval (standard, guided and Accounting Inbox use `blocking_review_count`); every other or unknown review code still does.
+- **A ticket's purchase date (Ostetud / Purchased) is now read as the invoice date instead of the departure date.** Details: `Ostetud`, `Ostu kuupäev`, `Ostukuupäev` and `Purchased (on)` are tier-2 date labels; an explicit invoice-date label still wins.
+- **An invoice with a reverse-charge footnote no longer reports a made-up VAT amount and low confidence.** Before, the Anthropic invoice footnote "[1] Tax to be paid on reverse charge basis" picked up a footer amount below it as VAT. Details: a layout row that starts with a `[n]` marker referenced earlier on the page, contains reverse-charge wording, has no amount and at least four words after the marker is not used as a label for an amount below it; column headers such as "VAT (reverse charge)" and labels with their own amount keep their bindings and conflicts.
+
+### Changed
+
+- **Possible-duplicate warnings say when the other booking has a different import reference, so they are easier to dismiss.** Details: a bank-posting suspect whose Wise ID (same leg) or CAMT bank reference differs from the new entry's is marked `distinct_source_reference` and shown as "Likely a different movement (different source reference)"; it is still a suspect, so `block_on_duplicate` refuses exactly as before and reconcile plan fingerprints are unchanged. Different clients are never treated as proof of a different payment.
+
+## [0.34.3] - 2026-10-28
+
+### Fixed
+
+- **A character that text recognition reads right beside a printed value can no longer complete that value into a different one.** Before, an invoice printing "A-1" with an OCR'd "7" next to it, and an order number "A-17" elsewhere, could pass "A-17" as the invoice number without a confirm row. Details: an OCR item that is a strict fragment of a cited value releases `ocr_cited_text` only when its box touches no text-layer item at all (previously: none of the items printing the value) and no other OCR fragment of the same value; an item without a box counts as touching. On the 28 live 2026-10-28 documents all 279 cited values keep their result, so Tele2 and Anthropic stay released.
+- **Your own registry code followed by a date or another number on the same line now counts as printed, so such a document keeps the `self_vat_detected` hold.** Details: the own-registry-code scan in the verified reading matches on the raw line with optional spaces or column breaks between digits ("16123456 17.07.2026", "1612 3456", "1612  3456") instead of on the line with all spaces removed; a longer unbroken number containing the code still does not count, while a digit separated from it by a space ("9 16123456") does, which may hold more often but never less.
+
+### Changed
+
+- **Dependencies:** `@types/node` 26.6.6.
+
 ## [0.34.2] - 2026-10-28
 
 ### Fixed

package/dist/account-postings.d.ts

@@ -9,6 +9,7 @@ export interface AccountPostingRow {
     amount: number;
     accounts_dimensions_id: number | null;
     clients_id: number | null;
+    operations_id?: number;
 }
 export declare function listAccountDimensionPostings(journals: Journal[], accountId: number, opts?: {
     dateFrom?: string;

package/dist/account-postings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"account-postings.d.ts","sourceRoot":"","sources":["../src/account-postings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3E,iBAAiB,EAAE,CAwBrB"}
+{"version":3,"file":"account-postings.d.ts","sourceRoot":"","sources":["../src/account-postings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3E,iBAAiB,EAAE,CAyBrB"}

package/dist/account-postings.js

@@ -24,6 +24,7 @@ export function listAccountDimensionPostings(journals, accountId, opts) {
                 amount: p.base_amount ?? p.amount,
                 accounts_dimensions_id: p.accounts_dimensions_id ?? null,
                 clients_id: journal.clients_id ?? null,
+                ...(journal.operations_id != null ? { operations_id: journal.operations_id } : {}),
             });
         }
     }

package/dist/account-postings.js.map

@@ -1 +1 @@
-{"version":3,"file":"account-postings.js","sourceRoot":"","sources":["../src/account-postings.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,4BAA4B,CAC1C,QAAmB,EACnB,SAAiB,EACjB,IAA4E;IAE5E,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;YAAE,SAAS;QAChG,IAAI,IAAI,EAAE,QAAQ,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,QAAQ;YAAE,SAAS;QACvE,IAAI,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,MAAM;YAAE,SAAS;QACnE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,SAAS;QAChC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACjC,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU;gBAAE,SAAS;YAC1D,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG;gBAAE,SAAS;YAC/C,IAAI,CAAC,IAAI,CAAC;gBACR,UAAU,EAAE,OAAO,CAAC,EAAG;gBACvB,aAAa,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;gBAClC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;gBAChD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;gBAC9C,IAAI,EAAE,OAAO,CAAC,cAAc;gBAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,MAAM;gBACjC,sBAAsB,EAAE,CAAC,CAAC,sBAAsB,IAAI,IAAI;gBACxD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;aACvC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"account-postings.js","sourceRoot":"","sources":["../src/account-postings.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,4BAA4B,CAC1C,QAAmB,EACnB,SAAiB,EACjB,IAA4E;IAE5E,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;YAAE,SAAS;QAChG,IAAI,IAAI,EAAE,QAAQ,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,QAAQ;YAAE,SAAS;QACvE,IAAI,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,MAAM;YAAE,SAAS;QACnE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,SAAS;QAChC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACjC,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU;gBAAE,SAAS;YAC1D,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG;gBAAE,SAAS;YAC/C,IAAI,CAAC,IAAI,CAAC;gBACR,UAAU,EAAE,OAAO,CAAC,EAAG;gBACvB,aAAa,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;gBAClC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;gBAChD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;gBAC9C,IAAI,EAAE,OAAO,CAAC,cAAc;gBAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,MAAM;gBACjC,sBAAsB,EAAE,CAAC,CAAC,sBAAsB,IAAI,IAAI;gBACxD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;gBACtC,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/bank-posting-duplicate-guard.d.ts

@@ -1,4 +1,5 @@
-import type { AccountDimension, BankAccount, Journal } from "./types/api.js";
+import type { AccountDimension, BankAccount, Journal, Transaction } from "./types/api.js";
+import { storedBankReferenceLookupKey } from "./camt/duplicate-identity.js";
 /**
  * Cross-mechanism bank-posting duplicate guard — core matching logic.
  *
@@ -39,6 +40,13 @@ export interface DuplicatePostingSuspect {
     type: "D" | "C";
     dimension_id: number | null;
     day_distance: number;
+    /** Internal only (never rendered): the transaction a TRANSACTION journal registers. */
+    operations_id?: number;
+    /**
+     * Advisory annotation: a same-namespace source reference proves this suspect
+     * is a different movement. It stays a suspect: blocking is unchanged.
+     */
+    distinct_source_reference?: true;
 }
 export interface DuplicatePostingScanResult {
     scan_available: boolean;
@@ -89,16 +97,40 @@ export declare function findDuplicatePostingsInJournals(journals: Journal[], can
     amountTolerance?: number;
     includeUnregistered?: boolean;
 }): DuplicatePostingSuspect[];
-/** Wire shape of a rendered suspect: the same fields, with `journal_title` / `document_number` sandbox-wrapped. */
-export type RenderedDuplicatePostingSuspect = {
-    [K in keyof DuplicatePostingSuspect]: DuplicatePostingSuspect[K];
-};
+/**
+ * Wire shape of a rendered suspect: the same fields without the internal
+ * `operations_id`, with `journal_title` / `document_number` sandbox-wrapped.
+ */
+export type RenderedDuplicatePostingSuspect = Omit<DuplicatePostingSuspect, "operations_id">;
 /**
  * Suspects as MCP output: the journal title and document number are
  * upstream free text, so both are sandbox-wrapped. The one rendering every
  * `possible_duplicate_postings` list uses.
  */
 export declare function renderDuplicatePostingSuspects(suspects: readonly DuplicatePostingSuspect[]): RenderedDuplicatePostingSuspect[];
+/** The typed source identity of one bank movement on its bank dimension. */
+export interface SourceReferenceIdentity {
+    readonly dimensionId: number;
+    /** `wise:<id>` per leg (main row or its fee row). */
+    readonly wise?: {
+        readonly leg: "main" | "fee";
+        readonly id: string;
+    };
+    /** `camt:<key>` — the stored bank-reference lookup key (full and hash forms agree). */
+    readonly camt?: string;
+}
+/** A stored or about-to-be-created bank transaction's identity: its WISE: tag and/or verified CAMT key. */
+export declare function transactionSourceReferenceIdentity(transaction: Parameters<typeof storedBankReferenceLookupKey>[0] & Pick<Transaction, "accounts_dimensions_id">): SourceReferenceIdentity | undefined;
+/** A journal's identity from a `WISE:{id}` document number, on the bank dimension it posts. */
+export declare function journalSourceReferenceIdentity(documentNumber: string | null | undefined, dimensionId: number | null): SourceReferenceIdentity | undefined;
+/**
+ * Annotate an existing scan's suspects with `distinct_source_reference`.
+ * Runs after the scan and never changes it otherwise: same suspects, same
+ * order, same `scan_available`. A TRANSACTION journal is identified only
+ * through its registered transaction (`operations_id`), any other journal by
+ * its `WISE:` document number. Any error returns the scan unannotated.
+ */
+export declare function annotateDistinctSourceReferences(scan: DuplicatePostingScanResult, candidate: () => SourceReferenceIdentity | undefined, loadTransactions: () => Promise<readonly Transaction[]>): Promise<DuplicatePostingScanResult>;
 /**
  * API-facing scan: loads `opts.preloadedJournals` or
  * `api.journals.listAllWithPostings()` and runs the pure matcher over it.

package/dist/bank-posting-duplicate-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bank-posting-duplicate-guard.d.ts","sourceRoot":"","sources":["../src/bank-posting-duplicate-guard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bank-posting-duplicate-guard.d.ts","sourceRoot":"","sources":["../src/bank-posting-duplicate-guard.ts"],"names":[],"mappings":"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"}

package/dist/bank-posting-duplicate-guard.js

@@ -2,6 +2,8 @@ import { listAccountDimensionPostings } from "./account-postings.js";
 import { roundMoney } from "./money.js";
 import { wrapUntrustedOcr } from "./mcp-json.js";
 import { toUtcDay } from "./date-utils.js";
+import { storedBankReferenceLookupKey } from "./camt/duplicate-identity.js";
+import { matchWiseLegTag } from "./wise/projection.js";
 /**
  * Cross-mechanism bank-posting duplicate guard — core matching logic.
  *
@@ -123,6 +125,7 @@ export function findDuplicatePostingsInJournals(journals, candidate, opts) {
             type: row.type,
             dimension_id: row.accounts_dimensions_id,
             day_distance: utcDayDiff(row.date, candidate.date),
+            ...(row.operations_id !== undefined ? { operations_id: row.operations_id } : {}),
         });
     }
     return suspects.sort((a, b) => a.day_distance - b.day_distance || a.journal_id - b.journal_id);
@@ -133,12 +136,90 @@ export function findDuplicatePostingsInJournals(journals, candidate, opts) {
  * `possible_duplicate_postings` list uses.
  */
 export function renderDuplicatePostingSuspects(suspects) {
-    return suspects.map(s => ({
+    return suspects.map(({ operations_id: _operationsId, ...s }) => ({
         ...s,
         journal_title: wrapUntrustedOcr(s.journal_title) ?? "",
         document_number: s.document_number == null ? s.document_number : wrapUntrustedOcr(s.document_number) ?? "",
     }));
 }
+/** The Wise leg and ID a `WISE:{id}` / `WISE:FEE:{id}` tag names (a split-leg `:CUR` suffix is the same ID). */
+function wiseTagIdentity(tag) {
+    const value = tag?.trim().split(/\s+/)[0] ?? "";
+    const leg = value.startsWith("WISE:FEE:") ? "fee" : value.startsWith("WISE:") ? "main" : undefined;
+    if (leg === undefined)
+        return undefined;
+    const prefix = leg === "fee" ? "WISE:FEE:" : "WISE:";
+    const id = value.slice(prefix.length).split(":")[0] ?? "";
+    if (id === "" || matchWiseLegTag(value, `${prefix}${id}`) === undefined)
+        return undefined;
+    return { leg, id };
+}
+/** A stored or about-to-be-created bank transaction's identity: its WISE: tag and/or verified CAMT key. */
+export function transactionSourceReferenceIdentity(transaction) {
+    const dimensionId = transaction.accounts_dimensions_id;
+    if (typeof dimensionId !== "number")
+        return undefined;
+    const wise = wiseTagIdentity(transaction.description);
+    const camt = storedBankReferenceLookupKey(transaction);
+    if (wise === undefined && camt === undefined)
+        return undefined;
+    return { dimensionId, ...(wise ? { wise } : {}), ...(camt ? { camt } : {}) };
+}
+/** A journal's identity from a `WISE:{id}` document number, on the bank dimension it posts. */
+export function journalSourceReferenceIdentity(documentNumber, dimensionId) {
+    const wise = wiseTagIdentity(documentNumber);
+    return wise !== undefined && dimensionId !== null ? { dimensionId, wise } : undefined;
+}
+/**
+ * Positively different: the same bank dimension, at least one namespace both
+ * sides carry (Wise on the same leg, or CAMT), and a different value in every
+ * such namespace. Different namespaces are not comparable.
+ */
+function differentSourceReference(left, right) {
+    if (left.dimensionId !== right.dimensionId)
+        return false;
+    const differs = [];
+    if (left.wise && right.wise && left.wise.leg === right.wise.leg)
+        differs.push(left.wise.id !== right.wise.id);
+    if (left.camt && right.camt)
+        differs.push(left.camt !== right.camt);
+    return differs.length > 0 && differs.every(Boolean);
+}
+/**
+ * Annotate an existing scan's suspects with `distinct_source_reference`.
+ * Runs after the scan and never changes it otherwise: same suspects, same
+ * order, same `scan_available`. A TRANSACTION journal is identified only
+ * through its registered transaction (`operations_id`), any other journal by
+ * its `WISE:` document number. Any error returns the scan unannotated.
+ */
+export async function annotateDistinctSourceReferences(scan, candidate, loadTransactions) {
+    if (!scan.scan_available || scan.suspects.length === 0)
+        return scan;
+    try {
+        const candidateIdentity = candidate();
+        if (candidateIdentity === undefined)
+            return scan;
+        const transactions = await loadTransactions();
+        const transactionById = new Map(transactions.filter(tx => tx.is_deleted !== true && tx.id !== undefined).map(tx => [tx.id, tx]));
+        const suspects = scan.suspects.map(suspect => {
+            let identity;
+            if (suspect.operation_type === "TRANSACTION") {
+                const transaction = suspect.operations_id !== undefined ? transactionById.get(suspect.operations_id) : undefined;
+                identity = transaction ? transactionSourceReferenceIdentity(transaction) : undefined;
+            }
+            else {
+                identity = journalSourceReferenceIdentity(suspect.document_number, suspect.dimension_id);
+            }
+            return identity && differentSourceReference(candidateIdentity, identity)
+                ? { ...suspect, distinct_source_reference: true }
+                : suspect;
+        });
+        return { ...scan, suspects };
+    }
+    catch {
+        return scan;
+    }
+}
 /**
  * API-facing scan: loads `opts.preloadedJournals` or
  * `api.journals.listAllWithPostings()` and runs the pure matcher over it.
@@ -257,6 +338,10 @@ export function formatDuplicatePostingWarnings(result, candidate, wrapTitle) {
     for (const suspect of result.suspects) {
         // document_number is upstream free text too — sandbox it like the title.
         const docPart = suspect.document_number ? `, doc ${wrapTitle(suspect.document_number)}` : "";
+        if (suspect.distinct_source_reference === true) {
+            lines.push(`Likely a different movement (different source reference): journal ${suspect.journal_id} "${wrapTitle(suspect.journal_title)}" (${suspect.date}${docPart}) books the same ${amount} € ${directionWord} under a different source reference. Advisory only — it is still listed as a duplicate suspect.`);
+            continue;
+        }
         lines.push(`POSSIBLE duplicate: this ${amount} € ${directionWord} may already be booked by journal ${suspect.journal_id} "${wrapTitle(suspect.journal_title)}" (${suspect.date}${docPart}). Verify before proceeding — two legitimate identical payments are possible.`);
     }
     if (!result.scan_available && result.scan_note) {

package/dist/bank-posting-duplicate-guard.js.map

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

package/dist/banking/reconciliation/executor.d.ts

@@ -31,6 +31,8 @@ export declare class ReconciliationOperationFailedError extends Error {
     readonly failure: ReconFailure;
     constructor(failure: ReconFailure);
 }
+/** The suggestion path's default minimum confidence. */
+export declare const SUGGEST_DEFAULT_MIN_CONFIDENCE = 50;
 export declare function runSuggestMatches(api: ApiContext, input: SuggestMatchesInput): Promise<ReconciliationSuggestions>;
 export declare function prepareExactConfirm(api: ApiContext, runtimeSafetyContext: RuntimeSafetyContext, input: ExactConfirmInput): Promise<ExactConfirmPreview>;
 export declare function executeExactConfirm(api: ApiContext, runtimeSafetyContext: RuntimeSafetyContext, input: ExactConfirmExecutionInput): Promise<ReconExecResult<ExactConfirmExecution>>;

package/dist/banking/reconciliation/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/banking/reconciliation/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAqB7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAgE5E,OAAO,KAAK,EAEV,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EAGjB,mBAAmB,EAGnB,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EAInB,yBAAyB,EAMzB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAkBpB,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAUlD,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACvC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC;AAE3D;;;;GAIG;AACH,qBAAa,kCAAmC,SAAQ,KAAK;IAC/C,QAAQ,CAAC,OAAO,EAAE,YAAY;IAA1C,YAAqB,OAAO,EAAE,YAAY,EAGzC;CACF;AAYD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,yBAAyB,CAAC,CAmMpC;AAyXD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,oBAAoB,EAAE,oBAAoB,EAC1C,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAI9B;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,oBAAoB,EAAE,oBAAoB,EAC1C,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC,CA0BjD;AAID,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,iBAAiB,EACxB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAw5BlC;AAuBD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,oBAAoB,EAAE,oBAAoB,EAC1C,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,mBAAmB,CAAC,CA6B9B;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,oBAAoB,EAAE,oBAAoB,EAC1C,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC,CAmNjD"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/banking/reconciliation/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAqB7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAoE5E,OAAO,KAAK,EAEV,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EAGjB,mBAAmB,EAGnB,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EAInB,yBAAyB,EAOzB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAkBpB,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAUlD,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACvC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC;AAE3D;;;;GAIG;AACH,qBAAa,kCAAmC,SAAQ,KAAK;IAC/C,QAAQ,CAAC,OAAO,EAAE,YAAY;IAA1C,YAAqB,OAAO,EAAE,YAAY,EAGzC;CACF;AAYD,wDAAwD;AACxD,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAWjD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,yBAAyB,CAAC,CAkOpC;AAoYD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,oBAAoB,EAAE,oBAAoB,EAC1C,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAI9B;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,oBAAoB,EAAE,oBAAoB,EAC1C,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC,CA0BjD;AAID,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,iBAAiB,EACxB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAw5BlC;AAuBD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,oBAAoB,EAAE,oBAAoB,EAC1C,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,mBAAmB,CAAC,CA6B9B;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,oBAAoB,EAAE,oBAAoB,EAC1C,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC,CAmNjD"}

package/dist/banking/reconciliation/executor.js

@@ -16,9 +16,11 @@ import { isRecord } from "../../record-utils.js";
 import { BookingGuard } from "../../booking-guard.js";
 import { buildBankAccountLookups, normalizeReference } from "../../tools/inter-account-utils.js";
 import { toUtcDay } from "../../date-utils.js";
-import { findDuplicateBankPostings, resolveBankDimensionsSafe, } from "../../bank-posting-duplicate-guard.js";
+import { annotateDistinctSourceReferences, findDuplicateBankPostings, resolveBankDimensionsSafe, transactionSourceReferenceIdentity, } from "../../bank-posting-duplicate-guard.js";
 import { BANK_RECONCILIATION_PLAN_DOMAIN, buildReconciliationExecutionPlanInput, canonicalPlanJson, executeReconciliationCommands, reconClientUpdateCommandId, reconInvoiceConfirmCommandId, reconTransferConfirmCommandId, reconDeleteDuplicateCommandId, RECON_CONFIRM_INVOICE_CATEGORY, RECON_CONFIRM_TRANSFER_CATEGORY, RECON_DELETE_DUPLICATE_CATEGORY, RECON_UPDATE_CLIENT_CATEGORY, stripUndefinedDeep, } from "../../tools/bank-reconciliation-plan.js";
 import { buildInvoiceIndex, getIndexedCandidates } from "./invoice-index.js";
+import { textCarriesStrongReference } from "../../journal-reference-scan.js";
+import { orderReferencesFromNotes } from "../../order-reference-note.js";
 import { legacyTruncatedCamtMarkerHint } from "../../camt/duplicate-identity.js";
 import { matchScore, getInvoiceMatchEligibility, buildSuggestedDistribution, comparableTransactionAmount, sameAmountToTheCent, isAmbiguousForeignInvoiceBase } from "./match-score.js";
 import { hasMeaningfulComparableAmount, resolveOneSidedTransferAmount, transactionCurrency } from "./amount-resolution.js";
@@ -65,8 +67,22 @@ function validateInterAccountDateGap(maxDateGap) {
     return value;
 }
 // === Suggest =================================================================
+/** The suggestion path's default minimum confidence. */
+export const SUGGEST_DEFAULT_MIN_CONFIDENCE = 50;
+/**
+ * The strong document reference (invoice number, then the notes' order / cart
+ * number lines) that `description` carries as a whole token, if any.
+ */
+function documentReferenceOnTransaction(description, inv) {
+    const references = [inv.number, ...orderReferencesFromNotes(inv.notes)];
+    return references.find(reference => textCarriesStrongReference(description, reference));
+}
 export async function runSuggestMatches(api, input) {
-    const threshold = input.minConfidence ?? 50;
+    const threshold = input.minConfidence ?? SUGGEST_DEFAULT_MIN_CONFIDENCE;
+    // A caller asking for a stricter threshold than the default gets no
+    // below-threshold document-reference group (okt 2026 finding 5).
+    const documentReferenceGroupEnabled = input.minConfidence === undefined || input.minConfidence <= SUGGEST_DEFAULT_MIN_CONFIDENCE;
+    const documentReferenceCandidates = [];
     const block_on_duplicate = input.blockOnDuplicate;
     // Get all unconfirmed transactions
     const allTx = await api.transactions.listAll();
@@ -136,6 +152,29 @@ export async function runSuggestMatches(api, input) {
                         match_reasons: reasons,
                     });
                 }
+                else if (documentReferenceGroupEnabled && reasons.includes("exact_amount")) {
+                    const matchedReference = documentReferenceOnTransaction(tx.description, inv);
+                    if (matchedReference !== undefined) {
+                        // RAW domain strings — the presenter wraps the free-text fields.
+                        documentReferenceCandidates.push({
+                            transaction_id: tx.id,
+                            date: tx.date,
+                            amount: tx.amount,
+                            description: tx.description ?? undefined,
+                            bank_account_name: tx.bank_account_name ?? undefined,
+                            invoice: {
+                                type: "purchase_invoice",
+                                id: inv.id,
+                                number: inv.number,
+                                client_name: inv.client_name,
+                                gross_price: inv.gross_price ?? 0,
+                                payment_status: inv.payment_status ?? "NOT_PAID",
+                            },
+                            matched_reference: matchedReference,
+                            match_reasons: [...reasons, "document_reference"],
+                        });
+                    }
+                }
             }
         }
         if (candidates.length > 0) {
@@ -152,13 +191,13 @@ export async function runSuggestMatches(api, input) {
             const suggestDim = suggestDimById.get(tx.accounts_dimensions_id);
             let possibleDuplicatePostings;
             if (suggestDim && tx.date) {
-                const scan = await findDuplicateBankPostings(api, {
+                const scan = await annotateDistinctSourceReferences(await findDuplicateBankPostings(api, {
                     accountId: suggestDim.accountId,
                     dimensionId: suggestDim.dimensionId,
                     amount: tx.base_amount ?? tx.amount,
                     direction: bankPostingSideForInvoiceMatch(tx, bestMatch.type),
                     date: tx.date,
-                });
+                }), () => transactionSourceReferenceIdentity(tx), async () => allTx);
                 if (scan.scan_available && scan.suspects.length > 0) {
                     possibleDuplicatePostings = scan.suspects;
                 }
@@ -236,6 +275,7 @@ export async function runSuggestMatches(api, input) {
         matched: results.length,
         unmatched: unconfirmed.length - results.length,
         matches: results,
+        ...(documentReferenceCandidates.length > 0 ? { documentReferenceCandidates } : {}),
         ...(suggestBankDimsResult.scanAvailable ? {} : { duplicateScanNote: suggestBankDimsResult.scanNote }),
         compact: {
             matchedTotalsByCurrency,
@@ -263,7 +303,7 @@ async function loadPendingTransactions(api, listed) {
  * Runs identically in the dry-run and execute paths so the re-derived execute
  * projection matches the reviewed plan fingerprint.
  */
-async function enrichExactMatchProjectionWithDuplicateGuard(api, projection, blockOnDuplicate) {
+async function enrichExactMatchProjectionWithDuplicateGuard(api, projection, blockOnDuplicate, allTransactions, pendingTransactions) {
     if (projection.confirms.length === 0)
         return;
     const bankDimsResult = await resolveBankDimensionsSafe(api);
@@ -291,7 +331,12 @@ async function enrichExactMatchProjectionWithDuplicateGuard(api, projection, blo
             direction: descriptor.direction,
             date: descriptor.date,
         };
-        const scan = await findDuplicateBankPostings(api, candidate);
+        // The source-reference annotation is advisory: it never changes which
+        // suspects block, and the plan fingerprint binds only their journal ids.
+        const scan = await annotateDistinctSourceReferences(await findDuplicateBankPostings(api, candidate), () => {
+            const transaction = pendingTransactions.find(tx => tx.id === descriptor.transactionId);
+            return transaction ? transactionSourceReferenceIdentity(transaction) : undefined;
+        }, async () => allTransactions);
         if (!scan.scan_available) {
             projection.duplicateScanNote ??= scan.scan_note;
             warningInputs.push({ scan, candidate });
@@ -596,7 +641,7 @@ async function loadExactMatchProjection(api, input, opts) {
         return critical.payment_status !== "PAID" && critical.status === "CONFIRMED";
     });
     const projection = computeExactMatchProjection(unconfirmed, openSales, openPurchases, threshold);
-    await enrichExactMatchProjectionWithDuplicateGuard(api, projection, input.blockOnDuplicate === true);
+    await enrichExactMatchProjectionWithDuplicateGuard(api, projection, input.blockOnDuplicate === true, allTx, unconfirmed);
     return { projection, threshold };
 }
 export async function prepareExactConfirm(api, runtimeSafetyContext, input) {