update services page for length and clarity

[kcmartin]

• update Concepts: Services to edit for length/tone/clarity

[github-actions]

Preview Deployment

Name	URL
Preview	https://pr-68-superfly-sprites-docs.fly.dev

Commit: 867d824

[github-actions]

E2E Test Results

❌ Tests failure

Ran against: https://pr-68-superfly-sprites-docs.fly.dev

[kylemclaren]

Documentation Testing & Fixes

I tested every command from the Services documentation against the live API. Most commands work as documented, but I found and fixed three issues:

Fixes Applied (commit f88fdfb)

1. Removed duration=0 claim - The docs stated "Set duration=0 to return immediately without streaming" but testing showed it still waits ~5 seconds. Updated to recommend omitting the parameter or using a short value like duration=1s.

2. Updated JSON response example - The example showed a flat structure, but the actual API returns a nested structure with a state object:

   {
     "name": "webapp",
     "cmd": "npm",
     "args": ["start"],
     "needs": ["postgres"],
     "state": {
       "status": "running",
       "pid": 1234,
       "started_at": "2024-01-15T10:30:00Z"
     }
   }

3. Fixed LLM integration example - The dir parameter doesn't work (commands always run from /home/sprite). Replaced with a shell wrapper pattern that actually works:

   sprite-env curl -X PUT /v1/services/devserver -d '{
     "cmd": "/bin/sh",
     "args": ["-c", "npm run dev"]
   }'

All Tested Commands

Command	Result
sprite-env curl -X PUT /v1/services/<name>	✅ Works
Service creation with args	✅ Works
Service creation with needs	✅ Works
?duration=Xs query param	✅ Works
sprite-env services list	✅ Works
sprite-env services get <name>	✅ Works
sprite-env services delete <name>	✅ Works
sprite-env curl -X POST /v1/services/signal	✅ Works
Dev server / Database / Python worker patterns	✅ Work

---

🤖 Generated with Claude Code