create-smash-os 0.1.2 → 0.1.3

package/install.mjs

@@ -3,23 +3,31 @@
  * smash-os-install — Install the SmashOS Claude Code harness into any repo.
  *
  * Usage (inside your repo root):
- *   npx smash-os-install
+ *   npx smash-os-install           — connected mode (requires SmashOS web app)
+ *   npx smash-os-install --local   — local-only mode (no web app, no API keys)
  *
- * What it does:
+ * What it does (connected):
  *   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
+ *
+ * What it does (--local):
+ *   1. Prompts for project name and tech stack only
+ *   2. Writes CLAUDE.md + /ai/ skeleton + 2 skills locally
+ *   3. No web app connection required
  */
 
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { join, dirname } from 'path';
+import { join, dirname, basename } from 'path';
+import { homedir } from 'os';
 import prompts from 'prompts';
 import chalk from 'chalk';
 
 const cwd = process.cwd();
+const isLocal = process.argv.includes('--local');
 
 // ─── Helpers ──────────────────────────────────────────────────────────────────
 
@@ -82,9 +90,236 @@ function ensureGitignore(entry) {
 
 console.log('');
 console.log(chalk.bold('  SmashOS Harness Installer'));
-console.log(chalk.dim('  Installs the Claude Code harness into your repo'));
+console.log(chalk.dim(isLocal ? '  Local-only mode — no web app required' : '  Installs the Claude Code harness into your repo'));
 console.log('');
 
+// ─── Local-only mode ──────────────────────────────────────────────────────────
+
+if (isLocal) {
+  const localAnswers = await prompts([
+    {
+      type: 'text',
+      name: 'projectName',
+      message: 'Project name',
+      initial: basename(cwd),
+      validate: (v) => (v.trim().length > 0 ? true : 'Required'),
+    },
+    {
+      type: 'text',
+      name: 'techStack',
+      message: 'Tech stack (e.g. React + Node.js + Postgres)',
+      initial: 'TypeScript',
+    },
+  ], { onCancel: () => { console.log(chalk.yellow('\n  Cancelled.')); process.exit(0); } });
+
+  const { projectName, techStack } = localAnswers;
+  const today = new Date().toISOString().split('T')[0];
+
+  const claudeMd = `# ${projectName} — SmashOS Harness Active
+
+You are operating inside the SmashOS AI Workflow Harness.
+You are not a single assistant. You are a coordinated AI engineering organisation.
+
+## On Session Start
+1. Read \`ai/context/product.md\` (if it exists)
+2. Read \`ai/context/architecture.md\` (if it exists)
+3. Read \`ai/context/coding-standards.md\` (if it exists)
+4. Read \`ai/memory/decisions.md\` — last 20 entries (if it exists)
+5. Adopt the role: Staff Engineer
+
+## Cognitive Mode Rules
+THINKING   → Staff Engineer, Product Manager (no file writes)
+EXECUTION  → Senior Developer, DevOps (no specs or decisions)
+VALIDATION → Security Engineer, QA Engineer (no production code)
+
+## Golden Rules
+- Never skip architecture review
+- Never write code without an approved spec
+- Never deploy without QA + Security validation
+- Output structured results only
+- Save decisions to memory after every significant choice
+
+## Slash Commands
+- /smash-os:role [name] — switch cognitive mode + load role definition
+
+## Tech Stack
+${techStack}
+`;
+
+  const aiFiles = {
+    'ai/orchestrator.md': `# ${projectName} — SmashOS Orchestrator
+**Generated:** ${today}
+**Version:** 1.0
+
+---
+
+## Overview
+
+You are operating inside the SmashOS AI Workflow Harness for **${projectName}**.
+You are not a single assistant. You are a coordinated AI engineering organisation.
+
+This orchestrator.md is your master boot document. Read it fully at the start of every session.
+
+---
+
+## On Session Start
+
+1. Read \`/ai/context/product.md\` — understand what you are building and for whom
+2. Read \`/ai/context/architecture.md\` — understand the technical system
+3. Read \`/ai/context/coding-standards.md\` — know the rules before touching any file
+4. Read \`/ai/memory/decisions.md\` (last 20 entries) — know what has been decided and why
+5. Adopt the role: Staff Engineer
+
+---
+
+## Cognitive Mode Rules
+
+| Mode | Roles | Permitted | Forbidden |
+|---|---|---|---|
+| THINKING | Staff Engineer, Product Manager | Specs, decisions, architecture docs | File writes, commits |
+| EXECUTION | Senior Developer, DevOps Engineer | Code, commits, branches, PRs | Specs, decisions |
+| VALIDATION | Security Engineer, QA Engineer | Scores, test results, audit reports | Production code |
+
+The orchestrator hard-blocks mode mixing. Never mix thinking and execution in the same phase.
+
+---
+
+## Golden Rules
+
+1. Never skip architecture review
+2. Never write code without an approved spec
+3. Never deploy without QA + Security validation
+4. Output structured results only — every phase output is a typed JSON object
+5. Save decisions to memory after every significant architectural choice
+6. Revenue risk outranks technical purity
+7. Block automation when stability drops below 40
+
+---
+
+## Active Role Definitions
+
+| Role | Mode | Primary Skill |
+|---|---|---|
+| Staff Engineer | THINKING | architecture-review |
+| Product Manager | THINKING | — |
+| Senior Developer | EXECUTION | code-generation |
+| Security Engineer | VALIDATION | security-audit |
+| QA Engineer | VALIDATION | qa-validation |
+| DevOps Engineer | EXECUTION | — |
+
+Full role definitions: \`/ai/roles/{role-name}.md\`
+
+---
+
+## Selective Context Loading
+
+Load only what your role requires. Never load the full context bundle.
+
+| Role | Load |
+|---|---|
+| Product Manager | product.md + database.md + trigger payload |
+| Staff Engineer | architecture.md + coding-standards.md + decisions.md + previous phase output |
+| Senior Developer | architecture.md + coding-standards.md + approved spec |
+| Security Engineer | database.md + auth section of architecture.md + file diff |
+| QA Engineer | coding-standards.md + acceptance criteria + file diff |
+| DevOps Engineer | architecture.md + PR metadata + score summary |
+
+---
+
+## Product Summary
+
+*Context not yet generated. Fill in \`/ai/context/product.md\` with your project details.*
+
+---
+
+## Architecture Summary
+
+*Context not yet generated. Fill in \`/ai/context/architecture.md\` with your architecture.*
+
+---
+
+## Coding Standards Summary
+
+*Context not yet generated. Fill in \`/ai/context/coding-standards.md\` with your coding standards.*
+
+---
+
+## Database Summary
+
+*Context not yet generated. Fill in \`/ai/context/database.md\` with your database details.*
+
+---
+
+## Memory
+
+- Architecture decisions: \`/ai/memory/decisions.md\`
+- Lessons learned: \`/ai/memory/lessons.md\`
+
+After every completed session, append decisions and lessons to the relevant memory file.
+
+---
+
+## Workflow References
+
+- Feature: \`/ai/workflows/feature.md\`
+- Bug Fix: \`/ai/workflows/bug-fix.md\`
+- Weekly Improvement: \`/ai/workflows/weekly-improvement.md\`
+
+---
+
+*Generated by smash-os-install (local mode) — fill in the /ai/context/ files to activate full context.*
+`,
+    'ai/context/product.md': `# Product Context — ${projectName}\n\n## What is this project?\n<!-- Describe what this project does -->\n\n## Who uses it?\n<!-- Describe the users -->\n\n## Core goals\n<!-- List the main goals -->\n\n## Tech Stack\n${techStack}\n`,
+    'ai/context/architecture.md': `# Architecture — ${projectName}\n\n## Overview\n<!-- Describe the high-level architecture -->\n\n## Key decisions\n<!-- List major architectural decisions and why they were made -->\n\n## Constraints\n<!-- List things that must not change -->\n`,
+    'ai/context/coding-standards.md': `# Coding Standards — ${projectName}\n\n## Language & formatting\n<!-- ESLint config, prettier, etc. -->\n\n## Naming conventions\n<!-- Variables, files, functions -->\n\n## Patterns to follow\n<!-- e.g. always use server actions, never bypass RLS -->\n\n## Patterns to avoid\n<!-- e.g. no raw SQL, no any types -->\n`,
+    'ai/memory/decisions.md': `# Decisions Log\n\n<!-- SmashOS writes here after each session. Format: -->\n<!-- ## YYYY-MM-DD — Decision title -->\n<!-- **Rationale:** why this was chosen -->\n<!-- **Outcome:** what changed -->\n`,
+    'ai/memory/lessons.md': `# Lessons Learned\n\n<!-- SmashOS writes here after bugs and incidents. Format: -->\n<!-- ## YYYY-MM-DD — Lesson title -->\n<!-- **What happened:** -->\n<!-- **What to do differently:** -->\n`,
+  };
+
+  const localSkills = {
+    'smash-os-role': `---\nname: smash-os-role\ndescription: Switch cognitive mode and load a SmashOS role definition. Use when the user says "act as X", "switch to X role", "be the X", or names a SmashOS role (Staff Engineer, Product Manager, Senior Developer, Security Engineer, QA Engineer, DevOps Engineer).\n---\n\n# /smash-os:role\n\nSwitch to the named role and adopt its cognitive mode.\n\n## Roles\n\n| Role | Mode | Allowed |\n|---|---|---|\n| Staff Engineer | THINKING | Architecture, decisions, reviews |\n| Product Manager | THINKING | Specs, user stories, acceptance criteria |\n| Senior Developer | EXECUTION | Writing code, editing files |\n| Security Engineer | VALIDATION | Security review only, no code changes |\n| QA Engineer | VALIDATION | Testing and verification only |\n| DevOps Engineer | EXECUTION | Infrastructure, deployment |\n\n## Steps\n1. Read the role name from the argument (default: Staff Engineer)\n2. Announce: "Switching to [Role] — [Mode] mode"\n3. Load \`ai/roles/<role-slug>.md\` if it exists\n4. Apply the cognitive mode restrictions for the rest of the session\n`,
+    'smash-os-memory': `---\nname: smash-os-memory\ndescription: Show recent SmashOS decisions and lessons from the ai/memory/ folder. Use when the user says "show memory", "what decisions were made", "show lessons", or "smash-os memory".\n---\n\n# /smash-os:memory\n\nRead and display the local SmashOS memory files.\n\n## Steps\n1. Read \`ai/memory/decisions.md\` (last 20 entries)\n2. Read \`ai/memory/lessons.md\` (last 10 entries)\n3. Display them clearly — decisions first, then lessons\n4. If either file is empty or missing, say so\n`,
+  };
+
+  let written = 0;
+
+  writeFile('CLAUDE.md', claudeMd);
+  console.log('  ' + chalk.green('✓') + ' ' + chalk.white('CLAUDE.md'));
+  written++;
+
+  for (const [relPath, content] of Object.entries(aiFiles)) {
+    if (!existsSync(join(cwd, relPath))) {
+      writeFile(relPath, content);
+      console.log('  ' + chalk.green('✓') + ' ' + chalk.white(relPath));
+      written++;
+    } else {
+      console.log('  ' + chalk.dim('↷') + ' ' + chalk.dim(`${relPath} (already exists — skipped)`));
+    }
+  }
+
+  console.log('');
+  for (const [skillName, skillContent] of Object.entries(localSkills)) {
+    const skillDir = join(homedir(), '.claude', 'skills', skillName);
+    mkdirSync(skillDir, { recursive: true });
+    writeFileSync(join(skillDir, 'SKILL.md'), skillContent, 'utf8');
+    console.log('  ' + chalk.green('✓') + ' ' + chalk.white(`/smash-os:${skillName.replace('smash-os-', '')}`) + chalk.dim(' → ~/.claude/skills/'));
+    written++;
+  }
+
+  console.log('');
+  console.log(chalk.bold.green('  SmashOS harness installed!') + chalk.dim(` (${written} files — local mode)`));
+  console.log('');
+  console.log(chalk.dim('  Open Claude Code in this directory and start working:'));
+  console.log('  ' + chalk.white('  claude .'));
+  console.log('');
+  console.log(chalk.dim('  Fill in the ai/context/ files with your project details,'));
+  console.log(chalk.dim('  then Claude Code will load them automatically every session.'));
+  console.log('');
+  process.exit(0);
+}
+
+// ─── Connected mode ────────────────────────────────────────────────────────────
+
 const answers = await prompts(
   [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-smash-os",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Scaffold a SmashOS AI workflow platform into any directory",
   "type": "module",
   "bin": {