project-cypher 0.10.0 → 0.12.0

package/bin/cypher.js

@@ -41,7 +41,7 @@ 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));
+  if (!fs.existsSync(ROOT_MD)) fs.writeFileSync(ROOT_MD, ROOT_TEMPLATE(devName(), 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;
@@ -51,11 +51,58 @@ const slug = p => path.basename(p).toLowerCase().replace(/[^a-z0-9]+/g, '-').rep
 const httpOf = s => s.replace(/\/$/, ''), wsOf = s => httpOf(s).replace(/^http/, 'ws');
 
 const ask = q => new Promise(r => { const rl = require('readline').createInterface({ input: process.stdin, output: process.stdout }); rl.question(q, a => { rl.close(); r(a.trim()); }); });
+const devName = () => rawCfg().name || os.hostname();
+
+// ── Background service (auto-start at boot/login, restarts on crash, waits for internet) ──
+const LOG = path.join(CFG_DIR, 'agent.log'), SELF = [process.execPath, path.resolve(__filename), 'connect'];
+const sh = (cmd, args) => require('child_process').spawnSync(cmd, args, { encoding: 'utf8' });
+const SVC = {
+  kind: process.platform === 'darwin' ? 'launchd' : process.platform === 'win32' ? 'task' : 'systemd',
+  unit: path.join(os.homedir(), '.config/systemd/user/cypher.service'),
+  plist: path.join(os.homedir(), 'Library/LaunchAgents/com.cypher.agent.plist'),
+  install() {
+    fs.mkdirSync(CFG_DIR, { recursive: true });
+    if (this.kind === 'systemd') {
+      fs.mkdirSync(path.dirname(this.unit), { recursive: true });
+      fs.writeFileSync(this.unit, `[Unit]\nDescription=Project Cypher agent\nAfter=network-online.target\nWants=network-online.target\n\n[Service]\nExecStart=${SELF.map(x => `"${x}"`).join(' ')}\nRestart=on-failure\nRestartSec=5\nStandardOutput=append:${LOG}\nStandardError=append:${LOG}\n\n[Install]\nWantedBy=default.target\n`);
+      sh('systemctl', ['--user', 'daemon-reload']); sh('loginctl', ['enable-linger', os.userInfo().username]); // linger = start at boot even before login
+      return sh('systemctl', ['--user', 'enable', 'cypher.service']).status === 0;
+    }
+    if (this.kind === 'launchd') {
+      fs.mkdirSync(path.dirname(this.plist), { recursive: true });
+      fs.writeFileSync(this.plist, `<?xml version="1.0" encoding="UTF-8"?>\n<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n<plist version="1.0"><dict><key>Label</key><string>com.cypher.agent</string><key>ProgramArguments</key><array>${SELF.map(x => `<string>${x}</string>`).join('')}</array><key>RunAtLoad</key><true/><key>KeepAlive</key><dict><key>SuccessfulExit</key><false/></dict><key>StandardOutPath</key><string>${LOG}</string><key>StandardErrorPath</key><string>${LOG}</string></dict></plist>\n`);
+      return true;
+    }
+    return sh('schtasks', ['/create', '/f', '/tn', 'ProjectCypher', '/sc', 'onlogon', '/rl', 'limited', '/tr', `cmd /c ""${SELF[0]}" "${SELF[1]}" connect >> "${LOG}" 2>&1"`]).status === 0;
+  },
+  start() {
+    if (!this.install()) return false;
+    if (this.kind === 'systemd') return sh('systemctl', ['--user', 'restart', 'cypher.service']).status === 0;
+    if (this.kind === 'launchd') { sh('launchctl', ['unload', this.plist]); return sh('launchctl', ['load', '-w', this.plist]).status === 0; }
+    return sh('schtasks', ['/run', '/tn', 'ProjectCypher']).status === 0;
+  },
+  stop() {
+    if (this.kind === 'systemd') { sh('systemctl', ['--user', 'stop', 'cypher.service']); return sh('systemctl', ['--user', 'disable', 'cypher.service']).status === 0; }
+    if (this.kind === 'launchd') return sh('launchctl', ['unload', '-w', this.plist]).status === 0;
+    sh('schtasks', ['/end', '/tn', 'ProjectCypher']); return sh('schtasks', ['/change', '/tn', 'ProjectCypher', '/disable']).status === 0;
+  },
+  remove() { this.stop(); try { fs.rmSync(this.kind === 'systemd' ? this.unit : this.plist, { force: true }); } catch {} if (this.kind === 'task') sh('schtasks', ['/delete', '/f', '/tn', 'ProjectCypher']); },
+  running() {
+    if (this.kind === 'systemd') return sh('systemctl', ['--user', 'is-active', 'cypher.service']).stdout.trim() === 'active';
+    if (this.kind === 'launchd') return sh('launchctl', ['list', 'com.cypher.agent']).status === 0;
+    return /Running/i.test(sh('schtasks', ['/query', '/tn', 'ProjectCypher']).stdout || '');
+  },
+  enabled() {
+    if (this.kind === 'systemd') return sh('systemctl', ['--user', 'is-enabled', 'cypher.service']).stdout.trim() === 'enabled';
+    if (this.kind === 'launchd') return fs.existsSync(this.plist);
+    return sh('schtasks', ['/query', '/tn', 'ProjectCypher']).status === 0;
+  },
+};
 const yes = (a, d) => (a === '' ? d : /^y/i.test(a));
 const has = (cmd, args = ['--version']) => { const r = require('child_process').spawnSync(cmd, args, { encoding: 'utf8' }); return r.error ? null : (r.stdout || r.stderr || '').trim().split('\n')[0]; };
 async function doLink(server) {
   const c = load(); const base = httpOf(server || c.server);
-  const r = await fetch(base + '/link/start', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ name: os.hostname() }) }).catch(() => null);
+  const r = await fetch(base + '/link/start', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ name: devName() }) }).catch(() => null);
   if (!r || !r.ok) { console.log('cannot reach ' + base); process.exit(1); }
   const { code, linkId } = await r.json();
   console.log('\nOpen Project Cypher on your phone and scan this, or type the code.\n');
@@ -75,7 +122,7 @@ const cmds = {
   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.');
+    SVC.remove(); 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) {
@@ -98,8 +145,9 @@ const cmds = {
     const h = await fetch(base + '/health').then(r => r.json()).catch(() => null);
     if (!h?.ok) { console.log(`[!!] Cannot reach the server ${base}. Check your internet (outbound port may be blocked).`); process.exit(1); }
     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);
+    const askName = async () => { let n = ''; while (!n) n = (await ask(`What should this computer be called in the app? [${devName()}] `)) || devName(); const k = load(); k.name = n.slice(0, 40); save(k); };
+    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 askName(); await doLink(base); } }
+    else { await askName(); await doLink(base); }
     // 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;
@@ -107,14 +155,14 @@ const cmds = {
     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();
+    if (SVC.start()) console.log('\nCypher now runs in the background and starts automatically whenever this computer is on and online.\nManage it with: cypher stats | cypher stop | cypher start');
+    else { console.log('\nCould not install the background service. Running in this window (Ctrl+C to stop). Next time: cypher connect'); cmds.connect(); }
   },
   // One command to link this computer to the phone: shows a QR + code, waits for the app, adds the current folder, goes online.
   async link(server) { await doLink(server); cmds.add('.'); cmds.connect(); },
   async _unused(server) {
     const c = load(); const base = httpOf(server || c.server);
-    const r = await fetch(base + '/link/start', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ name: os.hostname() }) }).catch(() => null);
+    const r = await fetch(base + '/link/start', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ name: devName() }) }).catch(() => null);
     if (!r || !r.ok) return console.log('cannot reach ' + base);
     const { code, linkId } = await r.json();
     console.log('\nOpen Project Cypher on your phone and scan this, or type the code.\n');
@@ -132,7 +180,7 @@ const cmds = {
   },
   async pair(server, code) {
     if (!server || !code) return console.log('usage: cypher pair <server-url> <code>   (get the code in the app: Projects > Add computer)');
-    const r = await fetch(httpOf(server) + '/pair', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ code, name: os.hostname() }) });
+    const r = await fetch(httpOf(server) + '/pair', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ code, name: devName() }) });
     const j = await r.json().catch(() => ({})); if (!r.ok) return console.log('pairing failed: ' + (j.error || r.status));
     const c = load(); c.server = httpOf(server); c.token = j.token; c.machineId = j.machineId; save(c); console.log('paired. Next: cypher add <folder>, then cypher connect');
   },
@@ -148,6 +196,15 @@ const cmds = {
   },
   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}`)); },
+  // Service control
+  start() { const c = load(); if (!c.token) return console.log('Not linked yet. Run: cypher init'); console.log(SVC.start() ? 'Cypher is running in the background and will start automatically when this computer turns on.' : 'Could not start the background service. Run it in this window instead: cypher connect'); },
+  stop() { console.log(SVC.stop() ? 'Cypher stopped and auto-start turned off. Run cypher start to bring it back.' : 'Nothing to stop (or the service is not installed).'); },
+  async stats() {
+    const c = load(); const r = await fetch(httpOf(c.server) + '/health').then(r => r.json()).catch(() => null);
+    console.log(`service:   ${SVC.running() ? 'running' : 'stopped'}${SVC.enabled() ? ' (starts automatically)' : ' (auto-start off)'}\ninternet/server: ${r?.ok ? 'reachable' : 'unreachable'}  ${c.server}\nlinked:    ${c.token ? 'yes, as "' + devName() + '"' : 'no (run cypher init)'}\nprojects:  ${c.projects.length}\nlog:       ${LOG}`);
+    try { const t = fs.readFileSync(LOG, 'utf8').trim().split('\n').slice(-3).join('\n'); if (t) console.log('\nrecent:\n' + t); } catch {}
+  },
+  logs() { try { console.log(fs.readFileSync(LOG, 'utf8').split('\n').slice(-40).join('\n')); } catch { console.log('no log yet'); } },
   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() {
@@ -159,10 +216,10 @@ const cmds = {
       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: announce() }); console.log(`connected as ${os.hostname()} with Root + ${readRegistry().length} project(s). Ctrl+C to stop.`); });
+      ws.on('open', () => { ws.opened = true; retry = 1000; tx({ type: 'hello', name: devName(), projects: announce() }); console.log(`connected as ${devName()} 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(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);
+      const watch = setInterval(() => { const a = announce(), n = JSON.stringify(a); if (n !== sig) { sig = n; tx({ type: 'hello', name: devName(), 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 => {
@@ -211,7 +268,9 @@ const help = () => console.log(`Project Cypher
   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 connect                      go online in this window (no background service)
+  cypher start | stop                 start / stop the background service (auto-starts at boot)
+  cypher stats | logs                 service + connection status / recent log
   cypher status | latest              server check / latest app build
 
 Config: ~/.cypher/config.json (permissionMode defaults to acceptEdits)`);

package/package.json

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