@planu/cli 5.3.67 → 5.3.69

package/dist/engine/context-orchestrator/index.js

@@ -1,7 +1,9 @@
 import { suggestArchivableSpecs, archiveSpecToPath } from '../context-manager.js';
 import { writeCheckpoint } from '../session/checkpoint-writer.js';
 import { sessionTracker } from '../session/session-tracker.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { specStore } from '../../storage/index.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { hashProjectPath, projectDataDir } from '../../storage/base-store.js';
 import { emitAutopilotEvent } from '../autopilot/event-bus.js';
 const WARN_THRESHOLD = 80;

package/dist/engine/convention-scanner/convention-parser.js

@@ -1,8 +1,9 @@
 import { technologyValue } from '../technology-registry.js';
 // engine/convention-scanner/convention-parser.ts — SPEC-192
 // Parses CLAUDE.md and .claude/rules/*.md to extract ConventionRule[]
-import { readFileSync, readdirSync } from 'node:fs';
+import { readdirSync } from 'node:fs';
 import { join, basename } from 'node:path';
+import { readFileSafeSync as readFileSafe } from '../../core/shared/fs.js';
 // ── keyword maps ──────────────────────────────────────────────────────────────
 const NAMING_KEYWORDS = [
     'english',
@@ -68,14 +69,6 @@ const CODE_QUALITY_KEYWORDS = [
     'type assertion',
 ];
 // ── helpers ───────────────────────────────────────────────────────────────────
-function readFileSafe(path) {
-    try {
-        return readFileSync(path, 'utf-8');
-    }
-    catch {
-        return '';
-    }
-}
 function listRulesFiles(projectPath) {
     const rulesDir = join(projectPath, '.claude', 'rules');
     try {

package/dist/engine/cost-guardrails.js

@@ -1,4 +1,5 @@
 // engine/cost-guardrails.ts — Cost Guardrails computation logic (SPEC-393)
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { getBudget } from '../storage/budget-store.js';
 /**
  * Compute the current budget status for a spec.

package/dist/engine/cost-tracking/ledger.js

@@ -1,6 +1,7 @@
 // engine/cost-tracking/ledger.ts — Per-operation cost ledger (SPEC-475)
 import { appendFile, readFile, mkdir } from 'node:fs/promises';
 import { join, dirname } from 'node:path';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { hashProjectPath, projectDataDir } from '../../storage/base-store.js';
 // ---------------------------------------------------------------------------
 // Model pricing (USD per token)

package/dist/engine/criterion-identity.js

@@ -12,7 +12,7 @@ export function normalizeCriterionText(value) {
         .normalize('NFKC')
         .replace(/^[-*+]\s*\[[ xX]\]\s*/, '')
         .replace(CRITERION_ID_PREFIX, '')
-        .replace(/[\p{P}]+/gu, ' ')
+        .replace(/[\p{P}\x60]+/gu, ' ')
         .replace(/[\s\u00a0]+/g, ' ')
         .trim()
         .toLowerCase();

package/dist/engine/dashboard/data-loader.js

@@ -2,6 +2,7 @@
 // for the dashboard. All I/O is synchronous-style via fs promises.
 import { readFile, readdir, stat } from 'node:fs/promises';
 import { join } from 'node:path';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { resolveStorageLayout } from '../../storage/storage-layout.js';
 import { computeDashboardMetrics, computeHealthScore } from './kanban-logic.js';
 import { extractSectionBody } from '../spec-format/read-technical-section.js';

package/dist/engine/dashboard/drift-score.js

@@ -1,7 +1,9 @@
 // engine/dashboard/drift-score.ts — Planu drift score computation (SPEC-748)
 // Computes a 0-100 score reflecting drift between done specs and codebase.
 // Formula: (driftReviewCount / doneSpecsCount) * 100, rounded to 1 decimal.
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { readJson, hashProjectPath } from '../../storage/base-store.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { listSpecs } from '../../storage/spec-store.js';
 import { join } from 'node:path';
 // ---------------------------------------------------------------------------

package/dist/engine/dashboard/spec-updater.d.ts

@@ -1,4 +1,6 @@
-import type { SpecStatusUpdateResult } from '../../types/index.js';
+import type { SpecStatusUpdateResult, UpdateStatusHandler } from '../../types/index.js';
+/** Wired by the tools layer at startup so this engine module never imports tools/. */
+export declare function registerUpdateStatusHandler(handler: UpdateStatusHandler): void;
 /** Update a spec's status after validating the transition.
  *
  * SPEC-720: Routes through handleUpdateStatus so all gates (DoD/validate/QA) run.

package/dist/engine/dashboard/spec-updater.js

@@ -1,7 +1,11 @@
 // engine/dashboard/spec-updater.ts — PATCH handler logic for spec status updates (SPEC-122)
 // SPEC-720: All status writes now route through handleUpdateStatus (full gates).
 import { isValidStatus, buildUpdateResult } from './kanban-logic.js';
-import { handleUpdateStatus } from '../../tools/update-status/index.js';
+let updateStatusHandler;
+/** Wired by the tools layer at startup so this engine module never imports tools/. */
+export function registerUpdateStatusHandler(handler) {
+    updateStatusHandler = handler;
+}
 /** Update a spec's status after validating the transition.
  *
  * SPEC-720: Routes through handleUpdateStatus so all gates (DoD/validate/QA) run.
@@ -19,8 +23,11 @@ export async function updateSpecStatus(projectId, specId, newStatus, projectPath
             // Fall back to cwd which is where the server runs.
             return process.cwd();
         })();
+    if (!updateStatusHandler) {
+        return buildUpdateResult(false, specId, newStatus, 'updateSpecStatus: no handler registered — call registerUpdateStatusHandler at startup');
+    }
     try {
-        const result = await handleUpdateStatus({
+        const result = await updateStatusHandler({
             specId,
             status: newStatus,
             projectId,

package/dist/engine/dashboard/templates-layout.d.ts

@@ -1,5 +1,5 @@
-/** Escape HTML special characters to prevent XSS */
-export declare function escapeHtml(str: string): string;
+import { escapeHtml } from '../../core/shared/strings.js';
+export { escapeHtml };
 /** Minimal Markdown → HTML converter (headings, bold, lists, code blocks) */
 export declare function markdownToHtml(md: string): string;
 /** Base CSS for the dark theme dashboard (assembled from subfunctions) */

package/dist/engine/dashboard/templates-layout.js

@@ -1,14 +1,7 @@
 // engine/dashboard/templates-layout.ts — Base layout and shared HTML helpers.
 // Dark theme, embedded CSS and JS. No external dependencies.
-/** Escape HTML special characters to prevent XSS */
-export function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-        .replace(/'/g, '&#39;');
-}
+import { escapeHtml } from '../../core/shared/strings.js';
+export { escapeHtml };
 /** Minimal Markdown → HTML converter (headings, bold, lists, code blocks) */
 export function markdownToHtml(md) {
     const lines = md.split('\n');

package/dist/engine/data-projects-gc/gc-runner.js

@@ -1,13 +1,11 @@
 // engine/data-projects-gc/gc-runner.ts — SPEC-581
 // Orchestrates scan + optional deletion of data/projects/ garbage.
-import { access, mkdir, readFile, readdir, rename, rm } from 'node:fs/promises';
+import { mkdir, readFile, readdir, rename, rm } from 'node:fs/promises';
 import { basename, dirname, isAbsolute, join, resolve } from 'node:path';
 import { scanProjectDirs } from './scanner.js';
+import { pathExists } from '../../core/shared/fs.js';
 import { atomicWriteFile } from '../safety/atomic-write-file.js';
 const DEFAULT_TRASH_TTL_DAYS = 30;
-async function pathExists(path) {
-    return access(path).then(() => true, () => false);
-}
 function parseTrashMetadata(value) {
     if (!value || typeof value !== 'object') {
         throw new Error('[Planu] Invalid GC trash metadata');

package/dist/engine/deleter/audit-logger.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { readJson, writeJson, projectDataDir } from '../../storage/base-store.js';
 import { randomUUID } from 'node:crypto';
 function auditFile(projectId) {

package/dist/engine/deleter/core.js

@@ -1,11 +1,17 @@
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { writeJson, projectDataDir } from '../../storage/base-store.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { listSpecs, getSpec, deleteSpec } from '../../storage/spec-store.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import * as patternStore from '../../storage/pattern-store.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import * as decisionStore from '../../storage/decision-store.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { moveToTrash, moveDataToTrash, countFiles, pathExists } from '../../storage/trash-store.js';
 import { appendAuditEntry } from './audit-logger.js';
 import { rm, mkdir, rename } from 'node:fs/promises';
 import { join } from 'node:path';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { resolveStorageLayout } from '../../storage/storage-layout.js';
 /**
  * Check if any specs reference the given specId as a dependency.

package/dist/engine/deleter/trash-manager.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { loadManifest, restoreFromTrash, purgeTrashItem, purgeAllTrash, } from '../../storage/trash-store.js';
 import { appendAuditEntry } from './audit-logger.js';
 /**

package/dist/engine/desktop-detector.js

@@ -1,18 +1,10 @@
 import { technologyValue } from './technology-registry.js';
 // engine/desktop-detector.ts — SPEC-014b desktop advanced detection
 // Detects IPC patterns, Tauri commands, .NET UI frameworks, macOS app types, Linux native frameworks.
-import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { glob } from 'glob';
+import { readFileOrNull as readFileSafe } from '../core/shared/fs.js';
 // --- Shared utilities ---
-async function readFileSafe(filePath) {
-    try {
-        return await readFile(filePath, 'utf-8');
-    }
-    catch {
-        return null;
-    }
-}
 async function globFirst(pattern, cwd) {
     try {
         const matches = await glob(pattern, { cwd, nodir: true, maxDepth: 5, dot: false });

package/dist/engine/detection-utils.d.ts

@@ -1,6 +1,7 @@
 import type { StackSignatures, ArchPatternsFile } from '../types/index.js';
+import { fileExistsIn as fileExists } from '../core/shared/fs.js';
+export { fileExists };
 declare const IGNORE_DIRS: string[];
-export declare function fileExists(basePath: string, relativePath: string): Promise<boolean>;
 export declare function hasAnyFile(basePath: string, patterns: string[]): Promise<boolean>;
 export declare function collectDependencies(projectPath: string): Promise<Set<string>>;
 export declare function loadStackSignatures(): Promise<StackSignatures>;

package/dist/engine/detection-utils.js

@@ -1,7 +1,9 @@
 // Planu — Shared detection utilities for project analysis
-import { readFile, access } from 'node:fs/promises';
+import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { glob } from 'glob';
+import { fileExistsIn as fileExists } from '../core/shared/fs.js';
+export { fileExists };
 const IGNORE_DIRS = [
     'node_modules/**',
     'dist/**',
@@ -14,15 +16,6 @@ const IGNORE_DIRS = [
     'target/**',
     'coverage/**',
 ];
-export async function fileExists(basePath, relativePath) {
-    try {
-        await access(join(basePath, relativePath));
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 export async function hasAnyFile(basePath, patterns) {
     for (const pattern of patterns) {
         try {

package/dist/engine/detectors/advanced-framework-detector/helpers.d.ts

@@ -1,6 +1,7 @@
 import type { PackageJsonDeps } from '../../../types/index.js';
+import { fileExistsByRead } from '../../../core/shared/fs.js';
+export { readFileSafe as readFileContent } from '../../../core/shared/fs.js';
+export { fileExistsByRead as fileExists };
 export declare function readPackageJson(projectPath: string): Promise<PackageJsonDeps>;
 export declare function getAllDeps(pkg: PackageJsonDeps): Set<string>;
-export declare function fileExists(filePath: string): Promise<boolean>;
-export declare function readFileContent(filePath: string): Promise<string>;
 //# sourceMappingURL=helpers.d.ts.map

package/dist/engine/detectors/advanced-framework-detector/helpers.js

@@ -2,6 +2,9 @@
 // Shared file I/O helpers for advanced framework detection.
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { fileExistsByRead } from '../../../core/shared/fs.js';
+export { readFileSafe as readFileContent } from '../../../core/shared/fs.js';
+export { fileExistsByRead as fileExists };
 export async function readPackageJson(projectPath) {
     try {
         const content = await readFile(join(projectPath, 'package.json'), 'utf-8');
@@ -17,21 +20,4 @@ export function getAllDeps(pkg) {
         ...Object.keys(pkg.devDependencies ?? {}),
     ]);
 }
-export async function fileExists(filePath) {
-    try {
-        await readFile(filePath, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export async function readFileContent(filePath) {
-    try {
-        return await readFile(filePath, 'utf-8');
-    }
-    catch {
-        return '';
-    }
-}
 //# sourceMappingURL=helpers.js.map

package/dist/engine/detectors/cicd-detector.js

@@ -1,4 +1,5 @@
 import { technologyValue } from '../technology-registry.js';
+import { fileExistsByRead } from '../../core/shared/fs.js';
 // engine/detectors/cicd-detector.ts — CI/CD platform detection (SPEC-026a)
 // Hierarchical detection: GitHub Actions > GitLab CI > CircleCI > Buildkite >
 // Azure DevOps > Jenkins > Drone > Woodpecker > Tekton > rest
@@ -112,7 +113,7 @@ async function findSignalFiles(projectPath, signal) {
     const found = [];
     // Check explicit paths
     for (const p of signal.paths) {
-        const exists = await fileExists(join(projectPath, p));
+        const exists = await fileExistsByRead(join(projectPath, p));
         if (exists) {
             found.push(p);
         }
@@ -131,15 +132,6 @@ async function findSignalFiles(projectPath, signal) {
     }
     return found;
 }
-async function fileExists(filePath) {
-    try {
-        await readFile(filePath, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 async function analyzeCiCdStages(projectPath, configFile) {
     try {
         const content = await readFile(join(projectPath, configFile), 'utf-8');

package/dist/engine/detectors/css-framework-detector.js

@@ -2,6 +2,7 @@
 // Detects CSS frameworks from package.json dependencies, config files, and import signals.
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { fileExistsByRead } from '../../core/shared/fs.js';
 // === Framework signal registry ===
 const FRAMEWORK_SIGNALS = {
     tailwind: {
@@ -117,7 +118,7 @@ async function checkConfigFiles(projectPath, scores, signals) {
     for (const fw of Object.keys(FRAMEWORK_SIGNALS)) {
         const frameworkSignals = FRAMEWORK_SIGNALS[fw];
         for (const configFile of frameworkSignals.configFiles) {
-            const exists = await fileExists(join(projectPath, configFile));
+            const exists = await fileExistsByRead(join(projectPath, configFile));
             if (exists) {
                 addScore(scores, fw, 2); // config file is medium-high confidence
                 /* v8 ignore next 1 */ // signals[fw] is always initialized in detectCSSFramework
@@ -126,15 +127,6 @@ async function checkConfigFiles(projectPath, scores, signals) {
         }
     }
 }
-async function fileExists(filePath) {
-    try {
-        await readFile(filePath, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 /** Map a numeric score to a confidence label. All real detections yield score ≥ 2. */
 function scoreToConfidence(score) {
     if (score >= 3) {

package/dist/engine/detectors/deployment-detector.js

@@ -1,7 +1,7 @@
 import { technologyValue } from '../technology-registry.js';
+import { fileExistsByRead } from '../../core/shared/fs.js';
 // engine/detectors/deployment-detector.ts — Deployment config detection (SPEC-026a)
 // Detects deployment targets, IaC tools, container orchestration, and cloud configs.
-import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { glob } from 'glob';
 // === Detection signals ===
@@ -123,7 +123,7 @@ export async function detectDeployment(projectPath) {
 async function findDeploymentFiles(projectPath, signal) {
     const found = [];
     for (const p of signal.paths) {
-        if (await fileExists(join(projectPath, p))) {
+        if (await fileExistsByRead(join(projectPath, p))) {
             found.push(p);
         }
     }
@@ -142,7 +142,7 @@ async function findDeploymentFiles(projectPath, signal) {
 }
 async function hasAnyPaths(projectPath, paths) {
     for (const p of paths) {
-        if (await fileExists(join(projectPath, p))) {
+        if (await fileExistsByRead(join(projectPath, p))) {
             return true;
         }
     }
@@ -157,13 +157,4 @@ async function hasGlobMatches(projectPath, pattern) {
         return false;
     }
 }
-async function fileExists(filePath) {
-    try {
-        await readFile(filePath, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 //# sourceMappingURL=deployment-detector.js.map

package/dist/engine/detectors/frontend-perf-detector.js

@@ -1,4 +1,5 @@
 import { technologyValue } from '../technology-registry.js';
+import { fileExistsByRead } from '../../core/shared/fs.js';
 // engine/detectors/frontend-perf-detector.ts — SPEC-057
 // Detects frontend performance budget configs, web vitals dependency,
 // SSR/SSG frameworks, design system tooling, and E2E test frameworks.
@@ -63,15 +64,6 @@ const STORYBOOK_MARKERS = [
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-async function fileExists(filePath) {
-    try {
-        await readFile(filePath, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 async function collectDeps(projectPath) {
     const deps = new Set();
     try {
@@ -95,7 +87,7 @@ async function collectDeps(projectPath) {
 async function detectPerformanceBudget(projectPath, deps) {
     let hasPerformanceBudget = false;
     for (const file of PERF_BUDGET_FILES) {
-        if (await fileExists(join(projectPath, file))) {
+        if (await fileExistsByRead(join(projectPath, file))) {
             hasPerformanceBudget = true;
             break;
         }

package/dist/engine/detectors/gitops-detector.js

@@ -3,6 +3,7 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { glob } from 'glob';
+import { fileExistsByRead } from '../../core/shared/fs.js';
 // === GitOps detection signals ===
 const GITOPS_SIGNALS = [
     {
@@ -90,7 +91,7 @@ async function findGitOpsFiles(projectPath, signal) {
     const found = [];
     // Check explicit paths
     for (const p of signal.paths) {
-        if (await fileExists(join(projectPath, p))) {
+        if (await fileExistsByRead(join(projectPath, p))) {
             found.push(p);
         }
     }
@@ -122,7 +123,7 @@ async function findPolicyFiles(projectPath, signal) {
     const found = [];
     // Check explicit paths
     for (const p of signal.paths) {
-        if (await fileExists(join(projectPath, p))) {
+        if (await fileExistsByRead(join(projectPath, p))) {
             found.push(p);
         }
     }
@@ -158,13 +159,4 @@ async function fileMatchesContent(projectPath, filePath, patterns) {
         return false;
     }
 }
-async function fileExists(filePath) {
-    try {
-        await readFile(filePath, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 //# sourceMappingURL=gitops-detector.js.map

package/dist/engine/detectors/idp-detector.js

@@ -3,6 +3,7 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { glob } from 'glob';
+import { escapeRegex } from '../../core/shared/strings.js';
 // === Detection signals ===
 const IDP_SIGNALS = [
     {
@@ -120,7 +121,4 @@ function extractYamlField(content, fieldPath) {
     // Remove surrounding quotes if present
     return value.replace(/^['"]|['"]$/g, '');
 }
-function escapeRegex(str) {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
 //# sourceMappingURL=idp-detector.js.map

package/dist/engine/detectors/k3s-detector.js

@@ -3,6 +3,7 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { glob } from 'glob';
+import { fileExistsByRead } from '../../core/shared/fs.js';
 // === Detection signals ===
 /** Explicit config file paths that indicate K3s is in use. */
 const K3S_PATHS = [
@@ -29,13 +30,13 @@ const K3S_KUBECONFIG_MARKER = 'k3s';
 export async function detectK3s(projectPath) {
     // Check explicit config file paths
     for (const p of K3S_PATHS) {
-        if (await fileExists(join(projectPath, p))) {
+        if (await fileExistsByRead(join(projectPath, p))) {
             return true;
         }
     }
     // Check K3s directories (presence of directory indicates K3s usage)
     for (const dir of K3S_DIRS) {
-        if (await fileExists(join(projectPath, dir))) {
+        if (await fileExistsByRead(join(projectPath, dir))) {
             return true;
         }
     }
@@ -64,15 +65,6 @@ async function detectK3sInKubeconfig(projectPath) {
     }
     return false;
 }
-async function fileExists(filePath) {
-    try {
-        await readFile(filePath, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 async function fileContains(filePath, substring) {
     try {
         const content = await readFile(filePath, 'utf-8');

package/dist/engine/detectors/llm-detector/file-readers.d.ts

@@ -1,4 +1,5 @@
-export declare function readFileOrNull(filePath: string): Promise<string | null>;
+import { readFileOrNull } from '../../../core/shared/fs.js';
+export { readFileOrNull };
 export declare function readPackageJson(projectPath: string): Promise<{
     deps: Record<string, string>;
     devDeps: Record<string, string>;

package/dist/engine/detectors/llm-detector/file-readers.js

@@ -1,14 +1,7 @@
 // llm-detector/file-readers.ts — File reading utilities for LLM detection
-import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
-export async function readFileOrNull(filePath) {
-    try {
-        return await readFile(filePath, 'utf-8');
-    }
-    catch {
-        return null;
-    }
-}
+import { readFileOrNull } from '../../../core/shared/fs.js';
+export { readFileOrNull };
 export async function readPackageJson(projectPath) {
     const content = await readFileOrNull(join(projectPath, 'package.json'));
     if (!content) {

package/dist/engine/detectors/mfe-detector.js

@@ -1,4 +1,5 @@
 import { technologyValue } from '../technology-registry.js';
+import { fileExistsByRead } from '../../core/shared/fs.js';
 // engine/detectors/mfe-detector.ts — Micro-frontend and signals detection (SPEC-017 tech-debt)
 // Detects Islands Architecture, Module Federation, Single-SPA, Nx MFE, Reactive Signals.
 import { readFile } from 'node:fs/promises';
@@ -64,14 +65,14 @@ async function collectAllDeps(projectPath) {
 }
 async function detectIslands(projectPath, deps) {
     // Astro: astro.config.mjs / .ts / .js
-    const hasAstroConfig = (await fileExists(join(projectPath, 'astro.config.mjs'))) ||
-        (await fileExists(join(projectPath, 'astro.config.ts'))) ||
-        (await fileExists(join(projectPath, 'astro.config.js')));
+    const hasAstroConfig = (await fileExistsByRead(join(projectPath, 'astro.config.mjs'))) ||
+        (await fileExistsByRead(join(projectPath, 'astro.config.ts'))) ||
+        (await fileExistsByRead(join(projectPath, 'astro.config.js')));
     if (hasAstroConfig || deps.has(technologyValue('technology-astro-23661e'))) {
         return { framework: technologyValue('technology-astro-23661e') };
     }
     // Fresh (Deno): fresh.config.ts
-    if (await fileExists(join(projectPath, 'fresh.config.ts'))) {
+    if (await fileExistsByRead(join(projectPath, 'fresh.config.ts'))) {
         return { framework: 'fresh' };
     }
     return { framework: undefined };
@@ -151,13 +152,4 @@ function detectSignals(deps) {
     }
     return detected;
 }
-async function fileExists(filePath) {
-    try {
-        await readFile(filePath, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 //# sourceMappingURL=mfe-detector.js.map

package/dist/engine/detectors/monitoring-detector.js

@@ -1,4 +1,5 @@
 import { technologyValue } from '../technology-registry.js';
+import { fileExistsByRead } from '../../core/shared/fs.js';
 // engine/detectors/monitoring-detector.ts — Monitoring/observability stack detection (SPEC-026a)
 // Detects Prometheus, Datadog, New Relic, OpenTelemetry, CloudWatch, Sentry, and more.
 import { readFile } from 'node:fs/promises';
@@ -184,7 +185,7 @@ async function isToolDetected(projectPath, signal, deps, envContent, foundFiles)
     if (signal.configFiles) {
         /* v8 ignore start */
         for (const f of signal.configFiles) {
-            if (await fileExists(join(projectPath, f))) {
+            if (await fileExistsByRead(join(projectPath, f))) {
                 foundFiles.push(f);
                 return true;
             }
@@ -256,14 +257,4 @@ async function safeGlob(projectPath, pattern) {
         return [];
     }
 }
-async function fileExists(filePath) {
-    try {
-        await readFile(filePath, 'utf-8');
-        return true;
-        /* v8 ignore next 2 */
-    }
-    catch {
-        return false;
-    }
-}
 //# sourceMappingURL=monitoring-detector.js.map

package/dist/engine/detectors/monorepo-detector.d.ts

@@ -1,5 +1,6 @@
 import type { MonorepoTool, MonorepoDetectionResult } from '../../types/index.js';
 export type { MonorepoTool, MonorepoDetectionResult };
+/** File existence check — returns true if file is accessible */
 /**
  * Detect which monorepo tool (if any) is used in the given project directory.
  *