container-superposition 0.1.8 → 0.1.10

package/docs/overlays.md

@@ -18,40 +18,44 @@ This document provides a comprehensive reference for all available overlays in c
 
 .NET 10 SDK with C# DevKit
 
-| Property     | Value                          |
-| ------------ | ------------------------------ |
-| **Category** | language                       |
-| **Tags**     | `language`, `dotnet`, `csharp` |
+| Property      | Value                                   |
+| ------------- | --------------------------------------- |
+| **Category**  | language                                |
+| **Conflicts** | `mysql`, `redpanda`, `otel-demo-nodejs` |
+| **Tags**      | `language`, `dotnet`, `csharp`          |
 
 ### Bun (`bun`)
 
 Bun runtime - faster JavaScript runtime and package manager
 
-| Property     | Value                                         |
-| ------------ | --------------------------------------------- |
-| **Category** | language                                      |
-| **Tags**     | `language`, `bun`, `javascript`, `typescript` |
-| **Ports**    | 3000, 8080                                    |
+| Property      | Value                                                            |
+| ------------- | ---------------------------------------------------------------- |
+| **Category**  | language                                                         |
+| **Conflicts** | `grafana`, `open-webui`, `mysql`, `redpanda`, `otel-demo-nodejs` |
+| **Tags**      | `language`, `bun`, `javascript`, `typescript`                    |
+| **Ports**     | 3000, 8080                                                       |
 
 ### Go (`go`)
 
 Go latest stable with gopls and delve debugger
 
-| Property     | Value                      |
-| ------------ | -------------------------- |
-| **Category** | language                   |
-| **Tags**     | `language`, `go`, `golang` |
-| **Ports**    | 8080, 8081                 |
+| Property      | Value                                                                  |
+| ------------- | ---------------------------------------------------------------------- |
+| **Category**  | language                                                               |
+| **Conflicts** | `mysql`, `redpanda`, `mongodb`, `otel-demo-nodejs`, `otel-demo-python` |
+| **Tags**      | `language`, `go`, `golang`                                             |
+| **Ports**     | 8080, 8081                                                             |
 
 ### Java (`java`)
 
 Eclipse Temurin JDK 21 with Maven and Gradle
 
-| Property     | Value                                 |
-| ------------ | ------------------------------------- |
-| **Category** | language                              |
-| **Tags**     | `language`, `java`, `maven`, `gradle` |
-| **Ports**    | 8080, 8081                            |
+| Property      | Value                                                                  |
+| ------------- | ---------------------------------------------------------------------- |
+| **Category**  | language                                                               |
+| **Conflicts** | `mysql`, `redpanda`, `mongodb`, `otel-demo-nodejs`, `otel-demo-python` |
+| **Tags**      | `language`, `java`, `maven`, `gradle`                                  |
+| **Ports**     | 8080, 8081                                                             |
 
 ### Jupyter (`jupyter`)
 
@@ -65,26 +69,15 @@ Jupyter notebook server for interactive computing and data science
 | **Tags**     | `language`, `jupyter`, `python`, `notebook`, `data-science` |
 | **Ports**    | 8888                                                        |
 
-### MkDocs (`mkdocs`)
-
-Material for MkDocs - professional documentation generator
-
-| Property      | Value                               |
-| ------------- | ----------------------------------- |
-| **Category**  | language                            |
-| **Requires**  | `python`                            |
-| **Conflicts** | `mkdocs2`                           |
-| **Tags**      | `documentation`, `mkdocs`, `python` |
-| **Ports**     | 8000                                |
-
 ### Node.js (`nodejs`)
 
 Node.js LTS with TypeScript and tooling
 
-| Property     | Value                                            |
-| ------------ | ------------------------------------------------ |
-| **Category** | language                                         |
-| **Tags**     | `language`, `nodejs`, `javascript`, `typescript` |
+| Property      | Value                                                            |
+| ------------- | ---------------------------------------------------------------- |
+| **Category**  | language                                                         |
+| **Conflicts** | `grafana`, `open-webui`, `mysql`, `redpanda`, `otel-demo-nodejs` |
+| **Tags**      | `language`, `nodejs`, `javascript`, `typescript`                 |
 
 ### PowerShell (`powershell`)
 
@@ -108,14 +101,27 @@ Python 3.12 with linting and formatting
 
 Rust stable with cargo, rustfmt, and clippy
 
-| Property     | Value                       |
-| ------------ | --------------------------- |
-| **Category** | language                    |
-| **Tags**     | `language`, `rust`, `cargo` |
-| **Ports**    | 8080, 3000                  |
+| Property      | Value                       |
+| ------------- | --------------------------- |
+| **Category**  | language                    |
+| **Conflicts** | `grafana`, `open-webui`     |
+| **Tags**      | `language`, `rust`, `cargo` |
+| **Ports**     | 8080, 3000                  |
 
 ## Database Overlays
 
+### Apache Jena Fuseki (`fuseki`)
+
+SPARQL 1.1 server and triplestore backed by Apache Jena TDB
+
+| Property     | Value                                                                             |
+| ------------ | --------------------------------------------------------------------------------- |
+| **Category** | database                                                                          |
+| **Supports** | compose                                                                           |
+| **Suggests** | `java`, `python`, `nodejs`                                                        |
+| **Tags**     | `database`, `rdf`, `sparql`, `triplestore`, `semantic-web`, `linked-data`, `jena` |
+| **Ports**    | 3030/http                                                                         |
+
 ### DuckDB (`duckdb`)
 
 In-process analytical database for OLAP workloads
@@ -130,45 +136,40 @@ In-process analytical database for OLAP workloads
 
 S3-compatible object storage with web console
 
-| Property     | Value                                                  |
-| ------------ | ------------------------------------------------------ |
-| **Category** | database                                               |
-| **Supports** | compose                                                |
-| **Tags**     | `database`, `storage`, `s3`, `object-storage`, `minio` |
-| **Ports**    | 9000, 9001                                             |
+| Property      | Value                                                  |
+| ------------- | ------------------------------------------------------ |
+| **Category**  | database                                               |
+| **Supports**  | compose                                                |
+| **Suggests**  | `prometheus`, `grafana`                                |
+| **Conflicts** | `localstack`                                           |
+| **Tags**      | `database`, `storage`, `s3`, `object-storage`, `minio` |
+| **Ports**     | 9000, 9001                                             |
 
 ### MongoDB (`mongodb`)
 
 MongoDB 8 with Mongo Express web UI
 
-| Property     | Value                                      |
-| ------------ | ------------------------------------------ |
-| **Category** | database                                   |
-| **Supports** | compose                                    |
-| **Tags**     | `database`, `nosql`, `mongodb`, `document` |
-| **Ports**    | 27017/tcp, 8081/http                       |
+| Property      | Value                                        |
+| ------------- | -------------------------------------------- |
+| **Category**  | database                                     |
+| **Supports**  | compose                                      |
+| **Suggests**  | `prometheus`, `grafana`                      |
+| **Conflicts** | `redpanda`, `otel-demo-python`, `go`, `java` |
+| **Tags**      | `database`, `nosql`, `mongodb`, `document`   |
+| **Ports**     | 27017/tcp, 8081/http                         |
 
 ### MySQL (`mysql`)
 
 MySQL 8 with phpMyAdmin web UI
 
-| Property     | Value                      |
-| ------------ | -------------------------- |
-| **Category** | database                   |
-| **Supports** | compose                    |
-| **Tags**     | `database`, `sql`, `mysql` |
-| **Ports**    | 3306/tcp, 8080/http        |
-
-### NATS (`nats`)
-
-Lightweight pub/sub messaging with JetStream
-
-| Property     | Value                                                  |
-| ------------ | ------------------------------------------------------ |
-| **Category** | database                                               |
-| **Supports** | compose                                                |
-| **Tags**     | `database`, `messaging`, `pubsub`, `nats`, `jetstream` |
-| **Ports**    | 4222/tcp, 8222/http                                    |
+| Property      | Value                                                                   |
+| ------------- | ----------------------------------------------------------------------- |
+| **Category**  | database                                                                |
+| **Supports**  | compose                                                                 |
+| **Suggests**  | `prometheus`, `grafana`                                                 |
+| **Conflicts** | `redpanda`, `nodejs`, `bun`, `go`, `java`, `dotnet`, `otel-demo-nodejs` |
+| **Tags**      | `database`, `sql`, `mysql`                                              |
+| **Ports**     | 3306/tcp, 8080/http                                                     |
 
 ### pgvector (PostgreSQL + vector) (`pgvector`)
 
@@ -178,7 +179,7 @@ PostgreSQL 16 with the pgvector extension for vector similarity search
 | ------------- | ----------------------------------------------------------------- |
 | **Category**  | database                                                          |
 | **Supports**  | compose                                                           |
-| **Suggests**  | `ollama`, `python`, `nodejs`                                      |
+| **Suggests**  | `ollama`, `python`, `nodejs`, `prometheus`, `grafana`             |
 | **Conflicts** | `postgres`                                                        |
 | **Tags**      | `database`, `sql`, `vector`, `embeddings`, `postgres`, `pgvector` |
 | **Ports**     | 5432/tcp                                                          |
@@ -191,6 +192,7 @@ PostgreSQL 16 database
 | ------------- | ----------------------------- |
 | **Category**  | database                      |
 | **Supports**  | compose                       |
+| **Suggests**  | `prometheus`, `grafana`       |
 | **Conflicts** | `pgvector`                    |
 | **Tags**      | `database`, `sql`, `postgres` |
 | **Ports**     | 5432/tcp                      |
@@ -199,24 +201,13 @@ PostgreSQL 16 database
 
 High-performance vector database for similarity search and embeddings
 
-| Property     | Value                                                  |
-| ------------ | ------------------------------------------------------ |
-| **Category** | database                                               |
-| **Supports** | compose                                                |
-| **Suggests** | `ollama`, `python`, `nodejs`                           |
-| **Tags**     | `database`, `vector`, `embeddings`, `search`, `qdrant` |
-| **Ports**    | 6333/http, 6334/grpc                                   |
-
-### RabbitMQ (`rabbitmq`)
-
-Message broker with AMQP protocol and management UI
-
-| Property     | Value                                                |
-| ------------ | ---------------------------------------------------- |
-| **Category** | database                                             |
-| **Supports** | compose                                              |
-| **Tags**     | `database`, `messaging`, `queue`, `rabbitmq`, `amqp` |
-| **Ports**    | 5672/tcp, 15672/http                                 |
+| Property     | Value                                                                   |
+| ------------ | ----------------------------------------------------------------------- |
+| **Category** | database                                                                |
+| **Supports** | compose                                                                 |
+| **Suggests** | `ollama`, `python`, `nodejs`, `prometheus`, `grafana`, `otel-collector` |
+| **Tags**     | `database`, `vector`, `embeddings`, `search`, `qdrant`                  |
+| **Ports**    | 6333/http, 6334/grpc                                                    |
 
 ### Redis (`redis`)
 
@@ -226,20 +217,10 @@ Redis 7 cache
 | ------------ | ---------------------------- |
 | **Category** | database                     |
 | **Supports** | compose                      |
+| **Suggests** | `prometheus`, `grafana`      |
 | **Tags**     | `database`, `cache`, `redis` |
 | **Ports**    | 6379/tcp                     |
 
-### Redpanda (`redpanda`)
-
-Kafka-compatible event streaming with web console
-
-| Property     | Value                                                     |
-| ------------ | --------------------------------------------------------- |
-| **Category** | database                                                  |
-| **Supports** | compose                                                   |
-| **Tags**     | `database`, `messaging`, `streaming`, `kafka`, `redpanda` |
-| **Ports**    | 9092, 8080, 8081, 8082, 9644                              |
-
 ### SQL Server (`sqlserver`)
 
 SQL Server 2022 for Linux
@@ -248,7 +229,7 @@ SQL Server 2022 for Linux
 | ------------ | ------------------------------------------- |
 | **Category** | database                                    |
 | **Supports** | compose                                     |
-| **Suggests** | `dotnet`                                    |
+| **Suggests** | `dotnet`, `prometheus`, `grafana`           |
 | **Tags**     | `database`, `sql`, `sqlserver`, `microsoft` |
 | **Ports**    | 1433                                        |
 
@@ -274,7 +255,7 @@ Distributed tracing backend
 | **Supports**  | compose                              |
 | **Conflicts** | `tempo`                              |
 | **Tags**      | `observability`, `tracing`, `jaeger` |
-| **Ports**     | 16686/http, 14250/grpc, 14268/http   |
+| **Ports**     | 16686/http                           |
 
 ### Loki (`loki`)
 
@@ -352,43 +333,66 @@ Log shipping agent for Loki with Docker auto-discovery
 
 Observability visualization dashboard with auto-provisioning
 
-| Property     | Value                                  |
-| ------------ | -------------------------------------- |
-| **Category** | observability                          |
-| **Supports** | compose                                |
-| **Requires** | `prometheus`                           |
-| **Suggests** | `loki`, `jaeger`, `tempo`, `promtail`  |
-| **Tags**     | `observability`, `ui`, `visualization` |
-| **Ports**    | 3000/http                              |
+| Property      | Value                                  |
+| ------------- | -------------------------------------- |
+| **Category**  | observability                          |
+| **Supports**  | compose                                |
+| **Requires**  | `prometheus`                           |
+| **Suggests**  | `loki`, `jaeger`, `tempo`, `promtail`  |
+| **Conflicts** | `open-webui`, `nodejs`, `bun`, `rust`  |
+| **Tags**      | `observability`, `ui`, `visualization` |
+| **Ports**     | 3000/http                              |
 
 ### OTel Demo (Node.js) (`otel-demo-nodejs`)
 
 Sample Node.js app with OpenTelemetry instrumentation
 
-| Property     | Value                                              |
-| ------------ | -------------------------------------------------- |
-| **Category** | observability                                      |
-| **Supports** | compose                                            |
-| **Requires** | `otel-collector`                                   |
-| **Suggests** | `jaeger`, `tempo`, `prometheus`, `loki`, `grafana` |
-| **Tags**     | `observability`, `demo`, `nodejs`, `opentelemetry` |
-| **Ports**    | 8080                                               |
+| Property      | Value                                                        |
+| ------------- | ------------------------------------------------------------ |
+| **Category**  | observability                                                |
+| **Supports**  | compose                                                      |
+| **Requires**  | `otel-collector`                                             |
+| **Suggests**  | `jaeger`, `tempo`, `prometheus`, `loki`, `grafana`           |
+| **Conflicts** | `mysql`, `redpanda`, `nodejs`, `bun`, `go`, `java`, `dotnet` |
+| **Tags**      | `observability`, `demo`, `nodejs`, `opentelemetry`           |
+| **Ports**     | 8080                                                         |
 
 ### OTel Demo (Python) (`otel-demo-python`)
 
 Sample Python Flask app with OpenTelemetry instrumentation
 
-| Property     | Value                                              |
-| ------------ | -------------------------------------------------- |
-| **Category** | observability                                      |
-| **Supports** | compose                                            |
-| **Requires** | `otel-collector`                                   |
-| **Suggests** | `jaeger`, `tempo`, `prometheus`, `loki`, `grafana` |
-| **Tags**     | `observability`, `demo`, `python`, `opentelemetry` |
-| **Ports**    | 8081                                               |
+| Property      | Value                                              |
+| ------------- | -------------------------------------------------- |
+| **Category**  | observability                                      |
+| **Supports**  | compose                                            |
+| **Requires**  | `otel-collector`                                   |
+| **Suggests**  | `jaeger`, `tempo`, `prometheus`, `loki`, `grafana` |
+| **Conflicts** | `mongodb`, `redpanda`, `go`, `java`                |
+| **Tags**      | `observability`, `demo`, `python`, `opentelemetry` |
+| **Ports**     | 8081                                               |
 
 ## Cloud Tool Overlays
 
+### Ansible (`ansible`)
+
+Automation and configuration management with Ansible and ansible-lint
+
+| Property     | Value                                         |
+| ------------ | --------------------------------------------- |
+| **Category** | cloud                                         |
+| **Suggests** | `aws-cli`, `azure-cli`, `gcloud`, `terraform` |
+| **Tags**     | `cloud`, `iac`, `automation`, `ansible`       |
+
+### Argo CD CLI (`argocd`)
+
+GitOps CLI for managing Argo CD applications and sync workflows
+
+| Property     | Value                                     |
+| ------------ | ----------------------------------------- |
+| **Category** | cloud                                     |
+| **Suggests** | `kubectl-helm`, `k3d`, `kind`             |
+| **Tags**     | `cloud`, `kubernetes`, `gitops`, `argocd` |
+
 ### AWS CLI (`aws-cli`)
 
 Amazon Web Services command-line tools
@@ -453,13 +457,14 @@ Kubernetes CLI and Helm package manager
 
 Local AWS cloud stack for development and testing
 
-| Property     | Value                                   |
-| ------------ | --------------------------------------- |
-| **Category** | cloud                                   |
-| **Supports** | compose                                 |
-| **Suggests** | `aws-cli`                               |
-| **Tags**     | `cloud`, `aws`, `testing`, `localstack` |
-| **Ports**    | 4566, 4571                              |
+| Property      | Value                                   |
+| ------------- | --------------------------------------- |
+| **Category**  | cloud                                   |
+| **Supports**  | compose                                 |
+| **Suggests**  | `aws-cli`                               |
+| **Conflicts** | `minio`                                 |
+| **Tags**      | `cloud`, `aws`, `testing`, `localstack` |
+| **Ports**     | 4566, 4571                              |
 
 ### Pulumi (`pulumi`)
 
@@ -549,7 +554,7 @@ Node-based image/video generation UI for Stable Diffusion and generative AI work
 | ------------ | -------------------------------------------------------------- |
 | **Category** | dev                                                            |
 | **Supports** | compose                                                        |
-| **Suggests** | `cuda`, `python`, `ollama`                                     |
+| **Suggests** | `cuda`, `rocm`, `python`, `ollama`                             |
 | **Tags**     | `dev`, `ai`, `image-generation`, `stable-diffusion`, `comfyui` |
 | **Ports**    | 8188                                                           |
 
@@ -673,6 +678,18 @@ Email testing tool with web UI and SMTP server
 | **Tags**     | `dev`, `email`, `smtp`, `testing` |
 | **Ports**    | 8025/http, 1025/tcp               |
 
+### MkDocs (`mkdocs`)
+
+Material for MkDocs - professional documentation generator
+
+| Property      | Value                               |
+| ------------- | ----------------------------------- |
+| **Category**  | dev                                 |
+| **Requires**  | `python`                            |
+| **Conflicts** | `mkdocs2`                           |
+| **Tags**      | `documentation`, `mkdocs`, `python` |
+| **Ports**     | 8000                                |
+
 ### MkDocs 2 (`mkdocs2`)
 
 MkDocs 2.0 pre-release (encode/mkdocs) — smart, simple website design tool
@@ -709,25 +726,37 @@ Secure tunneling for webhook testing and external access
 
 Local LLM inference server with OpenAI-compatible API
 
-| Property     | Value                                     |
-| ------------ | ----------------------------------------- |
-| **Category** | dev                                       |
-| **Supports** | compose                                   |
-| **Suggests** | `codex`, `claude-code`, `amp`             |
-| **Tags**     | `dev`, `ai`, `llm`, `inference`, `ollama` |
-| **Ports**    | 11434                                     |
+| Property     | Value                                                                    |
+| ------------ | ------------------------------------------------------------------------ |
+| **Category** | dev                                                                      |
+| **Supports** | compose                                                                  |
+| **Requires** | `ollama-cli`                                                             |
+| **Suggests** | `codex`, `claude-code`, `amp`, `prometheus`, `grafana`, `otel-collector` |
+| **Tags**     | `dev`, `ai`, `llm`, `inference`, `ollama`                                |
+| **Ports**    | 11434                                                                    |
+
+### Ollama CLI (`ollama-cli`)
+
+Ollama command-line client for local or remote Ollama servers
+
+| Property     | Value                                   |
+| ------------ | --------------------------------------- |
+| **Category** | dev                                     |
+| **Suggests** | `ollama`, `codex`, `claude-code`, `amp` |
+| **Tags**     | `dev`, `ai`, `llm`, `ollama`, `cli`     |
 
 ### Open WebUI (`open-webui`)
 
 Browser-based chat UI for Ollama and OpenAI-compatible LLM backends
 
-| Property     | Value                                         |
-| ------------ | --------------------------------------------- |
-| **Category** | dev                                           |
-| **Supports** | compose                                       |
-| **Suggests** | `ollama`                                      |
-| **Tags**     | `dev`, `ai`, `llm`, `ui`, `chat`, `openwebui` |
-| **Ports**    | 3000/http                                     |
+| Property      | Value                                         |
+| ------------- | --------------------------------------------- |
+| **Category**  | dev                                           |
+| **Supports**  | compose                                       |
+| **Suggests**  | `ollama`, `prometheus`, `otel-collector`      |
+| **Conflicts** | `grafana`, `nodejs`, `bun`, `rust`            |
+| **Tags**      | `dev`, `ai`, `llm`, `ui`, `chat`, `openwebui` |
+| **Ports**     | 3000/http                                     |
 
 ### OpenAPI Tools (`openapi-tools`)
 
@@ -756,6 +785,7 @@ Browser automation and testing framework
 | Property     | Value                       |
 | ------------ | --------------------------- |
 | **Category** | dev                         |
+| **Requires** | `nodejs`                    |
 | **Tags**     | `dev`, `testing`, `browser` |
 
 ### Pre-commit Framework (`pre-commit`)
@@ -776,6 +806,7 @@ AMD ROCm libraries and GPU passthrough for containerized ML/inference workloads
 | Property      | Value                                          |
 | ------------- | ---------------------------------------------- |
 | **Category**  | dev                                            |
+| **Suggests**  | `comfyui`                                      |
 | **Conflicts** | `cuda`                                         |
 | **Tags**      | `dev`, `gpu`, `rocm`, `amd`, `ml`, `inference` |
 
@@ -790,6 +821,16 @@ Continuous development and deployment pipeline for Kubernetes applications
 | **Conflicts** | `tilt`                                                       |
 | **Tags**      | `dev`, `kubernetes`, `k8s`, `cicd`, `deployment`, `skaffold` |
 
+### Taskfile (task) (`task`)
+
+Modern task runner and build tool using Taskfiles
+
+| Property     | Value                                    |
+| ------------ | ---------------------------------------- |
+| **Category** | dev                                      |
+| **Suggests** | `modern-cli-tools`, `kubectl-helm`       |
+| **Tags**     | `dev`, `automation`, `taskfile`, `build` |
+
 ### Tilt (`tilt`)
 
 Live update and orchestration for Kubernetes development

package/docs/specs/001-verbose-plan-graph/spec.md

@@ -1,18 +1,11 @@
 # Feature Specification: Verbose Plan Graph
 
-**Feature Branch**: `001-verbose-plan-graph`  
+**Spec ID**: `001-verbose-plan-graph`
 **Created**: 2026-03-10  
 **Status**: Final  
 **Input**: User description: "Extend the plan command with a --verbose flag that narrates the dependency resolution graph — explaining why each overlay was included, not just what was included. The principle: nothing here is magic. Scope update: it should also be possible to run plan including --verbose on an existing manifest."
 
-## Review & Approval _(mandatory before implementation)_
-
-- **Spec Path**: `docs/specs/001-verbose-plan-graph/spec.md`
-- **Commit Status**: Committed
-- **Review Status**: APPROVED
-- **Implementation Gate**: No implementation code may begin until this spec is committed and reviewed.
-
-## User Scenarios & Testing _(mandatory)_
+## User Scenarios & Testing
 
 ### User Story 1 - Explain auto-included overlays (Priority: P1)
 
@@ -80,7 +73,7 @@ A user who only wants a quick summary should still be able to run the plan comma
 - The user requests an invalid or unknown overlay and the plan must fail with a clear message instead of producing partial explanation data.
 - A user attempts to plan from a missing or invalid manifest and the command must fail with a clear message instead of producing incomplete verbose explanation output.
 
-## Requirements _(mandatory)_
+## Requirements
 
 ### Functional Requirements
 
@@ -110,14 +103,14 @@ A user who only wants a quick summary should still be able to run the plan comma
 - Existing conflict and validation behavior remains in scope; this feature only expands how the reasoning is presented.
 - Existing manifest-driven workflows should use the same explanation model as direct overlay selection rather than introducing a separate reasoning format.
 
-## Dependencies & Impact _(mandatory)_
+## Dependencies & Impact
 
 - **Affected Areas**: CLI command behavior, manifest-driven planning workflows, plan output, discovery documentation, CHANGELOG.md, automated tests
 - **Compatibility Impact**: Backward compatible
 - **Required Documentation Updates**: README.md, discovery command documentation, CHANGELOG.md
 - **Verification Plan**: Unit tests for inclusion-reason reporting, command-level tests for verbose and non-verbose output, manifest-driven planning validation, and manual validation with direct, transitive, duplicate-path, manifest, and failure scenarios
 
-## Success Criteria _(mandatory)_
+## Success Criteria
 
 ### Measurable Outcomes
 

package/docs/specs/002-superposition-config-file/spec.md

@@ -1,6 +1,6 @@
 # Feature Specification: Project Configuration File
 
-**Feature Branch**: `002-superposition-config-file`  
+**Spec ID**: `002-superposition-config-file`
 **Created**: 2026-03-11  
 **Status**: Final  
 **Input**: Add a repository-root project config file so teams and automation can generate the same environment from committed declarative setup instead of reconstructing long CLI commands.
@@ -8,14 +8,7 @@
 > Use repo-relative Markdown links for repository files. The root `README.md`
 > is the only exception and may use package-friendly hosted URLs.
 
-## Review & Approval _(mandatory before implementation)_
-
-- **Spec Path**: `docs/specs/002-superposition-config-file/spec.md`
-- **Commit Status**: Committed
-- **Review Status**: Approved
-- **Implementation Gate**: No implementation code may begin until this spec is committed and reviewed.
-
-## User Scenarios & Testing _(mandatory)_
+## User Scenarios & Testing
 
 ### User Story 1 - Generate from committed project config (Priority: P1)
 
@@ -77,7 +70,7 @@ A contributor receives clear guidance when the project config file is invalid, i
 - How does the system handle `adopt --project-file` when a repository already contains a supported project config file? It reuses that file path, and it must still stop on dual-file ambiguity so the source of truth stays deterministic.
 - How does the system handle project-file or manifest discovery from outside the target repository? An explicit project-root option may redirect persisted-input discovery and relative output resolution to that repository root.
 
-## Requirements _(mandatory)_
+## Requirements
 
 ### Functional Requirements
 
@@ -110,7 +103,7 @@ A contributor receives clear guidance when the project config file is invalid, i
 - **Customization Input**: A supported user-configurable generation setting beyond basic stack and overlay selection, such as custom container definitions, environment-related settings, or additional generated features that alter the final output.
 - **Validation Result**: The user-facing outcome of checking the project config file, including syntax problems, unsupported entries, conflict findings, ambiguity conditions, and corrective guidance.
 
-## Dependencies & Impact _(mandatory)_
+## Dependencies & Impact
 
 - **Affected Areas**: Standard initialization workflow, clean-generation parity, supported customization handling, manifest-based regeneration boundaries, project-file based regeneration boundaries, CLI usage patterns, onboarding workflow, CI/CD workflow, user documentation
 - **Compatibility Impact**: Backward compatible
@@ -124,7 +117,7 @@ A contributor receives clear guidance when the project config file is invalid, i
 - `--from-project` and `--from-manifest` are mutually exclusive persisted-input modes rather than additive sources for one run.
 - A single repository should contain at most one supported project config file so the source of truth stays deterministic and easy to explain.
 
-## Success Criteria _(mandatory)_
+## Success Criteria
 
 ### Measurable Outcomes
 

package/docs/specs/003-mkdocs2-overlay/spec.md

@@ -1,18 +1,11 @@
 # Feature Specification: MkDocs 2.x Overlay
 
-**Feature Branch**: `copilot/add-mkdocs2-overlay`
+**Spec ID**: `003-mkdocs2-overlay`
 **Created**: 2026-03-16
 **Status**: Final
 **Input**: Add a new `mkdocs2` overlay that installs MkDocs 2.x with the Material theme via direct `pip` install, keeping the existing `mkdocs` (MkDocs 1.x) overlay untouched for backward compatibility.
 
-## Review & Approval _(mandatory before implementation)_
-
-- **Spec Path**: `docs/specs/003-mkdocs2-overlay/spec.md`
-- **Commit Status**: Committed
-- **Review Status**: Approved
-- **Implementation Gate**: No implementation code may begin until this spec is committed and reviewed.
-
-## User Scenarios & Testing _(mandatory)_
+## User Scenarios & Testing
 
 ### User Story 1 - Use MkDocs 2.x in a devcontainer (Priority: P1)
 

package/docs/specs/004-doctor-fix/spec.md

@@ -1,17 +1,10 @@
 # Feature Specification: `doctor --fix` — Interactive Auto-Repair
 
-**Feature Branch**: `004-doctor-fix`
+**Spec ID**: `004-doctor-fix`
 **Created**: 2026-03-19
 **Status**: Final
 **Input**: GitHub issue: Implement `doctor --fix` — interactive auto-repair for environment issues
 
-## Review & Approval _(mandatory before implementation)_
-
-- **Spec Path**: `docs/specs/004-doctor-fix/spec.md`
-- **Commit Status**: Committed
-- **Review Status**: APPROVED
-- **Implementation Gate**: No implementation code may begin until this spec is committed and reviewed.
-
 ## Summary
 
 The `doctor` command validates the environment. The `--fix` path was a placeholder. This spec