@promptctl/cc-candybar 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptctl/cc-candybar",
-  "version": "1.2.0",
+  "version": "1.3.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,10 +91,10 @@
     "mobx": "^6.15.0"
   },
   "optionalDependencies": {
-    "@promptctl/cc-candybar-darwin-arm64": "1.2.0",
-    "@promptctl/cc-candybar-darwin-x64": "1.2.0",
-    "@promptctl/cc-candybar-linux-x64": "1.2.0",
-    "@promptctl/cc-candybar-linux-arm64": "1.2.0"
+    "@promptctl/cc-candybar-darwin-arm64": "1.3.0",
+    "@promptctl/cc-candybar-darwin-x64": "1.3.0",
+    "@promptctl/cc-candybar-linux-x64": "1.3.0",
+    "@promptctl/cc-candybar-linux-arm64": "1.3.0"
   },
   "pnpm": {
     "supportedArchitectures": {

package/src/config/default-dsl-config.ts

@@ -159,6 +159,14 @@ export const DEFAULT_DSL_CONFIG = {
       path: "workspace.project_dir",
       default: "",
     },
+    // Transcript path (a top-level hookData field, spread onto the payload
+    // root by buildRenderPayload). Read by the quick-action tray's
+    // openTranscript action — pass-through, no projection.
+    transcript_path: {
+      kind: "input",
+      path: "transcript_path",
+      default: "",
+    },
     "model.display_name": {
       kind: "input",
       path: "model.display_name",
@@ -497,10 +505,16 @@ export const DEFAULT_DSL_CONFIG = {
       fg: "foreground",
       when: '{{ ne .git.branch "" }}',
     },
+    // Quick-action tray — copy the session id / cwd, open the project dir /
+    // transcript in the editor. [LAW:locality-or-seam] The glyph is the
+    // REPRESENTATION; the named action (below) is the BEHAVIOR; the action
+    // name is the seam between them. Re-glyph without touching behavior;
+    // re-target without touching this template. Each `{{ action … }}` emits
+    // one OSC-8 clickable region whose URL the wire codec owns end-to-end.
     toolbar: {
       template:
-        ' {{ link (printf "cc-candybar://open-vscode/%s" (urlEncode .current_dir)) "\u{1F4C2}" }}' +
-        ' {{ link (printf "cc-candybar://copy/%s" (urlEncode (trunc 8 .session.id))) "⎘" }} ',
+        ' {{ action "copySession" "⎘ id" }} {{ action "copyDir" "⎘ cwd" }}' +
+        ' {{ action "openProject" "↗ proj" }} {{ action "openTranscript" "↗ log" }} ',
       bg: "surface",
       fg: "foreground",
     },
@@ -612,7 +626,7 @@ export const DEFAULT_DSL_CONFIG = {
   },
 
   // Default layout — a single horizontal row of segment refs.
-  // A-grammar equivalent: { h: ["directory","git","model","session","today","context"] }
+  // A-grammar equivalent: { h: ["directory","git","model","session","today","context","toolbar"] }
   // [LAW:one-source-of-truth] The bundled default now authors the same terse
   // surface every user config lowers to, so the default is the reference spelling.
   // Adding rows = wrapping in { kind:"container", direction:"vertical", children:[...] };
@@ -627,14 +641,30 @@ export const DEFAULT_DSL_CONFIG = {
       { kind: "segment", name: "session" },
       { kind: "segment", name: "today" },
       { kind: "segment", name: "context" },
+      { kind: "segment", name: "toolbar" },
     ],
   },
 
-  // [LAW:locality-or-seam] No decoupled actions in the bundled default either —
-  // the baseline statusline binds no clickable regions. A user config declares
-  // named actions and binds them from a segment template via
-  // `{{ action "name" … }}`; the merge cascade adds them by name.
-  actions: {},
+  // [LAW:locality-or-seam] The quick-action tray's behaviors, decoupled by NAME
+  // from the `toolbar` segment's glyphs above. copy/open evaluate a Go-template
+  // against the live render scope at click time and write NO SessionState, so
+  // they derive no state validator (no gate) — they are pure click effects.
+  //
+  // [LAW:single-enforcer] Each template emits a RAW value; the click-wire codec
+  // (effectsUrl → encodeSegments) owns ALL percent-encoding and the verb's
+  // `oneArg` owns the single matching decode — so the template never hand-rolls
+  // a `urlEncode`, and the path round-trips untouched through one codec.
+  //
+  // open* route through the open-vscode verb (`open -a "Visual Studio Code"
+  // <path>`), so they pass a bare filesystem path — a directory or a file the
+  // editor opens directly — NOT a `vscode://` URL (which `open -a` would treat
+  // as a literal filename, not a deep link).
+  actions: {
+    copySession: { copy: "{{ .session.id }}" },
+    copyDir: { copy: "{{ .current_dir }}" },
+    openProject: { open: "{{ .project_dir }}" },
+    openTranscript: { open: "{{ .transcript_path }}" },
+  },
 
   // [LAW:single-enforcer] / [LAW:one-source-of-truth] Display-formatting policy
   // for the cost/token/budget family lives here as named template helpers, each

package/src/daemon/cache/render.ts

@@ -300,12 +300,11 @@ export class RenderCache {
     // reloadInto preserves the prior last-known-good with nothing half-installed.
     const validatorDisposers: Array<() => void> = [];
     try {
-      // [LAW:locality-or-seam] Pass the store so the config's `widget`
-      // references can read session.id + current picker values from the same
-      // source the rest of the render reads.
+      // [LAW:one-source-of-truth] The action runtime reads session.id + current
+      // picker values from registry.variableStore — the same store this entry's
+      // registry declares into — so no store reference is threaded separately.
       compiled = registerDslConfig(config, registry, {
         cwd: entry.cwd,
-        store,
       });
       // [LAW:one-source-of-truth] Derive the writable-key validators from the
       // config's action table (the sole interaction authority) through one

package/src/demo/dsl.ts

@@ -79,7 +79,6 @@ const registry = new SourceRegistry(store);
 try {
   const compiled = registerDslConfig(config, registry, {
     cwd: process.cwd(),
-    store,
   });
 
   process.stdout.write(

package/src/dsl/render.ts

@@ -252,7 +252,7 @@ function compileHelperPreamble(
 export function registerDslConfig(
   config: ValidatedConfig,
   registry: SourceRegistry,
-  opts?: { cwd?: string; store?: VariableStore; clock?: () => Date },
+  opts?: { cwd?: string; clock?: () => Date },
 ): CompiledConfig {
   const cwd = opts?.cwd ?? process.cwd();
 
@@ -262,11 +262,12 @@ export function registerDslConfig(
   // because the action set is config-scoped. The runtime holder is populated below
   // — the `action`/`picker` funcs reference the engine, and the compiled actions
   // reference the engine, so the holder breaks that cycle.
-  // [LAW:no-defensive-null-guards] store may be absent for compile-only callers
-  // with no actions; renderAction throws loudly if an action is actually used
-  // without a store, rather than silently rendering an empty click.
+  // [LAW:one-source-of-truth] The action runtime reads through the SAME store the
+  // registry declares into and the renderer reads back — sourced from the registry
+  // itself, not a redundant opts field a caller could forget (or pass a divergent
+  // store for). Every config has a registry, so the action store is never null.
   const actionRuntime: ActionRuntime = {
-    store: opts?.store ?? null,
+    store: registry.variableStore,
     compiled: new Map(),
   };
   // [LAW:one-way-deps] Inject action + picker feature funcs as data — the engine

package/src/render/action.ts

@@ -117,7 +117,11 @@ export function optionDomain(src: OptionSource): readonly string[] {
 // reads session.id and the current value from the same source the rest of the
 // render does.
 export interface ActionRuntime {
-  store: VariableStore | null;
+  // [LAW:types-are-the-program] Always present — registerDslConfig sources it
+  // from the registry it is handed (registry.variableStore), so "no store" is
+  // structurally unrepresentable. The action reads session.id and current
+  // values from the same store the renderer reads.
+  store: VariableStore;
   compiled: CompiledActions;
 }
 
@@ -416,11 +420,6 @@ export function renderAction(
     throw new Error(`action "${name}" is not declared in this config`);
   }
   const store = runtime.store;
-  if (!store) {
-    throw new Error(
-      `action "${name}" rendered without a VariableStore — registerDslConfig was not given one`,
-    );
-  }
   const { display, boundValue } = selectDisplay(name, action, displays, store);
   const sessionId = readVar(store, "session.id");
   const { effect, active } = realize(

package/src/render/picker.ts

@@ -144,11 +144,6 @@ function renderPicker(
     "an int action ({ set, int: true })",
   );
   const store = runtime.store;
-  if (!store) {
-    throw new Error(
-      `picker "${applyName}" rendered without a VariableStore — registerDslConfig was not given one`,
-    );
-  }
   const sessionId = readVar(store, "session.id");
   const current = readVar(store, apply.stateVar);
   const widths = apply.options.map(cellWidth);

package/src/var-system/sources.ts

@@ -580,6 +580,15 @@ export class SourceRegistry {
     this.sessionState = sessionState;
   }
 
+  // [LAW:one-source-of-truth] The registry IS the owner of its store — every
+  // variable it declares lives there, and the renderer reads back through it.
+  // Exposing it read-only lets a caller that already holds the registry obtain
+  // the one store without threading a second reference that could diverge (the
+  // action runtime reads session.id/current values from this exact store).
+  get variableStore(): VariableStore {
+    return this.store;
+  }
+
   // ─── Synchronous source kinds ─────────────────────────────────────────────
 
   // literal: type inferred from value; box written once at declaration and never again.