@paraharness/fs 0.0.0-stage → 0.1.0

package/dist/builders/fs-namespace-contract.d.ts

@@ -0,0 +1,187 @@
+import type { FsAllowOnlyGuardNode, FsBoundaryGuardNode, FsEditToolNode, FsGlobMatcherNode, FsGlobSourceNode, FsGlobToolNode, FsGrepToolNode, FsJsonlLessonStoreNode, FsPartitionMapNode, FsPartitionPathMapping, FsProtectGuardNode, FsQuotaTripwireNode, FsReadOnlyGuardNode, FsReadToolNode, FsRegexCheckNode, FsRequireReadBeforeWriteGuardNode, FsScopedWriteGuardNode, FsSecretLiteralsGuardNode, FsTelemetryCollectorNode, FsTextSourceNode, FsWriteGuardNode, FsWriteToolNode, LeaseDelta, MaybeBuilder, NodeRunnerNode, ScopePredicate, TopologyNode } from '@paraharness/core';
+import type { FsJsonlLessonStoreOptions } from './create-fs-jsonl-lesson-store-builder.js';
+import type { FsRegexCheckOptions } from './create-fs-regex-check-builder.js';
+import type { FsWriteGuardOptions } from './create-fs-write-guard-builder.js';
+/**
+ * Declarative builder namespace (`fs.*`) for `@paraharness/fs` sources, partition maps, guards, tools, and stores.
+ *
+ * Every method returns a passive, frozen AST node or serializable `LeaseDelta` / `ScopePredicate`
+ * with zero import-time or declaration-time filesystem I/O.
+ */
+export interface FsNamespace {
+    /**
+     * Compiles a passive `FsTextSourceNode` loading UTF-8 text from `filePath`.
+     *
+     * Resolves against the host repository root or active `ResolutionContext.scopeHandle`.
+     * @param {string} filePath - Repository-relative path to the UTF-8 file.
+     * @returns {FsTextSourceNode} Frozen `FsTextSourceNode` descriptor.
+     */
+    text(filePath: string): FsTextSourceNode;
+    /**
+     * Compiles a passive `FsGlobSourceNode` loading all UTF-8 files matching `globPattern`.
+     *
+     * Resolves matching files in deterministic lexicographical order with a SHA-256 digest.
+     * @param {string} globPattern - POSIX glob pattern matched against the repository root.
+     * @returns {FsGlobSourceNode} Frozen `FsGlobSourceNode` descriptor.
+     */
+    glob(globPattern: string): FsGlobSourceNode;
+    /**
+     * Compiles a passive `FsGlobMatcherNode` matching `FsToolEffect` paths against `globs`.
+     *
+     * Matches both exact normalized file paths and POSIX glob patterns.
+     * @param {readonly string[]}        globs          - Glob patterns or exact file paths.
+     * @param {'read' | 'write' | 'any'} [mode='write'] - Access mode filter.
+     * @returns {FsGlobMatcherNode} Frozen `FsGlobMatcherNode` descriptor.
+     */
+    matchGlobs(globs: readonly string[], mode?: 'read' | 'write' | 'any'): FsGlobMatcherNode;
+    /**
+     * Compiles a passive `FsPartitionMapNode` mapping logical `topology` partitions to file globs.
+     *
+     * Binds each partition to its implementation `globs` and public `boundaryGlobs`.
+     * @template TPartition Literal union of partition identifiers in `topology`.
+     * @param {MaybeBuilder<TopologyNode<TPartition>>}               topology - Relational topology AST node or builder.
+     * @param {Readonly<Record<TPartition, FsPartitionPathMapping>>} mapping  - Per-partition glob mapping.
+     * @returns {FsPartitionMapNode<TPartition>} Frozen `FsPartitionMapNode` descriptor.
+     */
+    partitionMap<TPartition extends string = string>(topology: MaybeBuilder<TopologyNode<TPartition>>, mapping: Readonly<Record<TPartition, FsPartitionPathMapping>>): FsPartitionMapNode<TPartition>;
+    /**
+     * Builds a `ScopePredicate` scoping rules or skills to `partitionId` in `partitionMap`.
+     *
+     * Combines Turn-0 `partitions: [partitionId]` with reactive `'any'`-mode `effects` matching.
+     * @template TPartition Literal union of partition identifiers in `partitionMap`.
+     * @param {FsPartitionMapNode<TPartition>} partitionMap - Filesystem partition map AST node.
+     * @param {TPartition}                     partitionId  - Target partition identifier.
+     * @returns {ScopePredicate} Frozen `ScopePredicate` record.
+     */
+    inPartition<TPartition extends string = string>(partitionMap: FsPartitionMapNode<TPartition>, partitionId: TPartition): ScopePredicate;
+    /**
+     * Compiles a passive `FsBoundaryGuardNode` blocking unleased writes to partition `boundaryGlobs`.
+     *
+     * Projects `violatedEffects` strictly to the violating boundary file paths.
+     * @template TPartition Literal union of partition identifiers in `partitionMap`.
+     * @param {FsPartitionMapNode<TPartition>} partitionMap - Filesystem partition map AST node.
+     * @returns {FsBoundaryGuardNode} Frozen `FsBoundaryGuardNode` descriptor.
+     */
+    boundaryGuard<TPartition extends string = string>(partitionMap: FsPartitionMapNode<TPartition>): FsBoundaryGuardNode;
+    /**
+     * Compiles a passive `FsWriteGuardNode` enforcing glob-based write allow/deny rules.
+     *
+     * Supports `onlyExistingAtBaseRef: true` to block edits to existing files while allowing new files.
+     * @param {FsWriteGuardOptions} options - Write guard configuration options.
+     * @returns {FsWriteGuardNode} Frozen `FsWriteGuardNode` descriptor.
+     */
+    writeGuard(options: FsWriteGuardOptions): FsWriteGuardNode;
+    /**
+     * Compiles a passive `FsProtectGuardNode` protecting `globs` from unleased write mutations.
+     *
+     * Projects `violatedEffects` strictly to the protected paths touched by a write effect.
+     * @param {readonly string[]} globs - Protected file glob patterns.
+     * @returns {FsProtectGuardNode} Frozen `FsProtectGuardNode` descriptor.
+     */
+    protect(globs: readonly string[]): FsProtectGuardNode;
+    /**
+     * Compiles a passive `FsReadOnlyGuardNode` rejecting all unleased filesystem write mutations.
+     *
+     * Enforces read-only access across declared and post-flight-diffed tools.
+     * @returns {FsReadOnlyGuardNode} Frozen `FsReadOnlyGuardNode` descriptor.
+     */
+    readOnly(): FsReadOnlyGuardNode;
+    /**
+     * Compiles a passive `FsAllowOnlyGuardNode` restricting writes strictly to `globs`.
+     *
+     * Blocks any write path outside `globs` unless covered by an active lease.
+     * @param {readonly string[]} globs - Allowed write glob patterns.
+     * @returns {FsAllowOnlyGuardNode} Frozen `FsAllowOnlyGuardNode` descriptor.
+     */
+    allowOnly(globs: readonly string[]): FsAllowOnlyGuardNode;
+    /**
+     * Compiles a passive `FsRequireReadBeforeWriteGuardNode` requiring existing files to be read before mutation.
+     *
+     * Verifies that any target file existing at `baseRef` was previously read in `observedEffects`.
+     * @returns {FsRequireReadBeforeWriteGuardNode} Frozen `FsRequireReadBeforeWriteGuardNode` descriptor.
+     */
+    requireReadBeforeWrite(): FsRequireReadBeforeWriteGuardNode;
+    /**
+     * Compiles a passive `FsScopedWriteGuardNode` restricting writes to `ctx.activePartitions`.
+     *
+     * Rejects write mutations outside the member `globs` of the actor's active partitions.
+     * @template TPartition Literal union of partition identifiers in `partitionMap`.
+     * @param {FsPartitionMapNode<TPartition>} partitionMap - Filesystem partition map AST node.
+     * @returns {FsScopedWriteGuardNode} Frozen `FsScopedWriteGuardNode` descriptor.
+     */
+    scopedWrite<TPartition extends string = string>(partitionMap: FsPartitionMapNode<TPartition>): FsScopedWriteGuardNode;
+    /**
+     * Compiles a passive `FsSecretLiteralsGuardNode` scanning proposed file writes for secret literals.
+     *
+     * Evaluates built-in high-entropy credential patterns plus optional custom regex `patterns`.
+     * @param {readonly string[]} [patterns] - Optional custom secret regex pattern strings.
+     * @returns {FsSecretLiteralsGuardNode} Frozen `FsSecretLiteralsGuardNode` descriptor.
+     */
+    secretLiterals(patterns?: readonly string[]): FsSecretLiteralsGuardNode;
+    /**
+     * Creates a serializable `LeaseDelta` unlocking write access to `globs`.
+     *
+     * Matches both exact normalized file paths (including bracketed paths) and POSIX globs.
+     * @param {readonly string[]} globs - Exact file paths or glob patterns to unlock.
+     * @returns {LeaseDelta} Frozen `LeaseDelta` record.
+     */
+    allowWriteGlobs(globs: readonly string[]): LeaseDelta;
+    /**
+     * Compiles a passive `FsQuotaTripwireNode` tripping when distinct mutated files exceed `count`.
+     *
+     * Evaluated post-flight after each allowed tool call via `RuntimeExecutorRegistry.quotaTripwires`.
+     * @param {number} count - Maximum distinct mutated files allowed.
+     * @returns {FsQuotaTripwireNode} Frozen `FsQuotaTripwireNode` descriptor.
+     */
+    maxFilesMutated(count: number): FsQuotaTripwireNode;
+    /**
+     * Compiles the 5-tool workspace-jailed coding bundle (`read_file`, `edit_file`, `write_file`, `glob_files`, `grep_files`).
+     *
+     * Enforces `realpath` symlink jailing and `node_modules` write denial at runtime.
+     * @template THandle Runtime handle type of the active isolation scope.
+     * @param {MaybeBuilder<NodeRunnerNode>} runner - Runner pool AST node or builder.
+     * @returns {readonly [FsReadToolNode<THandle>, FsEditToolNode<THandle>, FsWriteToolNode<THandle>, FsGlobToolNode<THandle>, FsGrepToolNode<THandle>]} Frozen 5-tuple of coding tools.
+     */
+    codingTools<THandle = unknown>(runner: MaybeBuilder<NodeRunnerNode>): readonly [
+        FsReadToolNode<THandle>,
+        FsEditToolNode<THandle>,
+        FsWriteToolNode<THandle>,
+        FsGlobToolNode<THandle>,
+        FsGrepToolNode<THandle>
+    ];
+    /**
+     * Compiles the 3-tool workspace-jailed read-only bundle (`read_file`, `glob_files`, `grep_files`).
+     *
+     * Emits read-only `FsToolEffect` records with `mutatesScope: false`.
+     * @template THandle Runtime handle type of the active isolation scope.
+     * @param {MaybeBuilder<NodeRunnerNode>} runner - Runner pool AST node or builder.
+     * @returns {readonly [FsReadToolNode<THandle>, FsGlobToolNode<THandle>, FsGrepToolNode<THandle>]} Frozen 3-tuple of read-only tools.
+     */
+    readOnlyTools<THandle = unknown>(runner: MaybeBuilder<NodeRunnerNode>): readonly [FsReadToolNode<THandle>, FsGlobToolNode<THandle>, FsGrepToolNode<THandle>];
+    /**
+     * Compiles a passive `FsTelemetryCollectorNode` collecting `filesRead` and `filesMutated`.
+     *
+     * Folds observed `FsToolEffect` records into `UniversalStepTelemetry.custom`.
+     * @returns {FsTelemetryCollectorNode} Frozen `FsTelemetryCollectorNode` descriptor.
+     */
+    telemetry(): FsTelemetryCollectorNode;
+    /**
+     * Compiles a passive `FsRegexCheckNode` scanning mutated files matching `options.targetGlobs`.
+     *
+     * Evaluates `options.forbidPattern` strictly over files mutated during the session or since `baseRef`.
+     * @template THandle Runtime handle type of the active isolation scope.
+     * @param {string}              id      - Unique check identifier.
+     * @param {FsRegexCheckOptions} options - Regex check options.
+     * @returns {FsRegexCheckNode<THandle>} Frozen `FsRegexCheckNode` descriptor.
+     */
+    regexCheck<THandle = unknown>(id: string, options: FsRegexCheckOptions): FsRegexCheckNode<THandle>;
+    /**
+     * Compiles a passive `FsJsonlLessonStoreNode` configuring the crash-safe hybrid lesson store.
+     *
+     * Resolves `definitionsDir`, `statsPath`, and `lockFile` against the immutable host repository root.
+     * @param {FsJsonlLessonStoreOptions} options - Lesson store host-root path options.
+     * @returns {FsJsonlLessonStoreNode} Frozen `FsJsonlLessonStoreNode` descriptor.
+     */
+    jsonlLessonStore(options: FsJsonlLessonStoreOptions): FsJsonlLessonStoreNode;
+}
+//# sourceMappingURL=fs-namespace-contract.d.ts.map

package/dist/builders/fs-namespace-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-namespace-contract.d.ts","sourceRoot":"","sources":["../../src/builders/fs-namespace-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,iCAAiC,EACjC,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAC3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACzC;;;;;;OAMG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C;;;;;;;OAOG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,iBAAiB,CAAC;IACzF;;;;;;;;OAQG;IACH,YAAY,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,EAC7C,QAAQ,EAAE,YAAY,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,EAChD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC,GAC5D,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAClC;;;;;;;;OAQG;IACH,WAAW,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,EAC5C,YAAY,EAAE,kBAAkB,CAAC,UAAU,CAAC,EAC5C,WAAW,EAAE,UAAU,GACtB,cAAc,CAAC;IAClB;;;;;;;OAOG;IACH,aAAa,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,EAC9C,YAAY,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAC3C,mBAAmB,CAAC;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,CAAC;IAC3D;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CAAC;IACtD;;;;;OAKG;IACH,QAAQ,IAAI,mBAAmB,CAAC;IAChC;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,oBAAoB,CAAC;IAC1D;;;;;OAKG;IACH,sBAAsB,IAAI,iCAAiC,CAAC;IAC5D;;;;;;;OAOG;IACH,WAAW,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,EAC5C,YAAY,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAC3C,sBAAsB,CAAC;IAC1B;;;;;;OAMG;IACH,cAAc,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,yBAAyB,CAAC;IACxE;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAAC;IACtD;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACpD;;;;;;;OAOG;IACH,WAAW,CAAC,OAAO,GAAG,OAAO,EAC3B,MAAM,EAAE,YAAY,CAAC,cAAc,CAAC,GACnC,SAAS;QACV,cAAc,CAAC,OAAO,CAAC;QACvB,cAAc,CAAC,OAAO,CAAC;QACvB,eAAe,CAAC,OAAO,CAAC;QACxB,cAAc,CAAC,OAAO,CAAC;QACvB,cAAc,CAAC,OAAO,CAAC;KACxB,CAAC;IACF;;;;;;;OAOG;IACH,aAAa,CAAC,OAAO,GAAG,OAAO,EAC7B,MAAM,EAAE,YAAY,CAAC,cAAc,CAAC,GACnC,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACxF;;;;;OAKG;IACH,SAAS,IAAI,wBAAwB,CAAC;IACtC;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnG;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,yBAAyB,GAAG,sBAAsB,CAAC;CAC9E"}

package/dist/builders/fs-namespace-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fs-namespace-contract.js.map

package/dist/builders/fs-namespace-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-namespace-contract.js","sourceRoot":"","sources":["../../src/builders/fs-namespace-contract.ts"],"names":[],"mappings":""}

package/dist/builders/fs-namespace.d.ts

@@ -0,0 +1,10 @@
+import type { FsNamespace } from './fs-namespace-contract.js';
+/**
+ * Frozen `@paraharness/fs` builder namespace (`fs.*`).
+ *
+ * Provides pure AST builder factories for filesystem sources, partition maps, policy guards,
+ * capability lease deltas, quota tripwires, regex checks, telemetry collectors, lesson stores,
+ * and workspace-jailed coding/read-only tool bundles.
+ */
+export declare const fs: FsNamespace;
+//# sourceMappingURL=fs-namespace.d.ts.map

package/dist/builders/fs-namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-namespace.d.ts","sourceRoot":"","sources":["../../src/builders/fs-namespace.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,EAAE,EAAE,WAqBf,CAAC"}

package/dist/builders/fs-namespace.js

@@ -0,0 +1,50 @@
+import { createFsAllowOnlyGuardBuilder } from './create-fs-allow-only-guard-builder.js';
+import { createFsAllowWriteGlobsLeaseDelta } from './create-fs-allow-write-globs-lease-delta.js';
+import { createFsBoundaryGuardBuilder } from './create-fs-boundary-guard-builder.js';
+import { createFsCodingTools } from './create-fs-coding-tools.js';
+import { createFsGlobMatcherBuilder } from './create-fs-glob-matcher-builder.js';
+import { createFsGlobSourceBuilder } from './create-fs-glob-source-builder.js';
+import { createFsInPartitionPredicate } from './create-fs-in-partition-predicate.js';
+import { createFsJsonlLessonStoreBuilder } from './create-fs-jsonl-lesson-store-builder.js';
+import { createFsMaxFilesMutatedBuilder } from './create-fs-max-files-mutated-builder.js';
+import { createFsPartitionMap } from './create-fs-partition-map.js';
+import { createFsProtectGuardBuilder } from './create-fs-protect-guard-builder.js';
+import { createFsReadOnlyGuardBuilder } from './create-fs-read-only-guard-builder.js';
+import { createFsReadOnlyTools } from './create-fs-read-only-tools.js';
+import { createFsRegexCheckBuilder } from './create-fs-regex-check-builder.js';
+import { createFsRequireReadBeforeWriteGuardBuilder } from './create-fs-require-read-before-write-guard-builder.js';
+import { createFsScopedWriteGuardBuilder } from './create-fs-scoped-write-guard-builder.js';
+import { createFsSecretLiteralsGuardBuilder } from './create-fs-secret-literals-guard-builder.js';
+import { createFsTelemetryBuilder } from './create-fs-telemetry-builder.js';
+import { createFsTextSourceBuilder } from './create-fs-text-source-builder.js';
+import { createFsWriteGuardBuilder } from './create-fs-write-guard-builder.js';
+/**
+ * Frozen `@paraharness/fs` builder namespace (`fs.*`).
+ *
+ * Provides pure AST builder factories for filesystem sources, partition maps, policy guards,
+ * capability lease deltas, quota tripwires, regex checks, telemetry collectors, lesson stores,
+ * and workspace-jailed coding/read-only tool bundles.
+ */
+export const fs = Object.freeze({
+    text: createFsTextSourceBuilder,
+    glob: createFsGlobSourceBuilder,
+    matchGlobs: createFsGlobMatcherBuilder,
+    partitionMap: createFsPartitionMap,
+    inPartition: createFsInPartitionPredicate,
+    boundaryGuard: createFsBoundaryGuardBuilder,
+    writeGuard: createFsWriteGuardBuilder,
+    protect: createFsProtectGuardBuilder,
+    readOnly: createFsReadOnlyGuardBuilder,
+    allowOnly: createFsAllowOnlyGuardBuilder,
+    requireReadBeforeWrite: createFsRequireReadBeforeWriteGuardBuilder,
+    scopedWrite: createFsScopedWriteGuardBuilder,
+    secretLiterals: createFsSecretLiteralsGuardBuilder,
+    allowWriteGlobs: createFsAllowWriteGlobsLeaseDelta,
+    maxFilesMutated: createFsMaxFilesMutatedBuilder,
+    codingTools: createFsCodingTools,
+    readOnlyTools: createFsReadOnlyTools,
+    telemetry: createFsTelemetryBuilder,
+    regexCheck: createFsRegexCheckBuilder,
+    jsonlLessonStore: createFsJsonlLessonStoreBuilder,
+});
+//# sourceMappingURL=fs-namespace.js.map

package/dist/builders/fs-namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-namespace.js","sourceRoot":"","sources":["../../src/builders/fs-namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,EAAE,iCAAiC,EAAE,MAAM,8CAA8C,CAAC;AACjG,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,0CAA0C,EAAE,MAAM,wDAAwD,CAAC;AACpH,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,kCAAkC,EAAE,MAAM,8CAA8C,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAG/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,EAAE,GAAgB,MAAM,CAAC,MAAM,CAAc;IACxD,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,yBAAyB;IAC/B,UAAU,EAAE,0BAA0B;IACtC,YAAY,EAAE,oBAAoB;IAClC,WAAW,EAAE,4BAA4B;IACzC,aAAa,EAAE,4BAA4B;IAC3C,UAAU,EAAE,yBAAyB;IACrC,OAAO,EAAE,2BAA2B;IACpC,QAAQ,EAAE,4BAA4B;IACtC,SAAS,EAAE,6BAA6B;IACxC,sBAAsB,EAAE,0CAA0C;IAClE,WAAW,EAAE,+BAA+B;IAC5C,cAAc,EAAE,kCAAkC;IAClD,eAAe,EAAE,iCAAiC;IAClD,eAAe,EAAE,8BAA8B;IAC/C,WAAW,EAAE,mBAAmB;IAChC,aAAa,EAAE,qBAAqB;IACpC,SAAS,EAAE,wBAAwB;IACnC,UAAU,EAAE,yBAAyB;IACrC,gBAAgB,EAAE,+BAA+B;CAClD,CAAC,CAAC"}

package/dist/builders/internal/build-fs-tool-nodes.d.ts

@@ -0,0 +1,62 @@
+import type { FsEditToolNode, FsGlobToolNode, FsGrepToolNode, FsReadToolNode, FsWriteToolNode, NodeRunnerNode } from '@paraharness/core';
+/**
+ * Constructs a frozen `FsReadToolNode` (`fs:read` / `read_file`) bound to `runnerNode`.
+ *
+ * Uses the pre-compiled `FsReadToolInputSchema` with `effectTracking: 'declared'`.
+ *
+ * @template THandle Runtime handle type of the active isolation scope.
+ *
+ * @param {NodeRunnerNode} runnerNode - Passive runner pool AST node.
+ *
+ * @returns {FsReadToolNode<THandle>} Deeply frozen `FsReadToolNode` AST descriptor.
+ */
+export declare function buildFsReadToolNode<THandle = unknown>(runnerNode: NodeRunnerNode): FsReadToolNode<THandle>;
+/**
+ * Constructs a frozen `FsEditToolNode` (`fs:edit` / `edit_file`) bound to `runnerNode`.
+ *
+ * Uses the pre-compiled `FsEditToolInputSchema` with `effectTracking: 'declared'`.
+ *
+ * @template THandle Runtime handle type of the active isolation scope.
+ *
+ * @param {NodeRunnerNode} runnerNode - Passive runner pool AST node.
+ *
+ * @returns {FsEditToolNode<THandle>} Deeply frozen `FsEditToolNode` AST descriptor.
+ */
+export declare function buildFsEditToolNode<THandle = unknown>(runnerNode: NodeRunnerNode): FsEditToolNode<THandle>;
+/**
+ * Constructs a frozen `FsWriteToolNode` (`fs:write` / `write_file`) bound to `runnerNode`.
+ *
+ * Uses the pre-compiled `FsWriteToolInputSchema` with `effectTracking: 'declared'`.
+ *
+ * @template THandle Runtime handle type of the active isolation scope.
+ *
+ * @param {NodeRunnerNode} runnerNode - Passive runner pool AST node.
+ *
+ * @returns {FsWriteToolNode<THandle>} Deeply frozen `FsWriteToolNode` AST descriptor.
+ */
+export declare function buildFsWriteToolNode<THandle = unknown>(runnerNode: NodeRunnerNode): FsWriteToolNode<THandle>;
+/**
+ * Constructs a frozen `FsGlobToolNode` (`fs:glob` / `glob_files`) bound to `runnerNode`.
+ *
+ * Uses the pre-compiled `FsGlobToolInputSchema` with `effectTracking: 'declared'`.
+ *
+ * @template THandle Runtime handle type of the active isolation scope.
+ *
+ * @param {NodeRunnerNode} runnerNode - Passive runner pool AST node.
+ *
+ * @returns {FsGlobToolNode<THandle>} Deeply frozen `FsGlobToolNode` AST descriptor.
+ */
+export declare function buildFsGlobToolNode<THandle = unknown>(runnerNode: NodeRunnerNode): FsGlobToolNode<THandle>;
+/**
+ * Constructs a frozen `FsGrepToolNode` (`fs:grep` / `grep_files`) bound to `runnerNode`.
+ *
+ * Uses the pre-compiled `FsGrepToolInputSchema` with `effectTracking: 'declared'`.
+ *
+ * @template THandle Runtime handle type of the active isolation scope.
+ *
+ * @param {NodeRunnerNode} runnerNode - Passive runner pool AST node.
+ *
+ * @returns {FsGrepToolNode<THandle>} Deeply frozen `FsGrepToolNode` AST descriptor.
+ */
+export declare function buildFsGrepToolNode<THandle = unknown>(runnerNode: NodeRunnerNode): FsGrepToolNode<THandle>;
+//# sourceMappingURL=build-fs-tool-nodes.d.ts.map

package/dist/builders/internal/build-fs-tool-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-fs-tool-nodes.d.ts","sourceRoot":"","sources":["../../../src/builders/internal/build-fs-tool-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,EACf,MAAM,mBAAmB,CAAC;AAS3B;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAG,OAAO,EACnD,UAAU,EAAE,cAAc,GACzB,cAAc,CAAC,OAAO,CAAC,CASzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAG,OAAO,EACnD,UAAU,EAAE,cAAc,GACzB,cAAc,CAAC,OAAO,CAAC,CASzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAG,OAAO,EACpD,UAAU,EAAE,cAAc,GACzB,eAAe,CAAC,OAAO,CAAC,CAS1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAG,OAAO,EACnD,UAAU,EAAE,cAAc,GACzB,cAAc,CAAC,OAAO,CAAC,CASzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAG,OAAO,EACnD,UAAU,EAAE,cAAc,GACzB,cAAc,CAAC,OAAO,CAAC,CASzB"}

package/dist/builders/internal/build-fs-tool-nodes.js

@@ -0,0 +1,107 @@
+import { FsEditToolInputSchema, FsGlobToolInputSchema, FsGrepToolInputSchema, FsReadToolInputSchema, FsWriteToolInputSchema, } from './fs-tool-input.schema.js';
+/**
+ * Constructs a frozen `FsReadToolNode` (`fs:read` / `read_file`) bound to `runnerNode`.
+ *
+ * Uses the pre-compiled `FsReadToolInputSchema` with `effectTracking: 'declared'`.
+ *
+ * @template THandle Runtime handle type of the active isolation scope.
+ *
+ * @param {NodeRunnerNode} runnerNode - Passive runner pool AST node.
+ *
+ * @returns {FsReadToolNode<THandle>} Deeply frozen `FsReadToolNode` AST descriptor.
+ */
+export function buildFsReadToolNode(runnerNode) {
+    return Object.freeze({
+        type: 'fs:read',
+        name: 'read_file',
+        description: 'Read UTF-8 text from a workspace-relative file path.',
+        inputSchema: FsReadToolInputSchema,
+        effectTracking: 'declared',
+        runner: runnerNode,
+    });
+}
+/**
+ * Constructs a frozen `FsEditToolNode` (`fs:edit` / `edit_file`) bound to `runnerNode`.
+ *
+ * Uses the pre-compiled `FsEditToolInputSchema` with `effectTracking: 'declared'`.
+ *
+ * @template THandle Runtime handle type of the active isolation scope.
+ *
+ * @param {NodeRunnerNode} runnerNode - Passive runner pool AST node.
+ *
+ * @returns {FsEditToolNode<THandle>} Deeply frozen `FsEditToolNode` AST descriptor.
+ */
+export function buildFsEditToolNode(runnerNode) {
+    return Object.freeze({
+        type: 'fs:edit',
+        name: 'edit_file',
+        description: 'Replace an exact target string in an existing workspace-relative file.',
+        inputSchema: FsEditToolInputSchema,
+        effectTracking: 'declared',
+        runner: runnerNode,
+    });
+}
+/**
+ * Constructs a frozen `FsWriteToolNode` (`fs:write` / `write_file`) bound to `runnerNode`.
+ *
+ * Uses the pre-compiled `FsWriteToolInputSchema` with `effectTracking: 'declared'`.
+ *
+ * @template THandle Runtime handle type of the active isolation scope.
+ *
+ * @param {NodeRunnerNode} runnerNode - Passive runner pool AST node.
+ *
+ * @returns {FsWriteToolNode<THandle>} Deeply frozen `FsWriteToolNode` AST descriptor.
+ */
+export function buildFsWriteToolNode(runnerNode) {
+    return Object.freeze({
+        type: 'fs:write',
+        name: 'write_file',
+        description: 'Create or overwrite a workspace-relative UTF-8 file.',
+        inputSchema: FsWriteToolInputSchema,
+        effectTracking: 'declared',
+        runner: runnerNode,
+    });
+}
+/**
+ * Constructs a frozen `FsGlobToolNode` (`fs:glob` / `glob_files`) bound to `runnerNode`.
+ *
+ * Uses the pre-compiled `FsGlobToolInputSchema` with `effectTracking: 'declared'`.
+ *
+ * @template THandle Runtime handle type of the active isolation scope.
+ *
+ * @param {NodeRunnerNode} runnerNode - Passive runner pool AST node.
+ *
+ * @returns {FsGlobToolNode<THandle>} Deeply frozen `FsGlobToolNode` AST descriptor.
+ */
+export function buildFsGlobToolNode(runnerNode) {
+    return Object.freeze({
+        type: 'fs:glob',
+        name: 'glob_files',
+        description: 'List workspace-relative files matching a POSIX glob pattern.',
+        inputSchema: FsGlobToolInputSchema,
+        effectTracking: 'declared',
+        runner: runnerNode,
+    });
+}
+/**
+ * Constructs a frozen `FsGrepToolNode` (`fs:grep` / `grep_files`) bound to `runnerNode`.
+ *
+ * Uses the pre-compiled `FsGrepToolInputSchema` with `effectTracking: 'declared'`.
+ *
+ * @template THandle Runtime handle type of the active isolation scope.
+ *
+ * @param {NodeRunnerNode} runnerNode - Passive runner pool AST node.
+ *
+ * @returns {FsGrepToolNode<THandle>} Deeply frozen `FsGrepToolNode` AST descriptor.
+ */
+export function buildFsGrepToolNode(runnerNode) {
+    return Object.freeze({
+        type: 'fs:grep',
+        name: 'grep_files',
+        description: 'Search workspace files for lines matching a regular expression pattern.',
+        inputSchema: FsGrepToolInputSchema,
+        effectTracking: 'declared',
+        runner: runnerNode,
+    });
+}
+//# sourceMappingURL=build-fs-tool-nodes.js.map

package/dist/builders/internal/build-fs-tool-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-fs-tool-nodes.js","sourceRoot":"","sources":["../../../src/builders/internal/build-fs-tool-nodes.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAA0B;IAE1B,OAAO,MAAM,CAAC,MAAM,CAA0B;QAC5C,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,sDAAsD;QACnE,WAAW,EAAE,qBAAqB;QAClC,cAAc,EAAE,UAAU;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAA0B;IAE1B,OAAO,MAAM,CAAC,MAAM,CAA0B;QAC5C,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,wEAAwE;QACrF,WAAW,EAAE,qBAAqB;QAClC,cAAc,EAAE,UAAU;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA0B;IAE1B,OAAO,MAAM,CAAC,MAAM,CAA2B;QAC7C,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,sDAAsD;QACnE,WAAW,EAAE,sBAAsB;QACnC,cAAc,EAAE,UAAU;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAA0B;IAE1B,OAAO,MAAM,CAAC,MAAM,CAA0B;QAC5C,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE,qBAAqB;QAClC,cAAc,EAAE,UAAU;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAA0B;IAE1B,OAAO,MAAM,CAAC,MAAM,CAA0B;QAC5C,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,yEAAyE;QACtF,WAAW,EAAE,qBAAqB;QAClC,cAAc,EAAE,UAAU;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/internal/fs-tool-input.schema.d.ts

@@ -0,0 +1,80 @@
+import { z } from '@paraharness/core';
+/**
+ * Zod input schema for `FsReadToolNode` (`fs:read` / `read_file`).
+ *
+ * Validates that the caller provides a non-empty workspace-relative `path` string.
+ */
+export declare const FsReadToolInputSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Validated input payload for `read_file`.
+ */
+export type FsReadToolInput = z.infer<typeof FsReadToolInputSchema>;
+/**
+ * Zod input schema for `FsEditToolNode` (`fs:edit` / `edit_file`).
+ *
+ * Validates the target file `path`, exact `oldString` to locate, and replacement `newString`.
+ */
+export declare const FsEditToolInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    oldString: z.ZodString;
+    newString: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Validated input payload for `edit_file`.
+ */
+export type FsEditToolInput = z.infer<typeof FsEditToolInputSchema>;
+/**
+ * Zod input schema for `FsWriteToolNode` (`fs:write` / `write_file`).
+ *
+ * Validates the workspace-relative destination `path` and full UTF-8 `content`.
+ */
+export declare const FsWriteToolInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Validated input payload for `write_file`.
+ */
+export type FsWriteToolInput = z.infer<typeof FsWriteToolInputSchema>;
+/**
+ * Zod input schema for `FsGlobToolNode` (`fs:glob` / `glob_files`).
+ *
+ * Validates a non-empty POSIX glob `pattern`.
+ */
+export declare const FsGlobToolInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Validated input payload for `glob_files`.
+ */
+export type FsGlobToolInput = z.infer<typeof FsGlobToolInputSchema>;
+/**
+ * Zod input schema for `FsGrepToolNode` (`fs:grep` / `grep_files`).
+ *
+ * Validates regular expression `pattern` and optional `glob` and regex `flags`.
+ */
+export declare const FsGrepToolInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    glob: z.ZodOptional<z.ZodString>;
+    flags: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Validated input payload for `grep_files`.
+ */
+export type FsGrepToolInput = z.infer<typeof FsGrepToolInputSchema>;
+/**
+ * Zod telemetry schema for `FsTelemetryCollectorNode` (`fs:telemetry`).
+ *
+ * Validates distinct `filesRead` and `filesMutated` path arrays collected per step.
+ */
+export declare const FsTelemetryMetricsSchema: z.ZodObject<{
+    filesRead: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    filesMutated: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Validated telemetry metrics shape for `fs.telemetry()`.
+ */
+export type FsTelemetryMetrics = z.infer<typeof FsTelemetryMetricsSchema>;
+//# sourceMappingURL=fs-tool-input.schema.d.ts.map

package/dist/builders/internal/fs-tool-input.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-tool-input.schema.d.ts","sourceRoot":"","sources":["../../../src/builders/internal/fs-tool-input.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/builders/internal/fs-tool-input.schema.js

@@ -0,0 +1,56 @@
+import { z } from '@paraharness/core';
+/**
+ * Zod input schema for `FsReadToolNode` (`fs:read` / `read_file`).
+ *
+ * Validates that the caller provides a non-empty workspace-relative `path` string.
+ */
+export const FsReadToolInputSchema = z.object({
+    path: z.string().min(1),
+});
+/**
+ * Zod input schema for `FsEditToolNode` (`fs:edit` / `edit_file`).
+ *
+ * Validates the target file `path`, exact `oldString` to locate, and replacement `newString`.
+ */
+export const FsEditToolInputSchema = z.object({
+    path: z.string().min(1),
+    oldString: z.string(),
+    newString: z.string(),
+});
+/**
+ * Zod input schema for `FsWriteToolNode` (`fs:write` / `write_file`).
+ *
+ * Validates the workspace-relative destination `path` and full UTF-8 `content`.
+ */
+export const FsWriteToolInputSchema = z.object({
+    path: z.string().min(1),
+    content: z.string(),
+});
+/**
+ * Zod input schema for `FsGlobToolNode` (`fs:glob` / `glob_files`).
+ *
+ * Validates a non-empty POSIX glob `pattern`.
+ */
+export const FsGlobToolInputSchema = z.object({
+    pattern: z.string().min(1),
+});
+/**
+ * Zod input schema for `FsGrepToolNode` (`fs:grep` / `grep_files`).
+ *
+ * Validates regular expression `pattern` and optional `glob` and regex `flags`.
+ */
+export const FsGrepToolInputSchema = z.object({
+    pattern: z.string().min(1),
+    glob: z.string().optional(),
+    flags: z.string().optional(),
+});
+/**
+ * Zod telemetry schema for `FsTelemetryCollectorNode` (`fs:telemetry`).
+ *
+ * Validates distinct `filesRead` and `filesMutated` path arrays collected per step.
+ */
+export const FsTelemetryMetricsSchema = z.object({
+    filesRead: z.array(z.string()).readonly(),
+    filesMutated: z.array(z.string()).readonly(),
+});
+//# sourceMappingURL=fs-tool-input.schema.js.map

package/dist/builders/internal/fs-tool-input.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-tool-input.schema.js","sourceRoot":"","sources":["../../../src/builders/internal/fs-tool-input.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC;AAOH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAOH;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAOH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3B,CAAC,CAAC;AAOH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAOH;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC"}

package/dist/executors/create-fs-executors.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeExecutorRegistrySlice } from '@paraharness/core';
+/**
+ * Creates a fresh `RuntimeExecutorRegistrySlice` registering all `@paraharness/fs` runtime executors and drivers.
+ *
+ * Registers `sources`, `checks`, `policyGuards`, `quotaTripwires`, `telemetryCollectors`,
+ * `effectMatchers`, `tools`, and `lessons` for `@paraharness/fs` AST nodes (`SPEC.md` §4.3).
+ *
+ * @returns {RuntimeExecutorRegistrySlice} Deeply frozen executor registry slice for `@paraharness/fs`.
+ */
+export declare function createFsExecutors(): RuntimeExecutorRegistrySlice;
+//# sourceMappingURL=create-fs-executors.d.ts.map

package/dist/executors/create-fs-executors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-fs-executors.d.ts","sourceRoot":"","sources":["../../src/executors/create-fs-executors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,4BAA4B,EAC7B,MAAM,mBAAmB,CAAC;AAkC3B;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,4BAA4B,CAwChE"}