@soda-gql/lsp 0.14.0 → 0.14.2

package/README.md

@@ -52,8 +52,53 @@ const server = createLspServer({ connection });
 server.start();
 ```
 
+## Claude Code Integration
+
+soda-gql LSP integrates with [Claude Code](https://claude.com/claude-code) as a plugin, providing GraphQL diagnostics, completion, and code intelligence directly in the AI coding assistant.
+
+### How it works
+
+The integration uses a separate **proxy package** ([`@soda-gql/protocol-proxy`](../protocol-proxy)) that resolves the project-local `@soda-gql/lsp` at runtime. This ensures version consistency between the LSP server and the project's soda-gql dependencies — similar to how `typescript-language-server` delegates to the project-local TypeScript.
+
+### Setup for users
+
+1. Install the proxy binary globally:
+
+```bash
+npm install -g @soda-gql/protocol-proxy
+```
+
+2. Ensure `@soda-gql/lsp` is a project dependency (the proxy resolves it from `node_modules`):
+
+```bash
+bun add -D @soda-gql/lsp
+```
+
+3. The Claude Code plugin is defined in the project's `.claude-plugin/marketplace.json`. Install it via `/plugin` in Claude Code and restart the session.
+
+### Setup for monorepo contributors
+
+1. Build the packages:
+
+```bash
+bun run build
+```
+
+2. Link the proxy package globally:
+
+```bash
+cd packages/protocol-proxy && bun link
+```
+
+3. Install the plugin via `/plugin` in Claude Code, then restart.
+
+### Coexistence with TypeScript LSP
+
+Both soda-gql LSP and the TypeScript LSP plugin can be active simultaneously on `.ts`/`.tsx` files. The TypeScript LSP provides type checking, while soda-gql LSP provides GraphQL-specific intelligence within tagged templates and callback builders.
+
 ## Supported Editors
 
+- **Claude Code** — Via the soda-gql plugin (see above)
 - **VS Code / Cursor** — Via the [soda-gql VS Code extension](../vscode-extension)
 - **Any LSP-compatible editor** — Neovim, Emacs, Sublime Text, etc. using the standalone CLI
 

package/dist/bin.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_server = require('./server-DsJ1bZ7i.cjs');
+const require_server = require('./server-C1MSX490.cjs');
 
 //#region packages/lsp/src/bin.ts
 /**

package/dist/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as createLspServer } from "./server-CqOUHwDk.mjs";
+import { t as createLspServer } from "./server-wPCHK04O.mjs";
 
 //#region packages/lsp/src/bin.ts
 /**

package/dist/index.cjs

@@ -1,8 +1,304 @@
-const require_server = require('./server-DsJ1bZ7i.cjs');
+const require_server = require('./server-C1MSX490.cjs');
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let __soda_gql_builder = require("@soda-gql/builder");
+let __soda_gql_config = require("@soda-gql/config");
+let graphql = require("graphql");
 
+//#region packages/lsp/src/cli-utils.ts
+/**
+* Shared utility functions for CLI.
+* @module
+*/
+/** Extract variable declaration from template content (e.g., "($id: ID!)"). */
+const extractVariablesFromContent = (content) => {
+	const match = content.match(/^\s*\(([^)]+)\)/);
+	return match ? `(${match[1]})` : undefined;
+};
+/** Compute 1-based line number from a byte offset in source. */
+const computeLineFromOffset = (source, offset) => {
+	let line = 1;
+	for (let i = 0; i < offset && i < source.length; i++) {
+		if (source[i] === "\n") line++;
+	}
+	return line;
+};
+const collectDiagnostics = (state, ctx) => {
+	const diagnostics = require_server.collectRawDiagnostics(state, ctx);
+	return [...diagnostics].map((d) => ({
+		message: d.message,
+		line: d.range.start.line + 1,
+		column: d.range.start.character + 1,
+		severity: diagnosticSeverityToString(d.severity)
+	}));
+};
+const diagnosticSeverityToString = (severity) => {
+	switch (severity) {
+		case 1: return "Error";
+		case 2: return "Warning";
+		case 3: return "Information";
+		case 4: return "Hint";
+		default: return "Error";
+	}
+};
+/** Introspect a single GraphQL type (depth-1). */
+const introspectType = (schema, typeName) => {
+	const type = schema.getType(typeName);
+	if (!type) return undefined;
+	if ((0, graphql.isObjectType)(type) || (0, graphql.isInterfaceType)(type)) {
+		const fields = Object.values(type.getFields()).map((f) => ({
+			name: f.name,
+			type: f.type.toString(),
+			args: f.args.map((a) => ({
+				name: a.name,
+				type: a.type.toString()
+			}))
+		}));
+		return {
+			name: type.name,
+			kind: (0, graphql.isObjectType)(type) ? "OBJECT" : "INTERFACE",
+			fields
+		};
+	}
+	if ((0, graphql.isUnionType)(type)) {
+		return {
+			name: type.name,
+			kind: "UNION",
+			members: type.getTypes().map((t) => ({ name: t.name }))
+		};
+	}
+	if ((0, graphql.isEnumType)(type)) {
+		return {
+			name: type.name,
+			kind: "ENUM",
+			values: type.getValues().map((v) => ({ name: v.name }))
+		};
+	}
+	if ((0, graphql.isInputObjectType)(type)) {
+		const fields = Object.values(type.getFields()).map((f) => ({
+			name: f.name,
+			type: f.type.toString()
+		}));
+		return {
+			name: type.name,
+			kind: "INPUT_OBJECT",
+			fields
+		};
+	}
+	if ((0, graphql.isScalarType)(type)) {
+		return {
+			name: type.name,
+			kind: "SCALAR"
+		};
+	}
+	return undefined;
+};
+/** List all user-defined types in a schema. */
+const listTypes = (schema) => {
+	const typeMap = schema.getTypeMap();
+	const types = Object.values(typeMap).filter((t) => !t.name.startsWith("__")).map((t) => ({
+		name: t.name,
+		kind: getTypeKind(t)
+	}));
+	return { types };
+};
+const getTypeKind = (type) => {
+	if ((0, graphql.isObjectType)(type)) return "OBJECT";
+	if ((0, graphql.isInterfaceType)(type)) return "INTERFACE";
+	if ((0, graphql.isUnionType)(type)) return "UNION";
+	if ((0, graphql.isEnumType)(type)) return "ENUM";
+	if ((0, graphql.isInputObjectType)(type)) return "INPUT_OBJECT";
+	if ((0, graphql.isScalarType)(type)) return "SCALAR";
+	return "UNKNOWN";
+};
+
+//#endregion
+//#region packages/lsp/src/cli.ts
+/**
+* One-shot CLI runner: exposes soda-gql GraphQL intelligence as CLI subcommands.
+* Provides a stable, daemon-free interface for Claude Code skills.
+* @module
+*/
+const USAGE = `Usage: soda-gql-lsp-cli <subcommand> [options]
+
+Subcommands:
+  diagnostics <file>              Validate GraphQL templates against the schema
+  schema [typeName]               Introspect schema types (omit typeName for full list)
+  symbols <file>                  List fragments and operations in a file
+
+Options:
+  --workspace                     Index all workspace files (for cross-file fragment resolution)
+  --schema <name>                 Target schema name (multi-schema projects)
+  --config <path>                 Config context file path (multi-config projects)
+  --help                          Show this help message`;
+const parseCliArgs = (args) => {
+	const subcommand = args[0];
+	if (!subcommand || subcommand === "--help" || ![
+		"diagnostics",
+		"schema",
+		"symbols"
+	].includes(subcommand)) {
+		return undefined;
+	}
+	let filePath;
+	let typeName;
+	let workspace = false;
+	let schemaName;
+	let configPath;
+	let i = 1;
+	const firstArg = args[i];
+	if (firstArg !== undefined && !firstArg.startsWith("--")) {
+		if (subcommand === "schema") {
+			typeName = firstArg;
+		} else {
+			filePath = (0, node_path.resolve)(firstArg);
+		}
+		i++;
+	}
+	for (; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === undefined) continue;
+		if (arg === "--workspace") {
+			workspace = true;
+		} else if (arg === "--schema" && i + 1 < args.length) {
+			schemaName = args[++i];
+		} else if (arg === "--config" && i + 1 < args.length) {
+			const nextArg = args[++i];
+			if (nextArg !== undefined) configPath = (0, node_path.resolve)(nextArg);
+		}
+	}
+	return {
+		subcommand,
+		filePath,
+		typeName,
+		workspace,
+		schemaName,
+		configPath
+	};
+};
+const output = (data) => {
+	process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+};
+var CliError = class extends Error {};
+const cliError = (message) => {
+	process.stderr.write(`${JSON.stringify({ error: message })}\n`);
+	return new CliError(message);
+};
+const initRegistry = () => {
+	const cwd = process.cwd();
+	const configPaths = (0, __soda_gql_config.findAllConfigFiles)(cwd);
+	if (configPaths.length === 0) {
+		throw cliError(`No soda-gql config found in ${cwd}`);
+	}
+	const result = require_server.createConfigRegistry(configPaths);
+	if (result.isErr()) {
+		throw cliError(result.error.message);
+	}
+	return result.value;
+};
+const indexWorkspace = (registry) => {
+	for (const ctx of registry.getAllContexts()) {
+		const filesResult = (0, __soda_gql_builder.resolveEntryPaths)(ctx.config.include, ctx.config.exclude);
+		if (filesResult.isErr()) continue;
+		for (const fp of filesResult.value) {
+			if (ctx.documentManager.get(fp)) continue;
+			try {
+				const source = (0, node_fs.readFileSync)(fp, "utf-8");
+				ctx.documentManager.update(fp, 1, source);
+			} catch {}
+		}
+	}
+};
+const resolveContext = (registry, filePath) => {
+	const ctx = filePath ? registry.resolveForUri(filePath) : registry.getAllContexts()[0];
+	if (!ctx) {
+		throw cliError(filePath ? `No soda-gql config covers ${filePath}` : "No soda-gql config context found");
+	}
+	return ctx;
+};
+const readSource = (filePath) => {
+	try {
+		return (0, node_fs.readFileSync)(filePath, "utf-8");
+	} catch (e) {
+		throw cliError(`Failed to read file: ${e instanceof Error ? e.message : String(e)}`);
+	}
+};
+const requireFilePath = (args, subcommand) => {
+	const { filePath } = args;
+	if (!filePath) throw cliError(`${subcommand} requires a file path argument`);
+	return filePath;
+};
+const handleDiagnostics = (registry, args) => {
+	const filePath = requireFilePath(args, "diagnostics");
+	const ctx = resolveContext(registry, filePath);
+	const source = readSource(filePath);
+	const state = ctx.documentManager.update(filePath, 1, source);
+	output(collectDiagnostics(state, ctx));
+};
+const handleSchema = (registry, args) => {
+	const ctx = resolveContext(registry, args.configPath);
+	const targetSchemaName = args.schemaName ?? ctx.schemaResolver.getSchemaNames()[0];
+	if (!targetSchemaName) throw cliError("No schema available");
+	const entry = ctx.schemaResolver.getSchema(targetSchemaName);
+	if (!entry) throw cliError(`Schema '${targetSchemaName}' not found`);
+	if (args.typeName) {
+		const result = introspectType(entry.schema, args.typeName);
+		if (!result) throw cliError(`Type '${args.typeName}' not found in schema`);
+		output(result);
+	} else {
+		output(listTypes(entry.schema));
+	}
+};
+const handleSymbols = (registry, args) => {
+	const filePath = requireFilePath(args, "symbols");
+	const ctx = resolveContext(registry, filePath);
+	const source = readSource(filePath);
+	const state = ctx.documentManager.update(filePath, 1, source);
+	const symbols = state.templates.filter((t) => t.elementName !== undefined).map((t) => ({
+		name: t.elementName,
+		kind: t.kind,
+		typeName: t.typeName,
+		schemaName: t.schemaName,
+		variables: extractVariablesFromContent(t.content),
+		line: computeLineFromOffset(source, t.contentRange.start)
+	}));
+	output(symbols);
+};
+/** Run the soda-gql LSP CLI with the given arguments. */
+const runLspCli = async (args) => {
+	const parsed = parseCliArgs(args);
+	if (!parsed) {
+		process.stderr.write(`${USAGE}\n`);
+		process.exit(args.includes("--help") ? 0 : 1);
+	}
+	try {
+		const registry = initRegistry();
+		if (parsed.workspace) {
+			indexWorkspace(registry);
+		}
+		switch (parsed.subcommand) {
+			case "diagnostics":
+				handleDiagnostics(registry, parsed);
+				break;
+			case "schema":
+				handleSchema(registry, parsed);
+				break;
+			case "symbols":
+				handleSymbols(registry, parsed);
+				break;
+		}
+	} catch (e) {
+		if (e instanceof CliError) process.exit(1);
+		throw e;
+	}
+};
+
+//#endregion
 exports.createDocumentManager = require_server.createDocumentManager;
 exports.createLspServer = require_server.createLspServer;
 exports.createPositionMapper = require_server.createPositionMapper;
 exports.createSchemaResolver = require_server.createSchemaResolver;
 exports.lspErrors = require_server.lspErrors;
-exports.preprocessFragmentArgs = require_server.preprocessFragmentArgs;
+exports.preprocessFragmentArgs = require_server.preprocessFragmentArgs;
+exports.runLspCli = runLspCli;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["collectRawDiagnostics","filePath: string | undefined","typeName: string | undefined","schemaName: string | undefined","configPath: string | undefined","createConfigRegistry"],"sources":["../src/cli-utils.ts","../src/cli.ts"],"sourcesContent":["/**\n * Shared utility functions for CLI.\n * @module\n */\n\nimport {\n  type GraphQLNamedType,\n  type GraphQLSchema,\n  isEnumType,\n  isInputObjectType,\n  isInterfaceType,\n  isObjectType,\n  isScalarType,\n  isUnionType,\n} from \"graphql\";\nimport type { ConfigContext } from \"./config-registry\";\nimport { collectRawDiagnostics } from \"./diagnostics-collector\";\nimport type { DocumentState } from \"./types\";\n\n/** Extract variable declaration from template content (e.g., \"($id: ID!)\"). */\nexport const extractVariablesFromContent = (content: string): string | undefined => {\n  const match = content.match(/^\\s*\\(([^)]+)\\)/);\n  return match ? `(${match[1]})` : undefined;\n};\n\n/** Compute 1-based line number from a byte offset in source. */\nexport const computeLineFromOffset = (source: string, offset: number): number => {\n  let line = 1;\n  for (let i = 0; i < offset && i < source.length; i++) {\n    if (source[i] === \"\\n\") line++;\n  }\n  return line;\n};\n\n/** Collect diagnostics and map to JSON-serializable format. */\nexport type DiagnosticResult = { message: string; line: number; column: number; severity: string };\n\nexport const collectDiagnostics = (state: DocumentState, ctx: ConfigContext): DiagnosticResult[] => {\n  const diagnostics = collectRawDiagnostics(state, ctx);\n  return [...diagnostics].map((d) => ({\n    message: d.message,\n    line: d.range.start.line + 1,\n    column: d.range.start.character + 1,\n    severity: diagnosticSeverityToString(d.severity),\n  }));\n};\n\nexport const diagnosticSeverityToString = (severity: number | undefined): string => {\n  switch (severity) {\n    case 1:\n      return \"Error\";\n    case 2:\n      return \"Warning\";\n    case 3:\n      return \"Information\";\n    case 4:\n      return \"Hint\";\n    default:\n      return \"Error\";\n  }\n};\n\n/** Introspect a single GraphQL type (depth-1). */\nexport const introspectType = (schema: GraphQLSchema, typeName: string) => {\n  const type = schema.getType(typeName);\n  if (!type) return undefined;\n\n  if (isObjectType(type) || isInterfaceType(type)) {\n    const fields = Object.values(type.getFields()).map((f) => ({\n      name: f.name,\n      type: f.type.toString(),\n      args: f.args.map((a) => ({ name: a.name, type: a.type.toString() })),\n    }));\n    return { name: type.name, kind: isObjectType(type) ? \"OBJECT\" : \"INTERFACE\", fields };\n  }\n  if (isUnionType(type)) {\n    return { name: type.name, kind: \"UNION\", members: type.getTypes().map((t) => ({ name: t.name })) };\n  }\n  if (isEnumType(type)) {\n    return { name: type.name, kind: \"ENUM\", values: type.getValues().map((v) => ({ name: v.name })) };\n  }\n  if (isInputObjectType(type)) {\n    const fields = Object.values(type.getFields()).map((f) => ({\n      name: f.name,\n      type: f.type.toString(),\n    }));\n    return { name: type.name, kind: \"INPUT_OBJECT\", fields };\n  }\n  if (isScalarType(type)) {\n    return { name: type.name, kind: \"SCALAR\" };\n  }\n  return undefined;\n};\n\n/** List all user-defined types in a schema. */\nexport const listTypes = (schema: GraphQLSchema) => {\n  const typeMap = schema.getTypeMap();\n  const types = Object.values(typeMap)\n    .filter((t) => !t.name.startsWith(\"__\"))\n    .map((t) => ({ name: t.name, kind: getTypeKind(t) }));\n  return { types };\n};\n\nconst getTypeKind = (type: GraphQLNamedType): string => {\n  if (isObjectType(type)) return \"OBJECT\";\n  if (isInterfaceType(type)) return \"INTERFACE\";\n  if (isUnionType(type)) return \"UNION\";\n  if (isEnumType(type)) return \"ENUM\";\n  if (isInputObjectType(type)) return \"INPUT_OBJECT\";\n  if (isScalarType(type)) return \"SCALAR\";\n  return \"UNKNOWN\";\n};\n","/**\n * One-shot CLI runner: exposes soda-gql GraphQL intelligence as CLI subcommands.\n * Provides a stable, daemon-free interface for Claude Code skills.\n * @module\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { resolveEntryPaths } from \"@soda-gql/builder\";\nimport { findAllConfigFiles } from \"@soda-gql/config\";\nimport { collectDiagnostics, computeLineFromOffset, extractVariablesFromContent, introspectType, listTypes } from \"./cli-utils\";\nimport type { ConfigContext, ConfigRegistry } from \"./config-registry\";\nimport { createConfigRegistry } from \"./config-registry\";\n\ninterface CliArgs {\n  readonly subcommand: \"diagnostics\" | \"schema\" | \"symbols\";\n  readonly filePath?: string;\n  readonly typeName?: string;\n  readonly workspace: boolean;\n  readonly schemaName?: string;\n  readonly configPath?: string;\n}\n\nconst USAGE = `Usage: soda-gql-lsp-cli <subcommand> [options]\n\nSubcommands:\n  diagnostics <file>              Validate GraphQL templates against the schema\n  schema [typeName]               Introspect schema types (omit typeName for full list)\n  symbols <file>                  List fragments and operations in a file\n\nOptions:\n  --workspace                     Index all workspace files (for cross-file fragment resolution)\n  --schema <name>                 Target schema name (multi-schema projects)\n  --config <path>                 Config context file path (multi-config projects)\n  --help                          Show this help message`;\n\nexport const parseCliArgs = (args: readonly string[]): CliArgs | undefined => {\n  const subcommand = args[0];\n  if (!subcommand || subcommand === \"--help\" || ![\"diagnostics\", \"schema\", \"symbols\"].includes(subcommand)) {\n    return undefined;\n  }\n\n  let filePath: string | undefined;\n  let typeName: string | undefined;\n  let workspace = false;\n  let schemaName: string | undefined;\n  let configPath: string | undefined;\n\n  let i = 1;\n  // Collect positional arg first (before any flags)\n  const firstArg = args[i];\n  if (firstArg !== undefined && !firstArg.startsWith(\"--\")) {\n    if (subcommand === \"schema\") {\n      typeName = firstArg;\n    } else {\n      filePath = resolve(firstArg);\n    }\n    i++;\n  }\n\n  // Collect flags\n  for (; i < args.length; i++) {\n    const arg = args[i];\n    if (arg === undefined) continue;\n    if (arg === \"--workspace\") {\n      workspace = true;\n    } else if (arg === \"--schema\" && i + 1 < args.length) {\n      schemaName = args[++i];\n    } else if (arg === \"--config\" && i + 1 < args.length) {\n      const nextArg = args[++i];\n      if (nextArg !== undefined) configPath = resolve(nextArg);\n    }\n  }\n\n  return { subcommand: subcommand as CliArgs[\"subcommand\"], filePath, typeName, workspace, schemaName, configPath };\n};\n\nconst output = (data: unknown): void => {\n  process.stdout.write(`${JSON.stringify(data, null, 2)}\\n`);\n};\n\nclass CliError extends Error {}\n\nconst cliError = (message: string): CliError => {\n  process.stderr.write(`${JSON.stringify({ error: message })}\\n`);\n  return new CliError(message);\n};\n\nconst initRegistry = (): ConfigRegistry => {\n  const cwd = process.cwd();\n  const configPaths = findAllConfigFiles(cwd);\n  if (configPaths.length === 0) {\n    throw cliError(`No soda-gql config found in ${cwd}`);\n  }\n  const result = createConfigRegistry(configPaths);\n  if (result.isErr()) {\n    throw cliError(result.error.message);\n  }\n  return result.value;\n};\n\nconst indexWorkspace = (registry: ConfigRegistry): void => {\n  for (const ctx of registry.getAllContexts()) {\n    const filesResult = resolveEntryPaths(ctx.config.include, ctx.config.exclude);\n    if (filesResult.isErr()) continue;\n    for (const fp of filesResult.value) {\n      if (ctx.documentManager.get(fp)) continue;\n      try {\n        const source = readFileSync(fp, \"utf-8\");\n        ctx.documentManager.update(fp, 1, source);\n      } catch {\n        /* skip unreadable files */\n      }\n    }\n  }\n};\n\nconst resolveContext = (registry: ConfigRegistry, filePath?: string): ConfigContext => {\n  const ctx = filePath ? registry.resolveForUri(filePath) : registry.getAllContexts()[0];\n  if (!ctx) {\n    throw cliError(filePath ? `No soda-gql config covers ${filePath}` : \"No soda-gql config context found\");\n  }\n  return ctx;\n};\n\nconst readSource = (filePath: string): string => {\n  try {\n    return readFileSync(filePath, \"utf-8\");\n  } catch (e) {\n    throw cliError(`Failed to read file: ${e instanceof Error ? e.message : String(e)}`);\n  }\n};\n\nconst requireFilePath = (args: CliArgs, subcommand: string): string => {\n  const { filePath } = args;\n  if (!filePath) throw cliError(`${subcommand} requires a file path argument`);\n  return filePath;\n};\n\nconst handleDiagnostics = (registry: ConfigRegistry, args: CliArgs): void => {\n  const filePath = requireFilePath(args, \"diagnostics\");\n  const ctx = resolveContext(registry, filePath);\n  const source = readSource(filePath);\n  const state = ctx.documentManager.update(filePath, 1, source);\n  output(collectDiagnostics(state, ctx));\n};\n\nconst handleSchema = (registry: ConfigRegistry, args: CliArgs): void => {\n  const ctx = resolveContext(registry, args.configPath);\n  const targetSchemaName = args.schemaName ?? ctx.schemaResolver.getSchemaNames()[0];\n  if (!targetSchemaName) throw cliError(\"No schema available\");\n\n  const entry = ctx.schemaResolver.getSchema(targetSchemaName);\n  if (!entry) throw cliError(`Schema '${targetSchemaName}' not found`);\n\n  if (args.typeName) {\n    const result = introspectType(entry.schema, args.typeName);\n    if (!result) throw cliError(`Type '${args.typeName}' not found in schema`);\n    output(result);\n  } else {\n    output(listTypes(entry.schema));\n  }\n};\n\nconst handleSymbols = (registry: ConfigRegistry, args: CliArgs): void => {\n  const filePath = requireFilePath(args, \"symbols\");\n  const ctx = resolveContext(registry, filePath);\n  const source = readSource(filePath);\n  const state = ctx.documentManager.update(filePath, 1, source);\n  const symbols = state.templates\n    .filter((t): t is typeof t & { elementName: string } => t.elementName !== undefined)\n    .map((t) => ({\n      name: t.elementName,\n      kind: t.kind,\n      typeName: t.typeName,\n      schemaName: t.schemaName,\n      variables: extractVariablesFromContent(t.content),\n      line: computeLineFromOffset(source, t.contentRange.start),\n    }));\n  output(symbols);\n};\n\n/** Run the soda-gql LSP CLI with the given arguments. */\nexport const runLspCli = async (args: readonly string[]): Promise<void> => {\n  const parsed = parseCliArgs(args);\n  if (!parsed) {\n    process.stderr.write(`${USAGE}\\n`);\n    process.exit(args.includes(\"--help\") ? 0 : 1);\n  }\n\n  try {\n    const registry = initRegistry();\n    if (parsed.workspace) {\n      indexWorkspace(registry);\n    }\n\n    switch (parsed.subcommand) {\n      case \"diagnostics\":\n        handleDiagnostics(registry, parsed);\n        break;\n      case \"schema\":\n        handleSchema(registry, parsed);\n        break;\n      case \"symbols\":\n        handleSymbols(registry, parsed);\n        break;\n    }\n  } catch (e) {\n    if (e instanceof CliError) process.exit(1);\n    throw e;\n  }\n};\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,12 +1,30 @@
 import * as _swc_core0 from "@swc/core";
 import { GraphqlSystemIdentifyHelper } from "@soda-gql/builder";
-import { ExtractedTemplateWithPosition, OperationKind } from "@soda-gql/common/template-extraction";
+import { ExtractedFieldTree, ExtractedTemplateWithPosition, OperationKind } from "@soda-gql/common/template-extraction";
 import * as graphql0 from "graphql";
 import { DocumentNode, FragmentDefinitionNode } from "graphql";
 import { Result } from "neverthrow";
 import { ResolvedSodaGqlConfig } from "@soda-gql/config";
-import { Connection } from "vscode-languageserver/node";
+import { Connection, InitializeParams, InitializeResult } from "vscode-languageserver/node";
 
+//#region packages/lsp/src/cli.d.ts
+/**
+ * One-shot CLI runner: exposes soda-gql GraphQL intelligence as CLI subcommands.
+ * Provides a stable, daemon-free interface for Claude Code skills.
+ * @module
+ */
+interface CliArgs {
+  readonly subcommand: "diagnostics" | "schema" | "symbols";
+  readonly filePath?: string;
+  readonly typeName?: string;
+  readonly workspace: boolean;
+  readonly schemaName?: string;
+  readonly configPath?: string;
+}
+declare const parseCliArgs: (args: readonly string[]) => CliArgs | undefined;
+/** Run the soda-gql LSP CLI with the given arguments. */
+declare const runLspCli: (args: readonly string[]) => Promise<void>;
+//#endregion
 //#region packages/lsp/src/types.d.ts
 /** A single tagged template extracted from a TypeScript file (with guaranteed position info). */
 type ExtractedTemplate = ExtractedTemplateWithPosition;
@@ -16,6 +34,8 @@ type DocumentState = {
   readonly version: number;
   readonly source: string;
   readonly templates: readonly ExtractedTemplate[];
+  /** Callback builder field call trees (schema-independent, resolved lazily). */
+  readonly fieldTrees: readonly ExtractedFieldTree[];
   /** Set when @swc/core could not be loaded; template extraction is skipped. */
   readonly swcUnavailable?: true;
 };
@@ -51,6 +71,10 @@ type DocumentManager = {
   readonly get: (uri: string) => DocumentState | undefined;
   readonly remove: (uri: string) => void;
   readonly findTemplateAtOffset: (uri: string, offset: number) => ExtractedTemplate | undefined;
+  /** Find the field call tree containing the given offset. */
+  readonly findFieldTreeAtOffset: (uri: string, offset: number) => ExtractedFieldTree | undefined;
+  /** Find a template whose typeNameSpan contains the given offset. */
+  readonly findTemplateByTypeNameOffset: (uri: string, offset: number) => ExtractedTemplate | undefined;
   /** Get fragments from other documents for a given schema, excluding the specified URI. */
   readonly getExternalFragments: (uri: string, schemaName: string) => readonly IndexedFragment[];
   /** Get ALL indexed fragments (including self) for a given schema. */
@@ -71,8 +95,21 @@ type SwcLoaderOptions = {
 /**
  * Reconstruct full GraphQL source from an extracted template.
  * Prepends the definition header from curried tag call arguments.
+ *
+ * For callback-variables templates (source === "callback-variables"), wraps the
+ * partial variables string in a dummy operation to produce valid GraphQL that
+ * graphql-language-service can parse.
  */
 declare const reconstructGraphql: (template: ExtractedTemplate) => string;
+/**
+ * Compute the length of the synthesized prefix before the template content
+ * in the reconstructed GraphQL string.
+ *
+ * For tagged templates, headerLen = reconstructed.length - content.length (content is at the end).
+ * For callback-variables, content is in the MIDDLE (prefix + content + suffix), so we must
+ * compute the prefix length explicitly.
+ */
+declare const computeHeaderLen: (template: ExtractedTemplate, reconstructed: string) => number;
 /** Create a document manager that tracks open documents and extracts templates. */
 declare const createDocumentManager: (helper: GraphqlSystemIdentifyHelper, swcOptions?: SwcLoaderOptions) => DocumentManager;
 //#endregion
@@ -222,9 +259,11 @@ declare const createSchemaResolver: (config: ResolvedSodaGqlConfig) => Result<Sc
 //#region packages/lsp/src/server.d.ts
 type LspServerOptions = {
   readonly connection?: Connection;
+  readonly initializeParams?: InitializeParams;
 };
 declare const createLspServer: (options?: LspServerOptions) => {
   start: () => void;
+  initializeResult: InitializeResult<any> | undefined;
 };
 /** One-time SWC unavailable notification state. */
 type SwcNotificationState = {
@@ -233,5 +272,5 @@ type SwcNotificationState = {
 /** Check if SWC is unavailable and show a one-time error notification. */
 declare const checkSwcUnavailable: (swcUnavailable: boolean | undefined, state: SwcNotificationState, showError: (message: string) => void) => void;
 //#endregion
-export { type DocumentManager, type DocumentState, type ExtractedTemplate, type FragmentSpreadLocation, type IndexedFragment, type LspError, type LspErrorCode, type LspResult, type LspServerOptions, type OperationKind, type PositionMapper, type SchemaEntry, type SchemaResolver, createDocumentManager, createLspServer, createPositionMapper, createSchemaResolver, lspErrors, preprocessFragmentArgs };
+export { type DocumentManager, type DocumentState, type ExtractedTemplate, type FragmentSpreadLocation, type IndexedFragment, type LspError, type LspErrorCode, type LspResult, type LspServerOptions, type OperationKind, type PositionMapper, type SchemaEntry, type SchemaResolver, createDocumentManager, createLspServer, createPositionMapper, createSchemaResolver, lspErrors, preprocessFragmentArgs, runLspCli };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/document-manager.ts","../src/errors.ts","../src/fragment-args-preprocessor.ts","../src/position-mapping.ts","../src/schema-resolver.ts","../src/server.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/cli.ts","../src/types.ts","../src/document-manager.ts","../src/errors.ts","../src/fragment-args-preprocessor.ts","../src/position-mapping.ts","../src/schema-resolver.ts","../src/server.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -1,12 +1,30 @@
-import { ExtractedTemplateWithPosition, OperationKind } from "@soda-gql/common/template-extraction";
+import { GraphqlSystemIdentifyHelper } from "@soda-gql/builder";
+import { ResolvedSodaGqlConfig } from "@soda-gql/config";
 import * as graphql0 from "graphql";
 import { DocumentNode, FragmentDefinitionNode } from "graphql";
+import { ExtractedFieldTree, ExtractedTemplateWithPosition, OperationKind } from "@soda-gql/common/template-extraction";
 import { Result } from "neverthrow";
-import { ResolvedSodaGqlConfig } from "@soda-gql/config";
-import { Connection } from "vscode-languageserver/node";
-import { GraphqlSystemIdentifyHelper } from "@soda-gql/builder";
+import { Connection, InitializeParams, InitializeResult } from "vscode-languageserver/node";
 import * as _swc_core0 from "@swc/core";
 
+//#region packages/lsp/src/cli.d.ts
+/**
+ * One-shot CLI runner: exposes soda-gql GraphQL intelligence as CLI subcommands.
+ * Provides a stable, daemon-free interface for Claude Code skills.
+ * @module
+ */
+interface CliArgs {
+  readonly subcommand: "diagnostics" | "schema" | "symbols";
+  readonly filePath?: string;
+  readonly typeName?: string;
+  readonly workspace: boolean;
+  readonly schemaName?: string;
+  readonly configPath?: string;
+}
+declare const parseCliArgs: (args: readonly string[]) => CliArgs | undefined;
+/** Run the soda-gql LSP CLI with the given arguments. */
+declare const runLspCli: (args: readonly string[]) => Promise<void>;
+//#endregion
 //#region packages/lsp/src/types.d.ts
 /** A single tagged template extracted from a TypeScript file (with guaranteed position info). */
 type ExtractedTemplate = ExtractedTemplateWithPosition;
@@ -16,6 +34,8 @@ type DocumentState = {
   readonly version: number;
   readonly source: string;
   readonly templates: readonly ExtractedTemplate[];
+  /** Callback builder field call trees (schema-independent, resolved lazily). */
+  readonly fieldTrees: readonly ExtractedFieldTree[];
   /** Set when @swc/core could not be loaded; template extraction is skipped. */
   readonly swcUnavailable?: true;
 };
@@ -51,6 +71,10 @@ type DocumentManager = {
   readonly get: (uri: string) => DocumentState | undefined;
   readonly remove: (uri: string) => void;
   readonly findTemplateAtOffset: (uri: string, offset: number) => ExtractedTemplate | undefined;
+  /** Find the field call tree containing the given offset. */
+  readonly findFieldTreeAtOffset: (uri: string, offset: number) => ExtractedFieldTree | undefined;
+  /** Find a template whose typeNameSpan contains the given offset. */
+  readonly findTemplateByTypeNameOffset: (uri: string, offset: number) => ExtractedTemplate | undefined;
   /** Get fragments from other documents for a given schema, excluding the specified URI. */
   readonly getExternalFragments: (uri: string, schemaName: string) => readonly IndexedFragment[];
   /** Get ALL indexed fragments (including self) for a given schema. */
@@ -71,8 +95,21 @@ type SwcLoaderOptions = {
 /**
  * Reconstruct full GraphQL source from an extracted template.
  * Prepends the definition header from curried tag call arguments.
+ *
+ * For callback-variables templates (source === "callback-variables"), wraps the
+ * partial variables string in a dummy operation to produce valid GraphQL that
+ * graphql-language-service can parse.
  */
 declare const reconstructGraphql: (template: ExtractedTemplate) => string;
+/**
+ * Compute the length of the synthesized prefix before the template content
+ * in the reconstructed GraphQL string.
+ *
+ * For tagged templates, headerLen = reconstructed.length - content.length (content is at the end).
+ * For callback-variables, content is in the MIDDLE (prefix + content + suffix), so we must
+ * compute the prefix length explicitly.
+ */
+declare const computeHeaderLen: (template: ExtractedTemplate, reconstructed: string) => number;
 /** Create a document manager that tracks open documents and extracts templates. */
 declare const createDocumentManager: (helper: GraphqlSystemIdentifyHelper, swcOptions?: SwcLoaderOptions) => DocumentManager;
 //#endregion
@@ -222,9 +259,11 @@ declare const createSchemaResolver: (config: ResolvedSodaGqlConfig) => Result<Sc
 //#region packages/lsp/src/server.d.ts
 type LspServerOptions = {
   readonly connection?: Connection;
+  readonly initializeParams?: InitializeParams;
 };
 declare const createLspServer: (options?: LspServerOptions) => {
   start: () => void;
+  initializeResult: InitializeResult<any> | undefined;
 };
 /** One-time SWC unavailable notification state. */
 type SwcNotificationState = {
@@ -233,5 +272,5 @@ type SwcNotificationState = {
 /** Check if SWC is unavailable and show a one-time error notification. */
 declare const checkSwcUnavailable: (swcUnavailable: boolean | undefined, state: SwcNotificationState, showError: (message: string) => void) => void;
 //#endregion
-export { type DocumentManager, type DocumentState, type ExtractedTemplate, type FragmentSpreadLocation, type IndexedFragment, type LspError, type LspErrorCode, type LspResult, type LspServerOptions, type OperationKind, type PositionMapper, type SchemaEntry, type SchemaResolver, createDocumentManager, createLspServer, createPositionMapper, createSchemaResolver, lspErrors, preprocessFragmentArgs };
+export { type DocumentManager, type DocumentState, type ExtractedTemplate, type FragmentSpreadLocation, type IndexedFragment, type LspError, type LspErrorCode, type LspResult, type LspServerOptions, type OperationKind, type PositionMapper, type SchemaEntry, type SchemaResolver, createDocumentManager, createLspServer, createPositionMapper, createSchemaResolver, lspErrors, preprocessFragmentArgs, runLspCli };
 //# sourceMappingURL=index.d.mts.map