Loading go_port/AGENTS.md +30 −0 Original line number Diff line number Diff line Loading @@ -35,6 +35,14 @@ Maintain the Go port as a CLI-compatible implementation of the Python `climax` a - Avoid regressions where freeze shutdown targets default `8080/8081` instead of runtime ports. - Freeze should tolerate missing linked resources (4xx during crawl) without failing the whole command. ## Download Behavior - `cachedDownload` has two modes: - cache hit: silent copy from cache - cache miss: real network download - On cache miss, show network activity feedback (spinner/progress) on interactive terminals. - Keep non-interactive output clean (no noisy progress output when not on a TTY). ## Storage and Project Registry - Use JSON storage in `~/.climax/projects.json`. Loading Loading @@ -65,6 +73,28 @@ Maintain the Go port as a CLI-compatible implementation of the Python `climax` a - `make build` (linux/amd64, darwin/arm64, windows/amd64) - `make installer-windows` (NSIS) - `make installer-macos` (unsigned `pkgbuild` package) - `make installer-deb` (Debian `.deb`, requires `dpkg-deb`) ## Java Runtime Notes - After extracting bundled JDK archives, ensure the resolved `java` binary is executable on Unix/macOS. - Do not change behavior for Windows (`.exe` path remains unchanged). ## Windows Installer Notes - `packaging/windows-installer.nsi` uses `StrFunc.nsh`. - For this NSIS toolchain, `StrFunc` must be enabled with: - `${Using:StrFunc} StrRep` - `${Using:StrFunc} UnStrRep` - Do not use `!insertmacro StrStr` or `!insertmacro StrRep` in this script. - NSIS warnings `6040`/`6001` seen during build are currently non-fatal and do not block installer creation. ## Debian Packaging Notes - Debian packaging is built from the linux/amd64 binary and assembled with `dpkg-deb`. - Output naming convention: - `dist/climax_<version>_amd64.deb` - If `dpkg-deb` is missing on macOS, install Debian tooling (`brew install dpkg`) or build in a Debian container. ## Dependency Policy Loading Loading
go_port/AGENTS.md +30 −0 Original line number Diff line number Diff line Loading @@ -35,6 +35,14 @@ Maintain the Go port as a CLI-compatible implementation of the Python `climax` a - Avoid regressions where freeze shutdown targets default `8080/8081` instead of runtime ports. - Freeze should tolerate missing linked resources (4xx during crawl) without failing the whole command. ## Download Behavior - `cachedDownload` has two modes: - cache hit: silent copy from cache - cache miss: real network download - On cache miss, show network activity feedback (spinner/progress) on interactive terminals. - Keep non-interactive output clean (no noisy progress output when not on a TTY). ## Storage and Project Registry - Use JSON storage in `~/.climax/projects.json`. Loading Loading @@ -65,6 +73,28 @@ Maintain the Go port as a CLI-compatible implementation of the Python `climax` a - `make build` (linux/amd64, darwin/arm64, windows/amd64) - `make installer-windows` (NSIS) - `make installer-macos` (unsigned `pkgbuild` package) - `make installer-deb` (Debian `.deb`, requires `dpkg-deb`) ## Java Runtime Notes - After extracting bundled JDK archives, ensure the resolved `java` binary is executable on Unix/macOS. - Do not change behavior for Windows (`.exe` path remains unchanged). ## Windows Installer Notes - `packaging/windows-installer.nsi` uses `StrFunc.nsh`. - For this NSIS toolchain, `StrFunc` must be enabled with: - `${Using:StrFunc} StrRep` - `${Using:StrFunc} UnStrRep` - Do not use `!insertmacro StrStr` or `!insertmacro StrRep` in this script. - NSIS warnings `6040`/`6001` seen during build are currently non-fatal and do not block installer creation. ## Debian Packaging Notes - Debian packaging is built from the linux/amd64 binary and assembled with `dpkg-deb`. - Output naming convention: - `dist/climax_<version>_amd64.deb` - If `dpkg-deb` is missing on macOS, install Debian tooling (`brew install dpkg`) or build in a Debian container. ## Dependency Policy Loading
