@growthub/cli 0.14.5 → 0.14.8

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

@@ -1,89 +0,0 @@
----
-name: growthub-open-higgsfield-studio-v1
-description: "Self-contained workspace for Open Higgsfield AI visual production using Muapi BYOK. Produces implementation-ready visual briefs + rendered assets. Use when the user says: \"higgsfield\", \"muapi\", \"ai visual studio\". Session memory tracks prompt iterations, generation costs, and self-eval outcomes per render."
-triggers:
-  - open higgsfield studio
-  - fork growthub-open-higgsfield-studio-v1
-progressiveDisclosure: true
-sessionMemory:
-  path: .growthub-fork/project.md
-selfEval:
-  criteria:
-    - Operator contract (workers/open-higgsfield-studio-operator/CLAUDE.md) read before any material change.
-    - .growthub-fork/project.md appended to at each material change.
-    - .growthub-fork/trace.jsonl receives a typed event for each material change.
-    - Kit-specific QUICKSTART / runtime-assumptions / output-standards honoured.
-  maxRetries: 3
-  traceTo: .growthub-fork/trace.jsonl
-helpers: []
-subSkills: []
-mcpTools: []
----
-
-# Growthub Agent Worker Kit — Open Higgsfield Studio
-
-Discovery entry + routing menu for the `growthub-open-higgsfield-studio-v1` worker kit. Family: `studio`. Agent contract: `workers/open-higgsfield-studio-operator/CLAUDE.md`.
-
-## When to use this skill
-
-When the user's intent matches any of the triggers above — or when an agent has been dropped into a fork whose `.growthub-fork/fork.json` declares `kitId: "growthub-open-higgsfield-studio-v1"`.
-
-## Decision tree
-
-```
-Fork exists (this directory contains .growthub-fork/fork.json)?
-├── No  → run: growthub starter init --out <path>   (or import-repo / import-skill)
-│         then: growthub kit download growthub-open-higgsfield-studio-v1 --out <path>
-│
-└── Yes → read in this order:
-          1. .growthub-fork/project.md                         — session memory (primitive #3)
-          2. SKILL.md  (this file)                             — routing menu  (primitive #1)
-          3. skills.md                                         — operator runbook
-          4. workers/open-higgsfield-studio-operator/CLAUDE.md                              — agent contract
-          5. QUICKSTART.md                                     — first-run steps
-          6. runtime-assumptions.md                            — host expectations
-          7. .growthub-fork/policy.json                        — what you may touch
-          8. .growthub-fork/trace.jsonl (tail 20)              — recent machine history
-```
-
-## The six primitives (same shape across every Growthub worker kit)
-
-1. **`SKILL.md`** — this file.
-2. **Symlinked pointer** — repo-root `AGENTS.md` is authoritative.
-3. **`.growthub-fork/project.md`** — session memory, seeded by the CLI from `templates/project.md` at init/import time.
-4. **Self-evaluation** — generate → apply → evaluate → record; retry up to `selfEval.maxRetries` (default 3); mirrors the Fork Sync Agent's preview → apply → trace loop (primitive #4). Contract: `@growthub/api-contract/skills::SkillSelfEval`.
-5. **`skills/`** — nested sub-skills for parallel sub-agents on heavy / narrow work.
-6. **`helpers/`** — safe shell tool layer. Promote inline shell here whenever the same snippet is re-used.
-
-## Self-evaluation (primitive #4)
-
-Enforce `selfEval.maxRetries: 3`. At the ceiling, park with a `needs_confirmation` note in `project.md` and stop. Record every attempt to both `project.md` and `trace.jsonl`.
-
-## Session memory (primitive #3)
-
-`.growthub-fork/project.md` is the only cross-session continuity surface for this fork. Append at every material change, approval boundary, and self-eval outcome.
-
-## Sub-skills (primitive #5)
-
-(None declared at the baseline; populate `skills/` and the frontmatter `subSkills[]` array as specialist lanes emerge.)
-
-## Helpers (primitive #6)
-
-(None declared at the baseline; populate `helpers/` and the frontmatter `helpers[]` array as inline shell matures.)
-
-## MCP routing (optional)
-
-List concrete MCP tool IDs in `mcpTools[]` when a fork runs an MCP server for auth-heavy actions. Declarative only at v1.
-
-## Related files
-
-- `skills.md` — operator runbook (deep)
-- `QUICKSTART.md` — first-run steps
-- `runtime-assumptions.md` — host expectations
-- `output-standards.md` — output locations + manifest shape
-- `validation-checklist.md` — pre-flight checklist (if present)
-- `templates/project.md` — session-memory template
-- `templates/self-eval.md` — self-evaluation template
-- `helpers/README.md` — safe shell tool layer convention
-- `skills/README.md` — sub-skill convention
-- `workers/open-higgsfield-studio-operator/CLAUDE.md` — agent contract

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/brands/NEW-CLIENT.md

@@ -1,46 +0,0 @@
-# Creating a New Client Brand Kit
-
-Each client you run campaigns for should have their own brand kit. The agent uses this as its primary brand reference during Step 1 of every session.
-
----
-
-## Setup
-
-```bash
-cp brands/_template/brand-kit.md brands/<client-slug>/brand-kit.md
-```
-
-Replace `<client-slug>` with a lowercase hyphenated identifier (e.g. `acme-corp`, `solo-founder`, `ecom-brand-x`).
-
----
-
-## Required fields to fill in
-
-Open your new `brands/<client-slug>/brand-kit.md` and complete:
-
-| Field | What to write |
-|---|---|
-| Brand name | Full brand name as it appears in content |
-| Visual identity | Colors, typography, logo usage notes |
-| Tone and voice | Adjectives that describe how the brand communicates |
-| Target audience | Who the content is for |
-| Content restrictions | What to avoid in visuals or copy |
-| Reference assets | Paths to existing brand images, videos, or logo files |
-
-Fill in every section. Incomplete brand kits result in generic outputs.
-
----
-
-## Telling the agent to use your brand kit
-
-At the start of your session, say:
-
-> "Use `brands/<client-slug>/brand-kit.md` as the active brand kit."
-
-The agent will load it in Step 1 instead of the Growthub default.
-
----
-
-## Multiple clients
-
-Keep one subdirectory per client under `brands/`. Each session uses exactly one active brand kit.

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/brands/_template/brand-kit.md

@@ -1,89 +0,0 @@
-# Brand Kit — [CLIENT NAME]
-
-Copy to `brands/<client-slug>/brand-kit.md` and fill before producing outputs.
-
----
-
-## IDENTITY
-
-```yaml
-client_name: "[CLIENT NAME]"
-slug: "[client-slug]"
-industry: "[industry]"
-primary_offer: "[offer]"
-campaign_owner: "[owner]"
-date_onboarded: "YYYY-MM-DD"
-```
-
-## AUDIENCE
-
-```yaml
-primary_persona:
-  role: "[role]"
-  company_type: "[company type]"
-  pain_point: "[pain]"
-  desired_outcome: "[desired outcome]"
-  awareness_level: "[awareness]"
-```
-
-## POSITIONING
-
-```yaml
-core_positioning: "[one-sentence positioning]"
-what_they_buy: "[outcome they actually want]"
-unique_mechanism: "[why this works]"
-proof_points:
-  - "[approved proof only]"
-```
-
-## VISUAL SYSTEM
-
-```yaml
-visual_identity:
-  palette:
-    primary: "#000000"
-    secondary: "#FFFFFF"
-    accent: "#CCCCCC"
-  visual_adjectives:
-    - "[cinematic]"
-    - "[premium]"
-    - "[clean]"
-  prohibited_visuals:
-    - "[visual no-go]"
-    - "[visual no-go]"
-  reference_styles:
-    - "[director / campaign / style]"
-```
-
-## MESSAGING
-
-```yaml
-voice_and_tone:
-  - "[direct]"
-  - "[clear]"
-approved_phrases:
-  - "[approved phrase]"
-messaging_guardrails:
-  - "[no-go claim]"
-cta_language:
-  primary: "[primary CTA]"
-  secondary: "[secondary CTA]"
-```
-
-## ASSET LIBRARY
-
-```yaml
-available_assets:
-  product_stills: "[path or URL]"
-  brand_guidelines: "[path or URL]"
-  source_video: "[path or URL]"
-  portrait_assets: "[path or URL]"
-  audio_assets: "[path or URL]"
-  prior_generations: "[path or URL]"
-```
-
-## DELIVERABLES LOG
-
-```text
-- YYYY-MM-DD | Open Higgsfield Visual Package v<N> — <Project Name> | output/<client-slug>/<project-slug>/
-```

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/brands/growthub/brand-kit.md

@@ -1,96 +0,0 @@
-# Brand Kit — Growthub
-
-Reference example brand kit for visual-generation work.
-
----
-
-## IDENTITY
-
-```yaml
-client_name: "Growthub"
-slug: "growthub"
-industry: "AI-enabled growth infrastructure and creative operations"
-primary_offer: "Creative velocity systems, visual strategy, and execution support for paid-media operators"
-campaign_owner: "Growthub"
-date_onboarded: "2026-04-10"
-```
-
-## AUDIENCE
-
-```yaml
-primary_persona:
-  role: "performance lead, agency owner, or growth operator"
-  company_type: "DTC brand, agency, or startup running paid acquisition"
-  pain_point: "creative throughput is too slow to sustain testing velocity"
-  desired_outcome: "more winning concepts without slower turnaround or more headcount"
-  awareness_level: "problem-aware"
-```
-
-## POSITIONING
-
-```yaml
-core_positioning: "Growthub is the operating layer that removes the bottleneck between creative ideas and campaign execution."
-what_they_buy: "speed to winning creative with more control and less chaos"
-unique_mechanism: "operator-grade planning plus AI-assisted visual production workflows"
-proof_points:
-  - "Use only approved client-result examples already cleared by Growthub"
-```
-
-## VISUAL SYSTEM
-
-```yaml
-visual_identity:
-  palette:
-    primary: "#0E1726"
-    secondary: "#F4F1E8"
-    accent: "#D8613C"
-  visual_adjectives:
-    - "decisive"
-    - "cinematic"
-    - "premium"
-    - "high-signal"
-  prohibited_visuals:
-    - "generic SaaS gradient slop"
-    - "empty dashboard glamour shots with no human tension"
-  reference_styles:
-    - "high-contrast product-led motion"
-    - "operator POV"
-    - "documentary-meets-performance-marketing"
-```
-
-## MESSAGING
-
-```yaml
-voice_and_tone:
-  - "direct"
-  - "operator-level"
-  - "confident"
-approved_phrases:
-  - "creative velocity"
-  - "remove the bottleneck between ideas and execution"
-  - "speed to winning ads"
-messaging_guardrails:
-  - "Do not promise guaranteed revenue outcomes"
-  - "Do not reduce Growthub to just an AI tool"
-cta_language:
-  primary: "Book your growth call"
-  secondary: "Review the plan and approve the batch"
-```
-
-## ASSET LIBRARY
-
-```yaml
-available_assets:
-  product_stills: "[fill per engagement]"
-  brand_guidelines: "[fill per engagement]"
-  source_video: "[fill per engagement]"
-  portrait_assets: "[fill per engagement]"
-  audio_assets: "[fill per engagement]"
-  prior_generations: "[fill per engagement]"
-```
-
-## DELIVERABLES LOG
-
-```text
-- 2026-04-10 | Open Higgsfield Visual Package v1 — Studio Launch Reference | output/growthub/studio-launch-reference/
-```

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/bundles/growthub-open-higgsfield-studio-v1.json

@@ -1,64 +0,0 @@
-{
-  "schemaVersion": 2,
-  "bundle": {
-    "id": "growthub-open-higgsfield-studio-v1",
-    "version": "1.0.0",
-    "kitId": "growthub-open-higgsfield-studio-v1",
-    "workerId": "open-higgsfield-studio-operator"
-  },
-  "briefType": "open-higgsfield-visual-production",
-  "publicExampleBrandPaths": [
-    "brands/growthub/brand-kit.md"
-  ],
-  "requiredFrozenAssets": [
-    "QUICKSTART.md",
-    ".env.example",
-    "skills.md",
-    "output-standards.md",
-    "runtime-assumptions.md",
-    "validation-checklist.md",
-    "workers/open-higgsfield-studio-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/visual-campaign-brief.md",
-    "templates/studio-selection-brief.md",
-    "templates/model-selection-recommendation.md",
-    "templates/shot-plan.md",
-    "templates/prompt-matrix.md",
-    "templates/generation-batch-plan.md",
-    "templates/asset-tracking.md",
-    "templates/review-qa-checklist.md",
-    "templates/platform-ready-execution-handoff.md",
-    "templates/frame-analysis.md",
-    "templates/prompt-templates/image-generation.md",
-    "templates/prompt-templates/video-generation.md",
-    "templates/prompt-templates/lip-sync-generation.md",
-    "templates/prompt-templates/cinema-generation.md",
-    "examples/visual-campaign-brief-sample.md",
-    "examples/shot-plan-sample.md",
-    "examples/prompt-matrix-sample.md",
-    "examples/platform-ready-handoff-sample.md",
-    "docs/open-higgsfield-fork-integration.md",
-    "docs/provider-adapter-layer.md",
-    "growthub-meta/README.md",
-    "growthub-meta/kit-standard.md",
-    "SKILL.md",
-    "templates/project.md",
-    "templates/self-eval.md",
-    "helpers/README.md",
-    "skills/README.md"
-  ],
-  "optionalPresets": [],
-  "export": {
-    "folderName": "growthub-agent-worker-kit-open-higgsfield-studio-v1",
-    "zipFileName": "growthub-agent-worker-kit-open-higgsfield-studio-v1.zip"
-  },
-  "activationModes": [
-    "export"
-  ]
-}

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/docs/open-higgsfield-fork-integration.md

@@ -1,63 +0,0 @@
-# Open Higgsfield Fork Integration Notes
-
-This document tells the agent what to inspect in a maintained local fork before it commits to a plan.
-
----
-
-## EXPECTED REPO LAYOUT
-
-Based on the upstream repository:
-
-```text
-app/
-components/
-electron/
-packages/studio/src/
-README.md
-package.json
-```
-
-The agent should treat these as the runtime-critical zones:
-- `packages/studio/src/models.js`
-- `packages/studio/src/muapi.js`
-- `packages/studio/src/components/*.jsx`
-- `components/StandaloneShell.js`
-- `components/ApiKeyModal.js`
-- `electron/`
-
----
-
-## WHAT TO INSPECT BEFORE GENERATING
-
-1. Which studios are actually rendered in the current fork
-2. Whether model ids or endpoint names differ from upstream
-3. Which controls the UI exposes for the chosen model
-4. Whether prompt is optional for the chosen mode
-5. How many input images are supported
-6. Whether upload history and generation history are available
-7. Whether browser and desktop packaging diverge
-
----
-
-## SOURCE OF TRUTH RULES
-
-- `models.js` is the model source of truth
-- `muapi.js` is the provider request-flow source of truth
-- the relevant studio component is the UI behavior source of truth
-- `README.md` is the environment and packaging overview
-- `electron/` is the desktop-specific behavior source of truth
-
-If these conflict, prefer:
-1. studio component behavior
-2. provider client behavior
-3. model registry
-4. README summary
-
----
-
-## FORK-AWARE OUTPUT RULE
-
-Every handoff should say whether it was:
-- `fork-verified`
-- `upstream-verified`
-- `assumption-based`

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/docs/provider-adapter-layer.md

@@ -1,67 +0,0 @@
-# Provider Adapter Layer Notes
-
-Muapi is the reference implementation for this kit because the upstream Open Higgsfield AI workflow is built around it. The adapter layer must remain pluggable.
-
----
-
-## REFERENCE PROVIDER — MUAPI
-
-| Field | Value |
-|---|---|
-| Provider name | Muapi |
-| Auth pattern | `x-api-key` header |
-| Upload flow | file upload first when image, video, or audio assets are required |
-| Submit flow | `POST /api/v1/{model-endpoint}` |
-| Poll flow | `GET /api/v1/predictions/{request_id}/result` |
-| Result flow | completed payload yields output URL(s) and status |
-
----
-
-## ADAPTER CONTRACT
-
-Every provider adapter should support:
-- `UPLOAD_ASSET`
-- `SUBMIT_GENERATION`
-- `POLL_RESULT`
-- `NORMALIZE_RESULT`
-- `LIST_MODEL_CAPABILITIES`
-
-Optional:
-- `CANCEL_JOB`
-- `LIST_HISTORY`
-- `HEALTHCHECK`
-
----
-
-## MODEL ENDPOINT MAPPING ASSUMPTION
-
-The agent should assume that a model entry maps to:
-- a studio category
-- an endpoint id
-- accepted inputs
-- exposed controls
-- output class
-
-Do not recommend a model without naming the endpoint or the endpoint assumption.
-
----
-
-## FALLBACK MODES
-
-When the reference provider path fails:
-- fallback to a second model in the same studio if available
-- fallback to a neighboring studio only if output intent can still be preserved
-- mark the handoff with the exact fallback trigger
-
----
-
-## FUTURE PROVIDER EXTENSION PATH
-
-New providers should be added by implementing the same contract and documenting:
-- auth
-- endpoint mapping
-- submit / poll rhythm
-- file upload behavior
-- result normalization
-
-Do not rewrite this kit around one provider-specific prompt schema.

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/platform-ready-handoff-sample.md

@@ -1,24 +0,0 @@
-# Growthub Platform-Ready Execution Handoff v1
-
-## Runtime Mode
-
-local-fork
-
-## Repo Inspection Summary
-
-- `packages/studio/src/models.js` reviewed for available video and lip-sync models
-- `packages/studio/src/muapi.js` reviewed for submit and poll behavior
-- `packages/studio/src/components/VideoStudio.jsx` reviewed for i2v vs t2v switching
-
-## Provider Adapter Assumptions
-
-- provider: Muapi
-- auth: `x-api-key`
-- flow: submit -> poll -> result
-
-## Execution Steps
-
-1. open video studio and load prompt `P01`
-2. submit batch `B01`
-3. poll until complete and review for continuity
-4. move to lip-sync batch after hook clip is approved

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/prompt-matrix-sample.md

@@ -1,6 +0,0 @@
-# Growthub Prompt Matrix v1
-
-| Prompt ID | Shot / Output | Studio | Model | Base Prompt | Variation Prompt | Negative / Exclusions | Controls | Assets |
-|---|---|---|---|---|---|---|---|---|
-| P01 | Hook reveal | video | Kling-class T2V | premium operator desk, kinetic startup energy, handheld push-in, warm key light, high-contrast branded palette | same beat with slower dolly and cleaner desk styling | warped hands, brand-off colors, text artifacts | 9:16, 5s | logo stills |
-| P02 | Talking operator | lip-sync | Infinite Talk-class I2V | direct-to-camera founder, calm authority, subtle head motion, realistic office background | increase urgency in expression only | rubber mouth, eye drift, over-animated cheeks | 9:16, 720p | portrait + audio |

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/shot-plan-sample.md

@@ -1,7 +0,0 @@
-# Growthub Shot Plan v1
-
-| Shot ID | Beat | Studio | Model | Assets | Camera Intent | Prompt Key | Ratio / Duration | Passes | Review Note |
-|---|---|---|---|---|---|---|---|---|---|
-| S01 | Hook reveal | video | Kling-class T2V | logo stills | handheld push-in | P01 | 9:16 / 5s | 3 | keep motion tight |
-| S02 | Operator close-up | lip-sync | Infinite Talk-class I2V | portrait + VO | static medium close | P02 | 9:16 / 6s | 2 | check mouth sync |
-| S03 | Hero payoff | cinema | cinema-native | product stills | 50mm dolly-in | P03 | 16:9 / keyframe | 4 | protect palette |

package/assets/worker-kits/growthub-open-higgsfield-studio-v1/examples/visual-campaign-brief-sample.md

@@ -1,22 +0,0 @@
-# Growthub Visual Campaign Brief v1
-
-## Project Overview
-
-| Field | Value |
-|---|---|
-| Client | Growthub |
-| Project | AI UGC launch teaser |
-| Objective | Produce 3 vertical concept clips and 1 cinematic hero still |
-| Primary platform | Meta / TikTok |
-| Runtime mode | local-fork |
-
-## Studio Hypothesis
-
-Primary studio: `video` for motion clips.  
-Fallback studio: `cinema` for hero still and controlled frame development.
-
-## Output Package
-
-- 3 motion concepts
-- 1 hero keyframe
-- 1 asset reuse plan

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

@@ -1,67 +0,0 @@
-# Growthub Agent Worker Kit — Open Higgsfield Studio v1
-
-**Kit ID:** `growthub-open-higgsfield-studio-v1`  
-**Version:** `1.0.0`  
-**Type:** `worker`  
-**Execution mode:** `export`
-
----
-
-## What this kit does
-
-This kit gives an agent a self-contained environment for visual-generation planning and execution support around Open Higgsfield AI.
-
-It packages:
-- agent operating instructions
-- a locked methodology
-- fork/runtime assumptions
-- provider adapter notes
-- visual production templates
-- examples
-- output standards
-- contributor metadata
-
-The intended operator is an AI visual content operator, cinematic prompt strategist, or browser-assisted creative producer working against a local fork, browser-hosted surface, or desktop app workflow.
-
----
-
-## Folder structure
-
-```text
-growthub-open-higgsfield-studio-v1/
-├── kit.json
-├── bundles/
-├── workers/
-├── brands/
-├── templates/
-├── examples/
-├── docs/
-├── growthub-meta/
-├── skills.md
-├── output-standards.md
-├── runtime-assumptions.md
-└── validation-checklist.md
-```
-
----
-
-## Activation
-
-1. Export the kit.
-2. Point the agent working directory at the expanded folder.
-3. The agent reads `workers/open-higgsfield-studio-operator/CLAUDE.md`.
-4. `skills.md` provides the working method for every session.
-
----
-
-## Supported output categories
-
-- visual campaign brief
-- studio selection brief
-- shot plan
-- prompt matrix
-- generation batch plan
-- model selection recommendation
-- asset reuse/reference plan
-- review notes
-- platform-ready execution handoff