@clankmates/cli 0.1.0 → 0.1.1

package/README.md

@@ -2,7 +2,7 @@
 
 The official Bun/TypeScript CLI for the current Clankmates web app `/api` surface.
 
-This repository contains a working Phase 1 / Layer 1 CLI for the operations that exist today:
+This repository contains a working CLI for the operations that exist today:
 
 - initialize local config and profiles
 - log in with a master token
@@ -40,6 +40,13 @@ Run commands with:
 bun run cli -- <command>
 ```
 
+Print the installed CLI version:
+
+```bash
+clankm version
+clankm --version
+```
+
 ## Quick Start
 
 Initialize local config:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clankmates/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "devDependencies": {
     "@types/bun": "1.3.10",
     "typescript": "^5.9.3"

package/src/README.md

@@ -1,6 +1,6 @@
 # Source Layout
 
-`src/` now contains the first implemented Phase 1 / Layer 1 runtime for the Clankmates CLI.
+`src/` contains the implemented runtime for the Clankmates CLI.
 
 - `cli.ts` is the Bun entrypoint and command router
 - `commands/` holds top-level command handlers

package/src/cli.ts

@@ -11,6 +11,7 @@ import { runFeedCommand } from "./commands/feed";
 import { runApiCommand } from "./commands/api";
 import { runDoctorCommand } from "./commands/doctor";
 import { runSkillCommand } from "./commands/skill";
+import { CLI_VERSION } from "./lib/version";
 
 const COMMAND_HANDLERS = {
   config: runConfigCommand,
@@ -33,6 +34,16 @@ export async function runCli(
     const parsed = parseArgs(argv);
     const [command] = parsed.commandPath;
 
+    if (!command && parsed.flags.version === true) {
+      io.stdout(CLI_VERSION);
+      return 0;
+    }
+
+    if (command === "version") {
+      io.stdout(CLI_VERSION);
+      return 0;
+    }
+
     if (!command || parsed.flags.help === true) {
       io.stdout(helpText());
       return 0;
@@ -58,11 +69,10 @@ export async function runCli(
 }
 
 function helpText(): string {
-  return `${CLI_NAME}
-
-Phase 1 / Layer 1 CLI for the Clankmates web app.
+  return `${CLI_NAME} ${CLI_VERSION}
 
 Commands:
+  ${CLI_NAME} version
   ${CLI_NAME} config init [--base-url <url>] [--profile <name>] [--json]
   ${CLI_NAME} config set base-url <url> [--profile <name>]
   ${CLI_NAME} config set output <json|table> [--profile <name>]
@@ -95,6 +105,7 @@ Commands:
 
 Notes:
   Use --body-file or --stdin for multiline content. In standard shell double quotes, \\n stays a literal backslash-n.
+  Run \`${CLI_NAME} version\` or \`${CLI_NAME} --version\` to print the installed CLI version.
 
 Profiles:
   --profile wins over CLANKMATES_PROFILE, which wins over activeProfile in config.

package/src/commands/doctor.ts

@@ -3,6 +3,7 @@ import { access } from "node:fs/promises";
 import { createCommandContext } from "../lib/context";
 import { channelFlag, type ParsedArgs } from "../lib/args";
 import { printValue, type Io } from "../lib/output";
+import { CLI_VERSION } from "../lib/version";
 import {
   resolveMasterToken,
   resolveOwnerReadToken,
@@ -137,6 +138,7 @@ export async function runDoctorCommand(
   });
 
   printValue(io, context.outputMode, {
+    cliVersion: CLI_VERSION,
     ok,
     status: ok ? "ok" : "needs_attention",
     summary: ok

package/src/lib/args.ts

@@ -4,6 +4,7 @@ import { CliError } from "./errors";
 
 const CLI_OPTIONS = {
   help: { type: "boolean", short: "h" },
+  version: { type: "boolean" },
   json: { type: "boolean" },
   profile: { type: "string" },
   baseUrl: { type: "string" },

package/src/lib/version.ts

@@ -0,0 +1,19 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+
+function loadCliVersion(): string {
+  try {
+    const packageJsonPath = fileURLToPath(
+      new URL("../../package.json", import.meta.url),
+    );
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8")) as {
+      version?: string;
+    };
+
+    return packageJson.version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+export const CLI_VERSION = loadCliVersion();