agent-memory-sdk 0.1.2__tar.gz → 0.1.4__tar.gz

{agent_memory_sdk-0.1.2 → agent_memory_sdk-0.1.4}/.github/workflows/ci.yml

@@ -3,7 +3,6 @@ name: CI
 on:
   push:
     branches: [main, develop]
-    tags: ['v*']
   pull_request:
     branches: [main, develop]
 
@@ -15,7 +14,11 @@ jobs:
         python-version: ["3.10", "3.11", "3.12", "3.13"]
 
     steps:
-      - uses: actions/checkout@v4.2.2
+      - name: Checkout
+        run: |
+          git clone --depth 1 ${{ github.server_url }}/${{ github.repository }} .
+          git fetch origin ${{ github.sha }}
+          git checkout ${{ github.sha }}
 
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5.5.0
@@ -45,10 +48,14 @@ jobs:
   benchmark:
     runs-on: ubuntu-latest
     needs: test
-    if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/'))
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
 
     steps:
-      - uses: actions/checkout@v4.2.2
+      - name: Checkout
+        run: |
+          git clone --depth 1 ${{ github.server_url }}/${{ github.repository }} .
+          git fetch origin ${{ github.sha }}
+          git checkout ${{ github.sha }}
 
       - name: Set up Python
         uses: actions/setup-python@v5.5.0
@@ -74,9 +81,11 @@ jobs:
     needs: test
 
     steps:
-      - uses: actions/checkout@v4.2.2
-        with:
-          fetch-depth: 0  # Need full history for version detection
+      - name: Checkout
+        run: |
+          git clone --depth 1 ${{ github.server_url }}/${{ github.repository }} .
+          git fetch origin ${{ github.sha }}
+          git checkout ${{ github.sha }}
 
       - name: Build Docker image
         run: |
@@ -108,45 +117,4 @@ jobs:
       - name: Test Docker image with ChromaDB backend
         run: |
           docker run --rm -v agent_memory_chromadb:/home/appuser/.agent_memory agent-memory:latest remember "test" "test response" --backend chromadb
-          docker run --rm -v agent_memory_chromadb:/home/appuser/.agent_memory agent-memory:latest resolve "test" --backend chromadb
-
-  publish:
-    runs-on: ubuntu-latest
-    needs: [test, benchmark]
-    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
-    permissions:
-      contents: write
-      packages: write
-      id-token: write
-
-    steps:
-      - uses: actions/checkout@v4.2.2
-
-      - name: Set up Python
-        uses: actions/setup-python@v5.5.0
-        with:
-          python-version: "3.11"
-
-      - name: Install build dependencies
-        run: |
-          python -m pip install --upgrade pip build twine
-
-      - name: Build package
-        run: |
-          # For tag releases, use clean version without local identifier
-          VERSION=${GITHUB_REF_NAME#v}
-          SETUPTOOLS_SCM_PRETEND_VERSION=${VERSION} python -m build
-
-      - name: Publish to PyPI
-        env:
-          TWINE_USERNAME: __token__
-          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
-        run: |
-          twine upload dist/*
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          generate_release_notes: true
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          docker run --rm -v agent_memory_chromadb:/home/appuser/.agent_memory agent-memory:latest resolve "test" --backend chromadb

agent_memory_sdk-0.1.4/.github/workflows/release.yml

@@ -0,0 +1,53 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+env:
+  PYPI_PACKAGE_NAME: agent-memory-sdk
+
+jobs:
+  build-and-publish:
+    name: Build and Publish to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - name: Checkout
+        run: |
+          git clone --depth 1 ${{ github.server_url }}/${{ github.repository }} .
+          git fetch origin ${{ github.sha }}
+          git checkout ${{ github.sha }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5.5.0
+        with:
+          python-version: "3.11"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip build twine
+
+      - name: Build package
+        run: |
+          # For tag releases, use clean version without local identifier
+          VERSION=${GITHUB_REF_NAME#v}
+          SETUPTOOLS_SCM_PRETEND_VERSION=${VERSION} python -m build
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          twine upload dist/*
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

{agent_memory_sdk-0.1.2 → agent_memory_sdk-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-memory-sdk
-Version: 0.1.2
+Version: 0.1.4
 Summary: Persistent semantic memory for AI agents with replay, restore, verify, and ignore decisions
 License-Expression: MIT
 License-File: LICENSE
@@ -22,7 +22,7 @@ Description-Content-Type: text/markdown
 [![CI](https://github.com/TheProdSDE/agent-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/TheProdSDE/agent-memory/actions)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![PyPI version](https://img.shields.io/pypi/v/agent-memory.svg)](https://pypi.org/project/agent-memory/)
+[![PyPI version](https://img.shields.io/pypi/v/agent-memory-sdk.svg)](https://pypi.org/project/agent-memory-sdk/)
 
 **Persistent semantic memory for AI agents with intelligent decision-making.**
 
@@ -213,7 +213,7 @@ print(decision.explain())  # Detailed score breakdown
 
 ```bash
 # From PyPI
-pip install agent-memory
+pip install agent-memory-sdk
 
 # From source (development)
 git clone https://github.com/TheProdSDE/agent-memory.git
@@ -422,7 +422,88 @@ agent-memory eval --datasets ./benchmarks/datasets
 
 ---
 
-## 📈 Current Status (v0.1.0-alpha)
+## � Release Process
+
+### How Releases Work
+
+The project uses **automated CI/CD** via GitHub Actions. Releases are triggered by **pushing a version tag**:
+
+```bash
+# Create and push a version tag (triggers full release pipeline)
+git tag v0.1.3
+git push origin v0.1.3
+```
+
+### What Happens on Tag Push
+
+When you push a tag matching `v*` (e.g., `v0.1.3`, `v1.0.0`, `v2.0.0-beta.1`):
+
+| Step | Description |
+|------|-------------|
+| 1️⃣ **Test** | Runs tests on Python 3.10, 3.11, 3.12, 3.13 |
+| 2️⃣ **Benchmark** | Runs performance benchmarks |
+| 3️⃣ **Docker** | Builds and tests multi-stage Docker image |
+| 4️⃣ **Publish** | Builds package → Publishes to PyPI → Creates GitHub Release |
+
+### Release Artifacts Created
+
+| Artifact | Location |
+|----------|----------|
+| **PyPI Package** | `pip install agent-memory-sdk==0.1.3` |
+| **GitHub Release** | https://github.com/theprodsde/agent-memory/releases/tag/v0.1.3 |
+| **Docker Image** | `ghcr.io/theprodsde/agent-memory:v0.1.3` (if configured) |
+| **Source Archives** | Auto-attached to GitHub Release |
+
+### Version Format
+
+Use **Semantic Versioning** with optional pre-release suffixes:
+- `v1.0.0` - Stable release
+- `v1.0.1` - Patch release
+- `v1.1.0` - Minor release
+- `v2.0.0` - Major release
+- `v1.0.0-alpha.1` - Alpha pre-release
+- `v1.0.0-beta.2` - Beta pre-release
+- `v1.0.0-rc.1` - Release candidate
+
+### Prerequisites
+
+1. **PyPI Token** - Stored as `PYPI_API_TOKEN` in GitHub repository secrets
+2. **GitHub Token** - Automatically provided as `GITHUB_TOKEN`
+3. **Branch Protection** - Recommended: require PR reviews before merging to main
+
+### Manual Release (if needed)
+
+```bash
+# 1. Ensure you're on main with latest changes
+git checkout main
+git pull origin main
+
+# 2. Create version tag
+git tag v0.1.3
+
+# 3. Push tag (triggers CI/CD)
+git push origin v0.1.3
+
+# 4. Monitor workflow
+# https://github.com/theprodsde/agent-memory/actions
+```
+
+### Rollback / Delete Release
+
+```bash
+# Delete local tag
+git tag -d v0.1.3
+
+# Delete remote tag (also deletes GitHub Release)
+git push origin --delete v0.1.3
+
+# Note: PyPI packages CANNOT be deleted, only yanked
+# twine yank agent-memory 0.1.3
+```
+
+---
+
+## 📈 Current Status (v0.1.2)
 
 ### ✅ Implemented
 - Hybrid retrieval (BM25 + Vector + RRF fusion)

{agent_memory_sdk-0.1.2 → agent_memory_sdk-0.1.4}/README.md

@@ -3,7 +3,7 @@
 [![CI](https://github.com/TheProdSDE/agent-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/TheProdSDE/agent-memory/actions)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![PyPI version](https://img.shields.io/pypi/v/agent-memory.svg)](https://pypi.org/project/agent-memory/)
+[![PyPI version](https://img.shields.io/pypi/v/agent-memory-sdk.svg)](https://pypi.org/project/agent-memory-sdk/)
 
 **Persistent semantic memory for AI agents with intelligent decision-making.**
 
@@ -194,7 +194,7 @@ print(decision.explain())  # Detailed score breakdown
 
 ```bash
 # From PyPI
-pip install agent-memory
+pip install agent-memory-sdk
 
 # From source (development)
 git clone https://github.com/TheProdSDE/agent-memory.git
@@ -403,7 +403,88 @@ agent-memory eval --datasets ./benchmarks/datasets
 
 ---
 
-## 📈 Current Status (v0.1.0-alpha)
+## � Release Process
+
+### How Releases Work
+
+The project uses **automated CI/CD** via GitHub Actions. Releases are triggered by **pushing a version tag**:
+
+```bash
+# Create and push a version tag (triggers full release pipeline)
+git tag v0.1.3
+git push origin v0.1.3
+```
+
+### What Happens on Tag Push
+
+When you push a tag matching `v*` (e.g., `v0.1.3`, `v1.0.0`, `v2.0.0-beta.1`):
+
+| Step | Description |
+|------|-------------|
+| 1️⃣ **Test** | Runs tests on Python 3.10, 3.11, 3.12, 3.13 |
+| 2️⃣ **Benchmark** | Runs performance benchmarks |
+| 3️⃣ **Docker** | Builds and tests multi-stage Docker image |
+| 4️⃣ **Publish** | Builds package → Publishes to PyPI → Creates GitHub Release |
+
+### Release Artifacts Created
+
+| Artifact | Location |
+|----------|----------|
+| **PyPI Package** | `pip install agent-memory-sdk==0.1.3` |
+| **GitHub Release** | https://github.com/theprodsde/agent-memory/releases/tag/v0.1.3 |
+| **Docker Image** | `ghcr.io/theprodsde/agent-memory:v0.1.3` (if configured) |
+| **Source Archives** | Auto-attached to GitHub Release |
+
+### Version Format
+
+Use **Semantic Versioning** with optional pre-release suffixes:
+- `v1.0.0` - Stable release
+- `v1.0.1` - Patch release
+- `v1.1.0` - Minor release
+- `v2.0.0` - Major release
+- `v1.0.0-alpha.1` - Alpha pre-release
+- `v1.0.0-beta.2` - Beta pre-release
+- `v1.0.0-rc.1` - Release candidate
+
+### Prerequisites
+
+1. **PyPI Token** - Stored as `PYPI_API_TOKEN` in GitHub repository secrets
+2. **GitHub Token** - Automatically provided as `GITHUB_TOKEN`
+3. **Branch Protection** - Recommended: require PR reviews before merging to main
+
+### Manual Release (if needed)
+
+```bash
+# 1. Ensure you're on main with latest changes
+git checkout main
+git pull origin main
+
+# 2. Create version tag
+git tag v0.1.3
+
+# 3. Push tag (triggers CI/CD)
+git push origin v0.1.3
+
+# 4. Monitor workflow
+# https://github.com/theprodsde/agent-memory/actions
+```
+
+### Rollback / Delete Release
+
+```bash
+# Delete local tag
+git tag -d v0.1.3
+
+# Delete remote tag (also deletes GitHub Release)
+git push origin --delete v0.1.3
+
+# Note: PyPI packages CANNOT be deleted, only yanked
+# twine yank agent-memory 0.1.3
+```
+
+---
+
+## 📈 Current Status (v0.1.2)
 
 ### ✅ Implemented
 - Hybrid retrieval (BM25 + Vector + RRF fusion)

{agent_memory_sdk-0.1.2 → agent_memory_sdk-0.1.4}/agent_memory/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.2'
-__version_tuple__ = version_tuple = (0, 1, 2)
+__version__ = version = '0.1.4'
+__version_tuple__ = version_tuple = (0, 1, 4)
 
 __commit_id__ = commit_id = None

{agent_memory_sdk-0.1.2 → agent_memory_sdk-0.1.4}/pyproject.toml

@@ -34,6 +34,7 @@ packages = ["agent_memory", "mcp_server"]
 
 [tool.hatch.version]
 source = "vcs"
+version-file = "agent_memory/_version.py"
 
 [tool.hatch.build.hooks.vcs]
 version-file = "agent_memory/_version.py"