Org Web Adapter

Editing hungryroot/jira/be_6896_update_and_improve_dev_setup_wiki.org

:PROPERTIES:
:ID:       2430bc9d-e04e-4e55-a845-7b5b6a8affa4
:END:
#+title: BE-6896 Update and improve dev setup wiki

- source :: https://hungryroot.atlassian.net/browse/BE-6896
- tags ::  [[id:3a477c02-e26d-40f7-a719-0aa1cd169dd8][Hungryroot API Project]] 
- epic :: [[id:86327fb4-0f66-4bc6-9068-c414cea77042][EP-411 Eng Parking Lot]]
- sprint :: [[id:2d34c333-e997-4a5b-9e83-2218d1b76940][HR BE Sprint 101]]
- status ::  [[id:4d41d978-e56f-45c1-88d1-e2c76510972e][Status - Complete]]

* Tasks
** DONE Add improvements to justfile :work:hungryroot:ep411:sprint101:justfile:be6896:chore:
:PROPERTIES:
:ID:       70e03d22-44c3-9375-f7e2-b53bf1df0ba4
:END:

- Note taken on [2026-01-08 Thu 11:50]

This has gotten a little out of hand. I'm basically constantly re-running `just setup` and seeing how ergonomic it feels and updating things to work more smoothly with all the various edge cases. This includes:

- Fix bug in cache-secrets missing `local` dir
  - Adding linux support (via homebrew on linux)
  - Guarding against missing AWS profiles
  - Adding a `preflight` wrapper for the initial-setup.sh script
    
** DONE Talk with Stephen about revamping the current onboarding guide in confluence :be6896:ep411:work:admin:docs:hungryroot:sprint101:chore:
:PROPERTIES:
:ID:       7b2ac7fa-d79c-1435-8f2a-40630f717f08
:END:
** DONE Push up fix for justfile for creating local dir :work:chore:justfile:hungryroot:sprint101:be6896:ep411:
:PROPERTIES:
:ID:       772d489c-f384-5eee-71d2-5f73fb52efeb
:END:

- Note taken on [2026-01-09 Fri 10:20]

Few things still to iron out. Mostly discrpancies on macOS where Docker.app
  was installed, shimmed out ~/.docker/cli-plugins and then was removed, those
  shims will be broken.

Basically, we need to validate that `docker compose` returns a valid response,
  we should be fine to bootstrap. But if it errors out, we want to lookup the
  valid path to the `docker-compose` binary, wherever it happens to be, and make
  sure it's symlinked to ~/.docker/cli-plugins/docker-compose
  
- Note taken on [2026-01-08 Thu 21:48]

Still working on getting things totally working on Linux. The upshot is that most of the setup now consists of:

1. Install brew via brew.sh
  2. `brew install just`
  3. Setup SSH key access to Github
  4. Clone hungryroot repository
  5. `just preflight`
  6. Re-open your terminal
  7. `just setup`
  8. `just docker-run`
  9. `just migrate`
  10. `just django`