@iowarp/clio-coder 0.4.0 → 0.4.1

package/src/interactive/view/artifacts.ts

@@ -151,7 +151,6 @@ const RECEIPT_REQUIRED_KEYS = [
 	"costUsd",
 	"compiledPromptHash",
 	"staticCompositionHash",
-	"clioVersion",
 	"piMonoVersion",
 	"platform",
 	"nodeVersion",
@@ -255,7 +254,7 @@ export function receiptFilePath(stateDir: string, runId: string): string {
 	return join(stateDir, "receipts", `${runId}.json`);
 }
 
-export function runLedgerPath(stateDir: string): string {
+function runLedgerPath(stateDir: string): string {
 	return join(stateDir, "runs.json");
 }
 
@@ -317,7 +316,7 @@ type ReadLedgerResult = { ok: true; envelope: RunEnvelope } | { ok: false; reaso
  * the same file and ledger row, projected through the shared boundary so the
  * receipt view spells its verdict exactly as the board and the CLI do.
  */
-export function receiptTrustDetail(stateDir: string, runId: string): string {
+function receiptTrustDetail(stateDir: string, runId: string): string {
 	try {
 		const receipt = JSON.parse(readFileSync(receiptFilePath(stateDir, runId), "utf8")) as RunReceipt;
 		const ledger = readRunEnvelope(stateDir, runId);
@@ -335,7 +334,7 @@ function readRunEnvelope(stateDir: string, runId: string): ReadLedgerResult {
 	return { ok: false, reason: runs.length === 0 ? "run ledger not found" : "run not found in ledger" };
 }
 
-export function verifyReceiptFile(stateDir: string, runId: string): ReceiptVerifyResult {
+function verifyReceiptFile(stateDir: string, runId: string): ReceiptVerifyResult {
 	const target = receiptFilePath(stateDir, runId);
 	let raw: string;
 	try {
@@ -358,6 +357,9 @@ export function verifyReceiptFile(stateDir: string, runId: string): ReceiptVerif
 	for (const key of RECEIPT_REQUIRED_KEYS) {
 		if (!(key in r)) return { ok: false, reason: `missing field: ${key}` };
 	}
+	if (!("clioCoderVersion" in r) && !("clioVersion" in r)) {
+		return { ok: false, reason: "missing field: clioCoderVersion" };
+	}
 	if (!isNonEmptyString(r.runId)) {
 		return { ok: false, reason: `runId invalid: ${String(r.runId)}` };
 	}
@@ -413,8 +415,9 @@ export function verifyReceiptFile(stateDir: string, runId: string): ReceiptVerif
 	if (!isIso8601(r.endedAt)) {
 		return { ok: false, reason: `endedAt not ISO-8601: ${String(r.endedAt)}` };
 	}
-	if (typeof r.clioVersion !== "string" || r.clioVersion.length === 0) {
-		return { ok: false, reason: "clioVersion empty" };
+	const clioCoderVersion = r.clioCoderVersion ?? r.clioVersion;
+	if (typeof clioCoderVersion !== "string" || clioCoderVersion.length === 0) {
+		return { ok: false, reason: "clioCoderVersion empty" };
 	}
 	if (!isNonEmptyString(r.piMonoVersion)) {
 		return { ok: false, reason: `piMonoVersion invalid: ${String(r.piMonoVersion)}` };
@@ -453,7 +456,7 @@ export function verifyReceiptFile(stateDir: string, runId: string): ReceiptVerif
 
 const RECEIPT_FILE_FAILURE = /^(?:receipt file not found|read error:)/u;
 const RECEIPT_CONTRACT_FAILURE =
-	/^(?:invalid json:|receipt is not an object|missing field:|runId invalid:|runId mismatch:|agentId invalid:|task invalid:|targetId invalid:|wireModelId invalid:|runtimeId invalid:|runtimeKind invalid:|exitCode out of range:|tokenCount out of range:|inputTokenCount out of range:|outputTokenCount out of range:|cacheReadTokenCount out of range:|cacheWriteTokenCount out of range:|costUsd out of range:|reasoningTokenCount out of range:|startedAt not ISO-8601:|endedAt not ISO-8601:|clioVersion empty|piMonoVersion invalid:|platform invalid:|nodeVersion invalid:|toolCalls out of range:|toolStats\[|compiledPromptHash invalid:|staticCompositionHash invalid:|sessionId invalid:|integrity invalid|execution role invalid|routing intent invalid|route decision invalid)/u;
+	/^(?:invalid json:|receipt is not an object|missing field:|runId invalid:|runId mismatch:|agentId invalid:|task invalid:|targetId invalid:|wireModelId invalid:|runtimeId invalid:|runtimeKind invalid:|exitCode out of range:|tokenCount out of range:|inputTokenCount out of range:|outputTokenCount out of range:|cacheReadTokenCount out of range:|cacheWriteTokenCount out of range:|costUsd out of range:|reasoningTokenCount out of range:|startedAt not ISO-8601:|endedAt not ISO-8601:|clioCoderVersion empty|piMonoVersion invalid:|platform invalid:|nodeVersion invalid:|toolCalls out of range:|toolStats\[|compiledPromptHash invalid:|staticCompositionHash invalid:|sessionId invalid:|integrity invalid|execution role invalid|routing intent invalid|route decision invalid)/u;
 const LEDGER_FAILURE = /^(?:run ledger not found|run not found in ledger|ledger mismatch:)/u;
 
 function receiptIntegrityDigest(value: unknown): string | null {
@@ -586,7 +589,7 @@ function splitLinesCapped(text: string, path?: string, maxLines = VIEW_ARTIFACT_
 	return [...lines.slice(0, maxLines), `[truncated, open file directly${path ? `: ${path}` : ""}]`];
 }
 
-export async function loadJsonFileLines(path: string): Promise<ViewArtifactLoadResult> {
+async function loadJsonFileLines(path: string): Promise<ViewArtifactLoadResult> {
 	let canPrettyPrint = false;
 	try {
 		const info = await stat(path);
@@ -1569,7 +1572,7 @@ export function createDefaultArtifactProviders(deps: ArtifactProviderDeps): Arti
 	];
 }
 
-export function sortViewArtifacts(artifacts: ReadonlyArray<ViewArtifact>): ViewArtifact[] {
+function sortViewArtifacts(artifacts: ReadonlyArray<ViewArtifact>): ViewArtifact[] {
 	return [...artifacts].sort((a, b) => {
 		const time = b.timestamp - a.timestamp;
 		if (time !== 0) return time;

package/src/interactive/view/view-overlay.ts

@@ -141,7 +141,7 @@ function isViewArtifactCategory(value: string): value is ViewArtifactCategory {
 	return VIEW_ARTIFACT_CATEGORY_SET.has(value as ViewArtifactCategory);
 }
 
-export function parseViewFilterQuery(query: string): ViewFilterQuery {
+function parseViewFilterQuery(query: string): ViewFilterQuery {
 	const text = query.trim();
 	if (text.length === 0) return { kind: "text", text };
 	const colon = text.indexOf(":");
@@ -215,7 +215,7 @@ function formatLocalTime(timestamp: number): string {
 	return !Number.isFinite(timestamp) || timestamp <= 0 ? "unknown time" : clockLocal(timestamp);
 }
 
-export function filterViewArtifacts(artifacts: ReadonlyArray<ViewArtifact>, query: string): ViewArtifact[] {
+function filterViewArtifacts(artifacts: ReadonlyArray<ViewArtifact>, query: string): ViewArtifact[] {
 	const parsed = parseViewFilterQuery(query);
 	if (parsed.kind === "category") {
 		const categoryArtifacts = artifacts.filter((artifact) => artifact.category === parsed.category);
@@ -226,11 +226,11 @@ export function filterViewArtifacts(artifacts: ReadonlyArray<ViewArtifact>, quer
 	return fuzzyFilter([...artifacts], parsed.text, broadFilterText);
 }
 
-export function artifactsInCategoryOrder(artifacts: ReadonlyArray<ViewArtifact>): ViewArtifact[] {
+function artifactsInCategoryOrder(artifacts: ReadonlyArray<ViewArtifact>): ViewArtifact[] {
 	return VIEW_ARTIFACT_CATEGORIES.flatMap((category) => artifacts.filter((artifact) => artifact.category === category));
 }
 
-export function initialViewSelection(artifacts: ReadonlyArray<ViewArtifact>, initialFilter = ""): number {
+function initialViewSelection(artifacts: ReadonlyArray<ViewArtifact>, initialFilter = ""): number {
 	const filtered = filterViewArtifacts(artifacts, initialFilter);
 	const first = filtered[0];
 	if (!first) return 0;
@@ -252,7 +252,7 @@ export function initialViewSelection(artifacts: ReadonlyArray<ViewArtifact>, ini
 	return Math.max(0, artifactsInCategoryOrder(filtered).indexOf(selected));
 }
 
-export function nextCategorySelection(
+function nextCategorySelection(
 	artifacts: ReadonlyArray<ViewArtifact>,
 	currentIndex: number,
 	direction: -1 | 1,
@@ -271,7 +271,7 @@ export function nextCategorySelection(
 	return safeCurrent;
 }
 
-export function groupedViewRows(artifacts: ReadonlyArray<ViewArtifact>): RenderedViewRow[] {
+function groupedViewRows(artifacts: ReadonlyArray<ViewArtifact>): RenderedViewRow[] {
 	const rows: RenderedViewRow[] = [];
 	for (const category of VIEW_ARTIFACT_CATEGORIES) {
 		const items = artifacts.filter((artifact) => artifact.category === category);
@@ -334,7 +334,7 @@ function verificationText(state: ViewVerificationState | undefined): string {
 	return `${GLYPH.error} verify fail ${state.detail}`;
 }
 
-export function buildArtifactHeader(
+function buildArtifactHeader(
 	artifact: ViewArtifact | undefined,
 	verification: ViewVerificationState | undefined,
 	width: number,
@@ -361,7 +361,7 @@ export function buildArtifactHeader(
 }
 
 /** Put verification on wrapped rows so a canonical receipt verdict is never reduced to a prefix. */
-export function buildArtifactHeaderLines(
+function buildArtifactHeaderLines(
 	artifact: ViewArtifact | undefined,
 	verification: ViewVerificationState | undefined,
 	width: number,
@@ -384,7 +384,7 @@ export function buildArtifactHeaderLines(
 	];
 }
 
-export function viewFooterHint(focus: ViewPaneFocus, canVerify: boolean, innerWidth?: number): string {
+function viewFooterHint(focus: ViewPaneFocus, canVerify: boolean, innerWidth?: number): string {
 	// One pane at a time means Tab is how the other one is reached, so the
 	// narrow footer states it. The generic elider drops middle entries, and Tab
 	// sits in the middle.
@@ -527,6 +527,7 @@ export class ViewOverlayView implements Component {
 	private renderedContentLines(width: number): string[] {
 		const content = this.content;
 		if (!content) return [];
+		if (content.status === "error") return content.lines.flatMap((line) => wrapTextWithAnsi(line, Math.max(1, width)));
 		if (content.format !== "markdown") return content.lines;
 		if (content.renderedLines && content.renderWidth === width) return content.renderedLines;
 		const md = new Markdown(content.lines.join("\n"), 0, 0, markdownTheme(clioTheme()));
@@ -548,7 +549,9 @@ export class ViewOverlayView implements Component {
 			return this.fixedLines(lines, width, height);
 		}
 		if (this.artifactError) {
-			lines.push(padAnsi(theme.fg("error", this.artifactError), width, ELLIPSIS));
+			lines.push(
+				...wrapTextWithAnsi(theme.fg("error", this.artifactError), Math.max(1, width)).map((line) => padAnsi(line, width)),
+			);
 			return this.fixedLines(lines, width, height);
 		}
 

package/src/interactive/watch-pane.ts

@@ -21,7 +21,7 @@
 import { mkdirSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { type ClioDirs, clioCacheDir, clioConfigDir, clioDataDir, clioStateDir } from "../core/xdg.js";
-import type { MuxContract } from "../domains/mux/index.js";
+import type { MuxContract, MuxPaneRef } from "../domains/mux/index.js";
 import type { PanesWatchController, PanesWatchResult } from "../domains/mux/operations.js";
 import { watchViewerCommand } from "../domains/mux/viewer-command.js";
 
@@ -38,6 +38,12 @@ function watchSelectionPath(stateDir: string = clioStateDir()): string {
 export interface WatchPaneDeps {
 	mux: MuxContract;
 	getCwd: () => string;
+	/**
+	 * Live workers-dock share, read at each open so a `/settings` edit applies
+	 * to the next pane. Absent (tests, minimal wiring) the dock spec's default
+	 * governs.
+	 */
+	getWorkersRatio?: () => number;
 	/** Selection-file override for tests. */
 	selectionPath?: string;
 	/** Resolved-layout override for tests. Production pins this process's four cached roots. */
@@ -78,7 +84,7 @@ export function createWatchPaneController(deps: WatchPaneDeps): PanesWatchContro
 		if (disposed || paneId !== null) return Promise.resolve(true);
 		if (adoptionInFlight !== null) return adoptionInFlight;
 		const attempt = Promise.resolve()
-			.then(() => deps.mux.adoptPane({ purpose: "watch", label: "watch" }))
+			.then(() => deps.mux.adoptPane({ purpose: "watch", label: "watch", dock: "workers" }))
 			.then((adopted) => {
 				if (!disposed && paneId === null && adopted !== null) paneId = adopted.paneId;
 				return true;
@@ -104,11 +110,40 @@ export function createWatchPaneController(deps: WatchPaneDeps): PanesWatchContro
 		}
 	};
 
+	/**
+	 * The one place a watch pane is created: the workers dock slot, split right
+	 * of Clio's pane at the configured share. On a host without the layout tier
+	 * the dock request degrades inside the contract to a plain right split.
+	 */
+	const openPane = (): Promise<MuxPaneRef | null> =>
+		deps.mux.openUtilityPane({
+			argv: command(selectionPath, dirs),
+			cwd: deps.getCwd(),
+			label: "watch",
+			title: "clio-coder watch",
+			purpose: "watch",
+			dock: { slot: "workers", ...(deps.getWorkersRatio ? { share: deps.getWorkersRatio() } : {}) },
+		});
+
 	// Reclaim durable ownership for inventory and navigation immediately. The
 	// scan remains best effort and never opens a replacement pane on its own.
 	void adoptExistingPane();
 
 	return {
+		async ensureOpen(): Promise<boolean> {
+			// Boot composition: the pane exists and parks on the last selection
+			// (the viewer renders "no selection" until one is written). Adoption
+			// first, so a surviving dock is reused rather than doubled.
+			if (disposed) return false;
+			if (paneId !== null) return true;
+			await adoptExistingPane();
+			if (paneId !== null) return true;
+			const opened = await openPane();
+			if (opened === null) return false;
+			paneId = opened.paneId;
+			return true;
+		},
+
 		async watch(runId: string): Promise<PanesWatchResult> {
 			if (!writeSelection(runId)) {
 				return { status: "unavailable", reason: `cannot write the watch selection at ${selectionPath}` };
@@ -117,14 +152,7 @@ export function createWatchPaneController(deps: WatchPaneDeps): PanesWatchContro
 			const scanned = await adoptExistingPane();
 			if (!scanned) await adoptExistingPane();
 			if (paneId !== null) return { status: "watching", runId, paneId, opened: false };
-			const opened = await deps.mux.openUtilityPane({
-				argv: command(selectionPath, dirs),
-				cwd: deps.getCwd(),
-				label: "watch",
-				title: "clio watch",
-				purpose: "watch",
-				direction: "right",
-			});
+			const opened = await openPane();
 			if (opened === null) {
 				return { status: "unavailable", reason: "the pane host refused to open the watch pane" };
 			}

package/src/interactive/welcome-dashboard.ts

@@ -103,7 +103,7 @@ function findCurrentStatus(
 	statuses: ReadonlyArray<TargetStatus>,
 	settings: Readonly<ClioSettings> | undefined,
 ): TargetStatus | null {
-	const targetId = settings?.orchestrator?.target ?? null;
+	const targetId = settings?.chat?.target ?? null;
 	if (!targetId) return null;
 	return statuses.find((status) => status.target.id === targetId) ?? null;
 }
@@ -127,7 +127,7 @@ function selectedModelCapabilities(
 	providers: ProvidersContract,
 ): CapabilityFlags | null {
 	if (!status) return null;
-	const wireModelId = settings?.orchestrator?.model ?? status.target.defaultModel ?? null;
+	const wireModelId = settings?.chat?.model ?? status.target.defaultModel ?? null;
 	const detectedReasoning =
 		wireModelId && typeof providers.getDetectedReasoning === "function"
 			? providers.getDetectedReasoning(status.target.id, wireModelId)
@@ -216,7 +216,7 @@ function handoffFacts(cwd: string): { handoffCount: number; handoffFreshness: st
 	}
 }
 
-export function readWelcomeRepositoryFacts(cwd: string): WelcomeRepositoryFacts {
+function readWelcomeRepositoryFacts(cwd: string): WelcomeRepositoryFacts {
 	const codewiki = readCodewiki(cwd);
 	const wiki = codewiki ? wikiFactsFrom(cwd, wikiStaleness(cwd)) : { wikiPageCount: 0, wikiStatus: NO_WIKI_STATUS };
 	return {
@@ -255,7 +255,7 @@ async function readWelcomeRepositoryFactsAsync(cwd: string): Promise<WelcomeRepo
  * guessed, because it decides whether the Wiki row exists at all and the whole
  * point of a placeholder is that the banner never changes height.
  */
-export function placeholderRepositoryFacts(cwd: string): WelcomeRepositoryFacts {
+function placeholderRepositoryFacts(cwd: string): WelcomeRepositoryFacts {
 	return {
 		clioMdStatus: clioMdStatusFor(cwd),
 		hasCodewiki: existsSync(join(cwd, ".clio-coder", "codewiki.json")),
@@ -269,13 +269,13 @@ export function placeholderRepositoryFacts(cwd: string): WelcomeRepositoryFacts
 	};
 }
 
-export function deriveWelcomeDashboardStats(deps: WelcomeDashboardDeps): WelcomeDashboardStats {
+function deriveWelcomeDashboardStats(deps: WelcomeDashboardDeps): WelcomeDashboardStats {
 	const settings = deps.getSettings?.();
 	const statuses = deps.providers.list();
 	const current = findCurrentStatus(statuses, settings);
 	// Left null when unset; formatTargetLabel owns the one spelling for that.
-	const targetLabel = current?.target.id ?? settings?.orchestrator?.target ?? null;
-	const modelLabel = settings?.orchestrator?.model ?? current?.target.defaultModel ?? null;
+	const targetLabel = current?.target.id ?? settings?.chat?.target ?? null;
+	const modelLabel = settings?.chat?.model ?? current?.target.defaultModel ?? null;
 	const workspace = deps.getWorkspaceSnapshot?.() ?? null;
 	const cwd = workspace?.cwd ?? process.cwd();
 	const currentAvailable = current ? activeStatus(current) : false;
@@ -283,16 +283,16 @@ export function deriveWelcomeDashboardStats(deps: WelcomeDashboardDeps): Welcome
 	const thinkingLevel =
 		resolveModelRuntimeCapabilitiesForProviders(
 			deps.providers,
-			settings?.orchestrator?.target,
-			settings?.orchestrator?.model,
-			settings?.orchestrator?.thinkingLevel ?? "off",
+			settings?.chat?.target,
+			settings?.chat?.model,
+			settings?.chat?.thinkingLevel ?? "off",
 		)?.thinking.display ??
-		settings?.orchestrator?.thinkingLevel ??
+		settings?.chat?.thinkingLevel ??
 		"off";
 
-	const autonomy = settings?.autonomy ?? "auto-edit";
-	const toolProfile = settings?.delegation?.defaults?.toolGovernance ?? "clio-policy";
-	const threshold = settings?.compaction?.threshold;
+	const autonomy = settings?.safety.autonomy ?? "auto-edit";
+	const toolProfile = settings?.integrations.externalAgents?.defaults?.toolGovernance ?? "clio-coder-policy";
+	const threshold = settings?.context.compaction?.threshold;
 	const compactionThreshold =
 		typeof threshold === "number" && Number.isFinite(threshold) ? `${Math.round(threshold * 100)}%` : "80%";
 
@@ -376,7 +376,7 @@ function nextValue(stats: WelcomeDashboardStats): string {
  * route answers, and what the context is ready for. Maturity caveats belong
  * in the README, not in a line the operator reads on every turn.
  */
-export function buildWelcomeDashboardLines(
+function buildWelcomeDashboardLines(
 	stats: WelcomeDashboardStats,
 	width: number,
 	mode: WelcomeDashboardMode = "launchpad",

package/src/interactive/worker-progress.ts

@@ -164,9 +164,9 @@ function isThinkingEvent(event: Record<string, unknown>): boolean {
 	return assistantEvent?.type === "thinking_delta";
 }
 
-/** The action a `clio_tool_start`/`clio_tool_finish` event names, or null when it is neither. */
+/** The action a `clio_coder_tool_start`/`clio_coder_tool_finish` event names, or null when it is neither. */
 function toolEventAction(event: Record<string, unknown>): WorkerAction | null {
-	if (event.type !== "clio_tool_start" && event.type !== "clio_tool_finish") return null;
+	if (event.type !== "clio_coder_tool_start" && event.type !== "clio_coder_tool_finish") return null;
 	const payload = isRecord(event.payload) ? event.payload : null;
 	const tool = nonEmptyString(payload?.tool);
 	if (tool === undefined) return null;
@@ -363,7 +363,7 @@ export function createWorkerProgressFold(): WorkerProgressFold {
 			}
 
 			const action = toolEventAction(event);
-			if (action !== null && event.type === "clio_tool_start") {
+			if (action !== null && event.type === "clio_coder_tool_start") {
 				if (action.toolCallId !== undefined) {
 					const duplicate = pendingActionsById.get(action.toolCallId);
 					if (duplicate !== undefined) removePendingAction(duplicate);
@@ -375,7 +375,7 @@ export function createWorkerProgressFold(): WorkerProgressFold {
 				touch();
 				setPhase("tool");
 				changed = true;
-			} else if (action !== null && event.type === "clio_tool_finish") {
+			} else if (action !== null && event.type === "clio_coder_tool_finish") {
 				// An id is authoritative when both sides carry it. If either side came
 				// from an older or incomplete producer, retain the historical name match.
 				const finished =

package/src/interactive/worker-receipts.ts

@@ -77,7 +77,7 @@ function contractKindFrom(receipt: Record<string, unknown>): WorkerPresentedResu
  * by older versions of Clio are still valid history, so every field is read
  * structurally and a missing one degrades the footer rather than the render.
  */
-export function workerReceiptFacts(receipt: Record<string, unknown>): WorkerReceiptFacts | null {
+function workerReceiptFacts(receipt: Record<string, unknown>): WorkerReceiptFacts | null {
 	const outcome = optionalString(receipt.outcome);
 	if (outcome === undefined) return null;
 	const output = isRecord(receipt.output) ? receipt.output : null;

package/src/interactive/worker-stream.ts

@@ -185,10 +185,7 @@ function finiteNumber(value: unknown): number | undefined {
 	return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
 
-export function workerRuntimeKind(
-	runtimeKind: RunKind | undefined,
-	runtimeId: string | undefined,
-): WorkerRunRuntimeKind {
+function workerRuntimeKind(runtimeKind: RunKind | undefined, runtimeId: string | undefined): WorkerRunRuntimeKind {
 	if (runtimeKind === "acp-delegation") return "acp";
 	if (runtimeId === "claude-code") return "claude-code";
 	if (runtimeId === "claude-sdk") return "claude-sdk";

package/src/interactive/yazi-bridge.ts

@@ -25,6 +25,8 @@ export interface YaziBridgeSettings {
 	mode: YaziSessionMode;
 	profile: YaziProfileMode;
 	followCwd: boolean;
+	/** Files-dock share of the height; absent leaves the dock spec's default. */
+	ratio?: number;
 }
 
 export interface YaziMentionBatch {
@@ -111,7 +113,7 @@ function readOptional(path: string): string {
  * before the TUI lease is released. A missing or below-floor binary therefore
  * leaves the screen intact and returns the shared doctor sentence verbatim.
  */
-export async function runYaziTerminalChooser(options: YaziTerminalChooserOptions): Promise<YaziTerminalChooserResult> {
+async function runYaziTerminalChooser(options: YaziTerminalChooserOptions): Promise<YaziTerminalChooserResult> {
 	const binaries = (options.resolveBinaries ?? resolveYaziBinaries)();
 	if (!binaries.yaziPath) {
 		return { status: "missing-binary", binary: "yazi", detail: binaries.missingYaziDetail };
@@ -217,7 +219,7 @@ function pathKind(path: string): "file" | "directory" | "other" {
 }
 
 /** Format one DDS or chooser batch for the composer without ever submitting it. */
-export function formatYaziMentions(
+function formatYaziMentions(
 	paths: ReadonlyArray<string>,
 	options: {
 		cwd: string;
@@ -328,7 +330,11 @@ export function createYaziBridge(deps: YaziBridgeDeps): YaziBridge {
 		}
 	};
 
-	const start = async (mode: YaziSessionMode, profileMode: YaziProfileMode): Promise<YaziBridgeOpenResult> => {
+	const start = async (
+		mode: YaziSessionMode,
+		profileMode: YaziProfileMode,
+		dockShare?: number,
+	): Promise<YaziBridgeOpenResult> => {
 		const mux = deps.mux;
 		if (!mux?.available()) return { status: "unavailable", reason: "the pane layer is not available" };
 		generation += 1;
@@ -341,6 +347,7 @@ export function createYaziBridge(deps: YaziBridgeDeps): YaziBridge {
 			mode,
 			profileMode,
 			cwd: deps.getCwd(),
+			...(dockShare === undefined ? {} : { dockShare }),
 			pickToken: token,
 			onEvent: (event: YaziEvent) => {
 				if (disposed || ownGeneration !== generation) return;
@@ -379,7 +386,7 @@ export function createYaziBridge(deps: YaziBridgeDeps): YaziBridge {
 				active = null;
 				deps.notice("warning", "the file-pane event stream did not start; reopening yazi in chooser mode");
 				void stale.close().finally(() => {
-					if (!disposed && ownGeneration === generation) void start("chooser", profileMode);
+					if (!disposed && ownGeneration === generation) void start("chooser", profileMode, dockShare);
 				});
 			}, deps.livenessMs ?? YAZI_LIVENESS_MS);
 			livenessTimer.unref();
@@ -419,7 +426,7 @@ export function createYaziBridge(deps: YaziBridgeDeps): YaziBridge {
 				}
 				return result;
 			}
-			return await start(mode, settings.profile);
+			return await start(mode, settings.profile, settings.ratio);
 		},
 		status(): Readonly<YaziBridgeStatus> {
 			const snapshot = active?.snapshot();

package/src/tools/ask-user.ts

@@ -261,7 +261,7 @@ function normalizeDecisions(value: unknown): { decisions?: AskUserDecision[]; er
 	return { decisions };
 }
 
-export function normalizeAskUserCall(args: Record<string, unknown>): { call?: AskUserCall; error?: string } {
+function normalizeAskUserCall(args: Record<string, unknown>): { call?: AskUserCall; error?: string } {
 	const rawAction = trimOptionalString(args.action)?.toLowerCase() ?? "ask";
 	if (rawAction !== "ask" && rawAction !== "complete") {
 		return { error: "action must be ask or complete" };
@@ -499,7 +499,7 @@ async function persistAskUserTranscript(
 		await mkdir(dir, { recursive: true });
 		if (!policy.transcriptPath) policy.transcriptPath = path.join(dir, transcriptFileName(policy));
 		const transcript = {
-			schema: "clio.ask_user.interview.v1",
+			schema: "clio-coder.ask_user.interview.v1",
 			id: policy.id,
 			status: policy.status,
 			startedAt: policy.startedAt,
@@ -595,7 +595,7 @@ async function completeInterview(
 	return okInterviewResult(policy, event);
 }
 
-export async function finalizeAskUserInterview(
+async function finalizeAskUserInterview(
 	policy: AskUserToolPolicy,
 	reason: string,
 	options?: ToolInvokeOptions,

package/src/tools/bash.ts

@@ -48,7 +48,7 @@ export const BASH_DEFAULT_RESULT_DISPOSITION: ToolResultDisposition = {
 };
 
 /** Pure, idempotent normalization used by registry admission and direct calls. */
-export function normalizeBashArguments(args: Record<string, unknown>): Record<string, unknown> {
+function normalizeBashArguments(args: Record<string, unknown>): Record<string, unknown> {
 	return args.output_policy === undefined ? { ...args, output_policy: "bounded" } : args;
 }
 

package/src/tools/builtin-tool-catalog.ts

@@ -95,7 +95,7 @@ const TOOL_METADATA: Readonly<Record<string, ToolMetadata>> = {
 		),
 		costLatency: "local_fast",
 		promptHint:
-			'Call context with scope="skills" to list installed and marketplace skills; when one matches the task, or the operator names a skill or asks how one works, suggest the operator run /skill <name> (a marketplace skill is offered for install) and never load it uninvited. When the user message carries a skill request, first load that skill via context (scope="skills", name=<skill>) before doing anything else. When an [evicted ...] marker names content you need, recall it with context(scope="recall", ref=...); re-read the file only when the marker says it changed.',
+			'Call context with scope="skills" to list installed and marketplace skills; when one matches the task, or the operator names a skill or asks how one works, suggest the operator run /skill <name> (a marketplace skill is offered for install) and never load it uninvited; a [Marketplace] reminder naming an uninstalled skill may instead be offered through ask_user with its exact options, and the harness performs any install. When the user message carries a skill request, first load that skill via context (scope="skills", name=<skill>) before doing anything else. When an [evicted ...] marker names content you need, recall it with context(scope="recall", ref=...); re-read the file only when the marker says it changed.',
 	},
 	[ToolNames.CredentialPresent]: {
 		objective: "Check whether a credential key is present without returning its value.",

package/src/tools/compete-worktrees.ts

@@ -2,7 +2,7 @@
  * Scratch git worktrees for the compete dispatch topology.
  *
  * Each candidate builds in its own worktree on its own branch
- * (`clio/compete/<group>/<n>`), created from the repository HEAD under
+ * (`clio-coder/compete/<group>/<n>`), created from the repository HEAD under
  * `<root>/.clio-coder/worktrees/<group>/candidate-<n>`. The path sits inside the
  * project root because remote fleet nodes share the filesystem and doctor
  * preflight verifies path parity only for the project root; `.clio-coder/` is
@@ -127,8 +127,9 @@ export interface CompeteRunAdmission {
 
 const COMPETE_PARENT_SEGMENTS = [".clio-coder", "worktrees"] as const;
 const COMPETE_MANIFEST_FILE = ".clio-coder-compete-owner.json";
-const COMPETE_MANIFEST_KIND = "clio-compete-group";
-const COMPETE_COMMIT_IDENTITY = "clio-compete";
+const COMPETE_MANIFEST_KIND = "clio-coder-compete-group";
+const LEGACY_COMPETE_MANIFEST_KIND = "clio-compete-group";
+const COMPETE_COMMIT_IDENTITY = "clio-coder-compete";
 
 const SAFE_GROUP = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
 const PROCESS_EXIT_GRACE_MS = 750;
@@ -324,7 +325,7 @@ function isCanonicalDirectoryAt(path: string): boolean {
  * `relative()` makes the decision by path segment, so `/group-a2` can never
  * be mistaken for a child of `/group-a` as it can with textual startsWith.
  */
-export function isCanonicalPathInside(parent: string, candidate: string): boolean {
+function isCanonicalPathInside(parent: string, candidate: string): boolean {
 	return isCanonicalWorktreePathInside(parent, candidate);
 }
 
@@ -333,7 +334,7 @@ function manifestFromUnknown(value: unknown): CompeteGroupManifest | null {
 	const manifest = value as Record<string, unknown>;
 	if (
 		manifest.version !== 2 ||
-		manifest.kind !== COMPETE_MANIFEST_KIND ||
+		(manifest.kind !== COMPETE_MANIFEST_KIND && manifest.kind !== LEGACY_COMPETE_MANIFEST_KIND) ||
 		typeof manifest.root !== "string" ||
 		typeof manifest.group !== "string" ||
 		typeof manifest.token !== "string" ||
@@ -417,10 +418,14 @@ export function isGitRepository(root: string): boolean {
 	}
 }
 
-function competeBranch(group: string, index: number): string {
+function competeBranch(group: string, index: number, legacy = false): string {
 	validateGroup(group);
 	if (!Number.isInteger(index) || index < 1) throw new Error(`invalid compete candidate index ${index}`);
-	return `clio/compete/${group}/${index}`;
+	return `${legacy ? "clio" : "clio-coder"}/compete/${group}/${index}`;
+}
+
+function competeBranchMatches(branch: string, group: string, index: number): boolean {
+	return branch === competeBranch(group, index) || branch === competeBranch(group, index, true);
 }
 
 /** Claim the group before creating a branch or candidate worktree. */
@@ -549,11 +554,7 @@ export function markCompeteGroupWinnerPreserved(
  * baseline is a parameter rather than HEAD so every candidate in a compete
  * transaction starts from the same approved state.
  */
-export function createCandidateWorktree(
-	ownership: CompeteGroupOwnership,
-	index: number,
-	baseline: string,
-): CandidateWorktree {
+function createCandidateWorktree(ownership: CompeteGroupOwnership, index: number, baseline: string): CandidateWorktree {
 	assertOwnership(ownership);
 	const branch = competeBranch(ownership.group, index);
 	const path = join(ownership.directory, `candidate-${index}`);
@@ -589,7 +590,7 @@ export async function createCandidateWorktreeMapped(
 				branch,
 				base: baseline,
 				path,
-				label: `clio compete ${ownership.group} candidate ${index}`,
+				label: `clio-coder compete ${ownership.group} candidate ${index}`,
 				focus: false,
 			})
 			.catch(() => null);
@@ -652,7 +653,7 @@ function exactGroupBranches(root: string, group: string): string[] {
 			const parts = branch.split("/");
 			return (
 				parts.length === 4 &&
-				parts[0] === "clio" &&
+				(parts[0] === "clio-coder" || parts[0] === "clio") &&
 				parts[1] === "compete" &&
 				parts[2] === group &&
 				/^\d+$/.test(parts[3] ?? "")
@@ -660,6 +661,16 @@ function exactGroupBranches(root: string, group: string): string[] {
 		});
 }
 
+/** Resolve a current candidate branch while retaining indefinite read support for released refs. */
+export function competeBranchForCandidate(root: string, group: string, index: number): string {
+	const branches = exactGroupBranches(root, group);
+	return (
+		branches.find((branch) => branch === competeBranch(group, index)) ??
+		branches.find((branch) => branch === competeBranch(group, index, true)) ??
+		competeBranch(group, index)
+	);
+}
+
 function removeRegisteredWorktree(root: string, path: string): void {
 	try {
 		git(root, ["worktree", "remove", "--force", path]);
@@ -676,10 +687,9 @@ function removeCandidateWorktree(
 ): void {
 	assertOwnership(ownership);
 	const expectedPath = join(ownership.directory, `candidate-${worktree.index}`);
-	const expectedBranch = competeBranch(ownership.group, worktree.index);
 	if (
 		resolve(worktree.path) !== resolve(expectedPath) ||
-		worktree.branch !== expectedBranch ||
+		!competeBranchMatches(worktree.branch, ownership.group, worktree.index) ||
 		!isCanonicalPathInside(ownership.directory, worktree.path)
 	) {
 		throw new Error(`candidate ${worktree.index} does not belong to compete group ${ownership.group}`);
@@ -819,8 +829,8 @@ export function settleRecoveredCompeteDecision(
 		cleanupWorktreeGroup(ownership);
 		return null;
 	}
-	const winnerBranch = competeBranch(group, winnerIndex);
 	const branches = exactGroupBranches(ownership.root, group);
+	const winnerBranch = competeBranchForCandidate(ownership.root, group, winnerIndex);
 	const winnerPath = join(ownership.directory, `candidate-${winnerIndex}`);
 	if (
 		!branches.includes(winnerBranch) ||