kingminos 0.2.1 → 2026.10.2300

package/README.md

@@ -103,6 +103,18 @@ node dist/kingminos.js --help
 npm run ci
 ```
 
+## Releases & versioning
+
+Published npm versions use **CalVer** in npm-safe semver form: `YYYY.M.DDNN` (UTC calendar date, month without a leading zero, day encoded in the patch as `DD×100+NN`). Examples: `2026.10.2300` (first release on 2026-10-23), `2026.10.2301` (second that day), `2027.1.500` (2027-01-05). Git tags are `v` plus that version (e.g. `v2026.10.2300`).
+
+On `main`, `package.json` stays at a **placeholder** (`0.0.0-dev`). The authoritative version for each release is the git tag; CI bumps `package.json` only in the publish job before `npm publish`, without committing back to `main`.
+
+After [CI](.github/workflows/ci.yml) succeeds on a push to `main` (or on a manual **Publish** workflow run on `main`), [.github/workflows/publish.yml](.github/workflows/publish.yml) plans the next version, skips when there are no releasable commits since the last tag, builds and tests, publishes to npm with OIDC trusted publishing (`npm publish --provenance`), then creates the git tag and GitHub release. Preview locally:
+
+```bash
+npm run release:preview
+```
+
 ## License
 
 MIT — see [LICENSE](LICENSE).

package/dist/kingminos.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/kingminos.ts
-import { readFileSync, realpathSync } from "fs";
-import { fileURLToPath } from "url";
+import { readFileSync as readFileSync2, realpathSync } from "fs";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/sanitize.ts
 function stripSafeToWrite(value) {
@@ -98,7 +98,7 @@ var BYOK_PROVIDERS = [
 function isByokProvider(value) {
   return BYOK_PROVIDERS.includes(value);
 }
-var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["help", "h", "dry-run", "skip-cache", "json"]);
+var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["help", "h", "version", "V", "dry-run", "skip-cache", "json"]);
 var GLOBAL_FLAGS = /* @__PURE__ */ new Set(["token", "base-url", "help", "h", "json"]);
 var EXIT = {
   ok: 0,
@@ -416,6 +416,10 @@ function parseArgv(argv) {
       flags[name] = value;
       continue;
     }
+    if (arg === "-V" || arg === "-v") {
+      flags.version = true;
+      continue;
+    }
     if (arg === "-h") {
       flags.help = true;
       continue;
@@ -604,9 +608,9 @@ function pathForPriority(priority) {
   return priority;
 }
 function applyPriority(body, priority, _capability) {
-  const path = pathForPriority(priority);
+  const path2 = pathForPriority(priority);
   const routing = body.routing && typeof body.routing === "object" && !Array.isArray(body.routing) ? body.routing : {};
-  return { ...body, routing: { ...routing, path } };
+  return { ...body, routing: { ...routing, path: path2 } };
 }
 function formatDecisionNotes(body) {
   if (!body || typeof body !== "object" || Array.isArray(body)) {
@@ -739,10 +743,10 @@ function buildRequest(command, flags, loader) {
       return assertNever(command);
   }
 }
-function capabilityPost(path, body, flags, options) {
+function capabilityPost(path2, body, flags, options) {
   return {
     method: "POST",
-    path,
+    path: path2,
     headers: {
       ...explainSchemaHeaders(flags),
       ...optionalHeader("Idempotency-Key", flagString(flags, "idempotency-key")),
@@ -965,10 +969,10 @@ function personB2bSocialBody(flags, loader) {
 }
 function assignRouting(body, flags) {
   assignJson(body, "routing", flags);
-  const path = flagString(flags, "path");
-  if (path !== void 0) {
+  const path2 = flagString(flags, "path");
+  if (path2 !== void 0) {
     const routing = body.routing && typeof body.routing === "object" && !Array.isArray(body.routing) ? body.routing : {};
-    body.routing = { ...routing, path };
+    body.routing = { ...routing, path: path2 };
   }
 }
 function expectedCompany(flags) {
@@ -1046,11 +1050,11 @@ function loadBodyObject(raw, loader) {
     return parseObjectJson(loader.stdin, "--body -");
   }
   if (raw.startsWith("@")) {
-    const path = raw.slice(1);
-    if (!path) {
+    const path2 = raw.slice(1);
+    if (!path2) {
       throw new UsageError("--body @file requires a path");
     }
-    return parseObjectJson(loader.readFile(path), `--body @${path}`);
+    return parseObjectJson(loader.readFile(path2), `--body @${path2}`);
   }
   return parseObjectJson(raw, "--body");
 }
@@ -1511,6 +1515,22 @@ function stringField2(body, key) {
   return typeof value === "string" && value !== "" ? value : void 0;
 }
 
+// src/version.ts
+import { readFileSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+var cachedVersion;
+function getPackageVersion() {
+  if (cachedVersion !== void 0) {
+    return cachedVersion;
+  }
+  const entryDir = path.dirname(fileURLToPath(import.meta.url));
+  const pkgPath = path.join(entryDir, "..", "package.json");
+  const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+  cachedVersion = typeof pkg.version === "string" ? pkg.version : "0.0.0";
+  return cachedVersion;
+}
+
 // src/kingminos.ts
 async function runCli(io) {
   try {
@@ -1530,6 +1550,11 @@ async function runCli(io) {
 }
 async function runCliUnsafe(io) {
   const parsed = parseArgv(io.argv);
+  if (parsed.flags.version === true || parsed.flags.V === true) {
+    io.stdout(`${getPackageVersion()}
+`);
+    return 0;
+  }
   if (parsed.flags.help === true || parsed.flags.h === true) {
     if (parsed.positionals.length === 0) {
       io.stdout(ROOT_HELP);
@@ -1549,7 +1574,7 @@ async function runCliUnsafe(io) {
     return runBatch(io, command, parsed.flags);
   }
   const request = buildRequest(command, parsed.flags, {
-    readFile: io.readFile ?? ((path) => readFileSync(path, "utf8")),
+    readFile: io.readFile ?? ((path2) => readFileSync2(path2, "utf8")),
     stdin: io.stdin ?? ""
   });
   const token = request.auth ? requireToken(parsed.flags, io.env) : void 0;
@@ -1608,7 +1633,7 @@ async function runBatch(io, command, flags) {
     );
   }
   const loader = {
-    readFile: io.readFile ?? ((path) => readFileSync(path, "utf8")),
+    readFile: io.readFile ?? ((path2) => readFileSync2(path2, "utf8")),
     stdin: io.stdin ?? ""
   };
   const raw = file === "-" ? loader.stdin : loader.readFile(file);
@@ -1768,7 +1793,7 @@ function redact(text, secrets) {
   return secrets.reduce((out, secret) => out.split(secret).join("[redacted]"), text);
 }
 function launchedAsCli() {
-  const self = fileURLToPath(import.meta.url);
+  const self = fileURLToPath2(import.meta.url);
   const argv1 = process.argv[1];
   if (!argv1) {
     return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingminos",
-  "version": "0.2.1",
+  "version": "2026.10.2300",
   "description": "KingMinos CLI — call the KingMinos API from your terminal",
   "license": "MIT",
   "type": "module",
@@ -29,12 +29,16 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "npm run build && node --experimental-strip-types --test test/*.test.ts",
-    "ci": "npm run typecheck && npm run test"
+    "test": "npm run build && node --experimental-strip-types --test test/*.test.ts && node --test test/release-calver.test.mjs",
+    "ci": "npm run typecheck && npm run test",
+    "release:preview": "node scripts/release-calver.mjs --dry-run"
   },
   "devDependencies": {
     "@types/node": "^22.15.29",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3"
+  },
+  "allowScripts": {
+    "esbuild@0.27.7": true
   }
 }