@teevee98/synapse-hub 0.0.0-stage → 3.8.2
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.
- package/.agents/agents/api-engineer.md +67 -0
- package/.agents/agents/failure-analyst.md +75 -0
- package/.agents/agents/live-explorer.md +70 -0
- package/.agents/agents/orchestrator.md +104 -0
- package/.agents/agents/perf-engineer.md +74 -0
- package/.agents/agents/pom-crafter.md +112 -0
- package/.agents/agents/quality-gatekeeper.md +87 -0
- package/.agents/agents/test-designer.md +73 -0
- package/.agents/agents/test-runner.md +67 -0
- package/.agents/rules/author-integrity-guard.md +33 -0
- package/.agents/rules/communication-style.md +18 -0
- package/.agents/rules/context-engineering.md +37 -0
- package/.agents/rules/git-push-protocol.md +33 -0
- package/.agents/rules/graphify.md +14 -0
- package/.agents/rules/lessons-learned.md +25 -0
- package/.agents/rules/mandatory-playwright-live.md +25 -0
- package/.agents/rules/mobile_appium_rules.md +43 -0
- package/.agents/rules/performance_testing_rules.md +35 -0
- package/.agents/rules/skill-precedence.md +29 -0
- package/.agents/rules/systematic-debugging.md +36 -0
- package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
- package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
- package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
- package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
- package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
- package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
- package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
- package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
- package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
- package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
- package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
- package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
- package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
- package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
- package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
- package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
- package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
- package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
- package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
- package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
- package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
- package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
- package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
- package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
- package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
- package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
- package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
- package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
- package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
- package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
- package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
- package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
- package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
- package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
- package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
- package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
- package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
- package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
- package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
- package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
- package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
- package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
- package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
- package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
- package/.agents/skills/github-actions-templates/SKILL.md +77 -0
- package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
- package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
- package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
- package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
- package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
- package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
- package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
- package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
- package/.agents/skills/lam-script-generator/SKILL.md +123 -0
- package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
- package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
- package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
- package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
- package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
- package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
- package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
- package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
- package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
- package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
- package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
- package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
- package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
- package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
- package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
- package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
- package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
- package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
- package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
- package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
- package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
- package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
- package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
- package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
- package/.agents/skills/qa-memory-os/SKILL.md +80 -0
- package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
- package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
- package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
- package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
- package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
- package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
- package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
- package/.agents/skills/review-spec/SKILL.md +60 -0
- package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
- package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
- package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
- package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
- package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
- package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
- package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
- package/.agents/skills/self-healing-locator/SKILL.md +86 -0
- package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
- package/.agents/skills/senior-code-review/SKILL.md +108 -0
- package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
- package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
- package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
- package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
- package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
- package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
- package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
- package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
- package/.agents/skills/systematic-debugging/SKILL.md +100 -0
- package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
- package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
- package/.agents/skills/test-driven-development/SKILL.md +114 -0
- package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
- package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
- package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
- package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
- package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
- package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
- package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
- package/.agents/skills/verification-before-completion/SKILL.md +100 -0
- package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
- package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
- package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
- package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
- package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
- package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
- package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
- package/.agents/templates/completion_report.md +57 -0
- package/.agents/workflows/analyze_requirement_document.md +18 -0
- package/.agents/workflows/export_testcases_excel.md +32 -0
- package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
- package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
- package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
- package/.agents/workflows/generate_requirements_from_website.md +25 -0
- package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
- package/.agents/workflows/graphify.md +10 -0
- package/.agents/workflows/test-impact.md +15 -0
- package/.agents/workflows/verify.md +34 -0
- package/.cursor/rules/agents.mdc +16 -0
- package/.cursor/rules/language.mdc +7 -0
- package/.cursor/rules/synapse-qa.mdc +24 -0
- package/.cursorrules +27 -0
- package/.dockerignore +53 -0
- package/.pre-commit-hooks.yaml +14 -0
- package/.windsurfrules +26 -0
- package/AGENTS.md +86 -0
- package/CLAUDE.md +54 -0
- package/Dockerfile +81 -0
- package/LICENSE +52 -0
- package/NOTICE +264 -0
- package/README.en.md +172 -0
- package/README.md +171 -2
- package/action.yml +51 -0
- package/agentskills.json +16 -0
- package/bin/agent-qa.js +138 -0
- package/docker-compose.yml +74 -0
- package/docs/ARCHITECTURE.en.md +197 -0
- package/docs/ARCHITECTURE.md +198 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +175 -0
- package/docs/CLI_REFERENCE.md +177 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +121 -0
- package/docs/QUALITY_GATES.md +121 -0
- package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
- package/docs/TOOL_CATALOG.md +129 -0
- package/docs/adopted-ecosystem-tools.md +96 -0
- package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
- package/docs/research/agent_skill_training_analysis.md +1359 -0
- package/docs/schemas/synapse.config.schema.json +87 -0
- package/package.json +94 -4
- package/plugin.json +31 -0
- package/scripts/generate_skill_examples.py +244 -0
- package/scripts/install.ps1 +112 -0
- package/scripts/install_global_plugin.ps1 +94 -0
- package/scripts/install_global_plugin.sh +49 -0
- package/scripts/lint_skills.ps1 +57 -0
- package/scripts/package_dist.py +337 -0
- package/scripts/setup.sh +59 -0
- package/scripts/update_hub.ps1 +19 -0
- package/scripts/update_hub.sh +15 -0
- package/skills_manifest.json +854 -0
- package/synapse.config.json +32 -0
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
- package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
- package/templates/ai_bridges/CLAUDE.md +54 -0
- package/templates/ai_bridges/copilot-instructions.md +20 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
- package/templates/ai_bridges/windsurfrules +26 -0
- package/templates/ci/github-actions-synapse.yml +95 -0
- package/templates/ci/gitlab-ci-synapse.yml +16 -0
- package/templates/ui/index.html +1069 -0
- package/templates/welcome.html.tmpl +2079 -0
- package/tools/.infer_baseline.json +30 -0
- package/tools/TOOLS_RUNBOOK.md +1553 -0
- package/tools/TOOL_CATALOG.json +1769 -0
- package/tools/__init__.py +43 -0
- package/tools/_openapi_parser.py +158 -0
- package/tools/agent_canary.py +525 -0
- package/tools/agentless_patcher.py +417 -0
- package/tools/analyze_project.py +258 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +184 -0
- package/tools/auto_heal.py +271 -0
- package/tools/auto_heal_reflexion.py +532 -0
- package/tools/autogen_qa_broker.py +844 -0
- package/tools/benchmark_swarm_context.py +394 -0
- package/tools/browser_helpers.js +746 -0
- package/tools/browsergym_eval.py +236 -0
- package/tools/bug_reporter.py +252 -0
- package/tools/bump_version.py +423 -0
- package/tools/cache_resolver.py +1214 -0
- package/tools/check_env.py +426 -0
- package/tools/check_version_sync.py +256 -0
- package/tools/ci_healing_hook.py +126 -0
- package/tools/cli.py +1598 -0
- package/tools/config_decoupler.py +253 -0
- package/tools/contract_validator.py +141 -0
- package/tools/core/__init__.py +70 -0
- package/tools/core/adapters.py +431 -0
- package/tools/core/circuit_breaker.py +263 -0
- package/tools/core/cli_runtime.py +66 -0
- package/tools/core/file_lock.py +159 -0
- package/tools/core/i18n.py +394 -0
- package/tools/core/memory_bus.py +905 -0
- package/tools/core/process_supervisor.py +332 -0
- package/tools/core/telemetry.py +329 -0
- package/tools/count_tokens.py +1267 -0
- package/tools/create_mock_docx.py +104 -0
- package/tools/dashboard_generator.py +2419 -0
- package/tools/db_sandbox.py +675 -0
- package/tools/debt_harvester.py +237 -0
- package/tools/distill_log.py +161 -0
- package/tools/dspy_qa_signatures.py +356 -0
- package/tools/e2e_flow_prober.py +132 -0
- package/tools/export_postman_collection.py +945 -0
- package/tools/flaky_detector.py +389 -0
- package/tools/fsm_enforcer.py +450 -0
- package/tools/fsm_middleware.py +401 -0
- package/tools/fuzz_payloads.py +197 -0
- package/tools/generate_allure_report.py +88 -0
- package/tools/generate_api_matrix.py +193 -0
- package/tools/generate_jmx_plan.py +1322 -0
- package/tools/generate_sbom.py +252 -0
- package/tools/generate_tc_from_story.py +203 -0
- package/tools/generate_test_reports.py +133 -0
- package/tools/generate_tool_catalog.py +482 -0
- package/tools/gherkin_suite.py +758 -0
- package/tools/git_pre_commit_guard.py +298 -0
- package/tools/goldfish_review.py +366 -0
- package/tools/heal/__init__.py +28 -0
- package/tools/heal_pr_automator.py +220 -0
- package/tools/heuristic_locator_matcher.py +351 -0
- package/tools/hub_publisher.py +623 -0
- package/tools/humanize_linter.py +438 -0
- package/tools/infer_linter.py +977 -0
- package/tools/init_config.py +307 -0
- package/tools/interview_story.py +116 -0
- package/tools/jira_sync.py +566 -0
- package/tools/jtl_analyzer.py +474 -0
- package/tools/lint/__init__.py +30 -0
- package/tools/lint_ai_docs.py +374 -0
- package/tools/lookup_tc.py +165 -0
- package/tools/lookup_xpath.py +167 -0
- package/tools/matrix_sharder.py +148 -0
- package/tools/mcp/__init__.py +18 -0
- package/tools/mcp_docx_server.ps1 +13 -0
- package/tools/mcp_docx_server.py +851 -0
- package/tools/mcp_excel_server.ps1 +13 -0
- package/tools/mcp_excel_server.py +441 -0
- package/tools/mcp_server.py +724 -0
- package/tools/md_to_xlsx.py +327 -0
- package/tools/micro_mutator.py +887 -0
- package/tools/mipro_assertion_tuner.py +210 -0
- package/tools/network_mock_shield.py +311 -0
- package/tools/newman_analyzer.py +384 -0
- package/tools/omni_emitter.py +579 -0
- package/tools/omni_parser.py +450 -0
- package/tools/omni_transpiler.py +168 -0
- package/tools/openxml_guard.py +438 -0
- package/tools/output_formatter.py +182 -0
- package/tools/package_release.py +325 -0
- package/tools/perf/__init__.py +24 -0
- package/tools/pinpoint_failure.py +190 -0
- package/tools/project_state.py +171 -0
- package/tools/qa_event_stream.py +358 -0
- package/tools/repo_map.py +346 -0
- package/tools/report/__init__.py +32 -0
- package/tools/reversible_sandbox.py +344 -0
- package/tools/safety_firewall.py +437 -0
- package/tools/security_coverage_ledger.py +538 -0
- package/tools/security_scanner.py +229 -0
- package/tools/senior_code_review.py +393 -0
- package/tools/setup_project.py +770 -0
- package/tools/skill_collision_guard.py +304 -0
- package/tools/skill_profiles.py +217 -0
- package/tools/skill_vault.py +481 -0
- package/tools/skillspector.py +1278 -0
- package/tools/smart_visual_masker.py +132 -0
- package/tools/spec_drift_sentinel.py +438 -0
- package/tools/swe_qa_aci.py +369 -0
- package/tools/synapse_observer.py +485 -0
- package/tools/synapse_qa_bench.py +190 -0
- package/tools/sync_agent_rules.py +274 -0
- package/tools/telemetry_correlator.py +397 -0
- package/tools/template_excel_exporter.py +514 -0
- package/tools/templates/jmeter-distributed/README.md +54 -0
- package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
- package/tools/test_impact.py +419 -0
- package/tools/test_memory_os.py +462 -0
- package/tools/textgrad_mutation_optimizer.py +237 -0
- package/tools/tms_sync_bridge.py +834 -0
- package/tools/tot_exploratory_tester.py +239 -0
- package/tools/trace_data_flow.py +240 -0
- package/tools/traffic_session_converter.py +256 -0
- package/tools/trend_analytics.py +314 -0
- package/tools/ui_server.py +401 -0
- package/tools/universal_ir.py +488 -0
- package/tools/update_sentinel.py +383 -0
- package/tools/validate_groovy_scripts.py +173 -0
- package/tools/verify_all.py +1259 -0
- package/tools/visual_diff_canvas.py +143 -0
- package/tools/visual_som_helper.py +550 -0
- package/tools/watch_mode.py +308 -0
- package/tools/wcag_audit.py +239 -0
- package/tools/welcome_page.py +290 -0
|
@@ -0,0 +1,374 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Enterprise AI Documentation & Artifact Linter (Anti-Drift Guard v2.0)
|
|
4
|
+
---------------------------------------------------------------
|
|
5
|
+
Automatically cross-references AI skills, agent instructions, and markdown
|
|
6
|
+
documents against the actual repository files, classes, methods, and test cases.
|
|
7
|
+
|
|
8
|
+
Checks:
|
|
9
|
+
1. Page Class references: Matches against Keywords/pages/*.groovy.
|
|
10
|
+
2. Test Suite references: Matches against Test Suites/*.ts.
|
|
11
|
+
3. Tool script references: Matches against tools/*.
|
|
12
|
+
4. Test Case references: Matches against Test Cases/*.tc (and validates TC-1..259 range).
|
|
13
|
+
5. Method call references: Matches EnterpriseHelper.xxx() and BasePage.xxx() against real AST/regex methods.
|
|
14
|
+
|
|
15
|
+
Prevents AI agents from hallucinating nonexistent PageClasses, suites, tools, methods, or test cases.
|
|
16
|
+
Supports both Target Test Project mode and Hub Repository mode.
|
|
17
|
+
"""
|
|
18
|
+
|
|
19
|
+
import os
|
|
20
|
+
import sys
|
|
21
|
+
import glob
|
|
22
|
+
import re
|
|
23
|
+
|
|
24
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
25
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
26
|
+
try:
|
|
27
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
28
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
29
|
+
except Exception:
|
|
30
|
+
pass
|
|
31
|
+
|
|
32
|
+
GENERIC_PAGES = {
|
|
33
|
+
"WebPage", "CurrentPage", "LandingPage", "GitHubPage", "SamplePage",
|
|
34
|
+
"BasePage", "Page", "SinglePage", "MultiPage"
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
def extract_groovy_methods(file_path):
|
|
38
|
+
"""Extracts standard public/static methods from a Groovy class file."""
|
|
39
|
+
methods = set()
|
|
40
|
+
if not os.path.exists(file_path):
|
|
41
|
+
return methods
|
|
42
|
+
try:
|
|
43
|
+
with open(file_path, "r", encoding="utf-8", errors="ignore") as fp:
|
|
44
|
+
lines = fp.readlines()
|
|
45
|
+
method_pattern = re.compile(
|
|
46
|
+
r'^\s*(?:@\w+\s+)*(?:public|protected|private)?\s*(?:static\s+)?(?:final\s+)?'
|
|
47
|
+
r'(?:void|def|String|int|boolean|List[^\s]*|TestObject|WebDriver|[A-Za-z0-9_<>\[\]]+)\s+([a-z][a-zA-Z0-9_]*)\s*\('
|
|
48
|
+
)
|
|
49
|
+
for line in lines:
|
|
50
|
+
stripped = line.strip()
|
|
51
|
+
if stripped.startswith("//") or stripped.startswith("*"):
|
|
52
|
+
continue
|
|
53
|
+
m = method_pattern.search(line)
|
|
54
|
+
if m:
|
|
55
|
+
mname = m.group(1)
|
|
56
|
+
if mname not in {"if", "for", "while", "switch", "catch"}:
|
|
57
|
+
methods.add(mname)
|
|
58
|
+
except (OSError, UnicodeDecodeError) as err:
|
|
59
|
+
sys.stderr.write(f"Notice: Parse methods skipped for {file_path}: {err}\n")
|
|
60
|
+
return methods
|
|
61
|
+
|
|
62
|
+
def get_actual_entities(repo_root):
|
|
63
|
+
pages_dir = os.path.join(repo_root, "Keywords", "pages")
|
|
64
|
+
helpers_dir = os.path.join(repo_root, "Keywords", "helpers")
|
|
65
|
+
suites_dir = os.path.join(repo_root, "Test Suites")
|
|
66
|
+
cases_dir = os.path.join(repo_root, "Test Cases")
|
|
67
|
+
tools_dir = os.path.join(repo_root, "tools")
|
|
68
|
+
|
|
69
|
+
actual_pages = set()
|
|
70
|
+
class_methods = {}
|
|
71
|
+
|
|
72
|
+
if os.path.isdir(pages_dir):
|
|
73
|
+
for f in os.listdir(pages_dir):
|
|
74
|
+
if f.endswith(".groovy"):
|
|
75
|
+
pname = f[:-7]
|
|
76
|
+
actual_pages.add(pname)
|
|
77
|
+
class_methods[pname] = extract_groovy_methods(os.path.join(pages_dir, f))
|
|
78
|
+
|
|
79
|
+
if os.path.isdir(helpers_dir):
|
|
80
|
+
for f in os.listdir(helpers_dir):
|
|
81
|
+
if f.endswith(".groovy"):
|
|
82
|
+
hname = f[:-7]
|
|
83
|
+
class_methods[hname] = extract_groovy_methods(os.path.join(helpers_dir, f))
|
|
84
|
+
|
|
85
|
+
actual_suites = set()
|
|
86
|
+
if os.path.isdir(suites_dir):
|
|
87
|
+
for f in os.listdir(suites_dir):
|
|
88
|
+
if f.endswith(".ts"):
|
|
89
|
+
actual_suites.add(f[:-3])
|
|
90
|
+
|
|
91
|
+
actual_cases = set()
|
|
92
|
+
actual_tc_ids = set()
|
|
93
|
+
if os.path.isdir(cases_dir):
|
|
94
|
+
for f in os.listdir(cases_dir):
|
|
95
|
+
if f.endswith(".tc"):
|
|
96
|
+
base_name = f[:-3]
|
|
97
|
+
actual_cases.add(base_name)
|
|
98
|
+
m = re.match(r'(TC-\d+)', base_name)
|
|
99
|
+
if m:
|
|
100
|
+
actual_tc_ids.add(m.group(1))
|
|
101
|
+
|
|
102
|
+
actual_tools = set()
|
|
103
|
+
if os.path.isdir(tools_dir):
|
|
104
|
+
actual_tools.update(os.listdir(tools_dir))
|
|
105
|
+
# Always include Hub tools directory in decoupled architecture
|
|
106
|
+
hub_tools = os.path.abspath(os.path.dirname(__file__))
|
|
107
|
+
if os.path.isdir(hub_tools):
|
|
108
|
+
actual_tools.update(os.listdir(hub_tools))
|
|
109
|
+
|
|
110
|
+
return actual_pages, actual_suites, actual_cases, actual_tc_ids, actual_tools, class_methods
|
|
111
|
+
|
|
112
|
+
def find_doc_files(repo_root):
|
|
113
|
+
md_patterns = [
|
|
114
|
+
os.path.join(repo_root, ".agents", "**", "*.md"),
|
|
115
|
+
os.path.join(repo_root, "*.md"),
|
|
116
|
+
]
|
|
117
|
+
doc_files = []
|
|
118
|
+
for pattern in md_patterns:
|
|
119
|
+
for f in glob.glob(pattern, recursive=True):
|
|
120
|
+
rel = os.path.relpath(f, repo_root)
|
|
121
|
+
if any(ignored in rel for ignored in ("node_modules", ".git", "allure-results", "teamwork", "external_repos", "AUDIT_REPORT", "FINAL_REPORT")):
|
|
122
|
+
continue
|
|
123
|
+
doc_files.append(rel)
|
|
124
|
+
return sorted(doc_files)
|
|
125
|
+
|
|
126
|
+
def lint_docs(repo_root):
|
|
127
|
+
actual_pages, actual_suites, actual_cases, actual_tc_ids, actual_tools, class_methods = get_actual_entities(repo_root)
|
|
128
|
+
doc_files = find_doc_files(repo_root)
|
|
129
|
+
|
|
130
|
+
page_pattern = re.compile(r'\b([A-Z][A-Za-z0-9]+Page)\b')
|
|
131
|
+
suite_pattern = re.compile(r'(?:Test Suites/|-Suite\s+["\'](?:Test Suites/)?|--testSuitePath=["\'](?:Test Suites/)?)([A-Za-z0-9_]+)')
|
|
132
|
+
tool_pattern = re.compile(r'\btools/([a-zA-Z0-9_\-\.]+\.(?:py|sh|ps1|bat|js))\b')
|
|
133
|
+
tc_id_pattern = re.compile(r'\b(TC-\d+)\b')
|
|
134
|
+
tc_path_pattern = re.compile(r'Test Cases/([A-Za-z0-9_ \-\.\(\)]+?)(?:\.tc)?["\s\)]')
|
|
135
|
+
method_pattern = re.compile(r'\b(EnterpriseHelper|BasePage|[A-Z][a-zA-Z0-9]+Page)\.([a-z][a-zA-Z0-9_]+)\s*\(')
|
|
136
|
+
|
|
137
|
+
errors = []
|
|
138
|
+
warnings = []
|
|
139
|
+
|
|
140
|
+
# Ignored tool references (examples, output targets, artifacts)
|
|
141
|
+
ignored_tool_refs = {"api_matrix.json", "output.json", "report.json", "output.txt", "summary.json"}
|
|
142
|
+
|
|
143
|
+
# 6. Hub Mode Metadata & Count Synchronization (Anti-Drift Guard for Skills, Rules, Workflows)
|
|
144
|
+
manifest_path = os.path.join(repo_root, "skills_manifest.json")
|
|
145
|
+
skills_dir = os.path.join(repo_root, ".agents", "skills")
|
|
146
|
+
rules_dir = os.path.join(repo_root, ".agents", "rules")
|
|
147
|
+
workflows_dir = os.path.join(repo_root, ".agents", "workflows")
|
|
148
|
+
|
|
149
|
+
if os.path.exists(manifest_path) and os.path.isdir(skills_dir):
|
|
150
|
+
import json
|
|
151
|
+
try:
|
|
152
|
+
with open(manifest_path, "r", encoding="utf-8") as mf:
|
|
153
|
+
manifest_data = json.load(mf)
|
|
154
|
+
manifest_skill_ids = set(s.get("id") for s in manifest_data.get("skills", []))
|
|
155
|
+
actual_skill_dirs = set(
|
|
156
|
+
d for d in os.listdir(skills_dir)
|
|
157
|
+
if os.path.isdir(os.path.join(skills_dir, d))
|
|
158
|
+
)
|
|
159
|
+
unregistered = actual_skill_dirs - manifest_skill_ids
|
|
160
|
+
if unregistered:
|
|
161
|
+
errors.append(f"[skills_manifest.json] Skills on disk not in manifest: {sorted(unregistered)}")
|
|
162
|
+
ghost_manifest = manifest_skill_ids - actual_skill_dirs
|
|
163
|
+
if ghost_manifest:
|
|
164
|
+
errors.append(f"[skills_manifest.json] Skills in manifest missing on disk: {sorted(ghost_manifest)}")
|
|
165
|
+
|
|
166
|
+
total_declared = manifest_data.get("totalSkills", len(manifest_skill_ids))
|
|
167
|
+
if total_declared != len(actual_skill_dirs):
|
|
168
|
+
errors.append(f"[skills_manifest.json] totalSkills ({total_declared}) does not match actual count ({len(actual_skill_dirs)})")
|
|
169
|
+
|
|
170
|
+
if os.path.isdir(rules_dir):
|
|
171
|
+
actual_rules_count = len([f for f in os.listdir(rules_dir) if f.endswith(".md")])
|
|
172
|
+
else:
|
|
173
|
+
actual_rules_count = 0
|
|
174
|
+
|
|
175
|
+
if os.path.isdir(workflows_dir):
|
|
176
|
+
actual_workflows_count = len([f for f in os.listdir(workflows_dir) if f.endswith(".md")])
|
|
177
|
+
else:
|
|
178
|
+
actual_workflows_count = 0
|
|
179
|
+
|
|
180
|
+
readme_path = os.path.join(repo_root, "README.md")
|
|
181
|
+
if os.path.exists(readme_path):
|
|
182
|
+
with open(readme_path, "r", encoding="utf-8", errors="ignore") as rf:
|
|
183
|
+
readme_text = rf.read()
|
|
184
|
+
m_rules = re.search(r'\((\d+)\s+Core Rules\)', readme_text)
|
|
185
|
+
if m_rules and int(m_rules.group(1)) != actual_rules_count:
|
|
186
|
+
errors.append(f"[README.md] Documented Core Rules count ({m_rules.group(1)}) differs from actual rules on disk ({actual_rules_count})")
|
|
187
|
+
|
|
188
|
+
m_wf = re.search(r'\((\d+)\s+Workflows\)', readme_text)
|
|
189
|
+
if m_wf and int(m_wf.group(1)) != actual_workflows_count:
|
|
190
|
+
errors.append(f"[README.md] Documented Workflows count ({m_wf.group(1)}) differs from actual workflows on disk ({actual_workflows_count})")
|
|
191
|
+
|
|
192
|
+
skill_table_matches = re.findall(r'\|\s*\d+\s*\|\s*`([a-z0-9\-]+)`\s*\|', readme_text)
|
|
193
|
+
for sid in skill_table_matches:
|
|
194
|
+
if sid not in actual_skill_dirs:
|
|
195
|
+
errors.append(f"[README.md] Non-existent skill referenced in skills table: '{sid}'")
|
|
196
|
+
|
|
197
|
+
arch_path = os.path.join(repo_root, "docs", "ARCHITECTURE.md")
|
|
198
|
+
if os.path.exists(arch_path):
|
|
199
|
+
with open(arch_path, "r", encoding="utf-8", errors="ignore") as af:
|
|
200
|
+
arch_text = af.read()
|
|
201
|
+
m_arch_skills = re.search(r'Catalog\["(\d+)\s+Standardized Skills', arch_text)
|
|
202
|
+
if m_arch_skills and int(m_arch_skills.group(1)) != len(actual_skill_dirs):
|
|
203
|
+
errors.append(f"[ARCHITECTURE.md] Documented skills count ({m_arch_skills.group(1)}) differs from actual skills on disk ({len(actual_skill_dirs)})")
|
|
204
|
+
except Exception as e:
|
|
205
|
+
errors.append(f"Failed to validate skills_manifest.json: {e}")
|
|
206
|
+
|
|
207
|
+
for doc in doc_files:
|
|
208
|
+
full_path = os.path.join(repo_root, doc)
|
|
209
|
+
try:
|
|
210
|
+
with open(full_path, "r", encoding="utf-8", errors="ignore") as fp:
|
|
211
|
+
lines = fp.readlines()
|
|
212
|
+
except Exception as e:
|
|
213
|
+
errors.append(f"Cannot read {doc}: {e}")
|
|
214
|
+
continue
|
|
215
|
+
|
|
216
|
+
is_historical = "FINAL_REPORT.md" in doc or "POM_REFACTORING_PLAN.md" in doc
|
|
217
|
+
|
|
218
|
+
for line_no, line in enumerate(lines, 1):
|
|
219
|
+
# 1. Page Class Lint (Only strictly enforced if repository defines Page Classes in Keywords/pages)
|
|
220
|
+
if actual_pages:
|
|
221
|
+
for m in page_pattern.finditer(line):
|
|
222
|
+
pname = m.group(1)
|
|
223
|
+
if pname not in actual_pages and pname not in GENERIC_PAGES:
|
|
224
|
+
if is_historical:
|
|
225
|
+
continue
|
|
226
|
+
errors.append(f"[{doc}:{line_no}] Non-existent Page Class referenced: '{pname}' (Must be one of {sorted(actual_pages)})")
|
|
227
|
+
|
|
228
|
+
# 2. Test Suite Lint (Only strictly enforced if repository defines Test Suites)
|
|
229
|
+
if actual_suites:
|
|
230
|
+
for m in suite_pattern.finditer(line):
|
|
231
|
+
sname = m.group(1)
|
|
232
|
+
if "xxx" in sname.lower() or "example" in sname.lower():
|
|
233
|
+
continue
|
|
234
|
+
if is_historical:
|
|
235
|
+
continue
|
|
236
|
+
if sname not in actual_suites:
|
|
237
|
+
errors.append(f"[{doc}:{line_no}] Non-existent Test Suite referenced: '{sname}'")
|
|
238
|
+
|
|
239
|
+
# 3. Tool Script Lint (Enforced in both Hub and Target modes)
|
|
240
|
+
for m in tool_pattern.finditer(line):
|
|
241
|
+
tname = m.group(1)
|
|
242
|
+
if tname in ignored_tool_refs:
|
|
243
|
+
continue
|
|
244
|
+
if tname not in actual_tools:
|
|
245
|
+
errors.append(f"[{doc}:{line_no}] Non-existent tool script referenced: 'tools/{tname}'")
|
|
246
|
+
|
|
247
|
+
# 4. Test Case Validation (Only strictly enforced if repository defines Test Cases)
|
|
248
|
+
if actual_cases and not is_historical:
|
|
249
|
+
# 4a. Validate TC-xxx numeric range
|
|
250
|
+
for m in tc_id_pattern.finditer(line):
|
|
251
|
+
tcid = m.group(1)
|
|
252
|
+
num = int(tcid[3:])
|
|
253
|
+
if num < 1 or num > 259:
|
|
254
|
+
errors.append(f"[{doc}:{line_no}] Out-of-range Test Case ID referenced: '{tcid}' (Valid range: TC-1 to TC-259)")
|
|
255
|
+
|
|
256
|
+
# 4b. Validate full Test Cases/... paths
|
|
257
|
+
for m in tc_path_pattern.finditer(line):
|
|
258
|
+
tcname = m.group(1).strip()
|
|
259
|
+
if "xxx" in tcname.lower() or "*" in tcname or "example" in tcname.lower():
|
|
260
|
+
continue
|
|
261
|
+
if tcname.endswith(".tc"):
|
|
262
|
+
tcname = tcname[:-3]
|
|
263
|
+
if tcname not in actual_cases:
|
|
264
|
+
# Check prefix match
|
|
265
|
+
matching = [c for c in actual_cases if c.startswith(tcname)]
|
|
266
|
+
if not matching:
|
|
267
|
+
errors.append(f"[{doc}:{line_no}] Non-existent Test Case path referenced: 'Test Cases/{tcname}'")
|
|
268
|
+
|
|
269
|
+
# 5. Method Call Lint (Cross-checks Class.method() against Groovy AST/regex)
|
|
270
|
+
for m in method_pattern.finditer(line):
|
|
271
|
+
cname = m.group(1)
|
|
272
|
+
mname = m.group(2)
|
|
273
|
+
if "xxx" in mname.lower() or "example" in mname.lower():
|
|
274
|
+
continue
|
|
275
|
+
if cname in class_methods:
|
|
276
|
+
valid_methods = class_methods[cname]
|
|
277
|
+
# Also include inherited BasePage methods if it's a Page class
|
|
278
|
+
if cname != "BasePage" and "BasePage" in class_methods:
|
|
279
|
+
valid_methods = valid_methods.union(class_methods["BasePage"])
|
|
280
|
+
|
|
281
|
+
if mname not in valid_methods:
|
|
282
|
+
errors.append(f"[{doc}:{line_no}] Non-existent method referenced: '{cname}.{mname}()' (Class '{cname}' does not define this method)")
|
|
283
|
+
|
|
284
|
+
# 6. Documentation Metrics Consistency (Detects stale skill/tool/gate numbers)
|
|
285
|
+
metric_errors = check_doc_metrics_consistency(repo_root)
|
|
286
|
+
errors.extend(metric_errors)
|
|
287
|
+
|
|
288
|
+
# 7. Bilingual Documentation Parity (Ensures Vietnamese and English counterparts exist)
|
|
289
|
+
bilingual_pairs = [
|
|
290
|
+
("README.md", "README.en.md"),
|
|
291
|
+
(os.path.join("docs", "ARCHITECTURE.md"), os.path.join("docs", "ARCHITECTURE.en.md")),
|
|
292
|
+
]
|
|
293
|
+
for vi_rel, en_rel in bilingual_pairs:
|
|
294
|
+
vi_path = os.path.join(repo_root, vi_rel)
|
|
295
|
+
en_path = os.path.join(repo_root, en_rel)
|
|
296
|
+
if os.path.exists(vi_path) and not os.path.exists(en_path):
|
|
297
|
+
errors.append(f"Missing English bilingual documentation counterpart for {vi_rel}: expected {en_rel}")
|
|
298
|
+
elif not os.path.exists(vi_path) and os.path.exists(en_path):
|
|
299
|
+
errors.append(f"Missing Vietnamese bilingual documentation counterpart for {en_rel}: expected {vi_rel}")
|
|
300
|
+
|
|
301
|
+
return errors, warnings
|
|
302
|
+
|
|
303
|
+
|
|
304
|
+
def check_doc_metrics_consistency(repo_root):
|
|
305
|
+
"""Verifies that documented counts (skills, tools, DoD gates) accurately match disk."""
|
|
306
|
+
errors = []
|
|
307
|
+
skills_dir = os.path.join(repo_root, ".agents", "skills")
|
|
308
|
+
tools_dir = os.path.join(repo_root, "tools")
|
|
309
|
+
|
|
310
|
+
if not os.path.isdir(skills_dir) or not os.path.isdir(tools_dir):
|
|
311
|
+
return errors
|
|
312
|
+
|
|
313
|
+
skills_count = len([d for d in os.listdir(skills_dir) if os.path.isdir(os.path.join(skills_dir, d)) and os.path.exists(os.path.join(skills_dir, d, "SKILL.md"))])
|
|
314
|
+
tools_count = len([f for f in os.listdir(tools_dir) if f.endswith(".py") and f != "__init__.py"])
|
|
315
|
+
|
|
316
|
+
obsolete_patterns = [
|
|
317
|
+
(re.compile(r'\b(42|50)\s+(kỹ năng|skills?)\b', re.IGNORECASE), f"Obsolete skill count detected (real count: {skills_count})"),
|
|
318
|
+
(re.compile(r'\b(60|68)\s+(công cụ|tools?)\b', re.IGNORECASE), f"Obsolete tool count detected (real count: {tools_count})"),
|
|
319
|
+
(re.compile(r'\b(9|10)\s+Cổng\s+Chất\s+Lượng\b', re.IGNORECASE), "Obsolete gate count detected: must refer to 11 Cổng Chất Lượng DoD (Gate 0–10)"),
|
|
320
|
+
(re.compile(r'\b(9|10)\s+Quality\s+Gates\b', re.IGNORECASE), "Obsolete gate count detected: must refer to 11 Quality Gates DoD (Gate 0–10)"),
|
|
321
|
+
]
|
|
322
|
+
|
|
323
|
+
docs_to_check = [
|
|
324
|
+
os.path.join(repo_root, "README.md"),
|
|
325
|
+
os.path.join(repo_root, "README.en.md"),
|
|
326
|
+
os.path.join(repo_root, "docs", "ARCHITECTURE.md"),
|
|
327
|
+
os.path.join(repo_root, "docs", "CONTRIBUTING.md"),
|
|
328
|
+
]
|
|
329
|
+
|
|
330
|
+
for doc_path in docs_to_check:
|
|
331
|
+
if not os.path.exists(doc_path):
|
|
332
|
+
continue
|
|
333
|
+
rel_doc = os.path.relpath(doc_path, repo_root)
|
|
334
|
+
with open(doc_path, "r", encoding="utf-8", errors="ignore") as f:
|
|
335
|
+
for line_no, line in enumerate(f, 1):
|
|
336
|
+
for pattern, msg in obsolete_patterns:
|
|
337
|
+
if pattern.search(line):
|
|
338
|
+
errors.append(f"[{rel_doc}:{line_no}] {msg}: '{line.strip()}'")
|
|
339
|
+
|
|
340
|
+
return errors
|
|
341
|
+
|
|
342
|
+
def main():
|
|
343
|
+
import argparse
|
|
344
|
+
parser = argparse.ArgumentParser(description="Enterprise AI Documentation & Artifact Linter")
|
|
345
|
+
parser.add_argument("target", nargs="?", default=None, help="Path to repository root to lint")
|
|
346
|
+
parser.add_argument("--repo", default=None, help="Path to repository root to lint")
|
|
347
|
+
args = parser.parse_args()
|
|
348
|
+
|
|
349
|
+
target_path = args.repo or args.target
|
|
350
|
+
if target_path:
|
|
351
|
+
repo_root = os.path.abspath(target_path)
|
|
352
|
+
else:
|
|
353
|
+
repo_root = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
|
|
354
|
+
|
|
355
|
+
print(f"[AI-DOCS-LINT] Running Documentation & Artifact Linter on: {os.path.basename(repo_root)}")
|
|
356
|
+
errors, warnings = lint_docs(repo_root)
|
|
357
|
+
|
|
358
|
+
if warnings:
|
|
359
|
+
print(f"\n[WARN] {len(warnings)} Warnings:")
|
|
360
|
+
for w in warnings:
|
|
361
|
+
print(f" - {w}")
|
|
362
|
+
|
|
363
|
+
if errors:
|
|
364
|
+
print(f"\n[FAIL] {len(errors)} Lint Errors Found (Documentation Drift / Hallucination):")
|
|
365
|
+
for e in errors:
|
|
366
|
+
print(f" - {e}")
|
|
367
|
+
print("\n[BLOCKED] Verification failed: Please align documentation with real disk entities.")
|
|
368
|
+
return 1
|
|
369
|
+
else:
|
|
370
|
+
print("[PASS] All documented tools, PageClasses, Suites, and Method calls verified on disk.")
|
|
371
|
+
return 0
|
|
372
|
+
|
|
373
|
+
if __name__ == "__main__":
|
|
374
|
+
sys.exit(main())
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Enterprise QA: Fast Test Case Metadata Lookup (lookup_tc.py)
|
|
4
|
+
-------------------------------------------------------------
|
|
5
|
+
Fast lookup tool for Test Cases from project JSON testcase specifications.
|
|
6
|
+
Enables AI Agents to load a single targeted test case (<100 tokens)
|
|
7
|
+
instead of reading entire massive test suites (~45,000 tokens).
|
|
8
|
+
|
|
9
|
+
Multi-tier Resolution:
|
|
10
|
+
1. CLI Flag: python tools/lookup_tc.py <query> --file <path_to_json> (-f)
|
|
11
|
+
2. Environment variable: TC_DATA_FILE or TESTCASES_JSON
|
|
12
|
+
3. Automatic discovery: testcases.json, tc_index.json, test_cases.json...
|
|
13
|
+
4. Internal Hub archive fallback: archive/legacy_references/Enterprise_testcases.json
|
|
14
|
+
"""
|
|
15
|
+
|
|
16
|
+
import sys
|
|
17
|
+
import json
|
|
18
|
+
import os
|
|
19
|
+
import argparse
|
|
20
|
+
|
|
21
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
22
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
23
|
+
try:
|
|
24
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
25
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
26
|
+
except Exception:
|
|
27
|
+
pass
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
def resolve_json_path(cli_file=None):
|
|
31
|
+
"""Resolves Test Case JSON file path via precedence order."""
|
|
32
|
+
# 1. CLI flag
|
|
33
|
+
if cli_file:
|
|
34
|
+
if os.path.exists(cli_file):
|
|
35
|
+
return os.path.abspath(cli_file)
|
|
36
|
+
else:
|
|
37
|
+
print(f"⚠️ Warning: File specified via --file '{cli_file}' does not exist.")
|
|
38
|
+
|
|
39
|
+
# 2. Environment variable
|
|
40
|
+
env_file = os.environ.get("TC_DATA_FILE") or os.environ.get("TESTCASES_JSON")
|
|
41
|
+
if env_file and os.path.exists(env_file):
|
|
42
|
+
return os.path.abspath(env_file)
|
|
43
|
+
|
|
44
|
+
# 3. Automatic discovery in CWD and common directories
|
|
45
|
+
script_dir = os.path.dirname(os.path.abspath(__file__))
|
|
46
|
+
hub_root = os.path.abspath(os.path.join(script_dir, ".."))
|
|
47
|
+
cwd = os.getcwd()
|
|
48
|
+
|
|
49
|
+
search_dirs = [
|
|
50
|
+
cwd,
|
|
51
|
+
os.path.join(cwd, "references"),
|
|
52
|
+
os.path.join(cwd, "data"),
|
|
53
|
+
os.path.join(cwd, "tools"),
|
|
54
|
+
os.path.join(cwd, "docs"),
|
|
55
|
+
script_dir
|
|
56
|
+
]
|
|
57
|
+
|
|
58
|
+
candidate_names = [
|
|
59
|
+
"testcases.json",
|
|
60
|
+
"tc_index.json",
|
|
61
|
+
"Enterprise_testcases.json",
|
|
62
|
+
"test_cases.json",
|
|
63
|
+
"tc_matrix.json"
|
|
64
|
+
]
|
|
65
|
+
|
|
66
|
+
for d in search_dirs:
|
|
67
|
+
for name in candidate_names:
|
|
68
|
+
candidate = os.path.join(d, name)
|
|
69
|
+
if os.path.isfile(candidate):
|
|
70
|
+
return os.path.abspath(candidate)
|
|
71
|
+
|
|
72
|
+
# 4. Hub Archive fallback
|
|
73
|
+
for legacy_name in ["Enterprise_testcases.json", "dmit_testcases.json", "odp_testcases.json"]:
|
|
74
|
+
legacy_file = os.path.join(hub_root, "archive", "legacy_references", legacy_name)
|
|
75
|
+
if os.path.isfile(legacy_file):
|
|
76
|
+
return os.path.abspath(legacy_file)
|
|
77
|
+
|
|
78
|
+
return None
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
def normalize_testcase_data(raw_data):
|
|
82
|
+
"""Normalizes Test Case data across diverse JSON structures (list, dict, dict of dicts)."""
|
|
83
|
+
if isinstance(raw_data, list):
|
|
84
|
+
return raw_data
|
|
85
|
+
elif isinstance(raw_data, dict):
|
|
86
|
+
if "testcases" in raw_data and isinstance(raw_data["testcases"], list):
|
|
87
|
+
return raw_data["testcases"]
|
|
88
|
+
if "items" in raw_data and isinstance(raw_data["items"], list):
|
|
89
|
+
return raw_data["items"]
|
|
90
|
+
|
|
91
|
+
flat = []
|
|
92
|
+
for k, v in raw_data.items():
|
|
93
|
+
if isinstance(v, dict):
|
|
94
|
+
item = dict(v)
|
|
95
|
+
if "ID" not in item:
|
|
96
|
+
item["ID"] = k
|
|
97
|
+
flat.append(item)
|
|
98
|
+
else:
|
|
99
|
+
flat.append({"ID": k, "Name": str(v)})
|
|
100
|
+
return flat
|
|
101
|
+
return []
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
def main():
|
|
105
|
+
parser = argparse.ArgumentParser(description="Fast Test Case lookup from project JSON specifications")
|
|
106
|
+
parser.add_argument("query", help="Test Case ID (e.g., TC-132, 132) or search keyword")
|
|
107
|
+
parser.add_argument("-f", "--file", dest="file", help="Path to JSON file containing test cases")
|
|
108
|
+
args = parser.parse_args()
|
|
109
|
+
|
|
110
|
+
json_path = resolve_json_path(args.file)
|
|
111
|
+
|
|
112
|
+
if not json_path:
|
|
113
|
+
print("❌ Error: Test Case JSON data file not found.")
|
|
114
|
+
print("\n👉 Guidance to configure test case data for target project:")
|
|
115
|
+
print(" 1. Use CLI flag: python tools/lookup_tc.py <query> --file <path_to_testcases.json>")
|
|
116
|
+
print(" 2. Set environment variable: export TC_DATA_FILE='path/to/testcases.json' (or set TC_DATA_FILE=...)")
|
|
117
|
+
print(" 3. Place 'testcases.json' in project root or declare path in PROJECT_AI_GUIDE.md")
|
|
118
|
+
sys.exit(1)
|
|
119
|
+
|
|
120
|
+
try:
|
|
121
|
+
with open(json_path, "r", encoding="utf-8") as f:
|
|
122
|
+
raw_data = json.load(f)
|
|
123
|
+
except Exception as e:
|
|
124
|
+
print(f"❌ Error reading file '{json_path}': {e}")
|
|
125
|
+
sys.exit(1)
|
|
126
|
+
|
|
127
|
+
data = normalize_testcase_data(raw_data)
|
|
128
|
+
query = args.query.strip().lower()
|
|
129
|
+
|
|
130
|
+
exact_matches = []
|
|
131
|
+
fuzzy_matches = []
|
|
132
|
+
|
|
133
|
+
for tc in data:
|
|
134
|
+
tc_id = str(tc.get("ID") or tc.get("id") or tc.get("tc_id") or "").strip().lower()
|
|
135
|
+
tc_name = str(tc.get("Name") or tc.get("name") or tc.get("title") or "").strip().lower()
|
|
136
|
+
|
|
137
|
+
if query == tc_id or f"tc-{query}" == tc_id or f"tc_{query}" == tc_id:
|
|
138
|
+
exact_matches.append(tc)
|
|
139
|
+
elif query in tc_id or query in tc_name:
|
|
140
|
+
fuzzy_matches.append(tc)
|
|
141
|
+
|
|
142
|
+
matches = exact_matches if exact_matches else fuzzy_matches
|
|
143
|
+
|
|
144
|
+
if not matches:
|
|
145
|
+
print(f"No Test Cases found matching: '{args.query}' in file '{os.path.basename(json_path)}'")
|
|
146
|
+
sys.exit(0)
|
|
147
|
+
|
|
148
|
+
rel_source = os.path.relpath(json_path, os.getcwd()) if os.path.exists(json_path) else json_path
|
|
149
|
+
print(f"=== Found {len(matches)} Test Case(s) (Source: {rel_source}) ===")
|
|
150
|
+
for tc in matches[:5]:
|
|
151
|
+
tc_id = tc.get("ID") or tc.get("id") or "N/A"
|
|
152
|
+
tc_mod = tc.get("Module") or tc.get("module") or "GLOBAL"
|
|
153
|
+
tc_name = tc.get("Name") or tc.get("name") or tc.get("title") or "N/A"
|
|
154
|
+
tc_expected = tc.get("Expected") or tc.get("expected") or tc.get("expected_result") or "N/A"
|
|
155
|
+
tc_steps = tc.get("Steps") or tc.get("steps") or tc.get("description") or "N/A"
|
|
156
|
+
|
|
157
|
+
print(f"ID: {tc_id} | Module: {tc_mod}")
|
|
158
|
+
print(f"Name: {tc_name}")
|
|
159
|
+
print(f"Expected: {tc_expected}")
|
|
160
|
+
print(f"Steps:\n{tc_steps}")
|
|
161
|
+
print("-" * 50)
|
|
162
|
+
|
|
163
|
+
|
|
164
|
+
if __name__ == "__main__":
|
|
165
|
+
main()
|