rdev/docs
jordan a9ad3d8304
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
chore: accumulated platform hardening and CI fixes
CI / Woodpecker:
- Add explicit depends_on to all .woodpecker.yml steps (rdev + templates)
- Fix skip_tls_verify -> skip-tls-verify (correct Kaniko flag name)
- Add replicasets get/list to deployer RBAC for rollout status
- Skeleton template: add failure:ignore on docs steps, Traefik TLS
  annotations on ingress, depends_on on verify step

Component templates:
- Fix container name in deploy steps (PROJECT_NAME-COMPONENT_NAME)
- Replace kubectl scale with kubectl patch for replicas
- Add post-deploy image verification and rollout status checks
- Applied consistently across all 5 component templates

Adapters:
- gitea: Add HTTP client timeout (30s), context cancellation checks,
  handle 404 on GetRepo/DeleteRepo
- zot: Add retry with exponential backoff (doWithRetry), limit response
  body reads to 10MB
- cockroach: Use net.JoinHostPort for IPv6-safe DSN construction
- woodpecker: Fix error wrapping (%v -> %w)
- redis: Fix error wrapping (%v -> %w)
- deployer: Add context cancellation checks

Services:
- apikey_service: Fix error wrapping (%v -> %w)
- component_deploy: Fix error wrapping (%v -> %w)
- project_infra: Fix error wrapping (%v -> %w)
- webhook/dispatcher: Fix error wrapping (%v -> %w)

Other:
- CLAUDE.md: Add guide links for Gitea, Go 1.25, Woodpecker v3,
  Traefik v3, Zot registry
- circuitbreaker: Add test for error wrapping
- docs: Update deployment, troubleshooting, and runbook docs
- health: Fix error wrapping (%v -> %w)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-10 23:16:56 -07:00
..
api chore: prepare for composable monorepo template implementation 2026-01-31 11:39:28 -07:00
architecture feat: Implement hexagonal architecture with services, webhooks, queue, and telemetry 2026-01-25 19:57:46 -07:00
features feat: add operations audit system and template improvements 2026-02-01 19:08:57 -07:00
guides/sdlc feat: add auth scopes, OpenAPI docs, SDLC guides, and code quality improvements 2026-02-02 13:55:50 -07:00
legal feat: add structured logging infrastructure and SDLC extensions 2026-02-04 22:56:04 -07:00
operations chore: accumulated platform hardening and CI fixes 2026-02-10 23:16:56 -07:00
plans feat: fix composable monorepo CI builds + health endpoint improvements 2026-02-03 18:46:51 -07:00
specs feat: complete template upgrade - chassis framework, UI library, auth, app-nextjs, OpenAPI, and cookbook 2026-02-02 00:46:51 -07:00
ui/ideation feat(foundary): implement complete backend for conversational project design 2026-02-09 00:50:46 -07:00
claude-config-api.md feat: Add claude-config API, security hardening, and testing infrastructure 2026-01-25 01:29:13 -07:00
media-handling-spec.md fix(templates): upgrade Go to 1.25 and fix Woodpecker syntax 2026-02-08 23:57:38 -07:00
README.md chore: prepare for composable monorepo template implementation 2026-01-31 11:39:28 -07:00
reference.md chore: prepare for composable monorepo template implementation 2026-01-31 11:39:28 -07:00
RELEASE_CHECKLIST.md docs: update build/deploy docs for Woodpecker CI 2026-02-05 23:54:00 -07:00

rdev Documentation

Documentation for the rdev remote development API.

Quick Start

Documentation Structure

docs/
├── reference.md              # Quick reference for operations
├── api/                      # API documentation
│   ├── README.md            # API overview
│   ├── authentication.md    # API key auth
│   ├── sse-examples.md      # SSE streaming
│   └── errors.md            # Error codes
├── architecture/             # System design
│   ├── README.md            # Architecture overview
│   ├── hexagonal.md         # Ports & adapters
│   ├── security.md          # Auth, sanitization
│   └── streaming.md         # SSE protocol
├── operations/               # Operational guides
│   ├── deployment.md        # K8s deployment
│   ├── monitoring.md        # Prometheus/Grafana
│   ├── troubleshooting.md   # Common issues
│   ├── database-connections.md  # CRDB/Redis/Postgres
│   └── runbooks/            # Incident runbooks
├── features/                 # Feature documentation
│   └── multi-provider.md    # Code agent providers
└── plans/                    # Planning documents

Developer Guides

For day-to-day development, see .claude/guides/:

Guide Description
local/setup.md Local development setup
local/testing.md Running tests
backend/go-guidelines.md Go coding standards
backend/hexagonal.md Hexagonal architecture
ops/credentials.md Credentials management
ops/deploying.md Deployment process

Key Resources

Database Connections

See operations/database-connections.md for:

  • CockroachDB SQL shell access
  • Redis CLI access
  • PostgreSQL access for rdev metadata

Credentials

Infrastructure credentials (Cloudflare, Gitea, Woodpecker) are stored in:

Service URLs

Service External URL
rdev API https://rdev.masq-ops.orchard9.ai
CockroachDB Console https://cockroachdb.threesix.ai
Gitea https://git.threesix.ai
Woodpecker CI https://ci.threesix.ai
  • CLAUDE.md - Project root documentation (always in context)
  • ai-lookup/ - Quick fact lookups for Claude