Skip to content

docs: surface security features and test coverage in README#235

Merged
akuehner merged 1 commit into
mainfrom
docs/readme-security-tests
Jun 11, 2026
Merged

docs: surface security features and test coverage in README#235
akuehner merged 1 commit into
mainfrom
docs/readme-security-tests

Conversation

@akuehner

Copy link
Copy Markdown
Member

Summary

  • Add Security section after Architecture documenting five code-level properties: 30-day token TTL with upgrade migration, atomic rename-after-write with mode 0o600, append-only audit log, progressive lockout with per-IP and per-username tracking, and OS-level isolation in multi-user mode
  • Add Postinstall / systemd subsection under Install explaining the Linux systemd unit registration and how to skip with --ignore-scripts
  • Add Testing section listing the 12 test surface areas covered by the 26-file test suite

Documentation-only change. No code modified.

Test plan

  • npm test — 303 tests, 0 failures
  • All claims verified against source: lib/server-auth.js (TOKEN_TTL_MS, lockout), lib/store.js (atomic write, 0o600), lib/audit.js (append-only log), lib/os-users.js (OS isolation), scripts/postinstall.js (systemd), test/ (26 test files)

@akuehner akuehner merged commit db03860 into main Jun 11, 2026
1 check passed
@akuehner akuehner deleted the docs/readme-security-tests branch June 11, 2026 20:50
@clagentic-release-bot

Copy link
Copy Markdown

This issue has been resolved in version 1.5.0-beta.2 (beta).

To update, run:

npx @clagentic/console@1.5.0-beta.2

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant