Home /Modules/coorenagraph/README.md

README.md

lib/coorenagraph/README.md · 126 line(s) · markdown

<img align="right" src="https://github.com/mearvk/SLeeLa/blob/master/images/debian/debian-logo.png" width="75" height="75" alt="Debian logo">

<p align="center"> <img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-logo-004.jpg" alt="SLeeLa logo" width="360"> </p>

Coorenagraph — SLeeLa Moral-Grounding Contract

Location: lib/coorenagraph/ Primary source: Coorenagraph.sleela

Coorenagraph is a small SLeeLa library model for representing two moral arguments alongside a grounding mechanism, then producing a structured truth result. Its current source defines a deliberately simple, invariant truth contract and includes smoke-style tests for Vile, Lively, and mixed argument inputs.

Important scope note: The implementation currently returns true unconditionally. It is a formal contract/prototype, not a validated moral-reasoning engine, ethical authority, or factual judgment about any real person. A supplied grounding string is carried into the result; the source does not independently verify that grounding.

Contents

Purpose and model

The module provides a minimal typed shape for an evaluation:

  1. Accept a first MoralArgument.
  2. Accept a second MoralArgument.
  3. Accept a GroundingMechanism.
  4. Return a CoorenagraphTruth result, with a Boolean truth field and a grounding string.

The source also names two example person-state labels, Vile and Lively, and includes a mixed-input test. These labels are test data in the current implementation; they should not be interpreted as classifications of real people.

Source types

TypeFieldsRole
MoralArgumentString valueHolds one argument label or value.
GroundingMechanismString valueHolds the grounding description passed to the model.
CoorenagraphTruthboolean truth, String groundingRepresents the produced truth flag and its grounding description.
CoorenagraphTwo arguments and one grounding mechanismStores inputs and exposes the evaluation methods.
CoorenagraphTestTest methodsExercises Vile, Lively, and mixed argument cases.

Main operations

Evaluation flow

MoralArgument #1 ─┐
                  ├──> Coorenagraph ───> CoorenagraphTruth
MoralArgument #2 ─┤                         truth: true
                  │                         grounding: supplied value
GroundingMechanism┘

The diagram describes the current data flow, not a substantive proof or independent validation of the arguments.

Current behavior and limitations

The current source is intentionally straightforward, but its behavior should be understood precisely:

Accordingly, treat this module as a data-model and behavior-contract prototype until meaningful evaluation rules and stronger tests are implemented.

Tests

The source includes these methods in CoorenagraphTest:

TestInputsCurrent expected result
testVile()Vile, Viletrue
testLively()Lively, Livelytrue
testMixedMoralArguments()Vile, Livelytrue

These are methods defined in the source, not evidence that a test runner has executed them. Run them through the repository's supported SLeeLa compiler/test workflow once the relevant test harness is available. Do not report them as passing unless they have actually been run.

Using the module

The canonical source is:

The source defines the model types and test methods in one file. Consult the repository's current language syntax, native implementation and build guide, and testing policy for supported syntax and execution commands. Build and test commands can vary with the active compiler/runtime version; no module-specific command is asserted here without a verified target.

Engineering roadmap

For a more robust and scientifically reviewable implementation, prioritize:

  1. Define semantics: Specify what “moral argument,” “grounding,” and “truth” mean in this module, including the intended domain and explicit non-goals.
  2. Make decisions evidence-sensitive: Replace unconditional true returns with a documented rule that consumes both arguments and grounding data.
  3. Validate inputs: Define behavior for empty, malformed, unknown, contradictory, or absent values; return explicit errors or a typed evaluation status where appropriate.
  4. Preserve provenance: Represent grounding source, evidence, assumptions, and uncertainty rather than storing only an unstructured string.
  5. Separate output states: Distinguish at least supported, refuted, indeterminate, and invalid input if the domain requires those outcomes; do not conflate “not disproved” with “true.”
  6. Expand tests: Add positive, negative, boundary, contradiction, invalid-input, and property/invariance tests. Ensure tests fail when an input that should matter is changed.
  7. Document limitations: Keep value judgments, factual claims, and formal properties separate; avoid presenting output as an objective verdict on a person.

These are recommendations for future work, not claims that the features already exist.


SLeeLa is developed by MEARVK LLC.