nemoris 0.1.0

package/src/cli/help.js

@@ -0,0 +1,265 @@
+export const USER_FACING_COMMANDS = [
+  {
+    name: "setup",
+    description: "Configure your agent and connect Telegram",
+    usage: [
+      "nemoris setup [--non-interactive] [--accept-risk] [--flow <quickstart|manual>]",
+      "nemoris setup telegram",
+    ],
+  },
+  {
+    name: "start",
+    description: "Start the agent daemon",
+    usage: ["nemoris start"],
+  },
+  {
+    name: "stop",
+    description: "Stop the agent daemon",
+    usage: ["nemoris stop"],
+  },
+  {
+    name: "restart",
+    description: "Restart the agent daemon",
+    usage: ["nemoris restart"],
+  },
+  {
+    name: "status",
+    description: "Show daemon and session status",
+    usage: ["nemoris status [--json]"],
+  },
+  {
+    name: "logs",
+    description: "Tail the daemon log",
+    usage: ["nemoris logs [n] [--follow|-f] [--raw]"],
+  },
+  {
+    name: "chat",
+    description: "Open the terminal chat client",
+    usage: ["nemoris chat [--agent <id>] [--model <name>] [--no-color] [--json]"],
+  },
+  {
+    name: "models",
+    description: "Show configured auth and model routing",
+    usage: ["nemoris models"],
+  },
+  {
+    name: "doctor",
+    description: "Run a health check",
+    usage: ["nemoris doctor [--json]"],
+  },
+  {
+    name: "migrate",
+    description: "Import agents from OpenClaw",
+    usage: ["nemoris migrate [--dry-run]"],
+  },
+  {
+    name: "mcp",
+    description: "Manage MCP server connections",
+    usage: ["nemoris mcp list"],
+  },
+];
+
+export const AUXILIARY_COMMANDS = [
+  {
+    name: "init",
+    description: "Legacy alias for setup",
+    usage: ["nemoris init [--non-interactive] [--accept-risk] [--flow <quickstart|manual>]"],
+  },
+  {
+    name: "telegram",
+    description: "Telegram utilities",
+    usage: ["nemoris telegram whoami"],
+  },
+  {
+    name: "tools",
+    description: "Manage local tool definitions",
+    usage: ["nemoris tools", "nemoris tools add <tool-id>"],
+  },
+  {
+    name: "skills",
+    description: "List configured skills",
+    usage: ["nemoris skills"],
+  },
+  {
+    name: "improvements",
+    description: "List active improvement tunings",
+    usage: ["nemoris improvements"],
+  },
+  {
+    name: "uninstall",
+    description: "Remove local setup artifacts",
+    usage: ["nemoris uninstall [--force|-f]"],
+  },
+  {
+    name: "run",
+    description: "Alias for execute-job in provider mode",
+    usage: ["nemoris run <job-id>"],
+  },
+  {
+    name: "runs",
+    description: "Alias for review-runs 10",
+    usage: ["nemoris runs"],
+  },
+  {
+    name: "internal",
+    description: "Show all internal and developer commands",
+    usage: ["nemoris internal --help", "nemoris --all"],
+  },
+];
+
+export const INTERNAL_COMMANDS = [
+  "battle",
+  "benchmark-models",
+  "compare-improvements",
+  "compare-improvements-with-report-fallback",
+  "compare-jobs",
+  "config-validate",
+  "consume-follow-up",
+  "cutover-readiness",
+  "daily-driver-trust-pack",
+  "deliver-notification-file",
+  "deliver-notifications",
+  "dependency-health",
+  "demo",
+  "due-jobs",
+  "embedding-health",
+  "embedding-readiness",
+  "evaluate-job",
+  "evaluate-runs",
+  "execute-job",
+  "execute-job-with-report-fallback",
+  "find-agent-cards",
+  "improvement-targets",
+  "index-embeddings",
+  "job-embedding-health",
+  "lane-readiness",
+  "list-agent-cards",
+  "live-cron-summary",
+  "maintenance-status",
+  "manifest-summary",
+  "memory-backends",
+  "peer-readiness",
+  "pilot-status",
+  "plan-job",
+  "preview-workspace-health-validation",
+  "provider-capabilities",
+  "provider-health",
+  "provider-mode-policy",
+  "prune-state",
+  "query-embeddings",
+  "query-qmd",
+  "repair-and-compare-improvement",
+  "repair-and-compare-improvement-with-report-fallback",
+  "rebuild-job-embeddings",
+  "report-fallback-readiness",
+  "resolve-delivery-profile",
+  "review-deliveries",
+  "review-inbox",
+  "review-notifications",
+  "review-pending-followups",
+  "review-pending-handoffs",
+  "review-runs",
+  "runtime-status",
+  "send-test-delivery",
+  "serve-daemon",
+  "serve-transport",
+  "shadow-compare",
+  "shadow-eval-job",
+  "shadow-import",
+  "shadow-summary",
+  "sqlite-checkpoint",
+  "sqlite-status",
+  "suggest-peers",
+  "sweep-pending-followups",
+  "sweep-pending-handoffs",
+  "tick-scheduler",
+  "validate-config",
+  "validate-memory-rollup",
+  "validate-workspace-health",
+  "validate-workspace-health-full",
+  "validate-workspace-health-pilot",
+  "validate-workspace-health-repeatable",
+];
+
+const COMMAND_HELP = new Map([
+  ...USER_FACING_COMMANDS.map((command) => [command.name, command]),
+  ...AUXILIARY_COMMANDS.map((command) => [command.name, command]),
+]);
+
+const KNOWN_COMMANDS = new Set([
+  ...USER_FACING_COMMANDS.map((command) => command.name),
+  ...AUXILIARY_COMMANDS.map((command) => command.name),
+  ...INTERNAL_COMMANDS,
+]);
+
+function formatCommandRows(commands) {
+  return commands.map((command) => `  ${command.name.padEnd(10)} ${command.description}`);
+}
+
+function formatInternalCommandRows(commands) {
+  return commands.map((command) => `  ${command}`);
+}
+
+export function hasHelpFlag(args = []) {
+  return args.includes("--help") || args.includes("-h");
+}
+
+export function shouldShowAllCommands(args = []) {
+  return args.includes("--all");
+}
+
+export function isKnownCommand(command) {
+  return KNOWN_COMMANDS.has(command);
+}
+
+export function formatGeneralHelp({ includeInternal = false } = {}) {
+  const lines = [
+    "nemoris — personal agent runtime",
+    "",
+  ];
+
+  if (includeInternal) {
+    lines.push("User-facing commands:");
+    lines.push(...formatCommandRows(USER_FACING_COMMANDS));
+    lines.push("");
+    lines.push("Other commands:");
+    lines.push(...formatCommandRows(AUXILIARY_COMMANDS));
+    lines.push("");
+    lines.push("Internal/developer commands:");
+    lines.push(...formatInternalCommandRows(INTERNAL_COMMANDS));
+  } else {
+    lines.push("Commands:");
+    lines.push(...formatCommandRows(USER_FACING_COMMANDS));
+  }
+
+  lines.push("");
+  lines.push("Run nemoris <command> --help for command details.");
+  if (!includeInternal) {
+    lines.push("Run nemoris internal --help to see all internal commands.");
+  }
+  return lines.join("\n");
+}
+
+export function formatCommandHelp(command) {
+  const help = COMMAND_HELP.get(command);
+  if (help) {
+    const lines = [
+      help.description,
+      "",
+      "Usage:",
+      ...help.usage.map((usage) => `  ${usage}`),
+    ];
+    return lines.join("\n");
+  }
+
+  if (INTERNAL_COMMANDS.includes(command)) {
+    return [
+      "Internal/developer command.",
+      "",
+      "Usage:",
+      `  nemoris ${command} [args]`,
+    ].join("\n");
+  }
+
+  return null;
+}

package/src/cli/output-filter.js

@@ -0,0 +1,49 @@
+export function filterOpenClawPatchLine(chunk) {
+  const isBuffer = Buffer.isBuffer(chunk);
+  const text = typeof chunk === "string"
+    ? chunk
+    : isBuffer
+      ? chunk.toString("utf8")
+      : null;
+
+  if (text === null) {
+    return chunk;
+  }
+
+  const filtered = text
+    .split(/\r?\n/)
+    .filter((line) => !line.startsWith("[openclaw/patch]"))
+    .join("\n");
+
+  if (!filtered) {
+    return null;
+  }
+
+  return isBuffer ? Buffer.from(filtered, "utf8") : filtered;
+}
+
+export function createFilteredStdoutWrite(originalWrite) {
+  return function filteredStdoutWrite(chunk, ...args) {
+    const nextChunk = filterOpenClawPatchLine(chunk);
+    if (nextChunk === null) {
+      return true;
+    }
+    return originalWrite(nextChunk, ...args);
+  };
+}
+
+export function installOpenClawStdoutFilter(stream = process.stdout) {
+  if (!stream || typeof stream.write !== "function") {
+    return null;
+  }
+
+  if (stream.__nemorisOpenClawFilterInstalled) {
+    return stream.write;
+  }
+
+  const originalWrite = stream.write.bind(stream);
+  const filteredWrite = createFilteredStdoutWrite(originalWrite);
+  stream.write = filteredWrite;
+  stream.__nemorisOpenClawFilterInstalled = true;
+  return filteredWrite;
+}