🪐 CMD — v1 Status & Pipeline¶
Updated 6 May 2026, 07:00 NZST. CMD v2e (errno mode) is LIVE in production.
🟢 What's LIVE today¶
The planet itself¶
https://cmd.aguidetocloud.com/— CMD's homepage and command launcher- 55 jargon entries + 10 error codes (catalogue + decoder, see below)
- Per-entry pages at
/<slug>/(e.g./mde/,/azure-ai-foundry/,/m365-business-premium/) /all/— full browseable catalogue grouped by kind/wishlist/— public top-20 missed-term aggregate (privacy-safe, awaits D1 binding)/about/— story, cosmos map, what CMD isn't/changelog/— public release log/cmd-index.json— public JSON data feed (CORS allow-* enabled)/decode/decode-index.json— errno search index (CORS allow-* enabled)- 36 OG image cards at
/og/<slug>.png(1200×630 phosphor-on-ink — every share is a beautiful card) - OpenSearch description at
/opensearch.xml— browser address-barbb mde<Enter>shortcut
The decoder (v2e — May 2026)¶
https://cmd.aguidetocloud.com/decode/— errno-mode landing with curated error codes- 10 seed entries at
/decode/<slug>/: 5 AADSTS · 3 HRESULT · 1 INTUNE · 1 KB - Per-entry shape: code · plain English · most likely causes · numbered fix path · seen in · related (auto-routed: errno↔jargon) · learn link · freshness dot
- TechArticle JSON-LD on every entry (rich snippet eligibility for "what does X mean" queries)
- Red severity glyph on result cards (chrome stays CMD green — "differentiate by feature, not chrome")
- No spicy editorial voice on decode entries — error codes earn their keep by being right, not opinionated
The home launcher (jargon AND errno modes)¶
[ $ jargon ] [ ! errno ]chips above the prompt — both modes visible at first glance- Click swaps in place: placeholder · index · result-row tint · boot block samples (URL stays
/) - Default = jargon; preference NOT persisted (each visit starts in jargon)
- 9-tier deterministic search in jargon mode (slug → abbreviation → alias → old-name → synonym → prefix → substring → multi-token AND → Levenshtein-2)
- Simpler 4-tier dispatch in errno mode (exact code/slug → prefix → substring on code → substring on description) — no fuzzy, codes are pasted not typed
- Smart-suggest layer: in jargon mode, strict regex match (
^0x[0-9a-fA-F]{8}$ | ^AADSTS\d+$ | ^KB\d+$) AND zero jargon hits → prepend ONE[errno]row routing to the curated decode entry - Auto-redirect on
/?q=AADSTS50105straight to/decode/aadsts50105/via the existing tier ≤2 initial-query handler - Auto-focused input on page load
- Keyboard-first nav:
/to focus,↑↓to navigate,Enterto open,Escto clear - Drag-to-bookmarks bookmarklet (highlight any acronym anywhere → click bookmark → palette opens with term)
- No fuzzy auto-open — only tier 1-4 exact matches navigate without confirmation
The cross-cosmos portal¶
The $_ palette button + Cmd+K command palette is now in the navbar of:
- 🌍 Earth — https://www.aguidetocloud.com/ (next to the logo, replacing the live-user counter)
- 🌑 Moon — every Astro Guided page including practice exam pages
- 🪐 CMD's own homepage — its native launcher
Triggers everywhere: click the $_ button, press / from anywhere, or press Cmd+K / Ctrl+K.
Closes via Esc, click outside, or selecting a result.
The redirects + safety nets¶
- 92 HTTP 301 alias redirects (
/mdatp→/mde/,/foundry→/azure-ai-foundry/, etc.) - Wildcard middleware (Pages Function
_middleware.mjs) handles<term>.cmd.aguidetocloud.com→ 302 to canonical (13/13 offline tests pass; awaits the wildcard custom domain dashboard step to activate) - Build-time validator with 10 rules — gates every deploy
- Practice Exam SLA firewall — paid content cannot be reached from the CMD code path; cosmos law #6 enforced
- CMD lives on a separate Cloudflare Pages project (
aguidetocloud-brainbar) so its blast radius is structurally isolated from the practice exam product
The cosmos contract¶
- CORS on
cmd-index.jsonanddecode-index.jsonso Earth and any future planet can fetch them - Theme cookie scoped to
.aguidetocloud.com— dark/light persists between Earth and CMD - Brand back-link in the footer
- Self-hosted JetBrains Mono (no Google Fonts CDN, no third-party privacy ping)
- Cosmos rail in the header — sibling planets (Earth · Shift · Plain AI) reachable in one click
The integrations across surfaces¶
- Earth
/free-tools/— CMD registered as the 57th tool (under "Quick Utilities", opens in new tab) - Earth
/about/— links to CMD - Cosmos philosophy publicly documented at
learn.aguidetocloud.com/reference/cosmos-philosophy/ - CMD lessons learned at
learn.aguidetocloud.com/reference/brain-bar-lessons/ - Cosmos nav playbook at
learn.aguidetocloud.com/reference/cosmos-nav-playbook/
⏳ Pending Sush-only steps (each is a 30-second dashboard click)¶
| Step | What it activates |
|---|---|
Cloudflare Pages → aguidetocloud-brainbar → Custom domains → add *.cmd.aguidetocloud.com |
The wildcard subdomain pattern (mde.cmd.aguidetocloud.com → cmd.aguidetocloud.com/mde/). Pages API rejects literal * so this must come from the dashboard. |
cd brainbar-mcp && wrangler login && wrangler deploy then add custom domain mcp.aguidetocloud.com |
CMD inside Claude Desktop / Cursor / ChatGPT via MCP protocol. 15/15 offline tests already pass. |
D1 binding (still pending after round 7): cd brainbar && wrangler d1 create brainbar-misses then wrangler d1 execute brainbar-misses --command "CREATE TABLE IF NOT EXISTS missed (term TEXT NOT NULL, day TEXT NOT NULL, count INTEGER NOT NULL DEFAULT 1, first_seen TEXT NOT NULL, last_seen TEXT NOT NULL, PRIMARY KEY(term, day));" then in Cloudflare Pages dashboard: aguidetocloud-brainbar → Settings → Functions → D1 database bindings → add binding name MISSES → database brainbar-misses |
Activates the privacy-safe missed-term tracking. /wishlist/ stays empty until this is done. Once bound, /api/log-miss records misses and /api/popular-misses serves the top-N feed. Endpoint code verified clean in round 7. |
Replace {{/* TODO sush */}} in brainbar/layouts/_default/about.html |
Adds your personal voice paragraph to /about/. The page is great without it; it'll be even better with it. |
🛠️ v2 Pipeline (in priority order)¶
Already shipped (counted as v2 because they ride alongside v1 launch)¶
- v2a OG images 🟢 — every entry has its own social card; wired in baseof.html
- v2.1 Wildcard middleware 🟢 — code + tests; activates when wildcard custom domain is added
- v2.2 Browser address-bar search engine 🟢 — OpenSearch + setup instructions on the homepage
- v2.3 Missed-term tracking 🟢 (code) — D1 binding pending
- v2.4 Disambiguation pages 🟢 — P1, P2, E5, Defender, Copilot
- v2.5 Scale entries 5 → 55 🟢 — continuous; next milestone 100
- v2.6 MCP server 🟢 (code + 15/15 tests) —
wrangler deploypending - v2.7 Astro Guided palette 🟢 — lighter version: cross-origin fetch instead of vendored JSON
- v2.8 Self-host JetBrains Mono 🟢
- v2b Synonyms + did-you-mean 🟢 (5 May r6) — search quality jump; 116 synonym terms across 27 entries; Levenshtein-2 typo tolerance (only fires when tiers 1-8 return 0 hits)
- v2c
/watch/aggregate + JSON-LD on entries 🟢 (5 May r7) — Schema.orgDefinedTerm+WebPageon every entry; rebrand/retirement watch list - v2c.2
/changelog/public release log 🟢 (5 May r7) - v2d Custom favicon 🟢 (5 May r7) — phosphor-green block cursor on terminal black; 649 bytes self-contained SVG
- v2d.2 Theme toggle ☀ / ☾ icons 🟢 (5 May r7)
- v2d.3 5 new spicy voice takes 🟢 (5 May r7) — bitlocker, secure-score, kql, exchange-online, windows-365
- v2e Errno mode (the decoder) 🟢 (5 May r8 + 6 May fix) —
/decode/subsection · 10 curated codes · home mode chips · smart-suggest · result-row severity tinting. See "What's LIVE — The decoder" above for full surface inventory.
Pending — quick wins¶
- v2f MCP
brainbar_decode_errortool (~30min) — separate Worker repo; mirrors existingbrainbar_lookuppattern. Adds errno decode capability inside Claude / Cursor / ChatGPT. - v2f.2 D1 miss-logging for decode (~15min) — extend
/api/log-missto acceptmode=decodeso errno misses are tracked separately from jargon misses. - v2f.3 OG generation for decode entries (~15min) — run existing
og-generatorscript with the new schema. Currently 10 decode pages share CMD's default OG. - v2f.4 Decode seed expansion (~30min per batch) — next 10-20 codes: Graph API (401 insufficient_scope, 403 authorization_RequestDenied), Outlook 0x800CCC0E, more KBs, Defender alert IDs.
Pending — bigger swings¶
- v3 Universal palette (~4-5h) — extend the Cmd+K palette on Earth to also search Earth's tools/blog/certs (with paid-content firewall enforced). Recommendation: wait ~2 weeks of v1 in production before building, to learn what users actually search for.
- v3.5 Browser extension (~6-8h) — highlight any acronym anywhere → tooltip with CMD definition. Distribution play via Chrome Web Store.
Pending — content scale¶
- More entries: 35 → 100. Sush curates priorities (top of next pass: MDA confusion, Defender for Servers tiers, CAE, Risk-based CA, Win11 LTSC, Frontline shared device, Microsoft Loop, Power BI Pro vs Premium).
Pending — MCP server v0.2¶
brainbar_compare(a, b)— side-by-side comparison tool (killer demo)brainbar_recent_changes(days)— entries updated recentlybrainbar_by_domain(domain)— filter to security/identity/AI/etc.
🚫 What I'd defer or NOT build¶
| Skip / defer | Why |
|---|---|
| Mascot illustrations replacing emojis | Cute but no real user value. Emojis already work. |
| A/B testing of voice | CMD's voice is Sush's voice. Don't optimize via testing. |
| Domain-specific theme colours (security in red, AI in cyan) | Distracts from unified terminal aesthetic. |
| User accounts / favorites | Adds complexity, requires auth, contradicts "no signup" ethos. localStorage history covers it. |
| Public popularity rankings | Streisand effect on certain terms. Keep low-volume terms hidden. |
📊 Hard numbers¶
| Metric | v1 launch (4 May) | r7 polish (5 May) | r8 errno (5-6 May) |
|---|---|---|---|
| Live jargon entries | 35 | 55 | 55 |
Live error codes (/decode/) |
n/a | n/a | 10 (5 AADSTS · 3 HRESULT · 1 INTUNE · 1 KB) |
| URL paths registered | 127 | 209 | 220 (+/decode/, +10 entry pages) |
HTTP 301 alias redirects in _redirects |
92 | 92 | 92 |
| OG image cards | 36 | 36 | 36 (10 decode pending) |
| Hugo build time | ~250ms | ~665ms | ~3.6s (still fine; gotmpl content adapter overhead) |
| Hugo build warnings | 0 | 0 | 0 |
| Search ranking tiers (jargon mode) | 6 | 9 | 9 |
| Search ranking tiers (errno mode) | n/a | n/a | 4 |
| Synonym terms seeded | 0 | 116 across 27 entries | 116 |
| Smart-suggest regex patterns | n/a | n/a | 3 (HRESULT · AADSTS · KB) |
| Wildcard middleware offline tests | 13/13 pass | 13/13 pass | 13/13 pass |
| MCP server offline tests | 15/15 pass | 15/15 pass | 15/15 pass |
| Live regression tests (Playwright) | 0 | 21/21 pass | 21/21 + new qa/decode-chip-diagnostic.mjs |
| Spicy Sush-takes | 5 | 10 | 10 |
| Voice keys total | 18 | 34 | 34 |
Live release notes (/changelog/) |
n/a | 5 entries | 6 entries |
| Self-hosted woff2 font weights | 4 (~376 KB) | 4 (~376 KB) | 4 (~376 KB) |
| Practice Exam SLA verifications during the build | 6 (all GREEN) | 7+ (all GREEN) | 10+ (all GREEN, separate Pages project) |
| cache_version | 2026050401 | 2026050506 | 2026050511 |
New pages live since v1: /wishlist/, /watch/, /changelog/, /decode/, 10 /decode/<code>/ pages, ? help overlay, recent searches.
Custom favicon at /favicon.svg (terminal-green block cursor on rounded black) — was 404'd before round 7, browsers fell through to the home HTML.
Theme toggle now shows ☀ / ☾ icons (was [ theme ] text).
Home launcher now has [ $ jargon ] [ ! errno ] mode chips (round 8) with smart-suggest fallback for paste-without-reading users.
🌌 Cosmos-level — what's next session¶
Recommendation: build Shift v1. (See ~/.copilot/build-backlog.md "🔥 NEXT SESSION" section for the full brief.)
In one line: the audience-expansion planet. "How fast is your job changing?" — a living mirror that shows any knowledge worker how AI is changing their role. Brings non-Microsoft audiences who've never heard of A Guide to Cloud. Validates that the cosmos pattern repeats across planets with different atmospheres.
If Shift feels too big to bite off, alternative quick wins: - MCP Move deploy (one evening — code is already done) - CMD v2b synonyms (~2 hours — search quality jump) - AI for Grandma v0 (~1 week — empathy planet, content-led)
This file is the living status of CMD. Update when v2 items ship, when entry count changes, when planets graduate from idea to live.