jordan/rdev
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
062a828a00
rdev/docs
History
jordan 592b2d5ec0 fix: clarify database types across docs and fix video storage persistence 
Two distinct fixes:

1. Database terminology: Make it crystal clear that generated projects use
   CockroachDB in production and PostgreSQL for local dev, while the rdev
   platform itself uses PostgreSQL. Updated 15 files across skeleton agents,
   component templates, cookbook trees, and platform docs.

2. Video storage: VideoHandler was ignoring vid.Data bytes (already downloaded
   by the Gemini adapter with auth) and re-downloading from the provider URL
   with a plain GET — which fails because Gemini URLs require API key auth.
   Now uses vid.Data first, falls back to downloadURL only for public URLs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 23:13:21 -07:00
..
aios-core feat(sessions): add command execution endpoint and activity tracking 2026-02-13 08:41:05 -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
citadel-integration.md feat: add GCS-based persistent media storage, AI generation pipeline, and composable skeleton packages 2026-02-19 21:29:09 -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: clarify database types across docs and fix video storage persistence 2026-02-19 23:13:21 -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

README.md

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