@planu/cli 5.3.67 → 5.3.69

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

@@ -1,17 +1,8 @@
 // engine/detectors/monorepo-detector.ts — Monorepo tool detection
 // SPEC-004 tech-debt: Nx, Turborepo, Bazel, Rush, Moon monorepo detection
-import { access } from 'node:fs/promises';
 import { join } from 'node:path';
+import { fileExists } from '../../core/shared/fs.js';
 /** File existence check — returns true if file is accessible */
-async function fileExists(filePath) {
-    try {
-        await access(filePath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 /**
  * Detect which monorepo tool (if any) is used in the given project directory.
  *

package/dist/engine/detectors/nomad-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 top-level files that indicate Nomad is configured. */
 const NOMAD_EXPLICIT_PATHS = ['nomad.hcl', 'nomad.json'];
@@ -25,13 +26,13 @@ const NOMAD_TASK_PATTERN = 'task "';
 export async function detectNomad(projectPath) {
     // Check explicit top-level Nomad config files
     for (const p of NOMAD_EXPLICIT_PATHS) {
-        if (await fileExists(join(projectPath, p))) {
+        if (await fileExistsByRead(join(projectPath, p))) {
             return true;
         }
     }
     // Check Nomad directories
     for (const dir of NOMAD_DIRS) {
-        if (await fileExists(join(projectPath, dir))) {
+        if (await fileExistsByRead(join(projectPath, dir))) {
             return true;
         }
     }
@@ -79,15 +80,6 @@ async function globMatch(projectPath, pattern) {
         return [];
     }
 }
-async function fileExists(filePath) {
-    try {
-        await readFile(filePath, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 async function fileContainsAny(filePath, jobPatterns, taskPattern) {
     try {
         const content = await readFile(filePath, 'utf-8');

package/dist/engine/detectors/otel-ecosystem-detectors.d.ts

@@ -1,3 +1,5 @@
+import { readFileOrNull } from '../../core/shared/fs.js';
+export { readFileOrNull };
 /** npm package names that indicate OTel is installed */
 export declare const OTEL_NPM_PACKAGES: string[];
 /** Python package patterns (requirements.txt, pyproject.toml) */
@@ -10,7 +12,6 @@ export declare const OTEL_RUST_CRATE: "opentelemetry";
 export declare const OTEL_JAVA_PATTERN: "opentelemetry";
 /** Dependencies that indicate a project might need OTel (async workers, HTTP clients) */
 export declare const MULTISERVICE_DEPS: string[];
-export declare function readFileOrNull(filePath: string): Promise<string | null>;
 export declare function readPackageDeps(projectPath: string): Promise<{
     deps: Record<string, string>;
     devDeps: Record<string, string>;

package/dist/engine/detectors/otel-ecosystem-detectors.js

@@ -1,8 +1,9 @@
 import { technologyValue } from '../technology-registry.js';
 // engine/detectors/otel-ecosystem-detectors.ts — SPEC-044
 // Per-ecosystem OTel detection helpers extracted from otel-detector.ts.
-import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { readFileOrNull } from '../../core/shared/fs.js';
+export { readFileOrNull };
 // === OTel package patterns per ecosystem ===
 /** npm package names that indicate OTel is installed */
 export const OTEL_NPM_PACKAGES = [
@@ -35,15 +36,6 @@ export const MULTISERVICE_DEPS = [
     'amqplib',
     'nats',
 ];
-// === Shared helper ===
-export async function readFileOrNull(filePath) {
-    try {
-        return await readFile(filePath, 'utf-8');
-    }
-    catch {
-        return null;
-    }
-}
 export async function readPackageDeps(projectPath) {
     const content = await readFileOrNull(join(projectPath, 'package.json'));
     if (!content) {

package/dist/engine/doc-generator/executive-summary/html-template.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from '../../../core/shared/strings.js';
 // Planu — HTML document wrapper with inline CSS for executive summary
 const CSS = `
   @page { margin: 2cm; size: A4; }
@@ -47,11 +48,4 @@ ${bodyContent}
 </body>
 </html>`;
 }
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 //# sourceMappingURL=html-template.js.map

package/dist/engine/doc-generator/executive-summary/section-builders.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from '../../../core/shared/strings.js';
 // ── Helpers ─────────────────────────────────────────────────────────────────
 function statusToBadgeClass(status) {
     switch (status) {
@@ -142,11 +143,4 @@ export function buildTimelineSection(svgContent) {
 export function buildFooterSection() {
     return `<div class="footer">Generated by Planu &mdash; ${new Date().toUTCString()}</div>`;
 }
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 //# sourceMappingURL=section-builders.js.map

package/dist/engine/doc-generator/per-spec-report/mermaid-renderer.js

@@ -1,4 +1,5 @@
 import { getCdnUrl } from '../../../config/version-defaults.js';
+import { escapeHtml } from '../../../core/shared/strings.js';
 /**
  * Render an array of SpecDiagrams as HTML sections with Mermaid pre blocks.
  * Uses Mermaid.js CDN for client-side rendering with raw code fallback.
@@ -30,11 +31,4 @@ export function getMermaidScript() {
 </script>
 <noscript><style>.mermaid { white-space: pre; font-family: monospace; background: #f3f4f6; padding: 16px; border-radius: 8px; }</style></noscript>`;
 }
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 //# sourceMappingURL=mermaid-renderer.js.map

package/dist/engine/doc-generator/per-spec-report/spec-section-builders.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from '../../../core/shared/strings.js';
 const STATUS_COLORS = {
     draft: { bg: '#e5e7eb', fg: '#374151' },
     review: { bg: '#dbeafe', fg: '#1d4ed8' },
@@ -299,11 +300,4 @@ function metricCard(value, label) {
       <div class="metric-label">${escapeHtml(label)}</div>
     </div>`;
 }
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 //# sourceMappingURL=spec-section-builders.js.map

package/dist/engine/doc-generator/per-spec-report/technical-report.js

@@ -2,6 +2,7 @@ import { extractPerSpecData } from './spec-data-extractor.js';
 import { buildSpecHeaderSection, buildAffectedFilesSection, buildArchDecisionsSection, buildSpecFooterSection, buildImpactAnalysisSection, buildEstimationReasoningSection, buildLivingSpecSection, buildAcceptanceCriteriaSection, } from './spec-section-builders.js';
 import { renderMermaidDiagrams, getMermaidScript } from './mermaid-renderer.js';
 import { wrapPerSpecHtml } from './html-wrapper.js';
+import { escapeHtml } from '../../../core/shared/strings.js';
 /**
  * Generate a self-contained HTML technical report for a single spec.
  * Includes: header, scope, diagrams, impact analysis, affected files,
@@ -57,11 +58,4 @@ function buildScopeSection(scope, target, gitBranch) {
   ${gitBranch ? `<p><strong>Branch:</strong> <code>${escapeHtml(gitBranch)}</code></p>` : ''}
 </div>`;
 }
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 //# sourceMappingURL=technical-report.js.map

package/dist/engine/doc-generator/portal/analytics-page.js

@@ -8,6 +8,7 @@ import { computeVelocity } from './data-aggregators/velocity-aggregator.js';
 import { computeBurndown } from './data-aggregators/burndown-aggregator.js';
 import { detectBottlenecks } from './data-aggregators/bottleneck-detector.js';
 import { computeAccuracy } from './data-aggregators/accuracy-aggregator.js';
+import { escapeHtml } from '../../../core/shared/strings.js';
 /**
  * Generate the full analytics.html page for the Planu portal.
  * Returns an HTML string ready to write to disk.
@@ -202,13 +203,6 @@ function mapToPieSlices(counts) {
         color: CHART_COLORS[i % CHART_COLORS.length] ?? '#e94560',
     }));
 }
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 const ANALYTICS_CSS = `
   .analytics-main {
     max-width: 1100px;

package/dist/engine/doc-generator/portal/architecture-page.js

@@ -1,12 +1,6 @@
 import { buildNavbar } from './portal-navbar.js';
 import { getPortalThemeCSS } from './portal-theme.js';
-function escapeHtml(s) {
-    return s
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
+import { escapeHtml } from '../../../core/shared/strings.js';
 const TECH_ICONS = {
     typescript: '🔷',
     javascript: '🟡',

package/dist/engine/doc-generator/portal/changelog-page.js

@@ -1,12 +1,6 @@
 import { buildNavbar } from './portal-navbar.js';
 import { getPortalThemeCSS } from './portal-theme.js';
-function escapeHtml(s) {
-    return s
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
+import { escapeHtml } from '../../../core/shared/strings.js';
 function formatDate(dateStr) {
     try {
         const d = new Date(dateStr);

package/dist/engine/doc-generator/portal/decision-page.js

@@ -1,13 +1,7 @@
 import { buildNavbar } from './portal-navbar.js';
 import { getPortalThemeCSS } from './portal-theme.js';
 import { buildDecisionTimeline, DECISION_TIMELINE_CSS } from './decision-timeline-builder.js';
-function escapeHtml(s) {
-    return s
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
+import { escapeHtml } from '../../../core/shared/strings.js';
 const CATEGORY_COLORS = {
     architecture: '#7c3aed',
     stack: '#2563eb',

package/dist/engine/doc-generator/portal/decision-timeline-builder.js

@@ -1,10 +1,4 @@
-function escapeHtml(s) {
-    return s
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
+import { escapeHtml } from '../../../core/shared/strings.js';
 const CATEGORY_COLORS = {
     architecture: '#7c3aed', // purple
     stack: '#2563eb', // blue

package/dist/engine/doc-generator/portal/kanban-view-builder.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from '../../../core/shared/strings.js';
 const COLUMNS = [
     { key: 'draft', label: 'Draft' },
     { key: 'review', label: 'Review' },
@@ -77,13 +78,6 @@ function buildCard(spec) {
   ${tags ? `<div class="kanban-card-tags">${tags}</div>` : ''}
 </div>`;
 }
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 const KANBAN_CSS = `
   .kanban-board {
     display: grid;

package/dist/engine/doc-generator/portal/portal-breadcrumbs.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from '../../../core/shared/strings.js';
 function getBreadcrumbCss() {
     return `
   .planu-breadcrumbs {
@@ -48,13 +49,6 @@ function getBreadcrumbCss() {
     .planu-breadcrumbs, .planu-spec-nav { display: none !important; }
   }`;
 }
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 /**
  * Build a breadcrumb trail.
  * Last item is rendered as plain text (current page); all others are links.

package/dist/engine/doc-generator/portal/portal-landing-cards.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from '../../../core/shared/strings.js';
 const PAGE_CARDS = [
     {
         key: 'proposal',
@@ -131,13 +132,6 @@ function getLandingCardsCss() {
     .planu-cards-grid { grid-template-columns: repeat(2, 1fr); }
   }`;
 }
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 /**
  * Build the Quick Links section rendered between the navbar and the spec table
  * in planu/index.html. Cards that aren't yet generated are rendered greyed out.

package/dist/engine/doc-generator/portal/portal-navbar.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from '../../../core/shared/strings.js';
 /** All portal pages in display order */
 export const NAV_ITEMS = [
     { key: 'dashboard', label: 'Dashboard', filename: 'index.html', icon: '📋' },
@@ -99,13 +100,6 @@ const NAVBAR_CSS = `
 function getNavbarCss() {
     return NAVBAR_CSS;
 }
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 /**
  * Build a horizontal portal navbar.
  *

package/dist/engine/doc-generator/portal/portal-page-detector.d.ts

@@ -3,6 +3,9 @@
  * Order matches the navbar display order.
  */
 export declare const DETECTABLE_PAGES: Record<string, string>;
+/**
+ * Check whether a single file exists on disk (non-throwing).
+ */
 /**
  * Detect which portal pages currently exist inside planu/.
  * Returns an array of page keys (e.g. ['proposal', 'executive-summary']).

package/dist/engine/doc-generator/portal/portal-page-detector.js

@@ -1,6 +1,6 @@
 // Planu — Detects which portal pages exist on disk in planu/
-import { access } from 'node:fs/promises';
 import { join } from 'node:path';
+import { fileExists } from '../../../core/shared/fs.js';
 /**
  * All detectable portal page keys mapped to their filenames within planu/.
  * Order matches the navbar display order.
@@ -18,15 +18,6 @@ export const DETECTABLE_PAGES = {
 /**
  * Check whether a single file exists on disk (non-throwing).
  */
-async function fileExists(filePath) {
-    try {
-        await access(filePath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 /**
  * Detect which portal pages currently exist inside planu/.
  * Returns an array of page keys (e.g. ['proposal', 'executive-summary']).

package/dist/engine/doc-generator/portal/portal-regenerator.js

@@ -1,6 +1,7 @@
 // Planu — Portal regenerator: auto-regen pages when stores change (SPEC-146)
 import { mkdir, writeFile } 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 { hashProjectPath } from '../../../storage/base-store.js';
 import { getAffectedPages } from './dirty-flag-map.js';
 import { withAudit } from '../../../engine/autopilot/audit-logger.js';
@@ -71,6 +72,7 @@ export async function regeneratePages(projectPath, changedStores) {
 async function generatePage(projectPath, page) {
     const projectId = hashProjectPath(projectPath);
     try {
+        // eslint-disable-next-line no-restricted-syntax -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
         const { listSpecs } = await import('../../../storage/spec-store.js');
         const specs = await listSpecs(projectId);
         return await dispatchPageGenerator(projectPath, page, specs);

package/dist/engine/doc-generator/portal/risk-matrix-svg.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from '../../../core/shared/strings.js';
 const IMPACT_LEVELS = ['low', 'medium', 'high', 'very_high', 'critical'];
 const PROB_LEVELS = [20, 40, 60, 80, 100];
 const CATEGORY_COLORS = {
@@ -74,13 +75,6 @@ function circleSizeFromUsd(usd) {
     }
     return 24;
 }
-function escapeHtml(s) {
-    return s
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 function buildGridCells() {
     const cells = [];
     for (let row = 0; row < 5; row++) {

package/dist/engine/doc-generator/portal/risk-page.js

@@ -2,13 +2,7 @@ import { buildNavbar } from './portal-navbar.js';
 import { getPortalThemeCSS } from './portal-theme.js';
 import { buildRiskMatrixSvg } from './risk-matrix-svg.js';
 import { buildRiskGaugeSvg } from './risk-gauge-svg.js';
-function escapeHtml(s) {
-    return s
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
+import { escapeHtml } from '../../../core/shared/strings.js';
 const STATUS_BADGE = {
     identified: 'planu-badge-muted',
     mitigating: 'planu-badge-info',

package/dist/engine/doc-generator/portal/roadmap-page.js

@@ -1,6 +1,7 @@
 import { getPortalThemeCSS } from './portal-theme.js';
 import { buildNavbar } from './portal-navbar.js';
 import { buildGanttChart } from '../proposal/proposal-gantt-builder.js';
+import { escapeHtml } from '../../../core/shared/strings.js';
 /**
  * Generate the full roadmap.html page for the Planu portal.
  * Returns an HTML string ready to write to disk.
@@ -116,13 +117,6 @@ function buildMilestonesSection(specs) {
     return `<div class="milestone-timeline">${items.join('\n')}</div>`;
 }
 // --- Helpers ---
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 const ROADMAP_CSS = `
   .roadmap-main {
     max-width: 1100px;

package/dist/engine/doc-generator/proposal/proposal-gantt-builder.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from '../../../core/shared/strings.js';
 const PHASE_COLORS = [
     '#7c3aed',
     '#0891b2',
@@ -116,11 +117,4 @@ ${ganttRows.join('\n')}
 </div>`;
 }
 // Internal helper
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 //# sourceMappingURL=proposal-gantt-builder.js.map

package/dist/engine/doc-generator/proposal/proposal-kpi-builder.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from '../../../core/shared/strings.js';
 /**
  * Build a responsive KPI grid with large value + small label per card.
  * Uses CSS class `.kpi-grid` and `.kpi-card` from proposal-themes.ts.
@@ -22,11 +23,4 @@ export function buildKpiGrid(kpis) {
     return `<div class="kpi-grid">${cards}</div>`;
 }
 // Internal helper
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 //# sourceMappingURL=proposal-kpi-builder.js.map

package/dist/engine/doc-generator/proposal/proposal-section-builders-advanced.js

@@ -1,11 +1,5 @@
 import { t } from './proposal-i18n.js';
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
+import { escapeHtml } from '../../../core/shared/strings.js';
 function sectionTitle(icon, text) {
     return `<h2 class="section-title"><span class="icon">${icon}</span>${escapeHtml(text)}</h2>`;
 }
@@ -269,7 +263,7 @@ export function buildScorecardSection(items, title = 'Scorecard') {
   <span class="score-delta ${totalDelta > 0 ? 'delta-positive' : totalDelta < 0 ? 'delta-negative' : 'delta-neutral'}">${totalSign}${String(totalDelta)}</span>
 </div>`;
     return `<section>
-  ${sectionTitle('&#128200;', escapeHtml(title))}
+  ${sectionTitle('&#128200;', title)}
   <div class="kpi-grid">
     ${cards.join('\n    ')}
     ${totalCard}

package/dist/engine/doc-generator/proposal/proposal-section-builders.js

@@ -1,14 +1,8 @@
 import { buildGanttChart } from './proposal-gantt-builder.js';
 import { buildKpiGrid } from './proposal-kpi-builder.js';
 import { t } from './proposal-i18n.js';
+import { escapeHtml } from '../../../core/shared/strings.js';
 // ── Internal helpers ──────────────────────────────────────────────────────────
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 function sectionTitle(icon, text) {
     return `<h2 class="section-title"><span class="icon">${icon}</span>${escapeHtml(text)}</h2>`;
 }

package/dist/engine/docs-site-generator/html-templates.js

@@ -2,6 +2,7 @@
  * HTML templates for the static docs site generator.
  * Provides layout, CSS, navigation, and shared HTML utilities.
  */
+import { escapeHtml } from '../../core/shared/strings.js';
 // eslint-disable-next-line max-lines-per-function -- CSS template is inherently long
 export function getStyles() {
     return `
@@ -346,13 +347,6 @@ export function renderSearchScript() {
   });
 })();`;
 }
-function escapeHtml(text) {
-    return text
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 function escapeAttr(text) {
     return escapeHtml(text).replace(/'/g, '&#39;');
 }

package/dist/engine/docs-site-generator/markdown-renderer.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from '../../core/shared/strings.js';
 /**
  * Minimal markdown-to-HTML converter for spec rendering.
  * No external dependencies — pure regex-based transformation.
@@ -142,13 +143,6 @@ function renderInline(text) {
     result = result.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
     return result;
 }
-function escapeHtml(text) {
-    return text
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 function closeList(output, inList) {
     if (inList) {
         output.push('</ul>');

package/dist/engine/drift/violation-resolver.js

@@ -1,7 +1,9 @@
 // engine/drift/violation-resolver.ts — Semi-automatic drift violation resolution (SPEC-408)
 import { mkdir, access } 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 { specStore } from '../../storage/index.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { DriftCacheStore } from '../../storage/drift-cache-store.js';
 import { atomicWriteFile } from '../safety/atomic-write-file.js';
 // ---------------------------------------------------------------------------

package/dist/engine/dynamic-knowledge/knowledge-cache.js

@@ -4,6 +4,7 @@
 import { CATEGORY_TTL, } from '../../types/index.js';
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { dirname } from 'node:path';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { resolvedStorageArtifactPath } from '../../storage/storage-catalog.js';
 const MAX_ENTRIES = 200;
 const PRUNE_THRESHOLD_DAYS = 30;

package/dist/engine/ecosystem-absorber/knowledge-cache.js

@@ -1,6 +1,7 @@
 // engine/ecosystem-absorber/knowledge-cache.ts — Reads/writes ecosystem capability cache
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 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';
 const CACHE_VERSION = '1';
 const PRUNE_DAYS = 30;

package/dist/engine/edge-db-detector.js

@@ -1,19 +1,10 @@
 // engine/edge-db-detector.ts — SPEC-052
 // Detects edge-native SQLite usage: Turso (libSQL) and Cloudflare D1.
-import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { glob } from 'glob';
+import { readFileOrNull } from '../core/shared/fs.js';
 // === Source file glob ignore list ===
 const SOURCE_GLOB_IGNORE = ['node_modules/**', 'dist/**', 'build/**', '.git/**', 'coverage/**'];
-// === Helpers ===
-async function readFileOrNull(filePath) {
-    try {
-        return await readFile(filePath, 'utf-8');
-    }
-    catch {
-        return null;
-    }
-}
 async function readEdgeDbPackageDeps(projectPath) {
     const content = await readFileOrNull(join(projectPath, 'package.json'));
     if (!content) {

package/dist/engine/escalator/retry-counter.js

@@ -3,6 +3,7 @@
 import { join } from 'node:path';
 import { readFile } from 'node:fs/promises';
 import { atomicWriteFile } from '../safety/atomic-write-file.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { projectDataDir } from '../../storage/base-store.js';
 // ---------------------------------------------------------------------------
 // Constants