zob-harness 0.2.0 → 0.3.0

package/.pi/extensions/zob-harness/src/{orchestration → domains/orchestration}/plan.ts

@@ -1,9 +1,9 @@
-import { SUPERVISED_READONLY_CHILD_TOOLS, SUPERVISED_SMOKE_CHILD_TOOLS } from "../constants.js";
-import type { OrchestrateExecutionMode, OrchestrateRunInput, TeamDefinition } from "../types.js";
+import { SUPERVISED_READONLY_CHILD_TOOLS, SUPERVISED_SMOKE_CHILD_TOOLS } from "../../core/constants.js";
+import type { OrchestrateExecutionMode, OrchestrateRunInput, TeamDefinition } from "../../types.js";
 import { normalizeAdaptiveDelegationPolicy } from "./adaptive-delegation.js";
-import { sha256 } from "../utils/hashing.js";
-import { safeFileStem } from "../utils/paths.js";
-import { isRecord } from "../utils/records.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 
 function renderOrchestrationTemplate(template: string, values: Record<string, string>): string {
   return template.replace(/\{([a-zA-Z0-9_.-]+)\}/g, (match, key: string) => values[key] ?? match);

package/.pi/extensions/zob-harness/src/{orchestration → domains/orchestration}/room.ts

@@ -1,10 +1,10 @@
 import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
-import { SUPERVISED_READONLY_CHILD_TOOLS, SUPERVISED_SMOKE_CHILD_TOOLS } from "../constants.js";
-import type { OrchestrateExecutionMode, TeamDefinition } from "../types.js";
-import { sha256 } from "../utils/hashing.js";
-import { isRecord } from "../utils/records.js";
+import { SUPERVISED_READONLY_CHILD_TOOLS, SUPERVISED_SMOKE_CHILD_TOOLS } from "../../core/constants.js";
+import type { OrchestrateExecutionMode, TeamDefinition } from "../../types.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { isRecord } from "../../core/utils/records.js";
 
 function orchestrationLedger(runDir: string, entry: Record<string, unknown>): void {
   appendFileSync(join(runDir, "ledger.jsonl"), `${JSON.stringify({ ...entry, timestamp: new Date().toISOString() })}\n`, "utf8");

package/.pi/extensions/zob-harness/src/{orchestration → domains/orchestration}/run.ts

@@ -1,15 +1,15 @@
 import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
-import { resolveComputeProfile } from "../compute-profile.js";
-import { SUPERVISED_SMOKE_CHILD_TOOLS } from "../constants.js";
-import type { OrchestrateExecutionMode, OrchestrateRunInput, OrchestrateRunResult, TeamDefinition } from "../types.js";
+import { resolveComputeProfile } from "../compute/compute-profile.js";
+import { SUPERVISED_SMOKE_CHILD_TOOLS } from "../../core/constants.js";
+import type { OrchestrateExecutionMode, OrchestrateRunInput, OrchestrateRunResult, TeamDefinition } from "../../types.js";
 import { mirrorOrchestrationToComs } from "../topology/coms.js";
 import { loadOrchestrationProfile, teamDefinitionFromOrchestrationProfile, validateOrchestrateRunInputs } from "../topology/orchestration-profiles.js";
 import { loadTeamDefinition } from "../topology/teams.js";
-import { sha256 } from "../utils/hashing.js";
-import { safeRunId } from "../utils/paths.js";
-import { isRecord } from "../utils/records.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { safeRunId } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 import { buildInitialAdaptiveDelegationGovernorState, normalizeAdaptiveDelegationPolicy } from "./adaptive-delegation.js";
 import { writeAdaptiveWorkflowArtifacts } from "./adaptive-workflow.js";
 import { buildOrchestrationPlan, redactBodyLikeFieldsForPersistence, redactOrchestrationPlanForPersistence } from "./plan.js";

package/.pi/extensions/zob-harness/src/{orchestration → domains/orchestration}/supervised-readonly.ts

@@ -1,13 +1,13 @@
 import { existsSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
-import { SUPERVISED_READONLY_CHILD_TOOLS } from "../constants.js";
+import { SUPERVISED_READONLY_CHILD_TOOLS } from "../../core/constants.js";
 import { ackZobComsMessage, appendZobComsMessage, getZobComsMessage, listZobComsMessages, replyZobComsMessage, transitionZobComsStatus } from "../topology/coms.js";
-import type { AdaptiveDelegationGovernorState, AdaptiveDelegationPolicy, DelegationRequestProposal, GovernorDecision, OrchestrateRunInput, ParentDispatchContract, SupervisedReadonlyDispatcher, SupervisedReadonlyDispatchResult, TeamDefinition } from "../types.js";
-import { sha256 } from "../utils/hashing.js";
-import { parseJsonFile, readJsonl, readJsonObjectIfPresent } from "../utils/json.js";
-import { safeRunId } from "../utils/paths.js";
-import { isRecord } from "../utils/records.js";
+import type { AdaptiveDelegationGovernorState, AdaptiveDelegationPolicy, DelegationRequestProposal, GovernorDecision, OrchestrateRunInput, ParentDispatchContract, SupervisedReadonlyDispatcher, SupervisedReadonlyDispatchResult, TeamDefinition } from "../../types.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { parseJsonFile, readJsonl, readJsonObjectIfPresent } from "../../core/utils/json.js";
+import { safeRunId } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 import {
   ADAPTIVE_DELEGATION_HARD_MAX_DEPTH,
   buildInitialAdaptiveDelegationGovernorState,

package/.pi/extensions/zob-harness/src/{orchestration → domains/orchestration}/widget-readers.ts

@@ -1,8 +1,8 @@
 import { existsSync, lstatSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 
-import { parseJsonFile, readJsonObjectIfPresent } from "../utils/json.js";
-import { isRecord } from "../utils/records.js";
+import { parseJsonFile, readJsonObjectIfPresent } from "../../core/utils/json.js";
+import { isRecord } from "../../core/utils/records.js";
 
 function widgetCounts(value: unknown): string {
   if (!isRecord(value)) return "none";

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

@@ -0,0 +1,19 @@
+# ProjectDNA domain guardrail
+
+## Scope
+
+- ProjectDNA query, federated query, workflow planning helpers, schemas, and writeback proposals.
+
+## MUST DO
+
+- Preserve read-only scan artifact usage, bounded cited context, proposal-only writeback, and quarantine/output path policy.
+
+## MUST NOT
+
+- Do not scan external projects, import/sync/embed/write to backends, or promote ProjectDNA learnings by moving code.
+- Do not import from `index.ts` or `index.js`.
+
+## Validation
+
+- `npm run check -- --pretty false`.
+- Run relevant `validate:project-dna*`/smoke scripts when ProjectDNA behavior moves.

package/.pi/extensions/zob-harness/src/{project-dna.ts → domains/project-dna/project-dna.ts}

@@ -1,9 +1,9 @@
 import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 
-import { sha256 } from "./utils/hashing.js";
-import { isRecord } from "./utils/records.js";
-import { safeRunId } from "./utils/paths.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { isRecord } from "../../core/utils/records.js";
+import { safeRunId } from "../../core/utils/paths.js";
 
 const STOPWORDS = new Set(["the", "and", "for", "with", "how", "does", "this", "that", "dans", "avec", "pour", "comment", "faire", "using", "use", "project", "style"]);
 const DEFAULT_SCAN_DIR = "reports/project-dna-scans/project-dna-factory-smoke";
@@ -463,7 +463,7 @@ export function buildProjectDnaReadinessAudit(repoRoot: string, input: { scanDir
   } catch (error) {
     scanErrors = [error instanceof Error ? error.message : String(error)];
   }
-  const p4RuntimeReady = existsSync(resolve(repoRoot, ".pi/extensions/zob-harness/src/project-dna.ts")) && existsSync(resolve(repoRoot, ".pi/extensions/zob-harness/src/runtime/tools-project-dna.ts"));
+  const p4RuntimeReady = existsSync(resolve(repoRoot, ".pi/extensions/zob-harness/src/domains/project-dna/project-dna.ts")) && existsSync(resolve(repoRoot, ".pi/extensions/zob-harness/src/runtime/tools-project-dna.ts"));
   const p5FederationReady = p4RuntimeReady;
   const errors = [...missingRepoFiles.map((file) => `missing repo file: ${file}`), ...scanErrors];
   return {

package/.pi/extensions/zob-harness/src/{promotion → domains/promotion}/candidate.ts

@@ -1,11 +1,11 @@
 import { appendFileSync, existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 
-import { DEFAULT_RULES } from "../constants.js";
-import { sha256 } from "../utils/hashing.js";
-import { readJsonObjectIfPresent } from "../utils/json.js";
-import { pathMatches, resolveRepoPath, safeFileStem } from "../utils/paths.js";
-import { isRecord } from "../utils/records.js";
+import { DEFAULT_RULES } from "../../core/constants.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { readJsonObjectIfPresent } from "../../core/utils/json.js";
+import { pathMatches, resolveRepoPath, safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 import type { PromotionApplyScope, PromotionCandidateInput, PromotionCandidateRecord, PromotionGates, PromotionKind, PromotionStatus, PromotionTransitionInput } from "./types.js";
 import { PROMOTION_APPLY_SCOPES, PROMOTION_KINDS, PROMOTION_STATUSES } from "./types.js";
 

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

@@ -1,9 +1,9 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
-import { sha256 } from "../utils/hashing.js";
-import { safeFileStem } from "../utils/paths.js";
-import { isRecord } from "../utils/records.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 import { promotionCandidateDir, promotionCandidateRef } from "./candidate.js";
 import type { PromotionCandidateRecord, PromotionComsMessageRef, PromotionComsThreadInput, PromotionComsThreadRecord } from "./types.js";
 

package/.pi/extensions/zob-harness/src/{promotion → domains/promotion}/documentation.ts

@@ -1,10 +1,10 @@
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 
-import { sha256 } from "../utils/hashing.js";
-import { resolveRepoPath, safeFileStem } from "../utils/paths.js";
-import { parseJsonFile } from "../utils/json.js";
-import { isRecord } from "../utils/records.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { resolveRepoPath, safeFileStem } from "../../core/utils/paths.js";
+import { parseJsonFile } from "../../core/utils/json.js";
+import { isRecord } from "../../core/utils/records.js";
 import { advancePromotionCandidate, createPromotionCandidate, promotionCandidateDir, promotionCandidateRef, validatePromotionCandidate, writePromotionCandidate } from "./candidate.js";
 import type { PromotionCandidateRecord } from "./types.js";
 

package/.pi/extensions/zob-harness/src/{promotion → domains/promotion}/factory.ts

@@ -1,8 +1,8 @@
 import { existsSync, mkdirSync, writeFileSync } 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";
 import { advancePromotionCandidate, createPromotionCandidate, promotionCandidateDir, promotionCandidateRef, validatePromotionCandidate, writePromotionCandidate } from "./candidate.js";
 import type { PromotionCandidateRecord } from "./types.js";
 

package/.pi/extensions/zob-harness/src/{promotion → domains/promotion}/temp-agent.ts

@@ -1,10 +1,10 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
-import { sha256 } from "../utils/hashing.js";
-import { safeFileStem } from "../utils/paths.js";
-import { parseJsonFile } from "../utils/json.js";
-import { isRecord } from "../utils/records.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { safeFileStem } from "../../core/utils/paths.js";
+import { parseJsonFile } from "../../core/utils/json.js";
+import { isRecord } from "../../core/utils/records.js";
 import { advancePromotionCandidate, createPromotionCandidate, promotionCandidateDir, promotionCandidateRef, validatePromotionCandidate, writePromotionCandidate } from "./candidate.js";
 import type { PromotionCandidateRecord } from "./types.js";
 

package/.pi/extensions/zob-harness/src/{promotion → domains/promotion}/write-lane.ts

@@ -1,9 +1,9 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 
-import { sha256 } from "../utils/hashing.js";
-import { safeFileStem } from "../utils/paths.js";
-import { isRecord } from "../utils/records.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 import { advancePromotionCandidate, createPromotionCandidate, promotionCandidateDir, promotionCandidateRef, validatePromotionCandidate, writePromotionCandidate } from "./candidate.js";
 import type { PromotionCandidateRecord } from "./types.js";
 

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

@@ -0,0 +1,19 @@
+# Telemetry domain guardrail
+
+## Scope
+
+- Chronicle classification, queue metadata, telemetry summaries, and body-free runtime evidence records.
+
+## MUST DO
+
+- Preserve completion classifiers, budget preflight dry-run semantics, body-free telemetry, and artifact/ref names.
+
+## MUST NOT
+
+- Do not persist raw prompts, outputs, diffs, patches, or secrets.
+- Do not import from `index.ts` or `index.js`.
+
+## Validation
+
+- `npm run check -- --pretty false`.
+- `npm run smoke:harness` after chronicle/queue/runtime-facing moves.

package/.pi/extensions/zob-harness/src/{chronicle.ts → domains/telemetry/chronicle.ts}

@@ -9,9 +9,9 @@ import type {
   DelegationTelemetryInput,
   FactoryTelemetryInput,
   RunawayGuardInput,
-} from "./types.js";
-import { sha256 } from "./utils/hashing.js";
-import { safeFileStem } from "./utils/paths.js";
+} from "../../types.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { safeFileStem } from "../../core/utils/paths.js";
 
 export const CHRONICLE_STATES = [
   "created",

package/.pi/extensions/zob-harness/src/{queue.ts → domains/telemetry/queue.ts}

@@ -1,15 +1,15 @@
 import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
 import { basename, join, resolve } from "node:path";
 
-import { evaluateStrictBudgetDispatchGate } from "./budget-policy.js";
+import { evaluateStrictBudgetDispatchGate } from "../governance/budget-policy.js";
 import { classifyChildStopCondition, evaluateBudgetPreflightDryRun } from "./chronicle.js";
-import { DEFAULT_RULES } from "./constants.js";
+import { DEFAULT_RULES } from "../../core/constants.js";
 import { incrementCounter, normalizeDailyTelemetryDate, stringFrom } from "./telemetry.js";
-import type { ChildStopCondition, FactoryRunBudgetInput, QueueState, QueueTickResult, ReadOnlyQueueJob, ReadOnlyQueueJobType } from "./types.js";
-import { sha256 } from "./utils/hashing.js";
-import { parseJsonFile } from "./utils/json.js";
-import { expandHome, isSafeArtifactName, pathMatches, safeFileStem } from "./utils/paths.js";
-import { isRecord } from "./utils/records.js";
+import type { ChildStopCondition, FactoryRunBudgetInput, QueueState, QueueTickResult, ReadOnlyQueueJob, ReadOnlyQueueJobType } from "../../types.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { parseJsonFile } from "../../core/utils/json.js";
+import { expandHome, isSafeArtifactName, pathMatches, safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 
 export const READ_ONLY_QUEUE_JOB_TYPES: ReadOnlyQueueJobType[] = ["docs_watch", "repo_audit_readonly", "todo_risk_report", "session_analysis"];
 const QUEUE_STATES: QueueState[] = ["pending", "running", "done", "failed"];

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

@@ -2,10 +2,10 @@ import { existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
 import { classifyDelegationChronicleCompletion, classifyFactoryChronicleCompletion, writeChronicleSnapshot } from "./chronicle.js";
-import type { AssistantLikeMessage, ChildResult, ChildStopCondition, DelegationTelemetryInput, FactoryTelemetryInput } from "./types.js";
-import { parseJsonFile } from "./utils/json.js";
-import { safeFileStem } from "./utils/paths.js";
-import { isRecord } from "./utils/records.js";
+import type { AssistantLikeMessage, ChildResult, ChildStopCondition, DelegationTelemetryInput, FactoryTelemetryInput } from "../../types.js";
+import { parseJsonFile } from "../../core/utils/json.js";
+import { safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
 
 function usageEmpty(): ChildResult["usage"] {
   return { turns: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, contextTokens: 0 };

package/.pi/extensions/zob-harness/src/{topology → domains/topology}/chains.ts

@@ -1,16 +1,16 @@
 import { appendFileSync, existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
-import { loadProjectAgents } from "../agents.js";
-import { BLOCKED_CHAIN_TOOLS, READ_ONLY_CHAIN_TOOLS } from "../constants.js";
-import { validateOutputContractId } from "../output-contracts.js";
-import { validateToolList } from "../safety.js";
-import type { ChainDefinition, ChainRunInput, ChainRunResult, ChainStepDefinition } from "../types.js";
-import { sha256 } from "../utils/hashing.js";
-import { parseJsonFile } from "../utils/json.js";
-import { isSafeArtifactName, safeFileStem, safeRunId } from "../utils/paths.js";
-import { isRecord } from "../utils/records.js";
-import { listZobResourceJsonStems, readableZobResourcePath } from "../utils/resources.js";
+import { loadProjectAgents } from "../delegation/agents.js";
+import { BLOCKED_CHAIN_TOOLS, READ_ONLY_CHAIN_TOOLS } from "../../core/constants.js";
+import { validateOutputContractId } from "../delegation/output-contracts.js";
+import { validateToolList } from "../governance/safety.js";
+import type { ChainDefinition, ChainRunInput, ChainRunResult, ChainStepDefinition } from "../../types.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { parseJsonFile } from "../../core/utils/json.js";
+import { isSafeArtifactName, safeFileStem, safeRunId } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
+import { listZobResourceJsonStems, readableZobResourcePath } from "../../core/utils/resources.js";
 import { isStringArray } from "./teams.js";
 
 function chainsDir(repoRoot: string): string {

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

@@ -1,9 +1,9 @@
 import { appendFileSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
 
-import type { TeamDefinition, ZobComsMessageInput } from "../types.js";
-import { sha256 } from "../utils/hashing.js";
-import { readJsonl } from "../utils/json.js";
+import type { TeamDefinition, ZobComsMessageInput } from "../../types.js";
+import { sha256 } from "../../core/utils/hashing.js";
+import { readJsonl } from "../../core/utils/json.js";
 
 function comsDir(repoRoot: string): string {
   return join(repoRoot, ".pi", "coms");

package/.pi/extensions/zob-harness/src/{topology → domains/topology}/orchestration-profiles.ts

@@ -1,15 +1,15 @@
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 
-import { loadProjectAgents } from "../agents.js";
+import { loadProjectAgents } from "../delegation/agents.js";
 import { normalizeAdaptiveDelegationPolicy, validateAdaptiveDelegationPolicy } from "../orchestration/adaptive-delegation.js";
-import { validateOutputContractId } from "../output-contracts.js";
-import { validateAllowedPathPolicy, validateDelegateTaskWriteScope, validateForbiddenPathPolicy, validateToolList } from "../safety.js";
-import type { OrchestrateRunInput, OrchestrationProfileDefinition, OrchestrationProfilePhase, OrchestrationProfileRole, TeamDefinition } from "../types.js";
-import { parseJsonFile } from "../utils/json.js";
-import { isSafeArtifactName, safeFileStem } from "../utils/paths.js";
-import { isRecord } from "../utils/records.js";
-import { listZobResourceJsonStems, readableZobResourcePath } from "../utils/resources.js";
+import { validateOutputContractId } from "../delegation/output-contracts.js";
+import { validateAllowedPathPolicy, validateDelegateTaskWriteScope, validateForbiddenPathPolicy, validateToolList } from "../governance/safety.js";
+import type { OrchestrateRunInput, OrchestrationProfileDefinition, OrchestrationProfilePhase, OrchestrationProfileRole, TeamDefinition } from "../../types.js";
+import { parseJsonFile } from "../../core/utils/json.js";
+import { isSafeArtifactName, safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
+import { listZobResourceJsonStems, readableZobResourcePath } from "../../core/utils/resources.js";
 import { isStringArray, loadTeamDefinition, validateTeamDefinition } from "./teams.js";
 
 function orchestrationProfilesDir(repoRoot: string): string {

package/.pi/extensions/zob-harness/src/{topology → domains/topology}/teams.ts

@@ -1,14 +1,14 @@
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 
-import { loadProjectAgents } from "../agents.js";
-import { validateOutputContractId } from "../output-contracts.js";
-import { validateToolList } from "../safety.js";
-import type { HarnessAgent, TeamDefinition, TeamLead, TeamRoleBase, TeamWorker } from "../types.js";
-import { parseJsonFile } from "../utils/json.js";
-import { isSafeArtifactName, safeFileStem } from "../utils/paths.js";
-import { isRecord } from "../utils/records.js";
-import { readableZobResourcePath } from "../utils/resources.js";
+import { loadProjectAgents } from "../delegation/agents.js";
+import { validateOutputContractId } from "../delegation/output-contracts.js";
+import { validateToolList } from "../governance/safety.js";
+import type { HarnessAgent, TeamDefinition, TeamLead, TeamRoleBase, TeamWorker } from "../../types.js";
+import { parseJsonFile } from "../../core/utils/json.js";
+import { isSafeArtifactName, safeFileStem } from "../../core/utils/paths.js";
+import { isRecord } from "../../core/utils/records.js";
+import { readableZobResourcePath } from "../../core/utils/resources.js";
 
 function isStringArray(value: unknown): value is string[] {
   return Array.isArray(value) && value.every((item) => typeof item === "string");

package/.pi/extensions/zob-harness/src/runtime/adaptive-zmode.ts

@@ -1,6 +1,6 @@
 import type { ModeName } from "../types.js";
-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 type AdaptiveZmodeAlias = "orchestrator";
 

package/.pi/extensions/zob-harness/src/runtime/auto-compaction.ts

@@ -2,8 +2,8 @@ import { randomUUID } from "node:crypto";
 import type { CompactionResult, ExtensionAPI, ExtensionContext, SessionEntry } from "@earendil-works/pi-coding-agent";
 import { compact, estimateTokens, findCutPoint } from "@earendil-works/pi-coding-agent";
 
-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";
 import { buildZobCompactionInstructions, withZobCompactionDetails, ZOB_COMPACTION_TARGET_TOKENS, type ZobCompactionDetails } from "./compaction-policy.js";
 import type { HarnessRuntimeState } from "./state.js";
 

package/.pi/extensions/zob-harness/src/runtime/commands.ts

@@ -1,26 +1,26 @@
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 import type { AutocompleteItem } from "@earendil-works/pi-tui";
 
-import { MODE_PROMPTS } from "../constants.js";
+import { MODE_PROMPTS } from "../core/constants.js";
 import type { ModeName, QueueTickResult } from "../types.js";
-import { discoverAgents, formatAgentList } from "../agents.js";
-import { buildComputePreview, resolveComputeProfile, type ComputeRequestedProfile } from "../compute-profile.js";
-import { buildComputeWorkflowShape } from "../compute-workflow-shape.js";
-import { buildDaemonRuntimeState, buildDaemonTickPlan, type DaemonRuntimeState, type DaemonTickPlan } from "../daemon-runtime.js";
-import { runQueueDaemonTick } from "../queue.js";
-import { buildProjectDnaAgenticPlan, buildProjectDnaQueryResult, buildProjectDnaReadinessAudit } from "../project-dna.js";
-import { formatZagentList, formatZteamList, listZagentManifests, listZteamManifests, loadZagentManifest, loadZteamManifest, normalizeZagentRoomBindings, readZagentPrompt, type ZAgentManifest, type ZAgentRoomBinding, type ZTeamAgentManifest, type ZTeamManifest, type ZTeamMemberManifest } from "../zagents.js";
+import { discoverAgents, formatAgentList } from "../domains/delegation/agents.js";
+import { buildComputePreview, resolveComputeProfile, type ComputeRequestedProfile } from "../domains/compute/compute-profile.js";
+import { buildComputeWorkflowShape } from "../domains/compute/compute-workflow-shape.js";
+import { buildDaemonRuntimeState, buildDaemonTickPlan, type DaemonRuntimeState, type DaemonTickPlan } from "../domains/autonomy/daemon-runtime.js";
+import { runQueueDaemonTick } from "../domains/telemetry/queue.js";
+import { buildProjectDnaAgenticPlan, buildProjectDnaQueryResult, buildProjectDnaReadinessAudit } from "../domains/project-dna/project-dna.js";
+import { formatZagentList, formatZteamList, listZagentManifests, listZteamManifests, loadZagentManifest, loadZteamManifest, normalizeZagentRoomBindings, readZagentPrompt, resolveZagentRuntimeRoomBindings, type ZAgentManifest, type ZAgentRoomBinding, type ZTeamAgentManifest, type ZTeamManifest, type ZTeamMemberManifest } from "../domains/coms/zagents.js";
 import { resolveAdaptiveZmodeEntrypoint, renderAdaptiveZmodeTemplate } from "./adaptive-zmode.js";
 import { handleZcompactCommand } from "./auto-compaction.js";
-import { sha256 } from "../utils/hashing.js";
-import { buildZcommitPlan, formatZcommitPlan, formatZcommitStatus, readZcommitPolicy, runGovernedZcommitAdopt, runGovernedZcommitCommit, runGovernedZcommitPush, type ZcommitAdoptResult, type ZcommitCommandResult, type ZcommitOwnedPathRef, type ZcommitToggleState } from "../git-ops.js";
-import { clearZpeerNewCarryoverProfile, writeZpeerLocalProfileFromPeer } from "../coms-v2/zpeer-profile.js";
-import { buildZpeerRoomSummary, changeZpeerAlias, changeZpeerRoom, clearZpeerRoom, joinZpeerRoom, leaveZpeerRoom, peerAliasInRoom, refreshZpeerSelf, sendZpeerPrompt, useZpeerRoom, zpeerMembershipsForPeer, type ZpeerSendMode } from "../coms-v2/zpeer.js";
+import { sha256 } from "../core/utils/hashing.js";
+import { buildZcommitPlan, formatZcommitPlan, formatZcommitStatus, readZcommitPolicy, runGovernedZcommitAdopt, runGovernedZcommitCommit, runGovernedZcommitPush, type ZcommitAdoptResult, type ZcommitCommandResult, type ZcommitOwnedPathRef, type ZcommitToggleState } from "../domains/git/git-ops.js";
+import { clearZpeerNewCarryoverProfile, writeZpeerLocalProfileFromPeer } from "../domains/coms/coms-v2/zpeer-profile.js";
+import { buildZpeerRoomSummary, changeZpeerAlias, changeZpeerRoom, clearZpeerRoom, joinZpeerRoom, leaveZpeerRoom, peerAliasInRoom, refreshZpeerSelf, sendZpeerPrompt, useZpeerRoom, zpeerMembershipsForPeer, type ZpeerSendMode } from "../domains/coms/coms-v2/zpeer.js";
 import { markZpeerNewHardResetPending } from "./events.js";
-import { parseBillableJobIntake, validateBillableJobIntake } from "../goal.js";
-import { handleGoalCommand, handleGoalGateCommand, pauseRuntimeGoalForStop } from "../goal-runtime.js";
-import { formatRuleResolution, resolveRuleProfile } from "../rules.js";
-import { formatContractTemplate } from "../safety.js";
+import { parseBillableJobIntake, validateBillableJobIntake } from "../domains/goal/goal.js";
+import { handleGoalCommand, handleGoalGateCommand, pauseRuntimeGoalForStop } from "./goal-runtime.js";
+import { formatRuleResolution, resolveRuleProfile } from "../domains/governance/rules.js";
+import { formatContractTemplate } from "../domains/governance/safety.js";
 import { showDelegationOverlay } from "./delegation-overlay.js";
 import { finishDelegationRun } from "./delegation-monitor.js";
 import { showGoalTodoOverlay } from "./goal-todo-overlay.js";
@@ -33,7 +33,7 @@ import {
   scoreMissionReadiness,
   toAutonomyStateLedgerEntry,
   toMissionReadinessLedgerEntry,
-} from "../interactive-autonomy.js";
+} from "../domains/autonomy/interactive-autonomy.js";
 import { applyMode, renderHarnessWidget } from "./widget.js";
 
 const COMPUTE_PROFILES = ["auto", "low", "medium", "high", "xhigh", "max"] as const;
@@ -598,6 +598,7 @@ function formatZagentShow(loaded: ReturnType<typeof loadZagentManifest>): string
     loaded.manifest.team ? `team: ${loaded.manifest.team}` : undefined,
     loaded.manifest.role ? `role: ${loaded.manifest.role}` : undefined,
     loaded.manifest.alias ? `alias: @${loaded.manifest.alias}` : undefined,
+    loaded.manifest.defaultMode ? `defaultMode: ${loaded.manifest.defaultMode}` : undefined,
     rooms.length ? `rooms: ${rooms.map((room) => `${room.id}${room.alias ? `@${room.alias}` : ""}${room.active ? "*" : ""}`).join(", ")}` : "rooms: none",
     loaded.manifest.promptRef ? `promptRef: ${loaded.manifest.promptRef}` : "promptRef: none",
     loaded.promptPath ? `promptPath: ${loaded.promptPath}` : undefined,
@@ -627,7 +628,7 @@ function normalizeZpeerRole(role: string | undefined): "member" | "bridge" | "ob
 
 async function applyZagentToZpeer(repoRoot: string, peer: NonNullable<HarnessRuntimeState["zobLive"]["peerCard"]>, manifest: ZAgentManifest): Promise<{ ok: true; peer: NonNullable<HarnessRuntimeState["zobLive"]["peerCard"]> } | { ok: false; reason: string; peer: NonNullable<HarnessRuntimeState["zobLive"]["peerCard"]> }> {
   let current = refreshZpeerSelf(repoRoot, peer);
-  const rooms = normalizeZagentRoomBindings(manifest.rooms, manifest.defaultRoom, manifest.activeRoom);
+  const rooms = resolveZagentRuntimeRoomBindings(repoRoot, manifest).rooms;
   if (rooms.length === 0 && manifest.alias) {
     const changed = await changeZpeerAlias(repoRoot, current, manifest.alias);
     if (!changed.ok) return { ok: false, reason: changed.reason, peer: current };
@@ -663,25 +664,44 @@ function zteamMembers(team: ZTeamManifest): Array<{ id: string; alias?: string;
   }));
 }
 
-function zteamLaunchPlanText(team: ZTeamManifest): { text: string; roomIds: string[]; agentIds: string[] } {
+function safeLaunchPlanModel(value: string | undefined): string | undefined {
+  const trimmed = value?.trim();
+  if (!trimmed || trimmed.length > 160) return undefined;
+  if (trimmed.includes("\0") || trimmed.includes("\n") || trimmed.includes("\r") || trimmed.includes("..")) return undefined;
+  if (trimmed.startsWith("/") || trimmed.startsWith("~")) return undefined;
+  return /^[a-zA-Z0-9._:/+@-]+$/.test(trimmed) ? trimmed : undefined;
+}
+
+function zteamLaunchPlanText(repoRoot: string, team: ZTeamManifest): { text: string; roomIds: string[]; agentIds: string[]; modelIds: string[]; defaultModes: string[] } {
   const teamRooms = normalizeZagentRoomBindings(team.rooms, team.defaultRoom, team.activeRoom).map((room) => room.id);
   const members = zteamMembers(team);
   const roomIds = [...new Set([...teamRooms, ...members.flatMap((member) => (member.rooms ?? []).map((room) => room.id))])];
   const agentIds = members.map((member) => member.id);
+  const loadedAgents = members.map((member) => ({ member, loaded: loadZagentManifest(repoRoot, member.id) }));
+  const modelIds = [...new Set(loadedAgents.map(({ loaded }) => safeLaunchPlanModel(loaded.manifest.model)).filter((model): model is string => Boolean(model)))];
+  const defaultModes = [...new Set(loadedAgents.map(({ loaded }) => loaded.manifest.defaultMode).filter((mode): mode is ModeName => Boolean(mode)))];
   const lines = [
     `# ZTeam launch-plan: ${team.id}`,
     "No processes spawned. Copy/paste each command in a separate terminal when approved.",
     "",
-    ...members.map((member) => {
+    ...loadedAgents.map(({ member, loaded }) => {
+      const rawModel = loaded.manifest.model;
+      const model = safeLaunchPlanModel(rawModel);
+      const defaultMode = loaded.manifest.defaultMode;
       const rooms = (member.rooms ?? []).map((room) => `${room.id}${room.active ? "*" : ""}`).join(", ") || teamRooms.join(", ") || "default";
       const alias = member.alias ? ` alias=@${member.alias}` : "";
-      return `ZOB_ZAGENT_ID=${member.id} pi    # expected_rooms=${rooms}${alias}`;
+      const modelArg = model ? ` --model ${model}` : "";
+      const modelNote = rawModel ? (model ? ` model=${model}` : " model=invalid_omitted") : "";
+      const modeNote = defaultMode ? ` defaultMode=${defaultMode}` : "";
+      return `ZOB_ZAGENT_ID=${member.id} pi${modelArg}    # expected_rooms=${rooms}${alias}${modelNote}${modeNote}`;
     }),
     "",
     `Expected rooms: ${roomIds.join(", ") || "default"}`,
+    modelIds.length ? `Models: ${modelIds.join(", ")}` : "Models: default Pi model unless each ZAgent manifest sets a safe model",
+    defaultModes.length ? `Default modes: ${defaultModes.join(", ")}` : "Default modes: restored/current ZOB mode unless each ZAgent manifest sets defaultMode",
     "After each session starts, run /zagent use <id> to bind its ZPeer alias/rooms.",
   ];
-  return { text: lines.join("\n"), roomIds, agentIds };
+  return { text: lines.join("\n"), roomIds, agentIds, modelIds, defaultModes };
 }
 
 function delegationArgumentCompletions(state: HarnessRuntimeState, prefix: string): AutocompleteItem[] | null {
@@ -874,11 +894,13 @@ export function registerHarnessCommands(pi: ExtensionAPI, state: HarnessRuntimeS
         }
         const loaded = loadZagentManifest(ctx.cwd, id);
         const prompt = readZagentPrompt(ctx.cwd, loaded.manifest.promptRef);
-        const rooms = normalizeZagentRoomBindings(loaded.manifest.rooms, loaded.manifest.defaultRoom, loaded.manifest.activeRoom);
+        const resolved = resolveZagentRuntimeRoomBindings(ctx.cwd, loaded.manifest);
+        const rooms = resolved.rooms;
         const errors = [...loaded.errors, ...prompt.errors];
         state.zagent = {
           id: loaded.manifest.id,
-          team: loaded.manifest.team,
+          team: loaded.manifest.team ?? resolved.teamIds[0],
+          teams: resolved.teamIds,
           role: loaded.manifest.role,
           alias: loaded.manifest.alias,
           description: loaded.manifest.description,
@@ -967,11 +989,11 @@ export function registerHarnessCommands(pi: ExtensionAPI, state: HarnessRuntimeS
           return;
         }
         const loaded = loadZteamManifest(ctx.cwd, id);
-        const plan = zteamLaunchPlanText(loaded.manifest);
+        const plan = zteamLaunchPlanText(ctx.cwd, loaded.manifest);
         pi.appendEntry("zob-zagent", zagentLedgerEntry("zteam_launch_plan", { teamId: loaded.manifest.id, status: loaded.errors.length === 0 ? "ok" : "blocked", roomIds: plan.roomIds, path: loaded.path, errors: loaded.errors }));
         renderHarnessWidget(pi, state, ctx);
-        void pi.sendMessage({ customType: "zob-zteam-launch-plan", content: loaded.errors.length ? `${plan.text}\n\nBlocked manifest errors:\n- ${loaded.errors.join("\n- ")}` : plan.text, display: true, details: { id: loaded.manifest.id, agentIdHashes: plan.agentIds.map((agentId) => sha256(agentId)), roomIdHashes: plan.roomIds.map((roomId) => sha256(roomId)), bodyStored: false } }, { triggerTurn: false });
-        ctx.ui.notify(`zteam ${loaded.manifest.id} launch-plan printed; spawn count=0; expectedRooms=${plan.roomIds.join(",") || "default"}`, loaded.errors.length === 0 ? "info" : "warning");
+        void pi.sendMessage({ customType: "zob-zteam-launch-plan", content: loaded.errors.length ? `${plan.text}\n\nBlocked manifest errors:\n- ${loaded.errors.join("\n- ")}` : plan.text, display: true, details: { id: loaded.manifest.id, agentIdHashes: plan.agentIds.map((agentId) => sha256(agentId)), roomIdHashes: plan.roomIds.map((roomId) => sha256(roomId)), modelIdHashes: plan.modelIds.map((modelId) => sha256(modelId)), defaultModeHashes: plan.defaultModes.map((mode) => sha256(mode)), bodyStored: false } }, { triggerTurn: false });
+        ctx.ui.notify(`zteam ${loaded.manifest.id} launch-plan printed; spawn count=0; expectedRooms=${plan.roomIds.join(",") || "default"}; models=${plan.modelIds.length || "default"}; defaultModes=${plan.defaultModes.length || "current"}`, loaded.errors.length === 0 ? "info" : "warning");
         return;
       }
       ctx.ui.notify("Usage: /zteam list | /zteam show <id> | /zteam launch-plan <id>", "warning");

package/.pi/extensions/zob-harness/src/runtime/compaction-policy.ts

@@ -1,7 +1,7 @@
 import type { CompactionResult } from "@earendil-works/pi-coding-agent";
 
-import { goalTodoCompletionDiagnostics, summarizeGoalTodos } from "../goal-todos.js";
-import { sha256 } from "../utils/hashing.js";
+import { goalTodoCompletionDiagnostics, summarizeGoalTodos } from "../domains/goal/goal-todos.js";
+import { sha256 } from "../core/utils/hashing.js";
 import type { HarnessRuntimeState } from "./state.js";
 
 export const ZOB_COMPACTION_ENTRY_TYPE = "zob-compaction";

package/.pi/extensions/zob-harness/src/runtime/delegation-feed.ts

@@ -5,7 +5,7 @@ import { Markdown, truncateToWidth, visibleWidth, type MarkdownTheme } from "@ea
 
 import { delegationDurationMs, delegationSignalBadge, delegationSignalColor, formatDelegationContextLabel, formatDelegationCostLabel, formatDelegationModelLabel, formatDelegationSignalBadge, formatDuration, statusIcon, type DelegationRunView } from "./delegation-monitor.js";
 import { sanitizeDelegationText } from "./delegation-markdown.js";
-import { isRecord } from "../utils/records.js";
+import { isRecord } from "../core/utils/records.js";
 
 const FEED_MAX_BYTES = 240_000;
 const FEED_MAX_LINES = 1_200;

package/.pi/extensions/zob-harness/src/runtime/delegation-monitor.ts

@@ -2,7 +2,7 @@ import { closeSync, existsSync, openSync, readFileSync, readSync, statSync } fro
 import { resolve, sep } from "node:path";
 
 import type { ChildResult, DelegationFailureKind } from "../types.js";
-import { isRecord } from "../utils/records.js";
+import { isRecord } from "../core/utils/records.js";
 
 export type DelegationRunSource = "delegate_agent" | "delegate_task";
 export type DelegationRunMode = "single" | "parallel" | "chain";