bmm-opencode 1.5.0 → 1.6.0

package/_bmad/tea/workflows/testarch/trace/validation-report-20260127-095021.md

@@ -0,0 +1,73 @@
+---
+validationDate: 2026-01-27
+workflowName: testarch-trace
+workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/trace
+validationStatus: COMPLETE
+completionDate: 2026-01-27 10:03:10
+---
+
+# Validation Report: testarch-trace
+
+**Validation Started:** 2026-01-27 09:50:21
+**Validator:** BMAD Workflow Validation System (Codex)
+**Standards Version:** BMAD Workflow Standards
+
+## File Structure & Size
+
+- workflow.md present: YES
+- instructions.md present: YES
+- workflow.yaml present: YES
+- step files found: 8
+
+**Step File Sizes:**
+
+- steps-c/step-01-load-context.md: 73 lines [GOOD]
+- steps-c/step-02-discover-tests.md: 62 lines [GOOD]
+- steps-c/step-03-map-criteria.md: 58 lines [GOOD]
+- steps-c/step-04-analyze-gaps.md: 57 lines [GOOD]
+- steps-c/step-05-gate-decision.md: 66 lines [GOOD]
+- steps-e/step-01-assess.md: 51 lines [GOOD]
+- steps-e/step-02-apply-edit.md: 46 lines [GOOD]
+- steps-v/step-01-validate.md: 53 lines [GOOD]
+- workflow-plan.md present: YES
+
+## Frontmatter Validation
+
+- No frontmatter violations found
+
+## Critical Path Violations
+
+- No {project-root} hardcoded paths detected in body
+- No dead relative links detected
+
+## Menu Handling Validation
+
+- No menu structures detected (linear step flow) [N/A]
+
+## Step Type Validation
+
+- Last step steps-v/step-01-validate.md has no nextStepFile (final step OK)
+- Step type validation assumes linear sequence (no branching/menu). Workflow-plan.md present for reference. [INFO]
+
+## Output Format Validation
+
+- Templates present: trace-template.md
+- Steps with outputFile in frontmatter:
+  - steps-c/step-05-gate-decision.md
+  - steps-v/step-01-validate.md
+
+## Validation Design Check
+
+- checklist.md present: YES
+- Validation steps folder (steps-v) present: YES
+
+## Instruction Style Check
+
+- All steps include STEP GOAL, MANDATORY EXECUTION RULES, EXECUTION PROTOCOLS, CONTEXT BOUNDARIES, and SUCCESS/FAILURE metrics
+
+## Summary
+
+- Validation completed: 2026-01-27 10:03:10
+- Critical issues: 0
+- Warnings: 0 (informational notes only)
+- Readiness: READY (manual review optional)

package/_bmad/tea/workflows/testarch/trace/validation-report-20260127-102401.md

@@ -0,0 +1,116 @@
+---
+validationDate: 2026-01-27
+workflowName: testarch-trace
+workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/trace
+validationStatus: COMPLETE
+completionDate: 2026-01-27 10:24:01
+---
+
+# Validation Report: testarch-trace
+
+**Validation Started:** 2026-01-27 10:24:01
+**Validator:** BMAD Workflow Validation System (Codex)
+**Standards Version:** BMAD Workflow Standards
+
+## File Structure & Size
+
+- workflow.md present: YES
+- instructions.md present: YES
+- workflow.yaml present: YES
+- step files found: 8
+
+**Step File Sizes:**
+
+- steps-c/step-01-load-context.md: 72 lines [GOOD]
+- steps-c/step-02-discover-tests.md: 61 lines [GOOD]
+- steps-c/step-03-map-criteria.md: 57 lines [GOOD]
+- steps-c/step-04-analyze-gaps.md: 56 lines [GOOD]
+- steps-c/step-05-gate-decision.md: 65 lines [GOOD]
+- steps-e/step-01-assess.md: 50 lines [GOOD]
+- steps-e/step-02-apply-edit.md: 45 lines [GOOD]
+- steps-v/step-01-validate.md: 52 lines [GOOD]
+- workflow-plan.md present: YES
+
+## Frontmatter Validation
+
+- No frontmatter violations found
+
+## Critical Path Violations
+
+### Config Variables (Exceptions)
+
+Standard BMAD config variables treated as valid exceptions: bmb_creations_output_folder, communication_language, document_output_language, output_folder, planning_artifacts, project-root, project_name, test_artifacts, user_name
+
+- No {project-root} hardcoded paths detected in body
+
+- No dead relative links detected
+
+- No module path assumptions detected
+
+**Status:** ✅ PASS - No critical violations
+
+## Menu Handling Validation
+
+- No menu structures detected (linear step flow) [N/A]
+
+## Step Type Validation
+
+- steps-c/step-01-load-context.md: Init [PASS]
+- steps-c/step-02-discover-tests.md: Middle [PASS]
+- steps-c/step-03-map-criteria.md: Middle [PASS]
+- steps-c/step-04-analyze-gaps.md: Middle [PASS]
+- steps-c/step-05-gate-decision.md: Final [PASS]
+- Step type validation assumes linear sequence (no branching/menu). Workflow-plan.md present for reference. [INFO]
+
+## Output Format Validation
+
+- Templates present: trace-template.md
+- Steps with outputFile in frontmatter:
+  - steps-c/step-05-gate-decision.md
+  - steps-v/step-01-validate.md
+- checklist.md present: YES
+
+## Validation Design Check
+
+- Validation steps folder (steps-v) present: YES
+- Validation step(s) present: step-01-validate.md
+- Validation steps reference checklist data and auto-proceed
+
+## Instruction Style Check
+
+- Instruction style: Prescriptive (appropriate for TEA quality/compliance workflows)
+- Steps emphasize mandatory sequence, explicit success/failure metrics, and risk-based guidance
+
+## Collaborative Experience Check
+
+- Overall facilitation quality: GOOD
+- Steps use progressive prompts and clear role reinforcement; no laundry-list interrogation detected
+- Flow progression is clear and aligned to workflow goals
+
+## Subprocess Optimization Opportunities
+
+- No high-priority subprocess optimizations identified; workflow already uses step-file architecture
+- Pattern 1 (grep/regex): N/A for most steps
+- Pattern 2 (per-file analysis): already aligned to validation structure
+- Pattern 3 (data ops): minimal data file loads
+- Pattern 4 (parallel): optional for validation only
+
+## Cohesive Review
+
+- Overall assessment: GOOD
+- Flow is linear, goals are clear, and outputs map to TEA artifacts
+- Voice and tone consistent with Test Architect persona
+- Recommendation: READY (minor refinements optional)
+
+## Plan Quality Validation
+
+- Plan file present: workflow-plan.md
+- Planned steps found: 8 (all implemented)
+- Plan implementation status: Fully Implemented
+
+## Summary
+
+- Validation completed: 2026-01-27 10:24:01
+- Critical issues: 0
+- Warnings: 0 (informational notes only)
+- Readiness: READY (manual review optional)

package/_bmad/tea/workflows/testarch/trace/workflow-plan.md

@@ -0,0 +1,21 @@
+    # Workflow Plan: testarch-trace
+
+    ## Create Mode (steps-c)
+    - step-01-load-context.md
+
+- step-02-discover-tests.md
+- step-03-map-criteria.md
+- step-04-analyze-gaps.md
+- step-05-gate-decision.md
+
+  ## Validate Mode (steps-v)
+  - step-01-validate.md
+
+  ## Edit Mode (steps-e)
+  - step-01-assess.md
+  - step-02-apply-edit.md
+
+  ## Outputs
+  - {output_folder}/traceability-matrix.md
+
+- Gate decision summary (if evidence available)

package/_bmad/tea/workflows/testarch/trace/workflow.md

@@ -0,0 +1,39 @@
+---
+name: testarch-trace
+description: 'Generate requirements-to-tests traceability matrix, analyze coverage, and make quality gate decision (PASS/CONCERNS/FAIL/WAIVED)'
+web_bundle: true
+---
+
+# Requirements Traceability & Quality Gate
+
+**Goal:** Generate requirements-to-tests traceability matrix, analyze coverage, and make quality gate decision (PASS/CONCERNS/FAIL/WAIVED)
+
+**Role:** You are the Master Test Architect.
+
+---
+
+## WORKFLOW ARCHITECTURE
+
+This workflow uses **tri-modal step-file architecture**:
+
+- **Create mode (steps-c/)**: primary execution flow
+- **Validate mode (steps-v/)**: validation against checklist
+- **Edit mode (steps-e/)**: revise existing outputs
+
+---
+
+## INITIALIZATION SEQUENCE
+
+### 1. Mode Determination
+
+"Welcome to the workflow. What would you like to do?"
+
+- **[C] Create** — Run the workflow
+- **[V] Validate** — Validate existing outputs
+- **[E] Edit** — Edit existing outputs
+
+### 2. Route to First Step
+
+- **If C:** Load `steps-c/step-01-load-context.md`
+- **If V:** Load `steps-v/step-01-validate.md`
+- **If E:** Load `steps-e/step-01-assess.md`

package/_bmad/tea/workflows/testarch/trace/workflow.yaml

@@ -0,0 +1,55 @@
+# Test Architect workflow: trace (enhanced with gate decision)
+name: testarch-trace
+description: "Generate requirements-to-tests traceability matrix, analyze coverage, and make quality gate decision (PASS/CONCERNS/FAIL/WAIVED)"
+author: "BMad"
+
+# Critical variables from config
+config_source: "{project-root}/_bmad/tea/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+date: system-generated
+
+# Workflow components
+installed_path: "{project-root}/_bmad/tea/workflows/testarch/trace"
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+template: "{installed_path}/trace-template.md"
+
+# Variables and inputs
+variables:
+  # Directory paths
+  test_dir: "{project-root}/tests" # Root test directory
+  source_dir: "{project-root}" # Source code directory (customize if needed, e.g., {project-root}/src or {project-root}/lib)
+
+  # Workflow behavior
+  coverage_levels: "e2e,api,component,unit" # Which test levels to trace
+  gate_type: "story" # story | epic | release | hotfix - determines gate scope
+  decision_mode: "deterministic" # deterministic (rule-based) | manual (team decision)
+
+# Output configuration
+default_output_file: "{output_folder}/traceability-matrix.md"
+
+# Required tools
+required_tools:
+  - read_file # Read story, test files, BMad artifacts
+  - write_file # Create traceability matrix, gate YAML
+  - list_files # Discover test files
+  - search_repo # Find tests by test ID, describe blocks
+  - glob # Find test files matching patterns
+
+tags:
+  - qa
+  - traceability
+  - test-architect
+  - coverage
+  - requirements
+  - gate
+  - decision
+  - release
+
+execution_hints:
+  interactive: false # Minimize prompts
+  autonomous: true # Proceed without user input unless blocked
+  iterative: true

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAkflD,eAAO,MAAM,SAAS,EAAE,MA0SvB,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA+lBlD,eAAO,MAAM,SAAS,EAAE,MAwXvB,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 import { tool } from "@opencode-ai/plugin/tool";
-import { readFileSync, readdirSync, existsSync, mkdirSync, writeFileSync, statSync } from "fs";
+import { readFileSync, readdirSync, existsSync, mkdirSync, writeFileSync, statSync, unlinkSync, rmdirSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import { homedir } from "os";
@@ -8,6 +8,117 @@ const packageRoot = join(__dirname, "..");
 const bundledAgentsDir = join(packageRoot, ".opencode", "agents");
 const bundledSkillsDir = join(packageRoot, ".opencode", "skills");
 const bundledWorkflowsDir = join(packageRoot, "_bmad", "bmm", "workflows");
+const MANIFEST_FILENAME = "bmm-opencode.json";
+function getPackageVersion() {
+    try {
+        const pkgPath = join(packageRoot, "package.json");
+        if (existsSync(pkgPath)) {
+            return JSON.parse(readFileSync(pkgPath, "utf-8")).version || "0.0.0";
+        }
+    }
+    catch { /* fallback */ }
+    return "0.0.0";
+}
+function readManifest(targetDir) {
+    try {
+        const p = join(targetDir, MANIFEST_FILENAME);
+        if (existsSync(p))
+            return JSON.parse(readFileSync(p, "utf-8"));
+    }
+    catch { /* fallback */ }
+    return null;
+}
+function writeManifest(targetDir, manifest) {
+    mkdirSync(targetDir, { recursive: true });
+    writeFileSync(join(targetDir, MANIFEST_FILENAME), JSON.stringify(manifest, null, 2));
+}
+function removeManifestFiles(targetDir) {
+    const manifest = readManifest(targetDir);
+    if (!manifest)
+        return 0;
+    let removed = 0;
+    for (const rel of manifest.installedFiles) {
+        const full = join(targetDir, rel);
+        try {
+            if (existsSync(full)) {
+                unlinkSync(full);
+                removed++;
+            }
+            const parent = dirname(full);
+            if (existsSync(parent) && readdirSync(parent).length === 0)
+                rmdirSync(parent);
+        }
+        catch { /* skip */ }
+    }
+    try {
+        const skillsDir = join(targetDir, "skills");
+        if (existsSync(skillsDir) && readdirSync(skillsDir).length === 0)
+            rmdirSync(skillsDir);
+    }
+    catch { /* not empty */ }
+    try {
+        unlinkSync(join(targetDir, MANIFEST_FILENAME));
+    }
+    catch { /* skip */ }
+    return removed;
+}
+function resolveSkillTarget(directory) {
+    const globalDir = join(homedir(), ".config", "opencode");
+    const localDir = join(directory, ".opencode");
+    if (readManifest(globalDir))
+        return globalDir;
+    if (readManifest(localDir))
+        return localDir;
+    return globalDir;
+}
+function autoInstallSkills(targetDir) {
+    const ver = getPackageVersion();
+    const existing = readManifest(targetDir);
+    if (existing && existing.version === ver)
+        return { installed: false, skills: 0 };
+    if (existing)
+        removeManifestFiles(targetDir);
+    const { skills } = readBundledFiles();
+    const installedFiles = [];
+    for (const skill of skills) {
+        installedFiles.push(writeSkillFileTracked(targetDir, skill));
+    }
+    writeManifest(targetDir, { version: ver, installedFiles });
+    return { installed: true, skills: skills.length };
+}
+function writeSkillFileTracked(targetDir, skill) {
+    const skillDir = join(targetDir, "skills", skill.folder);
+    mkdirSync(skillDir, { recursive: true });
+    const frontmatterLines = ["---"];
+    frontmatterLines.push(`name: ${skill.frontmatter.name}`);
+    frontmatterLines.push(`description: ${JSON.stringify(skill.frontmatter.description)}`);
+    if (skill.frontmatter.license)
+        frontmatterLines.push(`license: ${skill.frontmatter.license}`);
+    if (skill.frontmatter.compatibility)
+        frontmatterLines.push(`compatibility: ${skill.frontmatter.compatibility}`);
+    if (skill.frontmatter.metadata) {
+        frontmatterLines.push("metadata:");
+        for (const [key, value] of Object.entries(skill.frontmatter.metadata)) {
+            frontmatterLines.push(`  ${key}: ${JSON.stringify(value)}`);
+        }
+    }
+    frontmatterLines.push("---");
+    const content = frontmatterLines.join("\n") + "\n\n" + skill.content;
+    const relPath = join("skills", skill.folder, "SKILL.md");
+    writeFileSync(join(targetDir, relPath), content);
+    return relPath;
+}
+function buildAgentPrompt(agent) {
+    let promptContent = agent.prompt;
+    if (agent.frontmatter.workflows && agent.frontmatter.workflows.length > 0) {
+        const workflows = readWorkflows();
+        const workflowSection = buildWorkflowSection(agent.frontmatter.workflows, workflows);
+        if (!promptContent.includes("You have access to the following workflows")) {
+            promptContent = promptContent.trim() + "\n\n" + workflowSection;
+        }
+    }
+    return promptContent;
+}
 function readBundledFiles() {
     const agents = [];
     const skills = [];
@@ -408,8 +519,54 @@ function formatSkillContent(skill) {
     frontmatterLines.push("---");
     return frontmatterLines.join("\n") + "\n\n" + skill.content;
 }
-export const BMMPlugin = async () => {
+export const BMMPlugin = async ({ directory }) => {
+    const { agents } = readBundledFiles();
+    try {
+        autoInstallSkills(resolveSkillTarget(directory));
+    }
+    catch { /* skills auto-install failed — still accessible via bmm_skill tool */ }
     return {
+        config: async (config) => {
+            if (!config.agent)
+                config.agent = {};
+            for (const agent of agents) {
+                const name = agent.filename.replace(".md", "");
+                if (config.agent[name])
+                    continue;
+                const entry = {
+                    description: agent.frontmatter.description,
+                    prompt: buildAgentPrompt(agent),
+                };
+                if (agent.frontmatter.mode)
+                    entry.mode = agent.frontmatter.mode;
+                if (agent.frontmatter.model)
+                    entry.model = agent.frontmatter.model;
+                if (agent.frontmatter.tools) {
+                    const tools = {};
+                    for (const [k, v] of Object.entries(agent.frontmatter.tools)) {
+                        if (v !== undefined)
+                            tools[k] = v;
+                    }
+                    entry.tools = tools;
+                }
+                config.agent[name] = entry;
+            }
+            if (!config.command)
+                config.command = {};
+            for (const cmd of getCommandMappings()) {
+                if (config.command[cmd.commandName])
+                    continue;
+                const entry = {
+                    template: `Load the skill "${cmd.skillName}" and follow its instructions. $ARGUMENTS`,
+                    description: cmd.description,
+                };
+                if (cmd.agentName) {
+                    entry.agent = cmd.agentName;
+                    entry.subtask = true;
+                }
+                config.command[cmd.commandName] = entry;
+            }
+        },
         tool: {
             bmm_list: tool({
                 description: "List all available BMAD-METHOD agents, skills, and commands from bmm-opencode",
@@ -571,9 +728,10 @@ Use \`force=true\` to overwrite, or remove existing files first.`;
                             writeAgentFile(targetBase, agent);
                             agentsCopied++;
                         }
+                        const skillFiles = [];
                         let skillsCopied = 0;
                         for (const skill of skills) {
-                            writeSkillFile(targetBase, skill);
+                            skillFiles.push(writeSkillFileTracked(targetBase, skill));
                             skillsCopied++;
                         }
                         const commandMappings = getCommandMappings();
@@ -582,28 +740,60 @@ Use \`force=true\` to overwrite, or remove existing files first.`;
                             writeCommandFile(targetBase, mapping);
                             commandsCopied++;
                         }
+                        writeManifest(targetBase, { version: getPackageVersion(), installedFiles: skillFiles });
                         const isGlobal = targetBase === globalConfigDir;
                         const installType = isGlobal ? "globally" : "to project";
-                        const source = "from bundled files";
                         const targetCommands = join(targetBase, "commands");
                         const autoNote = autoDetected ? `\n\nNote: Auto-detected existing global installation at ${globalConfigDir}` : "";
                         return `Successfully installed BMM-OpenCode ${installType} (${targetBase}):
 - ${agentsCopied} agents copied to ${targetAgents}
 - ${skillsCopied} skills copied to ${targetSkills}
 - ${commandsCopied} commands copied to ${targetCommands}
-
-Source: ${source}${autoNote}
-
-After restart, type \`/\` to see all available workflow commands (e.g. \`/bmad-bmm-create-prd\`, \`/bmad-bmm-dev-story\`).
-Each command auto-routes to the correct agent and loads the workflow skill.
-
-Restart OpenCode to use the new agents, skills, and commands.`;
+- Manifest: ${join(targetBase, MANIFEST_FILENAME)}
+${autoNote}
+Use \`bmm_uninstall\` to cleanly remove skill files.
+Agents and commands are also injected via config hook (auto-removed when plugin is removed).`;
                     }
                     catch (error) {
                         return `Installation failed: ${error instanceof Error ? error.message : String(error)}`;
                     }
                 },
             }),
+            bmm_uninstall: tool({
+                description: "Remove all BMM skill files that were auto-installed. Reads bmm-opencode.json manifest for clean removal.",
+                args: {
+                    target: tool.schema
+                        .string()
+                        .optional()
+                        .describe("Target directory to uninstall from (auto-detected if omitted)"),
+                },
+                async execute(args, context) {
+                    const globalConfigDir = join(homedir(), ".config", "opencode");
+                    const localConfigDir = join(context.directory, ".opencode");
+                    const targets = [];
+                    if (args.target) {
+                        targets.push(args.target);
+                    }
+                    else {
+                        if (readManifest(globalConfigDir))
+                            targets.push(globalConfigDir);
+                        if (readManifest(localConfigDir))
+                            targets.push(localConfigDir);
+                    }
+                    if (targets.length === 0) {
+                        return `No BMM installation found. No ${MANIFEST_FILENAME} manifest in:\n- ${globalConfigDir}\n- ${localConfigDir}`;
+                    }
+                    const results = [];
+                    for (const target of targets) {
+                        const manifest = readManifest(target);
+                        if (!manifest)
+                            continue;
+                        const removed = removeManifestFiles(target);
+                        results.push(`- ${target}: removed ${removed} skill files (was v${manifest.version})`);
+                    }
+                    return `BMM-OpenCode skill files uninstalled:\n${results.join("\n")}\n\nAgents and commands are injected via config hook — they disappear automatically when "bmm-opencode" is removed from opencode.json plugin list.`;
+                },
+            }),
             bmm_agent_workflows: tool({
                 description: "List all BMM agents with their available workflows for @agent autocomplete suggestions",
                 args: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmm-opencode",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "BMAD-METHOD agents and skills for OpenCode - AI agent framework with 19 specialized agents and 62 workflow skills",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,6 +47,7 @@
   "files": [
     "dist",
     ".opencode/**/*",
+    "_bmad/**/*",
     "README.md",
     "LICENSE"
   ],