opencode-swarm 7.151.0 → 7.152.0

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

@@ -271,7 +271,7 @@ export declare function scanFile(filePath: string, absoluteRoot: string, maxFile
  * @param maxFileSize - Maximum file size in bytes
  * @returns AsyncScanResult with node, edges, and symbolEdges
  */
-export declare function scanFileAsync(filePath: string, absoluteRoot: string, maxFileSize: number, hasManifest?: (relDir: string) => boolean): Promise<AsyncScanResult>;
+export declare function scanFileAsync(filePath: string, absoluteRoot: string, maxFileSize: number, hasManifest: ((relDir: string) => boolean) | undefined, repoRootId: string): Promise<AsyncScanResult>;
 /**
  * Build a complete dependency graph for a workspace by scanning all source files.
  *

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

@@ -0,0 +1,21 @@
+import { type SymbolEdge, type SymbolEdgeEvidence, type SymbolEdgeKind, type SymbolEdgeResolution, type SymbolIdentityKind } from './types';
+export declare const LOW_CONFIDENCE_SYMBOL_EDGE_THRESHOLD = 0.5;
+export declare const MAX_SYMBOL_EDGE_EVIDENCE = 16;
+declare const V2_KEYS: readonly ["id", "fromId", "toId", "kind", "confidence", "resolution", "evidence"];
+export declare function deriveRepoRootId(workspaceRoot: string): string;
+export declare function relativeSymbolPath(workspaceRoot: string, filePath: string): string;
+export declare function createStableSymbolId(repoRootId: string, relativePath: string, qualifiedName: string, identityKind: SymbolIdentityKind): string;
+export declare function createStableSymbolEdgeId(fromId: string, toId: string, kind: SymbolEdgeKind): string;
+export declare function hashSymbolEdgeSnippet(snippet: string): string;
+export declare function isCompleteSymbolEdge(edge: SymbolEdge): edge is SymbolEdge & Required<Pick<SymbolEdge, (typeof V2_KEYS)[number]>>;
+export declare function hasSymbolEdgeV2Fields(edge: SymbolEdge): boolean;
+export declare function mergeSymbolEdgeEvidence(left: readonly SymbolEdgeEvidence[], right: readonly SymbolEdgeEvidence[]): SymbolEdgeEvidence[];
+export declare function normalizeSymbolEdge(edge: SymbolEdge, workspaceRoot: string, repoRootId: string): SymbolEdge & Required<Pick<SymbolEdge, (typeof V2_KEYS)[number]>>;
+export declare function createSymbolEdgeV2(edge: Pick<SymbolEdge, 'fromFile' | 'fromSymbol' | 'toFile' | 'toSymbol'>, workspaceRoot: string, repoRootId: string, options: {
+    kind?: SymbolEdgeKind;
+    confidence: number;
+    resolution: SymbolEdgeResolution;
+    evidence: SymbolEdgeEvidence[];
+}): SymbolEdge;
+export declare function mergeSymbolEdges(left: SymbolEdge, right: SymbolEdge, workspaceRoot: string, repoRootId: string): SymbolEdge;
+export {};

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

@@ -43,8 +43,12 @@ export declare const REPO_GRAPH_FILENAME = "repo-graph.json";
  * source read. The content-freshness sidecar requires both witnesses before
  * it will certify a graph; older graphs remain readable but are intentionally
  * treated as needing a rebuild before certification.
+ *
+ * 1.5.0 adds an optional graph-level `repoRootId` plus additive SymbolEdge v2
+ * identity, kind, confidence, resolution, and evidence fields. Legacy 1.2.0
+ * four-coordinate symbol edges remain readable and are normalized in memory.
  */
-export declare const GRAPH_SCHEMA_VERSION = "1.4.0";
+export declare const GRAPH_SCHEMA_VERSION = "1.5.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`
@@ -228,6 +232,23 @@ export interface SymbolReference {
  * than {@link GraphEdge} (which tracks file-level imports) and enable
  * precise context-packing and symbol navigation queries.
  */
+export declare const SYMBOL_EDGE_KIND_VALUES: readonly ["CALLS", "REFERENCES", "USES_TYPE", "INSTANTIATES", "IMPLEMENTS", "OVERRIDES"];
+export type SymbolEdgeKind = (typeof SYMBOL_EDGE_KIND_VALUES)[number];
+export declare const SYMBOL_EDGE_RESOLUTION_VALUES: readonly ["exact", "import_binding", "same_file_scope", "unique_name", "type_resolved", "lsp", "scip", "heuristic", "unresolved"];
+export type SymbolEdgeResolution = (typeof SYMBOL_EDGE_RESOLUTION_VALUES)[number];
+export type SymbolIdentityKind = 'symbol' | 'module';
+export interface SymbolEdgeEvidence {
+    /** Workspace-relative source path; source text itself is never persisted. */
+    file: string;
+    /** 1-based source line. */
+    line: number;
+    /** Optional 1-based source column. */
+    column?: number;
+    /** SHA-256 of the NFC-normalized logical source line. */
+    snippetHash: string;
+    /** Extractor that produced the fact, for example `tree-sitter/typescript`. */
+    extractor: string;
+}
 export interface SymbolEdge {
     /** Resolved absolute path of the source file (matches `GraphNode.filePath` keys). */
     fromFile: string;
@@ -237,6 +258,20 @@ export interface SymbolEdge {
     toFile: string;
     /** Exported symbol referenced in the target file. */
     toSymbol: string;
+    /** Stable SHA-256 identity of this edge (schema >= 1.5.0). */
+    id?: string;
+    /** Stable SHA-256 identity of the source symbol. */
+    fromId?: string;
+    /** Stable SHA-256 identity of the target symbol. */
+    toId?: string;
+    /** Relationship kind. Current tree-sitter extraction emits REFERENCES. */
+    kind?: SymbolEdgeKind;
+    /** Advisory confidence in the inclusive range 0..1. */
+    confidence?: number;
+    /** How the relationship was resolved. */
+    resolution?: SymbolEdgeResolution;
+    /** Bounded provenance records. Empty only when no honest location exists. */
+    evidence?: SymbolEdgeEvidence[];
 }
 /**
  * A contiguous line span inside a source file, used by context-packing to
@@ -396,6 +431,7 @@ export interface GraphHealthResult {
     unreadableFiles: string[];
     validationSkippedFiles: string[];
     lowConfidenceEdgeCount: number;
+    unresolvedSymbolEdgeCount: number;
     walkTruncated: boolean;
     walkTruncationReason: 'budget' | 'cap' | null;
     incrementalFallbacks: number;
@@ -441,6 +477,8 @@ export interface RepoGraph {
     schema_version: string;
     /** Workspace root directory */
     workspaceRoot: string;
+    /** Root-independent repository label used to scope stable symbol IDs. */
+    repoRootId?: string;
     /** Graph nodes keyed by resolved file path */
     nodes: Record<string, GraphNode>;
     /** Graph edges representing dependencies */

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

@@ -26,6 +26,6 @@ export { extractFileOntology } from './repo-graph/ontology';
 export type { DeadExportsOptions } from './repo-graph/query';
 export { buildOntologyPreflightPacket, getBlastRadius, getCallers, getContextPack, getDeadExports, getDependencies, getFileOntology, getGraphHealth, 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 { AskHit, AskOptions, AskResult, BlastRadiusResult, BuildWorkspaceGraphOptions, CallerReference, ContextPackResult, ContextPackSpan, ConventionFact, DataOperationFact, DeadExportCandidate, DeadExportsResult, FileOntology, FileReference, FileRole, FreshnessProbeState, GraphEdge, GraphExtractionFailure, GraphExtractorInputWitness, GraphHealthResult, GraphNode, GraphUnresolvedImport, LocalizationBlock, OntologyFinding, PackageBoundarySummary, RepoGraph, RepoGraphDiagnostics, RouteFact, RouteMethod, SecurityFact, SymbolEdge, SymbolReference, } from './repo-graph/types';
+export type { AskHit, AskOptions, AskResult, BlastRadiusResult, BuildWorkspaceGraphOptions, CallerReference, ContextPackResult, ContextPackSpan, ConventionFact, DataOperationFact, DeadExportCandidate, DeadExportsResult, FileOntology, FileReference, FileRole, FreshnessProbeState, GraphEdge, GraphExtractionFailure, GraphExtractorInputWitness, GraphHealthResult, GraphNode, GraphUnresolvedImport, LocalizationBlock, OntologyFinding, PackageBoundarySummary, RepoGraph, RepoGraphDiagnostics, RouteFact, RouteMethod, SecurityFact, SymbolEdge, SymbolEdgeEvidence, SymbolEdgeKind, SymbolEdgeResolution, SymbolIdentityKind, SymbolReference, } from './repo-graph/types';
 export { createEmptyGraph, GRAPH_SCHEMA_VERSION, inferPackageBoundary, 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.151.0",
+	"version": "7.152.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",