{
  "module": "tools",
  "version": "1.0.0",
  "description": "Executable generators, validators, auditors, guardians, and schema enforcers for TriadicFrameworks. This module contains the full canon‑maintenance toolchain.",
  "ai": {
    "module_kind": "engine_cluster",
    "substrate": "operator",
    "coherence": "declared",
    "drift": "bounded"
  },

  "files": [
    {
      "path": "README.md",
      "role": "index",
      "analyzer_layer": "coherence",
      "purpose": "Overview of the TriadicFrameworks toolchain; describes generators, validators, auditors, guardians, and schema enforcers."
    },

    /* ------------------------------ DRIFT & PURITY ------------------------------ */

    {
      "path": "auto_fix_drift.py",
      "role": "engine",
      "analyzer_layer": "drift",
      "purpose": "Automatic drift repair engine; resolves drift signatures across modules."
    },
    {
      "path": "auto_fix_drift.py.md",
      "role": "reference",
      "analyzer_layer": "drift",
      "purpose": "Documentation for auto drift repair engine."
    },

    {
      "path": "drift_guardian.py",
      "role": "engine",
      "analyzer_layer": "drift",
      "purpose": "Guardian engine for drift detection and containment."
    },
    {
      "path": "drift_guardian.py.md",
      "role": "reference",
      "analyzer_layer": "drift",
      "purpose": "Documentation for drift guardian engine."
    },

    {
      "path": "validate_drift_severity.py",
      "role": "diagnostic",
      "analyzer_layer": "drift",
      "purpose": "Diagnostic tool for drift severity scoring."
    },
    {
      "path": "validate_drift_severity.py.md",
      "role": "reference",
      "analyzer_layer": "drift",
      "purpose": "Documentation for drift severity validator."
    },

    /* ------------------------------ CANON PURITY ------------------------------ */

    {
      "path": "validate_canon_purity.py",
      "role": "diagnostic",
      "analyzer_layer": "regime",
      "purpose": "Purity validator for canon‑wide structural coherence."
    },
    {
      "path": "validate_canon_purity.py.md",
      "role": "reference",
      "analyzer_layer": "regime",
      "purpose": "Documentation for canon purity validator."
    },

    {
      "path": "generate_canon_purity_dashboard.py",
      "role": "engine",
      "analyzer_layer": "regime",
      "purpose": "Generates dashboard visualizing canon purity metrics."
    },
    {
      "path": "generate_canon_purity_dashboard.py.md",
      "role": "reference",
      "analyzer_layer": "regime",
      "purpose": "Documentation for purity dashboard generator."
    },

    {
      "path": "generate_canon_purity_heatmap.py",
      "role": "engine",
      "analyzer_layer": "regime",
      "purpose": "Generates heatmap of purity across modules."
    },
    {
      "path": "generate_canon_purity_heatmap.py.md",
      "role": "reference",
      "analyzer_layer": "regime",
      "purpose": "Documentation for purity heatmap generator."
    },

    /* ------------------------------ MODULE SCHEMA ------------------------------ */

    {
      "path": "enforce_module_schema.py",
      "role": "engine",
      "analyzer_layer": "operator",
      "purpose": "Enforces module.json schema compliance across all modules."
    },
    {
      "path": "enforce_module_schema.py.md",
      "role": "reference",
      "analyzer_layer": "operator",
      "purpose": "Documentation for module schema enforcement engine."
    },

    {
      "path": "repair_module_schema.py",
      "role": "engine",
      "analyzer_layer": "operator",
      "purpose": "Repairs module schema inconsistencies."
    },
    {
      "path": "repair_module_schema.py.md",
      "role": "reference",
      "analyzer_layer": "operator",
      "purpose": "Documentation for module schema repair engine."
    },

    {
      "path": "upgrade_module_schema_vnext.py",
      "role": "engine",
      "analyzer_layer": "operator",
      "purpose": "Upgrades module schemas to next‑generation canonical format."
    },
    {
      "path": "upgrade_module_schema_vnext.py.md",
      "role": "reference",
      "analyzer_layer": "operator",
      "purpose": "Documentation for schema upgrade engine."
    },

    {
      "path": "repair_module_json.py",
      "role": "engine",
      "analyzer_layer": "operator",
      "purpose": "Repairs module.json manifests."
    },
    {
      "path": "repair_module_json.py.md",
      "role": "reference",
      "analyzer_layer": "operator",
      "purpose": "Documentation for module.json repair engine."
    },

    /* ------------------------------ CONSISTENCY MAPS ------------------------------ */

    {
      "path": "consistency_map_auto_repair.py",
      "role": "engine",
      "analyzer_layer": "coherence",
      "purpose": "Auto‑repair engine for consistency maps."
    },
    {
      "path": "consistency_map_auto_repair.py.md",
      "role": "reference",
      "analyzer_layer": "coherence",
      "purpose": "Documentation for consistency map auto‑repair."
    },

    {
      "path": "generate_consistency_map.py",
      "role": "engine",
      "analyzer_layer": "coherence",
      "purpose": "Generates consistency map across modules."
    },
    {
      "path": "generate_consistency_map.py.md",
      "role": "reference",
      "analyzer_layer": "coherence",
      "purpose": "Documentation for consistency map generator."
    },

    {
      "path": "generate_consistency_map_svg.py",
      "role": "engine",
      "analyzer_layer": "coherence",
      "purpose": "SVG generator for consistency maps."
    },
    {
      "path": "generate_consistency_map_svg.py.md",
      "role": "reference",
      "analyzer_layer": "coherence",
      "purpose": "Documentation for consistency map SVG generator."
    },

    {
      "path": "generate_consistency_map_heatmap.py",
      "role": "engine",
      "analyzer_layer": "coherence",
      "purpose": "Heatmap generator for consistency maps."
    },
    {
      "path": "generate_consistency_map_heatmap.py.md",
      "role": "reference",
      "analyzer_layer": "coherence",
      "purpose": "Documentation for consistency map heatmap generator."
    },

    {
      "path": "generate_consistency_atlas.py",
      "role": "engine",
      "analyzer_layer": "coherence",
      "purpose": "Generates atlas of consistency surfaces."
    },
    {
      "path": "generate_consistency_atlas.py.md",
      "role": "reference",
      "analyzer_layer": "coherence",
      "purpose": "Documentation for consistency atlas generator."
    },

    /* ------------------------------ MODULE GENERATION ------------------------------ */

    {
      "path": "generate_module.py",
      "role": "engine",
      "analyzer_layer": "operator",
      "purpose": "Generates a new module scaffold."
    },
    {
      "path": "generate_module.py.md",
      "role": "reference",
      "analyzer_layer": "operator",
      "purpose": "Documentation for module generator."
    },

    {
      "path": "generate_module_bundle.py",
      "role": "engine",
      "analyzer_layer": "operator",
      "purpose": "Generates bundle of module artifacts."
    },
    {
      "path": "generate_module_bundle.py.md",
      "role": "reference",
      "analyzer_layer": "operator",
      "purpose": "Documentation for module bundle generator."
    },

    {
      "path": "generate_all_modules.py",
      "role": "engine",
      "analyzer_layer": "operator",
      "purpose": "Generates all modules in the canon."
    },
    {
      "path": "generate_all_modules.py.md",
      "role": "reference",
      "analyzer_layer": "operator",
      "purpose": "Documentation for all‑modules generator."
    },

    /* ------------------------------ DOMAIN GRAPH & BUNDLES ------------------------------ */

    {
      "path": "generate_domain_bundle.py",
      "role": "engine",
      "analyzer_layer": "dimensional",
      "purpose": "Generates domain bundle artifacts."
    },
    {
      "path": "generate_domain_bundle.py.md",
      "role": "reference",
      "analyzer_layer": "dimensional",
      "purpose": "Documentation for domain bundle generator."
    },

    {
      "path": "generate_domain_graph_svg.py",
      "role": "engine",
      "analyzer_layer": "dimensional",
      "purpose": "Generates SVG domain graph."
    },
    {
      "path": "generate_domain_graph_svg.py.md",
      "role": "reference",
      "analyzer_layer": "dimensional",
      "purpose": "Documentation for domain graph SVG generator."
    },

    {
      "path": "generate_domain_module_graphs.py",
      "role": "engine",
      "analyzer_layer": "dimensional",
      "purpose": "Generates module‑level domain graphs."
    },
    {
      "path": "generate_domain_module_graphs.py.md",
      "role": "reference",
      "analyzer_layer": "dimensional",
      "purpose": "Documentation for domain module graph generator."
    },

    {
      "path": "generate_domain_overview.py",
      "role": "engine",
      "analyzer_layer": "dimensional",
      "purpose": "Generates domain overview document."
    },
    {
      "path": "generate_domain_overview.py.md",
      "role": "reference",
      "analyzer_layer": "dimensional",
      "purpose": "Documentation for domain overview generator."
    },

    /* ------------------------------ TRIAD PURITY ------------------------------ */

    {
      "path": "triad_purity_auditor.py",
      "role": "diagnostic",
      "analyzer_layer": "regime",
      "purpose": "Audits triad purity across modules."
    },
    {
      "path": "triad_purity_auditor.py.md",
      "role": "reference",
      "analyzer_layer": "regime",
      "purpose": "Documentation for triad purity auditor."
    },

    {
      "path": "triad_purity_auto_repair.py",
      "role": "engine",
      "analyzer_layer": "regime",
      "purpose": "Auto‑repair engine for triad purity."
    },
    {
      "path": "triad_purity_auto_repair.py.md",
      "role": "reference",
      "analyzer_layer": "regime",
      "purpose": "Documentation for triad purity auto‑repair."
    },

    {
      "path": "generate_triad_purity_badges.py",
      "role": "engine",
      "analyzer_layer": "regime",
      "purpose": "Generates triad purity badges."
    },
    {
      "path": "generate_triad_purity_badges.py.md",
      "role": "reference",
      "analyzer_layer": "regime",
      "purpose": "Documentation for triad purity badge generator."
    },

    {
      "path": "generate_triad_purity_heatmap.py",
      "role": "engine",
      "analyzer_layer": "regime",
      "purpose": "Generates triad purity heatmap."
    },
    {
      "path": "generate_triad_purity_heatmap.py.md",
      "role": "reference",
      "analyzer_layer": "regime",
      "purpose": "Documentation for triad purity heatmap generator."
    },

    /* ------------------------------ VALIDATION ------------------------------ */

    {
      "path": "validate_module_dependencies.py",
      "role": "diagnostic",
      "analyzer_layer": "operator",
      "purpose": "Validates module dependency graph."
    },
    {
      "path": "validate_module_dependencies.py.md",
      "role": "reference",
      "analyzer_layer": "operator",
      "purpose": "Documentation for module dependency validator."
    },

    {
      "path": "validate_module_inheritance.py",
      "role": "diagnostic",
      "analyzer_layer": "operator",
      "purpose": "Validates inheritance patterns across modules."
    },
    {
      "path": "validate_module_inheritance.py.md",
      "role": "reference",
      "analyzer_layer": "operator",
      "purpose": "Documentation for module inheritance validator."
    },

    {
      "path": "validate_mrt_trace.js",
      "role": "diagnostic",
      "analyzer_layer": "operator",
      "purpose": "Validates MRT trace using JS engine."
    },

    {
      "path": "validate_mrt_trace.py",
      "role": "diagnostic",
      "analyzer_layer": "operator",
      "purpose": "Validates MRT trace using Python engine."
    }
  ]
}