@love-moon/conductor-sdk 0.15.1 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,65 @@
 # @love-moon/conductor-sdk
 
+## 0.16.0
+
+### Minor Changes
+
+- 7c45a56: `conductor issue start` can pick the AI for the task it spawns: `--backend <b>`,
+  or `--global-backend <backend>@<host>` to run the AI on one of your global AI
+  backends while the code stays on the project's daemon (same as the web "Move
+  Issue To Doing" dialog). The SDK's `updateIssue` forwards `globalBackend`.
+
+  Requires a Conductor web server that ships issue global backends (the same
+  release): deploy the web server before publishing the CLI/SDK. An older server
+  ignores `--global-backend` and starts a plain task on the project's daemon; the
+  CLI then prints a warning instead of failing silently.
+
+### Patch Changes
+
+- 0495b79: The CLI can now do what the web app can:
+
+  - `conductor task`: `stop`, `interrupt`, `restart`, `delete`, `archive`/`unarchive`,
+    `rename`, `pin`/`unpin`, `move`, `labels`, `share`/`unshare`, `persistent`,
+    `round start|end`, `cleanup-worktree`, `terminal open|show|close`, `resume`,
+    `attachment download`, `shared <token|link>` (read a shared task), `transcribe <audio>`
+    (speech to text), and `schedule update`. `create` also takes `--daemon-host`, `--agent` (multi-agent group),
+    `--global-backend`, `--worktree`, `--remote-worktree` and `--persistent`.
+    `send --attach` uploads files, `messages --follow` streams new messages, and
+    `list --all-projects` / `--project-ids` lists tasks across projects.
+  - `conductor project`: `update`, `refresh`, `delete`, `reorder`, `agents`,
+    `collab invite|show-invite|join|leave`, `labels list|add|rename|remove`.
+  - `conductor issue`: `delete`, and `list --all-projects` / `--project-ids`.
+  - `conductor daemon`: `restart`, `upgrade [--status|--wait]`, `sessions`, `accounts`,
+    `switch-account`, `commands list|run|status`, `share create|list|revoke|show-invite|accept`.
+  - New `conductor search`, `conductor settings` (global backends, catchphrases, daily
+    report, task-list and card-group preferences, generated reports) and `conductor auth`
+    (`whoami`, `tokens list|create|revoke`).
+
+  Fix: `conductor project hide/unhide` (and the SDK's `setProjectHidden`) no longer erase
+  the project's metadata (task labels, memos, binding data).
+
+  On a cross-daemon merged project, `project hide/unhide`, `delete` and
+  `update --merge-opt-out` act on every daemon, like the web. `hide/unhide --json`
+  still prints the target project, plus `ids` for every project changed.
+  `delete --daemon-host <h>` deletes only that copy; a group delete stops at the
+  first failure and says which ids were deleted. `update --merge-opt-out` lists the
+  same-name projects it also split or re-merged.
+
+- b68fadf: `conductor issue` now matches the web issue board:
+  `start --daemon <host> [--project <id>]` picks the daemon, or the merged-group
+  sibling project, that the task runs on (on another member's shared project the
+  server decides). `--priority` takes `P0|P1|P2`, and `--status` uses
+  `todo|doing|done`; `create` no longer offers `doing`. `list --status` is sent to
+  the server and still applied locally, so an older server that ignores it filters
+  too. An invalid argument now exits 2 without sending a request. The SDK's
+  `updateIssue` forwards `projectId`, and `listIssues` sends multiple statuses to
+  the server and filters the result the same way.
+
+  The matching web server changes (metadata patches merge instead of replacing,
+  `GET /api/issues?status=` filtering) should be deployed before publishing.
+
+## 0.15.2
+
 ## 0.15.1
 
 ## 0.15.0

package/dist/api/issues.d.ts

@@ -31,12 +31,19 @@ export interface CreateIssueInput {
     clientRequestId?: string;
 }
 export interface UpdateIssueInput {
+    /** Re-parent the issue (e.g. onto a merged-group sibling when starting it). */
+    projectId?: string;
     title?: string;
     description?: string;
     priority?: string;
     type?: string;
     status?: string;
     metadata?: Record<string, unknown>;
+    /** RFC 0041: on todo→doing, run the spawned task's AI on this global backend. */
+    globalBackend?: {
+        host: string;
+        backend: string;
+    };
 }
 export interface UpdateIssueStatusOptions {
     evidence?: string;

package/dist/api/issues.js

@@ -21,6 +21,13 @@ const normalizeIssue = (payload) => {
         raw: payload,
     };
 };
+// Legacy statuses the server serves as their canonical value
+// (web/src/lib/issues/config.ts LEGACY_ISSUE_STATUS_ALIASES).
+const LEGACY_ISSUE_STATUS_ALIASES = { backlog: 'todo', review: 'doing' };
+const canonicalIssueStatus = (value) => {
+    const normalized = String(value ?? '').trim().toLowerCase();
+    return LEGACY_ISSUE_STATUS_ALIASES[normalized] ?? normalized;
+};
 const extractIssue = (payload) => {
     // The PATCH /issues/[issueId] route returns `{ issue, activeTask, ... }`.
     // Other routes return the issue itself. Normalize both shapes here so
@@ -58,9 +65,9 @@ export class IssuesApi {
         if (!input.projectId) {
             throw new Error('projectId is required');
         }
-        // The server `/api/issues` route accepts a single `status` query string;
-        // it doesn't (yet) parse comma-separated lists, so we filter on the
-        // client side for the multi-status case to match RFC 0025 §3 wording.
+        // The server filters on a comma-separated `status` (and maps legacy
+        // aliases such as `backlog` → `todo`); servers that predate that ignore
+        // it, so the result is filtered here too.
         const statusFilter = Array.isArray(input.status)
             ? input.status.map((value) => String(value).trim()).filter(Boolean)
             : input.status
@@ -68,12 +75,12 @@ export class IssuesApi {
                 : [];
         const issues = await this.client.listIssues({
             projectId: input.projectId,
-            status: statusFilter.length === 1 ? statusFilter[0] : undefined,
+            status: statusFilter.length > 0 ? statusFilter.join(',') : undefined,
         });
         let normalized = issues.map((entry) => normalizeIssue(entry));
-        if (statusFilter.length > 1) {
-            const statusSet = new Set(statusFilter);
-            normalized = normalized.filter((issue) => statusSet.has(issue.status));
+        if (statusFilter.length > 0) {
+            const wanted = new Set(statusFilter.map(canonicalIssueStatus));
+            normalized = normalized.filter((issue) => wanted.has(canonicalIssueStatus(issue.status)));
         }
         if (typeof input.limit === 'number' && Number.isFinite(input.limit)) {
             normalized = normalized.slice(0, Math.max(0, Math.floor(input.limit)));
@@ -125,6 +132,9 @@ export class IssuesApi {
             throw new Error('issueId is required');
         }
         const params = {};
+        if (patch.projectId !== undefined) {
+            params.projectId = patch.projectId;
+        }
         if (patch.title !== undefined) {
             params.title = patch.title;
         }
@@ -140,6 +150,9 @@ export class IssuesApi {
         if (patch.status !== undefined) {
             params.status = patch.status;
         }
+        if (patch.globalBackend !== undefined) {
+            params.globalBackend = patch.globalBackend;
+        }
         // We always include audit metadata on writes. If the caller passes a
         // `metadata` patch, we merge our audit keys with theirs (caller wins).
         params.metadata = buildAuditMetadata(patch.metadata, this.options);
@@ -157,8 +170,8 @@ export class IssuesApi {
             });
         }
         // Pull the existing metadata so we can merge `qa.evidence` without
-        // clobbering unrelated keys. The PATCH body fully replaces metadata, so
-        // we have to round-trip the current state (matches RFC 0025 §3 wording
+        // clobbering sibling `qa.*` keys. The PATCH route only shallow-merges
+        // metadata, so we have to round-trip the current state (matches RFC 0025 §3 wording
         // for `done --evidence`).
         const existing = await this.getIssue(issueId);
         const existingMetadata = existing.metadata && typeof existing.metadata === 'object'

package/dist/api/projects.d.ts

@@ -43,6 +43,8 @@ export interface CreateProjectInput {
     name?: string;
     workspacePath?: string;
     daemonHost?: string;
+    /** Ask the daemon to mkdir `workspacePath` when it does not exist yet. */
+    createWorkspaceIfMissing?: boolean;
     isDefault?: boolean;
     clientRequestId?: string;
     metadata?: Record<string, unknown>;

package/dist/api/projects.js

@@ -139,6 +139,9 @@ export class ProjectsApi {
             if (input.daemonHost) {
                 params.daemonHost = input.daemonHost;
             }
+            if (input.createWorkspaceIfMissing) {
+                params.createWorkspaceIfMissing = true;
+            }
         }
         params.metadata = metadata;
         const summary = await this.client.createProject(params);
@@ -156,8 +159,12 @@ export class ProjectsApi {
     }
     async setProjectHidden(idOrName, hidden, options = {}) {
         const targetId = looksLikeProjectId(idOrName) ? idOrName.trim() : (await this.resolveById(idOrName)).id;
-        const metadata = buildAuditMetadata(options.metadata, this.options);
-        const payload = await this.client.patchProjectByQuery(targetId, { hidden, metadata });
+        // Send `hidden` only, exactly like the web UI. The project PATCH route
+        // *replaces* `project.metadata` with any `metadata` it receives, so the
+        // audit-only blob this used to send wiped the project's task labels, memos
+        // and binding data on every hide/unhide.
+        void options;
+        const payload = await this.client.patchProjectByQuery(targetId, { hidden });
         return normalizeProject(payload);
     }
     async resolveProject(input = {}) {

package/dist/api/tasks.js

@@ -226,14 +226,15 @@ export class TasksApi {
         if (typeof content !== 'string' || content.length === 0) {
             throw new Error('content is required');
         }
-        const userMetadata = options.clientRequestId
-            ? { clientRequestId: options.clientRequestId, ...(options.metadata ?? {}) }
-            : options.metadata;
-        const metadata = buildAuditMetadata(userMetadata, this.options);
+        const metadata = buildAuditMetadata(options.metadata, this.options);
         const body = {
             content,
             metadata,
         };
+        // The server dedupes on the top-level key and stamps it onto the message metadata.
+        if (options.clientRequestId) {
+            body.clientRequestId = options.clientRequestId;
+        }
         if (options.role) {
             body.role = options.role;
         }

package/dist/backend/client.js

@@ -19,6 +19,12 @@ export class BackendApiError extends Error {
         this.details = details;
     }
 }
+/**
+ * Server payload per summary, so `asObject()` keeps REST-only fields (hidden,
+ * mergeOptOut, gitRemoteUrl, metadata). A WeakMap keeps it off the instance's
+ * own (serialized) properties.
+ */
+const projectSummaryPayloads = new WeakMap();
 export class ProjectSummary {
     id;
     name;
@@ -47,10 +53,13 @@ export class ProjectSummary {
         if (!id) {
             throw new Error('Project payload missing id');
         }
-        return new ProjectSummary(id, payload.name ?? undefined, payload.daemonHost ?? payload.daemon_host ?? null, payload.workspacePath ?? payload.workspace_path ?? null, payload.repoRoot ?? payload.repo_root ?? null, payload.worktreeBranch ?? payload.worktree_branch ?? null, payload.lastCommit ?? payload.last_commit ?? null, payload.fileCount ?? payload.file_count ?? null, payload.isDefault ?? payload.is_default ?? undefined, payload.lastCommitAt ?? payload.last_commit_at ?? null);
+        const summary = new ProjectSummary(id, payload.name ?? undefined, payload.daemonHost ?? payload.daemon_host ?? null, payload.workspacePath ?? payload.workspace_path ?? null, payload.repoRoot ?? payload.repo_root ?? null, payload.worktreeBranch ?? payload.worktree_branch ?? null, payload.lastCommit ?? payload.last_commit ?? null, payload.fileCount ?? payload.file_count ?? null, payload.isDefault ?? payload.is_default ?? undefined, payload.lastCommitAt ?? payload.last_commit_at ?? null);
+        projectSummaryPayloads.set(summary, payload);
+        return summary;
     }
     asObject() {
         return {
+            ...projectSummaryPayloads.get(this),
             id: this.id,
             name: this.name,
             daemonHost: this.daemonHost,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@love-moon/conductor-sdk",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lovemoon-ai/conductor.git"
@@ -33,5 +33,5 @@
     "typescript": "^5.6.3",
     "vitest": "^2.1.4"
   },
-  "gitCommitId": "4dd9818"
+  "gitCommitId": "77239b9"
 }