Skip to main content

DeepSigma Core - Drift to Patch governed execution

Project description

CI PyPI License: MIT Python 3.10+ Coherence Score

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 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.0.tar.gz (141.1 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.0-py3-none-any.whl (143.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: deepsigma-2.1.0.tar.gz
  • Upload date:
  • Size: 141.1 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.0.tar.gz
Algorithm Hash digest
SHA256 0e09cecbc324f419accb31b9fd5086469d2700d583130481786e53d9329da90f
MD5 ef7dbcfc1ba3cfde4be2c7971e8c36eb
BLAKE2b-256 1fad1bb0500839928f7b831e11e3e2342d002cd02342c8959b86710bf2c6dd3a

See more details on using hashes here.

Provenance

The following attestation bundles were made for deepsigma-2.1.0.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.0-py3-none-any.whl.

File metadata

  • Download URL: deepsigma-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 143.4 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 88174a6997bde99154b97be0658a6fe3fc5e899012c261512e1a9b6f1c47ff6e
MD5 d4eb177e5be01ed863836040fd75c5a0
BLAKE2b-256 ebd8eab0ab5176664eee7b250d43be74a5f73fb9ece2c6ebd4a9133646258263

See more details on using hashes here.

Provenance

The following attestation bundles were made for deepsigma-2.1.0-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