sillyspec 3.20.2 → 3.20.4

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 (133) hide show
  1. package/.claude/skills/sillyspec-archive/SKILL.md +21 -21
  2. package/.claude/skills/sillyspec-auto/SKILL.md +83 -83
  3. package/.claude/skills/sillyspec-brainstorm/SKILL.md +44 -44
  4. package/.claude/skills/sillyspec-commit/SKILL.md +106 -106
  5. package/.claude/skills/sillyspec-continue/SKILL.md +45 -45
  6. package/.claude/skills/sillyspec-doctor/SKILL.md +31 -31
  7. package/.claude/skills/sillyspec-execute/SKILL.md +30 -30
  8. package/.claude/skills/sillyspec-explore/SKILL.md +109 -109
  9. package/.claude/skills/sillyspec-knowledge/SKILL.md +269 -269
  10. package/.claude/skills/sillyspec-plan/SKILL.md +21 -21
  11. package/.claude/skills/sillyspec-propose/SKILL.md +21 -21
  12. package/.claude/skills/sillyspec-quick/SKILL.md +21 -21
  13. package/.claude/skills/sillyspec-resume/SKILL.md +68 -68
  14. package/.claude/skills/sillyspec-scan/SKILL.md +21 -21
  15. package/.claude/skills/sillyspec-state/SKILL.md +54 -54
  16. package/.claude/skills/sillyspec-status/SKILL.md +21 -21
  17. package/.claude/skills/sillyspec-verify/SKILL.md +21 -21
  18. package/.claude/skills/sillyspec-workspace/SKILL.md +157 -157
  19. package/.husky/pre-push +13 -13
  20. package/CLAUDE.md +18 -18
  21. package/README.md +198 -188
  22. package/SKILL.md +90 -91
  23. package/bin/sillyspec.js +2 -2
  24. package/docs/brainstorm-plan-contract.md +64 -64
  25. package/docs/plan-execute-contract.md +123 -123
  26. package/docs/platform-scan-protocol.md +298 -298
  27. package/docs/revision-mode.md +115 -115
  28. package/docs/sillyspec/file-lifecycle/known-implementation-gaps.md +99 -99
  29. package/docs/sillyspec/file-lifecycle/platform-workflows-sync.md +218 -218
  30. package/docs/sillyspec/file-lifecycle/stage-artifacts.md +167 -167
  31. package/docs/sillyspec/file-lifecycle/storage-and-state.md +148 -148
  32. package/docs/sillyspec/file-lifecycle/worktree-and-guard.md +211 -193
  33. package/docs/sillyspec/file-lifecycle.md +125 -125
  34. package/docs/workflow-contract-regression.md +106 -106
  35. package/docs/worktree-isolation.md +252 -252
  36. package/package.json +40 -40
  37. package/packages/dashboard/dist/assets/index-Bq_Z2hne.js +7446 -7446
  38. package/packages/dashboard/dist/assets/index-O2W5RV4z.css +1 -1
  39. package/packages/dashboard/dist/index.html +16 -16
  40. package/packages/dashboard/index.html +15 -15
  41. package/packages/dashboard/package-lock.json +2384 -2384
  42. package/packages/dashboard/package.json +25 -25
  43. package/packages/dashboard/server/executor.js +86 -86
  44. package/packages/dashboard/server/index.js +588 -588
  45. package/packages/dashboard/server/parser.js +526 -526
  46. package/packages/dashboard/server/watcher.js +344 -344
  47. package/packages/dashboard/src/App.vue +558 -558
  48. package/packages/dashboard/src/components/ActionBar.vue +93 -93
  49. package/packages/dashboard/src/components/CommandPalette.vue +96 -96
  50. package/packages/dashboard/src/components/DetailPanel.vue +137 -137
  51. package/packages/dashboard/src/components/LogStream.vue +65 -65
  52. package/packages/dashboard/src/components/PipelineStage.vue +95 -95
  53. package/packages/dashboard/src/components/PipelineView.vue +156 -156
  54. package/packages/dashboard/src/components/ProjectList.vue +210 -210
  55. package/packages/dashboard/src/components/StageBadge.vue +67 -67
  56. package/packages/dashboard/src/components/StepCard.vue +94 -94
  57. package/packages/dashboard/src/components/detail/DocsDetail.vue +48 -48
  58. package/packages/dashboard/src/components/detail/GitDetail.vue +61 -61
  59. package/packages/dashboard/src/components/detail/TechDetail.vue +43 -43
  60. package/packages/dashboard/src/composables/useDashboard.js +170 -170
  61. package/packages/dashboard/src/composables/useKeyboard.js +119 -119
  62. package/packages/dashboard/src/composables/useWebSocket.js +129 -129
  63. package/packages/dashboard/src/main.js +8 -8
  64. package/packages/dashboard/src/style.css +132 -132
  65. package/packages/dashboard/vite.config.js +18 -18
  66. package/src/brainstorm-postcheck.js +158 -158
  67. package/src/change-list.js +52 -52
  68. package/src/change-risk-profile.js +352 -352
  69. package/src/classify-change.js +73 -73
  70. package/src/constants.js +70 -70
  71. package/src/contract-matrix.js +278 -278
  72. package/src/db.js +201 -201
  73. package/src/endpoint-extractor.js +315 -315
  74. package/src/hooks/claude-pre-tool-use.cjs +125 -125
  75. package/src/hooks/worktree-guard.js +653 -653
  76. package/src/index.js +922 -900
  77. package/src/init.js +431 -431
  78. package/src/knowledge-match.js +130 -130
  79. package/src/migrate.js +117 -117
  80. package/src/modules.js +482 -482
  81. package/src/progress.js +1734 -1734
  82. package/src/run.js +3465 -3358
  83. package/src/scan-postcheck.js +387 -383
  84. package/src/setup.js +398 -398
  85. package/src/stage-contract.js +700 -700
  86. package/src/stages/archive.js +160 -160
  87. package/src/stages/brainstorm-auto.js +229 -229
  88. package/src/stages/brainstorm.js +645 -645
  89. package/src/stages/doctor.js +365 -365
  90. package/src/stages/execute.js +625 -625
  91. package/src/stages/explore.js +34 -34
  92. package/src/stages/index.js +29 -29
  93. package/src/stages/knowledge.js +498 -498
  94. package/src/stages/plan-postcheck.js +511 -513
  95. package/src/stages/plan.js +582 -582
  96. package/src/stages/propose.js +174 -174
  97. package/src/stages/quick.js +82 -82
  98. package/src/stages/scan.js +558 -558
  99. package/src/stages/status.js +65 -65
  100. package/src/stages/verify.js +322 -322
  101. package/src/sync.js +497 -497
  102. package/src/task-review.js +346 -346
  103. package/src/workflow.js +785 -785
  104. package/src/worktree-apply.js +549 -549
  105. package/src/worktree-deps.js +185 -0
  106. package/src/worktree.js +982 -932
  107. package/templates/workflows/archive-impact.yaml +79 -79
  108. package/templates/workflows/scan-docs.yaml +132 -132
  109. package/test/brainstorm-plan-contract.test.mjs +273 -273
  110. package/test/check-syntax.mjs +26 -26
  111. package/test/contract-artifacts.test.mjs +323 -323
  112. package/test/decision-supersede.test.mjs +277 -277
  113. package/test/knowledge-match.test.mjs +231 -231
  114. package/test/plan-execute-contract.test.mjs +330 -330
  115. package/test/plan-optimization.test.mjs +572 -572
  116. package/test/platform-artifacts.test.mjs +166 -166
  117. package/test/platform-failure-samples.test.mjs +199 -199
  118. package/test/platform-recovery-chain.test.mjs +167 -167
  119. package/test/platform-recovery.test.mjs +136 -136
  120. package/test/platform-scan-p0.test.mjs +168 -168
  121. package/test/revision-v1.test.mjs +1145 -1145
  122. package/test/run-scan-project-parse.test.mjs +200 -200
  123. package/test/run-tests.mjs +48 -48
  124. package/test/scan-knowledge.test.mjs +175 -175
  125. package/test/scan-paths.test.mjs +68 -68
  126. package/test/scan-postcheck.test.mjs +197 -197
  127. package/test/spec-dir.test.mjs +206 -206
  128. package/test/stage-contract.test.mjs +299 -299
  129. package/test/stage-definitions.test.mjs +39 -39
  130. package/test/wait-gates.test.mjs +496 -496
  131. package/test/worktree-deps-provision.test.mjs +148 -0
  132. package/test/worktree-guard.test.mjs +71 -71
  133. package/test/worktree-native-overlay.test.mjs +188 -188
@@ -1,147 +1,147 @@
1
- import chokidar from 'chokidar'
2
- import { join, basename, dirname, sep } from 'path'
3
- import { homedir } from 'os'
4
- import { existsSync, readdirSync, realpathSync } from 'fs'
5
- import { parseProjectState, parseProjectOverview } from './parser.js'
6
-
7
- let watcher = null
8
- let updateCallback = null
9
- let projectStates = new Map()
10
- export const customScanPaths = new Set()
11
-
12
- // Directories to exclude (system junk, cache, etc.)
13
- const excludeDirs = new Set([
14
- '.Trash', '.cache', '.npm', '.local', '.vscode', 'Library',
15
- '.git', 'node_modules', '.Trash-*', '.DS_Store', '.config',
16
- '.cocoapods', '.gem', '.rvm', '.nvm', '.asdf', '.brew',
17
- 'AppData', 'Application Data', '.cargo', '.rustup',
18
- '.nuget', '.android', '.gradle', '.m2', '.vscode-server'
19
- ])
20
-
21
- /**
22
- * Check if directory should be excluded from scanning
23
- * @param {string} name - Directory name
24
- * @returns {boolean}
25
- */
26
- function shouldExclude(name, cwd) {
27
- if (excludeDirs.has(name)) return true
28
- // Check wildcard patterns (like .Trash-*)
29
- for (const pattern of excludeDirs) {
30
- if (pattern.includes('*')) {
31
- const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$')
32
- if (regex.test(name)) return true
33
- }
34
- }
35
- // Exclude hidden directories unless it's the cwd basename
36
- const cwdName = cwd.split(sep).pop() || cwd.split('/').pop() || ''
37
- if (name.startsWith('.') && name !== cwdName) {
38
- return true
39
- }
40
- return false
41
- }
42
-
43
- /**
44
- * Build list of directories to scan
45
- * @returns {string[]}
46
- */
47
- function buildScanDirs() {
48
- const home = homedir()
49
- const cwd = process.cwd()
50
-
51
- const scanDirs = new Set()
52
-
53
- // Always scan cwd and its parent
54
- scanDirs.add(cwd)
55
- scanDirs.add(dirname(cwd))
56
-
57
- // Scan parent of parent (2 levels up from cwd) to discover sibling projects
58
- const parentParent = dirname(dirname(cwd))
59
- scanDirs.add(parentParent)
60
-
61
- // Home directory
62
- scanDirs.add(home)
63
-
64
- // Common project directories - check both English and Chinese names
65
- const extraDirs = [
66
- 'Desktop', '桌面',
67
- 'Documents', '文档',
68
- 'Downloads', '下载',
69
- 'Projects', '项目',
70
- 'Work', '工作',
71
- 'Repos', 'Code', 'src', 'dev',
72
- 'workspace', '工作区'
73
- ]
74
-
75
- for (const extra of extraDirs) {
76
- const extraPath = join(home, extra)
77
- if (existsSync(extraPath)) {
78
- scanDirs.add(extraPath)
79
- }
80
- }
81
-
82
- // Add custom scan paths
83
- for (const customPath of customScanPaths) {
84
- if (existsSync(customPath)) {
85
- scanDirs.add(customPath)
86
- }
87
- }
88
-
89
- return Array.from(scanDirs)
90
- }
91
-
92
- /**
93
- * Recursively scan a directory for .sillyspec projects
94
- * @param {string} baseDir - Directory to scan
95
- * @param {Set} seen - Already seen paths
96
- * @param {number} maxDepth - Maximum recursion depth
97
- * @param {number} currentDepth - Current depth
98
- * @returns {Array} Found projects
99
- */
100
- function scanDirectory(baseDir, seen, maxDepth = 2, currentDepth = 0) {
101
- const cwd = process.cwd()
102
- const projects = []
103
-
104
- try {
105
- const entries = readdirSync(baseDir, { withFileTypes: true })
106
-
107
- for (const entry of entries) {
108
- if (!entry.isDirectory()) continue
109
- if (shouldExclude(entry.name, cwd)) continue
110
-
111
- const dirPath = join(baseDir, entry.name)
112
-
113
- let realPath
114
- try { realPath = realpathSync(dirPath) } catch { realPath = dirPath }
115
- const normalizedPath = realPath.toLowerCase()
116
- if (seen.has(normalizedPath)) continue
117
- seen.add(normalizedPath)
118
-
119
- // Check if this dir has .sillyspec
120
- const sillyspecPath = join(dirPath, '.sillyspec')
121
- if (existsSync(sillyspecPath)) {
122
- projects.push({
123
- name: entry.name,
124
- path: dirPath
125
- })
126
- }
127
-
128
- // Recurse into subdirectories if not at max depth
129
- if (currentDepth < maxDepth) {
130
- projects.push(...scanDirectory(dirPath, seen, maxDepth, currentDepth + 1))
131
- }
132
- }
133
- } catch (err) {
134
- // Skip directories we can't read
135
- }
136
-
137
- return projects
138
- }
139
-
140
- /**
141
- * Scan cwd itself (it might be a project root)
142
- * @param {Set} seen - Already seen paths
143
- * @returns {Array} Found projects
144
- */
1
+ import chokidar from 'chokidar'
2
+ import { join, basename, dirname, sep } from 'path'
3
+ import { homedir } from 'os'
4
+ import { existsSync, readdirSync, realpathSync } from 'fs'
5
+ import { parseProjectState, parseProjectOverview } from './parser.js'
6
+
7
+ let watcher = null
8
+ let updateCallback = null
9
+ let projectStates = new Map()
10
+ export const customScanPaths = new Set()
11
+
12
+ // Directories to exclude (system junk, cache, etc.)
13
+ const excludeDirs = new Set([
14
+ '.Trash', '.cache', '.npm', '.local', '.vscode', 'Library',
15
+ '.git', 'node_modules', '.Trash-*', '.DS_Store', '.config',
16
+ '.cocoapods', '.gem', '.rvm', '.nvm', '.asdf', '.brew',
17
+ 'AppData', 'Application Data', '.cargo', '.rustup',
18
+ '.nuget', '.android', '.gradle', '.m2', '.vscode-server'
19
+ ])
20
+
21
+ /**
22
+ * Check if directory should be excluded from scanning
23
+ * @param {string} name - Directory name
24
+ * @returns {boolean}
25
+ */
26
+ function shouldExclude(name, cwd) {
27
+ if (excludeDirs.has(name)) return true
28
+ // Check wildcard patterns (like .Trash-*)
29
+ for (const pattern of excludeDirs) {
30
+ if (pattern.includes('*')) {
31
+ const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$')
32
+ if (regex.test(name)) return true
33
+ }
34
+ }
35
+ // Exclude hidden directories unless it's the cwd basename
36
+ const cwdName = cwd.split(sep).pop() || cwd.split('/').pop() || ''
37
+ if (name.startsWith('.') && name !== cwdName) {
38
+ return true
39
+ }
40
+ return false
41
+ }
42
+
43
+ /**
44
+ * Build list of directories to scan
45
+ * @returns {string[]}
46
+ */
47
+ function buildScanDirs() {
48
+ const home = homedir()
49
+ const cwd = process.cwd()
50
+
51
+ const scanDirs = new Set()
52
+
53
+ // Always scan cwd and its parent
54
+ scanDirs.add(cwd)
55
+ scanDirs.add(dirname(cwd))
56
+
57
+ // Scan parent of parent (2 levels up from cwd) to discover sibling projects
58
+ const parentParent = dirname(dirname(cwd))
59
+ scanDirs.add(parentParent)
60
+
61
+ // Home directory
62
+ scanDirs.add(home)
63
+
64
+ // Common project directories - check both English and Chinese names
65
+ const extraDirs = [
66
+ 'Desktop', '桌面',
67
+ 'Documents', '文档',
68
+ 'Downloads', '下载',
69
+ 'Projects', '项目',
70
+ 'Work', '工作',
71
+ 'Repos', 'Code', 'src', 'dev',
72
+ 'workspace', '工作区'
73
+ ]
74
+
75
+ for (const extra of extraDirs) {
76
+ const extraPath = join(home, extra)
77
+ if (existsSync(extraPath)) {
78
+ scanDirs.add(extraPath)
79
+ }
80
+ }
81
+
82
+ // Add custom scan paths
83
+ for (const customPath of customScanPaths) {
84
+ if (existsSync(customPath)) {
85
+ scanDirs.add(customPath)
86
+ }
87
+ }
88
+
89
+ return Array.from(scanDirs)
90
+ }
91
+
92
+ /**
93
+ * Recursively scan a directory for .sillyspec projects
94
+ * @param {string} baseDir - Directory to scan
95
+ * @param {Set} seen - Already seen paths
96
+ * @param {number} maxDepth - Maximum recursion depth
97
+ * @param {number} currentDepth - Current depth
98
+ * @returns {Array} Found projects
99
+ */
100
+ function scanDirectory(baseDir, seen, maxDepth = 2, currentDepth = 0) {
101
+ const cwd = process.cwd()
102
+ const projects = []
103
+
104
+ try {
105
+ const entries = readdirSync(baseDir, { withFileTypes: true })
106
+
107
+ for (const entry of entries) {
108
+ if (!entry.isDirectory()) continue
109
+ if (shouldExclude(entry.name, cwd)) continue
110
+
111
+ const dirPath = join(baseDir, entry.name)
112
+
113
+ let realPath
114
+ try { realPath = realpathSync(dirPath) } catch { realPath = dirPath }
115
+ const normalizedPath = realPath.toLowerCase()
116
+ if (seen.has(normalizedPath)) continue
117
+ seen.add(normalizedPath)
118
+
119
+ // Check if this dir has .sillyspec
120
+ const sillyspecPath = join(dirPath, '.sillyspec')
121
+ if (existsSync(sillyspecPath)) {
122
+ projects.push({
123
+ name: entry.name,
124
+ path: dirPath
125
+ })
126
+ }
127
+
128
+ // Recurse into subdirectories if not at max depth
129
+ if (currentDepth < maxDepth) {
130
+ projects.push(...scanDirectory(dirPath, seen, maxDepth, currentDepth + 1))
131
+ }
132
+ }
133
+ } catch (err) {
134
+ // Skip directories we can't read
135
+ }
136
+
137
+ return projects
138
+ }
139
+
140
+ /**
141
+ * Scan cwd itself (it might be a project root)
142
+ * @param {Set} seen - Already seen paths
143
+ * @returns {Array} Found projects
144
+ */
145
145
  function scanSelf(seen) {
146
146
  const cwd = process.cwd()
147
147
  const projects = []
@@ -155,203 +155,203 @@ function scanSelf(seen) {
155
155
  const sillyspecPath = join(cwd, '.sillyspec')
156
156
  if (existsSync(sillyspecPath)) {
157
157
  projects.push({
158
- name: basename(cwd),
159
- path: cwd
160
- })
161
- }
162
- }
163
-
164
- return projects
165
- }
166
-
167
- /**
168
- * Discover all .sillyspec projects
169
- * @returns {{ projects: Array, watchPaths: string[] }}
170
- */
171
- function discoverAll() {
172
- const scanDirs = buildScanDirs()
173
- const seen = new Set()
174
- const allProjects = []
175
-
176
- // Check cwd itself first
177
- allProjects.push(...scanSelf(seen))
178
-
179
- // Scan each base directory
180
- for (const baseDir of scanDirs) {
181
- allProjects.push(...scanDirectory(baseDir, seen, 2, 0))
182
- }
183
-
184
- // Build watch paths
185
- const watchPaths = allProjects.map(p => join(p.path, '.sillyspec'))
186
-
187
- return { projects: allProjects, watchPaths }
188
- }
189
-
190
- /**
191
- * Start watching all .sillyspec directories
192
- * @param {function} callback - Callback function when projects are updated
193
- * @returns {object} The watcher instance
194
- */
195
- export function startWatcher(callback) {
196
- if (watcher) {
197
- stopWatcher()
198
- }
199
-
200
- updateCallback = callback
201
-
202
- const { projects, watchPaths } = discoverAll()
203
-
204
- // Parse initial states
205
- for (const project of projects) {
206
- const state = parseProjectState(project.path)
207
- const overview = parseProjectOverview(project.path)
208
- if (state) {
209
- projectStates.set(project.name, { ...project, state, overview })
210
- }
211
- }
212
-
213
- // Emit initial state
214
- if (updateCallback) {
215
- updateCallback(Array.from(projectStates.values()))
216
- }
217
-
218
- // Watch for changes
219
- watcher = chokidar.watch(watchPaths, {
220
- ignored: /node_modules/,
221
- persistent: true,
222
- ignoreInitial: true,
223
- awaitWriteFinish: {
224
- stabilityThreshold: 300,
225
- pollInterval: 100
226
- },
227
- depth: 5
228
- })
229
-
230
- watcher.on('change', async (filePath) => {
231
- await handleFileChange(filePath)
232
- })
233
-
234
- watcher.on('add', async (filePath) => {
235
- await handleFileChange(filePath)
236
- })
237
-
238
- watcher.on('unlink', async (filePath) => {
239
- await handleFileChange(filePath)
240
- })
241
-
242
- watcher.on('error', (error) => {
243
- console.error('Watcher error:', error)
244
- })
245
-
246
- return watcher
247
- }
248
-
249
- /**
250
- * Handle file change events
251
- * @param {string} filePath - Path to the changed file
252
- */
253
- async function handleFileChange(filePath) {
254
- // Normalize path for comparison
255
- const normalizedPath = filePath.replace(/\\/g, '/')
256
-
257
- const projectName = Array.from(projectStates.values()).find(p =>
258
- normalizedPath.startsWith(p.path.replace(/\\/g, '/'))
259
- )?.name
260
-
261
- if (!projectName) {
262
- await rescanProjects()
263
- return
264
- }
265
-
266
- const project = projectStates.get(projectName)
267
- if (project) {
268
- const newState = parseProjectState(project.path)
269
- const overview = parseProjectOverview(project.path)
270
- if (newState) {
271
- projectStates.set(projectName, { ...project, state: newState, overview })
272
- }
273
- }
274
-
275
- if (updateCallback) {
276
- updateCallback(Array.from(projectStates.values()))
277
- }
278
- }
279
-
280
- /**
281
- * Re-scan for projects (e.g., new .sillyspec directories)
282
- */
283
- async function rescanProjects() {
284
- const { projects } = discoverAll()
285
-
286
- for (const project of projects) {
287
- if (!projectStates.has(project.name)) {
288
- const state = parseProjectState(project.path)
289
- const overview = parseProjectOverview(project.path)
290
- if (state) {
291
- projectStates.set(project.name, {
292
- name: project.name,
293
- path: project.path,
294
- state,
295
- overview
296
- })
297
- }
298
- }
299
- }
300
-
301
- if (updateCallback) {
302
- updateCallback(Array.from(projectStates.values()))
303
- }
304
- }
305
-
306
- /**
307
- * Add a custom scan path and rescan
308
- * @param {string} path - Path to add
309
- */
310
- export function addCustomScanPath(path) {
311
- customScanPaths.add(path)
312
- rescanProjects()
313
- }
314
-
315
- /**
316
- * Remove a custom scan path
317
- * @param {string} path - Path to remove
318
- */
319
- export function removeCustomScanPath(path) {
320
- customScanPaths.delete(path)
321
- }
322
-
323
- /**
324
- * Get list of custom scan paths
325
- * @returns {string[]}
326
- */
327
- export function getCustomScanPaths() {
328
- return Array.from(customScanPaths)
329
- }
330
-
331
- /**
332
- * Stop the file watcher
333
- */
334
- export function stopWatcher() {
335
- if (watcher) {
336
- watcher.close()
337
- watcher = null
338
- projectStates.clear()
339
- }
340
- }
341
-
342
- /**
343
- * Get current project states
344
- * @returns {array} Array of project states
345
- */
346
- export function getProjectStates() {
347
- return Array.from(projectStates.values())
348
- }
349
-
350
- /**
351
- * Get a specific project state
352
- * @param {string} projectName - Name of the project
353
- * @returns {object|null} Project state or null
354
- */
355
- export function getProjectState(projectName) {
356
- return projectStates.get(projectName) || null
357
- }
158
+ name: basename(cwd),
159
+ path: cwd
160
+ })
161
+ }
162
+ }
163
+
164
+ return projects
165
+ }
166
+
167
+ /**
168
+ * Discover all .sillyspec projects
169
+ * @returns {{ projects: Array, watchPaths: string[] }}
170
+ */
171
+ function discoverAll() {
172
+ const scanDirs = buildScanDirs()
173
+ const seen = new Set()
174
+ const allProjects = []
175
+
176
+ // Check cwd itself first
177
+ allProjects.push(...scanSelf(seen))
178
+
179
+ // Scan each base directory
180
+ for (const baseDir of scanDirs) {
181
+ allProjects.push(...scanDirectory(baseDir, seen, 2, 0))
182
+ }
183
+
184
+ // Build watch paths
185
+ const watchPaths = allProjects.map(p => join(p.path, '.sillyspec'))
186
+
187
+ return { projects: allProjects, watchPaths }
188
+ }
189
+
190
+ /**
191
+ * Start watching all .sillyspec directories
192
+ * @param {function} callback - Callback function when projects are updated
193
+ * @returns {object} The watcher instance
194
+ */
195
+ export function startWatcher(callback) {
196
+ if (watcher) {
197
+ stopWatcher()
198
+ }
199
+
200
+ updateCallback = callback
201
+
202
+ const { projects, watchPaths } = discoverAll()
203
+
204
+ // Parse initial states
205
+ for (const project of projects) {
206
+ const state = parseProjectState(project.path)
207
+ const overview = parseProjectOverview(project.path)
208
+ if (state) {
209
+ projectStates.set(project.name, { ...project, state, overview })
210
+ }
211
+ }
212
+
213
+ // Emit initial state
214
+ if (updateCallback) {
215
+ updateCallback(Array.from(projectStates.values()))
216
+ }
217
+
218
+ // Watch for changes
219
+ watcher = chokidar.watch(watchPaths, {
220
+ ignored: /node_modules/,
221
+ persistent: true,
222
+ ignoreInitial: true,
223
+ awaitWriteFinish: {
224
+ stabilityThreshold: 300,
225
+ pollInterval: 100
226
+ },
227
+ depth: 5
228
+ })
229
+
230
+ watcher.on('change', async (filePath) => {
231
+ await handleFileChange(filePath)
232
+ })
233
+
234
+ watcher.on('add', async (filePath) => {
235
+ await handleFileChange(filePath)
236
+ })
237
+
238
+ watcher.on('unlink', async (filePath) => {
239
+ await handleFileChange(filePath)
240
+ })
241
+
242
+ watcher.on('error', (error) => {
243
+ console.error('Watcher error:', error)
244
+ })
245
+
246
+ return watcher
247
+ }
248
+
249
+ /**
250
+ * Handle file change events
251
+ * @param {string} filePath - Path to the changed file
252
+ */
253
+ async function handleFileChange(filePath) {
254
+ // Normalize path for comparison
255
+ const normalizedPath = filePath.replace(/\\/g, '/')
256
+
257
+ const projectName = Array.from(projectStates.values()).find(p =>
258
+ normalizedPath.startsWith(p.path.replace(/\\/g, '/'))
259
+ )?.name
260
+
261
+ if (!projectName) {
262
+ await rescanProjects()
263
+ return
264
+ }
265
+
266
+ const project = projectStates.get(projectName)
267
+ if (project) {
268
+ const newState = parseProjectState(project.path)
269
+ const overview = parseProjectOverview(project.path)
270
+ if (newState) {
271
+ projectStates.set(projectName, { ...project, state: newState, overview })
272
+ }
273
+ }
274
+
275
+ if (updateCallback) {
276
+ updateCallback(Array.from(projectStates.values()))
277
+ }
278
+ }
279
+
280
+ /**
281
+ * Re-scan for projects (e.g., new .sillyspec directories)
282
+ */
283
+ async function rescanProjects() {
284
+ const { projects } = discoverAll()
285
+
286
+ for (const project of projects) {
287
+ if (!projectStates.has(project.name)) {
288
+ const state = parseProjectState(project.path)
289
+ const overview = parseProjectOverview(project.path)
290
+ if (state) {
291
+ projectStates.set(project.name, {
292
+ name: project.name,
293
+ path: project.path,
294
+ state,
295
+ overview
296
+ })
297
+ }
298
+ }
299
+ }
300
+
301
+ if (updateCallback) {
302
+ updateCallback(Array.from(projectStates.values()))
303
+ }
304
+ }
305
+
306
+ /**
307
+ * Add a custom scan path and rescan
308
+ * @param {string} path - Path to add
309
+ */
310
+ export function addCustomScanPath(path) {
311
+ customScanPaths.add(path)
312
+ rescanProjects()
313
+ }
314
+
315
+ /**
316
+ * Remove a custom scan path
317
+ * @param {string} path - Path to remove
318
+ */
319
+ export function removeCustomScanPath(path) {
320
+ customScanPaths.delete(path)
321
+ }
322
+
323
+ /**
324
+ * Get list of custom scan paths
325
+ * @returns {string[]}
326
+ */
327
+ export function getCustomScanPaths() {
328
+ return Array.from(customScanPaths)
329
+ }
330
+
331
+ /**
332
+ * Stop the file watcher
333
+ */
334
+ export function stopWatcher() {
335
+ if (watcher) {
336
+ watcher.close()
337
+ watcher = null
338
+ projectStates.clear()
339
+ }
340
+ }
341
+
342
+ /**
343
+ * Get current project states
344
+ * @returns {array} Array of project states
345
+ */
346
+ export function getProjectStates() {
347
+ return Array.from(projectStates.values())
348
+ }
349
+
350
+ /**
351
+ * Get a specific project state
352
+ * @param {string} projectName - Name of the project
353
+ * @returns {object|null} Project state or null
354
+ */
355
+ export function getProjectState(projectName) {
356
+ return projectStates.get(projectName) || null
357
+ }