@paraharness/fs 0.1.0 → 0.2.1

package/README.md

@@ -34,6 +34,14 @@ import { local, nodeExecutors } from '@paraharness/node';
 const runner = local.runner({ slots: 4 });
 const sonnet = claude.model('sonnet', { id: 'claude-sonnet-4-6' });
 
+const leaseRequest = P.interrupt(
+  'lease-request',
+  z.object({
+    requestedPaths: z.array(z.string()),
+    justification: z.string(),
+  }),
+);
+
 const workerPolicy = P.policy('worker-policy')
   .guard(
     fs.protect(['packages/*/src/index.ts', 'PRODUCT_SPEC.md']),
@@ -41,6 +49,16 @@ const workerPolicy = P.policy('worker-policy')
     fs.secretLiterals(),
   )
   .onViolation('deny-with-error')
+  .guard(
+    fs.writeGuard({
+      denyGlobs: ['**/*.test.ts', '**/*.test.tsx'],
+      onlyExistingAtBaseRef: true,
+    }),
+  )
+  .onViolation('raise-interrupt', leaseRequest, (violation) => ({
+    requestedPaths: fs.violatedPaths(violation),
+    justification: violation.violationSummary,
+  }))
   .tripwire(fs.maxFilesMutated(6));
 
 const worker = P.agent('worker')

package/dist/builders/create-fs-coding-tools.d.ts

@@ -1,17 +1,18 @@
 import { type FsEditToolNode, type FsGlobToolNode, type FsGrepToolNode, type FsReadToolNode, type FsWriteToolNode, type MaybeBuilder, type NodeRunnerNode } from '@paraharness/core';
 /**
- * Compiles the 5-tool workspace-jailed coding bundle (`fs.codingTools(runner)`).
+ * Compiles the 5-tool workspace-jailed coding bundle (`fs.codingTools(runner?)`).
  *
  * Returns passive `ToolASTNode` descriptors (`read_file`, `edit_file`, `write_file`,
- * `glob_files`, `grep_files`) with `effectTracking: 'declared'`.
+ * `glob_files`, `grep_files`) with `effectTracking: 'declared'`, defaulting `runner` to
+ * `DEFAULT_NODE_RUNNER_AST_NODE` when omitted.
  *
  * @template THandle Runtime handle type of the active isolation scope.
  *
- * @param {MaybeBuilder<NodeRunnerNode>} runner - Runner pool AST node or builder.
+ * @param {MaybeBuilder<NodeRunnerNode>} [runner=DEFAULT_NODE_RUNNER_AST_NODE] - Optional runner pool AST node or builder.
  *
  * @returns {readonly [FsReadToolNode<THandle>, FsEditToolNode<THandle>, FsWriteToolNode<THandle>, FsGlobToolNode<THandle>, FsGrepToolNode<THandle>]} Frozen 5-tuple of filesystem coding tool AST nodes.
  */
-export declare function createFsCodingTools<THandle = unknown>(runner: MaybeBuilder<NodeRunnerNode>): readonly [
+export declare function createFsCodingTools<THandle = unknown>(runner?: MaybeBuilder<NodeRunnerNode>): readonly [
     FsReadToolNode<THandle>,
     FsEditToolNode<THandle>,
     FsWriteToolNode<THandle>,

package/dist/builders/create-fs-coding-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-fs-coding-tools.d.ts","sourceRoot":"","sources":["../../src/builders/create-fs-coding-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAS3B;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAG,OAAO,EACnD,MAAM,EAAE,YAAY,CAAC,cAAc,CAAC,GACnC,SAAS;IACV,cAAc,CAAC,OAAO,CAAC;IACvB,cAAc,CAAC,OAAO,CAAC;IACvB,eAAe,CAAC,OAAO,CAAC;IACxB,cAAc,CAAC,OAAO,CAAC;IACvB,cAAc,CAAC,OAAO,CAAC;CACxB,CASA"}
+{"version":3,"file":"create-fs-coding-tools.d.ts","sourceRoot":"","sources":["../../src/builders/create-fs-coding-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAS3B;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAG,OAAO,EACnD,MAAM,GAAE,YAAY,CAAC,cAAc,CAAgC,GAClE,SAAS;IACV,cAAc,CAAC,OAAO,CAAC;IACvB,cAAc,CAAC,OAAO,CAAC;IACvB,eAAe,CAAC,OAAO,CAAC;IACxB,cAAc,CAAC,OAAO,CAAC;IACvB,cAAc,CAAC,OAAO,CAAC;CACxB,CASA"}

package/dist/builders/create-fs-coding-tools.js

@@ -1,18 +1,19 @@
-import { extractAST, } from '@paraharness/core';
+import { DEFAULT_NODE_RUNNER_AST_NODE, extractAST, } from '@paraharness/core';
 import { buildFsEditToolNode, buildFsGlobToolNode, buildFsGrepToolNode, buildFsReadToolNode, buildFsWriteToolNode, } from './internal/build-fs-tool-nodes.js';
 /**
- * Compiles the 5-tool workspace-jailed coding bundle (`fs.codingTools(runner)`).
+ * Compiles the 5-tool workspace-jailed coding bundle (`fs.codingTools(runner?)`).
  *
  * Returns passive `ToolASTNode` descriptors (`read_file`, `edit_file`, `write_file`,
- * `glob_files`, `grep_files`) with `effectTracking: 'declared'`.
+ * `glob_files`, `grep_files`) with `effectTracking: 'declared'`, defaulting `runner` to
+ * `DEFAULT_NODE_RUNNER_AST_NODE` when omitted.
  *
  * @template THandle Runtime handle type of the active isolation scope.
  *
- * @param {MaybeBuilder<NodeRunnerNode>} runner - Runner pool AST node or builder.
+ * @param {MaybeBuilder<NodeRunnerNode>} [runner=DEFAULT_NODE_RUNNER_AST_NODE] - Optional runner pool AST node or builder.
  *
  * @returns {readonly [FsReadToolNode<THandle>, FsEditToolNode<THandle>, FsWriteToolNode<THandle>, FsGlobToolNode<THandle>, FsGrepToolNode<THandle>]} Frozen 5-tuple of filesystem coding tool AST nodes.
  */
-export function createFsCodingTools(runner) {
+export function createFsCodingTools(runner = DEFAULT_NODE_RUNNER_AST_NODE) {
     const runnerNode = extractAST(runner);
     return Object.freeze([
         buildFsReadToolNode(runnerNode),

package/dist/builders/create-fs-coding-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-fs-coding-tools.js","sourceRoot":"","sources":["../../src/builders/create-fs-coding-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAQX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAoC;IAQpC,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,mBAAmB,CAAU,UAAU,CAAC;QACxC,mBAAmB,CAAU,UAAU,CAAC;QACxC,oBAAoB,CAAU,UAAU,CAAC;QACzC,mBAAmB,CAAU,UAAU,CAAC;QACxC,mBAAmB,CAAU,UAAU,CAAC;KACzC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"create-fs-coding-tools.js","sourceRoot":"","sources":["../../src/builders/create-fs-coding-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,UAAU,GAQX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAuC,4BAA4B;IAQnE,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,mBAAmB,CAAU,UAAU,CAAC;QACxC,mBAAmB,CAAU,UAAU,CAAC;QACxC,oBAAoB,CAAU,UAAU,CAAC;QACzC,mBAAmB,CAAU,UAAU,CAAC;QACxC,mBAAmB,CAAU,UAAU,CAAC;KACzC,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-fs-jsonl-lesson-store-builder.d.ts

@@ -1,29 +1,29 @@
 import type { FsJsonlLessonStoreNode } from '@paraharness/core';
 /**
- * Configuration options for `fs.jsonlLessonStore(options)`.
+ * Configuration options for `fs.jsonlLessonStore(options?)`.
  *
  * Configures the host-root directory for immutable content-addressed lesson JSON files,
  * the mutable telemetry counter file path, and the advisory lockfile path.
  */
 export interface FsJsonlLessonStoreOptions {
-    /** Host-root directory storing immutable `<lessonId>.json` definition files. */
-    readonly definitionsDir: string;
-    /** Host-root file path storing mutable lesson telemetry and outcome counters. */
-    readonly statsPath: string;
-    /** Host-root advisory lockfile path used for cross-process synchronization. */
-    readonly lockFile: string;
+    /** Host-root directory storing immutable `<lessonId>.json` definition files (defaults to `'.paraharness/lessons'`). */
+    readonly definitionsDir?: string;
+    /** Host-root file path storing mutable lesson telemetry and outcome counters (defaults to `` `${definitionsDir}-stats.json` ``). */
+    readonly statsPath?: string;
+    /** Host-root advisory lockfile path used for cross-process synchronization (defaults to `` `${definitionsDir}.lock` ``). */
+    readonly lockFile?: string;
 }
 /**
- * Compiles a passive `FsJsonlLessonStoreNode` (`fs:jsonl-lesson-store`) for `fs.jsonlLessonStore(options)`.
+ * Compiles a passive `FsJsonlLessonStoreNode` (`fs:jsonl-lesson-store`) for `fs.jsonlLessonStore(options?)`.
  *
  * Configures a host-root-resolved content-addressed lesson store splitting immutable
  * `<definitionsDir>/<lessonId>.json` definitions from mutable `statsPath` counters.
  *
- * @param {FsJsonlLessonStoreOptions} options - Host-root paths for definitions, stats, and lockfile.
+ * @param {FsJsonlLessonStoreOptions} [options] - Optional host-root paths for definitions, stats, and lockfile.
  *
  * @returns {FsJsonlLessonStoreNode} Deeply frozen `FsJsonlLessonStoreNode` AST descriptor.
  *
  * @throws {Error} If any of `definitionsDir`, `statsPath`, or `lockFile` is empty.
  */
-export declare function createFsJsonlLessonStoreBuilder(options: FsJsonlLessonStoreOptions): FsJsonlLessonStoreNode;
+export declare function createFsJsonlLessonStoreBuilder(options?: FsJsonlLessonStoreOptions): FsJsonlLessonStoreNode;
 //# sourceMappingURL=create-fs-jsonl-lesson-store-builder.d.ts.map

package/dist/builders/create-fs-jsonl-lesson-store-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-fs-jsonl-lesson-store-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-fs-jsonl-lesson-store-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,gFAAgF;IAChF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,yBAAyB,GACjC,sBAAsB,CAgBxB"}
+{"version":3,"file":"create-fs-jsonl-lesson-store-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-fs-jsonl-lesson-store-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,uHAAuH;IACvH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,oIAAoI;IACpI,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,4HAA4H;IAC5H,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,CAAC,EAAE,yBAAyB,GAClC,sBAAsB,CA6BxB"}

package/dist/builders/create-fs-jsonl-lesson-store-builder.js

@@ -1,30 +1,37 @@
 /**
- * Compiles a passive `FsJsonlLessonStoreNode` (`fs:jsonl-lesson-store`) for `fs.jsonlLessonStore(options)`.
+ * Compiles a passive `FsJsonlLessonStoreNode` (`fs:jsonl-lesson-store`) for `fs.jsonlLessonStore(options?)`.
  *
  * Configures a host-root-resolved content-addressed lesson store splitting immutable
  * `<definitionsDir>/<lessonId>.json` definitions from mutable `statsPath` counters.
  *
- * @param {FsJsonlLessonStoreOptions} options - Host-root paths for definitions, stats, and lockfile.
+ * @param {FsJsonlLessonStoreOptions} [options] - Optional host-root paths for definitions, stats, and lockfile.
  *
  * @returns {FsJsonlLessonStoreNode} Deeply frozen `FsJsonlLessonStoreNode` AST descriptor.
  *
  * @throws {Error} If any of `definitionsDir`, `statsPath`, or `lockFile` is empty.
  */
 export function createFsJsonlLessonStoreBuilder(options) {
-    if (typeof options.definitionsDir !== 'string' || options.definitionsDir.trim().length === 0) {
+    if (options?.definitionsDir !== undefined &&
+        (typeof options.definitionsDir !== 'string' || options.definitionsDir.trim().length === 0)) {
         throw new Error('fs.jsonlLessonStore requires a non-empty definitionsDir path.');
     }
-    if (typeof options.statsPath !== 'string' || options.statsPath.trim().length === 0) {
+    if (options?.statsPath !== undefined &&
+        (typeof options.statsPath !== 'string' || options.statsPath.trim().length === 0)) {
         throw new Error('fs.jsonlLessonStore requires a non-empty statsPath.');
     }
-    if (typeof options.lockFile !== 'string' || options.lockFile.trim().length === 0) {
+    if (options?.lockFile !== undefined &&
+        (typeof options.lockFile !== 'string' || options.lockFile.trim().length === 0)) {
         throw new Error('fs.jsonlLessonStore requires a non-empty lockFile path.');
     }
+    const definitionsDir = (options?.definitionsDir ?? '.paraharness/lessons').trim();
+    const normalizedBase = definitionsDir.replace(/[/\\]+$/, '') || '.paraharness/lessons';
+    const statsPath = (options?.statsPath ?? `${normalizedBase}-stats.json`).trim();
+    const lockFile = (options?.lockFile ?? `${normalizedBase}.lock`).trim();
     return Object.freeze({
         type: 'fs:jsonl-lesson-store',
-        definitionsDir: options.definitionsDir.trim(),
-        statsPath: options.statsPath.trim(),
-        lockFile: options.lockFile.trim(),
+        definitionsDir,
+        statsPath,
+        lockFile,
     });
 }
 //# sourceMappingURL=create-fs-jsonl-lesson-store-builder.js.map

package/dist/builders/create-fs-jsonl-lesson-store-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-fs-jsonl-lesson-store-builder.js","sourceRoot":"","sources":["../../src/builders/create-fs-jsonl-lesson-store-builder.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAkC;IAElC,IAAI,OAAO,OAAO,CAAC,cAAc,KAAK,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7F,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAyB;QAC3C,IAAI,EAAE,uBAAuB;QAC7B,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE;QAC7C,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE;QACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE;KAClC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"create-fs-jsonl-lesson-store-builder.js","sourceRoot":"","sources":["../../src/builders/create-fs-jsonl-lesson-store-builder.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAmC;IAEnC,IACE,OAAO,EAAE,cAAc,KAAK,SAAS;QACrC,CAAC,OAAO,OAAO,CAAC,cAAc,KAAK,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAC1F,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,IACE,OAAO,EAAE,SAAS,KAAK,SAAS;QAChC,CAAC,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAChF,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IACE,OAAO,EAAE,QAAQ,KAAK,SAAS;QAC/B,CAAC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAC9E,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,cAAc,IAAI,sBAAsB,CAAC,CAAC,IAAI,EAAE,CAAC;IAClF,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,sBAAsB,CAAC;IACvF,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,SAAS,IAAI,GAAG,cAAc,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC;IAChF,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,QAAQ,IAAI,GAAG,cAAc,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACxE,OAAO,MAAM,CAAC,MAAM,CAAyB;QAC3C,IAAI,EAAE,uBAAuB;QAC7B,cAAc;QACd,SAAS;QACT,QAAQ;KACT,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-fs-read-only-tools.d.ts

@@ -1,15 +1,16 @@
 import { type FsGlobToolNode, type FsGrepToolNode, type FsReadToolNode, type MaybeBuilder, type NodeRunnerNode } from '@paraharness/core';
 /**
- * Compiles the 3-tool workspace-jailed read-only bundle (`fs.readOnlyTools(runner)`).
+ * Compiles the 3-tool workspace-jailed read-only bundle (`fs.readOnlyTools(runner?)`).
  *
  * Returns passive `ToolASTNode` descriptors (`read_file`, `glob_files`, `grep_files`)
- * with `effectTracking: 'declared'` for evaluators, adjudicators, and arbiters.
+ * with `effectTracking: 'declared'` for evaluators, adjudicators, and arbiters, defaulting
+ * `runner` to `DEFAULT_NODE_RUNNER_AST_NODE` when omitted.
  *
  * @template THandle Runtime handle type of the active isolation scope.
  *
- * @param {MaybeBuilder<NodeRunnerNode>} runner - Runner pool AST node or builder.
+ * @param {MaybeBuilder<NodeRunnerNode>} [runner=DEFAULT_NODE_RUNNER_AST_NODE] - Optional runner pool AST node or builder.
  *
  * @returns {readonly [FsReadToolNode<THandle>, FsGlobToolNode<THandle>, FsGrepToolNode<THandle>]} Frozen 3-tuple of read-only filesystem tool AST nodes.
  */
-export declare function createFsReadOnlyTools<THandle = unknown>(runner: MaybeBuilder<NodeRunnerNode>): readonly [FsReadToolNode<THandle>, FsGlobToolNode<THandle>, FsGrepToolNode<THandle>];
+export declare function createFsReadOnlyTools<THandle = unknown>(runner?: MaybeBuilder<NodeRunnerNode>): readonly [FsReadToolNode<THandle>, FsGlobToolNode<THandle>, FsGrepToolNode<THandle>];
 //# sourceMappingURL=create-fs-read-only-tools.d.ts.map

package/dist/builders/create-fs-read-only-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-fs-read-only-tools.d.ts","sourceRoot":"","sources":["../../src/builders/create-fs-read-only-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAO3B;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAG,OAAO,EACrD,MAAM,EAAE,YAAY,CAAC,cAAc,CAAC,GACnC,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAOtF"}
+{"version":3,"file":"create-fs-read-only-tools.d.ts","sourceRoot":"","sources":["../../src/builders/create-fs-read-only-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAO3B;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAG,OAAO,EACrD,MAAM,GAAE,YAAY,CAAC,cAAc,CAAgC,GAClE,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAOtF"}

package/dist/builders/create-fs-read-only-tools.js

@@ -1,18 +1,19 @@
-import { extractAST, } from '@paraharness/core';
+import { DEFAULT_NODE_RUNNER_AST_NODE, extractAST, } from '@paraharness/core';
 import { buildFsGlobToolNode, buildFsGrepToolNode, buildFsReadToolNode, } from './internal/build-fs-tool-nodes.js';
 /**
- * Compiles the 3-tool workspace-jailed read-only bundle (`fs.readOnlyTools(runner)`).
+ * Compiles the 3-tool workspace-jailed read-only bundle (`fs.readOnlyTools(runner?)`).
  *
  * Returns passive `ToolASTNode` descriptors (`read_file`, `glob_files`, `grep_files`)
- * with `effectTracking: 'declared'` for evaluators, adjudicators, and arbiters.
+ * with `effectTracking: 'declared'` for evaluators, adjudicators, and arbiters, defaulting
+ * `runner` to `DEFAULT_NODE_RUNNER_AST_NODE` when omitted.
  *
  * @template THandle Runtime handle type of the active isolation scope.
  *
- * @param {MaybeBuilder<NodeRunnerNode>} runner - Runner pool AST node or builder.
+ * @param {MaybeBuilder<NodeRunnerNode>} [runner=DEFAULT_NODE_RUNNER_AST_NODE] - Optional runner pool AST node or builder.
  *
  * @returns {readonly [FsReadToolNode<THandle>, FsGlobToolNode<THandle>, FsGrepToolNode<THandle>]} Frozen 3-tuple of read-only filesystem tool AST nodes.
  */
-export function createFsReadOnlyTools(runner) {
+export function createFsReadOnlyTools(runner = DEFAULT_NODE_RUNNER_AST_NODE) {
     const runnerNode = extractAST(runner);
     return Object.freeze([
         buildFsReadToolNode(runnerNode),

package/dist/builders/create-fs-read-only-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-fs-read-only-tools.js","sourceRoot":"","sources":["../../src/builders/create-fs-read-only-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAMX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAoC;IAEpC,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,mBAAmB,CAAU,UAAU,CAAC;QACxC,mBAAmB,CAAU,UAAU,CAAC;QACxC,mBAAmB,CAAU,UAAU,CAAC;KACzC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"create-fs-read-only-tools.js","sourceRoot":"","sources":["../../src/builders/create-fs-read-only-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,UAAU,GAMX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAuC,4BAA4B;IAEnE,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,mBAAmB,CAAU,UAAU,CAAC;QACxC,mBAAmB,CAAU,UAAU,CAAC;QACxC,mBAAmB,CAAU,UAAU,CAAC;KACzC,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/extract-fs-violated-paths.d.ts

@@ -0,0 +1,14 @@
+import type { PolicyViolation } from '@paraharness/core';
+/**
+ * Extracts deduplicated filesystem paths in first-seen order from a `PolicyViolation` (`fs.violatedPaths(violation)`).
+ *
+ * Iterates `violation.violatedEffects` in a single pass, inspecting only `'fs:effect'` records whose
+ * `attributes.paths` property is an array, and collects unique string path entries without allocating
+ * intermediate arrays.
+ *
+ * @param {PolicyViolation} violation - Policy violation emitted by a pre-flight or post-flight policy guard.
+ *
+ * @returns {string[]} Deduplicated array of violated filesystem paths in first-seen order.
+ */
+export declare function extractFsViolatedPaths(violation: PolicyViolation): string[];
+//# sourceMappingURL=extract-fs-violated-paths.d.ts.map

package/dist/builders/extract-fs-violated-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-fs-violated-paths.d.ts","sourceRoot":"","sources":["../../src/builders/extract-fs-violated-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,EAAE,CAe3E"}

package/dist/builders/extract-fs-violated-paths.js

@@ -0,0 +1,30 @@
+/**
+ * Extracts deduplicated filesystem paths in first-seen order from a `PolicyViolation` (`fs.violatedPaths(violation)`).
+ *
+ * Iterates `violation.violatedEffects` in a single pass, inspecting only `'fs:effect'` records whose
+ * `attributes.paths` property is an array, and collects unique string path entries without allocating
+ * intermediate arrays.
+ *
+ * @param {PolicyViolation} violation - Policy violation emitted by a pre-flight or post-flight policy guard.
+ *
+ * @returns {string[]} Deduplicated array of violated filesystem paths in first-seen order.
+ */
+export function extractFsViolatedPaths(violation) {
+    const seenPaths = new Set();
+    const paths = [];
+    for (const effect of violation.violatedEffects) {
+        if (effect.kind !== 'fs:effect')
+            continue;
+        const rawPaths = effect.attributes?.['paths'];
+        if (!Array.isArray(rawPaths))
+            continue;
+        for (const candidatePath of rawPaths) {
+            if (typeof candidatePath === 'string' && !seenPaths.has(candidatePath)) {
+                seenPaths.add(candidatePath);
+                paths.push(candidatePath);
+            }
+        }
+    }
+    return paths;
+}
+//# sourceMappingURL=extract-fs-violated-paths.js.map

package/dist/builders/extract-fs-violated-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-fs-violated-paths.js","sourceRoot":"","sources":["../../src/builders/extract-fs-violated-paths.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAA0B;IAC/D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,eAAe,EAAE,CAAC;QAC/C,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,SAAS;QACvC,KAAK,MAAM,aAAa,IAAI,QAAQ,EAAE,CAAC;YACrC,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBACvE,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -1,4 +1,4 @@
-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 { 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, PolicyViolation, 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';
@@ -126,6 +126,14 @@ export interface FsNamespace {
      * @returns {LeaseDelta} Frozen `LeaseDelta` record.
      */
     allowWriteGlobs(globs: readonly string[]): LeaseDelta;
+    /**
+     * Extracts deduplicated filesystem paths in first-seen order from `violation.violatedEffects`.
+     *
+     * Inspects `'fs:effect'` records in `violation.violatedEffects` and returns unique string path entries.
+     * @param {PolicyViolation} violation - Policy violation emitted by a pre-flight or post-flight guard.
+     * @returns {string[]} Deduplicated array of violated filesystem paths in first-seen order.
+     */
+    violatedPaths(violation: PolicyViolation): string[];
     /**
      * Compiles a passive `FsQuotaTripwireNode` tripping when distinct mutated files exceed `count`.
      *
@@ -139,10 +147,10 @@ export interface FsNamespace {
      *
      * 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.
+     * @param {MaybeBuilder<NodeRunnerNode>} [runner] - Optional runner pool AST node or builder (defaults to `DEFAULT_NODE_RUNNER_AST_NODE`).
      * @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 [
+    codingTools<THandle = unknown>(runner?: MaybeBuilder<NodeRunnerNode>): readonly [
         FsReadToolNode<THandle>,
         FsEditToolNode<THandle>,
         FsWriteToolNode<THandle>,
@@ -154,10 +162,10 @@ export interface FsNamespace {
      *
      * 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.
+     * @param {MaybeBuilder<NodeRunnerNode>} [runner] - Optional runner pool AST node or builder (defaults to `DEFAULT_NODE_RUNNER_AST_NODE`).
      * @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>];
+    readOnlyTools<THandle = unknown>(runner?: MaybeBuilder<NodeRunnerNode>): readonly [FsReadToolNode<THandle>, FsGlobToolNode<THandle>, FsGrepToolNode<THandle>];
     /**
      * Compiles a passive `FsTelemetryCollectorNode` collecting `filesRead` and `filesMutated`.
      *
@@ -179,9 +187,9 @@ export interface FsNamespace {
      * 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.
+     * @param {FsJsonlLessonStoreOptions} [options] - Optional lesson store host-root path options.
      * @returns {FsJsonlLessonStoreNode} Frozen `FsJsonlLessonStoreNode` descriptor.
      */
-    jsonlLessonStore(options: FsJsonlLessonStoreOptions): FsJsonlLessonStoreNode;
+    jsonlLessonStore(options?: FsJsonlLessonStoreOptions): FsJsonlLessonStoreNode;
 }
 //# sourceMappingURL=fs-namespace-contract.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fs-namespace-contract.d.ts","sourceRoot":"","sources":["../../src/builders/fs-namespace-contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs-namespace-contract.d.ts","sourceRoot":"","sources":["../../src/builders/fs-namespace-contract.ts"],"names":[],"mappings":"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"}

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

@@ -1 +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"}
+{"version":3,"file":"fs-namespace.d.ts","sourceRoot":"","sources":["../../src/builders/fs-namespace.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,EAAE,EAAE,WAsBf,CAAC"}

package/dist/builders/fs-namespace.js

@@ -18,6 +18,7 @@ import { createFsSecretLiteralsGuardBuilder } from './create-fs-secret-literals-
 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';
+import { extractFsViolatedPaths } from './extract-fs-violated-paths.js';
 /**
  * Frozen `@paraharness/fs` builder namespace (`fs.*`).
  *
@@ -40,6 +41,7 @@ export const fs = Object.freeze({
     scopedWrite: createFsScopedWriteGuardBuilder,
     secretLiterals: createFsSecretLiteralsGuardBuilder,
     allowWriteGlobs: createFsAllowWriteGlobsLeaseDelta,
+    violatedPaths: extractFsViolatedPaths,
     maxFilesMutated: createFsMaxFilesMutatedBuilder,
     codingTools: createFsCodingTools,
     readOnlyTools: createFsReadOnlyTools,

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

@@ -1 +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"}
+{"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;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE;;;;;;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,aAAa,EAAE,sBAAsB;IACrC,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/executors/internal/execute-fs-edit-operation.d.ts

@@ -14,13 +14,12 @@ export interface ExecuteFsEditOperationParams {
  * Executes a jailed `edit_file` string replacement inside `scopeHandle`.
  *
  * Verifies that `params.oldString` exists in the target file before writing the updated UTF-8 text.
+ * Returns an `isError: true` result when reading the file fails or `params.oldString` is absent.
  *
  * @param {unknown}                      scopeHandle - Active isolation scope handle.
  * @param {ExecuteFsEditOperationParams} params      - Validated edit arguments (`path`, `oldString`, `newString`).
  *
  * @returns {Promise<ToolExecutionResult>} Frozen tool execution result.
- *
- * @throws {Error} If `params.oldString` is not found in the target file.
  */
 export declare function executeFsEditOperation(scopeHandle: unknown, params: ExecuteFsEditOperationParams): Promise<ToolExecutionResult>;
 //# sourceMappingURL=execute-fs-edit-operation.d.ts.map

package/dist/executors/internal/execute-fs-edit-operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute-fs-edit-operation.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/execute-fs-edit-operation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,mBAAmB,CAAC,CAe9B"}
+{"version":3,"file":"execute-fs-edit-operation.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/execute-fs-edit-operation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,mBAAmB,CAAC,CA2B9B"}

package/dist/executors/internal/execute-fs-edit-operation.js

@@ -4,22 +4,36 @@ import { resolveJailedWorktreePath } from './resolve-jailed-worktree-path.js';
  * Executes a jailed `edit_file` string replacement inside `scopeHandle`.
  *
  * Verifies that `params.oldString` exists in the target file before writing the updated UTF-8 text.
+ * Returns an `isError: true` result when reading the file fails or `params.oldString` is absent.
  *
  * @param {unknown}                      scopeHandle - Active isolation scope handle.
  * @param {ExecuteFsEditOperationParams} params      - Validated edit arguments (`path`, `oldString`, `newString`).
  *
  * @returns {Promise<ToolExecutionResult>} Frozen tool execution result.
- *
- * @throws {Error} If `params.oldString` is not found in the target file.
  */
 export async function executeFsEditOperation(scopeHandle, params) {
     const { normalizedRelPath, absolutePath } = resolveJailedWorktreePath(scopeHandle, params.path, 'write');
-    const currentContent = await readFile(absolutePath, 'utf8');
+    let currentContent;
+    try {
+        currentContent = await readFile(absolutePath, 'utf8');
+    }
+    catch (err) {
+        return Object.freeze({
+            content: err instanceof Error ? err.message : String(err),
+            isError: true,
+        });
+    }
     if (!currentContent.includes(params.oldString)) {
-        throw new Error(`fs:edit failed on '${normalizedRelPath}': target oldString was not found in file.`);
+        return Object.freeze({
+            content: `fs:edit failed on '${normalizedRelPath}': target oldString was not found in file.`,
+            isError: true,
+        });
     }
     const updatedContent = currentContent.replace(params.oldString, () => params.newString);
     await writeFile(absolutePath, updatedContent, 'utf8');
-    return Object.freeze({ content: `Edited ${normalizedRelPath}` });
+    return Object.freeze({
+        content: `Edited ${normalizedRelPath}`,
+        isError: false,
+    });
 }
 //# sourceMappingURL=execute-fs-edit-operation.js.map

package/dist/executors/internal/execute-fs-edit-operation.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute-fs-edit-operation.js","sourceRoot":"","sources":["../../../src/executors/internal/execute-fs-edit-operation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAgB9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAoB,EACpB,MAAoC;IAEpC,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,GAAG,yBAAyB,CACnE,WAAW,EACX,MAAM,CAAC,IAAI,EACX,OAAO,CACR,CAAC;IACF,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC5D,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,sBAAsB,iBAAiB,4CAA4C,CACpF,CAAC;IACJ,CAAC;IACD,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxF,MAAM,SAAS,CAAC,YAAY,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,MAAM,CAAsB,EAAE,OAAO,EAAE,UAAU,iBAAiB,EAAE,EAAE,CAAC,CAAC;AACxF,CAAC"}
+{"version":3,"file":"execute-fs-edit-operation.js","sourceRoot":"","sources":["../../../src/executors/internal/execute-fs-edit-operation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAgB9E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAoB,EACpB,MAAoC;IAEpC,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,GAAG,yBAAyB,CACnE,WAAW,EACX,MAAM,CAAC,IAAI,EACX,OAAO,CACR,CAAC;IACF,IAAI,cAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,cAAc,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,MAAM,CAAC,MAAM,CAAsB;YACxC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,OAAO,MAAM,CAAC,MAAM,CAAsB;YACxC,OAAO,EAAE,sBAAsB,iBAAiB,4CAA4C;YAC5F,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IACD,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxF,MAAM,SAAS,CAAC,YAAY,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,MAAM,CAAsB;QACxC,OAAO,EAAE,UAAU,iBAAiB,EAAE;QACtC,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/executors/internal/fs-coding-tool-drivers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-coding-tool-drivers.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/fs-coding-tool-drivers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAW3B;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAG,OAAO,EACpD,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,EAC7B,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAK9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAG,OAAO,EAC9C,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,EAC7B,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAG9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAG,OAAO,EAC/C,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAG9B"}
+{"version":3,"file":"fs-coding-tool-drivers.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/fs-coding-tool-drivers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAW3B;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAG,OAAO,EACpD,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,EAC7B,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAY9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAG,OAAO,EAC9C,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,EAC7B,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAG9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAG,OAAO,EAC/C,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAG9B"}

package/dist/executors/internal/fs-coding-tool-drivers.js

@@ -16,8 +16,16 @@ import { resolveJailedWorktreePath } from './resolve-jailed-worktree-path.js';
 export async function readFsToolFile(node, args, ctx) {
     const parsed = node.inputSchema.parse(args);
     const { absolutePath } = resolveJailedWorktreePath(ctx.scopeHandle, parsed.path, 'read');
-    const content = await readFile(absolutePath, 'utf8');
-    return Object.freeze({ content });
+    try {
+        const content = await readFile(absolutePath, 'utf8');
+        return Object.freeze({ content, isError: false });
+    }
+    catch (err) {
+        return Object.freeze({
+            content: err instanceof Error ? err.message : String(err),
+            isError: true,
+        });
+    }
 }
 /**
  * Validates `args` against `node.inputSchema` and executes a jailed `fs:edit` replacement.

package/dist/executors/internal/fs-coding-tool-drivers.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs-coding-tool-drivers.js","sourceRoot":"","sources":["../../../src/executors/internal/fs-coding-tool-drivers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ5C,OAAO,EAEL,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEL,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAA6B,EAC7B,IAAa,EACb,GAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAA8B,CAAC;IACzE,MAAM,EAAE,YAAY,EAAE,GAAG,yBAAyB,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,MAAM,CAAsB,EAAE,OAAO,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,IAA6B,EAC7B,IAAa,EACb,GAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAiC,CAAC;IAC5E,OAAO,sBAAsB,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,IAA8B,EAC9B,IAAa,EACb,GAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAkC,CAAC;IAC7E,OAAO,uBAAuB,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"fs-coding-tool-drivers.js","sourceRoot":"","sources":["../../../src/executors/internal/fs-coding-tool-drivers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ5C,OAAO,EAEL,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEL,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAA6B,EAC7B,IAAa,EACb,GAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAA8B,CAAC;IACzE,MAAM,EAAE,YAAY,EAAE,GAAG,yBAAyB,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC,MAAM,CAAsB,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,MAAM,CAAC,MAAM,CAAsB;YACxC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,IAA6B,EAC7B,IAAa,EACb,GAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAiC,CAAC;IAC5E,OAAO,sBAAsB,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,IAA8B,EAC9B,IAAa,EACb,GAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAkC,CAAC;IAC7E,OAAO,uBAAuB,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -19,6 +19,7 @@ export { createFsSecretLiteralsGuardBuilder } from './builders/create-fs-secret-
 export { createFsTelemetryBuilder } from './builders/create-fs-telemetry-builder.js';
 export { createFsTextSourceBuilder } from './builders/create-fs-text-source-builder.js';
 export { createFsWriteGuardBuilder, type FsWriteGuardOptions, } from './builders/create-fs-write-guard-builder.js';
+export { extractFsViolatedPaths, extractFsViolatedPaths as violatedPaths, } from './builders/extract-fs-violated-paths.js';
 export type { FsNamespace } from './builders/fs-namespace-contract.js';
 export { fs } from './builders/fs-namespace.js';
 export { createFsExecutors } from './executors/create-fs-executors.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,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,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,EAAE,iCAAiC,EAAE,MAAM,uDAAuD,CAAC;AAC1G,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,EACL,+BAA+B,EAC/B,KAAK,yBAAyB,GAC/B,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,GACzB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,0CAA0C,EAAE,MAAM,iEAAiE,CAAC;AAC7H,OAAO,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAC;AACrG,OAAO,EAAE,kCAAkC,EAAE,MAAM,uDAAuD,CAAC;AAC3G,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,GACzB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,IAAI,aAAa,GACxC,MAAM,yCAAyC,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,EAAE,EAAE,MAAM,4BAA4B,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,YAAY,EACZ,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,qCAAqC,EACrC,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,KAAK,mBAAmB,EACxB,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -18,6 +18,7 @@ export { createFsSecretLiteralsGuardBuilder } from './builders/create-fs-secret-
 export { createFsTelemetryBuilder } from './builders/create-fs-telemetry-builder.js';
 export { createFsTextSourceBuilder } from './builders/create-fs-text-source-builder.js';
 export { createFsWriteGuardBuilder, } from './builders/create-fs-write-guard-builder.js';
+export { extractFsViolatedPaths, extractFsViolatedPaths as violatedPaths, } from './builders/extract-fs-violated-paths.js';
 export { fs } from './builders/fs-namespace.js';
 export { createFsExecutors } from './executors/create-fs-executors.js';
 export { collectFsTelemetry, evaluateFsQuotaTripwire, executeFsRegexCheck, } from './executors/fs-check-tripwire-and-telemetry.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,EAAE,iCAAiC,EAAE,MAAM,uDAAuD,CAAC;AAC1G,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,EACL,+BAA+B,GAEhC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EACL,yBAAyB,GAE1B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,0CAA0C,EAAE,MAAM,iEAAiE,CAAC;AAC7H,OAAO,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAC;AACrG,OAAO,EAAE,kCAAkC,EAAE,MAAM,uDAAuD,CAAC;AAC3G,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EACL,yBAAyB,GAE1B,MAAM,6CAA6C,CAAC;AAErD,OAAO,EAAE,EAAE,EAAE,MAAM,4BAA4B,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAK5C,OAAO,EACL,qCAAqC,EACrC,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAEL,kBAAkB,GAGnB,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,EAAE,iCAAiC,EAAE,MAAM,uDAAuD,CAAC;AAC1G,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,EACL,+BAA+B,GAEhC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EACL,yBAAyB,GAE1B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,0CAA0C,EAAE,MAAM,iEAAiE,CAAC;AAC7H,OAAO,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAC;AACrG,OAAO,EAAE,kCAAkC,EAAE,MAAM,uDAAuD,CAAC;AAC3G,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EACL,yBAAyB,GAE1B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,IAAI,aAAa,GACxC,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAE,EAAE,EAAE,MAAM,4BAA4B,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAK5C,OAAO,EACL,qCAAqC,EACrC,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAEL,kBAAkB,GAGnB,MAAM,mCAAmC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paraharness/fs",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Workspace-jailed filesystem tools, glob effect matchers, pre/post-flight write policy guards, quota tripwires, and atomic JSONL lesson store for Paraharness.",
   "keywords": [
     "paraharness",
@@ -50,8 +50,8 @@
     "tinyglobby": "^0.2.17",
     "write-file-atomic": "^8.0.0",
     "zod": "^4.6.7",
-    "@paraharness/core": "0.1.0",
-    "@paraharness/lockfile": "0.1.0"
+    "@paraharness/core": "0.2.4",
+    "@paraharness/lockfile": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.9.0",