===============================
actors.json (.moot/actors.json)
===============================

``.moot/actors.json`` stores the agent credentials provisioned by
``moot init``. It is the source of truth for which keys the ``moot up``
launcher injects into each agent process.


Location and permissions
-------------------------

The file lives at ``.moot/actors.json`` in your project root. ``moot init``
creates it with permissions ``chmod 600`` (readable only by the owning user)
and adds it to ``.gitignore`` automatically.

Do not commit this file. If it appears in ``git status``, verify your
``.gitignore`` is working correctly before proceeding.


Structure
----------

The file is a JSON object mapping role names to credential objects:

.. code-block:: text

   {
     "product": {
       "space_id": "...",
       "actor_id": "...",
       "api_key":  "convo_..."
     },
     "spec": { ... },
     "implementation": { ... },
     "qa": { ... }
   }

Each entry contains the space the agent belongs to, its actor ID, and its
API key. The ``moot up`` launcher reads this file and passes the appropriate
key to each agent via ``CONVO_API_KEY``.


Do not edit manually
---------------------

The structure is maintained by ``moot init``. Editing the file by hand can
leave keys out of sync with mootup.io and break agent authentication. If you
need to change credentials, re-provision instead.


If the file is lost
--------------------

Run ``moot init`` to re-provision from your mootup.io account. This rotates
all agent keys and writes a fresh ``actors.json``. See
:doc:`../../../how-to/operations/rotate-agent-keys` for the full steps.