knodin 0.8.7 → 0.9.0

package/dist/fixtures/update-verification/fixture.json

@@ -0,0 +1,147 @@
+{
+	"schemaVersion": 1,
+	"fixtureVersion": "2026-08-14.2",
+	"languages": [
+		"typescript",
+		"javascript",
+		"python",
+		"java",
+		"csharp",
+		"apex",
+		"sql",
+		"prisma",
+		"xml",
+		"salesforce",
+		"terraform",
+		"dbt"
+	],
+	"assertions": [
+		{
+			"pattern": "callers_of",
+			"symbol": "typescriptTarget",
+			"coverage": ["typescript"],
+			"expected": {
+				"symbol": "typescriptCaller",
+				"file": "src/typescript.ts",
+				"line": 6,
+				"kind": "call"
+			}
+		},
+		{
+			"pattern": "callers_of",
+			"symbol": "javascriptTarget",
+			"coverage": ["javascript"],
+			"expected": {
+				"symbol": "javascriptCaller",
+				"file": "src/javascript.js",
+				"line": 6,
+				"kind": "call"
+			}
+		},
+		{
+			"pattern": "callers_of",
+			"symbol": "python_target",
+			"coverage": ["python"],
+			"expected": {
+				"symbol": "python_caller",
+				"file": "src/python_fixture.py",
+				"line": 6,
+				"kind": "call"
+			}
+		},
+		{
+			"pattern": "callers_of",
+			"symbol": "javaTarget",
+			"coverage": ["java"],
+			"expected": {
+				"symbol": "javaCaller",
+				"file": "src/JavaFixture.java",
+				"line": 7,
+				"kind": "call"
+			}
+		},
+		{
+			"pattern": "callers_of",
+			"symbol": "CsharpTarget",
+			"coverage": ["csharp"],
+			"expected": {
+				"symbol": "CsharpCaller",
+				"file": "src/CsharpFixture.cs",
+				"line": 5,
+				"kind": "call"
+			}
+		},
+		{
+			"pattern": "callers_of",
+			"symbol": "apexTarget",
+			"coverage": ["apex"],
+			"expected": {
+				"symbol": "apexCaller",
+				"file": "force-app/main/default/classes/UpdateFixture.cls",
+				"line": 7,
+				"kind": "call"
+			}
+		},
+		{
+			"pattern": "file_summary",
+			"symbol": "sql/functions.sql",
+			"coverage": ["sql"],
+			"expected": {
+				"symbol": "verified_wrapper",
+				"file": "sql/functions.sql",
+				"line": 6,
+				"kind": "procedure",
+				"evidenceQuality": "parser-grounded"
+			}
+		},
+		{
+			"pattern": "file_summary",
+			"symbol": "prisma/schema.prisma",
+			"coverage": ["prisma"],
+			"expected": {
+				"symbol": "Contact",
+				"file": "prisma/schema.prisma",
+				"kind": "model",
+				"evidenceQuality": "parser-grounded"
+			}
+		},
+		{
+			"pattern": "file_summary",
+			"symbol": "force-app/main/default/flows/Update_Verification.flow-meta.xml",
+			"coverage": ["xml"],
+			"expected": {
+				"symbol": "Update_Verification",
+				"file": "force-app/main/default/flows/Update_Verification.flow-meta.xml",
+				"kind": "salesforce-metadata",
+				"evidenceQuality": "parser-grounded"
+			}
+		},
+		{
+			"pattern": "imports_of",
+			"symbol": "force-app/main/default/flows/Update_Verification.flow-meta.xml",
+			"coverage": ["salesforce"],
+			"expected": {
+				"file": "force-app/main/default/classes/UpdateFixture.cls",
+				"kind": "flow_apex_action"
+			}
+		},
+		{
+			"pattern": "file_summary",
+			"symbol": "terraform/main.tf",
+			"coverage": ["terraform"],
+			"expected": {
+				"symbol": "verified_child",
+				"file": "terraform/main.tf",
+				"line": 1,
+				"kind": "Module",
+				"evidenceQuality": "source-derived"
+			}
+		},
+		{
+			"pattern": "imports_of",
+			"symbol": ".knodin/dbt/model.fixture.contacts.sql",
+			"coverage": ["dbt"],
+			"expected": { "file": ".knodin/dbt/model.fixture.accounts.sql", "kind": "dbt-lineage" }
+		}
+	]
+}

package/dist/fixtures/update-verification/force-app/main/default/classes/UpdateFixture.cls

@@ -0,0 +1,14 @@
+public class UpdateFixture {
+    public static String apexTarget(String value) {
+        return value.toUpperCase();
+    }
+
+    public static String apexCaller() {
+        return apexTarget('verified');
+    }
+
+    @InvocableMethod
+    public static List<String> verifiedAction(List<String> values) {
+        return values;
+    }
+}

package/dist/fixtures/update-verification/force-app/main/default/flows/Update_Verification.flow-meta.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Flow xmlns="http://soap.sforce.com/2006/04/metadata">
+  <actionCalls>
+    <name>Call_Update_Fixture</name>
+    <actionName>UpdateFixture.verifiedAction</actionName>
+    <actionType>apex</actionType>
+  </actionCalls>
+  <status>Active</status>
+</Flow>

package/dist/fixtures/update-verification/package.json

@@ -0,0 +1,5 @@
+{
+	"name": "knodin-update-verification-fixture",
+	"private": true,
+	"type": "module"
+}

package/dist/fixtures/update-verification/prisma/schema.prisma

@@ -0,0 +1,10 @@
+model Account {
+  id       Int       @id
+  contacts Contact[]
+}
+
+model Contact {
+  id        Int     @id
+  accountId Int
+  account   Account @relation(fields: [accountId], references: [id])
+}

package/dist/fixtures/update-verification/sql/functions.sql

@@ -0,0 +1,16 @@
+CREATE OR REPLACE FUNCTION verified_message(input_text text)
+RETURNS text
+LANGUAGE plpgsql
+AS $verified_body$
+BEGIN
+  RETURN upper(input_text || '$not_a_delimiter$');
+END;
+$verified_body$;
+
+CREATE OR REPLACE PROCEDURE verified_wrapper()
+LANGUAGE plpgsql
+AS $wrapper$
+BEGIN
+  PERFORM verified_message('ready');
+END;
+$wrapper$;

package/dist/fixtures/update-verification/src/CsharpFixture.cs

@@ -0,0 +1,6 @@
+public static class CsharpFixture
+{
+    public static string CsharpTarget(string value) => value.ToUpperInvariant();
+
+    public static string CsharpCaller() => CsharpTarget("verified");
+}

package/dist/fixtures/update-verification/src/JavaFixture.java

@@ -0,0 +1,9 @@
+public final class JavaFixture {
+    public static String javaTarget(String value) {
+        return value.toUpperCase();
+    }
+
+    public static String javaCaller() {
+        return javaTarget("verified");
+    }
+}

package/dist/fixtures/update-verification/src/javascript.js

@@ -0,0 +1,7 @@
+export function javascriptTarget(value) {
+	return value + 1;
+}
+
+export function javascriptCaller() {
+	return javascriptTarget(41);
+}

package/dist/fixtures/update-verification/src/python_fixture.py

@@ -0,0 +1,6 @@
+def python_target(value: str) -> str:
+    return value.upper()
+
+
+def python_caller() -> str:
+    return python_target("verified")

package/dist/fixtures/update-verification/src/typescript.ts

@@ -0,0 +1,7 @@
+export function typescriptTarget(value: string): string {
+	return value.toUpperCase();
+}
+
+export function typescriptCaller(): string {
+	return typescriptTarget("verified");
+}

package/dist/fixtures/update-verification/terraform/main.tf

@@ -0,0 +1,7 @@
+module "verified_child" {
+  source = "./modules/verified-child"
+}
+
+output "verified_value" {
+  value = module.verified_child.value
+}

package/dist/fixtures/update-verification/terraform/modules/verified-child/main.tf

@@ -0,0 +1,3 @@
+output "value" {
+  value = "verified"
+}

package/dist/src/agent-integration.js

@@ -160,12 +160,29 @@ function removeEmptyParent(filePath) {
             throw error;
     }
 }
+function compatibleMcpRegistration(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const registration = value;
+    return ((registration.type === undefined || registration.type === "stdio") &&
+        registration.command === "knodin" &&
+        Array.isArray(registration.args) &&
+        registration.args.length === 1 &&
+        registration.args[0] === "serve");
+}
 function updateJsonMcp(filePath, remove) {
     const document = readJsonObject(filePath);
     const existing = document.mcpServers;
-    const servers = typeof existing === "object" && existing !== null && !Array.isArray(existing)
-        ? { ...existing }
-        : {};
+    const existingServers = typeof existing === "object" && existing !== null && !Array.isArray(existing)
+        ? existing
+        : undefined;
+    // Do nothing when the existing Knodin entry is compatible. Preserve
+    // whitespace, foreign entries, and type: stdio.
+    if (!remove && compatibleMcpRegistration(existingServers?.[MCP_NAME]))
+        return true;
+    if (remove && existingServers?.[MCP_NAME] === undefined)
+        return fs.existsSync(filePath);
+    const servers = existingServers ? { ...existingServers } : {};
     if (remove)
         delete servers[MCP_NAME];
     else
@@ -191,6 +208,12 @@ function updateVsCodeMcp(filePath, remove) {
     const servers = typeof existing === "object" && existing !== null && !Array.isArray(existing)
         ? { ...existing }
         : {};
+    // Do nothing when the existing Knodin entry is compatible. Preserve
+    // whitespace, foreign entries, and type: stdio.
+    if (!remove && compatibleMcpRegistration(servers[MCP_NAME]))
+        return true;
+    if (remove && servers[MCP_NAME] === undefined)
+        return fs.existsSync(filePath);
     if (remove)
         delete servers[MCP_NAME];
     else