projectdavid-orm 1.12.0__tar.gz → 1.13.1__tar.gz

{projectdavid_orm-1.12.0 → projectdavid_orm-1.13.1}/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [1.13.1](https://github.com/project-david-ai/projectdavid-orm/compare/v1.13.0...v1.13.1) (2026-09-29)
+
+
+### Bug Fixes
+
+* **deps:** decouple ORM from Common runtime ([4e1ca2e](https://github.com/project-david-ai/projectdavid-orm/commit/4e1ca2e9b2a1b84d014fc0447849964bf974daf5))
+* **exports:** expose Scratchpad through public ORM API ([205ae03](https://github.com/project-david-ai/projectdavid-orm/commit/205ae03ebe801701d9c19ce83e1b59764a8ab93b))
+
+# [1.13.0](https://github.com/project-david-ai/projectdavid-orm/compare/v1.12.0...v1.13.0) (2026-09-29)
+
+
+### Features
+
+* **schema:** add thread-associated scratchpad resource ([5e8d87c](https://github.com/project-david-ai/projectdavid-orm/commit/5e8d87c6641b4eed245feb42c373c91bd643cfc3))
+
 # [1.12.0](https://github.com/project-david-ai/projectdavid-orm/compare/v1.11.0...v1.12.0) (2026-09-28)
 
 

{projectdavid_orm-1.12.0/src/projectdavid_orm.egg-info → projectdavid_orm-1.13.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: projectdavid-orm
-Version: 1.12.0
+Version: 1.13.1
 Summary: Shared SQLAlchemy ORM models for ProjectDavid services
 Author-email: "Francis N." <engineering@projectdavid.co.uk>
 License: PolyForm Noncommercial License 1.0.0
@@ -15,6 +15,8 @@ Requires-Dist: sqlalchemy>=2.0
 Requires-Dist: pymysql
 Requires-Dist: pydantic>=2.0
 Requires-Dist: python-dotenv
+Requires-Dist: passlib==1.7.4
+Requires-Dist: bcrypt==4.0.1
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: black==24.1.1; extra == "dev"

{projectdavid_orm-1.12.0 → projectdavid_orm-1.13.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "projectdavid-orm"
-version = "1.12.0"
+version = "1.13.1"
 description = "Shared SQLAlchemy ORM models for ProjectDavid services"
 readme = "README.md"
 authors = [
@@ -19,6 +19,8 @@ dependencies = [
   "pymysql",
   "pydantic>=2.0",
   "python-dotenv",
+  "passlib==1.7.4",
+  "bcrypt==4.0.1",
 ]
 
 [project.optional-dependencies]

{projectdavid_orm-1.12.0 → projectdavid_orm-1.13.1}/src/projectdavid_orm/__init__.py

@@ -15,6 +15,7 @@ from .ormInterface import (
     OrmInterface,
     Run,
     Sandbox,
+    Scratchpad,
     Thread,
     TrainingJob,
     User,
@@ -36,6 +37,7 @@ __all__ = [
     "Assistant",
     "Action",
     "Sandbox",
+    "Scratchpad",
     # File system
     "File",
     "FileStorage",

projectdavid_orm-1.13.1/src/projectdavid_orm/enums.py

@@ -0,0 +1,20 @@
+from enum import Enum
+
+
+class StatusEnum(str, Enum):
+    """Canonical persistence status values used by ORM models."""
+
+    deleted = "deleted"
+    active = "active"
+    queued = "queued"
+    in_progress = "in_progress"
+    pending_action = "action_required"
+    completed = "completed"
+    failed = "failed"
+    cancelling = "cancelling"
+    cancelled = "cancelled"
+    pending = "pending"
+    processing = "processing"
+    expired = "expired"
+    retrying = "retrying"
+    offline = "offline"

{projectdavid_orm-1.12.0 → projectdavid_orm-1.13.1}/src/projectdavid_orm/ormInterface.py

@@ -30,6 +30,8 @@ class OrmInterface:
     Action = Action
     # Sandbox model
     Sandbox = Sandbox
+    # Scratchpad model
+    Scratchpad = Scratchpad
     # File model
     File = File
     # FileStorage model

{projectdavid_orm-1.12.0 → projectdavid_orm-1.13.1}/src/projectdavid_orm/projectdavid_orm/models.py

@@ -3,9 +3,6 @@ import time
 from datetime import datetime
 
 from passlib.context import CryptContext
-from projectdavid_common import ValidationInterface
-from projectdavid_common.schemas.enums import StatusEnum
-from projectdavid_common.utilities.logging_service import LoggingUtility
 from sqlalchemy import JSON, BigInteger, Boolean, Column, DateTime
 from sqlalchemy import Enum as SAEnum
 from sqlalchemy import (
@@ -22,11 +19,9 @@ from sqlalchemy import (
 from sqlalchemy.ext.mutable import MutableDict
 from sqlalchemy.orm import joinedload, relationship
 
-from .base import Base
-
-logger = LoggingUtility()
+from projectdavid_orm.enums import StatusEnum
 
-validation = ValidationInterface
+from .base import Base
 
 # --- Association Tables ---
 
@@ -195,6 +190,12 @@ class User(Base):
         lazy="select",
     )
 
+    scratchpads = relationship(
+        "Scratchpad",
+        back_populates="owner",
+        lazy="select",
+    )
+
     __table_args__ = (
         UniqueConstraint(
             "oauth_provider", "provider_user_id", name="uq_user_oauth_provider_id"
@@ -269,6 +270,72 @@ class Thread(Base):
     )
     owner = relationship("User", foreign_keys=[owner_id], lazy="select")
 
+    scratchpad = relationship(
+        "Scratchpad",
+        back_populates="thread",
+        uselist=False,
+        cascade="all, delete-orphan",
+        single_parent=True,
+        lazy="select",
+    )
+
+
+class Scratchpad(Base):
+    """Tenant-owned working-memory resource associated with one thread."""
+
+    __tablename__ = "scratchpads"
+
+    id = Column(String(64), primary_key=True, index=True)
+
+    owner_id = Column(
+        String(64),
+        ForeignKey("users.id", ondelete="CASCADE"),
+        nullable=False,
+    )
+
+    thread_id = Column(
+        String(64),
+        ForeignKey("threads.id", ondelete="CASCADE"),
+        nullable=False,
+    )
+
+    created_at = Column(DateTime, nullable=False, default=datetime.utcnow)
+    updated_at = Column(
+        DateTime,
+        nullable=False,
+        default=datetime.utcnow,
+        onupdate=datetime.utcnow,
+    )
+
+    meta_data = Column(
+        MutableDict.as_mutable(JSON),
+        nullable=False,
+        default=dict,
+    )
+
+    owner = relationship(
+        "User",
+        back_populates="scratchpads",
+        lazy="select",
+    )
+
+    thread = relationship(
+        "Thread",
+        back_populates="scratchpad",
+        lazy="select",
+    )
+
+    __table_args__ = (
+        UniqueConstraint(
+            "thread_id",
+            name="uq_scratchpads_thread_id",
+        ),
+        Index(
+            "idx_scratchpads_owner_id",
+            "owner_id",
+        ),
+    )
+
 
 class Message(Base):
     __tablename__ = "messages"
@@ -356,7 +423,7 @@ class Run(Base):
     required_action = Column(String(256), nullable=True)
     response_format = Column(String(64), nullable=True)
 
-    status = Column(SAEnum(validation.StatusEnum), nullable=False)
+    status = Column(SAEnum(StatusEnum), nullable=False)
 
     thread_id = Column(String(64), nullable=False)
     tool_choice = Column(String(64), nullable=True)

{projectdavid_orm-1.12.0 → projectdavid_orm-1.13.1/src/projectdavid_orm.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: projectdavid-orm
-Version: 1.12.0
+Version: 1.13.1
 Summary: Shared SQLAlchemy ORM models for ProjectDavid services
 Author-email: "Francis N." <engineering@projectdavid.co.uk>
 License: PolyForm Noncommercial License 1.0.0
@@ -15,6 +15,8 @@ Requires-Dist: sqlalchemy>=2.0
 Requires-Dist: pymysql
 Requires-Dist: pydantic>=2.0
 Requires-Dist: python-dotenv
+Requires-Dist: passlib==1.7.4
+Requires-Dist: bcrypt==4.0.1
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: black==24.1.1; extra == "dev"

{projectdavid_orm-1.12.0 → projectdavid_orm-1.13.1}/src/projectdavid_orm.egg-info/SOURCES.txt

@@ -10,6 +10,7 @@ src/projectdavid_common.egg-info/entry_points.txt
 src/projectdavid_common.egg-info/requires.txt
 src/projectdavid_common.egg-info/top_level.txt
 src/projectdavid_orm/__init__.py
+src/projectdavid_orm/enums.py
 src/projectdavid_orm/ormInterface.py
 src/projectdavid_orm.egg-info/PKG-INFO
 src/projectdavid_orm.egg-info/SOURCES.txt
@@ -21,4 +22,6 @@ src/projectdavid_orm/projectdavid_orm/__init__.py
 src/projectdavid_orm/projectdavid_orm/base.py
 src/projectdavid_orm/projectdavid_orm/models.py
 src/projectdavid_orm/utilities/__init__.py
-tests/test_clients.py
+tests/test_clients.py
+tests/test_runtime_dependency_boundary.py
+tests/test_scratchpad_public_exports.py

{projectdavid_orm-1.12.0 → projectdavid_orm-1.13.1}/src/projectdavid_orm.egg-info/requires.txt

@@ -2,6 +2,8 @@ sqlalchemy>=2.0
 pymysql
 pydantic>=2.0
 python-dotenv
+passlib==1.7.4
+bcrypt==4.0.1
 
 [dev]
 pytest

projectdavid_orm-1.13.1/tests/test_runtime_dependency_boundary.py

@@ -0,0 +1,57 @@
+from pathlib import Path
+
+from projectdavid_orm.enums import StatusEnum
+from projectdavid_orm.projectdavid_orm.models import ApiKey
+
+EXPECTED_STATUS_VALUES = {
+    "deleted": "deleted",
+    "active": "active",
+    "queued": "queued",
+    "in_progress": "in_progress",
+    "pending_action": "action_required",
+    "completed": "completed",
+    "failed": "failed",
+    "cancelling": "cancelling",
+    "cancelled": "cancelled",
+    "pending": "pending",
+    "processing": "processing",
+    "expired": "expired",
+    "retrying": "retrying",
+    "offline": "offline",
+}
+
+
+def test_status_enum_persistence_contract_is_preserved():
+    assert {item.name: item.value for item in StatusEnum} == EXPECTED_STATUS_VALUES
+
+
+def test_models_have_no_runtime_dependency_on_common():
+    models_path = (
+        Path(__file__).parents[1]
+        / "src"
+        / "projectdavid_orm"
+        / "projectdavid_orm"
+        / "models.py"
+    )
+
+    source = models_path.read_text(encoding="utf-8")
+
+    assert "projectdavid_common" not in source
+    assert "ValidationInterface" not in source
+    assert "LoggingUtility" not in source
+
+
+def test_bcrypt_backend_hashes_and_verifies_api_keys():
+    plain = "project-david-runtime-dependency-probe"
+
+    hashed = ApiKey.hash_key(plain)
+
+    assert hashed != plain
+
+    api_key = ApiKey(
+        key_name="dependency-probe",
+        hashed_key=hashed,
+    )
+
+    assert api_key.verify_key(plain)
+    assert not api_key.verify_key(plain + "-invalid")

projectdavid_orm-1.13.1/tests/test_scratchpad_public_exports.py

@@ -0,0 +1,6 @@
+from projectdavid_orm import OrmInterface, Scratchpad
+
+
+def test_scratchpad_is_exposed_through_public_orm_api():
+    assert Scratchpad.__tablename__ == "scratchpads"
+    assert OrmInterface.Scratchpad is Scratchpad