@arcforgelabs/flow 2026.10.53-1 → 2026.10.53-3

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@arcforgelabs/flow",
-  "version": "2026.10.53-1",
+  "version": "2026.10.53-3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@arcforgelabs/flow",
-      "version": "2026.10.53-1",
+      "version": "2026.10.53-3",
       "license": "MIT",
       "dependencies": {
         "@clerk/backend": "3.25.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcforgelabs/flow",
-  "version": "2026.10.53-1",
+  "version": "2026.10.53-3",
   "description": "Invoicing, bill entry and a financial dashboard for labs, with Seazona and Xero integrations.",
   "license": "MIT",
   "repository": {

package/server/core/reconcile.js

@@ -124,6 +124,20 @@ export async function reconcileDays(db, organisationId, { integrations, from, to
           and e.kind in ('observed', 'source_changed') and e.actor <> ${HISTORY_ACTOR})`,
     ));
 
+  // A billable feed cannot prove absence. Check the remaining ledger refs
+  // against the source copy without billing filters. Older adapters retain
+  // the feed comparison until they declare workJobPresence.
+  const present = new Set(work.keys());
+  for (const adapter of workAdapters) {
+    if (!adapter.capabilities.workJobPresence) continue;
+    const jobRefs = [...new Set(obligations
+      .filter((o) => o.sourceSystem === adapter.id && !present.has(`${adapter.id}:${o.sourceJobRef}`))
+      .map((o) => o.sourceJobRef))];
+    for (let i = 0; i < jobRefs.length; i += FIND_BATCH) {
+      const { presentRefs } = await adapter.capabilities.workJobPresence({ organisationId, jobRefs: jobRefs.slice(i, i + FIND_BATCH) });
+      for (const ref of presentRefs) present.add(`${adapter.id}:${ref}`);
+    }
+  }
   const reported = new Set(workAdapters.map((a) => a.id));
   const inLedger = new Set();
   for (const o of obligations) {
@@ -139,7 +153,7 @@ export async function reconcileDays(db, organisationId, { integrations, from, to
     if (reported.has(o.sourceSystem)) {
       const key = `${o.sourceSystem}:${o.sourceJobRef}`;
       inLedger.add(key);
-      if (!work.has(key)) entry.differences.missingInWork.push({ id: o.id, cents: o.totalCents });
+      if (!present.has(key)) entry.differences.missingInWork.push({ id: o.id, cents: o.totalCents });
     }
   }
   for (const [key, job] of work) {

package/server/core/sending.js

@@ -439,7 +439,8 @@ export async function sendQueued(db, organisationId, { accounting, limit = WORKE
         summary.waiting += 1;
       } else {
         const error = result.error ?? { code: `send_${result.outcome}`, message: `Sending ended as ${result.outcome}.` };
-        await settle(db, organisationId, result.invoiceId, { sendState: 'failed', sendError: { code: error.code, message: error.message, ...(error.short ? { short: error.short } : {}) } });
+        const xero = xeroMatch(error);
+        await settle(db, organisationId, result.invoiceId, { sendState: 'failed', sendError: { code: error.code, message: error.message, ...(error.short ? { short: error.short } : {}), ...(xero ? { xero } : {}) } });
         summary.failed += 1;
         summary.refused = [...new Set([...(summary.refused ?? []), error.code])];
         const fact = refusalFact(known.get(result.invoiceId), error);
@@ -450,6 +451,17 @@ export async function sendQueued(db, organisationId, { accounting, limit = WORKE
   return summary;
 }
 
+// The Xero invoice a refusal matched, kept so the page can link to it.
+// Only an id, a number and a status. Anything else in the error stays out.
+function xeroMatch(error) {
+  const xero = error?.details?.xero;
+  if (!xero || typeof xero !== 'object') return null;
+  if (!INVOICE_ID.test(xero.invoiceId ?? '')) return null;
+  const number = INVOICE_NUMBER.test(xero.number ?? '') ? xero.number : null;
+  const status = /^[A-Z0-9_]{1,32}$/.test(xero.status ?? '') ? xero.status : null;
+  return { invoiceId: xero.invoiceId, ...(number ? { number } : {}), ...(status ? { status } : {}) };
+}
+
 function settle(db, organisationId, invoiceId, fields) {
   return db.update(invoices).set({ ...fields, sendUpdatedAt: sql`now()` })
     .where(and(eq(invoices.organisationId, organisationId), eq(invoices.id, invoiceId), eq(invoices.sendState, 'queued')));

package/server/db/schema.js

@@ -112,7 +112,8 @@ export const invoices = pgTable('invoices', {
   readyAt: timestamp('ready_at', { withTimezone: true }),
   readyBy: uuid('ready_by').references(() => people.id, { onDelete: 'set null' }),
   // Sending to the accounting system (server/core/sending.js): queued by a
-  // person, then sent or failed. `sendError` is { code, message } while failed.
+  // person, then sent or failed. `sendError` is { code, message, short?, xero? }
+  // while failed. `xero` is the matched invoice { invoiceId, number, status }.
   sendState: text('send_state'),
   sendError: jsonb('send_error'),
   sendRequestedBy: uuid('send_requested_by').references(() => people.id, { onDelete: 'set null' }),

package/server/integrations/port.js

@@ -24,6 +24,7 @@ export const CAPABILITIES = Object.freeze([
   'pullPayments', // payments since a cursor, matched to invoices and bills
   'checkInvoice', // does the accounting system hold an invoice for a billable job? (the ledger's liveCheck)
   'billableJobs', // billable jobs by day from the work system's copy in Flow, for the daily reconcile; never a live call
+  'workJobPresence', // { organisationId, jobRefs } -> { presentRefs }: requested jobs still present in the work copy, without status, date or line filters; deleted jobs are absent; never a live call
   'jobReferenceFields', // { patient }: the fields a job gives the invoice Reference (server/core/references.js)
   'jobLink', // { url, exact } or null: the link to one job in the work system's own web app, for "Open in" on a job's problem; never a live call
   'listWork', // the work system's jobs from its copy in Flow, open and lately finished, for the Jobs board; a job may carry `pendingMove`

package/server/integrations/seazona/index.js

@@ -4,7 +4,7 @@ import { createSeazonaClient } from './client.js';
 import { listClients, listProducts, listWork, readBillableWork } from './feed.js';
 import { historyJobIssues, historySummary, readHistoryWork } from './history/index.js';
 import { readSeazonaSyncHealth, runSeazonaSync } from './lanes.js';
-import { readBillableJobs } from './reconcile.js';
+import { readBillableJobs, readWorkJobPresence } from './reconcile.js';
 import { SEAZONA_CALL_GUARD } from './governor.js';
 import { createSeazonaRouter } from './routes.js';
 import {
@@ -200,6 +200,10 @@ export function createSeazonaAdapter({ env = null, fetchImpl = null, now = Date.
         return readBillableJobs(current().db, { from, to });
       },
 
+      async workJobPresence({ jobRefs }) {
+        return readWorkJobPresence(current().db, { jobRefs });
+      },
+
       // Seazona clients by id and company name, for the identity map. Reads
       // Flow's copy only.
       async listCustomers() {

package/server/integrations/seazona/reconcile.js

@@ -1,4 +1,16 @@
+import { and, inArray, isNull } from 'drizzle-orm';
 import { readBillableWork } from './feed.js';
+import { seazonaOrders } from './schema.js';
+
+// Presence is not billing eligibility. Keep a job that returned to an open
+// status, lost its lines, or changed its date separate from a missing job.
+export async function readWorkJobPresence(db, { jobRefs }) {
+  if (!jobRefs.length) return { presentRefs: [] };
+  const rows = await db.select({ ref: seazonaOrders.id }).from(seazonaOrders).where(and(
+    inArray(seazonaOrders.id, jobRefs), isNull(seazonaOrders.deletedInSourceAt),
+  ));
+  return { presentRefs: rows.map((row) => row.ref) };
+}
 
 // The billable jobs in Flow's copy of Seazona, by day, behind the port's
 // `billableJobs` (the daily reconcile, server/core/reconcile.js). It walks the

package/server/ui/invoicing.js

@@ -1423,6 +1423,21 @@ function issuedView(invoice, ui, context, redraw) {
     ? h('button', { class: 'fx-btn', type: 'button', onclick: () => act('revise', `${invoice.number} is a draft again.`) }, 'Revise') : null;
   const preview = previewButton(ui, invoice.id);
   actionBar = h('div', { class: 'fx-ph__actions' }, [voidButton, reviseButton, preview, send].filter(Boolean));
+  // The same problem notice as a draft. A matched Xero invoice gets the
+  // same Open in Xero link as the Xero card (go.xero.com, reconcile.js).
+  const found = invoice.problems ?? [];
+  const shorts = found.length && found.every((p) => p.short) ? [...new Set(found.map((p) => p.short))].join(', ') : null;
+  const problemNotice = found.length
+    ? ui.notice([...new Set(found.map((p) => brief(p.message)))].join(' '), 'danger', 'Problem.', { short: shorts })
+    : null;
+  const matched = found.find((p) => /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(p.xero?.invoiceId ?? ''));
+  const openXero = matched ? h('a', {
+    class: 'fx-btn fx-btn--sm fx-btn--ghost',
+    href: `https://go.xero.com/AccountsReceivable/View.aspx?InvoiceID=${encodeURIComponent(matched.xero.invoiceId)}`,
+    target: '_blank',
+    rel: 'noopener',
+  }, 'Open in Xero') : null;
+  const problemRow = problemNotice ? (openXero ? h('div', { class: 'fx-offer' }, problemNotice, openXero) : problemNotice) : null;
   const header = h('header', { class: 'fx-ph' },
     h('div', { class: 'fx-ph__text' },
       h('h1', { class: 'fx-title' }, invoice.number),
@@ -1449,6 +1464,7 @@ function issuedView(invoice, ui, context, redraw) {
     chrome.record,
     chrome.pager,
     header,
+    problemRow,
     h('div', { class: 'fx-invoice__grid' },
       h('div', { class: 'fx-invoice__main' },
         h('section', { class: 'fx-card fx-doc' },