smash-os-install 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# smash-os-install
+
+Install the [SmashOS](https://github.com/MrShifu01/SmashOS) Claude Code harness into any repository.
+
+## Prerequisites
+
+1. A running SmashOS instance (self-hosted or deployed)
+2. Your repo registered in the SmashOS dashboard
+3. An API key generated from SmashOS → Settings → API Keys
+
+## Usage
+
+Run inside your repo root:
+
+```bash
+npx smash-os-install
+```
+
+The installer will prompt for:
+- **SmashOS URL** — where your SmashOS is deployed (e.g. `https://your-smash-os.vercel.app`)
+- **Repo ID** — from the SmashOS dashboard URL: `/dashboard/repos/<ID>`
+- **API Key** — from SmashOS → Settings → API Keys
+
+## What gets installed
+
+```
+CLAUDE.md                          ← harness instructions, loaded every Claude session
+.env.smash-os                      ← your credentials (gitignored automatically)
+.claude/settings.json              ← SessionStart + Stop hooks
+.claude/hooks/smash-os-boot.mjs    ← fetches live state from SmashOS on session start
+.claude/hooks/smash-os-sync.mjs    ← posts session summary to SmashOS on session end
+.claude/skills/smash-os-status.md  ← /smash-os:status command
+.claude/skills/smash-os-run.md     ← /smash-os:run command
+.claude/skills/smash-os-memory.md  ← /smash-os:memory command
+.claude/skills/smash-os-audit.md   ← /smash-os:audit command
+.claude/skills/smash-os-role.md    ← /smash-os:role command
+.claude/skills/smash-os-sync.md    ← /smash-os:sync command
+```
+
+If `.claude/settings.json` already exists, the hooks are merged — your existing config is preserved.
+
+## After installation
+
+1. Open a Claude Code session in this directory
+2. The harness activates automatically on session start
+3. Use `/smash-os:run feature` to trigger a pipeline
+4. View results in the SmashOS dashboard

package/index.js

@@ -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,28 @@
+{
+  "name": "smash-os-install",
+  "version": "0.1.0",
+  "description": "Install the SmashOS Claude Code harness into any repository",
+  "type": "module",
+  "bin": {
+    "smash-os-install": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "keywords": [
+    "smash-os",
+    "claude-code",
+    "ai-workflow",
+    "harness",
+    "install"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "prompts": "^2.4.2"
+  }
+}