@growthub/cli 0.3.54 → 0.3.56

package/assets/worker-kits/growthub-twenty-crm-v1/examples/lead-enrichment-sample.md

@@ -0,0 +1,117 @@
+# Lead Enrichment Pipeline — Growthub (SAMPLE)
+
+**Date:** 2026-04-15  
+**Kit:** `growthub-twenty-crm-v1`  
+**Mode:** `cloud`
+
+> **Note:** This is a sample output. Adapt all values to the actual client context.
+
+---
+
+## 1. ENRICHMENT PROVIDER(S)
+
+| Provider | Auth mechanism | Data tier | Primary use |
+|---|---|---|---|
+| Apollo | Bearer token | Person + Company | Outbound lead source |
+| Clay | API key | Person + Company | Enrichment waterfall (email verification + firmographic) |
+
+---
+
+## 2. SOURCE FIELDS PROVIDED
+
+### Apollo — Person fields
+
+| Provider field | Data type | Example value |
+|---|---|---|
+| `first_name` | string | `Jane` |
+| `last_name` | string | `Doe` |
+| `email` | string | `jane@acme.com` |
+| `title` | string | `Head of Growth` |
+| `seniority` | string | `director` |
+| `linkedin_url` | string | `https://linkedin.com/in/janedoe` |
+| `city` | string | `San Francisco` |
+| `organization.name` | string | `Acme Corp` |
+| `organization.website_url` | string | `https://acme.com` |
+| `organization.estimated_num_employees` | integer | `250` |
+
+---
+
+## 3. DEDUPLICATION STRATEGY
+
+**Person dedup key:** `emails.primaryEmail`  
+**Company dedup key:** `domain`  
+**Secondary person key (when email unavailable):** `linkedInLink.url`
+
+**Dedup behavior:**
+- Match found → **merge** (update existing record with enriched fields, preserve existing data)
+- No match found → **insert** (create new record)
+- If both email and LinkedIn are absent → **skip and log** for manual review
+
+---
+
+## 4. IMPORT MODE
+
+**Selected mode:** `merge-with-insert-fallback`
+
+**Rationale:** Growthub has existing contacts from previous manual spreadsheet work. Merging ensures enrichment data layers on top without creating duplicates.
+
+---
+
+## 5. IMPORT METHOD
+
+**Method:** CSV import via Twenty UI (first batch), then GraphQL mutation batch (ongoing enrichment)
+
+**Import sequence:**
+1. Export Apollo contact list as CSV with all available fields selected
+2. Clean CSV: lowercase all emails, strip `https://` and trailing slashes from domain field
+3. Import Company records first (Settings > Companies > Import)
+4. Import Person records second with company linking enabled
+5. Run post-import audit
+
+**Batch size recommendation:** 500 records per batch
+
+---
+
+## 6. FIELD MAPPING (SUMMARY)
+
+| Source field | → | Twenty object | Twenty field | Transformation |
+|---|---|---|---|---|
+| `email` | → | `Person` | `emails.primaryEmail` | lowercase, trim |
+| `first_name` | → | `Person` | `name.firstName` | none |
+| `last_name` | → | `Person` | `name.lastName` | none |
+| `title` | → | `Person` | `position` | none |
+| `linkedin_url` | → | `Person` | `linkedInLink.url` | none |
+| `city` | → | `Person` | `city` | none |
+| `organization.name` | → | `Company` | `name` | none |
+| `organization.website_url` | → | `Company` | `domain` | strip `https://` and trailing `/` |
+| `organization.estimated_num_employees` | → | `Company` | `employees` | integer cast |
+
+---
+
+## 7. POST-IMPORT VALIDATION
+
+| Check | Expected result | Actual result |
+|---|---|---|
+| Total Person records imported | ~1,200 | [fill after import] |
+| Total Company records imported | ~400 | [fill after import] |
+| Duplicate email check | 0 duplicates | [fill after import] |
+| Company linkage rate | ≥ 90% | [fill after import] |
+| Skipped records (no email) | < 5% | [fill after import] |
+
+---
+
+## 8. ERROR AND FAILURE HANDLING
+
+| Error type | Behavior | Resolution |
+|---|---|---|
+| Invalid email format | Skip record, log to `enrichment-errors.csv` | Manual review and clean |
+| Duplicate email (post-dedup) | Merge into existing record | Review merged record for accuracy |
+| Missing company domain | Create Company with name only; flag for manual domain entry | Review flagged companies weekly |
+| API rate limit hit | Pause 30 seconds, retry with smaller batch | Reduce to 250 records/batch |
+
+---
+
+## 9. UPDATE FREQUENCY
+
+**Enrichment cadence:** Weekly on Monday mornings  
+**Trigger:** Apollo saves a new export on Sundays; enrichment job runs at 6 AM Monday via cron

package/assets/worker-kits/growthub-twenty-crm-v1/examples/pipeline-automation-sample.md

@@ -0,0 +1,132 @@
+# Pipeline Automation Brief — Growthub (SAMPLE)
+
+**Date:** 2026-04-15  
+**Kit:** `growthub-twenty-crm-v1`  
+**Mode:** `cloud`
+
+> **Note:** This is a sample output. Adapt all values to the actual client context.
+
+---
+
+## AUTOMATION INVENTORY
+
+| # | Automation name | Trigger | Action | Status |
+|---|---|---|---|---|
+| 1 | Lead Qualified — Assign Rep + Create Follow-Up Task | Stage changes to QUALIFIED | Assign owner, create Task | planned |
+| 2 | Demo Scheduled — Notify Slack | Stage changes to DEMO | Send outbound webhook to Slack | planned |
+| 3 | Closed Won — Create Customer Onboarding Task | Stage changes to CLOSED_WON | Create Task, update field | planned |
+
+---
+
+## AUTOMATION 1 — LEAD QUALIFIED: ASSIGN REP AND CREATE FOLLOW-UP TASK
+
+**Purpose:** When a lead's stage changes to QUALIFIED, assign the opportunity to the next available sales rep (round-robin, two reps) and create a follow-up task due in 24 hours.
+
+### Trigger
+
+| Property | Value |
+|---|---|
+| Trigger type | `on_field_change` |
+| Target object | `Opportunity` |
+| Field | `stage` |
+| Previous value | any (except QUALIFIED) |
+| New value | `QUALIFIED` |
+
+### Action sequence
+
+| Step | Action type | Target | Parameters |
+|---|---|---|---|
+| 1 | `assign_owner` | `Opportunity` | Round-robin between [Sales Rep 1 ID] and [Sales Rep 2 ID] |
+| 2 | `create_task` | `Person` (pointOfContact) | `title: "Follow up with [Person name]", dueAt: +24h, assignee: opportunity.assignee` |
+| 3 | `update_field` | `Opportunity` | `qualifiedAt: now()` (custom date field) |
+
+### Failure behavior
+
+**If step 1 fails (assignment):** Assign to CRM Admin as fallback  
+**If step 2 fails (task creation):** Retry once after 60 seconds; if still failing, send in-app notification to CRM Admin  
+**If step 3 fails (field update):** Log error; non-critical, do not halt
+
+### Monitoring
+
+Check the automation execution log in Twenty > Settings > Workflows weekly. Expected volume: 5–15 triggers per week.
+
+---
+
+## AUTOMATION 2 — DEMO SCHEDULED: NOTIFY SLACK
+
+**Purpose:** When a deal enters the DEMO stage, post a message to the #sales-pipeline Slack channel so the full team sees demo activity in real time.
+
+### Trigger
+
+| Property | Value |
+|---|---|
+| Trigger type | `on_field_change` |
+| Target object | `Opportunity` |
+| Field | `stage` |
+| Previous value | `QUALIFIED` |
+| New value | `DEMO` |
+
+### Action sequence
+
+| Step | Action type | Target | Parameters |
+|---|---|---|---|
+| 1 | `send_webhook` | Slack Incoming Webhook URL | See payload below |
+
+**Slack payload:**
+
+```json
+{
+  "text": "🎯 Demo stage reached: *{{opportunity.name}}* — assigned to {{opportunity.assignee.name}}. Close date: {{opportunity.closeDate}}",
+  "channel": "#sales-pipeline"
+}
+```
+
+### Failure behavior
+
+**If webhook fails:** Retry 3× (5s, 15s, 45s). If all retries fail: log error and send in-app notification to CRM Admin. Non-critical — pipeline is not blocked.
+
+---
+
+## AUTOMATION 3 — CLOSED WON: CREATE ONBOARDING TASK
+
+**Purpose:** When a deal is marked as CLOSED_WON, automatically create a customer onboarding task assigned to the CS Manager.
+
+### Trigger
+
+| Property | Value |
+|---|---|
+| Trigger type | `on_field_change` |
+| Target object | `Opportunity` |
+| Field | `stage` |
+| Previous value | any |
+| New value | `CLOSED_WON` |
+
+### Action sequence
+
+| Step | Action type | Target | Parameters |
+|---|---|---|---|
+| 1 | `create_task` | `Person` (pointOfContact) | `title: "Onboard [Person name] — [Company name]", dueAt: +3 days, assignee: [CS Manager ID]` |
+| 2 | `update_field` | `Opportunity` | `closedAt: now()` (custom date field) |
+| 3 | `send_webhook` | Slack Incoming Webhook | Post to #customer-success: "New customer: [Company name]" |
+
+### Failure behavior
+
+**If task creation fails:** Retry once; then send email notification to CS Manager directly  
+**If Slack webhook fails:** Retry 3×; if all fail, log — non-critical
+
+---
+
+## AUTOMATION DESIGN DECISIONS
+
+| Decision | Choice | Rationale |
+|---|---|---|
+| Assignment method | Round-robin (2 reps) | Equal load distribution; no territory segmentation needed at current team size |
+| Slack notification trigger | Stage change to DEMO (not QUALIFIED) | QUALIFIED happens frequently (5–15/week); only DEMO warrants team visibility |
+| Onboarding task assignee | CS Manager (fixed) | Single CS contact at current team size; revisit when team grows |
+
+---
+
+## OPEN QUESTIONS
+
+- [ ] Should the Closed Won Slack notification include the deal amount? (confirm with head of sales)
+- [ ] What is the round-robin assignment rule when one rep is on leave — assign to the other rep only, or default to CRM Admin?

package/assets/worker-kits/growthub-twenty-crm-v1/growthub-meta/README.md

@@ -0,0 +1,114 @@
+# Growthub Agent Worker Kit — Twenty CRM v1
+
+**Kit ID:** `growthub-twenty-crm-v1`  
+**Version:** `1.0.0`  
+**Type:** `worker`  
+**Execution mode:** `export`
+
+---
+
+## What this kit does
+
+This kit gives an agent a self-contained environment for implementing, configuring, and operating Twenty CRM — the open-source Salesforce/Apollo alternative — as a growth stack foundation.
+
+It packages:
+- agent operating instructions
+- a locked CRM methodology
+- runtime and deployment assumptions
+- API, webhook, and data model reference docs
+- CRM implementation templates (12 templates)
+- example output artifacts (4 complete samples)
+- brand kit system
+- output standards
+- setup scripts for local-fork and cloud modes
+- contributor metadata
+
+The intended operator is a growth engineer, CRM consultant, or AI agent responsible for implementing Twenty CRM for a B2B team and building enrichment pipelines, pipeline automations, and integration handoffs on top of it.
+
+---
+
+## Folder structure
+
+```text
+growthub-twenty-crm-v1/
+├── kit.json
+├── bundles/
+├── workers/
+│   └── twenty-crm-operator/
+│       └── CLAUDE.md
+├── brands/
+│   ├── _template/brand-kit.md
+│   ├── growthub/brand-kit.md
+│   └── NEW-CLIENT.md
+├── setup/
+│   ├── clone-fork.sh
+│   ├── verify-env.mjs
+│   └── check-deps.sh
+├── templates/
+│   ├── crm-setup-brief.md
+│   ├── data-model-design.md
+│   ├── lead-enrichment-pipeline.md
+│   ├── pipeline-automation-brief.md
+│   ├── webhook-integration-spec.md
+│   ├── api-query-plan.md
+│   ├── crm-playbook.md
+│   ├── custom-object-design.md
+│   ├── import-mapping.md
+│   ├── workspace-config-checklist.md
+│   ├── integration-handoff.md
+│   └── enrichment-field-map.md
+├── examples/
+│   ├── crm-setup-sample.md
+│   ├── lead-enrichment-sample.md
+│   ├── pipeline-automation-sample.md
+│   └── crm-playbook-sample.md
+├── docs/
+│   ├── twenty-fork-integration.md
+│   ├── api-and-webhooks.md
+│   └── data-model-layer.md
+├── output/
+│   └── README.md
+├── growthub-meta/
+│   ├── README.md
+│   └── kit-standard.md
+├── skills.md
+├── output-standards.md
+├── runtime-assumptions.md
+├── validation-checklist.md
+├── QUICKSTART.md
+└── .env.example
+```
+
+---
+
+## Activation
+
+1. Export the kit via `growthub kit download growthub-twenty-crm-v1`.
+2. Point the agent working directory at the expanded folder.
+3. The agent reads `workers/twenty-crm-operator/CLAUDE.md`.
+4. `skills.md` provides the working method for every session.
+
+---
+
+## Supported output categories
+
+- CRM setup brief
+- data model design
+- lead enrichment pipeline
+- pipeline automation brief
+- webhook integration spec
+- API query plan
+- custom object design
+- import mapping
+- workspace config checklist
+- integration handoff
+- enrichment field map
+- CRM playbook
+
+---
+
+## Source repository
+
+Twenty CRM: [github.com/twentyhq/twenty](https://github.com/twentyhq/twenty)  
+License: MIT  
+Stack: TypeScript / React / NestJS / PostgreSQL / Redis

package/assets/worker-kits/growthub-twenty-crm-v1/growthub-meta/kit-standard.md

@@ -0,0 +1,61 @@
+# Kit Standard — Twenty CRM v1
+
+This document defines the locked contract for this kit.
+
+---
+
+## Required files contract
+
+Every path in `kit.json -> frozenAssetPaths` must exist in every valid release.
+
+---
+
+## Bundle contract
+
+The bundle manifest must remain aligned with `kit.json`:
+- `bundle.kitId` matches `kit.id`
+- `bundle.workerId` matches `entrypoint.workerId`
+- `requiredFrozenAssets` stays a subset of `frozenAssetPaths`
+
+---
+
+## Agent operating rules
+
+The entrypoint file is the operating law. `skills.md` is the methodology.
+
+Required invariants:
+- strict workflow order (Steps 0–10)
+- environment gate passes before any planning work
+- data model is defined before automation or enrichment pipelines
+- deployment mode is always labeled in every output
+- deduplication key is named in every enrichment or import artifact
+- every automation trigger-action pair has a documented failure path
+- no secrets are stored in any kit file or output artifact
+- outputs are operational artifacts, not ideation-only text
+
+---
+
+## Runtime rules
+
+- no secrets stored in kit files
+- agent-only mode is always a valid fallback — no live CRM required for planning work
+- cloud, self-hosted, and local-fork modes are all first-class
+- outputs are Markdown only
+- field names use Twenty's naming conventions (camelCase for fields, PascalCase for objects)
+- SELECT option values use SCREAMING_SNAKE_CASE
+
+---
+
+## Versioning rules
+
+Additive template/docs changes are minor-version work. Entrypoint path changes, export name changes, or fundamental workflow changes require a major version bump.
+
+---
+
+## Scope rules
+
+This kit is scoped to Twenty CRM implementation planning and operator documentation. It does not:
+- provide a live CRM dashboard
+- write application code (it produces specs and handoffs for developers)
+- manage infrastructure directly
+- store client data in kit files

package/assets/worker-kits/growthub-twenty-crm-v1/kit.json

@@ -0,0 +1,108 @@
+{
+  "schemaVersion": 2,
+  "kit": {
+    "id": "growthub-twenty-crm-v1",
+    "version": "1.0.0",
+    "name": "Growthub Agent Worker Kit — Twenty CRM",
+    "description": "Self-contained local execution environment for Twenty CRM — the open-source Salesforce/Apollo alternative. Produces CRM setup plans, data model designs, lead enrichment pipelines, pipeline automation briefs, webhook integration specs, API query plans, and client-ready CRM playbooks for teams adopting Twenty as their growth stack foundation.",
+    "type": "worker",
+    "visibility": "public-open-source",
+    "sourceRepo": "growthub-local",
+    "family": "studio"
+  },
+  "entrypoint": {
+    "workerId": "twenty-crm-operator",
+    "path": "workers/twenty-crm-operator/CLAUDE.md"
+  },
+  "workerIds": [
+    "twenty-crm-operator"
+  ],
+  "agentContractPath": "workers/twenty-crm-operator/CLAUDE.md",
+  "brandTemplatePath": "brands/_template/brand-kit.md",
+  "publicExampleBrandPaths": [
+    "brands/growthub/brand-kit.md"
+  ],
+  "frozenAssetPaths": [
+    "QUICKSTART.md",
+    ".env.example",
+    "skills.md",
+    "output-standards.md",
+    "runtime-assumptions.md",
+    "validation-checklist.md",
+    "workers/twenty-crm-operator/CLAUDE.md",
+    "brands/_template/brand-kit.md",
+    "brands/growthub/brand-kit.md",
+    "brands/NEW-CLIENT.md",
+    "setup/clone-fork.sh",
+    "setup/verify-env.mjs",
+    "setup/check-deps.sh",
+    "output/README.md",
+    "templates/crm-setup-brief.md",
+    "templates/data-model-design.md",
+    "templates/lead-enrichment-pipeline.md",
+    "templates/pipeline-automation-brief.md",
+    "templates/webhook-integration-spec.md",
+    "templates/api-query-plan.md",
+    "templates/crm-playbook.md",
+    "templates/custom-object-design.md",
+    "templates/import-mapping.md",
+    "templates/workspace-config-checklist.md",
+    "templates/integration-handoff.md",
+    "templates/enrichment-field-map.md",
+    "examples/crm-setup-sample.md",
+    "examples/lead-enrichment-sample.md",
+    "examples/pipeline-automation-sample.md",
+    "examples/crm-playbook-sample.md",
+    "docs/twenty-fork-integration.md",
+    "docs/api-and-webhooks.md",
+    "docs/data-model-layer.md",
+    "growthub-meta/README.md",
+    "growthub-meta/kit-standard.md"
+  ],
+  "setupPaths": {
+    "quickstart": "QUICKSTART.md",
+    "envExample": ".env.example",
+    "setupDir": "setup/",
+    "outputDir": "output/"
+  },
+  "outputStandard": {
+    "type": "working-directory",
+    "description": "Exported folder is intended to be pointed at directly by the agent Working Directory. All outputs are Markdown files written to output/<client-slug>/<project-slug>/.",
+    "requiredPaths": [
+      "QUICKSTART.md",
+      ".env.example",
+      "kit.json",
+      "bundles/growthub-twenty-crm-v1.json",
+      "skills.md",
+      "workers/twenty-crm-operator/CLAUDE.md",
+      "brands/_template/brand-kit.md",
+      "brands/growthub/brand-kit.md",
+      "brands/NEW-CLIENT.md",
+      "setup/clone-fork.sh",
+      "setup/verify-env.mjs",
+      "setup/check-deps.sh",
+      "output/README.md",
+      "templates",
+      "docs",
+      "growthub-meta"
+    ]
+  },
+  "bundles": [
+    {
+      "id": "growthub-twenty-crm-v1",
+      "version": "1.0.0",
+      "path": "bundles/growthub-twenty-crm-v1.json"
+    }
+  ],
+  "executionMode": "export",
+  "activationModes": [
+    "export"
+  ],
+  "compatibility": {
+    "cliMinVersion": "0.3.50"
+  },
+  "provenance": {
+    "sourceRepo": "growthub-local",
+    "frozenAt": "2026-04-15T00:00:00.000Z"
+  }
+}

package/assets/worker-kits/growthub-twenty-crm-v1/output/README.md

@@ -0,0 +1,46 @@
+# Output Directory — Twenty CRM v1
+
+This directory is where the agent writes all client deliverables.
+
+---
+
+## Structure
+
+```text
+output/
+└── <client-slug>/
+    └── <project-slug>/
+        ├── <ClientSlug>_CRMSetupBrief_v<N>_<YYYYMMDD>.md
+        ├── <ClientSlug>_DataModelDesign_v<N>_<YYYYMMDD>.md
+        ├── <ClientSlug>_LeadEnrichmentPipeline_v<N>_<YYYYMMDD>.md
+        ├── <ClientSlug>_PipelineAutomationBrief_v<N>_<YYYYMMDD>.md
+        ├── <ClientSlug>_WebhookIntegrationSpec_v<N>_<YYYYMMDD>.md
+        ├── <ClientSlug>_APIQueryPlan_v<N>_<YYYYMMDD>.md
+        ├── <ClientSlug>_CustomObjectDesign_v<N>_<YYYYMMDD>.md
+        ├── <ClientSlug>_ImportMapping_v<N>_<YYYYMMDD>.md
+        ├── <ClientSlug>_WorkspaceConfigChecklist_v<N>_<YYYYMMDD>.md
+        ├── <ClientSlug>_IntegrationHandoff_v<N>_<YYYYMMDD>.md
+        ├── <ClientSlug>_EnrichmentFieldMap_v<N>_<YYYYMMDD>.md
+        └── <ClientSlug>_CRMPlaybook_v<N>_<YYYYMMDD>.md
+```
+
+---
+
+## File naming
+
+Pattern: `<ClientSlug>_<OutputType>_v<N>_<YYYYMMDD>.md`
+
+- `ClientSlug` is PascalCase (e.g. `AcmeCorp`, `Growthub`)
+- `OutputType` matches the artifact type exactly (e.g. `CRMSetupBrief`, `DataModelDesign`)
+- `v<N>` is the version number (start at `v1`, increment on revision)
+- `YYYYMMDD` is the date of production
+
+---
+
+## Rules
+
+- never overwrite an existing version file — create a new version
+- keep one artifact per file
+- Markdown only
+- no placeholder text in any delivered file
+- brand kit DELIVERABLES LOG must be updated after each delivery