scriptoriumadmin/fabro
1
0
Fork 0
mirror of https://github.com/fabro-sh/fabro.git synced 2026-10-17 04:37:03 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 5
fabro/CLAUDE.md
Bryan Helmkamp 46a110f1c0 Add CLAUDE.md instruction to use shlex::try_quote for shell quoting 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 09:59:59 -04:00

1.2 KiB
Raw Blame History

Arc

Dev servers

  1. arc serve — starts the Rust API server (demo mode is per-request via X-Arc-Demo: 1 header)
  2. cd apps/arc-web && bun run dev — starts the React dev server

API workflow

The OpenAPI spec at docs/api-reference/arc-api.yaml is the source of truth for the arc-api HTTP interface.

  1. Edit docs/api-reference/arc-api.yaml
  2. cargo build -p arc-types — build.rs regenerates Rust types via typify
  3. Write/update handler in crates/arc-api/src/server.rs, add route to build_router()
  4. cargo test -p arc-api — conformance test catches spec/router drift
  5. cd packages/arc-api-client && bun run generate — regenerates TypeScript Axios client

Shell quoting in sandbox code

When interpolating values into shell command strings (in arc-exe and arc-workflows), always use the shell_quote() helper (backed by shlex::try_quote). Never use manual replace('\'', "'\\''") or unquoted interpolation. This applies to file paths, branch names, URLs, env vars, image names, glob patterns, and any other user-controlled input assembled into a shell script.

Testing workflows

When manually testing workflows with arc run, use --no-retro to skip the retro step and finish faster.