@growthub/cli 0.7.6 → 0.7.8

package/assets/worker-kits/creative-strategist-v1/skills.md

@@ -1,8 +1,10 @@
-# Claude Workers — Creative Strategist Skill
+# Creative Strategist Worker Skill
 ## Video Creative Brief Production  |  Multi-Brand System
 
-> **Who this is for:** Any Claude agent in `/Users/antonio/claude-workers/` producing a Video Creative Brief.
+> **Who this is for:** Any agent (Claude is first-party; Cursor / Codex / Gemini / custom harnesses are equally supported) operating inside `${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/` and producing a Video Creative Brief.
 > Read this file fully before starting. Every section is a required step.
+>
+> **Workspace path:** all commands below reference the kit workspace via the `CREATIVE_STRATEGIST_HOME` env var. Default: `$HOME/creative-strategist`. Override it to any directory (e.g. `export CREATIVE_STRATEGIST_HOME=$HOME/claude-workers`) to mount your own brand/template tree without forking this kit.
 
 ---
 
@@ -53,7 +55,7 @@ Required fields: `client_name`, `slug`, `primary_service`, `landing_page`, `targ
 ## STEP 1b — READ THE BRAND KIT
 
 ```bash
-cat /Users/antonio/claude-workers/brands/<client-slug>/brand-kit.md
+cat ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<client-slug>/brand-kit.md
 ```
 
 Load every field. The brief JS must pull colors, tone, and guardrails from this file — not memory.
@@ -88,7 +90,7 @@ Phone + Website:         [from brand kit]
 > **Do this first — every time.** A frozen format skips frame extraction entirely.
 
 ```
-Read /Users/antonio/claude-workers/templates/ad-formats/INDEX.md
+Read ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/templates/ad-formats/INDEX.md
 ```
 
 **Match found?**
@@ -99,7 +101,7 @@ Read /Users/antonio/claude-workers/templates/ad-formats/INDEX.md
 
 **Then load scene modules:**
 ```
-Read /Users/antonio/claude-workers/templates/scene-modules/INDEX.md
+Read ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/templates/scene-modules/INDEX.md
 ```
 Pull each module listed under "Scene Modules Used" in the format file.
 
@@ -123,7 +125,7 @@ Add rows to templates/scene-modules/INDEX.md
 **3-pass grep method (fast):**
 
 ```bash
-CSV=/Users/antonio/claude-workers/templates/hooks-library/500-winning-hooks.csv
+CSV=${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/templates/hooks-library/500-winning-hooks.csv
 
 # Pass 1 — client niche / pain-point keywords
 grep -i "KEYWORD1\|KEYWORD2" "$CSV" | head -10
@@ -218,13 +220,13 @@ APPENDIX             — AI video generation prompts (Veo 3 / Runway) — labele
 
 ```bash
 # Copy and fill the template
-cp /Users/antonio/claude-workers/templates/brief-template.js /tmp/docx_work/<slug>_brief_v1.js
+cp ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/templates/brief-template.js /tmp/docx_work/<slug>_brief_v1.js
 # Edit: fill CONFIG (colors from brand kit) + BRIEF (all content)
 
 # Run
 cd /tmp/docx_work && npm install docx   # once per session
 node <slug>_brief_v1.js
-# Output: /Users/antonio/Downloads/<slug>_VideoBrief_<concept>_v1_<YYYYMMDD>.docx
+# Output: $HOME/Downloads/<slug>_VideoBrief_<concept>_v1_<YYYYMMDD>.docx
 ```
 
 **JS non-negotiables:**
@@ -242,7 +244,7 @@ node <slug>_brief_v1.js
 ## STEP 5 — OPEN IN GOOGLE DOCS
 
 ```bash
-open -R "/Users/antonio/Downloads/<filename>.docx"
+open -R "$HOME/Downloads/<filename>.docx"
 osascript -e 'tell application "Google Chrome" to open location "https://drive.google.com/drive/my-drive"'
 ```
 
@@ -254,7 +256,7 @@ Tell the user: "File revealed in Finder. Drag into the Google Drive browser wind
 
 ```bash
 echo "- $(date +%Y-%m-%d) | Video Creative Brief v1 | ~/Downloads/<filename>.docx" \
-  >> /Users/antonio/claude-workers/brands/<client-slug>/brand-kit.md
+  >> ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<client-slug>/brand-kit.md
 ```
 
 ---
@@ -313,7 +315,7 @@ Change only the 6 color constants at the top of the JS file — pull from `brand
 ## FOLDER STRUCTURE
 
 ```
-/Users/antonio/claude-workers/
+${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/
 ├── skills.md                          ← this file — read first, every session
 ├── README.md                          ← kit overview + template library summary
 ├── templates/

package/assets/worker-kits/creative-strategist-v1/templates/brief-template.js

@@ -25,7 +25,7 @@ const CONFIG = {
   doctor_name:       "[DR. NAME, CREDENTIALS]", // e.g. "Dr. Anthony Carabasi, DO"
   campaign_name:     "[CAMPAIGN NAME]",          // e.g. "Regenerative Medicine — Spring 2026"
   date:              "[MONTH YEAR]",             // e.g. "April 2026"
-  output_path:       "/Users/antonio/Downloads/[ClientSlug]_Video_Creative_Brief_v1_[DATE].docx",
+  output_path:       `${process.env.HOME}/Downloads/[ClientSlug]_Video_Creative_Brief_v1_[DATE].docx`,
 
   // Brief metadata
   video_length:      "[XX seconds]",

package/assets/worker-kits/creative-strategist-v1/workers/creative-strategist/CLAUDE.md

@@ -1,7 +1,9 @@
 # Creative Strategist Worker — Operating Instructions
-> You are a creative strategist agent operating inside `/Users/antonio/claude-workers/`.
+> You are a creative strategist agent operating inside `${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/`.
 > Read this file completely before taking any action. Every section is enforced.
 >
+> **Agent compatibility:** Claude is first-party (this file is what Claude Code loads), but the kit is agent-agnostic — Cursor, Codex, Gemini, or any harness reading this file can run the same workflow. All workspace paths resolve through the `CREATIVE_STRATEGIST_HOME` env var (default `$HOME/creative-strategist`); override it to mount an existing tree (e.g. `export CREATIVE_STRATEGIST_HOME=$HOME/claude-workers`).
+>
 > Last updated: 2026-04-08
 
 ---
@@ -24,7 +26,7 @@ You do NOT produce:
 Everything about format, docx rules, design system, and frame analysis lives here:
 
 ```
-/Users/antonio/claude-workers/skills.md
+${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/skills.md
 ```
 
 **Read it first. Every session. No exceptions.**
@@ -39,13 +41,13 @@ When they conflict, skills.md wins on technical rules; this file wins on workflo
 
 ```bash
 # Read the master skill doc
-cat /Users/antonio/claude-workers/skills.md
+cat ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/skills.md
 
 # Check for existing briefs for this client (if returning client)
-ls /Users/antonio/claude-workers/brands/<slug>/
+ls ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<slug>/
 
 # Check the deliverables log for any prior brief output
-grep "docx" /Users/antonio/claude-workers/brands/<slug>/brand-kit.md
+grep "docx" ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<slug>/brand-kit.md
 ```
 
 **Also check for working JS examples in `/tmp/docx_work/` — use the most recent one for this
@@ -64,7 +66,7 @@ Existing brief JS files to reference (in priority order):
 ### STEP 2 — Load the Brand Kit
 
 ```bash
-cat /Users/antonio/claude-workers/brands/<slug>/brand-kit.md
+cat ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<slug>/brand-kit.md
 ```
 
 Load every field into context:
@@ -76,9 +78,9 @@ Load every field into context:
 
 If the brand kit does not exist → copy the template and fill from context:
 ```bash
-cp /Users/antonio/claude-workers/brands/_template/brand-kit.md \
-   /Users/antonio/claude-workers/brands/<new-slug>/brand-kit.md
-mkdir -p /Users/antonio/claude-workers/brands/<new-slug>/assets
+cp ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/_template/brand-kit.md \
+   ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<new-slug>/brand-kit.md
+mkdir -p ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<new-slug>/assets
 ```
 
 ---
@@ -158,7 +160,7 @@ If a muse/reference video exists — **do not skip this step. It is not optional
 
 Follow the complete frame analysis workflow documented in:
 ```
-/Users/antonio/claude-workers/skills.md → SKILL MODULE: FRAME-BY-FRAME VIDEO ANALYSIS
+${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/skills.md → SKILL MODULE: FRAME-BY-FRAME VIDEO ANALYSIS
 ```
 
 Quick reference:
@@ -211,10 +213,9 @@ Save to: `/tmp/docx_work/<slug>_brief_v<N>.js`
 ### STEP 6 — RUN THE SCRIPT
 
 ```bash
-mkdir -p /tmp/docx_work/node_modules
-ln -sf /Users/antonio/.nvm/versions/node/v18.20.5/lib/node_modules/docx \
-       /tmp/docx_work/node_modules/docx
-cd /tmp/docx_work && node <slug>_brief_v<N>.js
+mkdir -p /tmp/docx_work
+cd /tmp/docx_work && npm install docx   # once per session
+node <slug>_brief_v<N>.js
 ```
 
 If it errors: read the exact error line, fix in place, re-run. Do NOT start over from scratch.
@@ -225,7 +226,7 @@ If it errors: read the exact error line, fix in place, re-run. Do NOT start over
 
 ```bash
 # Reveal file in Finder
-open -R "/Users/antonio/Downloads/<filename>.docx"
+open -R "$HOME/Downloads/<filename>.docx"
 
 # Open Google Drive in Chrome
 osascript -e 'tell application "Google Chrome" to open location "https://drive.google.com/drive/my-drive"'
@@ -246,7 +247,7 @@ osascript -e 'tell application "Google Chrome" to open location "<URL>"'
 
 ```bash
 echo "- $(date +%Y-%m-%d) | Video Creative Brief v<N> — <Campaign Name> | ~/Downloads/<filename>.docx" \
-  >> /Users/antonio/claude-workers/brands/<slug>/brand-kit.md
+  >> ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<slug>/brand-kit.md
 ```
 
 ---
@@ -357,9 +358,9 @@ Use Chrome for the following tasks:
 
 ```bash
 # 1. Create brand folder
-cp /Users/antonio/claude-workers/brands/_template/brand-kit.md \
-   /Users/antonio/claude-workers/brands/<new-slug>/brand-kit.md
-mkdir -p /Users/antonio/claude-workers/brands/<new-slug>/assets
+cp ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/_template/brand-kit.md \
+   ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<new-slug>/brand-kit.md
+mkdir -p ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<new-slug>/assets
 
 # 2. Fill all YAML fields from conversation
 # 3. Mark unknown fields: "TBD — confirm with client"
@@ -374,8 +375,8 @@ mkdir -p /Users/antonio/claude-workers/brands/<new-slug>/assets
 |-----------|-----------|
 | Brief JS | `/tmp/docx_work/<slug>_brief_v<N>.js` |
 | Output docx | `~/Downloads/<ClientName>_VideoBrief_<CampaignSlug>_v<N>_<YYYYMMDD>.docx` |
-| Brand kit | `/Users/antonio/claude-workers/brands/<slug>/brand-kit.md` |
-| Assets | `/Users/antonio/claude-workers/brands/<slug>/assets/<filename>` |
+| Brand kit | `${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<slug>/brand-kit.md` |
+| Assets | `${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/brands/<slug>/assets/<filename>` |
 | Muse frames | `/tmp/muse_frames/frame_Xs.jpg` |
 
 ---

package/assets/worker-kits/growthub-ai-website-cloner-v1/.env.example

@@ -3,5 +3,7 @@
 # No API key is required for this kit.
 
 # Optional: override local fork path.
-# Default: ~/ai-website-cloner-template
-AI_CLONER_FORK_PATH=~/ai-website-cloner-template
+# Canonical env var: AI_WEBSITE_CLONER_HOME (uniform pattern across all worker kits)
+# Legacy alias: AI_CLONER_FORK_PATH (still accepted by the CLI)
+# Default when unset: $HOME/ai-website-cloner-template
+AI_WEBSITE_CLONER_HOME=$HOME/ai-website-cloner-template

package/assets/worker-kits/growthub-ai-website-cloner-v1/QUICKSTART.md

@@ -19,7 +19,7 @@
 bash setup/clone-fork.sh
 ```
 
-This clones the `ai-website-cloner-template` fork to `~/ai-website-cloner-template` and runs `npm install`.
+This clones the `ai-website-cloner-template` fork to `$HOME/ai-website-cloner-template` and runs `npm install`.
 
 ---
 
@@ -85,12 +85,12 @@ The agent will:
 
 All artifacts land in:
 ```
-~/ai-website-cloner-template/output/<client-slug>/<project-slug>/
+$HOME/ai-website-cloner-template/output/<client-slug>/<project-slug>/
 ```
 
 The cloned Next.js components live in:
 ```
-~/ai-website-cloner-template/src/components/
+$HOME/ai-website-cloner-template/src/components/
 ```
 
 ---
@@ -98,7 +98,7 @@ The cloned Next.js components live in:
 ## Running the cloned site
 
 ```bash
-cd ~/ai-website-cloner-template
+cd $HOME/ai-website-cloner-template
 npm run dev
 ```
 

package/assets/worker-kits/growthub-ai-website-cloner-v1/runtime-assumptions.md

@@ -10,7 +10,7 @@ This kit assumes the `ai-website-cloner-template` fork is checked out and instal
 
 | Assumption | Default | Override |
 |---|---|---|
-| Fork directory | `~/ai-website-cloner-template` | `AI_CLONER_FORK_PATH` env var |
+| Fork directory | `$HOME/ai-website-cloner-template` | `AI_WEBSITE_CLONER_HOME` (legacy: `AI_CLONER_FORK_PATH`) env var |
 | Fork repo URL | `https://github.com/JCodesMore/ai-website-cloner-template` | n/a |
 | Node.js version | 24+ (strict) | n/a — minimum requirement |
 | Package manager | npm | n/a |

package/assets/worker-kits/growthub-ai-website-cloner-v1/setup/clone-fork.sh

@@ -3,7 +3,7 @@
 # Run from any location. Installs to ~/ai-website-cloner-template (or AI_CLONER_FORK_PATH).
 set -e
 
-FORK_DIR="${AI_CLONER_FORK_PATH:-$HOME/ai-website-cloner-template}"
+FORK_DIR="${AI_WEBSITE_CLONER_HOME:-${AI_CLONER_FORK_PATH:-$HOME/ai-website-cloner-template}}"
 REPO_URL="https://github.com/JCodesMore/ai-website-cloner-template.git"
 
 echo "=== Growthub AI Website Cloner — Fork Setup ==="

package/assets/worker-kits/growthub-ai-website-cloner-v1/setup/verify-env.mjs

@@ -5,7 +5,7 @@ import { execSync } from "node:child_process";
 import { resolve } from "node:path";
 import { homedir } from "node:os";
 
-const FORK_PATH = process.env.AI_CLONER_FORK_PATH || resolve(homedir(), "ai-website-cloner-template");
+const FORK_PATH = process.env.AI_WEBSITE_CLONER_HOME || process.env.AI_CLONER_FORK_PATH || resolve(homedir(), "ai-website-cloner-template");
 
 let passed = 0;
 let failed = 0;

package/assets/worker-kits/growthub-ai-website-cloner-v1/validation-checklist.md

@@ -8,7 +8,7 @@ Run through this checklist before producing the platform handoff.
 
 ## Environment validation
 
-- [ ] Fork exists at `~/ai-website-cloner-template` (or `AI_CLONER_FORK_PATH`)
+- [ ] Fork exists at `$HOME/ai-website-cloner-template` (or `AI_WEBSITE_CLONER_HOME` (legacy: `AI_CLONER_FORK_PATH`))
 - [ ] Node.js 24+ confirmed (`node --version`)
 - [ ] `node_modules/` installed in fork root
 - [ ] AI agent is active and running in the fork directory

package/assets/worker-kits/growthub-ai-website-cloner-v1/workers/ai-website-cloner-operator/CLAUDE.md

@@ -55,7 +55,7 @@ Before loading any methodology, verify the environment is ready.
 
 **Check 1 — Fork directory exists:**
 
-Confirm the fork is checked out at `~/ai-website-cloner-template` (or `AI_CLONER_FORK_PATH` if set).
+Confirm the fork is checked out at `$HOME/ai-website-cloner-template` (or `AI_WEBSITE_CLONER_HOME` (legacy: `AI_CLONER_FORK_PATH`) if set).
 
 If missing, tell the user:
 

package/assets/worker-kits/growthub-geo-seo-v1/.env.example

@@ -2,9 +2,11 @@
 # Copy this file to .env and fill in your values.
 # Never commit .env to version control.
 
-# Path to your local clone of the geo-seo-claude fork
-# Default is ~/geo-seo-claude — only set this if your fork is elsewhere
-# GEO_SEO_FORK_PATH=/path/to/your/geo-seo-claude
+# Path to your local clone of the geo-seo-claude fork.
+# Canonical env var: GEO_SEO_HOME (uniform pattern across all worker kits)
+# Legacy alias: GEO_SEO_FORK_PATH (still accepted by the CLI)
+# Default when unset: $HOME/geo-seo-claude
+# GEO_SEO_HOME=/path/to/your/geo-seo-claude
 
 # Anthropic API key — required for agent-enhanced analysis (Steps 5-9)
 # Core Python audit commands work without this key

package/assets/worker-kits/growthub-geo-seo-v1/setup/check-deps.sh

@@ -54,14 +54,14 @@ if command -v playwright >/dev/null 2>&1; then
 fi
 
 # Check for the fork directory
-FORK_DIR="${GEO_SEO_FORK_PATH:-$HOME/geo-seo-claude}"
+FORK_DIR="${GEO_SEO_HOME:-${GEO_SEO_FORK_PATH:-$HOME/geo-seo-claude}}"
 if [ -d "$FORK_DIR" ]; then
   echo "OK   geo-seo-claude fork at $FORK_DIR"
   PASS=$((PASS+1))
 else
   echo "MISS geo-seo-claude fork not found at $FORK_DIR"
   echo "     Run: bash setup/clone-fork.sh"
-  echo "     Or set GEO_SEO_FORK_PATH to your fork path in .env"
+  echo "     Or set GEO_SEO_HOME (legacy alias: GEO_SEO_FORK_PATH) to your fork path in .env"
   FAIL=$((FAIL+1))
 fi
 

package/assets/worker-kits/growthub-geo-seo-v1/setup/clone-fork.sh

@@ -3,7 +3,7 @@
 # Usage: bash setup/clone-fork.sh
 set -e
 
-FORK_DIR="${GEO_SEO_FORK_PATH:-$HOME/geo-seo-claude}"
+FORK_DIR="${GEO_SEO_HOME:-${GEO_SEO_FORK_PATH:-$HOME/geo-seo-claude}}"
 REPO_URL="https://github.com/zubair-trabzada/geo-seo-claude"
 
 echo "=== Growthub GEO SEO Studio — Fork Setup ==="

package/assets/worker-kits/growthub-geo-seo-v1/setup/verify-env.mjs

@@ -68,7 +68,7 @@ console.log("--- Fork Path Check ---");
 
 // ─── Fork Path ─────────────────────────────────────────────────────────────
 
-const forkPathRaw = config["GEO_SEO_FORK_PATH"] || join(homedir(), "geo-seo-claude");
+const forkPathRaw = config["GEO_SEO_HOME"] || config["GEO_SEO_FORK_PATH"] || join(homedir(), "geo-seo-claude");
 const forkPath = resolve(forkPathRaw);
 
 if (existsSync(forkPath)) {

package/assets/worker-kits/growthub-geo-seo-v1/validation-checklist.md

@@ -7,7 +7,7 @@ Use this checklist before starting a session, when validating a kit installation
 ## PRE-SESSION CHECKLIST
 
 ### Environment
-- [ ] geo-seo-claude fork is present at `GEO_SEO_FORK_PATH` (or `~/geo-seo-claude`) — OR agent-only mode is confirmed
+- [ ] geo-seo-claude fork is present at `GEO_SEO_HOME` / `GEO_SEO_FORK_PATH` (default `$HOME/geo-seo-claude`) — OR agent-only mode is confirmed
 - [ ] Python 3.8+ is installed (`python3 --version`)
 - [ ] Playwright is installed (`playwright --version`)
 - [ ] Playwright chromium browser is installed (`playwright install chromium` — or already done)

package/assets/worker-kits/growthub-geo-seo-v1/workers/geo-seo-operator/CLAUDE.md

@@ -68,7 +68,7 @@ If `python3` is not found, stop and tell the user:
 
 **Check 2 — Fork exists (local-fork mode only):**
 
-Check whether geo-seo-claude is cloned at `GEO_SEO_FORK_PATH` (default `~/geo-seo-claude`).
+Check whether geo-seo-claude is cloned at `GEO_SEO_HOME` (legacy alias: `GEO_SEO_FORK_PATH`; default `$HOME/geo-seo-claude`).
 
 If the clone is missing and the user wants local-fork mode, stop and tell the user:
 

package/assets/worker-kits/growthub-hyperframes-studio-v1/.env.example

@@ -3,5 +3,7 @@
 # Never commit .env to version control.
 
 # Absolute path to your local Hyperframes clone.
-# Example: /Users/<you>/dev/hyperframes
-HYPERFRAMES_LOCAL_PATH=
+# Canonical env var: HYPERFRAMES_HOME (uniform pattern across all worker kits)
+# Legacy alias: HYPERFRAMES_LOCAL_PATH (still accepted by the CLI)
+# Default when unset: $HOME/hyperframes
+HYPERFRAMES_HOME=$HOME/hyperframes

package/assets/worker-kits/growthub-hyperframes-studio-v1/docs/hyperframes-discovery-path.md

@@ -8,5 +8,5 @@ Discovery path:
 
 Feature branch demo checks:
 
-- `zsh /Users/antonio/growthub-local/scripts/demo-cli.sh cli kit list --family studio`
-- `zsh /Users/antonio/growthub-local/scripts/demo-cli.sh cli kit inspect hyperframes`
+- `bash scripts/demo-cli.sh cli kit list --family studio`
+- `bash scripts/demo-cli.sh cli kit inspect hyperframes`

package/assets/worker-kits/growthub-hyperframes-studio-v1/setup/clone-fork.sh

@@ -2,7 +2,8 @@
 set -euo pipefail
 
 REPO_URL="${HYPERFRAMES_REPO_URL:-https://github.com/heygen-com/hyperframes}"
-LOCAL_PATH="${HYPERFRAMES_LOCAL_PATH:-./.hyperframes}"
+# Canonical: HYPERFRAMES_HOME. Legacy alias: HYPERFRAMES_LOCAL_PATH.
+LOCAL_PATH="${HYPERFRAMES_HOME:-${HYPERFRAMES_LOCAL_PATH:-./.hyperframes}}"
 
 if [ -d "${LOCAL_PATH}/.git" ]; then
   git -C "${LOCAL_PATH}" fetch origin

package/assets/worker-kits/growthub-hyperframes-studio-v1/setup/verify-env.mjs

@@ -8,8 +8,9 @@ if (!fs.existsSync(envPath)) {
 }
 
 const raw = fs.readFileSync(envPath, "utf8");
-if (!raw.includes("HYPERFRAMES_LOCAL_PATH=")) {
-  console.error("HYPERFRAMES_LOCAL_PATH is required in .env");
+// Canonical: HYPERFRAMES_HOME. Legacy alias: HYPERFRAMES_LOCAL_PATH.
+if (!raw.includes("HYPERFRAMES_HOME=") && !raw.includes("HYPERFRAMES_LOCAL_PATH=")) {
+  console.error("HYPERFRAMES_HOME (or legacy HYPERFRAMES_LOCAL_PATH) is required in .env");
   process.exit(1);
 }
 

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/.env.example

@@ -7,3 +7,8 @@ MUAPI_API_KEY=your_muapi_key_here
 
 # Muapi base URL — do not change unless self-hosting
 MUAPI_BASE_URL=https://api.muapi.io
+
+# Optional: override local fork path for Open-Higgsfield-AI clone.
+# Canonical env var: OPEN_HIGGSFIELD_HOME (uniform pattern across all worker kits)
+# Default when unset: $HOME/open-higgsfield-ai
+# OPEN_HIGGSFIELD_HOME=$HOME/open-higgsfield-ai

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/QUICKSTART.md

@@ -50,7 +50,7 @@ Checks for `node`, `npm`, `git`, and `ffmpeg`. All four are required for local-f
 bash setup/clone-fork.sh
 ```
 
-Clones the Open Higgsfield AI repo to `~/open-higgsfield-ai`, installs dependencies, **automatically applies the CORS proxy patch** (see `setup/patch-cors-proxy.sh`), and starts the dev server at `http://localhost:3001`.
+Clones the Open Higgsfield AI repo to `$HOME/open-higgsfield-ai`, installs dependencies, **automatically applies the CORS proxy patch** (see `setup/patch-cors-proxy.sh`), and starts the dev server at `http://localhost:3001`.
 
 The CORS patch is required — the upstream repo calls `api.muapi.ai` directly from the browser, which modern browsers block. The patch routes all API calls through the local Next.js server instead.
 

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/runtime-assumptions.md

@@ -60,7 +60,7 @@ Next.js proxies them to `api.muapi.ai` from the server where CORS does not apply
 **To apply manually if not already patched:**
 ```bash
 bash setup/patch-cors-proxy.sh [path-to-fork]
-# defaults to ~/open-higgsfield-ai
+# defaults to $HOME/open-higgsfield-ai
 ```
 
 **Affected functions in muapi.js:**

package/assets/worker-kits/growthub-open-montage-studio-v1/.env.example

@@ -31,8 +31,10 @@ XAI_API_KEY=your_xai_key_here
 
 # ─── OpenMontage Fork Path ───
 # Absolute path to your local OpenMontage clone.
-# Defaults to ~/OpenMontage if unset.
-# OPENMONTAGE_PATH=~/OpenMontage
+# Canonical env var: OPEN_MONTAGE_HOME (uniform pattern across all worker kits)
+# Legacy alias: OPENMONTAGE_PATH (still accepted by the CLI)
+# Default when unset: $HOME/OpenMontage
+# OPEN_MONTAGE_HOME=$HOME/OpenMontage
 
 # ─── GrowthHub CMS Node Bridge ───
 # When using CMS nodes for video/image generation, the bridge

package/assets/worker-kits/growthub-open-montage-studio-v1/QUICKSTART.md

@@ -58,7 +58,7 @@ bash setup/check-deps.sh     # Check Python, FFmpeg, Node.js, Git
 bash setup/clone-fork.sh     # Clone OpenMontage and run make setup
 ```
 
-This clones OpenMontage to `~/OpenMontage`, installs all dependencies (Python packages, Remotion, Piper TTS), and verifies the tool registry.
+This clones OpenMontage to `$HOME/OpenMontage`, installs all dependencies (Python packages, Remotion, Piper TTS), and verifies the tool registry.
 
 Skip this step if you are using agent-only or hybrid mode.
 

package/assets/worker-kits/growthub-open-montage-studio-v1/runtime-assumptions.md

@@ -27,7 +27,7 @@ This file documents the runtime environment expectations for the Open Montage St
 
 ### OpenMontage Clone
 
-- Default path: `~/OpenMontage` (override with `OPENMONTAGE_PATH` in `.env`)
+- Default path: `$HOME/OpenMontage` (override with `OPEN_MONTAGE_HOME` (legacy: `OPENMONTAGE_PATH`) in `.env`)
 - Setup: `git clone https://github.com/calesthio/OpenMontage.git && cd OpenMontage && make setup`
 - The clone includes Python requirements, Remotion composer, and Piper TTS
 

package/assets/worker-kits/growthub-open-montage-studio-v1/setup/clone-fork.sh

@@ -4,7 +4,8 @@ set -euo pipefail
 # Clone and set up OpenMontage for local-fork execution mode.
 # Usage: bash setup/clone-fork.sh [target-dir]
 
-TARGET_DIR="${1:-${OPENMONTAGE_PATH:-$HOME/OpenMontage}}"
+# Canonical: OPEN_MONTAGE_HOME. Legacy alias: OPENMONTAGE_PATH.
+TARGET_DIR="${1:-${OPEN_MONTAGE_HOME:-${OPENMONTAGE_PATH:-$HOME/OpenMontage}}}"
 
 echo "=== OpenMontage Fork Setup ==="
 echo "Target directory: $TARGET_DIR"

package/assets/worker-kits/growthub-open-montage-studio-v1/setup/verify-env.mjs

@@ -89,8 +89,11 @@ if (configured.length === 0) {
 
 console.log(`[summary] ${configured.length} provider(s) configured, ${missing.length} not set.`);
 
-// Check OpenMontage path
-const omPath = env.OPENMONTAGE_PATH || resolve(process.env.HOME || "~", "OpenMontage");
+// Check OpenMontage path — canonical OPEN_MONTAGE_HOME, legacy alias OPENMONTAGE_PATH.
+const omPath =
+  env.OPEN_MONTAGE_HOME ||
+  env.OPENMONTAGE_PATH ||
+  resolve(process.env.HOME || "~", "OpenMontage");
 if (existsSync(omPath)) {
   console.log(`[ok] OpenMontage clone found at: ${omPath}`);
 } else {

package/assets/worker-kits/growthub-open-montage-studio-v1/validation-checklist.md

@@ -16,9 +16,9 @@ Run through this checklist before your first generation session.
 - [ ] Python 3.10+ installed: `python3 --version`
 - [ ] FFmpeg installed: `ffmpeg -version`
 - [ ] Node.js 18+ installed: `node --version`
-- [ ] OpenMontage clone exists at `$OPENMONTAGE_PATH` (default `~/OpenMontage`)
-- [ ] OpenMontage setup completed: `cd ~/OpenMontage && python -c "from tools.tool_registry import registry; registry.discover(); print('OK')"`
-- [ ] Remotion dependencies installed: `cd ~/OpenMontage/remotion-composer && node -e "require('remotion')"`
+- [ ] OpenMontage clone exists at `$OPENMONTAGE_PATH` (default `$HOME/OpenMontage`)
+- [ ] OpenMontage setup completed: `cd $HOME/OpenMontage && python -c "from tools.tool_registry import registry; registry.discover(); print('OK')"`
+- [ ] Remotion dependencies installed: `cd $HOME/OpenMontage/remotion-composer && node -e "require('remotion')"`
 
 ## CMS Node Validation (skip if local-fork only)
 

package/assets/worker-kits/growthub-open-montage-studio-v1/workers/open-montage-studio-operator/CLAUDE.md

@@ -76,7 +76,7 @@ If none are set, check whether the user has a GrowthHub session for CMS node gen
 
 **Check 3 — OpenMontage clone (local-fork mode only):**
 
-If using `local-fork` execution mode, check whether the clone exists at the path in `OPENMONTAGE_PATH` (default `~/OpenMontage`).
+If using `local-fork` execution mode, check whether the clone exists at the path in `OPEN_MONTAGE_HOME` (legacy: `OPENMONTAGE_PATH`) (default `$HOME/OpenMontage`).
 
 If not found:
 
@@ -148,7 +148,7 @@ remotion-composer/                      # React/Remotion composition engine
 Run capability discovery if local fork is available:
 
 ```bash
-cd ~/OpenMontage && python -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.support_envelope(), indent=2))"
+cd $HOME/OpenMontage && python -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.support_envelope(), indent=2))"
 ```
 
 If the user is not pointing at a fork checkout, proceed using the assumptions frozen in this kit and explicitly mark the plan as `repo-unverified`.

package/assets/worker-kits/growthub-postiz-social-v1/.env.example

@@ -3,8 +3,10 @@
 # Never commit .env to version control.
 
 # Optional override for your local Postiz fork path.
-# Default used by scripts is ~/postiz-app.
-# POSTIZ_FORK_PATH=/path/to/your/postiz-app
+# Canonical env var: POSTIZ_HOME (uniform pattern across all worker kits)
+# Legacy alias: POSTIZ_FORK_PATH (still accepted by the CLI)
+# Default when unset: $HOME/postiz-app
+# POSTIZ_HOME=/path/to/your/postiz-app
 
 # Base URL for the local Postiz API.
 POSTIZ_API_URL=http://localhost:3000

package/assets/worker-kits/growthub-postiz-social-v1/QUICKSTART.md

@@ -43,7 +43,7 @@ node setup/verify-env.mjs
 ```
 
 This checks:
-- Whether the Postiz fork is cloned at `POSTIZ_FORK_PATH` (default: `~/postiz-app`)
+- Whether the Postiz fork is cloned at `POSTIZ_HOME` (legacy: `POSTIZ_FORK_PATH`) (default: `$HOME/postiz-app`)
 - Whether the Postiz API is reachable on port 3000
 - Whether `ANTHROPIC_API_KEY` is valid format (if set for AI caption enhancement)
 - No OAuth tokens are validated here — those are managed inside Postiz
@@ -62,7 +62,7 @@ Verifies that `node`, `docker`, `docker compose`, and `git` are available. Check
 bash setup/clone-fork.sh
 ```
 
-This clones `postiz-app` to `~/postiz-app` (or `POSTIZ_FORK_PATH` if set), runs `docker compose up -d` to start Redis, PostgreSQL, and the Postiz API, and waits for the API healthcheck to pass.
+This clones `postiz-app` to `$HOME/postiz-app` (or `POSTIZ_HOME` (legacy: `POSTIZ_FORK_PATH`) if set), runs `docker compose up -d` to start Redis, PostgreSQL, and the Postiz API, and waits for the API healthcheck to pass.
 
 Skip this step if you are using **agent-only mode** — the operator can plan campaigns, draft captions, and produce content calendars without a running Postiz instance.
 

package/assets/worker-kits/growthub-postiz-social-v1/setup/clone-fork.sh

@@ -3,7 +3,7 @@
 # Usage: bash setup/clone-fork.sh
 set -e
 
-FORK_DIR="${POSTIZ_FORK_PATH:-$HOME/postiz-app}"
+FORK_DIR="${POSTIZ_HOME:-${POSTIZ_FORK_PATH:-$HOME/postiz-app}}"
 REPO_URL="https://github.com/gitroomhq/postiz-app"
 
 echo "=== Growthub Postiz Social Media Studio — Fork Setup ==="

package/assets/worker-kits/growthub-postiz-social-v1/setup/verify-env.mjs

@@ -29,7 +29,8 @@ console.log("=".repeat(60));
 console.log("");
 
 // --- Check 1: Postiz fork path ---
-const forkPath = process.env.POSTIZ_FORK_PATH ?? join(homedir(), "postiz-app");
+// Canonical: POSTIZ_HOME. Legacy alias: POSTIZ_FORK_PATH.
+const forkPath = process.env.POSTIZ_HOME ?? process.env.POSTIZ_FORK_PATH ?? join(homedir(), "postiz-app");
 const forkExists = existsSync(forkPath);
 check("Postiz fork directory exists", forkExists, forkExists ? forkPath : `Not found at ${forkPath}`);
 

package/assets/worker-kits/growthub-postiz-social-v1/validation-checklist.md

@@ -15,7 +15,7 @@
 
 ### Local-Fork Mode (skip if agent-only)
 
-- [ ] Postiz fork is cloned at `POSTIZ_FORK_PATH` (default: `~/postiz-app`)
+- [ ] Postiz fork is cloned at `POSTIZ_HOME` (legacy: `POSTIZ_FORK_PATH`) (default: `$HOME/postiz-app`)
 - [ ] `docker compose ps` shows `postiz`, `postiz-postgres`, `postiz-redis` all running
 - [ ] `curl http://localhost:3000/api/healthcheck` returns a 200 response
 - [ ] At least one platform integration is connected and authorized in the Postiz admin UI