foxyz
32848aaf71
release.sh writes updates/manifest.json at release time (predictable asset URL) — no CI commit-back, no push-token problem, no detached checkout dance. release_publish.sh is create-release + upload only. Manifest sha256 now optional; updater skips verification with a note when absent (HTTPS + gzip CRC cover the realistic cases). Fixed the repo-URL sed keeping a .git suffix (caught by a worktree dry run). Updater tests: 8 (sha-less manifest flow added).
36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
# AGENTS.md — sync_relay_project
|
|
|
|
Project conventions for agents. Global interaction rules live in the
|
|
user-level AGENTS.md; this file holds repo-specific facts only.
|
|
Source of truth order: codebase > `HANDOFF.md` + `docs/ROADMAP.md` >
|
|
chat history.
|
|
|
|
## Wishlist drafts
|
|
|
|
The user drops raw idea/bug lists as drafts (gitignored, never
|
|
committed: `docs/Wishlist.md`, `docs/drafts/`). Agent duty on sight:
|
|
translate each entry into its proper place — `docs/ROADMAP.md`
|
|
backlog (ordered, one sitting-sized item each) or Epics, real bugs
|
|
with repro detail preserved — then confirm placement with the user
|
|
and delete the draft. Drafts must never be committed, even partially.
|
|
|
|
## Commits
|
|
|
|
Few commits, one per topic/session — never per fix. Rewriting
|
|
unpushed history (amend, squash) is expected, not exceptional.
|
|
Commit code + its docs together. No `flutter analyze` unless asked
|
|
or diagnosing; scoped `dart analyze` on touched files is the
|
|
pre-commit check. Tests run only when the code under test changed.
|
|
|
|
## Releases (user pushes tags, CI does the rest)
|
|
|
|
Release flow: `tool/release.sh [patch|minor|major]` derives the
|
|
version (no typing), bumps all pubspecs, commits, tags → review →
|
|
`git push --follow-tags` → `.gitea/workflows/release.yml`
|
|
builds and publishes the Forgejo release (manifest already written
|
|
by release.sh — predictable asset URL, no CI roundtrip). `tool/release_publish.sh` is the same
|
|
flow by hand. Workflows live in `.gitea/workflows` (this forge reads
|
|
`.gitea` first, `.github` is ignored when it exists).
|
|
Never commit secrets: tokens arrive via env (`DISCORD_WEBHOOK_URL`,
|
|
`RELEASE_TOKEN`) or Actions-provided (`GITHUB_TOKEN/GITEA_TOKEN`).
|