clikit-plugin 0.2.35 → 0.2.37

package/dist/cli.js

@@ -45,7 +45,7 @@ function getPackageVersion() {
   }
 }
 function getPluginEntry() {
-  return `${PLUGIN_NAME}@${getPackageVersion()}`;
+  return `${PLUGIN_NAME}@latest`;
 }
 function resolveProjectDir(env = process.env, cwd = process.cwd()) {
   const candidates = [env.INIT_CWD, env.PWD, cwd].filter((value) => typeof value === "string" && value.trim().length > 0);
@@ -59,9 +59,10 @@ function resolveProjectDir(env = process.env, cwd = process.cwd()) {
   }
   return cwd;
 }
-function upsertPluginEntry(existingPlugins, pluginName, version) {
+function upsertPluginEntry(existingPlugins, pluginEntry) {
+  const pluginName = pluginEntry.split("@")[0] || pluginEntry;
   const filteredPlugins = existingPlugins.filter((p) => p !== pluginName && !p.startsWith(`${pluginName}@`));
-  filteredPlugins.push(`${pluginName}@${version}`);
+  filteredPlugins.push(pluginEntry);
   return filteredPlugins;
 }
 function copyFileIfMissing(sourcePath, targetPath, stats) {
@@ -125,6 +126,8 @@ export default CliKitPlugin;
 function removeLegacyGlobalPluginAssets(configDir) {
   const legacyPluginPath = path.join(configDir, "plugins", "clikit.js");
   const legacyAgentsDir = path.join(configDir, "plugins", "agents");
+  const legacyCommandDir = path.join(configDir, "command");
+  const legacyStatusPath = path.join(legacyCommandDir, "status.md");
   if (fs.existsSync(legacyPluginPath)) {
     fs.rmSync(legacyPluginPath, { force: true });
     console.log(`\u2713 Removed legacy local plugin file: ${legacyPluginPath}`);
@@ -133,6 +136,10 @@ function removeLegacyGlobalPluginAssets(configDir) {
     fs.rmSync(legacyAgentsDir, { recursive: true, force: true });
     console.log(`\u2713 Removed legacy local agents directory: ${legacyAgentsDir}`);
   }
+  if (fs.existsSync(legacyStatusPath)) {
+    fs.rmSync(legacyStatusPath, { force: true });
+    console.log(`\u2713 Removed legacy command file: ${legacyStatusPath}`);
+  }
 }
 function getRealHome() {
   if (process.env.SNAP_REAL_HOME) {
@@ -210,20 +217,10 @@ function writeConfig(configPath, config) {
   fs.renameSync(tmpPath, configPath);
 }
 async function install(options) {
-  console.log(`
-  CliKit Installer
-  ================
-`);
-  const pluginVersion = getPackageVersion();
-  console.log("[1/6] Adding CliKit plugin to OpenCode config...");
+  const pluginEntry = getPluginEntry();
   try {
     ensureConfigDir();
-  } catch (err) {
-    console.error(`\u2717 Failed to create config directory: ${err}`);
-    return 1;
-  }
-  const configPath = getConfigPath();
-  try {
+    const configPath = getConfigPath();
     const result = parseConfig(configPath);
     if (result.parseError && result.raw.trim()) {
       console.error(`\u2717 Config file has syntax errors and cannot be safely modified.`);
@@ -233,106 +230,47 @@ async function install(options) {
     }
     const config = result.config;
     const existingPlugins = Array.isArray(config.plugin) ? config.plugin.filter((p) => typeof p === "string") : [];
-    const preservedKeys = Object.keys(config).filter((k) => k !== "plugin");
-    if (preservedKeys.length > 0) {
-      console.log(`  Preserving existing config: ${preservedKeys.join(", ")}`);
-    }
-    const filteredPlugins = upsertPluginEntry(existingPlugins, PLUGIN_NAME, pluginVersion);
+    const filteredPlugins = upsertPluginEntry(existingPlugins, pluginEntry);
     const pluginMergedConfig = { ...config, plugin: filteredPlugins };
     writeConfig(configPath, pluginMergedConfig);
-    console.log(`\u2713 Plugin added to ${configPath} as ${getPluginEntry()}`);
-    console.log("\u2713 MCP servers are provided by plugin runtime (not written to opencode config)");
-  } catch (err) {
-    console.error(`\u2717 Failed to update OpenCode config: ${err}`);
-    return 1;
-  }
-  if (options.includeProjectScaffold) {
-    console.log(`
-[2/6] Scaffolding project .opencode assets...`);
-    try {
+    if (options.includeProjectScaffold) {
       const projectDir = resolveProjectDir();
-      const stats = scaffoldProjectOpencode(projectDir);
-      console.log(`\u2713 Project assets ready in ${path.join(projectDir, ".opencode")}`);
-      console.log(`  Copied: ${stats.copied}, Skipped existing: ${stats.skipped}`);
-      if (stats.missingSources.length > 0) {
-        console.log("  Missing bundled sources (skipped):");
-        for (const missing of stats.missingSources) {
-          console.log(`    - ${missing}`);
-        }
-      }
-    } catch (err) {
-      console.error(`\u2717 Failed to scaffold project assets: ${err}`);
-      return 1;
+      scaffoldProjectOpencode(projectDir);
     }
-  } else {
-    console.log(`
-[2/6] Skipping project scaffold (global-only install)`);
-  }
-  console.log(`
-[3/6] Cleaning legacy local plugin assets...`);
-  try {
     removeLegacyGlobalPluginAssets(getConfigDir());
-    console.log("\u2713 Global install mode uses npm plugin from opencode config");
+    const memoryDir = path.join(getConfigDir(), "memory");
+    const memorySubdirs = ["specs", "plans", "research", "reviews", "handoffs", "beads", "prds"];
+    for (const subdir of memorySubdirs) {
+      const dir = path.join(memoryDir, subdir);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+    }
+    const clikitConfigPath = getCliKitConfigPath();
+    if (!fs.existsSync(clikitConfigPath)) {
+      const defaultConfig = {
+        $schema: `https://unpkg.com/${PLUGIN_NAME}@latest/schema.json`,
+        disabled_agents: [],
+        disabled_commands: [],
+        disabled_skills: [],
+        agents: {},
+        commands: {},
+        skills: {
+          enable: [],
+          disable: []
+        },
+        hooks: {}
+      };
+      writeConfig(clikitConfigPath, defaultConfig);
+    }
+    console.log(`\u2713 CliKit installed (${pluginEntry})`);
+    console.log(`\u2713 Config: ${configPath}`);
+    console.log("\u2713 Restart OpenCode");
+    return 0;
   } catch (err) {
-    console.error(`\u2717 Failed to clean legacy assets: ${err}`);
+    console.error(`\u2717 Install failed: ${err}`);
     return 1;
   }
-  console.log(`
-[4/6] Creating memory directories...`);
-  const memoryDir = path.join(getConfigDir(), "memory");
-  const memorySubdirs = ["specs", "plans", "research", "reviews", "handoffs", "beads", "prds"];
-  for (const subdir of memorySubdirs) {
-    const dir = path.join(memoryDir, subdir);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-  }
-  console.log(`\u2713 Memory directories created in ${memoryDir}`);
-  console.log(`
-[5/6] Verifying MCP environment hints...`);
-  if (!process.env.CONTEXT7_API_KEY) {
-    console.log("! CONTEXT7_API_KEY not set; using {env:CONTEXT7_API_KEY} placeholder");
-  }
-  if (!process.env.GOOGLE_GEMINI_API_KEY) {
-    console.log("! GOOGLE_GEMINI_API_KEY not set; human-mcp will require it at runtime");
-  }
-  console.log(`
-[6/6] Creating CliKit config...`);
-  const clikitConfigPath = getCliKitConfigPath();
-  if (!fs.existsSync(clikitConfigPath)) {
-    const defaultConfig = {
-      $schema: `https://unpkg.com/${PLUGIN_NAME}@latest/schema.json`,
-      disabled_agents: [],
-      disabled_commands: [],
-      disabled_skills: [],
-      agents: {},
-      commands: {},
-      skills: {
-        enable: [],
-        disable: []
-      },
-      hooks: {}
-    };
-    writeConfig(clikitConfigPath, defaultConfig);
-    console.log(`\u2713 Config created at ${clikitConfigPath}`);
-  } else {
-    console.log(`\u2713 Config already exists at ${clikitConfigPath}`);
-  }
-  console.log(`
-\u2713 CliKit installed successfully!
-`);
-  console.log("Available commands:");
-  console.log("  /create   - Start new task with specification");
-  console.log("  /start    - Begin implementing from plan");
-  console.log("  /plan     - Create implementation plan");
-  console.log("  /verify   - Run verification suite");
-  console.log("  /ship     - Commit, PR, and cleanup");
-  console.log("  /review   - Request code review");
-  console.log("  /debug    - Debug issues");
-  console.log(`
-Restart OpenCode to use CliKit.
-`);
-  return 0;
 }
 function help() {
   console.log(`

package/dist/cli.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.test.d.ts.map

package/dist/cli.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.test.d.ts","sourceRoot":"","sources":["../src/cli.test.ts"],"names":[],"mappings":""}

package/dist/clikit.schema.json

@@ -1,245 +1,263 @@
 {
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://unpkg.com/clikit-plugin/schema.json",
-  "title": "CliKit Config",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "CliKit Configuration",
+  "description": "Configuration schema for the CliKit OpenCode plugin",
   "type": "object",
-  "additionalProperties": false,
   "properties": {
     "$schema": {
-      "type": "string"
+      "type": "string",
+      "description": "JSON Schema reference"
     },
     "disabled_agents": {
       "type": "array",
       "items": { "type": "string" },
-      "default": []
+      "description": "List of agent names to disable"
     },
     "disabled_commands": {
       "type": "array",
       "items": { "type": "string" },
-      "default": []
+      "description": "List of command names to disable"
     },
     "disabled_skills": {
       "type": "array",
       "items": { "type": "string" },
-      "default": []
+      "description": "List of skill names to disable"
     },
     "agents": {
       "type": "object",
+      "description": "Per-agent overrides",
       "additionalProperties": {
-        "type": "object",
-        "additionalProperties": true,
-        "properties": {
-          "model": { "type": "string" },
-          "temperature": { "type": "number" },
-          "mode": { "enum": ["subagent", "primary", "all"] },
-          "disabled": { "type": "boolean" },
-          "tools": {
-            "type": "object",
-            "additionalProperties": { "type": "boolean" }
-          },
-          "permission": {
-            "type": "object",
-            "additionalProperties": true
-          }
-        }
-      },
-      "default": {}
+        "$ref": "#/definitions/AgentOverride"
+      }
     },
     "commands": {
       "type": "object",
+      "description": "Per-command overrides",
       "additionalProperties": {
-        "type": "object",
-        "additionalProperties": true
-      },
-      "default": {}
+        "type": "object"
+      }
     },
     "skills": {
-      "anyOf": [
+      "description": "Skill configuration — array of names, object with enable/disable/sources, or per-skill overrides",
+      "oneOf": [
         {
           "type": "array",
           "items": { "type": "string" }
         },
+        {
+          "$ref": "#/definitions/SkillsConfigObject"
+        },
         {
           "type": "object",
-          "properties": {
-            "sources": {
-              "type": "array",
-              "items": {
-                "anyOf": [
-                  { "type": "string" },
-                  {
-                    "type": "object",
-                    "required": ["path"],
-                    "properties": {
-                      "path": { "type": "string" },
-                      "recursive": { "type": "boolean" },
-                      "glob": { "type": "string" }
-                    },
-                    "additionalProperties": false
-                  }
-                ]
-              }
-            },
-            "enable": {
-              "type": "array",
-              "items": { "type": "string" }
-            },
-            "disable": {
-              "type": "array",
-              "items": { "type": "string" }
-            }
-          },
           "additionalProperties": {
-            "anyOf": [
+            "oneOf": [
               { "type": "boolean" },
-              {
-                "type": "object",
-                "additionalProperties": true,
-                "properties": {
-                  "description": { "type": "string" },
-                  "template": { "type": "string" },
-                  "from": { "type": "string" },
-                  "model": { "type": "string" },
-                  "agent": { "type": "string" },
-                  "subtask": { "type": "boolean" },
-                  "argument-hint": { "type": "string" },
-                  "license": { "type": "string" },
-                  "compatibility": { "type": "string" },
-                  "metadata": { "type": "object", "additionalProperties": true },
-                  "allowed-tools": {
-                    "type": "array",
-                    "items": { "type": "string" }
-                  },
-                  "disable": { "type": "boolean" }
-                }
-              }
+              { "$ref": "#/definitions/SkillOverride" }
             ]
           }
         }
-      ],
-      "default": {}
+      ]
     },
     "lsp": {
       "type": "object",
+      "description": "LSP server configurations",
       "additionalProperties": {
-        "type": "object",
-        "additionalProperties": true,
-        "required": ["command"],
-        "properties": {
-          "command": {
-            "type": "array",
-            "items": { "type": "string" },
-            "minItems": 1
-          },
-          "extensions": {
-            "type": "array",
-            "items": { "type": "string" }
-          },
-          "priority": { "type": "number" },
-          "disabled": { "type": "boolean" },
-          "env": {
-            "type": "object",
-            "additionalProperties": { "type": "string" }
+        "$ref": "#/definitions/LspServerConfig"
+      }
+    },
+    "hooks": {
+      "$ref": "#/definitions/HooksConfig"
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "AgentOverride": {
+      "type": "object",
+      "properties": {
+        "model": { "type": "string", "description": "Override the model for this agent" },
+        "temperature": { "type": "number", "minimum": 0, "maximum": 2 },
+        "mode": { "type": "string", "enum": ["subagent", "primary", "all"] },
+        "disabled": { "type": "boolean" },
+        "tools": {
+          "type": "object",
+          "additionalProperties": { "type": "boolean" }
+        },
+        "permission": {
+          "type": "object",
+          "properties": {
+            "edit": { "type": "string", "enum": ["allow", "ask", "deny"] },
+            "bash": {
+              "oneOf": [
+                { "type": "string", "enum": ["allow", "ask", "deny"] },
+                { "type": "object", "additionalProperties": { "type": "string", "enum": ["allow", "ask", "deny"] } }
+              ]
+            },
+            "webfetch": { "type": "string", "enum": ["allow", "ask", "deny"] }
           },
-          "initialization": {
-            "type": "object",
-            "additionalProperties": true
-          }
+          "additionalProperties": false
         }
       },
-      "default": {}
+      "additionalProperties": false
     },
-    "hooks": {
+    "LspServerConfig": {
+      "type": "object",
+      "required": ["command"],
+      "properties": {
+        "command": { "type": "array", "items": { "type": "string" } },
+        "extensions": { "type": "array", "items": { "type": "string" } },
+        "priority": { "type": "integer" },
+        "disabled": { "type": "boolean" },
+        "env": { "type": "object", "additionalProperties": { "type": "string" } },
+        "initialization": { "type": "object" }
+      },
+      "additionalProperties": false
+    },
+    "HooksConfig": {
       "type": "object",
-      "additionalProperties": false,
       "properties": {
         "session_logging": { "type": "boolean" },
         "tool_logging": { "type": "boolean" },
         "todo_enforcer": {
           "type": "object",
-          "additionalProperties": false,
           "properties": {
             "enabled": { "type": "boolean" },
             "warn_on_incomplete": { "type": "boolean" }
-          }
+          },
+          "additionalProperties": false
         },
         "empty_message_sanitizer": {
           "type": "object",
-          "additionalProperties": false,
           "properties": {
             "enabled": { "type": "boolean" },
             "log_empty": { "type": "boolean" },
             "placeholder": { "type": "string" }
-          }
+          },
+          "additionalProperties": false
         },
         "git_guard": {
           "type": "object",
-          "additionalProperties": false,
           "properties": {
             "enabled": { "type": "boolean" },
             "allow_force_with_lease": { "type": "boolean" }
-          }
+          },
+          "additionalProperties": false
         },
         "security_check": {
           "type": "object",
-          "additionalProperties": false,
           "properties": {
             "enabled": { "type": "boolean" },
             "block_commits": { "type": "boolean" }
-          }
+          },
+          "additionalProperties": false
         },
         "subagent_question_blocker": {
           "type": "object",
-          "additionalProperties": false,
           "properties": {
             "enabled": { "type": "boolean" }
-          }
+          },
+          "additionalProperties": false
         },
         "truncator": {
           "type": "object",
-          "additionalProperties": false,
           "properties": {
             "enabled": { "type": "boolean" },
-            "max_output_chars": { "type": "number" },
-            "max_output_lines": { "type": "number" },
-            "preserve_head_lines": { "type": "number" },
-            "preserve_tail_lines": { "type": "number" },
+            "max_output_chars": { "type": "integer" },
+            "max_output_lines": { "type": "integer" },
+            "preserve_head_lines": { "type": "integer" },
+            "preserve_tail_lines": { "type": "integer" },
             "log": { "type": "boolean" }
-          }
+          },
+          "additionalProperties": false
         },
         "swarm_enforcer": {
           "type": "object",
-          "additionalProperties": false,
           "properties": {
             "enabled": { "type": "boolean" },
             "strict_file_locking": { "type": "boolean" },
             "block_unreserved_edits": { "type": "boolean" },
             "log": { "type": "boolean" }
-          }
+          },
+          "additionalProperties": false
         },
         "memory_digest": {
           "type": "object",
-          "additionalProperties": false,
           "properties": {
             "enabled": { "type": "boolean" },
-            "max_per_type": { "type": "number" },
-            "include_types": {
-              "type": "array",
-              "items": { "type": "string" }
-            },
+            "max_per_type": { "type": "integer" },
+            "include_types": { "type": "array", "items": { "type": "string" } },
+            "index_highlights_per_type": { "type": "integer" },
+            "write_topic_files": { "type": "boolean" },
             "log": { "type": "boolean" }
-          }
+          },
+          "additionalProperties": false
         },
         "todo_beads_sync": {
           "type": "object",
-          "additionalProperties": false,
           "properties": {
             "enabled": { "type": "boolean" },
             "close_missing": { "type": "boolean" },
             "log": { "type": "boolean" }
-          }
+          },
+          "additionalProperties": false
+        },
+        "cass_memory": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "context_on_session_created": { "type": "boolean" },
+            "reflect_on_session_idle": { "type": "boolean" },
+            "context_limit": { "type": "integer" },
+            "reflect_days": { "type": "integer" },
+            "cm_path": { "type": "string" },
+            "log": { "type": "boolean" }
+          },
+          "additionalProperties": false
         }
-      }
+      },
+      "additionalProperties": false
+    },
+    "SkillsConfigObject": {
+      "type": "object",
+      "properties": {
+        "sources": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              { "type": "string" },
+              {
+                "type": "object",
+                "required": ["path"],
+                "properties": {
+                  "path": { "type": "string" },
+                  "recursive": { "type": "boolean" },
+                  "glob": { "type": "string" }
+                }
+              }
+            ]
+          }
+        },
+        "enable": { "type": "array", "items": { "type": "string" } },
+        "disable": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": true
+    },
+    "SkillOverride": {
+      "type": "object",
+      "properties": {
+        "disable": { "type": "boolean" },
+        "description": { "type": "string" },
+        "template": { "type": "string" },
+        "from": { "type": "string" },
+        "model": { "type": "string" },
+        "agent": { "type": "string" },
+        "subtask": { "type": "boolean" },
+        "argument-hint": { "type": "string" },
+        "license": { "type": "string" },
+        "compatibility": { "type": "string" },
+        "metadata": { "type": "object" },
+        "allowed-tools": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
     }
   }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA+C9C,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAuB5D;AAKD,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAUlE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA+C9C,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAuB5D;AAmBD,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAWlE"}

package/dist/config.d.ts

@@ -54,6 +54,8 @@ export interface MemoryDigestHookConfig {
     enabled?: boolean;
     max_per_type?: number;
     include_types?: string[];
+    index_highlights_per_type?: number;
+    write_topic_files?: boolean;
     log?: boolean;
 }
 export interface TodoBeadsSyncHookConfig {
@@ -61,6 +63,15 @@ export interface TodoBeadsSyncHookConfig {
     close_missing?: boolean;
     log?: boolean;
 }
+export interface CassMemoryHookConfig {
+    enabled?: boolean;
+    context_on_session_created?: boolean;
+    reflect_on_session_idle?: boolean;
+    context_limit?: number;
+    reflect_days?: number;
+    cm_path?: string;
+    log?: boolean;
+}
 export interface HooksConfig {
     session_logging?: boolean;
     tool_logging?: boolean;
@@ -73,6 +84,7 @@ export interface HooksConfig {
     swarm_enforcer?: SwarmEnforcerHookConfig;
     memory_digest?: MemoryDigestHookConfig;
     todo_beads_sync?: TodoBeadsSyncHookConfig;
+    cass_memory?: CassMemoryHookConfig;
 }
 export interface SkillOverride {
     disable?: boolean;
@@ -110,6 +122,7 @@ export interface CliKitConfig {
     hooks?: HooksConfig;
 }
 declare function getUserConfigDir(): string;
+export declare function deepMerge<T extends object>(base: T, override: Partial<T>): T;
 export declare function loadCliKitConfig(projectDirectory: unknown): CliKitConfig;
 export declare function filterAgents(agents: Record<string, AgentConfig>, config: CliKitConfig | undefined | null): Record<string, AgentConfig>;
 export declare function filterCommands(commands: Record<string, CommandConfig>, config: CliKitConfig | undefined | null): Record<string, CommandConfig>;