eyeprolog 1.1.23 → 1.1.24

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.1.23",
+  "version": "1.1.24",
   "description": "EyeProlog turns facts and rules into answers and proofs.",
   "type": "module",
   "main": "./index.js",

package/src/iso.js

@@ -1784,7 +1784,8 @@ function* phraseBuiltin({ solver, goal, env }) {
   }
 }
 function formalErrorTerm(error) {
-  if (error.formalTerm != null) return compound('error', [error.formalTerm, atom('eyeprolog')]);
+  const context = error.contextTerm ?? atom('eyeprolog');
+  if (error.formalTerm != null) return compound('error', [error.formalTerm, context]);
   const parse = (text) => {
     const open = text.indexOf('(');
     if (open === -1) return atom(text);
@@ -1811,7 +1812,7 @@ function formalErrorTerm(error) {
       formal = compound(formal.name, [error.culprit]);
     }
   }
-  return compound('error', [formal, atom('eyeprolog')]);
+  return compound('error', [formal, context]);
 }
 function* catchBuiltin({ solver, goal, env }) {
   const child = solver.cloneForInnerGoal();

package/src/repl.js

@@ -415,21 +415,43 @@ function formatError(engine, state, error) {
     let generated = 0;
     if (error.formalTerm != null) {
       collectUnboundVariables(engine, error.formalTerm, env, variableNames, () => `_${letterName(generated++)}`);
+      if (error.contextTerm != null) {
+        collectUnboundVariables(engine, error.contextTerm, env, variableNames, () => `_${letterName(generated++)}`);
+      }
       const formal = engine.formatTermForWrite(error.formalTerm, env, {
         quoted: true,
         operators: [...state.program.operators.values()],
         variableNames,
       });
+      if (error.contextTerm != null) {
+        const context = engine.formatTermForWrite(error.contextTerm, env, {
+          quoted: true,
+          operators: [...state.program.operators.values()],
+          variableNames,
+        });
+        return `error(${formal}, ${context}).`;
+      }
       return `error(${formal}).`;
     }
     if (error.culprit != null) {
       collectUnboundVariables(engine, error.culprit, env, variableNames, () => `_${letterName(generated++)}`);
     }
+    if (error.contextTerm != null) {
+      collectUnboundVariables(engine, error.contextTerm, env, variableNames, () => `_${letterName(generated++)}`);
+    }
     const culprit = error.culprit == null ? '' : `, ${engine.formatTermForWrite(error.culprit, env, {
       quoted: true,
       operators: [...state.program.operators.values()],
       variableNames,
     })}`;
+    if (error.contextTerm != null) {
+      const context = engine.formatTermForWrite(error.contextTerm, env, {
+        quoted: true,
+        operators: [...state.program.operators.values()],
+        variableNames,
+      });
+      return `error(${error.formal}${culprit}, ${context}).`;
+    }
     return `error(${error.formal}${culprit}).`;
   }
   const message = error?.message ?? String(error);

package/src/solver.js

@@ -1,7 +1,7 @@
 // Depth-first EyeProlog solver with builtin dispatch, memoization, and guarded recursion handling.
 // Most semantic decisions still flow through unification; optimizations only select candidates earlier.
 import {
-  COMPOUND, Env, compound, copyResolved, deref, flattenConjunction, freshTerm,
+  COMPOUND, Env, compound, copyResolved, deref, emptyList, flattenConjunction, freshTerm,
   numberTerm, numberTextFromDouble, termIsGround, termToString, unify, variantTerms,
 } from './term.js';
 import { PrologError } from './iso.js';
@@ -24,8 +24,11 @@ export function nextFreshId() {
 }
 
 function raiseOccursCheckError(left, right, env) {
-  const error = new PrologError('occurs_check');
-  error.formalTerm = copyResolved(compound('occurs_check', [left, right]), env);
+  // occurs_check=error is an implementation-specific STO diagnostic.  Report
+  // the unrepresentable cyclic result through the standard error envelope.
+  // Keep the implementation-defined context empty for stable, portable output.
+  const error = new PrologError('representation_error(term)');
+  error.contextTerm = emptyList();
   throw error;
 }
 

package/test/run-regression.mjs

@@ -523,7 +523,7 @@ c4 ?- call((!;1)).
       },
     },
     {
-      name: 'occurs_check error mode detects STO while ISO occurs-check unification still fails',
+      name: 'occurs_check error mode reports representation_error(term) while ISO occurs-check unification still fails',
       run: () => {
         const filename = path.join(tmp, `occurs-check-${++tmpCounter}.pl`);
         fs.writeFileSync(filename, ':- set_prolog_flag(occurs_check, error).\nsame(X, X).\n');
@@ -544,11 +544,11 @@ c4 ?- call((!;1)).
         assertEqual(result.stdout,
           '?-    Mode = true.\n' +
           '?-    true.\n' +
-          '?-    error(occurs_check(_A, f(_A))).\n' +
-          '?-    E = error(occurs_check(_A, g(_A)), eyeprolog).\n' +
+          '?-    error(representation_error(term), []).\n' +
+          '?-    E = error(representation_error(term), []).\n' +
           '?-    false.\n' +
           '?-    true.\n' +
-          '?-    error(occurs_check(_A, k(_A))).\n' +
+          '?-    error(representation_error(term), []).\n' +
           '?-    true.\n' +
           '?-    false.\n' +
           '?- ',

package/the-art-of-eyeprolog.md

@@ -785,15 +785,22 @@ subject-to-occurs-check (STO). EyeProlog's default remains the sound finite-tree
 behavior above. For diagnosis, EyeProlog additionally provides the
 implementation-specific flag `occurs_check`; setting it to `error` turns a
 normal unification that would otherwise fail because of the occurs check into
-an exception:
+a representation error:
 
 ```eyeprolog
 :- set_prolog_flag(occurs_check, error).
 
 sto_example :- X = wrapper(X).
-% error(occurs_check(_A, wrapper(_A)))
+% error(representation_error(term), [])
 ```
 
+The ISO error mechanism wraps an error term together with an
+implementation-defined context term. For this implementation-specific STO
+diagnostic EyeProlog uses `representation_error(term)` and currently uses the
+empty list `[]` as that context. This reports that the cyclic result of a
+succeeding STO unification cannot be represented by EyeProlog's finite-tree
+term model, without exposing a non-standard `occurs_check/2` error term.
+
 The supported values are `true` (the default finite-tree behavior) and `error`
 (STO detection). EyeProlog deliberately does not provide `occurs_check=false`,
 because its term model does not construct cyclic terms. The ISO predicate