opencode-swarm 7.90.1 → 7.91.0

package/dist/lang/registry.d.ts

@@ -1,4 +1,4 @@
-import { type Parser } from './runtime';
+import type { Parser } from './runtime';
 export declare const _internals: {
     getLanguageForExtension: typeof getLanguageForExtension;
     listSupportedLanguages: typeof listSupportedLanguages;

package/dist/lang/symbol-graph.d.ts

@@ -0,0 +1,43 @@
+export interface FileSymbolFacts {
+    defs: Array<{
+        name: string;
+        kind: 'function' | 'class' | 'const' | 'type' | 'interface' | 'enum' | 'method';
+        exported: boolean;
+        startLine: number;
+        endLine: number;
+    }>;
+    imports: Array<{
+        specifier: string;
+        importType: 'commonjs' | 'named' | 'namespace' | 'default';
+        bindings: Array<{
+            imported: string;
+            local: string;
+        }>;
+    }>;
+    refs: Array<{
+        identifier: string;
+        line: number;
+        enclosingDecl: string | null;
+    }>;
+}
+/**
+ * Extract symbol, import, and reference facts from a source string using
+ * tree-sitter.
+ *
+ * Fail-open: returns null on grammar-load failure, timeout, or parse error.
+ * The 500 ms `AST_TIMEOUT_MS` race bounds the async `loadGrammar` WASM load
+ * and races the parse attempt, but cannot hard-interrupt a synchronous
+ * `parser.parse()` once it begins (mirrors the `computeASTDiff` pattern in
+ * `src/diff/ast-diff.ts`). The primary async risk (WASM grammar load) IS
+ * bounded.
+ *
+ * The parsed tree is always deleted: the inner async IIFE owns tree cleanup
+ * via its own `finally` block (deletes the tree after `buildFacts` regardless
+ * of whether the outer race rejects on timeout). Tree cleanup is handled
+ * solely by that inner `finally`; there is no outer backstop.
+ *
+ * @param grammarId - Tree-sitter grammar id (e.g. 'typescript')
+ * @param source - Source code text
+ * @returns FileSymbolFacts, or null on failure
+ */
+export declare function extractFileSymbols(grammarId: string, source: string): Promise<FileSymbolFacts | null>;

package/dist/tools/repo-graph/builder.d.ts

@@ -10,10 +10,11 @@
  * Also exports upsertNode, addEdge, and resolveModuleSpecifier which are
  * used by both the builder and the incremental updater.
  */
+import { extractFileSymbols } from '../../lang/symbol-graph';
 import { extractPythonSymbols, extractTSSymbols } from '../symbols';
 import { extractFileOntology } from './ontology';
 import { safeRealpathSync } from './safe-realpath';
-import type { BuildWorkspaceGraphOptions, GraphEdge, GraphNode, RepoGraph } from './types';
+import type { BuildWorkspaceGraphOptions, GraphEdge, GraphNode, RepoGraph, SymbolEdge } from './types';
 /**
  * _internals DI seam for safeRealpathSync.
  * Defaults to the real implementation. Tests can override this to inject
@@ -28,6 +29,7 @@ export declare const _internals: {
     extractFileOntology: typeof extractFileOntology;
     stripComments: typeof stripComments;
     computeUsedSymbols: typeof computeUsedSymbols;
+    extractFileSymbols: typeof extractFileSymbols;
 };
 /**
  * Add or update a node in the graph.
@@ -130,6 +132,16 @@ export interface ScanResult {
     /** The edges created from this file's imports */
     edges: GraphEdge[];
 }
+/**
+ * Result of the async single-file scanner. Extends ScanResult with
+ * symbol-level reference edges produced by tree-sitter symbol extraction.
+ */
+export interface AsyncScanResult {
+    node: GraphNode | null;
+    edges: GraphEdge[];
+    /** Symbol-to-symbol reference edges (schema >= 1.2.0). */
+    symbolEdges: SymbolEdge[];
+}
 /**
  * Scan a single file and extract its graph node and edges.
  * Reuses the same logic from buildWorkspaceGraph for consistency.
@@ -140,6 +152,23 @@ export interface ScanResult {
  * @returns ScanResult with node and edges
  */
 export declare function scanFile(filePath: string, absoluteRoot: string, maxFileSize: number): ScanResult;
+/**
+ * Async variant of scanFile that uses tree-sitter symbol extraction
+ * (extractFileSymbols) to populate exportRanges and symbolEdges.
+ *
+ * Fail-open: if extractFileSymbols returns null (grammar unavailable,
+ * timeout, parse error), falls back to a minimal file-level node with
+ * empty exports/imports/symbolEdges — never throws.
+ *
+ * Oversized, binary, or unreadable files return { node: null, edges: [], symbolEdges: [] }
+ * matching the sync scanFile contract.
+ *
+ * @param filePath - Absolute path to the file to scan
+ * @param absoluteRoot - Absolute path to workspace root
+ * @param maxFileSize - Maximum file size in bytes
+ * @returns AsyncScanResult with node, edges, and symbolEdges
+ */
+export declare function scanFileAsync(filePath: string, absoluteRoot: string, maxFileSize: number): Promise<AsyncScanResult>;
 /**
  * Build a complete dependency graph for a workspace by scanning all source files.
  *

package/dist/tools/repo-graph/query.d.ts

@@ -1,4 +1,4 @@
-import type { BlastRadiusResult, CallerReference, DeadExportsResult, FileOntology, FileReference, GraphNode, LocalizationBlock, PackageBoundarySummary, RepoGraph, SymbolReference } from './types';
+import type { BlastRadiusResult, CallerReference, ContextPackResult, DeadExportsResult, FileOntology, FileReference, GraphNode, LocalizationBlock, PackageBoundarySummary, RepoGraph, SymbolReference } from './types';
 export declare function getGraphNode(graph: RepoGraph, input: string): GraphNode | undefined;
 export declare function resetQueryCache(): void;
 export declare function isGraphFresh(graph: RepoGraph | null, maxAgeMs?: number): boolean;
@@ -38,6 +38,10 @@ export declare function getLocalizationContext(graph: RepoGraph, filePath: strin
     maxDeps?: number;
     maxDepth?: number;
 }): LocalizationBlock;
+export declare function getContextPack(graph: RepoGraph, file: string, symbol: string, options?: {
+    maxDepth?: number;
+    maxTokens?: number;
+}): ContextPackResult;
 export declare function getPackageBoundaries(graph: RepoGraph, topN?: number): PackageBoundarySummary[];
 export declare function buildOntologyPreflightPacket(graph: RepoGraph, filePaths?: string[], options?: {
     maxFiles?: number;

package/dist/tools/repo-graph/types.d.ts

@@ -16,8 +16,14 @@ export declare const REPO_GRAPH_FILENAME = "repo-graph.json";
  * versions (1.0.0) still load — but `dead_exports` requires >= 1.1.0 data and
  * self-gates via {@link isSchemaVersionAtLeast} rather than relying on the
  * loader (which only checks that a version string is present, not its value).
+ *
+ * 1.2.0 adds per-node `exportRanges` (1-based inclusive line spans for each
+ * exported symbol) and the top-level `symbolEdges` array (direct symbol-to-
+ * symbol reference edges). Both fields are optional, so 1.0.0 and 1.1.0 graphs
+ * still load without corruption. New queries may use these fields to provide
+ * more precise context-packing and symbol-level navigation.
  */
-export declare const GRAPH_SCHEMA_VERSION = "1.1.0";
+export declare const GRAPH_SCHEMA_VERSION = "1.2.0";
 /**
  * Compare dotted numeric version strings (e.g. '1.1.0' >= '1.1.0').
  * Missing/non-numeric segments are treated as 0. Returns true when `version`
@@ -96,6 +102,17 @@ export interface GraphNode {
      * `dead_exports` candidates at a location.
      */
     exportLines?: Record<string, number>;
+    /**
+     * 1-based inclusive line span for each exported symbol, keyed by symbol
+     * name. Present on graphs built at schema >= 1.2.0; absent on older
+     * graphs. Used for precise context-packing around a symbol.
+     * Each span value uses `startLine` / `endLine` to match the codebase
+     * convention (see `ContextPackSpan` and `FileSymbolFacts`).
+     */
+    exportRanges?: Record<string, {
+        startLine: number;
+        endLine: number;
+    }>;
     /** Imported module specifiers */
     imports: string[];
     /** Language/extension of the file */
@@ -140,6 +157,56 @@ export interface SymbolReference {
     line?: number;
     importedAs: string;
 }
+/**
+ * A symbol-level reference edge: one exported symbol in one file directly
+ * references (calls / uses) an exported symbol in another file.
+ *
+ * Present in graphs built at schema >= 1.2.0. These edges are finer-grained
+ * than {@link GraphEdge} (which tracks file-level imports) and enable
+ * precise context-packing and symbol navigation queries.
+ */
+export interface SymbolEdge {
+    /** Resolved absolute path of the source file (matches `GraphNode.filePath` keys). */
+    fromFile: string;
+    /** Enclosing top-level declaration in the source file, or `'<module>'` for module-scope references. */
+    fromSymbol: string;
+    /** Resolved absolute path of the target file. */
+    toFile: string;
+    /** Exported symbol referenced in the target file. */
+    toSymbol: string;
+}
+/**
+ * A contiguous line span inside a source file, used by context-packing to
+ * extract the relevant region around a symbol without reading the whole file.
+ */
+export interface ContextPackSpan {
+    file: string;
+    symbol: string;
+    startLine: number;
+    endLine: number;
+    mode: 'full' | 'signature';
+}
+/**
+ * Result of a context-pack query: the set of spans needed to understand
+ * how a target symbol is used across the workspace.
+ */
+export interface ContextPackResult {
+    /** False when the graph predates schema 1.2.0 (rebuild required for full results). */
+    schemaSupported: boolean;
+    /** The symbol whose usage context was requested. */
+    target: {
+        file: string;
+        symbol: string;
+    };
+    /** Deduped, budget-ordered spans covering usage sites. */
+    spans: ContextPackSpan[];
+    /** True when the span budget was exhausted before all sites could be returned. */
+    truncated: boolean;
+    /** Rough token estimate for the returned spans (sum of span sizes × a fixed multiplier). */
+    estimatedTokens: number;
+    /** Optional human-readable note about scope or limitations. */
+    note?: string;
+}
 /**
  * A file that references a specific exported symbol of a target file.
  * `resolution` records how confidently the usage was attributed:
@@ -230,6 +297,8 @@ export interface RepoGraph {
         nodeCount: number;
         edgeCount: number;
     };
+    /** Symbol-level reference edges (schema >= 1.2.0; absent on older graphs). */
+    symbolEdges?: SymbolEdge[];
 }
 /**
  * Options for building a workspace graph.

package/dist/tools/repo-graph.d.ts

@@ -21,8 +21,8 @@ export { updateGraphForFiles } from './repo-graph/incremental';
 export type { ExtractFileOntologyInput } from './repo-graph/ontology';
 export { extractFileOntology } from './repo-graph/ontology';
 export type { DeadExportsOptions } from './repo-graph/query';
-export { buildOntologyPreflightPacket, getBlastRadius, getCallers, getDeadExports, getDependencies, getFileOntology, getGraphNode, getImporters, getKeyFiles, getLocalizationContext, getPackageBoundaries, getSymbolConsumers, isGraphFresh, resetQueryCache, } from './repo-graph/query';
+export { buildOntologyPreflightPacket, getBlastRadius, getCallers, getContextPack, getDeadExports, getDependencies, getFileOntology, getGraphNode, getImporters, getKeyFiles, getLocalizationContext, getPackageBoundaries, getSymbolConsumers, isGraphFresh, resetQueryCache, } from './repo-graph/query';
 export { getGraphPath, loadGraph, loadGraphSync, loadOrCreateGraph, saveGraph, saveIfDirty, } from './repo-graph/storage';
-export type { BlastRadiusResult, BuildWorkspaceGraphOptions, CallerReference, ConventionFact, DataOperationFact, DeadExportCandidate, DeadExportsResult, FileOntology, FileReference, FileRole, GraphEdge, GraphNode, LocalizationBlock, OntologyFinding, PackageBoundarySummary, RepoGraph, RouteFact, RouteMethod, SecurityFact, SymbolReference, } from './repo-graph/types';
+export type { BlastRadiusResult, BuildWorkspaceGraphOptions, CallerReference, ContextPackResult, ContextPackSpan, ConventionFact, DataOperationFact, DeadExportCandidate, DeadExportsResult, FileOntology, FileReference, FileRole, GraphEdge, GraphNode, LocalizationBlock, OntologyFinding, PackageBoundarySummary, RepoGraph, RouteFact, RouteMethod, SecurityFact, SymbolEdge, SymbolReference, } from './repo-graph/types';
 export { createEmptyGraph, GRAPH_SCHEMA_VERSION, isSchemaVersionAtLeast, normalizeGraphPath, REPO_GRAPH_FILENAME, updateGraphMetadata, } from './repo-graph/types';
 export { validateGraphEdge, validateGraphNode, validateWorkspace, } from './repo-graph/validation';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.90.1",
+	"version": "7.91.0",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -71,7 +71,7 @@
 	],
 	"scripts": {
 		"clean": "bun -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
-		"build": "bun run clean && bun run scripts/copy-grammars.ts && bun build src/index.ts --outdir dist --target node --format esm && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm --external bash-parser --splitting && bun run scripts/copy-grammars.ts --to-dist && tsc --emitDeclarationOnly",
+		"build": "bun run clean && bun run scripts/copy-grammars.ts && bun build src/index.ts --outdir dist --target node --format esm --external web-tree-sitter && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm --external bash-parser --splitting && bun run scripts/copy-grammars.ts --to-dist && tsc --emitDeclarationOnly",
 		"typecheck": "tsc --noEmit",
 		"test": "bun test",
 		"lint": "biome lint .",