@kkelly-offical/kkcode 0.1.3 → 0.1.7

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)
     }
   }
 

package/src/core/constants.mjs

@@ -1,46 +1,91 @@
-export const MODES = ["ask", "plan", "agent", "longagent"]
-
-export const TOOL_STATUSES = ["running", "completed", "error", "cancelled"]
-
-export const PERMISSION_DECISIONS = ["allow_once", "allow_session", "deny"]
-
-export const DEFAULT_MAX_STEPS = 8
-export const DEFAULT_REQUEST_TIMEOUT_MS = 120000
-export const DEFAULT_RETRY_ATTEMPTS = 3
-export const DEFAULT_LONGAGENT_RETRY_STORM_THRESHOLD = 3
-export const DEFAULT_LONGAGENT_TOKEN_ALERT_THRESHOLD = 120000
-
-export const EVENT_TYPES = {
-  TURN_START: "turn.start",
-  TURN_STEP_START: "turn.step.start",
-  TURN_STEP_FINISH: "turn.step.finish",
-  TURN_FINISH: "turn.finish",
-  TURN_ERROR: "turn.error",
-  TOOL_START: "tool.start",
-  TOOL_FINISH: "tool.finish",
-  TOOL_ERROR: "tool.error",
-  PERMISSION_ASKED: "permission.asked",
-  PERMISSION_DECIDED: "permission.decided",
-  REVIEW_DECISION: "review.decision",
-  MCP_HEALTH: "mcp.health",
-  MCP_REQUEST: "mcp.request",
-  LONGAGENT_HEARTBEAT: "longagent.heartbeat",
-  LONGAGENT_ALERT: "longagent.alert",
-  LONGAGENT_PHASE_CHANGED: "longagent.phase.changed",
-  LONGAGENT_GATE_CHECKED: "longagent.gate.checked",
-  LONGAGENT_RECOVERY_ENTERED: "longagent.recovery.entered",
-  LONGAGENT_INTAKE_STARTED: "longagent.intake.started",
-  LONGAGENT_PLAN_FROZEN: "longagent.plan.frozen",
-  LONGAGENT_STAGE_STARTED: "longagent.stage.started",
-  LONGAGENT_STAGE_TASK_DISPATCHED: "longagent.stage.task.dispatched",
-  LONGAGENT_STAGE_TASK_FINISHED: "longagent.stage.task.finished",
-  LONGAGENT_STAGE_FINISHED: "longagent.stage.finished",
-  LONGAGENT_SCAFFOLD_COMPLETE: "longagent.scaffold.complete",
-  LONGAGENT_GIT_BRANCH_CREATED: "longagent.git.branch.created",
-  LONGAGENT_GIT_STAGE_COMMITTED: "longagent.git.stage.committed",
-  LONGAGENT_GIT_MERGED: "longagent.git.merged",
-  SESSION_COMPACTED: "session.compacted",
-  TURN_USAGE_UPDATE: "turn.usage.update",
-  STREAM_TEXT_START: "stream.text.start",
-  STREAM_THINKING_START: "stream.thinking.start"
-}
+export const MODES = ["ask", "plan", "agent", "longagent"]
+
+export const TOOL_STATUSES = ["running", "completed", "error", "cancelled"]
+
+export const PERMISSION_DECISIONS = ["allow_once", "allow_session", "deny"]
+
+export const DEFAULT_MAX_STEPS = 8
+export const DEFAULT_REQUEST_TIMEOUT_MS = 120000
+export const DEFAULT_RETRY_ATTEMPTS = 3
+export const DEFAULT_LONGAGENT_RETRY_STORM_THRESHOLD = 3
+export const DEFAULT_LONGAGENT_TOKEN_ALERT_THRESHOLD = 120000
+
+export const LONGAGENT_4STAGE_STAGES = {
+  PREVIEW: "preview",
+  BLUEPRINT: "blueprint",
+  CODING: "coding",
+  DEBUGGING: "debugging"
+}
+
+export const EVENT_TYPES = {
+  TURN_START: "turn.start",
+  TURN_STEP_START: "turn.step.start",
+  TURN_STEP_FINISH: "turn.step.finish",
+  TURN_FINISH: "turn.finish",
+  TURN_ERROR: "turn.error",
+  TOOL_START: "tool.start",
+  TOOL_FINISH: "tool.finish",
+  TOOL_ERROR: "tool.error",
+  PERMISSION_ASKED: "permission.asked",
+  PERMISSION_DECIDED: "permission.decided",
+  REVIEW_DECISION: "review.decision",
+  MCP_HEALTH: "mcp.health",
+  MCP_REQUEST: "mcp.request",
+  MCP_RECONNECT: "mcp.reconnect",
+  MCP_CIRCUIT_OPEN: "mcp.circuit_open",
+  MCP_CIRCUIT_CLOSE: "mcp.circuit_close",
+  LONGAGENT_HEARTBEAT: "longagent.heartbeat",
+  LONGAGENT_ALERT: "longagent.alert",
+  LONGAGENT_PHASE_CHANGED: "longagent.phase.changed",
+  LONGAGENT_GATE_CHECKED: "longagent.gate.checked",
+  LONGAGENT_RECOVERY_ENTERED: "longagent.recovery.entered",
+  LONGAGENT_INTAKE_STARTED: "longagent.intake.started",
+  LONGAGENT_PLAN_FROZEN: "longagent.plan.frozen",
+  LONGAGENT_STAGE_STARTED: "longagent.stage.started",
+  LONGAGENT_STAGE_TASK_DISPATCHED: "longagent.stage.task.dispatched",
+  LONGAGENT_STAGE_TASK_FINISHED: "longagent.stage.task.finished",
+  LONGAGENT_STAGE_FINISHED: "longagent.stage.finished",
+  LONGAGENT_SCAFFOLD_COMPLETE: "longagent.scaffold.complete",
+  LONGAGENT_GIT_BRANCH_CREATED: "longagent.git.branch.created",
+  LONGAGENT_GIT_STAGE_COMMITTED: "longagent.git.stage.committed",
+  LONGAGENT_GIT_MERGED: "longagent.git.merged",
+  LONGAGENT_4STAGE_PREVIEW_START: "longagent.4stage.preview.start",
+  LONGAGENT_4STAGE_PREVIEW_COMPLETE: "longagent.4stage.preview.complete",
+  LONGAGENT_4STAGE_BLUEPRINT_START: "longagent.4stage.blueprint.start",
+  LONGAGENT_4STAGE_BLUEPRINT_COMPLETE: "longagent.4stage.blueprint.complete",
+  LONGAGENT_4STAGE_CODING_START: "longagent.4stage.coding.start",
+  LONGAGENT_4STAGE_CODING_COMPLETE: "longagent.4stage.coding.complete",
+  LONGAGENT_4STAGE_DEBUGGING_START: "longagent.4stage.debugging.start",
+  LONGAGENT_4STAGE_DEBUGGING_COMPLETE: "longagent.4stage.debugging.complete",
+  LONGAGENT_4STAGE_RETURN_TO_CODING: "longagent.4stage.return_to_coding",
+  LONGAGENT_HYBRID_PREVIEW_START: "longagent.hybrid.preview.start",
+  LONGAGENT_HYBRID_PREVIEW_COMPLETE: "longagent.hybrid.preview.complete",
+  LONGAGENT_HYBRID_BLUEPRINT_START: "longagent.hybrid.blueprint.start",
+  LONGAGENT_HYBRID_BLUEPRINT_COMPLETE: "longagent.hybrid.blueprint.complete",
+  LONGAGENT_HYBRID_DEBUGGING_START: "longagent.hybrid.debugging.start",
+  LONGAGENT_HYBRID_DEBUGGING_COMPLETE: "longagent.hybrid.debugging.complete",
+  LONGAGENT_HYBRID_RETURN_TO_CODING: "longagent.hybrid.return_to_coding",
+  LONGAGENT_HYBRID_BLUEPRINT_REVIEW: "longagent.hybrid.blueprint.review",
+  LONGAGENT_HYBRID_BLUEPRINT_VALIDATED: "longagent.hybrid.blueprint.validated",
+  LONGAGENT_HYBRID_CROSS_REVIEW: "longagent.hybrid.cross_review",
+  LONGAGENT_HYBRID_INCREMENTAL_GATE: "longagent.hybrid.incremental_gate",
+  LONGAGENT_HYBRID_CONTEXT_COMPRESSED: "longagent.hybrid.context_compressed",
+  LONGAGENT_HYBRID_BUDGET_WARNING: "longagent.hybrid.budget_warning",
+  LONGAGENT_HYBRID_CHECKPOINT_RESUMED: "longagent.hybrid.checkpoint_resumed",
+  LONGAGENT_HYBRID_REPLAN: "longagent.hybrid.replan",
+  LONGAGENT_HYBRID_MEMORY_LOADED: "longagent.hybrid.memory_loaded",
+  LONGAGENT_HYBRID_MEMORY_SAVED: "longagent.hybrid.memory_saved",
+  SESSION_COMPACTED: "session.compacted",
+  TURN_USAGE_UPDATE: "turn.usage.update",
+  STREAM_TEXT_START: "stream.text.start",
+  STREAM_THINKING_START: "stream.thinking.start",
+  LONGAGENT_DEGRADATION_APPLIED: "longagent.degradation.applied",
+  LONGAGENT_WRITE_LOOP_DETECTED: "longagent.write_loop.detected",
+  LONGAGENT_SEMANTIC_ERROR_REPEATED: "longagent.semantic_error.repeated",
+  LONGAGENT_PHASE_TIMEOUT: "longagent.phase.timeout",
+  LONGAGENT_GIT_CONFLICT_RESOLUTION: "longagent.git.conflict_resolution",
+  LONGAGENT_CHECKPOINT_CLEANED: "longagent.checkpoint.cleaned",
+  LONGAGENT_HYBRID_CHECKPOINT_INVALID: "longagent.hybrid.checkpoint_invalid",
+  LONGAGENT_STAGE_TASK_SKIPPED: "longagent.stage.task.skipped",
+  PROVIDER_FALLBACK: "provider.fallback"
+}

package/src/index.mjs

@@ -54,7 +54,7 @@ async function main() {
   }
 
   const program = new Command()
-  program.name("kkcode").description("kkcode CLI").version("0.1.3")
+  program.name("kkcode").description("kkcode CLI").version("0.1.6")
   program.addCommand(createChatCommand())
   program.addCommand(createThemeCommand())
   program.addCommand(createUsageCommand())

package/src/knowledge/frontend-aesthetics.txt

@@ -0,0 +1,39 @@
+<frontend_aesthetics>
+## Frontend Design Quality Rules
+
+When building frontend UI, avoid generic "AI-generated" aesthetics. Make creative, distinctive choices.
+
+### Typography
+- Avoid default fonts (Inter, Roboto, Arial, system-ui). Choose distinctive fonts.
+- Use high contrast: pair display fonts with monospace, serif with geometric sans.
+- Use extreme weight differences (200 vs 800) and 3x+ size jumps.
+- Load fonts from Google Fonts via <link> or @import.
+
+### Color
+- Define ALL colors as CSS variables in :root.
+- Use a dominant color with 1-2 sharp accents. Avoid evenly-distributed palettes.
+- Draw from real palettes: IDE themes (Nord, Catppuccin, Dracula), nature, cultural aesthetics.
+- AVOID: purple gradients on white, generic blue buttons, gray-on-gray cards.
+
+### Motion
+- One high-impact animation per page (staggered reveal on load).
+- Micro-interactions: hover lift, focus glow, press feedback.
+- Use CSS transitions/animations. Use animation-delay for staggered effects.
+
+### Layout
+- CSS Grid for page structure, Flexbox for components.
+- Generous whitespace. Consistent spacing scale (4/8/12/16/24/32/48/64px).
+- Mobile-first responsive design.
+
+### Depth & Atmosphere
+- Layered gradients, subtle patterns, backdrop-filter for glass effects.
+- Elevation hierarchy via box-shadow (not just border).
+- Noise/grain textures for premium feel.
+
+### What NOT to do
+- Cookie-cutter card grids with identical rounded corners
+- Generic hero with centered text + gradient
+- border-radius: 9999px on everything
+- Gray placeholder text that looks like wireframe
+- No visual rhythm (identical spacing everywhere)
+</frontend_aesthetics>

package/src/knowledge/loader.mjs

@@ -58,7 +58,8 @@ const LANGUAGE_MAP = {
 // Project type → scenario knowledge
 const TYPE_MAP = {
   backend: ["api-design.txt"],
-  fullstack: ["api-design.txt"],
+  fullstack: ["api-design.txt", "frontend-aesthetics.txt"],
+  frontend: ["frontend-aesthetics.txt"],
 }
 
 // Feature → knowledge file

package/src/knowledge/tailwind.txt

@@ -4,7 +4,16 @@ Tailwind CSS conventions:
 - Dark mode: dark: prefix with class or media strategy
 - Component patterns: extract repeated patterns with @apply in CSS or component abstraction
 - Spacing scale: p-4 = 1rem, m-2 = 0.5rem (4px base)
-- Colors: bg-blue-500, text-gray-900, use project's color palette
+- Colors: bg-blue-500, text-gray-900, use project's color palette from tailwind.config
 - Layout: flex, grid, container mx-auto, gap utilities
-- Customization: tailwind.config.js for theme extension
-- Avoid: inline styles, arbitrary values when a utility exists
+- Customization: tailwind.config.js for theme extension (colors, fonts, spacing)
+- Avoid: inline styles, arbitrary values when a utility exists
+
+Design quality with Tailwind:
+- READ tailwind.config.js first — use the project's defined colors/fonts/spacing
+- Prefer semantic color names (primary, accent, muted) over raw colors (blue-500)
+- Use ring utilities for focus states (ring-2 ring-offset-2)
+- Transition utilities: transition-all duration-200 ease-in-out for interactions
+- Shadow scale: shadow-sm → shadow → shadow-md → shadow-lg for elevation
+- Use group and group-hover for parent-child hover effects
+- Animate: animate-pulse for loading, animate-spin for spinners