Commit Graph

19 Commits

Author SHA1 Message Date
63850fd47a Update URLs to terraphim org 2026-02-21 21:18:45 +00:00
9608d4cb4f Add agent coordination documentation for Gitea workflow 2026-02-21 19:35:08 +00:00
961e54a902 security: redact credentials and remove corporate hostname/vault references
- README: replace zesticai-non-prod vault name and bigbox hostname with
  generic placeholders; replace hardcoded Tailscale IP with descriptive text
- deploy-to-bigbox.sh: make BIGBOX and TAILSCALE_IP configurable via env
  vars (auto-detect via tailscale ip -4); replace op_zesticai_non_prod.sh
  with op_credentials.sh
- Caddyfile: remove bigbox hostname from comment
- RESEARCH doc: remove hardcoded S3 access key and secret key values from
  the secrets table; replace with generic op:// reference format
- docker-compose_kitchen_sink.yml: replace hardcoded S3 credentials with
  CHANGE_ME placeholders

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-18 19:56:32 +01:00
dfaf019916 docs: Update handover with session 4 and 1Password SA lessons
- Document service account read-only limitation
- Add session 4 log (1Password token update, task tracking)
- Track expired token fix in cto-executive-system#8

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 15:50:02 +01:00
1c8ab5939e refactor: Replace GitHub Actions mirroring with Gitea native pull mirror
- Remove sync-to-gitea.yml and mirror-check.yml GitHub Actions workflows
- Set up Gitea as pull mirror from GitHub (1h interval, via POST /repos/migrate)
- Rewrite MIRRORING-GUIDE.md with pull mirror setup and gotchas
- Update HANDOVER.md and lessons-learned.md with new approach

Gitea now automatically pulls from GitHub. No Actions, no dual-push,
no billing dependency. Push to GitHub only; Gitea syncs within 1 hour.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 15:24:37 +01:00
a98941d74d docs: Update handover with articles, publishing, and new lessons learned
Session 2 additions: two comparison articles written, repo published to
both GitHub and Gitea, GitHub Actions billing issue documented.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 15:08:47 +01:00
2b5ab840f7 docs: Add articles comparing beads/br/agent-mail with Gitea replacement
Two complementary articles:
- ARTICLE-agent-task-management.md: CTO voice, ~2800 words, narrative style
- ARTICLE-agent-task-consolidation.md: Technical reference, ~6000 words, full configs

Both cover: beads (Go) vs br (Rust) vs Agent Mail vs Gitea with 12 labels,
1Password integration, SeaweedFS S3 storage, Docker Compose deployment,
and the three API gotchas (label swap, assignees, dependencies).
All commands verified against live Gitea 1.22.6.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 14:11:21 +01:00
de9f6bc3ff docs: Update handover and add lessons learned
- Update HANDOVER.md with AI agent skill section, API gotchas, session log
- Add lessons-learned.md with Gitea API findings and debugging insights

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 14:01:38 +01:00
1637782273 chore: Fix trailing whitespace across project files
Automated fix from pre-commit hooks (trailing-whitespace, end-of-file-fixer).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 12:45:32 +01:00
654e03dc71 feat(gitea-skill): Add integration tests and fix workflow label swap
- Add test-gitea-skill.sh with 10 tests (26 assertions) against live Gitea
- Fix: API POST /labels only appends, does not enforce scoped exclusivity
- Fix: Use PUT with label swap pattern to atomically replace workflow labels
- Fix: Use PATCH /issues/{index} for assignees (POST /assignees not in 1.22.6)
- All 26 assertions pass against live Gitea 1.22.6

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 12:45:18 +01:00
c6d425be63 feat(gitea-skill): Rewrite Gitea agent skill with verified API patterns
Rewrites SKILL.md with patterns verified against live Gitea 1.22.6:
- Milestones as project containers (project board API does not exist)
- Scoped workflow labels with mutual exclusivity
- Issue dependencies using IssueMeta format
- 1Password token retrieval via op read
- Default repo terraphim/agent-tasks with env var overrides

Adds setup-labels.sh for idempotent repo and label creation.
Includes research and design documents from disciplined development.
Adds pre-commit config adapted for infrastructure project.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 12:41:19 +01:00
Alex
776b8a618e Add Gitea skill for AI agents
This skill enables AI agents to interact with the Gitea instance at
git.terraphim.cloud for administrative and automation tasks.

Features:
- User management via admin CLI and API
- Organization CRUD operations
- Repository creation, deletion, and management
- Issue tracking: create, update, close, add labels/comments
- Pull request operations: list, get, merge
- Project board management
- Label and release management

Usage:
- REST API for most operations (preferred for automation)
- Admin CLI for user creation (requires container access)
- Includes helper bash functions for common operations

The skill follows the same structure as other opencode skills and
can be loaded using the skill tool for gitea-related tasks.
2026-02-17 09:13:44 +00:00
Alex
2e73ca794f Add handover document 2026-02-16 21:07:43 +00:00
Alex
e999ed9a4e Add S3 storage config for attachments, pictures, and LFS 2026-02-16 21:05:24 +00:00
Alex
d2c28a91e6 fix: Update S3 config and add Gitea URL settings
- Change MINIO_ENDPOINT from IP to Docker hostname (s3storage)
- Add ROOT_URL and DOMAIN settings for proper Gitea configuration
- Give anonymous users Admin permission for bucket creation
- Document SeaweedFS bucket creation process
2026-02-16 20:33:21 +00:00
Alex
b9e307bcc8 fix: Remove user directive from compose template
The user: "1000:1000" directive was causing permission issues
with the s6-svscan service. Gitea runs fine without it.
2026-02-16 20:14:22 +00:00
Alex
708adecc16 docs: Add repository mirroring guide and GitHub Actions
- Complete mirroring guide (GitHub ↔ Gitea)
- GitHub Actions workflow to sync to Gitea
- Mirror status check workflow
- SSH and token authentication methods
- Troubleshooting guide
2026-02-16 19:44:25 +00:00
Alex
4a4a0351aa feat: Gitea deployment with 1Password and Caddy
Complete infrastructure deployment including:
- Docker Compose templates with 1Password integration (op://)
- Caddy reverse proxy configuration for git.terraphim.cloud
- Automated deployment script (deploy-to-bigbox.sh)
- Comprehensive documentation and deployment article
- Network isolation: Public (Gitea) + Tailscale (Prometheus/S3)
- Security: No hardcoded secrets, all via 1Password

Services deployed:
- Gitea 1.22.6 (Git hosting)
- PostgreSQL 15 (Database)
- SeaweedFS (S3-compatible storage)
- Prometheus (Monitoring)

Excludes:
- docker-compose.yml (contains resolved secrets)
- s3_config.json (contains resolved secrets)
- Data directories (gitea/, postgres/, seaweedfs/)

Refs: Private deployment on bigbox with TerraphimPlatform vault
2026-02-16 19:40:19 +00:00
850d8b7680 First version 2024-12-10 13:54:13 +00:00