@palettelab/cli 0.3.33 → 0.3.34

package/README.md

@@ -509,6 +509,51 @@ management. For advanced Qdrant features, use `ctx.vector.client()` with
 `collection_name()`, `scoped_filter()`, `merge_filter()`, `scoped_payload()`,
 and `scoped_point()` so custom calls remain scoped.
 
+Common managed-service commands:
+
+```python
+# Redis strings, counters, and key discovery
+await ctx.redis.get("key", default=None)
+await ctx.redis.set("key", {"json": True}, ttl=600)
+await ctx.redis.delete("key1", "key2")
+await ctx.redis.exists("key")
+await ctx.redis.expire("key", 300)
+await ctx.redis.ttl("key")
+await ctx.redis.incr("counter")
+await ctx.redis.decr("counter")
+await ctx.redis.scan(prefix="cache:", limit=100)
+
+# Redis hashes, lists, sets, sorted sets, streams, locks
+await ctx.redis.hset("hash", "field", {"value": 1})
+await ctx.redis.hgetall("hash")
+await ctx.redis.lpush("queue", {"job": 1})
+await ctx.redis.lrange("queue", 0, -1)
+await ctx.redis.sadd("tags", "red", "blue")
+await ctx.redis.smembers("tags")
+await ctx.redis.zadd("scores", {"alice": 10})
+await ctx.redis.zrange("scores", 0, -1, with_scores=True)
+await ctx.redis.xadd("events", {"type": "created"})
+await ctx.redis.xread({"events": "0-0"}, count=10)
+await ctx.redis.lock("invoice:1", token, ttl=30)
+await ctx.redis.unlock("invoice:1", token)
+
+# Redis provider-style data-plane calls
+await ctx.redis.execute("MSET", "a", "1", "b", "2")
+values = await ctx.redis.execute("MGET", "a", "b")
+
+# Vector search
+await ctx.vector.upsert_texts("knowledge", [{"id": "doc-1", "text": "Text"}])
+await ctx.vector.upsert_vectors("knowledge", [{"id": "vec-1", "vector": [0.1, 0.2]}])
+hits = await ctx.vector.search("knowledge", query="invoice policy", top_k=10)
+record = await ctx.vector.get("knowledge", "doc-1")
+await ctx.vector.delete("knowledge", ["doc-1"])
+await ctx.vector.delete_index("knowledge")
+stats = await ctx.vector.stats("knowledge")
+```
+
+Blocked Redis control-plane commands include `FLUSHDB`, `FLUSHALL`, `CONFIG`,
+`KEYS`, `CLUSTER`, `SCRIPT`, `EVAL`, `FUNCTION`, and `SELECT`.
+
 ### `pltt login`
 
 Save a Palette sandbox or production environment URL plus token in `~/.palette/config.json` with file mode `0600`. Environment variables still override the stored token when present.

package/docs/python-backend-sdk.md

@@ -344,6 +344,52 @@ Alembic migrations. Route code intentionally has data permissions only; it
 cannot access Palette core tables, another app's schema, or another org's
 RLS-protected rows.
 
+Common `ctx.db` operations:
+
+```python
+from sqlalchemy import delete, func, insert, select, text, update
+
+rows = (await ctx.db.execute(select(Invoice))).scalars().all()
+invoice = await ctx.db.scalar(select(Invoice).where(Invoice.id == invoice_id))
+count = await ctx.db.scalar(select(func.count()).select_from(Invoice))
+
+ctx.db.add(Invoice(customer_name="A", amount=10, status="draft"))
+ctx.db.add_all([
+    Invoice(customer_name="B", amount=20, status="draft"),
+    Invoice(customer_name="C", amount=30, status="draft"),
+])
+await ctx.db.execute(insert(Invoice).values(customer_name="D", amount=40, status="draft"))
+await ctx.db.execute(update(Invoice).where(Invoice.id == invoice_id).values(status="paid"))
+await ctx.db.execute(delete(Invoice).where(Invoice.id == invoice_id))
+
+async with ctx.db.begin():
+    ctx.db.add(Invoice(customer_name="E", amount=50, status="queued"))
+
+await ctx.db.commit()
+await ctx.db.rollback()
+await ctx.db.refresh(invoice)
+
+result = await ctx.db.execute(
+    text("select id, customer_name from finance_tools__invoices where amount > :amount"),
+    {"amount": 100},
+)
+rows = result.mappings().all()
+```
+
+Common migration operations:
+
+```python
+op.create_table(...)
+op.add_column(...)
+op.alter_column(...)
+op.create_index(...)
+op.create_unique_constraint(...)
+op.create_foreign_key(...)
+op.drop_index(...)
+op.drop_column(...)
+ensure_org_rls(op, "finance_tools__invoices")
+```
+
 ## 8. Data Rooms From Python
 
 Use `ctx.data_rooms` when backend code needs to create folders, find files, or
@@ -569,6 +615,93 @@ while blocking server/admin commands. `ctx.vector.client()` returns the Qdrant
 client for custom calls; combine it with `collection_name()`, `scoped_filter()`,
 `merge_filter()`, `scoped_payload()`, and `scoped_point()` to preserve isolation.
 
+Common `ctx.redis` commands:
+
+```python
+await ctx.redis.get("key", default=None)
+await ctx.redis.set("key", {"json": True}, ttl=600, nx=False, xx=False)
+await ctx.redis.delete("key1", "key2")
+await ctx.redis.exists("key")
+await ctx.redis.expire("key", 300)
+await ctx.redis.ttl("key")
+await ctx.redis.incr("counter", 1)
+await ctx.redis.decr("counter", 1)
+await ctx.redis.scan(prefix="cache:", limit=100)
+
+await ctx.redis.hset("hash", "field", {"value": 1})
+await ctx.redis.hget("hash", "field")
+await ctx.redis.hgetall("hash")
+await ctx.redis.hdel("hash", "field")
+
+await ctx.redis.lpush("queue", {"job": 1})
+await ctx.redis.rpush("queue", {"job": 2})
+await ctx.redis.lpop("queue")
+await ctx.redis.rpop("queue")
+await ctx.redis.lrange("queue", 0, -1)
+
+await ctx.redis.sadd("tags", "red", "blue")
+await ctx.redis.smembers("tags")
+await ctx.redis.srem("tags", "red")
+
+await ctx.redis.zadd("scores", {"alice": 10, "bob": 8})
+await ctx.redis.zrange("scores", 0, -1, with_scores=True)
+await ctx.redis.zrem("scores", "bob")
+
+await ctx.redis.enqueue("jobs", {"task": "sync"})
+await ctx.redis.dequeue("jobs")
+await ctx.redis.xadd("events", {"type": "created"})
+await ctx.redis.xread({"events": "0-0"}, count=10)
+await ctx.redis.lock("invoice:1", token, ttl=30)
+await ctx.redis.unlock("invoice:1", token)
+```
+
+Provider-style Redis commands:
+
+```python
+await ctx.redis.execute("MSET", "a", "1", "b", "2")
+values = await ctx.redis.execute("MGET", "a", "b")
+await ctx.redis.execute("ZUNIONSTORE", "dest", 2, "scores:1", "scores:2")
+```
+
+Server/admin Redis commands are blocked because they would affect the shared
+central Redis instance: `FLUSHDB`, `FLUSHALL`, `CONFIG`, `KEYS`, `CLUSTER`,
+`SCRIPT`, `EVAL`, `FUNCTION`, `SELECT`, and similar control-plane commands.
+
+Common `ctx.vector` commands:
+
+```python
+await ctx.vector.upsert_texts(
+    "knowledge",
+    [{"id": "doc-1", "text": "Text to embed", "metadata": {"type": "note"}}],
+)
+await ctx.vector.upsert_vectors(
+    "knowledge",
+    [{"id": "vec-1", "vector": [0.1, 0.2], "metadata": {"type": "manual"}}],
+)
+hits = await ctx.vector.search("knowledge", query="invoice policy", top_k=10)
+hits = await ctx.vector.search("knowledge", vector=[0.1, 0.2], filter={"type": "note"})
+record = await ctx.vector.get("knowledge", "doc-1")
+await ctx.vector.delete("knowledge", ["doc-1"])
+await ctx.vector.delete_index("knowledge")
+stats = await ctx.vector.stats("knowledge")
+```
+
+Advanced Qdrant calls should use scoped helpers:
+
+```python
+client = await ctx.vector.client()
+collection = ctx.vector.collection_name()
+query_filter = ctx.vector.scoped_filter("knowledge", {"type": "note"})
+point = ctx.vector.scoped_point(
+    "knowledge",
+    id="doc-2",
+    vector=[0.1, 0.2],
+    text="Indexed text",
+    metadata={"type": "note"},
+)
+await client.upsert(collection_name=collection, points=[point])
+```
+
 ## 10. Lifecycle Hooks
 
 Lifecycle hooks let an app seed defaults or clean up app-owned data when the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@palettelab/cli",
-  "version": "0.3.33",
+  "version": "0.3.34",
   "description": "Developer CLI for building Palette platform plugins — no platform source access required.",
   "bin": {
     "pltt": "bin/pltt.js"