@teevee98/synapse-hub 0.0.0-stage → 3.8.3

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 (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +171 -0
  190. package/README.md +170 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +198 -0
  196. package/docs/ARCHITECTURE.md +199 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +174 -0
  200. package/docs/CLI_REFERENCE.md +176 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +118 -0
  206. package/docs/QUALITY_GATES.md +118 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1358 -0
  212. package/docs/schemas/synapse.config.schema.json +86 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +31 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2074 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +262 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +190 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2403 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +306 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +725 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1271 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. 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|11)\s+Cổng\s+Chất\s+Lượng\b', re.IGNORECASE), "Obsolete gate count detected: must refer to 10 Cổng Chất Lượng DoD (Gate 1–10)"),
320
+ (re.compile(r'\b(9|11)\s+Quality\s+Gates\b', re.IGNORECASE), "Obsolete gate count detected: must refer to 10 Quality Gates DoD (Gate 1–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()