renn-studio 0.6.0

package/hooks/dist/renn-check-update.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+// Check for RENN updates in background, write result to cache
+// Called by SessionStart hook - runs once per session
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawn } = require('child_process');
+
+const homeDir = os.homedir();
+const cwd = process.cwd();
+const cacheDir = path.join(homeDir, '.claude', 'cache');
+const cacheFile = path.join(cacheDir, 'renn-update-check.json');
+
+// VERSION file locations (check project first, then global)
+const projectVersionFile = path.join(cwd, '.claude', 'renn', 'VERSION');
+const globalVersionFile = path.join(homeDir, '.claude', 'renn', 'VERSION');
+
+// Ensure cache directory exists
+if (!fs.existsSync(cacheDir)) {
+  fs.mkdirSync(cacheDir, { recursive: true });
+}
+
+// Run check in background
+const child = spawn(
+  process.execPath,
+  [
+    '-e',
+    `
+  const fs = require('fs');
+  const { execSync } = require('child_process');
+
+  const cacheFile = ${JSON.stringify(cacheFile)};
+  const projectVersionFile = ${JSON.stringify(projectVersionFile)};
+  const globalVersionFile = ${JSON.stringify(globalVersionFile)};
+
+  let installed = '0.0.0';
+  try {
+    if (fs.existsSync(projectVersionFile)) {
+      installed = fs.readFileSync(projectVersionFile, 'utf8').trim();
+    } else if (fs.existsSync(globalVersionFile)) {
+      installed = fs.readFileSync(globalVersionFile, 'utf8').trim();
+    }
+  } catch (e) {}
+
+  let latest = null;
+  try {
+    latest = execSync('npm view renn version', { encoding: 'utf8', timeout: 10000, windowsHide: true }).trim();
+  } catch (e) {}
+
+  const result = {
+    update_available: latest && installed !== latest,
+    installed,
+    latest: latest || 'unknown',
+    checked: Math.floor(Date.now() / 1000)
+  };
+
+  fs.writeFileSync(cacheFile, JSON.stringify(result));
+`,
+  ],
+  {
+    stdio: 'ignore',
+    windowsHide: true,
+  }
+);
+
+child.unref();

package/hooks/dist/renn-statusline.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+// Claude Code Statusline - RENN Edition
+// Shows: model | current task | directory | context usage
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Read JSON from stdin
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => (input += chunk));
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input);
+    const model = data.model?.display_name || 'Claude';
+    const dir = data.workspace?.current_dir || process.cwd();
+    const session = data.session_id || '';
+    const remaining = data.context_window?.remaining_percentage;
+
+    // Context window display (shows USED percentage scaled to 80% limit)
+    let ctx = '';
+    if (remaining != null) {
+      const rem = Math.round(remaining);
+      const rawUsed = Math.max(0, Math.min(100, 100 - rem));
+      const used = Math.min(100, Math.round((rawUsed / 80) * 100));
+
+      const filled = Math.floor(used / 10);
+      const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(10 - filled);
+
+      if (used < 63) {
+        ctx = ` \x1b[32m${bar} ${used}%\x1b[0m`;
+      } else if (used < 81) {
+        ctx = ` \x1b[33m${bar} ${used}%\x1b[0m`;
+      } else if (used < 95) {
+        ctx = ` \x1b[38;5;208m${bar} ${used}%\x1b[0m`;
+      } else {
+        ctx = ` \x1b[5;31m\ud83d\udc80 ${bar} ${used}%\x1b[0m`;
+      }
+    }
+
+    // Current task from todos
+    let task = '';
+    const homeDir = os.homedir();
+    const todosDir = path.join(homeDir, '.claude', 'todos');
+    if (session && fs.existsSync(todosDir)) {
+      try {
+        const files = fs
+          .readdirSync(todosDir)
+          .filter((f) => f.startsWith(session) && f.includes('-agent-') && f.endsWith('.json'))
+          .map((f) => ({ name: f, mtime: fs.statSync(path.join(todosDir, f)).mtime }))
+          .sort((a, b) => b.mtime - a.mtime);
+
+        if (files.length > 0) {
+          try {
+            const todos = JSON.parse(fs.readFileSync(path.join(todosDir, files[0].name), 'utf8'));
+            const inProgress = todos.find((t) => t.status === 'in_progress');
+            if (inProgress) task = inProgress.activeForm || '';
+          } catch (_e) {
+            /* ignore parse errors */
+          }
+        }
+      } catch (_e) {
+        // Silently fail on file system errors
+      }
+    }
+
+    // RENN update available?
+    let rennUpdate = '';
+    const cacheFile = path.join(homeDir, '.claude', 'cache', 'renn-update-check.json');
+    if (fs.existsSync(cacheFile)) {
+      try {
+        const cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
+        if (cache.update_available) {
+          rennUpdate = '\x1b[33m\u2b06 RENN update\x1b[0m \u2502 ';
+        }
+      } catch (_e) {
+        /* ignore parse errors */
+      }
+    }
+
+    // Output
+    const dirname = path.basename(dir);
+    if (task) {
+      process.stdout.write(
+        `${rennUpdate}\x1b[2m${model}\x1b[0m \u2502 \x1b[1m${task}\x1b[0m \u2502 \x1b[2m${dirname}\x1b[0m${ctx}`
+      );
+    } else {
+      process.stdout.write(
+        `${rennUpdate}\x1b[2m${model}\x1b[0m \u2502 \x1b[2m${dirname}\x1b[0m${ctx}`
+      );
+    }
+  } catch (_e) {
+    // Silent fail
+  }
+});

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "renn-studio",
+  "version": "0.6.0",
+  "description": "Grow ideas into shipped software",
+  "bin": {
+    "renn": "bin/install.js"
+  },
+  "files": [
+    "bin",
+    "commands",
+    "renn",
+    "agents",
+    "hooks/dist"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "agentic",
+    "context-engineering",
+    "code-execution",
+    "gemini",
+    "gemini-cli"
+  ],
+  "author": "Ash",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AshExplained/renn.git"
+  },
+  "homepage": "https://github.com/AshExplained/renn",
+  "bugs": {
+    "url": "https://github.com/AshExplained/renn/issues"
+  },
+  "engines": {
+    "node": ">=16.7.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "eslint": "^9.39.2",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.1"
+  },
+  "lint-staged": {
+    "*.js": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.json": [
+      "prettier --write"
+    ],
+    "*.{yml,yaml}": [
+      "prettier --write"
+    ],
+    "commands/*.md": [
+      "node scripts/validate-markdown.js"
+    ],
+    "agents/*.md": [
+      "node scripts/validate-markdown.js"
+    ],
+    "renn/workflows/*.md": [
+      "node scripts/validate-markdown.js"
+    ],
+    "renn/references/*.md": [
+      "node scripts/validate-markdown.js"
+    ],
+    "renn/templates/**/*.md": [
+      "node scripts/validate-markdown.js"
+    ],
+    "hooks/renn-*.js": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "scripts": {
+    "build:hooks": "node scripts/build-hooks.js",
+    "prepublishOnly": "npm run build:hooks",
+    "prepare": "husky",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "validate": "node scripts/validate-markdown.js",
+    "validate:dist": "node scripts/check-dist-sync.js",
+    "test": "node --test tests/*.test.js",
+    "check": "npm run lint && npm run format:check && npm run validate && npm run validate:dist"
+  }
+}

package/renn/references/continuation-format.md

@@ -0,0 +1,249 @@
+# Continuation Format
+
+Standard format for presenting next steps after completing a command or workflow.
+
+## Core Structure
+
+```
+---
+
+## ▶ Next Up
+
+**{identifier}: {name}** — {one-line description}
+
+`{command to copy-paste}`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `{alternative option 1}` — description
+- `{alternative option 2}` — description
+
+---
+```
+
+## Format Rules
+
+1. **Always show what it is** — name + description, never just a command path
+2. **Pull context from source** — track.md for stages, run.md `<objective>` for runs
+3. **Command in inline code** — backticks, easy to copy-paste, renders as clickable link
+4. **`/clear` explanation** — always include, keeps it concise but explains why
+5. **"Also available" not "Other options"** — sounds more app-like
+6. **Visual separators** — `---` above and below to make it stand out
+
+## Variants
+
+### Execute Next Run
+
+```
+---
+
+## ▶ Next Up
+
+**02.03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry
+
+`/renn.run-stage 2`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- Review run before executing
+- `/renn.list-stage-assumptions 2` — check assumptions
+
+---
+```
+
+### Execute Final Run in Stage
+
+Add note that this is the last run and what comes after:
+
+```
+---
+
+## ▶ Next Up
+
+**02.03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry
+<sub>Final run in Stage 2</sub>
+
+`/renn.run-stage 2`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**After this completes:**
+- Stage 2 → Stage 3 transition
+- Next: **Stage 3: Core Features** — User dashboard and settings
+
+---
+```
+
+### Plan a Stage
+
+```
+---
+
+## ▶ Next Up
+
+**Stage 2: Authentication** — JWT login flow with refresh tokens
+
+`/renn.plan-stage 2`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `/renn.discuss-stage 2` — gather context first
+- `/renn.research-stage 2` — investigate unknowns
+- Review track
+
+---
+```
+
+### Stage Complete, Ready for Next
+
+Show completion status before next action:
+
+```
+---
+
+## ✓ Stage 2 Complete
+
+3/3 runs executed
+
+## ▶ Next Up
+
+**Stage 3: Core Features** — User dashboard, settings, and data export
+
+`/renn.plan-stage 3`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `/renn.discuss-stage 3` — gather context first
+- `/renn.research-stage 3` — investigate unknowns
+- Review what Stage 2 built
+
+---
+```
+
+### Multiple Equal Options
+
+When there's no clear primary action:
+
+```
+---
+
+## ▶ Next Up
+
+**Stage 3: Core Features** — User dashboard, settings, and data export
+
+**To plan directly:** `/renn.plan-stage 3`
+
+**To discuss context first:** `/renn.discuss-stage 3`
+
+**To research unknowns:** `/renn.research-stage 3`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+```
+
+### Milestone Complete
+
+```
+---
+
+## 🎉 Milestone v1.0 Complete
+
+All 4 stages shipped
+
+## ▶ Next Up
+
+**Start v1.1** — questioning → research → requirements → track
+
+`/renn.new-milestone`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+```
+
+## Pulling Context
+
+### For stages (from track.md):
+
+```markdown
+### Stage 2: Authentication
+**Goal**: JWT login flow with refresh tokens
+```
+
+Extract: `**Stage 2: Authentication** — JWT login flow with refresh tokens`
+
+### For runs (from track.md):
+
+```markdown
+Runs:
+- [ ] 02.03: Add refresh token rotation
+```
+
+Or from run.md `<objective>`:
+
+```xml
+<objective>
+Add refresh token rotation with sliding expiry window.
+
+Purpose: Extend session lifetime without compromising security.
+</objective>
+```
+
+Extract: `**02.03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry`
+
+## Anti-Patterns
+
+### Don't: Command-only (no context)
+
+```
+## To Continue
+
+Run `/clear`, then paste:
+/renn.run-stage 2
+```
+
+User has no idea what 02.03 is about.
+
+### Don't: Missing /clear explanation
+
+```
+`/renn.plan-stage 3`
+
+Run /clear first.
+```
+
+Doesn't explain why. User might skip it.
+
+### Don't: "Other options" language
+
+```
+Other options:
+- Review track
+```
+
+Sounds like an afterthought. Use "Also available:" instead.
+
+### Don't: Fenced code blocks for commands
+
+```
+```
+/renn.plan-stage 3
+```
+```
+
+Fenced blocks inside templates create nesting ambiguity. Use inline backticks instead.