docs(ISSUE-WP-0006): Forgejo-only language and projection boundary
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
Build and Publish Container Image / build-and-push (push) Successful in 34s

Prefer Forgejo as the self-hosted forge product. Keep Gitea only as the
Gitea-compatible API identifier (module backends/gitea, type string
gitea). FORGEJO_TOKEN is preferred; GITEA_* remains a deprecated alias.

INTENT/SCOPE quote ACT-ADR-005: issue-core is not the fleet ops claim
queue. Connector docs describe repo work record → hub index → optional
Forgejo projection, not activity-core → issue-core → harness.

Assistant: grok
Assistant-Session: 01a09dc6-3f0d-7c93-8b11-8e83c0623d49
This commit is contained in:
tegwick 2026-09-14 04:52:58 +02:00
parent f9d276dadf
commit ee9b85215d
34 changed files with 410 additions and 263 deletions

View file

@ -12,7 +12,8 @@ This directory contains working examples of autonomous agents using the Issue Co
2. **Configure backend** (one-time setup):
```bash
export GITEA_API_TOKEN="your-token"
export FORGEJO_TOKEN="your-token"
# Deprecated alias: GITEA_API_TOKEN
issue backend add myproject gitea
# Enter: URL, owner, repo when prompted
issue backend set-default myproject
@ -20,10 +21,11 @@ This directory contains working examples of autonomous agents using the Issue Co
3. **Set environment variables** for scripts:
```bash
export GITEA_URL=https://gitea.example.com
export GITEA_TOKEN=your-token
export GITEA_OWNER=your-org
export GITEA_REPO=your-repo
export FORGEJO_URL=https://forgejo.example.com
export FORGEJO_TOKEN=your-token
export FORGEJO_OWNER=your-org
export FORGEJO_REPO=your-repo
# Deprecated aliases: GITEA_URL, GITEA_TOKEN, GITEA_OWNER, GITEA_REPO
```
## Examples
@ -212,7 +214,7 @@ issue backend add myproject gitea
### "Authentication failed"
```bash
# Check token is valid
curl -H "Authorization: token $GITEA_TOKEN" $GITEA_URL/api/v1/user
curl -H "Authorization: token $FORGEJO_TOKEN" $FORGEJO_URL/api/v1/user
```
### "No issues found"