@comfanion/workflow 4.36.22 → 4.36.23

package/package.json

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

package/src/opencode/agents/analyst.md

@@ -34,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>
@@ -43,7 +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>USE SEMANTIC SEARCH for existing docs: search({ query: "requirements", index: "docs" })</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

@@ -45,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>
@@ -56,10 +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="true">USE SEMANTIC SEARCH FIRST! Before using glob/grep, ALWAYS try search tool:
-       - search({ query: "concept", index: "docs" }) for documentation
-       - search({ query: "pattern", index: "code" }) for code exploration
-       - glob/grep ONLY for exact filenames or literal strings</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

@@ -37,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>
@@ -48,7 +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>USE SEMANTIC SEARCH for finding existing patterns: search({ query: "similar feature", index: "code" })</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

@@ -42,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>
@@ -53,7 +63,8 @@ permission:
     <r>NEVER create stories without acceptance criteria</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>USE SEMANTIC SEARCH FIRST: search({ query: "topic", index: "docs" }) before glob/grep</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">

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)
         }
       }