@bitsocial/bitsocial-cli 0.19.65 → 0.19.67

package/README.md

@@ -298,9 +298,15 @@ $ bitsocial community edit mysub.bso '--roles["author-address.bso"]' null
 ## Commands
 
 <!-- commands -->
+* [`bitsocial challenge add PACKAGE`](#bitsocial-challenge-add-package)
+* [`bitsocial challenge i PACKAGE`](#bitsocial-challenge-i-package)
 * [`bitsocial challenge install PACKAGE`](#bitsocial-challenge-install-package)
 * [`bitsocial challenge list`](#bitsocial-challenge-list)
+* [`bitsocial challenge ls`](#bitsocial-challenge-ls)
 * [`bitsocial challenge remove NAME`](#bitsocial-challenge-remove-name)
+* [`bitsocial challenge rm NAME`](#bitsocial-challenge-rm-name)
+* [`bitsocial challenge un NAME`](#bitsocial-challenge-un-name)
+* [`bitsocial challenge uninstall NAME`](#bitsocial-challenge-uninstall-name)
 * [`bitsocial community create`](#bitsocial-community-create)
 * [`bitsocial community delete ADDRESSES`](#bitsocial-community-delete-addresses)
 * [`bitsocial community edit ADDRESS`](#bitsocial-community-edit-address)
@@ -316,6 +322,72 @@ $ bitsocial community edit mysub.bso '--roles["author-address.bso"]' null
 * [`bitsocial update install [VERSION]`](#bitsocial-update-install-version)
 * [`bitsocial update versions`](#bitsocial-update-versions)
 
+## `bitsocial challenge add PACKAGE`
+
+Install a challenge package (npm package name, git URL, tarball URL, or local path)
+
+```
+USAGE
+  $ bitsocial challenge add PACKAGE [--pkcOptions.dataPath <value>]
+
+ARGUMENTS
+  PACKAGE  Package specifier — anything npm can install (name, name@version, git URL, tarball URL, local path)
+
+FLAGS
+  --pkcOptions.dataPath=<value>  Data path to install the challenge into
+
+DESCRIPTION
+  Install a challenge package (npm package name, git URL, tarball URL, or local path)
+
+ALIASES
+  $ bitsocial challenge i
+  $ bitsocial challenge add
+
+EXAMPLES
+  $ bitsocial challenge install @bitsocial/mintpass-challenge
+
+  $ bitsocial challenge install @bitsocial/mintpass-challenge@1.0.0
+
+  $ bitsocial challenge install github:user/repo
+
+  $ bitsocial challenge install https://example.com/my-challenge-1.0.0.tar.gz
+
+  $ bitsocial challenge install ./my-local-challenge
+```
+
+## `bitsocial challenge i PACKAGE`
+
+Install a challenge package (npm package name, git URL, tarball URL, or local path)
+
+```
+USAGE
+  $ bitsocial challenge i PACKAGE [--pkcOptions.dataPath <value>]
+
+ARGUMENTS
+  PACKAGE  Package specifier — anything npm can install (name, name@version, git URL, tarball URL, local path)
+
+FLAGS
+  --pkcOptions.dataPath=<value>  Data path to install the challenge into
+
+DESCRIPTION
+  Install a challenge package (npm package name, git URL, tarball URL, or local path)
+
+ALIASES
+  $ bitsocial challenge i
+  $ bitsocial challenge add
+
+EXAMPLES
+  $ bitsocial challenge install @bitsocial/mintpass-challenge
+
+  $ bitsocial challenge install @bitsocial/mintpass-challenge@1.0.0
+
+  $ bitsocial challenge install github:user/repo
+
+  $ bitsocial challenge install https://example.com/my-challenge-1.0.0.tar.gz
+
+  $ bitsocial challenge install ./my-local-challenge
+```
+
 ## `bitsocial challenge install PACKAGE`
 
 Install a challenge package (npm package name, git URL, tarball URL, or local path)
@@ -333,6 +405,10 @@ FLAGS
 DESCRIPTION
   Install a challenge package (npm package name, git URL, tarball URL, or local path)
 
+ALIASES
+  $ bitsocial challenge i
+  $ bitsocial challenge add
+
 EXAMPLES
   $ bitsocial challenge install @bitsocial/mintpass-challenge
 
@@ -345,7 +421,7 @@ EXAMPLES
   $ bitsocial challenge install ./my-local-challenge
 ```
 
-_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/challenge/install.ts)_
+_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/challenge/install.ts)_
 
 ## `bitsocial challenge list`
 
@@ -362,13 +438,40 @@ FLAGS
 DESCRIPTION
   List installed challenge packages
 
+ALIASES
+  $ bitsocial challenge ls
+
 EXAMPLES
   $ bitsocial challenge list
 
   $ bitsocial challenge list -q
 ```
 
-_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/challenge/list.ts)_
+_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/challenge/list.ts)_
+
+## `bitsocial challenge ls`
+
+List installed challenge packages
+
+```
+USAGE
+  $ bitsocial challenge ls [-q] [--pkcOptions.dataPath <value>]
+
+FLAGS
+  -q, --quiet                        Only display challenge names
+      --pkcOptions.dataPath=<value>  Data path where challenges are installed
+
+DESCRIPTION
+  List installed challenge packages
+
+ALIASES
+  $ bitsocial challenge ls
+
+EXAMPLES
+  $ bitsocial challenge list
+
+  $ bitsocial challenge list -q
+```
 
 ## `bitsocial challenge remove NAME`
 
@@ -387,13 +490,102 @@ FLAGS
 DESCRIPTION
   Remove an installed challenge package
 
+ALIASES
+  $ bitsocial challenge uninstall
+  $ bitsocial challenge rm
+  $ bitsocial challenge un
+
+EXAMPLES
+  $ bitsocial challenge remove my-challenge
+
+  $ bitsocial challenge remove @scope/my-challenge
+```
+
+_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/challenge/remove.ts)_
+
+## `bitsocial challenge rm NAME`
+
+Remove an installed challenge package
+
+```
+USAGE
+  $ bitsocial challenge rm NAME [--pkcOptions.dataPath <value>]
+
+ARGUMENTS
+  NAME  The challenge package name (e.g., my-challenge or @scope/my-challenge)
+
+FLAGS
+  --pkcOptions.dataPath=<value>  Data path where challenges are installed
+
+DESCRIPTION
+  Remove an installed challenge package
+
+ALIASES
+  $ bitsocial challenge uninstall
+  $ bitsocial challenge rm
+  $ bitsocial challenge un
+
+EXAMPLES
+  $ bitsocial challenge remove my-challenge
+
+  $ bitsocial challenge remove @scope/my-challenge
+```
+
+## `bitsocial challenge un NAME`
+
+Remove an installed challenge package
+
+```
+USAGE
+  $ bitsocial challenge un NAME [--pkcOptions.dataPath <value>]
+
+ARGUMENTS
+  NAME  The challenge package name (e.g., my-challenge or @scope/my-challenge)
+
+FLAGS
+  --pkcOptions.dataPath=<value>  Data path where challenges are installed
+
+DESCRIPTION
+  Remove an installed challenge package
+
+ALIASES
+  $ bitsocial challenge uninstall
+  $ bitsocial challenge rm
+  $ bitsocial challenge un
+
 EXAMPLES
   $ bitsocial challenge remove my-challenge
 
   $ bitsocial challenge remove @scope/my-challenge
 ```
 
-_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/challenge/remove.ts)_
+## `bitsocial challenge uninstall NAME`
+
+Remove an installed challenge package
+
+```
+USAGE
+  $ bitsocial challenge uninstall NAME [--pkcOptions.dataPath <value>]
+
+ARGUMENTS
+  NAME  The challenge package name (e.g., my-challenge or @scope/my-challenge)
+
+FLAGS
+  --pkcOptions.dataPath=<value>  Data path where challenges are installed
+
+DESCRIPTION
+  Remove an installed challenge package
+
+ALIASES
+  $ bitsocial challenge uninstall
+  $ bitsocial challenge rm
+  $ bitsocial challenge un
+
+EXAMPLES
+  $ bitsocial challenge remove my-challenge
+
+  $ bitsocial challenge remove @scope/my-challenge
+```
 
 ## `bitsocial community create`
 
@@ -423,7 +615,7 @@ EXAMPLES
     $ bitsocial community create --jsonFile ./create-options.json
 ```
 
-_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/community/create.ts)_
+_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/community/create.ts)_
 
 ## `bitsocial community delete ADDRESSES`
 
@@ -448,7 +640,7 @@ EXAMPLES
   $ bitsocial community delete 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/community/delete.ts)_
+_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/community/delete.ts)_
 
 ## `bitsocial community edit ADDRESS`
 
@@ -518,7 +710,7 @@ EXAMPLES
     $ bitsocial community edit bitsocial.bso --jsonFile ./edit-options.json
 ```
 
-_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/community/edit.ts)_
+_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/community/edit.ts)_
 
 ## `bitsocial community export [ADDRESS]`
 
@@ -559,7 +751,7 @@ EXAMPLES
   $ bitsocial community export --publicKey 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/export.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/community/export.ts)_
+_See code: [src/cli/commands/community/export.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/community/export.ts)_
 
 ## `bitsocial community get [ADDRESS]`
 
@@ -590,7 +782,7 @@ EXAMPLES
   $ bitsocial community get --publicKey 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/community/get.ts)_
+_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/community/get.ts)_
 
 ## `bitsocial community list`
 
@@ -613,7 +805,7 @@ EXAMPLES
   $ bitsocial community list
 ```
 
-_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/community/list.ts)_
+_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/community/list.ts)_
 
 ## `bitsocial community start ADDRESSES`
 
@@ -647,7 +839,7 @@ EXAMPLES
     $ bitsocial community start $(bitsocial community list -q) --concurrency 1
 ```
 
-_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/community/start.ts)_
+_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/community/start.ts)_
 
 ## `bitsocial community stop ADDRESSES`
 
@@ -672,7 +864,7 @@ EXAMPLES
   $ bitsocial community stop Qmb99crTbSUfKXamXwZBe829Vf6w5w5TktPkb6WstC9RFW
 ```
 
-_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/community/stop.ts)_
+_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/community/stop.ts)_
 
 ## `bitsocial daemon`
 
@@ -719,7 +911,7 @@ EXAMPLES
   $ bitsocial daemon --no-allowPrivateKeyExport
 ```
 
-_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/daemon.ts)_
+_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/daemon.ts)_
 
 ## `bitsocial help [COMMAND]`
 
@@ -785,7 +977,7 @@ EXAMPLES
   $ bitsocial logs --stdout -f
 ```
 
-_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/logs.ts)_
+_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/logs.ts)_
 
 ## `bitsocial update check`
 
@@ -802,7 +994,7 @@ EXAMPLES
   $ bitsocial update check
 ```
 
-_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/update/check.ts)_
+_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/update/check.ts)_
 
 ## `bitsocial update install [VERSION]`
 
@@ -834,7 +1026,7 @@ EXAMPLES
   $ bitsocial update install --no-restart-daemons
 ```
 
-_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/update/install.ts)_
+_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/update/install.ts)_
 
 ## `bitsocial update versions`
 
@@ -856,7 +1048,7 @@ EXAMPLES
   $ bitsocial update versions --limit 5
 ```
 
-_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.65/src/cli/commands/update/versions.ts)_
+_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.67/src/cli/commands/update/versions.ts)_
 <!-- commandsstop -->
 
 ## Contribution

package/dist/challenge-packages/challenge-utils.d.ts

@@ -21,4 +21,5 @@ export declare function ensureNpmAvailable(): Promise<void>;
 export declare function runNpmPack(packageSpec: string, destDir: string): Promise<string>;
 export declare function runNpmInstall(challengeDir: string): Promise<void>;
 export declare function verifyNativeModuleAbi(challengeDir: string): Promise<void>;
-export declare function loadChallengesIntoPKC(dataPath?: string): Promise<string[]>;
+export declare function formatChallengeNameVersion(challenge: Pick<InstalledChallenge, "name" | "version">): string;
+export declare function loadChallengesIntoPKC(dataPath?: string): Promise<InstalledChallenge[]>;

package/dist/challenge-packages/challenge-utils.js

@@ -285,12 +285,15 @@ export async function verifyNativeModuleAbi(challengeDir) {
             `Ensure the challenge package was built for this Node.js version.`);
     }
 }
+export function formatChallengeNameVersion(challenge) {
+    return challenge.version && challenge.version !== "unknown" ? `${challenge.name}@${challenge.version}` : challenge.name;
+}
 export async function loadChallengesIntoPKC(dataPath) {
     const challenges = await listInstalledChallenges(dataPath);
     if (challenges.length === 0)
         return [];
     const PKC = await import("@pkcprotocol/pkc-js");
-    const loadedNames = [];
+    const loaded = [];
     for (const challenge of challenges) {
         try {
             const pkg = await readChallengePackageJson(challenge.path);
@@ -300,11 +303,11 @@ export async function loadChallengesIntoPKC(dataPath) {
             const imported = await import(pathToFileURL(entryPath).href);
             const factory = imported.default || imported;
             PKC.default.challenges[challenge.name] = factory;
-            loadedNames.push(challenge.name);
+            loaded.push(challenge);
         }
         catch (err) {
             console.error(`Failed to load challenge "${challenge.name}":`, err);
         }
     }
-    return loadedNames;
+    return loaded;
 }

package/dist/cli/commands/challenge/install.d.ts

@@ -1,6 +1,7 @@
 import { Command } from "@oclif/core";
 export default class Install extends Command {
     static description: string;
+    static aliases: string[];
     static args: {
         package: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/cli/commands/challenge/install.js

@@ -6,6 +6,7 @@ import defaults from "../../../common-utils/defaults.js";
 import { ensureNpmAvailable, ensureChallengesDir, challengeNameToDir, readChallengePackageJson, runNpmPack, runNpmInstall, verifyNativeModuleAbi } from "../../../challenge-packages/challenge-utils.js";
 export default class Install extends Command {
     static description = "Install a challenge package (npm package name, git URL, tarball URL, or local path)";
+    static aliases = ["challenge:i", "challenge:add"];
     static args = {
         package: Args.string({
             description: "Package specifier — anything npm can install (name, name@version, git URL, tarball URL, local path)",
@@ -26,9 +27,9 @@ export default class Install extends Command {
         "bitsocial challenge install ./my-local-challenge"
     ];
     async run() {
+        const startTime = Date.now();
         const { args, flags } = await this.parse(Install);
         const dataPath = flags["pkcOptions.dataPath"] || defaults.PKC_DATA_PATH;
-        this.log("Installing challenge package — this may take a few minutes...");
         // 1. Check npm is available
         await ensureNpmAvailable();
         // 2. Use npm pack to download the package as a tarball
@@ -68,7 +69,16 @@ export default class Install extends Command {
             }
             // 5. Read package info
             const pkg = await readChallengePackageJson(pkgDir);
-            // 6. Check not already installed
+            // 6. Run npm install in the temp dir, so a failed install never
+            //    touches an existing working installation of the same package
+            process.stderr.write(`[challenge-install] starting npm install in ${pkgDir}\n`);
+            await runNpmInstall(pkgDir);
+            process.stderr.write("[challenge-install] npm install completed\n");
+            // 7. Verify native modules are ABI-compatible (still in the temp dir,
+            //    so failure needs no rollback — the temp dir is cleaned up below)
+            await verifyNativeModuleAbi(pkgDir);
+            // 8. Swap the verified package into the challenges dir, replacing any
+            //    existing installation (idempotent, like npm install)
             const challengesDir = await ensureChallengesDir(dataPath);
             const destDir = challengeNameToDir(challengesDir, pkg.name);
             let alreadyExists = true;
@@ -78,44 +88,30 @@ export default class Install extends Command {
             catch {
                 alreadyExists = false;
             }
-            if (alreadyExists) {
-                this.error(`Challenge "${pkg.name}" is already installed. Remove it first with: bitsocial challenge remove ${pkg.name}`);
-            }
-            // 7. Move to challenges dir
+            // Move any existing install aside (same filesystem — tmpDir lives under
+            // dataPath) so it can be restored if the final rename fails
+            const backupDir = path.join(tmpDir, "previous-install");
+            if (alreadyExists)
+                await fs.rename(destDir, backupDir);
             if (pkg.name.startsWith("@")) {
                 // Ensure scope dir exists for scoped packages
                 const scopeDir = path.dirname(destDir);
                 await fs.mkdir(scopeDir, { recursive: true });
             }
-            await fs.rename(pkgDir, destDir);
-            // 8. Run npm install
-            process.stderr.write(`[challenge-install] starting npm install in ${destDir}\n`);
-            await runNpmInstall(destDir);
-            process.stderr.write("[challenge-install] npm install completed\n");
-            // 9. Verify native modules are ABI-compatible
             try {
-                await verifyNativeModuleAbi(destDir);
+                await fs.rename(pkgDir, destDir);
             }
             catch (err) {
-                // Roll back the installation on ABI mismatch
-                await fs.rm(destDir, { recursive: true, force: true });
-                if (pkg.name.startsWith("@")) {
-                    const scopeDir = path.dirname(destDir);
-                    try {
-                        const entries = await fs.readdir(scopeDir);
-                        if (entries.length === 0)
-                            await fs.rmdir(scopeDir);
-                    }
-                    catch {
-                        // ignore
-                    }
-                }
-                this.error(err instanceof Error ? err.message : String(err));
+                // Restore the previous installation before surfacing the error
+                if (alreadyExists)
+                    await fs.rename(backupDir, destDir);
+                throw err;
             }
-            // 10. Print success
+            // 9. Print success (npm-style)
             const version = pkg.version ? `@${pkg.version}` : "";
-            this.log(`Installed challenge '${pkg.name}${version}'`);
-            // 11. Best-effort reload via daemon
+            const elapsedSeconds = Math.max(1, Math.round((Date.now() - startTime) / 1000));
+            this.log(`${alreadyExists ? "changed" : "added"} ${pkg.name}${version} in ${elapsedSeconds}s`);
+            // 10. Best-effort reload via daemon
             try {
                 await fetch("http://localhost:9138/api/challenges/reload", { method: "POST" });
             }
@@ -124,7 +120,7 @@ export default class Install extends Command {
             }
         }
         finally {
-            // 12. Clean up temp dir
+            // 11. Clean up temp dir (includes the previous-install backup, if any)
             await fs.rm(tmpDir, { recursive: true, force: true });
         }
     }

package/dist/cli/commands/challenge/list.d.ts

@@ -1,6 +1,7 @@
 import { Command } from "@oclif/core";
 export default class List extends Command {
     static description: string;
+    static aliases: string[];
     static flags: {
         quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         "pkcOptions.dataPath": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/cli/commands/challenge/list.js

@@ -1,10 +1,11 @@
 import { Flags, Command } from "@oclif/core";
 import { EOL } from "os";
-import { printTable } from "@oclif/table";
+import path from "path";
 import defaults from "../../../common-utils/defaults.js";
-import { listInstalledChallenges } from "../../../challenge-packages/challenge-utils.js";
+import { getChallengesDir, listInstalledChallenges, formatChallengeNameVersion } from "../../../challenge-packages/challenge-utils.js";
 export default class List extends Command {
     static description = "List installed challenge packages";
+    static aliases = ["challenge:ls"];
     static flags = {
         quiet: Flags.boolean({ char: "q", summary: "Only display challenge names" }),
         "pkcOptions.dataPath": Flags.directory({
@@ -16,7 +17,8 @@ export default class List extends Command {
     async run() {
         const { flags } = await this.parse(List);
         const dataPath = flags["pkcOptions.dataPath"] || defaults.PKC_DATA_PATH;
-        const challenges = await listInstalledChallenges(dataPath);
+        // Sort alphabetically like npm ls (readdir order is filesystem-dependent)
+        const challenges = (await listInstalledChallenges(dataPath)).sort((a, b) => a.name.localeCompare(b.name));
         if (challenges.length === 0) {
             this.log("No challenge packages installed.");
             return;
@@ -25,12 +27,11 @@ export default class List extends Command {
             this.log(challenges.map((c) => c.name).join(EOL));
         }
         else {
-            printTable({
-                data: challenges.map((c) => ({
-                    name: c.name,
-                    version: c.version,
-                    description: c.description
-                }))
+            // npm-ls-style tree: challenges dir header, then name@version entries
+            this.log(path.resolve(getChallengesDir(dataPath)));
+            challenges.forEach((c, i) => {
+                const branch = i === challenges.length - 1 ? "└── " : "├── ";
+                this.log(`${branch}${formatChallengeNameVersion(c)}`);
             });
         }
     }

package/dist/cli/commands/challenge/remove.d.ts

@@ -1,6 +1,7 @@
 import { Command } from "@oclif/core";
 export default class Remove extends Command {
     static description: string;
+    static aliases: string[];
     static args: {
         name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/cli/commands/challenge/remove.js

@@ -2,9 +2,10 @@ import { Args, Flags, Command } from "@oclif/core";
 import fs from "fs/promises";
 import path from "path";
 import defaults from "../../../common-utils/defaults.js";
-import { getChallengesDir, challengeNameToDir } from "../../../challenge-packages/challenge-utils.js";
+import { getChallengesDir, challengeNameToDir, readChallengePackageJson } from "../../../challenge-packages/challenge-utils.js";
 export default class Remove extends Command {
     static description = "Remove an installed challenge package";
+    static aliases = ["challenge:uninstall", "challenge:rm", "challenge:un"];
     static args = {
         name: Args.string({
             description: "The challenge package name (e.g., my-challenge or @scope/my-challenge)",
@@ -33,6 +34,16 @@ export default class Remove extends Command {
         catch {
             this.error(`Challenge "${args.name}" is not installed.`);
         }
+        // Read the installed version for the success message (best-effort)
+        let version = "";
+        try {
+            const pkg = await readChallengePackageJson(challengeDir);
+            if (pkg.version)
+                version = `@${pkg.version}`;
+        }
+        catch {
+            // unreadable package.json — report the name only
+        }
         // Remove the challenge directory
         await fs.rm(challengeDir, { recursive: true, force: true });
         // Clean up empty @scope/ dir for scoped packages
@@ -48,7 +59,7 @@ export default class Remove extends Command {
                 // ignore
             }
         }
-        this.log(`Removed challenge '${args.name}'`);
+        this.log(`removed ${args.name}${version}`);
         // Best-effort reload via daemon
         try {
             await fetch("http://localhost:9138/api/challenges/reload", { method: "POST" });