instar 0.8.9 → 0.8.11

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/PostUpdateMigrator.js

@@ -196,6 +196,30 @@ Strip the \`[telegram:N]\` prefix before interpreting the message. Respond natur
         else {
             result.skipped.push('CLAUDE.md: Private Viewer section already present');
         }
+        // Dashboard section
+        if (!content.includes('**Dashboard**') && !content.includes('/dashboard')) {
+            const section = `
+**Dashboard** — Visual web interface for monitoring and managing sessions. Accessible from any device (phone, tablet, laptop) via tunnel.
+- Local: \`http://localhost:${port}/dashboard\`
+- Remote: When a tunnel is running, the dashboard is accessible at \`{tunnelUrl}/dashboard\`
+- Authentication: Uses a 6-digit PIN (configured via \`dashboardPin\` in \`.instar/config.json\`) — no need to enter the full bearer token
+- Features: Real-time terminal streaming of all running sessions, session management, model badges, mobile-responsive
+- **Sharing the dashboard**: When the user wants to check on sessions from their phone, give them the tunnel URL + PIN. Check tunnel status: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/tunnel\`
+`;
+            // Insert after Server Status or before Scripts section
+            const insertBefore = content.indexOf('**Scripts**');
+            if (insertBefore >= 0) {
+                content = content.slice(0, insertBefore) + section + '\n' + content.slice(insertBefore);
+            }
+            else {
+                content += '\n' + section;
+            }
+            patched = true;
+            result.upgraded.push('CLAUDE.md: added Dashboard section');
+        }
+        else {
+            result.skipped.push('CLAUDE.md: Dashboard section already present');
+        }
         if (patched) {
             try {
                 fs.writeFileSync(claudeMdPath, content);

package/dist/scaffold/templates.js

@@ -268,6 +268,13 @@ This routes feedback to the Instar maintainers automatically. Valid types: \`bug
 **Server Status** — Detailed runtime information beyond health checks.
 - Status: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/status\`
 
+**Dashboard** — Visual web interface for monitoring and managing sessions. Accessible from any device (phone, tablet, laptop) via tunnel.
+- Local: \`http://localhost:${port}/dashboard\`
+- Remote: When a tunnel is running, the dashboard is accessible at \`{tunnelUrl}/dashboard\`
+- Authentication: Uses a 6-digit PIN (configured via \`dashboardPin\` in \`.instar/config.json\`) — no need to enter the full bearer token
+- Features: Real-time terminal streaming of all running sessions, session management, model badges, mobile-responsive
+- **Sharing the dashboard**: When the user wants to check on sessions from their phone, give them the tunnel URL + PIN. Check tunnel status: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/tunnel\`
+
 **Scripts** — Reusable capabilities in \`.claude/scripts/\`.
 
 **Skills** — Reusable behavioral capabilities in \`.claude/skills/\`.

package/package.json

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