@sudocode-ai/types 0.1.21 → 0.1.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudocode-ai/types",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "TypeScript type definitions for sudocode",
   "types": "src/index.d.ts",
   "type": "module",

package/src/index.d.ts

@@ -348,19 +348,80 @@ export interface SpawnConfig {
 }
 
 /**
- * Config metadata file structure (.sudocode/config.json)
+ * Storage mode determines the source of truth for entity data
+ * - "jsonl": JSONL files are authoritative (default)
+ * - "markdown": Markdown files are authoritative
+ *
+ * Note: JSONL is always exported regardless of mode (for git tracking).
+ * This setting only controls which format is authoritative during conflicts.
  */
-export interface Config {
-  // TODO: Deprecate version field.
-  version: string;
-  /** Worktree configuration (optional) */
-  worktree?: WorktreeConfig;
-  /** Integration configurations (optional) */
+export type StorageMode = "jsonl" | "markdown";
+
+/**
+ * Project-level configuration (git-tracked: .sudocode/config.json)
+ * These settings are shared across the team.
+ */
+export interface ProjectConfig {
+  /** Source of truth for entity data (default: "jsonl") */
+  sourceOfTruth?: StorageMode;
+  /** Integration configurations (shared across team) */
   integrations?: IntegrationsConfig;
-  /** Editor configuration (optional) */
+  /** Telemetry configuration (project-level, git-tracked) */
+  telemetry?: {
+    /** Stable anonymous identifier for this project */
+    projectId?: string;
+    /** @deprecated Use projectId instead */
+    anonymousId?: string;
+  };
+}
+
+/**
+ * Local machine configuration (gitignored: .sudocode/config.local.json)
+ * These settings are specific to each developer's machine.
+ */
+export interface LocalConfig {
+  /** Worktree configuration (machine-specific paths) */
+  worktree?: WorktreeConfig;
+  /** Editor configuration (personal preference) */
   editor?: EditorConfig;
-  /** Voice configuration (optional) */
+  /** Voice configuration (personal preference) */
   voice?: VoiceSettingsConfig;
+  /** Telemetry configuration (machine-specific, gitignored) */
+  telemetry?: {
+    /** OTLP endpoint URL (e.g., Grafana Cloud OTLP gateway) */
+    endpoint?: string;
+    /** Full Authorization header value (e.g., "Basic <base64>" or "Bearer <token>") */
+    authHeader?: string;
+    /** Disable telemetry entirely (default: false) */
+    disabled?: boolean;
+  };
+}
+
+/**
+ * Merged telemetry configuration (ProjectConfig.telemetry + LocalConfig.telemetry)
+ */
+export interface TelemetryConfig {
+  /** Stable anonymous identifier for this project (from ProjectConfig) */
+  projectId?: string;
+  /** @deprecated Use projectId instead */
+  anonymousId?: string;
+  /** OTLP endpoint URL (from LocalConfig) */
+  endpoint?: string;
+  /** Full Authorization header value (from LocalConfig) */
+  authHeader?: string;
+  /** Disable telemetry entirely (from LocalConfig) */
+  disabled?: boolean;
+}
+
+/**
+ * Merged configuration (ProjectConfig + LocalConfig)
+ * This is the runtime config object returned by getConfig().
+ */
+export interface Config extends Omit<ProjectConfig, 'telemetry'>, Omit<LocalConfig, 'telemetry'> {
+  /** @deprecated Legacy version field, no longer used */
+  version?: string;
+  /** Merged telemetry configuration */
+  telemetry?: TelemetryConfig;
 }
 
 /**