Release Plan¶
This page details the release plan for the FCC Agent Team Framework.
Current Release: v1.3.1 (April 2026)¶
Status: In Progress
Theme: Foundation for v1.3.x — hard branch coverage gate, make seed-full implementation, stale document refresh
Key Deliverables¶
| Deliverable | Status |
|---|---|
Hard --cov-branch gate |
CI + Release workflows enforce branch coverage at baseline - 2% |
make seed-full implementation |
All 10 external constellation projects ship working seed expansion script |
| STRATEGIC_ARCHITECTURE_REVIEW.md refresh | Full update from v0.8.0 to v1.3.1 state (metrics, Technology Radar, phase completions) |
| ROADMAP.md refresh | Remove stale Phase 16+, add v1.0.1–v1.3.0 milestones, add v1.3.x plan |
| docs/roadmap/release-plan.md refresh | Current Release v1.0.3 → v1.3.1; add v1.1.0–v1.3.0 entries (this file) |
| Coverage ratchet ledger | Move v1.3.1 row from "planned" to "current" with branch gate baseline |
v1.3.0 (April 12, 2026)¶
Status: Done Theme: Ten external constellation projects + federation 11 → 21 namespaces + 99% coverage
Key Deliverables¶
| Deliverable | Status |
|---|---|
| 10 External Constellation Projects | Ophiuchus/Serpens (medical), Libra/Crater (financial), Scutum/Norma (insurance), Pyxis/Vela (energy), Columba/Caelum (government) |
| Federation Namespace Expansion | 11 → 21 namespaces in namespace_registry.yaml |
| Vocabulary Mappings | 95 → 175 across 20 YAML files |
| Vocabulary Plugins | 2 → 12 VocabularyProviderPlugin packages |
fcc scaffold-vertical-project CLI |
Jinja2 template engine for ontology + metadata project generation |
| Coverage 98 → 99% | ABC/Protocol ellipsis exclusions in pyproject.toml |
| Branch coverage introduced | Advisory job added to CI (hard gate deferred to v1.3.1) |
v1.2.6 (April 12, 2026)¶
Status: Done Theme: Coverage ratchet 97% → 98%
10 test files, 127 new tests targeting remaining gaps.
v1.2.5 (April 12, 2026)¶
Status: Done Theme: Coverage ratchet 96% → 97%
10 test files, 127 new tests. test_scaffold_cli_v125.py alone has 121 CliRunner tests covering all 15 CLI command groups.
v1.2.4 (April 12, 2026)¶
Status: Done Theme: Coverage ratchet 95% → 96%
4 test files, 69 new tests.
v1.2.3 (April 12, 2026)¶
Status: Done Theme: Coverage ratchet iteration
Focused tests across compliance, observability, protocol modules.
v1.2.2 (April 12, 2026)¶
Status: Done Theme: Coverage ratchet 94% → 95%
9 focused test files, 199 new tests. Two follow-up patches relaxed hardcoded 10-plugin-type and 19-demo assertions across the test suite.
v1.2.1 (April 12, 2026)¶
Status: Done Theme: K8s smoke fix + VocabularyProviderPlugin pattern
Key Deliverables¶
| Deliverable | Status |
|---|---|
| K8s smoke test | First green since v1.0.x (3 forward-fix commits) |
| VocabularyProviderPlugin | 11th plugin type with ABC, namespace, class_map contract |
| VocabularyMappingLoader | verify_against_plugin() for contract validation |
| 2 new plugins | fcc-athenium-plugin, fcc-mnemosyne-plugin (verified clean) |
| 4 new notebooks | 25: Helm Deployment, 26-27: Vertical Packs, 28: Web Frontend |
| 16 audience tutorials | Per-subsystem × 4 audiences (beginner/academic/scientific/professional) |
| Archetype Interaction Atlas | Auto-generated persona relationship documentation |
| Coverage ratchet start | 93% → 94% |
| Chart bump | 0.2.0, appVersion 1.2.1 |
v1.2.0 (April 12, 2026)¶
Status: Done Theme: Vertical schema v2 + 45 vertical personas
Key Deliverables¶
| Deliverable | Status |
|---|---|
| Vertical schema v2 | Nested R.I.S.C.E.A.R. with anyOf schema for v1/v2 backward compat |
| 45 Vertical Personas | Healthcare (11), Finance (11), Legal (5), Insurance (6), Energy (6), Government (6) |
| Model cards 128 → 173 | 147 personas + 20 categories + 6 workflow cards |
| EU AI Act vertical risk profiles | vertical_risk_profiles.yaml (45 entries) |
--include-verticals flag |
fcc model-card generate --include-verticals |
v1.1.1 (April 11, 2026)¶
Status: Done Theme: Helm chart + multi-arch images + vLLM
Key Deliverables¶
| Deliverable | Status |
|---|---|
| Helm chart | charts/fcc/: 12 K8s resources + 14 templates + 39 tests |
| Multi-arch ghcr.io images | amd64 + arm64 builds pushed to ghcr.io |
| vLLM provider plugin | 6th AI provider (production serving) |
| helm-mirror CI | Inert workflow prepared for gh-pages publish |
| kind k8s-smoke CI | Ephemeral cluster validation |
| 7 deployment docs | Docker, K8s, Helm, security, observability, upgrade, limitations |
| Notebook 25 | Helm Deployment Walkthrough |
v1.1.0.1 (April 11, 2026)¶
Status: Done Theme: Docker stack forward-fix patch
Patch release consolidating 4 forward-fix commits. Working Docker stack verified (4 healthy containers). Fixed docs.yml and publish.yml CI. No API changes — reserved v1.1.1 slot for K8s/Helm.
v1.1.0 (April 10, 2026)¶
Status: Done Theme: Docker stack + 6 AI providers
Key Deliverables¶
| Deliverable | Status |
|---|---|
| 4 production Dockerfiles | backend, frontend, streamlit, jupyter |
| docker-compose.yml + prod overlay | Local dev + production overlay |
| 6 AI providers | anthropic, openai, azure_openai, ollama, litellm, mock |
| Conservative auto-detection | AIProviderPlugin.get_env_var_hint() |
| Per-scenario overrides | setup.ai_config: |
| Ollama + LiteLLM plugins | Universal LLM backend router |
fcc protocol ws-bridge |
Backend Docker ENTRYPOINT with HTTP /health |
| Makefile targets | make docker-{build,up,down,logs,test} |
[full] optional dep umbrella |
Everything needed for Docker backend |
| 7 new docs + 4 audience tutorials | Docker, Compose, AI providers |
Build-only in v1.1.0 — image registry push and K8s/Helm deferred to v1.1.1.
v1.0.3 (April 2026)¶
Status: Done Theme: Publishing pipeline functional, 27 artifacts published, for-teams expansion
Key Deliverables¶
| Deliverable | Status |
|---|---|
| 27 publication artifacts | All 5 formats (PDF/EPUB/DOCX/PPTX/HTML) built and committed |
| GitHub Actions publish.yml | Auto-uploads artifacts to Releases on publish event |
| make help completeness | All 44 targets documented (was 35) |
| README Publications section | All download links in place |
| docs/publications/ guide | Build instructions + troubleshooting |
| docs/for-teams/ expansion | 5 files (was 1): workflows, governance, scaling, KB |
| New sample prompts | team-coordination, publications-workflow |
| New publications tutorials | building-your-own-book, contributing-to-books |
v1.0.2 (April 2026)¶
Status: Done Theme: Multi-format publishing, comprehensive Mermaid diagrams, documentation quality
Key Deliverables¶
| Deliverable | Status |
|---|---|
| 0 MkDocs warnings | All 299 strict-mode warnings resolved |
| 300+ Mermaid diagrams | Persona interaction maps, category mindmaps, API class diagrams, specification ER diagrams |
| Multi-format publishing | Quarto + Pandoc pipeline for PDF, EPUB, DOCX, PPTX |
| All 147 personas in nav | Complete coverage across 20 core categories + 6 vertical packs |
| Executive package | PowerPoint deck + PDF for decision makers |
| Academic package | Curriculum, workshop guide, student workbook |
| Reference cards | 5 condensed PDF cards (personas, CLI, workflows, prompts, R.I.S.C.E.A.R.) |
| MkDocs enhancements | Version selector, print-site, dark-mode Mermaid, code annotations |
Phase 7: Distribution (Complete)¶
Status: Done (v0.2.0) Theme: Make the framework installable and distributable as a standard Python package.
Deliverables¶
| Deliverable | Status |
|---|---|
| PyPI package | pip install fcc-agent-team-ext installs the framework with all dependencies |
| Release automation | GitHub Actions workflow with OIDC trusted publishing for TestPyPI and PyPI |
| Version management | Dynamic version from __init__.py, SemVer (0.2.0) |
| Package data | All data files relocated to src/fcc/data/, included in wheel (47 files) |
| Resource resolution | fcc._resources module using importlib.resources.files() |
| Distribution docs | RELEASING.md, migration guide, FAQ, troubleshooting, packaging guide |
Success Criteria¶
- Package installs cleanly with
pip install fcc-agent-team-ext fcc --versionreports the correct version after installation- All 1,168 tests pass in the installed (non-editable) package
- Release pipeline publishes automatically on GitHub Release creation
Phase 8: Advanced Automation¶
Timeline: Q2-Q3 2026 Theme: Enable extensibility through plugins and third-party integrations.
Goals¶
- Implement a plugin architecture for custom components
- Integrate with CI/CD platforms for automated documentation quality checks
- Add support for custom workflow engines
- Enable third-party template registries
Deliverables¶
| Deliverable | Description |
|---|---|
| Plugin system | Entry-point-based plugin discovery for simulation engines, template renderers, and governance scorers |
| CI/CD integration | GitHub Actions and GitLab CI templates for running fcc validate and fcc generate-docs in pipelines |
| Custom engines | Interface for registering custom simulation engines beyond the built-in mock and AI engines |
| Template registry | Support for loading templates from external packages and directories |
| Webhook support | Event hooks for simulation start, step completion, gate evaluation, and simulation end |
Success Criteria¶
- At least 3 plugin types are supported (engine, template, scorer)
- CI/CD integration templates work out of the box for GitHub Actions
- Custom engines can be registered without modifying framework source
- Plugin documentation covers the full development lifecycle
Phase 9: Agent-Human Collaboration¶
Timeline: Q3 2026 - Q1 2027 Theme: Enable real-time collaboration between AI agents and human reviewers.
Goals¶
- Add human-in-the-loop checkpoints to simulation workflows
- Implement feedback integration for iterative persona improvement
- Create a web-based dashboard for simulation monitoring
- Support real-time persona switching for human collaborators
Deliverables¶
| Deliverable | Description |
|---|---|
| Checkpoint system | Configurable pause points in workflow simulation where human review is required before proceeding |
| Feedback loop | Structured feedback from human reviewers that updates persona behavior in subsequent simulation runs |
| Monitoring dashboard | Web interface showing real-time simulation progress, persona activity, and quality gate status |
| Role adoption mode | Interactive mode where a human adopts a persona role, guided by the R.I.S.C.E.A.R. specification and adoption checklist |
| Collaboration log | Structured log of agent-human interactions for audit and analysis |
Success Criteria¶
- Checkpoints pause simulation and wait for human input
- Feedback from human reviewers measurably improves simulation output quality
- Dashboard displays real-time simulation state for all workflow graph types
- Role adoption mode guides humans through the full adoption checklist
Version Strategy¶
The framework follows semantic versioning:
| Version | Meaning |
|---|---|
0.x.y |
Pre-1.0 development (current: 0.2.0) |
1.0.0 |
First stable release (after Phase 8 plugin system) |
1.x.0 |
New features, backward compatible |
x.0.0 |
Breaking changes to core specifications |
The __version__ string in src/fcc/__init__.py is the single source of truth for the current version.
Related Pages¶
- Roadmap Overview -- complete phase timeline
- Strategic Vision -- three-year direction
- Changelog -- what has been delivered so far