@cavelang/solver 0.27.14 → 0.29.1

package/Authors.md

@@ -0,0 +1,5 @@
+# Authors
+
+By adding their name to this file, all listed authors confirm they have copyright over their contributions to this project and are waiving these rights, placing their work in the public domain in accordance with the CC0 1.0 Universal Public Domain Dedication.
+
+- Mirek Rusin (Switzerland)

package/License.md

@@ -1,8 +1,6 @@
 # CC0 1.0 Universal (CC0 1.0) Public Domain Dedication
 
-To the extent possible under law, the authors listed in the repository's
-`Authors.md` have waived all copyright and related or neighboring rights to
-this software and associated documentation files (the "Software").
+To the extent possible under law, the authors listed in [Authors.md](./Authors.md) have waived all copyright and related or neighboring rights to this software and associated documentation files (the "Software").
 
-For more information, see:
+For more information, please see:
 https://creativecommons.org/publicdomain/zero/1.0/

package/README.md

@@ -6,7 +6,7 @@ resource limits; canonical model digests; result states; and linear-subset
 recognition. It does not depend on Z3, HiGHS, SQLite, or another CAVE package.
 
 ```ts
-import { Adapter, Model, Solve } from '@cavelang/solver'
+import { Adapter, Explain, Model, Solve } from '@cavelang/solver'
 
 const model: Model.t = {
   schema: Model.schema,
@@ -93,3 +93,97 @@ only then invokes it. Results are disjoint:
 A feasible assignment returned after an optimization timeout is `unknown`,
 not `optimal`. A timeout or unsupported capability is never rendered as proof
 that the model is infeasible.
+
+## Provenance and explanations
+
+Variables, constraints, soft constraints, and objectives may carry a stable
+declaration URI/line/column, exact CAVE evidence row IDs, and scenario input
+IDs. These fields and human descriptions never affect the canonical model
+digest.
+
+`Solve.runWithExplanation` wraps any adapter result in versioned, plain JSON.
+The report records the canonical digest, backend/version, resolved limits,
+diagnostics, optional frozen snapshot and authored inputs, assignments,
+evaluated hard and soft constraints, objective contributions, or a mapped
+unsatisfiable core. Cores are explicitly not promised minimal and `unknown`
+keeps its structured reason.
+
+```ts
+const report = await Solve.runWithExplanation(adapter, model, {
+  unsatCore: true,
+  limits: { timeoutMs: 2_000 }
+}, {
+  snapshot: { transactionTime: '019c…', validTime: '2026-08-01' },
+  inputs: [{
+    id: 'team-size',
+    query: 'system HAS team-size: ?n',
+    value: { kind: 'integer', value: '12', unit: 'people' },
+    authoredValue: '0.012K people',
+    evidenceRowIds: ['019c…'],
+    scenarioClaimIds: []
+  }]
+})
+
+process.stdout.write(Explain.render(report))
+```
+
+The renderer is a deterministic human view over the same JSON report. Neither
+building nor rendering an explanation writes to the CAVE store.
+
+## Backend evaluations
+
+Z3 is the only shipped adapter. The [MiniZinc](MINIZINC-EVALUATION.md) and
+[direct HiGHS](HIGHS-EVALUATION.md) evaluations record why neither candidate
+currently crosses the portable boundary. MiniZinc lacks a motivating
+solver-neutral finite-domain schema. HiGHS materially outperforms Z3 on
+representative LP/MIP workloads and is much smaller, but its synchronous
+binary64 wrapper cannot yet honor CAVE's exact-result, cancellation, and
+working-memory contracts.
+
+## Verification workflows
+
+`Workflow` gives feasibility, optimization, counterexample, and bounded
+sensitivity distinct public semantics while keeping one validated model,
+snapshot context, adapter limits, and result vocabulary.
+
+```ts
+import { Workflow } from '@cavelang/solver'
+
+const feasible = await Workflow.feasibility(adapter, model, {
+  limits: { timeoutMs: 2_000 }
+}, context)
+
+const best = await Workflow.optimization(adapter, model, {}, context)
+const witness = await Workflow.counterexample(
+  adapter, model, 'declared-invariant-id', {}, context
+)
+const boundary = await Workflow.sensitivity(adapter, model, {
+  variableId: 'team-size',
+  samples: [
+    { sort: 'int', value: '4' },
+    { sort: 'int', value: '8' },
+    { sort: 'int', value: '12' }
+  ],
+  observe: ['architecture'],
+  operation: 'optimization',
+  maxRuns: 3
+}, {}, context)
+```
+
+Workflows require every real variable to have explicit lower and upper bounds.
+Sensitivity accepts an explicit, typed sample list and refuses more than
+`maxRuns` checks. Its report includes adjacent result transitions and
+contiguous `unknown` regions rather than interpolating across timeouts.
+
+Backend model choices are made deterministic with lexicographic objectives in
+stable variable-ID order: false before true, smaller exact numbers first, and
+enum values in lexical order. In optimization, authored objectives retain
+their declared order, explicitly weighted soft constraints follow, and the
+tie-break objectives come last. These generated objectives count against
+`maxObjectives`; the workflow fails preflight rather than silently dropping
+determinism. A merely feasible backend result is never promoted to `optimal`.
+
+Counterexample checks replace one declared invariant with its negation. A
+model is a concrete witness; an unsatisfied result means only that the
+invariant holds within the report's named assumptions, bounded domains, and
+declared Boolean/integer/rational/enum theories. `unknown` remains unknown.

package/dist/src/explain.d.ts

@@ -0,0 +1,106 @@
+import type { Backend, Diagnostic, Limits, Result, UnknownReason } from './adapter.ts';
+import * as Exact from './exact.ts';
+import type { Declaration, Model, Value } from './model.ts';
+export declare const schema: "cave.solver/explanation@1";
+export type Json = null | boolean | number | string | readonly Json[] | {
+    readonly [key: string]: Json | undefined;
+};
+export type Snapshot = {
+    readonly transactionTime: string | null;
+    readonly validTime?: string;
+    readonly aliases?: 'exact' | 'closure';
+    readonly resolution?: 'coexisting' | 'winner';
+    readonly minimumConfidence?: number;
+};
+export type Input = {
+    readonly id: string;
+    readonly query?: string;
+    readonly value?: Json;
+    readonly authoredValue?: Json;
+    readonly evidenceRowIds: readonly string[];
+    readonly scenarioClaimIds: readonly string[];
+};
+export type Scenario = {
+    readonly id: string;
+    readonly inputDigest: string;
+    readonly overlayDigest: string;
+};
+export type Context = {
+    /** Reject accidentally replaying bindings against a different model. */
+    readonly modelDigest?: string;
+    readonly scenario?: Scenario;
+    readonly snapshot?: Snapshot;
+    readonly inputs?: readonly Input[];
+};
+export type Run = {
+    readonly modelDigest: string;
+    readonly backend: Backend;
+    readonly elapsedMs: number;
+    readonly limits: Limits;
+    readonly diagnostics: readonly Diagnostic[];
+    readonly scenario?: Scenario;
+    readonly snapshot?: Snapshot;
+    readonly inputs: readonly Input[];
+};
+export type Element = {
+    readonly id: string;
+    readonly description?: string;
+    readonly declaration?: Declaration;
+    readonly evidenceRowIds: readonly string[];
+    readonly scenarioInputIds: readonly string[];
+};
+export type AssignmentValue = Element & {
+    /** False exposes an adapter value that has no matching model declaration. */
+    readonly declared: boolean;
+    readonly value: Value;
+};
+export type Constraint = Element & {
+    readonly evaluation: 'satisfied' | 'violated' | 'indeterminate';
+};
+export type SoftConstraintResult = Element & {
+    readonly evaluation: 'accepted' | 'violated' | 'indeterminate';
+    readonly weight: ReturnType<typeof Exact.rational>;
+};
+export type ObjectiveResult = Element & {
+    /** False exposes an adapter value that has no matching model declaration. */
+    readonly declared: boolean;
+    readonly direction: 'minimize' | 'maximize' | 'unknown';
+    readonly value: Value;
+    readonly bound?: Value;
+};
+export type CoreConstraint = Element & {
+    /** False means the backend returned an ID absent from the submitted model. */
+    readonly declared: boolean;
+};
+type Feasible = {
+    readonly assignments: readonly AssignmentValue[];
+    readonly hardConstraints: readonly Constraint[];
+    readonly softConstraints: readonly SoftConstraintResult[];
+};
+export type Outcome = ({
+    readonly status: 'satisfied';
+} & Feasible) | ({
+    readonly status: 'optimal';
+    readonly objectives: readonly ObjectiveResult[];
+    readonly optimalityProved: true;
+} & Feasible) | {
+    readonly status: 'unsatisfied';
+    readonly core?: readonly CoreConstraint[];
+    /** Solver cores explain one contradiction, but are not promised minimal. */
+    readonly coreMinimal: false;
+    readonly infeasibilityProved: true;
+} | {
+    readonly status: 'unknown';
+    readonly reason: UnknownReason;
+};
+export type Report = {
+    readonly schema: typeof schema;
+    readonly run: Run;
+    readonly outcome: Outcome;
+};
+/** Build stable JSON data without mutating the model, scenario, or CAVE store. */
+export declare const report: (model: Model, result: Result, limits: Limits, context?: Context) => Report;
+/** Render the same report as concise, deterministic plain text. */
+export declare const render: (value: Report) => string;
+export {};
+//# sourceMappingURL=explain.d.ts.map

package/dist/src/explain.d.ts.map

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

package/dist/src/explain.js

@@ -0,0 +1,256 @@
+import * as Canonical from "./canonical.js";
+import * as Exact from "./exact.js";
+export const schema = 'cave.solver/explanation@1';
+const compareText = (left, right) => left < right ? -1 : left > right ? 1 : 0;
+const normalize = (numerator, denominator) => {
+    if (denominator === 0n)
+        throw new TypeError('cannot explain division by zero');
+    const exact = Exact.rational({ numerator: String(numerator), denominator: String(denominator) });
+    return { kind: 'number', numerator: BigInt(exact.numerator), denominator: BigInt(exact.denominator) };
+};
+const number = (value) => {
+    const exact = Exact.rational(value);
+    return { kind: 'number', numerator: BigInt(exact.numerator), denominator: BigInt(exact.denominator) };
+};
+const numeric = (value) => {
+    if (value.kind !== 'number')
+        throw new TypeError(`expected a numeric explanation value, received ${value.kind}`);
+    return value;
+};
+const bool = (value) => {
+    if (value.kind !== 'bool')
+        throw new TypeError(`expected a Boolean explanation value, received ${value.kind}`);
+    return value.value;
+};
+const add = (left, right) => normalize(left.numerator * right.denominator + right.numerator * left.denominator, left.denominator * right.denominator);
+const multiply = (left, right) => normalize(left.numerator * right.numerator, left.denominator * right.denominator);
+const compare = (left, right) => {
+    const difference = left.numerator * right.denominator - right.numerator * left.denominator;
+    return difference < 0n ? -1 : difference > 0n ? 1 : 0;
+};
+const equal = (left, right) => {
+    if (left.kind === 'number' && right.kind === 'number')
+        return compare(left, right) === 0;
+    if (left.kind !== right.kind)
+        return false;
+    if (left.kind === 'bool' && right.kind === 'bool')
+        return left.value === right.value;
+    if (left.kind === 'enum' && right.kind === 'enum')
+        return left.domain === right.domain && left.value === right.value;
+    return false;
+};
+const assigned = (value) => {
+    switch (value.sort) {
+        case 'bool': return { kind: 'bool', value: value.value };
+        case 'int': return number({ numerator: value.value, denominator: '1' });
+        case 'real': return number({ numerator: value.numerator, denominator: value.denominator });
+        case 'enum': return { kind: 'enum', domain: value.domain, value: value.value };
+    }
+};
+const evaluate = (expression, assignment) => {
+    const run = (value) => evaluate(value, assignment);
+    switch (expression.kind) {
+        case 'literal':
+            switch (expression.sort) {
+                case 'bool': return { kind: 'bool', value: expression.value };
+                case 'int': return number({ numerator: String(Exact.integer(expression.value)), denominator: '1' });
+                case 'real': return number(expression.value);
+                case 'enum': return { kind: 'enum', domain: expression.domain, value: expression.value };
+            }
+        case 'variable': {
+            const value = assignment[expression.id];
+            if (value === undefined)
+                throw new TypeError(`assignment omits ${JSON.stringify(expression.id)}`);
+            return assigned(value);
+        }
+        case 'not': return { kind: 'bool', value: !bool(run(expression.value)) };
+        case 'and': return { kind: 'bool', value: expression.operands.every(value => bool(run(value))) };
+        case 'or': return { kind: 'bool', value: expression.operands.some(value => bool(run(value))) };
+        case 'implies': return { kind: 'bool', value: !bool(run(expression.left)) || bool(run(expression.right)) };
+        case 'eq': return { kind: 'bool', value: equal(run(expression.left), run(expression.right)) };
+        case 'neq': return { kind: 'bool', value: !equal(run(expression.left), run(expression.right)) };
+        case 'lt': return { kind: 'bool', value: compare(numeric(run(expression.left)), numeric(run(expression.right))) < 0 };
+        case 'lte': return { kind: 'bool', value: compare(numeric(run(expression.left)), numeric(run(expression.right))) <= 0 };
+        case 'gt': return { kind: 'bool', value: compare(numeric(run(expression.left)), numeric(run(expression.right))) > 0 };
+        case 'gte': return { kind: 'bool', value: compare(numeric(run(expression.left)), numeric(run(expression.right))) >= 0 };
+        case 'add': return expression.operands.map(run).map(numeric).reduce(add);
+        case 'multiply': return expression.operands.map(run).map(numeric).reduce(multiply);
+        case 'subtract': {
+            const left = numeric(run(expression.left));
+            const right = numeric(run(expression.right));
+            return add(left, normalize(-right.numerator, right.denominator));
+        }
+        case 'divide': {
+            const left = numeric(run(expression.left));
+            const right = numeric(run(expression.right));
+            return normalize(left.numerator * right.denominator, left.denominator * right.numerator);
+        }
+        case 'negate': {
+            const value = numeric(run(expression.value));
+            return normalize(-value.numerator, value.denominator);
+        }
+        case 'if': return bool(run(expression.condition)) ? run(expression.then) : run(expression.else);
+    }
+};
+const sorted = (values) => [...new Set(values ?? [])].sort();
+const element = (value) => ({
+    id: value.id,
+    ...(value.description === undefined ? {} : { description: value.description }),
+    ...(value.declaration === undefined ? {} : { declaration: value.declaration }),
+    evidenceRowIds: sorted(value.evidenceRowIds),
+    scenarioInputIds: sorted(value.scenarioInputIds)
+});
+const constraint = (value, assignment) => {
+    let evaluation = 'indeterminate';
+    try {
+        evaluation = bool(evaluate(value.expression, assignment)) ? 'satisfied' : 'violated';
+    }
+    catch { /* Keep the solver result usable when a backend uses totalized arithmetic. */ }
+    return { ...element(value), evaluation };
+};
+const softConstraint = (value, assignment) => ({
+    ...element(value),
+    evaluation: (() => {
+        try {
+            return bool(evaluate(value.expression, assignment)) ? 'accepted' : 'violated';
+        }
+        catch {
+            return 'indeterminate';
+        }
+    })(),
+    weight: Exact.rational(value.weight)
+});
+const assignments = (model, assignment) => {
+    const variables = new Map(model.variables.map(variable => [variable.id, variable]));
+    return Object.entries(assignment)
+        .sort(([left], [right]) => compareText(left, right))
+        .map(([id, value]) => {
+        const variable = variables.get(id);
+        return { ...element(variable ?? { id }), declared: variable !== undefined, value };
+    });
+};
+const feasible = (model, assignment) => ({
+    assignments: assignments(model, assignment),
+    hardConstraints: model.constraints.map(value => constraint(value, assignment)),
+    softConstraints: (model.softConstraints ?? []).map(value => softConstraint(value, assignment))
+});
+const objective = (declaration, result) => ({
+    ...element(declaration ?? { id: result.objectiveId }),
+    declared: declaration !== undefined,
+    direction: declaration?.direction ?? 'unknown',
+    value: result.value,
+    ...(result.bound === undefined ? {} : { bound: result.bound })
+});
+const outcome = (model, result) => {
+    switch (result.status) {
+        case 'satisfied': return { status: result.status, ...feasible(model, result.assignment) };
+        case 'optimal': {
+            const declarations = new Map((model.objectives ?? []).map(value => [value.id, value]));
+            return {
+                status: result.status,
+                ...feasible(model, result.assignment),
+                objectives: result.objectives.map(value => objective(declarations.get(value.objectiveId), value)),
+                optimalityProved: result.optimalityProved
+            };
+        }
+        case 'unsatisfied': {
+            const declarations = new Map(model.constraints.map(value => [value.id, value]));
+            return {
+                status: result.status,
+                ...(result.core === undefined ? {} : {
+                    core: result.core.map(id => {
+                        const declaration = declarations.get(id);
+                        return { ...element(declaration ?? { id }), declared: declaration !== undefined };
+                    })
+                }),
+                coreMinimal: false,
+                infeasibilityProved: result.infeasibilityProved
+            };
+        }
+        case 'unknown': return { status: result.status, reason: result.reason };
+    }
+};
+/** Build stable JSON data without mutating the model, scenario, or CAVE store. */
+export const report = (model, result, limits, context = {}) => {
+    const modelDigest = Canonical.digest(model);
+    if (context.modelDigest !== undefined && context.modelDigest !== modelDigest) {
+        throw new TypeError(`scenario model digest ${context.modelDigest} does not match ${modelDigest}`);
+    }
+    return {
+        schema,
+        run: {
+            modelDigest,
+            backend: result.backend,
+            elapsedMs: result.elapsedMs,
+            limits,
+            diagnostics: result.diagnostics,
+            ...(context.scenario === undefined ? {} : { scenario: context.scenario }),
+            ...(context.snapshot === undefined ? {} : { snapshot: context.snapshot }),
+            inputs: [...(context.inputs ?? [])].sort((left, right) => compareText(left.id, right.id))
+        },
+        outcome: outcome(model, result)
+    };
+};
+const evidence = (value) => {
+    const parts = [
+        value.declaration === undefined ? undefined : `${value.declaration.uri}${value.declaration.line === undefined ? '' : `:${value.declaration.line}${value.declaration.column === undefined ? '' : `:${value.declaration.column}`}`}`,
+        value.evidenceRowIds.length === 0 ? undefined : `rows ${value.evidenceRowIds.join(', ')}`,
+        value.scenarioInputIds.length === 0 ? undefined : `inputs ${value.scenarioInputIds.join(', ')}`
+    ].filter((part) => part !== undefined);
+    return parts.length === 0 ? '' : ` — ${parts.join('; ')}`;
+};
+const valueText = (value) => {
+    switch (value.sort) {
+        case 'bool': return String(value.value);
+        case 'int': return value.value;
+        case 'real': return `${value.numerator}/${value.denominator}`;
+        case 'enum': return value.value;
+    }
+};
+/** Render the same report as concise, deterministic plain text. */
+export const render = (value) => {
+    const lines = [
+        `Solver result: ${value.outcome.status}`,
+        `Model: ${value.run.modelDigest}`,
+        `Backend: ${value.run.backend.name} ${value.run.backend.version}`,
+        `Elapsed: ${value.run.elapsedMs} ms`
+    ];
+    if (value.run.snapshot !== undefined) {
+        lines.push(`Snapshot: transaction ${value.run.snapshot.transactionTime ?? 'empty'}${value.run.snapshot.validTime === undefined ? '' : `, valid ${value.run.snapshot.validTime}`}`);
+    }
+    if (value.run.scenario !== undefined)
+        lines.push(`Scenario: ${value.run.scenario.id} (${value.run.scenario.inputDigest})`);
+    for (const input of value.run.inputs) {
+        lines.push(`Input ${input.id}: ${JSON.stringify(input.value)}${input.query === undefined ? '' : ` via ${input.query}`}`);
+    }
+    switch (value.outcome.status) {
+        case 'satisfied':
+        case 'optimal':
+            for (const assignment of value.outcome.assignments) {
+                lines.push(`Assignment ${assignment.id} = ${valueText(assignment.value)}${assignment.declared ? '' : ' (undeclared backend ID)'}${evidence(assignment)}`);
+            }
+            for (const constraint of value.outcome.hardConstraints) {
+                lines.push(`Hard constraint ${constraint.id}: ${constraint.evaluation}${evidence(constraint)}`);
+            }
+            for (const constraint of value.outcome.softConstraints) {
+                lines.push(`Soft constraint ${constraint.id}: ${constraint.evaluation}, weight ${constraint.weight.numerator}/${constraint.weight.denominator}${evidence(constraint)}`);
+            }
+            if (value.outcome.status === 'optimal') {
+                for (const objective of value.outcome.objectives) {
+                    lines.push(`Objective ${objective.id} (${objective.direction}) = ${valueText(objective.value)}${objective.declared ? '' : ' (undeclared backend ID)'}${evidence(objective)}`);
+                }
+            }
+            break;
+        case 'unsatisfied':
+            lines.push('Infeasibility proved. Unsatisfiable cores are not necessarily minimal.');
+            for (const constraint of value.outcome.core ?? []) {
+                lines.push(`Core constraint ${constraint.id}${constraint.declared ? '' : ' (undeclared backend ID)'}${evidence(constraint)}`);
+            }
+            break;
+        case 'unknown':
+            lines.push(`Unknown: ${value.outcome.reason.kind} — ${value.outcome.reason.message}`);
+            break;
+    }
+    return `${lines.join('\n')}\n`;
+};
+//# sourceMappingURL=explain.js.map

package/dist/src/explain.js.map

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

package/dist/src/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Solver-neutral formal reasoning contracts for CAVE.
+ * Solver-neutral formal reasoning contracts and bounded workflows for CAVE.
  *
  * This package contains no solver implementation and never imports Z3 or
  * another backend. Adapters receive only validated portable model data.
@@ -8,8 +8,10 @@ export * as Adapter from './adapter.ts';
 export * as Canonical from './canonical.ts';
 export * as Capability from './capability.ts';
 export * as Exact from './exact.ts';
+export * as Explain from './explain.ts';
 export * as Linear from './linear.ts';
 export * as Model from './model.ts';
 export * as Solve from './solve.ts';
 export * as Validate from './validate.ts';
+export * as Workflow from './workflow.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}

package/dist/src/index.js

@@ -1,5 +1,5 @@
 /**
- * Solver-neutral formal reasoning contracts for CAVE.
+ * Solver-neutral formal reasoning contracts and bounded workflows for CAVE.
  *
  * This package contains no solver implementation and never imports Z3 or
  * another backend. Adapters receive only validated portable model data.
@@ -8,8 +8,10 @@ export * as Adapter from "./adapter.js";
 export * as Canonical from "./canonical.js";
 export * as Capability from "./capability.js";
 export * as Exact from "./exact.js";
+export * as Explain from "./explain.js";
 export * as Linear from "./linear.js";
 export * as Model from "./model.js";
 export * as Solve from "./solve.js";
 export * as Validate from "./validate.js";
+export * as Workflow from "./workflow.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}

package/dist/src/model.d.ts

@@ -10,29 +10,37 @@ export type EnumDomain = {
     readonly id: string;
     readonly values: readonly string[];
     readonly description?: string;
+    readonly declaration?: Declaration;
 };
-export type Variable = {
+export type Declaration = {
+    /** Stable model source. Prefer a repository-relative URI over a machine-local path. */
+    readonly uri: string;
+    readonly line?: number;
+    readonly column?: number;
+};
+export type Provenance = {
+    readonly description?: string;
+    readonly declaration?: Declaration;
+    readonly evidenceRowIds?: readonly string[];
+    readonly scenarioInputIds?: readonly string[];
+};
+type VariableDeclaration = {
     readonly id: string;
+} & Provenance;
+export type Variable = VariableDeclaration & ({
     readonly sort: 'bool';
-    readonly description?: string;
 } | {
-    readonly id: string;
     readonly sort: 'int';
     readonly min: Integer;
     readonly max: Integer;
-    readonly description?: string;
 } | {
-    readonly id: string;
     readonly sort: 'real';
     readonly min?: Rational;
     readonly max?: Rational;
-    readonly description?: string;
 } | {
-    readonly id: string;
     readonly sort: 'enum';
     readonly domain: string;
-    readonly description?: string;
-};
+});
 export type Literal = {
     readonly kind: 'literal';
     readonly sort: 'bool';
@@ -84,22 +92,18 @@ export type Expression = Literal | {
     readonly then: Expression;
     readonly else: Expression;
 };
-export type HardConstraint = {
+export type HardConstraint = Provenance & {
     readonly id: string;
     readonly expression: Expression;
-    readonly description?: string;
-    readonly evidenceRowIds?: readonly string[];
 };
 export type SoftConstraint = HardConstraint & {
     /** Deliberate preference weight; never inferred from CAVE confidence. */
     readonly weight: Rational;
 };
-export type Objective = {
+export type Objective = Provenance & {
     readonly id: string;
     readonly direction: 'minimize' | 'maximize';
     readonly expression: Expression;
-    readonly description?: string;
-    readonly evidenceRowIds?: readonly string[];
 };
 export type Model = {
     readonly schema: typeof schema;
@@ -127,4 +131,5 @@ export type Value = {
     readonly value: string;
 };
 export type Assignment = Readonly<Record<string, Value>>;
+export {};
 //# sourceMappingURL=model.d.ts.map