Add friendly names system for recipes, effects, and media

- Add friendly_names table with unique constraints per actor
- Create NamingService with HMAC-signed timestamp version IDs
- Version IDs use base32-crockford encoding, always increase alphabetically
- Name normalization: spaces/underscores to dashes, lowercase, strip special chars
- Format: "my-effect 01hw3x9k" (space separator ensures uniqueness)
- Integrate naming into recipe, effect, and media uploads
- Resolve friendly names to CIDs during DAG execution
- Update effects UI to display friendly names
- Add 30 tests covering normalization, parsing, and service structure

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

app/routers/effects.py

@@ -200,12 +200,24 @@ async def upload_effect(
     # Also store metadata in IPFS for discoverability
     meta_cid = ipfs_client.add_json(full_meta)
 
-    logger.info(f"Uploaded effect '{meta.get('name')}' cid={cid} by {ctx.actor_id}")
+    # Assign friendly name
+    from ..services.naming_service import get_naming_service
+    naming = get_naming_service()
+    friendly_entry = await naming.assign_name(
+        cid=cid,
+        actor_id=ctx.actor_id,
+        item_type="effect",
+        display_name=meta.get("name"),
+        filename=file.filename,
+    )
+
+    logger.info(f"Uploaded effect '{meta.get('name')}' cid={cid} friendly_name='{friendly_entry['friendly_name']}' by {ctx.actor_id}")
 
     return {
         "cid": cid,
         "metadata_cid": meta_cid,
         "name": meta.get("name"),
+        "friendly_name": friendly_entry["friendly_name"],
         "version": meta.get("version"),
         "temporal": meta.get("temporal", False),
         "params": meta.get("params", []),
@@ -244,6 +256,15 @@ async def get_effect(
         meta = {"cid": cid, "meta": parsed_meta}
         (effect_dir / "metadata.json").write_text(json.dumps(meta, indent=2))
 
+    # Add friendly name if available
+    from ..services.naming_service import get_naming_service
+    naming = get_naming_service()
+    friendly = await naming.get_by_cid(ctx.actor_id, cid)
+    if friendly:
+        meta["friendly_name"] = friendly["friendly_name"]
+        meta["base_name"] = friendly["base_name"]
+        meta["version_id"] = friendly["version_id"]
+
     if wants_json(request):
         return meta
 
@@ -295,6 +316,10 @@ async def list_effects(
     effects_dir = get_effects_dir()
     effects = []
 
+    # Get naming service for friendly name lookup
+    from ..services.naming_service import get_naming_service
+    naming = get_naming_service()
+
     if effects_dir.exists():
         for effect_dir in effects_dir.iterdir():
             if effect_dir.is_dir():
@@ -302,6 +327,13 @@ async def list_effects(
                 if metadata_path.exists():
                     try:
                         meta = json.loads(metadata_path.read_text())
+                        # Add friendly name if available
+                        cid = meta.get("cid")
+                        if cid:
+                            friendly = await naming.get_by_cid(ctx.actor_id, cid)
+                            if friendly:
+                                meta["friendly_name"] = friendly["friendly_name"]
+                                meta["base_name"] = friendly["base_name"]
                         effects.append(meta)
                     except json.JSONDecodeError:
                         pass