/**
 * Route map and shape-check analysis for NEXUS code graph.
 *
 * Route nodes represent API/HTTP endpoints in the code graph.
 * This module provides primitives to:
 * - Map all routes to their handler functions and downstream dependencies
 * - Check response shape compatibility between handlers and callers
 *
 * @task T1064 — Route-Map and Shape-Check Commands
 */
import type { RouteMapResult, ShapeCheckResult } from '@cleocode/contracts/nexus-route-ops.js';
import { type EngineResult } from '../engine-result.js';
/**
 * Query all route nodes in the project and their handler relations.
 *
 * For each route, resolve:
 * - handles_route reverse-relation to find handler functions
 * - fetches forward-relations from handlers to external deps
 * - calls relations to find downstream callers
 *
 * @param projectId - Project identifier from registry
 * @param _projectRoot - Root directory of the project (unused, kept for signature)
 * @returns Promise resolving to route map entries
 */
export declare function getRouteMap(projectId: string, _projectRoot: string): Promise<RouteMapResult>;
/**
 * Check response shape compatibility between a route and its callers.
 *
 * Compares:
 * - Route's declared shape (from meta_json or return type)
 * - Each caller's expected shape (inferred from usage or return annotation)
 *
 * Currently limited to meta_json shape string equality due to lack of AST analysis.
 * A full implementation would require parsing type annotations and inferring shapes
 * from call sites, which is deferred to T1534 (AST-based shape inference).
 *
 * @param routeSymbol - Route symbol ID (format: `<filePath>::<routeName>`)
 * @param _projectId - Unused since ADR-090 · T11648 (project-scoped graph DB);
 *   kept for the dispatch signature.
 * @param _projectRoot - Root directory of the project (unused, kept for signature)
 * @returns Promise resolving to shape check result
 */
export declare function shapeCheck(routeSymbol: string, _projectId: string, _projectRoot: string): Promise<ShapeCheckResult>;
export declare function nexusRouteMap(projectId: string, projectRoot: string): Promise<EngineResult<RouteMapResult>>;
export declare function nexusShapeCheck(routeSymbol: string, projectId: string, projectRoot: string): Promise<EngineResult<ShapeCheckResult>>;
//# sourceMappingURL=route-analysis.d.ts.map