Skip to content

Latest commit

 

History

History
37 lines (31 loc) · 1.42 KB

File metadata and controls

37 lines (31 loc) · 1.42 KB
title Safety
description Safety rules and constraints in clawpatch

Safety

Current safety rules:

  • review, status, report, doctor, and map --dry-run do not edit source files.
  • fix requires explicit --finding <id>.
  • fix refuses a dirty source worktree by default.
  • .clawpatch/ state changes are allowed during runs.
  • review and revalidate provider calls use a read-only sandbox for the codex provider. The claude provider restricts available tools to read/search tools for read-only operations. The acpx provider relies on acpx --approve-reads plus an explicit read-only prompt directive; underlying agents that bypass ACP permissions (e.g. agents running in their own full-access mode) may not be strictly sandboxed. See docs/providers.md.
  • provider output must pass runtime schema validation.
  • feature locks are stored in feature records and .clawpatch/locks/; status surfaces both. Claims automatically reclaim same-host locks whose process is dead, and clean-locks --stale-only applies the same conservative rule without clearing live local or remote locks.
  • the mapper skips symlinked directories and common generated directories.

Not implemented today:

  • automatic commits
  • automatic PRs
  • automatic landing
  • rollback snapshots
  • global process locks

Git safety remains the caller's responsibility after a fix. Inspect git diff and run project tests before committing.