leaseguard

Demo: một lần chạy thật

Kết quả thật từ README của leaseguard — một lease 3 giây, dùng một lần, rồi hết hạn (từ examples/demo.sh):

### 1. grant a 3-second lease for the deploy command
lease <id> granted
  pattern : echo deploy-*
  valid   : 3s (until <ts>)
  scope   : <tmpdir>
  note    : demo lease
token: <redacted>

run it with: leaseguard run --lease <token> -- echo deploy-<arg>

### 2. run it right away -> allowed
deploy-backend

### 3. run it again after the lease expired -> denied
leaseguard: denied: lease <id> expired at <ts> — ask for a fresh approval

### 4. audit: the stale approval died quietly, nothing ran on it
leaseguard audit
  leases : 1 total — 0 active, 0 revoked, 1 expired (used), 0 expired unused
  runs   : 1 allowed, 1 denied
  ledger : 3 entries, hash chain OK

  recent denials:
    [<ts>] lease-expired: echo deploy-backend

Kết quả được chép nguyên văn từ README của leaseguard.

Bài toán nó giải quyết

Bạn đã duyệt lệnh đó lúc 10:00. Bạn không hề duyệt lệnh đó lúc 10:40 — từ một thư mục khác, trên code đã thay đổi hai lần kể từ lúc bạn xem. Mỗi phê duyệt con người dành cho agent đều là một cái gật đầu không ngày hết hạn, không phạm vi, không biên lai. leaseguard ghi cả ba điều đó lại: mỗi phê duyệt trở thành một lease đã ký với giới hạn thời gian, phạm vi thư mục, và một bản ghi kiểm toán chuỗi băm.

Từ README của leaseguard (mục "The problem").

Cài đặt

3 bước. Không phụ thuộc. Node 18+.

git clone https://github.com/techdevfun/leaseguard.git
cd leaseguard
npm link   # hoặc: chmod +x leaseguard.js && ln -s $PWD/leaseguard.js ~/.local/bin/leaseguard

Kiểm tra xem đã chạy đúng chưa:

leaseguard help
npm test   # 21 tests, ~7 seconds

Các lệnh được chép nguyên văn từ README của leaseguard (mục "Install").

Cách dùng

Cấp một lease — pattern là một glob được khớp với toàn bộ chuỗi lệnh:

leaseguard grant "npm run deploy" --for 10m              # phạm vi mặc định: thư mục hiện tại
leaseguard grant "kubectl rollout restart *" --for 2m --scope ./infra --note "incident #7"
leaseguard grant "rm -rf ./dist" --for 30s

Thời lượng: 30s, 10m, 2h, 1d (mặc định 15m).

Chạy qua gate — lớp bao bọc dành cho agent. Mã thoát: 0 đã chạy (mã của chính lệnh được giữ nguyên), 2 bị từ chối (không có lease / không có allow trong policy), 3 lease hỏng hoặc hết hạn, 4 policy từ chối:

leaseguard run --lease $TOKEN -- npm run deploy
leaseguard run --lease-file ./lease.token -- npm run deploy   # tránh để token trong `ps`
LEASEGUARD_LEASE=$TOKEN leaseguard run -- npm run deploy      # hoặc qua biến môi trường

Lệnh chạy trực tiếp, không qua shell — chính xác argv đã duyệt mới được thực thi. Cần pipe? Chạy sh -c tường minh và để pattern khớp toàn bộ chuỗi sh -c "...".

Standing policy — các glob allow/deny luôn hiệu lực, không cần lease cho mấy việc nhàm chán. Deny luôn thắng:

{ "allow": ["npm test", "git status"], "deny": ["rm -rf *", "curl * | sh", "git push * --force"] }

leaseguard run --policy examples/policy.json -- npm test

Quản lý & kiểm toán:

leaseguard leases          # đang hiệu lực / hết hạn / bị thu hồi
leaseguard revoke 9f2c1a   # thu hồi lease ngay (khớp tiền tố ok; tiền tố mơ hồ bị từ chối chứ không đoán)
leaseguard audit           # tóm tắt + kiểm tra tính toàn vẹn của sổ cái
leaseguard audit --json    # dạng máy đọc

Mọi thứ nằm trong ~/.leaseguard/ (key, leases.json, ledger.jsonl); trỏ sang chỗ khác bằng LEASEGUARD_HOME.

Các lệnh và mã thoát được chép nguyên văn từ README của leaseguard (mục "Usage").

Giới hạn trung thực

• Nó không chặn được một kẻ tấn công quyết tâm đã có quyền file của bạn. Ai đọc được ~/.leaseguard/key đều có thể tự đúc lease. Hãy chạy phía cấp lease từ shell của bạn hoặc CI — không phải từ agent.
• Token trên dòng lệnh bị lộ trong ps; dùng --lease-file hoặc biến môi trường khi dùng thật.
• Nó chỉ kiểm tra cái gì đã được duyệt và khi nào — không phán xét lệnh đó có khôn ngoan hay không. Một lease cho rm -rf * vẫn là lỗi của bạn.

Các giới hạn được chép nguyên văn từ README của leaseguard (mục "What this does NOT do").

Lộ trình — chưa có

• Lease --approve-once (dùng một lần rồi tự thu hồi)
• leaseguard watch — theo dõi sổ cái trực tiếp trong một phiên agent
• Ví dụ hook phía agent, tùy chọn (Claude Code / Codex pre-tool hooks)

Lộ trình chép từ README của leaseguard; chưa mục nào được triển khai (2026-10-30).

Giấy phép

MIT — xem LICENSE trong repository.

Công cụ liên quan

Các công cụ mã nguồn mở khác của TECHDEV: sessguard, runverdict, gheist-guard, vetgate, context-diet, ci-failure-detective, agent-seatbelt, devsecops-os, env-doctor, skill-audit, logtrim, testguard, breakcheck, keymap, memgraph, ggufit, factfence, jsonfold

Đóng góp ý kiến

Bình chọn cho công cụ này, đề xuất tính năng, hoặc thảo luận với các vận hành khác trên bảng cộng đồng.