@tyroneross/build-loop 0.30.3

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 (389) hide show
  1. package/.agents/plugins/marketplace.json +10 -0
  2. package/.claude-plugin/marketplace.json +38 -0
  3. package/.claude-plugin/plugin.json +30 -0
  4. package/.codex-plugin/plugin.json +41 -0
  5. package/.cursor/rules/build-loop-surface.mdc +22 -0
  6. package/AGENTS.md +498 -0
  7. package/LICENSE +202 -0
  8. package/README.md +403 -0
  9. package/agents/alignment-checker.md +124 -0
  10. package/agents/api-assessor.md +136 -0
  11. package/agents/architecture-scout.md +185 -0
  12. package/agents/assessment-orchestrator.md +163 -0
  13. package/agents/build-orchestrator.md +198 -0
  14. package/agents/database-assessor.md +133 -0
  15. package/agents/design-contract-specialist.md +239 -0
  16. package/agents/fact-checker.md +69 -0
  17. package/agents/fix-critique.md +161 -0
  18. package/agents/frontend-assessor.md +136 -0
  19. package/agents/implementer.md +185 -0
  20. package/agents/independent-auditor.md +143 -0
  21. package/agents/mock-scanner.md +78 -0
  22. package/agents/optimize-runner.md +112 -0
  23. package/agents/overfitting-reviewer.md +96 -0
  24. package/agents/performance-assessor.md +159 -0
  25. package/agents/plan-critic.md +85 -0
  26. package/agents/promotion-reviewer.md +121 -0
  27. package/agents/recurring-pattern-detector.md +248 -0
  28. package/agents/retrospective-synthesizer.md +109 -0
  29. package/agents/root-cause-investigator.md +285 -0
  30. package/agents/scope-auditor.md +121 -0
  31. package/agents/security-reviewer.md +151 -0
  32. package/agents/self-improvement-architect.md +125 -0
  33. package/agents/synthesis-critic.md +99 -0
  34. package/agents/transcript-pattern-miner.md +165 -0
  35. package/agents/ui-validator.md +193 -0
  36. package/codex-skills/build-loop/SKILL.md +20 -0
  37. package/codex-skills/debug-loop/SKILL.md +18 -0
  38. package/codex-skills/handoff/SKILL.md +22 -0
  39. package/codex-skills/knowledge/SKILL.md +21 -0
  40. package/codex-skills/optimize/SKILL.md +18 -0
  41. package/codex-skills/research/SKILL.md +18 -0
  42. package/commands/agent-rally-point.md +301 -0
  43. package/commands/assess.md +41 -0
  44. package/commands/debug.md +20 -0
  45. package/commands/debugger-detail.md +34 -0
  46. package/commands/debugger-scan.md +15 -0
  47. package/commands/debugger-status.md +20 -0
  48. package/commands/debugger.md +32 -0
  49. package/commands/handoff.md +113 -0
  50. package/commands/knowledge-review.md +16 -0
  51. package/commands/optimize.md +31 -0
  52. package/commands/plan-verify.md +39 -0
  53. package/commands/promote-experiment.md +129 -0
  54. package/commands/research.md +22 -0
  55. package/commands/run.md +12 -0
  56. package/commands/self-review.md +51 -0
  57. package/commands/start-prd.md +57 -0
  58. package/commands/test.md +34 -0
  59. package/dist/src/assessment-orchestrator.d.ts +78 -0
  60. package/dist/src/assessment-orchestrator.d.ts.map +1 -0
  61. package/dist/src/assessment-orchestrator.js +304 -0
  62. package/dist/src/assessment-orchestrator.js.map +1 -0
  63. package/dist/src/audit-miner.d.ts +21 -0
  64. package/dist/src/audit-miner.d.ts.map +1 -0
  65. package/dist/src/audit-miner.js +421 -0
  66. package/dist/src/audit-miner.js.map +1 -0
  67. package/dist/src/batch-operations.d.ts +30 -0
  68. package/dist/src/batch-operations.d.ts.map +1 -0
  69. package/dist/src/batch-operations.js +339 -0
  70. package/dist/src/batch-operations.js.map +1 -0
  71. package/dist/src/config.d.ts +83 -0
  72. package/dist/src/config.d.ts.map +1 -0
  73. package/dist/src/config.js +176 -0
  74. package/dist/src/config.js.map +1 -0
  75. package/dist/src/context-engine.d.ts +45 -0
  76. package/dist/src/context-engine.d.ts.map +1 -0
  77. package/dist/src/context-engine.js +135 -0
  78. package/dist/src/context-engine.js.map +1 -0
  79. package/dist/src/debug-wrapper.d.ts +58 -0
  80. package/dist/src/debug-wrapper.d.ts.map +1 -0
  81. package/dist/src/debug-wrapper.js +285 -0
  82. package/dist/src/debug-wrapper.js.map +1 -0
  83. package/dist/src/index.d.ts +31 -0
  84. package/dist/src/index.d.ts.map +1 -0
  85. package/dist/src/index.js +149 -0
  86. package/dist/src/index.js.map +1 -0
  87. package/dist/src/interactive-verifier.d.ts +26 -0
  88. package/dist/src/interactive-verifier.d.ts.map +1 -0
  89. package/dist/src/interactive-verifier.js +435 -0
  90. package/dist/src/interactive-verifier.js.map +1 -0
  91. package/dist/src/lessons.d.ts +59 -0
  92. package/dist/src/lessons.d.ts.map +1 -0
  93. package/dist/src/lessons.js +172 -0
  94. package/dist/src/lessons.js.map +1 -0
  95. package/dist/src/log-reader.d.ts +39 -0
  96. package/dist/src/log-reader.d.ts.map +1 -0
  97. package/dist/src/log-reader.js +291 -0
  98. package/dist/src/log-reader.js.map +1 -0
  99. package/dist/src/logger.d.ts +59 -0
  100. package/dist/src/logger.d.ts.map +1 -0
  101. package/dist/src/logger.js +328 -0
  102. package/dist/src/logger.js.map +1 -0
  103. package/dist/src/parallel-retrieval.d.ts +52 -0
  104. package/dist/src/parallel-retrieval.d.ts.map +1 -0
  105. package/dist/src/parallel-retrieval.js +309 -0
  106. package/dist/src/parallel-retrieval.js.map +1 -0
  107. package/dist/src/pattern-extractor.d.ts +30 -0
  108. package/dist/src/pattern-extractor.d.ts.map +1 -0
  109. package/dist/src/pattern-extractor.js +386 -0
  110. package/dist/src/pattern-extractor.js.map +1 -0
  111. package/dist/src/result-aggregator.d.ts +44 -0
  112. package/dist/src/result-aggregator.d.ts.map +1 -0
  113. package/dist/src/result-aggregator.js +315 -0
  114. package/dist/src/result-aggregator.js.map +1 -0
  115. package/dist/src/retrieval.d.ts +139 -0
  116. package/dist/src/retrieval.d.ts.map +1 -0
  117. package/dist/src/retrieval.js +724 -0
  118. package/dist/src/retrieval.js.map +1 -0
  119. package/dist/src/setup/auto-setup.d.ts +15 -0
  120. package/dist/src/setup/auto-setup.d.ts.map +1 -0
  121. package/dist/src/setup/auto-setup.js +157 -0
  122. package/dist/src/setup/auto-setup.js.map +1 -0
  123. package/dist/src/setup/configure-hooks.d.ts +8 -0
  124. package/dist/src/setup/configure-hooks.d.ts.map +1 -0
  125. package/dist/src/setup/configure-hooks.js +16 -0
  126. package/dist/src/setup/configure-hooks.js.map +1 -0
  127. package/dist/src/setup/create-slash-commands.d.ts +8 -0
  128. package/dist/src/setup/create-slash-commands.d.ts.map +1 -0
  129. package/dist/src/setup/create-slash-commands.js +101 -0
  130. package/dist/src/setup/create-slash-commands.js.map +1 -0
  131. package/dist/src/setup/index.d.ts +8 -0
  132. package/dist/src/setup/index.d.ts.map +1 -0
  133. package/dist/src/setup/index.js +17 -0
  134. package/dist/src/setup/index.js.map +1 -0
  135. package/dist/src/setup/inject-claude-md.d.ts +10 -0
  136. package/dist/src/setup/inject-claude-md.d.ts.map +1 -0
  137. package/dist/src/setup/inject-claude-md.js +150 -0
  138. package/dist/src/setup/inject-claude-md.js.map +1 -0
  139. package/dist/src/setup/uninstall.d.ts +22 -0
  140. package/dist/src/setup/uninstall.d.ts.map +1 -0
  141. package/dist/src/setup/uninstall.js +235 -0
  142. package/dist/src/setup/uninstall.js.map +1 -0
  143. package/dist/src/storage.d.ts +192 -0
  144. package/dist/src/storage.d.ts.map +1 -0
  145. package/dist/src/storage.js +1037 -0
  146. package/dist/src/storage.js.map +1 -0
  147. package/dist/src/string-similarity.d.ts +8 -0
  148. package/dist/src/string-similarity.d.ts.map +1 -0
  149. package/dist/src/string-similarity.js +57 -0
  150. package/dist/src/string-similarity.js.map +1 -0
  151. package/dist/src/traces/adapters/browser.d.ts +69 -0
  152. package/dist/src/traces/adapters/browser.d.ts.map +1 -0
  153. package/dist/src/traces/adapters/browser.js +280 -0
  154. package/dist/src/traces/adapters/browser.js.map +1 -0
  155. package/dist/src/traces/adapters/index.d.ts +23 -0
  156. package/dist/src/traces/adapters/index.d.ts.map +1 -0
  157. package/dist/src/traces/adapters/index.js +67 -0
  158. package/dist/src/traces/adapters/index.js.map +1 -0
  159. package/dist/src/traces/adapters/langchain.d.ts +42 -0
  160. package/dist/src/traces/adapters/langchain.d.ts.map +1 -0
  161. package/dist/src/traces/adapters/langchain.js +151 -0
  162. package/dist/src/traces/adapters/langchain.js.map +1 -0
  163. package/dist/src/traces/adapters/opentelemetry.d.ts +46 -0
  164. package/dist/src/traces/adapters/opentelemetry.d.ts.map +1 -0
  165. package/dist/src/traces/adapters/opentelemetry.js +164 -0
  166. package/dist/src/traces/adapters/opentelemetry.js.map +1 -0
  167. package/dist/src/traces/adapters/sentry.d.ts +58 -0
  168. package/dist/src/traces/adapters/sentry.d.ts.map +1 -0
  169. package/dist/src/traces/adapters/sentry.js +212 -0
  170. package/dist/src/traces/adapters/sentry.js.map +1 -0
  171. package/dist/src/traces/index.d.ts +10 -0
  172. package/dist/src/traces/index.d.ts.map +1 -0
  173. package/dist/src/traces/index.js +45 -0
  174. package/dist/src/traces/index.js.map +1 -0
  175. package/dist/src/traces/storage.d.ts +78 -0
  176. package/dist/src/traces/storage.d.ts.map +1 -0
  177. package/dist/src/traces/storage.js +399 -0
  178. package/dist/src/traces/storage.js.map +1 -0
  179. package/dist/src/traces/summarizer.d.ts +83 -0
  180. package/dist/src/traces/summarizer.d.ts.map +1 -0
  181. package/dist/src/traces/summarizer.js +247 -0
  182. package/dist/src/traces/summarizer.js.map +1 -0
  183. package/dist/src/traces/types.d.ts +365 -0
  184. package/dist/src/traces/types.d.ts.map +1 -0
  185. package/dist/src/traces/types.js +14 -0
  186. package/dist/src/traces/types.js.map +1 -0
  187. package/dist/src/types.d.ts +495 -0
  188. package/dist/src/types.d.ts.map +1 -0
  189. package/dist/src/types.js +27 -0
  190. package/dist/src/types.js.map +1 -0
  191. package/docs/agent-surface-policy.md +45 -0
  192. package/docs/memory-setup.md +226 -0
  193. package/hooks/_arch_scan_bg.py +88 -0
  194. package/hooks/_plugin_drift_check_bg.py +85 -0
  195. package/hooks/_session_start_lib.sh +42 -0
  196. package/hooks/git/pre-push +141 -0
  197. package/hooks/hooks.json +126 -0
  198. package/hooks/post-commit +30 -0
  199. package/hooks/pre-commit +29 -0
  200. package/hooks/pre-edit-apppulse.sh +6 -0
  201. package/hooks/pre-edit-architecture.sh +106 -0
  202. package/hooks/pre-edit-rally-point.sh +92 -0
  203. package/hooks/session-start-apppulse.sh +6 -0
  204. package/hooks/session-start-architecture.sh +10 -0
  205. package/hooks/session-start-git-hooks.sh +12 -0
  206. package/hooks/session-start-plugin-drift.sh +27 -0
  207. package/hooks/session-start-rally-point.sh +44 -0
  208. package/hooks/session-start-retrieval.sh +24 -0
  209. package/hooks/session-start-worktree-gc.sh +105 -0
  210. package/hooks/test_apppulse_hooks.sh +6 -0
  211. package/hooks/test_rally_point_hooks.sh +388 -0
  212. package/hooks/test_sec008_hooks.sh +66 -0
  213. package/package.json +111 -0
  214. package/scripts/README.md +301 -0
  215. package/scripts/_db_url.py +61 -0
  216. package/scripts/_paths.py +445 -0
  217. package/scripts/blm.py +162 -0
  218. package/scripts/blm_api.py +263 -0
  219. package/scripts/check_cache_sync.py +490 -0
  220. package/scripts/embed_backend.py +475 -0
  221. package/scripts/install_memory.py +556 -0
  222. package/scripts/lessons_index/__init__.py +77 -0
  223. package/scripts/lessons_index/__main__.py +135 -0
  224. package/scripts/lessons_index/ingest.py +288 -0
  225. package/scripts/lessons_index/query.py +285 -0
  226. package/scripts/lessons_index/schema.py +114 -0
  227. package/scripts/memory_context/__init__.py +610 -0
  228. package/scripts/memory_graph/__init__.py +393 -0
  229. package/scripts/project_resolver.py +172 -0
  230. package/scripts/prune_codex_plugin_cache.py +23 -0
  231. package/scripts/prune_plugin_cache.py +359 -0
  232. package/scripts/semantic_index/__init__.py +482 -0
  233. package/scripts/semantic_index/_bench_hybrid.py +175 -0
  234. package/scripts/semantic_index/backfill.py +263 -0
  235. package/scripts/semantic_index/hybrid.py +174 -0
  236. package/scripts/semantic_index/test_backfill.py +292 -0
  237. package/scripts/semantic_index/test_hybrid.py +541 -0
  238. package/scripts/sync_navgator_lessons.py +666 -0
  239. package/scripts/sync_plugin_cache.py +388 -0
  240. package/skills/agent-rally-point/SKILL.md +165 -0
  241. package/skills/agent-rally-watcher/SKILL.md +83 -0
  242. package/skills/api-registry-bridge/SKILL.md +59 -0
  243. package/skills/architecture/dead/SKILL.md +56 -0
  244. package/skills/architecture/impact/SKILL.md +88 -0
  245. package/skills/architecture/review/SKILL.md +227 -0
  246. package/skills/architecture/rules/SKILL.md +72 -0
  247. package/skills/architecture/scan/SKILL.md +79 -0
  248. package/skills/architecture/trace/SKILL.md +65 -0
  249. package/skills/attribution-standard/SKILL.md +122 -0
  250. package/skills/authentication/SKILL.md +81 -0
  251. package/skills/authentication/references/better-auth-magic-link.md +135 -0
  252. package/skills/authentication/references/better-auth-setup.md +224 -0
  253. package/skills/authentication/references/google-calendar-sync.md +278 -0
  254. package/skills/authentication/references/google-cloud-console.md +159 -0
  255. package/skills/authentication/references/google-geocoding-directions.md +126 -0
  256. package/skills/authentication/references/google-lessons-example-web-app.md +177 -0
  257. package/skills/authentication/references/google-maps.md +162 -0
  258. package/skills/authentication/references/google-oauth-setup.md +343 -0
  259. package/skills/authentication/references/google-places.md +173 -0
  260. package/skills/authentication/references/lessons-example-web-app-better-auth.md +126 -0
  261. package/skills/authentication/references/resend-email.md +227 -0
  262. package/skills/authentication/references/resend-otp-magic-link.md +153 -0
  263. package/skills/authentication/references/supabase-auth.md +172 -0
  264. package/skills/auto-decision-capture/SKILL.md +419 -0
  265. package/skills/build-loop/SKILL.md +516 -0
  266. package/skills/build-loop/detect-plugins.mjs +82 -0
  267. package/skills/build-loop/eval-guide.md +65 -0
  268. package/skills/build-loop/fallbacks.md +549 -0
  269. package/skills/build-loop/phases/fact-check.md +42 -0
  270. package/skills/build-loop/phases/ui-validation.md +267 -0
  271. package/skills/build-loop/references/apple-native-planning.md +439 -0
  272. package/skills/build-loop/references/capability-routing.md +181 -0
  273. package/skills/build-loop/references/codex-subagents.md +98 -0
  274. package/skills/build-loop/references/coordination.md +161 -0
  275. package/skills/build-loop/references/correction-aware-capture.md +177 -0
  276. package/skills/build-loop/references/independent-auditor.md +72 -0
  277. package/skills/build-loop/references/intent-capability-pack.md +170 -0
  278. package/skills/build-loop/references/intent-exploration-prompts.md +96 -0
  279. package/skills/build-loop/references/leadership.md +72 -0
  280. package/skills/build-loop/references/memory.md +284 -0
  281. package/skills/build-loop/references/modular-systems-pack.md +96 -0
  282. package/skills/build-loop/references/output-style.md +129 -0
  283. package/skills/build-loop/references/pay-it-forward-arch.md +98 -0
  284. package/skills/build-loop/references/phase-1-assess.md +218 -0
  285. package/skills/build-loop/references/phase-2-plan.md +77 -0
  286. package/skills/build-loop/references/phase-3-execute.md +47 -0
  287. package/skills/build-loop/references/phase-4-review.md +310 -0
  288. package/skills/build-loop/references/phase-5-iterate.md +71 -0
  289. package/skills/build-loop/references/phase-6-learn.md +56 -0
  290. package/skills/build-loop/references/recent-design-structures.md +274 -0
  291. package/skills/build-loop/references/refactor-history/ASSESSMENT.md +85 -0
  292. package/skills/build-loop/references/refactor-history/STANDALONE_TEST_RUN.md +149 -0
  293. package/skills/build-loop/references/refactor-history/scenarios/01-simple-bugfix.md +32 -0
  294. package/skills/build-loop/references/refactor-history/scenarios/02-ui-build-with-iteration.md +48 -0
  295. package/skills/build-loop/references/refactor-history/scenarios/03-multi-failure-escalation.md +60 -0
  296. package/skills/build-loop/references/refactor-history/scenarios/04-ui-build-ibr-absent.md +51 -0
  297. package/skills/build-loop/references/refactor-history/scenarios/05-refactor-navgator-absent.md +71 -0
  298. package/skills/build-loop/references/refactor-history/scenarios/06-recurring-bug-debugger-absent.md +52 -0
  299. package/skills/build-loop/references/refactor-history/trace-comparison.md +202 -0
  300. package/skills/build-loop/references/self-recursive-dev.md +77 -0
  301. package/skills/build-loop/references/self-review.md +232 -0
  302. package/skills/build-loop/references/ui-io-contract.md +116 -0
  303. package/skills/build-loop/scanners/audit-design-rules.mjs +476 -0
  304. package/skills/build-loop/scanners/require-visual-evidence.mjs +239 -0
  305. package/skills/build-loop/templates/backlog-item.md +35 -0
  306. package/skills/build-loop/templates/codex-worker-prompt.md +89 -0
  307. package/skills/build-loop/templates/ui-subagent-prompt.md +179 -0
  308. package/skills/build-loop/templates/ux-fix-plan.md +40 -0
  309. package/skills/building-with-deepagents/SKILL.md +195 -0
  310. package/skills/building-with-deepagents/references/anti-patterns.md +141 -0
  311. package/skills/building-with-deepagents/references/api-quick-reference.md +184 -0
  312. package/skills/capabilities/SKILL.md +91 -0
  313. package/skills/debug-loop/SKILL.md +278 -0
  314. package/skills/debug-loop/references/convergence-rules.md +145 -0
  315. package/skills/debug-loop/references/swiftui-macos-clunky-ui-debugger.html +823 -0
  316. package/skills/debugging/assess/SKILL.md +111 -0
  317. package/skills/debugging/debug-loop/SKILL.md +231 -0
  318. package/skills/debugging/memory/SKILL.md +147 -0
  319. package/skills/debugging/store/SKILL.md +153 -0
  320. package/skills/debugging-memory/SKILL.md +440 -0
  321. package/skills/debugging-memory/examples/incident-example.json +67 -0
  322. package/skills/debugging-memory/references/incident-documentation.md +280 -0
  323. package/skills/debugging-memory/references/ios-notification-alarm-playbook.md +300 -0
  324. package/skills/debugging-memory/references/pattern-extraction.md +163 -0
  325. package/skills/debugging-memory/references/subagent-integration.md +312 -0
  326. package/skills/defenseclaw-bridge/SKILL.md +156 -0
  327. package/skills/defenseclaw-bridge/references/dc-config-mapping.md +162 -0
  328. package/skills/defenseclaw-bridge/references/output-format.md +108 -0
  329. package/skills/handoff/SKILL.md +94 -0
  330. package/skills/ibr-bridge/SKILL.md +68 -0
  331. package/skills/knowledge/SKILL.md +127 -0
  332. package/skills/knowledge/references/recall-integration.md +83 -0
  333. package/skills/knowledge/templates/madr-minimal.md +56 -0
  334. package/skills/knowledge-review/SKILL.md +112 -0
  335. package/skills/logging-tracer/SKILL.md +202 -0
  336. package/skills/logging-tracer/references/log-analysis.md +128 -0
  337. package/skills/logging-tracer/references/stack-templates.md +274 -0
  338. package/skills/logging-tracer-bridge/SKILL.md +70 -0
  339. package/skills/mcp-builder/SKILL.md +278 -0
  340. package/skills/mcp-builder/references/mcp-security.md +106 -0
  341. package/skills/model-tiering/SKILL.md +216 -0
  342. package/skills/native-ax-driver/SKILL.md +220 -0
  343. package/skills/native-ax-driver/scripts/layout_fill.py +222 -0
  344. package/skills/native-ax-driver/scripts/native_driver.py +495 -0
  345. package/skills/native-ax-driver/swift/bl-ax-driver/Package.swift +20 -0
  346. package/skills/native-ax-driver/swift/bl-ax-driver/Sources/main.swift +542 -0
  347. package/skills/optimize/SKILL.md +202 -0
  348. package/skills/optimize/profiles.md +61 -0
  349. package/skills/plan-verify/SKILL.md +115 -0
  350. package/skills/plan-verify/test-fixtures/example-app-v20-findings.json +27 -0
  351. package/skills/plan-verify/test-fixtures/example-app-v20.md +42 -0
  352. package/skills/plan-verify/test-fixtures/example-app-v22-findings.json +15 -0
  353. package/skills/plan-verify/test-fixtures/example-app-v22.md +1608 -0
  354. package/skills/plan-verify/test-fixtures/unrelated-good-plan-findings.json +15 -0
  355. package/skills/plan-verify/test-fixtures/unrelated-good-plan.md +55 -0
  356. package/skills/plugin-builder/SKILL.md +329 -0
  357. package/skills/plugin-builder/references/authoritative-sources.md +104 -0
  358. package/skills/plugin-builder/references/build-loop-phase-guidance.md +94 -0
  359. package/skills/plugin-builder/references/components-guide.md +221 -0
  360. package/skills/plugin-builder/references/distribution.md +317 -0
  361. package/skills/plugin-builder/references/dual-host-claude-codex.md +220 -0
  362. package/skills/plugin-builder/references/hooks-reference.md +210 -0
  363. package/skills/plugin-builder/references/manifest-schema.md +111 -0
  364. package/skills/plugin-builder/references/plugin-hygiene-lessons.md +307 -0
  365. package/skills/plugin-tests/SKILL.md +94 -0
  366. package/skills/prd-bridge/SKILL.md +135 -0
  367. package/skills/research/SKILL.md +80 -0
  368. package/skills/security-methodology/SKILL.md +105 -0
  369. package/skills/security-methodology/references/cross-source-matrix.md +77 -0
  370. package/skills/security-methodology/references/mitre-atlas-starter.md +83 -0
  371. package/skills/security-methodology/references/nist-600-1-mapping.md +119 -0
  372. package/skills/security-methodology/references/owasp-agentic-top-10.md +157 -0
  373. package/skills/security-methodology/references/owasp-llm-top-10.md +144 -0
  374. package/skills/security-methodology/references/owasp-web-top-10.md +65 -0
  375. package/skills/self-improve/SKILL.md +298 -0
  376. package/skills/spec-writing/SKILL.md +548 -0
  377. package/skills/spec-writing/scripts/check_checklist.py +478 -0
  378. package/skills/sync-skills/SKILL.md +132 -0
  379. package/skills/telemetry/SKILL.md +66 -0
  380. package/skills/ui-design/SKILL.md +75 -0
  381. package/skills/ui-design/references/design-patterns-multi.md +165 -0
  382. package/skills/ui-design/references/design-preferences-from-owned-apps.md +150 -0
  383. package/skills/ui-design/references/evidence-capture-policy.md +55 -0
  384. package/skills/ui-design/references/ui-guidance-sources.md +330 -0
  385. package/skills/ui-design/references/universal-design-principles.alt.md +182 -0
  386. package/skills/ui-design/references/universal-design-principles.md +419 -0
  387. package/templates/memory/MEMORY.md.template +55 -0
  388. package/templates/memory/constitution.md.template +64 -0
  389. package/templates/memory/manifest.json +47 -0
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Langchain Adapter
3
+ *
4
+ * Parses LangSmith run format into unified traces.
5
+ */
6
+ import type { TraceAdapter, TraceSource, UnifiedTrace, TraceSummary, LangSmithRun } from '../types';
7
+ export declare class LangchainAdapter implements TraceAdapter<LangSmithRun[]> {
8
+ readonly source: TraceSource;
9
+ /**
10
+ * Validate if input is LangSmith run format
11
+ */
12
+ validate(input: unknown): input is LangSmithRun[];
13
+ /**
14
+ * Parse LangSmith runs into unified traces
15
+ */
16
+ parse(input: LangSmithRun[]): Promise<UnifiedTrace[]>;
17
+ /**
18
+ * Convert single LangSmith run to unified trace
19
+ */
20
+ private convertRun;
21
+ /**
22
+ * Create summary from trace
23
+ */
24
+ summarize(trace: UnifiedTrace, rawData: LangSmithRun[]): TraceSummary;
25
+ /**
26
+ * Build run summary
27
+ */
28
+ private buildRunSummary;
29
+ /**
30
+ * Store full data for lazy loading
31
+ */
32
+ storeFullData(trace: UnifiedTrace, rawData: LangSmithRun[]): Promise<string>;
33
+ /**
34
+ * Map run type to trace category
35
+ */
36
+ private mapRunType;
37
+ /**
38
+ * Identify performance bottleneck
39
+ */
40
+ private identifyBottleneck;
41
+ }
42
+ //# sourceMappingURL=langchain.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../../../src/traces/adapters/langchain.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAGX,YAAY,EACZ,YAAY,EAEZ,YAAY,EACb,MAAM,UAAU,CAAC;AAIlB,qBAAa,gBAAiB,YAAW,YAAY,CAAC,YAAY,EAAE,CAAC;IACnE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAe;IAE3C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,EAAE;IAcjD;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI3D;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY;IAIrE;;OAEG;IACH,OAAO,CAAC,eAAe;IA8CvB;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC;IAKlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAiBlB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAe3B"}
@@ -0,0 +1,151 @@
1
+ "use strict";
2
+ // SPDX-FileCopyrightText: 2025-2026 Tyrone Ross, Jr <46267523+tyroneross@users.noreply.github.com>
3
+ // SPDX-License-Identifier: Apache-2.0
4
+ /**
5
+ * Langchain Adapter
6
+ *
7
+ * Parses LangSmith run format into unified traces.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.LangchainAdapter = void 0;
11
+ const storage_1 = require("../storage");
12
+ const summarizer_1 = require("../summarizer");
13
+ class LangchainAdapter {
14
+ constructor() {
15
+ this.source = 'langchain';
16
+ }
17
+ /**
18
+ * Validate if input is LangSmith run format
19
+ */
20
+ validate(input) {
21
+ if (!Array.isArray(input))
22
+ return false;
23
+ if (input.length === 0)
24
+ return true; // Empty array is valid
25
+ const first = input[0];
26
+ return (typeof first === 'object' &&
27
+ first !== null &&
28
+ typeof first.id === 'string' &&
29
+ typeof first.name === 'string' &&
30
+ typeof first.run_type === 'string');
31
+ }
32
+ /**
33
+ * Parse LangSmith runs into unified traces
34
+ */
35
+ async parse(input) {
36
+ return input.map((run) => this.convertRun(run));
37
+ }
38
+ /**
39
+ * Convert single LangSmith run to unified trace
40
+ */
41
+ convertRun(run) {
42
+ const startTime = new Date(run.start_time).getTime();
43
+ const endTime = run.end_time ? new Date(run.end_time).getTime() : undefined;
44
+ const durationMs = endTime ? endTime - startTime : undefined;
45
+ return {
46
+ trace_id: (0, storage_1.generateTraceId)(),
47
+ source: 'langchain',
48
+ external_id: run.id,
49
+ timestamp: startTime,
50
+ duration_ms: durationMs,
51
+ severity: run.status === 'error' ? 'error' : 'info',
52
+ category: this.mapRunType(run.run_type),
53
+ operation: run.name,
54
+ summary: this.buildRunSummary(run, durationMs),
55
+ has_full_data: true,
56
+ tokens_estimated: 60,
57
+ };
58
+ }
59
+ /**
60
+ * Create summary from trace
61
+ */
62
+ summarize(trace, rawData) {
63
+ return trace.summary;
64
+ }
65
+ /**
66
+ * Build run summary
67
+ */
68
+ buildRunSummary(run, durationMs) {
69
+ const highlights = [];
70
+ // Add model info
71
+ if (run.extra?.runtime?.model) {
72
+ highlights.push({ label: 'model', value: run.extra.runtime.model });
73
+ }
74
+ if (run.extra?.runtime?.provider) {
75
+ highlights.push({ label: 'provider', value: run.extra.runtime.provider });
76
+ }
77
+ // Add token usage
78
+ if (run.token_usage?.total_tokens) {
79
+ highlights.push({
80
+ label: 'tokens',
81
+ value: String(run.token_usage.total_tokens),
82
+ });
83
+ }
84
+ // Add run type
85
+ highlights.push({ label: 'type', value: run.run_type });
86
+ // Build description
87
+ let description = `${run.run_type}: ${run.name}`;
88
+ if (run.extra?.runtime?.model) {
89
+ description = `${run.run_type}[${run.extra.runtime.model}]: ${run.name}`;
90
+ }
91
+ return (0, summarizer_1.createTraceSummary)(run.name, description, {
92
+ highlights: highlights.slice(0, 5),
93
+ error: run.error
94
+ ? {
95
+ type: 'LangChainError',
96
+ message: run.error.substring(0, 200),
97
+ }
98
+ : undefined,
99
+ performance: durationMs
100
+ ? {
101
+ duration_ms: durationMs,
102
+ is_slow: durationMs > 10000, // > 10 seconds is slow for LLM calls
103
+ bottleneck: this.identifyBottleneck(run, durationMs),
104
+ }
105
+ : undefined,
106
+ });
107
+ }
108
+ /**
109
+ * Store full data for lazy loading
110
+ */
111
+ async storeFullData(trace, rawData) {
112
+ const result = await (0, storage_1.storeTrace)(trace, rawData);
113
+ return result.file_path;
114
+ }
115
+ /**
116
+ * Map run type to trace category
117
+ */
118
+ mapRunType(runType) {
119
+ switch (runType) {
120
+ case 'llm':
121
+ return 'llm-call';
122
+ case 'chain':
123
+ return 'llm-chain';
124
+ case 'tool':
125
+ return 'custom';
126
+ case 'retriever':
127
+ return 'database-query';
128
+ case 'embedding':
129
+ return 'llm-call';
130
+ default:
131
+ return 'custom';
132
+ }
133
+ }
134
+ /**
135
+ * Identify performance bottleneck
136
+ */
137
+ identifyBottleneck(run, durationMs) {
138
+ if (durationMs > 30000) {
139
+ return 'Extremely slow LLM response';
140
+ }
141
+ if (durationMs > 15000 && run.run_type === 'llm') {
142
+ return 'Slow LLM inference';
143
+ }
144
+ if (run.token_usage && run.token_usage.total_tokens && run.token_usage.total_tokens > 10000) {
145
+ return 'High token usage';
146
+ }
147
+ return undefined;
148
+ }
149
+ }
150
+ exports.LangchainAdapter = LangchainAdapter;
151
+ //# sourceMappingURL=langchain.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"langchain.js","sourceRoot":"","sources":["../../../../src/traces/adapters/langchain.ts"],"names":[],"mappings":";AAAA,mGAAmG;AACnG,sCAAsC;AACtC;;;;GAIG;;;AAYH,wCAAyD;AACzD,8CAAmD;AAEnD,MAAa,gBAAgB;IAA7B;QACW,WAAM,GAAgB,WAAW,CAAC;IA0J7C,CAAC;IAxJC;;OAEG;IACH,QAAQ,CAAC,KAAc;QACrB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,uBAAuB;QAE5D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;YAC5B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC9B,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CACnC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,KAAqB;QAC/B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,GAAiB;QAClC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAE7D,OAAO;YACL,QAAQ,EAAE,IAAA,yBAAe,GAAE;YAC3B,MAAM,EAAE,WAAW;YACnB,WAAW,EAAE,GAAG,CAAC,EAAE;YACnB,SAAS,EAAE,SAAS;YACpB,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,GAAG,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;YACnD,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC;YACvC,SAAS,EAAE,GAAG,CAAC,IAAI;YACnB,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC;YAC9C,aAAa,EAAE,IAAI;YACnB,gBAAgB,EAAE,EAAE;SACrB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAmB,EAAE,OAAuB;QACpD,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,GAAiB,EAAE,UAAmB;QAC5D,MAAM,UAAU,GAAqB,EAAE,CAAC;QAExC,iBAAiB;QACjB,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC9B,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;YACjC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,kBAAkB;QAClB,IAAI,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC;YAClC,UAAU,CAAC,IAAI,CAAC;gBACd,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;QAED,eAAe;QACf,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAExD,oBAAoB;QACpB,IAAI,WAAW,GAAG,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC9B,WAAW,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3E,CAAC;QAED,OAAO,IAAA,+BAAkB,EAAC,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE;YAC/C,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YAClC,KAAK,EAAE,GAAG,CAAC,KAAK;gBACd,CAAC,CAAC;oBACE,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;iBACrC;gBACH,CAAC,CAAC,SAAS;YACb,WAAW,EAAE,UAAU;gBACrB,CAAC,CAAC;oBACE,WAAW,EAAE,UAAU;oBACvB,OAAO,EAAE,UAAU,GAAG,KAAK,EAAE,qCAAqC;oBAClE,UAAU,EAAE,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,UAAU,CAAC;iBACrD;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,KAAmB,EACnB,OAAuB;QAEvB,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAU,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,OAAiC;QAClD,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,KAAK;gBACR,OAAO,UAAU,CAAC;YACpB,KAAK,OAAO;gBACV,OAAO,WAAW,CAAC;YACrB,KAAK,MAAM;gBACT,OAAO,QAAQ,CAAC;YAClB,KAAK,WAAW;gBACd,OAAO,gBAAgB,CAAC;YAC1B,KAAK,WAAW;gBACd,OAAO,UAAU,CAAC;YACpB;gBACE,OAAO,QAAQ,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB,CACxB,GAAiB,EACjB,UAAkB;QAElB,IAAI,UAAU,GAAG,KAAK,EAAE,CAAC;YACvB,OAAO,6BAA6B,CAAC;QACvC,CAAC;QACD,IAAI,UAAU,GAAG,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YACjD,OAAO,oBAAoB,CAAC;QAC9B,CAAC;QACD,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC,YAAY,IAAI,GAAG,CAAC,WAAW,CAAC,YAAY,GAAG,KAAK,EAAE,CAAC;YAC5F,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AA3JD,4CA2JC"}
@@ -0,0 +1,46 @@
1
+ /**
2
+ * OpenTelemetry Adapter
3
+ *
4
+ * Parses OTLP JSON format traces into unified format.
5
+ */
6
+ import type { TraceAdapter, TraceSource, UnifiedTrace, TraceSummary, OTLPTrace } from '../types';
7
+ export declare class OpenTelemetryAdapter implements TraceAdapter<OTLPTrace> {
8
+ readonly source: TraceSource;
9
+ /**
10
+ * Validate if input is OTLP format
11
+ */
12
+ validate(input: unknown): input is OTLPTrace;
13
+ /**
14
+ * Parse OTLP trace into unified traces
15
+ */
16
+ parse(input: OTLPTrace): Promise<UnifiedTrace[]>;
17
+ /**
18
+ * Convert single OTLP span to unified trace
19
+ */
20
+ private convertSpan;
21
+ /**
22
+ * Create summary for span
23
+ */
24
+ summarize(trace: UnifiedTrace, rawData: OTLPTrace): TraceSummary;
25
+ /**
26
+ * Summarize a single span
27
+ */
28
+ private summarizeSpan;
29
+ /**
30
+ * Store full data for lazy loading
31
+ */
32
+ storeFullData(trace: UnifiedTrace, rawData: OTLPTrace): Promise<string>;
33
+ /**
34
+ * Infer category from span attributes
35
+ */
36
+ private inferCategory;
37
+ /**
38
+ * Extract attribute value from OTLP attributes
39
+ */
40
+ private extractAttribute;
41
+ /**
42
+ * Truncate URL for display
43
+ */
44
+ private truncateUrl;
45
+ }
46
+ //# sourceMappingURL=opentelemetry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../../../../src/traces/adapters/opentelemetry.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAGX,YAAY,EACZ,YAAY,EAEZ,SAAS,EAGV,MAAM,UAAU,CAAC;AAIlB,qBAAa,oBAAqB,YAAW,YAAY,CAAC,SAAS,CAAC;IAClE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAmB;IAE/C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS;IAM5C;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmBtD;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,GAAG,YAAY;IAIhE;;OAEG;IACH,OAAO,CAAC,aAAa;IA8CrB;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7E;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,WAAW;CASpB"}
@@ -0,0 +1,164 @@
1
+ "use strict";
2
+ // SPDX-FileCopyrightText: 2025-2026 Tyrone Ross, Jr <46267523+tyroneross@users.noreply.github.com>
3
+ // SPDX-License-Identifier: Apache-2.0
4
+ /**
5
+ * OpenTelemetry Adapter
6
+ *
7
+ * Parses OTLP JSON format traces into unified format.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.OpenTelemetryAdapter = void 0;
11
+ const storage_1 = require("../storage");
12
+ const summarizer_1 = require("../summarizer");
13
+ class OpenTelemetryAdapter {
14
+ constructor() {
15
+ this.source = 'opentelemetry';
16
+ }
17
+ /**
18
+ * Validate if input is OTLP format
19
+ */
20
+ validate(input) {
21
+ if (!input || typeof input !== 'object')
22
+ return false;
23
+ const obj = input;
24
+ return Array.isArray(obj.resourceSpans);
25
+ }
26
+ /**
27
+ * Parse OTLP trace into unified traces
28
+ */
29
+ async parse(input) {
30
+ const traces = [];
31
+ for (const resourceSpan of input.resourceSpans) {
32
+ const serviceName = this.extractAttribute(resourceSpan.resource?.attributes || [], 'service.name');
33
+ for (const scopeSpan of resourceSpan.scopeSpans || []) {
34
+ for (const span of scopeSpan.spans || []) {
35
+ traces.push(this.convertSpan(span, serviceName));
36
+ }
37
+ }
38
+ }
39
+ return traces;
40
+ }
41
+ /**
42
+ * Convert single OTLP span to unified trace
43
+ */
44
+ convertSpan(span, serviceName) {
45
+ const startNano = BigInt(span.startTimeUnixNano);
46
+ const endNano = BigInt(span.endTimeUnixNano);
47
+ const durationMs = Number((endNano - startNano) / BigInt(1000000));
48
+ const hasError = span.status?.code === 2;
49
+ const severity = hasError ? 'error' : 'info';
50
+ return {
51
+ trace_id: (0, storage_1.generateTraceId)(),
52
+ source: 'opentelemetry',
53
+ external_id: span.traceId,
54
+ timestamp: Number(startNano / BigInt(1000000)),
55
+ duration_ms: durationMs,
56
+ severity,
57
+ category: this.inferCategory(span),
58
+ operation: span.name,
59
+ summary: this.summarizeSpan(span, serviceName, durationMs, hasError),
60
+ has_full_data: true,
61
+ tokens_estimated: 50,
62
+ };
63
+ }
64
+ /**
65
+ * Create summary for span
66
+ */
67
+ summarize(trace, rawData) {
68
+ return trace.summary;
69
+ }
70
+ /**
71
+ * Summarize a single span
72
+ */
73
+ summarizeSpan(span, serviceName, durationMs, hasError) {
74
+ const highlights = [];
75
+ // Add service name if available
76
+ if (serviceName) {
77
+ highlights.push({ label: 'service', value: serviceName });
78
+ }
79
+ // Add HTTP info if available
80
+ const httpMethod = this.extractAttribute(span.attributes || [], 'http.method');
81
+ const httpUrl = this.extractAttribute(span.attributes || [], 'http.url');
82
+ if (httpMethod)
83
+ highlights.push({ label: 'method', value: httpMethod });
84
+ if (httpUrl)
85
+ highlights.push({ label: 'url', value: this.truncateUrl(httpUrl) });
86
+ // Add database info if available
87
+ const dbSystem = this.extractAttribute(span.attributes || [], 'db.system');
88
+ const dbStatement = this.extractAttribute(span.attributes || [], 'db.statement');
89
+ if (dbSystem)
90
+ highlights.push({ label: 'database', value: dbSystem });
91
+ if (dbStatement)
92
+ highlights.push({ label: 'query', value: dbStatement.substring(0, 50) });
93
+ // Build description
94
+ let description = span.name;
95
+ if (httpMethod && httpUrl) {
96
+ description = `${httpMethod} ${this.truncateUrl(httpUrl)}`;
97
+ }
98
+ else if (dbStatement) {
99
+ description = `DB: ${dbStatement.substring(0, 80)}`;
100
+ }
101
+ return (0, summarizer_1.createTraceSummary)(span.name, description, {
102
+ highlights: highlights.slice(0, 5),
103
+ error: hasError && span.status?.message
104
+ ? { type: 'SpanError', message: span.status.message }
105
+ : undefined,
106
+ performance: {
107
+ duration_ms: durationMs,
108
+ is_slow: durationMs > 1000, // > 1 second is slow
109
+ bottleneck: durationMs > 5000 ? 'Very slow operation' : undefined,
110
+ },
111
+ });
112
+ }
113
+ /**
114
+ * Store full data for lazy loading
115
+ */
116
+ async storeFullData(trace, rawData) {
117
+ const result = await (0, storage_1.storeTrace)(trace, rawData);
118
+ return result.file_path;
119
+ }
120
+ /**
121
+ * Infer category from span attributes
122
+ */
123
+ inferCategory(span) {
124
+ const name = span.name.toLowerCase();
125
+ const attributes = span.attributes || [];
126
+ const httpMethod = this.extractAttribute(attributes, 'http.method');
127
+ if (httpMethod)
128
+ return 'http-request';
129
+ const dbSystem = this.extractAttribute(attributes, 'db.system');
130
+ if (dbSystem)
131
+ return 'database-query';
132
+ if (name.includes('cache') || name.includes('redis'))
133
+ return 'cache-operation';
134
+ if (name.includes('llm') || name.includes('openai'))
135
+ return 'llm-call';
136
+ return 'custom';
137
+ }
138
+ /**
139
+ * Extract attribute value from OTLP attributes
140
+ */
141
+ extractAttribute(attributes, key) {
142
+ const attr = attributes.find((a) => a.key === key);
143
+ if (!attr)
144
+ return undefined;
145
+ const value = attr.value;
146
+ return value.stringValue || value.intValue?.toString() || undefined;
147
+ }
148
+ /**
149
+ * Truncate URL for display
150
+ */
151
+ truncateUrl(url) {
152
+ if (url.length <= 60)
153
+ return url;
154
+ try {
155
+ const parsed = new URL(url);
156
+ return `${parsed.pathname}${parsed.search ? '?...' : ''}`;
157
+ }
158
+ catch {
159
+ return url.substring(0, 60) + '...';
160
+ }
161
+ }
162
+ }
163
+ exports.OpenTelemetryAdapter = OpenTelemetryAdapter;
164
+ //# sourceMappingURL=opentelemetry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"opentelemetry.js","sourceRoot":"","sources":["../../../../src/traces/adapters/opentelemetry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Sentry Adapter
3
+ *
4
+ * Parses Sentry error events and breadcrumbs into unified format.
5
+ */
6
+ import type { TraceAdapter, TraceSource, UnifiedTrace, TraceSummary, SentryEvent } from '../types';
7
+ export declare class SentryAdapter implements TraceAdapter<SentryEvent> {
8
+ readonly source: TraceSource;
9
+ /**
10
+ * Validate if input is Sentry event format
11
+ */
12
+ validate(input: unknown): input is SentryEvent;
13
+ /**
14
+ * Parse Sentry event into unified traces
15
+ */
16
+ parse(input: SentryEvent): Promise<UnifiedTrace[]>;
17
+ /**
18
+ * Convert Sentry event to unified trace
19
+ */
20
+ private convertEvent;
21
+ /**
22
+ * Convert breadcrumb to unified trace
23
+ */
24
+ private convertBreadcrumb;
25
+ /**
26
+ * Create summary from trace
27
+ */
28
+ summarize(trace: UnifiedTrace, rawData: SentryEvent): TraceSummary;
29
+ /**
30
+ * Build event summary
31
+ */
32
+ private buildEventSummary;
33
+ /**
34
+ * Build breadcrumb highlights
35
+ */
36
+ private buildBreadcrumbHighlights;
37
+ /**
38
+ * Extract stack preview from stacktrace
39
+ */
40
+ private extractStackPreview;
41
+ /**
42
+ * Store full data for lazy loading
43
+ */
44
+ storeFullData(trace: UnifiedTrace, rawData: SentryEvent): Promise<string>;
45
+ /**
46
+ * Map Sentry level to trace severity
47
+ */
48
+ private mapSeverity;
49
+ /**
50
+ * Map breadcrumb type to severity
51
+ */
52
+ private mapBreadcrumbSeverity;
53
+ /**
54
+ * Map breadcrumb category to trace category
55
+ */
56
+ private mapBreadcrumbCategory;
57
+ }
58
+ //# sourceMappingURL=sentry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sentry.d.ts","sourceRoot":"","sources":["../../../../src/traces/adapters/sentry.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAGX,YAAY,EACZ,YAAY,EAEZ,WAAW,EACZ,MAAM,UAAU,CAAC;AAIlB,qBAAa,aAAc,YAAW,YAAY,CAAC,WAAW,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAY;IAExC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW;IAU9C;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgBxD;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,YAAY;IAIlE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+CzB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAqBjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/E;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAQ9B"}