@promptctl/cc-candybar 1.25.0 → 1.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptctl/cc-candybar",
-  "version": "1.25.0",
+  "version": "1.26.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.25.0",
-    "@promptctl/cc-candybar-darwin-x64": "1.25.0",
-    "@promptctl/cc-candybar-linux-x64": "1.25.0",
-    "@promptctl/cc-candybar-linux-arm64": "1.25.0"
+    "@promptctl/cc-candybar-darwin-arm64": "1.26.0",
+    "@promptctl/cc-candybar-darwin-x64": "1.26.0",
+    "@promptctl/cc-candybar-linux-x64": "1.26.0",
+    "@promptctl/cc-candybar-linux-arm64": "1.26.0"
   }
 }

package/src/help-text.ts

@@ -0,0 +1,59 @@
+import { DISCLOSURE_GLYPH_CLOSED } from "./config/disclosure";
+
+// [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
+// pulling in index.ts's top-level `main()` call.
+// [LAW:one-source-of-truth] The disclosure glyph comes from config/disclosure.ts
+// (the same constant the theme/look picker itself renders with), so this text
+// can't drift from what a user actually sees on the bar.
+export const HELP_TEXT = `
+cc-candybar - Beautiful powerline statusline for Claude Code
+
+Usage: cc-candybar [options]
+
+Standalone Commands:
+  -h, --help               Show this help
+
+Debugging:
+  CC_CANDYBAR_DEBUG=1      Enable debug logging for troubleshooting
+
+Configuration:
+  Layout and segment options are defined in .cc-candybar.json5 (place in your
+  project dir, cwd, or ~/.config/cc-candybar/config.json5). Use CC_CANDYBAR_CONFIG
+  to point at a specific file. See the default config for all available options:
+    node dist/index.mjs debug --project-dir . --cwd .
+
+  The bundled default bar ships a clickable theme/look picker — no config
+  needed. Click 🎨 <theme> ${DISCLOSURE_GLYPH_CLOSED} or ◐ <look> ${DISCLOSURE_GLYPH_CLOSED} on the bar to
+  switch palettes.
+
+Subcommands:
+  install                  One-shot setup: stages the runtime (native render
+                           binary + dist bundle) at a stable path, creates the
+                           URL handler app + cc-candybar:// scheme (macOS), and
+                           writes the staged entry as the statusLine command in
+                           ~/.claude/settings.json. Re-run to update.
+  install-url-handler      Just stage the runtime and create + register the URL
+                           handler app (macOS only).
+  url-handle URL           Internal — invoked by the URL handler app on
+                           cmd-click. Parses cc-candybar://<verb>/<value> and
+                           dispatches (currently: copy to clipboard).
+  daemon-stats [--json]    Query the running daemon for runtime stats:
+                           uptime, RSS, cache hit rates, watcher count,
+                           request totals. Does not spawn a daemon.
+
+Config tooling:
+  check [config-file]      Validate a config on the full render pipeline (parse
+                           → merge → validate → register → render) with no
+                           daemon. With no path, checks the same file the daemon
+                           would load from here. Exit 0 clean (warnings on
+                           stderr), 1 invalid, 2 unreadable. "lint" is an alias.
+  schema                   Print the JSON Schema for the config file shape
+                           (.cc-candybar.json5). Point an editor's $schema at it
+                           for autocomplete + structural validation.
+  vars [--json]            Declared variables: source kind, value, last error.
+  segments [--json]        Segment templates and their last rendered output.
+  config [--json]          The effective merged config. (All three query the
+                           running daemon; none spawn one.)
+
+`;

package/src/index.ts

@@ -15,6 +15,7 @@ import { runSchema } from "./config/cli";
 import { runCheck } from "./check";
 import { obtainDaemonKick } from "./daemon/acquire";
 import { planOutcome } from "./render/outcome-plan";
+import { HELP_TEXT } from "./help-text";
 
 // Read terminal width from the live shell context (no subprocess). Returns
 // undefined when nothing reliable is available; the daemon falls back to its
@@ -36,53 +37,7 @@ function detectTermCols(): number | undefined {
 }
 
 function showHelpText(): void {
-  console.log(`
-cc-candybar - Beautiful powerline statusline for Claude Code
-
-Usage: cc-candybar [options]
-
-Standalone Commands:
-  -h, --help               Show this help
-
-Debugging:
-  CC_CANDYBAR_DEBUG=1      Enable debug logging for troubleshooting
-
-Configuration:
-  Layout and segment options are defined in .cc-candybar.json5 (place in your
-  project dir, cwd, or ~/.config/cc-candybar/config.json5). Use CC_CANDYBAR_CONFIG
-  to point at a specific file. See the default config for all available options:
-    node dist/index.mjs debug --project-dir . --cwd .
-
-Subcommands:
-  install                  One-shot setup: stages the runtime (native render
-                           binary + dist bundle) at a stable path, creates the
-                           URL handler app + cc-candybar:// scheme (macOS), and
-                           writes the staged entry as the statusLine command in
-                           ~/.claude/settings.json. Re-run to update.
-  install-url-handler      Just stage the runtime and create + register the URL
-                           handler app (macOS only).
-  url-handle URL           Internal — invoked by the URL handler app on
-                           cmd-click. Parses cc-candybar://<verb>/<value> and
-                           dispatches (currently: copy to clipboard).
-  daemon-stats [--json]    Query the running daemon for runtime stats:
-                           uptime, RSS, cache hit rates, watcher count,
-                           request totals. Does not spawn a daemon.
-
-Config tooling:
-  check [config-file]      Validate a config on the full render pipeline (parse
-                           → merge → validate → register → render) with no
-                           daemon. With no path, checks the same file the daemon
-                           would load from here. Exit 0 clean (warnings on
-                           stderr), 1 invalid, 2 unreadable. "lint" is an alias.
-  schema                   Print the JSON Schema for the config file shape
-                           (.cc-candybar.json5). Point an editor's $schema at it
-                           for autocomplete + structural validation.
-  vars [--json]            Declared variables: source kind, value, last error.
-  segments [--json]        Segment templates and their last rendered output.
-  config [--json]          The effective merged config. (All three query the
-                           running daemon; none spawn one.)
-
-`);
+  console.log(HELP_TEXT);
 }
 
 async function main(): Promise<void> {

package/src/install/index.ts

@@ -7,6 +7,7 @@ import { tryClickViaDaemon } from "../daemon/client";
 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.
@@ -440,6 +441,21 @@ function formatPermanent(outcome: PermanentOutcome): string {
   }
 }
 
+// [LAW:effects-at-boundaries] Pure string builder — runInstall performs the
+// actual write. Kept separate so the message content is testable without
+// driving the full (fs + Launch Services) install side effects.
+// [LAW:one-source-of-truth] The disclosure glyph comes from config/disclosure.ts,
+// the same constant the theme/look picker itself renders with, so this tip
+// can't drift from what the bundled default bar actually shows.
+function installSuccessMessage(): string {
+  return (
+    `✓ install complete.\n` +
+    `  Restart Claude Code to pick up the new statusline.\n` +
+    `  Tip: the default bar has a clickable theme/look picker — click\n` +
+    `  🎨 <theme> ${DISCLOSURE_GLYPH_CLOSED} or ◐ <look> ${DISCLOSURE_GLYPH_CLOSED} on the bar to switch palettes.\n`
+  );
+}
+
 export function runInstall(rendererArgs: string[]): void {
   const force = rendererArgs.includes("--force");
   const filteredArgs = rendererArgs.filter((a) => a !== "--force");
@@ -459,10 +475,7 @@ export function runInstall(rendererArgs: string[]): void {
 
   updateClaudeSettings(staged.binPath, argsToInstall, force);
 
-  process.stdout.write(`✓ install complete.\n`);
-  process.stdout.write(
-    `  Restart Claude Code to pick up the new statusline.\n`,
-  );
+  process.stdout.write(installSuccessMessage());
 }
 
 function updateClaudeSettings(
@@ -529,4 +542,5 @@ export const __test__ = {
   resolveRenderEntry,
   stageFile,
   stagedEntryKind,
+  installSuccessMessage,
 };