@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.
- 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 +171 -0
- package/README.md +170 -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 +198 -0
- package/docs/ARCHITECTURE.md +199 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +174 -0
- package/docs/CLI_REFERENCE.md +176 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +118 -0
- package/docs/QUALITY_GATES.md +118 -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 +1358 -0
- package/docs/schemas/synapse.config.schema.json +86 -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 +31 -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 +2074 -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 +262 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +190 -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 +2403 -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 +306 -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 +725 -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 +1271 -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,450 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee98). All rights reserved.
|
|
3
|
+
# SPDX-License-Identifier: MIT
|
|
4
|
+
# Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
|
|
5
|
+
|
|
6
|
+
"""
|
|
7
|
+
Enterprise 5-Stage QA Multi-Agent Finite State Machine (FSM) Enforcer
|
|
8
|
+
---------------------------------------------------------------------
|
|
9
|
+
Converts the descriptive 5-stage markdown workflow into an executable,
|
|
10
|
+
tamper-evident state machine enforced by code:
|
|
11
|
+
Stage 1: DISCOVERY (Actor: live-explorer) -> Requires DOM/AOM discovery contract
|
|
12
|
+
Stage 2: CODE_SYNTHESIS (Actor: pom-crafter) -> Requires synthesized PageClass/script
|
|
13
|
+
Stage 3: HEADLESS_EXEC (Actor: test-runner) -> Requires test run evidence (JUnit/exitcode)
|
|
14
|
+
Stage 4: AUTOPSY_HEAL (Actor: failure-analyst) -> Requires autopsy triage (or PASSED waiver)
|
|
15
|
+
Stage 5: ACCEPTANCE_DOD (Actor: quality-gatekeeper) -> Requires 10 Quality Gates verification
|
|
16
|
+
|
|
17
|
+
Usage:
|
|
18
|
+
python tools/fsm_enforcer.py start --session-id "SESS_001"
|
|
19
|
+
python tools/fsm_enforcer.py advance --stage DISCOVERY --actor live-explorer --evidence '{"target": "login"}'
|
|
20
|
+
python tools/fsm_enforcer.py advance --stage CODE_SYNTHESIS --actor pom-crafter --evidence '{"files": ["LoginPage.ts"]}'
|
|
21
|
+
python tools/fsm_enforcer.py advance --stage HEADLESS_EXEC --actor test-runner --evidence '{"exit_code": 0}'
|
|
22
|
+
python tools/fsm_enforcer.py advance --stage AUTOPSY_HEAL --actor failure-analyst --evidence '{"status": "PASSED"}'
|
|
23
|
+
python tools/fsm_enforcer.py advance --stage ACCEPTANCE_DOD --actor quality-gatekeeper --evidence '{"gates": 11}'
|
|
24
|
+
python tools/fsm_enforcer.py verify-compliance
|
|
25
|
+
"""
|
|
26
|
+
|
|
27
|
+
import os
|
|
28
|
+
import sys
|
|
29
|
+
import json
|
|
30
|
+
import uuid
|
|
31
|
+
import hmac
|
|
32
|
+
import hashlib
|
|
33
|
+
import argparse
|
|
34
|
+
from datetime import datetime, timezone
|
|
35
|
+
from typing import Dict, Any, Optional, Tuple, List
|
|
36
|
+
|
|
37
|
+
STAGES_ORDER = [
|
|
38
|
+
"DISCOVERY",
|
|
39
|
+
"CODE_SYNTHESIS",
|
|
40
|
+
"HEADLESS_EXEC",
|
|
41
|
+
"AUTOPSY_HEAL",
|
|
42
|
+
"ACCEPTANCE_DOD"
|
|
43
|
+
]
|
|
44
|
+
|
|
45
|
+
STAGE_ACTORS = {
|
|
46
|
+
"DISCOVERY": ["live-explorer", "test-designer"],
|
|
47
|
+
"CODE_SYNTHESIS": ["pom-crafter", "api-engineer"],
|
|
48
|
+
"HEADLESS_EXEC": ["test-runner", "perf-engineer", "api-engineer"],
|
|
49
|
+
"AUTOPSY_HEAL": ["failure-analyst"],
|
|
50
|
+
"ACCEPTANCE_DOD": ["quality-gatekeeper"]
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
# Formal Stage Evidence Contract Schemas
|
|
54
|
+
STAGE_EVIDENCE_SCHEMAS = {
|
|
55
|
+
"DISCOVERY": {
|
|
56
|
+
"required_any": ["selectors", "locators", "target_url", "url", "target", "element", "elements", "dom_hash", "aom_nodes", "test_cases", "matrix", "story", "spec", "requirements"],
|
|
57
|
+
"description": "Requires DOM/AOM discovery contract (target URL, selectors, elements list, or requirement/test matrix specification)."
|
|
58
|
+
},
|
|
59
|
+
"CODE_SYNTHESIS": {
|
|
60
|
+
"required_any": ["pages", "files", "scripts", "page_classes", "file", "classes", "matrix", "api_matrix", "endpoints"],
|
|
61
|
+
"description": "Requires synthesized PageClass, API test matrix, or test script file list/signatures."
|
|
62
|
+
},
|
|
63
|
+
"HEADLESS_EXEC": {
|
|
64
|
+
"required_fields": ["exit_code"],
|
|
65
|
+
"field_types": {"exit_code": int},
|
|
66
|
+
"description": "Requires headless execution exit_code (int) and optional test summary/artifact."
|
|
67
|
+
},
|
|
68
|
+
"AUTOPSY_HEAL": {
|
|
69
|
+
"required_any": ["verdict", "status", "waiver", "root_cause", "patch", "triage", "action"],
|
|
70
|
+
"description": "Requires triage analysis, root_cause & patch, or waiver (e.g. PASSED_NO_HEAL_NEEDED)."
|
|
71
|
+
},
|
|
72
|
+
"ACCEPTANCE_DOD": {
|
|
73
|
+
"required_any": ["gates_passed", "gates", "verify_all_passed", "passed_gates", "summary"],
|
|
74
|
+
"description": "Requires 10 Quality Gates DoD verification evidence."
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
def validate_stage_evidence(stage: str, evidence: Dict[str, Any]) -> Tuple[bool, Optional[str]]:
|
|
80
|
+
"""Validates that stage evidence adheres to its formal data contract schema."""
|
|
81
|
+
if not isinstance(evidence, dict) or not evidence:
|
|
82
|
+
return False, f"Stage '{stage}' requires a non-empty evidence dictionary."
|
|
83
|
+
|
|
84
|
+
schema = STAGE_EVIDENCE_SCHEMAS.get(stage)
|
|
85
|
+
if not schema:
|
|
86
|
+
return True, None
|
|
87
|
+
|
|
88
|
+
if "required_fields" in schema:
|
|
89
|
+
for rf in schema["required_fields"]:
|
|
90
|
+
if rf not in evidence:
|
|
91
|
+
return False, f"Stage '{stage}' evidence missing mandatory field '{rf}'. {schema['description']}"
|
|
92
|
+
|
|
93
|
+
if "field_types" in schema:
|
|
94
|
+
for f, expected_type in schema["field_types"].items():
|
|
95
|
+
if f in evidence and not isinstance(evidence[f], expected_type):
|
|
96
|
+
return False, f"Stage '{stage}' evidence field '{f}' must be of type {expected_type.__name__}, got {type(evidence[f]).__name__}."
|
|
97
|
+
|
|
98
|
+
if "required_any" in schema:
|
|
99
|
+
has_any = any(k in evidence for k in schema["required_any"])
|
|
100
|
+
if not has_any:
|
|
101
|
+
return False, f"Stage '{stage}' evidence missing required context. Must include at least one of: {schema['required_any']}. {schema['description']}"
|
|
102
|
+
|
|
103
|
+
return True, None
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
def compute_proof_token(session_id: str, stage: str, actor: str, evidence: Dict[str, Any], timestamp: str) -> Tuple[str, str]:
|
|
107
|
+
"""
|
|
108
|
+
Computes a tamper-evident cryptographic HMAC-SHA256 proof token for stage signoff.
|
|
109
|
+
Returns (proof_token, evidence_hash).
|
|
110
|
+
"""
|
|
111
|
+
canonical_ev = json.dumps(evidence, sort_keys=True, separators=(",", ":"))
|
|
112
|
+
ev_hash = hashlib.sha256(canonical_ev.encode("utf-8")).hexdigest()
|
|
113
|
+
payload = f"{session_id}:{stage}:{actor}:{ev_hash}:{timestamp}"
|
|
114
|
+
token_sig = hmac.new(session_id.encode("utf-8"), payload.encode("utf-8"), hashlib.sha256).hexdigest()[:24]
|
|
115
|
+
token = f"proof_v2_{stage.lower()}_{token_sig}"
|
|
116
|
+
return token, ev_hash
|
|
117
|
+
|
|
118
|
+
|
|
119
|
+
def verify_proof_token(session_id: str, stage: str, actor: str, evidence: Dict[str, Any], timestamp: str, token: str) -> bool:
|
|
120
|
+
"""Verifies that a proof token matches the evidence payload and has not been forged or tampered with."""
|
|
121
|
+
expected_token, _ = compute_proof_token(session_id, stage, actor, evidence, timestamp)
|
|
122
|
+
return hmac.compare_digest(token, expected_token)
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
def compute_artifact_hashes(artifacts: List[str], base_dir: Optional[str] = None) -> Dict[str, str]:
|
|
126
|
+
"""
|
|
127
|
+
Computes cryptographic SHA-256 digests for physical artifact files on disk.
|
|
128
|
+
Returns mapping of {artifact_path: sha256_hexdigest}.
|
|
129
|
+
"""
|
|
130
|
+
hashes = {}
|
|
131
|
+
for item in artifacts:
|
|
132
|
+
target = os.path.join(base_dir, item) if base_dir and not os.path.isabs(item) else item
|
|
133
|
+
if os.path.isfile(target):
|
|
134
|
+
try:
|
|
135
|
+
with open(target, "rb") as f:
|
|
136
|
+
file_bytes = f.read()
|
|
137
|
+
hashes[item] = hashlib.sha256(file_bytes).hexdigest()
|
|
138
|
+
except OSError as err:
|
|
139
|
+
_ = err
|
|
140
|
+
return hashes
|
|
141
|
+
|
|
142
|
+
|
|
143
|
+
def verify_artifact_integrity(session_state: Dict[str, Any], base_dir: Optional[str] = None) -> Tuple[bool, List[str]]:
|
|
144
|
+
"""
|
|
145
|
+
Verifies that all physical artifact files referenced in the session match their recorded SHA-256 hashes.
|
|
146
|
+
Returns (all_intact: bool, violations: List[str]).
|
|
147
|
+
"""
|
|
148
|
+
violations = []
|
|
149
|
+
completed = session_state.get("completed_stages", {})
|
|
150
|
+
for stage_name, record in completed.items():
|
|
151
|
+
evidence = record.get("evidence", {})
|
|
152
|
+
recorded_hashes = evidence.get("artifact_hashes", {})
|
|
153
|
+
for item, recorded_hash in recorded_hashes.items():
|
|
154
|
+
target = os.path.join(base_dir, item) if base_dir and not os.path.isabs(item) else item
|
|
155
|
+
if not os.path.isfile(target):
|
|
156
|
+
violations.append(f"Stage '{stage_name}' artifact missing on disk: {item}")
|
|
157
|
+
continue
|
|
158
|
+
try:
|
|
159
|
+
with open(target, "rb") as f:
|
|
160
|
+
current_bytes = f.read()
|
|
161
|
+
current_hash = hashlib.sha256(current_bytes).hexdigest()
|
|
162
|
+
if current_hash != recorded_hash:
|
|
163
|
+
violations.append(f"Stage '{stage_name}' artifact tampered on disk: {item} (expected {recorded_hash[:12]}..., got {current_hash[:12]}...)")
|
|
164
|
+
except OSError as err:
|
|
165
|
+
violations.append(f"Stage '{stage_name}' failed to read artifact: {item} ({err})")
|
|
166
|
+
return len(violations) == 0, violations
|
|
167
|
+
|
|
168
|
+
|
|
169
|
+
class FsmEnforcer:
|
|
170
|
+
"""Executable finite state machine enforcing strict multi-agent workflow compliance."""
|
|
171
|
+
|
|
172
|
+
def __init__(self, state_file: Optional[str] = None):
|
|
173
|
+
if state_file:
|
|
174
|
+
self.state_file = state_file
|
|
175
|
+
else:
|
|
176
|
+
repo_root = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
|
|
177
|
+
self.state_file = os.path.join(repo_root, ".agent_memory", "fsm_session.json")
|
|
178
|
+
|
|
179
|
+
os.makedirs(os.path.dirname(os.path.abspath(self.state_file)), exist_ok=True)
|
|
180
|
+
self._load_state()
|
|
181
|
+
|
|
182
|
+
def _load_state(self):
|
|
183
|
+
if os.path.exists(self.state_file):
|
|
184
|
+
try:
|
|
185
|
+
with open(self.state_file, "r", encoding="utf-8") as f:
|
|
186
|
+
self.state = json.load(f)
|
|
187
|
+
except Exception:
|
|
188
|
+
self.state = self._empty_state()
|
|
189
|
+
else:
|
|
190
|
+
self.state = self._empty_state()
|
|
191
|
+
|
|
192
|
+
def _save_state(self):
|
|
193
|
+
tmp_file = f"{self.state_file}.{uuid.uuid4().hex[:8]}.tmp"
|
|
194
|
+
with open(tmp_file, "w", encoding="utf-8") as f:
|
|
195
|
+
json.dump(self.state, f, indent=2, ensure_ascii=False)
|
|
196
|
+
os.replace(tmp_file, self.state_file)
|
|
197
|
+
|
|
198
|
+
def _empty_state(self) -> Dict[str, Any]:
|
|
199
|
+
return {
|
|
200
|
+
"session_id": f"sess_{uuid.uuid4().hex[:8]}",
|
|
201
|
+
"current_stage": None,
|
|
202
|
+
"stage_history": [],
|
|
203
|
+
"completed_stages": {},
|
|
204
|
+
"status": "INITIALIZED",
|
|
205
|
+
"created_at": datetime.now(timezone.utc).isoformat(),
|
|
206
|
+
"updated_at": datetime.now(timezone.utc).isoformat()
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
def start_session(self, session_id: Optional[str] = None) -> Dict[str, Any]:
|
|
210
|
+
"""Initializes a new workflow session."""
|
|
211
|
+
self.state = self._empty_state()
|
|
212
|
+
if session_id:
|
|
213
|
+
self.state["session_id"] = session_id
|
|
214
|
+
self.state["status"] = "IN_PROGRESS"
|
|
215
|
+
self._save_state()
|
|
216
|
+
return {
|
|
217
|
+
"status": "PASS",
|
|
218
|
+
"session_id": self.state["session_id"],
|
|
219
|
+
"current_stage": None,
|
|
220
|
+
"next_required_stage": STAGES_ORDER[0]
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
def advance_stage(self, stage: str, actor: str, evidence: Dict[str, Any]) -> Dict[str, Any]:
|
|
224
|
+
"""Advances workflow to the specified stage with evidence validation."""
|
|
225
|
+
self._load_state()
|
|
226
|
+
stage_upper = stage.upper().strip()
|
|
227
|
+
if stage_upper not in STAGES_ORDER:
|
|
228
|
+
return {
|
|
229
|
+
"status": "REJECTED",
|
|
230
|
+
"error": f"Invalid stage '{stage}'. Must be one of: {STAGES_ORDER}"
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
target_idx = STAGES_ORDER.index(stage_upper)
|
|
234
|
+
completed = self.state.get("completed_stages", {})
|
|
235
|
+
|
|
236
|
+
# 1. Enforce strict sequential order (cannot jump stages)
|
|
237
|
+
for prev_idx in range(target_idx):
|
|
238
|
+
prev_stage = STAGES_ORDER[prev_idx]
|
|
239
|
+
if prev_stage not in completed:
|
|
240
|
+
return {
|
|
241
|
+
"status": "REJECTED",
|
|
242
|
+
"error": f"Cannot transition to stage '{stage_upper}'. Preceding stage '{prev_stage}' has not been completed."
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
# 2. Validate actor authorization
|
|
246
|
+
allowed_actors = STAGE_ACTORS.get(stage_upper, [])
|
|
247
|
+
if actor not in allowed_actors:
|
|
248
|
+
return {
|
|
249
|
+
"status": "REJECTED",
|
|
250
|
+
"error": f"Actor '{actor}' is not authorized to sign off on stage '{stage_upper}'. Required: {allowed_actors}"
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
# 3. Evidence contract schema validation
|
|
254
|
+
valid, schema_err = validate_stage_evidence(stage_upper, evidence)
|
|
255
|
+
if not valid:
|
|
256
|
+
return {
|
|
257
|
+
"status": "REJECTED",
|
|
258
|
+
"error": schema_err
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
# 4. Automatic Physical Artifact SHA-256 Hashing
|
|
262
|
+
artifact_candidates = []
|
|
263
|
+
for key in ["files", "scripts", "pages", "page_classes", "artifacts"]:
|
|
264
|
+
val = evidence.get(key)
|
|
265
|
+
if isinstance(val, list):
|
|
266
|
+
artifact_candidates.extend([str(v) for v in val if isinstance(v, str)])
|
|
267
|
+
elif isinstance(val, str):
|
|
268
|
+
artifact_candidates.append(val)
|
|
269
|
+
if "file" in evidence and isinstance(evidence["file"], str):
|
|
270
|
+
artifact_candidates.append(evidence["file"])
|
|
271
|
+
|
|
272
|
+
if artifact_candidates:
|
|
273
|
+
repo_root = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
|
|
274
|
+
artifact_hashes = compute_artifact_hashes(artifact_candidates, base_dir=repo_root)
|
|
275
|
+
if artifact_hashes:
|
|
276
|
+
evidence["artifact_hashes"] = artifact_hashes
|
|
277
|
+
|
|
278
|
+
now_iso = datetime.now(timezone.utc).isoformat()
|
|
279
|
+
proof_token, ev_hash = compute_proof_token(
|
|
280
|
+
self.state["session_id"],
|
|
281
|
+
stage_upper,
|
|
282
|
+
actor,
|
|
283
|
+
evidence,
|
|
284
|
+
now_iso
|
|
285
|
+
)
|
|
286
|
+
|
|
287
|
+
record = {
|
|
288
|
+
"stage": stage_upper,
|
|
289
|
+
"actor": actor,
|
|
290
|
+
"sequence": len(self.state["stage_history"]) + 1,
|
|
291
|
+
"proof_token": proof_token,
|
|
292
|
+
"evidence_hash": ev_hash,
|
|
293
|
+
"evidence": evidence,
|
|
294
|
+
"timestamp": now_iso
|
|
295
|
+
}
|
|
296
|
+
|
|
297
|
+
self.state["completed_stages"][stage_upper] = record
|
|
298
|
+
self.state["stage_history"].append(record)
|
|
299
|
+
self.state["current_stage"] = stage_upper
|
|
300
|
+
self.state["updated_at"] = now_iso
|
|
301
|
+
|
|
302
|
+
if len(self.state["completed_stages"]) == len(STAGES_ORDER):
|
|
303
|
+
self.state["status"] = "COMPLETED"
|
|
304
|
+
|
|
305
|
+
self._save_state()
|
|
306
|
+
|
|
307
|
+
next_idx = target_idx + 1
|
|
308
|
+
next_stage = STAGES_ORDER[next_idx] if next_idx < len(STAGES_ORDER) else None
|
|
309
|
+
|
|
310
|
+
return {
|
|
311
|
+
"status": "PASS",
|
|
312
|
+
"session_id": self.state["session_id"],
|
|
313
|
+
"stage_advanced": stage_upper,
|
|
314
|
+
"proof_token": proof_token,
|
|
315
|
+
"next_required_stage": next_stage,
|
|
316
|
+
"workflow_completed": (self.state["status"] == "COMPLETED")
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
def verify_compliance(self) -> Dict[str, Any]:
|
|
320
|
+
"""Audits workflow session to verify if task definition of done is legally satisfied."""
|
|
321
|
+
self._load_state()
|
|
322
|
+
completed = self.state.get("completed_stages", {})
|
|
323
|
+
missing = [s for s in STAGES_ORDER if s not in completed]
|
|
324
|
+
|
|
325
|
+
if missing:
|
|
326
|
+
return {
|
|
327
|
+
"status": "BLOCKED",
|
|
328
|
+
"compliant": False,
|
|
329
|
+
"session_id": self.state["session_id"],
|
|
330
|
+
"missing_stages": missing,
|
|
331
|
+
"completed_count": f"{len(completed)}/{len(STAGES_ORDER)}",
|
|
332
|
+
"error": f"Workflow is incomplete! Missing stages: {missing}"
|
|
333
|
+
}
|
|
334
|
+
|
|
335
|
+
# Cryptographic verification of all stage proof tokens
|
|
336
|
+
tampered_stages = []
|
|
337
|
+
for s in STAGES_ORDER:
|
|
338
|
+
rec = completed[s]
|
|
339
|
+
token = rec.get("proof_token", "")
|
|
340
|
+
if token.startswith("proof_v2_"):
|
|
341
|
+
is_valid = verify_proof_token(
|
|
342
|
+
self.state["session_id"],
|
|
343
|
+
s,
|
|
344
|
+
rec.get("actor", ""),
|
|
345
|
+
rec.get("evidence", {}),
|
|
346
|
+
rec.get("timestamp", ""),
|
|
347
|
+
token
|
|
348
|
+
)
|
|
349
|
+
if not is_valid:
|
|
350
|
+
tampered_stages.append(s)
|
|
351
|
+
|
|
352
|
+
if tampered_stages:
|
|
353
|
+
return {
|
|
354
|
+
"status": "BLOCKED",
|
|
355
|
+
"compliant": False,
|
|
356
|
+
"session_id": self.state["session_id"],
|
|
357
|
+
"error": f"Cryptographic integrity verification failed! Proof tokens for stages {tampered_stages} do not match evidence.",
|
|
358
|
+
"tampered_stages": tampered_stages
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
# Physical artifact integrity verification
|
|
362
|
+
repo_root = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
|
|
363
|
+
artifacts_ok, artifact_violations = verify_artifact_integrity(self.state, base_dir=repo_root)
|
|
364
|
+
if not artifacts_ok:
|
|
365
|
+
return {
|
|
366
|
+
"status": "BLOCKED",
|
|
367
|
+
"compliant": False,
|
|
368
|
+
"session_id": self.state["session_id"],
|
|
369
|
+
"error": f"Artifact integrity verification failed! {len(artifact_violations)} violation(s) detected.",
|
|
370
|
+
"artifact_violations": artifact_violations
|
|
371
|
+
}
|
|
372
|
+
|
|
373
|
+
return {
|
|
374
|
+
"status": "PASS",
|
|
375
|
+
"compliant": True,
|
|
376
|
+
"session_id": self.state["session_id"],
|
|
377
|
+
"total_stages": len(STAGES_ORDER),
|
|
378
|
+
"proof_tokens": {s: completed[s]["proof_token"] for s in STAGES_ORDER},
|
|
379
|
+
"summary": "100% 5-Stage FSM workflow verified with valid cryptographic proof tokens."
|
|
380
|
+
}
|
|
381
|
+
|
|
382
|
+
def get_status(self) -> Dict[str, Any]:
|
|
383
|
+
"""Returns current FSM status."""
|
|
384
|
+
self._load_state()
|
|
385
|
+
completed = self.state.get("completed_stages", {})
|
|
386
|
+
return {
|
|
387
|
+
"session_id": self.state["session_id"],
|
|
388
|
+
"status": self.state["status"],
|
|
389
|
+
"current_stage": self.state.get("current_stage"),
|
|
390
|
+
"completed_stages": list(completed.keys()),
|
|
391
|
+
"progress_pct": round((len(completed) / len(STAGES_ORDER)) * 100.0, 1),
|
|
392
|
+
"history_count": len(self.state.get("stage_history", []))
|
|
393
|
+
}
|
|
394
|
+
|
|
395
|
+
|
|
396
|
+
def main():
|
|
397
|
+
parser = argparse.ArgumentParser(description="Enterprise 5-Stage QA Multi-Agent FSM Enforcer")
|
|
398
|
+
subparsers = parser.add_subparsers(dest="subcommand", help="FSM subcommand to run")
|
|
399
|
+
|
|
400
|
+
# start
|
|
401
|
+
sp_start = subparsers.add_parser("start", help="Start new FSM session")
|
|
402
|
+
sp_start.add_argument("--session-id", help="Optional custom session ID")
|
|
403
|
+
|
|
404
|
+
# advance
|
|
405
|
+
sp_adv = subparsers.add_parser("advance", help="Advance workflow stage")
|
|
406
|
+
sp_adv.add_argument("--stage", required=True, choices=STAGES_ORDER, help="Target stage")
|
|
407
|
+
sp_adv.add_argument("--actor", required=True, help="Actor role submitting evidence")
|
|
408
|
+
sp_adv.add_argument("--evidence", required=True, help="JSON string containing stage evidence")
|
|
409
|
+
|
|
410
|
+
# verify-compliance
|
|
411
|
+
subparsers.add_parser("verify-compliance", help="Verify full workflow compliance before DoD closure")
|
|
412
|
+
|
|
413
|
+
# status
|
|
414
|
+
subparsers.add_parser("status", help="Display current FSM status")
|
|
415
|
+
|
|
416
|
+
args = parser.parse_args()
|
|
417
|
+
enforcer = FsmEnforcer()
|
|
418
|
+
|
|
419
|
+
if args.subcommand == "start":
|
|
420
|
+
res = enforcer.start_session(args.session_id)
|
|
421
|
+
print(json.dumps(res, indent=2))
|
|
422
|
+
sys.exit(0)
|
|
423
|
+
|
|
424
|
+
elif args.subcommand == "advance":
|
|
425
|
+
try:
|
|
426
|
+
ev = json.loads(args.evidence)
|
|
427
|
+
except Exception as e:
|
|
428
|
+
print(json.dumps({"status": "REJECTED", "error": f"Invalid JSON in evidence: {e}"}, indent=2))
|
|
429
|
+
sys.exit(1)
|
|
430
|
+
res = enforcer.advance_stage(args.stage, args.actor, ev)
|
|
431
|
+
print(json.dumps(res, indent=2))
|
|
432
|
+
sys.exit(0 if res["status"] == "PASS" else 1)
|
|
433
|
+
|
|
434
|
+
elif args.subcommand == "verify-compliance":
|
|
435
|
+
res = enforcer.verify_compliance()
|
|
436
|
+
print(json.dumps(res, indent=2))
|
|
437
|
+
sys.exit(0 if res["status"] == "PASS" else 1)
|
|
438
|
+
|
|
439
|
+
elif args.subcommand == "status":
|
|
440
|
+
res = enforcer.get_status()
|
|
441
|
+
print(json.dumps(res, indent=2))
|
|
442
|
+
sys.exit(0)
|
|
443
|
+
|
|
444
|
+
else:
|
|
445
|
+
parser.print_help()
|
|
446
|
+
sys.exit(1)
|
|
447
|
+
|
|
448
|
+
|
|
449
|
+
if __name__ == "__main__":
|
|
450
|
+
main()
|