codex-flows/.codex/skills/codeberg-development-flow/references/development-flow.md

# Codeberg Development Flow Reference

## Remotes

```bash
git remote -v
# origin  git@codeberg.org:peezy-tech/codex-flows.git
# github  https://github.com/peezy-tech/codex-flows.git
```

`main` should track Codeberg:

```bash
git branch --set-upstream-to=origin/main main
git status --short --branch
# ## main...origin/main
```

Use Codeberg for day-to-day work:

```bash
git pull
git push
```

Use GitHub only to run npm trusted publishing:

```bash
git push github main
gh workflow run publish-codex-flows.yml --repo peezy-tech/codex-flows --ref main -f confirm_package='@peezy.tech/codex-flows'
```

## Keys

SSH public key:

```text
~/.ssh/id_ed25519_codeberg.pub
```

GPG public key:

```text
~/.config/codeberg-keys/matamune-codeberg-gpg.asc
```

Git signing is expected:

```bash
git config --global commit.gpgsign true
git config --global user.signingkey E3B0D5FB2E5CF11FAFB2EA113BB8E7D3B968A324
```

## Forgejo CLI

`forgejo-cli` is installed as `fj`.

The configured Codeberg login should be visible as `matamune@codeberg.org`:

```bash
fj --host codeberg.org auth list
```

If authentication needs to be recreated:

```bash
fj --host codeberg.org auth add-key matamune <token>
fj --host codeberg.org auth use-ssh true
```

Create the organization repo when missing:

```bash
fj --host codeberg.org org repo create peezy-tech codex-flows \
  -d "Public monorepo for @peezy.tech/codex-flows" \
  -S true
```

Verify the repository:

```bash
fj --host codeberg.org repo view peezy-tech/codex-flows
git ls-remote origin HEAD refs/heads/main
```

## Package Release Gate

```bash
bun run --filter @peezy.tech/codex-flows release:check
bun run check:types
bun run test
git diff --check
```

Verify npm after GitHub Actions publishing:

```bash
npm dist-tag ls @peezy.tech/codex-flows
npm view @peezy.tech/codex-flows version repository --json
```

## Current Constructed State

- Codeberg repo: `https://codeberg.org/peezy-tech/codex-flows`
- GitHub mirror: `https://github.com/peezy-tech/codex-flows`
- `origin/main` and `github/main` should be kept aligned for release commits.
- Latest setup commit: `cebe948fbc44a027d905d26a972ab243f6a5d9c6`.