stapel-docs 0.2.2__tar.gz → 0.2.4__tar.gz

{stapel_docs-0.2.2/stapel_docs.egg-info → stapel_docs-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stapel-docs
-Version: 0.2.2
+Version: 0.2.4
 Summary: Documents: storage, revisions and per-type editors for the Stapel framework
 License: MIT
 Project-URL: Homepage, https://github.com/usestapel/stapel-docs
@@ -22,7 +22,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: stapel-core<1.0,>=0.26.0
+Requires-Dist: stapel-core<1.0,>=0.27.0
 Provides-Extra: s3
 Requires-Dist: boto3>=1.26; extra == "s3"
 Provides-Extra: pdf
@@ -58,13 +58,13 @@ pip install stapel-docs
 
 | Fact | Value |
 |---|---|
-| Version | `0.2.2` |
+| Version | `0.2.4` |
 | Python | `>=3.11` (3.11, 3.12, 3.13) |
 | HTTP operations | 27 |
 | Config axes | 1 |
 | Usage surface | 54 |
 | Extension points | 7 |
-| Error codes | 73 |
+| Error codes | 74 |
 | Fleet dependencies | [`stapel-auth`](https://github.com/usestapel/stapel-auth) (optional) · [`stapel-core`](https://github.com/usestapel/stapel-core) · [`stapel-workspaces`](https://github.com/usestapel/stapel-workspaces) (optional) |
 
 ## Documentation

{stapel_docs-0.2.2 → stapel_docs-0.2.4}/README.md

@@ -24,13 +24,13 @@ pip install stapel-docs
 
 | Fact | Value |
 |---|---|
-| Version | `0.2.2` |
+| Version | `0.2.4` |
 | Python | `>=3.11` (3.11, 3.12, 3.13) |
 | HTTP operations | 27 |
 | Config axes | 1 |
 | Usage surface | 54 |
 | Extension points | 7 |
-| Error codes | 73 |
+| Error codes | 74 |
 | Fleet dependencies | [`stapel-auth`](https://github.com/usestapel/stapel-auth) (optional) · [`stapel-core`](https://github.com/usestapel/stapel-core) · [`stapel-workspaces`](https://github.com/usestapel/stapel-workspaces) (optional) |
 
 ## Documentation

{stapel_docs-0.2.2 → stapel_docs-0.2.4}/docs/capabilities.json

@@ -1,6 +1,6 @@
 {
   "module": "stapel-docs",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "provides": "Google-Drive-style workspace documents: a folder tree, one-entity-per-type documents over an open type registry, content-addressed snapshot storage with an update journal and revision history, optimistic-lock editing (v1), trash with irreversible purge, a swappable object-storage seam, comm ingest (docs.create_document) and registry-driven export (PDF built in).",
   "axes": [
     {

{stapel_docs-0.2.2 → stapel_docs-0.2.4}/docs/errors.json

@@ -603,6 +603,14 @@
     "en": "Workspace membership service is unavailable",
     "owner": "stapel_docs"
   },
+  {
+    "code": "error.503.mandate_unavailable",
+    "status": 503,
+    "params": [],
+    "remediation": "retry",
+    "en": "Cannot verify workspace mandate right now",
+    "owner": "stapel_core"
+  },
   {
     "code": "error.507.docs_workspace_quota",
     "status": 507,

{stapel_docs-0.2.2 → stapel_docs-0.2.4}/docs/llms.txt

@@ -1,8 +1,8 @@
-# stapel-docs 0.2.2
+# stapel-docs 0.2.4
 
 Google-Drive-style workspace documents: a folder tree, one-entity-per-type documents over an open type registry, content-addressed snapshot storage with an update journal and revision history, optimistic-lock editing (v1), trash with irreversible purge, a swappable object-storage seam, comm ingest (docs.create_document) and registry-driven export (PDF built in).
 
-Contract: axes 1 · surface 54 · extension points 7 · operations 27 · error codes 73.
+Contract: axes 1 · surface 54 · extension points 7 · operations 27 · error codes 74.
 Generated from docs/capabilities.json by `stapel-llms-txt` — do not edit; drift-gated by `make contract-check`.
 
 ## Configuration axes — what a product switches on
@@ -189,7 +189,7 @@ Paths are relative to `/docs/api/v1/`.
 - POST /uploads — docs_api_v1_uploads_create
 - POST /uploads/{upload_id}/finalize — docs_api_v1_uploads_finalize_create
 
-## Error codes (73) — the StapelError envelope
+## Error codes (74) — the StapelError envelope
 Render `t(code, params)`; branch UX on the remediation. Localized text lives in docs/errors.<lang>.md, not here.
 - error.400.bad_request [400] fix_input
 - error.400.captcha_invalid [400] retry
@@ -263,4 +263,5 @@ Render `t(code, params)`; branch UX on the remediation. Localized text lives in
 - error.503.docs_download_url_unavailable [503] retry
 - error.503.docs_exporter_unavailable [503] retry
 - error.503.docs_workspaces_unavailable [503] retry
+- error.503.mandate_unavailable [503] retry
 - error.507.docs_workspace_quota [507] retry

{stapel_docs-0.2.2 → stapel_docs-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stapel-docs"
-version = "0.2.2"
+version = "0.2.4"
 description = "Documents: storage, revisions and per-type editors for the Stapel framework"
 readme = "README.md"
 license = { text = "MIT" }
@@ -43,7 +43,12 @@ dependencies = [
     # (>=0.3,<0.4) that made the package uninstallable next to any real host.
     # Floor: 0.26.0 emits docs/errors.json with the `owner` field the
     # committed artifact and its drift gate require.
-    "stapel-core>=0.26.0,<1.0",
+    # Floor: 0.27.0 registers `error.503.mandate_unavailable` (+ ru/es
+    # catalogs) — CI always installs core off git HEAD, so the committed
+    # docs/errors.json (regenerated against the current core) needs the
+    # floor to match or a consumer on an older core silently regenerates a
+    # smaller artifact and the drift gate goes red again.
+    "stapel-core>=0.27.0,<1.0",
 ]
 
 [project.urls]

{stapel_docs-0.2.2 → stapel_docs-0.2.4}/services.py

@@ -622,43 +622,49 @@ def _save_snapshot(
     already_stored = storage_tx.put(key, body, content_type=content_mime(document))
     added = 0 if already_stored else len(body)
 
-    document.head_seq = new_seq
-    document.snapshot_seq = new_seq
-    document.snapshot_key = key
-    document.size_bytes = len(body)
-    document.save(
-        update_fields=["head_seq", "snapshot_seq", "snapshot_key", "size_bytes", "updated_at"]
-    )
-
     revision = None
-    if force_revision or _auto_revision_due(document):
-        revision = Revision.objects.create(
-            document=document,
-            seq=new_seq,
-            kind=Revision.KIND_AUTO,
-            storage_key=key,
-            created_by=user,
-            size_bytes=len(body),
+    # Mutation + outbox rows share this atomic block (outbox canon — see
+    # module docstring). The callers already hold a wider
+    # transaction.atomic(); nesting here is a safe savepoint (per
+    # stapel_core.comm.mutate_and_emit's documented nesting guarantee) and
+    # makes this helper self-sufficient for emit-check's lexical scan.
+    with transaction.atomic():
+        document.head_seq = new_seq
+        document.snapshot_seq = new_seq
+        document.snapshot_key = key
+        document.size_bytes = len(body)
+        document.save(
+            update_fields=["head_seq", "snapshot_seq", "snapshot_key", "size_bytes", "updated_at"]
         )
 
-    # Orphan cleanup: the previous snapshot dies iff no Revision points at
-    # it (content-addressed keys make identical bodies dedup for free).
-    freed = 0
-    if (
-        prev_key
-        and prev_key != key
-        and not Revision.objects.filter(document=document, storage_key=prev_key).exists()
-    ):
-        storage_tx.delete(prev_key)
-        freed = prev_size
+        if force_revision or _auto_revision_due(document):
+            revision = Revision.objects.create(
+                document=document,
+                seq=new_seq,
+                kind=Revision.KIND_AUTO,
+                storage_key=key,
+                created_by=user,
+                size_bytes=len(body),
+            )
+
+        # Orphan cleanup: the previous snapshot dies iff no Revision points at
+        # it (content-addressed keys make identical bodies dedup for free).
+        freed = 0
+        if (
+            prev_key
+            and prev_key != key
+            and not Revision.objects.filter(document=document, storage_key=prev_key).exists()
+        ):
+            storage_tx.delete(prev_key)
+            freed = prev_size
 
-    _compact_journal(document)
+        _compact_journal(document)
 
-    if emit_updated:
-        events.emit_document_updated(document)
-    delta = added - freed
-    if delta:
-        events.emit_storage_changed(document.workspace_id, delta)
+        if emit_updated:
+            events.emit_document_updated(document)
+        delta = added - freed
+        if delta:
+            events.emit_storage_changed(document.workspace_id, delta)
     return revision
 
 

{stapel_docs-0.2.2 → stapel_docs-0.2.4/stapel_docs.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stapel-docs
-Version: 0.2.2
+Version: 0.2.4
 Summary: Documents: storage, revisions and per-type editors for the Stapel framework
 License: MIT
 Project-URL: Homepage, https://github.com/usestapel/stapel-docs
@@ -22,7 +22,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: stapel-core<1.0,>=0.26.0
+Requires-Dist: stapel-core<1.0,>=0.27.0
 Provides-Extra: s3
 Requires-Dist: boto3>=1.26; extra == "s3"
 Provides-Extra: pdf
@@ -58,13 +58,13 @@ pip install stapel-docs
 
 | Fact | Value |
 |---|---|
-| Version | `0.2.2` |
+| Version | `0.2.4` |
 | Python | `>=3.11` (3.11, 3.12, 3.13) |
 | HTTP operations | 27 |
 | Config axes | 1 |
 | Usage surface | 54 |
 | Extension points | 7 |
-| Error codes | 73 |
+| Error codes | 74 |
 | Fleet dependencies | [`stapel-auth`](https://github.com/usestapel/stapel-auth) (optional) · [`stapel-core`](https://github.com/usestapel/stapel-core) · [`stapel-workspaces`](https://github.com/usestapel/stapel-workspaces) (optional) |
 
 ## Documentation

{stapel_docs-0.2.2 → stapel_docs-0.2.4}/stapel_docs.egg-info/requires.txt

@@ -1,4 +1,4 @@
-stapel-core<1.0,>=0.26.0
+stapel-core<1.0,>=0.27.0
 
 [all]
 boto3>=1.26