Entity states

Every entity moves through a small set of states.

The states

State	Meaning
Charged	Registered on the grid but not yet deployed — no successful build. Produced by grid plug --no-deploy (or a plug whose build has not completed yet); copies from grid fork / grid remix are also minted charged.
Live	Deployed and reachable.
Dark	Deployed but powered down — stopped and reversible. Re-plug to bring it back.
Live (unhealthy)	Deployed but failing its health checks.
Archived	Taken off the grid. Recoverable during the grace period, then removed.
Expired	Inspirations only — reached the 30-day TTL and were reclaimed.

The lifecycle

charged  ──▶  live  ──▶  dark (stopped)  ──▶  archived
                   ╰──▶  live (unhealthy)
inspirations:  live  ──▶  expired  (after the 30-day TTL, unless pinned)

Moving between states

grid new my-app             # scaffold locally (no server entity yet)
grid plug --no-deploy       # → charged (registered, not built)
grid plug                   # charged → live
grid unplug my-app --dark   # live → dark (reversible power-down)
grid plug --grid my-grid    # dark → live (re-plug)
grid unplug my-app          # live → archived (7-day grace period)
grid unplug my-app --hard   # archive immediately, no grace period

grid unplug without a flag archives with a 7-day grace period — data is recoverable during that window. --dark powers down reversibly. --hard archives immediately.

URL patterns

Kind	URL
Runtime (app/agent)	<slug>.<grid>.cloudgrid.io (subdomain)
Inspiration	<grid>.cloudgrid.io/<slug> (path)

The exact slug carries a short suffix to keep it unique. Whatever the pattern, the URL is stable — it does not change across deploys, rollbacks, or visibility changes.