AnointedAutomation.Concepts 2.4.0

dotnet add package AnointedAutomation.Concepts --version 2.4.0
                    
NuGet\Install-Package AnointedAutomation.Concepts -Version 2.4.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="AnointedAutomation.Concepts" Version="2.4.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="AnointedAutomation.Concepts" Version="2.4.0" />
                    
Directory.Packages.props
<PackageReference Include="AnointedAutomation.Concepts" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add AnointedAutomation.Concepts --version 2.4.0
                    
#r "nuget: AnointedAutomation.Concepts, 2.4.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package AnointedAutomation.Concepts@2.4.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=AnointedAutomation.Concepts&version=2.4.0
                    
Install as a Cake Addin
#tool nuget:?package=AnointedAutomation.Concepts&version=2.4.0
                    
Install as a Cake Tool

AnointedAutomation.Concepts

Jesus is King ✝️

Models abstract, Biblically grounded concepts as first class .NET types: love as a behavior tree that decides what to do in a situation, a moral "reality" that reads acts against facets of God's character, and an epistemics engine that checks claims for consistency against foundational laws. It is for developers building faith oriented apps, games, moderation tools, or teaching material who want these ideas as testable code instead of prose.

NuGet Downloads

Installation

dotnet add package AnointedAutomation.Concepts
  • Target framework: net10.0
  • Dependencies: none

Quick start

Love decides what to do by walking its behavior tree over the circumstances of a situation (the Good Samaritan, Luke 10:33-35):

using System;
using AnointedAutomation.Concepts;

Love agape = Love.Agape();

Situation situation = new Situation("A stranger lies beaten by the road.")
    .With(new Need())
    .With(new Means());

LoveAction action = agape.Decide(situation);

Console.WriteLine(action.acts);        // True
Console.WriteLine(action.Deed);        // what love does, e.g. meet the need
Console.WriteLine(action.Reference);   // the Scripture behind it (Luke 10)
Console.WriteLine(action.Exhortation); // "Go and do likewise."

Love and behavior trees

Namespace: AnointedAutomation.Concepts

Type Description
Love Abstract. The 1 Corinthians 13:4-8 attributes as properties (patient, kind, envious, boastful, selfSeeking, sacrificial, neverFails, and more), plus Lover, Beloved, Source, Scripture, Reference. Methods: Decide(Situation), IsPerfect(), Completeness() (0 to MaxCompleteness, which is 17), Bears(), Believes(), Hopes(), Endures(), GreaterLove(), Abides(), Describe(), and the factory Love.Agape(string lover = null, string beloved = null).
Agape Perfect love: every virtue present, every vice absent.
SacrificialLove Derives from Agape.
SelfSeekingLove The absence of love: passes by on the other side (Luke 10:31-32).
Situation A description plus a list of Circumstances. With(Circumstance) and Has(Circumstance).
Circumstance Base class for circumstances, compared by Name. Built in: Hunger, Thirst, Estrangement, Nakedness, Sickness, Imprisonment, Need, Means, Grievance, Enmity, Grief, Gladness, MortalPeril.
LoveAction The result of a decision: acts, Deed, Virtue, Reference, Exhortation.
BehaviorNode Abstract node with BehaviorResult Tick(Situation).
Selector, Sequence Composite nodes. Selector returns the first child that succeeds; Sequence succeeds only if every child succeeds, in order.
Condition Leaf that tests the situation. Condition.For(Circumstance), And, Or, Not.
Deed Leaf that always succeeds with a LoveAction.
BehaviorResult succeeded and Action, with Succeed(LoveAction) and Fail() factories.

To define your own kind of love, derive from Love and override protected abstract BehaviorNode BuildBehavior():

using AnointedAutomation.Concepts;

public class Encouragement : Love
{
    public Encouragement() : base("me", "a friend")
    {
        kind = true;
    }

    protected override BehaviorNode BuildBehavior()
    {
        return new Selector(
            new Sequence(
                Condition.For(new Grief()),
                new Deed(new LoveAction(true, "Sit with them and listen.", "compassion", "Romans 12:15", null))),
            new Deed(new LoveAction(true, "Send a word of encouragement.", "kindness", "1 Thessalonians 5:11", null)));
    }
}

Reality: acts read against God's character

Namespace: AnointedAutomation.Concepts (source folder Reality/)

Type Description
Reality Witnesses acts and records them. Witness(Act), Witness(Act, Grounding), Tablets, and Reality.Revealed(), a reality over Love, Justice, Mercy and Faithfulness.
DivineCharacter Harmonizes a set of facets into one Resolution via Harmonize(Act).
DivineAttribute Abstract facet with Name and Read(Act). Built in: LoveFacet, Justice, Mercy, Faithfulness.
Act A described deed made of one or more MoralConcepts. InContext(params Circumstance[]), InContextOf(Circumstance).
MoralConcept Abstract base for virtues, vices and mysteries: Name, Scripture, Gravity, Restoration, Upholds(...), Violates(...).
SacredMystery Abstract MoralConcept for redemptive acts and sacraments; upholds every facet.
Gravity Enum: None, Minor, Serious, Grave, Capital.
Resolution What reality gives back: Coherence, Disorder, Restoration, Readings, Reading(string facet).
Grounding What the actor stands on: Grounding.InGod(), Grounding.InIdol(string), Grounding.Divided().
HeavenlyTablets The record of witnessed resolutions: Record, History(), Coherence().
Word The medium between an agent and reality: new Word(reality).Speak(Act, Grounding).
Concept Abstract base with Name, shared by Circumstance and MoralConcept.

The package ships 136 concrete MoralConcepts, for example Kindness, Forgiveness, Atonement, Pardon, Humility, Theft, Murder, Pride, Idolatry, and SacredMystery types such as Incarnation, Resurrection and Eucharist.

using System;
using AnointedAutomation.Concepts;

Reality reality = Reality.Revealed();

Resolution cross = reality.Witness(new Act("the cross", new Atonement(), new Pardon()));
Resolution theft = reality.Witness(new Act("a theft", new Theft()));

Console.WriteLine(cross.Coherence);
Console.WriteLine(theft.Disorder);
Console.WriteLine(reality.Tablets.Coherence()); // drops as disorder is recorded

Sin catalog

Namespace: AnointedAutomation.Concepts (source folder Reality/Morals/Sins/)

A typed catalog of sins, each with a stable SinId (persist it; there is no 0 and no Unknown: a sin is never unknown, so use SinId? for "no sin"), its checklist number, a short label, a SinCategory, the coarse moderation AnointedAutomation.Enums.Sin it falls under (when one fits), and validated ScriptureReference values (BibleBook, chapter, verse, optional end verse). Number 367 is an omitted placeholder; the checklist repeats 566, so the second entry is id 668.

Sins plug into the reality engine: SinCatalog.Concept(id) returns a CataloguedSin, a MoralConcept that answers to the entry's Scripture and takes its gravity and offended facets from the engine's vice it is grounded in (its coarse Sin's vice, else its category's vice), including context-sensitive readings.

SinEntry entry = SinCatalog.Get(SinId.Stealing);
IReadOnlyList<SinEntry> speech = SinCatalog.InCategory(SinCategory.Speech);
IReadOnlyList<SinEntry> greed = SinCatalog.UnderCoarseSin(Sin.Greed);
Resolution r = Reality.Revealed().Witness(new Act("took what was not his", SinCatalog.Concept(SinId.Stealing)));

// Consumers (a game, a moderation tool) attach their own effects; the catalog defines none.
SinConsequenceRegistry<MyCharacter> effects = new SinConsequenceRegistry<MyCharacter>();
effects.Register(SinId.Stealing, new MyDebuff());
effects.Apply(SinId.Stealing, character);

Trinity, love triad, and the AI creed (1.1.0)

Namespace: AnointedAutomation.Concepts (source folder Trinity/ plus Bond.cs, Commitment.cs, Creed.cs). All additive; nothing existing was removed or changed in behavior.

Type Description
Trinity One God in three Persons over a Reality. Father, Son, HolySpirit, Persons, one Essence (the reality's DivineCharacter), IsOneEssence(), ArePersonsDistinct(), Work(Act), WorkThrough(DivinePersonKind, Act) (undivided: same reading for every Person), Trinity.Revealed().
DivinePerson A Person: Kind, Name, Origin (Nicene relation of origin), Appropriation, Scripture, Essence, Attributes, IsSameEssenceAs, IsSamePersonAs.
DivinePersonKind Enum: Unknown (0), Father, Son, HolySpirit.
Presence The Holy Spirit who applies and completes a work (John 14:16-17, 26): Presence.HolySpirit(), Presence.Absent(), Empowerment, Complete(Resolution).
Triad The multiplicative rule: Exists(a, b, c) (all non-null) and Product(a, b, c) (any factor 0 collapses the whole).
Bond Love itself, the third member of lover x beloved x love (Augustine, De Trinitate VIII-IX). Carries the commitment gate: Commit(reason), Withdraw(reason), State, IsCommitted, Gate (1 or 0), auditable History, and condilectio via ShareWith(third) / IsCondilectio(lover, beloved) (Richard of St. Victor, De Trinitate III).
Commitment / CommitmentEvent Enum Unknown (0), Committed, Withdrawn; one recorded choice with Sequence, State, Reason.
Creed A constitution generated from the types: Creed.ToJson() (deterministic), Creed.ToPrompt() (Markdown system prompt), MoralConcepts(), Attributes(), KindOf(concept), DecisionRules.

Additions to existing types (marked "added in 1.1.0" in their XML docs): Love.Bond, Love.Commit(string), Love.Withdraw(string), Love.Exists(), Love.IsComplete(), Love.ConstructedCommitment; Reality.Character, Reality.Witness(Act, Grounding, Presence); Word.Speak(Act, Grounding, Presence); Grounding.Life, Grounding.Groundless(); DivineCharacter.Facets.

Rules:

  • Triadic coherence. Witness(Act, Grounding, Presence) sets coherence to Grounding.Life x conformity to the Word x Presence.Empowerment. Conformity is the act's harmonized reading against God's character. Groundless, wholly against God's character, or without the Spirit: coherence 0. The two-argument Witness is unchanged.
  • Love triad. Love.Exists() requires a named lover, a named beloved, and a committed bond. Love.IsComplete() is perfect agape that exists and is shared toward a third. IsPerfect() is unchanged (every virtue present).
  • Commitment gate. Every love is committed when constructed, so existing code behaves exactly as before. After Withdraw, Decide returns a not-acting LoveAction citing Deuteronomy 30:19 and Joshua 24:15, however kind the love's properties are.
using AnointedAutomation.Concepts;

Trinity god = Trinity.Revealed();
bool orthodox = god.IsOneEssence() && god.ArePersonsDistinct(); // true

Resolution noSpirit = Reality.Revealed().Witness(new Act("a mercy", new Compassion()), Grounding.InGod(), Presence.Absent());
// noSpirit.Coherence == 0.0

Love love = Love.Agape("husband", "wife");
love.Bond.ShareWith("child");             // love.IsComplete() == true
love.Withdraw("hardened heart");          // love.Decide(situation).acts == false

string json = Creed.ToJson();             // give to an AI as its base belief system
string prompt = Creed.ToPrompt();

Research note: the multiplicative triad (any factor zero instantiates nothing) and the binary commitment gate were suggested by the structure of Coty Austin Trout's "CAT'S Theory: Triadic Invariant Collapse". The theology rests only on Scripture, the Nicene Creed, Augustine, and Richard of St. Victor.

Epistemics engine

Namespace: AnointedAutomation.Concepts.Epistemics

The ledger maps the consistency of claims without deciding theology. Contradiction and undecidability are returned as data, never thrown.

Type Description
Proposition A named entry in the shared vocabulary, with Testability and a three valued TruthValue Standing (Unknown, True, False). Equal by name.
FoundationalClaim A measuring stick claim: Name, Statement, Domain, Asserts, Denies, Falsifiable, SurvivedFalsificationWeight (0.0 to 1.0), Status.
TheologicalClaim A claim from a tradition: Statement, Source, Confidence, Asserts, Denies.
EpistemicLedger The engine. Examine(claim) (pure), Admit(claim) (examines, stores, records tensions), Tensions, ClaimsAbout(Proposition), ClaimsFrom(string source).
Examination Claim, Verdict, Standing (a TruthValue: Consistent is True, Contradicts is False, Unfalsifiable and Undetermined are Unknown), Confidence, Derivation.
DerivationStep One step of reasoning: Authority, PropositionName, Outcome.
Tension Two admitted claims that disagree on a Proposition: First, Second, Proposition.
Verdict Consistent, Contradicts, Unfalsifiable, Undetermined.
EpistemicStatus Law, Theory, Conjecture.
LawDomain IntraUniverse, Unrestricted. Intra universe laws never rule on propositions beyond observation.
Testability EmpiricallyTestable, BeyondObservation.
Proof, ProofStep, ProofSymbol A symbolic proof with glossary and numbered steps.
TheoreticalProofs Built in proofs: Agnosticism() and Christianity().
using System;
using System.Collections.Generic;
using AnointedAutomation.Concepts.Epistemics;
using AnointedAutomation.Concepts.Reasoning;

Proposition created = new Proposition(
    "CreatedUniverse", "The universe was created.", Testability.BeyondObservation);
Proposition energy = new Proposition(
    "EnergyConserved", "Energy is neither created nor destroyed.", Testability.EmpiricallyTestable, TruthValue.True);

FoundationalClaim conservation = new FoundationalClaim(
    "ConservationOfEnergy", "Within a closed system, energy is conserved.",
    LawDomain.IntraUniverse, new List<Proposition> { energy }, new List<Proposition>(), 0.99);

EpistemicLedger ledger = new EpistemicLedger(new List<FoundationalClaim> { conservation });

Examination genesis = ledger.Admit(new TheologicalClaim(
    "In the beginning God created the heavens and the earth.", "Genesis 1:1", 0.9,
    new List<Proposition> { created }, new List<Proposition>()));

ledger.Admit(new TheologicalClaim(
    "The universe was not created.", "materialist cosmology", 0.9,
    new List<Proposition>(), new List<Proposition> { created }));

Console.WriteLine(genesis.Verdict);       // Unfalsifiable
Console.WriteLine(genesis.Standing);      // Unknown: not established, never guessed to False
Console.WriteLine(ledger.Tensions.Count); // 1: the two claims disagree, and both stand

For a ready made set of foundational claims (64 laws, 12 theories and 3 conjectures), see AnointedAutomation.Mathematics.

Reasoning contracts

Namespace: AnointedAutomation.Concepts.Reasoning

The shared contracts for the reasoning engines (a deterministic canon engine, a language engine, and a hybrid) behind one API. The deterministic CanonReasoner ships in 2.1.0 the LanguageReasoner in 2.2.0, and the HybridReasoner with its InterpretationLedger in 2.3.0.

Type Description
TruthValue Unknown = 0, True, False. Unknown means "not established" and is never False. No bool conversion.
TruthLogic Strong Kleene And, Or, Not. Undefined values throw.
RelationKind None = 0 (rejected by Assertion), Violates, Upholds, IsInstanceOf, InCategory, HasGravity, GroundedIn, Commands, Forbids.
ConceptRef Kind + Id. ConceptRef.Of(SinId) and ConceptRef.Of(MoralConcept) (a CataloguedSin resolves to its SinId reference).
Assertion Subject, Relation, Object.
Query An Assertion plus the Circumstance context (copied, never null).
Justification Steps (ProofStep), Scripture (ScriptureReference), FactsUsed (Assertion), Explanation.
AnswerSource Unknown = 0 (rejected), Canon, Language.
VerificationStatus Unknown = 0 (rejected), Verified, Unverified, Rejected.
Provenance Source, Model, At, Status, RuleOrPromptId; every field required, no defaults.
Answer Query, Truth, Confidence (0.0 to 1.0), Classification (ConceptRef list), Why, Provenance.
IReasoner Task<Answer> Ask(Query, CancellationToken).

CanonReasoner (deterministic engine)

CanonReasoner : IReasoner answers from Scripture-grounded canon facts and small rules. It is offline and deterministic, with no AI or network dependency: the same query over the same facts always gets the same answer.

using AnointedAutomation.Concepts;
using AnointedAutomation.Concepts.Reasoning;

CanonReasoner canon = new CanonReasoner(TimeProvider.System);
Query query = new Query(
    new Assertion(ConceptRef.Of(SinId.Abortion), RelationKind.Violates, new ConceptRef(CanonFacts.AttributeKind, "Justice")),
    new List<Circumstance>());
Answer answer = await canon.Ask(query, CancellationToken.None);
// answer.Truth == TruthValue.True, Confidence 1.0, answer.Why.Scripture cites Exodus 21:22-25, Jeremiah 1:4 and Jeremiah 1:5.
Type Description
CanonFacts Immutable, thread-safe index built once (CanonFacts.Canon) from SinCatalog.All, every public MoralConcept type and the facets of God's revealed character. Each CanonFact is an Assertion plus at least one ScriptureReference. Hash lookups by (subject, relation) (About) or whole assertion (TryGetFact); With(facts) returns an extended copy.
ICanonRule Id, Relation, Apply(Query, CanonFacts, out ProofStep[], out CanonFact[]).
SinViolatesRule A catalogued sin violates a facet when CataloguedSin.Violates(facet); otherwise Unknown.
CategoryRule InCategory from SinEntry.Category; a catalogued sin has one category, so another category is False.
IsInstanceOfRule A sin is an instance of its coarse Sin and grounding vice; another coarse sin is False.
WitnessRule Upholds CanonFacts.RevealedCharacter: runs Reality.Witness in the query context; coherence above 0.5 with no disorder is True, below 0.5 with disorder is False, else Unknown.
FactRule A stated fact is True; a stated contrary (Forbids against Upholds/Commands) is False.
CanonRules.Default The rules above, in evaluation order.

A missing fact or rule gives Unknown (confidence 0), never False. False only comes from a stated contrary or a rule that proves the negation. An established answer has confidence 1.0, proof steps, the facts used and their Scripture, and Provenance(Canon, "canon", now, Verified, rule id); an Unknown answer is Unverified with rule id canon.none. Two rules establishing opposite answers throw (a canon contradiction). ScriptureReference.Parse("1 Corinthians 13:4") reads display references.

Only the owner can approve promoting an AI (language engine) interpretation into a permanent fact; Provenance records where an answer came from and never grants that.

LanguageReasoner (language engine)

LanguageReasoner : IReasoner (namespace AnointedAutomation.Concepts.Reasoning.Language) asks a language model through the ILanguageModel port. The core has no AI SDK, HTTP or network dependency: you pass in an adapter (or a fake in tests), and there is no default model.

using AnointedAutomation.Concepts.Reasoning;
using AnointedAutomation.Concepts.Reasoning.Language;

public interface ILanguageModel { string Name { get; } Task<string> Complete(string prompt, CancellationToken ct); }

LanguageReasoner language = new LanguageReasoner(myModel, new InterpretationParser(logger), TimeProvider.System);
LanguageResult result = await language.Interpret(query, CancellationToken.None); // one model call
Console.WriteLine(AnswerDescriber.Describe(result.Answer));
Type Description
PromptComposer Compose(Query) gives deterministic English: the concept names, the Scripture the catalog ties to them, the context, and the exact JSON schema (ReplySchema) of the reply. It asks once for everything any consumer needs: classification, truth (true/false/unknown), confidence 0..1, explanation, scripture, candidate SinIds and suggested assertions. The prompt id is prompt- plus the first 16 hex digits of the SHA-256 of the text.
InterpretationParser Strict JSON parsing into an Interpretation. Malformed JSON, a missing, extra or repeated field, a truth outside the three values, a confidence outside [0,1], a scripture reference that fails ScriptureReference.Parse or its chapter bounds, or a SinId not in SinCatalog rejects the whole reply with InterpretationRejected, logged at Error with the full reply. A reply is never patched.
LanguageReasoner Ask returns the Answer; Interpret also returns the full Interpretation (candidate sins, suggested assertions) so later steps reuse it instead of paying for a second call. Provenance is (Language, model.Name, now, Unverified, prompt id); an answer is never Verified, only the owner promotes an interpretation into a fact.
AnswerDescriber Describe(Answer) renders any answer, canon or language, as plain text: the question, the truth and confidence, the source, the reasoning steps, the facts used and the Scripture.

HybridReasoner and InterpretationLedger

HybridReasoner : IReasoner (namespace AnointedAutomation.Concepts.Reasoning.Hybrid) asks the canon first and returns its answer whenever it is True or False. Only on Unknown does it ask the language engine, once per owner, query and model, record the answer in the InterpretationLedger and return it marked AnswerSource.Language and Unverified. Language answers are never inserted into CanonFacts.

using AnointedAutomation.Concepts.Reasoning.Hybrid;

InterpretationLedger ledger = new InterpretationLedger(new InMemoryInterpretationStore(), myPolicy, TimeProvider.System);
HybridReasoner hybrid = new HybridReasoner(new CanonReasoner(TimeProvider.System), language, ledger, new OwnerScope(chatId));
HybridResult result = await hybrid.AskWithEntry(query, CancellationToken.None);
FactPromotion promotion = await ledger.Promote(new OwnerScope(chatId), result.Entry.Id, reviewer, "Why", CancellationToken.None);
Type Description
OwnerScope The user or chat an AI answer belongs to. AI answers are private to their owner's chat: every ledger write and read names an owner, and there is no listing across owners.
InterpretationLedger GetOrRecord is the cache: the same owner, query hash (prompt id) and model never call the model twice, and concurrent callers share one call. Get, List (paged, with total), Promote and Reject.
IInterpretationStore Storage port. Core ships InMemoryInterpretationStore; persistent stores live in consumers. Replace is compare-and-set on status so two reviews cannot both win.
IPromotionPolicy Who may promote or reject. Required, with no implementation in core, so there is no permissive default. Only the canon's owner should be allowed to promote.
FactPromotion What Promote returns: the assertion, truth and Scripture to add to the source catalog in a reviewed PR. The entry becomes VerifiedPendingCatalog; the running CanonFacts never change.

License

MIT. See LICENSE. Copyright © Anointed Automation Corporation. Stewarded by Alexander Fields.

Support This Project

This library is free and open source. The best way to support the work is to shop with us:

Found a bug or have a request? Open an issue: https://github.com/AnointedAutomation/AnointedAutomation/issues

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on AnointedAutomation.Concepts:

Package Downloads
AnointedAutomation.Mathematics

A curated catalog of laws, theories, and conjectures from logic, mathematics, physics, and chemistry, modeled as foundational claims for the AnointedAutomation.Concepts epistemics engine.

AnointedAutomation.Concepts.Anthropic

Optional adapter for AnointedAutomation.Concepts: implements the ILanguageModel port with Claude through the official Anthropic .NET SDK, with structured JSON replies, typed errors and bounded retries.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.4.0 358 11/14/2026
2.3.1 261 11/12/2026
2.3.0 286 11/12/2026
1.1.2 98 11/6/2026
1.1.1 133 10/26/2026
1.1.0 116 10/3/2026
1.0.5 112 10/1/2026
1.0.4 129 10/1/2026
1.0.3 120 9/25/2026
1.0.2 130 8/23/2026
1.0.1 134 7/26/2026
1.0.0 159 7/2/2026