Skip to content

An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.

feat: improve tm auto-update display (#1444)

Ralph Khreish77b3b7780d32
diff --git a/apps/cli/package.json b/apps/cli/package.json
index 86dbb717..4abfd97c 100644
--- a/apps/cli/package.json
+++ b/apps/cli/package.json
@@ -26,6 +26,7 @@
"@tm/core": "*",
"boxen": "^8.0.1",
"chalk": "5.6.2",
+ "cli-progress": "^3.12.0",
"cli-table3": "^0.6.5",
"commander": "^12.1.0",
"inquirer": "^12.5.0",
@@ -33,6 +34,7 @@
},
"devDependencies": {
"@biomejs/biome": "^1.9.4",
+ "@types/cli-progress": "^3.11.6",
"@types/inquirer": "^9.0.3",
"@types/node": "^22.10.5",
"@vitest/coverage-v8": "^4.0.10",
diff --git a/apps/cli/src/utils/auto-update.ts b/apps/cli/src/utils/auto-update.ts
deleted file mode 100644
index 9e661944..00000000
--- a/apps/cli/src/utils/auto-update.ts
+++ /dev/null
@@ -1,409 +0,0 @@
-/**
- * @fileoverview Auto-update utilities for task-master-ai CLI
- */
-
-import { spawn } from 'child_process';
-import https from 'https';
-import boxen from 'boxen';
-import chalk from 'chalk';
-import ora from 'ora';
-import process from 'process';
-
-export interface UpdateInfo {
- currentVersion: string;
- latestVersion: string;
- needsUpdate: boolean;
- highlights?: string[];
-}
-
-/**
- * Get current version from build-time injected environment variable
- */
-function getCurrentVersion(): string {
- // Version is injected at build time via TM_PUBLIC_VERSION
- const version = process.env.TM_PUBLIC_VERSION;
- if (version && version !== 'unknown') {
- return version;
- }
-
- // Fallback for development or if injection failed
- console.warn('Could not read version from TM_PUBLIC_VERSION, using fallback');
- return '0.0.0';
-}
-
-/**
- * Compare semantic versions with proper pre-release handling
- * @param v1 - First version
- * @param v2 - Second version
- * @returns -1 if v1 < v2, 0 if v1 = v2, 1 if v1 > v2
- */
-export function compareVersions(v1: string, v2: string): number {
- const toParts = (v: string) => {
- const [core, pre = ''] = v.split('-', 2);
- const nums = core.split('.').map((n) => Number.parseInt(n, 10) || 0);
- return { nums, pre };
- };
-
- const a = toParts(v1);
- const b = toParts(v2);
- const len = Math.max(a.nums.length, b.nums.length);
-
- // Compare numeric parts
- for (let i = 0; i < len; i++) {
- const d = (a.nums[i] || 0) - (b.nums[i] || 0);
- if (d !== 0) return d < 0 ? -1 : 1;
- }
-
- // Handle pre-release comparison
- if (a.pre && !b.pre) return -1; // prerelease < release
- if (!a.pre && b.pre) return 1; // release > prerelease
- if (a.pre === b.pre) return 0; // same or both empty
- return a.pre < b.pre ? -1 : 1; // basic prerelease tie-break
-}
-
-/**
- * Fetch CHANGELOG.md from GitHub and extract highlights for a specific version
- */
-async function fetchChangelogHighlights(version: string): Promise<string[]> {
- return new Promise((resolve) => {
- const options = {
- hostname: 'raw.githubusercontent.com',
- path: '/eyaltoledano/claude-task-master/main/CHANGELOG.md',
- method: 'GET',
- headers: {
- 'User-Agent': `task-master-ai/${version}`
- }
- };
-
- const req = https.request(options, (res) => {
- let data = '';
-
- res.on('data', (chunk) => {
- data += chunk;
- });
-
- res.on('end', () => {
- try {
- if (res.statusCode !== 200) {
- resolve([]);
- return;
- }
-
- const highlights = parseChangelogHighlights(data, version);
- resolve(highlights);
- } catch (error) {
- resolve([]);
- }
- });
- });
-
- req.on('error', () => {
- resolve([]);
- });
-
- req.setTimeout(3000, () => {
- req.destroy();
- resolve([]);
- });
-
- req.end();
- });
-}
-
-/**
- * Parse changelog markdown to extract Minor Changes for a specific version
- * @internal - Exported for testing purposes only
- */
-export function parseChangelogHighlights(
- changelog: string,
- version: string
-): string[] {
- try {
- // Validate version format (basic semver pattern) to prevent ReDoS
- if (!/^\d+\.\d+\.\d+(-[a-zA-Z0-9.-]+)?$/.test(version)) {
- return [];
- }
-
- // Find the version section
- const versionRegex = new RegExp(
- `## ${version.replace(/\./g, '\\.')}\\s*\\n`,
- 'i'
- );
- const versionMatch = changelog.match(versionRegex);
-
- if (!versionMatch) {
- return [];
- }
-
- // Extract content from this version to the next version heading
- const startIdx = versionMatch.index! + versionMatch[0].length;
- const nextVersionIdx = changelog.indexOf('\n## ', startIdx);
- const versionContent =
- nextVersionIdx > 0
- ? changelog.slice(startIdx, nextVersionIdx)
- : changelog.slice(startIdx);
-
- // Find Minor Changes section
- const minorChangesMatch = versionContent.match(
- /### Minor Changes\s*\n([\s\S]*?)(?=\n###|\n##|$)/i
- );
-
- if (!minorChangesMatch) {
- return [];
- }
-
- const minorChangesContent = minorChangesMatch[1];
- const highlights: string[] = [];
-
- // Extract all bullet points (lines starting with -)
- // Format: - [#PR](...) Thanks [@author]! - Description
- const bulletRegex = /^-\s+\[#\d+\][^\n]*?!\s+-\s+(.+?)$/gm;
- let match;
-
- while ((match = bulletRegex.exec(minorChangesContent)) !== null) {
- const desc = match[1].trim();
- highlights.push(desc);
- }
-
- return highlights;
- } catch (error) {
- return [];
- }
-}
-
-/**
- * Check for newer version of task-master-ai
- */
-export async function checkForUpdate(
- currentVersionOverride?: string
-): Promise<UpdateInfo> {
- const currentVersion = currentVersionOverride || getCurrentVersion();
-
- return new Promise((resolve) => {
- const options = {
- hostname: 'registry.npmjs.org',
- path: '/task-master-ai',
- method: 'GET',
- headers: {
- Accept: 'application/vnd.npm.install-v1+json',
- 'User-Agent': `task-master-ai/${currentVersion}`
- }
- };
-
- const req = https.request(options, (res) => {
- let data = '';
-
- res.on('data', (chunk) => {
- data += chunk;
- });
-
- res.on('end', async () => {
- try {
- if (res.statusCode !== 200)
- throw new Error(`npm registry status ${res.statusCode}`);
- const npmData = JSON.parse(data);
- const latestVersion = npmData['dist-tags']?.latest || currentVersion;
-
- const needsUpdate =
- compareVersions(currentVersion, latestVersion) < 0;
-
- // Fetch highlights if update is needed
- let highlights: string[] | undefined;
- if (needsUpdate) {
- highlights = await fetchChangelogHighlights(latestVersion);
- }
-
- resolve({
- currentVersion,
- latestVersion,
- needsUpdate,
- highlights
- });
- } catch (error) {
- resolve({
- currentVersion,
- latestVersion: currentVersion,
- needsUpdate: false
- });
- }
- });
- });
-
- req.on('error', () => {
- resolve({
- currentVersion,
- latestVersion: currentVersion,
- needsUpdate: false
- });
- });
-
- req.setTimeout(3000, () => {
- req.destroy();
- resolve({
- currentVersion,
- latestVersion: currentVersion,
- needsUpdate: false
- });
- });
-
- req.end();
- });
-}
-
-/**
- * Display upgrade notification message
- */
-export function displayUpgradeNotification(
- currentVersion: string,
- latestVersion: string,
- highlights?: string[]
-) {
- let content = `${chalk.blue.bold('Update Available!')} ${chalk.dim(currentVersion)} → ${chalk.green(latestVersion)}`;
-
- if (highlights && highlights.length > 0) {
- content += '\n\n' + chalk.bold("What's New:");
- for (const highlight of highlights) {
- content += '\n' + chalk.cyan('• ') + highlight;
- }
- content += '\n\n' + 'Auto-updating to the latest version...';
- } else {
- content +=
- '\n\n' +
- 'Auto-updating to the latest version with new features and bug fixes...';
- }
-
- const message = boxen(content, {
- padding: 1,
- margin: { top: 1, bottom: 1 },
- borderColor: 'yellow',
- borderStyle: 'round'
- });
-
- console.log(message);
-}
-
-/**
- * Automatically update task-master-ai to the latest version
- */
-export async function performAutoUpdate(
- latestVersion: string
-): Promise<boolean> {
- if (
- process.env.TASKMASTER_SKIP_AUTO_UPDATE === '1' ||
- process.env.CI ||
- process.env.NODE_ENV === 'test'
- ) {
- const reason =
- process.env.TASKMASTER_SKIP_AUTO_UPDATE === '1'
- ? 'TASKMASTER_SKIP_AUTO_UPDATE=1'
- : process.env.CI
- ? 'CI environment'
- : 'NODE_ENV=test';
- console.log(chalk.dim(`Skipping auto-update (${reason})`));
- return false;
- }
- const spinner = ora({
- text: chalk.blue(
- `Updating task-master-ai to version ${chalk.green(latestVersion)}`
- ),
- spinner: 'dots',
- color: 'blue'
- }).start();
-
- return new Promise((resolve) => {
- const updateProcess = spawn(
- 'npm',
- [
- 'install',
- '-g',
- `task-master-ai@${latestVersion}`,
- '--no-fund',
- '--no-audit',
- '--loglevel=warn'
- ],
- {
- stdio: ['ignore', 'pipe', 'pipe']
- }
- );
-
- let errorOutput = '';
-
- updateProcess.stdout.on('data', () => {
- // Update spinner text with progress
- spinner.text = chalk.blue(
- `Installing task-master-ai@${latestVersion}...`
- );
- });
-
- updateProcess.stderr.on('data', (data) => {
- errorOutput += data.toString();
- });
-
- updateProcess.on('close', (code) => {
- if (code === 0) {
- spinner.succeed(
- chalk.green(
- `Successfully updated to version ${chalk.bold(latestVersion)}`
- )
- );
- resolve(true);
- } else {
- spinner.fail(chalk.red('Auto-update failed'));
- console.log(
- chalk.cyan(
- `Please run manually: npm install -g task-master-ai@${latestVersion}`
- )
- );
- if (errorOutput) {
- console.log(chalk.dim(`Error: ${errorOutput.trim()}`));
- }
- resolve(false);
- }
- });
-
- updateProcess.on('error', (error) => {
- spinner.fail(chalk.red('Auto-update failed'));
- console.log(chalk.red('Error:'), error.message);
- console.log(
- chalk.cyan(
- `Please run manually: npm install -g task-master-ai@${latestVersion}`
- )
- );
- resolve(false);
- });
- });
-}
-
-/**
- * Restart the CLI with the newly installed version
- * @param argv - Original command-line arguments (process.argv)
- */
-export function restartWithNewVersion(argv: string[]): void {
- const args = argv.slice(2); // Remove 'node' and script path
-
- console.log(chalk.dim('Restarting with updated version...\n'));
-
- // Spawn the updated task-master command
- const child = spawn('task-master', args, {
- stdio: 'inherit', // Inherit stdin/stdout/stderr so it looks seamless
- detached: false,
- shell: process.platform === 'win32' // Windows compatibility
- });
-
- child.on('exit', (code, signal) => {
- if (signal) {
- process.kill(process.pid, signal);
- return;
- }
- process.exit(code ?? 0);
- });
-
- child.on('error', (error) => {
- console.error(
- chalk.red('Failed to restart with new version:'),
- error.message
- );
- console.log(chalk.yellow('Please run your command again manually.'));
- process.exit(1);
- });
-}
diff --git a/apps/cli/src/utils/auto-update/changelog.ts b/apps/cli/src/utils/auto-update/changelog.ts
new file mode 100644
index 00000000..66d12214
--- /dev/null
+++ b/apps/cli/src/utils/auto-update/changelog.ts
@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Changelog fetching and parsing utilities
+ */
+
+import https from 'https';
+
+/**
+ * Fetch CHANGELOG.md from GitHub and extract highlights for a specific version
+ */
+export async function fetchChangelogHighlights(
+ version: string
+): Promise<string[]> {
+ return new Promise((resolve) => {
+ const options = {
+ hostname: 'raw.githubusercontent.com',
+ path: '/eyaltoledano/claude-task-master/main/CHANGELOG.md',
+ method: 'GET',
+ headers: {
+ 'User-Agent': `task-master-ai/${version}`
+ }
+ };
+
+ const req = https.request(options, (res) => {
+ let data = '';
+
+ res.on('data', (chunk) => {
+ data += chunk;
+ });
+
+ res.on('end', () => {
+ try {
+ if (res.statusCode !== 200) {
+ resolve([]);
+ return;
+ }
+
+ const highlights = parseChangelogHighlights(data, version);
+ resolve(highlights);
+ } catch {
+ resolve([]);
+ }
+ });
+ });
+
+ req.on('error', () => {
+ resolve([]);
+ });
+
+ req.setTimeout(3000, () => {
+ req.destroy();
+ resolve([]);
+ });
+
+ req.end();
+ });
+}
+
+/**
+ * Parse changelog markdown to extract Minor Changes for a specific version
+ * @internal - Exported for testing purposes only
+ */
+export function parseChangelogHighlights(
+ changelog: string,
+ version: string
+): string[] {
+ try {
+ // Validate version format (basic semver pattern) to prevent ReDoS
+ if (!/^\d+\.\d+\.\d+(-[a-zA-Z0-9.-]+)?$/.test(version)) {
+ return [];
+ }
+
+ // Find the version section
+ const versionRegex = new RegExp(
+ `## ${version.replace(/\./g, '\\.')}\\s*\\n`,
+ 'i'
+ );
+ const versionMatch = changelog.match(versionRegex);
+
+ if (!versionMatch) {
+ return [];
+ }
+
+ // Extract content from this version to the next version heading
+ const startIdx = versionMatch.index! + versionMatch[0].length;
+ const nextVersionIdx = changelog.indexOf('\n## ', startIdx);
+ const versionContent =
+ nextVersionIdx > 0
+ ? changelog.slice(startIdx, nextVersionIdx)
+ : changelog.slice(startIdx);
+
+ // Find Minor Changes section
+ const minorChangesMatch = versionContent.match(
+ /### Minor Changes\s*\n([\s\S]*?)(?=\n###|\n##|$)/i
+ );
+
+ if (!minorChangesMatch) {
+ return [];
+ }
+
+ const minorChangesContent = minorChangesMatch[1];
+ const highlights: string[] = [];
+
+ // Extract all bullet points (lines starting with -)
+ // Format: - [#PR](...) Thanks [@author]! - Description
+ const bulletRegex = /^-\s+\[#\d+\][^\n]*?!\s+-\s+(.+?)$/gm;
+ let match;
+
+ while ((match = bulletRegex.exec(minorChangesContent)) !== null) {
+ const desc = match[1].trim();
+ highlights.push(desc);
+ }
+
+ return highlights;
+ } catch {
+ return [];
+ }
+}
diff --git a/apps/cli/src/utils/auto-update/check-update.ts b/apps/cli/src/utils/auto-update/check-update.ts
new file mode 100644
index 00000000..e624edb6
--- /dev/null
+++ b/apps/cli/src/utils/auto-update/check-update.ts
@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Check npm registry for package updates
+ */
+
+import https from 'https';
+
+import type { UpdateInfo } from './types.js';
+import { compareVersions, getCurrentVersion } from './version.js';
+import { fetchChangelogHighlights } from './changelog.js';
+
+/**
+ * Check for newer version of task-master-ai
+ */
+export async function checkForUpdate(
+ currentVersionOverride?: string
+): Promise<UpdateInfo> {
+ const currentVersion = currentVersionOverride || getCurrentVersion();
+
+ return new Promise((resolve) => {
+ const options = {
+ hostname: 'registry.npmjs.org',
+ path: '/task-master-ai',
+ method: 'GET',
+ headers: {
+ Accept: 'application/vnd.npm.install-v1+json',
+ 'User-Agent': `task-master-ai/${currentVersion}`
+ }
+ };
+
+ const req = https.request(options, (res) => {
+ let data = '';
+
+ res.on('data', (chunk) => {
+ data += chunk;
+ });
+
+ res.on('end', async () => {
+ try {
+ if (res.statusCode !== 200)
+ throw new Error(`npm registry status ${res.statusCode}`);
+ const npmData = JSON.parse(data);
+ const latestVersion = npmData['dist-tags']?.latest || currentVersion;
+
+ const needsUpdate =
+ compareVersions(currentVersion, latestVersion) < 0;
+
+ // Fetch highlights if update is needed
+ let highlights: string[] | undefined;
+ if (needsUpdate) {
+ highlights = await fetchChangelogHighlights(latestVersion);
+ }
+
+ resolve({
+ currentVersion,
+ latestVersion,
+ needsUpdate,
+ highlights
+ });
+ } catch {
+ resolve({
+ currentVersion,
+ latestVersion: currentVersion,
+ needsUpdate: false
+ });
+ }
+ });
+ });
+
+ req.on('error', () => {
+ resolve({
+ currentVersion,
+ latestVersion: currentVersion,
+ needsUpdate: false
+ });
+ });
+
+ req.setTimeout(3000, () => {
+ req.destroy();
+ resolve({
+ currentVersion,
+ latestVersion: currentVersion,
+ needsUpdate: false
+ });
+ });
+
+ req.end();
+ });
+}
diff --git a/apps/cli/src/utils/auto-update/display.ts b/apps/cli/src/utils/auto-update/display.ts
new file mode 100644
index 00000000..7276d882
--- /dev/null
+++ b/apps/cli/src/utils/auto-update/display.ts
@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Update notification display utilities
+ */
+
+import boxen from 'boxen';
+import chalk from 'chalk';
+
+/**
+ * Display upgrade notification message
+ */
+export function displayUpgradeNotification(
+ currentVersion: string,
+ latestVersion: string,
+ highlights?: string[]
+) {
+ let content = `${chalk.blue.bold('Update Available!')} ${chalk.dim(currentVersion)} → ${chalk.green(latestVersion)}`;
+
+ if (highlights && highlights.length > 0) {
+ content += '\n\n' + chalk.bold("What's New:");
+ for (const highlight of highlights) {
+ content += '\n' + chalk.cyan('• ') + highlight;
+ }
+ content += '\n\n' + 'Auto-updating to the latest version...';
+ } else {
+ content +=
+ '\n\n' +
+ 'Auto-updating to the latest version with new features and bug fixes...';
+ }
+
+ const message = boxen(content, {
+ padding: 1,
+ margin: { top: 1, bottom: 1 },
+ borderColor: 'yellow',
+ borderStyle: 'round'
+ });
+
+ console.log(message);
+}
diff --git a/apps/cli/src/utils/auto-update/download.ts b/apps/cli/src/utils/auto-update/download.ts
new file mode 100644
index 00000000..475c3a08
--- /dev/null
+++ b/apps/cli/src/utils/auto-update/download.ts
@@ -0,0 +1,213 @@
+/**
+ * @fileoverview Tarball download with progress bar
+ */
+
+import fs from 'fs';
+import https from 'https';
+
+import chalk from 'chalk';
+import cliProgress from 'cli-progress';
+
+import type { TarballInfo } from './types.js';
+
+/**
+ * Format bytes to human-readable string
+ */
+export function formatBytes(bytes: number): string {
+ if (bytes < 1024) return `${bytes} B`;
+ if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+ return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+/**
+ * Fetch tarball info (URL and size) from npm registry
+ */
+export async function fetchTarballInfo(
+ version: string
+): Promise<TarballInfo | null> {
+ return new Promise((resolve) => {
+ const options = {
+ hostname: 'registry.npmjs.org',
+ path: `/task-master-ai/${version}`,
+ method: 'GET',
+ headers: {
+ Accept: 'application/json',
+ 'User-Agent': `task-master-ai/${version}`
+ }
+ };
+
+ const req = https.request(options, (res) => {
+ let data = '';
+
+ res.on('data', (chunk) => {
+ data += chunk;
+ });
+
+ res.on('end', () => {
+ try {
+ if (res.statusCode !== 200) {
+ resolve(null);
+ return;
+ }
+
+ const packageData = JSON.parse(data);
+ const tarballUrl = packageData.dist?.tarball;
+ const unpackedSize = packageData.dist?.unpackedSize;
+
+ if (!tarballUrl) {
+ resolve(null);
+ return;
+ }
+
+ resolve({
+ url: tarballUrl,
+ size: unpackedSize || 0
+ });
+ } catch {
+ resolve(null);
+ }
+ });
+ });
+
+ req.on('error', () => {
+ resolve(null);
+ });
+
+ req.setTimeout(10000, () => {
+ req.destroy();
+ resolve(null);
+ });
+
+ req.end();
+ });
+}
+
+/**
+ * Download tarball with progress bar
+ */
+export async function downloadTarballWithProgress(
+ tarballUrl: string,
+ destPath: string,
+ version: string,
+ maxRedirects = 5
+): Promise<boolean> {
+ if (maxRedirects <= 0) {
+ console.error(chalk.red('Too many redirects'));
+ return Promise.resolve(false);
+ }
+
+ return new Promise((resolve) => {
+ const url = new URL(tarballUrl);
+
+ const options = {
+ hostname: url.hostname,
+ path: url.pathname,
+ method: 'GET',
+ headers: {
+ 'User-Agent': `task-master-ai/${version}`
+ }
+ };
+
+ const req = https.request(options, (res) => {
+ // Handle redirects
+ if (res.statusCode === 301 || res.statusCode === 302) {
+ const redirectUrl = res.headers.location;
+ if (redirectUrl) {
+ downloadTarballWithProgress(
+ redirectUrl,
+ destPath,
+ version,
+ maxRedirects - 1
+ )
+ .then(resolve)
+ .catch(() => resolve(false));
+ return;
+ }
+ resolve(false);
+ return;
+ }
+
+ if (res.statusCode !== 200) {
+ resolve(false);
+ return;
+ }
+
+ const totalSize = Number.parseInt(
+ res.headers['content-length'] || '0',
+ 10
+ );
+ let downloadedSize = 0;
+
+ // Create progress bar
+ const progressBar = new cliProgress.SingleBar(
+ {
+ format: `${chalk.blue('Downloading')} ${chalk.cyan('{bar}')} {percentage}% | {downloaded}/{total}`,
+ barCompleteChar: '\u2588',
+ barIncompleteChar: '\u2591',
+ hideCursor: true,
+ clearOnComplete: true
+ },
+ cliProgress.Presets.shades_classic
+ );
+
+ if (totalSize > 0) {
+ progressBar.start(totalSize, 0, {
+ downloaded: formatBytes(0),
+ total: formatBytes(totalSize)
+ });
+ } else {
+ // If no content-length, show indeterminate progress
+ console.log(chalk.blue(`Downloading task-master-ai@${version}...`));
+ }
+
+ const fileStream = fs.createWriteStream(destPath);
+
+ res.on('data', (chunk: Buffer) => {
+ downloadedSize += chunk.length;
+ if (totalSize > 0) {
+ progressBar.update(downloadedSize, {
+ downloaded: formatBytes(downloadedSize),
+ total: formatBytes(totalSize)
+ });
+ }
+ });
+
+ res.pipe(fileStream);
+
+ fileStream.on('finish', () => {
+ if (totalSize > 0) {
+ progressBar.stop();
+ }
+ fileStream.close(() => {
+ console.log(
+ chalk.green('✓') +
+ chalk.dim(` Downloaded ${formatBytes(downloadedSize)}`)
+ );
+ resolve(true);
+ });
+ });
+
+ fileStream.on('error', (err) => {
+ if (totalSize > 0) {
+ progressBar.stop();
+ }
+ console.error(chalk.red('Download error:'), err.message);
+ fs.unlink(destPath, () => {}); // Cleanup partial file
+ resolve(false);
+ });
+ });
+
+ req.on('error', (err) => {
+ console.error(chalk.red('Request error:'), err.message);
+ resolve(false);
+ });
+
+ req.setTimeout(120000, () => {
+ req.destroy();
+ console.error(chalk.red('Download timeout'));
+ resolve(false);
+ });
+
+ req.end();
+ });
+}
diff --git a/apps/cli/src/utils/auto-update/index.ts b/apps/cli/src/utils/auto-update/index.ts
new file mode 100644
index 00000000..e08a34c7
--- /dev/null
+++ b/apps/cli/src/utils/auto-update/index.ts
@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Auto-update utilities for task-master-ai CLI
+ *
+ * This module provides functionality for:
+ * - Checking for updates from npm registry
+ * - Downloading and installing updates with progress bar
+ * - Displaying update notifications
+ * - Restarting CLI after updates
+ */
+
+// Re-export types
+export type { UpdateInfo, TarballInfo } from './types.js';
+
+// Re-export version utilities
+export { compareVersions } from './version.js';
+
+// Re-export changelog utilities (parseChangelogHighlights exported for testing)
+export { parseChangelogHighlights } from './changelog.js';
+
+// Re-export update checking
+export { checkForUpdate } from './check-update.js';
+
+// Re-export display utilities
+export { displayUpgradeNotification } from './display.js';
+
+// Re-export installation
+export { performAutoUpdate } from './install.js';
+
+// Re-export restart functionality
+export { restartWithNewVersion } from './restart.js';
diff --git a/apps/cli/src/utils/auto-update/install.ts b/apps/cli/src/utils/auto-update/install.ts
new file mode 100644
index 00000000..c45a6a60
--- /dev/null
+++ b/apps/cli/src/utils/auto-update/install.ts
@@ -0,0 +1,381 @@
+/**
+ * @fileoverview Package installation operations
+ */
+
+import { spawn } from 'child_process';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import process from 'process';
+
+import chalk from 'chalk';
+import cliProgress from 'cli-progress';
+import ora from 'ora';
+
+import { downloadTarballWithProgress, fetchTarballInfo } from './download.js';
+
+/** Installation phases with weights (how much of the progress bar each phase takes) */
+const INSTALL_PHASES = [
+ { name: 'Extracting package', weight: 15 },
+ { name: 'Resolving dependencies', weight: 25 },
+ { name: 'Building dependency tree', weight: 20 },
+ { name: 'Linking package', weight: 25 },
+ { name: 'Finalizing installation', weight: 15 }
+];
+
+/** Total weight for percentage calculation */
+const TOTAL_WEIGHT = INSTALL_PHASES.reduce((sum, p) => sum + p.weight, 0);
+
+/**
+ * Parse npm output to determine current installation phase index
+ */
+function parseNpmPhaseIndex(output: string): number {
+ const lowerOutput = output.toLowerCase();
+
+ if (lowerOutput.includes('extract') || lowerOutput.includes('unpack')) {
+ return 0;
+ }
+ if (lowerOutput.includes('resolv') || lowerOutput.includes('fetch')) {
+ return 1;
+ }
+ if (lowerOutput.includes('build') || lowerOutput.includes('tree')) {
+ return 2;
+ }
+ if (lowerOutput.includes('link') || lowerOutput.includes('bin')) {
+ return 3;
+ }
+ if (lowerOutput.includes('added') || lowerOutput.includes('done')) {
+ return 4;
+ }
+
+ return -1;
+}
+
+/**
+ * Calculate progress percentage based on phase and sub-progress within phase
+ */
+function calculateProgress(phaseIndex: number, phaseProgress: number): number {
+ if (phaseIndex < 0 || phaseIndex >= INSTALL_PHASES.length) {
+ return phaseIndex >= INSTALL_PHASES.length ? 100 : 0;
+ }
+ let baseProgress = 0;
+ for (let i = 0; i < phaseIndex; i++) {
+ baseProgress += INSTALL_PHASES[i].weight;
+ }
+ const currentPhaseContribution =
+ (INSTALL_PHASES[phaseIndex].weight * phaseProgress) / 100;
+ return Math.round(
+ ((baseProgress + currentPhaseContribution) / TOTAL_WEIGHT) * 100
+ );
+}
+
+/**
+ * Install package from local tarball with progress bar
+ */
+async function installFromTarball(tarballPath: string): Promise<boolean> {
+ // Create progress bar
+ const progressBar = new cliProgress.SingleBar(
+ {
+ format: `${chalk.blue('Installing')} ${chalk.cyan('{bar}')} {percentage}% | {phase}`,
+ barCompleteChar: '\u2588',
+ barIncompleteChar: '\u2591',
+ hideCursor: true,
+ clearOnComplete: true
+ },
+ cliProgress.Presets.shades_classic
+ );
+
+ progressBar.start(100, 0, { phase: INSTALL_PHASES[0].name });
+
+ let currentPhaseIndex = 0;
+ let currentProgress = 0;
+ const startTime = Date.now();
+
+ // Smooth progress animation within phases
+ const progressInterval = setInterval(() => {
+ const elapsed = Date.now() - startTime;
+
+ // Estimate phase based on time (fallback when npm is silent)
+ // Assume ~10 seconds total install time, distributed by phase weights
+ const estimatedTotalTime = 10000; // 10 seconds estimate
+ let timeBasedPhase = 0;
+ let accumulatedTime = 0;
+
+ for (let i = 0; i < INSTALL_PHASES.length; i++) {
+ const phaseTime =
+ (INSTALL_PHASES[i].weight / TOTAL_WEIGHT) * estimatedTotalTime;
+ if (elapsed < accumulatedTime + phaseTime) {
+ timeBasedPhase = i;
+ break;
+ }
+ accumulatedTime += phaseTime;
+ timeBasedPhase = i;
+ }
+
+ // Use time-based phase if we haven't detected a newer phase from npm output
+ if (timeBasedPhase > currentPhaseIndex) {
+ currentPhaseIndex = timeBasedPhase;
+ }
+
+ // Calculate sub-progress within current phase (smooth animation)
+ const phaseStartTime =
+ (INSTALL_PHASES.slice(0, currentPhaseIndex).reduce(
+ (sum, p) => sum + p.weight,
+ 0
+ ) /
+ TOTAL_WEIGHT) *
+ estimatedTotalTime;
+ const phaseDuration =
+ (INSTALL_PHASES[currentPhaseIndex].weight / TOTAL_WEIGHT) *
+ estimatedTotalTime;
+ const phaseElapsed = elapsed - phaseStartTime;
+ const phaseProgress = Math.min((phaseElapsed / phaseDuration) * 100, 95); // Cap at 95% within phase
+
+ const newProgress = calculateProgress(currentPhaseIndex, phaseProgress);
+
+ // Only update if progress increased (never go backwards)
+ if (newProgress > currentProgress) {
+ currentProgress = newProgress;
+ progressBar.update(currentProgress, {
+ phase: INSTALL_PHASES[currentPhaseIndex].name
+ });
+ }
+ }, 100);
+
+ return new Promise((resolve) => {
+ const installProcess = spawn(
+ 'npm',
+ ['install', '-g', tarballPath, '--no-fund', '--no-audit'],
+ {
+ stdio: ['ignore', 'pipe', 'pipe']
+ }
+ );
+
+ let errorOutput = '';
+
+ // Parse stdout for progress hints
+ installProcess.stdout.on('data', (data) => {
+ const output = data.toString();
+ const detectedPhase = parseNpmPhaseIndex(output);
+ if (detectedPhase > currentPhaseIndex) {
+ currentPhaseIndex = detectedPhase;
+ const newProgress = calculateProgress(currentPhaseIndex, 0);
+ if (newProgress > currentProgress) {
+ currentProgress = newProgress;
+ progressBar.update(currentProgress, {
+ phase: INSTALL_PHASES[currentPhaseIndex].name
+ });
+ }
+ }
+ });
+
+ installProcess.stderr.on('data', (data) => {
+ const output = data.toString();
+ errorOutput += output;
+
+ // npm often writes progress to stderr
+ const detectedPhase = parseNpmPhaseIndex(output);
+ if (detectedPhase > currentPhaseIndex) {
+ currentPhaseIndex = detectedPhase;
+ const newProgress = calculateProgress(currentPhaseIndex, 0);
+ if (newProgress > currentProgress) {
+ currentProgress = newProgress;
+ progressBar.update(currentProgress, {
+ phase: INSTALL_PHASES[currentPhaseIndex].name
+ });
+ }
+ }
+ });
+
+ installProcess.on('close', (code) => {
+ clearInterval(progressInterval);
+
+ // Complete the progress bar
+ progressBar.update(100, { phase: 'Complete' });
+ progressBar.stop();
+
+ // Cleanup tarball
+ if (fs.existsSync(tarballPath)) {
+ fs.unlink(tarballPath, () => {});
+ }
+
+ if (code === 0) {
+ console.log(
+ chalk.green('✔') + chalk.green(' Update installed successfully')
+ );
+ resolve(true);
+ } else {
+ console.log(chalk.red('✖') + chalk.red(' Installation failed'));
+ if (errorOutput) {
+ // Only show actual errors, not progress messages
+ const actualErrors = errorOutput
+ .split('\n')
+ .filter(
+ (line) =>
+ line.includes('ERR') ||
+ line.includes('error') ||
+ line.includes('WARN')
+ )
+ .join('\n')
+ .trim();
+ if (actualErrors) {
+ console.log(chalk.dim(`Error: ${actualErrors}`));
+ }
+ }
+ resolve(false);
+ }
+ });
+
+ installProcess.on('error', (error) => {
+ clearInterval(progressInterval);
+ progressBar.stop();
+
+ // Cleanup tarball
+ fs.unlink(tarballPath, () => {});
+ console.log(chalk.red('✖') + chalk.red(' Installation failed'));
+ console.log(chalk.red('Error:'), error.message);
+ resolve(false);
+ });
+ });
+}
+
+/**
+ * Fallback: Direct npm install without progress bar
+ */
+async function performDirectNpmInstall(
+ latestVersion: string
+): Promise<boolean> {
+ const spinner = ora({
+ text: chalk.blue(
+ `Updating task-master-ai to version ${chalk.green(latestVersion)}`
+ ),
+ spinner: 'dots',
+ color: 'blue'
+ }).start();
+
+ return new Promise((resolve) => {
+ const updateProcess = spawn(
+ 'npm',
+ [
+ 'install',
+ '-g',
+ `task-master-ai@${latestVersion}`,
+ '--no-fund',
+ '--no-audit',
+ '--loglevel=warn'
+ ],
+ {
+ stdio: ['ignore', 'pipe', 'pipe']
+ }
+ );
+
+ let errorOutput = '';
+
+ updateProcess.stdout.on('data', () => {
+ spinner.text = chalk.blue(
+ `Installing task-master-ai@${latestVersion}...`
+ );
+ });
+
+ updateProcess.stderr.on('data', (data) => {
+ errorOutput += data.toString();
+ });
+
+ updateProcess.on('close', (code) => {
+ if (code === 0) {
+ spinner.succeed(
+ chalk.green(
+ `Successfully updated to version ${chalk.bold(latestVersion)}`
+ )
+ );
+ resolve(true);
+ } else {
+ spinner.fail(chalk.red('Auto-update failed'));
+ console.log(
+ chalk.cyan(
+ `Please run manually: npm install -g task-master-ai@${latestVersion}`
+ )
+ );
+ if (errorOutput) {
+ console.log(chalk.dim(`Error: ${errorOutput.trim()}`));
+ }
+ resolve(false);
+ }
+ });
+
+ updateProcess.on('error', (error) => {
+ spinner.fail(chalk.red('Auto-update failed'));
+ console.log(chalk.red('Error:'), error.message);
+ console.log(
+ chalk.cyan(
+ `Please run manually: npm install -g task-master-ai@${latestVersion}`
+ )
+ );
+ resolve(false);
+ });
+ });
+}
+
+/**
+ * Automatically update task-master-ai to the latest version
+ */
+export async function performAutoUpdate(
+ latestVersion: string
+): Promise<boolean> {
+ if (
+ process.env.TASKMASTER_SKIP_AUTO_UPDATE === '1' ||
+ process.env.CI ||
+ process.env.NODE_ENV === 'test'
+ ) {
+ const reason =
+ process.env.TASKMASTER_SKIP_AUTO_UPDATE === '1'
+ ? 'TASKMASTER_SKIP_AUTO_UPDATE=1'
+ : process.env.CI
+ ? 'CI environment'
+ : 'NODE_ENV=test';
+ console.log(chalk.dim(`Skipping auto-update (${reason})`));
+ return false;
+ }
+
+ // Fetch tarball info from npm registry
+ const tarballInfo = await fetchTarballInfo(latestVersion);
+
+ if (!tarballInfo) {
+ // Fall back to direct npm install if we can't get tarball info
+ return performDirectNpmInstall(latestVersion);
+ }
+
+ // Create temp directory for tarball
+ const tempDir = os.tmpdir();
+ const tarballPath = path.join(tempDir, `task-master-ai-${latestVersion}.tgz`);
+
+ // Download tarball with progress
+ const downloadSuccess = await downloadTarballWithProgress(
+ tarballInfo.url,
+ tarballPath,
+ latestVersion
+ );
+
+ if (!downloadSuccess) {
+ // Fall back to direct npm install on download failure
+ console.log(chalk.dim('Falling back to npm install...'));
+ return performDirectNpmInstall(latestVersion);
+ }
+
+ // Install from tarball
+ const installSuccess = await installFromTarball(tarballPath);
+
+ if (!installSuccess) {
+ console.log(
+ chalk.cyan(
+ `Please run manually: npm install -g task-master-ai@${latestVersion}`
+ )
+ );
+ return false;
+ }
+
+ console.log(
+ chalk.green(`Successfully updated to version ${chalk.bold(latestVersion)}`)
+ );
+ return true;
+}
diff --git a/apps/cli/src/utils/auto-update/restart.ts b/apps/cli/src/utils/auto-update/restart.ts
new file mode 100644
index 00000000..9806b68e
--- /dev/null
+++ b/apps/cli/src/utils/auto-update/restart.ts
@@ -0,0 +1,42 @@
+/**
+ * @fileoverview CLI restart functionality after update
+ */
+
+import { spawn } from 'child_process';
+import process from 'process';
+
+import chalk from 'chalk';
+
+/**
+ * Restart the CLI with the newly installed version
+ * @param argv - Original command-line arguments (process.argv)
+ */
+export function restartWithNewVersion(argv: string[]): void {
+ const args = argv.slice(2); // Remove 'node' and script path
+
+ console.log(chalk.dim('Restarting with updated version...\n'));
+
+ // Spawn the updated task-master command
+ const child = spawn('task-master', args, {
+ stdio: 'inherit', // Inherit stdin/stdout/stderr so it looks seamless
+ detached: false,
+ shell: process.platform === 'win32' // Windows compatibility
+ });
+
+ child.on('exit', (code, signal) => {
+ if (signal) {
+ process.kill(process.pid, signal);
+ return;
+ }
+ process.exit(code ?? 0);
+ });
+
+ child.on('error', (error) => {
+ console.error(
+ chalk.red('Failed to restart with new version:'),
+ error.message
+ );
+ console.log(chalk.yellow('Please run your command again manually.'));
+ process.exit(1);
+ });
+}
diff --git a/apps/cli/src/utils/auto-update/types.ts b/apps/cli/src/utils/auto-update/types.ts
new file mode 100644
index 00000000..0ba0c0e2
--- /dev/null
+++ b/apps/cli/src/utils/auto-update/types.ts
@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Type definitions for auto-update functionality
+ */
+
+export interface UpdateInfo {
+ currentVersion: string;
+ latestVersion: string;
+ needsUpdate: boolean;
+ highlights?: string[];
+}
+
+export interface TarballInfo {
+ url: string;
+ size: number;
+}
diff --git a/apps/cli/src/utils/auto-update/version.ts b/apps/cli/src/utils/auto-update/version.ts
new file mode 100644
index 00000000..dc2e311f
--- /dev/null
+++ b/apps/cli/src/utils/auto-update/version.ts
@@ -0,0 +1,50 @@
+/**
+ * @fileoverview Version comparison and retrieval utilities
+ */
+
+import process from 'process';
+
+/**
+ * Get current version from build-time injected environment variable
+ */
+export function getCurrentVersion(): string {
+ // Version is injected at build time via TM_PUBLIC_VERSION
+ const version = process.env.TM_PUBLIC_VERSION;
+ if (version && version !== 'unknown') {
+ return version;
+ }
+
+ // Fallback for development or if injection failed
+ console.warn('Could not read version from TM_PUBLIC_VERSION, using fallback');
+ return '0.0.0';
+}
+
+/**
+ * Compare semantic versions with proper pre-release handling
+ * @param v1 - First version
+ * @param v2 - Second version
+ * @returns -1 if v1 < v2, 0 if v1 = v2, 1 if v1 > v2
+ */
+export function compareVersions(v1: string, v2: string): number {
+ const toParts = (v: string) => {
+ const [core, pre = ''] = v.split('-', 2);
+ const nums = core.split('.').map((n) => Number.parseInt(n, 10) || 0);
+ return { nums, pre };
+ };
+
+ const a = toParts(v1);
+ const b = toParts(v2);
+ const len = Math.max(a.nums.length, b.nums.length);
+
+ // Compare numeric parts
+ for (let i = 0; i < len; i++) {
+ const d = (a.nums[i] || 0) - (b.nums[i] || 0);
+ if (d !== 0) return d < 0 ? -1 : 1;
+ }
+
+ // Handle pre-release comparison
+ if (a.pre && !b.pre) return -1; // prerelease < release
+ if (!a.pre && b.pre) return 1; // release > prerelease
+ if (a.pre === b.pre) return 0; // same or both empty
+ return a.pre < b.pre ? -1 : 1; // basic prerelease tie-break
+}
diff --git a/apps/cli/src/utils/index.ts b/apps/cli/src/utils/index.ts
index e47218eb..71bce819 100644
--- a/apps/cli/src/utils/index.ts
+++ b/apps/cli/src/utils/index.ts
@@ -28,7 +28,7 @@ export {
displayUpgradeNotification,
compareVersions,
restartWithNewVersion
-} from './auto-update.js';
+} from './auto-update/index.js';
// Display helpers (command-specific helpers)
export { displayCommandHeader } from './display-helpers.js';
diff --git a/package-lock.json b/package-lock.json
index 9e8effb8..fa611b73 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -117,6 +117,7 @@
"@tm/core": "*",
"boxen": "^8.0.1",
"chalk": "5.6.2",
+ "cli-progress": "^3.12.0",
"cli-table3": "^0.6.5",
"commander": "^12.1.0",
"inquirer": "^12.5.0",
@@ -124,6 +125,7 @@
},
"devDependencies": {
"@biomejs/biome": "^1.9.4",
+ "@types/cli-progress": "^3.11.6",
"@types/inquirer": "^9.0.3",
"@types/node": "^22.10.5",
"@vitest/coverage-v8": "^4.0.10",
@@ -12082,6 +12084,16 @@
"assertion-error": "^2.0.1"
}
},
+ "node_modules/@types/cli-progress": {
+ "version": "3.11.6",
+ "resolved": "https://registry.npmjs.org/@types/cli-progress/-/cli-progress-3.11.6.tgz",
+ "integrity": "sha512-cE3+jb9WRlu+uOSAugewNpITJDt1VF8dHOopPO4IABFc3SXYL5WE/+PTz/FCdZRRfIujiWW3n3aMbv1eIGVRWA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@types/node": "*"
+ }
+ },
"node_modules/@types/cors": {
"version": "2.8.19",
"resolved": "https://registry.npmjs.org/@types/cors/-/cors-2.8.19.tgz",
diff --git a/tests/unit/commands.test.js b/tests/unit/commands.test.js
index d29292a3..89f26269 100644
--- a/tests/unit/commands.test.js
+++ b/tests/unit/commands.test.js
@@ -91,12 +91,16 @@ jest.mock('../../scripts/modules/utils.js', () => ({
// Import all modules after mocking
import fs from 'fs';
import path from 'path';
+import { compareVersions } from '@tm/cli';
+import {
+ displayUpgradeNotification,
+ parseChangelogHighlights
+} from '../../apps/cli/src/utils/auto-update/index.js';
import { setupCLI } from '../../scripts/modules/commands.js';
import {
- RULES_SETUP_ACTION,
- RULES_ACTIONS
+ RULES_ACTIONS,
+ RULES_SETUP_ACTION
} from '../../src/constants/rules-actions.js';
-import { compareVersions } from '@tm/cli';
describe('Commands Module - CLI Setup and Integration', () => {
const mockExistsSync = jest.spyOn(fs, 'existsSync');
@@ -278,17 +282,8 @@ describe('Version comparison utility', () => {
});
describe('Update check functionality', () => {
- let displayUpgradeNotification;
- let parseChangelogHighlights;
let consoleLogSpy;
- beforeAll(async () => {
- // Import from @tm/cli instead of commands.js
- const cliModule = await import('../../apps/cli/src/utils/auto-update.js');
- displayUpgradeNotification = cliModule.displayUpgradeNotification;
- parseChangelogHighlights = cliModule.parseChangelogHighlights;
- });
-
beforeEach(() => {
consoleLogSpy = jest.spyOn(console, 'log').mockImplementation(() => {});
});