FCC Release History¶
Moved out of README.md on 2026-09-04. It had grown to 201 lines — 26% of the front page — and
had stopped at v1.4.0 (2026-04-22), nine releases behind, while the section carrying most of it
was still titled "What's Next" despite being ~95% backwards-looking.
The front page now states what is true now; this file holds what was true then.
Canonical release record is
CHANGELOG.md. This file is a narrative companion, preserved unedited below for continuity. Where the two disagree, the CHANGELOG wins. Entries below are historical and are not maintained — several counts were accurate at the time of writing and have since moved (e.g. "12,100+ tests" was true at v1.0.x; the measured figure at v2.2.0 is 15,647).
Phase Roadmap¶
| Phase | Status | Tests | Description |
|---|---|---|---|
| 1. Foundation | Done | 3 | Project skeleton, packaging, smoke tests |
| 2. Core FCC | Done | 43 | Personas, workflow graph, registry |
| 3. Simulation | Done | 32 | Engine, traces, AI client, scenarios |
| 4. Scaffolding CLI | Done | 22 | fcc init, templates, project config |
| 5. Governance | Done | 21 | Tags, quality gates, compliance |
| R.I.S.C.E.A.R. Expansion | Done | 259 total | Full 10-component spec, dimensions, strategic architecture |
| Extended Persona Gallery | Done | 693 total | 24 personas, cross-reference matrix, champion architecture, docs-as-code (1,348 files), dynamic validation |
| CI/CD, Scenarios & Docs | Done | 726 total | GitHub Actions CI/CD, MkDocs deployment, 11 advanced scenarios, 5 new validation rules |
| Coverage Push to 100% | Done | 757 total | 100% line coverage across 20 test files |
| Phase 5.5: Profiles & Docs UX | Done | 877+ total | 24 dimension profiles, documentation overhaul, MkDocs UX, 50 hand-written pages |
| Phase 6: Cross-Reference Expansion | Done | 1030+ total | Cross-reference matrix 16→106 entries, governance/champion-of types, 3 quality gates |
| Phase 7: Distribution | Done | 1168 total | PyPI packaging, release automation, _resources module |
| Phase 8: Plugin System & Ecosystem | Done | 1454+ total | 9 plugin types, 50→84 personas (17 categories), 5-phase workflow, artifact DB, ecosystem registry |
| Phase 9: EAIFC Integration | Done | 1705 total | 34 new personas, 6-action workflow (204 actions), ActionEngine, ConstitutionRegistry |
| Phase 10: Plugin Ecosystem & Collaboration | Done | 2472 total | Event bus, observability, collaboration engine, 10th plugin type, PAOM/AOME/CONSTEL plugins, dashboards |
| Phase 11: FCC Book, Notebooks & Streamlit | Done | 2932 total | Object model abstraction, CTO bridge, 12 notebooks, 10 Streamlit apps, 14-chapter guidebook |
| Phase 12: Protocol Integration & Web Frontend | Done | 5570+ total | A2A protocol, MCP server, 18 new personas (102 total), React frontend, JV governance, simulation hardening |
| Phase 13: Knowledge Federation & Doc Intelligence | Done | 9265 total | Semantic search, knowledge graphs, RAG pipeline, federation, demos, tutorials, 3 books, docs-from-code |
| Phase 14: Evaluation, Governance & Compliance | Done | 11,025+ total | CLEAR+ benchmarks, 128 model cards, EU AI Act compliance, NIST AI RMF, compliance pipeline, 73 event types |
| Phase 15 Stage I: Unified Object Model | Done | 11,439+ total | AOME/CONSTEL bridges, UnifiedModelFacade, 67 CTO↔AOME + 45 SID↔CTO mappings, unified search/KG/RAG, provider registry |
| Phase 15 Stage II: Enhanced Demos, UI & Messaging | Done | 11,892+ total | 4 new demos (19 total), PriorityEventBus, DLQ, circuit breaker, 81 EventTypes, 4 Streamlit apps (27 total) |
| Phase 15 Stage III: Documentation Excellence | Done | 12,052+ total | 6 book chapters (30 total), 4 notebooks (23 total), 4 guidebook chapters (24 total), maturity model |
| Phase 15 Stage IV: Platform Release & v1.0.0 | Done | 12,100+ total | VS Code extension, 3 domain verticals (15 new personas), public API freeze, migration guide, v1.0.0 release |
| v1.0.1: Documentation Overhaul | Done | 12,100+ total | Docs accuracy across 60+ files, guidebook restructure, model card version fix, adoption guide, audience quick-starts, expanded vertical prompts |
| v1.0.2: Multi-Format Publishing | Done | 12,100+ total | 300+ Mermaid diagrams, Quarto/Pandoc publishing pipeline, PDF/EPUB/DOCX/PPTX output, all 117 personas in MkDocs, 0 strict-mode warnings, executive/academic/reference packages |
| v1.0.3: Publishing Pipeline Live | Done | 12,100+ total | 27 artifacts built and committed, GitHub Actions publish workflow, make help completeness, for-teams expansion (5 files), 2 new tutorials, 2 new sample prompt files, README Publications section |
| v1.1.0: Docker + AI Provider Expansion | Done | 12,100+ total | 4 Dockerfiles + compose stack, make docker-* targets, WebSocket bridge entry function with HTTP /health endpoint, Ollama plugin, LiteLLM plugin (100+ backends via one client), conservative auto-detection, scenario ai_config override, model-reference sweep, [full] optional deps group, deployment + provider docs (7 files), notebook 24, audience tutorials |
| v1.1.0.1: Forward-fix patch | Done | 12,100+ total | 4 forward-fix commits consolidated: frontend Dockerfile tsc bypass, backend image OOM fix (slim deps), WS bridge /health endpoint using proper Response object, Jupyter HOME=/app fix, mkdocs-print-site-plugin added to [docs], docs.yml broken cross-repo links, publish.yml apt-get install pandoc. End-to-end local Docker stack verified: all 4 containers report healthy |
| v1.1.1: Helm + ghcr.io + vLLM | Done | 12,100+ total | Multi-arch image push to ghcr.io/rollingthunderfourtytwo-afk/fcc-* (amd64+arm64), Helm chart at charts/fcc/ (12 default + 14 prod K8s resources, 39 helm tests), helm-mirror CI for sister fcc-helm repo (inert until configured), kind k8s-smoke CI workflow, vLLM provider plugin (#7) with docker/vllm.yml GPU example + 17 tests, 7 deferred deployment docs (kubernetes/helm/security/observability/upgrade/images/helm-repo-mirror), docs/providers/vllm.md, notebook 25 |
| v1.2.0: Vertical Schema Extension + Industry Packs | Done | 12,100+ total | Schema v2 with nested R.I.S.C.E.A.R. + backward-compat v1 loader (anyOf), retrofitted healthcare/finance/legal (15 personas → rich content), 3 net-new packs (insurance 6, energy 6, government 6), healthcare+finance expansions (+12 medical/financial personas), 45 vertical personas total across 6 packs (up from 15 across 3), 5 research notes with standards sources, vertical risk profiles for EU AI Act, persona ID collision prevention script, cross-reference generator, 173 model cards regenerated, 20 audience tutorials, notebooks 26+27, vertical_explorer Streamlit app, guidebook ch25, book 3 ch11 |
| v1.2.1: K8s Smoke + Vocabulary Plugins + Demo Expansion | Done | 12,500+ total | Helm chart bumped to 0.2.0/appVersion 1.2.1, K8s smoke probe tuning + post-failure diagnostics, coverage ratchet start (94%), VocabularyProviderPlugin ABC + loader + athenium/mnemosyne plugins, 4 new subsystem notebooks (28-31) + full_stack demo + notebook 32, 16 audience subsystem tutorials, persona/archetype interaction atlas auto-generator |
| v1.2.2–v1.2.6: Coverage Ratchet | Done | 13,000+ total | 525 new coverage tests across 25 test files. Gate ratcheted: 94→95→96→97→98→98%. Targets: ai_client, action_engine, auditor, pipeline, runner, embeddings, requirements, feedback, dashboard, RAG, knowledge, federation, code_analyzer, observability, distiller, objectmodel, artifacts, plugins, demos, scaffold/cli (121 CliRunner tests) |
| v1.3.0: 10 External Project Scaffolds + Federation Expansion | Done | 13,000+ total | 10 constellation-codename projects (5 ontology + 5 metadata) scaffolded at /mnt/d/.../Ideate/{codename}_ext/ with full CTO/CONSTEL-pattern applications (FastAPI + CLI + persistence + ETL + seed data + tests). Federation namespace registry 11→21, vocabulary mappings 95→175, vocabulary provider plugins 2→12. fcc scaffold-vertical-project CLI command. Coverage gate 98→99% with ABC/Protocol ellipsis exclusion + advisory --cov-branch CI job |
| v1.3.1: Foundation — Branch Gate + Seed-Full + Stale Doc Refresh | Done | 13,000+ total | Hard --cov-branch gate (was advisory in v1.3.0); make seed-full implementation with pattern-based 500-1000 entity expansion; STRATEGIC_ARCHITECTURE_REVIEW.md refreshed v0.8.0→v1.3.1; ROADMAP.md rewritten (Phase 16+ → v1.3.x plan); docs/roadmap/release-plan.md refreshed v1.0.3→v1.3.1 with 11 new release entries |
| v1.3.2: Publication Pipeline — Mermaid Rendering + Markdown Format | Done | 13,000+ total | publications/scripts/render_mermaid.py renders 280 mermaid diagrams across 228 files to SVG + PNG (560 assets committed); Pandoc Lua filter safety net (mermaid-filter.lua); all 27 existing artifacts rebuild with embedded images (PDF→SVG via Typst, DOCX→PNG, EPUB/HTML→SVG); NEW Markdown publication format — consolidated (single file per book) + per-chapter variants with dual representation (fenced source + image refs); Makefile targets pub-diagrams, pub-markdown, pub-diagrams-clean; CI publications-check advisory job |
| v1.3.3: Content Expansion — Sample Prompts + Persona Evolution + Audience Docs | Done | 13,000+ total | 11 new sample prompt files (vertical insurance/energy/government + evaluation/compliance/docker/federation/scaffold + beginner/educator/research) → 35 total; persona evolution content: evolution-pathways.md + 6 archetype deep-dives (shepherd/quant/investigator/architect/storyteller/safety-engineer) + persona-evolution-workshop; guidebook chapter 26 (25→26); notebook 33 persona evolution explorer (32→33); 8 new audience docs (beginner first-30-min + common-mistakes, scientist experimental-design + statistical-analysis, educator grading-rubrics + lab-exercise-bank, professional cost-analysis + security-review); mkdocs.yml nav expanded ~29 entries |
What's Next¶
Phase 6 — FCC Portal redesign (in development). The web UI is being rebuilt
into a true portal into the project: a persistent PortalShell with a ⌘K
command palette, the formerly URL-only admin folded into the nav, a full
176-agent catalog with per-persona detail + adopt bindings (R.I.S.C.E.A.R.
prompt / A2A card / PAOM-8), an Ask FCC Agent deep-search front door over a
live read API (/api/v1/personas, /api/v1/ask), and a federation board +
ecosystem product switcher. Design of record: docs/roadmap/fcc-portal-redesign.md.
v1.3.5.2 released (2026-04-13) — Third patch. Closes v1.3.5.1 deferred
items and ships a broad content expansion: 5 demo addenda
(*-v1352-addendum.md under docs/tutorials/demos/) covering WebSocket
stress-test, distiller vocabulary evolution, cross-project FAIR audit,
Sky-Parlour Phase-17 integration, full-stack OpenTelemetry trace; 10 new
sample-prompt files (architecture teaching, persona evolution stages,
plugin-dev gap-fill, guided-demo follow-ups); a first-class ecosystem
alignment status table covering all 10 sibling projects; light-touch
figure prose across 111 MkDocs-only Mermaid blocks. A new v1352 Showcase
demo walks the 5 addendum flows end-to-end (built-in demo count: 20 → 21).
v1.3.5.1 released (2026-04-13) — Second patch of the v1.3.5.x series. Ships
a brand-new docs/architecture/ tree: 5 classDiagrams, 6 sequenceDiagrams, 4
data-flow diagrams, 4 use-case diagrams (one per audience tier), a repo site
map, an API-boundary matrix covering all 6 external interfaces, a plugin-
boundary reference for all 11 plugin types, and a side-by-side "federated vs
individual" comparison for both the object model and the knowledge graph. The
5 ADRs under docs/decisions/ are finally in the mkdocs nav (Reference →
Architecture Decisions). Each audience tier has a new "See also" block bridging
to the others and to the relevant architecture slice. Also: render_mermaid.py
now disambiguates slugs by parent directory so the 20 overview.md siblings
no longer collide on asset filenames (302 renders → 302 distinct PNG/SVG
files, up from 281). Build-time guard in build_all.sh drops the redundant
pre-render pass, saving ~10 minutes on WSL2.
v1.3.5 released (2026-04-13) — First patch. Main CI unblocked; publication pipeline fixed so DOCX/EPUB embed real PNG diagrams instead of blank boxes; 56 figures in publication source trees authored with unified "Figure N" captions + intros + followups; Quarto LOF/LOT enabled across PDF/DOCX/EPUB/HTML.
v1.4.0 released (2026-04-22) — Ecosystem pivot pillar 1 COMPLETE. Published all 10 constellation vertical projects as independent public GitHub repositories with their own release cycles, ending the pre-v1.4.0 prework pipeline (8 releases shipped in this session):
- Medical — ophiuchus_ext (HL7 FHIR Genomics + DICOM + IEC 62304) · serpens_ext (ICH E2B + EudraVigilance)
- Financial — libra_ext (FIBO, EDM Council) · crater_ext (ISO 20022 + BCBS 239)
- Insurance — scutum_ext (ACORD v2.11) · norma_ext (Solvency II + IFRS 17)
- Energy — pyxis_ext (IEC 61970 CIM) · vela_ext (IEC 62325 + CGMES + IEEE 1547)
- Government — columba_ext (DCAT-US 3.0) · caelum_ext (NIEM 6.0 + eIDAS 2.0)
Each repo is v0.2.0 signaling FCC v1.4.0 alignment; each carries the
full public-release package from v1.3.11 (CODE_OF_CONDUCT, CONTRIBUTING,
SECURITY, MIT LICENSE, CI/release workflows, issue + PR templates,
release-checklist runbook). Helm chart bumped to 0.3.0. Pillars 2-5
(GraphRAG, real canonical seed data, i18n, real-time multi-user
collaboration, advanced federation, performance optimization) defer
to v1.4.1+.
v1.3.11 released (2026-04-22) — Seventh and final patch of the
pre-v1.4.0 prework plan. Wires ecosystem-integration-tests 49
offline contract tests as an advisory CI gate. Extends the vertical-
project scaffold with a --public-release flag emitting all 10
artifacts a constellation needs to stand up as an independent
GitHub repo (CODE_OF_CONDUCT, CONTRIBUTING, SECURITY, LICENSE,
CI/release workflows, issue + PR templates, release-checklist
runbook). Dry-runs all 10 constellation tarballs via
make pub-constellations. Bumps all 12 vocabulary_provider plugins
to version 0.2.0 with FCC pin >=1.3.11. +19 new tests.
Pre-v1.4.0 plan COMPLETE (7 of 7 patches shipped in this session — v1.3.5.4 through v1.3.11).
Next: v1.4.0 final — publish the 10 constellation GitHub repos
(Ophiuchus, Serpens, Libra, Crater, Scutum, Norma, Pyxis, Vela,
Columba, Caelum). This is a hard-to-reverse public action:
gh repo create for each, push release tarballs, enable Actions
+ Issues + Discussions. Requires explicit user approval before
proceeding.
v1.3.10 released (2026-04-22) — Sixth patch of the pre-v1.4.0
prework plan. Ships the full 9-audience canonical taxonomy the
ecosystem has standardized on (beginners, developers, educators,
scientists, architects, operators, auditors, knowledge-engineers,
data-architects) — 25 new audience pages (~29,000 words), 4 new
guidebook chapters (ch27-30) with 13 new diagrams, 5 new sample
prompts (45 → 50), 5 new Jupyter notebooks (33 → 38), and a
cross-link matrix connecting every audience to its related
resources. Gracefully deprecates for-professionals/ +
for-teams/ with MIGRATION.md stubs + banners; content preserved
for external-link stability. Navigation reorganized across
mkdocs.yml into canonical order; publications/_quarto.yml now
carries 8 parts. No source changes; test suite + persona count
unchanged.
Next: v1.3.11 — ecosystem-integration-tests CI gate +
constellation scaffold for public release + v1.4.0-rc cut. Adds
make ecosystem-check that runs the 49 offline contract tests
from ecosystem-integration-tests, updates all 12 vocabulary
provider plugins to match PAOM v3.2.0, and cuts the v1.4.0 release
candidate.
v1.3.9 released (2026-04-22) — Fifth patch of the pre-v1.4.0
prework plan. FCC was designated patent-centric; this release ships
the full draft patent package READY FOR COUNSEL REVIEW. Full
docs/patent/ tree (12 files, 40,570 words): invention disclosure
form, prior-art landscape (35 items reviewed — 0 direct overlaps,
2 Medium-risk items noted, 8 Low-risk), provisional specification
with abstract + 20 claims (3 independent + 17 dependent), utility
specification with 32 claims (5 independent + 27 dependent), FTO
analysis + per-claim risk register, drawings pointer (4+1 UML from
v1.3.7 re-used as FIG. 1-6). IP Evaluation Analyst introduced as
the 104th core persona (governance 5 → 6). Quarto make pub-patent
target builds the patent PDF + DOCX with DRAFT watermark. PAOM v1.4
preview plugin surface declared at fcc.plugins.v1_4_preview.*
with 6-month deprecation policy. +6 new PAOM compat tests. Filing
requires patent counsel engagement; outside plan scope.
Next: v1.3.10 — 9-audience documentation scale-up. FCC currently
has 5 audience dirs (for-beginners, for-educators, for-scientists,
for-professionals, for-teams); the ecosystem has standardized on 9
canonical audiences. v1.3.10 adds for-developers, for-architects,
for-operators, for-auditors, for-knowledge-engineers, and
for-data-architects with 20+ sample prompts, 10+ new Jupyter
notebooks, and guidebook chapters 27-30.
Pre-v1.4.0 plan (7 patches total):
- v1.3.5.4 — Inventory + port realignment + carry-overs + JV L2 unblock (shipped 2026-04-22)
- v1.3.6 — Self-audit +
fcc adminCLI + PlantUML pipeline + forensic auditor archetype (shipped 2026-04-22) - v1.3.7 — 4+1 UML views + C4 context diagram + React
/adminroute + StressTestPanel.tsx (shipped 2026-04-22) - v1.3.8 — 58-gate quality registry from PHOENIX + R.I.S.C.E.A.R. completeness + 12 open-science templates (shipped 2026-04-22)
- v1.3.9 — Patent infrastructure (provisional + utility + FTO) + PAOM v1.4-preview plugin surface (shipped 2026-04-22)
- v1.3.10 — 9-audience documentation scale-up (6 new audience dirs, 25 pages, 4 guidebook chapters, cross-link matrix) (shipped 2026-04-22)
- v1.3.11 — Ecosystem-integration-tests CI gate + constellation public-release scaffold + 12 plugin bumps + dry-run tarballs (shipped 2026-04-22)
- v1.4.0 — Ecosystem pivot pillar 1: 10 constellation repos published to GitHub as independent public releases (this release; pillars 2-5 defer to v1.4.1+)
Past releases:
- v1.1.0 — Docker + Compose stack, 6 AI providers
- v1.1.0.1 — Forward-fix patch
- v1.1.1 — Helm chart, multi-arch ghcr.io, vLLM provider
- v1.2.0 — Vertical schema extension + 6 industry packs (45 personas)
- v1.2.1 — K8s smoke + vocabulary plugins + demo expansion
- v1.2.2–v1.2.6 — Coverage ratchet (94% → 98%)
- v1.3.0 — 10 external project scaffolds + federation 11→21 + coverage to 99%
- v1.3.1 — Hard branch gate + seed-full + stale doc refresh
- v1.3.2 — Publication pipeline: mermaid rendering + Markdown format
- v1.3.3 — Content expansion: sample prompts, persona evolution, audience docs
- v1.3.4 — Hotfix: green CI + restored publications pipeline
- v1.3.5 — Publication pipeline quality + figure numbering + main CI unblock
- v1.3.5.1 — New architecture/UML docs tree (24 docs) + slug-collision fix + build-perf guard
- v1.3.5.2 — Full republish + 5 demo addenda + 10 sample prompts + ecosystem alignment + 111 light-touch figure annotations
- v1.3.5.3 — Coverage gate restored 98→99 + needs_render guard bug fixed; closes v1.3.5.x series
- v1.3.5.4 — Inventory + port realignment (10 → 19 projects, constellation ports 8300→8600) + vendored RC registries with CI drift test + carry-overs resolved
- v1.3.6 — Self-audit + admin CLIs + PlantUML pipeline + Forensic Auditor persona (103rd; governance 4→5)
- v1.3.7 — 4+1 UML views + C4 context diagram + REST admin API + React /admin route + StressTestPanel.tsx
- v1.3.8 — 58-gate quality registry from PHOENIX + R.I.S.C.E.A.R. strict gate + 12 OPEN-SCI templates + 3 PHOENIX Tier-1 gap closures
- v1.3.9 — Patent infrastructure (12 files, 40,570 words, 20 provisional + 32 utility claims) + IP Evaluation Analyst (104th persona) + PAOM v1.4-preview (this release)