Understand any codebase instantly. System intelligence for codebases, built for humans and AI.
TypeScript aiai-memoryclaude-codeclicode-analysiscode-mappingcode-memorycodebase-understandingcodexdeveloper-toolsllmopenclawpersistent-memoryprogram-analysissoftware-architecturesystem-intelligencesystem-mapping
feat: track memory-layer and compass versions in upgrade command
Tanner Kocher5285e78c57f7
diff --git a/ix-cli/package.json b/ix-cli/package.jsonindex 6f2c4f3f..7c7dbfd2 100644--- a/ix-cli/package.json+++ b/ix-cli/package.json@@ -1,6 +1,6 @@{"name": "@ix/cli",- "version": "0.5.0",+ "version": "0.5.1","type": "module","description": "Ix Memory — Persistent Memory for LLM Systems","main": "dist/index.js",diff --git a/ix-cli/src/cli/commands/upgrade.ts b/ix-cli/src/cli/commands/upgrade.tsindex 8e959888..b6b8af68 100644--- a/ix-cli/src/cli/commands/upgrade.ts+++ b/ix-cli/src/cli/commands/upgrade.ts@@ -12,14 +12,17 @@ const __dirname = dirname(__filename);const GITHUB_ORG = "ix-infrastructure";const GITHUB_REPO = "Ix";const COMPASS_DIST_REPO = "ix-compass-dist";+const MEMORY_LAYER_DIST_REPO = "ix-memory-layer-dist";const IX_HOME = process.env.IX_HOME || join(homedir(), ".ix");const VERSION_CACHE = join(IX_HOME, ".version-check.json");const COMPASS_DIR = join(IX_HOME, "cli", "compass");const COMPASS_VERSION_FILE = join(COMPASS_DIR, ".version");+const BACKEND_VERSION_FILE = join(IX_HOME, ".backend-version");interface VersionCache {latest: string;compassLatest?: string;+ backendLatest?: string;checkedAt: number;}@@ -34,10 +37,10 @@ function getCurrentVersion(): string {}}-async function fetchLatestVersion(): Promise<string | null> {+async function fetchLatestRelease(repo: string): Promise<string | null> {try {const resp = await fetch(- `https://api.github.com/repos/${GITHUB_ORG}/${GITHUB_REPO}/releases/latest`+ `https://api.github.com/repos/${GITHUB_ORG}/${repo}/releases/latest`);if (!resp.ok) return null;const data = (await resp.json()) as { tag_name?: string };@@ -56,11 +59,12 @@ function readCache(): VersionCache | null {}}-function writeCache(latest: string, compassLatest?: string): void {+function writeCache(latest: string, compassLatest?: string, backendLatest?: string): void {try {mkdirSync(IX_HOME, { recursive: true });const data: VersionCache = { latest, checkedAt: Date.now() };if (compassLatest) data.compassLatest = compassLatest;+ if (backendLatest) data.backendLatest = backendLatest;writeFileSync(VERSION_CACHE, JSON.stringify(data));} catch {// non-critical@@ -77,28 +81,15 @@ function isNewer(latest: string, current: string): boolean {return false;}-function getCompassVersion(): string {+function getTrackedVersion(versionFile: string): string {try {- if (!existsSync(COMPASS_VERSION_FILE)) return "0.0.0";- return readFileSync(COMPASS_VERSION_FILE, "utf-8").trim() || "0.0.0";+ if (!existsSync(versionFile)) return "0.0.0";+ return readFileSync(versionFile, "utf-8").trim() || "0.0.0";} catch {return "0.0.0";}}-async function fetchLatestCompassVersion(): Promise<string | null> {- try {- const resp = await fetch(- `https://api.github.com/repos/${GITHUB_ORG}/${COMPASS_DIST_REPO}/releases/latest`- );- if (!resp.ok) return null;- const data = (await resp.json()) as { tag_name?: string };- return data.tag_name?.replace(/^v/, "") ?? null;- } catch {- return null;- }-}-function detectPlatform(): string {let os: string;if (process.platform === "darwin") os = "darwin";@@ -118,36 +109,43 @@ export async function checkForUpdate(): Promise<void> {if (cache && Date.now() - cache.checkedAt < 3600_000) {const hasCliUpdate = isNewer(cache.latest, current);- const compassCurrent = getCompassVersion();+ const compassCurrent = getTrackedVersion(COMPASS_VERSION_FILE);const hasCompassUpdate =- compassCurrent !== "0.0.0" &&cache.compassLatest && isNewer(cache.compassLatest, compassCurrent);- if (hasCliUpdate || hasCompassUpdate) {- printUpdateNotice(current, cache.latest, !!hasCompassUpdate);+ const backendCurrent = getTrackedVersion(BACKEND_VERSION_FILE);+ const hasBackendUpdate =+ cache.backendLatest && isNewer(cache.backendLatest, backendCurrent);+ if (hasCliUpdate || hasCompassUpdate || hasBackendUpdate) {+ printUpdateNotice(current, cache.latest, !!hasCompassUpdate, !!hasBackendUpdate);}return;}- Promise.all([fetchLatestVersion(), fetchLatestCompassVersion()]).then(- ([latest, compassLatest]) => {- if (!latest) return;- writeCache(latest, compassLatest ?? undefined);- const compassCurrent = getCompassVersion();- const hasCliUpdate = isNewer(latest, current);- const hasCompassUpdate =- compassCurrent !== "0.0.0" &&- compassLatest && isNewer(compassLatest, compassCurrent);- if (hasCliUpdate || hasCompassUpdate) {- printUpdateNotice(current, latest, hasCompassUpdate ? true : false);- }+ Promise.all([+ fetchLatestRelease(GITHUB_REPO),+ fetchLatestRelease(COMPASS_DIST_REPO),+ fetchLatestRelease(MEMORY_LAYER_DIST_REPO),+ ]).then(([latest, compassLatest, backendLatest]) => {+ if (!latest) return;+ writeCache(latest, compassLatest ?? undefined, backendLatest ?? undefined);+ const hasCliUpdate = isNewer(latest, current);+ const compassCurrent = getTrackedVersion(COMPASS_VERSION_FILE);+ const hasCompassUpdate =+ compassLatest && isNewer(compassLatest, compassCurrent);+ const backendCurrent = getTrackedVersion(BACKEND_VERSION_FILE);+ const hasBackendUpdate =+ backendLatest && isNewer(backendLatest, backendCurrent);+ if (hasCliUpdate || hasCompassUpdate || hasBackendUpdate) {+ printUpdateNotice(current, latest, !!hasCompassUpdate, !!hasBackendUpdate);}- );+ });}function printUpdateNotice(current: string,latest: string,- compassUpdate?: boolean+ compassUpdate?: boolean,+ backendUpdate?: boolean): void {process.stderr.write("\r" + " ".repeat(80) + "\r");console.error("");@@ -157,6 +155,9 @@ function printUpdateNotice(if (compassUpdate) {console.error(chalk.yellow(" Compass update available"));}+ if (backendUpdate) {+ console.error(chalk.yellow(" Backend update available"));+ }console.error(chalk.dim(" Run: ix upgrade"));console.error("");}@@ -164,188 +165,200 @@ function printUpdateNotice(export function registerUpgradeCommand(program: Command): void {program.command("upgrade")- .description("Upgrade ix CLI and backend to the latest version")+ .description("Upgrade ix CLI, backend, and components to the latest version").option("--check", "Only check for updates, don't install").action(async (opts: { check?: boolean }) => {const current = getCurrentVersion();console.log(`Current version: ${current}`);console.log("Checking for updates...");- const latest = await fetchLatestVersion();+ const [latest, compassLatest, backendLatest] = await Promise.all([+ fetchLatestRelease(GITHUB_REPO),+ fetchLatestRelease(COMPASS_DIST_REPO),+ fetchLatestRelease(MEMORY_LAYER_DIST_REPO),+ ]);+if (!latest) {console.error("[error] Could not reach GitHub to check for updates.");process.exit(1);}- writeCache(latest);-+ // ── CLI upgrade ──────────────────────────────────────────────────const cliUpToDate = !isNewer(latest, current);if (cliUpToDate) {console.log(`[ok] CLI already on the latest version (${current})`);- }-- if (!cliUpToDate) {- console.log(`New version available: ${chalk.green(latest)}`);-- if (!opts.check) {+ } else {+ console.log(`New CLI version available: ${chalk.green(latest)}`);- const platform = detectPlatform();- const isWindows = platform.startsWith("windows");- const archiveName = isWindows- ? `ix-${latest}-${platform}.zip`- : `ix-${latest}-${platform}.tar.gz`;- const url = `https://github.com/${GITHUB_ORG}/${GITHUB_REPO}/releases/download/v${latest}/${archiveName}`;- const installDir = join(IX_HOME, "cli");+ if (!opts.check) {+ const platform = detectPlatform();+ const isWindows = platform.startsWith("windows");+ const archiveName = isWindows+ ? `ix-${latest}-${platform}.zip`+ : `ix-${latest}-${platform}.tar.gz`;+ const url = `https://github.com/${GITHUB_ORG}/${GITHUB_REPO}/releases/download/v${latest}/${archiveName}`;+ const installDir = join(IX_HOME, "cli");- // Use secure temp directory- // Keep Windows paths for curl/Node (which use Windows curl/fs),- // convert to Unix paths only for bash tools (unzip)- const tmpDirRaw = mkdtempSync(join(tmpdir(), "ix-upgrade-"));- const tmpFile = join(tmpDirRaw, archiveName);+ const tmpDirRaw = mkdtempSync(join(tmpdir(), "ix-upgrade-"));+ const tmpFile = join(tmpDirRaw, archiveName);- console.log(`Downloading ix ${latest} for ${platform}...`);+ console.log(`Downloading ix ${latest} for ${platform}...`);- try {- execFileSync(- "curl",- ["-fsSL", "--progress-bar", url, "-o", tmpFile],- { stdio: ["ignore", "inherit", "inherit"], timeout: 300000 }- );- } catch {- console.error(`[error] Failed to download ${url}`);- console.error(" You can also upgrade manually:");- console.error(- ` curl -fsSL https://raw.githubusercontent.com/${GITHUB_ORG}/${GITHUB_REPO}/main/scripts/install/install.sh | bash`- );- rmSync(tmpDirRaw, { recursive: true, force: true });- process.exit(1);- }+ try {+ execFileSync(+ "curl",+ ["-fsSL", "--progress-bar", url, "-o", tmpFile],+ { stdio: ["ignore", "inherit", "inherit"], timeout: 300000 }+ );+ } catch {+ console.error(`[error] Failed to download ${url}`);+ console.error(" You can also upgrade manually:");+ console.error(+ ` curl -fsSL https://raw.githubusercontent.com/${GITHUB_ORG}/${GITHUB_REPO}/main/scripts/install/install.sh | bash`+ );+ rmSync(tmpDirRaw, { recursive: true, force: true });+ process.exit(1);+ }- console.log("Installing...");- try {- rmSync(installDir, { recursive: true, force: true });- mkdirSync(installDir, { recursive: true });- if (isWindows) {- let unixTmpFile = tmpFile;- let unixInstallDir = installDir;+ console.log("Installing...");try {- unixTmpFile = execFileSync("cygpath", ["-u", tmpFile], { encoding: "utf-8" }).trim();- unixInstallDir = execFileSync("cygpath", ["-u", installDir], { encoding: "utf-8" }).trim();- } catch { /* use as-is */ }- execFileSync("unzip", ["-q", unixTmpFile, "-d", unixInstallDir], { stdio: "ignore" });- } else {- execFileSync(- "tar",- ["-xzf", tmpFile, "-C", installDir, "--strip-components=1"],- { stdio: "ignore" }- );- }- rmSync(tmpDirRaw, { recursive: true, force: true });- } catch {- console.error("[error] Failed to extract CLI update.");- rmSync(tmpDirRaw, { recursive: true, force: true });- process.exit(1);- }+ rmSync(installDir, { recursive: true, force: true });+ mkdirSync(installDir, { recursive: true });+ if (isWindows) {+ let unixTmpFile = tmpFile;+ let unixInstallDir = installDir;+ try {+ unixTmpFile = execFileSync("cygpath", ["-u", tmpFile], { encoding: "utf-8" }).trim();+ unixInstallDir = execFileSync("cygpath", ["-u", installDir], { encoding: "utf-8" }).trim();+ } catch { /* use as-is */ }+ execFileSync("unzip", ["-q", unixTmpFile, "-d", unixInstallDir], { stdio: "ignore" });+ } else {+ execFileSync(+ "tar",+ ["-xzf", tmpFile, "-C", installDir, "--strip-components=1"],+ { stdio: "ignore" }+ );+ }+ rmSync(tmpDirRaw, { recursive: true, force: true });+ } catch {+ console.error("[error] Failed to extract CLI update.");+ rmSync(tmpDirRaw, { recursive: true, force: true });+ process.exit(1);+ }- // On Windows, update the shim to point to the new versioned directory- if (isWindows) {- const shimPath = join(homedir(), ".local", "bin", "ix");- const jsPathWin = join(installDir, `ix-${latest}-${platform}`, "cli", "dist", "cli", "main.js");- let jsPath = jsPathWin;- try {- jsPath = execFileSync("cygpath", ["-u", jsPathWin], { encoding: "utf-8" }).trim();- } catch { /* use windows path */ }- if (existsSync(shimPath)) {- writeFileSync(shimPath, `#!/usr/bin/env bash\nexec node "${jsPath}" "$@"\n`);+ // On Windows, update the shim to point to the new versioned directory+ if (isWindows) {+ const shimPath = join(homedir(), ".local", "bin", "ix");+ const jsPathWin = join(installDir, `ix-${latest}-${platform}`, "cli", "dist", "cli", "main.js");+ let jsPath = jsPathWin;+ try {+ jsPath = execFileSync("cygpath", ["-u", jsPathWin], { encoding: "utf-8" }).trim();+ } catch { /* use windows path */ }+ if (existsSync(shimPath)) {+ writeFileSync(shimPath, `#!/usr/bin/env bash\nexec node "${jsPath}" "$@"\n`);+ }+ }++ console.log(`[ok] Upgraded ix: ${current} → ${latest}`);}}- console.log(`[ok] Upgraded ix: ${current} → ${latest}`);-- console.log("Pulling latest backend image...");- try {- execFileSync(- "docker",- ["pull", "ghcr.io/ix-infrastructure/ix-memory-layer:latest"],- { stdio: "inherit", timeout: 120000 }+ // ── Backend (memory-layer) upgrade ───────────────────────────────+ const backendCurrent = getTrackedVersion(BACKEND_VERSION_FILE);+ if (backendLatest && isNewer(backendLatest, backendCurrent)) {+ console.log(+ `Backend update available: ${backendCurrent === "0.0.0" ? "none" : backendCurrent} → ${chalk.green(backendLatest)}`);- console.log("[ok] Backend image updated");- } catch {- console.error("[!!] Could not pull latest backend image. Run: ix docker restart");- }- // Restart backend if running- try {- execFileSync("curl", ["-sf", "http://localhost:8090/v1/health"], {- stdio: "ignore",- timeout: 3000,- });- console.log("Restarting backend...");- const composeFile = join(IX_HOME, "backend", "docker-compose.yml");- if (existsSync(composeFile)) {- execFileSync(- "docker",- ["compose", "-f", composeFile, "up", "-d", "--pull", "always"],- { stdio: "inherit" }- );- console.log("[ok] Backend restarted with latest image");+ if (!opts.check) {+ console.log("Pulling latest backend image...");+ try {+ execFileSync(+ "docker",+ ["pull", "ghcr.io/ix-infrastructure/ix-memory-layer:latest"],+ { stdio: "inherit", timeout: 120000 }+ );+ mkdirSync(IX_HOME, { recursive: true });+ writeFileSync(BACKEND_VERSION_FILE, backendLatest);+ console.log(`[ok] Backend image updated to ${backendLatest}`);+ } catch {+ console.error("[!!] Could not pull latest backend image. Run: ix docker restart");+ }++ // Restart backend if running+ try {+ execFileSync("curl", ["-sf", "http://localhost:8090/v1/health"], {+ stdio: "ignore",+ timeout: 3000,+ });+ console.log("Restarting backend...");+ const composeFile = join(IX_HOME, "backend", "docker-compose.yml");+ if (existsSync(composeFile)) {+ execFileSync(+ "docker",+ ["compose", "-f", composeFile, "up", "-d", "--pull", "always"],+ { stdio: "inherit" }+ );+ console.log("[ok] Backend restarted with latest image");+ }+ } catch {+ // Backend not running, that's fine+ }}- } catch {- // Backend not running, that's fine+ } else if (backendLatest) {+ console.log(`[ok] Backend already on the latest version (${backendCurrent})`);+ } else {+ console.log("[--] Could not check backend version");}- } // end if !opts.check- } // end if !cliUpToDate-// ── Compass upgrade ──────────────────────────────────────────────- console.log("Checking for compass updates...");- const compassCurrent = getCompassVersion();- const compassLatest = await fetchLatestCompassVersion();-+ const compassCurrent = getTrackedVersion(COMPASS_VERSION_FILE);if (compassLatest && isNewer(compassLatest, compassCurrent)) {console.log(`Compass update available: ${compassCurrent === "0.0.0" ? "none" : compassCurrent} → ${chalk.green(compassLatest)}`);- const compassUrl = `https://github.com/${GITHUB_ORG}/${COMPASS_DIST_REPO}/releases/download/v${compassLatest}/compass-${compassLatest}.tar.gz`;- const compassTmp = mkdtempSync(join(tmpdir(), "ix-compass-"));- const compassTar = join(compassTmp, `compass-${compassLatest}.tar.gz`);-- try {- execFileSync("curl", ["-fsSL", compassUrl, "-o", compassTar], {- stdio: ["ignore", "inherit", "inherit"],- timeout: 60000,- });- mkdirSync(COMPASS_DIR, { recursive: true });- // Clear old compass files, then extract new ones- rmSync(COMPASS_DIR, { recursive: true, force: true });- mkdirSync(COMPASS_DIR, { recursive: true });- // On Windows/MINGW, convert paths for tar- let tarFile = compassTar;- let tarDest = COMPASS_DIR;- if (process.platform === "win32") {- try {- tarFile = execFileSync("cygpath", ["-u", compassTar], { encoding: "utf-8" }).trim();- tarDest = execFileSync("cygpath", ["-u", COMPASS_DIR], { encoding: "utf-8" }).trim();- } catch { /* use as-is */ }++ if (!opts.check) {+ const compassUrl = `https://github.com/${GITHUB_ORG}/${COMPASS_DIST_REPO}/releases/download/v${compassLatest}/compass-${compassLatest}.tar.gz`;+ const compassTmp = mkdtempSync(join(tmpdir(), "ix-compass-"));+ const compassTar = join(compassTmp, `compass-${compassLatest}.tar.gz`);++ try {+ execFileSync("curl", ["-fsSL", compassUrl, "-o", compassTar], {+ stdio: ["ignore", "inherit", "inherit"],+ timeout: 60000,+ });+ mkdirSync(COMPASS_DIR, { recursive: true });+ rmSync(COMPASS_DIR, { recursive: true, force: true });+ mkdirSync(COMPASS_DIR, { recursive: true });+ let tarFile = compassTar;+ let tarDest = COMPASS_DIR;+ if (process.platform === "win32") {+ try {+ tarFile = execFileSync("cygpath", ["-u", compassTar], { encoding: "utf-8" }).trim();+ tarDest = execFileSync("cygpath", ["-u", COMPASS_DIR], { encoding: "utf-8" }).trim();+ } catch { /* use as-is */ }+ }+ execFileSync(+ "tar",+ ["-xzf", tarFile, "-C", tarDest, "--strip-components=1"],+ { stdio: "ignore" }+ );+ writeFileSync(COMPASS_VERSION_FILE, compassLatest);+ console.log(`[ok] Compass upgraded to ${compassLatest}`);+ } catch {+ console.error("[!!] Could not download compass update. ix view may use the bundled version.");}- execFileSync(- "tar",- ["-xzf", tarFile, "-C", tarDest, "--strip-components=1"],- { stdio: "ignore" }- );- writeFileSync(COMPASS_VERSION_FILE, compassLatest);- console.log(`[ok] Compass upgraded to ${compassLatest}`);- } catch {- console.error("[!!] Could not download compass update. ix view may use the bundled version.");+ rmSync(compassTmp, { recursive: true, force: true });}- rmSync(compassTmp, { recursive: true, force: true });} else if (compassLatest) {- console.log(`[ok] Compass is up to date (${compassCurrent})`);+ console.log(`[ok] Compass already on the latest version (${compassCurrent})`);} else {console.log("[--] Could not check compass version");}- if (compassLatest) writeCache(latest, compassLatest);+ // ── Update cache with all latest versions ────────────────────────+ writeCache(latest, compassLatest ?? undefined, backendLatest ?? undefined);console.log("");console.log("[ok] ix is up to date");