wogiflow 1.0.50 → 1.1.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/.claude/docs/commands.md +3 -3
- package/.claude/docs/knowledge-base/configuration/all-options.md +3 -56
- package/README.md +0 -14
- package/package.json +1 -1
- package/.claude/docs/knowledge-base/01-setup-onboarding/team-setup.md +0 -346
- package/.claude/docs/knowledge-base/02-task-execution/sync-daemon.md +0 -96
- package/.claude/docs/knowledge-base/03-self-improvement/team-learning.md +0 -342
- package/.claude/docs/knowledge-base/04-memory-context/team-history.md +0 -317
- package/scripts/flow-sync-daemon.js +0 -654
- package/scripts/flow-team-dashboard.js +0 -748
- package/scripts/flow-team-sync.js +0 -752
- package/scripts/flow-team.js +0 -977
package/.claude/docs/commands.md
CHANGED
|
@@ -66,7 +66,7 @@ When user types these commands, execute the corresponding action immediately.
|
|
|
66
66
|
| Command | Action |
|
|
67
67
|
|---------|--------|
|
|
68
68
|
| `/wogi-export [name]` | Export CLAUDE.md, agents/, config.json to a shareable zip. Ask about including decisions.md. |
|
|
69
|
-
| `/wogi-import [file]` | Import
|
|
69
|
+
| `/wogi-import [file]` | Import workflow profile. Merge or replace workflow config. Restart required after. |
|
|
70
70
|
| `/wogi-changelog` | Generate CHANGELOG.md from request-log entries. Group by type (added, changed, fixed). |
|
|
71
71
|
|
|
72
72
|
### Browser Testing (Claude Extension)
|
|
@@ -187,8 +187,8 @@ npx flow onboard # Analyze existing project & set up context
|
|
|
187
187
|
./scripts/flow session-learning # Analyze session for patterns (standalone)
|
|
188
188
|
./scripts/flow search "#tag" # Search request-log
|
|
189
189
|
./scripts/flow context TASK-X # Load task context
|
|
190
|
-
./scripts/flow export-profile # Export workflow config
|
|
191
|
-
./scripts/flow import-profile # Import
|
|
190
|
+
./scripts/flow export-profile # Export workflow config as shareable profile
|
|
191
|
+
./scripts/flow import-profile # Import workflow profile
|
|
192
192
|
./scripts/flow archive # Archive old request-log entries
|
|
193
193
|
./scripts/flow watch # Run file watcher for auto-validation
|
|
194
194
|
|
|
@@ -61,7 +61,7 @@ Configuration lives in `.workflow/config.json`
|
|
|
61
61
|
| [memory](#memory) | Fact storage |
|
|
62
62
|
| [automaticMemory](#automaticmemory) | Memory management |
|
|
63
63
|
| [automaticPromotion](#automaticpromotion) | Pattern promotion |
|
|
64
|
-
| [knowledgeRouting](#knowledgerouting) |
|
|
64
|
+
| [knowledgeRouting](#knowledgerouting) | Knowledge routing |
|
|
65
65
|
| [modelAdapters](#modeladapters) | Per-model learning |
|
|
66
66
|
| [prd](#prd) | PRD chunking |
|
|
67
67
|
|
|
@@ -96,7 +96,6 @@ Configuration lives in `.workflow/config.json`
|
|
|
96
96
|
### Category 7: Integrations
|
|
97
97
|
| Section | Purpose |
|
|
98
98
|
|---------|---------|
|
|
99
|
-
| [team](#team) | Team sync |
|
|
100
99
|
| [agents](#agents) | Agent personas |
|
|
101
100
|
| [multiApproach](#multiapproach) | Multiple solution analysis |
|
|
102
101
|
| [hooks](#hooks) | CLI hooks (Claude Code, etc.) |
|
|
@@ -1231,56 +1230,6 @@ Session persistence configuration.
|
|
|
1231
1230
|
|
|
1232
1231
|
---
|
|
1233
1232
|
|
|
1234
|
-
## team
|
|
1235
|
-
|
|
1236
|
-
Team sync configuration.
|
|
1237
|
-
|
|
1238
|
-
```json
|
|
1239
|
-
{
|
|
1240
|
-
"team": {
|
|
1241
|
-
"enabled": false,
|
|
1242
|
-
"teamId": null,
|
|
1243
|
-
"userId": null,
|
|
1244
|
-
"setupId": null,
|
|
1245
|
-
"projectId": null,
|
|
1246
|
-
"apiKey": null,
|
|
1247
|
-
"backendUrl": "https://api.wogi-flow.com",
|
|
1248
|
-
"syncInterval": 300000,
|
|
1249
|
-
"autoSync": true,
|
|
1250
|
-
"projectScope": true,
|
|
1251
|
-
"sync": {
|
|
1252
|
-
"decisions": true,
|
|
1253
|
-
"appMap": true,
|
|
1254
|
-
"componentIndex": true,
|
|
1255
|
-
"skills": true,
|
|
1256
|
-
"memory": true,
|
|
1257
|
-
"requestLog": "recent",
|
|
1258
|
-
"tasks": false
|
|
1259
|
-
},
|
|
1260
|
-
"conflictResolution": "newest-wins"
|
|
1261
|
-
}
|
|
1262
|
-
}
|
|
1263
|
-
```
|
|
1264
|
-
|
|
1265
|
-
| Option | Type | Default | Description |
|
|
1266
|
-
|--------|------|---------|-------------|
|
|
1267
|
-
| `enabled` | boolean | `false` | Enable team sync |
|
|
1268
|
-
| `teamId` | string | `null` | Team identifier |
|
|
1269
|
-
| `userId` | string | `null` | User identifier |
|
|
1270
|
-
| `backendUrl` | string | `"https://api.wogi-flow.com"` | Backend URL |
|
|
1271
|
-
| `syncInterval` | number | `300000` | Sync interval in ms |
|
|
1272
|
-
| `autoSync` | boolean | `true` | Auto-sync enabled |
|
|
1273
|
-
| `sync.decisions` | boolean | `true` | Sync decisions |
|
|
1274
|
-
| `sync.appMap` | boolean | `true` | Sync app-map |
|
|
1275
|
-
| `sync.componentIndex` | boolean | `true` | Sync component index |
|
|
1276
|
-
| `sync.skills` | boolean | `true` | Sync skills |
|
|
1277
|
-
| `sync.memory` | boolean | `true` | Sync memory |
|
|
1278
|
-
| `sync.requestLog` | string | `"recent"` | `"all"`, `"recent"`, or `false` |
|
|
1279
|
-
| `sync.tasks` | boolean | `false` | Sync tasks |
|
|
1280
|
-
| `conflictResolution` | string | `"newest-wins"` | Conflict resolution strategy |
|
|
1281
|
-
|
|
1282
|
-
---
|
|
1283
|
-
|
|
1284
1233
|
## memory
|
|
1285
1234
|
|
|
1286
1235
|
Fact storage configuration.
|
|
@@ -1309,7 +1258,7 @@ Fact storage configuration.
|
|
|
1309
1258
|
|
|
1310
1259
|
## knowledgeRouting
|
|
1311
1260
|
|
|
1312
|
-
|
|
1261
|
+
Knowledge routing configuration.
|
|
1313
1262
|
|
|
1314
1263
|
```json
|
|
1315
1264
|
{
|
|
@@ -1408,8 +1357,7 @@ Pattern promotion configuration.
|
|
|
1408
1357
|
"threshold": 3,
|
|
1409
1358
|
"minRelevance": 0.8,
|
|
1410
1359
|
"destinations": ["decisions.md"],
|
|
1411
|
-
"requireApproval": true
|
|
1412
|
-
"autoApplyTeamApproved": true
|
|
1360
|
+
"requireApproval": true
|
|
1413
1361
|
}
|
|
1414
1362
|
}
|
|
1415
1363
|
```
|
|
@@ -1421,7 +1369,6 @@ Pattern promotion configuration.
|
|
|
1421
1369
|
| `minRelevance` | number | `0.8` | Min relevance score |
|
|
1422
1370
|
| `destinations` | array | `["decisions.md"]` | Where to promote |
|
|
1423
1371
|
| `requireApproval` | boolean | `true` | Require user approval |
|
|
1424
|
-
| `autoApplyTeamApproved` | boolean | `true` | Auto-apply team approved |
|
|
1425
1372
|
|
|
1426
1373
|
---
|
|
1427
1374
|
|
package/README.md
CHANGED
|
@@ -242,20 +242,6 @@ After 3+ similar corrections → promotes to permanent instruction.
|
|
|
242
242
|
|
|
243
243
|
---
|
|
244
244
|
|
|
245
|
-
## Team Sharing
|
|
246
|
-
|
|
247
|
-
```bash
|
|
248
|
-
# Export your refined workflow
|
|
249
|
-
flow export-profile "team-v1"
|
|
250
|
-
|
|
251
|
-
# Share the zip file with team
|
|
252
|
-
|
|
253
|
-
# Others import
|
|
254
|
-
flow import-profile team-v1.zip
|
|
255
|
-
```
|
|
256
|
-
|
|
257
|
-
---
|
|
258
|
-
|
|
259
245
|
## License
|
|
260
246
|
|
|
261
247
|
AGPL-3.0
|
package/package.json
CHANGED
|
@@ -1,346 +0,0 @@
|
|
|
1
|
-
# Team Setup
|
|
2
|
-
|
|
3
|
-
Configure team sync and shared knowledge.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## Purpose
|
|
8
|
-
|
|
9
|
-
Team features enable:
|
|
10
|
-
- **Shared Decisions**: Team-wide coding patterns
|
|
11
|
-
- **Knowledge Transfer**: Share learnings across projects
|
|
12
|
-
- **Consistent Configuration**: Import/export workflow profiles
|
|
13
|
-
- **Audit Trails**: Track changes across team members
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## Quick Start
|
|
18
|
-
|
|
19
|
-
### Export Your Profile
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
/wogi-export
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
Creates a shareable profile with your configuration.
|
|
26
|
-
|
|
27
|
-
### Import Team Profile
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
/wogi-import
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
Import a team's shared configuration.
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
37
|
-
## Configuration
|
|
38
|
-
|
|
39
|
-
```json
|
|
40
|
-
{
|
|
41
|
-
"team": {
|
|
42
|
-
"enabled": false,
|
|
43
|
-
"teamId": null,
|
|
44
|
-
"userId": null,
|
|
45
|
-
"projectId": null,
|
|
46
|
-
"apiKey": null,
|
|
47
|
-
"backendUrl": "https://api.wogi-flow.com",
|
|
48
|
-
"syncInterval": 300000,
|
|
49
|
-
"autoSync": true,
|
|
50
|
-
"sync": {
|
|
51
|
-
"decisions": true,
|
|
52
|
-
"appMap": true,
|
|
53
|
-
"componentIndex": true,
|
|
54
|
-
"skills": true,
|
|
55
|
-
"memory": true,
|
|
56
|
-
"requestLog": "recent",
|
|
57
|
-
"tasks": false
|
|
58
|
-
},
|
|
59
|
-
"conflictResolution": "newest-wins"
|
|
60
|
-
}
|
|
61
|
-
}
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
---
|
|
65
|
-
|
|
66
|
-
## What Gets Synced
|
|
67
|
-
|
|
68
|
-
| Item | Default | Description |
|
|
69
|
-
|------|---------|-------------|
|
|
70
|
-
| `decisions` | `true` | Coding patterns and conventions |
|
|
71
|
-
| `appMap` | `true` | Component registry |
|
|
72
|
-
| `componentIndex` | `true` | Auto-scanned components |
|
|
73
|
-
| `skills` | `true` | Installed skill packages |
|
|
74
|
-
| `memory` | `true` | Learned facts and patterns |
|
|
75
|
-
| `requestLog` | `"recent"` | Change history (recent only) |
|
|
76
|
-
| `tasks` | `false` | Task queues |
|
|
77
|
-
|
|
78
|
-
---
|
|
79
|
-
|
|
80
|
-
## Profile Export
|
|
81
|
-
|
|
82
|
-
```bash
|
|
83
|
-
/wogi-export
|
|
84
|
-
|
|
85
|
-
# Output:
|
|
86
|
-
# 📤 Exporting workflow profile...
|
|
87
|
-
#
|
|
88
|
-
# Profile includes:
|
|
89
|
-
# - config.json settings
|
|
90
|
-
# - decisions.md patterns
|
|
91
|
-
# - app-map.md components
|
|
92
|
-
# - Installed skills
|
|
93
|
-
#
|
|
94
|
-
# Saved to: .workflow/exports/profile-2024-01-15.json
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
### Export File Structure
|
|
98
|
-
|
|
99
|
-
```json
|
|
100
|
-
{
|
|
101
|
-
"version": "2.0.0",
|
|
102
|
-
"exportedAt": "2024-01-15T10:30:00Z",
|
|
103
|
-
"exportedBy": "user-id",
|
|
104
|
-
"config": {...},
|
|
105
|
-
"state": {
|
|
106
|
-
"decisions": "...",
|
|
107
|
-
"appMap": "..."
|
|
108
|
-
},
|
|
109
|
-
"skills": ["react", "nestjs"]
|
|
110
|
-
}
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
115
|
-
## Profile Import
|
|
116
|
-
|
|
117
|
-
```bash
|
|
118
|
-
/wogi-import
|
|
119
|
-
|
|
120
|
-
# Prompts for:
|
|
121
|
-
# - Profile file path or URL
|
|
122
|
-
# - What to import (all or select)
|
|
123
|
-
# - Conflict resolution preference
|
|
124
|
-
```
|
|
125
|
-
|
|
126
|
-
### Import Options
|
|
127
|
-
|
|
128
|
-
| Option | Description |
|
|
129
|
-
|--------|-------------|
|
|
130
|
-
| Import all | Full profile replacement |
|
|
131
|
-
| Select items | Choose specific parts |
|
|
132
|
-
| Merge | Combine with existing |
|
|
133
|
-
| Replace | Overwrite existing |
|
|
134
|
-
|
|
135
|
-
---
|
|
136
|
-
|
|
137
|
-
## Team Sync (Future)
|
|
138
|
-
|
|
139
|
-
When team backend is available:
|
|
140
|
-
|
|
141
|
-
### Enable Team Mode
|
|
142
|
-
|
|
143
|
-
```json
|
|
144
|
-
{
|
|
145
|
-
"team": {
|
|
146
|
-
"enabled": true,
|
|
147
|
-
"teamId": "team-123",
|
|
148
|
-
"apiKey": "your-api-key"
|
|
149
|
-
}
|
|
150
|
-
}
|
|
151
|
-
```
|
|
152
|
-
|
|
153
|
-
### Auto-Sync Behavior
|
|
154
|
-
|
|
155
|
-
1. **On Session Start**: Pull latest team changes
|
|
156
|
-
2. **On Session End**: Push local changes
|
|
157
|
-
3. **Continuous**: Sync every 5 minutes (configurable)
|
|
158
|
-
|
|
159
|
-
### Conflict Resolution
|
|
160
|
-
|
|
161
|
-
```json
|
|
162
|
-
{
|
|
163
|
-
"team": {
|
|
164
|
-
"conflictResolution": "newest-wins"
|
|
165
|
-
}
|
|
166
|
-
}
|
|
167
|
-
```
|
|
168
|
-
|
|
169
|
-
Options:
|
|
170
|
-
- `newest-wins` - Latest timestamp wins
|
|
171
|
-
- `local-wins` - Prefer local changes
|
|
172
|
-
- `remote-wins` - Prefer team changes
|
|
173
|
-
- `ask` - Prompt for each conflict
|
|
174
|
-
|
|
175
|
-
---
|
|
176
|
-
|
|
177
|
-
## Knowledge Routing
|
|
178
|
-
|
|
179
|
-
Control where learnings go:
|
|
180
|
-
|
|
181
|
-
```json
|
|
182
|
-
{
|
|
183
|
-
"knowledgeRouting": {
|
|
184
|
-
"autoDetect": true,
|
|
185
|
-
"confirmWithUser": true,
|
|
186
|
-
"defaultScope": "local"
|
|
187
|
-
}
|
|
188
|
-
}
|
|
189
|
-
```
|
|
190
|
-
|
|
191
|
-
### Routing Logic
|
|
192
|
-
|
|
193
|
-
```
|
|
194
|
-
New Pattern Learned
|
|
195
|
-
↓
|
|
196
|
-
┌─────────────────────────────────────────┐
|
|
197
|
-
│ Is this project-specific? │
|
|
198
|
-
├─────────────────────────────────────────┤
|
|
199
|
-
│ YES → Save to local decisions.md │
|
|
200
|
-
│ NO → Continue │
|
|
201
|
-
└─────────────────────────────────────────┘
|
|
202
|
-
↓
|
|
203
|
-
┌─────────────────────────────────────────┐
|
|
204
|
-
│ Is this team-applicable? │
|
|
205
|
-
├─────────────────────────────────────────┤
|
|
206
|
-
│ YES → Promote to team (with approval) │
|
|
207
|
-
│ NO → Keep local │
|
|
208
|
-
└─────────────────────────────────────────┘
|
|
209
|
-
```
|
|
210
|
-
|
|
211
|
-
---
|
|
212
|
-
|
|
213
|
-
## Automatic Promotion
|
|
214
|
-
|
|
215
|
-
Share valuable patterns team-wide:
|
|
216
|
-
|
|
217
|
-
```json
|
|
218
|
-
{
|
|
219
|
-
"automaticPromotion": {
|
|
220
|
-
"enabled": false,
|
|
221
|
-
"threshold": 3, // Uses before promoting
|
|
222
|
-
"minRelevance": 0.8,
|
|
223
|
-
"destinations": ["decisions.md"],
|
|
224
|
-
"requireApproval": true,
|
|
225
|
-
"autoApplyTeamApproved": true
|
|
226
|
-
}
|
|
227
|
-
}
|
|
228
|
-
```
|
|
229
|
-
|
|
230
|
-
### Promotion Flow
|
|
231
|
-
|
|
232
|
-
1. Pattern used successfully 3+ times
|
|
233
|
-
2. Relevance score > 0.8
|
|
234
|
-
3. Suggest promotion to team
|
|
235
|
-
4. Team admin approves
|
|
236
|
-
5. Pattern synced to all team members
|
|
237
|
-
|
|
238
|
-
---
|
|
239
|
-
|
|
240
|
-
## Manual Setup (No Backend)
|
|
241
|
-
|
|
242
|
-
Without team backend, use file-based sharing:
|
|
243
|
-
|
|
244
|
-
### Share Configuration
|
|
245
|
-
|
|
246
|
-
```bash
|
|
247
|
-
# Export
|
|
248
|
-
/wogi-export
|
|
249
|
-
# Share: .workflow/exports/profile-2024-01-15.json
|
|
250
|
-
|
|
251
|
-
# Import on other machine
|
|
252
|
-
/wogi-import
|
|
253
|
-
# Select exported file
|
|
254
|
-
```
|
|
255
|
-
|
|
256
|
-
### Share via Git
|
|
257
|
-
|
|
258
|
-
```bash
|
|
259
|
-
# Include workflow in repo
|
|
260
|
-
git add .workflow/
|
|
261
|
-
git commit -m "Share workflow config"
|
|
262
|
-
git push
|
|
263
|
-
```
|
|
264
|
-
|
|
265
|
-
Team members:
|
|
266
|
-
```bash
|
|
267
|
-
git pull
|
|
268
|
-
# Workflow config now shared
|
|
269
|
-
```
|
|
270
|
-
|
|
271
|
-
---
|
|
272
|
-
|
|
273
|
-
## Multi-Project Setup
|
|
274
|
-
|
|
275
|
-
For multiple projects:
|
|
276
|
-
|
|
277
|
-
### Shared Team Profile
|
|
278
|
-
|
|
279
|
-
```json
|
|
280
|
-
{
|
|
281
|
-
"team": {
|
|
282
|
-
"projectScope": true // Scope to current project
|
|
283
|
-
}
|
|
284
|
-
}
|
|
285
|
-
```
|
|
286
|
-
|
|
287
|
-
### Cross-Project Knowledge
|
|
288
|
-
|
|
289
|
-
```json
|
|
290
|
-
{
|
|
291
|
-
"team": {
|
|
292
|
-
"projectScope": false // Share across all projects
|
|
293
|
-
}
|
|
294
|
-
}
|
|
295
|
-
```
|
|
296
|
-
|
|
297
|
-
---
|
|
298
|
-
|
|
299
|
-
## Commands
|
|
300
|
-
|
|
301
|
-
| Command | Purpose |
|
|
302
|
-
|---------|---------|
|
|
303
|
-
| `/wogi-import` | Import team profile |
|
|
304
|
-
| `/wogi-export` | Export current profile |
|
|
305
|
-
| `/wogi-health` | Check team sync status |
|
|
306
|
-
|
|
307
|
-
---
|
|
308
|
-
|
|
309
|
-
## Best Practices
|
|
310
|
-
|
|
311
|
-
1. **Export Before Major Changes**: Create backup profile
|
|
312
|
-
2. **Review Imported Config**: Check for conflicts
|
|
313
|
-
3. **Use Project Scope**: Keep project-specific decisions local
|
|
314
|
-
4. **Regular Sync**: Keep team knowledge up-to-date
|
|
315
|
-
5. **Document Team Decisions**: Use decisions.md for patterns
|
|
316
|
-
|
|
317
|
-
---
|
|
318
|
-
|
|
319
|
-
## Troubleshooting
|
|
320
|
-
|
|
321
|
-
### Import Fails
|
|
322
|
-
|
|
323
|
-
```bash
|
|
324
|
-
# Check file format
|
|
325
|
-
node -e "JSON.parse(require('fs').readFileSync('profile.json'))"
|
|
326
|
-
```
|
|
327
|
-
|
|
328
|
-
### Sync Conflicts
|
|
329
|
-
|
|
330
|
-
Check sync status:
|
|
331
|
-
```bash
|
|
332
|
-
/wogi-health
|
|
333
|
-
# Shows sync status and conflicts
|
|
334
|
-
```
|
|
335
|
-
|
|
336
|
-
### Missing Team Features
|
|
337
|
-
|
|
338
|
-
Team backend is optional. Most features work with file-based sharing.
|
|
339
|
-
|
|
340
|
-
---
|
|
341
|
-
|
|
342
|
-
## Related
|
|
343
|
-
|
|
344
|
-
- [Configuration Reference](../configuration/all-options.md)
|
|
345
|
-
- [Self-Improvement](../03-self-improvement/) - Knowledge learning
|
|
346
|
-
- [Memory & Context](../04-memory-context/) - Memory systems
|
|
@@ -1,96 +0,0 @@
|
|
|
1
|
-
# Background Sync Daemon
|
|
2
|
-
|
|
3
|
-
Keep workflow state synchronized in the background.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## Overview
|
|
8
|
-
|
|
9
|
-
The sync daemon watches for changes and keeps state files fresh across multiple agent sessions or branches.
|
|
10
|
-
|
|
11
|
-
**Script**: `flow-sync-daemon.js`
|
|
12
|
-
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
## Commands
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
# Start the daemon
|
|
19
|
-
flow sync-daemon start
|
|
20
|
-
|
|
21
|
-
# Stop the daemon
|
|
22
|
-
flow sync-daemon stop
|
|
23
|
-
|
|
24
|
-
# Check status
|
|
25
|
-
flow sync-daemon status
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
---
|
|
29
|
-
|
|
30
|
-
## Configuration
|
|
31
|
-
|
|
32
|
-
Add to `.workflow/config.json`:
|
|
33
|
-
|
|
34
|
-
```json
|
|
35
|
-
{
|
|
36
|
-
"syncDaemon": {
|
|
37
|
-
"enabled": true,
|
|
38
|
-
"watchPaths": [".workflow/state/"],
|
|
39
|
-
"syncOnChange": true,
|
|
40
|
-
"syncOnBranchSwitch": true,
|
|
41
|
-
"heartbeatMs": 5000
|
|
42
|
-
}
|
|
43
|
-
}
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
---
|
|
47
|
-
|
|
48
|
-
## Watched Paths
|
|
49
|
-
|
|
50
|
-
By default, the daemon watches:
|
|
51
|
-
|
|
52
|
-
- `.workflow/state/` - All state files
|
|
53
|
-
- `.workflow/memory/` - Memory database changes
|
|
54
|
-
- `ready.json` - Task queue changes
|
|
55
|
-
|
|
56
|
-
---
|
|
57
|
-
|
|
58
|
-
## Use Cases
|
|
59
|
-
|
|
60
|
-
### Multi-Agent Workflows
|
|
61
|
-
|
|
62
|
-
When running multiple Claude Code sessions:
|
|
63
|
-
- Daemon keeps `ready.json` in sync
|
|
64
|
-
- Prevents task conflicts
|
|
65
|
-
- Shares completion status
|
|
66
|
-
|
|
67
|
-
### Git Branch Switching
|
|
68
|
-
|
|
69
|
-
When switching branches:
|
|
70
|
-
- Daemon detects `.git/HEAD` changes
|
|
71
|
-
- Reloads state for new branch
|
|
72
|
-
- Preserves branch-specific context
|
|
73
|
-
|
|
74
|
-
---
|
|
75
|
-
|
|
76
|
-
## Status Output
|
|
77
|
-
|
|
78
|
-
```bash
|
|
79
|
-
$ flow sync-daemon status
|
|
80
|
-
|
|
81
|
-
Sync Daemon Status
|
|
82
|
-
════════════════════════════════════════
|
|
83
|
-
Status: Running
|
|
84
|
-
PID: 12345
|
|
85
|
-
Uptime: 2h 15m
|
|
86
|
-
Last Sync: 2 minutes ago
|
|
87
|
-
Watches: 3 paths
|
|
88
|
-
Changes: 47 synced
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
---
|
|
92
|
-
|
|
93
|
-
## Related
|
|
94
|
-
|
|
95
|
-
- [External Integrations](./external-integrations.md) - Sync with Jira/Linear
|
|
96
|
-
- [Session Persistence](../04-memory-context/session-persistence.md) - State management
|