Skip to main content

Deterministic Python code-failure memory layer for mneme: redact-before-store, provenance-labelled FailureMemory, vault-ready markdown output.

Project description

mneme-code

Deterministic Python code-failure memory for mneme. Parses CPython tracebacks into structured failures, renders them as vault-ground-truth markdown memories, and resolves stack frames to mneme-graph function nodes.

Part of the mneme memory engine.

What it does (v1)

  • Traceback parsing. parse_traceback turns a standard CPython traceback into a ParsedTraceback (exception type, message, frames). It never raises; unrecognised input returns None.
  • Failure memories. failure_from_traceback + failure_to_markdown produce a markdown note the user owns, with provenance (content_hash, observed_at, trust) and a confidence label.
  • Frame resolution. resolve_frames pairs each frame with a mneme-graph function node when one matches, with a clean fallback to None.

Redaction (mneme_core.privacy.redact) is applied to every user-derived string (exception message, code context, file path) before it is stored or rendered. No LLM, no network; library functions are pure (the caller injects timestamps).

Scope and deferrals (v1)

The following are not implemented yet and are documented here for honesty:

  • Live test-runner integration.
  • Branch-aware failure tracking.
  • AGENTS.md procedural-memory parsing and repo runbook generation.
  • Fix-trajectory wiring: a fix is modelled as a mneme-temporal claim that supersedes the failure memory. That lifecycle lives in mneme-temporal and is reused, not reinvented here.
  • Non-Python tracebacks.

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

mneme_code-3.5.0.tar.gz (25.3 kB view details)

Uploaded Source

Built Distribution

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

mneme_code-3.5.0-py3-none-any.whl (21.4 kB view details)

Uploaded Python 3

File details

Details for the file mneme_code-3.5.0.tar.gz.

File metadata

  • Download URL: mneme_code-3.5.0.tar.gz
  • Upload date:
  • Size: 25.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for mneme_code-3.5.0.tar.gz
Algorithm Hash digest
SHA256 54b70ad0185cadf776c67763c46e687792df6d2e42300cdb54693323d21bf479
MD5 2abbe354e9130c3319d1449deceaeb7c
BLAKE2b-256 91f16a5904629d5ae62f9ab19eb455df8696bb708d59de68f65064dde26d3c22

See more details on using hashes here.

Provenance

The following attestation bundles were made for mneme_code-3.5.0.tar.gz:

Publisher: release.yml on TheGoatPsy/mneme

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

File details

Details for the file mneme_code-3.5.0-py3-none-any.whl.

File metadata

  • Download URL: mneme_code-3.5.0-py3-none-any.whl
  • Upload date:
  • Size: 21.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for mneme_code-3.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e7008f9c75aa319fc66453b4fee09636a341a716cad064ae106a25d9a5096f2e
MD5 665883358a0459f26fcb6dfc03c3c2c5
BLAKE2b-256 91bebb25cba794aa897b81173f2c12b1220b8adb1a2df741c2ec61b13ca58003

See more details on using hashes here.

Provenance

The following attestation bundles were made for mneme_code-3.5.0-py3-none-any.whl:

Publisher: release.yml on TheGoatPsy/mneme

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