@rune-kit/rune 2.10.0 → 2.12.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 (240) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +65 -6
  3. package/commands/rune.md +168 -168
  4. package/compiler/__tests__/detect-invariants.test.js +136 -0
  5. package/compiler/__tests__/doctor-mesh.test.js +229 -0
  6. package/compiler/__tests__/hook-dispatch.test.js +91 -0
  7. package/compiler/__tests__/hooks-antigravity.test.js +118 -0
  8. package/compiler/__tests__/hooks-cursor.test.js +139 -0
  9. package/compiler/__tests__/hooks-install.test.js +305 -0
  10. package/compiler/__tests__/hooks-merge.test.js +204 -0
  11. package/compiler/__tests__/hooks-tiers.test.js +519 -0
  12. package/compiler/__tests__/hooks-windsurf.test.js +115 -0
  13. package/compiler/__tests__/inject-claude-md.test.js +152 -0
  14. package/compiler/__tests__/load-invariants.test.js +408 -0
  15. package/compiler/__tests__/onboard-invariants.test.js +240 -0
  16. package/compiler/adapters/hooks/antigravity.js +140 -0
  17. package/compiler/adapters/hooks/claude.js +166 -0
  18. package/compiler/adapters/hooks/cursor.js +191 -0
  19. package/compiler/adapters/hooks/index.js +82 -0
  20. package/compiler/adapters/hooks/tier-emitter.js +182 -0
  21. package/compiler/adapters/hooks/windsurf.js +202 -0
  22. package/compiler/bin/rune.js +196 -6
  23. package/compiler/commands/hook-dispatch.js +87 -0
  24. package/compiler/commands/hooks/install.js +120 -0
  25. package/compiler/commands/hooks/merge.js +211 -0
  26. package/compiler/commands/hooks/presets.js +116 -0
  27. package/compiler/commands/hooks/status.js +112 -0
  28. package/compiler/commands/hooks/tiers.js +221 -0
  29. package/compiler/commands/hooks/uninstall.js +94 -0
  30. package/compiler/doctor.js +236 -0
  31. package/contexts/dev.md +34 -34
  32. package/contexts/research.md +43 -43
  33. package/contexts/review.md +55 -55
  34. package/extensions/ai-ml/PACK.md +88 -88
  35. package/extensions/ai-ml/skills/ai-agents.md +172 -172
  36. package/extensions/ai-ml/skills/code-sandbox.md +187 -187
  37. package/extensions/ai-ml/skills/deep-research.md +146 -146
  38. package/extensions/ai-ml/skills/embedding-search.md +66 -66
  39. package/extensions/ai-ml/skills/fine-tuning-guide.md +74 -74
  40. package/extensions/ai-ml/skills/llm-architect.md +125 -125
  41. package/extensions/ai-ml/skills/llm-integration.md +64 -64
  42. package/extensions/ai-ml/skills/prompt-patterns.md +72 -72
  43. package/extensions/ai-ml/skills/rag-patterns.md +66 -66
  44. package/extensions/ai-ml/skills/web-extraction.md +114 -114
  45. package/extensions/analytics/PACK.md +92 -92
  46. package/extensions/analytics/skills/ab-testing.md +72 -72
  47. package/extensions/analytics/skills/dashboard-patterns.md +83 -83
  48. package/extensions/analytics/skills/data-validation.md +68 -68
  49. package/extensions/analytics/skills/funnel-analysis.md +81 -81
  50. package/extensions/analytics/skills/sql-patterns.md +57 -57
  51. package/extensions/analytics/skills/statistical-analysis.md +79 -79
  52. package/extensions/analytics/skills/tracking-setup.md +71 -71
  53. package/extensions/backend/PACK.md +104 -104
  54. package/extensions/backend/skills/api-patterns.md +84 -84
  55. package/extensions/backend/skills/async-pipeline.md +193 -193
  56. package/extensions/backend/skills/auth-patterns.md +97 -97
  57. package/extensions/backend/skills/background-jobs.md +133 -133
  58. package/extensions/backend/skills/caching-patterns.md +108 -108
  59. package/extensions/backend/skills/cli-generation.md +133 -133
  60. package/extensions/backend/skills/database-patterns.md +87 -87
  61. package/extensions/backend/skills/middleware-patterns.md +104 -104
  62. package/extensions/chrome-ext/PACK.md +93 -93
  63. package/extensions/chrome-ext/skills/cws-preflight.md +143 -143
  64. package/extensions/chrome-ext/skills/cws-publish.md +104 -104
  65. package/extensions/chrome-ext/skills/ext-ai-integration.md +251 -251
  66. package/extensions/chrome-ext/skills/ext-messaging.md +139 -139
  67. package/extensions/chrome-ext/skills/ext-storage.md +133 -133
  68. package/extensions/chrome-ext/skills/mv3-scaffold.md +164 -164
  69. package/extensions/content/PACK.md +96 -96
  70. package/extensions/content/skills/blog-patterns.md +88 -88
  71. package/extensions/content/skills/cms-integration.md +131 -131
  72. package/extensions/content/skills/content-scoring.md +107 -107
  73. package/extensions/content/skills/i18n.md +83 -83
  74. package/extensions/content/skills/mdx-authoring.md +137 -137
  75. package/extensions/content/skills/reference.md +1014 -1014
  76. package/extensions/content/skills/seo-patterns.md +67 -67
  77. package/extensions/content/skills/video-repurpose.md +153 -153
  78. package/extensions/devops/PACK.md +101 -101
  79. package/extensions/devops/skills/chaos-testing.md +67 -67
  80. package/extensions/devops/skills/ci-cd.md +75 -75
  81. package/extensions/devops/skills/docker.md +58 -58
  82. package/extensions/devops/skills/edge-serverless.md +163 -163
  83. package/extensions/devops/skills/infra-as-code.md +158 -158
  84. package/extensions/devops/skills/kubernetes.md +110 -110
  85. package/extensions/devops/skills/monitoring.md +57 -57
  86. package/extensions/devops/skills/server-setup.md +64 -64
  87. package/extensions/devops/skills/ssl-domain.md +42 -42
  88. package/extensions/ecommerce/PACK.md +116 -116
  89. package/extensions/ecommerce/skills/cart-system.md +79 -79
  90. package/extensions/ecommerce/skills/inventory-mgmt.md +102 -102
  91. package/extensions/ecommerce/skills/order-management.md +126 -126
  92. package/extensions/ecommerce/skills/payment-integration.md +472 -472
  93. package/extensions/ecommerce/skills/shopify-dev.md +69 -69
  94. package/extensions/ecommerce/skills/subscription-billing.md +93 -93
  95. package/extensions/ecommerce/skills/tax-compliance.md +117 -117
  96. package/extensions/gamedev/PACK.md +142 -142
  97. package/extensions/gamedev/skills/asset-pipeline.md +74 -74
  98. package/extensions/gamedev/skills/audio-system.md +129 -129
  99. package/extensions/gamedev/skills/camera-system.md +87 -87
  100. package/extensions/gamedev/skills/ecs.md +98 -98
  101. package/extensions/gamedev/skills/game-loops.md +72 -72
  102. package/extensions/gamedev/skills/input-system.md +199 -199
  103. package/extensions/gamedev/skills/multiplayer.md +180 -180
  104. package/extensions/gamedev/skills/particles.md +105 -105
  105. package/extensions/gamedev/skills/physics-engine.md +89 -89
  106. package/extensions/gamedev/skills/scene-management.md +146 -146
  107. package/extensions/gamedev/skills/threejs-patterns.md +90 -90
  108. package/extensions/gamedev/skills/webgl.md +71 -71
  109. package/extensions/mobile/PACK.md +106 -106
  110. package/extensions/mobile/skills/app-store-connect.md +152 -152
  111. package/extensions/mobile/skills/app-store-prep.md +66 -66
  112. package/extensions/mobile/skills/deep-linking.md +109 -109
  113. package/extensions/mobile/skills/flutter.md +60 -60
  114. package/extensions/mobile/skills/ios-build-pipeline.md +142 -142
  115. package/extensions/mobile/skills/native-bridge.md +66 -66
  116. package/extensions/mobile/skills/ota-updates.md +97 -97
  117. package/extensions/mobile/skills/push-notifications.md +111 -111
  118. package/extensions/mobile/skills/react-native.md +82 -82
  119. package/extensions/saas/PACK.md +116 -116
  120. package/extensions/saas/skills/billing-integration.md +200 -200
  121. package/extensions/saas/skills/feature-flags.md +130 -130
  122. package/extensions/saas/skills/multi-tenant.md +103 -103
  123. package/extensions/saas/skills/onboarding-flow.md +139 -139
  124. package/extensions/saas/skills/subscription-flow.md +95 -95
  125. package/extensions/saas/skills/team-management.md +144 -144
  126. package/extensions/security/PACK.md +99 -99
  127. package/extensions/security/skills/api-security.md +140 -140
  128. package/extensions/security/skills/compliance.md +68 -68
  129. package/extensions/security/skills/owasp-audit.md +64 -64
  130. package/extensions/security/skills/pentest-patterns.md +77 -77
  131. package/extensions/security/skills/secret-mgmt.md +65 -65
  132. package/extensions/security/skills/supply-chain.md +65 -65
  133. package/extensions/trading/PACK.md +80 -80
  134. package/extensions/trading/skills/chart-components.md +55 -55
  135. package/extensions/trading/skills/experiment-loop.md +125 -125
  136. package/extensions/trading/skills/fintech-patterns.md +47 -47
  137. package/extensions/trading/skills/indicator-library.md +58 -58
  138. package/extensions/trading/skills/quant-analysis.md +111 -111
  139. package/extensions/trading/skills/realtime-data.md +58 -58
  140. package/extensions/trading/skills/trade-logic.md +104 -104
  141. package/extensions/ui/PACK.md +130 -130
  142. package/extensions/ui/skills/a11y-audit.md +91 -91
  143. package/extensions/ui/skills/animation-patterns.md +127 -127
  144. package/extensions/ui/skills/component-patterns.md +100 -100
  145. package/extensions/ui/skills/design-decision.md +108 -108
  146. package/extensions/ui/skills/design-system.md +68 -68
  147. package/extensions/ui/skills/landing-patterns.md +155 -155
  148. package/extensions/ui/skills/palette-picker.md +173 -173
  149. package/extensions/ui/skills/react-health.md +90 -90
  150. package/extensions/ui/skills/type-system.md +125 -125
  151. package/extensions/ui/skills/web-vitals.md +153 -153
  152. package/extensions/zalo/PACK.md +145 -145
  153. package/extensions/zalo/skills/zalo-oa-mcp.md +317 -317
  154. package/extensions/zalo/skills/zalo-oa-messaging.md +429 -429
  155. package/extensions/zalo/skills/zalo-oa-setup.md +236 -236
  156. package/extensions/zalo/skills/zalo-oa-webhook.md +189 -189
  157. package/extensions/zalo/skills/zalo-personal-messaging.md +194 -194
  158. package/extensions/zalo/skills/zalo-personal-setup.md +153 -153
  159. package/extensions/zalo/skills/zalo-rate-guard.md +219 -219
  160. package/hooks/auto-format/index.cjs +48 -48
  161. package/hooks/hooks.json +111 -111
  162. package/hooks/post-session-reflect/index.cjs +189 -189
  163. package/hooks/pre-compact/index.cjs +95 -95
  164. package/hooks/run-hook.cmd +1 -1
  165. package/hooks/secrets-scan/index.cjs +100 -100
  166. package/hooks/session-start/index.cjs +71 -71
  167. package/hooks/typecheck/index.cjs +65 -65
  168. package/package.json +63 -63
  169. package/references/ui-pro-max-data/LICENSE-UI-PRO-MAX +21 -21
  170. package/references/ui-pro-max-data/charts.csv +26 -26
  171. package/references/ui-pro-max-data/colors.csv +161 -161
  172. package/references/ui-pro-max-data/styles.csv +68 -68
  173. package/references/ui-pro-max-data/typography.csv +74 -74
  174. package/references/ui-pro-max-data/ui-reasoning.csv +162 -162
  175. package/references/ui-pro-max-data/ux-guidelines.csv +99 -99
  176. package/skills/adversary/SKILL.md +283 -283
  177. package/skills/asset-creator/SKILL.md +157 -157
  178. package/skills/audit/SKILL.md +147 -2
  179. package/skills/autopsy/SKILL.md +335 -335
  180. package/skills/ba/SKILL.md +85 -1
  181. package/skills/brainstorm/SKILL.md +380 -342
  182. package/skills/browser-pilot/SKILL.md +169 -168
  183. package/skills/constraint-check/SKILL.md +165 -165
  184. package/skills/context-engine/SKILL.md +408 -404
  185. package/skills/cook/SKILL.md +917 -863
  186. package/skills/db/SKILL.md +273 -273
  187. package/skills/debug/SKILL.md +465 -465
  188. package/skills/dependency-doctor/SKILL.md +265 -235
  189. package/skills/deploy/SKILL.md +274 -231
  190. package/skills/design/DESIGN-REFERENCE.md +365 -365
  191. package/skills/design/SKILL.md +590 -589
  192. package/skills/doc-processor/SKILL.md +254 -254
  193. package/skills/docs/SKILL.md +374 -374
  194. package/skills/docs-seeker/SKILL.md +178 -177
  195. package/skills/fix/SKILL.md +332 -330
  196. package/skills/git/SKILL.md +339 -339
  197. package/skills/hallucination-guard/SKILL.md +220 -219
  198. package/skills/incident/SKILL.md +254 -253
  199. package/skills/integrity-check/SKILL.md +169 -169
  200. package/skills/journal/SKILL.md +241 -240
  201. package/skills/launch/SKILL.md +344 -344
  202. package/skills/logic-guardian/SKILL.md +269 -251
  203. package/skills/marketing/SKILL.md +351 -289
  204. package/skills/mcp-builder/SKILL.md +425 -425
  205. package/skills/neural-memory/SKILL.md +359 -362
  206. package/skills/onboard/SKILL.md +432 -403
  207. package/skills/onboard/references/invariants-template.md +76 -0
  208. package/skills/onboard/scripts/detect-invariants.js +439 -0
  209. package/skills/onboard/scripts/inject-claude-md.js +150 -0
  210. package/skills/onboard/scripts/onboard-invariants.js +194 -0
  211. package/skills/perf/SKILL.md +347 -346
  212. package/skills/plan/SKILL.md +435 -428
  213. package/skills/preflight/SKILL.md +415 -415
  214. package/skills/problem-solver/SKILL.md +380 -284
  215. package/skills/rescue/SKILL.md +474 -474
  216. package/skills/research/SKILL.md +4 -0
  217. package/skills/retro/SKILL.md +3 -1
  218. package/skills/review/SKILL.md +614 -588
  219. package/skills/review-intake/SKILL.md +249 -249
  220. package/skills/safeguard/SKILL.md +200 -200
  221. package/skills/sast/SKILL.md +190 -190
  222. package/skills/scaffold/SKILL.md +328 -287
  223. package/skills/scope-guard/SKILL.md +183 -180
  224. package/skills/scout/SKILL.md +269 -263
  225. package/skills/sentinel/SKILL.md +384 -381
  226. package/skills/sentinel-env/SKILL.md +254 -254
  227. package/skills/sequential-thinking/SKILL.md +234 -234
  228. package/skills/session-bridge/SKILL.md +595 -543
  229. package/skills/session-bridge/scripts/load-invariants.js +397 -0
  230. package/skills/skill-forge/SKILL.md +581 -581
  231. package/skills/skill-router/SKILL.md +3 -0
  232. package/skills/slides/SKILL.md +19 -0
  233. package/skills/surgeon/SKILL.md +215 -215
  234. package/skills/team/SKILL.md +557 -537
  235. package/skills/test/SKILL.md +620 -614
  236. package/skills/trend-scout/SKILL.md +145 -145
  237. package/skills/verification/SKILL.md +334 -326
  238. package/skills/video-creator/SKILL.md +201 -201
  239. package/skills/watchdog/SKILL.md +168 -168
  240. 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
+ ```