dsh-plugin-wiki-tools 0.10.1 → 0.11.0

package/lib/lint.js

@@ -9,6 +9,7 @@
 import { mkdir, readFile, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import {
+  PAGE_STATUSES,
   buildAliasMap,
   collectMarkdown,
   isMachineryPage,
@@ -37,6 +38,7 @@ export async function lintVault(root) {
   const inbound = checkDeadLinks(pages, add)
   checkOrphans(pages, inbound, indexed, add)
   checkFrontmatterGaps(pages, add)
+  checkStatusVocabulary(pages, add)
   checkEmptySections(pages, add)
   await checkHotCacheStaleness(root, pages, add)
 
@@ -172,6 +174,25 @@ function checkFrontmatterGaps(pages, add) {
   }
 }
 
+/**
+ * Status values outside the lifecycle vocabulary (seed/developing/mature/
+ * evergreen). A stray value silently breaks status-based queries and
+ * promotion flows, so it is flagged even though links stay intact.
+ * @param {Pages} pages - collected pages.
+ * @param {Add} add - issue recorder.
+ */
+function checkStatusVocabulary(pages, add) {
+  for (const page of pages) {
+    if (isMachineryPage(page.name)) continue
+    const status = page.fields?.status
+    if (typeof status === 'string' && !PAGE_STATUSES.includes(status)) {
+      add('status-vocabulary', 'warn', page.name,
+        `status "${status}" is outside the lifecycle vocabulary (${PAGE_STATUSES.join('/')})`,
+        `Set status to one of ${PAGE_STATUSES.join('/')}`)
+    }
+  }
+}
+
 /**
  * Headings with no content before the next heading.
  * @param {Pages} pages - collected pages.

package/lib/vault.js

@@ -32,6 +32,9 @@ export const TYPE_FOLDERS = {
   meta: 'wiki/meta',
 }
 
+/** Lifecycle status vocabulary; writePage rejects anything else and lint flags it. */
+export const PAGE_STATUSES = ['seed', 'developing', 'mature', 'evergreen']
+
 /** Master-index section headings follow the mapped folder basename, computed per vault. */
 
 /**
@@ -284,6 +287,9 @@ export class Vault {
       const existing = await this.readPage(path)
       await this.assertUniqueFilename(cleanTitle, path)
       validateExtraFrontmatter(extraFrontmatter)
+      if (status !== undefined && !PAGE_STATUSES.includes(status)) {
+        throw new Error(`wiki-tools: status must be one of ${PAGE_STATUSES.join('/')} (got ${JSON.stringify(status)})`)
+      }
       const date = today()
       const fields = {
         ...(existing?.fields ?? {}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-wiki-tools",
-  "version": "0.10.1",
+  "version": "0.11.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",