v0.3.2 a514042

AGENTS.md RawHistoryFolder

Repository rules

  • Go 1.27 only. Normal builds/tests use CGO_ENABLED=0; race tests use CGO_ENABLED=1.
  • Lightweight hexagonal architecture: core imports only stdlib and ports; app wires adapters. Owner goroutines own state, no window-state mutex.
  • Reuse NeferWL dependency conventions: zerowrap with component on every entry, Mockery v3 testify generated mocks. No handwritten fakes/stubs/spies or swapped function fields.
  • Cross-layer seams live in internal/ports; generated mocks in internal/mocks/ports. Adapter-internal seams stay unexported with generated same-package test mocks. Add .mockery.yml entries and verify generation.
  • Signed conventional commits only; no remote/publication/installation or live lock/off/suspend/real credential attempt without authorization.
  • Credentials travel directly from visual process to the isolated authentication worker, never through policy daemon, render models, logs, argv or debug output.
  • Pure Go/purego PAM via purego-pam; no C helper or renderer fallback. Standard advertised Wayland protocols only: neferclient for surfaces and input, go-wayland-bindings for the control connection, NeferGUI Vulkan/DMA-BUF/explicit-sync rendering. Headless tests (NEFERAFK_HEADLESS) only, never a real session lock.
  • Flat key = value config with independent disableable lock/fade/output-off/suspend deadlines. Returning activity never unlocks.
source
1# Repository rules
2
3- Go 1.27 only. Normal builds/tests use CGO_ENABLED=0; race tests use CGO_ENABLED=1.
4- Lightweight hexagonal architecture: core imports only stdlib and ports; app wires adapters. Owner goroutines own state, no window-state mutex.
5- Reuse NeferWL dependency conventions: zerowrap with component on every entry, Mockery v3 testify generated mocks. No handwritten fakes/stubs/spies or swapped function fields.
6- Cross-layer seams live in internal/ports; generated mocks in internal/mocks/ports. Adapter-internal seams stay unexported with generated same-package test mocks. Add .mockery.yml entries and verify generation.
7- Signed conventional commits only; no remote/publication/installation or live lock/off/suspend/real credential attempt without authorization.
8- Credentials travel directly from visual process to the isolated authentication worker, never through policy daemon, render models, logs, argv or debug output.
9- Pure Go/purego PAM via purego-pam; no C helper or renderer fallback. Standard advertised Wayland protocols only: neferclient for surfaces and input, go-wayland-bindings for the control connection, NeferGUI Vulkan/DMA-BUF/explicit-sync rendering. Headless tests (NEFERAFK_HEADLESS) only, never a real session lock.
10- Flat key = value config with independent disableable lock/fade/output-off/suspend deadlines. Returning activity never unlocks.

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 2

Tags 9

↑↓ moveenter openesc close