rigjs 4.0.5 → 4.0.7

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));
-  }
-}

package/lib/wiki/register.ts

@@ -1,104 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import print from '../print';
-import {
-  loadRegistry,
-  saveRegistry,
-  loadVaultConfig,
-  saveVaultConfig,
-  VaultConfig,
-} from './config';
-
-interface RegisterOpts {
-  as?: string;
-  force?: boolean;
-}
-
-/**
- * `rig wiki register [path]`
- *
- *   1. Resolve the vault dir (explicit arg, or walk up from CWD looking for
- *      a directory that already has `purpose.md`).
- *   2. Ensure `<vault>/.rig/config.yml` exists. Create it from defaults if
- *      missing; otherwise keep whatever the user authored.
- *   3. Apply the optional `--as <slug>` override to the vault config's name.
- *   4. Append the absolute vault path to `~/.rig/wikis.yml` (the
- *      discovery-only registry). No-op if already present.
- */
-export default function wikiRegister(givenPath: string | undefined, opts: RegisterOpts): void {
-  const vaultPath = path.resolve(givenPath || detectVaultPath(process.cwd()) || process.cwd());
-  if (!fs.existsSync(vaultPath)) {
-    print.error(`path does not exist: ${vaultPath}`);
-    process.exit(1);
-  }
-  if (!fs.existsSync(path.join(vaultPath, 'purpose.md'))) {
-    print.error(`not a wiki vault (no purpose.md): ${vaultPath}`);
-    print.info(`run \`rig wiki init ${shortPath(vaultPath)}\` first.`);
-    process.exit(1);
-  }
-
-  // Load or seed the per-vault config.
-  let vault = loadVaultConfig(vaultPath);
-  if (!vault) {
-    vault = defaultVaultConfig(path.basename(vaultPath));
-  }
-  const desiredName = (opts.as || vault.name || path.basename(vaultPath)).trim();
-  if (!desiredName) {
-    print.error('failed to derive a wiki name; pass --as <slug>');
-    process.exit(1);
-  }
-
-  // Name collision in the registry — surfaced by composing the registry.
-  const reg = loadRegistry();
-  for (const existingPath of reg.wikis) {
-    if (existingPath === vaultPath) continue;
-    const other = loadVaultConfig(existingPath);
-    if (other && other.name === desiredName) {
-      if (!opts.force) {
-        print.error(`wiki "${desiredName}" already registered at ${existingPath}; pass --force to overwrite`);
-        process.exit(1);
-      }
-      // --force: drop the old entry, the new one wins.
-      reg.wikis = reg.wikis.filter(p => p !== existingPath);
-    }
-  }
-
-  vault.name = desiredName;
-  saveVaultConfig(vaultPath, vault);
-
-  if (!reg.wikis.includes(vaultPath)) reg.wikis.push(vaultPath);
-  saveRegistry(reg);
-
-  print.succeed(`registered wiki "${desiredName}" -> ${vaultPath}`);
-}
-
-function detectVaultPath(start: string): string | undefined {
-  const candidates = ['harness/llm-wiki', 'wiki'];
-  let dir = start;
-  while (true) {
-    if (fs.existsSync(path.join(dir, 'purpose.md'))) return dir;
-    for (const c of candidates) {
-      const cand = path.join(dir, c);
-      if (fs.existsSync(path.join(cand, 'purpose.md'))) return cand;
-    }
-    const parent = path.dirname(dir);
-    if (parent === dir) return undefined;
-    dir = parent;
-  }
-}
-
-function defaultVaultConfig(vaultBasename: string): VaultConfig {
-  return {
-    name: vaultBasename,
-    root: '..',
-    include: ['**/*.md'],
-    exclude: [`${vaultBasename}/**`, 'node_modules/**', '.git/**'],
-    schedule: { scan: '0 */6 * * *', lint: '0 3 * * *', ingest: null },
-    ingestRules: [{ match: 'raw/**/*.md', mode: 'auto-on-new' }],
-  };
-}
-
-function shortPath(p: string): string {
-  const home = process.env.HOME || '';
-  return home && p.startsWith(home) ? '~' + p.slice(home.length) : p;
-}

package/lib/wiki/unregister.ts

@@ -1,28 +0,0 @@
-import path from 'path';
-import print from '../print';
-import { loadRegistry, saveRegistry, loadVaultConfig } from './config';
-
-/**
- * `rig wiki unregister <nameOrPath>` — drop a vault path from
- * `~/.rig/wikis.yml`. The vault's own `<vault>/.rig/config.yml` (and the
- * rest of its on-disk contents) is left untouched.
- */
-export default function wikiUnregister(nameOrPath: string): void {
-  const reg = loadRegistry();
-  const targetAbs = path.resolve(nameOrPath);
-  const before = reg.wikis.length;
-
-  reg.wikis = reg.wikis.filter(p => {
-    if (p === targetAbs) return false;
-    const v = loadVaultConfig(p);
-    if (v && v.name === nameOrPath) return false;
-    return true;
-  });
-
-  if (reg.wikis.length === before) {
-    print.error(`no registered wiki matches "${nameOrPath}"`);
-    process.exit(1);
-  }
-  saveRegistry(reg);
-  print.succeed(`unregistered "${nameOrPath}" (disk contents untouched)`);
-}