@swarmvaultai/engine 0.10.0 → 0.12.0

package/dist/index.d.ts

@@ -239,6 +239,29 @@ interface VaultConfig {
     };
     graph?: {
         communityResolution?: number;
+        /**
+         * Minimum IDF weight a similarity feature must carry to contribute to an
+         * inferred `semantically_similar_to` edge. Features below the floor are
+         * dropped entirely. Defaults to 0.5.
+         */
+        similarityIdfFloor?: number;
+        /**
+         * Hard cap on the number of inferred similarity edges emitted. Defaults
+         * to `min(5 * nodeCount, 20000)` so very large repos do not produce
+         * O(n²) similarity fan-out.
+         */
+        similarityEdgeCap?: number;
+        /**
+         * Upper bound on god-node entries surfaced in the graph report and
+         * tooling. Defaults to 20 for small repos and 10 for large ones.
+         */
+        godNodeLimit?: number;
+        /**
+         * Report rollup threshold: communities with fewer members than this are
+         * folded into the fragmented-community rollup instead of listed
+         * individually. Defaults to `max(3, ceil(totalCommunities / 50))`.
+         */
+        foldCommunitiesBelow?: number;
     };
     webSearch?: {
         providers: Record<string, WebSearchProviderConfig>;
@@ -259,6 +282,15 @@ interface VaultConfig {
     redaction?: RedactionSettings;
     freshness?: FreshnessConfig;
     consolidation?: ConsolidationConfig;
+    watch?: WatchConfig;
+}
+/**
+ * Explicit user control over which repository roots `swarmvault watch --repo` tracks.
+ * Absent config preserves the existing auto-discovery behavior over managed sources and manifests.
+ */
+interface WatchConfig {
+    repoRoots?: string[];
+    excludeRepoRoots?: string[];
 }
 /**
  * Heuristic configuration for the LLM Wiki v2 consolidation tier rollup.
@@ -602,7 +634,14 @@ interface SourceRationale {
     id: string;
     text: string;
     citation: string;
-    kind: "docstring" | "comment" | "marker";
+    /**
+     * Structural kind for code rationales (`docstring`, `comment`, `marker`) or
+     * the lowercased fixed-prefix marker for non-code rationales (`note`,
+     * `why`, `hack`, `important`, `rationale`, `todo`, `fixme`, `warning`,
+     * `warn`). Non-code kinds are parser-selected from markdown blockquotes /
+     * list items and plain-text paragraphs, never swept from whole files.
+     */
+    kind: "docstring" | "comment" | "marker" | "note" | "why" | "hack" | "important" | "rationale" | "todo" | "fixme" | "warning" | "warn";
     symbolName?: string;
 }
 interface CodeIndexEntry {
@@ -656,6 +695,11 @@ interface GraphNode {
     degree?: number;
     bridgeScore?: number;
     isGodNode?: boolean;
+    /**
+     * Human-readable explanation of why this node was flagged as a god-node
+     * (high-degree hub). Populated for god nodes only. Deterministic.
+     */
+    surpriseReason?: string;
     tags?: string[];
 }
 /**
@@ -1049,6 +1093,7 @@ interface WatchOptions {
     debounceMs?: number;
     repo?: boolean;
     codeOnly?: boolean;
+    overrideRoots?: string[];
 }
 interface PendingSemanticRefreshEntry {
     id: string;
@@ -1382,6 +1427,27 @@ interface BenchmarkSummary {
     avgReduction: number;
     reductionRatio: number;
 }
+/**
+ * Per-source-class slice of a benchmark run. The graph-guided tokens are
+ * computed against the same traversal seeds that produced the corpus-wide
+ * numbers, then narrowed to nodes/edges/pages whose `sourceClass` matches
+ * this class. The naive tokens come from manifests whose
+ * {@link SourceManifest.sourceClass} matches this class. Empty classes are
+ * represented as zeroed entries rather than being omitted so downstream
+ * consumers never have to branch on `undefined`.
+ */
+interface BenchmarkByClassEntry {
+    sourceClass: SourceClass;
+    sourceCount: number;
+    pageCount: number;
+    nodeCount: number;
+    godNodeCount: number;
+    corpusWords: number;
+    corpusTokens: number;
+    finalContextTokens: number;
+    reductionRatio: number;
+    perQuestion: BenchmarkQuestionResult[];
+}
 interface BenchmarkArtifact {
     generatedAt: string;
     graphHash: string;
@@ -1394,6 +1460,7 @@ interface BenchmarkArtifact {
     sampleQuestions: string[];
     perQuestion: BenchmarkQuestionResult[];
     summary: BenchmarkSummary;
+    byClass: Record<SourceClass, BenchmarkByClassEntry>;
 }
 interface EmbeddingCacheEntry {
     itemId: string;
@@ -1439,6 +1506,21 @@ interface GraphReportArtifact {
         stale: boolean;
         summary: BenchmarkSummary;
         questionCount: number;
+        /**
+         * Compact per-source-class mirror of the benchmark summary. Populated
+         * from {@link BenchmarkArtifact.byClass} whenever the benchmark artifact
+         * is available at report build time. Kept optional so older benchmark
+         * files without a `byClass` field still produce a valid report.
+         */
+        byClass?: Record<SourceClass, {
+            sourceCount: number;
+            pageCount: number;
+            nodeCount: number;
+            godNodeCount: number;
+            finalContextTokens: number;
+            naiveCorpusTokens: number;
+            reductionRatio: number;
+        }>;
     };
     godNodes: Array<{
         nodeId: string;
@@ -1446,6 +1528,12 @@ interface GraphReportArtifact {
         pageId?: string;
         degree?: number;
         bridgeScore?: number;
+        /**
+         * Deterministic one-line explanation of why the node is surfaced as a
+         * god-node — e.g. "degree 42 across 7 communities" or
+         * "degree 38 (2.1σ above mean)". Omitted when no degree signal exists.
+         */
+        surpriseReason?: string;
     }>;
     bridgeNodes: Array<{
         nodeId: string;
@@ -1787,6 +1875,61 @@ declare function runDecayPass(input: {
     markedStale: string[];
 }>;
 
+/**
+ * Viewer-only hub node synthesized from a group-pattern hyperedge. Hubs are
+ * never written back to `state/graph.json` — callers can treat them as
+ * transient UI scaffolding that turns a single `GraphHyperedge` into a tiny
+ * star of pairwise edges that Cytoscape (or vis.js) can render natively.
+ */
+type SynthesizedHubNode = {
+    id: string;
+    hyperedgeId: string;
+    label: string;
+    relation: string;
+    participantIds: string[];
+    confidence: number;
+    evidenceClass: string;
+    why: string;
+};
+/**
+ * Viewer-only edge that connects a synthesized hub to one of the hyperedge
+ * participants. IDs are stable across renders so Cytoscape can reuse them and
+ * tests can assert their presence.
+ */
+type SynthesizedHubEdge = {
+    id: string;
+    hyperedgeId: string;
+    source: string;
+    target: string;
+    relation: string;
+    confidence: number;
+    evidenceClass: string;
+};
+type SynthesizedHyperedgeHubs = {
+    hubNodes: SynthesizedHubNode[];
+    hubEdges: SynthesizedHubEdge[];
+};
+type MinimalHyperedge = {
+    id: string;
+    label: string;
+    relation: string;
+    nodeIds: string[];
+    confidence?: number;
+    evidenceClass?: string;
+    why?: string;
+};
+type MinimalNode = {
+    id: string;
+};
+/**
+ * Turn every group-pattern hyperedge with `>= 2` participants into a star:
+ * one synthetic hub node plus a pairwise edge to each participant. Degenerate
+ * hyperedges (zero or one participant) are skipped because a hub with no
+ * "group" to anchor is noisy and contributes nothing to the layout. Nothing
+ * here mutates `state/graph.json`; the caller layers hubs on top of the real
+ * graph for rendering only.
+ */
+declare function synthesizeHyperedgeHubs(hyperedges: ReadonlyArray<MinimalHyperedge>, nodes: ReadonlyArray<MinimalNode>): SynthesizedHyperedgeHubs;
 declare function exportGraphFormat(rootDir: string, format: Exclude<GraphExportFormat, "html" | "report" | "obsidian" | "canvas">, outputPath: string): Promise<GraphExportResult>;
 declare function exportGraphReportHtml(rootDir: string, outputPath: string): Promise<GraphExportResult>;
 declare function exportObsidianVault(rootDir: string, outputDir: string): Promise<GraphExportResult>;
@@ -1833,11 +1976,150 @@ declare function importInbox(rootDir: string, inputDir?: string): Promise<InboxI
 declare function listManifests(rootDir: string): Promise<SourceManifest[]>;
 declare function readExtractedText(rootDir: string, manifest: SourceManifest): Promise<string | undefined>;
 
+/**
+ * Effective tuning thresholds for graph output. These knobs keep report and
+ * similarity surfaces readable on large repositories while preserving
+ * friendly defaults on small ones. Every caller that picks a graph limit
+ * should route through {@link resolveLargeRepoDefaults} so user-provided
+ * overrides stay authoritative and defaults adjust automatically based on
+ * node count.
+ */
+interface ResolvedLargeRepoDefaults {
+    /** Upper bound on god-node entries surfaced in the report/tooling. */
+    godNodeLimit: number;
+    /**
+     * Community rollup threshold: any community with fewer than this many
+     * members is folded into the rollup summary in the report. Defaults to
+     * `max(3, ceil(totalCommunities / 50))` when `totalCommunities` is
+     * provided, otherwise to 3.
+     */
+    foldCommunitiesBelow: number;
+    /**
+     * Hard cap on the number of inferred similarity edges emitted per graph.
+     * Prevents degenerate O(n²) fan-out on very large repos.
+     */
+    similarityEdgeCap: number;
+    /**
+     * Minimum IDF weight a similarity feature must carry to contribute to an
+     * edge score. Features below the floor are dropped entirely.
+     */
+    similarityIdfFloor: number;
+}
+/** Node count at which tighter defaults begin firing. */
+declare const LARGE_REPO_NODE_THRESHOLD = 1000;
+/**
+ * Resolve effective numeric thresholds for a graph of `nodeCount` nodes.
+ * User-configured values on `config.graph` always win — defaults only fire
+ * when the caller has left the knob unset. Pass `totalCommunities` when the
+ * community rollup threshold needs to scale with the community count.
+ */
+declare function resolveLargeRepoDefaults(input: {
+    nodeCount: number;
+    totalCommunities?: number;
+    config?: VaultConfig | null;
+}): ResolvedLargeRepoDefaults;
+
 declare function createMcpServer(rootDir: string): Promise<McpServer>;
 declare function startMcpServer(rootDir: string, stdin?: Readable, stdout?: Writable): Promise<{
     close: () => Promise<void>;
 }>;
 
+interface MigrationStepContext {
+    rootDir: string;
+    paths: {
+        wikiDir: string;
+        stateDir: string;
+        rootDir: string;
+    };
+}
+interface MigrationStep {
+    id: string;
+    fromVersion: string;
+    toVersion: string;
+    description: string;
+    apply(ctx: MigrationStepContext, options: {
+        dryRun: boolean;
+    }): Promise<{
+        changed: string[];
+    }>;
+}
+interface MigrationPlan {
+    fromVersion: string | null;
+    toVersion: string;
+    steps: MigrationStep[];
+}
+interface MigrationResult {
+    planned: number;
+    applied: Array<{
+        id: string;
+        changed: string[];
+    }>;
+    skipped: Array<{
+        id: string;
+        reason: string;
+    }>;
+    dryRun: boolean;
+    fromVersion: string | null;
+    toVersion: string;
+}
+interface VaultVersionRecord {
+    version: string;
+    migratedAt: string;
+    appliedSteps: string[];
+}
+declare const ALL_MIGRATIONS: readonly MigrationStep[];
+declare function detectVaultVersion(rootDir: string): Promise<string | null>;
+declare function planMigration(rootDir: string, targetVersion?: string): Promise<MigrationPlan>;
+declare function runMigration(rootDir: string, options?: {
+    targetVersion?: string;
+    dryRun?: boolean;
+}): Promise<MigrationResult>;
+
+/**
+ * Canonical capability matrix for the OpenAI-compatible provider family.
+ *
+ * OpenAI-compatible implementations differ substantially in which endpoints
+ * they support, how strict their structured-output adherence is, and whether
+ * they can handle vision or audio tasks. This matrix records the community
+ * consensus so downstream code can query support before issuing requests
+ * instead of discovering the gap via a runtime error.
+ *
+ * Entries are normative defaults, not contractual guarantees — a user who
+ * configures `capabilities: [...]` on a `ProviderConfig` always wins over
+ * the defaults.
+ */
+interface ProviderPresetCapability {
+    readonly presetId: string;
+    readonly apiStyle: "chat" | "responses";
+    readonly capabilities: readonly ProviderCapability[];
+    readonly notes: string;
+}
+declare const OPENAI_COMPATIBLE_CAPABILITY_MATRIX: Readonly<Record<string, ProviderPresetCapability>>;
+type OpenAiCompatiblePresetId = keyof typeof OPENAI_COMPATIBLE_CAPABILITY_MATRIX;
+/**
+ * Look up the canonical capability list for a known preset id. Returns `null`
+ * when the preset is unknown (e.g., `custom` adapters) so callers can decide
+ * whether to trust the adapter's declared capability set instead.
+ */
+declare function lookupPresetCapabilities(presetId: string): ProviderPresetCapability | null;
+type DegradeReason = "unsupported" | "unknown";
+interface DegradationOutcome<T> {
+    readonly supported: boolean;
+    readonly reason: DegradeReason | null;
+    readonly value: T | null;
+}
+/**
+ * Safe-degradation helper: if the provider advertises the requested
+ * capability, run `run()`. Otherwise return the caller-supplied fallback
+ * and explain why.
+ *
+ * This is intentionally a thin wrapper — the cost of misusing it is a
+ * silent failure, so it forces the caller to supply an explicit fallback
+ * and logs the reason so callers can surface a warning instead of
+ * hallucinating a result.
+ */
+declare function withCapabilityFallback<T>(provider: Pick<ProviderAdapter, "capabilities" | "type">, capability: ProviderCapability, run: () => Promise<T>, fallback: () => T | Promise<T>): Promise<DegradationOutcome<T>>;
+
 declare function createProvider(id: string, config: ProviderConfig, rootDir: string): Promise<ProviderAdapter>;
 declare function getProviderForTask(rootDir: string, task: keyof Awaited<ReturnType<typeof loadVaultConfig>>["config"]["tasks"]): Promise<ProviderAdapter>;
 declare function assertProviderCapability(provider: ProviderAdapter, capability: ProviderCapability): void;
@@ -2110,6 +2392,35 @@ type WatchCycleResult = {
     changedPages: string[];
     lintFindingCount?: number;
 };
+/**
+ * Compute the effective list of repository roots that `swarmvault watch --repo` should track.
+ * Resolution order (highest wins):
+ *   1. `options.overrideRoots` (CLI `--root <path>`) — used verbatim, config and discovery skipped.
+ *   2. Explicit `config.watch.repoRoots` — skips auto-discovery but still honors `excludeRepoRoots`.
+ *   3. Auto-discovery via `listTrackedRepoRoots` — preserves pre-0.11 behavior.
+ * `config.watch.excludeRepoRoots` always applies as a deny list (unless `overrideRoots` is set).
+ */
+declare function resolveWatchedRepoRoots(rootDir: string, options?: {
+    overrideRoots?: string[];
+    config?: VaultConfig;
+}): Promise<string[]>;
+/**
+ * Public helper mirroring `resolveWatchedRepoRoots` for CLI and MCP callers that only need the
+ * final list without the full watch cycle machinery.
+ */
+declare function listWatchedRoots(rootDir: string, options?: {
+    overrideRoots?: string[];
+}): Promise<string[]>;
+/**
+ * Add a repo root to the persisted `watch.repoRoots` list in `swarmvault.config.json`.
+ * Returns the resolved absolute path that was added (or already present). Dedupes on resolved path.
+ */
+declare function addWatchedRoot(rootDir: string, candidate: string): Promise<string>;
+/**
+ * Remove a repo root from the persisted `watch.repoRoots` list. Missing path is a no-op.
+ * Returns `true` when the path was removed, `false` when it was absent.
+ */
+declare function removeWatchedRoot(rootDir: string, candidate: string): Promise<boolean>;
 declare function runWatchCycle(rootDir: string, options?: WatchOptions): Promise<WatchCycleResult>;
 declare function watchVault(rootDir: string, options?: WatchOptions): Promise<WatchController>;
 declare function getWatchStatus(rootDir: string): Promise<WatchStatusResult>;
@@ -2118,4 +2429,4 @@ declare function createWebSearchAdapter(id: string, config: WebSearchProviderCon
 type WebSearchTaskId = "deepLintProvider" | "queryProvider" | "exploreProvider";
 declare function getWebSearchAdapterForTask(rootDir: string, task: WebSearchTaskId): Promise<WebSearchAdapter>;
 
-export { type AddOptions, type AddResult, 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 BenchmarkOptions, type BenchmarkQuestionResult, type BenchmarkSummary, type BlastRadiusResult, type CandidatePromotionConfig, type CandidateRecord, type ChartDatum, type ChartSpec, type ClaimStatus, type CodeAnalysis, type CodeDiagnostic, type CodeImport, type CodeIndexArtifact, type CodeIndexEntry, type CodeLanguage, type CodeSymbol, type CodeSymbolKind, type CommandRoleExecutorConfig, type CompileOptions, type CompileResult, type CompileState, type ConsolidationConfig, type ConsolidationPromotion, type ConsolidationResult, DEFAULT_CONSOLIDATION_CONFIG, DEFAULT_HALF_LIFE_DAYS, DEFAULT_HALF_LIFE_DAYS_BY_SOURCE_CLASS, DEFAULT_PROMOTION_CONFIG, DEFAULT_REDACTION_PATTERNS, DEFAULT_STALE_THRESHOLD, 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 Freshness, type FreshnessConfig, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GitHookStatus, type GraphArtifact, 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 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, type LintFinding, type LintOptions, type ManagedSourceAddOptions, type ManagedSourceAddResult, type ManagedSourceDeleteResult, type ManagedSourceKind, type ManagedSourceRecord, type ManagedSourceReloadOptions, type ManagedSourceReloadResult, type ManagedSourceStatus, type ManagedSourceSyncCounts, type ManagedSourcesArtifact, type MemoryTier, type Neo4jGraphSinkConfig, 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 ProviderRoleExecutorConfig, type ProviderType, type QueryOptions, type QueryResult, type RedactionMatchSummary, type RedactionPatternConfig, type RedactionSettings, type RedactionSummary, type RepoSyncResult, type ResolvedPaths, type ReviewActionResult, type RoleExecutorConfig, 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 VaultConfig, type VaultDashboardPack, type VaultProfileConfig, type VaultProfilePreset, type WatchController, type WatchOptions, type WatchRepoSyncResult, type WatchRunRecord, type WatchStatusResult, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, acceptApproval, addInput, addManagedSource, agentTypeSchema, applyDecayToPages, archiveCandidate, assertProviderCapability, autoCommitWikiChanges, benchmarkVault, blastRadius, blastRadiusVault, bootstrapDemo, buildConfiguredRedactor, buildRedactor, compileVault, computeDecayScore, consolidateVault, createMcpServer, createProvider, createSupersessionEdge, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, deleteManagedSource, estimatePageTokens, estimateTokens, evaluateCandidateForPromotion, explainGraphVault, exploreVault, exportGraphFormat, exportGraphHtml, exportGraphReportHtml, exportObsidianCanvas, exportObsidianVault, getGitHookStatus, getProviderForTask, getWatchStatus, getWebSearchAdapterForTask, getWorkspaceInfo, graphDiff, guideManagedSource, guideSourceScope, importInbox, ingestDirectory, ingestInput, ingestInputDetailed, initVault, initWorkspace, installAgent, installConfiguredAgents, installGitHooks, lintVault, listApprovals, listCandidates, listGodNodes, listGraphHyperedges, listManagedSourceRecords, listManifests, listPages, listSchedules, listTrackedRepoRoots, loadVaultConfig, loadVaultSchema, loadVaultSchemas, markSuperseded, pathGraphVault, persistDecayFrontmatter, previewCandidatePromotions, promoteCandidate, providerCapabilitySchema, providerTypeSchema, pushGraphNeo4j, queryGraphVault, queryVault, readApproval, readExtractedText, readGraphReport, readPage, rejectApproval, reloadManagedSources, resetDecay, resolveConsolidationConfig, resolveDecayConfig, resolvePaths, resolveRedactionPatterns, resumeSourceSession, reviewManagedSource, reviewSourceScope, runAutoPromotion, runConsolidation, runDecayPass, runSchedule, runWatchCycle, searchVault, serveSchedules, stageGeneratedOutputPages, startGraphServer, startMcpServer, syncTrackedRepos, syncTrackedReposForWatch, trimToTokenBudget, uninstallGitHooks, watchVault, webSearchProviderTypeSchema };
+export { ALL_MIGRATIONS, type AddOptions, type AddResult, 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 CandidatePromotionConfig, type CandidateRecord, type ChartDatum, type ChartSpec, type ClaimStatus, type CodeAnalysis, type CodeDiagnostic, type CodeImport, type CodeIndexArtifact, type CodeIndexEntry, type CodeLanguage, type CodeSymbol, type CodeSymbolKind, type CommandRoleExecutorConfig, type CompileOptions, type CompileResult, type CompileState, type ConsolidationConfig, type ConsolidationPromotion, type ConsolidationResult, 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 Freshness, type FreshnessConfig, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GitHookStatus, type GraphArtifact, 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 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, type LintFinding, type LintOptions, 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 ProviderRoleExecutorConfig, type ProviderType, type QueryOptions, type QueryResult, type RedactionMatchSummary, type RedactionPatternConfig, type RedactionSettings, type RedactionSummary, type RepoSyncResult, type ResolvedLargeRepoDefaults, type ResolvedPaths, type ReviewActionResult, type RoleExecutorConfig, 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 SynthesizedHubEdge, type SynthesizedHubNode, type SynthesizedHyperedgeHubs, type VaultConfig, type VaultDashboardPack, 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, acceptApproval, addInput, addManagedSource, addWatchedRoot, agentTypeSchema, applyDecayToPages, archiveCandidate, assertProviderCapability, autoCommitWikiChanges, benchmarkVault, blastRadius, blastRadiusVault, bootstrapDemo, buildConfiguredRedactor, buildRedactor, compileVault, computeDecayScore, consolidateVault, createMcpServer, createProvider, createSupersessionEdge, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, deleteManagedSource, detectVaultVersion, estimatePageTokens, estimateTokens, evaluateCandidateForPromotion, explainGraphVault, exploreVault, exportGraphFormat, exportGraphHtml, exportGraphReportHtml, exportObsidianCanvas, exportObsidianVault, getGitHookStatus, getProviderForTask, getWatchStatus, getWebSearchAdapterForTask, getWorkspaceInfo, graphDiff, guideManagedSource, guideSourceScope, importInbox, ingestDirectory, ingestInput, ingestInputDetailed, initVault, initWorkspace, installAgent, installConfiguredAgents, installGitHooks, lintVault, listApprovals, listCandidates, listGodNodes, listGraphHyperedges, listManagedSourceRecords, listManifests, listPages, listSchedules, listTrackedRepoRoots, listWatchedRoots, loadVaultConfig, loadVaultSchema, loadVaultSchemas, lookupPresetCapabilities, markSuperseded, pathGraphVault, persistDecayFrontmatter, planMigration, previewCandidatePromotions, promoteCandidate, providerCapabilitySchema, providerTypeSchema, pushGraphNeo4j, queryGraphVault, queryVault, readApproval, readExtractedText, readGraphReport, readPage, rejectApproval, reloadManagedSources, removeWatchedRoot, resetDecay, resolveConsolidationConfig, resolveDecayConfig, resolveLargeRepoDefaults, resolvePaths, resolveRedactionPatterns, resolveWatchedRepoRoots, resumeSourceSession, reviewManagedSource, reviewSourceScope, runAutoPromotion, runConsolidation, runDecayPass, runMigration, runSchedule, runWatchCycle, searchVault, serveSchedules, stageGeneratedOutputPages, startGraphServer, startMcpServer, syncTrackedRepos, syncTrackedReposForWatch, synthesizeHyperedgeHubs, trimToTokenBudget, uninstallGitHooks, watchVault, webSearchProviderTypeSchema, withCapabilityFallback };