What shipped
Built a local Python CLI package named freight_ai_pilot_control_tower with three commands:
sample-pack --path <workspace>creates a synthetic Freight Exception Triage Studio-compatibletriage/triage-pack.json.generate-control-tower --path <workspace>converts that triage pack into pilot-control Markdown, CSV, and JSON artifacts.validate-control-tower --path <workspace>validates source contract, generated artifacts, KPI completeness, approval gates, synthetic-data boundaries, and unsafe automation markers.
The generated pilot-control/ pack includes opportunity mapping, workflow discovery, prioritization, KPI tree, evaluation scenarios, approval register, 30-60-90 rollout, PM narrative, and consolidated JSON export.
Architecture
- Standard-library Python only:
argparse,dataclasses,json,csv,pathlib, and collections utilities. - Deterministic generation: same source pack produces the same artifact pack.
- Contract-first input: the new build reads the parent
triage/triage-pack.jsonshape instead of copying the prior triage app. - Human-in-the-loop by default: sensitive freight actions remain approval-gated in source validation, generated artifacts, and verifier assertions.
- Self-contained verification:
verify.shbuilds a demo workspace under/tmpwithout relying on the absolute parent build path.
Trimmed scope
- No web UI.
- No database.
- No hosted deployment.
- No real TMS, tracking, EDI, inbox, carrier, claims, payment, or workflow integrations.
- No external AI/model/provider calls.
- No autonomous execution of freight operations decisions.
Limitations
- Ranking formulas are deterministic heuristics intended for pilot planning, not production optimization.
- Source data is synthetic and compact; real use would require a sanitized export that matches the documented contract.
- Validation checks structural safety and obvious unsafe claims, but it is not a legal, compliance, or freight safety review.
- KPI baselines are demo assumptions derived from queue size and source fields.
Suggested next steps
- Add a contract adapter for sanitized parent build exports if the parent pack evolves.
- Add golden-file tests for artifact rendering when the source pack changes.
- Add configurable owner/category mappings for a real discovery sprint.
- Add a redacted-import checklist for sanitized TMS or tracking exports.
- Add a human review worksheet that records weekly KPI readouts and approval-gate exceptions.