@burdenoff/microfe-movethewheels 2026.1016.3 → 2026.1016.4

package/src/generated/wspace-types.ts

@@ -1,11 +1,5 @@
-// @ts-nocheck
 export type Maybe<T> = T | null;
 export type InputMaybe<T> = Maybe<T>;
-export type Exact<T extends { [key: string]: unknown }> = { [K in keyof T]: T[K] };
-export type MakeOptional<T, K extends keyof T> = Omit<T, K> & { [SubKey in K]?: Maybe<T[SubKey]> };
-export type MakeMaybe<T, K extends keyof T> = Omit<T, K> & { [SubKey in K]: Maybe<T[SubKey]> };
-export type MakeEmpty<T extends { [key: string]: unknown }, K extends keyof T> = { [_ in K]?: never };
-export type Incremental<T> = T | { [P in keyof T]?: P extends ' $fragmentName' | '__typename' ? T[P] : never };
 /** All built-in and custom scalars, mapped to their actual values */
 export type Scalars = {
   ID: { input: string; output: string; }
@@ -25,8 +19,8 @@ export type Scalars = {
   JSONObject: { input: Record<string, unknown>; output: Record<string, unknown>; }
   /** Upload scalar (file upload) */
   Upload: { input: File; output: File; }
-  _ScalarsPlaceholder: { input: any; output: any; }
-  _SecurityMainPlaceholder: { input: any; output: any; }
+  _ScalarsPlaceholder: { input: unknown; output: unknown; }
+  _SecurityMainPlaceholder: { input: unknown; output: unknown; }
 };
 
 export type A2AConnection = {

package/src/movethewheels/MoveTheWheelsRoot.tsx

@@ -265,6 +265,12 @@ const NavRegistrar: FC<Pick<MoveTheWheelsRootProps, 'registerNavItems' | 'basePa
           icon: <DollarSign size={16} />,
           order: 9,
           children: [
+            {
+              id: 'mtw-freight-invoice-comparisons',
+              label: tr('movethewheels.root.nav.freightInvoices', 'Freight invoice comparisons'),
+              path: joinPath(basePath, 'finance/freight-invoice-comparisons'),
+              icon: <DollarSign size={16} />,
+            },
             {
               id: 'mtw-freight-estimates',
               label: tr('movethewheels.root.nav.freightEstimates', 'Freight cost estimates'),

package/src/movethewheels/MoveTheWheelsRoutes.tsx

@@ -75,6 +75,7 @@ const RouteDetailsPage = lazy(() => import('./pages/RouteDetailsPage'));
 const AnalyticsPage = lazy(() => import('./pages/AnalyticsPage'));
 const FinancePage = lazy(() => import('./pages/FinancePage'));
 const FreightEstimatePage = lazy(() => import('./pages/FreightEstimatePage'));
+const FreightInvoicePage = lazy(() => import('./pages/FreightInvoicePage'));
 const ConsolidationPage = lazy(() => import('./pages/ConsolidationPage'));
 const LogisticsProceduresPage = lazy(() => import('./pages/LogisticsProceduresPage'));
 const MarketplacePage = lazy(() => import('./pages/MarketplacePage'));
@@ -169,6 +170,7 @@ export function MoveTheWheelsRoutes() {
         {/* Finance */}
         <Route path="finance" element={<FinancePage />} />
         <Route path="finance/freight-estimates" element={<FreightEstimatePage />} />
+        <Route path="finance/freight-invoice-comparisons" element={<FreightInvoicePage />} />
 
         {/* Marketplace */}
         <Route path="marketplace" element={<MarketplacePage />} />

package/src/movethewheels/components/ContainerEvidencePicker.tsx

@@ -1,6 +1,8 @@
 import { useState } from 'react';
 import {
   ContainerEvidenceFilesDocument,
+  InvoiceEvidenceVersionsDocument,
+  type InvoiceEvidenceVersionsQuery,
   ContainerEvidenceVersionsDocument,
   type ContainerEvidenceFilesQuery,
   type ContainerEvidenceVersionsQuery,
@@ -16,11 +18,13 @@ export interface SelectedEvidence extends MtwContainerEvidenceInput {
 export function ContainerEvidencePicker({
   value,
   onChange,
+  currentOnly = false,
   description = 'Choose exact versions from shared Files. Evidence integrity does not confirm the issuer or certify the container.',
 }: {
   value: SelectedEvidence[];
   onChange: (value: SelectedEvidence[]) => void;
   description?: string;
+  currentOnly?: boolean;
 }) {
   const [fileId, setFileId] = useState('');
   const [fileOffset, setFileOffset] = useState(0);
@@ -28,8 +32,8 @@ export function ContainerEvidencePicker({
   const files = useConditionQuery<ContainerEvidenceFilesQuery>(ContainerEvidenceFilesDocument, {
     pagination: { limit: 25, offset: fileOffset },
   });
-  const versions = useConditionQuery<ContainerEvidenceVersionsQuery>(
-    ContainerEvidenceVersionsDocument,
+  const versions = useConditionQuery<ContainerEvidenceVersionsQuery | InvoiceEvidenceVersionsQuery>(
+    currentOnly ? InvoiceEvidenceVersionsDocument : ContainerEvidenceVersionsDocument,
     fileId ? { fileId, pagination: { limit: 25, offset: versionOffset } } : null
   );
   return (
@@ -87,7 +91,9 @@ export function ContainerEvidencePicker({
       {versions.loading && <p role="status">Loading file versions…</p>}
       {versions.data?.getFileVersions.versions.map((version) => {
         const selected = value.some((item) => item.versionId === version.id);
-        const valid = /^[a-fA-F0-9]{64}$/.test(version.sha256Hash ?? '');
+        const current =
+          !currentOnly || ('isCurrentVersion' in version && version.isCurrentVersion === true);
+        const valid = current && /^[a-fA-F0-9]{64}$/.test(version.sha256Hash ?? '');
         const label = `${version.name} — version ${version.versionLabel ?? version.versionNumber}`;
         return (
           <label key={version.id} className="flex gap-2 text-sm">
@@ -104,7 +110,9 @@ export function ContainerEvidencePicker({
               }
             />
             {label}
-            {!valid && ' (integrity fingerprint unavailable)'}
+            {!current
+              ? ' (not confirmed current)'
+              : !valid && ' (integrity fingerprint unavailable)'}
           </label>
         );
       })}

package/src/movethewheels/components/FleetAlertsPanel.tsx

@@ -99,7 +99,7 @@ export function FleetAlertsPanel({
           <p className="text-sm text-text-secondary">
             {t(
               'movethewheels.fleet.alerts.allClear',
-              'All clear — every licence is valid and no vehicle is due for service.'
+              'No recorded fleet alerts. This does not certify legal driving eligibility or duty-hours availability.'
             )}
           </p>
         </CardContent>
@@ -133,7 +133,9 @@ export function FleetAlertsPanel({
                     showDot={false}
                   />
                   <span className="flex-1 min-w-0">
-                    <span className="block text-sm font-medium truncate">{alert.message}</span>
+                    <span className="block text-sm font-medium whitespace-normal break-words">
+                      {alert.message}
+                    </span>
                     {detail && <span className="block text-xs text-text-secondary">{detail}</span>}
                   </span>
                   <ChevronRight size={16} aria-hidden="true" className="shrink-0" />

package/src/movethewheels/components/freight-invoice/InvoiceForm.tsx

@@ -0,0 +1,412 @@
+import { useEffect, useRef, useState } from 'react';
+import type {
+  CompareMtwFreightInvoiceInput,
+  InvoiceEstimatePinFragment,
+  InvoiceEstimateVersionQuery,
+  InvoiceReceiptFragment,
+  InvoiceStructuralPreviewQuery,
+  MtwFreightInvoiceFactsInput,
+} from '../../../generated/freight-invoice-operations';
+import { ContainerEvidencePicker, type SelectedEvidence } from '../ContainerEvidencePicker';
+import { Button } from '../ui';
+import { FreightCurrency, FreightSelect, FreightText } from '../freight-cost/FreightFields';
+import {
+  invoiceCanonical,
+  invoiceFactsInput,
+  matchesInvoicePreview,
+} from '../../utils/invoiceComparison';
+import { fixedFreightMinor, freightMoney } from '../../utils/freightDraft';
+import { InvoiceResults } from './InvoiceResults';
+
+export type InvoiceEstimate = InvoiceEstimateVersionQuery['mtwFreightEstimateVersion'];
+function blankFacts(): MtwFreightInvoiceFactsInput {
+  return {
+    schemaVersion: 1,
+    supplierReference: null,
+    supplierLabel: null,
+    invoiceReference: null,
+    sourceReference: '',
+    sourceRevision: '',
+    invoiceDate: null,
+    currency: { code: '', minorUnitDigits: 2 },
+    rows: [
+      {
+        id: crypto.randomUUID(),
+        description: '',
+        estimateLineId: null,
+        currency: { code: '', minorUnitDigits: 2 },
+        payerReference: null,
+        payerLabel: null,
+        quantity: null,
+        unit: null,
+        unitRateMajor: null,
+        amountMinor: null,
+        zeroReason: null,
+      },
+    ],
+  };
+}
+export function invoiceEstimatePin(estimate: InvoiceEstimate): InvoiceEstimatePinFragment {
+  return {
+    id: estimate.id,
+    estimateReference: estimate.estimateReference,
+    version: estimate.version,
+    kind: estimate.facts.kind,
+    sourceReference: estimate.facts.sourceReference,
+    sourceRevision: estimate.facts.sourceRevision,
+    quotedAt: estimate.facts.quotedAt,
+    validFrom: estimate.facts.validFrom,
+    validUntil: estimate.facts.validUntil,
+    acceptance: 'NOT_ESTABLISHED',
+  };
+}
+export function InvoiceForm({
+  estimate,
+  previous,
+  disabled,
+  canRecord,
+  onPreview,
+  onSave,
+}: {
+  estimate: InvoiceEstimate;
+  previous: InvoiceReceiptFragment | null;
+  disabled: boolean;
+  canRecord: boolean;
+  onPreview: (input: {
+    shipmentId: string;
+    estimateVersionId: string;
+    facts: MtwFreightInvoiceFactsInput;
+    evidence: { fileId: string; versionId: string }[];
+  }) => Promise<InvoiceStructuralPreviewQuery['previewMtwFreightInvoice']>;
+  onSave: (
+    input: Omit<CompareMtwFreightInvoiceInput, 'idempotencyKey'>,
+    pin: InvoiceEstimatePinFragment
+  ) => Promise<InvoiceReceiptFragment | null | undefined>;
+}) {
+  const [facts, setFacts] = useState<MtwFreightInvoiceFactsInput>(() =>
+      previous ? structuredClone(previous.facts) : blankFacts()
+    ),
+    [evidence, setEvidence] = useState<SelectedEvidence[]>([]),
+    [reason, setReason] = useState('');
+  const [preview, setPreview] = useState<{
+      body: string;
+      value: InvoiceStructuralPreviewQuery['previewMtwFreightInvoice'];
+    } | null>(null),
+    [error, setError] = useState<string | null>(null),
+    [previewing, setPreviewing] = useState(false);
+  const form = useRef<HTMLFormElement | null>(null);
+  const alive = useRef(true),
+    running = useRef(false);
+  useEffect(() => {
+    alive.current = true;
+    return () => {
+      alive.current = false;
+    };
+  }, []);
+  // The owning workbench is keyed by canonical context; no old draft is rebound to a new owner.
+  const body = invoiceCanonical({
+    facts,
+    evidence: evidence.map(({ fileId, versionId }) => ({ fileId, versionId })),
+    estimateId: estimate.id,
+  });
+  const current = preview?.body === body ? preview.value : null;
+  const patch = (v: Partial<MtwFreightInvoiceFactsInput>) => setFacts({ ...facts, ...v });
+  const changeRow = (id: string, v: Partial<MtwFreightInvoiceFactsInput['rows'][number]>) =>
+    patch({ rows: facts.rows.map((r) => (r.id === id ? { ...r, ...v } : r)) });
+  const previewNow = async () => {
+    if (running.current || disabled || !form.current?.reportValidity()) return;
+    running.current = true;
+    setPreviewing(true);
+    setError(null);
+    const original = body;
+    try {
+      const normalized = invoiceFactsInput(facts),
+        value = await onPreview({
+          shipmentId: estimate.shipmentId,
+          estimateVersionId: estimate.id,
+          facts: normalized,
+          evidence: evidence.map(({ fileId, versionId }) => ({ fileId, versionId })),
+        });
+      if (!matchesInvoicePreview(value, normalized, invoiceEstimatePin(estimate)))
+        throw new Error(
+          'The preview did not match these reported facts and exact estimate. Nothing was sent.'
+        );
+      if (alive.current) setPreview({ body: original, value });
+    } catch (failure) {
+      if (alive.current)
+        setError(
+          failure instanceof Error ? failure.message : 'Unable to preview the reported facts.'
+        );
+    } finally {
+      running.current = false;
+      if (alive.current) setPreviewing(false);
+    }
+  };
+  return (
+    <form
+      ref={form}
+      className="min-w-0 space-y-5"
+      aria-label="Manual invoice comparison"
+      onSubmit={(event) => {
+        event.preventDefault();
+        if (!current || current.recordable !== true || disabled || !canRecord || running.current)
+          return;
+        setError(null);
+        try {
+          const normalized = invoiceFactsInput(facts);
+          void onSave(
+            {
+              shipmentId: estimate.shipmentId,
+              estimateVersionId: estimate.id,
+              facts: normalized,
+              evidence: evidence.map(({ fileId, versionId }) => ({ fileId, versionId })),
+              expectedRevision: previous?.revision ?? 0,
+              expectedPreviousComparisonId: previous?.id ?? null,
+              correctionReason: previous ? reason.trim() || null : null,
+            },
+            invoiceEstimatePin(estimate)
+          ).catch(() =>
+            setError('The original request remains retained; inspect read-only recovery.')
+          );
+        } catch (failure) {
+          setError(
+            failure instanceof Error
+              ? failure.message
+              : 'Review the reported source fields. Nothing was sent.'
+          );
+        }
+      }}
+    >
+      <fieldset disabled={disabled || previewing} className="min-w-0 space-y-5">
+        <legend className="text-lg font-semibold">
+          {previous ? 'Append an immutable correction' : 'Reported supplier invoice'}
+        </legend>
+        <p>
+          Blank means unknown, never zero. This is a manual comparison, not approval or payment. No
+          FX, credits or split allocation.
+        </p>
+        <p>
+          Exact pinned {estimate.facts.kind.toLowerCase()}: {estimate.estimateReference} / version{' '}
+          {estimate.version}; {estimate.facts.title}. Source validity: {estimate.validityAtRead}.
+          Acceptance is not established.
+        </p>
+        <div className="grid min-w-0 gap-3 md:grid-cols-2">
+          <FreightText
+            label="Supplier source reference"
+            value={facts.supplierReference ?? ''}
+            disabled={!!previous}
+            onChange={(supplierReference) => patch({ supplierReference })}
+          />
+          <FreightText
+            label="Supplier label"
+            value={facts.supplierLabel ?? ''}
+            onChange={(supplierLabel) => patch({ supplierLabel })}
+          />
+          <FreightText
+            label="Invoice reference"
+            value={facts.invoiceReference ?? ''}
+            disabled={!!previous}
+            onChange={(invoiceReference) => patch({ invoiceReference })}
+          />
+          <FreightText
+            label="Invoice source reference"
+            value={facts.sourceReference}
+            required
+            onChange={(sourceReference) => patch({ sourceReference })}
+          />
+          <FreightText
+            label="Invoice source revision"
+            value={facts.sourceRevision}
+            required
+            onChange={(sourceRevision) => patch({ sourceRevision })}
+          />
+          <FreightText
+            label="Invoice source date (optional)"
+            type="date"
+            value={facts.invoiceDate ?? ''}
+            onChange={(invoiceDate) => patch({ invoiceDate: invoiceDate || null })}
+          />
+        </div>
+        <FreightCurrency
+          label="Invoice currency"
+          value={facts.currency}
+          onChange={(currency) =>
+            patch({
+              currency,
+              rows: facts.rows.map((r) => ({
+                ...r,
+                currency,
+                amountMinor: null,
+                zeroReason: null,
+              })),
+            })
+          }
+        />
+        {facts.rows.map((row, index) => (
+          <fieldset key={row.id} className="min-w-0 space-y-3 rounded border p-3">
+            <legend className="font-semibold">Reported row {index + 1}</legend>
+            <FreightText
+              label={`Row ${index + 1} description`}
+              value={row.description}
+              required
+              onChange={(description) => changeRow(row.id, { description })}
+            />
+            <FreightSelect
+              label={`Row ${index + 1} exact estimate mapping`}
+              value={row.estimateLineId ?? ''}
+              onChange={(estimateLineId) =>
+                changeRow(row.id, { estimateLineId: estimateLineId || null })
+              }
+            >
+              <option value="">Unmatched invoice row</option>
+              {estimate.facts.lines.map((line) => (
+                <option key={line.id} value={line.id}>
+                  {line.description} / {line.id} / {line.disposition}
+                </option>
+              ))}
+            </FreightSelect>
+            <div className="grid min-w-0 gap-3 md:grid-cols-2">
+              <FreightText
+                label={`Row ${index + 1} payer source reference`}
+                value={row.payerReference ?? ''}
+                onChange={(payerReference) => changeRow(row.id, { payerReference })}
+              />
+              <FreightText
+                label={`Row ${index + 1} payer label`}
+                value={row.payerLabel ?? ''}
+                onChange={(payerLabel) => changeRow(row.id, { payerLabel })}
+              />
+              <label className="block text-sm">
+                Row {index + 1} supplied amount ({row.currency.code || 'declare currency'})
+                <input
+                  key={`${row.currency.code}:${row.currency.minorUnitDigits}`}
+                  className="mt-1 min-h-11 w-full rounded border p-2"
+                  aria-label={`Row ${index + 1} supplied amount`}
+                  inputMode="decimal"
+                  defaultValue={
+                    row.amountMinor == null
+                      ? ''
+                      : freightMoney(row.amountMinor, row.currency.minorUnitDigits)
+                  }
+                  onChange={(event) => {
+                    try {
+                      changeRow(row.id, {
+                        amountMinor: fixedFreightMinor(
+                          event.target.value,
+                          row.currency.minorUnitDigits
+                        ),
+                      });
+                      event.target.setCustomValidity('');
+                    } catch (failure) {
+                      changeRow(row.id, { amountMinor: null });
+                      event.target.setCustomValidity(
+                        failure instanceof Error ? failure.message : 'Invalid sourced amount.'
+                      );
+                    }
+                  }}
+                />
+              </label>
+              <FreightText
+                label={`Row ${index + 1} zero source reason`}
+                value={row.zeroReason ?? ''}
+                onChange={(zeroReason) => changeRow(row.id, { zeroReason })}
+              />
+              <FreightText
+                label={`Row ${index + 1} supplied quantity`}
+                value={row.quantity ?? ''}
+                onChange={(quantity) => changeRow(row.id, { quantity })}
+              />
+              <FreightText
+                label={`Row ${index + 1} explicit unit`}
+                value={row.unit ?? ''}
+                onChange={(unit) => changeRow(row.id, { unit })}
+              />
+              <FreightText
+                label={`Row ${index + 1} supplied unit rate`}
+                value={row.unitRateMajor ?? ''}
+                onChange={(unitRateMajor) => changeRow(row.id, { unitRateMajor })}
+              />
+            </div>
+            <p>
+              {facts.currency.code || 'currency unknown'} / decimal places{' '}
+              {facts.currency.minorUnitDigits}. Amount stays as supplied, not quantity × rate.
+            </p>
+            <Button
+              type="button"
+              variant="outline"
+              disabled={facts.rows.length === 1}
+              onClick={() => patch({ rows: facts.rows.filter((r) => r.id !== row.id) })}
+            >
+              Remove row {index + 1}
+            </Button>
+          </fieldset>
+        ))}
+        <Button
+          type="button"
+          variant="outline"
+          disabled={facts.rows.length >= 100}
+          onClick={() =>
+            patch({
+              rows: [
+                ...facts.rows,
+                {
+                  id: crypto.randomUUID(),
+                  description: '',
+                  estimateLineId: null,
+                  currency: { ...facts.currency },
+                  payerReference: null,
+                  payerLabel: null,
+                  quantity: null,
+                  unit: null,
+                  unitRateMajor: null,
+                  amountMinor: null,
+                  zeroReason: null,
+                },
+              ],
+            })
+          }
+        >
+          Add reported row
+        </Button>
+        <ContainerEvidencePicker
+          currentOnly
+          value={evidence}
+          onChange={setEvidence}
+          description="Choose current readable ACTIVE Files versions with an integrity fingerprint. The server rechecks eligibility when recording; no binary is uploaded here."
+        />
+        {previous && (
+          <FreightText
+            label="Correction source reason"
+            value={reason}
+            required={false}
+            onChange={setReason}
+          />
+        )}
+        <div className="flex flex-wrap gap-3">
+          <Button type="button" variant="outline" onClick={() => void previewNow()}>
+            Preview reported comparison
+          </Button>
+          <Button
+            type="submit"
+            disabled={
+              !canRecord ||
+              current?.recordable !== true ||
+              !evidence.length ||
+              (!!previous && !reason.trim())
+            }
+          >
+            Record immutable comparison
+          </Button>
+        </div>
+      </fieldset>
+      {!canRecord && (
+        <p>
+          Shipment update permission is required to record; structural preview remains read-only.
+        </p>
+      )}
+      {previewing && <p role="status">Comparing the exact recorded facts…</p>}
+      {error && <p role="alert">{error}</p>}
+      {current && <InvoiceResults value={current} />}
+    </form>
+  );
+}