Files
rea/src/reference/ReferenceSourceReaderTypes.ts
T
morlutoandGitHub b8a9da0c0f refactor(mcp): make analysis states unrepresentable (#468)
* refactor(config): parse capability settings into exact states

* refactor(runtime): encode replay and process outcomes exactly

* refactor: make analysis states unrepresentable

* refactor(mcp): register canonical schemas with SDK

* fix: preserve capability and catalog invariants

* fix(build): remove stale compiled modules

* fix(replay): update real verifier policy dependency

* fix(package): verify the complete MCP catalog

* fix(test): supply complete replay reload policy

* refactor(contracts): centralize output schema lookup

* refactor(mcp): delegate protocol boundaries to SDK

* fix(browser): approve real source capture

* fix(mcp): preserve catalog guidance
2026-08-10 02:28:11 +08:00

106 lines
2.7 KiB
TypeScript

import { type BigIntStats } from "node:fs";
import { type Result } from "../domain/result.js";
export interface ReferenceSourceLimits {
readonly maxBytes: number;
readonly maxEntries: number;
readonly maxDepth: number;
readonly maxPathBytes: number;
}
export interface ReferenceSourceReaderOptions {
readonly signal?: AbortSignal;
readonly shouldExclude?: (path: string) => boolean;
}
export type ReferenceSourceFailureCode =
| "cancelled"
| "changed"
| "io"
| "limit"
| "symlink"
| "unsupported";
export type ReferenceSourceEntry =
| {
readonly status: "read";
readonly kind: "file";
readonly path: string;
readonly bytes: Uint8Array;
readonly size: number;
}
| {
readonly status: "read";
readonly kind: "directory";
readonly path: string;
}
| {
readonly status: "read";
readonly kind: "symlink";
readonly path: string;
readonly target: string;
readonly targetState: "internal" | "external" | "missing";
}
| {
readonly status: "failed";
readonly kind: "file" | "directory" | "symlink" | "other" | "unknown";
readonly path: string;
readonly code: ReferenceSourceFailureCode;
readonly message: string;
readonly size?: number;
};
export interface ReferenceSourceRead {
readonly root: string;
readonly entries: readonly ReferenceSourceEntry[];
readonly bytesRead: number;
readonly truncated: boolean;
/** Node exposes no portable openat traversal; pathname identity is checked around each operation. */
readonly limitations: readonly string[];
}
export interface ReferenceSourceReaderError {
readonly tag: "reference-source-reader";
readonly code:
| "cancelled"
| "invalid-limits"
| "invalid-root"
| "io"
| "unsupported";
readonly message: string;
}
export type BigStats = BigIntStats;
export type PendingDirectory = {
readonly path: string;
readonly depth: number;
};
export type TraversalState = {
readonly root: string;
readonly rootIdentity: BigStats;
readonly limits: ReferenceSourceLimits;
readonly signal?: AbortSignal;
readonly shouldExclude?: (path: string) => boolean;
readonly entries: ReferenceSourceEntry[];
readonly pending: PendingDirectory[];
bytesRead: number;
filesSeen: number;
truncated: boolean;
stopReason: "entry-limit" | undefined;
};
export type StableFileRequest = {
readonly root: string;
readonly rootIdentity: BigStats;
readonly absolute: string;
readonly path: string;
readonly expected: BigStats;
readonly remaining: number;
readonly signal?: AbortSignal;
};
export type ReferenceSourceResult<T> = Result<T, ReferenceSourceReaderError>;