@iowarp/clio-coder 0.4.0 → 0.4.1

package/src/domains/prompts/fragments/operating/skills.md

@@ -1,26 +1,33 @@
 ---
 id: operating.skills
 version: 1
-budgetTokens: 260
+budgetTokens: 340
 description: Coordinator skill suggestion discipline; rendered only when context is on the surface
 ---
 
 # Skills
 
-Skills package proven workflows. Some are installed; the rest sit in
-a marketplace the operator installs from, and context (scope="skills")
-lists both. Some tasks are skill-shaped: stress-testing a plan or
-idea, a benchmark or a change that must get faster or more accurate, a
-debug that has stalled or keeps flaking, turning an idea into a spec,
-slicing a plan into a sprint, or a run that needs an API key or token.
-On a skill-shaped task, first call context (scope="skills") and match
-the task against the catalog. Suggest the best match to the operator
-as /skill <name>, or the sequence in order when skills compose, and
-let the operator decide before grinding through that workflow bare. A
-marketplace match is suggested the same way; /skill <name> offers the
-install. When the operator names a skill or asks how one works, call
-context (scope="skills") before searching the repository: a skill is
-not a file in the working tree. Only an explicit
-operator request activates a skill; never load one on your own. If
-nothing fits or the task is routine, proceed normally and suggest
-nothing.
+Skills package proven workflows. Some are installed; the rest sit in a
+marketplace the operator installs from, and context (scope="skills") is
+the one authoritative listing of both — never guess the inventory or
+search the repository for a skill file. The catalog spans git delivery
+(filing, fixing, and shipping issues), planning (intent, PRD, backlog,
+architecture, sprint slicing), coding practice (TDD, standards,
+prototyping), context priming and handoff, research workflows, and
+plan-stress-testing debates. When a task lands in one of those shapes,
+call context (scope="skills") first and match it against the catalog.
+Suggest the best match to the operator as /skill <name> — the sequence
+in order when skills compose — and let the operator decide before
+grinding through that workflow bare; a marketplace match is suggested
+the same way, and /skill <name> offers the install. When the operator
+names a skill or asks how one works, answer from that same listing.
+When a [Marketplace] reminder names an uninstalled skill for the
+current request, first check the installed side with context
+(scope="skills"); only if nothing installed serves and the named skill
+truly fits, put the install question to the operator with ask_user
+using exactly the four options the reminder states, then continue the
+task in the same turn. The harness performs any consented install;
+never install a skill yourself, and never offer one no reminder named.
+Only an explicit operator request activates a skill; never load one on
+your own. If nothing fits or the task is routine, proceed normally and
+suggest nothing.

package/src/domains/providers/extension.ts

@@ -88,7 +88,7 @@ function positiveWindow(value: unknown): number | undefined {
  * `n_ctx: 0` still discovers the window it did publish, instead of silently
  * falling back to the runtime descriptor's placeholder.
  */
-export function capabilitiesFor(
+function capabilitiesFor(
 	desc: RuntimeDescriptor,
 	target: TargetDescriptor,
 	probe: ProbeMerge,
@@ -173,7 +173,7 @@ export interface ProbeMerge {
  * `cache`, while health and availability (decided by the caller from `probe`)
  * reflect the failure. Only a successful probe replaces the catalog.
  */
-export function mergeProbeResult(
+function mergeProbeResult(
 	desc: RuntimeDescriptor,
 	target: TargetDescriptor,
 	probe: ProbeResult | null,
@@ -224,7 +224,7 @@ export function mergeProbeResult(
  * Returns the reason when the default is not served, null when it is or when
  * there is no live evidence either way.
  */
-export function unservedDefaultModelReason(
+function unservedDefaultModelReason(
 	desc: Pick<RuntimeDescriptor, "id">,
 	target: Pick<TargetDescriptor, "defaultModel">,
 	merge: Pick<ProbeMerge, "discoveredModels" | "discoveredModelsSource" | "discoveredModelStates">,
@@ -396,7 +396,7 @@ export function createProvidersBundle(context: DomainContext): DomainBundle<Prov
 		}
 		if (probeResult.ok && options?.reasoning !== false && typeof desc.probeReasoning === "function") {
 			const settings = readConfig();
-			const orchestratorTarget = settings.orchestrator.target === target.id ? settings.orchestrator.model : null;
+			const orchestratorTarget = settings.chat.target === target.id ? settings.chat.model : null;
 			const candidateModelId = orchestratorTarget ?? target.defaultModel ?? null;
 			if (candidateModelId) {
 				try {
@@ -482,7 +482,7 @@ export function createProvidersBundle(context: DomainContext): DomainBundle<Prov
 			registerClioOAuthProviders();
 			registerBuiltinRuntimes(registry);
 			const settings = readConfig();
-			setGlobalDefaultMaxOutputTokens(settings.defaults.maxTokens);
+			setGlobalDefaultMaxOutputTokens(settings.chat.maxOutputTokens);
 			await loadPluginRuntimes(registry, settings);
 			await probeAll();
 			const config = context.getContract<ConfigContract>("config");

package/src/domains/providers/knowledge-base-path.ts

@@ -72,7 +72,7 @@ function envOverlayDirs(): string[] {
 		.filter((entry) => entry.length > 0);
 }
 
-export function resolveProviderModelCatalogDirs(
+function resolveProviderModelCatalogDirs(
 	importMetaUrl: string,
 	options: { cwd?: string } = {},
 ): ProviderModelCatalogDirs {

package/src/domains/providers/model-runtime-capabilities.ts

@@ -1,3 +1,4 @@
+import { warnLegacyNaming } from "../../core/naming-compat.js";
 import type { Api, Model } from "../../engine/types.js";
 import { getCatalogModelForRuntime } from "./catalog.js";
 import type { ProvidersContract, TargetStatus } from "./contract.js";
@@ -111,10 +112,19 @@ function capabilityHints(input: {
 }
 
 interface ClioRuntimeMetadata {
+	clioCoder?: {
+		targetId?: string;
+		runtimeId?: string;
+		lifecycle?: "user-managed" | "clio-coder-managed";
+		gateway?: boolean;
+		family?: string;
+		quirks?: LocalModelQuirks;
+	};
+	/** Released in-memory metadata name accepted at plugin/runtime read boundaries. */
 	clio?: {
 		targetId?: string;
 		runtimeId?: string;
-		lifecycle?: "user-managed" | "clio-managed";
+		lifecycle?: "user-managed" | "clio-coder-managed";
 		gateway?: boolean;
 		family?: string;
 		quirks?: LocalModelQuirks;
@@ -691,7 +701,9 @@ export function resolveModelRuntimeCapabilitiesForModel<TApi extends Api>(
 	model: Model<TApi>,
 	configuredThinkingLevel?: ThinkingLevel,
 ): ResolvedModelRuntimeCapabilities {
-	const metadata = (model as Model<TApi> & ClioRuntimeMetadata).clio;
+	const runtimeModel = model as Model<TApi> & ClioRuntimeMetadata;
+	if (runtimeModel.clio !== undefined) warnLegacyNaming("model.clio", "model.clioCoder");
+	const metadata = runtimeModel.clioCoder ?? runtimeModel.clio;
 	const caps = capabilitiesFromModel(model as Model<Api> & ClioRuntimeMetadata);
 	return resolveModelRuntimeCapabilities({
 		targetId: metadata?.targetId ?? null,

package/src/domains/providers/models/cloud-models/alcf.yaml

@@ -1,7 +1,7 @@
 # ALCF (Argonne) inference-gateway model knowledge base.
 #
 # GPT-OSS models served through ALCF are already covered by the existing
-# openai-gpt-oss family in local-models/clio-local-coding-targets.yaml.
+# openai-gpt-oss family in local-models/clio-coder-local-coding-targets.yaml.
 
 - family: meta-llama-4-maverick
   matchPatterns:

package/src/domains/providers/models/local-models/{clio-local-coding-targets.yaml → clio-coder-local-coding-targets.yaml}

@@ -308,7 +308,7 @@
     measuredUnder:
       hardware: unknown
       runtime: lmstudio
-      build: "unknown; the host was the operator's `dynamo` LM Studio machine, whose bundled build string was not recorded on this date"
+      build: "unknown; the host was a Windows LM Studio machine whose bundled build string was not recorded on this date"
       llamaCpp: "unknown; the measurement went through LM Studio's OpenAI-compatible port, which does not expose the underlying server argv"
       date: "2026-08-08"
       source: "commit b3db3b82 (fix(providers): thinking off reaches the wire for models that reason by default)"
@@ -884,12 +884,12 @@
     measuredUnder:
       hardware: unknown
       runtime: "lmstudio and its OpenAI-compatible port for the reasoning findings; an unrecorded llama.cpp host for the presence-penalty finding"
-      build: "unknown for both dates; the operator's `dynamo` host is a Windows LM Studio machine whose bundled build string was first recorded on 2026-08-29 as llama.cpp-win-x86_64-nvidia-cuda12-avx2, which is three weeks after the reasoning measurement and cannot be backdated to it"
+      build: "unknown for both dates; the Windows LM Studio measurement host's bundled build string was first recorded on 2026-08-29 as llama.cpp-win-x86_64-nvidia-cuda12-avx2, which is three weeks after the reasoning measurement and cannot be backdated to it"
       llamaCpp: "unknown; the reasoning measurement went through LM Studio's HTTP port, which does not expose the underlying server argv, and no argv survives for the dispatch that produced the presence-penalty value"
       date: "2026-08-08 (reasoning_effort and enable_thinking), 2026-07-06 (presence penalty)"
       source: "commits b3db3b82 and f7d76bf4"
       note: |
-        Three numbers here are measurements. On 2026-08-08 on `dynamo` this
+        Three numbers here are measurements. On 2026-08-08 on that host this
         model spent 98 of 103 completion tokens reasoning on "what is 17+25"
         with no thinking field set; chat_template_kwargs enable_thinking was
         inert, re-checked with unique prompts to rule out prompt-cache hits;
@@ -1268,7 +1268,7 @@
     maxTokens: 32768
   quirks:
     measuredUnder:
-      hardware: "unknown; the host was the operator's `dynamo` LM Studio machine"
+      hardware: "unknown; the host was a Windows LM Studio machine"
       runtime: "lmstudio, SDK 1.5.0 and its OpenAI-compatible port"
       build: "unknown; LM Studio's bundled llama.cpp build string was not recorded on this date"
       llamaCpp: "unknown; the measurement went through LM Studio, which does not expose the underlying server argv"

package/src/domains/providers/plugins.ts

@@ -4,7 +4,7 @@
  *   1. `~/.config/clio-coder/runtimes/`: any `.js` file whose default export is a valid
  *      RuntimeDescriptor. Resolved from `clioConfigDir()` so CLIO_CODER_HOME /
  *      CLIO_CODER_CONFIG_DIR overrides flow through.
- *   2. npm packages listed under `settings.runtimePlugins` (optional field).
+ *   2. npm packages listed under `settings.integrations.runtimePlugins`.
  *      Each package must export a `clioRuntimes: RuntimeDescriptor[]` array.
  *
  * Missing directories, import failures, and descriptor conflicts are logged

package/src/domains/providers/resolver.ts

@@ -117,7 +117,7 @@ function buildResult(
  *
  * Trailing `:low`/`:medium`/`:high`/`:xhigh`/`:minimal`/`:off` is parsed off
  * before matching and surfaced on the returned ref so callers can apply it
- * to settings.orchestrator.thinkingLevel.
+ * to settings.chat.thinkingLevel.
  */
 export function resolveModelReference(rawPattern: string, providers: ProvidersContract): ResolveModelResult {
 	const trimmed = rawPattern.trim();

package/src/domains/providers/runtimes/cloud/alcf.ts

@@ -35,13 +35,13 @@ const KNOWN_MODELS: string[] = [
 
 type AlcfCluster = string;
 
-export function clusterFromUrl(url: string | undefined): AlcfCluster | null {
+function clusterFromUrl(url: string | undefined): AlcfCluster | null {
 	if (!url) return null;
 	const match = /\/resource_server\/([^/]+)\//.exec(url);
 	return match ? (match[1] ?? null) : null;
 }
 
-export function frameworkForCluster(cluster: AlcfCluster): string {
+function frameworkForCluster(cluster: AlcfCluster): string {
 	return cluster === "metis" ? "api" : "vllm";
 }
 
@@ -59,7 +59,7 @@ export function catalogModels(payload: CatalogPayload, cluster: string, framewor
 	return models.map((model) => String(model).trim()).filter((model) => model.length > 0);
 }
 
-export function runningModels(payload: JobsPayload): string[] {
+function runningModels(payload: JobsPayload): string[] {
 	const out: string[] = [];
 	for (const job of payload.running ?? []) {
 		for (const raw of String(job.Models ?? "").split(",")) {
@@ -162,7 +162,7 @@ const alcfRuntime: RuntimeDescriptor = {
 			provider: "alcf",
 			baseUrlForTarget: withAsIs,
 		});
-		const meta = (model as Model<Api> & { clio?: { chatTemplateKwargsUnsupported?: boolean } }).clio;
+		const meta = (model as Model<Api> & { clioCoder?: { chatTemplateKwargsUnsupported?: boolean } }).clioCoder;
 		if (meta) meta.chatTemplateKwargsUnsupported = true;
 		return model;
 	},

package/src/domains/providers/runtimes/common/lmstudio-http.ts

@@ -169,7 +169,7 @@ function reasoningOptions(capabilities: unknown): string[] | undefined {
 	return options.length > 0 ? options : undefined;
 }
 
-export function parseLmStudioV1Models(data: unknown): LmStudioModelInfo[] | null {
+function parseLmStudioV1Models(data: unknown): LmStudioModelInfo[] | null {
 	if (!isRecord(data) || !Array.isArray(data.models)) return null;
 	const models: LmStudioModelInfo[] = [];
 	for (const raw of data.models) {
@@ -285,10 +285,6 @@ export function resolveLmStudioInstance(
 	return { requestedId, wireModelId: requestedId, peerTargets: [], state: "unknown" };
 }
 
-export function resetLmStudioHostCatalogs(): void {
-	catalogsByHost.clear();
-}
-
 export function lmStudioReasoningLevels(options: ReadonlyArray<string> | undefined): ThinkingLevel[] {
 	if (!options || options.length === 0) return [...THINKING_LEVELS];
 	if (options.includes("on") && !options.includes("low") && !options.includes("medium") && !options.includes("high")) {

package/src/domains/providers/runtimes/common/local-synth.ts

@@ -7,10 +7,10 @@ import { extractLocalModelQuirks, type LocalModelQuirks } from "../../types/loca
 import type { RuntimeApiFamily } from "../../types/runtime-descriptor.js";
 import type { TargetDescriptor } from "../../types/target-descriptor.js";
 
-export type LocalModelLifecycle = "user-managed" | "clio-managed";
+export type LocalModelLifecycle = "user-managed" | "clio-coder-managed";
 
 export interface ClioLocalModelMetadata {
-	clio?: {
+	clioCoder?: {
 		targetId: string;
 		runtimeId: string;
 		/**
@@ -101,7 +101,7 @@ export function synthLocalModel(input: LocalSynthesisInput): Model<Api> {
 		},
 		contextWindow: caps.contextWindow,
 		maxTokens: caps.maxTokens,
-		clio: {
+		clioCoder: {
 			targetId: target.id,
 			runtimeId: target.runtime,
 			...(target.lifecycle ? { lifecycle: target.lifecycle } : {}),

package/src/domains/providers/runtimes/common/probe-helpers.ts

@@ -357,7 +357,7 @@ export interface LlamaCppRequestContextWindow {
  * 25% (issue #187). With `--kv-unified` every slot shares one sequence and
  * the total is the window.
  */
-export function llamaCppRequestContextWindow(flags: LlamaCppServerFlags): LlamaCppRequestContextWindow | undefined {
+function llamaCppRequestContextWindow(flags: LlamaCppServerFlags): LlamaCppRequestContextWindow | undefined {
 	const total = positiveNumber(flags.contextSize);
 	if (total === undefined) return undefined;
 	const parallel = positiveNumber(flags.parallel);
@@ -423,7 +423,7 @@ function booleanFlag(args: ReadonlyArray<string>, ...flags: ReadonlyArray<string
 	return undefined;
 }
 
-export function parseLlamaCppServerFlags(args: ReadonlyArray<string>): LlamaCppServerFlags {
+function parseLlamaCppServerFlags(args: ReadonlyArray<string>): LlamaCppServerFlags {
 	const flags: LlamaCppServerFlags = {};
 	const ctxSize = numberFlag(args, "--ctx-size", "-c");
 	if (ctxSize !== undefined) flags.contextSize = ctxSize;

package/src/domains/providers/runtimes/local-native/llamacpp-completion.ts

@@ -100,7 +100,7 @@ async function* streamSse(body: ReadableStream<Uint8Array>): AsyncGenerator<Comp
 		}
 	} finally {
 		if (droppedFrames > 0) {
-			process.stderr.write(`[clio:llamacpp] dropped ${droppedFrames} malformed stream frame(s)\n`);
+			process.stderr.write(`[clio-coder:llamacpp] dropped ${droppedFrames} malformed stream frame(s)\n`);
 		}
 		reader.releaseLock();
 	}

package/src/domains/providers/runtimes/local-native/lmstudio.ts

@@ -13,7 +13,6 @@ import {
 	listLmStudioModels,
 	lmStudioReasoningLevels,
 	loadedContextLength,
-	parseLmStudioV1Models,
 	resolveLmStudioInstance,
 } from "../common/lmstudio-http.js";
 import { synthLocalModel, withV1 } from "../common/local-synth.js";
@@ -181,12 +180,6 @@ function probeFromCatalog(catalog: LmStudioCatalog, target: TargetDescriptor): P
 	return result;
 }
 
-export function probeResultFromV1Models(data: unknown, target: TargetDescriptor, latencyMs?: number): ProbeResult {
-	const models = parseLmStudioV1Models(data);
-	if (!models) return { ok: false, error: "LM Studio /api/v1/models response has no models array" };
-	return probeFromCatalog({ ok: true, models, tier: "0.4+", ...(latencyMs !== undefined ? { latencyMs } : {}) }, target);
-}
-
 const lmstudioRuntime: RuntimeDescriptor = {
 	id: "lmstudio",
 	aliases: ["lmstudio-native"],
@@ -224,13 +217,13 @@ const lmstudioRuntime: RuntimeDescriptor = {
 		});
 		const metadata = (
 			model as Model<Api> & {
-				clio?: {
+				clioCoder?: {
 					chatTemplateKwargsUnsupported?: boolean;
 					lmstudioReasoningOptions?: ReadonlyArray<string>;
 					lmstudioDefaultModel?: string;
 				};
 			}
-		).clio;
+		).clioCoder;
 		if (metadata) {
 			metadata.chatTemplateKwargsUnsupported = true;
 			if (target.defaultModel) metadata.lmstudioDefaultModel = target.defaultModel;

package/src/domains/providers/runtimes/protocol/litellm.ts

@@ -14,10 +14,6 @@
  * publishes the real numbers on `/v1/model/info` instead, which is what this
  * probe reads.
  *
- * Second, routed-deployment attribution. Which physical model answered is a
- * per-response fact behind an alias, and LiteLLM returns it in `x-litellm-*`
- * response headers. See {@link routedDeploymentFromHeaders}.
- *
  * Structured output is the one property worth stating explicitly, because
  * getting it wrong is silent. `src/core/response-schema.ts` deliberately keys
  * the schema dialect on runtime id and not on api family, since a generic
@@ -110,7 +106,7 @@ function boolean(value: unknown): boolean | undefined {
  * so the caller can tell "the gateway says this model has no vision" apart from
  * "the gateway did not say", and merge accordingly.
  */
-export function capabilitiesFromLiteLLMModelInfo(info: Record<string, unknown>): Partial<CapabilityFlags> {
+function capabilitiesFromLiteLLMModelInfo(info: Record<string, unknown>): Partial<CapabilityFlags> {
 	const caps: Partial<CapabilityFlags> = {};
 	const contextWindow = positiveInteger(info.max_input_tokens) ?? positiveInteger(info.max_tokens);
 	if (contextWindow !== undefined) caps.contextWindow = contextWindow;
@@ -200,92 +196,6 @@ async function fetchCatalog(base: string, ctx: ProbeContext, headers: Record<str
 	return { models, modelCapabilities: {}, modelStates: {}, deployments: {} };
 }
 
-/**
- * The routed deployment LiteLLM reports for one response.
- *
- * Behind an alias the physical model is a per-request fact: a fallback, a
- * context-window promotion, or an ordinary load-balancing choice all change it
- * without changing what the client asked for. Reporting the alias back as the
- * model is how a gateway hides an outage, and it is exactly what an operator
- * needs to see. LiteLLM answers in headers on every completion.
- */
-export interface RoutedDeployment {
-	/** The alias the client asked for, e.g. `code`. */
-	group?: string;
-	/** The physical model that answered, e.g. `openai/katcoder2.5-35b-moe`. */
-	model?: string;
-	/** The upstream that served it. */
-	apiBase?: string;
-	/** Stable id of the specific deployment inside the group. */
-	deploymentId?: string;
-	/** Non-zero when the request did not reach its first-choice deployment. */
-	attemptedFallbacks?: number;
-	attemptedRetries?: number;
-}
-
-function headerValue(headers: { get(name: string): string | null }, name: string): string | undefined {
-	const raw = headers.get(name)?.trim();
-	return raw && raw.length > 0 ? raw : undefined;
-}
-
-function headerInteger(headers: { get(name: string): string | null }, name: string): number | undefined {
-	const raw = headerValue(headers, name);
-	if (raw === undefined) return undefined;
-	const parsed = Number.parseInt(raw, 10);
-	return Number.isFinite(parsed) ? parsed : undefined;
-}
-
-/**
- * Extract the routed deployment from a LiteLLM response, or null when the
- * headers are absent. Absent is the normal answer for every non-LiteLLM target,
- * so callers treat null as "no attribution available" rather than an error.
- */
-export function routedDeploymentFromHeaders(headers: { get(name: string): string | null }): RoutedDeployment | null {
-	const routed: RoutedDeployment = {};
-	const group = headerValue(headers, "x-litellm-model-group");
-	if (group !== undefined) routed.group = group;
-	const model = headerValue(headers, "x-litellm-model-name");
-	if (model !== undefined) routed.model = model;
-	const apiBase = headerValue(headers, "x-litellm-model-api-base");
-	if (apiBase !== undefined) routed.apiBase = apiBase;
-	const deploymentId = headerValue(headers, "x-litellm-model-id");
-	if (deploymentId !== undefined) routed.deploymentId = deploymentId;
-	const fallbacks = headerInteger(headers, "x-litellm-attempted-fallbacks");
-	if (fallbacks !== undefined) routed.attemptedFallbacks = fallbacks;
-	const retries = headerInteger(headers, "x-litellm-attempted-retries");
-	if (retries !== undefined) routed.attemptedRetries = retries;
-	return Object.keys(routed).length > 0 ? routed : null;
-}
-
-/**
- * One-line attribution for a routed response.
- *
- * A request that fell back says so. `code -> openai/qwen3.8-27b-dense @
- * mini.tail78f300.ts.net:8080 (fallback)` is the whole point of the runtime:
- * the operator asked for the coder, the coder was asleep, and something else
- * answered.
- */
-export function formatRoutedDeployment(routed: RoutedDeployment): string {
-	const parts: string[] = [];
-	if (routed.group && routed.model && routed.group !== routed.model) {
-		parts.push(`${routed.group} -> ${routed.model}`);
-	} else if (routed.model ?? routed.group) {
-		parts.push((routed.model ?? routed.group) as string);
-	}
-	if (routed.apiBase) {
-		let host = routed.apiBase;
-		try {
-			host = new URL(routed.apiBase).host;
-		} catch {
-			// A non-URL api_base is displayed verbatim.
-		}
-		parts.push(`@ ${host}`);
-	}
-	if ((routed.attemptedFallbacks ?? 0) > 0) parts.push("(fallback)");
-	else if ((routed.attemptedRetries ?? 0) > 0) parts.push("(retried)");
-	return parts.join(" ");
-}
-
 const litellmRuntime: RuntimeDescriptor = {
 	id: "litellm",
 	displayName: "LiteLLM gateway",

package/src/domains/providers/types/knowledge-base.ts

@@ -2,6 +2,7 @@ import { readdirSync, readFileSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { parse as parseYaml } from "yaml";
 
+import { warnLegacyNaming } from "../../../core/naming-compat.js";
 import type { CapabilityFlags } from "./capability-flags.js";
 
 export interface KnowledgeBaseEntry {
@@ -9,6 +10,8 @@ export interface KnowledgeBaseEntry {
 	matchPatterns: ReadonlyArray<string>;
 	capabilities: Partial<CapabilityFlags>;
 	quirks?: Record<string, unknown>;
+	/** Product-owned catalog metadata, normalized from either YAML spelling. */
+	clioCoder?: Record<string, unknown>;
 }
 
 export type MatchKind = "family" | "alias";
@@ -152,5 +155,15 @@ function normalizeEntry(raw: unknown, file: string): KnowledgeBaseEntry {
 		}
 		entry.quirks = candidate.quirks as Record<string, unknown>;
 	}
+	const canonicalMetadata = candidate["clio-coder"];
+	const legacyMetadata = candidate.clio;
+	if (legacyMetadata !== undefined) warnLegacyNaming("clio: model metadata", "clio-coder: model metadata");
+	const metadata = canonicalMetadata ?? legacyMetadata;
+	if (metadata !== undefined) {
+		if (typeof metadata !== "object" || metadata === null || Array.isArray(metadata)) {
+			throw new Error(`knowledge base file ${file}: entry '${family}' clio-coder metadata must be an object`);
+		}
+		entry.clioCoder = metadata as Record<string, unknown>;
+	}
 	return entry;
 }

package/src/domains/providers/types/local-model-quirks.ts

@@ -3,7 +3,7 @@
  * keeps free-form `quirks` (gpu tiers, runtime preferences, serving notes), so
  * `KnowledgeBaseEntry.quirks` stays `Record<string, unknown>`. This module
  * narrows the slice the engine consumes (KV cache layout, per-mode sampling)
- * into a typed shape that flows through `model.clio.quirks` at synth time.
+ * into a typed shape that flows through `model.clioCoder.quirks` at synth time.
  *
  * Field naming follows the Hugging Face / model-card terminology so the YAML
  * can be authored against the source-of-truth card. The OpenAI adapter
@@ -201,7 +201,7 @@ function extractThinkingQuirks(raw: unknown): ThinkingQuirks | undefined {
 /**
  * Pull the engine-visible quirks slice out of a free-form catalog quirks
  * record. Returns `undefined` when nothing engine-relevant is configured so
- * `model.clio.quirks` only gets attached when it carries information.
+ * `model.clioCoder.quirks` only gets attached when it carries information.
  */
 export function extractLocalModelQuirks(raw: unknown): LocalModelQuirks | undefined {
 	if (!isRecord(raw)) return undefined;

package/src/domains/providers/types/target-descriptor.ts

@@ -14,9 +14,9 @@ export interface TargetPricing {
 	cacheWrite?: number;
 }
 
-// "clio-managed" is a settings.yaml enum value, not an artifact name; it stays
-// unrenamed by rebrand decision so existing `lifecycle:` lines keep working.
-export type TargetLifecycle = "user-managed" | "clio-managed";
+// Canonical persisted lifecycle name. Readers temporarily normalize the
+// released `clio-managed` spelling at the settings boundary.
+export type TargetLifecycle = "user-managed" | "clio-coder-managed";
 
 export interface LmStudioLoadSettings {
 	contextLength?: number;

package/src/domains/resources/extension.ts

@@ -12,7 +12,7 @@ export function createResourcesBundle(
 		...(options.cwd !== undefined ? { cwd: options.cwd } : {}),
 		...(options.reservedPromptNames !== undefined ? { reservedPromptNames: options.reservedPromptNames } : {}),
 		skills: () => ({
-			...skillOptions(config()?.get().skills.trustProjectCompatRoots === true, options),
+			...skillOptions(config()?.get().integrations.projectResources.trustProjectImports === true, options),
 		}),
 	});
 	const extension: DomainExtension = {

package/src/domains/resources/library.ts

@@ -37,7 +37,7 @@ function isRecord(value: unknown): value is Record<string, unknown> {
 }
 
 function catalogPath(): string {
-	const configured = readSettings().library.catalog;
+	const configured = readSettings().integrations.library.catalog;
 	return path.resolve(configured ?? path.join(clioConfigDir(), "library.yaml"));
 }
 
@@ -283,17 +283,17 @@ export function installLibraryPlan(plan: LibraryInstallPlan): void {
 }
 
 function confirmedRemote(): string {
-	const settings = readSettings().library;
+	const settings = readSettings().integrations.library;
 	if (!settings.remote || settings.remote !== settings.confirmedRemote) throw new Error("library_remote_unconfirmed");
 	return settings.remote;
 }
 
 export function confirmLibraryRemote(url: string): void {
-	const current = readSettings().library.remote;
+	const current = readSettings().integrations.library.remote;
 	if (current !== null && current !== url) throw new Error("library_remote_mismatch");
 	updateSettings((settings) => {
-		if (settings.library.remote === null) settings.library.remote = url;
-		settings.library.confirmedRemote = url;
+		if (settings.integrations.library.remote === null) settings.integrations.library.remote = url;
+		settings.integrations.library.confirmedRemote = url;
 	});
 }
 
@@ -307,7 +307,7 @@ export async function syncLibrary(
 	direction: "sync" | "push",
 	runner: LibraryCommandRunner = runCommandVector,
 ): Promise<void> {
-	const settings = readSettings().library;
+	const settings = readSettings().integrations.library;
 	if (!settings.sync) throw new Error("library_sync_disabled");
 	const remote = confirmedRemote();
 	const cwd = path.dirname(catalogPath());

package/src/domains/resources/prompts/loader.ts

@@ -393,7 +393,7 @@ export function expandPromptTemplateInput(input: string, templates: PromptTempla
 		};
 	}
 	if (!template.trusted) {
-		const message = `prompt template ${template.name} comes from an untrusted project root; set skills.trustProjectCompatRoots to use it`;
+		const message = `prompt template ${template.name} comes from an untrusted project root; set integrations.projectResources.trustProjectImports to use it`;
 		return {
 			expanded: false,
 			text: input,

package/src/domains/resources/skills/content-hash.ts

@@ -2,7 +2,8 @@ import { createHash } from "node:crypto";
 
 /**
  * Frontmatter keys owned by the install lifecycle, recognized both at the top
- * level (legacy flat form) and nested under the reserved `clio:` block.
+ * level (legacy flat form) and nested under the reserved `clio-coder:` or
+ * released `clio:` block.
  * Stripped before hashing so upstream and installed copies compare on
  * content, not on when or how a copy was installed. Registry identity
  * (`registry-id`, `registry-url`) is deliberately NOT here: it names which
@@ -64,7 +65,7 @@ export function frontmatterRegion(rawText: string): FrontmatterRegion | null {
 export function stripProvenanceLines(lines: ReadonlyArray<string>): string[] {
 	const kept: string[] = [];
 	let dropIndent: number | null = null;
-	let inClioBlock = false;
+	let inProductBlock = false;
 	for (const line of lines) {
 		const indent = line.length - line.trimStart().length;
 		if (dropIndent !== null && line.trim().length > 0 && indent > dropIndent) continue;
@@ -72,19 +73,19 @@ export function stripProvenanceLines(lines: ReadonlyArray<string>): string[] {
 		const keyMatch = line.match(/^([ \t]*)([A-Za-z][A-Za-z0-9-]*):/);
 		const key = keyMatch?.[2];
 		if (key !== undefined) {
-			if (indent === 0) inClioBlock = key === "clio";
-			if (PROVENANCE_KEYS.has(key) && (indent === 0 || inClioBlock)) {
+			if (indent === 0) inProductBlock = key === "clio-coder" || key === "clio";
+			if (PROVENANCE_KEYS.has(key) && (indent === 0 || inProductBlock)) {
 				dropIndent = indent;
 				continue;
 			}
 		}
 		kept.push(line);
 	}
-	// A `clio:` mapping whose children were all lifecycle keys is now empty;
+	// A product mapping whose children were all lifecycle keys is now empty;
 	// keep it and a source that never had the block reads as drifted from its
 	// own installed copy. Drop the dangling key line.
 	return kept.filter((line, index) => {
-		if (!/^clio:\s*$/.test(line)) return true;
+		if (!/^(?:clio-coder|clio):\s*$/.test(line)) return true;
 		for (let next = index + 1; next < kept.length; next += 1) {
 			const candidate = kept[next] as string;
 			if (candidate.trim().length === 0) continue;