@mrclrchtr/supi-code-intelligence 6.2.0 → 6.4.0

package/src/tool/code_refactor_apply/guidance.ts

@@ -1,5 +1,5 @@
 export const toolDescription =
-  "Apply one fresh stored refactor plan by planId after safety checks; mutates its files.";
+  "Apply a fresh stored refactor plan to change its files. It does not create or regenerate a plan.";
 
 export const promptSnippet = "apply a stored refactor plan";
 

package/src/tool/code_refactor_plan/guidance.ts

@@ -1,8 +1,6 @@
 export const toolDescription =
-  "Preview one semantic rename, extraction, import cleanup, or dead-code deletion and return a planId without mutating files.";
+  "Preview a semantic refactor without changing files or falling back to text edits.";
 
-export const promptSnippet = "preview a precise semantic refactor";
+export const promptSnippet = "preview a semantic refactor";
 
-export const promptGuidelines = [
-  "Use code_refactor_plan for preview only, then call code_refactor_apply with its planId.",
-];
+export const promptGuidelines: string[] = [];

package/src/tool/code_resolve/guidance.ts

@@ -1,8 +1,8 @@
 export const toolDescription =
-  "Resolve one provider-backed anchor or semantic symbol query to session handles, or enumerate a file's declarations as a bounded Target group. Anchors must identify real symbols";
+  "Resolve a real symbol anchor or semantic query to target handles, or list a file's declarations as a target group. Symbol lookup does not fall back to text search.";
 
-export const promptSnippet = "resolve a precise target or enumerate a file’s target group";
+export const promptSnippet = "resolve symbols or file declarations";
 
 export const promptGuidelines = [
-  "Use code_resolve when a symbol query may be ambiguous, when later calls should share a stable target handle, or when a known file’s declarations should be enumerated.",
+  "Use code_resolve when a symbol query can match multiple symbols or when a later tool requires a target handle.",
 ];

package/src/tool/guidance.ts

@@ -1,10 +1,8 @@
-// Model-facing prompt surfaces for the eight public code-intelligence tools.
-//
-// Ownership map (docs/pi/tool-guidance.md): each model-facing fact lives in
-// exactly one home — the per-tool guidance module. This aggregator assembles
-// the canonical surface map consumed by registration.
-// Parameter mechanics (formats, enum semantics, cross-field rules) live in
-// schemas.ts / per-tool spec.ts and are not repeated here.
+/**
+ * Each tool owns its model-facing text. This module assembles the canonical
+ * surface map used by registration. Parameter mechanics stay in specs and
+ * shared schemas.
+ */
 
 import type { CodeIntelligenceToolName } from "../types/index.ts";
 import {
@@ -48,9 +46,13 @@ import {
   promptSnippet as resolveSnippet,
 } from "./code_resolve/guidance.ts";
 
+/** Model-facing fields registered for one public code-intelligence tool. */
 export interface CodeIntelligenceToolPromptSurface {
+  /** Selection contract in the active provider tool definition. */
   description: string;
+  /** One-line capability phrase in the default tool list. */
   promptSnippet: string;
+  /** Optional active-tool routing or ordering reminders. */
   promptGuidelines: string[];
 }
 
@@ -59,7 +61,7 @@ export type CodeIntelligenceToolPromptSurfaceMap = Record<
   CodeIntelligenceToolPromptSurface
 >;
 
-export const CODE_INTELLIGENCE_TOOL_PROMPT_SURFACES: CodeIntelligenceToolPromptSurfaceMap = {
+export const CODE_INTELLIGENCE_TOOL_PROMPT_SURFACES = {
   code_resolve: {
     description: resolveDescription,
     promptSnippet: resolveSnippet,
@@ -100,4 +102,4 @@ export const CODE_INTELLIGENCE_TOOL_PROMPT_SURFACES: CodeIntelligenceToolPromptS
     promptSnippet: applySnippet,
     promptGuidelines: applyGuidelines,
   },
-};
+} satisfies CodeIntelligenceToolPromptSurfaceMap;