~/About~/Systems~/Foundry~/Blueprint~/Journal~/Projects
Book a Call

The Journal

Essays on architectural decisions, engineering trade-offs, and the thinking behind the systems.

Showing 41 entries

Technical essays compared by failure mode, constraints, code evidence, and system context.

+124 more tags inside entries

From the Edge Fleet Rollout Safety Control Plane system

Two PostgreSQL timestamps described the same instant but hashed to different bytes. A fresh evidence row failed its own verification.

postgresqlhash-chainscanonicalization
Code SampleFailureConstraintSurprise

Sep 1, 2026

8 min read

Open entry

From the Swarm Intelligence Gateway system

A swarm run can finish while its memory remains trapped upstream. I moved retrieval into PostgreSQL scoped by tenant without copying Zep.

PostgreSQLpgvectoragent-memory
Code SampleFailureConstraintSurprise

Aug 29, 2026

9 min read

Open entry

From the Swarm Intelligence Gateway system

A simulation ID looked ready to run, yet MiroFish still rejected it. Eight live attempts exposed the lifecycle hidden behind one client.

TypeScriptAPI-integrationorchestration
Code SampleFailureConstraintSurprise

Aug 29, 2026

9 min read

Open entry

From the Swarm Intelligence Gateway system

A worker with one slot sounds underused until a simulation dies with exit code -9. BullMQ became the boundary for memory pressure, not a speed trick.

BullMQRedisbackpressure
Code SampleConstraintSurpriseScaling Limit

Aug 29, 2026

9 min read

Open entry

From the Swarm Intelligence Gateway system

Tenant filters kept predictions private, yet the UI showed the wrong theater when feeds arrived out of order. Security did not buy coherence.

multi-tenancyFastifyRedis
Code SampleFailureConstraintScaling Limit

Aug 29, 2026

8 min read

Open entry

From the Swarm Intelligence Gateway system

WorldMonitor changed one Redis value from full JSON to an R2 pointer. Without a transport boundary, valid input looked corrupt and retried forever.

RedisR2data-ingestion
Code SampleFailureConstraintSurprise

Aug 29, 2026

8 min read

Open entry

From the Cloud Commitment Portfolio Optimizer system

A frontier full of positive downside values reported zero. The bug was a harmless-looking default inside a minimum reducer for risk.

financial-softwaretypescriptrisk-modeling
Code SampleFailureConstraintSurprise

Aug 27, 2026

8 min read

Open entry

From the Freight Capacity Auction Clearing Engine system

Exit code 0 can still leave a freight award without valid solver evidence. One terminal record decides whether the job may persist an award.

ocamlminizincprocess-isolation
Code SampleFailureConstraintSurprise

Aug 27, 2026

8 min read

Open entry

From the Inventory Allocation Simulator system

A planner approved a transfer after the warehouse data changed. The only honest answer was to freeze the run inputs before solving.

juliaoptimizationsimulation
Code SampleFailureConstraintSurprise

May 28, 2026

5 min read

Open entry

From the Compliance Document Substrate system

The docs CLI proved that a document type can be reachable while still bypassing the service that owns its legal behavior.

api-designclidispatch
Code SampleFailureConstraint

May 11, 2026

3 min read

Open entry

From the Compliance Document Substrate system

Entity snapshots turned legal identity from template text into durable document state, including the dormant Nigerian Ltd constraint.

entity-scopecompliancesnapshots
Code SampleFailureConstraint

May 11, 2026

3 min read

Open entry

From the Compliance Document Substrate system

The invoice send path refuses to invent a valid-looking document when XML, PDF/A, or signing checks fail.

factur-xxrechnungpdf-a
Code SampleFailure

May 11, 2026

3 min read

Open entry

From the Compliance Document Substrate system

Each finalized document enters a per-entity chain so later verification can prove order, content, and tamper evidence.

hash-chainauditpostgres
Code Sample

May 11, 2026

2 min read

Open entry

From the Compliance Document Substrate system

Document numbers are reserved before finalization, reclaimed after failure, and isolated by entity, type, and year.

numberingpostgresconcurrency
Code SampleFailure

May 11, 2026

2 min read

Open entry

From the Dispute Resolution Workbench system

A 0.70 correlation score can still attach the wrong exception to the wrong case. I made confidence create a decision, not mutate the dispute.

clojurecorrelationfinance-operations
Code SampleFailureConstraintSurprise

May 6, 2026

8 min read

Open entry

From the SLA Penalty Settlement Engine system

A penalty row without its mirror is worse than a missing accrual. The ledger had to reject half-truths before SQL ever saw them.

fsharpledger-designdomain-modeling
Code SampleFailureConstraintSurprise

May 5, 2026

8 min read

Open entry

From the Event-Driven Notification Hub system

Per-tenant rate limit silently capped every tenant at the default 200/minute. The rate check ran before auth populated the tenant on the request.

fastifyrate-limitingmulti-tenant
Code SampleFailureConstraintSurprise

Apr 26, 2026

8 min read

Open entry

From the Contract Lifecycle Engine system

False-positive AI obligations create phantom compliance records worse than missed real ones. Every extraction lands in Pending until a human confirms it.

state-machineevent-sourcingai-extraction
Code SampleFailureConstraint

Apr 18, 2026

8 min read

Open entry

From the Invoice Reconciliation Engine system

Vendors copy-paste PO numbers differently, omit sales orders, or pad format noise. A single exact match catches 60%. A five-strategy cascade catches 98%.

kotlinmatching-algorithmsfuzzy-matching
Code SampleFailureConstraintSurprise

Apr 16, 2026

10 min read

Open entry

From the Sensor Telemetry Engine system

A downstream HTTP timeout inside synchronous anomaly evaluation stalled the NATS consumer. 3,000 messages piled up before fire-and-forget tasks fixed it.

rustanomaly-detectionasync
Code SampleFailureConstraintScaling Limit

Apr 15, 2026

8 min read

Open entry

DAGs don't branch natively. Encoding branches in graph structure produced path explosion. Mutable skip sets at runtime kept the topological sort flat.

dag-orchestrationstate-machinesconditional-branching
Code SampleFailureConstraintSurprise

Apr 13, 2026

8 min read

Open entry

From the Transaction Reconciliation Engine system

Bank settlement dates differ from charge dates on 23% of transactions, and 4% by two days. Exact-match reconciliation flags all of them as discrepancies.

Goreconciliationscoring-algorithms
Code SampleFailureConstraintScaling Limit

Mar 21, 2026

5 min read

Open entry

From the Solar Pricing Engine system

Fuzzy matching on the last 15% of solar SKUs paired STP8.0 with STP10.0. Running the pipeline twice beat every fuzzy threshold I tuned.

sku-matchingdata-processingpython
Code SampleFailureConstraintSurprise

Mar 3, 2026

7 min read

Open entry

Get Notified

New system breakdown? You'll know first.