@adrkit/mcp 0.2.0

package/dist/corpus/ordering.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @adrkit/mcp — the one locale-independent comparator and the canonical orderings
+ * every channel uses. Never `String.prototype.localeCompare` (research §R6).
+ */
+import type { Finding } from '@adrkit/core';
+/** The sole code-unit comparator: `a < b ? -1 : a > b ? 1 : 0` over UTF-16 units. */
+export declare function compareCodeUnits(a: string, b: string): number;
+export interface OrderedSummary {
+    readonly id: string;
+    readonly sourcePath: string;
+}
+/** Canonical `(id, sourcePath)` ascending order; sourcePath is the unique tiebreak. */
+export declare function compareByIdThenPath(a: OrderedSummary, b: OrderedSummary): number;
+/** Canonical finding order using `sortFindings`' field tuple with the code-unit comparator. */
+export declare function compareFindings(a: Finding, b: Finding): number;
+export declare function sortFindingsCanonical(findings: readonly Finding[]): Finding[];
+export declare function sortByIdThenPath<T extends OrderedSummary>(items: readonly T[]): T[];

package/dist/corpus/projection.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @adrkit/mcp — the per-call, in-memory corpus projection (data-model.md §3, §8).
+ *
+ * Rebuilt from scratch on every tool call: fresh canonical-root validation, the
+ * pre-read 64 KiB size guard, `discoverAdrFiles` + `lintCorpus`, a local multi-valued
+ * `byId` index, immutable corpus findings, and a canonical SHA-256 fingerprint.
+ * No cache, index, or database of any kind.
+ */
+import { type Adr, type Finding } from '@adrkit/core';
+export declare const MAX_SOURCE_BYTES: number;
+export type CorpusUnavailableReason = 'root-not-found' | 'root-not-directory' | 'root-not-readable' | 'root-not-git' | 'dir-not-found' | 'dir-not-directory' | 'dir-not-readable' | 'dir-outside-root' | 'corpus-changed-during-load';
+/** Typed rejection carrying one of the `CorpusUnavailableOutcome` reasons (data-model.md §5). */
+export declare class CorpusUnavailableError extends Error {
+    readonly reason: CorpusUnavailableReason;
+    constructor(reason: CorpusUnavailableReason);
+}
+export interface CorpusHealth {
+    readonly fingerprint: string;
+    readonly recordCount: number;
+    readonly excludedCount: number;
+}
+export interface CorpusProjection {
+    readonly records: readonly Adr[];
+    readonly byId: ReadonlyMap<string, readonly Adr[]>;
+    readonly corpusFindings: readonly Finding[];
+    readonly fingerprint: string;
+    readonly recordCount: number;
+    readonly excludedCount: number;
+}
+export interface ResolveCanonicalRootsOptions {
+    readonly cwd: string;
+    readonly dir: string;
+}
+export interface CanonicalRoots {
+    readonly canonicalCwd: string;
+    readonly canonicalDir: string;
+}
+/** The one canonicalization/containment routine both `start()` and every load call use. */
+export declare function resolveCanonicalRoots(options: ResolveCanonicalRootsOptions): Promise<CanonicalRoots>;
+export interface LoadCorpusProjectionOptions {
+    readonly configuredCwd: string;
+    readonly configuredDir: string;
+    readonly expectedCanonicalCwd: string;
+    readonly maxSourceBytes: number;
+}
+/** The one entry point every tool handler calls, fresh, at the start of its execution. */
+export declare function loadCorpusProjection(options: LoadCorpusProjectionOptions): Promise<CorpusProjection>;

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @adrkit/mcp — public entry point.
+ *
+ * Exports ONLY the sealed stdio lifecycle factory and its option/handle types.
+ * No SDK server, registration API, internal builder, transport, or test subpath is
+ * reachable from here. No side effects at import time; no filesystem access at
+ * construction time (data-model.md §8, contracts/tools.md §1).
+ */
+export interface AdrkitMcpServerOptions {
+    readonly cwd: string;
+    readonly dir: string;
+}
+export interface AdrkitMcpServerHandle {
+    start(): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * The public stdio lifecycle factory. Performs NO filesystem access at construction;
+ * `start()` validates the configured root, builds the closure-private server, creates
+ * exactly one `StdioServerTransport`, and connects it. The concrete server, its
+ * registrations, and its transport remain unreachable to the caller.
+ */
+export declare function createAdrkitMcpServer(options?: Partial<AdrkitMcpServerOptions>): Readonly<AdrkitMcpServerHandle>;