@syntesseraai/opencode-feature-factory 0.6.4 → 0.6.6

package/commands/pipeline/building/implement-batch.md

@@ -0,0 +1,16 @@
+---
+description: Implement validated batches with Codex
+subtask: true
+agent: ff-building-codex
+---
+
+Read `.feature-factory/agents/ff-building-gemini-batches-{UUID}.md` and implement tasks batch-by-batch.
+
+For each task:
+
+1. implement code changes
+2. add/update tests
+3. run lint/typecheck/tests for impacted scope
+4. persist completion report to `.feature-factory/agents/ff-building-codex-{UUID}-T{N}.md`
+
+This command performs implementation only; reviewing is triggered by `/pipeline/building/run` and by rework flow.

package/commands/pipeline/building/run.md

@@ -0,0 +1,19 @@
+---
+description: Run build phase from approved plan
+subtask: true
+return:
+  - /pipeline/building/breakdown
+  - /pipeline/building/validate-batch
+  - /pipeline/building/implement-batch
+  - /pipeline/reviewing/run
+---
+
+Run build phase from `.feature-factory/plans/plan-final-{UUID}.md`.
+
+Rules:
+
+1. Maintain dependency-safe batching.
+2. Only parallelize tasks with no dependency edges.
+3. Persist batch/task outputs to `.feature-factory/agents/`.
+4. Implementation is Codex-only via `ff-building-codex` (model `openai/gpt-5.3-codex`).
+5. Send completed batches into reviewing via `/pipeline/reviewing/run`.

package/commands/pipeline/building/validate-batch.md

@@ -0,0 +1,16 @@
+---
+description: Validate task batches for architecture and dependencies
+subtask: true
+agent: ff-building-gemini
+---
+
+Read `.feature-factory/agents/ff-building-opus-tasks-{UUID}.md` and create dependency-safe batches.
+
+For each batch:
+
+1. validate architecture and codebase fit
+2. confirm or adjust file targets
+3. flag architectural risks
+4. mark whether tasks can run in parallel
+
+Persist enriched batches to `.feature-factory/agents/ff-building-gemini-batches-{UUID}.md`.

package/commands/pipeline/complete.md

@@ -0,0 +1,12 @@
+---
+description: Finalize pipeline run and summarize outcomes
+subtask: true
+model: openai/gpt-5.4
+---
+
+Finalize the pipeline run.
+
+1. Summarize accepted plan, implemented tasks, review outcomes, and assumptions.
+2. Keep plans and reviews for auditability.
+3. Clear transient pipeline agent context files.
+4. Return concise completion report to user.

package/commands/pipeline/planning/gate.md

@@ -0,0 +1,22 @@
+---
+description: Apply planning consensus gate
+subtask: true
+agent: ff-planning-codex
+model: openai/gpt-5.4
+---
+
+Read `.feature-factory/plans/plan-consensus-{UUID}.md` and apply the planning gate exactly:
+
+- `>=75`: APPROVED
+- `50-74`: REWORK
+- `<50`: BLOCKED
+
+Actions:
+
+1. If APPROVED, persist `.feature-factory/plans/plan-final-{UUID}.md` from the synthesized plan.
+2. If REWORK, append divergence feedback to pipeline context so the next planning loop iteration re-plans with explicit deltas.
+3. If BLOCKED, update pipeline context with explicit user-decision-needed status.
+
+Always write a gate summary to pipeline context and include one status line in your final output:
+
+`PLANNING_GATE=APPROVED|REWORK|BLOCKED`

package/commands/pipeline/planning/run-codex.md

@@ -0,0 +1,22 @@
+---
+description: Generate Codex planning proposal
+subtask: true
+agent: ff-planning-codex
+model: openai/gpt-5.3-codex
+---
+
+Create a comprehensive implementation plan from the current pipeline requirements.
+
+Requirements brief:
+
+$ARGUMENTS
+
+Persist plan content using `ff-plans-update` into `.feature-factory/plans/plan-codex-{UUID}.md`.
+
+Include:
+
+- requirements summary
+- architecture validation for the proposed implementation approach
+- ordered implementation steps with file targets
+- risks and mitigations
+- testing and validation strategy

package/commands/pipeline/planning/run-gemini.md

@@ -0,0 +1,21 @@
+---
+description: Generate Gemini planning proposal
+subtask: true
+agent: ff-planning-gemini
+---
+
+Create a comprehensive implementation plan from the current pipeline requirements.
+
+Requirements brief:
+
+$ARGUMENTS
+
+Persist plan content using `ff-plans-update` into `.feature-factory/plans/plan-gemini-{UUID}.md`.
+
+Include:
+
+- requirements summary
+- architecture validation for the proposed implementation approach
+- ordered implementation steps with file targets
+- risks and mitigations
+- testing and validation strategy

package/commands/pipeline/planning/run-opus.md

@@ -0,0 +1,21 @@
+---
+description: Generate Opus planning proposal
+subtask: true
+agent: ff-planning-opus
+---
+
+Create a comprehensive implementation plan from the current pipeline requirements.
+
+Requirements brief:
+
+$ARGUMENTS
+
+Persist plan content using `ff-plans-update` into `.feature-factory/plans/plan-opus-{UUID}.md`.
+
+Include:
+
+- requirements summary
+- architecture validation for the proposed implementation approach
+- ordered implementation steps with file targets
+- risks and mitigations
+- testing and validation strategy

package/commands/pipeline/planning/run.md

@@ -0,0 +1,25 @@
+---
+description: Execute one planning iteration
+subtask: true
+model: openai/gpt-5.4
+parallel:
+  - /pipeline/planning/run-opus {as:plan-opus}
+  - /pipeline/planning/run-gemini {as:plan-gemini}
+  - /pipeline/planning/run-codex {as:plan-codex}
+return:
+  - /pipeline/planning/synthesize
+  - /pipeline/planning/gate
+---
+
+Run one complete planning iteration for the active pipeline.
+
+Requirements brief:
+
+$ARGUMENTS
+
+Rules:
+
+1. Persist each planner output to `.feature-factory/plans/plan-{model}-{UUID}.md`.
+2. Preserve prior planning artifacts for audit.
+3. Each planning model must include architecture validation in its proposal.
+4. Continue only through gate outcomes defined in `/pipeline/planning/gate`.

package/commands/pipeline/planning/synthesize.md

@@ -0,0 +1,18 @@
+---
+description: Synthesize planning consensus
+subtask: true
+agent: ff-planning-codex
+model: openai/gpt-5.4
+---
+
+Read the latest planning artifacts (`plan-opus-{UUID}.md`, `plan-gemini-{UUID}.md`, `plan-codex-{UUID}.md`) and produce a consensus report.
+
+Persist as `.feature-factory/plans/plan-consensus-{UUID}.md`.
+
+Required output sections:
+
+1. `CONSENSUS_SCORE` (0-100)
+2. `AGREED_ELEMENTS`
+3. `DIVERGENT_ELEMENTS`
+4. `SYNTHESIZED_PLAN`
+5. `OPEN_QUESTIONS`

package/commands/pipeline/reviewing/gate.md

@@ -0,0 +1,16 @@
+---
+description: Apply review approval gate
+subtask: true
+agent: ff-reviewing-codex
+model: openai/gpt-5.4
+---
+
+Read latest synthesis report and apply gate exactly:
+
+- APPROVED when confidence `>=95` and unresolved issues count is `0`
+- REWORK when below threshold and iteration < 10
+- ESCALATE when iteration == 10 and still not approved
+
+Persist gate decision in pipeline context and output one status line:
+
+`REVIEW_GATE=APPROVED|REWORK|ESCALATE`

package/commands/pipeline/reviewing/run-codex.md

@@ -0,0 +1,12 @@
+---
+description: Independent Codex review
+subtask: true
+agent: ff-reviewing-codex
+model: openai/gpt-5.3-codex
+---
+
+Review the current task from triage brief for correctness, quality, architecture validity, testing, security, and edge cases.
+
+Classify findings as critical/high/medium/low and include confidence score.
+
+Persist to `.feature-factory/agents/ff-reviewing-codex-{UUID}-T{N}.md`.

package/commands/pipeline/reviewing/run-gemini.md

@@ -0,0 +1,11 @@
+---
+description: Independent Gemini review
+subtask: true
+agent: ff-reviewing-gemini
+---
+
+Review the current task from triage brief for correctness, quality, architecture validity, testing, security, and edge cases.
+
+Classify findings as critical/high/medium/low and include confidence score.
+
+Persist to `.feature-factory/agents/ff-reviewing-gemini-{UUID}-T{N}.md`.

package/commands/pipeline/reviewing/run-opus.md

@@ -0,0 +1,11 @@
+---
+description: Independent Opus review
+subtask: true
+agent: ff-reviewing-opus
+---
+
+Review the current task from triage brief for correctness, quality, architecture validity, testing, security, and edge cases.
+
+Classify findings as critical/high/medium/low and include confidence score.
+
+Persist to `.feature-factory/agents/ff-reviewing-opus-{UUID}-T{N}.md`.

package/commands/pipeline/reviewing/run.md

@@ -0,0 +1,24 @@
+---
+description: Run review loop for completed tasks
+subtask: true
+model: openai/gpt-5.4
+loop:
+  max: 10
+  until: all tasks in the active batch are approved with confidence >=95 and zero unresolved issues
+return:
+  - /pipeline/reviewing/triage
+  - /pipeline/reviewing/run-opus {as:review-opus}
+  - /pipeline/reviewing/run-gemini {as:review-gemini}
+  - /pipeline/reviewing/run-codex {as:review-codex}
+  - /pipeline/reviewing/synthesize
+  - /pipeline/reviewing/gate
+  - If `REVIEW_GATE=REWORK`, invoke `/pipeline/building/implement-batch` to apply fixes before the next loop iteration.
+---
+
+Execute the review loop for the current completed tasks/rework report.
+
+Stop criteria:
+
+- approve when `>=95` confidence and zero unresolved issues
+- continue loop while unresolved issues exist and iteration < 10
+- escalate to user when iteration reaches 10 without approval

package/commands/pipeline/reviewing/synthesize.md

@@ -0,0 +1,18 @@
+---
+description: Synthesize independent reviews into one report
+subtask: true
+agent: ff-reviewing-codex
+model: openai/gpt-5.4
+---
+
+Read the latest three review reports (Opus, Gemini, and Codex) and synthesize a single authoritative output.
+
+Required output:
+
+1. overall confidence (0-100)
+2. consolidated deduplicated findings
+3. unresolved issues list
+4. verdict `APPROVED` or `REWORK_REQUIRED`
+5. explicit rework instructions when needed
+
+Persist to `.feature-factory/agents/ff-reviewing-codex-synthesis-{UUID}-T{N}-iter{I}.md`.

package/commands/pipeline/reviewing/triage.md

@@ -0,0 +1,16 @@
+---
+description: Build review brief from implementation outputs
+subtask: true
+agent: ff-reviewing-codex
+model: openai/gpt-5.4
+---
+
+Prepare a review brief for the current completed task or rework output.
+
+Include:
+
+- summary of implemented changes
+- files changed
+- focus areas and risk points
+
+Persist to `.feature-factory/agents/ff-reviewing-codex-triage-{UUID}-T{N}.md`.

package/commands/pipeline/start.md

@@ -0,0 +1,21 @@
+---
+description: Pipeline workflow entrypoint
+subtask: true
+model: openai/gpt-5.4
+return:
+  - /pipeline/planning/run {loop:5 && until:planning gate is APPROVED or planning gate is BLOCKED and waiting for user confirmation}
+  - If planning is BLOCKED or loop max was reached, stop and ask the user whether to continue planning iterations. Otherwise continue.
+  - /pipeline/building/run
+  - /pipeline/complete
+---
+
+Start the deterministic Feature Factory pipeline with this requirements brief:
+
+$ARGUMENTS
+
+Execution requirements:
+
+1. Create a pipeline UUID and persist orchestrator state in `.feature-factory/agents/pipeline-{UUID}.md` via `ff-agents-update`.
+2. Keep all phase artifacts in `.feature-factory/plans/` and `.feature-factory/reviews/`.
+3. Use command chaining, parallel fan-out, and loop gates from the `/pipeline/...` command tree.
+4. Do not skip planning and review gates.

package/dist/index.js

@@ -1,6 +1,7 @@
 import { StopQualityGateHooksPlugin } from './stop-quality-gate.js';
 import { updateMCPConfig } from './mcp-config.js';
 import { updateAgentConfig } from './agent-config.js';
+import { updatePluginConfig } from './plugin-config.js';
 import { $ } from 'bun';
 // Import tool creator functions
 import { createFFAgentsCurrentTool } from './plugins/ff-agents-current-plugin.js';
@@ -53,6 +54,14 @@ export const FeatureFactoryPlugin = async (input) => {
     catch {
         console.error('Failed to update agent config in OpenCode plugin');
     }
+    // Update plugin list in global OpenCode config
+    // This ensures required companion plugins are present
+    try {
+        await updatePluginConfig($);
+    }
+    catch {
+        console.error('Failed to update plugin config in OpenCode plugin');
+    }
     // Load hooks from the quality gate plugin
     const qualityGateHooks = await StopQualityGateHooksPlugin(input).catch(() => ({}));
     // Create all tools

package/dist/plugin-config.d.ts

@@ -0,0 +1,49 @@
+type BunShell = any;
+/**
+ * Default plugins that should be present in the global OpenCode config.
+ * These will be merged into the existing plugin array without removing
+ * any user-added entries.
+ */
+export declare const DEFAULT_PLUGINS: readonly string[];
+/**
+ * Extract the base package name from a plugin specifier, stripping the
+ * version suffix. Handles both scoped (`@scope/name@version`) and
+ * unscoped (`name@version`) packages.
+ *
+ * Examples:
+ *   "@scope/pkg@latest"  → "@scope/pkg"
+ *   "@scope/pkg@1.2.3"   → "@scope/pkg"
+ *   "pkg@latest"          → "pkg"
+ *   "pkg"                 → "pkg"
+ */
+export declare function getPackageBaseName(plugin: string): string;
+/**
+ * Check whether a plugin (by base name) is already present in the array,
+ * regardless of the version suffix. If a user has pinned a specific version
+ * (e.g. `@scope/pkg@1.2.3`), we treat the package as already present and
+ * do NOT add the `@latest` variant.
+ */
+export declare function hasPlugin(existing: string[], plugin: string): boolean;
+/**
+ * Merge plugin arrays, preserving existing entries and appending new ones.
+ * Existing entries are never removed or reordered.
+ *
+ * Matching is done by base package name (without version suffix), so a
+ * user-pinned `@scope/pkg@1.0.0` will prevent `@scope/pkg@latest` from
+ * being added.
+ */
+export declare function mergePlugins(existing: string[] | undefined, defaults: readonly string[]): string[];
+/**
+ * Update the plugin list in global opencode.json.
+ *
+ * This function:
+ * 1. Reads existing config from ~/.config/opencode/opencode.json
+ * 2. Preserves all existing plugins in the array
+ * 3. Appends default Feature Factory plugins that aren't already present
+ *    (matched by base package name, so pinned versions are respected)
+ * 4. Writes updated config back to ~/.config/opencode/opencode.json
+ *
+ * @param $ - Bun shell instance
+ */
+export declare function updatePluginConfig($: BunShell): Promise<void>;
+export {};

package/dist/plugin-config.js

@@ -0,0 +1,140 @@
+import { readJsonFile } from './quality-gate-config.js';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const GLOBAL_OPENCODE_DIR = join(homedir(), '.config', 'opencode');
+const GLOBAL_OPENCODE_CONFIG_PATH = join(GLOBAL_OPENCODE_DIR, 'opencode.json');
+/**
+ * Default plugins that should be present in the global OpenCode config.
+ * These will be merged into the existing plugin array without removing
+ * any user-added entries.
+ */
+export const DEFAULT_PLUGINS = [
+    '@syntesseraai/opencode-feature-factory@latest',
+    '@nick-vi/opencode-type-inject@latest',
+    '@franlol/opencode-md-table-formatter@latest',
+    '@spoons-and-mirrors/subtask2@latest',
+    'opencode-pty@latest',
+    '@angdrew/opencode-hashline-plugin@latest',
+];
+/**
+ * Extract the base package name from a plugin specifier, stripping the
+ * version suffix. Handles both scoped (`@scope/name@version`) and
+ * unscoped (`name@version`) packages.
+ *
+ * Examples:
+ *   "@scope/pkg@latest"  → "@scope/pkg"
+ *   "@scope/pkg@1.2.3"   → "@scope/pkg"
+ *   "pkg@latest"          → "pkg"
+ *   "pkg"                 → "pkg"
+ */
+export function getPackageBaseName(plugin) {
+    if (plugin.startsWith('@')) {
+        // Scoped package: the version delimiter is the '@' after the '/'
+        const slashIndex = plugin.indexOf('/');
+        if (slashIndex !== -1) {
+            const versionAt = plugin.indexOf('@', slashIndex + 1);
+            if (versionAt !== -1) {
+                return plugin.substring(0, versionAt);
+            }
+        }
+        // No slash or no version suffix — return as-is
+        return plugin;
+    }
+    // Unscoped package: version delimiter is the first '@'
+    const atIndex = plugin.indexOf('@');
+    if (atIndex !== -1) {
+        return plugin.substring(0, atIndex);
+    }
+    return plugin;
+}
+/**
+ * Check whether a plugin (by base name) is already present in the array,
+ * regardless of the version suffix. If a user has pinned a specific version
+ * (e.g. `@scope/pkg@1.2.3`), we treat the package as already present and
+ * do NOT add the `@latest` variant.
+ */
+export function hasPlugin(existing, plugin) {
+    const baseName = getPackageBaseName(plugin);
+    return existing.some((entry) => getPackageBaseName(entry) === baseName);
+}
+/**
+ * Merge plugin arrays, preserving existing entries and appending new ones.
+ * Existing entries are never removed or reordered.
+ *
+ * Matching is done by base package name (without version suffix), so a
+ * user-pinned `@scope/pkg@1.0.0` will prevent `@scope/pkg@latest` from
+ * being added.
+ */
+export function mergePlugins(existing, defaults) {
+    const existingPlugins = existing ?? [];
+    const result = [...existingPlugins];
+    for (const plugin of defaults) {
+        if (!hasPlugin(result, plugin)) {
+            result.push(plugin);
+        }
+    }
+    return result;
+}
+/**
+ * Update the plugin list in global opencode.json.
+ *
+ * This function:
+ * 1. Reads existing config from ~/.config/opencode/opencode.json
+ * 2. Preserves all existing plugins in the array
+ * 3. Appends default Feature Factory plugins that aren't already present
+ *    (matched by base package name, so pinned versions are respected)
+ * 4. Writes updated config back to ~/.config/opencode/opencode.json
+ *
+ * @param $ - Bun shell instance
+ */
+export async function updatePluginConfig($) {
+    // Read existing global config
+    const globalJson = await readJsonFile($, GLOBAL_OPENCODE_CONFIG_PATH);
+    // Get existing plugins from global config
+    const existingPlugins = Array.isArray(globalJson?.plugin)
+        ? globalJson.plugin
+        : undefined;
+    // Check if any changes are needed (by base name)
+    const existingArray = existingPlugins ?? [];
+    const hasChanges = DEFAULT_PLUGINS.some((plugin) => !hasPlugin(existingArray, plugin));
+    if (!hasChanges) {
+        // All default plugins already present (possibly with pinned versions)
+        return;
+    }
+    // Merge with default plugins
+    const updatedPlugins = mergePlugins(existingPlugins, DEFAULT_PLUGINS);
+    // Prepare updated global config
+    const updatedGlobalConfig = {
+        ...(globalJson ?? {}),
+        plugin: updatedPlugins,
+    };
+    // Ensure global config directory exists
+    try {
+        await $ `mkdir -p ${GLOBAL_OPENCODE_DIR}`.quiet();
+    }
+    catch {
+        // Directory might already exist, ignore
+    }
+    // Backup existing global config if it exists and has content
+    if (globalJson && Object.keys(globalJson).length > 0) {
+        try {
+            const timestamp = new Date().toISOString().split('T')[0].replace(/-/g, '');
+            const backupPath = `${GLOBAL_OPENCODE_CONFIG_PATH}.backup.${timestamp}`;
+            const backupContent = JSON.stringify(globalJson, null, 2);
+            await $ `echo ${backupContent} > ${backupPath}`.quiet();
+        }
+        catch (error) {
+            // Backup failed, but continue anyway
+            console.warn('[feature-factory] Could not create backup:', error);
+        }
+    }
+    // Write updated config to global opencode.json
+    const configContent = JSON.stringify(updatedGlobalConfig, null, 2);
+    try {
+        await $ `echo ${configContent} > ${GLOBAL_OPENCODE_CONFIG_PATH}`.quiet();
+    }
+    catch (error) {
+        // Silently fail - don't block if we can't write the config
+        console.warn('[feature-factory] Could not update plugin config:', error);
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@syntesseraai/opencode-feature-factory",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "type": "module",
   "description": "OpenCode plugin for Feature Factory agents - provides sub-agents and skills for validation, review, security, and architecture assessment",
   "license": "MIT",
@@ -15,6 +15,7 @@
     "assets",
     "skills",
     "agents",
+    "commands",
     "bin"
   ],
   "keywords": [