zob-harness 0.1.0 → 0.1.1

package/.pi/capabilities/zob-public-runtime-capabilities.json

@@ -1409,7 +1409,7 @@
         "AGENTS.md",
         "docs/ZOB_ADAPTIVE_WORKFLOW_RUNTIME_PLAN.md"
       ],
-      "noShipNotes": "Switches active harness mode only. orchestrator routes to adaptive-chief-vision plan_only defaults; child dispatch requires parent-owned contract/preflight gates and writes remain blocked without sandbox/oracle/human approval."
+      "noShipNotes": "Switches active harness mode only. orchestrator routes to adaptive-chief-vision plan_only defaults; vanilla restores Pi base-style unrestricted tool access outside ZOB governance and disables ZOB-specific bash mutation blocks. Child dispatch in governed modes requires parent-owned contract/preflight gates and writes remain blocked without sandbox/oracle/human approval."
     },
     {
       "name": "stop",

package/.pi/extensions/zob-harness/src/constants.ts

@@ -64,6 +64,8 @@ export const MODE_TOOLS: Record<ModeName, string[]> = {
   oracle: ["read", "grep", "find", "ls", "bash", "delegate_agent", "delegate_task", "zob_coms_list", "zob_coms_get", "zob_coms_await", "zpeer_ask", "zob_goal_room_list", "zob_workspace_claims_list", "zob_worker_pool_status", "zob_merge_queue_list", ...ZOB_RUNTIME_GOAL_TOOLS, ...ZOB_DELEGATION_READ_TOOLS, ...ZOB_ZCOMMIT_TOOLS, ...ZOB_AUTONOMOUS_READ_TOOLS, ...ZOB_MISSION_CONTROL_READ_TOOLS, ...ZOB_CONTEXT_READ_TOOLS, ...ZOB_COMPUTE_READ_TOOLS, ...ZOB_PROJECT_DNA_READ_TOOLS],
   orchestrator: ["read", "grep", "find", "ls", "delegate_agent", "delegate_task", "orchestrate_run", "chain_run", ...ZOB_RUNTIME_GOAL_TOOLS, ...ZOB_DELEGATION_READ_TOOLS, ...ZOB_ZCOMMIT_TOOLS, ...ZOB_COMS_TOOLS, ...ZOB_GOAL_ROOM_TOOLS, ...ZOB_GOVERNED_REQUEST_TOOLS, ...ZOB_WORKSPACE_CLAIM_TOOLS, ...ZOB_WORKER_POOL_TOOLS, ...ZOB_MERGE_QUEUE_TOOLS, ...ZOB_MISSION_CONTROL_READ_TOOLS, ...ZOB_MISSION_CONTROL_PROPOSAL_TOOLS, ...ZOB_CONTEXT_READ_TOOLS, ...ZOB_CONTEXT_PROPOSAL_TOOLS, ...ZOB_COMPUTE_READ_TOOLS, ...ZOB_COMPUTE_REPORT_TOOLS],
   factory: ["read", "bash", "edit", "write", "grep", "find", "ls", "delegate_agent", "delegate_task", "orchestrate_run", "factory_run", "factory_quarantine_review", "factory_quarantine_activate", "factory_quarantine_verify_activation", "chain_run", ...ZOB_RUNTIME_GOAL_TOOLS, ...ZOB_DELEGATION_READ_TOOLS, ...ZOB_ZCOMMIT_TOOLS, ...ZOB_AUTONOMOUS_READ_TOOLS, ...ZOB_AUTONOMOUS_FACTORY_TOOLS, ...ZOB_COMS_TOOLS, ...ZOB_GOAL_ROOM_TOOLS, ...ZOB_GOVERNED_REQUEST_TOOLS, ...ZOB_WORKSPACE_CLAIM_TOOLS, ...ZOB_WORKER_POOL_TOOLS, ...ZOB_MERGE_QUEUE_TOOLS, ...ZOB_MISSION_CONTROL_READ_TOOLS, ...ZOB_MISSION_CONTROL_PROPOSAL_TOOLS, ...ZOB_CONTEXT_READ_TOOLS, ...ZOB_CONTEXT_PROPOSAL_TOOLS, ...ZOB_COMPUTE_READ_TOOLS, ...ZOB_COMPUTE_REPORT_TOOLS, ...ZOB_PROJECT_DNA_READ_TOOLS, ...ZOB_PROJECT_DNA_PROPOSAL_TOOLS],
+  // Vanilla is handled specially by applyMode: all currently available Pi tools are enabled.
+  vanilla: [],
 };
 
 export const MODE_PROMPTS: Record<ModeName, string> = {
@@ -105,4 +107,10 @@ export const MODE_PROMPTS: Record<ModeName, string> = {
 - Turn repeated work into reusable prompts, agents, scripts, schemas, or Pi extensions.
 - Prefer deterministic scaffolding for immutable content; let LLMs enrich structured sections only.
 - Require sentinel/completion artifacts and validation before scale-up.`,
+  vanilla: `ZOB MODE: VANILLA (Pi base-style unrestricted agent)
+- Behave like the base Pi coding agent rather than a governed ZOB workflow agent.
+- ZOB-specific Explore/Plan/Implement/Oracle routing, tool-routing, TODO/goal governance, and bash mutation blocks are disabled for this mode.
+- You may use any available Pi tool and launch arbitrary shell commands, including external coding tools such as codex or project scripts that modify files.
+- Do not claim ZOB safety/oracle/governance guarantees while in vanilla; the user is intentionally choosing direct operator-style execution.
+- Keep normal conversational clarity: state what you are about to run when useful, then execute directly and report results.`,
 };

package/.pi/extensions/zob-harness/src/model-routing.ts

@@ -64,7 +64,7 @@ function chooseModelClass(input: ModelRoutingDryRunInput): { modelClass: ModelCl
   const risk = normalizeRisk(input.risk);
   const contextTokens = numberOrZero(input.contextTokens);
   const isOracleLike = includesAny(input.taskType, ["oracle", "review", "validate"]) || includesAny(input.outputContract, ["oracle"]);
-  const isImplementationLike = includesAny(input.taskType, ["implement", "factory", "synthesis", "worker"]) || input.mode === "implement" || input.mode === "factory";
+  const isImplementationLike = includesAny(input.taskType, ["implement", "factory", "synthesis", "worker"]) || input.mode === "implement" || input.mode === "factory" || input.mode === "vanilla";
 
   if (contextTokens >= 120_000) {
     reasonCodes.push("context_tokens_high");
@@ -239,7 +239,7 @@ export function validateModelRoutingConfig(repoRoot: string): Record<string, unk
   }
 
   const expectedClasses: ModelClass[] = ["cheap_scout", "balanced_worker", "strong_reasoning", "strong_oracle", "high_context"];
-  const modes: ModeName[] = ["explore", "plan", "implement", "oracle", "factory", "orchestrator"];
+  const modes: ModeName[] = ["explore", "plan", "implement", "oracle", "factory", "orchestrator", "vanilla"];
   const modelClasses = isRecord(parsed?.modelClasses) ? parsed.modelClasses : undefined;
   const defaults = isRecord(parsed?.defaults) ? parsed.defaults : undefined;
   const byMode = isRecord(defaults?.byMode) ? defaults.byMode : undefined;

package/.pi/extensions/zob-harness/src/rules.ts

@@ -8,7 +8,7 @@ import { isRecord } from "./utils/records.js";
 const RULE_PACK_SCHEMA = "zob.rule-pack.v1";
 const RULE_RESOLUTION_SCHEMA = "zob.rule-resolution.v1";
 const RULE_PACK_ORDER = ["always", "project", "runtime", "factory", "orchestration", "prompts", "docs", "sandbox", "oracle"];
-const MODE_NAMES = new Set<ModeName>(["explore", "plan", "implement", "oracle", "factory", "orchestrator"]);
+const MODE_NAMES = new Set<ModeName>(["explore", "plan", "implement", "oracle", "factory", "orchestrator", "vanilla"]);
 const ENFORCEMENT_LEVELS = new Set<RuleEnforcementLevel>(["advisory", "warn", "preflight_fail", "block", "no_ship", "human_approval"]);
 
 const PROFILE_PATHS: Array<{ profile: string; patterns: string[] }> = [

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

@@ -547,7 +547,7 @@ function delegationArgumentCompletions(state: HarnessRuntimeState, prefix: strin
 
 export function registerHarnessCommands(pi: ExtensionAPI, state: HarnessRuntimeState): void {
   pi.registerCommand("zmode", {
-    description: "Switch ZOB harness mode: explore | plan | implement | oracle | factory | orchestrator. Orchestrator routes to adaptive-chief-vision plan_only defaults.",
+    description: "Switch ZOB harness mode: explore | plan | implement | oracle | factory | orchestrator | vanilla. Orchestrator routes to adaptive-chief-vision plan_only defaults; vanilla restores Pi base-style unrestricted tool access outside ZOB governance.",
     handler: async (args, ctx) => {
       const requestedText = args.trim();
       const adaptiveEntrypoint = resolveAdaptiveZmodeEntrypoint(requestedText);

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

@@ -106,13 +106,14 @@ function buildZpeerAwarenessPrompt(state: HarnessRuntimeState, repoRoot: string)
 const SAME_AGENT_MODE_INTENT_PROMPT = [
   "ZOB SAME-AGENT AUTO-MODE INTENT",
   "- If the current ZOB mode does not match the next required action, emit at most one standalone intent line:",
-  "  <zob_mode_intent mode=\"explore|plan|implement|oracle|factory|orchestrator\" confidence=\"low|medium|high\" risk=\"low|medium|high\" reason=\"short reason\"/>",
+  "  <zob_mode_intent mode=\"explore|plan|implement|oracle|factory|orchestrator|vanilla\" confidence=\"low|medium|high\" risk=\"low|medium|high\" reason=\"short reason\"/>",
   "- This is only a suggestion; the harness validates and applies mode changes.",
   "- Do not claim the mode switched unless the harness reports it.",
   "- SINGLE-PLAN RULE: if you produce a complete plan in this response, do not also emit a plan-mode intent.",
   "- Emit mode=plan only when deferring the actual detailed plan to a follow-up turn; in that case keep this response to a short handoff.",
   "- Never both: full plan content and mode=plan intent in the same response.",
   "- Prefer orchestrator for multi-agent decomposition, Chief Vision coordination, Lead/Worker orchestration, TODO/workgraph routing, and parent-owned dispatch.",
+  "- Prefer vanilla when the user explicitly asks for Pi base behavior, Vanilla/Vania, Codex, unrestricted/external commands, or arbitrary shell tools outside ZOB governance.",
   "- Prefer implement for code/file edits, oracle for validation/review/no-ship, factory for reusable repeatable workflows/factories.",
   "- Do not emit an intent for ordinary discussion or when the current mode already fits.",
 ].join("\n");
@@ -145,6 +146,7 @@ function handleSameAgentModeIntent(pi: ExtensionAPI, state: HarnessRuntimeState,
   state.lastModeIntent = { ...intent, at: Date.now(), accepted: validation.accepted, validationReason: validation.reason };
   if (validation.accepted) {
     applyMode(pi, state, ctx, intent.mode);
+    state.activeRuleResolution = resolveRuleProfile({ repoRoot: ctx.cwd, mode: state.activeMode });
     ctx.ui.notify(`ZOB same-agent auto-mode: ${previousMode} → ${intent.mode} (${intent.confidence}; ${intent.reason})`, "info");
   } else {
     renderHarnessWidget(pi, state, ctx);
@@ -458,16 +460,21 @@ export function registerHarnessEvents(pi: ExtensionAPI, state: HarnessRuntimeSta
         else if (readiness.decision === "block") ctx.ui.notify(formatMissionReadinessForUi(readiness), "warning");
       }
     }
-    if (event.source === "extension" || state.activeMode !== "explore") return { action: "continue" as const };
+    if (event.source === "extension") return { action: "continue" as const };
     const nextMode = inferModeFromUserIntent(event.text);
-    if (!nextMode) return { action: "continue" as const };
+    if (!nextMode || nextMode === state.activeMode) return { action: "continue" as const };
+    if (state.activeMode !== "explore" && nextMode !== "vanilla") return { action: "continue" as const };
+    const previousMode = state.activeMode;
     applyMode(pi, state, ctx, nextMode);
-    const reason = nextMode === "orchestrator" ? "orchestration intent detected" : nextMode === "factory" ? "factory workflow intent detected" : "write/update intent detected";
-    ctx.ui.notify(`ZOB auto-mode: explore → ${nextMode} (${reason})`, "info");
+    state.activeRuleResolution = resolveRuleProfile({ repoRoot: ctx.cwd, mode: state.activeMode });
+    const reason = nextMode === "orchestrator" ? "orchestration intent detected" : nextMode === "factory" ? "factory workflow intent detected" : nextMode === "vanilla" ? "vanilla/Pi base or external-command intent detected" : "write/update intent detected";
+    ctx.ui.notify(`ZOB auto-mode: ${previousMode} → ${nextMode} (${reason})`, "info");
     return { action: "continue" as const };
   });
 
   pi.on("tool_call", async (event, ctx) => {
+    if (state.activeMode === "vanilla") return { action: "continue" as const };
+
     let violation: string | undefined;
     let attempted = JSON.stringify(event.input);
 
@@ -680,6 +687,9 @@ export function registerHarnessEvents(pi: ExtensionAPI, state: HarnessRuntimeSta
       : "\n\nZOB RULE PROFILE\n- Not resolved yet. Use /rules_status for diagnostics when scope is unclear.";
     const autonomyHint = `\n\n${formatInteractiveAutonomyPromptHint(state.autonomy)}`;
     const zpeerHint = buildZpeerAwarenessPrompt(state, state.zobLive.inbound?.repoRoot ?? process.cwd());
+    if (state.activeMode === "vanilla") {
+      return { systemPrompt: `${event.systemPrompt}\n\n${MODE_PROMPTS.vanilla}` };
+    }
     const contractHint = `\n\nZOB HARNESS OPERATING CONTRACT\n- Prefer Explore -> Plan -> Implement -> Oracle for non-trivial work.\n- Use the six-part contract for delegated work: TASK / EXPECTED OUTCOME / REQUIRED TOOLS / MUST DO / MUST NOT DO / CONTEXT.\n- Do not claim completion without concrete evidence.\n- If output may truncate, prioritize verdict, blockers, and next steps over exhaustive listings.\n\n${SAME_AGENT_MODE_INTENT_PROMPT}\n\n${ZOB_TOOL_ROUTING_CONTRACT}\n\n${ZOB_COMPACTION_CONTINUITY_CONTRACT}\n\n${MODE_PROMPTS[state.activeMode]}${goalHint}${runtimeGoalHint}${rulesHint}${autonomyHint}${zpeerHint}`;
     return { systemPrompt: `${event.systemPrompt}${contractHint}` };
   });

package/.pi/extensions/zob-harness/src/runtime/mode-intent.ts

@@ -15,7 +15,7 @@ export interface ZobModeIntentValidation {
   reason: string;
 }
 
-const VALID_MODES: readonly ModeName[] = ["explore", "plan", "implement", "oracle", "factory", "orchestrator"];
+const VALID_MODES: readonly ModeName[] = ["explore", "plan", "implement", "oracle", "factory", "orchestrator", "vanilla"];
 
 function modeName(value: string | undefined): ModeName | undefined {
   return VALID_MODES.includes(value as ModeName) ? value as ModeName : undefined;
@@ -118,6 +118,7 @@ function hasModeEvidence(mode: ModeName, text: string): boolean {
   if (mode === "orchestrator") return /\b(orchestrator|orchestrat(?:e|ion|or)|orchestrer|multi[- ]?agent|lead(?:s)?|worker(?:s)?|chief vision|coordonn(?:e|er|ation)|d[eé]l[eè]gu(?:e|er|ation)|delegat(?:e|ion)|sub[- ]?agents?|subtasks?|work graph|todo graph|graphe de travail|graphe todo)\b/i.test(text);
   if (mode === "factory") return /\b(factory|factory_run|pilot|batch|sentinel|manifest|quarantine|software factory)\b/i.test(text);
   if (mode === "implement") return /\b(update|modify|modifier|change|changer|fix|patch|implement|impl[eé]mente|edit|write|[eé]cris|ajoute|add|create|cr[eé]e|refactor|refactorise|remplace|am[eé]lior(?:e|er)|appliqu(?:e|er)|mets?|mettre|rends?|rendre|fais\s+en\s+sorte)\b/i.test(text);
+  if (mode === "vanilla") return /\b(vanilla|vania|pi\s+base|agent\s+pi\s+de\s+base|base\s+pi|codex|external\s+(?:command|tool|agent)|commande\s+externe|outil\s+externe|unrestricted|arbitrary\s+command|n['’]?importe\s+quelle\s+commande|sans\s+r[eé]glementation|sans\s+garde[- ]?fous|no\s+guardrails?)\b/i.test(text);
   if (mode === "oracle") return /\b(review|validate|validation|oracle|no[_-]?ship|v[eé]rifie|audit|qa|risks?|blocker)\b/i.test(text);
   if (mode === "plan") return /\b(plan|design|architecture|propose|roadmap|spec|sp[eé]cifie|comment|how would|strat[eé]gie)\b/i.test(text);
   return /\b(read|explore|inspect|analy[sz]e|cherche|comprends?|trouve|diagnostic)\b/i.test(text);
@@ -137,6 +138,9 @@ export function validateModeIntent(intent: ZobModeIntent | undefined, currentMod
   if ((intent.mode === "implement" || intent.mode === "factory" || intent.mode === "orchestrator") && intent.confidence !== "high" && !evidence) {
     return { accepted: false, reason: `mode ${intent.mode} requires high confidence or explicit evidence` };
   }
+  if (intent.mode === "vanilla" && !evidence) {
+    return { accepted: false, reason: "vanilla mode requires explicit user-text evidence for Pi base/unrestricted external-command behavior" };
+  }
   if (intent.mode === "oracle" && intent.confidence === "medium" && !evidence) {
     return { accepted: false, reason: "oracle mode requires review/validation evidence" };
   }

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

@@ -389,6 +389,8 @@ export function restoreHarnessState(state: HarnessRuntimeState, ctx: ExtensionCo
 export function inferModeFromUserIntent(text: string): ModeName | undefined {
   const normalized = text.trim().toLowerCase();
   if (!normalized || normalized.startsWith("/")) return undefined;
+  const asksForVanilla = /\b(vanilla|vania|pi\s+base|agent\s+pi\s+de\s+base|base\s+pi|codex|external\s+(?:command|tool|agent)|commande\s+externe|outil\s+externe|unrestricted|arbitrary\s+command|n['’]?importe\s+quelle\s+commande|sans\s+r[eé]glementation|sans\s+garde[- ]?fous|no\s+guardrails?)\b/i.test(normalized);
+  if (asksForVanilla) return "vanilla";
   const asksForOrchestration = /\b(orchestrator|orchestrat(?:e|ion|or)|orchestrer|multi[- ]?agent|lead(?:s)?|worker(?:s)?|chief vision|coordonn(?:e|er|ation)|d[eé]l[eè]gu(?:e|er|ation)|delegat(?:e|ion)|sub[- ]?agents?|subtasks?|work graph|todo graph|graphe de travail|graphe todo)\b/i.test(normalized);
   if (asksForOrchestration) return "orchestrator";
   const asksForMutation = /\b(update|udpate|modify|modifier|modifie|change|changer|corrige|correction|fix|patch|implement|impl[eé]mente|edit|write|[eé]cris|ajoute|add|create|cr[eé]e|supprime|delete|remove|refactor|refactorise|remplace|am[eé]lior(?:e|er)|appliqu(?:e|er)|mets?|mettre|rends?|rendre|fais\s+en\s+sorte|mets? .*jour|mise .*jour|faire .*update|continue .*update)\b/i.test(normalized);

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

@@ -345,7 +345,8 @@ export function renderHarnessWidget(pi: ExtensionAPI, state: HarnessRuntimeState
 export function applyMode(pi: ExtensionAPI, state: HarnessRuntimeState, ctx: ExtensionContext, mode: ModeName, persist = true): void {
   state.activeMode = mode;
   const available = new Set(pi.getAllTools().map((tool) => tool.name));
-  pi.setActiveTools(MODE_TOOLS[mode].filter((tool) => available.has(tool)));
+  const activeTools = mode === "vanilla" ? [...available] : MODE_TOOLS[mode].filter((tool) => available.has(tool));
+  pi.setActiveTools(activeTools);
   if (persist) pi.appendEntry("zob-mode-state", { mode, timestamp: new Date().toISOString() });
   ctx.ui.setStatus("zob-mode", ctx.ui.theme.fg("accent", `zob:${mode}`));
   renderHarnessWidget(pi, state, ctx);

package/.pi/extensions/zob-harness/src/types/core.ts

@@ -1,4 +1,4 @@
-export type ModeName = "explore" | "plan" | "implement" | "oracle" | "factory" | "orchestrator";
+export type ModeName = "explore" | "plan" | "implement" | "oracle" | "factory" | "orchestrator" | "vanilla";
 export type AgentScope = "project" | "user" | "both";
 export type ChildThinkingLevel = "low" | "medium" | "high" | "xhigh";
 

package/.pi/model-routing.json

@@ -71,7 +71,8 @@
       "implement": "balanced_worker",
       "oracle": "strong_oracle",
       "factory": "balanced_worker",
-      "orchestrator": "strong_reasoning"
+      "orchestrator": "strong_reasoning",
+      "vanilla": "balanced_worker"
     },
     "highContextThresholdTokens": 120000,
     "highContextModelClass": "high_context"

package/.pi/prompts/vanilla.md

@@ -0,0 +1,14 @@
+---
+description: Switch to Pi base-style unrestricted Vanilla mode
+argument-hint: "<task>"
+---
+Switch to `/zmode vanilla` if not already there.
+
+Run this task in Vanilla mode: $ARGUMENTS
+
+Vanilla behavior:
+- Behave like the base Pi coding agent rather than a governed ZOB workflow agent.
+- ZOB-specific Explore/Plan/Implement/Oracle routing, tool-routing, TODO/goal governance, and bash mutation blocks are disabled for this mode.
+- You may use any available Pi tool and launch arbitrary shell commands, including external coding tools such as codex or project scripts that modify files.
+- Do not claim ZOB safety/oracle/governance guarantees while in Vanilla; the user is intentionally choosing direct operator-style execution.
+- Keep normal conversational clarity: state what you are about to run when useful, then execute directly and report results.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zob-harness",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "A governed, human-controlled Pi harness for contract-driven agentic engineering, safety gates, specialist delegation, and software-factory workflows.",
   "license": "MIT",