yzcode-cli 1.0.2 → 1.0.3

package/vim/types.ts

@@ -0,0 +1,199 @@
+/**
+ * Vim Mode State Machine Types
+ *
+ * This file defines the complete state machine for vim input handling.
+ * The types ARE the documentation - reading them tells you how the system works.
+ *
+ * State Diagram:
+ * ```
+ *                              VimState
+ *   ┌──────────────────────────────┬──────────────────────────────────────┐
+ *   │  INSERT                      │  NORMAL                              │
+ *   │  (tracks insertedText)       │  (CommandState machine)              │
+ *   │                              │                                      │
+ *   │                              │  idle ──┬─[d/c/y]──► operator        │
+ *   │                              │         ├─[1-9]────► count           │
+ *   │                              │         ├─[fFtT]───► find            │
+ *   │                              │         ├─[g]──────► g               │
+ *   │                              │         ├─[r]──────► replace         │
+ *   │                              │         └─[><]─────► indent          │
+ *   │                              │                                      │
+ *   │                              │  operator ─┬─[motion]──► execute     │
+ *   │                              │            ├─[0-9]────► operatorCount│
+ *   │                              │            ├─[ia]─────► operatorTextObj
+ *   │                              │            └─[fFtT]───► operatorFind │
+ *   └──────────────────────────────┴──────────────────────────────────────┘
+ * ```
+ */
+
+// ============================================================================
+// Core Types
+// ============================================================================
+
+export type Operator = 'delete' | 'change' | 'yank'
+
+export type FindType = 'f' | 'F' | 't' | 'T'
+
+export type TextObjScope = 'inner' | 'around'
+
+// ============================================================================
+// State Machine Types
+// ============================================================================
+
+/**
+ * Complete vim state. Mode determines what data is tracked.
+ *
+ * INSERT mode: Track text being typed (for dot-repeat)
+ * NORMAL mode: Track command being parsed (state machine)
+ */
+export type VimState =
+  | { mode: 'INSERT'; insertedText: string }
+  | { mode: 'NORMAL'; command: CommandState }
+
+/**
+ * Command state machine for NORMAL mode.
+ *
+ * Each state knows exactly what input it's waiting for.
+ * TypeScript ensures exhaustive handling in switches.
+ */
+export type CommandState =
+  | { type: 'idle' }
+  | { type: 'count'; digits: string }
+  | { type: 'operator'; op: Operator; count: number }
+  | { type: 'operatorCount'; op: Operator; count: number; digits: string }
+  | { type: 'operatorFind'; op: Operator; count: number; find: FindType }
+  | {
+      type: 'operatorTextObj'
+      op: Operator
+      count: number
+      scope: TextObjScope
+    }
+  | { type: 'find'; find: FindType; count: number }
+  | { type: 'g'; count: number }
+  | { type: 'operatorG'; op: Operator; count: number }
+  | { type: 'replace'; count: number }
+  | { type: 'indent'; dir: '>' | '<'; count: number }
+
+/**
+ * Persistent state that survives across commands.
+ * This is the "memory" of vim - what gets recalled for repeats and pastes.
+ */
+export type PersistentState = {
+  lastChange: RecordedChange | null
+  lastFind: { type: FindType; char: string } | null
+  register: string
+  registerIsLinewise: boolean
+}
+
+/**
+ * Recorded change for dot-repeat.
+ * Captures everything needed to replay a command.
+ */
+export type RecordedChange =
+  | { type: 'insert'; text: string }
+  | {
+      type: 'operator'
+      op: Operator
+      motion: string
+      count: number
+    }
+  | {
+      type: 'operatorTextObj'
+      op: Operator
+      objType: string
+      scope: TextObjScope
+      count: number
+    }
+  | {
+      type: 'operatorFind'
+      op: Operator
+      find: FindType
+      char: string
+      count: number
+    }
+  | { type: 'replace'; char: string; count: number }
+  | { type: 'x'; count: number }
+  | { type: 'toggleCase'; count: number }
+  | { type: 'indent'; dir: '>' | '<'; count: number }
+  | { type: 'openLine'; direction: 'above' | 'below' }
+  | { type: 'join'; count: number }
+
+// ============================================================================
+// Key Groups - Named constants, no magic strings
+// ============================================================================
+
+export const OPERATORS = {
+  d: 'delete',
+  c: 'change',
+  y: 'yank',
+} as const satisfies Record<string, Operator>
+
+export function isOperatorKey(key: string): key is keyof typeof OPERATORS {
+  return key in OPERATORS
+}
+
+export const SIMPLE_MOTIONS = new Set([
+  'h',
+  'l',
+  'j',
+  'k', // Basic movement
+  'w',
+  'b',
+  'e',
+  'W',
+  'B',
+  'E', // Word motions
+  '0',
+  '^',
+  '$', // Line positions
+])
+
+export const FIND_KEYS = new Set(['f', 'F', 't', 'T'])
+
+export const TEXT_OBJ_SCOPES = {
+  i: 'inner',
+  a: 'around',
+} as const satisfies Record<string, TextObjScope>
+
+export function isTextObjScopeKey(
+  key: string,
+): key is keyof typeof TEXT_OBJ_SCOPES {
+  return key in TEXT_OBJ_SCOPES
+}
+
+export const TEXT_OBJ_TYPES = new Set([
+  'w',
+  'W', // Word/WORD
+  '"',
+  "'",
+  '`', // Quotes
+  '(',
+  ')',
+  'b', // Parens
+  '[',
+  ']', // Brackets
+  '{',
+  '}',
+  'B', // Braces
+  '<',
+  '>', // Angle brackets
+])
+
+export const MAX_VIM_COUNT = 10000
+
+// ============================================================================
+// State Factories
+// ============================================================================
+
+export function createInitialVimState(): VimState {
+  return { mode: 'INSERT', insertedText: '' }
+}
+
+export function createInitialPersistentState(): PersistentState {
+  return {
+    lastChange: null,
+    lastFind: null,
+    register: '',
+    registerIsLinewise: false,
+  }
+}

package/voice/voiceModeEnabled.ts

@@ -0,0 +1,54 @@
+import { feature } from 'bun:bundle'
+import { getFeatureValue_CACHED_MAY_BE_STALE } from '../services/analytics/growthbook.js'
+import {
+  getClaudeAIOAuthTokens,
+  isAnthropicAuthEnabled,
+} from '../utils/auth.js'
+
+/**
+ * Kill-switch check for voice mode. Returns true unless the
+ * `tengu_amber_quartz_disabled` GrowthBook flag is flipped on (emergency
+ * off). Default `false` means a missing/stale disk cache reads as "not
+ * killed" — so fresh installs get voice working immediately without
+ * waiting for GrowthBook init. Use this for deciding whether voice mode
+ * should be *visible* (e.g., command registration, config UI).
+ */
+export function isVoiceGrowthBookEnabled(): boolean {
+  // Positive ternary pattern — see docs/feature-gating.md.
+  // Negative pattern (if (!feature(...)) return) does not eliminate
+  // inline string literals from external builds.
+  return feature('VOICE_MODE')
+    ? !getFeatureValue_CACHED_MAY_BE_STALE('tengu_amber_quartz_disabled', false)
+    : false
+}
+
+/**
+ * Auth-only check for voice mode. Returns true when the user has a valid
+ * Anthropic OAuth token. Backed by the memoized getClaudeAIOAuthTokens —
+ * first call spawns `security` on macOS (~20-50ms), subsequent calls are
+ * cache hits. The memoize clears on token refresh (~once/hour), so one
+ * cold spawn per refresh is expected. Cheap enough for usage-time checks.
+ */
+export function hasVoiceAuth(): boolean {
+  // Voice mode requires Anthropic OAuth — it uses the voice_stream
+  // endpoint on claude.ai which is not available with API keys,
+  // Bedrock, Vertex, or Foundry.
+  if (!isAnthropicAuthEnabled()) {
+    return false
+  }
+  // isAnthropicAuthEnabled only checks the auth *provider*, not whether
+  // a token exists. Without this check, the voice UI renders but
+  // connectVoiceStream fails silently when the user isn't logged in.
+  const tokens = getClaudeAIOAuthTokens()
+  return Boolean(tokens?.accessToken)
+}
+
+/**
+ * Full runtime check: auth + GrowthBook kill-switch. Callers: `/voice`
+ * (voice.ts, voice/index.ts), ConfigTool, VoiceModeNotice — command-time
+ * paths where a fresh keychain read is acceptable. For React render
+ * paths use useVoiceEnabled() instead (memoizes the auth half).
+ */
+export function isVoiceModeEnabled(): boolean {
+  return hasVoiceAuth() && isVoiceGrowthBookEnabled()
+}