@mnemonik/cli 7.105.0 → 7.106.0

package/dist/router.js

@@ -857,6 +857,7 @@ var init_hookRuntime = __esm({
 
 // packages/cli/src/router.ts
 import { humanReason, humanReport, humanIdentityState } from "./humanReason.js";
+import { helpScreen } from "./help.js";
 import { enableScanner, updateScannerRoots } from "./scanner/enable.js";
 import { controlScanner, scannerReceipt } from "./scanner/control.js";
 import { updateScanner } from "./scanner/update.js";
@@ -5304,6 +5305,8 @@ var alreadyConnectedFolderLine = (name2) => `  \u2713 ${name2} is already connec
 var removedFolderLine = (name2) => `  \u2713 ${name2} is no longer connected.`;
 var projectDeletionWarning = (name2) => `Deleting ${name2} removes its memories, code index and summaries for everyone. This cannot be undone.`;
 var projectDeletedLine = (name2) => `Deleted ${name2}.`;
+var NOTHING_DELETED_LINE = "Nothing was deleted.";
+var dataDeletePrompt = (projectId) => `This deletes everything background indexing has sent for ${projectId} from your account. Type yes to continue.`;
 var stillWatchedLine = (root) => `The folder is still being indexed. Run mnemonik remove ${root} to stop that.`;
 var identityFileKeptLine = "This folder's .mnemonik.json still points at the deleted project. Connecting the folder again creates a new project.";
 var CODEX_SIGNED_IN_MESSAGE = "Codex is signed in to Mnemonik.";
@@ -5360,28 +5363,7 @@ var values = /* @__PURE__ */ new Set([
   "project",
   "exclusions"
 ]);
-var help = `Usage: mnemonik <command> [options]
-
-Commands:
-  install
-  status
-  connect <${hostOrder.join("|")}>
-  project <init|setup|status|link|ensure|delete>
-  add <folder>
-  remove <folder>
-  data delete --project <id>
-  diagnostics <preview|send>
-  doctor
-  repair
-  update
-  uninstall
-  auth login
-  auth status
-  auth logout [--host <host>] [--confirm]
-  logout
-
-Global options: --json --non-interactive --no-browser --help --version
-Install consent: --accept-indexing --accept-limited --apply`;
+var help = helpScreen([]) ?? "";
 function parse(args2) {
   const positionals = [];
   const flags2 = /* @__PURE__ */ new Map();
@@ -6045,7 +6027,7 @@ async function deleteProjectCommand(parsed, rest, deps, output) {
     typed = String((await readline[Symbol.asyncIterator]().next()).value ?? "").trim();
     readline.close();
     if (typed.toLowerCase() !== project.name.toLowerCase()) {
-      output.line("Nothing was deleted.");
+      output.line(NOTHING_DELETED_LINE);
       return 130;
     }
   }
@@ -6090,7 +6072,10 @@ async function deleteProjectCommand(parsed, rest, deps, output) {
 }
 async function runCli(args2, deps = {}) {
   const parsed = parse(args2);
-  const silent = parsed.flags.has("automatic");
+  const helpIndex = args2.findIndex(
+    (argument) => argument === "--help" || argument.startsWith("--help=")
+  );
+  const silent = helpIndex === -1 && parsed.flags.has("automatic");
   const discard = { write: () => {
   } };
   const stdout = silent ? discard : deps.stdout ?? process.stdout;
@@ -6098,6 +6083,16 @@ async function runCli(args2, deps = {}) {
   const output = new Output(stdout, stderr, {
     home: deps.home ?? homedir3()
   });
+  const usageError = (positionals) => {
+    stderr.write(helpScreen(positionals) ?? help);
+    return 2;
+  };
+  if (helpIndex !== -1) {
+    const positionals = args2.slice(0, helpIndex).filter((argument) => !argument.startsWith("--"));
+    const screen = helpScreen(positionals);
+    stdout.write(screen ?? helpScreen(positionals.slice(0, 1)) ?? help);
+    return screen ? 0 : 2;
+  }
   if (process.env.MNEMONIK_DEV_RELEASE_DIR && !silent)
     stderr.write(
       "WARNING: MNEMONIK_DEV_RELEASE_DIR uses development artifacts; readiness remains LIMITED.\n"
@@ -6109,15 +6104,13 @@ async function runCli(args2, deps = {}) {
     output.line(await packageVersion());
     return 0;
   }
-  if (parsed.flags.has("help") || !parsed.positionals.length) {
-    if (parsed.positionals.length && !parsed.flags.has("help"))
-      return output.error(`Unknown command: ${parsed.positionals[0]}`), 2;
-    output.line(help);
+  if (!parsed.positionals.length) {
+    stdout.write(help);
     return 0;
   }
   const [command, subcommand, ...rest] = parsed.positionals;
   if (command === "install") {
-    if (subcommand) return output.error(`Unexpected argument: ${subcommand}`), 2;
+    if (subcommand) return usageError(["install"]);
     return installCommand(parsed, deps, output);
   }
   if (command === "roots" || command === "add" || command === "remove") {
@@ -6125,7 +6118,7 @@ async function runCli(args2, deps = {}) {
     const actionArguments = command === "roots" ? rest : [subcommand, ...rest].filter(Boolean);
     const invalid = allowed(parsed, ["accept-indexing", "apply", "no-browser", "non-git"]);
     if (invalid || !["add", "remove", "list"].includes(action ?? "") || actionArguments.length !== (action === "list" ? 0 : 1))
-      return output.error(invalid ?? "Usage: mnemonik add <folder> or mnemonik remove <folder>"), 2;
+      return invalid ? (output.error(invalid), 2) : usageError([command]);
     const stateDir = deps.installStateDir ?? stateDirectory(process.platform, process.env, deps.home);
     const saved = JSON.parse(
       await readFile3(`${stateDir}/scanner/state.json`, "utf8").catch(() => "null")
@@ -6136,7 +6129,7 @@ async function runCli(args2, deps = {}) {
       else for (const root of saved.config.roots) output.line(root);
       return 0;
     }
-    if (action === "add" && (parsed.flags.has("non-interactive") || parsed.flags.has("json")) && !parsed.flags.has("apply"))
+    if ((action === "add" || action === "remove") && (parsed.flags.has("non-interactive") || parsed.flags.has("json")) && !parsed.flags.has("apply"))
       return actionRequired2(output, parsed.flags.has("json"), "Rerun with --apply", "--apply");
     const pathArgument = actionArguments[0] ?? "";
     const requested = action === "add" ? await realpath(pathArgument) : saved.config.roots.find((root) => root === pathArgument) ?? pathArgument;
@@ -6208,7 +6201,8 @@ async function runCli(args2, deps = {}) {
   }
   if (command === "auth" && subcommand === "logout" && parsed.flags.get("component") === "scanner") {
     const invalid = allowed(parsed, ["component"]);
-    if (invalid || rest.length) return output.error(invalid ?? "Unexpected argument"), 2;
+    if (invalid || rest.length)
+      return invalid ? (output.error(invalid), 2) : usageError(["auth", "logout"]);
     try {
       const stateDir = deps.installStateDir ?? stateDirectory(process.platform, process.env, deps.home);
       const saved = JSON.parse(await readFile3(`${stateDir}/scanner/state.json`, "utf8"));
@@ -6236,10 +6230,27 @@ async function runCli(args2, deps = {}) {
     }
   }
   if (command === "data") {
-    const invalid = allowed(parsed, ["project"]);
+    const invalid = allowed(parsed, ["project", "confirm"]);
     const project = parsed.flags.get("project");
     if (invalid || subcommand !== "delete" || rest.length || typeof project !== "string")
-      return output.error(invalid ?? "Usage: mnemonik data delete --project <id>"), 2;
+      return invalid ? (output.error(invalid), 2) : usageError(["data", "delete"]);
+    if (!parsed.flags.has("confirm")) {
+      if (parsed.flags.has("non-interactive") || parsed.flags.has("json"))
+        return actionRequired2(
+          output,
+          parsed.flags.has("json"),
+          "Rerun with --confirm",
+          "--confirm"
+        );
+      output.line(dataDeletePrompt(project));
+      const readline = createInterface({ input: deps.input ?? process.stdin, terminal: false });
+      const answer = String((await readline[Symbol.asyncIterator]().next()).value ?? "").trim();
+      readline.close();
+      if (!/^(?:y|yes)$/iu.test(answer)) {
+        output.line(NOTHING_DELETED_LINE);
+        return 130;
+      }
+    }
     try {
       const bearer = await ensureCliAuth(deps, output, false);
       const result = await deleteScannerIndex(project, bearer, deps.grantFetch);
@@ -6256,7 +6267,7 @@ async function runCli(args2, deps = {}) {
   }
   if ((command === "update" || command === "uninstall") && parsed.flags.get("component") === "scanner") {
     const invalid = allowed(parsed, ["component", "confirm"]);
-    if (invalid || subcommand) return output.error(invalid ?? "Unexpected argument"), 2;
+    if (invalid || subcommand) return invalid ? (output.error(invalid), 2) : usageError([command]);
     try {
       const options = {
         stateDir: deps.installStateDir ?? stateDirectory(process.platform, process.env, deps.home),
@@ -6337,8 +6348,7 @@ async function runCli(args2, deps = {}) {
       "apply",
       ...command === "update" ? ["automatic"] : []
     ]);
-    if (invalid || subcommand)
-      return output.error(invalid ?? `Unexpected argument: ${subcommand}`), 2;
+    if (invalid || subcommand) return invalid ? (output.error(invalid), 2) : usageError([command]);
     if (command === "uninstall" && parsed.flags.has("non-interactive")) {
       const missing = requireConsent(parsed, output, ["confirm"]);
       if (missing !== void 0) return missing;
@@ -6348,8 +6358,7 @@ async function runCli(args2, deps = {}) {
   }
   if (command === "update") {
     const invalid = allowed(parsed, ["automatic"]);
-    if (invalid || subcommand)
-      return output.error(invalid ?? `Unexpected argument: ${subcommand}`), 2;
+    if (invalid || subcommand) return invalid ? (output.error(invalid), 2) : usageError(["update"]);
     const runtimeUpdate = deps.runtimeUpdate;
     if (!runtimeUpdate)
       return placeholder(
@@ -6375,16 +6384,14 @@ async function runCli(args2, deps = {}) {
     return 0;
   }
   if (command === "doctor") {
-    if (subcommand) return output.error(`Unexpected argument: ${subcommand}`), 2;
+    if (subcommand) return usageError(["doctor"]);
     return doctorCommand(parsed, deps, output);
   }
   if (command === "diagnostics") {
     const invalid = allowed(parsed, subcommand === "preview" ? ["out"] : []);
     const bundleId = rest[0];
     if (invalid || !["preview", "send"].includes(subcommand ?? "") || subcommand === "preview" && rest.length || subcommand === "send" && (rest.length !== 1 || !bundleId))
-      return output.error(
-        invalid ?? "Usage: mnemonik diagnostics preview [--out <file>] | send <bundle-id>"
-      ), 2;
+      return invalid ? (output.error(invalid), 2) : usageError(["diagnostics"]);
     try {
       const result = subcommand === "preview" ? await previewDiagnostics(
         parsed.flags.get("out"),
@@ -6425,8 +6432,7 @@ Preview: ${preview.path}
   }
   if (command === "status") {
     const invalid = allowed(parsed, []);
-    if (invalid || subcommand)
-      return output.error(invalid ?? `Unexpected argument: ${subcommand}`), 2;
+    if (invalid || subcommand) return invalid ? (output.error(invalid), 2) : usageError(["status"]);
     const document = await collectCurrentInstallation(deps, output);
     const version = await packageVersion();
     const store = new RuntimeStore(
@@ -6446,7 +6452,7 @@ Preview: ${preview.path}
     const invalid = allowed(parsed, ["scope"]);
     if (invalid) return output.error(invalid), 2;
     if (!subcommand || rest.length || !hostOrder.includes(subcommand))
-      return output.error(`Usage: mnemonik connect <${hostOrder.join("|")}>`), 2;
+      return usageError(["connect"]);
     const host = subcommand;
     const editor = (await localEditorStatus(deps.home ?? homedir3())).find(
       (candidate) => candidate.host === host
@@ -6480,11 +6486,11 @@ Preview: ${preview.path}
   }
   if (command === "project") {
     if (!subcommand || !["init", "setup", "status", "link", "ensure", "delete"].includes(subcommand))
-      return output.error("Usage: mnemonik project <init|setup|status|link|ensure|delete>"), 2;
+      return usageError(["project"]);
     if (subcommand === "delete") {
       const unknown = allowed(parsed, ["confirm"]);
       if (unknown || rest.length > 1)
-        return output.error(unknown ?? "Usage: mnemonik project delete [<project id or name>]"), 2;
+        return unknown ? (output.error(unknown), 2) : usageError(["project", "delete"]);
       return deleteProjectCommand(parsed, rest, deps, output);
     }
     const invalid = allowed(
@@ -6493,8 +6499,7 @@ Preview: ${preview.path}
     );
     if (invalid) return output.error(invalid), 2;
     if (subcommand === "ensure") {
-      if (rest.length || !parsed.flags.has("agent") || !parsed.flags.has("json"))
-        return output.error("Usage: mnemonik project ensure --agent --json"), 2;
+      if (rest.length) return usageError(["project", "ensure"]);
       return ensureProjectForAgent({
         output,
         cwd: deps.cwd ?? process.cwd(),
@@ -6507,9 +6512,7 @@ Preview: ${preview.path}
       if (missing !== void 0) return missing;
     }
     if (subcommand === "link" && (rest.length < 1 || rest.length > 2) || subcommand !== "link" && rest.length > 1)
-      return output.error(
-        `Usage: mnemonik project ${subcommand}${subcommand === "link" ? " <project-id> [path]" : " [path]"}`
-      ), 2;
+      return usageError(["project", subcommand]);
     return runProjectCommand(
       {
         command: subcommand,
@@ -6535,10 +6538,7 @@ Preview: ${preview.path}
     );
   }
   if (command === "identity") {
-    if (subcommand !== "migrate")
-      return output.error(
-        "Usage: mnemonik identity migrate [paths] [--report|--backup]\n       mnemonik identity migrate [--apply|--verify|--rollback <run-id>]"
-      ), 2;
+    if (subcommand !== "migrate") return usageError(["identity", "migrate"]);
     const invalid = allowed(parsed, ["report", "backup", "apply", "verify", "rollback"]);
     if (invalid) return output.error(invalid), 2;
     const selected = ["report", "backup", "apply", "verify", "rollback"].filter(
@@ -6589,7 +6589,9 @@ Preview: ${preview.path}
       "uninstall",
       "status"
     ].includes(subcommand))
-      return output.error("Usage: mnemonik scanner <enable|start|stop|uninstall|status>"), 2;
+      return usageError(
+        subcommand && helpScreen(["scanner", subcommand]) ? ["scanner", subcommand] : ["scanner"]
+      );
     const invalid = allowed(
       parsed,
       subcommand === "enable" ? ["accept-indexing", "apply", "scan-roots", "exclusions", "no-browser"] : subcommand === "export-preview" ? ["out"] : []
@@ -6726,7 +6728,9 @@ Preview: ${preview.path}
   if (command === "auth") {
     const invalid = allowed(parsed, ["host", "confirm", "no-browser", "reopen-install"]);
     if (invalid || rest.length || !["login", "status", "logout"].includes(subcommand ?? "") || parsed.flags.has("reopen-install") && subcommand !== "login")
-      return output.error(invalid ?? "Usage: mnemonik auth <login|status|logout> [--host <host>]"), 2;
+      return invalid ? (output.error(invalid), 2) : usageError(
+        subcommand && helpScreen(["auth", subcommand]) ? ["auth", subcommand] : ["auth"]
+      );
     const host = parsed.flags.get("host");
     if (host && !hostOrder.includes(host)) return output.error("Invalid host"), 2;
     if (subcommand === "login") {
@@ -6820,7 +6824,7 @@ Preview: ${preview.path}
     return 0;
   }
   if (command === "logout") {
-    if (subcommand) return output.error(`Unexpected argument: ${subcommand}`), 2;
+    if (subcommand) return usageError(["logout"]);
     const invalid = allowed(parsed, []);
     if (invalid) return output.error(invalid), 2;
     await auth(deps, output, false).logout();
@@ -6828,16 +6832,17 @@ Preview: ${preview.path}
     else output.line("Logged out.");
     return 0;
   }
-  output.error(`Unknown command: ${command}`);
-  return 2;
+  return usageError([]);
 }
 var serializeReadiness2 = (input) => devReadiness(serializeReadiness(input));
 export {
   CODEX_SIGNED_IN_MESSAGE,
   CONNECT_NOT_APPROVED_MESSAGE,
+  NOTHING_DELETED_LINE,
   alreadyConnectedFolderLine,
   connectFolderPrompt,
   connectedFolderLine,
+  dataDeletePrompt,
   help,
   identityFileKeptLine,
   maintenanceExitCode,