rigjs 4.0.5 → 4.0.6

package/lib/wiki/installSkill.ts

@@ -1,5 +1,6 @@
 import fs from 'fs';
 import path from 'path';
+import os from 'os';
 import print from '../print';
 import { paths } from './paths';
 
@@ -10,8 +11,6 @@ const BUNDLED_SKILLS = [
 
 /** Find rig's package root by walking up from built/ or lib/. */
 function findRigRoot(): string | undefined {
-  // Walk up from `built/index.js` (prod) or `lib/wiki/installSkill.ts` (dev)
-  // looking for the rigjs package root.
   let dir = __dirname;
   for (let i = 0; i < 10; i++) {
     const pkg = path.join(dir, 'package.json');
@@ -28,8 +27,19 @@ function findRigRoot(): string | undefined {
   return undefined;
 }
 
-interface InstallOpts { force?: boolean; }
+interface InstallOpts { force?: boolean; project?: boolean; }
 
+/**
+ * Install bundled skills (rig-wiki, rig-crew) as symlinks.
+ *
+ * Default (global): link into `~/.claude/skills/<name>/SKILL.md`. Affects
+ * every project that uses Claude Code on this machine.
+ *
+ * `--project` (project-level override for overmind-style monorepos):
+ * link into BOTH `<cwd>/.claude/skills/<name>/SKILL.md` (Claude Code) AND
+ * `<cwd>/.agents/skills/<name>/SKILL.md` (Codex). When the user is inside
+ * the project, the project-local skill files override the global ones.
+ */
 export default function wikiInstallSkill(opts: InstallOpts): void {
   const root = findRigRoot();
   if (!root) {
@@ -37,45 +47,77 @@ export default function wikiInstallSkill(opts: InstallOpts): void {
     process.exit(1);
   }
 
-  if (!fs.existsSync(paths.claudeSkillsDir)) {
-    print.error(`Claude Code skills dir not found: ${paths.claudeSkillsDir}`);
-    print.info('install Claude Code first, then re-run `rig wiki install-skill`.');
-    process.exit(1);
-  }
+  const targetRoots = resolveTargetRoots(opts);
+  for (const tr of targetRoots) {
+    if (!fs.existsSync(tr.parent)) {
+      // Project-level install creates the dirs on demand (parent is <cwd>).
+      // Global install requires the dir to already exist — that's how we
+      // detect "Claude Code is installed on this machine".
+      if (tr.kind === 'global') {
+        print.error(`${tr.label} dir not found: ${tr.parent}`);
+        print.info(`install ${tr.label} first, then re-run \`rig wiki install-skill\`.`);
+        process.exit(1);
+      }
+    }
 
-  for (const skill of BUNDLED_SKILLS) {
-    const src = path.join(root, skill.file);
-    if (!fs.existsSync(src)) {
-      print.warn(`skipping ${skill.name}: ${skill.file} not found inside rigjs install`);
-      continue;
+    for (const skill of BUNDLED_SKILLS) {
+      const src = path.join(root, skill.file);
+      if (!fs.existsSync(src)) {
+        print.warn(`skipping ${skill.name}: ${skill.file} not found inside rigjs install`);
+        continue;
+      }
+      linkSkill(skill.name, src, tr.parent, opts);
     }
-    linkSkill(skill.name, src, opts);
   }
 
-  print.info('restart Claude Code to pick up new or updated skills.');
+  if (opts.project) {
+    print.info('project-local skills will override global ones when this project is the cwd.');
+  } else {
+    print.info('restart Claude Code to pick up new or updated skills.');
+  }
+}
+
+interface TargetRoot {
+  /** `<parent>/<skill-name>/SKILL.md` is the resulting symlink. */
+  parent: string;
+  kind: 'global' | 'project';
+  label: string;
 }
 
-function linkSkill(name: string, src: string, opts: InstallOpts): void {
-  const targetDir = path.join(paths.claudeSkillsDir, name);
+function resolveTargetRoots(opts: InstallOpts): TargetRoot[] {
+  if (opts.project) {
+    const cwd = process.cwd();
+    return [
+      { parent: path.join(cwd, '.claude', 'skills'), kind: 'project', label: 'Claude Code project skills' },
+      { parent: path.join(cwd, '.agents', 'skills'), kind: 'project', label: 'Codex project skills' },
+    ];
+  }
+  return [
+    { parent: paths.claudeSkillsDir, kind: 'global', label: 'Claude Code skills' },
+  ];
+}
+
+function linkSkill(name: string, src: string, parentDir: string, opts: InstallOpts): void {
+  const targetDir = path.join(parentDir, name);
   const target = path.join(targetDir, 'SKILL.md');
   fs.mkdirSync(targetDir, { recursive: true });
 
   if (fs.existsSync(target) || isBrokenSymlink(target)) {
     const existing = safeReadlink(target);
     if (existing === src) {
-      print.info(`already linked: ${target}`);
+      print.info(`already linked: ${shortPath(target)}`);
       return;
     }
     if (!opts.force) {
       const what = existing ? `symlink -> ${existing}` : 'a regular file';
-      print.error(`${target} exists as ${what}. Pass --force to replace.`);
+      print.error(`${shortPath(target)} exists as ${what}. Pass --force to replace.`);
       process.exit(1);
     }
     fs.rmSync(target, { force: true });
   }
 
   fs.symlinkSync(src, target);
-  print.succeed(`linked ${target} -> ${src}`);
+  print.succeed(`linked ${shortPath(target)} -> ${shortPath(src)}`);
 }
 
 function safeReadlink(p: string): string | null {
@@ -90,3 +132,9 @@ function isBrokenSymlink(p: string): boolean {
     try { return Boolean(fs.readlinkSync(p)); } catch { return false; }
   }
 }
+
+function shortPath(p: string): string {
+  const home = os.homedir();
+  if (p.startsWith(home + path.sep)) return '~' + p.slice(home.length);
+  return p;
+}

package/lib/wiki/lint.ts

@@ -16,13 +16,13 @@ import fs from 'fs';
 import path from 'path';
 import crypto from 'crypto';
 import print from '../print';
-import { loadWikiConfig, resolveWiki, WikiEntry } from './config';
+import { requireVault, WikiEntry } from './config';
 import { recordLastRun } from './db';
 
-interface LintOpts { wiki?: string; all?: boolean; json?: boolean; }
+interface LintOpts { json?: boolean; }
 
 interface PageMeta {
-  rel: string;          // wiki-relative path, e.g. "wiki/sources/foo.md"
+  rel: string;          // vault-relative path, e.g. "sources/foo.md"
   slug: string;         // filename without ext
   sub: string;          // "sources" | "entities" | "concepts" | "synthesis" | "queries"
   frontmatter: Record<string, unknown> | null;
@@ -44,34 +44,24 @@ const SOURCE_EXTRA_KEYS = ['source-sha', 'source-path'] as const;
 const WIKI_SUBDIRS = ['sources', 'entities', 'concepts', 'synthesis', 'queries'] as const;
 
 export default async function wikiLint(opts: LintOpts): Promise<void> {
-  const cfg = loadWikiConfig();
-  const targets: WikiEntry[] = opts.all
-    ? cfg.wikis
-    : [resolveWiki(cfg, opts.wiki)].filter(Boolean) as WikiEntry[];
-  if (targets.length === 0) {
-    print.error('no wiki resolved. Pass --wiki <name>, --all, or run from inside a registered project.');
-    process.exit(1);
-  }
-
-  let severeFound = false;
-  const reports: { wiki: string; findings: Findings }[] = [];
-  for (const t of targets) {
-    const findings = lintOne(t);
-    reports.push({ wiki: t.name, findings });
-    const sev =
-      findings.missingFrontmatter.length +
-      findings.missingRequiredKey.length +
-      findings.brokenWikilinks.length +
-      findings.missingRawSource.length;
-    if (sev > 0) severeFound = true;
-    if (!opts.json) printSummary(t.name, findings);
-    writeReport(t, findings);
-    recordLastRun(t.name, 'lint', sev > 0 ? 11 : 0);
-  }
+  const target = requireVault();
+  const findings = lintOne(target);
+  const sev =
+    findings.missingFrontmatter.length +
+    findings.missingRequiredKey.length +
+    findings.brokenWikilinks.length +
+    findings.missingRawSource.length;
+  const severeFound = sev > 0;
+  if (!opts.json) printSummary(target.name, findings);
+  writeReport(target, findings);
+  recordLastRun(target.name, 'lint', severeFound ? 11 : 0);
 
   if (opts.json) {
     // eslint-disable-next-line no-console
-    console.log(JSON.stringify({ ok: !severeFound, code: severeFound ? 11 : 0, data: reports }, null, 2));
+    console.log(JSON.stringify({
+      ok: !severeFound, code: severeFound ? 11 : 0,
+      data: [{ wiki: target.name, findings }],
+    }, null, 2));
   }
   if (severeFound) process.exit(11);
 }
@@ -89,7 +79,7 @@ function lintOne(wiki: WikiEntry): Findings {
 
   const pages: PageMeta[] = [];
   for (const sub of WIKI_SUBDIRS) {
-    const dir = path.join(wiki.path, 'wiki', sub);
+    const dir = path.join(wiki.path, sub);
     if (!fs.existsSync(dir)) continue;
     for (const name of fs.readdirSync(dir)) {
       if (!name.endsWith('.md') || name === '.gitkeep') continue;

package/lib/wiki/paths.ts

@@ -6,7 +6,6 @@ export const RIG_HOME = process.env.RIG_HOME || path.join(os.homedir(), '.rig');
 export const paths = {
   home: RIG_HOME,
   config: path.join(RIG_HOME, 'config.yml'),
-  registry: path.join(RIG_HOME, 'wikis.yml'),
   stateDb: path.join(RIG_HOME, 'state.db'),
   locks: path.join(RIG_HOME, 'locks'),
   logs: path.join(RIG_HOME, 'logs'),

package/lib/wiki/query.ts

@@ -10,12 +10,11 @@
 
 import path from 'path';
 import print from '../print';
-import { loadWikiConfig, resolveWiki, loadRigConfig, WikiEntry } from './config';
+import { requireVault, loadRigConfig, WikiEntry } from './config';
 import { qmdQuery, QmdHit } from './qmd';
 import { adapters } from './agent/registry';
 
 interface QueryOpts {
-  wiki?: string;
   json?: boolean;
   limit?: number;
   synth?: boolean;
@@ -28,12 +27,7 @@ export default async function wikiQuery(q: string, opts: QueryOpts): Promise<voi
     print.error('empty query.');
     process.exit(1);
   }
-  const cfg = loadWikiConfig();
-  const target = resolveWiki(cfg, opts.wiki);
-  if (!target) {
-    print.error('no wiki resolved. Pass --wiki <name> or run from inside a registered project.');
-    process.exit(1);
-  }
+  const target = requireVault();
 
   const limit = Math.max(1, Math.min(50, opts.limit || 10));
   const hits = await qmdQuery(q, target.name, { limit, rerank: opts.rerank !== false });
@@ -78,13 +72,15 @@ function printHits(wiki: WikiEntry, q: string, hits: QmdHit[]): void {
   console.log('');
 }
 
-// "/abs/.../wiki/sources/foo.md" → "foo". Outside wiki/<sub>/ → null so the
-// caller falls back to printing the literal path.
+// "/abs/<vault>/sources/foo.md" → "foo". For paths outside the page-tree
+// subdirs returns null so the caller falls back to the literal path.
+const PAGE_SUBDIRS = ['sources', 'entities', 'concepts', 'synthesis', 'queries'];
 function toWikilink(wiki: WikiEntry, filePath: string): string | null {
   try {
     const abs = path.isAbsolute(filePath) ? filePath : path.resolve(wiki.path, filePath);
-    const wikiRoot = path.join(wiki.path, 'wiki') + path.sep;
-    if (!abs.startsWith(wikiRoot)) return null;
+    const rel = path.relative(wiki.path, abs);
+    const first = rel.split(path.sep)[0];
+    if (!PAGE_SUBDIRS.includes(first)) return null;
     return path.basename(abs, path.extname(abs));
   } catch { return null; }
 }

package/lib/wiki/rebuild.ts

@@ -13,44 +13,33 @@
 //   - full re-embed (Qwen3-Embedding by default)
 
 import print from '../print';
-import { loadWikiConfig, resolveWiki, WikiEntry } from './config';
+import { requireVault } from './config';
 import { getDb, recordLastRun } from './db';
 import { qmdEmbed, qmdResetStore } from './qmd';
 
-interface RebuildOpts { wiki?: string; all?: boolean; skipEmbed?: boolean; }
+interface RebuildOpts { skipEmbed?: boolean; }
 
 export default async function wikiRebuild(opts: RebuildOpts): Promise<void> {
-  const cfg = loadWikiConfig();
-  const targets: WikiEntry[] = opts.all
-    ? cfg.wikis
-    : [resolveWiki(cfg, opts.wiki)].filter(Boolean) as WikiEntry[];
-  if (targets.length === 0) {
-    print.error('no wiki resolved. Pass --wiki <name>, --all, or run from inside a registered project.');
-    process.exit(1);
-  }
-
+  const t = requireVault();
   const db = getDb();
-  for (const t of targets) {
-    print.start(`rebuild: ${t.name}`);
-    const del = db.prepare('DELETE FROM source_sha WHERE wiki = ?').run(t.name);
-    print.info(`  cleared ${del.changes} source_sha rows for ${t.name}`);
 
-    qmdResetStore(t.name);
+  print.start(`rebuild: ${t.name}`);
+  const del = db.prepare('DELETE FROM source_sha WHERE wiki = ?').run(t.name);
+  print.info(`  cleared ${del.changes} source_sha rows for ${t.name}`);
 
-    if (!opts.skipEmbed) {
-      const res = await qmdEmbed(t.name, t.path, { force: true });
-      if (res.ok) print.info(`  qmd embed: ${t.name} done`);
-      else {
-        print.error(`  qmd embed: ${t.name} failed: ${res.stderr.trim()}`);
-        recordLastRun(t.name, 'rebuild', 1);
-        process.exitCode = 1;
-        continue;
-      }
-    }
+  qmdResetStore(t.name);
 
-    recordLastRun(t.name, 'rebuild', 0);
-    print.succeed(`rebuilt: ${t.name}`);
+  if (!opts.skipEmbed) {
+    const res = await qmdEmbed(t.name, t.path, { force: true });
+    if (res.ok) print.info(`  qmd embed: ${t.name} done`);
+    else {
+      print.error(`  qmd embed: ${t.name} failed: ${res.stderr.trim()}`);
+      recordLastRun(t.name, 'rebuild', 1);
+      process.exit(1);
+    }
   }
 
+  recordLastRun(t.name, 'rebuild', 0);
+  print.succeed(`rebuilt: ${t.name}`);
   print.info('next: run `rig wiki scan` to baseline the new sha index.');
 }

package/lib/wiki/uninstallSkill.ts

@@ -1,30 +1,50 @@
 import fs from 'fs';
 import path from 'path';
+import os from 'os';
 import print from '../print';
 import { paths } from './paths';
 
-export default function wikiUninstallSkill(): void {
-  const targetDir = path.join(paths.claudeSkillsDir, 'rig-wiki');
-  const target = path.join(targetDir, 'SKILL.md');
+const BUNDLED_SKILLS = ['rig-wiki', 'rig-crew'];
 
-  let removed = false;
-  if (fs.existsSync(target) || isBrokenSymlink(target)) {
-    fs.rmSync(target, { force: true });
-    print.succeed(`removed ${target}`);
-    removed = true;
-  }
+interface UninstallOpts { project?: boolean; }
+
+/**
+ * Remove bundled-skill symlinks. Mirrors `installSkill` flags:
+ *   default       — `~/.claude/skills/<name>/SKILL.md`
+ *   `--project`   — both `<cwd>/.claude/skills/<name>/SKILL.md`
+ *                   and `<cwd>/.agents/skills/<name>/SKILL.md`
+ */
+export default function wikiUninstallSkill(opts: UninstallOpts): void {
+  const parents = opts.project
+    ? [
+        path.join(process.cwd(), '.claude', 'skills'),
+        path.join(process.cwd(), '.agents', 'skills'),
+      ]
+    : [paths.claudeSkillsDir];
 
-  // Clean the rig-wiki/ dir if we left it empty.
-  if (fs.existsSync(targetDir)) {
-    try {
-      if (fs.readdirSync(targetDir).length === 0) {
-        fs.rmdirSync(targetDir);
-        print.info(`removed empty dir ${targetDir}`);
+  let removed = 0;
+  for (const parent of parents) {
+    for (const name of BUNDLED_SKILLS) {
+      const targetDir = path.join(parent, name);
+      const target = path.join(targetDir, 'SKILL.md');
+
+      if (fs.existsSync(target) || isBrokenSymlink(target)) {
+        fs.rmSync(target, { force: true });
+        print.succeed(`removed ${shortPath(target)}`);
+        removed++;
       }
-    } catch { /* non-fatal */ }
+
+      if (fs.existsSync(targetDir)) {
+        try {
+          if (fs.readdirSync(targetDir).length === 0) {
+            fs.rmdirSync(targetDir);
+          }
+        } catch { /* non-fatal */ }
+      }
+    }
   }
 
-  if (!removed) print.info(`nothing to remove at ${target}`);
+  if (removed === 0) print.info('nothing to remove.');
 }
 
 function isBrokenSymlink(p: string): boolean {
@@ -35,3 +55,9 @@ function isBrokenSymlink(p: string): boolean {
     try { return Boolean(fs.readlinkSync(p)); } catch { return false; }
   }
 }
+
+function shortPath(p: string): string {
+  const home = os.homedir();
+  if (p.startsWith(home + path.sep)) return '~' + p.slice(home.length);
+  return p;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rigjs",
-  "version": "4.0.5",
-  "versionCode": 26052412,
+  "version": "4.0.6",
+  "versionCode": 26052413,
   "description": "A multi-repos dev tool based on yarn and git.Rigjs is intended to be the simplest way to develop,share and deliver codes between different developers or different projects.",
   "keywords": [
     "modular",

package/scripts/publish.mjs

@@ -90,4 +90,63 @@ try {
 } finally {
   rmSync(tmpDir, { recursive: true, force: true });
 }
+
+if (status === 0) {
+  await syncNpmmirror(pkg.name);
+}
 process.exit(status);
+
+/**
+ * Tell registry.npmmirror.com to pull the newly published version from
+ * upstream npmjs. Fire the POST kickoff, then poll the sync log a few
+ * times — we don't block release on completion, just surface progress.
+ *
+ * Failures (network, 5xx, timeout) are warnings, not hard errors: the
+ * publish itself succeeded; the mirror will catch up on its own.
+ */
+async function syncNpmmirror(pkgName) {
+  const slug = encodeURIComponent(pkgName);
+  const kickoffUrl = `https://registry.npmmirror.com/-/package/${slug}/syncs?sync_upstream=true`;
+  process.stdout.write(`\nsyncing ${pkgName} to npmmirror.com...\n`);
+
+  let logId;
+  try {
+    const r = await fetch(kickoffUrl, { method: 'PUT' });
+    if (!r.ok) {
+      process.stderr.write(`  kickoff failed (HTTP ${r.status}) — mirror will sync on its own schedule\n`);
+      return;
+    }
+    const body = await r.json();
+    logId = body.logId || body.id;
+    if (!logId) {
+      process.stdout.write(`  kicked off (no logId returned, treating as fire-and-forget)\n`);
+      return;
+    }
+    process.stdout.write(`  kicked off (logId=${logId})\n`);
+  } catch (e) {
+    process.stderr.write(`  kickoff error: ${e.message} — mirror will sync on its own schedule\n`);
+    return;
+  }
+
+  // Poll the sync log: 3s interval, give up after 60s.
+  const statusUrl = `https://registry.npmmirror.com/-/package/${slug}/syncs/${logId}`;
+  const start = Date.now();
+  const TIMEOUT_MS = 60_000;
+  while (Date.now() - start < TIMEOUT_MS) {
+    await new Promise(r => setTimeout(r, 3000));
+    try {
+      const r = await fetch(statusUrl);
+      if (!r.ok) continue;
+      const s = await r.json();
+      if (s.syncDone || s.state === 'success') {
+        process.stdout.write(`  npmmirror sync complete\n`);
+        return;
+      }
+      if (s.state === 'fail') {
+        process.stderr.write(`  npmmirror sync failed: ${s.error || '(no error message)'}\n`);
+        return;
+      }
+    } catch { /* transient — keep polling */ }
+  }
+  process.stdout.write(`  still in progress after ${TIMEOUT_MS / 1000}s — npmmirror will finish in the background\n`);
+}

package/skills.md

@@ -15,22 +15,49 @@ Keep the root `README.md` short: it should link here and to the canonical skill
 
 ## Install
 
-Normal install:
+### Global install (default — affects every project on the machine)
 
 ```bash
-npm i -g rigjs
+yarn global add rigjs
 ```
 
-The `postinstall` script links bundled skills into `~/.claude/skills/` when Claude Code is installed.
-
-Security-conscious install:
+The `postinstall` script links bundled skills into `~/.claude/skills/` (Claude Code's user-level skill directory). If you prefer to skip the postinstall:
 
 ```bash
-npm i -g rigjs --ignore-scripts
+yarn global add rigjs --ignore-scripts
 rig wiki install-skill
 ```
 
-`rig wiki install-skill` installs both bundled skills. The command name remains under `wiki` for backward compatibility.
+### Project-level install (per-project override, Claude Code + Codex)
+
+For "monorepo of work projects" setups — e.g. overmind — you can install the skills **into the project itself** so they live alongside the code and override the global ones whenever the user is inside that project:
+
+```bash
+cd <project>
+rig wiki install-skill --project
+```
+
+This creates symlinks at:
+
+- `<project>/.claude/skills/rig-wiki/SKILL.md` → `<rigjs-install>/RIG_WIKI_SKILL.md`
+- `<project>/.claude/skills/rig-crew/SKILL.md` → `<rigjs-install>/RIG_CREW_SKILL.md`
+- `<project>/.agents/skills/rig-wiki/SKILL.md` → (same target, for Codex)
+- `<project>/.agents/skills/rig-crew/SKILL.md` → (same target, for Codex)
+
+Both Claude Code (`.claude/skills/`) and Codex (`.agents/skills/`) read from project-local skill dirs when invoked inside the project, so a single `--project` install covers both agents.
+
+Project-local skills take precedence over `~/.claude/skills/` while the user is in that project. To remove:
+
+```bash
+cd <project>
+rig wiki uninstall-skill --project
+```
+
+### Why project-level over global
+
+- Pins the skill version to the rigjs install in `node_modules` (or wherever the global rig lives), so the skill the agent sees matches the CLI it's about to call.
+- Lets the project decide which agent gets which skill — committing `.claude/skills/rig-wiki/` to the repo makes the agent behaviour reproducible across machines.
+- Works in CI / sandboxes where there's no home-dir `~/.claude/skills/` to install into.
 
 ## Maintenance
 

package/lib/wiki/list.ts

@@ -1,69 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import print from '../print';
-import { loadWikiConfig, loadRigConfig } from './config';
-import { getLastRun } from './db';
-import { detectQmd } from './qmd';
-import { adapters } from './agent/registry';
-
-export default async function wikiList(): Promise<void> {
-  const cfg = loadWikiConfig();
-  const rig = loadRigConfig();
-  if (cfg.wikis.length === 0) {
-    print.info('no wikis registered. Use `rig wiki register [<path>]` to add one.');
-  } else {
-    const rows = cfg.wikis.map(w => ({
-      name: w.name,
-      path: shortPath(w.path),
-      pages: countPages(w.path),
-      lastScan: fmtTs(getLastRun(w.name, 'scan')?.ts),
-      lastIngest: fmtTs(getLastRun(w.name, 'ingest')?.ts),
-      lastLint: fmtTs(getLastRun(w.name, 'lint')?.ts),
-    }));
-    const header = ['NAME', 'PATH', 'PAGES', 'LAST SCAN', 'LAST INGEST', 'LAST LINT'];
-    printTable(header, rows.map(r => [r.name, r.path, String(r.pages), r.lastScan, r.lastIngest, r.lastLint]));
-  }
-
-  const qmd = detectQmd();
-  const defaultAgent = rig.wiki?.defaultAgent || 'claude';
-  const agentDetect = await adapters.find(a => a.name === defaultAgent)?.detect();
-  // eslint-disable-next-line no-console
-  console.log(`\nagent: ${defaultAgent}${agentDetect?.installed ? ` (${agentDetect.version || 'installed'})` : ' (NOT installed)'}` +
-              `   qmd: ${qmd.installed ? qmd.version || 'installed' : 'not installed (fallback mode)'}`);
-}
-
-function countPages(wikiDir: string): number {
-  const wiki = path.join(wikiDir, 'wiki');
-  if (!fs.existsSync(wiki)) return 0;
-  let n = 0;
-  for (const sub of ['sources', 'entities', 'concepts', 'synthesis', 'queries']) {
-    const d = path.join(wiki, sub);
-    if (!fs.existsSync(d)) continue;
-    for (const f of fs.readdirSync(d)) if (f.endsWith('.md') && f !== '.gitkeep') n++;
-  }
-  return n;
-}
-
-function shortPath(p: string): string {
-  const home = process.env.HOME || '';
-  return home && p.startsWith(home) ? '~' + p.slice(home.length) : p;
-}
-
-function fmtTs(ts?: number): string {
-  if (!ts) return '—';
-  const d = new Date(ts);
-  return d.toISOString().replace('T', ' ').slice(0, 16);
-}
-
-function printTable(header: string[], rows: string[][]): void {
-  const widths = header.map((h, i) => Math.max(h.length, ...rows.map(r => (r[i] || '').length)));
-  const fmt = (cells: string[]) => cells.map((c, i) => (c || '').padEnd(widths[i])).join('  ');
-  // eslint-disable-next-line no-console
-  console.log(fmt(header));
-  // eslint-disable-next-line no-console
-  console.log(widths.map(w => '-'.repeat(w)).join('  '));
-  for (const r of rows) {
-    // eslint-disable-next-line no-console
-    console.log(fmt(r));
-  }
-}