clikit-plugin 0.1.0

package/dist/clikit.schema.json

@@ -0,0 +1,423 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "CliKit Plugin Configuration",
+  "description": "Configuration for CliKit OpenCode plugin",
+  "type": "object",
+  "properties": {
+    "disabled_agents": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of agent names to disable",
+      "examples": [["scout"]]
+    },
+    "disabled_commands": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of command names to disable",
+      "examples": [["debug", "import-plan"]]
+    },
+    "agents": {
+      "type": "object",
+      "description": "Override settings for specific agents",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "model": { "type": "string", "description": "Override model for this agent" },
+          "temperature": { "type": "number", "minimum": 0, "maximum": 2 },
+          "top_p": { "type": "number", "minimum": 0, "maximum": 1 },
+          "mode": { "enum": ["subagent", "primary", "all"] },
+          "disabled": { "type": "boolean", "description": "Disable this agent" },
+          "color": { "type": "string", "description": "Agent color in UI" },
+          "maxSteps": { "type": "integer", "minimum": 1, "description": "Maximum steps for agent" },
+          "tools": {
+            "type": "object",
+            "additionalProperties": { "type": "boolean" }
+          },
+          "permission": {
+            "type": "object",
+            "description": "Permission overrides for this agent",
+            "properties": {
+              "edit": { "enum": ["ask", "allow", "deny"] },
+              "bash": {
+                "oneOf": [
+                  { "enum": ["ask", "allow", "deny"] },
+                  { "type": "object", "additionalProperties": { "enum": ["ask", "allow", "deny"] } }
+                ]
+              },
+              "webfetch": { "enum": ["ask", "allow", "deny"] },
+              "doom_loop": { "enum": ["ask", "allow", "deny"] },
+              "external_directory": { "enum": ["ask", "allow", "deny"] }
+            }
+          }
+        }
+      }
+    },
+    "commands": {
+      "type": "object",
+      "description": "Override settings for specific commands",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "agent": { "type": "string", "description": "Agent to use for this command" },
+          "model": { "type": "string", "description": "Model to use for this command" },
+          "subtask": { "type": "boolean", "description": "Run as subtask" },
+          "description": { "type": "string", "description": "Command description" },
+          "template": { "type": "string", "description": "Command template/prompt" }
+        }
+      }
+    },
+    "lsp": {
+      "type": "object",
+      "description": "LSP server configurations to inject into OpenCode",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["command"],
+        "properties": {
+          "command": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Command and arguments to start the LSP server"
+          },
+          "extensions": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "File extensions this LSP handles (e.g., ['.ts', '.tsx'])"
+          },
+          "priority": { "type": "integer", "description": "Priority when multiple LSPs match (higher = preferred)" },
+          "disabled": { "type": "boolean", "description": "Disable this LSP server" },
+          "env": {
+            "type": "object",
+            "additionalProperties": { "type": "string" },
+            "description": "Environment variables for the LSP process"
+          },
+          "initialization": {
+            "type": "object",
+            "description": "LSP initialization options"
+          }
+        }
+      },
+      "examples": [{
+        "typescript": {
+          "command": ["typescript-language-server", "--stdio"],
+          "extensions": [".ts", ".tsx", ".js", ".jsx"]
+        }
+      }]
+    },
+    "hooks": {
+      "type": "object",
+      "properties": {
+        "session_logging": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable session lifecycle logging"
+        },
+        "tool_logging": {
+          "type": "boolean",
+          "default": false,
+          "description": "Enable tool execution logging"
+        },
+        "todo_enforcer": {
+          "type": "object",
+          "description": "Todo continuation enforcer - warns when todos are incomplete",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable todo completion checking"
+            },
+            "warn_on_incomplete": {
+              "type": "boolean",
+              "default": true,
+              "description": "Log warning when todos are incomplete"
+            }
+          }
+        },
+        "empty_message_sanitizer": {
+          "type": "object",
+          "description": "Empty message sanitizer - prevents API errors from empty outputs",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable empty message sanitization"
+            },
+            "log_empty": {
+              "type": "boolean",
+              "default": true,
+              "description": "Log when empty messages are detected"
+            },
+            "placeholder": {
+              "type": "string",
+              "default": "(No output)",
+              "description": "Placeholder text for empty outputs"
+            }
+          }
+        },
+        "git_guard": {
+          "type": "object",
+          "description": "Blocks dangerous git commands (force push, hard reset, rm -rf)",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable git command guard"
+            },
+            "allow_force_with_lease": {
+              "type": "boolean",
+              "default": true,
+              "description": "Allow --force-with-lease as a safer alternative"
+            }
+          }
+        },
+        "security_check": {
+          "type": "object",
+          "description": "Scans for secrets and credentials before git commits",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable secret scanning"
+            },
+            "block_commits": {
+              "type": "boolean",
+              "default": false,
+              "description": "Block commits when secrets are detected (vs. warn only)"
+            }
+          }
+        },
+        "subagent_question_blocker": {
+          "type": "object",
+          "description": "Prevents subagents from asking clarifying questions",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable subagent question blocking"
+            }
+          }
+        },
+        "comment_checker": {
+          "type": "object",
+          "description": "Detects excessive AI-generated comments in code",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable comment density checking"
+            },
+            "threshold": {
+              "type": "number",
+              "default": 0.3,
+              "minimum": 0,
+              "maximum": 1,
+              "description": "Comment-to-code ratio threshold (0.3 = 30%)"
+            }
+          }
+        },
+        "env_context": {
+          "type": "object",
+          "description": "Injects project structure, git branch, and build system info",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable environment context injection"
+            },
+            "include_git": {
+              "type": "boolean",
+              "default": true,
+              "description": "Include git branch and status"
+            },
+            "include_package": {
+              "type": "boolean",
+              "default": true,
+              "description": "Include package.json info"
+            },
+            "include_structure": {
+              "type": "boolean",
+              "default": true,
+              "description": "Include project directory structure"
+            },
+            "max_depth": {
+              "type": "integer",
+              "default": 2,
+              "minimum": 1,
+              "maximum": 5,
+              "description": "Max depth for directory structure scan"
+            }
+          }
+        },
+        "auto_format": {
+          "type": "object",
+          "description": "Runs project formatter after file edits (prettier, biome, dprint)",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable auto-formatting (off by default)"
+            },
+            "formatter": {
+              "type": "string",
+              "enum": ["prettier", "biome", "dprint"],
+              "description": "Override formatter (auto-detected if not set)"
+            },
+            "extensions": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "File extensions to format (e.g., ['.ts', '.tsx'])"
+            },
+            "log": {
+              "type": "boolean",
+              "default": true,
+              "description": "Log format operations"
+            }
+          }
+        },
+        "typecheck_gate": {
+          "type": "object",
+          "description": "Runs TypeScript type checking after .ts/.tsx file edits",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable typecheck gate (off by default)"
+            },
+            "tsconfig": {
+              "type": "string",
+              "description": "Path to tsconfig.json (auto-detected if not set)"
+            },
+            "log": {
+              "type": "boolean",
+              "default": true,
+              "description": "Log typecheck results"
+            },
+            "block_on_error": {
+              "type": "boolean",
+              "default": false,
+              "description": "Block file writes when type errors are found"
+            }
+          }
+        },
+        "session_notification": {
+          "type": "object",
+          "description": "Desktop notifications when sessions complete or error",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable desktop notifications"
+            },
+            "on_idle": {
+              "type": "boolean",
+              "default": true,
+              "description": "Notify when session goes idle"
+            },
+            "on_error": {
+              "type": "boolean",
+              "default": true,
+              "description": "Notify on session errors"
+            },
+            "title_prefix": {
+              "type": "string",
+              "default": "OpenCode",
+              "description": "Prefix for notification titles"
+            }
+          }
+        },
+        "truncator": {
+          "type": "object",
+          "description": "Dynamic output truncation to prevent context overflow",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable output truncation"
+            },
+            "max_output_chars": {
+              "type": "integer",
+              "default": 30000,
+              "description": "Maximum output characters before truncation"
+            },
+            "max_output_lines": {
+              "type": "integer",
+              "default": 500,
+              "description": "Maximum output lines before truncation"
+            },
+            "preserve_head_lines": {
+              "type": "integer",
+              "default": 50,
+              "description": "Lines to preserve from the start"
+            },
+            "preserve_tail_lines": {
+              "type": "integer",
+              "default": 50,
+              "description": "Lines to preserve from the end"
+            },
+            "log": {
+              "type": "boolean",
+              "default": true,
+              "description": "Log truncation events"
+            }
+          }
+        },
+        "compaction": {
+          "type": "object",
+          "description": "Preserves beads state and memory during context compaction",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable compaction state preservation"
+            },
+            "include_beads_state": {
+              "type": "boolean",
+              "default": true,
+              "description": "Include beads-village task state"
+            },
+            "include_memory_refs": {
+              "type": "boolean",
+              "default": true,
+              "description": "Include recent memory references"
+            },
+            "include_todo_state": {
+              "type": "boolean",
+              "default": true,
+              "description": "Include current todo list state"
+            },
+            "max_state_chars": {
+              "type": "integer",
+              "default": 5000,
+              "description": "Maximum characters for compaction context"
+            }
+          }
+        },
+        "swarm_enforcer": {
+          "type": "object",
+          "description": "Enforces task isolation for multi-agent swarms",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable swarm enforcement (off by default)"
+            },
+            "strict_file_locking": {
+              "type": "boolean",
+              "default": true,
+              "description": "Only allow edits to reserved files"
+            },
+            "block_unreserved_edits": {
+              "type": "boolean",
+              "default": false,
+              "description": "Block edits to unreserved files (vs. warn)"
+            },
+            "log": {
+              "type": "boolean",
+              "default": true,
+              "description": "Log enforcement decisions"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/commands/index.d.ts

@@ -0,0 +1,4 @@
+import type { CommandConfig } from "../types";
+export declare function loadCommands(): Record<string, CommandConfig>;
+export declare function getBuiltinCommands(): Record<string, CommandConfig>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAkC9C,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAoB5D;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAElE"}

package/dist/config.d.ts

@@ -0,0 +1,118 @@
+import type { AgentConfig, CommandConfig } from "./types";
+export interface AgentOverride {
+    model?: string;
+    temperature?: number;
+    mode?: "subagent" | "primary" | "all";
+    disabled?: boolean;
+    tools?: Record<string, boolean>;
+    permission?: AgentConfig["permission"];
+}
+export interface LspServerConfig {
+    command: string[];
+    extensions?: string[];
+    priority?: number;
+    disabled?: boolean;
+    env?: Record<string, string>;
+    initialization?: Record<string, unknown>;
+}
+export interface TodoEnforcerHookConfig {
+    enabled?: boolean;
+    warn_on_incomplete?: boolean;
+}
+export interface EmptyMessageSanitizerHookConfig {
+    enabled?: boolean;
+    log_empty?: boolean;
+    placeholder?: string;
+}
+export interface GitGuardHookConfig {
+    enabled?: boolean;
+    allow_force_with_lease?: boolean;
+}
+export interface SecurityCheckHookConfig {
+    enabled?: boolean;
+    block_commits?: boolean;
+}
+export interface SubagentQuestionBlockerHookConfig {
+    enabled?: boolean;
+}
+export interface CommentCheckerHookConfig {
+    enabled?: boolean;
+    threshold?: number;
+}
+export interface EnvContextHookConfig {
+    enabled?: boolean;
+    include_git?: boolean;
+    include_package?: boolean;
+    include_structure?: boolean;
+    max_depth?: number;
+}
+export interface AutoFormatHookConfig {
+    enabled?: boolean;
+    formatter?: string;
+    extensions?: string[];
+    log?: boolean;
+}
+export interface TypeCheckGateHookConfig {
+    enabled?: boolean;
+    tsconfig?: string;
+    log?: boolean;
+    block_on_error?: boolean;
+}
+export interface SessionNotificationHookConfig {
+    enabled?: boolean;
+    on_idle?: boolean;
+    on_error?: boolean;
+    title_prefix?: string;
+}
+export interface TruncatorHookConfig {
+    enabled?: boolean;
+    max_output_chars?: number;
+    max_output_lines?: number;
+    preserve_head_lines?: number;
+    preserve_tail_lines?: number;
+    log?: boolean;
+}
+export interface CompactionHookConfig {
+    enabled?: boolean;
+    include_beads_state?: boolean;
+    include_memory_refs?: boolean;
+    include_todo_state?: boolean;
+    max_state_chars?: number;
+}
+export interface SwarmEnforcerHookConfig {
+    enabled?: boolean;
+    strict_file_locking?: boolean;
+    block_unreserved_edits?: boolean;
+    log?: boolean;
+}
+export interface HooksConfig {
+    session_logging?: boolean;
+    tool_logging?: boolean;
+    todo_enforcer?: TodoEnforcerHookConfig;
+    empty_message_sanitizer?: EmptyMessageSanitizerHookConfig;
+    git_guard?: GitGuardHookConfig;
+    security_check?: SecurityCheckHookConfig;
+    subagent_question_blocker?: SubagentQuestionBlockerHookConfig;
+    comment_checker?: CommentCheckerHookConfig;
+    env_context?: EnvContextHookConfig;
+    auto_format?: AutoFormatHookConfig;
+    typecheck_gate?: TypeCheckGateHookConfig;
+    session_notification?: SessionNotificationHookConfig;
+    truncator?: TruncatorHookConfig;
+    compaction?: CompactionHookConfig;
+    swarm_enforcer?: SwarmEnforcerHookConfig;
+}
+export interface CliKitConfig {
+    disabled_agents?: string[];
+    disabled_commands?: string[];
+    agents?: Record<string, AgentOverride>;
+    commands?: Record<string, Partial<CommandConfig>>;
+    lsp?: Record<string, LspServerConfig>;
+    hooks?: HooksConfig;
+}
+declare function getUserConfigDir(): string;
+export declare function loadCliKitConfig(projectDirectory: string): CliKitConfig;
+export declare function filterAgents(agents: Record<string, AgentConfig>, config: CliKitConfig): Record<string, AgentConfig>;
+export declare function filterCommands(commands: Record<string, CommandConfig>, config: CliKitConfig): Record<string, CommandConfig>;
+export { getUserConfigDir };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/hooks/auto-format.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Auto-Format Hook
+ *
+ * Runs the project's formatter after file edits.
+ * Detects prettier, biome, dprint, or other formatters from project config.
+ * Runs on tool.execute.after for edit/write tools.
+ */
+export interface AutoFormatConfig {
+    enabled?: boolean;
+    formatter?: string;
+    extensions?: string[];
+    log?: boolean;
+}
+export interface FormatResult {
+    formatted: boolean;
+    file: string;
+    formatter: string;
+    error?: string;
+}
+type FormatterEntry = {
+    name: string;
+    configFiles: string[];
+    command: (file: string) => string;
+};
+export declare function detectFormatter(projectDir: string): FormatterEntry | undefined;
+export declare function shouldFormat(filePath: string, extensions?: string[]): boolean;
+export declare function runFormatter(filePath: string, projectDir: string, formatterOverride?: string): FormatResult;
+export declare function formatAutoFormatLog(result: FormatResult): string;
+export {};
+//# sourceMappingURL=auto-format.d.ts.map

package/dist/hooks/auto-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-format.d.ts","sourceRoot":"","sources":["../../src/hooks/auto-format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,cAAc,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACnC,CAAC;AAsBF,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CA2B9E;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAI7E;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,MAAM,GACzB,YAAY,CAmCd;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAKhE"}

package/dist/hooks/comment-checker.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Comment Checker Hook
+ *
+ * Detects excessive AI-generated comments in code output.
+ * AI code should be indistinguishable from human-written code.
+ * Runs on tool.execute.after for edit/write tools.
+ */
+export interface CommentCheckResult {
+    excessive: boolean;
+    count: number;
+    totalLines: number;
+    ratio: number;
+}
+export declare function checkCommentDensity(content: string, threshold?: number): CommentCheckResult;
+export declare function hasExcessiveAIComments(content: string): boolean;
+export declare function formatCommentWarning(result: CommentCheckResult): string;
+//# sourceMappingURL=comment-checker.d.ts.map

package/dist/hooks/comment-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-checker.d.ts","sourceRoot":"","sources":["../../src/hooks/comment-checker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,kBAAkB,CAkDhG;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAS/D;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAGvE"}

package/dist/hooks/compaction.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Compaction Hook
+ *
+ * Injects beads-village state and memory references when a session
+ * is being compacted (context window nearing limit). Ensures critical
+ * state survives compaction so agents don't lose task context.
+ * Runs on session.idle / compaction event.
+ *
+ * Beads state: reads from .beads/metadata.json + .reservations/
+ * Memory refs: scans .opencode/memory/ subdirs for .md files
+ */
+export interface CompactionConfig {
+    enabled?: boolean;
+    include_beads_state?: boolean;
+    include_memory_refs?: boolean;
+    include_todo_state?: boolean;
+    max_state_chars?: number;
+}
+export interface BeadsState {
+    currentTask?: string;
+    taskId?: string;
+    reservedFiles?: string[];
+    agentId?: string;
+    team?: string;
+    inProgressCount?: number;
+    openCount?: number;
+}
+export interface MemoryRef {
+    key: string;
+    summary: string;
+    timestamp: number;
+    category: string;
+}
+export interface CompactionPayload {
+    beads?: BeadsState;
+    memories?: MemoryRef[];
+    todos?: Array<{
+        id: string;
+        content: string;
+        status: string;
+    }>;
+    sessionSummary?: string;
+}
+/**
+ * Read beads-village state from the actual beads infrastructure:
+ * - .beads/metadata.json for DB config
+ * - .reservations/ for active file locks
+ * - `bd ls` command for current task status (if bd CLI available)
+ */
+export declare function readBeadsState(projectDir: string): BeadsState | undefined;
+/**
+ * Read memory references from .opencode/memory/ subdirectories.
+ * Scans for .md files in subdirs: specs/, plans/, research/, reviews/, handoffs/, beads/
+ * Extracts title from first heading or filename.
+ */
+export declare function readMemoryRefs(projectDir: string, limit?: number): MemoryRef[];
+export declare function buildCompactionBlock(payload: CompactionPayload, maxChars?: number): string;
+export declare function collectCompactionPayload(projectDir: string, config?: CompactionConfig): CompactionPayload;
+export declare function formatCompactionLog(payload: CompactionPayload): string;
+//# sourceMappingURL=compaction.d.ts.map