migrated all pawprint work

artery/__init__.py

@@ -1,11 +1,36 @@
 """
 Artery - Todo lo vital
 
-Connectors to external services (Jira, Slack, APIs, etc.)
+Connectors to external services.
+
+Hierarchy (simple → complex):
+
+    Vein ──────► Pulse ──────► Plexus
+    │           │              │
+    │           │              └── Full app: backend + frontend + DB
+    │           │                  (e.g., WhatsApp with chat UI)
+    │           │
+    │           └── Composed: Vein + Room + Depot
+    │               (e.g., Jira vein configured for specific project)
+    │
+    └── Stateless API connector
+        (e.g., Jira client, Slack client)
 
 Components:
-    - veins/   Single-responsibility connectors
-    - pulses/  Composed: Vein + Room + Depot
-    - rooms/   Environment configs
-    - depots/  Data storage
+    - veins/     Stateless connectors (core/ + api/)
+    - pulses/    Composed: Vein + Room + Depot
+    - plexuses/  Full applications with frontend
+    - rooms/     Environment configs
+    - depots/    Data storage
+
+Differences:
+
+    | Aspect     | Vein              | Pulse             | Plexus                    |
+    |------------|-------------------|-------------------|---------------------------|
+    | State      | None (or OAuth)   | Vein + config     | Full application state    |
+    | Frontend   | Optional test UI  | None (uses vein)  | Required full frontend    |
+    | Webhooks   | No                | No                | Yes                       |
+    | Deploy     | With soleprint    | With soleprint    | Self-contained (docker)   |
 """
+
+from . import veins