structural-codes 0.1.0-alpha.1

package/dist/schema/source-registry-v2.schema.js

@@ -0,0 +1,176 @@
+import { z } from "zod";
+import { isoDateSchema, isoDateTimeSchema } from "./primitives.js";
+const sha256StrictSchema = z.string().regex(/^[a-f0-9]{64}$/, "SHA-256 esadecimale richiesto");
+const officialGazzettaUrlSchema = z
+    .string()
+    .url()
+    .refine((value) => {
+    const url = new URL(value);
+    return url.protocol === "https:" && url.hostname === "www.gazzettaufficiale.it";
+}, "URL HTTPS ufficiale gazzettaufficiale.it richiesto");
+const localPdfPathSchema = z
+    .string()
+    .regex(/^raw-sources\/[a-z0-9][a-z0-9/-]*\.pdf$/, "percorso PDF relativo sotto raw-sources/ richiesto")
+    .refine((value) => !value.includes(".."), "segmenti .. non ammessi");
+const manifestationSchema = z.object({
+    sourceId: z.string().min(1),
+    expressionId: z.string().min(1),
+    mediaType: z.literal("application/pdf"),
+    officialUrl: officialGazzettaUrlSchema,
+    localFile: localPdfPathSchema,
+    sha256: sha256StrictSchema,
+    bytes: z.number().int().positive(),
+    pageCount: z.number().int().positive(),
+    acquiredAt: isoDateTimeSchema,
+    verification: z.object({
+        status: z.enum(["local-hash-verified", "remote-byte-identical"]),
+        verifiedAt: isoDateTimeSchema,
+        method: z.enum(["local-sha256", "streamed-remote-sha256"]),
+        manifestRecordId: z.string().min(1),
+    }),
+});
+const expressionSchema = z.object({
+    expressionId: z.string().min(1),
+    language: z.literal("it"),
+    version: z.enum(["original", "consolidated"]),
+    validFrom: isoDateSchema.nullable(),
+    validTo: isoDateSchema.nullable(),
+    officialConsolidation: z.boolean(),
+});
+const legalRelationSchema = z.object({
+    type: z.enum(["amends", "interprets"]),
+    targetWorkId: z.string().min(1),
+    note: z.string().min(1),
+});
+const temporalEffectSchema = z.object({
+    effectId: z.string().min(1),
+    type: z.enum(["substitutes", "adds", "temporarily-suspends"]),
+    targetWorkId: z.string().min(1),
+    targetCitation: z.string().min(1),
+    legalOperationFrom: isoDateSchema,
+    statedFrom: isoDateSchema.nullable(),
+    statedThrough: isoDateSchema.nullable(),
+    note: z.string().min(1),
+});
+const workSchema = z.object({
+    workId: z.string().min(1),
+    actType: z.enum(["decree", "circular"]),
+    legalRole: z.enum(["base-act", "interpretive-circular", "amending-act"]),
+    title: z.string().min(1),
+    authority: z.array(z.string().min(1)).min(1),
+    actNumber: z.string().min(1),
+    issuedOn: isoDateSchema,
+    publishedOn: isoDateSchema,
+    effectiveFrom: isoDateSchema.nullable(),
+    effectiveTo: isoDateSchema.nullable(),
+    effectiveDateBasis: z.string().min(1),
+    publication: z.object({
+        gazette: z.string().min(1),
+        supplement: z.string().nullable(),
+        redactionCode: z.string().regex(/^\d{2}[A-Z]\d{5}$/),
+        eliUri: officialGazzettaUrlSchema,
+        officialLandingPage: officialGazzettaUrlSchema,
+    }),
+    components: z
+        .array(z.object({
+        componentId: z.string().min(1),
+        kind: z.enum(["decree-body", "technical-annex", "circular-body"]),
+        label: z.string().min(1),
+    }))
+        .min(1),
+    expressions: z.array(expressionSchema).min(1),
+    manifestations: z.array(manifestationSchema).min(1),
+    relations: z.array(legalRelationSchema),
+    temporalEffects: z.array(temporalEffectSchema),
+});
+export const sourceRegistryV2Schema = z
+    .object({
+    registryVersion: z.literal(2),
+    status: z.literal("provisional-source-verified"),
+    scopeReviewedThrough: isoDateSchema,
+    corpusDisclaimer: z.string().min(1),
+    works: z.array(workSchema).min(1),
+})
+    .superRefine((registry, ctx) => {
+    const workIds = new Set(registry.works.map((work) => work.workId));
+    const seenWorkIds = new Set();
+    const expressionIds = new Set();
+    const sourceIds = new Set();
+    registry.works.forEach((work, workIndex) => {
+        if (seenWorkIds.has(work.workId)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["works", workIndex, "workId"],
+                message: `workId duplicato: ${work.workId}`,
+            });
+        }
+        seenWorkIds.add(work.workId);
+        const localExpressionIds = new Set(work.expressions.map((item) => item.expressionId));
+        for (const expression of work.expressions) {
+            if (expressionIds.has(expression.expressionId)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: ["works", workIndex, "expressions"],
+                    message: `expressionId duplicato: ${expression.expressionId}`,
+                });
+            }
+            expressionIds.add(expression.expressionId);
+        }
+        work.manifestations.forEach((manifestation, manifestationIndex) => {
+            if (sourceIds.has(manifestation.sourceId)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: ["works", workIndex, "manifestations", manifestationIndex, "sourceId"],
+                    message: `sourceId duplicato: ${manifestation.sourceId}`,
+                });
+            }
+            sourceIds.add(manifestation.sourceId);
+            if (!localExpressionIds.has(manifestation.expressionId)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: [
+                        "works",
+                        workIndex,
+                        "manifestations",
+                        manifestationIndex,
+                        "expressionId",
+                    ],
+                    message: "manifestazione collegata a expressionId inesistente nel work",
+                });
+            }
+        });
+        [...work.relations, ...work.temporalEffects].forEach((relation) => {
+            if (!workIds.has(relation.targetWorkId)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: ["works", workIndex],
+                    message: `targetWorkId non registrato: ${relation.targetWorkId}`,
+                });
+            }
+        });
+    });
+});
+const sourceVerificationRecordSchema = z.object({
+    recordId: z.string().min(1),
+    sourceId: z.string().min(1),
+    officialUrl: officialGazzettaUrlSchema,
+    httpStatus: z.literal(200),
+    remoteBytes: z.number().int().positive(),
+    remoteSha256: sha256StrictSchema,
+    localFile: localPdfPathSchema,
+    localBytes: z.number().int().positive(),
+    localSha256: sha256StrictSchema,
+    result: z.literal("byte-identical"),
+});
+export const sourceVerificationManifestSchema = z.object({
+    manifestVersion: z.literal(1),
+    manifestId: z.string().min(1),
+    performedAt: isoDateTimeSchema,
+    performedBy: z.object({
+        kind: z.literal("automated-agent"),
+        name: z.string().min(1),
+    }),
+    method: z.string().min(1),
+    records: z.array(sourceVerificationRecordSchema).min(1),
+});
+//# sourceMappingURL=source-registry-v2.schema.js.map

package/dist/schema/source-registry-v2.schema.js.map

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

package/integration/structural-checks-ts/manifest.json

@@ -0,0 +1,131 @@
+{
+    "$schema": "urn:structural-codes:schema:integration-manifest:v1",
+    "manifestVersion": 1,
+    "consumer": "structural-codes",
+    "provider": {
+        "currentName": "structural-checks-ts",
+        "plannedName": "structural-checks-ts",
+        "repository": "https://github.com/claudiopagani/structural-checks-ts",
+        "packageVersion": "0.3.0",
+        "gitCommit": "64f29e157f6685375df3c8348e517c343c3e60a7",
+        "observedWorktree": "clean",
+        "entrypoint": "dist/norms/ntc2018/index.js",
+        "normativeModule": "src/norms/ntc2018/actions/ntc2018WindLoad.ts",
+        "normativeModuleGitBlobSha1": "b20f09864a1a4d1c63b17152dfbca6304b71456d"
+    },
+    "expectedExports": [
+        "NTC2018_WIND_EXPOSURE_CATEGORIES",
+        "NTC2018_WIND_REFERENCES",
+        "NTC2018_WIND_ZONES",
+        "calculateNTC2018BaseWindSpeed",
+        "calculateNTC2018ReferenceWindPressure",
+        "calculateNTC2018ReferenceWindSpeed",
+        "calculateNTC2018WindAreaLoad",
+        "calculateNTC2018WindExposureCoefficient",
+        "calculateNTC2018WindPressure",
+        "calculateNTC2018WindReturnCoefficient",
+        "getNTC2018WindExposureCategoryDefinition",
+        "getNTC2018WindZoneDefinition"
+    ],
+    "mappings": [
+        {
+            "mappingId": "ntc2018-wind.base-speed",
+            "exportName": "calculateNTC2018BaseWindSpeed",
+            "status": "proposed",
+            "coverage": "full",
+            "unitIds": [
+                "urn:structural-codes:it:unit:ntc2018:3.3.1"
+            ],
+            "assetIds": [
+                "urn:structural-codes:it:asset:formula:ntc2018:3.3.1",
+                "urn:structural-codes:it:asset:formula:ntc2018:3.3.1.b",
+                "urn:structural-codes:it:asset:table:ntc2018:3.3.i"
+            ],
+            "rationale": "Calcola velocità base e coefficiente di altitudine usando i parametri zonali."
+        },
+        {
+            "mappingId": "ntc2018-wind.return-coefficient",
+            "exportName": "calculateNTC2018WindReturnCoefficient",
+            "status": "proposed",
+            "coverage": "full",
+            "unitIds": [
+                "urn:structural-codes:it:unit:ntc2018:3.3.2"
+            ],
+            "assetIds": [
+                "urn:structural-codes:it:asset:formula:ntc2018:3.3.3"
+            ],
+            "rationale": "Calcola il coefficiente di ritorno in funzione del periodo TR."
+        },
+        {
+            "mappingId": "ntc2018-wind.reference-speed",
+            "exportName": "calculateNTC2018ReferenceWindSpeed",
+            "status": "proposed",
+            "coverage": "full",
+            "unitIds": [
+                "urn:structural-codes:it:unit:ntc2018:3.3.2"
+            ],
+            "assetIds": [
+                "urn:structural-codes:it:asset:formula:ntc2018:3.3.2",
+                "urn:structural-codes:it:asset:formula:ntc2018:3.3.3"
+            ],
+            "rationale": "Combina velocità base e coefficiente di ritorno."
+        },
+        {
+            "mappingId": "ntc2018-wind.reference-pressure",
+            "exportName": "calculateNTC2018ReferenceWindPressure",
+            "status": "proposed",
+            "coverage": "full",
+            "unitIds": [
+                "urn:structural-codes:it:unit:ntc2018:3.3.6"
+            ],
+            "assetIds": [
+                "urn:structural-codes:it:asset:formula:ntc2018:3.3.6"
+            ],
+            "rationale": "Calcola la pressione cinetica di riferimento."
+        },
+        {
+            "mappingId": "ntc2018-wind.exposure",
+            "exportName": "calculateNTC2018WindExposureCoefficient",
+            "status": "proposed",
+            "coverage": "partial",
+            "unitIds": [
+                "urn:structural-codes:it:unit:ntc2018:3.3.7"
+            ],
+            "assetIds": [
+                "urn:structural-codes:it:asset:formula:ntc2018:3.3.7",
+                "urn:structural-codes:it:asset:table:ntc2018:3.3.ii"
+            ],
+            "rationale": "Implementa la formula nominale fino a 200 m; la scelta geografica della categoria resta input esplicito."
+        },
+        {
+            "mappingId": "ntc2018-wind.pressure",
+            "exportName": "calculateNTC2018WindPressure",
+            "status": "proposed",
+            "coverage": "partial",
+            "unitIds": [
+                "urn:structural-codes:it:unit:ntc2018:3.3.4"
+            ],
+            "assetIds": [
+                "urn:structural-codes:it:asset:formula:ntc2018:3.3.4"
+            ],
+            "rationale": "Compone la pressione; coefficienti aerodinamico e dinamico restano input documentati."
+        },
+        {
+            "mappingId": "ntc2018-wind.area-load",
+            "exportName": "calculateNTC2018WindAreaLoad",
+            "status": "proposed",
+            "coverage": "partial",
+            "unitIds": [
+                "urn:structural-codes:it:unit:ntc2018:3.3.1",
+                "urn:structural-codes:it:unit:ntc2018:3.3.2",
+                "urn:structural-codes:it:unit:ntc2018:3.3.4",
+                "urn:structural-codes:it:unit:ntc2018:3.3.6",
+                "urn:structural-codes:it:unit:ntc2018:3.3.7",
+                "urn:structural-codes:it:unit:ntc2018:3.3.8",
+                "urn:structural-codes:it:unit:ntc2018:3.3.9"
+            ],
+            "assetIds": [],
+            "rationale": "Workflow composito per pressione statica equivalente; non deriva coefficienti aerodinamici dalla geometria."
+        }
+    ]
+}

package/package.json

@@ -0,0 +1,217 @@
+{
+    "name": "structural-codes",
+    "version": "0.1.0-alpha.1",
+    "description": "Corpus strutturato, versionato e verificabile delle NTC 2018 e della Circolare 7/2019, predisposto per collegamenti a structural-checks-ts.",
+    "license": "LGPL-2.1-or-later",
+    "homepage": "https://github.com/claudiopagani/structural-codes#readme",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/claudiopagani/structural-codes.git"
+    },
+    "bugs": {
+        "url": "https://github.com/claudiopagani/structural-codes/issues"
+    },
+    "keywords": [
+        "structural-engineering",
+        "civil-engineering",
+        "building-codes",
+        "ntc2018",
+        "italian-regulations",
+        "machine-readable-law"
+    ],
+    "type": "module",
+    "sideEffects": false,
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        },
+        "./corpus": {
+            "types": "./dist/corpus/index.d.ts",
+            "import": "./dist/corpus/index.js",
+            "default": "./dist/corpus/index.js"
+        },
+        "./schema": {
+            "types": "./dist/schema/index.d.ts",
+            "import": "./dist/schema/index.js",
+            "default": "./dist/schema/index.js"
+        },
+        "./lib": {
+            "types": "./dist/lib/index.d.ts",
+            "import": "./dist/lib/index.js",
+            "default": "./dist/lib/index.js"
+        },
+        "./corpus/manifest.json": "./corpus/manifest.json",
+        "./corpus/units/*": "./corpus/units/*",
+        "./corpus/assets/*": "./corpus/assets/*",
+        "./schemas/*": "./schemas/*",
+        "./sources/registry": "./sources/registry/sources.v2.json",
+        "./integration/structural-checks-ts": "./integration/structural-checks-ts/manifest.json",
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist",
+        "schemas",
+        "corpus",
+        "sources/registry",
+        "integration",
+        "README.md",
+        "LICENSE",
+        "NOTICE"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": "^22.13.0 || >=24.0.0"
+    },
+    "scripts": {
+        "test": "node --experimental-strip-types --test \"tests/*.test.ts\"",
+        "typecheck": "tsc --noEmit -p tsconfig.json",
+        "lint": "eslint src scripts tests --max-warnings 0",
+        "validate:sources": "node --experimental-strip-types scripts/verify-source-registry-v2.ts",
+        "validate:sources:registry": "node --experimental-strip-types scripts/verify-source-registry-v2.ts --registry-only",
+        "validate:corpus": "node --experimental-strip-types scripts/validate-corpus-v2.ts",
+        "validate:integration": "node --experimental-strip-types scripts/validate-integration-manifest.ts",
+        "verify:integration:local": "node --experimental-strip-types scripts/validate-integration-manifest.ts --provider ../structural-checks-ts",
+        "verify:sources:online": "node --experimental-strip-types scripts/verify-source-registry-v2.ts --online",
+        "validate": "npm run validate:sources && npm run validate:corpus && npm run validate:integration",
+        "validate:ci": "npm run validate:sources:registry && npm run validate:corpus && npm run validate:integration",
+        "acquire:source": "node --experimental-strip-types scripts/acquire-source-v2.ts",
+        "extract:evidence": "node --experimental-strip-types scripts/extract-evidence.ts",
+        "render:evidence": "node --experimental-strip-types scripts/render-evidence.ts",
+        "verify:evidence": "node --experimental-strip-types scripts/verify-evidence.ts",
+        "verify:evidence:release": "node --experimental-strip-types scripts/verify-evidence.ts --require-local --require-samples",
+        "normalize:text": "node --experimental-strip-types scripts/normalize-text.ts",
+        "review:diff": "node --experimental-strip-types scripts/generate-review-diff.ts",
+        "workflow:check": "node --experimental-strip-types scripts/check-workflow-transition.ts",
+        "corpus:core:formulas": "node --experimental-strip-types scripts/build-core-formula-manifests.ts",
+        "corpus:circ12:figures": "python scripts/extract-circ12-figures.py",
+        "corpus:circ12:tables": "node --experimental-strip-types scripts/build-circ12-tables.ts",
+        "corpus:circ3:step1:figures": "python scripts/extract-circ3-step1-figures.py",
+        "corpus:circ3:step1:tables": "node --experimental-strip-types scripts/build-circ3-step1-tables.ts",
+        "corpus:circ3:step2:figures": "python scripts/extract-circ3-step2-figures.py",
+    "corpus:circ3:step2:tables": "node --experimental-strip-types scripts/build-circ3-step2-tables.ts",
+    "corpus:circ3:evidence-fix": "node --experimental-strip-types scripts/fix-circ3-evidence-spans.ts",
+        "corpus:circ3:step3:figures": "python scripts/extract-circ3-step3-figures.py",
+    "corpus:circ3:step3:tables": "node --experimental-strip-types scripts/build-circ3-step3-tables.ts",
+        "corpus:circ41:figures": "python scripts/extract-circ41-figures.py",
+    "corpus:circ41:tables": "node --experimental-strip-types scripts/build-circ41-tables.ts",
+    "corpus:ntc74:step1": "node --experimental-strip-types scripts/build-ntc74-step1.ts",
+    "corpus:ntc74:step1:figures": "python scripts/extract-ntc74-step1-figures.py",
+    "corpus:ntc74:step2": "node --experimental-strip-types scripts/build-ntc74-step2.ts",
+    "corpus:ntc74:step2:figures": "python scripts/extract-ntc74-step2-figures.py",
+    "corpus:ntc74:step3": "node --experimental-strip-types scripts/build-ntc74-step3.ts",
+    "corpus:ntc42:step1": "node --experimental-strip-types scripts/build-ntc42-step1.ts",
+    "corpus:ntc43:step1:figures": "python scripts/extract-ntc43-step1-figures.py",
+    "corpus:ntc43:step1": "node --experimental-strip-types scripts/build-ntc43-step1.ts",
+    "corpus:ntc43:step2:figures": "python scripts/extract-ntc43-step2-figures.py",
+    "corpus:ntc43:step2": "node --experimental-strip-types scripts/build-ntc43-step2.ts",
+    "corpus:ntc43:step3:figures": "python scripts/extract-ntc43-step3-figures.py",
+    "corpus:ntc43:step3": "node --experimental-strip-types scripts/build-ntc43-step3.ts",
+    "corpus:ntc43:step4:figures": "python scripts/extract-ntc43-step4-figures.py",
+    "corpus:ntc43:step4": "node --experimental-strip-types scripts/build-ntc43-step4.ts",
+    "corpus:ntc42:step2": "node --experimental-strip-types scripts/build-ntc42-step2.ts",
+    "corpus:ntc42:step3": "node --experimental-strip-types scripts/build-ntc42-step3.ts",
+    "corpus:ntc42:step4a": "node --experimental-strip-types scripts/build-ntc42-step4a.ts",
+    "corpus:ntc42:step4b": "node --experimental-strip-types scripts/build-ntc42-step4b.ts",
+    "corpus:ntc42:step4c": "node --experimental-strip-types scripts/build-ntc42-step4c.ts",
+    "corpus:ntc42:step4d": "node --experimental-strip-types scripts/build-ntc42-step4d.ts",
+    "corpus:ntc42:step5": "node --experimental-strip-types scripts/build-ntc42-step5.ts",
+    "corpus:ntc42:step6": "node --experimental-strip-types scripts/build-ntc42-step6.ts",
+    "corpus:ntc7:step2": "node --experimental-strip-types scripts/build-ntc7-step2.ts",
+    "corpus:ntc7:step3": "node --experimental-strip-types scripts/build-ntc7-step3.ts",
+    "corpus:ntc77-78:step2": "node --experimental-strip-types scripts/build-ntc77-step2.ts",
+    "corpus:ntc42:step6:figures": "python scripts/extract-ntc42-step6-figures.py",
+    "corpus:ntc7:step1": "node --experimental-strip-types scripts/build-ntc7-step1.ts",
+    "corpus:circ42:step1": "node --experimental-strip-types scripts/build-circ42-step1.ts",
+    "corpus:circ42:step2a": "node --experimental-strip-types scripts/build-circ42-step2a.ts",
+    "corpus:circ42:step2b": "node --experimental-strip-types scripts/build-circ42-step2b.ts",
+    "corpus:circ42:step2c": "node --experimental-strip-types scripts/build-circ42-step2c.ts",
+    "corpus:circ42:step2d": "node --experimental-strip-types scripts/build-circ42-step2d.ts",
+    "corpus:circ42:step2e": "node --experimental-strip-types scripts/build-circ42-step2e.ts",
+    "corpus:circ42:step2f": "node --experimental-strip-types scripts/build-circ42-step2f.ts",
+    "corpus:circ42:step2g": "node --experimental-strip-types scripts/build-circ42-step2g.ts",
+    "corpus:circ42:step2h": "node --experimental-strip-types scripts/build-circ42-step2h.ts",
+    "corpus:circ42:step2i": "node --experimental-strip-types scripts/build-circ42-step2i.ts",
+    "corpus:circ42:step2j": "node --experimental-strip-types scripts/build-circ42-step2j.ts",
+    "corpus:circ42:step2k": "node --experimental-strip-types scripts/build-circ42-step2k.ts",
+    "corpus:circ42:step2m": "node --experimental-strip-types scripts/build-circ42-step2m.ts",
+    "corpus:circ42:step2n": "node --experimental-strip-types scripts/build-circ42-step2n.ts",
+    "corpus:circ42:step2o": "node --experimental-strip-types scripts/build-circ42-step2o.ts",
+    "corpus:circ42:step2p": "node --experimental-strip-types scripts/build-circ42-step2p.ts",
+    "corpus:circ42:step2q": "node --experimental-strip-types scripts/build-circ42-step2q.ts",
+    "corpus:circ42:step2r": "node --experimental-strip-types scripts/build-circ42-step2r.ts",
+    "corpus:circ42:step2s": "node --experimental-strip-types scripts/build-circ42-step2s.ts",
+    "corpus:circ42:step2t": "node --experimental-strip-types scripts/build-circ42-step2t.ts",
+    "corpus:circ42:step2u": "node --experimental-strip-types scripts/build-circ42-step2u.ts",
+    "corpus:circ42:step2v": "node --experimental-strip-types scripts/build-circ42-step2v.ts",
+    "corpus:circ42:step2w": "node --experimental-strip-types scripts/build-circ42-step2w.ts",
+    "corpus:circ42:step2x": "node --experimental-strip-types scripts/build-circ42-step2x.ts",
+    "corpus:circ42:step2y": "node --experimental-strip-types scripts/build-circ42-step2y.ts",
+    "corpus:circ42:step2z": "node --experimental-strip-types scripts/build-circ42-step2z.ts",
+    "corpus:circ42:step2aa": "node --experimental-strip-types scripts/build-circ42-step2aa.ts",
+    "corpus:circ42:step2ab": "node --experimental-strip-types scripts/build-circ42-step2ab.ts",
+    "corpus:circ42:step2ac": "node --experimental-strip-types scripts/build-circ42-step2ac.ts",
+    "corpus:circ42:step2ad": "node --experimental-strip-types scripts/build-circ42-step2ad.ts",
+    "corpus:circ42:step2ae": "node --experimental-strip-types scripts/build-circ42-step2ae.ts",
+    "corpus:circ42:step2l": "node --experimental-strip-types scripts/build-circ42-step2l.ts",
+    "corpus:circ74": "node --experimental-strip-types scripts/build-circ74.ts",
+    "corpus:circ74:figures": "python scripts/extract-circ74-figures.py",
+    "corpus:circ75:step1": "node --experimental-strip-types scripts/build-circ75-step1.ts",
+    "corpus:circ75:step1:figures": "python scripts/extract-circ75-step1-figures.py",
+    "corpus:circ76:step1": "node --experimental-strip-types scripts/build-circ76-step1.ts",
+    "corpus:circ76:step1:figures": "python scripts/extract-circ76-step1-figures.py",
+    "corpus:circ77:step1": "node --experimental-strip-types scripts/build-circ77-step1.ts",
+    "corpus:circ78-79:step1": "node --experimental-strip-types scripts/build-circ78-79-step1.ts",
+    "corpus:circ78-79:step1:figures": "python scripts/extract-circ78-79-step1-figures.py",
+    "corpus:circ710:step1": "node --experimental-strip-types scripts/build-circ710-step1.ts",
+    "corpus:circ710:step1:figures": "python scripts/extract-circ710-step1-figures.py",
+    "corpus:circ711:step1": "node --experimental-strip-types scripts/build-circ711-step1.ts",
+    "corpus:circ7:step0": "node --experimental-strip-types scripts/build-circ7-step0.ts && npm run corpus:circ7:figures",
+    "corpus:circ7:step1": "node --experimental-strip-types scripts/build-circ7-step1.ts",
+    "corpus:circ7:step2": "node --experimental-strip-types scripts/build-circ7-step2.ts",
+    "corpus:circ7:figures": "python scripts/extract-circ7-figures.py",
+    "corpus:ntc31:tables": "node --experimental-strip-types scripts/build-ntc31-tables.ts",
+    "corpus:ntc314:flow": "node --experimental-strip-types scripts/clean-ntc314-table-flow.ts",
+    "corpus:circ8:root": "node --experimental-strip-types scripts/build-circ8-root.ts",
+    "corpus:circ87:step3b": "node --experimental-strip-types scripts/build-circ87-step3b.ts",
+    "corpus:circ43:figures": "python scripts/extract-circ43-figures.py",
+    "corpus:circ43": "node --experimental-strip-types scripts/build-circ43-step1.ts",
+        "build": "npm run build:package",
+        "build:package": "node scripts/build-package.mjs",
+        "viewer:install": "node scripts/install-viewer-dependencies.mjs",
+        "viewer:dev": "npm --prefix viewer run dev",
+        "viewer:build": "npm --prefix viewer run build",
+        "viewer:start": "npm --prefix viewer run start",
+        "viewer:check": "npm --prefix viewer run check",
+        "viewer:test": "npm --prefix viewer test",
+        "audit:production": "npm audit --omit=dev",
+        "viewer:audit:production": "npm --prefix viewer audit --omit=dev",
+        "check": "npm run validate && npm run verify:evidence && npm run typecheck && npm run lint && npm test",
+        "check:ci": "npm run validate:ci && npm run verify:evidence && npm run typecheck && npm run lint && npm test",
+        "release:verify:package": "npm run build:package && node scripts/verify-release.mjs",
+        "release:verify": "npm run check && npm run verify:evidence:release && npm run audit:production && npm run viewer:check && npm run viewer:audit:production && npm run release:verify:package",
+        "prepack": "npm run build:package"
+    },
+    "dependencies": {
+        "zod": "^3.24.1"
+    },
+    "devDependencies": {
+        "@eslint/js": "^10.0.1",
+        "@napi-rs/canvas": "^1.0.2",
+        "@types/node": "^22.10.0",
+        "ajv": "^8.20.0",
+        "ajv-formats": "^3.0.1",
+        "canonicalize": "^3.0.0",
+        "diff": "^8.0.4",
+        "eslint": "^10.8.0",
+        "globals": "^17.7.0",
+        "pdfjs-dist": "^4.10.38",
+        "typescript": "^5.7.0",
+        "typescript-eslint": "^8.65.0"
+    }
+}

package/schemas/README.md

@@ -0,0 +1,21 @@
+# Schemi canonici
+
+`corpus-v2.schema.json` è il contratto JSON Schema Draft 2020-12 per una
+unità normativa canonica. La versione corrente è `2.0.0-alpha.2`: il corpus è
+pubblico come lavoro editoriale, ma non è ancora una release normativa
+approvata.
+
+La validazione ha due livelli:
+
+1. JSON Schema, eseguito con AJV in modalità stretta;
+2. vincoli semantici e referenziali, eseguiti da
+   `scripts/validate-corpus-v2.ts`.
+
+Eseguire:
+
+```bash
+npm run validate:corpus
+```
+
+I record reali andranno sotto `corpus/`; le fixture contrattuali sono in
+`fixtures/corpus-v2/`. MDX, Markdown e JSONL non sono fonti canoniche.