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.

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-4.1.0.tar.gz (25.4 kB view details)

Uploaded Aug 31, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

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

Uploaded Aug 31, 2026 Python 3

File details

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

File metadata

Download URL: mneme_code-4.1.0.tar.gz
Upload date: Aug 31, 2026
Size: 25.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mneme_code-4.1.0.tar.gz
Algorithm	Hash digest
SHA256	`bfa7f57f152e9607013567b838428e73b6dfd34721497f78dd1c07460fa1d162`
MD5	`45d538833d66f84c3e110f2d173bcc9e`
BLAKE2b-256	`927f09eec0ab957e95101a72bea8f1af194577accb34ea0d0e1a83a9c1b6a178`

See more details on using hashes here.

Provenance

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

Publisher: release.yml on OnourImpram/mneme

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mneme_code-4.1.0.tar.gz
- Subject digest: bfa7f57f152e9607013567b838428e73b6dfd34721497f78dd1c07460fa1d162
- Sigstore transparency entry: 2666795083
- Sigstore integration time: Aug 31, 2026
Source repository:
- Permalink: OnourImpram/mneme@de0712ca8e00cec52e77fa215329f31d11254be2
- Branch / Tag: refs/tags/v4.1.0
- Owner: https://github.com/OnourImpram
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@de0712ca8e00cec52e77fa215329f31d11254be2
- Trigger Event: push