agmem 0.1.1__tar.gz → 0.1.2__tar.gz

{agmem-0.1.1/agmem.egg-info → agmem-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agmem
-Version: 0.1.1
+Version: 0.1.2
 Summary: Agentic Memory Version Control System - Git for AI agent memories
 Home-page: https://github.com/vivek-tiwari-vt/agmem
 Author: agmem Team
@@ -16,7 +16,6 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -30,7 +29,7 @@ Requires-Dist: PyYAML>=6.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: black==24.10.0; extra == "dev"
 Requires-Dist: flake8>=5.0.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Provides-Extra: mcp
@@ -53,6 +52,12 @@ Provides-Extra: daemon
 Requires-Dist: watchdog>=3.0.0; extra == "daemon"
 Provides-Extra: graph
 Requires-Dist: networkx>=3.0; extra == "graph"
+Provides-Extra: pack
+Requires-Dist: tiktoken>=0.5.0; extra == "pack"
+Provides-Extra: distill
+Requires-Dist: openai>=1.0.0; extra == "distill"
+Provides-Extra: verify
+Requires-Dist: openai>=1.0.0; extra == "verify"
 Provides-Extra: all
 Requires-Dist: mcp>=1.0.0; extra == "all"
 Requires-Dist: sqlite-vec>=0.1.0; extra == "all"
@@ -72,6 +77,7 @@ Dynamic: requires-python
 
 # agmem - Agentic Memory Version Control System
 
+[![PyPI version](https://img.shields.io/pypi/v/agmem.svg)](https://pypi.org/project/agmem/)
 [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
@@ -109,6 +115,8 @@ agmem solves all of these problems with a familiar Git-like interface.
 
 ### Installation
 
+**From PyPI** ([pypi.org/project/agmem](https://pypi.org/project/agmem/)):
+
 ```bash
 pip install agmem
 ```
@@ -639,6 +647,15 @@ Or connect via MCP and call `memory_add` from your agent.
 3. Write via `agmem add` + `agmem commit` or MCP `memory_add`
 4. Optional: Use `agmem search` for semantic retrieval
 
+## Links
+
+- **PyPI:** [pypi.org/project/agmem](https://pypi.org/project/agmem/) — `pip install agmem`
+
+**GitHub repo (About):** Use this description and topics in your repo’s **About** (gear → Description & topics):
+
+- **Description:** Git for AI agent memories. Version control for episodic logs, semantic knowledge, and procedural workflows.
+- **Topics:** `ai` `agent` `memory` `version-control` `git` `vcs` `llm` `python`
+
 ## Contributing
 
 Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.

{agmem-0.1.1 → agmem-0.1.2}/README.md

@@ -1,5 +1,6 @@
 # agmem - Agentic Memory Version Control System
 
+[![PyPI version](https://img.shields.io/pypi/v/agmem.svg)](https://pypi.org/project/agmem/)
 [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
@@ -37,6 +38,8 @@ agmem solves all of these problems with a familiar Git-like interface.
 
 ### Installation
 
+**From PyPI** ([pypi.org/project/agmem](https://pypi.org/project/agmem/)):
+
 ```bash
 pip install agmem
 ```
@@ -567,6 +570,15 @@ Or connect via MCP and call `memory_add` from your agent.
 3. Write via `agmem add` + `agmem commit` or MCP `memory_add`
 4. Optional: Use `agmem search` for semantic retrieval
 
+## Links
+
+- **PyPI:** [pypi.org/project/agmem](https://pypi.org/project/agmem/) — `pip install agmem`
+
+**GitHub repo (About):** Use this description and topics in your repo’s **About** (gear → Description & topics):
+
+- **Description:** Git for AI agent memories. Version control for episodic logs, semantic knowledge, and procedural workflows.
+- **Topics:** `ai` `agent` `memory` `version-control` `git` `vcs` `llm` `python`
+
 ## Contributing
 
 Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.

{agmem-0.1.1 → agmem-0.1.2/agmem.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agmem
-Version: 0.1.1
+Version: 0.1.2
 Summary: Agentic Memory Version Control System - Git for AI agent memories
 Home-page: https://github.com/vivek-tiwari-vt/agmem
 Author: agmem Team
@@ -16,7 +16,6 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -30,7 +29,7 @@ Requires-Dist: PyYAML>=6.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: black==24.10.0; extra == "dev"
 Requires-Dist: flake8>=5.0.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Provides-Extra: mcp
@@ -53,6 +52,12 @@ Provides-Extra: daemon
 Requires-Dist: watchdog>=3.0.0; extra == "daemon"
 Provides-Extra: graph
 Requires-Dist: networkx>=3.0; extra == "graph"
+Provides-Extra: pack
+Requires-Dist: tiktoken>=0.5.0; extra == "pack"
+Provides-Extra: distill
+Requires-Dist: openai>=1.0.0; extra == "distill"
+Provides-Extra: verify
+Requires-Dist: openai>=1.0.0; extra == "verify"
 Provides-Extra: all
 Requires-Dist: mcp>=1.0.0; extra == "all"
 Requires-Dist: sqlite-vec>=0.1.0; extra == "all"
@@ -72,6 +77,7 @@ Dynamic: requires-python
 
 # agmem - Agentic Memory Version Control System
 
+[![PyPI version](https://img.shields.io/pypi/v/agmem.svg)](https://pypi.org/project/agmem/)
 [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
@@ -109,6 +115,8 @@ agmem solves all of these problems with a familiar Git-like interface.
 
 ### Installation
 
+**From PyPI** ([pypi.org/project/agmem](https://pypi.org/project/agmem/)):
+
 ```bash
 pip install agmem
 ```
@@ -639,6 +647,15 @@ Or connect via MCP and call `memory_add` from your agent.
 3. Write via `agmem add` + `agmem commit` or MCP `memory_add`
 4. Optional: Use `agmem search` for semantic retrieval
 
+## Links
+
+- **PyPI:** [pypi.org/project/agmem](https://pypi.org/project/agmem/) — `pip install agmem`
+
+**GitHub repo (About):** Use this description and topics in your repo’s **About** (gear → Description & topics):
+
+- **Description:** Git for AI agent memories. Version control for episodic logs, semantic knowledge, and procedural workflows.
+- **Topics:** `ai` `agent` `memory` `version-control` `git` `vcs` `llm` `python`
+
 ## Contributing
 
 Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.

{agmem-0.1.1 → agmem-0.1.2}/agmem.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ agmem.egg-info/dependency_links.txt
 agmem.egg-info/entry_points.txt
 agmem.egg-info/requires.txt
 agmem.egg-info/top_level.txt
+docs/AGMEM_PUBLISHING_SETUP.md
 docs/CONFIG.md
 docs/GTM.md
 docs/KNOWLEDGE_GRAPH.md
@@ -30,7 +31,9 @@ memvcs/commands/clean.py
 memvcs/commands/clone.py
 memvcs/commands/commit.py
 memvcs/commands/daemon.py
+memvcs/commands/decay.py
 memvcs/commands/diff.py
+memvcs/commands/distill.py
 memvcs/commands/fsck.py
 memvcs/commands/garden.py
 memvcs/commands/graph.py
@@ -38,11 +41,15 @@ memvcs/commands/init.py
 memvcs/commands/log.py
 memvcs/commands/mcp.py
 memvcs/commands/merge.py
+memvcs/commands/pack.py
 memvcs/commands/pull.py
 memvcs/commands/push.py
+memvcs/commands/recall.py
 memvcs/commands/reflog.py
 memvcs/commands/remote.py
+memvcs/commands/repair.py
 memvcs/commands/reset.py
+memvcs/commands/resurrect.py
 memvcs/commands/search.py
 memvcs/commands/serve.py
 memvcs/commands/show.py
@@ -50,11 +57,18 @@ memvcs/commands/stash.py
 memvcs/commands/status.py
 memvcs/commands/tag.py
 memvcs/commands/test.py
+memvcs/commands/timeline.py
 memvcs/commands/tree.py
+memvcs/commands/verify.py
+memvcs/commands/when.py
 memvcs/core/__init__.py
+memvcs/core/access_index.py
 memvcs/core/config_loader.py
+memvcs/core/consistency.py
 memvcs/core/constants.py
+memvcs/core/decay.py
 memvcs/core/diff.py
+memvcs/core/distiller.py
 memvcs/core/gardener.py
 memvcs/core/hooks.py
 memvcs/core/knowledge_graph.py
@@ -66,6 +80,7 @@ memvcs/core/remote.py
 memvcs/core/repository.py
 memvcs/core/schema.py
 memvcs/core/staging.py
+memvcs/core/temporal_index.py
 memvcs/core/test_runner.py
 memvcs/core/vector_store.py
 memvcs/core/storage/__init__.py
@@ -77,10 +92,22 @@ memvcs/integrations/__init__.py
 memvcs/integrations/mcp_server.py
 memvcs/integrations/web_ui/__init__.py
 memvcs/integrations/web_ui/server.py
+memvcs/retrieval/__init__.py
+memvcs/retrieval/base.py
+memvcs/retrieval/pack.py
+memvcs/retrieval/recaller.py
+memvcs/retrieval/strategies.py
 memvcs/utils/__init__.py
 memvcs/utils/helpers.py
+tests/test_access_index.py
+tests/test_advanced_commands.py
+tests/test_commit_importance.py
+tests/test_consistency.py
+tests/test_decay.py
 tests/test_edge_cases.py
 tests/test_objects.py
 tests/test_pii.py
 tests/test_plan_features.py
-tests/test_repository.py
+tests/test_repository.py
+tests/test_retrieval.py
+tests/test_temporal_index.py

{agmem-0.1.1 → agmem-0.1.2}/agmem.egg-info/requires.txt

@@ -23,10 +23,13 @@ watchdog>=3.0.0
 [dev]
 pytest>=7.0.0
 pytest-cov>=4.0.0
-black>=22.0.0
+black==24.10.0
 flake8>=5.0.0
 mypy>=1.0.0
 
+[distill]
+openai>=1.0.0
+
 [gardener]
 scikit-learn>=1.3.0
 openai>=1.0.0
@@ -37,6 +40,9 @@ networkx>=3.0
 [mcp]
 mcp>=1.0.0
 
+[pack]
+tiktoken>=0.5.0
+
 [pii]
 presidio-analyzer>=2.2.0
 
@@ -44,6 +50,9 @@ presidio-analyzer>=2.2.0
 sqlite-vec>=0.1.0
 sentence-transformers>=2.0.0
 
+[verify]
+openai>=1.0.0
+
 [web]
 fastapi>=0.100.0
 uvicorn>=0.22.0

agmem-0.1.2/docs/AGMEM_PUBLISHING_SETUP.md

@@ -0,0 +1,62 @@
+# PyPI Trusted Publishing Setup
+
+The `ci-and-publish.yml` workflow uses **PyPI Trusted Publishing** (OIDC) to publish packages without API tokens. You need to configure this on PyPI to allow your GitHub repository to upload releases.
+
+## 1. If the project `agmem` ALREADY exists on PyPI
+
+1. Log in to [pypi.org](https://pypi.org/).
+2. Go to your project's publishing settings: `https://pypi.org/manage/project/agmem/settings/publishing/`
+3. Scroll to **"Add a new publisher"** and select **GitHub**.
+4. Fill in the details:
+   - **Owner**: `vivek-tiwari-vt`
+   - **Repository name**: `agmem`
+   - **Workflow name**: `ci-and-publish.yml`
+   - **Environment name**: *Leave this blank* (unless you uncommented `environment: pypi` in the YAML).
+5. Click **Add**.
+
+## 2. If the project does NOT exist on PyPI yet
+
+You cannot "register" a package via OIDC directly for the very first upload *unless* you use "Pending Publishers".
+
+### Option A: Use Pending Publishers (Recommended)
+1. Go to [https://pypi.org/manage/account/publishing/](https://pypi.org/manage/account/publishing/)
+2. Click **Add a new pending publisher**.
+3. Fill in the details:
+   - **Project name**: `agmem`
+   - **Owner**: `vivek-tiwari-vt`
+   - **Repository name**: `agmem`
+   - **Workflow name**: `ci-and-publish.yml`
+   - **Environment name**: *Leave blank*.
+4. Click **Add**.
+5. The next time your GitHub Action runs for a release, PyPI will create the project for you.
+
+### Option B: Manual First Release
+1. Build the package locally:
+   ```bash
+   pip install build twine
+   python -m build
+   ```
+2. Upload manually (requires your username/password or an API token):
+   ```bash
+   twine upload dist/*
+   ```
+3. Once created, follow the steps in **Section 1** to enable automation for future releases.
+
+## 3. Triggering the Release
+
+The workflow runs when a **GitHub Release** is published.
+
+1. **Tag**: Push a tag starting with `v` (e.g., `v0.1.2`).
+   ```bash
+   git tag v0.1.2
+   git push origin v0.1.2
+   ```
+   *(This triggers the `release-on-tag.yml` workflow, which creates the GitHub Release)*
+
+2. **Release**: The `release-on-tag` workflow will create a GitHub Release.
+3. **Publish**: The creation of that Release triggers `ci-and-publish.yml`, which runs tests and then uploads to PyPI (if the Trusted Publisher is set up).
+
+## Troubleshooting
+
+- **"OpenID Connect not supported"**: You forgot to set up the Trusted Publisher on PyPI.
+- **"File already exists"**: You are trying to publish a version (`0.1.0` or `0.1.1`) that is already on PyPI. Bump the version in `pyproject.toml` and `memvcs/__init__.py` before tagging.

{agmem-0.1.1 → agmem-0.1.2}/memvcs/__init__.py

@@ -4,6 +4,6 @@ agmem - Agentic Memory Version Control System
 A Git-inspired version control system for AI agent memory artifacts.
 """
 
-__version__ = "0.1.1"
+__version__ = "0.1.3"
 __author__ = "agmem Team"
 __license__ = "MIT"

{agmem-0.1.1 → agmem-0.1.2}/memvcs/cli.py

@@ -49,6 +49,15 @@ from .commands.fsck import FsckCommand
 from .commands.graph import GraphCommand
 from .commands.daemon import DaemonCommand
 from .commands.garden import GardenCommand
+from .commands.recall import RecallCommand
+from .commands.when import WhenCommand
+from .commands.timeline import TimelineCommand
+from .commands.pack import PackCommand
+from .commands.distill import DistillCommand
+from .commands.decay import DecayCommand
+from .commands.resurrect import ResurrectCommand
+from .commands.verify import VerifyCommand
+from .commands.repair import RepairCommand
 
 
 # List of available commands
@@ -82,14 +91,23 @@ COMMANDS = [
     GraphCommand,
     DaemonCommand,
     GardenCommand,
+    RecallCommand,
+    WhenCommand,
+    TimelineCommand,
+    PackCommand,
+    DistillCommand,
+    DecayCommand,
+    ResurrectCommand,
+    VerifyCommand,
+    RepairCommand,
 ]
 
 
 def create_parser() -> argparse.ArgumentParser:
     """Create the main argument parser."""
     parser = argparse.ArgumentParser(
-        prog='agmem',
-        description='agmem - Agentic Memory Version Control System',
+        prog="agmem",
+        description="agmem - Agentic Memory Version Control System",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
@@ -110,36 +128,21 @@ Examples:
   agmem tree                              Show directory tree visually
 
 For more information: https://github.com/vivek-tiwari-vt/agmem
-        """
+        """,
     )
-    
-    parser.add_argument(
-        '--version', '-v',
-        action='version',
-        version='%(prog)s 0.1.0'
-    )
-    
-    parser.add_argument(
-        '--verbose',
-        action='store_true',
-        help='Enable verbose output'
-    )
-    
+
+    parser.add_argument("--version", "-v", action="version", version="%(prog)s 0.1.0")
+
+    parser.add_argument("--verbose", action="store_true", help="Enable verbose output")
+
     # Create subparsers for commands
-    subparsers = parser.add_subparsers(
-        dest='command',
-        help='Available commands',
-        metavar='COMMAND'
-    )
-    
+    subparsers = parser.add_subparsers(dest="command", help="Available commands", metavar="COMMAND")
+
     # Add each command
     for cmd_class in COMMANDS:
-        cmd_parser = subparsers.add_parser(
-            cmd_class.name,
-            help=cmd_class.help
-        )
+        cmd_parser = subparsers.add_parser(cmd_class.name, help=cmd_class.help)
         cmd_class.add_arguments(cmd_parser)
-    
+
     return parser
 
 
@@ -147,12 +150,12 @@ def main(args: List[str] = None) -> int:
     """Main entry point."""
     parser = create_parser()
     parsed_args = parser.parse_args(args)
-    
+
     # No command specified
     if not parsed_args.command:
         parser.print_help()
         return 0
-    
+
     # Find and execute the command
     for cmd_class in COMMANDS:
         if cmd_class.name == parsed_args.command:
@@ -164,15 +167,16 @@ def main(args: List[str] = None) -> int:
             except Exception as e:
                 if parsed_args.verbose:
                     import traceback
+
                     traceback.print_exc()
                 else:
                     print(f"Error: {e}")
                 return 1
-    
+
     # Unknown command
     print(f"Unknown command: {parsed_args.command}")
     return 1
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     sys.exit(main())

{agmem-0.1.1 → agmem-0.1.2}/memvcs/commands/__init__.py

@@ -11,13 +11,13 @@ from .merge import MergeCommand
 from .diff import DiffCommand
 
 __all__ = [
-    'InitCommand',
-    'AddCommand',
-    'CommitCommand',
-    'StatusCommand',
-    'LogCommand',
-    'BranchCommand',
-    'CheckoutCommand',
-    'MergeCommand',
-    'DiffCommand',
+    "InitCommand",
+    "AddCommand",
+    "CommitCommand",
+    "StatusCommand",
+    "LogCommand",
+    "BranchCommand",
+    "CheckoutCommand",
+    "MergeCommand",
+    "DiffCommand",
 ]