@bartolli/kmd 0.2.0 → 0.4.0

package/dist/kmd.mjs

@@ -82,6 +82,9 @@ import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { parse } from "yaml";
 import { z } from "zod";
+function kindName(entry) {
+  return typeof entry === "string" ? entry : entry.name;
+}
 async function loadVaultConfig(vaultRoot2) {
   const path = join(vaultRoot2, "vault.yaml");
   let raw;
@@ -98,25 +101,61 @@ ${issues}`);
   }
   return parsed.data;
 }
-var ScopeSchema, VaultConfigSchema;
+var ScopeSchema, KindEntrySchema, VaultConfigSchema, BUILT_IN_KINDS;
 var init_config = __esm({
   "../cli/src/config.ts"() {
     "use strict";
     ScopeSchema = z.object({
       repo: z.string().optional(),
-      methodology: z.enum(["sdd", "tdd", "hybrid"]).optional(),
+      methodology: z.string().optional(),
       status: z.string()
     });
+    KindEntrySchema = z.union([
+      z.string(),
+      z.object({
+        name: z.string(),
+        signal: z.string(),
+        where: z.string()
+      })
+    ]);
     VaultConfigSchema = z.object({
       scopes: z.record(z.string(), ScopeSchema),
-      kinds: z.array(z.string()),
+      kinds: z.array(KindEntrySchema),
       statuses: z.array(z.string()),
       methodologies: z.array(z.string()),
       tags: z.object({
         canonical: z.array(z.string()),
         aliases: z.record(z.string(), z.string())
-      })
+      }),
+      authoring_rules: z.string().optional(),
+      authoring_rules_extra: z.string().optional(),
+      sync_protocol: z.string().optional(),
+      sync_protocol_extra: z.string().optional()
+    }).superRefine((config, ctx) => {
+      for (const [name, scope] of Object.entries(config.scopes)) {
+        if (scope.methodology !== void 0 && !config.methodologies.includes(scope.methodology)) {
+          ctx.addIssue({
+            code: "custom",
+            path: ["scopes", name, "methodology"],
+            message: `"${scope.methodology}" is not in the methodologies list`
+          });
+        }
+      }
     });
+    BUILT_IN_KINDS = /* @__PURE__ */ new Set([
+      "project",
+      "spec",
+      "adr",
+      "plan",
+      "story",
+      "ops",
+      "topic",
+      "article",
+      "src",
+      "note",
+      "artifact",
+      "prompt"
+    ]);
   }
 });
 
@@ -378,9 +417,13 @@ var init_sync = __esm({
 });
 
 // ../cli/src/validate.ts
-import { readFile as readFile3 } from "node:fs/promises";
+import { readFile as readFile3, stat } from "node:fs/promises";
+import { join as join3 } from "node:path";
+function hasIndexableTitle(data) {
+  return typeof data.title === "string" && data.title.trim() !== "";
+}
 function isIndexed(relPath, data) {
-  if (typeof data.title !== "string" || data.title.trim() === "") return false;
+  if (!hasIndexableTitle(data)) return false;
   if (typeof data.kind === "string" && data.kind !== "") return true;
   return relPath.startsWith("notes/");
 }
@@ -402,6 +445,45 @@ function checkRequiredFields(relPath, data) {
       });
     }
   }
+  if (Object.hasOwn(data, "title") && !hasIndexableTitle(data)) {
+    findings.push({
+      path: relPath,
+      rule: "required-fields",
+      severity: "error",
+      message: `"title" must be a non-empty string for kind "${kind}" \u2014 sync skips the page otherwise`
+    });
+  }
+  return findings;
+}
+function customKindNames(cfg) {
+  const names = /* @__PURE__ */ new Set();
+  for (const entry of cfg.kinds) {
+    if (typeof entry !== "string" && !BUILT_IN_KINDS.has(entry.name)) names.add(entry.name);
+  }
+  return names;
+}
+function checkCustomKindFloor(relPath, data, cfg) {
+  const kind = data.kind;
+  if (typeof kind !== "string" || !customKindNames(cfg).has(kind)) return [];
+  const findings = [];
+  for (const field of UNIVERSAL_FLOOR) {
+    if (!Object.hasOwn(data, field)) {
+      findings.push({
+        path: relPath,
+        rule: "custom-kind-floor",
+        severity: "warning",
+        message: `custom kind "${kind}": missing "${field}" \u2014 the universal floor (title, summary, updated) keeps the page retrievable`
+      });
+    }
+  }
+  if (Object.hasOwn(data, "title") && !hasIndexableTitle(data)) {
+    findings.push({
+      path: relPath,
+      rule: "custom-kind-floor",
+      severity: "warning",
+      message: `custom kind "${kind}": "title" is empty \u2014 sync skips title-less pages; this page will not be indexed`
+    });
+  }
   return findings;
 }
 function checkTagsRequired(relPath, data) {
@@ -433,7 +515,7 @@ function checkFolderSlug(relPath, data) {
 function checkVocabulary(relPath, data, cfg) {
   const findings = [];
   const kind = data.kind;
-  if (typeof kind === "string" && !cfg.kinds.includes(kind)) {
+  if (typeof kind === "string" && !cfg.kinds.some((k) => kindName(k) === kind)) {
     findings.push({
       path: relPath,
       rule: "kind-vocabulary",
@@ -572,7 +654,6 @@ function checkSupersededLink(relPath, data) {
 function checkIndexedPage(relPath, data, body, cfg, refIndex) {
   if (!isIndexed(relPath, data)) return [];
   return [
-    ...checkRequiredFields(relPath, data),
     ...checkTagsRequired(relPath, data),
     ...checkFolderSlug(relPath, data),
     ...checkVocabulary(relPath, data, cfg),
@@ -599,7 +680,11 @@ function validatePage(relPath, raw, cfg, refIndex) {
   if (isPrimer(relPath)) {
     return checkBodyLinks(relPath, parsed.content, refIndex);
   }
-  return checkIndexedPage(relPath, parsed.data, parsed.content, cfg, refIndex);
+  return [
+    ...checkRequiredFields(relPath, parsed.data),
+    ...checkCustomKindFloor(relPath, parsed.data, cfg),
+    ...checkIndexedPage(relPath, parsed.data, parsed.content, cfg, refIndex)
+  ];
 }
 function hasErrors(findings) {
   return findings.some((f) => f.severity === "error");
@@ -702,9 +787,22 @@ async function validateVault(root) {
   }
   findings.push(...validateSupersession(pages));
   findings.push(...validateAmbiguousLinks(linkPages, basenameToPaths));
+  for (const name of customKindNames(cfg)) {
+    const file = `templates/${name}.md`;
+    try {
+      await stat(join3(root, file));
+    } catch {
+      findings.push({
+        path: file,
+        rule: "custom-kind-template",
+        severity: "warning",
+        message: `custom kind "${name}" declared in vault.yaml has no template file`
+      });
+    }
+  }
   return findings;
 }
-var REQUIRED_FIELDS, TAG_OPTIONAL_KINDS, FOLDER_PATTERNS;
+var REQUIRED_FIELDS, TAG_OPTIONAL_KINDS, FOLDER_PATTERNS, UNIVERSAL_FLOOR;
 var init_validate = __esm({
   "../cli/src/validate.ts"() {
     "use strict";
@@ -755,6 +853,7 @@ var init_validate = __esm({
       topic: /^research\/[^/]+\/index\.md$/,
       src: /^research\/[^/]+\/src-[^/]+\.md$/
     };
+    UNIVERSAL_FLOOR = ["title", "summary", "updated"];
   }
 });
 
@@ -863,10 +962,10 @@ var init_config2 = __esm({
 // ../mcp/src/db.ts
 import { mkdirSync as mkdirSync2 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
-import { join as join3 } from "node:path";
+import { join as join4 } from "node:path";
 function createDatabase() {
-  const dbDir = join3(homedir2(), ".kmd", "db");
-  const dbPath = join3(dbDir, "index.db");
+  const dbDir = join4(homedir2(), ".kmd", "db");
+  const dbPath = join4(dbDir, "index.db");
   mkdirSync2(dbDir, { recursive: true });
   return openDatabase(dbPath);
 }
@@ -880,7 +979,7 @@ var init_db = __esm({
 // ../mcp/src/lib/diag.ts
 import { appendFileSync, mkdirSync as mkdirSync3 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { join as join4 } from "node:path";
+import { join as join5 } from "node:path";
 function diag(msg, data) {
   try {
     const line = data ? `${(/* @__PURE__ */ new Date()).toISOString()} pid=${process.pid} ${msg} ${JSON.stringify(data)}
@@ -894,8 +993,8 @@ var DIAG_DIR, DIAG_LOG_PATH;
 var init_diag = __esm({
   "../mcp/src/lib/diag.ts"() {
     "use strict";
-    DIAG_DIR = join4(homedir3(), ".local", "state", "wiki-mcp");
-    DIAG_LOG_PATH = join4(DIAG_DIR, "server.log");
+    DIAG_DIR = join5(homedir3(), ".local", "state", "wiki-mcp");
+    DIAG_LOG_PATH = join5(DIAG_DIR, "server.log");
     try {
       mkdirSync3(DIAG_DIR, { recursive: true });
     } catch {
@@ -922,31 +1021,111 @@ var init_logger = __esm({
   }
 });
 
-// ../mcp/src/resources/authoring.ts
+// ../mcp/src/vault-config.ts
 import { readFile as readFile4 } from "node:fs/promises";
-import { join as join5 } from "node:path";
-async function readAuthoringRules(vaultRoot2) {
+import { join as join6 } from "node:path";
+import { parse as parse2 } from "yaml";
+import { z as z4 } from "zod";
+function kindName2(entry) {
+  return typeof entry === "string" ? entry : entry.name;
+}
+async function loadVaultConfig2(vaultRoot2) {
+  const path = join6(vaultRoot2, "vault.yaml");
+  let raw;
   try {
-    const raw = await readFile4(join5(vaultRoot2, "CLAUDE.md"), "utf8");
-    const start = raw.indexOf("## Authoring rules");
-    if (start === -1) return "";
-    const after = raw.indexOf("\n## ", start + 1);
-    const section = after === -1 ? raw.slice(start) : raw.slice(start, after);
-    return section.trim();
-  } catch {
-    return "";
+    raw = await readFile4(path, "utf8");
+  } catch (err) {
+    throw new Error(`vault.yaml not found at ${path}`, { cause: err });
+  }
+  const parsed = VaultConfigSchema2.safeParse(parse2(raw));
+  if (!parsed.success) {
+    const issues = parsed.error.issues.map((i) => `  - ${i.path.join(".") || "(root)"}: ${i.message}`).join("\n");
+    throw new Error(`Invalid vault.yaml at ${path}:
+${issues}`);
   }
+  return parsed.data;
+}
+var ScopeSchema2, KindEntrySchema2, VaultConfigSchema2, BUILT_IN_KINDS2;
+var init_vault_config = __esm({
+  "../mcp/src/vault-config.ts"() {
+    "use strict";
+    ScopeSchema2 = z4.object({
+      repo: z4.string().optional(),
+      methodology: z4.string().optional(),
+      status: z4.string()
+    });
+    KindEntrySchema2 = z4.union([
+      z4.string(),
+      z4.object({
+        name: z4.string(),
+        signal: z4.string(),
+        where: z4.string()
+      })
+    ]);
+    VaultConfigSchema2 = z4.object({
+      scopes: z4.record(z4.string(), ScopeSchema2),
+      kinds: z4.array(KindEntrySchema2),
+      statuses: z4.array(z4.string()),
+      methodologies: z4.array(z4.string()),
+      tags: z4.object({
+        canonical: z4.array(z4.string()),
+        aliases: z4.record(z4.string(), z4.string())
+      }),
+      authoring_rules: z4.string().optional(),
+      authoring_rules_extra: z4.string().optional(),
+      sync_protocol: z4.string().optional(),
+      sync_protocol_extra: z4.string().optional()
+    }).superRefine((config, ctx) => {
+      for (const [name, scope] of Object.entries(config.scopes)) {
+        if (scope.methodology !== void 0 && !config.methodologies.includes(scope.methodology)) {
+          ctx.addIssue({
+            code: "custom",
+            path: ["scopes", name, "methodology"],
+            message: `"${scope.methodology}" is not in the methodologies list`
+          });
+        }
+      }
+    });
+    BUILT_IN_KINDS2 = /* @__PURE__ */ new Set([
+      "project",
+      "spec",
+      "adr",
+      "plan",
+      "story",
+      "ops",
+      "topic",
+      "article",
+      "src",
+      "note",
+      "artifact",
+      "prompt"
+    ]);
+  }
+});
+
+// ../mcp/src/resources/authoring.ts
+function buildAuthoringRules(config) {
+  const parts = [(config.authoring_rules ?? DEFAULT_AUTHORING_RULES).trim()];
+  if (config.authoring_rules_extra) parts.push(config.authoring_rules_extra.trim());
+  return ["## Authoring rules", "", parts.join("\n\n")].join("\n");
+}
+function buildSyncProtocol(config) {
+  const parts = [(config.sync_protocol ?? DEFAULT_SYNC_PROTOCOL).trim()];
+  if (config.sync_protocol_extra) parts.push(config.sync_protocol_extra.trim());
+  return ["## Resync protocol", "", parts.join("\n\n")].join("\n");
 }
 function buildKindSelector(kinds) {
   const lines = ["## Kind selector", "", "| Signal | Kind | Where |", "|---|---|---|"];
-  for (const kind of kinds) {
-    const pedagogy = KIND_PEDAGOGY.get(kind);
+  for (const entry of kinds) {
+    const name = kindName2(entry);
+    const pedagogy = typeof entry === "string" ? KIND_PEDAGOGY.get(entry) : entry;
     const signal = pedagogy?.signal ?? "\u2014";
     const where = pedagogy?.where ?? "\u2014";
-    lines.push(`| ${signal} | **${kind}** | ${where} |`);
+    lines.push(`| ${signal} | **${name}** | ${where} |`);
   }
-  const hasNote = kinds.includes("note");
-  const hasAdrAndSpec = kinds.includes("adr") && kinds.includes("spec");
+  const names = kinds.map(kindName2);
+  const hasNote = names.includes("note");
+  const hasAdrAndSpec = names.includes("adr") && names.includes("spec");
   if (hasNote || hasAdrAndSpec) {
     const hints = [];
     if (hasNote) hints.push("If none fits \u2192 note.");
@@ -959,12 +1138,16 @@ function buildKindSelector(kinds) {
   }
   return lines.join("\n");
 }
+function buildStatusLine(statuses) {
+  const isCanonical = statuses.length === CANONICAL_STATUS_FLOW.length && statuses.every((s, i) => s === CANONICAL_STATUS_FLOW[i]);
+  return isCanonical ? `**Statuses:** ${statuses.join(" \u2192 ")} (one-directional; superseded requires superseded_by link)` : `**Statuses:** ${statuses.join(", ")}`;
+}
 function buildVocabulary(config) {
   const lines = [
     "## Controlled vocabulary",
     "",
-    `**Kinds:** ${config.kinds.join(", ")}`,
-    `**Statuses:** ${config.statuses.join(" \u2192 ")} (one-directional; superseded requires superseded_by link)`,
+    `**Kinds:** ${config.kinds.map(kindName2).join(", ")}`,
+    buildStatusLine(config.statuses),
     `**Methodologies:** ${config.methodologies.join(", ")}`,
     `**Canonical tags:** ${config.tags.canonical.join(", ")}`
   ];
@@ -974,16 +1157,15 @@ function buildVocabulary(config) {
   }
   return lines.join("\n");
 }
-function registerAuthoringResource(mcp, vaultRoot2, vaultConfig) {
+function registerAuthoringResource(mcp, _vaultRoot, vaultConfig) {
   mcp.registerResource(
     "Authoring guide",
     "wiki://authoring",
     {
-      description: "Wiki authoring pedagogy: kind selector, controlled vocabulary, authoring rules, and template URIs. Read before creating or editing wiki pages.",
+      description: "Wiki authoring pedagogy: kind selector, controlled vocabulary, authoring rules, resync protocol, and template URIs. Read before creating or editing wiki pages.",
       mimeType: "text/markdown"
     },
     async (uri) => {
-      const rules = await readAuthoringRules(vaultRoot2);
       const sections = [
         "# Wiki authoring guide",
         "",
@@ -993,11 +1175,12 @@ function registerAuthoringResource(mcp, vaultRoot2, vaultConfig) {
         "",
         "## Templates",
         "",
-        "Full index with URIs and descriptions: `wiki://templates`"
+        "Full index with URIs and descriptions: `wiki://templates`",
+        "",
+        buildAuthoringRules(vaultConfig),
+        "",
+        buildSyncProtocol(vaultConfig)
       ];
-      if (rules) {
-        sections.push("", rules);
-      }
       return {
         contents: [
           {
@@ -1010,10 +1193,11 @@ function registerAuthoringResource(mcp, vaultRoot2, vaultConfig) {
     }
   );
 }
-var KIND_PEDAGOGY;
+var KIND_PEDAGOGY, DEFAULT_AUTHORING_RULES, DEFAULT_SYNC_PROTOCOL, CANONICAL_STATUS_FLOW;
 var init_authoring = __esm({
   "../mcp/src/resources/authoring.ts"() {
     "use strict";
+    init_vault_config();
     KIND_PEDAGOGY = /* @__PURE__ */ new Map([
       [
         "project",
@@ -1094,21 +1278,74 @@ var init_authoring = __esm({
         }
       ]
     ]);
+    DEFAULT_AUTHORING_RULES = [
+      "**Where things go**",
+      "",
+      "- **Use the matching template** via `wiki://template/{domain}/{kind}` (MCP) or from `templates/` (filesystem). Don't hand-roll frontmatter.",
+      "- **Folder name = slug prefix in `projects/`.** `spec/spec-x.md`, `adr/adr-y.md`, `plan/plan-z.md`, `ops/ops-w.md`. Stories use `story-` prefix under `plan/{plan-name}/`.",
+      "- **Research is flat.** Articles are `{subject}.md`; sources are `src-{slug}.md`. The topic folder names a *frame*, the article slug names a *subject*. Avoid generic slugs (`architecture.md`, `notes.md`) and slugs that collide with project scopes.",
+      "- **Extend before you split.** Prefer sharpening the existing spec, ADR, or article over creating a near-duplicate page. A new page needs a new subject, not a new session.",
+      "",
+      "**Frontmatter**",
+      "",
+      '- **`summary` is the retrieval contract.** One sentence stating the page\'s decision or claim, not its topic. Search and `prime` rank by it \u2014 "Chose X over Y because Z" surfaces; "About the sync pipeline" sinks.',
+      '- **Quote prose-bearing scalars.** `summary: "..."` \u2014 unquoted `Word: phrase` patterns break the YAML parser.',
+      "- **On any edit, update `updated`.** Never change `created` \u2014 it is write-once.",
+      "- **Notes have no `kind` field** \u2014 implied by location. Sync sets `kind: note`.",
+      "- **Reuse existing tags** (visible in `prime` response `top_tags`). No synonyms.",
+      "",
+      "**Content**",
+      "",
+      "- **ADR and ops pages are predicate-only.** No definitional preambles for established vocabulary, no narrative, no marketing. The audience is the project team \u2014 assume fluency.",
+      "- **Spec / ADR edits land inline with the change that surfaces them.** Don't queue corrections in plans \u2014 the spec reflects current code at every commit.",
+      "",
+      "**Linking**",
+      "",
+      "- **Cross-reference with `[[wikilinks]]`, and link every mention of another vault page** \u2014 backlinks are the navigation graph for humans and agents alike. Don't link pages that don't exist yet: dangling links fail validation.",
+      "- **ADR supersession is bidirectional**: `superseded_by` on the old ADR + `supersedes` on the new one.",
+      "- **Sources convention**: external paths/URLs go inline in body text. Vault-internal `raw/` paths go in frontmatter `sources:` array. Don't mix the two surfaces."
+    ].join("\n");
+    DEFAULT_SYNC_PROTOCOL = [
+      "Edit the smallest set of files that reflects the change. A milestone tick is plan-only; don't cascade to index.md unless phase or status changed. Controlled-vocabulary edits (`vault.yaml`) need explicit user approval.",
+      "After editing wiki pages, run `kmd validate` and fix findings before `kmd sync` \u2014 it checks frontmatter shape, vocabulary membership, and link integrity."
+    ].join("\n");
+    CANONICAL_STATUS_FLOW = ["draft", "active", "superseded", "archived"];
   }
 });
 
 // ../mcp/src/resources/templates.ts
 import { readFile as readFile5 } from "node:fs/promises";
-import { join as join6 } from "node:path";
-function registerTemplateResources(mcp, vaultRoot2) {
-  const dir = join6(vaultRoot2, "templates");
-  for (const tmpl of TEMPLATES) {
+import { join as join7 } from "node:path";
+function customTemplates(config) {
+  const specs = [];
+  for (const entry of config.kinds) {
+    if (typeof entry === "string" || BUILT_IN_KINDS2.has(entry.name)) continue;
+    specs.push({
+      uri: `wiki://template/${entry.name}`,
+      name: entry.name.charAt(0).toUpperCase() + entry.name.slice(1),
+      file: `${entry.name}.md`,
+      description: entry.signal
+    });
+  }
+  return specs;
+}
+function registerTemplateResources(mcp, vaultRoot2, vaultConfig) {
+  const dir = join7(vaultRoot2, "templates");
+  const templates = [...TEMPLATES, ...customTemplates(vaultConfig)];
+  for (const tmpl of templates) {
     mcp.registerResource(
       tmpl.name,
       tmpl.uri,
       { description: tmpl.description, mimeType: "text/markdown" },
       async (uri) => {
-        const text = await readFile5(join6(dir, tmpl.file), "utf8");
+        let text;
+        try {
+          text = await readFile5(join7(dir, tmpl.file), "utf8");
+        } catch (err) {
+          throw new Error(`template file missing: templates/${tmpl.file} (${tmpl.uri})`, {
+            cause: err
+          });
+        }
         return {
           contents: [
             {
@@ -1122,7 +1359,7 @@ function registerTemplateResources(mcp, vaultRoot2) {
     );
   }
   const indexLines = ["# Wiki Templates", ""];
-  for (const tmpl of TEMPLATES) {
+  for (const tmpl of templates) {
     indexLines.push(`- **${tmpl.name}** \u2014 \`${tmpl.uri}\`  `);
     indexLines.push(`  ${tmpl.description}`);
   }
@@ -1143,6 +1380,7 @@ var TEMPLATES;
 var init_templates = __esm({
   "../mcp/src/resources/templates.ts"() {
     "use strict";
+    init_vault_config();
     TEMPLATES = [
       {
         uri: "wiki://template/project/index",
@@ -1283,14 +1521,14 @@ var init_toolResponse = __esm({
 
 // ../mcp/src/tools/prime.ts
 import { readFile as readFile6 } from "node:fs/promises";
-import { basename as basename2, join as join7 } from "node:path";
-import { z as z4 } from "zod";
+import { basename as basename2, join as join8 } from "node:path";
+import { z as z5 } from "zod";
 function pathSlug(p) {
   return basename2(p).replace(/\.md$/, "");
 }
 async function readIndexFm(vaultRoot2, scope) {
   try {
-    const raw = await readFile6(join7(vaultRoot2, "projects", scope, "index.md"), "utf8");
+    const raw = await readFile6(join8(vaultRoot2, "projects", scope, "index.md"), "utf8");
     return parseFrontmatter2(raw).data;
   } catch {
     return {};
@@ -1298,7 +1536,7 @@ async function readIndexFm(vaultRoot2, scope) {
 }
 async function readPrimer(vaultRoot2, scope) {
   try {
-    const raw = await readFile6(join7(vaultRoot2, "projects", scope, "primer.md"), "utf8");
+    const raw = await readFile6(join8(vaultRoot2, "projects", scope, "primer.md"), "utf8");
     return parseFrontmatter2(raw).content.trim().replace(/^#\s+[^\n]+\n+/, "");
   } catch {
     return "";
@@ -1425,7 +1663,7 @@ function renderMarkdown(d, config, task) {
     lines.push(countEntries.map(([k, n]) => `${k}: ${n}`).join(" | "));
   }
   lines.push("", "## Vocabulary");
-  lines.push(`kinds: ${config.kinds.join(", ")}`);
+  lines.push(`kinds: ${config.kinds.map(kindName2).join(", ")}`);
   lines.push(`statuses: ${config.statuses.join(", ")}`);
   lines.push(`tags: ${config.tags.canonical.join(", ")}`);
   if (d.top_tags.length > 0) {
@@ -1459,7 +1697,7 @@ function renderMarkdown(d, config, task) {
   lines.push(
     "",
     "---",
-    "Authoring wiki content? Read `wiki://authoring` for kind selector, rules, and templates."
+    "Authoring wiki content? Read `wiki://authoring` for kind selector, rules, and templates. After edits: `kmd validate`, then `kmd sync`."
   );
   return lines.join("\n");
 }
@@ -1488,15 +1726,16 @@ var init_prime = __esm({
     init_frontmatter2();
     init_fts();
     init_toolResponse();
-    PrimeInputSchema = z4.object({
-      scope: z4.string().min(1).describe("Project scope to prime (matches projects/{scope}/ in the vault)."),
-      task: z4.string().optional().describe("Optional task description; surfaces top-3 tsvector-ranked relevant pages.")
+    init_vault_config();
+    PrimeInputSchema = z5.object({
+      scope: z5.string().min(1).describe("Project scope to prime (matches projects/{scope}/ in the vault)."),
+      task: z5.string().optional().describe("Optional task description; surfaces top-3 tsvector-ranked relevant pages.")
     });
   }
 });
 
 // ../mcp/src/tools/search.ts
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 function search(deps, input) {
   const ftsQuery = sanitizeFtsQuery(input.query);
   if (!ftsQuery) return { results: [] };
@@ -1543,15 +1782,15 @@ var init_search = __esm({
     "use strict";
     init_fts();
     init_toolResponse();
-    SearchInputSchema = z5.object({
-      query: z5.string().min(1).describe(
+    SearchInputSchema = z6.object({
+      query: z6.string().min(1).describe(
         "Natural-language search query. Matched against title, summary, and body via SQLite FTS5."
       ),
-      scope: z5.string().optional().describe('Optional: restrict to a project scope (e.g. "ontology", "sotto").'),
-      kind: z5.string().optional().describe(
+      scope: z6.string().optional().describe('Optional: restrict to a project scope (e.g. "ontology", "sotto").'),
+      kind: z6.string().optional().describe(
         "Optional: restrict to a kind. Project kinds: spec, adr, plan, ops. Research kinds: article, src. Misc: note."
       ),
-      limit: z5.number().int().min(1).max(50).default(5).describe("Maximum number of ranked results to return. Default 5.")
+      limit: z6.number().int().min(1).max(50).default(5).describe("Maximum number of ranked results to return. Default 5.")
     });
   }
 });
@@ -1579,7 +1818,7 @@ function buildServer(args) {
       return handleSearch({ db }, input);
     }
   );
-  registerTemplateResources(mcp, vaultRoot2);
+  registerTemplateResources(mcp, vaultRoot2, vaultConfig);
   registerAuthoringResource(mcp, vaultRoot2, vaultConfig);
   return mcp;
 }
@@ -1593,49 +1832,6 @@ var init_server = __esm({
   }
 });
 
-// ../mcp/src/vault-config.ts
-import { readFile as readFile7 } from "node:fs/promises";
-import { join as join8 } from "node:path";
-import { parse as parse2 } from "yaml";
-import { z as z6 } from "zod";
-async function loadVaultConfig2(vaultRoot2) {
-  const path = join8(vaultRoot2, "vault.yaml");
-  let raw;
-  try {
-    raw = await readFile7(path, "utf8");
-  } catch (err) {
-    throw new Error(`vault.yaml not found at ${path}`, { cause: err });
-  }
-  const parsed = VaultConfigSchema2.safeParse(parse2(raw));
-  if (!parsed.success) {
-    const issues = parsed.error.issues.map((i) => `  - ${i.path.join(".") || "(root)"}: ${i.message}`).join("\n");
-    throw new Error(`Invalid vault.yaml at ${path}:
-${issues}`);
-  }
-  return parsed.data;
-}
-var ScopeSchema2, VaultConfigSchema2;
-var init_vault_config = __esm({
-  "../mcp/src/vault-config.ts"() {
-    "use strict";
-    ScopeSchema2 = z6.object({
-      repo: z6.string().optional(),
-      methodology: z6.enum(["sdd", "tdd", "hybrid"]).optional(),
-      status: z6.string()
-    });
-    VaultConfigSchema2 = z6.object({
-      scopes: z6.record(z6.string(), ScopeSchema2),
-      kinds: z6.array(z6.string()),
-      statuses: z6.array(z6.string()),
-      methodologies: z6.array(z6.string()),
-      tags: z6.object({
-        canonical: z6.array(z6.string()),
-        aliases: z6.record(z6.string(), z6.string())
-      })
-    });
-  }
-});
-
 // ../mcp/src/start.ts
 var start_exports = {};
 __export(start_exports, {