Salt-lamp meeting reminder — v1 spec, STPA safety analysis, and atopile hardware board

.gitignore

@@ -41,3 +41,9 @@ venv/
 
 # IDEs
 .vscode/
+
+# SDD scratch (superpowers task reports, briefs, review diffs, progress)
+.superpowers/
+
+# Research artifact (not part of the design source)
+board.json

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "python.defaultInterpreterPath": "/home/lars_erhardt/.local/share/uv/tools/atopile/bin/python"
+}

LICENSE.j2 → LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 {{ author | default("ORIGINAL AUTHOR", true) }}
+Copyright (c) 2024 Lars Erhardt
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

README.md

@@ -1,3 +1,10 @@
-# atopile project template
+# ground
 
-Don't fork this repository to setup your atopile project - it contains jinja templates anyways. Instead, use `ato create`, which will setup the project for you. Project setup instructions are here: https://atopile.io/
+Wooohooo a new package!
+
+## Build
+
+`ato build` is self-contained on a fresh clone (all parts + the `generics/`
+dependency are vendored). See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for the
+`easyeda2kicad` CloudFront/User-Agent workaround needed when installing **new**
+parts via `ato install --jlcpcb <id>`.

ato.yaml

@@ -0,0 +1,9 @@
+requires-atopile: "^0.15.0"
+
+paths:
+  src: elec/src
+  layout: elec/layout
+
+builds:
+  default:
+    entry: elec/src/ground.ato:SaltLamp

docs/DEVELOPMENT.md

@@ -0,0 +1,47 @@
+# Development & Setup Notes
+
+## Building the board (self-contained)
+
+`ato build` is **fully self-contained** on a fresh clone. All JLCPCB parts and the
+`generics/` dependency are vendored/committed under `elec/src/` (including
+`elec/src/generics/`), so no network access or extra tooling is required:
+
+```sh
+ato build        # default + ci configs; must finish with zero ERC errors
+```
+
+## Installing NEW parts (`ato install --jlcpcb <id>`) — known workaround
+
+> This only matters when adding **new** components in the future. The committed
+> design does not need it to build.
+
+atopile uses `easyeda2kicad` to pull footprints/symbols from EasyEDA/LCSC. On a
+clean machine this currently **fails** for two reasons:
+
+1. **CloudFront 403** — `easyeda.com`'s WAF blocks the default
+   `easyeda2kicad vX.Y.Z` User-Agent, returning HTTP 403.
+2. **`lceda.cn` fallback** — some older LCSC IDs are IP-rate-limited on
+   `easyeda.com` and must be fetched from `lceda.cn` instead.
+
+### Workaround
+
+Add a `sitecustomize.py` to the atopile venv's `site-packages` that monkey-patches
+`easyeda2kicad.easyeda.easyeda_api.EasyedaApi` to (a) send a browser User-Agent and
+(b) fall back to `lceda.cn` on an empty/403 response. The venv lives at:
+
+```
+$(dirname $(dirname $(readlink -f $(which ato))))/lib/python3.11/site-packages/sitecustomize.py
+```
+
+(e.g. `~/.local/share/uv/tools/atopile/lib/python3.11/site-packages/sitecustomize.py`
+for a `uv`-installed atopile.)
+
+The patch sets:
+
+- `User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36`
+- Fallback URL: `https://lceda.cn/api/products/{lcsc_id}/components?version=6.4.19.5`
+
+This file is **machine-local and intentionally NOT committed** (it patches the
+venv, not the repo). Re-add it after recreating the atopile venv. Upstream
+`easyeda2kicad` may fix the User-Agent issue in a future release, making the patch
+unnecessary.