@axplusb/kepler 1.0.10 → 2.0.0

package/src/state/verbosity.mjs

@@ -0,0 +1,99 @@
+/**
+ * Verbosity modes — Mission Control (PRD-055 §12).
+ *
+ *   quiet     Folded summary only. Sub-agent inner tools hidden.
+ *   default   Folded summary. Sub-agent header shown, inner tools folded.
+ *   verbose   Folded summary. Sub-agent inner tools shown.
+ *   surgical  Expanded tool details + raw model reasoning.
+ *
+ * Persisted to `~/.kepler/config.json` under the `verbosity` key so the
+ * choice survives across sessions.
+ *
+ *   import { getVerbosity, setVerbosity, showSubAgentTools, showReasoning } from './verbosity.mjs';
+ *
+ * No imports from the REPL — this module is pure state + filesystem.
+ */
+
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+export const MODES = Object.freeze({
+  QUIET:    'quiet',
+  DEFAULT:  'default',
+  VERBOSE:  'verbose',
+  SURGICAL: 'surgical',
+});
+
+const VALID = new Set(Object.values(MODES));
+
+const CONFIG_DIR = process.env.KEPLER_HOME || path.join(os.homedir(), '.kepler');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
+
+let _cached = null;
+
+function readConfig() {
+  try { return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8')); }
+  catch { return {}; }
+}
+
+function writeConfig(obj) {
+  try {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(obj, null, 2));
+  } catch { /* best effort */ }
+}
+
+/** Read the current mode (falls back to default). */
+export function getVerbosity() {
+  if (_cached) return _cached;
+  const v = readConfig().verbosity;
+  _cached = VALID.has(v) ? v : MODES.DEFAULT;
+  return _cached;
+}
+
+/** Update the persisted mode. Returns the new mode. */
+export function setVerbosity(mode) {
+  if (!VALID.has(mode)) throw new Error(`Unknown verbosity mode: ${mode}`);
+  const cfg = readConfig();
+  cfg.verbosity = mode;
+  writeConfig(cfg);
+  _cached = mode;
+  return mode;
+}
+
+/** Force-reload from disk (used by tests). */
+export function _resetCache() { _cached = null; }
+
+// ── Predicates — let other modules ask "should I render X?" ─────────────
+
+/** Should sub-agent inner tool cards be printed? */
+export function showSubAgentTools(mode = getVerbosity()) {
+  return mode === MODES.VERBOSE || mode === MODES.SURGICAL;
+}
+
+/** Should raw model reasoning be printed? */
+export function showReasoning(mode = getVerbosity()) {
+  return mode === MODES.SURGICAL;
+}
+
+/** Should tool cards default to expanded instead of folded? */
+export function defaultExpanded(mode = getVerbosity()) {
+  return mode === MODES.SURGICAL;
+}
+
+/** Should markdown be rendered? (only `surgical` shows raw, others render) */
+export function renderMarkdown(mode = getVerbosity()) {
+  return mode !== MODES.SURGICAL;
+}
+
+/** Per-mode label for /help and status display. */
+export function label(mode = getVerbosity()) {
+  switch (mode) {
+    case MODES.QUIET:    return 'quiet (compact)';
+    case MODES.DEFAULT:  return 'default';
+    case MODES.VERBOSE:  return 'verbose (sub-agent tools visible)';
+    case MODES.SURGICAL: return 'surgical (everything shown)';
+    default:             return String(mode || 'default');
+  }
+}

package/src/terminal/ansi.mjs

@@ -1,10 +1,16 @@
 /**
- * ANSI Terminal Renderer — zero dependencies, zero flickering.
+ * ANSI Terminal Renderer — cursor control, box drawing, status bars.
  *
- * Provides cursor control, colors, box drawing, progress bars,
- * in-place updates, and a persistent status bar.
+ * Color helpers (the `c` object) now route through the semantic palette
+ * (`src/ui/palette.mjs`) so the entire CLI honors the Kepler brand and
+ * tier fallbacks (truecolor, ansi256, ansi16, none) without touching
+ * each call site. Hot-swap-friendly: external semantics like `c.red`,
+ * `c.bold`, `c.cyan` are preserved as the legacy contract; new code
+ * should prefer importing `paint` directly.
  */
 
+import { paint } from '../ui/palette.mjs';
+
 const ESC = '\x1b[';
 const write = (s) => process.stderr.write(s);
 
@@ -27,27 +33,43 @@ export const cursor = {
 };
 
 // ── Colors ──
+// Legacy color names re-mapped onto semantic palette tokens. The CLI's
+// branding is centralized in palette.mjs; this object is preserved only
+// so existing imports keep compiling. Internal Kepler color choices are
+// documented next to each mapping for the next code review.
+
+const identity = (s) => String(s ?? '');
 
 export const c = {
-  reset:   (s) => `${ESC}0m${s}${ESC}0m`,
-  bold:    (s) => `${ESC}1m${s}${ESC}0m`,
-  dim:     (s) => `${ESC}2m${s}${ESC}0m`,
-  italic:  (s) => `${ESC}3m${s}${ESC}0m`,
-  underline: (s) => `${ESC}4m${s}${ESC}0m`,
-  red:     (s) => `${ESC}31m${s}${ESC}0m`,
-  green:   (s) => `${ESC}32m${s}${ESC}0m`,
-  yellow:  (s) => `${ESC}33m${s}${ESC}0m`,
-  blue:    (s) => `${ESC}34m${s}${ESC}0m`,
-  magenta: (s) => `${ESC}35m${s}${ESC}0m`,
-  brand:   (s) => `${ESC}36m${s}${ESC}0m`,
-  cyan:    (s) => `${ESC}94m${s}${ESC}0m`,
-  cyanRegular: (s) => `${ESC}36m${s}${ESC}0m`,
-  cyanBold: (s) => `${ESC}1;36m${s}${ESC}0m`,
-  white:   (s) => `${ESC}97m${s}${ESC}0m`,
-  gray:    (s) => `${ESC}90m${s}${ESC}0m`,
-  bgRed:   (s) => `${ESC}41m${s}${ESC}0m`,
-  bgGreen: (s) => `${ESC}42m${s}${ESC}0m`,
-  bgCyan:  (s) => `${ESC}46m${s}${ESC}0m`,
+  reset:       identity,                       // palette already wraps with RESET
+
+  // Styles — work at every tier
+  bold:        paint.bold,
+  dim:         paint.dim,
+  italic:      paint.italic,
+  underline:   paint.underline,
+
+  // State semantics
+  red:         paint.state.danger,             // failure / hard error
+  green:       paint.state.success,            // pass / aligned
+  yellow:      paint.state.warn,               // soft warn / retry
+
+  // Brand semantics
+  blue:        paint.brand.primary,            // headers, primary brand
+  magenta:     paint.brand.accent,             // attention required
+  brand:       paint.brand.primary,            // primary brand surface
+  cyan:        paint.brand.data,               // code / file paths
+  cyanRegular: paint.brand.data,
+  cyanBold:    (s) => paint.bold(paint.brand.data(s)),
+
+  // Text semantics
+  white:       paint.text.primary,             // primary text
+  gray:        paint.text.dim,                 // hints, metadata, dim text
+
+  // Backgrounds — kept as raw ANSI; rarely used and have no palette analog
+  bgRed:       (s) => `${ESC}41m${String(s ?? '')}${ESC}0m`,
+  bgGreen:     (s) => `${ESC}42m${String(s ?? '')}${ESC}0m`,
+  bgCyan:      (s) => `${ESC}46m${String(s ?? '')}${ESC}0m`,
 };
 
 // ── Box Drawing ──