dsh-plugin-wiki-tools 0.13.0 → 0.14.0

package/lib/lint.js

@@ -6,7 +6,7 @@
  * @module dsh-plugin-wiki-tools/lib/lint
  */
 
-import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { mkdir, readFile, stat, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import {
   PAGE_STATUSES,
@@ -39,6 +39,7 @@ export async function lintVault(root) {
   checkOrphans(pages, inbound, indexed, add)
   checkFrontmatterGaps(pages, add)
   checkStatusVocabulary(pages, add)
+  await checkStructurePages(root, add)
   checkEmptySections(pages, add)
   await checkHotCacheStaleness(root, pages, add)
 
@@ -193,6 +194,23 @@ function checkStatusVocabulary(pages, add) {
   }
 }
 
+/**
+ * The narrative structure page every vault layout expects. `overview.md` is
+ * human-maintained, so its absence is info — a nudge, not a defect.
+ * @param {string} root - absolute vault root.
+ * @param {Add} add - issue recorder.
+ */
+async function checkStructurePages(root, add) {
+  const overview = join(root, 'wiki', 'overview.md')
+  const exists = await stat(overview).then(() => true, () => false)
+  if (!exists) {
+    add('missing-structure', 'info', 'overview',
+      'wiki/overview.md does not exist',
+      'Run wiki_scaffold (generic) or write a ~200-word vault overview: what the vault is for, its areas, and where things go',
+    )
+  }
+}
+
 /**
  * Headings with no content before the next heading.
  * @param {Pages} pages - collected pages.

package/lib/vault.js

@@ -439,7 +439,9 @@ export class Vault {
         // `\]` / `\|` would be eaten by the template literal and leave an
         // empty alternation branch matching every `[[title` prefix.
         const pattern = new RegExp(`\\[\\[${escapeRegExp(title)}(\\]\\]|\\||#)`, 'g')
-        const updated = raw.replace(pattern, `[[${cleanNew}$1`)
+        let updated = raw.replace(pattern, `[[${cleanNew}$1`)
+        // A page whose links changed today is not "current" as of yesterday.
+        if (updated !== raw) updated = updated.replace(/^(updated:\s*).+$/m, `$1${today()}`)
         if (updated !== raw) {
           await writeFile(page.path, updated, 'utf8')
           rewritten.push(page.name)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-wiki-tools",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Native DeepSeek Harness tools for an Obsidian wiki vault: wiki_query, wiki_write, and wiki_lint implement the mechanical core (path routing, delta tracking, index/log bookkeeping, health checks) of the wiki skill suite.",
   "license": "MIT",
   "type": "module",