cueloop 0.1.0-alpha.2 → 0.1.0-alpha.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cueloop",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.20",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {
@@ -10,9 +10,9 @@
     ".": "./src/main.ts"
   },
   "dependencies": {
-    "@cueloop/schema": "0.1.0-alpha.2",
-    "@cueloop/daemon": "0.1.0-alpha.2",
-    "@cueloop/client": "0.1.0-alpha.2"
+    "@cueloop/schema": "0.1.0-alpha.20",
+    "@cueloop/daemon": "0.1.0-alpha.20",
+    "@cueloop/client": "0.1.0-alpha.20"
   },
   "publishConfig": {
     "access": "public"
@@ -28,5 +28,10 @@
     "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"
+  },
+  "description": "Terminal review surface for coding agents: annotate plans and diffs, return a verdict, send structured feedback back"
+}

package/src/args.ts

@@ -9,16 +9,16 @@ 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;
@@ -31,7 +31,7 @@ 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 value = flags[key];
+  return typeof value === "string" ? value : undefined;
 }

package/src/main.ts

@@ -1,16 +1,17 @@
 #!/usr/bin/env bun
 /**
- * cueloop entry points (#18): `cueloop` opens the TUI on the inbox,
+ * cueloop entry points: `cueloop` opens the TUI on the inbox,
  * `cueloop diff` reviews the working tree, `cueloop review <pr>` a PR,
  * `cueloop session *` mirrors the daemon API for agents and scripts,
  * `cueloop serve` shares a session over ssh (read-only observers),
  * `cueloop daemon` runs the daemon in the foreground.
  */
 
-import { parseArgs, flagStr } from "./args";
-import { sessionCommand } from "./session-cmds";
-import { resolveWorkspace, workingTreeDiff } from "./workspace";
+import { parseArgs, stringFlag } from "./args";
+import { sessionCommand } from "./session-commands";
+import { workingTreeDiff } from "./working-tree";
 import { DaemonClient } from "@cueloop/daemon/client";
+import { openReview, resolveWorkspace } from "@cueloop/daemon/review";
 
 const argv = process.argv.slice(2);
 const cmd = argv[0];
@@ -39,21 +40,22 @@ async function main(): Promise<number> {
         return 1;
       }
       const client = await DaemonClient.connect({ autostart: true });
-      const session = await client.sessionCreate(workspace, {
+      const review = await openReview(client, {
         type: "diff",
         content: diff,
-        meta: { title: `working tree @ ${workspace.branch}`, cwd: process.cwd() },
+        workspace,
+        title: `working tree @ ${workspace.branch}`,
       });
       client.close();
-      return runTui(session.id);
+      return runTui(review.id);
     }
     case "serve": {
       const { positional, flags } = parseArgs(argv.slice(1));
-      const port = flagStr(flags, "port");
+      const port = stringFlag(flags, "port");
       const { serveClient } = await import("@cueloop/client");
       const handle = await serveClient({
         port: port !== undefined ? Number(port) : undefined,
-        host: flagStr(flags, "host"),
+        host: stringFlag(flags, "host"),
         sessionId: positional[0],
       });
       console.log(

package/src/pr.ts

@@ -1,5 +1,5 @@
 /**
- * PR review entry (#18): `cueloop review <pr>` fetches the PR diff through the
+ * PR review entry: `cueloop review <pr>` fetches the PR diff through the
  * user's `gh` CLI (auth fully delegated), opens a diff session, and posts the
  * verdict back to the PR as a real review when the session resolves.
  * `cueloop review-post <session-id> <pr>` is the non-interactive post-back
@@ -8,8 +8,8 @@
 
 import type { ReviewSession, VerdictKind } from "@cueloop/schema";
 import { DaemonClient } from "@cueloop/daemon/client";
+import { openReview } from "@cueloop/daemon/review";
 import { parseArgs } from "./args";
-import { resolveWorkspace } from "./workspace";
 
 /** The gh binary is injectable so tests can stub it. */
 function ghBin(): string {
@@ -55,13 +55,14 @@ export async function reviewCommand(argv: string[]): Promise<number> {
     console.error(`PR ${pr} has an empty diff - nothing to review`);
     return 1;
   }
-  const workspace = await resolveWorkspace();
   const client = await DaemonClient.connect({ autostart: true });
-  const session = await client.sessionCreate(workspace, {
+  const review = await openReview(client, {
     type: "diff",
     content: diff.stdout,
-    meta: { title: `PR ${pr}`, pr, cwd: process.cwd() },
+    title: `PR ${pr}`,
+    pr,
   });
+  const session = review.session;
   client.close();
 
   if (flags["no-tui"]) {

package/src/{session-cmds.ts → session-commands.ts}

@@ -1,13 +1,13 @@
 /**
- * `cueloop session *` - mirrors the daemon socket API 1:1 (#14). One surface,
+ * `cueloop session *` - mirrors the daemon socket API 1:1. One surface,
  * three consumers: agent adapters, the dev loop, and integrations. Output is
  * JSON on stdout; exit code 0 unless the daemon returned an error.
  */
 
-import type { ArtifactType, VerdictKind } from "@cueloop/schema";
+import { newAnnotationId, type ArtifactType, type VerdictKind } from "@cueloop/schema";
 import { DaemonClient } from "@cueloop/daemon/client";
-import { parseArgs, flagStr } from "./args";
-import { resolveWorkspace } from "./workspace";
+import { openReview, verdictResponse, type ReviewNote } from "@cueloop/daemon/review";
+import { parseArgs, stringFlag } from "./args";
 
 async function readStdin(): Promise<string> {
   return await new Response(Bun.stdin.stream()).text();
@@ -24,21 +24,22 @@ export async function sessionCommand(argv: string[]): Promise<number> {
   try {
     switch (verb) {
       case "create": {
-        const workspace = await resolveWorkspace(flagStr(flags, "cwd"));
-        const contentFile = flagStr(flags, "content-file");
+        const contentFile = stringFlag(flags, "content-file");
         const content = contentFile ? await Bun.file(contentFile).text() : await readStdin();
-        const session = await client.sessionCreate(workspace, {
-          type: (flagStr(flags, "type") ?? "plan") as ArtifactType,
+        // per-file agent notes for diff sessions: a JSON array of { path, body }
+        const notesFile = stringFlag(flags, "notes-file");
+        const notes = notesFile ? (JSON.parse(await Bun.file(notesFile).text()) as ReviewNote[]) : undefined;
+        const review = await openReview(client, {
+          type: (stringFlag(flags, "type") ?? "plan") as ArtifactType,
           content,
-          meta: {
-            agent: flagStr(flags, "agent"),
-            agentSessionId: flagStr(flags, "agent-session-id"),
-            planPath: flagStr(flags, "plan-path"),
-            title: flagStr(flags, "title"),
-            cwd: flagStr(flags, "cwd") ?? process.cwd(),
-          },
+          cwd: stringFlag(flags, "cwd"),
+          agent: stringFlag(flags, "agent"),
+          agentSessionId: stringFlag(flags, "agent-session-id"),
+          planPath: stringFlag(flags, "plan-path"),
+          title: stringFlag(flags, "title"),
+          notes,
         });
-        out(session);
+        out(review.session);
         return 0;
       }
       case "get": {
@@ -46,38 +47,34 @@ export async function sessionCommand(argv: string[]): Promise<number> {
         return 0;
       }
       case "list": {
-        const status = flagStr(flags, "status") as "pending" | "resolved" | undefined;
+        const status = stringFlag(flags, "status") as "pending" | "resolved" | undefined;
         out(await client.sessionList(status ? { status } : undefined));
         return 0;
       }
       case "wait": {
         const id = required(positional[1], "session id");
-        const timeoutMs = Number(flagStr(flags, "timeout-ms") ?? "60000");
+        const timeoutMs = Number(stringFlag(flags, "timeout-ms") ?? "60000");
         const session = await client.sessionWait(id, timeoutMs);
         if (session === null) {
           out({ status: "pending" });
           return 0;
         }
-        out({
-          status: "resolved",
-          allow: session.verdict!.kind === "approve",
-          verdict: session.verdict!.kind,
-          feedback: session.verdict!.feedback,
-        });
+        const { allow, feedback } = verdictResponse(session);
+        out({ status: "resolved", allow, verdict: session.verdict!.kind, feedback });
         return 0;
       }
       case "annotate": {
         const id = required(positional[1], "session id");
-        const body = flagStr(flags, "body") ?? "";
-        const quote = required(flagStr(flags, "quote"), "--quote");
+        const body = stringFlag(flags, "body") ?? "";
+        const quote = required(stringFlag(flags, "quote"), "--quote");
         out(
           await client.sessionAnnotate(id, {
-            id: flagStr(flags, "annotation-id") ?? `a_${Date.now().toString(36)}`,
-            kind: flagStr(flags, "kind") ?? "comment",
+            id: stringFlag(flags, "annotation-id") ?? newAnnotationId(),
+            kind: stringFlag(flags, "kind") ?? "comment",
             anchor: {
               quote,
-              prefix: flagStr(flags, "prefix") ?? "",
-              suffix: flagStr(flags, "suffix") ?? "",
+              prefix: stringFlag(flags, "prefix") ?? "",
+              suffix: stringFlag(flags, "suffix") ?? "",
             },
             body,
           }),
@@ -86,13 +83,13 @@ export async function sessionCommand(argv: string[]): Promise<number> {
       }
       case "resolve": {
         const id = required(positional[1], "session id");
-        const kind = required(flagStr(flags, "verdict"), "--verdict") as VerdictKind;
-        out(await client.sessionResolve(id, kind, flagStr(flags, "summary") ?? ""));
+        const kind = required(stringFlag(flags, "verdict"), "--verdict") as VerdictKind;
+        out(await client.sessionResolve(id, kind, stringFlag(flags, "summary") ?? ""));
         return 0;
       }
       case "submit-revision": {
         const id = required(positional[1], "session id");
-        const contentFile = flagStr(flags, "content-file");
+        const contentFile = stringFlag(flags, "content-file");
         const content = contentFile ? await Bun.file(contentFile).text() : await readStdin();
         out(await client.sessionSubmitRevision(id, content));
         return 0;
@@ -108,7 +105,7 @@ export async function sessionCommand(argv: string[]): Promise<number> {
   }
 }
 
-function required<T>(v: T | undefined, what: string): T {
-  if (v === undefined) throw new Error(`missing ${what}`);
-  return v;
+function required<T>(value: T | undefined, description: string): T {
+  if (value === undefined) throw new Error(`missing ${description}`);
+  return value;
 }

package/src/{workspace.ts → working-tree.ts}

@@ -1,6 +1,4 @@
-/** Workspace key resolution (#9): repo root + branch from the cwd. */
-
-import type { WorkspaceKey } from "@cueloop/schema";
+/** Working-tree diff capture for `cueloop diff`, untracked files included. */
 
 async function git(args: string[], cwd: string): Promise<string | null> {
   const proc = Bun.spawn(["git", ...args], { cwd, stdout: "pipe", stderr: "ignore" });
@@ -9,15 +7,9 @@ async function git(args: string[], cwd: string): Promise<string | null> {
   return out.trim();
 }
 
-export async function resolveWorkspace(cwd = process.cwd()): Promise<WorkspaceKey> {
-  const repoRoot = (await git(["rev-parse", "--show-toplevel"], cwd)) ?? cwd;
-  const branch = (await git(["rev-parse", "--abbrev-ref", "HEAD"], cwd)) ?? "detached";
-  return { repoRoot, branch };
-}
-
 export async function workingTreeDiff(cwd = process.cwd()): Promise<string> {
   const tracked = (await git(["diff", "HEAD"], cwd)) ?? "";
-  // untracked files included by default (map note: changed-first)
+  // untracked files included by default
   const untrackedList = (await git(["ls-files", "--others", "--exclude-standard"], cwd)) ?? "";
   let untracked = "";
   for (const file of untrackedList.split("\n").filter(Boolean)) {