@analyticscli/growth-engineer 0.1.0-preview.9 → 0.1.1-preview.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@analyticscli/growth-engineer",
-  "version": "0.1.0-preview.9",
+  "version": "0.1.1-preview.0",
   "description": "Growth Engineer CLI for connector setup, scheduling, health checks, and OpenClaw-compatible growth runs.",
   "license": "MIT",
   "type": "module",
@@ -24,6 +24,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json && mkdir -p dist/runtime && cp src/runtime/*.py dist/runtime/",
+    "dev": "tsx src/index.ts",
     "prepack": "npm run build",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
@@ -33,6 +34,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.10",
+    "tsx": "^4.19.3",
     "typescript": "^5.8.2"
   }
 }

package/templates/config.example.json

@@ -1,5 +1,5 @@
 {
-  "version": 7,
+  "version": 2,
   "generatedAt": "2026-03-21T00:00:00.000Z",
   "project": {
     "githubRepo": "owner/repo",
@@ -17,13 +17,59 @@
     },
     "revenuecat": {
       "enabled": false,
-      "mode": "file",
-      "path": "data/openclaw-growth-engineer/revenuecat_summary.example.json"
+      "mode": "command",
+      "command": "node scripts/export-revenuecat-summary.mjs"
+    },
+    "paddle": {
+      "enabled": false,
+      "mode": "command",
+      "command": "node scripts/export-paddle-summary.mjs",
+      "environment": "live"
+    },
+    "seo": {
+      "enabled": false,
+      "mode": "command",
+      "command": "node scripts/export-seo-summary.mjs",
+      "siteUrl": "",
+      "paidProvider": {
+        "dataforseo": {
+          "enabled": false,
+          "confirmPaid": false,
+          "maxPaidRequests": 1
+        }
+      }
     },
     "sentry": {
       "enabled": false,
       "mode": "command",
-      "command": "node scripts/export-sentry-summary.mjs"
+      "command": "node scripts/export-sentry-summary.mjs --config data/openclaw-growth-engineer/config.json",
+      "accounts": [
+        {
+          "id": "sentry_cloud",
+          "label": "Sentry Cloud",
+          "baseUrl": "https://sentry.io",
+          "tokenEnv": "SENTRY_AUTH_TOKEN",
+          "org": "owner-org",
+          "projects": ["ios-app"],
+          "environment": "production"
+        },
+        {
+          "id": "glitchtip_selfhosted",
+          "label": "GlitchTip self-hosted",
+          "baseUrl": "https://glitchtip.example.com",
+          "tokenEnv": "GLITCHTIP_AUTH_TOKEN",
+          "org": "owner-org",
+          "projects": ["backend-api", "web-app"],
+          "environment": "production"
+        }
+      ]
+    },
+    "coolify": {
+      "enabled": false,
+      "mode": "command",
+      "command": "npx -y @analyticscli/growth-engineer@preview exporters coolify-summary --config data/openclaw-growth-engineer/config.json",
+      "baseUrl": "https://coolify.example.com",
+      "tokenEnv": "COOLIFY_API_TOKEN"
     },
     "feedback": {
       "enabled": true,
@@ -33,81 +79,82 @@
       "initialLookback": "30d"
     },
     "extra": [
-      {
-        "key": "glitchtip",
-        "label": "glitchtip",
-        "service": "glitchtip",
-        "enabled": false,
-        "mode": "file",
-        "path": "data/openclaw-growth-engineer/glitchtip_summary.json",
-        "secretEnv": "GLITCHTIP_API_TOKEN"
-      },
       {
         "key": "asc_cli",
         "label": "asc-cli",
         "service": "asc-cli",
         "enabled": false,
         "mode": "command",
-        "command": "node scripts/export-asc-summary.mjs",
+        "command": "node scripts/export-asc-summary.mjs --max-signals 6",
         "secretEnv": "ASC_KEY_ID"
       }
     ]
   },
   "schedule": {
-    "intervalMinutes": 1440,
+    "intervalMinutes": 90,
     "connectorHealthCheckIntervalMinutes": 360,
     "skipIfNoDataChange": true,
     "skipIfIssueSetUnchanged": true,
     "cadences": [
+      {
+        "key": "healthcheck",
+        "title": "90-minute production error healthcheck",
+        "intervalMinutes": 90,
+        "criticalOnly": true,
+        "focusAreas": ["crash", "deployment", "availability"],
+        "sourcePriorities": ["sentry", "glitchtip", "coolify", "asc_cli"],
+        "objective": "Check Sentry/GlitchTip and Coolify for production errors, failed deploys, unhealthy resources, and availability blockers across every configured app.",
+        "instructions": "For Sentry/GlitchTip app errors, compare the issue release or app version with ASC production versions first. Ignore errors that only affect TestFlight, debug, staging, unreleased, or non-production app versions. Keep the social output short and action-oriented."
+      },
       {
         "key": "daily",
-        "title": "Daily Sentry and production guardrail",
+        "title": "Daily behavioral anomaly guardrail",
         "intervalDays": 1,
         "criticalOnly": true,
-        "focusAreas": ["sentry_errors", "crash", "onboarding", "conversion", "paywall", "purchase"],
-        "sourcePriorities": ["sentry", "glitchtip", "analytics", "revenuecat", "asc_cli", "feedback", "github"],
-        "objective": "Analyze every configured project for critical production blockers: Sentry/GlitchTip errors, crashes, onboarding or purchase drop-offs, zero-conversion days, missing buyers, very low users, and other silent business anomalies.",
-        "instructions": "Compare against recent baselines across connected sources and code changes. If the finding is critical, produce the exact fix or next debugging step and prefer a GitHub issue or draft PR when GitHub write access is configured; otherwise hand off via OpenClaw chat. Avoid generic growth ideas."
+        "focusAreas": ["analytics_anomaly", "onboarding", "conversion", "paywall", "purchase", "retention", "revenue"],
+        "sourcePriorities": ["analytics", "revenuecat", "paddle", "asc_cli", "feedback", "github", "sentry", "glitchtip", "coolify"],
+        "objective": "Detect non-Sentry product and payment anomalies that affect real users: broken login or account flows inferred from behavior, onboarding or purchase drop-offs, zero-conversion days, missing buyers, very low active users, retention cliffs, and revenue anomalies.",
+        "instructions": "Compare AnalyticsCLI, RevenueCat, Paddle, ASC, feedback, memory/state, and recent code changes against recent baselines. Use Sentry/GlitchTip/Coolify only as corroborating context; do not repeat pure crash or deployment alerts that belong to the 90-minute healthcheck."
       },
       {
         "key": "weekly",
         "title": "Weekly executive product and growth summary",
         "intervalDays": 7,
         "criticalOnly": false,
-        "focusAreas": ["conversion", "paywall", "onboarding", "marketing", "retention", "stability"],
-        "sourcePriorities": ["analytics", "revenuecat", "asc_cli", "feedback", "sentry", "github"],
-        "objective": "Create an executive summary across all configured projects, connectors, recent releases, code changes, revenue, activation, retention, reviews, and production stability.",
-        "instructions": "Pick one to three high-confidence improvements with evidence, expected KPI movement, likely code/store surfaces, owner-ready next steps, and a verification plan. Create GitHub issues or draft PR proposals only when the evidence is specific enough."
+        "focusAreas": ["conversion", "paywall", "onboarding", "marketing", "retention", "stability", "seo"],
+        "sourcePriorities": ["analytics", "revenuecat", "paddle", "seo", "asc_cli", "feedback", "sentry", "coolify", "github"],
+        "objective": "Create a deep app-by-app executive summary across all configured projects, connectors, recent releases, code changes, traffic, SEO/acquisition, revenue, activation, conversion, retention, reviews, and production stability.",
+        "instructions": "Be detailed. Group findings per app, explain why each recommendation should improve app usage, revenue, conversion, retention, or traffic, include expected KPI movement, likely code/store surfaces, owner-ready next steps, and verification plans. Generate charts when they clarify the evidence."
       },
       {
         "key": "monthly",
         "title": "Monthly deep product, business, and code review",
         "intervalDays": 30,
         "criticalOnly": false,
-        "focusAreas": ["conversion", "paywall", "retention", "marketing", "onboarding", "codebase"],
-        "sourcePriorities": ["analytics", "revenuecat", "asc_cli", "feedback", "sentry", "github"],
-        "objective": "Compare all configured projects month-over-month: MRR, trial conversion, churn, acquisition quality, store conversion, retention, review themes, feature usage, crash totals, and codebase changes.",
-        "instructions": "Decide what should be built, changed, deleted, or instrumented next. Tie conclusions to connector data plus codebase evidence and explain why each recommendation should move revenue, activation, retention, stability, or acquisition quality."
+        "focusAreas": ["conversion", "paywall", "retention", "marketing", "onboarding", "codebase", "seo"],
+        "sourcePriorities": ["analytics", "revenuecat", "paddle", "seo", "asc_cli", "feedback", "sentry", "coolify", "github"],
+        "objective": "Compare all configured projects month-over-month: MRR, trial conversion, churn, Paddle revenue/subscriber movement, SEO demand/clicks, acquisition quality, store conversion, retention, review themes, feature usage, crash totals, and codebase changes.",
+        "instructions": "Be very detailed and app-grouped. Decide what should be built, changed, deleted, priced differently, marketed differently, or instrumented next. Tie conclusions to connector data plus codebase evidence and explain why each recommendation should move revenue, conversion, retention, traffic, or acquisition quality. Generate charts when useful."
       },
       {
         "key": "quarterly",
-        "title": "Quarterly positioning, pricing, and roadmap review",
+        "title": "3-month positioning, pricing, and roadmap review",
         "intervalDays": 91,
         "criticalOnly": false,
         "focusAreas": ["marketing", "paywall", "retention", "conversion", "onboarding"],
-        "sourcePriorities": ["analytics", "revenuecat", "asc_cli", "feedback", "github", "sentry"],
-        "objective": "Revisit positioning, pricing/packaging, onboarding architecture, roadmap assumptions, tracking quality, codebase constraints, and major funnel bets across every configured project.",
-        "instructions": "Find structural constraints and durable opportunities. Tie recommendations to cohort behavior, monetization, reviews, channel quality, and shipped changes."
+        "sourcePriorities": ["analytics", "revenuecat", "paddle", "seo", "asc_cli", "feedback", "github", "sentry"],
+        "objective": "Revisit positioning, pricing/packaging, onboarding architecture, roadmap assumptions, tracking quality, codebase constraints, and major funnel bets across every configured app.",
+        "instructions": "Find structural constraints and durable opportunities, not small UI tweaks. Group the analysis by app and tie recommendations to cohort behavior, monetization, reviews, channel quality, and shipped changes. Include concrete roadmap, pricing, conversion, and traffic recommendations."
       },
       {
         "key": "six_months",
         "title": "Six-month instrumentation and growth-system audit",
         "intervalDays": 182,
         "criticalOnly": false,
-        "focusAreas": ["retention", "conversion", "paywall", "marketing", "general"],
-        "sourcePriorities": ["analytics", "revenuecat", "asc_cli", "feedback", "sentry"],
-        "objective": "Audit connector coverage, SDK instrumentation, event taxonomy, data reliability, memory, growth loops, and whether product/code strategy still matches the best users across configured projects.",
-        "instructions": "Prioritize measurement fixes and system changes that make future analysis more trustworthy. Identify stale events, missing attribution, weak identity, and misleading dashboards."
+        "focusAreas": ["retention", "conversion", "paywall", "marketing", "general", "seo"],
+        "sourcePriorities": ["analytics", "revenuecat", "paddle", "seo", "asc_cli", "feedback", "sentry"],
+        "objective": "Audit connector coverage, SDK instrumentation, event taxonomy, data reliability, memory, growth loops, and whether product/code strategy still matches the best users across configured apps.",
+        "instructions": "Group by app. Prioritize measurement fixes and system changes that make future analysis more trustworthy, then identify the highest-leverage app/revenue/conversion/traffic improvements. Identify stale events, missing attribution, weak identity, broken feedback loops, and misleading dashboards."
       },
       {
         "key": "yearly",
@@ -115,41 +162,25 @@
         "intervalDays": 365,
         "criticalOnly": false,
         "focusAreas": ["marketing", "retention", "paywall", "conversion", "general"],
-        "sourcePriorities": ["analytics", "revenuecat", "asc_cli", "feedback", "sentry"],
+        "sourcePriorities": ["analytics", "revenuecat", "paddle", "seo", "asc_cli", "feedback", "sentry"],
         "objective": "Reset strategy from evidence across every configured project: market/channel fit, monetization model, retention ceiling, product scope, and whether to double down, reposition, rebuild, or sunset major surfaces/features.",
         "instructions": "Use the full year of memory, releases, revenue, acquisition, reviews, code changes, and cohort behavior. Produce strategic experiments and stop-doing decisions."
       }
     ]
   },
-  "strategy": {
-    "proposalMode": "balanced"
-  },
-  "deliveries": {
-    "openclawChat": {
-      "enabled": true,
-      "markdownPath": ".openclaw/chat/latest.md",
-      "jsonPath": ".openclaw/chat/latest.json"
-    },
-    "github": {
-      "enabled": false,
-      "mode": "issue",
-      "autoCreate": false,
-      "draftPullRequests": true,
-      "proposalBranchPrefix": "openclaw/proposals"
-    },
-    "slack": {
-      "enabled": false,
-      "webhookEnv": "SLACK_WEBHOOK_URL"
-    },
-    "webhook": {
-      "enabled": false,
-      "urlEnv": "OPENCLAW_WEBHOOK_URL",
-      "method": "POST",
-      "headers": {}
-    }
+  "actions": {
+    "mode": "issue",
+    "outputDestinations": ["openclaw_chat", "github_issue"],
+    "productionErrorMode": "issue",
+    "autoCreateIssues": true,
+    "autoCreatePullRequests": false,
+    "autoCreateWhenGitHubWriteAccess": true,
+    "disableAutoCreateGitHubArtifacts": false,
+    "draftPullRequests": true,
+    "proposalBranchPrefix": "openclaw/proposals"
   },
   "charting": {
-    "enabled": false,
+    "enabled": true,
     "command": null
   },
   "notifications": {
@@ -176,6 +207,28 @@
       ]
     }
   },
+  "automation": {
+    "openclawCron": {
+      "enabled": true,
+      "mode": "main",
+      "schedule": "*/30 * * * *",
+      "timezone": "UTC",
+      "name": "OpenClaw Growth Engineer scheduler",
+      "delivery": {
+        "enabled": true,
+        "mode": "announce",
+        "channel": "last",
+        "to": ""
+      }
+    },
+    "hermesCron": {
+      "enabled": true,
+      "schedule": "*/30 * * * *",
+      "name": "Hermes Growth Engineer scheduler",
+      "skill": "growth-engineer",
+      "deliver": "local"
+    }
+  },
   "security": {
     "connectorSecrets": {
       "mode": "openclaw-secret-refs",
@@ -191,7 +244,17 @@
     "analyticsTokenRef": { "source": "env", "provider": "default", "id": "ANALYTICSCLI_ACCESS_TOKEN" },
     "revenuecatTokenEnv": "REVENUECAT_API_KEY",
     "revenuecatTokenRef": { "source": "env", "provider": "default", "id": "REVENUECAT_API_KEY" },
+    "paddleTokenEnv": "PADDLE_API_KEY",
+    "paddleTokenRef": { "source": "env", "provider": "default", "id": "PADDLE_API_KEY" },
+    "gscTokenEnv": "GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN",
+    "gscTokenRef": { "source": "env", "provider": "default", "id": "GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN" },
+    "dataforseoLoginEnv": "DATAFORSEO_LOGIN",
+    "dataforseoLoginRef": { "source": "env", "provider": "default", "id": "DATAFORSEO_LOGIN" },
+    "dataforseoPasswordEnv": "DATAFORSEO_PASSWORD",
+    "dataforseoPasswordRef": { "source": "env", "provider": "default", "id": "DATAFORSEO_PASSWORD" },
     "sentryTokenEnv": "SENTRY_AUTH_TOKEN",
-    "sentryTokenRef": { "source": "env", "provider": "default", "id": "SENTRY_AUTH_TOKEN" }
+    "sentryTokenRef": { "source": "env", "provider": "default", "id": "SENTRY_AUTH_TOKEN" },
+    "coolifyTokenEnv": "COOLIFY_API_TOKEN",
+    "coolifyTokenRef": { "source": "env", "provider": "default", "id": "COOLIFY_API_TOKEN" }
   }
 }