@tracepass/dpp-validate 0.1.0

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * Evaluate a Digital Product Passport against its category field-spec.
+ *
+ * `evaluateCompliance` takes a passport and its template as plain objects and
+ * returns a three-tier verdict with regulation-cited findings. It reads no
+ * database and makes no network calls.
+ */
+export { evaluateCompliance } from "./verdict.js";
+export { isEuEeaCountry } from "./eu-countries.js";
+export { CONDITIONAL_RULES, CROSS_CUTTING_RULES, } from "./rules.js";
+export { IN_SCOPE_BATTERY_CATEGORIES, BATTERY_FIELD_GATES, GATED_FIELD_KEYS, batteryFieldApplicability, gateForKey, } from "./battery-applicability.js";
+// Re-exported because a passport's publish-readiness and required economic
+// operators are part of judging whether it is compliant, not separate concerns.
+export { checkPublishReady } from "./vendor/publish-gate.js";
+export { getPartyRoles, isRequiredRole, allRolesForCategory, CATEGORY_PARTY_ROLES } from "./vendor/required-roles.js";
+export { derivePassportCounts } from "./vendor/counts.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAWlD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,EACzB,UAAU,GACX,MAAM,4BAA4B,CAAC;AAGpC,2EAA2E;AAC3E,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEtH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/rules.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Per-category CONDITIONAL compliance rules.
+ *
+ * These encode the conditional obligations that are binding and in force.
+ * Three categories carry them — battery, chemicals, construction — plus one
+ * cross-cutting rule (CC-1) that applies to every category. The remaining
+ * categories have no rule entry here, so the engine reports them
+ * `static-only`: their template's required fields are the whole obligation.
+ *
+ * Rules live in TypeScript rather than a JSON DSL in the templates.
+ * Regulatory logic stays in code, reviewed in pull requests, and is
+ * deliberately not drift-able by editing a template. Each rule cites its
+ * article so the verdict can show provenance.
+ *
+ * A rule returns findings. `unverifiable_conditional` (warning) is
+ * emitted when a rule's TRIGGER field is absent — we never silently
+ * skip a mandatory conditional, and never assert compliance on data we
+ * couldn't read.
+ *
+ * Tier discipline: `critical` is reserved for binding, in-force obligations
+ * traced to a primary source. A draft or not-yet-dated obligation is a
+ * `warning`, never a blocker.
+ */
+import type { Passport, Template } from "@tracepass/dpp-types";
+import type { ComplianceFinding } from "./types.js";
+/** A conditional rule: given passport+template, produce zero or more findings. */
+export interface ConditionalRule {
+    id: string;
+    run(passport: Passport, template: Template): ComplianceFinding[];
+}
+/**
+ * Conditional-rule registry. Categories ABSENT from this map have no
+ * binding conditionals in force → the engine reports them `static-only`.
+ * CC-1 runs for every category and is composed in by the engine, so it
+ * is NOT listed per-category here.
+ */
+export declare const CONDITIONAL_RULES: Record<string, ConditionalRule[]>;
+/** The cross-cutting rule the engine runs for every category. */
+export declare const CROSS_CUTTING_RULES: ConditionalRule[];
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAapD,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,iBAAiB,EAAE,CAAC;CAClE;AAwVD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAI/D,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,EAAE,eAAe,EAAU,CAAC"}

package/dist/rules.js

@@ -0,0 +1,376 @@
+/**
+ * Per-category CONDITIONAL compliance rules.
+ *
+ * These encode the conditional obligations that are binding and in force.
+ * Three categories carry them — battery, chemicals, construction — plus one
+ * cross-cutting rule (CC-1) that applies to every category. The remaining
+ * categories have no rule entry here, so the engine reports them
+ * `static-only`: their template's required fields are the whole obligation.
+ *
+ * Rules live in TypeScript rather than a JSON DSL in the templates.
+ * Regulatory logic stays in code, reviewed in pull requests, and is
+ * deliberately not drift-able by editing a template. Each rule cites its
+ * article so the verdict can show provenance.
+ *
+ * A rule returns findings. `unverifiable_conditional` (warning) is
+ * emitted when a rule's TRIGGER field is absent — we never silently
+ * skip a mandatory conditional, and never assert compliance on data we
+ * couldn't read.
+ *
+ * Tier discipline: `critical` is reserved for binding, in-force obligations
+ * traced to a primary source. A draft or not-yet-dated obligation is a
+ * `warning`, never a blocker.
+ */
+import { isEuEeaCountry } from "./eu-countries.js";
+import { BATTERY_FIELD_GATES, batteryFieldApplicability } from "./battery-applicability.js";
+/** A field counts as "present" when it exists with a non-empty value. */
+function hasValue(passport, key) {
+    const f = passport.fields[key];
+    return !!f && f.value !== null && f.value !== undefined && f.value !== "";
+}
+/** Read a field's raw value (or undefined when absent/empty). */
+function valueOf(passport, key) {
+    return hasValue(passport, key) ? passport.fields[key].value : undefined;
+}
+// ── CC-1 · cross-cutting EU economic-operator rule ──────────────────
+// Reg (EU) 2019/1020 Art. 4(1)+(2): a product may be placed on the
+// market only if there is an EU-established operator. When the
+// manufacturer is non-EU, that operator must be one of importer / AR /
+// fulfilment service provider. This is GROUPED (any one satisfies) —
+// NOT "AR required". We have no fulfilmentServiceProvider role, so the
+// satisfying set is {importer, authorisedRepresentative}; if neither is
+// present we warn (not critical) and point at the FSP escape hatch, to
+// avoid a false-positive on a legitimately FSP-only arrangement.
+const CC1 = {
+    id: "CC-1",
+    run(passport) {
+        const mfr = passport.parties?.manufacturer;
+        // Trigger field absent → can't evaluate. Warn, don't assert.
+        if (!mfr || !mfr.country) {
+            return [
+                {
+                    type: "unverifiable_conditional",
+                    severity: "warning",
+                    target: "manufacturer.country",
+                    regulation: "(EU) 2019/1020",
+                    article: "Art. 4",
+                    ruleId: "CC-1",
+                    why: "Manufacturer country is not set, so the EU economic-operator requirement couldn't be evaluated.",
+                    fix: "Set the manufacturer party's country so compliance with Art. 4 can be confirmed.",
+                },
+            ];
+        }
+        if (isEuEeaCountry(mfr.country))
+            return []; // EU/EEA manufacturer satisfies Art. 4 directly.
+        const satisfied = !!passport.parties?.importer || !!passport.parties?.authorisedRepresentative;
+        if (satisfied)
+            return [];
+        return [
+            {
+                type: "conditional_missing",
+                severity: "warning",
+                target: "importer|authorisedRepresentative",
+                regulation: "(EU) 2019/1020",
+                article: "Art. 4(1)(2)",
+                ruleId: "CC-1",
+                why: `Manufacturer is established outside the EU/EEA (${mfr.country}); EU placing on market requires an EU-established operator.`,
+                fix: "Add an importer OR an authorised representative (or record a fulfilment service provider) established in the EU.",
+            },
+        ];
+    },
+};
+// ── Battery · Reg (EU) 2023/1542 ────────────────────────────────────
+// BAT-1: battery passport required IF category ∈ {LMT, EV, industrial>2kWh}.
+// The template's `batteryCategory` enum already encodes the scope split
+// (LMT, EV, industrial_gt_2kwh vs industrial_lte_2kwh, SLI, portable),
+// so the ">2 kWh" line is an enum check, not kWh math.
+const IN_SCOPE_BATTERY = new Set(["LMT", "EV", "industrial_gt_2kwh"]);
+// Fields the passport must carry once it's an in-scope battery. Kept tight —
+// only the identifiers Art. 77 hangs the passport on; broader field
+// completeness is the static tier's job.
+const BATTERY_PASSPORT_FIELDS = ["batteryUniqueIdentifier"];
+const BAT1 = {
+    id: "BAT-1",
+    run(passport) {
+        const cat = valueOf(passport, "batteryCategory");
+        if (cat === undefined) {
+            return [
+                {
+                    type: "unverifiable_conditional",
+                    severity: "warning",
+                    target: "batteryCategory",
+                    regulation: "(EU) 2023/1542",
+                    article: "Art. 77(1)",
+                    ruleId: "BAT-1",
+                    why: "Battery category isn't set, so battery-passport scope (LMT / EV / industrial >2 kWh) couldn't be evaluated.",
+                    fix: "Set batteryCategory. Portable and SLI batteries are out of scope; LMT, EV and industrial >2 kWh require a battery passport.",
+                },
+            ];
+        }
+        // Out-of-scope categories (portable, SLI, industrial_lte_2kwh) → no obligation.
+        if (!IN_SCOPE_BATTERY.has(String(cat)))
+            return [];
+        const findings = [];
+        for (const key of BATTERY_PASSPORT_FIELDS) {
+            if (!hasValue(passport, key)) {
+                findings.push({
+                    type: "conditional_missing",
+                    severity: "critical",
+                    target: key,
+                    regulation: "(EU) 2023/1542",
+                    article: "Art. 77",
+                    ruleId: "BAT-1",
+                    why: `This is an in-scope battery (${String(cat)}); a battery passport with its unique identifier is mandatory.`,
+                    fix: `Provide ${key} — the battery passport's unique identifier (GS1 Digital Link).`,
+                });
+            }
+        }
+        return findings;
+    },
+};
+// ── Battery · field-applicability (deck 27 May 2026, slide 36) ──────
+// BAT-APP: not every Annex XIII field applies to every battery. The
+// shared predicate (battery-applicability.ts) decides per field from
+// batteryCategory + the batteryProfile classifiers. This rule turns that
+// into findings WITHOUT ever blocking:
+//   - a field that's `not_applicable` but FILLED → warning (likely
+//     mis-entered or the battery is mis-classified). Never critical —
+//     extra data isn't a compliance failure, just a flag.
+//   - a gate whose trigger is absent (`unknown`) AND the dependent field
+//     is filled → unverifiable_conditional warning (can't confirm the
+//     field belongs; ask for the missing classifier).
+// We deliberately do NOT emit "missing applicable field" here — required-
+// field completeness is the static tier's job; this rule is purely about
+// applicability, so it stays additive and can't double-count.
+const BAT_APP = {
+    id: "BAT-APP",
+    run(passport) {
+        const findings = [];
+        // Reuse the shared predicate so the verdict + editor read applicability
+        // through ONE path (incl. the "pending AI flag = unknown" safety rule).
+        const applicability = batteryFieldApplicability(passport, "battery");
+        for (const gate of BATTERY_FIELD_GATES) {
+            // Every key in a gate shares the gate's verdict; sample the first.
+            const verdict = applicability[gate.keys[0]];
+            if (verdict === "applies")
+                continue;
+            for (const key of gate.keys) {
+                const filled = hasValue(passport, key);
+                if (verdict === "not_applicable" && filled) {
+                    findings.push({
+                        type: "invalid_format",
+                        severity: "warning",
+                        target: key,
+                        regulation: "(EU) 2023/1542",
+                        article: gate.article,
+                        ruleId: "BAT-APP",
+                        why: `${key} is filled but doesn't apply to this battery — ${gate.reason}`,
+                        fix: `Remove ${key}, or correct the battery classification (batteryCategory / battery profile) if this field should apply.`,
+                    });
+                }
+                else if (verdict === "unknown" && filled) {
+                    findings.push({
+                        type: "unverifiable_conditional",
+                        severity: "warning",
+                        target: key,
+                        regulation: "(EU) 2023/1542",
+                        article: gate.article,
+                        ruleId: "BAT-APP",
+                        why: `${key} is filled, but whether it applies couldn't be confirmed — ${gate.reason}`,
+                        fix: "Set the battery classification (has-BMS / rechargeable / external-storage) so applicability can be confirmed.",
+                    });
+                }
+            }
+        }
+        return findings;
+    },
+};
+// ── Battery · value validation (not just presence) ──────────────────
+// BAT-VAL: the static tier + BAT-1 check fields are PRESENT; this rule
+// checks the values that ARE present are PLAUSIBLE. All warnings, never
+// blocking — a malformed value is a data-quality flag for the reviewer,
+// not a hard compliance failure (the reviewer owns the value per the
+// "AI suggests, human approves" product stance). Two kinds of check:
+//   (1) numeric-range: percentages must be 0–100; carbon footprints ≥ 0.
+//   (2) correlated-requirement: a recorded hazardous substance engages
+//       the REACH/SCIP notification obligation, so scipNotificationNumber
+//       should be present.
+// Absent fields are skipped here (presence is BAT-1 / the static tier's
+// job) so this rule stays additive and can't double-count.
+/** Parse a field value as a finite number, or undefined if not numeric. */
+function numberOf(passport, key) {
+    if (!hasValue(passport, key))
+        return undefined;
+    const raw = passport.fields[key].value;
+    const n = typeof raw === "number" ? raw : Number(raw);
+    return Number.isFinite(n) ? n : undefined;
+}
+// Percentage fields that must sit within 0–100 when present.
+const BATTERY_PERCENT_FIELDS = [
+    "recycledContentCobalt",
+    "recycledContentLithium",
+    "recycledContentNickel",
+    "recycledContentLead",
+    "stateOfHealth",
+    "stateOfCertifiedEnergy",
+];
+// Carbon-footprint fields that must be ≥ 0 when present (kg CO2e/kWh).
+const BATTERY_NONNEGATIVE_FIELDS = [
+    "carbonFootprintTotal",
+    "cfRawMaterialAcquisition",
+    "cfMainProductProduction",
+    "cfDistribution",
+    "cfEndOfLifeRecycling",
+];
+const BAT_VAL = {
+    id: "BAT-VAL",
+    run(passport) {
+        const findings = [];
+        // (1a) percentages in [0, 100].
+        for (const key of BATTERY_PERCENT_FIELDS) {
+            const n = numberOf(passport, key);
+            if (n !== undefined && (n < 0 || n > 100)) {
+                findings.push({
+                    type: "invalid_format",
+                    severity: "warning",
+                    target: key,
+                    regulation: "(EU) 2023/1542",
+                    article: "Annex XIII",
+                    ruleId: "BAT-VAL",
+                    why: `${key} is ${n}, outside the valid 0–100% range.`,
+                    fix: `Correct ${key} to a percentage between 0 and 100.`,
+                });
+            }
+        }
+        // (1b) carbon-footprint values ≥ 0.
+        for (const key of BATTERY_NONNEGATIVE_FIELDS) {
+            const n = numberOf(passport, key);
+            if (n !== undefined && n < 0) {
+                findings.push({
+                    type: "invalid_format",
+                    severity: "warning",
+                    target: key,
+                    regulation: "(EU) 2023/1542",
+                    article: "Art. 7",
+                    ruleId: "BAT-VAL",
+                    why: `${key} is ${n}; a carbon-footprint value cannot be negative.`,
+                    fix: `Correct ${key} to a non-negative value (kg CO2e/kWh).`,
+                });
+            }
+        }
+        // (2) correlated requirement: hazardous substance recorded ⇒ SCIP
+        // notification expected. Skipped entirely when no hazardous substance
+        // is recorded (obligation not engaged) — so it never fires spuriously.
+        const hazardous = valueOf(passport, "hazardousSubstances");
+        const hazardousList = Array.isArray(hazardous)
+            ? hazardous
+            : hazardous !== undefined
+                ? [hazardous]
+                : [];
+        if (hazardousList.length > 0 && !hasValue(passport, "scipNotificationNumber")) {
+            findings.push({
+                type: "conditional_missing",
+                severity: "warning",
+                target: "scipNotificationNumber",
+                regulation: "(EC) 1907/2006",
+                article: "WFD Art. 9(1)(i)",
+                ruleId: "BAT-VAL",
+                why: "A hazardous substance is recorded, which engages the SCIP notification obligation, but no SCIP notification number is set.",
+                fix: "Record scipNotificationNumber for the SCIP database notification covering the recorded hazardous substance(s).",
+            });
+        }
+        return findings;
+    },
+};
+// ── Chemicals · REACH Art. 33 + SCIP (WFD Art. 9(1)(i)) ─────────────
+// CHEM-1: SVHC disclosure required IF any Candidate-List SVHC present
+// >0.1% w/w. The trigger is composition data the passport may not carry
+// machine-readably — when `svhcSubstances` is absent we cannot tell
+// whether the threshold is crossed, so we WARN (verify manually) rather
+// than assert compliance. When the array is present and non-empty, the
+// disclosure obligation is engaged → require the safe-use disclosure.
+const CHEM1 = {
+    id: "CHEM-1",
+    run(passport) {
+        const svhc = valueOf(passport, "svhcSubstances");
+        if (svhc === undefined) {
+            return [
+                {
+                    type: "unverifiable_conditional",
+                    severity: "warning",
+                    target: "svhcSubstances",
+                    regulation: "(EC) 1907/2006",
+                    article: "Art. 33",
+                    ruleId: "CHEM-1",
+                    why: "SVHC content isn't recorded, so REACH Art. 33 / SCIP disclosure (triggered above 0.1% w/w) couldn't be evaluated.",
+                    fix: "Record svhcSubstances. If any Candidate-List substance exceeds 0.1% w/w, safe-use info and a SCIP notification are required.",
+                },
+            ];
+        }
+        // Empty array → declared no SVHC above threshold → obligation not engaged.
+        const list = Array.isArray(svhc) ? svhc : [svhc];
+        if (list.length === 0)
+            return [];
+        // SVHC present → the safe-use disclosure (substance name min.) must be set.
+        if (!hasValue(passport, "svhcSubstanceName")) {
+            return [
+                {
+                    type: "conditional_missing",
+                    severity: "critical",
+                    target: "svhcSubstanceName",
+                    regulation: "(EC) 1907/2006",
+                    article: "Art. 33(1)",
+                    ruleId: "CHEM-1",
+                    why: "A Candidate-List SVHC is recorded; Art. 33 requires safe-use information including, as a minimum, the substance name.",
+                    fix: "Provide svhcSubstanceName and ensure a SCIP notification reference (WFD Art. 9(1)(i)) is recorded.",
+                },
+            ];
+        }
+        return [];
+    },
+};
+// ── Construction · Reg (EU) 2024/3110 (new CPR) ─────────────────────
+// CON-1: a Declaration of Performance & Conformity is required IF the
+// product is covered by a harmonised technical specification. The
+// template's `harmonizedStandardReference` (required) signals coverage;
+// when it's set, the CE-marking / declaration evidence must follow.
+// NB: the CPR's *DPP* provisions are NOT in force (future delegated
+// acts) — only this DoP/DoC conditional is binding today.
+const CON1 = {
+    id: "CON-1",
+    run(passport) {
+        const hsRef = valueOf(passport, "harmonizedStandardReference");
+        // No harmonised spec referenced → DoP/DoC obligation not engaged here.
+        if (hsRef === undefined)
+            return [];
+        if (!hasValue(passport, "ceMarkingStatus")) {
+            return [
+                {
+                    type: "conditional_missing",
+                    severity: "critical",
+                    target: "ceMarkingStatus",
+                    regulation: "(EU) 2024/3110",
+                    article: "DoP/DoC",
+                    ruleId: "CON-1",
+                    why: "Product is covered by a harmonised technical specification; a Declaration of Performance & Conformity (CE marking) is required.",
+                    fix: "Record ceMarkingStatus and the declaration evidence for the referenced harmonised standard.",
+                },
+            ];
+        }
+        return [];
+    },
+};
+/**
+ * Conditional-rule registry. Categories ABSENT from this map have no
+ * binding conditionals in force → the engine reports them `static-only`.
+ * CC-1 runs for every category and is composed in by the engine, so it
+ * is NOT listed per-category here.
+ */
+export const CONDITIONAL_RULES = {
+    battery: [BAT1, BAT_APP, BAT_VAL],
+    chemicals: [CHEM1],
+    construction: [CON1],
+};
+/** The cross-cutting rule the engine runs for every category. */
+export const CROSS_CUTTING_RULES = [CC1];
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Types for the compliance-verdict engine.
+ *
+ * The engine answers, for one passport: "is this DPP compliant, and if not,
+ * what's missing — citing the regulation?" It composes three tiers of check:
+ *
+ *   1. STATIC      — required template fields present + approved, required
+ *                    economic-operator parties present, filled values well-
+ *                    formed (pattern/enum/bounds). Applies to every category.
+ *   2. CONDITIONAL — per-category rules that only fire under a condition
+ *                    (e.g. battery passport required IF category is EV/LMT/
+ *                    industrial>2kWh; EU operator required IF manufacturer
+ *                    non-EU). Three categories carry binding conditionals —
+ *                    battery, chemicals, construction — plus one cross-cutting
+ *                    rule that applies to every category.
+ *   3. COVERAGE    — the engine self-reports whether conditionals were
+ *                    evaluated or the category is static-only, so an agent
+ *                    NEVER reads silence as "compliant".
+ *
+ * Severity → verdict:
+ *   - any `critical`  → "incomplete"
+ *   - else any `warning` → "compliant_with_warnings"
+ *   - else            → "compliant"
+ */
+export type ComplianceVerdict = "compliant" | "compliant_with_warnings" | "incomplete";
+/** Did per-category conditional rules actually run for this passport's
+ *  category, or does no binding conditional exist yet (static-only)? */
+export type ConditionalCoverage = "evaluated" | "static-only";
+export type FindingSeverity = "critical" | "warning";
+export type FindingType = 
+/** A required template field has no value (static tier). */
+"missing_field"
+/** A field has a value but isn't approved yet (static tier). */
+ | "unapproved_field"
+/** A required economic-operator party isn't set (static tier). */
+ | "missing_party"
+/** A filled value violates the template's pattern/enum/bounds (static tier). */
+ | "invalid_format"
+/** A conditional rule fired and its required field/party is missing. */
+ | "conditional_missing"
+/** A conditional rule should apply but its trigger field is absent, so the
+ *  engine couldn't evaluate it — surfaced as a warning, never silent. */
+ | "unverifiable_conditional";
+export interface ComplianceFinding {
+    type: FindingType;
+    severity: FindingSeverity;
+    /** Field key or party role this finding concerns, when applicable. */
+    target?: string;
+    /** Regulation number, e.g. "(EU) 2023/1542". Present for conditional
+     *  findings and for static findings whose field carries a regulationRef. */
+    regulation?: string;
+    /** Article / annex citation, e.g. "Art. 77" / "Annex VI". */
+    article?: string;
+    /** Short rule id from the verified spec (e.g. "BAT-1", "CC-1"). */
+    ruleId?: string;
+    /** One-line human explanation of why this matters. */
+    why: string;
+    /** One-line, actionable next step for the agent / user. */
+    fix?: string;
+}
+export interface ComplianceResult {
+    verdict: ComplianceVerdict;
+    category: string;
+    conditionalCoverage: ConditionalCoverage;
+    /** Findings that force "incomplete". */
+    critical: ComplianceFinding[];
+    /** Findings that downgrade to "compliant_with_warnings" but don't block. */
+    warnings: ComplianceFinding[];
+    /** Rule ids that actually ran (static checks + every conditional rule
+     *  evaluated). Lets an agent see WHAT was checked, not just the result. */
+    checkedRules: string[];
+    /** Completion metric, mirrors the passport's approved/total field ratio. */
+    completionPercentage: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,yBAAyB,GACzB,YAAY,CAAC;AAEjB;wEACwE;AACxE,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,aAAa,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,CAAC;AAErD,MAAM,MAAM,WAAW;AACrB,4DAA4D;AAC1D,eAAe;AACjB,gEAAgE;GAC9D,kBAAkB;AACpB,kEAAkE;GAChE,eAAe;AACjB,gFAAgF;GAC9E,gBAAgB;AAClB,wEAAwE;GACtE,qBAAqB;AACvB;yEACyE;GACvE,0BAA0B,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;gFAC4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,wCAAwC;IACxC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B;+EAC2E;IAC3E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,4EAA4E;IAC5E,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}

package/dist/types.js

@@ -0,0 +1,26 @@
+/**
+ * Types for the compliance-verdict engine.
+ *
+ * The engine answers, for one passport: "is this DPP compliant, and if not,
+ * what's missing — citing the regulation?" It composes three tiers of check:
+ *
+ *   1. STATIC      — required template fields present + approved, required
+ *                    economic-operator parties present, filled values well-
+ *                    formed (pattern/enum/bounds). Applies to every category.
+ *   2. CONDITIONAL — per-category rules that only fire under a condition
+ *                    (e.g. battery passport required IF category is EV/LMT/
+ *                    industrial>2kWh; EU operator required IF manufacturer
+ *                    non-EU). Three categories carry binding conditionals —
+ *                    battery, chemicals, construction — plus one cross-cutting
+ *                    rule that applies to every category.
+ *   3. COVERAGE    — the engine self-reports whether conditionals were
+ *                    evaluated or the category is static-only, so an agent
+ *                    NEVER reads silence as "compliant".
+ *
+ * Severity → verdict:
+ *   - any `critical`  → "incomplete"
+ *   - else any `warning` → "compliant_with_warnings"
+ *   - else            → "compliant"
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/vendor/counts.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Pure helpers for rolling passport-field status counts up into the
+ * `fieldCounts` and `completionPercentage` denormalized on the passport row.
+ *
+ * The same derivation logic was duplicated across the field edit, batch edit,
+ * review, and agent-pipeline paths — getting it in one place means the number
+ * the UI shows is always consistent no matter which writer touched the fields
+ * last.
+ */
+import type { FieldStatus } from "@tracepass/dpp-types";
+export interface FieldCounts {
+    total: number;
+    empty: number;
+    pendingReview: number;
+    approved: number;
+    flagged: number;
+}
+export interface PassportFieldsRollup {
+    fieldCounts: FieldCounts;
+    completionPercentage: number;
+}
+/** Narrow shape — we only care about the status of each field to roll counts up. */
+export interface CountableField {
+    status: FieldStatus;
+}
+/**
+ * completionPercentage is explicitly the share of approved fields, not the
+ * share of non-empty fields — a field that's pending_review or flagged is
+ * *known about* but not yet confirmed, so it doesn't count as done.
+ */
+export declare function derivePassportCounts(fields: Record<string, CountableField>): PassportFieldsRollup;
+//# sourceMappingURL=counts.d.ts.map

package/dist/vendor/counts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counts.d.ts","sourceRoot":"","sources":["../../src/vendor/counts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,WAAW,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GACrC,oBAAoB,CAatB"}

package/dist/vendor/counts.js

@@ -0,0 +1,28 @@
+/**
+ * Pure helpers for rolling passport-field status counts up into the
+ * `fieldCounts` and `completionPercentage` denormalized on the passport row.
+ *
+ * The same derivation logic was duplicated across the field edit, batch edit,
+ * review, and agent-pipeline paths — getting it in one place means the number
+ * the UI shows is always consistent no matter which writer touched the fields
+ * last.
+ */
+/**
+ * completionPercentage is explicitly the share of approved fields, not the
+ * share of non-empty fields — a field that's pending_review or flagged is
+ * *known about* but not yet confirmed, so it doesn't count as done.
+ */
+export function derivePassportCounts(fields) {
+    const values = Object.values(fields);
+    const total = values.length;
+    const fieldCounts = {
+        total,
+        empty: values.filter((f) => f.status === "empty").length,
+        pendingReview: values.filter((f) => f.status === "pending_review").length,
+        approved: values.filter((f) => f.status === "approved").length,
+        flagged: values.filter((f) => f.status === "flagged").length,
+    };
+    const completionPercentage = total > 0 ? Math.round((fieldCounts.approved / total) * 100) : 0;
+    return { fieldCounts, completionPercentage };
+}
+//# sourceMappingURL=counts.js.map

package/dist/vendor/counts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counts.js","sourceRoot":"","sources":["../../src/vendor/counts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAsC;IAEtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5B,MAAM,WAAW,GAAgB;QAC/B,KAAK;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM;QACxD,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC,MAAM;QACzE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,MAAM;QAC9D,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;KAC7D,CAAC;IACF,MAAM,oBAAoB,GACxB,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;AAC/C,CAAC"}