@noir-ai/cli 1.8.0 → 1.9.0

package/dist/bin.js

@@ -1181,6 +1181,264 @@ function shouldShowBanner(opts) {
   return true;
 }
 
+// src/tui/commands/registry.ts
+var DESTRUCTIVE_PREFIXES = [
+  ["context", "index"],
+  ["context", "forget"],
+  ["memory", "save"],
+  ["memory", "forget"],
+  ["memory", "consolidate"],
+  ["task", "new"],
+  ["task", "advance"],
+  ["skills", "sync"],
+  ["daemon", "start"],
+  ["daemon", "stop"],
+  ["daemon", "restart"],
+  ["init"],
+  ["create"],
+  ["sync"],
+  ["install"],
+  ["update"]
+];
+function isDestructive(argv) {
+  return DESTRUCTIVE_PREFIXES.some((prefix) => {
+    if (argv.length < prefix.length) return false;
+    return prefix.every((tok, i) => argv[i] === tok);
+  });
+}
+function capitalizeFirst(s) {
+  if (s.length === 0) return s;
+  return `${s[0]?.toUpperCase() ?? ""}${s.slice(1)}`;
+}
+function hasAction(cmd) {
+  return cmd._actionHandler != null;
+}
+function collectLeaves(cmd, path, out) {
+  const children = cmd.commands;
+  const isLeaf = hasAction(cmd) && children.length === 0;
+  if (isLeaf) {
+    const argv = path;
+    const id = argv.join(" ");
+    const description = cmd.description() || argv.join(" ");
+    out.push({
+      id,
+      label: argv.map(capitalizeFirst).join(": "),
+      argv,
+      description,
+      category: argv[0] ?? "",
+      keywords: argv,
+      destructive: isDestructive(argv)
+    });
+    return;
+  }
+  for (const child of children) {
+    collectLeaves(child, [...path, child.name()], out);
+  }
+}
+function buildPaletteCommands(program2) {
+  const out = [];
+  collectLeaves(program2, [], out);
+  return out;
+}
+
+// src/tui/commands/sections.ts
+var HOME_SECTIONS = [
+  {
+    id: "status",
+    label: "Status & context",
+    hint: "snapshot \xB7 index \xB7 search \xB7 doctor",
+    key: "1",
+    items: [
+      {
+        id: "status",
+        label: "Status",
+        hint: "project + daemon + workflow + store snapshot (noir status)"
+      },
+      {
+        id: "context index",
+        label: "Index project",
+        hint: "(re)index files into context \xB7 \u26A0 destructive",
+        destructive: true
+      },
+      {
+        id: "context search",
+        label: "Search context",
+        hint: "hybrid search over indexed files",
+        needsArg: { prompt: "Context search query:", placeholder: "e.g. auth flow, deploy steps" }
+      },
+      {
+        id: "doctor",
+        label: "Doctor",
+        hint: "environment + project health checks"
+      },
+      {
+        id: "context status",
+        label: "Context status",
+        hint: "index freshness + counts"
+      }
+    ]
+  },
+  {
+    id: "memory",
+    label: "Memory",
+    hint: "recall \xB7 save \xB7 sessions \xB7 forget \xB7 consolidate",
+    key: "2",
+    items: [
+      {
+        id: "memory recall",
+        label: "Recall memory",
+        hint: "search cross-session memory",
+        needsArg: { prompt: "Recall query:", placeholder: "e.g. auth flow, deploy steps" }
+      },
+      {
+        id: "memory save",
+        label: "Save memory",
+        hint: "save an observation \xB7 \u26A0 destructive",
+        destructive: true,
+        needsArg: { prompt: "Memory content:", placeholder: "what you want to remember" }
+      },
+      {
+        id: "memory sessions",
+        label: "Sessions",
+        hint: "list recent memory sessions"
+      },
+      {
+        id: "memory forget",
+        label: "Forget memory",
+        hint: "forget observations by id \xB7 \u26A0 destructive",
+        destructive: true
+      },
+      {
+        id: "memory consolidate",
+        label: "Consolidate",
+        hint: "fold observations into lessons \xB7 \u26A0 destructive",
+        destructive: true
+      }
+    ]
+  },
+  {
+    id: "workflow",
+    label: "Workflow",
+    hint: "next \xB7 status \xB7 advance \xB7 handoff \xB7 wrap",
+    key: "3",
+    items: [
+      {
+        id: "task next",
+        label: "Next task",
+        hint: "suggest next phase + applicable skill"
+      },
+      {
+        id: "task status",
+        label: "Task status",
+        hint: "active task status"
+      },
+      {
+        id: "task advance",
+        label: "Advance task",
+        hint: "advance to next phase \xB7 \u26A0 destructive",
+        destructive: true
+      },
+      {
+        id: "handoff",
+        label: "Handoff",
+        hint: "ready-to-paste host prompt"
+      },
+      {
+        id: "wrap",
+        label: "Wrap (end session)",
+        hint: "session-end handoff",
+        dispatch: ["wrap", "--write"]
+      }
+    ]
+  },
+  {
+    id: "setup",
+    label: "Setup & maintenance",
+    hint: "init \xB7 create \xB7 sync \xB7 skills \xB7 install \xB7 update",
+    key: "4",
+    items: [
+      {
+        id: "init",
+        label: "Init",
+        hint: "scaffold Noir in this project \xB7 \u26A0 destructive",
+        destructive: true
+      },
+      {
+        id: "create",
+        label: "Create",
+        hint: "bootstrap in a new/empty dir \xB7 \u26A0 destructive",
+        destructive: true
+      },
+      {
+        id: "sync",
+        label: "Sync",
+        hint: "re-emit managed files + skills \xB7 \u26A0 destructive",
+        destructive: true
+      },
+      {
+        id: "skills list",
+        label: "Skills list",
+        hint: "list installed skills"
+      },
+      {
+        id: "skills sync",
+        label: "Sync skills",
+        hint: "re-emit builtin skills \xB7 \u26A0 destructive",
+        destructive: true
+      },
+      {
+        id: "update",
+        label: "Update",
+        hint: "check for a new version \xB7 \u26A0 destructive",
+        destructive: true
+      },
+      {
+        id: "install",
+        label: "Install / migrate",
+        hint: "native install / migrate \xB7 \u26A0 destructive",
+        destructive: true
+      }
+    ]
+  },
+  {
+    id: "dashboard",
+    label: "Dashboard (full-screen)",
+    hint: "noir tui \xB7 noir palette \xB7 home",
+    key: "5",
+    items: [
+      {
+        id: "tui",
+        label: "Dashboard (full-screen)",
+        hint: "live status \xB7 /command \xB7 Ctrl+K palette (noir tui)"
+      },
+      {
+        id: "palette",
+        label: "All commands (fuzzy palette)",
+        hint: "fuzzy search over every command (noir palette)"
+      }
+    ]
+  }
+];
+async function resolveSections(commands) {
+  const byId = new Map(commands.map((c2) => [c2.id, c2]));
+  const out = [];
+  for (const section of HOME_SECTIONS) {
+    const items = [];
+    for (const action of section.items) {
+      const entry = byId.get(action.id);
+      if (!entry) continue;
+      items.push({
+        ...action,
+        // Resolve the dispatch argv from the registry (never hand-written).
+        dispatch: action.dispatch ?? [...entry.argv]
+      });
+    }
+    if (items.length === 0) continue;
+    out.push({ ...section, items });
+  }
+  return out;
+}
+
 // src/commands/home.ts
 function tryProject() {
   try {
@@ -1195,7 +1453,7 @@ function shouldShowMigrationBanner(rec, currentVersion) {
   if (rec.dismissedVersions?.includes(currentVersion)) return false;
   return true;
 }
-var COMMANDS_HINT = "Commands: init \xB7 create \xB7 sync \xB7 status \xB7 context \xB7 memory \xB7 skills \xB7 task \xB7 daemon \xB7 doctor";
+var COMMANDS_HINT = "Commands: status \xB7 context \xB7 memory \xB7 task \xB7 skills \xB7 daemon \xB7 doctor \xB7 install \xB7 update \xB7 tui \xB7 palette";
 async function home(opts, deps) {
   if (isInteractive(opts) && opts.tui !== false) {
     await runMenu(opts, deps);
@@ -1207,6 +1465,138 @@ async function home(opts, deps) {
   }
   await deps.dispatch(["status"]);
 }
+async function pickSection(clack, sections, opts) {
+  const result = await clack.selectKey({
+    message: "What would you like to do?",
+    options: [
+      ...sections.map((s) => ({
+        value: s.id,
+        label: s.label,
+        hint: s.hint
+      })),
+      { value: "exit", label: "Exit", hint: "leave the home menu" }
+    ]
+  });
+  if (clack.isCancel(result)) {
+    clack.cancel("Cancelled.");
+    fail(EXIT.CANCELLED, "cancelled", opts);
+  }
+  return result;
+}
+async function pickAction(clack, section, sections, opts) {
+  const idx = sections.findIndex((s) => s.id === section.id);
+  const hasPrev = idx > 0;
+  const hasNext = idx !== -1 && idx < sections.length - 1;
+  const result = await clack.select({
+    message: section.label,
+    initialValue: section.items[0]?.id,
+    options: [
+      ...section.items.map((a) => ({
+        value: a.id,
+        label: a.label,
+        hint: a.hint
+      })),
+      // Navigation options so the user can move across sections without
+      // re-entering the section picker (the "lancar" navigation requirement).
+      ...hasPrev ? [{ value: "prev", label: "\u2190 Prev section", hint: sections[idx - 1]?.label }] : [],
+      ...hasNext ? [{ value: "next", label: "\u2192 Next section", hint: sections[idx + 1]?.label }] : [],
+      { value: "back", label: "\u2191 Back to sections", hint: "return to the section picker" }
+    ]
+  });
+  if (clack.isCancel(result)) {
+    clack.cancel("Back to the home menu.");
+    return "back";
+  }
+  if (opts.verbose) {
+    process.stderr.write(`noir: home: section '${section.id}' selected
+`);
+  }
+  return result;
+}
+async function collectArg(clack, action, opts) {
+  if (!action.needsArg) return null;
+  const value = await clack.text({
+    message: action.needsArg.prompt,
+    placeholder: action.needsArg.placeholder
+  });
+  if (clack.isCancel(value)) {
+    clack.cancel("Cancelled.");
+    fail(EXIT.CANCELLED, "cancelled", opts);
+  }
+  return String(value);
+}
+async function argvForAction(clack, action, opts) {
+  const base = action.dispatch ?? [action.id];
+  let argv = [...base];
+  if (action.needsArg) {
+    const arg = await collectArg(clack, action, opts);
+    if (arg === null) return null;
+    argv = [...base, arg];
+  }
+  if (action.destructive || isDestructive(argv)) {
+    const confirmed = await clack.confirm({
+      message: `Run \`noir ${argv.join(" ")}\`? This may modify project files / the store.`
+    });
+    if (clack.isCancel(confirmed) || !confirmed) return null;
+  }
+  return argv;
+}
+async function runGroupedMenu(clack, opts, deps, sections) {
+  let currentSection = null;
+  while (true) {
+    if (currentSection === null) {
+      const picked = await pickSection(clack, sections, opts);
+      if (clack.isCancel(picked) || picked === "exit") {
+        clack.outro("bye");
+        return;
+      }
+      const idx = sections.findIndex((s) => s.id === picked);
+      if (idx === -1) {
+        continue;
+      }
+      currentSection = idx;
+      continue;
+    }
+    const section = sections[currentSection];
+    if (!section) {
+      currentSection = null;
+      continue;
+    }
+    const chosen = await pickAction(clack, section, sections, opts);
+    if (clack.isCancel(chosen)) {
+      currentSection = null;
+      continue;
+    }
+    switch (chosen) {
+      case "back": {
+        currentSection = null;
+        continue;
+      }
+      case "next": {
+        currentSection = (currentSection + 1) % sections.length;
+        continue;
+      }
+      case "prev": {
+        currentSection = (currentSection - 1 + sections.length) % sections.length;
+        continue;
+      }
+      default: {
+        const action = section.items.find((a) => a.id === chosen);
+        if (!action) {
+          currentSection = null;
+          continue;
+        }
+        const argv = await argvForAction(clack, action, opts);
+        if (argv === null) {
+          continue;
+        }
+        await deps.dispatch(argv);
+        clack.outro("done");
+        return;
+      }
+    }
+  }
+}
 async function runMenu(opts, deps) {
   const clack = await import("@clack/prompts");
   const project = tryProject();
@@ -1245,62 +1635,8 @@ ${COMMANDS_HINT}
     );
   }
   clack.intro(project ? `noir \u2014 ${project.name}` : "noir");
-  const choice = await clack.select({
-    message: "What would you like to do?",
-    initialValue: "status",
-    options: [
-      { value: "status", label: "Status", hint: "project + daemon + store snapshot" },
-      { value: "index", label: "Index project", hint: "(re)index files into context" },
-      { value: "recall", label: "Recall memory", hint: "search cross-session memory" },
-      { value: "next", label: "Next task", hint: "suggest next phase + skill" },
-      { value: "handoff", label: "Handoff", hint: "ready-to-paste host prompt" },
-      { value: "daemon", label: "Start daemon", hint: "foreground daemon" },
-      { value: "sync", label: "Sync skills", hint: "re-emit builtin skills" },
-      { value: "exit", label: "Exit" }
-    ]
-  });
-  if (clack.isCancel(choice)) {
-    clack.cancel("Cancelled.");
-    fail(EXIT.CANCELLED, "cancelled", opts);
-  }
-  const argv = await argvForChoice(choice, clack, opts);
-  if (argv === null) {
-    clack.outro("bye");
-    return;
-  }
-  await deps.dispatch(argv);
-  clack.outro("done");
-}
-async function argvForChoice(choice, clack, opts) {
-  switch (choice) {
-    case "status":
-      return ["status"];
-    case "index":
-      return ["context", "index"];
-    case "next":
-      return ["task", "next"];
-    case "handoff":
-      return ["handoff"];
-    case "daemon":
-      return ["daemon", "start"];
-    case "sync":
-      return ["sync"];
-    case "exit":
-      return null;
-    case "recall": {
-      const query = await clack.text({
-        message: "Recall query:",
-        placeholder: "e.g. auth flow, ContextEngine, deploy steps"
-      });
-      if (clack.isCancel(query)) {
-        clack.cancel("Cancelled.");
-        fail(EXIT.CANCELLED, "cancelled", opts);
-      }
-      return ["memory", "recall", String(query)];
-    }
-    default:
-      return null;
-  }
+  const sections = await resolveSections(deps.commands ?? []);
+  await runGroupedMenu(clack, opts, deps, sections);
 }
 
 // src/commands/memory.ts
@@ -1702,66 +2038,6 @@ async function skillsSync(opts) {
   }
 }
 
-// src/tui/commands/registry.ts
-var DESTRUCTIVE_PREFIXES = [
-  ["context", "index"],
-  ["context", "forget"],
-  ["memory", "save"],
-  ["memory", "forget"],
-  ["memory", "consolidate"],
-  ["task", "new"],
-  ["task", "advance"],
-  ["skills", "sync"],
-  ["daemon", "start"],
-  ["daemon", "stop"],
-  ["daemon", "restart"],
-  ["init"],
-  ["create"],
-  ["sync"],
-  ["install"],
-  ["update"]
-];
-function isDestructive(argv) {
-  return DESTRUCTIVE_PREFIXES.some((prefix) => {
-    if (argv.length < prefix.length) return false;
-    return prefix.every((tok, i) => argv[i] === tok);
-  });
-}
-function capitalizeFirst(s) {
-  if (s.length === 0) return s;
-  return `${s[0]?.toUpperCase() ?? ""}${s.slice(1)}`;
-}
-function hasAction(cmd) {
-  return cmd._actionHandler != null;
-}
-function collectLeaves(cmd, path, out) {
-  const children = cmd.commands;
-  const isLeaf = hasAction(cmd) && children.length === 0;
-  if (isLeaf) {
-    const argv = path;
-    const id = argv.join(" ");
-    const description = cmd.description() || argv.join(" ");
-    out.push({
-      id,
-      label: argv.map(capitalizeFirst).join(": "),
-      argv,
-      description,
-      category: argv[0] ?? "",
-      keywords: argv,
-      destructive: isDestructive(argv)
-    });
-    return;
-  }
-  for (const child of children) {
-    collectLeaves(child, [...path, child.name()], out);
-  }
-}
-function buildPaletteCommands(program2) {
-  const out = [];
-  collectLeaves(program2, [], out);
-  return out;
-}
-
 // src/bin.ts
 function buildPaletteCommandsForTui() {
   return buildPaletteCommands(createProgram());
@@ -2201,16 +2477,25 @@ function createProgram() {
     };
     await runTui(opts, dispatch);
   });
-  const homeDeps = {
-    dispatch: async (argv) => {
+  program2.command("palette").description("fuzzy command palette \u2014 run any noir command (Ink)").action(async (...args) => {
+    const g = actionGlobals(args);
+    const opts = toCliOptions(g);
+    requireInteractive(opts, "`noir palette`");
+    const tuiUrl = new URL("./tui/index.js", import.meta.url).href;
+    const { runPalette } = await import(
+      /* @vite-ignore */
+      tuiUrl
+    );
+    const dispatch = async (argv) => {
       const sub = createProgram();
       try {
         await sub.parseAsync([...argv], { from: "user" });
       } catch (err) {
         handleError(err);
       }
-    }
-  };
+    };
+    await runPalette(opts, dispatch);
+  });
   program2.action(async (...args) => {
     const cmd = trailingCmd(args);
     const leftovers = cmd.args;
@@ -2226,6 +2511,20 @@ function createProgram() {
   return program2;
 }
 var program = createProgram();
+var homeDeps = {
+  dispatch: async (argv) => {
+    const sub = createProgram();
+    try {
+      await sub.parseAsync([...argv], { from: "user" });
+    } catch (err) {
+      handleError(err);
+    }
+  },
+  // The grouped home menu resolves its sections against the LIVE palette
+  // registry (home-consolidation S1/S2) — the same source the TUI palette
+  // uses — so the menu cannot drift from the commander tree.
+  commands: buildPaletteCommands(createProgram())
+};
 async function run(argv = []) {
   try {
     await program.parseAsync([...argv], { from: "user" });