@cleocode/contracts 2026.4.29 → 2026.4.31

package/dist/dependency.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Dependency registry contracts for CLEO runtime dependency verification.
+ *
+ * This is the single source of truth (SSoT) for all CLEO dependency types.
+ * All health check systems that inspect external dependencies MUST use these
+ * contracts rather than defining inline or ad-hoc types.
+ *
+ * @task T507
+ */
+/**
+ * Classification of a CLEO dependency by necessity.
+ *
+ * - `required` — CLEO cannot function without this dependency.
+ * - `optional` — CLEO works without this but specific features are disabled.
+ * - `feature` — A bundled or internally-managed dependency (e.g. native addons).
+ */
+export type DependencyCategory = 'required' | 'optional' | 'feature';
+/**
+ * Static specification describing a single CLEO dependency.
+ *
+ * This is the registry entry — it does NOT carry check results.
+ * Use {@link DependencyCheckResult} for runtime check outcomes.
+ */
+export interface DependencySpec {
+    /** Canonical identifier used as a lookup key (e.g. `"git"`, `"gh"`). */
+    name: string;
+    /** Classification of the dependency by necessity. */
+    category: DependencyCategory;
+    /** Human-readable description of what the dependency is used for. */
+    description: string;
+    /** Semver-style constraint string (e.g. `">=24.0.0"`). Optional. */
+    versionConstraint?: string;
+    /** URL pointing to installation or documentation for this dependency. */
+    documentationUrl?: string;
+    /** Shell command to install the dependency (informational only). */
+    installCommand?: string;
+    /**
+     * Platforms on which this dependency applies.
+     * When absent the dependency is considered applicable on all platforms.
+     */
+    platforms?: ('linux' | 'darwin' | 'win32')[];
+}
+/**
+ * Runtime check result for a single CLEO dependency.
+ *
+ * Produced by `checkDependency()` and collected into a {@link DependencyReport}.
+ */
+export interface DependencyCheckResult {
+    /** Canonical identifier matching the corresponding {@link DependencySpec}. */
+    name: string;
+    /** Classification of the dependency (copied from its spec). */
+    category: DependencyCategory;
+    /** Whether the dependency is present on the system. */
+    installed: boolean;
+    /** Detected version string, if available (e.g. `"2.43.0"`). */
+    version?: string;
+    /** Filesystem path where the dependency was found (e.g. `/usr/bin/git`). */
+    location?: string;
+    /**
+     * Whether the dependency passes all health criteria.
+     *
+     * For `required` dependencies this means installed AND the version satisfies
+     * `versionConstraint`. For `optional` and `feature` dependencies a missing
+     * dependency is still considered healthy (the feature is simply disabled).
+     */
+    healthy: boolean;
+    /** Human-readable error or diagnostic message when `healthy` is `false`. */
+    error?: string;
+    /** Actionable fix suggestion to show the user when `healthy` is `false`. */
+    suggestedFix?: string;
+}
+/**
+ * Full dependency report produced by `checkAllDependencies()`.
+ *
+ * Intended for consumption by `coreDoctorReport()` and any CLI output layer.
+ */
+export interface DependencyReport {
+    /** ISO 8601 timestamp of when the report was generated. */
+    timestamp: string;
+    /** `process.platform` value at check time (e.g. `"linux"`, `"darwin"`). */
+    platform: string;
+    /** Node.js version string without the `v` prefix (e.g. `"24.0.0"`). */
+    nodeVersion: string;
+    /** Per-dependency check results. */
+    results: DependencyCheckResult[];
+    /**
+     * `true` when every `required` dependency is healthy.
+     * Optional and feature dependencies do not affect this flag.
+     */
+    allRequiredMet: boolean;
+    /** Non-fatal advisory messages (e.g. optional dep missing, feature unavailable). */
+    warnings: string[];
+}
+//# sourceMappingURL=dependency.d.ts.map

package/dist/dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency.d.ts","sourceRoot":"","sources":["../src/dependency.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB,oFAAoF;IACpF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/dependency.js

@@ -0,0 +1,11 @@
+/**
+ * Dependency registry contracts for CLEO runtime dependency verification.
+ *
+ * This is the single source of truth (SSoT) for all CLEO dependency types.
+ * All health check systems that inspect external dependencies MUST use these
+ * contracts rather than defining inline or ad-hoc types.
+ *
+ * @task T507
+ */
+export {};
+//# sourceMappingURL=dependency.js.map

package/dist/dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency.js","sourceRoot":"","sources":["../src/dependency.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/graph.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Graph type contracts for CLEO code intelligence.
+ *
+ * Defines the node types, relationship types, and structures that form the
+ * foundation of the code intelligence graph. Ported from GitNexus graph
+ * primitives and adapted for CLEO's lightweight, in-process use case.
+ *
+ * @task T512
+ * @module contracts/graph
+ */
+/**
+ * All supported symbol node kinds in the code intelligence graph.
+ *
+ * Covers file/folder structural nodes plus every symbol-level construct
+ * that tree-sitter can identify across TypeScript, JavaScript, and future
+ * language providers. Includes synthetic graph-level nodes produced by
+ * analysis phases (community detection, process detection, route extraction).
+ *
+ * @since T529 — expanded from T512 baseline with 17 new kinds
+ */
+export type GraphNodeKind = 'file' | 'folder' | 'module' | 'namespace' | 'function' | 'method' | 'constructor' | 'class' | 'interface' | 'struct' | 'trait' | 'impl' | 'type_alias' | 'enum' | 'property' | 'constant' | 'variable' | 'static' | 'record' | 'delegate' | 'macro' | 'union' | 'typedef' | 'annotation' | 'template' | 'community' | 'process' | 'route' | 'tool' | 'section' | 'import' | 'export' | 'type';
+/**
+ * All supported directed relationship types between graph nodes.
+ *
+ * Types are intentionally lowercase to match CLEO convention.
+ * Each type carries semantic meaning about the nature of the dependency.
+ *
+ * @since T529 — expanded from T512 baseline with 10 new relation types
+ */
+export type GraphRelationType = 'contains' | 'defines' | 'imports' | 'accesses' | 'calls' | 'extends' | 'implements' | 'method_overrides' | 'method_implements' | 'has_method' | 'has_property' | 'member_of' | 'step_in_process' | 'handles_route' | 'fetches' | 'handles_tool' | 'entry_point_of' | 'wraps' | 'queries' | 'documents' | 'applies_to';
+/**
+ * A node in the code intelligence graph representing a symbol or structural
+ * element extracted from source code.
+ *
+ * The `id` field is a stable identifier for the node, typically derived from
+ * the file path and symbol name (e.g., `src/foo.ts::parseFile`).
+ */
+export interface GraphNode {
+    /** Unique, stable node identifier. Typically `<filePath>::<name>`. */
+    id: string;
+    /** Kind of code element this node represents. */
+    kind: GraphNodeKind;
+    /** Symbol name as it appears in source code. */
+    name: string;
+    /** File path relative to the project root. */
+    filePath: string;
+    /** Start line in the source file (1-based). */
+    startLine: number;
+    /** End line in the source file (1-based). */
+    endLine: number;
+    /** Language of the source file (e.g., "typescript", "javascript"). */
+    language: string;
+    /** Whether the symbol is publicly exported from its module. */
+    exported: boolean;
+    /** Parent node ID, if this symbol is nested (e.g., method inside class). */
+    parent?: string;
+    /** Parameter names or signatures for functions and methods. */
+    parameters?: string[];
+    /** Return type annotation text, if available. */
+    returnType?: string;
+    /** First line of the TSDoc/JSDoc comment for this symbol, if present. */
+    docSummary?: string;
+    /** Community ID this node belongs to (set after Phase 5 community detection). */
+    communityId?: string;
+    /** Execution flow process IDs this node participates in (set after Phase 6). */
+    processIds?: string[];
+    /** Kind-specific metadata blob (matches nexus_nodes.meta_json). */
+    meta?: Record<string, unknown>;
+}
+/**
+ * A directed relationship between two nodes in the code intelligence graph.
+ *
+ * The `source` and `target` fields reference node IDs (see {@link GraphNode.id}).
+ * Confidence reflects how certain the extractor is about this relationship,
+ * from 0.0 (speculative) to 1.0 (statically verified).
+ */
+export interface GraphRelation {
+    /** ID of the originating node. */
+    source: string;
+    /** ID of the target node. */
+    target: string;
+    /** Semantic type of the relationship. */
+    type: GraphRelationType;
+    /**
+     * Extractor confidence for this relationship (0.0 to 1.0).
+     *
+     * Common values by type:
+     * - `calls` / `imports`: 0.9 (direct, strongly typed)
+     * - `extends` / `implements`: 0.85 (statically verifiable)
+     * - `has_method` / `has_property`: 0.95 (structural containment)
+     * - `accesses`: 0.8 (field read/write, may be indirect)
+     */
+    confidence: number;
+    /** Human-readable note explaining why this relation was emitted. */
+    reason?: string;
+}
+/**
+ * Result of a BFS-based impact analysis starting from a named symbol.
+ *
+ * Affected nodes are grouped into three depth tiers that reflect the
+ * likelihood and urgency of breakage:
+ *
+ * - **depth1_willBreak** (d=1): Direct callers/importers — WILL break.
+ *   Must be updated whenever the target changes.
+ * - **depth2_likelyAffected** (d=2): Indirect dependants — LIKELY affected.
+ *   Should be tested.
+ * - **depth3_mayNeedTesting** (d=3): Transitive dependants — MAY need testing.
+ *   Test if the symbol is on a critical path.
+ */
+export interface ImpactResult {
+    /** Name or ID of the symbol that was analyzed. */
+    target: string;
+    /**
+     * Overall risk classification based on the number and type of affected nodes.
+     *
+     * - `low`: 0–3 direct dependants, no cross-module spread
+     * - `medium`: 4–9 direct dependants, or limited cross-module spread
+     * - `high`: 10+ direct dependants, or significant cross-module spread
+     * - `critical`: Exported symbol with high cross-module usage
+     */
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    /** Human-readable summary of the impact analysis outcome. */
+    summary: string;
+    /** Nodes affected at each traversal depth. */
+    affectedByDepth: {
+        /** d=1: Direct dependants — WILL BREAK. */
+        depth1_willBreak: GraphNode[];
+        /** d=2: Indirect dependants — LIKELY AFFECTED. */
+        depth2_likelyAffected: GraphNode[];
+        /** d=3: Transitive dependants — MAY NEED TESTING. */
+        depth3_mayNeedTesting: GraphNode[];
+    };
+    /** Total number of affected nodes across all depths. */
+    totalAffected: number;
+}
+/**
+ * An in-memory symbol table entry tracking all files where a name appears.
+ * Used during ingestion to resolve cross-file call targets.
+ */
+export interface SymbolIndex {
+    /** Symbol name as it appears in source (e.g., "parseFile"). */
+    name: string;
+    /** All node IDs that define this name across the project. */
+    nodeIds: string[];
+    /** All file paths that export this name. */
+    exportingFiles: string[];
+}
+/**
+ * The in-memory KnowledgeGraph assembled during a single ingestion run.
+ * Flushed to nexus_nodes + nexus_relations after all phases complete.
+ */
+export interface KnowledgeGraph {
+    /** Primary node store: nodeId → GraphNode. */
+    nodes: Map<string, GraphNode>;
+    /** All directed edges (appended during ingestion, deduplicated at flush). */
+    relations: GraphRelation[];
+    /** Indexes for fast lookup during resolution phases. */
+    symbolTable: SymbolIndex[];
+    /** Files that changed since last index (incremental mode only). */
+    changedFiles?: Set<string>;
+}
+/**
+ * A community (module cluster) identified by Louvain community detection
+ * during Phase 5. Represents a group of cohesive symbols within the graph.
+ */
+export interface CommunityNode {
+    /** Node ID format: `community:<n>` */
+    id: string;
+    /** Inferred label from the top folder name. */
+    label: string;
+    /** Number of member symbols in this community. */
+    memberCount: number;
+    /** Top-level folders contributing most members. */
+    topFolders: string[];
+}
+/**
+ * A detected execution flow (process) from BFS entry point analysis
+ * during Phase 6. Represents a named sequence of function calls.
+ */
+export interface ProcessNode {
+    /** Node ID format: `process:<slug>` */
+    id: string;
+    /** Entry point function name used as the process label. */
+    label: string;
+    /** Node ID of the entry point function. */
+    entryPointId: string;
+    /** Ordered node IDs representing each step in the flow. */
+    stepIds: string[];
+    /** Total number of steps in this execution flow. */
+    stepCount: number;
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"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"}

package/dist/graph.js

@@ -0,0 +1,12 @@
+/**
+ * Graph type contracts for CLEO code intelligence.
+ *
+ * Defines the node types, relationship types, and structures that form the
+ * foundation of the code intelligence graph. Ported from GitNexus graph
+ * primitives and adapted for CLEO's lightweight, in-process use case.
+ *
+ * @task T512
+ * @module contracts/graph
+ */
+export {};
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/index.d.ts

@@ -16,11 +16,13 @@ export type { Conduit, ConduitConfig, ConduitMessage, ConduitSendOptions, Condui
 export type { BackupConfig, BrainConfig, BrainEmbeddingConfig, BrainMemoryBridgeConfig, BrainSummarizationConfig, CleoConfig, ConfigSource, DateFormat, EnforcementProfile, HierarchyConfig, LifecycleConfig, LifecycleEnforcementMode, LoggingConfig, LogLevel, OutputConfig, OutputFormat, ResolvedValue, SessionConfig, SessionSummaryInput, SharingConfig, SharingMode, SignalDockConfig, SignalDockMode, } from './config.js';
 export type { AdapterContextMonitorProvider } from './context-monitor.js';
 export type { ArchiveFields, ArchiveFile, DataAccessor, DataAccessorAgentInstance, QueryTasksResult, TaskFieldUpdates, TaskQueryFilters, TransactionAccessor, } from './data-accessor.js';
+export type { DependencyCategory, DependencyCheckResult, DependencyReport, DependencySpec, } from './dependency.js';
 export type { AdapterManifest, DetectionPattern } from './discovery.js';
 export { createErrorResult, createSuccessResult, formatError, getErrorMessage, isErrorResult, isErrorType, normalizeError, } from './errors.js';
 export { ExitCode, getExitCodeName, isErrorCode, isNoChangeCode, isRecoverableCode, isSuccessCode, } from './exit-codes.js';
 export type { AdminAPI, AgentCapacity, AgentHealthStatus, AgentInstanceRow, AgentInstanceStatus, AgentsAPI, AgentType, BlastRadius, BlastRadiusSeverity, BrainObservationType, CleoInitOptions, DuplicateStrategy, HybridSearchOptions, ImpactedTask, ImpactReport, ImportParams, IntelligenceAPI, LifecycleAPI, MemoryAPI, NexusAPI, OrchestrationAPI, RegisterAgentOptions, ReleaseAPI, SessionsAPI, StickyAPI, SyncAPI, TaskStartResult, TasksAPI, } from './facade.js';
 export { AGENT_INSTANCE_STATUSES, AGENT_TYPES, BRAIN_OBSERVATION_TYPES, } from './facade.js';
+export type { CommunityNode, GraphNode, GraphNodeKind, GraphRelation, GraphRelationType, ImpactResult, KnowledgeGraph, ProcessNode, SymbolIndex, } from './graph.js';
 export type { AdapterHookProvider } from './hooks.js';
 export type { AdapterInstallProvider, InstallOptions, InstallResult } from './install.js';
 export type { CleoResponse, ConformanceReport, FlagInput, GatewayEnvelope, GatewayError, GatewayMeta, GatewaySuccess, LAFSEnvelope, LAFSError, LAFSErrorCategory, LAFSMeta, LAFSPage, LAFSPageNone, LAFSPageOffset, LAFSTransport, LafsAlternative, LafsEnvelope, LafsError, LafsErrorDetail, LafsSuccess, MVILevel, Warning, } from './lafs.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE7E,YAAY,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,OAAO,EACP,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAE1E,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,eAAe,EACf,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC1F,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,YAAY,EACZ,WAAW,EACX,cAAc,EACd,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,SAAS,EACT,eAAe,EACf,WAAW,EACX,QAAQ,EACR,OAAO,GACR,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAE7C,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,UAAU,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,OAAO,EACP,eAAe,EACf,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElF,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,EAEd,KAAK,UAAU,EACf,aAAa,EACb,KAAK,UAAU,EACf,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,cAAc,EAEnB,qBAAqB,EACrB,KAAK,cAAc,EACnB,gBAAgB,EAChB,KAAK,aAAa,EAClB,kBAAkB,EAClB,eAAe,EACf,KAAK,WAAW,EAChB,yBAAyB,EACzB,2BAA2B,EAE3B,aAAa,EAEb,KAAK,UAAU,EACf,0BAA0B,EAC1B,uBAAuB,EAEvB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,QAAQ,EACR,KAAK,EACL,WAAW,EACX,eAAe,EACf,WAAW,EACX,OAAO,EACP,aAAa,EACb,WAAW,EACX,IAAI,EACJ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,wBAAwB,EACxB,SAAS,EACT,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,UAAU,EACV,eAAe,EACf,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,SAAS,GACV,MAAM,iBAAiB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyGH,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+BzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AA2BrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAG7C,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAgCtC,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA6E9B,yCAAyC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgHH,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+BzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAuCrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAG7C,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAgCtC,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA6E9B,yCAAyC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.4.29",
+  "version": "2026.4.31",
   "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/dependency.ts

@@ -0,0 +1,97 @@
+/**
+ * Dependency registry contracts for CLEO runtime dependency verification.
+ *
+ * This is the single source of truth (SSoT) for all CLEO dependency types.
+ * All health check systems that inspect external dependencies MUST use these
+ * contracts rather than defining inline or ad-hoc types.
+ *
+ * @task T507
+ */
+
+/**
+ * Classification of a CLEO dependency by necessity.
+ *
+ * - `required` — CLEO cannot function without this dependency.
+ * - `optional` — CLEO works without this but specific features are disabled.
+ * - `feature` — A bundled or internally-managed dependency (e.g. native addons).
+ */
+export type DependencyCategory = 'required' | 'optional' | 'feature';
+
+/**
+ * Static specification describing a single CLEO dependency.
+ *
+ * This is the registry entry — it does NOT carry check results.
+ * Use {@link DependencyCheckResult} for runtime check outcomes.
+ */
+export interface DependencySpec {
+  /** Canonical identifier used as a lookup key (e.g. `"git"`, `"gh"`). */
+  name: string;
+  /** Classification of the dependency by necessity. */
+  category: DependencyCategory;
+  /** Human-readable description of what the dependency is used for. */
+  description: string;
+  /** Semver-style constraint string (e.g. `">=24.0.0"`). Optional. */
+  versionConstraint?: string;
+  /** URL pointing to installation or documentation for this dependency. */
+  documentationUrl?: string;
+  /** Shell command to install the dependency (informational only). */
+  installCommand?: string;
+  /**
+   * Platforms on which this dependency applies.
+   * When absent the dependency is considered applicable on all platforms.
+   */
+  platforms?: ('linux' | 'darwin' | 'win32')[];
+}
+
+/**
+ * Runtime check result for a single CLEO dependency.
+ *
+ * Produced by `checkDependency()` and collected into a {@link DependencyReport}.
+ */
+export interface DependencyCheckResult {
+  /** Canonical identifier matching the corresponding {@link DependencySpec}. */
+  name: string;
+  /** Classification of the dependency (copied from its spec). */
+  category: DependencyCategory;
+  /** Whether the dependency is present on the system. */
+  installed: boolean;
+  /** Detected version string, if available (e.g. `"2.43.0"`). */
+  version?: string;
+  /** Filesystem path where the dependency was found (e.g. `/usr/bin/git`). */
+  location?: string;
+  /**
+   * Whether the dependency passes all health criteria.
+   *
+   * For `required` dependencies this means installed AND the version satisfies
+   * `versionConstraint`. For `optional` and `feature` dependencies a missing
+   * dependency is still considered healthy (the feature is simply disabled).
+   */
+  healthy: boolean;
+  /** Human-readable error or diagnostic message when `healthy` is `false`. */
+  error?: string;
+  /** Actionable fix suggestion to show the user when `healthy` is `false`. */
+  suggestedFix?: string;
+}
+
+/**
+ * Full dependency report produced by `checkAllDependencies()`.
+ *
+ * Intended for consumption by `coreDoctorReport()` and any CLI output layer.
+ */
+export interface DependencyReport {
+  /** ISO 8601 timestamp of when the report was generated. */
+  timestamp: string;
+  /** `process.platform` value at check time (e.g. `"linux"`, `"darwin"`). */
+  platform: string;
+  /** Node.js version string without the `v` prefix (e.g. `"24.0.0"`). */
+  nodeVersion: string;
+  /** Per-dependency check results. */
+  results: DependencyCheckResult[];
+  /**
+   * `true` when every `required` dependency is healthy.
+   * Optional and feature dependencies do not affect this flag.
+   */
+  allRequiredMet: boolean;
+  /** Non-fatal advisory messages (e.g. optional dep missing, feature unavailable). */
+  warnings: string[];
+}

package/src/graph.ts

@@ -0,0 +1,297 @@
+/**
+ * Graph type contracts for CLEO code intelligence.
+ *
+ * Defines the node types, relationship types, and structures that form the
+ * foundation of the code intelligence graph. Ported from GitNexus graph
+ * primitives and adapted for CLEO's lightweight, in-process use case.
+ *
+ * @task T512
+ * @module contracts/graph
+ */
+
+// ---------------------------------------------------------------------------
+// Node kinds
+// ---------------------------------------------------------------------------
+
+/**
+ * All supported symbol node kinds in the code intelligence graph.
+ *
+ * Covers file/folder structural nodes plus every symbol-level construct
+ * that tree-sitter can identify across TypeScript, JavaScript, and future
+ * language providers. Includes synthetic graph-level nodes produced by
+ * analysis phases (community detection, process detection, route extraction).
+ *
+ * @since T529 — expanded from T512 baseline with 17 new kinds
+ */
+export type GraphNodeKind =
+  // Structural
+  | 'file'
+  | 'folder'
+  // Module-level
+  | 'module'
+  | 'namespace'
+  // Callable
+  | 'function'
+  | 'method'
+  | 'constructor'
+  // Type hierarchy
+  | 'class'
+  | 'interface'
+  | 'struct'
+  | 'trait'
+  | 'impl'
+  | 'type_alias'
+  | 'enum'
+  // Value-level
+  | 'property'
+  | 'constant'
+  | 'variable'
+  | 'static'
+  | 'record'
+  | 'delegate'
+  // Language-specific constructs
+  | 'macro'
+  | 'union'
+  | 'typedef'
+  | 'annotation'
+  | 'template'
+  // Graph-level (synthetic, from analysis phases)
+  | 'community'
+  | 'process'
+  | 'route'
+  | 'tool'
+  | 'section'
+  // Legacy (kept for T506 compatibility)
+  | 'import'
+  | 'export'
+  | 'type';
+
+// ---------------------------------------------------------------------------
+// Relationship types
+// ---------------------------------------------------------------------------
+
+/**
+ * All supported directed relationship types between graph nodes.
+ *
+ * Types are intentionally lowercase to match CLEO convention.
+ * Each type carries semantic meaning about the nature of the dependency.
+ *
+ * @since T529 — expanded from T512 baseline with 10 new relation types
+ */
+export type GraphRelationType =
+  // Structural
+  | 'contains'
+  // Definition / usage
+  | 'defines'
+  | 'imports'
+  | 'accesses'
+  // Callable
+  | 'calls'
+  // Type hierarchy
+  | 'extends'
+  | 'implements'
+  | 'method_overrides'
+  | 'method_implements'
+  // Class structure
+  | 'has_method'
+  | 'has_property'
+  // Graph-level (synthetic, from analysis phases)
+  | 'member_of' // symbol → community node
+  | 'step_in_process' // symbol → process node
+  // Web / API
+  | 'handles_route' // function → route node
+  | 'fetches' // function → external URL
+  // Tool / agent
+  | 'handles_tool'
+  | 'entry_point_of' // function → process node
+  // Wrapping / delegation
+  | 'wraps'
+  // Data access
+  | 'queries'
+  // Cross-graph (brain integration)
+  | 'documents' // brain node → nexus node
+  | 'applies_to'; // brain decision/learning → nexus node
+
+// ---------------------------------------------------------------------------
+// Node interface
+// ---------------------------------------------------------------------------
+
+/**
+ * A node in the code intelligence graph representing a symbol or structural
+ * element extracted from source code.
+ *
+ * The `id` field is a stable identifier for the node, typically derived from
+ * the file path and symbol name (e.g., `src/foo.ts::parseFile`).
+ */
+export interface GraphNode {
+  /** Unique, stable node identifier. Typically `<filePath>::<name>`. */
+  id: string;
+  /** Kind of code element this node represents. */
+  kind: GraphNodeKind;
+  /** Symbol name as it appears in source code. */
+  name: string;
+  /** File path relative to the project root. */
+  filePath: string;
+  /** Start line in the source file (1-based). */
+  startLine: number;
+  /** End line in the source file (1-based). */
+  endLine: number;
+  /** Language of the source file (e.g., "typescript", "javascript"). */
+  language: string;
+  /** Whether the symbol is publicly exported from its module. */
+  exported: boolean;
+  /** Parent node ID, if this symbol is nested (e.g., method inside class). */
+  parent?: string;
+  /** Parameter names or signatures for functions and methods. */
+  parameters?: string[];
+  /** Return type annotation text, if available. */
+  returnType?: string;
+  /** First line of the TSDoc/JSDoc comment for this symbol, if present. */
+  docSummary?: string;
+  /** Community ID this node belongs to (set after Phase 5 community detection). */
+  communityId?: string;
+  /** Execution flow process IDs this node participates in (set after Phase 6). */
+  processIds?: string[];
+  /** Kind-specific metadata blob (matches nexus_nodes.meta_json). */
+  meta?: Record<string, unknown>;
+}
+
+// ---------------------------------------------------------------------------
+// Relation interface
+// ---------------------------------------------------------------------------
+
+/**
+ * A directed relationship between two nodes in the code intelligence graph.
+ *
+ * The `source` and `target` fields reference node IDs (see {@link GraphNode.id}).
+ * Confidence reflects how certain the extractor is about this relationship,
+ * from 0.0 (speculative) to 1.0 (statically verified).
+ */
+export interface GraphRelation {
+  /** ID of the originating node. */
+  source: string;
+  /** ID of the target node. */
+  target: string;
+  /** Semantic type of the relationship. */
+  type: GraphRelationType;
+  /**
+   * Extractor confidence for this relationship (0.0 to 1.0).
+   *
+   * Common values by type:
+   * - `calls` / `imports`: 0.9 (direct, strongly typed)
+   * - `extends` / `implements`: 0.85 (statically verifiable)
+   * - `has_method` / `has_property`: 0.95 (structural containment)
+   * - `accesses`: 0.8 (field read/write, may be indirect)
+   */
+  confidence: number;
+  /** Human-readable note explaining why this relation was emitted. */
+  reason?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Impact analysis result
+// ---------------------------------------------------------------------------
+
+/**
+ * Result of a BFS-based impact analysis starting from a named symbol.
+ *
+ * Affected nodes are grouped into three depth tiers that reflect the
+ * likelihood and urgency of breakage:
+ *
+ * - **depth1_willBreak** (d=1): Direct callers/importers — WILL break.
+ *   Must be updated whenever the target changes.
+ * - **depth2_likelyAffected** (d=2): Indirect dependants — LIKELY affected.
+ *   Should be tested.
+ * - **depth3_mayNeedTesting** (d=3): Transitive dependants — MAY need testing.
+ *   Test if the symbol is on a critical path.
+ */
+export interface ImpactResult {
+  /** Name or ID of the symbol that was analyzed. */
+  target: string;
+  /**
+   * Overall risk classification based on the number and type of affected nodes.
+   *
+   * - `low`: 0–3 direct dependants, no cross-module spread
+   * - `medium`: 4–9 direct dependants, or limited cross-module spread
+   * - `high`: 10+ direct dependants, or significant cross-module spread
+   * - `critical`: Exported symbol with high cross-module usage
+   */
+  riskLevel: 'low' | 'medium' | 'high' | 'critical';
+  /** Human-readable summary of the impact analysis outcome. */
+  summary: string;
+  /** Nodes affected at each traversal depth. */
+  affectedByDepth: {
+    /** d=1: Direct dependants — WILL BREAK. */
+    depth1_willBreak: GraphNode[];
+    /** d=2: Indirect dependants — LIKELY AFFECTED. */
+    depth2_likelyAffected: GraphNode[];
+    /** d=3: Transitive dependants — MAY NEED TESTING. */
+    depth3_mayNeedTesting: GraphNode[];
+  };
+  /** Total number of affected nodes across all depths. */
+  totalAffected: number;
+}
+
+// ---------------------------------------------------------------------------
+// Pipeline interfaces (T529)
+// ---------------------------------------------------------------------------
+
+/**
+ * An in-memory symbol table entry tracking all files where a name appears.
+ * Used during ingestion to resolve cross-file call targets.
+ */
+export interface SymbolIndex {
+  /** Symbol name as it appears in source (e.g., "parseFile"). */
+  name: string;
+  /** All node IDs that define this name across the project. */
+  nodeIds: string[];
+  /** All file paths that export this name. */
+  exportingFiles: string[];
+}
+
+/**
+ * The in-memory KnowledgeGraph assembled during a single ingestion run.
+ * Flushed to nexus_nodes + nexus_relations after all phases complete.
+ */
+export interface KnowledgeGraph {
+  /** Primary node store: nodeId → GraphNode. */
+  nodes: Map<string, GraphNode>;
+  /** All directed edges (appended during ingestion, deduplicated at flush). */
+  relations: GraphRelation[];
+  /** Indexes for fast lookup during resolution phases. */
+  symbolTable: SymbolIndex[];
+  /** Files that changed since last index (incremental mode only). */
+  changedFiles?: Set<string>;
+}
+
+/**
+ * A community (module cluster) identified by Louvain community detection
+ * during Phase 5. Represents a group of cohesive symbols within the graph.
+ */
+export interface CommunityNode {
+  /** Node ID format: `community:<n>` */
+  id: string;
+  /** Inferred label from the top folder name. */
+  label: string;
+  /** Number of member symbols in this community. */
+  memberCount: number;
+  /** Top-level folders contributing most members. */
+  topFolders: string[];
+}
+
+/**
+ * A detected execution flow (process) from BFS entry point analysis
+ * during Phase 6. Represents a named sequence of function calls.
+ */
+export interface ProcessNode {
+  /** Node ID format: `process:<slug>` */
+  id: string;
+  /** Entry point function name used as the process label. */
+  label: string;
+  /** Node ID of the entry point function. */
+  entryPointId: string;
+  /** Ordered node IDs representing each step in the flow. */
+  stepIds: string[];
+  /** Total number of steps in this execution flow. */
+  stepCount: number;
+}

package/src/index.ts

@@ -108,6 +108,13 @@ export type {
   TaskQueryFilters,
   TransactionAccessor,
 } from './data-accessor.js';
+// === Dependency Registry Contracts ===
+export type {
+  DependencyCategory,
+  DependencyCheckResult,
+  DependencyReport,
+  DependencySpec,
+} from './dependency.js';
 export type { AdapterManifest, DetectionPattern } from './discovery.js';
 // === Error Utilities ===
 export {
@@ -164,6 +171,18 @@ export {
   AGENT_TYPES,
   BRAIN_OBSERVATION_TYPES,
 } from './facade.js';
+// === Graph Intelligence Types (T512, T529) ===
+export type {
+  CommunityNode,
+  GraphNode,
+  GraphNodeKind,
+  GraphRelation,
+  GraphRelationType,
+  ImpactResult,
+  KnowledgeGraph,
+  ProcessNode,
+  SymbolIndex,
+} from './graph.js';
 export type { AdapterHookProvider } from './hooks.js';
 export type { AdapterInstallProvider, InstallOptions, InstallResult } from './install.js';
 export type {