v0.4.0

⚠ Breaking change

create-forge new now renders through the forge-template engine by
default — forge-template>=0.5,<0.6 is a required dependency, not an
optional extra. copier moved to the optional legacy extra
(pip install "create-forge[legacy]"); the hidden --engine-preview flag
no longer exists.

Migrating from 0.3.x? See the
migration guide —
covers upgrading the CLI, existing Copier and engine-preview projects,
pinning back to 0.3.2 if 0.4.0 doesn't work for you, and recovering
from a bad update (git restore . && git clean -fd).
create-forge 0.3.x stays installable and supported for at least 90 days
and at least one further tagged release past this one.

[0.4.0] - 2026-09-14

Documentation

• Reconcile living documentation with the 0.3 release line (#148)
• Prepare engine-default and Streamlit roadmap packs
• Record filed cross-repository roadmaps
• Define engine-default selection and source-resolution UX (#155) (#169)
• Define update dispatch, migration and filesystem lifecycle (#156) (#170)
• Approve coordinated cutover acceptance and support policy (#157) (#171)
• Consolidate CLAUDE.md and CONTRIBUTING.md behind a docs index (#173)

Features

• Make the engine the default new path (CF-18.01)
• Implement isolated --engine-source overrides (CF-18.02) (#174)
• Implement engine generation finalisation, Git and hooks (CF-18.03) (#175)
• Implement engine-native project updates (CF-18.04) (#176)
• Preserve legacy Copier workflows and reject preview projects (CF-18.05) (#177)
• Complete installed cutover regressions and migration docs (CF-18.06) (#178)

v0.3.2

[0.3.2] - 2026-09-08

Features

• Diagnose the Copier template cache (#147)

v0.3.1

[0.3.1] - 2026-09-08

Bug Fixes

• Prevent template source credentials from reaching CLI output (#144)
• Raise the Copier floor past the destination-escape advisories (#146)

Documentation

• Publish 0.3.0 and close the Data Science roadmap (#130)
• Add shared Forge user guide and simplify README (#131)

v0.3.0

Compatibility

0.3.0 is the first create-forge line with discovery-driven generic component
selection and the Data Science archetype reachable behind --engine-preview
(CF-EPIC-13; CF-EPIC-14, ADR 0031–0034).

• The default new command is unchanged — it renders directly from the
  bundled forge-template Copier registry and needs no engine.
• --engine-preview remains hidden and opt-in. This release is not the
  CLI cutover.
• create-forge[engine] now resolves forge-template>=0.4.1,<0.5 and
  uv>=0.12,<0.13. Against forge-template 0.4.1, --engine-preview
  discovery returns five components: the library, cli, and data-science
  archetypes and the jupyter and scientific-python capabilities.

Validation evidence and roadmap closure:
CF-14.04 / #114 and
docs/release-0-3-0-validation.md.

---

[0.3.0] - 2026-09-05

Bug Fixes

• Handle template clone failures

Documentation

• Link canonical organisation policy model
• Sync canonical Stage 09 contracts
• Validate the reference-client boundary
• Add Data Science CLI roadmap
• Add Data Science CLI issue plan
• Link canonical Data Science project shape
• Link canonical Data Science capability contracts
• Link production Jupyter capability
• Link production Scientific Python capability
• Record forge-template 0.4.0 release
• Define generic component-selection CLI conventions (#122)

Features

• Define the downstream policy-consumption hook (#97)
• Add a downstream CLI integration reference (#98)
• Add dry-run support to update
• Prompt engine options from discovery, not the registry (#102)
• Adopt the forge-template 0.4 compatibility line (#121)
• Select capabilities and platforms from discovery (#123)
• Collect options for every selected component (#124)

Testing

• Validate the Data Science preview pipeline (#125)
• Validate installed Data Science generation (#127)
• Complete the rollout regression and failure matrix (#128)

v0.2.1

[0.2.1] - 2026-08-31

Bug Fixes

• Generate engine project lockfiles

Refactor

• Derive component options from discovery, not an archetype list (#92)

Testing

• Extend end-to-end generation to the public engine (#93)

v0.2.0

[0.2.0] - 2026-08-30

Documentation

• Mark v0.1.0 released in CLAUDE.md
• Sync cross-repository dependency matrix
• Link canonical Forge terminology
• Link canonical Foundation scope
• Link canonical Python support policy
• Define cross-repository integration policy
• Close roadmap stage 00
• Define CLI UX and prompting conventions
• Document cross-repository contributor workflow
• Link canonical editor integration strategy
• Link canonical configuration ownership
• Link canonical environment-variable conventions
• Link canonical structured logging contract
• Define template-engine source and version resolution
• Define template-engine dependency update policy
• Link canonical GitHub Action pinning policy
• Link canonical ProjectSpec protocol
• Link canonical component manifest contract
• Link stable template-engine API
• Link generated-project validation
• Link canonical Library archetype contract
• Link canonical CLI application archetype contract

Features

• Report engine and version diagnostics in doctor
• Build the canonical ProjectSpec behind one engine adapter (#79)
• Implement component discovery adapter
• Implement the shared create pipeline behind an opt-in engine flag (#83)
• Stage and finalise generation without leaving partials (#84)
• Expose the CLI Application archetype through the engine path (#89)
• Publish to PyPI and assign the first bounded engine range (#90)

Testing

• Add cross-repository engine contract
• Generate and check a real project end to end (#86)

v0.1.0

[0.1.0] - 2026-08-22

Bug Fixes

• Drop unasked task_runner prompt, add missing license prompt
• Fall back to ASCII markers when the console can't encode check marks (#22)
• Update always failed -- missing overwrite=True (#24)

Documentation

• Add Architecture Decision Records (Phase 6) (#21)

Features

• Wire config.py into cli.py

Refactor

• Extract helpers from cli.new() (#27)

Testing

• Add test suite and copier.yml drift guard (#13)