Module health 

Purpose: Detect structural health issues in ProjectAtlas indexes.

Structs

HealthFinding

Health finding emitted by ProjectAtlas.

ParseSeverityError

Error returned when a health severity string is unknown.

Enums

Severity

Health finding severity.

Constants

CATEGORY_DUPLICATE_PURPOSE

Health category for duplicated purpose text.

CATEGORY_MISSING_PURPOSE

Health category for paths without purpose metadata.

CATEGORY_PURPOSE_AGENT_REVIEW_REQUIRED

Health category for approved purposes that still need agent review.

CATEGORY_REPEATED_TEMPORARY_FOLDER

Health category for repeated temporary/generated-output folders.

CATEGORY_STALE_PURPOSE

Health category for legacy or explicitly flagged accepted-purpose records.

CATEGORY_SUGGESTED_PURPOSE_REVIEW

Health category for generated purpose suggestions awaiting review.

MESSAGE_MISSING_PURPOSE

Finding message for missing-purpose rows.

MESSAGE_PURPOSE_AGENT_REVIEW_REQUIRED

Finding message for purpose-agent-review-required rows.

MESSAGE_STALE_PURPOSE

Finding message for stale-purpose rows.

MESSAGE_SUGGESTED_PURPOSE_REVIEW

Finding message for suggested-purpose-review rows.

RECOMMENDATION_DUPLICATE_PURPOSE

Finding recommendation for duplicate-purpose rows.

RECOMMENDATION_MISSING_PURPOSE

Finding recommendation for missing-purpose rows.

RECOMMENDATION_MISSING_PURPOSE_QUEUE

Queue recommendation for missing-purpose rows.

RECOMMENDATION_PURPOSE_AGENT_REVIEW_REQUIRED

Finding recommendation for purpose-agent-review-required rows.

RECOMMENDATION_REPEATED_TEMPORARY_FOLDER

Finding recommendation for repeated-temporary-folder rows.

RECOMMENDATION_STALE_PURPOSE

Finding recommendation for stale-purpose rows.

RECOMMENDATION_SUGGESTED_PURPOSE_REVIEW

Finding recommendation for suggested-purpose-review rows.

RECOMMENDATION_SUGGESTED_PURPOSE_REVIEW_QUEUE

Queue recommendation for suggested-purpose-review rows.

STRUCTURAL_HEALTH_CATEGORIES

Structural categories that are not simple purpose lifecycle states.

TEMP_FOLDER_BUCKETS

Folder names treated as repeated temporary/generated-output buckets.

Functions

finding_id

Build a stable finding id from category and affected paths.

health_check

Run initial structural health checks.

unresolved_health_findings

Return findings that have not been marked resolved.