codymaster 5.2.0 → 7.0.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 (378) hide show
  1. package/CHANGELOG.md +276 -0
  2. package/README.md +216 -333
  3. package/dist/agent/antigravity.js +152 -0
  4. package/dist/agent/backend.js +2 -0
  5. package/dist/agent/claude.js +196 -0
  6. package/dist/agent/codex.js +204 -0
  7. package/dist/agent/copilot.js +284 -0
  8. package/dist/agent/cursor.js +211 -0
  9. package/dist/agent/factory.js +30 -0
  10. package/dist/agent/gemini.js +142 -0
  11. package/dist/agent/opencode.js +205 -0
  12. package/dist/agent/spawn-helper.js +237 -0
  13. package/dist/agent/version.js +25 -0
  14. package/dist/browse/adapter-factory.js +69 -0
  15. package/dist/browse/adapters/agent-browser-adapter.js +305 -0
  16. package/dist/browse/adapters/playwright-adapter.js +309 -0
  17. package/dist/browse/adapters/types.js +6 -0
  18. package/dist/browse/error-collector.js +132 -0
  19. package/dist/browse/event-log.js +109 -0
  20. package/dist/browse/index.js +17 -0
  21. package/dist/browse-server.js +204 -120
  22. package/dist/cli/command-registry.js +12 -0
  23. package/dist/cli/commands/dashboard.js +76 -2
  24. package/dist/cli/commands/engineering.js +218 -4
  25. package/dist/cli/commands/install.js +160 -0
  26. package/dist/cli/commands/learn.js +181 -0
  27. package/dist/cli/commands/parallel.js +138 -0
  28. package/dist/cli/commands/quality.js +105 -0
  29. package/dist/cli/commands/stack.js +49 -0
  30. package/dist/cli/commands/update.js +159 -0
  31. package/dist/cli/update-check.js +94 -10
  32. package/dist/continuity.js +3 -1
  33. package/dist/dashboard.js +47 -6
  34. package/dist/data.js +35 -0
  35. package/dist/execution/tdd-gate.js +113 -0
  36. package/dist/executor/cancel.js +34 -0
  37. package/dist/executor/gc.js +74 -0
  38. package/dist/executor/index.js +14 -0
  39. package/dist/executor/runner.js +70 -0
  40. package/dist/executor/workdir.js +31 -0
  41. package/dist/handoff/contracts.js +22 -0
  42. package/dist/handoff/index.js +18 -0
  43. package/dist/handoff/io.js +121 -0
  44. package/dist/index.js +7 -3
  45. package/dist/indexer/stack-detect.js +219 -0
  46. package/dist/install/copy.js +98 -0
  47. package/dist/install/engine.js +42 -0
  48. package/dist/install/paths.js +70 -0
  49. package/dist/install/platforms/_simple.js +85 -0
  50. package/dist/install/platforms/antigravity.js +91 -0
  51. package/dist/install/platforms/claude-code.js +107 -0
  52. package/dist/install/platforms/cursor.js +77 -0
  53. package/dist/install/platforms/index.js +27 -0
  54. package/dist/install/platforms/simple.js +163 -0
  55. package/dist/install/profiles.js +75 -0
  56. package/dist/install/types.js +2 -0
  57. package/dist/learnings.js +208 -0
  58. package/dist/middleware/metrics.js +30 -0
  59. package/dist/middleware/security-headers.js +14 -0
  60. package/dist/realtime/event-bus.js +29 -0
  61. package/dist/realtime/ws-hub.js +91 -0
  62. package/dist/schemas/task-schema.js +48 -0
  63. package/dist/schemas/validate.js +18 -0
  64. package/dist/skills-lock.js +96 -0
  65. package/dist/sprint-pipeline.js +26 -0
  66. package/dist/storage/index.js +21 -0
  67. package/dist/storage/repos/activity-repo.js +46 -0
  68. package/dist/storage/repos/message-repo.js +39 -0
  69. package/dist/storage/repos/project-repo.js +56 -0
  70. package/dist/storage/repos/task-repo.js +142 -0
  71. package/dist/storage/services/project-service.js +49 -0
  72. package/dist/storage/services/task-service.js +97 -0
  73. package/dist/storage/sqlite.js +113 -0
  74. package/dist/tier-classify.js +131 -0
  75. package/dist/ui/onboarding.js +51 -15
  76. package/dist/utils/cli-utils.js +7 -2
  77. package/dist/utils/design-taste.js +108 -0
  78. package/dist/utils/output-compress.js +143 -0
  79. package/dist/vibecoding-index.js +126 -0
  80. package/package.json +19 -4
  81. package/public/dashboard/app.js +52 -1
  82. package/scripts/build-skills-lock.mjs +88 -0
  83. package/scripts/build-skills.mjs +187 -28
  84. package/scripts/compress-skill.mjs +73 -0
  85. package/scripts/deprecate-skill.mjs +72 -0
  86. package/scripts/install.sh +170 -0
  87. package/scripts/mcp-bridge.js +2 -2
  88. package/scripts/postinstall.js +54 -287
  89. package/scripts/update-changelog.sh +88 -0
  90. package/scripts/validate-skills.mjs +101 -4
  91. package/skills/_shared/SKILL_TEMPLATE.md +62 -0
  92. package/skills/cm-autopilot/scripts/autopilot.py +19 -2
  93. package/skills/cm-brainstorm-idea/SKILL.md +9 -0
  94. package/skills/cm-clean-code/SKILL.md +20 -0
  95. package/skills/cm-code-review/SKILL.md +21 -0
  96. package/skills/cm-codeintell/SKILL.md +9 -0
  97. package/skills/cm-conductor-worktrees/SKILL.archive.md +28 -0
  98. package/skills/cm-conductor-worktrees/SKILL.md +17 -19
  99. package/skills/cm-continuity/SKILL.md +9 -0
  100. package/skills/cm-dashboard/SKILL.archive.md +15 -0
  101. package/skills/cm-dashboard/SKILL.md +20 -9
  102. package/skills/cm-dashboard/ui/app.js +9 -1
  103. package/skills/cm-debugging/SKILL.md +9 -0
  104. package/skills/cm-design-studio/SKILL.archive.md +34 -0
  105. package/skills/cm-design-studio/SKILL.md +17 -25
  106. package/skills/cm-design-system/SKILL.md +1 -0
  107. package/skills/cm-engineering-meta/SKILL.archive.md +73 -0
  108. package/skills/cm-engineering-meta/SKILL.md +16 -63
  109. package/skills/cm-execution/SKILL.md +98 -0
  110. package/skills/cm-git-worktrees/SKILL.archive.md +157 -0
  111. package/skills/cm-git-worktrees/SKILL.md +15 -146
  112. package/skills/cm-identity-guard/SKILL.md +8 -0
  113. package/skills/cm-planning/SKILL.md +63 -92
  114. package/skills/cm-post-deploy-canary/SKILL.archive.md +22 -0
  115. package/skills/cm-post-deploy-canary/SKILL.md +17 -13
  116. package/skills/cm-qa-visual-cli/SKILL.archive.md +22 -0
  117. package/skills/cm-qa-visual-cli/SKILL.md +16 -12
  118. package/skills/cm-quality-gate/SKILL.md +38 -0
  119. package/skills/cm-safe-deploy/SKILL.md +9 -0
  120. package/skills/cm-second-opinion-cli/SKILL.archive.md +23 -0
  121. package/skills/cm-second-opinion-cli/SKILL.md +17 -14
  122. package/skills/cm-secret-shield/SKILL.archive.md +580 -0
  123. package/skills/cm-secret-shield/SKILL.md +15 -569
  124. package/skills/cm-security-gate/SKILL.archive.md +239 -0
  125. package/skills/cm-security-gate/SKILL.md +15 -228
  126. package/skills/cm-skill-health/SKILL.archive.md +83 -0
  127. package/skills/cm-skill-health/SKILL.md +16 -73
  128. package/skills/cm-skill-index/SKILL.md +8 -0
  129. package/skills/cm-skill-mastery/SKILL.archive.md +156 -0
  130. package/skills/cm-skill-mastery/SKILL.md +16 -146
  131. package/skills/cm-skill-search/SKILL.archive.md +49 -0
  132. package/skills/cm-skill-search/SKILL.md +17 -40
  133. package/skills/cm-skill-share/SKILL.archive.md +58 -0
  134. package/skills/cm-skill-share/SKILL.md +17 -49
  135. package/skills/cm-sprint-bus/SKILL.md +9 -0
  136. package/skills/cm-start/SKILL.md +17 -0
  137. package/skills/cm-tdd/SKILL.md +19 -0
  138. package/skills/cm-terminal/SKILL.md +15 -0
  139. package/skills/cm-test-gate/SKILL.archive.md +245 -0
  140. package/skills/cm-test-gate/SKILL.md +15 -234
  141. package/skills/cm-ui-preview/SKILL.archive.md +153 -0
  142. package/skills/cm-ui-preview/SKILL.md +16 -143
  143. package/skills/cm-ux-master/cli/uxmaster/commands/mcp.py +1 -1
  144. package/skills/cm-ux-master/mcp/mcp-config.json +1 -1
  145. package/skills/cm-ux-master/mcp/server.py +2 -2
  146. package/skills/profiles/design.txt +1 -1
  147. package/skills/profiles/full.txt +0 -10
  148. package/skills/profiles/growth.txt +8 -8
  149. package/skills/profiles/knowledge.txt +1 -1
  150. package/skills/profiles/top35.json +41 -0
  151. package/adapters/antigravity.js +0 -15
  152. package/adapters/claude-code.js +0 -17
  153. package/adapters/cursor.js +0 -16
  154. package/skills/cm-ads-tracker/SKILL.md +0 -401
  155. package/skills/cm-ads-tracker/evals/evals.json +0 -55
  156. package/skills/cm-ads-tracker/references/gtm-architecture.md +0 -321
  157. package/skills/cm-ads-tracker/references/industry-events.md +0 -294
  158. package/skills/cm-ads-tracker/references/platforms-api.md +0 -238
  159. package/skills/cm-ads-tracker/templates/capi-payload.md +0 -79
  160. package/skills/cm-ads-tracker/templates/datalayer-push.js +0 -104
  161. package/skills/cm-ads-tracker/templates/gtm-variables.js +0 -56
  162. package/skills/cm-auto-publisher/SKILL.md +0 -81
  163. package/skills/cm-booking-calendar/SKILL.md +0 -521
  164. package/skills/cm-booking-calendar/references/industry-patterns.md +0 -527
  165. package/skills/cm-booking-calendar/templates/booking-form.css +0 -626
  166. package/skills/cm-booking-calendar/templates/booking-form.html +0 -477
  167. package/skills/cm-booking-calendar/templates/calendar-engine.js +0 -419
  168. package/skills/cm-booking-calendar/templates/calendar-export.js +0 -395
  169. package/skills/cm-booking-calendar/templates/reminder-config.js +0 -629
  170. package/skills/cm-content-factory/.content-factory-state.json +0 -132
  171. package/skills/cm-content-factory/.git 2/logs/refs/heads/main +0 -1
  172. package/skills/cm-content-factory/.git 2/logs/refs/remotes/origin/main +0 -1
  173. package/skills/cm-content-factory/.git 2/objects/02/fb0956734b5f8ba3f918b7defd04a89cfe0076 +0 -0
  174. package/skills/cm-content-factory/.git 2/objects/08/1e129d75dc6feac6c02037272e6bd1a04e3324 +0 -0
  175. package/skills/cm-content-factory/.git 2/objects/0c/5393416f3c5e01c9a655a802bff0dd52f76f0a +0 -0
  176. package/skills/cm-content-factory/.git 2/objects/10/0b9be46978a946a77188f68be725098a122001 +0 -0
  177. package/skills/cm-content-factory/.git 2/objects/10/cf041167fc9843610eb3d90259ef3396315fdc +0 -0
  178. package/skills/cm-content-factory/.git 2/objects/12/5e19538dd6e1338ffe74f6c4c165b00435bf48 +0 -0
  179. package/skills/cm-content-factory/.git 2/objects/16/a9b9d0088d5c1347628b45a2620b479d8ad57c +0 -0
  180. package/skills/cm-content-factory/.git 2/objects/17/8c2a9ef93c33ae4eec9d58e82321f9229843a1 +0 -0
  181. package/skills/cm-content-factory/.git 2/objects/25/397ae41d09104d763bdcac2695209d85cdea89 +0 -0
  182. package/skills/cm-content-factory/.git 2/objects/2f/a836b7947f2d458e1f639788bf4bb0983a3305 +0 -0
  183. package/skills/cm-content-factory/.git 2/objects/3a/baaaf0a1c0909c0828335791557125fba911e0 +0 -0
  184. package/skills/cm-content-factory/.git 2/objects/42/2924221b81f5ce3c4e4daac9a64a24f9b01f9a +0 -0
  185. package/skills/cm-content-factory/.git 2/objects/42/ec0ce707447dc11446a34c9995fb8533801731 +0 -0
  186. package/skills/cm-content-factory/.git 2/objects/46/e43ce92866d56ce74b1d750db307cfe6154a15 +0 -0
  187. package/skills/cm-content-factory/.git 2/objects/48/5e41b633c63f55b8277bcc59f44f67681f671a +0 -0
  188. package/skills/cm-content-factory/.git 2/objects/49/49c596a3a89fa240642acd95dd3258e261eb09 +0 -0
  189. package/skills/cm-content-factory/.git 2/objects/50/9d42d8412ef8eaf7f7e138476bac2e4d10ce60 +0 -0
  190. package/skills/cm-content-factory/.git 2/objects/55/0c8c389d981b463ef849aeb792d8be3ccb6ec8 +0 -0
  191. package/skills/cm-content-factory/.git 2/objects/5d/82d3b18410cdda3ace3677436f0cb599dbe2d2 +0 -0
  192. package/skills/cm-content-factory/.git 2/objects/60/0617c58e871a38b33bf29e282d132bb3c381ad +0 -0
  193. package/skills/cm-content-factory/.git 2/objects/6a/8369a99c687b7245c92ffaf0e0f0dab9014504 +0 -0
  194. package/skills/cm-content-factory/.git 2/objects/79/bea435d40ab531c1aaf6be0432c6a5b7aaed21 +0 -0
  195. package/skills/cm-content-factory/.git 2/objects/7e/5ebd79251c2f14e4aceb86c74b6b6daae6b500 +0 -0
  196. package/skills/cm-content-factory/.git 2/objects/81/98a822a60178d6d5023ddb3e222cddf048742e +0 -0
  197. package/skills/cm-content-factory/.git 2/objects/86/0a0e1943dfe53411d2e499a1f16f46a96ef758 +0 -0
  198. package/skills/cm-content-factory/.git 2/objects/86/971fb55fdc081fdbae52376f0f13e57a4e9b04 +0 -0
  199. package/skills/cm-content-factory/.git 2/objects/88/b89dd609a0a03f8d4fe8bfde20d5b8fc1d326d +0 -0
  200. package/skills/cm-content-factory/.git 2/objects/90/8737edb6b7809e32cc01590b4e08ba42a9d40d +0 -0
  201. package/skills/cm-content-factory/.git 2/objects/93/d5a8a9a7d4fb7f11491cb596a6880528725118 +0 -0
  202. package/skills/cm-content-factory/.git 2/objects/98/46a2ab81d0c3b3eb00ef88fc56989aa7e9f316 +0 -0
  203. package/skills/cm-content-factory/.git 2/objects/9b/d8dd1e49cf274eaf9c555f3ab39dce7af5715e +0 -0
  204. package/skills/cm-content-factory/.git 2/objects/a1/13329fb0cec96ae78b222d33a24c3b5bc7fa1f +0 -0
  205. package/skills/cm-content-factory/.git 2/objects/a9/e6effe626e8a3aea3a8fc3364b492191c6e7d0 +0 -0
  206. package/skills/cm-content-factory/.git 2/objects/ad/6de7e48d9782cca9353d1ff0aa1aab7fe1df85 +0 -0
  207. package/skills/cm-content-factory/.git 2/objects/af/54ae316f771ff692e299ffcd8bf2f06b413b59 +0 -0
  208. package/skills/cm-content-factory/.git 2/objects/b0/4cb8b0b00dad633e731c1472161419e738d674 +0 -0
  209. package/skills/cm-content-factory/.git 2/objects/b3/094abb0b9ed46419b269e4a4e36a459690e3b0 +0 -0
  210. package/skills/cm-content-factory/.git 2/objects/b9/435c5d4baac2cfc5c83009ddd27b46b60db5f1 +0 -0
  211. package/skills/cm-content-factory/.git 2/objects/ba/5da17dbaec5ec2dcfdfd126aead518d1171d5c +0 -0
  212. package/skills/cm-content-factory/.git 2/objects/c0/bf58703aa258ba5dd63083bebaec8f223d844c +0 -0
  213. package/skills/cm-content-factory/.git 2/objects/c4/701a34edf1fc1bad58ccc57bd03f9426acb59a +0 -0
  214. package/skills/cm-content-factory/.git 2/objects/c7/5ccce9a4e5cc74d9b3174550cf6d993ca43638 +0 -0
  215. package/skills/cm-content-factory/.git 2/objects/c7/710d59b5a35b0f1f0a0399386643a0bd94c929 +0 -0
  216. package/skills/cm-content-factory/.git 2/objects/d1/fe58237112e953e5fec52da22cf38e08be3df9 +0 -5
  217. package/skills/cm-content-factory/.git 2/objects/d2/2bbe9fd2f74c95bc5583e803f5e435f1e2cd86 +0 -0
  218. package/skills/cm-content-factory/.git 2/objects/d7/e72852ea2bff74581dbf247d400120086229f4 +0 -0
  219. package/skills/cm-content-factory/.git 2/objects/d8/d4c3b5553e4fd72807e1d4b49ef07d9ef3ac35 +0 -0
  220. package/skills/cm-content-factory/.git 2/objects/dc/75050c2876f6a02ae2a53a3c886f395b622977 +0 -0
  221. package/skills/cm-content-factory/.git 2/objects/ee/e8546f95acec500187c08a28a8b9ee02db0dec +0 -0
  222. package/skills/cm-content-factory/.git 2/objects/ef/263c059208b416c2146434f10cb2b9fabcba16 +0 -0
  223. package/skills/cm-content-factory/.git 2/objects/f3/ae597e84d9a59b88acd21c99bde2eaf686d785 +0 -0
  224. package/skills/cm-content-factory/.git 2/objects/f3/f6f5673c821d3d8e76fa267a9e882e7a5387ea +0 -0
  225. package/skills/cm-content-factory/.git 2/objects/f9/6e6d0ad02624dd11d5848594d056caef7a5e8b +0 -0
  226. package/skills/cm-content-factory/.git 2/objects/ff/278988fc1edf0db3abcf18de795f4cc0b4f3e1 +0 -0
  227. package/skills/cm-content-factory/.git 2/refs/heads/main +0 -1
  228. package/skills/cm-content-factory/.git 2/refs/remotes/origin/main +0 -1
  229. package/skills/cm-content-factory/.pytest_cache 2/v/cache/nodeids +0 -76
  230. package/skills/cm-content-factory/.pytest_cache 2/v/cache/stepwise +0 -1
  231. package/skills/cm-content-factory/AGENTS.md +0 -61
  232. package/skills/cm-content-factory/CLAUDE.md +0 -63
  233. package/skills/cm-content-factory/CURSOR.md +0 -43
  234. package/skills/cm-content-factory/Content Factory.zip +0 -0
  235. package/skills/cm-content-factory/SKILL.md +0 -416
  236. package/skills/cm-content-factory/cf +0 -313
  237. package/skills/cm-content-factory/config.schema.json +0 -397
  238. package/skills/cm-content-factory/dashboard/app.js +0 -556
  239. package/skills/cm-content-factory/dashboard/index.html +0 -397
  240. package/skills/cm-content-factory/dashboard/style.css +0 -1211
  241. package/skills/cm-content-factory/examples/01-real-estate.config.json +0 -146
  242. package/skills/cm-content-factory/examples/02-personal-finance.config.json +0 -146
  243. package/skills/cm-content-factory/examples/03-health-wellness.config.json +0 -147
  244. package/skills/cm-content-factory/examples/04-saas-software.config.json +0 -147
  245. package/skills/cm-content-factory/examples/05-legal-services.config.json +0 -147
  246. package/skills/cm-content-factory/examples/06-insurance.config.json +0 -146
  247. package/skills/cm-content-factory/examples/07-ecommerce-dropship.config.json +0 -146
  248. package/skills/cm-content-factory/examples/08-online-education.config.json +0 -147
  249. package/skills/cm-content-factory/examples/09-crypto-defi.config.json +0 -147
  250. package/skills/cm-content-factory/examples/10-beauty-skincare.config.json +0 -147
  251. package/skills/cm-content-factory/examples/11-home-services.config.json +0 -146
  252. package/skills/cm-content-factory/examples/12-dental-clinic.config.json +0 -147
  253. package/skills/cm-content-factory/examples/13-pet-care.config.json +0 -147
  254. package/skills/cm-content-factory/examples/14-travel-hospitality.config.json +0 -147
  255. package/skills/cm-content-factory/examples/15-ai-automation.config.json +0 -147
  256. package/skills/cm-content-factory/examples/16-wedding-events.config.json +0 -147
  257. package/skills/cm-content-factory/examples/17-fitness-coaching.config.json +0 -148
  258. package/skills/cm-content-factory/examples/18-cybersecurity.config.json +0 -147
  259. package/skills/cm-content-factory/examples/19-food-restaurant.config.json +0 -148
  260. package/skills/cm-content-factory/examples/20-solar-energy.config.json +0 -147
  261. package/skills/cm-content-factory/examples/fitness-blog.config.json +0 -116
  262. package/skills/cm-content-factory/examples/tech-blog.config.json +0 -107
  263. package/skills/cm-content-factory/extensions/EXTENSION_GUIDE.md +0 -72
  264. package/skills/cm-content-factory/extensions/hooks.py +0 -126
  265. package/skills/cm-content-factory/extensions/openclaw_adapter.py +0 -132
  266. package/skills/cm-content-factory/landing/docs/content/changelog.md +0 -36
  267. package/skills/cm-content-factory/landing/docs/content/deployment.md +0 -46
  268. package/skills/cm-content-factory/landing/docs/content/execution-flow.md +0 -67
  269. package/skills/cm-content-factory/landing/docs/content/memory-system.md +0 -38
  270. package/skills/cm-content-factory/landing/docs/content/openspace.md +0 -27
  271. package/skills/cm-content-factory/landing/docs/content/use-cases.md +0 -26
  272. package/skills/cm-content-factory/landing/docs/content/v5-intro.md +0 -28
  273. package/skills/cm-content-factory/landing/docs/index.html +0 -240
  274. package/skills/cm-content-factory/landing/index.html +0 -680
  275. package/skills/cm-content-factory/landing/script.js +0 -143
  276. package/skills/cm-content-factory/landing/style.css +0 -1216
  277. package/skills/cm-content-factory/landing/translations.js +0 -508
  278. package/skills/cm-content-factory/logs/events.jsonl +0 -11
  279. package/skills/cm-content-factory/profiles/_template.profile.json +0 -231
  280. package/skills/cm-content-factory/profiles/finance.profile.json +0 -278
  281. package/skills/cm-content-factory/profiles/legal.profile.json +0 -263
  282. package/skills/cm-content-factory/profiles/medical-research.profile.json +0 -321
  283. package/skills/cm-content-factory/profiles/technology.profile.json +0 -275
  284. package/skills/cm-content-factory/scripts/agent_dispatcher.py +0 -266
  285. package/skills/cm-content-factory/scripts/audit.py +0 -106
  286. package/skills/cm-content-factory/scripts/dashboard_server.py +0 -225
  287. package/skills/cm-content-factory/scripts/deploy.py +0 -146
  288. package/skills/cm-content-factory/scripts/extract.py +0 -132
  289. package/skills/cm-content-factory/scripts/landing_generator.py +0 -459
  290. package/skills/cm-content-factory/scripts/memory.py +0 -521
  291. package/skills/cm-content-factory/scripts/monetize.py +0 -239
  292. package/skills/cm-content-factory/scripts/pipeline.py +0 -357
  293. package/skills/cm-content-factory/scripts/plan.py +0 -163
  294. package/skills/cm-content-factory/scripts/publish.py +0 -145
  295. package/skills/cm-content-factory/scripts/research.py +0 -337
  296. package/skills/cm-content-factory/scripts/scaffold.py +0 -464
  297. package/skills/cm-content-factory/scripts/scoreboard.py +0 -336
  298. package/skills/cm-content-factory/scripts/seo.py +0 -90
  299. package/skills/cm-content-factory/scripts/state_manager.py +0 -320
  300. package/skills/cm-content-factory/scripts/token_manager.py +0 -268
  301. package/skills/cm-content-factory/scripts/validate.py +0 -221
  302. package/skills/cm-content-factory/scripts/wizard.py +0 -329
  303. package/skills/cm-content-factory/scripts/write.py +0 -93
  304. package/skills/cm-content-factory/sites/docs-site/src/assets/houston.webp +0 -0
  305. package/skills/cm-content-factory/sites/docs-site/src/content/docs/architecture.md +0 -90
  306. package/skills/cm-content-factory/sites/docs-site/src/content/docs/data-flow.md +0 -54
  307. package/skills/cm-content-factory/sites/docs-site/src/content/docs/deployment.md +0 -38
  308. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/index.md +0 -65
  309. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/lc-content-lifecycle.md +0 -48
  310. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/seq-write-mode.md +0 -39
  311. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/uj-first-batch.md +0 -42
  312. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/wf-content-pipeline.md +0 -51
  313. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/wf-learning-cycle.md +0 -52
  314. package/skills/cm-content-factory/sites/docs-site/src/content/docs/getting-started/configuration.md +0 -86
  315. package/skills/cm-content-factory/sites/docs-site/src/content/docs/getting-started/installation.md +0 -80
  316. package/skills/cm-content-factory/sites/docs-site/src/content/docs/getting-started/intro.md +0 -58
  317. package/skills/cm-content-factory/sites/docs-site/src/content/docs/index.md +0 -102
  318. package/skills/cm-content-factory/sites/docs-site/src/content/docs/jtbd/index.md +0 -45
  319. package/skills/cm-content-factory/sites/docs-site/src/content/docs/jtbd/optimize-seo.md +0 -29
  320. package/skills/cm-content-factory/sites/docs-site/src/content/docs/jtbd/scale-content-production.md +0 -55
  321. package/skills/cm-content-factory/sites/docs-site/src/content/docs/jtbd/standardize-quality.md +0 -29
  322. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/buyer-cmo-huong.md +0 -41
  323. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/buyer-content-lead-khoa.md +0 -40
  324. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/index.md +0 -56
  325. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/user-content-manager-lan.md +0 -46
  326. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/user-seo-minh.md +0 -45
  327. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/user-writer-tu.md +0 -45
  328. package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/content-pipeline.md +0 -108
  329. package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/index.md +0 -22
  330. package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/memory-system.md +0 -52
  331. package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/seo-optimization.md +0 -58
  332. package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/troubleshooting-guide.md +0 -92
  333. package/skills/cm-content-factory/sites/docs-site/src/styles/custom.css +0 -575
  334. package/skills/cm-content-factory/tests/conftest.py +0 -66
  335. package/skills/cm-content-factory/tests/test_agent_dispatcher.py +0 -125
  336. package/skills/cm-content-factory/tests/test_memory.py +0 -128
  337. package/skills/cm-content-factory/tests/test_pipeline.py +0 -107
  338. package/skills/cm-content-factory/tests/test_research.py +0 -56
  339. package/skills/cm-content-factory/tests/test_state_manager.py +0 -131
  340. package/skills/cm-content-factory/tests/test_token_manager.py +0 -110
  341. package/skills/cm-content-factory/tests/test_wizard.py +0 -121
  342. package/skills/cm-cro-methodology/SKILL.md +0 -290
  343. package/skills/cm-cro-methodology/references/COPYWRITING.md +0 -178
  344. package/skills/cm-cro-methodology/references/OBJECTIONS.md +0 -135
  345. package/skills/cm-cro-methodology/references/PERSUASION.md +0 -158
  346. package/skills/cm-cro-methodology/references/RESEARCH.md +0 -220
  347. package/skills/cm-cro-methodology/references/funnel-analysis.md +0 -365
  348. package/skills/cm-cro-methodology/references/testing-methodology.md +0 -330
  349. package/skills/cm-google-form/SKILL.md +0 -266
  350. package/skills/cm-google-form/templates/apps-script.js +0 -55
  351. package/skills/cm-google-form/templates/form-markup.html +0 -110
  352. package/skills/cm-google-form/templates/form-submit.js +0 -201
  353. package/skills/cm-google-form/templates/toast.css +0 -152
  354. package/skills/cm-growth-hacking/SKILL.md +0 -282
  355. package/skills/cm-growth-hacking/bottom-sheet-engine.md +0 -261
  356. package/skills/cm-growth-hacking/calendar-integration.md +0 -264
  357. package/skills/cm-growth-hacking/references/engagement-patterns.md +0 -346
  358. package/skills/cm-growth-hacking/templates/bottom-sheet.css +0 -528
  359. package/skills/cm-growth-hacking/templates/bottom-sheet.js +0 -269
  360. package/skills/cm-growth-hacking/templates/calendar-cta.js +0 -213
  361. package/skills/cm-growth-hacking/templates/tracking-events.js +0 -211
  362. package/skills/cm-growth-hacking/templates/trigger-manager.js +0 -254
  363. package/skills/cm-growth-hacking/tracking-events.md +0 -246
  364. package/skills/cm-growth-hacking/trigger-system.md +0 -342
  365. package/skills/cm-jtbd/SKILL.md +0 -98
  366. package/skills/cm-notebooklm/SKILL.md +0 -156
  367. package/skills/cm-notebooklm/references/command_reference.md +0 -94
  368. package/skills/cm-notebooklm/references/workflows.md +0 -60
  369. package/skills/cm-notebooklm/resources/knowledge_sources.md +0 -106
  370. package/skills/cm-notebooklm/scripts/brain-sync.sh +0 -453
  371. package/skills/cm-notebooklm/scripts/graduate_wisdom.py +0 -101
  372. package/skills/cm-readit/SKILL.md +0 -289
  373. package/skills/cm-readit/audio-player.md +0 -206
  374. package/skills/cm-readit/examples/blog-reader.js +0 -352
  375. package/skills/cm-readit/examples/voice-cro.js +0 -390
  376. package/skills/cm-readit/tts-engine.md +0 -262
  377. package/skills/cm-readit/ui-patterns.md +0 -362
  378. package/skills/cm-readit/voice-cro.md +0 -223
@@ -1,152 +0,0 @@
1
- /* ============================================
2
- FORM TOAST NOTIFICATION
3
- ============================================
4
-
5
- Copy this into your main CSS file.
6
-
7
- Dependencies: none
8
- CSS Variables used (override if needed):
9
- - --space-2 through --space-8
10
- - --radius-lg, --radius-full
11
- - --text-sm
12
- - --transition-fast
13
- - --white
14
-
15
- If your project doesn't use CSS variables,
16
- replace them with fixed values:
17
- - --space-2: 8px, --space-3: 12px, --space-4: 16px, --space-5: 20px
18
- - --radius-lg: 12px, --radius-full: 9999px
19
- - --text-sm: 14px
20
- - --transition-fast: 150ms ease
21
- */
22
-
23
- .form-toast-container {
24
- position: fixed;
25
- bottom: 100px;
26
- left: 50%;
27
- transform: translateX(-50%);
28
- z-index: 10000;
29
- display: flex;
30
- flex-direction: column;
31
- gap: 12px;
32
- width: calc(100% - 32px);
33
- max-width: 440px;
34
- pointer-events: none;
35
- }
36
-
37
- .form-toast {
38
- pointer-events: auto;
39
- display: flex;
40
- align-items: flex-start;
41
- gap: 12px;
42
- padding: 16px 20px;
43
- border-radius: 12px;
44
- box-shadow: 0 8px 32px rgba(0, 0, 0, 0.18), 0 2px 8px rgba(0, 0, 0, 0.1);
45
- animation: toastSlideUp 0.35s cubic-bezier(0.16, 1, 0.3, 1) forwards;
46
- opacity: 0;
47
- transform: translateY(20px);
48
- font-size: 14px;
49
- line-height: 1.5;
50
- }
51
-
52
- .form-toast.hiding {
53
- animation: toastSlideDown 0.25s ease-in forwards;
54
- }
55
-
56
- /* Variants */
57
- .form-toast--success {
58
- background: #ECFDF5;
59
- border: 1px solid #A7F3D0;
60
- color: #065F46;
61
- }
62
-
63
- .form-toast--error {
64
- background: #FEF2F2;
65
- border: 1px solid #FECACA;
66
- color: #991B1B;
67
- }
68
-
69
- .form-toast--retrying {
70
- background: #FFFBEB;
71
- border: 1px solid #FDE68A;
72
- color: #92400E;
73
- }
74
-
75
- /* Elements */
76
- .form-toast-icon {
77
- font-size: 20px;
78
- flex-shrink: 0;
79
- line-height: 1;
80
- margin-top: 1px;
81
- }
82
-
83
- .form-toast-body {
84
- flex: 1;
85
- min-width: 0;
86
- }
87
-
88
- .form-toast-title {
89
- font-weight: 700;
90
- margin-bottom: 2px;
91
- }
92
-
93
- .form-toast-msg {
94
- opacity: 0.85;
95
- }
96
-
97
- .form-toast-close {
98
- flex-shrink: 0;
99
- background: none;
100
- border: none;
101
- cursor: pointer;
102
- font-size: 18px;
103
- line-height: 1;
104
- opacity: 0.5;
105
- padding: 4px;
106
- color: inherit;
107
- transition: opacity 150ms ease;
108
- }
109
-
110
- .form-toast-close:hover {
111
- opacity: 1;
112
- }
113
-
114
- /* Fallback contact button (Zalo, Messenger, etc.) */
115
- .form-toast-zalo {
116
- display: inline-flex;
117
- align-items: center;
118
- gap: 6px;
119
- margin-top: 8px;
120
- padding: 8px 16px;
121
- background: #0068FF;
122
- color: #fff !important;
123
- border-radius: 9999px;
124
- font-size: 14px;
125
- font-weight: 600;
126
- text-decoration: none;
127
- transition: background 150ms ease, transform 150ms ease;
128
- }
129
-
130
- .form-toast-zalo:hover {
131
- background: #0054cc;
132
- transform: translateY(-1px);
133
- }
134
-
135
- /* Animations */
136
- @keyframes toastSlideUp {
137
- from { opacity: 0; transform: translateY(20px); }
138
- to { opacity: 1; transform: translateY(0); }
139
- }
140
-
141
- @keyframes toastSlideDown {
142
- from { opacity: 1; transform: translateY(0); }
143
- to { opacity: 0; transform: translateY(20px); }
144
- }
145
-
146
- /* Mobile: push toast above sticky CTAs */
147
- @media (max-width: 768px) {
148
- .form-toast-container {
149
- bottom: 80px;
150
- width: calc(100% - 24px);
151
- }
152
- }
@@ -1,282 +0,0 @@
1
- ---
2
- name: cm-growth-hacking
3
- description: "Bottom-sheet and popup growth system: booking CTAs, calendars, lead capture, surveys, re-engagement, with CRO tracking hooks. Zero-deps; works static or dynamic sites. Works with cm-booking-calendar, cm-ads-tracker, cm-google-form, cm-readit, cm-ux-master."
4
- allowed-tools: Read, Write, Edit, Glob, Grep, Browser
5
- version: 1.0
6
- priority: HIGH
7
- skills:
8
- - cm-booking-calendar
9
- - cm-ads-tracker
10
- - cm-google-form
11
- - cm-readit
12
- - cm-ux-master
13
- ---
14
-
15
- # CM Growth Hacking
16
-
17
- > **Bottom Sheet + Calendar + Trigger + Tracking = Growth Hacking Engine.**
18
- > Đa ngành, đa mục đích, zero dependencies.
19
- > 1 skill = mọi growth hacking pattern bạn cần.
20
-
21
- ---
22
-
23
- ## 🎯 When to Use
24
-
25
- | Trigger | Action |
26
- |---------|--------|
27
- | User says "bottom sheet", "popup" | Activate — start Phase 1 |
28
- | User says "đặt lịch popup", "booking bottom sheet" | Activate — focus booking sheet |
29
- | User says "lead capture", "exit intent" | Activate — focus lead capture |
30
- | User says "nhắc lịch", "google calendar", "apple calendar" | Activate — focus calendar CTA |
31
- | User says "flash sale popup", "countdown" | Activate — focus promo sheet |
32
- | User says "survey", "đánh giá", "feedback" | Activate — focus survey sheet |
33
- | User says "tăng conversion", "giảm bounce" | Activate — explain + build |
34
-
35
- ---
36
-
37
- ## 📖 Selective Reading Rule (MANDATORY)
38
-
39
- | File | Status | When to Read |
40
- |------|--------|--------------|
41
- | [bottom-sheet-engine.md](bottom-sheet-engine.md) | 🔴 REQUIRED | Any bottom sheet implementation |
42
- | [trigger-system.md](trigger-system.md) | 🔴 REQUIRED | Setting up when/how sheets appear |
43
- | [calendar-integration.md](calendar-integration.md) | ⚪ Optional | When sheet includes calendar CTA |
44
- | [tracking-events.md](tracking-events.md) | ⚪ Optional | When tracking engagement events |
45
-
46
- > 🔴 **Always read `bottom-sheet-engine.md` + `trigger-system.md` first.**
47
-
48
- ---
49
-
50
- ## 🧭 Quick Decision Tree
51
-
52
- ```
53
- "I need an engagement popup"
54
-
55
- ├─ Booking / Appointment
56
- │ └─ bottom-sheet-engine + calendar-integration + cm-booking-calendar
57
- │ └─ Form → Sheet: cm-google-form
58
- │ └─ Post-submit: Calendar CTA (GCal + ICS)
59
-
60
- ├─ Lead Capture / Exit Intent
61
- │ └─ bottom-sheet-engine + trigger-system (exit-intent)
62
- │ └─ Form → Sheet: cm-google-form
63
- │ └─ Tracking: cro_lead_capture
64
-
65
- ├─ Flash Sale / Promo
66
- │ └─ bottom-sheet-engine + trigger-system (timer)
67
- │ └─ Countdown timer + CTA
68
- │ └─ Optional: Calendar deadline
69
-
70
- ├─ Survey / Feedback
71
- │ └─ bottom-sheet-engine + trigger-system (post-interaction)
72
- │ └─ Star rating or NPS
73
- │ └─ Form → Sheet: cm-google-form
74
-
75
- ├─ Event / Webinar Registration
76
- │ └─ bottom-sheet-engine + calendar-integration
77
- │ └─ Register → Add to Calendar
78
- │ └─ Tracking: cro_event_register
79
-
80
- ├─ Re-engagement (Return Visitor)
81
- │ └─ bottom-sheet-engine + trigger-system (return-visitor)
82
- │ └─ "Welcome back" + personalized CTA
83
-
84
- └─ Chat / Contact CTA
85
- └─ bottom-sheet-engine + trigger-system (scroll)
86
- └─ Zalo / Messenger / Hotline buttons
87
- ```
88
-
89
- ---
90
-
91
- ## 📋 6-Phase Workflow
92
-
93
- ```
94
- Phase 1: DISCOVER → Scan site, detect industry, identify existing popups/forms
95
- Phase 2: SOCRATIC GATE → Ask strategic questions (max 5)
96
- Phase 3: CONFIGURE → Select engagement pattern + customize
97
- Phase 4: BUILD → Generate bottom sheet + triggers + calendar + tracking
98
- Phase 5: INTEGRATE → Wire to site + link skills
99
- Phase 6: VERIFY → Test all interactions + tracking events
100
- ```
101
-
102
- > 🔴 **Rule:** NEVER skip Phase 1 & 2. Always scan first, ask second.
103
-
104
- ---
105
-
106
- ## Phase 1: DISCOVER
107
-
108
- Scan the website to understand:
109
-
110
- ```bash
111
- # Find existing popups/modals/sheets
112
- grep -ri "modal\|popup\|bottom-sheet\|overlay\|dialog" --include="*.html" --include="*.astro" --include="*.css" .
113
-
114
- # Find existing forms
115
- grep -ri "data-form-type\|onsubmit\|<form" --include="*.html" --include="*.astro" .
116
-
117
- # Find existing calendar code
118
- grep -ri "VCALENDAR\|google.com/calendar\|\.ics\|VEVENT" --include="*.js" --include="*.html" .
119
-
120
- # Find existing tracking
121
- grep -ri "dataLayer\|fbq\|ttq\|gtag" --include="*.js" --include="*.html" .
122
- ```
123
-
124
- **Output:** Discovery Report with detected industry, existing UI, and recommended pattern.
125
-
126
- ---
127
-
128
- ## Phase 2: SOCRATIC GATE
129
-
130
- > 🔴 **MANDATORY.** Ask ALL in ONE message. Max 5 questions.
131
-
132
- 1. **Mục tiêu chính** — Bạn muốn popup/bottom sheet để làm gì? (đặt lịch / thu lead / khuyến mãi / survey / khác)
133
- 2. **Trigger** — Khi nào hiện? (ngay khi vào trang / scroll X% / sau X giây / khi sắp thoát / click nút)
134
- 3. **Nội dung** — Trong popup cần gì? (form / calendar CTA / countdown / rating / nút chat)
135
- 4. **Calendar** — Có cần thêm Google Calendar / Apple Calendar không? Nhắc trước bao lâu?
136
- 5. **Tracking** — Đang chạy ads platform nào? (Facebook / TikTok / Google / không)
137
-
138
- ---
139
-
140
- ## Phase 3: CONFIGURE
141
-
142
- Based on answers, select from `references/engagement-patterns.md` and build config:
143
-
144
- ```javascript
145
- const ENGAGEMENT_CONFIG = {
146
- type: 'booking', // booking | lead | promo | survey | event | chat | reengagement
147
- trigger: {
148
- type: 'scroll', // scroll | time | exit | click | return | interaction
149
- value: 0.3, // scroll % or ms or selector
150
- delay: 0, // additional delay after trigger
151
- },
152
- sheet: {
153
- size: 'standard', // compact | standard | full
154
- title: 'Đặt Lịch Khám',
155
- icon: '📅',
156
- dismissible: true,
157
- swipeToDismiss: true,
158
- },
159
- calendar: {
160
- enabled: true,
161
- providers: ['gcal', 'ics'], // gcal | ics | outlook
162
- reminderMinutes: [1440, 120], // 1 day + 2 hours before
163
- location: 'Google Maps URL',
164
- },
165
- tracking: {
166
- events: ['cro_sheet_shown', 'cro_booking_submit', 'cro_calendar_add'],
167
- conversionValue: 500000,
168
- currency: 'VND',
169
- },
170
- session: {
171
- dismissKey: 'eng_booking_dismissed',
172
- storage: 'sessionStorage', // sessionStorage | localStorage
173
- maxShowPerSession: 1,
174
- }
175
- };
176
- ```
177
-
178
- ---
179
-
180
- ## Phase 4: BUILD
181
-
182
- Read and use templates from `templates/` directory:
183
-
184
- | Template | Purpose |
185
- |----------|---------|
186
- | `templates/bottom-sheet.css` | Universal responsive bottom sheet CSS |
187
- | `templates/bottom-sheet.js` | `BottomSheetEngine` class — create, show, hide, swipe, stack |
188
- | `templates/calendar-cta.js` | Calendar button generators (GCal + ICS + device detection) |
189
- | `templates/trigger-manager.js` | `TriggerManager` class — scroll, time, exit, click triggers |
190
- | `templates/tracking-events.js` | DataLayer push helpers for engagement events |
191
-
192
- ---
193
-
194
- ## Phase 5: INTEGRATE
195
-
196
- ### Wire to Existing Skills
197
-
198
- ```
199
- cm-growth-hacking (this skill)
200
-
201
- ├── UI Layer ──────────── templates/bottom-sheet.css + .js
202
-
203
- ├── Form Submit ───────── @skills/cm-google-form
204
- │ └── submitToGoogleSheet() → success callback → show calendar CTA
205
-
206
- ├── Calendar Logic ────── @skills/cm-booking-calendar
207
- │ └── calendar-engine.js (scheduling)
208
- │ └── calendar-export.js (ICS + GCal deep link)
209
- │ └── reminder-config.js (VALARM + industry patterns)
210
-
211
- ├── CRO Tracking ──────── @skills/cm-ads-tracker
212
- │ └── dataLayer.push() → GTM → FB/TikTok/Google
213
-
214
- └── Design Principles ─── @skills/cm-ux-master
215
- └── Color, typography, animation standards
216
- ```
217
-
218
- ---
219
-
220
- ## Phase 6: VERIFY
221
-
222
- | # | Test Case | Expected |
223
- |---|-----------|----------|
224
- | 1 | Bottom sheet opens | Slides up with animation |
225
- | 2 | Swipe down to dismiss | Sheet closes + state saved |
226
- | 3 | Trigger fires correctly | Sheet appears at configured trigger |
227
- | 4 | Form submit (if applicable) | Toast success → Calendar CTA appears |
228
- | 5 | Google Calendar click | New tab with pre-filled event |
229
- | 6 | ICS download click | .ics file downloads |
230
- | 7 | .ics on iOS | Opens Apple Calendar with reminders |
231
- | 8 | Tracking events fire | dataLayer shows correct events |
232
- | 9 | Session dismiss works | Sheet doesn't reappear after dismiss |
233
- | 10 | Mobile responsive | Sheet adapts to viewport |
234
- | 11 | Accessibility | aria-labels, focus trap, Escape key |
235
- | 12 | No conflict with existing UI | Doesn't break page layout |
236
-
237
- ---
238
-
239
- ## ❌ Anti-Patterns
240
-
241
- | ❌ Don't | ✅ Do |
242
- |----------|------|
243
- | Hardcode content in sheet | Use config object |
244
- | Show popup immediately on page load | Use trigger system with delay |
245
- | No dismiss option | Always allow close + swipe |
246
- | Forget mobile safe-area | Pad for notched devices |
247
- | Skip tracking | Track every interaction |
248
- | One-size-fits-all sheet | Use compact/standard/full variants |
249
- | Autoplay anything | Require user interaction |
250
- | Show on every page visit | Respect session/localStorage dismiss |
251
- | Build calendar logic from scratch | Inherit from `cm-booking-calendar` |
252
- | Build tracking from scratch | Inherit from `cm-ads-tracker` |
253
-
254
- ---
255
-
256
- ## 📑 Templates
257
-
258
- | File | Purpose |
259
- |------|---------|
260
- | `templates/bottom-sheet.css` | Universal bottom sheet CSS (3 sizes) |
261
- | `templates/bottom-sheet.js` | BottomSheetEngine class |
262
- | `templates/calendar-cta.js` | Calendar CTA buttons + auto device route |
263
- | `templates/trigger-manager.js` | TriggerManager class |
264
- | `templates/tracking-events.js` | Engagement tracking helpers |
265
-
266
- ## 📚 References
267
-
268
- | File | Purpose |
269
- |------|---------|
270
- | `references/engagement-patterns.md` | 10+ engagement patterns by industry |
271
-
272
- ---
273
-
274
- ## 🔗 Related Skills
275
-
276
- | Need | Skill |
277
- |------|-------|
278
- | Calendar scheduling + export | `@[skills/cm-booking-calendar]` |
279
- | Form → Google Sheet | `@[skills/cm-google-form]` |
280
- | Full CRO tracking setup | `@[skills/cm-ads-tracker]` |
281
- | Audio engagement | `@[skills/cm-readit]` |
282
- | UI/UX design principles | `@[skills/cm-ux-master]` |
@@ -1,261 +0,0 @@
1
- # Bottom Sheet Engine
2
-
3
- > Core module cho mọi engagement UI. Modular, responsive, accessible.
4
- > Một engine — nhiều content types.
5
-
6
- ---
7
-
8
- ## 🏗️ Architecture
9
-
10
- ```
11
- BottomSheetEngine
12
- ├── create(config) → Build DOM + attach events
13
- ├── show() → Slide up animation
14
- ├── hide() → Slide down + cleanup
15
- ├── destroy() → Remove from DOM entirely
16
- ├── setContent(html) → Swap inner content dynamically
17
- ├── setSize(size) → Switch compact/standard/full
18
- └── onDismiss(callback) → Hook for tracking/state
19
- ```
20
-
21
- ### 3 Size Variants
22
-
23
- | Size | Height | Use Case |
24
- |------|--------|----------|
25
- | `compact` | ~120px | Simple CTA, chat buttons, promo banner |
26
- | `standard` | ~320px | Booking form, lead capture, calendar CTA |
27
- | `full` | ~80vh | Survey, multi-step form, detailed content |
28
-
29
- ### DOM Structure
30
-
31
- ```html
32
- <!-- Backdrop (optional, for full-size sheets) -->
33
- <div class="eng-backdrop" data-sheet-id="booking"></div>
34
-
35
- <!-- Bottom Sheet -->
36
- <div class="eng-sheet eng-sheet--standard" data-sheet-id="booking" role="dialog" aria-modal="true" aria-label="Đặt Lịch Khám">
37
- <!-- Drag handle -->
38
- <div class="eng-sheet__handle" aria-hidden="true">
39
- <div class="eng-sheet__handle-bar"></div>
40
- </div>
41
-
42
- <!-- Close button -->
43
- <button class="eng-sheet__close" aria-label="Đóng">✕</button>
44
-
45
- <!-- Content area (swappable) -->
46
- <div class="eng-sheet__content">
47
- <!-- Dynamic content injected here -->
48
- </div>
49
- </div>
50
- ```
51
-
52
- ---
53
-
54
- ## 🎨 Styling Principles
55
-
56
- ### Must-Have CSS Features
57
-
58
- | Feature | Why |
59
- |---------|-----|
60
- | `position: fixed; bottom: 0` | Anchored to viewport bottom |
61
- | `transform: translateY(100%)` → `translateY(0)` | Smooth slide-up animation |
62
- | `backdrop-filter: blur(24px)` | Glassmorphism, premium feel |
63
- | `border-radius: 20px 20px 0 0` | iOS-style rounded top corners |
64
- | `padding-bottom: env(safe-area-inset-bottom)` | Safe area for notched devices |
65
- | `z-index: 1100` | Above nav bars but below modals |
66
- | Drag handle pseudo-element | Visual signal "this is draggable" |
67
-
68
- ### Animation Timing
69
-
70
- ```css
71
- /* Open: slightly bouncy, feels natural */
72
- transition: transform 0.4s cubic-bezier(0.32, 0.72, 0, 1);
73
-
74
- /* Close: quick, decisive */
75
- transition: transform 0.25s cubic-bezier(0.4, 0, 1, 1);
76
- ```
77
-
78
- ### Responsive Rules
79
-
80
- | Viewport | Behavior |
81
- |----------|----------|
82
- | Mobile (< 768px) | Full-width, touch-optimized, swipe dismiss |
83
- | Tablet (768-1024px) | Max-width 480px, centered |
84
- | Desktop (> 1024px) | Max-width 480px, right-aligned or centered |
85
-
86
- ---
87
-
88
- ## 👆 Touch Interactions
89
-
90
- ### Swipe-to-Dismiss
91
-
92
- ```
93
- touchstart → record startY
94
- touchmove → calculate deltaY
95
- if deltaY > 0 → sheet follows finger (translateY)
96
- if deltaY > threshold (80px) → dismiss
97
- touchend → snap back or dismiss based on velocity
98
- ```
99
-
100
- **Key Rules:**
101
- - Only allow downward swipe (deltaY > 0)
102
- - Apply `will-change: transform` during drag for perf
103
- - Use velocity calculation: fast swipe = dismiss even if < 80px
104
- - Add `touch-action: none` on the drag handle only
105
-
106
- ### Focus Trap (Accessibility)
107
-
108
- ```
109
- When sheet opens:
110
- 1. Save currently focused element
111
- 2. Move focus to sheet
112
- 3. Trap Tab/Shift+Tab within sheet
113
- 4. On close: restore focus to saved element
114
- ```
115
-
116
- ---
117
-
118
- ## 📦 Content Type Patterns
119
-
120
- ### 1. Booking Form Content
121
-
122
- ```html
123
- <div class="eng-sheet__content">
124
- <div class="eng-content-booking">
125
- <h3 class="eng-content__title">📅 Đặt Lịch Khám</h3>
126
- <form data-form-type="booking" onsubmit="window.submitToGoogleSheet(event)">
127
- <input type="hidden" name="url" value="">
128
- <input type="text" name="name" placeholder="Họ tên" required>
129
- <input type="tel" name="phone" placeholder="Số điện thoại" required>
130
- <div class="eng-date-chips" id="dateChips"><!-- JS generated --></div>
131
- <div class="eng-time-slots" id="timeSlots"><!-- JS generated --></div>
132
- <select name="service"><!-- Industry-specific options --></select>
133
- <textarea name="note" placeholder="Ghi chú (tùy chọn)"></textarea>
134
- <button type="submit" class="eng-btn eng-btn--primary">Xác Nhận Đặt Lịch</button>
135
- </form>
136
- </div>
137
- </div>
138
- ```
139
-
140
- ### 2. Calendar CTA Content (Post-Submit)
141
-
142
- ```html
143
- <div class="eng-content-calendar">
144
- <div class="eng-content__icon">✅</div>
145
- <h3 class="eng-content__title">Đặt lịch thành công!</h3>
146
- <p class="eng-content__subtitle">Thêm vào lịch để không quên nhé</p>
147
- <div class="eng-calendar-buttons">
148
- <button onclick="addToGoogleCal()" class="eng-btn eng-btn--gcal">
149
- <img src="gcal-icon.svg" alt="" width="20"> Google Calendar
150
- </button>
151
- <button onclick="downloadICS()" class="eng-btn eng-btn--ics">
152
- 📥 Apple Calendar / Khác
153
- </button>
154
- </div>
155
- <p class="eng-content__benefit">💡 Lịch sẽ tự nhắc bạn — hoàn toàn miễn phí</p>
156
- </div>
157
- ```
158
-
159
- ### 3. Lead Capture Content
160
-
161
- ```html
162
- <div class="eng-content-lead">
163
- <div class="eng-content__icon">🎁</div>
164
- <h3 class="eng-content__title">Nhận tài liệu miễn phí</h3>
165
- <p class="eng-content__subtitle">Để lại SĐT, chúng tôi gửi ngay</p>
166
- <form data-form-type="lead" onsubmit="window.submitToGoogleSheet(event)">
167
- <input type="hidden" name="url" value="">
168
- <input type="tel" name="phone" placeholder="Số điện thoại" required>
169
- <button type="submit" class="eng-btn eng-btn--primary">Gửi Cho Tôi</button>
170
- </form>
171
- </div>
172
- ```
173
-
174
- ### 4. Flash Sale Content
175
-
176
- ```html
177
- <div class="eng-content-promo">
178
- <div class="eng-content__icon">🔥</div>
179
- <h3 class="eng-content__title">Ưu đãi đặc biệt!</h3>
180
- <div class="eng-countdown" id="countdown">
181
- <span class="eng-countdown__unit"><span id="hours">00</span>h</span>
182
- <span class="eng-countdown__unit"><span id="minutes">00</span>m</span>
183
- <span class="eng-countdown__unit"><span id="seconds">00</span>s</span>
184
- </div>
185
- <p class="eng-content__subtitle">Giảm 30% khi đặt lịch hôm nay</p>
186
- <a href="#booking" class="eng-btn eng-btn--primary">Đặt Ngay →</a>
187
- <button class="eng-btn eng-btn--outline" onclick="addDeadlineToCalendar()">
188
- 📅 Nhắc tôi trước khi hết hạn
189
- </button>
190
- </div>
191
- ```
192
-
193
- ### 5. Survey / Feedback Content
194
-
195
- ```html
196
- <div class="eng-content-survey">
197
- <h3 class="eng-content__title">⭐ Đánh giá trải nghiệm</h3>
198
- <div class="eng-rating" id="starRating">
199
- <button data-rating="1" aria-label="1 sao">⭐</button>
200
- <button data-rating="2" aria-label="2 sao">⭐</button>
201
- <button data-rating="3" aria-label="3 sao">⭐</button>
202
- <button data-rating="4" aria-label="4 sao">⭐</button>
203
- <button data-rating="5" aria-label="5 sao">⭐</button>
204
- </div>
205
- <textarea name="feedback" placeholder="Chia sẻ thêm (tùy chọn)"></textarea>
206
- <button class="eng-btn eng-btn--primary" onclick="submitSurvey()">Gửi Đánh Giá</button>
207
- </div>
208
- ```
209
-
210
- ### 6. Chat / Contact CTA
211
-
212
- ```html
213
- <div class="eng-content-chat">
214
- <p class="eng-content__title">💬 Cần tư vấn?</p>
215
- <div class="eng-chat-buttons">
216
- <a href="https://zalo.me/PHONE" class="eng-btn eng-btn--zalo">Zalo</a>
217
- <a href="tel:PHONE" class="eng-btn eng-btn--phone">📞 Gọi ngay</a>
218
- <a href="https://m.me/PAGE" class="eng-btn eng-btn--messenger">Messenger</a>
219
- </div>
220
- </div>
221
- ```
222
-
223
- ---
224
-
225
- ## 🔄 Multi-Step Flow
226
-
227
- For complex interactions (e.g., booking → success → calendar CTA):
228
-
229
- ```javascript
230
- // Step 1: Show booking form
231
- sheet.setContent(bookingFormHTML);
232
- sheet.show();
233
-
234
- // Step 2: On form success → swap to calendar CTA
235
- onFormSuccess(() => {
236
- sheet.setContent(calendarCTAHTML);
237
- // Track transition
238
- trackEngagement('cro_booking_submit', { service: formData.service });
239
- });
240
-
241
- // Step 3: On calendar add → show thank you + close
242
- onCalendarAdd(() => {
243
- trackEngagement('cro_calendar_add', { type: 'gcal' });
244
- sheet.hide();
245
- showToast('success', 'Đã thêm vào lịch! 🎉');
246
- });
247
- ```
248
-
249
- ---
250
-
251
- ## ❌ Anti-Patterns
252
-
253
- | ❌ Don't | ✅ Do |
254
- |----------|------|
255
- | Nest sheets inside sheets | One sheet at a time, swap content |
256
- | Hardcode content | Use setContent() for flexibility |
257
- | Forget backdrop for full sheets | Add backdrop + blur for full-size |
258
- | Skip keyboard navigation | Trap Tab key, close on Escape |
259
- | Ignore safe-area-inset | Always pad for notched phones |
260
- | Use `overflow: hidden` on body | Use `overscroll-behavior: contain` on sheet |
261
- | Animate with JS | Use CSS transitions + `requestAnimationFrame` |