@trackseries/cli 0.1.0-preview.2 → 0.2.0

package/README.md

@@ -34,10 +34,10 @@ After installation, authenticate and inspect the available commands:
 ```bash
 trackseries auth login
 trackseries auth status
-trackseries skill
+trackseries --skill
 ```
 
-`trackseries skill` prints version-matched instructions designed for coding agents and other automated tools.
+`trackseries --skill` prints version-matched instructions designed for coding agents and other automated tools.
 
 ## Updates
 

package/bin/trackseries.js

@@ -3,6 +3,7 @@
 import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { ensureBinary } from "../scripts/install.js";
+import { binaryRoot } from "../scripts/platform.js";
 
 let executablePath;
 try {
@@ -13,6 +14,10 @@ try {
 }
 
 const result = spawnSync(executablePath, process.argv.slice(2), {
+  env: {
+    ...process.env,
+    TRACKSERIES_CLI_BINARY_ROOT: binaryRoot()
+  },
   stdio: "inherit"
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackseries/cli",
-  "version": "0.1.0-preview.2",
+  "version": "0.2.0",
   "description": "Install and run the TrackSeries CLI.",
   "type": "module",
   "bin": {
@@ -19,6 +19,7 @@
   },
   "dependencies": {
     "fflate": "0.8.3",
+    "semver": "7.8.5",
     "tar": "7.5.22"
   },
   "publishConfig": {

package/scripts/install.js

@@ -4,8 +4,9 @@ import { tmpdir } from "node:os";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { unzipSync } from "fflate";
+import { gt, valid } from "semver";
 import { x as extractTar } from "tar";
-import { assertSupportedRuntime, binaryDirectory, releaseArtifact } from "./platform.js";
+import { assertSupportedRuntime, binaryDirectory, binaryRoot, releaseArtifact } from "./platform.js";
 
 const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const metadata = JSON.parse(await readFile(resolve(packageRoot, "package.json"), "utf8"));
@@ -54,11 +55,13 @@ async function isRegularFile(path) {
 
 export async function ensureBinary() {
   assertSupportedRuntime();
-  const artifact = releaseArtifact(metadata.version);
+  const root = binaryRoot();
+  const version = await resolveBinaryVersion(metadata.version, root);
+  const artifact = releaseArtifact(version);
   const releaseBaseUrl =
-    process.env.TRACKSERIES_CLI_RELEASE_BASE_URL ?? `https://github.com/TrackSeries/cli/releases/download/cli-v${metadata.version}`;
+    process.env.TRACKSERIES_CLI_RELEASE_BASE_URL ?? `https://github.com/TrackSeries/cli/releases/download/cli-v${version}`;
   const executableName = process.platform === "win32" ? "trackseries.exe" : "trackseries";
-  const installedExecutable = resolve(binaryDirectory(metadata.version), executableName);
+  const installedExecutable = resolve(binaryDirectory(version), executableName);
 
   if (await isRegularFile(installedExecutable)) return installedExecutable;
 
@@ -67,7 +70,7 @@ export async function ensureBinary() {
   const extractionPath = resolve(temporaryDirectory, "extracted");
   const pendingExecutable = `${installedExecutable}.${process.pid}.tmp`;
 
-  console.error(`Downloading TrackSeries CLI ${metadata.version} for ${process.platform}-${process.arch}...`);
+  console.error(`Downloading TrackSeries CLI ${version} for ${process.platform}-${process.arch}...`);
 
   try {
     const [archive, checksumFile] = await Promise.all([
@@ -119,7 +122,7 @@ export async function ensureBinary() {
   } catch (error) {
     const reason = error instanceof Error ? error.message : String(error);
     throw new Error(
-      `Unable to install TrackSeries CLI ${metadata.version}: ${reason} Download ${artifact} manually from ${releaseBaseUrl}.`,
+      `Unable to install TrackSeries CLI ${version}: ${reason} Download ${artifact} manually from ${releaseBaseUrl}.`,
       { cause: error }
     );
   } finally {
@@ -127,3 +130,22 @@ export async function ensureBinary() {
     await rm(temporaryDirectory, { force: true, recursive: true });
   }
 }
+
+export async function resolveBinaryVersion(packageVersion, root) {
+  const manifestPath = resolve(root, "current.json");
+  let manifest;
+  try {
+    manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+  } catch (error) {
+    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+      return packageVersion;
+    }
+    throw new Error(`Unable to read the TrackSeries CLI update state at ${manifestPath}.`, { cause: error });
+  }
+
+  const activeVersion = typeof manifest?.version === "string" ? valid(manifest.version) : null;
+  if (!activeVersion) {
+    throw new Error(`The TrackSeries CLI update state at ${manifestPath} contains an invalid version.`);
+  }
+  return gt(activeVersion, packageVersion) ? activeVersion : packageVersion;
+}

package/scripts/platform.js

@@ -25,6 +25,11 @@ export function assertSupportedRuntime(platform = process.platform, report = pro
 }
 
 export function binaryDirectory(version, platform = process.platform, environment = process.env, home = homedir()) {
+  const path = platform === "win32" ? win32 : posix;
+  return path.join(binaryRoot(platform, environment, home), version);
+}
+
+export function binaryRoot(platform = process.platform, environment = process.env, home = homedir()) {
   const path = platform === "win32" ? win32 : posix;
   let dataDirectory;
 
@@ -36,5 +41,5 @@ export function binaryDirectory(version, platform = process.platform, environmen
     dataDirectory = environment.XDG_DATA_HOME ?? path.join(home, ".local", "share");
   }
 
-  return path.join(dataDirectory, "trackseries", "bin", version);
+  return path.join(dataDirectory, "trackseries", "bin");
 }