tines 0.0.211 → 0.0.212

package/README.md

@@ -46,12 +46,18 @@ tines issues comment <project>/<number> - <<'EOF'    # body from stdin; @file al
 EOF
 tines events list --issue <project>/<number>
 tines events list --since 2026-09-01T00:00:00Z --until 2026-09-08T00:00:00Z --state Engineering/Review
+tines events list --project Tines --all-pages --max-items 20000 --json
 tines supervisor stats --window 7d --project Tines
 ```
 
 Issues are addressed as `<project>/<number>`; schedules as `<project>/<name>`; workflow
 states as `<workflow>/<state>`. Every `list` command returns one page — add `--all-pages`
-for the whole list — and every command takes `--json` for machine-readable output.
+for the whole list — and every command takes `--json` for machine-readable output. Complete
+list walks have a default 10,000-item safety ceiling. Use `--max-items <n>` with
+`--all-pages` to choose a different positive finite bound; exceeding it fails without
+printing a partial result. `--limit` remains the per-request page size. A larger bound keeps
+more output in memory and makes more requests, so increase it deliberately or narrow the
+list's filters.
 `tines <noun> --help` lists the rest: `workflows`, `context`, `journal`, `schedules`,
 `runners`, `runs`, `routing`, `supervisor`.
 

package/dist/index.js

@@ -5904,23 +5904,39 @@ function withCommon(cmd) {
   ).option("--api-key <key>", "API key (or set TINES_API_KEY, or run `tines login`)").option("--json", "output the raw JSON response");
 }
 function withList(cmd) {
-  return withCommon(
-    cmd.option(
-      "--limit <n>",
-      "maximum items to return (page size under --all-pages)",
-      parsePositiveInteger
-    ).option("--cursor <cursor>", "resume from the next_cursor of a previous page").addOption(
-      new Option(
-        "--all-pages",
-        "fetch every page, not just the first (slower on large lists)"
-      ).conflicts("cursor")
-    )
-  );
+  const listCommand = cmd.option(
+    "--limit <n>",
+    "maximum items to return (page size under --all-pages)",
+    parsePositiveInteger
+  ).option("--cursor <cursor>", "resume from the next_cursor of a previous page").addOption(
+    new Option(
+      "--all-pages",
+      "fetch every page, not just the first (default safety ceiling: 10000 items)"
+    ).conflicts("cursor")
+  ).option(
+    "--max-items <n>",
+    "safety ceiling for --all-pages (default 10000; exceeding it errors)",
+    parseMaxItems
+  ).hook("preAction", (_thisCommand, actionCommand) => {
+    const opts = actionCommand.opts();
+    if (opts.maxItems !== void 0 && !opts.allPages) {
+      actionCommand.error("--max-items requires --all-pages");
+    }
+  });
+  return withCommon(listCommand);
 }
 function parsePositiveInteger(value) {
-  if (!/^[1-9]\d*$/.test(value)) throw new Error("limit must be a positive integer");
+  return parsePositiveIntegerOption(value, "limit");
+}
+function parseMaxItems(value) {
+  return parsePositiveIntegerOption(value, "max-items");
+}
+function parsePositiveIntegerOption(value, optionName) {
+  if (!/^[1-9]\d*$/.test(value)) throw new Error(`${optionName} must be a positive integer`);
   const result = Number(value);
-  if (!Number.isSafeInteger(result)) throw new Error("limit must be a positive safe integer");
+  if (!Number.isSafeInteger(result)) {
+    throw new Error(`${optionName} must be a positive safe integer`);
+  }
   return result;
 }
 function isUsageIdentity(value, prefix) {
@@ -5999,7 +6015,10 @@ more results: rerun with --all-pages, or resume with --cursor ${res.next_cursor}
 }
 async function fetchList(opts, fetchPage) {
   if (opts.allPages) {
-    return { items: await listAll(fetchPage, { pageSize: opts.limit }), next_cursor: null };
+    return {
+      items: await listAll(fetchPage, { pageSize: opts.limit, maxItems: opts.maxItems }),
+      next_cursor: null
+    };
   }
   const res = await fetchPage({ limit: opts.limit, cursor: opts.cursor });
   if (res.next_cursor && opts.json && !opts.cursor) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tines",
-  "version": "0.0.211",
+  "version": "0.0.212",
   "description": "CLI for Tines, an orchestration layer for AI agents",
   "repository": {
     "type": "git",