@corvio/cli 0.1.0-beta.13 → 0.1.0-beta.14

package/dist/cli.js

@@ -39,7 +39,7 @@ import {
   agentCredentialPath,
 } from "./core.js";
 
-const VERSION = "0.1.0-beta.13";
+const VERSION = "0.1.0-beta.14";
 const DEFAULT_API_BASE = "https://api.corvio.ai/v1";
 const DEFAULT_APP_BASE = "https://corvio.ai";
 const USER_AGENT = `corvio-cli/${VERSION}`;
@@ -91,14 +91,16 @@ const COMMAND_OPTIONS = Object.freeze({
   "conversations:list": ["limit", "cursor"],
   "conversations:get": ["id"],
   "search:": ["query", "limit", "page-id", "node-id"],
-  "docs:list": ["limit", "cursor"],
+  "docs:list": ["limit", "cursor", "lifecycle"],
   "docs:get": ["id", "output"],
   "docs:create": ["title", "file", "markdown", "parent-node-id", "idempotency-key"],
   "docs:update": ["id", "title", "file", "markdown", "expected-revision", "change-summary"],
   "docs:move": ["id", "parent-node-id", "before-node-id", "after-node-id", "idempotency-key"],
   "docs:archive": ["id"],
+  "docs:restore": ["id"],
   "docs:share": ["id", "display-name"],
   "docs:open": ["id"],
+  "projects:list": ["limit"],
   "projects:create": ["title", "idempotency-key"],
   "files:list": ["limit"],
   "files:get": ["id"],
@@ -127,8 +129,8 @@ Usage:
   corvio questions list|get [id]
   corvio conversations list|get [id]
   corvio search <query>
-  corvio docs list|get|create|update|move|archive|share|open [id]
-  corvio projects create --title <title>
+  corvio docs list|get|create|update|move|archive|restore|share|open [id]
+  corvio projects list|create
   corvio files list|get|download|upload|organize|open [id]
   corvio sync init|status|plan|pull|push|resolve
   corvio update check
@@ -155,8 +157,8 @@ const COMMAND_HELP = Object.freeze({
   questions: `Usage:\n  corvio questions list [--limit <n>] [--cursor <cursor>] [--conversation-id <id>]\n  corvio questions get <question-id>`,
   conversations: `Usage:\n  corvio conversations list [--limit <n>] [--cursor <cursor>]\n  corvio conversations get <conversation-id>`,
   search: `Usage: corvio search <query> [--limit <n>] [--page-id <id>] [--node-id <id>]`,
-  docs: `Usage:\n  corvio docs list [--limit <n>] [--cursor <cursor>]\n  corvio docs get <id> [--output <path>]\n  corvio docs create --title <title> [--file <path>|--markdown <text>] [--parent-node-id <id>] [--idempotency-key <key>]\n  corvio docs update <id> [--title <title>] [--file <path>|--markdown <text>] [--expected-revision <n>] [--change-summary <text>]\n  corvio docs move <id> --parent-node-id <id>\n  corvio docs archive <id> --yes\n  corvio docs share <id> --yes [--display-name <name>]\n  corvio docs open <id>\n\nAgent-authenticated document updates require --change-summary and create a visible document-level comment after the guarded update.`,
-  projects: `Usage: corvio projects create --title <title> [--idempotency-key <key>]\n\nProjects are the user-visible folder/container owner in the Corvio Docs tree. 'corvio folders' is an alias.`,
+  docs: `Usage:\n  corvio docs list [--limit <n>] [--cursor <cursor>] [--lifecycle active|archived]\n  corvio docs get <id> [--output <path>]\n  corvio docs create --title <title> [--file <path>|--markdown <text>] [--parent-node-id <id>] [--idempotency-key <key>]\n  corvio docs update <id> [--title <title>] [--file <path>|--markdown <text>] [--expected-revision <n>] [--change-summary <text>]\n  corvio docs move <id> --parent-node-id <id>\n  corvio docs archive <id> --yes\n  corvio docs restore <id> --yes\n  corvio docs share <id> --yes [--display-name <name>]\n  corvio docs open <id>\n\nDirect document commands operate on canonical Page/Markdown. Use \`corvio ask --allow-actions\` for Spreadsheet, Presentation, Code, HTML Artifact, or semantic organization. Agent-authenticated document updates require --change-summary and create a visible document-level comment after the guarded update. When a document/comment is the task owner, use \`corvio agent comments|reply|status\` to return verified work to that same collaboration surface.`,
+  projects: `Usage:\n  corvio projects list [--limit <n>]\n  corvio projects create --title <title> [--idempotency-key <key>]\n\nProjects are durable grouping owners in the Corvio Docs tree. Reuse a matching Project instead of creating one ceremonial Project per file. 'corvio folders' is an alias.`,
   files: `Usage:\n  corvio files list [--limit <n>]\n  corvio files get <id>\n  corvio files download <id> [--output <path>]\n  corvio files upload --file <path> [--mime-type <type>]\n  corvio files organize <id> --instruction <text> --yes [--target-root-node-id <id>]\n  corvio files open <id>`,
   sync: `Usage:\n  corvio sync init --root-node-id <id> [--dir <path>] [--name <name>]\n  corvio sync status|plan|pull [--dir <path>]\n  corvio sync push --yes [--dir <path>]\n  corvio sync resolve --conflict-id <id> --strategy use-remote|keep-local --yes [--dir <path>]`,
   update: `Usage: corvio update check [--json]\n\nCompare this executable with the reviewed API policy and the npm beta dist-tag.`,
@@ -180,7 +182,7 @@ function normalizeInvocation(command, action) {
     questions: "list",
     conversations: "list",
     docs: "list",
-    projects: "create",
+    projects: "list",
     files: "list",
     agents: "list",
     agent: "claim",
@@ -211,6 +213,7 @@ function validateInvocation(options, positionals) {
       "docs:update",
       "docs:move",
       "docs:archive",
+      "docs:restore",
       "docs:share",
       "docs:open",
       "files:get",
@@ -2246,9 +2249,19 @@ async function docs(options, action, id) {
   const documentId = id || options.id;
   let result;
   if (action === "list") {
-    result = await api.request("/documents", { query: pageQuery(options) });
+    const lifecycle = String(options.lifecycle || "active").trim().toLowerCase();
+    if (!new Set(["active", "archived"]).has(lifecycle)) {
+      throw new CliError("--lifecycle must be active or archived.", { code: "document_lifecycle_invalid" });
+    }
+    result = await api.request("/documents", { query: { ...pageQuery(options), lifecycle } });
   } else if (action === "get") {
     result = await api.request(`/documents/${resourcePath(documentId || option(options, "id", { required: true }))}`);
+    if (executionIdentity === "agent") {
+      result = {
+        ...result,
+        collaboration_follow_up: "If this document or one of its comments is the task/feedback owner and materially drives your work, reread current state after the work, update an explicit status only when unambiguous, reply on the originating thread with verified evidence, and resolve only after completion. A read-only citation needs no ceremonial comment.",
+      };
+    }
     if (options.output) {
       await writeTextFile(options.output, String(result.markdown || ""));
       result = { ...result, output: options.output };
@@ -2361,6 +2374,9 @@ async function docs(options, action, id) {
   } else if (action === "archive") {
     requireConfirmation(options, "Archiving a document");
     result = await api.request(`/documents/${resourcePath(documentId || option(options, "id", { required: true }))}`, { method: "DELETE" });
+  } else if (action === "restore") {
+    requireConfirmation(options, "Restoring an archived document");
+    result = await api.request(`/documents/${resourcePath(documentId || option(options, "id", { required: true }))}/restore`, { method: "POST", retrySafe: true });
   } else if (action === "share") {
     requireConfirmation(options, "Creating a document share link");
     result = await api.request(`/documents/${resourcePath(documentId || option(options, "id", { required: true }))}/shares`, {
@@ -2374,16 +2390,20 @@ async function docs(options, action, id) {
     const opened = options["no-input"] ? false : await openBrowser(target);
     result = { document_id: targetId, url: target, opened };
   } else {
-    throw new CliError("docs action must be list, get, create, update, move, archive, share, or open.");
+    throw new CliError("docs action must be list, get, create, update, move, archive, restore, share, or open.");
   }
   writeResult(result, { json: options.json });
 }
 
 async function projects(options, action) {
+  const { api } = await client(options);
+  if (action === "list") {
+    writeResult(await api.request("/projects", { query: { limit: numberOption(options, "limit", 100, { maximum: 100 }) } }), { json: options.json });
+    return;
+  }
   if (action !== "create") {
-    throw new CliError("projects action must be create.");
+    throw new CliError("projects action must be list or create.");
   }
-  const { api } = await client(options);
   const result = await api.request("/projects", {
     method: "POST",
     headers: { "idempotency-key": idempotencyKey(options) },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corvio/cli",
-  "version": "0.1.0-beta.13",
+  "version": "0.1.0-beta.14",
   "description": "Official Corvio Workspace CLI for questions, knowledge search, documents, and Agent workflows.",
   "type": "module",
   "bin": {