memorytrace 0.1.0__py3-none-any.whl

memorytrace-0.1.0.dist-info/METADATA

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: memorytrace
+Version: 0.1.0
+Summary: AI agent memory system with SQLite+FTS5, MCP integration, and quality gates
+Project-URL: Homepage, https://github.com/engram-memory/engram
+Project-URL: Issues, https://github.com/engram-memory/engram/issues
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,fts5,llm,mcp,memory,sqlite
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5.0; extra == 'dev'
+Provides-Extra: full
+Requires-Dist: engram[llm]; extra == 'full'
+Requires-Dist: engram[mcp]; extra == 'full'
+Requires-Dist: engram[semantic]; extra == 'full'
+Provides-Extra: llm
+Requires-Dist: anthropic>=0.40.0; extra == 'llm'
+Requires-Dist: openai>=1.50.0; extra == 'llm'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
+Provides-Extra: semantic
+Requires-Dist: numpy>=1.24.0; extra == 'semantic'
+Description-Content-Type: text/markdown
+
+# Engram
+
+AI agent memory that learns across conversations.
+
+## Install
+
+```bash
+pip install git+https://github.com/aop60003/default.git
+```
+
+## Use
+
+```bash
+engram save "Minseong Jeong is the Space King of Galaxy Corp"
+engram find "Space King"
+engram who "Minseong Jeong"
+```
+
+That's it. 3 commands. No config, no API keys, no database setup.
+
+## All Commands
+
+```
+engram save "text"                   Save information (auto-extracts entities & facts)
+engram find "query"                  Search memory
+engram who "name"                    Look up a person/org
+engram remember "name" "fact"        Manually remember something
+engram all                           List everything
+engram status                        Health check
+engram forget "name"                 Delete an entity
+engram export                        Export to Markdown files
+```
+
+## Examples
+
+```bash
+# Store meeting notes
+engram save "Met Alice Johnson, VP of Engineering at Google. Discussed cloud AI partnership."
+
+# Store Korean
+engram remember "정민성" "AI와 우주 탐사에 관심이 많다"
+
+# Search later
+engram find "Google partnership"
+engram who "Alice Johnson"
+
+# Check status
+engram status
+```
+
+## What It Does Automatically
+
+- **Extracts** people & organizations from text (English, Korean, Chinese, Japanese)
+- **Masks PII** — phone numbers, credit cards, emails become `[REDACTED]`
+- **Deduplicates** — same fact won't be stored twice
+- **Detects conflicts** — "CEO" then "CTO" for same person gets flagged
+- **Generates summaries** — auto-summary when you don't provide one
+- **Learns across sessions** — every conversation builds on previous ones
+
+## For Claude Code Users
+
+Add slash commands to use memory inside Claude Code:
+
+```bash
+# Copy command files
+mkdir -p ~/.claude/commands
+# See docs/04-usage-guide/02-claude-code-setup.md for details
+```
+
+Then use: `/memory-save`, `/memory-find`, `/memory-who`, `/memory-remember`, `/memory-status`
+
+## For Developers (Python SDK)
+
+```python
+from engram.integrations.sdk import EngramSDK
+
+with EngramSDK() as sdk:
+    sdk.store("Minseong Jeong is the Space King of Galaxy Corp")
+    result = sdk.search("Space King")
+    print(result.to_agent_context())
+```
+
+## How It Works
+
+```
+Text → NER Extraction → Quality Gate → SQLite+FTS5 → BM25 Search
+                              ↓
+                     Confidence Scoring
+                     PII Masking
+                     Duplicate Check
+                     Conflict Detection
+```
+
+- **Storage**: SQLite + FTS5 (zero dependencies, genuine BM25)
+- **Export**: Markdown files for human reading
+- **Session**: Context carries over between conversations
+
+## License
+
+MIT

memorytrace-0.1.0.dist-info/RECORD

@@ -0,0 +1,54 @@
+engram/__init__.py,sha256=_F7kaif7XsEyCIMr4fR4pk9_AmtDqgljvj6tPOkzGOs,278
+engram/__main__.py,sha256=CbZN8Vi06_9QRGEogaDZZv-_1PzvwXjrx1dBR1rjP-k,115
+engram/config.py,sha256=m2FUU-DguXbwkpbt2PqyTSGpEcWIDv6nrnG3gLlzu8Q,2315
+engram/engine.py,sha256=hdMYpVeAa-lrGG88GDOX8LAuk6wGflWfTeW0AUgSyIU,24655
+engram/exceptions.py,sha256=cUXgVOW2MKRV_azh4iE_hWCWo1FdoiU_EAWY-5iEzaQ,954
+engram/cli/__init__.py,sha256=6ONMgTbEG23DpKEZw7bkixkff_sOvy6kYvTAFx2yLhY,32
+engram/cli/app.py,sha256=poMhsCrJ25HDeuIxpb-rw_RJjbrgBTWbQcAIEdqBda4,10474
+engram/cli/formatters.py,sha256=rwI2YLNn-PefDVVtJ_FkzWYZTiFL5H-zoG9Hn8Wu37c,3384
+engram/cli/simple.py,sha256=MdNnj0gkr-5VFvPtCY686p70NN5Mqt-qlYFJHsuy1hY,9022
+engram/extraction/__init__.py,sha256=eJ5cjat9Ltdt6mFZ3qH2CVlKwvGWffgKw03R26LzhQM,186
+engram/extraction/base.py,sha256=d-tXvbYRK2GgbNrmDaSDwN_d0Pl0cvdPUPKbVIrp0mo,600
+engram/extraction/llm_extractor.py,sha256=oiBl-vMyExZRMZZqxTAIoVE0y9hEHq4SZT82gfUNgl8,7209
+engram/extraction/regex_extractor.py,sha256=nGZDwRRI-zdAu05u7WZfbMrENs0eLZExvItkLk11tuQ,6548
+engram/extraction/ner/__init__.py,sha256=UcvuCpbI5hd6Sy5VMhf8rSUAxHGCgGweHmEclm4-Pp8,323
+engram/extraction/ner/cjk.py,sha256=otl6LXHNKherW2DxCXm_UDQF4EMZkS5eKXhlESt-EgI,2412
+engram/extraction/ner/english.py,sha256=r6hMiXyyy-1XmNR8FTYwuaZdpBzREpYYmsWyNlwwCbw,4215
+engram/extraction/ner/korean.py,sha256=R2_BFaQNv-uU7jBs-pFpgPWAL_X0okbu7RIcANqtdiI,4593
+engram/integrations/__init__.py,sha256=uML5GLd3YVMYxOjLUfZIXykqm7Jbd9GINVlsn-wttbE,42
+engram/integrations/mcp_server.py,sha256=AQdnPR0bDuJGoD_7DMPAfW8AONl7XkgjdwY7o_NjrCo,6778
+engram/integrations/sdk.py,sha256=fwpNWSCwglDIPzlZjZhRLTc3lq0gEsi9y0id5RxB8ag,6390
+engram/models/__init__.py,sha256=WB3YN92lm9_AZQyU2QRbOUpJZ2ScaV7F8USQJQIHsRM,750
+engram/models/entity.py,sha256=UJO6wNKz7_Gc5V5822ySQsKLYqTNLIs-Tyh7LTYJDfQ,2061
+engram/models/fact.py,sha256=WchxRBhzcAuGHEW6jkqF-QYlZsq9Ys07HxZvZvGdm70,1763
+engram/models/quality.py,sha256=LZRJT5QL4AcTeL5AxIvEBD_KZeq-eowStUJX3XHlYNE,1522
+engram/models/relation.py,sha256=yslMD7WPm6yVv0mjrX0epFBMPACHrRE5Q3cV36NtIHw,793
+engram/models/search.py,sha256=cYvVOTJYre-JNe53626igxnVhfeWJyGnl0pMm-MwlxY,2950
+engram/models/session.py,sha256=9UxePkWJ4K41e5rJByGhefsjjgLuVvzQKxJDZHCleVI,1625
+engram/models/source.py,sha256=KJ84ssOcU9nKs81K-_0Hxu2GYT5YYQUg8DdYu66TRuQ,2205
+engram/quality/__init__.py,sha256=bvc3PM1gBIHvZfabqcDigM8GxnpV55EJ7LOQIzimJ0M,320
+engram/quality/confidence.py,sha256=pA_7ketQuoQR3nkhbKgHOw4V5WJIecgWnTQ-AobUzXg,1096
+engram/quality/conflict.py,sha256=euw4Q2Tx_lKel6E87o0F7ZBie8qcB9OwrbSdrwGmvwA,2895
+engram/quality/decay.py,sha256=JXtlK-NMo0fZOoIXrc3qnFpEKAGUiR0VKZl1MvrF2tM,787
+engram/quality/gate.py,sha256=G-Bo95qEneYrERSV9AMy-NLX5kkBCKpLvO-c6o9pgHA,4795
+engram/quality/pii.py,sha256=-m8pLl3Pq3-yWV2jODO_zc7O2EyrPAgejPI1T2Xoa2k,2529
+engram/search/__init__.py,sha256=dVb7wEd3KSOzi50QZMgEXazzFmaG-YbDamvsy9C3SoQ,330
+engram/search/base.py,sha256=O1pHFgZi4lOiL1DBtWISMAuORAmUTnZSjNpf9xVnFBI,530
+engram/search/fts5_search.py,sha256=xuPU8Gk6qOuDbVK8NAGApHf4vOqxqJf1cDuWEXmnY2Q,7555
+engram/search/hybrid.py,sha256=XtKDIIJd16FJuwBC_2pkZHlrrUusGbnjpN3nyIHubHM,3259
+engram/search/semantic.py,sha256=fIgG9aojv9cpw6KDHWA4w4Tb_Ny9kYKOMwe-3PpUOBw,6356
+engram/search/tokenizer.py,sha256=DGmS8G-bx5rvGkfblH8itE9pXRTx1pVybZC5FDWrc0g,3271
+engram/session/__init__.py,sha256=vG8B-cGoyGbWvXipblPvKDCalmLmpfdCyfMDzgv3Fw4,191
+engram/session/context.py,sha256=kWNM2EeMGco_rqB_kJZhYjSph9kRIJ3OaFfxjPg5tuU,3193
+engram/session/manager.py,sha256=FiUjywT23o1yIDigDhX3dvXNxt7Q2D3c4tnv3iwdeRk,5992
+engram/session/working_memory.py,sha256=n62kt4SQido4ZrTHE-wBFdBdx88zUj7BpafBJdzVff0,2085
+engram/storage/__init__.py,sha256=llZZpK4pvs3Yh92CLcbUz6wFi1L4x0wzjtn7L80Oyhk,184
+engram/storage/base.py,sha256=nFgsTZa3eRn9iJ7ZFyT_gax40uO3K6FJyLCz7_9kv3o,2157
+engram/storage/markdown_export.py,sha256=Pnhwe8f90H_B3E4q3U2hyq01vkFWkkyDySab6v7I-kk,4878
+engram/storage/migrations.py,sha256=hJpe3kG07P64lXOmdvePSjXDarb1_uGlkJzPHOXpDHE,801
+engram/storage/sqlite_store.py,sha256=3v3Le1vJMDq_6ESlPcqdNnjlxh6rIc7BFX2hx37ufCU,23669
+memorytrace-0.1.0.dist-info/METADATA,sha256=N3Y3ZiDBD6t0D571GhIMX04b84EjlJOAn0TSUCj90NM,4223
+memorytrace-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+memorytrace-0.1.0.dist-info/entry_points.txt,sha256=XkU8WOApeS-N2s1_wxzgD5HzWRNGNe6WjYtLsRY0ZQs,98
+memorytrace-0.1.0.dist-info/licenses/LICENSE,sha256=TqMuMU0fCNmy3FtbpSj4TpdBFXXSYG7zezuJaj2gnyM,1076
+memorytrace-0.1.0.dist-info/RECORD,,

memorytrace-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

memorytrace-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+engram = engram.cli.simple:cli_entry
+engram-advanced = engram.cli.app:cli_entry

memorytrace-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Engram Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.