docs: add CLAUDE.md with codebase overview and development guide#3
Merged
Conversation
Provides AI assistants with project structure, build commands, architecture patterns, code conventions, and CI/CD details. https://claude.ai/code/session_01KzkmihiXtnU6koPk8jkfWH
Tests: - Add unit tests for parse_env_file, construct_url, get_base_url, get_access_token, build_table in helpers.rs - Add Serde deserialization tests for all models (StackList, EndpointList, TeamList, User, Stack) and enums - Add tempfile dev-dependency for test file handling Critical fixes: - Fix Dockerfile ENTRYPOINT path (/bin/wrpt -> /usr/bin/wrpt) - Propagate API errors in start/stop/remove handlers instead of silently ignoring them (let _ = ... -> ...?) Other fixes: - Fix parse_env_file: preserve # in values, add quoted value support - Add pub(crate) to all list model fields for consistency - Check Option before dereference in resource_control handler - Fix misleading variable name in get_access_token() https://claude.ai/code/session_01KzkmihiXtnU6koPk8jkfWH
Architecture improvements: - Introduce CliError enum for structured error propagation, replacing Result<T, ()> and log_expect() panics throughout - Introduce CliContext struct that holds a reusable HTTP client and resolved config (base_url), created once at startup - Add 30s timeout on HTTP client - Add resolve_stack() helper to deduplicate stack lookup logic across start/stop/remove/resource_control handlers - Warn when --insecure flag is used Cleanup: - Remove log_err dependency (no longer needed) - Remove all log_expect/unwrap calls in favor of ? operator - Simplify handler signatures: accept &CliContext instead of individual base_url/access_token/insecure params - Net reduction of ~190 lines of code Dockerfile hardening: - Pin Rust version to 1.83 - Pin docker-compose-bin to v2.32.4 - Add non-root user - Clean apt cache in all stages - Use --no-install-recommends - Remove unnecessary clippy/rustfmt from build stage https://claude.ai/code/session_01KzkmihiXtnU6koPk8jkfWH
… and CI/CD guides Add Installation section (cargo, Docker, from source), Quick Start guide, and CI/CD integration examples for GitHub Actions and GitLab CI. Update roadmap to mark Documentation and Testing as completed. Update CLAUDE.md to reflect CliContext/CliError architecture. https://claude.ai/code/session_01KzkmihiXtnU6koPk8jkfWH
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Provides AI assistants with project structure, build commands,
architecture patterns, code conventions, and CI/CD details.
https://claude.ai/code/session_01KzkmihiXtnU6koPk8jkfWH