easyeda-mcp-pro 0.3.2 → 0.5.2

package/dist/export-manifest/errors.js

@@ -0,0 +1,69 @@
+/**
+ * Export manifest — error codes, structured issues, and factories.
+ *
+ * Follows the same pattern as `net-validation/errors.ts`:
+ * a const-object error code enum, a structured issue interface
+ * (re-exported from types.ts), and factory helpers.
+ *
+ * @module
+ */
+// ── Error codes ─────────────────────────────────────────────────────────────
+export const ExportManifestCode = {
+    // ── Completeness errors ────────────────────────────────────────────────
+    /** A required artifact file was not found in the export output. */
+    MISSING_REQUIRED_FILE: 'MISSING_REQUIRED_FILE',
+    /** An artifact file exists but has zero bytes. */
+    EMPTY_FILE: 'EMPTY_FILE',
+    /** An artifact is flagged as stale (outdated). */
+    STALE_FILE: 'STALE_FILE',
+    /** An artifact appears in the output but was not in the expected set. */
+    UNEXPECTED_FILE: 'UNEXPECTED_FILE',
+    // ── Integrity errors ───────────────────────────────────────────────────
+    /** Artifact checksum does not match the expected value. */
+    CHECKSUM_MISMATCH: 'CHECKSUM_MISMATCH',
+    /** Artifact's declared file type does not match its content/name. */
+    WRONG_FILE_TYPE: 'WRONG_FILE_TYPE',
+    // ── Metadata errors ────────────────────────────────────────────────────
+    /** Artifact is missing a human-readable purpose description. */
+    MISSING_PURPOSE: 'MISSING_PURPOSE',
+    /** Artifact is missing a generation timestamp. */
+    MISSING_GENERATED_TIMESTAMP: 'MISSING_GENERATED_TIMESTAMP',
+    /** Artifact is missing a source project reference. */
+    MISSING_SOURCE_PROJECT: 'MISSING_SOURCE_PROJECT',
+    // ── Schema errors ──────────────────────────────────────────────────────
+    /** Manifest version string is not valid semver. */
+    INVALID_MANIFEST_VERSION: 'INVALID_MANIFEST_VERSION',
+    // ── Internal ───────────────────────────────────────────────────────────
+    /** Validation could not be completed due to an internal error. */
+    MANIFEST_INTERNAL: 'MANIFEST_INTERNAL',
+};
+// ── Factory ─────────────────────────────────────────────────────────────────
+/**
+ * Create a single export manifest issue.
+ */
+export function manifestIssue(code, message, opts) {
+    return {
+        code,
+        message,
+        severity: opts?.severity ?? 'error',
+        path: opts?.path,
+        artifactPath: opts?.artifactPath,
+        artifactType: opts?.artifactType,
+        purpose: opts?.purpose,
+        remediationHint: opts?.remediationHint ?? '',
+        details: opts?.details,
+    };
+}
+/**
+ * Convenience: create an error-severity issue.
+ */
+export function manifestError(code, message, opts) {
+    return manifestIssue(code, message, { ...opts, severity: 'error' });
+}
+/**
+ * Convenience: create a warning-severity issue.
+ */
+export function manifestWarning(code, message, opts) {
+    return manifestIssue(code, message, { ...opts, severity: 'warning' });
+}
+//# sourceMappingURL=errors.js.map

package/dist/export-manifest/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/export-manifest/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,+EAA+E;AAE/E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,0EAA0E;IAE1E,mEAAmE;IACnE,qBAAqB,EAAE,uBAAuB;IAC9C,kDAAkD;IAClD,UAAU,EAAE,YAAY;IACxB,kDAAkD;IAClD,UAAU,EAAE,YAAY;IACxB,yEAAyE;IACzE,eAAe,EAAE,iBAAiB;IAElC,0EAA0E;IAE1E,2DAA2D;IAC3D,iBAAiB,EAAE,mBAAmB;IACtC,qEAAqE;IACrE,eAAe,EAAE,iBAAiB;IAElC,0EAA0E;IAE1E,gEAAgE;IAChE,eAAe,EAAE,iBAAiB;IAClC,kDAAkD;IAClD,2BAA2B,EAAE,6BAA6B;IAC1D,sDAAsD;IACtD,sBAAsB,EAAE,wBAAwB;IAEhD,0EAA0E;IAE1E,mDAAmD;IACnD,wBAAwB,EAAE,0BAA0B;IAEpD,0EAA0E;IAE1E,kEAAkE;IAClE,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAIX,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAwB,EACxB,OAAe,EACf,IAQC;IAED,OAAO;QACL,IAAI;QACJ,OAAO;QACP,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,OAAO;QACnC,IAAI,EAAE,IAAI,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI,EAAE,YAAY;QAChC,YAAY,EAAE,IAAI,EAAE,YAAY;QAChC,OAAO,EAAE,IAAI,EAAE,OAAO;QACtB,eAAe,EAAE,IAAI,EAAE,eAAe,IAAI,EAAE;QAC5C,OAAO,EAAE,IAAI,EAAE,OAAO;KACvB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAwB,EACxB,OAAe,EACf,IAA4D;IAE5D,OAAO,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAwB,EACxB,OAAe,EACf,IAA4D;IAE5D,OAAO,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/export-manifest/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Export manifest — public API barrel export.
+ *
+ * @module
+ */
+export { ArtifactType } from './types.js';
+export type { ExportManifestEntry, ExpectedArtifact, ExportManifestInput, ExportManifestIssue, ExportManifestSummary, ExportManifestReport, } from './types.js';
+export { ExportManifestCode, manifestIssue, manifestError, manifestWarning } from './errors.js';
+export type { ExportManifestCode as ExportManifestCodeType } from './errors.js';
+export { validateExportManifest } from './validation.js';

package/dist/export-manifest/index.js

@@ -0,0 +1,9 @@
+/**
+ * Export manifest — public API barrel export.
+ *
+ * @module
+ */
+export { ArtifactType } from './types.js';
+export { ExportManifestCode, manifestIssue, manifestError, manifestWarning } from './errors.js';
+export { validateExportManifest } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/export-manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/export-manifest/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAU1C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGhG,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/export-manifest/types.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Export manifest — types for export artifact manifests and validation.
+ *
+ * Defines the schema for export manifests — structural metadata files
+ * that describe what was exported (artifacts), when, and by which tool,
+ * and enable subsequent validation of completeness and integrity.
+ *
+ * @module
+ */
+/**
+ * Supported export artifact types.
+ *
+ * Maps to the file format enum used by EasyEDA Pro export tools and
+ * the golden fixture's `exportManifest.expectedFormats`.
+ */
+export declare enum ArtifactType {
+    /** Gerber RS-274X (fabrication layers). */
+    Gerber = "gerber",
+    /** NC drill file (Excellon). */
+    Drill = "drill",
+    /** Bill of materials (CSV). */
+    Bom = "bom",
+    /** Pick-and-place / centroid file (CSV). */
+    Pnp = "pnp",
+    /** PDF export (schematic, board, or both). */
+    Pdf = "pdf",
+    /** Netlist (PADS / Allegro / Altium format). */
+    Netlist = "netlist",
+    /** Electrical rules check report. */
+    ErcReport = "erc-report",
+    /** Design rules check report. */
+    DrcReport = "drc-report"
+}
+/**
+ * A single artifact entry in an export manifest.
+ *
+ * Each entry describes one file produced by an export operation, including
+ * its origin, integrity metadata, and required/optional classification.
+ */
+export interface ExportManifestEntry {
+    /** File name (e.g. "ESP32-S3-Board-F.Cu.gbr"). */
+    filename: string;
+    /** Relative path from the export root directory. */
+    relativePath?: string;
+    /** The type of exported file. */
+    fileType: ArtifactType;
+    /** Human-readable purpose (e.g. "Top copper layer"). */
+    purpose: string;
+    /** Source project identifier. */
+    sourceProject?: string;
+    /** Tool that generated this artifact (e.g. "easyeda-export-gerbers"). */
+    generatedByTool?: string;
+    /** ISO-8601 timestamp when this artifact was generated. */
+    timestamp?: string;
+    /** Hex-encoded SHA-256 or MD5 checksum. */
+    checksum?: string;
+    /** File size in bytes. */
+    fileSize?: number;
+    /** Whether this artifact is required for the export to be valid. */
+    required: boolean;
+    /** Whether this artifact is stale (outdated relative to source design). */
+    stale: boolean;
+}
+/**
+ * Expected artifact descriptor used to validate actual export output.
+ *
+ * Mirrors the golden fixture's `exportManifest.files[]` structure.
+ */
+export interface ExpectedArtifact {
+    /** Expected file name pattern. */
+    filename: string;
+    /** Expected file type. */
+    fileType: ArtifactType;
+    /** Minimum acceptable file size in bytes. */
+    minSizeBytes?: number;
+    /** Whether this artifact is required (missing = validation error). */
+    required?: boolean;
+}
+/**
+ * Complete input to export manifest validation.
+ *
+ * Carries both the actual exported artifacts and an optional set of
+ * expectations to compare against.
+ */
+export interface ExportManifestInput {
+    /** Manifest schema version (semver, e.g. "1.0.0"). */
+    version: string;
+    /** Source project identifier (EasyEDA project UUID). */
+    sourceProjectId: string;
+    /** Human-readable source project name. */
+    sourceProjectName?: string;
+    /** ISO-8601 timestamp of manifest generation. */
+    generatedAt: string;
+    /** Server / tool version that produced this manifest. */
+    serverVersion?: string;
+    /** EasyEDA / bridge metadata if available. */
+    bridgeMetadata?: Record<string, unknown>;
+    /** Artifacts produced by the export. */
+    artifacts: ExportManifestEntry[];
+    /** Expected artifacts for comparison-based validation. */
+    expectedArtifacts?: ExpectedArtifact[];
+}
+/**
+ * A single export manifest validation issue (error or warning).
+ *
+ * Mirrors the pattern from `net-validation/errors.ts` for consistency
+ * across validation modules.
+ */
+export interface ExportManifestIssue {
+    /** Machine-readable error code. */
+    code: string;
+    /** Human-readable description of what is wrong. */
+    message: string;
+    /** Whether this issue blocks validation or is advisory. */
+    severity: 'error' | 'warning';
+    /** Dot-notation path to the offending field (e.g. "artifacts[2]"). */
+    path?: string;
+    /** Related artifact path for file-level issues. */
+    artifactPath?: string;
+    /** Related artifact type for type-specific issues. */
+    artifactType?: string;
+    /** Related purpose field for purpose-related issues. */
+    purpose?: string;
+    /** Actionable hint for the user. */
+    remediationHint: string;
+    /** Additional machine-readable context. */
+    details?: Record<string, unknown>;
+}
+/**
+ * Validation summary breakdown.
+ */
+export interface ExportManifestSummary {
+    /** Total artifact count in the manifest. */
+    totalFiles: number;
+    /** Number of error-severity issues. */
+    errors: number;
+    /** Number of warning-severity issues. */
+    warnings: number;
+    /** Count of missing required files. */
+    missingRequired: number;
+    /** Count of empty files. */
+    emptyFiles: number;
+    /** Count of stale files. */
+    staleFiles: number;
+    /** Count of checksum mismatches. */
+    checksumMismatches: number;
+    /** Count of unexpected files (present but not expected). */
+    unexpectedFiles: number;
+    /** Count of wrong file type assignments. */
+    wrongFileTypes: number;
+    /** Count of artifacts missing a purpose description. */
+    missingPurposes: number;
+    /** Count of artifacts missing a generation timestamp. */
+    missingTimestamps: number;
+    /** Count of artifacts missing a source project reference. */
+    missingSourceProjects: number;
+}
+/**
+ * Complete export manifest validation report.
+ */
+export interface ExportManifestReport {
+    /** True when there are zero errors (warnings are allowed). */
+    valid: boolean;
+    /** The manifest that was validated (as provided). */
+    manifest: ExportManifestInput;
+    /** All issues found during validation. */
+    issues: ExportManifestIssue[];
+    /** Aggregated summary counts. */
+    summary: ExportManifestSummary;
+}

package/dist/export-manifest/types.js

@@ -0,0 +1,36 @@
+/**
+ * Export manifest — types for export artifact manifests and validation.
+ *
+ * Defines the schema for export manifests — structural metadata files
+ * that describe what was exported (artifacts), when, and by which tool,
+ * and enable subsequent validation of completeness and integrity.
+ *
+ * @module
+ */
+// ── Artifact type ───────────────────────────────────────────────────────────
+/**
+ * Supported export artifact types.
+ *
+ * Maps to the file format enum used by EasyEDA Pro export tools and
+ * the golden fixture's `exportManifest.expectedFormats`.
+ */
+export var ArtifactType;
+(function (ArtifactType) {
+    /** Gerber RS-274X (fabrication layers). */
+    ArtifactType["Gerber"] = "gerber";
+    /** NC drill file (Excellon). */
+    ArtifactType["Drill"] = "drill";
+    /** Bill of materials (CSV). */
+    ArtifactType["Bom"] = "bom";
+    /** Pick-and-place / centroid file (CSV). */
+    ArtifactType["Pnp"] = "pnp";
+    /** PDF export (schematic, board, or both). */
+    ArtifactType["Pdf"] = "pdf";
+    /** Netlist (PADS / Allegro / Altium format). */
+    ArtifactType["Netlist"] = "netlist";
+    /** Electrical rules check report. */
+    ArtifactType["ErcReport"] = "erc-report";
+    /** Design rules check report. */
+    ArtifactType["DrcReport"] = "drc-report";
+})(ArtifactType || (ArtifactType = {}));
+//# sourceMappingURL=types.js.map

package/dist/export-manifest/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/export-manifest/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAN,IAAY,YAiBX;AAjBD,WAAY,YAAY;IACtB,2CAA2C;IAC3C,iCAAiB,CAAA;IACjB,gCAAgC;IAChC,+BAAe,CAAA;IACf,+BAA+B;IAC/B,2BAAW,CAAA;IACX,4CAA4C;IAC5C,2BAAW,CAAA;IACX,8CAA8C;IAC9C,2BAAW,CAAA;IACX,gDAAgD;IAChD,mCAAmB,CAAA;IACnB,qCAAqC;IACrC,wCAAwB,CAAA;IACxB,iCAAiC;IACjC,wCAAwB,CAAA;AAC1B,CAAC,EAjBW,YAAY,KAAZ,YAAY,QAiBvB"}

package/dist/export-manifest/validation.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Export manifest — validation rules and entry point.
+ *
+ * Implements 10 validation rules that operate on {@link ExportManifestInput}
+ * and produce structured {@link ExportManifestIssue}s.
+ *
+ * Rules:
+ *  1. Invalid manifest version  — error if version is not valid semver
+ *  2. Missing source project    — error if sourceProjectId is empty
+ *  3. Missing generated timestamp — error if generatedAt is empty
+ *  4. Missing purpose           — warning for each artifact without purpose
+ *  5. Empty file                — error for each artifact with fileSize === 0
+ *  6. Stale file                — warning for each artifact flagged stale
+ *  7. Checksum mismatch         — error when expected checksum != actual
+ *  8. Missing required file     — error when expected artifact not found in output
+ *  9. Unexpected file           — warning when output file not in expected set
+ * 10. Wrong file type           — error when artifact type doesn't match expected
+ *
+ * @module
+ */
+import type { ExportManifestInput, ExportManifestReport } from './types.js';
+/**
+ * Run all export manifest validation rules against an input manifest.
+ *
+ * Orchestrates 10 rules:
+ *  1. Invalid manifest version   — error if version is not valid semver
+ *  2. Missing source project     — error if sourceProjectId is empty
+ *                                — warning per artifact without sourceProject
+ *  3. Missing generated timestamp— error if generatedAt is empty
+ *                                — warning per artifact without timestamp
+ *  4. Missing purpose            — warning per artifact without purpose
+ *  5. Empty file                 — error per artifact with fileSize === 0
+ *  6. Stale file                 — warning per artifact with stale === true
+ *  7. Checksum mismatch          — error when checksum "expected:actual" differs
+ *  8. Missing required file      — error when expected artifact not in output
+ *  9. Unexpected file            — warning when output file not in expected set
+ * 10. Wrong file type            — error when artifact type !== expected type
+ */
+export declare function validateExportManifest(input: ExportManifestInput): ExportManifestReport;

package/dist/export-manifest/validation.js

@@ -0,0 +1,298 @@
+/**
+ * Export manifest — validation rules and entry point.
+ *
+ * Implements 10 validation rules that operate on {@link ExportManifestInput}
+ * and produce structured {@link ExportManifestIssue}s.
+ *
+ * Rules:
+ *  1. Invalid manifest version  — error if version is not valid semver
+ *  2. Missing source project    — error if sourceProjectId is empty
+ *  3. Missing generated timestamp — error if generatedAt is empty
+ *  4. Missing purpose           — warning for each artifact without purpose
+ *  5. Empty file                — error for each artifact with fileSize === 0
+ *  6. Stale file                — warning for each artifact flagged stale
+ *  7. Checksum mismatch         — error when expected checksum != actual
+ *  8. Missing required file     — error when expected artifact not found in output
+ *  9. Unexpected file           — warning when output file not in expected set
+ * 10. Wrong file type           — error when artifact type doesn't match expected
+ *
+ * @module
+ */
+import { ExportManifestCode, manifestError, manifestWarning } from './errors.js';
+// ── Constants ───────────────────────────────────────────────────────────────
+/** Simple semver regex: major.minor.patch with optional pre-release. */
+const SEMVER_RE = /^\d+\.\d+\.\d+(?:-[a-zA-Z0-9.]+)?$/;
+// ── Rule: invalid manifest version ──────────────────────────────────────────
+function checkManifestVersion(input) {
+    const issues = [];
+    if (!input.version || !SEMVER_RE.test(input.version)) {
+        issues.push(manifestError(ExportManifestCode.INVALID_MANIFEST_VERSION, `Manifest version "${input.version ?? ''}" is not a valid semver string (expected e.g. "1.0.0")`, {
+            path: 'version',
+            remediationHint: 'Set the manifest version to a valid semver string like "1.0.0"',
+            details: { providedVersion: input.version },
+        }));
+    }
+    return issues;
+}
+// ── Rule: missing source project ────────────────────────────────────────────
+function checkSourceProject(input) {
+    const issues = [];
+    if (!input.sourceProjectId || input.sourceProjectId.trim().length === 0) {
+        issues.push(manifestError(ExportManifestCode.MISSING_SOURCE_PROJECT, 'Manifest is missing a source project identifier', {
+            path: 'sourceProjectId',
+            remediationHint: 'Set sourceProjectId to the EasyEDA project UUID that produced this export',
+        }));
+    }
+    // Check each artifact for source project
+    for (let i = 0; i < input.artifacts.length; i++) {
+        const artifact = input.artifacts[i];
+        if (!artifact.sourceProject || artifact.sourceProject.trim().length === 0) {
+            issues.push(manifestWarning(ExportManifestCode.MISSING_SOURCE_PROJECT, `Artifact "${artifact.filename}" is missing a source project reference`, {
+                path: `artifacts[${i}]`,
+                artifactPath: artifact.filename,
+                remediationHint: 'Set sourceProject on each artifact to trace it back to its origin project',
+            }));
+        }
+    }
+    return issues;
+}
+// ── Rule: missing generated timestamp ────────────────────────────────────────
+function checkGeneratedTimestamps(input) {
+    const issues = [];
+    // Check manifest-level timestamp
+    if (!input.generatedAt || input.generatedAt.trim().length === 0) {
+        issues.push(manifestError(ExportManifestCode.MISSING_GENERATED_TIMESTAMP, 'Manifest is missing a generation timestamp', {
+            path: 'generatedAt',
+            remediationHint: 'Set generatedAt to the ISO-8601 timestamp of manifest creation',
+        }));
+    }
+    // Check per-artifact timestamps
+    for (let i = 0; i < input.artifacts.length; i++) {
+        const artifact = input.artifacts[i];
+        if (!artifact.timestamp || artifact.timestamp.trim().length === 0) {
+            issues.push(manifestWarning(ExportManifestCode.MISSING_GENERATED_TIMESTAMP, `Artifact "${artifact.filename}" is missing a generation timestamp`, {
+                path: `artifacts[${i}]`,
+                artifactPath: artifact.filename,
+                remediationHint: 'Add an ISO-8601 timestamp to each artifact for staleness tracking',
+            }));
+        }
+    }
+    return issues;
+}
+// ── Rule: missing purpose ────────────────────────────────────────────────────
+function checkMissingPurposes(input) {
+    const issues = [];
+    for (let i = 0; i < input.artifacts.length; i++) {
+        const artifact = input.artifacts[i];
+        if (!artifact.purpose || artifact.purpose.trim().length === 0) {
+            issues.push(manifestWarning(ExportManifestCode.MISSING_PURPOSE, `Artifact "${artifact.filename}" is missing a purpose description`, {
+                path: `artifacts[${i}]`,
+                artifactPath: artifact.filename,
+                remediationHint: 'Add a brief purpose description (e.g. "Top copper layer", "Schematic PDF")',
+            }));
+        }
+    }
+    return issues;
+}
+// ── Rule: empty files ────────────────────────────────────────────────────────
+function checkEmptyFiles(input) {
+    const issues = [];
+    for (let i = 0; i < input.artifacts.length; i++) {
+        const artifact = input.artifacts[i];
+        if (artifact.fileSize !== undefined && artifact.fileSize === 0) {
+            issues.push(manifestError(ExportManifestCode.EMPTY_FILE, `Artifact "${artifact.filename}" is empty (0 bytes)`, {
+                path: `artifacts[${i}]`,
+                artifactPath: artifact.filename,
+                artifactType: artifact.fileType,
+                remediationHint: 'Re-export the artifact — the file may have been truncated or the export may have failed silently',
+                details: { fileSize: artifact.fileSize },
+            }));
+        }
+    }
+    return issues;
+}
+// ── Rule: stale files ────────────────────────────────────────────────────────
+function checkStaleFiles(input) {
+    const issues = [];
+    for (let i = 0; i < input.artifacts.length; i++) {
+        const artifact = input.artifacts[i];
+        if (artifact.stale) {
+            issues.push(manifestWarning(ExportManifestCode.STALE_FILE, `Artifact "${artifact.filename}" is stale and may not reflect the current design`, {
+                path: `artifacts[${i}]`,
+                artifactPath: artifact.filename,
+                artifactType: artifact.fileType,
+                remediationHint: 'Re-export this artifact to ensure it reflects the latest design changes',
+                details: { stale: true },
+            }));
+        }
+    }
+    return issues;
+}
+// ── Rule: checksum mismatch ─────────────────────────────────────────────────
+function checkChecksumMismatches(input) {
+    const issues = [];
+    for (let i = 0; i < input.artifacts.length; i++) {
+        const artifact = input.artifacts[i];
+        if (artifact.checksum !== undefined &&
+            artifact.checksum !== null &&
+            artifact.checksum.trim().length > 0 &&
+            artifact.checksum.includes(':') // format: "expected:actual" for comparison
+        ) {
+            const parts = artifact.checksum.split(':');
+            const expected = parts[0];
+            const actual = parts[1];
+            if (expected && actual && expected !== actual) {
+                issues.push(manifestError(ExportManifestCode.CHECKSUM_MISMATCH, `Checksum mismatch for "${artifact.filename}": expected ${expected}, got ${actual}`, {
+                    path: `artifacts[${i}]`,
+                    artifactPath: artifact.filename,
+                    remediationHint: 'Re-export the file or verify the source file integrity',
+                    details: {
+                        expectedChecksum: expected,
+                        actualChecksum: actual,
+                    },
+                }));
+            }
+        }
+    }
+    return issues;
+}
+// ── Rule: missing required files ────────────────────────────────────────────
+function checkMissingRequiredFiles(input) {
+    const issues = [];
+    if (!input.expectedArtifacts || input.expectedArtifacts.length === 0) {
+        return issues;
+    }
+    const exportedNames = new Set(input.artifacts.map((a) => a.filename));
+    for (let i = 0; i < input.expectedArtifacts.length; i++) {
+        const expected = input.expectedArtifacts[i];
+        const isRequired = expected.required ?? true; // default to required
+        if (isRequired && !exportedNames.has(expected.filename)) {
+            issues.push(manifestError(ExportManifestCode.MISSING_REQUIRED_FILE, `Required artifact "${expected.filename}" (${expected.fileType}) was not found in the export output`, {
+                path: `expectedArtifacts[${i}]`,
+                artifactType: expected.fileType,
+                remediationHint: 'Re-run the export to ensure all required files are generated',
+                details: {
+                    expectedFilename: expected.filename,
+                    expectedFileType: expected.fileType,
+                },
+            }));
+        }
+    }
+    return issues;
+}
+// ── Rule: unexpected files ──────────────────────────────────────────────────
+function checkUnexpectedFiles(input) {
+    const issues = [];
+    if (!input.expectedArtifacts || input.expectedArtifacts.length === 0) {
+        return issues;
+    }
+    const expectedNames = new Set(input.expectedArtifacts.map((a) => a.filename));
+    for (let i = 0; i < input.artifacts.length; i++) {
+        const artifact = input.artifacts[i];
+        if (!expectedNames.has(artifact.filename)) {
+            issues.push(manifestWarning(ExportManifestCode.UNEXPECTED_FILE, `Unexpected artifact "${artifact.filename}" was found but is not listed in expected artifacts`, {
+                path: `artifacts[${i}]`,
+                artifactPath: artifact.filename,
+                artifactType: artifact.fileType,
+                remediationHint: 'Either add this file to the expected artifact list or verify it is intentionally included',
+                details: { filename: artifact.filename },
+            }));
+        }
+    }
+    return issues;
+}
+// ── Rule: wrong file type ───────────────────────────────────────────────────
+function checkWrongFileTypes(input) {
+    const issues = [];
+    if (!input.expectedArtifacts || input.expectedArtifacts.length === 0) {
+        return issues;
+    }
+    // Build a map of expected file types by filename
+    const expectedTypeByFile = new Map();
+    for (const expected of input.expectedArtifacts) {
+        expectedTypeByFile.set(expected.filename, expected.fileType);
+    }
+    for (let i = 0; i < input.artifacts.length; i++) {
+        const artifact = input.artifacts[i];
+        const expectedType = expectedTypeByFile.get(artifact.filename);
+        if (expectedType && artifact.fileType !== expectedType) {
+            issues.push(manifestError(ExportManifestCode.WRONG_FILE_TYPE, `Artifact "${artifact.filename}" has type "${artifact.fileType}" but expected "${expectedType}"`, {
+                path: `artifacts[${i}]`,
+                artifactPath: artifact.filename,
+                artifactType: artifact.fileType,
+                remediationHint: 'Check the export configuration — the file may have been assigned the wrong format',
+                details: {
+                    actualType: artifact.fileType,
+                    expectedType,
+                },
+            }));
+        }
+    }
+    return issues;
+}
+const RULES = [
+    checkManifestVersion,
+    checkSourceProject,
+    checkGeneratedTimestamps,
+    checkMissingPurposes,
+    checkEmptyFiles,
+    checkStaleFiles,
+    checkChecksumMismatches,
+    checkMissingRequiredFiles,
+    checkUnexpectedFiles,
+    checkWrongFileTypes,
+];
+// ── Summary builder ─────────────────────────────────────────────────────────
+function buildSummary(issues, input) {
+    const errors = issues.filter((i) => i.severity === 'error').length;
+    const warnings = issues.filter((i) => i.severity === 'warning').length;
+    return {
+        totalFiles: input.artifacts.length,
+        errors,
+        warnings,
+        missingRequired: issues.filter((i) => i.code === ExportManifestCode.MISSING_REQUIRED_FILE)
+            .length,
+        emptyFiles: issues.filter((i) => i.code === ExportManifestCode.EMPTY_FILE).length,
+        staleFiles: issues.filter((i) => i.code === ExportManifestCode.STALE_FILE).length,
+        checksumMismatches: issues.filter((i) => i.code === ExportManifestCode.CHECKSUM_MISMATCH)
+            .length,
+        unexpectedFiles: issues.filter((i) => i.code === ExportManifestCode.UNEXPECTED_FILE).length,
+        wrongFileTypes: issues.filter((i) => i.code === ExportManifestCode.WRONG_FILE_TYPE).length,
+        missingPurposes: issues.filter((i) => i.code === ExportManifestCode.MISSING_PURPOSE).length,
+        missingTimestamps: issues.filter((i) => i.code === ExportManifestCode.MISSING_GENERATED_TIMESTAMP).length,
+        missingSourceProjects: issues.filter((i) => i.code === ExportManifestCode.MISSING_SOURCE_PROJECT).length,
+    };
+}
+// ── Main entry point ────────────────────────────────────────────────────────
+/**
+ * Run all export manifest validation rules against an input manifest.
+ *
+ * Orchestrates 10 rules:
+ *  1. Invalid manifest version   — error if version is not valid semver
+ *  2. Missing source project     — error if sourceProjectId is empty
+ *                                — warning per artifact without sourceProject
+ *  3. Missing generated timestamp— error if generatedAt is empty
+ *                                — warning per artifact without timestamp
+ *  4. Missing purpose            — warning per artifact without purpose
+ *  5. Empty file                 — error per artifact with fileSize === 0
+ *  6. Stale file                 — warning per artifact with stale === true
+ *  7. Checksum mismatch          — error when checksum "expected:actual" differs
+ *  8. Missing required file      — error when expected artifact not in output
+ *  9. Unexpected file            — warning when output file not in expected set
+ * 10. Wrong file type            — error when artifact type !== expected type
+ */
+export function validateExportManifest(input) {
+    const issues = [];
+    for (const rule of RULES) {
+        const ruleIssues = rule(input);
+        issues.push(...ruleIssues);
+    }
+    const errors = issues.filter((i) => i.severity === 'error').length;
+    return {
+        valid: errors === 0,
+        manifest: input,
+        issues,
+        summary: buildSummary(issues, input),
+    };
+}
+//# sourceMappingURL=validation.js.map