@mrclrchtr/supi-code-intelligence 4.7.0 → 4.8.0

package/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);
-}

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

@@ -1,11 +0,0 @@
-// supi-core config domain — config loading.
-export type { SupiConfigLocation, SupiConfigOptions } from "./config/config.ts";
-export {
-  loadSectionConfig,
-  loadSupiConfig,
-  loadSupiConfigForScope,
-  loadSupiConfigSectionForScope,
-  readJsonFile,
-  removeSupiConfigKey,
-  writeSupiConfig,
-} from "./config/config.ts";

package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/context/context-messages.ts

@@ -1,119 +0,0 @@
-// Shared context-message utilities for SuPi extensions.
-//
-// Provides a generic prune-and-reorder pattern for extensions that inject
-// managed context messages (via `before_agent_start` with a `customType` and
-// `contextToken`) and maintain them via the `context` event.
-
-/**
- * Minimal message shape needed for context-message operations.
- * Extensions cast their event.messages entries to this type.
- */
-export type ContextMessageLike = {
-  role?: string;
-  customType?: string;
-  content?: unknown;
-  details?: unknown;
-};
-
-/**
- * Extract the `contextToken` string from a message's `details` object.
- * Returns `null` when the token is absent or not a string.
- */
-export function getContextToken(details: unknown): string | null {
-  if (!details || typeof details !== "object") return null;
-  const token = (details as { contextToken?: unknown }).contextToken;
-  return typeof token === "string" ? token : null;
-}
-
-/**
- * Find the index of the last message with `role: "user"`.
- * Returns `-1` when no user message exists.
- */
-export function findLastUserMessageIndex<T extends ContextMessageLike>(messages: T[]): number {
-  for (let index = messages.length - 1; index >= 0; index--) {
-    if (messages[index]?.role === "user") return index;
-  }
-  return -1;
-}
-
-/**
- * Filter stale context messages and reorder the active one before the last user message.
- *
- * - Removes all messages matching `customType` whose token differs from `activeToken`.
- * - When `activeToken` is `null`, removes **all** messages of that `customType`.
- * - If the active context message is after the last user message, moves it before.
- *
- * Returns the modified array, or the original reference when no changes were needed.
- */
-export function pruneAndReorderContextMessages<T extends ContextMessageLike>(
-  messages: T[],
-  customType: string,
-  activeToken: string | null,
-): T[] {
-  // Remove stale messages of the target customType
-  const filtered = messages.filter((message) => {
-    if (message.customType !== customType) return true;
-    if (!activeToken) return false;
-    return getContextToken(message.details) === activeToken;
-  });
-
-  if (!activeToken) return filtered;
-
-  // Find the active context message
-  const contextIndex = filtered.findIndex(
-    (message) =>
-      message.customType === customType && getContextToken(message.details) === activeToken,
-  );
-  if (contextIndex === -1) return filtered;
-
-  // Find the last user message
-  const userIndex = findLastUserMessageIndex(filtered);
-  if (userIndex === -1 || contextIndex < userIndex) return filtered;
-
-  // Move context message before last user message
-  const next = [...filtered];
-  const [contextMessage] = next.splice(contextIndex, 1);
-  if (!contextMessage) return filtered;
-  next.splice(userIndex, 0, contextMessage);
-  return next;
-}
-
-/**
- * Restore the raw prompt content on a context message that was swapped for display text.
- *
- * Extensions using `registerMessageRenderer` store their LLM-facing content in
- * `details.promptContent` and put a human-readable summary in `content`. This function
- * reverses the swap so the model sees the original prompt content.
- *
- * Returns the original array reference when no change is needed.
- */
-export function restorePromptContent<T extends ContextMessageLike>(
-  messages: T[],
-  customType: string,
-  activeToken: string | null,
-): T[] {
-  if (!activeToken) return messages;
-
-  const index = messages.findIndex(
-    (message) =>
-      message.customType === customType && getContextToken(message.details) === activeToken,
-  );
-  if (index === -1) return messages;
-
-  const promptContent = getPromptContent(messages[index]?.details);
-  if (!promptContent || messages[index]?.content === promptContent) return messages;
-
-  const next = [...messages];
-  next[index] = { ...next[index], content: promptContent };
-  return next;
-}
-
-/**
- * Extract the `promptContent` string from a message's `details` object.
- * Returns `null` when absent or not a string.
- */
-export function getPromptContent(details: unknown): string | null {
-  if (!details || typeof details !== "object") return null;
-  const promptContent = (details as { promptContent?: unknown }).promptContent;
-  return typeof promptContent === "string" ? promptContent : null;
-}

package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/context/context-provider-registry.ts

@@ -1,36 +0,0 @@
-// Context provider registry for SuPi extensions.
-//
-// Extensions declare context data providers via `registerContextProvider()` during their
-// factory function. The `/supi-context` command reads them via `getRegisteredContextProviders()`.
-
-import { createRegistry } from "../registry-utils.ts";
-
-export interface ContextProvider {
-  /** Unique identifier — e.g. "lsp" */
-  id: string;
-  /** Human-readable label shown in the report */
-  label: string;
-  /** Return structured data for display, or null when unavailable. */
-  getData: () => Record<string, string | number> | null;
-}
-
-const registry = createRegistry<ContextProvider>("context-provider-registry");
-
-/**
- * Register a context data provider for an extension.
- * Call during the extension factory function (not async handlers).
- * Duplicate ids replace the previous registration.
- */
-export function registerContextProvider(provider: ContextProvider): void {
-  registry.register(provider.id, provider);
-}
-
-/** Get all registered context providers in registration order. */
-export function getRegisteredContextProviders(): ContextProvider[] {
-  return registry.getAll();
-}
-
-/** Clear the registry — used by tests. */
-export function clearRegisteredContextProviders(): void {
-  registry.clear();
-}

package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts

@@ -1,31 +0,0 @@
-// XML context tag wrapping for SuPi extensions.
-//
-// Produces machine-parseable <extension-context> blocks that:
-// - Are LLM-friendly (structured XML)
-// - Carry metadata via attributes (source, file, turn, etc.)
-// - Can be reconstructed from session history via regex
-
-/**
- * Wrap content in an `<extension-context>` XML tag.
- *
- * @param source - Extension identifier (e.g. "supi-claude-md", "supi-lsp")
- * @param content - The text content to wrap
- * @param attrs - Optional additional attributes (rendered as key="value")
- * @returns Formatted XML string
- */
-export function wrapExtensionContext(
-  source: string,
-  content: string,
-  attrs?: Record<string, string | number>,
-): string {
-  const attrParts = [`source="${source}"`];
-
-  if (attrs) {
-    for (const [key, value] of Object.entries(attrs)) {
-      attrParts.push(`${key}="${String(value)}"`);
-    }
-  }
-
-  const openTag = `<extension-context ${attrParts.join(" ")}>`;
-  return `${openTag}\n${content}\n</extension-context>`;
-}

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

@@ -1,16 +0,0 @@
-// supi-core context domain — context messages, providers, and XML tags.
-export type { ContextMessageLike } from "./context/context-messages.ts";
-export {
-  findLastUserMessageIndex,
-  getContextToken,
-  getPromptContent,
-  pruneAndReorderContextMessages,
-  restorePromptContent,
-} from "./context/context-messages.ts";
-export type { ContextProvider } from "./context/context-provider-registry.ts";
-export {
-  clearRegisteredContextProviders,
-  getRegisteredContextProviders,
-  registerContextProvider,
-} from "./context/context-provider-registry.ts";
-export { wrapExtensionContext } from "./context/context-tag.ts";