# Original Base44 Export Audit

Source received: `shire-scan-forge.zip`

## What the export already contained

- React 18 and Vite frontend.
- Standalone ScanForge layout and navigation.
- SHiRE module route concept at `/agents/scanforge`.
- `ScanForgeAgentWorkspace`, compact module header and reusable Agents card.
- Logical SHiRE agent client and local Scan Bridge client.
- Base44 entities for scan projects, capture sessions, mesh versions, calibration, measurements, exports and audit events.
- Safety wording for Kinect limitations and non-load-bearing prosthetic-cover reference work.
- SHiREVault verification and controlled Forge handoff helper functions.

## Critical integration faults found

1. The default SHiRE API path could resolve as `/api/api/v1/...`.
2. The Base44 authentication provider was mounted even in `SHIRE_MODULE` mode, causing unwanted Base44 requests.
3. Project creation, project listing and the Agents card still depended directly on Base44 entities in module mode.
4. The live capture controls mostly changed browser state rather than calling the ScanForge Agent or Scan Bridge.
5. The local bridge WebSocket did not carry an authentication credential.
6. The configured ScanForge route was not consistently used.
7. The export did not include separate SHiRE-module and standalone build commands.
8. It included interface shells for processing, Mesh Lab, measurements, calibration, print checks and exports, but no actual Kinect driver, mesh reconstruction service or SHiRE backend implementation.

## Corrections in this package

- Normalised API and WebSocket URL joining.
- Prevented Base44 authentication startup in SHiRE module mode.
- Added a project repository abstraction that uses the SHiRE Agent in module mode and Base44 only in standalone mode.
- Added parent-injected SHiRE module context support and same-origin session fallback.
- Added live ScanForge Agent status polling.
- Routed real capture controls through structured agent actions.
- Kept demo mode manual and visibly labelled.
- Added an agent manifest and JSON contracts.
- Added separate `build:shire` and `build:standalone` targets.

## Not yet implemented

This source package does not contain:

- `libfreenect` Kinect v1 capture daemon.
- Open3D point-cloud registration or mesh reconstruction.
- The ARMOR/SHiRE backend endpoints described by the contracts.
- A production WebSocket preview encoder/stream.
- SHiRE global Agents registry changes inside `/home/shire3d/ARMOR`.
- Real Mesh Lab editing operations.
- Real print analysis, calibration or export execution.

Those components must be implemented and tested on SHiRE Mini before the scanner can produce real 3D-print files.
