@promptctl/cc-candybar 1.41.3 → 1.42.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptctl/cc-candybar",
-  "version": "1.41.3",
+  "version": "1.42.0",
   "description": "Statusline renderer for Claude Code — a JSON5-configurable DSL with daemon-cached data sources, byte-clean palette-aware composition, and OSC8 click verbs.",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -91,9 +91,9 @@
     "mobx": "^6.15.0"
   },
   "optionalDependencies": {
-    "@promptctl/cc-candybar-darwin-arm64": "1.41.3",
-    "@promptctl/cc-candybar-darwin-x64": "1.41.3",
-    "@promptctl/cc-candybar-linux-x64": "1.41.3",
-    "@promptctl/cc-candybar-linux-arm64": "1.41.3"
+    "@promptctl/cc-candybar-darwin-arm64": "1.42.0",
+    "@promptctl/cc-candybar-darwin-x64": "1.42.0",
+    "@promptctl/cc-candybar-linux-x64": "1.42.0",
+    "@promptctl/cc-candybar-linux-arm64": "1.42.0"
   }
 }

package/src/cli-flags.ts

@@ -0,0 +1,8 @@
+// [LAW:one-source-of-truth] The bare flags Node answers itself. The dispatch in
+// index.ts reads it, `--help` renders its own lines from it, and the Rust client
+// routes exactly these to Node (its NODE_FLAGS; check-protocol diffs the two),
+// so a spelling added here without its mirror fails the build, not the user.
+export const NODE_FLAGS = {
+  help: ["-h", "--help"],
+  version: ["-V", "--version"],
+} as const;

package/src/daemon/client-stats.ts

@@ -64,6 +64,7 @@ export function formatStats(s: StatsSnapshot): string {
   lines.push(`process`);
   lines.push(`  pid           ${s.pid}`);
   lines.push(`  version       ${s.version}`);
+  lines.push(`  protocol      ${s.protocolVersion}`);
   lines.push(`  startedAt     ${s.startedAt}`);
   lines.push(`  uptime        ${fmtUptime(s.uptimeSec)}`);
   lines.push(`  rss           ${fmtBytes(s.rssBytes)}`);

package/src/daemon/stats.ts

@@ -5,6 +5,7 @@
 import type { LaunchCategory } from "../proc/launch";
 import type { LaunchStatsHandle } from "../proc/stats-handle";
 import { PROTOCOL_VERSION } from "./protocol";
+import { PACKAGE_VERSION } from "../version";
 
 // Rolling window for "last minute" counts. Keep timestamps for each launch in
 // a ring buffer; eviction happens lazily on read.
@@ -28,7 +29,11 @@ const HISTOGRAM_CAP = 16;
 
 export interface StatsSnapshot {
   pid: number;
-  version: number;
+  // [LAW:one-source-of-truth] The daemon's own baked package stamp — set
+  // against `cc-candybar --version` to diagnose client-vs-daemon skew in one
+  // step. The wire contract number is a different fact under its own name.
+  version: string;
+  protocolVersion: number;
   startedAt: string;
   uptimeSec: number;
   rssBytes: number;
@@ -199,7 +204,8 @@ export class RuntimeStats {
     const mem = process.memoryUsage();
     return {
       pid: process.pid,
-      version: PROTOCOL_VERSION,
+      version: PACKAGE_VERSION,
+      protocolVersion: PROTOCOL_VERSION,
       startedAt: this.startedAt.toISOString(),
       uptimeSec: Math.floor((Date.now() - this.startedAt.getTime()) / 1000),
       rssBytes: mem.rss,

package/src/help-text.ts

@@ -1,5 +1,6 @@
 import { DISCLOSURE_GLYPH_CLOSED } from "./config/disclosure";
 import { HELP_GLYPH_CLOSED } from "./config/help";
+import { NODE_FLAGS } from "./cli-flags";
 
 // [LAW:effects-at-boundaries] Pure data, no I/O — index.ts owns the console.log
 // effect. Kept as its own module so the text is importable (and testable) without
@@ -36,7 +37,8 @@ cc-candybar - Beautiful powerline statusline for Claude Code
 Usage: cc-candybar [options]
 
 Standalone Commands:
-  -h, --help               Show this help
+  ${NODE_FLAGS.help.join(", ").padEnd(25)}Show this help
+  ${NODE_FLAGS.version.join(", ").padEnd(25)}Print the version of this runtime (cc-candybar <version>)
 
 Debugging:
   CC_CANDYBAR_DEBUG=1      Enable debug logging for troubleshooting

package/src/index.ts

@@ -16,6 +16,8 @@ import { runCheck } from "./check";
 import { obtainDaemonKick } from "./daemon/acquire";
 import { planOutcome } from "./render/outcome-plan";
 import { HELP_TEXT } from "./help-text";
+import { NODE_FLAGS } from "./cli-flags";
+import { PACKAGE_VERSION } from "./version";
 
 // Read terminal width from the live shell context (no subprocess). Returns
 // undefined when nothing reliable is available; the daemon falls back to its
@@ -52,6 +54,9 @@ function detectTermCols(): number | undefined {
 // widen recall of a fact that is otherwise reported as a plain `false`.
 const SSH_ENV_VARS = ["SSH_CONNECTION", "SSH_CLIENT", "SSH_TTY"] as const;
 
+const hasFlag = (flags: readonly string[]): boolean =>
+  flags.some((f) => process.argv.includes(f));
+
 // [LAW:dataflow-not-control-flow] A fold over the vocabulary, not a chain of
 // ifs — adding a name is a data edit.
 //
@@ -69,13 +74,18 @@ function showHelpText(): void {
 
 async function main(): Promise<void> {
   try {
-    const showHelp =
-      process.argv.includes("--help") || process.argv.includes("-h");
-
-    if (showHelp) {
+    if (hasFlag(NODE_FLAGS.help)) {
       showHelpText();
       process.exit(0);
     }
+    // [LAW:one-type-per-behavior] Answers "what is THIS binary" from the baked
+    // stamp alone — never a daemon probe, which would fail exactly when the
+    // flag is most needed (no working daemon). Daemon skew is the stats
+    // snapshot's `version` field.
+    if (hasFlag(NODE_FLAGS.version)) {
+      console.log(`cc-candybar ${PACKAGE_VERSION}`);
+      process.exit(0);
+    }
 
     // [LAW:dataflow-not-control-flow] Subcommand dispatch is data: argv[2]
     // selects the handler. Each handler short-circuits via process.exit().

package/src/install/index.ts

@@ -8,12 +8,7 @@ import type { PermanentOutcome } from "../daemon/client-transport";
 import { obtainDaemonKick } from "../daemon/acquire";
 import { URL_SCHEME, VERB_COPY } from "../click/wire";
 import { DISCLOSURE_GLYPH_CLOSED } from "../config/disclosure";
-
-// [LAW:one-source-of-truth] Replaced at build time by tsdown's `define` option
-// from package.json — the single version stamp install output reports.
-declare const __PACKAGE_VERSION__: string;
-const PACKAGE_VERSION =
-  typeof __PACKAGE_VERSION__ !== "undefined" ? __PACKAGE_VERSION__ : "dev";
+import { PACKAGE_VERSION } from "../version";
 
 const PACKAGE_NAME = "@promptctl/cc-candybar";
 const BUNDLE_ID = "com.cccandybar.url-handler";

package/src/version.ts

@@ -0,0 +1,17 @@
+// [LAW:one-source-of-truth] THE version stamp of this runtime. package.json is
+// the sole authority: tsdown's `define` bakes it into the bundle, and
+// scripts/version-stamp.cjs preloads it for untranspiled source. Every consumer
+// — `--version`, the install banner, the daemon's stats snapshot — reads this
+// one export.
+declare const __PACKAGE_VERSION__: string;
+
+// [LAW:no-silent-failure] A runtime that cannot say what it is must say THAT.
+// The old `"dev"` fallback was an answer-shaped void in a flag whose whole job
+// is answering this question; an unsubstituted build now fails at module load.
+if (typeof __PACKAGE_VERSION__ === "undefined") {
+  throw new Error(
+    "__PACKAGE_VERSION__ was not substituted: build via tsdown (define), or preload scripts/version-stamp.cjs when running source",
+  );
+}
+
+export const PACKAGE_VERSION: string = __PACKAGE_VERSION__;