TypeScript control plane for shipment-exception intake, carrier-rule pressure, resolution routing, and SLA-safe escalation across logistics workflows.
- Shipment teams lose time when carrier exceptions, SLA clocks, and customer-facing evidence live in separate tools.
- Exceptions often become refunds or churn because the handoff between operations, support, and carrier management breaks down.
- Logistics leaders need to know which shipment is blocked, who owns the next move, and whether the SLA is still recoverable.
- Supply-chain buyers care whether exception handling is auditable and execution-safe, not whether the dashboard uses trendy automation language.
This repo demonstrates the exception-routing primitive for Supply Chain / Logistics buyers: shipment exceptions tied to carrier rules, SLA pressure, customer-impact blockers, and operator-safe escalation paths. A B2B SaaS buyer would care because fulfillment and exception data often need to surface inside customer-facing tools without exposing unsafe write paths or fragmented operational evidence. Kinetic Gain Embedded extends this into security-first in-product analytics for logistics-aware and SLA-aware reporting across fulfillment and operations workflows, see kineticgain.com/embedded.
//exception-lane/carrier-rules/resolution-posture/verification/docs
/api/dashboard/summary/api/exception-lane/api/carrier-rules/api/resolution-posture/api/verification/api/sample
cd shipment-exception-command-center
npm install
npm run devOpen:
- http://127.0.0.1:5462/
- http://127.0.0.1:5462/exception-lane
- http://127.0.0.1:5462/carrier-rules
- http://127.0.0.1:5462/resolution-posture
- http://127.0.0.1:5462/verification
npm run buildnpm run testnpm run demonpm run smokenpm run render:assets
| Aspect | Status |
|---|---|
| CI | Node 20 + 22 matrix — lint · typecheck · coverage · build · demo · smoke · npm audit (workflow) |
| Test coverage | 100% statements on src/services/ (gate: ≥ 60%) |
| License | AGPL-3.0-or-later |
| Dependencies | Dependabot weekly (npm + GitHub Actions); npm audit --audit-level=high in CI |
| Security | SECURITY.md — 0 known high/critical advisories at v1.0-prod |
| Deploy | Static prerender → https://shipments.kineticgain.com/ (GitHub Pages, pages workflow) |
Operator surface in the Kinetic Gain Suite — a portfolio of buyer-readable control planes spanning security posture, compliance evidence, data-platform governance, FinOps, and operator workflows. See the suite index for related surfaces. Apex: kineticgain.com.