takomi 2.1.13 → 2.1.15

package/.pi/extensions/takomi-context-manager/model-policy-gate.ts

@@ -1,206 +1,228 @@
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import type { ContextManagerState } from "./state";
-import { recordBlocked } from "./state";
-import { resolveTakomiRoutingPolicy } from "../takomi-runtime/routing-policy";
-
-type Settings = {
-  takomi?: { modelRoutingPolicyFile?: string };
-  subagents?: { agentOverrides?: Record<string, unknown> };
-};
-
-type ModelPolicySnapshot = {
-  approvedModels: string[];
-  preferredModels: string[];
-  sourceFiles: string[];
-};
-
-function asRecord(value: unknown): Record<string, unknown> {
-  return value && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : {};
-}
-
-async function readSettings(cwd: string): Promise<Settings> {
-  try {
-    return JSON.parse(await readFile(path.resolve(cwd, ".pi/settings.json"), "utf8")) as Settings;
-  } catch {
-    return {};
-  }
-}
-
-function modelFamily(model: string): string {
-  return model.split("/").at(-1)?.toLowerCase() ?? model.toLowerCase();
-}
-
-function unique(values: string[]): string[] {
-  return [...new Set(values.filter(Boolean))];
-}
-
-function collectModelsFromSettings(settings: Settings): string[] {
-  const overrides = asRecord(settings.subagents?.agentOverrides);
-  const models: string[] = [];
-  for (const value of Object.values(overrides)) {
-    const record = asRecord(value);
-    if (typeof record.model === "string") models.push(record.model);
-    if (Array.isArray(record.fallbackModels)) {
-      for (const fallback of record.fallbackModels) if (typeof fallback === "string") models.push(fallback.split(":")[0]);
-    }
-  }
-  return models;
-}
-
-function isModelLike(value: string): boolean {
-  const lower = value.toLowerCase();
-  return /(^|\/)(gpt|claude|gemini|o[0-9]|qwen|deepseek|llama|mistral|kimi|grok|sonnet|haiku|opus|codex|mini|max)/i.test(lower)
-    || lower.includes("oauth-router/")
-    || lower.includes("openai-codex/")
-    || lower.includes("lmstudio/");
-}
-
-function collectModelsFromPolicy(text: string): string[] {
-  const explicit = (text.match(/[a-z0-9-]+\/[a-z0-9._-]+/gi) ?? []).filter(isModelLike);
-  const inferred: string[] = [];
-  if (/gpt[- ]?5\.5/i.test(text)) inferred.push("oauth-router/gpt-5.5");
-  if (/gpt[- ]?5\.4(?!\s*mini)/i.test(text)) inferred.push("oauth-router/gpt-5.4");
-  if (/gpt[- ]?5\.4\s*mini/i.test(text)) inferred.push("oauth-router/gpt-5.4-mini");
-  return unique([...explicit, ...inferred]);
-}
-
-async function loadSnapshot(cwd: string): Promise<ModelPolicySnapshot> {
-  const settings = await readSettings(cwd);
-  const settingsModels = collectModelsFromSettings(settings);
-  const resolvedPolicy = await resolveTakomiRoutingPolicy(cwd);
-  const sourceFiles = resolvedPolicy.policyPath ? [resolvedPolicy.policyPath] : [];
-  const policyModels = resolvedPolicy.text ? collectModelsFromPolicy(resolvedPolicy.text) : [];
-  const approvedModels = unique([...settingsModels, ...policyModels]);
-  return { approvedModels, preferredModels: settingsModels.length ? unique(settingsModels) : approvedModels, sourceFiles };
-}
-
-function collectRequestedModelRefs(input: unknown): Array<{ holder: Record<string, unknown>; key: string; value: string }> {
-  const refs: Array<{ holder: Record<string, unknown>; key: string; value: string }> = [];
-  function visit(value: unknown): void {
-    if (!value || typeof value !== "object") return;
-    if (Array.isArray(value)) {
-      for (const item of value) visit(item);
-      return;
-    }
-    const record = value as Record<string, unknown>;
-    for (const key of ["model", "preferredModel"]) {
-      if (typeof record[key] === "string") refs.push({ holder: record, key, value: record[key] });
-    }
-    if (Array.isArray(record.fallbackModels)) {
-      record.fallbackModels = record.fallbackModels.filter((item) => typeof item === "string");
-    }
-    for (const key of ["tasks", "chain"]) visit(record[key]);
-  }
-  visit(input);
-  return refs;
-}
-
-function approvedEquivalent(requested: string, approved: string[]): string | undefined {
-  const requestedFamily = modelFamily(requested);
-  return approved.find((candidate) => modelFamily(candidate) === requestedFamily);
-}
-
-function isModelFailure(text: string): boolean {
-  return /(unknown provider|provider.*not.*found|model.*not.*found|model.*unavailable|invalid model|unsupported model|auth|unauthorized|forbidden|rate limit|429|quota|context window|maximum context)/i.test(text);
-}
-
-function renderPolicyViolation(requested: string, approved: string[]): string {
-  return [
-    "Blocked by Takomi routing policy.",
-    "",
-    "Requested model:",
-    requested,
-    "",
-    "Allowed/preferred models include:",
-    ...(approved.length ? approved.map((model) => `- ${model}`) : ["- none discovered; run /takomi routing <policy text> first"]),
-    "",
-    "The subagent did not run. Ask the user how to proceed or retry with an approved model.",
-  ].join("\n");
-}
-
-type RecoveryChoice =
-  | { action: "retry"; model: string }
-  | { action: "stop" };
-
-async function askForInvalidModelRecovery(ctx: { ui: { select(title: string, options: string[]): Promise<string | undefined>; notify(message: string, level?: string): void }; abort?: () => void }, requested: string, approved: string[]): Promise<RecoveryChoice> {
-  if (approved.length === 0) return { action: "stop" };
-  const options = [
-    ...approved.map((model) => `Retry with ${model}`),
-    "Stop and let me send a new prompt",
-  ];
-  const choice = await ctx.ui.select(
-    `takomi_subagent requested a model outside your routing policy: ${requested}`,
-    options,
-  );
-  if (choice?.startsWith("Retry with ")) return { action: "retry", model: choice.replace("Retry with ", "") };
-  return { action: "stop" };
-}
-
-export function installModelPolicyGate(pi: ExtensionAPI, state: ContextManagerState): void {
-  pi.on("tool_call", async (event, ctx) => {
-    if (event.toolName !== "takomi_subagent") return;
-    const snapshot = await loadSnapshot(ctx.cwd);
-    const approved = snapshot.approvedModels;
-    if (approved.length === 0) return;
-
-    const refs = collectRequestedModelRefs(event.input);
-    const corrections: string[] = [];
-    for (const ref of refs) {
-      if (approved.includes(ref.value)) continue;
-      const equivalent = approvedEquivalent(ref.value, approved);
-      if (equivalent) {
-        ref.holder[ref.key] = equivalent;
-        corrections.push(`${ref.value} -> ${equivalent}`);
-        continue;
-      }
-      const recovery = await askForInvalidModelRecovery(ctx, ref.value, approved);
-      if (recovery.action === "retry") {
-        ref.holder[ref.key] = recovery.model;
-        corrections.push(`${ref.value} -> ${recovery.model} (user selected recovery)`);
-        continue;
-      }
-      const reason = [
-        renderPolicyViolation(ref.value, approved),
-        "",
-        "Human selected stop. The agent turn has been aborted; wait for the user's next prompt.",
-      ].join("\n");
-      recordBlocked(state, event.toolName, reason);
-      ctx.abort?.();
-      return { block: true, reason };
-    }
-
-    if (corrections.length > 0) {
-      ctx.ui.notify(`Takomi context manager corrected subagent model routing:\n- ${corrections.join("\n- ")}\n\nBe careful to follow /takomi routing policy next time.`, "warning");
-    }
-  });
-
-  pi.on("tool_result", async (event, ctx) => {
-    if (event.toolName !== "takomi_subagent" || !event.isError) return;
-    const content = JSON.stringify(event.content ?? "");
-    if (!isModelFailure(content)) return;
-
-    const snapshot = await loadSnapshot(ctx.cwd);
-    const options = [
-      ...snapshot.approvedModels.map((model) => `Retry with ${model}`),
-      "Stop and let me send a new prompt",
-    ];
-    const choice = await ctx.ui.select("Takomi subagent model/provider failure. How do you want to continue?", options);
-    const retryModel = choice?.startsWith("Retry with ") ? choice.replace("Retry with ", "") : undefined;
-    const stopped = !retryModel;
-    const guidance = [
-      "Takomi subagent failed with a model/provider-related error.",
-      "",
-      `Policy source: ${snapshot.sourceFiles.join(", ") || "not found"}`,
-      "Policy-approved models:",
-      ...(snapshot.approvedModels.length ? snapshot.approvedModels.map((model) => `- ${model}`) : ["- none discovered"]),
-      "",
-      stopped
-        ? "Human selected stop/no retry. The agent turn has been aborted; wait for the user's next prompt."
-        : `User selected retry with ${retryModel}. Retry takomi_subagent with model ${retryModel}.`,
-    ].join("\n");
-    if (stopped) ctx.abort?.();
-    return { content: [{ type: "text", text: guidance }], isError: true, terminate: stopped };
-  });
-}
+import { readFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ContextManagerState } from "./state";
+import { recordBlocked } from "./state";
+import { resolveTakomiRoutingPolicy } from "../takomi-runtime/routing-policy";
+
+type Settings = {
+  takomi?: { modelRoutingPolicyFile?: string };
+  subagents?: { agentOverrides?: Record<string, unknown> };
+};
+
+type ModelPolicySnapshot = {
+  approvedModels: string[];
+  preferredModels: string[];
+  sourceFiles: string[];
+};
+
+function asRecord(value: unknown): Record<string, unknown> {
+  return value && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : {};
+}
+
+async function readSettingsFile(filePath: string): Promise<Settings> {
+  try {
+    return JSON.parse(await readFile(filePath, "utf8")) as Settings;
+  } catch {
+    return {};
+  }
+}
+
+function mergeSettings(globalSettings: Settings, projectSettings: Settings): Settings {
+  const globalOverrides = asRecord(globalSettings.subagents?.agentOverrides);
+  const projectOverrides = asRecord(projectSettings.subagents?.agentOverrides);
+  return {
+    ...globalSettings,
+    ...projectSettings,
+    takomi: { ...(globalSettings.takomi ?? {}), ...(projectSettings.takomi ?? {}) },
+    subagents: {
+      ...(globalSettings.subagents ?? {}),
+      ...(projectSettings.subagents ?? {}),
+      agentOverrides: { ...globalOverrides, ...projectOverrides },
+    },
+  };
+}
+
+async function readSettings(cwd: string): Promise<Settings> {
+  const globalSettings = await readSettingsFile(path.join(os.homedir(), ".pi", "agent", "settings.json"));
+  const projectSettings = await readSettingsFile(path.resolve(cwd, ".pi/settings.json"));
+  return mergeSettings(globalSettings, projectSettings);
+}
+
+function modelFamily(model: string): string {
+  return model.split("/").at(-1)?.toLowerCase() ?? model.toLowerCase();
+}
+
+function unique(values: string[]): string[] {
+  return [...new Set(values.filter(Boolean))];
+}
+
+function collectModelsFromSettings(settings: Settings): string[] {
+  const overrides = asRecord(settings.subagents?.agentOverrides);
+  const models: string[] = [];
+  for (const value of Object.values(overrides)) {
+    const record = asRecord(value);
+    if (typeof record.model === "string") models.push(record.model);
+    if (Array.isArray(record.fallbackModels)) {
+      for (const fallback of record.fallbackModels) if (typeof fallback === "string") models.push(fallback.split(":")[0]);
+    }
+  }
+  return models;
+}
+
+function isModelLike(value: string): boolean {
+  const lower = value.toLowerCase();
+  return /(^|\/)(gpt|claude|gemini|o[0-9]|qwen|deepseek|llama|mistral|kimi|grok|sonnet|haiku|opus|codex|mini|max)/i.test(lower)
+    || lower.includes("oauth-router/")
+    || lower.includes("openai-codex/")
+    || lower.includes("lmstudio/");
+}
+
+function collectModelsFromPolicy(text: string): string[] {
+  const explicit = (text.match(/[a-z0-9-]+\/[a-z0-9._-]+/gi) ?? []).filter(isModelLike);
+  const inferred: string[] = [];
+  if (/gpt[- ]?5\.5/i.test(text)) inferred.push("oauth-router/gpt-5.5");
+  if (/gpt[- ]?5\.4(?!\s*mini)/i.test(text)) inferred.push("oauth-router/gpt-5.4");
+  if (/gpt[- ]?5\.4\s*mini/i.test(text)) inferred.push("oauth-router/gpt-5.4-mini");
+  return unique([...explicit, ...inferred]);
+}
+
+async function loadSnapshot(cwd: string): Promise<ModelPolicySnapshot> {
+  const settings = await readSettings(cwd);
+  const settingsModels = collectModelsFromSettings(settings);
+  const resolvedPolicy = await resolveTakomiRoutingPolicy(cwd);
+  const sourceFiles = resolvedPolicy.policyPath ? [resolvedPolicy.policyPath] : [];
+  const policyModels = resolvedPolicy.text ? collectModelsFromPolicy(resolvedPolicy.text) : [];
+  const approvedModels = unique([...settingsModels, ...policyModels]);
+  return { approvedModels, preferredModels: settingsModels.length ? unique(settingsModels) : approvedModels, sourceFiles };
+}
+
+function collectRequestedModelRefs(input: unknown): Array<{ holder: Record<string, unknown>; key: string; value: string }> {
+  const refs: Array<{ holder: Record<string, unknown>; key: string; value: string }> = [];
+  function visit(value: unknown): void {
+    if (!value || typeof value !== "object") return;
+    if (Array.isArray(value)) {
+      for (const item of value) visit(item);
+      return;
+    }
+    const record = value as Record<string, unknown>;
+    for (const key of ["model", "preferredModel"]) {
+      if (typeof record[key] === "string") refs.push({ holder: record, key, value: record[key] });
+    }
+    if (Array.isArray(record.fallbackModels)) {
+      record.fallbackModels = record.fallbackModels.filter((item) => typeof item === "string");
+    }
+    for (const key of ["tasks", "chain"]) visit(record[key]);
+  }
+  visit(input);
+  return refs;
+}
+
+function approvedEquivalent(requested: string, approved: string[]): string | undefined {
+  const requestedFamily = modelFamily(requested);
+  return approved.find((candidate) => modelFamily(candidate) === requestedFamily);
+}
+
+function isModelFailure(text: string): boolean {
+  return /(unknown provider|provider.*not.*found|model.*not.*found|model.*unavailable|invalid model|unsupported model|auth|unauthorized|forbidden|rate limit|429|quota|context window|maximum context)/i.test(text);
+}
+
+function renderPolicyViolation(requested: string, approved: string[]): string {
+  return [
+    "Blocked by Takomi routing policy.",
+    "",
+    "Requested model:",
+    requested,
+    "",
+    "Allowed/preferred models include:",
+    ...(approved.length ? approved.map((model) => `- ${model}`) : ["- none discovered; run /takomi routing <policy text> first"]),
+    "",
+    "The subagent did not run. Ask the user how to proceed or retry with an approved model.",
+  ].join("\n");
+}
+
+type RecoveryChoice =
+  | { action: "retry"; model: string }
+  | { action: "stop" };
+
+async function askForInvalidModelRecovery(ctx: { ui: { select(title: string, options: string[]): Promise<string | undefined>; notify(message: string, level?: string): void }; abort?: () => void }, requested: string, approved: string[]): Promise<RecoveryChoice> {
+  if (approved.length === 0) return { action: "stop" };
+  const options = [
+    ...approved.map((model) => `Retry with ${model}`),
+    "Stop and let me send a new prompt",
+  ];
+  const choice = await ctx.ui.select(
+    `takomi_subagent requested a model outside your routing policy: ${requested}`,
+    options,
+  );
+  if (choice?.startsWith("Retry with ")) return { action: "retry", model: choice.replace("Retry with ", "") };
+  return { action: "stop" };
+}
+
+export function installModelPolicyGate(pi: ExtensionAPI, state: ContextManagerState): void {
+  pi.on("tool_call", async (event, ctx) => {
+    if (event.toolName !== "takomi_subagent") return;
+    const snapshot = await loadSnapshot(ctx.cwd);
+    const approved = snapshot.approvedModels;
+    if (approved.length === 0) return;
+
+    const refs = collectRequestedModelRefs(event.input);
+    const corrections: string[] = [];
+    for (const ref of refs) {
+      if (approved.includes(ref.value)) continue;
+      const equivalent = approvedEquivalent(ref.value, approved);
+      if (equivalent) {
+        ref.holder[ref.key] = equivalent;
+        corrections.push(`${ref.value} -> ${equivalent}`);
+        continue;
+      }
+      const recovery = await askForInvalidModelRecovery(ctx, ref.value, approved);
+      if (recovery.action === "retry") {
+        ref.holder[ref.key] = recovery.model;
+        corrections.push(`${ref.value} -> ${recovery.model} (user selected recovery)`);
+        continue;
+      }
+      const reason = [
+        renderPolicyViolation(ref.value, approved),
+        "",
+        "Human selected stop. The agent turn has been aborted; wait for the user's next prompt.",
+      ].join("\n");
+      recordBlocked(state, event.toolName, reason);
+      ctx.abort?.();
+      return { block: true, reason };
+    }
+
+    if (corrections.length > 0) {
+      ctx.ui.notify(`Takomi context manager corrected subagent model routing:\n- ${corrections.join("\n- ")}\n\nBe careful to follow /takomi routing policy next time.`, "warning");
+    }
+  });
+
+  pi.on("tool_result", async (event, ctx) => {
+    if (event.toolName !== "takomi_subagent" || !event.isError) return;
+    const content = JSON.stringify(event.content ?? "");
+    if (!isModelFailure(content)) return;
+
+    const snapshot = await loadSnapshot(ctx.cwd);
+    const options = [
+      ...snapshot.approvedModels.map((model) => `Retry with ${model}`),
+      "Stop and let me send a new prompt",
+    ];
+    const choice = await ctx.ui.select("Takomi subagent model/provider failure. How do you want to continue?", options);
+    const retryModel = choice?.startsWith("Retry with ") ? choice.replace("Retry with ", "") : undefined;
+    const stopped = !retryModel;
+    const guidance = [
+      "Takomi subagent failed with a model/provider-related error.",
+      "",
+      `Policy source: ${snapshot.sourceFiles.join(", ") || "not found"}`,
+      "Policy-approved models:",
+      ...(snapshot.approvedModels.length ? snapshot.approvedModels.map((model) => `- ${model}`) : ["- none discovered"]),
+      "",
+      stopped
+        ? "Human selected stop/no retry. The agent turn has been aborted; wait for the user's next prompt."
+        : `User selected retry with ${retryModel}. Retry takomi_subagent with model ${retryModel}.`,
+    ].join("\n");
+    if (stopped) ctx.abort?.();
+    return { content: [{ type: "text", text: guidance }], isError: true, terminate: stopped };
+  });
+}

package/.pi/extensions/takomi-context-manager/policy-registry.ts

@@ -1,97 +1,97 @@
-import { readdir, readFile } from "node:fs/promises";
-import path from "node:path";
-import type { ContextManagerConfig, PolicyPack } from "./types";
-import { normalizeName } from "./skill-registry";
-import { resolveTakomiRoutingPolicy } from "../takomi-runtime/routing-policy";
-
-function descriptionFromMarkdown(content: string): string {
-  const lines = content.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
-  const firstBody = lines.find((line) => !line.startsWith("#"));
-  return firstBody?.slice(0, 240) ?? "Policy pack";
-}
-
-async function readPolicyFile(name: string, filePath: string): Promise<PolicyPack | undefined> {
-  try {
-    const content = await readFile(filePath, "utf8");
-    return {
-      name,
-      description: descriptionFromMarkdown(content),
-      content,
-      path: filePath,
-    };
-  } catch {
-    return undefined;
-  }
-}
-
-function addPolicy(policies: Map<string, PolicyPack>, policy: PolicyPack | undefined, override = false): void {
-  if (!policy) return;
-  const key = normalizeName(policy.name);
-  if (!override && policies.has(key)) return;
-  policies.set(key, policy);
-}
-
-async function discoverResolvedModelRoutingPolicy(cwd: string): Promise<PolicyPack | undefined> {
-  const resolved = await resolveTakomiRoutingPolicy(cwd);
-  if (!resolved.text) return undefined;
-  return {
-    name: "model-routing",
-    description: descriptionFromMarkdown(resolved.text),
-    content: resolved.text,
-    path: resolved.policyPath,
-  };
-}
-
-async function discoverExplicitPolicyFiles(cwd: string, config: ContextManagerConfig): Promise<PolicyPack[]> {
-  const entries = Object.entries(config.policyFiles ?? {});
-  const policies = await Promise.all(entries.map(([name, filePath]) => readPolicyFile(name, path.resolve(cwd, filePath))));
-  return policies.filter((policy): policy is PolicyPack => Boolean(policy));
-}
-
-export async function discoverPolicies(cwd: string, config: ContextManagerConfig): Promise<Map<string, PolicyPack>> {
-  const policies = new Map<string, PolicyPack>();
-
-  // Source-of-truth priority 1: explicit context-manager policy file mappings.
-  for (const policy of await discoverExplicitPolicyFiles(cwd, config)) {
-    addPolicy(policies, policy, true);
-  }
-
-  // Source-of-truth priority 2: Takomi routing policy resolved from project settings or the bundled harness default.
-  addPolicy(policies, await discoverResolvedModelRoutingPolicy(cwd), true);
-
-  // Source-of-truth priority 3: discovered markdown policy packs. These are supplemental/default packs.
-  for (const policyPath of config.policyPaths) {
-    const absolute = path.resolve(cwd, policyPath);
-    try {
-      const entries = await readdir(absolute, { withFileTypes: true });
-      for (const entry of entries) {
-        if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
-        const name = path.basename(entry.name, ".md");
-        addPolicy(policies, await readPolicyFile(name, path.join(absolute, entry.name)), false);
-      }
-    } catch {
-      // Optional policy directories may not exist.
-    }
-  }
-
-  return policies;
-}
-
-export function renderPolicyManifest(policies: Map<string, PolicyPack>, names: string[]): string {
-  const selected = names.length > 0 ? names : [...policies.keys()];
-  return selected.map((name) => {
-    const policy = policies.get(normalizeName(name));
-    if (!policy) return `Policy not found: ${name}`;
-    return [`Policy: ${policy.name}`, `Description: ${policy.description}`, `Location: ${policy.path ?? "(generated/default)"}`].join("\n");
-  }).join("\n\n");
-}
-
-export function renderPolicies(policies: Map<string, PolicyPack>, loaded: Set<string>, names: string[]): string {
-  if (names.length === 0) return "No policies requested.";
-  return names.map((name) => {
-    const policy = policies.get(normalizeName(name));
-    if (!policy) return `Policy not found: ${name}`;
-    loaded.add(policy.name);
-    return [`Policy: ${policy.name}`, `Description: ${policy.description}`, `Location: ${policy.path ?? "(generated/default)"}`, "", policy.content].join("\n");
-  }).join("\n\n---\n\n");
-}
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import type { ContextManagerConfig, PolicyPack } from "./types";
+import { normalizeName } from "./skill-registry";
+import { resolveTakomiRoutingPolicy } from "../takomi-runtime/routing-policy";
+
+function descriptionFromMarkdown(content: string): string {
+  const lines = content.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+  const firstBody = lines.find((line) => !line.startsWith("#"));
+  return firstBody?.slice(0, 240) ?? "Policy pack";
+}
+
+async function readPolicyFile(name: string, filePath: string): Promise<PolicyPack | undefined> {
+  try {
+    const content = await readFile(filePath, "utf8");
+    return {
+      name,
+      description: descriptionFromMarkdown(content),
+      content,
+      path: filePath,
+    };
+  } catch {
+    return undefined;
+  }
+}
+
+function addPolicy(policies: Map<string, PolicyPack>, policy: PolicyPack | undefined, override = false): void {
+  if (!policy) return;
+  const key = normalizeName(policy.name);
+  if (!override && policies.has(key)) return;
+  policies.set(key, policy);
+}
+
+async function discoverResolvedModelRoutingPolicy(cwd: string): Promise<PolicyPack | undefined> {
+  const resolved = await resolveTakomiRoutingPolicy(cwd);
+  if (!resolved.text) return undefined;
+  return {
+    name: "model-routing",
+    description: descriptionFromMarkdown(resolved.text),
+    content: resolved.text,
+    path: resolved.policyPath,
+  };
+}
+
+async function discoverExplicitPolicyFiles(cwd: string, config: ContextManagerConfig): Promise<PolicyPack[]> {
+  const entries = Object.entries(config.policyFiles ?? {});
+  const policies = await Promise.all(entries.map(([name, filePath]) => readPolicyFile(name, path.resolve(cwd, filePath))));
+  return policies.filter((policy): policy is PolicyPack => Boolean(policy));
+}
+
+export async function discoverPolicies(cwd: string, config: ContextManagerConfig): Promise<Map<string, PolicyPack>> {
+  const policies = new Map<string, PolicyPack>();
+
+  // Source-of-truth priority 1: explicit context-manager policy file mappings.
+  for (const policy of await discoverExplicitPolicyFiles(cwd, config)) {
+    addPolicy(policies, policy, true);
+  }
+
+  // Source-of-truth priority 2: Takomi routing policy resolved from project settings or the bundled harness default.
+  addPolicy(policies, await discoverResolvedModelRoutingPolicy(cwd), true);
+
+  // Source-of-truth priority 3: discovered markdown policy packs. These are supplemental/default packs.
+  for (const policyPath of config.policyPaths) {
+    const absolute = path.resolve(cwd, policyPath);
+    try {
+      const entries = await readdir(absolute, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
+        const name = path.basename(entry.name, ".md");
+        addPolicy(policies, await readPolicyFile(name, path.join(absolute, entry.name)), false);
+      }
+    } catch {
+      // Optional policy directories may not exist.
+    }
+  }
+
+  return policies;
+}
+
+export function renderPolicyManifest(policies: Map<string, PolicyPack>, names: string[]): string {
+  const selected = names.length > 0 ? names : [...policies.keys()];
+  return selected.map((name) => {
+    const policy = policies.get(normalizeName(name));
+    if (!policy) return `Policy not found: ${name}`;
+    return [`Policy: ${policy.name}`, `Description: ${policy.description}`, `Location: ${policy.path ?? "(generated/default)"}`].join("\n");
+  }).join("\n\n");
+}
+
+export function renderPolicies(policies: Map<string, PolicyPack>, loaded: Set<string>, names: string[]): string {
+  if (names.length === 0) return "No policies requested.";
+  return names.map((name) => {
+    const policy = policies.get(normalizeName(name));
+    if (!policy) return `Policy not found: ${name}`;
+    loaded.add(policy.name);
+    return [`Policy: ${policy.name}`, `Description: ${policy.description}`, `Location: ${policy.path ?? "(generated/default)"}`, "", policy.content].join("\n");
+  }).join("\n\n---\n\n");
+}