Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Proof of Artifacts

Visual and structural evidence that this project works, ships, and is real.

This is not a demo repo. This is production software. The artifacts below prove it.

Architecture

flowchart LR
    User[User] --> CF[Cloudflare Tunnel]
    CF --> AR[approuter :8080]
    AR --> CB[cochranblock :8081]
    AR --> OD[oakilydokily :3000]
    CB --> Redb[(redb)]
    CB --> Assets[Embedded Assets]

Build Output

MetricValue
Version1.0.1
Binary size (x86)13 MB (release, opt-level=3, lto=fat, strip)
Binary size (ARM)8.9 MB
Infrastructure cost$10/month
External servicesCloudflare tunnel (free tier)
DatabaseEmbedded redb — single-file ACID, no external DB
Cloud dependenciesZero
Public repos31 (Unlicense / public domain)
crates.io33 published crates (kova-engine, exopack, any-gpu, header-writer, +29)
CertificationSAM.gov Active · CAGE 1CQ66 · UEI W7X3HAQL9CF9 · SDVOSB Certified 2026-05-12 (SBA VetCert, expires 2029-05-12) · eMMA SUP1095449 · CSB approved · TS/SCI reactivation eligible · 30% service-connected disabled veteran
Handler functions86
Types18
Lines of code14,494
Direct dependencies38
Routes190 total (including aliases and redirects)
Release profileopt-level=3, lto=fat, codegen-units=1, panic=abort, strip=true
GPU nodeslf: RTX 3070 8GB · gd: RTX 3050 Ti 4GB
PerformanceTTFB 116ms · First paint 176ms · 72fps · CLS 0.0000 · 131 DOM elements
QA Round 1PASS — zero errors, zero warnings, zero debug prints, zero AI slop, all routes 200
QA Round 2PASS — clean build, clippy -D warnings, zero uncommitted changes
QA Round 3 (v1.0.0)PASS — 8 clippy warnings resolved, zero warnings, clean release build

Validation

MetricValue
Version1.0.1
Clippy warnings0
cargo auditPASS — 0 unignored advisories (see .cargo/audit.toml for ignored)
Release buildPASS — cargo build --release -p cochranblock --features approuter
GitHub releasesv0.1.0 through v1.0.0 (11 releases, all tagged)
Git commits283+
Provenance docsTIMELINE_OF_INVENTION.md + PROOF_OF_ARTIFACTS.md
Docs sitedocs/ — mdBook source, deployed via GitHub Pages
Planning docsplanning/ — internal UX research and business planning (formerly docs/)
TRIPLE SIMS gatecargo run -p cochranblock --bin cochranblock-test --features tests

Named Inventions & Techniques

NameTypeProjectDescription
Fish Tank StarfieldInventioncochranblockGPU-zero-cost starfield — static mask + background-position loop, 1/4 GPU memory
P13 Compression MappingInventionkovaAI context tokenization — 75% context budget reduction, 368 symbols compressed
Triple SimsInventionexopackTriple-deterministic test gate — pass identically 3x or fail
NanoSignInventionpixel-forge36-byte BLAKE3 model integrity — air-gapped, no infrastructure
Gemini Man PatternInventionrogue-repoZero-downtime binary self-replacement via SO_REUSEPORT
Sponge Mesh BroadcastInventionkova/tmuxisfreeRate-limit-aware retry mesh across 28 AI agent sessions
Self-Converging FlywheelInventionportfolio6-stage architecture reducing external AI dependency per cycle
MoE Cascade PipelineTechniquepixel-forgeCinder → Quench → Anvil staged AI model pipeline
Ghost Fabric Edge IntelligenceTechniquecochranblockEdge deployment cost model — Rust vs Python at scale
Negative Space StarfieldTechniquecochranblockStatic gradient mask with drifting light, compositor-only
Tokenized CLI CompressionTechniquekovax0-x9, g0-g9, c1-c9 compressed command interface
Two-Act Manifesto FoldTechniquecochranblockDoctrine (Act I) + amber-rule seam + Operations (Act II) folded on a single scroll. Sticky TOC rail kicks in at the seam. Single asset, multiple deep-link anchors (#doctrine, #manual).
Trust-Chip StripTechniquecochranblockFederal-credentials display restructured from inline <br>-separated text to flex-wrap atomic chips. Each credential (UEI, CAGE, EIN, SAM, SDVOSB, etc.) is its own self-contained pill that wraps cleanly without clipping at the viewport edge on mobile portrait.
HTML → PDF Render PipelineTechniquecochranblockchromium --headless --print-to-pdf against the live /resume HTML (with sed-rewritten absolute URLs) generates michael-cochran-resume_may_2026.pdf from the same source the browser sees. Single source of truth for site + downloaded artifact. Print stylesheet hides topbar / pdf-nudge / backrefs / cosmic backdrop.
Multi-Viewport Screenshot PipelineTechniquecochranblockscripts/screenshots.sh drives chromium-headless across phone-portrait (390×844), phone-landscape (844×390), tablet-portrait (768×1024), tablet-landscape (1024×768), and desktop (1280×800) for 5 pages. UI/UX simulation as a CI artifact.
AI Orchestration over Curated DataTechniquecochranblockCustom AI orchestration paired with researched and curated datasets — data is the moat, not the model. Multiple shipped instances. On-device inference for disconnected / cleared environments; no FedRAMP cloud auth required.
Hannah Montana ModePattern (rejected)cochranblockTwo-identity resume serving (ATS-clean default + anti-founder branded variant) explored under /resume + /resume/doctrine. Rejected after testing — single name-led resume with the doctrine demoted to footer reference is the better trade-off. The website itself does the doctrine work.
Native-Details HamburgerTechniquecochranblockCSS-only mobile nav using <details class="nav-mobile"> + styled <summary> as the burger icon. [open] state morphs 3 stacked bars into an X via :nth-child transforms; drawer is the details body, fixed-positioned over the cosmic backdrop. Drawer content grouped into 4 labeled accordion-style sections (On This Page / Procurement / Receipts / Site) so the user navigates in buyer-journey order. Zero JavaScript. Renders identically across desktop, tablet, phone, and accessibility tools because it’s native HTML semantics.
CDP-Driven Rendering VerificationTechniquecochranblockStandalone Rust binary (/tmp/burger-check/ + chromiumoxide 0.7) drives Chromium via the DevTools Protocol to evaluate JS against a loaded page, returning the actual computed DOM state (display, visibility, bbox, z-index, etc.) of any selector. Settles UI bugs that headless CLI screenshots can’t — e.g. when chromium --headless=new --screenshot failed to capture a position: fixed hamburger overlaid on a cosmic-backdrop layer at small viewports, the CDP introspection proved the element was rendering at the correct coordinates with full opacity. Source of truth = computed style + CDP screenshot, not CLI screenshot.

Screenshots

All prod-* captures below are from the live deployed site at https://cochranblock.org, taken via chromium-headless one at a time with 8s pacing to respect Cloudflare rate limits. Each was visually inspected after capture to confirm content + layout integrity per viewport. The pics-or-it-didn't-happen audit.

Legacy site (pre-2026-05-06)

ViewArtifact
Homepage (legacy commercial hero — replaced by LET’S TEAM 2026-05-06)Index
ProductsProducts
Deploy (Tech Intake)Deploy
AboutAbout
Book a CallBook

Live production captures — 2026-05-06

PageViewportArtifactVerified
Lets Team apex rootdesktop 1280×800Lets Team desktopHero “LET’S TEAM.” renders at full Orbitron 900; full nav with all 3 dropdowns (Gov / Tools / Site) + Resume link + Doctrine →; trust chips display all 10 credentials in 2 wrapping rows; speedometer 00032 with crates.io link
Lets Team apex roottablet portrait 768×1024Lets Team tablet portraitHero fits cleanly; pills wrap to 2 rows (3+3); trust chips wrap to 4 lines; CTAs (Email / Cap Stmt / Resume / Doctrine) all visible at fold
Lets Team apex roottablet landscape 1024×768Lets Team tablet landscapeCompressed tablet view, all critical elements above fold
Lets Team apex rootphone portrait 390×844Lets Team phone portraitMobile-portrait fix verified — banner clamp(1.7rem,10vw,3.4rem) fits “LET’S TEAM.” cleanly; trust strip flex-wrap chips render WITHOUT right-edge clipping (was the reported “weird box under JV/Mentor-Protégé” issue); 6 hero pills wrap 3+3
Lets Team apex rootphone landscape 844×390Lets Team phone landscapeWide-but-short viewport, nav-row + hero
Resume (MICHAEL COCHRAN)desktop 1280×800Resume desktopBanner reads MICHAEL COCHRAN (cyan/white split) at Orbitron 26pt 900; cap-statement-styled letter doc rendered as a centered page on dark; right-side contact block with phone/email/LinkedIn/cochranblock.org; cosmic backdrop (screen-only) glowing
Resumetablet portrait 768×1024Resume tablet portraitTightened 8.4pt typography + larger banner; full content visible; cosmic backdrop
Resumephone portrait 390×844Resume phone portraitSingle-column 10pt for screen readability; sticky topbar (Lets Team / Doctrine / Gov Docs / Capability Statement / GitHub / Email + Save PDF button); MICHAEL COCHRAN banner sized for phone; no horizontal overflow
Folded Manual (Act I Doctrine)desktop 1280×800Manual desktop“THE ANTI-FOUNDER” Orbitron banner at top of folded asset, “M·A·N·I·F·E·S·T·O” subtitle, “PUBLIC DOMAIN · ZERO CLOUD · RECEIPTS ATTACHED” pretag, doctrine creed in cyan-bordered block
Folded Manualtablet portrait 768×1024Manual tablet portraitBanner wraps to 2 lines; creed visible; “WHAT AN ANTI-FOUNDER IS” section heading at fold
Folded Manualphone portrait 390×844Manual phone portraitSame Act I content scaled for phone; banner THE ANTI-FOUNDER on 2 lines; doctrine creed visible
Govdocs (procurement)desktop 1280×800Govdocs desktopStandard C7 nav (Products / Services / About / Contact / ▾Gov / ▾Tools / ▾More); “Government Documents” h1; Capability Statement details; SDVOSB Certified 2026-05-12 (SBA VetCert, expires 2029-05-12); 33 crates · 31 repos; cosmic backdrop
Servicesdesktop 1280×800Services desktopStandard nav; “Services & Pricing”; “What I Replace” comparison block; cosmic backdrop with the orange-tinted services-page ambient gradient (per body[data-page="services"]::after); 3-card pricing row at bottom
Mobile hamburger — closediPhone 390×844 (CDP)Burger closedCaptured via chromiumoxide DevTools Protocol with iOS Safari UA + mobile=true emulation. 40×40 cyan-bordered ☰ button at top-right (x=335.6, y=11.2). Three horizontal bars visible inside. Brand “COCHRAN BLOCK” left-aligned. CDP-verified computed style: display:block · position:fixed · z-index:100 · visibility:visible · opacity:1.
Mobile hamburger — openiPhone 390×844 (CDP)Burger openSame viewport after programmatic click on summary. Bars morph into ✕ (cyan X). Drawer expands below with 4-group accordion: ON THIS PAGE (Engage / Architecture / Verticals / Registrations) · PROCUREMENT (Gov Docs / SBIR / VR&E / DCAA / Capability Statement / Resume) · RECEIPTS (Open Books / Source / Stats / Binaries) · SITE. 25 menu items total. Cyan group headings in Orbitron, item links monospace. Backdrop blur preserves cosmic-layer through the drawer.

Site-wide nav unification — 2026-05-15

Single canonical .cb-nav (root-derived: COCHRAN BLOCK diamond + search + Engage/Architecture/Verticals/Registrations + Gov/Tools/Site dropdowns + Resume + Doctrine →) is now served on every route. Captured via exopack screenshot from the local bt:8081 build immediately after the change — three different rendering paths, one nav.

Rendering pathRouteArtifactVerified
lets-team.html (apex root, monolithic doc)/Unified nav — rootInline .cb-nav markup + <style> replaces former .nav/Rajdhani block; font now JetBrains Mono matching the rest of the site
head + C7 + body + C8 template (C7-served pages, e.g. /govdocs, /about, /sbir, /services)/govdocsUnified nav — govdocsC7 const rewritten to skip-link + .cb-nav block + <main> opener; old .nav selectors in main.css become dead code
C7-served — SBIR/sbirUnified nav — sbirSame nav as /govdocs and root; user-confirmed reference for visual parity
Standalone artifact + f105 injector/manifestoUnified nav — manifestof105(&str) splices C9 (self-contained nav + scoped CSS + cosmic starfield) after <body…> in each artifact-page handler; idempotent via cb-nav/class="nav" check
Standalone artifact + f105 injector/constitutionUnified nav — constitutionArtifact-page text colors (amber) preserved; backdrop layer adds cyan/purple/amber ambient gradients
Manual artifact + f64 wrapper/manualUnified nav — manualf64 = f105 + brand-href→apex absolute; brand <a> rewritten to https://cochranblock.org/ so manual.cochranblock.org/* doesn’t loop back on itself

Code shape (tokenized per Kova standards, in src/web/pages.rs):

  • C9 — site nav shim: <style> (cosmic backdrop cbDrift + 2 shooting stars cbShoot/cbShoot2 w/ prefers-reduced-motion opt-out + .cb-nav* scoped CSS, hardcoded colors) + <nav class="cb-nav">…</nav>. ~5 KB inline.
  • C7concat! of skip-link + same nav block as C9 + <main id="main" class="content"> opener.
  • f105(&str) -> String — 4 lines: idempotency check, find <body…>, splice. No allocations on the skip path.
  • f64(&str) -> String — wraps f105, then one .replace rewriting the brand <a href="/"> to absolute apex.

Quick Start

# Build & run
cargo build --release -p cochranblock --features approuter
./target/release/cochranblock          # localhost:8081

# Test (runs unit + integration + HTTP tests 3x — TRIPLE SIMS gate — with
# screenshot capture via exopack)
cargo run -p cochranblock --bin cochranblock-test --features tests

How to Verify

# Clone, build, run. That's it.
cargo build --release -p cochranblock --features approuter
ls -lh target/release/cochranblock   # ~16MB (the binary now embeds 2 PDFs + folded manual + lets-team + capability statement HTML/PDF)
./target/release/cochranblock         # localhost:8081

Multi-Viewport UI/UX Simulation

# Build, restart, capture 25 screenshots across phone / tablet / desktop
cargo build --release -p cochranblock --features approuter
./target/release/cochranblock &
bash scripts/screenshots.sh http://192.168.1.52:8081
ls -1 screenshots/prod-*.png

HTML → PDF Resume Render

# Generate the downloadable resume PDF directly from the served /resume HTML
bash scripts/build-resume-pdf.sh
ls -lh assets/michael-cochran-resume_may_2026.pdf  # ~290 KB, 2 pages, letter format
cargo build --release -p cochranblock --features approuter  # re-embed into binary

Routes

RouteWhat
/Home — hero, pitch, live stats, CTAs
/productsProduct catalog — platforms, partnerships, open source
/servicesPricing and service offerings
/deployTech intake form (redb-backed)
/deploy/confirmedSubmission confirmation
/bookDiscovery call booking calendar
/aboutMission, credentials, testimonials
/contactEmail CTA
/community-grantCommunity grant application form
/community-grant/confirmedGrant submission confirmation
/downloadsResume PDF, logo card
/codeskillzLive velocity tracking for repos
/statsPerformance, cloud cost math, live traffic
/govdocsCapability statement, SBIR proposals, bid tracker
/sbirSBIR/provenance documentation
/provenanceAI development documentation framework
/vreVR&E Chapter 31 self-employment track
/tinybinariesBinary size comparison across repos
/sourceLive source code of the running server
/searchSite search
/speedRedirects to /stats
/openbooksOpen books financial transparency
/dcaaDCAA-ready accounting (alias for /openbooks)
/analyticsSite analytics dashboard
/privacyPrivacy policy
/healthHealth check endpoint
/robots.txtCrawler directives
/sitemap.xmlSearch engine sitemap
/llms.txtAI crawler context
/llms-full.txtExtended AI crawler context
/humans.txtTeam, tools, tech stack
/.well-known/security.txtRFC 9116 security contact
/api/statsRepo count stats
/api/velocityGitHub velocity data
/api/analyticsAnalytics data
/api/site-statsSite statistics
/api/openbooksOpen books data
/api/summarySite summary

Code Style

Source uses compact identifiers (f2, t0, C7, etc.) per the Token-Optimized Code Representation system. See the kova compression map for the canonical mapping.

Dependencies on Other Repos

Products marked “Coming Soon” on the site depend on other repos:

ProductWaiting On
Rogue Reporogue-repo, approuter
Ronin Sitesrogue-repo, approuter
Pocket Serverapprouter, kova
Ghost Fabrickova

Commit Log

Selected milestone commits. Run git log --oneline for the full 283-commit history.

HashDescription
9495ef7b89v1.0.0 version bump
a9ced55d24fix: resolve all clippy warnings (8 warnings)
811831a5d5v0.11.0: redb+SDVOSB sweep, bt deploy pipeline, SBA RFIs, brand assets
67b0930323fix: nav-mobile-menu hidden when <details> not [open]
a517534c3fv0.10.0: site-wide nav consistency + CHANGELOG
baa6757b1eSDVOSB certified — sweep site, capability statement, federal docs
aa4e18b72edeploy: fix cargo-audit gate (exit code, not regex)
8f7446e781db: consolidate sled+sqlx → redb (single-file ACID, no rsa chain)
3efef68f66deps: clear all Dependabot advisories
9e7a7e7465site: LET’S TEAM apex root + folded manifesto + resume + hamburger
7947e6bda3Unlicense + public domain sweep
391f5951fffeat: openbooks — local git, no GitHub API
61e783aa98add whyme.cochranblock.org subdomain
fc5388b01fsite: live receipts — 31 repos, 22 crates, hero counter

Part of the CochranBlock zero-cloud architecture. All source under the Unlicense.


THE COCHRAN BLOCK, LLC · CAGE 1CQ66 · UEI W7X3HAQL9CF9 · UNLICENSE · cochranblock.org


THE COCHRAN BLOCK, LLC · CAGE 1CQ66 · UEI W7X3HAQL9CF9 · UNLICENSE · cochranblock.org