gtm-now 0.10.12 → 0.10.13

package/dist/index.js

@@ -12770,10 +12770,11 @@ var init_provision = __esm({
                 "export_mailboxes",
                 "create_plusvibe_client",
                 "save_config",
+                "deploy_crm",
                 "start_provision",
                 "status"
               ],
-              description: "Action: check_domains (availability), check_balance (Zapmail wallet), buy_domains (purchase via wallet), list_domains (show all with status), list_mailboxes (show mailboxes), setup_dmarc (configure DMARC for domains), create_mailboxes (create on specific domains), export_mailboxes (export to PlusVibe), create_plusvibe_client (create client in existing workspace), save_config (persist provider config to ~/.gtm/config.yaml), start_provision (trigger full pipeline), status (check progress)"
+              description: "Action: check_domains (availability), check_balance (Zapmail wallet), buy_domains (purchase via wallet), list_domains (show all with status), list_mailboxes (show mailboxes), setup_dmarc (configure DMARC for domains), create_mailboxes (create on specific domains), export_mailboxes (export to PlusVibe), create_plusvibe_client (create client in existing workspace), save_config (persist provider config to ~/.gtm/config.yaml), deploy_crm (generate Twenty CRM deployment instructions for Railway), start_provision (trigger full pipeline), status (check progress)"
             },
             domains: {
               type: "array",
@@ -13280,7 +13281,7 @@ Note: HarvestAPI charges per request. For engagement mining, each post lookup co
       gtm_feedback: "Submit feedback, bug reports, feature requests, or provider requests. Feedback is stored for the gtm-now maintainers to review.",
       gtm_review: "Push data to a visual review table hosted at view.gtmnow.com. Users see an interactive AG Grid in their browser with checkboxes to select/deselect rows. Creates a temporary table (24h TTL) with a shareable URL. Use after finding companies or contacts to let the user review before spending enrichment credits. Three actions: create (new table from data array), update (modify existing table \u2014 add columns, update rows), get_selected (fetch only the rows the user has checked).",
       gtm_batch: 'Process a CSV file through a pipeline of GTM tool steps. Each row runs through each step sequentially \u2014 results are extracted as new columns in the output CSV. Use rows: "0:1" to pilot on a single row before full execution, and dry_run: true to preview without API calls. Template placeholders ({{column}}) are replaced with row values. Multiple steps can form a waterfall: set waterfall: true on later steps to skip rows already filled by earlier steps.',
-      gtm_provision: "Infrastructure provisioning for client setup. Twelve actions: check_domains (Zapmail domain availability), check_balance (Zapmail wallet), buy_domains (purchase via wallet), list_domains (all domains with status), list_mailboxes (mailboxes for a domain), setup_dmarc (DMARC for domain IDs), create_mailboxes (mailboxes on domains), export_mailboxes (export to PlusVibe/Instantly), create_plusvibe_client (client in existing workspace), save_config (persist provider config), start_provision (trigger full provisioning pipeline via gtm-api), status (check provisioning progress).",
+      gtm_provision: "Infrastructure provisioning for client setup. Thirteen actions: check_domains (Zapmail domain availability), check_balance (Zapmail wallet), buy_domains (purchase via wallet), list_domains (all domains with status), list_mailboxes (mailboxes for a domain), setup_dmarc (DMARC for domain IDs), create_mailboxes (mailboxes on domains), export_mailboxes (export to PlusVibe/Instantly), create_plusvibe_client (client in existing workspace), save_config (persist provider config), deploy_crm (Twenty CRM deployment instructions for Railway), start_provision (trigger full provisioning pipeline via gtm-api), status (check provisioning progress).",
       // ─── Maestro (Knowledge Graph) ────────────────────────
       maestro_get_context: "Assemble full business context from the knowledge graph using a named strategy (call_prep, content_generation, lead_scoring, personalization, campaign_planning, general). Each strategy tunes which entities are included and their priority. Optionally narrow by query string or persona_id.",
       maestro_upsert_product: "Create or update a product in the knowledge graph. Products are what the business sells \u2014 services, courses, SaaS, consulting packages. Upserts by owner_id + name.",
@@ -16137,6 +16138,8 @@ async function handleProvision(args, ctx) {
       return createPlusVibeClient(a, ctx);
     case "save_config":
       return saveConfig(a, ctx);
+    case "deploy_crm":
+      return deployCrm(a, ctx);
     case "start_provision":
       return startProvision(a);
     case "status":
@@ -16353,6 +16356,120 @@ async function saveConfig(args, ctx) {
     fields: Object.keys(args.config_values)
   };
 }
+async function deployCrm(args, ctx) {
+  if (!args.name) throw new Error("name is required for deploy_crm (client name)");
+  const clientSlug = args.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/-+$/, "");
+  const projectName = `twenty-${clientSlug}`;
+  const serviceName = `twenty-crm-${clientSlug}`;
+  const config = ctx.session.getActiveContext().config;
+  const existingUrl = config.providers.twenty?.base_url;
+  const existingKey = config.providers.twenty?.api_key;
+  const steps = [];
+  steps.push({
+    step: 1,
+    title: "Create Railway project",
+    type: "cli",
+    commands: [
+      `railway login`,
+      `railway init --name ${projectName}`
+    ],
+    notes: "Creates a new Railway project. Skip if project already exists."
+  });
+  steps.push({
+    step: 2,
+    title: "Deploy Twenty CRM service",
+    type: "cli",
+    commands: [
+      `railway add --service ${serviceName}`,
+      `railway variables set SERVER_URL=https://${serviceName}.up.railway.app -s ${serviceName}`,
+      `railway variables set FRONT_BASE_URL=https://${serviceName}.up.railway.app -s ${serviceName}`,
+      `railway variables set IS_SIGN_UP_DISABLED=true -s ${serviceName}`,
+      `railway variables set NODE_ENV=production -s ${serviceName}`
+    ],
+    notes: "Uses Twenty Docker image twentycrm/twenty:latest. Alternatively deploy from Railway template: https://railway.app/template/twenty",
+    env_vars: {
+      SERVER_URL: `https://${serviceName}.up.railway.app`,
+      FRONT_BASE_URL: `https://${serviceName}.up.railway.app`,
+      IS_SIGN_UP_DISABLED: "true"
+    }
+  });
+  steps.push({
+    step: 3,
+    title: "Add PostgreSQL database",
+    type: "cli",
+    commands: [
+      `railway add --database postgres --service ${serviceName}-db`,
+      `railway variables set DATABASE_URL=\${{${serviceName}-db.DATABASE_URL}} -s ${serviceName}`
+    ],
+    notes: "Twenty requires PostgreSQL 15+. Railway provisions this automatically."
+  });
+  steps.push({
+    step: 4,
+    title: "Add Redis cache",
+    type: "cli",
+    commands: [
+      `railway add --database redis --service ${serviceName}-redis`,
+      `railway variables set REDIS_URL=\${{${serviceName}-redis.REDIS_URL}} -s ${serviceName}`
+    ],
+    notes: "Required for Twenty job queue and caching."
+  });
+  steps.push({
+    step: 5,
+    title: "Deploy and wait for health",
+    type: "cli",
+    commands: [
+      `railway up -s ${serviceName} --image twentycrm/twenty:latest`,
+      `# Wait ~2-3 minutes for first deploy`,
+      `# Verify: curl https://${serviceName}.up.railway.app/healthz`
+    ],
+    notes: "First deploy runs database migrations automatically. May take 2-3 minutes."
+  });
+  steps.push({
+    step: 6,
+    title: "Create admin account",
+    type: "manual",
+    notes: `Open https://${serviceName}.up.railway.app in browser. Sign up is enabled on first visit (even with IS_SIGN_UP_DISABLED). Create an admin account with email: ${args.email ?? `admin@${clientSlug}.com`}. After first account creation, sign-up is locked.`
+  });
+  steps.push({
+    step: 7,
+    title: "Generate API key",
+    type: "manual",
+    notes: `In Twenty dashboard \u2192 Settings \u2192 API Keys \u2192 Generate. Copy the API key \u2014 needed for gtm-now configuration.`
+  });
+  steps.push({
+    step: 8,
+    title: "Save CRM config to gtm-now",
+    type: "automated",
+    commands: [
+      `gtm exec gtm_provision --arg action=save_config --arg provider=twenty --arg 'config_values={"api_key":"<API_KEY_FROM_STEP_7>","base_url":"https://${serviceName}.up.railway.app"}'`
+    ],
+    notes: "Replace <API_KEY_FROM_STEP_7> with the actual key. " + (args.client_name ? `Will save under client "${args.client_name}".` : "Will save under the active client config.")
+  });
+  steps.push({
+    step: 9,
+    title: "Verify CRM connection",
+    type: "automated",
+    commands: [
+      `gtm exec gtm_crm --arg action=find --arg 'query={"email":"test@verify.com"}'`,
+      `gtm exec gtm_status --arg provider=twenty`
+    ],
+    notes: "Should return empty results (no error). Status should show twenty as connected."
+  });
+  return {
+    action: "deploy_crm",
+    crm: "twenty",
+    project: projectName,
+    service: serviceName,
+    base_url: existingUrl ?? `https://${serviceName}.up.railway.app`,
+    already_configured: !!(existingUrl && existingKey),
+    total_steps: steps.length,
+    cli_steps: steps.filter((s) => s.type === "cli").length,
+    manual_steps: steps.filter((s) => s.type === "manual").length,
+    steps,
+    railway_template_url: "https://railway.app/template/twenty",
+    note: "Railway template is the fastest path \u2014 1-click deploy, then only steps 6-9 are needed."
+  };
+}
 var init_provision2 = __esm({
   "src/handlers/provision.ts"() {
     "use strict";
@@ -18744,11 +18861,12 @@ var init_validation = __esm({
             "export_mailboxes",
             "create_plusvibe_client",
             "save_config",
+            "deploy_crm",
             "start_provision",
             "status"
           ],
           {
-            message: "action must be one of: check_domains, check_balance, buy_domains, list_domains, list_mailboxes, setup_dmarc, create_mailboxes, export_mailboxes, create_plusvibe_client, save_config, start_provision, status"
+            message: "action must be one of: check_domains, check_balance, buy_domains, list_domains, list_mailboxes, setup_dmarc, create_mailboxes, export_mailboxes, create_plusvibe_client, save_config, deploy_crm, start_provision, status"
           }
         ),
         domains: z2.array(z2.string()).optional(),