cueloop 0.1.0-alpha.7 → 0.1.0-alpha.71

package/package.json

@@ -1,37 +1,42 @@
 {
   "name": "cueloop",
-  "version": "0.1.0-alpha.7",
+  "version": "0.1.0-alpha.71",
+  "description": "Terminal review surface for coding agents: annotate plans and diffs, return a verdict, send structured feedback back",
+  "homepage": "https://github.com/mmurakaru/cueloop#readme",
+  "bugs": {
+    "url": "https://github.com/mmurakaru/cueloop/issues"
+  },
   "license": "Apache-2.0",
-  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mmurakaru/cueloop.git",
+    "directory": "packages/cli"
+  },
   "bin": {
     "cueloop": "./src/main.ts"
   },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "type": "module",
   "exports": {
     ".": "./src/main.ts"
   },
-  "dependencies": {
-    "@cueloop/schema": "0.1.0-alpha.7",
-    "@cueloop/daemon": "0.1.0-alpha.7",
-    "@cueloop/client": "0.1.0-alpha.7"
-  },
   "publishConfig": {
     "access": "public"
   },
-  "files": [
-    "src",
-    "README.md"
-  ],
-  "engines": {
-    "bun": ">=1.3.0"
+  "scripts": {
+    "build:binary": "bun build --compile --external cpu-features ./src/main.ts --outfile dist/cueloop"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mmurakaru/cueloop.git",
-    "directory": "packages/cli"
-  },
-  "homepage": "https://github.com/mmurakaru/cueloop#readme",
-  "bugs": {
-    "url": "https://github.com/mmurakaru/cueloop/issues"
+  "dependencies": {
+    "@cueloop/adapters": "0.1.0-alpha.71",
+    "@cueloop/client": "0.1.0-alpha.71",
+    "@cueloop/daemon": "0.1.0-alpha.71",
+    "@cueloop/schema": "0.1.0-alpha.71",
+    "valibot": "^1.4.2"
   },
-  "description": "Terminal review surface for coding agents: annotate plans and diffs, return a verdict, send structured feedback back"
-}
+  "engines": {
+    "bun": ">=1.3.0"
+  }
+}

package/src/actions-command.ts

@@ -0,0 +1,49 @@
+/**
+ * `cueloop actions list [--session <id>]` - print the quick-action vocabulary
+ * (the same presets a human picks in the marker popover) so a review-side agent
+ * can reference one by name or index via `session annotate --action`. With
+ * `--session`, the vocabulary comes from that session's repo (matching what
+ * `--action` will resolve); otherwise from the caller's cwd. JSON on stdout.
+ */
+
+import { loadConfig } from "@cueloop/client/config";
+import { DaemonClient } from "@cueloop/daemon/client";
+import { parseArgs, stringFlag } from "./args";
+
+export async function actionsCommand(argv: string[]): Promise<number> {
+  const { positional, flags } = parseArgs(argv);
+  const primitive = positional[0] ?? "list";
+
+  if (primitive !== "list") {
+    console.error("usage: cueloop actions list [--session <id>]");
+
+    return 2;
+  }
+  const role = stringFlag(flags, "role") === "agent" ? "agent" : undefined;
+  const repoRoot = await repoRootForSession(stringFlag(flags, "session"), role);
+  const actions = loadConfig({ repoRoot }).actions;
+  const numbered = actions.map((action, index) => ({
+    index: index + 1,
+    prompt: action.prompt,
+    metadata: action.metadata,
+  }));
+
+  console.log(JSON.stringify(numbered, null, 2));
+
+  return 0;
+}
+
+/** The repo the given session lives in, or the caller's cwd when no session is named. */
+async function repoRootForSession(
+  sessionId: string | undefined,
+  role: "agent" | undefined,
+): Promise<string> {
+  if (sessionId === undefined) return process.cwd();
+  const client = await DaemonClient.connect({ autostart: true, role });
+
+  try {
+    return (await client.sessionGet(sessionId)).workspace.repoRoot;
+  } finally {
+    client.close();
+  }
+}

package/src/args.ts

@@ -1,5 +1,7 @@
 /** Tiny flag parser: --key value, --key=value, boolean --flag, positionals. */
 
+import * as v from "valibot";
+
 export interface ParsedArgs {
   positional: string[];
   flags: Record<string, string | boolean>;
@@ -8,18 +10,22 @@ export interface ParsedArgs {
 export function parseArgs(argv: string[]): ParsedArgs {
   const positional: string[] = [];
   const flags: Record<string, string | boolean> = {};
+
   for (let i = 0; i < argv.length; i++) {
-    const a = argv[i]!;
-    if (!a.startsWith("--")) {
-      positional.push(a);
+    const argument = argv[i]!;
+
+    if (!argument.startsWith("--")) {
+      positional.push(argument);
       continue;
     }
-    const eq = a.indexOf("=");
-    if (eq !== -1) {
-      flags[a.slice(2, eq)] = a.slice(eq + 1);
+    const equalsIndex = argument.indexOf("=");
+
+    if (equalsIndex !== -1) {
+      flags[argument.slice(2, equalsIndex)] = argument.slice(equalsIndex + 1);
     } else {
-      const key = a.slice(2);
+      const key = argument.slice(2);
       const next = argv[i + 1];
+
       if (next !== undefined && !next.startsWith("--")) {
         flags[key] = next;
         i++;
@@ -28,10 +34,15 @@ export function parseArgs(argv: string[]): ParsedArgs {
       }
     }
   }
+
   return { positional, flags };
 }
 
-export function flagStr(flags: Record<string, string | boolean>, key: string): string | undefined {
-  const v = flags[key];
-  return typeof v === "string" ? v : undefined;
+export function stringFlag(
+  flags: Record<string, string | boolean>,
+  key: string,
+): string | undefined {
+  const result = v.safeParse(v.string(), flags[key]);
+
+  return result.success ? result.output : undefined;
 }

package/src/dev-command.ts

@@ -0,0 +1,85 @@
+/**
+ * `cueloop dev`: open the TUI against an isolated dev home seeded once with a
+ * plan and a diff under this repo's project plus a standalone reply thread, so
+ * the Projects and Threads sidebar and the thread view are populated without a
+ * live agent. It never touches the real ~/.cueloop home.
+ */
+
+import { homedir, tmpdir } from "node:os";
+import { join } from "node:path";
+import { DaemonClient } from "@cueloop/daemon/client";
+import { resolveWorkspace } from "@cueloop/daemon/review";
+
+const SEED_PLAN = `# Read the repository
+
+A seeded plan so \`cueloop dev\` always has a thread to open.
+
+## Steps
+- open the thread view
+- move the cursor into the agent's text
+- type to leave a comment
+`;
+
+const SEED_REPLY = `A standalone thought, not tied to any repository.
+
+It lands under Threads in the sidebar rather than a project.
+`;
+
+const SEED_DIFF_PATH = "packages/client/src/theme.ts";
+const SEED_DIFF_OLD = '  accent: "#f5a3a3",\n';
+const SEED_DIFF_NEW = '  accent: "#cba6f7",\n';
+const SEED_DIFF = `diff --git a/${SEED_DIFF_PATH} b/${SEED_DIFF_PATH}
+--- a/${SEED_DIFF_PATH}
++++ b/${SEED_DIFF_PATH}
+@@ -1 +1 @@
+-${SEED_DIFF_OLD.trimEnd()}
++${SEED_DIFF_NEW.trimEnd()}
+`;
+
+async function seedDevSessions(client: DaemonClient): Promise<void> {
+  // the current repo carries a root commit, so its threads gather under a project
+  const project = await resolveWorkspace(process.cwd());
+  // a non-repo directory has no root commit, so its thread stays standalone
+  const standalone = await resolveWorkspace(tmpdir());
+
+  await client.sessionCreate(project, {
+    type: "plan",
+    content: SEED_PLAN,
+    meta: { title: "Read the repository" },
+  });
+  await client.sessionCreate(project, {
+    type: "diff",
+    content: SEED_DIFF,
+    meta: { title: "Review the accent change" },
+    files: [
+      {
+        path: SEED_DIFF_PATH,
+        oldContents: SEED_DIFF_OLD,
+        newContents: SEED_DIFF_NEW,
+        status: "modified",
+      },
+    ],
+  });
+  await client.sessionCreate(standalone, {
+    type: "reply",
+    content: SEED_REPLY,
+    meta: { title: "A standalone thought" },
+  });
+}
+
+/** `cueloop dev`: seed an isolated dev home once, then open the TUI on it. */
+export async function devCommand(): Promise<number> {
+  process.env.CUELOOP_HOME ??= join(homedir(), ".cueloop-dev");
+
+  const client = await DaemonClient.connect({ autostart: true });
+  try {
+    const existing = await client.sessionList();
+    if (existing.length === 0) await seedDevSessions(client);
+  } finally {
+    client.close();
+  }
+
+  const { runClient } = await import("@cueloop/client");
+
+  return runClient({});
+}