rigjs/lib/wiki/index.ts

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.

import wikiInit from './init';
import wikiScan from './scan';
import wikiSurvey from './survey';
import wikiSync from './sync';
import wikiFetch from './fetch';
import wikiIngest from './ingest';
import wikiQuery from './query';
import wikiLint from './lint';
import wikiIndex from './indexCmd';
import wikiRebuild from './rebuild';
import wikiInstallSkill from './installSkill';
import wikiUninstallSkill from './uninstallSkill';
import { registerAgentCommands } from './agent';
import { registerDaemonCommands } from './daemon';

// `program` is commander's Command instance. commander@6.1.0 typings are
// inconsistent between `CommanderStatic.Command` (the global `program`) and
// the per-call `Command` returned by `.command()`, so we type loose here to
// match the rest of the codebase.
// eslint-disable-next-line @typescript-eslint/no-explicit-any
export function registerWikiCommands(program: any): void {
  const wiki = program.command('wiki').description('Karpathy-style LLM Wiki ops (macOS only in v1)');

  wiki.command('init [scope]')
    .description('bootstrap a vault under ./rig-wiki/. With no <scope>, the vault covers the whole CWD; with <scope>, only that subdir is scanned. Hidden/.gitignored/binary files are filtered at walk time regardless.')
    .action(wikiInit);

  wiki.command('scan')
    .description('compute NEW/MODIFIED/DELETED/RAW DRIFT report for the vault resolved from CWD')
    .option('-b, --baseline', 'commit current shas into state.db so future scans can detect drift (no wiki content changed)')
    .option('--json', 'machine-readable output')
    .action(wikiScan);

  wiki.command('survey')
    .description('triage candidate files via schema.md "Ingestion policy" — agent decides ingest/skip/unclear per file')
    .option('-a, --apply', 'auto-ingest every "ingest" decision (sequential)')
    .option('-l, --limit <n>', `cap candidates passed to the agent (default 500)`, (v) => parseInt(v, 10))
    .option('--no-agent', 'skip agent classification; accept every non-binary candidate (local rules only)')
    .option('--json', 'machine-readable output')
    .action(wikiSurvey);

  wiki.command('sync')
    .description('one-shot wiki update: scan → ingest NEW + MODIFIED → prune wiki pages for DELETED sources')
    .option('--dry-run', 'print scan diff and what would change without writing anything')
    .option('--no-prune', 'skip the delete step (only ingest NEW + MODIFIED)')
    .option('--json', 'machine-readable output')
    .action(wikiSync);

  wiki.command('fetch <url>')
    .description('verbatim download URL into raw/YYYY-MM-DD-<slug>.md')
    .option('--slug <slug>', 'override the auto-derived slug')
    .option('--via-agent', 'use Claude WebFetch for HTML→md conversion')
    .option('--json', 'machine-readable output')
    .action(wikiFetch);

  wiki.command('ingest <source>')
    .description('two-step CoT ingest of one source (preview diff, then apply)')
    .option('--dry-run', 'print diff but do not apply')
    .option('--json', 'machine-readable output')
    .action(wikiIngest);

  wiki.command('query <q>')
    .description('semantic search — Qwen3 vector + Qwen3 reranker, cross-lingual CN/EN')
    .option('-l, --limit <n>', 'top-k hits (1-50, default 10)', (v) => parseInt(v, 10))
    .option('--no-rerank', 'skip the reranker pass (faster, no reranker model load)')
    .option('-s, --synth', 'use Claude to synthesize a paragraph answer with citations')
    .option('--json', 'machine-readable output')
    .action(wikiQuery);

  wiki.command('lint')
    .description('contradictions / orphans / stale claims / broken refs')
    .option('--json', 'machine-readable output')
    .action(wikiLint);

  wiki.command('index')
    .description('build/refresh qmd vector index (incremental by default)')
    .option('-f, --force', 'force full re-embed (use after switching embed models)')
    .action(wikiIndex);

  wiki.command('rebuild')
    .description('refresh local caches (sha index + qmd vectors) — for new devices or after switching embed models')
    .option('--skip-embed', 'only clear ~/.rig/state.db rows, do not touch qmd at all')
    .action(wikiRebuild);

  wiki.command('install-skill')
    .description('symlink bundled rig-wiki + rig-crew skills into ~/.claude/skills/ (or --project for the local project)')
    .option('-f, --force', 'replace an existing symlink')
    .option('-p, --project', 'install into <cwd>/.claude/skills/ and <cwd>/.agents/skills/ (project-level override for Claude Code + Codex)')
    .action(wikiInstallSkill);

  wiki.command('uninstall-skill')
    .description('remove the bundled skill symlinks (default: global; pass --project for the local project)')
    .option('-p, --project', 'uninstall from <cwd>/.claude/skills/ and <cwd>/.agents/skills/')
    .action(wikiUninstallSkill);

  registerAgentCommands(wiki);
  registerDaemonCommands(wiki);
}