Pre release

infra/docker/docker-compose.yml

@@ -4,7 +4,7 @@ services:
     container_name: bytebell-mongo
     restart: unless-stopped
     ports:
-      - "127.0.0.1:27017:27017"
+      - "127.0.0.1:27117:27017"
     volumes:
       - mongo_data:/data/db
     environment:
@@ -26,7 +26,7 @@ services:
     restart: unless-stopped
     ports:
       - "127.0.0.1:7474:7474"
-      - "127.0.0.1:7687:7687"
+      - "127.0.0.1:7787:7687"
     volumes:
       - neo4j_data:/data
     environment:
@@ -47,7 +47,7 @@ services:
     container_name: bytebell-redis
     restart: unless-stopped
     ports:
-      - "127.0.0.1:6379:6379"
+      - "127.0.0.1:6479:6379"
     volumes:
       - redis_data:/data
     command: ["redis-server", "--appendonly", "yes"]

package.json

@@ -22,7 +22,7 @@
   "lint-staged": {
     "**/*.{ts,tsx,js,mjs,cjs}": [
       "prettier --write",
-      "eslint --fix --max-warnings=0"
+      "eslint --fix --max-warnings=0 --no-warn-ignored"
     ],
     "**/*.{json,md}": [
       "prettier --write"

packages/cli/README.md

@@ -51,7 +51,8 @@ infra/docker/docker-compose.yml up -d`, polls
   prefer `bytebell boot`.
 - `bytebell index <git-url>` / `bytebell ingest [path]` / `bytebell ls`
   — talk HTTP to a running server (lazy-spawn via
-  `serverSpawn.ensureServerRunning` when the daemon is down).
+  `serverSpawn.ensureServerRunning` when the daemon is down). `ls` supports
+  an interactive mode (`-i`) for hierarchical browsing of repos and commits.
 - `bytebell delete` — list indexed knowledge in an Ink arrow-key picker
   (`DeleteSelector.tsx`, plain `useInput` — no extra dep), and on
   confirm `DELETE /api/v1/repos/:id` against the running server. The
@@ -151,7 +152,7 @@ will touch when implemented. Only the **bolded** entries ship in v0.
 | **`bytebell server start`**                      | **Spawn `bytebell-server` in foreground.**                                                                           | **Shipped**                                 |
 | **`bytebell index <git-url>`**                   | **POST `/api/v1/github/index` to local server.**                                                                     | **Shipped**                                 |
 | **`bytebell ingest [path]`**                     | **POST `/api/v1/local/index` for a directory tree.**                                                                 | **Shipped**                                 |
-| **`bytebell ls`**                                | **Render `/api/v1/repos` as a table.**                                                                               | **Shipped**                                 |
+| **`bytebell ls`**                                | **Render `/api/v1/repos` as a table or interactive explorer (`-i`). v0.**                                            | **Shipped**                                 |
 | **`bytebell delete`**                            | **Ink picker over `/api/v1/repos`, then DELETE `/api/v1/repos/:id` (Mongo + Neo4j + jobs).**                         | **Shipped**                                 |
 | **`bytebell stats`**                             | **Render `/api/v1/stats` (totals + per-repo + per-commit token / cost rows).**                                       | **Shipped**                                 |
 | `bytebell`                                       | Ink dashboard with Repos / Server / Activity / Cost panes ([docs/arch.md:172-184](../../docs/arch.md#L172-L184))     | After `@bb/server` HTTP API + activity feed |

packages/cli/package.json

@@ -8,12 +8,16 @@
   "exports": {
     ".": "./src/index.ts"
   },
+  "imports": {
+    "#src/*": "./src/*"
+  },
   "bin": {
     "bytebell": "./src/index.ts"
   },
   "dependencies": {
     "@bb/config": "workspace:*",
     "@bb/errors": "workspace:*",
+    "@bb/ingest-github": "workspace:*",
     "@bb/logger": "workspace:*",
     "@bb/types": "workspace:*",
     "commander": "^14.0.3",

packages/cli/src/BranchSelector.tsx

@@ -0,0 +1,130 @@
+import { useMemo, useState } from "react";
+import type { ReactElement } from "react";
+import { Box, Text, useApp, useInput } from "ink";
+
+export interface BranchSelectorResult {
+  branch?: string;
+  typeManually?: boolean;
+  cancelled?: boolean;
+}
+
+export interface BranchSelectorProps {
+  branches: string[];
+  title?: string;
+  onDone: (result: BranchSelectorResult) => void;
+}
+
+const MAX_VISIBLE = 12;
+
+type ItemKind = "branch" | "manual";
+
+export function BranchSelector({ branches: rawBranches, title, onDone }: BranchSelectorProps): ReactElement {
+  const { exit } = useApp();
+  const [filter, setFilter] = useState("");
+  const [index, setIndex] = useState(0);
+
+  const branches = useMemo(() => {
+    const items: Array<{ label: string; kind: ItemKind }> = rawBranches.map((b) => ({
+      label: b,
+      kind: "branch",
+    }));
+    items.push({ label: "Type manually...", kind: "manual" });
+    return items;
+  }, [rawBranches]);
+
+  const filtered = useMemo(() => {
+    if (filter.length === 0) {
+      return branches;
+    }
+    const needle = filter.toLowerCase();
+    return branches.filter((item) => item.label.toLowerCase().includes(needle));
+  }, [branches, filter]);
+
+  const boundedIndex = filtered.length === 0 ? 0 : Math.min(index, filtered.length - 1);
+
+  useInput((input, key) => {
+    if (key.escape) {
+      exit();
+      onDone({ cancelled: true });
+      return;
+    }
+    if (key.return) {
+      const chosen = filtered[boundedIndex];
+      if (!chosen) {
+        exit();
+        onDone({ cancelled: true });
+        return;
+      }
+      exit();
+      if (chosen.kind === "manual") {
+        onDone({ typeManually: true });
+      } else {
+        onDone({ branch: chosen.label });
+      }
+      return;
+    }
+    if (key.upArrow || (input === "k" && filter.length === 0)) {
+      setIndex(() => (boundedIndex > 0 ? boundedIndex - 1 : Math.max(filtered.length - 1, 0)));
+      return;
+    }
+    if (key.downArrow || (input === "j" && filter.length === 0)) {
+      setIndex(() => (boundedIndex < filtered.length - 1 ? boundedIndex + 1 : 0));
+      return;
+    }
+    if (key.backspace || key.delete) {
+      setFilter((s) => s.slice(0, -1));
+      setIndex(0);
+      return;
+    }
+    if (input.length > 0 && !key.ctrl && !key.meta) {
+      setFilter((s) => s + input);
+      setIndex(0);
+    }
+  });
+
+  const heading = title ?? "Select a branch";
+  const visibleStart = clampWindow(boundedIndex, filtered.length, MAX_VISIBLE);
+  const visible = filtered.slice(visibleStart, visibleStart + MAX_VISIBLE);
+
+  return (
+    <Box flexDirection="column" borderStyle="round" paddingX={1} paddingY={0}>
+      <Box marginBottom={1}>
+        <Text bold>{heading}</Text>
+        <Text dimColor>{`  (${filtered.length}/${branches.length})`}</Text>
+      </Box>
+      <Box marginBottom={1}>
+        <Text color="cyan">filter: </Text>
+        <Text>{filter.length > 0 ? filter : <Text dimColor>(type to filter)</Text>}</Text>
+      </Box>
+      {filtered.length === 0 ? (
+        <Box>
+          <Text dimColor>No branches match the filter. Backspace to clear.</Text>
+        </Box>
+      ) : (
+        visible.map((item, i) => {
+          const absoluteIndex = visibleStart + i;
+          const cursor = absoluteIndex === boundedIndex;
+          const isManual = item.kind === "manual";
+          return (
+            <Box key={`${item.kind}-${item.label}`}>
+              <Text color={cursor ? "cyan" : "gray"}>{cursor ? "▶ " : "  "}</Text>
+              <Text color={cursor ? "cyan" : isManual ? "yellow" : "white"}>{item.label}</Text>
+            </Box>
+          );
+        })
+      )}
+      <Box marginTop={1}>
+        <Text dimColor>[type to filter] [↑/↓] move [Enter] choose [Backspace] clear [Esc] cancel</Text>
+      </Box>
+    </Box>
+  );
+}
+
+function clampWindow(index: number, total: number, size: number): number {
+  if (total <= size) {
+    return 0;
+  }
+  const halfWindow = Math.floor(size / 2);
+  const start = Math.max(0, Math.min(index - halfWindow, total - size));
+  return start;
+}