kodingo-core

Purpose

This repository contains the core domain logic of Kodingo.

It is responsible for understanding why code changes happen by:

• Processing events
• Inferring decisions
• Writing memory
• Managing confidence
• Reconciling assertions over time

This repository is intentionally interface-agnostic.

What This Repo Owns

• Event processing pipelines
• Decision inference logic
• Memory lifecycle management
• Confidence calculation
• Assertion reconciliation
• Conflict resolution logic (logical, not Git-level)

What This Repo Does NOT Do

• No CLI commands
• No terminal interaction
• No Git commands
• No filesystem watching
• No authentication UX
• No billing logic

Core Invariants

• Every code change produces memory
• Decisions may exist without assertions
• Confidence may be low without human input
• Silence is treated as data
• Memory is immutable; confidence and assertions evolve

Dependencies

• Depends on kodingo-schema
• Must never depend on kodingo-cli

Architecture Notes

• Input: normalized events (from CLI or other adapters)
• Output: structured memories and decisions
• All side effects are explicit
• No hidden state

Change Discipline

Any logic added here must be:

• Deterministic
• Auditable
• Explainable

If it cannot be explained, it does not belong here.

Status

Core domain modeling phase.