---
id: 02-single-version-release-please
epic: platform-retrofit
title: Rewrite release-please to a single root product version
type: technical-story
status: todo
feature: tooling
depends-on: []
blocks: [03-delete-demo-apps-and-features, 08-rewrite-agent-docs]
created: 2026-07-12T10:22:00Z
---

## Goal

`release-please-config.json` + `.release-please-manifest.json` track the root package only — a single product version with plain `v*` tags (`include-component-in-tag` dropped), pre-1.0 bump policy retained. Veect is a hosted SaaS that deploys continuously; per-feature versions return only if an npm distribution ships.

## Why

release-please currently tracks five demo feature packages that stories 03/04 delete. Rewriting to root-only FIRST keeps ADR-021's Conventional-Commit → release automation working through the deletions: if a deletion commit touched a still-tracked `packages/<feature>/**` path, release-please would try to bump a package whose `package.json` no longer exists. Story 03 therefore depends on this story (PRD user story 5 + ADR-021 constraint).

## Done when

- `release-please-config.json` validates against its schema and tracks only `"."`.
- `include-component-in-tag` is dropped (single `v*` tags); pre-1.0 bump policy (`bump-patch-for-minor-pre-major`) retained; changelog sections retained.
- `.release-please-manifest.json` contains only the root entry.
- Any release-please CI workflow references to per-package components still work.
- `pnpm typecheck && pnpm lint && pnpm test && pnpm conformance && pnpm fallow:audit && pnpm coverage:diff` pass.

## In scope

- `release-please-config.json`, `.release-please-manifest.json`, and any CI workflow wiring that assumes per-component tags.

## Out of scope

- Deleting the feature packages themselves (story 03).
- Renaming the root package (`template-vertical` → product name changes belong to the docs rewrite only if the PRD's next-PRD work requires it; this story touches versioning config only).
- Retagging or rewriting existing git tags/releases.

## Tasks

- [ ] Rewrite `release-please-config.json` to track the root package only (drop the five `packages/*` entries and `include-component-in-tag`, keep the pre-1.0 bump policy and changelog sections), shrink `.release-please-manifest.json` to the root entry, and adjust any release CI workflow that assumed per-component tags — config validates, one commit, all gates pass.
