@ricsam/r5dctl 0.0.35 → 0.0.37

package/dist/cjs/cli.cjs

@@ -49,6 +49,8 @@ __export(cli_exports, {
   renderProcessHistory: () => renderProcessHistory,
   renderProcessInspection: () => renderProcessInspection,
   renderProcessList: () => renderProcessList,
+  renderWorkspaceStatus: () => renderWorkspaceStatus,
+  renderWorkspaceSync: () => renderWorkspaceSync,
   resolveCommandExecution: () => resolveCommandExecution,
   runR5dctlCli: () => runR5dctlCli,
   summarizeEnvData: () => summarizeEnvData
@@ -68,7 +70,6 @@ const CHAT_MODES = /* @__PURE__ */ new Set([
   "build",
   "agent",
   "explore",
-  "review",
   "test",
   "research",
   "security_review",
@@ -133,6 +134,17 @@ const SHARED_HELP_ENTRIES = [
   },
   { section: "auth", usage: "auth api-key list", description: "List API keys for the current account." },
   { section: "auth", usage: "auth api-key revoke <key-id>", description: "Revoke an API key." },
+  { section: "workspace", usage: "workspace status", description: "Inspect the per-user canonical workspace and active remediation." },
+  {
+    section: "workspace",
+    usage: "workspace sync [--worker <label>]",
+    description: "Publish a connected worker into the canonical workspace now."
+  },
+  {
+    section: "workspace",
+    usage: "workspace reset [--worker <label>] --confirm",
+    description: "Destructively discard a blocked remediation candidate and restore canonical state."
+  },
   { section: "projects", usage: "get projects", description: "List projects you can access." },
   { section: "projects", usage: "describe project <namespace/name|id>", description: "Show details for a project." },
   { section: "projects", usage: "update project <namespace/name|id> --mode <greenfield|prod>", description: "Update project settings." },
@@ -159,6 +171,11 @@ const SHARED_HELP_ENTRIES = [
     usage: "-p <project> get sessions [--branch <branch>]",
     description: "List sessions for a project, optionally filtered by branch."
   },
+  {
+    section: "sessions",
+    usage: "sessions recent [--limit <n>]",
+    description: "List the most recently active sessions across your projects."
+  },
   {
     section: "sessions",
     usage: "-p <project> create session -b <branch> [--name <name>]",
@@ -210,7 +227,7 @@ const SHARED_HELP_ENTRIES = [
   {
     section: "processes",
     usage: "ps inspect <run-id>",
-    description: "Inspect execution, synchronization, repository outcomes, and bounded output tails."
+    description: "Inspect process metadata and bounded stdout/stderr tails."
   },
   { section: "processes", usage: "ps stop <run-id>", description: "Gracefully stop an active process with SIGTERM." },
   {
@@ -230,6 +247,7 @@ const SHARED_HELP_ENTRIES = [
 ];
 const HELP_SECTION_ORDER = [
   "auth",
+  "workspace",
   "projects",
   "branches",
   "envs",
@@ -241,6 +259,7 @@ const HELP_SECTION_ORDER = [
 ];
 const HELP_SECTION_TITLES = {
   auth: "Auth",
+  workspace: "Canonical workspace",
   projects: "Projects",
   branches: "Branches",
   envs: "Environment variables",
@@ -851,6 +870,35 @@ function parsePsHistoryArgs(args) {
   }
   return { ...parsePsListArgs(filterArgs), ...limit !== void 0 ? { limit } : {} };
 }
+function parseWorkspaceWorkerArgs(args, options = {}) {
+  let worker;
+  let confirmed = false;
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--worker" || arg?.startsWith("--worker=")) {
+      if (worker) throw new Error("Use only one --worker value");
+      worker = requireValue(arg === "--worker" ? args[++index] : parseLongOptionWithEquals(arg, "--worker"), "Missing value for --worker");
+      continue;
+    }
+    if (arg === "--confirm" && options.allowConfirm) {
+      confirmed = true;
+      continue;
+    }
+    throw new Error(`Unknown workspace argument: ${arg ?? ""}`.trim());
+  }
+  if (options.allowConfirm && !confirmed) throw new Error("workspace reset requires --confirm");
+  return { ...worker ? { worker } : {}, ...confirmed ? { confirmed: true } : {} };
+}
+function parseRecentSessionArgs(args) {
+  if (args.length === 0) return {};
+  if (args.length > 2 || args[0] !== "--limit" && !args[0]?.startsWith("--limit=")) {
+    throw new Error(`Unknown sessions recent argument: ${args[0] ?? ""}`.trim());
+  }
+  const raw = args[0] === "--limit" ? args[1] : parseLongOptionWithEquals(args[0], "--limit");
+  const limit = Number(requireValue(raw, "Missing value for --limit"));
+  if (!Number.isInteger(limit) || limit < 1 || limit > 200) throw new Error("--limit must be an integer between 1 and 200");
+  return { limit };
+}
 async function openInBrowser(url) {
   if (process.platform === "darwin") {
     (0, import_node_child_process.spawn)("open", [url], { stdio: "ignore", detached: true }).unref();
@@ -989,6 +1037,29 @@ function renderSessionList(sessions) {
   return `${sessions.map((session) => `${session.id}  ${session.branchName}  ${session.name ?? "(unnamed)"}`).join("\n")}
 `;
 }
+function renderRecentSessionList(sessions) {
+  if (sessions.length === 0) return "No recent sessions.\n";
+  return `${sessions.map((session) => `${session.id}  ${session.projectPath}/${session.branchName}  ${session.name ?? "(unnamed)"}`).join("\n")}
+`;
+}
+function renderWorkspaceStatus(status) {
+  const lines = [
+    `Workspace HEAD: ${status.head ?? "(not initialized)"}`,
+    `Latest sync: ${status.latestSync ? `${status.latestSync.outcome} on ${status.latestSync.workerLabel}` : "(none)"}`,
+    `Remediation: ${status.incident ? `${status.incident.status} (${status.incident.id}) on ${status.incident.originWorkerLabel}` : "none"}`
+  ];
+  return `${lines.join("\n")}
+`;
+}
+function renderWorkspaceSync(result) {
+  const head = result.publishedHead ?? result.candidateHead ?? result.startingHead ?? "(none)";
+  const discarded = result.discardedPaths.length > 0 ? `
+Discarded paths: ${result.discardedPaths.join(", ")}` : "";
+  const error = result.error ? `
+Error: ${result.error}` : "";
+  return `Workspace sync ${result.outcome} on ${result.workerLabel}; HEAD ${head}; ${result.diffSizeBytes} bytes.${discarded}${error}
+`;
+}
 function renderSessionDescription(session) {
   return [`Session: ${session.id}`, `Project: ${session.projectPath}`, `Branch: ${session.branchName}`].join("\n") + "\n";
 }
@@ -1040,33 +1111,26 @@ function renderProcessHistory(processes, nowMs = Date.now()) {
   return processes.length === 0 ? "No process history.\n" : renderProcessList(processes, nowMs);
 }
 function renderProcessInspection(process2) {
-  const repositories = process2.repositoryOutcomes.length === 0 ? "  (none)" : process2.repositoryOutcomes.map(
-    (outcome) => `  ${outcome.projectPath ?? outcome.projectId} ${outcome.branchName}: ${outcome.status}${outcome.startCommitHash ? `; start ${outcome.startCommitHash}` : ""}${outcome.publishedCommitHash ? ` (${outcome.publishedCommitHash})` : ""}${outcome.branchActionId ? `; branch action ${outcome.branchActionId}` : ""}${outcome.largeDiffIncidentId ? `; incident ${outcome.largeDiffIncidentId}` : ""}${outcome.diffSizeBytes !== void 0 ? `; ${outcome.diffSizeBytes} diff bytes` : ""}${outcome.principalSynchronizationState ? `; principal ${outcome.principalSynchronizationState}` : ""}${outcome.fanOutState ? `; fan-out ${outcome.fanOutState}` : ""}${outcome.error ? ` \u2014 ${outcome.error}` : ""}`
-  ).join("\n");
   return [
     `Run: ${process2.runId}`,
-    `Status: ${process2.status} / sync ${process2.syncState}`,
+    `Status: ${process2.status}`,
     `Mode: ${process2.mode}`,
     `Worker: ${process2.workerLabel} (${process2.platform ?? "unknown"}/${process2.arch ?? "unknown"})`,
     `Project: ${process2.projectPath} ${process2.branchName}`,
     `Session: ${process2.sessionId}`,
     `Command: ${process2.command}`,
     `Argv: ${JSON.stringify(process2.argv)}`,
-    `CWD: ${process2.cwd ?? "(default checkout)"}`,
+    `CWD: ${process2.cwd ?? "(project root)"}`,
     `PID/process group: ${process2.pid ?? "(unknown)"}/${process2.processGroupId ?? "(unknown)"}`,
-    `Starting canonical commit: ${process2.startCommitHash}`,
     `Started: ${process2.startedAt}`,
     `Updated: ${process2.updatedAt}`,
     `Completed: ${process2.completedAt ?? "(running)"}`,
     `Exit code: ${process2.exitCode ?? "(none)"}`,
     `Error: ${process2.error ?? "(none)"}`,
-    `Launch action: ${process2.launchWorkspaceActionId ?? "(none)"}`,
-    `Terminal sync action: ${process2.terminalWorkspaceActionId ?? "(pending)"}`,
-    `Terminal sync claimed: ${process2.terminalSyncClaimedAt ?? "(pending)"}`,
-    `Published origin commit: ${process2.publishedCommitHash ?? "(none)"}`,
-    `Principal synchronization: ${process2.principalSynchronizationState ?? "(pending)"}`,
-    "Repositories observed during synchronization:",
-    repositories,
+    `Workspace sync: ${process2.workspaceSync ? `${process2.workspaceSync.outcome} (${process2.workspaceSync.attemptId})` : "(pending or not observed)"}`,
+    ...process2.workspaceSync?.affectedProjects.length ? [`Repositories observed during synchronization: ${process2.workspaceSync.affectedProjects.join(", ")}`] : [],
+    ...process2.workspaceSync?.discardedPaths.length ? [`Discarded paths: ${process2.workspaceSync.discardedPaths.join(", ")}`] : [],
+    `Log: ${process2.logPath}`,
     "",
     `stdout tail${process2.stdoutTailTruncated ? " (truncated)" : ""}:`,
     process2.stdoutTail || "(empty)",
@@ -1345,6 +1409,23 @@ async function executeR5dctlCommand(client, json, args) {
     write(result, "API key revoked.\n");
     return;
   }
+  if (first === "workspace" && second === "status") {
+    if (args.length > 2) throw new Error(`Unexpected workspace status argument: ${args[2]}`);
+    const status = await client.workspace.status();
+    write(status, renderWorkspaceStatus(status));
+    return;
+  }
+  if (first === "workspace" && second === "sync") {
+    const result = await client.workspace.sync(parseWorkspaceWorkerArgs(args.slice(2)));
+    write(result, renderWorkspaceSync(result));
+    return;
+  }
+  if (first === "workspace" && second === "reset") {
+    const parsed = parseWorkspaceWorkerArgs(args.slice(2), { allowConfirm: true });
+    const result = await client.workspace.reset({ worker: parsed.worker, confirmed: true });
+    write(result, renderWorkspaceSync(result));
+    return;
+  }
   if (first === "ps" && second === "list") {
     const processes = await client.processes.list(parsePsListArgs(args.slice(2)));
     write(processes, renderProcessList(processes));
@@ -1356,6 +1437,7 @@ async function executeR5dctlCommand(client, json, args) {
     return;
   }
   if (first === "ps" && second === "inspect") {
+    if (args.length > 3) throw new Error(`Unexpected ps inspect value: ${args[3]}`);
     const process2 = await client.processes.inspect(requireValue(args[2], "Missing process run id"));
     write(process2, renderProcessInspection(process2));
     return;
@@ -1366,6 +1448,11 @@ async function executeR5dctlCommand(client, json, args) {
 `);
     return;
   }
+  if (first === "sessions" && second === "recent") {
+    const sessions = await client.sessions.recent(parseRecentSessionArgs(args.slice(2)));
+    write(sessions, renderRecentSessionList(sessions));
+    return;
+  }
   if (first === "projects" && second === "list" || first === "get" && second === "projects") {
     const projects = await client.projects.list();
     write(projects, renderProjectList(projects));
@@ -1603,7 +1690,7 @@ function resolveCommandExecution(options, rest) {
       pluginArgs: [...normalizedRest, "--help"]
     };
   }
-  if (command === "projects" || command === "sessions") {
+  if (command === "projects" || command === "sessions" || command === "workspace") {
     return {
       kind: "plugin",
       pluginArgs: normalizedRest
@@ -1690,11 +1777,11 @@ function resolveCommandExecution(options, rest) {
         ["--project", filters.project],
         ["--branch", filters.branch],
         ["--session", filters.session],
-        ["--worker", filters.worker],
-        ["--limit", filters.limit?.toString()]
+        ["--worker", filters.worker]
       ]) {
         if (value) pluginArgs.push(flag, value);
       }
+      if (filters.limit !== void 0) pluginArgs.push("--limit", String(filters.limit));
       return { kind: "plugin", pluginArgs };
     }
     if (subcommand === "inspect") {
@@ -2145,6 +2232,8 @@ async function main(argv = process.argv.slice(2)) {
   renderProcessHistory,
   renderProcessInspection,
   renderProcessList,
+  renderWorkspaceStatus,
+  renderWorkspaceSync,
   resolveCommandExecution,
   runR5dctlCli,
   summarizeEnvData

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.35",
+  "version": "0.0.37",
   "type": "commonjs"
 }

package/dist/mjs/cli.mjs

@@ -15,7 +15,6 @@ const CHAT_MODES = /* @__PURE__ */ new Set([
   "build",
   "agent",
   "explore",
-  "review",
   "test",
   "research",
   "security_review",
@@ -80,6 +79,17 @@ const SHARED_HELP_ENTRIES = [
   },
   { section: "auth", usage: "auth api-key list", description: "List API keys for the current account." },
   { section: "auth", usage: "auth api-key revoke <key-id>", description: "Revoke an API key." },
+  { section: "workspace", usage: "workspace status", description: "Inspect the per-user canonical workspace and active remediation." },
+  {
+    section: "workspace",
+    usage: "workspace sync [--worker <label>]",
+    description: "Publish a connected worker into the canonical workspace now."
+  },
+  {
+    section: "workspace",
+    usage: "workspace reset [--worker <label>] --confirm",
+    description: "Destructively discard a blocked remediation candidate and restore canonical state."
+  },
   { section: "projects", usage: "get projects", description: "List projects you can access." },
   { section: "projects", usage: "describe project <namespace/name|id>", description: "Show details for a project." },
   { section: "projects", usage: "update project <namespace/name|id> --mode <greenfield|prod>", description: "Update project settings." },
@@ -106,6 +116,11 @@ const SHARED_HELP_ENTRIES = [
     usage: "-p <project> get sessions [--branch <branch>]",
     description: "List sessions for a project, optionally filtered by branch."
   },
+  {
+    section: "sessions",
+    usage: "sessions recent [--limit <n>]",
+    description: "List the most recently active sessions across your projects."
+  },
   {
     section: "sessions",
     usage: "-p <project> create session -b <branch> [--name <name>]",
@@ -157,7 +172,7 @@ const SHARED_HELP_ENTRIES = [
   {
     section: "processes",
     usage: "ps inspect <run-id>",
-    description: "Inspect execution, synchronization, repository outcomes, and bounded output tails."
+    description: "Inspect process metadata and bounded stdout/stderr tails."
   },
   { section: "processes", usage: "ps stop <run-id>", description: "Gracefully stop an active process with SIGTERM." },
   {
@@ -177,6 +192,7 @@ const SHARED_HELP_ENTRIES = [
 ];
 const HELP_SECTION_ORDER = [
   "auth",
+  "workspace",
   "projects",
   "branches",
   "envs",
@@ -188,6 +204,7 @@ const HELP_SECTION_ORDER = [
 ];
 const HELP_SECTION_TITLES = {
   auth: "Auth",
+  workspace: "Canonical workspace",
   projects: "Projects",
   branches: "Branches",
   envs: "Environment variables",
@@ -798,6 +815,35 @@ function parsePsHistoryArgs(args) {
   }
   return { ...parsePsListArgs(filterArgs), ...limit !== void 0 ? { limit } : {} };
 }
+function parseWorkspaceWorkerArgs(args, options = {}) {
+  let worker;
+  let confirmed = false;
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--worker" || arg?.startsWith("--worker=")) {
+      if (worker) throw new Error("Use only one --worker value");
+      worker = requireValue(arg === "--worker" ? args[++index] : parseLongOptionWithEquals(arg, "--worker"), "Missing value for --worker");
+      continue;
+    }
+    if (arg === "--confirm" && options.allowConfirm) {
+      confirmed = true;
+      continue;
+    }
+    throw new Error(`Unknown workspace argument: ${arg ?? ""}`.trim());
+  }
+  if (options.allowConfirm && !confirmed) throw new Error("workspace reset requires --confirm");
+  return { ...worker ? { worker } : {}, ...confirmed ? { confirmed: true } : {} };
+}
+function parseRecentSessionArgs(args) {
+  if (args.length === 0) return {};
+  if (args.length > 2 || args[0] !== "--limit" && !args[0]?.startsWith("--limit=")) {
+    throw new Error(`Unknown sessions recent argument: ${args[0] ?? ""}`.trim());
+  }
+  const raw = args[0] === "--limit" ? args[1] : parseLongOptionWithEquals(args[0], "--limit");
+  const limit = Number(requireValue(raw, "Missing value for --limit"));
+  if (!Number.isInteger(limit) || limit < 1 || limit > 200) throw new Error("--limit must be an integer between 1 and 200");
+  return { limit };
+}
 async function openInBrowser(url) {
   if (process.platform === "darwin") {
     spawn("open", [url], { stdio: "ignore", detached: true }).unref();
@@ -936,6 +982,29 @@ function renderSessionList(sessions) {
   return `${sessions.map((session) => `${session.id}  ${session.branchName}  ${session.name ?? "(unnamed)"}`).join("\n")}
 `;
 }
+function renderRecentSessionList(sessions) {
+  if (sessions.length === 0) return "No recent sessions.\n";
+  return `${sessions.map((session) => `${session.id}  ${session.projectPath}/${session.branchName}  ${session.name ?? "(unnamed)"}`).join("\n")}
+`;
+}
+function renderWorkspaceStatus(status) {
+  const lines = [
+    `Workspace HEAD: ${status.head ?? "(not initialized)"}`,
+    `Latest sync: ${status.latestSync ? `${status.latestSync.outcome} on ${status.latestSync.workerLabel}` : "(none)"}`,
+    `Remediation: ${status.incident ? `${status.incident.status} (${status.incident.id}) on ${status.incident.originWorkerLabel}` : "none"}`
+  ];
+  return `${lines.join("\n")}
+`;
+}
+function renderWorkspaceSync(result) {
+  const head = result.publishedHead ?? result.candidateHead ?? result.startingHead ?? "(none)";
+  const discarded = result.discardedPaths.length > 0 ? `
+Discarded paths: ${result.discardedPaths.join(", ")}` : "";
+  const error = result.error ? `
+Error: ${result.error}` : "";
+  return `Workspace sync ${result.outcome} on ${result.workerLabel}; HEAD ${head}; ${result.diffSizeBytes} bytes.${discarded}${error}
+`;
+}
 function renderSessionDescription(session) {
   return [`Session: ${session.id}`, `Project: ${session.projectPath}`, `Branch: ${session.branchName}`].join("\n") + "\n";
 }
@@ -987,33 +1056,26 @@ function renderProcessHistory(processes, nowMs = Date.now()) {
   return processes.length === 0 ? "No process history.\n" : renderProcessList(processes, nowMs);
 }
 function renderProcessInspection(process2) {
-  const repositories = process2.repositoryOutcomes.length === 0 ? "  (none)" : process2.repositoryOutcomes.map(
-    (outcome) => `  ${outcome.projectPath ?? outcome.projectId} ${outcome.branchName}: ${outcome.status}${outcome.startCommitHash ? `; start ${outcome.startCommitHash}` : ""}${outcome.publishedCommitHash ? ` (${outcome.publishedCommitHash})` : ""}${outcome.branchActionId ? `; branch action ${outcome.branchActionId}` : ""}${outcome.largeDiffIncidentId ? `; incident ${outcome.largeDiffIncidentId}` : ""}${outcome.diffSizeBytes !== void 0 ? `; ${outcome.diffSizeBytes} diff bytes` : ""}${outcome.principalSynchronizationState ? `; principal ${outcome.principalSynchronizationState}` : ""}${outcome.fanOutState ? `; fan-out ${outcome.fanOutState}` : ""}${outcome.error ? ` \u2014 ${outcome.error}` : ""}`
-  ).join("\n");
   return [
     `Run: ${process2.runId}`,
-    `Status: ${process2.status} / sync ${process2.syncState}`,
+    `Status: ${process2.status}`,
     `Mode: ${process2.mode}`,
     `Worker: ${process2.workerLabel} (${process2.platform ?? "unknown"}/${process2.arch ?? "unknown"})`,
     `Project: ${process2.projectPath} ${process2.branchName}`,
     `Session: ${process2.sessionId}`,
     `Command: ${process2.command}`,
     `Argv: ${JSON.stringify(process2.argv)}`,
-    `CWD: ${process2.cwd ?? "(default checkout)"}`,
+    `CWD: ${process2.cwd ?? "(project root)"}`,
     `PID/process group: ${process2.pid ?? "(unknown)"}/${process2.processGroupId ?? "(unknown)"}`,
-    `Starting canonical commit: ${process2.startCommitHash}`,
     `Started: ${process2.startedAt}`,
     `Updated: ${process2.updatedAt}`,
     `Completed: ${process2.completedAt ?? "(running)"}`,
     `Exit code: ${process2.exitCode ?? "(none)"}`,
     `Error: ${process2.error ?? "(none)"}`,
-    `Launch action: ${process2.launchWorkspaceActionId ?? "(none)"}`,
-    `Terminal sync action: ${process2.terminalWorkspaceActionId ?? "(pending)"}`,
-    `Terminal sync claimed: ${process2.terminalSyncClaimedAt ?? "(pending)"}`,
-    `Published origin commit: ${process2.publishedCommitHash ?? "(none)"}`,
-    `Principal synchronization: ${process2.principalSynchronizationState ?? "(pending)"}`,
-    "Repositories observed during synchronization:",
-    repositories,
+    `Workspace sync: ${process2.workspaceSync ? `${process2.workspaceSync.outcome} (${process2.workspaceSync.attemptId})` : "(pending or not observed)"}`,
+    ...process2.workspaceSync?.affectedProjects.length ? [`Repositories observed during synchronization: ${process2.workspaceSync.affectedProjects.join(", ")}`] : [],
+    ...process2.workspaceSync?.discardedPaths.length ? [`Discarded paths: ${process2.workspaceSync.discardedPaths.join(", ")}`] : [],
+    `Log: ${process2.logPath}`,
     "",
     `stdout tail${process2.stdoutTailTruncated ? " (truncated)" : ""}:`,
     process2.stdoutTail || "(empty)",
@@ -1292,6 +1354,23 @@ async function executeR5dctlCommand(client, json, args) {
     write(result, "API key revoked.\n");
     return;
   }
+  if (first === "workspace" && second === "status") {
+    if (args.length > 2) throw new Error(`Unexpected workspace status argument: ${args[2]}`);
+    const status = await client.workspace.status();
+    write(status, renderWorkspaceStatus(status));
+    return;
+  }
+  if (first === "workspace" && second === "sync") {
+    const result = await client.workspace.sync(parseWorkspaceWorkerArgs(args.slice(2)));
+    write(result, renderWorkspaceSync(result));
+    return;
+  }
+  if (first === "workspace" && second === "reset") {
+    const parsed = parseWorkspaceWorkerArgs(args.slice(2), { allowConfirm: true });
+    const result = await client.workspace.reset({ worker: parsed.worker, confirmed: true });
+    write(result, renderWorkspaceSync(result));
+    return;
+  }
   if (first === "ps" && second === "list") {
     const processes = await client.processes.list(parsePsListArgs(args.slice(2)));
     write(processes, renderProcessList(processes));
@@ -1303,6 +1382,7 @@ async function executeR5dctlCommand(client, json, args) {
     return;
   }
   if (first === "ps" && second === "inspect") {
+    if (args.length > 3) throw new Error(`Unexpected ps inspect value: ${args[3]}`);
     const process2 = await client.processes.inspect(requireValue(args[2], "Missing process run id"));
     write(process2, renderProcessInspection(process2));
     return;
@@ -1313,6 +1393,11 @@ async function executeR5dctlCommand(client, json, args) {
 `);
     return;
   }
+  if (first === "sessions" && second === "recent") {
+    const sessions = await client.sessions.recent(parseRecentSessionArgs(args.slice(2)));
+    write(sessions, renderRecentSessionList(sessions));
+    return;
+  }
   if (first === "projects" && second === "list" || first === "get" && second === "projects") {
     const projects = await client.projects.list();
     write(projects, renderProjectList(projects));
@@ -1550,7 +1635,7 @@ function resolveCommandExecution(options, rest) {
       pluginArgs: [...normalizedRest, "--help"]
     };
   }
-  if (command === "projects" || command === "sessions") {
+  if (command === "projects" || command === "sessions" || command === "workspace") {
     return {
       kind: "plugin",
       pluginArgs: normalizedRest
@@ -1637,11 +1722,11 @@ function resolveCommandExecution(options, rest) {
         ["--project", filters.project],
         ["--branch", filters.branch],
         ["--session", filters.session],
-        ["--worker", filters.worker],
-        ["--limit", filters.limit?.toString()]
+        ["--worker", filters.worker]
       ]) {
         if (value) pluginArgs.push(flag, value);
       }
+      if (filters.limit !== void 0) pluginArgs.push("--limit", String(filters.limit));
       return { kind: "plugin", pluginArgs };
     }
     if (subcommand === "inspect") {
@@ -2091,6 +2176,8 @@ export {
   renderProcessHistory,
   renderProcessInspection,
   renderProcessList,
+  renderWorkspaceStatus,
+  renderWorkspaceSync,
   resolveCommandExecution,
   runR5dctlCli,
   summarizeEnvData

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.35",
+  "version": "0.0.37",
   "type": "module"
 }

package/dist/types/cli.d.ts

@@ -1,4 +1,4 @@
-import { type R5dctlConversationRenderOptions, type R5dctlConversationResponse, type R5dctlConversationOverviewResponse, type R5dctlConversationWorkDetail, type R5dctlConversationWorkResponse, type R5dctlEnvData, type R5dctlProcessListInput, type R5dctlProcessInspection, type R5dctlProcessRun, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
+import { type R5dctlConversationRenderOptions, type R5dctlConversationResponse, type R5dctlConversationOverviewResponse, type R5dctlConversationWorkDetail, type R5dctlConversationWorkResponse, type R5dctlEnvData, type R5dctlProcessInspection, type R5dctlProcessListInput, type R5dctlProcessRun, type R5dctlWorkspaceStatus, type R5dctlWorkspaceSyncResult, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
 export type GlobalOptions = {
     baseUrl?: string;
     json: boolean;
@@ -62,6 +62,8 @@ export declare function parseShellArgs(args: string[]): {
 };
 export declare function parsePsListArgs(args: string[]): R5dctlProcessListInput;
 export declare function parsePsHistoryArgs(args: string[]): R5dctlProcessListInput;
+export declare function renderWorkspaceStatus(status: R5dctlWorkspaceStatus): string;
+export declare function renderWorkspaceSync(result: R5dctlWorkspaceSyncResult): string;
 export declare function formatProcessAge(startedAt: string, nowMs?: number): string;
 export declare function renderProcessList(processes: R5dctlProcessRun[], nowMs?: number): string;
 export declare function renderProcessHistory(processes: R5dctlProcessRun[], nowMs?: number): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.35",
+  "version": "0.0.37",
   "type": "module",
   "main": "./dist/cjs/cli.cjs",
   "module": "./dist/mjs/cli.mjs",
@@ -26,7 +26,7 @@
     "r5dctl": "dist/cjs/main.cjs"
   },
   "dependencies": {
-    "@ricsam/r5d-api": "^0.0.35",
+    "@ricsam/r5d-api": "^0.0.37",
     "dotenv": "^17",
     "ws": "^8.18.3"
   },