Skip to main content

DeepSigma Core - Drift to Patch governed execution

Project description

CI PyPI License: MIT Python 3.10+ Coherence Score Authority Coverage Drift Density Memory Coverage version LOC tests EDGE workflows

Feature Catalog | TEC Summary | KPI Standards Overlay

DeepSigma

DeepSigma prevents decision amnesia in AI systems.

Log every agent decision. Detect when it drifts. Prove what happened.

Quickstart

pip install deepsigma

# Log an agent decision
coherence agent log decision.json

# Audit all logged decisions
coherence agent audit --json

# Coherence score
coherence agent score

60-Second Proof

coherence demo
BASELINE   90.00 (A)
DRIFT      85.75 (B)   red=1
PATCH      90.00 (A)   patch=RETCON  drift_resolved=true

Three states, deterministic every run:

  1. BASELINE — sealed episode, coherence scored
  2. DRIFT — data changed, drift detected automatically
  3. PATCH — governed retcon applied, coherence restored

Machine-readable: coherence demo --json

What It Does

DeepSigma is the institutional memory layer that makes AI decisions reconstructable.

Every agent decision becomes a sealed, hash-chained episode. Drift between decisions is detected automatically across 8 types. Authority is captured cryptographically, not implied. The full "why" is retrievable in under 60 seconds.

In practice:

  • the "why" is retrievable (not tribal)
  • authority is explicit (not implied)
  • changes are patched, not overwritten
  • drift is detected early and corrected consistently

Editions

One product line, one version, two editions:

  • CORE edition: minimal, demo-first, deterministic (pip install deepsigma)
  • ENTERPRISE edition: extended adapters, dashboards, and ops surfaces (repo-native under enterprise/)

Edition boundary ledger: EDITION_DIFF.md

Operating Modes

Core Mode

Use Core mode when you need fast adoption and low cognitive load.

Active Core surface at repo root:

  • run_money_demo.sh
  • src/core/
  • docs/examples/demo-stack/
  • tests/test_money_demo.py

Enterprise Mode

Use Enterprise mode when you need connectors, dashboards, extended security, broader telemetry, and integration-heavy workflows.

Dependency note:

  • pip install "deepsigma[enterprise]" installs enterprise runtime extras used by telemetry/radar tooling.
  • Full enterprise code surfaces are repository-native under enterprise/ and are run from source in this repo.

Enterprise surfaces are first-class under:

Examples of parked modules:

  • enterprise/dashboard/
  • enterprise/docker/
  • enterprise/release_kpis/
  • enterprise/schemas/
  • enterprise/scripts/
  • enterprise/src/ (non-core packages)
  • enterprise/docs/ (full enterprise docs)

Run the enterprise wedge:

make enterprise-demo
make test-enterprise

Release Artifacts

Build both edition artifacts from one version line:

make release-artifacts

Outputs in dist/:

  • deepsigma-core-vX.Y.Z.zip
  • deepsigma-enterprise-vX.Y.Z.zip

Full Platform References

For the full-platform docs and architecture map, use parked docs directly:

  • enterprise/docs/positioning/positioning_manifesto.md
  • enterprise/docs/positioning/executive_briefing_one_page.md
  • enterprise/docs/release/
  • enterprise/docs/security/
  • enterprise/docs/mermaid/

Repo Snapshot (auto-generated 2026-03-06 04:12 UTC)

  • 1,728 files | 316,029 lines of code
  • 41 CI workflows | 163 test files | 5 pyproject.toml
  • 21 EDGE modules

LOC by extension: .py 105,363 .html 59,838 .json 54,145 .md 47,769 .svg 28,054 .jsonl 5,278 .tsx 2,942 .ttl 2,804 .patch 1,438 .ts 1,244

Repo Intent

  • Keep root focused on a reliable first proof.
  • Keep enterprise depth available without deleting capability.
  • Expand from Core into Enterprise intentionally, not by drift.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deepsigma-2.1.1.tar.gz (233.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

deepsigma-2.1.1-py3-none-any.whl (240.0 kB view details)

Uploaded Python 3

File details

Details for the file deepsigma-2.1.1.tar.gz.

File metadata

  • Download URL: deepsigma-2.1.1.tar.gz
  • Upload date:
  • Size: 233.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for deepsigma-2.1.1.tar.gz
Algorithm Hash digest
SHA256 d9a673b45f8445d69ea58e94657624dc1c02fc6ee2bd1b80b9d2dd680e2ca575
MD5 88dcef5f6542fbb0e7cc2f50532d1c30
BLAKE2b-256 fb071882e3d39d11f5b462308bb31e1e76a75954cdc6268835eab485e1eaf821

See more details on using hashes here.

Provenance

The following attestation bundles were made for deepsigma-2.1.1.tar.gz:

Publisher: publish-deepsigma.yml on 8ryanWh1t3/DeepSigma

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file deepsigma-2.1.1-py3-none-any.whl.

File metadata

  • Download URL: deepsigma-2.1.1-py3-none-any.whl
  • Upload date:
  • Size: 240.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for deepsigma-2.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f281b6e5f662bd1f4262b303dce465ef280b8b6cc8202d179d4f2eeda4b0f419
MD5 63d735ff471d5fbf1be7f66934a94642
BLAKE2b-256 2bbb7e9ee30e1856b12f6adb5fd7da103ecdc24a951e17229935858b9b7466a1

See more details on using hashes here.

Provenance

The following attestation bundles were made for deepsigma-2.1.1-py3-none-any.whl:

Publisher: publish-deepsigma.yml on 8ryanWh1t3/DeepSigma

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page