@shanepadgett/tau-agent 0.33.0 → 0.34.0

package/src/ast/languages/fixtures/sample.swift.expected.json

@@ -0,0 +1,147 @@
+{
+	"languageId": "swift",
+	"parseDegraded": false,
+	"imports": [
+		"Foundation"
+	],
+	"decls": [
+		{
+			"kind": "class",
+			"qualifiedName": "Greeter",
+			"visibility": "public",
+			"exported": true,
+			"children": [
+				{
+					"kind": "property",
+					"qualifiedName": "Greeter.name",
+					"visibility": "public",
+					"exported": true,
+					"children": []
+				},
+				{
+					"kind": "constructor",
+					"qualifiedName": "Greeter.init",
+					"visibility": "public",
+					"exported": true,
+					"children": []
+				},
+				{
+					"kind": "constructor",
+					"qualifiedName": "Greeter.init",
+					"visibility": "public",
+					"exported": true,
+					"children": []
+				},
+				{
+					"kind": "method",
+					"qualifiedName": "Greeter.hello",
+					"visibility": "public",
+					"exported": true,
+					"children": []
+				},
+				{
+					"kind": "method",
+					"qualifiedName": "Greeter.deinit",
+					"visibility": "internal",
+					"exported": false,
+					"children": []
+				},
+				{
+					"kind": "method",
+					"qualifiedName": "Greeter.shout",
+					"visibility": "public",
+					"exported": true,
+					"children": []
+				}
+			]
+		},
+		{
+			"kind": "interface",
+			"qualifiedName": "Named",
+			"visibility": "public",
+			"exported": true,
+			"children": [
+				{
+					"kind": "property",
+					"qualifiedName": "Named.name",
+					"visibility": "internal",
+					"exported": false,
+					"children": []
+				},
+				{
+					"kind": "method",
+					"qualifiedName": "Named.nameLabel",
+					"visibility": "internal",
+					"exported": false,
+					"children": []
+				}
+			]
+		},
+		{
+			"kind": "struct",
+			"qualifiedName": "Box",
+			"visibility": "internal",
+			"exported": false,
+			"children": [
+				{
+					"kind": "property",
+					"qualifiedName": "Box.value",
+					"visibility": "internal",
+					"exported": false,
+					"children": []
+				}
+			]
+		},
+		{
+			"kind": "enum",
+			"qualifiedName": "Color",
+			"visibility": "private",
+			"exported": false,
+			"children": [
+				{
+					"kind": "enumMember",
+					"qualifiedName": "Color.red",
+					"visibility": "public",
+					"exported": true,
+					"children": []
+				},
+				{
+					"kind": "enumMember",
+					"qualifiedName": "Color.green",
+					"visibility": "public",
+					"exported": true,
+					"children": []
+				}
+			]
+		},
+		{
+			"kind": "typeAlias",
+			"qualifiedName": "Alias",
+			"visibility": "public",
+			"exported": true,
+			"children": []
+		},
+		{
+			"kind": "enum",
+			"qualifiedName": "Result",
+			"visibility": "public",
+			"exported": true,
+			"children": [
+				{
+					"kind": "enumMember",
+					"qualifiedName": "Result.ok",
+					"visibility": "public",
+					"exported": true,
+					"children": []
+				},
+				{
+					"kind": "enumMember",
+					"qualifiedName": "Result.err",
+					"visibility": "public",
+					"exported": true,
+					"children": []
+				}
+			]
+		}
+	]
+}

package/src/ast/languages/fixtures/sample.ts

@@ -0,0 +1,45 @@
+import { readFile } from "node:fs/promises";
+import type { Reader } from "./types.ts";
+
+/** Priority QUEUE of pending work. */
+export class Queue implements Reader {
+	private size = 0;
+
+	constructor(public readonly name: string) {}
+
+	enqueue(item: string): void {
+		void item;
+		this.size += 1;
+	}
+
+	get length(): number {
+		return this.size;
+	}
+}
+
+export abstract class BaseStore {
+	abstract load(): Promise<string>;
+}
+
+export interface Reader {
+	length: number;
+}
+
+export type OutlineRow = { depth: number; name: string };
+
+export enum Color {
+	Red = "red",
+	Green = "green",
+}
+
+export const MAX = 10;
+
+export function outlinePath(): void {}
+
+export namespace Nested {
+	export function inner(): number {
+		return 1;
+	}
+}
+
+function hidden(): void {}

package/src/ast/languages/fixtures/sample.ts.expected.json

@@ -0,0 +1,141 @@
+{
+	"languageId": "typescript",
+	"parseDegraded": false,
+	"imports": [
+		"node:fs/promises",
+		"./types.ts"
+	],
+	"decls": [
+		{
+			"kind": "class",
+			"qualifiedName": "Queue",
+			"visibility": "public",
+			"exported": true,
+			"children": [
+				{
+					"kind": "field",
+					"qualifiedName": "Queue.size",
+					"visibility": "private",
+					"exported": false,
+					"children": []
+				},
+				{
+					"kind": "constructor",
+					"qualifiedName": "Queue.constructor",
+					"visibility": "public",
+					"exported": false,
+					"children": []
+				},
+				{
+					"kind": "method",
+					"qualifiedName": "Queue.enqueue",
+					"visibility": "public",
+					"exported": false,
+					"children": []
+				},
+				{
+					"kind": "method",
+					"qualifiedName": "Queue.length",
+					"visibility": "public",
+					"exported": false,
+					"children": []
+				}
+			]
+		},
+		{
+			"kind": "class",
+			"qualifiedName": "BaseStore",
+			"visibility": "public",
+			"exported": true,
+			"children": [
+				{
+					"kind": "method",
+					"qualifiedName": "BaseStore.load",
+					"visibility": "public",
+					"exported": false,
+					"children": []
+				}
+			]
+		},
+		{
+			"kind": "interface",
+			"qualifiedName": "Reader",
+			"visibility": "public",
+			"exported": true,
+			"children": [
+				{
+					"kind": "property",
+					"qualifiedName": "Reader.length",
+					"visibility": "public",
+					"exported": false,
+					"children": []
+				}
+			]
+		},
+		{
+			"kind": "typeAlias",
+			"qualifiedName": "OutlineRow",
+			"visibility": "public",
+			"exported": true,
+			"children": []
+		},
+		{
+			"kind": "enum",
+			"qualifiedName": "Color",
+			"visibility": "public",
+			"exported": true,
+			"children": [
+				{
+					"kind": "enumMember",
+					"qualifiedName": "Color.Red",
+					"visibility": "public",
+					"exported": false,
+					"children": []
+				},
+				{
+					"kind": "enumMember",
+					"qualifiedName": "Color.Green",
+					"visibility": "public",
+					"exported": false,
+					"children": []
+				}
+			]
+		},
+		{
+			"kind": "constant",
+			"qualifiedName": "MAX",
+			"visibility": "public",
+			"exported": true,
+			"children": []
+		},
+		{
+			"kind": "function",
+			"qualifiedName": "outlinePath",
+			"visibility": "public",
+			"exported": true,
+			"children": []
+		},
+		{
+			"kind": "namespace",
+			"qualifiedName": "Nested",
+			"visibility": "public",
+			"exported": true,
+			"children": [
+				{
+					"kind": "function",
+					"qualifiedName": "Nested.inner",
+					"visibility": "public",
+					"exported": true,
+					"children": []
+				}
+			]
+		},
+		{
+			"kind": "function",
+			"qualifiedName": "hidden",
+			"visibility": "public",
+			"exported": false,
+			"children": []
+		}
+	]
+}

package/src/ast/languages/fixtures/sample.tsx

@@ -0,0 +1,36 @@
+import type { ReactNode } from "react";
+
+export type Props = {
+	name: string;
+	children?: ReactNode;
+};
+
+/** Landing page shell. */
+export function CatalogLanding({ name, children }: Props) {
+	return (
+		<main className="catalog">
+			<h1>{name}</h1>
+			{children}
+		</main>
+	);
+}
+
+export const STATE: Readonly<Record<string, string>> = {
+	draft: "Draft",
+	delivery: "Delivery",
+};
+
+export const CatalogPage = define.page(async function CatalogPage({ state }) {
+	const catalog = await loadCatalog(state);
+	return <main>{catalog.name}</main>;
+});
+
+export default function DefaultPage() {
+	return <CatalogLanding name="home" />;
+}
+
+class PrivateWidget {
+	render() {
+		return <span />;
+	}
+}

package/src/ast/languages/fixtures/sample.tsx.expected.json

@@ -0,0 +1,59 @@
+{
+	"languageId": "tsx",
+	"parseDegraded": false,
+	"imports": [
+		"react"
+	],
+	"decls": [
+		{
+			"kind": "typeAlias",
+			"qualifiedName": "Props",
+			"visibility": "public",
+			"exported": true,
+			"children": []
+		},
+		{
+			"kind": "function",
+			"qualifiedName": "CatalogLanding",
+			"visibility": "public",
+			"exported": true,
+			"children": []
+		},
+		{
+			"kind": "object",
+			"qualifiedName": "STATE",
+			"visibility": "public",
+			"exported": true,
+			"children": []
+		},
+		{
+			"kind": "constant",
+			"qualifiedName": "CatalogPage",
+			"visibility": "public",
+			"exported": true,
+			"children": []
+		},
+		{
+			"kind": "function",
+			"qualifiedName": "DefaultPage",
+			"visibility": "public",
+			"exported": true,
+			"children": []
+		},
+		{
+			"kind": "class",
+			"qualifiedName": "PrivateWidget",
+			"visibility": "public",
+			"exported": false,
+			"children": [
+				{
+					"kind": "method",
+					"qualifiedName": "PrivateWidget.render",
+					"visibility": "public",
+					"exported": false,
+					"children": []
+				}
+			]
+		}
+	]
+}

package/{extensions/explore → src}/ast/languages/go-file-deps.ts

@@ -92,6 +92,12 @@ function firstPathElement(specifier: string): string {
 	return slash === -1 ? specifier : specifier.slice(0, slash);
 }
 
+/**
+ * Build constraints are not evaluated: a package resolves to every `.go` file in
+ * its directory, so mutually exclusive `//go:build` variants all appear. Every
+ * branch is reported on purpose — a per-configuration graph would need a build
+ * context this layer does not have.
+ */
 export const resolveGoFileDep: FileDepResolver = async (fromPath, specifier, host, signal) => {
 	signal.throwIfAborted();
 	const trimmed = specifier.trim().replace(/^"+|"+$/g, "");

package/{extensions/explore → src}/ast/languages/go.ts

@@ -23,6 +23,7 @@ const CAPABILITIES: LanguageCapabilities = {
 	fileDeps: true,
 	callEdges: true,
 	packageSurface: false,
+	structuralImplements: true,
 };
 
 const IMPORT_NOISE = new Set([
@@ -89,6 +90,7 @@ const INTERFACE_TYPE = "interface_type";
 const FIELD_DECLARATION_LIST = "field_declaration_list";
 const FIELD_DECLARATION = "field_declaration";
 const METHOD_ELEM = "method_elem";
+const TYPE_ELEM = "type_elem";
 const CALL_EXPRESSION = "call_expression";
 const COMPOSITE_LITERAL = "composite_literal";
 const SELECTOR_EXPRESSION = "selector_expression";
@@ -171,7 +173,8 @@ function goExported(name: string): boolean {
 }
 
 function visibilityFor(name: string): Visibility {
-	return goExported(name) ? "public" : "private";
+	// Go has no file-private level: lowercase is package-visible, the analogue of pub(crate).
+	return goExported(name) ? "public" : "internal";
 }
 
 function receiverTypeName(receiver: Node): string {
@@ -257,6 +260,20 @@ function interfaceMethods(iface: Node, owner: string): Decl[] {
 	return out;
 }
 
+/** Embedded interface names in an interface body (`type_elem` children). */
+function interfaceEmbeds(iface: Node): string[] {
+	const out: string[] = [];
+	for (const node of iface.namedChildren) {
+		if (node.type !== TYPE_ELEM) continue;
+		const text = node.text.trim();
+		// Type sets (`~int | string`) are constraints, not embedded interfaces.
+		if (text.includes("|") || text.startsWith("~")) continue;
+		const bare = text.includes(".") ? (text.split(".").pop() ?? text) : text;
+		if (/^[A-Za-z_]\w*$/u.test(bare)) out.push(bare);
+	}
+	return out;
+}
+
 function declsFromTypeSpec(spec: Node, span: Node, doc: DocSpan | undefined): Decl[] {
 	const name = nameText(field(spec, "name"));
 	if (name.length === 0) return [];
@@ -292,7 +309,8 @@ function declsFromTypeSpec(spec: Node, span: Node, doc: DocSpan | undefined): De
 					exported: goExported(name),
 					children: interfaceMethods(typeNode, name),
 					calls: [],
-					bases: [],
+					// Embedded interfaces are heritage: `implementations` follows them.
+					bases: interfaceEmbeds(typeNode),
 				},
 				doc,
 			);
@@ -522,7 +540,7 @@ function extractGo(tree: Tree, source: string): ExtractResult {
 	for (const node of root.children) {
 		if (node.isNamed || node.isError) extractFromNode(node, source, decls);
 	}
-	return { decls, imports: collectImports(root) };
+	return { decls, imports: collectImports(root), fileCalls: extractCalls(root) };
 }
 
 /** Bare `pkg.Call($A)` parses as type_conversion in Go; wrap as a statement call. */

package/{extensions/explore → src}/ast/languages/java.ts

@@ -3,17 +3,15 @@ import type { ExtractResult, GrammarAdapter, LanguageCapabilities } from "../ada
 import { resolveJavaFileDep } from "./jvm-file-deps.ts";
 import type { CallSite, Decl, ImportRef, Visibility } from "../ir.ts";
 import {
-	applyDoc,
 	callSite,
+	type DocSpan,
 	docSpanBefore,
-	endLine,
 	field,
-	finishDecl,
+	createLeafBuilder,
 	nameText,
 	qualify,
 	startLine,
 	walkBodyNodes,
-	type DocSpan,
 } from "./tree.ts";
 
 const CAPABILITIES: LanguageCapabilities = {
@@ -22,6 +20,7 @@ const CAPABILITIES: LanguageCapabilities = {
 	fileDeps: true,
 	callEdges: true,
 	packageSurface: false,
+	structuralImplements: false,
 };
 
 const IMPORT_NOISE = new Set([
@@ -218,39 +217,7 @@ function nameOf(node: Node): string {
 	return nameText(field(node, "name"));
 }
 
-function leaf(
-	node: Node,
-	owner: string,
-	kind: Decl["kind"],
-	name: string,
-	visibility: Visibility,
-	body: Node | null,
-	children: Decl[],
-	doc: DocSpan | undefined,
-): Decl | undefined {
-	if (name.length === 0) return undefined;
-	const callable = kind === "function" || kind === "method" || kind === "constructor";
-	const typeLike = kind === "class" || kind === "interface" || kind === "enum" || kind === "struct";
-	const decl = finishDecl(
-		{
-			kind,
-			name,
-			qualifiedName: qualify(owner, name),
-			startLine: startLine(node),
-			endLine: endLine(node),
-			startOffset: node.startIndex,
-			endOffset: node.endIndex,
-			visibility,
-			exported: visibility === "public",
-			children,
-			calls: callable ? extractCalls(body) : [],
-			bases: typeLike ? heritageBases(node) : [],
-		},
-		body,
-	);
-	if (body === null) decl.signatureEndOffset = node.endIndex;
-	return applyDoc(decl, doc);
-}
+const leaf = createLeafBuilder(extractCalls, heritageBases);
 
 function declaratorNames(node: Node): string[] {
 	const names: string[] = [];
@@ -396,7 +363,7 @@ function extractJava(tree: Tree, source: string): ExtractResult {
 	for (const node of root.children) {
 		if (node.isNamed || node.isError) decls.push(...declsFromNode(node, "", source, "internal"));
 	}
-	return { decls, imports: collectImports(root) };
+	return { decls, imports: collectImports(root), fileCalls: extractCalls(root) };
 }
 
 export function javaAdapter(): GrammarAdapter {