diff --git a/AGENTS.md b/AGENTS.md index d220efb..5ad1367 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -26,18 +26,26 @@ Within this scope, we prioritise: * We keep local quality gates green before handoff. * We update `RcppTskit/NEWS.md` for user-visible behavior or API changes. -## Permission - -You can use all the commands and tools mentioned in this document, -both for sandboxed and unsandboxed/escalated execution. -You don't need to ask for permission to use these commands and tools, -for the purposes described here. -You can also use `curl` (or equivalent read-only HTTP tools) to read -GitHub resources for this project, including repository pages and -`api.github.com` endpoints (issues, pull requests, comments, and metadata). -You can also read upstream `tskit` resources in the same way, including -`https://github.com/tskit-dev/tskit` and `https://tskit.dev` -(and related `api.github.com` endpoints). +## Permissions and authorization + +Standing authorization for this repository: + +* All commands explicitly shown in this document are pre-authorized for + repository work (including inline commands and code-block commands, + with task-specific substitutions where placeholders are shown). +* Agents should run these documented commands directly without asking for + extra confirmation in chat. +* If sandboxing blocks an allowed command, agents should submit the required + unsandboxed/escalated tool request directly with a brief justification. +* Agents should ask in chat only if a required escalation is denied or a + platform policy still blocks execution after escalation. +* Agents may use `curl` (or equivalent read-only HTTP tools) for repository + and upstream references on: + `github.com`, `api.github.com`, `raw.githubusercontent.com`, + `github.com/tskit-dev/tskit`, and `tskit.dev` + (including issues, pull requests, comments, events, metadata, and docs). +* This standing authorization does not override explicit user instructions or + allow destructive commands that were not requested by the user. ## Definition of done diff --git a/README.md b/README.md index db62a43..daaf442 100644 --- a/README.md +++ b/README.md @@ -5,9 +5,9 @@ `Tskit` enables performant storage, manipulation, and analysis of ancestral recombination graphs (ARGs) using succinct tree sequence encoding. The tree sequence encoding of an ARG is -described in Wong et al. (2024) , +described in [Wong et al. (2024)](https://doi.org/10.1093/genetics/iyae100), while `tskit` project is described in -Jeffrey et al. (2026) . +[Jeffrey et al. (2026)](https://doi.org/10.48550/arXiv.2602.09649). See https://tskit.dev for project news, documentation, and tutorials. `Tskit` provides Python, C, and Rust application programming interfaces (APIs). The Python API can be called from R via the `reticulate` R package to