@comfanion/workflow 4.36.20 → 4.36.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.36.20",
+  "version": "4.36.22",
   "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.20",
-  "buildDate": "2026-01-24T17:33:20.798Z",
+  "version": "4.36.22",
+  "buildDate": "2026-01-24T17:58:25.989Z",
   "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:
@@ -41,6 +43,7 @@ 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>
   </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:
@@ -54,6 +56,10 @@ 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>
   </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:
@@ -46,6 +48,7 @@ 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>
   </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:
@@ -49,15 +51,16 @@ 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>USE SEMANTIC SEARCH FIRST: search({ query: "topic", index: "docs" }) before glob/grep</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/README.md

@@ -40,7 +40,7 @@ Checks for updates and shows a toast notification if a newer version is availabl
 - Checks npm registry for latest @comfanion/workflow version
 - Compares with locally installed version
 - Shows toast notification if update available
-- Caches check result for 24 hours (avoids spam)
+- Caches check result for 1 hour
 - Supports EN/UK/RU languages
 
 **Toast Example:**

package/src/opencode/plugins/version-check.ts

@@ -12,7 +12,7 @@ import https from "https"
  * Configuration in .opencode/config.yaml:
  *   version_check:
  *     enabled: true       # Enable version checking
- *     check_interval: 86400000  # Check once per day (ms)
+ *     check_interval: 3600000  # Check once per hour (ms)
  */
 
 const DEBUG = process.env.DEBUG?.includes('version-check') || process.env.DEBUG === '*'
@@ -118,7 +118,7 @@ async function getLanguage(directory: string): Promise<'en' | 'uk' | 'ru'> {
 }
 
 export const VersionCheckPlugin: Plugin = async ({ directory, client }) => {
-  const CHECK_INTERVAL = 24 * 60 * 60 * 1000 // 24 hours
+  const CHECK_INTERVAL = 60 * 60 * 1000 // 1 hour (you release often! 🚀)
   
   const toast = async (message: string, variant: 'info' | 'success' | 'error' = 'info') => {
     try {

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