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.2.0.tar.gz (25.2 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.2.0-py3-none-any.whl (21.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mneme_code-3.2.0.tar.gz
  • Upload date:
  • Size: 25.2 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.2.0.tar.gz
Algorithm Hash digest
SHA256 e3baacbe4f7de9003f03475cdc8bcff1aa03b41c6b896c719e02b4b1cb36e37a
MD5 3226a34ef7474027f76cfd317d9c9e52
BLAKE2b-256 ae2e0b1ccba1120e28b8d04c95d84c684ecdf41b4af507ad2f6f53e115b3709d

See more details on using hashes here.

Provenance

The following attestation bundles were made for mneme_code-3.2.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.2.0-py3-none-any.whl.

File metadata

  • Download URL: mneme_code-3.2.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.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cb4715ec811e6413ed689cdde2be69fa8e64f82e17ef7d627e9093fc25388b5d
MD5 edf7e46f1e0ea9b7363ad21d84f0aebb
BLAKE2b-256 1714317c5e1cd0b550d0b78afa19ef396c63303d6581fa5c752d86601476b37d

See more details on using hashes here.

Provenance

The following attestation bundles were made for mneme_code-3.2.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