claudewheel v0.24.2 /claudewheel.state
Updated Edit
On this page

State persistence for claudewheel.

#claudewheel.state

#claudewheel.state

Persist launch state (selections, counts, recent dirs) and project inodes.

#project_key

python
def project_key(directory: str) -> str

Return the canonical per-project state key for directory.

This is THE rule for keying per-project state: the symlink-resolved (os.path.realpath) absolute path. A symlink and its target, and a relative path and its absolute form, all map to the same key so per-project state is never split across aliases of the same directory.

#_get_project_value

python
def _get_project_value(sf: 'StateFile', top_key: str, directory: str, default: Any=None) -> Any

Read a per-project sub-value from the top_key mapping in state.json.

#_set_project_value

python
def _set_project_value(sf: 'StateFile', top_key: str, directory: str, value: Any) -> None

Write a per-project sub-value under top_key, via set_value (single-key, multi-session-safe read-modify-write of the top-level key).

#get_project_hook_approvals

python
def get_project_hook_approvals(sf: 'StateFile', directory: str, default: Any=None) -> Any

Read the hook-approval record for directory (canonical key).

#set_project_hook_approvals

python
def set_project_hook_approvals(sf: 'StateFile', directory: str, value: Any) -> None

Persist the hook-approval record for directory (canonical key).

#get_vanilla_guardrails_opt_in

python
def get_vanilla_guardrails_opt_in(sf: 'StateFile', default: Any=None) -> Any

Read the machine-global vanilla-guardrails opt-in tri-state from state.

A leftover per-project dict value (from the old, superseded per-project shape) is not a valid answer -- it reads as unset (default).

#set_vanilla_guardrails_opt_in

python
def set_vanilla_guardrails_opt_in(sf: 'StateFile', value: Any) -> None

Persist the machine-global vanilla-guardrails opt-in tri-state to state.

#get_scratchpad_snooze_until

python
def get_scratchpad_snooze_until(sf: 'StateFile', default: Any=None) -> Any

Read the scratchpad-cleanup snooze deadline (ISO-8601 string) from state.

#set_scratchpad_snooze_until

python
def set_scratchpad_snooze_until(sf: 'StateFile', value: str) -> None

Persist the scratchpad-cleanup snooze deadline (ISO-8601 string).

#save_launch_state

python
def save_launch_state(cfg: 'AppConfigStore', selections: dict[str, str | None]) -> None

Save current selections to state.json before launch.

#record_inode

python
def record_inode(shared: 'SharedStore', directory: str) -> None

Record the inode of a project directory for rename detection.

Search