@love-moon/conductor-cli 0.7.7 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @love-moon/conductor-cli
 
+## 0.8.0
+
+### Minor Changes
+
+- 959dd1d: Add project-configured worker and reviewer task groups, task-group discovery in
+  the SDK and `conductor task group`, and a lightweight daemon protocol for
+  refreshing the project agent registry.
+- fe76139: Add `conductor task create` for creating app tasks with title, prompt, backend,
+  project resolution, and optional parent task-card grouping. App tasks now
+  require an online compatible daemon, and grouping results are exposed to
+  callers so partial success is visible without retrying task creation.
+
+### Patch Changes
+
+- Updated dependencies [959dd1d]
+- Updated dependencies [fe76139]
+  - @love-moon/conductor-sdk@0.8.0
+  - @love-moon/ai-sdk@0.8.0
+
 ## 0.7.7
 
 ### Patch Changes

package/bin/conductor-task.js

@@ -5,7 +5,10 @@
  *
  * Subcommands:
  *   list [--project ...] [--issue <id>] [--status ...]
+ *   create --title <title> [--prompt <prompt>] [--backend <backend>]
+ *          [--parent-task-id <id>] [--project ...]
  *   show <id>
+ *   group [<id>]
  *   send <id> [<message>] [--stdin] [--from-file FILE] [--metadata-json '{...}']
  *   insert <id> [<message>] [--stdin] [--from-file FILE] [--target-reply-to <msg-id>]
  *   messages <id> [--limit N] [--before <msg-id>]
@@ -63,6 +66,7 @@ function taskAsObject(task) {
     sessionId: task.sessionId,
     createdAt: task.createdAt,
     updatedAt: task.updatedAt,
+    grouping: task.grouping ?? undefined,
   };
 }
 
@@ -243,6 +247,54 @@ async function handleList(argv, deps) {
   return EXIT.OK;
 }
 
+async function handleCreate(argv, deps) {
+  const apis = await buildApis(deps);
+  const project = await resolveProject(apis, {
+    env: deps.env,
+    cwd: deps.cwd,
+    project: argv.project,
+  });
+  const title = String(argv.title ?? "").trim();
+  if (!title) {
+    const err = new Error("--title must not be empty");
+    err.code = "ARGS";
+    throw err;
+  }
+
+  const body = {
+    projectId: project.id,
+    title,
+    taskType: "ai_task",
+    ...(argv.prompt !== undefined ? { initialContent: String(argv.prompt) } : {}),
+    ...(argv.backend ? { backendType: String(argv.backend) } : {}),
+    ...(argv.parentTaskId ? { parentTaskId: String(argv.parentTaskId) } : {}),
+    metadata: buildAuditMetadata(deps.env),
+  };
+  if (argv.dryRun) {
+    emitDryRun(
+      deps.stdout,
+      argv.json,
+      makeDryRunPayload("POST", `${buildBaseUrl(apis.config)}/api/tasks`, body),
+    );
+    return EXIT.OK;
+  }
+
+  const created = await apis.tasks.createTask(body);
+  const obj = taskAsObject(created);
+  if (argv.json) {
+    printJson(deps.stdout, obj);
+    return EXIT.OK;
+  }
+  printPretty(deps.stdout, `Created app task ${obj.id}: ${obj.title}`);
+  if (obj.grouping?.grouped === false) {
+    printPretty(
+      deps.stderr,
+      `Warning: ${obj.grouping.warning || `task was not grouped with ${obj.grouping.parentTaskId}`}. The task itself was created successfully.`,
+    );
+  }
+  return EXIT.OK;
+}
+
 async function handleShow(argv, deps) {
   const apis = await buildApis(deps);
   const task = await apis.tasks.getTask(argv.id);
@@ -267,6 +319,45 @@ async function handleShow(argv, deps) {
   return EXIT.OK;
 }
 
+async function handleGroup(argv, deps) {
+  const apis = await buildApis(deps);
+  const taskId =
+    (argv.id && String(argv.id).trim()) ||
+    (deps.env.CONDUCTOR_TASK_ID && String(deps.env.CONDUCTOR_TASK_ID).trim());
+  if (!taskId) {
+    const err = new Error(
+      "No task id: pass <id> or run inside a task (CONDUCTOR_TASK_ID)",
+    );
+    err.statusCode = 400;
+    throw err;
+  }
+  const group = await apis.tasks.getTaskGroup(taskId);
+  if (argv.json) {
+    printJson(deps.stdout, group);
+    return EXIT.OK;
+  }
+  if (!group.groupId) {
+    printPretty(deps.stdout, "(task is not in a group)");
+    return EXIT.OK;
+  }
+  printPretty(deps.stdout, `group ${group.groupId}`);
+  printPretty(
+    deps.stdout,
+    `${pad("ROLE", 10)} ${pad("TASK ID", 24)} ${pad("AGENT", 20)} STATUS`,
+  );
+  for (const member of group.members) {
+    const selfMark = member.isSelf ? "  (you)" : "";
+    printPretty(
+      deps.stdout,
+      `${pad(member.role || "?", 10)} ${pad(member.taskId, 24)} ${pad(
+        member.agent || "-",
+        20,
+      )} ${member.status || ""}${selfMark}`,
+    );
+  }
+  return EXIT.OK;
+}
+
 async function handleSend(argv, deps) {
   const apis = await buildApis(deps);
   const content = readMessageInput({
@@ -485,6 +576,31 @@ export async function main(argvInput = hideBin(process.argv), deps = {}) {
           exitCode = await handleList(argv, { ...handlerDeps, configFile: argv.configFile });
         },
       )
+      .command(
+        "create",
+        "Create a new app task through the frontend task pipeline",
+        (cmd) => cmd
+          .option("title", {
+            type: "string",
+            demandOption: true,
+            describe: "Task title",
+          })
+          .option("prompt", {
+            type: "string",
+            describe: "Initial user prompt",
+          })
+          .option("backend", {
+            type: "string",
+            describe: "AI backend type, for example codex or claude",
+          })
+          .option("parent-task-id", {
+            type: "string",
+            describe: "Display the new task in the same task-card group as this task",
+          }),
+        async (argv) => {
+          exitCode = await handleCreate(argv, { ...handlerDeps, configFile: argv.configFile });
+        },
+      )
       .command(
         "show <id>",
         "Show one task's detail",
@@ -493,6 +609,14 @@ export async function main(argvInput = hideBin(process.argv), deps = {}) {
           exitCode = await handleShow(argv, { ...handlerDeps, configFile: argv.configFile });
         },
       )
+      .command(
+        "group [id]",
+        "Show the multi-agent group a task belongs to (defaults to $CONDUCTOR_TASK_ID)",
+        (cmd) => cmd.positional("id", { type: "string" }),
+        async (argv) => {
+          exitCode = await handleGroup(argv, { ...handlerDeps, configFile: argv.configFile });
+        },
+      )
       .command(
         "send <id> [message]",
         "Send a user message into a running task",

package/bin/conductor.js

@@ -14,7 +14,7 @@
  *   serve-ai - Start an OpenAI-compatible local AI server
  *   project  - Manage Conductor projects (list/show/create/...)
  *   issue    - Manage issues (list/show/create/update/start/done)
- *   task     - Manage tasks (list/show/send/messages/schedule)
+ *   task     - Manage tasks (create/list/show/send/messages/schedule)
  */
 
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -134,7 +134,7 @@ Subcommands:
   serve-ai  Start an OpenAI-compatible local AI server
   project   Manage Conductor projects (list/show/create/...)
   issue     Manage issues (list/show/create/update/start/done)
-  task      Manage tasks (list/show/send/messages/schedule)
+  task      Manage tasks (create/list/show/send/messages/schedule)
 
 Options:
   -h, --help     Show this help message
@@ -156,6 +156,7 @@ Examples:
   conductor update
   conductor project list
   conductor issue create --title "Refactor module" --priority P2
+  conductor task create --title "Refactor module" --prompt "Extract the parser" --backend codex
   conductor task send <task-id> "please add a unit test"
   conductor task schedule create <task-id> "follow up" --delay 10m
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@love-moon/conductor-cli",
-  "version": "0.7.7",
-  "gitCommitId": "26b2dbb",
+  "version": "0.8.0",
+  "gitCommitId": "04d4f62",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lovemoon-ai/conductor.git"
@@ -24,8 +24,8 @@
     "test": "node --test test/*.test.js"
   },
   "dependencies": {
-    "@love-moon/ai-sdk": "0.7.7",
-    "@love-moon/conductor-sdk": "0.7.7",
+    "@love-moon/ai-sdk": "0.8.0",
+    "@love-moon/conductor-sdk": "0.8.0",
     "@github/copilot-sdk": "^0.3.0",
     "chrome-launcher": "^1.2.1",
     "chrome-remote-interface": "^0.33.0",
@@ -38,7 +38,7 @@
   },
   "optionalDependencies": {
     "@roamhq/wrtc": "^0.10.0",
-    "@love-moon/chat-web": "0.7.7"
+    "@love-moon/chat-web": "0.8.0"
   },
   "pnpm": {
     "onlyBuiltDependencies": [

package/src/daemon.js

@@ -1843,6 +1843,14 @@ export function startDaemon(config = {}, deps = {}) {
     "# (svg/png/jpg/gif/webp/ico/avif) relative to this .conductor/ directory.",
     "# Remove this line to use the default folder icon.",
     "",
+    "# Optional agent registry used by the task-composer worker/reviewer picker.",
+    "# Agent docs are workspace-relative paths; backend is optional.",
+    "# agents:",
+    "#   feature-dev:",
+    "#     doc: claw/agents/feature-dev.md",
+    "#     description: Implements features end to end.",
+    "#     backend: codex",
+    "",
     "worktree:",
     "  sync_branch: false",
     "  sync_submodules: true",
@@ -1856,6 +1864,13 @@ export function startDaemon(config = {}, deps = {}) {
   ].join("\n");
 
   const MAX_PROJECT_ICON_IMAGE_BYTES = 128 * 1024;
+  const MAX_PROJECT_AGENT_ENTRIES = 64;
+  const MAX_PROJECT_AGENT_NAME_LENGTH = 64;
+  const MAX_PROJECT_AGENT_DOC_LENGTH = 512;
+  const MAX_PROJECT_AGENT_DESCRIPTION_LENGTH = 512;
+  const MAX_PROJECT_AGENT_BACKEND_LENGTH = 64;
+  const PROJECT_AGENT_NAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+  const PROJECT_AGENT_BACKEND_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
   const PROJECT_ICON_MIME_BY_EXTENSION = {
     ".svg": "image/svg+xml",
     ".png": "image/png",
@@ -1954,6 +1969,118 @@ export function startDaemon(config = {}, deps = {}) {
     return null;
   }
 
+  function normalizeProjectAgentSetting(name, value) {
+    const normalizedName = normalizeOptionalString(name);
+    if (
+      !normalizedName ||
+      normalizedName.length > MAX_PROJECT_AGENT_NAME_LENGTH ||
+      !PROJECT_AGENT_NAME_RE.test(normalizedName)
+    ) {
+      return null;
+    }
+
+    let docValue = null;
+    let descriptionValue = null;
+    let backendValue = null;
+    if (typeof value === "string") {
+      docValue = value;
+    } else if (value && typeof value === "object" && !Array.isArray(value)) {
+      docValue = value.doc ?? value.path;
+      descriptionValue = value.description;
+      backendValue = value.backend;
+    } else {
+      return null;
+    }
+
+    const doc = normalizeOptionalString(docValue);
+    if (
+      !doc ||
+      doc.length > MAX_PROJECT_AGENT_DOC_LENGTH ||
+      path.isAbsolute(doc) ||
+      /^[A-Za-z]:[\\/]/.test(doc) ||
+      /^[/\\]{2}/.test(doc)
+    ) {
+      return null;
+    }
+    const normalizedDoc = path.posix.normalize(doc.split("\\").join("/"));
+    if (normalizedDoc === ".." || normalizedDoc.startsWith("../")) {
+      return null;
+    }
+
+    const description = normalizeOptionalString(descriptionValue);
+    const backend = normalizeOptionalString(backendValue)?.toLowerCase() || null;
+    return {
+      name: normalizedName,
+      doc,
+      description:
+        description && description.length <= MAX_PROJECT_AGENT_DESCRIPTION_LENGTH
+          ? description
+          : null,
+      backend:
+        backend &&
+        backend.length <= MAX_PROJECT_AGENT_BACKEND_LENGTH &&
+        PROJECT_AGENT_BACKEND_RE.test(backend)
+          ? backend
+          : null,
+    };
+  }
+
+  function normalizeProjectAgentsSetting(agentsNode) {
+    if (!agentsNode || typeof agentsNode !== "object") {
+      return [];
+    }
+    const result = [];
+    const seen = new Set();
+    const push = (entry) => {
+      if (
+        entry &&
+        result.length < MAX_PROJECT_AGENT_ENTRIES &&
+        !seen.has(entry.name)
+      ) {
+        seen.add(entry.name);
+        result.push(entry);
+      }
+    };
+
+    if (Array.isArray(agentsNode)) {
+      for (const item of agentsNode) {
+        if (!item || typeof item !== "object" || Array.isArray(item)) {
+          continue;
+        }
+        const keys = Object.keys(item);
+        if (keys.length === 1) {
+          push(normalizeProjectAgentSetting(keys[0], item[keys[0]]));
+        } else if (Object.prototype.hasOwnProperty.call(item, "name")) {
+          push(normalizeProjectAgentSetting(item.name, item));
+        }
+      }
+      return result;
+    }
+
+    for (const [name, value] of Object.entries(agentsNode)) {
+      push(normalizeProjectAgentSetting(name, value));
+    }
+    return result;
+  }
+
+  function readProjectAgentsSetting(projectWorkspacePath) {
+    for (const settingsPath of getProjectSettingsCandidates(projectWorkspacePath)) {
+      if (!existsSyncFn(settingsPath)) {
+        continue;
+      }
+      try {
+        const parsed = yaml.load(readFileSyncFn(settingsPath, "utf8"));
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+          return [];
+        }
+        return normalizeProjectAgentsSetting(parsed.agents);
+      } catch {
+        return [];
+      }
+    }
+    return [];
+  }
+
   function readProjectWorktreeSettings(projectWorkspacePath) {
     for (const settingsPath of getProjectSettingsCandidates(projectWorkspacePath)) {
       if (!existsSyncFn(settingsPath)) {
@@ -2804,6 +2931,7 @@ export function startDaemon(config = {}, deps = {}) {
   };
   const advertisedCapabilities = [
     "project_path_validation",
+    "project_agents_registry",
     "restart_daemon",
     "refresh_session_inplace",
     CUSTOM_COMMANDS_CAPABILITY,
@@ -5027,6 +5155,11 @@ export function startDaemon(config = {}, deps = {}) {
     }
     if (event.type === "validate_project_path") {
       void handleValidateProjectPath(event.payload);
+      return;
+    }
+    if (event.type === "get_project_agents") {
+      void handleGetProjectAgents(event.payload);
+      return;
     }
     if (event.type === "ai_manager_request") {
       handleAiManagerRequest(client, aiManagerHandlers, event.payload).catch((error) => {
@@ -5132,6 +5265,7 @@ export function startDaemon(config = {}, deps = {}) {
       lastCommitAt: null,
       fileCount: null,
       icon: null,
+      agents: [],
       error: null,
       errorCode: null,
       validatedAt,
@@ -5186,6 +5320,7 @@ export function startDaemon(config = {}, deps = {}) {
               ? snapshot.fileCount
               : null,
           icon: readProjectIconSetting(effectiveWorkspace),
+          agents: readProjectAgentsSetting(effectiveWorkspace),
         };
       }
     } catch (error) {
@@ -5210,6 +5345,7 @@ export function startDaemon(config = {}, deps = {}) {
           git_remote_url: result.gitRemoteUrl,
           file_count: result.fileCount,
           icon: result.icon,
+          agents: result.agents,
           error: result.error,
           error_code: result.errorCode,
           validated_at: result.validatedAt,
@@ -5220,6 +5356,69 @@ export function startDaemon(config = {}, deps = {}) {
     }
   }
 
+  async function handleGetProjectAgents(payload) {
+    const requestId = payload?.request_id ? String(payload.request_id).trim() : "";
+    const rawWorkspacePath = payload?.workspace_path ? String(payload.workspace_path).trim() : "";
+    const resolvedAt = new Date().toISOString();
+
+    if (!requestId || !rawWorkspacePath) {
+      logError(`Invalid get_project_agents payload: ${JSON.stringify(payload)}`);
+      return;
+    }
+
+    let result = {
+      workspacePath: null,
+      agents: [],
+      error: null,
+      errorCode: null,
+    };
+    try {
+      const resolvedPath = path.resolve(rawWorkspacePath);
+      if (!existsSyncFn(resolvedPath)) {
+        result = {
+          ...result,
+          error: `Workspace path does not exist on daemon ${AGENT_NAME}: ${rawWorkspacePath}`,
+          errorCode: "workspace_not_found",
+        };
+      } else if (!statSyncFn(resolvedPath).isDirectory()) {
+        result = {
+          ...result,
+          error: `Workspace path is not a directory on daemon ${AGENT_NAME}: ${rawWorkspacePath}`,
+          errorCode: "workspace_not_directory",
+        };
+      } else {
+        result = {
+          ...result,
+          workspacePath: resolvedPath,
+          agents: readProjectAgentsSetting(resolvedPath),
+        };
+      }
+    } catch (error) {
+      result = {
+        ...result,
+        error: `Failed to read project agents on daemon ${AGENT_NAME}: ${error?.message || error}`,
+        errorCode: "project_agents_read_failed",
+      };
+    }
+
+    try {
+      await client.sendJson({
+        type: "project_agents_resolved",
+        payload: {
+          request_id: requestId,
+          daemon_host: AGENT_NAME,
+          workspace_path: result.workspacePath,
+          agents: result.agents,
+          error: result.error,
+          error_code: result.errorCode,
+          resolved_at: resolvedAt,
+        },
+      });
+    } catch (error) {
+      logError(`Failed to report project_agents_resolved for ${rawWorkspacePath}: ${error?.message || error}`);
+    }
+  }
+
   function stopActiveTaskProcess(
     taskId,
     {

package/src/entity-helpers.js

@@ -192,8 +192,14 @@ export async function resolveProject(apis, options = {}) {
   if (!apis.projects || typeof apis.projects.resolveProject !== "function") {
     throw new Error("ProjectsApi.resolveProject is not available in conductor-sdk");
   }
+  const explicitProject = String(options.project ?? "").trim();
+  if (explicitProject) {
+    if (typeof apis.projects.getProject !== "function") {
+      throw new Error("ProjectsApi.getProject is not available in conductor-sdk");
+    }
+    return apis.projects.getProject(explicitProject);
+  }
   return apis.projects.resolveProject({
-    project: options.project,
     env: options.env || process.env,
     cwd: options.cwd || process.cwd(),
   });
@@ -332,11 +338,30 @@ export function emitDryRun(stream, json, payload) {
   }
 }
 
+/**
+ * Pull a human-readable reason out of a backend error payload. Backend routes
+ * respond with `{ error }` (occasionally `{ message }`), which the SDK attaches
+ * to BackendApiError.details. Surfacing it turns an opaque "Backend responded
+ * with 409" into the actual cause (e.g. "Project daemon X is offline").
+ */
+function backendErrorDetail(error) {
+  const details = error && typeof error === "object" ? error.details : null;
+  if (!details) return null;
+  if (typeof details === "string") return details.trim() || null;
+  if (typeof details === "object") {
+    const reason = details.error ?? details.message;
+    if (typeof reason === "string" && reason.trim()) return reason.trim();
+  }
+  return null;
+}
+
 /**
  * Translate an unknown error into a printable + exit-coded form.
  */
 export function reportError(consoleErr, error) {
   const message = error instanceof Error ? error.message : String(error);
-  consoleErr.error(`Error: ${message}`);
+  const detail = backendErrorDetail(error);
+  const line = detail && detail !== message ? `${message}: ${detail}` : message;
+  consoleErr.error(`Error: ${line}`);
   return exitCodeForError(error);
 }