@comfanion/workflow 4.36.21 → 4.36.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.36.21",
+  "version": "4.36.23",
   "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.21",
-  "buildDate": "2026-01-24T17:35:27.690Z",
+  "version": "4.36.23",
+  "buildDate": "2026-01-24T18:20:05.500Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",

package/src/opencode/agents/analyst.md

@@ -14,9 +14,11 @@ tools:
   skill: true
   question: true
   bash: false        # No shell commands needed
-  webfetch: true    # Use @researcher for web research
+  webfetch: true     # For research
   todowrite: true    # Track complex requirements gathering
   todoread: true
+  search: true       # Semantic search for existing docs/requirements
+  codeindex: true    # Check index status
 
 # Permissions - granular control
 permission:
@@ -32,6 +34,16 @@ permission:
   <step n="3">Greet user by {user_name}, communicate in {communication_language}</step>
   <step n="4">Understand user request and select appropriate skill</step>
   <step n="5">Load .opencode/skills/{skill-name}/SKILL.md and follow instructions</step>
+  
+  <search-first critical="MANDATORY - DO THIS BEFORE GLOB/GREP">
+    BEFORE using glob or grep, you MUST call search() first:
+    1. search({ query: "your topic", index: "docs" })  - for documentation
+    2. THEN use glob/grep if you need specific files
+    
+    Example: Looking for existing requirements?
+    ✅ CORRECT: search({ query: "user requirements authentication", index: "docs" })
+    ❌ WRONG: glob("**/*requirements*.md") without search first
+  </search-first>
 
   <rules>
     <r>ALWAYS communicate in {communication_language}</r>
@@ -41,6 +53,8 @@ permission:
     <r>Always validate requirements against SMART criteria</r>
     <r>Never assume - always ask clarifying questions</r>
     <r>Find and use `**/project-context.md` as source of truth if exists</r>
+    <r critical="MANDATORY">🔍 SEARCH FIRST: You MUST call search() BEFORE glob/grep when exploring.
+       search({ query: "topic", index: "docs" }) → THEN glob if needed</r>
   </rules>
 </activation>
 

package/src/opencode/agents/architect.md

@@ -8,8 +8,8 @@ tools:
   read: true
   write: true
   edit: true
-  glob: true
-  grep: true
+  glob: true         # Use ONLY for specific file patterns, prefer search for exploration
+  grep: true         # Use ONLY for exact string match, prefer search for concepts
   list: true
   skill: true
   question: true
@@ -18,6 +18,8 @@ tools:
   todowrite: true    # Architecture can be complex multi-step
   todoread: true
   lsp: true          # Code intelligence for architecture analysis
+  search: true       # PREFERRED: Semantic search for code/docs/config exploration
+  codeindex: true    # Check index status before searching
 
 # Permissions - granular control
 permission:
@@ -43,6 +45,17 @@ permission:
   <step n="3">Greet user by {user_name}, communicate in {communication_language}</step>
   <step n="4">Understand user request and select appropriate skill</step>
   <step n="5">Load .opencode/skills/{skill-name}/SKILL.md and follow instructions</step>
+  
+  <search-first critical="MANDATORY - DO THIS BEFORE GLOB/GREP">
+    BEFORE using glob or grep, you MUST call search() first:
+    1. search({ query: "your topic", index: "docs" })  - for documentation
+    2. search({ query: "your topic", index: "code" })  - for source code
+    3. THEN use glob/grep if you need specific files
+    
+    Example: Looking for database schema?
+    ✅ CORRECT: search({ query: "database schema users teams", index: "docs" })
+    ❌ WRONG: glob("**/*schema*.md") without search first
+  </search-first>
 
   <rules>
     <r>ALWAYS communicate in {communication_language}</r>
@@ -54,6 +67,8 @@ permission:
     <r>User journeys drive technical decisions</r>
     <r>Each doc file < 2000 lines (RAG-friendly)</r>
     <r>Find and use `**/project-context.md` and `CLAUDE.md` as source of truth</r>
+    <r critical="MANDATORY">🔍 SEARCH FIRST: You MUST call search() BEFORE glob/grep when exploring.
+       search({ query: "topic", index: "docs" }) → THEN glob if needed</r>
   </rules>
 </activation>
 

package/src/opencode/agents/dev.md

@@ -9,8 +9,8 @@ tools:
   write: true
   edit: true
   patch: true        # For applying diffs
-  glob: true
-  grep: true
+  glob: true         # Use for specific file patterns
+  grep: true         # Use for exact string match
   list: true
   skill: true
   question: true
@@ -19,6 +19,8 @@ tools:
   todowrite: true    # Track implementation progress
   todoread: true
   lsp: true          # Code intelligence (experimental)
+  search: true       # PREFERRED: Semantic search for finding patterns/examples
+  codeindex: true    # Check index status
 
 # Permissions - developer has full access
 permission:
@@ -35,6 +37,17 @@ permission:
   <step n="3">Greet user by {user_name}, communicate in {communication_language}</step>
   <step n="4">Understand user request and select appropriate skill</step>
   <step n="5">Load .opencode/skills/{skill-name}/SKILL.md and follow instructions</step>
+  
+  <search-first critical="MANDATORY - DO THIS BEFORE GLOB/GREP">
+    BEFORE using glob or grep, you MUST call search() first:
+    1. search({ query: "your topic", index: "code" })  - for source code patterns
+    2. search({ query: "your topic", index: "docs" })  - for documentation
+    3. THEN use glob/grep if you need specific files
+    
+    Example: Looking for similar implementation?
+    ✅ CORRECT: search({ query: "user repository CRUD", index: "code" })
+    ❌ WRONG: glob("**/*user*.go") without search first
+  </search-first>
 
   <rules>
     <r>ALWAYS communicate in {communication_language}</r>
@@ -46,6 +59,8 @@ permission:
     <r>All existing tests must pass 100% before story is ready for review</r>
     <r>NEVER lie about tests being written or passing</r>
     <r>Find and use `**/project-context.md` and `CLAUDE.md` as source of truth</r>
+    <r critical="MANDATORY">🔍 SEARCH FIRST: Call search() BEFORE glob when exploring codebase.
+       search({ query: "feature pattern", index: "code" }) → THEN glob if needed</r>
   </rules>
   
   <dev-story-workflow hint="When executing /dev-story command" critical="FOLLOW THIS EXACTLY">

package/src/opencode/agents/pm.md

@@ -8,8 +8,8 @@ tools:
   read: true
   write: true
   edit: true
-  glob: true
-  grep: true
+  glob: true         # For specific file patterns
+  grep: true         # For exact strings
   list: true
   skill: true
   question: true
@@ -17,6 +17,8 @@ tools:
   webfetch: false    # Use @researcher for web research
   todowrite: true    # PM tracks complex planning tasks
   todoread: true
+  search: true       # PREFERRED: Semantic search for docs/PRD/architecture
+  codeindex: true    # Check index status
 
 # Permissions - granular control
 permission:
@@ -40,6 +42,16 @@ permission:
   <step n="3">Greet user by {user_name}, communicate in {communication_language}</step>
   <step n="4">Understand user request and select appropriate skill</step>
   <step n="5">Load .opencode/skills/{skill-name}/SKILL.md and follow instructions</step>
+  
+  <search-first critical="MANDATORY - DO THIS BEFORE GLOB/GREP">
+    BEFORE using glob or grep, you MUST call search() first:
+    1. search({ query: "your topic", index: "docs" })  - for PRD, architecture, requirements
+    2. THEN use glob/grep if you need specific files
+    
+    Example: Looking for existing stories?
+    ✅ CORRECT: search({ query: "user authentication stories", index: "docs" })
+    ❌ WRONG: glob("**/*story*.md") without search first
+  </search-first>
 
   <rules>
     <r>ALWAYS communicate in {communication_language}</r>
@@ -49,15 +61,17 @@ permission:
     <r>Ship the smallest thing that validates the assumption</r>
     <r>Every feature must trace to a user problem</r>
     <r>NEVER create stories without acceptance criteria</r>
-    <r critical="true">BEFORE writing epic/story tasks: MUST Glob+Read coding standards (see before-epic-story)</r>
+    <r critical="true">BEFORE writing epic/story: USE SEMANTIC SEARCH (see before-epic-story)</r>
     <r>Find and use `**/project-context.md` as source of truth if exists</r>
+    <r critical="MANDATORY">🔍 SEARCH FIRST: You MUST call search() BEFORE glob/grep when exploring.
+       search({ query: "topic", index: "docs" }) → THEN glob if needed</r>
   </rules>
   
   <before-epic-story critical="MANDATORY">
     <instruction>BEFORE writing ANY epic or story with tasks, you MUST execute:</instruction>
-    <step n="1">Glob "**/AGENTS.md" OR "**/CLAUDE.md" → Read the file</step>
-    <step n="2">Glob "**/coding-standards/**/*.md" → Read ALL files found</step>
-    <step n="3">Glob "**/[module]-data-model*.md" → Read data model</step>
+    <step n="1">search({ query: "coding standards patterns conventions", index: "docs" }) → Read results</step>
+    <step n="2">search({ query: "architecture module boundaries", index: "docs" }) → Understand structure</step>
+    <step n="3">Read CLAUDE.md or AGENTS.md if found</step>
     <step n="4">Glob "**/src/services/[module]/**/domain/**/*.go" → Read 2-3 existing patterns</step>
     <step n="5">ONLY THEN proceed to write tasks with Documentation links</step>
     <warning>Tasks without proper Documentation links to coding standards = REJECTED</warning>

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

@@ -366,13 +366,12 @@ async function processPendingFiles(projectRoot: string, config: VectorizerConfig
         try {
           const wasIndexed = await indexer.indexSingleFile(filePath)
           if (wasIndexed) {
-            // Only log in debug mode, successful reindex is silent
-            debug(`Reindexed: ${path.relative(projectRoot, filePath)} -> ${indexName}`)
+            log(`Reindexed: ${path.relative(projectRoot, filePath)} → ${indexName}`)
           } else {
-            debug(`Skipped (unchanged): ${path.relative(projectRoot, filePath)}`)
+            logFile(`Skipped (unchanged): ${path.relative(projectRoot, filePath)}`)
           }
         } catch (e) {
-          debug(`Error: ${(e as Error).message}`)
+          log(`Error reindexing ${path.relative(projectRoot, filePath)}: ${(e as Error).message}`)
         }
       }
       
@@ -478,7 +477,7 @@ export const FileIndexerPlugin: Plugin = async ({ directory, client }) => {
         const props = (event as any).properties || {}
         const filePath = props.file || props.path || props.filePath
         if (filePath) {
-          debug(`${event.type}: ${filePath}`)
+          log(`Event: ${event.type} → ${filePath}`)
           queueFileForIndexing(filePath)
         }
       }

package/src/opencode/tools/search.ts

@@ -63,7 +63,7 @@ Prerequisites: Run 'npx @comfanion/workflow index --index <name>' first.`,
       const { CodebaseIndexer } = await import(`file://${vectorizerModule}`)
       
       let allResults: any[] = []
-      const limit = args.limit || 5
+      const limit = args.limit || 10
       const indexName = args.index || "code"
 
       // Auto-freshen stale files before searching