# Upstream helpers for polis-protocol-a-self-optimizing-city-of-agents

The files listed below were recovered from [ymxlx/polis-protocol](https://github.com/ymxlx/polis-protocol) at commit `eb7d3a9ca8cca5f719c1b0bd4ee657adb3c13dcd`. The repository ID is `1239920071`.

They retain the upstream **MIT** license reproduced in [UPSTREAM-LICENSE.txt](UPSTREAM-LICENSE.txt). This notice applies to the listed support files; it does not replace the license metadata of other catalog files. Preserve the upstream license and this attribution when redistributing them.

License wording is unchanged; text-only trailing whitespace and EOF blank lines are normalized. Original license: https://github.com/ymxlx/polis-protocol/blob/eb7d3a9ca8cca5f719c1b0bd4ee657adb3c13dcd/LICENSE

| Local file | Original upstream path | Original Git blob SHA | Import changes |
| --- | --- | --- | --- |
| `references/troubleshooting.md` | `references/troubleshooting.md` | `d8321888bbda5112324ac9a6497ece50dba9a10f` | text-only trailing whitespace and EOF blank lines normalized |
| `references/protocol-spec.md` | `references/protocol-spec.md` | `9e9728ffa3e6319b726efb540e5f3f013bded8b1` | text-only trailing whitespace and EOF blank lines normalized |
| `references/templates.md` | `references/templates.md` | `d3af17bc62605c8129d16ebb95394ec0abdb1bd2` | text-only trailing whitespace and EOF blank lines normalized |
| `scripts/route_contract.py` | `scripts/route_contract.py` | `503435ad6bb54879251708dbb4cd1998be72c1fd` | content unchanged |
| `references/routing.md` | `references/routing.md` | `7346d10411b4294304b6720de97b17e0030e55d8` | text-only trailing whitespace and EOF blank lines normalized |
| `references/amendments.md` | `references/amendments.md` | `fafbe26a8fbfce330a160bd906d923eecbbc49c7` | text-only trailing whitespace and EOF blank lines normalized |
| `scripts/init_polis.py` | `scripts/init_polis.py` | `c0cfc4e1505eac4db7e6c6fbb223efc9a6f4c8e4` | content unchanged |
| `templates/POLIS_CONSTITUTION.md` | `templates/POLIS_CONSTITUTION.md` | `7996a6b9efdccbb7bbe7032eea1102f9d30b8084` | text-only trailing whitespace and EOF blank lines normalized |

Local review modifications: scope/privacy/concurrency and heuristic-policy guidance revised; offline initializer made complete for its bundled templates, exclusive and symlink-refusing; implicit router import replaced by an explicit missing-dependency notice. Original upstream hashes above describe imported sources, not the modified current files.