opencodekit 0.16.15 → 0.16.18

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 (85) hide show
  1. package/README.md +77 -242
  2. package/dist/index.js +19 -6
  3. package/dist/template/.opencode/AGENTS.md +72 -236
  4. package/dist/template/.opencode/README.md +49 -482
  5. package/dist/template/.opencode/agent/build.md +71 -345
  6. package/dist/template/.opencode/agent/explore.md +47 -139
  7. package/dist/template/.opencode/agent/general.md +61 -172
  8. package/dist/template/.opencode/agent/looker.md +65 -161
  9. package/dist/template/.opencode/agent/painter.md +46 -200
  10. package/dist/template/.opencode/agent/plan.md +37 -220
  11. package/dist/template/.opencode/agent/review.md +72 -153
  12. package/dist/template/.opencode/agent/scout.md +44 -486
  13. package/dist/template/.opencode/agent/vision.md +63 -178
  14. package/dist/template/.opencode/command/create.md +75 -307
  15. package/dist/template/.opencode/command/design.md +53 -589
  16. package/dist/template/.opencode/command/handoff.md +76 -180
  17. package/dist/template/.opencode/command/init.md +45 -211
  18. package/dist/template/.opencode/command/plan.md +62 -514
  19. package/dist/template/.opencode/command/pr.md +56 -226
  20. package/dist/template/.opencode/command/research.md +55 -266
  21. package/dist/template/.opencode/command/resume.md +33 -138
  22. package/dist/template/.opencode/command/review-codebase.md +54 -202
  23. package/dist/template/.opencode/command/ship.md +78 -127
  24. package/dist/template/.opencode/command/start.md +47 -577
  25. package/dist/template/.opencode/command/status.md +60 -353
  26. package/dist/template/.opencode/command/ui-review.md +52 -298
  27. package/dist/template/.opencode/command/verify.md +36 -250
  28. package/dist/template/.opencode/memory.db-shm +0 -0
  29. package/dist/template/.opencode/memory.db-wal +0 -0
  30. package/dist/template/.opencode/opencode.json +133 -35
  31. package/dist/template/.opencode/plugin/README.md +40 -166
  32. package/dist/template/.opencode/plugin/compaction.ts +162 -131
  33. package/dist/template/.opencode/plugin/lib/memory-db.ts +112 -0
  34. package/dist/template/.opencode/plugin/swarm-enforcer.ts +182 -27
  35. package/dist/template/.opencode/skill/augment-context-engine/SKILL.md +112 -0
  36. package/dist/template/.opencode/skill/augment-context-engine/mcp.json +6 -0
  37. package/dist/template/.opencode/skill/core-data-expert/SKILL.md +82 -0
  38. package/dist/template/.opencode/skill/core-data-expert/references/batch-operations.md +543 -0
  39. package/dist/template/.opencode/skill/core-data-expert/references/cloudkit-integration.md +259 -0
  40. package/dist/template/.opencode/skill/core-data-expert/references/concurrency.md +522 -0
  41. package/dist/template/.opencode/skill/core-data-expert/references/fetch-requests.md +643 -0
  42. package/dist/template/.opencode/skill/core-data-expert/references/glossary.md +233 -0
  43. package/dist/template/.opencode/skill/core-data-expert/references/migration.md +393 -0
  44. package/dist/template/.opencode/skill/core-data-expert/references/model-configuration.md +597 -0
  45. package/dist/template/.opencode/skill/core-data-expert/references/performance.md +300 -0
  46. package/dist/template/.opencode/skill/core-data-expert/references/persistent-history.md +553 -0
  47. package/dist/template/.opencode/skill/core-data-expert/references/project-audit.md +60 -0
  48. package/dist/template/.opencode/skill/core-data-expert/references/saving.md +574 -0
  49. package/dist/template/.opencode/skill/core-data-expert/references/stack-setup.md +625 -0
  50. package/dist/template/.opencode/skill/core-data-expert/references/testing.md +300 -0
  51. package/dist/template/.opencode/skill/core-data-expert/references/threading.md +589 -0
  52. package/dist/template/.opencode/skill/swift-concurrency/SKILL.md +246 -0
  53. package/dist/template/.opencode/skill/swift-concurrency/references/actors.md +640 -0
  54. package/dist/template/.opencode/skill/swift-concurrency/references/async-algorithms.md +822 -0
  55. package/dist/template/.opencode/skill/swift-concurrency/references/async-await-basics.md +249 -0
  56. package/dist/template/.opencode/skill/swift-concurrency/references/async-sequences.md +670 -0
  57. package/dist/template/.opencode/skill/swift-concurrency/references/core-data.md +533 -0
  58. package/dist/template/.opencode/skill/swift-concurrency/references/glossary.md +128 -0
  59. package/dist/template/.opencode/skill/swift-concurrency/references/linting.md +142 -0
  60. package/dist/template/.opencode/skill/swift-concurrency/references/memory-management.md +542 -0
  61. package/dist/template/.opencode/skill/swift-concurrency/references/migration.md +1076 -0
  62. package/dist/template/.opencode/skill/swift-concurrency/references/performance.md +574 -0
  63. package/dist/template/.opencode/skill/swift-concurrency/references/sendable.md +578 -0
  64. package/dist/template/.opencode/skill/swift-concurrency/references/tasks.md +604 -0
  65. package/dist/template/.opencode/skill/swift-concurrency/references/testing.md +565 -0
  66. package/dist/template/.opencode/skill/swift-concurrency/references/threading.md +452 -0
  67. package/dist/template/.opencode/skill/swiftui-expert-skill/SKILL.md +290 -0
  68. package/dist/template/.opencode/skill/swiftui-expert-skill/references/animation-advanced.md +351 -0
  69. package/dist/template/.opencode/skill/swiftui-expert-skill/references/animation-basics.md +284 -0
  70. package/dist/template/.opencode/skill/swiftui-expert-skill/references/animation-transitions.md +326 -0
  71. package/dist/template/.opencode/skill/swiftui-expert-skill/references/image-optimization.md +286 -0
  72. package/dist/template/.opencode/skill/swiftui-expert-skill/references/layout-best-practices.md +312 -0
  73. package/dist/template/.opencode/skill/swiftui-expert-skill/references/liquid-glass.md +377 -0
  74. package/dist/template/.opencode/skill/swiftui-expert-skill/references/list-patterns.md +153 -0
  75. package/dist/template/.opencode/skill/swiftui-expert-skill/references/modern-apis.md +400 -0
  76. package/dist/template/.opencode/skill/swiftui-expert-skill/references/performance-patterns.md +377 -0
  77. package/dist/template/.opencode/skill/swiftui-expert-skill/references/scroll-patterns.md +305 -0
  78. package/dist/template/.opencode/skill/swiftui-expert-skill/references/sheet-navigation-patterns.md +292 -0
  79. package/dist/template/.opencode/skill/swiftui-expert-skill/references/state-management.md +447 -0
  80. package/dist/template/.opencode/skill/swiftui-expert-skill/references/text-formatting.md +285 -0
  81. package/dist/template/.opencode/skill/swiftui-expert-skill/references/view-structure.md +276 -0
  82. package/dist/template/.opencode/tool/action-queue.ts +308 -0
  83. package/dist/template/.opencode/tool/swarm.ts +65 -40
  84. package/package.json +16 -3
  85. package/dist/template/.opencode/.agents/skills/context7/SKILL.md +0 -88
@@ -1,395 +1,102 @@
1
1
  ---
2
- description: Comprehensive project and session status dashboard
3
- argument-hint: "[--full] [--health] [--sessions] [--git]"
4
- agent: explore
5
- subtask: true
2
+ description: Show project status - tasks, git state, recent sessions
3
+ argument-hint: "[--git] [--sessions]"
4
+ agent: build
6
5
  ---
7
6
 
8
- # Status Dashboard
7
+ # Status: $ARGUMENTS
9
8
 
10
- ## Load Beads Skill
9
+ Quick project status dashboard. Runs read-only commands and reports state.
11
10
 
12
- ```typescript
13
- skill({ name: "beads" });
14
- skill({ name: "memory-system" });
15
- ```
11
+ > **No arguments required.** Flags are optional filters.
16
12
 
17
- Generate a comprehensive project status report covering tasks, sessions, git state, memory health, and system health.
13
+ ## Parse Arguments
18
14
 
19
- ## Phase 1: Gather All State (Parallel)
20
-
21
- Run all status checks simultaneously:
22
-
23
- ```
24
- # Beads CLI commands
25
- !`br stats`
26
- !`br list --status in_progress`
27
- !`br ready`
15
+ | Argument | Default | Description |
16
+ | ------------ | ------- | ----------------------- |
17
+ | `--git` | false | Focus on git state only |
18
+ | `--sessions` | false | Focus on sessions only |
28
19
 
29
- # Git state
30
- !`git status --porcelain`
31
- !`git branch --show-current`
32
- !`git log --oneline -5`
33
- ```
20
+ ## Load Skills
34
21
 
35
22
  ```typescript
36
- // Built-in tools
37
- list_sessions({ project: "current", since: "today", limit: 5 });
38
- ```
39
-
40
- ````
41
-
42
- ## Phase 2: Health Score Calculation
43
-
44
- Calculate overall project health (0-100):
45
-
46
- ```
47
- ┌─────────────────────────────────────────────────────────────────────────┐
48
- │ HEALTH SCORE FORMULA │
49
- ├─────────────────────────────────────────────────────────────────────────┤
50
- │ │
51
- │ Health = Base(60) + Bonuses - Penalties │
52
- │ │
53
- │ BONUSES (up to +40) │
54
- │ ├── Database healthy: +10 │
55
- │ ├── No SLA breaches: +10 │
56
- │ ├── All P0/P1 assigned: +10 │
57
- │ └── CI passing: +10 │
58
- │ │
59
- │ PENALTIES (uncapped) │
60
- │ ├── Per SLA breach: -5 │
61
- │ ├── Per unread urgent msg: -3 │
62
- │ ├── Per stale task (>7d): -2 │
63
- │ ├── Database issues: -20 │
64
- │ └── Per circular dependency: -10 │
65
- │ │
66
- │ GRADES │
67
- │ ├── 90-100: 🟢 EXCELLENT │
68
- │ ├── 75-89: 🟢 GOOD │
69
- │ ├── 60-74: 🟡 FAIR │
70
- │ ├── 40-59: 🟠 NEEDS ATTENTION │
71
- │ └── 0-39: 🔴 CRITICAL │
72
- │ │
73
- └─────────────────────────────────────────────────────────────────────────┘
74
- ```
75
-
76
- ## Phase 3: Generate Dashboard
77
-
78
- ```
79
- ╔══════════════════════════════════════════════════════════════════════════╗
80
- ║ PROJECT STATUS ║
81
- ║ [Project Name] ║
82
- ║ [Timestamp] ║
83
- ╠══════════════════════════════════════════════════════════════════════════╣
84
-
85
- HEALTH: 🟢 85/100 GOOD
86
- ━━━━━━━━━━━━━━━━━━━━━━
87
-
88
- [████████████████████████░░░░░░] 85%
89
-
90
- Database: ✓ OK
91
- CI: ✓ Passing
92
- SLA: ✓ No breaches
93
- Agents: 3 active
94
-
95
-
96
- TASK OVERVIEW
97
- ━━━━━━━━━━━━━
98
- ┌────────────────────────────────────────────────────┐
99
- │ │
100
- │ Open: 12 In Progress: 3 Ready: 5 │
101
- │ ├── P0: 0 ├── P0: 1 ├── Blocked: 2 │
102
- │ ├── P1: 2 ├── P1: 1 └── Unblocked: 3 │
103
- │ ├── P2: 5 └── P2: 1 │
104
- │ └── P3+: 5 │
105
- │ │
106
- │ Closed Today: 4 This Week: 18 │
107
- │ │
108
- └────────────────────────────────────────────────────┘
109
-
110
-
111
- IN PROGRESS
112
- ━━━━━━━━━━━
113
- ID │ Priority │ Title │ Assignee │ Age
114
- ─────────┼──────────┼──────────────────────────┼──────────┼────────
115
- br-abc12 │ P0 │ Fix auth regression │ user │ 2h
116
- br-def34 │ P1 │ Add user dashboard │ user │ 1d
117
- br-ghi56 │ P2 │ Refactor logging │ user │ 3h
118
-
119
-
120
- READY TO START
121
- ━━━━━━━━━━━━━━
122
- ID │ Priority │ Title │ Blocked By
123
- ─────────┼──────────┼──────────────────────────┼───────────
124
- br-xyz11 │ P1 │ Add notifications │ -
125
- br-xyz22 │ P2 │ Update API docs │ -
126
- br-xyz33 │ P2 │ Add analytics │ br-abc12
127
-
128
-
129
- GIT STATUS
130
- ━━━━━━━━━━
131
- Branch: feature/auth-refactor
132
- Ahead: 2 commits
133
- Behind: 0 commits
134
-
135
- [If changes:]
136
- Modified: 3 files
137
- Staged: 1 file
138
- Untracked: 2 files
139
-
140
- [If clean:]
141
- Working tree clean ✓
142
-
143
-
144
- RECENT COMMITS
145
- ━━━━━━━━━━━━━━
146
- abc1234 - fix: auth token validation (2h ago)
147
- def5678 - feat: add dashboard skeleton (5h ago)
148
- ghi9012 - refactor: extract user service (1d ago)
149
-
150
-
151
- SESSIONS TODAY
152
- ━━━━━━━━━━━━━━
153
- Session │ Time │ Messages │ Files │ Focus
154
- ────────────┼──────────┼──────────┼───────┼──────────────────
155
- ses_abc123 │ 2:30 PM │ 45 │ 12 │ Auth refactor
156
- ses_def456 │ 11:00 AM │ 28 │ 8 │ Dashboard setup
157
- ses_ghi789 │ 9:15 AM │ 15 │ 3 │ Bug triage
158
-
159
- Total: 3 sessions, 88 messages, 23 files modified
160
-
161
-
162
- TASK COMPLIANCE
163
- ━━━━━━━━━━━━━━━
164
- [Check .beads/artifacts/<id>/ for each in-progress task]
165
-
166
- Complete (spec + plan):
167
- ✓ br-abc12: Fix auth regression
168
- ✓ br-def34: Add user dashboard
169
-
170
- Incomplete:
171
- ⚠ br-ghi56: Missing plan.md
172
-
173
- Compliance: 2/3 (67%)
174
-
175
-
176
- CONTEXT STATUS
177
- ━━━━━━━━━━━━━━
178
- Current Session: ses_xyz999
179
- Token Usage: ~85,000 (estimated)
180
- Context Zone: 🟠 ORANGE (50-75%)
181
- Status: Distill completed tool outputs
182
-
183
- Compaction Strategy:
184
- → distill: Condense valuable tool outputs into summaries
185
- → compress: Squash completed conversation phases
186
- → prune: Remove noise and irrelevant outputs
187
- → /handoff: Full session handoff when near limit
188
-
189
- Recommendation: Distill large tool outputs from completed exploration
190
-
191
-
192
- REQUIRED ACTIONS
193
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
194
- Priority │ Action │ Command
195
- ─────────┼─────────────────────────────────────┼────────────────────
196
- HIGH │ Add plan for br-ghi56 │ /plan br-ghi56
197
- MEDIUM │ Review 2 stale tasks │ /triage --stale
198
- LOW │ Push 2 local commits │ git push
199
-
200
- ╚══════════════════════════════════════════════════════════════════════════╝
201
- ```
202
-
203
- ## Phase 4: Trend Analysis (--full mode)
204
-
205
- If `--full` flag, add historical comparison:
206
-
207
- ```
208
- TRENDS (7 days)
209
- ━━━━━━━━━━━━━━━
210
- This Week Last Week Change
211
- ────────────────────────────────────────────────────
212
- Tasks Completed 18 12 +50% ↑
213
- Avg Cycle Time 2.3 days 3.1 days -26% ↑
214
- SLA Compliance 95% 88% +7% ↑
215
- Throughput/Day 2.6 1.7 +53% ↑
216
-
217
- Velocity Chart:
218
- Mon ████████ 8
219
- Tue ██████ 6
220
- Wed ████ 4
221
- Thu ██████ 6
222
- Fri ██████████ 10
223
- └──────────────────→
23
+ skill({ name: "beads" });
224
24
  ```
225
25
 
226
- ## Phase 5: Session Insights
227
-
228
- ### Memory Health
229
-
230
- ```typescript
231
- // Check memory system status
232
- memory_admin({ operation: "status" });
233
- ```
26
+ ---
234
27
 
235
- Display memory stats in dashboard:
28
+ ## Phase 1: Gather State (Parallel)
236
29
 
237
- ```
238
- MEMORY STATUS
239
- ━━━━━━━━━━━━
240
- Observations: [N] stored
241
- Database size: [X] KB
242
- FTS Index: ✓ Healthy
243
- Last search: [timestamp]
30
+ Run all checks simultaneously:
244
31
 
245
- Recent learnings:
246
- [Latest observation title] (type: decision)
247
- [Latest observation title] (type: pattern)
32
+ ```bash
33
+ br stats
34
+ br list --status in_progress
35
+ br ready
248
36
  ```
249
37
 
250
- ### Context Health
251
-
252
- ```typescript
253
- // Load compaction skill for threshold-aware context assessment
254
- skill({ name: "compaction" });
255
-
256
- // Assess context health using compaction thresholds
257
- // These thresholds match the compaction skill's zones:
258
- const contextZone = (usage) => {
259
- if (usage < 50) return { zone: "🟢 GREEN", action: "No action needed" };
260
- if (usage < 75) return { zone: "🟡 YELLOW", action: "Distill completed tool outputs" };
261
- if (usage < 90) return { zone: "🟠 ORANGE", action: "Compress completed phases" };
262
- if (usage < 95) return { zone: "🔴 RED", action: "Aggressive prune + compress" };
263
- return { zone: "⛔ CRITICAL", action: "Emergency /handoff now" };
264
- };
265
-
266
- // Context health warnings
267
- const contextWarnings = [];
268
-
269
- if (estimatedTokens > 150000) {
270
- contextWarnings.push("⛔ CRITICAL: Near context limit - run /handoff immediately");
271
- } else if (estimatedTokens > 120000) {
272
- contextWarnings.push("🔴 HIGH: Compress completed phases, prune noise");
273
- } else if (estimatedTokens > 80000) {
274
- contextWarnings.push("🟠 ELEVATED: Distill completed tool outputs");
275
- } else if (estimatedTokens > 50000) {
276
- contextWarnings.push("🟡 MODERATE: Consider distilling large tool outputs");
277
- }
278
-
279
- if (sessionDuration > 3 * 60 * 60 * 1000) {
280
- // 3 hours
281
- contextWarnings.push("⚠️ Long session - context quality may be degraded");
282
- }
283
-
284
- if (toolCallCount > 200) {
285
- contextWarnings.push("⚠️ Many tool calls - prune completed outputs");
286
- }
38
+ ```bash
39
+ git status --porcelain
40
+ git branch --show-current
41
+ git log --oneline -5
287
42
  ```
288
43
 
289
- ### Incomplete Sessions
290
-
291
44
  ```typescript
292
- // Check for sessions with incomplete work
293
- const incompleteSessions = recentSessions.filter(
294
- (s) => !s.hasHandoff && !s.summary?.includes("completed"),
295
- );
296
-
297
- if (incompleteSessions.length > 0) {
298
- console.log("Incomplete work from previous sessions:");
299
- for (const s of incompleteSessions) {
300
- console.log(`- ${s.id}: ${s.lastMessage}`);
301
- }
302
- }
303
- ```
304
-
305
- ## Phase 6: CI/CD Status (if available)
306
-
45
+ list_sessions({ since: "today", limit: 5 });
46
+ action - queue({ op: "status" });
307
47
  ```
308
- # GitHub Actions
309
- !`gh run list --limit 3 --json status,conclusion,name,createdAt`
310
48
 
311
- # Or check for common CI files
312
- !`ls .github/workflows/ 2>/dev/null`
313
- !`cat .github/workflows/*.yml | grep -A5 "name:"`
314
- ```
315
-
316
- **Output:**
317
-
318
- ```
319
- CI/CD STATUS
320
- ━━━━━━━━━━━━
321
- Pipeline │ Status │ Time
322
- ────────────────┼───────────┼─────────
323
- main │ ✓ Passing │ 15m ago
324
- feature/auth │ ✗ Failed │ 2h ago
325
- staging-deploy │ ✓ Passing │ 1d ago
326
-
327
- Failed Check: feature/auth
328
- └── Jest tests: 2 failures in auth.test.ts
329
- └── Fix: /implement br-abc12 (related task)
330
- ```
331
-
332
- ## Examples
333
-
334
- ```bash
335
- /status # Quick overview
336
- /status --full # Include trends and history
337
- /status --health # Focus on health metrics
338
- /status --sessions # Focus on session activity
339
- /status --git # Focus on git state
340
- ```
49
+ ---
341
50
 
342
- ## Integration
51
+ ## Phase 2: Format Report
343
52
 
344
- Based on status, suggest next actions:
53
+ Present results in simple sections. Use the actual output from Phase 1 — don't invent data.
345
54
 
346
55
  ```
347
- RECOMMENDED NEXT STEPS
348
- ━━━━━━━━━━━━━━━━━━━━━━
349
-
350
- Based on current status:
56
+ Status
57
+ ━━━━━━
351
58
 
352
- 1. High Priority Messages:
353
- Reply to build-1: br msg --to "build-1" --subj "Re: API spec" --body "..."
59
+ TASKS
60
+ In Progress: [list from br list --status in_progress]
61
+ Ready: [list from br ready]
62
+ Stats: [summary from br stats]
354
63
 
355
- 2. Continue In-Progress Work:
356
- → /implement br-abc12 (P0, 2h old)
64
+ GIT
65
+ Branch: [from git branch]
66
+ Changes: [from git status, or "clean"]
67
+ Recent: [from git log]
357
68
 
358
- 3. Start Ready Tasks:
359
- → /start br-xyz11 (P1, unblocked)
69
+ SESSIONS TODAY
70
+ [from list_sessions]
360
71
 
361
- 4. Session Maintenance:
362
- Consider /handoff if switching tasks
363
- Prune old tool outputs to reduce context
72
+ ACTION QUEUE
73
+ Pending approvals: [from action-queue pending_approvals]
74
+ Ready tasks: [from action-queue ready_tasks]
75
+ Idle workers: [from action-queue idle_workers]
364
76
  ```
365
77
 
366
- ## Caching
78
+ ---
367
79
 
368
- For performance, cache expensive checks:
80
+ ## Phase 3: Suggest Next Action
369
81
 
370
- ```typescript
371
- // Cache health check for 5 minutes
372
- const healthCacheKey = `health_${(Date.now() / (5 * 60 * 1000)) | 0}`;
82
+ Based on gathered state, recommend ONE next step:
373
83
 
374
- // Cache CI status for 10 minutes
375
- const ciCacheKey = `ci_${(Date.now() / (10 * 60 * 1000)) | 0}`;
376
- ```
84
+ | State | Suggestion |
85
+ | ---------------------------- | ----------------------------- |
86
+ | Has in_progress tasks | `/ship <id>` (continue work) |
87
+ | Has ready tasks, none active | `/start <id>` (pick up work) |
88
+ | Uncommitted changes | Review and commit |
89
+ | Nothing active or ready | `/create "<desc>"` (new work) |
377
90
 
378
- ## Error States
91
+ ---
379
92
 
380
- Handle gracefully:
93
+ ## Output
381
94
 
382
95
  ```
383
- [If beads unavailable:]
384
- ⚠️ Beads database not initialized
385
- Run: br init
96
+ Status
97
+ ━━━━━━
386
98
 
387
- [If git not available:]
388
- ⚠️ Not a git repository
389
- Run: git init
99
+ [Sections from Phase 2]
390
100
 
391
- [If CI check fails:]
392
- ⚠️ CI status unavailable
393
- Check: GitHub Actions permissions
101
+ Next: [single recommendation from Phase 3]
394
102
  ```
395
- ````