@zuzuucodes/cli 1.4.0 → 1.5.0

package/bin/zuzuu.mjs

@@ -33,6 +33,7 @@ import { web } from '../zuzuu/commands/web.mjs';
 import { explain } from '../zuzuu/commands/explain.mjs';
 import { inbox } from '../zuzuu/commands/inbox.mjs';
 import { session } from '../zuzuu/commands/session.mjs';
+import { faculty } from '../zuzuu/commands/faculty.mjs';
 
 function parseArgs(argv) {
   const a = { _: [] };
@@ -74,6 +75,10 @@ usage: zuzuu <command> [options]
   recall "query" [--type t] [--attr k=v] [--related-to id] [--semantic]
                             search knowledge: lexical · graph · semantic
   knowledge reindex|audit   rebuild the search index · check registry/items health
+  faculty items <f> [--json|--jsonl]
+                            list a faculty's envelope items (one doc · one line per item)
+  faculty schema <f> [--json]
+                            print a faculty's payload schema (JSON-Schema subset)
   digest [--json] [--budget N]
                             print the session-start grounding brief
   act [list|show <slug>|new <slug>|schema <slug>]
@@ -95,7 +100,8 @@ usage: zuzuu <command> [options]
   session [status|merge|continue|discard]
                             the invisible session branch (one per agent session)
   eval [--faculty f]        rank pending proposals by eval score, highest first
-  migrate [--home]          one-time migrators: proposal schema · --home moves agent/ → .zuzuu/
+  migrate [--home|--items]  one-time migrators: proposal schema · --home moves agent/ → .zuzuu/
+                            · --items rewrites legacy faculty shapes → the envelope standard
   doctor                    environment + session health (reconciles lost sessions)
   explain [topic]           the 5 faculties + how graduation works
   version                   print version
@@ -128,6 +134,7 @@ switch (cmd) {
   case 'disable': disable(args); break;
   case 'hook': runHook(args._[0], { host: args.host, session: args.session }); break;
   case 'session': session(args); break;
+  case 'faculty': faculty(args); break;
   case 'eval': evalCmd(args); break;
   case 'migrate': migrate(args); break;
   case 'generation': generation(args); break;

package/package.json

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

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

@@ -128,15 +128,104 @@ 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 };
+// ── Faculty Standard envelope listing ────────────────────────────────────
+// The CLI is the parser of record (`zuzuu faculty items <f> --json` returns
+// the full envelopes incl. payload/body). When it's absent we degrade to a
+// count-only frontmatter PEEK: read the items dir, lift the tiny top-level
+// scalar lines (title:/status:/kind:) best-effort — counts still render,
+// detail degrades. Never a re-implementation of the envelope grammar.
+/** Flat envelope item dirs per faculty; actions are dir-shaped (ACTION.md). */
+const ITEM_DIRS = {
+    knowledge: ["knowledge", "items"],
+    memory: ["memory", "entries"],
+    instructions: ["instructions", "items"],
+    guardrails: ["guardrails", "items"],
+};
+const PEEK_KEYS = new Set(["id", "faculty", "kind", "title", "status", "created_at", "updated_at"]);
+function unquoteScalar(s) {
+    const t = s.trim();
+    if (t.startsWith('"') && t.endsWith('"') && t.length >= 2) {
+        try {
+            return JSON.parse(t);
+        }
+        catch {
+            return t.slice(1, -1);
+        }
     }
-    catch {
-        return { count: 0, names: [] };
+    if (t.startsWith("'") && t.endsWith("'") && t.length >= 2)
+        return t.slice(1, -1);
+    return t;
+}
+/** Best-effort peek at an envelope's top-level frontmatter scalars. */
+function peekFrontmatter(text) {
+    const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!m)
+        return {};
+    const out = {};
+    for (const raw of (m[1] ?? "").split("\n")) {
+        if (/^\s/.test(raw))
+            continue; // indented = provenance/payload children
+        const kv = raw.match(/^([A-Za-z_][\w-]*):\s*(.*)$/);
+        if (kv && PEEK_KEYS.has(kv[1]))
+            out[kv[1]] = unquoteScalar(kv[2] ?? "");
     }
+    return out;
+}
+/** CLI-less fallback: degraded envelope items (no payload/body) from disk. */
+async function peekFacultyItems(agent, key) {
+    const files = [];
+    if (key === "actions") {
+        const base = path.join(agent, "actions");
+        let names = [];
+        try {
+            names = (await fsp.readdir(base)).sort();
+        }
+        catch {
+            return [];
+        }
+        for (const n of names) {
+            if (n === "inbox" || n === "proposals" || n === "_rolledback")
+                continue;
+            files.push({ id: n, file: path.join(base, n, "ACTION.md") });
+        }
+    }
+    else {
+        const rel = ITEM_DIRS[key];
+        if (!rel)
+            return [];
+        const dir = path.join(agent, ...rel);
+        let names = [];
+        try {
+            names = (await fsp.readdir(dir)).sort();
+        }
+        catch {
+            return [];
+        }
+        for (const n of names) {
+            if (!n.endsWith(".md") || n === "README.md")
+                continue;
+            files.push({ id: n.replace(/\.md$/, ""), file: path.join(dir, n) });
+        }
+    }
+    const items = [];
+    for (const { id, file } of files) {
+        let fm;
+        try {
+            fm = peekFrontmatter(await fsp.readFile(file, "utf8"));
+        }
+        catch {
+            continue;
+        }
+        items.push({ kind: "?", ...fm, id: fm.id ?? id, faculty: key, title: fm.title ?? id });
+    }
+    return items;
+}
+/** One faculty's envelope items: CLI first (full envelopes), peek fallback. */
+async function facultyEnvelopeItems(root, agent, key, binary) {
+    const viaCli = await runZuzuu(root, ["faculty", "items", key], { binary });
+    if (viaCli && Array.isArray(viaCli.items))
+        return { items: viaCli.items, errors: Array.isArray(viaCli.errors) ? viaCli.errors : [], degraded: false };
+    return { items: await peekFacultyItems(agent, key), errors: [], degraded: true };
 }
 /** Read every *.json in a dir into objects; missing dir → [], corrupt file → skipped. */
 async function readJsonDir(dir) {
@@ -163,14 +252,6 @@ function proposalTitle(p) {
     const payload = p.payload;
     return firstLine(cand?.body ?? payload?.body ?? p.id);
 }
-/** The conventional item dir for a faculty, or null (heterogeneous faculties → counted as 0 for the MVP). */
-function itemsDirOf(agent, key) {
-    if (key === "knowledge")
-        return path.join(agent, "knowledge", "items");
-    if (key === "memory")
-        return path.join(agent, "memory", "entries");
-    return null;
-}
 export function createZuzuuApi(getRoot, opts = {}) {
     const app = new Hono();
     let root = getRoot();
@@ -188,13 +269,13 @@ export function createZuzuuApi(getRoot, opts = {}) {
     });
     app.get("/faculties", async (c) => {
         const agent = await agentDir();
-        const faculties = [];
-        for (const key of FACULTIES) {
-            const itemsDir = itemsDirOf(agent, key);
-            const count = itemsDir ? (await countItemFiles(itemsDir)).count : 0;
-            const pending = (await proposalsOf(agent, key)).length;
-            faculties.push({ key, count, pending });
-        }
+        const faculties = await Promise.all(FACULTIES.map(async (key) => {
+            const [{ items }, proposals] = await Promise.all([
+                facultyEnvelopeItems(root, agent, key, opts.binary),
+                proposalsOf(agent, key),
+            ]);
+            return { key, count: items.length, pending: proposals.length };
+        }));
         return c.json({ faculties });
     });
     app.get("/faculty/:key", async (c) => {
@@ -202,12 +283,26 @@ export function createZuzuuApi(getRoot, opts = {}) {
         if (!FACULTIES.includes(key))
             return c.json({ error: "unknown faculty" }, 404);
         const agent = await agentDir();
-        const itemsDir = itemsDirOf(agent, key);
-        const items = itemsDir
-            ? (await countItemFiles(itemsDir)).names.map((n) => ({ id: n.replace(/\.(json|md)$/, ""), title: n.replace(/\.(json|md)$/, "") }))
-            : [];
+        const { items, errors, degraded } = await facultyEnvelopeItems(root, agent, key, opts.binary);
         const proposals = (await proposalsOf(agent, key)).map((p) => ({ id: String(p.id ?? "?"), faculty: key, title: proposalTitle(p) }));
-        return c.json({ key, items, proposals });
+        return c.json({ key, items, proposals, errors, ...(degraded ? { degraded: true } : {}) });
+    });
+    app.get("/faculty/:key/schema", async (c) => {
+        const key = c.req.param("key");
+        if (!FACULTIES.includes(key))
+            return c.json({ error: "unknown faculty" }, 404);
+        const viaCli = await runZuzuu(root, ["faculty", "schema", key], { binary: opts.binary });
+        if (viaCli)
+            return c.json({ key, schema: viaCli, source: "cli" });
+        // CLI absent → the seeded payload schema in the home (zuzuu init writes it)
+        const agent = await agentDir();
+        try {
+            const schema = JSON.parse(await fsp.readFile(path.join(agent, key, "schema.json"), "utf8"));
+            return c.json({ key, schema, source: "home" });
+        }
+        catch {
+            return c.json({ key, schema: null, source: "absent" });
+        }
     });
     app.get("/generations", async (c) => {
         const agent = await agentDir();

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

@@ -1 +1 @@
-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};
+import{d as e,f as t,u as n}from"./index-DHpC851f.js";import{i as r,n as i,t as a}from"./monaco-setup-wbBeb0oN.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-CL3DhFKG.js → MonacoFile-CqbVacUZ.js}

@@ -1 +1 @@
-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};
+import{f as e,l as t}from"./index-DHpC851f.js";import{n,r,t as i}from"./monaco-setup-wbBeb0oN.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-B9jnrWOz.js → cssMode-Dx3ub8Pk.js}

@@ -1 +1 @@
-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};
+import{h as e}from"./editor.api2-BmGoRSl4.js";import{o as t}from"./monaco-setup-wbBeb0oN.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};