codymaster 5.2.0 → 7.0.1

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 (380) 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/mcp-context-server.js +1 -1
  59. package/dist/middleware/metrics.js +30 -0
  60. package/dist/middleware/security-headers.js +14 -0
  61. package/dist/realtime/event-bus.js +29 -0
  62. package/dist/realtime/ws-hub.js +91 -0
  63. package/dist/schemas/task-schema.js +48 -0
  64. package/dist/schemas/validate.js +18 -0
  65. package/dist/skills-lock.js +96 -0
  66. package/dist/sprint-pipeline.js +26 -0
  67. package/dist/storage/index.js +21 -0
  68. package/dist/storage/repos/activity-repo.js +46 -0
  69. package/dist/storage/repos/message-repo.js +39 -0
  70. package/dist/storage/repos/project-repo.js +56 -0
  71. package/dist/storage/repos/task-repo.js +142 -0
  72. package/dist/storage/services/project-service.js +49 -0
  73. package/dist/storage/services/task-service.js +97 -0
  74. package/dist/storage/sqlite.js +113 -0
  75. package/dist/tier-classify.js +131 -0
  76. package/dist/ui/onboarding.js +51 -15
  77. package/dist/utils/cli-utils.js +7 -2
  78. package/dist/utils/design-taste.js +108 -0
  79. package/dist/utils/output-compress.js +143 -0
  80. package/dist/vibecoding-index.js +126 -0
  81. package/package.json +27 -4
  82. package/public/dashboard/app.js +52 -1
  83. package/scripts/build-skills-lock.mjs +88 -0
  84. package/scripts/build-skills.mjs +187 -28
  85. package/scripts/compress-skill.mjs +73 -0
  86. package/scripts/deprecate-skill.mjs +72 -0
  87. package/scripts/install.sh +170 -0
  88. package/scripts/mcp-bridge.js +2 -2
  89. package/scripts/postinstall.js +54 -287
  90. package/scripts/release.sh +126 -0
  91. package/scripts/update-changelog.sh +88 -0
  92. package/scripts/validate-skills.mjs +101 -4
  93. package/skills/_shared/SKILL_TEMPLATE.md +62 -0
  94. package/skills/cm-autopilot/scripts/autopilot.py +19 -2
  95. package/skills/cm-brainstorm-idea/SKILL.md +9 -0
  96. package/skills/cm-clean-code/SKILL.md +20 -0
  97. package/skills/cm-code-review/SKILL.md +21 -0
  98. package/skills/cm-codeintell/SKILL.md +9 -0
  99. package/skills/cm-conductor-worktrees/SKILL.archive.md +28 -0
  100. package/skills/cm-conductor-worktrees/SKILL.md +17 -19
  101. package/skills/cm-continuity/SKILL.md +9 -0
  102. package/skills/cm-dashboard/SKILL.archive.md +15 -0
  103. package/skills/cm-dashboard/SKILL.md +20 -9
  104. package/skills/cm-dashboard/ui/app.js +9 -1
  105. package/skills/cm-debugging/SKILL.md +9 -0
  106. package/skills/cm-design-studio/SKILL.archive.md +34 -0
  107. package/skills/cm-design-studio/SKILL.md +17 -25
  108. package/skills/cm-design-system/SKILL.md +1 -0
  109. package/skills/cm-engineering-meta/SKILL.archive.md +73 -0
  110. package/skills/cm-engineering-meta/SKILL.md +16 -63
  111. package/skills/cm-execution/SKILL.md +98 -0
  112. package/skills/cm-git-worktrees/SKILL.archive.md +157 -0
  113. package/skills/cm-git-worktrees/SKILL.md +15 -146
  114. package/skills/cm-identity-guard/SKILL.md +8 -0
  115. package/skills/cm-planning/SKILL.md +63 -92
  116. package/skills/cm-post-deploy-canary/SKILL.archive.md +22 -0
  117. package/skills/cm-post-deploy-canary/SKILL.md +17 -13
  118. package/skills/cm-qa-visual-cli/SKILL.archive.md +22 -0
  119. package/skills/cm-qa-visual-cli/SKILL.md +16 -12
  120. package/skills/cm-quality-gate/SKILL.md +38 -0
  121. package/skills/cm-safe-deploy/SKILL.md +9 -0
  122. package/skills/cm-second-opinion-cli/SKILL.archive.md +23 -0
  123. package/skills/cm-second-opinion-cli/SKILL.md +17 -14
  124. package/skills/cm-secret-shield/SKILL.archive.md +580 -0
  125. package/skills/cm-secret-shield/SKILL.md +15 -569
  126. package/skills/cm-security-gate/SKILL.archive.md +239 -0
  127. package/skills/cm-security-gate/SKILL.md +15 -228
  128. package/skills/cm-skill-health/SKILL.archive.md +83 -0
  129. package/skills/cm-skill-health/SKILL.md +16 -73
  130. package/skills/cm-skill-index/SKILL.md +8 -0
  131. package/skills/cm-skill-mastery/SKILL.archive.md +156 -0
  132. package/skills/cm-skill-mastery/SKILL.md +16 -146
  133. package/skills/cm-skill-search/SKILL.archive.md +49 -0
  134. package/skills/cm-skill-search/SKILL.md +17 -40
  135. package/skills/cm-skill-share/SKILL.archive.md +58 -0
  136. package/skills/cm-skill-share/SKILL.md +17 -49
  137. package/skills/cm-sprint-bus/SKILL.md +9 -0
  138. package/skills/cm-start/SKILL.md +17 -0
  139. package/skills/cm-tdd/SKILL.md +19 -0
  140. package/skills/cm-terminal/SKILL.md +15 -0
  141. package/skills/cm-test-gate/SKILL.archive.md +245 -0
  142. package/skills/cm-test-gate/SKILL.md +15 -234
  143. package/skills/cm-ui-preview/SKILL.archive.md +153 -0
  144. package/skills/cm-ui-preview/SKILL.md +16 -143
  145. package/skills/cm-ux-master/cli/uxmaster/commands/mcp.py +1 -1
  146. package/skills/cm-ux-master/mcp/mcp-config.json +1 -1
  147. package/skills/cm-ux-master/mcp/server.py +2 -2
  148. package/skills/profiles/design.txt +1 -1
  149. package/skills/profiles/full.txt +0 -10
  150. package/skills/profiles/growth.txt +8 -8
  151. package/skills/profiles/knowledge.txt +1 -1
  152. package/skills/profiles/top35.json +41 -0
  153. package/adapters/antigravity.js +0 -15
  154. package/adapters/claude-code.js +0 -17
  155. package/adapters/cursor.js +0 -16
  156. package/skills/cm-ads-tracker/SKILL.md +0 -401
  157. package/skills/cm-ads-tracker/evals/evals.json +0 -55
  158. package/skills/cm-ads-tracker/references/gtm-architecture.md +0 -321
  159. package/skills/cm-ads-tracker/references/industry-events.md +0 -294
  160. package/skills/cm-ads-tracker/references/platforms-api.md +0 -238
  161. package/skills/cm-ads-tracker/templates/capi-payload.md +0 -79
  162. package/skills/cm-ads-tracker/templates/datalayer-push.js +0 -104
  163. package/skills/cm-ads-tracker/templates/gtm-variables.js +0 -56
  164. package/skills/cm-auto-publisher/SKILL.md +0 -81
  165. package/skills/cm-booking-calendar/SKILL.md +0 -521
  166. package/skills/cm-booking-calendar/references/industry-patterns.md +0 -527
  167. package/skills/cm-booking-calendar/templates/booking-form.css +0 -626
  168. package/skills/cm-booking-calendar/templates/booking-form.html +0 -477
  169. package/skills/cm-booking-calendar/templates/calendar-engine.js +0 -419
  170. package/skills/cm-booking-calendar/templates/calendar-export.js +0 -395
  171. package/skills/cm-booking-calendar/templates/reminder-config.js +0 -629
  172. package/skills/cm-content-factory/.content-factory-state.json +0 -132
  173. package/skills/cm-content-factory/.git 2/logs/refs/heads/main +0 -1
  174. package/skills/cm-content-factory/.git 2/logs/refs/remotes/origin/main +0 -1
  175. package/skills/cm-content-factory/.git 2/objects/02/fb0956734b5f8ba3f918b7defd04a89cfe0076 +0 -0
  176. package/skills/cm-content-factory/.git 2/objects/08/1e129d75dc6feac6c02037272e6bd1a04e3324 +0 -0
  177. package/skills/cm-content-factory/.git 2/objects/0c/5393416f3c5e01c9a655a802bff0dd52f76f0a +0 -0
  178. package/skills/cm-content-factory/.git 2/objects/10/0b9be46978a946a77188f68be725098a122001 +0 -0
  179. package/skills/cm-content-factory/.git 2/objects/10/cf041167fc9843610eb3d90259ef3396315fdc +0 -0
  180. package/skills/cm-content-factory/.git 2/objects/12/5e19538dd6e1338ffe74f6c4c165b00435bf48 +0 -0
  181. package/skills/cm-content-factory/.git 2/objects/16/a9b9d0088d5c1347628b45a2620b479d8ad57c +0 -0
  182. package/skills/cm-content-factory/.git 2/objects/17/8c2a9ef93c33ae4eec9d58e82321f9229843a1 +0 -0
  183. package/skills/cm-content-factory/.git 2/objects/25/397ae41d09104d763bdcac2695209d85cdea89 +0 -0
  184. package/skills/cm-content-factory/.git 2/objects/2f/a836b7947f2d458e1f639788bf4bb0983a3305 +0 -0
  185. package/skills/cm-content-factory/.git 2/objects/3a/baaaf0a1c0909c0828335791557125fba911e0 +0 -0
  186. package/skills/cm-content-factory/.git 2/objects/42/2924221b81f5ce3c4e4daac9a64a24f9b01f9a +0 -0
  187. package/skills/cm-content-factory/.git 2/objects/42/ec0ce707447dc11446a34c9995fb8533801731 +0 -0
  188. package/skills/cm-content-factory/.git 2/objects/46/e43ce92866d56ce74b1d750db307cfe6154a15 +0 -0
  189. package/skills/cm-content-factory/.git 2/objects/48/5e41b633c63f55b8277bcc59f44f67681f671a +0 -0
  190. package/skills/cm-content-factory/.git 2/objects/49/49c596a3a89fa240642acd95dd3258e261eb09 +0 -0
  191. package/skills/cm-content-factory/.git 2/objects/50/9d42d8412ef8eaf7f7e138476bac2e4d10ce60 +0 -0
  192. package/skills/cm-content-factory/.git 2/objects/55/0c8c389d981b463ef849aeb792d8be3ccb6ec8 +0 -0
  193. package/skills/cm-content-factory/.git 2/objects/5d/82d3b18410cdda3ace3677436f0cb599dbe2d2 +0 -0
  194. package/skills/cm-content-factory/.git 2/objects/60/0617c58e871a38b33bf29e282d132bb3c381ad +0 -0
  195. package/skills/cm-content-factory/.git 2/objects/6a/8369a99c687b7245c92ffaf0e0f0dab9014504 +0 -0
  196. package/skills/cm-content-factory/.git 2/objects/79/bea435d40ab531c1aaf6be0432c6a5b7aaed21 +0 -0
  197. package/skills/cm-content-factory/.git 2/objects/7e/5ebd79251c2f14e4aceb86c74b6b6daae6b500 +0 -0
  198. package/skills/cm-content-factory/.git 2/objects/81/98a822a60178d6d5023ddb3e222cddf048742e +0 -0
  199. package/skills/cm-content-factory/.git 2/objects/86/0a0e1943dfe53411d2e499a1f16f46a96ef758 +0 -0
  200. package/skills/cm-content-factory/.git 2/objects/86/971fb55fdc081fdbae52376f0f13e57a4e9b04 +0 -0
  201. package/skills/cm-content-factory/.git 2/objects/88/b89dd609a0a03f8d4fe8bfde20d5b8fc1d326d +0 -0
  202. package/skills/cm-content-factory/.git 2/objects/90/8737edb6b7809e32cc01590b4e08ba42a9d40d +0 -0
  203. package/skills/cm-content-factory/.git 2/objects/93/d5a8a9a7d4fb7f11491cb596a6880528725118 +0 -0
  204. package/skills/cm-content-factory/.git 2/objects/98/46a2ab81d0c3b3eb00ef88fc56989aa7e9f316 +0 -0
  205. package/skills/cm-content-factory/.git 2/objects/9b/d8dd1e49cf274eaf9c555f3ab39dce7af5715e +0 -0
  206. package/skills/cm-content-factory/.git 2/objects/a1/13329fb0cec96ae78b222d33a24c3b5bc7fa1f +0 -0
  207. package/skills/cm-content-factory/.git 2/objects/a9/e6effe626e8a3aea3a8fc3364b492191c6e7d0 +0 -0
  208. package/skills/cm-content-factory/.git 2/objects/ad/6de7e48d9782cca9353d1ff0aa1aab7fe1df85 +0 -0
  209. package/skills/cm-content-factory/.git 2/objects/af/54ae316f771ff692e299ffcd8bf2f06b413b59 +0 -0
  210. package/skills/cm-content-factory/.git 2/objects/b0/4cb8b0b00dad633e731c1472161419e738d674 +0 -0
  211. package/skills/cm-content-factory/.git 2/objects/b3/094abb0b9ed46419b269e4a4e36a459690e3b0 +0 -0
  212. package/skills/cm-content-factory/.git 2/objects/b9/435c5d4baac2cfc5c83009ddd27b46b60db5f1 +0 -0
  213. package/skills/cm-content-factory/.git 2/objects/ba/5da17dbaec5ec2dcfdfd126aead518d1171d5c +0 -0
  214. package/skills/cm-content-factory/.git 2/objects/c0/bf58703aa258ba5dd63083bebaec8f223d844c +0 -0
  215. package/skills/cm-content-factory/.git 2/objects/c4/701a34edf1fc1bad58ccc57bd03f9426acb59a +0 -0
  216. package/skills/cm-content-factory/.git 2/objects/c7/5ccce9a4e5cc74d9b3174550cf6d993ca43638 +0 -0
  217. package/skills/cm-content-factory/.git 2/objects/c7/710d59b5a35b0f1f0a0399386643a0bd94c929 +0 -0
  218. package/skills/cm-content-factory/.git 2/objects/d1/fe58237112e953e5fec52da22cf38e08be3df9 +0 -5
  219. package/skills/cm-content-factory/.git 2/objects/d2/2bbe9fd2f74c95bc5583e803f5e435f1e2cd86 +0 -0
  220. package/skills/cm-content-factory/.git 2/objects/d7/e72852ea2bff74581dbf247d400120086229f4 +0 -0
  221. package/skills/cm-content-factory/.git 2/objects/d8/d4c3b5553e4fd72807e1d4b49ef07d9ef3ac35 +0 -0
  222. package/skills/cm-content-factory/.git 2/objects/dc/75050c2876f6a02ae2a53a3c886f395b622977 +0 -0
  223. package/skills/cm-content-factory/.git 2/objects/ee/e8546f95acec500187c08a28a8b9ee02db0dec +0 -0
  224. package/skills/cm-content-factory/.git 2/objects/ef/263c059208b416c2146434f10cb2b9fabcba16 +0 -0
  225. package/skills/cm-content-factory/.git 2/objects/f3/ae597e84d9a59b88acd21c99bde2eaf686d785 +0 -0
  226. package/skills/cm-content-factory/.git 2/objects/f3/f6f5673c821d3d8e76fa267a9e882e7a5387ea +0 -0
  227. package/skills/cm-content-factory/.git 2/objects/f9/6e6d0ad02624dd11d5848594d056caef7a5e8b +0 -0
  228. package/skills/cm-content-factory/.git 2/objects/ff/278988fc1edf0db3abcf18de795f4cc0b4f3e1 +0 -0
  229. package/skills/cm-content-factory/.git 2/refs/heads/main +0 -1
  230. package/skills/cm-content-factory/.git 2/refs/remotes/origin/main +0 -1
  231. package/skills/cm-content-factory/.pytest_cache 2/v/cache/nodeids +0 -76
  232. package/skills/cm-content-factory/.pytest_cache 2/v/cache/stepwise +0 -1
  233. package/skills/cm-content-factory/AGENTS.md +0 -61
  234. package/skills/cm-content-factory/CLAUDE.md +0 -63
  235. package/skills/cm-content-factory/CURSOR.md +0 -43
  236. package/skills/cm-content-factory/Content Factory.zip +0 -0
  237. package/skills/cm-content-factory/SKILL.md +0 -416
  238. package/skills/cm-content-factory/cf +0 -313
  239. package/skills/cm-content-factory/config.schema.json +0 -397
  240. package/skills/cm-content-factory/dashboard/app.js +0 -556
  241. package/skills/cm-content-factory/dashboard/index.html +0 -397
  242. package/skills/cm-content-factory/dashboard/style.css +0 -1211
  243. package/skills/cm-content-factory/examples/01-real-estate.config.json +0 -146
  244. package/skills/cm-content-factory/examples/02-personal-finance.config.json +0 -146
  245. package/skills/cm-content-factory/examples/03-health-wellness.config.json +0 -147
  246. package/skills/cm-content-factory/examples/04-saas-software.config.json +0 -147
  247. package/skills/cm-content-factory/examples/05-legal-services.config.json +0 -147
  248. package/skills/cm-content-factory/examples/06-insurance.config.json +0 -146
  249. package/skills/cm-content-factory/examples/07-ecommerce-dropship.config.json +0 -146
  250. package/skills/cm-content-factory/examples/08-online-education.config.json +0 -147
  251. package/skills/cm-content-factory/examples/09-crypto-defi.config.json +0 -147
  252. package/skills/cm-content-factory/examples/10-beauty-skincare.config.json +0 -147
  253. package/skills/cm-content-factory/examples/11-home-services.config.json +0 -146
  254. package/skills/cm-content-factory/examples/12-dental-clinic.config.json +0 -147
  255. package/skills/cm-content-factory/examples/13-pet-care.config.json +0 -147
  256. package/skills/cm-content-factory/examples/14-travel-hospitality.config.json +0 -147
  257. package/skills/cm-content-factory/examples/15-ai-automation.config.json +0 -147
  258. package/skills/cm-content-factory/examples/16-wedding-events.config.json +0 -147
  259. package/skills/cm-content-factory/examples/17-fitness-coaching.config.json +0 -148
  260. package/skills/cm-content-factory/examples/18-cybersecurity.config.json +0 -147
  261. package/skills/cm-content-factory/examples/19-food-restaurant.config.json +0 -148
  262. package/skills/cm-content-factory/examples/20-solar-energy.config.json +0 -147
  263. package/skills/cm-content-factory/examples/fitness-blog.config.json +0 -116
  264. package/skills/cm-content-factory/examples/tech-blog.config.json +0 -107
  265. package/skills/cm-content-factory/extensions/EXTENSION_GUIDE.md +0 -72
  266. package/skills/cm-content-factory/extensions/hooks.py +0 -126
  267. package/skills/cm-content-factory/extensions/openclaw_adapter.py +0 -132
  268. package/skills/cm-content-factory/landing/docs/content/changelog.md +0 -36
  269. package/skills/cm-content-factory/landing/docs/content/deployment.md +0 -46
  270. package/skills/cm-content-factory/landing/docs/content/execution-flow.md +0 -67
  271. package/skills/cm-content-factory/landing/docs/content/memory-system.md +0 -38
  272. package/skills/cm-content-factory/landing/docs/content/openspace.md +0 -27
  273. package/skills/cm-content-factory/landing/docs/content/use-cases.md +0 -26
  274. package/skills/cm-content-factory/landing/docs/content/v5-intro.md +0 -28
  275. package/skills/cm-content-factory/landing/docs/index.html +0 -240
  276. package/skills/cm-content-factory/landing/index.html +0 -680
  277. package/skills/cm-content-factory/landing/script.js +0 -143
  278. package/skills/cm-content-factory/landing/style.css +0 -1216
  279. package/skills/cm-content-factory/landing/translations.js +0 -508
  280. package/skills/cm-content-factory/logs/events.jsonl +0 -11
  281. package/skills/cm-content-factory/profiles/_template.profile.json +0 -231
  282. package/skills/cm-content-factory/profiles/finance.profile.json +0 -278
  283. package/skills/cm-content-factory/profiles/legal.profile.json +0 -263
  284. package/skills/cm-content-factory/profiles/medical-research.profile.json +0 -321
  285. package/skills/cm-content-factory/profiles/technology.profile.json +0 -275
  286. package/skills/cm-content-factory/scripts/agent_dispatcher.py +0 -266
  287. package/skills/cm-content-factory/scripts/audit.py +0 -106
  288. package/skills/cm-content-factory/scripts/dashboard_server.py +0 -225
  289. package/skills/cm-content-factory/scripts/deploy.py +0 -146
  290. package/skills/cm-content-factory/scripts/extract.py +0 -132
  291. package/skills/cm-content-factory/scripts/landing_generator.py +0 -459
  292. package/skills/cm-content-factory/scripts/memory.py +0 -521
  293. package/skills/cm-content-factory/scripts/monetize.py +0 -239
  294. package/skills/cm-content-factory/scripts/pipeline.py +0 -357
  295. package/skills/cm-content-factory/scripts/plan.py +0 -163
  296. package/skills/cm-content-factory/scripts/publish.py +0 -145
  297. package/skills/cm-content-factory/scripts/research.py +0 -337
  298. package/skills/cm-content-factory/scripts/scaffold.py +0 -464
  299. package/skills/cm-content-factory/scripts/scoreboard.py +0 -336
  300. package/skills/cm-content-factory/scripts/seo.py +0 -90
  301. package/skills/cm-content-factory/scripts/state_manager.py +0 -320
  302. package/skills/cm-content-factory/scripts/token_manager.py +0 -268
  303. package/skills/cm-content-factory/scripts/validate.py +0 -221
  304. package/skills/cm-content-factory/scripts/wizard.py +0 -329
  305. package/skills/cm-content-factory/scripts/write.py +0 -93
  306. package/skills/cm-content-factory/sites/docs-site/src/assets/houston.webp +0 -0
  307. package/skills/cm-content-factory/sites/docs-site/src/content/docs/architecture.md +0 -90
  308. package/skills/cm-content-factory/sites/docs-site/src/content/docs/data-flow.md +0 -54
  309. package/skills/cm-content-factory/sites/docs-site/src/content/docs/deployment.md +0 -38
  310. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/index.md +0 -65
  311. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/lc-content-lifecycle.md +0 -48
  312. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/seq-write-mode.md +0 -39
  313. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/uj-first-batch.md +0 -42
  314. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/wf-content-pipeline.md +0 -51
  315. package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/wf-learning-cycle.md +0 -52
  316. package/skills/cm-content-factory/sites/docs-site/src/content/docs/getting-started/configuration.md +0 -86
  317. package/skills/cm-content-factory/sites/docs-site/src/content/docs/getting-started/installation.md +0 -80
  318. package/skills/cm-content-factory/sites/docs-site/src/content/docs/getting-started/intro.md +0 -58
  319. package/skills/cm-content-factory/sites/docs-site/src/content/docs/index.md +0 -102
  320. package/skills/cm-content-factory/sites/docs-site/src/content/docs/jtbd/index.md +0 -45
  321. package/skills/cm-content-factory/sites/docs-site/src/content/docs/jtbd/optimize-seo.md +0 -29
  322. package/skills/cm-content-factory/sites/docs-site/src/content/docs/jtbd/scale-content-production.md +0 -55
  323. package/skills/cm-content-factory/sites/docs-site/src/content/docs/jtbd/standardize-quality.md +0 -29
  324. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/buyer-cmo-huong.md +0 -41
  325. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/buyer-content-lead-khoa.md +0 -40
  326. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/index.md +0 -56
  327. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/user-content-manager-lan.md +0 -46
  328. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/user-seo-minh.md +0 -45
  329. package/skills/cm-content-factory/sites/docs-site/src/content/docs/personas/user-writer-tu.md +0 -45
  330. package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/content-pipeline.md +0 -108
  331. package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/index.md +0 -22
  332. package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/memory-system.md +0 -52
  333. package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/seo-optimization.md +0 -58
  334. package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/troubleshooting-guide.md +0 -92
  335. package/skills/cm-content-factory/sites/docs-site/src/styles/custom.css +0 -575
  336. package/skills/cm-content-factory/tests/conftest.py +0 -66
  337. package/skills/cm-content-factory/tests/test_agent_dispatcher.py +0 -125
  338. package/skills/cm-content-factory/tests/test_memory.py +0 -128
  339. package/skills/cm-content-factory/tests/test_pipeline.py +0 -107
  340. package/skills/cm-content-factory/tests/test_research.py +0 -56
  341. package/skills/cm-content-factory/tests/test_state_manager.py +0 -131
  342. package/skills/cm-content-factory/tests/test_token_manager.py +0 -110
  343. package/skills/cm-content-factory/tests/test_wizard.py +0 -121
  344. package/skills/cm-cro-methodology/SKILL.md +0 -290
  345. package/skills/cm-cro-methodology/references/COPYWRITING.md +0 -178
  346. package/skills/cm-cro-methodology/references/OBJECTIONS.md +0 -135
  347. package/skills/cm-cro-methodology/references/PERSUASION.md +0 -158
  348. package/skills/cm-cro-methodology/references/RESEARCH.md +0 -220
  349. package/skills/cm-cro-methodology/references/funnel-analysis.md +0 -365
  350. package/skills/cm-cro-methodology/references/testing-methodology.md +0 -330
  351. package/skills/cm-google-form/SKILL.md +0 -266
  352. package/skills/cm-google-form/templates/apps-script.js +0 -55
  353. package/skills/cm-google-form/templates/form-markup.html +0 -110
  354. package/skills/cm-google-form/templates/form-submit.js +0 -201
  355. package/skills/cm-google-form/templates/toast.css +0 -152
  356. package/skills/cm-growth-hacking/SKILL.md +0 -282
  357. package/skills/cm-growth-hacking/bottom-sheet-engine.md +0 -261
  358. package/skills/cm-growth-hacking/calendar-integration.md +0 -264
  359. package/skills/cm-growth-hacking/references/engagement-patterns.md +0 -346
  360. package/skills/cm-growth-hacking/templates/bottom-sheet.css +0 -528
  361. package/skills/cm-growth-hacking/templates/bottom-sheet.js +0 -269
  362. package/skills/cm-growth-hacking/templates/calendar-cta.js +0 -213
  363. package/skills/cm-growth-hacking/templates/tracking-events.js +0 -211
  364. package/skills/cm-growth-hacking/templates/trigger-manager.js +0 -254
  365. package/skills/cm-growth-hacking/tracking-events.md +0 -246
  366. package/skills/cm-growth-hacking/trigger-system.md +0 -342
  367. package/skills/cm-jtbd/SKILL.md +0 -98
  368. package/skills/cm-notebooklm/SKILL.md +0 -156
  369. package/skills/cm-notebooklm/references/command_reference.md +0 -94
  370. package/skills/cm-notebooklm/references/workflows.md +0 -60
  371. package/skills/cm-notebooklm/resources/knowledge_sources.md +0 -106
  372. package/skills/cm-notebooklm/scripts/brain-sync.sh +0 -453
  373. package/skills/cm-notebooklm/scripts/graduate_wisdom.py +0 -101
  374. package/skills/cm-readit/SKILL.md +0 -289
  375. package/skills/cm-readit/audio-player.md +0 -206
  376. package/skills/cm-readit/examples/blog-reader.js +0 -352
  377. package/skills/cm-readit/examples/voice-cro.js +0 -390
  378. package/skills/cm-readit/tts-engine.md +0 -262
  379. package/skills/cm-readit/ui-patterns.md +0 -362
  380. 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` |