@kkelly-offical/kkcode 0.1.3 → 0.1.6

package/src/config/defaults.mjs

@@ -1,195 +1,260 @@
-export const DEFAULT_CONFIG = {
-  language: "en",
-  provider: {
-    default: "openai",
-    openai: {
-      base_url: "https://api.openai.com/v1",
-      api_key_env: "OPENAI_API_KEY",
-      default_model: "gpt-5.3-codex",
-      models: ["gpt-5.3-codex", "gpt-5.2"],
-      timeout_ms: 120000,
-      stream_idle_timeout_ms: 120000,
-      max_tokens: 32768,
-      context_limit: null,
-      retry_attempts: 3,
-      retry_base_delay_ms: 800,
-      stream: true,
-      thinking: null
-    },
-    anthropic: {
-      base_url: "https://api.anthropic.com/v1",
-      api_key_env: "ANTHROPIC_API_KEY",
-      default_model: "claude-opus-4-6",
-      models: ["claude-sonnet-4-5", "claude-sonnet-4-6", "claude-haiku-4-5-20251001", "claude-opus-4-6"],
-      timeout_ms: 120000,
-      stream_idle_timeout_ms: 120000,
-      max_tokens: 32768,
-      context_limit: null,
-      retry_attempts: 3,
-      retry_base_delay_ms: 800,
-      stream: true,
-      thinking: null
-    },
-    ollama: {
-      base_url: "http://localhost:11434",
-      api_key_env: "",
-      default_model: "llama3.1",
-      timeout_ms: 300000,
-      stream_idle_timeout_ms: 300000,
-      max_tokens: 32768,
-      context_limit: null,
-      retry_attempts: 1,
-      retry_base_delay_ms: 1000,
-      stream: true,
-      thinking: null
-    },
-    model_context: {}
-  },
-  agent: {
-    default_mode: "agent",
-    max_steps: 8,
-    longagent: {
-      max_iterations: 0,
-      no_progress_warning: 3,
-      no_progress_limit: 5,
-      max_stage_recoveries: 3,
-      heartbeat_timeout_ms: 120000,
-      checkpoint_interval: 5,
-      parallel: {
-        enabled: true,
-        max_concurrency: 3,
-        stage_pass_rule: "all_success",
-        task_timeout_ms: 600000,
-        task_max_retries: 2
-      },
-      planner: {
-        intake_questions: {
-          enabled: true,
-          max_rounds: 6
-        },
-        ask_user_after_plan_frozen: false
-      },
-      resume_incomplete_files: true,
-      scaffold: {
-        enabled: true
-      },
-      git: {
-        enabled: "ask",
-        auto_branch: true,
-        auto_commit_stages: true,
-        auto_merge: true,
-        branch_prefix: "kkcode"
-      },
-      usability_gates: {
-        prompt_user: "first_run",
-        build: { enabled: true },
-        test: { enabled: true },
-        review: { enabled: true },
-        health: { enabled: true },
-        budget: { enabled: true }
-      }
-    },
-    subagents: {},
-    routing: {
-      categories: {}
-    }
-  },
-  mcp: {
-    servers: {},
-    auto_discover: true,
-    timeout_ms: 30000
-  },
-  skills: {
-    enabled: true,
-    dirs: [".kkcode/skills"]
-  },
-  permission: {
-    default_policy: "ask",
-    non_tty_default: "deny",
-    rules: []
-  },
-  storage: {
-    session_shard_enabled: true,
-    flush_interval_ms: 1000,
-    event_rotate_mb: 32,
-    event_retain_days: 14
-  },
-  background: {
-    mode: "worker_process",
-    worker_timeout_ms: 900000,
-    max_parallel: 2
-  },
-  runtime: {
-    tool_registry_cache_ttl_ms: 30000,
-    mcp_refresh_ttl_ms: 60000
-  },
-  tool: {
-    sources: {
-      builtin: true,
-      local: true,
-      mcp: true,
-      plugin: true
-    },
-    write_lock: {
-      mode: "file_lock",
-      wait_timeout_ms: 120000
-    },
-    local_dirs: [".kkcode/tools", ".kkcode/tool"],
-    plugin_dirs: [".kkcode/plugins", ".kkcode/plugin"]
-  },
-  session: {
-    max_history: 30,
-    recovery: true,
-    compaction_threshold_ratio: 0.7,
-    compaction_threshold_messages: 50,
-    context_cache_points: true
-  },
-  review: {
-    sort: "risk_first",
-    default_lines: 80,
-    max_expand_lines: 1200,
-    risk_weights: {
-      sensitive_path: 4,
-      large_change: 3,
-      medium_change: 2,
-      small_change: 1,
-      executable_script: 2,
-      command_pattern: 3
-    }
-  },
-  usage: {
-    pricing_file: null,
-    aggregation: ["turn", "session", "global"],
-    budget: {
-      session_usd: null,
-      global_usd: null,
-      warn_at_percent: 80,
-      strategy: "warn"
-    }
-  },
-  ui: {
-    theme_file: null,
-    mode_colors: {
-      ask: "#8da3b9",
-      plan: "#00b7c2",
-      agent: "#2ac26f",
-      longagent: "#ff7a33"
-    },
-    layout: "compact",
-    markdown_render: true,
-    status: {
-      show_cost: true,
-      show_token_meter: true
-    }
-  }
-}
-
-export const VALID_PROVIDER_TYPES = ["openai", "anthropic", "ollama", "openai-compatible"]
-
-import { listProviders } from "../provider/router.mjs"
-export function getValidProviderTypes() {
-  return listProviders()
-}
-export const VALID_MODES = ["ask", "plan", "agent", "longagent"]
-export const VALID_REVIEW_SORT = ["risk_first", "time_order", "file_order"]
-export const VALID_LANGUAGES = ["en", "zh"]
+export const DEFAULT_CONFIG = {
+  language: "en",
+  provider: {
+    default: "openai",
+    strict_mode: false,
+    openai: {
+      base_url: "https://api.openai.com/v1",
+      api_key_env: "OPENAI_API_KEY",
+      default_model: "gpt-5.3-codex",
+      models: ["gpt-5.3-codex", "gpt-5.2"],
+      timeout_ms: 120000,
+      stream_idle_timeout_ms: 120000,
+      max_tokens: 32768,
+      context_limit: null,
+      retry_attempts: 3,
+      retry_base_delay_ms: 800,
+      stream: true,
+      thinking: null
+    },
+    anthropic: {
+      base_url: "https://api.anthropic.com/v1",
+      api_key_env: "ANTHROPIC_API_KEY",
+      default_model: "claude-opus-4-6",
+      models: ["claude-sonnet-4-5", "claude-sonnet-4-6", "claude-haiku-4-5-20251001", "claude-opus-4-6"],
+      timeout_ms: 120000,
+      stream_idle_timeout_ms: 120000,
+      max_tokens: 32768,
+      context_limit: null,
+      retry_attempts: 3,
+      retry_base_delay_ms: 800,
+      stream: true,
+      thinking: null
+    },
+    ollama: {
+      base_url: "http://localhost:11434",
+      api_key_env: "",
+      default_model: "llama3.1",
+      timeout_ms: 300000,
+      stream_idle_timeout_ms: 300000,
+      max_tokens: 32768,
+      context_limit: null,
+      retry_attempts: 1,
+      retry_base_delay_ms: 1000,
+      stream: true,
+      thinking: null
+    },
+    model_context: {}
+  },
+  agent: {
+    default_mode: "agent",
+    max_steps: 8,
+    longagent: {
+      max_iterations: 0,
+      no_progress_warning: 3,
+      no_progress_limit: 5,
+      max_stage_recoveries: 3,
+      heartbeat_timeout_ms: 120000,
+      checkpoint_interval: 5,
+      lock_timeout_ms: 5000,
+      parallel: {
+        enabled: true,
+        max_concurrency: 3,
+        stage_pass_rule: "all_success",
+        task_timeout_ms: 600000,
+        task_max_retries: 2,
+        poll_interval_ms: 300
+      },
+      planner: {
+        intake_questions: {
+          enabled: true,
+          max_rounds: 6
+        },
+        ask_user_after_plan_frozen: false
+      },
+      four_stage: {
+        enabled: false,
+        preview_max_iterations: 10,
+        blueprint_max_iterations: 10,
+        coding_max_iterations: 50,
+        debugging_max_iterations: 20,
+        separate_models: {
+          enabled: false,
+          preview_model: null,
+          blueprint_model: null,
+          coding_model: null,
+          debugging_model: null
+        }
+      },
+      hybrid: {
+        enabled: true,
+        intake: true,
+        completion_validation: true,
+        debugging_max_iterations: 20,
+        max_coding_rollbacks: 2,
+        parallel_preview: true,
+        blueprint_review: false,
+        blueprint_validation: true,
+        tdd_mode: false,
+        cross_review: true,
+        incremental_gates: true,
+        context_pressure_limit: 8000,
+        budget_awareness: true,
+        checkpoint_resume: true,
+        project_memory: true,
+        task_bus: true,
+        coding_phase_timeout_ms: 1800000,
+        debugging_phase_timeout_ms: 600000,
+        checkpoint_max_keep: 10,
+        checkpoint_cleanup: true,
+        degradation: {
+          enabled: true,
+          fallback_model: null,
+          skip_non_critical: true
+        },
+        separate_models: {
+          enabled: false,
+          preview_model: null,
+          blueprint_model: null,
+          debugging_model: null
+        },
+        adaptive_models: {
+          enabled: false,
+          low: null,
+          medium: null,
+          high: null
+        }
+      },
+      resume_incomplete_files: true,
+      scaffold: {
+        enabled: true
+      },
+      git: {
+        enabled: "ask",
+        auto_branch: true,
+        auto_commit_stages: true,
+        auto_merge: true,
+        branch_prefix: "kkcode"
+      },
+      usability_gates: {
+        prompt_user: "first_run",
+        build: { enabled: true },
+        test: { enabled: true },
+        review: { enabled: true },
+        health: { enabled: true },
+        budget: { enabled: true }
+      }
+    },
+    subagents: {},
+    routing: {
+      categories: {}
+    }
+  },
+  mcp: {
+    servers: {},
+    auto_discover: true,
+    timeout_ms: 30000,
+    max_reconnect_attempts: 5,
+    circuit_reset_ms: 60000,
+    health_check_interval_ms: 0,
+    max_buffer_bytes: 16777216,
+    shutdown_timeout_ms: 5000,
+    max_sse_buffer_bytes: 4194304
+  },
+  skills: {
+    enabled: true,
+    dirs: [".kkcode/skills"],
+    allowed_commands: []
+  },
+  permission: {
+    default_policy: "ask",
+    non_tty_default: "deny",
+    rules: []
+  },
+  storage: {
+    session_shard_enabled: true,
+    flush_interval_ms: 1000,
+    event_rotate_mb: 32,
+    event_retain_days: 14
+  },
+  background: {
+    mode: "worker_process",
+    worker_timeout_ms: 900000,
+    max_parallel: 2,
+    max_log_lines: 300
+  },
+  runtime: {
+    tool_registry_cache_ttl_ms: 30000,
+    mcp_refresh_ttl_ms: 60000
+  },
+  tool: {
+    sources: {
+      builtin: true,
+      local: true,
+      mcp: true,
+      plugin: true
+    },
+    bash_timeout_ms: 120000,
+    write_lock: {
+      mode: "file_lock",
+      wait_timeout_ms: 120000
+    },
+    local_dirs: [".kkcode/tools", ".kkcode/tool"],
+    plugin_dirs: [".kkcode/plugins", ".kkcode/plugin"]
+  },
+  session: {
+    max_history: 30,
+    recovery: true,
+    compaction_threshold_ratio: 0.7,
+    compaction_threshold_messages: 50,
+    context_cache_points: true
+  },
+  review: {
+    sort: "risk_first",
+    default_lines: 80,
+    max_expand_lines: 1200,
+    risk_weights: {
+      sensitive_path: 4,
+      large_change: 3,
+      medium_change: 2,
+      small_change: 1,
+      executable_script: 2,
+      command_pattern: 3
+    }
+  },
+  usage: {
+    pricing_file: null,
+    aggregation: ["turn", "session", "global"],
+    budget: {
+      session_usd: null,
+      global_usd: null,
+      warn_at_percent: 80,
+      strategy: "warn"
+    }
+  },
+  ui: {
+    theme_file: null,
+    mode_colors: {
+      ask: "#8da3b9",
+      plan: "#00b7c2",
+      agent: "#2ac26f",
+      longagent: "#ff7a33"
+    },
+    layout: "compact",
+    markdown_render: true,
+    status: {
+      show_cost: true,
+      show_token_meter: true
+    }
+  }
+}
+
+export const VALID_PROVIDER_TYPES = ["openai", "anthropic", "ollama", "openai-compatible"]
+
+import { listProviders } from "../provider/router.mjs"
+export function getValidProviderTypes() {
+  return listProviders()
+}
+export const VALID_MODES = ["ask", "plan", "agent", "longagent"]
+export const VALID_REVIEW_SORT = ["risk_first", "time_order", "file_order"]
+export const VALID_LANGUAGES = ["en", "zh"]

package/src/config/schema.mjs

@@ -39,11 +39,10 @@ export function validateConfig(config) {
       err(errors, "provider", "must be object")
     } else {
       const providerTypes = getValidProviderTypes()
-      const knownKeys = new Set([...providerTypes, ...Object.keys(config.provider).filter(k => k !== "default")])
-      if (config.provider.default !== undefined && !knownKeys.has(config.provider.default)) {
-        err(errors, "provider.default", `must be one of ${[...knownKeys].join(", ")}`)
-      }
       const providerKeys = new Set([...providerTypes, ...Object.keys(config.provider).filter(k => k !== "default")])
+      if (config.provider.default !== undefined && !providerKeys.has(config.provider.default)) {
+        err(errors, "provider.default", `must be one of ${[...providerKeys].join(", ")}`)
+      }
       for (const key of providerKeys) {
         const p = config.provider[key]
         if (p === undefined) continue
@@ -72,6 +71,9 @@ export function validateConfig(config) {
           }
         }
       }
+      if (config.provider.strict_mode !== undefined && typeof config.provider.strict_mode !== "boolean") {
+        err(errors, "provider.strict_mode", "must be boolean")
+      }
       if (config.provider.model_context !== undefined) {
         if (!isObj(config.provider.model_context)) err(errors, "provider.model_context", "must be object")
         else {
@@ -118,8 +120,11 @@ export function validateConfig(config) {
               if (config.agent.longagent.parallel.max_concurrency !== undefined) {
                 checkInt(errors, "agent.longagent.parallel.max_concurrency", config.agent.longagent.parallel.max_concurrency, 1)
               }
-              if (config.agent.longagent.parallel.stage_pass_rule !== undefined && config.agent.longagent.parallel.stage_pass_rule !== "all_success") {
-                err(errors, "agent.longagent.parallel.stage_pass_rule", "must be all_success")
+              if (config.agent.longagent.parallel.stage_pass_rule !== undefined && !["all_success", "majority", "any_success"].includes(config.agent.longagent.parallel.stage_pass_rule)) {
+                err(errors, "agent.longagent.parallel.stage_pass_rule", "must be all_success|majority|any_success")
+              }
+              if (config.agent.longagent.parallel.poll_interval_ms !== undefined) {
+                checkInt(errors, "agent.longagent.parallel.poll_interval_ms", config.agent.longagent.parallel.poll_interval_ms, 50)
               }
               if (config.agent.longagent.parallel.task_timeout_ms !== undefined) {
                 checkInt(errors, "agent.longagent.parallel.task_timeout_ms", config.agent.longagent.parallel.task_timeout_ms, 1000)
@@ -150,6 +155,58 @@ export function validateConfig(config) {
               }
             }
           }
+          if (config.agent.longagent.lock_timeout_ms !== undefined) {
+            checkInt(errors, "agent.longagent.lock_timeout_ms", config.agent.longagent.lock_timeout_ms, 1000)
+          }
+          if (config.agent.longagent.four_stage !== undefined) {
+            if (!isObj(config.agent.longagent.four_stage)) {
+              err(errors, "agent.longagent.four_stage", "must be object")
+            } else {
+              const fs = config.agent.longagent.four_stage
+              if (fs.enabled !== undefined && typeof fs.enabled !== "boolean") err(errors, "agent.longagent.four_stage.enabled", "must be boolean")
+              if (fs.separate_models !== undefined) {
+                if (!isObj(fs.separate_models)) err(errors, "agent.longagent.four_stage.separate_models", "must be object")
+                else {
+                  if (fs.separate_models.enabled !== undefined && typeof fs.separate_models.enabled !== "boolean") err(errors, "agent.longagent.four_stage.separate_models.enabled", "must be boolean")
+                  for (const k of ["preview_model", "blueprint_model", "coding_model", "debugging_model"]) {
+                    if (fs.separate_models[k] !== undefined && fs.separate_models[k] !== null && typeof fs.separate_models[k] !== "string") {
+                      err(errors, `agent.longagent.four_stage.separate_models.${k}`, "must be string or null")
+                    }
+                  }
+                }
+              }
+            }
+          }
+          if (config.agent.longagent.hybrid !== undefined) {
+            if (!isObj(config.agent.longagent.hybrid)) {
+              err(errors, "agent.longagent.hybrid", "must be object")
+            } else {
+              const hy = config.agent.longagent.hybrid
+              if (hy.enabled !== undefined && typeof hy.enabled !== "boolean") err(errors, "agent.longagent.hybrid.enabled", "must be boolean")
+              if (hy.separate_models !== undefined) {
+                if (!isObj(hy.separate_models)) err(errors, "agent.longagent.hybrid.separate_models", "must be object")
+                else {
+                  if (hy.separate_models.enabled !== undefined && typeof hy.separate_models.enabled !== "boolean") err(errors, "agent.longagent.hybrid.separate_models.enabled", "must be boolean")
+                  for (const k of ["preview_model", "blueprint_model", "debugging_model"]) {
+                    if (hy.separate_models[k] !== undefined && hy.separate_models[k] !== null && typeof hy.separate_models[k] !== "string") {
+                      err(errors, `agent.longagent.hybrid.separate_models.${k}`, "must be string or null")
+                    }
+                  }
+                }
+              }
+              if (hy.adaptive_models !== undefined) {
+                if (!isObj(hy.adaptive_models)) err(errors, "agent.longagent.hybrid.adaptive_models", "must be object")
+                else {
+                  if (hy.adaptive_models.enabled !== undefined && typeof hy.adaptive_models.enabled !== "boolean") err(errors, "agent.longagent.hybrid.adaptive_models.enabled", "must be boolean")
+                  for (const k of ["low", "medium", "high"]) {
+                    if (hy.adaptive_models[k] !== undefined && hy.adaptive_models[k] !== null && typeof hy.adaptive_models[k] !== "string") {
+                      err(errors, `agent.longagent.hybrid.adaptive_models.${k}`, "must be string or null")
+                    }
+                  }
+                }
+              }
+            }
+          }
           if (config.agent.longagent.resume_incomplete_files !== undefined && typeof config.agent.longagent.resume_incomplete_files !== "boolean") {
             err(errors, "agent.longagent.resume_incomplete_files", "must be boolean")
           }
@@ -180,6 +237,8 @@ export function validateConfig(config) {
     else {
       if (config.mcp.servers !== undefined && !isObj(config.mcp.servers)) err(errors, "mcp.servers", "must be object")
       if (config.mcp.timeout_ms !== undefined) checkInt(errors, "mcp.timeout_ms", config.mcp.timeout_ms, 1000)
+      if (config.mcp.shutdown_timeout_ms !== undefined) checkInt(errors, "mcp.shutdown_timeout_ms", config.mcp.shutdown_timeout_ms, 100)
+      if (config.mcp.max_sse_buffer_bytes !== undefined) checkInt(errors, "mcp.max_sse_buffer_bytes", config.mcp.max_sse_buffer_bytes, 1024)
       if (config.mcp.auto_discover !== undefined && typeof config.mcp.auto_discover !== "boolean") {
         err(errors, "mcp.auto_discover", "must be boolean")
       }
@@ -249,6 +308,10 @@ export function validateConfig(config) {
       if (config.skills.dirs !== undefined && !Array.isArray(config.skills.dirs)) {
         err(errors, "skills.dirs", "must be array")
       }
+      if (config.skills.allowed_commands !== undefined) {
+        if (!Array.isArray(config.skills.allowed_commands)) err(errors, "skills.allowed_commands", "must be array")
+        else if (config.skills.allowed_commands.some(c => typeof c !== "string")) err(errors, "skills.allowed_commands", "all values must be string")
+      }
     }
   }
 
@@ -325,6 +388,7 @@ export function validateConfig(config) {
       }
       if (config.background.worker_timeout_ms !== undefined) checkInt(errors, "background.worker_timeout_ms", config.background.worker_timeout_ms, 1000)
       if (config.background.max_parallel !== undefined) checkInt(errors, "background.max_parallel", config.background.max_parallel, 1)
+      if (config.background.max_log_lines !== undefined) checkInt(errors, "background.max_log_lines", config.background.max_log_lines, 1)
     }
   }
 
@@ -357,6 +421,7 @@ export function validateConfig(config) {
       }
       if (config.tool.local_dirs !== undefined && !Array.isArray(config.tool.local_dirs)) err(errors, "tool.local_dirs", "must be array")
       if (config.tool.plugin_dirs !== undefined && !Array.isArray(config.tool.plugin_dirs)) err(errors, "tool.plugin_dirs", "must be array")
+      if (config.tool.bash_timeout_ms !== undefined) checkInt(errors, "tool.bash_timeout_ms", config.tool.bash_timeout_ms, 1000)
     }
   }