eyelang 0.1.0

package/examples/gd-step-certified.pl

@@ -0,0 +1,158 @@
+% Memoize interval computations reused across width, midpoint, gradient, step,
+% objective, and contraction report relations.
+% Output declarations: materialize/2 selects the relations written to this example's golden output.
+materialize(eta, 2).
+materialize(etaLeHalf, 2).
+materialize(xBounds, 2).
+materialize(midpoint, 2).
+materialize(width, 2).
+materialize(gradientBounds, 2).
+materialize(stepBounds, 2).
+materialize(objectiveBounds, 2).
+materialize(widthContractsAt, 2).
+
+% Program structure: facts set up the scenario, and rules derive the materialized conclusions.
+memoize(x_bounds, 3).
+memoize(width, 2).
+memoize(g_bounds, 3).
+memoize(p_bounds, 3).
+memoize(midpoint, 3).
+memoize(f_lower, 2).
+memoize(f_upper, 2).
+
+% Adapted from Eyeling's gd-step-certified.n3.
+% One-dimensional gradient descent over certified interval bounds.
+
+max_k(10).
+target(1.0).
+% Derivation rules: each rule below contributes one logical step toward the displayed results.
+eta(Eta) :- div(1.0, 5, Eta).
+x_bounds(0, 0.0, 2.0).
+
+index(0). index(1). index(2). index(3). index(4). index(5).
+index(6). index(7). index(8). index(9). index(10).
+
+previous(1, 0). previous(2, 1). previous(3, 2). previous(4, 3). previous(5, 4).
+previous(6, 5). previous(7, 6). previous(8, 7). previous(9, 8). previous(10, 9).
+
+g_bounds(K, GL, GU) :-
+  target(A),
+  x_bounds(K, L, U),
+  sub(L, A, DL),
+  sub(U, A, DU),
+  mul(2, DL, GL),
+  mul(2, DU, GU).
+
+p_bounds(K, PL, PU) :-
+  eta(Eta),
+  g_bounds(K, GL, GU),
+  mul(Eta, GL, PL),
+  mul(Eta, GU, PU).
+
+x_bounds(K1, L1, U1) :-
+  previous(K1, K),
+  x_bounds(K, L, U),
+  target(A),
+  eta(Eta),
+  sub(L, A, DL),
+  sub(U, A, DU),
+  mul(2, DL, GL),
+  mul(2, DU, GU),
+  mul(Eta, GL, PL),
+  mul(Eta, GU, PU),
+  sub(L, PU, L1),
+  sub(U, PL, U1).
+
+width(K, W) :-
+  x_bounds(K, L, U),
+  sub(U, L, W).
+
+midpoint(K, M, HalfW) :-
+  x_bounds(K, L, U),
+  width(K, W),
+  div(W, 2, HalfW),
+  add(L, U, Sum),
+  div(Sum, 2, M).
+
+eta_le_half(true) :-
+  eta(Eta),
+  div(1.0, 2, Half),
+  le(Eta, Half).
+
+width_contracts_at(K1, true) :-
+  eta_le_half(true),
+  previous(K1, K),
+  width(K, W),
+  width(K1, W1),
+  le(W1, W).
+
+max2(A, B, A) :- ge(A, B).
+max2(A, B, B) :- lt(A, B).
+min2(A, B, A) :- le(A, B).
+min2(A, B, B) :- gt(A, B).
+
+end_squares(K, SL, SU) :-
+  target(A),
+  x_bounds(K, L, U),
+  sub(L, A, DL),
+  sub(U, A, DU),
+  mul(DL, DL, SL),
+  mul(DU, DU, SU).
+
+f_upper(K, FU) :-
+  end_squares(K, SL, SU),
+  max2(SL, SU, FU).
+
+f_lower(K, 0.0) :-
+  target(A),
+  x_bounds(K, L, U),
+  le(L, A),
+  le(A, U).
+
+f_lower(K, FL) :-
+  target(A),
+  x_bounds(K, L, U),
+  lt(U, A),
+  end_squares(K, SL, SU),
+  min2(SL, SU, FL).
+
+f_lower(K, FL) :-
+  target(A),
+  x_bounds(K, L, U),
+  lt(A, L),
+  end_squares(K, SL, SU),
+  min2(SL, SU, FL).
+
+eta(result, Eta) :-
+  eta(Eta).
+
+etaLeHalf(result, true) :-
+  eta_le_half(true).
+
+xBounds(result, bounds(K, L, U)) :-
+  index(K),
+  x_bounds(K, L, U).
+
+midpoint(result, midpoint(K, M, HalfW)) :-
+  index(K),
+  midpoint(K, M, HalfW).
+
+width(result, width(K, W)) :-
+  index(K),
+  width(K, W).
+
+gradientBounds(result, gradient(K, GL, GU)) :-
+  index(K),
+  g_bounds(K, GL, GU).
+
+stepBounds(result, step(K, PL, PU)) :-
+  index(K),
+  p_bounds(K, PL, PU).
+
+objectiveBounds(result, f(K, FL, FU)) :-
+  index(K),
+  f_lower(K, FL),
+  f_upper(K, FU).
+
+widthContractsAt(result, K) :-
+  width_contracts_at(K, true).

package/examples/gdpr-compliance.pl

@@ -0,0 +1,69 @@
+% GDPR-style compliance check: purpose, basis, minimisation, safeguards, and export.
+
+% Output declarations: materialize/2 selects the relations written to this example's golden output.
+materialize(status, 2).
+materialize(reason, 2).
+
+% Program structure: facts set up the scenario, and rules derive the materialized conclusions.
+% case_alpha is intended to pass; case_beta is intentionally incomplete.
+processing(case_alpha).
+processing(case_beta).
+
+purpose(case_alpha, care_coordination).
+purpose(case_beta, marketing).
+
+legal_basis(case_alpha, explicit_consent).
+% case_beta intentionally has no legal basis.
+
+minimized(case_alpha).
+not_minimized(case_beta).
+
+special_category(case_alpha, health_data).
+special_category(case_beta, health_data).
+
+safeguard(case_alpha, encryption).
+safeguard(case_alpha, access_logging).
+safeguard(case_beta, encryption).
+
+third_country_transfer(case_beta).
+adequacy_decision(case_alpha).
+
+% Compliance is decomposed into reusable checks so reasons can be reported.
+% Derivation rules: each rule below contributes one logical step toward the displayed results.
+has_required_basis(Case) :- legal_basis(Case, explicit_consent).
+has_required_basis(Case) :- legal_basis(Case, medical_care).
+
+has_health_safeguards(Case) :-
+  special_category(Case, health_data),
+  safeguard(Case, encryption),
+  safeguard(Case, access_logging).
+
+transfer_ok(Case) :- not(third_country_transfer(Case)).
+transfer_ok(Case) :- adequacy_decision(Case).
+
+compliant(Case) :-
+  processing(Case),
+  has_required_basis(Case),
+  minimized(Case),
+  has_health_safeguards(Case),
+  transfer_ok(Case).
+
+% Individual failure rules explain why a case is noncompliant.
+noncompliance_reason(Case, missing_legal_basis) :-
+  processing(Case),
+  not(has_required_basis(Case)).
+
+noncompliance_reason(Case, not_minimized) :-
+  not_minimized(Case).
+
+noncompliance_reason(Case, missing_access_logging) :-
+  special_category(Case, health_data),
+  not(safeguard(Case, access_logging)).
+
+noncompliance_reason(Case, transfer_without_adequacy) :-
+  third_country_transfer(Case),
+  not(adequacy_decision(Case)).
+
+status(Case, gdpr_compliant) :- compliant(Case).
+status(Case, gdpr_noncompliant) :- noncompliance_reason(Case, _Reason).
+reason(Case, Reason) :- noncompliance_reason(Case, Reason).

package/examples/good-cobbler.pl

@@ -0,0 +1,14 @@
+% Good cobbler, adapted from Eyeling's examples/good-cobbler.n3.
+%
+% The Eyeling result is a quoted assertion saying that joe is a good Cobbler.
+% Here the quoted assertion is represented as an eyelang term.
+
+% Output declarations: materialize/2 selects the relations written to this example's golden output.
+materialize(is, 2).
+
+% Program structure: facts set up the scenario, and rules derive the materialized conclusions.
+assertedIs(joe, good(cobbler)).
+
+% Derivation rules: each rule below contributes one logical step toward the displayed results.
+is(test, is(X, good(Y))) :-
+  assertedIs(X, good(Y)).

package/examples/gps.pl

@@ -0,0 +1,152 @@
+% Memoize route paths because the same candidate routes are checked repeatedly
+% for explanation and verification relations.
+% Output declarations: materialize/2 selects the relations written to this example's golden output.
+materialize(recommendedRoute, 2).
+materialize(outcome, 2).
+materialize(statement, 3).
+materialize(label, 2).
+materialize(actionSequence, 2).
+materialize(durationSeconds, 2).
+materialize(cost, 2).
+materialize(belief, 2).
+materialize(comfort, 2).
+materialize(selectedRoute, 2).
+materialize(comparison, 2).
+
+% Program structure: facts set up the scenario, and rules derive the materialized conclusions.
+memoize(path, 7).
+memoize(traveller_path, 6).
+
+% GPS — ARC-style goal-driven route planning, translated from Eyeling's gps.n3.
+%
+% The map is kept as quoted formula data.  Rules project gps_description
+% statements from that formula, chain them into paths, compare the two complete
+% routes from Gent to Oostende, and produce a compact explanation report.
+
+case_graph(caseGraph, (
+  location(i1, gent),
+  text(question, "Which route should we take from Gent to Oostende?"),
+  label(routeDirect, "Gent -> Brugge -> Oostende"),
+  label(routeViaKortrijk, "Gent -> Kortrijk -> Brugge -> Oostende")
+)).
+
+map_graph(mapBE, (
+  gps_description(mapBE, description(location(S, gent), true, location(S, brugge), drive_gent_brugge, 1500.0, 0.006, 0.96, 0.99)),
+  gps_description(mapBE, description(location(S, gent), true, location(S, kortrijk), drive_gent_kortrijk, 1600.0, 0.007, 0.96, 0.99)),
+  gps_description(mapBE, description(location(S, kortrijk), true, location(S, brugge), drive_kortrijk_brugge, 1600.0, 0.007, 0.96, 0.99)),
+  gps_description(mapBE, description(location(S, brugge), true, location(S, oostende), drive_brugge_oostende, 900.0, 0.004, 0.98, 1.0))
+)).
+
+% Derivation rules: each rule below contributes one logical step toward the displayed results.
+case_statement(S, P, O) :-
+  case_graph(caseGraph, Context),
+  holds(Context, P, [S, O]).
+
+map_description(From, To, Action, Duration, Cost, Belief, Comfort) :-
+  map_graph(mapBE, Context),
+  holds(Context, gps_description(mapBE, description(From, true, To, Action, Duration, Cost, Belief, Comfort))).
+
+path(From, To, [Action], Duration, Cost, Belief, Comfort) :-
+  map_description(From, To, Action, Duration, Cost, Belief, Comfort).
+
+path(From, To, Actions, Duration, Cost, Belief, Comfort) :-
+  map_description(From, Mid, Action, D1, C1, B1, F1),
+  path(Mid, To, RestActions, D2, C2, B2, F2),
+  append([Action], RestActions, Actions),
+  add(D1, D2, Duration),
+  add(C1, C2, Cost),
+  mul(B1, B2, Belief),
+  mul(F1, F2, Comfort).
+
+traveller_start(i1, location(i1, gent)).
+traveller_goal(i1, location(i1, oostende)).
+
+traveller_path(Traveller, Actions, Duration, Cost, Belief, Comfort) :-
+  traveller_start(Traveller, From),
+  traveller_goal(Traveller, To),
+  path(From, To, Actions, Duration, Cost, Belief, Comfort).
+
+route_metrics(routeDirect, Duration, Cost, Belief, Comfort) :-
+  traveller_path(i1, [drive_gent_brugge, drive_brugge_oostende], Duration, Cost, Belief, Comfort).
+
+route_metrics(routeViaKortrijk, Duration, Cost, Belief, Comfort) :-
+  traveller_path(i1, [drive_gent_kortrijk, drive_kortrijk_brugge, drive_brugge_oostende], Duration, Cost, Belief, Comfort).
+
+recommended_route(routeDirect) :-
+  route_metrics(routeDirect, DirectDuration, DirectCost, DirectBelief, DirectComfort),
+  route_metrics(routeViaKortrijk, ViaDuration, ViaCost, ViaBelief, ViaComfort),
+  lt(DirectDuration, ViaDuration),
+  lt(DirectCost, ViaCost),
+  gt(DirectBelief, ViaBelief),
+  gt(DirectComfort, ViaComfort).
+
+outcome(routeDirect, "Take the direct route via Brugge.").
+
+% Verification checks, analogous to the false-producing guards in gps.n3.
+check(c1, true) :-
+  traveller_path(i1, [drive_gent_brugge, drive_brugge_oostende], _, _, _, _).
+
+check(c2, true) :-
+  traveller_path(i1, [drive_gent_kortrijk, drive_kortrijk_brugge, drive_brugge_oostende], _, _, _, _).
+
+check(c3, true) :-
+  route_metrics(routeDirect, D1, _, _, _),
+  route_metrics(routeViaKortrijk, D2, _, _, _),
+  lt(D1, D2).
+
+check(c4, true) :-
+  route_metrics(routeDirect, _, C1, _, _),
+  route_metrics(routeViaKortrijk, _, C2, _, _),
+  lt(C1, C2).
+
+check(c5, true) :-
+  route_metrics(routeDirect, _, _, B1, F1),
+  route_metrics(routeViaKortrijk, _, _, B2, F2),
+  gt(B1, B2),
+  gt(F1, F2).
+
+recommendedRoute(decision, Route) :-
+  recommended_route(Route).
+
+outcome(decision, Outcome) :-
+  recommended_route(Route),
+  outcome(Route, Outcome).
+
+statement(check, Check, true) :-
+  check(Check, true).
+
+route_actions(routeDirect, [drive_gent_brugge, drive_brugge_oostende]).
+route_actions(routeViaKortrijk, [drive_gent_kortrijk, drive_kortrijk_brugge, drive_brugge_oostende]).
+
+% Derived route and report relations.  These are consequences of the route search
+% and comparison, not pre-written markdown output.
+label(Route, Label) :-
+  case_statement(Route, label, Label),
+  route_metrics(Route, _Duration, _Cost, _Belief, _Comfort).
+
+actionSequence(Route, Actions) :-
+  route_actions(Route, Actions),
+  route_metrics(Route, _Duration, _Cost, _Belief, _Comfort).
+
+durationSeconds(Route, Duration) :-
+  route_metrics(Route, Duration, _Cost, _Belief, _Comfort).
+
+cost(Route, Cost) :-
+  route_metrics(Route, _Duration, Cost, _Belief, _Comfort).
+
+belief(Route, Belief) :-
+  route_metrics(Route, _Duration, _Cost, Belief, _Comfort).
+
+comfort(Route, Comfort) :-
+  route_metrics(Route, _Duration, _Cost, _Belief, Comfort).
+
+selectedRoute(report, route(Route, Actions, Duration, Cost, Belief, Comfort)) :-
+  recommended_route(Route),
+  route_actions(Route, Actions),
+  route_metrics(Route, Duration, Cost, Belief, Comfort).
+
+comparison(report, dominates(routeDirect, routeViaKortrijk)) :-
+  recommended_route(routeDirect),
+  check(c3, true),
+  check(c4, true),
+  check(c5, true).

package/examples/graph-reachability.pl

@@ -0,0 +1,36 @@
+% Graph reachability example adapted from Eyelet input/graph-reachability.pl.
+%
+% The original uses Prolog negation and member/2 to avoid revisiting nodes.
+% eyelang expresses the same finite search with not(member(...)).
+
+% Output declarations: materialize/2 selects the relations written to this example's golden output.
+materialize(reachable, 2).
+materialize(not_reachable, 2).
+
+% Program structure: facts set up the scenario, and rules derive the materialized conclusions.
+edge(a, b).
+edge(a, c).
+edge(b, d).
+edge(c, e).
+edge(d, f).
+edge(e, f).
+edge(f, g).
+
+reachable(Node, Node, _Visited).
+% Derivation rules: each rule below contributes one logical step toward the displayed results.
+reachable(Start, Goal, Visited) :-
+  edge(Start, Next),
+  not(member(Next, Visited)),
+  reachable(Next, Goal, [Next|Visited]).
+
+is_reachable(Start, Goal) :-
+  reachable(Start, Goal, [Start]).
+
+reachable(reachability_case, path(a, f)) :-
+  is_reachable(a, f).
+
+reachable(reachability_case, path(c, g)) :-
+  is_reachable(c, g).
+
+not_reachable(reachability_case, path(b, e)) :-
+  not(is_reachable(b, e)).

package/examples/gray-code-counter.pl

@@ -0,0 +1,48 @@
+% Gray-code counter adapted from Eyeling gray-code-counter.n3 and the
+% Clause and Effect example referenced there.
+
+% Output declarations: materialize/2 selects the relations written to this example's golden output.
+materialize(isgcc, 2).
+
+% Program structure: facts set up the scenario, and rules derive the materialized conclusions.
+% Boolean gates are truth tables; the circuit rules compose them.
+and(0, 0, 0). and(0, 1, 0). and(1, 0, 0). and(1, 1, 1).
+or(0, 0, 0).  or(0, 1, 1).  or(1, 0, 1).  or(1, 1, 1).
+inv(0, 1). inv(1, 0).
+
+dff(D, 0, Q, Q).
+dff(D, 1, _Q, D).
+
+% Derivation rules: each rule below contributes one logical step toward the displayed results.
+neta(A, B, Q) :-
+  and(A, B, T1),
+  inv(A, NA),
+  inv(B, NB),
+  and(NA, NB, T2),
+  or(T1, T2, Q).
+
+netb(A, B, C, Q1, Q2) :-
+  and(A, C, T1),
+  inv(C, NC),
+  and(B, NC, T2),
+  inv(A, NA),
+  and(NA, C, T3),
+  or(T1, T2, Q1),
+  or(T2, T3, Q2).
+
+% One clock step computes D inputs, then updates the three flip-flops.
+gcc(C, [Qa, Qb, Qc], [Za, Zb, Zc]) :-
+  netb(Qa, Qb, Qc, D1, D2),
+  neta(Qa, Qb, D3),
+  dff(D1, C, Qa, Za),
+  dff(D2, C, Qb, Zb),
+  dff(D3, C, Qc, Zc).
+
+% testgcc/3 runs the circuit over a list of clock inputs.
+testgcc([], _State, []).
+testgcc([C|Cs], State, [Next|Rest]) :-
+  gcc(C, State, Next),
+  testgcc(Cs, Next, Rest).
+
+isgcc([[1, 1, 1, 1, 1, 1, 1, 1, 1], [0, 0, 0]], States) :-
+  testgcc([1, 1, 1, 1, 1, 1, 1, 1, 1], [0, 0, 0], States).

package/examples/greatest-lower-bound-uniqueness.pl

@@ -0,0 +1,28 @@
+% Output declarations: materialize/2 selects the relations written to this example's golden output.
+materialize(sameGreatestLowerBound, 4).
+
+% Program structure: facts set up the scenario, and rules derive the materialized conclusions.
+% Greatest-lower-bound uniqueness example adapted from Eyeling
+% greatest-lower-bound-uniqueness.n3.
+% If M and N are both greatest lower bounds of A and B, each is below the other;
+% antisymmetry is represented by the ordinary derived relation sameTerm/2.
+
+glbOf(g1, a, b).
+glbOf(g2, a, b).
+
+% Derivation rules: each rule below contributes one logical step toward the displayed results.
+lowerBoundOf(M, A, B) :- glbOf(M, A, B).
+
+leq(L, M) :-
+  glbOf(M, A, B),
+  lowerBoundOf(L, A, B).
+
+sameTerm(M, N) :-
+  leq(M, N),
+  leq(N, M).
+
+sameGreatestLowerBound(A, B, M, N) :-
+  glbOf(M, A, B),
+  glbOf(N, A, B),
+  sameTerm(M, N),
+  neq(M, N).

package/examples/group-inverse-uniqueness.pl

@@ -0,0 +1,34 @@
+% Group inverse uniqueness, adapted from Eyeling's examples/group-inverse-uniqueness.n3.
+%
+% The output mirrors the Eyeling golden result shape:
+% sameInverse(x, i, j) and sameInverse(x, j, i).
+
+% Output declarations: materialize/2 selects the relations written to this example's golden output.
+materialize(sameInverse, 3).
+
+% Program structure: facts set up the scenario, and rules derive the materialized conclusions.
+element(e).
+element(x).
+element(i).
+element(j).
+
+% Derivation rules: each rule below contributes one logical step toward the displayed results.
+op(e, X, X) :- element(X).
+op(X, e, X) :- element(X).
+op(i, x, e).
+op(x, j, e).
+op(j, x, e).
+op(x, i, e).
+
+sameTerm(X, X) :- element(X).
+sameTerm(i, j).
+sameTerm(j, i).
+
+leftInverse(A, B) :- op(B, A, e).
+rightInverse(A, B) :- op(A, B, e).
+
+sameInverse(A, B, C) :-
+  leftInverse(A, B),
+  rightInverse(A, C),
+  sameTerm(B, C),
+  neq(B, C).

package/examples/hamiltonian-path.pl

@@ -0,0 +1,49 @@
+% Hamiltonian path, adapted from Eyelet's input/hamiltonian-path.pl.
+%
+% The graph is the same six-vertex undirected graph.  eyelang spells the finite
+% vertex set directly and derives every path that visits each vertex exactly
+% once.
+
+% Output declarations: materialize/2 selects the relations written to this example's golden output.
+materialize(hasHamiltonianPath, 2).
+materialize(hamiltonianPath, 2).
+
+% Program structure: facts set up the scenario, and rules derive the materialized conclusions.
+memoize(adjacent, 2).
+
+edge(v1, v2).
+edge(v1, v3).
+edge(v1, v5).
+edge(v1, v6).
+edge(v2, v3).
+edge(v2, v4).
+edge(v2, v6).
+edge(v3, v4).
+edge(v3, v6).
+edge(v4, v5).
+edge(v4, v6).
+
+% Derivation rules: each rule below contributes one logical step toward the displayed results.
+adjacent(V, U) :- edge(V, U).
+adjacent(V, U) :- edge(U, V).
+
+vertex(v1).
+vertex(v2).
+vertex(v3).
+vertex(v4).
+vertex(v5).
+vertex(v6).
+
+hamiltonian_path([A, B, C, D, E, F]) :-
+  vertex(A),
+  vertex(B), adjacent(A, B), not_member(B, [A]),
+  vertex(C), adjacent(B, C), not_member(C, [A, B]),
+  vertex(D), adjacent(C, D), not_member(D, [A, B, C]),
+  vertex(E), adjacent(D, E), not_member(E, [A, B, C, D]),
+  vertex(F), adjacent(E, F), not_member(F, [A, B, C, D, E]).
+
+hasHamiltonianPath(graph, true) :-
+  hamiltonian_path(_Path).
+
+hamiltonianPath(graph, Path) :-
+  hamiltonian_path(Path).

package/examples/hamming-code.pl

@@ -0,0 +1,105 @@
+% Technology example: Hamming(7,4) single-bit error correction.
+%
+% The received word has one corrupted bit. Syndrome bits identify the bad
+% position, then the corrected codeword and decoded payload are derived.
+
+% Output declarations: materialize/2 selects the relations written to this example's golden output.
+materialize(syndrome, 2).
+materialize(errorBit, 2).
+materialize(correctedCodeword, 2).
+materialize(decodedPayload, 2).
+materialize(status, 2).
+materialize(reason, 2).
+
+% Program structure: facts set up the scenario, and rules derive the materialized conclusions.
+received_bit(packet1, 1, 1).
+received_bit(packet1, 2, 0).
+received_bit(packet1, 3, 1).
+received_bit(packet1, 4, 1).
+received_bit(packet1, 5, 1).
+received_bit(packet1, 6, 1).
+received_bit(packet1, 7, 0).
+
+flip(0, 1).
+flip(1, 0).
+
+% Derivation rules: each rule below contributes one logical step toward the displayed results.
+parity4(A, B, C, D, Parity) :-
+  add(A, B, AB),
+  add(AB, C, ABC),
+  add(ABC, D, Sum),
+  mod(Sum, 2, Parity).
+
+syndrome_bit1(Code, S1) :-
+  received_bit(Code, 1, B1),
+  received_bit(Code, 3, B3),
+  received_bit(Code, 5, B5),
+  received_bit(Code, 7, B7),
+  parity4(B1, B3, B5, B7, S1).
+
+syndrome_bit2(Code, S2) :-
+  received_bit(Code, 2, B2),
+  received_bit(Code, 3, B3),
+  received_bit(Code, 6, B6),
+  received_bit(Code, 7, B7),
+  parity4(B2, B3, B6, B7, S2).
+
+syndrome_bit4(Code, S4) :-
+  received_bit(Code, 4, B4),
+  received_bit(Code, 5, B5),
+  received_bit(Code, 6, B6),
+  received_bit(Code, 7, B7),
+  parity4(B4, B5, B6, B7, S4).
+
+syndrome(Code, Syndrome) :-
+  syndrome_bit1(Code, S1),
+  syndrome_bit2(Code, S2),
+  syndrome_bit4(Code, S4),
+  mul(S2, 2, WeightedS2),
+  mul(S4, 4, WeightedS4),
+  add(S1, WeightedS2, Partial),
+  add(Partial, WeightedS4, Syndrome).
+
+corrected_bit(Code, Position, Corrected) :-
+  syndrome(Code, Position),
+  received_bit(Code, Position, Bit),
+  flip(Bit, Corrected).
+
+corrected_bit(Code, Position, Bit) :-
+  syndrome(Code, ErrorPosition),
+  neq(Position, ErrorPosition),
+  received_bit(Code, Position, Bit).
+
+corrected_codeword(Code, [B1, B2, B3, B4, B5, B6, B7]) :-
+  corrected_bit(Code, 1, B1),
+  corrected_bit(Code, 2, B2),
+  corrected_bit(Code, 3, B3),
+  corrected_bit(Code, 4, B4),
+  corrected_bit(Code, 5, B5),
+  corrected_bit(Code, 6, B6),
+  corrected_bit(Code, 7, B7).
+
+decoded_payload(Code, [D1, D2, D3, D4]) :-
+  corrected_bit(Code, 3, D1),
+  corrected_bit(Code, 5, D2),
+  corrected_bit(Code, 6, D3),
+  corrected_bit(Code, 7, D4).
+
+
+errorBit(Code, Position) :-
+  syndrome(Code, Position),
+  gt(Position, 0).
+
+correctedCodeword(Code, Codeword) :-
+  corrected_codeword(Code, Codeword).
+
+decodedPayload(Code, Payload) :-
+  decoded_payload(Code, Payload).
+
+status(Code, single_bit_corrected) :-
+  syndrome(Code, Position),
+  gt(Position, 0).
+
+reason(Code, "Hamming syndrome identifies the flipped bit position") :-
+  syndrome(Code, Position),
+  gt(Position, 0).