# ENG-FLEXIFORGE-SHIRE-0001A — Engineering Handover

**Date:** 20 July 2026  
**Status:** Tested integration candidate; not yet installed on `armoros`  
**Target:** `/home/shire3d/ARMOR/tools/flexiforge`

## Objective

Integrate FlexiForge with SHiRE as the local articulation and fidget-conversion engine while preserving Ray's approval gates and SHiREVault network-storage policy.

## Implemented

- Automatic deterministic joint-location suggestions.
- Ranked hinge, flexi-hinge and snap ball-and-socket strategies.
- Persistent SHiRE job manifests and event history.
- Immutable design approval bound to the source STL hash and selected geometry.
- Forge blocked until design approval.
- STL-level output validation and SHA-256 records.
- Separate export approval bound to the validated package.
- SHiREVault mount and write verification before export.
- No silent local export fallback.
- Local-only service at `127.0.0.1:8876` to avoid the SHiRE Brain service on `127.0.0.1:8765`.
- CLI bridge and tool manifest for later SHiRE routing.

## Approval lifecycle

`REQUEST → SUGGESTIONS → RAY DESIGN APPROVAL → FORGE → VALIDATE → RAY EXPORT APPROVAL → VERIFIED NETWORK EXPORT`

## Storage

Final output:

`/SHiREVault/SHIRE3D/FlexiForge/Projects/<project>/<job-id>`

Mandatory pre-install backup:

`/SHiREVault/Backup/OSBackups`

`/SHiREVault` must resolve to the verified SHiREVault network mount. The installer and runtime stop rather than falling back to the ARMOR laptop's local disk.

## Blender boundary

This integration does not invoke Blender and does not change the locked BlenderMCP payload or existing Blender infrastructure.

## Validation performed

- Python syntax compilation: passed.
- Bash installer syntax: passed.
- Frontend production build: passed.
- Automated test suite: 5 passed.
- End-to-end CLI workflow: create, select, design approval, forge, validate, export approval and verified test export passed.
- Local health endpoint: passed.
- Export-before-second-approval negative test: correctly blocked.

## Current limitations

- One engineered joint per job.
- Assembly joints rather than guaranteed print-in-place geometry.
- Automatic suggestions use dominant-axis geometry analysis and still require Ray's visual review.
- Physical clearances require printer/material calibration and a real test print.

## Installation candidate

Run only from the extracted package on `armoros`:

`integration/install_into_armor_candidate.sh`

The installer verifies the host, clean Git state, network-backed SHiREVault path and writable backup destination. It creates and verifies a Git bundle before copying new files. It does not enable the service or create a Git commit.
