@burdenoff/microfe-movethewheels 2026.930.5 → 2026.1010.1

package/src/movethewheels/components/pending-pick/PickLineSelection.tsx

@@ -0,0 +1,130 @@
+import { useState } from 'react';
+import type { PickInventoryQuery } from '../../../generated/pending-pick-operations';
+import { Button, Input } from '../ui';
+import { PinnedSelect, ReusePager, ReuseState, reuseCard } from '../ReuseControls';
+export function PickLineSelection({
+  inventory,
+  sourceId,
+  destinationId,
+  locked,
+  offset,
+  onOffset,
+  onSelect,
+  onRefresh,
+  refreshBusy,
+}: {
+  inventory: { data: PickInventoryQuery | null; loading: boolean; error: string | null };
+  sourceId: string;
+  destinationId: string;
+  locked: boolean;
+  offset: number;
+  onOffset: (value: number) => void;
+  onSelect: (side: 'source' | 'destination', id: string) => void;
+  onRefresh: () => void;
+  refreshBusy: boolean;
+}) {
+  const [knownSource, setKnownSource] = useState(''),
+    [knownDestination, setKnownDestination] = useState('');
+  const rows = inventory.data?.inventoryItems ?? [];
+  const source = rows.find((row) => row.id === sourceId);
+  const label = (row: (typeof rows)[number]) =>
+    `${row.cargoItem?.name ?? 'Unknown cargo'} · ${row.cargoItem?.sku ?? 'Unknown SKU'} · ${row.warehouse?.name ?? 'Unknown warehouse'} · ${row.location?.locationCode ?? 'No bin'} · line ${row.id}`;
+  const sourceOptions = rows
+    .filter((row) => row.locationId != null)
+    .map((row) => ({ id: row.id, label: label(row) }));
+  const destinationOptions = rows
+    .filter(
+      (row) =>
+        row.id !== sourceId &&
+        row.locationId != null &&
+        (!source ||
+          (row.cargoItemId === source.cargoItemId &&
+            row.warehouseId === source.warehouseId &&
+            row.locationId !== source.locationId))
+    )
+    .map((row) => ({ id: row.id, label: label(row) }));
+  if (sourceId && !sourceOptions.some((row) => row.id === sourceId))
+    sourceOptions.unshift({ id: sourceId, label: `Known source line ${sourceId}` });
+  if (destinationId && !destinationOptions.some((row) => row.id === destinationId))
+    destinationOptions.unshift({ id: destinationId, label: `Known staging line ${destinationId}` });
+  const page = inventory.data
+    ? {
+        total: inventory.data.inventoryItemsCount,
+        limit: 25,
+        offset,
+        hasMore: offset + rows.length < inventory.data.inventoryItemsCount,
+        nextOffset: offset + 25,
+      }
+    : undefined;
+  return (
+    <section className={reuseCard}>
+      <p>
+        This records a plan needing review. It does not reserve stock, authorize handling, or record
+        movement.
+      </p>
+      <ReuseState loading={inventory.loading} error={inventory.error} />
+      <PinnedSelect
+        label="Source inventory line"
+        value={sourceId}
+        options={sourceOptions}
+        disabled={locked}
+        onChange={(id) => onSelect('source', id)}
+      />
+      <PinnedSelect
+        label="Staging inventory line"
+        value={destinationId}
+        options={destinationOptions}
+        disabled={locked || !sourceId}
+        onChange={(id) => onSelect('destination', id)}
+      />
+      <div className="grid gap-3 sm:grid-cols-2">
+        <label>
+          Known source line ID
+          <Input
+            value={knownSource}
+            maxLength={255}
+            disabled={locked}
+            onChange={(e) => setKnownSource(e.target.value)}
+          />
+          <Button
+            type="button"
+            variant="outline"
+            disabled={locked || !knownSource.trim()}
+            onClick={() => onSelect('source', knownSource.trim())}
+          >
+            Choose exact source
+          </Button>
+        </label>
+        <label>
+          Known staging line ID
+          <Input
+            value={knownDestination}
+            maxLength={255}
+            disabled={locked || !sourceId}
+            onChange={(e) => setKnownDestination(e.target.value)}
+          />
+          <Button
+            type="button"
+            variant="outline"
+            disabled={locked || !sourceId || !knownDestination.trim()}
+            onClick={() => onSelect('destination', knownDestination.trim())}
+          >
+            Choose exact staging line
+          </Button>
+        </label>
+      </div>
+      <p className="break-all text-sm">
+        Selected source {sourceId || 'None'}; staging {destinationId || 'None'}.
+      </p>
+      <ReusePager
+        page={page}
+        offset={offset}
+        onChange={onOffset}
+        busy={locked || inventory.loading}
+      />
+      <Button type="button" variant="outline" disabled={refreshBusy} onClick={onRefresh}>
+        Refresh current context and history
+      </Button>
+    </section>
+  );
+}

package/src/movethewheels/components/stock-binding/StockAssessmentDraft.tsx

@@ -0,0 +1,52 @@
+import type { StockDraftPin, StockFactDraft } from '../../utils/stockBindingForm';
+import { reuseCard } from '../ReuseControls';
+import { Button } from '../ui';
+import { StockFactForm } from './StockFactForm';
+export function StockAssessmentDraft({
+  pin,
+  mismatch,
+  uncertain,
+  startDisabled,
+  formDisabled,
+  onStart,
+  onSubmit,
+}: {
+  pin: (StockDraftPin & { generation: string }) | null;
+  mismatch: boolean;
+  uncertain: boolean;
+  startDisabled: boolean;
+  formDisabled: boolean;
+  onStart: () => void;
+  onSubmit: (draft: StockFactDraft) => Promise<void>;
+}) {
+  return (
+    <section className={reuseCard} aria-label="Record declared source facts">
+      <h2 className="text-lg font-semibold">Review and record reported facts</h2>
+      <p className="text-sm">
+        Review this stock line before entering facts. If it or its recorded history changes, start a
+        new draft.
+      </p>
+      {pin && (
+        <p>
+          Reviewed stock line: {pin.label}; after recorded version {pin.expectedVersion}. Continuity
+          revision: {pin.expectedCompositionEpoch}.
+        </p>
+      )}
+      {mismatch && (
+        <p role="alert">
+          This stock line or its recorded history changed. Refresh and review a new draft. Unsaved
+          fields are cleared; the original uncertain request is kept for retry.
+        </p>
+      )}
+      {uncertain && (
+        <p>Check history and retry or discard the uncertain request before starting a new draft.</p>
+      )}
+      <Button type="button" variant="outline" disabled={startDisabled} onClick={onStart}>
+        Review stock line and start a draft
+      </Button>
+      {pin && !mismatch && (
+        <StockFactForm key={pin.generation} busy={formDisabled} onSubmit={onSubmit} />
+      )}
+    </section>
+  );
+}

package/src/movethewheels/components/stock-binding/StockAssessmentHistory.tsx

@@ -0,0 +1,56 @@
+import type {
+  StockAssessmentFragment,
+  StockBindingHistoryQuery,
+} from '../../../generated/stock-binding-operations';
+import { ReuseState, ReusePager, reuseCard } from '../ReuseControls';
+import { Button } from '../ui';
+import { StockAssessmentSummary } from './StockAssessmentSummary';
+import { stockCompletenessLabel } from '../../utils/stockBindingLabels';
+export function StockAssessmentHistory({
+  query,
+  current,
+  selected,
+  onSelect,
+  offset,
+  onPage,
+  busy,
+}: {
+  query: { data: StockBindingHistoryQuery | null; loading: boolean; error: string | null };
+  current?: { id: string; compositionEpoch: number } | null;
+  selected: StockAssessmentFragment | null;
+  onSelect: (value: StockAssessmentFragment) => void;
+  offset: number;
+  onPage: (offset: number) => void;
+  busy: boolean;
+}) {
+  const page = query.data?.mtwStockBindingAssessmentPage;
+  return (
+    <section className={reuseCard} aria-label="Immutable source assessment history">
+      <h2 className="text-lg font-semibold">Recorded assessment history</h2>
+      <p>History follows recorded order, including future effective dates.</p>
+      <ReuseState {...query} />
+      {page?.items.length === 0 && <p>No assessments recorded for this inventory line.</p>}
+      {page?.items.map((item) => (
+        <div key={item.id} className="flex flex-wrap items-center gap-3 rounded border p-3">
+          <p>
+            Version {item.version}; effective {item.effectiveAt}; recorded {item.recordedAt};{' '}
+            {stockCompletenessLabel(item.completeness.status)}. Continuity revision{' '}
+            {item.capturedCompositionEpoch ?? 'not recorded'}.
+          </p>
+          <Button type="button" variant="outline" disabled={busy} onClick={() => onSelect(item)}>
+            Inspect recorded version
+          </Button>
+        </div>
+      ))}
+      <ReusePager page={page} offset={offset} onChange={onPage} busy={busy || query.loading} />
+      {selected && (
+        <>
+          <p className="text-sm">
+            The selected recorded version stays available as you browse history.
+          </p>
+          <StockAssessmentSummary assessment={selected} current={current} />
+        </>
+      )}
+    </section>
+  );
+}

package/src/movethewheels/components/stock-binding/StockAssessmentSummary.tsx

@@ -0,0 +1,108 @@
+import type { StockAssessmentFragment } from '../../../generated/stock-binding-operations';
+import {
+  stockContinuityLabel,
+  stockCompletenessLabel,
+  stockFactLabel,
+  stockMissingFactLabel,
+} from '../../utils/stockBindingLabels';
+export function StockAssessmentSummary({
+  assessment,
+  current,
+}: {
+  assessment: StockAssessmentFragment;
+  current?: { id: string; compositionEpoch: number } | null;
+}) {
+  const { facts, criticalOwnerSnapshot: owner, capturedStockQuantityAudit: quantity } = assessment;
+  const known = (value: string | number | null | undefined) => value ?? 'Unknown';
+  return (
+    <article className="space-y-3 rounded border p-4">
+      <h3 className="font-semibold">
+        Recorded version {assessment.version} — {owner.warehouseCode} / {owner.cargoSku} /{' '}
+        {owner.locationId === null ? 'Unbinned' : known(owner.locationCode)}
+      </h3>
+      <p>{stockContinuityLabel(assessment, current)}</p>
+      <p>
+        Effective {assessment.effectiveAt}; recorded {assessment.recordedAt}.
+      </p>
+      <p>
+        {stockCompletenessLabel(assessment.completeness.status)}. These are recorded declarations;
+        they do not verify scans or authorize picking.
+      </p>
+      {assessment.completeness.reasons.length > 0 && (
+        <ul className="list-disc pl-5">
+          {assessment.completeness.reasons.map((reason) => (
+            <li key={reason}>{stockMissingFactLabel(reason)}</li>
+          ))}
+        </ul>
+      )}
+      <p>
+        Scope {stockFactLabel(facts.scope)}; source {known(facts.source.reference)} / revision{' '}
+        {known(facts.source.revision)}.
+      </p>
+      <p>
+        Count unit {stockFactLabel(facts.countUnit?.kind)}; source{' '}
+        {known(facts.countUnit?.reference)} / {known(facts.countUnit?.revision)}.
+      </p>
+      <p>
+        Reported item {known(facts.scanMapping?.reportedItemLabel)}; bin{' '}
+        {known(facts.scanMapping?.reportedBinLabel)}; mapping{' '}
+        {known(facts.scanMapping?.mappingReference)} / {known(facts.scanMapping?.mappingRevision)}.
+      </p>
+      <p>
+        Declared lot requirement {stockFactLabel(facts.declaredLotPolicy)}; lot{' '}
+        {known(facts.lot?.reference)} / {known(facts.lot?.revision)}; disposition{' '}
+        {stockFactLabel(facts.lot?.declaredDisposition)}.
+      </p>
+      <p>
+        Lot expiry policy {stockFactLabel(facts.lot?.expiry.policy)}; cutoff{' '}
+        {known(facts.lot?.expiry.expiresAt)}; source {known(facts.lot?.expiry.sourceReference)} /{' '}
+        {known(facts.lot?.expiry.sourceRevision)}.
+      </p>
+      <p>
+        Physical source validity {stockFactLabel(facts.sourceValidity.policy)};{' '}
+        {known(facts.sourceValidity.from)}–{known(facts.sourceValidity.until)}; source{' '}
+        {known(facts.sourceValidity.sourceReference)} / {known(facts.sourceValidity.sourceRevision)}
+        .
+      </p>
+      <details className="space-y-2">
+        <summary>Captured owner and evidence audit</summary>
+        <p>
+          Recorded by {assessment.createdBy}; actor provenance {assessment.actorProvenance}.
+        </p>
+        <p>
+          These fixed captured labels and revisions are historical; they are not substituted from
+          the current inventory record.
+        </p>
+        <p>
+          Warehouse status {owner.warehouseStatus}; location status {known(owner.locationStatus)};
+          cargo hazardous {String(owner.cargoHazardous)}, fragile {String(owner.cargoFragile)},
+          temperature controlled {String(owner.cargoTemperatureControlled)}.
+        </p>
+        <p>
+          At capture: on hand {quantity.onHand}, available {quantity.available}, allocated{' '}
+          {quantity.allocated}, damaged {quantity.damaged}. This assessment does not change
+          balances.
+        </p>
+        <p>
+          Inventory {assessment.inventoryItemId}; cargo {assessment.capturedCargoItemId}; warehouse{' '}
+          {assessment.capturedWarehouseId}; location {known(assessment.capturedLocationId)}.
+        </p>
+        <p>
+          Revisions: inventory {assessment.capturedInventoryUpdatedAt}; cargo{' '}
+          {assessment.capturedCargoUpdatedAt}; warehouse {assessment.capturedWarehouseUpdatedAt};
+          location {known(assessment.capturedLocationUpdatedAt)}.
+        </p>
+        <p>
+          Assessment {assessment.id}; predecessor {known(assessment.previousAssessmentId)}; critical
+          fingerprint {assessment.criticalFingerprint}; on behalf of {known(assessment.onBehalfOf)}.
+        </p>
+        {assessment.evidence.map((item) => (
+          <p key={item.versionId}>
+            File {item.fileId}; exact version {item.versionId}; SHA-256 {item.sha256Hash};
+            point-in-time Files receipt {item.checkedAt}.
+          </p>
+        ))}
+      </details>
+    </article>
+  );
+}

package/src/movethewheels/components/stock-binding/StockFactForm.tsx

@@ -0,0 +1,186 @@
+import { useState } from 'react';
+import { ContainerEvidencePicker, type SelectedEvidence } from '../ContainerEvidencePicker';
+import { ReuseField, reuseSelect } from '../ReuseControls';
+import { Button } from '../ui';
+import { stockFactLabel } from '../../utils/stockBindingLabels';
+import { readStockFactDraft, type StockFactDraft } from '../../utils/stockBindingForm';
+
+function Choice({
+  name,
+  label,
+  options,
+  onChange,
+}: {
+  name: string;
+  label: string;
+  options: string[];
+  onChange?: (value: string) => void;
+}) {
+  return (
+    <label className="block">
+      {label}
+      <select
+        name={name}
+        className={reuseSelect}
+        defaultValue="UNKNOWN"
+        onChange={(event) => onChange?.(event.target.value)}
+      >
+        {options.map((value) => (
+          <option key={value} value={value}>
+            {stockFactLabel(value)}
+          </option>
+        ))}
+      </select>
+    </label>
+  );
+}
+function SourcePair({ prefix, label }: { prefix: string; label: string }) {
+  return (
+    <div className="grid gap-3 md:grid-cols-2">
+      <ReuseField
+        label={`${label} reference (blank = unknown)`}
+        name={`${prefix}Reference`}
+        required={false}
+      />
+      <ReuseField
+        label={`${label} revision (blank = unknown)`}
+        name={`${prefix}Revision`}
+        required={false}
+        maxLength={120}
+      />
+    </div>
+  );
+}
+export function StockFactForm({
+  busy,
+  onSubmit,
+}: {
+  busy: boolean;
+  onSubmit: (draft: StockFactDraft) => Promise<void>;
+}) {
+  const [evidence, setEvidence] = useState<SelectedEvidence[]>([]);
+  const [lotPresent, setLotPresent] = useState(false);
+  const [unitPresent, setUnitPresent] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  return (
+    <form
+      className="space-y-4"
+      onSubmit={async (event) => {
+        event.preventDefault();
+        setError(null);
+        try {
+          await onSubmit(readStockFactDraft(new FormData(event.currentTarget), evidence));
+        } catch (failure) {
+          setError(failure instanceof Error ? failure.message : 'Unable to record assessment.');
+        }
+      }}
+    >
+      <fieldset disabled={busy} className="space-y-4">
+        <p className="text-sm">
+          Blank facts remain unknown. Physical labels are your reported observations; the selected
+          database item and bin do not populate or authenticate scans. No EACH/case/pallet
+          conversion is inferred.
+        </p>
+        <ReuseField
+          label="Assessment effective time (ISO with seconds and timezone)"
+          name="effectiveAt"
+        />
+        <p className="text-sm">
+          Use Z or an explicit offset, e.g. 2026-10-04T08:00:00+05:30. A future effective time is
+          recordable and does not replace current operational eligibility.
+        </p>
+        <Choice
+          name="scope"
+          label="Declared line scope"
+          options={['UNKNOWN', 'WHOLE_LINE', 'UNSUPPORTED_MIXED_LOT']}
+        />
+        <SourcePair prefix="source" label="Physical assessment source" />
+        <section className="space-y-3 rounded border p-3">
+          <h3 className="font-semibold">Count unit declaration</h3>
+          <Choice
+            name="unitPresent"
+            label="Explicit unit kind"
+            options={['UNKNOWN', 'COUNT_UNIT']}
+            onChange={(value) => setUnitPresent(value === 'COUNT_UNIT')}
+          />
+          {unitPresent && <SourcePair key="count" prefix="unit" label="Count unit" />}
+        </section>
+        <section className="space-y-3 rounded border p-3">
+          <h3 className="font-semibold">Reported item and bin label mapping</h3>
+          <ReuseField
+            label="Reported item label (blank = unknown)"
+            name="itemLabel"
+            required={false}
+          />
+          <ReuseField
+            label="Reported bin label (blank = unknown)"
+            name="binLabel"
+            required={false}
+          />
+          <SourcePair prefix="mapping" label="Mapping source" />
+        </section>
+        <section className="space-y-3 rounded border p-3">
+          <h3 className="font-semibold">Reported lot facts</h3>
+          <Choice
+            name="lotPolicy"
+            label="Declared lot requirement"
+            options={['UNKNOWN', 'REQUIRED', 'NOT_REQUIRED']}
+          />
+          <Choice
+            name="lotPresent"
+            label="Lot identity observation"
+            options={['UNKNOWN', 'REPORTED']}
+            onChange={(value) => setLotPresent(value === 'REPORTED')}
+          />
+          {lotPresent && (
+            <div key="reported-lot" className="space-y-3">
+              <SourcePair prefix="lot" label="Lot" />
+              <Choice
+                name="lotDisposition"
+                label="Reported lot disposition"
+                options={['UNKNOWN', 'RELEASED', 'HELD', 'EXPIRED']}
+              />
+              <Choice
+                name="expiryPolicy"
+                label="Reported lot expiry policy"
+                options={['UNKNOWN', 'TIME_BOUNDED', 'NO_REQUIRED_EXPIRY']}
+              />
+              <ReuseField
+                label="Reported expiry cutoff (ISO with timezone; blank = unknown)"
+                name="expiresAt"
+                required={false}
+              />
+              <SourcePair prefix="expiry" label="Expiry source" />
+            </div>
+          )}
+        </section>
+        <section className="space-y-3 rounded border p-3">
+          <h3 className="font-semibold">Physical source validity declaration</h3>
+          <Choice
+            name="validityPolicy"
+            label="Declared validity policy"
+            options={['UNKNOWN', 'TIME_BOUNDED', 'NO_REQUIRED_EXPIRY']}
+          />
+          <ReuseField
+            label="Known validity start (ISO with timezone; blank = unknown)"
+            name="validityFrom"
+            required={false}
+          />
+          <ReuseField
+            label="Known validity end (ISO with timezone; blank = unknown)"
+            name="validityUntil"
+            required={false}
+          />
+          <SourcePair prefix="validity" label="Validity source" />
+        </section>
+        <ContainerEvidencePicker
+          value={evidence}
+          onChange={setEvidence}
+          description="Choose readable Files versions that support these facts. Documents do not certify labels or make stock ready to pick."
+        />
+        <Button type="submit">Record reported facts</Button>
+      </fieldset>
+      {error && <p role="alert">{error}</p>}
+    </form>
+  );
+}

package/src/movethewheels/components/stock-observation/StockIssueForm.tsx

@@ -0,0 +1,103 @@
+import { useState } from 'react';
+import { Button, Input } from '../ui';
+import { ReuseField, reuseSelect } from '../ReuseControls';
+import { stockObservationInput } from '../../utils/stockObservationForm';
+import type { RecordMtwStockObservationInput } from '../../../generated/stock-observation-operations';
+
+export function StockIssueForm({
+  inventoryItemId,
+  disabled,
+  onSubmit,
+}: {
+  inventoryItemId: string;
+  disabled: boolean;
+  onSubmit: (input: Omit<RecordMtwStockObservationInput, 'idempotencyKey'>) => Promise<void>;
+}) {
+  const [error, setError] = useState<string | null>(null);
+  return (
+    <form
+      className="space-y-4"
+      onSubmit={async (event) => {
+        event.preventDefault();
+        if (disabled) return;
+        setError(null);
+        try {
+          await onSubmit(stockObservationInput(inventoryItemId, new FormData(event.currentTarget)));
+        } catch (failure) {
+          setError(failure instanceof Error ? failure.message : 'Check the reported fields.');
+        }
+      }}
+    >
+      <fieldset disabled={disabled} className="space-y-4">
+        <div className="grid gap-3 md:grid-cols-2">
+          <label>
+            Issue
+            <select name="kind" className={reuseSelect} defaultValue="COUNT_DISCREPANCY">
+              <option value="COUNT_DISCREPANCY">Count discrepancy</option>
+              <option value="DAMAGE">Damage</option>
+              <option value="IDENTITY_UNCERTAIN">Uncertain item identity</option>
+              <option value="OTHER">Other issue</option>
+            </select>
+          </label>
+          <label>
+            Count scope
+            <select name="countScope" className={reuseSelect} defaultValue="UNKNOWN">
+              <option value="UNKNOWN">Not known</option>
+              <option value="WHOLE_LINE">Whole inventory line</option>
+            </select>
+          </label>
+          <ReuseField
+            name="observedCount"
+            label="Reported count (blank = not known)"
+            type="number"
+            required={false}
+          />
+          <label>
+            Reported observation time (your local time; optional)
+            <Input type="datetime-local" name="reportedObservedAt" />
+          </label>
+          <label>
+            Reported unit
+            <select name="countUnit" className={reuseSelect} defaultValue="UNKNOWN">
+              <option value="UNKNOWN">Not known</option>
+              <option value="COUNT_UNIT">Count unit</option>
+            </select>
+          </label>
+          <ReuseField
+            name="unitReference"
+            label="Count-unit reference (optional)"
+            required={false}
+          />
+          <ReuseField name="unitRevision" label="Count-unit revision (optional)" required={false} />
+          <ReuseField
+            name="sourceReference"
+            label="Reported source reference (optional)"
+            required={false}
+          />
+          <ReuseField
+            name="sourceRevision"
+            label="Reported source revision (optional)"
+            required={false}
+          />
+        </div>
+        <label className="block">
+          What did you observe?
+          <textarea name="reason" required maxLength={1000} rows={3} className={reuseSelect} />
+        </label>
+        <details>
+          <summary>Optional unverified file references</summary>
+          <p className="text-sm">
+            These references are recorded as supplied. Files are not opened or verified when
+            reporting an issue.
+          </p>
+          <div className="grid gap-3 md:grid-cols-2">
+            <ReuseField name="fileId" label="Exact file reference" required={false} />
+            <ReuseField name="versionId" label="Exact version reference" required={false} />
+          </div>
+        </details>
+        <Button type="submit">Record unresolved issue</Button>
+      </fieldset>
+      {error && <p role="alert">{error}</p>}
+    </form>
+  );
+}