skillwiki 0.2.0-beta.20 → 0.2.0-beta.23

package/dist/cli.js

@@ -71,7 +71,8 @@ var ExitCode = {
   ARCHIVE_ALREADY_ARCHIVED: 31,
   DRIFT_DETECTED: 32,
   RAW_DEDUP_DETECTED: 33,
-  MIGRATION_APPLIED: 34
+  MIGRATION_APPLIED: 34,
+  UNKNOWN_WIKI_PROFILE: 35
 };
 
 // ../shared/src/json-output.ts
@@ -504,6 +505,16 @@ import { readFile as readFile4, writeFile as writeFile2, mkdir as mkdir2 } from
 import { dirname as dirname2 } from "path";
 var CONFIG_KEYS = ["WIKI_PATH", "WIKI_LANG"];
 var _whitelist = new Set(CONFIG_KEYS);
+var PROFILE_PATH_RE = /^WIKI_([A-Z][A-Z0-9_]{0,31})_PATH$/;
+var PROFILE_LANG_RE = /^WIKI_([A-Z][A-Z0-9_]{0,31})_LANG$/;
+var PROFILE_DEFAULT_RE = /^WIKI_DEFAULT$/;
+function isValidWikiProfileKey(key) {
+  if (key === "WIKI_PATH" || key === "WIKI_LANG") return false;
+  return PROFILE_PATH_RE.test(key) || PROFILE_LANG_RE.test(key) || PROFILE_DEFAULT_RE.test(key);
+}
+function profileKey(name, suffix) {
+  return `WIKI_${name.toUpperCase().replace(/-/g, "_").replace(/[^A-Z0-9_]/g, "")}_${suffix}`;
+}
 function parseDotenvText(text) {
   const out = {};
   for (const rawLine of text.split(/\r?\n/)) {
@@ -513,7 +524,7 @@ function parseDotenvText(text) {
     if (eq <= 0) continue;
     const key = line.slice(0, eq).trim();
     const value = line.slice(eq + 1).trim();
-    if (!_whitelist.has(key)) continue;
+    if (!_whitelist.has(key) && !isValidWikiProfileKey(key)) continue;
     if (value.length === 0) continue;
     out[key] = value;
   }
@@ -598,6 +609,14 @@ async function resolveInitTimePath(input) {
     return { path: hermes.WIKI_PATH, source: "hermes-dotenv", ...input.explain ? { chain } : {} };
   }
   if (input.explain) chain.push({ source: "hermes-dotenv", matched: false });
+  if (input.cwd) {
+    const projCfg = await parseDotenvFile(join2(input.cwd, ".skillwiki", ".env"));
+    if (projCfg.WIKI_PATH !== void 0) {
+      if (input.explain) chain.push({ source: "project-dotenv", matched: true, value: projCfg.WIKI_PATH });
+      return { path: projCfg.WIKI_PATH, source: "project-dotenv", ...input.explain ? { chain } : {} };
+    }
+  }
+  if (input.explain) chain.push({ source: "project-dotenv", matched: false });
   const fallback = join2(input.home, "wiki");
   if (input.explain) chain.push({ source: "default", matched: true, value: fallback });
   return { path: fallback, source: "default", ...input.explain ? { chain } : {} };
@@ -609,15 +628,73 @@ async function resolveRuntimePath(input) {
     return ok({ path: input.flag, source: "flag", ...input.explain ? { chain } : {} });
   }
   if (input.explain) chain.push({ source: "flag", matched: false });
+  const swGlobal = await parseDotenvFile(join2(input.home, ".skillwiki", ".env"));
+  const wikiName = input.wiki;
+  if (wikiName !== void 0 && wikiName.length > 0) {
+    if (wikiName.toLowerCase() === "default") {
+      const path2 = swGlobal.WIKI_PATH;
+      if (path2 !== void 0) {
+        if (input.explain) chain.push({ source: "wiki-profile", matched: true, value: path2 });
+        return ok({ path: path2, source: "skillwiki-dotenv", ...input.explain ? { chain } : {} });
+      }
+      if (input.explain) chain.push({ source: "wiki-profile", matched: false });
+      return err("UNKNOWN_WIKI_PROFILE", {
+        message: `Wiki profile "default" not found. Set it with: skillwiki config set wiki.path <dir>`
+      });
+    }
+    const key = profileKey(wikiName, "PATH");
+    const path = swGlobal[key];
+    if (path !== void 0) {
+      if (input.explain) chain.push({ source: "wiki-profile", matched: true, value: path });
+      return ok({ path, source: "wiki-profile", ...input.explain ? { chain } : {} });
+    }
+    if (input.explain) chain.push({ source: "wiki-profile", matched: false });
+    return err("UNKNOWN_WIKI_PROFILE", {
+      message: `Wiki profile "${wikiName}" not found. Set it with: skillwiki config set wiki.${wikiName}.path <dir>`
+    });
+  }
+  if (input.wikiEnv !== void 0 && input.wikiEnv.length > 0) {
+    const key = profileKey(input.wikiEnv, "PATH");
+    const path = swGlobal[key];
+    if (path !== void 0) {
+      if (input.explain) chain.push({ source: "wiki-profile", matched: true, value: path });
+      return ok({ path, source: "wiki-profile", ...input.explain ? { chain } : {} });
+    }
+    if (input.explain) chain.push({ source: "wiki-profile", matched: false });
+    return err("UNKNOWN_WIKI_PROFILE", {
+      message: `Wiki profile "${input.wikiEnv}" not found (from $WIKI env). Set it with: skillwiki config set wiki.${input.wikiEnv}.path <dir>`
+    });
+  }
+  if (input.explain) chain.push({ source: "wiki-profile", matched: false });
   if (input.envValue !== void 0 && input.envValue.length > 0) {
     if (input.explain) chain.push({ source: "env", matched: true, value: input.envValue });
     return ok({ path: input.envValue, source: "env", ...input.explain ? { chain } : {} });
   }
   if (input.explain) chain.push({ source: "env", matched: false });
-  const sw = await parseDotenvFile(join2(input.home, ".skillwiki", ".env"));
-  if (sw.WIKI_PATH !== void 0) {
-    if (input.explain) chain.push({ source: "skillwiki-dotenv", matched: true, value: sw.WIKI_PATH });
-    return ok({ path: sw.WIKI_PATH, source: "skillwiki-dotenv", ...input.explain ? { chain } : {} });
+  if (input.cwd) {
+    const projCfg = await parseDotenvFile(join2(input.cwd, ".skillwiki", ".env"));
+    if (projCfg.WIKI_PATH !== void 0) {
+      if (input.explain) chain.push({ source: "project-dotenv", matched: true, value: projCfg.WIKI_PATH });
+      return ok({ path: projCfg.WIKI_PATH, source: "project-dotenv", ...input.explain ? { chain } : {} });
+    }
+    if (input.explain) chain.push({ source: "project-dotenv", matched: false });
+  }
+  const defaultProfile = swGlobal["WIKI_DEFAULT"];
+  if (defaultProfile !== void 0) {
+    const key = profileKey(defaultProfile, "PATH");
+    const path = swGlobal[key];
+    if (path !== void 0) {
+      if (input.explain) chain.push({ source: "wiki-default", matched: true, value: path });
+      return ok({ path, source: "wiki-default", ...input.explain ? { chain } : {} });
+    }
+    if (input.explain) chain.push({ source: "wiki-default", matched: false });
+    return err("UNKNOWN_WIKI_PROFILE", {
+      message: `Default wiki profile "${defaultProfile}" not found. Set it with: skillwiki config set wiki.${defaultProfile}.path <dir>`
+    });
+  }
+  if (swGlobal.WIKI_PATH !== void 0) {
+    if (input.explain) chain.push({ source: "skillwiki-dotenv", matched: true, value: swGlobal.WIKI_PATH });
+    return ok({ path: swGlobal.WIKI_PATH, source: "skillwiki-dotenv", ...input.explain ? { chain } : {} });
   }
   if (input.explain) chain.push({ source: "skillwiki-dotenv", matched: false });
   return err("NO_VAULT_CONFIGURED", {
@@ -631,8 +708,11 @@ async function runOrphans(input) {
   if (input.vault) {
     vault = input.vault;
   } else {
-    const r = await resolveRuntimePath({ flag: void 0, envValue: input.envValue, home: input.home ?? "" });
-    if (!r.ok) return { exitCode: ExitCode.NO_VAULT_CONFIGURED, result: r };
+    const r = await resolveRuntimePath({ flag: void 0, envValue: input.envValue, home: input.home ?? "", wiki: input.wiki });
+    if (!r.ok) {
+      const exitCode = r.error === "UNKNOWN_WIKI_PROFILE" ? ExitCode.UNKNOWN_WIKI_PROFILE : ExitCode.NO_VAULT_CONFIGURED;
+      return { exitCode, result: r };
+    }
     vault = r.data.path;
   }
   const scan = await scanVault(vault);
@@ -953,9 +1033,13 @@ async function runPath(input) {
     flag: input.flag,
     envValue: input.envValue,
     home: input.home,
+    wiki: input.wiki,
     explain: input.explain
   });
-  if (!r.ok) return { exitCode: ExitCode.NO_VAULT_CONFIGURED, result: r };
+  if (!r.ok) {
+    const exitCode = r.error === "UNKNOWN_WIKI_PROFILE" ? ExitCode.UNKNOWN_WIKI_PROFILE : ExitCode.NO_VAULT_CONFIGURED;
+    return { exitCode, result: r };
+  }
   return { exitCode: ExitCode.OK, result: ok({ path: r.data.path, source: r.data.source, ...r.data.chain ? { chain: r.data.chain } : {}, humanHint: `${r.data.path} (via ${r.data.source})` }) };
 }
 
@@ -1124,13 +1208,13 @@ async function runInit(input) {
   }
   const existingEnv = parseDotenvText(existingEnvRaw);
   const swDotenvHadPath = existingEnv.WIKI_PATH !== void 0;
-  if (existingEnv.WIKI_PATH !== void 0 && existingEnv.WIKI_PATH !== target && !input.force) {
+  if (!input.profile && existingEnv.WIKI_PATH !== void 0 && existingEnv.WIKI_PATH !== target && !input.force) {
     return {
       exitCode: ExitCode.ENV_WRITE_CONFLICT,
       result: err("ENV_WRITE_CONFLICT", { key: "WIKI_PATH", existing: existingEnv.WIKI_PATH, attempted: target })
     };
   }
-  if (existingEnv.WIKI_LANG !== void 0 && existingEnv.WIKI_LANG !== canonicalLang && !input.force) {
+  if (!input.profile && existingEnv.WIKI_LANG !== void 0 && existingEnv.WIKI_LANG !== canonicalLang && !input.force) {
     return {
       exitCode: ExitCode.ENV_WRITE_CONFLICT,
       result: err("ENV_WRITE_CONFLICT", { key: "WIKI_LANG", existing: existingEnv.WIKI_LANG, attempted: canonicalLang })
@@ -1209,7 +1293,16 @@ async function runInit(input) {
   let envWritten = "";
   if (!skipEnv) {
     try {
-      await writeDotenv(envPath, { WIKI_PATH: target, WIKI_LANG: canonicalLang }, existingEnvRaw);
+      const envEntries = {};
+      if (input.profile) {
+        envEntries[profileKey(input.profile, "PATH")] = target;
+        envEntries[profileKey(input.profile, "LANG")] = canonicalLang;
+        envEntries["WIKI_DEFAULT"] = input.profile;
+      } else {
+        envEntries["WIKI_PATH"] = target;
+        envEntries["WIKI_LANG"] = canonicalLang;
+      }
+      await writeDotenv(envPath, envEntries, existingEnvRaw);
       envWritten = envPath;
     } catch (e) {
       return { exitCode: ExitCode.WRITE_FAILED, result: err("WRITE_FAILED", { file: envPath, message: String(e) }) };
@@ -1525,8 +1618,19 @@ async function runDedup(input) {
 // src/commands/lint.ts
 var STRUCT_MIN_BODY_LINES = 60;
 var STRUCT_MIN_SECTIONS = 3;
+function hasDuplicateFrontmatter(body) {
+  if (/^---\r?\n/.test(body)) return true;
+  const lines = body.split(/\r?\n/);
+  const limit = Math.min(lines.length, 20);
+  let seenYamlKey = false;
+  for (let i = 0; i < limit; i++) {
+    if (/^\w[\w-]*:/.test(lines[i].trim())) seenYamlKey = true;
+    if (seenYamlKey && lines[i].trim() === "---") return true;
+  }
+  return false;
+}
 var ERROR_ORDER = ["broken_wikilinks", "invalid_frontmatter", "raw_dedup", "tag_not_in_taxonomy"];
-var WARNING_ORDER = ["index_incomplete", "index_link_format", "stale_page", "page_too_large", "log_rotate_needed", "contested", "orphans", "legacy_citation_style", "orphaned_citations"];
+var WARNING_ORDER = ["index_incomplete", "index_link_format", "stale_page", "page_too_large", "log_rotate_needed", "contested", "orphans", "legacy_citation_style", "orphaned_citations", "duplicate_frontmatter"];
 var INFO_ORDER = ["bridges", "low_confidence_single_source", "page_structure", "topic_map_recommended"];
 async function runLint(input) {
   const buckets = {};
@@ -1575,11 +1679,13 @@ async function runLint(input) {
     const legacyPages = [];
     const orphanedPages = [];
     const structFlags = [];
+    const dupFrontmatter = [];
     for (const page of scan.data.typedKnowledge) {
       const text = await readPage(page);
       const split = splitFrontmatter(text);
       if (!split.ok) continue;
       const body = split.data.body;
+      if (hasDuplicateFrontmatter(body)) dupFrontmatter.push(page.relPath);
       if (isLegacyCitationStyle(body)) legacyPages.push(page.relPath);
       if (hasOrphanedCitations(body)) orphanedPages.push(page.relPath);
       const bodyLines = body.split("\n").filter((l) => l.trim().length > 0).length;
@@ -1599,6 +1705,7 @@ async function runLint(input) {
     if (legacyPages.length > 0) buckets.legacy_citation_style = legacyPages;
     if (orphanedPages.length > 0) buckets.orphaned_citations = orphanedPages;
     if (structFlags.length > 0) buckets.page_structure = structFlags;
+    if (dupFrontmatter.length > 0) buckets.duplicate_frontmatter = dupFrontmatter;
   }
   const errorOut = ERROR_ORDER.flatMap((k) => buckets[k] ? [{ kind: k, items: buckets[k] }] : []);
   const warningOut = WARNING_ORDER.flatMap((k) => buckets[k] ? [{ kind: k, items: buckets[k] }] : []);
@@ -1636,7 +1743,7 @@ import { readFile as readFile12 } from "fs/promises";
 import { existsSync } from "fs";
 import { join as join13 } from "path";
 function validateKey(key) {
-  return CONFIG_KEYS.includes(key);
+  return CONFIG_KEYS.includes(key) || isValidWikiProfileKey(key);
 }
 function configPath(home) {
   return join13(home, ".skillwiki", ".env");
@@ -1671,7 +1778,21 @@ async function runConfigSet(input) {
 async function runConfigList(input) {
   const map = await parseDotenvFile(configPath(input.home));
   const entries = Object.entries(map).map(([key, value]) => ({ key, value: value ?? "" }));
-  return { exitCode: ExitCode.OK, result: ok({ entries, humanHint: entries.map((e) => `${e.key}=${e.value}`).join("\n") }) };
+  let profiles;
+  if (input.profiles) {
+    const defaultProfile = map["WIKI_DEFAULT"];
+    profiles = [];
+    for (const key of Object.keys(map)) {
+      const m = key.match(/^WIKI_([A-Z][A-Z0-9_]{0,31})_PATH$/);
+      if (m && key !== "WIKI_PATH") {
+        const name = m[1].toLowerCase().replace(/_/g, "-");
+        profiles.push({ name, path: map[key] ?? "", isDefault: name === defaultProfile });
+      }
+    }
+    profiles.sort((a, b) => a.name.localeCompare(b.name));
+  }
+  const hint = profiles ? profiles.map((p) => `${p.isDefault ? "* " : "  "}${p.name} \u2192 ${p.path}`).join("\n") || "(no profiles)" : entries.map((e) => `${e.key}=${e.value}`).join("\n");
+  return { exitCode: ExitCode.OK, result: ok({ entries, profiles, humanHint: hint }) };
 }
 async function runConfigPath(input) {
   const filePath = configPath(input.home);
@@ -1855,6 +1976,34 @@ function checkPluginVersionDrift(home, currentVersion) {
     return check("pass", "plugin_version_drift", "Plugin/CLI version", "Could not read plugin cache");
   }
 }
+async function checkProfiles(home) {
+  const map = await parseDotenvFile(configPath(home));
+  const profiles = [];
+  for (const key of Object.keys(map)) {
+    if (key.startsWith("WIKI_") && key.endsWith("_PATH") && key !== "WIKI_PATH") {
+      const name = key.slice(5, -5).toLowerCase().replace(/_/g, "-");
+      profiles.push(name);
+    }
+  }
+  if (profiles.length === 0) {
+    return check("pass", "wiki_profiles", "Wiki profiles", "No named profiles configured");
+  }
+  const defaultProfile = map["WIKI_DEFAULT"] ?? "(none)";
+  return check(
+    "pass",
+    "wiki_profiles",
+    "Wiki profiles",
+    `${profiles.length} profile(s): ${profiles.join(", ")}; default: ${defaultProfile}`
+  );
+}
+async function checkProjectLocalOverride(cwd) {
+  const dir = cwd ?? process.cwd();
+  const envPath = join15(dir, ".skillwiki", ".env");
+  if (existsSync3(envPath)) {
+    return check("pass", "project_local", "Project-local config", `Found: ${envPath}`);
+  }
+  return check("pass", "project_local", "Project-local config", "None");
+}
 function findSkillMd(dir) {
   const results = [];
   let entries;
@@ -1877,6 +2026,8 @@ async function runDoctor(input) {
   checks.push(checkNodeVersion());
   checks.push(checkCliOnPath(input.argv));
   checks.push(await checkConfigFile(input.home));
+  checks.push(await checkProfiles(input.home));
+  checks.push(await checkProjectLocalOverride(input.cwd));
   const resolved = await resolveRuntimePath({ flag: void 0, envValue: input.envValue, home: input.home });
   if (resolved.ok) {
     checks.push(check("pass", "wiki_path_set", "WIKI_PATH configured", `Resolved via ${resolved.data.source}: ${resolved.data.path}`));
@@ -2243,19 +2394,20 @@ function emit(r) {
 program.command("hash <file>").action(async (file) => emit(await runHash({ file })));
 program.command("fetch-guard <url>").action(async (url) => emit(await runFetchGuard({ url })));
 program.command("validate <file>").action(async (file) => emit(await runValidate({ file })));
-program.command("graph").description("graph subcommands").command("build <vault>").option("--out <path>", "graph output path", ".skillwiki/graph.json").action(async (vault, opts) => emit(await runGraphBuild({ vault, out: opts.out })));
+program.command("graph").description("graph subcommands").command("build <vault>").option("--out <path>", "graph output path", ".skillwiki/graph.json").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => emit(await runGraphBuild({ vault, out: opts.out })));
 program.command("overlap <vault>").action(async (vault) => emit(await runOverlap({ vault })));
-program.command("orphans [vault]").action(async (vault) => emit(await runOrphans({
+program.command("orphans [vault]").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => emit(await runOrphans({
   vault,
   envValue: process.env.WIKI_PATH,
-  home: process.env.HOME ?? ""
+  home: process.env.HOME ?? "",
+  wiki: opts.wiki
 })));
 program.command("audit <file>").action(async (file) => emit(await runAudit({ file })));
 program.command("install").option("--target <dir>", "target install directory", `${process.env.HOME ?? ""}/.claude/skills/`).option("--dry-run", "preview only", false).option("--skills-root <dir>", "source skills directory (defaults to packaged)").action(async (opts) => {
   const skillsRoot = opts.skillsRoot ?? new URL("../skills/", import.meta.url).pathname;
   emit(await runInstall({ skillsRoot, target: opts.target, dryRun: !!opts.dryRun }));
 });
-program.command("path").option("--vault <dir>", "explicit vault override (runtime)").option("--target <dir>", "explicit target override (init-time)").option("--init-time", "use init-time chain instead of runtime", false).option("--explain", "include resolution chain in output", false).action(async (opts) => {
+program.command("path").option("--vault <dir>", "explicit vault override (runtime)").option("--target <dir>", "explicit target override (init-time)").option("--wiki <name>", "wiki profile name").option("--init-time", "use init-time chain instead of runtime", false).option("--explain", "include resolution chain in output", false).action(async (opts) => {
   const initTime = !!opts.initTime;
   const flag = initTime ? opts.target : opts.vault;
   emit(await runPath({
@@ -2263,6 +2415,7 @@ program.command("path").option("--vault <dir>", "explicit vault override (runtim
     envValue: process.env.WIKI_PATH,
     home: process.env.HOME ?? "",
     initTime,
+    wiki: opts.wiki,
     explain: !!opts.explain
   }));
 });
@@ -2274,7 +2427,7 @@ program.command("lang").option("--lang <code>", "explicit language override").op
     explain: !!opts.explain
   }));
 });
-program.command("init").option("--target <dir>", "explicit target directory").requiredOption("--domain <text>", "knowledge domain seed").option("--taxonomy <csv>", "comma-separated tag list").option("--lang <code>", "output language (BCP 47 or alias)").option("--force", "override existing target / env conflict", false).option("--no-env", "skip writing ~/.skillwiki/.env").action(async (opts) => {
+program.command("init").option("--target <dir>", "explicit target directory").requiredOption("--domain <text>", "knowledge domain seed").option("--taxonomy <csv>", "comma-separated tag list").option("--lang <code>", "output language (BCP 47 or alias)").option("--force", "override existing target / env conflict", false).option("--no-env", "skip writing ~/.skillwiki/.env").option("--profile <name>", "write as named wiki profile instead of WIKI_PATH").action(async (opts) => {
   const templates = new URL("../templates/", import.meta.url).pathname;
   const taxonomy = typeof opts.taxonomy === "string" ? opts.taxonomy.split(",").map((s) => s.trim()).filter((s) => s.length > 0) : void 0;
   emit(await runInit({
@@ -2286,51 +2439,57 @@ program.command("init").option("--target <dir>", "explicit target directory").re
     taxonomy,
     lang: opts.lang,
     force: !!opts.force,
-    noEnv: opts.env === false
+    noEnv: opts.env === false,
+    profile: opts.profile
   }));
 });
-async function resolveVaultArg(arg) {
+async function resolveVaultArg(arg, wiki) {
   if (arg) return { ok: true, vault: arg };
   const r = await resolveRuntimePath({
     flag: void 0,
     envValue: process.env.WIKI_PATH,
-    home: process.env.HOME ?? ""
+    wikiEnv: process.env.WIKI,
+    home: process.env.HOME ?? "",
+    wiki
   });
-  if (!r.ok) return { ok: false, exitCode: 25, payload: r };
+  if (!r.ok) {
+    const exitCode = r.error === "UNKNOWN_WIKI_PROFILE" ? 35 : 25;
+    return { ok: false, exitCode, payload: r };
+  }
   return { ok: true, vault: r.data.path };
 }
-program.command("links [vault]").action(async (vault) => {
-  const v = await resolveVaultArg(vault);
+program.command("links [vault]").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+  const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runLinks({ vault: v.vault }));
 });
-program.command("tag-audit [vault]").action(async (vault) => {
-  const v = await resolveVaultArg(vault);
+program.command("tag-audit [vault]").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+  const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runTagAudit({ vault: v.vault }));
 });
-program.command("index-check [vault]").action(async (vault) => {
-  const v = await resolveVaultArg(vault);
+program.command("index-check [vault]").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+  const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runIndexCheck({ vault: v.vault }));
 });
-program.command("stale [vault]").option("--days <n>", "staleness threshold in days", (s) => parseInt(s, 10), 90).action(async (vault, opts) => {
-  const v = await resolveVaultArg(vault);
+program.command("stale [vault]").option("--days <n>", "staleness threshold in days", (s) => parseInt(s, 10), 90).option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+  const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runStale({ vault: v.vault, days: opts.days }));
 });
-program.command("pagesize [vault]").option("--lines <n>", "max body lines", (s) => parseInt(s, 10), 200).action(async (vault, opts) => {
-  const v = await resolveVaultArg(vault);
+program.command("pagesize [vault]").option("--lines <n>", "max body lines", (s) => parseInt(s, 10), 200).option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+  const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runPagesize({ vault: v.vault, lines: opts.lines }));
 });
-program.command("log-rotate [vault]").option("--threshold <n>", "entry count threshold", (s) => parseInt(s, 10), 500).option("--apply", "actually rotate", false).action(async (vault, opts) => {
-  const v = await resolveVaultArg(vault);
+program.command("log-rotate [vault]").option("--threshold <n>", "entry count threshold", (s) => parseInt(s, 10), 500).option("--apply", "actually rotate", false).option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+  const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runLogRotate({ vault: v.vault, threshold: opts.threshold, apply: !!opts.apply }));
 });
-program.command("lint [vault]").option("--days <n>", "stale threshold", (s) => parseInt(s, 10), 90).option("--lines <n>", "pagesize threshold", (s) => parseInt(s, 10), 200).option("--log-threshold <n>", "log rotation threshold", (s) => parseInt(s, 10), 500).action(async (vault, opts) => {
-  const v = await resolveVaultArg(vault);
+program.command("lint [vault]").option("--days <n>", "stale threshold", (s) => parseInt(s, 10), 90).option("--lines <n>", "pagesize threshold", (s) => parseInt(s, 10), 200).option("--log-threshold <n>", "log rotation threshold", (s) => parseInt(s, 10), 500).option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+  const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runLint({
     vault: v.vault,
@@ -2343,31 +2502,32 @@ program.command("lint [vault]").option("--days <n>", "stale threshold", (s) => p
 var configCmd = program.command("config").description("manage skillwiki configuration");
 configCmd.command("get <key>").description("print the value of a config key").action(async (key) => emit(await runConfigGet({ key, home: process.env.HOME ?? "" })));
 configCmd.command("set <key> <value>").description("set a config key value").action(async (key, value) => emit(await runConfigSet({ key, value, home: process.env.HOME ?? "" })));
-configCmd.command("list").description("list all config key=value pairs").action(async () => emit(await runConfigList({ home: process.env.HOME ?? "" })));
+configCmd.command("list").option("--profiles", "show wiki profiles summary", false).description("list all config key=value pairs").action(async (opts) => emit(await runConfigList({ home: process.env.HOME ?? "", profiles: !!opts.profiles })));
 configCmd.command("path").description("print the config file path").action(async () => emit(await runConfigPath({ home: process.env.HOME ?? "" })));
 program.command("doctor").description("diagnose skillwiki setup issues").action(async () => emit(await runDoctor({
   home: process.env.HOME ?? "",
   envValue: process.env.WIKI_PATH,
   argv: process.argv,
-  currentVersion: pkg.version
+  currentVersion: pkg.version,
+  cwd: process.cwd()
 })));
-program.command("archive <page> [vault]").description("archive a typed-knowledge page").action(async (page, vault) => {
-  const v = await resolveVaultArg(vault);
+program.command("archive <page> [vault]").description("archive a typed-knowledge page").option("--wiki <name>", "wiki profile name").action(async (page, vault, opts) => {
+  const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runArchive({ vault: v.vault, page }));
 });
-program.command("drift [vault]").description("detect content drift in raw sources").action(async (vault) => {
-  const v = await resolveVaultArg(vault);
+program.command("drift [vault]").description("detect content drift in raw sources").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+  const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runDrift({ vault: v.vault }));
 });
-program.command("dedup [vault]").description("detect duplicate raw sources by sha256").action(async (vault) => {
-  const v = await resolveVaultArg(vault);
+program.command("dedup [vault]").description("detect duplicate raw sources by sha256").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+  const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runDedup({ vault: v.vault }));
 });
-program.command("migrate-citations [vault]").description("migrate ^[raw/...] markers to paragraph-end citations").option("--dry-run", "preview changes without writing", false).action(async (vault, opts) => {
-  const v = await resolveVaultArg(vault);
+program.command("migrate-citations [vault]").description("migrate ^[raw/...] markers to paragraph-end citations").option("--dry-run", "preview changes without writing", false).option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+  const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runMigrateCitations({ vault: v.vault, dryRun: !!opts.dryRun }));
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.2.0-beta.20",
+  "version": "0.2.0-beta.23",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"
@@ -15,7 +15,8 @@
     "build": "tsup && rm -rf ./skills && cp -r ../skills ./skills",
     "test": "vitest run",
     "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "commander": "^12.1.0",

package/skills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.2.0-beta.20",
+  "version": "0.2.0-beta.23",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 11 prompt-only skills (wiki-*, proj-*, using-skillwiki) backed by the deterministic `skillwiki` CLI (8 subcommands, JSON-by-default).",
   "author": {

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.2.0-beta.20",
+  "version": "0.2.0-beta.23",
   "private": true,
   "files": [
     "wiki-*",

package/skills/using-skillwiki/SKILL.md

@@ -88,3 +88,15 @@ Run `skillwiki doctor` to diagnose setup issues. Run `skillwiki config list` to
 For longer-running project work, use `proj-init` → `proj-work` → `proj-distill` / `proj-decide`.
 
 Maintenance: **Archive** (`wiki-archive`) superseded pages, **Drift** (`wiki-reingest`) to detect stale sources, **Adapter** (`wiki-adapter-prd`) for foreign PRD format ingestion.
+
+## Multi-Wiki Profiles
+
+skillwiki supports named wiki profiles for working with multiple vaults. Set `WIKI_DEFAULT` to control which wiki all skills target by default.
+
+**Manage profiles:**
+- `skillwiki config set wiki.<name>.path <dir>` — register a profile
+- `skillwiki config set default <name>` — set active profile
+- `skillwiki config list --profiles` — list all profiles
+- `skillwiki --wiki <name> lint` — override per-command
+
+**Project-local override:** Place a `./skillwiki/.env` in a project root to bind that project to a specific wiki. Skills will use it automatically when running from that directory.