@wefter/opencode 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,25 +1,43 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-## 0.2.0 - 2026-06-02
-
-Promotes `product-shaping` to an available workflow.
-
-- Added available-by-default product-shaping workflow installation, CLI run generation, OpenCode command, agents, skill, prompts, contracts and schemas.
-- Added product-shaping completion gate validation for required specs, ready deliverables, adversarial review evidence and final validation evidence.
-- Added `DELIVERABLES.md` handoff validation before legacy work-unit implementation can consume product-shaping output.
-- Added product-shaping doctrine autoaudit profile and repaired audit findings across schemas, prompts, agents, CLI behavior and docs.
-- Hardened product-shaping schemas and runtime checks for canonical file order, vocabulary, relative paths, manifest outputs, handoff and gate evidence.
-- Expanded CLI tests for product-shaping availability, path safety, handoff validation and OpenCode installation.
-
-## 0.1.0 - 2026-06-02
-
-Initial public release of Wefter for OpenCode.
-
-- Added the `wefter` CLI for installing and validating OpenCode workflow packs.
-- Added documentation audit workflow generation, profile import, profile scaffolding, and doctor validation.
-- Added documentation repair workflow generation from validated audit reports.
-- Added work-unit implementation workflow generation and task/review guard validation.
-- Added reusable OpenCode agents, skills, commands, workflow manifests, prompt templates, and schemas.
-- Added path-safety checks and automated CLI tests for core workflow operations.
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## 0.3.0 - 2026-06-05
+
+- Added `.wefter/install-manifest.json` generation during `init` and a safe `wefter uninstall` command.
+- Added install manifest schema and documentation for previewing/removing Wefter-managed files.
+- Added roadmap and internal release specs for `delivery-implementation-migration` and `technical-shaping-foundation`.
+- Opted GitHub Actions workflows into Node 24 for JavaScript actions while preserving package test coverage across supported Node versions.
+
+## 0.2.1 - 2026-06-04
+
+Stabilizes the `0.2.x` workflow contracts after the product-shaping release.
+
+- Clarified that planned workflows do not install executable CLI or OpenCode commands until implemented.
+- Moved future `technical-shaping` command names to planning metadata instead of executable command metadata.
+- Hardened work-unit config and workflow manifest schemas to better match runtime validation.
+- Added per-command CLI flag validation so unsupported options fail fast instead of being silently ignored.
+- Added CI coverage across Node 18, 20, 22 and 24, and hardened manual npm publish inputs to require an existing tag.
+- Updated local development, installation and self-audit documentation to distinguish package defaults from Wefter dogfooding config.
+
+## 0.2.0 - 2026-06-02
+
+Promotes `product-shaping` to an available workflow.
+
+- Added available-by-default product-shaping workflow installation, CLI run generation, OpenCode command, agents, skill, prompts, contracts and schemas.
+- Added product-shaping completion gate validation for required specs, ready deliverables, adversarial review evidence and final validation evidence.
+- Added `DELIVERABLES.md` handoff validation before legacy work-unit implementation can consume product-shaping output.
+- Added product-shaping doctrine autoaudit profile and repaired audit findings across schemas, prompts, agents, CLI behavior and docs.
+- Hardened product-shaping schemas and runtime checks for canonical file order, vocabulary, relative paths, manifest outputs, handoff and gate evidence.
+- Expanded CLI tests for product-shaping availability, path safety, handoff validation and OpenCode installation.
+
+## 0.1.0 - 2026-06-02
+
+Initial public release of Wefter for OpenCode.
+
+- Added the `wefter` CLI for installing and validating OpenCode workflow packs.
+- Added documentation audit workflow generation, profile import, profile scaffolding, and doctor validation.
+- Added documentation repair workflow generation from validated audit reports.
+- Added work-unit implementation workflow generation and task/review guard validation.
+- Added reusable OpenCode agents, skills, commands, workflow manifests, prompt templates, and schemas.
+- Added path-safety checks and automated CLI tests for core workflow operations.

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Wuerike
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Wuerike
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,125 +1,128 @@
-# Wefter for OpenCode
-
-Wefter installs reusable OpenCode workflows that weave product intent into audited specs, executable tasks, and validated implementation.
-
-## Status
-
-Wefter is usable locally for `product-shaping`, `documentation-audit`, `documentation-repair`, and `work-unit-implementation`. Product shaping is available by default and includes CLI run generation, OpenCode integration, validation gates and audited `DELIVERABLES.md` handoff.
-
-## Package
-
-```text
-package: @wefter/opencode
-repo: opencode-wefter
-cli: wefter
-config: wefter.config.json
-local workflow files: .wefter/
-runtime artifacts: .audit/wefter/ for legacy workflows; .wefter/runs/ for product-shaping
-```
-
-## Workflows
-
-| Workflow ID | Status | Purpose |
-| --- | --- | --- |
-| `product-shaping` | Available | Shape an initial idea into product specs, release scope, acceptance criteria and deliverables. |
-| `documentation-audit` | Available | Run redundant, adversarial documentation consistency audits. |
-| `documentation-repair` | Available | Repair docs from a validated audit report without mixing detection and correction. |
-| `technical-shaping` | Planned | Convert product docs into explicit technical decisions and implementation constraints. |
-| `work-unit-implementation` | Available | Generate planning runs, orchestrate plan review, enforce task/review guards, and validate a work unit. |
-
-## Local Development
-
-```bash
-npm run check
-node bin/wefter.js --help
-```
-
-Install into another project from this checkout:
-
-```bash
-node <path-to-opencode-wefter>/bin/wefter.js init --target <path-to-project> --yes
-```
-
-## Intended User Flow
-
-```bash
-npx @wefter/opencode init
-```
-
-Restart OpenCode, then use the available default commands:
-
-```text
-/wefter-generate-doc-audit-profile
-/wefter-shape-product
-/wefter-audit-docs
-/wefter-repair-docs
-/wefter-run-work-unit
-```
-
-CLI checks are also available:
-
-```bash
-wefter doctor
-wefter product shape --dry-run
-wefter product validate --json
-wefter docs audit --passes-per-lens 1 --max-audits 12
-wefter docs audit --profile-path docs/audits/lenses.json --passes-per-lens 1 --max-audits 12
-wefter profile import --source docs/audits/lenses.json --force
-wefter docs repair --audit-report .audit/wefter/documentation-audit/<run-id>/final/final-documentation-audit-report.md
-wefter new-run documentation-audit --passes-per-lens 1 --max-audits 12
-```
-
-## Default Config
-
-```json
-{
-  "version": 1,
-  "workflowRoot": ".wefter/workflows",
-  "profilePath": ".wefter/workflows/documentation-audit/profile.json",
-  "artifactRoot": ".audit/wefter/documentation-audit",
-  "templateRoot": ".wefter/workflows/documentation-audit/templates",
-  "processDocPath": ".wefter/workflows/documentation-audit/README.md",
-  "runnerCommand": "node <path-to-wefter>/bin/wefter.js",
-  "workflows": {
-    "product-shaping": {
-      "status": "available",
-      "enabled": true,
-      "specRoot": ".wefter/specs",
-      "runRoot": ".wefter/runs/product-shaping",
-      "configPath": ".wefter/workflows/product-shaping/config.json",
-      "profilePath": ".wefter/workflows/product-shaping/profile.json"
-    },
-    "documentation-audit": { "status": "available", "enabled": true },
-    "documentation-repair": { "status": "available", "enabled": true },
-    "technical-shaping": { "status": "planned", "enabled": false },
-    "work-unit-implementation": {
-      "status": "available",
-      "enabled": true,
-      "configPath": ".wefter/workflows/work-unit-implementation/config.json",
-      "profilePath": ".wefter/workflows/work-unit-implementation/profile.json"
-    }
-  }
-}
-```
-
-## Safety Model
-
-- Installed audit agents render permissions using the configured artifact root and profile path.
-- `docs audit` writes through a staging directory and only moves the final run after all files are generated.
-- `docs audit --profile-path` can use a repository-specific audit profile for one run without changing `wefter.config.json`.
-- `profile import` validates and copies an existing repository-relative audit profile into the configured Wefter profile path.
-- `docs repair` writes through a staging directory and requires an existing repository-relative audit report path.
-- Paths in `wefter.config.json` must be relative to the target repository and must not contain `..`.
-- Run names are plain directory names and cannot contain path separators.
-- `product-shaping` writes versioned product specs under `.wefter/specs/` and runtime runs under `.wefter/runs/product-shaping/` by default.
-- `product validate` fails the publication/handoff gate when required product specs, blocking questions or deliverable statuses are invalid.
-- Audit execution must not edit source documentation; correction is a separate workflow.
-- Repair execution must pause when validated findings require unresolved human decisions.
-
-## Product Direction
-
-Next hardening steps after the `0.2.0` product-shaping release:
-
-1. Add installation manifest/uninstall support.
-2. Continue migration from legacy `work-unit-implementation` naming toward `delivery-implementation`.
-3. Harden release and package publishing automation.
+# Wefter for OpenCode
+
+Wefter installs reusable OpenCode workflows that weave product intent into audited specs, executable tasks, and validated implementation.
+
+## Status
+
+Wefter is usable locally for `product-shaping`, `documentation-audit`, `documentation-repair`, and `work-unit-implementation`. Product shaping is available by default and includes CLI run generation, OpenCode integration, validation gates and audited `DELIVERABLES.md` handoff.
+
+## Package
+
+```text
+package: @wefter/opencode
+repo: wefter
+cli: wefter
+config: wefter.config.json
+install manifest: .wefter/install-manifest.json
+local workflow files: .wefter/
+runtime artifacts: .audit/wefter/ for legacy workflows; .wefter/runs/ for product-shaping
+```
+
+## Workflows
+
+| Workflow ID | Status | Purpose |
+| --- | --- | --- |
+| `product-shaping` | Available | Shape an initial idea into product specs, release scope, acceptance criteria and deliverables. |
+| `documentation-audit` | Available | Run redundant, adversarial documentation consistency audits. |
+| `documentation-repair` | Available | Repair docs from a validated audit report without mixing detection and correction. |
+| `technical-shaping` | Planned | Convert product docs into explicit technical decisions and implementation constraints. |
+| `work-unit-implementation` | Available | Generate planning runs, orchestrate plan review, enforce task/review guards, and validate a work unit. |
+
+## Local Development
+
+```bash
+npm run check
+npm test
+node bin/wefter.js --help
+```
+
+Install into another project from this checkout:
+
+```bash
+node <path-to-wefter>/bin/wefter.js init --target <path-to-project> --yes
+```
+
+## Intended User Flow
+
+```bash
+npx @wefter/opencode init
+```
+
+Restart OpenCode, then use the available default commands:
+
+```text
+/wefter-generate-doc-audit-profile
+/wefter-shape-product
+/wefter-audit-docs
+/wefter-repair-docs
+/wefter-run-work-unit
+```
+
+CLI checks are also available:
+
+```bash
+wefter doctor
+wefter product shape --dry-run
+wefter product validate --json
+wefter docs audit --passes-per-lens 1 --max-audits 12
+wefter docs audit --profile-path docs/audits/lenses.json --passes-per-lens 1 --max-audits 12
+wefter profile import --source docs/audits/lenses.json --force
+wefter docs repair --audit-report .audit/wefter/documentation-audit/<run-id>/final/final-documentation-audit-report.md
+wefter new-run documentation-audit --passes-per-lens 1 --max-audits 12
+wefter uninstall --dry-run
+```
+
+## Default Config
+
+```json
+{
+  "version": 1,
+  "workflowRoot": ".wefter/workflows",
+  "profilePath": ".wefter/workflows/documentation-audit/profile.json",
+  "artifactRoot": ".audit/wefter/documentation-audit",
+  "templateRoot": ".wefter/workflows/documentation-audit/templates",
+  "processDocPath": ".wefter/workflows/documentation-audit/README.md",
+  "runnerCommand": "node <path-to-wefter>/bin/wefter.js",
+  "workflows": {
+    "product-shaping": {
+      "status": "available",
+      "enabled": true,
+      "specRoot": ".wefter/specs",
+      "runRoot": ".wefter/runs/product-shaping",
+      "configPath": ".wefter/workflows/product-shaping/config.json",
+      "profilePath": ".wefter/workflows/product-shaping/profile.json"
+    },
+    "documentation-audit": { "status": "available", "enabled": true },
+    "documentation-repair": { "status": "available", "enabled": true },
+    "technical-shaping": { "status": "planned", "enabled": false },
+    "work-unit-implementation": {
+      "status": "available",
+      "enabled": true,
+      "configPath": ".wefter/workflows/work-unit-implementation/config.json",
+      "profilePath": ".wefter/workflows/work-unit-implementation/profile.json"
+    }
+  }
+}
+```
+
+## Safety Model
+
+- Installed audit agents render permissions using the configured artifact root and profile path.
+- `docs audit` writes through a staging directory and only moves the final run after all files are generated.
+- `docs audit --profile-path` can use a repository-specific audit profile for one run without changing `wefter.config.json`.
+- `profile import` validates and copies an existing repository-relative audit profile into the configured Wefter profile path.
+- `docs repair` writes through a staging directory and requires an existing repository-relative audit report path.
+- `init` writes `.wefter/install-manifest.json` with checksums for installed files; `uninstall` removes only unchanged manifest-recorded files unless `--force` is used.
+- Paths in `wefter.config.json` must be relative to the target repository and must not contain `..`.
+- Run names are plain directory names and cannot contain path separators.
+- `product-shaping` writes versioned product specs under `.wefter/specs/` and runtime runs under `.wefter/runs/product-shaping/` by default.
+- `product validate` fails the publication/handoff gate when required product specs, blocking questions or deliverable statuses are invalid.
+- Audit execution must not edit source documentation; correction is a separate workflow.
+- Repair execution must pause when validated findings require unresolved human decisions.
+
+## Product Direction
+
+Next hardening steps after the `0.3.0` install-manifest release:
+
+1. Continue migration from legacy `work-unit-implementation` naming toward `delivery-implementation`.
+2. Implement `technical-shaping` only after its contract, CLI behavior and OpenCode command are ready.

package/bin/wefter.js

@@ -1,8 +1,8 @@
-#!/usr/bin/env node
-
-import { main } from "../src/cli/main.js";
-
-main().catch((error) => {
-  console.error(error.message);
-  process.exitCode = 1;
-});
+#!/usr/bin/env node
+
+import { main } from "../src/cli/main.js";
+
+main().catch((error) => {
+  console.error(error.message);
+  process.exitCode = 1;
+});

package/docs/ARCHITECTURE.md

@@ -1,75 +1,75 @@
-# Architecture
-
-Wefter separates reusable workflow infrastructure from repository-specific product, documentation and implementation intent.
-
-## Reusable Engine
-
-The reusable engine contains:
-
-- CLI command runner.
-- Workflow manifests.
-- OpenCode agents and skills.
-- Generic prompt templates.
-- Config, profile and run schemas.
-
-These files must not encode any single product domain.
-
-## Local Configuration
-
-`wefter.config.json` stores installation choices for one repository:
-
-- `workflowRoot`: versioned Wefter workflow files installed in the target repository.
-- `artifactRoot`: generated runtime output root for legacy audit workflows. Product-shaping uses its workflow-specific run root under `.wefter/runs/product-shaping` by default.
-- `profilePath`: project-specific documentation audit profile.
-- `templateRoot`: installed documentation audit prompt templates.
-- `processDocPath`: installed workflow documentation.
-- `runnerCommand`: command used by OpenCode orchestrators to invoke Wefter.
-- `workflows`: registry of available and planned workflow IDs, with workflow-specific paths such as work-unit `configPath` and `profilePath`.
-
-Paths are repository-relative and validated before use.
-
-## Workflow Modules
-
-Workflow modules live under `src/workflows/<workflow-id>/` and expose `workflow.json` as their contract. The initial architecture registers:
-
-- `product-shaping`
-- `documentation-audit`
-- `documentation-repair`
-- `technical-shaping`
-- `work-unit-implementation`
-
-`product-shaping` is available for product spec generation and gated `DELIVERABLES.md` handoff. `documentation-audit` is executable end-to-end through the CLI. `documentation-repair` generates gated repair runs from validated audit reports. `work-unit-implementation` can generate planning runs, install OpenCode agents, enforce deterministic task/review guards and validate completed work units.
-
-## Documentation Audit Run
-
-`wefter docs audit` reads config and profile, then writes a run under the configured artifact root.
-
-Run generation uses staging:
-
-```text
-<artifactRoot>/.tmp/<run-id>/
-  -> <artifactRoot>/<run-id>/
-```
-
-This avoids exposing partially generated final runs after an interrupted creation.
-
-## Documentation Repair Run
-
-`wefter docs repair --audit-report <path>` reads config and creates a run under `.audit/wefter/documentation-repair/`.
-
-Repair runs contain prompts for planning, applying approved repairs and reviewing the repaired documentation. The generated flow separates safe documentation edits from human-decision items and recommends a follow-up audit after repair.
-
-## OpenCode Integration
-
-The installer writes:
-
-- `.opencode/agent/wefter-doc-*.md`
-- `.opencode/agent/wefter-product-*.md`
-- `.opencode/agent/wefter-work-unit-*.md`
-- `.opencode/skills/documentation-audit/SKILL.md`
-- `.opencode/skills/documentation-repair/SKILL.md`
-- `.opencode/skills/product-shaping/SKILL.md`
-- `.opencode/skills/work-unit-implementation/SKILL.md`
-- `opencode.json` commands `/wefter-generate-doc-audit-profile`, `/wefter-shape-product`, `/wefter-audit-docs`, `/wefter-repair-docs` and `/wefter-run-work-unit`
-
-OpenCode must be restarted after installation because configuration is loaded once at startup.
+# Architecture
+
+Wefter separates reusable workflow infrastructure from repository-specific product, documentation and implementation intent.
+
+## Reusable Engine
+
+The reusable engine contains:
+
+- CLI command runner.
+- Workflow manifests.
+- OpenCode agents and skills.
+- Generic prompt templates.
+- Config, profile and run schemas.
+
+These files must not encode any single product domain.
+
+## Local Configuration
+
+`wefter.config.json` stores installation choices for one repository:
+
+- `workflowRoot`: versioned Wefter workflow files installed in the target repository.
+- `artifactRoot`: generated runtime output root for legacy audit workflows. Product-shaping uses its workflow-specific run root under `.wefter/runs/product-shaping` by default.
+- `profilePath`: project-specific documentation audit profile.
+- `templateRoot`: installed documentation audit prompt templates.
+- `processDocPath`: installed workflow documentation.
+- `runnerCommand`: command used by OpenCode orchestrators to invoke Wefter.
+- `workflows`: registry of available and planned workflow IDs, with workflow-specific paths such as work-unit `configPath` and `profilePath`.
+
+Paths are repository-relative and validated before use.
+
+## Workflow Modules
+
+Workflow modules live under `src/workflows/<workflow-id>/` and expose `workflow.json` as their contract. The initial architecture registers:
+
+- `product-shaping`
+- `documentation-audit`
+- `documentation-repair`
+- `technical-shaping`
+- `work-unit-implementation`
+
+`product-shaping` is available for product spec generation and gated `DELIVERABLES.md` handoff. `documentation-audit` is executable end-to-end through the CLI. `documentation-repair` generates gated repair runs from validated audit reports. `work-unit-implementation` can generate planning runs, install OpenCode agents, enforce deterministic task/review guards and validate completed work units.
+
+## Documentation Audit Run
+
+`wefter docs audit` reads config and profile, then writes a run under the configured artifact root.
+
+Run generation uses staging:
+
+```text
+<artifactRoot>/.tmp/<run-id>/
+  -> <artifactRoot>/<run-id>/
+```
+
+This avoids exposing partially generated final runs after an interrupted creation.
+
+## Documentation Repair Run
+
+`wefter docs repair --audit-report <path>` reads config and creates a run under `.audit/wefter/documentation-repair/`.
+
+Repair runs contain prompts for planning, applying approved repairs and reviewing the repaired documentation. The generated flow separates safe documentation edits from human-decision items and recommends a follow-up audit after repair.
+
+## OpenCode Integration
+
+The installer writes:
+
+- `.opencode/agent/wefter-doc-*.md`
+- `.opencode/agent/wefter-product-*.md`
+- `.opencode/agent/wefter-work-unit-*.md`
+- `.opencode/skills/documentation-audit/SKILL.md`
+- `.opencode/skills/documentation-repair/SKILL.md`
+- `.opencode/skills/product-shaping/SKILL.md`
+- `.opencode/skills/work-unit-implementation/SKILL.md`
+- `opencode.json` commands `/wefter-generate-doc-audit-profile`, `/wefter-shape-product`, `/wefter-audit-docs`, `/wefter-repair-docs` and `/wefter-run-work-unit`
+
+OpenCode must be restarted after installation because configuration is loaded once at startup.