@comfanion/workflow 4.13.0 → 4.15.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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@comfanion/workflow",
3
- "version": "4.13.0",
3
+ "version": "4.15.0",
4
4
  "description": "Initialize OpenCode Workflow system for AI-assisted development with semantic code search",
5
5
  "type": "module",
6
6
  "bin": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": "3.0.0",
3
- "buildDate": "2026-01-24T10:12:31.595Z",
3
+ "buildDate": "2026-01-24T10:17:10.814Z",
4
4
  "files": [
5
5
  "config.yaml",
6
6
  "FLOW.yaml",
@@ -1,24 +1,47 @@
1
1
  ---
2
- description: "Codebase Crawler - Use when you need to understand code structure, find patterns, locate files, or gather context before implementation. Fast read-only exploration."
2
+ description: |
3
+ Codebase Crawler - Semantic search explorer.
4
+
5
+ YOUR FIRST TWO CALLS MUST BE:
6
+ 1. codeindex({ action: "list", index: "code" })
7
+ 2. codesearch({ query: "category mapping", index: "code" })
8
+
9
+ Then read the codesearch results. Done!
10
+
11
+ DO NOT USE grep OR glob BEFORE codesearch!
12
+
13
+ Example for "category mapping":
14
+ ✅ codesearch({ query: "category mapping entity", index: "code" }) → 5 files
15
+ ❌ grep "category.*mapping" → 100 matches = WRONG!
3
16
  mode: subagent
4
17
  temperature: 0.1
5
18
 
6
19
  # Tools - READ-ONLY exploration
20
+ # PRIORITY ORDER: codesearch FIRST, then grep/glob as fallback
7
21
  tools:
22
+ # PRIMARY - Use these first!
23
+ codesearch: true # ⭐ SEMANTIC SEARCH - use this FIRST for concepts
24
+ codeindex: true # Check index status
8
25
  read: true
9
- write: false # READ-ONLY
10
- edit: false # READ-ONLY
11
- patch: false # READ-ONLY
12
- glob: true
13
- grep: true
26
+
27
+ # SECONDARY - Only after codesearch
28
+ grep: true # Only for EXACT string matches
29
+ glob: true # Only for file patterns
30
+
31
+ # OTHER
14
32
  list: true
15
- skill: false # Fast exploration, no skill loading
16
- question: false # Fast, no questions
33
+ lsp: true # Code intelligence
17
34
  bash: true # Limited to read-only commands
18
- webfetch: false # No external access
19
- todowrite: false # Subagent - no todo
35
+
36
+ # DISABLED
37
+ write: false
38
+ edit: false
39
+ patch: false
40
+ skill: false
41
+ question: false
42
+ webfetch: false
43
+ todowrite: false
20
44
  todoread: false
21
- lsp: true # Code intelligence for exploration
22
45
 
23
46
  # Permissions - strict read-only
24
47
  permission:
@@ -39,26 +62,29 @@ permission:
39
62
  "rg *": allow # ripgrep
40
63
  ---
41
64
 
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
- ═══════════════════════════════════════════════════════════════════════════ -->
65
+ # ⛔ STOP! MANDATORY SEARCH ORDER ⛔
66
+
67
+ **After `codeindex list` shows indexes exist, you MUST immediately call:**
68
+
69
+ ```
70
+ codesearch({ query: "category mapping", index: "code" })
71
+ ```
72
+
73
+ **DO NOT call grep or glob until codesearch is done!**
74
+
75
+ | Step | Action | Tool |
76
+ |------|--------|------|
77
+ | 1 | Check indexes | `codeindex({ action: "list" })` |
78
+ | 2 | **SEARCH** | `codesearch({ query: "...", index: "code" })` ← DO THIS! |
79
+ | 3 | Read results | `read` top 3-5 files from codesearch |
80
+ | 4 | Only if needed | `grep` for exact string match |
81
+
82
+ ```
83
+ ❌ WRONG: codeindex list → grep → glob → 100 matches → slow
84
+ RIGHT: codeindex list → codesearch → 5 files → fast
85
+ ```
86
+
87
+ ---
62
88
 
63
89
  <agent id="crawler" name="Scout" title="Codebase Crawler" icon="🔎">
64
90