antigravity-rtl-patcher 2.3.3 → 2.3.4

package/README.md

@@ -8,21 +8,39 @@ Smart RTL and Persian/Arabic typography support for the [Antigravity](https://an
 
 ---
 
-## Install
+## ⚡ Quick Install
+
+Always use `@latest` to ensure you get the newest version:
 
 ```bash
-npx antigravity-rtl-patcher patch
+npx antigravity-rtl-patcher@latest patch
 ```
 
 If Antigravity is installed in a system directory, use `sudo`:
 
 ```bash
-sudo npx antigravity-rtl-patcher patch
+sudo npx antigravity-rtl-patcher@latest patch
 ```
 
 Restart Antigravity after patching.
 
-## Uninstall
+## 🔄 Update to Latest Version
+
+To ensure you're always using the latest version, run:
+
+```bash
+npx antigravity-rtl-patcher@latest patch
+```
+
+Or check for updates manually:
+
+```bash
+npx antigravity-rtl-patcher@latest update
+```
+
+The patcher will automatically notify you when a new version is available.
+
+## 🗑️ Uninstall
 
 ```bash
 npx antigravity-rtl-patcher restore
@@ -30,16 +48,18 @@ npx antigravity-rtl-patcher restore
 
 This restores the original `app.asar` from the backup created during patching.
 
-## Commands
+## 📋 Commands
 
 | Command | Description |
 |---|---|
 | `agy-rtl patch` | Apply RTL patch |
 | `agy-rtl restore` | Remove patch, restore original |
 | `agy-rtl status` | Show current patch status |
+| `agy-rtl update` | Check for updates |
 | `agy-rtl patch --path /custom/path` | Patch a custom installation |
+| `agy-rtl patch --skip-update-check` | Skip update check during patching |
 
-## How it works
+## 🔧 How it works
 
 Antigravity is an Electron app. The patcher extracts `app.asar`, appends an RTL engine to the preload script, and repacks the archive. The engine uses a `MutationObserver` to detect Persian, Arabic, and Hebrew text in real-time and applies `direction: rtl` where needed.
 
@@ -53,15 +73,17 @@ After patching, an RTL icon appears at the bottom of the Antigravity window. Cli
 - Preserves LTR direction for code blocks inside RTL text
 - Provides a toggle UI to enable/disable at any time
 
-## After Antigravity updates
+## 🔄 After Antigravity updates
 
 Updates may overwrite the patch. Run the patch command again:
 
 ```bash
-npx antigravity-rtl-patcher patch
+npx antigravity-rtl-patcher@latest patch
 ```
 
-## Supported platforms
+**Pro tip:** Always use `@latest` flag to ensure you're patching with the newest version of the patcher.
+
+## 💻 Supported platforms
 
 | Platform | Typical install locations |
 |---|---|
@@ -71,10 +93,10 @@ npx antigravity-rtl-patcher patch
 
 Custom paths are supported via `--path`.
 
-## Contributing
+## 🤝 Contributing
 
 Issues and pull requests are welcome at [github.com/VaFa1726/antigravity-rtl-patcher](https://github.com/VaFa1726/antigravity-rtl-patcher).
 
-## License
+## 📄 License
 
 MIT

package/bin/cli.js

@@ -3,24 +3,26 @@
 const { program } = require('commander');
 const chalk = require('chalk');
 const { patch, restore, status } = require('../src/patcher');
+const { checkForUpdates, showUpdateInstructions, currentVersion } = require('../src/version-checker');
 
 const BANNER = `
-${chalk.cyan('Antigravity Smart RTL Patcher')} ${chalk.gray('v2.3.3')}
+${chalk.cyan('Antigravity Smart RTL Patcher')} ${chalk.gray('v' + currentVersion)}
 `;
 
 program
   .name('agy-rtl')
   .description('RTL patcher for Antigravity')
-  .version('2.3.3');
+  .version(currentVersion);
 
 program
   .command('patch')
   .description('Inject RTL support into Antigravity')
   .option('-p, --path <path>', 'Custom path to Antigravity installation')
+  .option('--skip-update-check', 'Skip checking for updates')
   .action(async (options) => {
     console.log(BANNER);
     try {
-      await patch(options.path);
+      await patch(options.path, options.skipUpdateCheck);
     } catch (err) {
       console.error(chalk.red('\nPatch failed:'), err.message);
       process.exit(1);
@@ -55,4 +57,17 @@ program
     }
   });
 
+program
+  .command('update')
+  .description('Check for updates and show installation instructions')
+  .action(async () => {
+    console.log(BANNER);
+    console.log(chalk.cyan('Checking for updates...\n'));
+    const hasUpdate = await checkForUpdates(false);
+    if (!hasUpdate) {
+      showUpdateInstructions();
+    }
+  });
+
 program.parse(process.argv);
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antigravity-rtl-patcher",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "description": "Smart RTL and Persian/Arabic typography patcher for Antigravity",
   "main": "src/patcher.js",
   "bin": {

package/src/patcher.js

@@ -6,6 +6,7 @@ const ora = require('ora');
 const chalk = require('chalk');
 const { findInstallations } = require('./paths');
 const { checkPermissions, delay } = require('./utils');
+const { checkForUpdates } = require('./version-checker');
 
 const PATCH_MARKER = '__AGY_RTL_INJECTED__';
 const BACKUP_SUFFIX = '.agy-rtl-backup';
@@ -151,7 +152,12 @@ async function restoreAsar(installation, spinner) {
 /**
  * Main patch function.
  */
-async function patch(customPath) {
+async function patch(customPath, skipUpdateCheck = false) {
+  // Check for updates (non-blocking)
+  if (!skipUpdateCheck) {
+    await checkForUpdates(false);
+  }
+
   const spinner = ora('Searching for Antigravity...').start();
   const installations = findInstallations(customPath);
 

package/src/version-checker.js

@@ -0,0 +1,103 @@
+const https = require('https');
+const chalk = require('chalk');
+const { version: currentVersion } = require('../package.json');
+
+/**
+ * Compare two semantic versions.
+ * Returns: 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+function compareVersions(v1, v2) {
+  const parts1 = v1.split('.').map(Number);
+  const parts2 = v2.split('.').map(Number);
+  
+  for (let i = 0; i < 3; i++) {
+    const p1 = parts1[i] || 0;
+    const p2 = parts2[i] || 0;
+    if (p1 > p2) return 1;
+    if (p1 < p2) return -1;
+  }
+  return 0;
+}
+
+/**
+ * Fetch the latest version from npm registry.
+ */
+function fetchLatestVersion() {
+  return new Promise((resolve, reject) => {
+    const url = 'https://registry.npmjs.org/antigravity-rtl-patcher/latest';
+    
+    https.get(url, { timeout: 3000 }, (res) => {
+      let data = '';
+      
+      res.on('data', (chunk) => { data += chunk; });
+      res.on('end', () => {
+        try {
+          const pkg = JSON.parse(data);
+          resolve(pkg.version);
+        } catch (e) {
+          reject(new Error('Failed to parse npm response'));
+        }
+      });
+    }).on('error', (err) => {
+      reject(err);
+    }).on('timeout', () => {
+      reject(new Error('Request timeout'));
+    });
+  });
+}
+
+/**
+ * Check if a newer version is available and notify the user.
+ * Returns: true if update is available, false otherwise
+ */
+async function checkForUpdates(silent = false) {
+  try {
+    const latestVersion = await fetchLatestVersion();
+    
+    if (compareVersions(latestVersion, currentVersion) > 0) {
+      if (!silent) {
+        console.log('');
+        console.log(chalk.yellow.bold('⚠️  Update Available!'));
+        console.log(chalk.white(`   Current: ${chalk.red(currentVersion)} → Latest: ${chalk.green(latestVersion)}`));
+        console.log('');
+        console.log(chalk.cyan('   Run one of these commands to update:'));
+        console.log(chalk.gray('   • npx antigravity-rtl-patcher@latest patch'));
+        console.log(chalk.gray('   • npm install -g antigravity-rtl-patcher@latest'));
+        console.log('');
+      }
+      return true;
+    }
+    
+    if (!silent) {
+      console.log(chalk.green('✓ You are using the latest version.\n'));
+    }
+    return false;
+  } catch (error) {
+    // Silently fail if network is unavailable
+    return false;
+  }
+}
+
+/**
+ * Show update instructions.
+ */
+function showUpdateInstructions() {
+  console.log('');
+  console.log(chalk.cyan.bold('Update Instructions:'));
+  console.log('');
+  console.log(chalk.white('To update to the latest version, run:'));
+  console.log('');
+  console.log(chalk.green('  npx antigravity-rtl-patcher@latest patch'));
+  console.log(chalk.gray('  (This will automatically download and use the latest version)\n'));
+  console.log(chalk.white('Or install globally:'));
+  console.log('');
+  console.log(chalk.green('  npm install -g antigravity-rtl-patcher@latest'));
+  console.log(chalk.gray('  (Then you can use: agy-rtl patch)\n'));
+}
+
+module.exports = {
+  checkForUpdates,
+  showUpdateInstructions,
+  compareVersions,
+  currentVersion,
+};