1.8 KiB
1.8 KiB
AGENTS.md
This is a StartOS service-package repository — it builds a .s9pk for StartOS.
Develop it inside a StartOS packaging workspace created by start-cli s9pk init-workspace,
which provides the packaging guide and agent context one level up. If you're reading this in a
bare clone with no workspace, the full guide is at https://docs.start9.com/packaging.
Work this package's TODO.md from top to bottom. Keep README.md (technical reference for an AI support or administering agent) and instructions.md (end-user docs) in sync with your changes.
This repo
config.json's shape must stay exactly upstream's. The proxy rewrites the whole file when a key is saved on the Status Page, so anything the package adds there is destroyed. Package-owned settings go instore.jsonat the volume root — outside theproxy/subpath that is mounted — where the container cannot see or clobber them.- Don't set
PPQ_API_KEY. Leaving it unset makes the proxy's own key store the single owner, so the action and the Status Page write the same key rather than competing. - The task is
important, notcritical, on purpose. Acriticaltask suspends the ordinary controls, which would stop the user starting the service — and the Status Page is the other place a key can be saved. Blocking startup would block half the ways to complete the task. - The key pattern is validated in the action because upstream only validates on the Status Page — a malformed key written straight to
config.jsonsurfaces later as a 401 on the first request. - A blank key field preserves the existing key, so the action doubles as the way to toggle logging. Don't "fix" it to clear on empty.
- Default branch is
main, notmaster. Its CI workflows referencemain; leave them.