cognize 0.1.1

Symbolic cognition engine for epistemic drift, rupture detection, and realignment.

Cognize

Programmable cognition for Python systems

---

Overview

Cognize is a lightweight cognition engine that tracks epistemic drift and enables rupture-aware reasoning in recursive systems.
It models projection (V), reality (R), distortion (∆), misalignment memory (E), and rupture thresholds (Θ) — and supports programmable logic for collapse, realignment, and intervention.

---

Features

• Drift-aware cognitive kernel (EpistemicState)
• Programmable rupture, realignment, and collapse policies
• Misalignment memory tracking with decay
• Symbolic cognition trace export (.json, .csv)
• Compatible with scalar or vector inputs
• DSL-ready via runtime injection (inject_policy)
• Lightweight, dependency-minimal, and test-backed

---

Installation

pip install cognize

---

Core Concepts

Symbol	Meaning
V	Belief / Projection
R	Reality Signal
∆	Distortion
Θ	Rupture Threshold
E	Misalignment Memory

---

Quick Usage

from cognize import EpistemicState

# Initialize agent
agent = EpistemicState(V0=0.0, threshold=0.35)

# Feed scalar signals
for R in [0.1, 0.3, 0.6, 0.8]:
    agent.receive(R)
    print(agent.summary())

# Inject custom rupture logic (optional)
from cognize.policies import collapse_soft_decay, realign_tanh, threshold_adaptive

agent.inject_policy(
    collapse=collapse_soft_decay,
    realign=realign_tanh,
    threshold=threshold_adaptive
)

# Run a new signal cycle
agent.receive(0.5)

# Get drift metrics
print(agent.drift_stats(window=3))

# Export cognition trace
agent.export_json("trace.json")
agent.export_csv("trace.csv")

---

Example Output

{
  "t": 2,
  "V": 0.41,
  "R": 0.6,
  "delta": 0.19,
  "Θ": 0.35,
  "ruptured": false,
  "event": "realign",
  "source": "default"
}

---

Read the full Cognize User Guide

---

License

Licensed under the Apache 2.0 License.

---

© 2025 Pulikanti Sashi Bharadwaj
All rights reserved.