@swarmvaultai/engine 3.7.3 → 3.9.0

package/dist/index.d.ts

@@ -905,6 +905,25 @@ interface GraphStatsResult {
     edgeRelations: Record<string, number>;
     hyperedgeRelations: Record<string, number>;
 }
+type GraphValidationSeverity = "error" | "warning";
+interface GraphValidationIssue {
+    severity: GraphValidationSeverity;
+    code: string;
+    message: string;
+    path?: string;
+    id?: string;
+    refs?: string[];
+}
+interface GraphValidationResult {
+    ok: boolean;
+    strict: boolean;
+    generatedAt: string;
+    counts: GraphStatsResult["counts"];
+    errorCount: number;
+    warningCount: number;
+    issues: GraphValidationIssue[];
+    summary: string;
+}
 interface GraphClusterRefreshResult {
     graphPath: string;
     nodeCount: number;
@@ -955,6 +974,20 @@ interface GraphQueryMatch {
     label: string;
     score: number;
 }
+type GraphQueryRelationGroup = "calls" | "imports" | "types" | "data" | "rationale" | "evidence";
+interface GraphQueryFilters {
+    relations?: string[];
+    relationGroups?: GraphQueryRelationGroup[];
+    evidenceClasses?: EvidenceClass[];
+    nodeTypes?: GraphNode["type"][];
+    languages?: CodeLanguage[];
+}
+interface GraphQueryFilterStats {
+    active: boolean;
+    droppedEdges: number;
+    droppedNodes: number;
+    expandedRelations: string[];
+}
 interface GraphQueryResult {
     question: string;
     traversal: "bfs" | "dfs";
@@ -967,6 +1000,8 @@ interface GraphQueryResult {
     communities: string[];
     summary: string;
     matches: GraphQueryMatch[];
+    filters?: GraphQueryFilters;
+    filterStats?: GraphQueryFilterStats;
 }
 interface GraphPathResult {
     from: string;
@@ -2466,6 +2501,10 @@ declare function getGraphStatus(rootDir: string, options?: {
     repoRoots?: string[];
 }): Promise<GraphStatusResult>;
 
+declare function graphStats(graph: GraphArtifact): GraphStatsResult;
+declare function validateGraphArtifact(graph: GraphArtifact, options?: {
+    strict?: boolean;
+}): GraphValidationResult;
 declare function graphDiff(oldGraph: GraphArtifact, newGraph: GraphArtifact): GraphDiffResult;
 /**
  * Compute the blast radius of changing a file/module by tracing reverse import
@@ -3027,12 +3066,17 @@ declare function searchVault(rootDir: string, query: string, limit?: number): Pr
 declare function queryGraphVault(rootDir: string, rawQuestion: string, options?: {
     traversal?: "bfs" | "dfs";
     budget?: number;
+    filters?: GraphQueryFilters;
 }): Promise<GraphQueryResult>;
 declare function benchmarkVault(rootDir: string, options?: BenchmarkOptions): Promise<BenchmarkArtifact>;
 declare function pathGraphVault(rootDir: string, from: string, to: string): Promise<GraphPathResult>;
 declare function explainGraphVault(rootDir: string, target: string): Promise<GraphExplainResult>;
 declare function listGraphHyperedges(rootDir: string, target?: string, limit?: number): Promise<GraphHyperedge[]>;
 declare function graphStatsVault(rootDir: string): Promise<GraphStatsResult>;
+declare function validateGraphVault(rootDir: string, options?: {
+    graphPath?: string;
+    strict?: boolean;
+}): Promise<ReturnType<typeof validateGraphArtifact>>;
 declare function refreshGraphClusters(rootDir: string, options?: {
     resolution?: number;
 }): Promise<GraphClusterRefreshResult>;
@@ -3140,4 +3184,4 @@ declare function createWebSearchAdapter(id: string, config: WebSearchProviderCon
 type WebSearchTaskId = "deepLintProvider" | "queryProvider" | "exploreProvider";
 declare function getWebSearchAdapterForTask(rootDir: string, task: WebSearchTaskId): Promise<WebSearchAdapter>;
 
-export { ALL_MIGRATIONS, type AddOptions, type AddResult, type AgentMemoryDecision, type AgentMemoryNote, type AgentMemoryResumeFormat, type AgentMemoryTask, type AgentMemoryTaskResult, type AgentMemoryTaskStatus, type AgentMemoryTaskSummary, type AgentType, type AnalyzedTerm, type ApprovalBundleType, type ApprovalChangeType, type ApprovalDetail, type ApprovalDiffHunk, type ApprovalDiffLine, type ApprovalEntry, type ApprovalEntryDetail, type ApprovalEntryLabel, type ApprovalEntryStatus, type ApprovalFrontmatterChange, type ApprovalManifest, type ApprovalStructuredDiff, type ApprovalSummary, type AudioTranscriptionRequest, type AudioTranscriptionResponse, type BenchmarkArtifact, type BenchmarkByClassEntry, type BenchmarkOptions, type BenchmarkQuestionResult, type BenchmarkSummary, type BlastRadiusResult, type BuildContextPackOptions, type BuildContextPackResult, type CandidatePromotionConfig, type CandidateRecord, type ChartDatum, type ChartSpec, type ClaimStatus, type CodeAnalysis, type CodeDiagnostic, type CodeImport, type CodeIndexArtifact, type CodeIndexEntry, type CodeLanguage, type CodeRelation, type CodeSymbol, type CodeSymbolKind, type CommandRoleExecutorConfig, type CompileOptions, type CompileResult, type CompileState, type ConsolidationConfig, type ConsolidationPromotion, type ConsolidationResult, type ContextPack, type ContextPackFormat, type ContextPackItem, type ContextPackItemKind, type ContextPackOmittedItem, type ContextPackSummary, DEFAULT_CONSOLIDATION_CONFIG, DEFAULT_HALF_LIFE_DAYS, DEFAULT_HALF_LIFE_DAYS_BY_SOURCE_CLASS, DEFAULT_PROMOTION_CONFIG, DEFAULT_REDACTION_PATTERNS, DEFAULT_STALE_THRESHOLD, type DegradationOutcome, type DirectoryIngestFailure, type DirectoryIngestResult, type DirectoryIngestSkip, type EmbeddingCacheArtifact, type EmbeddingCacheEntry, type EvidenceClass, type ExploreOptions, type ExploreResult, type ExploreStepResult, type ExtractionClaim, type ExtractionKind, type ExtractionTerm, type FinishMemoryTaskOptions, type Freshness, type FreshnessConfig, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GitHookStatus, type GraphArtifact, type GraphClusterRefreshResult, type GraphCommunityResult, type GraphDiffResult, type GraphEdge, type GraphExplainNeighbor, type GraphExplainResult, type GraphExportFormat, type GraphExportResult, type GraphHyperedge, type GraphNode, type GraphPage, type GraphPathResult, type GraphPushCounts, type GraphPushNeo4jOptions, type GraphPushResult, type GraphQueryMatch, type GraphQueryResult, type GraphReportArtifact, type GraphShareArtifact, type GraphShareBundleFile, type GraphShrinkDimension, type GraphShrinkGuardResult, type GraphStatsResult, type GraphStatusChange, type GraphStatusResult, type GuidedSessionMode, type GuidedSourceSessionAnswers, type GuidedSourceSessionQuestion, type GuidedSourceSessionRecord, type GuidedSourceSessionStatus, type ImageGenerationRequest, type ImageGenerationResponse, type ImageVisionExtraction, type InboxImportResult, type InboxImportSkip, type IngestOptions, type InitOptions, type InputIngestResult, type InstallAgentOptions, type InstallAgentResult, LARGE_REPO_NODE_THRESHOLD, LOCAL_WHISPER_MODEL_SIZES, type LintFinding, type LintOptions, type LocalWhisperAdapterOptions, type LocalWhisperBinaryDiscovery, LocalWhisperProviderAdapter, type LocalWhisperSetupStatus, type ManagedSourceAddOptions, type ManagedSourceAddResult, type ManagedSourceDeleteResult, type ManagedSourceKind, type ManagedSourceRecord, type ManagedSourceReloadOptions, type ManagedSourceReloadResult, type ManagedSourceStatus, type ManagedSourceSyncCounts, type ManagedSourcesArtifact, type MemoryTier, type MigrationPlan, type MigrationResult, type MigrationStep, type Neo4jGraphSinkConfig, OPENAI_COMPATIBLE_CAPABILITY_MATRIX, type OpenAiCompatiblePresetId, type OrchestrationConfig, type OrchestrationFinding, type OrchestrationProposal, type OrchestrationRole, type OrchestrationRoleConfig, type OrchestrationRoleResult, type OutputAsset, type OutputAssetRole, type OutputFormat, type OutputOrigin, type PageKind, type PageManager, type PageStatus, type PendingSemanticRefreshEntry, type Polarity, type PromotionDecision, type PromotionGateKind, type PromotionGateResult, type PromotionSession, type ProviderAdapter, type ProviderCapability, type ProviderConfig, type ProviderPresetCapability, type ProviderRegistrationOptions, type ProviderRegistrationResult, type ProviderRoleExecutorConfig, type ProviderType, type QueryOptions, type QueryResult, type RedactionMatchSummary, type RedactionPatternConfig, type RedactionSettings, type RedactionSummary, type RepoSyncResult, type ResolvedLargeRepoDefaults, type ResolvedPaths, type ResumeMemoryTaskOptions, type ResumeMemoryTaskResult, type RetrievalConfig, type RetrievalDoctorResult, type RetrievalManifest, type RetrievalStatus, type ReviewActionResult, type RoleExecutorConfig, SWARMVAULT_OUT_ENV, type SceneElement, type SceneSpec, type ScheduleController, type ScheduleJobConfig, type ScheduleStateRecord, type ScheduleTriggerConfig, type ScheduledCompileTask, type ScheduledConsolidateTask, type ScheduledExploreTask, type ScheduledLintTask, type ScheduledQueryTask, type ScheduledRunResult, type ScheduledTaskConfig, type SearchResult, type SourceAnalysis, type SourceAttachment, type SourceCaptureType, type SourceClaim, type SourceClass, type SourceExtractionArtifact, type SourceGuideResult, type SourceKind, type SourceManifest, type SourceRationale, type SourceReviewResult, type StartMemoryTaskOptions, type SynthesizedHubEdge, type SynthesizedHubNode, type SynthesizedHyperedgeHubs, type UpdateMemoryTaskOptions, type VaultConfig, type VaultDashboardPack, type VaultDoctorAction, type VaultDoctorCheck, type VaultDoctorCounts, type VaultDoctorRecommendation, type VaultDoctorRecommendationPriority, type VaultDoctorReport, type VaultDoctorSafeAction, type VaultDoctorStatus, type VaultProfileConfig, type VaultProfilePreset, type VaultVersionRecord, type WatchConfig, type WatchController, type WatchOptions, type WatchRepoSyncResult, type WatchRunRecord, type WatchStatusResult, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, type WhisperRunResult, type WhisperRunner, acceptApproval, addInput, addManagedSource, addWatchedRoot, agentTypeSchema, applyDecayToPages, archiveCandidate, assertProviderCapability, autoCommitWikiChanges, benchmarkVault, blastRadius, blastRadiusVault, bootstrapDemo, buildConfiguredRedactor, buildContextPack, buildGraphShareArtifact, buildGraphTree, buildMemoryGraphElements, buildRedactor, checkTrackedRepoChanges, compileVault, computeDecayScore, consolidateVault, createMcpServer, createProvider, createSupersessionEdge, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, deleteContextPack, deleteManagedSource, detectVaultVersion, discoverLocalWhisperBinary, doctorRetrieval, doctorVault, downloadWhisperModel, ensureMemoryLedger, estimatePageTokens, estimateTokens, evaluateCandidateForPromotion, evaluateGraphShrinkGuard, expectedModelPath, explainGraphVault, exploreVault, exportGraphFormat, exportGraphHtml, exportGraphReportHtml, exportGraphTree, exportObsidianCanvas, exportObsidianVault, finishMemoryTask, getGitHookStatus, getGraphCommunityVault, getGraphStatus, getProviderForTask, getRetrievalStatus, getWatchStatus, getWebSearchAdapterForTask, getWorkspaceInfo, graphDiff, graphStatsVault, guideManagedSource, guideSourceScope, importInbox, ingestDirectory, ingestInput, ingestInputDetailed, initVault, initWorkspace, installAgent, installConfiguredAgents, installGitHooks, lintVault, listApprovals, listCandidates, listContextPacks, listGodNodes, listGraphHyperedges, listManagedSourceRecords, listManifests, listMemoryTasks, listPages, listSchedules, listTrackedRepoRoots, listWatchedRoots, loadMemoryTaskPages, loadVaultConfig, loadVaultSchema, loadVaultSchemas, lookupPresetCapabilities, markSuperseded, memoryTaskHashes, mergeGraphFiles, modelDownloadUrl, pathGraphVault, persistDecayFrontmatter, planMigration, previewCandidatePromotions, projectGraphAfterRemovals, promoteCandidate, providerCapabilitySchema, providerTypeSchema, pushGraphNeo4j, queryGraphVault, queryVault, readApproval, readContextPack, readExtractedText, readGraphReport, readMemoryTask, readPage, rebuildRetrievalIndex, refreshGraphClusters, registerLocalWhisperProvider, rejectApproval, reloadManagedSources, removeWatchedRoot, renderContextPackLlms, renderContextPackMarkdown, renderGraphShareBundleFiles, renderGraphShareMarkdown, renderGraphSharePreviewHtml, renderGraphShareSvg, renderGraphTreeHtml, renderMemoryTaskMarkdown, resetDecay, resolveArtifactRootDir, resolveConsolidationConfig, resolveDecayConfig, resolveLargeRepoDefaults, resolvePaths, resolveRedactionPatterns, resolveRetrievalConfig, resolveWatchedRepoRoots, resumeMemoryTask, resumeSourceSession, reviewManagedSource, reviewSourceScope, runAutoPromotion, runConsolidation, runDecayPass, runMigration, runSchedule, runWatchCycle, searchVault, serveSchedules, stageGeneratedOutputPages, startGraphServer, startMcpServer, startMemoryTask, summarizeLocalWhisperSetup, syncTrackedRepos, syncTrackedReposForWatch, synthesizeHyperedgeHubs, trimToTokenBudget, uninstallGitHooks, updateMemoryTask, watchVault, webSearchProviderTypeSchema, withCapabilityFallback, writeRetrievalManifest };
+export { ALL_MIGRATIONS, type AddOptions, type AddResult, type AgentMemoryDecision, type AgentMemoryNote, type AgentMemoryResumeFormat, type AgentMemoryTask, type AgentMemoryTaskResult, type AgentMemoryTaskStatus, type AgentMemoryTaskSummary, type AgentType, type AnalyzedTerm, type ApprovalBundleType, type ApprovalChangeType, type ApprovalDetail, type ApprovalDiffHunk, type ApprovalDiffLine, type ApprovalEntry, type ApprovalEntryDetail, type ApprovalEntryLabel, type ApprovalEntryStatus, type ApprovalFrontmatterChange, type ApprovalManifest, type ApprovalStructuredDiff, type ApprovalSummary, type AudioTranscriptionRequest, type AudioTranscriptionResponse, type BenchmarkArtifact, type BenchmarkByClassEntry, type BenchmarkOptions, type BenchmarkQuestionResult, type BenchmarkSummary, type BlastRadiusResult, type BuildContextPackOptions, type BuildContextPackResult, type CandidatePromotionConfig, type CandidateRecord, type ChartDatum, type ChartSpec, type ClaimStatus, type CodeAnalysis, type CodeDiagnostic, type CodeImport, type CodeIndexArtifact, type CodeIndexEntry, type CodeLanguage, type CodeRelation, type CodeSymbol, type CodeSymbolKind, type CommandRoleExecutorConfig, type CompileOptions, type CompileResult, type CompileState, type ConsolidationConfig, type ConsolidationPromotion, type ConsolidationResult, type ContextPack, type ContextPackFormat, type ContextPackItem, type ContextPackItemKind, type ContextPackOmittedItem, type ContextPackSummary, DEFAULT_CONSOLIDATION_CONFIG, DEFAULT_HALF_LIFE_DAYS, DEFAULT_HALF_LIFE_DAYS_BY_SOURCE_CLASS, DEFAULT_PROMOTION_CONFIG, DEFAULT_REDACTION_PATTERNS, DEFAULT_STALE_THRESHOLD, type DegradationOutcome, type DirectoryIngestFailure, type DirectoryIngestResult, type DirectoryIngestSkip, type EmbeddingCacheArtifact, type EmbeddingCacheEntry, type EvidenceClass, type ExploreOptions, type ExploreResult, type ExploreStepResult, type ExtractionClaim, type ExtractionKind, type ExtractionTerm, type FinishMemoryTaskOptions, type Freshness, type FreshnessConfig, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GitHookStatus, type GraphArtifact, type GraphClusterRefreshResult, type GraphCommunityResult, type GraphDiffResult, type GraphEdge, type GraphExplainNeighbor, type GraphExplainResult, type GraphExportFormat, type GraphExportResult, type GraphHyperedge, type GraphNode, type GraphPage, type GraphPathResult, type GraphPushCounts, type GraphPushNeo4jOptions, type GraphPushResult, type GraphQueryFilterStats, type GraphQueryFilters, type GraphQueryMatch, type GraphQueryRelationGroup, type GraphQueryResult, type GraphReportArtifact, type GraphShareArtifact, type GraphShareBundleFile, type GraphShrinkDimension, type GraphShrinkGuardResult, type GraphStatsResult, type GraphStatusChange, type GraphStatusResult, type GraphValidationIssue, type GraphValidationResult, type GraphValidationSeverity, type GuidedSessionMode, type GuidedSourceSessionAnswers, type GuidedSourceSessionQuestion, type GuidedSourceSessionRecord, type GuidedSourceSessionStatus, type ImageGenerationRequest, type ImageGenerationResponse, type ImageVisionExtraction, type InboxImportResult, type InboxImportSkip, type IngestOptions, type InitOptions, type InputIngestResult, type InstallAgentOptions, type InstallAgentResult, LARGE_REPO_NODE_THRESHOLD, LOCAL_WHISPER_MODEL_SIZES, type LintFinding, type LintOptions, type LocalWhisperAdapterOptions, type LocalWhisperBinaryDiscovery, LocalWhisperProviderAdapter, type LocalWhisperSetupStatus, type ManagedSourceAddOptions, type ManagedSourceAddResult, type ManagedSourceDeleteResult, type ManagedSourceKind, type ManagedSourceRecord, type ManagedSourceReloadOptions, type ManagedSourceReloadResult, type ManagedSourceStatus, type ManagedSourceSyncCounts, type ManagedSourcesArtifact, type MemoryTier, type MigrationPlan, type MigrationResult, type MigrationStep, type Neo4jGraphSinkConfig, OPENAI_COMPATIBLE_CAPABILITY_MATRIX, type OpenAiCompatiblePresetId, type OrchestrationConfig, type OrchestrationFinding, type OrchestrationProposal, type OrchestrationRole, type OrchestrationRoleConfig, type OrchestrationRoleResult, type OutputAsset, type OutputAssetRole, type OutputFormat, type OutputOrigin, type PageKind, type PageManager, type PageStatus, type PendingSemanticRefreshEntry, type Polarity, type PromotionDecision, type PromotionGateKind, type PromotionGateResult, type PromotionSession, type ProviderAdapter, type ProviderCapability, type ProviderConfig, type ProviderPresetCapability, type ProviderRegistrationOptions, type ProviderRegistrationResult, type ProviderRoleExecutorConfig, type ProviderType, type QueryOptions, type QueryResult, type RedactionMatchSummary, type RedactionPatternConfig, type RedactionSettings, type RedactionSummary, type RepoSyncResult, type ResolvedLargeRepoDefaults, type ResolvedPaths, type ResumeMemoryTaskOptions, type ResumeMemoryTaskResult, type RetrievalConfig, type RetrievalDoctorResult, type RetrievalManifest, type RetrievalStatus, type ReviewActionResult, type RoleExecutorConfig, SWARMVAULT_OUT_ENV, type SceneElement, type SceneSpec, type ScheduleController, type ScheduleJobConfig, type ScheduleStateRecord, type ScheduleTriggerConfig, type ScheduledCompileTask, type ScheduledConsolidateTask, type ScheduledExploreTask, type ScheduledLintTask, type ScheduledQueryTask, type ScheduledRunResult, type ScheduledTaskConfig, type SearchResult, type SourceAnalysis, type SourceAttachment, type SourceCaptureType, type SourceClaim, type SourceClass, type SourceExtractionArtifact, type SourceGuideResult, type SourceKind, type SourceManifest, type SourceRationale, type SourceReviewResult, type StartMemoryTaskOptions, type SynthesizedHubEdge, type SynthesizedHubNode, type SynthesizedHyperedgeHubs, type UpdateMemoryTaskOptions, type VaultConfig, type VaultDashboardPack, type VaultDoctorAction, type VaultDoctorCheck, type VaultDoctorCounts, type VaultDoctorRecommendation, type VaultDoctorRecommendationPriority, type VaultDoctorReport, type VaultDoctorSafeAction, type VaultDoctorStatus, type VaultProfileConfig, type VaultProfilePreset, type VaultVersionRecord, type WatchConfig, type WatchController, type WatchOptions, type WatchRepoSyncResult, type WatchRunRecord, type WatchStatusResult, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, type WhisperRunResult, type WhisperRunner, acceptApproval, addInput, addManagedSource, addWatchedRoot, agentTypeSchema, applyDecayToPages, archiveCandidate, assertProviderCapability, autoCommitWikiChanges, benchmarkVault, blastRadius, blastRadiusVault, bootstrapDemo, buildConfiguredRedactor, buildContextPack, buildGraphShareArtifact, buildGraphTree, buildMemoryGraphElements, buildRedactor, checkTrackedRepoChanges, compileVault, computeDecayScore, consolidateVault, createMcpServer, createProvider, createSupersessionEdge, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, deleteContextPack, deleteManagedSource, detectVaultVersion, discoverLocalWhisperBinary, doctorRetrieval, doctorVault, downloadWhisperModel, ensureMemoryLedger, estimatePageTokens, estimateTokens, evaluateCandidateForPromotion, evaluateGraphShrinkGuard, expectedModelPath, explainGraphVault, exploreVault, exportGraphFormat, exportGraphHtml, exportGraphReportHtml, exportGraphTree, exportObsidianCanvas, exportObsidianVault, finishMemoryTask, getGitHookStatus, getGraphCommunityVault, getGraphStatus, getProviderForTask, getRetrievalStatus, getWatchStatus, getWebSearchAdapterForTask, getWorkspaceInfo, graphDiff, graphStats, graphStatsVault, guideManagedSource, guideSourceScope, importInbox, ingestDirectory, ingestInput, ingestInputDetailed, initVault, initWorkspace, installAgent, installConfiguredAgents, installGitHooks, lintVault, listApprovals, listCandidates, listContextPacks, listGodNodes, listGraphHyperedges, listManagedSourceRecords, listManifests, listMemoryTasks, listPages, listSchedules, listTrackedRepoRoots, listWatchedRoots, loadMemoryTaskPages, loadVaultConfig, loadVaultSchema, loadVaultSchemas, lookupPresetCapabilities, markSuperseded, memoryTaskHashes, mergeGraphFiles, modelDownloadUrl, pathGraphVault, persistDecayFrontmatter, planMigration, previewCandidatePromotions, projectGraphAfterRemovals, promoteCandidate, providerCapabilitySchema, providerTypeSchema, pushGraphNeo4j, queryGraphVault, queryVault, readApproval, readContextPack, readExtractedText, readGraphReport, readMemoryTask, readPage, rebuildRetrievalIndex, refreshGraphClusters, registerLocalWhisperProvider, rejectApproval, reloadManagedSources, removeWatchedRoot, renderContextPackLlms, renderContextPackMarkdown, renderGraphShareBundleFiles, renderGraphShareMarkdown, renderGraphSharePreviewHtml, renderGraphShareSvg, renderGraphTreeHtml, renderMemoryTaskMarkdown, resetDecay, resolveArtifactRootDir, resolveConsolidationConfig, resolveDecayConfig, resolveLargeRepoDefaults, resolvePaths, resolveRedactionPatterns, resolveRetrievalConfig, resolveWatchedRepoRoots, resumeMemoryTask, resumeSourceSession, reviewManagedSource, reviewSourceScope, runAutoPromotion, runConsolidation, runDecayPass, runMigration, runSchedule, runWatchCycle, searchVault, serveSchedules, stageGeneratedOutputPages, startGraphServer, startMcpServer, startMemoryTask, summarizeLocalWhisperSetup, syncTrackedRepos, syncTrackedReposForWatch, synthesizeHyperedgeHubs, trimToTokenBudget, uninstallGitHooks, updateMemoryTask, validateGraphArtifact, validateGraphVault, watchVault, webSearchProviderTypeSchema, withCapabilityFallback, writeRetrievalManifest };

package/dist/index.js

@@ -45,6 +45,7 @@ import {
   getWorkspaceInfo,
   graphDiff,
   graphHash,
+  graphStats,
   graphStatsVault,
   guidedSourceSessionStatePath,
   importInbox,
@@ -121,11 +122,13 @@ import {
   syncTrackedRepos,
   syncTrackedReposForWatch,
   updateMemoryTask,
+  validateGraphArtifact,
+  validateGraphVault,
   validateUrlSafety,
   writeGuidedSourceSession,
   writeRetrievalManifest,
   writeWatchStatusArtifact
-} from "./chunk-WWP3VPEJ.js";
+} from "./chunk-2PN46RDI.js";
 import {
   LocalWhisperProviderAdapter,
   SWARMVAULT_OUT_ENV,
@@ -4410,6 +4413,23 @@ function compareTreeNodes(left, right) {
 function escapeHtml(value) {
   return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
 }
+function escapeAttribute(value) {
+  return escapeHtml(value).replaceAll("'", "&#39;");
+}
+function escapeScriptJson(value) {
+  return JSON.stringify(value).replace(/[<>&]/g, (character) => {
+    switch (character) {
+      case "<":
+        return "\\u003c";
+      case ">":
+        return "\\u003e";
+      case "&":
+        return "\\u0026";
+      default:
+        return character;
+    }
+  });
+}
 function normalizeSourcePath(rootDir, source) {
   const candidate = source.repoRelativePath ?? source.originalPath ?? source.storedPath ?? source.title;
   if (source.repoRelativePath) {
@@ -4538,6 +4558,43 @@ function buildGraphTree(graph, options = {}) {
   }
   return sortAndCapTree(root, Math.max(1, options.maxChildren ?? DEFAULT_MAX_CHILDREN));
 }
+function collectTreeInspectorEntries(tree, graph) {
+  const graphNodes = new Map(graph.nodes.map((node) => [node.id, node]));
+  const entries = {};
+  const visit = (node) => {
+    const edges = node.nodeId ? graph.edges.filter((edge) => edge.source === node.nodeId || edge.target === node.nodeId).slice().sort((left, right) => right.confidence - left.confidence || left.relation.localeCompare(right.relation)).slice(0, 8).map((edge) => {
+      const outgoing = edge.source === node.nodeId;
+      const otherId = outgoing ? edge.target : edge.source;
+      return {
+        id: edge.id,
+        relation: edge.relation,
+        direction: outgoing ? "outgoing" : "incoming",
+        otherId,
+        otherLabel: graphNodes.get(otherId)?.label ?? otherId,
+        evidenceClass: edge.evidenceClass,
+        confidence: edge.confidence
+      };
+    }) : [];
+    entries[node.id] = {
+      id: node.id,
+      label: node.label,
+      kind: node.kind,
+      count: node.count,
+      path: node.path,
+      sourceId: node.sourceId,
+      nodeId: node.nodeId,
+      language: node.language,
+      symbolKind: node.symbolKind,
+      hiddenChildren: node.hiddenChildren,
+      edges
+    };
+    for (const child of node.children) {
+      visit(child);
+    }
+  };
+  visit(tree);
+  return entries;
+}
 function renderNode(node) {
   const meta = [
     node.kind,
@@ -4549,15 +4606,17 @@ function renderNode(node) {
     node.count ? `${node.count} item${node.count === 1 ? "" : "s"}` : void 0
   ].filter(Boolean);
   const content = [
-    `<span class="label">${escapeHtml(node.label)}</span>`,
+    `<button class="node-button" type="button" data-tree-id="${escapeAttribute(node.id)}"><span class="label">${escapeHtml(node.label)}</span></button>`,
+    node.count ? `<span class="count">${node.count}</span>` : "",
     meta.length ? `<span class="meta">${escapeHtml(meta.join(" \xB7 "))}</span>` : ""
   ].join("");
   if (node.children.length === 0) {
-    return `<li class="tree-node kind-${escapeHtml(node.kind)}">${content}</li>`;
+    return `<li class="tree-node kind-${escapeAttribute(node.kind)}" data-tree-id="${escapeAttribute(node.id)}">${content}</li>`;
   }
-  return `<li class="tree-node kind-${escapeHtml(node.kind)}"><details open><summary>${content}</summary><ul>${node.children.map(renderNode).join("")}</ul></details></li>`;
+  return `<li class="tree-node kind-${escapeAttribute(node.kind)}" data-tree-id="${escapeAttribute(node.id)}"><details open><summary>${content}</summary><ul>${node.children.map(renderNode).join("")}</ul></details></li>`;
 }
 function renderGraphTreeHtml(tree, graph) {
+  const inspectorEntries = collectTreeInspectorEntries(tree, graph);
   return `<!doctype html>
 <html lang="en">
 <head>
@@ -4567,27 +4626,44 @@ function renderGraphTreeHtml(tree, graph) {
 <style>
 :root { color-scheme: light dark; font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
 body { margin: 0; background: #f7f7f5; color: #171717; }
-main { max-width: 1120px; margin: 0 auto; padding: 32px 20px 56px; }
+main { max-width: 1280px; margin: 0 auto; padding: 32px 20px 56px; }
 h1 { font-size: 28px; line-height: 1.2; margin: 0 0 8px; }
 .subtitle { color: #5d5d5d; margin: 0 0 20px; }
-.toolbar { display: flex; gap: 12px; align-items: center; margin: 0 0 18px; }
-input { flex: 1; min-width: 0; border: 1px solid #c9c9c9; border-radius: 6px; padding: 10px 12px; font: inherit; background: #fff; color: inherit; }
-.tree { background: #fff; border: 1px solid #deded9; border-radius: 8px; padding: 16px 18px; }
+.toolbar { display: flex; flex-wrap: wrap; gap: 10px; align-items: center; margin: 0 0 18px; }
+input { flex: 1 1 320px; min-width: 0; border: 1px solid #c9c9c9; border-radius: 6px; padding: 10px 12px; font: inherit; background: #fff; color: inherit; }
+.toolbar button { border: 1px solid #c9c9c9; border-radius: 6px; background: #fff; color: inherit; font: inherit; padding: 10px 12px; cursor: pointer; }
+.layout { display: grid; grid-template-columns: minmax(0, 1fr) 340px; gap: 18px; align-items: start; }
+.tree, .inspector { background: #fff; border: 1px solid #deded9; border-radius: 8px; padding: 16px 18px; }
+.inspector { position: sticky; top: 16px; }
+.inspector h2 { font-size: 17px; margin: 0 0 10px; }
+.inspector dl { display: grid; grid-template-columns: 96px minmax(0, 1fr); gap: 6px 10px; margin: 0 0 16px; font-size: 13px; }
+.inspector dt { color: #666; }
+.inspector dd { margin: 0; overflow-wrap: anywhere; }
+.edge-list { display: grid; gap: 8px; margin: 0; padding: 0; list-style: none; }
+.edge-list li { border-top: 1px solid #ecece8; padding-top: 8px; }
 ul { list-style: none; margin: 0; padding-left: 20px; }
 .tree > ul { padding-left: 0; }
 li { margin: 4px 0; }
 summary { cursor: pointer; }
+.node-button { border: 0; background: transparent; color: inherit; font: inherit; padding: 2px 0; cursor: pointer; text-align: left; }
+.node-button:focus-visible, .toolbar button:focus-visible, input:focus-visible { outline: 2px solid #1f6feb; outline-offset: 2px; }
 .label { font-weight: 600; }
+.count { display: inline-flex; min-width: 18px; justify-content: center; margin-left: 8px; padding: 1px 6px; border-radius: 999px; background: #ededdf; color: #444; font-size: 12px; }
 .meta { color: #666; font-size: 12px; margin-left: 8px; }
 .kind-directory > details > summary .label { color: #245b78; }
 .kind-source > details > summary .label, .kind-source > .label { color: #22543d; }
 .kind-module > details > summary .label { color: #6b3f12; }
 .kind-rationale > .label { color: #6d2f46; }
+.selected > details > summary, .selected > .node-button { background: #eef6f1; border-radius: 4px; }
 .hidden { display: none !important; }
+@media (max-width: 900px) { .layout { grid-template-columns: 1fr; } .inspector { position: static; } }
 @media (prefers-color-scheme: dark) {
   body { background: #161616; color: #efefef; }
-  .subtitle, .meta { color: #ababab; }
-  input, .tree { background: #202020; border-color: #3a3a3a; }
+  .subtitle, .meta, .inspector dt { color: #ababab; }
+  input, .tree, .inspector, .toolbar button { background: #202020; border-color: #3a3a3a; }
+  .count { background: #333329; color: #deded8; }
+  .edge-list li { border-color: #333; }
+  .selected > details > summary, .selected > .node-button { background: #24362d; }
 }
 </style>
 </head>
@@ -4595,11 +4671,61 @@ summary { cursor: pointer; }
 <main>
 <h1>${escapeHtml(tree.label)}</h1>
 <p class="subtitle">${graph.sources.length} sources \xB7 ${graph.nodes.length} nodes \xB7 ${graph.edges.length} edges \xB7 generated ${escapeHtml(graph.generatedAt)}</p>
-<div class="toolbar"><input id="filter" type="search" placeholder="Filter files, modules, symbols, or ids" aria-label="Filter graph tree"></div>
-<section class="tree"><ul>${renderNode(tree)}</ul></section>
+<div class="toolbar">
+  <input id="filter" type="search" placeholder="Filter files, modules, symbols, or ids" aria-label="Filter graph tree">
+  <button type="button" id="expandAll">Expand all</button>
+  <button type="button" id="collapseAll">Collapse all</button>
+  <button type="button" id="resetTree">Reset</button>
+</div>
+<div class="layout">
+  <section class="tree" aria-label="Graph tree"><ul>${renderNode(tree)}</ul></section>
+  <aside class="inspector" aria-live="polite">
+    <h2 id="inspectorTitle">Select a node</h2>
+    <dl id="inspectorMeta"></dl>
+    <ul class="edge-list" id="inspectorEdges"></ul>
+  </aside>
+</div>
 </main>
 <script>
+const treeData = ${escapeScriptJson(inspectorEntries)};
 const input = document.getElementById('filter');
+const inspectorTitle = document.getElementById('inspectorTitle');
+const inspectorMeta = document.getElementById('inspectorMeta');
+const inspectorEdges = document.getElementById('inspectorEdges');
+const renderText = (value) => String(value ?? '').replace(/[&<>"']/g, (character) => ({
+  '&': '&amp;',
+  '<': '&lt;',
+  '>': '&gt;',
+  '"': '&quot;',
+  "'": '&#39;'
+})[character]);
+function selectNode(id) {
+  const entry = treeData[id];
+  if (!entry) return;
+  for (const selected of document.querySelectorAll('.selected')) selected.classList.remove('selected');
+  const selectedNode = Array.from(document.querySelectorAll('[data-tree-id]')).find((node) => node.dataset.treeId === id);
+  selectedNode?.classList.add('selected');
+  inspectorTitle.textContent = entry.label;
+  const rows = [
+    ['Kind', entry.kind],
+    ['Count', entry.count],
+    ['Path', entry.path],
+    ['Source', entry.sourceId],
+    ['Node', entry.nodeId],
+    ['Language', entry.language],
+    ['Symbol', entry.symbolKind],
+    ['Hidden', entry.hiddenChildren]
+  ].filter(([, value]) => value !== undefined && value !== null && value !== '');
+  inspectorMeta.innerHTML = rows.map(([label, value]) => '<dt>' + renderText(label) + '</dt><dd>' + renderText(value) + '</dd>').join('');
+  inspectorEdges.innerHTML = entry.edges.length
+    ? entry.edges.map((edge) => '<li><strong>' + renderText(edge.relation) + '</strong> ' + renderText(edge.direction) + ' ' + renderText(edge.otherLabel) + '<br><span class="meta">' + renderText(edge.evidenceClass) + ' \xB7 ' + renderText(edge.confidence) + '</span></li>').join('')
+    : '<li>No connected edges in the top slice.</li>';
+}
+document.querySelector('.tree')?.addEventListener('click', (event) => {
+  const button = event.target.closest('.node-button');
+  if (!button) return;
+  selectNode(button.dataset.treeId);
+});
 input.addEventListener('input', () => {
   const query = input.value.trim().toLowerCase();
   for (const node of document.querySelectorAll('.tree-node')) {
@@ -4607,6 +4733,19 @@ input.addEventListener('input', () => {
     node.classList.toggle('hidden', query.length > 0 && !text.includes(query));
   }
 });
+document.getElementById('expandAll').addEventListener('click', () => {
+  for (const details of document.querySelectorAll('details')) details.open = true;
+});
+document.getElementById('collapseAll').addEventListener('click', () => {
+  for (const details of document.querySelectorAll('details')) details.open = false;
+});
+document.getElementById('resetTree').addEventListener('click', () => {
+  input.value = '';
+  input.dispatchEvent(new Event('input'));
+  for (const details of document.querySelectorAll('details')) details.open = true;
+  selectNode('${escapeAttribute(tree.id)}');
+});
+selectNode('${escapeAttribute(tree.id)}');
 </script>
 </body>
 </html>
@@ -4774,7 +4913,44 @@ import path10 from "path";
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-var SERVER_VERSION = "3.7.3";
+var SERVER_VERSION = "3.9.0";
+var codeLanguageSchema = z.enum([
+  "javascript",
+  "jsx",
+  "typescript",
+  "tsx",
+  "bash",
+  "python",
+  "go",
+  "rust",
+  "java",
+  "kotlin",
+  "scala",
+  "dart",
+  "lua",
+  "zig",
+  "csharp",
+  "c",
+  "cpp",
+  "php",
+  "ruby",
+  "powershell",
+  "swift",
+  "elixir",
+  "ocaml",
+  "objc",
+  "rescript",
+  "solidity",
+  "html",
+  "css",
+  "vue",
+  "svelte",
+  "julia",
+  "verilog",
+  "systemverilog",
+  "r",
+  "sql"
+]);
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -4883,13 +5059,25 @@ async function createMcpServer(rootDir) {
       inputSchema: {
         question: z.string().min(1).describe("Question or graph search seed"),
         traversal: z.enum(["bfs", "dfs"]).optional().describe("Traversal strategy"),
-        budget: z.number().int().min(3).max(50).optional().describe("Maximum nodes to summarize")
+        budget: z.number().int().min(3).max(50).optional().describe("Maximum nodes to summarize"),
+        relations: z.array(z.string().min(1)).optional().describe("Only traverse edges with these relation names"),
+        context: z.array(z.enum(["calls", "imports", "types", "data", "rationale", "evidence"])).optional().describe("Relation group filters for common code/evidence contexts"),
+        evidenceClasses: z.array(z.enum(["extracted", "inferred", "ambiguous"])).optional().describe("Only traverse these evidence classes"),
+        nodeTypes: z.array(z.enum(["source", "concept", "entity", "module", "symbol", "rationale", "memory_task", "decision"])).optional().describe("Prefer traversal around these graph node types"),
+        languages: z.array(codeLanguageSchema).optional().describe("Prefer traversal around nodes with these code languages")
       }
     },
-    safeHandler(async ({ question, traversal, budget }) => {
+    safeHandler(async ({ question, traversal, budget, relations, context, evidenceClasses, nodeTypes, languages }) => {
       const result = await queryGraphVault(rootDir, question, {
         traversal,
-        budget
+        budget,
+        filters: {
+          relations,
+          relationGroups: context,
+          evidenceClasses,
+          nodeTypes,
+          languages
+        }
       });
       return asToolText(result);
     })
@@ -8888,6 +9076,7 @@ export {
   getWebSearchAdapterForTask,
   getWorkspaceInfo,
   graphDiff,
+  graphStats,
   graphStatsVault,
   guideManagedSource,
   guideSourceScope,
@@ -8983,6 +9172,8 @@ export {
   trimToTokenBudget,
   uninstallGitHooks,
   updateMemoryTask,
+  validateGraphArtifact,
+  validateGraphVault,
   watchVault,
   withCapabilityFallback,
   writeRetrievalManifest

package/dist/memory-HEA7XNKB.js

@@ -0,0 +1,32 @@
+import {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+} from "./chunk-2PN46RDI.js";
+import "./chunk-75BU5TQ6.js";
+import "./chunk-NAIERP4C.js";
+export {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+};

package/dist/memory-PK5JJNAG.js

@@ -0,0 +1,32 @@
+import {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+} from "./chunk-WOA5LSNB.js";
+import "./chunk-75BU5TQ6.js";
+import "./chunk-NAIERP4C.js";
+export {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+};

package/dist/memory-YKQWWIVY.js

@@ -0,0 +1,32 @@
+import {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+} from "./chunk-563TZ4TZ.js";
+import "./chunk-75BU5TQ6.js";
+import "./chunk-NAIERP4C.js";
+export {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/engine",
-  "version": "3.7.3",
+  "version": "3.9.0",
   "description": "Core engine for SwarmVault: ingest, compile, query, lint, and provider abstractions.",
   "type": "module",
   "main": "dist/index.js",
@@ -40,7 +40,7 @@
     "node": ">=24.0.0"
   },
   "scripts": {
-    "build": "test -f ../viewer/dist/index.html || pnpm --dir ../viewer build; tsup src/index.ts --format esm --dts && tsup --config tsup.hooks.config.ts && rm -rf dist/viewer && mkdir -p dist/viewer && cp -R ../viewer/dist/. dist/viewer/",
+    "build": "test -f ../viewer/dist/index.html || pnpm --dir ../viewer build; tsup src/index.ts --format esm --dts && tsup --config tsup.hooks.config.ts && node ../../scripts/copy-engine-grammar-assets.mjs && rm -rf dist/viewer && mkdir -p dist/viewer && cp -R ../viewer/dist/. dist/viewer/",
     "pretest": "tsup --config tsup.hooks.config.ts",
     "test": "SWARMVAULT_ALLOW_PRIVATE_URLS=1 vitest run --testTimeout=10000",
     "typecheck": "tsc --noEmit",
@@ -95,6 +95,8 @@
     "@types/turndown": "^5.0.5",
     "graphology-types": "^0.24.8",
     "tsup": "^8.5.0",
+    "tree-sitter-julia": "0.23.1",
+    "tree-sitter-systemverilog": "0.3.1",
     "vitest": "^3.2.4"
   }
 }