Expand description
Workspace layout paths (.malvin/ tree) and home-directory run logs.
Constants§
- MALVIN_
ADVICE_ REL - MALVIN_
CHECKS_ REL - MALVIN_
CONFIG_ REL - Workspace-local config (distinct from
malvin_home_config_path). - MALVIN_
DIR - MALVIN_
HOME_ CONFIG_ FILE - Global user config filename under
malvin_user_home_root. - MALVIN_
LOGS_ REL - Legacy repo-relative logs path (pre-relocation); retained for docs and migration tests.
- MALVIN_
SNAPSHOTS_ DIR ~/.malvin/snapshots/— session dotfile backups (checks, gitignore tree, workspace config, etc.).- MALVIN_
TEST_ ALLOW_ HOME_ CONFIG_ MUTATION - When set to
1duringcargo test, code may create/write/delete~/.malvin_home/config.toml. - MALVIN_
USER_ HOME_ DIR - Per-user malvin data root under
$HOME(logs, config, names, dotfile snapshots). - WORK_
DIR_ MANIFEST - Run-directory file recording the canonical workspace cwd for this run.
Functions§
- canonical_
work_ dir_ for_ logs - find_
malvin_ logs_ root - Returns the home logs bucket for
startwhen it already exists. - git_
worktree_ toplevel - Git repository root for
work_dir, whengit rev-parse --show-toplevelsucceeds. - is_
malvin_ workspace - legacy_
malvin_ checks_ path - Legacy cwd-relative checks path (pre git-root relocation).
- malvin_
acp_ spawn_ chamber_ dir .malvin/acp_spawn/chamber under the resolved layout dir.- malvin_
advice_ path - malvin_
checks_ path - Primary
.malvin/checkspath undermalvin_data_root(git) or~/.malvin/checks(non-git). - malvin_
config_ path ~/.malvin_home/config.toml(global user config;work_diris ignored).- malvin_
data_ root - Git worktree root when inside a repo, else
~/.malvin/(shared for non-git workspaces). - malvin_
home_ config_ path - malvin_
home_ logs_ root - malvin_
home_ snapshots_ root - malvin_
logs_ root ~/.malvin_home/logs/<hash>/for the canonical absolute path ofwork_dir.- malvin_
user_ home_ root ~/.malvin_home/.- read_
work_ dir_ manifest - Reads the workspace cwd recorded for a run, if present.
- remove_
legacy_ malvin_ checks_ file - Removes pre-migration root
.malvin_checksif present (no legacy fallback reads). - resolve_
malvin_ checks_ path - Primary checks file when present, else legacy cwd-relative file, else primary for create.
- snapshot_
category_ dir - workspace_
logs_ hash - Alphanumeric (hex) digest of the canonical absolute path of
work_dir. - write_
work_ dir_ manifest - Writes the canonical workspace path into a run directory manifest.