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:

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"}'

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"}'

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

Workflow Examples

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

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
• Galaxy lock state lives in the galaxySettings table
• Admin UI route: /admin/andromeda