@@ -905,6 +905,29 @@ replacement content here
 			expect(error).toContain("Best Match Length: 0 characters")
 		})
 
+		it("should include a whole-lines tip when no sufficiently similar match is found", async () => {
+			const originalContent = "line one\nline two"
+			const diffContent = `test.ts
+<<<<<<< SEARCH
+:start_line:999
+-------
+non-existent content that cannot be found in the file
+=======
+replacement content here
+>>>>>>> REPLACE`
+
+			const result = await strategy.applyDiff(originalContent, diffContent)
+			expect(result.success).toBe(false)
+			const error =
+				!result.success && result.failParts?.[0]
+					? "error" in result.failParts[0]
+						? result.failParts[0].error
+						: ""
+					: ""
+			expect(error).toContain("No sufficiently similar match found")
+			expect(error).toContain("Tip: The SEARCH block must contain complete, whole lines")
+		})
+
 		it("should include scoped original content when search fails with start_line that has a low-score match", async () => {
 			const originalContent = "function existing() {\n    return 42;\n}\n"
 			const diffContent = `test.ts
 
@@ -0,0 +1,40 @@
+import type OpenAI from "openai"
+import { apply_diff } from "../apply_diff"
+
+// Helper type to access function tools
+type FunctionTool = OpenAI.Chat.ChatCompletionTool & { type: "function" }
+
+// Helper to get function definition from tool
+const getFunctionDef = (tool: OpenAI.Chat.ChatCompletionTool) => (tool as FunctionTool).function
+
+// OpenAI types the parameter schema as FunctionParameters (Record<string, unknown>).
+// Narrow it with runtime checks instead of assertions so the spec tracks schema changes.
+function asRecord(value: unknown): Record<string, unknown> {
+	if (typeof value !== "object" || value === null) {
+		throw new Error("expected an object value in the apply_diff parameter schema")
+	}
+	return value as Record<string, unknown>
+}
+
+const getDiffParameterDescription = (): string => {
+	const parameters = asRecord(getFunctionDef(apply_diff).parameters)
+	const properties = asRecord(parameters["properties"])
+	const diff = asRecord(properties["diff"])
+	const description = diff["description"]
+	if (typeof description !== "string") {
+		throw new Error("diff parameter must declare a string description")
+	}
+	return description
+}
+
+describe("apply_diff diff parameter description", () => {
+	const diffDescription = getDiffParameterDescription()
+
+	it("should require complete, whole lines in the SEARCH block", () => {
+		expect(diffDescription).toContain("The SEARCH block must contain complete, whole lines")
+	})
+
+	it("should warn that partial-line (substring) matching is not supported", () => {
+		expect(diffDescription).toContain("partial-line (substring) matching is not supported")
+	})
+})