@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
package/skills/doc-processor/SKILL.md CHANGED
@@ -1,254 +1,254 @@
1
- ---
2
- name: doc-processor
3
- description: Generate and parse office documents — PDF, DOCX, XLSX, PPTX, CSV. Pure format utility for creating reports, exporting data, and processing uploaded documents.
4
- metadata:
5
- author: runedev
6
- version: "0.2.0"
7
- layer: L3
8
- model: sonnet
9
- group: utility
10
- tools: "Read, Write, Edit, Bash, Glob, Grep"
11
- ---
12
-
13
- # doc-processor
14
-
15
- ## Purpose
16
-
17
- Document format utility. Generates and parses office documents (PDF, DOCX, XLSX, PPTX, CSV). Pure utility — no business logic, just format handling. Other skills call doc-processor when they need to produce or consume structured documents.
18
-
19
- ## Triggers
20
-
21
- - Called by `docs` when export to PDF/DOCX is requested
22
- - Called by `marketing` for generating PDF reports, PPTX presentations
23
- - Called by Rune Pro packs for business document generation
24
- - `/rune doc-processor generate <format> <source>` — manual document generation
25
- - `/rune doc-processor parse <file>` — manual document parsing
26
-
27
- ## Calls (outbound)
28
-
29
- None — pure L3 utility. Receives content, produces formatted output.
30
-
31
- ## Called By (inbound)
32
-
33
- - `docs` (L2): export documentation to PDF/DOCX
34
- - `marketing` (L2): generate PDF reports, PPTX pitch decks
35
- - Rune Pro packs: business document generation (invoices, proposals, reports)
36
- - User: `/rune doc-processor` direct invocation
37
-
38
- ## Format Reference
39
-
40
- ### Supported Formats
41
-
42
- | Format | Generate | Parse | Node.js Library | Python Library |
43
- |--------|----------|-------|-----------------|----------------|
44
- | PDF | Yes | Yes (via Read tool) | jsPDF, Puppeteer (HTML→PDF) | reportlab, weasyprint |
45
- | DOCX | Yes | Yes | docx (officegen) | python-docx |
46
- | XLSX | Yes | Yes | ExcelJS | openpyxl |
47
- | PPTX | Yes | Yes | pptxgenjs | python-pptx |
48
- | CSV | Yes | Yes | Built-in (fs + string ops) | Built-in (csv module) |
49
- | HTML | Yes | Yes | Built-in | Built-in |
50
-
51
- ### Library Selection
52
-
53
- Detect project language from context:
54
- - If Node.js project → use Node.js libraries
55
- - If Python project → use Python libraries
56
- - If unclear → default to Node.js (wider ecosystem)
57
- - For HTML→PDF → prefer Puppeteer (best fidelity) or weasyprint (Python)
58
-
59
- ## Executable Steps
60
-
61
- ### Generate Mode
62
-
63
- #### Step 1 — Determine Format and Template
64
-
65
- Identify:
66
- - Target format (PDF, DOCX, XLSX, PPTX, CSV)
67
- - Content source (markdown, data object, template + data)
68
- - Styling requirements (brand colors, fonts, layout)
69
- - Output path
70
-
71
- #### Step 2 — Select Generation Strategy
72
-
73
- | Source | Target | Strategy |
74
- |--------|--------|----------|
75
- | Markdown → PDF | HTML intermediate | Render MD → HTML → Puppeteer → PDF |
76
- | Markdown → DOCX | Direct conversion | Parse MD → docx library → DOCX |
77
- | Data → XLSX | Direct write | Map data to sheets/cells → ExcelJS |
78
- | Slides → PPTX | Template + data | Build slides from content → pptxgenjs |
79
- | Data → CSV | Direct write | Serialize rows → CSV string → file |
80
- | Any → HTML | Direct render | Template engine → HTML file |
81
-
82
- #### Step 3 — Generate Code
83
-
84
- Produce the generation script:
85
-
86
- **PDF from Markdown:**
87
- ```javascript
88
- // Strategy: Markdown → HTML → Puppeteer → PDF
89
- const puppeteer = require('puppeteer');
90
- const { marked } = require('marked');
91
-
92
- async function generatePDF(markdownContent, outputPath, options = {}) {
93
- const html = `
94
- <!DOCTYPE html>
95
- <html>
96
- <head><style>${options.css || defaultCSS}</style></head>
97
- <body>${marked(markdownContent)}</body>
98
- </html>
99
- `;
100
- const browser = await puppeteer.launch();
101
- const page = await browser.newPage();
102
- await page.setContent(html, { waitUntil: 'networkidle0' });
103
- await page.pdf({ path: outputPath, format: 'A4', margin: { top: '1in', bottom: '1in', left: '1in', right: '1in' } });
104
- await browser.close();
105
- }
106
- ```
107
-
108
- **XLSX from Data:**
109
- ```javascript
110
- const ExcelJS = require('exceljs');
111
-
112
- async function generateXLSX(data, outputPath, options = {}) {
113
- const workbook = new ExcelJS.Workbook();
114
- const sheet = workbook.addWorksheet(options.sheetName || 'Sheet1');
115
- if (data.length > 0) {
116
- sheet.columns = Object.keys(data[0]).map(key => ({ header: key, key, width: 20 }));
117
- data.forEach(row => sheet.addRow(row));
118
- // Style header row
119
- sheet.getRow(1).font = { bold: true };
120
- sheet.getRow(1).fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFE0E0E0' } };
121
- }
122
- await workbook.xlsx.writeFile(outputPath);
123
- }
124
- ```
125
-
126
- **PPTX from Slides:**
127
- ```javascript
128
- const PptxGenJS = require('pptxgenjs');
129
-
130
- function generatePPTX(slides, outputPath, options = {}) {
131
- const pptx = new PptxGenJS();
132
- pptx.author = options.author || 'Generated by Rune';
133
- slides.forEach(slide => {
134
- const s = pptx.addSlide();
135
- if (slide.title) s.addText(slide.title, { x: 0.5, y: 0.5, fontSize: 28, bold: true });
136
- if (slide.body) s.addText(slide.body, { x: 0.5, y: 1.5, fontSize: 16 });
137
- if (slide.bullets) s.addText(slide.bullets.map(b => ({ text: b, options: { bullet: true } })), { x: 0.5, y: 1.5, fontSize: 16 });
138
- });
139
- return pptx.writeFile({ fileName: outputPath });
140
- }
141
- ```
142
-
143
- #### Step 4 — Execute and Verify
144
-
145
- Run the generation script. Verify:
146
- - Output file exists and is non-empty
147
- - File can be opened (basic format validation)
148
- - Content matches expected structure
149
-
150
- ### Parse Mode
151
-
152
- #### Step 1 — Detect Format
153
-
154
- Identify file format from extension and MIME type.
155
-
156
- #### Step 2 — Extract Content
157
-
158
- | Format | Extraction Strategy |
159
- |--------|-------------------|
160
- | PDF | Use Read tool (Claude can read PDFs natively) |
161
- | DOCX | docx library → extract text, tables, images |
162
- | XLSX | ExcelJS → extract sheets, rows, formulas |
163
- | PPTX | pptxgenjs → extract slides, text, notes |
164
- | CSV | Built-in parser → structured data |
165
-
166
- #### Step 3 — Structure Output
167
-
168
- Return parsed content as structured data:
169
- ```json
170
- {
171
- "format": "xlsx",
172
- "sheets": [
173
- {
174
- "name": "Sheet1",
175
- "headers": ["Name", "Email", "Role"],
176
- "rows": [["Alice", "alice@co.com", "Engineer"], ...],
177
- "rowCount": 100
178
- }
179
- ]
180
- }
181
- ```
182
-
183
- ## Output Format
184
-
185
- ### Generate Mode Output
186
- - Generated document file at specified output path
187
- - Verification report: file exists, non-empty, format valid
188
-
189
- ```
190
- Document Generated:
191
- - Format: [PDF/DOCX/XLSX/PPTX/CSV]
192
- - Path: [output file path]
193
- - Size: [file size]
194
- - Strategy: [e.g., Markdown → HTML → Puppeteer → PDF]
195
- - Status: verified ✓
196
- ```
197
-
198
- ### Parse Mode Output
199
- Structured JSON returned to calling skill:
200
-
201
- ```json
202
- {
203
- "format": "xlsx",
204
- "metadata": { "author": "...", "created": "..." },
205
- "content": {
206
- "sheets": [
207
- {
208
- "name": "Sheet1",
209
- "headers": ["Col1", "Col2"],
210
- "rows": [["val1", "val2"]],
211
- "rowCount": 100
212
- }
213
- ]
214
- }
215
- }
216
- ```
217
-
218
- Format-specific fields: `sheets` (XLSX), `pages` (PDF/DOCX), `slides` (PPTX), `rows` (CSV).
219
-
220
- ## Constraints
221
-
222
- 1. MUST verify output file exists and is non-empty after generation
223
- 2. MUST handle missing libraries gracefully — suggest `npm install` / `pip install` if not found
224
- 3. MUST NOT embed secrets or sensitive data in generated documents
225
- 4. MUST preserve formatting fidelity — generated docs should look professional
226
- 5. Parse mode MUST handle malformed files gracefully — report errors, don't crash
227
- 6. MUST use appropriate library for each format — don't force one library for all formats
228
-
229
- ## Sharp Edges
230
-
231
- | Failure Mode | Severity | Mitigation |
232
- |---|---|---|
233
- | Library not installed in project | HIGH | Check package.json/requirements.txt, suggest install command |
234
- | PDF generation fails without headless browser | HIGH | Puppeteer needs chromium — suggest alternative (jsPDF) if unavailable |
235
- | XLSX with formulas not evaluated | MEDIUM | Use ExcelJS formula support, warn if complex formulas |
236
- | Large file generation runs out of memory | MEDIUM | Stream large datasets instead of loading all at once |
237
- | Generated file is empty or corrupt | HIGH | Step 4 verification catches this — retry or report |
238
-
239
- ## Done When
240
-
241
- ### Generate Mode
242
- - Target format and source identified
243
- - Generation strategy selected
244
- - Code produced and executed
245
- - Output file verified (exists, non-empty, valid format)
246
-
247
- ### Parse Mode
248
- - File format detected
249
- - Content extracted to structured data
250
- - Output returned in consistent JSON format
251
-
252
- ## Cost Profile
253
-
254
- ~1000-3000 tokens input, ~500-2000 tokens output. Sonnet — document processing requires understanding format libraries and generating correct code, but not deep reasoning.
1
+ ---
2
+ name: doc-processor
3
+ description: Generate and parse office documents — PDF, DOCX, XLSX, PPTX, CSV. Pure format utility for creating reports, exporting data, and processing uploaded documents.
4
+ metadata:
5
+ author: runedev
6
+ version: "0.2.0"
7
+ layer: L3
8
+ model: sonnet
9
+ group: utility
10
+ tools: "Read, Write, Edit, Bash, Glob, Grep"
11
+ ---
12
+
13
+ # doc-processor
14
+
15
+ ## Purpose
16
+
17
+ Document format utility. Generates and parses office documents (PDF, DOCX, XLSX, PPTX, CSV). Pure utility — no business logic, just format handling. Other skills call doc-processor when they need to produce or consume structured documents.
18
+
19
+ ## Triggers
20
+
21
+ - Called by `docs` when export to PDF/DOCX is requested
22
+ - Called by `marketing` for generating PDF reports, PPTX presentations
23
+ - Called by Rune Pro packs for business document generation
24
+ - `/rune doc-processor generate <format> <source>` — manual document generation
25
+ - `/rune doc-processor parse <file>` — manual document parsing
26
+
27
+ ## Calls (outbound)
28
+
29
+ None — pure L3 utility. Receives content, produces formatted output.
30
+
31
+ ## Called By (inbound)
32
+
33
+ - `docs` (L2): export documentation to PDF/DOCX
34
+ - `marketing` (L2): generate PDF reports, PPTX pitch decks
35
+ - Rune Pro packs: business document generation (invoices, proposals, reports)
36
+ - User: `/rune doc-processor` direct invocation
37
+
38
+ ## Format Reference
39
+
40
+ ### Supported Formats
41
+
42
+ | Format | Generate | Parse | Node.js Library | Python Library |
43
+ |--------|----------|-------|-----------------|----------------|
44
+ | PDF | Yes | Yes (via Read tool) | jsPDF, Puppeteer (HTML→PDF) | reportlab, weasyprint |
45
+ | DOCX | Yes | Yes | docx (officegen) | python-docx |
46
+ | XLSX | Yes | Yes | ExcelJS | openpyxl |
47
+ | PPTX | Yes | Yes | pptxgenjs | python-pptx |
48
+ | CSV | Yes | Yes | Built-in (fs + string ops) | Built-in (csv module) |
49
+ | HTML | Yes | Yes | Built-in | Built-in |
50
+
51
+ ### Library Selection
52
+
53
+ Detect project language from context:
54
+ - If Node.js project → use Node.js libraries
55
+ - If Python project → use Python libraries
56
+ - If unclear → default to Node.js (wider ecosystem)
57
+ - For HTML→PDF → prefer Puppeteer (best fidelity) or weasyprint (Python)
58
+
59
+ ## Executable Steps
60
+
61
+ ### Generate Mode
62
+
63
+ #### Step 1 — Determine Format and Template
64
+
65
+ Identify:
66
+ - Target format (PDF, DOCX, XLSX, PPTX, CSV)
67
+ - Content source (markdown, data object, template + data)
68
+ - Styling requirements (brand colors, fonts, layout)
69
+ - Output path
70
+
71
+ #### Step 2 — Select Generation Strategy
72
+
73
+ | Source | Target | Strategy |
74
+ |--------|--------|----------|
75
+ | Markdown → PDF | HTML intermediate | Render MD → HTML → Puppeteer → PDF |
76
+ | Markdown → DOCX | Direct conversion | Parse MD → docx library → DOCX |
77
+ | Data → XLSX | Direct write | Map data to sheets/cells → ExcelJS |
78
+ | Slides → PPTX | Template + data | Build slides from content → pptxgenjs |
79
+ | Data → CSV | Direct write | Serialize rows → CSV string → file |
80
+ | Any → HTML | Direct render | Template engine → HTML file |
81
+
82
+ #### Step 3 — Generate Code
83
+
84
+ Produce the generation script:
85
+
86
+ **PDF from Markdown:**
87
+ ```javascript
88
+ // Strategy: Markdown → HTML → Puppeteer → PDF
89
+ const puppeteer = require('puppeteer');
90
+ const { marked } = require('marked');
91
+
92
+ async function generatePDF(markdownContent, outputPath, options = {}) {
93
+ const html = `
94
+ <!DOCTYPE html>
95
+ <html>
96
+ <head><style>${options.css || defaultCSS}</style></head>
97
+ <body>${marked(markdownContent)}</body>
98
+ </html>
99
+ `;
100
+ const browser = await puppeteer.launch();
101
+ const page = await browser.newPage();
102
+ await page.setContent(html, { waitUntil: 'networkidle0' });
103
+ await page.pdf({ path: outputPath, format: 'A4', margin: { top: '1in', bottom: '1in', left: '1in', right: '1in' } });
104
+ await browser.close();
105
+ }
106
+ ```
107
+
108
+ **XLSX from Data:**
109
+ ```javascript
110
+ const ExcelJS = require('exceljs');
111
+
112
+ async function generateXLSX(data, outputPath, options = {}) {
113
+ const workbook = new ExcelJS.Workbook();
114
+ const sheet = workbook.addWorksheet(options.sheetName || 'Sheet1');
115
+ if (data.length > 0) {
116
+ sheet.columns = Object.keys(data[0]).map(key => ({ header: key, key, width: 20 }));
117
+ data.forEach(row => sheet.addRow(row));
118
+ // Style header row
119
+ sheet.getRow(1).font = { bold: true };
120
+ sheet.getRow(1).fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFE0E0E0' } };
121
+ }
122
+ await workbook.xlsx.writeFile(outputPath);
123
+ }
124
+ ```
125
+
126
+ **PPTX from Slides:**
127
+ ```javascript
128
+ const PptxGenJS = require('pptxgenjs');
129
+
130
+ function generatePPTX(slides, outputPath, options = {}) {
131
+ const pptx = new PptxGenJS();
132
+ pptx.author = options.author || 'Generated by Rune';
133
+ slides.forEach(slide => {
134
+ const s = pptx.addSlide();
135
+ if (slide.title) s.addText(slide.title, { x: 0.5, y: 0.5, fontSize: 28, bold: true });
136
+ if (slide.body) s.addText(slide.body, { x: 0.5, y: 1.5, fontSize: 16 });
137
+ if (slide.bullets) s.addText(slide.bullets.map(b => ({ text: b, options: { bullet: true } })), { x: 0.5, y: 1.5, fontSize: 16 });
138
+ });
139
+ return pptx.writeFile({ fileName: outputPath });
140
+ }
141
+ ```
142
+
143
+ #### Step 4 — Execute and Verify
144
+
145
+ Run the generation script. Verify:
146
+ - Output file exists and is non-empty
147
+ - File can be opened (basic format validation)
148
+ - Content matches expected structure
149
+
150
+ ### Parse Mode
151
+
152
+ #### Step 1 — Detect Format
153
+
154
+ Identify file format from extension and MIME type.
155
+
156
+ #### Step 2 — Extract Content
157
+
158
+ | Format | Extraction Strategy |
159
+ |--------|-------------------|
160
+ | PDF | Use Read tool (Claude can read PDFs natively) |
161
+ | DOCX | docx library → extract text, tables, images |
162
+ | XLSX | ExcelJS → extract sheets, rows, formulas |
163
+ | PPTX | pptxgenjs → extract slides, text, notes |
164
+ | CSV | Built-in parser → structured data |
165
+
166
+ #### Step 3 — Structure Output
167
+
168
+ Return parsed content as structured data:
169
+ ```json
170
+ {
171
+ "format": "xlsx",
172
+ "sheets": [
173
+ {
174
+ "name": "Sheet1",
175
+ "headers": ["Name", "Email", "Role"],
176
+ "rows": [["Alice", "alice@co.com", "Engineer"], ...],
177
+ "rowCount": 100
178
+ }
179
+ ]
180
+ }
181
+ ```
182
+
183
+ ## Output Format
184
+
185
+ ### Generate Mode Output
186
+ - Generated document file at specified output path
187
+ - Verification report: file exists, non-empty, format valid
188
+
189
+ ```
190
+ Document Generated:
191
+ - Format: [PDF/DOCX/XLSX/PPTX/CSV]
192
+ - Path: [output file path]
193
+ - Size: [file size]
194
+ - Strategy: [e.g., Markdown → HTML → Puppeteer → PDF]
195
+ - Status: verified ✓
196
+ ```
197
+
198
+ ### Parse Mode Output
199
+ Structured JSON returned to calling skill:
200
+
201
+ ```json
202
+ {
203
+ "format": "xlsx",
204
+ "metadata": { "author": "...", "created": "..." },
205
+ "content": {
206
+ "sheets": [
207
+ {
208
+ "name": "Sheet1",
209
+ "headers": ["Col1", "Col2"],
210
+ "rows": [["val1", "val2"]],
211
+ "rowCount": 100
212
+ }
213
+ ]
214
+ }
215
+ }
216
+ ```
217
+
218
+ Format-specific fields: `sheets` (XLSX), `pages` (PDF/DOCX), `slides` (PPTX), `rows` (CSV).
219
+
220
+ ## Constraints
221
+
222
+ 1. MUST verify output file exists and is non-empty after generation
223
+ 2. MUST handle missing libraries gracefully — suggest `npm install` / `pip install` if not found
224
+ 3. MUST NOT embed secrets or sensitive data in generated documents
225
+ 4. MUST preserve formatting fidelity — generated docs should look professional
226
+ 5. Parse mode MUST handle malformed files gracefully — report errors, don't crash
227
+ 6. MUST use appropriate library for each format — don't force one library for all formats
228
+
229
+ ## Sharp Edges
230
+
231
+ | Failure Mode | Severity | Mitigation |
232
+ |---|---|---|
233
+ | Library not installed in project | HIGH | Check package.json/requirements.txt, suggest install command |
234
+ | PDF generation fails without headless browser | HIGH | Puppeteer needs chromium — suggest alternative (jsPDF) if unavailable |
235
+ | XLSX with formulas not evaluated | MEDIUM | Use ExcelJS formula support, warn if complex formulas |
236
+ | Large file generation runs out of memory | MEDIUM | Stream large datasets instead of loading all at once |
237
+ | Generated file is empty or corrupt | HIGH | Step 4 verification catches this — retry or report |
238
+
239
+ ## Done When
240
+
241
+ ### Generate Mode
242
+ - Target format and source identified
243
+ - Generation strategy selected
244
+ - Code produced and executed
245
+ - Output file verified (exists, non-empty, valid format)
246
+
247
+ ### Parse Mode
248
+ - File format detected
249
+ - Content extracted to structured data
250
+ - Output returned in consistent JSON format
251
+
252
+ ## Cost Profile
253
+
254
+ ~1000-3000 tokens input, ~500-2000 tokens output. Sonnet — document processing requires understanding format libraries and generating correct code, but not deep reasoning.