instar 0.24.19 → 0.24.21

package/.claude/settings.json

@@ -67,6 +67,126 @@
           }
         ]
       }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .instar/hooks/instar/hook-event-reporter.js",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .instar/hooks/instar/hook-event-reporter.js",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .instar/hooks/instar/hook-event-reporter.js",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .instar/hooks/instar/hook-event-reporter.js",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "WorktreeCreate": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .instar/hooks/instar/hook-event-reporter.js",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "WorktreeRemove": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .instar/hooks/instar/hook-event-reporter.js",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "TaskCompleted": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .instar/hooks/instar/hook-event-reporter.js",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .instar/hooks/instar/hook-event-reporter.js",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .instar/hooks/instar/hook-event-reporter.js",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "PermissionRequest": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .instar/hooks/instar/auto-approve-permissions.js",
+            "timeout": 5000
+          }
+        ]
+      }
     ]
   },
   "mcpServers": {

package/.claude/skills/setup-wizard/skill.md

@@ -1621,8 +1621,8 @@ Build the app manifest JSON with minimal Phase 1 scopes:
   "oauth_config": {
     "scopes": {
       "bot": [
-        "channels:history", "channels:manage", "channels:read",
-        "chat:write", "im:history", "im:read", "im:write",
+        "channels:history", "channels:join", "channels:manage", "channels:read",
+        "chat:write", "files:read", "groups:history", "im:history", "im:read", "im:write",
         "pins:write", "reactions:read", "reactions:write", "users:read"
       ]
     }

package/dashboard/index.html

@@ -2004,6 +2004,19 @@
     .systems-event-time { color: var(--text-dim); white-space: nowrap; font-size: 11px; min-width: 60px; }
     .systems-event-text { color: var(--text); flex: 1; }
 
+    /* Content Browser (browsable stats) */
+    .cap-content-panel { background: var(--bg); border: 1px solid var(--border); border-radius: 8px; margin-top: 12px; overflow: hidden; }
+    .cap-content-header { display: flex; align-items: center; justify-content: space-between; padding: 10px 14px; border-bottom: 1px solid var(--border); font-size: 12px; font-weight: 600; color: var(--text-bright); }
+    .cap-content-body { max-height: 400px; overflow-y: auto; padding: 8px; }
+    .cap-content-item { padding: 10px 12px; border: 1px solid var(--border); border-radius: 6px; margin-bottom: 6px; background: var(--bg-panel); }
+    .cap-content-item-title { font-size: 13px; font-weight: 500; color: var(--text-bright); margin-bottom: 4px; }
+    .cap-content-item-body { font-size: 12px; color: var(--text-dim); line-height: 1.5; word-break: break-word; }
+    .cap-content-item-time { font-size: 11px; color: var(--text-dim); margin-top: 4px; }
+    .cap-content-tag { display: inline-block; font-size: 10px; padding: 2px 8px; border-radius: 3px; background: rgba(255,255,255,0.06); color: var(--text-dim); margin-right: 4px; margin-top: 4px; }
+    .cap-content-tag.applied { background: rgba(76,175,80,0.15); color: var(--accent); }
+    .cap-content-empty { padding: 16px; text-align: center; color: var(--text-dim); font-size: 12px; }
+    .cap-stat-card:hover { border-color: var(--accent); transition: border-color 0.15s; }
+
     .discovery-container {
       grid-column: 1 / -1;
       overflow-y: auto;
@@ -5484,7 +5497,7 @@
       document.getElementById('systemsDetailView').classList.add('active');
       const content = document.getElementById('systemsDetailContent');
 
-      const statCards = buildStatCards(cap.stats || {});
+      const statCards = buildStatCards(cap.stats || {}, capId);
       const processRows = (cap.processes || []).map(p => {
         const dotColor = p.status === 'running' ? 'var(--accent)' : 'var(--red)';
         return `<div class="cap-process-row">
@@ -5506,7 +5519,7 @@
           <div class="cap-detail-description">${esc(cap.description)}</div>
           ${lastAct}
         </div>
-        ${statCards ? '<div class="cap-detail-section"><div class="cap-detail-section-title">Metrics</div><div class="cap-stats-grid">' + statCards + '</div></div>' : ''}
+        ${statCards ? '<div class="cap-detail-section"><div class="cap-detail-section-title">Metrics</div><div class="cap-stats-grid">' + statCards + '</div><div id="capContentBrowser"></div></div>' : ''}
         <div class="cap-detail-section">
           <div class="cap-detail-section-title">Components (${(cap.processes || []).length})</div>
           <div class="cap-process-list">${processRows}</div>
@@ -5517,7 +5530,31 @@
         </div>`;
     }
 
-    function buildStatCards(stats) {
+    // Map stat keys to browsable content endpoints
+    const BROWSABLE_STATS = {
+      // Evolution
+      learnings: { endpoint: '/evolution/learnings', label: 'Learnings', renderer: 'renderLearnings' },
+      proposals: { endpoint: '/evolution/proposals', label: 'Proposals', renderer: 'renderProposals' },
+      gaps: { endpoint: '/evolution/gaps', label: 'Capability Gaps', renderer: 'renderGaps' },
+      actions: { endpoint: '/evolution/actions', label: 'Actions', renderer: 'renderActions' },
+      overdueActions: { endpoint: '/evolution/actions/overdue', label: 'Overdue Actions', renderer: 'renderActions' },
+      // Health
+      coherenceChecks: { endpoint: '/health/coherence', label: 'Coherence Report', renderer: 'renderCoherence' },
+      coherencePassed: { endpoint: '/health/coherence', label: 'Coherence Report', renderer: 'renderCoherence' },
+      coherenceFailed: { endpoint: '/health/coherence', label: 'Coherence Report', renderer: 'renderCoherence' },
+      // Recovery
+      totalTriages: { endpoint: '/triage/history?limit=20', label: 'Triage History', renderer: 'renderTriageHistory' },
+      interventions: { endpoint: '/watchdog/status', label: 'Watchdog Status', renderer: 'renderWatchdog' },
+      recoveries: { endpoint: '/watchdog/status', label: 'Watchdog Status', renderer: 'renderWatchdog' },
+      // Jobs
+      totalJobs: { endpoint: '/jobs', label: 'Jobs', renderer: 'renderJobs' },
+      enabledJobs: { endpoint: '/jobs', label: 'Jobs', renderer: 'renderJobs' },
+      // Telegram
+      totalMessages: { endpoint: '/telegram/log-stats', label: 'Message Stats', renderer: 'renderTelegramStats' },
+      topicMappings: { endpoint: '/telegram/log-stats', label: 'Message Stats', renderer: 'renderTelegramStats' },
+    };
+
+    function buildStatCards(stats, capId) {
       if (!stats || typeof stats !== 'object') return '';
       const map = {
         interventions: 'Interventions', recoveries: 'Recoveries', sessionDeaths: 'Deaths',
@@ -5535,12 +5572,117 @@
       const cards = [];
       for (const [key, label] of Object.entries(map)) {
         if (stats[key] != null && typeof stats[key] === 'number') {
-          cards.push(`<div class="cap-stat-card"><div class="cap-stat-card-value">${stats[key]}</div><div class="cap-stat-card-label">${esc(label)}</div></div>`);
+          const browsable = BROWSABLE_STATS[key];
+          const clickAttr = browsable ? ` onclick="browseStatContent('${key}')" style="cursor:pointer"` : '';
+          const browseHint = browsable ? '<div style="font-size:9px;color:var(--accent);margin-top:2px">click to view</div>' : '';
+          cards.push(`<div class="cap-stat-card"${clickAttr}><div class="cap-stat-card-value">${stats[key]}</div><div class="cap-stat-card-label">${esc(label)}</div>${browseHint}</div>`);
         }
       }
       return cards.join('');
     }
 
+    async function browseStatContent(statKey) {
+      const info = BROWSABLE_STATS[statKey];
+      if (!info) return;
+      const panel = document.getElementById('capContentBrowser');
+      if (!panel) return;
+      panel.innerHTML = '<div style="padding:12px;color:var(--text-dim);font-size:12px">Loading ' + esc(info.label) + '...</div>';
+      try {
+        const data = await apiFetch(info.endpoint);
+        panel.innerHTML = '<div class="cap-content-panel">' +
+          '<div class="cap-content-header"><span>' + esc(info.label) + '</span><button onclick="document.getElementById(\'capContentBrowser\').innerHTML=\'\'" style="border:none;background:none;color:var(--text-dim);cursor:pointer;font-size:14px">&times;</button></div>' +
+          '<div class="cap-content-body">' + renderBrowsableContent(info.renderer, data) + '</div></div>';
+      } catch (e) {
+        panel.innerHTML = '<div style="padding:12px;color:var(--red);font-size:12px">Failed to load: ' + esc(e.message) + '</div>';
+      }
+    }
+
+    function renderBrowsableContent(renderer, data) {
+      switch (renderer) {
+        case 'renderLearnings': {
+          const items = data.learnings || data || [];
+          if (!Array.isArray(items) || items.length === 0) return '<div class="cap-content-empty">No learnings recorded</div>';
+          return items.map(l => `<div class="cap-content-item">
+            <div class="cap-content-item-title">${esc(l.title || l.insight || l.id || 'Untitled')}</div>
+            ${l.description || l.context ? '<div class="cap-content-item-body">' + esc(l.description || l.context || '') + '</div>' : ''}
+            ${l.category ? '<span class="cap-content-tag">' + esc(l.category) + '</span>' : ''}
+            ${l.applied ? '<span class="cap-content-tag applied">Applied</span>' : ''}
+            ${l.createdAt ? '<div class="cap-content-item-time">' + esc(timeAgo(l.createdAt)) + '</div>' : ''}
+          </div>`).join('');
+        }
+        case 'renderProposals': {
+          const items = data.proposals || data || [];
+          if (!Array.isArray(items) || items.length === 0) return '<div class="cap-content-empty">No proposals</div>';
+          return items.map(p => `<div class="cap-content-item">
+            <div class="cap-content-item-title">${esc(p.title || p.id || 'Untitled')}</div>
+            ${p.description ? '<div class="cap-content-item-body">' + esc(p.description) + '</div>' : ''}
+            ${p.status ? '<span class="cap-content-tag">' + esc(p.status) + '</span>' : ''}
+            ${p.type ? '<span class="cap-content-tag">' + esc(p.type) + '</span>' : ''}
+          </div>`).join('');
+        }
+        case 'renderGaps': {
+          const items = data.gaps || data || [];
+          if (!Array.isArray(items) || items.length === 0) return '<div class="cap-content-empty">No gaps detected</div>';
+          return items.map(g => `<div class="cap-content-item">
+            <div class="cap-content-item-title">${esc(g.title || g.capability || g.id || 'Untitled')}</div>
+            ${g.description ? '<div class="cap-content-item-body">' + esc(g.description) + '</div>' : ''}
+            ${g.severity ? '<span class="cap-content-tag">' + esc(g.severity) + '</span>' : ''}
+          </div>`).join('');
+        }
+        case 'renderActions': {
+          const items = data.actions || data || [];
+          if (!Array.isArray(items) || items.length === 0) return '<div class="cap-content-empty">No actions</div>';
+          return items.map(a => `<div class="cap-content-item">
+            <div class="cap-content-item-title">${esc(a.title || a.action || a.id || 'Untitled')}</div>
+            ${a.status ? '<span class="cap-content-tag">' + esc(a.status) + '</span>' : ''}
+            ${a.dueAt ? '<div class="cap-content-item-time">Due: ' + esc(timeAgo(a.dueAt)) + '</div>' : ''}
+          </div>`).join('');
+        }
+        case 'renderCoherence': {
+          const report = data.lastReport || data;
+          if (!report || !report.checks) return '<div class="cap-content-empty">No coherence data</div>';
+          return report.checks.map(c => `<div class="cap-content-item" style="border-left:3px solid ${c.passed ? 'var(--accent)' : 'var(--red)'}">
+            <div class="cap-content-item-title">${c.passed ? '&check;' : '&cross;'} ${esc(c.name)}</div>
+            <div class="cap-content-item-body">${esc(c.message)}</div>
+          </div>`).join('');
+        }
+        case 'renderTriageHistory': {
+          const items = data.history || data || [];
+          if (!Array.isArray(items) || items.length === 0) return '<div class="cap-content-empty">No triage history</div>';
+          return items.map(t => `<div class="cap-content-item">
+            <div class="cap-content-item-title">Topic ${t.topicId} — ${esc(t.sessionName || 'unknown')}</div>
+            <div class="cap-content-item-body">${t.result ? esc(JSON.stringify(t.result.actionsTaken || t.result, null, 0).substring(0, 200)) : ''}</div>
+            ${t.timestamp ? '<div class="cap-content-item-time">' + esc(timeAgo(t.timestamp)) + '</div>' : ''}
+          </div>`).join('');
+        }
+        case 'renderWatchdog': {
+          const hist = data.interventionHistory || [];
+          if (hist.length === 0) return '<div class="cap-content-empty">No interventions recorded</div>';
+          return hist.map(h => `<div class="cap-content-item">
+            <div class="cap-content-item-title">PID ${h.stuckPid || '?'} — ${esc(h.level || h.outcome || 'intervention')}</div>
+            ${h.outcome ? '<span class="cap-content-tag">' + esc(h.outcome) + '</span>' : ''}
+            ${h.timestamp ? '<div class="cap-content-item-time">' + esc(timeAgo(h.timestamp)) + '</div>' : ''}
+          </div>`).join('');
+        }
+        case 'renderJobs': {
+          const jobs = data.jobs || data || [];
+          if (!Array.isArray(jobs) || jobs.length === 0) return '<div class="cap-content-empty">No jobs</div>';
+          return jobs.slice(0, 20).map(j => `<div class="cap-content-item">
+            <div class="cap-content-item-title">${esc(j.slug || j.name || 'unnamed')}</div>
+            <div class="cap-content-item-body">${esc(j.cron || '')} ${j.enabled === false ? '(disabled)' : ''}</div>
+          </div>`).join('');
+        }
+        case 'renderTelegramStats': {
+          return `<div class="cap-content-item">
+            <div class="cap-content-item-title">Message Log</div>
+            <div class="cap-content-item-body">Total messages: ${data.totalMessages || '?'}<br>Log size: ${data.logSizeBytes ? Math.round(data.logSizeBytes / 1024) + ' KB' : '?'}</div>
+          </div>`;
+        }
+        default:
+          return '<div class="cap-content-empty">No viewer for this content</div>';
+      }
+    }
+
     function showSystemsOverview() {
       document.getElementById('systemsOverview').style.display = '';
       document.getElementById('systemsDetailView').classList.remove('active');

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA6BH,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yFAAyF;IACzF,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBrE;AAgzFD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAiBlF"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA+CH,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yFAAyF;IACzF,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBrE;AAgzFD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAiBlF"}

package/dist/commands/init.js

@@ -31,7 +31,7 @@ import os from 'node:os';
 import path from 'node:path';
 import pc from 'picocolors';
 import { randomUUID } from 'node:crypto';
-import { execFileSync } from 'node:child_process';
+import { execFileSync, execSync } from 'node:child_process';
 import { detectTmuxPath, detectClaudePath, detectGitPath, detectGhPath, ensureStateDir, standaloneAgentsDir, getInstarVersion } from '../core/Config.js';
 import { ensurePrerequisites } from '../core/Prerequisites.js';
 import { allocatePort, registerAgent, validateAgentName } from '../core/AgentRegistry.js';
@@ -44,6 +44,24 @@ import { CanonicalState } from '../core/CanonicalState.js';
 import { ManifestIntegrity } from '../security/ManifestIntegrity.js';
 import { buildHttpHookSettings } from '../data/http-hook-templates.js';
 import { generateAgentMd, generateUserMd, generateMemoryMd, generateClaudeMd, generateSoulMd, } from '../scaffold/templates.js';
+/**
+ * Find a free port in the default range (4040-4099) by checking if anything
+ * is listening. Used as fallback when allocatePort() fails (e.g., registry
+ * is corrupted or locked).
+ */
+function findFreePortFallback() {
+    for (let port = 4040; port <= 4099; port++) {
+        try {
+            execSync(`lsof -iTCP:${port} -sTCP:LISTEN -P -n`, { stdio: 'ignore' });
+            // lsof found a listener — port is in use
+        }
+        catch {
+            // lsof found nothing — port is free
+            return port;
+        }
+    }
+    return 4040; // All ports in range are busy — return default and let server fail with a clear error
+}
 /**
  * Main init entry point. Handles both fresh and existing project modes.
  */
@@ -124,7 +142,7 @@ async function initFreshProject(projectName, options) {
             console.log(`  ${pc.green('✓')} Auto-allocated port ${port} (from ~/.instar/registry.json)`);
         }
         catch {
-            port = 4040; // Fallback to default
+            port = findFreePortFallback();
         }
     }
     // Generate identity (non-interactive for init, interactive for setup)
@@ -401,7 +419,7 @@ async function initExistingProject(options) {
             port = allocatePort(projectDir);
         }
         catch {
-            port = 4040;
+            port = findFreePortFallback();
         }
     }
     console.log(pc.bold(`\nInitializing instar in: ${pc.cyan(projectDir)}`));
@@ -732,7 +750,7 @@ async function initStandaloneAgent(agentName, options) {
             console.log(`  ${pc.green('✓')} Auto-allocated port ${port}`);
         }
         catch {
-            port = 4040;
+            port = findFreePortFallback();
         }
     }
     // Create directory structure