diffwiki 0.12.0 → 0.14.0

package/dist/bin.js

@@ -13,6 +13,7 @@ import {
   getConfigValue,
   initRepoWiki,
   installPlugin,
+  lintCollections,
   listCollections as listCollections2,
   listAvailablePlugins,
   listPlugins,
@@ -312,9 +313,9 @@ async function addExternalAction(opts) {
   console.log(`Added "${entry.name}"${branch} \u2192 ${entry.path}`);
   console.log("Registered globally \u2014 discoverable via: diffwiki collection list");
 }
-async function createCollectionAction(name) {
-  const entry = await createCollection(name);
-  console.log(`Created collection "${entry.name}" at ${entry.path}`);
+async function createCollectionAction(name, opts) {
+  const entry = await createCollection(name, opts.hidden ? { audience: "system" } : void 0);
+  console.log(`Created ${entry.audience === "system" ? "hidden " : ""}collection "${entry.name}" at ${entry.path}`);
 }
 async function createArticleAction(target, opts) {
   const article = await createArticle({
@@ -361,7 +362,12 @@ async function indexAction(opts) {
   console.log(`Indexed ${indexed} document(s).`);
 }
 async function queryAction(term, opts) {
-  const queryOpts = { engine: opts.engine, collection: opts.collection, type: opts.type };
+  const names = opts.collection ? opts.collection.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+  const queryOpts = {
+    engine: opts.engine,
+    collection: names && names.length === 1 ? names[0] : names,
+    type: opts.type
+  };
   const outcome = await search(term, queryOpts);
   const hits = outcome.hits;
   console.log(`${hits.length} result(s)`);
@@ -459,6 +465,21 @@ async function doctorAction() {
     process.exitCode = 1;
   }
 }
+async function lintAction(opts) {
+  const result = await lintCollections(opts.collections);
+  for (const file of result.files) {
+    if (file.findings.length === 0) {
+      console.log(`\u2713 ${file.path}`);
+      continue;
+    }
+    for (const f of file.findings) {
+      console.log(`${f.level === "error" ? "\u2716" : "!"} ${file.path}: ${f.message}`);
+    }
+  }
+  console.log(`
+${result.fileCount} file(s), ${result.errorCount} error(s), ${result.warnCount} warning(s)`);
+  if (result.errorCount > 0) process.exitCode = 1;
+}
 async function upAction(opts) {
   const existing = await readState();
   if (existing && isAlive(existing.pid)) {
@@ -527,13 +548,21 @@ function createProgram() {
   });
   const collection = program.command("collection").description("Manage collections (containers)");
   collection.command("list").description("List all collections").action(withErrors(listCollectionsAction));
-  collection.command("create").description("Create a new global collection").argument("<name>", "collection name").action(withErrors((name) => createCollectionAction(name)));
+  collection.command("create").description("Create a new global collection").argument("<name>", "collection name").option("--hidden", "create as a hidden system collection (audience: system)").action(withErrors((name, opts) => createCollectionAction(name, opts)));
   collection.command("add").description("Add the current git repo as an external collection (docs dir, no diffwiki.yaml)").option("-d, --docs <dir>", "content dir relative to repo root", "docs").action(withErrors((opts) => addExternalAction(opts)));
   collection.command("init").description("Initialize an in-repo wiki and register it globally").option("-c, --collection <name>", "collection name (default: repo name)").option("-p, --path <path>", "wiki path within the repo (default: wiki)").action(withErrors((opts) => initAction(opts)));
   collection.command("edit").description("Open a collection in your editor \u2014 GUI not required").argument("[name]", "collection (default: the current repo collection)").option("--editor <cmd>", "editor command (overrides config `editor`, $VISUAL, $EDITOR)").action(withErrors((name, opts) => editAction(name, opts.editor)));
   const article = program.command("article").description("Manage articles (documents)");
-  article.command("create").description("Add an article to a collection").argument("<target>", '"[collection:]title"').option("-b, --body <markdown>", 'article body (default: a "# <title>" heading)').option("-t, --tag <tag>", "tag (repeatable, comma-separated)", collect, []).addOption(new Option("--audience <audience>", "visibility (default: public)").choices(["public", "private"])).addOption(new Option("--status <status>", "publish status (default: published)").choices(["draft", "published"])).action(withErrors((target, opts) => createArticleAction(target, opts)));
-  article.command("update").description("Update an article's body, tags, audience, and/or status").argument("<target>", '"collection:slug"').option("-b, --body <markdown>", "replace the article body").option("-t, --tag <tag>", "replace all tags (repeatable, comma-separated)", collect, []).addOption(new Option("--audience <audience>", "set visibility").choices(["public", "private"])).addOption(new Option("--status <status>", "set publish status").choices(["draft", "published"])).action(withErrors((target, opts) => updateArticleAction(target, opts)));
+  article.command("create").description("Add an article to a collection").argument("<target>", '"[collection:]title"').option("-b, --body <markdown>", 'article body (default: a "# <title>" heading)').option("-t, --tag <tag>", "tag (repeatable, comma-separated)", collect, []).addOption(
+    new Option("--audience <audience>", "visibility (default: public)").choices(["public", "private", "system"])
+  ).addOption(
+    new Option("--status <status>", "publish status (default: published)").choices([
+      "draft",
+      "published",
+      "deprecated"
+    ])
+  ).action(withErrors((target, opts) => createArticleAction(target, opts)));
+  article.command("update").description("Update an article's body, tags, audience, and/or status").argument("<target>", '"collection:slug"').option("-b, --body <markdown>", "replace the article body").option("-t, --tag <tag>", "replace all tags (repeatable, comma-separated)", collect, []).addOption(new Option("--audience <audience>", "set visibility").choices(["public", "private", "system"])).addOption(new Option("--status <status>", "set publish status").choices(["draft", "published", "deprecated"])).action(withErrors((target, opts) => updateArticleAction(target, opts)));
   article.command("remove").description("Delete an article").argument("<target>", '"collection:slug"').action(withErrors((target) => removeArticleAction(target)));
   article.command("edit").description("Open an article in your editor \u2014 GUI not required").argument("<target>", '"collection:slug"').option("--editor <cmd>", "editor command (overrides config `editor`, $VISUAL, $EDITOR)").action(withErrors((target, opts) => editAction(target, opts.editor)));
   const tags = program.command("tags").description("Manage an article's tags");
@@ -544,7 +573,7 @@ function createProgram() {
   registerTagsSub("remove", "Remove from an article's tags", removeTags);
   registerTagsSub("set", "Replace an article's tags", setTags);
   const searchCmd = program.command("search").description("Search articles and manage the index");
-  searchCmd.command("query").alias("q").description("Search articles via the resolved search engine (native fallback if none)").option("--engine <name>", "search engine/plugin (default: config defaultSearch, else native)").option("-c, --collection <name>", "limit to a collection").option("-t, --type <type>", "search type (engine-defined, e.g. keyword|semantic|hybrid)").argument("[term]", "search term", "").action(
+  searchCmd.command("query").alias("q").description("Search articles via the resolved search engine (native fallback if none)").option("--engine <name>", "search engine/plugin (default: config defaultSearch, else native)").option("-c, --collection <names>", "limit to a collection (comma-separated for a set)").option("-t, --type <type>", "search type (engine-defined, e.g. keyword|semantic|hybrid)").argument("[term]", "search term", "").action(
     withErrors(
       (term, opts) => queryAction(term, opts)
     )
@@ -575,6 +604,7 @@ function createProgram() {
   config.command("set").description("Set a config value (e.g. defaultCollection, or defaultSearch <engine[:type]>)").argument("<key>", "config key").argument("<value>", "config value").action(withErrors((key, value) => configSetAction(key, value)));
   config.command("get").description("Read a config value").argument("<key>", "config key").action(withErrors((key) => configGetAction(key)));
   program.command("doctor").description("Diagnose configuration issues").action(withErrors(doctorAction));
+  program.command("lint").description("Lint articles against the template shapes (frontmatter, budgets, references)").option("-c, --collections <scope>", "current | all | comma-separated names", "current").action(withErrors((opts) => lintAction(opts)));
   return program;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffwiki",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "diffwiki command-line interface",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,7 @@
     "@logtape/logtape": "^2.2.4",
     "@logtape/file": "^2.2.4",
     "commander": "^13.0.0",
-    "diffwiki-core": "0.12.0"
+    "diffwiki-core": "0.14.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"