instar 0.8.10 → 0.8.12

package/dist/cli.js

@@ -624,5 +624,34 @@ autostartCmd
         console.log(pc.yellow(`Auto-start is not supported on ${process.platform}.`));
     }
 });
+// Hidden command: run post-update migration from the NEW binary
+// Called by the auto-updater after `npm install -g` to ensure
+// migrations use the latest code, not the old in-memory modules.
+program
+    .command('migrate')
+    .description('Run post-update knowledge migration')
+    .option('-d, --dir <path>', 'Project directory')
+    .action(async (opts) => {
+    try {
+        const { loadConfig } = await import('./core/Config.js');
+        const { PostUpdateMigrator } = await import('./core/PostUpdateMigrator.js');
+        const config = loadConfig(opts.dir);
+        const hasTelegram = config.messaging?.some((m) => m.type === 'telegram') ?? false;
+        const migrator = new PostUpdateMigrator({
+            projectDir: config.projectDir,
+            stateDir: config.stateDir,
+            port: config.port,
+            hasTelegram,
+            projectName: config.projectName,
+        });
+        const result = migrator.migrate();
+        // Output as JSON for the calling process to parse
+        console.log(JSON.stringify(result));
+    }
+    catch (err) {
+        console.error(JSON.stringify({ error: err instanceof Error ? err.message : String(err) }));
+        process.exit(1);
+    }
+});
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/commands/server.js

@@ -31,6 +31,7 @@ import { registerPort, unregisterPort, startHeartbeat } from '../core/PortRegist
 import { TelegraphService } from '../publishing/TelegraphService.js';
 import { PrivateViewer } from '../publishing/PrivateViewer.js';
 import { TunnelManager } from '../tunnel/TunnelManager.js';
+import { PostUpdateMigrator } from '../core/PostUpdateMigrator.js';
 import { EvolutionManager } from '../core/EvolutionManager.js';
 import { QuotaTracker } from '../monitoring/QuotaTracker.js';
 import { AccountSwitcher } from '../monitoring/AccountSwitcher.js';
@@ -483,6 +484,15 @@ function cleanupTelegramTempFiles() {
  * The self-diagnosis job checks .instar/logs/server.log — this ensures it exists.
  * Log is truncated at 5MB to prevent unbounded growth.
  */
+function getInstalledVersion() {
+    try {
+        const pkgPath = path.resolve(new URL(import.meta.url).pathname, '../../../package.json');
+        return JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version || '';
+    }
+    catch {
+        return '';
+    }
+}
 function setupServerLog(stateDir) {
     const logDir = path.join(stateDir, '..', 'logs');
     fs.mkdirSync(logDir, { recursive: true });
@@ -529,6 +539,39 @@ export async function startServer(options) {
         setupServerLog(config.stateDir);
         // Clean up stale Telegram temp files on startup
         cleanupTelegramTempFiles();
+        // Run post-update migration on startup — ensures agent knowledge stays current
+        // even if the update was installed externally (e.g., via `npm install -g instar@latest`)
+        try {
+            const installedVersion = getInstalledVersion();
+            const versionFile = path.join(config.stateDir, 'state', 'last-migrated-version.json');
+            let lastMigrated = '';
+            try {
+                lastMigrated = JSON.parse(fs.readFileSync(versionFile, 'utf-8')).version || '';
+            }
+            catch { /* first run */ }
+            if (installedVersion && installedVersion !== lastMigrated) {
+                const hasTelegram = config.messaging?.some((m) => m.type === 'telegram') ?? false;
+                const migrator = new PostUpdateMigrator({
+                    projectDir: config.projectDir,
+                    stateDir: config.stateDir,
+                    port: config.port,
+                    hasTelegram,
+                    projectName: config.projectName,
+                });
+                const migration = migrator.migrate();
+                if (migration.upgraded.length > 0) {
+                    console.log(pc.green(`  Knowledge upgrade (v${lastMigrated || '?'} → v${installedVersion}): ${migration.upgraded.join(', ')}`));
+                }
+                // Record the migrated version
+                const dir = path.dirname(versionFile);
+                if (!fs.existsSync(dir))
+                    fs.mkdirSync(dir, { recursive: true });
+                fs.writeFileSync(versionFile, JSON.stringify({ version: installedVersion, migratedAt: new Date().toISOString() }));
+            }
+        }
+        catch (err) {
+            console.log(pc.yellow(`  Post-update migration check: ${err instanceof Error ? err.message : String(err)}`));
+        }
         // Register this instance in the port registry (multi-instance support)
         try {
             registerPort(config.projectName, config.port, config.projectDir);

package/dist/core/UpdateChecker.js

@@ -128,21 +128,34 @@ export class UpdateChecker {
         if (success) {
             this.saveRollbackInfo(previousVersion, newVersion);
         }
-        // Post-update migration: upgrade hooks, CLAUDE.md, scripts
+        // Post-update migration: spawn the NEW binary to run migrations.
+        // Critical: the old process has stale modules in memory — only the
+        // new binary on disk has the latest PostUpdateMigrator entries.
         let migrationSummary = '';
         if (success && this.migratorConfig) {
             try {
-                const migrator = new PostUpdateMigrator(this.migratorConfig);
-                const migration = migrator.migrate();
-                if (migration.upgraded.length > 0) {
+                const dirFlag = this.migratorConfig.projectDir ? `--dir ${this.migratorConfig.projectDir}` : '';
+                const output = await this.execAsync('instar', ['migrate', ...(dirFlag ? ['--dir', this.migratorConfig.projectDir] : [])], 30000);
+                const migration = JSON.parse(output);
+                if (migration.upgraded && migration.upgraded.length > 0) {
                     migrationSummary = ` Intelligence download: ${migration.upgraded.length} files upgraded (${migration.upgraded.join(', ')}).`;
                 }
-                if (migration.errors.length > 0) {
+                if (migration.errors && migration.errors.length > 0) {
                     migrationSummary += ` Migration warnings: ${migration.errors.join('; ')}.`;
                 }
             }
             catch (err) {
-                migrationSummary = ` Post-update migration failed: ${err instanceof Error ? err.message : String(err)}.`;
+                // Fallback: run in-memory migrator (better than nothing)
+                try {
+                    const migrator = new PostUpdateMigrator(this.migratorConfig);
+                    const migration = migrator.migrate();
+                    if (migration.upgraded.length > 0) {
+                        migrationSummary = ` Intelligence download (fallback): ${migration.upgraded.length} files upgraded (${migration.upgraded.join(', ')}).`;
+                    }
+                }
+                catch (fallbackErr) {
+                    migrationSummary = ` Post-update migration failed: ${err instanceof Error ? err.message : String(err)}.`;
+                }
             }
         }
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "0.8.10",
+  "version": "0.8.12",
   "description": "Persistent autonomy infrastructure for AI agents",
   "type": "module",
   "main": "dist/index.js",