@j0hanz/filesystem-mcp 2.2.0 → 2.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j0hanz/filesystem-mcp",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "mcpName": "io.github.j0hanz/filesystem-mcp",
   "description": "Secure filesystem MCP server for reading, writing, searching, diffing, and patching files.",
   "author": "j0hanz",
@@ -32,12 +32,10 @@
     "format": "prettier --write .",
     "type-check": "tsc -p tsconfig.json --noEmit",
     "type-check:test": "tsc -p tsconfig.test.json",
-    "check:static": "npm run build && npm run type-check && npm run type-check:test && eslint . && prettier --check . && knip",
+    "check:static": "npm run build && npm run type-check:test && npm run lint && prettier --check . && knip",
     "fix": "npm run format && npm run lint:fix && npm run check",
     "check": "npm run check:static && npm run test",
-    "test": "node --test --import tsx",
-    "test:inspector": "node --test --import tsx \"__tests__/inspector-*.test.ts\"",
-    "inspector": "npm run build && npx -y @modelcontextprotocol/inspector node dist/index.js"
+    "test": "node --test"
   },
   "keywords": [
     "mcp",
@@ -66,13 +64,12 @@
     "@modelcontextprotocol/server": "2.0.0",
     "diff": "^9",
     "express": "^5.2.1",
-    "ignore": "^7.0.6",
-    "zod": "^4.4.3"
+    "ignore": "^7.0.9",
+    "zod": "^4.6.5"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@modelcontextprotocol/client": "2.0.0",
-    "@modelcontextprotocol/inspector": "^2.4.0",
     "@trivago/prettier-plugin-sort-imports": "^6.0.2",
     "@types/express": "^5.0.6",
     "@types/node": "^24",
@@ -80,14 +77,10 @@
     "eslint-config-prettier": "^10.1.8",
     "knip": "^6",
     "prettier": "^3.9.6",
-    "tsx": "^4.23.12",
     "typescript": "^6",
-    "typescript-eslint": "^8.68.0"
+    "typescript-eslint": "^8.70.0"
   },
   "engines": {
     "node": ">=24"
-  },
-  "allowScripts": {
-    "esbuild@0.28.2": true
   }
 }

package/dist/core/page-store.d.ts

@@ -1,41 +0,0 @@
-import { FsError } from './errors.js';
-export interface PageSnapshot<T = unknown, M = unknown> {
-    readonly items: readonly T[];
-    readonly metadata: M;
-}
-export interface PageSnapshotStoreOptions {
-    readonly maxSnapshots?: number;
-    readonly ttlMs?: number;
-    readonly now?: () => number;
-}
-/**
- * The one cursor rejection: a cursor whose snapshot expired, was evicted, was
- * already consumed past its end, or belongs to a different query. Every case
- * has the same remedy, so they share one message.
- */
-export declare function invalidCursor(): FsError;
-/**
- * Short-lived snapshots of a completed query's full result set, so later pages
- * slice a stored array instead of re-scanning and re-sorting the filesystem.
- *
- * ponytail: bounded by snapshot count and TTL, not by bytes — 32 x 20,000
- * `list` entries or 32 x 10,000 `search_text` matches, order of a few hundred MB
- * held for 60s, and the HTTP leg shares one store so any caller can drive it.
- * If that shows up as memory pressure, meter bytes the way `ResourceStore` does.
- */
-export declare class PageSnapshotStore {
-    private readonly byId;
-    private readonly maxSnapshots;
-    private readonly ttlMs;
-    private readonly now;
-    constructor(options?: PageSnapshotStoreOptions);
-    private pruneExpired;
-    create(params: {
-        queryKey: string;
-        items: readonly unknown[];
-        metadata?: unknown;
-    }): string;
-    read<T, M = undefined>(snapshotId: string, queryKey: string): PageSnapshot<T, M>;
-    clear(): void;
-}
-//# sourceMappingURL=page-store.d.ts.map

package/dist/core/page-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"page-store.d.ts","sourceRoot":"","sources":["../../src/core/page-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,OAAO,EAAE,MAAM,aAAa,CAAC;AAYjD,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACpD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAKvC;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyC;IAC9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,OAAO,GAAE,wBAA6B;IAMlD,OAAO,CAAC,YAAY;IAOpB,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM;IAmB3F,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAYhF,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/page-store.js

@@ -1,74 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { ErrorCode, FsError } from './errors.js';
-const DEFAULT_MAX_SNAPSHOTS = 32;
-const DEFAULT_TTL_MS = 60 * 1000;
-/**
- * The one cursor rejection: a cursor whose snapshot expired, was evicted, was
- * already consumed past its end, or belongs to a different query. Every case
- * has the same remedy, so they share one message.
- */
-export function invalidCursor() {
-    return new FsError(ErrorCode.INVALID_INPUT, 'Invalid cursor. Request the first page without a cursor.');
-}
-/**
- * Short-lived snapshots of a completed query's full result set, so later pages
- * slice a stored array instead of re-scanning and re-sorting the filesystem.
- *
- * ponytail: bounded by snapshot count and TTL, not by bytes — 32 x 20,000
- * `list` entries or 32 x 10,000 `search_text` matches, order of a few hundred MB
- * held for 60s, and the HTTP leg shares one store so any caller can drive it.
- * If that shows up as memory pressure, meter bytes the way `ResourceStore` does.
- */
-export class PageSnapshotStore {
-    byId = new Map();
-    maxSnapshots;
-    ttlMs;
-    now;
-    constructor(options = {}) {
-        this.maxSnapshots = options.maxSnapshots ?? DEFAULT_MAX_SNAPSHOTS;
-        this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
-        this.now = options.now ?? Date.now;
-    }
-    pruneExpired() {
-        const now = this.now();
-        for (const [snapshotId, entry] of this.byId) {
-            if (entry.expiresAt <= now)
-                this.byId.delete(snapshotId);
-        }
-    }
-    create(params) {
-        this.pruneExpired();
-        const snapshotId = randomUUID();
-        this.byId.set(snapshotId, {
-            queryKey: params.queryKey,
-            items: params.items,
-            metadata: params.metadata,
-            expiresAt: this.now() + this.ttlMs,
-        });
-        // Oldest first: Map keeps insertion order and `read` re-inserts, so the
-        // first key is the least recently used snapshot.
-        while (this.byId.size > this.maxSnapshots) {
-            const oldest = this.byId.keys().next();
-            if (oldest.done)
-                break;
-            this.byId.delete(oldest.value);
-        }
-        return snapshotId;
-    }
-    read(snapshotId, queryKey) {
-        this.pruneExpired();
-        const entry = this.byId.get(snapshotId);
-        if (entry?.queryKey !== queryKey)
-            throw invalidCursor();
-        this.byId.delete(snapshotId);
-        this.byId.set(snapshotId, entry);
-        return {
-            items: entry.items,
-            metadata: entry.metadata,
-        };
-    }
-    clear() {
-        this.byId.clear();
-    }
-}
-//# sourceMappingURL=page-store.js.map

package/dist/core/page-store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"page-store.js","sourceRoot":"","sources":["../../src/core/page-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC;AAoBjC;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,OAAO,CAChB,SAAS,CAAC,aAAa,EACvB,0DAA0D,CAC3D,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IACX,IAAI,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC7C,YAAY,CAAS;IACrB,KAAK,CAAS;IACd,GAAG,CAAe;IAEnC,YAAY,UAAoC,EAAE;QAChD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,qBAAqB,CAAC;QAClE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;QAC7C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACrC,CAAC;IAEO,YAAY;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,CAAC,MAA2E;QAChF,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE;YACxB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK;SACnC,CAAC,CAAC;QACH,wEAAwE;QACxE,iDAAiD;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,IAAI;gBAAE,MAAM;YACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,CAAmB,UAAkB,EAAE,QAAgB;QACzD,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,QAAQ,KAAK,QAAQ;YAAE,MAAM,aAAa,EAAE,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,KAAqB;YAClC,QAAQ,EAAE,KAAK,CAAC,QAAa;SAC9B,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF","sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { ErrorCode, FsError } from './errors.js';\n\nconst DEFAULT_MAX_SNAPSHOTS = 32;\nconst DEFAULT_TTL_MS = 60 * 1000;\n\ninterface StoredPageSnapshot {\n  readonly queryKey: string;\n  readonly items: readonly unknown[];\n  readonly metadata: unknown;\n  readonly expiresAt: number;\n}\n\nexport interface PageSnapshot<T = unknown, M = unknown> {\n  readonly items: readonly T[];\n  readonly metadata: M;\n}\n\nexport interface PageSnapshotStoreOptions {\n  readonly maxSnapshots?: number;\n  readonly ttlMs?: number;\n  readonly now?: () => number;\n}\n\n/**\n * The one cursor rejection: a cursor whose snapshot expired, was evicted, was\n * already consumed past its end, or belongs to a different query. Every case\n * has the same remedy, so they share one message.\n */\nexport function invalidCursor(): FsError {\n  return new FsError(\n    ErrorCode.INVALID_INPUT,\n    'Invalid cursor. Request the first page without a cursor.',\n  );\n}\n\n/**\n * Short-lived snapshots of a completed query's full result set, so later pages\n * slice a stored array instead of re-scanning and re-sorting the filesystem.\n *\n * ponytail: bounded by snapshot count and TTL, not by bytes — 32 x 20,000\n * `list` entries or 32 x 10,000 `search_text` matches, order of a few hundred MB\n * held for 60s, and the HTTP leg shares one store so any caller can drive it.\n * If that shows up as memory pressure, meter bytes the way `ResourceStore` does.\n */\nexport class PageSnapshotStore {\n  private readonly byId = new Map<string, StoredPageSnapshot>();\n  private readonly maxSnapshots: number;\n  private readonly ttlMs: number;\n  private readonly now: () => number;\n\n  constructor(options: PageSnapshotStoreOptions = {}) {\n    this.maxSnapshots = options.maxSnapshots ?? DEFAULT_MAX_SNAPSHOTS;\n    this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;\n    this.now = options.now ?? Date.now;\n  }\n\n  private pruneExpired(): void {\n    const now = this.now();\n    for (const [snapshotId, entry] of this.byId) {\n      if (entry.expiresAt <= now) this.byId.delete(snapshotId);\n    }\n  }\n\n  create(params: { queryKey: string; items: readonly unknown[]; metadata?: unknown }): string {\n    this.pruneExpired();\n    const snapshotId = randomUUID();\n    this.byId.set(snapshotId, {\n      queryKey: params.queryKey,\n      items: params.items,\n      metadata: params.metadata,\n      expiresAt: this.now() + this.ttlMs,\n    });\n    // Oldest first: Map keeps insertion order and `read` re-inserts, so the\n    // first key is the least recently used snapshot.\n    while (this.byId.size > this.maxSnapshots) {\n      const oldest = this.byId.keys().next();\n      if (oldest.done) break;\n      this.byId.delete(oldest.value);\n    }\n    return snapshotId;\n  }\n\n  read<T, M = undefined>(snapshotId: string, queryKey: string): PageSnapshot<T, M> {\n    this.pruneExpired();\n    const entry = this.byId.get(snapshotId);\n    if (entry?.queryKey !== queryKey) throw invalidCursor();\n    this.byId.delete(snapshotId);\n    this.byId.set(snapshotId, entry);\n    return {\n      items: entry.items as readonly T[],\n      metadata: entry.metadata as M,\n    };\n  }\n\n  clear(): void {\n    this.byId.clear();\n  }\n}\n"]}

package/dist/core/primitives.d.ts

@@ -1,34 +0,0 @@
-/**
- * Minimal shared primitives with no intra-package dependencies.
- * Kept separate to avoid import cycles between observability.ts and util.ts.
- */
-/** The four filesystem entry types; published as the `FileType` schema. */
-export declare const ENTRY_TYPES: readonly ["file", "directory", "symlink", "other"];
-export type EntryType = (typeof ENTRY_TYPES)[number];
-/** The three predicates both `Dirent` and `Stats` expose - all `resolveEntryType` needs. */
-export interface DirentLike {
-    isDirectory(): boolean;
-    isFile(): boolean;
-    isSymbolicLink(): boolean;
-}
-export declare function resolveEntryType(dirent: DirentLike): EntryType;
-/**
- * Warn once per (setting, value) that a configured value was rejected, and say
- * what was used instead. console.error, not Logger: this module stays
- * dependency-free to avoid import cycles, and a startup misconfiguration is
- * worth printing even when the operator asked for errors only.
- */
-export declare function warnInvalidSetting(name: string, value: string, expected: string, fallback: string | number | boolean): void;
-/**
- * Parse a boolean env flag: `true`/`1` enable, `false`/`0`/empty disable.
- * Any other value warns once per var (when `name` is given) and reads as
- * false, so a typo like `FS_ALLOW_SENSITIVE=yes` is never silent.
- */
-export declare function parseTrueEnvFlag(value: string | undefined, name?: string): boolean;
-export declare function escapeRegexLiteral(str: string): string;
-export declare function splitDirList(val: string | undefined): string[];
-export declare const IS_WINDOWS: boolean;
-export declare const isSlash: (code: number) => boolean;
-export declare const isAlpha: (code: number) => boolean;
-export declare const toPosixPath: (value: string) => string;
-//# sourceMappingURL=primitives.d.ts.map

package/dist/core/primitives.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/core/primitives.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,WAAW,oDAAqD,CAAC;AAC9E,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,4FAA4F;AAC5F,MAAM,WAAW,UAAU;IACzB,WAAW,IAAI,OAAO,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC;IAClB,cAAc,IAAI,OAAO,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAK9D;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAClC,IAAI,CAON;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAQlF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAM9D;AAID,eAAO,MAAM,UAAU,SAA+B,CAAC;AAEvD,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,OAAqC,CAAC;AAE7E,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,OACoB,CAAC;AAE5D,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAAqC,CAAC"}

package/dist/core/primitives.js

@@ -1,63 +0,0 @@
-import { delimiter } from 'node:path';
-/**
- * Minimal shared primitives with no intra-package dependencies.
- * Kept separate to avoid import cycles between observability.ts and util.ts.
- */
-/** The four filesystem entry types; published as the `FileType` schema. */
-export const ENTRY_TYPES = ['file', 'directory', 'symlink', 'other'];
-export function resolveEntryType(dirent) {
-    if (dirent.isDirectory())
-        return 'directory';
-    if (dirent.isFile())
-        return 'file';
-    if (dirent.isSymbolicLink())
-        return 'symlink';
-    return 'other';
-}
-const warnedSettings = new Set();
-/**
- * Warn once per (setting, value) that a configured value was rejected, and say
- * what was used instead. console.error, not Logger: this module stays
- * dependency-free to avoid import cycles, and a startup misconfiguration is
- * worth printing even when the operator asked for errors only.
- */
-export function warnInvalidSetting(name, value, expected, fallback) {
-    const key = `${name}:${value}`;
-    if (warnedSettings.has(key))
-        return;
-    warnedSettings.add(key);
-    console.error(`[warning] Invalid ${name} value: ${value} (must be ${expected}). Using default: ${String(fallback)}`);
-}
-/**
- * Parse a boolean env flag: `true`/`1` enable, `false`/`0`/empty disable.
- * Any other value warns once per var (when `name` is given) and reads as
- * false, so a typo like `FS_ALLOW_SENSITIVE=yes` is never silent.
- */
-export function parseTrueEnvFlag(value, name) {
-    if (value === undefined)
-        return false;
-    const trimmed = value.trim().toLowerCase();
-    if (trimmed === 'true' || trimmed === '1')
-        return true;
-    if (name && trimmed !== '' && trimmed !== 'false' && trimmed !== '0') {
-        warnInvalidSetting(name, value, '"true" or "1"', false);
-    }
-    return false;
-}
-export function escapeRegexLiteral(str) {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-export function splitDirList(val) {
-    if (!val)
-        return [];
-    return val
-        .split(delimiter)
-        .map((p) => p.trim())
-        .filter((p) => p.length > 0);
-}
-// ─── Path primitives (moved from path.ts to break the path↔sensitive cycle) ──
-export const IS_WINDOWS = process.platform === 'win32';
-export const isSlash = (code) => code === 47 || code === 92;
-export const isAlpha = (code) => (code >= 65 && code <= 90) || (code >= 97 && code <= 122);
-export const toPosixPath = (value) => value.replaceAll('\\', '/');
-//# sourceMappingURL=primitives.js.map

package/dist/core/primitives.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/core/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;GAGG;AAEH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AAU9E,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,IAAI,MAAM,CAAC,WAAW,EAAE;QAAE,OAAO,WAAW,CAAC;IAC7C,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,MAAM,CAAC;IACnC,IAAI,MAAM,CAAC,cAAc,EAAE;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,KAAa,EACb,QAAgB,EAChB,QAAmC;IAEnC,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;IAC/B,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IACpC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,KAAK,CACX,qBAAqB,IAAI,WAAW,KAAK,aAAa,QAAQ,qBAAqB,MAAM,CAAC,QAAQ,CAAC,EAAE,CACtG,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAyB,EAAE,IAAa;IACvE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,IAAI,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACrE,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAuB;IAClD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,GAAG;SACP,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,gFAAgF;AAEhF,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AAEvD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,CAAC;AAE7E,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAW,EAAE,CAC/C,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC","sourcesContent":["import { delimiter } from 'node:path';\n\n/**\n * Minimal shared primitives with no intra-package dependencies.\n * Kept separate to avoid import cycles between observability.ts and util.ts.\n */\n\n/** The four filesystem entry types; published as the `FileType` schema. */\nexport const ENTRY_TYPES = ['file', 'directory', 'symlink', 'other'] as const;\nexport type EntryType = (typeof ENTRY_TYPES)[number];\n\n/** The three predicates both `Dirent` and `Stats` expose - all `resolveEntryType` needs. */\nexport interface DirentLike {\n  isDirectory(): boolean;\n  isFile(): boolean;\n  isSymbolicLink(): boolean;\n}\n\nexport function resolveEntryType(dirent: DirentLike): EntryType {\n  if (dirent.isDirectory()) return 'directory';\n  if (dirent.isFile()) return 'file';\n  if (dirent.isSymbolicLink()) return 'symlink';\n  return 'other';\n}\n\nconst warnedSettings = new Set<string>();\n\n/**\n * Warn once per (setting, value) that a configured value was rejected, and say\n * what was used instead. console.error, not Logger: this module stays\n * dependency-free to avoid import cycles, and a startup misconfiguration is\n * worth printing even when the operator asked for errors only.\n */\nexport function warnInvalidSetting(\n  name: string,\n  value: string,\n  expected: string,\n  fallback: string | number | boolean,\n): void {\n  const key = `${name}:${value}`;\n  if (warnedSettings.has(key)) return;\n  warnedSettings.add(key);\n  console.error(\n    `[warning] Invalid ${name} value: ${value} (must be ${expected}). Using default: ${String(fallback)}`,\n  );\n}\n\n/**\n * Parse a boolean env flag: `true`/`1` enable, `false`/`0`/empty disable.\n * Any other value warns once per var (when `name` is given) and reads as\n * false, so a typo like `FS_ALLOW_SENSITIVE=yes` is never silent.\n */\nexport function parseTrueEnvFlag(value: string | undefined, name?: string): boolean {\n  if (value === undefined) return false;\n  const trimmed = value.trim().toLowerCase();\n  if (trimmed === 'true' || trimmed === '1') return true;\n  if (name && trimmed !== '' && trimmed !== 'false' && trimmed !== '0') {\n    warnInvalidSetting(name, value, '\"true\" or \"1\"', false);\n  }\n  return false;\n}\n\nexport function escapeRegexLiteral(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\nexport function splitDirList(val: string | undefined): string[] {\n  if (!val) return [];\n  return val\n    .split(delimiter)\n    .map((p) => p.trim())\n    .filter((p) => p.length > 0);\n}\n\n// ─── Path primitives (moved from path.ts to break the path↔sensitive cycle) ──\n\nexport const IS_WINDOWS = process.platform === 'win32';\n\nexport const isSlash = (code: number): boolean => code === 47 || code === 92;\n\nexport const isAlpha = (code: number): boolean =>\n  (code >= 65 && code <= 90) || (code >= 97 && code <= 122);\n\nexport const toPosixPath = (value: string): string => value.replaceAll('\\\\', '/');\n"]}