@indigoai-us/hq-cli 5.77.2 → 5.77.3

package/dist/commands/files.js

@@ -381,7 +381,7 @@ export function registerFilesCommand(program) {
     });
     files
         .command("versions <path>")
-        .description("List prior content versions and delete markers for one exact vault key. Use --personal for your personal vault.")
+        .description("List prior content versions and delete markers for one exact vault key. Restore a listed version with restore --version-id <id>. Use --personal for your personal vault.")
         .option("--personal", "Target your own personal vault instead of a company vault (mutually exclusive with --company)")
         .action(async (path, opts) => {
         try {
@@ -397,9 +397,9 @@ export function registerFilesCommand(program) {
     });
     files
         .command("restore <path>")
-        .description("Restore a prior version or undelete an exact vault key. Prompts before overwriting unless --yes. Use --personal for your personal vault.")
+        .description("Restore a prior version with --version-id or undelete an exact vault key. Prompts before overwriting unless --yes. Use --personal for your personal vault.")
         .option("--personal", "Target your own personal vault instead of a company vault (mutually exclusive with --company)")
-        .option("--version <id>", "Content version ID to restore")
+        .option("--version-id <id>", "Content version ID to restore")
         .option("-y, --yes", "Skip the overwrite confirmation prompt (for scripts)")
         .action(async (path, opts) => {
         try {
@@ -408,7 +408,7 @@ export function registerFilesCommand(program) {
             assertRecoveryScope(personal, companySlug);
             await runFilesRestore({
                 key: path,
-                versionId: opts.version,
+                versionId: opts.versionId,
                 yes: opts.yes === true,
                 personal,
                 companySlug,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.77.2",
+  "version": "5.77.3",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {

package/src/commands/files-recovery.test.ts

@@ -308,18 +308,20 @@ describe("hq files trash", () => {
 });
 
 describe("hq files recovery command help", () => {
-  it("documents the finalized --version and --prefix option forms", () => {
+  it("documents the finalized --version-id and --prefix option forms", () => {
     const program = buildProgram();
     const files = program.commands.find((command) => command.name() === "files");
     const restore = files?.commands.find((command) => command.name() === "restore");
     const trash = files?.commands.find((command) => command.name() === "trash");
 
     expect(files?.helpInformation()).toContain("versions [options] <path>");
-    expect(restore?.helpInformation()).toContain("--version <id>");
+    expect(files?.helpInformation()).toContain("restore --version-id <id>");
+    expect(restore?.helpInformation()).toContain("--version-id <id>");
+    expect(restore?.helpInformation()).not.toContain("--version <id>");
     expect(trash?.helpInformation()).toContain("--prefix <prefix>");
   });
 
-  it("passes --version to the restore request", async () => {
+  it("passes --version-id to the restore request", async () => {
     fetchSpy.mockResolvedValueOnce(membershipResponse());
     fetchSpy.mockResolvedValueOnce(
       jsonResponse(200, {
@@ -331,7 +333,14 @@ describe("hq files recovery command help", () => {
     );
 
     await buildProgram().parseAsync(
-      ["files", "restore", "notes/a.md", "--version", "old-version", "--yes"],
+      [
+        "files",
+        "restore",
+        "notes/a.md",
+        "--version-id",
+        "old-version",
+        "--yes",
+      ],
       { from: "user" },
     );
 

package/src/commands/files.ts

@@ -515,7 +515,7 @@ export function registerFilesCommand(program: Command): Command {
   files
     .command("versions <path>")
     .description(
-      "List prior content versions and delete markers for one exact vault key. Use --personal for your personal vault.",
+      "List prior content versions and delete markers for one exact vault key. Restore a listed version with restore --version-id <id>. Use --personal for your personal vault.",
     )
     .option(
       "--personal",
@@ -539,18 +539,18 @@ export function registerFilesCommand(program: Command): Command {
   files
     .command("restore <path>")
     .description(
-      "Restore a prior version or undelete an exact vault key. Prompts before overwriting unless --yes. Use --personal for your personal vault.",
+      "Restore a prior version with --version-id or undelete an exact vault key. Prompts before overwriting unless --yes. Use --personal for your personal vault.",
     )
     .option(
       "--personal",
       "Target your own personal vault instead of a company vault (mutually exclusive with --company)",
     )
-    .option("--version <id>", "Content version ID to restore")
+    .option("--version-id <id>", "Content version ID to restore")
     .option("-y, --yes", "Skip the overwrite confirmation prompt (for scripts)")
     .action(
       async (
         path: string,
-        opts: { personal?: boolean; yes?: boolean; version?: string },
+        opts: { personal?: boolean; yes?: boolean; versionId?: string },
       ) => {
         try {
           const companySlug = files.opts().company as string | undefined;
@@ -558,7 +558,7 @@ export function registerFilesCommand(program: Command): Command {
           assertRecoveryScope(personal, companySlug);
           await runFilesRestore({
             key: path,
-            versionId: opts.version,
+            versionId: opts.versionId,
             yes: opts.yes === true,
             personal,
             companySlug,