|
|
|
@@ -12,38 +12,6 @@ There is exactly one remote — `origin` — pointing to the self-hosted Gitea r
|
|
|
|
|
|
|
|
|
|
Do **not** add GitHub remotes. There is no `origin` on github.com and no separate "dev" repo. If you see `github.com/dzinesco/*` URLs in `.git/config`, that is stale configuration from a previous fork and should be removed (`git remote remove`).
|
|
|
|
|
|
|
|
|
|
### Gitea authentication (SSH)
|
|
|
|
|
|
|
|
|
|
This workspace has been using Gitea via SSH for all operations. The Gitea instance is self-hosted at `git.crispygoat.com` (web UI: `https://git.crispygoat.com`, API base: `https://git.crispygoat.com/api/v1`).
|
|
|
|
|
|
|
|
|
|
**SSH key:** `~/.ssh/id_ed25519_crispygoat` is the dedicated key registered with the Gitea instance (alias `dog` per the Gitea SSH banner). Add it to the agent before any git operation:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
eval "$(ssh-agent -s)"
|
|
|
|
|
ssh-add ~/.ssh/id_ed25519_crispygoat
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The SSH config (`~/.ssh/config`) already aliases the host as `crispygoat` with `AddKeysToAgent yes`, so subsequent shells can just `ssh crispygoat` / `git push origin ...` without re-adding.
|
|
|
|
|
|
|
|
|
|
**Verified working commands:**
|
|
|
|
|
- `git push origin <branch>` — push (this is the primary workflow)
|
|
|
|
|
- `ssh -p 22 git@git.crispygoat.com` — auth check; Gitea returns "successfully authenticated" + "Gitea does not provide shell access"
|
|
|
|
|
|
|
|
|
|
**API token:** This environment does **not** have a Gitea personal access token in any known location (no `~/.config/gitea`, no `GITEA_ACCESS_TOKEN` env, no token in `~/.config/gh/hosts.yml`). Do not assume a token is available — auth attempts will return `{"message":"invalid username, password or token"}`.
|
|
|
|
|
|
|
|
|
|
**`tea` CLI / `gitea-mcp`:** Both are installed but require a token; `--ssh-agent-key` is recognized by `tea logins add` but the underlying SDK still falls back to requiring a token. Treat these as unavailable until a token is provisioned.
|
|
|
|
|
|
|
|
|
|
### Opening pull requests (the workflow that actually works)
|
|
|
|
|
|
|
|
|
|
Because no Gitea API token is available in this environment, the PR creation flow is:
|
|
|
|
|
|
|
|
|
|
1. Create a feature branch: `git checkout -b docs/<date>-<description>`
|
|
|
|
|
2. Commit the changes (no need to commit unrelated files — leave the worktree dirty but `git add` only what you intend to ship)
|
|
|
|
|
3. Push: `git push -u origin <branch>`
|
|
|
|
|
4. The Gitea push hook prints a "Create a new pull request" URL on stderr, e.g. `https://git.crispygoat.com/tyler/route-commerce/pulls/new/<branch>` — open that URL in a browser to file the PR through the web UI.
|
|
|
|
|
|
|
|
|
|
If a future environment provides a Gitea token, the `tea pr create` and `curl POST /api/v1/repos/tyler/route-commerce/pulls` flows become available; the auth pattern is `Authorization: token <TOKEN>` on the REST API or `tea logins add -t <TOKEN> -u https://git.crispygoat.com` for the CLI.
|
|
|
|
|
|
|
|
|
|
## Project Overview
|
|
|
|
|
|
|
|
|
|
Route Commerce is a multi-tenant B2B e-commerce platform for fresh produce wholesale distribution. Brands sell to customers who pick up at scheduled stops or receive shipments. The platform includes admin dashboards for order management, stop/route scheduling, product catalogs, payment processing (Stripe + Square), and a communications module ("Harvest Reach") for email/SMS campaigns.
|
|
|
|
|