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:33 UTC)

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

LOC by extension: .py 105,380 .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.2.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.2-py3-none-any.whl (240.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: deepsigma-2.1.2.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.2.tar.gz
Algorithm Hash digest
SHA256 79d2fe05bf0434ccf0317acd94dad80b7ef25513f9b93188636bf6265446992b
MD5 197e3bfca683fd2736026a41706f5d02
BLAKE2b-256 483dee18c49a66b11e9a8b10e73f01802aa9cd77aee4402da4a3ecdd8802766d

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: deepsigma-2.1.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 5f38379afb4ddc191d4045856b75b43152f96311549c2ec32d57c70fa68fc80f
MD5 6ca34964c56968f654f3e029a288b313
BLAKE2b-256 f82f0787e2e9e9c5f0248b183ddbf1053390b71b2bae2b8290a3de415b5bd80c

See more details on using hashes here.

Provenance

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