wogiflow 1.1.2 → 1.1.3

package/.workflow/bridges/base-bridge.js

@@ -400,13 +400,112 @@ class BaseBridge {
 
   // ==================== Template Utility Methods ====================
 
+  /**
+   * Get the package root directory (where wogiflow is installed)
+   * @returns {string|null} Package root path or null if not found
+   */
+  getPackageRoot() {
+    // Try to find the package by looking up from scripts directory
+    const possibleRoots = [
+      path.resolve(__dirname, '..', '..'),  // From .workflow/bridges/ -> package root
+      path.resolve(__dirname, '..', '..', '..', 'node_modules', 'wogiflow'),  // From project
+    ];
+
+    for (const root of possibleRoots) {
+      const pkgPath = path.join(root, 'package.json');
+      if (fs.existsSync(pkgPath)) {
+        try {
+          const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+          if (pkg.name === 'wogiflow') {
+            return root;
+          }
+        } catch {
+          // Continue to next option
+        }
+      }
+    }
+    return null;
+  }
+
+  /**
+   * Check if a template file is outdated/stub
+   * @param {string} templatePath - Path to template file
+   * @returns {boolean} True if template appears to be outdated
+   */
+  isTemplateOutdated(templatePath) {
+    if (!fs.existsSync(templatePath)) {
+      return true;
+    }
+
+    try {
+      const content = fs.readFileSync(templatePath, 'utf-8');
+
+      // Check for stub/placeholder markers
+      const stubMarkers = [
+        'Full implementation pending',
+        'stub template',
+        'not yet implemented',
+        'TODO: implement',
+        'placeholder template'
+      ];
+
+      for (const marker of stubMarkers) {
+        if (content.toLowerCase().includes(marker.toLowerCase())) {
+          return true;
+        }
+      }
+
+      // Check if template is too short (likely incomplete)
+      if (content.length < 500) {
+        return true;
+      }
+
+      return false;
+    } catch {
+      return true;
+    }
+  }
+
+  /**
+   * Get template path, preferring package template if project template is outdated
+   * @param {string} templateName - Template filename (e.g., 'gemini-md.hbs')
+   * @returns {string|null} Path to best available template
+   */
+  getBestTemplatePath(templateName) {
+    const projectTemplate = path.join(this.projectDir, this.workflowDir, 'templates', templateName);
+
+    // If project template exists and is not outdated, use it
+    if (!this.isTemplateOutdated(projectTemplate)) {
+      return projectTemplate;
+    }
+
+    // Try to use package template instead
+    const packageRoot = this.getPackageRoot();
+    if (packageRoot) {
+      const packageTemplate = path.join(packageRoot, '.workflow', 'templates', templateName);
+      if (fs.existsSync(packageTemplate)) {
+        this.log(`Using package template for ${templateName} (project template outdated)`);
+        return packageTemplate;
+      }
+    }
+
+    // Fall back to project template even if outdated
+    if (fs.existsSync(projectTemplate)) {
+      return projectTemplate;
+    }
+
+    return null;
+  }
+
   /**
    * Load a partial template from .workflow/templates/partials/
+   * Checks both project and package directories
    * @param {string} partialName - Name of the partial (without .hbs extension)
    * @returns {string} Partial content or empty string if not found
    */
   loadPartial(partialName) {
-    const partialPath = path.join(
+    // Try project partials first
+    const projectPartialPath = path.join(
       this.projectDir,
       this.workflowDir,
       'templates',
@@ -415,12 +514,33 @@ class BaseBridge {
     );
 
     try {
-      if (fs.existsSync(partialPath)) {
-        return fs.readFileSync(partialPath, 'utf-8');
+      if (fs.existsSync(projectPartialPath)) {
+        return fs.readFileSync(projectPartialPath, 'utf-8');
       }
     } catch (err) {
-      this.log(`Warning: Could not load partial ${partialName}: ${err.message}`);
+      this.log(`Warning: Could not load project partial ${partialName}: ${err.message}`);
+    }
+
+    // Try package partials as fallback
+    const packageRoot = this.getPackageRoot();
+    if (packageRoot) {
+      const packagePartialPath = path.join(
+        packageRoot,
+        '.workflow',
+        'templates',
+        'partials',
+        `${partialName}.hbs`
+      );
+
+      try {
+        if (fs.existsSync(packagePartialPath)) {
+          return fs.readFileSync(packagePartialPath, 'utf-8');
+        }
+      } catch (err) {
+        this.log(`Warning: Could not load package partial ${partialName}: ${err.message}`);
+      }
     }
+
     return '';
   }
 

package/.workflow/bridges/claude-bridge.js

@@ -45,11 +45,9 @@ class ClaudeBridge extends BaseBridge {
    * @returns {string} Generated CLAUDE.md content
    */
   generateRulesContent(config) {
-    const projectName = config.projectName || 'Project';
-
-    // Check if custom template exists
-    const templatePath = path.join(this.projectDir, this.workflowDir, 'templates', 'claude-md.hbs');
-    if (fs.existsSync(templatePath)) {
+    // Use getBestTemplatePath to find the best template (prefers package over outdated project)
+    const templatePath = this.getBestTemplatePath('claude-md.hbs');
+    if (templatePath) {
       return this.generateFromTemplate(templatePath, config);
     }
 

package/.workflow/bridges/codex-bridge.js

@@ -81,8 +81,8 @@ class CodexBridge extends BaseBridge {
       this.registerPartials();
 
       try {
-        const templatePath = path.join(this.projectDir, this.workflowDir, 'templates', 'agents-md.hbs');
-        if (fs.existsSync(templatePath)) {
+        const templatePath = this.getBestTemplatePath('agents-md.hbs');
+        if (templatePath) {
           const templateSource = fs.readFileSync(templatePath, 'utf-8');
           const template = Handlebars.compile(templateSource);
           return template(context);

package/.workflow/bridges/cursor-bridge.js

@@ -88,8 +88,8 @@ class CursorBridge extends BaseBridge {
       // Register partials before compiling
       this.registerPartials();
 
-      const templatePath = path.join(this.projectDir, this.workflowDir, 'templates', 'cursor-rules.mdc.hbs');
-      if (fs.existsSync(templatePath)) {
+      const templatePath = this.getBestTemplatePath('cursor-rules.mdc.hbs');
+      if (templatePath) {
         try {
           const templateSource = fs.readFileSync(templatePath, 'utf-8');
           const template = Handlebars.compile(templateSource);

package/.workflow/bridges/gemini-bridge.js

@@ -58,9 +58,9 @@ class GeminiBridge extends BaseBridge {
    * @returns {string} Generated GEMINI.md content
    */
   generateRulesContent(config) {
-    // Check if custom template exists
-    const templatePath = path.join(this.projectDir, this.workflowDir, 'templates', 'gemini-md.hbs');
-    if (fs.existsSync(templatePath)) {
+    // Use getBestTemplatePath to find the best template (prefers package over outdated project)
+    const templatePath = this.getBestTemplatePath('gemini-md.hbs');
+    if (templatePath) {
       return this.generateFromTemplate(templatePath, config);
     }
 

package/.workflow/bridges/kimi-bridge.js

@@ -88,11 +88,11 @@ class KimiBridge extends BaseBridge {
 
       try {
         // Try kimi-specific template first, fall back to generic agents-md.hbs
-        let templatePath = path.join(this.projectDir, this.workflowDir, 'templates', 'kimi-agents-md.hbs');
-        if (!fs.existsSync(templatePath)) {
-          templatePath = path.join(this.projectDir, this.workflowDir, 'templates', 'agents-md.hbs');
+        let templatePath = this.getBestTemplatePath('kimi-agents-md.hbs');
+        if (!templatePath) {
+          templatePath = this.getBestTemplatePath('agents-md.hbs');
         }
-        if (fs.existsSync(templatePath)) {
+        if (templatePath) {
           let templateSource;
           try {
             templateSource = fs.readFileSync(templatePath, 'utf-8');

package/.workflow/bridges/opencode-bridge.js

@@ -84,8 +84,8 @@ class OpenCodeBridge extends BaseBridge {
       this.registerPartials();
 
       try {
-        const templatePath = path.join(this.projectDir, this.workflowDir, 'templates', 'opencode-agents-md.hbs');
-        if (fs.existsSync(templatePath)) {
+        const templatePath = this.getBestTemplatePath('opencode-agents-md.hbs');
+        if (templatePath) {
           const templateSource = fs.readFileSync(templatePath, 'utf-8');
           const template = Handlebars.compile(templateSource);
           return template(context);

package/lib/installer.js

@@ -322,6 +322,31 @@ function createWorkflowStructure(projectRoot, config) {
   console.log('  Created .workflow/ directory structure');
 }
 
+/**
+ * CLI-specific resource mappings
+ * Maps CLI keys to their package source directories and output file names
+ */
+const CLI_RESOURCES = {
+  claude: {
+    packageDir: '.claude',
+    rulesFile: 'CLAUDE.md',
+    templateName: 'claude-md.hbs',
+    subdirs: ['commands', 'docs', 'rules', 'skills']
+  },
+  gemini: {
+    packageDir: '.claude', // Share Claude's resources as base, bridge customizes output
+    rulesFile: 'GEMINI.md',
+    templateName: 'gemini-md.hbs',
+    subdirs: ['commands', 'docs', 'rules', 'skills']
+  },
+  opencode: {
+    packageDir: '.claude',
+    rulesFile: '.opencode/agents.md',
+    templateName: 'opencode-agents-md.hbs',
+    subdirs: ['docs', 'skills']
+  }
+};
+
 /**
  * Create CLI-specific configuration
  * @param {string} projectRoot - Project root directory
@@ -338,45 +363,48 @@ function createCLIConfig(projectRoot, cliKey, config) {
   const cliDir = path.join(projectRoot, cli.dir);
   fs.mkdirSync(cliDir, { recursive: true });
 
-  // Create CLI-specific config file and copy resources
-  if (cliKey === 'claude') {
-    // Copy commands from package
-    const packageCommands = path.join(PACKAGE_ROOT, '.claude', 'commands');
-    const projectCommands = path.join(cliDir, 'commands');
-    if (fs.existsSync(packageCommands)) {
-      copyDir(packageCommands, projectCommands);
-      console.log('  Copied .claude/commands/ (slash commands)');
-    }
+  // Get CLI-specific resource configuration
+  const resources = CLI_RESOURCES[cliKey];
+  if (!resources) {
+    console.log(`  ${cli.name} will be configured via bridge sync`);
+    console.log(`  Configured ${cli.name}`);
+    return;
+  }
 
-    // Copy docs from package
-    const packageDocs = path.join(PACKAGE_ROOT, '.claude', 'docs');
-    const projectDocs = path.join(cliDir, 'docs');
-    if (fs.existsSync(packageDocs)) {
-      copyDir(packageDocs, projectDocs);
-      console.log('  Copied .claude/docs/ (documentation)');
+  // Copy common subdirectories (commands, docs, rules, skills)
+  const packageCliDir = path.join(PACKAGE_ROOT, resources.packageDir);
+  for (const subdir of resources.subdirs) {
+    const packageSubdir = path.join(packageCliDir, subdir);
+    const projectSubdir = path.join(cliDir, subdir);
+    if (fs.existsSync(packageSubdir)) {
+      copyDir(packageSubdir, projectSubdir);
+      console.log(`  Copied ${cli.dir}/${subdir}/`);
     }
+  }
 
-    // Copy rules from package
-    const packageRules = path.join(PACKAGE_ROOT, '.claude', 'rules');
-    const projectRules = path.join(cliDir, 'rules');
-    if (fs.existsSync(packageRules)) {
-      copyDir(packageRules, projectRules);
-      console.log('  Copied .claude/rules/ (coding rules)');
+  // Generate the rules/instructions file (CLAUDE.md, GEMINI.md, etc.)
+  // First try to use the bridge for proper template rendering
+  try {
+    const bridgesPath = path.join(projectRoot, '.workflow', 'bridges');
+    if (fs.existsSync(bridgesPath)) {
+      const bridges = require(bridgesPath);
+      const bridge = bridges.getBridge({ projectDir: projectRoot, cliType: cliKey === 'claude' ? 'claude-code' : cliKey === 'gemini' ? 'gemini-cli' : cliKey, verbose: false });
+      if (bridge) {
+        bridge.generateRulesFile();
+        console.log(`  Created ${resources.rulesFile} (via bridge)`);
+        console.log(`  Configured ${cli.name}`);
+        return;
+      }
     }
-
-    // Copy skills from package (base skills only)
-    const packageSkills = path.join(PACKAGE_ROOT, '.claude', 'skills');
-    const projectSkills = path.join(cliDir, 'skills');
-    if (fs.existsSync(packageSkills)) {
-      copyDir(packageSkills, projectSkills);
-      console.log('  Copied .claude/skills/ (base skills)');
+  } catch (err) {
+    // Bridge not available yet - fall through to simple generation
+    if (process.env.DEBUG) {
+      console.log(`  Bridge not available: ${err.message}`);
     }
+  }
 
-    // Generate CLAUDE.md from template
-    const claudeMdTemplate = path.join(PACKAGE_ROOT, '.workflow', 'templates', 'claude-md.hbs');
-    if (fs.existsSync(claudeMdTemplate)) {
-      // For now, create a simple CLAUDE.md - the bridge will regenerate with full template
-      const claudeMd = `# Project Instructions
+  // Fallback: Create a simple rules file - the bridge will regenerate with full template
+  const simpleContent = `# Project Instructions
 
 You are an AI development assistant using the WogiFlow methodology v1.0.
 
@@ -394,13 +422,25 @@ cat .workflow/state/ready.json # Check tasks
 - \`/wogi-status\` - Project overview
 - \`/wogi-health\` - Check workflow health
 
+Run \`flow bridge sync\` to regenerate this file with full template.
+
 Generated by Wogi Flow v${config.version}
 `;
-      fs.writeFileSync(path.join(projectRoot, 'CLAUDE.md'), claudeMd);
-      console.log('  Created CLAUDE.md');
-    }
+
+  // Determine output path (handle nested paths like .opencode/agents.md)
+  const rulesFilePath = resources.rulesFile.includes('/')
+    ? path.join(projectRoot, resources.rulesFile)
+    : path.join(projectRoot, resources.rulesFile);
+
+  // Ensure parent directory exists for nested paths
+  const rulesFileDir = path.dirname(rulesFilePath);
+  if (!fs.existsSync(rulesFileDir)) {
+    fs.mkdirSync(rulesFileDir, { recursive: true });
   }
 
+  fs.writeFileSync(rulesFilePath, simpleContent);
+  console.log(`  Created ${resources.rulesFile}`);
+
   console.log(`  Configured ${cli.name}`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wogiflow",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "AI-powered development workflow management system with multi-model support",
   "main": "lib/index.js",
   "bin": {