Proof Portal

Project overview

Omarchy

ProbeLabsviewing a historical run

A proof layer — requirements, tests and verified fixes — for two of Omarchy's subsystems: the application menu (launcher scripts, QML model, JSONC config, search and selection) and the lock screen (lock scripts, QML, PAM authentication). Scope is deliberately limited to those components of omacom/omarchy; the rest of the distribution is not covered.

Viewing historical run e6a1a3eOct 2, 2026, 11:29 PMpr/9056Back to current
Back to findings
Known issueKI-LOCK-PAM-FLIP-ENGAGES-LOCK

Lock engages when password PAM disappears during the stabilize window; the stranded watchdog stands down

OpenOpenHigh

High-severity issue, currently open.

Description

The issue as recorded.

The missing-pam gate (lockIpc.lock, shell/plugins/lock/Service.qml:741-746) checks passwordPamConfigured once. BeginLock then schedules requestSessionLock through the 500ms stabilize delay, and requestSessionLock (87-99) re-checks only lockRequested/sessionLock state - never PAM. A FileView reload whose onLoadFailed lands inside that window (config removed / TTY-cleared failsafe) flips the flag after the gate. That happens before line 99 sets sessionLock.locked = true. onPasswordPamConfiguredChanged early-returns on the false transition, and checkStrandedLock explicitly stands down once the code sets lockRequested ('a lock this shell took is nobody's orphan'). So the session locks with no password PAM behind it and nothing releases it.

Affected requirements

The requirement(s) this issue violates — click through to the spec.

Severity, explained

Why this is rated the way it is — and the scoring signals behind the rating (each ⓘ explains the term).

HighRated severity — the impact if this issue is exploited or hit.
why this rating
Reproducer-confirmed
risk area
Correctness
Security classification
Not a security surface
CVE surface
None

Where it is

The code the issue lives in — peek the affected function inline to see it in context.

  • session lock lifecycle, missing-pam gate

How it's proven

The reproducer — an actual test that drives the real code and shows the issue happening. Run it yourself, or peek the test and the source it covers.

Known issue reproducedprofileknown_issue_reproducer
Reproducer test
Run it yourself
./pocs/lock-service-failopen-runtime.sh
Covers (2)
Last run Sep 30, 2026, 11:02 PM

Reproduction steps

Technical steps for your engineers to confirm the issue by hand.

./pocs/lock-service-failopen-runtime.sh

What protects you, and the fix

What limits your exposure today, and the planned remediation.

What protects you now

fingerprint PAM (if configured) can still unlock; TTY remains

The fix

Re-check passwordPamConfigured in requestSessionLock before sessionLock.locked = true and stand the lock back down (with the missing-pam notification) when it went false. Treat a PAM flip while lockRequested as a teardown trigger

Blast radius

If you touch this issue, what else may need re-checking — the requirements it affects and the code and tests that hang off them. Historical view: authored trace links only — automatically derived links aren't reconstructible for past runs.

Tracing blast radius…

Touch this finding and you re-check 6 requirements · 3 code files · 5 tests.

Code files (3)
  • Service.qml
  • omarchy-system-lock
  • LockView.qml
Tests (5)
  • lock-missing-pam-test.sh
  • system-lock-test.sh
  • lock-fingerprint-indicator-test.sh
  • lock-blank-fingerprint-test.sh
  • lock-password-overflow-test.sh

Per-requirement evidence

For each requirement this finding touches: the implementing code, verifying tests, and proof obligations that discharge it.

Implementing code (2)
  • shell/plugins/lock/Service.qml
    beginLock
  • shell/plugins/lock/Service.qml
    lock
Tests & evidence (1)
  • test/shell.d/lock-missing-pam-test.sh
Implementing code (51)
  • bin/omarchy-system-lock
  • shell/plugins/lock/LockView.qml
  • shell/plugins/lock/LockView.qml
    clearFailureRequested
  • shell/plugins/lock/LockView.qml
    forcePasswordFocus
  • shell/plugins/lock/LockView.qml
    onAccepted
  • shell/plugins/lock/LockView.qml
    onInputEnabledChanged
  • shell/plugins/lock/LockView.qml
    submitPassword
  • shell/plugins/lock/Service.qml
  • shell/plugins/lock/Service.qml
    Component.onCompleted
  • shell/plugins/lock/Service.qml
    applyMonitorDpms
  • shell/plugins/lock/Service.qml
    armBlankTimer
  • shell/plugins/lock/Service.qml
    finishUnlock
  • shell/plugins/lock/Service.qml
    handleFingerprintFinished
  • shell/plugins/lock/Service.qml
    handlePasswordFailure
  • shell/plugins/lock/Service.qml
    hasRealScreen
  • shell/plugins/lock/Service.qml
    logEvent
  • shell/plugins/lock/Service.qml
    onAuthenticatingPasswordChanged
  • shell/plugins/lock/Service.qml
    onClearFailureRequested
  • shell/plugins/lock/Service.qml
    onClicked
  • shell/plugins/lock/Service.qml
    onCompleted
  • shell/plugins/lock/Service.qml
    onError
  • shell/plugins/lock/Service.qml
    onExited
  • shell/plugins/lock/Service.qml
    onFileChanged
  • shell/plugins/lock/Service.qml
    onLoadFailed
  • shell/plugins/lock/Service.qml
    onLoaded
  • shell/plugins/lock/Service.qml
    onLockStateChanged
  • shell/plugins/lock/Service.qml
    onPamMessage
  • shell/plugins/lock/Service.qml
    onPasswordPamConfiguredChanged
  • shell/plugins/lock/Service.qml
    onPasswordTextEdited
  • shell/plugins/lock/Service.qml
    onResponseRequiredChanged
  • shell/plugins/lock/Service.qml
    onRunningChanged
  • shell/plugins/lock/Service.qml
    onScreensChanged
  • shell/plugins/lock/Service.qml
    onSecureStateChanged
  • shell/plugins/lock/Service.qml
    onStreamFinished
  • shell/plugins/lock/Service.qml
    onSubmitPassword
  • shell/plugins/lock/Service.qml
    onTriggered
  • shell/plugins/lock/Service.qml
    onWakeRequested
  • shell/plugins/lock/Service.qml
    queueSessionLock
  • shell/plugins/lock/Service.qml
    realScreenCount
  • shell/plugins/lock/Service.qml
    rearm
  • shell/plugins/lock/Service.qml
    refreshBackground
  • shell/plugins/lock/Service.qml
    refreshFingerprintStatus
  • shell/plugins/lock/Service.qml
    refreshPoster
  • shell/plugins/lock/Service.qml
    requestSessionLock
  • shell/plugins/lock/Service.qml
    resetAuthenticationState
  • shell/plugins/lock/Service.qml
    respondToPasswordPrompt
  • shell/plugins/lock/Service.qml
    runBlank
  • shell/plugins/lock/Service.qml
    runWake
  • shell/plugins/lock/Service.qml
    screenBlank
  • shell/plugins/lock/Service.qml
    startFingerprint
  • shell/plugins/lock/Service.qml
    submitPassword
Tests & evidence (1)
  • test/shell.d/system-lock-test.sh
Proof obligations (2)
error_handling

Behavior when operations fail or dependencies are unavailable.

  • ✓negative (required) — test/shell.d/system-lock-test.sh:83
  • ✓nominal (required) — test/shell.d/system-lock-test.sh:43
nominal

Happy-path behavior with valid inputs.

  • ✓nominal (required) — test/shell.d/system-lock-test.sh:44

Evidence trail

The raw evidence manifests behind this finding — superseded by the resolved reproducer above, kept here for traceability.

  • proof/evidence/ki-lock-pam-flip-engages-lock.yaml

Change history

Every recorded revision of this finding's source file — when it was added, edited, or re-classified, with the diff for each change.

Discussions

Discuss this with the proof team. Nothing changes in your audit automatically — you open a request and a staff member records any outcome inside the thread.

Sign in to discuss this with the proof team.Sign in