eSlider
63d3be0e19
- bin/db/psql-yq + bin/web/search + tools/{yamlout,websearch} vendored as real files
- bin/db/ssh-tunnel added (OnlyOffice VM pg on 5433)
- skills reference local bin/ paths; no agent-skills/abs links in git
- pyproject.toml + uv.lock; CI installs via uv sync --frozen
- release-please auto-tags semver from conventional commits when green
- LICENSE MIT, badges/mermaid README
1.4 KiB
1.4 KiB
name, description
| name | description |
|---|---|
| db-yaml | Read any Postgres as compact YAML through db/psql-yq, with a read-only guard and named profiles. Use when a task needs table contents, column types or a SELECT against cs_brain or another project database. |
db-yaml
bin/db/psql-yq (vendored in this repo) talks to Postgres and returns YAML,
which is far cheaper than a psql ASCII table and easy to slice with yq.
bin/db/psql-yq --profile onlyoffice -s document_asset # column list
bin/db/psql-yq --profile onlyoffice -t task_result -l 20 # sample rows as YAML
bin/db/psql-yq --profile onlyoffice -c 'SELECT ...' # query -> YAML
Ad-hoc targets without a profile:
bin/db/psql-yq --container my-pg --db app -c 'SELECT 1'
bin/db/psql-yq --dsn 'postgres://user@host:5432/db' -c 'SELECT 1'
Profiles
Connection details live in ~/.config/brain/db-profiles.yml (mode 600), never in a
project repo. A profile names either a container or a host; passwords are read
from a separate password_env_file and never appear in argv.
Rules
- Read-only. Any
insert|update|delete|drop|truncate|alter|create|grant| revoke|vacuum|copyis rejected with exit 3. Do not work around it. - PII.
cs_brainholds client data. Aggregate and count freely; never copy names or addresses into chat, issues or docs. - Use
-lto keep samples small. Twenty rows answer most questions.