docs(gatekeeper): formalize operator token resolution model and calibrated 0.69 decision thresholds #2

Merged
clawdie merged 2 commits from docs/gatekeeper-token-and-thresholds into main 2026-09-23 12:57:41 +02:00
Owner

Summary

  1. Operator Authorization Token Model (§4):
    • Primary: Memory-only environment variable (CLAWDIE_OPERATOR_TOKEN), leaving zero filesystem trace.
    • Secondary (secure file fallback): Cross-platform non-world-readable runtime paths (Linux /run/user/<UID>/clawdie/operator.token on tmpfs, FreeBSD /var/run/clawdie/operator.token with mode 0700 and security.bsd.see_other_uids=0 isolation).
    • Strict prohibition against storing tokens in /tmp.
  2. Calibrated Decision Thresholds (§5):
    • Sets requires_operator_token >= 0.69 based on empirical 16-scenario clustering.
    • is_grounded < 0.30 hard block on hallucinations.
    • ssh_keys_in_sync < 0.30 redirect to keygen.
    • Offline fail-closed regex fallback.
  3. Hook Pattern Updates (§7): Updated snippets and renumbered sections.
## Summary 1. **Operator Authorization Token Model (§4)**: - Primary: Memory-only environment variable (`CLAWDIE_OPERATOR_TOKEN`), leaving zero filesystem trace. - Secondary (secure file fallback): Cross-platform non-world-readable runtime paths (Linux `/run/user/<UID>/clawdie/operator.token` on tmpfs, FreeBSD `/var/run/clawdie/operator.token` with mode `0700` and `security.bsd.see_other_uids=0` isolation). - Strict prohibition against storing tokens in `/tmp`. 2. **Calibrated Decision Thresholds (§5)**: - Sets `requires_operator_token >= 0.69` based on empirical 16-scenario clustering. - `is_grounded < 0.30` hard block on hallucinations. - `ssh_keys_in_sync < 0.30` redirect to keygen. - Offline fail-closed regex fallback. 3. **Hook Pattern Updates (§7)**: Updated snippets and renumbered sections.
docs(gatekeeper): add operator token resolution model and calibrated 0.69 decision thresholds
Some checks failed
CI / Check contributors (pull_request) Has been cancelled
CI / Check uv.lock (pull_request) Has been cancelled
CI / Check no committed infographics (pull_request) Has been cancelled
CI / package-lock.json diff (pull_request) Has been cancelled
CI / Lint Docker scripts (pull_request) Has been cancelled
CI / Build&Test Docker image (pull_request) Has been cancelled
CI / Supply-chain scan (pull_request) Has been cancelled
CI / Review label gate (pull_request) Has been cancelled
CI / CI review comment (live) (pull_request) Has been cancelled
CI / All required checks pass (pull_request) Has been cancelled
CI / CI timing report (pull_request) Has been cancelled
CI / Generate slices (pull_request) Has been cancelled
CI / save-durations (pull_request) Has been cancelled
CI / e2e (pull_request) Has been cancelled
CI / List npm workspaces (pull_request) Has been cancelled
CI / PowerShell installer tests (pull_request) Has been cancelled
CI / Playwright E2E (Linux) (pull_request) Has been cancelled
CI / docs-site-checks (pull_request) Has been cancelled
CI / check-common-ancestor (pull_request) Has been cancelled
CI / check-attribution (pull_request) Has been cancelled
CI / uv lock --check (pull_request) Has been cancelled
CI / check-no-committed-infographics (pull_request) Has been cancelled
CI / package-lock.json semantic diff (pull_request) Has been cancelled
CI / Lint Dockerfile (hadolint) (pull_request) Has been cancelled
CI / Lint docker/ shell scripts (shellcheck) (pull_request) Has been cancelled
CI / build (amd64, type=gha,scope=docker-amd64, type=gha,mode=max,scope=docker-amd64, linux/amd64, ubuntu-latest) (pull_request) Has been cancelled
CI / build (arm64, type=gha,scope=docker-arm64, type=gha,mode=max,scope=docker-arm64, linux/arm64, ubuntu-24.04-arm) (pull_request) Has been cancelled
CI / publish (amd64, type=gha,scope=docker-amd64, type=gha,mode=max,scope=docker-amd64, linux/amd64, ubuntu-latest) (pull_request) Has been cancelled
CI / publish (arm64, type=gha,scope=docker-arm64, type=gha,mode=max,scope=docker-arm64, linux/arm64, ubuntu-24.04-arm) (pull_request) Has been cancelled
CI / merge (pull_request) Has been cancelled
9a8a768e69
docs(gatekeeper): calibrate is_grounded and ssh_keys_in_sync thresholds to <= 0.33 based on empirical sweep
Some checks failed
CI / Installer tests (pull_request) Has been cancelled
CI / publish (amd64, type=gha,scope=docker-amd64, type=gha,mode=max,scope=docker-amd64, linux/amd64, ubuntu-latest) (pull_request) Has been cancelled
CI / publish (arm64, type=gha,scope=docker-arm64, type=gha,mode=max,scope=docker-arm64, linux/arm64, ubuntu-24.04-arm) (pull_request) Has been cancelled
CI / merge (pull_request) Has been cancelled
CI / Desktop E2E (pull_request) Has been cancelled
CI / Docs Site (pull_request) Has been cancelled
CI / Deny unrelated histories (pull_request) Has been cancelled
CI / Check contributors (pull_request) Has been cancelled
CI / Check no committed infographics (pull_request) Has been cancelled
CI / package-lock.json diff (pull_request) Has been cancelled
CI / Lint Docker scripts (pull_request) Has been cancelled
CI / Build&Test Docker image (pull_request) Has been cancelled
CI / Supply-chain scan (pull_request) Has been cancelled
CI / Review label gate (pull_request) Has been cancelled
CI / CI review comment (live) (pull_request) Has been cancelled
CI / check-no-committed-infographics (pull_request) Has been cancelled
CI / package-lock.json semantic diff (pull_request) Has been cancelled
CI / All required checks pass (pull_request) Has been cancelled
CI / CI timing report (pull_request) Has been cancelled
CI / Generate slices (pull_request) Has been cancelled
CI / save-durations (pull_request) Has been cancelled
CI / e2e (pull_request) Has been cancelled
CI / List npm workspaces (pull_request) Has been cancelled
CI / PowerShell installer tests (pull_request) Has been cancelled
CI / Playwright E2E (Linux) (pull_request) Has been cancelled
CI / docs-site-checks (pull_request) Has been cancelled
CI / Lint Dockerfile (hadolint) (pull_request) Has been cancelled
CI / Lint docker/ shell scripts (shellcheck) (pull_request) Has been cancelled
CI / build (amd64, type=gha,scope=docker-amd64, type=gha,mode=max,scope=docker-amd64, linux/amd64, ubuntu-latest) (pull_request) Has been cancelled
CI / build (arm64, type=gha,scope=docker-arm64, type=gha,mode=max,scope=docker-arm64, linux/arm64, ubuntu-24.04-arm) (pull_request) Has been cancelled
ac78af2c4f
clawdie deleted branch docs/gatekeeper-token-and-thresholds 2026-09-23 12:57:41 +02:00
clawdie referenced this pull request from a commit 2026-10-20 12:29:48 +02:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
clawdie/hermes-bsd!2
No description provided.