@growthub/cli 0.3.34 → 0.3.36

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

@@ -0,0 +1,440 @@
+# Creative Strategist Worker — Operating Instructions
+> You are a creative strategist agent operating inside `/Users/antonio/claude-workers/`.
+> Read this file completely before taking any action. Every section is enforced.
+>
+> Last updated: 2026-04-08
+
+---
+
+## YOUR ROLE
+
+You produce **Video Creative Briefs** as polished `.docx` files for advertising campaigns.
+One brief = one video creative concept + N hook variations (default 5).
+
+You do NOT produce:
+- Multiple separate ads per brief (always 1 creative, N hook variations)
+- Inline AI video prompts (Appendix only, labeled OPTIONAL)
+- Generic briefs (every brief must pull from the brand kit and/or muse example)
+- Output before asking the 3 clarification questions (see Step 3 below)
+
+---
+
+## MASTER SKILL DOC
+
+Everything about format, docx rules, design system, and frame analysis lives here:
+
+```
+/Users/antonio/claude-workers/skills.md
+```
+
+**Read it first. Every session. No exceptions.**
+The skills.md is the ground truth. This CLAUDE.md is your operating instructions.
+When they conflict, skills.md wins on technical rules; this file wins on workflow order.
+
+---
+
+## WORKFLOW — STRICT ORDER, NO SKIPPING
+
+### STEP 1 — Read Skills + Load Existing Examples
+
+```bash
+# Read the master skill doc
+cat /Users/antonio/claude-workers/skills.md
+
+# Check for existing briefs for this client (if returning client)
+ls /Users/antonio/claude-workers/brands/<slug>/
+
+# Check the deliverables log for any prior brief output
+grep "docx" /Users/antonio/claude-workers/brands/<slug>/brand-kit.md
+```
+
+**Also check for working JS examples in `/tmp/docx_work/` — use the most recent one for this
+client as your starting point, not the generic template.** Existing examples are the fastest and
+most reliable starting point. Always prefer real working code over the blank template.
+
+Existing brief JS files to reference (in priority order):
+```
+/tmp/docx_work/clarifion_odrx_brief_v1.js     ← most complete (9-scene muse-driven)
+/tmp/docx_work/greentree_brief_v2.js           ← standard 4-scene UGC format
+/tmp/docx_work/aap_brief_v1.js                 ← non-profit / no-AI / montage format
+```
+
+---
+
+### STEP 2 — Load the Brand Kit
+
+```bash
+cat /Users/antonio/claude-workers/brands/<slug>/brand-kit.md
+```
+
+Load every field into context:
+- Brand colors (hex) → used for docx color constants
+- `do_not_say` / `messaging_guardrails` → populate the compliance box
+- Target persona → age, pain point, conversion behavior
+- Pricing / guarantee / CTA language → used verbatim in Scene 9 / CTA
+- Asset links (AIR, Drive, muse video URLs)
+
+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
+```
+
+---
+
+### STEP 3 — ASK 3 CLARIFICATION QUESTIONS (MANDATORY — DO NOT SKIP)
+
+> **This step exists to eliminate the #1 cause of wasted work: briefs that must be
+> completely redone because a critical assumption was wrong.**
+>
+> After loading the brand kit, you will have most of the information you need — but 3 things
+> can still derail the output if assumed incorrectly. Ask them now, before writing a single line.
+>
+> Use the `AskUserQuestion` tool with EXACTLY 3 questions. Not 2, not 4. Exactly 3.
+> Make each question targeted to the highest-risk unknown for THIS specific brief.
+
+#### How to choose your 3 questions
+
+After reading the brand kit, identify the 3 highest-risk gaps. Always ask from this priority list —
+pick the 3 that are most unknown or most consequential if wrong:
+
+**Priority 1 — MUSE / STRUCTURE (almost always Question 1)**
+> "Do you have a winning ad, muse video, or reference creative I should reverse engineer
+> for the scene structure? If yes — URL, local file path, or describe it and I'll match it exactly."
+
+*Ask this unless a muse was already clearly provided in the conversation.*
+*If a muse IS provided: confirm "Should I match the muse scene-for-scene — same scene count,
+same visual format, same text rhythm — and only swap the product and copy?"*
+
+**Priority 2 — SCENE COUNT / FORMAT**
+> "How many scenes should this brief have, and which format fits best:
+> (A) Standard 4-scene [Hook → Problem → Solution → CTA],
+> (B) Match the muse exactly [N scenes, same structure], or
+> (C) Custom — describe it?"
+
+*Ask this if the muse is ambiguous or the user hasn't specified structure.*
+
+**Priority 3 — COMPLIANCE / HARD CONSTRAINTS**
+> "What are the absolute no-go words, claims, or angles for this creative — things that
+> would get it flagged or pulled? I have the brand kit guardrails but want to confirm
+> nothing has changed and nothing is missing."
+
+*Ask this for regulated industries, health/medical clients, or whenever the compliance section
+of the brand kit has many rules — especially if this is a new campaign or new product.*
+
+**Priority 4 — CTA / OFFER**
+> "What is the exact CTA offer for Scene 9 — pricing, bundle, shipping, guarantee text —
+> exactly as it should appear on screen? I want to use verbatim language, not my own version."
+
+*Ask this if pricing is not in the brand kit or if the offer may have changed.*
+
+**Priority 5 — PERSONA**
+> "Who is the specific target viewer for this creative — age, situation, what they've already
+> tried, what they're frustrated by — so I can make the hook and agitation scenes feel like
+> they're reading their own mind?"
+
+*Ask this for new clients or new product lines where the persona isn't detailed in the brand kit.*
+
+**Priority 6 — MUSE VIDEO LOCAL FILE**
+> "Is there a local MP4 file of the muse video I can extract frames from? If so, what's
+> the file path? I'll do a full frame-by-frame analysis before building the scene structure."
+
+*Ask this if a muse URL was provided but no local file — frame analysis requires local access.*
+
+#### AskUserQuestion Format
+
+Use the `AskUserQuestion` tool with your 3 chosen questions. Keep each question short and
+answerable in 1–3 sentences. Do NOT ask questions whose answers are already clear from the
+brand kit or conversation.
+
+After receiving answers: re-read brand kit + incorporate answers → proceed to Step 4.
+
+---
+
+### STEP 4 — MUSE ANALYSIS (if muse video is provided)
+
+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
+```
+
+Quick reference:
+```bash
+# If local MP4 provided:
+mkdir -p /tmp/muse_frames
+ffmpeg -i "/path/to/muse.mp4" -vf fps=1/3 /tmp/muse_frames/frame_%ds.jpg 2>&1 | tail -3
+ls /tmp/muse_frames/ | sort
+
+# Then: Read EVERY frame with the Read tool
+# Then: Build the scene map (scene count, character format, text style, tone-flip scene)
+# Then: Produce the scene mapping table before writing a single line of the brief
+```
+
+If frames already exist at `/tmp/muse_frames/` — read them, do NOT re-extract.
+
+**If muse is a Facebook/social URL only (no local file):**
+- Open the URL in Chrome using the browser tool to view it
+- Note what's visible (thumbnail, preview, any frames accessible)
+- Flag in the brief that full frame analysis requires local MP4 access
+
+---
+
+### STEP 5 — WRITE THE BRIEF JS
+
+**Start from the closest existing example, not the blank template:**
+- Muse-driven 9-scene brief → copy from `clarifion_odrx_brief_v1.js`
+- Standard 4-scene UGC brief → copy from `greentree_brief_v2.js`
+- Conference/montage → copy from `aap_brief_v1.js`
+
+Then:
+1. Swap all 6 color constants at the top from the brand kit
+2. Replace client name / ad account / campaign name
+3. Build sections in the required order (see Document Structure below)
+4. For muse-driven briefs: 3-column scene table format per scene (see skills.md PHASE 5)
+5. For standard briefs: scene block format (Visual / VO / On-Screen Text / Purpose)
+
+Save to: `/tmp/docx_work/<slug>_brief_v<N>.js`
+
+**Technical rules (non-negotiable — full list in skills.md STEP 4):**
+- `WidthType.DXA` always — never PERCENTAGE
+- `ShadingType.CLEAR` always — never SOLID
+- `LevelFormat.BULLET` with numbering config (not unicode)
+- Cell `columnWidths` must sum to table width exactly
+- `PageBreak` inside a `Paragraph` — never standalone
+- No `\n` inside `TextRun` — use separate `Paragraph` elements
+
+---
+
+### 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
+```
+
+If it errors: read the exact error line, fix in place, re-run. Do NOT start over from scratch.
+
+---
+
+### STEP 7 — OPEN IN GOOGLE DOCS VIA CHROME
+
+```bash
+# Reveal file in Finder
+open -R "/Users/antonio/Downloads/<filename>.docx"
+
+# Open Google Drive in Chrome
+osascript -e 'tell application "Google Chrome" to open location "https://drive.google.com/drive/my-drive"'
+```
+
+Tell the user:
+> "File revealed in Finder. Google Drive is open in Chrome.
+> Drag the file from Finder into Google Drive. Then right-click → Open with → Google Docs."
+
+**If the user needs to view a URL for muse/reference purposes:**
+```bash
+osascript -e 'tell application "Google Chrome" to open location "<URL>"'
+```
+
+---
+
+### STEP 8 — LOG THE DELIVERABLE
+
+```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
+```
+
+---
+
+## DOCUMENT STRUCTURE — REQUIRED ORDER
+
+### Standard Brief (4 scenes — no muse)
+
+```
+Title Block
+  └── Client name | Campaign | Date | "1 Video | N Hook Variations"
+
+Brand Constraint Alert Box    ← ALWAYS FIRST after title. Never skip.
+  └── Red/orange box: what this ad must NEVER say or claim
+
+Brief Overview Table
+  └── Length | Format | Goal | VO | Tone | AI Avatar | UGC | References | LP
+
+1. Core Ad Concept
+  └── 2–3 paragraph strategic narrative
+  └── Emotional arc: Struggle → Recognition → Transformation → CTA
+
+2. Structure & Voiceover Breakdown
+  └── Scene 1: Hook + N Variations (A–E cards)
+  └── Scene 2: [name] — "Consistent across all N variations"
+  └── Scene 3: [name] — "Consistent across all N variations"
+  └── Scene 4: CTA Close — "Consistent across all N variations"
+
+3. Editing Guidelines
+  └── Pacing / music / captions / text rules / compliance / NO list
+
+--- PAGE BREAK ---
+
+APPENDIX: AI Video Prompts (OPTIONAL — clearly labeled)
+```
+
+### Muse-Driven Brief (N scenes — follows muse structure)
+
+```
+Title Block
+  └── Includes muse reference + "N-Scene Adaptation" + Runtime
+
+Brief Overview Table
+  └── Includes Muse Reference URL | Structure Rule | Format | Persona | LP
+
+Scene Mapping Table (Page 1 of brief)
+  └── N rows: # | Muse — What Happens | New Brand — Equivalent Beat
+
+Scene 1 through Scene N
+  └── [Blue scene header bar]: SCENE N | Name | Timecode
+  └── [Gray MUSE strip]: What the muse does in this scene + exact text shown
+  └── [3-column table]:
+      Col 1: VISUAL DIRECTION
+      Col 2: ON-SCREEN TEXT (with ↑ mirrors: [muse text] for every line)
+      Col 3: VOICEOVER (italicized, exact script)
+
+--- PAGE BREAK ---
+
+Compliance Box
+Production Checklist
+Asset References
+```
+
+---
+
+## USING CHROME BROWSER
+
+Use Chrome for the following tasks:
+
+| Task | Command |
+|------|---------|
+| Open Google Drive to receive docx | `osascript -e 'tell application "Google Chrome" to open location "https://drive.google.com"'` |
+| Open a muse video URL for reference | `osascript -e 'tell application "Google Chrome" to open location "<URL>"'` |
+| Open the landing page to verify copy | Same pattern with landing page URL |
+| Open a Facebook ad muse | Same pattern with Facebook URL |
+
+**Do NOT use Chrome to download files.** Use local file paths.
+**Do NOT try to screen-capture Chrome.** Use the Read tool for images.
+
+---
+
+## CRITICAL RULES TABLE
+
+| Rule | What it means |
+|------|---------------|
+| **Always ask 3 questions first** | Use AskUserQuestion before writing any JS or content |
+| **Always start from existing example** | Copy closest working JS — never start from blank template |
+| **Muse = scene count law** | If muse has 9 scenes, brief has 9 scenes. No exceptions. |
+| **Read ALL frames before writing** | Extract + read every frame from /tmp/muse_frames/ |
+| **1 creative per brief** | Never multiple separate ads |
+| **Scene 1 = hooks only** | Scenes 2–N identical across all hook variations |
+| **AI prompts = Appendix** | Never inline. Always labeled OPTIONAL. |
+| **Brand kit = source of truth** | Colors, tone, guardrails all from brand-kit.md |
+| **WidthType.DXA always** | Never PERCENTAGE — breaks Google Docs |
+| **ShadingType.CLEAR always** | Never SOLID |
+| **No \n in TextRun** | Use separate Paragraph elements |
+| **Alert box always present** | First element after title block. Non-negotiable. |
+| **Max 7 pages (muse-driven)** | Tight. 3-column table. No prose essays in scene blocks. |
+| **↑ mirrors: notation required** | Every on-screen text line maps to muse text |
+| **30-day ≠ 60-day** | Calendar in brief must match the product's actual guarantee period |
+| **"Room" not "home"** | Check compliance rules — Clarifion ODRx requires "room" not "home" |
+| **Captions ON** | Note in every editing guidelines section |
+| **Phone number large** | 55+ audience reads on mobile — large, bold, high contrast |
+
+---
+
+## STARTING A NEW BRAND
+
+```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
+
+# 2. Fill all YAML fields from conversation
+# 3. Mark unknown fields: "TBD — confirm with client"
+# 4. Run the 3-question check (Step 3) before proceeding
+```
+
+---
+
+## FILE NAMING
+
+| File type | Convention |
+|-----------|-----------|
+| 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>` |
+| Muse frames | `/tmp/muse_frames/frame_Xs.jpg` |
+
+---
+
+## RESPONSE FORMAT — AFTER BRIEF IS GENERATED
+
+```
+✅ Brief generated: ~/Downloads/<filename>.docx
+
+Brand:     <Client Name>
+Creative:  1 video concept | <N> hook variations
+Scenes:    <N> scenes | ~<runtime>s | Muse: <muse name or "N/A">
+Format:    <AI Animation / UGC / Doctor-Led / etc.>
+Pages:     ~<N> pages
+
+File revealed in Finder. Google Drive open in Chrome.
+→ Drag file into Drive → right-click → Open with Google Docs
+
+Next steps:
+• Confirm AIR library access for product footage
+• Confirm VO talent / AI voice selection
+• Confirm offer pricing is current before publishing
+```
+
+---
+
+## RESPONSE FORMAT — AFTER 3 CLARIFICATION QUESTIONS
+
+After AskUserQuestion responses come back, confirm alignment before proceeding:
+
+```
+Got it — here's what I'm building:
+
+Muse:      <muse title> — <N>-scene structure
+Structure: <scene 1 beat> → <scene 2 beat> → ... → CTA
+Persona:   <name, age, key pain point>
+Offer:     <exact CTA text>
+Compliance: <most critical rule to enforce>
+
+Starting now — [reading frames / writing brief / etc.]
+```
+
+This confirmation step costs 10 seconds and prevents hours of rework.
+
+---
+
+## COMMON MISTAKES — NEVER REPEAT
+
+| Mistake | Correct Approach |
+|---------|-----------------|
+| Skipping the 3 questions | Always ask before writing — no exceptions |
+| Writing from a blank template | Always copy the closest existing working JS |
+| Ignoring the muse scene count | Muse has 9 scenes = brief has 9 scenes |
+| Writing muse brief without frame reads | Extract frames, read every one, THEN write |
+| Re-extracting frames that exist | Check /tmp/muse_frames/ first |
+| Long essay paragraphs in scene blocks | 3-column table, bullets, editor-readable only |
+| Missing ↑ mirrors: notation | Every on-screen text line must reference muse text |
+| Wrong guarantee period on calendar | Match the product's actual guarantee (30 days ≠ 60 days) |
+| "Home stops smelling" for ODRx | Must say "room" — compliance rule |
+| Opening Google Drive before file exists | Run the script and confirm DONE first |
+| Asking more than 3 questions | Exactly 3. Prioritize the highest-risk unknowns. |
+| Asking questions already answered in brand kit | Only ask what's genuinely unknown |

package/dist/index.js

@@ -12489,6 +12489,211 @@ ${result.lastError}`);
   );
 }
 
+function resolveKitAssetRootDist(kitId) {
+  const moduleDir = path17.dirname(fileURLToPath2(import.meta.url));
+  const assetRoot = path17.resolve(moduleDir, "../assets/worker-kits", kitId);
+  if (!existsSync2(assetRoot)) {
+    throw new Error(`Bundled worker kit assets not found for ${kitId}: ${assetRoot}`);
+  }
+  return assetRoot;
+}
+function resolveKitOutputRootDist(outDir) {
+  if (typeof outDir === "string" && outDir.trim().length > 0) {
+    return path17.resolve(expandHomePrefix(outDir.trim()));
+  }
+  return path17.resolve(resolvePaperclipHomeDir(), "kits", "exports");
+}
+function readJsonDist(filePath) {
+  return JSON.parse(readFileSync(filePath, "utf8"));
+}
+function listFilesRecursiveDist(rootDir, currentDir = rootDir) {
+  const entries = [];
+  for (const entry of readdirSync2(currentDir, { withFileTypes: true })) {
+    const fullPath = path17.join(currentDir, entry.name);
+    if (entry.isDirectory()) {
+      entries.push(...listFilesRecursiveDist(rootDir, fullPath));
+      continue;
+    }
+    entries.push(path17.relative(rootDir, fullPath).split(path17.sep).join("/"));
+  }
+  return entries.sort();
+}
+function copyDirRecursiveDist(sourceDir, targetDir) {
+  mkdirSync2(targetDir, { recursive: true });
+  for (const entry of readdirSync2(sourceDir, { withFileTypes: true })) {
+    const sourcePath = path17.join(sourceDir, entry.name);
+    const targetPath = path17.join(targetDir, entry.name);
+    if (entry.isDirectory()) {
+      copyDirRecursiveDist(sourcePath, targetPath);
+      continue;
+    }
+    copyFileSync(sourcePath, targetPath);
+  }
+}
+function crc32Dist(buffer) {
+  let crc = 4294967295;
+  for (const byte of buffer) {
+    crc ^= byte;
+    for (let bit = 0; bit < 8; bit += 1) {
+      crc = crc >>> 1 ^ 3988292384 & -(crc & 1);
+    }
+  }
+  return (crc ^ 4294967295) >>> 0;
+}
+function toDosDateTimeDist(date) {
+  const year = Math.max(date.getUTCFullYear(), 1980);
+  const month = date.getUTCMonth() + 1;
+  const day = date.getUTCDate();
+  const hours = date.getUTCHours();
+  const minutes = date.getUTCMinutes();
+  const seconds = Math.floor(date.getUTCSeconds() / 2);
+  return {
+    dosTime: hours << 11 | minutes << 5 | seconds,
+    dosDate: year - 1980 << 9 | month << 5 | day
+  };
+}
+function buildStoredZipDist(entries) {
+  const parts = [];
+  const central = [];
+  let offset = 0;
+  const { dosTime, dosDate } = toDosDateTimeDist(new Date("2026-04-09T00:00:00.000Z"));
+  for (const entry of entries) {
+    const nameBuffer = Buffer.from(entry.name, "utf8");
+    const data = entry.data;
+    const checksum = crc32Dist(data);
+    const localHeader = Buffer.alloc(30 + nameBuffer.length);
+    localHeader.writeUInt32LE(67324752, 0);
+    localHeader.writeUInt16LE(20, 4);
+    localHeader.writeUInt16LE(0, 6);
+    localHeader.writeUInt16LE(0, 8);
+    localHeader.writeUInt16LE(dosTime, 10);
+    localHeader.writeUInt16LE(dosDate, 12);
+    localHeader.writeUInt32LE(checksum, 14);
+    localHeader.writeUInt32LE(data.length, 18);
+    localHeader.writeUInt32LE(data.length, 22);
+    localHeader.writeUInt16LE(nameBuffer.length, 26);
+    localHeader.writeUInt16LE(0, 28);
+    nameBuffer.copy(localHeader, 30);
+    parts.push(localHeader, data);
+    const centralHeader = Buffer.alloc(46 + nameBuffer.length);
+    centralHeader.writeUInt32LE(33639248, 0);
+    centralHeader.writeUInt16LE(20, 4);
+    centralHeader.writeUInt16LE(20, 6);
+    centralHeader.writeUInt16LE(0, 8);
+    centralHeader.writeUInt16LE(0, 10);
+    centralHeader.writeUInt16LE(dosTime, 12);
+    centralHeader.writeUInt16LE(dosDate, 14);
+    centralHeader.writeUInt32LE(checksum, 16);
+    centralHeader.writeUInt32LE(data.length, 20);
+    centralHeader.writeUInt32LE(data.length, 24);
+    centralHeader.writeUInt16LE(nameBuffer.length, 28);
+    centralHeader.writeUInt16LE(0, 30);
+    centralHeader.writeUInt16LE(0, 32);
+    centralHeader.writeUInt16LE(0, 34);
+    centralHeader.writeUInt16LE(0, 36);
+    centralHeader.writeUInt32LE(0, 38);
+    centralHeader.writeUInt32LE(offset, 42);
+    nameBuffer.copy(centralHeader, 46);
+    central.push(centralHeader);
+    offset += localHeader.length + data.length;
+  }
+  const centralDirectory = Buffer.concat(central);
+  const endRecord = Buffer.alloc(22);
+  endRecord.writeUInt32LE(101010256, 0);
+  endRecord.writeUInt16LE(0, 4);
+  endRecord.writeUInt16LE(0, 6);
+  endRecord.writeUInt16LE(entries.length, 8);
+  endRecord.writeUInt16LE(entries.length, 10);
+  endRecord.writeUInt32LE(centralDirectory.length, 12);
+  endRecord.writeUInt32LE(offset, 16);
+  endRecord.writeUInt16LE(0, 20);
+  return Buffer.concat([...parts, centralDirectory, endRecord]);
+}
+function validateKitAssetRootDist(assetRoot, manifest, bundleManifest) {
+  const requiredPaths = [
+    "kit.json",
+    ...manifest.frozenAssetPaths,
+    ...manifest.outputStandard.requiredPaths,
+    ...bundleManifest.requiredFrozenAssets
+  ];
+  for (const relativePath of requiredPaths) {
+    const fullPath = path17.resolve(assetRoot, relativePath);
+    if (!existsSync2(fullPath)) {
+      throw new Error(`Bundled worker kit validation failed. Missing required path: ${relativePath}`);
+    }
+  }
+}
+function inspectKitDist(kitId, outDir) {
+  const assetRoot = resolveKitAssetRootDist(kitId);
+  const manifest = readJsonDist(path17.resolve(assetRoot, "kit.json"));
+  const bundleRef = manifest.bundles.find((bundle) => bundle.id === kitId) ?? manifest.bundles[0];
+  const bundleManifest = readJsonDist(path17.resolve(assetRoot, bundleRef.path));
+  validateKitAssetRootDist(assetRoot, manifest, bundleManifest);
+  const outputRoot = resolveKitOutputRootDist(outDir);
+  return {
+    assetRoot,
+    manifest,
+    bundleManifest,
+    outputRoot,
+    folderPath: path17.resolve(outputRoot, bundleManifest.export.folderName),
+    zipPath: path17.resolve(outputRoot, bundleManifest.export.zipFileName)
+  };
+}
+function listBundledKitsDist() {
+  const assetBase = path17.resolve(path17.dirname(fileURLToPath2(import.meta.url)), "../assets/worker-kits");
+  if (!existsSync2(assetBase)) return [];
+  return readdirSync2(assetBase, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => inspectKitDist(entry.name)).sort((a, b) => a.manifest.kit.id.localeCompare(b.manifest.kit.id));
+}
+function downloadKitDist(kitId, outDir) {
+  const info = inspectKitDist(kitId, outDir);
+  mkdirSync2(info.outputRoot, { recursive: true });
+  rmSync(info.folderPath, { recursive: true, force: true });
+  copyDirRecursiveDist(info.assetRoot, info.folderPath);
+  const zipEntries = listFilesRecursiveDist(info.folderPath).map((relativePath) => ({
+    name: path17.posix.join(info.bundleManifest.export.folderName, relativePath),
+    data: readFileSync(path17.resolve(info.folderPath, relativePath))
+  }));
+  writeFileSync(info.zipPath, buildStoredZipDist(zipEntries));
+  return info;
+}
+function registerKitCommandsDist(target) {
+  const kit = target.command("kit").description("Bundled Growthub Agent Worker Kit export utilities");
+  kit.command("list").description("List the bundled worker kits available in this CLI build").action(() => {
+    const kits = listBundledKitsDist();
+    if (kits.length === 0) {
+      console.log(pc21.dim("No bundled worker kits are available in this CLI build."));
+      return;
+    }
+    for (const item of kits) {
+      console.log([
+        pc21.bold(item.manifest.kit.id),
+        `version=${item.manifest.kit.version}`,
+        `bundle=${item.bundleManifest.bundle.id}@${item.bundleManifest.bundle.version}`,
+        `briefType=${item.bundleManifest.briefType}`,
+        `name=${item.manifest.kit.name}`
+      ].join("  "));
+    }
+  });
+  kit.command("inspect").description("Inspect a bundled worker kit manifest and export metadata").argument("<kit-id>", "Bundled worker kit id").option("--out <path>", "Override the export root used for resolved output paths").action((kitId, opts) => {
+    const info = inspectKitDist(kitId, opts.out);
+    console.log(`Kit: ${info.manifest.kit.id} @ ${info.manifest.kit.version}`);
+    console.log(`Name: ${info.manifest.kit.name}`);
+    console.log(`Bundle: ${info.bundleManifest.bundle.id} @ ${info.bundleManifest.bundle.version}`);
+    console.log(`Entrypoint: ${info.manifest.entrypoint.path}`);
+    console.log(`Export Folder: ${info.folderPath}`);
+    console.log(`Export Zip: ${info.zipPath}`);
+  });
+  kit.command("download").description("Export a bundled worker kit as both a zip file and expanded folder").argument("<kit-id>", "Bundled worker kit id").option("--out <path>", "Output directory for the generated artifacts").action((kitId, opts) => {
+    const info = downloadKitDist(kitId, opts.out);
+    console.log(`Expanded Folder: ${info.folderPath}`);
+    console.log(`Zip File: ${info.zipPath}`);
+  });
+  kit.command("path").description("Resolve the expected expanded export folder path without exporting").argument("<kit-id>", "Bundled worker kit id").option("--out <path>", "Output directory for the generated artifacts").action((kitId, opts) => {
+    const info = inspectKitDist(kitId, opts.out);
+    console.log(info.folderPath);
+  });
+}
+
 // src/index.ts
 var program = new Command();
 var DATA_DIR_OPTION_HELP = "Growthub data directory root (isolates local instance state)";
@@ -12520,6 +12725,7 @@ function registerSharedCommands(target) {
   });
   target.command("allowed-hostname").description("Allow a hostname for authenticated/private mode access").argument("<host>", "Hostname to allow (for example dotta-macbook-pro)").option("-c, --config <path>", "Path to config file").option("-d, --data-dir <path>", DATA_DIR_OPTION_HELP).action(addAllowedHostname);
   target.command("run").description("Bootstrap local setup (onboard + doctor) and run Growthub").option("-c, --config <path>", "Path to config file").option("-d, --data-dir <path>", DATA_DIR_OPTION_HELP).option("-i, --instance <id>", "Local instance id (default: default)").option("--repair", "Attempt automatic repairs during doctor", true).option("--no-repair", "Disable automatic repairs during doctor").action(runCommand);
+  registerKitCommandsDist(target);
   const auth = target.command("auth").description("Authentication and bootstrap utilities");
   auth.command("bootstrap-ceo").description("Create a one-time bootstrap invite URL for first instance admin").option("-c, --config <path>", "Path to config file").option("-d, --data-dir <path>", DATA_DIR_OPTION_HELP).option("--force", "Create new invite even if admin already exists", false).option("--expires-hours <hours>", "Invite expiration window in hours", (value) => Number(value)).option("--base-url <url>", "Public base URL used to print invite link").action(bootstrapCeoInvite);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growthub/cli",
-  "version": "0.3.34",
+  "version": "0.3.36",
   "description": "Growthub CLI — orchestrate AI agent teams to run a business",
   "type": "module",
   "bin": {
@@ -25,7 +25,8 @@
     "url": "https://github.com/antonioromero1220/growthub-local/issues"
   },
   "files": [
-    "dist"
+    "dist",
+    "assets"
   ],
   "engines": {
     "node": ">=20"