clojure-namespace-architect

What problem does it solve?

Resolves Clojure namespace-path mismatches and classpath errors by providing a single source of truth for mapping kebab-case namespaces to snake_case file paths, reducing load-time failures.

Core Features & Use Cases

• Enforces the Dash-Underscore Convention: namespaces use dashes while file paths use underscores; prevents misalignment between code and structure.
• Enforces the Source Root Rule: roots like src, test, and resources are not part of the namespace, preventing incorrect ns declarations.
• Segment Mapping: each namespace segment maps to a directory level, with nested namespaces reflected in the directory structure.
• Diagnostic Tools: includes an audit_clojure_ns utility to verify declared namespaces against file paths and suggest fixes.
• Use Case: refactoring or creating Clojure files, diagnosing and correcting namespace declarations to match filesystem layout.

Quick Start

Run audit_clojure_ns on a Clojure source file to verify namespace-path alignment and apply the recommended fix.