@iowarp/clio-coder 0.4.1 → 0.4.2

package/dist/{chunk-QTFGO774.js → chunk-XQRY4DTA.js}

@@ -3,7 +3,7 @@ import {
   ensureYaziProfile,
   resetYaziProfile,
   yaziProfileDir
-} from "./chunk-J5LZHVIT.js";
+} from "./chunk-3M6DQK6S.js";
 import {
   normalizedSkillHash,
   stripProvenanceFrontmatter
@@ -16,11 +16,14 @@ import {
 } from "./chunk-QDC3K2U3.js";
 import {
   initializeClioHome
-} from "./chunk-7PWAODYW.js";
+} from "./chunk-I7XBWTYH.js";
+import {
+  INTEROP_AGENT_KINDS
+} from "./chunk-IHXBNWMM.js";
 import {
   settingsPath,
   withSettingsLock
-} from "./chunk-EIMVLWB3.js";
+} from "./chunk-34BHNEE3.js";
 import {
   resolvePackageRoot
 } from "./chunk-IWHMRKLL.js";
@@ -99,6 +102,7 @@ import {
   statSync,
   writeFileSync as writeFileSync2
 } from "node:fs";
+import { homedir } from "node:os";
 import path from "node:path";
 var LEGACY_SKILL_NAMES = [
   ["clio-dev", "clio-coder-dev"],
@@ -246,8 +250,13 @@ function collectSkillFiles(root, current = root) {
 function inspectSkillMetadataNaming(options = {}) {
   const cwd = options.cwd ?? process.cwd();
   const configDir = options.configDir ?? resolveClioDirs().config;
-  const roots = [path.join(configDir, "skills"), path.join(cwd, ".clio-coder", "skills")];
-  return roots.flatMap(
+  const home = options.home ?? homedir();
+  const roots = /* @__PURE__ */ new Set([path.join(configDir, "skills"), path.join(cwd, ".clio-coder", "skills")]);
+  for (const kind of INTEROP_AGENT_KINDS) {
+    if (kind.userSkillRoot !== void 0) roots.add(path.join(home, kind.userSkillRoot));
+    if (kind.projectSkillRoot !== void 0) roots.add(path.join(cwd, kind.projectSkillRoot));
+  }
+  return [...roots].flatMap(
     (root) => collectSkillFiles(root).map((file) => ({
       path: file,
       legacyMetadataKey: /^clio:\s*(?:#.*)?$/mu.test(readFileSync2(file, "utf8"))
@@ -405,10 +414,14 @@ function regenerateYaziNamingProfile(options = {}) {
   const cacheDir = options.cacheDir ?? resolveClioDirs().cache;
   const before = inspectYaziNaming(cacheDir);
   if (!before.present) {
-    return { ...before, status: "absent", detail: "managed Yazi profile is absent; next open writes canonical names" };
+    return {
+      ...before,
+      status: "absent",
+      detail: "managed files pane profile is absent; next open writes canonical names"
+    };
   }
   if (before.legacyEvents === 0 && before.legacyEnvironmentNames === 0) {
-    return { ...before, status: "canonical", detail: "managed Yazi profile already uses canonical names" };
+    return { ...before, status: "canonical", detail: "managed files pane profile already uses canonical names" };
   }
   const yaziPath = options.yaziPath === void 0 ? resolveToolBinary("yazi").binaryPath : options.yaziPath;
   const yaPath = options.yaPath === void 0 ? resolveToolBinary("ya").binaryPath : options.yaPath;
@@ -417,7 +430,7 @@ function regenerateYaziNamingProfile(options = {}) {
     return {
       ...before,
       status: "removed-unresolved",
-      detail: "legacy managed profile removed; Yazi/ya is unresolved, so the next managed open will regenerate it"
+      detail: "legacy managed profile removed; the files pane engine is unresolved, so the next managed open will regenerate it"
     };
   }
   const profile = ensureYaziProfile({ yaziPath, yaPath, profileDir: before.profileDir });
@@ -425,10 +438,10 @@ function regenerateYaziNamingProfile(options = {}) {
     return {
       ...before,
       status: "regeneration-failed",
-      detail: "legacy managed profile removed, but current Yazi rejected the regenerated profile"
+      detail: "legacy managed profile removed, but the files pane engine rejected the regenerated profile"
     };
   }
-  return { ...before, status: "regenerated", detail: "managed Yazi profile regenerated with canonical names" };
+  return { ...before, status: "regenerated", detail: "managed files pane profile regenerated with canonical names" };
 }
 
 // src/domains/lifecycle/migrations/2026-09-01-clio-coder-naming.ts
@@ -641,4 +654,4 @@ export {
   migrateNamingSettingsFile,
   clio_coder_naming_default
 };
-//# sourceMappingURL=chunk-QTFGO774.js.map
+//# sourceMappingURL=chunk-XQRY4DTA.js.map

package/dist/{chunk-BJGUKIG4.js → chunk-YJISEZKC.js}

@@ -3,7 +3,7 @@ import {
   describeYaziProfile,
   inspectCurrentYaziProfile,
   resetYaziProfile
-} from "./chunk-J5LZHVIT.js";
+} from "./chunk-3M6DQK6S.js";
 import {
   installTool,
   installedToolVersions,
@@ -299,4 +299,4 @@ function jsonShape(status) {
 export {
   runToolsCommand
 };
-//# sourceMappingURL=chunk-BJGUKIG4.js.map
+//# sourceMappingURL=chunk-YJISEZKC.js.map

package/dist/{chunk-GPPB3JBE.js → chunk-ZGNYYXQ6.js}

@@ -2,7 +2,7 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   parseJsonObjectPayload,
   parseVerifierResult
-} from "./chunk-IG7BCQBA.js";
+} from "./chunk-PGF63K6I.js";
 import {
   atomicWrite
 } from "./chunk-MQXIVJ35.js";
@@ -685,4 +685,4 @@ export {
   readGateDecisionArtifacts,
   readGateDecisionArtifactsForRunIds
 };
-//# sourceMappingURL=chunk-GPPB3JBE.js.map
+//# sourceMappingURL=chunk-ZGNYYXQ6.js.map

package/dist/{chunk-SINK3QR6.js → chunk-ZNT2M6TG.js}

@@ -1,7 +1,7 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   parseAgentRecipeSchema
-} from "./chunk-ZJLUDYFY.js";
+} from "./chunk-CRFOIAX3.js";
 import {
   discoverMarketplaceSkills,
   expandSkillInvocationInput,
@@ -9,7 +9,7 @@ import {
   loadSkills,
   parsePendingSkillRequests,
   projectCompatTrusted
-} from "./chunk-HUAS7ITX.js";
+} from "./chunk-O3YUNJZ2.js";
 import {
   normalizedSkillHash
 } from "./chunk-NDDGJUXD.js";
@@ -19,24 +19,24 @@ import {
   sourceInfoForRoot,
   splitYamlFrontmatter,
   stringField
-} from "./chunk-FEFIFZTL.js";
+} from "./chunk-XGDPUNND.js";
 import {
   parseFleetContract
-} from "./chunk-CTJ4RNAA.js";
+} from "./chunk-3F7VUY77.js";
 import {
   parseFrontmatter
 } from "./chunk-RKKLTLYB.js";
 import {
   assertAgentSpecPolicy,
   normalizeAgentSpec
-} from "./chunk-IG7BCQBA.js";
+} from "./chunk-PGF63K6I.js";
 import {
   INTEROP_AGENT_KINDS
 } from "./chunk-IHXBNWMM.js";
 import {
   readSettings,
   updateSettings
-} from "./chunk-EIMVLWB3.js";
+} from "./chunk-34BHNEE3.js";
 import {
   runCommandVector
 } from "./chunk-HJWWJ6IL.js";
@@ -908,4 +908,4 @@ export {
   ResourcesDomainModule,
   createResourcesDomainModule
 };
-//# sourceMappingURL=chunk-SINK3QR6.js.map
+//# sourceMappingURL=chunk-ZNT2M6TG.js.map

package/dist/{chunk-7RY5VZPH.js → chunk-ZW4HH5JJ.js}

@@ -7,21 +7,21 @@ import {
 import {
   openLedger,
   readFleetRun
-} from "./chunk-XKA2ICR3.js";
+} from "./chunk-I66ZTYNP.js";
 import {
   formatTrustSummaryLine,
   inspectRunReceiptTrustStatus
-} from "./chunk-6NJQITNH.js";
+} from "./chunk-B74PXLU7.js";
 import {
   WRITE_BOUNDARY_VIOLATION_REASON
-} from "./chunk-TD3PGPQA.js";
+} from "./chunk-W6NIE6OW.js";
 import {
   readRunEventJournal,
   runEventJournalPath
-} from "./chunk-6VC4OV3Z.js";
+} from "./chunk-VIA6RFQZ.js";
 import {
   sanitizeCallTargetText
-} from "./chunk-TVHHYFHE.js";
+} from "./chunk-NEDJ26B5.js";
 import {
   clioStateDir,
   resetXdgCache
@@ -570,4 +570,4 @@ export {
   loadFleetRunViewModel,
   runFleetView
 };
-//# sourceMappingURL=chunk-7RY5VZPH.js.map
+//# sourceMappingURL=chunk-ZW4HH5JJ.js.map

package/dist/cli/index.js

@@ -50,6 +50,7 @@ Usage:
   clio-coder auth list|status|login|logout [target-or-runtime]
   clio-coder doctor [--fix]       diagnose state; --fix creates or repairs it
   clio-coder paths [--json]       print resolved config/data/cache directories
+  clio-coder config inspect [--json]  inspect effective customization and provenance
   clio-coder reset                recover or wipe Clio Coder state
   clio-coder context              show project context status (CLIO-CODER.md, preload, codewiki)
   clio-coder context init [--yes] [--preview|--heuristic]  explore the repo and bootstrap CLIO-CODER.md and codewiki
@@ -74,7 +75,7 @@ Usage:
   clio-coder verifiers            discover, inspect, author, validate, edit, or dry-run project checks
   clio-coder tools list|status|install|remove <id>  pinned external programs Clio can drive
   clio-coder interop inspect --json  detected external coding agents and how far each one is wired
-  clio-coder panes install        install the pane multiplexer (alias for 'tools install herdr')
+  clio-coder panes install|theme  install the pane multiplexer (alias for 'tools install herdr'), or print Clio's theme as a herdr block
   clio-coder docs [topic]         serve the HTML docs of a source checkout on 127.0.0.1 (--no-open to skip browser)
   clio-coder dev <command>        harness instruments; run 'clio-coder dev' for the list
   clio-coder --help, -h           this message
@@ -153,7 +154,7 @@ async function main(argv) {
   };
   if (!subcommand) {
     await enableBootCompileCache();
-    const { runClioCommand } = await import("../clio-IT3G3VQH.js");
+    const { runClioCommand } = await import("../clio-7VB377CC.js");
     return runClioCommand(bootOptions);
   }
   return dispatch(subcommand, subArgs, bootOptions);
@@ -163,28 +164,28 @@ async function enableBootCompileCache(subArgs = []) {
   const { enableClioCompileCache } = await import("../compile-cache-OQAVB7Y5.js");
   enableClioCompileCache();
 }
-var extensionsCommand = async (subArgs) => (await import("../extensions-VHRBEID7.js")).runExtensionsCommand(subArgs);
+var extensionsCommand = async (subArgs) => (await import("../extensions-KPZ2UHBB.js")).runExtensionsCommand(subArgs);
 var COMMAND_HANDLERS = /* @__PURE__ */ new Map([
   [
     "acp",
     async (subArgs, bootOptions) => {
       await enableBootCompileCache(subArgs);
-      return (await import("../acp-ZILU3AUO.js")).runAcpCommand(subArgs, bootOptions);
+      return (await import("../acp-TMDQZDIG.js")).runAcpCommand(subArgs, bootOptions);
     }
   ],
-  ["auth", async (subArgs) => (await import("../auth-N3QT7CBO.js")).runAuthCommand(subArgs)],
-  ["config", async (subArgs) => (await import("../config-3QZRWZJF.js")).runConfigCommand(subArgs)],
-  ["configure", async (subArgs) => (await import("../configure-FL7Y3KJF.js")).runConfigureCommand(subArgs)],
-  ["targets", async (subArgs) => (await import("../targets-DSM6CY3M.js")).runTargetsCommand(subArgs)],
-  ["models", async (subArgs) => (await import("../models-ZVX3QOWE.js")).runModelsCommand(subArgs)],
-  ["agents", async (subArgs) => (await import("../agents-HYWGBGQR.js")).runAgentsCommand(subArgs)],
+  ["auth", async (subArgs) => (await import("../auth-Z5CCBXKQ.js")).runAuthCommand(subArgs)],
+  ["config", async (subArgs) => (await import("../config-4HVOS65E.js")).runConfigCommand(subArgs)],
+  ["configure", async (subArgs) => (await import("../configure-PIWO7B24.js")).runConfigureCommand(subArgs)],
+  ["targets", async (subArgs) => (await import("../targets-P2FUC4IL.js")).runTargetsCommand(subArgs)],
+  ["models", async (subArgs) => (await import("../models-2GPMFYCM.js")).runModelsCommand(subArgs)],
+  ["agents", async (subArgs) => (await import("../agents-5N5NG3XG.js")).runAgentsCommand(subArgs)],
   ["components", async (subArgs) => (await import("../components-UBWCQSRW.js")).runComponentsCommand(subArgs)],
-  ["evidence", async (subArgs) => (await import("../evidence-HWLBRH3Q.js")).runEvidenceCommand(subArgs)],
-  ["eval", async (subArgs) => (await import("../eval-GXLL44RD.js")).runEvalCommand(subArgs)],
-  ["memory", async (subArgs) => (await import("../memory-L4UTIIIW.js")).runMemoryCommand(subArgs)],
-  ["usage", async (subArgs) => (await import("../usage-X52N3IDJ.js")).runUsageCommand(subArgs)],
-  ["trace", async (subArgs) => (await import("../trace-ECQ7TIYZ.js")).runTraceCommand(subArgs)],
-  ["evolve", async (subArgs) => (await import("../evolve-FTZBMNVW.js")).runEvolveCommand(subArgs)],
+  ["evidence", async (subArgs) => (await import("../evidence-6SHONYAF.js")).runEvidenceCommand(subArgs)],
+  ["eval", async (subArgs) => (await import("../eval-C45FYRJ6.js")).runEvalCommand(subArgs)],
+  ["memory", async (subArgs) => (await import("../memory-HYOKAGGJ.js")).runMemoryCommand(subArgs)],
+  ["usage", async (subArgs) => (await import("../usage-ME5MPXGX.js")).runUsageCommand(subArgs)],
+  ["trace", async (subArgs) => (await import("../trace-YMGMUM6A.js")).runTraceCommand(subArgs)],
+  ["evolve", async (subArgs) => (await import("../evolve-KRKMV72X.js")).runEvolveCommand(subArgs)],
   [
     "dev",
     async (subArgs, bootOptions) => {
@@ -203,30 +204,30 @@ var COMMAND_HANDLERS = /* @__PURE__ */ new Map([
   ],
   ["extensions", extensionsCommand],
   ["ext", extensionsCommand],
-  ["fleet", async (subArgs) => (await import("../fleet-CKZHJWZJ.js")).runFleetCommand(subArgs)],
-  ["skills", async (subArgs) => (await import("../skills-35HHUKCR.js")).runSkillsCommand(subArgs)],
-  ["library", async (subArgs) => (await import("../library-3QY6KF57.js")).runLibraryCommand(subArgs)],
-  ["verifiers", async (subArgs) => (await import("../verifiers-EJTVVSMA.js")).runVerifiersCommand(subArgs)],
-  ["docs", async (subArgs) => (await import("../docs-5NAF6AU7.js")).runDocsCommand(subArgs)],
-  ["share", async (subArgs) => (await import("../share-G3APVLVP.js")).runShareCommand(subArgs)],
-  ["export", async (subArgs) => (await import("../share-G3APVLVP.js")).runExportCommand(subArgs)],
-  ["import", async (subArgs) => (await import("../share-G3APVLVP.js")).runImportCommand(subArgs)],
-  ["context", async (subArgs) => (await import("../context-KYQFRVDC.js")).runContextCommand(subArgs)],
+  ["fleet", async (subArgs) => (await import("../fleet-IVTCKDHT.js")).runFleetCommand(subArgs)],
+  ["skills", async (subArgs) => (await import("../skills-IYMXMKW4.js")).runSkillsCommand(subArgs)],
+  ["library", async (subArgs) => (await import("../library-LSCATDLZ.js")).runLibraryCommand(subArgs)],
+  ["verifiers", async (subArgs) => (await import("../verifiers-BVZ7IWOO.js")).runVerifiersCommand(subArgs)],
+  ["docs", async (subArgs) => (await import("../docs-PD3EXDKU.js")).runDocsCommand(subArgs)],
+  ["share", async (subArgs) => (await import("../share-IHWTLO3M.js")).runShareCommand(subArgs)],
+  ["export", async (subArgs) => (await import("../share-IHWTLO3M.js")).runExportCommand(subArgs)],
+  ["import", async (subArgs) => (await import("../share-IHWTLO3M.js")).runImportCommand(subArgs)],
+  ["context", async (subArgs) => (await import("../context-N6ZE3LGJ.js")).runContextCommand(subArgs)],
   [
     "run",
     async (subArgs, bootOptions) => {
       await enableBootCompileCache(subArgs);
-      return (await import("../run-HBAUJNNZ.js")).runClioRun(subArgs, bootOptions);
+      return (await import("../run-5DEYH5QK.js")).runClioRun(subArgs, bootOptions);
     }
   ],
-  ["tools", async (subArgs) => (await import("../tools-MKNWVPBH.js")).runToolsCommand(subArgs)],
-  ["interop", async (subArgs) => (await import("../interop-34TVO25M.js")).runInteropCommand(subArgs)],
-  ["panes", async (subArgs) => (await import("../panes-SHAUIRXY.js")).runPanesCommand(subArgs)],
-  ["doctor", async (subArgs) => (await import("../doctor-ZGPEGHIP.js")).runDoctorCommand(subArgs)],
+  ["tools", async (subArgs) => (await import("../tools-5B7RO6MV.js")).runToolsCommand(subArgs)],
+  ["interop", async (subArgs) => (await import("../interop-IN5I2A66.js")).runInteropCommand(subArgs)],
+  ["panes", async (subArgs) => (await import("../panes-IXKLOKA2.js")).runPanesCommand(subArgs)],
+  ["doctor", async (subArgs) => (await import("../doctor-LHBD36VU.js")).runDoctorCommand(subArgs)],
   ["paths", async (subArgs) => (await import("../paths-L7LGY6RN.js")).runPathsCommand(subArgs)],
-  ["reset", async (subArgs) => (await import("../reset-EOLM7GVE.js")).runResetCommand(subArgs)],
+  ["reset", async (subArgs) => (await import("../reset-OAQP3W4O.js")).runResetCommand(subArgs)],
   ["uninstall", async (subArgs) => (await import("../uninstall-N34PCTGJ.js")).runUninstallCommand(subArgs)],
-  ["upgrade", async (subArgs) => (await import("../upgrade-H7TOM7YL.js")).runUpgradeCommand(subArgs)],
+  ["upgrade", async (subArgs) => (await import("../upgrade-PXK3S2YM.js")).runUpgradeCommand(subArgs)],
   ["version", async () => (await import("../version-KGEG7EPO.js")).runVersionCommand()],
   [
     "worker",

package/dist/{clio-IT3G3VQH.js → clio-7VB377CC.js}

@@ -1,17 +1,17 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   runClioCommand
-} from "./chunk-GVQJ5CCZ.js";
-import "./chunk-VKRH2TCS.js";
+} from "./chunk-2HFQNRV3.js";
+import "./chunk-M2DAX4F6.js";
 import "./chunk-ZTJUVLTU.js";
-import "./chunk-7PWAODYW.js";
-import "./chunk-EIMVLWB3.js";
+import "./chunk-I7XBWTYH.js";
+import "./chunk-34BHNEE3.js";
 import "./chunk-D7E7WCDF.js";
 import "./chunk-EBY63B7G.js";
 import "./chunk-IWHMRKLL.js";
-import "./chunk-BWW4HLO4.js";
+import "./chunk-UXCU4E3T.js";
 import "./chunk-LL4KHSZI.js";
-import "./chunk-NLFAQR7Z.js";
+import "./chunk-S66XZJOF.js";
 import "./chunk-IKCO5N3L.js";
 import "./chunk-3I7MS7N2.js";
 import "./chunk-APJ265NV.js";
@@ -22,4 +22,4 @@ import "./chunk-3R73A4XB.js";
 export {
   runClioCommand
 };
-//# sourceMappingURL=clio-IT3G3VQH.js.map
+//# sourceMappingURL=clio-7VB377CC.js.map

package/dist/{code-nav-RK6S7F6E.js → code-nav-YVLCYA7V.js}

@@ -15,7 +15,7 @@ import {
   CODE_NAV_DEFAULT_LIMIT,
   CODE_NAV_MAX_LIMIT,
   codeNavToolSurface
-} from "./chunk-ABLSQ6JX.js";
+} from "./chunk-LJID3DYZ.js";
 import {
   compileGlobRegex
 } from "./chunk-VG7TBQIY.js";
@@ -25,7 +25,7 @@ import {
   finalizeObservation,
   observationBudgetExhausted,
   reserveObservation
-} from "./chunk-R23Z6K6I.js";
+} from "./chunk-B7HM5Z7T.js";
 import "./chunk-OZNBF4L3.js";
 import "./chunk-4BJ5BYCE.js";
 import "./chunk-6XLNIQDB.js";
@@ -37,10 +37,14 @@ import {
 import "./chunk-UUVG37B4.js";
 import {
   codewikiPath,
+  parseCodewikiRaw,
   readCodewiki
 } from "./chunk-LBMZMYH2.js";
 import "./chunk-33YXPOE3.js";
-import "./chunk-NLFAQR7Z.js";
+import {
+  resolvePackageRoot
+} from "./chunk-IWHMRKLL.js";
+import "./chunk-S66XZJOF.js";
 import "./chunk-IKCO5N3L.js";
 import "./chunk-3I7MS7N2.js";
 import "./chunk-APJ265NV.js";
@@ -55,7 +59,7 @@ import {
 // src/tools/codewiki/code-nav.ts
 init_esm_shims();
 import { existsSync, readFileSync } from "node:fs";
-import { join, normalize } from "node:path";
+import { isAbsolute, join, normalize, relative, resolve } from "node:path";
 
 // src/tools/codewiki/shared.ts
 init_esm_shims();
@@ -152,7 +156,51 @@ function renderJson(value) {
 
 // src/tools/codewiki/code-nav.ts
 var REGEX_SYNTAX_HINTS = /\.\*|\.\+|\^|\$|\\[dDwWsSbB]|\(\?:|\(\?=|\(\?!/;
+var CLIO_CODEWIKI_RELATIVE_PATH = join("dist", "assets", "codewiki.json");
 var navIndexCache = /* @__PURE__ */ new WeakMap();
+var clioCodewikiCache = null;
+function packageRootResolvedPath(packageRoot, indexedPath) {
+  const resolved = resolve(packageRoot, indexedPath);
+  const rel = relative(packageRoot, resolved);
+  if (rel.length === 0 || rel === ".." || rel.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`) || isAbsolute(rel)) {
+    throw new Error(`invalid package-root-relative path in bundled code map: ${indexedPath}`);
+  }
+  return resolved;
+}
+function packageRootResolvedCodewiki(packageRoot, codewiki) {
+  return {
+    ...codewiki,
+    files: codewiki.files.map((file) => ({
+      ...file,
+      path: packageRootResolvedPath(packageRoot, file.path)
+    }))
+  };
+}
+function loadClioCodewikiForTool() {
+  try {
+    const packageRoot = resolvePackageRoot();
+    if (clioCodewikiCache?.packageRoot === packageRoot) {
+      return { ok: true, loaded: { codewiki: clioCodewikiCache.codewiki, entryRoot: packageRoot } };
+    }
+    const artifactPath = join(packageRoot, CLIO_CODEWIKI_RELATIVE_PATH);
+    const parsed = parseCodewikiRaw(readFileSync(artifactPath, "utf8"));
+    if (!parsed) throw new Error("bundled artifact is not a valid codewiki");
+    const codewiki = packageRootResolvedCodewiki(packageRoot, parsed);
+    clioCodewikiCache = { packageRoot, codewiki };
+    return { ok: true, loaded: { codewiki, entryRoot: packageRoot } };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+      ok: false,
+      message: `code_nav: bundled Clio code map unavailable at ${CLIO_CODEWIKI_RELATIVE_PATH}: ${message}`
+    };
+  }
+}
+async function loadNavSource(source) {
+  if (source === "clio") return loadClioCodewikiForTool();
+  const loaded = await loadCodewikiForTool();
+  return loaded.ok ? { ok: true, loaded: { codewiki: loaded.codewiki, entryRoot: null } } : { ok: false, message: loaded.message };
+}
 function regexFromPattern(pattern) {
   if (pattern.startsWith("/") && pattern.lastIndexOf("/") > 0) {
     const last = pattern.lastIndexOf("/");
@@ -179,7 +227,7 @@ function regexFromPattern(pattern) {
   }
   return null;
 }
-function readPackageEntryPaths(cwd) {
+function readPackageEntryPaths(cwd, resolveFromRoot) {
   const out = /* @__PURE__ */ new Set();
   const pkgPath = join(cwd, "package.json");
   if (!existsSync(pkgPath)) return out;
@@ -191,11 +239,15 @@ function readPackageEntryPaths(cwd) {
   }
   if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return out;
   const pkg = parsed;
-  if (typeof pkg.main === "string") out.add(normalizeEntryPath(pkg.main));
-  if (typeof pkg.bin === "string") out.add(normalizeEntryPath(pkg.bin));
+  const add = (value) => {
+    const normalized = normalizeEntryPath(value);
+    out.add(resolveFromRoot ? packageRootResolvedPath(cwd, normalized) : normalized);
+  };
+  if (typeof pkg.main === "string") add(pkg.main);
+  if (typeof pkg.bin === "string") add(pkg.bin);
   if (typeof pkg.bin === "object" && pkg.bin !== null && !Array.isArray(pkg.bin)) {
     for (const value of Object.values(pkg.bin)) {
-      if (typeof value === "string") out.add(normalizeEntryPath(value));
+      if (typeof value === "string") add(value);
     }
   }
   return out;
@@ -329,9 +381,9 @@ function runPath(index, query, limit) {
     ...next !== void 0 ? { next } : {}
   };
 }
-function runEntries(index, limit) {
-  const cwd = process.cwd();
-  const packageEntries = readPackageEntryPaths(cwd);
+function runEntries(index, limit, entryRoot) {
+  const cwd = entryRoot ?? process.cwd();
+  const packageEntries = readPackageEntryPaths(cwd, entryRoot !== null);
   const candidates = [...index.filesByPath.values()].filter(
     (file) => file.lang !== "config" && (file.role === "entry" || packageEntries.has(file.path))
   );
@@ -537,10 +589,24 @@ function parseLimit(value, fallback) {
 var codeNavTool = {
   ...codeNavToolSurface,
   async run(args, options) {
+    const rawSource = args.source;
+    if (rawSource !== void 0 && rawSource !== "workspace" && rawSource !== "clio") {
+      return {
+        kind: "error",
+        message: `code_nav: source must be workspace or clio; got '${String(rawSource)}'`
+      };
+    }
+    const source = rawSource === "clio" ? "clio" : "workspace";
     const mode = typeof args.mode === "string" ? args.mode : "";
-    const loaded = await loadCodewikiForTool();
+    if (source === "clio" && mode === "wiki") {
+      return {
+        kind: "error",
+        message: "code_nav: source=clio does not provide mode=wiki; use context scope=docs for Clio documentation"
+      };
+    }
+    const loaded = await loadNavSource(source);
     if (!loaded.ok) return { kind: "error", message: loaded.message };
-    const index = navIndexFor(loaded.codewiki);
+    const index = navIndexFor(loaded.loaded.codewiki);
     const query = typeof args.query === "string" ? args.query.trim() : "";
     const limit = parseLimit(args.limit, mode === "entries" ? CODE_NAV_DEFAULT_ENTRY_LIMIT : CODE_NAV_DEFAULT_LIMIT);
     const reservation = reserveObservation(OBSERVE_SELF_CAPS.codeNav, options);
@@ -555,15 +621,17 @@ var codeNavTool = {
     }
     const close = (nav) => {
       if ("kind" in nav) return nav;
+      const next = source === "clio" && nav.next !== void 0 ? `source=clio ${nav.next}` : nav.next;
+      const payload = next === nav.next ? nav.payload : { ...nav.payload, next };
       return finalizeObservation({
         tool: ToolNames.CodeNav,
         unit: "results",
         format: "json",
-        output: renderJson(nav.payload),
+        output: renderJson(payload),
         shownCount: nav.shownCount,
         totalCount: nav.totalCount,
         truncated: nav.shownCount < nav.totalCount,
-        ...nav.next !== void 0 ? { next: nav.next } : {},
+        ...next !== void 0 ? { next } : {},
         reservation,
         ...options ? { options } : {}
       });
@@ -576,7 +644,7 @@ var codeNavTool = {
       if (query.length === 0) return { kind: "error", message: "code_nav: mode=path requires query" };
       return close(runPath(index, query, limit));
     }
-    if (mode === "entries") return close(runEntries(index, limit));
+    if (mode === "entries") return close(runEntries(index, limit, loaded.loaded.entryRoot));
     if (mode === "outline") {
       if (query.length === 0) return { kind: "error", message: "code_nav: mode=outline requires query path" };
       return close(runOutline(index, query, limit));
@@ -599,4 +667,4 @@ var codeNavTool = {
 export {
   codeNavTool
 };
-//# sourceMappingURL=code-nav-RK6S7F6E.js.map
+//# sourceMappingURL=code-nav-YVLCYA7V.js.map