rubricloop 0.1.2__tar.gz → 0.1.3__tar.gz

{rubricloop-0.1.2 → rubricloop-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: rubricloop
-Version: 0.1.2
+Version: 0.1.3
 Summary: Bounded, auditable verification loops for AI agent output.
 Project-URL: Homepage, https://rubricloop.com
 Project-URL: Documentation, https://rubricloop.com/docs
@@ -180,6 +180,7 @@ hosted registry:
 
 ```bash
 rubricloop --server https://api.rubricloop.dev login --api-key "$RUBRICLOOP_API_KEY"
+rubricloop --server https://api.rubricloop.dev create acme/check --visibility private
 rubricloop --server https://api.rubricloop.dev push dist/acme-check.rlpack --tag latest
 rubricloop --server https://api.rubricloop.dev vet acme/check@latest
 rubricloop --server https://api.rubricloop.dev pull acme/check@latest

{rubricloop-0.1.2 → rubricloop-0.1.3}/README.md

@@ -151,6 +151,7 @@ hosted registry:
 
 ```bash
 rubricloop --server https://api.rubricloop.dev login --api-key "$RUBRICLOOP_API_KEY"
+rubricloop --server https://api.rubricloop.dev create acme/check --visibility private
 rubricloop --server https://api.rubricloop.dev push dist/acme-check.rlpack --tag latest
 rubricloop --server https://api.rubricloop.dev vet acme/check@latest
 rubricloop --server https://api.rubricloop.dev pull acme/check@latest

rubricloop-0.1.3/examples/verify_reply_registry/README.md

@@ -0,0 +1,47 @@
+# Reply Quick Start registry lifecycle
+
+This package uses the same three deterministic rules as
+`sdk/examples/verify_reply.py`: 40 to 70 words, the word `timeline`, and no
+`guaranteed refund` promise.
+
+```bash
+pip install rubricloop openai
+export OPENAI_API_KEY="sk-..."
+python sdk/examples/verify_reply.py
+
+python sdk/examples/verify_reply_registry/build_package.py \
+  --namespace YOUR_NAMESPACE
+
+rubricloop --server https://api.rubricloop.dev login
+rubricloop --server https://api.rubricloop.dev create \
+  YOUR_NAMESPACE/support-reply \
+  --visibility private \
+  --description "Checks support replies before they are sent."
+rubricloop validate dist/support-reply.rlpack
+rubricloop test dist/support-reply.rlpack
+rubricloop --server https://api.rubricloop.dev push \
+  dist/support-reply.rlpack \
+  --tag latest
+rubricloop --server https://api.rubricloop.dev vet \
+  YOUR_NAMESPACE/support-reply@latest
+```
+
+Pull the immutable bundle digest returned by `push`, not the mutable tag:
+
+```bash
+rubricloop --server https://api.rubricloop.dev pull \
+  YOUR_NAMESPACE/support-reply@sha256:BUNDLE_DIGEST \
+  --output dist/pulled-support-reply.rlpack
+cmp dist/support-reply.rlpack dist/pulled-support-reply.rlpack
+```
+
+Once vetting passes and hosted execution is approved for that exact digest:
+
+```bash
+rubricloop --server https://api.rubricloop.dev run \
+  YOUR_NAMESPACE/support-reply@sha256:BUNDLE_DIGEST \
+  --input sdk/examples/verify_reply_registry/run-input.json
+```
+
+No credential belongs in this folder. `login` reads the key without echoing it
+and stores it in the operating system keychain.

rubricloop-0.1.3/examples/verify_reply_registry/build_package.py

@@ -0,0 +1,122 @@
+"""Build the registry package used by the OpenAI reply Quick Start."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+
+from rubricloop import build_rlpack, create_manifest, read_rlpack
+
+VALID_REPLY = (
+    "We apologize for the delay with your order. Our team is currently investigating "
+    "the issue and working to resolve it as quickly as possible. You can expect an "
+    "update on the timeline for your order shortly. Thank you for your patience."
+)
+
+
+def manifest(namespace: str, version: str) -> dict:
+    golden = [
+        {
+            "id": f"valid-reply-{index:02d}",
+            "input": {"reply": VALID_REPLY},
+            "context": {},
+            "expected": {"decision": "allow"},
+        }
+        for index in range(1, 21)
+    ]
+    return create_manifest(
+        namespace=namespace,
+        name="support-reply",
+        version=version,
+        title="Support reply",
+        description="Checks reply length, timeline wording, and refund promises.",
+        license="MIT",
+        categories=("Support", "Safety"),
+        rules=(
+            {
+                "id": "reply.length",
+                "kind": "text.word_count",
+                "severity": "error",
+                "description": "Reply must contain 40 to 70 words.",
+                "config": {"field": "reply", "minimum": 40, "maximum": 70},
+            },
+            {
+                "id": "reply.timeline",
+                "kind": "text.required_terms",
+                "severity": "error",
+                "description": "Reply must explain the timeline.",
+                "config": {"field": "reply", "terms": ["timeline"]},
+            },
+            {
+                "id": "reply.promise",
+                "kind": "text.forbidden_terms",
+                "severity": "error",
+                "description": "Reply must not promise a guaranteed refund.",
+                "config": {"field": "reply", "terms": ["guaranteed refund"]},
+            },
+        ),
+        tests={
+            "golden": golden,
+            "mutation": [
+                {
+                    "id": "forbidden-refund-promise",
+                    "input": {"reply": "We offer a guaranteed refund."},
+                    "context": {},
+                    "expected": {"decision": "deny"},
+                }
+            ],
+            "fail_closed": [
+                {
+                    "id": "missing-reply",
+                    "input": {},
+                    "context": {},
+                    "expected": {"decision": "deny"},
+                }
+            ],
+        },
+        examples=(
+            {
+                "name": "delayed-order",
+                "input": {"reply": VALID_REPLY},
+                "context": {},
+            },
+        ),
+        provenance={
+            "builder": "rubricloop-sdk",
+            "source_repository": "https://rubricloop.com/docs",
+            "source_revision": "verify-reply-quick-start",
+            "built_at": "",
+        },
+    )
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--namespace", required=True)
+    parser.add_argument("--version", default="1.0.0")
+    parser.add_argument("--output", type=Path, default=Path("dist/support-reply.rlpack"))
+    args = parser.parse_args()
+
+    bundle = build_rlpack(
+        manifest(args.namespace, args.version),
+        {
+            "payload/quick-start.json": json.dumps(
+                {
+                    "example": "sdk/examples/verify_reply.py",
+                    "model": "gpt-4o-mini",
+                },
+                sort_keys=True,
+            ).encode()
+        },
+    )
+    package = read_rlpack(bundle)
+    args.output.parent.mkdir(parents=True, exist_ok=True)
+    args.output.write_bytes(bundle)
+    print(args.output)
+    print(package.manifest_digest)
+    print(package.archive_digest)
+
+
+if __name__ == "__main__":
+    main()

rubricloop-0.1.3/examples/verify_reply_registry/run-input.json

@@ -0,0 +1,6 @@
+{
+  "output": {
+    "reply": "We apologize for the delay with your order. Our team is currently investigating the issue and working to resolve it as quickly as possible. You can expect an update on the timeline for your order shortly. Thank you for your patience."
+  },
+  "context": {}
+}

{rubricloop-0.1.2 → rubricloop-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rubricloop"
-version = "0.1.2"
+version = "0.1.3"
 description = "Bounded, auditable verification loops for AI agent output."
 readme = "README.md"
 requires-python = ">=3.10"

{rubricloop-0.1.2 → rubricloop-0.1.3}/src/rubricloop/__init__.py

@@ -56,4 +56,4 @@ __all__ = [
     "verify",
 ]
 
-__version__ = "0.1.2"
+__version__ = "0.1.3"

{rubricloop-0.1.2 → rubricloop-0.1.3}/src/rubricloop/cli.py

@@ -29,6 +29,10 @@ def parser() -> argparse.ArgumentParser:
     login.add_argument("--api-key")
     init = commands.add_parser("init")
     init.add_argument("directory", nargs="?", default=".")
+    create = commands.add_parser("create")
+    create.add_argument("repository")
+    create.add_argument("--description", default="")
+    create.add_argument("--visibility", choices=("public", "private"), default="private")
     for command in ("validate", "test"):
         item = commands.add_parser(command)
         item.add_argument("package")
@@ -89,6 +93,20 @@ def execute(args: argparse.Namespace) -> dict | str:
             + "\n"
         )
         return str(target)
+    if args.command == "create":
+        namespace, slash, name = args.repository.partition("/")
+        if not slash or not namespace or not name or "/" in name:
+            raise RegistryClientError("repository must be namespace/name")
+        return client.json(
+            "POST",
+            "/v1/registry/repositories",
+            payload={
+                "namespace": namespace,
+                "name": name,
+                "description": args.description,
+                "visibility": args.visibility,
+            },
+        )
     if args.command in {"validate", "test"}:
         package = _package(args.package)
         if args.command == "validate":

{rubricloop-0.1.2 → rubricloop-0.1.3}/tests/test_registry_cli.py

@@ -16,7 +16,18 @@ from rubricloop.registry import (
 
 
 def test_cli_exposes_complete_lifecycle():
-    for command in ("login", "init", "validate", "test", "push", "vet", "publish", "pull", "run"):
+    for command in (
+        "login",
+        "init",
+        "create",
+        "validate",
+        "test",
+        "push",
+        "vet",
+        "publish",
+        "pull",
+        "run",
+    ):
         assert command in parser()._subparsers._group_actions[0].choices
 
 
@@ -26,6 +37,42 @@ def test_init_creates_project_without_credentials(tmp_path):
     assert json.loads((tmp_path / "rubricloop.json").read_text())["format_version"] == 1
 
 
+def test_create_calls_repository_endpoint(monkeypatch):
+    calls = []
+    monkeypatch.setattr(
+        RegistryClient,
+        "json",
+        lambda self, method, path, **kwargs: calls.append((method, path, kwargs)) or {"id": "repo"},
+    )
+    result = execute(
+        parser().parse_args(
+            [
+                "create",
+                "acme/reply-check",
+                "--visibility",
+                "public",
+                "--description",
+                "Checks support replies.",
+            ]
+        )
+    )
+    assert result == {"id": "repo"}
+    assert calls == [
+        (
+            "POST",
+            "/v1/registry/repositories",
+            {
+                "payload": {
+                    "namespace": "acme",
+                    "name": "reply-check",
+                    "description": "Checks support replies.",
+                    "visibility": "public",
+                }
+            },
+        )
+    ]
+
+
 def test_credentials_use_keychain_or_explicit_environment(monkeypatch):
     values = {}
     backend_type = type("Backend", (), {})