morphdb 0.1.4__tar.gz → 0.1.5__tar.gz

{morphdb-0.1.4 → morphdb-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: morphdb
-Version: 0.1.4
+Version: 0.1.5
 Summary: A coding-agent-friendly, multi-tenant backend for vibe-coded websites. One process hosts many isolated apps; reshape each app's schema as fast as your agent iterates while the frontend keeps calling the same generic endpoints.
 Author: morphdb contributors
 License: MIT

{morphdb-0.1.4 → morphdb-0.1.5}/morphdb/__init__.py

@@ -5,4 +5,4 @@ coding agent iterates, while the frontend keeps calling the same small set of
 generic, deterministic endpoints.
 """
 
-__version__ = "0.1.4"
+__version__ = "0.1.5"

{morphdb-0.1.4 → morphdb-0.1.5}/morphdb/skill/SKILL.md

@@ -34,11 +34,18 @@ localhost-scale dev tool.
 
 ## The MorphDB tools (how you reshape the data model)
 
-These come from the `morphdb` MCP server. If you can see tools named `add_field`,
-`describe_type`, etc. (in Claude Code they appear as `mcp__morphdb__add_field`),
-use them. They each take the app key as `app` (or default to the `$MORPHDB_APP`
-env var). The tools talk to the backend for you and **auto-start it** if it is
-not running, so you don't have to manage the server in the common case.
+These come from the `morphdb` MCP server. **First, check which path you're on:**
+look for tools named `add_field` / `add_relation` (in Claude Code they appear as
+`mcp__morphdb__add_field`). **If you see them, use them** (this section). **If you
+don't** — a hosted `MORPHDB_HOST` setup, or the MCP server just isn't wired up —
+don't keep trying to call them and don't give up: skip to the **"Fallback: no
+MorphDB tools available?"** section at the end and drive the bundled script
+instead. Everything else in this skill (the data model, the endpoints, the
+queries) applies either way.
+
+When the tools are present, they each take the app key as `app` (or default to the
+`$MORPHDB_APP` env var). The tools talk to the backend for you and **auto-start it**
+if it is not running, so you don't have to manage the server in the common case.
 
 | Tool | What it does |
 | --- | --- |
@@ -276,6 +283,12 @@ applies here — cheap context that keeps later edits consistent.
   strings → numbers. A boolean for a `number` field is rejected.
 - A relation may not share a name with a field on the same type. A non-symmetric
   self-relation needs distinct forward/inverse names (or use `symmetric`).
+- The **inverse** of a relation shows up on the *other* type, not in the
+  `add_relation` response — `describe_type` the target type to see it (declare
+  `order.customer`, and `customer.orders` appears on `customer`). Inverse names only
+  need to be unique on the type they land on, so two relations can reuse an inverse
+  label when they point at **different** target types (`review.book` and
+  `review.author` can both use inverse `reviews`).
 - Setting a relation is set-as-field (the value becomes its full set). For a
   single-valued slot already taken, **last write wins** (the old link is moved).
   `null`/`[]` clears.
@@ -296,12 +309,15 @@ still do schema edits with the bundled zero-dependency script — it hits the sa
 HTTP API and takes `--app KEY` (or `$MORPHDB_APP`):
 
 ```bash
-S="python3 ~/.claude/skills/morphdb/scripts/morphdb_schema.py"
-$S register-app my-cool-site
+# define a helper (a function works in both bash and zsh; a "VAR=…; $VAR"
+# alias does NOT word-split in zsh, so use this form)
+mdb() { python3 ~/.claude/skills/morphdb/scripts/morphdb_schema.py "$@"; }
+mdb register-app my-cool-site
 export MORPHDB_APP=my-cool-site
-$S add-field task title string
-$S add-relation task assignee --to user --cardinality many_to_one --inverse tasks
-$S list ; $S show task
+mdb add-field task title string
+mdb add-field task status string --index   # --index → filterable/sortable (like index:true)
+mdb add-relation task assignee --to user --cardinality many_to_one --inverse tasks
+mdb list ; mdb show task
 ```
 
 Prefer the tools when they exist; the script is the no-MCP fallback. To wire the

{morphdb-0.1.4 → morphdb-0.1.5}/morphdb/skill/scripts/morphdb_schema.py

@@ -23,7 +23,7 @@ Usage:
     list                          Show every type in the app (fields + relations).
     show   <type>                 Show one type's schema.
 
-    add-field    <type> <name> <ftype> [--default V] [--required]
+    add-field    <type> <name> <ftype> [--default V] [--required] [--index]
     drop-field   <type> <name>
 
     add-relation <type> <name> --to T --cardinality C
@@ -43,6 +43,10 @@ Cardinalities: one_to_one, one_to_many, many_to_one, many_to_many.
 A relation is declared once (on the "from" side); its inverse appears
 automatically on the other type. Use --symmetric for mutual links within one
 type (to == <type>, cardinality one_to_one or many_to_many).
+
+Indexing: a field can only be filtered or sorted (GET /objects/{type}?field=…)
+if it was added with --index (json fields can't be indexed). Relations are
+always filterable without a flag. Index the few fields you actually query.
 """
 
 import argparse
@@ -141,6 +145,8 @@ def cmd_add_field(url, app, args):
         fdef["default"] = _parse_default(args.default)
     if args.required:
         fdef["required"] = True
+    if args.index:
+        fdef["index"] = True
     # merge:true so existing fields/relations are untouched.
     doc = {"merge": True, "fields": {args.name: fdef}}
     _pretty(_put_type(url, app, args.type, doc))
@@ -222,7 +228,8 @@ def cmd_set(url, app, args):
 def build_parser():
     p = argparse.ArgumentParser(prog="morphdb_schema", description=__doc__,
                                 formatter_class=argparse.RawDescriptionHelpFormatter)
-    p.add_argument("--url", default=DEFAULT_URL, help=f"MorphDB base URL (default {DEFAULT_URL})")
+    p.add_argument("--url", default=DEFAULT_URL,
+                   help=f"MorphDB base URL (default {DEFAULT_URL}; or set $MORPHDB_HOST)")
     p.add_argument("--app", default=None,
                    help="App key (default $MORPHDB_APP). Required except for register-app/delete-app.")
     sub = p.add_subparsers(dest="command", required=True)
@@ -241,6 +248,9 @@ def build_parser():
     sp.add_argument("type"); sp.add_argument("name")
     sp.add_argument("ftype", choices=["string", "number", "boolean", "json", "datetime"])
     sp.add_argument("--default"); sp.add_argument("--required", action="store_true")
+    sp.add_argument("--index", action="store_true",
+                    help="make this field filterable/sortable (backfills existing "
+                         "objects; json can't be indexed)")
     sp.set_defaults(func=cmd_add_field)
 
     sp = sub.add_parser("drop-field")

{morphdb-0.1.4 → morphdb-0.1.5}/morphdb.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: morphdb
-Version: 0.1.4
+Version: 0.1.5
 Summary: A coding-agent-friendly, multi-tenant backend for vibe-coded websites. One process hosts many isolated apps; reshape each app's schema as fast as your agent iterates while the frontend keeps calling the same generic endpoints.
 Author: morphdb contributors
 License: MIT

{morphdb-0.1.4 → morphdb-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "morphdb"
-version = "0.1.4"
+version = "0.1.5"
 description = "A coding-agent-friendly, multi-tenant backend for vibe-coded websites. One process hosts many isolated apps; reshape each app's schema as fast as your agent iterates while the frontend keeps calling the same generic endpoints."
 readme = "README.md"
 requires-python = ">=3.10"