PyPI - nat-engine - Versions diffs - 1__py3-none-any.whl - Mend

nat-engine 1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (299) hide show

mannf/__init__.py +33 -0
mannf/__main__.py +10 -0
mannf/_version.py +8 -0
mannf/agents/__init__.py +7 -0
mannf/agents/analyzer_agent.py +9 -0
mannf/agents/base.py +9 -0
mannf/agents/bdi_agent.py +9 -0
mannf/agents/belief_state.py +9 -0
mannf/agents/coordinator_agent.py +9 -0
mannf/agents/executor_agent.py +9 -0
mannf/agents/monitor_agent.py +9 -0
mannf/agents/oracle_agent.py +9 -0
mannf/agents/planner_agent.py +9 -0
mannf/agents/test_agent.py +9 -0
mannf/anomaly/__init__.py +7 -0
mannf/anomaly/enhanced_detector.py +9 -0
mannf/cli.py +9 -0
mannf/core/__init__.py +26 -0
mannf/core/agents/__init__.py +52 -0
mannf/core/agents/accessibility_scanner_agent.py +245 -0
mannf/core/agents/analyzer_agent.py +224 -0
mannf/core/agents/autonomous_loop_agent.py +1086 -0
mannf/core/agents/autonomous_loop_models.py +62 -0
mannf/core/agents/autonomous_run_differ.py +427 -0
mannf/core/agents/base.py +128 -0
mannf/core/agents/bdi_agent.py +330 -0
mannf/core/agents/belief_state.py +202 -0
mannf/core/agents/browser_coordinator_agent.py +224 -0
mannf/core/agents/browser_executor_agent.py +410 -0
mannf/core/agents/coordinator_agent.py +262 -0
mannf/core/agents/executor_agent.py +222 -0
mannf/core/agents/monitor_agent.py +188 -0
mannf/core/agents/oracle_agent.py +150 -0
mannf/core/agents/performance_testing_agent.py +279 -0
mannf/core/agents/planner_agent.py +128 -0
mannf/core/agents/test_agent.py +249 -0
mannf/core/agents/visual_regression_agent.py +311 -0
mannf/core/agents/web_crawler_agent.py +510 -0
mannf/core/agents/worker_pool.py +366 -0
mannf/core/anomaly/__init__.py +14 -0
mannf/core/anomaly/enhanced_detector.py +541 -0
mannf/core/browser/__init__.py +63 -0
mannf/core/browser/accessibility_scanner.py +424 -0
mannf/core/browser/discovery_model.py +178 -0
mannf/core/browser/dom_snapshot.py +349 -0
mannf/core/browser/ingestor_bridge.py +371 -0
mannf/core/browser/performance_metrics.py +217 -0
mannf/core/browser/reflection_analyzer.py +442 -0
mannf/core/browser/scenario_generator.py +1100 -0
mannf/core/browser/security_scenario_generator.py +695 -0
mannf/core/browser/visual_comparer.py +159 -0
mannf/core/diagnostics/__init__.py +28 -0
mannf/core/diagnostics/failure_clusterer.py +211 -0
mannf/core/diagnostics/flake_detector.py +233 -0
mannf/core/diagnostics/root_cause_analyzer.py +273 -0
mannf/core/distributed/__init__.py +16 -0
mannf/core/distributed/endpoint.py +139 -0
mannf/core/distributed/system_under_test.py +207 -0
mannf/core/functional_orchestrator.py +428 -0
mannf/core/messaging/__init__.py +11 -0
mannf/core/messaging/bus.py +113 -0
mannf/core/messaging/messages.py +89 -0
mannf/core/nat_orchestrator.py +342 -0
mannf/core/neural/__init__.py +183 -0
mannf/core/orchestrator.py +272 -0
mannf/core/prioritization/__init__.py +17 -0
mannf/core/prioritization/adaptive_controller.py +509 -0
mannf/core/prioritization/belief_prioritizer.py +231 -0
mannf/core/prioritization/risk_scorer.py +430 -0
mannf/core/reporting/__init__.py +12 -0
mannf/core/reporting/unified_report.py +664 -0
mannf/core/testing/__init__.py +17 -0
mannf/core/testing/adaptive_controller.py +149 -0
mannf/core/testing/models.py +179 -0
mannf/core/validation/__init__.py +10 -0
mannf/core/validation/self_validation_runner.py +180 -0
mannf/dashboard/__init__.py +7 -0
mannf/dashboard/app.py +9 -0
mannf/dashboard/models.py +9 -0
mannf/dashboard/static/index.html +2538 -0
mannf/dashboard/telemetry.py +9 -0
mannf/distributed/__init__.py +7 -0
mannf/distributed/endpoint.py +9 -0
mannf/distributed/system_under_test.py +9 -0
mannf/healing/__init__.py +7 -0
mannf/healing/graphql_schema_diff.py +9 -0
mannf/healing/healer.py +9 -0
mannf/healing/models.py +9 -0
mannf/healing/schema_diff.py +9 -0
mannf/integrations/__init__.py +7 -0
mannf/integrations/auth.py +9 -0
mannf/integrations/graphql_parser.py +9 -0
mannf/integrations/graphql_sut.py +9 -0
mannf/integrations/http_sut.py +9 -0
mannf/integrations/openapi_parser.py +9 -0
mannf/integrations/postman_parser.py +9 -0
mannf/llm/__init__.py +7 -0
mannf/llm/anthropic_provider.py +9 -0
mannf/llm/base.py +9 -0
mannf/llm/config.py +9 -0
mannf/llm/factory.py +9 -0
mannf/llm/openai_provider.py +9 -0
mannf/llm/prompts.py +9 -0
mannf/messaging/__init__.py +7 -0
mannf/messaging/bus.py +9 -0
mannf/messaging/messages.py +9 -0
mannf/nat_orchestrator.py +9 -0
mannf/neural/__init__.py +7 -0
mannf/orchestrator.py +9 -0
mannf/prioritization/__init__.py +7 -0
mannf/prioritization/adaptive_controller.py +9 -0
mannf/prioritization/belief_prioritizer.py +9 -0
mannf/prioritization/risk_scorer.py +9 -0
mannf/product/__init__.py +29 -0
mannf/product/admin/__init__.py +3 -0
mannf/product/admin/routes.py +514 -0
mannf/product/auth/__init__.py +5 -0
mannf/product/auth/saml.py +212 -0
mannf/product/billing/__init__.py +5 -0
mannf/product/billing/audit.py +160 -0
mannf/product/billing/feature_gates.py +180 -0
mannf/product/billing/metering.py +179 -0
mannf/product/billing/notifications.py +181 -0
mannf/product/billing/plans.py +133 -0
mannf/product/billing/rate_limits.py +35 -0
mannf/product/billing/stripe_billing.py +906 -0
mannf/product/billing/tenant_auth.py +233 -0
mannf/product/billing/tenant_manager.py +873 -0
mannf/product/cli.py +3900 -0
mannf/product/cli_admin.py +408 -0
mannf/product/dashboard/__init__.py +61 -0
mannf/product/dashboard/app.py +3567 -0
mannf/product/dashboard/models.py +460 -0
mannf/product/dashboard/static/index.html +6347 -0
mannf/product/dashboard/static/manifest.json +25 -0
mannf/product/dashboard/static/pwa-icon-192.png +0 -0
mannf/product/dashboard/static/pwa-icon-512.png +0 -0
mannf/product/dashboard/static/sw.js +64 -0
mannf/product/dashboard/telemetry.py +547 -0
mannf/product/database.py +145 -0
mannf/product/demo.py +844 -0
mannf/product/doctor.py +509 -0
mannf/product/exporters/__init__.py +65 -0
mannf/product/exporters/azuredevops_exporter.py +257 -0
mannf/product/exporters/base.py +307 -0
mannf/product/exporters/bugzilla_exporter.py +200 -0
mannf/product/exporters/dedup.py +275 -0
mannf/product/exporters/finding_adapter.py +216 -0
mannf/product/exporters/github_exporter.py +197 -0
mannf/product/exporters/gitlab_exporter.py +215 -0
mannf/product/exporters/jira_exporter.py +180 -0
mannf/product/exporters/linear_exporter.py +195 -0
mannf/product/exporters/loader.py +233 -0
mannf/product/exporters/pagerduty_exporter.py +363 -0
mannf/product/exporters/sentry_exporter.py +322 -0
mannf/product/exporters/servicenow_exporter.py +240 -0
mannf/product/exporters/shortcut_exporter.py +231 -0
mannf/product/exporters/webhook_exporter.py +383 -0
mannf/product/formatters/__init__.py +18 -0
mannf/product/formatters/allure_formatter.py +161 -0
mannf/product/formatters/ctrf_formatter.py +149 -0
mannf/product/healing/__init__.py +30 -0
mannf/product/healing/graphql_schema_diff.py +152 -0
mannf/product/healing/healer.py +141 -0
mannf/product/healing/models.py +175 -0
mannf/product/healing/schema_diff.py +251 -0
mannf/product/ingestors/__init__.py +77 -0
mannf/product/ingestors/base.py +256 -0
mannf/product/ingestors/bgstm_ingestor.py +764 -0
mannf/product/ingestors/curl_ingestor.py +1019 -0
mannf/product/ingestors/cypress_ingestor.py +487 -0
mannf/product/ingestors/gherkin_ingestor.py +967 -0
mannf/product/ingestors/graphql_ingestor.py +845 -0
mannf/product/ingestors/grpc_ingestor.py +591 -0
mannf/product/ingestors/har_ingestor.py +976 -0
mannf/product/ingestors/loader.py +284 -0
mannf/product/ingestors/models.py +146 -0
mannf/product/ingestors/openapi_ingestor.py +606 -0
mannf/product/ingestors/playwright_ingestor.py +449 -0
mannf/product/ingestors/postman_ingestor.py +631 -0
mannf/product/ingestors/traffic_ingestor.py +679 -0
mannf/product/ingestors/websocket_ingestor.py +526 -0
mannf/product/integrations/__init__.py +21 -0
mannf/product/integrations/auth.py +190 -0
mannf/product/integrations/graphql_parser.py +436 -0
mannf/product/integrations/graphql_sut.py +247 -0
mannf/product/integrations/grpc_sut.py +469 -0
mannf/product/integrations/http_sut.py +237 -0
mannf/product/integrations/kafka_adapter.py +342 -0
mannf/product/integrations/openapi_parser.py +513 -0
mannf/product/integrations/postman_parser.py +467 -0
mannf/product/integrations/webhook_receiver.py +344 -0
mannf/product/integrations/websocket_sut.py +434 -0
mannf/product/llm/__init__.py +25 -0
mannf/product/llm/anthropic_provider.py +94 -0
mannf/product/llm/base.py +267 -0
mannf/product/llm/config.py +48 -0
mannf/product/llm/factory.py +42 -0
mannf/product/llm/openai_provider.py +93 -0
mannf/product/llm/prompts.py +403 -0
mannf/product/llm/root_cause_service.py +311 -0
mannf/product/llm/test_plan_models.py +78 -0
mannf/product/metrics.py +149 -0
mannf/product/middleware/__init__.py +3 -0
mannf/product/middleware/audit_middleware.py +112 -0
mannf/product/middleware/tenant_isolation.py +114 -0
mannf/product/models.py +347 -0
mannf/product/notifications/__init__.py +24 -0
mannf/product/notifications/dispatcher.py +411 -0
mannf/product/onboarding.py +190 -0
mannf/product/orchestration/__init__.py +39 -0
mannf/product/orchestration/ingest_scan_orchestrator.py +339 -0
mannf/product/orchestration/pipeline.py +401 -0
mannf/product/orchestrator.py +987 -0
mannf/product/orchestrator_models.py +269 -0
mannf/product/regression/__init__.py +36 -0
mannf/product/regression/differ.py +172 -0
mannf/product/regression/masking.py +100 -0
mannf/product/regression/models.py +232 -0
mannf/product/regression/recorder.py +124 -0
mannf/product/regression/replayer.py +168 -0
mannf/product/reports/__init__.py +10 -0
mannf/product/reports/pdf.py +132 -0
mannf/product/scheduling/__init__.py +57 -0
mannf/product/scheduling/cron_utils.py +251 -0
mannf/product/scheduling/engine.py +473 -0
mannf/product/scheduling/models.py +86 -0
mannf/product/scheduling/queue.py +894 -0
mannf/product/scheduling/store.py +235 -0
mannf/product/security/__init__.py +21 -0
mannf/product/security/belief_guided.py +143 -0
mannf/product/security/checks/__init__.py +55 -0
mannf/product/security/checks/base.py +69 -0
mannf/product/security/checks/bfla.py +77 -0
mannf/product/security/checks/bola.py +77 -0
mannf/product/security/checks/bopla.py +80 -0
mannf/product/security/checks/broken_auth.py +86 -0
mannf/product/security/checks/graphql_security.py +299 -0
mannf/product/security/checks/inventory.py +70 -0
mannf/product/security/checks/misconfig.py +158 -0
mannf/product/security/checks/resource_consumption.py +70 -0
mannf/product/security/checks/sensitive_flows.py +80 -0
mannf/product/security/checks/ssrf.py +101 -0
mannf/product/security/checks/unsafe_consumption.py +120 -0
mannf/product/security/models.py +92 -0
mannf/product/security/plugin_loader.py +182 -0
mannf/product/security/reporter.py +92 -0
mannf/product/security/scanner.py +183 -0
mannf/product/server.py +6220 -0
mannf/product/setup_wizard.py +873 -0
mannf/product/status.py +404 -0
mannf/product/storage/__init__.py +10 -0
mannf/product/storage/artifact_store.py +343 -0
mannf/product/telemetry.py +300 -0
mannf/product/uninstall.py +169 -0
mannf/product/upgrade.py +139 -0
mannf/product/weights/__init__.py +13 -0
mannf/product/weights/blob_store.py +299 -0
mannf/product/weights/factory.py +42 -0
mannf/product/weights/registry.py +159 -0
mannf/product/weights/store.py +210 -0
mannf/regression/__init__.py +7 -0
mannf/regression/differ.py +9 -0
mannf/regression/masking.py +9 -0
mannf/regression/models.py +9 -0
mannf/regression/recorder.py +9 -0
mannf/regression/replayer.py +9 -0
mannf/security/__init__.py +7 -0
mannf/security/belief_guided.py +9 -0
mannf/security/checks/__init__.py +7 -0
mannf/security/checks/base.py +9 -0
mannf/security/checks/bfla.py +9 -0
mannf/security/checks/bola.py +9 -0
mannf/security/checks/bopla.py +9 -0
mannf/security/checks/broken_auth.py +9 -0
mannf/security/checks/graphql_security.py +9 -0
mannf/security/checks/inventory.py +9 -0
mannf/security/checks/misconfig.py +9 -0
mannf/security/checks/resource_consumption.py +9 -0
mannf/security/checks/sensitive_flows.py +9 -0
mannf/security/checks/ssrf.py +9 -0
mannf/security/checks/unsafe_consumption.py +9 -0
mannf/security/models.py +9 -0
mannf/security/reporter.py +9 -0
mannf/security/scanner.py +9 -0
mannf/server.py +9 -0
mannf/testing/__init__.py +7 -0
mannf/testing/adaptive_controller.py +9 -0
mannf/testing/models.py +9 -0
mannf/weights/__init__.py +7 -0
mannf/weights/registry.py +9 -0
mannf/weights/store.py +9 -0
nat_engine-1.dist-info/METADATA +555 -0
nat_engine-1.dist-info/RECORD +299 -0
nat_engine-1.dist-info/WHEEL +5 -0
nat_engine-1.dist-info/entry_points.txt +4 -0
nat_engine-1.dist-info/licenses/LICENSE +651 -0
nat_engine-1.dist-info/licenses/NOTICE +178 -0
nat_engine-1.dist-info/top_level.txt +1 -0

mannf/core/browser/accessibility_scanner.py ADDED Viewed

@@ -0,0 +1,424 @@
+# Copyright (C) 2026 Brad Guider
+# This file is part of NAT (Neural Agent Testing Framework).
+# Licensed under the AGPL-3.0. See LICENSE for details.
+# Commercial licensing available — see COMMERCIAL_LICENSE.md.
+"""AccessibilityScanner – static WCAG audit against a DOMSnapshot.
+Analyses a :class:`~mannf.core.browser.dom_snapshot.DOMSnapshot` for common
+WCAG 2.1 violations **without requiring a browser runtime or axe-core**.  All
+checks operate on the data already present in the snapshot's element list.
+Rules implemented
+-----------------
+* ``missing-alt-text``      — ``<img>`` with no ``alt`` attribute (WCAG 1.1.1)
+* ``missing-form-label``    — ``<input>``/``<select>``/``<textarea>`` without a
+                              ``<label>``, ``aria-label``, or ``aria-labelledby``
+                              (WCAG 1.3.1, 4.1.2)
+* ``empty-link``            — ``<a>`` with no text content (WCAG 2.4.4)
+* ``empty-button``          — ``<button>`` with no text content (WCAG 4.1.2)
+* ``missing-document-title``— page ``<title>`` is absent or empty (WCAG 2.4.2)
+* ``missing-lang-attr``     — ``<html>`` element has no ``lang`` attribute
+                              (WCAG 3.1.1)
+* ``unlabelled-placeholder``— ``<input>`` has a placeholder but no accessible
+                              label (informational / moderate)
+* ``duplicate-id``          — multiple elements share the same ``id``
+                              (WCAG 4.1.1)
+"""
+from __future__ import annotations
+from dataclasses import dataclass, field
+from datetime import datetime, timezone
+from typing import Any
+from mannf.core.browser.dom_snapshot import DOMElement, DOMSnapshot
+# ---------------------------------------------------------------------------
+# Data model
+# ---------------------------------------------------------------------------
+@dataclass
+class AccessibilityViolation:
+    """A single WCAG accessibility violation found in a page snapshot.
+    Parameters
+    ----------
+    rule_id:
+        Machine-readable rule identifier (e.g. ``"missing-alt-text"``).
+    description:
+        Human-readable explanation of the violation.
+    impact:
+        Severity level: ``"critical"``, ``"serious"``, ``"moderate"``, or
+        ``"minor"``.
+    wcag_criteria:
+        Relevant WCAG 2.1 success criterion (e.g. ``"1.1.1"``).
+    selector:
+        CSS selector of the offending element.
+    element_html:
+        Shortened HTML representation for display in reports.
+    """
+    rule_id: str
+    description: str
+    impact: str
+    wcag_criteria: str
+    selector: str
+    element_html: str
+@dataclass
+class AccessibilityScanResult:
+    """Aggregated result of an accessibility scan.
+    Parameters
+    ----------
+    url:
+        URL of the page that was scanned.
+    timestamp:
+        ISO 8601 UTC timestamp of when the scan was performed.
+    violations:
+        All violations found during the scan.
+    passes:
+        Number of rules that passed (no violations found).
+    total_rules:
+        Total number of rules evaluated.
+    """
+    url: str
+    timestamp: str
+    violations: list[AccessibilityViolation] = field(default_factory=list)
+    passes: int = 0
+    total_rules: int = 0
+    @property
+    def violation_count(self) -> int:
+        """Total number of violations found."""
+        return len(self.violations)
+    @property
+    def compliance_score(self) -> float:
+        """Compliance percentage in the range 0.0–100.0.
+        Returns ``100.0`` when no rules were evaluated.
+        """
+        if self.total_rules == 0:
+            return 100.0
+        return round((self.passes / self.total_rules) * 100.0, 1)
+# ---------------------------------------------------------------------------
+# Internal helpers
+# ---------------------------------------------------------------------------
+def _element_html(el: DOMElement) -> str:
+    """Build a short HTML-like representation of *el* for reports."""
+    attrs: list[str] = []
+    if el.element_id:
+        attrs.append(f'id="{el.element_id}"')
+    for key, val in el.attributes.items():
+        attrs.append(f'{key}="{val}"')
+    attr_str = " " + " ".join(attrs) if attrs else ""
+    text = el.text[:40] if el.text else ""
+    if text:
+        return f"<{el.tag}{attr_str}>{text}</{el.tag}>"
+    return f"<{el.tag}{attr_str}>"
+def _has_accessible_label(el: DOMElement, labelled_ids: set[str]) -> bool:
+    """Return ``True`` if *el* has an accessible name from any common source.
+    Checks (in order):
+    - ``aria-label`` attribute
+    - ``aria-labelledby`` attribute
+    - ``id`` referenced by a ``<label for="…">`` element in the snapshot
+    """
+    if el.attributes.get("aria-label", "").strip():
+        return True
+    if el.attributes.get("aria-labelledby", "").strip():
+        return True
+    if el.element_id and el.element_id in labelled_ids:
+        return True
+    return False
+def _collect_label_targets(elements: list[DOMElement]) -> set[str]:
+    """Return the set of element IDs referenced by ``<label for="…">`` elements."""
+    targets: set[str] = set()
+    for el in elements:
+        if el.tag == "label":
+            for_val = el.attributes.get("for", "").strip()
+            if for_val:
+                targets.add(for_val)
+    return targets
+# ---------------------------------------------------------------------------
+# Rule implementations
+# ---------------------------------------------------------------------------
+def _rule_missing_alt_text(elements: list[DOMElement]) -> list[AccessibilityViolation]:
+    violations: list[AccessibilityViolation] = []
+    for el in elements:
+        if el.tag == "img":
+            alt = el.attributes.get("alt")
+            if alt is None:
+                violations.append(
+                    AccessibilityViolation(
+                        rule_id="missing-alt-text",
+                        description=(
+                            "Image is missing an alt attribute. Screen readers "
+                            "will not be able to convey the image content."
+                        ),
+                        impact="critical",
+                        wcag_criteria="1.1.1",
+                        selector=el.selector,
+                        element_html=_element_html(el),
+                    )
+                )
+    return violations
+def _rule_missing_form_label(
+    elements: list[DOMElement], labelled_ids: set[str]
+) -> list[AccessibilityViolation]:
+    violations: list[AccessibilityViolation] = []
+    form_controls = {"input", "select", "textarea"}
+    # Exclude hidden inputs — they do not need labels.
+    for el in elements:
+        if el.tag not in form_controls:
+            continue
+        if el.attributes.get("type", "").lower() == "hidden":
+            continue
+        if not _has_accessible_label(el, labelled_ids):
+            violations.append(
+                AccessibilityViolation(
+                    rule_id="missing-form-label",
+                    description=(
+                        f"Form control <{el.tag}> has no associated label, "
+                        "aria-label, or aria-labelledby."
+                    ),
+                    impact="serious",
+                    wcag_criteria="1.3.1",
+                    selector=el.selector,
+                    element_html=_element_html(el),
+                )
+            )
+    return violations
+def _rule_empty_link(elements: list[DOMElement]) -> list[AccessibilityViolation]:
+    violations: list[AccessibilityViolation] = []
+    for el in elements:
+        if el.tag == "a":
+            if not el.text.strip() and not el.attributes.get("aria-label", "").strip():
+                violations.append(
+                    AccessibilityViolation(
+                        rule_id="empty-link",
+                        description=(
+                            "Link has no discernible text content. Screen readers "
+                            "cannot describe where the link leads."
+                        ),
+                        impact="serious",
+                        wcag_criteria="2.4.4",
+                        selector=el.selector,
+                        element_html=_element_html(el),
+                    )
+                )
+    return violations
+def _rule_empty_button(elements: list[DOMElement]) -> list[AccessibilityViolation]:
+    violations: list[AccessibilityViolation] = []
+    for el in elements:
+        if el.tag == "button":
+            if not el.text.strip() and not el.attributes.get("aria-label", "").strip():
+                violations.append(
+                    AccessibilityViolation(
+                        rule_id="empty-button",
+                        description=(
+                            "Button has no discernible text content. Screen readers "
+                            "cannot describe the button's action."
+                        ),
+                        impact="critical",
+                        wcag_criteria="4.1.2",
+                        selector=el.selector,
+                        element_html=_element_html(el),
+                    )
+                )
+    return violations
+def _rule_missing_document_title(snapshot: DOMSnapshot) -> list[AccessibilityViolation]:
+    if not snapshot.title or not snapshot.title.strip():
+        return [
+            AccessibilityViolation(
+                rule_id="missing-document-title",
+                description=(
+                    "The page is missing a <title> element. This prevents users "
+                    "from identifying the page in browser history or tab strips."
+                ),
+                impact="serious",
+                wcag_criteria="2.4.2",
+                selector="head > title",
+                element_html="<title></title>",
+            )
+        ]
+    return []
+def _rule_missing_lang_attr(elements: list[DOMElement]) -> list[AccessibilityViolation]:
+    for el in elements:
+        if el.tag == "html":
+            if not el.attributes.get("lang", "").strip():
+                return [
+                    AccessibilityViolation(
+                        rule_id="missing-lang-attr",
+                        description=(
+                            "The <html> element is missing a lang attribute. "
+                            "Screen readers use this to select the correct voice profile."
+                        ),
+                        impact="serious",
+                        wcag_criteria="3.1.1",
+                        selector="html",
+                        element_html=_element_html(el),
+                    )
+                ]
+            return []
+    # No <html> element found in snapshot — flag it
+    return [
+        AccessibilityViolation(
+            rule_id="missing-lang-attr",
+            description=(
+                "No <html> element found in snapshot; cannot verify lang attribute."
+            ),
+            impact="serious",
+            wcag_criteria="3.1.1",
+            selector="html",
+            element_html="<html>",
+        )
+    ]
+def _rule_unlabelled_placeholder(
+    elements: list[DOMElement], labelled_ids: set[str]
+) -> list[AccessibilityViolation]:
+    """Flag ``<input>`` elements that rely solely on placeholder text for labelling."""
+    violations: list[AccessibilityViolation] = []
+    for el in elements:
+        if el.tag != "input":
+            continue
+        if el.attributes.get("type", "").lower() == "hidden":
+            continue
+        placeholder = el.attributes.get("placeholder", "").strip()
+        if placeholder and not _has_accessible_label(el, labelled_ids):
+            violations.append(
+                AccessibilityViolation(
+                    rule_id="unlabelled-placeholder",
+                    description=(
+                        "Input uses placeholder text as its only label. "
+                        "Placeholder text disappears when the user starts typing."
+                    ),
+                    impact="moderate",
+                    wcag_criteria="1.3.1",
+                    selector=el.selector,
+                    element_html=_element_html(el),
+                )
+            )
+    return violations
+def _rule_duplicate_ids(elements: list[DOMElement]) -> list[AccessibilityViolation]:
+    seen: dict[str, int] = {}
+    for el in elements:
+        if el.element_id:
+            seen[el.element_id] = seen.get(el.element_id, 0) + 1
+    violations: list[AccessibilityViolation] = []
+    for eid, count in seen.items():
+        if count > 1:
+            violations.append(
+                AccessibilityViolation(
+                    rule_id="duplicate-id",
+                    description=(
+                        f'id="{eid}" appears {count} times on the page. '
+                        "Duplicate IDs break ARIA relationships and JS selectors."
+                    ),
+                    impact="serious",
+                    wcag_criteria="4.1.1",
+                    selector=f"#{eid}",
+                    element_html=f'[id="{eid}"] (×{count})',
+                )
+            )
+    return violations
+# ---------------------------------------------------------------------------
+# Public API
+# ---------------------------------------------------------------------------
+# Ordered list of (rule_fn, *extra_args) for the scanner loop.  Each entry is
+# a callable that returns list[AccessibilityViolation].
+_RULES: list[str] = [
+    "missing-alt-text",
+    "missing-form-label",
+    "empty-link",
+    "empty-button",
+    "missing-document-title",
+    "missing-lang-attr",
+    "unlabelled-placeholder",
+    "duplicate-id",
+]
+def scan_accessibility(snapshot: DOMSnapshot) -> AccessibilityScanResult:
+    """Run accessibility rules against a :class:`DOMSnapshot`.
+    No browser runtime is required — all checks operate on the static element
+    data already captured in the snapshot.
+    Parameters
+    ----------
+    snapshot:
+        A :class:`~mannf.core.browser.dom_snapshot.DOMSnapshot` to audit.
+    Returns
+    -------
+    AccessibilityScanResult
+        Aggregated violations, pass count, and compliance score.
+    """
+    timestamp = datetime.now(timezone.utc).isoformat()
+    elements = snapshot.elements
+    labelled_ids = _collect_label_targets(elements)
+    all_violations: list[AccessibilityViolation] = []
+    # Track which rules produced violations so we can compute `passes`.
+    rules_with_violations: set[str] = set()
+    def _run(rule_id: str, violations: list[AccessibilityViolation]) -> None:
+        if violations:
+            rules_with_violations.add(rule_id)
+        all_violations.extend(violations)
+    _run("missing-alt-text", _rule_missing_alt_text(elements))
+    _run("missing-form-label", _rule_missing_form_label(elements, labelled_ids))
+    _run("empty-link", _rule_empty_link(elements))
+    _run("empty-button", _rule_empty_button(elements))
+    _run("missing-document-title", _rule_missing_document_title(snapshot))
+    _run("missing-lang-attr", _rule_missing_lang_attr(elements))
+    _run("unlabelled-placeholder", _rule_unlabelled_placeholder(elements, labelled_ids))
+    _run("duplicate-id", _rule_duplicate_ids(elements))
+    total_rules = len(_RULES)
+    passes = total_rules - len(rules_with_violations)
+    return AccessibilityScanResult(
+        url=snapshot.url,
+        timestamp=timestamp,
+        violations=all_violations,
+        passes=passes,
+        total_rules=total_rules,
+    )

mannf/core/browser/discovery_model.py ADDED Viewed

@@ -0,0 +1,178 @@
+# Copyright (C) 2026 Brad Guider
+# This file is part of NAT (Neural Agent Testing Framework).
+# Licensed under the AGPL-3.0. See LICENSE for details.
+# Commercial licensing available — see COMMERCIAL_LICENSE.md.
+"""Discovery model dataclasses for the WebCrawlerAgent output.
+These typed dataclasses represent the structured JSON discovery model produced
+by the :class:`~mannf.core.agents.web_crawler_agent.WebCrawlerAgent` and
+consumed by downstream Phase 2 components (Scenario Config Generator, etc.).
+"""
+from __future__ import annotations
+import dataclasses
+import json
+from dataclasses import dataclass, field
+from typing import Any
+@dataclass
+class DiscoveredField:
+    """A single form field discovered on a page.
+    Parameters
+    ----------
+    selector:
+        CSS selector to locate the field.
+    type:
+        Input type: ``"text"``, ``"email"``, ``"password"``, ``"select"``, etc.
+    required:
+        Whether the field is marked as required.
+    label:
+        Associated label text (from ``<label for=…>`` or ancestor ``<label>``).
+    name:
+        Value of the ``name`` attribute.
+    placeholder:
+        Placeholder text, or empty string.
+    pattern:
+        HTML5 validation pattern, or empty string.
+    """
+    selector: str
+    type: str
+    required: bool
+    label: str
+    name: str
+    placeholder: str
+    pattern: str
+@dataclass
+class DiscoveredForm:
+    """A form discovered on a page.
+    Parameters
+    ----------
+    action:
+        Form ``action`` URL (may be relative or absolute).
+    method:
+        HTTP method: ``"GET"`` or ``"POST"``.
+    fields:
+        Ordered list of :class:`DiscoveredField` objects within the form.
+    submit_selector:
+        CSS selector for the submit button/input within (or associated with) the form.
+    """
+    action: str
+    method: str
+    fields: list[DiscoveredField]
+    submit_selector: str
+@dataclass
+class InteractiveElement:
+    """A non-form interactive element discovered on a page.
+    Parameters
+    ----------
+    selector:
+        CSS selector to locate the element.
+    text:
+        Visible text content.
+    type:
+        Element role: ``"button"``, ``"link"``, ``"dropdown"``, ``"tab"``, etc.
+    tag:
+        Lower-cased HTML tag name.
+    """
+    selector: str
+    text: str
+    type: str
+    tag: str
+@dataclass
+class DiscoveredPage:
+    """A single page node in the page graph.
+    Parameters
+    ----------
+    url:
+        Page URL (typically a path relative to ``base_url``, or full URL for
+        external pages that are recorded but not followed).
+    title:
+        Page ``<title>`` text.
+    forms:
+        Forms detected on this page.
+    links:
+        Outgoing link ``href`` values discovered on this page.
+    interactive_elements:
+        Non-form interactive elements (buttons, dropdowns, tabs, …).
+    """
+    url: str
+    title: str
+    forms: list[DiscoveredForm]
+    links: list[str]
+    interactive_elements: list[InteractiveElement]
+@dataclass
+class PageEdge:
+    """A directed edge in the page graph representing a navigation action.
+    Parameters
+    ----------
+    from_url:
+        Source page URL.
+    to_url:
+        Destination page URL.
+    action:
+        Navigation type: ``"click"``, ``"navigate"``, or ``"submit"``.
+    selector:
+        CSS selector that triggers the navigation (e.g. ``"a[href='/login']"``).
+    """
+    from_url: str
+    to_url: str
+    action: str
+    selector: str
+@dataclass
+class DiscoveryModel:
+    """Full discovery model produced by a single crawl run.
+    Parameters
+    ----------
+    base_url:
+        The root URL that was crawled.
+    pages:
+        All pages discovered during the crawl.
+    edges:
+        Navigation edges between pages.
+    crawl_duration_s:
+        Total crawl time in seconds.
+    crawl_timestamp:
+        ISO 8601 timestamp (with timezone) for when the crawl was completed.
+    """
+    base_url: str
+    pages: list[DiscoveredPage] = field(default_factory=list)
+    edges: list[PageEdge] = field(default_factory=list)
+    crawl_duration_s: float = 0.0
+    crawl_timestamp: str = ""
+    # ------------------------------------------------------------------
+    # Serialisation
+    # ------------------------------------------------------------------
+    def to_dict(self) -> dict[str, Any]:
+        """Serialise to a JSON-compatible dict matching the issue output shape."""
+        return dataclasses.asdict(self)
+    def to_json(self) -> str:
+        """Serialise to a JSON string (pretty-printed, 2-space indent)."""
+        return json.dumps(self.to_dict(), indent=2)