@growthub/cli 0.14.5 → 0.14.8

package/assets/worker-kits/growthub-zernio-social-v1/setup/setup.mjs

@@ -1,247 +0,0 @@
-#!/usr/bin/env node
-// setup.mjs — one-command cross-platform bootstrap for the Zernio Social Media Studio
-//
-// Works identically on macOS, Linux, and Windows (PowerShell, cmd, WSL, git-bash).
-// Usage:
-//   node setup/setup.mjs                      # full bootstrap (deps + env + verify)
-//   node setup/setup.mjs --skip-deps          # skip dependency check
-//   node setup/setup.mjs --skip-verify        # skip live API reachability check
-//   node setup/setup.mjs --yes                # no-prompt mode (CI-safe)
-//
-// What it does (in order):
-//   1. Prints the kit banner and detects the host OS.
-//   2. Runs the cross-platform dependency check (Node 18+, curl optional, git optional).
-//   3. If .env is missing, copies .env.example to .env verbatim.
-//   4. Runs verify-env.mjs to confirm ZERNIO_API_KEY format + reachability.
-//   5. Prints the exact next step for the user's OS.
-//
-// No external dependencies. Pure Node stdlib only.
-
-import { existsSync, copyFileSync, readFileSync, statSync } from "node:fs";
-import { join, dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { spawn } from "node:child_process";
-import { platform, release } from "node:os";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const KIT_ROOT = resolve(__dirname, "..");
-
-const argv = new Set(process.argv.slice(2));
-const SKIP_DEPS = argv.has("--skip-deps");
-const SKIP_VERIFY = argv.has("--skip-verify");
-const YES = argv.has("--yes");
-
-const RED = "\x1b[31m";
-const GREEN = "\x1b[32m";
-const YELLOW = "\x1b[33m";
-const BLUE = "\x1b[34m";
-const BOLD = "\x1b[1m";
-const DIM = "\x1b[2m";
-const RESET = "\x1b[0m";
-
-function log(msg) { console.log(msg); }
-function step(n, label) { log(""); log(`${BOLD}${BLUE}[${n}/4]${RESET} ${BOLD}${label}${RESET}`); }
-function ok(msg) { log(`  ${GREEN}\u2713${RESET} ${msg}`); }
-function warn(msg) { log(`  ${YELLOW}!${RESET} ${msg}`); }
-function fail(msg) { log(`  ${RED}\u2717${RESET} ${msg}`); }
-
-function detectOs() {
-  const p = platform();
-  if (p === "darwin") return { id: "mac", pretty: "macOS" };
-  if (p === "win32") return { id: "windows", pretty: "Windows" };
-  if (p === "linux") return { id: "linux", pretty: "Linux" };
-  return { id: p, pretty: p };
-}
-
-function run(cmd, args, opts = {}) {
-  return new Promise((resolvePromise) => {
-    const child = spawn(cmd, args, { stdio: "inherit", shell: false, ...opts });
-    child.on("close", (code) => resolvePromise(code ?? 1));
-    child.on("error", () => resolvePromise(1));
-  });
-}
-
-function printBanner(osInfo) {
-  log("");
-  log(`${BOLD}Growthub Zernio Social Media Studio${RESET} \u2014 one-command setup`);
-  log(`${DIM}kit: growthub-zernio-social-v1  \u00b7  host: ${osInfo.pretty} (${platform()} ${release()})  \u00b7  node: ${process.version}${RESET}`);
-  log("");
-}
-
-// ---------------------------------------------------------------------------
-// Step 1 \u2014 Dependency check (cross-platform, node-native)
-// ---------------------------------------------------------------------------
-
-function checkNodeVersion() {
-  const major = Number.parseInt(process.versions.node.split(".")[0], 10);
-  if (!Number.isFinite(major) || major < 18) {
-    fail(`Node.js ${process.version} detected \u2014 Node 18+ required. Install from https://nodejs.org`);
-    return false;
-  }
-  ok(`Node.js ${process.version} (>= 18 required)`);
-  return true;
-}
-
-function which(binary) {
-  // Cross-platform "which": spawn a lookup with proper extension handling.
-  return new Promise((resolvePromise) => {
-    const isWin = platform() === "win32";
-    const lookup = isWin ? "where" : "which";
-    const child = spawn(lookup, [binary], { shell: false });
-    let out = "";
-    child.stdout?.on("data", (d) => (out += String(d)));
-    child.on("close", (code) => resolvePromise(code === 0 ? out.trim().split(/\r?\n/)[0] : null));
-    child.on("error", () => resolvePromise(null));
-  });
-}
-
-async function runDepsCheck() {
-  step(1, "Checking dependencies");
-  if (SKIP_DEPS) {
-    warn("--skip-deps passed \u2014 skipping dependency check");
-    return true;
-  }
-  let allGood = true;
-  if (!checkNodeVersion()) allGood = false;
-
-  const curlPath = await which("curl");
-  if (curlPath) ok(`curl at ${curlPath}`);
-  else warn("curl not found \u2014 not required (Node's built-in fetch is used), but recommended for manual API testing");
-
-  const gitPath = await which("git");
-  if (gitPath) ok(`git at ${gitPath}`);
-  else warn("git not found \u2014 not required for the kit, but recommended for your own project versioning");
-
-  return allGood;
-}
-
-// ---------------------------------------------------------------------------
-// Step 2 \u2014 Ensure .env exists
-// ---------------------------------------------------------------------------
-
-function ensureEnvFile() {
-  step(2, "Ensuring .env is in place");
-  const envPath = join(KIT_ROOT, ".env");
-  const examplePath = join(KIT_ROOT, ".env.example");
-
-  if (existsSync(envPath)) {
-    const size = statSync(envPath).size;
-    ok(`.env already exists (${size} bytes) \u2014 not overwriting`);
-    return { created: false, envPath };
-  }
-
-  if (existsSync(examplePath)) {
-    copyFileSync(examplePath, envPath);
-    ok(`Copied .env.example \u2192 .env`);
-    warn(`Open .env and fill in ZERNIO_API_KEY + ZERNIO_PROFILE_ID before running the operator`);
-    return { created: true, envPath };
-  }
-
-  // No .env.example \u2014 guide the user to create .env directly.
-  warn(".env not found \u2014 create it with your Zernio credentials:");
-  log(`  ${DIM}ZERNIO_API_KEY=sk_<your-64-hex-key>${RESET}`);
-  log(`  ${DIM}ZERNIO_API_URL=https://zernio.com/api/v1${RESET}`);
-  log(`  ${DIM}ZERNIO_PROFILE_ID=<your-profile-id>${RESET}`);
-  log(`  ${DIM}ZERNIO_TIMEZONE=America/New_York  # optional${RESET}`);
-  log(`  ${DIM}ANTHROPIC_API_KEY=sk-ant-...       # optional, for hybrid caption mode${RESET}`);
-  log("");
-  log(`  Skip env entirely for agent-only mode: ${BOLD}node setup/setup.mjs --skip-verify${RESET}`);
-  return { created: false, envPath: null };
-}
-
-// ---------------------------------------------------------------------------
-// Step 3 \u2014 Run verify-env.mjs (same file we already ship)
-// ---------------------------------------------------------------------------
-
-async function runVerifyEnv() {
-  step(3, "Verifying environment (format + reachability)");
-  if (SKIP_VERIFY) {
-    warn("--skip-verify passed \u2014 skipping environment verification");
-    return true;
-  }
-  loadDotEnvInto(process.env);
-  const verifyPath = join(__dirname, "verify-env.mjs");
-  if (!existsSync(verifyPath)) {
-    fail("setup/verify-env.mjs missing \u2014 kit payload is incomplete");
-    return false;
-  }
-  const code = await run(process.execPath, [verifyPath]);
-  // verify-env.mjs returns 0 even on warnings; non-zero only if it crashes
-  return code === 0;
-}
-
-// Minimal inline .env loader \u2014 no dotenv dependency.
-function loadDotEnvInto(target) {
-  const envPath = join(KIT_ROOT, ".env");
-  if (!existsSync(envPath)) return;
-  const raw = readFileSync(envPath, "utf8");
-  for (const rawLine of raw.split(/\r?\n/)) {
-    const line = rawLine.trim();
-    if (!line || line.startsWith("#")) continue;
-    const eq = line.indexOf("=");
-    if (eq < 0) continue;
-    const key = line.slice(0, eq).trim();
-    let value = line.slice(eq + 1).trim();
-    if ((value.startsWith("\"") && value.endsWith("\"")) || (value.startsWith("'") && value.endsWith("'"))) {
-      value = value.slice(1, -1);
-    }
-    if (target[key] === undefined) target[key] = value;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Step 4 \u2014 Print OS-specific next steps
-// ---------------------------------------------------------------------------
-
-function printNextSteps(osInfo, envCreated) {
-  step(4, "Next steps");
-  const open = osInfo.id === "mac" ? "open" : osInfo.id === "windows" ? "start" : "xdg-open";
-  if (envCreated) {
-    log(`  1. Fill in your Zernio key in .env:`);
-    if (osInfo.id === "windows") {
-      log(`       ${DIM}notepad .env${RESET}         (or any editor)`);
-      log(`       ${DIM}code .env${RESET}            (VS Code)`);
-    } else {
-      log(`       ${DIM}${open} .env${RESET}              (system default editor)`);
-      log(`       ${DIM}nano .env${RESET}              (terminal editor)`);
-      log(`       ${DIM}code .env${RESET}              (VS Code)`);
-    }
-    log(`  2. Re-run:  ${BOLD}node setup/setup.mjs${RESET}  to re-verify.`);
-    log(`  3. Then open Claude Code / Codex / Cursor at this folder as the Working Directory.`);
-  } else {
-    log(`  1. Open Claude Code / Codex / Cursor.`);
-    log(`  2. Point the Working Directory at:`);
-    log(`       ${BOLD}${KIT_ROOT}${RESET}`);
-    log(`  3. The ${BOLD}zernio-social-operator${RESET} agent entrypoint is:`);
-    log(`       ${DIM}workers/zernio-social-operator/CLAUDE.md${RESET}`);
-    log(`  4. Try: ${BOLD}"/zernio campaign"${RESET} to run the full 10-step workflow.`);
-  }
-  log("");
-  log(`${DIM}For full setup guidance see QUICKSTART.md. Agent-only mode is always valid \u2014 Zernio reachability does not block planning.${RESET}`);
-}
-
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-
-async function main() {
-  const osInfo = detectOs();
-  printBanner(osInfo);
-
-  const depsOk = await runDepsCheck();
-  const envResult = ensureEnvFile();
-  await runVerifyEnv();
-  printNextSteps(osInfo, envResult.created);
-
-  if (!depsOk) {
-    log("");
-    log(`${RED}${BOLD}One or more dependency checks failed. Fix the issues above and re-run.${RESET}`);
-    process.exit(1);
-  }
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

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

@@ -1,138 +0,0 @@
-#!/usr/bin/env node
-// verify-env.mjs — Verify Zernio API key + profile + reachability for the kit
-// Usage: node setup/verify-env.mjs
-
-const RED = "\x1b[31m";
-const GREEN = "\x1b[32m";
-const YELLOW = "\x1b[33m";
-const RESET = "\x1b[0m";
-
-let allPassed = true;
-const results = [];
-
-function check(label, passed, detail = "") {
-  const icon = passed ? `${GREEN}✓${RESET}` : `${RED}✗${RESET}`;
-  results.push({ label, passed, detail, icon });
-  if (!passed) allPassed = false;
-}
-
-function warn(label, detail = "") {
-  results.push({ label, passed: null, detail, icon: `${YELLOW}⚠${RESET}` });
-}
-
-console.log("Growthub Zernio Social Media Studio — Environment Verification");
-console.log("=".repeat(64));
-console.log("");
-
-// --- Check 1: ZERNIO_API_KEY format ---
-const ZERNIO_KEY_RE = /^sk_[0-9a-fA-F]{64}$/;
-const zernioKey = process.env.ZERNIO_API_KEY;
-let zernioKeyValid = false;
-if (!zernioKey || zernioKey === "your_zernio_api_key_here") {
-  warn("ZERNIO_API_KEY not set", "Set it in .env. Agent-only mode is still available.");
-} else if (!ZERNIO_KEY_RE.test(zernioKey)) {
-  check("ZERNIO_API_KEY format is valid", false, "Key must match sk_ + 64 hex characters");
-} else {
-  check("ZERNIO_API_KEY format is valid", true, zernioKey.slice(0, 8) + "...");
-  zernioKeyValid = true;
-}
-
-// --- Check 2: ZERNIO_API_URL present ---
-const zernioApiUrl = process.env.ZERNIO_API_URL ?? "https://zernio.com/api/v1";
-check("ZERNIO_API_URL is set", Boolean(zernioApiUrl), zernioApiUrl);
-
-// --- Check 3: Zernio API reachable (only if a plausible key exists) ---
-let apiReachable = false;
-if (zernioKeyValid) {
-  try {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 5000);
-    const res = await fetch(`${zernioApiUrl}/profiles`, {
-      signal: controller.signal,
-      headers: { Authorization: `Bearer ${zernioKey}` },
-    });
-    clearTimeout(timeout);
-    apiReachable = res.ok;
-    if (!res.ok) {
-      check("Zernio API accepts the key", false, `HTTP ${res.status} from GET ${zernioApiUrl}/profiles`);
-    } else {
-      check("Zernio API accepts the key", true, `HTTP 200 from GET ${zernioApiUrl}/profiles`);
-    }
-  } catch (err) {
-    check("Zernio API is reachable", false, `Could not reach ${zernioApiUrl} — ${String(err?.message ?? err).slice(0, 120)}`);
-  }
-} else {
-  warn("Zernio API reachability skipped", "No valid ZERNIO_API_KEY — agent-only mode only");
-}
-
-// --- Check 4: ZERNIO_PROFILE_ID ---
-const profileId = process.env.ZERNIO_PROFILE_ID;
-if (!profileId || profileId === "your_zernio_profile_id_here") {
-  warn("ZERNIO_PROFILE_ID not set", "Required for scheduling — find it in the Zernio dashboard or via GET /api/v1/profiles");
-} else if (zernioKeyValid && apiReachable) {
-  try {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 5000);
-    const res = await fetch(`${zernioApiUrl}/profiles/${encodeURIComponent(profileId)}`, {
-      signal: controller.signal,
-      headers: { Authorization: `Bearer ${zernioKey}` },
-    });
-    clearTimeout(timeout);
-    if (res.ok) {
-      check("ZERNIO_PROFILE_ID exists on the account", true, profileId.slice(0, 16) + "...");
-    } else if (res.status === 404) {
-      check("ZERNIO_PROFILE_ID exists on the account", false, "Profile not found for this API key");
-    } else {
-      warn("ZERNIO_PROFILE_ID lookup returned non-2xx", `HTTP ${res.status}`);
-    }
-  } catch (err) {
-    warn("ZERNIO_PROFILE_ID lookup failed", String(err?.message ?? err).slice(0, 120));
-  }
-} else {
-  check("ZERNIO_PROFILE_ID is set", true, "Format check only — API not reached");
-}
-
-// --- Check 5: ZERNIO_TIMEZONE plausibility (optional) ---
-const tz = process.env.ZERNIO_TIMEZONE;
-if (tz) {
-  // minimum sanity: looks like "Area/City" or a UTC offset tag
-  const plausible = /^[A-Za-z]+\/[A-Za-z_]+/.test(tz) || /^UTC[+-]?\d*$/i.test(tz);
-  if (plausible) {
-    check("ZERNIO_TIMEZONE format is plausible", true, tz);
-  } else {
-    check("ZERNIO_TIMEZONE format is plausible", false, `Unexpected value: ${tz}`);
-  }
-}
-
-// --- Check 6: Anthropic API key (optional) ---
-const anthropicKey = process.env.ANTHROPIC_API_KEY;
-if (!anthropicKey || anthropicKey === "your_anthropic_key_here") {
-  warn("ANTHROPIC_API_KEY not set", "Optional — used only for enhanced caption drafting in hybrid mode");
-} else if (anthropicKey.startsWith("sk-ant-")) {
-  check("ANTHROPIC_API_KEY format is valid", true);
-} else {
-  check("ANTHROPIC_API_KEY format is valid", false, "Key does not start with sk-ant- — check your Anthropic console");
-}
-
-// --- Print results ---
-console.log("Results:");
-for (const { icon, label, detail } of results) {
-  const detailStr = detail ? `  → ${detail}` : "";
-  console.log(`  ${icon}  ${label}${detailStr}`);
-}
-
-console.log("");
-
-if (allPassed) {
-  console.log(`${GREEN}All checks passed. Ready for api-live or hybrid mode.${RESET}`);
-} else {
-  const warnings = results.filter((r) => r.passed === null);
-  const failures = results.filter((r) => r.passed === false);
-  if (failures.length > 0) {
-    console.log(`${RED}${failures.length} check(s) failed. See details above.${RESET}`);
-    console.log(`\n  Agent-only mode remains available for campaign planning and dry-run manifests.`);
-  }
-  if (warnings.length > 0 && failures.length === 0) {
-    console.log(`${YELLOW}Checks passed with warnings. Agent-only mode is available.${RESET}`);
-  }
-}

package/assets/worker-kits/growthub-zernio-social-v1/skills/README.md

@@ -1,23 +0,0 @@
-# `skills/` — nested sub-skill convention (primitive #5)
-
-A **sub-skill** is a full `SKILL.md`-addressable lane that a parent skill can spawn as a parallel sub-agent.
-
-## Convention
-
-```
-skills/
-├── README.md                        # this file
-└── <slug>/                          # kebab-case; matches the SKILL.md name
-    ├── SKILL.md                     # frontmatter + routing body (≤ 500 lines)
-    ├── references/                  # optional — long docs loaded on demand
-    ├── templates/                   # optional — reusable text/JS templates
-    └── scripts/                     # optional — deterministic helpers
-```
-
-Each sub-skill's frontmatter follows `@growthub/api-contract/skills::SkillManifest`. Sub-skills share the parent's `.growthub-fork/project.md` journal — they do not branch it.
-
-## Parallelism
-
-Spawn a sub-skill sub-agent when (a) the sub-skill's work is fully scoped by its own criteria, and (b) the parent's next step does not depend on intermediate state from the sub-skill. Each sub-skill run appends a row to `project.md::subSkillRuns` so the parent can read the outcome on return.
-
-See the parent `SKILL.md` `subSkills[]` array for the current roster.