project-cypher 0.11.0 → 0.13.0

package/bin/cypher.js

@@ -52,6 +52,52 @@ const httpOf = s => s.replace(/\/$/, ''), wsOf = s => httpOf(s).replace(/^http/,
 
 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) {
@@ -76,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) {
@@ -109,8 +155,8 @@ 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(); },
@@ -148,8 +194,27 @@ const cmds = {
     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) { writeRegistry(readRegistry().filter(x => x.id !== id)); console.log('removed ' + id); },
+  async remove(id, ...rest) {
+    if (id && id !== '--yes') { writeRegistry(readRegistry().filter(x => x.id !== id)); return console.log('removed project ' + id); }
+    console.log(`This fully removes Cypher from this computer:\n  - unlinks it from your phone app\n  - stops and deletes the background service\n  - deletes ${CFG_DIR} (login, project list, Root notes, chat sessions)\nYour actual project folders are NOT touched.`);
+    if (id !== '--yes' && !rest.includes('--yes') && !yes(await ask('Continue? [y/N] '), false)) return console.log('cancelled.');
+    const c = rawCfg();
+    if (c.token) await fetch(httpOf(c.server || 'http://140.238.248.30:3300') + '/unlink', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ token: c.token }) }).then(() => console.log('[ok] unlinked from the app')).catch(() => console.log('[!!] could not reach the server; remove this computer from the app Projects list'));
+    SVC.remove(); console.log('[ok] background service removed');
+    fs.rmSync(CFG_DIR, { recursive: true, force: true }); console.log('[ok] deleted ' + CFG_DIR);
+    console.log('\nClean. To reinstall: npm i -g project-cypher@latest && cypher init\nTo also remove the program itself: npm uninstall -g project-cypher');
+  },
+  removeProject(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() {
@@ -211,9 +276,12 @@ const help = () => console.log(`Project Cypher
   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]                 register a project folder (or just ask Root in the app)
-  cypher projects | remove <id>       list / remove projects
+  cypher projects | remove <id>       list projects / remove one project
+  cypher remove                       FULL removal (unlink, service, all local data) for a clean reinstall
   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.11.0",
+  "version": "0.13.0",
   "description": "Connect your machine's Claude Code projects to the Project Cypher phone app.",
   "bin": {
     "cypher": "bin/cypher.js"