@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,212 @@
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
+ * Sentry Adapter
6
+ *
7
+ * Parses Sentry error events and breadcrumbs into unified format.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.SentryAdapter = void 0;
11
+ const storage_1 = require("../storage");
12
+ const summarizer_1 = require("../summarizer");
13
+ class SentryAdapter {
14
+ constructor() {
15
+ this.source = 'sentry';
16
+ }
17
+ /**
18
+ * Validate if input is Sentry event format
19
+ */
20
+ validate(input) {
21
+ if (!input || typeof input !== 'object')
22
+ return false;
23
+ const obj = input;
24
+ return (typeof obj.event_id === 'string' &&
25
+ typeof obj.timestamp === 'string' &&
26
+ (obj.exception !== undefined || obj.level !== undefined));
27
+ }
28
+ /**
29
+ * Parse Sentry event into unified traces
30
+ */
31
+ async parse(input) {
32
+ const traces = [];
33
+ // Main error event
34
+ traces.push(this.convertEvent(input));
35
+ // Breadcrumbs as supporting traces
36
+ if (input.breadcrumbs?.values) {
37
+ for (const crumb of input.breadcrumbs.values) {
38
+ traces.push(this.convertBreadcrumb(crumb, input.event_id));
39
+ }
40
+ }
41
+ return traces;
42
+ }
43
+ /**
44
+ * Convert Sentry event to unified trace
45
+ */
46
+ convertEvent(event) {
47
+ const exception = event.exception?.values?.[0];
48
+ const timestamp = new Date(event.timestamp).getTime();
49
+ return {
50
+ trace_id: (0, storage_1.generateTraceId)(),
51
+ source: 'sentry',
52
+ external_id: event.event_id,
53
+ timestamp,
54
+ severity: this.mapSeverity(event.level),
55
+ category: 'console-error',
56
+ operation: event.transaction || exception?.type || 'Error',
57
+ summary: this.buildEventSummary(event),
58
+ has_full_data: true,
59
+ tokens_estimated: 80,
60
+ };
61
+ }
62
+ /**
63
+ * Convert breadcrumb to unified trace
64
+ */
65
+ convertBreadcrumb(crumb, parentEventId) {
66
+ const timestamp = new Date(crumb.timestamp).getTime();
67
+ return {
68
+ trace_id: (0, storage_1.generateTraceId)(),
69
+ source: 'sentry',
70
+ external_id: `${parentEventId}_breadcrumb`,
71
+ timestamp,
72
+ severity: this.mapBreadcrumbSeverity(crumb.type),
73
+ category: this.mapBreadcrumbCategory(crumb.category),
74
+ operation: crumb.category,
75
+ summary: {
76
+ description: crumb.message || `[${crumb.category}] ${crumb.type}`,
77
+ highlights: this.buildBreadcrumbHighlights(crumb),
78
+ },
79
+ has_full_data: false,
80
+ tokens_estimated: 30,
81
+ };
82
+ }
83
+ /**
84
+ * Create summary from trace
85
+ */
86
+ summarize(trace, rawData) {
87
+ return trace.summary;
88
+ }
89
+ /**
90
+ * Build event summary
91
+ */
92
+ buildEventSummary(event) {
93
+ const exception = event.exception?.values?.[0];
94
+ const highlights = [];
95
+ // Add context
96
+ if (event.release) {
97
+ highlights.push({ label: 'release', value: event.release });
98
+ }
99
+ if (event.environment) {
100
+ highlights.push({ label: 'env', value: event.environment });
101
+ }
102
+ if (event.transaction) {
103
+ highlights.push({ label: 'transaction', value: event.transaction });
104
+ }
105
+ // Add tags
106
+ if (event.tags) {
107
+ const tagEntries = Object.entries(event.tags).slice(0, 2);
108
+ for (const [key, value] of tagEntries) {
109
+ highlights.push({ label: key, value });
110
+ }
111
+ }
112
+ // Build description
113
+ let description = 'Error';
114
+ if (exception) {
115
+ description = `${exception.type}: ${exception.value.substring(0, 150)}`;
116
+ }
117
+ else if (event.transaction) {
118
+ description = `Transaction: ${event.transaction}`;
119
+ }
120
+ return (0, summarizer_1.createTraceSummary)(exception?.type || 'Error', description, {
121
+ highlights: highlights.slice(0, 5),
122
+ error: exception
123
+ ? {
124
+ type: exception.type,
125
+ message: exception.value.substring(0, 200),
126
+ stack_preview: this.extractStackPreview(exception.stacktrace),
127
+ }
128
+ : undefined,
129
+ });
130
+ }
131
+ /**
132
+ * Build breadcrumb highlights
133
+ */
134
+ buildBreadcrumbHighlights(crumb) {
135
+ const highlights = [];
136
+ highlights.push({ label: 'type', value: crumb.type });
137
+ highlights.push({ label: 'category', value: crumb.category });
138
+ if (crumb.data) {
139
+ const dataEntries = Object.entries(crumb.data).slice(0, 2);
140
+ for (const [key, value] of dataEntries) {
141
+ highlights.push({
142
+ label: key,
143
+ value: String(value).substring(0, 50),
144
+ });
145
+ }
146
+ }
147
+ return highlights;
148
+ }
149
+ /**
150
+ * Extract stack preview from stacktrace
151
+ */
152
+ extractStackPreview(stacktrace) {
153
+ if (!stacktrace?.frames)
154
+ return undefined;
155
+ // Get last 3 frames (most relevant)
156
+ const relevantFrames = stacktrace.frames.slice(-3).reverse();
157
+ return relevantFrames
158
+ .map((f) => `${f.function || 'anonymous'} (${f.filename}:${f.lineno})`)
159
+ .join('\n');
160
+ }
161
+ /**
162
+ * Store full data for lazy loading
163
+ */
164
+ async storeFullData(trace, rawData) {
165
+ const result = await (0, storage_1.storeTrace)(trace, rawData);
166
+ return result.file_path;
167
+ }
168
+ /**
169
+ * Map Sentry level to trace severity
170
+ */
171
+ mapSeverity(level) {
172
+ switch (level) {
173
+ case 'fatal':
174
+ return 'fatal';
175
+ case 'error':
176
+ return 'error';
177
+ case 'warning':
178
+ return 'warning';
179
+ case 'info':
180
+ return 'info';
181
+ case 'debug':
182
+ return 'debug';
183
+ default:
184
+ return 'info';
185
+ }
186
+ }
187
+ /**
188
+ * Map breadcrumb type to severity
189
+ */
190
+ mapBreadcrumbSeverity(type) {
191
+ if (type === 'error')
192
+ return 'error';
193
+ if (type === 'warning')
194
+ return 'warning';
195
+ return 'info';
196
+ }
197
+ /**
198
+ * Map breadcrumb category to trace category
199
+ */
200
+ mapBreadcrumbCategory(category) {
201
+ if (category === 'http' || category === 'fetch' || category === 'xhr') {
202
+ return 'http-request';
203
+ }
204
+ if (category === 'console')
205
+ return 'console-log';
206
+ if (category === 'navigation' || category === 'ui')
207
+ return 'ui-interaction';
208
+ return 'custom';
209
+ }
210
+ }
211
+ exports.SentryAdapter = SentryAdapter;
212
+ //# sourceMappingURL=sentry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sentry.js","sourceRoot":"","sources":["../../../../src/traces/adapters/sentry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Trace System - Entry Point
3
+ *
4
+ * Exports all trace functionality.
5
+ */
6
+ export type { TraceSource, TraceSeverity, TraceCategory, UnifiedTrace, TraceSummary, TraceHighlight, TraceErrorSummary, TracePerformanceSummary, TraceCollection, CollectionSummary, TraceIndex, TraceIndexEntry, TraceAdapter, SummarizationConfig, CorrelationConfig, TraceCorrelation, OTLPTrace, OTLPSpan, SentryEvent, LangSmithRun, ChromeTrace, PlaywrightTrace, } from './types';
7
+ export { generateTraceId, generateCollectionId, storeTrace, loadTraceSummary, loadFullTrace, loadAllTraces, loadTracesBySource, loadTracesByCategory, loadTracesBySeverity, loadTracesForIncident, loadTraceIndex, createCollection, loadCollection, correlateTraceToIncident, getTraceStats, } from './storage';
8
+ export { TraceSummarizer, createTraceSummary, summarizeTracesCompact, filterByTimeWindow, groupByCategory, getTopErrors, getSlowestOperations, } from './summarizer';
9
+ export { OpenTelemetryAdapter, SentryAdapter, LangchainAdapter, BrowserTraceAdapter, getAdapter, autoParseTraces, } from './adapters';
10
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/traces/index.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAGH,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAEhB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,WAAW,EACX,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,aAAa,GACd,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC"}
@@ -0,0 +1,45 @@
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
+ * Trace System - Entry Point
6
+ *
7
+ * Exports all trace functionality.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.autoParseTraces = exports.getAdapter = exports.BrowserTraceAdapter = exports.LangchainAdapter = exports.SentryAdapter = exports.OpenTelemetryAdapter = exports.getSlowestOperations = exports.getTopErrors = exports.groupByCategory = exports.filterByTimeWindow = exports.summarizeTracesCompact = exports.createTraceSummary = exports.TraceSummarizer = exports.getTraceStats = exports.correlateTraceToIncident = exports.loadCollection = exports.createCollection = exports.loadTraceIndex = exports.loadTracesForIncident = exports.loadTracesBySeverity = exports.loadTracesByCategory = exports.loadTracesBySource = exports.loadAllTraces = exports.loadFullTrace = exports.loadTraceSummary = exports.storeTrace = exports.generateCollectionId = exports.generateTraceId = void 0;
11
+ // Storage
12
+ var storage_1 = require("./storage");
13
+ Object.defineProperty(exports, "generateTraceId", { enumerable: true, get: function () { return storage_1.generateTraceId; } });
14
+ Object.defineProperty(exports, "generateCollectionId", { enumerable: true, get: function () { return storage_1.generateCollectionId; } });
15
+ Object.defineProperty(exports, "storeTrace", { enumerable: true, get: function () { return storage_1.storeTrace; } });
16
+ Object.defineProperty(exports, "loadTraceSummary", { enumerable: true, get: function () { return storage_1.loadTraceSummary; } });
17
+ Object.defineProperty(exports, "loadFullTrace", { enumerable: true, get: function () { return storage_1.loadFullTrace; } });
18
+ Object.defineProperty(exports, "loadAllTraces", { enumerable: true, get: function () { return storage_1.loadAllTraces; } });
19
+ Object.defineProperty(exports, "loadTracesBySource", { enumerable: true, get: function () { return storage_1.loadTracesBySource; } });
20
+ Object.defineProperty(exports, "loadTracesByCategory", { enumerable: true, get: function () { return storage_1.loadTracesByCategory; } });
21
+ Object.defineProperty(exports, "loadTracesBySeverity", { enumerable: true, get: function () { return storage_1.loadTracesBySeverity; } });
22
+ Object.defineProperty(exports, "loadTracesForIncident", { enumerable: true, get: function () { return storage_1.loadTracesForIncident; } });
23
+ Object.defineProperty(exports, "loadTraceIndex", { enumerable: true, get: function () { return storage_1.loadTraceIndex; } });
24
+ Object.defineProperty(exports, "createCollection", { enumerable: true, get: function () { return storage_1.createCollection; } });
25
+ Object.defineProperty(exports, "loadCollection", { enumerable: true, get: function () { return storage_1.loadCollection; } });
26
+ Object.defineProperty(exports, "correlateTraceToIncident", { enumerable: true, get: function () { return storage_1.correlateTraceToIncident; } });
27
+ Object.defineProperty(exports, "getTraceStats", { enumerable: true, get: function () { return storage_1.getTraceStats; } });
28
+ // Summarizer
29
+ var summarizer_1 = require("./summarizer");
30
+ Object.defineProperty(exports, "TraceSummarizer", { enumerable: true, get: function () { return summarizer_1.TraceSummarizer; } });
31
+ Object.defineProperty(exports, "createTraceSummary", { enumerable: true, get: function () { return summarizer_1.createTraceSummary; } });
32
+ Object.defineProperty(exports, "summarizeTracesCompact", { enumerable: true, get: function () { return summarizer_1.summarizeTracesCompact; } });
33
+ Object.defineProperty(exports, "filterByTimeWindow", { enumerable: true, get: function () { return summarizer_1.filterByTimeWindow; } });
34
+ Object.defineProperty(exports, "groupByCategory", { enumerable: true, get: function () { return summarizer_1.groupByCategory; } });
35
+ Object.defineProperty(exports, "getTopErrors", { enumerable: true, get: function () { return summarizer_1.getTopErrors; } });
36
+ Object.defineProperty(exports, "getSlowestOperations", { enumerable: true, get: function () { return summarizer_1.getSlowestOperations; } });
37
+ // Adapters
38
+ var adapters_1 = require("./adapters");
39
+ Object.defineProperty(exports, "OpenTelemetryAdapter", { enumerable: true, get: function () { return adapters_1.OpenTelemetryAdapter; } });
40
+ Object.defineProperty(exports, "SentryAdapter", { enumerable: true, get: function () { return adapters_1.SentryAdapter; } });
41
+ Object.defineProperty(exports, "LangchainAdapter", { enumerable: true, get: function () { return adapters_1.LangchainAdapter; } });
42
+ Object.defineProperty(exports, "BrowserTraceAdapter", { enumerable: true, get: function () { return adapters_1.BrowserTraceAdapter; } });
43
+ Object.defineProperty(exports, "getAdapter", { enumerable: true, get: function () { return adapters_1.getAdapter; } });
44
+ Object.defineProperty(exports, "autoParseTraces", { enumerable: true, get: function () { return adapters_1.autoParseTraces; } });
45
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/traces/index.ts"],"names":[],"mappings":";AAAA,mGAAmG;AACnG,sCAAsC;AACtC;;;;GAIG;;;AA6BH,UAAU;AACV,qCAgBmB;AAfjB,0GAAA,eAAe,OAAA;AACf,+GAAA,oBAAoB,OAAA;AACpB,qGAAA,UAAU,OAAA;AACV,2GAAA,gBAAgB,OAAA;AAChB,wGAAA,aAAa,OAAA;AACb,wGAAA,aAAa,OAAA;AACb,6GAAA,kBAAkB,OAAA;AAClB,+GAAA,oBAAoB,OAAA;AACpB,+GAAA,oBAAoB,OAAA;AACpB,gHAAA,qBAAqB,OAAA;AACrB,yGAAA,cAAc,OAAA;AACd,2GAAA,gBAAgB,OAAA;AAChB,yGAAA,cAAc,OAAA;AACd,mHAAA,wBAAwB,OAAA;AACxB,wGAAA,aAAa,OAAA;AAGf,aAAa;AACb,2CAQsB;AAPpB,6GAAA,eAAe,OAAA;AACf,gHAAA,kBAAkB,OAAA;AAClB,oHAAA,sBAAsB,OAAA;AACtB,gHAAA,kBAAkB,OAAA;AAClB,6GAAA,eAAe,OAAA;AACf,0GAAA,YAAY,OAAA;AACZ,kHAAA,oBAAoB,OAAA;AAGtB,WAAW;AACX,uCAOoB;AANlB,gHAAA,oBAAoB,OAAA;AACpB,yGAAA,aAAa,OAAA;AACb,4GAAA,gBAAgB,OAAA;AAChB,+GAAA,mBAAmB,OAAA;AACnB,sGAAA,UAAU,OAAA;AACV,2GAAA,eAAe,OAAA"}
@@ -0,0 +1,78 @@
1
+ /**
2
+ * Trace Storage Module
3
+ *
4
+ * Handles reading/writing traces to filesystem with indexing.
5
+ * Supports lazy loading of full trace data.
6
+ */
7
+ import type { UnifiedTrace, TraceIndex, TraceSource, TraceCategory, TraceSeverity, TraceCollection } from './types';
8
+ import type { MemoryConfig } from '../types';
9
+ /**
10
+ * Generate a unique trace ID
11
+ */
12
+ export declare function generateTraceId(): string;
13
+ /**
14
+ * Generate a collection ID
15
+ */
16
+ export declare function generateCollectionId(): string;
17
+ /**
18
+ * Store a trace with indexing
19
+ */
20
+ export declare function storeTrace(trace: UnifiedTrace, rawData?: unknown, config?: MemoryConfig): Promise<{
21
+ trace_id: string;
22
+ file_path: string;
23
+ }>;
24
+ /**
25
+ * Load trace summary by ID
26
+ */
27
+ export declare function loadTraceSummary(trace_id: string, config?: MemoryConfig): Promise<UnifiedTrace | null>;
28
+ /**
29
+ * Load full trace data (lazy loading)
30
+ */
31
+ export declare function loadFullTrace(trace_id: string, config?: MemoryConfig): Promise<unknown | null>;
32
+ /**
33
+ * Load all traces (summaries only)
34
+ */
35
+ export declare function loadAllTraces(config?: MemoryConfig): Promise<UnifiedTrace[]>;
36
+ /**
37
+ * Load traces by source
38
+ */
39
+ export declare function loadTracesBySource(source: TraceSource, config?: MemoryConfig): Promise<UnifiedTrace[]>;
40
+ /**
41
+ * Load traces by category
42
+ */
43
+ export declare function loadTracesByCategory(category: TraceCategory, config?: MemoryConfig): Promise<UnifiedTrace[]>;
44
+ /**
45
+ * Load traces by severity
46
+ */
47
+ export declare function loadTracesBySeverity(severity: TraceSeverity, config?: MemoryConfig): Promise<UnifiedTrace[]>;
48
+ /**
49
+ * Load traces correlated to an incident
50
+ */
51
+ export declare function loadTracesForIncident(incident_id: string, config?: MemoryConfig): Promise<UnifiedTrace[]>;
52
+ /**
53
+ * Load or initialize trace index
54
+ */
55
+ export declare function loadTraceIndex(config?: MemoryConfig): Promise<TraceIndex>;
56
+ /**
57
+ * Create a trace collection
58
+ */
59
+ export declare function createCollection(name: string, traceIds: string[], incident_id?: string, config?: MemoryConfig): Promise<TraceCollection>;
60
+ /**
61
+ * Load a collection by ID
62
+ */
63
+ export declare function loadCollection(collection_id: string, config?: MemoryConfig): Promise<TraceCollection | null>;
64
+ /**
65
+ * Correlate a trace to an incident
66
+ */
67
+ export declare function correlateTraceToIncident(trace_id: string, incident_id: string, config?: MemoryConfig): Promise<void>;
68
+ /**
69
+ * Get trace statistics
70
+ */
71
+ export declare function getTraceStats(config?: MemoryConfig): Promise<{
72
+ total_traces: number;
73
+ by_source: Record<string, number>;
74
+ by_severity: Record<string, number>;
75
+ oldest_trace: number;
76
+ newest_trace: number;
77
+ }>;
78
+ //# sourceMappingURL=storage.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/traces/storage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EAEV,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EAEhB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAO7C;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAOxC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAO7C;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE,OAAO,EACjB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBlD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAO9B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAczB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAIlF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAQzB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAQzB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAQzB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAQzB;AAMD;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAY/E;AA8GD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,eAAe,CAAC,CA2B1B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAajC;AA2DD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAuBD"}