@jayjiang/byoao 2.0.7 → 2.0.9

package/dist/index.js

@@ -4682,13 +4682,13 @@ var require_ast = __commonJS({
         helperExpression: function helperExpression(node) {
           return node.type === "SubExpression" || (node.type === "MustacheStatement" || node.type === "BlockStatement") && !!(node.params && node.params.length || node.hash);
         },
-        scopedId: function scopedId(path14) {
-          return /^\.|this\b/.test(path14.original);
+        scopedId: function scopedId(path15) {
+          return /^\.|this\b/.test(path15.original);
         },
         // an ID is simple if it only has one part, and that part is not
         // `..` or `this`.
-        simpleId: function simpleId(path14) {
-          return path14.parts.length === 1 && !AST.helpers.scopedId(path14) && !path14.depth;
+        simpleId: function simpleId(path15) {
+          return path15.parts.length === 1 && !AST.helpers.scopedId(path15) && !path15.depth;
         }
       }
     };
@@ -5758,12 +5758,12 @@ var require_helpers2 = __commonJS({
         loc
       };
     }
-    function prepareMustache(path14, params, hash2, open, strip, locInfo) {
+    function prepareMustache(path15, params, hash2, open, strip, locInfo) {
       var escapeFlag = open.charAt(3) || open.charAt(2), escaped = escapeFlag !== "{" && escapeFlag !== "&";
       var decorator = /\*/.test(open);
       return {
         type: decorator ? "Decorator" : "MustacheStatement",
-        path: path14,
+        path: path15,
         params,
         hash: hash2,
         escaped,
@@ -6033,9 +6033,9 @@ var require_compiler = __commonJS({
       },
       DecoratorBlock: function DecoratorBlock(decorator) {
         var program = decorator.program && this.compileProgram(decorator.program);
-        var params = this.setupFullMustacheParams(decorator, program, void 0), path14 = decorator.path;
+        var params = this.setupFullMustacheParams(decorator, program, void 0), path15 = decorator.path;
         this.useDecorators = true;
-        this.opcode("registerDecorator", params.length, path14.original);
+        this.opcode("registerDecorator", params.length, path15.original);
       },
       PartialStatement: function PartialStatement(partial2) {
         this.usePartial = true;
@@ -6099,46 +6099,46 @@ var require_compiler = __commonJS({
         }
       },
       ambiguousSexpr: function ambiguousSexpr(sexpr, program, inverse) {
-        var path14 = sexpr.path, name = path14.parts[0], isBlock = program != null || inverse != null;
-        this.opcode("getContext", path14.depth);
+        var path15 = sexpr.path, name = path15.parts[0], isBlock = program != null || inverse != null;
+        this.opcode("getContext", path15.depth);
         this.opcode("pushProgram", program);
         this.opcode("pushProgram", inverse);
-        path14.strict = true;
-        this.accept(path14);
+        path15.strict = true;
+        this.accept(path15);
         this.opcode("invokeAmbiguous", name, isBlock);
       },
       simpleSexpr: function simpleSexpr(sexpr) {
-        var path14 = sexpr.path;
-        path14.strict = true;
-        this.accept(path14);
+        var path15 = sexpr.path;
+        path15.strict = true;
+        this.accept(path15);
         this.opcode("resolvePossibleLambda");
       },
       helperSexpr: function helperSexpr(sexpr, program, inverse) {
-        var params = this.setupFullMustacheParams(sexpr, program, inverse), path14 = sexpr.path, name = path14.parts[0];
+        var params = this.setupFullMustacheParams(sexpr, program, inverse), path15 = sexpr.path, name = path15.parts[0];
         if (this.options.knownHelpers[name]) {
           this.opcode("invokeKnownHelper", params.length, name);
         } else if (this.options.knownHelpersOnly) {
           throw new _exception2["default"]("You specified knownHelpersOnly, but used the unknown helper " + name, sexpr);
         } else {
-          path14.strict = true;
-          path14.falsy = true;
-          this.accept(path14);
-          this.opcode("invokeHelper", params.length, path14.original, _ast2["default"].helpers.simpleId(path14));
+          path15.strict = true;
+          path15.falsy = true;
+          this.accept(path15);
+          this.opcode("invokeHelper", params.length, path15.original, _ast2["default"].helpers.simpleId(path15));
         }
       },
-      PathExpression: function PathExpression(path14) {
-        this.addDepth(path14.depth);
-        this.opcode("getContext", path14.depth);
-        var name = path14.parts[0], scoped = _ast2["default"].helpers.scopedId(path14), blockParamId = !path14.depth && !scoped && this.blockParamIndex(name);
+      PathExpression: function PathExpression(path15) {
+        this.addDepth(path15.depth);
+        this.opcode("getContext", path15.depth);
+        var name = path15.parts[0], scoped = _ast2["default"].helpers.scopedId(path15), blockParamId = !path15.depth && !scoped && this.blockParamIndex(name);
         if (blockParamId) {
-          this.opcode("lookupBlockParam", blockParamId, path14.parts);
+          this.opcode("lookupBlockParam", blockParamId, path15.parts);
         } else if (!name) {
           this.opcode("pushContext");
-        } else if (path14.data) {
+        } else if (path15.data) {
           this.options.data = true;
-          this.opcode("lookupData", path14.depth, path14.parts, path14.strict);
+          this.opcode("lookupData", path15.depth, path15.parts, path15.strict);
         } else {
-          this.opcode("lookupOnContext", path14.parts, path14.falsy, path14.strict, scoped);
+          this.opcode("lookupOnContext", path15.parts, path15.falsy, path15.strict, scoped);
         }
       },
       StringLiteral: function StringLiteral(string4) {
@@ -6488,16 +6488,16 @@ var require_util = __commonJS({
     }
     exports2.urlGenerate = urlGenerate;
     function normalize(aPath) {
-      var path14 = aPath;
+      var path15 = aPath;
       var url2 = urlParse(aPath);
       if (url2) {
         if (!url2.path) {
           return aPath;
         }
-        path14 = url2.path;
+        path15 = url2.path;
       }
-      var isAbsolute = exports2.isAbsolute(path14);
-      var parts = path14.split(/\/+/);
+      var isAbsolute = exports2.isAbsolute(path15);
+      var parts = path15.split(/\/+/);
       for (var part, up = 0, i = parts.length - 1; i >= 0; i--) {
         part = parts[i];
         if (part === ".") {
@@ -6514,15 +6514,15 @@ var require_util = __commonJS({
           }
         }
       }
-      path14 = parts.join("/");
-      if (path14 === "") {
-        path14 = isAbsolute ? "/" : ".";
+      path15 = parts.join("/");
+      if (path15 === "") {
+        path15 = isAbsolute ? "/" : ".";
       }
       if (url2) {
-        url2.path = path14;
+        url2.path = path15;
         return urlGenerate(url2);
       }
-      return path14;
+      return path15;
     }
     exports2.normalize = normalize;
     function join2(aRoot, aPath) {
@@ -9303,8 +9303,8 @@ var require_printer = __commonJS({
       return this.accept(sexpr.path) + " " + params + hash2;
     };
     PrintVisitor.prototype.PathExpression = function(id) {
-      var path14 = id.parts.join("/");
-      return (id.data ? "@" : "") + "PATH:" + path14;
+      var path15 = id.parts.join("/");
+      return (id.data ? "@" : "") + "PATH:" + path15;
     };
     PrintVisitor.prototype.StringLiteral = function(string4) {
       return '"' + string4.value + '"';
@@ -12015,10 +12015,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path14) {
-  if (!path14)
+function getElementAtPath(obj, path15) {
+  if (!path15)
     return obj;
-  return path14.reduce((acc, key) => acc?.[key], obj);
+  return path15.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -12379,11 +12379,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path14, issues) {
+function prefixIssues(path15, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path14);
+    iss.path.unshift(path15);
     return iss;
   });
 }
@@ -12551,7 +12551,7 @@ function treeifyError(error45, _mapper) {
     return issue2.message;
   };
   const result = { errors: [] };
-  const processError = (error46, path14 = []) => {
+  const processError = (error46, path15 = []) => {
     var _a, _b;
     for (const issue2 of error46.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -12561,7 +12561,7 @@ function treeifyError(error45, _mapper) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path14, ...issue2.path];
+        const fullpath = [...path15, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -12593,8 +12593,8 @@ function treeifyError(error45, _mapper) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path14 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path14) {
+  const path15 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path15) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -23779,7 +23779,7 @@ var matter = import_gray_matter.default;
 var Handlebars = import_handlebars.default;
 
 // dist/vault/create.js
-import path6 from "node:path";
+import path7 from "node:path";
 
 // dist/vault/template.js
 var templateCache = /* @__PURE__ */ new Map();
@@ -24273,8 +24273,8 @@ function getErrorMap2() {
 
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path14, errorMaps, issueData } = params;
-  const fullPath = [...path14, ...issueData.path || []];
+  const { data, path: path15, errorMaps, issueData } = params;
+  const fullPath = [...path15, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -24390,11 +24390,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path14, key) {
+  constructor(parent, value, path15, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path14;
+    this._path = path15;
     this._key = key;
   }
   get path() {
@@ -27861,10 +27861,13 @@ var VaultConfigSchema = external_exports2.object({
 var VaultStatusSchema = external_exports2.object({
   vaultPath: external_exports2.string()
 });
+var InitOfferWhenSchema = external_exports2.enum(["always", "work", "personal"]);
 var PresetConfigSchema = external_exports2.object({
   name: external_exports2.string().min(1),
   displayName: external_exports2.string().min(1),
   description: external_exports2.string(),
+  /** `always`: both Personal and Work paths; `work` / `personal`: only that init branch */
+  initOfferWhen: InitOfferWhenSchema.default("always"),
   directories: external_exports2.array(external_exports2.string()).default([]),
   agentDescription: external_exports2.string(),
   frontmatterExtras: external_exports2.record(external_exports2.string(), external_exports2.array(external_exports2.string())).default({}),
@@ -27906,7 +27909,7 @@ function getPresetsDir() {
   ${srcPresets}
   ${devPresets}`);
 }
-function listPresets() {
+function readAllPresetEntries() {
   const presetsDir = getPresetsDir();
   const entries = fs.readdirSync(presetsDir, { withFileTypes: true });
   const presets = [];
@@ -27921,11 +27924,19 @@ function listPresets() {
     presets.push({
       name: parsed.name,
       displayName: parsed.displayName,
-      description: parsed.description
+      description: parsed.description,
+      initOfferWhen: parsed.initOfferWhen
     });
   }
   return presets;
 }
+function listPresets() {
+  return readAllPresetEntries().map(({ name, displayName, description }) => ({
+    name,
+    displayName,
+    description
+  }));
+}
 function loadPreset(name) {
   const presetsDir = getPresetsDir();
   const presetDir = path.join(presetsDir, name);
@@ -28262,7 +28273,7 @@ async function configureProvider(provider, gcpProjectId) {
 
 // dist/vault/manifest.js
 import path4 from "node:path";
-var PKG_VERSION = "2.0.7";
+var PKG_VERSION = "2.0.9";
 var InfrastructureSchema = external_exports2.object({
   skills: external_exports2.array(external_exports2.string()).default([]),
   commands: external_exports2.array(external_exports2.string()).default([]),
@@ -28358,6 +28369,21 @@ function detectInitMode(targetPath) {
   return "fresh";
 }
 
+// dist/vault/index-base-example.js
+import path6 from "node:path";
+async function copyIndexBaseExampleIfMissing(vaultPath, commonDir) {
+  const dest = path6.join(vaultPath, "INDEX.base");
+  if (await fs.pathExists(dest)) {
+    return false;
+  }
+  const src = path6.join(commonDir, "INDEX.base.example");
+  if (!await fs.pathExists(src)) {
+    return false;
+  }
+  await fs.copy(src, dest);
+  return true;
+}
+
 // dist/vault/create.js
 function countWikilinks(content) {
   const stripped = content.replace(/```[\s\S]*?```/g, "").replace(/`[^`]+`/g, "");
@@ -28387,10 +28413,10 @@ var MCP_DISPLAY_NAMES = {
 };
 async function createMinimalCore(ctx) {
   if (!ctx.preserveObsidian) {
-    await fs.ensureDir(path6.join(ctx.vaultPath, ".obsidian"));
-    const obsidianSrc = path6.join(ctx.commonDir, "obsidian");
+    await fs.ensureDir(path7.join(ctx.vaultPath, ".obsidian"));
+    const obsidianSrc = path7.join(ctx.commonDir, "obsidian");
     if (await fs.pathExists(obsidianSrc)) {
-      await fs.copy(obsidianSrc, path6.join(ctx.vaultPath, ".obsidian"), { overwrite: false });
+      await fs.copy(obsidianSrc, path7.join(ctx.vaultPath, ".obsidian"), { overwrite: false });
       const obsidianFiles = await fs.readdir(obsidianSrc);
       ctx.filesCreated += obsidianFiles.length;
       for (const f of obsidianFiles) {
@@ -28398,13 +28424,13 @@ async function createMinimalCore(ctx) {
       }
     }
   }
-  const startHereTemplate = await fs.readFile(path6.join(ctx.commonDir, "Start Here.md.hbs"), "utf-8");
+  const startHereTemplate = await fs.readFile(path7.join(ctx.commonDir, "Start Here.md.hbs"), "utf-8");
   const startHereContent = renderTemplate(startHereTemplate, {
     KB_NAME: ctx.kbName,
     HAS_MCP_SERVICES: ctx.mcpServices.length > 0,
     MCP_SERVICES: ctx.mcpServices
   });
-  const startHerePath = path6.join(ctx.vaultPath, "Start Here.md");
+  const startHerePath = path7.join(ctx.vaultPath, "Start Here.md");
   if (!await fs.pathExists(startHerePath)) {
     await fs.writeFile(startHerePath, startHereContent);
     ctx.filesCreated++;
@@ -28413,21 +28439,21 @@ async function createMinimalCore(ctx) {
 async function createLlmWikiCore(ctx, wikiDomain = "") {
   const agentDirs = ["entities", "concepts", "comparisons", "queries"];
   for (const dir of agentDirs) {
-    const dirPath = path6.join(ctx.vaultPath, dir);
+    const dirPath = path7.join(ctx.vaultPath, dir);
     if (!await fs.pathExists(dirPath)) {
       await fs.ensureDir(dirPath);
       ctx.filesCreated++;
       ctx.directories.push(dir);
     }
   }
-  const schemaTemplatePath = path6.join(ctx.commonDir, "SCHEMA.md.hbs");
+  const schemaTemplatePath = path7.join(ctx.commonDir, "SCHEMA.md.hbs");
   if (await fs.pathExists(schemaTemplatePath)) {
     const schemaTemplate = await fs.readFile(schemaTemplatePath, "utf-8");
     const schemaContent = renderTemplate(schemaTemplate, {
       KB_NAME: ctx.kbName,
       WIKI_DOMAIN: wikiDomain || ""
     });
-    const schemaPath = path6.join(ctx.vaultPath, "SCHEMA.md");
+    const schemaPath = path7.join(ctx.vaultPath, "SCHEMA.md");
     if (!await fs.pathExists(schemaPath)) {
       await fs.writeFile(schemaPath, schemaContent);
       ctx.filesCreated++;
@@ -28438,16 +28464,19 @@ async function createLlmWikiCore(ctx, wikiDomain = "") {
 Entries are appended here during /cook operations.
 
 `;
-  const logPath = path6.join(ctx.vaultPath, "log.md");
+  const logPath = path7.join(ctx.vaultPath, "log.md");
   if (!await fs.pathExists(logPath)) {
     await fs.writeFile(logPath, logContent);
     ctx.filesCreated++;
   }
+  if (await copyIndexBaseExampleIfMissing(ctx.vaultPath, ctx.commonDir)) {
+    ctx.filesCreated++;
+  }
 }
 async function createAgentsMd(ctx, ownerName, presetConfig, presetDir) {
-  const agentsTemplate = await fs.readFile(path6.join(ctx.commonDir, "AGENTS.md.hbs"), "utf-8");
+  const agentsTemplate = await fs.readFile(path7.join(ctx.commonDir, "AGENTS.md.hbs"), "utf-8");
   let roleSection = "";
-  const agentSectionPath = path6.join(presetDir, "agent-section.hbs");
+  const agentSectionPath = path7.join(presetDir, "agent-section.hbs");
   if (await fs.pathExists(agentSectionPath)) {
     const agentSectionTemplate = await fs.readFile(agentSectionPath, "utf-8");
     roleSection = renderTemplate(agentSectionTemplate, {
@@ -28462,7 +28491,7 @@ async function createAgentsMd(ctx, ownerName, presetConfig, presetDir) {
     OWNER_NAME: ownerName,
     ROLE_SECTION: roleSection
   });
-  const agentsMdPath = path6.join(ctx.vaultPath, "AGENTS.md");
+  const agentsMdPath = path7.join(ctx.vaultPath, "AGENTS.md");
   if (!await fs.pathExists(agentsMdPath)) {
     await fs.writeFile(agentsMdPath, agentsContent);
     ctx.filesCreated++;
@@ -28470,17 +28499,17 @@ async function createAgentsMd(ctx, ownerName, presetConfig, presetDir) {
 }
 async function applyPresetOverlay(ctx, presetConfig, presetDir) {
   for (const dir of presetConfig.directories) {
-    await fs.ensureDir(path6.join(ctx.vaultPath, dir));
+    await fs.ensureDir(path7.join(ctx.vaultPath, dir));
   }
   ctx.directories.push(...presetConfig.directories);
   const allTemplateNames = [];
-  const presetTemplatesDir = path6.join(presetDir, "templates");
+  const presetTemplatesDir = path7.join(presetDir, "templates");
   if (await fs.pathExists(presetTemplatesDir)) {
-    const templateDest = path6.join(ctx.vaultPath, "templates");
+    const templateDest = path7.join(ctx.vaultPath, "templates");
     await fs.ensureDir(templateDest);
     const files = await fs.readdir(presetTemplatesDir);
     for (const file2 of files) {
-      await fs.copy(path6.join(presetTemplatesDir, file2), path6.join(templateDest, file2), { overwrite: false });
+      await fs.copy(path7.join(presetTemplatesDir, file2), path7.join(templateDest, file2), { overwrite: false });
       allTemplateNames.push(file2.replace(/\.md$/, ""));
       ctx.filesCreated++;
       ctx.installedFiles.templates.push(`templates/${file2}`);
@@ -28492,7 +28521,7 @@ async function createVault(config2) {
   const { kbName, vaultPath, preset } = config2;
   const presetName = preset ?? "minimal";
   const { config: presetConfig, presetsDir } = loadPreset(presetName);
-  const presetDir = path6.join(presetsDir, presetName);
+  const presetDir = path7.join(presetsDir, presetName);
   const initMode = detectInitMode(vaultPath);
   const preserveObsidian = initMode === "obsidian-vault";
   const ctx = makeContext(vaultPath, kbName, preserveObsidian);
@@ -28527,7 +28556,7 @@ async function createVault(config2) {
   for (const entry of entries) {
     const entryStr = String(entry);
     if (entryStr.endsWith(".md") && !entryStr.startsWith(".obsidian")) {
-      const content = await fs.readFile(path6.join(ctx.vaultPath, entryStr), "utf-8");
+      const content = await fs.readFile(path7.join(ctx.vaultPath, entryStr), "utf-8");
       wikilinksCreated += countWikilinks(content);
     }
   }
@@ -28543,7 +28572,7 @@ async function createVault(config2) {
   };
 }
 async function configureOpenCodeProject(vaultPath, installedFiles) {
-  const configPath = path6.join(vaultPath, ".opencode.json");
+  const configPath = path7.join(vaultPath, ".opencode.json");
   let config2 = {};
   if (await fs.pathExists(configPath)) {
     try {
@@ -28558,31 +28587,31 @@ async function configureOpenCodeProject(vaultPath, installedFiles) {
   }
   await fs.writeJson(configPath, config2, { spaces: 2 });
   const assetsDir = resolveAssetsDir();
-  const obsidianSkillsSrc = path6.join(assetsDir, "obsidian-skills");
-  const skillsDest = path6.join(vaultPath, ".opencode", "skills");
+  const obsidianSkillsSrc = path7.join(assetsDir, "obsidian-skills");
+  const skillsDest = path7.join(vaultPath, ".opencode", "skills");
   if (await fs.pathExists(obsidianSkillsSrc)) {
     await fs.ensureDir(skillsDest);
     const files = await fs.readdir(obsidianSkillsSrc);
     for (const file2 of files) {
       if (file2.endsWith(".md")) {
         const skillName = file2.replace(/\.md$/, "");
-        const destDir = path6.join(skillsDest, skillName);
+        const destDir = path7.join(skillsDest, skillName);
         await fs.ensureDir(destDir);
-        await fs.copy(path6.join(obsidianSkillsSrc, file2), path6.join(destDir, "SKILL.md"), { overwrite: true });
+        await fs.copy(path7.join(obsidianSkillsSrc, file2), path7.join(destDir, "SKILL.md"), { overwrite: true });
         installedFiles.skills.push(`.opencode/skills/${skillName}/SKILL.md`);
       }
     }
   }
-  const byoaoSkillsSrc = path6.join(assetsDir, "skills");
+  const byoaoSkillsSrc = path7.join(assetsDir, "skills");
   if (await fs.pathExists(byoaoSkillsSrc)) {
     const entries = await fs.readdir(byoaoSkillsSrc, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.isDirectory()) {
-        const srcSkill = path6.join(byoaoSkillsSrc, entry.name, "SKILL.md");
+        const srcSkill = path7.join(byoaoSkillsSrc, entry.name, "SKILL.md");
         if (await fs.pathExists(srcSkill)) {
-          const destDir = path6.join(skillsDest, entry.name);
+          const destDir = path7.join(skillsDest, entry.name);
           await fs.ensureDir(destDir);
-          await fs.copy(srcSkill, path6.join(destDir, "SKILL.md"), { overwrite: true });
+          await fs.copy(srcSkill, path7.join(destDir, "SKILL.md"), { overwrite: true });
           installedFiles.skills.push(`.opencode/skills/${entry.name}/SKILL.md`);
         }
       }
@@ -28590,9 +28619,9 @@ async function configureOpenCodeProject(vaultPath, installedFiles) {
   }
 }
 function resolveAssetsDir() {
-  const distAssets = path6.resolve(import.meta.dirname, "assets");
-  const srcAssets = path6.resolve(import.meta.dirname, "..", "assets");
-  const devAssets = path6.resolve(import.meta.dirname, "..", "..", "src", "assets");
+  const distAssets = path7.resolve(import.meta.dirname, "assets");
+  const srcAssets = path7.resolve(import.meta.dirname, "..", "assets");
+  const devAssets = path7.resolve(import.meta.dirname, "..", "..", "src", "assets");
   if (fs.existsSync(distAssets))
     return distAssets;
   if (fs.existsSync(srcAssets))
@@ -28716,10 +28745,10 @@ function formatObsidianStatus(status) {
 }
 
 // dist/tools/init-vault.js
-import path7 from "node:path";
+import path8 from "node:path";
 import os3 from "node:os";
 var byoao_init_vault = tool({
-  description: "Create an LLM Wiki knowledge base in Obsidian. Sets up agent directories (entities/, concepts/, comparisons/, queries/), SCHEMA.md, log.md, and AI routing (AGENTS.md). Your existing notes become raw material for /cook.",
+  description: "Create an LLM Wiki knowledge base in Obsidian. Sets up agent directories (entities/, concepts/, comparisons/, queries/), SCHEMA.md, log.md, INDEX.base (from INDEX.base.example when missing), and AI routing (AGENTS.md). Your existing notes become raw material for /cook.",
   args: {
     kbName: tool.schema.string().describe(`Knowledge base name (e.g. "Jay's KB")`),
     ownerName: tool.schema.string().optional().describe("Owner's name"),
@@ -28734,7 +28763,7 @@ var byoao_init_vault = tool({
 
 Please install Obsidian first, then try again.`;
     }
-    const resolvedPath = args.vaultPath || path7.join(os3.homedir(), "Documents", args.kbName);
+    const resolvedPath = args.vaultPath || path8.join(os3.homedir(), "Documents", args.kbName);
     const config2 = VaultConfigSchema.parse({
       kbName: args.kbName,
       ownerName: args.ownerName || "",
@@ -28851,7 +28880,7 @@ Open in Obsidian: "Open folder as vault" \u2192 select "${result.vaultPath}"`;
 });
 
 // dist/vault/status.js
-import path8 from "node:path";
+import path9 from "node:path";
 async function getAllMarkdownFiles(dirPath) {
   const results = [];
   async function walk(dir) {
@@ -28859,7 +28888,7 @@ async function getAllMarkdownFiles(dirPath) {
       return;
     const entries = await fs.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = path8.join(dir, entry.name);
+      const fullPath = path9.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (!entry.name.startsWith(".")) {
           await walk(fullPath);
@@ -28898,7 +28927,7 @@ async function getVaultStatus(vaultPath) {
     };
   }
   const allFiles = await getAllMarkdownFiles(vaultPath);
-  const noteNames = new Set(allFiles.map((f) => path8.basename(f, ".md")));
+  const noteNames = new Set(allFiles.map((f) => path9.basename(f, ".md")));
   let wikilinkCount = 0;
   const brokenLinksSet = /* @__PURE__ */ new Set();
   for (const file2 of allFiles) {
@@ -28923,7 +28952,7 @@ async function getVaultStatus(vaultPath) {
     "Daily"
   ];
   for (const dir of topDirs) {
-    const dirPath = path8.join(vaultPath, dir);
+    const dirPath = path9.join(vaultPath, dir);
     if (await fs.pathExists(dirPath)) {
       const files = await getAllMarkdownFiles(dirPath);
       directories[dir] = files.length;
@@ -28937,7 +28966,7 @@ async function getVaultStatus(vaultPath) {
     queries: 0
   };
   for (const name of agentDirNames) {
-    const dirPath = path8.join(vaultPath, name);
+    const dirPath = path9.join(vaultPath, name);
     const mdFiles = await getAllMarkdownFiles(dirPath);
     agentPages[name] = mdFiles.length;
   }
@@ -28948,12 +28977,12 @@ async function getVaultStatus(vaultPath) {
     wikilinkCount,
     brokenLinks: Array.from(brokenLinksSet),
     directories,
-    hasObsidianConfig: await fs.pathExists(path8.join(vaultPath, ".obsidian")),
-    hasAgentMd: await fs.pathExists(path8.join(vaultPath, "AGENTS.md")) || await fs.pathExists(path8.join(vaultPath, "AGENT.md")),
+    hasObsidianConfig: await fs.pathExists(path9.join(vaultPath, ".obsidian")),
+    hasAgentMd: await fs.pathExists(path9.join(vaultPath, "AGENTS.md")) || await fs.pathExists(path9.join(vaultPath, "AGENT.md")),
     agentPages,
-    hasSchema: await fs.pathExists(path8.join(vaultPath, "SCHEMA.md")),
-    hasLog: await fs.pathExists(path8.join(vaultPath, "log.md")),
-    hasIndexBase: await fs.pathExists(path8.join(vaultPath, "INDEX.base"))
+    hasSchema: await fs.pathExists(path9.join(vaultPath, "SCHEMA.md")),
+    hasLog: await fs.pathExists(path9.join(vaultPath, "log.md")),
+    hasIndexBase: await fs.pathExists(path9.join(vaultPath, "INDEX.base"))
   };
 }
 function formatVaultStatus(status) {
@@ -29009,18 +29038,18 @@ var byoao_vault_status = tool({
 });
 
 // dist/vault/doctor.js
-import path9 from "node:path";
+import path10 from "node:path";
 import { stat } from "node:fs/promises";
 var LLM_WIKI_V2_AGENT_DIRS = ["entities", "concepts", "comparisons", "queries"];
 function isAgentWikiPage(relativePath) {
-  const top = relativePath.split(path9.sep)[0];
+  const top = relativePath.split(path10.sep)[0];
   return LLM_WIKI_V2_AGENT_DIRS.includes(top);
 }
 async function collectMarkdownFiles(dir) {
   const results = [];
   const entries = await fs.readdir(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = path9.join(dir, entry.name);
+    const fullPath = path10.join(dir, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === ".obsidian" || entry.name === ".git")
         continue;
@@ -29040,11 +29069,22 @@ function extractWikilinks2(content) {
 }
 async function getVaultDiagnosis(vaultPath) {
   const issues = [];
+  const knowledgeDir = path10.join(vaultPath, "Knowledge");
+  if (await fs.pathExists(knowledgeDir)) {
+    const mdUnderKnowledge = await collectMarkdownFiles(knowledgeDir);
+    if (mdUnderKnowledge.length === 0) {
+      issues.push({
+        severity: "info",
+        category: "orphan",
+        message: "Folder `Knowledge/` exists but contains no markdown files. BYOAO v2 does not use this path (v1 legacy). You can remove the folder if you do not need it."
+      });
+    }
+  }
   const allFiles = await collectMarkdownFiles(vaultPath);
-  const noteNames = new Set(allFiles.map((f) => path9.basename(f, ".md")));
+  const noteNames = new Set(allFiles.map((f) => path10.basename(f, ".md")));
   let healthyNotes = 0;
   for (const filePath of allFiles) {
-    const relativePath = path9.relative(vaultPath, filePath);
+    const relativePath = path10.relative(vaultPath, filePath);
     if (relativePath.startsWith("Knowledge/templates/"))
       continue;
     const content = await fs.readFile(filePath, "utf-8");
@@ -29093,11 +29133,11 @@ async function getVaultDiagnosis(vaultPath) {
       healthyNotes++;
   }
   let agentContent = null;
-  let agentResolvedPath = path9.join(vaultPath, "AGENTS.md");
+  let agentResolvedPath = path10.join(vaultPath, "AGENTS.md");
   if (await fs.pathExists(agentResolvedPath)) {
     agentContent = await fs.readFile(agentResolvedPath, "utf-8");
   } else {
-    agentResolvedPath = path9.join(vaultPath, "AGENT.md");
+    agentResolvedPath = path10.join(vaultPath, "AGENT.md");
     if (await fs.pathExists(agentResolvedPath)) {
       agentContent = await fs.readFile(agentResolvedPath, "utf-8");
     }
@@ -29115,7 +29155,7 @@ async function getVaultDiagnosis(vaultPath) {
     }
   }
   for (const dirName of LLM_WIKI_V2_AGENT_DIRS) {
-    const dirPath = path9.join(vaultPath, dirName);
+    const dirPath = path10.join(vaultPath, dirName);
     const exists = await fs.pathExists(dirPath);
     const isDir = exists && (await stat(dirPath)).isDirectory();
     if (!isDir) {
@@ -29126,7 +29166,7 @@ async function getVaultDiagnosis(vaultPath) {
       });
     }
   }
-  const schemaPath = path9.join(vaultPath, "SCHEMA.md");
+  const schemaPath = path10.join(vaultPath, "SCHEMA.md");
   if (!await fs.pathExists(schemaPath)) {
     issues.push({
       severity: "warning",
@@ -29134,7 +29174,7 @@ async function getVaultDiagnosis(vaultPath) {
       message: "LLM Wiki v2: missing SCHEMA.md at vault root"
     });
   }
-  const logMdPath = path9.join(vaultPath, "log.md");
+  const logMdPath = path10.join(vaultPath, "log.md");
   if (!await fs.pathExists(logMdPath)) {
     issues.push({
       severity: "warning",
@@ -29147,21 +29187,21 @@ async function getVaultDiagnosis(vaultPath) {
   for (const filePath of allFiles) {
     const content = await fs.readFile(filePath, "utf-8");
     const links = extractWikilinks2(content);
-    const name = path9.basename(filePath, ".md");
+    const name = path10.basename(filePath, ".md");
     allLinksMap.set(name, new Set(links));
     for (const link of links) {
       incomingLinks.add(link);
     }
   }
   for (const filePath of allFiles) {
-    const relativePath = path9.relative(vaultPath, filePath);
+    const relativePath = path10.relative(vaultPath, filePath);
     if (relativePath.startsWith("Knowledge/templates/"))
       continue;
     if (relativePath === "AGENT.md" || relativePath === "AGENTS.md")
       continue;
     if (isAgentWikiPage(relativePath))
       continue;
-    const name = path9.basename(filePath, ".md");
+    const name = path10.basename(filePath, ".md");
     const outgoing = allLinksMap.get(name) || /* @__PURE__ */ new Set();
     const hasIncoming = incomingLinks.has(name);
     const hasOutgoing = outgoing.size > 0;
@@ -29175,7 +29215,7 @@ async function getVaultDiagnosis(vaultPath) {
     }
   }
   for (const filePath of allFiles) {
-    const relativePath = path9.relative(vaultPath, filePath);
+    const relativePath = path10.relative(vaultPath, filePath);
     const content = await fs.readFile(filePath, "utf-8");
     const links = extractWikilinks2(content);
     for (const link of links) {
@@ -29268,15 +29308,15 @@ var byoao_switch_provider = tool({
 });
 
 // dist/vault/upgrade.js
-import path11 from "node:path";
+import path12 from "node:path";
 import os4 from "node:os";
 
 // dist/vault/copy-bundled-skills.js
-import path10 from "node:path";
+import path11 from "node:path";
 function resolveBundledAssetsRoot() {
-  const distAssets = path10.resolve(import.meta.dirname, "assets");
-  const srcAssets = path10.resolve(import.meta.dirname, "..", "assets");
-  const devAssets = path10.resolve(import.meta.dirname, "..", "..", "src", "assets");
+  const distAssets = path11.resolve(import.meta.dirname, "assets");
+  const srcAssets = path11.resolve(import.meta.dirname, "..", "assets");
+  const devAssets = path11.resolve(import.meta.dirname, "..", "..", "src", "assets");
   if (fs.existsSync(distAssets))
     return distAssets;
   if (fs.existsSync(srcAssets))
@@ -29286,9 +29326,9 @@ function resolveBundledAssetsRoot() {
   return distAssets;
 }
 function resolveBundledByoaoSkillsRoot() {
-  const distSkills = path10.resolve(import.meta.dirname, "assets", "skills");
-  const srcSkills = path10.resolve(import.meta.dirname, "..", "skills");
-  const devSkills = path10.resolve(import.meta.dirname, "..", "..", "src", "skills");
+  const distSkills = path11.resolve(import.meta.dirname, "assets", "skills");
+  const srcSkills = path11.resolve(import.meta.dirname, "..", "skills");
+  const devSkills = path11.resolve(import.meta.dirname, "..", "..", "src", "skills");
   if (fs.existsSync(distSkills))
     return distSkills;
   if (fs.existsSync(srcSkills))
@@ -29305,15 +29345,15 @@ async function copyBundledSkillsToOpenCodeSkillsDir(targetSkillsRoot, options2)
   let obsidianSkills = 0;
   let byoaoSkills = 0;
   if (includeObsidian) {
-    const obsidianSrc = path10.join(assetsRoot, "obsidian-skills");
+    const obsidianSrc = path11.join(assetsRoot, "obsidian-skills");
     if (fs.existsSync(obsidianSrc)) {
       for (const file2 of fs.readdirSync(obsidianSrc)) {
         if (!file2.endsWith(".md"))
           continue;
         const skillName = file2.replace(/\.md$/, "");
-        const destDir = path10.join(targetSkillsRoot, skillName);
+        const destDir = path11.join(targetSkillsRoot, skillName);
         await fs.ensureDir(destDir);
-        await fs.copy(path10.join(obsidianSrc, file2), path10.join(destDir, "SKILL.md"), { overwrite: true });
+        await fs.copy(path11.join(obsidianSrc, file2), path11.join(destDir, "SKILL.md"), { overwrite: true });
         obsidianSkills++;
       }
     }
@@ -29323,11 +29363,11 @@ async function copyBundledSkillsToOpenCodeSkillsDir(targetSkillsRoot, options2)
     for (const entry of entries) {
       if (!entry.isDirectory())
         continue;
-      const srcSkill = path10.join(byoaoSkillsRoot, entry.name, "SKILL.md");
+      const srcSkill = path11.join(byoaoSkillsRoot, entry.name, "SKILL.md");
       if (await fs.pathExists(srcSkill)) {
-        const destDir = path10.join(targetSkillsRoot, entry.name);
+        const destDir = path11.join(targetSkillsRoot, entry.name);
         await fs.ensureDir(destDir);
-        await fs.copy(srcSkill, path10.join(destDir, "SKILL.md"), { overwrite: true });
+        await fs.copy(srcSkill, path11.join(destDir, "SKILL.md"), { overwrite: true });
         byoaoSkills++;
       }
     }
@@ -29343,7 +29383,7 @@ async function scanInstalledAssets(vaultPath) {
   const templates = await scanDir(vaultPath, "Knowledge/templates", ".md");
   const obsidianConfig = [];
   for (const file2 of OBSIDIAN_CONFIG_FILES) {
-    const abs = path11.join(vaultPath, ".obsidian", file2);
+    const abs = path12.join(vaultPath, ".obsidian", file2);
     if (await fs.pathExists(abs)) {
       obsidianConfig.push(`.obsidian/${file2}`);
     }
@@ -29351,21 +29391,21 @@ async function scanInstalledAssets(vaultPath) {
   return { skills, commands, obsidianConfig, templates };
 }
 async function scanDir(vaultPath, relDir, ext) {
-  const absDir = path11.join(vaultPath, relDir);
+  const absDir = path12.join(vaultPath, relDir);
   if (!await fs.pathExists(absDir))
     return [];
   const files = await fs.readdir(absDir);
   return files.filter((f) => f.endsWith(ext)).map((f) => `${relDir}/${f}`);
 }
 async function scanSkillDirs(vaultPath) {
-  const skillsRoot = path11.join(vaultPath, ".opencode", "skills");
+  const skillsRoot = path12.join(vaultPath, ".opencode", "skills");
   if (!await fs.pathExists(skillsRoot))
     return [];
   const results = [];
   const entries = await fs.readdir(skillsRoot, { withFileTypes: true });
   for (const entry of entries) {
     if (entry.isDirectory()) {
-      const skillMd = path11.join(skillsRoot, entry.name, "SKILL.md");
+      const skillMd = path12.join(skillsRoot, entry.name, "SKILL.md");
       if (await fs.pathExists(skillMd)) {
         results.push(`.opencode/skills/${entry.name}/SKILL.md`);
       }
@@ -29394,7 +29434,7 @@ function buildUpgradePlan(vaultPath, manifest, packageAssets) {
     const installed = new Set(manifest.infrastructure[key]);
     const shippedPaths = new Set(shipped.map((s) => s.relativePath));
     for (const entry of shipped) {
-      const onDisk = fs.existsSync(path11.join(vaultPath, entry.relativePath));
+      const onDisk = fs.existsSync(path12.join(vaultPath, entry.relativePath));
       items.push({
         file: entry.relativePath,
         action: onDisk ? "update" : "add",
@@ -29425,20 +29465,20 @@ Entries are appended here during /cook operations.
 `;
 async function migrateV1ToV2Infrastructure(vaultPath) {
   for (const dir of LLM_WIKI_AGENT_DIRS) {
-    const dirPath = path11.join(vaultPath, dir);
+    const dirPath = path12.join(vaultPath, dir);
     if (!await fs.pathExists(dirPath)) {
       await fs.ensureDir(dirPath);
     }
   }
-  const schemaPath = path11.join(vaultPath, "SCHEMA.md");
+  const schemaPath = path12.join(vaultPath, "SCHEMA.md");
   if (!await fs.pathExists(schemaPath)) {
-    const commonDir = getCommonDir();
-    const schemaTemplatePath = path11.join(commonDir, "SCHEMA.md.hbs");
+    const commonDir2 = getCommonDir();
+    const schemaTemplatePath = path12.join(commonDir2, "SCHEMA.md.hbs");
     let content;
     if (await fs.pathExists(schemaTemplatePath)) {
       const schemaTemplate = await fs.readFile(schemaTemplatePath, "utf-8");
       content = renderTemplate(schemaTemplate, {
-        KB_NAME: path11.basename(vaultPath),
+        KB_NAME: path12.basename(vaultPath),
         WIKI_DOMAIN: ""
       });
     } else {
@@ -29450,10 +29490,12 @@ This file describes the vault knowledge schema. Update it as your model evolves.
     }
     await fs.writeFile(schemaPath, content, "utf-8");
   }
-  const logPath = path11.join(vaultPath, "log.md");
+  const logPath = path12.join(vaultPath, "log.md");
   if (!await fs.pathExists(logPath)) {
     await fs.writeFile(logPath, LOG_MD_PLACEHOLDER, "utf-8");
   }
+  const commonDir = getCommonDir();
+  await copyIndexBaseExampleIfMissing(vaultPath, commonDir);
 }
 var BYOAO_SKILL_NAMES = [
   "ask",
@@ -29470,16 +29512,16 @@ var BYOAO_SKILL_NAMES = [
   "wiki"
 ];
 async function migrateCommandsToSkills(vaultPath) {
-  const commandsDir = path11.join(vaultPath, ".opencode", "commands");
+  const commandsDir = path12.join(vaultPath, ".opencode", "commands");
   if (!await fs.pathExists(commandsDir))
     return;
-  const skillsDir = path11.join(vaultPath, ".opencode", "skills");
+  const skillsDir = path12.join(vaultPath, ".opencode", "skills");
   for (const name of BYOAO_SKILL_NAMES) {
-    const src = path11.join(commandsDir, `${name}.md`);
+    const src = path12.join(commandsDir, `${name}.md`);
     if (!await fs.pathExists(src))
       continue;
-    const destDir = path11.join(skillsDir, name);
-    const dest = path11.join(destDir, "SKILL.md");
+    const destDir = path12.join(skillsDir, name);
+    const dest = path12.join(destDir, "SKILL.md");
     if (await fs.pathExists(dest)) {
       await fs.remove(src);
       continue;
@@ -29494,7 +29536,7 @@ async function migrateCommandsToSkills(vaultPath) {
 }
 async function collectV1DeprecatedInfrastructureItems(vaultPath) {
   const items = [];
-  const templatesDir = path11.join(vaultPath, "Knowledge", "templates");
+  const templatesDir = path12.join(vaultPath, "Knowledge", "templates");
   if (await fs.pathExists(templatesDir)) {
     const files = await fs.readdir(templatesDir);
     for (const f of files) {
@@ -29509,7 +29551,7 @@ async function collectV1DeprecatedInfrastructureItems(vaultPath) {
   }
   for (const cmd of ["weave.md", "emerge.md"]) {
     const rel = `.opencode/commands/${cmd}`;
-    if (await fs.pathExists(path11.join(vaultPath, rel))) {
+    if (await fs.pathExists(path12.join(vaultPath, rel))) {
       items.push({
         file: rel,
         action: "deprecated",
@@ -29529,9 +29571,9 @@ function mergeForcedDeprecatedIntoPlan(items, forced) {
   return [...byFile.values()];
 }
 function resolveAssetsDir2() {
-  const distAssets = path11.resolve(import.meta.dirname, "assets");
-  const srcAssets = path11.resolve(import.meta.dirname, "..", "assets");
-  const devAssets = path11.resolve(import.meta.dirname, "..", "..", "src", "assets");
+  const distAssets = path12.resolve(import.meta.dirname, "assets");
+  const srcAssets = path12.resolve(import.meta.dirname, "..", "assets");
+  const devAssets = path12.resolve(import.meta.dirname, "..", "..", "src", "assets");
   if (fs.existsSync(distAssets))
     return distAssets;
   if (fs.existsSync(srcAssets))
@@ -29541,9 +29583,9 @@ function resolveAssetsDir2() {
   return distAssets;
 }
 function resolveSkillsDir() {
-  const distSkills = path11.resolve(import.meta.dirname, "assets", "skills");
-  const srcSkills = path11.resolve(import.meta.dirname, "..", "skills");
-  const devSkills = path11.resolve(import.meta.dirname, "..", "..", "src", "skills");
+  const distSkills = path12.resolve(import.meta.dirname, "assets", "skills");
+  const srcSkills = path12.resolve(import.meta.dirname, "..", "skills");
+  const devSkills = path12.resolve(import.meta.dirname, "..", "..", "src", "skills");
   if (fs.existsSync(distSkills))
     return distSkills;
   if (fs.existsSync(srcSkills))
@@ -29560,14 +29602,14 @@ function resolvePackageAssets(preset) {
   const commands = [];
   const obsidianConfig = [];
   const templates = [];
-  const obsidianSkillsDir = path11.join(assetsDir, "obsidian-skills");
+  const obsidianSkillsDir = path12.join(assetsDir, "obsidian-skills");
   if (fs.existsSync(obsidianSkillsDir)) {
     for (const file2 of fs.readdirSync(obsidianSkillsDir)) {
       if (file2.endsWith(".md")) {
         const skillName = file2.replace(/\.md$/, "");
         skills.push({
           relativePath: `.opencode/skills/${skillName}/SKILL.md`,
-          sourcePath: path11.join(obsidianSkillsDir, file2)
+          sourcePath: path12.join(obsidianSkillsDir, file2)
         });
       }
     }
@@ -29575,7 +29617,7 @@ function resolvePackageAssets(preset) {
   if (fs.existsSync(skillsDir)) {
     for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
       if (entry.isDirectory()) {
-        const skillMd = path11.join(skillsDir, entry.name, "SKILL.md");
+        const skillMd = path12.join(skillsDir, entry.name, "SKILL.md");
         if (fs.existsSync(skillMd)) {
           skills.push({
             relativePath: `.opencode/skills/${entry.name}/SKILL.md`,
@@ -29585,10 +29627,10 @@ function resolvePackageAssets(preset) {
       }
     }
   }
-  const obsidianSrcDir = path11.join(commonDir, "obsidian");
+  const obsidianSrcDir = path12.join(commonDir, "obsidian");
   if (fs.existsSync(obsidianSrcDir)) {
     for (const file2 of OBSIDIAN_CONFIG_FILES) {
-      const srcPath = path11.join(obsidianSrcDir, file2);
+      const srcPath = path12.join(obsidianSrcDir, file2);
       if (fs.existsSync(srcPath)) {
         obsidianConfig.push({
           relativePath: `.obsidian/${file2}`,
@@ -29597,26 +29639,26 @@ function resolvePackageAssets(preset) {
       }
     }
   }
-  const commonTemplatesDir = path11.join(commonDir, "templates");
+  const commonTemplatesDir = path12.join(commonDir, "templates");
   if (fs.existsSync(commonTemplatesDir)) {
     for (const file2 of fs.readdirSync(commonTemplatesDir)) {
       if (file2.endsWith(".md")) {
         templates.push({
           relativePath: `Knowledge/templates/${file2}`,
-          sourcePath: path11.join(commonTemplatesDir, file2)
+          sourcePath: path12.join(commonTemplatesDir, file2)
         });
       }
     }
   }
   try {
     const { presetsDir } = loadPreset(preset);
-    const presetTemplatesDir = path11.join(presetsDir, preset, "templates");
+    const presetTemplatesDir = path12.join(presetsDir, preset, "templates");
     if (fs.existsSync(presetTemplatesDir)) {
       for (const file2 of fs.readdirSync(presetTemplatesDir)) {
         if (file2.endsWith(".md")) {
           templates.push({
             relativePath: `Knowledge/templates/${file2}`,
-            sourcePath: path11.join(presetTemplatesDir, file2)
+            sourcePath: path12.join(presetTemplatesDir, file2)
           });
         }
       }
@@ -29641,7 +29683,7 @@ async function upgradeVault(vaultPath, options2) {
     let globalOpenCodeSkillsEarly;
     let globalOpenCodeSkillsErrorEarly;
     if (!dryRun && !skipGlobalSkillsSync) {
-      const globalSkillsRoot = path11.join(os4.homedir(), ".config", "opencode", "skills");
+      const globalSkillsRoot = path12.join(os4.homedir(), ".config", "opencode", "skills");
       if (await fs.pathExists(globalSkillsRoot)) {
         try {
           globalOpenCodeSkillsEarly = await copyBundledSkillsToOpenCodeSkillsDir(globalSkillsRoot, {
@@ -29664,8 +29706,8 @@ async function upgradeVault(vaultPath, options2) {
       globalOpenCodeSkillsError: globalOpenCodeSkillsErrorEarly
     };
   }
-  const legacyAgentMd = path11.join(vaultPath, "AGENT.md");
-  const newAgentsMd = path11.join(vaultPath, "AGENTS.md");
+  const legacyAgentMd = path12.join(vaultPath, "AGENT.md");
+  const newAgentsMd = path12.join(vaultPath, "AGENTS.md");
   if (!dryRun && await fs.pathExists(legacyAgentMd) && !await fs.pathExists(newAgentsMd)) {
     await fs.rename(legacyAgentMd, newAgentsMd);
   }
@@ -29700,8 +29742,8 @@ async function upgradeVault(vaultPath, options2) {
         if (item.action === "add" || item.action === "update") {
           const source = sourceMap.get(item.file);
           if (source) {
-            const dest = path11.join(vaultPath, item.file);
-            await fs.ensureDir(path11.dirname(dest));
+            const dest = path12.join(vaultPath, item.file);
+            await fs.ensureDir(path12.dirname(dest));
             await fs.copy(source, dest, { overwrite: true });
             if (item.action === "add") {
               added.push(item.file);
@@ -29722,7 +29764,7 @@ async function upgradeVault(vaultPath, options2) {
     const installedFiles = await scanInstalledAssets(vaultPath);
     await writeManifest(vaultPath, effectivePreset, installedFiles);
     if (!skipGlobalSkillsSync && errors.length === 0) {
-      const globalSkillsRoot = path11.join(os4.homedir(), ".config", "opencode", "skills");
+      const globalSkillsRoot = path12.join(os4.homedir(), ".config", "opencode", "skills");
       if (await fs.pathExists(globalSkillsRoot)) {
         try {
           globalOpenCodeSkills = await copyBundledSkillsToOpenCodeSkillsDir(globalSkillsRoot, {
@@ -29811,11 +29853,11 @@ var byoao_vault_upgrade = tool({
 
 // dist/tools/mcp-auth.js
 import { spawn, execSync as execSync3 } from "node:child_process";
-import path12 from "node:path";
+import path13 from "node:path";
 import os5 from "node:os";
 function findOpencodeBinary() {
   const candidates = [
-    path12.join(os5.homedir(), ".opencode/bin/opencode"),
+    path13.join(os5.homedir(), ".opencode/bin/opencode"),
     "/usr/local/bin/opencode"
   ];
   for (const p of candidates) {
@@ -29919,7 +29961,7 @@ The user may need to:
 });
 
 // dist/hooks/system-transform.js
-import path13 from "node:path";
+import path14 from "node:path";
 
 // dist/lib/logger.js
 import { join } from "node:path";
@@ -29999,7 +30041,7 @@ async function log(level, source, message, options2) {
 
 // dist/hooks/system-transform.js
 function readVaultMarkdown(vaultPath, fileName) {
-  const full = path13.join(vaultPath, fileName);
+  const full = path14.join(vaultPath, fileName);
   if (!fs.existsSync(full))
     return null;
   try {
@@ -30085,7 +30127,7 @@ function getIdleSuggestion() {
   const suggestions = [
     "Tip: run /cook to compile your notes into structured knowledge pages",
     "Tip: run /health to check knowledge page health",
-    "Tip: run /wiki to regenerate INDEX.base",
+    "Tip: run /wiki to refresh your INDEX.base knowledge map",
     "Tip: run /trace to see how an idea evolved over time",
     "Tip: run /connect to bridge two topics using your vault's link graph",
     "Tip: run /ideas to generate actionable insights from your vault",