rdev/docs
jordan adcea2fc1f
Some checks failed
ci/woodpecker/push/woodpecker Pipeline failed
fix(templates): upgrade Go to 1.25 and fix Woodpecker syntax
## Template Version Alignment
- Go: 1.23 → 1.25 across all templates (go.work, go.mod, Dockerfiles, CI)
- Alpine: latest → 3.19 (explicit version pinning)
- Woodpecker: failure:retry → failure:ignore (invalid syntax fix)

## SDLC Tree Fixes (slackpath-5-full-lifecycle)
Fixed merge failures by correcting lifecycle flow:

1. **Branch Creation**: Added missing create-branch step (planned → ready)
   - Bug: Merge command requires feature.Branch field to be set
   - Fix: POST /projects/{id}/sdlc/features/{slug}/branch

2. **Artifact Status**: Changed approval to pass for execution artifacts
   - Bug: Review/audit/QA need status="passed" not "approved"
   - Fix: /artifacts/{type}/approve → /artifacts/{type}/pass
   - Added: pass-qa step after wait-qa

3. **Phase Transition Order**: Reordered merge phase transition
   - Bug: Merge command checks if phase == "merge" first
   - Fix: transition-to-merge BEFORE merge-feature (not after)

## GCS Provisioner Fix
- Replaced deprecated option.WithCredentialsFile with env var approach
- Now uses GOOGLE_APPLICATION_CREDENTIALS for ADC (Application Default Credentials)
- Avoids security risk from deprecated credential options
- Fixed test: Added ComponentTypeGCS to ValidComponentTypes test

## Critical Rules Added
- Version alignment: All template versions must stay in sync
- When updating versions, grep entire templates/ tree

## Files Changed
- 27 template files: Go version + Woodpecker syntax
- 1 tree file: SDLC lifecycle flow corrections
- 1 CLAUDE.md: Version alignment rule
- 1 GCS provisioner: Deprecated API fix
- 1 test file: Added missing component type

Root cause: Skeleton templates lagged behind Go 1.25 release and had
invalid Woodpecker syntax. SDLC tree skipped required branch creation
and used wrong artifact approval endpoints.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-08 23:57:38 -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: prepare for composable monorepo template implementation 2026-01-31 11:39:28 -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 fix: skip root deployment for empty template (defaults to skeleton) 2026-02-07 19:32:19 -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