@rune-kit/rune 2.8.0 → 2.11.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 (287) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +68 -34
  3. package/agents/adversary.md +27 -0
  4. package/agents/architect.md +19 -29
  5. package/agents/asset-creator.md +18 -4
  6. package/agents/audit.md +25 -4
  7. package/agents/autopsy.md +19 -4
  8. package/agents/ba.md +35 -0
  9. package/agents/brainstorm.md +31 -4
  10. package/agents/browser-pilot.md +21 -4
  11. package/agents/coder.md +21 -29
  12. package/agents/completion-gate.md +20 -4
  13. package/agents/constraint-check.md +18 -4
  14. package/agents/context-engine.md +22 -4
  15. package/agents/context-pack.md +32 -0
  16. package/agents/cook.md +41 -4
  17. package/agents/db.md +19 -4
  18. package/agents/debug.md +33 -4
  19. package/agents/dependency-doctor.md +20 -4
  20. package/agents/deploy.md +27 -4
  21. package/agents/design.md +22 -4
  22. package/agents/doc-processor.md +27 -0
  23. package/agents/docs-seeker.md +19 -4
  24. package/agents/docs.md +31 -0
  25. package/agents/fix.md +37 -4
  26. package/agents/git.md +29 -0
  27. package/agents/hallucination-guard.md +20 -4
  28. package/agents/incident.md +21 -4
  29. package/agents/integrity-check.md +18 -4
  30. package/agents/journal.md +19 -4
  31. package/agents/launch.md +32 -4
  32. package/agents/logic-guardian.md +26 -11
  33. package/agents/marketing.md +23 -4
  34. package/agents/mcp-builder.md +26 -0
  35. package/agents/neural-memory.md +30 -0
  36. package/agents/onboard.md +22 -4
  37. package/agents/perf.md +21 -4
  38. package/agents/plan.md +29 -4
  39. package/agents/preflight.md +22 -4
  40. package/agents/problem-solver.md +20 -4
  41. package/agents/rescue.md +23 -4
  42. package/agents/research.md +19 -4
  43. package/agents/researcher.md +19 -29
  44. package/agents/retro.md +32 -0
  45. package/agents/review-intake.md +20 -4
  46. package/agents/review.md +32 -4
  47. package/agents/reviewer.md +20 -28
  48. package/agents/safeguard.md +19 -4
  49. package/agents/sast.md +18 -4
  50. package/agents/scaffold.md +41 -0
  51. package/agents/scanner.md +19 -28
  52. package/agents/scope-guard.md +18 -4
  53. package/agents/scout.md +23 -4
  54. package/agents/sentinel-env.md +26 -0
  55. package/agents/sentinel.md +33 -4
  56. package/agents/sequential-thinking.md +20 -4
  57. package/agents/session-bridge.md +24 -4
  58. package/agents/skill-forge.md +22 -4
  59. package/agents/skill-router.md +26 -4
  60. package/agents/slides.md +24 -0
  61. package/agents/surgeon.md +19 -4
  62. package/agents/team.md +30 -4
  63. package/agents/test.md +36 -4
  64. package/agents/trend-scout.md +17 -4
  65. package/agents/verification.md +20 -4
  66. package/agents/video-creator.md +20 -4
  67. package/agents/watchdog.md +19 -4
  68. package/agents/worktree.md +17 -4
  69. package/commands/rune.md +168 -168
  70. package/compiler/__tests__/analytics.test.js +370 -0
  71. package/compiler/adapters/openclaw.js +2 -2
  72. package/compiler/analytics.js +385 -0
  73. package/compiler/bin/rune.js +68 -2
  74. package/compiler/dashboard.js +883 -0
  75. package/compiler/transforms/branding.js +1 -1
  76. package/contexts/dev.md +34 -34
  77. package/contexts/research.md +43 -43
  78. package/contexts/review.md +55 -55
  79. package/extensions/ai-ml/PACK.md +88 -88
  80. package/extensions/ai-ml/skills/ai-agents.md +172 -172
  81. package/extensions/ai-ml/skills/code-sandbox.md +187 -187
  82. package/extensions/ai-ml/skills/deep-research.md +146 -146
  83. package/extensions/ai-ml/skills/embedding-search.md +66 -66
  84. package/extensions/ai-ml/skills/fine-tuning-guide.md +74 -74
  85. package/extensions/ai-ml/skills/llm-architect.md +125 -125
  86. package/extensions/ai-ml/skills/llm-integration.md +64 -64
  87. package/extensions/ai-ml/skills/prompt-patterns.md +72 -72
  88. package/extensions/ai-ml/skills/rag-patterns.md +66 -66
  89. package/extensions/ai-ml/skills/web-extraction.md +114 -114
  90. package/extensions/analytics/PACK.md +92 -92
  91. package/extensions/analytics/skills/ab-testing.md +72 -72
  92. package/extensions/analytics/skills/dashboard-patterns.md +83 -83
  93. package/extensions/analytics/skills/data-validation.md +68 -68
  94. package/extensions/analytics/skills/funnel-analysis.md +81 -81
  95. package/extensions/analytics/skills/sql-patterns.md +57 -57
  96. package/extensions/analytics/skills/statistical-analysis.md +79 -79
  97. package/extensions/analytics/skills/tracking-setup.md +71 -71
  98. package/extensions/backend/PACK.md +104 -104
  99. package/extensions/backend/skills/api-patterns.md +84 -84
  100. package/extensions/backend/skills/async-pipeline.md +193 -193
  101. package/extensions/backend/skills/auth-patterns.md +97 -97
  102. package/extensions/backend/skills/background-jobs.md +133 -133
  103. package/extensions/backend/skills/caching-patterns.md +108 -108
  104. package/extensions/backend/skills/cli-generation.md +133 -133
  105. package/extensions/backend/skills/database-patterns.md +87 -87
  106. package/extensions/backend/skills/middleware-patterns.md +104 -104
  107. package/extensions/chrome-ext/PACK.md +93 -93
  108. package/extensions/chrome-ext/skills/cws-preflight.md +143 -143
  109. package/extensions/chrome-ext/skills/cws-publish.md +104 -104
  110. package/extensions/chrome-ext/skills/ext-ai-integration.md +251 -251
  111. package/extensions/chrome-ext/skills/ext-messaging.md +139 -139
  112. package/extensions/chrome-ext/skills/ext-storage.md +133 -133
  113. package/extensions/chrome-ext/skills/mv3-scaffold.md +164 -164
  114. package/extensions/content/PACK.md +96 -96
  115. package/extensions/content/skills/blog-patterns.md +88 -88
  116. package/extensions/content/skills/cms-integration.md +131 -131
  117. package/extensions/content/skills/content-scoring.md +107 -107
  118. package/extensions/content/skills/i18n.md +83 -83
  119. package/extensions/content/skills/mdx-authoring.md +137 -137
  120. package/extensions/content/skills/reference.md +1014 -1014
  121. package/extensions/content/skills/seo-patterns.md +67 -67
  122. package/extensions/content/skills/video-repurpose.md +153 -153
  123. package/extensions/devops/PACK.md +101 -101
  124. package/extensions/devops/skills/chaos-testing.md +67 -67
  125. package/extensions/devops/skills/ci-cd.md +75 -75
  126. package/extensions/devops/skills/docker.md +58 -58
  127. package/extensions/devops/skills/edge-serverless.md +163 -163
  128. package/extensions/devops/skills/infra-as-code.md +158 -158
  129. package/extensions/devops/skills/kubernetes.md +110 -110
  130. package/extensions/devops/skills/monitoring.md +57 -57
  131. package/extensions/devops/skills/server-setup.md +64 -64
  132. package/extensions/devops/skills/ssl-domain.md +42 -42
  133. package/extensions/ecommerce/PACK.md +116 -116
  134. package/extensions/ecommerce/skills/cart-system.md +79 -79
  135. package/extensions/ecommerce/skills/inventory-mgmt.md +102 -102
  136. package/extensions/ecommerce/skills/order-management.md +126 -126
  137. package/extensions/ecommerce/skills/payment-integration.md +472 -472
  138. package/extensions/ecommerce/skills/shopify-dev.md +69 -69
  139. package/extensions/ecommerce/skills/subscription-billing.md +93 -93
  140. package/extensions/ecommerce/skills/tax-compliance.md +117 -117
  141. package/extensions/gamedev/PACK.md +142 -142
  142. package/extensions/gamedev/skills/asset-pipeline.md +74 -74
  143. package/extensions/gamedev/skills/audio-system.md +129 -129
  144. package/extensions/gamedev/skills/camera-system.md +87 -87
  145. package/extensions/gamedev/skills/ecs.md +98 -98
  146. package/extensions/gamedev/skills/game-loops.md +72 -72
  147. package/extensions/gamedev/skills/input-system.md +199 -199
  148. package/extensions/gamedev/skills/multiplayer.md +180 -180
  149. package/extensions/gamedev/skills/particles.md +105 -105
  150. package/extensions/gamedev/skills/physics-engine.md +89 -89
  151. package/extensions/gamedev/skills/scene-management.md +146 -146
  152. package/extensions/gamedev/skills/threejs-patterns.md +90 -90
  153. package/extensions/gamedev/skills/webgl.md +71 -71
  154. package/extensions/mobile/PACK.md +106 -106
  155. package/extensions/mobile/skills/app-store-connect.md +152 -152
  156. package/extensions/mobile/skills/app-store-prep.md +66 -66
  157. package/extensions/mobile/skills/deep-linking.md +109 -109
  158. package/extensions/mobile/skills/flutter.md +60 -60
  159. package/extensions/mobile/skills/ios-build-pipeline.md +142 -142
  160. package/extensions/mobile/skills/native-bridge.md +66 -66
  161. package/extensions/mobile/skills/ota-updates.md +97 -97
  162. package/extensions/mobile/skills/push-notifications.md +111 -111
  163. package/extensions/mobile/skills/react-native.md +82 -82
  164. package/extensions/saas/PACK.md +116 -116
  165. package/extensions/saas/skills/billing-integration.md +200 -200
  166. package/extensions/saas/skills/feature-flags.md +130 -130
  167. package/extensions/saas/skills/multi-tenant.md +103 -103
  168. package/extensions/saas/skills/onboarding-flow.md +139 -139
  169. package/extensions/saas/skills/subscription-flow.md +95 -95
  170. package/extensions/saas/skills/team-management.md +144 -144
  171. package/extensions/security/PACK.md +99 -99
  172. package/extensions/security/skills/api-security.md +140 -140
  173. package/extensions/security/skills/compliance.md +68 -68
  174. package/extensions/security/skills/owasp-audit.md +64 -64
  175. package/extensions/security/skills/pentest-patterns.md +77 -77
  176. package/extensions/security/skills/secret-mgmt.md +65 -65
  177. package/extensions/security/skills/supply-chain.md +65 -65
  178. package/extensions/trading/PACK.md +80 -80
  179. package/extensions/trading/skills/chart-components.md +55 -55
  180. package/extensions/trading/skills/experiment-loop.md +125 -125
  181. package/extensions/trading/skills/fintech-patterns.md +47 -47
  182. package/extensions/trading/skills/indicator-library.md +58 -58
  183. package/extensions/trading/skills/quant-analysis.md +111 -111
  184. package/extensions/trading/skills/realtime-data.md +58 -58
  185. package/extensions/trading/skills/trade-logic.md +104 -104
  186. package/extensions/ui/PACK.md +130 -130
  187. package/extensions/ui/skills/a11y-audit.md +91 -91
  188. package/extensions/ui/skills/animation-patterns.md +127 -106
  189. package/extensions/ui/skills/component-patterns.md +100 -75
  190. package/extensions/ui/skills/design-decision.md +108 -108
  191. package/extensions/ui/skills/design-system.md +68 -68
  192. package/extensions/ui/skills/landing-patterns.md +155 -155
  193. package/extensions/ui/skills/palette-picker.md +173 -173
  194. package/extensions/ui/skills/react-health.md +90 -90
  195. package/extensions/ui/skills/type-system.md +125 -125
  196. package/extensions/ui/skills/web-vitals.md +153 -153
  197. package/extensions/zalo/PACK.md +145 -145
  198. package/extensions/zalo/skills/zalo-oa-mcp.md +317 -317
  199. package/extensions/zalo/skills/zalo-oa-messaging.md +429 -429
  200. package/extensions/zalo/skills/zalo-oa-setup.md +236 -236
  201. package/extensions/zalo/skills/zalo-oa-webhook.md +189 -189
  202. package/extensions/zalo/skills/zalo-personal-messaging.md +194 -194
  203. package/extensions/zalo/skills/zalo-personal-setup.md +153 -153
  204. package/extensions/zalo/skills/zalo-rate-guard.md +219 -219
  205. package/hooks/auto-format/index.cjs +48 -48
  206. package/hooks/context-watch/index.cjs +95 -68
  207. package/hooks/hooks.json +111 -111
  208. package/hooks/metrics-collector/index.cjs +86 -42
  209. package/hooks/post-session-reflect/index.cjs +189 -153
  210. package/hooks/pre-compact/index.cjs +95 -95
  211. package/hooks/run-hook.cmd +1 -1
  212. package/hooks/secrets-scan/index.cjs +100 -100
  213. package/hooks/session-start/index.cjs +71 -65
  214. package/hooks/typecheck/index.cjs +65 -65
  215. package/package.json +63 -63
  216. package/references/ui-pro-max-data/LICENSE-UI-PRO-MAX +21 -21
  217. package/references/ui-pro-max-data/charts.csv +26 -26
  218. package/references/ui-pro-max-data/colors.csv +161 -161
  219. package/references/ui-pro-max-data/styles.csv +68 -68
  220. package/references/ui-pro-max-data/typography.csv +74 -74
  221. package/references/ui-pro-max-data/ui-reasoning.csv +162 -162
  222. package/references/ui-pro-max-data/ux-guidelines.csv +99 -99
  223. package/skills/adversary/SKILL.md +283 -283
  224. package/skills/asset-creator/SKILL.md +157 -157
  225. package/skills/audit/SKILL.md +148 -2
  226. package/skills/autopsy/SKILL.md +335 -259
  227. package/skills/autopsy/references/repo-analysis-patterns.md +113 -0
  228. package/skills/ba/SKILL.md +72 -2
  229. package/skills/brainstorm/SKILL.md +342 -341
  230. package/skills/browser-pilot/SKILL.md +168 -168
  231. package/skills/constraint-check/SKILL.md +165 -165
  232. package/skills/context-engine/SKILL.md +404 -404
  233. package/skills/cook/SKILL.md +917 -834
  234. package/skills/cook/references/output-format.md +33 -0
  235. package/skills/db/SKILL.md +273 -272
  236. package/skills/debug/SKILL.md +465 -443
  237. package/skills/dependency-doctor/SKILL.md +265 -235
  238. package/skills/deploy/SKILL.md +274 -231
  239. package/skills/design/DESIGN-REFERENCE.md +365 -365
  240. package/skills/design/SKILL.md +589 -482
  241. package/skills/doc-processor/SKILL.md +254 -254
  242. package/skills/docs/SKILL.md +374 -373
  243. package/skills/docs-seeker/SKILL.md +177 -177
  244. package/skills/fix/SKILL.md +330 -308
  245. package/skills/git/SKILL.md +339 -339
  246. package/skills/graft/SKILL.md +352 -0
  247. package/skills/graft/references/challenge-framework.md +98 -0
  248. package/skills/graft/references/mode-decision.md +44 -0
  249. package/skills/hallucination-guard/SKILL.md +219 -219
  250. package/skills/incident/SKILL.md +254 -251
  251. package/skills/integrity-check/SKILL.md +169 -169
  252. package/skills/journal/SKILL.md +240 -238
  253. package/skills/launch/SKILL.md +344 -342
  254. package/skills/logic-guardian/SKILL.md +251 -251
  255. package/skills/marketing/SKILL.md +290 -245
  256. package/skills/mcp-builder/SKILL.md +425 -423
  257. package/skills/mcp-builder/references/auto-discovery-pattern.md +169 -0
  258. package/skills/neural-memory/SKILL.md +362 -362
  259. package/skills/onboard/SKILL.md +404 -403
  260. package/skills/perf/SKILL.md +346 -346
  261. package/skills/plan/SKILL.md +433 -370
  262. package/skills/plan/references/feature-map.md +84 -0
  263. package/skills/preflight/SKILL.md +415 -396
  264. package/skills/problem-solver/SKILL.md +380 -284
  265. package/skills/rescue/SKILL.md +474 -450
  266. package/skills/retro/SKILL.md +5 -1
  267. package/skills/review/SKILL.md +612 -535
  268. package/skills/review-intake/SKILL.md +249 -249
  269. package/skills/safeguard/SKILL.md +200 -200
  270. package/skills/sast/SKILL.md +190 -190
  271. package/skills/scaffold/SKILL.md +328 -286
  272. package/skills/scope-guard/SKILL.md +180 -162
  273. package/skills/scout/SKILL.md +263 -263
  274. package/skills/sentinel/SKILL.md +382 -353
  275. package/skills/sentinel-env/SKILL.md +254 -254
  276. package/skills/sequential-thinking/SKILL.md +234 -234
  277. package/skills/session-bridge/SKILL.md +543 -397
  278. package/skills/skill-forge/SKILL.md +581 -539
  279. package/skills/skill-router/{skill.md → SKILL.md} +30 -2
  280. package/skills/surgeon/SKILL.md +215 -215
  281. package/skills/team/SKILL.md +556 -514
  282. package/skills/test/SKILL.md +614 -587
  283. package/skills/trend-scout/SKILL.md +145 -145
  284. package/skills/verification/SKILL.md +326 -325
  285. package/skills/video-creator/SKILL.md +201 -201
  286. package/skills/watchdog/SKILL.md +168 -168
  287. package/skills/worktree/SKILL.md +140 -140
@@ -1,81 +1,81 @@
1
- ---
2
- name: "funnel-analysis"
3
- pack: "@rune/analytics"
4
- description: "Funnel analysis — conversion tracking, drop-off identification, cohort analysis, retention metrics, LTV calculation, attribution modeling."
5
- model: sonnet
6
- tools: [Read, Edit, Write, Grep, Glob, Bash]
7
- ---
8
-
9
- # funnel-analysis
10
-
11
- Funnel analysis — conversion tracking, drop-off identification, cohort analysis, retention metrics, LTV calculation, attribution modeling.
12
-
13
- #### Workflow
14
-
15
- **Step 1 — Detect funnel tracking**
16
- Use Grep to find funnel-related code: `funnel`, `conversion`, `step`, `checkout.*step`, `onboarding.*step`, `cohort`, `retention`. Read event tracking calls to understand: which user journey steps are tracked, how step completion is determined, and where drop-off data is collected.
17
-
18
- **Step 2 — Audit funnel completeness**
19
- Check for: missing steps in the funnel (gap between "add to cart" and "payment complete" — no "checkout started"), step events not including a session or flow ID (can't link steps to same journey), no timestamp on steps (can't measure time between steps), no segmentation on funnel data (can't compare mobile vs desktop conversion), and no drop-off alerting.
20
-
21
- **Step 3 — Emit funnel patterns**
22
- Emit: typed funnel step tracker with flow ID, funnel aggregation query (SQL), drop-off rate calculator, cohort retention matrix, and simple LTV estimation.
23
-
24
- #### Example
25
-
26
- ```typescript
27
- // Funnel step tracker with flow correlation
28
- interface FunnelStep {
29
- funnelId: string;
30
- flowId: string; // ties steps to same user journey
31
- step: string;
32
- stepIndex: number;
33
- userId: string;
34
- timestamp: number;
35
- metadata?: Record<string, string | number>;
36
- }
37
-
38
- const CHECKOUT_FUNNEL = ['cart_viewed', 'checkout_started', 'shipping_entered', 'payment_entered', 'order_completed'] as const;
39
-
40
- function trackFunnelStep(step: typeof CHECKOUT_FUNNEL[number], flowId: string, meta?: Record<string, string | number>) {
41
- const event: FunnelStep = {
42
- funnelId: 'checkout',
43
- flowId,
44
- step,
45
- stepIndex: CHECKOUT_FUNNEL.indexOf(step),
46
- userId: getCurrentUserId(),
47
- timestamp: Date.now(),
48
- metadata: meta,
49
- };
50
- analytics.track({ name: 'funnel_step', properties: event });
51
- }
52
-
53
- // SQL — funnel drop-off analysis (PostgreSQL)
54
- // SELECT step, COUNT(DISTINCT flow_id) as users,
55
- // LAG(COUNT(DISTINCT flow_id)) OVER (ORDER BY step_index) as prev_users,
56
- // ROUND(COUNT(DISTINCT flow_id)::numeric /
57
- // LAG(COUNT(DISTINCT flow_id)) OVER (ORDER BY step_index) * 100, 1) as conversion_pct
58
- // FROM funnel_events
59
- // WHERE funnel_id = 'checkout' AND timestamp > NOW() - INTERVAL '30 days'
60
- // GROUP BY step, step_index ORDER BY step_index;
61
-
62
- // Cohort retention matrix
63
- async function cohortRetention(cohortField: string, periods: number) {
64
- return db.execute(sql`
65
- WITH cohorts AS (
66
- SELECT user_id, DATE_TRUNC('week', MIN(created_at)) AS cohort_week
67
- FROM events WHERE name = 'signup_completed'
68
- GROUP BY user_id
69
- ),
70
- activity AS (
71
- SELECT user_id, DATE_TRUNC('week', timestamp) AS active_week
72
- FROM events GROUP BY user_id, DATE_TRUNC('week', timestamp)
73
- )
74
- SELECT c.cohort_week, EXTRACT(WEEK FROM a.active_week - c.cohort_week) AS week_number,
75
- COUNT(DISTINCT a.user_id) AS active_users
76
- FROM cohorts c JOIN activity a ON c.user_id = a.user_id
77
- WHERE a.active_week >= c.cohort_week
78
- GROUP BY c.cohort_week, week_number ORDER BY c.cohort_week, week_number
79
- `);
80
- }
81
- ```
1
+ ---
2
+ name: "funnel-analysis"
3
+ pack: "@rune/analytics"
4
+ description: "Funnel analysis — conversion tracking, drop-off identification, cohort analysis, retention metrics, LTV calculation, attribution modeling."
5
+ model: sonnet
6
+ tools: [Read, Edit, Write, Grep, Glob, Bash]
7
+ ---
8
+
9
+ # funnel-analysis
10
+
11
+ Funnel analysis — conversion tracking, drop-off identification, cohort analysis, retention metrics, LTV calculation, attribution modeling.
12
+
13
+ #### Workflow
14
+
15
+ **Step 1 — Detect funnel tracking**
16
+ Use Grep to find funnel-related code: `funnel`, `conversion`, `step`, `checkout.*step`, `onboarding.*step`, `cohort`, `retention`. Read event tracking calls to understand: which user journey steps are tracked, how step completion is determined, and where drop-off data is collected.
17
+
18
+ **Step 2 — Audit funnel completeness**
19
+ Check for: missing steps in the funnel (gap between "add to cart" and "payment complete" — no "checkout started"), step events not including a session or flow ID (can't link steps to same journey), no timestamp on steps (can't measure time between steps), no segmentation on funnel data (can't compare mobile vs desktop conversion), and no drop-off alerting.
20
+
21
+ **Step 3 — Emit funnel patterns**
22
+ Emit: typed funnel step tracker with flow ID, funnel aggregation query (SQL), drop-off rate calculator, cohort retention matrix, and simple LTV estimation.
23
+
24
+ #### Example
25
+
26
+ ```typescript
27
+ // Funnel step tracker with flow correlation
28
+ interface FunnelStep {
29
+ funnelId: string;
30
+ flowId: string; // ties steps to same user journey
31
+ step: string;
32
+ stepIndex: number;
33
+ userId: string;
34
+ timestamp: number;
35
+ metadata?: Record<string, string | number>;
36
+ }
37
+
38
+ const CHECKOUT_FUNNEL = ['cart_viewed', 'checkout_started', 'shipping_entered', 'payment_entered', 'order_completed'] as const;
39
+
40
+ function trackFunnelStep(step: typeof CHECKOUT_FUNNEL[number], flowId: string, meta?: Record<string, string | number>) {
41
+ const event: FunnelStep = {
42
+ funnelId: 'checkout',
43
+ flowId,
44
+ step,
45
+ stepIndex: CHECKOUT_FUNNEL.indexOf(step),
46
+ userId: getCurrentUserId(),
47
+ timestamp: Date.now(),
48
+ metadata: meta,
49
+ };
50
+ analytics.track({ name: 'funnel_step', properties: event });
51
+ }
52
+
53
+ // SQL — funnel drop-off analysis (PostgreSQL)
54
+ // SELECT step, COUNT(DISTINCT flow_id) as users,
55
+ // LAG(COUNT(DISTINCT flow_id)) OVER (ORDER BY step_index) as prev_users,
56
+ // ROUND(COUNT(DISTINCT flow_id)::numeric /
57
+ // LAG(COUNT(DISTINCT flow_id)) OVER (ORDER BY step_index) * 100, 1) as conversion_pct
58
+ // FROM funnel_events
59
+ // WHERE funnel_id = 'checkout' AND timestamp > NOW() - INTERVAL '30 days'
60
+ // GROUP BY step, step_index ORDER BY step_index;
61
+
62
+ // Cohort retention matrix
63
+ async function cohortRetention(cohortField: string, periods: number) {
64
+ return db.execute(sql`
65
+ WITH cohorts AS (
66
+ SELECT user_id, DATE_TRUNC('week', MIN(created_at)) AS cohort_week
67
+ FROM events WHERE name = 'signup_completed'
68
+ GROUP BY user_id
69
+ ),
70
+ activity AS (
71
+ SELECT user_id, DATE_TRUNC('week', timestamp) AS active_week
72
+ FROM events GROUP BY user_id, DATE_TRUNC('week', timestamp)
73
+ )
74
+ SELECT c.cohort_week, EXTRACT(WEEK FROM a.active_week - c.cohort_week) AS week_number,
75
+ COUNT(DISTINCT a.user_id) AS active_users
76
+ FROM cohorts c JOIN activity a ON c.user_id = a.user_id
77
+ WHERE a.active_week >= c.cohort_week
78
+ GROUP BY c.cohort_week, week_number ORDER BY c.cohort_week, week_number
79
+ `);
80
+ }
81
+ ```
@@ -1,57 +1,57 @@
1
- ---
2
- name: "sql-patterns"
3
- pack: "@rune/analytics"
4
- description: "SQL query patterns for analytics — common aggregations, window functions, CTEs, performance optimization, and safe parameterized queries for analytics workloads."
5
- model: sonnet
6
- tools: [Read, Edit, Write, Grep, Glob, Bash]
7
- ---
8
-
9
- # sql-patterns
10
-
11
- SQL query patterns for analytics — common aggregations, window functions, CTEs, performance optimization, and safe parameterized queries for analytics workloads.
12
-
13
- #### Workflow
14
-
15
- **Step 1 — Detect database setup**
16
- Use Grep to find database usage: `prisma`, `drizzle`, `knex`, `pg`, `mysql2`, `better-sqlite3`, `sql`, `SELECT`, `INSERT`. Identify: ORM vs raw SQL, database engine (PostgreSQL, MySQL, SQLite), migration tool, and query builder.
17
-
18
- **Step 2 — Audit query quality**
19
- Check for: string interpolation in SQL (injection risk), missing indexes on columns used in WHERE/JOIN/ORDER BY, N+1 queries in loops, SELECT * instead of specific columns, no pagination on large result sets, aggregations done client-side instead of database, and missing EXPLAIN ANALYZE on slow queries.
20
-
21
- **Step 3 — Emit SQL patterns**
22
- Emit patterns appropriate to the detected database engine.
23
-
24
- #### Example
25
-
26
- ```sql
27
- -- Time-bucketed metrics (PostgreSQL)
28
- -- Use DATE_TRUNC for consistent time buckets
29
- SELECT
30
- DATE_TRUNC('hour', created_at) AS bucket,
31
- COUNT(*) AS total_events,
32
- COUNT(DISTINCT user_id) AS unique_users,
33
- PERCENTILE_CONT(0.95) WITHIN GROUP (ORDER BY response_ms) AS p95_latency
34
- FROM events
35
- WHERE created_at > NOW() - INTERVAL '24 hours'
36
- GROUP BY bucket
37
- ORDER BY bucket;
38
-
39
- -- Running totals with window functions
40
- SELECT date, daily_revenue,
41
- SUM(daily_revenue) OVER (ORDER BY date ROWS UNBOUNDED PRECEDING) AS cumulative_revenue,
42
- AVG(daily_revenue) OVER (ORDER BY date ROWS 6 PRECEDING) AS rolling_7d_avg
43
- FROM daily_metrics;
44
-
45
- -- Efficient pagination (keyset, not OFFSET)
46
- -- BAD: SELECT * FROM events ORDER BY id LIMIT 20 OFFSET 10000;
47
- -- GOOD: cursor-based
48
- SELECT * FROM events
49
- WHERE id > $1 -- last seen ID
50
- ORDER BY id
51
- LIMIT 20;
52
-
53
- -- Safe parameterized queries (NEVER string interpolation)
54
- -- BAD: `SELECT * FROM users WHERE id = ${userId}`
55
- -- GOOD: prepared statement
56
- const result = await db.query('SELECT * FROM users WHERE id = $1', [userId]);
57
- ```
1
+ ---
2
+ name: "sql-patterns"
3
+ pack: "@rune/analytics"
4
+ description: "SQL query patterns for analytics — common aggregations, window functions, CTEs, performance optimization, and safe parameterized queries for analytics workloads."
5
+ model: sonnet
6
+ tools: [Read, Edit, Write, Grep, Glob, Bash]
7
+ ---
8
+
9
+ # sql-patterns
10
+
11
+ SQL query patterns for analytics — common aggregations, window functions, CTEs, performance optimization, and safe parameterized queries for analytics workloads.
12
+
13
+ #### Workflow
14
+
15
+ **Step 1 — Detect database setup**
16
+ Use Grep to find database usage: `prisma`, `drizzle`, `knex`, `pg`, `mysql2`, `better-sqlite3`, `sql`, `SELECT`, `INSERT`. Identify: ORM vs raw SQL, database engine (PostgreSQL, MySQL, SQLite), migration tool, and query builder.
17
+
18
+ **Step 2 — Audit query quality**
19
+ Check for: string interpolation in SQL (injection risk), missing indexes on columns used in WHERE/JOIN/ORDER BY, N+1 queries in loops, SELECT * instead of specific columns, no pagination on large result sets, aggregations done client-side instead of database, and missing EXPLAIN ANALYZE on slow queries.
20
+
21
+ **Step 3 — Emit SQL patterns**
22
+ Emit patterns appropriate to the detected database engine.
23
+
24
+ #### Example
25
+
26
+ ```sql
27
+ -- Time-bucketed metrics (PostgreSQL)
28
+ -- Use DATE_TRUNC for consistent time buckets
29
+ SELECT
30
+ DATE_TRUNC('hour', created_at) AS bucket,
31
+ COUNT(*) AS total_events,
32
+ COUNT(DISTINCT user_id) AS unique_users,
33
+ PERCENTILE_CONT(0.95) WITHIN GROUP (ORDER BY response_ms) AS p95_latency
34
+ FROM events
35
+ WHERE created_at > NOW() - INTERVAL '24 hours'
36
+ GROUP BY bucket
37
+ ORDER BY bucket;
38
+
39
+ -- Running totals with window functions
40
+ SELECT date, daily_revenue,
41
+ SUM(daily_revenue) OVER (ORDER BY date ROWS UNBOUNDED PRECEDING) AS cumulative_revenue,
42
+ AVG(daily_revenue) OVER (ORDER BY date ROWS 6 PRECEDING) AS rolling_7d_avg
43
+ FROM daily_metrics;
44
+
45
+ -- Efficient pagination (keyset, not OFFSET)
46
+ -- BAD: SELECT * FROM events ORDER BY id LIMIT 20 OFFSET 10000;
47
+ -- GOOD: cursor-based
48
+ SELECT * FROM events
49
+ WHERE id > $1 -- last seen ID
50
+ ORDER BY id
51
+ LIMIT 20;
52
+
53
+ -- Safe parameterized queries (NEVER string interpolation)
54
+ -- BAD: `SELECT * FROM users WHERE id = ${userId}`
55
+ -- GOOD: prepared statement
56
+ const result = await db.query('SELECT * FROM users WHERE id = $1', [userId]);
57
+ ```
@@ -1,79 +1,79 @@
1
- ---
2
- name: "statistical-analysis"
3
- pack: "@rune/analytics"
4
- description: "Statistical analysis patterns — significance testing, regression basics, distribution analysis, and correlation detection for product metrics."
5
- model: sonnet
6
- tools: [Read, Edit, Write, Grep, Glob, Bash]
7
- ---
8
-
9
- # statistical-analysis
10
-
11
- Statistical analysis patterns — significance testing, regression basics, distribution analysis, and correlation detection for product metrics.
12
-
13
- #### Workflow
14
-
15
- **Step 1 — Identify analysis need**
16
- Determine what type of analysis is needed: comparing two groups (A/B test significance), finding relationships (correlation), predicting values (regression), understanding distribution (histogram, percentiles), or detecting trends (time series decomposition).
17
-
18
- **Step 2 — Select method**
19
-
20
- | Question | Method | When to use |
21
- |----------|--------|-------------|
22
- | "Is A different from B?" | Two-sample t-test or Chi-square | Comparing conversion rates, revenue per user |
23
- | "Are these correlated?" | Pearson/Spearman correlation | Feature usage vs retention, price vs conversion |
24
- | "What predicts Y?" | Linear/logistic regression | Churn prediction, revenue forecasting |
25
- | "What's the distribution?" | Histogram + percentiles | Response times, order values, session lengths |
26
- | "Is this trend real?" | Mann-Kendall or linear regression on time | Month-over-month growth, seasonal patterns |
27
-
28
- **Step 3 — Emit analysis patterns**
29
-
30
- #### Example
31
-
32
- ```typescript
33
- // Chi-square significance test for A/B conversion rates
34
- function chiSquareTest(
35
- controlConversions: number, controlTotal: number,
36
- treatmentConversions: number, treatmentTotal: number
37
- ): { chiSquare: number; pValue: number; significant: boolean } {
38
- const controlRate = controlConversions / controlTotal;
39
- const treatmentRate = treatmentConversions / treatmentTotal;
40
- const pooledRate = (controlConversions + treatmentConversions) / (controlTotal + treatmentTotal);
41
-
42
- const expected = [
43
- [controlTotal * pooledRate, controlTotal * (1 - pooledRate)],
44
- [treatmentTotal * pooledRate, treatmentTotal * (1 - pooledRate)],
45
- ];
46
- const observed = [
47
- [controlConversions, controlTotal - controlConversions],
48
- [treatmentConversions, treatmentTotal - treatmentConversions],
49
- ];
50
-
51
- let chiSq = 0;
52
- for (let i = 0; i < 2; i++) {
53
- for (let j = 0; j < 2; j++) {
54
- chiSq += Math.pow(observed[i][j] - expected[i][j], 2) / expected[i][j];
55
- }
56
- }
57
-
58
- // p-value approximation for 1 degree of freedom
59
- const pValue = 1 - normalCDF(Math.sqrt(chiSq));
60
- return { chiSquare: chiSq, pValue, significant: pValue < 0.05 };
61
- }
62
-
63
- // Percentile calculation (for response time analysis, order values, etc.)
64
- function percentiles(values: number[], points: number[] = [50, 75, 90, 95, 99]): Record<string, number> {
65
- const sorted = [...values].sort((a, b) => a - b);
66
- return Object.fromEntries(
67
- points.map(p => [`p${p}`, sorted[Math.ceil((p / 100) * sorted.length) - 1]])
68
- );
69
- }
70
-
71
- // SQL — Correlation between two metrics (PostgreSQL)
72
- // SELECT CORR(feature_usage_count, retention_days) AS correlation,
73
- // CASE
74
- // WHEN ABS(CORR(feature_usage_count, retention_days)) > 0.7 THEN 'strong'
75
- // WHEN ABS(CORR(feature_usage_count, retention_days)) > 0.4 THEN 'moderate'
76
- // ELSE 'weak'
77
- // END AS strength
78
- // FROM user_metrics;
79
- ```
1
+ ---
2
+ name: "statistical-analysis"
3
+ pack: "@rune/analytics"
4
+ description: "Statistical analysis patterns — significance testing, regression basics, distribution analysis, and correlation detection for product metrics."
5
+ model: sonnet
6
+ tools: [Read, Edit, Write, Grep, Glob, Bash]
7
+ ---
8
+
9
+ # statistical-analysis
10
+
11
+ Statistical analysis patterns — significance testing, regression basics, distribution analysis, and correlation detection for product metrics.
12
+
13
+ #### Workflow
14
+
15
+ **Step 1 — Identify analysis need**
16
+ Determine what type of analysis is needed: comparing two groups (A/B test significance), finding relationships (correlation), predicting values (regression), understanding distribution (histogram, percentiles), or detecting trends (time series decomposition).
17
+
18
+ **Step 2 — Select method**
19
+
20
+ | Question | Method | When to use |
21
+ |----------|--------|-------------|
22
+ | "Is A different from B?" | Two-sample t-test or Chi-square | Comparing conversion rates, revenue per user |
23
+ | "Are these correlated?" | Pearson/Spearman correlation | Feature usage vs retention, price vs conversion |
24
+ | "What predicts Y?" | Linear/logistic regression | Churn prediction, revenue forecasting |
25
+ | "What's the distribution?" | Histogram + percentiles | Response times, order values, session lengths |
26
+ | "Is this trend real?" | Mann-Kendall or linear regression on time | Month-over-month growth, seasonal patterns |
27
+
28
+ **Step 3 — Emit analysis patterns**
29
+
30
+ #### Example
31
+
32
+ ```typescript
33
+ // Chi-square significance test for A/B conversion rates
34
+ function chiSquareTest(
35
+ controlConversions: number, controlTotal: number,
36
+ treatmentConversions: number, treatmentTotal: number
37
+ ): { chiSquare: number; pValue: number; significant: boolean } {
38
+ const controlRate = controlConversions / controlTotal;
39
+ const treatmentRate = treatmentConversions / treatmentTotal;
40
+ const pooledRate = (controlConversions + treatmentConversions) / (controlTotal + treatmentTotal);
41
+
42
+ const expected = [
43
+ [controlTotal * pooledRate, controlTotal * (1 - pooledRate)],
44
+ [treatmentTotal * pooledRate, treatmentTotal * (1 - pooledRate)],
45
+ ];
46
+ const observed = [
47
+ [controlConversions, controlTotal - controlConversions],
48
+ [treatmentConversions, treatmentTotal - treatmentConversions],
49
+ ];
50
+
51
+ let chiSq = 0;
52
+ for (let i = 0; i < 2; i++) {
53
+ for (let j = 0; j < 2; j++) {
54
+ chiSq += Math.pow(observed[i][j] - expected[i][j], 2) / expected[i][j];
55
+ }
56
+ }
57
+
58
+ // p-value approximation for 1 degree of freedom
59
+ const pValue = 1 - normalCDF(Math.sqrt(chiSq));
60
+ return { chiSquare: chiSq, pValue, significant: pValue < 0.05 };
61
+ }
62
+
63
+ // Percentile calculation (for response time analysis, order values, etc.)
64
+ function percentiles(values: number[], points: number[] = [50, 75, 90, 95, 99]): Record<string, number> {
65
+ const sorted = [...values].sort((a, b) => a - b);
66
+ return Object.fromEntries(
67
+ points.map(p => [`p${p}`, sorted[Math.ceil((p / 100) * sorted.length) - 1]])
68
+ );
69
+ }
70
+
71
+ // SQL — Correlation between two metrics (PostgreSQL)
72
+ // SELECT CORR(feature_usage_count, retention_days) AS correlation,
73
+ // CASE
74
+ // WHEN ABS(CORR(feature_usage_count, retention_days)) > 0.7 THEN 'strong'
75
+ // WHEN ABS(CORR(feature_usage_count, retention_days)) > 0.4 THEN 'moderate'
76
+ // ELSE 'weak'
77
+ // END AS strength
78
+ // FROM user_metrics;
79
+ ```
@@ -1,71 +1,71 @@
1
- ---
2
- name: "tracking-setup"
3
- pack: "@rune/analytics"
4
- description: "Analytics tracking — Google Analytics 4, Plausible, PostHog, Mixpanel. Event taxonomy design, consent management, server-side tracking, UTM handling."
5
- model: sonnet
6
- tools: [Read, Edit, Write, Grep, Glob, Bash]
7
- ---
8
-
9
- # tracking-setup
10
-
11
- Analytics tracking — Google Analytics 4, Plausible, PostHog, Mixpanel. Event taxonomy design, consent management, server-side tracking, UTM handling.
12
-
13
- #### Workflow
14
-
15
- **Step 1 — Detect tracking setup**
16
- Use Grep to find analytics code: `gtag`, `posthog.capture`, `mixpanel.track`, `plausible`, `analytics.track`, `useAnalytics`. Read the tracking initialization and event calls to understand: analytics provider, event naming convention, consent flow, and client vs server-side tracking.
17
-
18
- **Step 2 — Audit tracking quality**
19
- Check for: inconsistent event naming (mix of `snake_case`, `camelCase`, `kebab-case`), missing consent management (GDPR violation), tracking scripts blocking page load (performance impact), no event taxonomy document (ad-hoc event names), UTM parameters not captured on landing, user identification happening before consent, and no server-side tracking fallback (ad blockers lose 30-40% of events).
20
-
21
- **Step 3 — Emit tracking patterns**
22
- Emit: typed event taxonomy with auto-complete, consent-aware analytics wrapper, server-side event proxy for ad-blocker resistance, UTM capture and persistence utility, and page view tracking with proper SPA handling.
23
-
24
- #### Example
25
-
26
- ```typescript
27
- // Type-safe analytics wrapper with consent management
28
- type AnalyticsEvent =
29
- | { name: 'page_view'; properties: { path: string; referrer: string } }
30
- | { name: 'signup_started'; properties: { method: 'email' | 'google' | 'github' } }
31
- | { name: 'feature_used'; properties: { feature: string; plan: string } }
32
- | { name: 'checkout_started'; properties: { plan: string; billing: 'monthly' | 'annual' } }
33
- | { name: 'checkout_completed'; properties: { plan: string; revenue: number; currency: string } };
34
-
35
- class Analytics {
36
- private consent: 'granted' | 'denied' | 'pending' = 'pending';
37
- private queue: AnalyticsEvent[] = [];
38
-
39
- updateConsent(status: 'granted' | 'denied') {
40
- this.consent = status;
41
- if (status === 'granted') {
42
- this.queue.forEach(e => this.send(e));
43
- this.queue = [];
44
- } else {
45
- this.queue = [];
46
- }
47
- }
48
-
49
- track<E extends AnalyticsEvent>(event: E) {
50
- if (this.consent === 'denied') return;
51
- if (this.consent === 'pending') { this.queue.push(event); return; }
52
- this.send(event);
53
- }
54
-
55
- private send(event: AnalyticsEvent) {
56
- // Client-side (may be blocked)
57
- window.gtag?.('event', event.name, event.properties);
58
- // Server-side fallback (ad-blocker resistant)
59
- navigator.sendBeacon('/api/analytics', JSON.stringify(event));
60
- }
61
- }
62
-
63
- // UTM capture — run on landing page
64
- function captureUtm() {
65
- const params = new URLSearchParams(window.location.search);
66
- const utmKeys = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];
67
- const utm: Record<string, string> = {};
68
- utmKeys.forEach(key => { if (params.has(key)) utm[key] = params.get(key)!; });
69
- if (Object.keys(utm).length) sessionStorage.setItem('utm', JSON.stringify(utm));
70
- }
71
- ```
1
+ ---
2
+ name: "tracking-setup"
3
+ pack: "@rune/analytics"
4
+ description: "Analytics tracking — Google Analytics 4, Plausible, PostHog, Mixpanel. Event taxonomy design, consent management, server-side tracking, UTM handling."
5
+ model: sonnet
6
+ tools: [Read, Edit, Write, Grep, Glob, Bash]
7
+ ---
8
+
9
+ # tracking-setup
10
+
11
+ Analytics tracking — Google Analytics 4, Plausible, PostHog, Mixpanel. Event taxonomy design, consent management, server-side tracking, UTM handling.
12
+
13
+ #### Workflow
14
+
15
+ **Step 1 — Detect tracking setup**
16
+ Use Grep to find analytics code: `gtag`, `posthog.capture`, `mixpanel.track`, `plausible`, `analytics.track`, `useAnalytics`. Read the tracking initialization and event calls to understand: analytics provider, event naming convention, consent flow, and client vs server-side tracking.
17
+
18
+ **Step 2 — Audit tracking quality**
19
+ Check for: inconsistent event naming (mix of `snake_case`, `camelCase`, `kebab-case`), missing consent management (GDPR violation), tracking scripts blocking page load (performance impact), no event taxonomy document (ad-hoc event names), UTM parameters not captured on landing, user identification happening before consent, and no server-side tracking fallback (ad blockers lose 30-40% of events).
20
+
21
+ **Step 3 — Emit tracking patterns**
22
+ Emit: typed event taxonomy with auto-complete, consent-aware analytics wrapper, server-side event proxy for ad-blocker resistance, UTM capture and persistence utility, and page view tracking with proper SPA handling.
23
+
24
+ #### Example
25
+
26
+ ```typescript
27
+ // Type-safe analytics wrapper with consent management
28
+ type AnalyticsEvent =
29
+ | { name: 'page_view'; properties: { path: string; referrer: string } }
30
+ | { name: 'signup_started'; properties: { method: 'email' | 'google' | 'github' } }
31
+ | { name: 'feature_used'; properties: { feature: string; plan: string } }
32
+ | { name: 'checkout_started'; properties: { plan: string; billing: 'monthly' | 'annual' } }
33
+ | { name: 'checkout_completed'; properties: { plan: string; revenue: number; currency: string } };
34
+
35
+ class Analytics {
36
+ private consent: 'granted' | 'denied' | 'pending' = 'pending';
37
+ private queue: AnalyticsEvent[] = [];
38
+
39
+ updateConsent(status: 'granted' | 'denied') {
40
+ this.consent = status;
41
+ if (status === 'granted') {
42
+ this.queue.forEach(e => this.send(e));
43
+ this.queue = [];
44
+ } else {
45
+ this.queue = [];
46
+ }
47
+ }
48
+
49
+ track<E extends AnalyticsEvent>(event: E) {
50
+ if (this.consent === 'denied') return;
51
+ if (this.consent === 'pending') { this.queue.push(event); return; }
52
+ this.send(event);
53
+ }
54
+
55
+ private send(event: AnalyticsEvent) {
56
+ // Client-side (may be blocked)
57
+ window.gtag?.('event', event.name, event.properties);
58
+ // Server-side fallback (ad-blocker resistant)
59
+ navigator.sendBeacon('/api/analytics', JSON.stringify(event));
60
+ }
61
+ }
62
+
63
+ // UTM capture — run on landing page
64
+ function captureUtm() {
65
+ const params = new URLSearchParams(window.location.search);
66
+ const utmKeys = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];
67
+ const utm: Record<string, string> = {};
68
+ utmKeys.forEach(key => { if (params.has(key)) utm[key] = params.get(key)!; });
69
+ if (Object.keys(utm).length) sessionStorage.setItem('utm', JSON.stringify(utm));
70
+ }
71
+ ```