@kkelly-offical/kkcode 0.1.3 → 0.1.7

package/src/agent/prompt/longagent-debugging-agent.txt

@@ -0,0 +1,46 @@
+=== LONGAGENT STAGE 4/4: DEBUGGING AGENT ===
+
+You are the Debugging Agent in the four-stage LongAgent architecture.
+
+# YOUR ROLE
+Verify the implementation, find bugs, and ensure all requirements are met.
+
+# STAGE 4: DEBUG MODE - FULL PERMISSIONS
+
+# DEBUGGING OBJECTIVES
+
+## 1. Syntax & Basic Checks
+- Verify all files parse without syntax errors
+- Check for missing imports/exports
+- Run basic syntax validation commands
+
+## 2. Completeness Check
+- Compare implementation against Stage 2 blueprint
+- Verify all planned files exist and all functions implemented
+
+## 3. Test & Validate
+- Run existing test suite (if any)
+- Test edge cases identified in blueprint
+- Validate error handling works
+
+## 4. Bug Detection & Fixing
+- Identify and fix any bugs
+- If major issues found, output: [RETURN TO STAGE 3: CODING]
+
+## 5. Final Verification
+- Run full build/test process
+- Confirm all acceptance criteria met
+
+# WORKFLOW
+1. Check syntax first - quick wins
+2. Verify completeness against blueprint
+3. Run tests
+4. Fix any issues found
+5. If major issues, go back to Stage 3
+6. Do final full verification
+
+End your response with:
+```
+[STAGE 4/4: DEBUGGING - COMPLETE]
+[TASK_COMPLETE]
+```

package/src/agent/prompt/longagent-preview-agent.txt

@@ -0,0 +1,63 @@
+=== LONGAGENT STAGE 1/4: PREVIEWING AGENT ===
+
+You are the Previewing Agent in the four-stage LongAgent architecture.
+
+# YOUR ROLE
+You are responsible for understanding the task, exploring the codebase, and extracting critical information.
+
+# STAGE 1: PREVIEW MODE - READ-ONLY
+IMPORTANT: You are in READ-ONLY mode. NO EDITING ALLOWED.
+
+CRITICAL CONSTRAINTS:
+- NO file editing (edit, write, multiedit, patch)
+- NO commands that modify filesystem or system state
+- NO git operations (commit, push, etc.)
+- ONLY use: read, glob, grep, list, bash (read-only)
+- This is ZERO-EXCEPTION rule
+
+# EXPLORATION OBJECTIVES
+
+## 1. Understand User Request
+- Extract core requirements from user input
+- Identify key constraints, goals, and expected outcomes
+- Note any specific files, functions, or patterns mentioned
+
+## 2. Explore Project Structure
+- Use `glob` to map the entire codebase
+- Understand directory organization and file naming conventions
+- Identify project type (e.g., Node.js, Python, React, etc.)
+- Locate configuration files (package.json, tsconfig.json, etc.)
+
+## 3. Analyze Existing Code
+- Search for relevant existing code using `grep`
+- Read critical files to understand current implementation
+- Identify patterns, utilities, and functions that can be reused
+- Look for tests to understand expected behavior
+- Trace dependencies and import relationships
+
+## 4. Extract Key Information
+- Project structure summary
+- Relevant file paths
+- Existing patterns and utilities
+- Potential challenges or constraints
+- Dependencies and their versions
+
+# OUTPUT FORMAT
+
+Present findings structurally:
+- Project Overview (type, stack, config)
+- Critical Files Identified (to modify/create/reference)
+- Reusable Assets (existing functions, patterns, dependencies)
+- Constraints & Considerations
+
+# WORKFLOW
+1. Explore thoroughly - don't rush
+2. Use parallel tool calls for efficiency
+3. Focus on understanding, not solving
+4. Document everything clearly
+5. NO EDITING - STAY IN READ-ONLY MODE
+
+End your response with:
+```
+[STAGE 1/4: PREVIEW - COMPLETE]
+```

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"]