@zuzuucodes/cli 1.5.0 → 1.6.0

package/web-app/web-dist/assets/yaml-CwRYMJka.js

@@ -1 +0,0 @@
-import{n as e}from"./chunk-QTnfLwEv.js";var t=e({default:()=>n}),n=[Object.freeze(JSON.parse(`{"displayName":"YAML","fileTypes":["yaml","yml","rviz","reek","clang-format","yaml-tmlanguage","syntax","sublime-syntax"],"firstLineMatch":"^%YAML( ?1.\\\\d+)?","name":"yaml","patterns":[{"include":"#comment"},{"include":"#property"},{"include":"#directive"},{"match":"^---","name":"entity.other.document.begin.yaml"},{"match":"^\\\\.{3}","name":"entity.other.document.end.yaml"},{"include":"#node"}],"repository":{"block-collection":{"patterns":[{"include":"#block-sequence"},{"include":"#block-mapping"}]},"block-mapping":{"patterns":[{"include":"#block-pair"}]},"block-node":{"patterns":[{"include":"#prototype"},{"include":"#block-scalar"},{"include":"#block-collection"},{"include":"#flow-scalar-plain-out"},{"include":"#flow-node"}]},"block-pair":{"patterns":[{"begin":"\\\\?","beginCaptures":{"1":{"name":"punctuation.definition.key-value.begin.yaml"}},"end":"(?=\\\\?)|^ *(:)|(:)","endCaptures":{"1":{"name":"punctuation.separator.key-value.mapping.yaml"},"2":{"name":"invalid.illegal.expected-newline.yaml"}},"name":"meta.block-mapping.yaml","patterns":[{"include":"#block-node"}]},{"begin":"(?=(?:[^-\\\\]!\\"#%\\\\&'*,:>?@\\\\[\`{|}\\\\s]|[-:?]\\\\S)([^:\\\\s]|:\\\\S|\\\\s+(?![#\\\\s]))*\\\\s*:(\\\\s|$))","end":"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$))","patterns":[{"include":"#flow-scalar-plain-out-implicit-type"},{"begin":"[^-\\\\]!\\"#%\\\\&'*,:>?@\\\\[\`{|}\\\\s]|[-:?]\\\\S","beginCaptures":{"0":{"name":"entity.name.tag.yaml"}},"contentName":"entity.name.tag.yaml","end":"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$))","name":"string.unquoted.plain.out.yaml"}]},{"match":":(?=\\\\s|$)","name":"punctuation.separator.key-value.mapping.yaml"}]},"block-scalar":{"begin":"(?:(\\\\|)|(>))([1-9])?([-+])?(.*\\\\n?)","beginCaptures":{"1":{"name":"keyword.control.flow.block-scalar.literal.yaml"},"2":{"name":"keyword.control.flow.block-scalar.folded.yaml"},"3":{"name":"constant.numeric.indentation-indicator.yaml"},"4":{"name":"storage.modifier.chomping-indicator.yaml"},"5":{"patterns":[{"include":"#comment"},{"match":".+","name":"invalid.illegal.expected-comment-or-newline.yaml"}]}},"end":"^(?=\\\\S)|(?!\\\\G)","patterns":[{"begin":"^( +)(?! )","end":"^(?!\\\\1|\\\\s*$)","name":"string.unquoted.block.yaml"}]},"block-sequence":{"match":"(-)(?!\\\\S)","name":"punctuation.definition.block.sequence.item.yaml"},"comment":{"begin":"(?:^([\\\\t ]*)|[\\\\t ]+)(?=#\\\\p{print}*$)","beginCaptures":{"1":{"name":"punctuation.whitespace.comment.leading.yaml"}},"end":"(?!\\\\G)","patterns":[{"begin":"#","beginCaptures":{"0":{"name":"punctuation.definition.comment.yaml"}},"end":"\\\\n","name":"comment.line.number-sign.yaml"}]},"directive":{"begin":"^%","beginCaptures":{"0":{"name":"punctuation.definition.directive.begin.yaml"}},"end":"(?=$|[\\\\t ]+($|#))","name":"meta.directive.yaml","patterns":[{"captures":{"1":{"name":"keyword.other.directive.yaml.yaml"},"2":{"name":"constant.numeric.yaml-version.yaml"}},"match":"\\\\G(YAML)[\\\\t ]+(\\\\d+\\\\.\\\\d+)"},{"captures":{"1":{"name":"keyword.other.directive.tag.yaml"},"2":{"name":"storage.type.tag-handle.yaml"},"3":{"name":"support.type.tag-prefix.yaml"}},"match":"\\\\G(TAG)(?:[\\\\t ]+(!(?:[-0-9A-Za-z]*!)?)(?:[\\\\t ]+(!(?:%\\\\h{2}|[]!#$\\\\&-;=?-\\\\[_a-z~])*|(?![]!,\\\\[{}])(?:%\\\\h{2}|[]!#$\\\\&-;=?-\\\\[_a-z~])+))?)?"},{"captures":{"1":{"name":"support.other.directive.reserved.yaml"},"2":{"name":"string.unquoted.directive-name.yaml"},"3":{"name":"string.unquoted.directive-parameter.yaml"}},"match":"\\\\G(\\\\w+)(?:[\\\\t ]+(\\\\w+)(?:[\\\\t ]+(\\\\w+))?)?"},{"match":"\\\\S+","name":"invalid.illegal.unrecognized.yaml"}]},"flow-alias":{"captures":{"1":{"name":"keyword.control.flow.alias.yaml"},"2":{"name":"punctuation.definition.alias.yaml"},"3":{"name":"variable.other.alias.yaml"},"4":{"name":"invalid.illegal.character.anchor.yaml"}},"match":"((\\\\*))([^],/\\\\[{}\\\\s]+)([^],}\\\\s]\\\\S*)?"},"flow-collection":{"patterns":[{"include":"#flow-sequence"},{"include":"#flow-mapping"}]},"flow-mapping":{"begin":"\\\\{","beginCaptures":{"0":{"name":"punctuation.definition.mapping.begin.yaml"}},"end":"}","endCaptures":{"0":{"name":"punctuation.definition.mapping.end.yaml"}},"name":"meta.flow-mapping.yaml","patterns":[{"include":"#prototype"},{"match":",","name":"punctuation.separator.mapping.yaml"},{"include":"#flow-pair"}]},"flow-node":{"patterns":[{"include":"#prototype"},{"include":"#flow-alias"},{"include":"#flow-collection"},{"include":"#flow-scalar"}]},"flow-pair":{"patterns":[{"begin":"\\\\?","beginCaptures":{"0":{"name":"punctuation.definition.key-value.begin.yaml"}},"end":"(?=[],}])","name":"meta.flow-pair.explicit.yaml","patterns":[{"include":"#prototype"},{"include":"#flow-pair"},{"include":"#flow-node"},{"begin":":(?=\\\\s|$|[],\\\\[{}])","beginCaptures":{"0":{"name":"punctuation.separator.key-value.mapping.yaml"}},"end":"(?=[],}])","patterns":[{"include":"#flow-value"}]}]},{"begin":"(?=(?:[^-\\\\]!\\"#%\\\\&'*,:>?@\\\\[\`{|}\\\\s]|[-:?][^],\\\\[{}\\\\s])([^],:\\\\[{}\\\\s]|:[^],\\\\[{}\\\\s]|\\\\s+(?![#\\\\s]))*\\\\s*:(\\\\s|$))","end":"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$)|\\\\s*:[],\\\\[{}]|\\\\s*[],\\\\[{}])","name":"meta.flow-pair.key.yaml","patterns":[{"include":"#flow-scalar-plain-in-implicit-type"},{"begin":"[^-\\\\]!\\"#%\\\\&'*,:>?@\\\\[\`{|}\\\\s]|[-:?][^],\\\\[{}\\\\s]","beginCaptures":{"0":{"name":"entity.name.tag.yaml"}},"contentName":"entity.name.tag.yaml","end":"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$)|\\\\s*:[],\\\\[{}]|\\\\s*[],\\\\[{}])","name":"string.unquoted.plain.in.yaml"}]},{"include":"#flow-node"},{"begin":":(?=\\\\s|$|[],\\\\[{}])","captures":{"0":{"name":"punctuation.separator.key-value.mapping.yaml"}},"end":"(?=[],}])","name":"meta.flow-pair.yaml","patterns":[{"include":"#flow-value"}]}]},"flow-scalar":{"patterns":[{"include":"#flow-scalar-double-quoted"},{"include":"#flow-scalar-single-quoted"},{"include":"#flow-scalar-plain-in"}]},"flow-scalar-double-quoted":{"begin":"\\"","beginCaptures":{"0":{"name":"punctuation.definition.string.begin.yaml"}},"end":"\\"","endCaptures":{"0":{"name":"punctuation.definition.string.end.yaml"}},"name":"string.quoted.double.yaml","patterns":[{"match":"\\\\\\\\([ \\"/0LN\\\\\\\\_abefnprtv]|x\\\\d\\\\d|u\\\\d{4}|U\\\\d{8})","name":"constant.character.escape.yaml"},{"match":"\\\\\\\\\\\\n","name":"constant.character.escape.double-quoted.newline.yaml"}]},"flow-scalar-plain-in":{"patterns":[{"include":"#flow-scalar-plain-in-implicit-type"},{"begin":"[^-\\\\]!\\"#%\\\\&'*,:>?@\\\\[\`{|}\\\\s]|[-:?][^],\\\\[{}\\\\s]","end":"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$)|\\\\s*:[],\\\\[{}]|\\\\s*[],\\\\[{}])","name":"string.unquoted.plain.in.yaml"}]},"flow-scalar-plain-in-implicit-type":{"patterns":[{"captures":{"1":{"name":"constant.language.null.yaml"},"2":{"name":"constant.language.boolean.yaml"},"3":{"name":"constant.numeric.integer.yaml"},"4":{"name":"constant.numeric.float.yaml"},"5":{"name":"constant.other.timestamp.yaml"},"6":{"name":"constant.language.value.yaml"},"7":{"name":"constant.language.merge.yaml"}},"match":"(?:(null|Null|NULL|~)|([Yy]|yes|Yes|YES|[Nn]|no|No|NO|true|True|TRUE|false|False|FALSE|on|On|ON|off|Off|OFF)|([-+]?0b[01_]+|[-+]?0[0-7_]+|[-+]?(?:0|[1-9][0-9_]*)|[-+]?0x[_\\\\h]+|[-+]?[1-9][0-9_]*(?::[0-5]?[0-9])+)|([-+]?(?:[0-9][0-9_]*)?\\\\.[.0-9]*(?:[Ee][-+][0-9]+)?|[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\\\\.[0-9_]*|[-+]?\\\\.(?:inf|Inf|INF)|\\\\.(?:nan|NaN|NAN))|(\\\\d{4}-\\\\d{2}-\\\\d{2}|\\\\d{4}-\\\\d{1,2}-\\\\d{1,2}(?:[Tt]|[\\\\t ]+)\\\\d{1,2}:\\\\d{2}:\\\\d{2}(?:\\\\.\\\\d*)?(?:[\\\\t ]*Z|[-+]\\\\d{1,2}(?::\\\\d{1,2})?)?)|(=)|(<<))(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$)|\\\\s*:[],\\\\[{}]|\\\\s*[],\\\\[{}])"}]},"flow-scalar-plain-out":{"patterns":[{"include":"#flow-scalar-plain-out-implicit-type"},{"begin":"[^-\\\\]!\\"#%\\\\&'*,:>?@\\\\[\`{|}\\\\s]|[-:?]\\\\S","end":"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$))","name":"string.unquoted.plain.out.yaml"}]},"flow-scalar-plain-out-implicit-type":{"patterns":[{"captures":{"1":{"name":"constant.language.null.yaml"},"2":{"name":"constant.language.boolean.yaml"},"3":{"name":"constant.numeric.integer.yaml"},"4":{"name":"constant.numeric.float.yaml"},"5":{"name":"constant.other.timestamp.yaml"},"6":{"name":"constant.language.value.yaml"},"7":{"name":"constant.language.merge.yaml"}},"match":"(?:(null|Null|NULL|~)|([Yy]|yes|Yes|YES|[Nn]|no|No|NO|true|True|TRUE|false|False|FALSE|on|On|ON|off|Off|OFF)|([-+]?0b[01_]+|[-+]?0[0-7_]+|[-+]?(?:0|[1-9][0-9_]*)|[-+]?0x[_\\\\h]+|[-+]?[1-9][0-9_]*(?::[0-5]?[0-9])+)|([-+]?(?:[0-9][0-9_]*)?\\\\.[.0-9]*(?:[Ee][-+][0-9]+)?|[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\\\\.[0-9_]*|[-+]?\\\\.(?:inf|Inf|INF)|\\\\.(?:nan|NaN|NAN))|(\\\\d{4}-\\\\d{2}-\\\\d{2}|\\\\d{4}-\\\\d{1,2}-\\\\d{1,2}(?:[Tt]|[\\\\t ]+)\\\\d{1,2}:\\\\d{2}:\\\\d{2}(?:\\\\.\\\\d*)?(?:[\\\\t ]*Z|[-+]\\\\d{1,2}(?::\\\\d{1,2})?)?)|(=)|(<<))(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$))"}]},"flow-scalar-single-quoted":{"begin":"'","beginCaptures":{"0":{"name":"punctuation.definition.string.begin.yaml"}},"end":"'(?!')","endCaptures":{"0":{"name":"punctuation.definition.string.end.yaml"}},"name":"string.quoted.single.yaml","patterns":[{"match":"''","name":"constant.character.escape.single-quoted.yaml"}]},"flow-sequence":{"begin":"\\\\[","beginCaptures":{"0":{"name":"punctuation.definition.sequence.begin.yaml"}},"end":"]","endCaptures":{"0":{"name":"punctuation.definition.sequence.end.yaml"}},"name":"meta.flow-sequence.yaml","patterns":[{"include":"#prototype"},{"match":",","name":"punctuation.separator.sequence.yaml"},{"include":"#flow-pair"},{"include":"#flow-node"}]},"flow-value":{"patterns":[{"begin":"\\\\G(?![],}])","end":"(?=[],}])","name":"meta.flow-pair.value.yaml","patterns":[{"include":"#flow-node"}]}]},"node":{"patterns":[{"include":"#block-node"}]},"property":{"begin":"(?=[!\\\\&])","end":"(?!\\\\G)","name":"meta.property.yaml","patterns":[{"captures":{"1":{"name":"keyword.control.property.anchor.yaml"},"2":{"name":"punctuation.definition.anchor.yaml"},"3":{"name":"entity.name.type.anchor.yaml"},"4":{"name":"invalid.illegal.character.anchor.yaml"}},"match":"\\\\G((&))([^],/\\\\[{}\\\\s]+)(\\\\S+)?"},{"match":"\\\\G!(?:<(?:%\\\\h{2}|[]!#$\\\\&-;=?-\\\\[_a-z~])+>|(?:[-0-9A-Za-z]*!)?(?:%\\\\h{2}|[#$\\\\&-+\\\\--;=?-Z_a-z~])+|)(?=[\\\\t ]|$)","name":"storage.type.tag-handle.yaml"},{"match":"\\\\S+","name":"invalid.illegal.tag-handle.yaml"}]},"prototype":{"patterns":[{"include":"#comment"},{"include":"#property"}]}},"scopeName":"source.yaml","aliases":["yml"]}`))];export{t as n,n as t};

package/zuzuu/actions/adapter.mjs

@@ -1,122 +0,0 @@
-// zuzuu/actions/adapter.mjs
-// The Actions faculty adapter (WS2-T3). Wraps the EXISTING Actions inbox gate
-// (proposed dirs under .zuzuu/actions/inbox/<slug>/) behind the faculty-spine
-// adapter contract — { name, ingest, validate, apply, render } — so the generic
-// `zuzuu review` gate can drive Actions the same way it drives Knowledge.
-//
-// Actions payloads are DIRECTORIES (ACTION.md + sibling scripts), not JSON.
-// Strategy (lowest-risk): the inbox stays a dir; this adapter emits/reads a
-// spine-shaped proposal RECORD that REFERENCES the dir
-// (payload = { slug, kind, dir:'inbox/<slug>' }). The gate resolves a single
-// record via `getProposal`, lists pending via `listProposals`, and — because
-// the payload is dir-shaped — archives rejections via `rejectDir` (a dir move
-// into actions/proposals/archive/, not a JSON archive).
-//
-// Registers itself on import.
-
-import { join } from 'node:path';
-import { existsSync, readFileSync } from 'node:fs';
-import { listActions, inboxDir, isSafeSlug } from './manifest.mjs';
-import { activateAction, rejectAction } from './inbox.mjs';
-import { parseEnvelope, validateEnvelope, PAYLOAD_SCHEMAS } from '../faculty/envelope.mjs';
-import * as registry from '../faculty/registry.mjs';
-
-const name = 'actions';
-
-/** Build a spine-shaped proposal record for one proposed action. */
-function recordFor(a) {
-  return {
-    id: a.slug,
-    faculty: name,
-    kind: 'action',
-    status: 'pending',
-    source: 'agent',
-    payload: { slug: a.slug, kind: a.kind, dir: `inbox/${a.slug}` },
-    // carry render hints alongside the payload (cheap, dir read already done)
-    title: a.title,
-    promptSnippet: a.promptSnippet,
-    analysis: {},
-    evidence: {},
-    provenance: [],
-  };
-}
-
-/**
- * Pending action proposals (dirs in .zuzuu/actions/inbox/), surfaced as
- * spine-shaped records so the gate can render/approve/reject them uniformly.
- */
-function listProposals(agentDir) {
-  return listActions(inboxDir(agentDir)).map(recordFor);
-}
-
-/** Resolve a single proposed action by slug → spine-shaped record, or null. */
-function getProposal(agentDir, slug) {
-  if (!isSafeSlug(slug)) return null;
-  return listProposals(agentDir).find((p) => p.id === slug) ?? null;
-}
-
-/**
- * Ingest is a pass-through for Actions: proposing scaffolds a dir
- * (zuzuu act propose / act-author). Kept for adapter-contract symmetry.
- */
-function ingest(_agentDir, raw) {
-  return { payload: raw?.payload ?? raw ?? {}, analysis: {} };
-}
-
-/**
- * Validate a proposed action's ACTION.md envelope (id matches the dir; the
- * payload validates against the actions schema). Missing ACTION.md → accept
- * (slug fallback, mirrors the historical missing-manifest tolerance).
- * @returns {{ok:boolean, errors:string[], warnings:string[]}}
- */
-function validate(agentDir, payload) {
-  const slug = payload?.slug;
-  if (!isSafeSlug(slug)) return { ok: false, errors: [`invalid slug '${slug}'`], warnings: [] };
-  const manPath = join(inboxDir(agentDir), slug, 'ACTION.md');
-  if (!existsSync(manPath)) return { ok: true, errors: [], warnings: [] };
-  const { ok, item, errors: parseErrors } = parseEnvelope(readFileSync(manPath, 'utf8'));
-  if (!ok) return { ok: false, errors: [`ACTION.md is not a valid envelope: ${parseErrors[0]}`], warnings: [] };
-  if (item.id && item.id !== slug) return { ok: false, errors: [`ACTION.md id '${item.id}' ≠ dir '${slug}'`], warnings: [] };
-  if (item.faculty !== 'actions') return { ok: false, errors: [`ACTION.md faculty must be 'actions' (got '${item.faculty}')`], warnings: [] };
-  const v = validateEnvelope(item, PAYLOAD_SCHEMAS.actions);
-  return { ok: v.ok, errors: v.errors, warnings: [] };
-}
-
-/**
- * Apply an approved action proposal: activate it (move inbox/<slug> → <slug>).
- * Preserves the "already exists" guard from activateAction.
- * @returns {{ok:boolean, action:string, itemIds:string[], warnings:string[]}}
- */
-function apply(agentDir, proposal) {
-  const slug = proposal?.payload?.slug ?? proposal?.id;
-  const r = activateAction(agentDir, slug);
-  if (!r.ok) return { ok: false, action: r.error, itemIds: [], warnings: [] };
-  return { ok: true, action: `activated ${slug}`, itemIds: [slug], warnings: [] };
-}
-
-/**
- * Reject path: dir-shaped, so the gate calls this instead of the JSON archive.
- * Moves inbox/<slug> → actions/proposals/archive/<slug> (archive, not delete).
- */
-function rejectDir(agentDir, slug, _reason = '') {
-  return rejectAction(agentDir, slug);
-}
-
-/**
- * Render a proposed action for the human gate. `card` mirrors the current review
- * card (slug ── kind, then the prompt snippet); `line` is the one-line list form.
- * @returns {{line:string, card:string}}
- */
-function render(proposal) {
-  const slug = proposal?.id ?? proposal?.payload?.slug ?? '';
-  const kind = proposal?.payload?.kind ?? proposal?.kind ?? 'action';
-  const snippet = proposal?.promptSnippet ?? '';
-  return {
-    line: `${slug}  [${kind}]  ${snippet}`,
-    card: `${slug} ── ${kind}\n  ${snippet}`,
-  };
-}
-
-export const adapter = { name, ingest, validate, apply, render, listProposals, getProposal, rejectDir };
-
-registry.register(adapter);

package/zuzuu/digest.mjs

@@ -1,154 +0,0 @@
-// zuzuu/digest.mjs
-// The grounding digest — a pure, deterministic, zero-network, no-model brief of
-// the faculty home, injected at session start. Returns { text, sections }.
-// I/O-free: callers (the CLI + the SessionStart hook) handle output. Every
-// reader is wrapped so a single broken faculty never sinks the whole digest.
-
-import { join } from 'node:path';
-import { allItems } from './knowledge/items.mjs';
-import { listProposals } from './knowledge/proposals.mjs';
-import { loadRules } from './guardrails.mjs';
-import { allActions } from './actions/manifest.mjs';
-import { listFacultyItems } from './faculty/items.mjs';
-
-const PLACEHOLDER_MARK = '<!-- Fill in:';
-
-/** Read the instructions items (steering first, then amendments); classify
- *  empty vs steering text. Items are Faculty Standard envelopes (W24). */
-function readInstructions(agentDir) {
-  let items = [];
-  try {
-    items = listFacultyItems(agentDir, 'instructions').items;
-  } catch { /* missing or unreadable → treat as empty */ }
-  // steering pins the top; amendments follow in id order (already sorted)
-  items.sort((a, b) => (a.kind === 'steering' ? -1 : 1) - (b.kind === 'steering' ? -1 : 1));
-  const bodies = items
-    .map((i) => String(i.body ?? ''))
-    .map((raw) => (raw.includes(PLACEHOLDER_MARK) ? '' : raw.replace(/^#.*$/gm, '').trim() && raw.trim()))
-    .filter(Boolean);
-  const text = bodies.join('\n\n');
-  return { empty: !text, text };
-}
-
-const INTERVIEW = [
-  'Project steering is empty. Before substantive work, interview your human',
-  '(what is this project, its conventions, its priorities), draft the steering item',
-  '.zuzuu/instructions/items/steering.md from their answers, and get their approval.',
-].join(' ');
-
-function knowledgeSection(agentDir, limit) {
-  try {
-    const { items } = allItems(agentDir);
-    const ranked = [...items]
-      .sort((a, b) => String(b.created_at).localeCompare(String(a.created_at)))
-      .slice(0, limit);
-    return { count: items.length, shown: ranked.map((i) => ({ id: i.id, type: i.type, body: i.body })) };
-  } catch {
-    return { count: 0, shown: [] };
-  }
-}
-
-function proposalsSection(agentDir) {
-  try {
-    // count only pending — defensive if listProposals ever returns archived too
-    const pending = listProposals(agentDir).filter((p) => p.status === 'pending');
-    return { pending: pending.length };
-  } catch {
-    return { pending: 0 };
-  }
-}
-
-function actionsSection(agentDir, limit) {
-  try {
-    const list = allActions(agentDir);
-    return { count: list.length, shown: list.slice(0, limit).map((a) => ({ slug: a.slug, kind: a.kind, promptSnippet: a.promptSnippet })) };
-  } catch {
-    return { count: 0, shown: [] };
-  }
-}
-
-function guardrailsSection(agentDir) {
-  try {
-    const loaded = loadRules(join(agentDir, 'guardrails'));
-    return { ok: loaded.ok, count: loaded.ok ? loaded.rules.length : 0, skipped: loaded.skipped?.length ?? 0 };
-  } catch {
-    return { ok: false, count: 0, skipped: 0 };
-  }
-}
-
-/**
- * Compute the digest for a faculty home.
- * @param {string} agentDir  path to the .zuzuu/ directory
- * @param {{ knowledgeLimit?: number, budget?: number }} options
- * @returns {{ text: string, sections: object }}
- */
-export function computeDigest(agentDir, { knowledgeLimit = 5, budget = 1500 } = {}) {
-  const charBudget = budget * 4;
-  const sections = {};
-  const lines = ['# zuzuu faculty digest', ''];
-
-  const instr = readInstructions(agentDir);
-  sections.instructions = instr;
-  lines.push('## Instructions');
-  lines.push(instr.empty ? INTERVIEW : instr.text);
-  lines.push('');
-
-  const knowledge = knowledgeSection(agentDir, knowledgeLimit);
-  lines.push('## Knowledge');
-  if (!knowledge.count) {
-    lines.push('(no items yet — propose facts to knowledge/inbox/)');
-    sections.knowledge = { ...knowledge, renderedCount: 0 };
-  } else {
-    lines.push(`${knowledge.count} item(s); most recent:`);
-    let shown = 0;
-    for (const it of knowledge.shown) {
-      const line = `- ${it.id} · ${it.type} · ${it.body.split('\n')[0].slice(0, 80)}`;
-      // join is O(items²) but trivial: once-per-session, knowledgeLimit default 5
-      if (lines.join('\n').length + line.length > charBudget && shown > 0) break;
-      lines.push(line);
-      shown++;
-    }
-    const dropped = knowledge.count - shown;
-    if (dropped > 0) lines.push(`- … (${dropped} more — \`zuzuu recall\`)`);
-    // `shown` = items actually rendered (after budget); `count` = total available
-    sections.knowledge = { ...knowledge, shown: knowledge.shown.slice(0, shown), renderedCount: shown };
-  }
-  lines.push('');
-
-  const actions = actionsSection(agentDir, knowledgeLimit);
-  sections.actions = actions;
-  if (actions.count) {
-    lines.push('## Actions');
-    lines.push(`${actions.count} available; run with \`zuzuu act <slug>\`:`);
-    let shownA = 0;
-    for (const a of actions.shown) {
-      const line = `- ${a.slug} · ${a.promptSnippet}`;
-      if (lines.join('\n').length + line.length > charBudget && shownA > 0) break;
-      lines.push(line);
-      shownA++;
-    }
-    const droppedA = actions.count - shownA;
-    if (droppedA > 0) lines.push(`- … (${droppedA} more — \`zuzuu act list\`)`);
-    lines.push('');
-    // mirror the Knowledge contract: shown reflects what actually rendered
-    sections.actions = { ...actions, shown: actions.shown.slice(0, shownA), renderedCount: shownA };
-  } else {
-    sections.actions = { ...actions, renderedCount: 0 };
-  }
-
-  const proposals = proposalsSection(agentDir);
-  sections.proposals = proposals;
-  if (proposals.pending > 0) {
-    lines.push('## Proposals');
-    lines.push(`${proposals.pending} proposal(s) await your approval — run \`zuzuu review\`; approving mints a generation (your checkpoint).`);
-    lines.push('');
-  }
-
-  const guardrails = guardrailsSection(agentDir);
-  sections.guardrails = guardrails;
-  lines.push('## Guardrails');
-  lines.push(guardrails.count ? `${guardrails.count} rule(s) — the enforced gate is on; refusals are policy.` : 'no rules configured.');
-  lines.push('');
-
-  return { text: lines.join('\n').trimEnd() + '\n', sections };
-}