Skip to content

Release Notes: v0.1.0

Release Date: 2026-07-25

Status: Release. This is the initial tagged release of PRISM Control, covering all changes accumulated since the project's initial commit.

Summary

This is the initial build-out of PRISM Control: an Ent-backed (Dolt/MySQL) control plane for cross-repository initiatives, phases, roadmap items (RMIs), lease-based work assignments, and delivery evidence. It ships as a library-first Go SDK (prismcontrol) with a Cobra CLI (prismctl) and an MCP server, both built on one shared service layer, plus tooling to keep ROADMAP.md and the database in sync.

Highlights

  • Ent-backed domain store (MySQL dialect targeting Dolt) with an in-memory MemStore fake, so all domain logic is unit-testable without a running database
  • Full delivery model: initiatives, phases with derived status, roadmap items (RMIs), lease-based work assignments, and delivery evidence
  • One shared service layer powers both the prismctl Cobra CLI and an MCP server exposing 9 tools for Claude Code session integration
  • Bidirectional ROADMAP.md sync, git commit ingestion for Refs: trailers, and JSONL snapshot export for portable backups

What's New

Features

  • Ent schema and codegen for Initiative, Phase, RoadmapItem, Assignment, DeliveryEvidence, Repository, and their dependency edges (db4d1eb)
  • Store interface with sub-interfaces for initiatives, phases, RMIs, assignments, evidence, and repositories; a MemStore in-memory fake for unit testing; an Ent-backed DoltStore implementation with embedded and server connection modes; typed error kinds in pcerr (5a5fd93)
  • Core domain packages: initiative lifecycle with phase status always derived from member RMIs (never stored directly), lease-based work assignments (claim/release/renew/complete), commit trailer parsing for Refs: and Co-authored-by, and RMI status/dependency tracking (acd03da)
  • Roadmap sync, ingestion, and export: a ROADMAP.md parser, generator, and diff for bidirectional sync between markdown specs and the database; git commit ingestion for Refs: trailers and structured-changelog import; JSONL snapshot export with manifest for portable backups (ad376da)
  • Reporting, release planning, and validation: initiative report generation (markdown and JSON), dependency-ordered release planning, git repository scanning via gogit for commit attribution, and store-wide consistency validation — ID format, dangling dependencies, cycles, expired leases, status coherence, and evidence coverage (0832dfa)
  • Shared service layer and MCP server: one service layer called identically by the CLI and MCP adapters (initiative CRUD, phase management, RMI operations, work claims with lease enforcement, roadmap sync, ingestion, reports, validation, export); an MCP server exposing 9 tools over stdio transport for Claude Code session integration (c60ed09)
  • SDK facade: the root prismcontrol package as the importable Go SDK (0b62479)
  • CLI: full prismctl Cobra CLI covering database management (init, serve, create-views), a two-level dashboard (live server and static snapshot), registry, initiatives (CRUD, dependencies, program grouping), phases, RMIs (CRUD, dependencies, bulk status), work assignments (claim, release, renew, complete), roadmap sync, ingestion, reports, validation, export, and an MCP server launcher (64c1a4f)

Bug Fixes

  • Resolved all golangci-lint errors: gofmt formatting across 10 files, ReadHeaderTimeout on the dashboard HTTP server (Slowloris mitigation), tightened WriteFile permissions to 0o600, gosec suppressions for a test helper exec and an intentional safeHTML template func, and removal of always-constant test helper parameters (0ba1916)

Changed

  • Gated all doltstore-importing code behind a dolt build tag so go build, go test, and golangci-lint run work without CGO or ICU headers; full Dolt functionality now requires -tags dolt (d536cc5)

Infrastructure

  • Excluded the doltstore and cmd/prismctl packages (which require ICU C headers unavailable on standard CI runners) from test, lint, and CodeQL workflows; dropped Windows from the test matrix, bumped actions to v7, and fixed checkout-before-setup-go ordering (ff62c8a)

Breaking Changes

None — this is the project's initial build-out; no prior tagged release exists.

Installation

git clone https://github.com/ProductBuildersHQ/prism.git
cd prism
git checkout v0.1.0

# ICU headers are required for the embedded Dolt driver (see docs/getting-started/install.md)
export CGO_CPPFLAGS="-I$(brew --prefix icu4c)/include"
export CGO_LDFLAGS="-L$(brew --prefix icu4c)/lib"

go build -o prismctl ./cmd/prismctl/

See Installation for full prerequisites and setup.

Migration Guide

Not applicable — there is no prior release to migrate from.

Full Changelog

See CHANGELOG.md for the complete list of changes.