@zuzuucodes/cli 1.3.0 → 1.4.0

package/bin/zuzuu.mjs

@@ -61,7 +61,9 @@ function help() {
 usage: zuzuu <command> [options]
 
   code [dir]                launch OpenCode as the bundled default host (faculty home + capture + gate + digest)
-  web [dir]                 launch the visual workbench (installs @zuzuucodes/web on demand)
+  web [dir] [--stop|--status]
+                            launch the visual workbench (reuses a running one;
+                            --stop ends it, --status reports it)
   init                      scaffold the faculty home (.zuzuu/) — git-style, idempotent
   status                    detected hosts + recorded sessions
   capture [--host NAME]     capture a session → .zuzuu/.traces + .zuzuu/sessions.json
@@ -108,7 +110,7 @@ const args = parseArgs(rest);
 
 switch (cmd) {
   case 'code': process.exit(code(args)); break;
-  case 'web': web(args); break;
+  case 'web': await web(args); break;
   case 'init': init(args); break;
   case 'remember': remember(args); break;
   case 'recall': await recall(args); break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zuzuucodes/cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "private": false,
   "publishConfig": {
     "access": "public"

package/web-app/dist/index.js

@@ -7,6 +7,7 @@ import { fileURLToPath } from "node:url";
 import crypto from "node:crypto";
 import { WebcodeServer } from "./server.js";
 import { addRecent } from "./config.js";
+import { writeInstanceFile, removeInstanceFile } from "./instance-file.js";
 const HERE = path.dirname(fileURLToPath(import.meta.url));
 const DEFAULT_PORT = 7770;
 function parseArgs(argv) {
@@ -147,14 +148,32 @@ async function main() {
         console.log(`\n  zuzuu-web v${pkg.version}`);
         console.log(`  workspace  ${root}`);
         console.log(`  url        ${url}\n`);
+        // Singleton contract: record this instance so `zuzuu web` can reuse it
+        // instead of spawning a duplicate (never in hosted mode; never fatal).
+        if (!hosted) {
+            writeInstanceFile({
+                root,
+                port: boundPort,
+                pid: process.pid,
+                token,
+                startedAt: new Date().toISOString(),
+                version: pkg.version,
+            });
+        }
         if (args.open)
             openBrowser(url);
     });
     const shutdown = () => {
+        if (!hosted)
+            removeInstanceFile(root);
         server.stop();
         process.exit(0);
     };
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);
+    process.on("exit", () => {
+        if (!hosted)
+            removeInstanceFile(root); // best-effort; idempotent after shutdown()
+    });
 }
 void main();

package/web-app/dist/instance-file.js

@@ -0,0 +1,62 @@
+// Per-workspace daemon instance state — the singleton contract with `zuzuu web`.
+//
+// After a successful listen the daemon writes
+//   ~/.webcode/instances/<sha256(realpath-root).slice(0,16)>.json
+// and removes it on clean shutdown. The zuzuu CLI computes the same path for a
+// workspace to discover (and reuse / stop) an already-running daemon instead of
+// spawning a fresh one — so the port + token stay stable across `zuzuu web` runs.
+//
+// Security note: the file contains the auth token. That's acceptable here —
+// it's 0600 in the user's own home directory, and the same token already
+// appears in the daemon's own stdout URL. Hosted mode never writes this file.
+import crypto from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export function instancesDir() {
+    return path.join(os.homedir(), ".webcode", "instances");
+}
+/** Deterministic per-workspace file path. `root` must already be realpath'd. */
+export function instancePath(root, dir = instancesDir()) {
+    const id = crypto.createHash("sha256").update(root).digest("hex").slice(0, 16);
+    return path.join(dir, `${id}.json`);
+}
+/** Write the instance file (0600). Never throws — a failed write only costs reuse. */
+export function writeInstanceFile(info, dir = instancesDir()) {
+    const file = instancePath(info.root, dir);
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(file, JSON.stringify(info, null, 2) + "\n", { mode: 0o600 });
+        fs.chmodSync(file, 0o600); // mode option only applies on create; enforce on overwrite too
+        return file;
+    }
+    catch (err) {
+        console.warn(`zuzuu-web: could not write instance state (${String(err)}) — continuing without it`);
+        return null;
+    }
+}
+/** Best-effort read; null on missing/corrupt. */
+export function readInstanceFile(root, dir = instancesDir()) {
+    try {
+        return JSON.parse(fs.readFileSync(instancePath(root, dir), "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Best-effort removal on shutdown. Only removes the file if it still belongs
+ * to `pid` — if another daemon raced us and overwrote it, leave theirs alone.
+ */
+export function removeInstanceFile(root, pid = process.pid, dir = instancesDir()) {
+    const file = instancePath(root, dir);
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
+        if (typeof parsed.pid === "number" && parsed.pid !== pid)
+            return; // not ours anymore
+        fs.unlinkSync(file);
+    }
+    catch {
+        /* already gone or unreadable — nothing to do */
+    }
+}

package/web-app/dist/zuzuu-api.js

@@ -128,6 +128,16 @@ function binAvailable(binary) {
         return false;
     }
 }
+/** Count item FILES in a faculty dir — knowledge items are .md, others .json/.md. */
+async function countItemFiles(dir) {
+    try {
+        const names = (await fsp.readdir(dir)).filter((n) => n.endsWith(".json") || n.endsWith(".md"));
+        return { count: names.length, names };
+    }
+    catch {
+        return { count: 0, names: [] };
+    }
+}
 /** Read every *.json in a dir into objects; missing dir → [], corrupt file → skipped. */
 async function readJsonDir(dir) {
     let names = [];
@@ -181,7 +191,7 @@ export function createZuzuuApi(getRoot, opts = {}) {
         const faculties = [];
         for (const key of FACULTIES) {
             const itemsDir = itemsDirOf(agent, key);
-            const count = itemsDir ? (await readJsonDir(itemsDir)).length : 0;
+            const count = itemsDir ? (await countItemFiles(itemsDir)).count : 0;
             const pending = (await proposalsOf(agent, key)).length;
             faculties.push({ key, count, pending });
         }
@@ -194,7 +204,7 @@ export function createZuzuuApi(getRoot, opts = {}) {
         const agent = await agentDir();
         const itemsDir = itemsDirOf(agent, key);
         const items = itemsDir
-            ? (await readJsonDir(itemsDir)).map((it) => ({ id: String(it.id ?? "?"), title: firstLine(it.body ?? it.id) }))
+            ? (await countItemFiles(itemsDir)).names.map((n) => ({ id: n.replace(/\.(json|md)$/, ""), title: n.replace(/\.(json|md)$/, "") }))
             : [];
         const proposals = (await proposalsOf(agent, key)).map((p) => ({ id: String(p.id ?? "?"), faculty: key, title: proposalTitle(p) }));
         return c.json({ key, items, proposals });

package/web-app/web-dist/assets/{DiffTab-CihRJjzf.js → DiffTab-BuWonUNJ.js}

@@ -1 +1 @@
-import{d as e,f as t,u as n}from"./index-Ye54YyTn.js";import{i as r,n as i,t as a}from"./monaco-setup-Dszx738Y.js";var o=t();function s({path:t,name:s}){let{data:l,isLoading:u,error:d}=e({queryKey:[`git`,`diff`,t],queryFn:async()=>{let[e,r]=await Promise.all([n.gitDiff(t),n.readFile(t).catch(()=>``)]);return{original:e.original,working:r}}});return d?(0,o.jsx)(c,{danger:!0,children:d.message}):u||!l?(0,o.jsx)(c,{children:`loading diff…`}):(0,o.jsx)(r,{original:l.original,modified:l.working,language:i(s),theme:a(),options:{readOnly:!0,renderSideBySide:!0,fontFamily:`"JetBrains Mono Variable", ui-monospace, monospace`,fontSize:13,minimap:{enabled:!1},automaticLayout:!0}})}function c({children:e,danger:t}){return(0,o.jsx)(`div`,{className:`flex h-full items-center justify-center text-ui ${t?`text-danger`:`text-ink-500`}`,children:e})}export{s as DiffTab,s as default};
+import{d as e,f as t,u as n}from"./index--5yy8RbA.js";import{i as r,n as i,t as a}from"./monaco-setup-CsR6EfHe.js";var o=t();function s({path:t,name:s}){let{data:l,isLoading:u,error:d}=e({queryKey:[`git`,`diff`,t],queryFn:async()=>{let[e,r]=await Promise.all([n.gitDiff(t),n.readFile(t).catch(()=>``)]);return{original:e.original,working:r}}});return d?(0,o.jsx)(c,{danger:!0,children:d.message}):u||!l?(0,o.jsx)(c,{children:`loading diff…`}):(0,o.jsx)(r,{original:l.original,modified:l.working,language:i(s),theme:a(),options:{readOnly:!0,renderSideBySide:!0,fontFamily:`"JetBrains Mono Variable", ui-monospace, monospace`,fontSize:13,minimap:{enabled:!1},automaticLayout:!0}})}function c({children:e,danger:t}){return(0,o.jsx)(`div`,{className:`flex h-full items-center justify-center text-ui ${t?`text-danger`:`text-ink-500`}`,children:e})}export{s as DiffTab,s as default};

package/web-app/web-dist/assets/{MonacoFile-DJvpGyW2.js → MonacoFile-CL3DhFKG.js}

@@ -1 +1 @@
-import{f as e,l as t}from"./index-Ye54YyTn.js";import{n,r,t as i}from"./monaco-setup-Dszx738Y.js";var a=e();function o({path:e,name:o}){let c=t(t=>t.buffers[e]),l=t(e=>e.setValue),u=t(e=>e.save);return!c||c.loading?(0,a.jsx)(s,{children:`loading…`}):c.error?(0,a.jsx)(s,{danger:!0,children:c.error}):(0,a.jsx)(r,{path:e,language:n(o),theme:i(),value:c.value,onChange:t=>l(e,t??``),onMount:(t,n)=>{t.addCommand(n.KeyMod.CtrlCmd|n.KeyCode.KeyS,()=>{u(e)})},options:{fontFamily:`"JetBrains Mono Variable", ui-monospace, monospace`,fontSize:13,lineHeight:1.5,minimap:{enabled:!0,scale:1},scrollBeyondLastLine:!1,smoothScrolling:!0,renderWhitespace:`selection`,tabSize:2,automaticLayout:!0,padding:{top:8}}})}function s({children:e,danger:t}){return(0,a.jsx)(`div`,{className:`flex h-full items-center justify-center text-ui ${t?`text-danger`:`text-ink-500`}`,children:e})}export{o as MonacoFile,o as default};
+import{f as e,l as t}from"./index--5yy8RbA.js";import{n,r,t as i}from"./monaco-setup-CsR6EfHe.js";var a=e();function o({path:e,name:o}){let c=t(t=>t.buffers[e]),l=t(e=>e.setValue),u=t(e=>e.save);return!c||c.loading?(0,a.jsx)(s,{children:`loading…`}):c.error?(0,a.jsx)(s,{danger:!0,children:c.error}):(0,a.jsx)(r,{path:e,language:n(o),theme:i(),value:c.value,onChange:t=>l(e,t??``),onMount:(t,n)=>{t.addCommand(n.KeyMod.CtrlCmd|n.KeyCode.KeyS,()=>{u(e)})},options:{fontFamily:`"JetBrains Mono Variable", ui-monospace, monospace`,fontSize:13,lineHeight:1.5,minimap:{enabled:!0,scale:1},scrollBeyondLastLine:!1,smoothScrolling:!0,renderWhitespace:`selection`,tabSize:2,automaticLayout:!0,padding:{top:8}}})}function s({children:e,danger:t}){return(0,a.jsx)(`div`,{className:`flex h-full items-center justify-center text-ui ${t?`text-danger`:`text-ink-500`}`,children:e})}export{o as MonacoFile,o as default};

package/web-app/web-dist/assets/{cssMode-R1Bks9TO.js → cssMode-B9jnrWOz.js}

@@ -1 +1 @@
-import{h as e}from"./editor.api2-BmGoRSl4.js";import{o as t}from"./monaco-setup-Dszx738Y.js";import{_ as n,a as r,c as i,d as a,f as o,g as s,h as c,i as l,l as u,m as d,n as f,o as p,p as m,r as h,s as g,t as _,u as v,v as y}from"./lspLanguageFeatures-gTnJsses.js";var b=120*1e3,x=class{constructor(e){this._defaults=e,this._worker=null,this._client=null,this._idleCheckInterval=window.setInterval(()=>this._checkIfIdle(),30*1e3),this._lastUsedTime=0,this._configChangeListener=this._defaults.onDidChange(()=>this._stopWorker())}_stopWorker(){this._worker&&=(this._worker.dispose(),null),this._client=null}dispose(){clearInterval(this._idleCheckInterval),this._configChangeListener.dispose(),this._stopWorker()}_checkIfIdle(){this._worker&&Date.now()-this._lastUsedTime>b&&this._stopWorker()}_getClient(){return this._lastUsedTime=Date.now(),this._client||=(this._worker=t({moduleId:`vs/language/css/cssWorker`,createWorker:()=>new Worker(new URL(`/assets/css.worker-CvXBzhp8.js`,``+import.meta.url),{type:`module`}),label:this._defaults.languageId,createData:{options:this._defaults.options,languageId:this._defaults.languageId}}),this._worker.getProxy()),this._client}getLanguageServiceWorker(...e){let t;return this._getClient().then(e=>{t=e}).then(t=>{if(this._worker)return this._worker.withSyncedResources(e)}).then(e=>t)}};function S(t){let n=[],s=[],c=new x(t);n.push(c);let g=(...e)=>c.getLanguageServiceWorker(...e);function y(){let{languageId:n,modeConfiguration:c}=t;w(s),c.completionItems&&s.push(e.registerCompletionItemProvider(n,new _(g,[`/`,`-`,`:`]))),c.hovers&&s.push(e.registerHoverProvider(n,new a(g))),c.documentHighlights&&s.push(e.registerDocumentHighlightProvider(n,new p(g))),c.definitions&&s.push(e.registerDefinitionProvider(n,new f(g))),c.references&&s.push(e.registerReferenceProvider(n,new o(g))),c.documentSymbols&&s.push(e.registerDocumentSymbolProvider(n,new u(g))),c.rename&&s.push(e.registerRenameProvider(n,new m(g))),c.colors&&s.push(e.registerColorProvider(n,new l(g))),c.foldingRanges&&s.push(e.registerFoldingRangeProvider(n,new v(g))),c.diagnostics&&s.push(new h(n,g,t.onDidChange)),c.selectionRanges&&s.push(e.registerSelectionRangeProvider(n,new d(g))),c.documentFormattingEdits&&s.push(e.registerDocumentFormattingEditProvider(n,new r(g))),c.documentRangeFormattingEdits&&s.push(e.registerDocumentRangeFormattingEditProvider(n,new i(g)))}return y(),n.push(C(s)),C(n)}function C(e){return{dispose:()=>w(e)}}function w(e){for(;e.length;)e.pop().dispose()}export{_ as CompletionAdapter,f as DefinitionAdapter,h as DiagnosticsAdapter,l as DocumentColorAdapter,r as DocumentFormattingEditProvider,p as DocumentHighlightAdapter,g as DocumentLinkAdapter,i as DocumentRangeFormattingEditProvider,u as DocumentSymbolAdapter,v as FoldingRangeAdapter,a as HoverAdapter,o as ReferenceAdapter,m as RenameAdapter,d as SelectionRangeAdapter,x as WorkerManager,c as fromPosition,s as fromRange,S as setupMode,n as toRange,y as toTextEdit};
+import{h as e}from"./editor.api2-BmGoRSl4.js";import{o as t}from"./monaco-setup-CsR6EfHe.js";import{_ as n,a as r,c as i,d as a,f as o,g as s,h as c,i as l,l as u,m as d,n as f,o as p,p as m,r as h,s as g,t as _,u as v,v as y}from"./lspLanguageFeatures-gTnJsses.js";var b=120*1e3,x=class{constructor(e){this._defaults=e,this._worker=null,this._client=null,this._idleCheckInterval=window.setInterval(()=>this._checkIfIdle(),30*1e3),this._lastUsedTime=0,this._configChangeListener=this._defaults.onDidChange(()=>this._stopWorker())}_stopWorker(){this._worker&&=(this._worker.dispose(),null),this._client=null}dispose(){clearInterval(this._idleCheckInterval),this._configChangeListener.dispose(),this._stopWorker()}_checkIfIdle(){this._worker&&Date.now()-this._lastUsedTime>b&&this._stopWorker()}_getClient(){return this._lastUsedTime=Date.now(),this._client||=(this._worker=t({moduleId:`vs/language/css/cssWorker`,createWorker:()=>new Worker(new URL(`/assets/css.worker-CvXBzhp8.js`,``+import.meta.url),{type:`module`}),label:this._defaults.languageId,createData:{options:this._defaults.options,languageId:this._defaults.languageId}}),this._worker.getProxy()),this._client}getLanguageServiceWorker(...e){let t;return this._getClient().then(e=>{t=e}).then(t=>{if(this._worker)return this._worker.withSyncedResources(e)}).then(e=>t)}};function S(t){let n=[],s=[],c=new x(t);n.push(c);let g=(...e)=>c.getLanguageServiceWorker(...e);function y(){let{languageId:n,modeConfiguration:c}=t;w(s),c.completionItems&&s.push(e.registerCompletionItemProvider(n,new _(g,[`/`,`-`,`:`]))),c.hovers&&s.push(e.registerHoverProvider(n,new a(g))),c.documentHighlights&&s.push(e.registerDocumentHighlightProvider(n,new p(g))),c.definitions&&s.push(e.registerDefinitionProvider(n,new f(g))),c.references&&s.push(e.registerReferenceProvider(n,new o(g))),c.documentSymbols&&s.push(e.registerDocumentSymbolProvider(n,new u(g))),c.rename&&s.push(e.registerRenameProvider(n,new m(g))),c.colors&&s.push(e.registerColorProvider(n,new l(g))),c.foldingRanges&&s.push(e.registerFoldingRangeProvider(n,new v(g))),c.diagnostics&&s.push(new h(n,g,t.onDidChange)),c.selectionRanges&&s.push(e.registerSelectionRangeProvider(n,new d(g))),c.documentFormattingEdits&&s.push(e.registerDocumentFormattingEditProvider(n,new r(g))),c.documentRangeFormattingEdits&&s.push(e.registerDocumentRangeFormattingEditProvider(n,new i(g)))}return y(),n.push(C(s)),C(n)}function C(e){return{dispose:()=>w(e)}}function w(e){for(;e.length;)e.pop().dispose()}export{_ as CompletionAdapter,f as DefinitionAdapter,h as DiagnosticsAdapter,l as DocumentColorAdapter,r as DocumentFormattingEditProvider,p as DocumentHighlightAdapter,g as DocumentLinkAdapter,i as DocumentRangeFormattingEditProvider,u as DocumentSymbolAdapter,v as FoldingRangeAdapter,a as HoverAdapter,o as ReferenceAdapter,m as RenameAdapter,d as SelectionRangeAdapter,x as WorkerManager,c as fromPosition,s as fromRange,S as setupMode,n as toRange,y as toTextEdit};