eyeprolog 1.3.30 → 1.3.32

package/README.md

@@ -182,6 +182,8 @@ modules, DCGs, quads, libraries, proofs, and the other documented extensions.
 
 The auditable processor-requirement checklist lives in
 [`test/conformance/ISO-COMPLIANCE.md`](test/conformance/ISO-COMPLIANCE.md).
+The ISO 5.4 implementation-defined/implementation-specific decision index is
+[`test/conformance/ISO-IMPLEMENTATION-DEFINED.md`](test/conformance/ISO-IMPLEMENTATION-DEFINED.md).
 The separate [WG17 syntax ledger](test/conformance/WG17-SYNTAX-STATUS.md)
 records executable dispositions for the vendored active upstream WG17 syntax
 cases and runs as part of `npm test`. Reviewed cases can pin exact outcomes;
@@ -211,7 +213,7 @@ left-associative operators, so state is handed repeatedly from one nonterminal
 to the next rather than hidden in host code.
 
 Deep finite DCG traversal is kept relational but does not have to consume one
-general solver frame per token.  In particular, the interoperable `...//0`
+general solver frame per token.  In particular, the interoperable `... //0`
 helper from `library(iso_ext)` can scan a finite compact list iteratively, and a
 following grammar that is statically known to leave the DCG state unchanged can
 be continued without rebuilding a full clause-resolution frame for every
@@ -242,7 +244,7 @@ headroom, so an exhausted finite heap is reported as a catchable
 `resource_error(memory)` instead of degenerating into quadratic list checks.
 
 `library(iso_ext)` is also accepted as a common interop module name.
-EyeProlog exports `call_nth/2`, `time/1`, and the DCG helper `...//0` there.
+EyeProlog exports `call_nth/2`, `time/1`, and the DCG helper `... //0` there.
 The latter describes an arbitrary number of input elements and supports the
 nonterminal hand-off benchmark discussed in issue #49. These common predicates
 may be imported explicitly, while source/CLI/API dependency loading can resolve

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.3.30",
+  "version": "1.3.32",
   "description": "EyeProlog turns facts and rules into answers and proofs.",
   "type": "module",
   "main": "./index.js",
@@ -55,6 +55,10 @@
     "test:wg17": "node test/run-wg17.mjs",
     "test:examples": "node test/run-examples.mjs",
     "test:regression": "node test/run-regression.mjs",
+    "test:regression:api": "node test/run-regression.mjs api",
+    "test:regression:core": "node test/run-regression.mjs regression",
+    "test:regression:docs": "node test/run-regression.mjs docs",
+    "test:regression:white-box": "node test/run-regression.mjs white-box",
     "test:playground": "node test/run-playground.mjs",
     "wg17:upgrade": "node tools/upgrade-wg17.mjs",
     "report:wg17": "node tools/report-wg17-syntax-coverage.mjs",

package/src/cli.js

@@ -173,7 +173,7 @@ export async function main(argv) {
 
 async function loadEngine() {
   if (engineModule == null) {
-    const [term, parser, program, solver, iso, library, write, quads] = await Promise.all([
+    const [term, parser, program, solver, iso, library, write, quads, execute] = await Promise.all([
       import('./term.js'),
       import('./parser.js'),
       import('./program.js'),
@@ -182,8 +182,9 @@ async function loadEngine() {
       import('./standard-library.js'),
       import('./write.js'),
       import('./quads.js'),
+      import('./execute.js'),
     ]);
-    engineModule = { ...term, ...parser, ...program, ...solver, ...iso, ...library, ...write, ...quads };
+    engineModule = { ...term, ...parser, ...program, ...solver, ...iso, ...library, ...write, ...quads, ...execute };
   }
   return engineModule;
 }
@@ -201,49 +202,16 @@ async function runDefault(engine, program, options) {
     ioOptions: { write: (text) => process.stdout.write(String(text)) },
   });
   program = solver.program;
-  const goals = options.goals.map((text) => {
-    const goal = engine.parseGoalText(text, {
-      doubleQuotes: solver.prologFlags.get('double_quotes')?.value?.name ?? 'chars',
-      operatorDefinitions: [...program.operators.values()],
-      isoStrict: options.isoStrict,
-    });
-    if (goal.type === 'var') throw new engine.PrologError('instantiation_error');
-    if (goal.type !== 'atom' && goal.type !== 'compound') throw new engine.PrologError('type_error(callable)', goal);
-    return goal;
-  });
-  const queriedKeys = new Set(goals.map((goal) => `${goal.name}/${goal.arity}`));
-  const writeOptions = {
-    doubleQuotes: solver.prologFlags.get('double_quotes')?.value?.name ?? 'chars',
-    operators: [...program.operators.values()],
-    quoted: true,
-  };
-  const facts = program.sourceFactLines(queriedKeys, writeOptions);
-  const lines = new Set();
+  const goals = engine.normalizeGoals(options.goals, solver);
   const explanation = options.proof ? await loadExplanation() : null;
   try {
-    solver.runInitializations();
-    for (const goal of goals) {
-      solver.solutionsSeen = 0;
-      for (const env of solver.solve([goal], new engine.Env(), 0)) {
-        if (!engine.termIsGround(goal, env)) continue;
-
-        const currentWriteOptions = {
-          doubleQuotes: solver.prologFlags.get('double_quotes')?.value?.name ?? 'chars',
-          operators: [...program.operators.values()],
-          quoted: true,
-        };
-        const line = `${engine.formatTermForWrite(goal, env, currentWriteOptions)}.\n`;
-        if (facts.has(line) || lines.has(line)) continue;
-
-        lines.add(line);
-
+    const { haltCode } = engine.executeGoals(program, solver, goals, {
+      onAnswer: (line, resolved) => {
         process.stdout.write(line);
-        if (options.proof) writeExplanation(explanation, program, engine.copyResolved(goal, env), registry);
-      }
-    }
-  } catch (error) {
-    if (error?.name !== 'HaltSignal') throw error;
-    process.exitCode = error.code;
+        if (options.proof) writeExplanation(explanation, program, resolved, registry);
+      },
+    });
+    if (haltCode != null) process.exitCode = haltCode;
   } finally {
     if (options.stats) printStats(solver.stats);
   }

package/src/execute.js

@@ -0,0 +1,56 @@
+// Shared goal preparation and execution for the CLI and embedding API.
+import { ATOM, COMPOUND, VAR, Env, copyResolved, termIsGround } from './term.js';
+import { parseGoalText } from './parser.js';
+import { HaltSignal, PrologError } from './iso.js';
+import { formatTermForWrite } from './write.js';
+
+export function normalizeGoals(requestedGoals, solver) {
+  return requestedGoals.map((requestedGoal) => {
+    const goal = typeof requestedGoal === 'string'
+      ? parseGoalText(requestedGoal, {
+          doubleQuotes: solver.prologFlags.get('double_quotes')?.value?.name ?? 'chars',
+          operatorDefinitions: [...solver.program.operators.values()],
+          isoStrict: solver.isoStrict,
+        })
+      : requestedGoal;
+    if (goal.type === VAR) throw new PrologError('instantiation_error');
+    if (goal.type !== ATOM && goal.type !== COMPOUND) throw new PrologError('type_error(callable)', goal);
+    return goal;
+  });
+}
+
+export function executeGoals(program, solver, goals, { onAnswer = () => {} } = {}) {
+  const initialWriteOptions = currentWriteOptions(program, solver);
+  const queriedKeys = new Set(goals.map((goal) => `${goal.name}/${goal.arity}`));
+  const facts = program.sourceFactLines(queriedKeys, initialWriteOptions);
+  const seen = new Set();
+  let haltCode = null;
+
+  try {
+    solver.runInitializations();
+    for (const goal of goals) {
+      solver.solutionsSeen = 0;
+      for (const env of solver.solve([goal], new Env(), 0)) {
+        if (!termIsGround(goal, env)) continue;
+        const resolved = copyResolved(goal, env);
+        const line = `${formatTermForWrite(resolved, new Env(), currentWriteOptions(program, solver))}.\n`;
+        if (facts.has(line) || seen.has(line)) continue;
+        seen.add(line);
+        onAnswer(line, resolved);
+      }
+    }
+  } catch (error) {
+    if (!(error instanceof HaltSignal)) throw error;
+    haltCode = error.code;
+  }
+
+  return { haltCode };
+}
+
+function currentWriteOptions(program, solver) {
+  return {
+    doubleQuotes: solver.prologFlags.get('double_quotes')?.value?.name ?? 'chars',
+    operators: [...program.operators.values()],
+    quoted: true,
+  };
+}

package/src/index.js

@@ -27,14 +27,12 @@ export {
 export { StreamManager } from './io.js';
 export { runQuads } from './quads.js';
 
-import { ATOM, COMPOUND, VAR, Env, copyResolved, termIsGround } from './term.js';
 import { Program, autoloadProgramGoals } from './program.js';
 import { Solver } from './solver.js';
 import { whyNoProof, whyProof } from './explain.js';
-import { HaltSignal, PrologError, getStrictIsoRegistry } from './iso.js';
+import { getStrictIsoRegistry } from './iso.js';
 import { getEyePrologRegistry } from './standard-library.js';
-import { parseGoalText } from './parser.js';
-import { formatTermForWrite } from './write.js';
+import { executeGoals, normalizeGoals } from './execute.js';
 
 export function run(source, options = {}) {
   const includeWhy = options.proof === true || options.why === true || options.explain === true;
@@ -67,56 +65,14 @@ export function run(source, options = {}) {
     },
   });
   program = solver.program;
-  const goals = normalizeGoals(options, solver);
-  const writeOptions = {
-    doubleQuotes: solver.prologFlags.get('double_quotes')?.value?.name ?? 'chars',
-    operators: [...program.operators.values()],
-    quoted: true,
-  };
-  const queriedKeys = new Set(goals.map((goal) => `${goal.name}/${goal.arity}`));
-  const facts = program.sourceFactLines(queriedKeys, writeOptions);
-  const seen = new Set();
-  let haltCode = null;
-  try {
-    solver.runInitializations();
-    for (const goal of goals) {
-      solver.solutionsSeen = 0;
-      for (const env of solver.solve([goal], new Env(), 0)) {
-        const resolved = copyResolved(goal, env);
-        if (!termIsGround(resolved)) continue;
-        const currentWriteOptions = {
-          doubleQuotes: solver.prologFlags.get('double_quotes')?.value?.name ?? 'chars',
-          operators: [...program.operators.values()],
-          quoted: true,
-        };
-        const line = `${formatTermForWrite(resolved, new Env(), currentWriteOptions)}.\n`;
-        if (facts.has(line) || seen.has(line)) continue;
-        seen.add(line);
-        output.push(line);
-        if (includeWhy) appendExplanation(output, program, resolved, runOptions.registry);
-      }
-    }
-  } catch (error) {
-    if (!(error instanceof HaltSignal)) throw error;
-    haltCode = error.code;
-  }
-  return { stdout: output.join(''), stats: solver.stats, haltCode };
-}
-
-function normalizeGoals(options, solver) {
-  const requested = options.goals ?? (options.goal == null ? [] : [options.goal]);
-  return requested.map((requestedGoal) => {
-    const goal = typeof requestedGoal === 'string'
-      ? parseGoalText(requestedGoal, {
-          doubleQuotes: solver.prologFlags.get('double_quotes')?.value?.name ?? 'chars',
-          operatorDefinitions: [...solver.program.operators.values()],
-          isoStrict: solver.isoStrict,
-        })
-      : requestedGoal;
-    if (goal.type === VAR) throw new PrologError('instantiation_error');
-    if (goal.type !== ATOM && goal.type !== COMPOUND) throw new PrologError('type_error(callable)', goal);
-    return goal;
+  const goals = normalizeGoals(requestedGoals, solver);
+  const { haltCode } = executeGoals(program, solver, goals, {
+    onAnswer: (line, resolved) => {
+      output.push(line);
+      if (includeWhy) appendExplanation(output, program, resolved, runOptions.registry);
+    },
   });
+  return { stdout: output.join(''), stats: solver.stats, haltCode };
 }
 
 function appendExplanation(output, program, resolved, registry) {

package/src/solver.js

@@ -1333,7 +1333,7 @@ function bundledEllipsisPlan(solver, group, goal, rest, env) {
   }
 
   // length/2 and other native constructors can leave a known finite list as a
-  // compact spine.  The ordinary ...//0 relation simply enumerates every
+  // compact spine.  The ordinary ... //0 relation simply enumerates every
   // suffix of such a list; doing that directly avoids clause freshening and
   // recursive solver depth for every consumed element.  Non-compact and open
   // list cases retain the ordinary Prolog definition.

package/src/standard-library.js

@@ -118,7 +118,7 @@ export const eyePrologInteropAutoload = Object.freeze({
   // allowing Trealla-style unqualified source to use the same autoload entry.
   'call_nth/2': 'iso_ext',
   // Trealla exposes time/1 as a meta timing predicate and library(iso_ext)
-  // supplies ...//0. Autoload both so UWN's DCG hand-off benchmark runs
+  // supplies ... //0. Autoload both so UWN's DCG hand-off benchmark runs
   // unchanged while their implementations remain outside the ISO core.
   'time/1': 'iso_ext',
   '.../2': 'iso_ext',

package/test/conformance/ISO-COMPLIANCE.md

@@ -21,9 +21,9 @@ error-ordering alternative to an individual executable assertion.
 | 5.1(a) prepare conforming Prolog text | audit | Clause 6 parser/tokenizer coverage, directive coverage, syntax-error corpus, and the [complete vendored WG17 syntax matrix](WG17-SYNTAX-STATUS.md). Wider shall-by-shall text-processing audit remains open. |
 | 5.1(b) execute conforming Prolog goals | audit | Clause 7-9 conformance corpus plus regression/API/example gates. A normative goal-semantics ledger is still being expanded. |
 | 5.1(c) reject nonconforming text/read-terms | audit | Dedicated syntax-error cases and strict-core extension rejection. Exhaustive lexical rejection coverage remains open. |
-| 5.1(d) document permitted variations | audit | Major implementation-defined choices are documented in *The Art of EyeProlog*. Every occurrence of “implementation defined/dependent/specific” in Part 1 still needs a final documentation cross-check. |
+| 5.1(d) document permitted variations | covered | The clause-by-clause [ISO 5.4 decision index](ISO-IMPLEMENTATION-DEFINED.md) records every explicit implementation-defined decision found in the Part 1 + Corrigenda baseline and separately inventories implementation-specific extension families. Rows marked `audit gap` remain conformance work, but the variation is no longer undocumented. |
 | 5.1(e) offer a strictly conforming mode | covered | `--iso-strict` and API option `isoStrict: true` restrict the processor to the Part 1 + Corrigenda 1-3 core language surface, remove EyeProlog-only registry/flag/operator features, and disable automatic tabling/recursion guards. |
-| 5.4 accompanying documentation | audit | The book is the implementation reference. The implementation-defined-feature inventory is not yet a closed checklist. |
+| 5.4 accompanying documentation | covered | *The Art of EyeProlog* remains the implementation reference; [ISO-IMPLEMENTATION-DEFINED.md](ISO-IMPLEMENTATION-DEFINED.md) is the closed clause-by-clause 5.4 decision index and points each decision to implementation evidence or an explicit audit gap. |
 | 5.5 extensions preserve standard text | covered | Default mode retains EyeProlog extensions; strict core mode removes their language/runtime interpretation. Regression tests ensure the default profile remains unchanged. |
 
 ## Normative language families
@@ -95,6 +95,6 @@ ISO/IEC 13211-1 processor” until all of the following are true:
    difference explained or fixed;
 4. prescribed modes, errors, side effects, and relevant error precedence for
    every Part 1 built-in have executable coverage;
-5. every implementation-defined/dependent/specific choice required to be
-   documented is linked to the implementation reference; and
+5. every `audit gap` recorded in the ISO 5.4 decision index is either fixed or
+   explicitly excluded from the strict-conformance claim; and
 6. an external conformance run has found no unexplained deviations.

package/test/conformance/ISO-IMPLEMENTATION-DEFINED.md

@@ -0,0 +1,146 @@
+# ISO/IEC 13211-1 implementation-defined and implementation-specific profile
+
+This is the clause-by-clause ISO 5.4 decision index for EyeProlog. The
+normative baseline used for this table is **ISO/IEC 13211-1:1995** together
+with **Technical Corrigenda 1:2007, 2:2012, and 3:2017**. The current WG17/STC
+pages at complang.tuwien.ac.at are useful review input, but draft proposals are
+not silently treated as normative changes to that licensed baseline.
+
+[*The Art of EyeProlog*](../../the-art-of-eyeprolog.md) remains the single
+implementation reference. This file is an audit index: it identifies each
+explicitly implementation-defined decision in Part 1, states the EyeProlog
+choice, and points to the implementation boundary that realizes it. Repeated
+references to the same decision are folded into one row. Requirements that the
+standard calls **implementation dependent** are listed separately because ISO
+5.4 does not require their documentation in the same way.
+
+Status values are:
+
+- **defined** — the current behavior is implemented and stated here;
+- **not applicable** — the standard decision is conditional and the condition
+  is false for EyeProlog's selected profile;
+- **audit gap** — the current code behavior is stated, but strict-mode
+  conformance still needs a correction or a narrower profile before this row
+  can support a full conformance claim.
+
+## Explicit implementation-defined decisions
+
+| Clause | Decision completed by ISO 5.4 documentation | EyeProlog choice | Status / implementation evidence |
+| --- | --- | --- | --- |
+| 5.5.11 | Reserved atoms and the effect of instantiating a variable to one | EyeProlog reserves no Prolog atom under 5.5.11. Atoms with implementation-looking names remain ordinary terms unless a particular predicate interprets them. | **defined** — term representation and built-ins in `src/term.js`, `src/iso.js`. |
+| 6.5 | Processor character set (PCS) | The unquoted ISO lexical classes are the Part 1 ASCII characters implemented by `src/parser.js`. Quoted character data additionally accepts Unicode scalar values. | **audit gap** — the Unicode quoted-character extension is currently also accepted by `--iso-strict`; strict extension rejection still needs a narrower PCS rule or a documented conforming classification. |
+| 6.5 | Classification of additional/extended PCS characters | Non-ASCII scalar values are not accepted as unquoted small-letter, capital-letter, graphic, solo, layout, or meta characters; they are accepted only inside quoted character data. | **audit gap** — same strict-mode boundary as the preceding row. |
+| 6.6 | Collating-sequence integers | Character codes are Unicode scalar values. Atom comparison uses ECMAScript string lexicographic order; on the ISO ASCII repertoire this is code-point order and satisfies the required monotonic ranges. | **defined** — `src/term.js` (`compareTerms`), `src/iso.js` character-code predicates. |
+| 6.6 | Collating values of control escapes and extended characters | Control escapes and character-code predicates use Unicode scalar values. Atom ordering is ECMAScript string order; for non-BMP one-char atoms that order is based on UTF-16 code units rather than scalar values. | **audit gap** — the ISO ASCII repertoire is conforming, but the extended-character collating rule still needs one coherent documented integer/order mapping in strict mode. |
+| 7.1.2.2 | Mapping between a character code and bytes | Text file streams decode and encode UTF-8. Binary streams expose bytes 0..255 directly. | **defined** — `src/io.js`. |
+| 7.1.4.1 | Set `C` of characters represented by one-char atoms | Character predicates accept Unicode scalar values U+0000..U+10FFFF excluding surrogate code points. | **defined** — `src/iso.js` character-code validation. |
+| 7.4.2.4 | Whether `op/3` directives affect other Prolog texts or execution | An `op/3` directive changes parsing of subsequent text loaded into the same `Program`; the resulting operator table is also used by execution-time term I/O. Separately created `Program` objects are independent. | **defined** — `src/parser.js`, `src/program.js`, `src/iso.js`. |
+| 7.4.2.5 | Whether directive-created `Convc` affects other text/execution | Directive mappings are copied into the solver's execution-time `charConversions` map. The source tokenizer itself does not currently apply `char_conversion/2` to later unquoted source characters. | **audit gap** — `src/program.js`, `src/solver.js`; source-preparation conversion remains to be aligned with 7.11.2.1. |
+| 7.4.2.6 | Order of `initialization/1` goals | Initialization goals run once, in source/inclusion order, before requested goals; each must obtain a first solution. | **defined** — `Program.initializations`, `Solver.runInitializations()`. |
+| 7.4.2.7 | Ground term designating a Prolog text for `include/1` | A source designation is an atom interpreted as a file path; relative paths resolve from the including file's directory (or the current working directory for unanchored input). | **defined** — `src/program.js` (`readIncludedSource`). |
+| 7.4.2.8 | Ground term designating a Prolog text for `ensure_loaded/1` | Same atom/file-path designation as `include/1`. | **defined** — `src/program.js`. |
+| 7.4.2.8 | Position at which an ensured text is included | The first `ensure_loaded/1` expands the text in place at the directive; later requests for the same resolved path are ignored. | **defined** — `src/program.js` (`ensured` set and in-place builder loading). |
+| 7.4.2.9 | Whether `set_prolog_flag/2` directives affect other texts/execution | Parser-relevant `double_quotes` changes following source text in the same parse; recorded flag directives initialize the solver used for execution. Separately created programs/solvers are independent. | **defined** — `src/parser.js`, `src/program.js`, `src/solver.js`. |
+| 7.5.1 | Means by which the processor is asked to prepare Prolog text | Text is prepared through the CLI/REPL, the JavaScript `Program.parse`/`run` API, source files/URLs, and `include/1`/`ensure_loaded/1`. | **defined** — Chapter 40 and `src/cli.js`, `src/index.js`, `src/program.js`. |
+| 7.5.1 | Effects of directive-driven reordering, addition, or removal of clauses during preparation | Includes are expanded in place; declarations annotate the affected procedure; clauses otherwise retain source order. No directive silently reorders ordinary clauses. | **defined** — streaming builder in `src/program.js`. |
+| 7.7.1 | External form of a negative answer | The interactive top level prints `false.`. Non-interactive `run()`/CLI corpus execution emits no answer line for a failed goal. | **defined** — Chapter 40, `src/repl.js`, `src/execute.js`. |
+| 7.7.1 | External form of a positive answer | The REPL prints `true.` for a solution without visible bindings or `Name = Term` bindings; the file/API runner emits each resolved ground goal as a Prolog term followed by `.`. | **defined** — Chapter 40, `src/repl.js`, `src/execute.js`. |
+| 7.7.3 | Method by which a user delivers a goal | REPL queries, CLI `--goal`, `%% goal:` host comments, and the JavaScript `goal` option are supported host interfaces. | **defined** — Chapter 40. |
+| 7.10.1 | Additional source/sink possibilities | Node runtimes support local files plus the predefined standard streams; embedding supplies `user_input` text and a `user_output` callback. URL loading is a source-loading facility, not an ISO stream opened by `open/4`. | **defined** — `src/io.js`, `src/cli.js`, `src/index.js`. |
+| 7.10.1 | Ground term designating a source/sink to `open/4` | An atom is interpreted as a local file-system path. | **defined** — `src/iso.js`, `src/io.js`. |
+| 7.10.2.6 | Record-based/non-record-based text stream support | EyeProlog exposes non-record-based text streams. | **defined** — `src/io.js`. |
+| 7.10.2.6 | Alteration of spaces at line ends | None. EyeProlog preserves text-stream characters; it does not trim or pad line endings. | **defined** — `src/io.js`. |
+| 7.10.2.6 | Whether the last line is followed by newline / close adds one | Closing a text output stream writes exactly the accumulated content and does not synthesize a final newline. | **defined** — `StreamManager.close()`. |
+| 7.10.2.6 | Effect of outputting control characters | The Unicode character is appended unchanged to a text stream (subject to the host sink's ordinary string handling). | **defined** — `StreamManager.writeUnit()`. |
+| 7.10.2.7 | Number of zero bytes that may be appended on binary re-input | Zero. Binary file output is written and read byte-for-byte. | **defined** — `src/io.js`. |
+| 7.10.2.8 | Whether a source/sink can be arbitrarily repositioned | File streams are repositionable only when opened with `reposition(true)`; standard streams are not repositionable. | **defined** — `src/io.js`, `set_stream_position/2` in `src/iso.js`. |
+| 7.10.2.9 | Terms denoting end/past-end stream positions when repositionable | Stream positions are non-negative integer offsets; `position(N)` is also accepted by `set_stream_position/2`. End/past-end state is separately exposed by `end_of_stream/1`. | **defined** — `streamProperties()` and `setStreamPositionBuiltin()` in `src/iso.js`. |
+| 7.10.2.11 | Default `eof_action` | Newly opened file streams default to `error`. The predefined standard streams use `reset`. | **defined** — `src/io.js`. |
+| 7.10.2.13 | `eof_action(Action)` property when the stream uses its default action | Reports the same selected action: `error` for ordinary opened files and `reset` for the predefined standard streams. | **defined** — `streamProperties()` in `src/iso.js`, defaults in `src/io.js`. |
+| 7.10.2.11 | Whether `reposition(false)` streams may nevertheless be repositioned | No. `set_stream_position/2` raises a permission error unless the stream was created with `reposition(true)`. | **defined** — `src/iso.js`. |
+| 7.11.1.1 | Default `bounded` flag | `false`: EyeProlog's Prolog integer model uses arbitrary-precision `BigInt`, subject to host resources. | **defined** — `defaultPrologFlags()` in `src/solver.js`. |
+| 7.11.1.2 | Default `max_integer` when `bounded=true` | The bounded-profile default is not applicable because EyeProlog selects `bounded=false`. However, EyeProlog currently exposes the sentinel atom `unbounded` through `current_prolog_flag/2` instead of making the `max_integer` query fail as 7.11.1.1 prescribes for an unbounded processor. | **audit gap** — `src/solver.js`, `current_prolog_flag/2`. |
+| 7.11.1.3 | Default `min_integer` when `bounded=true` | The bounded-profile default is not applicable because EyeProlog selects `bounded=false`. However, EyeProlog currently exposes the sentinel atom `unbounded` through `current_prolog_flag/2` instead of making the `min_integer` query fail as 7.11.1.1 prescribes for an unbounded processor. | **audit gap** — `src/solver.js`, `current_prolog_flag/2`. |
+| 7.11.1.4 | Default `integer_rounding_function` flag | `toward_zero`; `//` uses truncation toward zero. `div` is provided separately with downward/floor division semantics. | **defined** — `src/solver.js`, `src/iso.js`. |
+| 9.1.3.1 | Integer division rounding function `rndI` | Truncation toward zero, matching the `integer_rounding_function=toward_zero` flag. | **defined** — BigInt division for `//` in `src/iso.js`. |
+| 7.11.2.1 | Whether preparation-time `Convc` affects execution-time `Convc` | Yes: mappings recorded by `char_conversion/2` directives initialize the solver map. Source-token conversion itself has the audit gap noted at 7.4.2.5. | **defined / audit note** — `src/solver.js`. |
+| 7.11.2.2 | Effect when `debug=on` | The flag is accepted and stored; it does not change goal semantics or enable a debugger. | **defined** — `src/solver.js`; no semantic branch depends on `debug`. |
+| 7.11.2.3 | Default `max_arity` | `unbounded` in the Prolog model, subject to host memory and practical JavaScript array/index limits. | **defined** — `src/solver.js`; relevant guards report representation/resource errors. |
+| 7.11.2.5 | Default `double_quotes` | `chars`. | **defined** — `src/solver.js`, parser flag state. |
+| 7.12.1 | Second argument of `error/2` | The default context term is the atom `eyeprolog`. A few implementation-specific diagnostics may deliberately supply a more specific context term. | **defined** — `formalErrorTerm()` in `src/iso.js`. |
+| 7.12.2(f) | Implementation-defined representation limits | Character and character-code operations use Unicode scalar limits; arity/integer values are modeled as unbounded but may hit host/resource limits. Float input overflow uses the implementation-specific `max_float`/`min_float` representation names documented by the STC-oriented tests. | **defined** — parser/ISO numeric and character guards. |
+| 8.17.1 | Implementation-defined flag value ranges | Strict mode exposes only Part 1 core flags and their standard value sets. Normal mode additionally exposes EyeProlog's `occurs_check` flag; `max_integer`/`min_integer` use the `unbounded` sentinel described above. | **defined** — strict registry/flag filtering in `src/solver.js`. |
+| 8.17.3 | Other effects of `halt/0` | Terminates EyeProlog execution and returns host/process status `0`; it produces no Prolog solution. | **defined** — `HaltSignal`, `haltBuiltin()`, CLI/runner handling. |
+| 8.17.4 | Meaning/effects of `halt(Status)` | Integer `Status` is converted to the host process/runner halt code; it produces no Prolog solution. | **defined** — `haltBuiltin()`, `src/execute.js`, `src/cli.js`. |
+| 9.1.4.1 | Floating-point rounding function `rndF` | Floating values and operations use ECMAScript `Number` (IEEE-754 binary64) and the host's specified binary64 arithmetic/conversions. | **defined** — `src/iso.js`, `src/number-value.js`. |
+| 9.1.4.2 | Floating-point result function, including tiny non-zero arithmetic results | For arithmetic operation results that underflow to zero from non-zero operands, EyeProlog chooses the exceptional value `underflow`, exposed as `evaluation_error(underflow)`. Float token/`number_chars/2` input is a separate conversion path and finite input underflow rounds to `0.0`. | **defined** — `evaluateOperation()` and parser/number conversion; executable issue-56 regression below. |
+| 9.1.4.3 | Approximate-addition function | ECMAScript binary64 addition is used; subtraction is implemented through the corresponding host operation and all finite results remain binary64 values. | **defined** — `evaluateOperation()` in `src/iso.js`. |
+| 9.4 | Representation of negative integers for bitwise operations | BigInt's unbounded signed binary semantics are used, equivalent to an infinite two's-complement sign extension for bitwise operations. | **defined** — `src/iso.js` BigInt bitwise operators. |
+| 9.4.1 | Right shift of negative integers and unusual shift counts | `>>` is arithmetic/sign-propagating. A negative count reverses direction according to JavaScript BigInt shift semantics; there is no finite integer bit-size ceiling in the Prolog model. | **defined** — `a >> b` in `src/iso.js`. |
+| 9.4.2 | Left shift of negative integers and unusual shift counts | `<<` uses BigInt signed shift semantics; a negative count reverses direction. Resource exhaustion remains possible for very large results. | **defined** — `a << b` in `src/iso.js`. |
+| 9.4.3 | Bitwise AND with negative operands | BigInt infinite-two's-complement semantics. | **defined** — `a & b`. |
+| 9.4.4 | Bitwise OR with negative operands | BigInt infinite-two's-complement semantics. | **defined** — `a \| b`. |
+| 9.4.5 | Bitwise complement | BigInt complement, i.e. `~N = -N-1`. | **defined** — `~a`. |
+| Cor.2 9.4.6 | `xor/2` with negative operands | BigInt infinite-two's-complement semantics. | **defined** — `a ^ b`. |
+
+### Why issue #56's two float results differ
+
+The arithmetic expression and the float token go through different specified
+layers. Clause 9.1.4 defines arithmetic operations in terms of the
+implementation-defined floating rounding/result functions, and EyeProlog's
+chosen `resultF` policy reports underflow for a non-zero arithmetic result that
+falls below the normal range and rounds to zero. By contrast, reading the token
+`0.1e-999` is an input conversion; the 1995 text does not precisely define the
+rounding of an inexact float token, a gap also called out in the later
+[WG17/STC item #40](https://www.complang.tuwien.ac.at/ulrich/iso-prolog/stc#40).
+EyeProlog's documented input policy is therefore to accept finite token
+underflow as `0.0` while arithmetic underflow remains an evaluation error.
+
+The regression suite contains an issue-56 case that checks both observations,
+and the existing `stc/float_underflow_input` conformance case covers the related
+input-conversion policy.
+
+## Implementation-specific features required to be documented by 5.4
+
+Part 1 clause 5.5 permits extensions only as implementation-specific features.
+Corrigendum 3 additionally makes extra option names explicit implementation-
+specific features. EyeProlog's normal profile provides the following extension
+families; `--iso-strict` is intended to remove their Part 1 interpretation.
+
+| Part 1 extension hook | EyeProlog normal-profile feature | Strict-core disposition |
+| --- | --- | --- |
+| 5.5.1 Syntax | Part 2 modules, Part 3 grammar-rule expansion, and embedded quad syntax | Module directives are rejected; grammar rules remain ordinary `-->/2` terms rather than being expanded; quad syntax is rejected. Unicode quoted-character handling is the open PCS audit item above. |
+| 5.5.2 Predefined operators | Part 3 `|` and EyeProlog's labelable infix `(?-)/2`; CLP(Z) operators when that library is imported | Only the Part 1 operator table is predefined; a conforming `op/3` may still add permitted operators. |
+| 5.5.3 Character-conversion mapping | No non-identity initial `Convc` extension | Identity initial mapping. |
+| 5.5.4 Types | No additional runtime Prolog term type is exposed by the core solver | Only variable, integer, float, atom, and compound term ordering participates in strict mode. |
+| 5.5.5 Directives | `module/2`, `use_module/1-2`, `meta_predicate/1` and normal-profile library behavior | Rejected as implementation-specific Part 1 directives. |
+| 5.5.6 Side effects | Host output/statistics, library-specific state, proof/statistics collection | The strict registry excludes library adapters; ordinary Part 1 I/O/database/flag/operator side effects remain. |
+| 5.5.7 Control constructs | `tnot/1` and normal-profile execution optimizations | `tnot/1` is absent; automatic tabling/recursion guards are disabled. |
+| 5.5.8 Flags | `occurs_check` | Absent in strict mode. |
+| 5.5.9 Built-in predicates | EyeProlog libraries, CLP(Z), statistics, Part 3 `phrase/2-3`, and interop autoloaded predicates | Strict registry contains only the Part 1 + Corrigenda core registry. |
+| 5.5.10 Evaluable functors | Library/runtime extensions when registered outside the strict core | Strict arithmetic registry is the Part 1 + Corrigenda set. |
+| 5.5.11 Reserved atoms | None | None. |
+| Cor.3 5.5.12 Options | Extra library/host options may exist outside core option lists | Strict core accepts the standard option names implemented for Part 1; invalid options follow Corrigendum 3 validation. |
+
+Part 2 and Part 3 are separately standardized profiles when EyeProlog is run in
+its normal mode; the table above describes them as extensions only relative to
+the Part 1 strict-core boundary.
+
+## Important implementation-dependent behavior (not the 5.4 mandatory table)
+
+For portability work, EyeProlog also documents these choices even though the
+1995 text labels them implementation **dependent**, not implementation defined:
+
+- distinct variables are ordered by first encounter within the operation that
+  needs a stable ordering;
+- expression arguments are evaluated left-to-right by the JavaScript evaluator;
+- generated variable names use EyeProlog's stable `_A`, `_B`, ... style within
+  a write operation/top-level query;
+- resource and syntax-error detail atoms are EyeProlog implementation details;
+- the order of `current_prolog_flag/2` solutions is the insertion order of the
+  flag registry.
+
+These rows are intentionally separate so that the ISO 5.4 checklist does not
+blur the standard's distinction between *implementation defined* (documented),
+*implementation dependent* (need not be documented), and *implementation
+specific* (an extension that must be documented for a conforming processor).

package/test/conformance/ISO-MATRIX.md

@@ -28,12 +28,13 @@ uninstantiation errors, and corrected `catch/3` behavior (Cor.2); and option
 validation, variable-name traversal/output, canonical list output, and negative
 integer powers (Cor.3).
 
-Implementation-defined choices are documented in *The Art of EyeProlog*:
-integers and arity are unbounded by the Prolog model (subject to host memory),
-ordinary unification performs an occurs check, `double_quotes` defaults to
-`chars`, both strict core mode and normal EyeProlog use the ISO
-`unknown=error` default, `//` rounds toward zero, floating-point operations use
-finite ECMAScript numbers, and character codes use Unicode scalar values.
+Implementation-defined and implementation-specific choices are indexed
+clause-by-clause in [ISO-IMPLEMENTATION-DEFINED.md](ISO-IMPLEMENTATION-DEFINED.md),
+with *The Art of EyeProlog* remaining the implementation reference. In
+particular, the index records the unbounded integer model, `double_quotes=chars`,
+`//` rounding toward zero, the ECMAScript binary64 float policy (including the
+9.1.4.2 arithmetic-underflow choice), stream/character decisions, and the
+normal-profile extension boundary.
 
 This is an executable conformance matrix, not a certification issued by an
 independent standards body. Release gating runs the ISO cases and the dedicated

package/test/run-all.mjs

@@ -2,7 +2,7 @@
 // Unified test runner used by `npm test`.
 // Running all suites in one process keeps the numbering continuous and avoids
 // npm's intermediate script banners between conformance, regression, and examples.
-import { TestReporter } from './test-style.mjs';
+import { runStandalone } from './test-style.mjs';
 import { runConformance } from './run-conformance.mjs';
 import { runRegression } from './run-regression.mjs';
 import { runIsoStrict } from './run-iso-strict.mjs';
@@ -12,9 +12,7 @@ import { runBookExamples } from './run-book-examples.mjs';
 import { runWg17 } from './run-wg17.mjs';
 import { runOpenRuleBenchChecks } from './run-openrulebench.mjs';
 
-const reporter = new TestReporter();
-
-try {
+await runStandalone(async (reporter) => {
   runConformance(reporter);
   runIsoStrict(reporter);
   runWg17(reporter);
@@ -23,8 +21,4 @@ try {
   await runPlayground(reporter);
   runExamples(reporter);
   runBookExamples(reporter);
-  reporter.totalLine();
-  process.exit(0);
-} catch (_) {
-  process.exit(1);
-}
+});

package/test/run-book-examples.mjs

@@ -4,7 +4,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { Program, run } from '../src/index.js';
-import { TestReporter, isMainModule } from './test-style.mjs';
+import { TestReporter, isMainModule, runStandalone } from './test-style.mjs';
 import { goalsFromSource } from './goal-metadata.mjs';
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
@@ -39,11 +39,5 @@ function listPrograms(directory) {
 }
 
 if (isMainModule(import.meta.url)) {
-  const reporter = new TestReporter();
-  try {
-    runBookExamples(reporter);
-    reporter.totalLine();
-  } catch (_) {
-    process.exit(1);
-  }
+  await runStandalone(runBookExamples);
 }

package/test/run-conformance-report.mjs

@@ -5,6 +5,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { listPrologFiles } from './test-support.mjs';
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)));
 const packageRoot = path.resolve(root, '..');
@@ -24,7 +25,7 @@ export function buildConformanceReport() {
   for (const { kind, expectedKind, expectedExt, column } of KINDS) {
     const base = path.join(conformanceRoot, kind);
     if (!fs.existsSync(base)) continue;
-    for (const file of listEyePrologFiles(base)) {
+    for (const file of listPrologFiles(base)) {
       const category = categoryOf(file);
       const counts = ensureCategory(categories, category);
       counts[column]++;
@@ -77,19 +78,6 @@ export function formatConformanceReport(report = buildConformanceReport()) {
   return `${lines.join('\n')}\n`;
 }
 
-function listEyePrologFiles(base, dir = base) {
-  const files = [];
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      files.push(...listEyePrologFiles(base, full));
-    } else if (entry.isFile() && entry.name.endsWith('.pl')) {
-      files.push(path.relative(base, full).split(path.sep).join('/'));
-    }
-  }
-  return files.sort();
-}
-
 function categoryOf(file) {
   const parts = file.split('/');
   return parts.length > 1 ? parts[0] : 'legacy-numbered';

package/test/run-conformance.mjs

@@ -6,27 +6,12 @@ import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { Program, createDefaultRegistry, run } from '../src/index.js';
 import { fileURLToPath } from 'node:url';
-import { TestReporter, isMainModule } from './test-style.mjs';
+import { TestReporter, isMainModule, runStandalone } from './test-style.mjs';
 import { goalsFromSource } from './goal-metadata.mjs';
+import { listPrologFiles, withStandardModules } from './test-support.mjs';
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)));
 const filterArg = process.argv[2] ?? null;
-const libraryCall = /\b(?:uuid|difference|maplist|lt|gt|le|ge|between|smallest_divisor_from|random|matches|split|replace|lowercase|uppercase|trim|number_string|atom_string|term_string|append|string_concat|contains|join|substring|member|select|last|nth0|nth1|set_nth0|take|drop|slice|reverse|length|sum_list|min_list|max_list|list_to_set|countall|sumall|aggregate_min|aggregate_max)\s*\(/;
-
-function withStandardModules(text) {
-  if (!libraryCall.test(text) || text.includes('use_module(library(')) return text;
-  return `:- use_module(library(aggregate)).
-:- use_module(library(comparison)).
-:- use_module(library(dates)).
-:- use_module(library(iso_ext)).
-:- use_module(library(lists)).
-:- use_module(library(primes)).
-:- use_module(library(prologue), [between/3]).
-:- use_module(library(random)).
-:- use_module(library(strings)).
-:- use_module(library(uuid)).
-${text}`;
-}
 
 export function runConformance(reporter = new TestReporter(), requestedFilter = null) {
   const filter = requestedFilter ?? filterArg;
@@ -42,7 +27,7 @@ export function runConformance(reporter = new TestReporter(), requestedFilter =
 function listCaseFiles(kind, filter = null) {
   const base = path.join(root, 'conformance', kind);
   if (!fs.existsSync(base)) return [];
-  return listEyePrologFiles(base)
+  return listPrologFiles(base)
     .filter((name) => matchesFilter(kind, name, filter))
     .sort();
 }
@@ -58,19 +43,6 @@ function matchesFilter(kind, name, filter) {
     || `${label}/${stem}`.includes(filter);
 }
 
-function listEyePrologFiles(base, dir = base) {
-  const files = [];
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      files.push(...listEyePrologFiles(base, full));
-    } else if (entry.isFile() && entry.name.endsWith('.pl')) {
-      files.push(path.relative(base, full).split(path.sep).join('/'));
-    }
-  }
-  return files;
-}
-
 function runCaseFile(reporter, file) {
   const name = file.slice(0, -3);
   reporter.test(name, () => runCase(name, file));
@@ -194,11 +166,5 @@ function diffText(expected, actualText) {
 }
 
 if (isMainModule(import.meta.url)) {
-  const reporter = new TestReporter();
-  try {
-    runConformance(reporter);
-    reporter.totalLine();
-  } catch (_) {
-    process.exit(1);
-  }
+  await runStandalone(runConformance);
 }

package/test/run-examples.mjs

@@ -6,7 +6,7 @@ import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { Program, run } from '../src/index.js';
 import { fileURLToPath } from 'node:url';
-import { TestReporter, isMainModule } from './test-style.mjs';
+import { TestReporter, isMainModule, runStandalone } from './test-style.mjs';
 import { goalsInProgramOrder } from './goal-metadata.mjs';
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)));
@@ -156,11 +156,5 @@ function diffText(expected, actualText) {
 }
 
 if (isMainModule(import.meta.url)) {
-  const reporter = new TestReporter();
-  try {
-    runExamples(reporter);
-    reporter.totalLine();
-  } catch (_) {
-    process.exit(1);
-  }
+  await runStandalone(runExamples);
 }

package/test/run-iso-strict.mjs

@@ -10,7 +10,7 @@ import {
   parseGoalText,
   run,
 } from '../src/index.js';
-import { TestReporter, isMainModule } from './test-style.mjs';
+import { TestReporter, isMainModule, runStandalone } from './test-style.mjs';
 
 export function runIsoStrict(reporter = new TestReporter()) {
   reporter.section('Strict ISO core');
@@ -103,11 +103,5 @@ function includes(actual, expected, label) {
 }
 
 if (isMainModule(import.meta.url)) {
-  const reporter = new TestReporter();
-  try {
-    runIsoStrict(reporter);
-    reporter.totalLine();
-  } catch (_) {
-    process.exit(1);
-  }
+  await runStandalone(runIsoStrict);
 }

package/test/run-openrulebench.mjs

@@ -2,57 +2,27 @@
 // Fast structural checks for the generated multi-engine OpenRuleBench corpus.
 // Full benchmark execution remains separate because it requires external
 // Prolog implementations and is intentionally performance-oriented.
-import path from 'node:path';
-import process from 'node:process';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import { TestReporter, isMainModule } from './test-style.mjs';
-
-const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+import { validateOpenRuleBench } from '../openrulebench/tools/check.mjs';
+import { TestReporter, isMainModule, runStandalone } from './test-style.mjs';
 
 export function runOpenRuleBenchChecks(reporter = new TestReporter()) {
+  let report = null;
   reporter.section('OpenRuleBench source integrity');
-  runChecker(
-    reporter,
-    'generated sources pass lexical checks',
-    'openrulebench/tools/check_sources.mjs',
-    'eyeprolog: 14 sources; lexical checks ok',
-  );
-  runChecker(
-    reporter,
-    'engine variants preserve table and WFS adaptations',
-    'openrulebench/tools/check_multiengine.mjs',
-    'OK: 14 benchmarks x 4 engines; table/WFS adaptations verified.',
-  );
+  reporter.test('generated sources pass lexical checks', () => {
+    report = validateOpenRuleBench();
+    assertNoErrors(report.lexicalErrors);
+  });
+  reporter.test('engine variants preserve table and WFS adaptations', () => {
+    report ??= validateOpenRuleBench();
+    assertNoErrors(report.adaptationErrors);
+  });
   reporter.sectionTotal('OpenRuleBench source-integrity');
 }
 
-function runChecker(reporter, name, relativeScript, expectedOutput) {
-  reporter.test(name, () => {
-    const result = spawnSync(process.execPath, [relativeScript], {
-      cwd: packageRoot,
-      encoding: 'utf8',
-      timeout: 30000,
-    });
-    if (result.error) throw result.error;
-    if (result.status !== 0) {
-      throw new Error(
-        `${relativeScript} exited with ${result.status}\n` +
-        `${result.stdout ?? ''}${result.stderr ?? ''}`.trimEnd(),
-      );
-    }
-    if (!String(result.stdout).includes(expectedOutput)) {
-      throw new Error(`${relativeScript} did not report its expected summary\n${result.stdout ?? ''}`.trimEnd());
-    }
-  });
+function assertNoErrors(errors) {
+  if (errors.length > 0) throw new Error(errors.join('\n'));
 }
 
 if (isMainModule(import.meta.url)) {
-  const reporter = new TestReporter();
-  try {
-    runOpenRuleBenchChecks(reporter);
-    reporter.totalLine();
-  } catch (_) {
-    process.exit(1);
-  }
+  await runStandalone(runOpenRuleBenchChecks);
 }

package/test/run-playground.mjs

@@ -10,7 +10,14 @@ import {
   executePlaygroundRequest,
   installPlaygroundWorker,
 } from '../src/playground-worker.js';
-import { TestReporter, isMainModule } from './test-style.mjs';
+import {
+  TestReporter,
+  assertEqual,
+  assertIncludes,
+  assertNotIncludes,
+  isMainModule,
+  runStandalone,
+} from './test-style.mjs';
 
 const testRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)));
 const packageRoot = path.resolve(testRoot, '..');
@@ -220,30 +227,6 @@ function assert(condition, message) {
   if (!condition) throw new Error(message);
 }
 
-function assertEqual(actual, expected, label) {
-  if (actual !== expected) {
-    throw new Error(`${label} mismatch\nexpected: ${JSON.stringify(expected)}\nactual:   ${JSON.stringify(actual)}`);
-  }
-}
-
-function assertIncludes(actual, expected, label) {
-  if (!String(actual).includes(expected)) {
-    throw new Error(`${label} did not include ${JSON.stringify(expected)}\nactual: ${JSON.stringify(actual)}`);
-  }
-}
-
-function assertNotIncludes(actual, expected, label) {
-  if (String(actual).includes(expected)) {
-    throw new Error(`${label} unexpectedly included ${JSON.stringify(expected)}`);
-  }
-}
-
 if (isMainModule(import.meta.url)) {
-  const reporter = new TestReporter();
-  try {
-    await runPlayground(reporter);
-    reporter.totalLine();
-  } catch (_) {
-    process.exit(1);
-  }
+  await runStandalone(runPlayground);
 }

package/test/run-regression.mjs

@@ -48,13 +48,21 @@ import { PrologError, formalErrorTerm } from '../src/iso.js';
 import { compareTerms } from '../src/term.js';
 import { formatTermForWrite } from '../src/write.js';
 import { selectClauseCandidates } from '../src/program.js';
-import { TestReporter, isMainModule } from './test-style.mjs';
+import {
+  TestReporter,
+  assertEqual,
+  assertIncludes,
+  assertNotIncludes,
+  isMainModule,
+  runStandalone,
+} from './test-style.mjs';
 import { buildConformanceReport, formatConformanceReport } from './run-conformance-report.mjs';
 import { proofExamples } from './run-examples.mjs';
 import { goalsFromSource } from './goal-metadata.mjs';
 import { renderWg17SyntaxStatus } from '../tools/report-wg17-syntax-coverage.mjs';
 import { parseWg17SyntaxTable } from '../tools/upgrade-wg17.mjs';
 import { executeWg17Item, matchesUpstreamExpectation, readWg17SyntaxFixture } from './run-wg17.mjs';
+import { withStandardModules } from './test-support.mjs';
 
 const testRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)));
 const packageRoot = path.resolve(testRoot, '..');
@@ -62,22 +70,6 @@ const bin = path.join(packageRoot, 'bin', 'eyeprolog.js');
 const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
 let tmp = null;
 let tmpCounter = 0;
-const libraryCall = /\b(?:uuid|difference|maplist|foldl|call_nth|lt|gt|le|ge|between|smallest_divisor_from|random|matches|split|replace|lowercase|uppercase|trim|number_string|atom_string|term_string|append|string_concat|contains|join|substring|member|select|last|nth0|nth1|set_nth0|take|drop|slice|reverse|length|sum_list|min_list|max_list|list_to_set|countall|sumall|aggregate_min|aggregate_max)\s*\(/;
-
-function withStandardModules(source) {
-  if (!libraryCall.test(source) || source.includes('use_module(library(') || source.includes(':- module(')) return source;
-  return `:- use_module(library(aggregate)).
-:- use_module(library(comparison)).
-:- use_module(library(dates)).
-:- use_module(library(iso_ext)).
-:- use_module(library(lists)).
-:- use_module(library(primes)).
-:- use_module(library(prologue), [between/3]).
-:- use_module(library(random)).
-:- use_module(library(strings)).
-:- use_module(library(uuid)).
-${source}`;
-}
 
 function run(source, options = {}) {
   const programSource = Array.isArray(source) ? source.join('\n') : source;
@@ -92,15 +84,24 @@ function sourceAtom(value) {
   return `'${String(value).replaceAll('\\', '\\\\').replaceAll("'", "''")}'`;
 }
 
-export function runRegression(reporter = new TestReporter()) {
+export function runRegression(reporter = new TestReporter(), requestedSection = null) {
+  const sections = [
+    { key: 'regression', name: 'Regression', cases: regressionCases },
+    { key: 'docs', name: 'Documentation sync', cases: documentationSyncCases },
+    { key: 'api', name: 'API', cases: apiCases },
+    { key: 'white-box', name: 'White-box', cases: whiteBoxCases },
+  ];
+  const selected = requestedSection == null
+    ? sections
+    : sections.filter((section) => section.key === requestedSection);
+  if (selected.length === 0) {
+    throw new Error(`unknown regression section: ${requestedSection}; expected ${sections.map(({ key }) => key).join(', ')}`);
+  }
+
   tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'eyeprolog-regression.'));
   tmpCounter = 0;
-
   try {
-    runSection(reporter, 'Regression', regressionCases());
-    runSection(reporter, 'Documentation sync', documentationSyncCases());
-    runSection(reporter, 'API', apiCases());
-    runSection(reporter, 'White-box', whiteBoxCases());
+    for (const section of selected) runSection(reporter, section.name, section.cases());
   } finally {
     fs.rmSync(tmp, { recursive: true, force: true });
     tmp = null;
@@ -738,6 +739,14 @@ c4 ?- call((!;1)).
         assertEqual(result.stderr, '', 'stderr');
       },
     },
+    {
+      name: 'arithmetic underflow choice differs from float-token input underflow (issue #56)',
+      run: () => {
+        const result = run('', { goal: 'catch((N is 0.1*10** -999), error(evaluation_error(underflow), _), N = underflow)' });
+        assertEqual(result.stdout, 'catch(underflow is 0.1 * 10 ** -999, error(evaluation_error(underflow), eyeprolog), underflow = underflow).\n', 'operation underflow');
+        assertEqual(run('', { goal: 'N = 0.1e-999' }).stdout, '0.0 = 0.0.\n', 'float-token input underflow');
+      },
+    },
     {
       name: 'float literals reject overflow and normalize underflow (issue #54)',
       run: () => {
@@ -1519,7 +1528,7 @@ c4 ?- call((!;1)).
       },
     },
     {
-      name: 'Trealla-style DCG hand-off autoloads time/1 and ...//0 without quadratic occurs checks (issue #49)',
+      name: 'Trealla-style DCG hand-off autoloads time/1 and ... //0 without quadratic occurs checks (issue #49)',
       run: () => {
         const engineUrl = new URL('../src/index.js', import.meta.url).href;
         const script = `
@@ -1592,7 +1601,7 @@ c4 ?- call((!;1)).
       },
     },
     {
-      name: 'REPL applies conservative autoloading to interactive time/1 and consulted ...//0',
+      name: 'REPL applies conservative autoloading to interactive time/1 and consulted ... //0',
       run: () => {
         const filename = path.join(tmp, `issue49-handoff-${tmpCounter++}.pl`);
         fs.writeFileSync(filename, 'a --> ..., epsilon.\nepsilon --> [].\n');
@@ -3399,6 +3408,33 @@ function documentationSyncCases() {
       name: 'documentation uses EyeProlog source style',
       run: () => assertArrayEqual(documentationSourceStyleIssues(), [], 'documentation source style'),
     },
+    {
+      name: 'DCG nonterminal indicator prose uses valid ... //0 spacing (issue #49)',
+      run: () => {
+        for (const filename of ['README.md', 'the-art-of-eyeprolog.md', 'src/standard-library.js', 'src/solver.js']) {
+          const text = fs.readFileSync(path.join(packageRoot, filename), 'utf8');
+          assertNotIncludes(text, '...' + '//0', `${filename} invalid compact nonterminal indicator`);
+        }
+      },
+    },
+    {
+      name: 'ISO 5.4 decision index inventories implementation-defined choices (issue #56)',
+      run: () => {
+        const filename = path.join(testRoot, 'conformance', 'ISO-IMPLEMENTATION-DEFINED.md');
+        const text = fs.readFileSync(filename, 'utf8');
+        for (const clause of [
+          '5.5.11', '6.5', '6.6', '7.1.2.2', '7.1.4.1', '7.4.2.4', '7.4.2.5',
+          '7.4.2.6', '7.4.2.7', '7.4.2.8', '7.4.2.9', '7.5.1', '7.7.1', '7.7.3',
+          '7.10.1', '7.10.2.6', '7.10.2.7', '7.10.2.8', '7.10.2.9', '7.10.2.11',
+          '7.10.2.13', '7.11.1.1', '7.11.1.2', '7.11.1.3', '7.11.1.4', '7.11.2.1',
+          '7.11.2.2', '7.11.2.3', '7.11.2.5', '7.12.1', '7.12.2(f)', '8.17.1',
+          '8.17.3', '8.17.4', '9.1.3.1', '9.1.4.1', '9.1.4.2', '9.1.4.3', '9.4',
+          '9.4.1', '9.4.2', '9.4.3', '9.4.4', '9.4.5', 'Cor.2 9.4.6',
+        ]) assertIncludes(text, `| ${clause} |`, `ISO 5.4 clause ${clause}`);
+        assertIncludes(text, 'Why issue #56', 'issue #56 explanation');
+        assertIncludes(text, 'Implementation-specific features required to be documented by 5.4', '5.5 extension inventory');
+      },
+    },
     {
       name: 'book is the single implementation reference',
       run: () => assertArrayEqual(bookReferenceDocumentationIssues(), [], 'book reference documentation'),
@@ -5739,18 +5775,6 @@ function runCli(args, options = {}) {
   });
 }
 
-function assertEqual(actual, expected, label) {
-  if (actual !== expected) throw new Error(`${label} mismatch\nexpected: ${format(expected)}\nactual:   ${format(actual)}`);
-}
-
-function assertIncludes(actual, expected, label) {
-  if (!actual.includes(expected)) throw new Error(`${label} did not include ${format(expected)}\nactual: ${format(actual)}`);
-}
-
-function assertNotIncludes(actual, expected, label) {
-  if (String(actual).includes(expected)) throw new Error(`${label} unexpectedly included ${format(expected)}\nactual: ${format(actual)}`);
-}
-
 function arrayDiffMessages(actual, expected, label) {
   const messages = [];
   const actualSet = new Set(actual);
@@ -5776,11 +5800,5 @@ function format(value) {
 }
 
 if (isMainModule(import.meta.url)) {
-  const reporter = new TestReporter();
-  try {
-    runRegression(reporter);
-    reporter.totalLine();
-  } catch (_) {
-    process.exit(1);
-  }
+  await runStandalone((reporter) => runRegression(reporter, process.argv[2] ?? null));
 }

package/test/run-wg17.mjs

@@ -11,7 +11,7 @@ import {
 } from '../src/index.js';
 import { parseTermText } from '../src/parser.js';
 import { variantTerms } from '../src/term.js';
-import { TestReporter, isMainModule } from './test-style.mjs';
+import { TestReporter, isMainModule, runStandalone } from './test-style.mjs';
 
 const testRoot = path.dirname(fileURLToPath(import.meta.url));
 const fixturePath = path.join(testRoot, 'conformance', 'wg17-syntax-cases.json');
@@ -377,12 +377,5 @@ export function runWg17(reporter = new TestReporter()) {
 }
 
 if (isMainModule(import.meta.url)) {
-  const reporter = new TestReporter();
-  try {
-    runWg17(reporter);
-    reporter.totalLine();
-  } catch (error) {
-    process.stderr.write(`${error?.stack ?? error}\n`);
-    process.exitCode = 1;
-  }
+  await runStandalone(runWg17);
 }

package/test/test-style.mjs

@@ -102,6 +102,43 @@ export function isMainModule(metaUrl) {
   return process.argv[1] != null && path.resolve(process.argv[1]) === fileURLToPath(metaUrl);
 }
 
+export async function runStandalone(runSuite) {
+  const reporter = new TestReporter();
+  try {
+    await runSuite(reporter);
+    reporter.totalLine();
+  } catch (error) {
+    // TestReporter already prints failures raised inside a test. Preserve a
+    // diagnostic for setup/teardown failures that occur outside reporter.test.
+    if (reporter.ok === reporter.total) {
+      reporter.stderr.write(`${error?.stack ?? String(error)}\n`);
+    }
+    process.exitCode = 1;
+  }
+}
+
+export function assertEqual(actual, expected, label) {
+  if (actual !== expected) {
+    throw new Error(`${label} mismatch\nexpected: ${formatValue(expected)}\nactual:   ${formatValue(actual)}`);
+  }
+}
+
+export function assertIncludes(actual, expected, label) {
+  if (!String(actual).includes(expected)) {
+    throw new Error(`${label} did not include ${formatValue(expected)}\nactual: ${formatValue(actual)}`);
+  }
+}
+
+export function assertNotIncludes(actual, expected, label) {
+  if (String(actual).includes(expected)) {
+    throw new Error(`${label} unexpectedly included ${formatValue(expected)}\nactual: ${formatValue(actual)}`);
+  }
+}
+
+function formatValue(value) {
+  return typeof value === 'string' ? JSON.stringify(value) : String(value);
+}
+
 function defaultSectionLabel(name) {
   return String(name)
     .replace(/^Conformance\s+/, 'conformance ')

package/test/test-support.mjs

@@ -0,0 +1,36 @@
+// Shared fixtures and filesystem helpers used across test suites.
+import fs from 'node:fs';
+import path from 'node:path';
+
+const libraryCall = /\b(?:uuid|difference|maplist|foldl|call_nth|lt|gt|le|ge|between|smallest_divisor_from|random|matches|split|replace|lowercase|uppercase|trim|number_string|atom_string|term_string|append|string_concat|contains|join|substring|member|select|last|nth0|nth1|set_nth0|take|drop|slice|reverse|length|sum_list|min_list|max_list|list_to_set|countall|sumall|aggregate_min|aggregate_max)\s*\(/;
+
+const standardModulePrelude = `:- use_module(library(aggregate)).
+:- use_module(library(comparison)).
+:- use_module(library(dates)).
+:- use_module(library(iso_ext)).
+:- use_module(library(lists)).
+:- use_module(library(primes)).
+:- use_module(library(prologue), [between/3]).
+:- use_module(library(random)).
+:- use_module(library(strings)).
+:- use_module(library(uuid)).
+`;
+
+export function withStandardModules(source) {
+  const text = String(source);
+  if (!libraryCall.test(text) || text.includes('use_module(library(') || text.includes(':- module(')) return text;
+  return `${standardModulePrelude}${text}`;
+}
+
+export function listPrologFiles(base, dir = base) {
+  const files = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...listPrologFiles(base, full));
+    } else if (entry.isFile() && entry.name.endsWith('.pl')) {
+      files.push(path.relative(base, full).split(path.sep).join('/'));
+    }
+  }
+  return files.sort();
+}

package/the-art-of-eyeprolog.md

@@ -5668,7 +5668,7 @@ round-tripping.  The checked answers are in
 
 #### Deep sequence hand-off
 
-`library(iso_ext)` provides the common `...//0` helper, which describes an
+`library(iso_ext)` provides the common `... //0` helper, which describes an
 arbitrary number of input elements.  It is not part of ISO Part 3, but it is a
 useful interoperability and stress-test relation.  A compact hand-off test is:
 
@@ -5677,7 +5677,7 @@ a --> ..., epsilon.
 epsilon --> [].
 ```
 
-Here the remaining sequence is repeatedly passed from `...//0` to another
+Here the remaining sequence is repeatedly passed from `... //0` to another
 nonterminal.  For a finite compact list, EyeProlog can scan the arbitrary
 sequence iteratively instead of consuming one ordinary solver depth level per
 list cell.  If the continuation is structurally proven to be a zero-width
@@ -6207,7 +6207,7 @@ The current interoperability profile recognizes these library roles:
 | Library | Role in the interoperability profile |
 | --- | --- |
 | `library(lists)` | Common list module. A conservative subset of its exports is in the shared predicate profile. |
-| `library(iso_ext)` | Common extension-module name. `call_nth/2`, `time/1`, and the `...//0` arbitrary-sequence helper are conservatively autoloaded for cross-engine source. |
+| `library(iso_ext)` | Common extension-module name. `call_nth/2`, `time/1`, and the `... //0` arbitrary-sequence helper are conservatively autoloaded for cross-engine source. |
 | `library(lambda)` | Scryer-aligned higher-order notation. It is imported explicitly because loading it also installs the `+\` operator. |
 | `library(prologue)` | EyeProlog compatibility module, not a common interop library name. `between/3` is nevertheless autoloaded from it so portable source need not name this EyeProlog-specific provider. |
 
@@ -6234,7 +6234,7 @@ recovery headroom so finite-heap exhaustion remains a catchable
 EyeProlog API belongs to the shared profile. `call_nth/2`, `time/1`, and
 `.../2` are mapped there. `time/1` measures each solution of a meta-call and
 prints elapsed time, EyeProlog inference count, and MLips in Trealla-style form,
-for example `% Time elapsed 0.832s, 65551 Inferences, 0.079 MLips`; `...//0`
+for example `% Time elapsed 0.832s, 65551 Inferences, 0.079 MLips`; `... //0`
 describes an arbitrary number of input elements. Together they let the
 Trealla/Scryer DCG hand-off benchmark run in EyeProlog without source changes
 (assuming the usual list library is already imported in an interactive
@@ -7416,6 +7416,10 @@ Part 1 conformance audit. It distinguishes implemented/tested families from
 requirements whose normative `shall` clauses, option combinations, or error
 precedence still need one-by-one closure. `test/conformance/ISO-MATRIX.md`
 maps language families to representative executable cases.
+`test/conformance/ISO-IMPLEMENTATION-DEFINED.md` is the ISO 5.4 decision
+index: it enumerates the Part 1 implementation-defined decisions, the
+implementation-specific extension families, and any remaining strict-mode audit
+gaps without turning draft WG17/STC proposals into the licensed baseline.
 `test/conformance/WG17-SYNTAX-STATUS.md` separately traces the vendored active
 upstream syntax cases. Reviewed cases can pin exact strict-reader outcomes, while
 newly upgraded cases execute directly against the upstream Codex expectation.