@wefter/opencode 0.2.0 → 0.3.0

package/docs/INSTALLATION.md

@@ -1,47 +1,56 @@
-# Installation
-
-From a published package:
-
-```bash
-npx @wefter/opencode init
-```
-
-From a local checkout:
-
-```bash
-node <path-to-opencode-wefter>/bin/wefter.js init --target <path-to-project> --yes
-```
-
-Then restart OpenCode and run:
-
-```text
-/wefter-generate-doc-audit-profile
-/wefter-shape-product
-/wefter-audit-docs
-/wefter-repair-docs
-/wefter-run-work-unit
-```
-
-Validate an installation with:
-
-```bash
-wefter doctor
-```
-
-Import an existing repository-specific documentation audit profile, such as a legacy `docs/audits/lenses.json`, with:
-
-```bash
-wefter profile import --source docs/audits/lenses.json --force
-```
-
-Run a one-off audit with a repository-specific profile without changing config:
-
-```bash
-wefter docs audit --profile-path docs/audits/lenses.json --passes-per-lens 1 --max-audits 12
-```
-
-Generate a documentation repair run from a validated audit report with:
-
-```bash
-wefter docs repair --audit-report .audit/wefter/documentation-audit/<run-id>/final/final-documentation-audit-report.md
-```
+# Installation
+
+From a published package:
+
+```bash
+npx @wefter/opencode init
+```
+
+From a local checkout:
+
+```bash
+node <path-to-wefter>/bin/wefter.js init --target <path-to-project> --yes
+```
+
+Then restart OpenCode and run:
+
+```text
+/wefter-generate-doc-audit-profile
+/wefter-shape-product
+/wefter-audit-docs
+/wefter-repair-docs
+/wefter-run-work-unit
+```
+
+Validate an installation with:
+
+```bash
+wefter doctor
+```
+
+Preview and remove an installation with:
+
+```bash
+wefter uninstall --dry-run
+wefter uninstall --yes
+```
+
+`uninstall` uses `.wefter/install-manifest.json` and removes only unchanged Wefter-managed files unless `--force` is used. It also removes Wefter commands and watcher ignores from `opencode.json` without deleting unrelated user configuration.
+
+Import an existing repository-specific documentation audit profile, such as a legacy `docs/audits/lenses.json`, with:
+
+```bash
+wefter profile import --source docs/audits/lenses.json --force
+```
+
+Run a one-off audit with a repository-specific profile without changing config:
+
+```bash
+wefter docs audit --profile-path docs/audits/lenses.json --passes-per-lens 1 --max-audits 12
+```
+
+Generate a documentation repair run from a validated audit report with:
+
+```bash
+wefter docs repair --audit-report .audit/wefter/documentation-audit/<run-id>/final/final-documentation-audit-report.md
+```

package/docs/ROADMAP.md

@@ -0,0 +1,48 @@
+# Roadmap
+
+Wefter development should move in small workflow releases. Each release must preserve installed-project compatibility unless a migration path is explicit.
+
+## Current Foundation
+
+- `product-shaping` is available and produces `DELIVERABLES.md` as the product handoff.
+- `work-unit-implementation` remains the executable implementation engine under legacy vocabulary.
+- `technical-shaping` is registered as planned metadata only; it must not install commands until implemented.
+- `init` records installed files in `.wefter/install-manifest.json`; `uninstall` removes manifest-recorded files safely.
+
+## Next Release Order
+
+1. `delivery-implementation-migration`
+2. `technical-shaping-foundation`
+3. CLI modularization and schema validation hardening
+
+## Delivery Implementation Migration
+
+Goal: migrate vocabulary and defaults from `work-unit-implementation` toward `delivery-implementation` without breaking existing installations.
+
+Required decisions:
+
+- Whether `DELIVERABLES.md` becomes the default implementation source document.
+- Which legacy command aliases remain and for how long.
+- Whether schemas are renamed, aliased or versioned in place.
+- How OpenCode agent names transition without invalidating existing configs.
+
+Non-goals:
+
+- Do not remove `work-unit` commands in the first migration release.
+- Do not change product-shaping responsibilities.
+- Do not create technical design artifacts in delivery implementation.
+
+## Technical Shaping Foundation
+
+Goal: define a workflow between product-shaped deliverables and delivery implementation.
+
+Required outputs:
+
+- Technical decisions and constraints.
+- Data contracts and interface expectations.
+- Verification strategy for delivery implementation.
+- Explicit human gates for architecture, security, persistence and migration decisions.
+
+Activation rule:
+
+`technical-shaping` commands stay in `plannedCommands` until the workflow has process docs, config/profile defaults, prompt templates, agents, schemas, CLI run generation and validation tests.

package/docs/SAFETY_MODEL.md

@@ -1,17 +1,18 @@
-# Safety Model
-
-Wefter workflows are designed as gated loops, not free-form agent prompts.
-
-Core rules:
-
-- Detection and correction are separate workflows.
-- Documentation audit agents must not edit source documentation.
-- Documentation repair must plan before editing and pause on unresolved human decisions.
-- Runtime artifacts are written under workflow-specific configured roots: legacy audit, repair and work-unit workflows default to `.audit/wefter/`, while product-shaping defaults to `.wefter/runs/`.
-- Versioned workflow configuration is written under `.wefter/` by default.
-- Paths are target-repository relative and must not contain `..`.
-- Run directories are staged before becoming visible as final runs.
-- OpenCode agent permissions restrict write access to configured artifact paths.
-- Implementation work must be task-level, reviewed and validated before moving to the next work unit.
-
-OpenCode must be restarted after installing or changing agents, skills or commands.
+# Safety Model
+
+Wefter workflows are designed as gated loops, not free-form agent prompts.
+
+Core rules:
+
+- Detection and correction are separate workflows.
+- Documentation audit agents must not edit source documentation.
+- Documentation repair must plan before editing and pause on unresolved human decisions.
+- Runtime artifacts are written under workflow-specific configured roots: legacy audit, repair and work-unit workflows default to `.audit/wefter/`, while product-shaping defaults to `.wefter/runs/`.
+- Versioned workflow configuration is written under `.wefter/` by default.
+- Paths are target-repository relative and must not contain `..`.
+- Run directories are staged before becoming visible as final runs.
+- Installations write `.wefter/install-manifest.json`; uninstall removes manifest-recorded files only when unchanged unless `--force` is explicit.
+- OpenCode agent permissions restrict write access to configured artifact paths.
+- Implementation work must be task-level, reviewed and validated before moving to the next work unit.
+
+OpenCode must be restarted after installing or changing agents, skills or commands.

package/docs/SELF_AUDIT.md

@@ -1,35 +1,37 @@
-# Self Audit
-
-Wefter can run `documentation-audit` against its own workflow source before publishing a workflow as available.
-
-The CLI command generates the audit run and auditor prompts. It does not execute the prompts by itself; a documentation-audit orchestrator or agent must resume the generated run and complete the raw audit, consolidation and validation steps.
-
-Use this pattern for any workflow-specific audit profile:
-
-```bash
-node bin/wefter.js docs audit --profile-path <workflow-audit-profile.json> --run-name <workflow-id>-self-audit --passes-per-lens 1 --max-audits 0
-```
-
-`--max-audits 0` means no audit prompt cap.
-
-Product-shaping example:
-
-```bash
-node bin/wefter.js docs audit --profile-path src/workflows/product-shaping/templates/documentation-audit-profile.json --run-name product-shaping-self-audit --passes-per-lens 1 --max-audits 0
-```
-
-Seed prompt:
-
-```text
-Audit the current workflow release against CHANGELOG.md and the workflow README.
-Focus on doctrine drift, missing runtime enforcement, handoff or gate bypasses, OpenCode execution gaps, schema/contract mismatch, weak tests and release artifacts that should not be committed.
-Treat prior review findings as hypotheses, not conclusions.
-```
-
-After the run is generated, resume it with:
-
-```text
-Resume the documentation audit run at .wefter/runs/documentation-audit/<run-id>.
-Read manifest.json, execute every auditor prompt listed there, write each raw output to its assigned path, then run prompts/consolidate.md and prompts/validate.md.
-Do not edit source files. Write only under the run directory.
-```
+# Self Audit
+
+Wefter can run `documentation-audit` against its own workflow source before publishing a workflow as available.
+
+The CLI command generates the audit run and auditor prompts. It does not execute the prompts by itself; a documentation-audit orchestrator or agent must resume the generated run and complete the raw audit, consolidation and validation steps.
+
+Use this pattern for any workflow-specific audit profile:
+
+```bash
+node bin/wefter.js docs audit --profile-path <workflow-audit-profile.json> --run-name <workflow-id>-self-audit --passes-per-lens 1 --max-audits 0
+```
+
+`--max-audits 0` means no audit prompt cap.
+
+Product-shaping example:
+
+```bash
+node bin/wefter.js docs audit --profile-path src/workflows/product-shaping/templates/documentation-audit-profile.json --run-name product-shaping-self-audit --passes-per-lens 1 --max-audits 0
+```
+
+The Wefter repository dogfoods documentation-audit with `artifactRoot` set to `.wefter/runs/documentation-audit` in its local `wefter.config.json`. Installed projects use the public default `.audit/wefter/documentation-audit` unless their config overrides it.
+
+Seed prompt:
+
+```text
+Audit the current workflow release against CHANGELOG.md and the workflow README.
+Focus on doctrine drift, missing runtime enforcement, handoff or gate bypasses, OpenCode execution gaps, schema/contract mismatch, weak tests and release artifacts that should not be committed.
+Treat prior review findings as hypotheses, not conclusions.
+```
+
+After the run is generated, resume it with:
+
+```text
+Resume the documentation audit run at .wefter/runs/documentation-audit/<run-id>.
+Read manifest.json, execute every auditor prompt listed there, write each raw output to its assigned path, then run prompts/consolidate.md and prompts/validate.md.
+Do not edit source files. Write only under the run directory.
+```

package/docs/WORKFLOWS.md

@@ -1,15 +1,17 @@
-# Workflows
-
-Wefter workflow IDs are stable nouns. CLI and OpenCode commands use verbs.
-
-| Workflow ID | CLI | OpenCode | Status |
-| --- | --- | --- | --- |
-| `product-shaping` | `wefter product shape`, `wefter product validate` | `/wefter-shape-product` | Available |
-| `documentation-audit` | `wefter docs audit` | `/wefter-audit-docs` | Available |
-| `documentation-repair` | `wefter docs repair` | `/wefter-repair-docs` | Available |
-| `technical-shaping` | `wefter technical shape` | `/wefter-shape-technical` | Planned |
-| `work-unit-implementation` | `wefter work-unit run`, `wefter work-unit guard` | `/wefter-run-work-unit` | Available |
-
-The `0.2.0` release promotes `product-shaping` to available. `documentation-audit` remains executable end-to-end. `documentation-repair` can generate repair runs from final audit reports with planning, human-decision gates, repair application and review prompts. `work-unit-implementation` can generate planning runs, orchestrate plan review, enforce deterministic task/review guards and validate a completed work unit.
-
-For workflow dogfooding and release self-audit, see `docs/SELF_AUDIT.md`.
+# Workflows
+
+Wefter workflow IDs are stable nouns. CLI and OpenCode commands use verbs.
+
+| Workflow ID | CLI | OpenCode | Status |
+| --- | --- | --- | --- |
+| `product-shaping` | `wefter product shape`, `wefter product validate` | `/wefter-shape-product` | Available |
+| `documentation-audit` | `wefter docs audit` | `/wefter-audit-docs` | Available |
+| `documentation-repair` | `wefter docs repair` | `/wefter-repair-docs` | Available |
+| `technical-shaping` | Not installed while planned | Not installed while planned | Planned |
+| `work-unit-implementation` | `wefter work-unit run`, `wefter work-unit guard` | `/wefter-run-work-unit` | Available |
+
+The `0.2.0` release promotes `product-shaping` to available. `documentation-audit` remains executable end-to-end. `documentation-repair` can generate repair runs from final audit reports with planning, human-decision gates, repair application and review prompts. `work-unit-implementation` can generate planning runs, orchestrate plan review, enforce deterministic task/review guards and validate a completed work unit.
+
+Planned workflows may document future command names in their workflow manifest, but only commands under `commands` are executable/installed. `technical-shaping` is intentionally not installed until its contract and CLI are implemented.
+
+For workflow dogfooding and release self-audit, see `docs/SELF_AUDIT.md`.

package/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "@wefter/opencode",
-  "version": "0.2.0",
-  "description": "Installable Wefter workflows for OpenCode projects.",
-  "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "git+ssh://git@github.com/Wuerike/wefter.git"
-  },
-  "bugs": {
-    "url": "https://github.com/Wuerike/wefter/issues"
-  },
-  "homepage": "https://github.com/Wuerike/wefter#readme",
-  "bin": {
-    "wefter": "bin/wefter.js"
-  },
-  "scripts": {
-    "check": "node --check bin/wefter.js && node --check src/cli/main.js",
-    "doctor:self": "node bin/wefter.js --help",
-    "test": "node --test"
-  },
-  "keywords": [
-    "opencode",
-    "wefter",
-    "documentation",
-    "audit",
-    "workflow",
-    "llm"
-  ],
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=18.17"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "schemas/",
-    "docs/",
-    "CHANGELOG.md",
-    "README.md"
-  ]
-}
+{
+  "name": "@wefter/opencode",
+  "version": "0.3.0",
+  "description": "Installable Wefter workflows for OpenCode projects.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Wuerike/wefter.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Wuerike/wefter/issues"
+  },
+  "homepage": "https://github.com/Wuerike/wefter#readme",
+  "bin": {
+    "wefter": "bin/wefter.js"
+  },
+  "scripts": {
+    "check": "node --check bin/wefter.js && node --check src/cli/main.js",
+    "doctor:self": "node bin/wefter.js --help",
+    "test": "node --test"
+  },
+  "keywords": [
+    "opencode",
+    "wefter",
+    "documentation",
+    "audit",
+    "workflow",
+    "llm"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.17"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "schemas/",
+    "docs/",
+    "CHANGELOG.md",
+    "README.md"
+  ]
+}

package/schemas/documentation-audit-profile.schema.json

@@ -1,55 +1,55 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://wefter.dev/schemas/documentation-audit-profile.schema.json",
-  "type": "object",
-  "required": ["version", "corpus", "variants", "lenses"],
-  "properties": {
-    "version": { "const": 1 },
-    "auditorPromptPath": { "$ref": "#/$defs/relativePath" },
-    "corpus": {
-      "type": "object",
-      "required": ["include", "exclude"],
-      "properties": {
-        "include": { "type": "array", "items": { "type": "string", "minLength": 1 } },
-        "exclude": { "type": "array", "items": { "type": "string", "minLength": 1 } }
-      },
-      "additionalProperties": false
-    },
-    "variants": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["id", "title", "instruction"],
-        "properties": {
-          "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
-          "title": { "type": "string", "minLength": 1 },
-          "instruction": { "type": "string", "minLength": 1 }
-        },
-        "additionalProperties": false
-      }
-    },
-    "lenses": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["id", "title", "focus"],
-        "properties": {
-          "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
-          "title": { "type": "string", "minLength": 1 },
-          "focus": { "type": "string", "minLength": 1 }
-        },
-        "additionalProperties": false
-      }
-    }
-  },
-  "additionalProperties": false,
-  "$defs": {
-    "relativePath": {
-      "type": "string",
-      "minLength": 1,
-      "pattern": "^(?![A-Za-z]:)(?![\\\\/])(?!.*(?:^|/)\\.\\.(?:/|$))[^\\\\\r\n]+$"
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://wefter.dev/schemas/documentation-audit-profile.schema.json",
+  "type": "object",
+  "required": ["version", "corpus", "variants", "lenses"],
+  "properties": {
+    "version": { "const": 1 },
+    "auditorPromptPath": { "$ref": "#/$defs/relativePath" },
+    "corpus": {
+      "type": "object",
+      "required": ["include", "exclude"],
+      "properties": {
+        "include": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "exclude": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+      },
+      "additionalProperties": false
+    },
+    "variants": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "title", "instruction"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+          "title": { "type": "string", "minLength": 1 },
+          "instruction": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    },
+    "lenses": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "title", "focus"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+          "title": { "type": "string", "minLength": 1 },
+          "focus": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "relativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?![A-Za-z]:)(?![\\\\/])(?!.*(?:^|/)\\.\\.(?:/|$))[^\\\\\r\n]+$"
+    }
+  }
+}

package/schemas/install-manifest.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://wefter.dev/schemas/install-manifest.schema.json",
+  "type": "object",
+  "required": ["version", "packageName", "packageVersion", "generatedAt", "files", "managedOpencode"],
+  "properties": {
+    "version": { "const": 1 },
+    "packageName": { "const": "@wefter/opencode" },
+    "packageVersion": { "type": "string", "minLength": 1 },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "sha256"],
+        "properties": {
+          "path": { "$ref": "#/$defs/relativePath" },
+          "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "managedOpencode": {
+      "type": "object",
+      "required": ["commands", "skillsPath", "watcherIgnores"],
+      "properties": {
+        "commands": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "skillsPath": { "$ref": "#/$defs/relativePath" },
+        "watcherIgnores": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "relativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?![A-Za-z]:)(?![\\\\/])(?!.*(?:^|[\\\\/])\\.\\.(?:[\\\\/]|$))[^\r\n]+$"
+    }
+  }
+}