michailbul/andromeda-messages

Andromeda Messages

Full CRUD API for the Andromeda galaxy app plus galaxy lock/unlock control.

Base URL

Use the deployed app base URL for the current environment.

• Current production: https://andromeda.laniameda.space
• Legacy redirect source: https://www.mishabuloichyk.com
• Local standalone repo example: http://localhost:3331

Auth

Authorization: Bearer <ADMIN_TOKEN>

Use the repo's configured ADMIN_TOKEN.

---

Galaxy Name Aliases

The galaxy field accepts any of these:

| Send this | Resolves to | | --- | --- | | "Your Dreams" / "dreams" / "мечты" | sagittarius | | "Your Soulmate" / "soulmate" / "partner" / "laniakea" / "партнёр" | wormhole | | "Your Family" / "family" / "семья" | carina | | "Your Life" / "life" / "жизнь" | andromeda | | "Your Antidreams" / "antidreams" / "антимечты" | kepler | | Raw IDs (sagittarius, wormhole, etc.) | also work |

Always confirm with the canonical display name, not the internal ID.

---

Production Safety Rules

These rules are mandatory. The Andromeda backend is live production data.

1. Never write with raw galaxy IDs (kepler, andromeda, etc.) unless Michael explicitly asks for raw-ID debugging. Use canonical display names in API requests.
2. Always resolve and state the target before mutating: Your Life → andromeda, Your Antidreams → kepler, etc.
3. Before any create, update, delete, lock, unlock, import, or cleanup, run a read check for the target galaxy and note its current node count.
4. After any mutation, re-read the target galaxy and confirm the new count or changed node.
5. For high-risk operations, also check Your Antidreams after the mutation. It should stay empty unless the user explicitly requested an antidream entry.
6. Never use spaceGraph:seedGalaxy, bulk imports, clearGalaxy, direct Convex mutations, or scripts against production unless Michael explicitly approves the exact galaxy and action in the current conversation.
7. Any bulk operation must first create a timestamped backup of affected nodes and edges.

Antidreams Hard Guard

Your Antidreams is kepler. Treat it as protected.

• Do not infer Your Antidreams from vague phrasing.
• Do not use kepler for life, dreams, family, partner/soulmate, or positive aspiration content.
• Only write to Your Antidreams when the user explicitly says Your Antidreams, antidreams, or антимечты.
• If the content reads like a dream, relationship goal, family goal, life goal, or positive aspiration, stop and ask before writing to Your Antidreams.
• If nodes appear in Your Antidreams unexpectedly, immediately stop, back up kepler nodes and edges, report counts, and ask before moving or deleting unless Michael directly asks to clear them.

---

Node Routes (/api/andromeda)

POST — Create a node

curl -s -X POST "$BASE_URL/api/andromeda" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"galaxy":"Your Life","title":"Short title","content":"Full message text","nodeType":"STATION","noteType":"note"}'

For centered markdown articles, set noteType to article:

curl -s -X POST "$BASE_URL/api/andromeda" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"galaxy":"Your Life","title":"Article title","content":"# Markdown article\n\nPure markdown text.","nodeType":"STATION","noteType":"article"}'

GET — List nodes in a galaxy

curl -s "$BASE_URL/api/andromeda?galaxy=Your+Life" \
  -H "Authorization: Bearer $ADMIN_TOKEN"

PATCH — Update a node

curl -s -X PATCH "$BASE_URL/api/andromeda" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nodeId":"<id>","title":"New title","content":"New content","noteType":"article"}'

DELETE — Delete a node

curl -s -X DELETE "$BASE_URL/api/andromeda?nodeId=<id>" \
  -H "Authorization: Bearer $ADMIN_TOKEN"

---

Galaxy Lock Routes (/api/andromeda/galaxy)

GET — List all galaxy lock states

curl -s "$BASE_URL/api/andromeda/galaxy" \
  -H "Authorization: Bearer $ADMIN_TOKEN"

POST — Lock or unlock a galaxy

curl -s -X POST "$BASE_URL/api/andromeda/galaxy" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"galaxy":"Your Life","locked":false}'

Set locked: false to unlock, locked: true to lock.

---

nodeType Options

• STATION — main message node
• RELAY — connecting or transition node
• SENSOR — observation or detail node

noteType Options

• note — regular galaxy node that opens in the side panel
• article — markdown article node that opens in a centered modal

Use noteType: "article" whenever Michael asks for an article, long-form note, markdown article, essay, centered reader, or modal-style note. Use noteType: "note" or omit it for the existing side-panel behavior.

---

Workflow Examples

Add to Your Dreams: title "Morning Light", content "..." Use POST /api/andromeda, then confirm the canonical galaxy name.

Add article to Your Life: title "What I learned", content "# What I learned\n\n..." Use POST /api/andromeda with {"noteType":"article"}. Confirm the canonical galaxy name and that it opens in the centered article modal.

Unlock Your Life Use POST /api/andromeda/galaxy with {"galaxy":"Your Life","locked":false}.

List all nodes in Your Family Use GET /api/andromeda?galaxy=Your+Family.

Delete the node with id X Use DELETE /api/andromeda?nodeId=X.

Update title of node X to "..."
Use PATCH /api/andromeda with { nodeId, title }.

---

Notes

• Changes are live immediately through Convex
• nodeType controls the 3D node shape/category; noteType controls the reader UI
• Article markdown lives in content/missionProfile; the article marker is stored as data.noteType
• Galaxy lock state lives in the galaxySettings table
• Admin UI route: /admin/andromeda