@sinoia/hubdoc-tools 1.8.2 → 1.9.0

package/cli.js

@@ -95034,7 +95034,7 @@ var require_bignumber = __commonJS({
   "node_modules/bignumber.js/bignumber.js"(exports2, module2) {
     (function(globalObject) {
       "use strict";
-      var BigNumber, isNumeric = /^-?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i, mathceil = Math.ceil, mathfloor = Math.floor, bignumberError = "[BigNumber Error] ", tooManyDigits = bignumberError + "Number primitive has more than 15 significant digits: ", BASE3 = 1e14, LOG_BASE = 14, MAX_SAFE_INTEGER = 9007199254740991, POWS_TEN = [1, 10, 100, 1e3, 1e4, 1e5, 1e6, 1e7, 1e8, 1e9, 1e10, 1e11, 1e12, 1e13], SQRT_BASE = 1e7, MAX = 1e9;
+      var BigNumber, isNumeric = /^-?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i, mathceil = Math.ceil, mathfloor = Math.floor, bignumberError = "[BigNumber Error] ", tooManyDigits = bignumberError + "Number primitive has more than 15 significant digits: ", BASE4 = 1e14, LOG_BASE = 14, MAX_SAFE_INTEGER = 9007199254740991, POWS_TEN = [1, 10, 100, 1e3, 1e4, 1e5, 1e6, 1e7, 1e8, 1e9, 1e10, 1e11, 1e12, 1e13], SQRT_BASE = 1e7, MAX = 1e9;
       function clone(configObject) {
         var div, convertBase, parseNumeric, P = BigNumber2.prototype = { constructor: BigNumber2, toString: null, valueOf: null }, ONE = new BigNumber2(1), DECIMAL_PLACES = 20, ROUNDING_MODE = 4, TO_EXP_NEG = -7, TO_EXP_POS = 21, MIN_EXP = -1e7, MAX_EXP = 1e7, CRYPTO = false, MODULO_MODE = 1, POW_PRECISION = 0, FORMAT = {
           prefix: "",
@@ -95286,7 +95286,7 @@ var require_bignumber = __commonJS({
               if (String(c3[0]).length == i3) {
                 for (i3 = 0; i3 < c3.length; i3++) {
                   n3 = c3[i3];
-                  if (n3 < 0 || n3 >= BASE3 || n3 !== mathfloor(n3)) break out;
+                  if (n3 < 0 || n3 >= BASE4 || n3 !== mathfloor(n3)) break out;
                 }
                 if (n3 !== 0) return true;
               }
@@ -95503,7 +95503,7 @@ var require_bignumber = __commonJS({
             e3 = x3.e - y2.e;
             s3 = dp + e3 + 1;
             if (!base) {
-              base = BASE3;
+              base = BASE4;
               e3 = bitFloor(x3.e / LOG_BASE) - bitFloor(y2.e / LOG_BASE);
               s3 = s3 / LOG_BASE | 0;
             }
@@ -95582,7 +95582,7 @@ var require_bignumber = __commonJS({
               more = rem[0] != null;
               if (!qc[0]) qc.splice(0, 1);
             }
-            if (base == BASE3) {
+            if (base == BASE4) {
               for (i3 = 1, s3 = qc[0]; s3 >= 10; s3 /= 10, i3++) ;
               round(q3, dp + (q3.e = i3 + e3 * LOG_BASE - 1) + 1, rm, more);
             } else {
@@ -95636,7 +95636,7 @@ var require_bignumber = __commonJS({
           }
           return x3;
         }
-        function normalise(n3, c3, e3) {
+        function normalise2(n3, c3, e3) {
           var i3 = 1, j3 = c3.length;
           for (; !c3[--j3]; c3.pop()) ;
           for (j3 = c3[0]; j3 >= 10; j3 /= 10, i3++) ;
@@ -95741,12 +95741,12 @@ var require_bignumber = __commonJS({
                     for (k3 = 1; j3 >= 10; j3 /= 10, k3++) ;
                     if (i3 != k3) {
                       x3.e++;
-                      if (xc[0] == BASE3) xc[0] = 1;
+                      if (xc[0] == BASE4) xc[0] = 1;
                     }
                     break;
                   } else {
                     xc[ni] += k3;
-                    if (xc[ni] != BASE3) break;
+                    if (xc[ni] != BASE4) break;
                     xc[ni--] = 0;
                     k3 = 1;
                   }
@@ -95955,12 +95955,12 @@ var require_bignumber = __commonJS({
           }
           b3 = (j3 = yc.length) - (i3 = xc.length);
           if (b3 > 0) for (; b3--; xc[i3++] = 0) ;
-          b3 = BASE3 - 1;
+          b3 = BASE4 - 1;
           for (; j3 > a3; ) {
             if (xc[--j3] < yc[j3]) {
               for (i3 = j3; i3 && !xc[--i3]; xc[i3] = b3) ;
               --xc[i3];
-              xc[j3] += BASE3;
+              xc[j3] += BASE4;
             }
             xc[j3] -= yc[j3];
           }
@@ -95970,7 +95970,7 @@ var require_bignumber = __commonJS({
             y2.c = [y2.e = 0];
             return y2;
           }
-          return normalise(y2, xc, ye);
+          return normalise2(y2, xc, ye);
         };
         P.modulo = P.mod = function(y2, b3) {
           var q3, s3, x3 = this;
@@ -96022,7 +96022,7 @@ var require_bignumber = __commonJS({
             ycL = i3;
           }
           for (i3 = xcL + ycL, zc = []; i3--; zc.push(0)) ;
-          base = BASE3;
+          base = BASE4;
           sqrtBase = SQRT_BASE;
           for (i3 = ycL; --i3 >= 0; ) {
             c3 = 0;
@@ -96043,7 +96043,7 @@ var require_bignumber = __commonJS({
           } else {
             zc.splice(0, 1);
           }
-          return normalise(y2, zc, e3);
+          return normalise2(y2, zc, e3);
         };
         P.negated = function() {
           var x3 = new BigNumber2(this);
@@ -96088,14 +96088,14 @@ var require_bignumber = __commonJS({
             b3 = a3;
           }
           for (a3 = 0; b3; ) {
-            a3 = (xc[--b3] = xc[b3] + yc[b3] + a3) / BASE3 | 0;
-            xc[b3] = BASE3 === xc[b3] ? 0 : xc[b3] % BASE3;
+            a3 = (xc[--b3] = xc[b3] + yc[b3] + a3) / BASE4 | 0;
+            xc[b3] = BASE4 === xc[b3] ? 0 : xc[b3] % BASE4;
           }
           if (a3) {
             xc = [a3].concat(xc);
             ++ye;
           }
-          return normalise(y2, xc, ye);
+          return normalise2(y2, xc, ye);
         };
         P.precision = P.sd = function(sd, rm) {
           var c3, n3, v6, x3 = this;
@@ -622232,10 +622232,10 @@ var require_tasks = __commonJS({
     exports2.VERSIONS = {
       v1: v1_1.tasks_v1.Tasks
     };
-    function tasks(versionOrOptions) {
+    function tasks2(versionOrOptions) {
       return (0, googleapis_common_1.getAPI)("tasks", versionOrOptions, exports2.VERSIONS, this);
     }
-    exports2.tasks = tasks;
+    exports2.tasks = tasks2;
     var auth = new googleapis_common_1.AuthPlus();
     exports2.auth = auth;
     var googleapis_common_2 = require_src7();
@@ -682521,19 +682521,19 @@ var HubDocExportService = class {
     const mappings = [];
     for (const doc of documents) {
       const detailedDoc = await this.getDocumentDetails(doc.id);
-      const projects = [];
+      const projects2 = [];
       if (detailedDoc.project && detailedDoc.folder_path) {
-        projects.push({
+        projects2.push({
           projectName: detailedDoc.project.name,
           folderPath: detailedDoc.folder_path,
           fullPath: `${detailedDoc.project.name}/${detailedDoc.folder_path}`
         });
       }
-      const defaultTargetPath = projects.length > 0 ? projects[0].fullPath.replace(/[/\\]/g, import_path5.default.sep) : "Exported Documents";
+      const defaultTargetPath = projects2.length > 0 ? projects2[0].fullPath.replace(/[/\\]/g, import_path5.default.sep) : "Exported Documents";
       const mapping = {
         documentId: doc.id,
         documentName: doc.name,
-        projects,
+        projects: projects2,
         downloadUrl: doc.download_url,
         metadata: doc.metadata,
         targetPath: defaultTargetPath
@@ -688590,22 +688590,22 @@ var GlobUtil = class {
       return;
     }
     processor.processPatterns(target, patterns);
-    let tasks = 1;
+    let tasks2 = 1;
     const next = () => {
-      if (--tasks === 0)
+      if (--tasks2 === 0)
         cb();
     };
     for (const [m3, absolute, ifDir] of processor.matches.entries()) {
       if (this.#ignored(m3))
         continue;
-      tasks++;
+      tasks2++;
       this.match(m3, absolute, ifDir).then(() => next());
     }
     for (const t3 of processor.subwalkTargets()) {
       if (this.maxDepth !== Infinity && t3.depth() >= this.maxDepth) {
         continue;
       }
-      tasks++;
+      tasks2++;
       const childrenCached = t3.readdirCached();
       if (t3.calledReaddir())
         this.walkCB3(t3, childrenCached, processor, next);
@@ -688617,19 +688617,19 @@ var GlobUtil = class {
   }
   walkCB3(target, entries, processor, cb) {
     processor = processor.filterEntries(target, entries);
-    let tasks = 1;
+    let tasks2 = 1;
     const next = () => {
-      if (--tasks === 0)
+      if (--tasks2 === 0)
         cb();
     };
     for (const [m3, absolute, ifDir] of processor.matches.entries()) {
       if (this.#ignored(m3))
         continue;
-      tasks++;
+      tasks2++;
       this.match(m3, absolute, ifDir).then(() => next());
     }
     for (const [target2, patterns] of processor.subwalks.entries()) {
-      tasks++;
+      tasks2++;
       this.walkCB2(target2, patterns, processor.child(), next);
     }
     next();
@@ -688649,9 +688649,9 @@ var GlobUtil = class {
       return;
     }
     processor.processPatterns(target, patterns);
-    let tasks = 1;
+    let tasks2 = 1;
     const next = () => {
-      if (--tasks === 0)
+      if (--tasks2 === 0)
         cb();
     };
     for (const [m3, absolute, ifDir] of processor.matches.entries()) {
@@ -688663,7 +688663,7 @@ var GlobUtil = class {
       if (this.maxDepth !== Infinity && t3.depth() >= this.maxDepth) {
         continue;
       }
-      tasks++;
+      tasks2++;
       const children2 = t3.readdirSync();
       this.walkCB3Sync(t3, children2, processor, next);
     }
@@ -688671,9 +688671,9 @@ var GlobUtil = class {
   }
   walkCB3Sync(target, entries, processor, cb) {
     processor = processor.filterEntries(target, entries);
-    let tasks = 1;
+    let tasks2 = 1;
     const next = () => {
-      if (--tasks === 0)
+      if (--tasks2 === 0)
         cb();
     };
     for (const [m3, absolute, ifDir] of processor.matches.entries()) {
@@ -688682,7 +688682,7 @@ var GlobUtil = class {
       this.matchSync(m3, absolute, ifDir);
     }
     for (const [target2, patterns] of processor.subwalks.entries()) {
-      tasks++;
+      tasks2++;
       this.walkCB2Sync(target2, patterns, processor.child(), next);
     }
     next();
@@ -689884,25 +689884,25 @@ var ExportCsvManager = class {
       }).on("end", () => resolve(results)).on("error", reject);
     });
   }
-  serializeProjects(projects) {
-    return projects.map((p3) => `${p3.projectName}:${p3.folderPath}`).join("|");
+  serializeProjects(projects2) {
+    return projects2.map((p3) => `${p3.projectName}:${p3.folderPath}`).join("|");
   }
   parseProjects(projectsStr) {
     if (!projectsStr || projectsStr.trim() === "") return [];
     try {
-      const projects = [];
+      const projects2 = [];
       const projectEntries = projectsStr.split("|");
       for (const entry of projectEntries) {
         const [projectName, folderPath] = entry.split(":");
         if (projectName && folderPath) {
-          projects.push({
+          projects2.push({
             projectName: projectName.trim(),
             folderPath: folderPath.trim(),
             fullPath: `${projectName.trim()}/${folderPath.trim()}`
           });
         }
       }
-      return projects;
+      return projects2;
     } catch {
       console.warn(import_chalk14.default.yellow(`Warning: Invalid projects format: ${projectsStr}`));
       return [];
@@ -732813,6 +732813,34 @@ var HubdocFs = class {
   async uploadUpdate(node) {
     await this.uploadNode(node, "update");
   }
+  /**
+   * If `node` has unpushed writes, upload them now and clear the dirty flag.
+   * Called from `flush` / `fsync` / `release` so that `close(fd)` (or an
+   * explicit `fsync(fd)`) in userspace blocks until the server has the new
+   * bytes — makes read-after-write via the API (from another process, or
+   * from the same one after close()) immediately consistent.
+   *
+   * The FUSE contract:
+   *   - `flush` fires on every `close(2)` in userspace (once per close, even
+   *     for dup'd fds).
+   *   - `release` fires only after the last reference to the file is dropped
+   *     by the kernel — potentially long after `close(2)` returned.
+   * So `flush` (not `release`) is where the upload has to happen for the
+   * close→read-back sequence to be reliable.
+   */
+  async flushDirty(node) {
+    if (!node.dirty) return;
+    if (this.opts.readOnly) return;
+    if (node.localOnly) {
+      node.dirty = false;
+      node.mtime = /* @__PURE__ */ new Date();
+      return;
+    }
+    if (node.isNew || !node.id) await this.uploadNew(node);
+    else await this.uploadUpdate(node);
+    node.dirty = false;
+    node.mtime = /* @__PURE__ */ new Date();
+  }
   invalidateParent(p3) {
     const parent = this.nodes.get(parentPath(p3));
     if (parent) parent.loadedAt = 0;
@@ -732956,19 +732984,21 @@ var HubdocFs = class {
           await import_fs_extra32.default.close(h3.localFd);
         } catch {
         }
-        if (h3.node.dirty && !ro && !h3.node.localOnly) {
-          if (h3.node.isNew || !h3.node.id) await this.uploadNew(h3.node);
-          else await this.uploadUpdate(h3.node);
-          h3.node.dirty = false;
-          h3.node.mtime = /* @__PURE__ */ new Date();
-        } else if (h3.node.dirty && h3.node.localOnly) {
-          h3.node.dirty = false;
-          h3.node.mtime = /* @__PURE__ */ new Date();
-        }
+        await this.flushDirty(h3.node);
+        cb(0);
+      }),
+      flush: wrap(async (_p, fd, cb) => {
+        const h3 = this.handles.get(fd);
+        if (!h3) return cb(0);
+        await this.flushDirty(h3.node);
+        cb(0);
+      }),
+      fsync: wrap(async (_p, fd, _datasync, cb) => {
+        const h3 = this.handles.get(fd);
+        if (!h3) return cb(0);
+        await this.flushDirty(h3.node);
         cb(0);
       }),
-      flush: (_p, _fd, cb) => cb(0),
-      fsync: (_p, _fd, _datasync, cb) => cb(0),
       unlink: wrap(async (p3, cb) => {
         if (ro) return cb(Fuse.EACCES);
         const node = await this.resolve(p3);
@@ -733923,10 +733953,769 @@ async function handlePermissionsShow(id, opts) {
   }
 }
 
+// apps/cli/cli/handlers/_pagination.ts
+function extractPagination(headers, itemsLength = 0) {
+  const h3 = normalise(headers);
+  const parseInt10 = (v6, fallback) => {
+    if (typeof v6 === "number") return Number.isFinite(v6) ? v6 : fallback;
+    if (typeof v6 === "string" && v6.trim() !== "") {
+      const n3 = Number(v6);
+      if (Number.isFinite(n3)) return n3;
+    }
+    return fallback;
+  };
+  const page = parseInt10(h3["x-page"], 1);
+  const per_page = parseInt10(h3["x-per-page"], itemsLength);
+  const count = parseInt10(h3["x-total-count"], itemsLength);
+  const pages = parseInt10(h3["x-total-pages"], 1);
+  const rawHasMore = h3["x-has-more"];
+  const has_more = typeof rawHasMore === "string" ? rawHasMore.toLowerCase() === "true" : Boolean(rawHasMore);
+  return { page, per_page, pages, count, has_more };
+}
+function normalise(headers) {
+  if (!headers) return {};
+  const out = {};
+  for (const key of Object.keys(headers)) {
+    out[key.toLowerCase()] = headers[key];
+  }
+  return out;
+}
+
+// apps/cli/cli/handlers/project-handlers.ts
+var BASE3 = "/api/v1/projects";
+var LIST_COLUMNS2 = [
+  { header: "ID", key: "id" },
+  { header: "Name", key: "name", maxWidth: 40 },
+  { header: "Type", key: "project_type" },
+  { header: "Status", key: "status" },
+  { header: "Workspace", key: "workspace_id" },
+  { header: "Progress", key: "completion_percentage", format: (v6) => v6 == null ? "" : `${v6}%` },
+  { header: "Updated", key: "updated_at" }
+];
+function parseJsonOpt5(name, raw, out) {
+  if (raw == null) return void 0;
+  try {
+    return JSON.parse(raw);
+  } catch (err) {
+    out.fail(new Error(`Invalid JSON for --${name}: ${err.message}`));
+  }
+}
+async function handleProjectsList(opts) {
+  const out = output(opts);
+  const ctx = await buildApiContext(out);
+  const params = {};
+  if (opts.workspace !== void 0) {
+    params.workspace_id = opts.workspace === "null" ? "null" : opts.workspace;
+  }
+  if (opts.type) params.project_type = opts.type;
+  if (opts.status) params.status = opts.status;
+  if (opts.page) params.page = Number(opts.page);
+  if (opts.perPage) params.per_page = Number(opts.perPage);
+  try {
+    const res = await ctx.axios.get(BASE3, { params });
+    const items = Array.isArray(res.data) ? res.data : [];
+    const pagination = extractPagination(res.headers, items.length);
+    if (opts.json) {
+      out.show({ items, pagination });
+      return;
+    }
+    out.list(items, LIST_COLUMNS2);
+    if (pagination.pages > 1) {
+      out.note(`page ${pagination.page}/${pagination.pages} (${pagination.count} total)`);
+    }
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleProjectsShow(id, opts) {
+  const out = output(opts);
+  const ctx = await buildApiContext(out);
+  try {
+    const res = await ctx.axios.get(`${BASE3}/${encodeURIComponent(id)}`);
+    out.show(res.data?.project ?? res.data, { title: `Project ${id}` });
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleProjectsCreate(opts) {
+  const out = output(opts);
+  const ctx = await buildApiContext(out);
+  if (!opts.name) out.fail(new Error("--name is required"));
+  const body2 = { name: opts.name };
+  if (opts.description !== void 0) body2.description = opts.description;
+  if (opts.workspace !== void 0) {
+    body2.workspace_id = opts.workspace === "null" ? null : opts.workspace;
+  }
+  if (opts.typeId) body2.project_type_id = opts.typeId;
+  if (opts.folder) body2.documents_folder_id = opts.folder;
+  const settings = parseJsonOpt5("settings", opts.settings, out);
+  if (settings !== void 0) body2.settings = settings;
+  const metadata2 = parseJsonOpt5("metadata", opts.metadata, out);
+  if (metadata2 !== void 0) body2.metadata_user = metadata2;
+  try {
+    const res = await ctx.axios.post(BASE3, body2);
+    const project = res.data?.project ?? res.data;
+    out.ok(`Project created (id=${project?.id ?? "unknown"})`, project);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleProjectsUpdate(id, opts) {
+  const out = output(opts);
+  const ctx = await buildApiContext(out);
+  const body2 = {};
+  if (opts.name !== void 0) body2.name = opts.name;
+  if (opts.description !== void 0) body2.description = opts.description;
+  if (opts.status !== void 0) body2.status = opts.status;
+  const settings = parseJsonOpt5("settings", opts.settings, out);
+  if (settings !== void 0) body2.settings = settings;
+  const metadata2 = parseJsonOpt5("metadata", opts.metadata, out);
+  if (metadata2 !== void 0) body2.metadata_user = metadata2;
+  if (Object.keys(body2).length === 0) out.fail(new Error("No fields to update"));
+  try {
+    const res = await ctx.axios.patch(`${BASE3}/${encodeURIComponent(id)}`, body2);
+    out.ok(`Project ${id} updated`, res.data?.project ?? res.data);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleProjectsDelete(id, opts) {
+  const out = output(opts);
+  const ctx = await buildApiContext(out);
+  if (!opts.yes && !opts.json) {
+    const { confirm } = await lib_default.prompt([
+      {
+        type: "confirm",
+        name: "confirm",
+        message: `Delete project ${id}? This also drops its sprints and tickets.`,
+        default: false
+      }
+    ]);
+    if (!confirm) {
+      out.note("Aborted");
+      return;
+    }
+  } else if (!opts.yes && opts.json) {
+    out.fail(new Error("Refusing to delete without --yes in --json mode"));
+  }
+  try {
+    await ctx.axios.delete(`${BASE3}/${encodeURIComponent(id)}`);
+    out.ok(`Project ${id} deleted`);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleProjectsArchive(id, opts) {
+  const out = output(opts);
+  const ctx = await buildApiContext(out);
+  try {
+    const res = await ctx.axios.post(`${BASE3}/${encodeURIComponent(id)}/archive`);
+    out.ok(`Project ${id} archived`, res.data?.project ?? res.data);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleProjectsPublish(id, opts) {
+  const out = output(opts);
+  const ctx = await buildApiContext(out);
+  try {
+    const res = await ctx.axios.post(`${BASE3}/${encodeURIComponent(id)}/publish`);
+    out.ok(`Project ${id} published`, res.data?.project ?? res.data);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+
+// apps/cli/cli/handlers/sprint-handlers.ts
+var sprintsBase = (pid) => `/api/v1/projects/${encodeURIComponent(pid)}/sprints`;
+var SPRINT_COLUMNS = [
+  { header: "ID", key: "id" },
+  { header: "Name", key: "name", maxWidth: 30 },
+  { header: "Status", key: "status" },
+  { header: "Start", key: "start_date" },
+  { header: "End", key: "end_date" },
+  { header: "Position", key: "position" }
+];
+function requireProject(opts, out) {
+  if (!opts.project) out.fail(new Error("--project <id> is required"));
+}
+async function handleSprintsList(opts) {
+  const out = output(opts);
+  requireProject(opts, out);
+  const ctx = await buildApiContext(out);
+  const params = {};
+  if (opts.status) params.status = opts.status;
+  if (opts.page) params.page = Number(opts.page);
+  if (opts.perPage) params.per_page = Number(opts.perPage);
+  try {
+    const res = await ctx.axios.get(sprintsBase(opts.project), { params });
+    const items = Array.isArray(res.data) ? res.data : [];
+    const pagination = extractPagination(res.headers, items.length);
+    if (opts.json) {
+      out.show({ items, pagination });
+      return;
+    }
+    out.list(items, SPRINT_COLUMNS);
+    if (pagination.pages > 1) {
+      out.note(`page ${pagination.page}/${pagination.pages} (${pagination.count} total)`);
+    }
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleSprintsShow(id, opts) {
+  const out = output(opts);
+  requireProject(opts, out);
+  const ctx = await buildApiContext(out);
+  try {
+    const res = await ctx.axios.get(`${sprintsBase(opts.project)}/${encodeURIComponent(id)}`);
+    out.show(res.data?.sprint ?? res.data, { title: `Sprint ${id}` });
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleSprintsCreate(opts) {
+  const out = output(opts);
+  requireProject(opts, out);
+  const ctx = await buildApiContext(out);
+  if (!opts.name) out.fail(new Error("--name is required"));
+  const body2 = { name: opts.name };
+  if (opts.goal !== void 0) body2.goal = opts.goal;
+  if (opts.description !== void 0) body2.description = opts.description;
+  if (opts.start !== void 0) body2.start_date = opts.start;
+  if (opts.end !== void 0) body2.end_date = opts.end;
+  try {
+    const res = await ctx.axios.post(sprintsBase(opts.project), body2);
+    const sprint = res.data?.sprint ?? res.data;
+    out.ok(`Sprint created (id=${sprint?.id ?? "unknown"})`, sprint);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleSprintsUpdate(id, opts) {
+  const out = output(opts);
+  requireProject(opts, out);
+  const ctx = await buildApiContext(out);
+  const body2 = {};
+  if (opts.name !== void 0) body2.name = opts.name;
+  if (opts.goal !== void 0) body2.goal = opts.goal;
+  if (opts.description !== void 0) body2.description = opts.description;
+  if (opts.start !== void 0) body2.start_date = opts.start;
+  if (opts.end !== void 0) body2.end_date = opts.end;
+  if (opts.status !== void 0) body2.status = opts.status;
+  if (Object.keys(body2).length === 0) out.fail(new Error("No fields to update"));
+  try {
+    const res = await ctx.axios.patch(
+      `${sprintsBase(opts.project)}/${encodeURIComponent(id)}`,
+      body2
+    );
+    out.ok(`Sprint ${id} updated`, res.data?.sprint ?? res.data);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleSprintsDelete(id, opts) {
+  const out = output(opts);
+  requireProject(opts, out);
+  const ctx = await buildApiContext(out);
+  if (!opts.yes && !opts.json) {
+    const { confirm } = await lib_default.prompt([
+      {
+        type: "confirm",
+        name: "confirm",
+        message: `Delete sprint ${id}? Tickets in this sprint will be returned to the backlog.`,
+        default: false
+      }
+    ]);
+    if (!confirm) {
+      out.note("Aborted");
+      return;
+    }
+  } else if (!opts.yes && opts.json) {
+    out.fail(new Error("Refusing to delete without --yes in --json mode"));
+  }
+  try {
+    await ctx.axios.delete(`${sprintsBase(opts.project)}/${encodeURIComponent(id)}`);
+    out.ok(`Sprint ${id} deleted`);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleSprintsStart(id, opts) {
+  const out = output(opts);
+  requireProject(opts, out);
+  const ctx = await buildApiContext(out);
+  try {
+    const res = await ctx.axios.post(
+      `${sprintsBase(opts.project)}/${encodeURIComponent(id)}/start`
+    );
+    out.ok(`Sprint ${id} started`, res.data?.sprint ?? res.data);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleSprintsComplete(id, opts) {
+  const out = output(opts);
+  requireProject(opts, out);
+  const ctx = await buildApiContext(out);
+  try {
+    const res = await ctx.axios.post(
+      `${sprintsBase(opts.project)}/${encodeURIComponent(id)}/complete`
+    );
+    out.ok(`Sprint ${id} completed`, res.data?.sprint ?? res.data);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+
+// apps/cli/cli/handlers/ticket-handlers.ts
+var ticketsBase = (pid) => `/api/v1/projects/${encodeURIComponent(pid)}/tickets`;
+var TICKET_COLUMNS = [
+  { header: "ID", key: "id" },
+  { header: "Title", key: "title", maxWidth: 40 },
+  { header: "Type", key: "ticket_type" },
+  { header: "Status", key: "status" },
+  { header: "Priority", key: "priority" },
+  { header: "Sprint", key: "sprint_id" },
+  { header: "Assignee", key: "assignee_id" },
+  { header: "Due", key: "due_date" }
+];
+function requireProject2(opts, out) {
+  if (!opts.project) out.fail(new Error("--project <id> is required"));
+}
+function parseLabels(raw) {
+  if (raw == null) return void 0;
+  return raw.split(",").map((s3) => s3.trim()).filter(Boolean);
+}
+async function handleTicketsList(opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  const params = {};
+  if (opts.backlog) {
+    params.backlog = true;
+  } else if (opts.sprint !== void 0) {
+    params.sprint_id = opts.sprint === "null" ? "null" : opts.sprint;
+  }
+  if (opts.assignee !== void 0) {
+    params.assignee_id = opts.assignee === "null" ? "null" : opts.assignee;
+  }
+  if (opts.status) params.status = opts.status;
+  if (opts.priority) params.priority = opts.priority;
+  if (opts.label) params.label = opts.label;
+  if (opts.page) params.page = Number(opts.page);
+  if (opts.perPage) params.per_page = Number(opts.perPage);
+  try {
+    const res = await ctx.axios.get(ticketsBase(opts.project), { params });
+    const items = Array.isArray(res.data) ? res.data : [];
+    const pagination = extractPagination(res.headers, items.length);
+    if (opts.json) {
+      out.show({ items, pagination });
+      return;
+    }
+    out.list(items, TICKET_COLUMNS);
+    if (pagination.pages > 1) {
+      out.note(`page ${pagination.page}/${pagination.pages} (${pagination.count} total)`);
+    }
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTicketsShow(id, opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  try {
+    const res = await ctx.axios.get(`${ticketsBase(opts.project)}/${encodeURIComponent(id)}`);
+    out.show(res.data?.ticket ?? res.data, { title: `Ticket ${id}` });
+  } catch (err) {
+    out.fail(err);
+  }
+}
+function ticketBodyFromOpts(opts, includeAll) {
+  const body2 = {};
+  if (opts.title !== void 0) body2.title = opts.title;
+  if (opts.description !== void 0) body2.description = opts.description;
+  if (opts.type !== void 0) body2.ticket_type = opts.type;
+  if (opts.sprint !== void 0) {
+    body2.sprint_id = opts.sprint === "null" ? null : opts.sprint;
+  }
+  if (opts.assignee !== void 0) {
+    body2.assignee_id = opts.assignee === "null" ? null : opts.assignee;
+  }
+  if (opts.priority !== void 0) body2.priority = opts.priority;
+  if (opts.status !== void 0) body2.status = opts.status;
+  if (opts.parent !== void 0) {
+    body2.parent_ticket_id = opts.parent === "null" ? null : opts.parent;
+  }
+  if (opts.due !== void 0) body2.due_date = opts.due;
+  if (opts.storyPoints !== void 0) body2.story_points = Number(opts.storyPoints);
+  const labels = parseLabels(opts.labels);
+  if (labels !== void 0) body2.labels = labels;
+  if (opts.column !== void 0) body2.column_status = opts.column;
+  return includeAll ? body2 : body2;
+}
+async function handleTicketsCreate(opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  if (!opts.title) out.fail(new Error("--title is required"));
+  const body2 = ticketBodyFromOpts(opts, true);
+  try {
+    const res = await ctx.axios.post(ticketsBase(opts.project), body2);
+    const ticket = res.data?.ticket ?? res.data;
+    out.ok(`Ticket created (id=${ticket?.id ?? "unknown"})`, ticket);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTicketsUpdate(id, opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  const body2 = ticketBodyFromOpts(opts, true);
+  if (Object.keys(body2).length === 0) out.fail(new Error("No fields to update"));
+  try {
+    const res = await ctx.axios.patch(
+      `${ticketsBase(opts.project)}/${encodeURIComponent(id)}`,
+      body2
+    );
+    out.ok(`Ticket ${id} updated`, res.data?.ticket ?? res.data);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTicketsDelete(id, opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  if (!opts.yes && !opts.json) {
+    const { confirm } = await lib_default.prompt([
+      {
+        type: "confirm",
+        name: "confirm",
+        message: `Delete ticket ${id}? This also drops its tasks, subtasks, deliverables and activities.`,
+        default: false
+      }
+    ]);
+    if (!confirm) {
+      out.note("Aborted");
+      return;
+    }
+  } else if (!opts.yes && opts.json) {
+    out.fail(new Error("Refusing to delete without --yes in --json mode"));
+  }
+  try {
+    await ctx.axios.delete(`${ticketsBase(opts.project)}/${encodeURIComponent(id)}`);
+    out.ok(`Ticket ${id} deleted`);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTicketsAssign(id, opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  if (opts.to === void 0) out.fail(new Error("--to <user-id|null> is required"));
+  const body2 = { assignee_id: opts.to === "null" ? null : opts.to };
+  try {
+    const res = await ctx.axios.patch(
+      `${ticketsBase(opts.project)}/${encodeURIComponent(id)}/assign`,
+      body2
+    );
+    const t3 = res.data?.ticket ?? res.data;
+    out.ok(
+      body2.assignee_id === null ? `Ticket ${id} unassigned` : `Ticket ${id} assigned to ${body2.assignee_id}`,
+      t3
+    );
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTicketsStatus(id, opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  if (!opts.to) {
+    out.fail(new Error("--to <open|in_progress|done|blocked|awaiting_human|cancelled|failed> is required"));
+  }
+  const body2 = { status: opts.to };
+  if (opts.column !== void 0) body2.column_status = opts.column;
+  try {
+    const res = await ctx.axios.patch(
+      `${ticketsBase(opts.project)}/${encodeURIComponent(id)}/change_status`,
+      body2
+    );
+    out.ok(`Ticket ${id} status \u2192 ${opts.to}`, res.data?.ticket ?? res.data);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTicketsMove(id, opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  const body2 = {};
+  if (opts.backlog) {
+    body2.sprint_id = null;
+  } else if (opts.sprint !== void 0) {
+    body2.sprint_id = opts.sprint === "null" ? null : opts.sprint;
+  }
+  if (opts.column !== void 0) body2.column_status = opts.column;
+  if (opts.position !== void 0) body2.position = Number(opts.position);
+  if (Object.keys(body2).length === 0) {
+    out.fail(new Error("Nothing to move \u2014 pass --sprint, --backlog, --column or --position"));
+  }
+  try {
+    const res = await ctx.axios.patch(
+      `${ticketsBase(opts.project)}/${encodeURIComponent(id)}/move`,
+      body2
+    );
+    out.ok(`Ticket ${id} moved`, res.data?.ticket ?? res.data);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+var ACTIVITY_COLUMNS = [
+  { header: "ID", key: "id" },
+  { header: "Kind", key: "kind" },
+  { header: "Actor", key: "actor_id" },
+  { header: "At", key: "created_at" },
+  { header: "Detail", key: "summary", maxWidth: 60 }
+];
+async function handleTicketsActivities(id, opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  const params = {};
+  if (opts.page) params.page = Number(opts.page);
+  if (opts.perPage) params.per_page = Number(opts.perPage);
+  try {
+    const res = await ctx.axios.get(
+      `${ticketsBase(opts.project)}/${encodeURIComponent(id)}/activities`,
+      { params }
+    );
+    const items = Array.isArray(res.data) ? res.data : [];
+    const pagination = extractPagination(res.headers, items.length);
+    if (opts.json) {
+      out.show({ items, pagination });
+      return;
+    }
+    out.list(items, ACTIVITY_COLUMNS);
+    if (pagination.pages > 1) {
+      out.note(`page ${pagination.page}/${pagination.pages} (${pagination.count} total)`);
+    }
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTicketsDeliverable(id, opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  if (!opts.deliverable) out.fail(new Error("--deliverable <id> is required"));
+  try {
+    const res = await ctx.axios.post(
+      `${ticketsBase(opts.project)}/${encodeURIComponent(id)}/publish_deliverable`,
+      { deliverable_id: opts.deliverable }
+    );
+    out.ok(
+      `Deliverable ${opts.deliverable} published on ticket ${id}`,
+      res.data?.deliverable ?? res.data
+    );
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTicketsDispatch(id, opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  try {
+    const res = await ctx.axios.post(
+      `${ticketsBase(opts.project)}/${encodeURIComponent(id)}/dispatch_agent`
+    );
+    out.ok(`Agent dispatched on ticket ${id}`, res.data?.ticket ?? res.data);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+
+// apps/cli/cli/handlers/task-handlers.ts
+var tasksBase = (pid, tid) => `/api/v1/projects/${encodeURIComponent(pid)}/tickets/${encodeURIComponent(tid)}/tasks`;
+var TASK_COLUMNS = [
+  { header: "ID", key: "id" },
+  { header: "Title", key: "title", maxWidth: 40 },
+  { header: "Done", key: "completed", format: (v6) => v6 ? "\u2714" : "" },
+  { header: "Priority", key: "priority" },
+  { header: "Assignee", key: "assignee_id" },
+  { header: "Due", key: "due_date" },
+  { header: "Position", key: "position" }
+];
+function requireParents(opts, out) {
+  if (!opts.project) out.fail(new Error("--project <id> is required"));
+  if (!opts.ticket) out.fail(new Error("--ticket <id> is required"));
+}
+function parseLabels2(raw) {
+  if (raw == null) return void 0;
+  return raw.split(",").map((s3) => s3.trim()).filter(Boolean);
+}
+async function handleTasksList(opts) {
+  const out = output(opts);
+  requireParents(opts, out);
+  const ctx = await buildApiContext(out);
+  try {
+    const res = await ctx.axios.get(tasksBase(opts.project, opts.ticket));
+    const items = Array.isArray(res.data) ? res.data : [];
+    const pagination = extractPagination(res.headers, items.length);
+    if (opts.json) {
+      out.show({ items, pagination });
+      return;
+    }
+    out.list(items, TASK_COLUMNS);
+    if (pagination.pages > 1) {
+      out.note(`page ${pagination.page}/${pagination.pages} (${pagination.count} total)`);
+    }
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTasksShow(id, opts) {
+  const out = output(opts);
+  requireParents(opts, out);
+  const ctx = await buildApiContext(out);
+  try {
+    const res = await ctx.axios.get(
+      `${tasksBase(opts.project, opts.ticket)}/${encodeURIComponent(id)}`
+    );
+    out.show(res.data?.task ?? res.data, { title: `Task ${id}` });
+  } catch (err) {
+    out.fail(err);
+  }
+}
+function taskBodyFromOpts(opts) {
+  const body2 = {};
+  if (opts.title !== void 0) body2.title = opts.title;
+  if (opts.description !== void 0) body2.description = opts.description;
+  if (opts.priority !== void 0) body2.priority = opts.priority;
+  if (opts.assignee !== void 0) {
+    body2.assignee_id = opts.assignee === "null" ? null : opts.assignee;
+  }
+  if (opts.due !== void 0) body2.due_date = opts.due;
+  if (opts.estimate !== void 0) body2.estimate = Number(opts.estimate);
+  const labels = parseLabels2(opts.labels);
+  if (labels !== void 0) body2.labels = labels;
+  return body2;
+}
+async function handleTasksCreate(opts) {
+  const out = output(opts);
+  requireParents(opts, out);
+  const ctx = await buildApiContext(out);
+  if (!opts.title) out.fail(new Error("--title is required"));
+  const body2 = taskBodyFromOpts(opts);
+  try {
+    const res = await ctx.axios.post(tasksBase(opts.project, opts.ticket), body2);
+    const task = res.data?.task ?? res.data;
+    out.ok(`Task created (id=${task?.id ?? "unknown"})`, task);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTasksUpdate(id, opts) {
+  const out = output(opts);
+  requireParents(opts, out);
+  const ctx = await buildApiContext(out);
+  const body2 = taskBodyFromOpts(opts);
+  if (Object.keys(body2).length === 0) out.fail(new Error("No fields to update"));
+  try {
+    const res = await ctx.axios.patch(
+      `${tasksBase(opts.project, opts.ticket)}/${encodeURIComponent(id)}`,
+      body2
+    );
+    out.ok(`Task ${id} updated`, res.data?.task ?? res.data);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTasksDelete(id, opts) {
+  const out = output(opts);
+  requireParents(opts, out);
+  const ctx = await buildApiContext(out);
+  if (!opts.yes && !opts.json) {
+    const { confirm } = await lib_default.prompt([
+      {
+        type: "confirm",
+        name: "confirm",
+        message: `Delete task ${id}?`,
+        default: false
+      }
+    ]);
+    if (!confirm) {
+      out.note("Aborted");
+      return;
+    }
+  } else if (!opts.yes && opts.json) {
+    out.fail(new Error("Refusing to delete without --yes in --json mode"));
+  }
+  try {
+    await ctx.axios.delete(
+      `${tasksBase(opts.project, opts.ticket)}/${encodeURIComponent(id)}`
+    );
+    out.ok(`Task ${id} deleted`);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTasksComplete(id, opts) {
+  const out = output(opts);
+  requireParents(opts, out);
+  const ctx = await buildApiContext(out);
+  const body2 = { completed: !opts.uncomplete };
+  try {
+    const res = await ctx.axios.patch(
+      `${tasksBase(opts.project, opts.ticket)}/${encodeURIComponent(id)}/complete`,
+      body2
+    );
+    out.ok(
+      body2.completed ? `Task ${id} completed` : `Task ${id} re-opened`,
+      res.data?.task ?? res.data
+    );
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleTasksReorder(opts) {
+  const out = output(opts);
+  requireParents(opts, out);
+  const ctx = await buildApiContext(out);
+  if (!opts.order || opts.order.trim() === "") {
+    out.fail(new Error("--order is required (comma-separated task ids)"));
+  }
+  const task_ids = opts.order.split(",").map((s3) => s3.trim()).filter(Boolean);
+  if (task_ids.length === 0) {
+    out.fail(new Error("--order must contain at least one task id"));
+  }
+  try {
+    const res = await ctx.axios.patch(
+      `${tasksBase(opts.project, opts.ticket)}/reorder`,
+      { task_ids }
+    );
+    const items = Array.isArray(res.data) ? res.data : [];
+    if (opts.json) {
+      out.show({ ok: true, message: "Tasks reordered", tasks: items });
+      return;
+    }
+    out.ok("Tasks reordered");
+    out.list(items, TASK_COLUMNS);
+  } catch (err) {
+    out.fail(err);
+  }
+}
+
 // apps/cli/cli.ts
 var getVersion = () => {
   try {
-    if (true) return "1.8.2";
+    if (true) return "1.9.0";
   } catch {
   }
   for (const candidate of [
@@ -734220,6 +735009,106 @@ permissions.command("grant").description("Grant a permission on a resource to a
 permissions.command("revoke <id>").description("Revoke a permission by id").option("--yes", "Skip the interactive confirmation").action(async (id, options) => {
   await handlePermissionsRevoke(id, withGlobals(options));
 });
+var projects = program2.command("projects").description("Manage projects (attached to a workspace or standalone)");
+projects.command("ls").alias("list").description("List projects").option("--workspace <id>", 'Filter by workspace id; use "null" for standalone projects').option("--type <slug>", "Filter by project_type").option("--status <status>", "active | completed | archived | draft | failed | paused").option("--page <n>").option("--per-page <n>").action(async (options) => {
+  await handleProjectsList(withGlobals(options));
+});
+projects.command("show <id>").description("Show a project (with sprints and ticket stats)").action(async (id, options) => {
+  await handleProjectsShow(id, withGlobals(options));
+});
+projects.command("create").description("Create a project").requiredOption("--name <name>", "Project name").option("--description <text>").option("--workspace <id>", "Attach to a workspace (omit for standalone)").option("--type-id <id>", "Project type id (UUID)").option("--folder <id>", "Link to a documents folder").option("--settings <json>", "Kanban columns / icon / color as JSON").option("--metadata <json>", "Custom metadata as JSON object").action(async (options) => {
+  await handleProjectsCreate(withGlobals(options));
+});
+projects.command("update <id>").description("Update a project (name / description / status / settings / metadata only \u2014 workspace and folder cannot be changed via API)").option("--name <name>").option("--description <text>").option("--status <status>").option("--settings <json>").option("--metadata <json>").action(async (id, options) => {
+  await handleProjectsUpdate(id, withGlobals(options));
+});
+projects.command("delete <id>").description("Delete a project (drops its sprints and tickets)").option("--yes", "Skip the interactive confirmation").action(async (id, options) => {
+  await handleProjectsDelete(id, withGlobals(options));
+});
+projects.command("archive <id>").description("Archive a project (transition to `archived` status)").action(async (id, options) => {
+  await handleProjectsArchive(id, withGlobals(options));
+});
+projects.command("publish <id>").description("Publish a project (transition from `draft` to `active`)").action(async (id, options) => {
+  await handleProjectsPublish(id, withGlobals(options));
+});
+var sprints = program2.command("sprints").description("Manage sprints of a project (requires --project)");
+sprints.command("ls").alias("list").description("List sprints of a project").requiredOption("--project <id>", "Parent project id").option("--status <status>", "planning | active | completed | failed | pending").option("--page <n>").option("--per-page <n>").action(async (options) => {
+  await handleSprintsList(withGlobals(options));
+});
+sprints.command("show <id>").description("Show a sprint (with tickets summary)").requiredOption("--project <id>", "Parent project id").action(async (id, options) => {
+  await handleSprintsShow(id, withGlobals(options));
+});
+sprints.command("create").description("Create a sprint").requiredOption("--project <id>", "Parent project id").requiredOption("--name <name>").option("--goal <text>").option("--description <text>").option("--start <YYYY-MM-DD>").option("--end <YYYY-MM-DD>").action(async (options) => {
+  await handleSprintsCreate(withGlobals(options));
+});
+sprints.command("update <id>").description("Update a sprint").requiredOption("--project <id>", "Parent project id").option("--name <name>").option("--goal <text>").option("--description <text>").option("--start <YYYY-MM-DD>").option("--end <YYYY-MM-DD>").option("--status <status>").action(async (id, options) => {
+  await handleSprintsUpdate(id, withGlobals(options));
+});
+sprints.command("delete <id>").description("Delete a sprint (its tickets return to the backlog)").requiredOption("--project <id>", "Parent project id").option("--yes", "Skip the interactive confirmation").action(async (id, options) => {
+  await handleSprintsDelete(id, withGlobals(options));
+});
+sprints.command("start <id>").description("Start a sprint (planning \u2192 active)").requiredOption("--project <id>", "Parent project id").action(async (id, options) => {
+  await handleSprintsStart(id, withGlobals(options));
+});
+sprints.command("complete <id>").description("Complete a sprint (active \u2192 completed)").requiredOption("--project <id>", "Parent project id").action(async (id, options) => {
+  await handleSprintsComplete(id, withGlobals(options));
+});
+var tickets = program2.command("tickets").description("Manage tickets of a project (requires --project)");
+tickets.command("ls").alias("list").description("List tickets").requiredOption("--project <id>", "Parent project id").option("--sprint <id>", 'Filter by sprint id; use "null" or --backlog for backlog').option("--backlog", "Alias for --sprint null").option("--assignee <id>", 'Filter by assignee id; use "null" for unassigned').option("--status <status>").option("--priority <priority>").option("--label <label>").option("--page <n>").option("--per-page <n>").action(async (options) => {
+  await handleTicketsList(withGlobals(options));
+});
+tickets.command("show <id>").description("Show a ticket (with tasks, subtasks, deliverables)").requiredOption("--project <id>", "Parent project id").action(async (id, options) => {
+  await handleTicketsShow(id, withGlobals(options));
+});
+tickets.command("create").description("Create a ticket").requiredOption("--project <id>", "Parent project id").requiredOption("--title <text>").option("--description <text>").option("--type <ticket_type>", "task (default) | bug | story | epic | \u2026").option("--sprint <id>", "Attach to a sprint; omit to leave in backlog").option("--assignee <id>", "Assign to a user id").option("--priority <priority>", "lowest | low | medium | high | highest").option("--status <status>").option("--parent <id>", "Parent ticket id (for subtasks)").option("--due <YYYY-MM-DD>").option("--story-points <n>").option("--labels <a,b,c>", "Comma-separated labels").option("--column <column_status>").action(async (options) => {
+  await handleTicketsCreate(withGlobals(options));
+});
+tickets.command("update <id>").description("Update a ticket").requiredOption("--project <id>", "Parent project id").option("--title <text>").option("--description <text>").option("--type <ticket_type>").option("--sprint <id>", 'Move to a sprint; use "null" for backlog').option("--assignee <id>", 'Reassign; use "null" to unassign').option("--priority <priority>").option("--status <status>").option("--parent <id>").option("--due <YYYY-MM-DD>").option("--story-points <n>").option("--labels <a,b,c>").option("--column <column_status>").action(async (id, options) => {
+  await handleTicketsUpdate(id, withGlobals(options));
+});
+tickets.command("delete <id>").description("Delete a ticket (drops its tasks, deliverables, activities)").requiredOption("--project <id>", "Parent project id").option("--yes", "Skip the interactive confirmation").action(async (id, options) => {
+  await handleTicketsDelete(id, withGlobals(options));
+});
+tickets.command("assign <id>").description("Assign a ticket to a user; --to null to unassign").requiredOption("--project <id>", "Parent project id").requiredOption("--to <user-id|null>").action(async (id, options) => {
+  await handleTicketsAssign(id, withGlobals(options));
+});
+tickets.command("status <id>").description("Change a ticket status (optionally pin the kanban column with --column)").requiredOption("--project <id>", "Parent project id").requiredOption("--to <status>", "open | in_progress | done | blocked | awaiting_human | cancelled | failed").option("--column <column_status>", "Optionally set the kanban column at the same time").action(async (id, options) => {
+  await handleTicketsStatus(id, withGlobals(options));
+});
+tickets.command("move <id>").description("Move a ticket to another sprint / column / position").requiredOption("--project <id>", "Parent project id").option("--sprint <id>", 'Target sprint id; use "null" or --backlog for backlog').option("--backlog", "Alias for --sprint null").option("--column <column_status>").option("--position <n>").action(async (id, options) => {
+  await handleTicketsMove(id, withGlobals(options));
+});
+tickets.command("activities <id>").description("List activities of a ticket (audit log)").requiredOption("--project <id>", "Parent project id").option("--page <n>").option("--per-page <n>").action(async (id, options) => {
+  await handleTicketsActivities(id, withGlobals(options));
+});
+tickets.command("deliverable <id>").description("Publish an existing deliverable already attached to a ticket (see corex#588 for the create-then-publish flow)").requiredOption("--project <id>", "Parent project id").requiredOption("--deliverable <id>", "Deliverable id to publish").action(async (id, options) => {
+  await handleTicketsDeliverable(id, withGlobals(options));
+});
+tickets.command("dispatch <id>").description("Dispatch the ticket's already-configured agent (agent_config is read from the ticket, not passed in body)").requiredOption("--project <id>", "Parent project id").action(async (id, options) => {
+  await handleTicketsDispatch(id, withGlobals(options));
+});
+var tasks = program2.command("tasks").description("Manage sub-tasks of a ticket (requires --project + --ticket)");
+tasks.command("ls").alias("list").description("List sub-tasks of a ticket").requiredOption("--project <id>", "Parent project id").requiredOption("--ticket <id>", "Parent ticket id").action(async (options) => {
+  await handleTasksList(withGlobals(options));
+});
+tasks.command("show <id>").description("Show a task").requiredOption("--project <id>", "Parent project id").requiredOption("--ticket <id>", "Parent ticket id").action(async (id, options) => {
+  await handleTasksShow(id, withGlobals(options));
+});
+tasks.command("create").description("Create a task under a ticket").requiredOption("--project <id>", "Parent project id").requiredOption("--ticket <id>", "Parent ticket id").requiredOption("--title <text>").option("--description <text>").option("--priority <priority>").option("--assignee <id>", 'Assign to a user id; use "null" for unassigned').option("--due <YYYY-MM-DD>").option("--estimate <n>", "Effort estimate (integer)").option("--labels <a,b,c>", "Comma-separated labels").action(async (options) => {
+  await handleTasksCreate(withGlobals(options));
+});
+tasks.command("update <id>").description("Update a task").requiredOption("--project <id>", "Parent project id").requiredOption("--ticket <id>", "Parent ticket id").option("--title <text>").option("--description <text>").option("--priority <priority>").option("--assignee <id>").option("--due <YYYY-MM-DD>").option("--estimate <n>").option("--labels <a,b,c>").action(async (id, options) => {
+  await handleTasksUpdate(id, withGlobals(options));
+});
+tasks.command("delete <id>").description("Delete a task").requiredOption("--project <id>", "Parent project id").requiredOption("--ticket <id>", "Parent ticket id").option("--yes", "Skip the interactive confirmation").action(async (id, options) => {
+  await handleTasksDelete(id, withGlobals(options));
+});
+tasks.command("complete <id>").description("Mark a task as completed (or re-open with --uncomplete)").requiredOption("--project <id>", "Parent project id").requiredOption("--ticket <id>", "Parent ticket id").option("--uncomplete", "Re-open the task instead of completing it").action(async (id, options) => {
+  await handleTasksComplete(id, withGlobals(options));
+});
+tasks.command("reorder").description("Reorder tasks under a ticket").requiredOption("--project <id>", "Parent project id").requiredOption("--ticket <id>", "Parent ticket id").requiredOption("--order <ids>", "Comma-separated task ids in the desired order").action(async (options) => {
+  await handleTasksReorder(withGlobals(options));
+});
 program2.parse();
 /*! Bundled license information:
 

package/docs/llm-usage.md

@@ -362,6 +362,101 @@ hubdoc permissions ls --on="$WS" --on-type=workspace --json \
     | jq '.[] | {actor: .actor.display_name, level}'
 ```
 
+### Projects / Sprints / Tickets / Tasks (corex#588)
+
+Manage projects (attached to a workspace or standalone), their sprints,
+tickets and sub-tasks — the same domain Synapse agents drive when they
+consume incoming emails, produce deliverables, or hand off work between
+themselves. All commands support `--json` for machine parsing.
+
+`hubdoc projects` (top-level: attached to a workspace or standalone) —
+`ls | show | create | update | delete | archive | publish`.
+`--workspace null` filters the standalone (unattached) projects.
+
+`hubdoc sprints --project=<pid>` — `ls | show | create | update | delete
+| start | complete`.
+
+`hubdoc tickets --project=<pid>` — `ls | show | create | update | delete
+| assign | status | move | activities | deliverable | dispatch`. Every
+verb requires `--project=<pid>`. `ls --backlog` (or `ls --sprint null`)
+lists the backlog. `assign --to null` unassigns. `status --to <state>
+[--column <col>]` uses the canonical statuses: `open | in_progress | done
+| blocked | awaiting_human | cancelled | failed` and optionally pins the
+kanban column at the same time.
+
+`hubdoc tasks --project=<pid> --ticket=<tid>` — `ls | show | create |
+update | delete | complete | reorder`. Sub-tasks live under a ticket;
+both parents are required on every call.
+
+**Pagination**: all `ls`-shaped verbs return `{ items, pagination:{ page,
+per_page, pages, count, has_more } }` in `--json`. The transport under
+the hood is a bare JSON array plus `X-Total-*` headers (Pagy), same
+convention as `/api/v1/documents`; the CLI normalises so agents don't
+need to touch headers.
+
+**Idempotence caveat**: `sprints start` / `sprints complete` follow the
+interactor semantics — re-triggering on a sprint already in the target
+state returns **422** (`unprocessable_entity` with an
+`already_active` / `already_completed` message), not 200.
+
+**Deliverables**: `tickets deliverable <id> --deliverable <did>`
+publishes an EXISTING deliverable already attached to the ticket (via
+web UI or a future create endpoint). The API does not yet support
+creating + publishing a deliverable in one CLI call — track corex#588
+follow-ups.
+
+**Dispatch**: `tickets dispatch <id>` fires the agent already configured
+on the ticket (`agent_config` is read from the ticket's persisted
+state). To change the agent config, set it on the ticket via the web UI
+or a future `update` extension — the CLI cannot pass it in the request
+body today.
+
+#### End-to-end example: agent turns an incoming email into a mission
+
+```bash
+# 0. The Synapse poller has already dropped the raw .eml + attachments
+#    into Hubdoc and passed us the email doc id.
+EMAIL_ID="doc-42"
+
+# 1. Detach attachments so the agent can classify them separately.
+hubdoc files detach "$EMAIL_ID" --ext pdf,docx --json
+
+# 2. Pick the standalone project used for triage (no workspace linkage).
+PID=$(hubdoc projects ls --workspace null --type-id "$TRIAGE_PT_ID" --json \
+        | jq -r '.items[0].id')
+
+# 3. Create a ticket in the current sprint, priority high, due next week.
+SID=$(hubdoc sprints ls --project "$PID" --status active --json \
+        | jq -r '.items[0].id')
+TID=$(hubdoc tickets create --project "$PID" \
+        --title "Client X – devis à produire" \
+        --sprint "$SID" --assignee "u-1" \
+        --priority high --due 2026-07-18 \
+        --labels "commercial,urgent" --json | jq -r '.data.id')
+
+# 4. Break it down into tasks the agent will chew through.
+hubdoc tasks create --project "$PID" --ticket "$TID" \
+    --title "Lire pièces jointes" --priority high --json
+hubdoc tasks create --project "$PID" --ticket "$TID" \
+    --title "Rédiger devis" --priority high --due 2026-07-16 --json
+
+# 5. Dispatch the agent already configured on the ticket.
+hubdoc tickets dispatch "$TID" --project "$PID" --json
+
+# 6. Later — publish an already-attached deliverable and close the ticket.
+hubdoc tickets deliverable "$TID" --project "$PID" \
+    --deliverable "$DELIVERABLE_ID" --json
+hubdoc tickets status "$TID" --project "$PID" \
+    --to done --column done --json
+```
+
+Common patterns:
+- **Move a ticket to the backlog**: `hubdoc tickets move <id> --project=<pid>
+  --backlog` (equivalent to `--sprint null`).
+- **Un-assign**: `hubdoc tickets assign <id> --project=<pid> --to null`.
+- **Reorder a ticket's tasks** (drag-and-drop from the UI equivalent):
+  `hubdoc tasks reorder --project=<pid> --ticket=<tid> --order=k3,k1,k2`.
+
 ## Out of scope (planned)
 
 - `hubdoc templates create|update|delete` — depends on corex#417 backend

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sinoia/hubdoc-tools",
-  "version": "1.8.2",
+  "version": "1.9.0",
   "description": "Professional command-line tool for HubDoc document management and bulk import/export",
   "main": "cli.js",
   "bin": {