@planu/cli 5.3.67 → 5.3.69

package/dist/engine/spec-decomposer/analyzer.js

@@ -1,8 +1,8 @@
 // engine/spec-decomposer/analyzer.ts — Analyze spec content into work units (SPEC-157)
 // Reads spec.md acceptance criteria and technical.md file lists, then groups
 // criteria into independent work units suitable for parallel agent execution.
-import { readFile } from 'node:fs/promises';
 import { extractAcceptanceCriteria } from '../shared/ac-extractor.js';
+import { readFileSafe as safeReadFile } from '../../core/shared/fs.js';
 // ---------------------------------------------------------------------------
 // Criterion classification
 // ---------------------------------------------------------------------------
@@ -122,16 +122,6 @@ function categorize(criterion) {
 // ---------------------------------------------------------------------------
 // Public API
 // ---------------------------------------------------------------------------
-/** Read spec.md file and return its content, or empty string on error. */
-async function safeReadFile(filePath) {
-    try {
-        return await readFile(filePath, 'utf-8');
-        /* v8 ignore next 3 */
-    }
-    catch {
-        return '';
-    }
-}
 /**
  * Analyze spec content from disk and produce raw work units.
  * Groups acceptance criteria by category heuristics.

package/dist/engine/spec-dependency-graph/dot-exporter.d.ts

@@ -1,4 +1,4 @@
-import type { SpecGraph } from './graph-builder.js';
+import type { SpecGraph } from '../../types/spec-dependency-graph.js';
 /**
  * Export a SpecGraph as Graphviz DOT source.
  *

package/dist/engine/spec-dependency-graph/graph-builder.d.ts

@@ -1,24 +1,5 @@
 import type { Spec } from '../../types/index.js';
-export type EdgeKind = 'dependency' | 'supersedes' | 'depends_on';
-export interface GraphNode {
-    id: string;
-    status: string;
-    supersededBy?: string;
-}
-export interface GraphEdge {
-    from: string;
-    to: string;
-    kind: EdgeKind;
-}
-export interface SupersedesCycleDiagnostic {
-    code: 'SUPERSEDES_CYCLE';
-    cycle: string[];
-}
-export interface SpecGraph {
-    nodes: GraphNode[];
-    edges: GraphEdge[];
-    diagnostics: SupersedesCycleDiagnostic[];
-}
+import type { SpecGraph } from '../../types/spec-dependency-graph.js';
 /**
  * Build a full SpecGraph from an array of specs.
  * Ingests `supersedes`, `depends_on`, and legacy `dependencies` fields.

package/dist/engine/spec-dependency-graph/superseded-set.d.ts

@@ -1,4 +1,4 @@
-import type { SpecGraph } from './graph-builder.js';
+import type { SpecGraph } from '../../types/spec-dependency-graph.js';
 /**
  * Returns the set of spec IDs that appear as the target of a `supersedes` edge.
  * These are specs that have been intentionally replaced and should be excluded

package/dist/engine/spec-diff-engine.js

@@ -1,4 +1,5 @@
 // engine/spec-diff-engine.ts — SPEC-362: Visual Spec Diff & 3-way Merge
+import { escapeHtml } from '../core/shared/strings.js';
 // ---------------------------------------------------------------------------
 // LCS-based line diff
 // ---------------------------------------------------------------------------
@@ -151,13 +152,6 @@ export function computeVisualDiff(textA, textB, labelA = 'A', labelB = 'B') {
         htmlOutput,
     };
 }
-function escapeHtml(text) {
-    return text
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
 function buildHtmlDiff(diffLines, labelA, labelB) {
     const rows = diffLines
         .map((line) => {

package/dist/engine/spec-format/read-technical-section.js

@@ -5,6 +5,7 @@
 // single source of truth for "give me the technical body for this spec":
 // it extracts only the canonical inline `## Technical` section.
 import { readFile } from 'node:fs/promises';
+import { escapeRegex } from '../../core/shared/strings.js';
 /**
  * Read the `## Technical` section body from a spec's unified `spec.md`.
  * Returns "" when the spec file is unreadable or the section is missing.
@@ -95,7 +96,4 @@ function maskFencedBlocks(body) {
     }
     return masked.join('');
 }
-function escapeRegex(input) {
-    return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
 //# sourceMappingURL=read-technical-section.js.map

package/dist/engine/spec-format/replace-section.js

@@ -8,6 +8,7 @@
 // positive heading matches inside fenced code blocks.
 import { readFile } from 'node:fs/promises';
 import { atomicWriteFile } from '../safety/atomic-write-file.js';
+import { escapeRegex } from '../../core/shared/strings.js';
 /**
  * Replace the body of a top-level `## ${sectionName}` section in the given
  * spec.md file with `newBody`. If the section does not yet exist it is
@@ -75,7 +76,4 @@ export async function replaceSectionInSpec(specPath, sectionName, newBody) {
 function maskFencedBlocks(body) {
     return body.replace(/(```|~~~)[\s\S]*?\1/g, (block) => block.replace(/[^\n]/g, ' '));
 }
-function escapeRegex(input) {
-    return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
 //# sourceMappingURL=replace-section.js.map

package/dist/engine/spec-format/spec-id.d.ts

@@ -1,2 +1,10 @@
-export { generateSpecId } from '../../tools/create-spec-helpers.js';
+import { z } from 'zod';
+export declare const SPEC_ID_PATTERN: RegExp;
+export declare const SPEC_DIR_NAME_PATTERN: RegExp;
+export declare const SpecIdSchema: z.ZodString;
+export declare const SpecDirNameSchema: z.ZodString;
+export declare function isCanonicalSpecId(value: string): boolean;
+export declare function generateSpecId(existingSpecs: {
+    id: string;
+}[]): string;
 //# sourceMappingURL=spec-id.d.ts.map

package/dist/engine/spec-format/spec-id.js

@@ -1,4 +1,25 @@
-// engine/spec-format/spec-id.ts — Re-export generateSpecId for engine-layer consumers
-// Avoids architecture violation (engine importing from tools)
-export { generateSpecId } from '../../tools/create-spec-helpers.js';
+import { z } from 'zod';
+export const SPEC_ID_PATTERN = /^SPEC-\d+$/;
+export const SPEC_DIR_NAME_PATTERN = /^SPEC-\d+(?:-[a-z0-9]+(?:-[a-z0-9]+)*)?$/;
+export const SpecIdSchema = z
+    .string()
+    .min(1)
+    .max(50)
+    .regex(SPEC_ID_PATTERN, 'Spec ID must use canonical numeric format like SPEC-042.');
+export const SpecDirNameSchema = z
+    .string()
+    .min(1)
+    .max(200)
+    .regex(SPEC_DIR_NAME_PATTERN, 'Spec directory must start with a canonical numeric ID like SPEC-042 or SPEC-042-my-feature.');
+export function isCanonicalSpecId(value) {
+    return SPEC_ID_PATTERN.test(value);
+}
+export function generateSpecId(existingSpecs) {
+    const maxNum = existingSpecs.reduce((max, spec) => {
+        const match = /^SPEC-(\d+)$/.exec(spec.id);
+        const num = match?.[1] ? parseInt(match[1], 10) : 0;
+        return Math.max(max, num);
+    }, 0);
+    return `SPEC-${String(maxNum + 1).padStart(3, '0')}`;
+}
 //# sourceMappingURL=spec-id.js.map

package/dist/engine/spec-format/unified-spec-builder.js

@@ -3,6 +3,7 @@
 // two-file spec.md + technical.md pair only to be merged on the next list_specs run.
 import { stripFrontmatter } from '../frontmatter-parser.js';
 import { extractAcceptanceCriteriaTexts } from './acceptance-criteria.js';
+import { escapeRegex } from '../../core/shared/strings.js';
 const REQUIRED_SECTIONS = [
     'Problem',
     'Goal',
@@ -122,9 +123,6 @@ function demoteTopLevelHeadings(section) {
 function stripFencedCodeBlocks(body) {
     return body.replace(/```[\s\S]*?```/g, '').replace(/~~~[\s\S]*?~~~/g, '');
 }
-function escapeRegex(input) {
-    return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
 /**
  * Extract a top-level (`## `) section from a body, returning the heading line
  * plus its content up to the next top-level heading (or EOF). Returns null

package/dist/engine/spec-migrator/canonical-deduplicator.js

@@ -3,7 +3,9 @@ import { createHash } from 'node:crypto';
 import { mkdir as mkdirFs, readFile as readFileFs } from 'node:fs/promises';
 import { join, relative, resolve } from 'node:path';
 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';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { invalidateSpecsCache, validateCanonicalSpecRows, withCanonicalSpecRepairLock, } from '../../storage/spec-store.js';
 function digest(value) {
     return createHash('sha256').update(value).digest('hex');

package/dist/engine/spec-observability/tracker.js

@@ -1,5 +1,6 @@
 // engine/spec-observability/tracker.ts — SpecUsageTracker (SPEC-158)
 // Records spec access events fire-and-forget — zero latency impact on callers.
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { recordSpecAccess } from '../../storage/spec-observability-store.js';
 // ---------------------------------------------------------------------------
 // Spec ID extraction helpers

package/dist/engine/spec-registry/adapter.js

@@ -1,23 +1,15 @@
 import { technologyValue } from '../technology-registry.js';
+import { fileExists } from '../../core/shared/fs.js';
 /**
  * Stack detection and spec adaptation for registry specs.
  * Detects project technology stack from config files and applies
  * framework-specific substitutions to spec content.
  */
-import { readFile, access, writeFile } from 'node:fs/promises';
+import { readFile, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-async function fileExists(filePath) {
-    try {
-        await access(filePath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 /* v8 ignore start -- safe file readers, catch branches are defensive */
 async function readJsonSafe(filePath) {
     try {

package/dist/engine/spec-registry/validator.d.ts

@@ -8,4 +8,5 @@ export declare function validateForPublish(specDir: string): Promise<{
     valid: boolean;
     errors: string[];
 }>;
+/** Check if a file exists at the given path. */
 //# sourceMappingURL=validator.d.ts.map

package/dist/engine/spec-registry/validator.js

@@ -2,6 +2,7 @@
 // Validates a spec directory before publishing to the registry.
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
+import { fileExists } from '../../core/shared/fs.js';
 /** Maximum total size of all spec files combined (500 KB). */
 const MAX_TOTAL_SIZE = 500 * 1024;
 /** Semver regex (simplified: major.minor.patch with optional pre-release). */
@@ -132,13 +133,4 @@ async function validateTotalSize(specDir, errors) {
     }
 }
 /** Check if a file exists at the given path. */
-async function fileExists(filePath) {
-    try {
-        await fs.access(filePath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 //# sourceMappingURL=validator.js.map

package/dist/engine/spec-state-machine/transition-spec.js

@@ -1,6 +1,7 @@
 // engine/spec-state-machine/transition-spec.ts — SPEC-720
 // Single, authoritative store-side entry point for all status writes.
 // MUST only be called from src/tools/update-status/index.ts (enforced by ESLint).
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { specStore } from '../../storage/index.js';
 // ---------------------------------------------------------------------------
 // Core transition

package/dist/engine/spec-templates/custom-loader.js

@@ -4,6 +4,7 @@
 import { readdir, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { z } from 'zod';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { resolvedStorageArtifactPath } from '../../storage/storage-catalog.js';
 /** Zod schema for validating custom template JSON files. */
 const templateVariableSchema = z.object({

package/dist/engine/stack-auditor/build-tool-auditor.js

@@ -2,20 +2,12 @@
 // Detects build-tool anti-patterns in audit_stack.
 // C14: Webpack 4 EOL → high severity finding
 // C15: require() CJS in ESM-first project → high severity finding
-import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { glob } from 'glob';
+import { readFileSafe } from '../../core/shared/fs.js';
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-async function readFileSafe(filePath) {
-    try {
-        return await readFile(filePath, 'utf-8');
-    }
-    catch {
-        return '';
-    }
-}
 function parseVersionMajor(version) {
     if (!version) {
         return null;

package/dist/engine/staleness/stale-implementing.js

@@ -2,23 +2,13 @@
 //
 // Finds specs in 'implementing' status that have been there for >N days and have
 // no progress.md file. These are candidates for "done but untransitioned".
-import { access, readdir } from 'node:fs/promises';
+import { readdir } from 'node:fs/promises';
 import { join } from 'node:path';
-import { constants } from 'node:fs';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { hashProjectPath } from '../../storage/base-store.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { readTransitionLog } from '../../storage/transition-log.js';
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-async function fileExists(p) {
-    try {
-        await access(p, constants.F_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
+import { fileExists } from '../../core/shared/fs.js';
 async function getLastTransitionForSpec(projectId, specId) {
     const entries = await readTransitionLog(projectId, specId);
     let lastAt = null;
@@ -54,6 +44,7 @@ async function getDaysInImplementing(projectId, specId) {
 export async function findStaleImplementing(params) {
     const { projectPath, daysThreshold = 7 } = params;
     const projectId = hashProjectPath(projectPath);
+    // eslint-disable-next-line no-restricted-syntax -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
     const { specStore } = await import('../../storage/index.js').catch(() => ({ specStore: null }));
     if (!specStore) {
         return [];

package/dist/engine/status-reconciler/index.js

@@ -133,8 +133,11 @@ export async function reconcileStatusFromDisk(projectPath, projectId) {
     }
     // Log to autopilot for observability (best-effort)
     try {
+        // eslint-disable-next-line no-restricted-syntax -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
         const { appendAutopilotLogEntry } = await import('../../storage/autopilot-log-store.js');
-        const resolvedProjectId = projectId ?? (await import('../../storage/base-store.js')).hashProjectPath(projectPath);
+        const resolvedProjectId = 
+        // eslint-disable-next-line no-restricted-syntax -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
+        projectId ?? (await import('../../storage/base-store.js')).hashProjectPath(projectPath);
         await appendAutopilotLogEntry(resolvedProjectId, {
             specId: 'system',
             hookName: 'status_json_reconcile',

package/dist/engine/structural-memory/helpers.js

@@ -1,4 +1,5 @@
 import { isAbsolute, normalize, relative, resolve } 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 { getProjectGraphFreshness, loadProjectGraphPolicy, readProjectGraph, } from '../project-graph/cache.js';
 export function resolveProjectId(input) {

package/dist/engine/supply-chain/slsa-checker.js

@@ -5,6 +5,7 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { glob } from 'glob';
+import { readFileSafe } from '../../core/shared/fs.js';
 // SLSA GitHub Generator workflow action
 const SLSA_GENERATOR_ACTION = 'slsa-framework/slsa-github-generator';
 // Actions/tools that provide SLSA L2 provenance
@@ -23,15 +24,6 @@ const SLSA_REFS = [
 // Both formats are valid; v1 is preferred for new setups.
 const SLSA_PROVENANCE_V1_FORMAT = 'slsa.dev/provenance/v1';
 const SLSA_PROVENANCE_V02_FORMAT = 'slsa.dev/provenance/v0.2';
-/** Read a file and return its content, or empty string on error. */
-async function readFileSafe(filePath) {
-    try {
-        return await readFile(filePath, 'utf-8');
-    }
-    catch {
-        return '';
-    }
-}
 /** Find all GitHub Actions workflow files. */
 async function findWorkflowFiles(projectPath) {
     try {

package/dist/engine/tdd-enforcer/stub-artifact-path.js

@@ -1,4 +1,5 @@
 import { join } 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';
 export function resolveTddStubArtifactPath(specId, projectPath) {
     const projectId = hashProjectPath(projectPath);

package/dist/engine/telemetry/health-checker.js

@@ -4,6 +4,7 @@ import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { isTelemetryEnabled } from './telemetry-store.js';
 import { sendTelemetryEvent } from './telemetry-client.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 { networkFetch, withNetworkConsent } from '../network-policy.js';
 const NETWORK_TIMEOUT_MS = 5_000;

package/dist/engine/telemetry/telemetry-store.js

@@ -3,6 +3,7 @@
 // Stores opt-in preference and installation ID outside the project directory.
 import { readFile, writeFile, mkdir } 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';
 const PLANU_DIR = resolveStorageLayout().config;
 const TELEMETRY_FILE = join(PLANU_DIR, 'telemetry.json');

package/dist/engine/token-optimizer/response-cache.js

@@ -1,15 +1,13 @@
 // engine/token-optimizer/response-cache.ts — LRU cache with content-hash keys (SPEC-082 AC-02, AC-10)
 import { createHash } from 'node:crypto';
 import { countTokens } from './counter.js';
+import { escapeRegex } from '../../core/shared/strings.js';
 const DEFAULT_CACHE_CONFIG = {
     defaultTtlMs: 5 * 60 * 1000, // 5 minutes
     maxEntries: 100,
     maxPersistentSizeMb: 5,
     persistMinTtlMs: 60 * 60 * 1000, // 1 hour
 };
-function escapeRegex(input) {
-    return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
 /**
  * In-memory LRU response cache with content-hash keys and TTL support.
  */

package/dist/engine/tool-groups/group-manager.js

@@ -1,5 +1,7 @@
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { readJson, writeJson } from '../../storage/base-store.js';
 import toolGroupsConfigJson from '../../config/tool-groups.json' with { type: 'json' };
+// 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 toolGroupsConfig = toolGroupsConfigJson;
 export class GroupManager {

package/dist/engine/update-notifier.js

@@ -5,6 +5,7 @@ import { get } from 'node:https';
 import { readFileSync, writeFileSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { PLANU_VERSION } from '../config/version.js';
+// 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 { assertNetworkAllowed } from './network-policy.js';
 const NPM_REGISTRY_URL = 'https://registry.npmjs.org/@planu%2Fcli/latest';

package/dist/engine/validation/approved-spec-portability.js

@@ -1,6 +1,7 @@
 import { access, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 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';
 import { PROJECT_ID as CANONICAL_PROJECT_ID } from './validation-receipt-codec.js';
 import { parseGroundedTechnicalPaths } from '../spec-grounding/contract.js';

package/dist/engine/validation/durable-validation.js

@@ -3,6 +3,7 @@ import { createHash } from 'node:crypto';
 import { readFile } from 'node:fs/promises';
 import { basename, join } from 'node:path';
 import { runAbortableProcess } from '../abortable-process-runner.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';
 import { atomicWriteFile } from '../safety/atomic-write-file.js';
 import { evidenceArtifactCollectionDigest, evidenceArtifactDigest, } from '../evidence-gates/artifact-reader.js';

package/dist/engine/validation/validation-freshness.js

@@ -55,7 +55,9 @@ import { createHash, randomUUID } from 'node:crypto';
 import { constants, watch } from 'node:fs';
 import { lstat, mkdir, open, readdir } from 'node:fs/promises';
 import { basename, join } from 'node:path';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { RuntimeDatabase } from '../../storage/runtime-db.js';
+// 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 { ValidationReceiptStore } from './validation-receipt.js';
 import { isValidationSourcePath } from './validation-source-policy.js';

package/dist/engine/validation/validation-receipt.js

@@ -3,6 +3,7 @@ import { chmod, mkdir, open, readFile, rename, unlink } from 'node:fs/promises';
 import { join } from 'node:path';
 import { TextDecoder } from 'node:util';
 import { reportClassifiedDegradation } from '../../errors/classified-degradation.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { resolvedStorageArtifactPath, } from '../../storage/storage-catalog.js';
 import { formatSecretReference, getSecretProvider, parseSecretReference, SecretProviderError, } from '../../security/secret-provider.js';
 import { redactText } from '../../security/redactor.js';

package/dist/engine/validation/validation-submission.d.ts

@@ -1,5 +1,5 @@
 import type { DurableJobRuntime } from '../execution/job-runtime.js';
-import type { DurableJobRecord } from '../../storage/runtime-db.js';
+import type { DurableJobRecord } from '../../types/durable-job.js';
 import type { DurableValidationBindings } from '../../types/durable-validation.js';
 import type { ValidationArtifactDigests, ValidationFreshnessLease } from '../../types/validation-receipt.js';
 /** Stable identity for exactly one immutable validation input tuple. */

package/dist/engine/validation-evidence-ledger.js

@@ -1,6 +1,7 @@
 import { createHash, randomUUID } from 'node:crypto';
 import { existsSync, lstatSync, mkdirSync, linkSync, appendFileSync, readFileSync, unlinkSync, 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 { projectDataDir } from '../storage/base-store.js';
 import { VALIDATION_EVIDENCE_SCHEMA_VERSION, } from '../types/validation-evidence.js';
 import { digestValidationPaths, resolveValidationToolchain } from './validation-evidence-digest.js';

package/dist/engine/validator/deep-code-checker.js

@@ -3,10 +3,8 @@
 import { readFile, stat } from 'node:fs/promises';
 import { join } from 'node:path';
 import { glob } from 'glob';
+import { escapeRegex } from '../../core/shared/strings.js';
 const DEFAULT_IGNORE = ['node_modules/**', 'dist/**', 'build/**', '.git/**', 'coverage/**'];
-function escapeRegex(input) {
-    return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
 // ─── Numeric literal normalization (SPEC-1367) ───────────────────────────────
 // Grounds criteria whose THEN names an explicit numeric timeout (e.g. "45_000")
 // against test files that may spell the same literal without underscores (or

package/dist/engine/validator/executable-evidence.d.ts

@@ -1,17 +1,4 @@
-export interface EvidenceTestLink {
-    path: string;
-}
-export interface EvidenceScenario {
-    title: string;
-    tests: EvidenceTestLink[];
-}
-export type ExecutableEvidenceSource = 'frontmatter' | 'criteria' | 'none';
-export interface ExecutableEvidence {
-    source: ExecutableEvidenceSource;
-    scenarios: EvidenceScenario[];
-    unmappedCriteria: string[];
-    ignoredCriteriaTitles: string[];
-}
+import type { ExecutableEvidence } from '../../types/validation-evidence.js';
 /**
  * Single evidence normalizer shared by spec-compliance-runner.ts and
  * readiness-checker.ts (SPEC-1214). Frontmatter `scenarios` stay canonical when

package/dist/engine/validator/scope-resolver.d.ts

@@ -1,9 +1,9 @@
 import type { Spec } from '../../types/spec/core.js';
 export type Dimension = 'tests' | 'lint' | 'typecheck' | 'security-scan' | 'spec-compliance';
-export type SkipReason = 'doc-only-scope' | 'meta-target' | 'no-source-files' | 'spec-config';
+export type ScopeSkipReason = 'doc-only-scope' | 'meta-target' | 'no-source-files' | 'spec-config';
 export interface SkippedDimension {
     dimension: Dimension;
-    reason: SkipReason;
+    reason: ScopeSkipReason;
 }
 export interface ResolvedDimensions {
     applicable: Dimension[];

package/dist/engine/validator/spec-compliance-runner.d.ts

@@ -1,35 +1,5 @@
 import type { Spec } from '../../types/index.js';
-export type ScenarioVerdict = 'pass' | 'fail' | 'missing';
-export interface ScenarioTestLink {
-    path: string;
-    line?: number;
-    runner?: string;
-    config?: string;
-    description?: string;
-}
-export interface ScenarioStep {
-    keyword: string;
-    text: string;
-}
-export interface FrontmatterScenario {
-    title: string;
-    done: boolean;
-    tests?: ScenarioTestLink[];
-    steps?: ScenarioStep[];
-}
-export interface PerScenarioResult {
-    title: string;
-    verdict: ScenarioVerdict;
-    evidence: string[];
-    unverifiable?: true;
-}
-export interface SpecComplianceResult {
-    dimensionScore: number;
-    perScenario: PerScenarioResult[];
-    command: string;
-    evidenceSource?: 'frontmatter' | 'criteria' | 'none';
-    ignoredCriteriaTitles?: string[];
-}
+import type { FrontmatterScenario, SpecComplianceResult } from '../../types/validation-evidence.js';
 /** A sanitized terminal adapter failure that cannot be mistaken for a failed test verdict. */
 export declare class ComplianceCommandTerminalError extends Error {
     readonly code: string;

package/dist/engine/validator/validation-report-writer.js

@@ -1,5 +1,5 @@
 import { appendArtifact, readArtifact } from '../handoff-artifacts/io.js';
-import { runSpecCompliance, } from './spec-compliance-runner.js';
+import { runSpecCompliance } from './spec-compliance-runner.js';
 export const AUTOMATED_VALIDATOR_AGENT = 'planu-automated-validator';
 export async function writeImplementationReviewReport(input) {
     const specCompliance = await runSpecCompliance(input.spec, input.projectPath, input.signal, input.projectId);

package/dist/engine/validator.d.ts

@@ -2,7 +2,7 @@ import type { Spec, ValidateResult, DriftReport } from '../types/index.js';
 export { generateDoR, generateDoD } from './validator/dor-dod.js';
 export { generateChecklist } from './validator/checklist.js';
 export { resolveApplicableDimensions, normaliseScore } from './validator/scope-resolver.js';
-export type { Dimension, SkipReason, SkippedDimension, ResolvedDimensions, } from './validator/scope-resolver.js';
+export type { Dimension, ScopeSkipReason, SkippedDimension, ResolvedDimensions, } from './validator/scope-resolver.js';
 export { buildHolisticReportFromFlatScore } from './validator/holistic-report.js';
 export type { HolisticValidateReport } from '../types/analysis.js';
 /**

package/dist/engine/validator.js

@@ -9,6 +9,7 @@ import { resolveApplicableDimensions } from './validator/scope-resolver.js';
 import { buildHolisticReportFromFlatScore } from './validator/holistic-report.js';
 import { readEvidenceArtifacts, traceabilityRowHasCurrentCommandEvidence, traceabilityRowHasCurrentTestEvidence, } from './evidence-gates/artifact-reader.js';
 import { createCriterionIdentity, hasExplicitCriterionId, normalizeCriterionText, } from './criterion-identity.js';
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { hashProjectPath } from '../storage/base-store.js';
 // Re-export the full public API so external callers never need to know
 // about the sub-module layout.

package/dist/engine/velocity/measure-velocity.js

@@ -1,6 +1,8 @@
 // engine/velocity/measure-velocity.ts — Compute VelocityProfile from real project actuals (SPEC-555)
 // Pure async function: reads specs from storage, computes calibrated day estimates.
+// eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1661 SPEC-1662 SPEC-1663
 import { hashProjectPath } from '../../storage/index.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';
 // ---------------------------------------------------------------------------
 // Default profile used when insufficient data is available