zob-harness 0.2.0 → 0.3.1

package/.pi/extensions/zob-harness/src/{autonomy-readiness.ts → domains/autonomy/autonomy-readiness.ts}

@@ -2,15 +2,15 @@ import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSy
 import { join } from "node:path";
 
 import { buildAutonomousRuntimeDryRun, validateAutonomousReadOnlySmokeRunArtifacts, validateAutonomousRuntimeDryRunArtifacts } from "./autonomous-runtime.js";
-import { buildCapabilityIndex } from "./capabilities.js";
-import { buildContextGbrainReadinessAudit } from "./context-gbrain.js";
-import { loadFactoryDefinition, loadFactoryInputManifest, validateFactoryStages } from "./factory/validation.js";
-import { validateStrictGoalSpecAnchor } from "./goal.js";
-import { validateDelegationWriteScope } from "./safety.js";
-import { sha256 } from "./utils/hashing.js";
-import { parseJsonFile } from "./utils/json.js";
-import { safeFileStem } from "./utils/paths.js";
-import { isRecord } from "./utils/records.js";
+import { buildCapabilityIndex } from "../delegation/capabilities.js";
+import { buildContextGbrainReadinessAudit } from "../context/context-gbrain.js";
+import { loadFactoryDefinition, loadFactoryInputManifest, validateFactoryStages } from "../factory/validation.js";
+import { validateStrictGoalSpecAnchor } from "../goal/goal.js";
+import { validateDelegationWriteScope } from "../governance/safety.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { parseJsonFile } from "../../core/utils/json.js";
+import { safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 
 export interface AutonomyReadinessAuditInput {
   run_id?: string;
@@ -43,16 +43,16 @@ const REGISTERED_FACTORY_SOURCE_FINGERPRINT_BASE_FILES = [
   ".pi/model-routing.json",
   ".pi/extensions/zob-harness/index.ts",
   ".pi/extensions/zob-harness/src/runtime/tools-factory.ts",
-  ".pi/extensions/zob-harness/src/budget-policy.ts",
-  ".pi/extensions/zob-harness/src/model-routing.ts",
-  ".pi/extensions/zob-harness/src/schemas.ts",
+  ".pi/extensions/zob-harness/src/domains/governance/budget-policy.ts",
+  ".pi/extensions/zob-harness/src/domains/models/model-routing.ts",
+  ".pi/extensions/zob-harness/src/runtime/schemas.ts",
   ".pi/extensions/zob-harness/src/types.ts",
-  ".pi/extensions/zob-harness/src/telemetry.ts",
-  ".pi/extensions/zob-harness/src/factory/run.ts",
-  ".pi/extensions/zob-harness/src/factory/agentic-plan.ts",
-  ".pi/extensions/zob-harness/src/factory/validation.ts",
-  ".pi/extensions/zob-harness/src/child-runner.ts",
-  ".pi/extensions/zob-harness/src/output-contracts.ts",
+  ".pi/extensions/zob-harness/src/domains/telemetry/telemetry.ts",
+  ".pi/extensions/zob-harness/src/domains/factory/run.ts",
+  ".pi/extensions/zob-harness/src/domains/factory/agentic-plan.ts",
+  ".pi/extensions/zob-harness/src/domains/factory/validation.ts",
+  ".pi/extensions/zob-harness/src/domains/delegation/child-runner.ts",
+  ".pi/extensions/zob-harness/src/domains/delegation/output-contracts.ts",
 ];
 
 function uniqueSorted(items: string[]): string[] {

package/.pi/extensions/zob-harness/src/{daemon-policy.ts → domains/autonomy/daemon-policy.ts}

@@ -1,12 +1,12 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
-import { READ_ONLY_QUEUE_JOB_TYPES } from "./queue.js";
-import type { ChildStopCondition } from "./types.js";
-import { sha256 } from "./utils/hashing.js";
-import { parseJsonFile } from "./utils/json.js";
-import { safeFileStem } from "./utils/paths.js";
-import { isRecord } from "./utils/records.js";
+import { READ_ONLY_QUEUE_JOB_TYPES } from "../telemetry/queue.js";
+import type { ChildStopCondition } from "../../types.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { parseJsonFile } from "../../core/utils/json.js";
+import { safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 
 export interface DaemonPolicyReadinessAuditInput {
   run_id?: string;

package/.pi/extensions/zob-harness/src/{daemon-readiness.ts → domains/autonomy/daemon-readiness.ts}

@@ -1,14 +1,14 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
-import { evaluateBudgetPreflightDryRun } from "./chronicle.js";
+import { evaluateBudgetPreflightDryRun } from "../telemetry/chronicle.js";
 import { validateDaemonPolicyConfig } from "./daemon-policy.js";
-import { evaluateModelRoutingDryRun } from "./model-routing.js";
-import { buildQueueDashboardSummary, ensureQueueDirs, READ_ONLY_QUEUE_JOB_TYPES, validateReadOnlyQueueJob } from "./queue.js";
-import { sha256 } from "./utils/hashing.js";
-import { parseJsonFile } from "./utils/json.js";
-import { safeFileStem } from "./utils/paths.js";
-import { isRecord } from "./utils/records.js";
+import { evaluateModelRoutingDryRun } from "../models/model-routing.js";
+import { buildQueueDashboardSummary, ensureQueueDirs, READ_ONLY_QUEUE_JOB_TYPES, validateReadOnlyQueueJob } from "../telemetry/queue.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { parseJsonFile } from "../../core/utils/json.js";
+import { safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 
 export interface DaemonReadinessDryRunInput {
   run_id?: string;

package/.pi/extensions/zob-harness/src/{daemon-runtime.ts → domains/autonomy/daemon-runtime.ts}

@@ -1,6 +1,6 @@
 import type { InteractiveAutonomyMode, InteractiveLaunchAuthorization, MissionReadinessReport } from "./interactive-autonomy.js";
-import type { RuntimeGoal, RuntimeGoalStatus } from "./goal-runtime.js";
-import type { GoalTodoNode, GoalTodoState, GoalTodoStatus } from "./goal-todos.js";
+import type { RuntimeGoal, RuntimeGoalStatus } from "../../runtime/goal-runtime.js";
+import type { GoalTodoNode, GoalTodoState, GoalTodoStatus } from "../goal/goal-todos.js";
 
 export const DAEMON_RUNTIME_STATUSES = [
   "off",

package/.pi/extensions/zob-harness/src/{full-autonomy-test.ts → domains/autonomy/full-autonomy-test.ts}

@@ -1,10 +1,10 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
-import { loadFactorySelectorCandidates, selectFactoryForDemands, type FactorySelectorResult } from "./factory-selector.js";
-import { buildControlledWorkerPoolPlan, evaluateLaunchAuthorizedApplyGate, type ControlledWorkerPoolPlan, type LaunchAuthorizedApplyGate } from "./launch-apply.js";
-import { sha256 } from "./utils/hashing.js";
-import { safeFileStem } from "./utils/paths.js";
+import { loadFactorySelectorCandidates, selectFactoryForDemands, type FactorySelectorResult } from "../factory/factory-selector.js";
+import { buildControlledWorkerPoolPlan, evaluateLaunchAuthorizedApplyGate, type ControlledWorkerPoolPlan, type LaunchAuthorizedApplyGate } from "../governance/launch-apply.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { safeFileStem } from "../../core/utils/paths.js";
 
 export interface FullAutonomyTestInput {
   runId?: string;

package/.pi/extensions/zob-harness/src/{interactive-autonomy.ts → domains/autonomy/interactive-autonomy.ts}

@@ -1,8 +1,8 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 
-import { sha256 } from "./utils/hashing.js";
-import { isRecord } from "./utils/records.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { isRecord } from "../../core/utils/records.js";
 
 export const INTERACTIVE_AUTONOMY_MODES = ["off", "open", "controlled", "adaptive"] as const;
 export type InteractiveAutonomyMode = typeof INTERACTIVE_AUTONOMY_MODES[number];

package/.pi/extensions/zob-harness/src/{compute-profile.ts → domains/compute/compute-profile.ts}

@@ -1,9 +1,9 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { basename, extname, join, relative, resolve } from "node:path";
 
-import { sha256 } from "./utils/hashing.js";
-import { resolveRepoPath, safeFileStem, safeRunId } from "./utils/paths.js";
-import { isRecord } from "./utils/records.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { resolveRepoPath, safeFileStem, safeRunId } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 
 export type ComputeRequestedProfile = "auto" | "low" | "medium" | "high" | "xhigh" | "max";
 export type ComputeEffectiveProfile = Exclude<ComputeRequestedProfile, "auto">;

package/.pi/extensions/zob-harness/src/{compute-workflow-shape.ts → domains/compute/compute-workflow-shape.ts}

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
-import { sha256 } from "./utils/hashing.js";
-import { resolveRepoPath } from "./utils/paths.js";
-import { isRecord } from "./utils/records.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { resolveRepoPath } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 import { resolveComputeProfile, type ComputeDomain, type ComputeEffectiveProfile, type ComputePreviewInput, type ComputeRequestedProfile } from "./compute-profile.js";
 
 export interface ComputeWorkflowShapeInput extends ComputePreviewInput {

package/.pi/extensions/zob-harness/src/domains/coms/AGENTS.md

@@ -0,0 +1,21 @@
+# Coms domain guardrail
+
+## Scope
+
+- Hash-only/local communication domains, Mission Control metadata, governed request extraction, topology-facing coms helpers, and coms-v2 compatibility.
+
+## MUST DO
+
+- Preserve hash-only/body-free ledgers, stale/offline peer blockers, bounded awaits, and topology guards.
+- Keep Goal Room parent-visible as canonical for coordination decisions.
+
+## MUST NOT
+
+- Do not persist raw prompts, outputs, rationale, diffs, patches, or message bodies.
+- Do not introduce hidden worker-to-worker direct chat or network transport.
+- Do not import from `index.ts` or `index.js`.
+
+## Validation
+
+- `npm run check -- --pretty false`.
+- `npm run smoke:harness` plus coms-specific smoke if coms transport paths move.

package/.pi/extensions/zob-harness/src/{coms-v2 → domains/coms/coms-v2}/envelope.ts

@@ -1,5 +1,5 @@
-import { sha256 } from "../utils/hashing.js";
-import { isRecord } from "../utils/records.js";
+import { sha256 } from "../../../core/utils/hashing.js";
+import { isRecord } from "../../../core/utils/records.js";
 
 const FORBIDDEN_PERSISTED_KEYS = new Set(["body", "task", "prompt", "output", "content", "message", "rationale", "text", "diff", "patch"]);
 const ENVELOPE_TYPES = new Set(["ping", "pong", "prompt", "ack", "response", "error"]);

package/.pi/extensions/zob-harness/src/{coms-v2 → domains/coms/coms-v2}/identity.ts

@@ -1,8 +1,8 @@
 import { basename } from "node:path";
 
-import type { TeamDefinition, TeamLead, TeamWorker } from "../types.js";
-import { sha256 } from "../utils/hashing.js";
-import { safeFileStem } from "../utils/paths.js";
+import type { TeamDefinition, TeamLead, TeamWorker } from "../../../types.js";
+import { sha256 } from "../../../core/utils/hashing.js";
+import { safeFileStem } from "../../../core/utils/paths.js";
 import type { ZobComsV2Policy, ZobLivePeerCard, ZobLiveRoleType } from "./types.js";
 
 const PROCESS_STARTED_AT = new Date().toISOString();

package/.pi/extensions/zob-harness/src/{coms-v2 → domains/coms/coms-v2}/ledger-bridge.ts

@@ -1,5 +1,5 @@
-import type { TeamDefinition } from "../types.js";
-import { appendZobComsMessage, replyZobComsMessage, transitionZobComsStatus } from "../topology/coms.js";
+import type { TeamDefinition } from "../../../types.js";
+import { appendZobComsMessage, replyZobComsMessage, transitionZobComsStatus } from "../../topology/coms.js";
 import type { ZobLiveEnvelope } from "./envelope.js";
 
 export function appendLiveSendRequestedRef(repoRoot: string, definition: TeamDefinition, envelope: ZobLiveEnvelope): Record<string, unknown> {

package/.pi/extensions/zob-harness/src/{coms-v2 → domains/coms/coms-v2}/local-transport.ts

@@ -3,7 +3,7 @@ import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
 import { createConnection, createServer, type Server, type Socket } from "node:net";
 
-import { safeFileStem } from "../utils/paths.js";
+import { safeFileStem } from "../../../core/utils/paths.js";
 import { buildZobLiveErrorEnvelope, parseZobLiveEnvelopeLine, validateZobLiveEnvelope, type ZobLiveEnvelope } from "./envelope.js";
 
 export interface ZobLocalTransportServer {

package/.pi/extensions/zob-harness/src/{coms-v2 → domains/coms/coms-v2}/policy.ts

@@ -1,9 +1,9 @@
 import { join } from "node:path";
 
 import type { ZobComsTranscriptMode, ZobComsTranscriptRetentionClass, ZobComsTransportMode, ZobComsV2Policy } from "./types.js";
-import { sha256 } from "../utils/hashing.js";
-import { readJsonObjectIfPresent } from "../utils/json.js";
-import { isRecord } from "../utils/records.js";
+import { sha256 } from "../../../core/utils/hashing.js";
+import { readJsonObjectIfPresent } from "../../../core/utils/json.js";
+import { isRecord } from "../../../core/utils/records.js";
 
 const TRANSPORT_POLICY_RELATIVE_PATH = ".pi/mission-control/zob_coms_transport.json";
 const MODES = new Set<ZobComsTransportMode>(["off", "observe_only", "required_local", "required_network", "break_glass_ledger_only"]);

package/.pi/extensions/zob-harness/src/{coms-v2 → domains/coms/coms-v2}/presence.ts

@@ -1,4 +1,4 @@
-import { sha256 } from "../utils/hashing.js";
+import { sha256 } from "../../../core/utils/hashing.js";
 import { readZobLiveRegistrySnapshot } from "./registry.js";
 import { readZobComsV2Policy } from "./policy.js";
 import type { ZobLivePeerCard, ZobLivePresenceSummary } from "./types.js";

package/.pi/extensions/zob-harness/src/{coms-v2 → domains/coms/coms-v2}/registry.ts

@@ -1,15 +1,17 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 
-import { loadTeamDefinition, validateTeamDefinition } from "../topology/teams.js";
-import { isRecord } from "../utils/records.js";
-import { safeFileStem } from "../utils/paths.js";
+import { loadTeamDefinition, validateTeamDefinition } from "../../topology/teams.js";
+import { isRecord } from "../../../core/utils/records.js";
+import { safeFileStem } from "../../../core/utils/paths.js";
 import { buildCurrentZobLivePeerCard, buildZobComsProjectId } from "./identity.js";
 import { readZobComsV2Policy, zobComsRegistryEnabled } from "./policy.js";
 import type { ZobLivePeerCard, ZobLivePeerStatus, ZobLiveRegistrySnapshot } from "./types.js";
 
 const FORBIDDEN_PERSISTED_KEYS = new Set(["body", "task", "prompt", "output", "content", "message", "rationale", "text", "diff", "patch"]);
+const DEFAULT_OFFLINE_PEER_RETENTION_MS = 24 * 60 * 60 * 1000;
+const MIN_OFFLINE_PEER_RETENTION_MS = 5 * 60 * 1000;
 
 function registryRoot(): { path: string; kind: "user_runtime" | "env_override" } {
   const override = process.env.ZOB_COMS_REGISTRY_ROOT;
@@ -54,6 +56,19 @@ function readPeerCardsFromAgentsDir(dir: string, nowMs: number, teamName?: strin
     .map((peer) => ({ ...peer, status: derivePeerStatus(peer, nowMs) }));
 }
 
+function boundedOfflinePeerRetentionMs(value: number | undefined): number {
+  const env = Number.parseInt(process.env.ZOB_COMS_OFFLINE_PEER_RETENTION_MS ?? "", 10);
+  const raw = typeof value === "number" && Number.isFinite(value) ? value : Number.isFinite(env) ? env : DEFAULT_OFFLINE_PEER_RETENTION_MS;
+  return Math.max(MIN_OFFLINE_PEER_RETENTION_MS, Math.floor(raw));
+}
+
+function offlinePeerExpired(peer: ZobLivePeerCard, nowMs: number, retentionMs: number): boolean {
+  if (derivePeerStatus(peer, nowMs) !== "offline") return false;
+  const heartbeatMs = Date.parse(peer.heartbeatAt);
+  if (!Number.isFinite(heartbeatMs)) return true;
+  return nowMs - heartbeatMs >= Math.max(peer.offlineAfterMs, retentionMs);
+}
+
 function allProjectAgentsDirs(): string[] {
   const root = registryRoot();
   const projectsDir = join(root.path, "projects");
@@ -94,6 +109,34 @@ function derivePeerStatus(peer: ZobLivePeerCard, nowMs: number): ZobLivePeerStat
   return "online";
 }
 
+export function pruneExpiredZobLivePeers(repoRoot: string, input: { teamName?: string; nowMs?: number; retentionMs?: number } = {}): { schema: "zob.live-registry-prune.v1"; pruned: number; retained: number; retentionMs: number; bodyStored: false } {
+  const { dir } = projectAgentsDir(repoRoot);
+  const nowMs = input.nowMs ?? Date.now();
+  const retentionMs = boundedOfflinePeerRetentionMs(input.retentionMs);
+  let pruned = 0;
+  let retained = 0;
+  if (!existsSync(dir)) return { schema: "zob.live-registry-prune.v1", pruned, retained, retentionMs, bodyStored: false };
+  for (const entry of readdirSync(dir).filter((name) => name.endsWith(".json"))) {
+    const filePath = join(dir, entry);
+    try {
+      const peer = parsePeerCard(JSON.parse(readFileSync(filePath, "utf8")) as unknown);
+      if (!peer || (input.teamName && peer.team !== input.teamName)) {
+        retained += 1;
+        continue;
+      }
+      if (offlinePeerExpired(peer, nowMs, retentionMs)) {
+        unlinkSync(filePath);
+        pruned += 1;
+      } else {
+        retained += 1;
+      }
+    } catch {
+      retained += 1;
+    }
+  }
+  return { schema: "zob.live-registry-prune.v1", pruned, retained, retentionMs, bodyStored: false };
+}
+
 export function writeZobLivePeerCard(repoRoot: string, peer: ZobLivePeerCard): ZobLivePeerCard {
   if (hasForbiddenPersistedKey(peer)) throw new Error("Refusing to persist ZOB live peer card with forbidden body-like keys");
   if (peer.bodyStored !== false) throw new Error("ZOB live peer card bodyStored must be false");

package/.pi/extensions/zob-harness/src/{coms-v2 → domains/coms/coms-v2}/response-capture.ts

@@ -1,4 +1,4 @@
-import { sha256 } from "../utils/hashing.js";
+import { sha256 } from "../../../core/utils/hashing.js";
 import { buildZobLiveEnvelope, type ZobLiveEnvelope } from "./envelope.js";
 
 export interface ZobLiveResponseCapture {

package/.pi/extensions/zob-harness/src/{coms-v2 → domains/coms/coms-v2}/transcript-capture.ts

@@ -2,8 +2,8 @@ import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
 import type { ZobComsTranscriptCapturePolicy } from "./types.js";
-import { sha256 } from "../utils/hashing.js";
-import { safeFileStem } from "../utils/paths.js";
+import { sha256 } from "../../../core/utils/hashing.js";
+import { safeFileStem } from "../../../core/utils/paths.js";
 
 export type ZobComsRedactedCaptureKind = "live_prompt" | "live_response" | "live_exchange";
 

package/.pi/extensions/zob-harness/src/{coms-v2 → domains/coms/coms-v2}/zpeer-profile.ts

@@ -4,9 +4,9 @@ import { join } from "node:path";
 
 import { buildZobComsProjectId } from "./identity.js";
 import type { ZobLivePeerCard, ZpeerRoomMembership } from "./types.js";
-import { sha256 } from "../utils/hashing.js";
-import { isRecord } from "../utils/records.js";
-import { safeFileStem } from "../utils/paths.js";
+import { sha256 } from "../../../core/utils/hashing.js";
+import { isRecord } from "../../../core/utils/records.js";
+import { safeFileStem } from "../../../core/utils/paths.js";
 
 const PROFILE_SCHEMA = "zob.zpeer-local-profile.v1";
 const NEW_CARRYOVER_SCHEMA = "zob.zpeer-new-carryover.v1";

package/.pi/extensions/zob-harness/src/{coms-v2 → domains/coms/coms-v2}/zpeer.ts

@@ -6,10 +6,10 @@ import { buildZobLiveEnvelope } from "./envelope.js";
 import { sendZobLocalEnvelope } from "./local-transport.js";
 import { readZobLiveRegistryAllProjectsSnapshot, writeZobLivePeerCard, writeZobLivePeerCardToProjectId } from "./registry.js";
 import type { ZobLivePeerCard, ZobLivePeerStatus, ZpeerRoomMembership, ZpeerRoomMembershipRole } from "./types.js";
-import { validateZobComsEdge } from "../topology/coms.js";
-import { loadTeamDefinition, validateTeamDefinition } from "../topology/teams.js";
+import { validateZobComsEdge } from "../../topology/coms.js";
+import { loadTeamDefinition, validateTeamDefinition } from "../../topology/teams.js";
 import { loadZteamManifest, zteamAllowsZpeerContact } from "../zagents.js";
-import { sha256 } from "../utils/hashing.js";
+import { sha256 } from "../../../core/utils/hashing.js";
 
 const DEFAULT_ROOM_ID = "default";
 const ALIAS_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]{1,31}$/;
@@ -26,6 +26,9 @@ export interface ZpeerRoomSummary {
   stale: number;
   offline: number;
   aliases: string[];
+  onlineAliases: string[];
+  staleAliases: string[];
+  offlineAliases: string[];
   duplicateAliases: string[];
   membershipCount?: number;
   localOnly: true;
@@ -248,9 +251,15 @@ function peersInRoom(repoRoot: string, roomId: string): ZpeerRoomPeer[] {
 
 function buildZpeerRoomSummaryFromPeers(projectId: string, self: ZobLivePeerCard | undefined, roomId: string, peers: ZpeerRoomPeer[]): ZpeerRoomSummary {
   const counts: Record<ZobLivePeerStatus, number> = { online: 0, stale: 0, offline: 0 };
+  const statusAliases: Record<ZobLivePeerStatus, string[]> = { online: [], stale: [], offline: [] };
   const aliases = peers.map((entry) => entry.membership.alias).sort();
-  for (const entry of peers) counts[zpeerReachableStatus(entry.peer)] += 1;
-  const duplicateAliases = aliases.filter((alias, index) => aliases.indexOf(alias) !== index).filter((alias, index, all) => all.indexOf(alias) === index);
+  for (const entry of peers) {
+    const status = zpeerReachableStatus(entry.peer);
+    counts[status] += 1;
+    statusAliases[status].push(entry.membership.alias);
+  }
+  const onlineAliases = statusAliases.online.sort();
+  const duplicateAliases = onlineAliases.filter((alias, index) => onlineAliases.indexOf(alias) !== index).filter((alias, index, all) => all.indexOf(alias) === index);
   return {
     schema: "zob.zpeer-room-summary.v1",
     projectId,
@@ -261,6 +270,9 @@ function buildZpeerRoomSummaryFromPeers(projectId: string, self: ZobLivePeerCard
     stale: counts.stale,
     offline: counts.offline,
     aliases,
+    onlineAliases,
+    staleAliases: statusAliases.stale.sort(),
+    offlineAliases: statusAliases.offline.sort(),
     duplicateAliases,
     membershipCount: self ? zpeerMembershipsForPeer(self).length : undefined,
     localOnly: true,
@@ -471,8 +483,24 @@ export async function sendZpeerPrompt(repoRoot: string, self: ZobLivePeerCard, t
   const candidates = peersInRoom(repoRoot, roomId).filter((entry) => entry.membership.alias === targetAlias && entry.peer.sessionHash !== self.sessionHash);
   if (targetAlias === senderAlias) return finish("attempt", { status: "blocked", reason: "cannot send to self", targetAlias, taskHash, bodyStored: false });
   if (candidates.length === 0) return finish("attempt", { status: "blocked", reason: `peer @${targetAlias} not found in room '${roomId}'`, targetAlias, taskHash, bodyStored: false }, 0);
-  if (candidates.length > 1) return finish("attempt", { status: "blocked", reason: `duplicate alias @${targetAlias} in room '${roomId}'`, targetAlias, taskHash, bodyStored: false }, candidates.length);
-  const target = candidates[0];
+  let liveCandidates = candidates.filter((entry) => zpeerReachableStatus(entry.peer) === "online");
+  if (liveCandidates.length > 1) {
+    const responsiveCandidates: ZpeerRoomPeer[] = [];
+    for (const entry of liveCandidates) {
+      if (await peerRespondsToAliasPing(entry.peer)) {
+        responsiveCandidates.push(entry);
+      } else {
+        try { writeZobLivePeerCard(repoRoot, { ...entry.peer, heartbeatAt: new Date().toISOString(), status: "offline" }); } catch { /* best-effort ghost alias release */ }
+      }
+    }
+    liveCandidates = responsiveCandidates;
+  }
+  if (liveCandidates.length === 0) {
+    const statuses = [...new Set(candidates.map((entry) => zpeerReachableStatus(entry.peer)))].sort().join("/") || "offline";
+    return finish("attempt", { status: "blocked", reason: `peer @${targetAlias} is ${statuses}`, targetAlias, taskHash, bodyStored: false }, candidates.length);
+  }
+  if (liveCandidates.length > 1) return finish("attempt", { status: "blocked", reason: `duplicate live alias @${targetAlias} in room '${roomId}'`, targetAlias, taskHash, bodyStored: false }, liveCandidates.length);
+  const target = liveCandidates[0];
   const targetReachableStatus = zpeerReachableStatus(target.peer);
   if (targetReachableStatus !== "online") return finish("attempt", { status: "blocked", reason: `peer @${targetAlias} is ${targetReachableStatus}`, targetAlias, taskHash, bodyStored: false }, 1);
   const topologyBlocker = validateZpeerTopology(repoRoot, self, target.peer, roomId, senderAlias, target.membership.alias);

package/.pi/extensions/zob-harness/src/{mission-control.ts → domains/coms/mission-control.ts}

@@ -5,14 +5,14 @@ import { buildZobLivePresenceSummary, redactZobLivePeerForMissionControl } from
 import { readZobComsV2Policy } from "./coms-v2/policy.js";
 import { zpeerMembershipsForPeer } from "./coms-v2/zpeer.js";
 import { readZobLiveRegistrySnapshot } from "./coms-v2/registry.js";
-import { buildQueueDashboardSummary } from "./queue.js";
-import type { TeamDefinition } from "./types.js";
-import { summarizePromotionCandidates } from "./promotion/candidate.js";
-import { buildZobComsMessage, listZobComsMessages, validateZobComsEdge, validateZobComsMessage } from "./topology/coms.js";
-import { sha256 } from "./utils/hashing.js";
-import { readJsonl, readJsonObjectIfPresent } from "./utils/json.js";
-import { safeFileStem } from "./utils/paths.js";
-import { isRecord } from "./utils/records.js";
+import { buildQueueDashboardSummary } from "../telemetry/queue.js";
+import type { TeamDefinition } from "../../types.js";
+import { summarizePromotionCandidates } from "../promotion/candidate.js";
+import { buildZobComsMessage, listZobComsMessages, validateZobComsEdge, validateZobComsMessage } from "../topology/coms.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { readJsonl, readJsonObjectIfPresent } from "../../core/utils/json.js";
+import { safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 
 export const MISSION_CONTROL_COMMANDS = ["pause", "resume", "reprioritize", "request_context", "request_oracle", "stop", "approve", "replan"] as const;
 
@@ -63,6 +63,7 @@ function summarizeZpeerRooms(peers: Array<Record<string, unknown>>): Array<Recor
   }
   return [...rooms.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([roomId, roomPeers]) => {
     const aliases = roomPeers.map((entry) => entry.alias).filter((alias): alias is string => Boolean(alias)).sort();
+    const onlineAliases = roomPeers.filter((entry) => entry.peer.status === "online").map((entry) => entry.alias).filter((alias): alias is string => Boolean(alias)).sort();
     const sessionHashes = roomPeers.map((entry) => typeof entry.peer.sessionHash === "string" ? entry.peer.sessionHash : undefined).filter((sessionHash): sessionHash is string => Boolean(sessionHash));
     return {
       schema: "zob.zpeer-room-summary.v1",
@@ -73,7 +74,9 @@ function summarizeZpeerRooms(peers: Array<Record<string, unknown>>): Array<Recor
       stale: roomPeers.filter((entry) => entry.peer.status === "stale").length,
       offline: roomPeers.filter((entry) => entry.peer.status === "offline").length,
       aliasHashes: aliases.map((alias) => sha256(alias)),
-      duplicateAliasHashes: aliases.filter((alias, index) => aliases.indexOf(alias) !== index).filter((alias, index, all) => all.indexOf(alias) === index).map((alias) => sha256(alias)),
+      onlineAliasHashes: onlineAliases.map((alias) => sha256(alias)),
+      duplicateAliasHashes: onlineAliases.filter((alias, index) => onlineAliases.indexOf(alias) !== index).filter((alias, index, all) => all.indexOf(alias) === index).map((alias) => sha256(alias)),
+      duplicateAliasScope: "online_only",
       localOnly: true,
       networkEnabled: false,
       bodyStored: false,