62 lines
1.7 KiB
Markdown
62 lines
1.7 KiB
Markdown
|
---
|
||
|
|
name: codeberg-development-flow
|
||
|
|
description: Use when working in this repository on development flow, remotes, Codeberg or Forgejo CLI operations, commit signing, mirroring to GitHub, npm trusted publishing, release validation, or publishing @peezy.tech/codex-flows.
|
||
|
|
---
|
||
|
|
|
||
|
|
# Codeberg Development Flow
|
||
|
|
|
||
|
|
## Overview
|
||
|
|
|
||
|
|
Use Codeberg as the primary development forge and GitHub only as the npm trusted-publishing mirror.
|
||
|
|
|
||
|
|
## Core Rules
|
||
|
|
|
||
|
|
- Treat `origin` as Codeberg: `git@codeberg.org:peezy-tech/codex-flows.git`.
|
||
|
|
- Treat `github` as the GitHub mirror: `https://github.com/peezy-tech/codex-flows.git`.
|
||
|
|
- Push normal development to Codeberg first.
|
||
|
|
- Push to GitHub only when the release workflow must publish to npm.
|
||
|
|
- Do not add npm tokens to the repo or GitHub secrets. GitHub publishes through trusted publishing.
|
||
|
|
- Use package name `@peezy.tech/codex-flows`, not `@peezy-tech/codex-flows`.
|
||
|
|
|
||
|
|
## Setup Checks
|
||
|
|
|
||
|
|
When asked to set up or verify the repo, check:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
git remote -v
|
||
|
|
ssh -T git@codeberg.org
|
||
|
|
fj auth list
|
||
|
|
gpg --list-secret-keys --keyid-format=long
|
||
|
|
```
|
||
|
|
|
||
|
|
Expected local key files:
|
||
|
|
|
||
|
|
```text
|
||
|
|
~/.ssh/id_ed25519_codeberg.pub
|
||
|
|
~/.config/codeberg-keys/matamune-codeberg-gpg.asc
|
||
|
|
```
|
||
|
|
|
||
|
|
## Release Workflow
|
||
|
|
|
||
|
|
Before release, run:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
bun run --filter @peezy.tech/codex-flows release:check
|
||
|
|
bun run check:types
|
||
|
|
bun run test
|
||
|
|
git diff --check
|
||
|
|
```
|
||
|
|
|
||
|
|
Then:
|
||
|
|
|
||
|
|
1. Bump `packages/codex-client/package.json`.
|
||
|
|
2. Commit.
|
||
|
|
3. Push to Codeberg: `git push origin main`.
|
||
|
|
4. Push to GitHub mirror: `git push github main`.
|
||
|
|
5. Run GitHub workflow `.github/workflows/publish-codex-flows.yml` with `confirm_package=@peezy.tech/codex-flows`.
|
||
|
|
6. Verify `npm dist-tag ls @peezy.tech/codex-flows`.
|
||
|
|
|
||
|
|
## References
|
||
|
|
|
||
|
|
- Read `references/development-flow.md` for exact setup and command details.
|