@dosu/cli 0.57.1 → 0.58.0

package/bin/dosu.js

@@ -1083,7 +1083,7 @@ function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.57.1", INSTALL_CHANNEL = "npm";
+var VERSION = "0.58.0", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -6786,7 +6786,7 @@ var init_dist4 = __esm(() => {
 });
 
 // src/client/contract.ts
-var CLI_CONTRACT_HASH = "d7c6f0f0e8d0";
+var CLI_CONTRACT_HASH = "a6e002dff58e";
 
 // src/client/trpc.ts
 function createTypedClient(config) {
@@ -6869,8 +6869,11 @@ function messageLimit(value) {
   }
   return parsed;
 }
+function isUuid(value) {
+  return UUID_RE.test(value);
+}
 function uuid(value) {
-  if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value)) {
+  if (!isUuid(value)) {
     throw new InvalidArgumentError("must be a UUID");
   }
   return value;
@@ -6913,8 +6916,10 @@ function boundedText(maximum) {
     return trimmed;
   };
 }
+var UUID_RE;
 var init_arguments = __esm(() => {
   init_commander();
+  UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 });
 
 // src/commands/auth.ts
@@ -11170,6 +11175,25 @@ async function listAccessibleDeployments(client, activeOrgId) {
   const deployments = await Promise.all(orgs.map((org) => client.workspaces.listForOrg.query(org.org_id)));
   return deployments.flat();
 }
+async function resolveDeploymentId(client, activeOrgId, id) {
+  const needle = id.trim();
+  if (isUuid(needle))
+    return needle;
+  const prefix = needle.toLowerCase();
+  const matches = (await listAccessibleDeployments(client, activeOrgId)).filter((d) => d.provider_slug === MCP_PROVIDER_SLUG && prefix.length > 0 && d.deployment_id.toLowerCase().startsWith(prefix));
+  if (matches.length === 1)
+    return matches[0].deployment_id;
+  if (matches.length === 0) {
+    console.error(import_picocolors15.default.red(`Deployment not found: ${id}`));
+    console.error(import_picocolors15.default.dim("Expected a full deployment ID (UUID). Run 'dosu deployments list --json' to see full IDs."));
+    process.exit(1);
+  }
+  console.error(import_picocolors15.default.red(`Ambiguous deployment ID prefix: ${id} matches ${matches.length}:`));
+  for (const d of matches) {
+    console.error(import_picocolors15.default.dim(`  ${d.deployment_id}  ${d.name}`));
+  }
+  process.exit(1);
+}
 function deploymentsCommand() {
   const cmd = new Command("deployments").description("Manage deployments");
   cmd.command("list").description("List all deployments").option("--json", "Output as JSON").action(async (opts) => {
@@ -11223,9 +11247,10 @@ ${import_picocolors15.default.dim(`Current: ${cfg.active_account?.target?.deploy
       ["Created", formatDate(deployment.created_at)]
     ], { rawData: deployment });
   });
-  cmd.command("switch").description("Switch to a different deployment").argument("<id>", "Deployment ID").option("--json", "Output as JSON").action(async (id, opts) => {
+  cmd.command("switch").description("Switch to a different deployment").argument("<id>", "Deployment ID (full UUID, or a unique prefix as shown by 'list')").option("--json", "Output as JSON").action(async (rawId, opts) => {
     const cfg = requireConfig4();
     const client = createTypedClient(cfg);
+    const id = await resolveDeploymentId(client, cfg.active_account?.target?.org_id, rawId);
     const deployment = await client.workspaces.get.query(id);
     if (!deployment) {
       console.error(import_picocolors15.default.red(`Deployment not found: ${id}`));
@@ -11258,6 +11283,7 @@ var init_deployments = __esm(() => {
   init_client();
   init_trpc();
   init_config();
+  init_arguments();
   init_auth();
   init_output();
   import_picocolors15 = __toESM(require_picocolors(), 1);
@@ -13716,7 +13742,7 @@ var init_sync = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "ca9e58ba-ed30-6875-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "102e2621-b1fd-c662-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
@@ -59352,6 +59378,95 @@ var init_org = __esm(() => {
   import_picocolors24 = __toESM(require_picocolors(), 1);
 });
 
+// src/commands/time-range.ts
+function utcDay(year, month, day) {
+  const [y, m, d] = [Number(year), Number(month), Number(day)];
+  const ms = Date.UTC(y, m - 1, d);
+  const check = new Date(ms);
+  const exists = check.getUTCFullYear() === y && check.getUTCMonth() === m - 1 && check.getUTCDate() === d;
+  return exists ? ms : undefined;
+}
+function offsetMs(offset) {
+  if (!offset || offset.toUpperCase() === "Z")
+    return 0;
+  const sign = offset.startsWith("-") ? -1 : 1;
+  const digits = offset.slice(1).replace(":", "");
+  const hours = Number(digits.slice(0, 2));
+  const minutes = Number(digits.slice(2) || "0");
+  if (hours > 23 || minutes > 59)
+    return;
+  return sign * (hours * HOUR_MS + minutes * 60 * 1000);
+}
+function parseIsoDatetime(text) {
+  const match = ISO_DATETIME.exec(text);
+  if (!match)
+    return;
+  const [, year, month, day, hour, minute, second = "0", fraction = "", offset] = match;
+  const dayMs = utcDay(year, month, day);
+  const offsetValue = offsetMs(offset);
+  const [h, mi, s] = [Number(hour), Number(minute), Number(second)];
+  if (dayMs === undefined || offsetValue === undefined || h > 23 || mi > 59 || s > 59) {
+    return;
+  }
+  const ms = Number(fraction.padEnd(3, "0").slice(0, 3));
+  return dayMs + h * HOUR_MS + mi * 60 * 1000 + s * 1000 + ms - offsetValue;
+}
+function parseTimeBound(value, opts) {
+  const text = value.trim();
+  let ms;
+  const relative = RELATIVE_BOUND.exec(text);
+  const dateOnly = DATE_ONLY.exec(text);
+  if (relative) {
+    ms = opts.now.getTime() - Number(relative[1]) * RELATIVE_UNIT_MS[relative[2]];
+  } else if (dateOnly) {
+    const day = utcDay(dateOnly[1], dateOnly[2], dateOnly[3]);
+    ms = day === undefined ? undefined : day + (opts.endOfDay ? 24 * HOUR_MS : 0);
+  } else {
+    ms = parseIsoDatetime(text);
+  }
+  const date = ms === undefined ? undefined : new Date(ms);
+  if (!date || Number.isNaN(date.getTime()))
+    throw new InvalidArgumentError(INVALID_BOUND);
+  return date;
+}
+function timeBound(value) {
+  parseTimeBound(value, { endOfDay: false, now: new Date });
+  return value.trim();
+}
+function resolveTimeRange(since, until, now = new Date) {
+  const range = {
+    since: since ? parseTimeBound(since, { endOfDay: false, now }) : undefined,
+    until: until ? parseTimeBound(until, { endOfDay: true, now }) : undefined
+  };
+  if (range.since && range.until && range.since >= range.until) {
+    throw new InvalidArgumentError("--since must be earlier than --until");
+  }
+  return range;
+}
+function describeTimeRange(range) {
+  const fmt = (d) => `${d.toISOString().slice(0, 16)}Z`;
+  const parts = [];
+  if (range.since)
+    parts.push(`since ${fmt(range.since)}`);
+  if (range.until)
+    parts.push(`before ${fmt(range.until)}`);
+  return parts.join(" and ");
+}
+var RELATIVE_BOUND, DATE_ONLY, ISO_DATETIME, HOUR_MS, RELATIVE_UNIT_MS, INVALID_BOUND;
+var init_time_range = __esm(() => {
+  init_commander();
+  RELATIVE_BOUND = /^(\d+)([hdw])$/;
+  DATE_ONLY = /^(\d{4})-(\d{2})-(\d{2})$/;
+  ISO_DATETIME = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d+))?)?(Z|[+-]\d{2}(?::?\d{2})?)?$/i;
+  HOUR_MS = 60 * 60 * 1000;
+  RELATIVE_UNIT_MS = {
+    h: HOUR_MS,
+    d: 24 * HOUR_MS,
+    w: 7 * 24 * HOUR_MS
+  };
+  INVALID_BOUND = 'must be a duration like "24h", "7d", or "2w", a UTC date like "2026-09-01", ' + 'or an ISO-8601 datetime like "2026-09-01T14:00:00Z"';
+});
+
 // src/commands/review.ts
 import { readFileSync as readFileSync18 } from "node:fs";
 function requireConfig10() {
@@ -59452,7 +59567,16 @@ async function getKnowledgeStoreId2(client, spaceId) {
 }
 function reviewCommand() {
   const cmd = new Command("review").description("Review workflow (doc changes and draft replies)");
-  cmd.command("list").description("List pending review items (doc changes and draft replies)").option("--json", "Output as JSON").action(async (opts) => {
+  cmd.command("list").description("List pending review items (doc changes and draft replies)").addOption(new Option("--since <when>", "Only items created at or after <when>: a duration back from now (24h, 7d, 2w), " + "a UTC date (2026-09-01), or an ISO-8601 datetime").argParser(timeBound)).addOption(new Option("--until <when>", "Only items created before <when> (same forms; a date includes that whole day)").argParser(timeBound)).option("--json", "Output as JSON").action(async (opts) => {
+    let range;
+    try {
+      range = resolveTimeRange(opts.since, opts.until);
+    } catch (err) {
+      console.error(import_picocolors25.default.red(`${err.message}.`));
+      process.exit(1);
+    }
+    const rangeLabel = describeTimeRange(range);
+    const inRange = rangeLabel ? ` ${rangeLabel}` : "";
     const cfg = requireConfig10();
     if (!cfg.active_account?.target?.space_id) {
       console.error(import_picocolors25.default.red("Missing space config. Run 'dosu setup' to reconfigure."));
@@ -59462,7 +59586,9 @@ function reviewCommand() {
     const ksId = await getKnowledgeStoreId2(client, cfg.active_account?.target?.space_id);
     const result = await client.review.listPending.query({
       knowledgeStoreId: ksId,
-      deploymentId: cfg.active_account?.target?.deployment_id
+      deploymentId: cfg.active_account?.target?.deployment_id,
+      ...range.since && { since: range.since.toISOString() },
+      ...range.until && { until: range.until.toISOString() }
     });
     const { items, truncated, total } = result;
     if (opts.json) {
@@ -59470,9 +59596,11 @@ function reviewCommand() {
       return;
     }
     if (!items || items.length === 0) {
-      console.log(import_picocolors25.default.dim("No pending review items."));
+      console.log(import_picocolors25.default.dim(`No pending review items${inRange}.`));
       return;
     }
+    if (rangeLabel)
+      console.log(import_picocolors25.default.dim(`Pending review items created ${rangeLabel}:`));
     printTable(["ID", "Kind", "Title", "Source", "Status", "Created"], items.map((i) => i.kind === "draft_message" ? [
       i.id,
       i.kind,
@@ -59489,7 +59617,7 @@ function reviewCommand() {
       formatDate(i.createdAt)
     ]), { rawData: items });
     if (truncated) {
-      console.log(import_picocolors25.default.dim(`Showing ${items.length} of ${total}+ pending items (list truncated).`));
+      console.log(import_picocolors25.default.dim(`Showing ${items.length} of ${total}+ pending items${inRange} (list truncated).`));
     }
   });
   cmd.command("diff").description("Show a pending review item (doc-change diff or draft reply body)").argument("<id>", "Review item ID (from `dosu review list`)").option("--json", "Output as JSON").action(async (id, opts) => {
@@ -59667,6 +59795,7 @@ var init_review = __esm(() => {
   init_auth();
   init_confirmation();
   init_output();
+  init_time_range();
   import_picocolors25 = __toESM(require_picocolors(), 1);
 });
 
@@ -66813,4 +66942,4 @@ main().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=ca9e58ba-ed30-6875-6475-6e2164756e21
+//# debugId=102e2621-b1fd-c662-6475-6e2164756e21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dosu/cli",
-  "version": "0.57.1",
+  "version": "0.58.0",
   "type": "module",
   "description": "Dosu CLI - Manage MCP servers for AI tools",
   "license": "MIT",