create-smash-os 0.1.2

package/README.md

@@ -0,0 +1,76 @@
+# create-smash-os
+
+> Scaffold a [SmashOS](https://github.com/SmashBurgerBar/smash-os) AI workflow platform instance into any directory.
+
+## Usage
+
+```bash
+npx create-smash-os my-smash-os
+```
+
+Or without a name (interactive):
+
+```bash
+npx create-smash-os
+```
+
+## What it does
+
+1. **Clones** the latest SmashOS source from GitHub
+2. **Prompts** for your environment variables (Supabase, GitHub App)
+3. **Creates** `.env.local` with your values
+4. **Runs** `npm install`
+5. **Prints** next steps for Supabase schema push, GitHub App setup, and Vercel deployment
+
+## Prerequisites
+
+- Node.js 18+
+- A [Supabase](https://supabase.com) project (free tier works)
+- A [Vercel](https://vercel.com) account (for deployment)
+- A [GitHub App](https://github.com/settings/apps) (created during setup)
+
+## After scaffolding
+
+```bash
+cd my-smash-os
+
+# 1. Push the database schema
+npx supabase db push
+
+# 2. Fill in GitHub App credentials in .env.local
+#    (created during the wizard — GitHub App ID, Client ID, Client Secret, Private Key)
+
+# 3. Start locally
+npm run dev
+
+# 4. Deploy
+npx vercel --prod
+```
+
+## GitHub App setup
+
+During the wizard you'll be prompted for GitHub App credentials.
+Create your app at: **github.com/settings/apps → New GitHub App**
+
+Required settings:
+| Field | Value |
+|---|---|
+| Callback URL | `https://your-domain.vercel.app/auth/github-app/callback` |
+| Post-install redirect | `https://your-domain.vercel.app/dashboard/repos/new?installed=true` |
+| Webhook | Disabled (enabled in later setup) |
+| Permissions | Contents (Read), Metadata (Read), Pull requests (Read & Write), Commit statuses (Read & Write) |
+
+## Environment variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `SUPABASE_URL` | ✅ | Your Supabase project URL |
+| `SUPABASE_ANON_KEY` | ✅ | Supabase anon/public key |
+| `GITHUB_APP_ID` | ⚙️ | GitHub App numeric ID |
+| `GITHUB_APP_SLUG` | ⚙️ | GitHub App URL slug (e.g. `smash-os`) |
+| `GITHUB_CLIENT_ID` | ⚙️ | GitHub App OAuth Client ID |
+| `GITHUB_CLIENT_SECRET` | ⚙️ | GitHub App OAuth Client Secret |
+| `GITHUB_APP_PRIVATE_KEY` | ⚙️ | GitHub App PEM private key (newlines as `\n`) |
+| `GITHUB_WEBHOOK_SECRET` | ⚙️ | Webhook verification secret |
+
+⚙️ = Required for GitHub App integration (repo registration + context engine)

package/index.mjs

@@ -0,0 +1,287 @@
+#!/usr/bin/env node
+/**
+ * create-smash-os
+ * Usage: npx create-smash-os [project-name]
+ *
+ * Scaffolds the SmashOS AI workflow platform into a new directory.
+ * Clones from GitHub, runs interactive env setup, and installs dependencies.
+ */
+
+import { execSync } from "child_process";
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
+import { join, resolve } from "path";
+import { argv, exit, cwd } from "process";
+import { createInterface } from "readline";
+
+// ── Lazy-load optional deps (installed via the package's own node_modules) ──
+async function loadDeps() {
+  try {
+    const [chalkMod, promptsMod, tigedMod] = await Promise.all([
+      import("chalk"),
+      import("prompts"),
+      import("tiged"),
+    ]);
+    return {
+      chalk: chalkMod.default,
+      prompts: promptsMod.default,
+      tiged: tigedMod.default,
+    };
+  } catch {
+    // Fallback if deps aren't installed — happens on first npx run before cache
+    console.error(
+      "Missing dependencies. Run: npm install chalk prompts tiged\n" +
+      "Or use: npx create-smash-os (which auto-installs via npx)"
+    );
+    exit(1);
+  }
+}
+
+// ── GitHub source — update this once the repo has a public remote ──────────
+const GITHUB_REPO = "SmashBurgerBar/smash-os";
+// Files/dirs to exclude from the clone (CLI package itself, dev artifacts)
+const EXCLUDE_PATTERN = "create-smash-os/**,.env,.env.local";
+
+// ── Environment variables the user must configure ──────────────────────────
+const ENV_VARS = [
+  {
+    name: "SUPABASE_URL",
+    message: "Supabase Project URL",
+    hint: "https://your-project.supabase.co",
+    required: true,
+  },
+  {
+    name: "SUPABASE_ANON_KEY",
+    message: "Supabase Anon Key",
+    hint: "Find it in Project Settings → API",
+    required: true,
+  },
+  {
+    name: "GITHUB_APP_ID",
+    message: "GitHub App ID",
+    hint: "Create at github.com/settings/apps — leave blank to skip",
+    required: false,
+  },
+  {
+    name: "GITHUB_APP_SLUG",
+    message: "GitHub App Slug (lowercase name from GitHub App URL)",
+    hint: "e.g. smash-os",
+    required: false,
+    default: "smash-os",
+  },
+  {
+    name: "GITHUB_CLIENT_ID",
+    message: "GitHub App Client ID",
+    required: false,
+  },
+  {
+    name: "GITHUB_CLIENT_SECRET",
+    message: "GitHub App Client Secret",
+    required: false,
+    secret: true,
+  },
+  {
+    name: "GITHUB_APP_PRIVATE_KEY",
+    message: "GitHub App Private Key (PEM, paste with \\n for newlines)",
+    hint: "Download from GitHub App settings as .pem file",
+    required: false,
+    secret: true,
+    long: true,
+  },
+  {
+    name: "GITHUB_WEBHOOK_SECRET",
+    message: "GitHub Webhook Secret",
+    hint: "Generate with: openssl rand -hex 32",
+    required: false,
+    secret: true,
+  },
+];
+
+// ── Main ───────────────────────────────────────────────────────────────────
+async function main() {
+  const { chalk, prompts, tiged } = await loadDeps();
+
+  // ── Header ──────────────────────────────────────────────────────────────
+  console.log("");
+  console.log(chalk.bold.white("  ╔══════════════════════════════╗"));
+  console.log(chalk.bold.white("  ║     SmashOS  Installer       ║"));
+  console.log(chalk.bold.white("  ║   AI Workflow Platform       ║"));
+  console.log(chalk.bold.white("  ╚══════════════════════════════╝"));
+  console.log("");
+
+  // ── Project name ────────────────────────────────────────────────────────
+  let projectName = argv[2];
+  if (!projectName) {
+    const { name } = await prompts({
+      type: "text",
+      name: "name",
+      message: "Project name",
+      initial: "my-smash-os",
+      validate: (v) =>
+        /^[a-z0-9-_]+$/.test(v) || "Use lowercase letters, numbers, hyphens only",
+    });
+    if (!name) {
+      console.log(chalk.yellow("  Cancelled."));
+      exit(0);
+    }
+    projectName = name;
+  }
+
+  const targetDir = resolve(cwd(), projectName);
+
+  if (existsSync(targetDir)) {
+    const { overwrite } = await prompts({
+      type: "confirm",
+      name: "overwrite",
+      message: `Directory "${projectName}" already exists. Continue anyway?`,
+      initial: false,
+    });
+    if (!overwrite) {
+      console.log(chalk.yellow("  Cancelled."));
+      exit(0);
+    }
+  } else {
+    mkdirSync(targetDir, { recursive: true });
+  }
+
+  // ── Clone from GitHub ────────────────────────────────────────────────────
+  console.log("");
+  console.log(chalk.cyan(`  Cloning SmashOS from github.com/${GITHUB_REPO}…`));
+
+  try {
+    const emitter = tiged(GITHUB_REPO, {
+      cache: false,
+      force: true,
+      verbose: false,
+    });
+
+    await emitter.clone(targetDir);
+    console.log(chalk.green("  ✓ Source cloned"));
+  } catch (err) {
+    console.error("");
+    console.error(chalk.red("  ✗ Clone failed:"), err.message);
+    console.error("");
+    console.error(
+      chalk.yellow("  The GitHub repo may not be public yet, or the slug may need updating.")
+    );
+    console.error(chalk.yellow(`  Expected: https://github.com/${GITHUB_REPO}`));
+    console.error("");
+    console.error(chalk.dim("  Tip: To scaffold from a local copy instead, run:"));
+    console.error(chalk.dim(`    cp -r /path/to/smash-os ${projectName}`));
+    exit(1);
+  }
+
+  // ── Remove the create-smash-os package from the clone ───────────────────
+  try {
+    execSync(`rm -rf "${join(targetDir, "create-smash-os")}"`, { stdio: "ignore" });
+  } catch {
+    // Non-critical — directory may not exist
+  }
+
+  // ── Env setup ────────────────────────────────────────────────────────────
+  console.log("");
+  console.log(chalk.bold("  Environment Setup"));
+  console.log(chalk.dim("  Configure your SmashOS instance. Press Enter to skip optional vars."));
+  console.log("");
+
+  const envValues = {};
+
+  for (const envVar of ENV_VARS) {
+    const hint = envVar.hint ? chalk.dim(` (${envVar.hint})`) : "";
+    const required = envVar.required ? chalk.red(" *required") : chalk.dim(" optional");
+
+    const { value } = await prompts({
+      type: envVar.long ? "text" : "text",
+      name: "value",
+      message: `${envVar.message}${required}${hint}`,
+      initial: envVar.default ?? "",
+    });
+
+    if (value) {
+      envValues[envVar.name] = value;
+    } else if (envVar.required) {
+      console.log(chalk.yellow(`  ⚠ ${envVar.name} is required — you'll need to add it to .env.local manually.`));
+    }
+  }
+
+  // ── Write .env.local ─────────────────────────────────────────────────────
+  const envLines = [
+    "# SmashOS — generated by create-smash-os",
+    "# Edit this file with your actual credentials before deploying.",
+    "",
+  ];
+
+  for (const envVar of ENV_VARS) {
+    const val = envValues[envVar.name] ?? "";
+    if (envVar.message) {
+      envLines.push(`# ${envVar.message}`);
+    }
+    envLines.push(`${envVar.name}=${val}`);
+    envLines.push("");
+  }
+
+  const envPath = join(targetDir, ".env.local");
+  writeFileSync(envPath, envLines.join("\n"), "utf-8");
+  console.log("");
+  console.log(chalk.green("  ✓ .env.local created"));
+
+  // ── npm install ──────────────────────────────────────────────────────────
+  console.log(chalk.cyan("  Installing dependencies…"));
+  try {
+    execSync("npm install", { cwd: targetDir, stdio: "inherit" });
+    console.log(chalk.green("  ✓ Dependencies installed"));
+  } catch {
+    console.log(chalk.yellow("  ⚠ npm install failed — run it manually inside the project."));
+  }
+
+  // ── Next steps ───────────────────────────────────────────────────────────
+  console.log("");
+  console.log(chalk.bold.green("  SmashOS scaffolded successfully!"));
+  console.log("");
+  console.log(chalk.bold("  Next steps:"));
+  console.log("");
+  console.log(
+    chalk.white("  1."),
+    chalk.dim("Push the Supabase schema:"),
+    chalk.cyan(`cd ${projectName} && npx supabase db push`)
+  );
+  console.log(
+    chalk.white("  2."),
+    chalk.dim("Create a GitHub App at:"),
+    chalk.cyan("github.com/settings/apps → New GitHub App")
+  );
+  console.log(
+    chalk.white("     "),
+    chalk.dim("Callback URL:"),
+    chalk.white(`https://your-domain.vercel.app/auth/github-app/callback`)
+  );
+  console.log(
+    chalk.white("     "),
+    chalk.dim("Post-install URL:"),
+    chalk.white(`https://your-domain.vercel.app/dashboard/repos/new?installed=true`)
+  );
+  console.log(
+    chalk.white("  3."),
+    chalk.dim("Update .env.local with your GitHub App credentials")
+  );
+  console.log(
+    chalk.white("  4."),
+    chalk.dim("Deploy to Vercel:"),
+    chalk.cyan(`cd ${projectName} && npx vercel --prod`)
+  );
+  console.log(
+    chalk.white("  5."),
+    chalk.dim("Start locally:"),
+    chalk.cyan(`cd ${projectName} && npm run dev`)
+  );
+  console.log("");
+  console.log(
+    chalk.dim("  Full setup guide: "),
+    chalk.underline.cyan(`https://github.com/${GITHUB_REPO}#setup`)
+  );
+  console.log("");
+}
+
+main().catch((err) => {
+  console.error("Unexpected error:", err);
+  exit(1);
+});

package/install.mjs

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+/**
+ * smash-os-install — Install the SmashOS Claude Code harness into any repo.
+ *
+ * Usage (inside your repo root):
+ *   npx smash-os-install
+ *
+ * What it does:
+ *   1. Prompts for your SmashOS URL, Repo ID, and API key
+ *   2. Validates credentials against the SmashOS API
+ *   3. Fetches the generated harness files for your repo
+ *   4. Writes CLAUDE.md, .claude/hooks/, .claude/skills/, .env.smash-os
+ *   5. Merges hooks into existing .claude/settings.json (if present)
+ *   6. Adds .env.smash-os to .gitignore
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import prompts from 'prompts';
+import chalk from 'chalk';
+
+const cwd = process.cwd();
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function writeFile(relPath, content) {
+  const abs = join(cwd, relPath);
+  mkdirSync(dirname(abs), { recursive: true });
+  writeFileSync(abs, content, 'utf8');
+}
+
+function mergeSettingsJson(newSettingsContent) {
+  const settingsPath = join(cwd, '.claude', 'settings.json');
+
+  if (!existsSync(settingsPath)) {
+    writeFile('.claude/settings.json', newSettingsContent);
+    return false; // not merged, freshly created
+  }
+
+  let existing;
+  try {
+    existing = JSON.parse(readFileSync(settingsPath, 'utf8'));
+  } catch {
+    // Unreadable — overwrite
+    writeFile('.claude/settings.json', newSettingsContent);
+    return false;
+  }
+
+  const incoming = JSON.parse(newSettingsContent);
+  if (!existing.hooks) existing.hooks = {};
+
+  for (const [event, hookList] of Object.entries(incoming.hooks ?? {})) {
+    if (!existing.hooks[event]) existing.hooks[event] = [];
+    for (const hookGroup of hookList) {
+      for (const hook of hookGroup.hooks ?? []) {
+        const alreadyPresent = existing.hooks[event].some((g) =>
+          g.hooks?.some((h) => h.command === hook.command)
+        );
+        if (!alreadyPresent) {
+          existing.hooks[event].push({ hooks: [hook] });
+        }
+      }
+    }
+  }
+
+  writeFile('.claude/settings.json', JSON.stringify(existing, null, 2));
+  return true; // merged into existing
+}
+
+function ensureGitignore(entry) {
+  const gitignorePath = join(cwd, '.gitignore');
+  if (existsSync(gitignorePath)) {
+    const content = readFileSync(gitignorePath, 'utf8');
+    if (content.includes(entry)) return;
+    writeFileSync(gitignorePath, content.trimEnd() + '\n' + entry + '\n', 'utf8');
+  } else {
+    writeFileSync(gitignorePath, entry + '\n', 'utf8');
+  }
+}
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+
+console.log('');
+console.log(chalk.bold('  SmashOS Harness Installer'));
+console.log(chalk.dim('  Installs the Claude Code harness into your repo'));
+console.log('');
+
+const answers = await prompts(
+  [
+    {
+      type: 'text',
+      name: 'apiUrl',
+      message: 'SmashOS URL (where your SmashOS is deployed)',
+      initial: 'http://localhost:5173',
+      validate: (v) => (v.startsWith('http') ? true : 'Must be a valid URL'),
+    },
+    {
+      type: 'text',
+      name: 'repoId',
+      message: 'Repo ID (from the SmashOS dashboard URL: /dashboard/repos/<ID>)',
+      validate: (v) => (v.trim().length > 0 ? true : 'Required'),
+    },
+    {
+      type: 'password',
+      name: 'apiKey',
+      message: 'API Key (from SmashOS Settings → API Keys)',
+      validate: (v) => (v.trim().length > 0 ? true : 'Required'),
+    },
+  ],
+  {
+    onCancel: () => {
+      console.log(chalk.yellow('\n  Cancelled.'));
+      process.exit(0);
+    },
+  }
+);
+
+const { apiUrl, repoId, apiKey } = answers;
+const cleanUrl = apiUrl.replace(/\/$/, '');
+
+// ─── Validate & fetch ─────────────────────────────────────────────────────────
+
+process.stdout.write('\n  ' + chalk.dim('Connecting to SmashOS…'));
+
+let data;
+try {
+  const resp = await fetch(`${cleanUrl}/api/repos/${repoId}/layer2-files`, {
+    headers: { Authorization: `Bearer ${apiKey}` },
+  });
+
+  if (resp.status === 401) {
+    console.log(chalk.red(' ✗'));
+    console.error(chalk.red('\n  Invalid API key or Repo ID. Check SmashOS → Settings → API Keys.\n'));
+    process.exit(1);
+  }
+  if (resp.status === 404) {
+    console.log(chalk.red(' ✗'));
+    console.error(chalk.red('\n  Repo not found. Check the Repo ID in your SmashOS dashboard URL.\n'));
+    process.exit(1);
+  }
+  if (!resp.ok) {
+    console.log(chalk.red(' ✗'));
+    console.error(chalk.red(`\n  SmashOS returned ${resp.status}. Is the URL correct?\n`));
+    process.exit(1);
+  }
+
+  data = await resp.json();
+} catch (err) {
+  console.log(chalk.red(' ✗'));
+  console.error(chalk.red(`\n  Could not reach SmashOS at ${cleanUrl}\n  ${err.message}\n`));
+  process.exit(1);
+}
+
+console.log(chalk.green(' ✓'));
+console.log('  ' + chalk.dim(`Connected to SmashOS — repo: ${chalk.white(data.repo.name)}`));
+console.log('');
+
+// ─── Write files ──────────────────────────────────────────────────────────────
+
+const { files } = data;
+let written = 0;
+let merged = false;
+
+for (const [relPath, content] of Object.entries(files)) {
+  if (relPath === '.claude/settings.json') {
+    merged = mergeSettingsJson(content);
+    console.log(
+      '  ' + chalk.green('✓') + ' ' +
+      chalk.white('.claude/settings.json') +
+      chalk.dim(merged ? ' (merged with existing)' : ' (created)')
+    );
+  } else {
+    writeFile(relPath, content);
+    console.log('  ' + chalk.green('✓') + ' ' + chalk.white(relPath));
+  }
+  written++;
+}
+
+// ─── Write .env.smash-os (pre-filled) ────────────────────────────────────────
+
+const envContent = [
+  '# SmashOS harness credentials — do not commit this file',
+  `SMASH_OS_API_URL=${cleanUrl}`,
+  `SMASH_OS_REPO_ID=${repoId}`,
+  `SMASH_OS_API_KEY=${apiKey}`,
+].join('\n') + '\n';
+
+writeFile('.env.smash-os', envContent);
+console.log('  ' + chalk.green('✓') + ' ' + chalk.white('.env.smash-os') + chalk.dim(' (pre-filled)'));
+
+// ─── Gitignore ────────────────────────────────────────────────────────────────
+
+ensureGitignore('.env.smash-os');
+console.log('  ' + chalk.green('✓') + ' ' + chalk.dim('.env.smash-os added to .gitignore'));
+
+// ─── Done ─────────────────────────────────────────────────────────────────────
+
+console.log('');
+console.log(chalk.bold.green('  SmashOS harness installed!') + chalk.dim(` (${written} files)`));
+console.log('');
+console.log(chalk.dim('  Next steps:'));
+console.log(chalk.dim('  1. Open a Claude Code session in this directory'));
+console.log(chalk.dim('  2. The harness activates automatically on session start'));
+console.log(chalk.dim(`  3. Use ${chalk.white('/smash-os:run')} to trigger a pipeline`));
+console.log(chalk.dim(`  4. View results at: ${chalk.white(cleanUrl + '/dashboard/repos/' + repoId)}`));
+console.log('');

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "create-smash-os",
+  "version": "0.1.2",
+  "description": "Scaffold a SmashOS AI workflow platform into any directory",
+  "type": "module",
+  "bin": {
+    "create-smash-os": "./index.mjs",
+    "smash-os-install": "./install.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "install.mjs",
+    "steps.mjs",
+    "README.md"
+  ],
+  "keywords": [
+    "smash-os",
+    "ai-workflow",
+    "scaffold",
+    "create"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "prompts": "^2.4.2",
+    "tiged": "^2.12.7"
+  }
+}