proactive-gate 0.2.5__tar.gz → 0.3.1__tar.gz

{proactive_gate-0.2.5 → proactive_gate-0.3.1}/PKG-INFO

@@ -1,23 +1,29 @@
 Metadata-Version: 2.5
 Name: proactive-gate
-Version: 0.2.5
+Version: 0.3.1
 Summary: Decide whether a proactive assistant may speak now: ordered checks, budgets, quiet hours, JSON policies, shared conformance fixtures with the TypeScript package.
 Project-URL: Homepage, https://bubblegunn.github.io/proactive-gate/
+Project-URL: Documentation, https://bubblegunn.github.io/proactive-gate/start/
+Project-URL: Playground, https://bubblegunn.github.io/proactive-gate/playground/
 Project-URL: Repository, https://github.com/Bubblegunn/proactive-gate
 Project-URL: Issues, https://github.com/Bubblegunn/proactive-gate/issues
 Project-URL: Specification, https://github.com/Bubblegunn/proactive-gate/tree/main/spec
 Project-URL: Changelog, https://github.com/Bubblegunn/proactive-gate/blob/main/CHANGELOG.md
 Author: Efe Genc
 License-Expression: MIT
-Keywords: agents,notifications,policy,proactive,quiet-hours,rate-limit
+Keywords: agents,ai-agents,consent,guardrails,interruption,llm,notification-budget,notification-policy,notifications,policy,policy-engine,proactive,proactive-agents,proactive-ai,quiet-hours,rate-limit
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: AsyncIO
 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 :: Only
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Communications
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
@@ -110,7 +116,9 @@ runs that loop with values you supply, for tests with no store at all.
 
 `MemoryStore` (in-process), `SqliteStore` (standard library, one file per host),
 `AsyncMemoryStore`, and `RedisStore` over `redis.asyncio` (INCR, then EXPIRE on the first
-increment). Any object with `get`, `set`, `incr` and `delete` works.
+increment). Any object with `get`, `set`, `incr` and `delete` works. `SqliteStore` removes
+an expired row when a read touches it and clears every already-expired row on each `set` or
+`incr`, so a key nobody reads again still disappears.
 
 ## Presets
 

{proactive_gate-0.2.5 → proactive_gate-0.3.1}/README.md

@@ -79,7 +79,9 @@ runs that loop with values you supply, for tests with no store at all.
 
 `MemoryStore` (in-process), `SqliteStore` (standard library, one file per host),
 `AsyncMemoryStore`, and `RedisStore` over `redis.asyncio` (INCR, then EXPIRE on the first
-increment). Any object with `get`, `set`, `incr` and `delete` works.
+increment). Any object with `get`, `set`, `incr` and `delete` works. `SqliteStore` removes
+an expired row when a read touches it and clears every already-expired row on each `set` or
+`incr`, so a key nobody reads again still disappears.
 
 ## Presets
 

{proactive_gate-0.2.5 → proactive_gate-0.3.1}/pyproject.toml

@@ -4,13 +4,17 @@ build-backend = "hatchling.build"
 
 [project]
 name = "proactive-gate"
-version = "0.2.5"
+version = "0.3.1"
 description = "Decide whether a proactive assistant may speak now: ordered checks, budgets, quiet hours, JSON policies, shared conformance fixtures with the TypeScript package."
 readme = "README.md"
 requires-python = ">=3.11"
 license = "MIT"
 authors = [{ name = "Efe Genc" }]
-keywords = ["proactive", "notifications", "agents", "rate-limit", "quiet-hours", "policy"]
+keywords = [
+  "proactive", "proactive-ai", "proactive-agents", "ai-agents", "llm", "agents",
+  "notifications", "notification-policy", "notification-budget", "quiet-hours",
+  "consent", "rate-limit", "policy", "policy-engine", "guardrails", "interruption",
+]
 classifiers = [
   "Development Status :: 4 - Beta",
   "Intended Audience :: Developers",
@@ -18,8 +22,12 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3 :: Only",
   "Framework :: AsyncIO",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
   "Topic :: Software Development :: Libraries",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
   "Topic :: Communications",
   "Typing :: Typed",
 ]
@@ -31,6 +39,8 @@ dev = ["pytest>=8", "mypy>=1.11", "redis>=5"]
 
 [project.urls]
 Homepage = "https://bubblegunn.github.io/proactive-gate/"
+Documentation = "https://bubblegunn.github.io/proactive-gate/start/"
+Playground = "https://bubblegunn.github.io/proactive-gate/playground/"
 Repository = "https://github.com/Bubblegunn/proactive-gate"
 Issues = "https://github.com/Bubblegunn/proactive-gate/issues"
 Specification = "https://github.com/Bubblegunn/proactive-gate/tree/main/spec"

{proactive_gate-0.2.5 → proactive_gate-0.3.1}/src/proactive_gate/stores.py

@@ -72,8 +72,15 @@ class SqliteStore:
     def __init__(self, path: str = ":memory:") -> None:
         self._conn = sqlite3.connect(path, isolation_level=None, check_same_thread=False)
         self._conn.execute("CREATE TABLE IF NOT EXISTS kv (key TEXT PRIMARY KEY, value TEXT NOT NULL, expires_at REAL)")
+        # The partial index keeps a sweep proportional to the dead rows instead of a table scan.
+        self._conn.execute("CREATE INDEX IF NOT EXISTS kv_expires_at ON kv (expires_at) WHERE expires_at IS NOT NULL")
         self._lock = threading.Lock()
 
+    def _sweep(self, now: float) -> None:
+        """A read prunes only the key it touches; a write first clears every row
+        that has already expired, so a key nobody reads again does not live forever."""
+        self._conn.execute("DELETE FROM kv WHERE expires_at IS NOT NULL AND expires_at <= ?", (now,))
+
     def _row(self, key: str) -> str | None:
         row = self._conn.execute("SELECT value, expires_at FROM kv WHERE key = ?", (key,)).fetchone()
         if row is None:
@@ -89,14 +96,17 @@ class SqliteStore:
             return self._row(key)
 
     def set(self, key: str, value: str, ttl_seconds: int | None = None) -> None:
-        expires = time.time() + ttl_seconds if ttl_seconds else None
+        now = time.time()
+        expires = now + ttl_seconds if ttl_seconds else None
         with self._lock:
+            self._sweep(now)
             self._conn.execute("INSERT OR REPLACE INTO kv (key, value, expires_at) VALUES (?, ?, ?)", (key, value, expires))
 
     def incr(self, key: str, ttl_seconds: int | None = None) -> int:
         with self._lock:
             self._conn.execute("BEGIN IMMEDIATE")
             try:
+                self._sweep(time.time())
                 current = self._row(key)
                 next_value = int(current or 0) + 1
                 if current is None:

{proactive_gate-0.2.5 → proactive_gate-0.3.1}/tests/test_stores.py

@@ -1,4 +1,6 @@
 import asyncio
+import sqlite3
+import time
 from datetime import datetime, timezone
 from pathlib import Path
 
@@ -31,6 +33,22 @@ def test_sqlite_store_persists_across_connections(tmp_path: Path) -> None:
     second.close()
 
 
+def test_sqlite_store_removes_expired_rows_on_write(tmp_path: Path) -> None:
+    path = str(tmp_path / "gate.sqlite")
+    store = SqliteStore(path)
+    raw = sqlite3.connect(path, isolation_level=None)
+    expired = time.time() - 10
+    for i in range(50):
+        raw.execute("INSERT INTO kv (key, value, expires_at) VALUES (?, 'v', ?)", (f"stale-{i}", expired))
+    raw.execute("INSERT INTO kv (key, value, expires_at) VALUES ('keeper', 'v', ?)", (time.time() + 600,))
+    # None of the stale keys were read, so all fifty rows are still physically there.
+    assert raw.execute("SELECT COUNT(*) FROM kv").fetchone()[0] == 51
+    store.incr("fresh", 60)
+    assert {key for (key,) in raw.execute("SELECT key FROM kv")} == {"keeper", "fresh"}
+    raw.close()
+    store.close()
+
+
 def _user() -> UserState:
     return UserState.from_dict({"id": "u1", "consent": True, "timezone": "Europe/Istanbul", "createdAt": "2026-01-01T00:00:00Z"})