in reviewhumanPR #341Transport

FactoryBridge: test real planner fulfillment through HTTP mailbox

FactoryBridge coordinates a simulated hardware order across print, PCB, purchased parts, inspection, assembly and shipping. This PR adds a bounded integration example, adapter, instructions and recorded test artifacts for Nanda Town.

Author

Status
In review
Opened on
Nov 11
Branch
integration/factorybridge-mailbox

Description

The pitch.

## Summary

FactoryBridge coordinates a simulated hardware order across print, PCB, purchased parts, inspection, assembly and shipping. This PR adds a bounded integration example, adapter, instructions and recorded test artifacts for Nanda Town.

## Integration

A requester sends an order through Town's SQLite-backed mailbox. A separate worker imports FactoryBridge from its [repository](https://github.com/nllm/ai_studio), executes the planner, marketplace, simulated suppliers and checker, and returns the result through the mailbox. The FactoryBridge repository is private; reviewers need authorized access. No project implementation is copied into Town.

## Reproduce

Nanda Town base: `6f9a7c064486c4a0ae9242f1ff341b8a4aad0244`  
FactoryBridge: `55fd8d81d52cf554745b91e250e5fa74842fd49e`

With authorized access to that FactoryBridge checkout and this PR checked out:

```bash
python -m venv .venv
. .venv/bin/activate
python -m pip install -e .
python examples/factorybridge/run_check.py --factory-root /absolute/path/to/ai_studio --out /tmp/factorybridge-town-evidence
```

See the example README for dependencies, provenance, outputs and limitations.

## Results and limitations

Expected and observed: a simulated print supplier delay triggers a shipping replan and the order arrives on day 8 within the $100 simulated budget; observed cost $42.50 and 25 marketplace calls. A zero-quantity request is rejected before simulation. The included evidence contains the simulator trace and Town mailbox events.

The planner's reviewer is scripted, not an LLM. Supplier, price, inspection and delivery data are synthetic. This invokes TownDB directly, not its HTTP coordinator; the requester and mailbox bridge share a process and use an example-specific evaluator rather than Town's standard bundle evaluator. Network transport, real CAD/slicing, real suppliers, physical manufacturing, crash recovery, duplicate delivery, concurrency and live-model behavior remain untested. The full Town test suite was not run in this environment.

## Course context

MIT AI Studio Fall 2026, HW8.

Try it

Open PR on GitHubView diff

Checkout locally

git fetch origin pull/341/head:pr-341
git checkout pr-341