@compilr-dev/agents-coding-go 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 scozzola
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @compilr-dev/agents-coding-go
+ *
+ * Go analysis tools for AI agents.
+ * AST-based code analysis using Tree-sitter.
+ */
+export * from "./parser/index.js";
+export * from "./tools/index.js";
+export * from "./skills/index.js";
+import { allGoTools } from "./tools/index.js";
+import { goSkills, goSkillsMap, goBestPracticesSkill, goCodeHealthSkill, goCodeStructureSkill, goDependencyAuditSkill, goRefactorImpactSkill } from "./skills/index.js";
+/**
+ * All Go analysis tools (named exports)
+ */
+export declare const goTools: {
+    readonly getFileStructure: import("@compilr-dev/agents").Tool<import("./tools/get-file-structure.js").GetFileStructureInput>;
+    readonly findSymbol: import("@compilr-dev/agents").Tool<import("./tools/find-symbol.js").FindSymbolInput>;
+    readonly findReferences: import("@compilr-dev/agents").Tool<import("./tools/find-references.js").FindReferencesInput>;
+    readonly getImports: import("@compilr-dev/agents").Tool<import("./tools/get-imports.js").GetImportsInput>;
+    readonly getClassHierarchy: import("@compilr-dev/agents").Tool<import("./tools/get-class-hierarchy.js").GetClassHierarchyInput>;
+    readonly getComplexity: import("@compilr-dev/agents").Tool<import("./tools/get-complexity.js").GetComplexityInput>;
+    readonly extractDocstrings: import("@compilr-dev/agents").Tool<import("./tools/extract-docstrings.js").ExtractDocstringsInput>;
+    readonly findDeadCode: import("@compilr-dev/agents").Tool<import("./tools/find-dead-code.js").FindDeadCodeInput>;
+    readonly findDuplicates: import("@compilr-dev/agents").Tool<import("./tools/find-duplicates.js").FindDuplicatesInput>;
+    readonly findImplementations: import("@compilr-dev/agents").Tool<import("./tools/find-implementations.js").FindImplementationsInput>;
+    readonly findPatterns: import("@compilr-dev/agents").Tool<import("./tools/find-patterns.js").FindPatternsInput>;
+    readonly getCallGraph: import("@compilr-dev/agents").Tool<import("./tools/get-call-graph.js").GetCallGraphInput>;
+    readonly getDependencyGraph: import("@compilr-dev/agents").Tool<import("./tools/get-dependency-graph.js").GetDependencyGraphInput>;
+    readonly getSignature: import("@compilr-dev/agents").Tool<import("./tools/get-signature.js").GetSignatureInput>;
+    readonly getExports: import("@compilr-dev/agents").Tool<import("./tools/get-exports.js").GetExportsInput>;
+};
+/**
+ * Array of all Go tools
+ */
+export { allGoTools };
+/**
+ * All Go skills
+ */
+export { goSkills, goSkillsMap, goBestPracticesSkill, goCodeHealthSkill, goCodeStructureSkill, goDependencyAuditSkill, goRefactorImpactSkill, };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,UAAU,EAAc,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,QAAQ,EACR,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;CAAa,CAAC;AAElC;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB;;GAEG;AACH,OAAO,EACL,QAAQ,EACR,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @compilr-dev/agents-coding-go
+ *
+ * Go analysis tools for AI agents.
+ * AST-based code analysis using Tree-sitter.
+ */
+// Parser
+export * from "./parser/index.js";
+// Tools
+export * from "./tools/index.js";
+// Skills
+export * from "./skills/index.js";
+// Re-export commonly used items at top level
+import { allGoTools, goToolsMap } from "./tools/index.js";
+import { goSkills, goSkillsMap, goBestPracticesSkill, goCodeHealthSkill, goCodeStructureSkill, goDependencyAuditSkill, goRefactorImpactSkill, } from "./skills/index.js";
+/**
+ * All Go analysis tools (named exports)
+ */
+export const goTools = goToolsMap;
+/**
+ * Array of all Go tools
+ */
+export { allGoTools };
+/**
+ * All Go skills
+ */
+export { goSkills, goSkillsMap, goBestPracticesSkill, goCodeHealthSkill, goCodeStructureSkill, goDependencyAuditSkill, goRefactorImpactSkill, };

package/dist/parser/go-parser.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Go Parser using Tree-sitter
+ *
+ * Provides AST parsing and traversal for Go source files.
+ */
+import Parser from "tree-sitter";
+import type { ClassInfo, FunctionInfo, MethodInfo, VariableInfo, ImportInfo, ParameterInfo } from "./node-types.js";
+/**
+ * Parse result containing the tree and source
+ */
+export interface ParseResult {
+    tree: Parser.Tree;
+    source: string;
+    hasErrors: boolean;
+    errors: ParseError[];
+}
+/**
+ * Parse error information
+ */
+export interface ParseError {
+    message: string;
+    line: number;
+    column: number;
+}
+/**
+ * Parse Go source code
+ */
+export declare function parseSource(source: string): ParseResult;
+/**
+ * Parse Go file
+ */
+export declare function parseFile(path: string): Promise<ParseResult>;
+/**
+ * Get text from a node
+ */
+export declare function getNodeText(node: Parser.SyntaxNode, source: string): string;
+/**
+ * Extract doc comment from above a declaration
+ * Go uses line comments (//) or block comments before declarations
+ */
+export declare function extractDocComment(node: Parser.SyntaxNode, source: string): string | undefined;
+/**
+ * Check if a name is exported (starts with uppercase)
+ */
+export declare function isExported(name: string): boolean;
+/**
+ * Parse function parameters
+ */
+export declare function parseParameters(node: Parser.SyntaxNode, source: string): ParameterInfo[];
+/**
+ * Parse return types (Go supports multiple return values)
+ */
+export declare function parseReturnTypes(node: Parser.SyntaxNode, source: string): string | undefined;
+/**
+ * Parse a function declaration
+ */
+export declare function parseFunction(node: Parser.SyntaxNode, source: string): FunctionInfo;
+/**
+ * Parse a method declaration (function with receiver)
+ */
+export declare function parseMethod(node: Parser.SyntaxNode, source: string): MethodInfo;
+/**
+ * Parse a type declaration (struct or interface)
+ * We treat these as "classes" for compatibility with the tool interface
+ */
+export declare function parseClass(node: Parser.SyntaxNode, source: string): ClassInfo;
+/**
+ * Parse import declaration
+ */
+export declare function parseImport(node: Parser.SyntaxNode, source: string): ImportInfo[];
+/**
+ * Parse variable/constant declaration
+ */
+export declare function parseVariable(node: Parser.SyntaxNode, source: string): VariableInfo[];
+/**
+ * Get package name from source file
+ */
+export declare function getPackageName(tree: Parser.Tree, source: string): string | undefined;
+/**
+ * Walk the AST and collect all nodes of given types
+ */
+export declare function walkTree(node: Parser.SyntaxNode, types?: string[]): Generator<Parser.SyntaxNode>;
+/**
+ * Find all nodes matching a predicate
+ */
+export declare function findNodes(node: Parser.SyntaxNode, predicate: (n: Parser.SyntaxNode) => boolean): Parser.SyntaxNode[];
+/**
+ * Get the containing scope for a node (function or type)
+ */
+export declare function getContainingScope(node: Parser.SyntaxNode): {
+    type: "function" | "class" | "module";
+    name: string;
+    node: Parser.SyntaxNode;
+} | null;
+/**
+ * Parse decorators - Go doesn't have decorators, returns empty array
+ * This is a compatibility function for tools that expect this export
+ */
+export declare function parseDecorators(_node: Parser.SyntaxNode, _source: string): string[];
+/**
+ * Alias for extractDocComment for compatibility with tools expecting Python-style docstring extraction
+ */
+export declare const extractDocstring: typeof extractDocComment;
+//# sourceMappingURL=go-parser.d.ts.map

package/dist/parser/go-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-parser.d.ts","sourceRoot":"","sources":["../../src/parser/go-parser.ts"],"names":[],"mappings":"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"}