@oozou/velocity 0.1.0 → 0.1.2

package/dist/index.js

@@ -2,6 +2,7 @@
 
 // src/index.ts
 import { Command } from "commander";
+import updateNotifier from "update-notifier";
 
 // src/commands/auth.ts
 import open from "open";
@@ -177,7 +178,7 @@ var requireProjectId = async (cmd, env) => {
   const projectId = await resolveProjectId(cmd, env);
   if (!projectId) {
     throw new Error(
-      "No project selected. Pass --project <id> or run `velocity project use <id>`."
+      "No project selected. Pass --project <slug-or-id> or run `velocity projects use <slug>`."
     );
   }
   return projectId;
@@ -570,19 +571,19 @@ var registerWhoamiCommand = (program2) => {
   });
 };
 
-// src/commands/project.ts
+// src/commands/projects.ts
 var formatProjectList = (rows) => {
   if (rows.length === 0) return "No projects.\n";
   const widths = {
-    id: Math.max(2, ...rows.map((r) => r._id.length)),
+    slug: Math.max(4, ...rows.map((r) => (r.slug ?? "\u2014").length)),
     name: Math.max(4, ...rows.map((r) => r.name.length))
   };
   const lines = [
-    `${"id".padEnd(widths.id)}  ${"name".padEnd(widths.name)}  client`
+    `${"slug".padEnd(widths.slug)}  ${"name".padEnd(widths.name)}  client`
   ];
   for (const r of rows) {
     lines.push(
-      `${r._id.padEnd(widths.id)}  ${r.name.padEnd(widths.name)}  ${r.client?.name ?? ""}`
+      `${(r.slug ?? "\u2014").padEnd(widths.slug)}  ${r.name.padEnd(widths.name)}  ${r.client?.name ?? ""}`
     );
   }
   return lines.join("\n") + "\n";
@@ -599,21 +600,28 @@ var runGet = async (cmd, id) => {
   const projectId = id ?? await readActiveProject(envName);
   if (!projectId) {
     throw new Error(
-      "No project id. Pass `velocity project get <id>` or run `velocity project use <id>`."
+      "No project id. Pass `velocity projects get <id>` or run `velocity projects use <id>`."
     );
   }
   const project = await fromAuth(auth).get(`/api/v1/projects/${projectId}`);
   writeResult(cmd, project);
 };
-var runUse2 = async (cmd, id) => {
+var runUse2 = async (cmd, slugOrId) => {
   const auth = await requireAuth(cmd);
-  await fromAuth(auth).get(`/api/v1/projects/${id}`);
+  const project = await fromAuth(auth).get(
+    `/api/v1/projects/${slugOrId}`
+  );
   const envName = await resolveEnvName(cmd);
-  await writeActiveProject(envName, id);
+  await writeActiveProject(envName, project._id);
   writeResult(
     cmd,
-    { projectId: id, env: envName },
-    (v) => `Active project set to ${v.projectId} (env: ${v.env}).
+    {
+      projectId: project._id,
+      slug: project.slug,
+      name: project.name,
+      env: envName
+    },
+    (v) => `Active project set to "${v.name}" (${v.slug ?? v.projectId}) for env ${v.env}.
 `
   );
 };
@@ -624,7 +632,7 @@ var runCurrent2 = async (cmd) => {
     cmd,
     { env: envName, projectId },
     (v) => v.projectId ? `Active project: ${v.projectId} (env: ${v.env})
-` : `No active project for env "${v.env}". Run \`velocity project use <id>\`.
+` : `No active project for env "${v.env}". Run \`velocity projects use <id>\`.
 `
   );
 };
@@ -638,37 +646,37 @@ var runReset2 = async (cmd) => {
 `
   );
 };
-var registerProjectCommands = (program2) => {
-  const project = program2.command("project").description("Project listing and active-project selection");
-  project.command("list").description("List accessible projects").action(async function() {
+var registerProjectsCommands = (program2) => {
+  const projects = program2.command("projects").description("Project listing and active-project selection");
+  projects.command("list").description("List accessible projects").action(async function() {
     try {
       await runList2(this);
     } catch (err) {
       exitWithError(err, this);
     }
   });
-  project.command("get [id]").description("Show project details (defaults to the active project)").action(async function(id) {
+  projects.command("get [id]").description("Show project details (defaults to the active project)").action(async function(id) {
     try {
       await runGet(this, id);
     } catch (err) {
       exitWithError(err, this);
     }
   });
-  project.command("use <id>").description("Set the active project for the current env").action(async function(id) {
+  projects.command("use <slugOrId>").description("Set the active project for the current env (slug or id)").action(async function(id) {
     try {
       await runUse2(this, id);
     } catch (err) {
       exitWithError(err, this);
     }
   });
-  project.command("current").description("Show the active project for the current env").action(async function() {
+  projects.command("current").description("Show the active project for the current env").action(async function() {
     try {
       await runCurrent2(this);
     } catch (err) {
       exitWithError(err, this);
     }
   });
-  project.command("reset").description("Clear the active project for the current env").action(async function() {
+  projects.command("reset").description("Clear the active project for the current env").action(async function() {
     try {
       await runReset2(this);
     } catch (err) {
@@ -1261,6 +1269,52 @@ var registerProjectMetaCommands = (program2) => {
   });
 };
 
+// src/commands/update.ts
+import { spawn } from "child_process";
+var PKG = "@oozou/velocity";
+var runUpdate5 = async (cmd) => {
+  return new Promise((resolve, reject) => {
+    process.stderr.write(
+      `Updating ${PKG} via \`npm i -g ${PKG}@latest\`...
+`
+    );
+    const proc = spawn(
+      "npm",
+      ["i", "-g", `${PKG}@latest`, "--no-update-notifier"],
+      { stdio: "inherit" }
+    );
+    proc.on("error", (err) => {
+      reject(
+        new Error(
+          `Could not invoke npm: ${err.message}. Run \`npm i -g ${PKG}@latest\` manually.`
+        )
+      );
+    });
+    proc.on("exit", (code) => {
+      if (code === 0) {
+        writeResult(
+          cmd,
+          { status: "ok", package: PKG },
+          () => `Updated ${PKG} to the latest version on npm.
+`
+        );
+        resolve();
+      } else {
+        reject(new Error(`npm exited with code ${code}`));
+      }
+    });
+  });
+};
+var registerUpdateCommand = (program2) => {
+  program2.command("update").description("Update the Velocity CLI to the latest version on npm").action(async function() {
+    try {
+      await runUpdate5(this);
+    } catch (err) {
+      exitWithError(err, this);
+    }
+  });
+};
+
 // src/commands/agent-help.ts
 var HELP_TEXT = `# Velocity CLI agent guide
 
@@ -1287,7 +1341,7 @@ The Velocity CLI is a REST client over /api/v1/* with two output modes:
 Most commands need a projectId. Resolution:
 1. \`--project <id>\` flag
 2. \`VELOCITY_PROJECT\` env var
-3. The active-project file (\`velocity project use <id>\`)
+3. The active-project file (\`velocity projects use <slug>\`)
 
 ## Command tree
 
@@ -1296,9 +1350,11 @@ auth login | logout | status
 env list | current | use <name> | reset
 whoami
 
-project list
-project get [id]
-project use <id> | current | reset
+projects list
+projects get [slug-or-id]
+projects use <slug-or-id> | current | reset
+
+update                 # upgrade the CLI to the latest version on npm
 
 stories list
 stories get <number>
@@ -1359,13 +1415,25 @@ var registerAgentHelpCommand = (program2) => {
 };
 
 // src/index.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.2";
+if (process.stdout.isTTY && process.env.VELOCITY_NO_UPDATE_NOTIFIER !== "1") {
+  try {
+    updateNotifier({
+      pkg: { name: "@oozou/velocity", version: VERSION },
+      updateCheckInterval: 1e3 * 60 * 60 * 24
+    }).notify({
+      defer: false,
+      message: "Update available {currentVersion} \u2192 {latestVersion}\nRun `velocity update` or `npm i -g {packageName}@latest`"
+    });
+  } catch {
+  }
+}
 var program = new Command();
 program.name("velocity").description("CLI for Velocity").version(VERSION).option("--json", "force JSON output regardless of TTY", false).option("--human", "force human output regardless of TTY", false).option("--env <name>", "Target a named env (production, local)").option("--api-base <url>", "Override the Velocity API base URL").option("--project <id>", "Target a specific project for this invocation");
 registerAuthCommands(program);
 registerEnvCommands(program);
 registerWhoamiCommand(program);
-registerProjectCommands(program);
+registerProjectsCommands(program);
 registerStoriesCommands(program);
 registerSprintsCommands(program);
 registerReleasesCommands(program);
@@ -1373,6 +1441,7 @@ registerCommentsCommands(program);
 registerNotesCommands(program);
 registerTodosCommands(program);
 registerProjectMetaCommands(program);
+registerUpdateCommand(program);
 registerAgentHelpCommand(program);
 program.parseAsync(process.argv).catch((err) => {
   writeError(err, program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oozou/velocity",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Velocity CLI — browser-based auth + REST client for the Velocity project management API.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://velocity.oozou.com",
@@ -29,8 +29,7 @@
     "LICENSE"
   ],
   "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "access": "public"
   },
   "scripts": {
     "dev": "tsup --watch",
@@ -42,10 +41,12 @@
   "dependencies": {
     "commander": "^12.1.0",
     "env-paths": "^3.0.0",
-    "open": "^10.1.0"
+    "open": "^10.1.0",
+    "update-notifier": "^7.3.1"
   },
   "devDependencies": {
     "@types/node": "^20",
+    "@types/update-notifier": "^6.0.8",
     "@velocity/shared": "workspace:*",
     "tsup": "^8.3.5",
     "typescript": "^5.9.3"