@specverse/engines 4.1.15 → 4.1.17

package/dist/inference/verification.js

@@ -0,0 +1,482 @@
+/**
+ * L3 Verification Runner
+ *
+ * Runs the Quint-transpiled guards against a spec snapshot and reports
+ * pass / fail / skipped. A guard is skipped when any of its state-var
+ * dependencies is missing from the snapshot — a raw (pre-inference)
+ * spec, for example, won't have `inferredControllers`, so guards that
+ * need it are skipped rather than failed.
+ *
+ * Usage:
+ *   const result = await verifySpec(parsedSpec, { entitiesDir });
+ *   if (result.failed.length > 0) process.exit(1);
+ *
+ * The caller is responsible for deciding what "the spec" is — raw,
+ * inferred, or something else. `verifySpec` runs whichever guards are
+ * applicable.
+ */
+import { createRequire } from 'module';
+import { dirname, join } from 'path';
+import { transpileEntityGuards, extractStateVariables, generateGuardsModule } from './quint-transpiler.js';
+/**
+ * Build a Quint-shaped snapshot from a SpecVerse AST.
+ *
+ * The AST nests collections under `components` and uses shorthand
+ * strings for relationships and convention-format attributes. The
+ * guards were written against a flatter, more structured shape — each
+ * top-level state var (`models`, `controllers`, etc.) is an array of
+ * entities, and each entity's nested collections (`attributes`,
+ * `relationships`, …) are keyed maps.
+ *
+ * This function performs the normalization. The caller passes any spec
+ * (raw or inferred); only keys actually present in the spec are
+ * populated in the returned snapshot.
+ */
+export function buildSnapshot(spec, stateVars) {
+    const toArray = (v) => {
+        if (!v)
+            return [];
+        if (Array.isArray(v))
+            return v;
+        return Object.entries(v).map(([name, data]) => {
+            if (data && typeof data === 'object')
+                return { name, ...data };
+            return { name, value: data };
+        });
+    };
+    const toKeyedMap = (v) => {
+        if (!v)
+            return {};
+        if (Array.isArray(v)) {
+            const out = {};
+            for (const item of v) {
+                const key = item?.name || item?.id;
+                if (key)
+                    out[key] = item;
+            }
+            return out;
+        }
+        return v;
+    };
+    // Parse shorthand relationship strings into structured objects so
+    // Quint guards that read `.relType` and `.targetModel` work on raw
+    // specs too. Examples:
+    //   "hasMany Component"               → {relType, targetModel}
+    //   "hasMany Post cascade"            → + {cascade: true}
+    //   "manyToMany Tag through=TagLink"  → + {through: "TagLink"}
+    //   "belongsTo User"                  → {relType, targetModel}
+    const parseRelationshipShorthand = (s, name) => {
+        const parts = s.trim().split(/\s+/);
+        const relType = parts[0];
+        const targetModel = parts[1];
+        const rest = parts.slice(2);
+        const obj = { name, relType, targetModel };
+        for (const token of rest) {
+            if (token.includes('=')) {
+                const [k, v] = token.split('=');
+                obj[k] = v;
+            }
+            else {
+                obj[token] = true;
+            }
+        }
+        return obj;
+    };
+    const normalizeRelationships = (rels) => {
+        if (!rels)
+            return {};
+        const result = {};
+        const entries = Array.isArray(rels)
+            ? rels.map((r) => [r.name, r])
+            : Object.entries(rels);
+        for (const [name, value] of entries) {
+            if (typeof value === 'string') {
+                result[name] = parseRelationshipShorthand(value, name);
+            }
+            else if (value && typeof value === 'object') {
+                // The parser stores structured relationships as { type, target }
+                // (e.g. { name: 'components', type: 'hasMany', target: 'Component' }).
+                // Quint invariants read them as { relType, targetModel }. Map
+                // between the two so guards can run against the parsed shape.
+                const relType = value.relType ?? value.type;
+                const targetModel = value.targetModel ?? value.target;
+                result[name] = { ...value, name, relType, targetModel };
+            }
+        }
+        return result;
+    };
+    const MODEL_NESTED = ['attributes', 'lifecycles', 'behaviors', 'profiles'];
+    // relationships handled specially so shorthand strings get parsed
+    const CONTROLLER_NESTED = ['endpoints', 'actions', 'operations'];
+    const SERVICE_NESTED = ['operations'];
+    const EVENT_NESTED = ['attributes'];
+    const VIEW_NESTED = ['layouts', 'uiComponents'];
+    const DEPLOYMENT_NESTED = ['instances'];
+    const normalizeEntity = (entity, keys) => {
+        if (!entity || typeof entity !== 'object')
+            return entity;
+        const out = { ...entity };
+        for (const k of keys)
+            if (k in out)
+                out[k] = toKeyedMap(out[k]);
+        // Relationships need their own normalization to parse shorthand strings.
+        if ('relationships' in out)
+            out.relationships = normalizeRelationships(out.relationships);
+        return out;
+    };
+    const normList = (arr, keys) => arr.map(e => normalizeEntity(e, keys));
+    // Field aliases and derivations: convenience flags the Quint specs
+    // use that are simple views of data already in the spec. These are
+    // NOT synthesizing new information — they expose existing data
+    // under Quint's field naming.
+    /**
+     * Parser stores lifecycle states as a flat array of strings for the
+     * shorthand form (`flow: "draft -> open -> closed"` → `states: ['draft',
+     * 'open', 'closed']`). Quint invariants expect structured
+     * LifecycleState records with `isInitial` / `isTerminal` flags. The
+     * shorthand form always makes the first state initial and the last
+     * terminal by convention, so we synthesize the structure here.
+     */
+    const structureLifecycle = (lc) => {
+        if (!lc || typeof lc !== 'object')
+            return { name: '', states: [], transitions: [] };
+        const rawStates = Array.isArray(lc.states) ? lc.states : [];
+        const structuredStates = rawStates.map((s, i) => {
+            if (typeof s === 'string') {
+                return { name: s, isInitial: i === 0, isTerminal: i === rawStates.length - 1 };
+            }
+            // Already structured — pass through, filling in flags if missing
+            return {
+                isInitial: false,
+                isTerminal: false,
+                ...s,
+            };
+        });
+        // Transitions: if the lifecycle has a `flow` shorthand, derive
+        // `from`/`to` pairs for adjacent states.
+        let structuredTransitions = [];
+        if (Array.isArray(lc.transitions) && lc.transitions.length > 0 && typeof lc.transitions[0] === 'object') {
+            structuredTransitions = lc.transitions;
+        }
+        else if (rawStates.length > 1) {
+            structuredTransitions = [];
+            for (let i = 0; i < rawStates.length - 1; i++) {
+                const from = typeof rawStates[i] === 'string' ? rawStates[i] : rawStates[i].name;
+                const to = typeof rawStates[i + 1] === 'string' ? rawStates[i + 1] : rawStates[i + 1].name;
+                structuredTransitions.push({ name: `${from}_to_${to}`, from, to });
+            }
+        }
+        return {
+            ...lc,
+            states: structuredStates,
+            transitions: structuredTransitions,
+        };
+    };
+    const aliasModelFields = (m) => {
+        const lifecycleEntries = m.lifecycles && typeof m.lifecycles === 'object'
+            ? Object.values(m.lifecycles)
+            : [];
+        const firstLifecycle = lifecycleEntries[0];
+        return {
+            ...m,
+            hasLifecycle: lifecycleEntries.length > 0,
+            lifecycle: firstLifecycle
+                ? structureLifecycle(firstLifecycle)
+                : { name: '', states: [], transitions: [] },
+        };
+    };
+    const aliasViewFields = (v) => ({
+        ...v,
+        // Parser stores `type` (matches YAML `type: list`), Quint uses
+        // `viewType` to avoid keyword collision. Keep both.
+        viewType: v.viewType ?? v.type,
+    });
+    // Collect top-level + component-nested entities for each state var.
+    // Only populate keys where the spec actually has data; leave others
+    // unset so the verification runner can skip dependent guards.
+    //
+    // When flattening, tag each entity with `.component` (the parent
+    // component name) and `.system` (true for entities under
+    // build-system / AI / tooling components — these are meta-models
+    // describing the language itself and don't need runtime controllers).
+    const SYSTEM_COMPONENT_PATTERN = /^(BuildSystem|ToolsSupport|AISupport|Tooling|MetaModel)/i;
+    const snapshot = {};
+    const componentList = spec?.components
+        ? (Array.isArray(spec.components) ? spec.components : Object.entries(spec.components).map(([name, data]) => ({ name, ...(data || {}) })))
+        : [];
+    const tagWithComponent = (item, componentName) => {
+        if (!item || typeof item !== 'object')
+            return item;
+        const isSystem = SYSTEM_COMPONENT_PATTERN.test(componentName);
+        return { component: componentName, system: isSystem, ...item };
+    };
+    for (const v of stateVars) {
+        const topLevel = toArray(spec?.[v]);
+        const nested = [];
+        for (const comp of componentList) {
+            const val = comp?.[v];
+            if (val) {
+                const compName = comp?.name || '';
+                for (const item of toArray(val)) {
+                    nested.push(tagWithComponent(item, compName));
+                }
+            }
+        }
+        if (topLevel.length > 0 || nested.length > 0) {
+            snapshot[v] = [...topLevel, ...nested];
+        }
+    }
+    // `components` is its own state var, populated from the list
+    if (stateVars.includes('components') && componentList.length > 0) {
+        snapshot.components = componentList;
+    }
+    // Normalize per-entity nested collections
+    if (snapshot.models)
+        snapshot.models = normList(snapshot.models, MODEL_NESTED).map(aliasModelFields);
+    if (snapshot.controllers)
+        snapshot.controllers = normList(snapshot.controllers, CONTROLLER_NESTED);
+    if (snapshot.services)
+        snapshot.services = normList(snapshot.services, SERVICE_NESTED);
+    if (snapshot.events)
+        snapshot.events = normList(snapshot.events, EVENT_NESTED);
+    if (snapshot.views)
+        snapshot.views = normList(snapshot.views, VIEW_NESTED).map(aliasViewFields);
+    if (snapshot.deployments)
+        snapshot.deployments = normList(snapshot.deployments, DEPLOYMENT_NESTED);
+    // `inferredControllers` / `inferredServices` are Quint internal aliases
+    // for inference output. Populate them only when the respective
+    // non-inferred collection is present AND non-empty — this is the
+    // signal that inference (or a user writing the expanded form) has run.
+    if (stateVars.includes('inferredControllers') && snapshot.controllers?.length) {
+        snapshot.inferredControllers = snapshot.controllers;
+    }
+    if (stateVars.includes('inferredServices') && snapshot.services?.length) {
+        snapshot.inferredServices = snapshot.services;
+    }
+    return snapshot;
+}
+/**
+ * Scan a guard body for `<loopVar>.<field>` accesses that are bound to
+ * a state-var collection (e.g. `c.depth` inside `commands.forall(c => ...)`).
+ * For each such field, check whether it's populated on AT LEAST ONE
+ * entity in the relevant snapshot collection. Return the fields that
+ * aren't populated anywhere — those are the reason to skip the guard.
+ *
+ * This is a best-effort heuristic; it only catches the common case
+ * where a Quint invariant references a field the runtime data doesn't
+ * populate (typically fields added by inference that a raw spec lacks).
+ */
+function findUnusableFields(guard, snapshot) {
+    const quint = guard.quint || '';
+    // Find forall / exists / filter / map bindings: e.g. `commands.forall(c => ...)`
+    // produces the binding `c -> commands`. We scan for `<stateVar>.<op>(<var> =>`
+    // and then look for `<var>.<field>` accesses elsewhere in the body.
+    const bindingRe = /(\w+)\.(?:forall|exists|filter|map|flatMap)\(\s*(\w+)\s*=>/g;
+    const bindings = new Map(); // var → state var name
+    let m;
+    while ((m = bindingRe.exec(quint)) !== null) {
+        const [, stateVar, varName] = m;
+        if (guard.dependencies.includes(stateVar) && !bindings.has(varName)) {
+            bindings.set(varName, stateVar);
+        }
+    }
+    if (bindings.size === 0)
+        return [];
+    const missing = new Set();
+    for (const [varName, stateVar] of bindings) {
+        const fieldRe = new RegExp(`\\b${varName}\\.(\\w+)`, 'g');
+        const fields = new Set();
+        let fm;
+        while ((fm = fieldRe.exec(quint)) !== null) {
+            // Skip methods (followed by `(`)
+            const after = quint[fm.index + fm[0].length];
+            if (after === '(')
+                continue;
+            fields.add(fm[1]);
+        }
+        const collection = snapshot[stateVar] || [];
+        for (const field of fields) {
+            const anyHas = collection.some(item => item && typeof item === 'object' && field in item);
+            if (!anyHas)
+                missing.add(field);
+        }
+    }
+    return [...missing].sort();
+}
+/**
+ * Resolve the entities source directory when not explicitly provided.
+ */
+function resolveEntitiesDir() {
+    const req = createRequire(import.meta.url);
+    const pkgPath = req.resolve('@specverse/entities/package.json');
+    return join(dirname(pkgPath), 'src');
+}
+/**
+ * Run the L3 verification gate against the provided spec.
+ *
+ * `spec` can be any SpecVerse AST — raw, inferred, or anywhere in
+ * between. Only guards whose dependencies are present in the
+ * resulting snapshot run; the rest are reported as skipped.
+ */
+export async function verifySpec(spec, opts = {}) {
+    const entitiesDir = opts.entitiesDir || resolveEntitiesDir();
+    const guards = transpileEntityGuards(entitiesDir);
+    const stateVars = extractStateVariables(entitiesDir);
+    // Deduplicate guards by (kind, name) to match generateGuardsModule
+    const seen = new Set();
+    const uniqueGuards = guards.filter(g => {
+        const key = `${g.kind}:${g.name}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    // Build the snapshot — caller can override which vars are "available"
+    // by passing an explicit availableVars list, but by default we derive
+    // it from what buildSnapshot populates.
+    const snapshot = buildSnapshot(spec, stateVars);
+    const availableVars = new Set(opts.availableVars || Object.keys(snapshot));
+    const invariants = uniqueGuards.filter(g => g.kind === 'invariant');
+    const failed = [];
+    const skipped = [];
+    const errors = [];
+    let passed = 0;
+    // Partition: which guards can run against this snapshot?
+    // A guard is runnable when (a) all its state-var dependencies are in
+    // the snapshot AND (b) for every `<loopVar>.<field>` access in its
+    // body, that field exists on at least one entity of the relevant
+    // state var. This second check catches cases like `c.depth <= 3`
+    // where the field is populated only by inference — on a raw spec,
+    // the guard would silently return false from `undefined <= 3`, which
+    // is a data-completeness issue, not an invariant violation.
+    const runnable = [];
+    for (const g of invariants) {
+        const missingVars = g.dependencies.filter(d => !availableVars.has(d));
+        if (missingVars.length > 0) {
+            skipped.push({ name: g.name, entity: g.entity, missingDeps: missingVars });
+            continue;
+        }
+        const missingFields = findUnusableFields(g, snapshot);
+        if (missingFields.length > 0) {
+            skipped.push({ name: g.name, entity: g.entity, missingDeps: missingFields.map(f => `field ${f}`) });
+            continue;
+        }
+        runnable.push(g);
+    }
+    if (runnable.length === 0) {
+        return { total: invariants.length, passed: 0, failed, skipped, errors };
+    }
+    // Transpile guards to a runnable module — only the ones we need, so
+    // state vars filter down naturally.
+    const guardsCode = generateGuardsModule(runnable, stateVars);
+    const esbuild = await import('esbuild');
+    const compiled = esbuild.transformSync(guardsCode, {
+        loader: 'ts',
+        format: 'esm',
+        target: 'es2022',
+    }).code;
+    const dataUrl = 'data:text/javascript;base64,' + Buffer.from(compiled).toString('base64');
+    const mod = await import(dataUrl);
+    if (typeof mod.setSpecSnapshot === 'function') {
+        mod.setSpecSnapshot(snapshot);
+    }
+    // Classify errors: a thrown exception from undefined field access
+    // (e.g. `.every` on undefined, `.X` on undefined, `X is not a function`
+    // on a missing array method) means the guard expected a field the
+    // spec doesn't have. Report it as "skipped — data-completeness",
+    // not as a transpiler error.
+    const classifyError = (msg) => {
+        if (/Cannot read properties of (undefined|null)/.test(msg) ||
+            /\bof undefined\b/.test(msg) ||
+            /Cannot convert undefined or null to object/.test(msg) ||
+            / is not a function\b/.test(msg)) {
+            const field = msg.match(/reading '([^']+)'/)?.[1]
+                || msg.match(/\b(\w+) is not a function/)?.[1];
+            return { isShape: true, field };
+        }
+        return { isShape: false };
+    };
+    for (const g of runnable) {
+        const fn = mod[`check_${g.name}`];
+        if (typeof fn !== 'function')
+            continue;
+        try {
+            const ok = fn();
+            if (ok === false) {
+                failed.push({
+                    name: g.name,
+                    entity: g.entity,
+                    module: g.module,
+                    quint: g.quint,
+                });
+            }
+            else {
+                passed++;
+            }
+        }
+        catch (e) {
+            const msg = e.message || String(e);
+            const cls = classifyError(msg);
+            if (cls.isShape) {
+                skipped.push({
+                    name: g.name,
+                    entity: g.entity,
+                    missingDeps: cls.field ? [`field ${cls.field}`] : ['undefined field'],
+                });
+            }
+            else {
+                errors.push({ name: g.name, entity: g.entity, message: msg });
+            }
+        }
+    }
+    return {
+        total: invariants.length,
+        passed,
+        failed,
+        skipped,
+        errors,
+    };
+}
+/**
+ * Format a verification result for CLI output.
+ */
+export function formatVerificationResult(result, verbose = false) {
+    const lines = [];
+    const applicable = result.passed + result.failed.length + result.errors.length;
+    lines.push(`L3 verification: ${result.passed}/${applicable} invariants hold`);
+    if (result.skipped.length > 0) {
+        lines.push(`  ${result.skipped.length} skipped (not applicable to this spec)`);
+    }
+    if (result.failed.length > 0) {
+        lines.push(`  ${result.failed.length} failed:`);
+        const toShow = verbose ? result.failed : result.failed.slice(0, 10);
+        for (const f of toShow) {
+            lines.push(`    ✗ ${f.entity}/${f.name}`);
+            if (verbose && f.quint) {
+                const first = f.quint.split('\n')[0].slice(0, 120);
+                lines.push(`        ${first}`);
+            }
+        }
+        if (!verbose && result.failed.length > 10) {
+            lines.push(`    ...and ${result.failed.length - 10} more`);
+        }
+    }
+    if (result.errors.length > 0) {
+        lines.push(`  ${result.errors.length} errored (shape mismatch):`);
+        const toShow = verbose ? result.errors : result.errors.slice(0, 5);
+        for (const e of toShow) {
+            lines.push(`    ⚠ ${e.entity}/${e.name}: ${e.message}`);
+        }
+        if (!verbose && result.errors.length > 5) {
+            lines.push(`    ...and ${result.errors.length - 5} more`);
+        }
+    }
+    if (verbose && result.skipped.length > 0) {
+        lines.push('  skipped guards:');
+        for (const s of result.skipped) {
+            lines.push(`    - ${s.entity}/${s.name} (needs: ${s.missingDeps.join(', ')})`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=verification.js.map

package/dist/inference/verification.js.map

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

package/dist/libs/instance-factories/cli/templates/commander/command-generator.js

@@ -20,7 +20,7 @@ function generateCommand(context) {
     const flagType = flag.type?.toLowerCase();
     const valuePart = flagType === "boolean" ? "" : ` <${flagName.replace(/^--/, "")}>`;
     const defaultVal = flag.default !== void 0 ? `, ${commanderDefault(flag.default, flagType)}` : "";
-    const desc = flag.description || `${flagName} option`;
+    const desc = escapeSingleQuotes(flag.description || `${flagName} option`);
     return `    .option('${alias}${flagName}${valuePart}', '${desc}'${defaultVal})`;
   });
   const optionTypes = Object.entries(flags).map(([flagName, flag]) => {
@@ -123,6 +123,27 @@ import type { ParserEngine } from '@specverse/types';`,
             console.warn('Warnings:');
             result.warnings.forEach((w: string) => console.warn(' ', w));
           }
+        }
+
+        // L3 verification \u2014 opt-in via --verify flag. Runs the
+        // transpiled Quint guards against the parsed spec. Guards
+        // whose state-var dependencies aren't present in this spec
+        // are reported as skipped (not failed).
+        if (options.verify) {
+          try {
+            const { verifySpec, formatVerificationResult } = await import('@specverse/engines/inference');
+            const verification = await verifySpec(result.ast);
+            if (options.json) {
+              console.log(JSON.stringify({ valid: true, verification }, null, 2));
+            } else {
+              console.log('');
+              console.log(formatVerificationResult(verification, options.verbose));
+            }
+            if (verification.failed.length > 0) process.exit(1);
+          } catch (ve: any) {
+            console.error('Verification error:', ve.message);
+            process.exit(1);
+          }
         }`
   },
   infer: {
@@ -862,7 +883,7 @@ function generateLeafCommand(name, description, commandStr, optionDefs, actionPa
   const finalActionParams = renameUnusedActionParams(actionParams, handler);
   return `program
     .command('${commandStr}')
-    .description('${description}')
+    .description('${escapeSingleQuotes(description)}')
 ${optionDefs.join("\n")}
     .action(async (${finalActionParams}) => {
       try {
@@ -873,6 +894,9 @@ ${optionDefs.join("\n")}
       }
     });`;
 }
+function escapeSingleQuotes(s) {
+  return s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
 function commanderDefault(value, flagType) {
   if (flagType === "boolean") return JSON.stringify(Boolean(value));
   if (typeof value === "number") return JSON.stringify(String(value));
@@ -903,7 +927,8 @@ function generateCommandWithSubcommands(name, description, subcommands, optionDe
       const flagType = flag.type?.toLowerCase();
       const valuePart = flagType === "boolean" ? "" : ` <${flagName.replace(/^--/, "")}>`;
       const defaultVal = flag.default !== void 0 ? `, ${commanderDefault(flag.default, flagType)}` : "";
-      return `    .option('${alias}${flagName}${valuePart}', '${flag.description || flagName}'${defaultVal})`;
+      const desc = escapeSingleQuotes(flag.description || flagName);
+      return `    .option('${alias}${flagName}${valuePart}', '${desc}'${defaultVal})`;
     });
     const handlerKey = `${name}.${subName}`;
     const engineHandler = ENGINE_HANDLERS[handlerKey];
@@ -914,7 +939,7 @@ function generateCommandWithSubcommands(name, description, subcommands, optionDe
     return `
   cmd
     .command('${subCmdStr}')
-    .description('${subDesc}')
+    .description('${escapeSingleQuotes(subDesc)}')
 ${subOptionDefs.join("\n")}
     .action(async (${finalSubActionParams}) => {
       try {
@@ -927,7 +952,7 @@ ${subOptionDefs.join("\n")}
   });
   return `const cmd = program
     .command('${name}')
-    .description('${description}');
+    .description('${escapeSingleQuotes(description)}');
 ${subcmdRegistrations.join("\n")}`;
 }
 function generateSubcommandRegistrations(_parentName, _subcommands) {

package/dist/realize/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realize/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMlE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AASnF,cAAM,sBAAuB,YAAW,aAAa;IACnD,IAAI,SAAa;IACjB,OAAO,SAAW;IAClB,YAAY,WAA+E;IAE3F,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAS;IAEtB,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjB,OAAO,IAAI,UAAU;IAIrB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG;IAK1B,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;IAKvF;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAklB9F;;;OAGG;YACW,UAAU;IAwDxB,OAAO,CAAC,oBAAoB;CAuB7B;AAED,eAAO,MAAM,MAAM,wBAA+B,CAAC;AACnD,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realize/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMlE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AASnF,cAAM,sBAAuB,YAAW,aAAa;IACnD,IAAI,SAAa;IACjB,OAAO,SAAW;IAClB,YAAY,WAA+E;IAE3F,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAS;IAEtB,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjB,OAAO,IAAI,UAAU;IAIrB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG;IAK1B,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;IAKvF;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAskB9F;;;OAGG;YACW,UAAU;IAwDxB,OAAO,CAAC,oBAAoB;CAuB7B;AAED,eAAO,MAAM,MAAM,wBAA+B,CAAC;AACnD,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/realize/index.js

@@ -68,6 +68,10 @@ class SpecVerseRealizeEngine {
         const files = [];
         const errors = [];
         const allModels = Object.values(spec.models || {});
+        // L3 verification (Quint guards) is NOT run here. It lives in
+        // `validate --verify` so users can opt into it explicitly and run
+        // it on any spec — raw or inferred — without also generating code.
+        // See engines/src/inference/verification.ts.
         const writeOutput = (output) => {
             // A generator can signal "skip this file" by returning an empty string.
             if (output.code === '')
@@ -529,32 +533,11 @@ export default {
                 errors.push(`SharedUtils: ${e.message}`);
             }
         }
-        // 9b. Runtime guards — transpiled from Quint specifications.
-        // Only emit when the manifest declares a backend; a frontend-only
-        // layout has no `backend/src/` to write into.
-        const hasBackendForGuards = !!(tryResolve('service.controller') || tryResolve('api.rest') || tryResolve('orm.schema'));
-        if (hasBackendForGuards) {
-            try {
-                const { transpileEntityGuards, generateGuardsModule } = await import('../inference/index.js');
-                const { createRequire } = await import('module');
-                const req = createRequire(import.meta.url);
-                const entitiesPkg = req.resolve('@specverse/entities/package.json');
-                const entitiesSrc = join(dirname(entitiesPkg), 'src');
-                const guards = transpileEntityGuards(entitiesSrc);
-                if (guards.length > 0) {
-                    const guardsCode = generateGuardsModule(guards);
-                    const guardsPath = join(outputDir, 'backend', 'src', 'guards.ts');
-                    const guardsDir = dirname(guardsPath);
-                    if (!existsSync(guardsDir))
-                        mkdirSync(guardsDir, { recursive: true });
-                    writeFileSync(guardsPath, guardsCode);
-                    console.log(`   ✅ Runtime guards: ${guards.length} guards (${guards.filter((g) => g.kind === 'function').length} functions, ${guards.filter((g) => g.kind === 'invariant').length} invariants) from Quint specs`);
-                }
-            }
-            catch (e) {
-                errors.push(`Guards: ${e.message}`);
-            }
-        }
+        // 9b. Quint guards are no longer emitted to the generated backend.
+        // They are L3 verification assertions about the SPEC, not runtime
+        // checks on the user's data — so they run at realize time (see the
+        // L3 verification gate at the start of realizeAll) and don't ship
+        // to the user's project.
         // 10. CLI commands (Commander.js)
         try {
             const cliDir = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'libs', 'instance-factories', 'cli', 'templates', 'commander');