@comfanion/workflow 4.39.0-dev.0 → 4.39.1

package/bin/cli.js

@@ -54,7 +54,6 @@ program
   .option('--tdd', 'Use TDD methodology')
   .option('--stub', 'Use STUB methodology')
   .option('--full', 'Create full repo structure')
-  .option('--vectorizer', 'Install vectorizer for semantic code search')
   .action(async (options) => {
     console.log(chalk.blue.bold(`\n🚀 OpenCode Workflow v${VERSION}\n`));
     
@@ -70,9 +69,6 @@ program
       jira_url: 'https://your-domain.atlassian.net',
       jira_project: 'PROJ',
       create_repo_structure: false,
-      vectorizer_enabled: true,
-      vectorizer_auto_index: true,
-      vectorizer_model: 'Xenova/all-MiniLM-L6-v2',
       project_name: path.basename(process.cwd())
     };
     
@@ -99,19 +95,6 @@ program
           if (jiraUrlMatch) config.jira_url = jiraUrlMatch[1];
           if (jiraProjMatch) config.jira_project = jiraProjMatch[1];
           
-          // Parse vectorizer settings from vectorizer.yaml if exists
-          const vecPath = path.join(targetDir, 'vectorizer.yaml');
-          if (await fs.pathExists(vecPath)) {
-            const vecContent = await fs.readFile(vecPath, 'utf8');
-            const vEnabledMatch = vecContent.match(/enabled:\s*(true|false)/);
-            const vAutoMatch = vecContent.match(/auto_index:\s*(true|false)/);
-            const vModelMatch = vecContent.match(/model:\s*["']?([^"'\n]+)["']?/);
-            
-            if (vEnabledMatch) config.vectorizer_enabled = vEnabledMatch[1] === 'true';
-            if (vAutoMatch) config.vectorizer_auto_index = vAutoMatch[1] === 'true';
-            if (vModelMatch) config.vectorizer_model = vModelMatch[1].trim();
-          }
-          
           isUpdate = true;
         } catch (e) {
           // Could not parse, use defaults
@@ -199,40 +182,6 @@ program
           message: 'Create full repository structure (README, CONTRIBUTING, .gitignore, docs/)?',
           default: options.full || false
         },
-        {
-          type: 'confirm',
-          name: 'vectorizer_enabled',
-          message: 'Enable semantic code search (vectorizer)?',
-          default: true
-        },
-        {
-          type: 'list',
-          name: 'vectorizer_model',
-          message: 'Embedding model for semantic search:',
-          when: (answers) => answers.vectorizer_enabled,
-          choices: [
-            { 
-              name: 'MiniLM-L6 (Fast)    - ~10 files/10sec, 384 dims, good quality', 
-              value: 'Xenova/all-MiniLM-L6-v2' 
-            },
-            { 
-              name: 'BGE-small (Balanced) - ~9 files/10sec, 384 dims, better quality', 
-              value: 'Xenova/bge-small-en-v1.5' 
-            },
-            { 
-              name: 'BGE-base (Quality)   - ~3 files/10sec, 768 dims, best quality', 
-              value: 'Xenova/bge-base-en-v1.5' 
-            }
-          ],
-          default: config.vectorizer_model
-        },
-        {
-          type: 'confirm',
-          name: 'vectorizer_auto_index',
-          message: 'Enable auto-indexing? (reindex files on save)',
-          when: (answers) => answers.vectorizer_enabled,
-          default: true
-        },
         {
           type: 'checkbox',
           name: 'mcp_servers',
@@ -259,7 +208,6 @@ program
       if (options.stub) config.methodology = 'stub';
       if (options.jira) config.jira_enabled = true;
       if (options.full) config.create_repo_structure = true;
-      if (options.vectorizer) config.install_vectorizer = true;
     }
 
     const spinner = ora('Initializing OpenCode Workflow...').start();
@@ -324,7 +272,6 @@ program
       // Update config.yaml with user values
       spinner.text = 'Configuring...';
       const configPath = path.join(targetDir, 'config.yaml');
-      const vecPath = path.join(targetDir, 'vectorizer.yaml');
       let configContent;
       
       // If we had existing config, use it as base (preserves comments and formatting)
@@ -354,19 +301,6 @@ program
       
       await fs.writeFile(configPath, configContent);
 
-      // Update vectorizer.yaml
-      if (await fs.pathExists(vecPath)) {
-        let vecContent = await fs.readFile(vecPath, 'utf8');
-        vecContent = vecContent
-          .replace(/(enabled:)\s*(true|false)/, `$1 ${config.vectorizer_enabled}`)
-          .replace(/(auto_index:)\s*(true|false)/, `$1 ${config.vectorizer_auto_index}`);
-        
-        if (config.vectorizer_model) {
-          vecContent = vecContent.replace(/(model:)\s*["']?[^"'\n]+["']?/, `$1 "${config.vectorizer_model}"`);
-        }
-        await fs.writeFile(vecPath, vecContent);
-      }
-      
       // Create docs structure (always)
       spinner.text = 'Creating docs structure...';
       await fs.ensureDir(path.join(process.cwd(), 'docs'));
@@ -476,24 +410,10 @@ program
         console.log(chalk.gray('   Run manually: cd .opencode && bun install'));
       }
 
-      // Show what was done
-      const vectorizerInstalled = await fs.pathExists(path.join(targetDir, 'vectorizer', 'node_modules'));
-      if (vectorizerInstalled) {
-        console.log(chalk.green('✅ Vectorizer installed (fresh dependencies)'));
-      } else if (config.vectorizer_enabled) {
-        console.log(chalk.yellow('⚠️  Vectorizer: run `npx @comfanion/workflow vectorizer install`'));
-      } else {
-        console.log(chalk.gray('ℹ️  Vectorizer disabled (enable in config.yaml to use semantic search)'));
-      }
       if (hadVectors) {
         console.log(chalk.green('✅ Vector indexes preserved'));
       }
 
-      // Install vectorizer if requested and failed above
-      if (config.install_vectorizer && !vectorizerInstalled) {
-        await installVectorizer(targetDir);
-      }
-
       // Show summary
       console.log(chalk.yellow('\n📁 Created structure:'));
       console.log(`
@@ -559,9 +479,8 @@ program
 
 program
   .command('update')
-  .description('Update .opencode/ to latest version (preserves config.yaml and vectorizer)')
+  .description('Update .opencode/ to latest version (preserves config.yaml and vector indexes)')
   .option('--no-backup', 'Skip creating backup')
-  .option('--vectorizer', 'Update/install vectorizer too')
   .action(async (options) => {
     const spinner = ora('Updating OpenCode Workflow...').start();
     
@@ -762,27 +681,25 @@ program
       console.log(chalk.gray('  ○  Jira credentials not set'));
     }
     
-    // Check Vectorizer
-    console.log(chalk.cyan('\nVectorizer (semantic search):'));
-    const vectorsExist = await fs.pathExists(path.join(process.cwd(), '.opencode', 'vectors', 'code', 'hashes.json'));
-    
-    // Check vectorizer config
-    let vectorizerEnabled = true;
-    let autoIndexEnabled = true;
+    // Check Semantic Search plugin
+    console.log(chalk.cyan('\nSemantic search (@comfanion/usethis_search):'));
     try {
-      const vecConfigContent = await fs.readFile(path.join(process.cwd(), '.opencode/vectorizer.yaml'), 'utf8');
-      const vecEnabledMatch = vecConfigContent.match(/enabled:\s*(true|false)/);
-      const autoIndexMatch = vecConfigContent.match(/auto_index:\s*(true|false)/);
-      if (vecEnabledMatch) vectorizerEnabled = vecEnabledMatch[1] === 'true';
-      if (autoIndexMatch) autoIndexEnabled = autoIndexMatch[1] === 'true';
-    } catch {}
-    
-    console.log(vectorizerEnabled 
-      ? chalk.green('  ✅ Enabled in config')
-      : chalk.yellow('  ⚠️  Disabled in config'));
-    console.log(autoIndexEnabled
-      ? chalk.green('  ✅ Auto-index: ON')
-      : chalk.gray('  ○  Auto-index: OFF'));
+      const opcPath = path.join(process.cwd(), 'opencode.json');
+      if (await fs.pathExists(opcPath)) {
+        const opc = JSON.parse(await fs.readFile(opcPath, 'utf8'));
+        const plugins = opc.plugin || [];
+        if (plugins.includes('@comfanion/usethis_search')) {
+          console.log(chalk.green('  ✅ Plugin registered in opencode.json'));
+        } else {
+          console.log(chalk.yellow('  ⚠️  Plugin not in opencode.json (add "@comfanion/usethis_search" to plugin array)'));
+        }
+      } else {
+        console.log(chalk.gray('  ○  No opencode.json found'));
+      }
+    } catch {
+      console.log(chalk.gray('  ○  Could not check opencode.json'));
+    }
+    const vectorsExist = await fs.pathExists(path.join(process.cwd(), '.opencode', 'vectors', 'code', 'hashes.json'));
     if (vectorsExist) {
       try {
         const hashes = await fs.readJSON(path.join(process.cwd(), '.opencode', 'vectors', 'code', 'hashes.json'));
@@ -791,14 +708,7 @@ program
         console.log(chalk.gray('  ○  Not indexed yet'));
       }
     } else {
-      console.log(chalk.gray('  ○  Not indexed (will index on startup)'));
-    }
-    
-    // Check LSP env
-    if (process.env.OPENCODE_EXPERIMENTAL_LSP_TOOL === 'true' || process.env.OPENCODE_EXPERIMENTAL === 'true') {
-      console.log(chalk.green('  ✅ LSP tool enabled'));
-    } else {
-      console.log(chalk.gray('  ○  LSP tool disabled (set OPENCODE_EXPERIMENTAL_LSP_TOOL=true)'));
+      console.log(chalk.gray('  ○  Not indexed (will index on first startup with plugin)'));
     }
     
     console.log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.39.0-dev.0",
+  "version": "4.39.1",
   "description": "Initialize OpenCode Workflow system for AI-assisted development with semantic code search",
   "type": "module",
   "bin": {

package/src/build-info.json

@@ -1,6 +1,6 @@
 {
-  "version": "4.39.0-dev.0",
-  "buildDate": "2026-01-28T23:02:57.835Z",
+  "version": "4.39.1",
+  "buildDate": "2026-01-29T22:52:34.568Z",
   "files": [
     ".gitignore",
     "config.yaml",
@@ -12,7 +12,6 @@
     "commands",
     "mcp",
     "package.json",
-    "opencode.json",
-    "vectorizer.yaml"
+    "opencode.json"
   ]
 }

package/src/opencode/agents/architect.md

@@ -67,6 +67,7 @@ permission:
     <r>ALWAYS write technical documentation in ENGLISH (docs/ folder)</r>
     <r>Translations go to docs/confluence/ folder</r>
     <r critical="MANDATORY">📚 LOAD SKILL FIRST: Before creating any document (architecture/ADR/unit/coding-standards), MUST load appropriate skill</r>
+    <r recommended="true">📝 For large docs (1000+ lines): prefer template → fill incrementally (better performance & quality)</r>
     <r>Always check existing codebase patterns in CLAUDE.md before proposing new patterns</r>
     <r>Document all decisions with ADRs and clear rationale</r>
     <r>Never skip NFR analysis</r>
@@ -114,8 +115,12 @@ permission:
        - LARGE: 2000-4000 lines, multiple files, DOMAINS
        - ENTERPRISE: 4000+ lines, per-domain files
     
+    REALITY CHECK: Most projects are TOY (30%) or SMALL (40%), MEDIUM+ (30%)
+    Default assumption: TOY/SMALL until proven otherwise
+    
     Example:
     - PRD says "TOY" → Write 350 lines, 3 components, NO modules
+    - PRD says "SMALL" → Write 700 lines, simple structure, NO modules
     - PRD says "MEDIUM" → Write 1500 lines, 3 MODULES with Unit docs
     
     DON'T write 2000-line architecture for Tetris!
@@ -130,9 +135,11 @@ permission:
   </phase>
 
   <phase name="3. Execution">
+    <action>For large docs (1000+ lines): Create template → fill section by section (better performance)</action>
+    <action>For small docs: Can write directly</action>
     <action>Work through tasklist sequentially</action>
     <action>Mark tasks in_progress → completed</action>
-    <action>If uncertain about something — ask, don't assume</action>
+    <action>If uncertain — ask, don't assume</action>
   </phase>
 
   <phase name="4. Review">
@@ -142,10 +149,8 @@ permission:
 
   <never-do>
     - Start creating files WITHOUT loading the skill first
-    - Start creating files before user confirms the plan
     - Skip the tasklist for complex work
     - Assume what user wants without asking
-    - Create all files at once without progress updates
   </never-do>
 </workflow>
 

package/src/opencode/agents/pm.md

@@ -64,6 +64,7 @@ permission:
     <r>ALWAYS write technical documentation in ENGLISH (docs/ folder)</r>
     <r>Translations go to docs/confluence/ folder</r>
     <r critical="MANDATORY">📚 LOAD SKILL FIRST: Before creating any document (PRD/epic/story), MUST load appropriate skill</r>
+    <r recommended="true">📝 For large docs (PRD, epics): prefer template → fill incrementally (better performance)</r>
     <r>PRDs emerge from user interviews, not template filling</r>
     <r>Ship the smallest thing that validates the assumption</r>
     <r>Every feature must trace to a user problem</r>
@@ -112,9 +113,12 @@ permission:
   </phase>
 
   <phase name="3. Execution">
+    <action>For large docs (PRD 1000+ lines): Create template → fill section by section (better performance)</action>
+    <action>For PRD: Start with "Project Classification" section FIRST</action>
+    <action>For small docs (stories, epics): Can write directly</action>
     <action>Work through tasklist sequentially</action>
     <action>Mark tasks in_progress → completed</action>
-    <action>If uncertain about something — ask, don't assume</action>
+    <action>If uncertain — ask, don't assume</action>
   </phase>
 
   <phase name="4. Review">
@@ -124,10 +128,9 @@ permission:
 
   <never-do>
     - Start writing docs WITHOUT loading the skill first
-    - Start writing docs before user confirms the plan
     - Skip the tasklist for complex work
     - Assume what user wants without asking
-    - Create all documents at once without progress updates
+    - For PRD: Skip "Project Classification" section or fill it last (MUST BE FIRST!)
   </never-do>
 </workflow>
 
@@ -162,6 +165,9 @@ permission:
     5. Fill Project Classification table in PRD (first section!)
     6. Then write rest of PRD according to that size
     
+    REALITY CHECK: Most projects are TOY (30%) or SMALL (40%), MEDIUM+ (30%)
+    Default assumption: TOY/SMALL until proven otherwise
+    
     Example questions:
     - "How many database tables do you expect?" (5-10 = SMALL, 20+ = MEDIUM)
     - "How many external integrations?" (0-2 = SMALL, 3-5 = MEDIUM)

package/src/opencode/gitignore

@@ -9,6 +9,7 @@ vectorizer/node_modules/
 
 # Vectorizer cache (re-indexable, large binary files)
 vectors/
+graph/
 
 # Build artifacts (regenerated by npm run build)
 cli/src/

package/src/opencode/vectorizer.yaml

@@ -1,45 +0,0 @@
-vectorizer:
-  # Enable/disable vectorizer functionality
-  enabled: true
-
-  # Auto-index files when they change (requires file-indexer plugin)
-  auto_index: true
-
-  # Debounce time in ms (wait before indexing after file change)
-  debounce_ms: 1000
-
-  # Indexes to maintain - each has pattern (what to include) and ignore (what to skip)
-  indexes:
-
-    # Documentation index - markdown, text files
-    docs:
-      enabled: true
-      pattern: "docs/**/*.{md,mdx,txt,rst,adoc}"
-      ignore: []
-
-    # Configuration index - yaml, json, toml
-    config:
-      enabled: false
-      pattern: "**/*.{yaml,yml,json,toml,ini}"
-      ignore:
-        - "**/node_modules/**"
-        - "**/.git/**"
-        - "**/dist/**"
-        - "**/build/**"
-        - "**/.opencode/**"
-        - "**/docs/**"
-        - "**/vendor/**"
-        - "**/__pycache__/**"
-        - "**/*.min.js"
-        - "**/*.bundle.js"
-        - "**/package-lock.json"
-        - "**/yarn.lock"
-
-  # Global exclude patterns (applied to ALL indexes, in addition to per-index ignore)
-  exclude:
-    - node_modules
-    - vendor
-    - dist
-    - build
-    - out
-    - __pycache__