@zuzuucodes/cli 1.4.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,130 +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 (run.mjs/SKILL.md + action.json), 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 { validateInputs } from './schema.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 manifest against the schema subset and confirm
- * the manifest slug matches the dir. Missing manifest → accept (slug fallback).
- * @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.json');
-  if (!existsSync(manPath)) return { ok: true, errors: [], warnings: [] };
-  let man;
-  try { man = JSON.parse(readFileSync(manPath, 'utf8')); }
-  catch { return { ok: false, errors: ['manifest is not valid JSON'], warnings: [] }; }
-  if (man.slug && man.slug !== slug) return { ok: false, errors: [`manifest slug '${man.slug}' ≠ dir '${slug}'`], warnings: [] };
-  const errors = [];
-  // the manifest schema is itself JSON-Schema-subset shaped; sanity-check both ends
-  if (man.inputs) {
-    const vi = validateInputs(man.inputs, man.default_args, {});
-    // inputs schema is for caller args, not the manifest — only flag a structurally
-    // broken schema (validateInputs is permissive on empty args), so this is a no-op
-    // for well-formed manifests. Kept for symmetry with the knowledge adapter.
-    if (vi.ok === false && !/required/i.test(vi.error ?? '')) errors.push(vi.error);
-  }
-  if (man.outputs && typeof man.outputs !== 'object') errors.push('outputs schema must be an object');
-  return { ok: errors.length === 0, 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/commands/migrate.mjs

@@ -1,225 +0,0 @@
-// zuzuu/commands/migrate.mjs
-// `zuzuu migrate` — one-time migrators.
-//
-//   (default)  proposal schema: legacy {candidate, er} → spine {payload, analysis, faculty} (WS2-T5)
-//   --home     faculty home: visible agent/ → hidden .zuzuu/ (W1, 2026-06-12)
-//
-// Pure cores:  migrateProposals(agentDir) → { scanned, migrated, skipped }
-//              migrateHome(root) → { migrated }
-// CLI surface: migrate(args) — resolves paths, runs the core, prints summary.
-
-import { existsSync, readdirSync, readFileSync, writeFileSync, renameSync, rmSync } from 'node:fs';
-import { join } from 'node:path';
-import { paths, repoRoot } from '../store.mjs';
-import { proposalsDir, archiveDir } from '../faculty/contract.mjs';
-import { ensureGitignore } from '../scaffold.mjs';
-import { injectBlock, BLOCK_VERSION } from '../inject.mjs';
-
-// ---------------------------------------------------------------------------
-// pure core — testable without process.*
-// ---------------------------------------------------------------------------
-
-/**
- * Determine whether a parsed JSON record is already in the new shape.
- * A record is "new" when it has `payload` AND `faculty` set.
- * If it only has `candidate` and/or lacks `faculty` it is legacy.
- */
-function isLegacy(rec) {
-  if (!rec || typeof rec !== 'object') return false;
-  // already migrated: has payload and faculty
-  if (rec.payload !== undefined && rec.faculty !== undefined) return false;
-  // legacy if it has candidate or er keys, or is simply missing faculty/payload
-  return rec.candidate !== undefined || rec.er !== undefined || rec.faculty === undefined;
-}
-
-/**
- * Convert a legacy record to the new unified shape.
- * Returns the migrated record (caller writes it back).
- */
-function migrateRecord(rec) {
-  const out = { ...rec };
-
-  // payload = candidate (drop candidate)
-  if (out.candidate !== undefined) {
-    if (out.payload === undefined) out.payload = out.candidate;
-    delete out.candidate;
-  }
-
-  // analysis = { er } (drop er)
-  if (out.er !== undefined) {
-    if (out.analysis === undefined) out.analysis = { er: out.er };
-    delete out.er;
-  }
-
-  // faculty defaults to 'knowledge' (only knowledge proposals exist pre-spine)
-  if (!out.faculty) out.faculty = 'knowledge';
-
-  return out;
-}
-
-/**
- * Scan one directory of *.json files and migrate legacy records in-place.
- * Fail-soft: bad JSON files are counted as skipped and never throw.
- * Returns { migrated, scanned, skipped } for this directory.
- */
-function migrateDir(dir) {
-  if (!existsSync(dir)) return { migrated: 0, scanned: 0, skipped: 0 };
-
-  const files = readdirSync(dir).filter((f) => f.endsWith('.json'));
-  let migrated = 0;
-  let skipped = 0;
-
-  for (const file of files) {
-    const fpath = join(dir, file);
-    let rec;
-    try {
-      rec = JSON.parse(readFileSync(fpath, 'utf8'));
-    } catch {
-      skipped++;
-      continue;
-    }
-
-    if (!isLegacy(rec)) {
-      skipped++;
-      continue;
-    }
-
-    try {
-      const migrated_rec = migrateRecord(rec);
-      writeFileSync(fpath, JSON.stringify(migrated_rec, null, 2) + '\n');
-      migrated++;
-    } catch {
-      skipped++;
-    }
-  }
-
-  return { migrated, scanned: files.length, skipped };
-}
-
-/**
- * Scan both pending and archived Knowledge proposals.
- * Returns { scanned, migrated, skipped }.
- */
-export function migrateProposals(agentDir) {
-  const pending = migrateDir(proposalsDir(agentDir, 'knowledge'));
-  const archived = migrateDir(archiveDir(agentDir, 'knowledge'));
-
-  return {
-    scanned: pending.scanned + archived.scanned,
-    migrated: pending.migrated + archived.migrated,
-    skipped: pending.skipped + archived.skipped,
-  };
-}
-
-// ---------------------------------------------------------------------------
-// home migration — agent/ → .zuzuu/ (W1, 2026-06-12)
-// ---------------------------------------------------------------------------
-
-// The denies the old visible-agent/ home installed; scrubbed here (NOT kept in
-// install.mjs — clean break) and replaced by the current narrow .zuzuu/ pair.
-const LEGACY_DENY_RULES = ['Read(./agent/.traces/**)', 'Read(./agent/.live/**)'];
-const NEW_DENY_RULES = ['Read(./.zuzuu/.traces/**)', 'Read(./.zuzuu/.live/**)'];
-
-/**
- * One-shot HOME migration: visible `agent/` → hidden `.zuzuu/` (byte-identical
- * inner layout). Gated on `agent/agent.json` — `agent/` is a common dir name,
- * so an unrelated agent/ dir in a brownfield repo must NEVER be touched (the
- * one place this differs from the old `.mns→agent` precedent). Idempotent +
- * fail-soft; NEVER clobbers an existing .zuzuu/. Pure FS move (renameSync).
- * @returns {{migrated: boolean}}
- */
-export function migrateHome(root = repoRoot()) {
-  const legacy = join(root, 'agent');
-  const home = join(root, '.zuzuu');
-  if (existsSync(home) || !existsSync(join(legacy, 'agent.json'))) return { migrated: false };
-
-  renameSync(legacy, home); // move the whole home (atomic on same filesystem)
-
-  rewriteTraceRefs(home);
-  rewriteGitignore(root);
-  scrubLegacyDenies(root);
-  // derived index: drop, it rebuilds on the next recall/reindex
-  try { rmSync(join(home, 'knowledge', '.index.db'), { force: true }); } catch { /* fail-soft */ }
-  return { migrated: true };
-}
-
-/** sessions.json stores repo-relative traceRefs (`agent/.traces/…`) — re-point them. */
-function rewriteTraceRefs(home) {
-  const index = join(home, 'sessions.json');
-  if (!existsSync(index)) return;
-  try {
-    const idx = JSON.parse(readFileSync(index, 'utf8'));
-    for (const s of idx.sessions || []) {
-      if (typeof s.traceRef === 'string' && s.traceRef.startsWith('agent/')) {
-        s.traceRef = '.zuzuu/' + s.traceRef.slice('agent/'.length);
-      }
-    }
-    writeFileSync(index, JSON.stringify(idx, null, 2) + '\n');
-  } catch { /* fail-soft: a bad index never blocks the move */ }
-}
-
-/** Drop legacy `agent/` ignore lines, then append the canonical .zuzuu/ ones. */
-function rewriteGitignore(root) {
-  const path = join(root, '.gitignore');
-  if (existsSync(path)) {
-    const kept = readFileSync(path, 'utf8')
-      .split('\n')
-      .filter((l) => !l.trim().startsWith('agent/'))
-      .join('\n');
-    writeFileSync(path, kept.endsWith('\n') || kept === '' ? kept : kept + '\n');
-  }
-  ensureGitignore(root); // appends .zuzuu/.traces/, .zuzuu/.live/, .zuzuu/knowledge/.index.db
-}
-
-/** Swap the old agent/ deny rules for the .zuzuu/ pair in any .claude settings file. */
-function scrubLegacyDenies(root) {
-  for (const f of ['settings.json', 'settings.local.json']) {
-    const path = join(root, '.claude', f);
-    if (!existsSync(path)) continue;
-    try {
-      const s = JSON.parse(readFileSync(path, 'utf8'));
-      const deny = s?.permissions?.deny;
-      if (!Array.isArray(deny)) continue;
-      const hadOurs = deny.some((r) => LEGACY_DENY_RULES.includes(r));
-      if (!hadOurs) continue;
-      s.permissions.deny = deny.filter((r) => !LEGACY_DENY_RULES.includes(r));
-      for (const rule of NEW_DENY_RULES) if (!s.permissions.deny.includes(rule)) s.permissions.deny.push(rule);
-      writeFileSync(path, JSON.stringify(s, null, 2) + '\n');
-    } catch { /* fail-soft: never break settings we can't parse */ }
-  }
-}
-
-/** Re-inject the current faculties block into any existing host instruction files. */
-function reinjectHostBlocks(root) {
-  for (const f of ['CLAUDE.md', 'AGENTS.md', 'GEMINI.md']) {
-    const p = join(root, f);
-    if (existsSync(p)) {
-      const text = readFileSync(p, 'utf8');
-      if (!text.includes(`zuzuu:faculties:v${BLOCK_VERSION}`)) writeFileSync(p, injectBlock(text));
-    }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// CLI surface
-// ---------------------------------------------------------------------------
-
-export function migrate(args = {}) {
-  if (args.home) {
-    const root = repoRoot(process.cwd());
-    const { migrated } = migrateHome(root);
-    if (!migrated) { console.log('migrate --home: nothing to do (already .zuzuu/, or no zuzuu home at agent/)'); return; }
-    try { reinjectHostBlocks(root); } catch { /* fail-open */ }
-    console.log(`migrate --home: agent/ → .zuzuu/ (hidden, like .git; block v${BLOCK_VERSION}, gitignore + deny rules rewritten)`);
-    console.log('  transparency lives in porcelain now: zuzuu status · explain · digest');
-    return;
-  }
-  const agentDir = paths().dir;
-  const { scanned, migrated, skipped } = migrateProposals(agentDir);
-  console.log(`migrate: scanned ${scanned} proposal(s) — migrated ${migrated}, skipped ${skipped}`);
-  if (migrated > 0) {
-    console.log('  legacy candidate/er keys rewritten to payload/analysis.er + faculty:knowledge');
-  } else {
-    console.log('  nothing to migrate (all records already in new shape)');
-  }
-}

package/zuzuu/digest.mjs

@@ -1,149 +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 { readFileSync } from 'node:fs';
-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';
-
-const PLACEHOLDER_MARK = '<!-- Fill in:';
-
-/** Read instructions/project.md; classify empty vs steering text. */
-function readInstructions(agentDir) {
-  const path = join(agentDir, 'instructions', 'project.md');
-  let raw = '';
-  try {
-    raw = readFileSync(path, 'utf8');
-  } catch { /* missing or unreadable → treat as empty */ }
-  const stripped = raw.replace(/^#.*$/gm, '').trim();
-  const empty = !stripped || raw.includes(PLACEHOLDER_MARK);
-  return { empty, text: empty ? '' : raw.trim() };
-}
-
-const INTERVIEW = [
-  'Project steering is empty. Before substantive work, interview your human',
-  '(what is this project, its conventions, its priorities), draft',
-  '.zuzuu/instructions/project.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', 'rules.json'));
-    return { ok: loaded.ok, count: loaded.ok ? loaded.rules.length : 0 };
-  } catch {
-    return { ok: false, count: 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 };
-}