@mrclrchtr/supi-code-intelligence 4.7.0 → 4.8.0

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,75 +0,0 @@
-{
-  "name": "@mrclrchtr/supi-core",
-  "version": "4.7.0",
-  "description": "Shared settings, configuration, reporting, and session infrastructure",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mrclrchtr/supi.git",
-    "directory": "packages/supi-core"
-  },
-  "homepage": "https://github.com/mrclrchtr/supi/tree/main/packages/supi-core#readme",
-  "bugs": {
-    "url": "https://github.com/mrclrchtr/supi/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "pi",
-    "pi-coding-agent",
-    "supi",
-    "extension-utils",
-    "settings",
-    "configuration"
-  ],
-  "type": "module",
-  "files": [
-    "src/**/*.ts",
-    "!__tests__"
-  ],
-  "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*",
-    "typebox": "*"
-  },
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-ai": {
-      "optional": true
-    },
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    },
-    "@earendil-works/pi-tui": {
-      "optional": true
-    },
-    "typebox": {
-      "optional": true
-    }
-  },
-  "main": "src/api.ts",
-  "exports": {
-    "./api": "./src/api.ts",
-    "./config": "./src/config.ts",
-    "./context": "./src/context.ts",
-    "./debug": "./src/debug-registry.ts",
-    "./evidence-badge": "./src/evidence-badge.ts",
-    "./footer-registry": "./src/footer-registry.ts",
-    "./llm": "./src/llm.ts",
-    "./model-selection": "./src/model-selection.ts",
-    "./package.json": "./package.json",
-    "./path": "./src/path.ts",
-    "./report": "./src/report.ts",
-    "./progress-widget": "./src/progress-widget.ts",
-    "./project": "./src/project.ts",
-    "./session": "./src/session.ts",
-    "./settings": "./src/settings.ts",
-    "./settings-ui": "./src/settings-ui.ts",
-    "./spinner-frames": "./src/spinner-frames.ts",
-    "./status-spinner": "./src/status-spinner.ts",
-    "./terminal": "./src/terminal.ts",
-    "./tool-framework": "./src/tool-framework.ts",
-    "./prompt-surface": "./src/prompt-surface.ts"
-  }
-}

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/api.ts

@@ -1,42 +0,0 @@
-// supi-core — shared infrastructure for SuPi extensions.
-// Provides XML context tag wrapping, unified config system, context-message utilities,
-// settings registry for supi-wide TUI settings, and a shared tool-spec/registration framework.
-//
-// Convenience barrel — re-exports all domain entry points.
-// For lighter imports, use one of the domain subpaths directly
-// (e.g. @mrclrchtr/supi-core/config, @mrclrchtr/supi-core/context).
-
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./config.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./context.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./debug-registry.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./evidence-badge.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./footer-registry.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./llm.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./model-selection.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./path.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./project.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./report.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./session.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./settings.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./settings-ui.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./spinner-frames.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./status-spinner.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./terminal.ts";
-// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./tool-framework.ts";

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config/config.ts

@@ -1,221 +0,0 @@
-// Shared config system for SuPi extensions.
-//
-// Global config: ~/.pi/agent/supi/config.json
-// Project config: .pi/supi/config.json (relative to cwd)
-// Resolution: hardcoded defaults ← global ← project
-
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { CONFIG_DIR_NAME } from "@earendil-works/pi-coding-agent";
-
-const GLOBAL_CONFIG_DIR = `${CONFIG_DIR_NAME}/agent/supi`;
-const PROJECT_CONFIG_DIR = `${CONFIG_DIR_NAME}/supi`;
-const CONFIG_FILE = "config.json";
-
-function getGlobalConfigPath(homeDir?: string): string {
-  return path.join(homeDir ?? os.homedir(), GLOBAL_CONFIG_DIR, CONFIG_FILE);
-}
-
-function getProjectConfigPath(cwd: string): string {
-  return path.join(cwd, PROJECT_CONFIG_DIR, CONFIG_FILE);
-}
-
-/** Return the SuPi config file path for one scope. */
-export function getSupiConfigPath(
-  scope: "global" | "project",
-  cwd: string,
-  options?: SupiConfigOptions,
-): string {
-  return scope === "global" ? getGlobalConfigPath(options?.homeDir) : getProjectConfigPath(cwd);
-}
-
-export function readJsonFile(filePath: string): Record<string, unknown> | null {
-  let content: string;
-  try {
-    content = fs.readFileSync(filePath, "utf-8");
-  } catch {
-    // ENOENT or permission error — silent, file may not exist
-    return null;
-  }
-
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(content);
-  } catch {
-    // biome-ignore lint/suspicious/noConsole: deliberate config parse warning
-    console.warn(`[supi-core] Failed to parse config file, ignoring: ${filePath}`);
-    return null;
-  }
-
-  if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
-    return parsed as Record<string, unknown>;
-  }
-
-  // biome-ignore lint/suspicious/noConsole: deliberate config parse warning
-  console.warn(`[supi-core] Config file root is not an object, ignoring: ${filePath}`);
-  return null;
-}
-
-function shallowMerge<T>(base: T, ...overrides: Array<Record<string, unknown> | null>): T {
-  let result = { ...base };
-  for (const override of overrides) {
-    if (!override) continue;
-    result = { ...result, ...override };
-  }
-  return result;
-}
-
-export interface SupiConfigOptions {
-  homeDir?: string;
-}
-
-/**
- * Load and merge config for a given extension section.
- *
- * Resolution order: defaults ← global ← project
- */
-export function loadSupiConfig<T>(
-  section: string,
-  cwd: string,
-  defaults: T,
-  options?: SupiConfigOptions,
-): T {
-  const globalConfig = readJsonFile(getGlobalConfigPath(options?.homeDir));
-  const projectConfig = readJsonFile(getProjectConfigPath(cwd));
-
-  const globalSection = extractSection(globalConfig, section);
-  const projectSection = extractSection(projectConfig, section);
-
-  return shallowMerge(defaults, globalSection, projectSection);
-}
-
-/**
- * Load config for a single scope only.
- *
- * Resolution order: defaults ← selected scope
- *
- * This is useful for settings UIs that need to show the raw values stored in
- * one scope, rather than the effective merged config.
- */
-export function loadSupiConfigForScope<T>(
-  section: string,
-  cwd: string,
-  defaults: T,
-  options: { scope: "global" | "project" } & SupiConfigOptions,
-): T {
-  const config = readJsonFile(getSupiConfigPath(options.scope, cwd, { homeDir: options.homeDir }));
-
-  const scopedSection = extractSection(config, section);
-  return shallowMerge(defaults, scopedSection);
-}
-
-/** Load the raw object for one config section and one scope. */
-export function loadSupiConfigSectionForScope(
-  section: string,
-  cwd: string,
-  options: { scope: "global" | "project" } & SupiConfigOptions,
-): Record<string, unknown> | null {
-  const config = readJsonFile(getSupiConfigPath(options.scope, cwd, { homeDir: options.homeDir }));
-  return extractSection(config, section);
-}
-
-export interface SupiConfigLocation {
-  section: string;
-  scope: "global" | "project";
-  cwd: string;
-}
-
-/**
- * Write config values for a given extension section.
- */
-export function writeSupiConfig(
-  loc: SupiConfigLocation,
-  value: Record<string, unknown>,
-  options?: SupiConfigOptions,
-): void {
-  const configPath = getSupiConfigPath(loc.scope, loc.cwd, options);
-
-  const dir = path.dirname(configPath);
-  fs.mkdirSync(dir, { recursive: true });
-
-  const existing = readJsonFile(configPath) ?? {};
-  existing[loc.section] = {
-    ...((existing[loc.section] as Record<string, unknown>) ?? {}),
-    ...value,
-  };
-
-  fs.writeFileSync(configPath, `${JSON.stringify(existing, null, 2)}\n`, "utf-8");
-}
-
-/**
- * Remove a key from a config section.
- * Used by `interval default` to remove the project override.
- */
-export function removeSupiConfigKey(
-  loc: SupiConfigLocation,
-  key: string,
-  options?: SupiConfigOptions,
-): void {
-  const configPath = getSupiConfigPath(loc.scope, loc.cwd, options);
-
-  const existing = readJsonFile(configPath);
-  if (!existing) return;
-
-  const sectionData = existing[loc.section] as Record<string, unknown> | undefined;
-  if (!sectionData) return;
-
-  delete sectionData[key];
-
-  if (Object.keys(sectionData).length === 0) {
-    delete existing[loc.section];
-  }
-
-  const dir = path.dirname(configPath);
-  fs.mkdirSync(dir, { recursive: true });
-
-  const content = Object.keys(existing).length > 0 ? `${JSON.stringify(existing, null, 2)}\n` : "";
-
-  if (content) {
-    // Directory guaranteed to exist since we just read from it
-    fs.writeFileSync(configPath, content, "utf-8");
-  } else {
-    try {
-      fs.unlinkSync(configPath);
-    } catch {
-      // File may not exist
-    }
-  }
-}
-
-function extractSection(
-  config: Record<string, unknown> | null,
-  section: string,
-): Record<string, unknown> | null {
-  if (!config) return null;
-  const data = config[section];
-  if (typeof data === "object" && data !== null && !Array.isArray(data)) {
-    return data as Record<string, unknown>;
-  }
-  return null;
-}
-
-/**
- * Shorthand for {@link loadSupiConfig} that infers the return type from defaults.
- *
- * Reduces boilerplate when a package only needs the merged runtime config.
- *
- * @example
- * ```ts
- * const config = loadSectionConfig("my-ext", cwd, { enabled: true, timeout: 30 });
- * // config is typed as { enabled: boolean; timeout: number }
- * ```
- */
-export function loadSectionConfig<T extends Record<string, unknown>>(
-  section: string,
-  cwd: string,
-  defaults: T,
-  options?: SupiConfigOptions,
-): T {
-  return loadSupiConfig(section, cwd, defaults, options);
-}

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config/prompt-surface.ts

@@ -1,357 +0,0 @@
-// Configurable tool prompt-surface overrides.
-//
-// Resolution order: package defaults ← global SuPi config ← trusted project SuPi config.
-// Project overrides are trust-gated; they require PI project trust and a PI-recognized
-// trust-requiring resource (e.g. .pi/settings.json).
-
-import {
-  type ExtensionContext,
-  hasTrustRequiringProjectResources,
-} from "@earendil-works/pi-coding-agent";
-import type { SuiPiToolPromptSurface } from "../tool-framework.ts";
-import { loadSupiConfigSectionForScope, type SupiConfigOptions } from "./config.ts";
-
-// ── Public types ───────────────────────────────────────────────────────────
-
-export type ToolPromptSurfaceDiagnosticCode =
-  | "invalidPromptSurfaceConfig"
-  | "invalidPromptSurfaceField"
-  | "projectPromptSurfaceIgnored";
-
-export interface ToolPromptSurfaceDiagnostic {
-  code: ToolPromptSurfaceDiagnosticCode;
-  scope: "global" | "project";
-  section: string;
-  toolName: string;
-  message: string;
-}
-
-export interface ResolveToolPromptSurfaceOptions extends SupiConfigOptions {
-  section: string;
-  toolName: string;
-  defaults: SuiPiToolPromptSurface;
-  ctx: Pick<ExtensionContext, "cwd" | "isProjectTrusted">;
-}
-
-export interface ResolveToolPromptSurfaceResult {
-  surface: SuiPiToolPromptSurface;
-  diagnostics: ToolPromptSurfaceDiagnostic[];
-}
-
-// ── Private types ──────────────────────────────────────────────────────────
-
-type PromptSurfaceField = keyof SuiPiToolPromptSurface;
-type PromptSurfaceScope = ToolPromptSurfaceDiagnostic["scope"];
-
-const PROMPT_SURFACE_FIELDS = new Set<string>(["description", "promptSnippet", "promptGuidelines"]);
-
-const PROMPT_SURFACE_DIAGNOSTICS_KEY = Symbol.for(
-  "@mrclrchtr/supi-core/tool-prompt-surface/notified-diagnostics",
-);
-
-// ── Resolution ─────────────────────────────────────────────────────────────
-
-/** Resolve a tool's model-facing prompt surface from defaults + SuPi config overrides. */
-export function resolveToolPromptSurface(
-  options: ResolveToolPromptSurfaceOptions,
-): ResolveToolPromptSurfaceResult {
-  const diagnostics: ToolPromptSurfaceDiagnostic[] = [];
-  let surface = clonePromptSurface(options.defaults);
-
-  const globalSection = loadSupiConfigSectionForScope(options.section, options.ctx.cwd, {
-    scope: "global",
-    homeDir: options.homeDir,
-  });
-  surface = applyPromptSurfaceScope(surface, options, "global", globalSection, diagnostics);
-
-  const projectSection = loadSupiConfigSectionForScope(options.section, options.ctx.cwd, {
-    scope: "project",
-    homeDir: options.homeDir,
-  });
-  const projectPromptSurface = getPromptSurfaceConfig(projectSection, options.toolName, {
-    diagnostics,
-    options,
-    scope: "project",
-  });
-
-  if (projectPromptSurface) {
-    const hasTrustMarker = hasTrustRequiringProjectResources(options.ctx.cwd);
-    const projectTrusted = options.ctx.isProjectTrusted();
-    if (hasTrustMarker && projectTrusted) {
-      surface = applyPromptSurfaceConfig(
-        surface,
-        options.defaults,
-        projectPromptSurface,
-        options,
-        "project",
-        diagnostics,
-      );
-    } else {
-      diagnostics.push({
-        code: "projectPromptSurfaceIgnored",
-        scope: "project",
-        section: options.section,
-        toolName: options.toolName,
-        message: hasTrustMarker
-          ? `Project prompt-surface overrides for ${options.toolName} were ignored because the project is not trusted in PI.`
-          : `Project prompt-surface overrides for ${options.toolName} were ignored because ${options.ctx.cwd}/.pi/supi/config.json is not PI trust-gated. Add .pi/settings.json and trust the project to enable them.`,
-      });
-    }
-  }
-
-  return { surface, diagnostics };
-}
-
-/** Notify prompt-surface diagnostics once per session/tool/diagnostic code. */
-export function notifyToolPromptSurfaceDiagnostics(
-  ctx: Pick<ExtensionContext, "sessionManager" | "ui">,
-  diagnostics: readonly ToolPromptSurfaceDiagnostic[],
-): void {
-  const globalRecord = globalThis as Record<symbol, Set<string> | undefined>;
-  const notified = globalRecord[PROMPT_SURFACE_DIAGNOSTICS_KEY] ?? new Set<string>();
-  globalRecord[PROMPT_SURFACE_DIAGNOSTICS_KEY] = notified;
-  const sessionId = ctx.sessionManager.getSessionId();
-
-  for (const diagnostic of diagnostics) {
-    const key = `${sessionId}:${diagnostic.section}:${diagnostic.toolName}:${diagnostic.code}`;
-    if (notified.has(key)) continue;
-    notified.add(key);
-    ctx.ui.notify(diagnostic.message, "warning");
-  }
-}
-
-// ── Scope helpers ──────────────────────────────────────────────────────────
-
-// biome-ignore lint/complexity/useMaxParams: resolver dispatch with diagnostics
-function applyPromptSurfaceScope(
-  current: SuiPiToolPromptSurface,
-  options: ResolveToolPromptSurfaceOptions,
-  scope: PromptSurfaceScope,
-  sectionConfig: Record<string, unknown> | null,
-  diagnostics: ToolPromptSurfaceDiagnostic[],
-): SuiPiToolPromptSurface {
-  const promptSurface = getPromptSurfaceConfig(sectionConfig, options.toolName, {
-    diagnostics,
-    options,
-    scope,
-  });
-  if (!promptSurface) return current;
-  return applyPromptSurfaceConfig(
-    current,
-    options.defaults,
-    promptSurface,
-    options,
-    scope,
-    diagnostics,
-  );
-}
-
-// biome-ignore lint/complexity/useMaxParams: per-scope config merger with diagnostics
-function applyPromptSurfaceConfig(
-  current: SuiPiToolPromptSurface,
-  defaults: SuiPiToolPromptSurface,
-  config: Record<string, unknown>,
-  options: ResolveToolPromptSurfaceOptions,
-  scope: PromptSurfaceScope,
-  diagnostics: ToolPromptSurfaceDiagnostic[],
-): SuiPiToolPromptSurface {
-  let next = clonePromptSurface(current);
-
-  for (const field of getResetFields(config.$reset, options, scope, diagnostics)) {
-    next = { ...next, [field]: clonePromptSurfaceField(defaults[field]) };
-  }
-
-  const description = getOptionalNonEmptyString(
-    config.description,
-    "description",
-    options,
-    scope,
-    diagnostics,
-  );
-  if (description !== undefined) next.description = description;
-
-  const promptSnippet = getOptionalNonEmptyString(
-    config.promptSnippet,
-    "promptSnippet",
-    options,
-    scope,
-    diagnostics,
-  );
-  if (promptSnippet !== undefined) next.promptSnippet = promptSnippet;
-
-  const promptGuidelines = getOptionalStringArray(
-    config.promptGuidelines,
-    "promptGuidelines",
-    options,
-    scope,
-    diagnostics,
-  );
-  if (promptGuidelines !== undefined) next.promptGuidelines = promptGuidelines;
-
-  const prepend = getOptionalStringArray(
-    config.prependPromptGuidelines,
-    "prependPromptGuidelines",
-    options,
-    scope,
-    diagnostics,
-  );
-  if (prepend !== undefined) next.promptGuidelines = [...prepend, ...next.promptGuidelines];
-
-  const append = getOptionalStringArray(
-    config.appendPromptGuidelines,
-    "appendPromptGuidelines",
-    options,
-    scope,
-    diagnostics,
-  );
-  if (append !== undefined) next.promptGuidelines = [...next.promptGuidelines, ...append];
-
-  return next;
-}
-
-// ── Config extraction ──────────────────────────────────────────────────────
-
-function getPromptSurfaceConfig(
-  sectionConfig: Record<string, unknown> | null,
-  toolName: string,
-  deps: {
-    diagnostics: ToolPromptSurfaceDiagnostic[];
-    options: ResolveToolPromptSurfaceOptions;
-    scope: PromptSurfaceScope;
-  },
-): Record<string, unknown> | null {
-  if (!sectionConfig) return null;
-  if (sectionConfig.tools === undefined) return null;
-  if (!isRecord(sectionConfig.tools)) {
-    pushInvalidConfig(deps, "tools must be an object.");
-    return null;
-  }
-  const toolConfig = sectionConfig.tools[toolName];
-  if (toolConfig === undefined) return null;
-  if (!isRecord(toolConfig)) {
-    pushInvalidConfig(deps, `tools.${toolName} must be an object.`);
-    return null;
-  }
-  if (toolConfig.promptSurface === undefined) return null;
-  if (!isRecord(toolConfig.promptSurface)) {
-    pushInvalidConfig(deps, `tools.${toolName}.promptSurface must be an object.`);
-    return null;
-  }
-  return toolConfig.promptSurface;
-}
-
-// ── Field validation ───────────────────────────────────────────────────────
-
-function getResetFields(
-  value: unknown,
-  options: ResolveToolPromptSurfaceOptions,
-  scope: PromptSurfaceScope,
-  diagnostics: ToolPromptSurfaceDiagnostic[],
-): PromptSurfaceField[] {
-  if (value === undefined) return [];
-  if (!Array.isArray(value)) {
-    pushInvalidField(options, scope, diagnostics, "$reset", "must be an array.");
-    return [];
-  }
-  const fields: PromptSurfaceField[] = [];
-  for (const item of value) {
-    if (typeof item === "string" && PROMPT_SURFACE_FIELDS.has(item)) {
-      fields.push(item as PromptSurfaceField);
-    } else {
-      pushInvalidField(
-        options,
-        scope,
-        diagnostics,
-        "$reset",
-        `contains unsupported field ${JSON.stringify(item)}.`,
-      );
-    }
-  }
-  return fields;
-}
-
-// biome-ignore lint/complexity/useMaxParams: validation helper with diagnostics
-function getOptionalNonEmptyString(
-  value: unknown,
-  field: string,
-  options: ResolveToolPromptSurfaceOptions,
-  scope: PromptSurfaceScope,
-  diagnostics: ToolPromptSurfaceDiagnostic[],
-): string | undefined {
-  if (value === undefined) return undefined;
-  if (typeof value === "string" && value.length > 0) return value;
-  pushInvalidField(options, scope, diagnostics, field, "must be a non-empty string.");
-  return undefined;
-}
-
-// biome-ignore lint/complexity/useMaxParams: validation helper with diagnostics
-function getOptionalStringArray(
-  value: unknown,
-  field: string,
-  options: ResolveToolPromptSurfaceOptions,
-  scope: PromptSurfaceScope,
-  diagnostics: ToolPromptSurfaceDiagnostic[],
-): string[] | undefined {
-  if (value === undefined) return undefined;
-  if (Array.isArray(value) && value.every((item) => typeof item === "string")) {
-    return [...value];
-  }
-  pushInvalidField(options, scope, diagnostics, field, "must be an array of strings.");
-  return undefined;
-}
-
-// ── Diagnostics ────────────────────────────────────────────────────────────
-
-function pushInvalidConfig(
-  deps: {
-    diagnostics: ToolPromptSurfaceDiagnostic[];
-    options: ResolveToolPromptSurfaceOptions;
-    scope: PromptSurfaceScope;
-  },
-  detail: string,
-): void {
-  deps.diagnostics.push({
-    // biome-ignore lint/security/noSecrets: false positive on string constant
-    code: "invalidPromptSurfaceConfig",
-    scope: deps.scope,
-    section: deps.options.section,
-    toolName: deps.options.toolName,
-    message: `Invalid prompt-surface config for ${deps.options.section}.${deps.options.toolName}: ${detail}`,
-  });
-}
-
-// biome-ignore lint/complexity/useMaxParams: diagnostics utility with many fields
-function pushInvalidField(
-  options: ResolveToolPromptSurfaceOptions,
-  scope: PromptSurfaceScope,
-  diagnostics: ToolPromptSurfaceDiagnostic[],
-  field: string,
-  detail: string,
-): void {
-  diagnostics.push({
-    // biome-ignore lint/security/noSecrets: false positive on string constant
-    code: "invalidPromptSurfaceField",
-    scope,
-    section: options.section,
-    toolName: options.toolName,
-    message: `Invalid prompt-surface field ${field} for ${options.section}.${options.toolName}: ${detail}`,
-  });
-}
-
-// ── Cloning ────────────────────────────────────────────────────────────────
-
-function clonePromptSurface(surface: SuiPiToolPromptSurface): SuiPiToolPromptSurface {
-  return {
-    description: surface.description,
-    promptSnippet: surface.promptSnippet,
-    promptGuidelines: [...surface.promptGuidelines],
-  };
-}
-
-function clonePromptSurfaceField<T extends string | string[]>(value: T): T {
-  return (Array.isArray(value) ? [...value] : value) as T;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}