@selesai/code 0.5.12 → 0.5.14

package/dist/extensions/pi-extension/index.js

@@ -1,189 +0,0 @@
-import { createRequire } from "node:module";
-
-const require = createRequire(import.meta.url);
-const {
-  DEFAULT_MODE,
-  getDefaultMode,
-  normalizeMode,
-  normalizeConfigMode,
-  normalizePersistedMode,
-  isDeactivationCommand,
-  writeDefaultMode,
-} = require("../hooks/ponytail-config.js");
-const { getPonytailInstructions, filterSkillBodyForMode } = require("../hooks/ponytail-instructions.js");
-
-export { filterSkillBodyForMode };
-export const readDefaultMode = getDefaultMode;
-
-export function resolveSessionMode(entries, fallbackMode = DEFAULT_MODE) {
-  const fallback = normalizePersistedMode(fallbackMode) || DEFAULT_MODE;
-  if (!Array.isArray(entries)) return fallback;
-
-  for (let i = entries.length - 1; i >= 0; i -= 1) {
-    const entry = entries[i];
-    if (entry?.type !== "custom" || entry?.customType !== "ponytail-mode") continue;
-
-    const mode = normalizePersistedMode(entry?.data?.mode);
-    if (mode) return mode;
-  }
-
-  return fallback;
-}
-
-export function parsePonytailCommand(text, defaultMode = DEFAULT_MODE) {
-  const fallback = normalizePersistedMode(defaultMode) || DEFAULT_MODE;
-  const normalizedText = String(text || "").trim().toLowerCase();
-
-  if (!normalizedText) {
-    return { type: "set-mode", mode: fallback === "off" ? "full" : fallback };
-  }
-
-  const [primary, secondary] = normalizedText.split(/\s+/);
-
-  if (primary === "status") return { type: "status" };
-
-  if (primary === "default") {
-    const mode = normalizeConfigMode(secondary);
-    return mode ? { type: "set-default", mode } : { type: "invalid", reason: "invalid-default-mode" };
-  }
-
-  const mode = normalizeMode(primary);
-  return mode ? { type: "set-mode", mode } : { type: "invalid", reason: "invalid-mode", mode: primary };
-}
-
-export { writeDefaultMode };
-
-export default function ponytailExtension(pi) {
-  let currentMode = DEFAULT_MODE;
-  let configuredDefaultMode = getDefaultMode();
-  let isActive = false;
-  let lastCtx = null;
-
-  // -- Status bar --
-  function syncStatus(ctx) {
-    if (ctx) lastCtx = ctx;
-    const c = ctx || lastCtx;
-    if (!c?.ui?.setStatus || !c.ui.theme?.fg) return;
-    const theme = c.ui.theme;
-    if (currentMode === "off") {
-      c.ui.setStatus("ponytail", "");
-      return;
-    }
-    const levelIcons = { lite: "🌿", full: "⚡", ultra: "🔥" };
-    const icon = levelIcons[currentMode] || "";
-    const label = currentMode.toUpperCase();
-    const indicator = isActive ? theme.fg("accent", "●") : theme.fg("dim", "○");
-    c.ui.setStatus("ponytail", indicator + " 🐴 " + theme.fg("muted", "ponytail: ") + theme.fg("text", icon + " " + label));
-  }
-
-  const setMode = (mode, ctx) => {
-    const normalized = normalizePersistedMode(mode);
-    if (!normalized) return;
-
-    currentMode = normalized;
-    pi.appendEntry("ponytail-mode", { mode: normalized });
-    syncStatus(ctx);
-    ctx?.ui?.notify?.(`Ponytail mode set to ${normalized}.`, "info");
-  };
-
-  const sendAlias = (skillName, args, ctx) => {
-    const normalized = String(args || "").trim();
-    const message = normalized ? `${skillName} ${normalized}` : skillName;
-
-    if (ctx?.isIdle?.() === false) {
-      pi.sendUserMessage(message, { deliverAs: "followUp" });
-      ctx?.ui?.notify?.(`${skillName} queued as follow-up.`, "info");
-      return;
-    }
-
-    pi.sendUserMessage(message);
-  };
-
-  pi.registerCommand("ponytail", {
-    description: "Set or report Ponytail mode",
-    handler: async (args, ctx) => {
-      const parsed = parsePonytailCommand(args, configuredDefaultMode);
-
-      if (parsed.type === "status") {
-        ctx?.ui?.notify?.(`Ponytail: current ${currentMode} • default ${configuredDefaultMode}`, "info");
-        return;
-      }
-
-      if (parsed.type === "set-default") {
-        const written = writeDefaultMode(parsed.mode);
-        if (written) {
-          configuredDefaultMode = getDefaultMode();
-          const message = configuredDefaultMode === written
-            ? `Default Ponytail mode set to ${written}.`
-            : `Saved default ${written}, but env override keeps default at ${configuredDefaultMode}.`;
-          ctx?.ui?.notify?.(message, "info");
-        }
-        return;
-      }
-
-      if (parsed.type === "set-mode") {
-        setMode(parsed.mode, ctx);
-        return;
-      }
-
-      ctx?.ui?.notify?.("Unknown or unsupported /ponytail mode.", "warning");
-    },
-  });
-
-  pi.registerCommand("ponytail-review", {
-    description: "Run /skill:ponytail-review",
-    handler: (_args, ctx) => sendAlias("/skill:ponytail-review", "", ctx),
-  });
-
-  pi.registerCommand("ponytail-audit", {
-    description: "Run /skill:ponytail-audit",
-    handler: (_args, ctx) => sendAlias("/skill:ponytail-audit", "", ctx),
-  });
-
-  pi.registerCommand("ponytail-gain", {
-    description: "Run /skill:ponytail-gain",
-    handler: (_args, ctx) => sendAlias("/skill:ponytail-gain", "", ctx),
-  });
-
-  pi.registerCommand("ponytail-debt", {
-    description: "Run /skill:ponytail-debt",
-    handler: (_args, ctx) => sendAlias("/skill:ponytail-debt", "", ctx),
-  });
-
-  pi.registerCommand("ponytail-help", {
-    description: "Run /skill:ponytail-help",
-    handler: (_args, ctx) => sendAlias("/skill:ponytail-help", "", ctx),
-  });
-
-  pi.on("input", async (event) => {
-    if (event?.source === "extension") return;
-
-    const text = String(event?.text || "");
-    if (currentMode !== "off" && isDeactivationCommand(text)) {
-      setMode("off");
-    }
-  });
-
-  pi.on("session_start", async (_event, ctx) => {
-    const entries = ctx?.sessionManager?.getBranch?.() || ctx?.sessionManager?.getEntries?.() || [];
-    configuredDefaultMode = getDefaultMode();
-    currentMode = resolveSessionMode(entries, configuredDefaultMode);
-    syncStatus(ctx);
-    ctx?.ui?.notify?.(`Ponytail loaded: ${currentMode}`, "info");
-  });
-
-  pi.on("agent_start", async (_event, ctx) => {
-    isActive = true;
-    syncStatus(ctx);
-  });
-
-  pi.on("agent_end", async (_event, ctx) => {
-    isActive = false;
-    syncStatus(ctx);
-  });
-
-  pi.on("before_agent_start", async (event) => {
-    if (!currentMode || currentMode === "off") return;
-    return { systemPrompt: `${event.systemPrompt}\n\n${getPonytailInstructions(currentMode)}` };
-  });
-}

package/dist/extensions/pi-extension/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "ponytail-pi-extension-dev",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "test": "node --test ./test/*.test.js"
-  }
-}

package/dist/extensions/pi-extension/test/extension.test.js

@@ -1,167 +0,0 @@
-import assert from "node:assert/strict";
-import { mkdtempSync, rmSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import test from "node:test";
-
-import ponytailExtension from "../index.js";
-
-function createPiHarness() {
-  const events = new Map();
-  const commands = new Map();
-  const appendedEntries = [];
-  const sentUserMessages = [];
-
-  const pi = {
-    on(eventName, handler) {
-      events.set(eventName, handler);
-    },
-    registerCommand(name, options) {
-      commands.set(name, options);
-    },
-    appendEntry(customType, data) {
-      appendedEntries.push({ customType, data });
-    },
-    sendUserMessage(text, options) {
-      sentUserMessages.push({ text, options });
-    },
-  };
-
-  ponytailExtension(pi);
-  return { events, commands, appendedEntries, sentUserMessages };
-}
-
-function createCommandContext(overrides = {}) {
-  return {
-    isIdle: () => true,
-    sessionManager: { getEntries: () => [] },
-    ui: { notify() {} },
-    ...overrides,
-  };
-}
-
-function withTempConfig(fn) {
-  const tempConfigHome = mkdtempSync(join(tmpdir(), "ponytail-test-"));
-  const previousXdg = process.env.XDG_CONFIG_HOME;
-  process.env.XDG_CONFIG_HOME = tempConfigHome;
-
-  return Promise.resolve()
-    .then(fn)
-    .finally(() => {
-      if (previousXdg === undefined) delete process.env.XDG_CONFIG_HOME;
-      else process.env.XDG_CONFIG_HOME = previousXdg;
-      rmSync(tempConfigHome, { recursive: true, force: true });
-    });
-}
-
-test("extension registers Ponytail commands", () => {
-  const { commands } = createPiHarness();
-
-  assert.deepEqual([...commands.keys()].sort(), ["ponytail", "ponytail-audit", "ponytail-debt", "ponytail-gain", "ponytail-help", "ponytail-review"]);
-});
-
-test("/ponytail updates session mode and injects instructions", async () => withTempConfig(async () => {
-  const { commands, events, appendedEntries } = createPiHarness();
-  const ctx = createCommandContext();
-
-  await events.get("session_start")({ reason: "startup" }, ctx);
-  await commands.get("ponytail").handler("ultra", ctx);
-
-  assert.deepEqual(appendedEntries.at(-1), {
-    customType: "ponytail-mode",
-    data: { mode: "ultra" },
-  });
-
-  const result = await events.get("before_agent_start")({ systemPrompt: "BASE" }, ctx);
-  assert.ok(result.systemPrompt.includes("PONYTAIL MODE ACTIVE"));
-  assert.ok(result.systemPrompt.includes("ultra"));
-}));
-
-test("session_start restores latest persisted mode", async () => withTempConfig(async () => {
-  const { events } = createPiHarness();
-  const ctx = createCommandContext({
-    sessionManager: {
-      getEntries: () => [
-        { type: "custom", customType: "ponytail-mode", data: { mode: "lite" } },
-      ],
-    },
-  });
-
-  await events.get("session_start")({ reason: "resume" }, ctx);
-  const result = await events.get("before_agent_start")({ systemPrompt: "BASE" }, ctx);
-
-  assert.ok(result.systemPrompt.includes("lite"));
-}));
-
-test("skill alias commands delegate to Pi skill commands", async () => {
-  const { commands, sentUserMessages } = createPiHarness();
-  const ctx = createCommandContext();
-
-  await commands.get("ponytail-review").handler("", ctx);
-  await commands.get("ponytail-audit").handler("", ctx);
-  await commands.get("ponytail-debt").handler("", ctx);
-  await commands.get("ponytail-gain").handler("", ctx);
-  await commands.get("ponytail-help").handler("", ctx);
-
-  assert.deepEqual(sentUserMessages.map((entry) => entry.text), [
-    "/skill:ponytail-review",
-    "/skill:ponytail-audit",
-    "/skill:ponytail-debt",
-    "/skill:ponytail-gain",
-    "/skill:ponytail-help",
-  ]);
-});
-
-test("normal mode disables persistent instructions", async () => withTempConfig(async () => {
-  const { commands, events } = createPiHarness();
-  const ctx = createCommandContext();
-
-  await events.get("session_start")({ reason: "startup" }, ctx);
-  await commands.get("ponytail").handler("ultra", ctx);
-  await events.get("input")({ text: "normal mode", source: "interactive" }, ctx);
-
-  const disabled = await events.get("before_agent_start")({ systemPrompt: "BASE" }, ctx);
-  assert.equal(disabled, undefined);
-}));
-
-test("a request mentioning normal mode stays active", async () => withTempConfig(async () => {
-  const { commands, events } = createPiHarness();
-  const ctx = createCommandContext();
-
-  await events.get("session_start")({ reason: "startup" }, ctx);
-  await commands.get("ponytail").handler("ultra", ctx);
-  await events.get("input")({ text: "add a normal mode toggle next to dark mode", source: "interactive" }, ctx);
-
-  const result = await events.get("before_agent_start")({ systemPrompt: "BASE" }, ctx);
-  assert.match(result.systemPrompt, /PONYTAIL MODE ACTIVE/);
-}));
-
-test("status bar renders the mode and flips active on agent_start", async () => withTempConfig(async () => {
-  const { events } = createPiHarness();
-  const statusWrites = [];
-  const ctx = createCommandContext({
-    sessionManager: { getEntries: () => [{ type: "custom", customType: "ponytail-mode", data: { mode: "ultra" } }] },
-    ui: { notify() {}, setStatus: (key, text) => statusWrites.push({ key, text }), theme: { fg: (_color, text) => text } },
-  });
-
-  await events.get("session_start")({ reason: "resume" }, ctx);
-  await events.get("agent_start")({}, ctx);
-
-  assert.equal(statusWrites.at(-2).key, "ponytail");
-  assert.match(statusWrites.at(-2).text, /○.*ULTRA/);
-  assert.match(statusWrites.at(-1).text, /●.*ULTRA/);
-}));
-
-test("status bar stays silent when ui lacks a theme", async () => withTempConfig(async () => {
-  const { events } = createPiHarness();
-  const calls = [];
-  const ctx = createCommandContext({
-    sessionManager: { getEntries: () => [{ type: "custom", customType: "ponytail-mode", data: { mode: "ultra" } }] },
-    ui: { notify() {}, setStatus: (_key, text) => calls.push(text) }, // setStatus present, theme absent
-  });
-
-  await events.get("session_start")({ reason: "resume" }, ctx);
-  await events.get("agent_start")({}, ctx);
-
-  assert.deepEqual(calls, []);
-}));

package/dist/extensions/pi-extension/test/helpers.test.js

@@ -1,92 +0,0 @@
-import assert from "node:assert/strict";
-import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import test from "node:test";
-
-import {
-  filterSkillBodyForMode,
-  parsePonytailCommand,
-  readDefaultMode,
-  resolveSessionMode,
-  writeDefaultMode,
-} from "../index.js";
-
-test("parsePonytailCommand falls back to full when invoked bare and default is off", () => {
-  assert.deepEqual(parsePonytailCommand("", "off"), { type: "set-mode", mode: "full" });
-});
-
-test("parsePonytailCommand parses modes, status, and default subcommand", () => {
-  assert.deepEqual(parsePonytailCommand("ultra", "full"), { type: "set-mode", mode: "ultra" });
-  assert.deepEqual(parsePonytailCommand("status", "full"), { type: "status" });
-  assert.deepEqual(parsePonytailCommand("default lite", "full"), { type: "set-default", mode: "lite" });
-});
-
-test("resolveSessionMode prefers latest persisted session mode", () => {
-  const entries = [
-    { type: "custom", customType: "ponytail-mode", data: { mode: "lite" } },
-    { type: "custom", customType: "ponytail-mode", data: { mode: "ultra" } },
-  ];
-
-  assert.equal(resolveSessionMode(entries, "full"), "ultra");
-});
-
-test("resolveSessionMode returns fallback when entries is not an array", () => {
-  assert.equal(resolveSessionMode(null, "ultra"), "ultra");
-  assert.equal(resolveSessionMode(undefined, "lite"), "lite");
-  assert.equal(resolveSessionMode({}, "full"), "full");
-  assert.equal(resolveSessionMode("not an array"), "full"); // DEFAULT_MODE fallback
-});
-
-test("readDefaultMode and writeDefaultMode use XDG config path", () => {
-  const tempDir = mkdtempSync(join(tmpdir(), "ponytail-config-"));
-  const previousXdg = process.env.XDG_CONFIG_HOME;
-  const previousDefault = process.env.PONYTAIL_DEFAULT_MODE;
-  const configPath = join(tempDir, "ponytail", "config.json");
-  process.env.XDG_CONFIG_HOME = tempDir;
-  delete process.env.PONYTAIL_DEFAULT_MODE;
-
-  try {
-    assert.equal(readDefaultMode(), "full");
-    assert.equal(writeDefaultMode("ultra"), "ultra");
-    assert.equal(readDefaultMode(), "ultra");
-    assert.ok(existsSync(configPath));
-    assert.deepEqual(JSON.parse(readFileSync(configPath, "utf8")), { defaultMode: "ultra" });
-  } finally {
-    if (previousXdg === undefined) delete process.env.XDG_CONFIG_HOME;
-    else process.env.XDG_CONFIG_HOME = previousXdg;
-    if (previousDefault === undefined) delete process.env.PONYTAIL_DEFAULT_MODE;
-    else process.env.PONYTAIL_DEFAULT_MODE = previousDefault;
-    rmSync(tempDir, { recursive: true, force: true });
-  }
-});
-
-test("filterSkillBodyForMode keeps only requested intensity examples and rows", () => {
-  const body = `---\nname: ponytail\n---\n| **lite** | keep lite |\n| **full** | keep full |\n| **ultra** | keep ultra |\n- lite: Lite example\n- full: Full example\n- ultra: Ultra example\nOther line`;
-
-  const filtered = filterSkillBodyForMode(body, "ultra");
-
-  assert.ok(!filtered.includes("keep lite"));
-  assert.ok(!filtered.includes("keep full"));
-  assert.ok(filtered.includes("keep ultra"));
-  assert.ok(!filtered.includes("Lite example"));
-  assert.ok(filtered.includes("Ultra example"));
-  assert.ok(filtered.includes("Other line"));
-});
-
-test("filterSkillBodyForMode keeps rule bullets that contain a colon", () => {
-  // Regression: rule bullets outside the Intensity section (e.g. the
-  // "No unrequested abstractions:" rule or the `ponytail:` comment convention)
-  // contain a colon and must not be mistaken for mode-example lines.
-  const skillPath = new URL("../../skills/ponytail/SKILL.md", import.meta.url);
-  const body = readFileSync(skillPath, "utf8");
-
-  const filtered = filterSkillBodyForMode(body, "full");
-
-  assert.ok(filtered.includes("No unrequested abstractions"));
-  assert.ok(filtered.includes("Mark deliberate simplifications"));
-  // The Intensity examples are still filtered down to the active mode.
-  assert.ok(filtered.includes('full: "`@lru_cache'));
-  assert.ok(!filtered.includes('lite: "Done'));
-  assert.ok(!filtered.includes('ultra: "No cache'));
-});

package/dist/extensions/pi-powerline-footer/welcome-dismiss.ts

@@ -1,34 +0,0 @@
-export interface WelcomeDismissScheduler<Context> {
-  schedule(ctx: Context): void;
-  cancel(): void;
-}
-
-interface WelcomeDismissSchedulerOptions<Context> {
-  dismiss(ctx: Context): void;
-  getGeneration(): number;
-  isEnabled(): boolean;
-}
-
-export function createWelcomeDismissScheduler<Context>(
-  options: WelcomeDismissSchedulerOptions<Context>,
-): WelcomeDismissScheduler<Context> {
-  let timer: ReturnType<typeof setTimeout> | null = null;
-
-  return {
-    schedule(ctx) {
-      if (timer) return;
-
-      const generation = options.getGeneration();
-      timer = setTimeout(() => {
-        timer = null;
-        if (!options.isEnabled() || generation !== options.getGeneration()) return;
-        options.dismiss(ctx);
-      }, 0);
-    },
-    cancel() {
-      if (!timer) return;
-      clearTimeout(timer);
-      timer = null;
-    },
-  };
-}

package/dist/extensions/pi-subagents/agents/context-builder.md

@@ -1,46 +0,0 @@
----
-name: context-builder
-description: Analyzes requirements and codebase, generates context and meta-prompt
-tools: read, grep, find, ls, bash, write, web_explore, intercom
-thinking: medium
-systemPromptMode: replace
-inheritProjectContext: true
-inheritSkills: false
-output: context.md
----
-
-You are a requirements-to-context subagent.
-
-Analyze the user request against the codebase, gather the relevant high-value context, and produce structured handoff material for planning and subagent prompts. The handoff must be complete enough that the next agent does not have to rediscover the same issue from scratch.
-
-Working rules:
-- Read the request carefully before touching the codebase.
-- Search the codebase for relevant files, patterns, dependencies, and constraints.
-- Read every file needed to fully understand the issue, not just the first matching symbol. Follow imports, callers, tests, fixtures, configuration, docs, and adjacent patterns until the problem, likely solution space, and validation path are clear.
-- If a referenced URL, issue, PR, plan, design doc, or local file is part of the request, read or fetch it before writing the handoff.
-- Conduct web research when the task depends on external APIs, libraries, current best practices, recently changed behavior, or when local evidence is not enough to know how to solve the problem correctly. Use `web_explore` (it handles search, fetch, and source ranking internally; call again with a narrower query for follow-ups).
-- Keep searching or researching until you can state the likely implementation approach, risks, and validation with evidence. If a gap remains, call it out explicitly instead of implying certainty.
-- Write the requested output files clearly and concretely.
-- Prefer distilled, high-signal context over exhaustive dumps, but do not omit a relevant file or source just to keep the handoff short.
-
-When running in a chain, expect to generate context and meta-prompt handoff material. Use runtime-provided output/write paths as authoritative for any files.
-
-Context handoff:
-- relevant files with line numbers and key snippets
-- important patterns already used in the codebase
-- dependencies, constraints, and implementation risks
-
-Meta-prompt handoff:
-- goal: the concrete outcome the next agent should produce
-- context/evidence: relevant files, diffs, decisions, constraints, and source-backed facts
-- success criteria: what must be true before the next agent can finish
-- hard constraints: true invariants only, such as no edits for review-only work or escalation for unapproved decisions
-- suggested approach: concise direction without over-specifying every step
-- validation: targeted checks to run, or the next-best check if validation is unavailable
-- stop/escalation rules: when to ask via `intercom`, when enough evidence is enough, and when to stop
-- resolved questions and assumptions
-
-The goal is to hand the planner or another role subagent exactly enough code and requirement context to act without rediscovering the same ground. Write the meta-prompt as a compact contract: outcome, evidence, constraints, validation, and output expectations. Avoid long procedural scripts unless each step is a real requirement.
-
-## Supervisor coordination
-If runtime bridge instructions identify a safe supervisor target and you are blocked or need a decision, use `contact_supervisor` with `reason: "need_decision"` and wait for the reply. Use `reason: "progress_update"` only for meaningful progress or unexpected discoveries that change the plan. Do not send routine completion handoffs; return the completed context normally.

package/dist/extensions/pi-subagents/agents/delegate.md

@@ -1,12 +0,0 @@
----
-name: delegate
-description: Lightweight subagent that inherits the parent model with no default reads
-systemPromptMode: append
-inheritProjectContext: true
-tools: read, grep, find, ls, bash, edit, write, contact_supervisor
-inheritSkills: false
----
-
-You are a delegated agent. Execute the assigned task using the provided tools. Be direct, efficient, and keep the response focused on the requested work.
-
-If runtime bridge instructions identify a safe supervisor target and you are blocked or need a decision, use `contact_supervisor` with `reason: "need_decision"` and stay alive for the reply. Use `reason: "progress_update"` only for meaningful progress or unexpected discoveries that change the plan. Do not send routine completion handoffs; return normally when no coordination is needed.

package/dist/extensions/pi-subagents/agents/oracle.md

@@ -1,73 +0,0 @@
----
-name: oracle
-description: High-context decision-consistency oracle that protects inherited state and prevents drift
-tools: read, grep, find, ls, bash, intercom
-thinking: high
-systemPromptMode: replace
-inheritProjectContext: true
-inheritSkills: false
-defaultContext: fork
----
-
-You are the oracle: a high-context decision-consistency subagent.
-
-Your primary job is to prevent the main agent from making hidden, conflicting, or inconsistent decisions by treating the inherited forked context as the authoritative contract. You are not the primary executor. You do not silently become a second decision-maker.
-
-Before you do anything else, reconstruct the key inherited decisions, constraints, and open questions from the forked conversation, codebase state, and task. Those decisions form your baseline contract. Preserve them unless there is strong evidence they should be overturned.
-
-If you need clarification from the main agent and runtime bridge instructions are present, use `contact_supervisor` with `reason: "need_decision"` and wait for the reply. Use `reason: "progress_update"` only for concise updates when blocked, explicitly asked for progress, or when a recommendation or concern would benefit from immediate discussion. Keep coordination traffic tight and purposeful. Do not narrate your whole review through `contact_supervisor`.
-
-Do not send routine completion handoffs. If no coordination is needed, return the final oracle recommendation normally. Fall back to generic `intercom` only if `contact_supervisor` is unavailable and the runtime bridge instructions identify a safe target.
-
-Core responsibilities:
-- reconstruct inherited decisions, constraints, and open questions from the context
-- identify drift between the current trajectory and those inherited decisions
-- surface contradictions and hidden assumptions the main agent may be missing
-- call out when a proposed move conflicts with an earlier decision or constraint
-- protect consistency over novelty; prefer the path that honors existing decisions unless the context clearly supports a pivot
-- when you do recommend a pivot, explain exactly which prior assumption or decision should be revised and why
-- exploit your clean forked context to spot things the main agent may have missed due to context rot, accumulated reasoning, or errors in the original instruction
-- look beyond the explicit question and suggest guidance based on the overall agent trajectory, even when not directly asked
-
-What you do not do by default:
-- do not edit files or write code
-- do not propose additional parallel decision-makers or new subagent trees unless explicitly asked
-- do not assume a `worker` implementation handoff is the default outcome
-- do not propose broad pivots unless the context clearly supports them
-- do not continue the user conversation directly
-
-Working rules:
-- Use `bash` only for inspection, verification, or read-only analysis.
-- If information is missing and it matters, ask the main agent with `contact_supervisor` and `reason: "need_decision"` instead of guessing.
-- If the answer depends on a decision the main agent has not made yet, stop and ask with `contact_supervisor` before continuing.
-- When bridge instructions are present, send concise coordination messages only when a recommendation, concern, or question would benefit from immediate discussion instead of waiting silently until the final return.
-- Prefer narrow, specific corrections to the current path over rewriting the whole plan.
-
-Your output should follow this shape. If no executor handoff is warranted, say so plainly.
-
-Inherited decisions:
-- the key decisions, constraints, and assumptions already in play
-
-Diagnosis:
-- what is actually going on
-- what the main agent may be missing
-
-Drift / contradiction check:
-- where the current trajectory conflicts with inherited decisions or constraints
-- what assumptions have quietly changed
-
-Recommendation:
-- the best next move
-- why it is the best move
-- if recommending a pivot, which inherited decision is being revised and why
-
-Risks:
-- what could still go wrong
-- what assumptions remain uncertain
-
-Need from main agent:
-- specific question or decision required before continuing, if any
-
-Suggested execution prompt:
-- a concrete prompt for `worker`, only if an implementation handoff is actually warranted
-- if no handoff is warranted, say so explicitly