Module project_state 

Admission and publication of automatic project-owned initialization files.

Modules

linux_access 🔒

Handle-bound Linux access policy and unnamed replacement preparation.

Structs

ProjectStateGuard 🔒

Retain the admitted root and existing state-directory objects during writes.

PublicationFailure 🔒

Keep a failed publication step and its native I/O cause together.

RetainedStaging 🔒

Preserve the operation and failed cleanup precondition without an unsafe unlink.

Enums

FilePublication 🔒

Whether publication creates defaults or replaces an owned generated document.

ProjectDocument 🔒

Fixed project destinations whose implicit writers must not follow aliases.

StateAdmission 🔒

Keep database admission independent of optional generated host documents.

Constants

CONFIG_FILE 🔒

Default config whose creation remains an automatic project output.

DATABASE_FILE 🔒

Automatic SQLite filename whose aliases must be checked before opening SQLite.

GITIGNORE_FILE 🔒

Git’s fixed root-level exclusion document.

HOST_FILES 🔒

Automatically generated host outputs, all preflighted before identity changes.

JSON_MAP_FILE 🔒

Optional sidecar next to the default legacy map import location.

LEGACY_CONFIG_FILE 🔒

Legacy root configuration selected by the existing discovery fallback.

NONSOURCE_FILE 🔒

Default nonsource metadata created by every ordinary initializer.

STATE_DIRECTORY 🔒

Product-owned directory, independent of explicitly selected external storage.

WAL_SIDECAR_SUFFIXES 🔒

The two sidecars opened by the supported SQLite WAL profile.

Functions

containing_directory 🔒

Select a path’s lookup directory without treating an empty parent as root.

direct_directory_spelling 🔒

Compare a fixed directory without following its final namespace component.

fixed_name_candidate 🔒

Select a possible fixed name without probing an unrelated filesystem.

hfs_managed_name_matches 🔒

Match the fixed ASCII product alphabet under HFS’s frozen comparison rules.

indirect 🔒

Reject symbolic links and Windows junction/reparse entries.

link_count 🔒

Return the platform’s hard-link count before any automatic SQLite open.

named 🔒

Match fixed components using the supported platform’s case behavior.

optional_metadata 🔒

Inspect a direct entry, preserving real I/O errors and dangling aliases.

owned_named_path 🔒

Recognize a managed entry without treating unresolved ownership as external.

publication_failure 🔒

Add causal operation context without changing the I/O failure category.

refusal 🔒

Keep the owning path and actual refusal cause in the filesystem error chain.

require_directory 🔒

Admit a direct directory, matching the existing project-state contract.

require_regular 🔒

Admit a regular non-indirect output entry.

require_regular_or_absent 🔒

Admit a fresh output or its existing regular entry before publication.

resolve_existing_parent_prefix 🔒

Resolve actual existing ancestors before reducing only an unresolved suffix.

resolved_logical_directory_reduction 🔒

Keep a reduction through the logical namespace owned even if it is aliased.

same_direct_directory 🔒

Prove only existing direct directory aliases; file hardlinks do not imply naming rules.

state_directory_spelling 🔒

Recognize the private directory before interpreting a relative config root.

unicode_name_matches 🔒

Compare ASCII product names using APFS’s Unicode 9 full, non-Turkic fold.