exponential-cli 1.16.0 → 1.18.1

package/dist/index.js

@@ -2298,17 +2298,49 @@ function statusBadge(status) {
 }
 function outputTimeLogJson(result) {
   console.log(
-    JSON.stringify({ outcome: result.outcome, entry: transformTimeEntry(result.entry) }, null, 2)
+    JSON.stringify(
+      {
+        outcome: result.outcome,
+        entry: result.entry ? transformTimeEntry(result.entry) : null,
+        pieces: (result.pieces ?? []).map(transformTimeEntry),
+        mergedInto: result.mergedInto ?? []
+      },
+      null,
+      2
+    )
   );
 }
 function outputTimeLogPretty(result) {
-  const e = result.entry;
-  const verb = { created: "Logged", updated: "Updated", left: "Left untouched (already confirmed)" }[result.outcome];
-  console.log(
-    `${chalk3.green("\u2713")} ${verb}: ${clock(e.startedAt)}\u2013${e.endedAt ? clock(e.endedAt) : "now"} ${chalk3.bold(formatMinutes(entryMinutes(e)))} ${statusBadge(e.status)} ${e.action?.name ?? e.actionId}`
-  );
-  if (e.note) console.log(chalk3.gray(`  ${e.note}`));
-  console.log(chalk3.gray(`  ID: ${e.id}${e.sourceRef ? `  ref: ${e.sourceRef}` : ""}  owner: ${e.userId}`));
+  if (result.outcome === "merged") {
+    console.log(
+      `${chalk3.green("\u2713")} Merged into your manual time (${(result.mergedInto ?? []).length} entr${(result.mergedInto ?? []).length === 1 ? "y" : "ies"} annotated); nothing new written.`
+    );
+    return;
+  }
+  if (result.outcome === "dropped" || !result.entry) {
+    console.log(`${chalk3.yellow("\u2013")} Dropped: your manual time already covers every minute of it.`);
+    return;
+  }
+  const pieces = result.pieces && result.pieces.length > 0 ? result.pieces : [result.entry];
+  const verb = { created: "Logged", updated: "Updated", left: "Left untouched (already confirmed)" }[result.outcome] ?? result.outcome;
+  for (const e of pieces) {
+    console.log(
+      `${chalk3.green("\u2713")} ${verb}: ${clock(e.startedAt)}\u2013${e.endedAt ? clock(e.endedAt) : "now"} ${chalk3.bold(formatMinutes(entryMinutes(e)))} ${statusBadge(e.status)} ${e.action?.name ?? e.actionId}`
+    );
+    if (e.note) console.log(chalk3.gray(`  ${e.note}`));
+    console.log(chalk3.gray(`  ID: ${e.id}${e.sourceRef ? `  ref: ${e.sourceRef}` : ""}  owner: ${e.userId}`));
+  }
+  if (pieces.length > 1) console.log(chalk3.gray(`  split into ${pieces.length} pieces around your manual time`));
+}
+function outputTimeConfirmJson(result, date) {
+  console.log(JSON.stringify({ date, confirmed: result.confirmed }, null, 2));
+}
+function outputTimeConfirmPretty(result, date) {
+  if (result.confirmed === 0) {
+    console.log(chalk3.gray(`Nothing proposed on ${date}; nothing to confirm.`));
+    return;
+  }
+  console.log(`${chalk3.green("\u2713")} Confirmed ${result.confirmed} ${result.confirmed === 1 ? "entry" : "entries"} on ${date}.`);
 }
 function outputTimeEntriesJson(entries, date) {
   const rows = entries.map(transformTimeEntry);
@@ -2386,6 +2418,59 @@ function outputTimeBatchPretty(results) {
   console.log(chalk3.bold(`
 ${ok}/${results.length} entries logged`));
 }
+function outputDayReportJson(report, date) {
+  console.log(
+    JSON.stringify(
+      {
+        date,
+        attentionMinutes: report.attentionMinutes,
+        sessionMinutes: report.sessionMinutes,
+        agentRunMinutes: report.agentRunMinutes,
+        unassignedCount: report.unassignedCount,
+        proposedCount: report.proposedCount,
+        byProduct: report.byProduct,
+        byAction: report.byAction,
+        flags: report.flags,
+        entries: report.entries.map((e) => ({
+          ...transformTimeEntry(e),
+          productId: e.productId,
+          productName: e.productName,
+          isAgentRun: e.isAgentRun,
+          flags: e.flags,
+          ticket: e.action.ticket ? { id: e.action.ticket.id, number: e.action.ticket.number, shortId: e.action.ticket.shortId } : null
+        }))
+      },
+      null,
+      2
+    )
+  );
+}
+function outputDayReportPretty(report, date) {
+  console.log(chalk3.bold(`
+${date}`));
+  console.log(
+    `  ${chalk3.bold(formatMinutes(report.attentionMinutes))} attention \xB7 ${formatMinutes(report.sessionMinutes)} session \xB7 ${formatMinutes(report.agentRunMinutes)} agent-run` + (report.proposedCount > 0 ? chalk3.yellow(` \xB7 ${report.proposedCount} proposed`) : "") + (report.unassignedCount > 0 ? chalk3.yellow(` \xB7 ${report.unassignedCount} unassigned`) : "")
+  );
+  if (report.entries.length === 0) {
+    console.log(chalk3.gray("  No time recorded."));
+    return;
+  }
+  console.log(chalk3.bold("\nBy product"));
+  for (const row of report.byProduct) {
+    console.log(`  ${formatMinutes(row.minutes).padStart(7)}  ${row.productId ? row.name : chalk3.yellow(row.name)}`);
+  }
+  console.log(chalk3.bold("\nBy action"));
+  for (const row of report.byAction) {
+    const ticket = row.ticket ? chalk3.gray(` ${row.ticket.shortId ?? `#${row.ticket.number}`}`) : row.projectId ? chalk3.gray(` \xB7 ${row.projectName ?? "project"}`) : chalk3.yellow(" [unassigned]");
+    const agent = row.agentRunMinutes > 0 ? chalk3.gray(` (+${formatMinutes(row.agentRunMinutes)} agent-run)`) : "";
+    const proposed = row.proposedCount > 0 ? chalk3.yellow(` ${row.proposedCount} proposed`) : "";
+    console.log(`  ${formatMinutes(row.minutes).padStart(7)}  ${row.name}${ticket}${agent}${proposed}`);
+  }
+  if (report.flags.length > 0) {
+    console.log(chalk3.yellow(`
+${report.flags.length} manual entr${report.flags.length === 1 ? "y looks" : "ies look"} like a forgotten timer`));
+  }
+}
 
 // src/commands/actions.ts
 var VALID_PRIORITIES = [
@@ -6240,6 +6325,7 @@ function createTicketsCommand() {
 
 // src/commands/time.ts
 import { Command as Command22 } from "commander";
+import { segmentConversation } from "exponential-sdk";
 var SOURCES2 = ["manual", "claude-desktop", "agent-run"];
 var STATUSES2 = ["PROPOSED", "CONFIRMED"];
 var OWNERSHIP_NOTE = "Run with an external-agent key, the entry belongs to the agent's OWNER and is always PROPOSED; a personal token logs your own time, CONFIRMED by default.";
@@ -6411,8 +6497,91 @@ function createTimeCommand() {
       handleError(error);
     }
   });
+  time.command("confirm").description(
+    "Confirm a day: every PROPOSED entry of yours that starts that day becomes CONFIRMED and the Actions' spent time moves. Human only \u2014 run it with your personal credentials; an agent key is refused."
+  ).requiredOption("-d, --date <YYYY-MM-DD>", "The day (local time)").option("-w, --workspace <slug|id>", "Only entries in this workspace (default: all)").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      if (!/^\d{4}-\d{2}-\d{2}$/.test(options.date)) {
+        throw new Error(`--date must be YYYY-MM-DD, got "${options.date}".`);
+      }
+      const client = getClient();
+      const workspaceId = options.workspace ? await resolveWorkspaceId(client, options.workspace) : void 0;
+      const result = await client.time.confirmDay(options.date, workspaceId);
+      if (useJson) outputTimeConfirmJson(result, options.date);
+      else outputTimeConfirmPretty(result, options.date);
+    } catch (error) {
+      handleError(error);
+    }
+  });
+  time.command("report").description(
+    "One day's report \u2014 the numbers the /time Day tab shows: attention hours (each covered minute once), session hours (the plain sum), agent-run time on its own, hours by Product and by Action with overlapping minutes split evenly, and the unassigned and proposed counts. JSON when piped or with --json."
+  ).requiredOption("-d, --date <YYYY-MM-DD>", "The day (local time)").option("-w, --workspace <slug|id>", "Only entries in this workspace (default: all)").action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const useJson = shouldUseJson(globalOpts.json, globalOpts.pretty);
+    try {
+      if (!/^\d{4}-\d{2}-\d{2}$/.test(options.date)) {
+        throw new Error(`--date must be YYYY-MM-DD, got "${options.date}".`);
+      }
+      const client = getClient();
+      const workspaceId = options.workspace ? await resolveWorkspaceId(client, options.workspace) : void 0;
+      const report = await client.time.dayReport(options.date, workspaceId);
+      if (useJson) outputDayReportJson(report, options.date);
+      else outputDayReportPretty(report, options.date);
+    } catch (error) {
+      handleError(error);
+    }
+  });
+  time.command("segment").description(
+    [
+      "Cut one conversation's messages into Worklog segments and print the batch `time log --from-file -` consumes.",
+      'Input: a JSON array of {at, role} (role user|assistant), or {"messages": [...]}.',
+      "A gap over 30 minutes between the person's messages ends a segment; bounds round outward to 5 minutes; assistant-only runs longer than the gap become agent-run entries."
+    ].join(" ")
+  ).requiredOption("--from-file <path>", 'Messages JSON ("-" = stdin)').requiredOption("-a, --action <id>", "Action CUID every entry is logged on").requiredOption("--ref-prefix <prefix>", "sourceRef prefix, e.g. claude-session:<sessionId>; segments get #0, #1, \u2026").option("--gap <minutes>", "Silence between the person's messages that ends a segment", "30").option("--note <text>", "Note copied onto every entry").action(
+    async (options) => {
+      try {
+        const gap = Number.parseInt(options.gap, 10);
+        if (Number.isNaN(gap) || gap <= 0) throw new Error(`--gap must be a positive integer, got "${options.gap}".`);
+        const messages = parseMessagesFile(readText(void 0, options.fromFile));
+        const segments = segmentConversation(messages, gap);
+        const entries = segments.map((segment, index) => ({
+          actionId: options.action,
+          startedAt: segment.start.toISOString(),
+          endedAt: segment.end.toISOString(),
+          source: segment.humanTurns === 0 ? "agent-run" : "claude-desktop",
+          sourceRef: `${options.refPrefix}#${index}`,
+          ...options.note ? { note: options.note } : {}
+        }));
+        console.log(JSON.stringify(entries, null, 2));
+      } catch (error) {
+        handleError(error);
+      }
+    }
+  );
   return time;
 }
+function parseMessagesFile(raw) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    throw new Error(
+      `--from-file must be JSON: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  const items = Array.isArray(parsed) ? parsed : typeof parsed === "object" && parsed !== null && Array.isArray(parsed.messages) ? parsed.messages : null;
+  if (!items) throw new Error('--from-file must contain a JSON array of {at, role} messages, or {"messages": [...]}.');
+  return items.map((item, i) => {
+    if (typeof item !== "object" || item === null) throw new Error(`Message[${i}] is not an object.`);
+    const { at, role } = item;
+    if (typeof at !== "string" && !(at instanceof Date)) throw new Error(`Message[${i}].at must be an ISO timestamp.`);
+    if (Number.isNaN(new Date(at).getTime())) throw new Error(`Message[${i}].at is not a valid timestamp: "${String(at)}".`);
+    if (role !== "user" && role !== "assistant") throw new Error(`Message[${i}].role must be "user" or "assistant".`);
+    return { at, role };
+  });
+}
 
 // src/commands/workspaces.ts
 import { Command as Command23 } from "commander";