instar 1.3.196 → 1.3.197

package/dist/core/AgentRegistry.d.ts

@@ -14,6 +14,21 @@
  * Agent names are display labels only — NOT unique.
  */
 import type { AgentRegistry, AgentRegistryEntry, AgentType, AgentStatus } from './types.js';
+/**
+ * WHATWG Fetch "bad ports" — node's global `fetch` (undici) throws
+ * `TypeError: fetch failed { cause: 'bad port' }` for any URL on one of these
+ * ports. Instar's multi-machine mesh does ALL of its cross-machine I/O over node
+ * fetch (pairing `POST /api/pair`, lease broadcast/pull, heartbeat), so an agent
+ * whose server lands on a blocked port is SILENTLY unreachable over the mesh —
+ * curl works (it ignores the blocklist), so the failure is invisible. Observed
+ * live 2026-06-02: a paired test agent on port 4045 (NFS `lockd`, on this list)
+ * could never be joined ("fetch failed: bad port") despite curl reaching it. The
+ * default allocation range (4040–4099) contains 4045, so the allocator MUST skip
+ * these. Source: the WHATWG Fetch spec "bad ports" table.
+ */
+export declare const FETCH_BLOCKED_PORTS: ReadonlySet<number>;
+/** True if `port` is on the WHATWG fetch bad-ports list (node `fetch` refuses it). */
+export declare function isFetchBlockedPort(port: number): boolean;
 /**
  * Validate an agent name for use in paths and registration.
  * Rejects names with path separators, null bytes, or `..`.

package/dist/core/AgentRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentRegistry.d.ts","sourceRoot":"","sources":["../../src/core/AgentRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4B5F;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKvD;AAuBD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,aAAa,CAoB5C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAU1D;AAoKD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,CA2BxE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAA2B,EACjC,GAAG,CAAC,EAAE,MAAM,GACX,IAAI,CA8CN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAKvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAUvF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CASjD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAYjD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,MAAe,GAAG,MAAM,IAAI,CA+BzF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE;IAClC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,kBAAkB,EAAE,CAavB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAIrE;AAiBD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAiC,EAC7C,QAAQ,GAAE,MAA+B,GACxC,MAAM,CAyBR;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAIxD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,GAAE,MAAe,GAAG,MAAM,IAAI,CA+BjG;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,MAAiC,EAC7C,QAAQ,GAAE,MAA+B,GACxC,MAAM,CAwBR"}
+{"version":3,"file":"AgentRegistry.d.ts","sourceRoot":"","sources":["../../src/core/AgentRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAY5F;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAOlD,CAAC;AAEH,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAkBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKvD;AAuBD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,aAAa,CAoB5C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAU1D;AAoKD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,CA2BxE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAA2B,EACjC,GAAG,CAAC,EAAE,MAAM,GACX,IAAI,CA8CN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAKvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAUvF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CASjD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAYjD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,MAAe,GAAG,MAAM,IAAI,CA+BzF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE;IAClC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,kBAAkB,EAAE,CAavB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAIrE;AAiBD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAiC,EAC7C,QAAQ,GAAE,MAA+B,GACxC,MAAM,CAyBR;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAIxD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,GAAE,MAAe,GAAG,MAAM,IAAI,CA+BjG;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,MAAiC,EAC7C,QAAQ,GAAE,MAA+B,GACxC,MAAM,CAwBR"}

package/dist/core/AgentRegistry.js

@@ -26,6 +26,30 @@ function registryPath() { return path.join(registryDir(), 'registry.json'); }
 function legacyRegistryPath() { return path.join(registryDir(), 'port-registry.json'); }
 const DEFAULT_PORT_RANGE_START = 4040;
 const DEFAULT_PORT_RANGE_END = 4099;
+/**
+ * WHATWG Fetch "bad ports" — node's global `fetch` (undici) throws
+ * `TypeError: fetch failed { cause: 'bad port' }` for any URL on one of these
+ * ports. Instar's multi-machine mesh does ALL of its cross-machine I/O over node
+ * fetch (pairing `POST /api/pair`, lease broadcast/pull, heartbeat), so an agent
+ * whose server lands on a blocked port is SILENTLY unreachable over the mesh —
+ * curl works (it ignores the blocklist), so the failure is invisible. Observed
+ * live 2026-06-02: a paired test agent on port 4045 (NFS `lockd`, on this list)
+ * could never be joined ("fetch failed: bad port") despite curl reaching it. The
+ * default allocation range (4040–4099) contains 4045, so the allocator MUST skip
+ * these. Source: the WHATWG Fetch spec "bad ports" table.
+ */
+export const FETCH_BLOCKED_PORTS = new Set([
+    1, 7, 9, 11, 13, 15, 17, 19, 20, 21, 22, 23, 25, 37, 42, 43, 53, 69, 77, 79, 87,
+    95, 101, 102, 103, 104, 109, 110, 111, 113, 115, 117, 119, 123, 135, 137, 139,
+    143, 161, 179, 389, 427, 465, 512, 513, 514, 515, 526, 530, 531, 532, 540, 548,
+    554, 556, 563, 587, 601, 636, 989, 990, 993, 995, 1719, 1720, 1723, 2049, 3659,
+    4045, 4190, 5060, 5061, 6000, 6566, 6665, 6666, 6667, 6668, 6669, 6679, 6697,
+    10080,
+]);
+/** True if `port` is on the WHATWG fetch bad-ports list (node `fetch` refuses it). */
+export function isFetchBlockedPort(port) {
+    return FETCH_BLOCKED_PORTS.has(port);
+}
 /** Agent name validation: alphanumeric, underscore, hyphen. Max 64 chars. */
 const AGENT_NAME_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;
 const LOCK_OPTIONS_ASYNC = {
@@ -500,7 +524,7 @@ export function allocatePort(agentPath, rangeStart = DEFAULT_PORT_RANGE_START, r
         // agents that may still be running but have stale registry entries
         const usedPorts = new Set(registry.entries.map(e => e.port));
         for (let port = rangeStart; port <= rangeEnd; port++) {
-            if (!usedPorts.has(port) && isPortFreeSync(port)) {
+            if (!usedPorts.has(port) && !FETCH_BLOCKED_PORTS.has(port) && isPortFreeSync(port)) {
                 return port;
             }
         }
@@ -587,7 +611,7 @@ export function allocatePortByName(projectName, rangeStart = DEFAULT_PORT_RANGE_
         // agents that may still be running but have stale registry entries
         const usedPorts = new Set(registry.entries.map(e => e.port));
         for (let port = rangeStart; port <= rangeEnd; port++) {
-            if (!usedPorts.has(port) && isPortFreeSync(port)) {
+            if (!usedPorts.has(port) && !FETCH_BLOCKED_PORTS.has(port) && isPortFreeSync(port)) {
                 return port;
             }
         }

package/dist/core/AgentRegistry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.196",
+  "version": "1.3.197",
   "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
   "type": "module",
   "main": "dist/index.js",

package/scripts/validate-retro-harvest.mjs

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+/**
+ * validate-retro-harvest.mjs — the schema validator for Apprenticeship Step 0
+ * retro-harvest artifacts (`apprenticeship-retro-harvest/v1`).
+ *
+ * Per APPRENTICESHIP-STEP0-RETRO-HARVEST-SPEC.md §9, this is the structural
+ * SIGNAL — not the authority. It checks the artifact's SHAPE deterministically;
+ * the LLM fidelity review (recorded in frontmatter) is the AUTHORITY for whether
+ * the harvest is faithful. (Signal vs Authority / The Body and the Mind.)
+ *
+ * Two layers:
+ *   - validateRetroHarvest(text, opts)  — PURE, offline, unit-tested. Structure,
+ *     reconciliation, redaction backstop, path safety, completeness, scope rules.
+ *   - checkLiveLedger(frontmatter, fetchImpl) — OPTIONAL live cross-check that
+ *     seeded ids resolve in the running ledger. Network; run by the integration
+ *     test / `--check-live`, never by the pure unit path.
+ *
+ * CLI:  node scripts/validate-retro-harvest.mjs <artifact.md> [--prior] [--check-live]
+ *   exit 0 = valid, exit 1 = invalid (errors to stderr).
+ */
+
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import yaml from 'js-yaml';
+
+export const SCHEMA_ID = 'apprenticeship-retro-harvest/v1';
+export const INSTANCE_TYPES = ['mentorship', 'apprenticeship'];
+export const SCOPE_MODES = ['full', 'incremental'];
+export const COMPLETENESS = ['complete', 'partial-accepted'];
+export const FIDELITY_VERDICTS = ['faithful', 'partial', 'rejected'];
+export const HARVEST_DIR = 'docs/apprenticeship/retro-harvests';
+
+/** Scrubbers Step 0 trusts. A missing/unknown/failed scrub refuses the artifact (§7). */
+export const APPROVED_SCRUBBERS = ['correction-scrub', 'instar-pii-scrub'];
+
+/** Evidence-pointer URI schemes (§6). */
+export const POINTER_PATTERNS = {
+  ledger: /^ledger:[0-9a-f-]{6,}$/i,            // validator-resolvable
+  pr: /^pr:\d+$/,                                // validator-resolvable
+  thread: /^thread:\d+#[\w.-]+$/,               // immutable msg locator; fidelity-review-only
+  memory: /^memory:[a-z0-9_-]+@[0-9a-f]{6,}#[\w.-]+$/i, // slug@hash#anchor; fidelity-review-only
+};
+
+/** Secret-shaped strings the backstop rejects (§7). A LIMITED backstop, not a scrub. */
+const SECRET_PATTERNS = [
+  { name: 'bearer-token', re: /\bBearer\s+[A-Za-z0-9._-]{8,}/ },
+  { name: 'tunnel-sig', re: /[?&]sig=[0-9a-f]{16,}/i },
+  { name: 'long-hex-blob', re: /\b[0-9a-f]{40,}\b/i },
+  { name: 'long-base64-blob', re: /\b[A-Za-z0-9+/]{50,}={0,2}\b/ },
+  { name: 'email', re: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/ },
+];
+
+/**
+ * Split a markdown doc into { frontmatter (parsed), body (string) }.
+ * Throws if there is no `---`-delimited YAML frontmatter.
+ */
+export function parseArtifact(text) {
+  const m = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/.exec(text);
+  if (!m) throw new Error('no YAML frontmatter (--- … ---) found');
+  const frontmatter = yaml.load(m[1]) || {};
+  return { frontmatter, body: m[2] || '' };
+}
+
+/** Count top-level `- ` bullet items directly under a `## <heading>` section. */
+export function countSectionItems(body, heading) {
+  const lines = body.split('\n');
+  let inSection = false;
+  let count = 0;
+  const headingRe = new RegExp('^##\\s+' + heading.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'i');
+  for (const line of lines) {
+    if (/^##\s+/.test(line)) inSection = headingRe.test(line);
+    else if (inSection && /^-\s+\S/.test(line)) count++;
+  }
+  return count;
+}
+
+/** True when the body contains a secret-shaped string (returns the matched pattern name or null). */
+export function findSecret(body) {
+  for (const { name, re } of SECRET_PATTERNS) {
+    if (re.test(body)) return name;
+  }
+  return null;
+}
+
+/**
+ * Resolve + confine an artifact path to HARVEST_DIR. Returns the safe relative
+ * path or throws on traversal / bad component (§6 security).
+ */
+export function safeArtifactPath(from, to, instanceType) {
+  for (const [k, v] of Object.entries({ from, to, instanceType })) {
+    if (typeof v !== 'string' || !/^[a-z0-9-]+$/.test(v)) {
+      throw new Error(`unsafe path component ${k}="${v}" (must match ^[a-z0-9-]+$)`);
+    }
+  }
+  const rel = `${HARVEST_DIR}/${from}-to-${to}-${instanceType}.md`;
+  const resolved = path.normalize(rel);
+  if (resolved.includes('..') || !resolved.startsWith(HARVEST_DIR + path.sep) && !resolved.startsWith(HARVEST_DIR + '/')) {
+    throw new Error(`path escapes ${HARVEST_DIR}: ${resolved}`);
+  }
+  return rel;
+}
+
+/**
+ * PURE structural validation of a retro-harvest artifact.
+ * @param {string} text - full artifact markdown
+ * @param {{ priorHarvestExists?: boolean }} [opts]
+ * @returns {{ valid: boolean, errors: string[] }}
+ */
+export function validateRetroHarvest(text, opts = {}) {
+  const errors = [];
+  const priorHarvestExists = !!opts.priorHarvestExists;
+
+  let parsed;
+  try {
+    parsed = parseArtifact(text);
+  } catch (e) {
+    return { valid: false, errors: [`parse: ${e.message}`] };
+  }
+  const { frontmatter: fm, body } = parsed;
+
+  // --- schema id
+  if (fm.schema !== SCHEMA_ID) errors.push(`schema must be "${SCHEMA_ID}" (got "${fm.schema}")`);
+
+  // --- required scalar fields
+  for (const f of ['instanceType', 'from', 'to', 'framework', 'harvestedAt', 'scopeMode', 'completeness']) {
+    if (fm[f] == null || fm[f] === '') errors.push(`missing required field: ${f}`);
+  }
+  if (fm.instanceType && !INSTANCE_TYPES.includes(fm.instanceType))
+    errors.push(`instanceType must be one of ${INSTANCE_TYPES.join('|')}`);
+  if (fm.scopeMode && !SCOPE_MODES.includes(fm.scopeMode))
+    errors.push(`scopeMode must be one of ${SCOPE_MODES.join('|')}`);
+  if (fm.completeness && !COMPLETENESS.includes(fm.completeness))
+    errors.push(`completeness must be one of ${COMPLETENESS.join('|')}`);
+
+  // --- path safety on the identity components
+  if (fm.from && fm.to && fm.instanceType) {
+    try { safeArtifactPath(fm.from, fm.to, fm.instanceType); }
+    catch (e) { errors.push(`path: ${e.message}`); }
+  }
+
+  // --- scope rule: first harvest (no prior baseline) MUST be full (§8)
+  if (fm.scopeMode === 'incremental' && !priorHarvestExists)
+    errors.push('scopeMode "incremental" requires a prior harvest baseline; the first harvest must be "full"');
+
+  // --- sourcesCovered: coverage EXTENT, not bare booleans (§8)
+  const sc = fm.sourcesCovered;
+  if (!sc || typeof sc !== 'object') {
+    errors.push('missing sourcesCovered');
+  } else {
+    if (!sc.ledger || typeof sc.ledger.issueCount !== 'number')
+      errors.push('sourcesCovered.ledger must carry { read, issueCount }');
+    if (!sc.playbook || typeof sc.playbook.entryCount !== 'number')
+      errors.push('sourcesCovered.playbook must carry { read, entryCount }');
+    if (!Array.isArray(sc.threads))
+      errors.push('sourcesCovered.threads must be an array of { id, messagesRead, truncated }');
+    else for (const t of sc.threads) {
+      if (typeof t.messagesRead !== 'number' || typeof t.truncated !== 'boolean')
+        errors.push(`sourcesCovered.threads[${t && t.id}] needs numeric messagesRead + boolean truncated (coverage extent, not presence)`);
+    }
+  }
+
+  // --- completeness vs truncation (§8): complete ⇒ nothing truncated
+  if (fm.completeness === 'complete' && sc && Array.isArray(sc.threads)) {
+    if (sc.threads.some((t) => t.truncated === true))
+      errors.push('completeness "complete" is invalid when a source is truncated; use "partial-accepted" with named gaps');
+  }
+
+  // --- counts reconcile with body (§9)
+  const counts = fm.counts || {};
+  const bodyLessons = countSectionItems(body, 'Lessons');
+  const bodyMeta = countSectionItems(body, 'Meta-lessons');
+  const bodyProc = countSectionItems(body, 'Process-insights');
+  const bodyNeeds = countSectionItems(body, 'What the program needs');
+  if (counts.lessons !== bodyLessons)
+    errors.push(`counts.lessons=${counts.lessons} but body has ${bodyLessons} "## Lessons" items`);
+  if (counts.metaLessons !== bodyMeta)
+    errors.push(`counts.metaLessons=${counts.metaLessons} but body has ${bodyMeta} "## Meta-lessons" items`);
+  if (counts.processInsights !== bodyProc)
+    errors.push(`counts.processInsights=${counts.processInsights} but body has ${bodyProc} "## Process-insights" items`);
+  if (fm.programNeeds !== bodyNeeds)
+    errors.push(`programNeeds=${fm.programNeeds} but body has ${bodyNeeds} "## What the program needs" items`);
+
+  // --- redaction: approved scrubber, not failed (§7)
+  const r = fm.redaction;
+  if (!r || typeof r !== 'object') {
+    errors.push('missing redaction { scrubber, findingsRemoved, scrubbedAt }');
+  } else {
+    const scrubberName = String(r.scrubber || '').split('@')[0];
+    if (!APPROVED_SCRUBBERS.includes(scrubberName))
+      errors.push(`redaction.scrubber "${r.scrubber}" not in approved list (${APPROVED_SCRUBBERS.join(', ')})`);
+    if (r.status === 'failed') errors.push('redaction.status is "failed" — scrub must succeed before write');
+    if (typeof r.findingsRemoved !== 'number') errors.push('redaction.findingsRemoved must be a number');
+  }
+
+  // --- fidelity review: the authority's stamp (§9)
+  const fr = fm.fidelityReview;
+  if (!fr || typeof fr !== 'object') {
+    errors.push('missing fidelityReview { reviewer, verdict, at }');
+  } else {
+    if (!FIDELITY_VERDICTS.includes(fr.verdict))
+      errors.push(`fidelityReview.verdict must be one of ${FIDELITY_VERDICTS.join('|')}`);
+    if (fr.verdict === 'rejected') errors.push('fidelityReview.verdict is "rejected" — harvest is not faithful');
+    if (fr.verdict === 'partial' && !fr.gaps && !(fr.audit && fr.audit.gaps))
+      errors.push('fidelityReview "partial" must name the gaps (fidelityReview.gaps)');
+    if (!fr.reviewer) errors.push('fidelityReview.reviewer required (must be independent of the harvesting pass)');
+  }
+
+  // --- evidence pointers well-formed (§6). Strip trailing sentence punctuation
+  // so a pointer at a clause boundary ("ledger:abc123, priority…") still validates.
+  const pointerTokens = (body.match(/\b(?:ledger|pr|thread|memory):[^\s)\]]+/g) || [])
+    .map((t) => t.replace(/[.,;:]+$/, ''));
+  for (const tok of pointerTokens) {
+    const scheme = tok.split(':')[0];
+    const re = POINTER_PATTERNS[scheme];
+    if (re && !re.test(tok)) errors.push(`malformed evidence pointer: ${tok}`);
+  }
+
+  // --- secret backstop (§7)
+  const secret = findSecret(body);
+  if (secret) errors.push(`secret-shaped string in body (${secret}) — pointers-not-payloads (§7)`);
+
+  return { valid: errors.length === 0, errors };
+}
+
+/**
+ * OPTIONAL live cross-check: every seededToPlaybook id resolves at candidate+ in
+ * the running ledger. Network — never part of the pure unit path. Inject fetch.
+ * @returns {Promise<{ ok: boolean, errors: string[] }>}
+ */
+export async function checkLiveLedger(frontmatter, fetchImpl) {
+  const errors = [];
+  const seeded = Array.isArray(frontmatter.seededToPlaybook) ? frontmatter.seededToPlaybook : [];
+  for (const s of seeded) {
+    const id = s && s.id;
+    if (!id) { errors.push('seededToPlaybook entry without id'); continue; }
+    try {
+      const res = await fetchImpl(id);
+      if (!res || !res.found) errors.push(`seeded id ${id} not found in live ledger`);
+      else if (!['candidate', 'extracted'].includes(res.playbookStatus))
+        errors.push(`seeded id ${id} is "${res.playbookStatus}", expected candidate+`);
+    } catch (e) {
+      errors.push(`live check for ${id} failed: ${e.message}`);
+    }
+  }
+  return { ok: errors.length === 0, errors };
+}
+
+// --- CLI entry (guarded so importing for tests is side-effect-free)
+const isMain = (() => {
+  try { return process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1]); }
+  catch { return false; }
+})();
+
+if (isMain) {
+  const args = process.argv.slice(2);
+  const file = args.find((a) => !a.startsWith('--'));
+  const priorHarvestExists = args.includes('--prior');
+  if (!file) {
+    console.error('usage: validate-retro-harvest.mjs <artifact.md> [--prior] [--check-live]');
+    process.exit(1);
+  }
+  const text = readFileSync(file, 'utf8');
+  const { valid, errors } = validateRetroHarvest(text, { priorHarvestExists });
+  if (!valid) {
+    console.error(`INVALID: ${file}`);
+    for (const e of errors) console.error('  - ' + e);
+    process.exit(1);
+  }
+  console.log(`valid: ${file}`);
+  process.exit(0);
+}

package/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-06-02T02:41:08.992Z",
-  "instarVersion": "1.3.196",
+  "generatedAt": "2026-06-02T04:46:08.483Z",
+  "instarVersion": "1.3.197",
   "entryCount": 193,
   "entries": {
     "hook:session-start": {

package/upgrades/1.3.197.md

@@ -0,0 +1,24 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+Agents are no longer assigned a network port that the multi-machine mesh secretly can't reach.
+
+The mesh talks between machines using Node's built-in web-request function, which refuses a short standard list of "bad ports" (for example 4045, the old file-lock service port). That list includes a port inside the default range agents were picked from — so an agent could be handed a port on which it would silently fail to pair or fail over, with no error in normal tools. The port picker now skips those bad ports, and any agent already running on one prints a clear startup warning telling you to change its port.
+
+## What to Tell Your User
+
+Nothing to do for new agents — they'll automatically avoid the handful of reserved ports that break multi-machine networking. If you run multiple machines and one happens to be on a bad port, the agent now warns you at startup with the exact fix (change its port and restart). This removes a silent, very-hard-to-spot failure where an agent looked healthy but could never join the mesh.
+
+## Summary of New Capabilities
+
+- The agent port allocator skips WHATWG fetch "bad ports" (4045, 6000, 6566, 6697, …), so a new agent never lands on a port the mesh's node-fetch comms can't reach.
+- A new exported helper, isFetchBlockedPort, plus an unconditional server-startup warning when an existing agent's configured port is on that list (the migration path for already-running agents).
+
+## Evidence
+
+- Root cause of a real 2026-06-02 failure: a paired test agent on port 4045 could never be joined ("fetch failed: bad port") even though curl reached its pairing endpoint; moving it off 4045 fixed the join immediately.
+- `tsc --noEmit` clean; 34 agent-registry unit tests green, including 3 new ones covering the blocklist helper (both sides of the boundary) and the allocator skipping a blocked port. Side-effects review: upgrades/side-effects/fix-fetch-blocked-ports.md.

package/upgrades/side-effects/APPRENTICESHIP-STEP0-RETRO-HARVEST-SPEC.md

@@ -0,0 +1,78 @@
+# Side-Effects Review — Apprenticeship Step 0: Retro-Harvest
+
+**Version / slug:** `APPRENTICESHIP-STEP0-RETRO-HARVEST-SPEC`
+**Date:** `2026-06-01`
+**Author:** `echo`
+**Second-pass reviewer:** `not required` (converged via /spec-converge: 5 internal reviewers + codex gpt-5.5, 3 rounds)
+
+## Summary of the change
+
+Builds Step 0 of the Apprenticeship Program (Tier-3 umbrella #675). Ships:
+- `scripts/validate-retro-harvest.mjs` — the pure, offline schema validator (the structural
+  SIGNAL) for `apprenticeship-retro-harvest/v1` artifacts, plus an optional injected-fetch
+  live-ledger cross-check.
+- `tests/unit/validate-retro-harvest.test.ts` (34 cases, both sides of every boundary) +
+  `tests/integration/retro-harvest-artifact.test.ts` (the real artifact as a fixture-of-record).
+- `docs/apprenticeship/RETRO-HARVEST-PROCEDURE.md` — the repeatable how-to.
+- `docs/apprenticeship/retro-harvests/echo-to-codey-mentorship.md` — the first real harvest,
+  grounded in the live ledger (28 issues), reviewed by an independent fidelity reviewer.
+- `docs/apprenticeship/retro-harvests/INDEX.json` — the latest-harvest pointer.
+
+No `src/` is touched. The validator is a standalone `scripts/` tool not imported by `src/`.
+
+## Decision-point inventory
+
+One: the validator's pass/fail boundary (`validateRetroHarvest`). It is a **signal**, not an
+authority (spec §9) — it asserts artifact SHAPE (schema, required fields, count/programNeeds
+reconciliation, coverage-extent, scope/completeness rules, evidence-pointer well-formedness,
+a limited secret-pattern backstop, path confinement, an approved+succeeded scrub, and a
+non-`rejected` fidelity verdict). It does NOT judge harvest fidelity — that is the independent
+LLM fidelity review, recorded in the artifact frontmatter.
+
+## 1. Over-block
+
+**What legitimate inputs does this reject?** A structurally malformed artifact (missing fields,
+counts that disagree with the body, an incremental first harvest, a `complete` artifact with a
+truncated source, an unapproved/failed scrub, a `rejected` fidelity verdict, a secret-shaped
+string, a malformed pointer). All are genuine defects the gate is meant to refuse. Trailing
+sentence punctuation after a pointer is tolerated (stripped before validation) so a clause-
+boundary pointer is not falsely rejected.
+
+## 2. Under-block
+
+**What does this still miss?** By design, the validator does NOT judge whether the harvest is
+*truthful or complete* — a well-shaped but hollow harvest passes the validator; the LLM fidelity
+review is the authority that catches that (Signal vs Authority). The secret-pattern scan is an
+explicit *limited backstop*, not a scrub guarantee (it misses API keys, hostnames, sig-less
+URLs, names, phone numbers, contextual PII); the authoritative defense is the approved scrubber.
+Live-ledger resolution of seeded ids runs only under `--check-live` / the integration path, not
+the pure unit path.
+
+## 3. Level-of-abstraction fit
+
+**Right layer?** Yes. The validator is a pure function with a thin CLI guard, in `scripts/`
+beside the other repo-invariant validators, unit-testable with no git/fs/network mocking. The
+harvest artifact + procedure + index are plain repo docs under `docs/apprenticeship/`. The gate
+that will *require* a valid harvest before an instance starts is deliberately deferred to Step 1
+(spec §12–13) — this step ships the artifact + the validator the gate will call.
+
+## 4. Testing
+
+- **Unit** (`tests/unit/validate-retro-harvest.test.ts`): 34 cases — valid baseline + a targeted
+  failing mutation per decision boundary + `checkLiveLedger` with an injected fetch.
+- **Integration** (`tests/integration/retro-harvest-artifact.test.ts`): the REAL
+  `echo-to-codey-mentorship.md` validates against the REAL validator; it is a full first harvest
+  with an independent (non-Echo) fidelity reviewer; seeds nothing (#50-independent); is INDEX-
+  registered.
+- **E2E:** genuinely n/a — pure CLI validator, no HTTP route, no DI (spec §9, §11).
+
+## 5. Migration / rollback / Agent-Awareness
+
+- **Migration Parity:** N/A. No agent-installed files (`.claude/`, `.instar/config.json`, hooks,
+  skills, CLAUDE.md template), no config defaults, no `src/`. Pure repo docs + one `scripts/`
+  helper + tests.
+- **Rollback:** revert the commit; nothing is deployed to agents, no state is written.
+- **Agent-Awareness:** explicitly deferred to Step 1 (spec §12) — the awareness surface ("a valid
+  harvest is required before an instance starts") belongs with the gate Step 1 wires, not before
+  it exists.
+- **NEXT.md / publish:** no `src/` change → no fleet-release/publish concern.

package/upgrades/side-effects/fix-fetch-blocked-ports.md

@@ -0,0 +1,74 @@
+# Side-Effects Review — Skip WHATWG fetch-blocked ports in agent port allocation
+
+**Version / slug:** `fix-fetch-blocked-ports`
+**Date:** `2026-06-02`
+**Author:** `echo`
+**Tier:** 1 (small, low-risk; ELI16 + side-effects, no converged spec)
+**Parent principle:** Cross-Machine Coherence — One Agent, Robust Under Degraded Conditions
+
+## Summary of the change
+
+Instar's multi-machine mesh does ALL cross-machine I/O over node's global `fetch`
+(pairing `POST /api/pair`, lease broadcast/pull, heartbeat). Node's `fetch` (undici)
+throws `TypeError: fetch failed { cause: 'bad port' }` for any URL whose port is on the
+WHATWG Fetch spec "bad ports" list. The default agent port-allocation range (4040–4099)
+**contains 4045** (NFS `lockd`, a blocked port), so the allocator could hand an agent a
+port on which it can **never** be reached over the mesh — silently, because `curl`
+ignores the blocklist so the endpoint looks healthy.
+
+**Observed live (2026-06-02):** a freshly-paired throwaway test agent landed on 4045 and
+could not be joined — `instar join` failed with "fetch failed" despite `curl` to the same
+`/api/pair` returning 400. Moving it off 4045 fixed the join instantly.
+
+### What changed
+- `src/core/AgentRegistry.ts`: added `FETCH_BLOCKED_PORTS` (the WHATWG bad-ports set) +
+  exported `isFetchBlockedPort(port)`. Both `allocatePort` and `allocatePortByName` now
+  skip blocked ports (in addition to used + lsof-busy ones).
+- `src/commands/server.ts`: an unconditional startup warning when `config.port` is a
+  blocked port — the migration-parity path for EXISTING agents already on one (the
+  allocator guard only protects newly-allocated agents).
+
+## Decision-point inventory
+- allocator: skip vs allocate a port → skip if on the blocklist (the check precedes the
+  lsof probe, so it's deterministic).
+- startup: warn vs silent → warn (loud, non-fatal) when an existing config sits on a
+  blocked port; we do NOT auto-re-port (that would change a running agent's port — left
+  to the operator).
+
+## 1. Over-correction risk
+The blocklist is the fixed WHATWG set; legitimate agent ports (4040–4044, 4046–4099, etc.)
+are unaffected. Only 4045 falls in the default range. Skipping reduces the usable range by
+one port — negligible (60→59).
+
+## 2. Under-correction risk
+Existing agents already on a blocked port aren't auto-fixed (that would change their port);
+the startup warning surfaces it so the operator re-ports. Acceptable — auto-re-porting a
+live agent is riskier than a loud warning.
+
+## 3. Level-of-abstraction fit
+The skip lives in the single port allocator both callers use; the warning at the single
+server-start path. No scattering.
+
+## 4. Signal vs Authority
+Pure deterministic check against a fixed spec list — no LLM, no heuristic. Appropriate.
+
+## 5. External surfaces
+None. No route/config-schema change. `isFetchBlockedPort` is a new pure export.
+
+## 6. Interactions with existing primitives
+The allocator's existing used-port + lsof checks are unchanged; the blocklist is an
+additional AND condition. The warning composes with the existing startup logs.
+
+## 7. Rollback cost
+Trivial: remove the `&& !FETCH_BLOCKED_PORTS.has(port)` clauses + the warning. No state.
+
+## Migration parity
+- New agents: allocator skips blocked ports (no action needed).
+- Existing agents on a blocked port: the startup warning surfaces it (operator re-ports).
+- Pure code; reaches existing agents on the normal dist update. No config/hook migration.
+
+## Tests
+`tsc --noEmit` clean. 34 `agent-registry` unit tests green, including 3 new: `isFetchBlockedPort`
+both sides of the boundary (4045/6000/6697/2049 blocked; 4040/4046/4050/4099 not),
+`allocatePort` throws rather than return a sole blocked candidate, and `allocatePort` skips
+a blocked port to return the next usable one.