diffwiki 0.10.0 → 0.11.0-rc.202607301234.850d29d

package/dist/bin.js

@@ -2,7 +2,7 @@
 
 // src/cli.ts
 import { spawn as spawn4 } from "child_process";
-import { Command } from "commander";
+import { Command, Option } from "commander";
 import {
   addExternalCollection,
   addTags,
@@ -26,6 +26,7 @@ import {
   resolveCwdCollection,
   resolveEditorCommand,
   resolveEditTarget,
+  setArticleMeta,
   setConfigValue,
   setTags,
   updateArticleBody
@@ -57,9 +58,6 @@ function withErrors(fn) {
 }
 var collect = (value, previous) => previous.concat([value]);
 var splitTags = (raw) => raw.flatMap((t) => t.split(",")).map((t) => t.trim()).filter((t) => t.length > 0);
-var deprecated = (oldForm, newForm) => {
-  console.error(`\u26A0 "diffwiki ${oldForm}" is deprecated; use "diffwiki ${newForm}".`);
-};
 
 // src/ui-server.ts
 import { spawn } from "child_process";
@@ -318,16 +316,28 @@ async function createCollectionAction(name) {
   const entry = await createCollection(name);
   console.log(`Created collection "${entry.name}" at ${entry.path}`);
 }
-async function createArticleAction(target, body, tags) {
+async function createArticleAction(target, opts) {
   const article = await createArticle({
     target,
-    tags: splitTags(tags),
-    body
+    tags: splitTags(opts.tag),
+    body: opts.body,
+    audience: opts.audience,
+    status: opts.status
   });
   console.log(article.path);
 }
-async function updateArticleAction(target, body) {
-  const article = await updateArticleBody(target, body);
+async function updateArticleAction(target, opts) {
+  const tagList = splitTags(opts.tag);
+  const hasMeta = opts.audience !== void 0 || opts.status !== void 0;
+  if (opts.body === void 0 && tagList.length === 0 && !hasMeta) {
+    console.error("Nothing to update \u2014 pass -b/--body, -t/--tag, --audience, and/or --status.");
+    process.exitCode = 1;
+    return;
+  }
+  let article;
+  if (opts.body !== void 0) article = await updateArticleBody(target, opts.body);
+  if (tagList.length > 0) article = await setTags(target, tagList);
+  if (hasMeta) article = await setArticleMeta(target, { audience: opts.audience, status: opts.status });
   console.log(`Updated ${article.path}`);
 }
 async function removeArticleAction(target) {
@@ -522,12 +532,8 @@ function createProgram() {
   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"').argument("[body]", "markdown body").option("-t, --tag <tag>", "tag (repeatable, comma-separated)", collect, []).action(
-    withErrors(
-      (target, body, opts) => createArticleAction(target, body, opts.tag)
-    )
-  );
-  article.command("update").description("Replace an article's body").argument("<target>", '"collection:slug"').argument("<body>", "new markdown body").action(withErrors((target, body) => updateArticleAction(target, body)));
+  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("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");
@@ -569,132 +575,8 @@ 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));
-  registerDeprecatedAliases(program);
   return program;
 }
-function registerDeprecatedAliases(program) {
-  program.command("list", { hidden: true }).action(
-    withErrors(() => {
-      deprecated("list", "collection list");
-      return listCollectionsAction();
-    })
-  );
-  program.command("add", { hidden: true }).option("-d, --docs <dir>", "content dir relative to repo root", "docs").action(
-    withErrors((opts) => {
-      deprecated("add", "collection add");
-      return addExternalAction(opts);
-    })
-  );
-  program.command("create", { hidden: true }).argument("<name>", "collection name").action(
-    withErrors((name) => {
-      deprecated("create", "collection create");
-      return createCollectionAction(name);
-    })
-  );
-  program.command("add-article", { hidden: true }).requiredOption("-p, --path <target>", '"[collection:]title"').option("-t, --tag <tag>", "tag (repeatable, comma-separated)", collect, []).argument("[body]", "markdown body").action(
-    withErrors((body, opts) => {
-      deprecated("add-article", "article create");
-      return createArticleAction(opts.path, body, opts.tag);
-    })
-  );
-  program.command("update-article", { hidden: true }).requiredOption("-p, --path <target>", '"collection:path"').argument("<body>", "new markdown body").action(
-    withErrors((body, opts) => {
-      deprecated("update-article", "article update");
-      return updateArticleAction(opts.path, body);
-    })
-  );
-  program.command("remove-article", { hidden: true }).requiredOption("-p, --path <target>", '"collection:path"').action(
-    withErrors((opts) => {
-      deprecated("remove-article", "article remove");
-      return removeArticleAction(opts.path);
-    })
-  );
-  const registerDeprecatedTag = (name, newForm, fn) => {
-    program.command(name, { hidden: true }).requiredOption("-p, --path <target>", '"collection:path"').argument("<tags>", "comma-separated tags").action(
-      withErrors((tagList, opts) => {
-        deprecated(name, newForm);
-        return tagsAction(fn, opts.path, tagList);
-      })
-    );
-  };
-  registerDeprecatedTag("add-tags", "tags add", addTags);
-  registerDeprecatedTag("remove-tags", "tags remove", removeTags);
-  registerDeprecatedTag("update-tags", "tags set", setTags);
-  program.command("index", { hidden: true }).option("--embed", "also build vector embeddings (may download models on first run)").action(
-    withErrors((opts) => {
-      deprecated("index", "search index");
-      return indexAction(opts);
-    })
-  );
-  program.command("query", { hidden: true }).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(
-    withErrors((term, opts) => {
-      deprecated("query", "search query");
-      return queryAction(term, opts);
-    })
-  );
-  program.command("init", { hidden: true }).option("-c, --collection <name>", "collection name (default: repo name)").option("-p, --path <path>", "wiki path within the repo (default: wiki)").action(
-    withErrors((opts) => {
-      deprecated("init", "collection init");
-      return initAction(opts);
-    })
-  );
-  program.command("export", { hidden: true }).requiredOption("-o, --out <dir>", "output directory").option("-b, --base <path>", "base URL path (e.g. /my-repo/ for GitHub Pages)", "/").option("-f, --filter <globs>", "only export collections matching these globs (comma-separated)").option("-e, --exclude <globs>", "exclude collections matching these globs (comma-separated)").option("--project [dir]", "build only the repo project from its diffwiki.yaml (default: cwd)").action(
-    withErrors(
-      (opts) => {
-        deprecated("export", "site export");
-        return exportAction(opts);
-      }
-    )
-  );
-  program.command("config-set", { hidden: true }).argument("<key>", "config key").argument("<value>", "config value").action(
-    withErrors((key, value) => {
-      deprecated("config-set", "config set");
-      return configSetAction(key, value);
-    })
-  );
-  program.command("config-get", { hidden: true }).argument("<key>", "config key").action(
-    withErrors((key) => {
-      deprecated("config-get", "config get");
-      return configGetAction(key);
-    })
-  );
-  program.command("up", { hidden: true }).option("-p, --port <port>", "port to serve on", "4321").action(
-    withErrors((opts) => {
-      deprecated("up", "ui up");
-      return upAction(opts);
-    })
-  );
-  program.command("down", { hidden: true }).action(
-    withErrors(() => {
-      deprecated("down", "ui down");
-      return downAction();
-    })
-  );
-  program.command("status", { hidden: true }).action(
-    withErrors(() => {
-      deprecated("status", "ui status");
-      return statusAction();
-    })
-  );
-  program.command("open", { hidden: true }).option("-p, --port <port>", "port to serve on", "4321").action(
-    withErrors((opts) => {
-      deprecated("open", "ui open");
-      return openAction(opts);
-    })
-  );
-  program.command("edit", { hidden: true }).argument("[target]", 'collection or "collection:slug" (default: the current repo collection)').option("--editor <cmd>", "editor command (overrides config `editor`, $VISUAL, $EDITOR)").action(
-    withErrors((target, opts) => {
-      deprecated("edit", "collection edit / article edit");
-      return editAction(target, opts.editor);
-    })
-  );
-  program.command("preview", { hidden: true }).option("-p, --port <port>", "port to serve on", "4321").action(
-    withErrors((opts) => {
-      deprecated("preview", "site preview");
-      return previewAction(opts);
-    })
-  );
-}
 
 // src/logging.ts
 import { mkdirSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffwiki",
-  "version": "0.10.0",
+  "version": "0.11.0-rc.202607301234.850d29d",
   "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.10.0"
+    "diffwiki-core": "0.11.0-rc.202607301234.850d29d"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"