jordan/rdev
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
13c7111a8b
rdev/docs/README.md
jordan c59d348040 chore: prepare for composable monorepo template implementation 
This commit captures the current state before implementing the composable
monorepo template system. Key changes included:

Infrastructure:
- Add CockroachDB provisioner adapter for database provisioning
- Add Redis provisioner adapter for cache provisioning
- Add build events system with PostgreSQL storage
- Add WebSocket endpoint for real-time build progress

Code agent improvements:
- Fix Claude Code adapter to use default allowed tools instead of dangerously-skip-permissions
- Add context-aware stream closing for cancellation support
- Improve parser tests for edge cases

Build system:
- Add build event constants and metrics
- Remove deprecated git_operations.go (replaced by pod_git_operations.go)
- Add rollback logic for multi-step provisioning operations

Documentation:
- Add composable-monorepo feature documentation
- Add DNS/Cloudflare service documentation
- Update deployment and troubleshooting guides

Cookbooks:
- Add fullstack-app cookbook
- Refactor landing-test with shared library

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 11:39:28 -07:00

2.9 KiB
Raw Blame History

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

Related

  • CLAUDE.md - Project root documentation (always in context)
  • ai-lookup/ - Quick fact lookups for Claude