[PR] docs(AGENTS): tool credentials live in $HOME, never in project tree [airflow-steward]

["potiuk (via GitHub)" <gi...@apache.org>]

potiuk opened a new pull request, #46:
URL: https://github.com/apache/airflow-steward/pull/46

   ## Summary
   
   Codify the credential-storage convention every existing framework tool already follows, so future tool integrations follow the same pattern.
   
   - Gmail OAuth → `~/.config/apache-steward/gmail-oauth.json`
   - PonyMail session cookie → `~/.ponymail-mcp/session.json`
   - GitHub auth → `gh auth` (`~/.config/gh/`)
   
   Two reasons it's non-negotiable:
   
   1. The standard sandbox (see `docs/setup/secure-agent-setup.md`) denies reads on home-dir credential paths. An in-tree credential silently bypasses that boundary — every credential read should be an explicit, visible sandbox-bypass moment, not a silent in-tree file slurp.
   2. One credential file should serve every clone / worktree / project, not be re-acquired per checkout.
   
   The new principle slots in as a sibling to the existing *"Run the agent in the credential-isolation setup"* block under `## Local setup`.
   
   ## Test plan
   
   - [ ] Visual review of the AGENTS.md diff — paragraph reads cleanly alongside the credential-isolation block above it.
   - [ ] No tool code change required: existing tools (`tools/gmail/oauth-draft/src/oauth_draft/credentials.py`, `tools/ponymail/`, `tools/github/`) already follow the rule.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [PR] docs(AGENTS): tool credentials live in $HOME, never in project tree [airflow-steward]

["potiuk (via GitHub)" <gi...@apache.org>]

potiuk merged PR #46:
URL: https://github.com/apache/airflow-steward/pull/46


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org