@comfanion/workflow 4.36.24 → 4.36.25

package/README.md

@@ -12,6 +12,37 @@ AI-assisted development workflow with **semantic code search**, agents, and stru
 - 🔄 **Auto-indexing** - Background indexing on startup with fun toast notifications
 - 🎯 **Jira Integration** - Bidirectional sync with your project
 
+## Agents & Workflow
+
+The workflow uses specialized AI agents, each with a unique persona and skills:
+
+| Agent | Name | Role | Phase |
+|-------|------|------|-------|
+| 📊 **Analyst** | Sara | Requirements gathering, stakeholder interviews | Planning |
+| 📋 **PM** | Dima | PRD, epics, stories, sprint planning, Jira | Planning → Sprint |
+| 🏗️ **Architect** | Winston | System design, ADRs, coding standards | Planning |
+| 💻 **Dev** | Rick | TDD implementation, code review | Implementation |
+| ⚡ **Coder** | Morty | Quick implementation, bug fixes | Implementation |
+| 🔍 **Researcher** | Kristina | Technical/market/domain research | Any |
+| 🔄 **Change Manager** | Bruce | Documentation changes, impact analysis | Any |
+
+### Workflow Pipeline
+
+```
+Planning:    /requirements → /prd → /coding-standards → /architecture
+Sprint:      /epics → /stories → /sprint-plan → /jira-sync  
+Development: /dev-story ↔ /code-review (loop until done)
+```
+
+### Key Skills
+
+- **requirements-gathering** - Extract FR/NFR through interviews
+- **prd-writing** - Product requirements documents
+- **architecture-design** - Hexagonal/DDD patterns
+- **story-writing** - User stories with Given/When/Then AC
+- **dev-story** - Red-green-refactor implementation cycle
+- **jira-integration** - Bidirectional sync with Jira
+
 ## Quick Start
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.36.24",
+  "version": "4.36.25",
   "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.36.24",
-  "buildDate": "2026-01-24T19:02:10.302Z",
+  "version": "4.36.25",
+  "buildDate": "2026-01-24T20:24:17.710Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",

package/src/opencode/FLOW.yaml

@@ -302,7 +302,7 @@ pipeline:
 #
 agents:
   analyst:
-    name: Mary
+    name: Sara
     title: Business Analyst
     icon: "📊"
     description: Requirements Analyst - extracts FR/NFR through stakeholder interviews
@@ -323,7 +323,7 @@ agents:
       - methodologies
 
   pm:
-    name: John
+    name: Dima
     title: Product Manager
     icon: "📋"
     description: Product Manager - creates PRDs, epics, stories, sprint planning, Jira sync
@@ -371,7 +371,7 @@ agents:
       - methodologies
 
   dev:
-    name: Amelia
+    name: Rick
     title: Senior Developer
     icon: "💻"
     description: Developer - implements stories following red-green-refactor cycle
@@ -389,9 +389,25 @@ agents:
       - code-review
       - test-design
 
+  coder:
+    name: Morty
+    title: Fast Coder
+    icon: "⚡"
+    description: Fast Coder - quick implementation, bug fixes, code following patterns
+    mode: subagent
+    hidden: true  # Internal subagent, invoked by @dev
+    model: anthropic/claude-sonnet-4-20250514
+    temperature: 0.1
+    file: agents/coder.md
+    expertise:
+      - Quick implementation
+      - Bug fixes
+      - Following existing patterns
+    personality: Fast, no questions, executes or fails
+
   # Supporting Agents (not in main pipeline)
   researcher:
-    name: Alex
+    name: Kristina
     title: Researcher
     icon: "🔍"
     description: Researcher - conducts technical, market, and domain research
@@ -412,7 +428,7 @@ agents:
       - methodologies
 
   change-manager:
-    name: Charles
+    name: Bruce
     title: Change Manager
     icon: "🔄"
     description: Change Manager - manages documentation change proposals

package/src/opencode/agents/analyst.md

@@ -26,7 +26,7 @@ permission:
   bash: deny         # No bash access
 ---
 
-<agent id="analyst" name="Mary" title="Business Analyst" icon="📊">
+<agent id="analyst" name="Sara" title="Business Analyst" icon="📊">
 
 <activation critical="MANDATORY">
   <step n="1">Load persona from this agent file</step>

package/src/opencode/agents/change-manager.md

@@ -33,7 +33,7 @@ permission:
     "cp *": ask      # Copies need confirmation
 ---
 
-<agent id="change-manager" name="Charles" title="Change Manager" icon="🔄">
+<agent id="change-manager" name="Bruce" title="Change Manager" icon="🔄">
 
 <activation critical="MANDATORY">
   <step n="1">Load persona from this agent file</step>

package/src/opencode/agents/coder.md

@@ -30,7 +30,7 @@ permission:
   bash: allow        # Full bash for speed
 ---
 
-<agent id="coder" name="Swift" title="Fast Coder" icon="⚡">
+<agent id="coder" name="Morty" title="Fast Coder" icon="⚡">
 
 <activation critical="MANDATORY">
   <step n="1">Receive task from parent agent or user</step>

package/src/opencode/agents/dev.md

@@ -29,7 +29,7 @@ permission:
   webfetch: allow
 ---
 
-<agent id="dev" name="Amelia" title="Senior Developer" icon="💻">
+<agent id="dev" name="Rick" title="Senior Developer" icon="💻">
 
 <activation critical="MANDATORY">
   <step n="1">Load persona from this agent file</step>

package/src/opencode/agents/pm.md

@@ -34,7 +34,7 @@ permission:
     "git log*": allow
 ---
 
-<agent id="pm" name="John" title="Product Manager" icon="📋">
+<agent id="pm" name="Dima" title="Product Manager" icon="📋">
 
 <activation critical="MANDATORY">
   <step n="1">Load persona from this agent file</step>

package/src/opencode/agents/researcher.md

@@ -38,7 +38,7 @@ permission:
     "curl *": ask    # HTTP requests need approval
 ---
 
-<agent id="researcher" name="Alex" title="Research Specialist" icon="🔍">
+<agent id="researcher" name="Kristina" title="Research Specialist" icon="🔍">
 
 <activation critical="MANDATORY">
   <step n="1">Load persona from this agent file</step>

package/src/opencode/config.yaml

@@ -281,11 +281,15 @@ vectorizer:
         - "**/yarn.lock"
   
   # Global exclude patterns (applied to ALL indexes, in addition to per-index ignore)
+  # Patterns without * are wrapped in **/{pattern}/**
+  # NOTE: Dot-folders (.git, .claude, .idea, etc.) are already ignored by default (glob dot:false)
   exclude:
     - node_modules
-    - .git
-    - .opencode/vectors
-    - .opencode/vectorizer
+    - vendor
+    - dist
+    - build
+    - out
+    - __pycache__
 
 # =============================================================================
 # LSP (Language Server Protocol) - Code Intelligence

package/src/opencode/plugins/file-indexer.ts

@@ -51,7 +51,10 @@ const DEFAULT_CONFIG = {
     docs: { enabled: true, extensions: ['.md', '.mdx', '.txt', '.rst', '.adoc'] },
     config: { enabled: false, extensions: ['.yaml', '.yml', '.json', '.toml', '.ini', '.xml'] },
   },
-  exclude: ['node_modules', '.git', 'dist', 'build', '.opencode/vectors', '.opencode/vectorizer', 'vendor', '__pycache__'],
+  exclude: [
+    // Build & deps (dot-folders like .git, .claude, .idea are already ignored by glob default)
+    'node_modules', 'vendor', 'dist', 'build', 'out', '__pycache__',
+  ],
 }
 
 interface VectorizerConfig {

package/src/opencode/tools/search.ts

@@ -44,6 +44,7 @@ Prerequisites: Run 'npx @comfanion/workflow index --index <name>' first.`,
     limit: tool.schema.number().optional().default(5).describe("Number of results to return (default: 5)"),
     searchAll: tool.schema.boolean().optional().default(false).describe("Search all indexes instead of just one"),
     freshen: tool.schema.boolean().optional().default(true).describe("Auto-update stale files before searching (default: true)"),
+    includeArchived: tool.schema.boolean().optional().default(false).describe("Include archived files in results (default: false). Files are archived if in /archive/ folder or have 'archived: true' in frontmatter."),
   },
 
   async execute(args, context) {
@@ -88,7 +89,7 @@ Prerequisites: Run 'npx @comfanion/workflow index --index <name>' first.`,
           if (args.freshen !== false) {
             await indexer.freshen()
           }
-          const results = await indexer.search(args.query, limit)
+          const results = await indexer.search(args.query, limit, args.includeArchived)
           allResults.push(...results.map((r: any) => ({ ...r, _index: idx })))
           await indexer.unloadModel() // Free memory after each index search
         }

package/src/vectorizer/index.js

@@ -181,6 +181,30 @@ class CodebaseIndexer {
     return crypto.createHash('md5').update(content).digest('hex');
   }
 
+  /**
+   * Check if file is archived (should be excluded from default search)
+   * Archived if:
+   * - Path contains /archive/ folder
+   * - File has frontmatter with archived: true
+   */
+  isArchived(relPath, content) {
+    // Check path
+    if (relPath.includes('/archive/') || relPath.startsWith('archive/')) {
+      return true;
+    }
+    
+    // Check frontmatter (YAML between --- markers at start of file)
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (frontmatterMatch) {
+      const frontmatter = frontmatterMatch[1];
+      if (/^archived:\s*true/m.test(frontmatter)) {
+        return true;
+      }
+    }
+    
+    return false;
+  }
+
   async embed(text) {
     const model = await this.loadModel();
     const result = await model(text, { pooling: 'mean', normalize: true });
@@ -246,6 +270,7 @@ class CodebaseIndexer {
     }
 
     const chunks = this.chunkCode(content);
+    const archived = this.isArchived(relPath, content);
     const data = [];
 
     for (let i = 0; i < chunks.length; i++) {
@@ -254,7 +279,8 @@ class CodebaseIndexer {
         file: relPath,
         chunk_index: i,
         content: chunks[i],
-        vector: embedding
+        vector: embedding,
+        archived: archived
       });
     }
 
@@ -279,8 +305,11 @@ class CodebaseIndexer {
 
   /**
    * Semantic search across indexed codebase
+   * @param {string} query - Search query
+   * @param {number} limit - Max results (default 5)
+   * @param {boolean} includeArchived - Include archived files (default false)
    */
-  async search(query, limit = 5) {
+  async search(query, limit = 5, includeArchived = false) {
     const tableName = 'chunks';
     const tables = await this.db.tableNames();
     if (!tables.includes(tableName)) {
@@ -289,9 +318,18 @@ class CodebaseIndexer {
 
     const queryEmbedding = await this.embed(query);
     const table = await this.db.openTable(tableName);
-    const results = await table.search(queryEmbedding).limit(limit).execute();
     
-    return results;
+    // Fetch more results if we need to filter archived
+    const fetchLimit = includeArchived ? limit : limit * 3;
+    let results = await table.search(queryEmbedding).limit(fetchLimit).execute();
+    
+    // Filter out archived files unless explicitly requested
+    if (!includeArchived) {
+      results = results.filter(r => !r.archived);
+    }
+    
+    // Trim to requested limit
+    return results.slice(0, limit);
   }
 
   /**