project-cypher 0.7.0 → 0.9.0

package/bin/cypher.js

@@ -1,9 +1,52 @@
 #!/usr/bin/env node
 // project-cypher: runs on your computer, exposes chosen folders to the Cypher phone app and runs Claude Code in them.
 const fs = require('fs'), os = require('os'), path = require('path'), { spawn } = require('child_process');
-const CFG_DIR = path.join(os.homedir(), '.cypher'), CFG = path.join(CFG_DIR, 'config.json');
-const load = () => { try { return JSON.parse(fs.readFileSync(CFG, 'utf8')); } catch { return { server: 'http://140.238.248.30:3300', token: '', projects: [], sessions: {}, permissionMode: 'acceptEdits' }; } };
-const save = c => { fs.mkdirSync(CFG_DIR, { recursive: true }); fs.writeFileSync(CFG, JSON.stringify(c, null, 2), { mode: 0o600 }); };
+const CFG_DIR = process.env.CYPHER_HOME || path.join(os.homedir(), '.cypher'), CFG = path.join(CFG_DIR, 'config.json');
+const ROOT_DIR = path.join(CFG_DIR, 'root'), REG = path.join(ROOT_DIR, 'projects.json'), ROOT_MD = path.join(ROOT_DIR, 'CLAUDE.md');
+// Registry = ROOT_DIR/projects.json: [{id,name,path,summary}]. Root (Claude) and `cypher add` both edit it, so always validate on read.
+function readRegistry() {
+  let raw; try { raw = JSON.parse(fs.readFileSync(REG, 'utf8')); } catch { return []; }
+  if (!Array.isArray(raw)) return []; const seen = new Set(['root']);
+  return raw.filter(p => p && typeof p.id === 'string' && /^[a-z0-9][a-z0-9-]{0,40}$/.test(p.id) && !seen.has(p.id) && seen.add(p.id) && typeof p.path === 'string' && path.isAbsolute(p.path) && (() => { try { return fs.statSync(p.path).isDirectory(); } catch { return false; } })())
+    .map(p => ({ id: p.id, name: String(p.name || p.id).slice(0, 60), path: p.path, summary: String(p.summary || '').slice(0, 300) }));
+}
+const writeRegistry = list => { fs.mkdirSync(ROOT_DIR, { recursive: true }); fs.writeFileSync(REG, JSON.stringify(list, null, 2)); };
+const rawCfg = () => { try { return JSON.parse(fs.readFileSync(CFG, 'utf8')); } catch { return { server: 'http://140.238.248.30:3300', token: '', sessions: {}, permissionMode: 'acceptEdits' }; } };
+const load = () => { const c = rawCfg(); if (c.projects?.length && !fs.existsSync(REG)) writeRegistry(c.projects); delete c.projects; return { ...c, projects: readRegistry() }; };
+const save = c => { const { projects, ...rest } = c; fs.mkdirSync(CFG_DIR, { recursive: true }); fs.writeFileSync(CFG, JSON.stringify(rest, null, 2), { mode: 0o600 }); };
+const ROOT_TEMPLATE = (machine, ws) => `# Root
+
+You are **Root**, the control assistant for this computer (${machine}). You talk to the user through the Project Cypher phone app. You are not a project and you do not build things yourself: projects have their own chats.
+
+Files (this folder): \`projects.json\` is the registry the app reads. \`CLAUDE.md\` is this file: instructions plus your memory.
+Workspace: ${ws}  (new projects are created inside it)
+
+## What you do
+1. **Add an existing project.** The user gives a folder path. Check it exists (ls), look at README / package.json read-only to understand it, then add an entry to projects.json: {"id","name","path","summary"}. id = lowercase letters, digits and hyphens, unique, never "root". path = absolute. summary = one line. Store the real location, never copy the folder.
+2. **Create a new project.** Make a folder inside the workspace (workspace/<id>), run git init, register it in projects.json, and tell the user the path. Ask what it is if they did not say.
+3. **Remove a project.** Remove only the registry entry. Never delete folders.
+4. **Status.** Use read-only commands (uptime, df -h, free -h, uname -a, ls, cat) and projects.json. Answer briefly: load, disk, memory, each project and whether its folder still exists.
+5. **Memory.** Keep the Memory section below current: one line per project (the gist) plus any user preferences. Update it whenever you add, change or learn something.
+
+## Rules
+- projects.json must stay valid JSON: read it, change it, write the whole file back.
+- Replies are short, plain text, for a phone screen.
+- When a project is added or created, tell the user to open it from the Projects list to build.
+- Never run destructive commands. Do not change files outside this folder and the workspace.
+
+## Memory
+(nothing yet)
+`;
+function ensureRoot(workspace) {
+  const c = rawCfg(); const ws = path.resolve(workspace || c.workspace || path.join(os.homedir(), 'cypher-projects'));
+  fs.mkdirSync(ROOT_DIR, { recursive: true }); fs.mkdirSync(ws, { recursive: true });
+  if (!fs.existsSync(REG)) writeRegistry([]);
+  if (!fs.existsSync(ROOT_MD)) fs.writeFileSync(ROOT_MD, ROOT_TEMPLATE(os.hostname(), ws));
+  else { const t = fs.readFileSync(ROOT_MD, 'utf8'); const n = t.replace(/^Workspace: .*$/m, `Workspace: ${ws}  (new projects are created inside it)`); if (n !== t) fs.writeFileSync(ROOT_MD, n); }
+  if (c.workspace !== ws) { c.workspace = ws; save(c); }
+  return ws;
+}
+const ROOT_TOOLS = 'Read,Edit,Write,Glob,Grep,Bash(ls:*),Bash(mkdir:*),Bash(git init:*),Bash(cat:*),Bash(uptime),Bash(df:*),Bash(free:*),Bash(uname:*),Bash(hostname),Bash(whoami),Bash(date),Bash(pwd)';
 const slug = p => path.basename(p).toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '') || 'project';
 const httpOf = s => s.replace(/\/$/, ''), wsOf = s => httpOf(s).replace(/^http/, 'ws');
 
@@ -26,7 +69,14 @@ async function doLink(server) {
     const k = load(); k.server = base; k.token = j.token; k.machineId = j.machineId; save(k); console.log('linked.'); return;
   }
 }
+const dropToken = msg => { const k = rawCfg(); k.token = ''; delete k.machineId; save(k); console.log(msg); };
 const cmds = {
+  // Unlink this computer: tells the server, forgets the token. Projects/Root folder stay on disk.
+  async disconnect() {
+    const c = load(); if (!c.token) return console.log('already disconnected.');
+    await fetch(httpOf(c.server) + '/unlink', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ token: c.token }) }).catch(() => null);
+    dropToken('disconnected. This computer is no longer linked to your app. Run cypher init to link again.');
+  },
   // First-run setup: checks Claude Code, reaches the server, shows the QR, adds this folder, goes online.
   async init(...argv) {
     const si = argv.indexOf('--server'); const server = si >= 0 ? argv[si + 1] : undefined; const c = load(); const base = httpOf(server || c.server);
@@ -50,15 +100,13 @@ const cmds = {
     console.log(`[ok] Server ${base}`);
     if (c.token) { const again = await ask('This computer is already linked. Link again? [y/N] '); if (!yes(again, false)) { console.log('Keeping the existing link.'); } else await doLink(base); }
     else await doLink(base);
-    // Pick the folder Claude works in. Default: where you ran this (even your home folder), so the app can chat right away.
-    let k = load();
-    if (!k.projects.length) {
-      const cwd = process.cwd();
-      let dir = cwd;
-      if (!yes(await ask(`Let Claude work in this folder? ${cwd} [Y/n] `), true)) dir = path.resolve((await ask('Folder path: ')).replace(/^~/, os.homedir()));
-      cmds.add(dir);
-    } else if (!k.projects.some(p => p.path === process.cwd()) && process.cwd() !== os.homedir() && yes(await ask(`Also add this folder (${process.cwd()})? [Y/n] `), true)) cmds.add('.');
-    if (!load().projects.length) { console.log('\nNo project added. Run: cypher add <folder>   then: cypher connect'); return; }
+    // Workspace = where Root creates new projects. Default: the folder you ran init in.
+    const cur = rawCfg().workspace; const cwd = process.cwd();
+    let ws = cur || cwd;
+    if (!cur) { const a2 = await ask(`Where should Root create new projects? [${cwd}] `); if (a2) ws = path.resolve(a2.replace(/^~/, os.homedir())); }
+    ws = ensureRoot(ws);
+    console.log(`\nRoot is ready. New projects will be created in ${ws}`);
+    console.log('Open Project Cypher and chat with Root: add existing folders, create projects, ask for status.');
     console.log('\nOnline soon. Keep this window open (Ctrl+C to stop). Next time just run: cypher connect');
     cmds.connect();
   },
@@ -94,35 +142,39 @@ const cmds = {
   },
   add(dir = '.') {
     const p = path.resolve(dir); if (!fs.existsSync(p)) return console.log('no such folder: ' + p);
-    const c = load(); if (c.projects.some(x => x.path === p)) return console.log('already added');
-    let id = slug(p), n = 2; while (c.projects.some(x => x.id === id)) id = slug(p) + '-' + n++;
-    c.projects.push({ id, name: path.basename(p), path: p }); save(c); console.log(`added ${id} (${p})`);
+    ensureRoot(); const list = readRegistry(); if (list.some(x => x.path === p)) return console.log('already added');
+    let id = slug(p), n = 2; if (id === 'root') id = 'root-project'; while (list.some(x => x.id === id)) id = slug(p) + '-' + n++;
+    list.push({ id, name: path.basename(p), path: p, summary: '' }); writeRegistry(list); console.log(`added ${id} (${p})`);
   },
-  remove(id) { const c = load(); c.projects = c.projects.filter(x => x.id !== id); save(c); console.log('removed ' + id); },
+  remove(id) { writeRegistry(readRegistry().filter(x => x.id !== id)); console.log('removed ' + id); },
   projects() { const c = load(); if (!c.projects.length) return console.log('none yet. cypher add <folder>'); c.projects.forEach(p => console.log(`${p.id.padEnd(20)} ${p.path}`)); },
   async status() { const c = load(); const r = await fetch(httpOf(c.server) + '/health').then(r => r.json()).catch(() => null); console.log(`server ${c.server}: ${r?.ok ? 'online' : 'unreachable'}\ntoken: ${c.token ? 'set' : 'missing (cypher login)'}\nprojects: ${c.projects.length}`); },
   async latest() { const c = load(); const l = await (await fetch(httpOf(c.server) + '/latest')).json(); console.log(`${l.versionName} (code ${l.versionCode})\n${l.apkUrl}`); },
   connect() {
+    const announce = () => [{ id: 'root', name: 'Root', root: true }, ...readRegistry().map(({ id, name, summary }) => ({ id, name, summary }))];
     const WebSocket = require('ws'); let c = load(); if (!c.token) return console.log('not linked yet. Run: cypher link');
-    if (!c.projects.length) return console.log('add a project first: cypher add <folder>');
+    ensureRoot();
         const runs = new Map(); let retry = 1000;
     const open = () => {
       c = { ...c, ...load() };
       const ws = new WebSocket(`${wsOf(c.server)}/agent?token=${encodeURIComponent(c.token)}`);
       const tx = m => ws.readyState === 1 && ws.send(JSON.stringify(m));
-      ws.on('open', () => { ws.opened = true; retry = 1000; tx({ type: 'hello', name: os.hostname(), projects: c.projects.map(({ id, name }) => ({ id, name })) }); console.log(`connected as ${os.hostname()} with ${c.projects.length} project(s). Ctrl+C to stop.`); });
+      ws.on('open', () => { ws.opened = true; retry = 1000; tx({ type: 'hello', name: os.hostname(), projects: announce() }); console.log(`connected as ${os.hostname()} with Root + ${readRegistry().length} project(s). Ctrl+C to stop.`); });
       // pick up `cypher add` / `remove` while running: re-announce projects when the config changes
-      let sig = JSON.stringify(load().projects.map(p => p.id));
-      const watch = setInterval(() => { const n = JSON.stringify(load().projects.map(p => p.id)); if (n !== sig) { sig = n; const ps = load().projects; tx({ type: 'hello', name: os.hostname(), projects: ps.map(({ id, name }) => ({ id, name })) }); console.log(`projects updated: ${ps.length}`); } }, 2000);
+      let sig = JSON.stringify(announce());
+      const watch = setInterval(() => { const a = announce(), n = JSON.stringify(a); if (n !== sig) { sig = n; tx({ type: 'hello', name: os.hostname(), projects: a }); console.log(`projects updated: ${a.length - 1}`); } }, 2000);
       ws.on('close', () => clearInterval(watch));
+      ws.on('unexpected-response', (req, res) => { if (res.statusCode === 401) { dropToken('This computer is not linked (removed from the app). Run cypher init to link again.'); process.exit(0); } else { req.destroy(); } });
       ws.on('message', raw => {
         let m; try { m = JSON.parse(raw); } catch { return; }
-        const proj = load().projects.find(p => p.id === m.projectId); const ctx = { reqId: m.reqId, projectId: m.projectId };
+        if (m.type === 'revoked') { runs.forEach(r => r.kill('SIGINT')); dropToken('Disconnected from the app. Run cypher init to link again.'); process.exit(0); }
+        const proj = m.projectId === 'root' ? { id: 'root', path: ROOT_DIR, root: true } : readRegistry().find(p => p.id === m.projectId); const ctx = { reqId: m.reqId, projectId: m.projectId };
         if (m.type === 'stop') return runs.get(m.projectId)?.kill('SIGINT');
         if (m.type !== 'prompt') return;
         if (!proj) return tx({ ...ctx, type: 'error', message: 'unknown project' });
         if (runs.has(proj.id)) return tx({ ...ctx, type: 'error', message: 'Claude is still working on this project.' });
         const cfg = load(); const args = ['-p', m.text, '--output-format', 'stream-json', '--verbose', '--permission-mode', cfg.permissionMode || 'acceptEdits'];
+        if (proj.root) { const wsd = rawCfg().workspace; args.push('--allowedTools', ROOT_TOOLS); if (wsd) args.push('--add-dir', wsd); }
         if (typeof m.model === 'string' && /^[a-z][a-z0-9.\-\[\]]{0,60}$/i.test(m.model) && m.model !== 'default') args.push('--model', m.model);
         if (cfg.sessions?.[proj.id]) args.push('--resume', cfg.sessions[proj.id]);
         console.log(`[${proj.id}] ${m.text.slice(0, 60)}`);
@@ -135,7 +187,7 @@ const cmds = {
             else if (b.type === 'tool_use') { const i = b.input || {}; tx({ ...ctx, type: 'tool', name: b.name, summary: String(i.file_path || i.command || i.pattern || i.path || i.url || i.description || '').slice(0, 120) }); }
           } else if (e.type === 'result') {
             if (e.session_id) { const k = load(); k.sessions = { ...k.sessions, [proj.id]: e.session_id }; save(k); }
-            tx({ ...ctx, type: 'done', error: !!e.is_error, cost: e.total_cost_usd });
+            runs.delete(proj.id); tx({ ...ctx, type: 'done', error: !!e.is_error, cost: e.total_cost_usd });
           }
         };
         ch.stdout.on('data', d => { buf += d; let i; while ((i = buf.indexOf('\n')) >= 0) { line(buf.slice(0, i)); buf = buf.slice(i + 1); } });
@@ -154,8 +206,9 @@ const help = () => console.log(`Project Cypher
   cypher init                         first-time setup: checks Claude Code, links to the app (QR), adds this folder, goes online
   cypher link [server-url]            link this computer to your phone (QR or code), add this folder, go online
   cypher pair <server-url> <code>     alternative: pair with a code made in the app
-  cypher add [folder]                 expose a project folder to the app
+  cypher add [folder]                 register a project folder (or just ask Root in the app)
   cypher projects | remove <id>       list / remove projects
+  cypher disconnect                   unlink this computer from the app
   cypher connect                      go online, run Claude Code when the app asks
   cypher status | latest              server check / latest app build
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-cypher",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Connect your machine's Claude Code projects to the Project Cypher phone app.",
   "bin": {
     "cypher": "bin/cypher.js"