arkaos 4.26.0 → 4.28.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 (412) hide show
  1. package/README.md +7 -5
  2. package/THE-ARKAOS-GUIDE.md +7 -7
  3. package/VERSION +1 -1
  4. package/arka/SKILL.md +1 -1
  5. package/arka/skills/human-writing/SKILL.md +106 -0
  6. package/arka/skills/human-writing/references/anti-slop-phrases.md +131 -0
  7. package/arka/skills/human-writing/references/checklist.md +66 -0
  8. package/arka/skills/human-writing/references/content-refresh.md +38 -0
  9. package/arka/skills/human-writing/references/plain-english-alternatives.md +394 -0
  10. package/arka/skills/human-writing/references/pt-pt-anti-slop.md +82 -0
  11. package/arka/skills/human-writing/references/stop-slop.LICENSE +21 -0
  12. package/arka/skills/human-writing/references/structural-patterns.md +151 -0
  13. package/config/claude-agents/content-marketer.md +1 -1
  14. package/config/claude-agents/content-strategist.md +1 -1
  15. package/config/claude-agents/eduardo-copy.md +13 -0
  16. package/config/claude-agents/lifecycle-marketer.md +50 -0
  17. package/config/claude-agents/pr-partnerships.md +50 -0
  18. package/config/claude-agents/product-marketer.md +50 -0
  19. package/config/claude-agents/repurpose-distributor.md +1 -1
  20. package/config/claude-agents/sales-copywriter.md +1 -1
  21. package/config/claude-agents/scriptwriter.md +1 -1
  22. package/config/claude-agents/viral-engineer.md +1 -1
  23. package/config/evals/community.yaml +137 -0
  24. package/config/evals/content.yaml +298 -0
  25. package/config/evals/landing.yaml +927 -0
  26. package/config/evals/marketing.yaml +3836 -0
  27. package/config/evals/saas.yaml +616 -0
  28. package/config/evals/sales.yaml +437 -0
  29. package/config/skills-curated.yaml +2 -2
  30. package/config/skills-provenance.yaml +194 -21
  31. package/core/registry/generator.py +7 -0
  32. package/departments/community/SKILL.md +1 -0
  33. package/departments/community/skills/community-marketing/SKILL.md +200 -0
  34. package/departments/content/SKILL.md +1 -0
  35. package/departments/content/agents/content-strategist.yaml +1 -0
  36. package/departments/content/agents/repurpose-distributor.yaml +1 -0
  37. package/departments/content/agents/scriptwriter.yaml +1 -0
  38. package/departments/content/agents/viral-engineer.yaml +1 -0
  39. package/departments/content/skills/image-create/SKILL.md +375 -0
  40. package/departments/content/skills/image-create/references/ai-image-prompting.md +229 -0
  41. package/departments/content/skills/video-produce/SKILL.md +220 -0
  42. package/departments/content/skills/video-produce/references/ai-video-prompting.md +175 -0
  43. package/departments/content/skills/video-produce/references/edit-anatomy.md +84 -0
  44. package/departments/landing/SKILL.md +3 -0
  45. package/departments/landing/agents/sales-copywriter.yaml +1 -0
  46. package/departments/landing/skills/affiliate-bridge/SKILL.md +291 -5
  47. package/departments/landing/skills/affiliate-bridge/references/affiliate-programs.md +167 -0
  48. package/departments/landing/skills/affiliate-bridge/references/program-examples.md +143 -0
  49. package/departments/landing/skills/copy-framework/SKILL.md +241 -0
  50. package/departments/landing/skills/copy-framework/references/copy-frameworks.md +344 -0
  51. package/departments/landing/skills/copy-framework/references/natural-transitions.md +272 -0
  52. package/departments/landing/skills/lead-magnet/SKILL.md +337 -0
  53. package/departments/landing/skills/lead-magnet/references/benchmarks.md +129 -0
  54. package/departments/landing/skills/lead-magnet/references/format-guide.md +196 -0
  55. package/departments/landing/skills/offer-create/SKILL.md +105 -8
  56. package/departments/landing/skills/offer-create/references/bonus-stacking.md +150 -0
  57. package/departments/landing/skills/offer-create/references/examples.md +215 -0
  58. package/departments/landing/skills/offer-create/references/guarantee-design.md +172 -0
  59. package/departments/landing/skills/offer-create/references/offer-anatomy.md +203 -0
  60. package/departments/landing/skills/offer-create/references/offer-formats.md +240 -0
  61. package/departments/landing/skills/offer-create/references/scarcity-urgency.md +175 -0
  62. package/departments/landing/skills/offer-create/references/value-equation.md +134 -0
  63. package/departments/landing/skills/optimize-page/SKILL.md +185 -4
  64. package/departments/landing/skills/optimize-page/references/experiments.md +248 -0
  65. package/departments/landing/skills/optimize-page/references/form.md +422 -0
  66. package/departments/landing/skills/page-architect/SKILL.md +373 -5
  67. package/departments/landing/skills/page-architect/references/mermaid-templates.md +216 -0
  68. package/departments/landing/skills/page-architect/references/navigation-patterns.md +305 -0
  69. package/departments/landing/skills/page-architect/references/site-type-templates.md +293 -0
  70. package/departments/landing/skills/popup-design/SKILL.md +481 -0
  71. package/departments/landing/skills/signup-optimize/SKILL.md +385 -0
  72. package/departments/marketing/SKILL.md +22 -1
  73. package/departments/marketing/agents/content-marketer.yaml +1 -0
  74. package/departments/marketing/agents/growth-marketing/lifecycle-marketer.yaml +75 -0
  75. package/departments/marketing/agents/growth-marketing/pr-partnerships.yaml +74 -0
  76. package/departments/marketing/agents/growth-marketing/product-marketer.yaml +79 -0
  77. package/departments/marketing/agents/marketing-director.yaml +1 -0
  78. package/departments/marketing/skills/ab-test/SKILL.md +322 -3
  79. package/departments/marketing/skills/ab-test/references/sample-size-guide.md +263 -0
  80. package/departments/marketing/skills/ab-test/references/test-templates.md +277 -0
  81. package/departments/marketing/skills/ad-creative/SKILL.md +451 -0
  82. package/departments/marketing/skills/ad-creative/references/creative-review-page.md +106 -0
  83. package/departments/marketing/skills/ad-creative/references/creative-roadmap.md +118 -0
  84. package/departments/marketing/skills/ad-creative/references/generative-tools.md +637 -0
  85. package/departments/marketing/skills/ad-creative/references/hook-system.md +115 -0
  86. package/departments/marketing/skills/ad-creative/references/imessage-video-ads.md +201 -0
  87. package/departments/marketing/skills/ad-creative/references/motion-video-ads.md +126 -0
  88. package/departments/marketing/skills/ad-creative/references/platform-specs.md +213 -0
  89. package/departments/marketing/skills/ad-creative/references/static-ad-templates.md +200 -0
  90. package/departments/marketing/skills/ai-seo/SKILL.md +520 -0
  91. package/departments/marketing/skills/ai-seo/references/citations-vs-recommendations.md +85 -0
  92. package/departments/marketing/skills/ai-seo/references/content-patterns.md +287 -0
  93. package/departments/marketing/skills/ai-seo/references/content-types.md +71 -0
  94. package/departments/marketing/skills/ai-seo/references/okf.md +104 -0
  95. package/departments/marketing/skills/ai-seo/references/platform-ranking-factors.md +154 -0
  96. package/departments/marketing/skills/analytics-report/SKILL.md +310 -1
  97. package/departments/marketing/skills/analytics-report/references/event-library.md +260 -0
  98. package/departments/marketing/skills/analytics-report/references/ga4-implementation.md +300 -0
  99. package/departments/marketing/skills/analytics-report/references/gtm-implementation.md +390 -0
  100. package/departments/marketing/skills/aso/SKILL.md +336 -0
  101. package/departments/marketing/skills/aso/references/apple-specs.md +107 -0
  102. package/departments/marketing/skills/aso/references/benchmarks.md +129 -0
  103. package/departments/marketing/skills/aso/references/google-play-specs.md +131 -0
  104. package/departments/marketing/skills/aso/references/report-template.md +213 -0
  105. package/departments/marketing/skills/aso/references/scoring-criteria.md +213 -0
  106. package/departments/marketing/skills/co-marketing/SKILL.md +316 -0
  107. package/departments/marketing/skills/cold-email/SKILL.md +80 -0
  108. package/departments/marketing/skills/cold-email/references/benchmarks.md +83 -0
  109. package/departments/marketing/skills/cold-email/references/follow-up-sequences.md +81 -0
  110. package/departments/marketing/skills/cold-email/references/frameworks.md +90 -0
  111. package/departments/marketing/skills/cold-email/references/personalization.md +79 -0
  112. package/departments/marketing/skills/cold-email/references/subject-lines.md +53 -0
  113. package/departments/marketing/skills/competitor-analysis/SKILL.md +262 -5
  114. package/departments/marketing/skills/competitor-analysis/references/content-architecture.md +271 -0
  115. package/departments/marketing/skills/competitor-analysis/references/templates.md +223 -0
  116. package/departments/marketing/skills/competitor-profile/SKILL.md +447 -0
  117. package/departments/marketing/skills/competitor-profile/references/templates.md +167 -0
  118. package/departments/marketing/skills/competitor-profile/references/tool-reference.md +179 -0
  119. package/departments/marketing/skills/content-strategy/SKILL.md +398 -0
  120. package/departments/marketing/skills/content-strategy/references/headless-cms.md +194 -0
  121. package/departments/marketing/skills/council/SKILL.md +185 -0
  122. package/departments/marketing/skills/council/references/advisor-template.md +51 -0
  123. package/departments/marketing/skills/council/references/advisors/alex-hormozi.md +43 -0
  124. package/departments/marketing/skills/council/references/advisors/ann-handley.md +43 -0
  125. package/departments/marketing/skills/council/references/advisors/april-dunford.md +41 -0
  126. package/departments/marketing/skills/council/references/advisors/byron-sharp.md +43 -0
  127. package/departments/marketing/skills/council/references/advisors/claude-hopkins.md +42 -0
  128. package/departments/marketing/skills/council/references/advisors/david-ogilvy.md +42 -0
  129. package/departments/marketing/skills/council/references/advisors/eugene-schwartz.md +42 -0
  130. package/departments/marketing/skills/council/references/advisors/gary-halbert.md +43 -0
  131. package/departments/marketing/skills/council/references/advisors/gary-vaynerchuk.md +43 -0
  132. package/departments/marketing/skills/council/references/advisors/rory-sutherland.md +42 -0
  133. package/departments/marketing/skills/council/references/advisors/russell-brunson.md +43 -0
  134. package/departments/marketing/skills/council/references/advisors/seth-godin.md +43 -0
  135. package/departments/marketing/skills/customer-research/SKILL.md +318 -0
  136. package/departments/marketing/skills/customer-research/references/source-guides.md +401 -0
  137. package/departments/marketing/skills/directory-submit/SKILL.md +409 -0
  138. package/departments/marketing/skills/directory-submit/references/directory-list.md +477 -0
  139. package/departments/marketing/skills/directory-submit/references/positioning-variations.md +232 -0
  140. package/departments/marketing/skills/directory-submit/references/submission-tracker-template.csv +266 -0
  141. package/departments/marketing/skills/email-sequence/SKILL.md +309 -2
  142. package/departments/marketing/skills/email-sequence/references/copy-guidelines.md +113 -0
  143. package/departments/marketing/skills/email-sequence/references/email-types.md +515 -0
  144. package/departments/marketing/skills/email-sequence/references/sequence-templates.md +168 -0
  145. package/departments/marketing/skills/free-tools/SKILL.md +203 -0
  146. package/departments/marketing/skills/free-tools/references/tool-types.md +217 -0
  147. package/departments/marketing/skills/marketing-ideas/SKILL.md +191 -0
  148. package/departments/marketing/skills/marketing-ideas/references/ideas-by-category.md +366 -0
  149. package/departments/marketing/skills/marketing-loops/SKILL.md +136 -0
  150. package/departments/marketing/skills/marketing-loops/references/loop-catalog.md +687 -0
  151. package/departments/marketing/skills/marketing-loops/references/loop-guardrails.md +73 -0
  152. package/departments/marketing/skills/marketing-loops/references/loop-orchestration.md +69 -0
  153. package/departments/marketing/skills/marketing-loops/references/loop-state.md +67 -0
  154. package/departments/marketing/skills/marketing-loops/references/loop-template.md +79 -0
  155. package/departments/marketing/skills/marketing-plan/SKILL.md +302 -0
  156. package/departments/marketing/skills/marketing-plan/references/aarrr-framework.md +180 -0
  157. package/departments/marketing/skills/marketing-plan/references/budget-planning.md +168 -0
  158. package/departments/marketing/skills/marketing-plan/references/client-types.md +373 -0
  159. package/departments/marketing/skills/marketing-plan/references/current-state-rubric.md +255 -0
  160. package/departments/marketing/skills/marketing-plan/references/example-quietude.md +972 -0
  161. package/departments/marketing/skills/marketing-plan/references/funding-stage-unlocks.md +230 -0
  162. package/departments/marketing/skills/marketing-plan/references/growth-patterns.md +148 -0
  163. package/departments/marketing/skills/marketing-plan/references/idea-cross-reference.md +265 -0
  164. package/departments/marketing/skills/marketing-plan/references/measurement-framework.md +213 -0
  165. package/departments/marketing/skills/marketing-plan/references/methodology.md +363 -0
  166. package/departments/marketing/skills/marketing-plan/references/ops-stack-mapping.md +197 -0
  167. package/departments/marketing/skills/marketing-plan/references/plan-template.md +494 -0
  168. package/departments/marketing/skills/marketing-plan/references/team-and-agency-model.md +278 -0
  169. package/departments/marketing/skills/marketing-psychology/SKILL.md +479 -0
  170. package/departments/marketing/skills/paid-campaign/SKILL.md +452 -3
  171. package/departments/marketing/skills/paid-campaign/references/abm-playbook.md +93 -0
  172. package/departments/marketing/skills/paid-campaign/references/ad-copy-templates.md +207 -0
  173. package/departments/marketing/skills/paid-campaign/references/audience-targeting.md +243 -0
  174. package/departments/marketing/skills/paid-campaign/references/b2b-paid-playbook.md +115 -0
  175. package/departments/marketing/skills/paid-campaign/references/conversion-tracking.md +361 -0
  176. package/departments/marketing/skills/paid-campaign/references/google-search-playbook.md +120 -0
  177. package/departments/marketing/skills/paid-campaign/references/linkedin-b2b-playbook.md +107 -0
  178. package/departments/marketing/skills/paid-campaign/references/meta-decision-system.md +143 -0
  179. package/departments/marketing/skills/paid-campaign/references/platform-setup-checklists.md +277 -0
  180. package/departments/marketing/skills/paid-campaign/references/rsa-output-spec.md +88 -0
  181. package/departments/marketing/skills/product-marketing/SKILL.md +141 -0
  182. package/departments/marketing/skills/programmatic-seo/SKILL.md +74 -3
  183. package/departments/marketing/skills/programmatic-seo/references/playbooks.md +308 -0
  184. package/departments/marketing/skills/public-relations/SKILL.md +167 -0
  185. package/departments/marketing/skills/public-relations/references/journalist-pitching.md +368 -0
  186. package/departments/marketing/skills/public-relations/references/media-outlets.md +207 -0
  187. package/departments/marketing/skills/public-relations/references/newsjacking.md +218 -0
  188. package/departments/marketing/skills/public-relations/references/press-platforms.md +188 -0
  189. package/departments/marketing/skills/schema-markup/SKILL.md +203 -0
  190. package/departments/marketing/skills/schema-markup/references/schema-examples.md +398 -0
  191. package/departments/marketing/skills/seo-audit/SKILL.md +470 -1
  192. package/departments/marketing/skills/seo-audit/references/ai-writing-detection.md +200 -0
  193. package/departments/marketing/skills/seo-audit/references/international-seo.md +230 -0
  194. package/departments/marketing/skills/sms-campaign/SKILL.md +363 -0
  195. package/departments/marketing/skills/sms-campaign/references/compliance.md +202 -0
  196. package/departments/marketing/skills/sms-campaign/references/platforms.md +318 -0
  197. package/departments/marketing/skills/sms-campaign/references/sequence-templates.md +282 -0
  198. package/departments/marketing/skills/social-strategy/SKILL.md +414 -3
  199. package/departments/marketing/skills/social-strategy/references/carousel-frameworks.md +141 -0
  200. package/departments/marketing/skills/social-strategy/references/listening-sources-template.md +123 -0
  201. package/departments/marketing/skills/social-strategy/references/listening.md +283 -0
  202. package/departments/marketing/skills/social-strategy/references/platform-limits.md +110 -0
  203. package/departments/marketing/skills/social-strategy/references/platforms.md +170 -0
  204. package/departments/marketing/skills/social-strategy/references/post-templates.md +179 -0
  205. package/departments/marketing/skills/social-strategy/references/reverse-engineering.md +195 -0
  206. package/departments/marketing/skills/social-strategy/references/short-form-video.md +237 -0
  207. package/departments/marketing/squad.yaml +10 -1
  208. package/departments/marketing/tools/LICENSE +21 -0
  209. package/departments/marketing/tools/REGISTRY.md +590 -0
  210. package/departments/marketing/tools/clis/README.md +198 -0
  211. package/departments/marketing/tools/clis/activecampaign.js +435 -0
  212. package/departments/marketing/tools/clis/adobe-analytics.js +161 -0
  213. package/departments/marketing/tools/clis/ahrefs.js +192 -0
  214. package/departments/marketing/tools/clis/airops.js +163 -0
  215. package/departments/marketing/tools/clis/amplitude.js +182 -0
  216. package/departments/marketing/tools/clis/apollo.js +142 -0
  217. package/departments/marketing/tools/clis/beehiiv.js +245 -0
  218. package/departments/marketing/tools/clis/brevo.js +368 -0
  219. package/departments/marketing/tools/clis/buffer.js +260 -0
  220. package/departments/marketing/tools/clis/calendly.js +253 -0
  221. package/departments/marketing/tools/clis/clay.js +159 -0
  222. package/departments/marketing/tools/clis/clearbit.js +163 -0
  223. package/departments/marketing/tools/clis/close.js +232 -0
  224. package/departments/marketing/tools/clis/coupler.js +173 -0
  225. package/departments/marketing/tools/clis/crossbeam.js +193 -0
  226. package/departments/marketing/tools/clis/customer-io.js +205 -0
  227. package/departments/marketing/tools/clis/dataforseo.js +257 -0
  228. package/departments/marketing/tools/clis/demio.js +149 -0
  229. package/departments/marketing/tools/clis/dub.js +158 -0
  230. package/departments/marketing/tools/clis/exa.js +147 -0
  231. package/departments/marketing/tools/clis/g2.js +186 -0
  232. package/departments/marketing/tools/clis/ga4.js +194 -0
  233. package/departments/marketing/tools/clis/github-prospects.js +257 -0
  234. package/departments/marketing/tools/clis/google-ads.js +189 -0
  235. package/departments/marketing/tools/clis/google-search-console.js +166 -0
  236. package/departments/marketing/tools/clis/hotjar.js +167 -0
  237. package/departments/marketing/tools/clis/hunter.js +249 -0
  238. package/departments/marketing/tools/clis/instantly.js +270 -0
  239. package/departments/marketing/tools/clis/intercom.js +399 -0
  240. package/departments/marketing/tools/clis/keywords-everywhere.js +185 -0
  241. package/departments/marketing/tools/clis/kit.js +232 -0
  242. package/departments/marketing/tools/clis/klaviyo.js +348 -0
  243. package/departments/marketing/tools/clis/lemlist.js +221 -0
  244. package/departments/marketing/tools/clis/linkedin-ads.js +185 -0
  245. package/departments/marketing/tools/clis/livestorm.js +292 -0
  246. package/departments/marketing/tools/clis/mailchimp.js +220 -0
  247. package/departments/marketing/tools/clis/mention-me.js +161 -0
  248. package/departments/marketing/tools/clis/meta-ads.js +181 -0
  249. package/departments/marketing/tools/clis/mixpanel.js +248 -0
  250. package/departments/marketing/tools/clis/onesignal.js +241 -0
  251. package/departments/marketing/tools/clis/optimizely.js +233 -0
  252. package/departments/marketing/tools/clis/outreach.js +213 -0
  253. package/departments/marketing/tools/clis/paddle.js +385 -0
  254. package/departments/marketing/tools/clis/partnerstack.js +382 -0
  255. package/departments/marketing/tools/clis/pendo.js +221 -0
  256. package/departments/marketing/tools/clis/plausible.js +249 -0
  257. package/departments/marketing/tools/clis/postmark.js +375 -0
  258. package/departments/marketing/tools/clis/rankparse.js +196 -0
  259. package/departments/marketing/tools/clis/resend.js +370 -0
  260. package/departments/marketing/tools/clis/rewardful.js +160 -0
  261. package/departments/marketing/tools/clis/savvycal.js +223 -0
  262. package/departments/marketing/tools/clis/segment.js +192 -0
  263. package/departments/marketing/tools/clis/semrush.js +207 -0
  264. package/departments/marketing/tools/clis/sendgrid.js +211 -0
  265. package/departments/marketing/tools/clis/similarweb.js +214 -0
  266. package/departments/marketing/tools/clis/snov.js +237 -0
  267. package/departments/marketing/tools/clis/supermetrics.js +169 -0
  268. package/departments/marketing/tools/clis/tiktok-ads.js +190 -0
  269. package/departments/marketing/tools/clis/tolt.js +153 -0
  270. package/departments/marketing/tools/clis/trustpilot.js +276 -0
  271. package/departments/marketing/tools/clis/typeform.js +269 -0
  272. package/departments/marketing/tools/clis/wistia.js +301 -0
  273. package/departments/marketing/tools/clis/zapier.js +165 -0
  274. package/departments/marketing/tools/clis/zoominfo.js +223 -0
  275. package/departments/marketing/tools/composio/README.md +105 -0
  276. package/departments/marketing/tools/composio/marketing-tools.md +91 -0
  277. package/departments/marketing/tools/integrations/activecampaign.md +337 -0
  278. package/departments/marketing/tools/integrations/adobe-analytics.md +156 -0
  279. package/departments/marketing/tools/integrations/ahrefs.md +142 -0
  280. package/departments/marketing/tools/integrations/airops.md +128 -0
  281. package/departments/marketing/tools/integrations/amplitude.md +135 -0
  282. package/departments/marketing/tools/integrations/apollo.md +148 -0
  283. package/departments/marketing/tools/integrations/attentive.md +152 -0
  284. package/departments/marketing/tools/integrations/audiencetap.md +125 -0
  285. package/departments/marketing/tools/integrations/beehiiv.md +157 -0
  286. package/departments/marketing/tools/integrations/brevo.md +268 -0
  287. package/departments/marketing/tools/integrations/browserbase.md +111 -0
  288. package/departments/marketing/tools/integrations/buffer.md +138 -0
  289. package/departments/marketing/tools/integrations/calendly.md +161 -0
  290. package/departments/marketing/tools/integrations/clay.md +149 -0
  291. package/departments/marketing/tools/integrations/clearbit.md +142 -0
  292. package/departments/marketing/tools/integrations/close.md +191 -0
  293. package/departments/marketing/tools/integrations/cogny.md +153 -0
  294. package/departments/marketing/tools/integrations/composio.md +190 -0
  295. package/departments/marketing/tools/integrations/contentful.md +160 -0
  296. package/departments/marketing/tools/integrations/coupler.md +142 -0
  297. package/departments/marketing/tools/integrations/crossbeam.md +137 -0
  298. package/departments/marketing/tools/integrations/customer-io.md +187 -0
  299. package/departments/marketing/tools/integrations/dataforseo.md +165 -0
  300. package/departments/marketing/tools/integrations/demio.md +182 -0
  301. package/departments/marketing/tools/integrations/dub-co.md +160 -0
  302. package/departments/marketing/tools/integrations/exa.md +145 -0
  303. package/departments/marketing/tools/integrations/firecrawl.md +144 -0
  304. package/departments/marketing/tools/integrations/firehose.md +159 -0
  305. package/departments/marketing/tools/integrations/g2.md +179 -0
  306. package/departments/marketing/tools/integrations/ga4.md +126 -0
  307. package/departments/marketing/tools/integrations/github.md +182 -0
  308. package/departments/marketing/tools/integrations/gong.md +144 -0
  309. package/departments/marketing/tools/integrations/google-ads.md +159 -0
  310. package/departments/marketing/tools/integrations/google-search-console.md +147 -0
  311. package/departments/marketing/tools/integrations/heygen.md +126 -0
  312. package/departments/marketing/tools/integrations/hotjar.md +147 -0
  313. package/departments/marketing/tools/integrations/hubspot.md +178 -0
  314. package/departments/marketing/tools/integrations/hunter.md +90 -0
  315. package/departments/marketing/tools/integrations/hyperframes.md +180 -0
  316. package/departments/marketing/tools/integrations/instantly.md +104 -0
  317. package/departments/marketing/tools/integrations/intercom.md +292 -0
  318. package/departments/marketing/tools/integrations/introw.md +182 -0
  319. package/departments/marketing/tools/integrations/keywords-everywhere.md +207 -0
  320. package/departments/marketing/tools/integrations/kit.md +167 -0
  321. package/departments/marketing/tools/integrations/klaviyo.md +228 -0
  322. package/departments/marketing/tools/integrations/lemlist.md +110 -0
  323. package/departments/marketing/tools/integrations/linkedin-ads.md +164 -0
  324. package/departments/marketing/tools/integrations/livestorm.md +313 -0
  325. package/departments/marketing/tools/integrations/mailchimp.md +150 -0
  326. package/departments/marketing/tools/integrations/mention-me.md +160 -0
  327. package/departments/marketing/tools/integrations/meta-ads.md +147 -0
  328. package/departments/marketing/tools/integrations/mixpanel.md +137 -0
  329. package/departments/marketing/tools/integrations/nitrosend.md +113 -0
  330. package/departments/marketing/tools/integrations/onesignal.md +229 -0
  331. package/departments/marketing/tools/integrations/optimizely.md +171 -0
  332. package/departments/marketing/tools/integrations/outreach.md +172 -0
  333. package/departments/marketing/tools/integrations/paddle.md +212 -0
  334. package/departments/marketing/tools/integrations/partnerstack.md +222 -0
  335. package/departments/marketing/tools/integrations/pendo.md +208 -0
  336. package/departments/marketing/tools/integrations/plausible.md +177 -0
  337. package/departments/marketing/tools/integrations/plivo.md +140 -0
  338. package/departments/marketing/tools/integrations/posthog.md +151 -0
  339. package/departments/marketing/tools/integrations/postmark.md +234 -0
  340. package/departments/marketing/tools/integrations/postscript.md +126 -0
  341. package/departments/marketing/tools/integrations/rankparse.md +257 -0
  342. package/departments/marketing/tools/integrations/rb2b.md +110 -0
  343. package/departments/marketing/tools/integrations/resend.md +212 -0
  344. package/departments/marketing/tools/integrations/rewardful.md +147 -0
  345. package/departments/marketing/tools/integrations/salesforce.md +150 -0
  346. package/departments/marketing/tools/integrations/sanity.md +148 -0
  347. package/departments/marketing/tools/integrations/savvycal.md +181 -0
  348. package/departments/marketing/tools/integrations/segment.md +159 -0
  349. package/departments/marketing/tools/integrations/semrush.md +121 -0
  350. package/departments/marketing/tools/integrations/sendgrid.md +161 -0
  351. package/departments/marketing/tools/integrations/sequenzy.md +306 -0
  352. package/departments/marketing/tools/integrations/shopify.md +176 -0
  353. package/departments/marketing/tools/integrations/similarweb.md +150 -0
  354. package/departments/marketing/tools/integrations/snov.md +94 -0
  355. package/departments/marketing/tools/integrations/sparktoro.md +127 -0
  356. package/departments/marketing/tools/integrations/strapi.md +167 -0
  357. package/departments/marketing/tools/integrations/stripe.md +148 -0
  358. package/departments/marketing/tools/integrations/supermetrics.md +145 -0
  359. package/departments/marketing/tools/integrations/tiktok-ads.md +161 -0
  360. package/departments/marketing/tools/integrations/tolt.md +144 -0
  361. package/departments/marketing/tools/integrations/truelist.md +184 -0
  362. package/departments/marketing/tools/integrations/trustpilot.md +191 -0
  363. package/departments/marketing/tools/integrations/twilio.md +152 -0
  364. package/departments/marketing/tools/integrations/typeform.md +190 -0
  365. package/departments/marketing/tools/integrations/webflow.md +198 -0
  366. package/departments/marketing/tools/integrations/wistia.md +164 -0
  367. package/departments/marketing/tools/integrations/wordpress.md +175 -0
  368. package/departments/marketing/tools/integrations/zapier.md +244 -0
  369. package/departments/marketing/tools/integrations/zoominfo.md +191 -0
  370. package/departments/quality/agents/copy-director.yaml +1 -0
  371. package/departments/saas/SKILL.md +1 -0
  372. package/departments/saas/skills/churn-analysis/SKILL.md +421 -4
  373. package/departments/saas/skills/churn-analysis/references/cancel-flow-patterns.md +316 -0
  374. package/departments/saas/skills/churn-analysis/references/dunning-playbook.md +408 -0
  375. package/departments/saas/skills/launch-execute/SKILL.md +346 -4
  376. package/departments/saas/skills/onboarding-optimize/SKILL.md +218 -4
  377. package/departments/saas/skills/onboarding-optimize/references/experiments.md +258 -0
  378. package/departments/saas/skills/paywall-design/SKILL.md +256 -0
  379. package/departments/saas/skills/paywall-design/references/experiments.md +164 -0
  380. package/departments/saas/skills/pricing-strategy/SKILL.md +224 -0
  381. package/departments/saas/skills/pricing-strategy/references/research-methods.md +152 -0
  382. package/departments/saas/skills/pricing-strategy/references/tier-structure.md +232 -0
  383. package/departments/sales/SKILL.md +3 -0
  384. package/departments/sales/skills/prospecting/SKILL.md +297 -0
  385. package/departments/sales/skills/prospecting/references/b2b-prospecting.md +106 -0
  386. package/departments/sales/skills/prospecting/references/compliance.md +123 -0
  387. package/departments/sales/skills/prospecting/references/data-sources.md +287 -0
  388. package/departments/sales/skills/prospecting/references/demand-signals.md +129 -0
  389. package/departments/sales/skills/prospecting/references/local-prospecting.md +165 -0
  390. package/departments/sales/skills/prospecting/references/saas-prospecting.md +123 -0
  391. package/departments/sales/skills/revops/SKILL.md +379 -0
  392. package/departments/sales/skills/revops/references/automation-playbooks.md +290 -0
  393. package/departments/sales/skills/revops/references/lifecycle-definitions.md +278 -0
  394. package/departments/sales/skills/revops/references/routing-rules.md +203 -0
  395. package/departments/sales/skills/revops/references/scoring-models.md +247 -0
  396. package/departments/sales/skills/sales-enablement/SKILL.md +396 -0
  397. package/departments/sales/skills/sales-enablement/references/deck-frameworks.md +263 -0
  398. package/departments/sales/skills/sales-enablement/references/demo-scripts.md +355 -0
  399. package/departments/sales/skills/sales-enablement/references/objection-library.md +270 -0
  400. package/departments/sales/skills/sales-enablement/references/one-pager-templates.md +208 -0
  401. package/harness/codex/AGENTS.md +8 -8
  402. package/harness/copilot/copilot-instructions.md +8 -8
  403. package/harness/cursor/rules/arkaos.mdc +9 -9
  404. package/harness/gemini/GEMINI.md +8 -8
  405. package/harness/opencode/AGENTS.md +8 -8
  406. package/harness/zed/.rules +8 -8
  407. package/knowledge/agents-registry-v2.json +170 -8
  408. package/knowledge/commands-registry.json +693 -99
  409. package/knowledge/skills-manifest.json +459 -20
  410. package/package.json +1 -1
  411. package/pyproject.toml +1 -1
  412. package/scripts/tools/evals_import.py +183 -0
@@ -0,0 +1,198 @@
1
+ # Marketing CLIs
2
+
3
+ Zero-dependency, single-file CLI tools for marketing platforms that don't ship their own.
4
+
5
+ Every CLI is a standalone Node.js script (Node 18+) with no `npm install` required — just `chmod +x` and go.
6
+
7
+ ## Install
8
+
9
+ ### Option 1: Run directly
10
+
11
+ ```bash
12
+ node tools/clis/ahrefs.js backlinks list --target example.com
13
+ ```
14
+
15
+ ### Option 2: Symlink for global access
16
+
17
+ ```bash
18
+ # Symlink any CLI you want available globally
19
+ ln -sf "$(pwd)/tools/clis/ahrefs.js" ~/.local/bin/ahrefs
20
+ ln -sf "$(pwd)/tools/clis/resend.js" ~/.local/bin/resend
21
+
22
+ # Then use directly
23
+ ahrefs backlinks list --target example.com
24
+ resend send --from you@example.com --to them@example.com --subject "Hello" --html "<p>Hi</p>"
25
+ ```
26
+
27
+ ### Option 3: Add the whole directory to PATH
28
+
29
+ ```bash
30
+ export PATH="$PATH:/path/to/marketingskills/tools/clis"
31
+ ```
32
+
33
+ ## Authentication
34
+
35
+ Every CLI reads credentials from environment variables:
36
+
37
+ | CLI | Environment Variable |
38
+ |-----|---------------------|
39
+ | `activecampaign` | `ACTIVECAMPAIGN_API_KEY`, `ACTIVECAMPAIGN_API_URL` |
40
+ | `adobe-analytics` | `ADOBE_ACCESS_TOKEN`, `ADOBE_CLIENT_ID`, `ADOBE_COMPANY_ID` |
41
+ | `ahrefs` | `AHREFS_API_KEY` |
42
+ | `amplitude` | `AMPLITUDE_API_KEY`, `AMPLITUDE_SECRET_KEY` |
43
+ | `apollo` | `APOLLO_API_KEY` |
44
+ | `beehiiv` | `BEEHIIV_API_KEY` |
45
+ | `brevo` | `BREVO_API_KEY` |
46
+ | `buffer` | `BUFFER_API_KEY` |
47
+ | `calendly` | `CALENDLY_API_KEY` |
48
+ | `clearbit` | `CLEARBIT_API_KEY` |
49
+ | `customer-io` | `CUSTOMERIO_APP_KEY` (App API), `CUSTOMERIO_SITE_ID` + `CUSTOMERIO_API_KEY` (Track API) |
50
+ | `dataforseo` | `DATAFORSEO_LOGIN`, `DATAFORSEO_PASSWORD` |
51
+ | `demio` | `DEMIO_API_KEY`, `DEMIO_API_SECRET` |
52
+ | `dub` | `DUB_API_KEY` |
53
+ | `exa` | `EXA_API_KEY` |
54
+ | `g2` | `G2_API_TOKEN` |
55
+ | `ga4` | `GA4_ACCESS_TOKEN` |
56
+ | `google-ads` | `GOOGLE_ADS_TOKEN`, `GOOGLE_ADS_DEVELOPER_TOKEN`, `GOOGLE_ADS_CUSTOMER_ID` |
57
+ | `google-search-console` | `GSC_ACCESS_TOKEN` |
58
+ | `hotjar` | `HOTJAR_CLIENT_ID`, `HOTJAR_CLIENT_SECRET` |
59
+ | `intercom` | `INTERCOM_API_KEY` |
60
+ | `keywords-everywhere` | `KEYWORDS_EVERYWHERE_API_KEY` |
61
+ | `kit` | `KIT_API_KEY`, `KIT_API_SECRET` |
62
+ | `klaviyo` | `KLAVIYO_API_KEY` |
63
+ | `linkedin-ads` | `LINKEDIN_ACCESS_TOKEN` |
64
+ | `livestorm` | `LIVESTORM_API_TOKEN` |
65
+ | `mailchimp` | `MAILCHIMP_API_KEY` |
66
+ | `mention-me` | `MENTIONME_API_KEY` |
67
+ | `meta-ads` | `META_ACCESS_TOKEN`, `META_AD_ACCOUNT_ID` |
68
+ | `mixpanel` | `MIXPANEL_TOKEN` (ingestion), `MIXPANEL_API_KEY` + `MIXPANEL_SECRET` (query) |
69
+ | `onesignal` | `ONESIGNAL_REST_API_KEY`, `ONESIGNAL_APP_ID` |
70
+ | `optimizely` | `OPTIMIZELY_API_KEY` |
71
+ | `paddle` | `PADDLE_API_KEY`, `PADDLE_SANDBOX` (optional) |
72
+ | `partnerstack` | `PARTNERSTACK_PUBLIC_KEY`, `PARTNERSTACK_SECRET_KEY` |
73
+ | `plausible` | `PLAUSIBLE_API_KEY`, `PLAUSIBLE_BASE_URL` (optional, for self-hosted) |
74
+ | `postmark` | `POSTMARK_API_KEY` |
75
+ | `resend` | `RESEND_API_KEY` |
76
+ | `rewardful` | `REWARDFUL_API_KEY` |
77
+ | `savvycal` | `SAVVYCAL_API_KEY` |
78
+ | `segment` | `SEGMENT_WRITE_KEY` (tracking), `SEGMENT_ACCESS_TOKEN` (profile) |
79
+ | `semrush` | `SEMRUSH_API_KEY` |
80
+ | `sendgrid` | `SENDGRID_API_KEY` |
81
+ | `tiktok-ads` | `TIKTOK_ACCESS_TOKEN`, `TIKTOK_ADVERTISER_ID` |
82
+ | `tolt` | `TOLT_API_KEY` |
83
+ | `trustpilot` | `TRUSTPILOT_API_KEY`, `TRUSTPILOT_API_SECRET`, `TRUSTPILOT_BUSINESS_UNIT_ID` |
84
+ | `typeform` | `TYPEFORM_API_KEY` |
85
+ | `hunter` | `HUNTER_API_KEY` |
86
+ | `instantly` | `INSTANTLY_API_KEY` |
87
+ | `lemlist` | `LEMLIST_API_KEY` |
88
+ | `snov` | `SNOV_CLIENT_ID`, `SNOV_CLIENT_SECRET` |
89
+ | `wistia` | `WISTIA_API_KEY` |
90
+ | `zapier` | `ZAPIER_API_KEY` |
91
+
92
+ ## Security
93
+
94
+ **Never hardcode API keys or tokens in scripts.** All CLIs read credentials exclusively from environment variables.
95
+
96
+ - Store keys in your shell profile (`~/.zshrc`, `~/.bashrc`) or a `.env` file
97
+ - The `.env` file is gitignored — but double-check before committing
98
+ - Use `--dry-run` on any command to preview the request without sending it (credentials are masked as `***`)
99
+ - If you fork this repo, audit your commits to ensure no secrets are included
100
+
101
+ ## Command Pattern
102
+
103
+ All CLIs follow the same structure:
104
+
105
+ ```
106
+ {tool} <resource> <action> [options]
107
+ ```
108
+
109
+ Examples:
110
+
111
+ ```bash
112
+ ahrefs backlinks list --target example.com --limit 50
113
+ semrush keywords overview --phrase "marketing automation" --database us
114
+ mailchimp campaigns list --limit 20
115
+ resend send --from you@example.com --to them@example.com --subject "Hello" --html "<p>Hi</p>"
116
+ dub links create --url https://example.com/landing --key summer-sale
117
+ ```
118
+
119
+ ## Output
120
+
121
+ All CLIs output JSON to stdout for easy piping:
122
+
123
+ ```bash
124
+ # Pipe to jq
125
+ ahrefs backlinks list --target example.com | jq '.backlinks[].url_from'
126
+
127
+ # Save to file
128
+ semrush keywords overview --phrase "saas marketing" --database us > keywords.json
129
+
130
+ # Use in scripts
131
+ DOMAINS=$(rewardful affiliates list | jq -r '.data[].email')
132
+ ```
133
+
134
+ ## Available CLIs
135
+
136
+ | CLI | Category | Tool |
137
+ |-----|----------|------|
138
+ | `activecampaign.js` | Email/CRM | [ActiveCampaign](https://activecampaign.com) |
139
+ | `adobe-analytics.js` | Analytics | [Adobe Analytics](https://business.adobe.com/products/analytics) |
140
+ | `ahrefs.js` | SEO | [Ahrefs](https://ahrefs.com) |
141
+ | `amplitude.js` | Analytics | [Amplitude](https://amplitude.com) |
142
+ | `apollo.js` | Data Enrichment | [Apollo.io](https://apollo.io) |
143
+ | `beehiiv.js` | Newsletter | [Beehiiv](https://beehiiv.com) |
144
+ | `brevo.js` | Email/SMS | [Brevo](https://brevo.com) |
145
+ | `buffer.js` | Social | [Buffer](https://buffer.com) |
146
+ | `calendly.js` | Scheduling | [Calendly](https://calendly.com) |
147
+ | `clearbit.js` | Data Enrichment | [Clearbit](https://clearbit.com) |
148
+ | `customer-io.js` | Email | [Customer.io](https://customer.io) |
149
+ | `dataforseo.js` | SEO | [DataForSEO](https://dataforseo.com) |
150
+ | `demio.js` | Webinar | [Demio](https://demio.com) |
151
+ | `dub.js` | Links | [Dub.co](https://dub.co) |
152
+ | `exa.js` | AI Search | [Exa](https://exa.ai) |
153
+ | `g2.js` | Reviews | [G2](https://g2.com) |
154
+ | `ga4.js` | Analytics | [Google Analytics 4](https://analytics.google.com) |
155
+ | `google-ads.js` | Ads | [Google Ads](https://ads.google.com) |
156
+ | `google-search-console.js` | SEO | [Google Search Console](https://search.google.com/search-console) |
157
+ | `hotjar.js` | CRO | [Hotjar](https://hotjar.com) |
158
+ | `hunter.js` | Email Outreach | [Hunter.io](https://hunter.io) |
159
+ | `instantly.js` | Email Outreach | [Instantly.ai](https://instantly.ai) |
160
+ | `intercom.js` | Messaging | [Intercom](https://intercom.com) |
161
+ | `keywords-everywhere.js` | SEO | [Keywords Everywhere](https://keywordseverywhere.com) |
162
+ | `kit.js` | Email | [Kit](https://kit.com) |
163
+ | `klaviyo.js` | Email/SMS | [Klaviyo](https://klaviyo.com) |
164
+ | `lemlist.js` | Email Outreach | [Lemlist](https://lemlist.com) |
165
+ | `linkedin-ads.js` | Ads | [LinkedIn Ads](https://business.linkedin.com/marketing-solutions/ads) |
166
+ | `livestorm.js` | Webinar | [Livestorm](https://livestorm.co) |
167
+ | `mailchimp.js` | Email | [Mailchimp](https://mailchimp.com) |
168
+ | `mention-me.js` | Referral | [Mention Me](https://www.mention-me.com) |
169
+ | `meta-ads.js` | Ads | [Meta Ads](https://www.facebook.com/business/ads) |
170
+ | `mixpanel.js` | Analytics | [Mixpanel](https://mixpanel.com) |
171
+ | `onesignal.js` | Push | [OneSignal](https://onesignal.com) |
172
+ | `optimizely.js` | A/B Testing | [Optimizely](https://optimizely.com) |
173
+ | `paddle.js` | Payments | [Paddle](https://paddle.com) |
174
+ | `partnerstack.js` | Affiliate | [PartnerStack](https://partnerstack.com) |
175
+ | `plausible.js` | Analytics | [Plausible](https://plausible.io) |
176
+ | `postmark.js` | Email | [Postmark](https://postmarkapp.com) |
177
+ | `resend.js` | Email | [Resend](https://resend.com) |
178
+ | `rewardful.js` | Referral | [Rewardful](https://www.getrewardful.com) |
179
+ | `savvycal.js` | Scheduling | [SavvyCal](https://savvycal.com) |
180
+ | `segment.js` | Analytics | [Segment](https://segment.com) |
181
+ | `semrush.js` | SEO | [SEMrush](https://semrush.com) |
182
+ | `sendgrid.js` | Email | [SendGrid](https://sendgrid.com) |
183
+ | `snov.js` | Email Outreach | [Snov.io](https://snov.io) |
184
+ | `tiktok-ads.js` | Ads | [TikTok Ads](https://ads.tiktok.com) |
185
+ | `tolt.js` | Referral | [Tolt](https://tolt.io) |
186
+ | `trustpilot.js` | Reviews | [Trustpilot](https://trustpilot.com) |
187
+ | `typeform.js` | Forms | [Typeform](https://typeform.com) |
188
+ | `wistia.js` | Video | [Wistia](https://wistia.com) |
189
+ | `zapier.js` | Automation | [Zapier](https://zapier.com) |
190
+
191
+ > **Security note:** `zapier.js hooks send` is the one CLI whose destination
192
+ > host is caller-controlled — it POSTs arbitrary `--data` to any HTTPS URL
193
+ > you pass. Review the URL before invoking it from an agent context.
194
+ > `wistia.js captions create --srt-file` only accepts `.srt`/`.vtt` caption
195
+ > files that resolve (symlinks followed) to inside the current working
196
+ > directory — both the argument and the final symlink target must be a
197
+ > caption file, and hard links are rejected — so no in-tree link, soft or
198
+ > hard, can redirect the read to a secret.
@@ -0,0 +1,435 @@
1
+ #!/usr/bin/env node
2
+
3
+ const API_KEY = process.env.ACTIVECAMPAIGN_API_KEY
4
+ const API_URL = process.env.ACTIVECAMPAIGN_API_URL
5
+
6
+ if (!API_KEY) {
7
+ console.error(JSON.stringify({ error: 'ACTIVECAMPAIGN_API_KEY environment variable required' }))
8
+ process.exit(1)
9
+ }
10
+
11
+ if (!API_URL) {
12
+ console.error(JSON.stringify({ error: 'ACTIVECAMPAIGN_API_URL environment variable required (e.g. https://yourname.api-us1.com)' }))
13
+ process.exit(1)
14
+ }
15
+
16
+ const BASE_URL = `${API_URL.replace(/\/$/, '')}/api/3`
17
+
18
+ async function api(method, path, body) {
19
+ if (args['dry-run']) {
20
+ return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { 'Api-Token': '***', 'Content-Type': 'application/json', 'Accept': 'application/json' }, body: body || undefined }
21
+ }
22
+ const res = await fetch(`${BASE_URL}${path}`, {
23
+ method,
24
+ headers: {
25
+ 'Api-Token': API_KEY,
26
+ 'Content-Type': 'application/json',
27
+ 'Accept': 'application/json',
28
+ },
29
+ body: body ? JSON.stringify(body) : undefined,
30
+ })
31
+ const text = await res.text()
32
+ try {
33
+ return JSON.parse(text)
34
+ } catch {
35
+ return { status: res.status, body: text }
36
+ }
37
+ }
38
+
39
+ function parseArgs(args) {
40
+ const result = { _: [] }
41
+ for (let i = 0; i < args.length; i++) {
42
+ const arg = args[i]
43
+ if (arg.startsWith('--')) {
44
+ const key = arg.slice(2)
45
+ const next = args[i + 1]
46
+ if (next && !next.startsWith('--')) {
47
+ result[key] = next
48
+ i++
49
+ } else {
50
+ result[key] = true
51
+ }
52
+ } else {
53
+ result._.push(arg)
54
+ }
55
+ }
56
+ return result
57
+ }
58
+
59
+ const args = parseArgs(process.argv.slice(2))
60
+ const [cmd, sub, ...rest] = args._
61
+
62
+ async function main() {
63
+ let result
64
+ const limit = args.limit ? Number(args.limit) : 20
65
+ const offset = args.offset ? Number(args.offset) : 0
66
+
67
+ switch (cmd) {
68
+ case 'contacts':
69
+ switch (sub) {
70
+ case 'list': {
71
+ const params = new URLSearchParams()
72
+ params.set('limit', String(limit))
73
+ params.set('offset', String(offset))
74
+ if (args.email) params.set('email', args.email)
75
+ if (args.search) params.set('search', args.search)
76
+ if (args['list-id']) params.set('listid', args['list-id'])
77
+ if (args.status) params.set('status', args.status)
78
+ result = await api('GET', `/contacts?${params.toString()}`)
79
+ break
80
+ }
81
+ case 'get': {
82
+ const id = args.id
83
+ if (!id) { result = { error: '--id required' }; break }
84
+ result = await api('GET', `/contacts/${id}`)
85
+ break
86
+ }
87
+ case 'create': {
88
+ const email = args.email
89
+ if (!email) { result = { error: '--email required' }; break }
90
+ const contact = { email }
91
+ if (args['first-name']) contact.firstName = args['first-name']
92
+ if (args['last-name']) contact.lastName = args['last-name']
93
+ if (args.phone) contact.phone = args.phone
94
+ result = await api('POST', '/contacts', { contact })
95
+ break
96
+ }
97
+ case 'update': {
98
+ const id = args.id
99
+ if (!id) { result = { error: '--id required' }; break }
100
+ const contact = {}
101
+ if (args.email) contact.email = args.email
102
+ if (args['first-name']) contact.firstName = args['first-name']
103
+ if (args['last-name']) contact.lastName = args['last-name']
104
+ if (args.phone) contact.phone = args.phone
105
+ result = await api('PUT', `/contacts/${id}`, { contact })
106
+ break
107
+ }
108
+ case 'delete': {
109
+ const id = args.id
110
+ if (!id) { result = { error: '--id required' }; break }
111
+ result = await api('DELETE', `/contacts/${id}`)
112
+ break
113
+ }
114
+ case 'sync': {
115
+ const email = args.email
116
+ if (!email) { result = { error: '--email required' }; break }
117
+ const contact = { email }
118
+ if (args['first-name']) contact.firstName = args['first-name']
119
+ if (args['last-name']) contact.lastName = args['last-name']
120
+ if (args.phone) contact.phone = args.phone
121
+ result = await api('POST', '/contact/sync', { contact })
122
+ break
123
+ }
124
+ default:
125
+ result = { error: 'Unknown contacts subcommand. Use: list, get, create, update, delete, sync' }
126
+ }
127
+ break
128
+
129
+ case 'lists':
130
+ switch (sub) {
131
+ case 'list': {
132
+ const params = new URLSearchParams()
133
+ params.set('limit', String(limit))
134
+ params.set('offset', String(offset))
135
+ result = await api('GET', `/lists?${params.toString()}`)
136
+ break
137
+ }
138
+ case 'get': {
139
+ const id = args.id
140
+ if (!id) { result = { error: '--id required' }; break }
141
+ result = await api('GET', `/lists/${id}`)
142
+ break
143
+ }
144
+ case 'create': {
145
+ const name = args.name
146
+ if (!name) { result = { error: '--name required' }; break }
147
+ const list = { name }
148
+ if (args['string-id']) list.stringid = args['string-id']
149
+ if (args['sender-url']) list.sender_url = args['sender-url']
150
+ if (args['sender-reminder']) list.sender_reminder = args['sender-reminder']
151
+ result = await api('POST', '/lists', { list })
152
+ break
153
+ }
154
+ case 'delete': {
155
+ const id = args.id
156
+ if (!id) { result = { error: '--id required' }; break }
157
+ result = await api('DELETE', `/lists/${id}`)
158
+ break
159
+ }
160
+ case 'subscribe': {
161
+ const listId = args['list-id'] || args.id
162
+ const contactId = args['contact-id']
163
+ if (!listId) { result = { error: '--list-id required' }; break }
164
+ if (!contactId) { result = { error: '--contact-id required' }; break }
165
+ result = await api('POST', '/contactLists', {
166
+ contactList: { list: listId, contact: contactId, status: 1 }
167
+ })
168
+ break
169
+ }
170
+ case 'unsubscribe': {
171
+ const listId = args['list-id'] || args.id
172
+ const contactId = args['contact-id']
173
+ if (!listId) { result = { error: '--list-id required' }; break }
174
+ if (!contactId) { result = { error: '--contact-id required' }; break }
175
+ result = await api('POST', '/contactLists', {
176
+ contactList: { list: listId, contact: contactId, status: 2 }
177
+ })
178
+ break
179
+ }
180
+ default:
181
+ result = { error: 'Unknown lists subcommand. Use: list, get, create, delete, subscribe, unsubscribe' }
182
+ }
183
+ break
184
+
185
+ case 'campaigns':
186
+ switch (sub) {
187
+ case 'list': {
188
+ const params = new URLSearchParams()
189
+ params.set('limit', String(limit))
190
+ params.set('offset', String(offset))
191
+ result = await api('GET', `/campaigns?${params.toString()}`)
192
+ break
193
+ }
194
+ case 'get': {
195
+ const id = args.id
196
+ if (!id) { result = { error: '--id required' }; break }
197
+ result = await api('GET', `/campaigns/${id}`)
198
+ break
199
+ }
200
+ default:
201
+ result = { error: 'Unknown campaigns subcommand. Use: list, get' }
202
+ }
203
+ break
204
+
205
+ case 'deals':
206
+ switch (sub) {
207
+ case 'list': {
208
+ const params = new URLSearchParams()
209
+ params.set('limit', String(limit))
210
+ params.set('offset', String(offset))
211
+ if (args.search) params.set('search', args.search)
212
+ if (args.stage) params.set('filters[stage]', args.stage)
213
+ if (args.owner) params.set('filters[owner]', args.owner)
214
+ result = await api('GET', `/deals?${params.toString()}`)
215
+ break
216
+ }
217
+ case 'get': {
218
+ const id = args.id
219
+ if (!id) { result = { error: '--id required' }; break }
220
+ result = await api('GET', `/deals/${id}`)
221
+ break
222
+ }
223
+ case 'create': {
224
+ const title = args.title
225
+ if (!title) { result = { error: '--title required' }; break }
226
+ const deal = { title }
227
+ if (args.value) deal.value = Number(args.value)
228
+ if (args.currency) deal.currency = args.currency
229
+ if (args.pipeline) deal.group = args.pipeline
230
+ if (args.stage) deal.stage = args.stage
231
+ if (args.owner) deal.owner = args.owner
232
+ if (args['contact-id']) deal.contact = args['contact-id']
233
+ result = await api('POST', '/deals', { deal })
234
+ break
235
+ }
236
+ case 'update': {
237
+ const id = args.id
238
+ if (!id) { result = { error: '--id required' }; break }
239
+ const deal = {}
240
+ if (args.title) deal.title = args.title
241
+ if (args.value) deal.value = Number(args.value)
242
+ if (args.stage) deal.stage = args.stage
243
+ if (args.owner) deal.owner = args.owner
244
+ if (args.status) deal.status = Number(args.status)
245
+ result = await api('PUT', `/deals/${id}`, { deal })
246
+ break
247
+ }
248
+ case 'delete': {
249
+ const id = args.id
250
+ if (!id) { result = { error: '--id required' }; break }
251
+ result = await api('DELETE', `/deals/${id}`)
252
+ break
253
+ }
254
+ default:
255
+ result = { error: 'Unknown deals subcommand. Use: list, get, create, update, delete' }
256
+ }
257
+ break
258
+
259
+ case 'automations':
260
+ switch (sub) {
261
+ case 'list': {
262
+ const params = new URLSearchParams()
263
+ params.set('limit', String(limit))
264
+ params.set('offset', String(offset))
265
+ result = await api('GET', `/automations?${params.toString()}`)
266
+ break
267
+ }
268
+ case 'get': {
269
+ const id = args.id
270
+ if (!id) { result = { error: '--id required' }; break }
271
+ result = await api('GET', `/automations/${id}`)
272
+ break
273
+ }
274
+ case 'add-contact': {
275
+ const automationId = args.id
276
+ const contactId = args['contact-id']
277
+ if (!automationId) { result = { error: '--id required (automation ID)' }; break }
278
+ if (!contactId) { result = { error: '--contact-id required (contact ID, not email)' }; break }
279
+ result = await api('POST', '/contactAutomations', {
280
+ contactAutomation: { contact: contactId, automation: automationId }
281
+ })
282
+ break
283
+ }
284
+ default:
285
+ result = { error: 'Unknown automations subcommand. Use: list, get, add-contact' }
286
+ }
287
+ break
288
+
289
+ case 'tags':
290
+ switch (sub) {
291
+ case 'list': {
292
+ const params = new URLSearchParams()
293
+ params.set('limit', String(limit))
294
+ params.set('offset', String(offset))
295
+ if (args.search) params.set('search', args.search)
296
+ result = await api('GET', `/tags?${params.toString()}`)
297
+ break
298
+ }
299
+ case 'get': {
300
+ const id = args.id
301
+ if (!id) { result = { error: '--id required' }; break }
302
+ result = await api('GET', `/tags/${id}`)
303
+ break
304
+ }
305
+ case 'create': {
306
+ const name = args.name
307
+ if (!name) { result = { error: '--name required' }; break }
308
+ result = await api('POST', '/tags', {
309
+ tag: { tag: name, tagType: args.type || 'contact' }
310
+ })
311
+ break
312
+ }
313
+ case 'delete': {
314
+ const id = args.id
315
+ if (!id) { result = { error: '--id required' }; break }
316
+ result = await api('DELETE', `/tags/${id}`)
317
+ break
318
+ }
319
+ case 'add-to-contact': {
320
+ const tagId = args['tag-id']
321
+ const contactId = args['contact-id']
322
+ if (!tagId) { result = { error: '--tag-id required' }; break }
323
+ if (!contactId) { result = { error: '--contact-id required' }; break }
324
+ result = await api('POST', '/contactTags', {
325
+ contactTag: { contact: contactId, tag: tagId }
326
+ })
327
+ break
328
+ }
329
+ case 'remove-from-contact': {
330
+ const contactTagId = args.id
331
+ if (!contactTagId) { result = { error: '--id required (contactTag ID)' }; break }
332
+ result = await api('DELETE', `/contactTags/${contactTagId}`)
333
+ break
334
+ }
335
+ default:
336
+ result = { error: 'Unknown tags subcommand. Use: list, get, create, delete, add-to-contact, remove-from-contact' }
337
+ }
338
+ break
339
+
340
+ case 'pipelines':
341
+ switch (sub) {
342
+ case 'list': {
343
+ const params = new URLSearchParams()
344
+ params.set('limit', String(limit))
345
+ params.set('offset', String(offset))
346
+ result = await api('GET', `/dealGroups?${params.toString()}`)
347
+ break
348
+ }
349
+ case 'get': {
350
+ const id = args.id
351
+ if (!id) { result = { error: '--id required' }; break }
352
+ result = await api('GET', `/dealGroups/${id}`)
353
+ break
354
+ }
355
+ default:
356
+ result = { error: 'Unknown pipelines subcommand. Use: list, get' }
357
+ }
358
+ break
359
+
360
+ case 'webhooks':
361
+ switch (sub) {
362
+ case 'list': {
363
+ const params = new URLSearchParams()
364
+ params.set('limit', String(limit))
365
+ params.set('offset', String(offset))
366
+ result = await api('GET', `/webhooks?${params.toString()}`)
367
+ break
368
+ }
369
+ case 'get': {
370
+ const id = args.id
371
+ if (!id) { result = { error: '--id required' }; break }
372
+ result = await api('GET', `/webhooks/${id}`)
373
+ break
374
+ }
375
+ case 'create': {
376
+ const name = args.name
377
+ const url = args.url
378
+ if (!name) { result = { error: '--name required' }; break }
379
+ if (!url) { result = { error: '--url required' }; break }
380
+ const events = args.events?.split(',') || ['subscribe']
381
+ const sources = args.sources?.split(',') || ['public', 'admin', 'api', 'system']
382
+ result = await api('POST', '/webhooks', {
383
+ webhook: { name, url, events, sources }
384
+ })
385
+ break
386
+ }
387
+ case 'delete': {
388
+ const id = args.id
389
+ if (!id) { result = { error: '--id required' }; break }
390
+ result = await api('DELETE', `/webhooks/${id}`)
391
+ break
392
+ }
393
+ default:
394
+ result = { error: 'Unknown webhooks subcommand. Use: list, get, create, delete' }
395
+ }
396
+ break
397
+
398
+ case 'users':
399
+ switch (sub) {
400
+ case 'me':
401
+ result = await api('GET', '/users/me')
402
+ break
403
+ case 'list':
404
+ result = await api('GET', '/users')
405
+ break
406
+ default:
407
+ result = { error: 'Unknown users subcommand. Use: me, list' }
408
+ }
409
+ break
410
+
411
+ default:
412
+ result = {
413
+ error: 'Unknown command',
414
+ usage: {
415
+ contacts: 'contacts [list | get --id <id> | create --email <email> | update --id <id> | delete --id <id> | sync --email <email>]',
416
+ lists: 'lists [list | get --id <id> | create --name <name> | delete --id <id> | subscribe --list-id <lid> --contact-id <cid> | unsubscribe --list-id <lid> --contact-id <cid>]',
417
+ campaigns: 'campaigns [list | get --id <id>]',
418
+ deals: 'deals [list | get --id <id> | create --title <title> | update --id <id> | delete --id <id>]',
419
+ automations: 'automations [list | get --id <id> | add-contact --id <aid> --email <email>]',
420
+ tags: 'tags [list | get --id <id> | create --name <name> | delete --id <id> | add-to-contact --tag-id <tid> --contact-id <cid>]',
421
+ pipelines: 'pipelines [list | get --id <id>]',
422
+ webhooks: 'webhooks [list | get --id <id> | create --name <name> --url <url> | delete --id <id>]',
423
+ users: 'users [me | list]',
424
+ options: '--limit <n> --offset <n> --search <query> --email <email>',
425
+ }
426
+ }
427
+ }
428
+
429
+ console.log(JSON.stringify(result, null, 2))
430
+ }
431
+
432
+ main().catch(err => {
433
+ console.error(JSON.stringify({ error: err.message }))
434
+ process.exit(1)
435
+ })