@hiveai/cli 0.9.15 → 0.9.16

package/README.md

@@ -52,13 +52,28 @@ haive memory add \
 haive enforce status
 haive enforce check --stage pre-commit
 haive enforce ci
-haive benchmark report --dir benchmarks/agent-benchmark
 ```
 
 ---
 
 ## Commands
 
+The default help is intentionally small and centered on the core harness workflow. Run:
+
+```bash
+haive --help
+haive memory --help
+```
+
+to see the focused surface. Maintenance and experimental commands remain available, but are hidden from default help:
+
+```bash
+haive --advanced --help
+haive --advanced memory --help
+```
+
+This keeps hAIve from feeling like a grab bag: day-to-day users see context loading, enforcement, diagnostics, sync, recaps, and the high-signal memory operations first.
+
 ### `haive init`
 
 Initialize the `.ai/` structure in a project. **Autopilot mode is ON by default** and now installs strict enforcement gates by default.

package/dist/index.js

@@ -6345,7 +6345,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
   };
 }
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.9.15";
+var SERVER_VERSION = "0.9.16";
 function jsonResult(data) {
   return {
     content: [
@@ -6356,7 +6356,7 @@ function jsonResult(data) {
     ]
   };
 }
-var ENFORCEMENT_PROFILE_TOOLS = /* @__PURE__ */ new Set([
+var ENFORCEMENT_PROFILE_TOOLS = [
   "get_briefing",
   "mem_save",
   "mem_tried",
@@ -6367,7 +6367,47 @@ var ENFORCEMENT_PROFILE_TOOLS = /* @__PURE__ */ new Set([
   "code_map",
   "pre_commit_check",
   "mem_session_end"
-]);
+];
+var MAINTENANCE_PROFILE_TOOLS = [
+  ...ENFORCEMENT_PROFILE_TOOLS,
+  "mem_suggest_topic",
+  "mem_for_files",
+  "mem_list",
+  "get_project_context",
+  "bootstrap_project_save",
+  "mem_resolve_project",
+  "mem_update",
+  "mem_approve",
+  "mem_reject",
+  "mem_pending",
+  "mem_delete",
+  "mem_diff",
+  "get_recap",
+  "code_search",
+  "anti_patterns_check",
+  "mem_distill",
+  "mem_timeline",
+  "mem_conflict_candidates"
+];
+var EXPERIMENTAL_PROFILE_TOOLS = [
+  ...MAINTENANCE_PROFILE_TOOLS,
+  "mem_observe",
+  "why_this_file",
+  "why_this_decision",
+  "mem_conflicts_with",
+  "pattern_detect",
+  "runtime_journal_append",
+  "runtime_journal_tail"
+];
+var TOOL_PROFILES = {
+  enforcement: new Set(ENFORCEMENT_PROFILE_TOOLS),
+  maintenance: new Set(MAINTENANCE_PROFILE_TOOLS),
+  experimental: new Set(EXPERIMENTAL_PROFILE_TOOLS)
+};
+function getAllowedToolsForProfile(profile) {
+  if (profile === "full") return TOOL_PROFILES.experimental;
+  return TOOL_PROFILES[profile] ?? TOOL_PROFILES.enforcement;
+}
 var BRIEFING_TOOLS = /* @__PURE__ */ new Set(["get_briefing", "mem_relevant_to"]);
 var MUTATING_TOOLS = /* @__PURE__ */ new Set([
   "mem_save",
@@ -6394,7 +6434,8 @@ function createHaiveServer(options = {}) {
     { name: SERVER_NAME, version: SERVER_VERSION },
     { capabilities: { tools: {}, prompts: {} } }
   );
-  const shouldRegisterTool = (name) => toolProfile === "full" || ENFORCEMENT_PROFILE_TOOLS.has(name);
+  const allowedTools = getAllowedToolsForProfile(toolProfile);
+  const shouldRegisterTool = (name) => allowedTools.has(name);
   const registerTool = (name, description, schema, handler) => {
     if (!shouldRegisterTool(name)) return;
     const tool = server.tool.bind(server);
@@ -6418,7 +6459,11 @@ function createHaiveServer(options = {}) {
       }
     );
   };
-  const shouldRegisterPrompt = (name) => toolProfile === "full" || name === "bootstrap_project" || name === "post_task";
+  const shouldRegisterPrompt = (name) => {
+    if (name === "bootstrap_project" || name === "post_task") return true;
+    if (name === "import_docs") return toolProfile !== "enforcement";
+    return toolProfile === "experimental" || toolProfile === "full";
+  };
   registerTool(
     "mem_save",
     [
@@ -10907,14 +10952,14 @@ function registerDoctor(program2) {
         fix: "Edit .ai/haive.config.json: set autoSessionEnd: true (or re-run `haive init` without --manual)."
       });
     }
-    findings.push(...await collectInstallFindings(root, "0.9.15"));
+    findings.push(...await collectInstallFindings(root, "0.9.16"));
     try {
       const legacyRaw = execSync3("haive-mcp --version", {
         encoding: "utf8",
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.9.15";
+      const cliVersion = "0.9.16";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -12006,7 +12051,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
       findings: [{ severity: "info", code: "enforcement-off", message: "hAIve enforcement is disabled." }]
     };
   }
-  findings.push(...await inspectIntegrationVersions(root, "0.9.15"));
+  findings.push(...await inspectIntegrationVersions(root, "0.9.16"));
   if (config.enforcement?.requireBriefingFirst !== false && stage !== "ci") {
     const hasBriefing = await hasRecentBriefingMarker(paths, sessionId);
     findings.push(hasBriefing ? { severity: "ok", code: "briefing-loaded", message: "A recent hAIve briefing marker exists." } : {
@@ -12464,7 +12509,7 @@ function registerRun(program2) {
 
 // src/index.ts
 var program = new Command51();
-program.name("haive").description("hAIve \u2014 policy enforcement layer for AI coding agents").version("0.9.15");
+program.name("haive").description("hAIve \u2014 policy enforcement layer for AI coding agents").version("0.9.16").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);
@@ -12517,6 +12562,32 @@ registerBenchmark(program);
 registerDoctor(program);
 registerPlayback(program);
 registerPrecommit(program);
+var CORE_ROOT_COMMANDS = /* @__PURE__ */ new Set([
+  "init",
+  "doctor",
+  "agent",
+  "enforce",
+  "run",
+  "briefing",
+  "sync",
+  "mcp",
+  "memory",
+  "session",
+  "precommit",
+  "welcome"
+]);
+var CORE_MEMORY_COMMANDS = /* @__PURE__ */ new Set([
+  "add",
+  "list",
+  "query",
+  "show",
+  "verify",
+  "lint",
+  "tried",
+  "rm"
+]);
+var CORE_SESSION_COMMANDS = /* @__PURE__ */ new Set(["end"]);
+applySurfaceVisibility(program);
 program.parseAsync(process.argv).catch((err) => {
   if (isZodError(err)) {
     for (const issue of err.issues) {
@@ -12528,6 +12599,44 @@ program.parseAsync(process.argv).catch((err) => {
   }
   process.exit(1);
 });
+function applySurfaceVisibility(root) {
+  const showAdvanced = process.argv.includes("--advanced") || process.env.HAIVE_SHOW_ADVANCED === "1";
+  if (!showAdvanced) hideNonCoreCommands(root);
+  root.addHelpText(
+    "after",
+    [
+      "",
+      "Default help shows the core hAIve harness: init, doctor, agent setup, briefing, enforcement,",
+      "sync, session recaps, and high-signal memory commands.",
+      "Run `haive --advanced --help` or set HAIVE_SHOW_ADVANCED=1 to show maintenance and experimental commands."
+    ].join("\n")
+  );
+  const memoryCommand = root.commands.find((cmd) => cmd.name() === "memory");
+  memoryCommand?.addHelpText(
+    "after",
+    [
+      "",
+      "Default help shows the memory commands that support the core harness workflow.",
+      "Run `haive --advanced memory --help` or set HAIVE_SHOW_ADVANCED=1 to show review, import, digest, timeline, and conflict tools."
+    ].join("\n")
+  );
+}
+function hideNonCoreCommands(command) {
+  for (const child of command.commands) {
+    if (!isCoreCommand(command, child)) {
+      child._hidden = true;
+    }
+    hideNonCoreCommands(child);
+  }
+}
+function isCoreCommand(parent, child) {
+  const parentName = parent.name();
+  const childName = child.name();
+  if (parentName === "haive") return CORE_ROOT_COMMANDS.has(childName);
+  if (parentName === "memory") return CORE_MEMORY_COMMANDS.has(childName);
+  if (parentName === "session") return CORE_SESSION_COMMANDS.has(childName);
+  return true;
+}
 function isZodError(err) {
   return err !== null && typeof err === "object" && "issues" in err && Array.isArray(err.issues);
 }