instar 1.3.931 → 1.3.933

package/dist/server/throughputRoutes.d.ts

@@ -0,0 +1,53 @@
+import { Router } from 'express';
+type Author = 'codey' | 'echo' | 'other';
+type Weights = {
+    velocity: number;
+    speed: number;
+    quality: number;
+    output: number;
+};
+type GhExec = (args: string[]) => Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;
+export declare const DEFAULT_THROUGHPUT_WEIGHTS: Weights;
+/** Canonical server-owned implementation of Echo's throughput-metrics.mjs contract. */
+export declare function buildThroughputSeries(opts: {
+    days: 7 | 14 | 30;
+    now?: Date;
+    run?: GhExec;
+    weights?: Weights;
+}): Promise<{
+    repo: string;
+    windowDays: 7 | 30 | 14;
+    generatedAt: string;
+    weights: Weights;
+    rows: {
+        day: string;
+        authors: Partial<Record<Author, {
+            merges: number;
+            medianLatencyH: number;
+            reworkLoops: number;
+            reverts: number;
+            medianPushIters: number;
+            medianLoc: number;
+        }>>;
+        team: {
+            dayLoc: number;
+            index: number;
+            merges: number;
+            medianLatencyH: number;
+            reworkLoops: number;
+            reverts: number;
+            medianPushIters: number;
+            medianLoc: number;
+        };
+    }[];
+}>;
+export declare function createThroughputRoutes(options?: {
+    run?: GhExec;
+    weights?: Weights;
+}): Router;
+export {};
+//# sourceMappingURL=throughputRoutes.d.ts.map

package/dist/server/throughputRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throughputRoutes.d.ts","sourceRoot":"","sources":["../../src/server/throughputRoutes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAC;AAU9D,KAAK,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AACzC,KAAK,OAAO,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACpF,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAI5F,eAAO,MAAM,0BAA0B,EAAE,OAAkE,CAAC;AAyC5G,uFAAuF;AACvF,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;GAwBnH;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAYhG"}

package/dist/server/throughputRoutes.js

@@ -0,0 +1,98 @@
+import { execFile } from 'node:child_process';
+import { Router } from 'express';
+export const DEFAULT_THROUGHPUT_WEIGHTS = { velocity: .40, speed: .20, quality: .25, output: .15 };
+const WINDOWS = [7, 14, 30];
+const ZERO = () => ({ merges: 0, medianLatencyH: 0, reworkLoops: 0, reverts: 0, medianPushIters: 0, medianLoc: 0 });
+function gh(args) {
+    return new Promise(resolve => execFile('gh', args, { timeout: 30_000, maxBuffer: 32 * 1024 * 1024 }, (err, stdout, stderr) => resolve({ code: err ? 1 : 0, stdout: stdout ?? '', stderr: stderr ?? '' })));
+}
+function median(values) {
+    if (!values.length)
+        return 0;
+    const a = [...values].sort((x, y) => x - y);
+    const m = Math.floor(a.length / 2);
+    return Math.round((a.length % 2 ? a[m] : (a[m - 1] + a[m]) / 2) * 10) / 10;
+}
+function authorOf(login) { return login === 'JKHeadley' ? 'codey' : login === 'EchoOfDawn' ? 'echo' : 'other'; }
+function pdtDay(iso) { return new Date(Date.parse(iso) - 7 * 3_600_000).toISOString().slice(0, 10); }
+function metrics(prs, details) {
+    return {
+        merges: prs.length,
+        medianLatencyH: median(prs.map(p => (Date.parse(p.mergedAt) - Date.parse(p.createdAt)) / 3_600_000)),
+        reworkLoops: prs.reduce((n, p) => n + (details.get(p.number)?.reworkLoops ?? 0), 0),
+        reverts: prs.filter(p => /^revert/i.test(p.title)).length,
+        medianPushIters: median(prs.map(p => details.get(p.number)?.commits ?? 0)),
+        medianLoc: median(prs.map(p => p.additions + p.deletions)),
+    };
+}
+async function detailMap(numbers, run) {
+    const out = new Map();
+    for (let offset = 0; offset < numbers.length; offset += 50) {
+        const batch = numbers.slice(offset, offset + 50);
+        const fields = batch.map(n => `p${n}:pullRequest(number:${n}){number reviews(first:30){nodes{state}} commits{totalCount}}`).join(' ');
+        const r = await run(['api', 'graphql', '-f', `query=query{repository(owner:"JKHeadley",name:"instar"){${fields}}}`]);
+        if (r.code)
+            throw new Error(`github-details-unavailable: ${r.stderr.slice(0, 120)}`);
+        const repo = JSON.parse(r.stdout)?.data?.repository ?? {};
+        for (const n of batch) {
+            const p = repo[`p${n}`];
+            if (!p)
+                continue;
+            out.set(n, { reworkLoops: (p.reviews?.nodes ?? []).filter((x) => x.state === 'CHANGES_REQUESTED').length, commits: Number(p.commits?.totalCount ?? 0) });
+        }
+    }
+    return out;
+}
+/** Canonical server-owned implementation of Echo's throughput-metrics.mjs contract. */
+export async function buildThroughputSeries(opts) {
+    const now = opts.now ?? new Date();
+    const run = opts.run ?? gh;
+    const weights = opts.weights ?? DEFAULT_THROUGHPUT_WEIGHTS;
+    const cutoff = now.getTime() - opts.days * 86_400_000;
+    const listed = await run(['pr', 'list', '--repo', 'JKHeadley/instar', '--state', 'merged', '--limit', '400', '--json', 'number,title,author,mergedAt,createdAt,additions,deletions']);
+    if (listed.code)
+        throw new Error(`github-list-unavailable: ${listed.stderr.slice(0, 120)}`);
+    const prs = JSON.parse(listed.stdout).filter(p => Date.parse(p.mergedAt) >= cutoff && Date.parse(p.mergedAt) <= now.getTime());
+    const details = await detailMap(prs.map(p => p.number), run);
+    const days = new Map();
+    for (const p of prs)
+        days.set(pdtDay(p.mergedAt), [...(days.get(pdtDay(p.mergedAt)) ?? []), p]);
+    const rows = [...days].sort(([a], [b]) => a.localeCompare(b)).map(([day, all]) => {
+        const authors = {};
+        for (const a of ['codey', 'echo', 'other']) {
+            const own = all.filter(p => authorOf(p.author?.login) === a);
+            if (own.length)
+                authors[a] = metrics(own, details);
+        }
+        return { day, authors, team: { ...metrics(all, details), dayLoc: all.reduce((n, p) => n + p.additions + p.deletions, 0), index: 0 } };
+    });
+    const maxM = Math.max(1, ...rows.map(r => r.team.merges));
+    const maxL = Math.max(1, ...rows.map(r => r.team.medianLatencyH));
+    const maxLoc = Math.max(1, ...rows.map(r => r.team.dayLoc));
+    for (const r of rows) {
+        const v = r.team.merges / maxM;
+        const s = 1 - r.team.medianLatencyH / maxL;
+        const q = 1 - Math.min(1, (r.team.reworkLoops + 2 * r.team.reverts) / r.team.merges);
+        const o = Math.log1p(r.team.dayLoc) / Math.log1p(maxLoc);
+        r.team.index = Math.round(1000 * (weights.velocity * v + weights.speed * s + weights.quality * q + weights.output * o)) / 10;
+    }
+    return { repo: 'JKHeadley/instar', windowDays: opts.days, generatedAt: now.toISOString(), weights, rows };
+}
+export function createThroughputRoutes(options = {}) {
+    const router = Router();
+    router.get('/throughput/series', async (req, res) => {
+        const days = Number(req.query.days ?? 14);
+        if (!WINDOWS.includes(days)) {
+            res.status(400).json({ error: 'invalid-throughput-window', allowed: WINDOWS });
+            return;
+        }
+        try {
+            res.set('Cache-Control', 'private, max-age=60').json(await buildThroughputSeries({ days: days, ...options }));
+        }
+        catch {
+            res.status(503).json({ error: 'throughput-series-unavailable' });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=throughputRoutes.js.map

package/dist/server/throughputRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throughputRoutes.js","sourceRoot":"","sources":["../../src/server/throughputRoutes.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.931",
+  "version": "1.3.933",
   "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
   "type": "module",
   "main": "dist/index.js",
@@ -129,6 +129,7 @@
     "proper-lockfile": "^4.1.2",
     "ssh2": "1.17.0",
     "telegram": "^2.26.22",
+    "undici": "^6.27.0",
     "ws": "^8.19.0",
     "zod": "^4.3.6"
   },

package/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-07-24T06:06:58.795Z",
-  "instarVersion": "1.3.931",
+  "generatedAt": "2026-07-24T13:04:17.807Z",
+  "instarVersion": "1.3.933",
   "entryCount": 202,
   "entries": {
     "hook:session-start": {
@@ -1530,7 +1530,7 @@
       "type": "subsystem",
       "domain": "server",
       "sourcePath": "src/server/AgentServer.ts",
-      "contentHash": "59e418f6d422344d2df994a788ac4949fe11c2cf20e811a76f8137d3aceab402",
+      "contentHash": "ea6bc1c5440b492c3127aba0367ee4e2248c29aedf59126f484d14402c78d90b",
       "since": "2025-01-01"
     },
     "subsystem:session-manager": {

package/upgrades/1.3.932.md

@@ -0,0 +1,29 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+After three consecutive network-level `fetch failed` errors, the Slack API
+client replaces its own undici dispatcher and retries through a fresh
+connection pool. Successful calls reset the failure streak. The recovery pool
+is scoped to Slack requests only — unrelated HTTP clients are not affected.
+`undici` is now a declared dependency (it was previously imported as a
+transitive package).
+
+## What to Tell Your User
+
+After a laptop network change (new Wi-Fi, hotspot, VPN flip), outbound Slack
+delivery now recovers on its own within a few failed attempts instead of
+staying dead until a server restart. Nothing to configure.
+
+## Summary of New Capabilities
+
+- Slack outbound transport self-heals after network interface changes.
+- Recovery is scoped to the Slack client's own connection pool.
+
+## Verification
+
+Tier 1 focused evidence: `tests/unit/slack-socket-reconnect.test.ts` — 17/17
+passing. Slack API response and retry semantics are unchanged.

package/upgrades/1.3.933.md

@@ -0,0 +1,22 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+The dashboard now has a read-only Throughput tab backed by a canonical `/throughput/series` route.
+
+## What to Tell Your User
+
+Use Throughput to compare Codey, Echo, or team delivery across 7, 14, or 30 days, including a single composite index.
+
+## Summary of New Capabilities
+
+- Charts merges, merge latency, rework, reverts, commit iterations, changed lines, and the composite index.
+- Uses the documented V40/S20/Q25/O15 weights and returns those weights in the API contract.
+- Reads GitHub pull-request data without mutating repository or runtime state.
+
+## Evidence
+
+The metric contract, dashboard registry, panel placement, URL state, navigation, and viewport floors pass locally. TypeScript and repository invariants pass, with browser verification at 2560px and 390px.

package/upgrades/side-effects/dashboard-throughput.md

@@ -0,0 +1,77 @@
+# Side-Effects Review — Dashboard Throughput
+
+**Version / slug:** `dashboard-throughput`  
+**Date:** 2026-07-24  
+**Author:** Instar-codey  
+**Second-pass reviewer:** not required
+
+## Summary of the change
+
+Adds a read-only dashboard tab and server route that derive daily pull-request delivery metrics from bounded, structured GitHub CLI responses. The browser renders the server-owned contract and never writes GitHub or Instar state.
+
+## Decision-point inventory
+
+No behavioral decision point. The only rejection is structural API validation limiting windows to 7, 14, or 30 days.
+
+## 1. Over-block
+
+Malformed or unsupported window values receive 400. Valid documented windows are all accepted; there is no message or action block surface.
+
+## 2. Under-block
+
+GitHub outages and malformed responses return 503 rather than plausible zero data. The metric remains limited by GitHub's bounded review list (30 reviews per PR) and 400 merged PR list.
+
+## 3. Level-of-abstraction fit
+
+Aggregation belongs on the server because it is the canonical contract and can safely execute structured `gh` calls. The browser only selects and plots.
+
+## 4. Signal vs authority compliance
+
+Required reference: [docs/signal-vs-authority.md](../../docs/signal-vs-authority.md)
+
+- [x] No — this change has no block/allow surface.
+
+These are observational signals only and authorize no action.
+
+## 4b. Judgment-point check
+
+No static heuristic is added at a competing-signals decision point. The published composite is descriptive arithmetic with returned weights, not an authority.
+
+## 5. Interactions
+
+The route uses authenticated dashboard middleware already owned by AgentServer. A one-minute private cache header reduces repeated reads. It shares no mutable state, so there is no double-fire, race, or feedback loop.
+
+## 6. External surfaces
+
+The external read surface is GitHub pull-request metadata. The user-visible dashboard adds no operator action and no persistent state.
+
+## 6b. Operator-surface quality
+
+1. The primary content—the index and charts—is visible immediately.
+2. Labels are plain language; no hashes, JSON, or internal identifiers are primary content.
+3. There are no destructive actions.
+4. Selectors and all seven charts were browser-verified at 2560px and 390px; phone layout is one column with no horizontal overflow.
+
+## 7. Multi-machine posture
+
+**Proxied-on-read:** each machine computes the same repository-global GitHub view on request. There is no durable state to replicate, no notice requiring one-voice gating, and no generated URL.
+
+## 8. Rollback cost
+
+Pure code rollback: revert the route registration and tab, then ship a patch. No data migration or agent-state repair is required.
+
+## Conclusion
+
+The review moved all metric and index ownership server-side, made GitHub failure explicit, and kept the dashboard fluid and read-only. Clear to ship.
+
+## Second-pass review
+
+Not required: no messaging, lifecycle, dispatch, context-recovery, coherence, trust, sentinel, guard, gate, or watchdog authority changes.
+
+## Evidence pointers
+
+Focused suite: 127 passed, one pre-existing conditional skip. TypeScript and repository invariants pass. Browser captures: `throughput-2560.png` and `throughput-390.png`.
+
+## Class-Closure Declaration
+
+No agent-authored-artifact defect — not applicable.

package/upgrades/side-effects/slack-outbound-transport-recovery.md

@@ -0,0 +1,14 @@
+# Side-effects Review — Slack outbound transport recovery
+
+## Class review
+
+The missing standard was transport recovery after interface changes: retrying the same undici pool was not evidence of a fresh network path. The process gap was no focused fault-injection check for repeated `fetch failed` across a Wi-Fi transition.
+
+## Decision
+
+The client keeps normal API retry behavior. On three consecutive network fetch failures it destroys and replaces a Slack-client-owned undici dispatcher supplied per request; unrelated HTTP clients are not affected. Successful calls clear the streak.
+
+## Evidence
+
+- Tier 1 focused Socket Mode reconnect suite: 17/17 passing.
+- ELI16: stale sockets are thrown away after three failed tries; the next try gets a fresh network path.