@ifc-lite/cli 0.27.0 → 0.28.1

package/README.md

@@ -48,7 +48,7 @@ Global flags: `--json`, `--out <file>`, `--verbose`, `--quiet`, `--debug`, `--lo
 
 ## gym
 
-`ifc-lite gym` is a prototype reset/step/reward environment API over the existing headless checks: the skeleton of an RLVR environment for buildings (see [`docs/vision/moonshots-tech.md`](../../docs/vision/moonshots-tech.md) M2 and [`docs/vision/moonshots-execution-plan.md`](../../docs/vision/moonshots-execution-plan.md) B0.4). It wraps a model - either a fixed file (`--model`) or a procedurally generated World Gym episode (`--seed`) - and lets an agent apply data-mutation ops, scoring each step against the same schema/clash/ids checks the `validate`, `clash`, and `ids` commands already run.
+`ifc-lite gym` is a prototype reset/step/reward environment API over the existing headless checks: the skeleton of an RLVR environment for buildings (see [`tools/world-gym/README.md`](../../tools/world-gym/README.md) M2 and [`tools/world-gym/benchmark/BENCHMARK.md`](../../tools/world-gym/benchmark/BENCHMARK.md) B0.4). It wraps a model - either a fixed file (`--model`) or a procedurally generated World Gym episode (`--seed`) - and lets an agent apply data-mutation ops, scoring each step against the same schema/clash/ids checks the `validate`, `clash`, and `ids` commands already run.
 
 ```bash
 ifc-lite gym --model model.ifc --checks schema,clash

package/dist/commands/bcf.js

@@ -21,7 +21,7 @@ export async function bcfCommand(args) {
             const author = getFlag(args, '--author') ?? 'cli@ifc-lite.com';
             const outPath = getFlag(args, '--out');
             if (!title)
-                fatal('Usage: ifc-lite bcf create --title "Issue" [--description "..."] [--author email] --out file.bcf');
+                fatal('Usage: ifc-lite bcf create --title "Missing door" [--description "..."] [--author email] --out file.bcf');
             if (!outPath)
                 fatal('--out is required for BCF creation');
             const project = await bcf.createProject({ name: 'CLI Project' });

package/dist/commands/bcf.js.map

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

package/dist/commands/delivery-checks.d.ts

@@ -0,0 +1,56 @@
+import { type IfcDataStore } from '@ifc-lite/parser';
+import { type ValidationIssue } from './validate.js';
+export type CheckStatus = 'pass' | 'fail' | 'error';
+export interface LoadedModel {
+    path: string;
+    /** SHA-256 of the exact bytes read from disk (post ifcZIP unwrap: the STEP text actually checked). */
+    sha256: string;
+    store: IfcDataStore;
+}
+export interface ModelLoadError {
+    path: string;
+    error: string;
+}
+/** Load one model file for delivery checking, never throwing and never exiting the process. */
+export declare function loadModelForDelivery(path: string): Promise<LoadedModel | ModelLoadError>;
+export interface StructuralCheckResult {
+    type: 'structural';
+    model: string;
+    status: CheckStatus;
+    errorCount: number;
+    warningCount: number;
+    infoCount: number;
+    issues: ValidationIssue[];
+    error?: string;
+}
+/** Run the same structural rules `ifc-lite validate` runs. `fail` iff at least one error-severity issue was found. */
+export declare function runStructuralCheck(modelPath: string, store: IfcDataStore): StructuralCheckResult;
+export interface IdsCheckResult {
+    type: 'ids';
+    model: string;
+    source: string;
+    status: CheckStatus;
+    totalSpecifications?: number;
+    passedSpecifications?: number;
+    failedSpecifications?: number;
+    notApplicableSpecifications?: number;
+    totalEntities?: number;
+    passedEntities?: number;
+    failedEntities?: number;
+    error?: string;
+}
+/**
+ * Run one IDS rule file against one already-loaded model.
+ *
+ * `status` is `error` when the IDS file itself could not be read/parsed, or
+ * when it declares zero specifications (nothing was actually evaluated —
+ * reporting that as `pass` would hide an empty ruleset behind a green
+ * check). Otherwise `fail` iff at least one specification failed; a
+ * specification whose applicability matched no entities counts as neither
+ * pass nor fail (`notApplicableSpecifications`) — if EVERY specification
+ * lands there (nothing was definitively satisfied OR violated), the check
+ * reports `error` rather than a `pass` that would rest on zero actual
+ * evidence.
+ */
+export declare function runIdsCheck(modelPath: string, store: IfcDataStore, idsPath: string): Promise<IdsCheckResult>;
+//# sourceMappingURL=delivery-checks.d.ts.map

package/dist/commands/delivery-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-checks.d.ts","sourceRoot":"","sources":["../../src/commands/delivery-checks.ts"],"names":[],"mappings":"AA6BA,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGlF,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAE9E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,sGAAsG;IACtG,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+FAA+F;AAC/F,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,cAAc,CAAC,CAyC9F;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sHAAsH;AACtH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,qBAAqB,CAchG;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+GD;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA6ClH"}

package/dist/commands/delivery-checks.js

@@ -0,0 +1,222 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Model loading and per-check evaluation for `ifc-lite delivery`.
+ *
+ * Three outcomes exist for every check, never just two:
+ *  - `pass`   — the check ran and found nothing to report.
+ *  - `fail`   — the check ran and found a violation.
+ *  - `error`  — the check could NOT be run (unreadable model, unreadable or
+ *               unparsable IDS file, an IDS document declaring zero
+ *               specifications). An unevaluable check must never be folded
+ *               into `pass`: a delivery report that silently skips a rule
+ *               and still reads as clean is worse than no report.
+ *
+ * `loadModelForDelivery` deliberately does NOT reuse `loader.ts`'s
+ * `loadIfcFile`/`loadIfcBytes`: those call `process.exit(1)` directly on an
+ * empty, non-STEP, or unparsable file, which is correct for a single-file
+ * command but would kill the whole `delivery` process on the SECOND model in
+ * a multi-model recipe just because the first one was bad. This loader
+ * performs the same validation (STEP signature, ifcZIP unwrap, parse) but
+ * returns a `{ error }` result instead of exiting, so one unreadable model
+ * becomes one `error` entry in the report — never a crashed run and never a
+ * silently-passing verdict.
+ */
+import { readFile } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { IfcParser, unwrapIfcZipView } from '@ifc-lite/parser';
+import { createDataAccessor } from '@ifc-lite/ids/bridge';
+import { IDSNamespace } from '@ifc-lite/sdk';
+import { computeValidationIssues } from './validate.js';
+/** Load one model file for delivery checking, never throwing and never exiting the process. */
+export async function loadModelForDelivery(path) {
+    let bytes;
+    try {
+        bytes = await readFile(path);
+    }
+    catch (err) {
+        return { path, error: `could not be read: ${err.message}` };
+    }
+    if (bytes.byteLength === 0) {
+        return { path, error: 'is empty (0 bytes)' };
+    }
+    try {
+        bytes = new Uint8Array(await unwrapIfcZipView(bytes));
+    }
+    catch (err) {
+        return { path, error: `could not be unwrapped: ${err.message}` };
+    }
+    const headerSnippet = new TextDecoder('latin1').decode(bytes.subarray(0, Math.min(bytes.byteLength, 256)));
+    if (!headerSnippet.includes('ISO-10303-21')) {
+        return { path, error: 'is not a valid IFC/STEP file' };
+    }
+    const sha256 = createHash('sha256').update(bytes).digest('hex');
+    const parser = new IfcParser();
+    const origLog = console.log;
+    const origWarn = console.warn;
+    console.log = () => { };
+    console.warn = () => { };
+    try {
+        const arrayBuffer = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+        const store = await parser.parseColumnar(arrayBuffer, {});
+        store.fileSize = bytes.byteLength;
+        return { path, sha256, store };
+    }
+    catch (err) {
+        return { path, error: `could not be parsed: ${err.message}` };
+    }
+    finally {
+        console.log = origLog;
+        console.warn = origWarn;
+    }
+}
+/** Run the same structural rules `ifc-lite validate` runs. `fail` iff at least one error-severity issue was found. */
+export function runStructuralCheck(modelPath, store) {
+    const issues = computeValidationIssues(store);
+    const errorCount = issues.filter(i => i.severity === 'error').length;
+    const warningCount = issues.filter(i => i.severity === 'warning').length;
+    const infoCount = issues.filter(i => i.severity === 'info').length;
+    return {
+        type: 'structural',
+        model: modelPath,
+        status: errorCount > 0 ? 'fail' : 'pass',
+        errorCount,
+        warningCount,
+        infoCount,
+        issues,
+    };
+}
+/**
+ * A specification counts as genuinely evaluated only when its cardinality
+ * bound could actually have been violated by SOME entity count, or it
+ * checked at least one entity's requirements. `minOccurs="0"` with no
+ * finite upper bound (the IDS "optional, if present" cardinality) is
+ * satisfied by zero matches for every possible model — no entity count
+ * could ever fail it — so treating that as `pass` reports success for a
+ * rule that could not possibly have failed and checked nothing. That is
+ * distinct from a `maxOccurs="0"` prohibition ("must not exist"), which a
+ * nonzero applicable count WOULD have violated, so zero matches there is
+ * real evidence, not a vacuous result — `@ifc-lite/ids`'s own corpus fixture
+ * `pass-prohibited_specifications_passes_if_the_applicability_does_not_matches.ids`
+ * exercises exactly this and must keep reading `pass`.
+ */
+function isVacuousSpecification(spec) {
+    if (spec.status === 'not_applicable')
+        return true;
+    const c = spec.cardinalityResult;
+    if (!c || c.actualCount !== 0)
+        return false;
+    return c.minExpected === 0 && (c.maxExpected === undefined || c.maxExpected === 'unbounded');
+}
+/**
+ * Summarize a real `IDSValidationReport` for the delivery checker.
+ *
+ * This intentionally does NOT call `bim.ids.summarize()` (`@ifc-lite/sdk`)
+ * for the specification-level bucketing: that helper defers entirely to
+ * the validator's own per-specification `status`, and the validator marks
+ * a `minOccurs="0"`/unbounded-`maxOccurs` specification `pass` whenever it
+ * matches zero entities (see `isVacuousSpecification` above) — correct IDS
+ * semantics for an "optional" clause, but exactly the vacuous-check defect
+ * a delivery checker must not fold into `pass`. Entity counts ARE summed
+ * directly here for the same reason `bim.ids.summarize()` would need
+ * `includePassingEntities: true` to get them right: that option controls
+ * whether PASSING entities are even present in `entityResults`, and this
+ * file used to call `validate()` with it `false`, which is harmless for the
+ * raw validator's own `summary.totalEntitiesChecked` (computed from each
+ * specification's `passedCount`/`failedCount`, not from `entityResults`)
+ * but would silently undercount any per-entity tally derived from
+ * `entityResults` directly, `bim.ids.summarize()` included.
+ */
+function summarizeIdsReport(report) {
+    let passedSpecifications = 0;
+    let failedSpecifications = 0;
+    let notApplicableSpecifications = 0;
+    let totalEntities = 0;
+    let passedEntities = 0;
+    let failedEntities = 0;
+    for (const spec of report.specificationResults) {
+        for (const entity of spec.entityResults) {
+            totalEntities++;
+            if (entity.passed)
+                passedEntities++;
+            else
+                failedEntities++;
+        }
+        if (spec.status === 'fail') {
+            failedSpecifications++;
+        }
+        else if (isVacuousSpecification(spec)) {
+            notApplicableSpecifications++;
+        }
+        else {
+            passedSpecifications++;
+        }
+    }
+    return {
+        totalSpecifications: report.specificationResults.length,
+        passedSpecifications,
+        failedSpecifications,
+        notApplicableSpecifications,
+        totalEntities,
+        passedEntities,
+        failedEntities,
+    };
+}
+/**
+ * Run one IDS rule file against one already-loaded model.
+ *
+ * `status` is `error` when the IDS file itself could not be read/parsed, or
+ * when it declares zero specifications (nothing was actually evaluated —
+ * reporting that as `pass` would hide an empty ruleset behind a green
+ * check). Otherwise `fail` iff at least one specification failed; a
+ * specification whose applicability matched no entities counts as neither
+ * pass nor fail (`notApplicableSpecifications`) — if EVERY specification
+ * lands there (nothing was definitively satisfied OR violated), the check
+ * reports `error` rather than a `pass` that would rest on zero actual
+ * evidence.
+ */
+export async function runIdsCheck(modelPath, store, idsPath) {
+    const base = { type: 'ids', model: modelPath, source: idsPath };
+    let idsContent;
+    try {
+        idsContent = await readFile(idsPath, 'utf-8');
+    }
+    catch (err) {
+        return { ...base, status: 'error', error: `could not be read: ${err.message}` };
+    }
+    const ids = new IDSNamespace();
+    let idsDoc;
+    try {
+        idsDoc = await ids.parse(idsContent);
+    }
+    catch (err) {
+        return { ...base, status: 'error', error: `could not be parsed: ${err.message}` };
+    }
+    const accessor = createDataAccessor(store);
+    let report;
+    try {
+        report = (await ids.validate(idsDoc, {
+            accessor,
+            modelInfo: { schemaVersion: store.schemaVersion },
+            locale: 'en',
+            includePassingEntities: true,
+        }));
+    }
+    catch (err) {
+        return { ...base, status: 'error', error: `validation failed: ${err.message}` };
+    }
+    const s = summarizeIdsReport(report);
+    if (s.totalSpecifications === 0) {
+        return { ...base, status: 'error', error: 'declares zero specifications', ...s };
+    }
+    const evaluated = s.passedSpecifications + s.failedSpecifications;
+    const status = s.failedSpecifications > 0 ? 'fail' : evaluated > 0 ? 'pass' : 'error';
+    return {
+        ...base,
+        status,
+        ...s,
+        ...(status === 'error' ? { error: 'every specification was not-applicable — nothing was evaluated' } : {}),
+    };
+}
+//# sourceMappingURL=delivery-checks.js.map

package/dist/commands/delivery-checks.js.map

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

package/dist/commands/delivery-recipe.d.ts

@@ -0,0 +1,23 @@
+/** The recipe fields as declared in the JSON file (paths not yet resolved). */
+export interface DeliveryRecipe {
+    models: string[];
+    structural: boolean;
+    ids: string[];
+}
+/** A recipe with every `models`/`ids` path resolved to an absolute path. */
+export interface ResolvedDeliveryRecipe extends DeliveryRecipe {
+    /** Absolute path to the recipe file itself. */
+    recipePath: string;
+    /** `models`, resolved to absolute paths, in declared order. */
+    resolvedModels: string[];
+    /** `ids`, resolved to absolute paths, in declared order. */
+    resolvedIds: string[];
+}
+/**
+ * Load and validate a delivery recipe, resolving every declared path
+ * relative to the recipe file's own directory. Every failure mode is a
+ * `fatal(...)` with a specific reason — never a silently empty or
+ * partially-applied recipe.
+ */
+export declare function loadDeliveryRecipe(path: string): Promise<ResolvedDeliveryRecipe>;
+//# sourceMappingURL=delivery-recipe.d.ts.map

package/dist/commands/delivery-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-recipe.d.ts","sourceRoot":"","sources":["../../src/commands/delivery-recipe.ts"],"names":[],"mappings":"AAuCA,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,4EAA4E;AAC5E,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAQD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiEtF"}

package/dist/commands/delivery-recipe.js

@@ -0,0 +1,104 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * The saved recipe `ifc-lite delivery` runs.
+ *
+ * A recipe is a plain JSON file naming one or more model files and the
+ * checks to run against every one of them — `structural` (the same rules
+ * `ifc-lite validate` runs) and/or one or more `ids` rule files (the same
+ * validator `ifc-lite ids` runs). It exists so a delivery check is a single,
+ * versioned, reviewable artifact a team commits and re-runs, rather than a
+ * remembered shell invocation.
+ *
+ * ```json
+ * {
+ *   "models": ["model.ifc"],
+ *   "structural": true,
+ *   "ids": ["door-rules.ids"]
+ * }
+ * ```
+ *
+ * Every `models`/`ids` path is resolved relative to the DIRECTORY CONTAINING
+ * THE RECIPE FILE, not the process's current working directory — a recipe
+ * committed alongside its fixtures stays runnable from anywhere.
+ *
+ * A malformed recipe is a `fatal(...)`, matching every other saved-definition
+ * loader in this CLI (`schedule-spec.ts`): not valid JSON, not a JSON object,
+ * an unrecognised field, a field of the wrong type, an empty/missing
+ * `models` list, or declaring NEITHER `structural: true` NOR a non-empty
+ * `ids` list (a recipe with zero applicable checks can never produce a
+ * meaningful delivery verdict, so it is rejected up front rather than
+ * silently reporting an empty "pass").
+ */
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fatal } from '../output.js';
+const RECIPE_FIELDS = ['models', 'structural', 'ids'];
+function isStringArray(value) {
+    return Array.isArray(value) && value.every(v => typeof v === 'string');
+}
+/**
+ * Load and validate a delivery recipe, resolving every declared path
+ * relative to the recipe file's own directory. Every failure mode is a
+ * `fatal(...)` with a specific reason — never a silently empty or
+ * partially-applied recipe.
+ */
+export async function loadDeliveryRecipe(path) {
+    let content;
+    try {
+        content = await readFile(path, 'utf-8');
+    }
+    catch (err) {
+        fatal(`Recipe "${path}" could not be read: ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (err) {
+        fatal(`Recipe "${path}" is not valid JSON: ${err.message}`);
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        fatal(`Recipe "${path}" must be a JSON object with "models" and at least one of "structural"/"ids", got ${Array.isArray(parsed) ? 'an array' : typeof parsed}.`);
+    }
+    const obj = parsed;
+    const unknownKeys = Object.keys(obj).filter(k => !RECIPE_FIELDS.includes(k));
+    if (unknownKeys.length > 0) {
+        fatal(`Recipe "${path}" has unrecognised field(s): ${unknownKeys.join(', ')}. Valid fields: ${RECIPE_FIELDS.join(', ')}.`);
+    }
+    if (!('models' in obj) || !isStringArray(obj.models) || obj.models.length === 0) {
+        fatal(`Recipe "${path}": "models" must be a non-empty array of file paths.`);
+    }
+    const models = obj.models;
+    if ('structural' in obj && typeof obj.structural !== 'boolean') {
+        fatal(`Recipe "${path}": "structural" must be a boolean, got ${typeof obj.structural}.`);
+    }
+    const structural = obj.structural ?? false;
+    if ('ids' in obj && !isStringArray(obj.ids)) {
+        fatal(`Recipe "${path}": "ids" must be an array of file paths.`);
+    }
+    const ids = obj.ids ?? [];
+    if (!structural && ids.length === 0) {
+        fatal(`Recipe "${path}" declares no applicable checks: set "structural": true and/or a non-empty "ids" list. A zero-check recipe can never produce a delivery verdict.`);
+    }
+    // Duplicate model/ids entries are rejected rather than silently
+    // deduplicated or run twice under one collapsed key: a repeated path is
+    // almost certainly a copy-paste mistake in the recipe, and either
+    // response (silent dedup, or a doubled report entry) would misrepresent
+    // what the recipe actually says it checks.
+    const dupModels = models.filter((m, i) => models.indexOf(m) !== i);
+    if (dupModels.length > 0) {
+        fatal(`Recipe "${path}": "models" lists the same path more than once: ${[...new Set(dupModels)].join(', ')}.`);
+    }
+    const dupIds = ids.filter((m, i) => ids.indexOf(m) !== i);
+    if (dupIds.length > 0) {
+        fatal(`Recipe "${path}": "ids" lists the same path more than once: ${[...new Set(dupIds)].join(', ')}.`);
+    }
+    const recipePath = resolve(path);
+    const baseDir = dirname(recipePath);
+    const resolvedModels = models.map(m => resolve(baseDir, m));
+    const resolvedIds = ids.map(i => resolve(baseDir, i));
+    return { recipePath, models, structural, ids, resolvedModels, resolvedIds };
+}
+//# sourceMappingURL=delivery-recipe.js.map

package/dist/commands/delivery-recipe.js.map

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

package/dist/commands/delivery-report.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Consolidated report assembly and HTML rendering for `ifc-lite delivery`.
+ *
+ * Determinism contract: `buildDeliveryReport` never reads the wall clock,
+ * never iterates a `Map`/object in insertion-order-dependent ways, and never
+ * keys a result by a derived string (model path, IDS file name, check type)
+ * — every check is one entry in a flat, declared-order ARRAY. Two collisions
+ * this codebase has actually shipped (a subtotal silently overwritten in
+ * `schedule`'s output, a duplicate `--columns` header collapsing a row in
+ * JSON) both came from keying a result object by a name that two distinct
+ * inputs could share; an array keeps every check's own model/type/source
+ * fields as data instead of forcing them into a Map/object key that could
+ * collide. The result: the SAME recipe run twice, with no model or IDS file
+ * changed on disk, produces byte-identical JSON (`tool.version` and the
+ * `sha256` fingerprints are the only fields that could ever legitimately
+ * differ between two runs, and neither depends on wall-clock time or
+ * iteration order).
+ */
+import type { StructuralCheckResult, IdsCheckResult } from './delivery-checks.js';
+import type { ResolvedDeliveryRecipe } from './delivery-recipe.js';
+export type DeliveryCheckResult = StructuralCheckResult | IdsCheckResult;
+export interface DeliveryModelEntry {
+    /** Path exactly as declared in the recipe (relative, for a readable report). */
+    path: string;
+    /** SHA-256 of the model's bytes, or undefined when the model could not be loaded. */
+    sha256?: string;
+    /** Set when the model could not be loaded; every check for this model then reports `error`. */
+    loadError?: string;
+}
+export interface DeliveryReport {
+    tool: {
+        name: 'ifc-lite';
+        version: string;
+    };
+    recipe: string;
+    models: DeliveryModelEntry[];
+    checks: DeliveryCheckResult[];
+    /** `pass` iff every check in `checks` is `pass` and `checks` is non-empty. */
+    verdict: 'pass' | 'fail';
+    summary: {
+        total: number;
+        pass: number;
+        fail: number;
+        error: number;
+    };
+}
+/** Build the consolidated report from a resolved recipe, its per-model load outcomes, and every check result. */
+export declare function buildDeliveryReport(recipe: ResolvedDeliveryRecipe, version: string, models: DeliveryModelEntry[], checks: DeliveryCheckResult[]): DeliveryReport;
+/** Render the report as a standalone HTML document — no external assets, safe to open from disk. */
+export declare function renderDeliveryHtml(report: DeliveryReport): string;
+//# sourceMappingURL=delivery-report.d.ts.map

package/dist/commands/delivery-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-report.d.ts","sourceRoot":"","sources":["../../src/commands/delivery-report.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAe,MAAM,sBAAsB,CAAC;AAC/F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,GAAG,cAAc,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,iHAAiH;AACjH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,EAAE,EAC5B,MAAM,EAAE,mBAAmB,EAAE,GAC5B,cAAc,CAchB;AA+BD,oGAAoG;AACpG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAoEjE"}

package/dist/commands/delivery-report.js

@@ -0,0 +1,114 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/** Build the consolidated report from a resolved recipe, its per-model load outcomes, and every check result. */
+export function buildDeliveryReport(recipe, version, models, checks) {
+    const counts = { total: checks.length, pass: 0, fail: 0, error: 0 };
+    for (const c of checks)
+        counts[c.status]++;
+    const verdict = checks.length > 0 && counts.fail === 0 && counts.error === 0 ? 'pass' : 'fail';
+    return {
+        tool: { name: 'ifc-lite', version },
+        recipe: recipe.recipePath,
+        models,
+        checks,
+        verdict,
+        summary: counts,
+    };
+}
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+function statusBadge(status) {
+    const label = status.toUpperCase();
+    return `<span class="badge badge-${status}">${label}</span>`;
+}
+function describeCheck(check) {
+    if (check.type === 'structural') {
+        return `${check.errorCount} error(s), ${check.warningCount} warning(s), ${check.infoCount} info`;
+    }
+    const parts = [];
+    if (check.totalSpecifications !== undefined) {
+        parts.push(`${check.passedSpecifications ?? 0}/${check.totalSpecifications} specification(s) passed`);
+    }
+    if (check.failedEntities !== undefined && check.totalEntities !== undefined) {
+        parts.push(`${check.failedEntities}/${check.totalEntities} entities failed`);
+    }
+    if (check.error)
+        parts.push(check.error);
+    return parts.join(' — ') || (check.error ?? '');
+}
+/** Render the report as a standalone HTML document — no external assets, safe to open from disk. */
+export function renderDeliveryHtml(report) {
+    const rows = report.checks
+        .map(check => {
+        const source = check.type === 'structural' ? 'structural' : check.source;
+        return `      <tr class="row-${check.status}">
+        <td>${escapeHtml(check.model)}</td>
+        <td>${escapeHtml(check.type)}</td>
+        <td>${escapeHtml(source)}</td>
+        <td>${statusBadge(check.status)}</td>
+        <td>${escapeHtml(describeCheck(check))}</td>
+      </tr>`;
+    })
+        .join('\n');
+    const modelRows = report.models
+        .map(m => `      <tr>
+        <td>${escapeHtml(m.path)}</td>
+        <td><code>${escapeHtml(m.sha256 ?? '')}</code></td>
+        <td>${m.loadError ? `<span class="badge badge-error">ERROR</span> ${escapeHtml(m.loadError)}` : 'OK'}</td>
+      </tr>`)
+        .join('\n');
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>IFC Delivery Check Report</title>
+<style>
+  body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; margin: 2rem; color: #1a1a1a; }
+  h1 { font-size: 1.4rem; }
+  .verdict { font-size: 1.1rem; font-weight: 600; padding: 0.5rem 1rem; border-radius: 4px; display: inline-block; }
+  .verdict-pass { background: #e6f4ea; color: #1e7e34; }
+  .verdict-fail { background: #fce8e6; color: #c5221f; }
+  table { border-collapse: collapse; width: 100%; margin-top: 1rem; }
+  th, td { border: 1px solid #ddd; padding: 0.4rem 0.6rem; text-align: left; font-size: 0.9rem; }
+  th { background: #f5f5f5; }
+  .badge { display: inline-block; padding: 0.1rem 0.5rem; border-radius: 3px; font-size: 0.75rem; font-weight: 600; }
+  .badge-pass { background: #e6f4ea; color: #1e7e34; }
+  .badge-fail { background: #fce8e6; color: #c5221f; }
+  .badge-error { background: #fef7e0; color: #8a6d00; }
+  .row-error td { background: #fffdf5; }
+</style>
+</head>
+<body>
+  <h1>IFC Delivery Check Report</h1>
+  <p><strong>Tool:</strong> ${escapeHtml(report.tool.name)} ${escapeHtml(report.tool.version)}<br>
+     <strong>Recipe:</strong> <code>${escapeHtml(report.recipe)}</code></p>
+  <p class="verdict verdict-${report.verdict}">Verdict: ${report.verdict.toUpperCase()}</p>
+  <p>${report.summary.pass} pass, ${report.summary.fail} fail, ${report.summary.error} error (of ${report.summary.total} check(s))</p>
+
+  <h2>Models</h2>
+  <table>
+    <thead><tr><th>Path</th><th>SHA-256</th><th>Status</th></tr></thead>
+    <tbody>
+${modelRows}
+    </tbody>
+  </table>
+
+  <h2>Checks</h2>
+  <table>
+    <thead><tr><th>Model</th><th>Type</th><th>Source</th><th>Status</th><th>Evidence</th></tr></thead>
+    <tbody>
+${rows}
+    </tbody>
+  </table>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=delivery-report.js.map