@wrtnlabs/evidence 0.0.0 → 0.1.0

package/lib/internal/IEvidenceTreeSitterAssetOptions.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Execution-local controls for immutable grammar acquisition.
+ *
+ * These options influence one caller's cache and transfer lifetime; they do not
+ * alter catalog provenance or the bytes accepted into the shared cache.
+ */
+export interface IEvidenceTreeSitterAssetOptions {
+    /**
+     * Writable root for the immutable grammar cache.
+     *
+     * Omission first uses `EVID_CACHE_DIR`, then `node_modules/.cache/evidence`
+     * under the current working directory. `EvidenceTreeSitterAssetCache` places
+     * verified grammar bytes below this root and never treats it as catalog
+     * provenance.
+     */
+    cacheDirectory?: string;
+    /**
+     * HTTP transport used to fetch a missing grammar asset.
+     *
+     * Omission uses the platform fetch implementation. Tests and embedding
+     * callers can supply a transport without changing checksum verification or
+     * cache keys.
+     */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Maximum duration of one transfer, including its response body, in
+     * milliseconds.
+     *
+     * Omission defaults to 30 seconds. The limit applies to each attempt rather
+     * than the caller's complete retry lifetime.
+     */
+    timeoutMilliseconds?: number;
+    /**
+     * Maximum transfer attempts allowed for transient acquisition failures.
+     *
+     * Omission defaults to three. Shared callers join one immutable transfer, so
+     * this bound controls its retries instead of multiplying requests per
+     * caller.
+     */
+    attempts?: number;
+    /**
+     * Signal that stops this caller's wait for a grammar acquisition.
+     *
+     * Aborting one waiter does not cancel other callers sharing the immutable
+     * transfer; the cache cancels transfer work only after every waiter leaves.
+     */
+    signal?: AbortSignal | undefined;
+    /**
+     * Caller-owned sink for grammar acquisition progress messages.
+     *
+     * Omission keeps library acquisition silent. The cache reports progress
+     * through this callback without writing to process output or changing
+     * transfer results.
+     */
+    progress?: ((message: string) => void) | undefined;
+}

package/lib/internal/IEvidenceTreeSitterAssetOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/internal/IEvidenceTreeSitterAssetPending.d.ts

@@ -0,0 +1,31 @@
+/**
+ * One process-wide transfer shared by callers targeting the same immutable
+ * cache entry.
+ *
+ * Consumer accounting lets an individual cancellation return promptly while
+ * transfer work continues for peers, then aborts only after the final waiter
+ * leaves.
+ */
+export interface IEvidenceTreeSitterAssetPending {
+    /**
+     * Promise for verified bytes after successful atomic cache publication.
+     *
+     * Each joining caller awaits this shared result, so checksum verification and
+     * publication run once for the immutable cache entry.
+     */
+    promise: Promise<Uint8Array>;
+    /**
+     * Controller that cancels transfer work after every waiting consumer leaves.
+     *
+     * A single caller's cancellation removes only its own wait and leaves the
+     * shared transfer available to remaining consumers.
+     */
+    controller: AbortController;
+    /**
+     * Number of callers still awaiting this transfer's result.
+     *
+     * Asset-cache cancellation decrements this count and aborts the controller
+     * only when it reaches zero.
+     */
+    consumers: number;
+}

package/lib/internal/IEvidenceTreeSitterAssetPending.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/internal/IEvidenceTtsxExecutables.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Executable mapping from the consumer-installed `ttsc` package manifest.
+ *
+ * The isolated configuration evaluator reads this projection through
+ * `IEvidenceTtsxManifest` so it can invoke the consumer's compiler launcher
+ * instead of resolving a tool from Evidence's own dependency graph.
+ */
+export interface IEvidenceTtsxExecutables {
+    /**
+     * Relative path to the `ttsx` launcher within the installed `ttsc` package.
+     *
+     * The evaluator resolves this path against the manifest directory before it
+     * starts the temporary project that evaluates the user's configuration.
+     */
+    ttsx: string;
+}

package/lib/internal/IEvidenceTtsxExecutables.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/internal/IEvidenceTtsxManifest.d.ts

@@ -0,0 +1,19 @@
+import type { IEvidenceTtsxExecutables } from "./IEvidenceTtsxExecutables";
+/**
+ * Consumer-installed `ttsc` manifest fields required for isolated configuration
+ * evaluation.
+ *
+ * `evaluateTypeScriptConfig` validates this narrow manifest projection after
+ * resolving `ttsc` from the config's dependency graph, then uses its executable
+ * mapping to start the matching `ttsx` launcher.
+ */
+export interface IEvidenceTtsxManifest {
+    /**
+     * Declared executable names and relative paths from the installed package.
+     *
+     * The evaluator consumes the `ttsx` entry in this mapping through
+     * `IEvidenceTtsxExecutables`; no other package manifest fields affect the
+     * launch.
+     */
+    bin: IEvidenceTtsxExecutables;
+}

package/lib/internal/IEvidenceTtsxManifest.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/internal/IEvidenceUnhostedChecklist.d.ts

@@ -8,7 +8,8 @@ import type { EvidenceSeverity } from "../typings/EvidenceSeverity";
  */
 export interface IEvidenceUnhostedChecklist {
     /**
-     * Authored checklist declaration retained for later attachment or diagnostics.
+     * Authored checklist declaration retained for later attachment or
+     * diagnostics.
      *
      * The graph holds this source record until structural ownership establishes
      * which selected claim units its host can affect.

package/lib/internal/IEvidenceWatchAttempt.d.ts

@@ -1,6 +1,6 @@
 import type { IEvidenceSourceDependency } from "../structures/IEvidenceSourceDependency";
 import type { EvidenceWatchCycle } from "../typings/EvidenceWatchCycle";
-import type { WatchDependencySnapshot } from "./WatchDependencySnapshot";
+import type { EvidenceWatchDependencySnapshot } from "./EvidenceWatchDependencySnapshot";
 /**
  * Stable unpublished result and dependency baseline for one watch attempt.
  *
@@ -11,8 +11,8 @@ export interface IEvidenceWatchAttempt {
     /**
      * Completed check or operational failure produced by the attempt.
      *
-     * Watch publication exposes this result only after verifying that its captured
-     * dependencies still match the associated snapshot.
+     * Watch publication exposes this result only after verifying that its
+     * captured dependencies still match the associated snapshot.
      */
     cycle: EvidenceWatchCycle;
     /**
@@ -23,14 +23,16 @@ export interface IEvidenceWatchAttempt {
      */
     dependencies: IEvidenceSourceDependency[];
     /**
-     * Captured versions proving those dependencies stayed stable during evaluation.
+     * Captured versions proving those dependencies stayed stable during
+     * evaluation.
      *
      * Comparing this snapshot before publication prevents an asynchronous check
      * from reporting a result for an already changed source graph.
      */
-    snapshot: WatchDependencySnapshot;
+    snapshot: EvidenceWatchDependencySnapshot;
     /**
-     * Whether parser preparation failed and should be retried independently of source edits.
+     * Whether parser preparation failed and should be retried independently of
+     * source edits.
      *
      * A true value schedules recovery for transient parser setup failures even
      * when no watched source dependency changes.

package/lib/internal/createEvidenceConfigPlan.js

@@ -45,25 +45,34 @@ function createEvidenceConfigPlan(config, configFile) {
     });
     return { configFile: filename, claims };
 }
-/** Narrows a retained severity and defends the invariant established by plan filtering.
+/**
+ * Narrows a retained severity and defends the invariant established by plan
+ * filtering.
  *
- * Plan construction has already removed unsupported values, so this helper documents and enforces the remaining configuration contract.
+ * Plan construction has already removed unsupported values, so this helper
+ * documents and enforces the remaining configuration contract.
  */
 function active(severity) {
     if (severity === "off")
-        throw new Error("An inactive severity cannot enter the Evidence config plan.");
+        throw new Error("An inactive severity cannot enter the Evidence Graph config plan.");
     return severity;
 }
-/** Normalizes singular and plural reference syntax without changing reference order.
+/**
+ * Normalizes singular and plural reference syntax without changing reference
+ * order.
  *
- * Later plan consumers preserve that order when resolving target applicability and reporting configuration results.
+ * Later plan consumers preserve that order when resolving target applicability
+ * and reporting configuration results.
  */
 function referenceList(claim) {
     return Array.isArray(claim.reference) ? claim.reference : [claim.reference];
 }
-/** Applies artifact defaults only when configuration did not explicitly select symbols.
+/**
+ * Applies artifact defaults only when configuration did not explicitly select
+ * symbols.
  *
- * An explicit empty or narrowed symbol selection is never replaced by the artifact's broad default population.
+ * An explicit empty or narrowed symbol selection is never replaced by the
+ * artifact's broad default population.
  */
 function symbols(population, reference) {
     if (population.symbol !== undefined)

package/lib/internal/evaluateTypeScriptConfig.d.ts

@@ -1,9 +1,10 @@
-import type { IEvaluateTypeScriptConfigOptions } from "./IEvaluateTypeScriptConfigOptions";
+import type { IEvidenceEvaluateTypeScriptConfigOptions } from "./IEvidenceEvaluateTypeScriptConfigOptions";
 /**
- * Typechecks and evaluates a config in an isolated temporary project through its own ttsx.
+ * Typechecks and evaluates a config in an isolated temporary project through
+ * its own ttsx.
  *
  * The evaluator resolves the consumer's compiler rather than this package's,
  * and serializes the default export with V8 so invalid configuration values
  * reach parent-side validation without JSON silently dropping them.
  */
-export declare function evaluateTypeScriptConfig(configFile: string, options?: IEvaluateTypeScriptConfigOptions): Promise<unknown>;
+export declare function evaluateTypeScriptConfig(configFile: string, options?: IEvidenceEvaluateTypeScriptConfigOptions): Promise<unknown>;

package/lib/internal/evaluateTypeScriptConfig.js

@@ -47,7 +47,8 @@ const node_path_1 = __importDefault(require("node:path"));
 const node_v8_1 = require("node:v8");
 const typia_1 = __importDefault(require("typia"));
 /**
- * Typechecks and evaluates a config in an isolated temporary project through its own ttsx.
+ * Typechecks and evaluates a config in an isolated temporary project through
+ * its own ttsx.
  *
  * The evaluator resolves the consumer's compiler rather than this package's,
  * and serializes the default export with V8 so invalid configuration values
@@ -63,12 +64,12 @@ async function evaluateTypeScriptConfig(configFile, options = {}) {
             const _ao0 = (input, _path, _exceptionable = true) => ("object" === typeof input.bin && null !== input.bin || _assertGuard_1._assertGuard(_exceptionable, {
                 method: "typia.json.assertParse",
                 path: _path + ".bin",
-                expected: "ITtsxExecutables",
+                expected: "IEvidenceTtsxExecutables",
                 value: input.bin
             }, _errorFactory)) && _ao1(input.bin, _path + ".bin", true && _exceptionable) || _assertGuard_1._assertGuard(_exceptionable, {
                 method: "typia.json.assertParse",
                 path: _path + ".bin",
-                expected: "ITtsxExecutables",
+                expected: "IEvidenceTtsxExecutables",
                 value: input.bin
             }, _errorFactory);
             const _ao1 = (input, _path, _exceptionable = true) => "string" === typeof input.ttsx || _assertGuard_1._assertGuard(_exceptionable, {
@@ -87,12 +88,12 @@ async function evaluateTypeScriptConfig(configFile, options = {}) {
                     ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _assertGuard_1._assertGuard(true, {
                         method: "typia.json.assertParse",
                         path: _path + "",
-                        expected: "ITtsxManifest",
+                        expected: "IEvidenceTtsxManifest",
                         value: input
                     }, _errorFactory)) && _ao0(input, _path + "", true) || _assertGuard_1._assertGuard(true, {
                         method: "typia.json.assertParse",
                         path: _path + "",
-                        expected: "ITtsxManifest",
+                        expected: "IEvidenceTtsxManifest",
                         value: input
                     }, _errorFactory))(input, "$input", true);
                 }
@@ -108,7 +109,7 @@ async function evaluateTypeScriptConfig(configFile, options = {}) {
             throw new Error("Compiler launcher or platform binary is not a file.");
     }
     catch (cause) {
-        throw new Error(`Cannot resolve the compiler for ${configFile}. Install it with: pnpm i -D typescript ttsc @wrtnlabs/evidence`, { cause });
+        throw new Error(`Cannot resolve the compiler for ${configFile}. Install it with: pnpm i -D typescript ttsc evidence`, { cause });
     }
     const directory = node_path_1.default.dirname(configFile);
     const nodeModules = await findNodeModules(directory);
@@ -201,9 +202,12 @@ async function evaluateTypeScriptConfig(configFile, options = {}) {
         });
     }
 }
-/** Starts the isolated evaluator and forwards compiler output without parsing or rewriting it.
+/**
+ * Starts the isolated evaluator and forwards compiler output without parsing or
+ * rewriting it.
  *
- * Config loading owns the failure boundary, while this helper preserves TypeScript and runtime diagnostics in their original format.
+ * Config loading owns the failure boundary, while this helper preserves
+ * TypeScript and runtime diagnostics in their original format.
  */
 function runEvaluator(configFile, args, writeDiagnostic) {
     return new Promise((resolve, reject) => {
@@ -229,16 +233,22 @@ function runEvaluator(configFile, args, writeDiagnostic) {
         });
     });
 }
-/** Writes child diagnostics to the parent process while preserving compiler formatting.
+/**
+ * Writes child diagnostics to the parent process while preserving compiler
+ * formatting.
  *
- * The evaluator streams both output channels here so users receive compiler context before config loading rejects.
+ * The evaluator streams both output channels here so users receive compiler
+ * context before config loading rejects.
  */
 function writeProcessDiagnostic(content) {
     process.stderr.write(content);
 }
-/** Determines module kind from Node's nearest package boundary without inheriting application tsconfig settings.
+/**
+ * Determines module kind from Node's nearest package boundary without
+ * inheriting application tsconfig settings.
  *
- * The temporary evaluator must follow the configuration file's runtime module rules, rather than unrelated compiler options from the application.
+ * The temporary evaluator must follow the configuration file's runtime module
+ * rules, rather than unrelated compiler options from the application.
  */
 async function configModule(configFile) {
     if (node_path_1.default.extname(configFile) === ".mts")
@@ -265,12 +275,12 @@ async function configModule(configFile) {
                         ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input && false === Array.isArray(input) || _assertGuard_1._assertGuard(true, {
                             method: "typia.json.assertParse",
                             path: _path + "",
-                            expected: "IConfigPackageScope",
+                            expected: "IEvidenceConfigPackageScope",
                             value: input
                         }, _errorFactory)) && _ao0(input, _path + "", true) || _assertGuard_1._assertGuard(true, {
                             method: "typia.json.assertParse",
                             path: _path + "",
-                            expected: "IConfigPackageScope",
+                            expected: "IEvidenceConfigPackageScope",
                             value: input
                         }, _errorFactory))(input, "$input", true);
                     }
@@ -286,9 +296,12 @@ async function configModule(configFile) {
         directory = parent;
     }
 }
-/** Finds the nearest reusable dependency tree so the temporary project resolves the consumer's packages.
+/**
+ * Finds the nearest reusable dependency tree so the temporary project resolves
+ * the consumer's packages.
  *
- * The evaluator links this tree instead of resolving dependencies from Evidence's own installation location.
+ * The evaluator links this tree instead of resolving dependencies from
+ * Evidence's own installation location.
  */
 async function findNodeModules(start) {
     let directory = start;
@@ -302,9 +315,12 @@ async function findNodeModules(start) {
         directory = parent;
     }
 }
-/** Chooses a temporary evaluator directory outside dependencies and on the config's volume.
+/**
+ * Chooses a temporary evaluator directory outside dependencies and on the
+ * config's volume.
  *
- * Keeping the generated project on that volume permits valid relative links when the system temp directory is on another drive.
+ * Keeping the generated project on that volume permits valid relative links
+ * when the system temp directory is on another drive.
  */
 async function tempBase(configFile, nodeModules) {
     const system = await (0, promises_1.realpath)((0, node_os_1.tmpdir)());
@@ -320,9 +336,12 @@ async function tempBase(configFile, nodeModules) {
     await (0, promises_1.mkdir)(directory, { recursive: true });
     return (0, promises_1.realpath)(directory);
 }
-/** Treats absent paths as false while preserving unexpected filesystem failures for diagnostics.
+/**
+ * Treats absent paths as false while preserving unexpected filesystem failures
+ * for diagnostics.
  *
- * Callers can probe optional package and dependency boundaries without hiding permission or device errors.
+ * Callers can probe optional package and dependency boundaries without hiding
+ * permission or device errors.
  */
 async function exists(file) {
     try {

package/lib/internal/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Supported advanced source, configuration, and parser-cache utilities.
+ *
+ * Test and integration authors use these boundaries through the package entry
+ * point rather than reaching into package source paths. Other internal modules
+ * remain implementation details and are intentionally not re-exported.
+ */
+export * from "./createEvidenceConfigPlan";
+export * from "./evaluateTypeScriptConfig";
+export * from "./EvidenceConfigDependencyScanner";
+export * from "./EvidenceFileGlob";
+export * from "./EvidenceSourcePath";
+export * from "./EvidenceSourceText";
+export * from "./EvidenceTreeSitterAssetCache";
+export * from "./EvidenceTreeSitterAssets";
+export * from "./EvidenceTreeSitterAssetScope";
+export * from "./EvidenceWatchDependencySnapshot";
+export * from "./validateEvidenceConfig";

package/lib/internal/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Supported advanced source, configuration, and parser-cache utilities.
+ *
+ * Test and integration authors use these boundaries through the package entry
+ * point rather than reaching into package source paths. Other internal modules
+ * remain implementation details and are intentionally not re-exported.
+ */
+__exportStar(require("./createEvidenceConfigPlan"), exports);
+__exportStar(require("./evaluateTypeScriptConfig"), exports);
+__exportStar(require("./EvidenceConfigDependencyScanner"), exports);
+__exportStar(require("./EvidenceFileGlob"), exports);
+__exportStar(require("./EvidenceSourcePath"), exports);
+__exportStar(require("./EvidenceSourceText"), exports);
+__exportStar(require("./EvidenceTreeSitterAssetCache"), exports);
+__exportStar(require("./EvidenceTreeSitterAssets"), exports);
+__exportStar(require("./EvidenceTreeSitterAssetScope"), exports);
+__exportStar(require("./EvidenceWatchDependencySnapshot"), exports);
+__exportStar(require("./validateEvidenceConfig"), exports);

package/lib/internal/validateEvidenceConfig.d.ts

@@ -3,6 +3,7 @@ import type { IEvidenceConfig } from "../structures/IEvidenceConfig";
  * Collects all configuration contract violations before plan construction.
  *
  * Validation does not stop at the first error so users can repair related
- * population policy mistakes together, including entries later disabled by severity.
+ * population policy mistakes together, including entries later disabled by
+ * severity.
  */
 export declare function validateEvidenceConfig(config: IEvidenceConfig, configFile?: string): void;

package/lib/internal/validateEvidenceConfig.js

@@ -4,14 +4,15 @@ exports.validateEvidenceConfig = validateEvidenceConfig;
 const node_path_1 = require("node:path");
 const EvidenceLanguageRegistry_1 = require("../parsers/EvidenceLanguageRegistry");
 const EvidenceArtifactTypes_1 = require("./EvidenceArtifactTypes");
-const FileGlob_1 = require("./FileGlob");
-const SourcePath_1 = require("./SourcePath");
-const SwaggerRemoteReader_1 = require("../adapters/swagger/SwaggerRemoteReader");
+const EvidenceFileGlob_1 = require("./EvidenceFileGlob");
+const EvidenceSourcePath_1 = require("./EvidenceSourcePath");
+const EvidenceSwaggerRemoteReader_1 = require("../adapters/swagger/EvidenceSwaggerRemoteReader");
 /**
  * Collects all configuration contract violations before plan construction.
  *
  * Validation does not stop at the first error so users can repair related
- * population policy mistakes together, including entries later disabled by severity.
+ * population policy mistakes together, including entries later disabled by
+ * severity.
  */
 function validateEvidenceConfig(config, configFile = (0, node_path_1.resolve)("evidence.config.ts")) {
     const problems = [];
@@ -56,7 +57,7 @@ function validateEvidenceConfig(config, configFile = (0, node_path_1.resolve)("e
     });
     if (problems.length !== 0)
         throw new Error([
-            "Invalid Evidence configuration:",
+            "Invalid Evidence Graph configuration:",
             ...problems.map((item) => `- ${item}`),
         ].join("\n"));
 }
@@ -64,7 +65,8 @@ function validateEvidenceConfig(config, configFile = (0, node_path_1.resolve)("e
  * Requires each configured artifact type to have a complete certified adapter.
  *
  * Configuration validation uses the registry-backed artifact list rather than
- * accepting a parser grammar that cannot produce a supported Evidence inventory.
+ * accepting a parser grammar that cannot produce a supported Evidence
+ * inventory.
  */
 function validateArtifactType(problems, path, type) {
     if (EvidenceArtifactTypes_1.EvidenceArtifactTypes.isSupported(type))
@@ -74,12 +76,13 @@ function validateArtifactType(problems, path, type) {
 /**
  * Validates file selection through the restricted matcher used by discovery.
  *
- * Constructing FileGlob checks every configured pattern before plan construction,
- * and this helper accumulates its message with the owning configuration path.
+ * Constructing EvidenceFileGlob checks every configured pattern before plan
+ * construction, and this helper accumulates its message with the owning
+ * configuration path.
  */
 function validateGlobs(problems, path, patterns) {
     try {
-        new FileGlob_1.FileGlob(patterns);
+        new EvidenceFileGlob_1.EvidenceFileGlob(patterns);
     }
     catch (cause) {
         problems.push(`${path}: ${message(cause)}`);
@@ -88,24 +91,27 @@ function validateGlobs(problems, path, patterns) {
 /**
  * Validates configured root spelling without requiring the directory to exist.
  *
- * SourcePath.root performs the same lexical resolution used by loading, allowing
- * a valid future directory while rejecting unsafe or invalid root expressions.
+ * EvidenceSourcePath.root performs the same lexical resolution used by loading,
+ * allowing a valid future directory while rejecting unsafe or invalid root
+ * expressions.
  */
 function validateRoot(problems, path, configFile, root) {
     if (root === undefined)
         return;
     try {
-        SourcePath_1.SourcePath.root(configFile, root);
+        EvidenceSourcePath_1.EvidenceSourcePath.root(configFile, root);
     }
     catch (cause) {
         problems.push(`${path}: ${message(cause)}`);
     }
 }
 /**
- * Checks explicit symbol selections when a language adapter supplies a supported set.
+ * Checks explicit symbol selections when a language adapter supplies a
+ * supported set.
  *
  * Empty arrays select no units, while named selections must match the adapter's
- * published symbols; artifact types without symbol metadata remain unrestricted.
+ * published symbols; artifact types without symbol metadata remain
+ * unrestricted.
  */
 function validateSymbols(problems, path, symbol, type) {
     if (Array.isArray(symbol) && symbol.length === 0)
@@ -120,16 +126,17 @@ function validateSymbols(problems, path, symbol, type) {
 /**
  * Requires one exact local or supported remote Swagger document source.
  *
- * Remote URLs are accepted only through SwaggerRemoteReader; local spellings are
- * resolved and rejected when they name a directory-like location rather than a file.
+ * Remote URLs are accepted only through EvidenceSwaggerRemoteReader; local
+ * spellings are resolved and rejected when they name a directory-like location
+ * rather than a file.
  */
 function validateSwaggerSource(problems, path, file) {
     try {
         if (file === "" || file.trim() !== file)
             throw new Error("A Swagger source must not be empty or padded.");
-        if (SwaggerRemoteReader_1.SwaggerRemoteReader.parse(file) !== undefined)
+        if (EvidenceSwaggerRemoteReader_1.EvidenceSwaggerRemoteReader.parse(file) !== undefined)
             return;
-        SourcePath_1.SourcePath.resolve(".", file);
+        EvidenceSourcePath_1.EvidenceSourcePath.resolve(".", file);
         const normalized = file.replaceAll("\\", "/");
         if (normalized.endsWith("/") ||
             normalized === "." ||
@@ -147,7 +154,8 @@ function validateSwaggerSource(problems, path, file) {
  * Converts validation helper failures into stable user-facing problem text.
  *
  * Each validator appends this normalized message to the aggregate error so one
- * malformed value does not prevent reporting the remaining configuration issues.
+ * malformed value does not prevent reporting the remaining configuration
+ * issues.
  */
 function message(cause) {
     return cause instanceof Error ? cause.message : String(cause);

package/lib/loaders/EvidenceConfigLoader.d.ts

@@ -3,24 +3,26 @@ import type { IEvidenceConfigPlan } from "../structures/IEvidenceConfigPlan";
 /**
  * Loads and validates Evidence configuration before artifact I/O begins.
  *
- * JSON is read as data; TypeScript is evaluated through the consumer's ttsx with
- * output isolated from report stdout. Validation covers disabled declarations too.
- * Call load to retain authored configuration or plan to resolve inherited policy
- * and remove inactive populations before source discovery.
+ * JSON is read as data; TypeScript is evaluated through the consumer's ttsx
+ * with output isolated from report stdout. Validation covers disabled
+ * declarations too. Call load to retain authored configuration or plan to
+ * resolve inherited policy and remove inactive populations before source
+ * discovery.
  *
  * @example
- * const plan: IEvidenceConfigPlan = await EvidenceConfigLoader.plan(
- *   "./config/evidence.config.ts",
- * );
- * // Population roots are anchored to the resolved configuration file.
+ *   const plan: IEvidenceConfigPlan = await EvidenceConfigLoader.plan(
+ *     "./config/evidence.config.ts",
+ *   );
+ *   // Population roots are anchored to the resolved configuration file.
  */
 export declare namespace EvidenceConfigLoader {
     /**
      * Loads authored configuration and validates every claim and reference.
      *
-     * JSON data and TypeScript default exports share artifact and shape validation.
-     * Evaluation output goes to stderr, and failures reject rather than returning
-     * partially validated configuration. Inactive declarations are still checked.
+     * JSON data and TypeScript default exports share artifact and shape
+     * validation. Evaluation output goes to stderr, and failures reject rather
+     * than returning partially validated configuration. Inactive declarations are
+     * still checked.
      *
      * @param file Configuration path, relative to the current working directory.
      */