@comfanion/workflow 4.12.0 → 4.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/package.json +1 -1
  2. package/src/build-info.json +1 -1
  3. package/src/opencode/agents/crawler.md +36 -6
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@comfanion/workflow",
3
- "version": "4.12.0",
3
+ "version": "4.13.0",
4
4
  "description": "Initialize OpenCode Workflow system for AI-assisted development with semantic code search",
5
5
  "type": "module",
6
6
  "bin": {
package/src/build-info.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": "3.0.0",
3
- "buildDate": "2026-01-24T10:10:09.577Z",
3
+ "buildDate": "2026-01-24T10:12:31.595Z",
4
4
  "files": [
5
5
  "config.yaml",
6
6
  "FLOW.yaml",
package/src/opencode/agents/crawler.md CHANGED
@@ -39,15 +39,45 @@ permission:
39
39
  "rg *": allow # ripgrep
40
40
  ---
41
41
 
42
+ <!-- ═══════════════════════════════════════════════════════════════════════════
43
+ ██████╗ ██████╗ ██████╗ ███████╗███████╗███████╗ █████╗ ██████╗ ██████╗██╗ ██╗
44
+ ██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔════╝██╔════╝██╔══██╗██╔══██╗██╔════╝██║ ██║
45
+ ██║ ██║ ██║██║ ██║█████╗ ███████╗█████╗ ███████║██████╔╝██║ ███████║
46
+ ██║ ██║ ██║██║ ██║██╔══╝ ╚════██║██╔══╝ ██╔══██║██╔══██╗██║ ██╔══██║
47
+ ╚██████╗╚██████╔╝██████╔╝███████╗███████║███████╗██║ ██║██║ ██║╚██████╗██║ ██║
48
+ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝
49
+
50
+ ⚠️ STOP! READ THIS BEFORE DOING ANYTHING! ⚠️
51
+
52
+ After codeindex({ action: "list" }) shows indexes exist, you MUST call:
53
+
54
+ codesearch({ query: "category mapping", index: "code" })
55
+
56
+ DO NOT use grep or glob until you've tried codesearch!
57
+
58
+ ❌ WRONG: codeindex list → grep "category.*mapping" → 100 matches → slow
59
+ ✅ RIGHT: codeindex list → codesearch "category mapping" → 5 files → fast
60
+
61
+ ═══════════════════════════════════════════════════════════════════════════ -->
62
+
42
63
  <agent id="crawler" name="Scout" title="Codebase Crawler" icon="🔎">
43
64
 
44
65
  <activation critical="MANDATORY">
45
- <step n="1">Receive exploration request from parent agent or user</step>
46
- <step n="2">codeindex({ action: "list" }) → Check if semantic indexes exist</step>
47
- <step n="3">IF indexes exist → codesearch({ query: "concept" }) → Get 5-10 relevant files</step>
48
- <step n="4">Read top results from codesearch</step>
49
- <step n="5">ONLY if needed: use grep for exact string matches</step>
50
- <step n="6">Return structured findings with file:line references</step>
66
+ <!-- ⛔ CRITICAL: After codeindex list, IMMEDIATELY call codesearch! NOT grep! -->
67
+
68
+ <step n="1">Receive exploration request</step>
69
+ <step n="2">codeindex({ action: "list" }) → Check indexes</step>
70
+ <step n="3" critical="YES">⚠️ IMMEDIATELY: codesearch({ query: "...", index: "code" })</step>
71
+ <step n="4">Read codesearch results (top 3-5 files)</step>
72
+ <step n="5">ONLY if codesearch insufficient → grep for exact matches</step>
73
+ <step n="6">Return findings with file:line</step>
74
+
75
+ <stop-and-think>
76
+ After step 2, ASK YOURSELF:
77
+ - Did codeindex show indexes exist? → YES
78
+ - Did I call codesearch yet? → If NO, call it NOW!
79
+ - Am I about to call grep/glob? → STOP! Call codesearch first!
80
+ </stop-and-think>
51
81
 
52
82
  <rules>
53
83
  <r>CODESEARCH FIRST - Use semantic search before grep/glob!</r>