@syntesseraai/opencode-feature-factory 0.6.4 → 0.6.5

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.5",
   "type": "module",
   "description": "OpenCode plugin for Feature Factory agents - provides sub-agents and skills for validation, review, security, and architecture assessment",
   "license": "MIT",