devsquad 4.5.2__tar.gz → 4.5.5__tar.gz

{devsquad-4.5.2 → devsquad-4.5.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devsquad
-Version: 4.5.2
+Version: 4.5.5
 Summary: Production-Ready Multi-Role AI Task Orchestrator
 Author-email: DevSquad Team <devsquad@example.com>
 License: MIT
@@ -96,14 +96,14 @@ Dynamic: license-file
 <p align="center">
   <strong>🎯 把「单个 AI 助手」升级成「7 人 AI 专业团队」</strong>
   <br>
-  <em>One task → Multi-role AI collaboration → One conclusion | V4.5.2 (Approval Gate + Connector Framework + anti-ghost E2E) | V4.5.0 (cross-session continuity + protocol-native skills) | V4.4.0 (5 enhancement modules)</em>
+  <em>One task → Multi-role AI collaboration → One conclusion | V4.5.5 (Module Fiber + Coeffect: 6-state FSM + topological activation + modules CLI) | V4.5.3 (Artifacts + Effect — ArtifactStore + DispatchEffect + EffectRegistry + Audit CLI) | V4.5.2 (Experience polish: MOKA + Metrics + GitLab + Doctor + BackendConfig) | V4.5.0 (cross-session continuity + protocol-native skills) | V4.4.0 (5 enhancement modules)</em>
 </p>
 
 <p align="center">
   <img alt="Python" src="https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white" />
   <img alt="License" src="https://img.shields.io/badge/License-MIT-green" />
-  <img alt="Tests" src="https://img.shields.io/badge/Tests-8392%2B%20passing-brightgreen" />
-  <img alt="Version" src="https://img.shields.io/badge/V4.5.2-success" />
+  <img alt="Tests" src="https://img.shields.io/badge/Tests-8996%2B%20passing-brightgreen" />
+  <img alt="Version" src="https://img.shields.io/badge/V4.5.5-success" />
   <img alt="CI" src="https://img.shields.io/badge/CI-GitHub_Actions-blue?logo=githubactions" />
   <img alt="Quality" src="https://img.shields.io/badge/Code%20Quality-4.3%2F5%20%E2%98%85%E2%98%85%E2%98%85%E2%98%85%E2%98%86-blue" />
   <img alt="Security" src="https://img.shields.io/badge/Security-5%2F5%20%E2%98%85%E2%98%85%E2%98%85%E2%98%85%E2%98%85-success" />
@@ -157,7 +157,7 @@ devsquad run "设计一个安全的用户认证系统" --roles architect,securit
 | 复杂系统设计（需要多视角） | **DevSquad 多角色协作** 🎯 |
 | 生产环境自动化流程 | **DevSquad + REST API + Dashboard** 🎯 |
 
-📚 **想深入了解？** → [完整快速入门指南](QUICKSTART.md) | [187+ 模块详细参考](SKILL.md)
+📚 **想深入了解？** → [完整快速入门指南](QUICKSTART.md) | [193 模块详细参考](SKILL.md)
 
 ---
 
@@ -235,7 +235,7 @@ Every new module includes `_call_counter` mechanism + E2E anti_ghost test + CI `
 - **V4.0.0 P3-1 Autonomous**: plan → dev → verify → fix 4-stage autonomous iteration
 - **V4.0.0 P3-2 Plugin Hot-Loading**: 3 loading paths + path traversal 3-layer protection + reload rollback
 
-8392+ tests passing (CI authoritative).
+8996+ tests passing (CI authoritative).
 
 ---
 

{devsquad-4.5.2 → devsquad-4.5.5}/README.md

@@ -3,14 +3,14 @@
 <p align="center">
   <strong>🎯 把「单个 AI 助手」升级成「7 人 AI 专业团队」</strong>
   <br>
-  <em>One task → Multi-role AI collaboration → One conclusion | V4.5.2 (Approval Gate + Connector Framework + anti-ghost E2E) | V4.5.0 (cross-session continuity + protocol-native skills) | V4.4.0 (5 enhancement modules)</em>
+  <em>One task → Multi-role AI collaboration → One conclusion | V4.5.5 (Module Fiber + Coeffect: 6-state FSM + topological activation + modules CLI) | V4.5.3 (Artifacts + Effect — ArtifactStore + DispatchEffect + EffectRegistry + Audit CLI) | V4.5.2 (Experience polish: MOKA + Metrics + GitLab + Doctor + BackendConfig) | V4.5.0 (cross-session continuity + protocol-native skills) | V4.4.0 (5 enhancement modules)</em>
 </p>
 
 <p align="center">
   <img alt="Python" src="https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white" />
   <img alt="License" src="https://img.shields.io/badge/License-MIT-green" />
-  <img alt="Tests" src="https://img.shields.io/badge/Tests-8392%2B%20passing-brightgreen" />
-  <img alt="Version" src="https://img.shields.io/badge/V4.5.2-success" />
+  <img alt="Tests" src="https://img.shields.io/badge/Tests-8996%2B%20passing-brightgreen" />
+  <img alt="Version" src="https://img.shields.io/badge/V4.5.5-success" />
   <img alt="CI" src="https://img.shields.io/badge/CI-GitHub_Actions-blue?logo=githubactions" />
   <img alt="Quality" src="https://img.shields.io/badge/Code%20Quality-4.3%2F5%20%E2%98%85%E2%98%85%E2%98%85%E2%98%85%E2%98%86-blue" />
   <img alt="Security" src="https://img.shields.io/badge/Security-5%2F5%20%E2%98%85%E2%98%85%E2%98%85%E2%98%85%E2%98%85-success" />
@@ -64,7 +64,7 @@ devsquad run "设计一个安全的用户认证系统" --roles architect,securit
 | 复杂系统设计（需要多视角） | **DevSquad 多角色协作** 🎯 |
 | 生产环境自动化流程 | **DevSquad + REST API + Dashboard** 🎯 |
 
-📚 **想深入了解？** → [完整快速入门指南](QUICKSTART.md) | [187+ 模块详细参考](SKILL.md)
+📚 **想深入了解？** → [完整快速入门指南](QUICKSTART.md) | [193 模块详细参考](SKILL.md)
 
 ---
 
@@ -142,7 +142,7 @@ Every new module includes `_call_counter` mechanism + E2E anti_ghost test + CI `
 - **V4.0.0 P3-1 Autonomous**: plan → dev → verify → fix 4-stage autonomous iteration
 - **V4.0.0 P3-2 Plugin Hot-Loading**: 3 loading paths + path traversal 3-layer protection + reload rollback
 
-8392+ tests passing (CI authoritative).
+8996+ tests passing (CI authoritative).
 
 ---
 

{devsquad-4.5.2 → devsquad-4.5.5}/devsquad.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devsquad
-Version: 4.5.2
+Version: 4.5.5
 Summary: Production-Ready Multi-Role AI Task Orchestrator
 Author-email: DevSquad Team <devsquad@example.com>
 License: MIT
@@ -96,14 +96,14 @@ Dynamic: license-file
 <p align="center">
   <strong>🎯 把「单个 AI 助手」升级成「7 人 AI 专业团队」</strong>
   <br>
-  <em>One task → Multi-role AI collaboration → One conclusion | V4.5.2 (Approval Gate + Connector Framework + anti-ghost E2E) | V4.5.0 (cross-session continuity + protocol-native skills) | V4.4.0 (5 enhancement modules)</em>
+  <em>One task → Multi-role AI collaboration → One conclusion | V4.5.5 (Module Fiber + Coeffect: 6-state FSM + topological activation + modules CLI) | V4.5.3 (Artifacts + Effect — ArtifactStore + DispatchEffect + EffectRegistry + Audit CLI) | V4.5.2 (Experience polish: MOKA + Metrics + GitLab + Doctor + BackendConfig) | V4.5.0 (cross-session continuity + protocol-native skills) | V4.4.0 (5 enhancement modules)</em>
 </p>
 
 <p align="center">
   <img alt="Python" src="https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white" />
   <img alt="License" src="https://img.shields.io/badge/License-MIT-green" />
-  <img alt="Tests" src="https://img.shields.io/badge/Tests-8392%2B%20passing-brightgreen" />
-  <img alt="Version" src="https://img.shields.io/badge/V4.5.2-success" />
+  <img alt="Tests" src="https://img.shields.io/badge/Tests-8996%2B%20passing-brightgreen" />
+  <img alt="Version" src="https://img.shields.io/badge/V4.5.5-success" />
   <img alt="CI" src="https://img.shields.io/badge/CI-GitHub_Actions-blue?logo=githubactions" />
   <img alt="Quality" src="https://img.shields.io/badge/Code%20Quality-4.3%2F5%20%E2%98%85%E2%98%85%E2%98%85%E2%98%85%E2%98%86-blue" />
   <img alt="Security" src="https://img.shields.io/badge/Security-5%2F5%20%E2%98%85%E2%98%85%E2%98%85%E2%98%85%E2%98%85-success" />
@@ -157,7 +157,7 @@ devsquad run "设计一个安全的用户认证系统" --roles architect,securit
 | 复杂系统设计（需要多视角） | **DevSquad 多角色协作** 🎯 |
 | 生产环境自动化流程 | **DevSquad + REST API + Dashboard** 🎯 |
 
-📚 **想深入了解？** → [完整快速入门指南](QUICKSTART.md) | [187+ 模块详细参考](SKILL.md)
+📚 **想深入了解？** → [完整快速入门指南](QUICKSTART.md) | [193 模块详细参考](SKILL.md)
 
 ---
 
@@ -235,7 +235,7 @@ Every new module includes `_call_counter` mechanism + E2E anti_ghost test + CI `
 - **V4.0.0 P3-1 Autonomous**: plan → dev → verify → fix 4-stage autonomous iteration
 - **V4.0.0 P3-2 Plugin Hot-Loading**: 3 loading paths + path traversal 3-layer protection + reload rollback
 
-8392+ tests passing (CI authoritative).
+8996+ tests passing (CI authoritative).
 
 ---
 

{devsquad-4.5.2 → devsquad-4.5.5}/devsquad.egg-info/SOURCES.txt

@@ -25,11 +25,13 @@ scripts/check_test_pyramid.py
 scripts/check_test_quality.py
 scripts/check_version_consistency.py
 scripts/cli.py
+scripts/cli_audit.py
 scripts/cli_backend.py
 scripts/cli_dispatch.py
 scripts/cli_doctor.py
 scripts/cli_lifecycle.py
 scripts/cli_metrics.py
+scripts/cli_modules.py
 scripts/cli_sessions.py
 scripts/cli_utils.py
 scripts/collect_baseline.py
@@ -60,6 +62,7 @@ scripts/collaboration/ai_semantic_matcher.py
 scripts/collaboration/anchor_checker.py
 scripts/collaboration/anti_rationalization.py
 scripts/collaboration/approval_gate.py
+scripts/collaboration/artifact_store.py
 scripts/collaboration/async_adapter.py
 scripts/collaboration/async_coordinator.py
 scripts/collaboration/async_llm_backend.py
@@ -77,6 +80,7 @@ scripts/collaboration/code_graph_query.py
 scripts/collaboration/code_graph_storage.py
 scripts/collaboration/code_knowledge_graph.py
 scripts/collaboration/code_map_generator.py
+scripts/collaboration/coeffect.py
 scripts/collaboration/concern_pack_loader.py
 scripts/collaboration/confidence_score.py
 scripts/collaboration/config_manager.py
@@ -94,6 +98,7 @@ scripts/collaboration/dependency_hallucination_checker.py
 scripts/collaboration/deployment_compliance_checker.py
 scripts/collaboration/dispatch_audit.py
 scripts/collaboration/dispatch_component_factory.py
+scripts/collaboration/dispatch_effect.py
 scripts/collaboration/dispatch_hooks.py
 scripts/collaboration/dispatch_lifecycle.py
 scripts/collaboration/dispatch_models.py
@@ -116,12 +121,16 @@ scripts/collaboration/dispatcher_base.py
 scripts/collaboration/dispatcher_config.py
 scripts/collaboration/dispatcher_error_mixin.py
 scripts/collaboration/dispatcher_factory.py
+scripts/collaboration/dispatcher_intent_mapper.py
 scripts/collaboration/dispatcher_lifecycle_mixin.py
+scripts/collaboration/dispatcher_loop_controller.py
 scripts/collaboration/dispatcher_mixins.py
 scripts/collaboration/dispatcher_status_mixin.py
+scripts/collaboration/dispatcher_transaction.py
 scripts/collaboration/dispatcher_utils_mixin.py
 scripts/collaboration/dora_metrics_collector.py
 scripts/collaboration/dual_layer_context.py
+scripts/collaboration/effect_registry.py
 scripts/collaboration/enhanced_worker.py
 scripts/collaboration/enterprise_feature.py
 scripts/collaboration/error_budget_tracker.py
@@ -134,6 +143,7 @@ scripts/collaboration/five_axis_consensus.py
 scripts/collaboration/gap_analyzer.py
 scripts/collaboration/gitlab_connector.py
 scripts/collaboration/host_llm_bridge.py
+scripts/collaboration/host_llm_bridge_v2.py
 scripts/collaboration/input_validator.py
 scripts/collaboration/intent_workflow_mapper.py
 scripts/collaboration/judge_agent.py
@@ -165,6 +175,7 @@ scripts/collaboration/models.py
 scripts/collaboration/models_base.py
 scripts/collaboration/models_dispatch.py
 scripts/collaboration/models_lifecycle.py
+scripts/collaboration/module_fiber.py
 scripts/collaboration/moka_backend.py
 scripts/collaboration/multi_host_adapter.py
 scripts/collaboration/multi_level_cache.py
@@ -307,6 +318,8 @@ tests/test_api_budget_status_endpoint.py
 tests/test_api_security.py
 tests/test_api_server_v362.py
 tests/test_approval_gate.py
+tests/test_artifact_effect_binding.py
+tests/test_artifact_store.py
 tests/test_async_coordinator.py
 tests/test_async_modules.py
 tests/test_audit_logger.py
@@ -325,6 +338,7 @@ tests/test_check_test_pyramid.py
 tests/test_check_test_quality.py
 tests/test_check_version_consistency.py
 tests/test_ci_feedback_adapter.py
+tests/test_cli_audit.py
 tests/test_cli_command_classifier.py
 tests/test_cli_deep_v362.py
 tests/test_cli_doctor.py
@@ -377,10 +391,14 @@ tests/test_dispatch_audit.py
 tests/test_dispatch_performance.py
 tests/test_dispatch_rbac.py
 tests/test_dispatch_steps.py
+tests/test_dispatcher_intent_mapper.py
+tests/test_dispatcher_loop_controller.py
 tests/test_dispatcher_mixins.py
 tests/test_dispatcher_phase5_core.py
+tests/test_dispatcher_transaction.py
 tests/test_docker_deployment.py
 tests/test_dual_layer_context.py
+tests/test_effect_registry.py
 tests/test_enhanced_worker.py
 tests/test_fallback_fuse.py
 tests/test_feedback_control_loop.py
@@ -394,6 +412,7 @@ tests/test_grilling_mode.py
 tests/test_handoff_redaction.py
 tests/test_history_manager_v362.py
 tests/test_host_bridge_unit.py
+tests/test_host_llm_bridge_v2.py
 tests/test_input_validator_phase5.py
 tests/test_input_validator_sensitive.py
 tests/test_intent_workflow_mapper.py
@@ -480,6 +499,7 @@ tests/test_v411_security_hardening.py
 tests/test_verification_gate.py
 tests/test_version.py
 tests/test_vertical_slice.py
+tests/test_worker_artifact_integration.py
 tests/test_workflow_engine.py
 tests/test_workflow_engine_base.py
 tests/test_workflow_engine_lifecycle.py

{devsquad-4.5.2 → devsquad-4.5.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devsquad"
-version = "4.5.2"
+version = "4.5.5"
 description = "Production-Ready Multi-Role AI Task Orchestrator"
 readme = "README.md"
 license = {text = "MIT"}

devsquad-4.5.5/scripts/check_module_activation.py

@@ -0,0 +1,344 @@
+#!/usr/bin/env python3
+"""
+check_module_activation.py — V4.5.3 Anti-Ghost CI gate.
+
+Verifies that all V4.5.3 modules' _call_counter is > 0 after a representative
+dispatch. Used by CI to block releases of ghost modules.
+
+V4.5.2 P12.1: Extended to include:
+    - MokaAIBackend (P12.1.1)
+    - GitLabConnector (P12.1.3)
+    - BackendConfig (P12.1.5)
+
+V4.5.3 P12.2: Extended to include:
+    - ArtifactStore (P12.2.1)
+    - DispatchEffect Protocol (P12.2.3)
+    - EffectRegistry (P12.2.4)
+    - Audit CLI (P12.2.6)
+
+V4.5.4 P12.3: Extended to include:
+    - ModuleFiber (P12.3.1)
+    - CoeffectResolver (P12.3.2)
+    - ModulesCLI (P12.3.3)
+
+Usage:
+    python3 scripts/check_module_activation.py
+    CI: python3 scripts/check_module_activation.py || exit 1
+"""
+
+from __future__ import annotations
+
+import contextlib
+import sys
+
+# Add project root to path
+sys.path.insert(0, ".")
+
+
+def main() -> int:
+    """Check all V4.5.2 modules' _call_counter > 0.
+
+    Returns:
+        0 if all modules activated (anti-ghost pass).
+        1 if any module's counter is 0 (ghost detected).
+    """
+    # Touch each module + ensure counter is exposed via get_call_counter
+    from scripts.collaboration.backend_config import get_call_count as bcc
+    from scripts.collaboration.backend_config import (
+        load_backend_config,
+        resolve_backend,
+    )
+    from scripts.collaboration.backend_paths import classify_error
+    from scripts.collaboration.backend_paths import get_call_counter as bp
+    from scripts.collaboration.gitlab_connector import GitLabConnector
+    from scripts.collaboration.gitlab_connector import get_call_count as glc
+    from scripts.collaboration.host_llm_bridge import get_call_counter as hbb
+
+    # V4.5.2 P12.1 modules
+    from scripts.collaboration.moka_backend import MokaAIBackend
+
+    # V4.5.2 P12.1 modules
+    from scripts.collaboration.moka_backend import get_call_counter as mok
+    from scripts.collaboration.order_chain_detector import OrderChainDetector
+    from scripts.collaboration.order_chain_detector import get_call_counter as ocd
+    from scripts.collaboration.perf_baseline import PerfSampleCollector
+    from scripts.collaboration.perf_baseline import get_call_counter as pb
+
+    # Activate each module (representative call)
+    from scripts.collaboration.task_scale_gate import TaskScaleGate
+    from scripts.collaboration.task_scale_gate import get_call_counter as tsg
+
+    TaskScaleGate().decide("anti-ghost check")
+    OrderChainDetector().detect("anti-ghost check")
+    classify_error(TimeoutError("test"))
+
+    col = PerfSampleCollector("mock")
+    for i in range(10):
+        col.add_sample(float(i))
+    col.snapshot()
+
+    # P12.1.1: MokaAIBackend — exercise is_available() to bump counter
+    moka_backend = MokaAIBackend(api_key="anti-ghost-test-key")
+    moka_backend.is_available()
+
+    # P12.1.3: GitLabConnector — exercise create_mr_comment in simulation mode
+    # (simulation=True guarantees no real GitLab API calls)
+    gitlab = GitLabConnector(simulation=True)
+    gitlab.create_mr_comment(project="anti-ghost/test", mr_iid=1, body="ghost check")
+
+    # P12.1.5: BackendConfig — exercise resolve_backend + load_backend_config
+    resolve_backend()
+    load_backend_config()
+
+    # HostBridgeBackend: counter is bumped by create_request().
+    # Verify wiring via create_backend() which imports HostBridgeBackend internally.
+    import os
+    from unittest.mock import patch
+    old_env = {
+        k: os.environ.pop(k, None)
+        for k in (
+            "TRAE_ENV", "CLAUDE_CODE_ENV", "TRAE_AGENT_PATH", "ANTHROPIC_ENV",
+            "DEVSQUAD_OPENAI_API_KEY", "DEVSQUAD_ANTHROPIC_API_KEY",
+            "MOKA_API_KEY", "DEVSQUAD_LLM_BACKEND",
+        )
+    }
+    try:
+        with patch("scripts.collaboration.llm_backend._load_dotenv"):
+            from scripts.collaboration.host_llm_bridge import HostLLMBridge
+            from scripts.collaboration.llm_backend import create_backend
+            # Exercise both create_backend (auto-fallback path) and a direct bridge
+            # construction to ensure the module is wired into the resolution chain.
+            create_backend("mock")  # C path
+            bridge = HostLLMBridge(bridge_dir=None)
+            # Directly invoke create_request — this is the only path that bumps
+            # _call_counter in production code (generate() calls it internally).
+            with contextlib.suppress(OSError, ValueError):
+                # Bridge dir may not exist; the counter bump happens BEFORE that.
+                bridge.create_request(
+                    agent_type="anti-ghost",
+                    task="anti-ghost check",
+                    context={},
+                    prompt="test prompt",
+                )
+    finally:
+        for k, v in old_env.items():
+            if v is not None:
+                os.environ[k] = v
+
+    # V4.5.3 P12.2 modules — touch counters in main scope so they survive module-level imports
+    from scripts.cli_audit import get_call_counter as au_call_counter
+    from scripts.collaboration.artifact_store import (
+        get_call_counter as as_call_counter,
+    )
+
+    # V4.5.5 P12.4 modules — touch counters in main scope
+    from scripts.collaboration.dispatcher_intent_mapper import (
+        get_call_counter_er as _get_intent_counter_er,
+    )
+    from scripts.collaboration.dispatcher_loop_controller import (
+        get_call_counter_er as _get_loop_counter_er,
+    )
+    from scripts.collaboration.dispatcher_transaction import (
+        get_call_counter_er as _get_tx_counter_er,
+    )
+    from scripts.collaboration.effect_registry import (
+        get_call_count as er_call_count,
+    )
+    from scripts.collaboration.host_llm_bridge_v2 import (
+        get_call_counter_er as _get_call_counter_er_v2,
+    )
+
+    # V4.5.4 P12.3 modules — touch counters in main scope
+    from scripts.collaboration.module_fiber import (
+        get_call_counter_er,
+    )
+
+    # V4.5.3 P12.2 activation (ArtifactStore + EffectRegistry + DispatchEffect + AuditCLI)
+    _activate_v453_modules()
+
+    # V4.5.4 P12.3 activation
+    _activate_v454_modules()
+
+    # V4.5.5 P12.4 activation (4 new modules)
+    _activate_v455_modules()
+
+    counters = {
+        "TaskScaleGate": tsg(),
+        "PerfBaseline": pb(),
+        "HostLLMBridge": hbb(),
+        "BackendPaths": bp(),
+        "TaskScaleGate_dual": tsg(),
+        "OrderChainDetector": ocd(),
+        "MokaAIBackend_P12.1.1": mok(),
+        "GitLabConnector_P12.1.3": glc(),
+        "BackendConfig_P12.1.5": bcc(),
+        # V4.5.3 P12.2 modules
+        "ArtifactStore_P12.2.1": as_call_counter(),
+        "EffectRegistry_P12.2.4": er_call_count(),
+        "AuditCLI_P12.2.6": au_call_counter(),
+        # V4.5.4 P12.3 modules
+        "ModuleFiber_P12.3.1": get_call_counter_er(),
+        "CoeffectResolver_P12.3.2": get_call_counter_er(),  # shared counter
+        "ModulesCLI_P12.3.3": get_call_counter_er(),  # shared counter
+        # V4.5.5 P12.4 modules
+        "HostLLMBridgeV2_P12.4.1": _get_call_counter_er_v2(),
+        "DispatcherTransaction_P12.4.2": _get_tx_counter_er(),
+        "IntentWorkflowMapper_P12.4.3": _get_intent_counter_er(),
+        "DispatchLoopController_P12.4.4": _get_loop_counter_er(),
+    }
+
+    print("V4.5.4 Anti-Ghost Verification")
+    print("=" * 60)
+    failed = []
+    for name, count in counters.items():
+        status = "PASS" if count > 0 else "FAIL (ghost)"
+        print(f"  {name:25s}  counter={count:>4}  [{status}]")
+        if count <= 0:
+            failed.append(name)
+
+    print("=" * 60)
+    if failed:
+        print(f"GHOST DETECTED: {len(failed)} module(s) not activated:")
+        for name in failed:
+            print(f"  - {name}")
+        return 1
+
+    print("All V4.5.3 modules activated. Anti-ghost gate PASSED.")
+    return 0
+
+
+def _activate_v454_modules() -> None:
+    """Exercise V4.5.4 P12.3 modules to bump their anti-ghost counters.
+
+    Touches:
+        - ModuleFiber_P12.3.1 — ModuleFiberRegistry
+        - CoeffectResolver_P12.3.2 — register + resolve
+        - ModulesCLI_P12.3.3 — cmd_modules_status
+    """
+    # Local imports — these names live in main(), not module-scope.
+    from scripts.cli_modules import cmd_modules_status as _cms_local
+    from scripts.collaboration.coeffect import (
+        CoeffectResolver as _CR_local,
+    )
+    from scripts.collaboration.coeffect import _StaticProvider as _SP_local
+    from scripts.collaboration.module_fiber import (
+        ModuleFiberRegistry as _MFR_local,
+    )
+
+    # P12.3.1: ModuleFiber — register a few fibers
+    reg = _MFR_local()
+    for module_id in ("v454_module_a", "v454_module_b"):
+        fiber = reg.register(module_id)
+        fiber.transition(fiber.state.__class__.ACTIVATING)
+        fiber.transition(fiber.state.__class__.ACTIVE)
+
+    # P12.3.2: CoeffectResolver — register + resolve
+    resolver = _CR_local()
+    resolver.register(_SP_local("v454_module_a", ()))
+    resolver.register(_SP_local("v454_module_b", ("v454_module_a",)))
+    resolver.resolve_activation_order()
+
+    # P12.3.3: ModulesCLI — exercise status command
+    from argparse import Namespace
+    _cms_local(Namespace(registry=reg, format="text", module=None))
+
+
+def _activate_v455_modules() -> None:
+    """Exercise V4.5.5 P12.4 modules to bump their anti-ghost counters.
+
+    Touches:
+        - HostLLMBridgeV2_P12.4.1 — create_request (writes marker)
+        - DispatcherTransaction_P12.4.2 — begin + commit
+        - IntentWorkflowMapper_P12.4.3 — resolve one workflow
+        - DispatchLoopController_P12.4.4 — should_stop call
+    """
+    # P12.4.1: HostLLMBridgeV2 — create_request
+    import tempfile as _tf
+
+    from scripts.collaboration.dispatcher_intent_mapper import IntentWorkflowMapper
+    from scripts.collaboration.dispatcher_loop_controller import (
+        DispatchLoopController,
+        IterationKind,
+        IterationResult,
+    )
+    from scripts.collaboration.dispatcher_transaction import (
+        DispatchTransaction,
+        TransactionRegistry,
+    )
+    from scripts.collaboration.host_llm_bridge_v2 import HostLLMBridgeV2
+    with _tf.TemporaryDirectory() as tmpdir:
+        bridge = HostLLMBridgeV2(bridge_dir=tmpdir)
+        bridge.create_request(
+            agent_type="anti-ghost",
+            task="anti-ghost check v2",
+            context={},
+            prompt="v2 test prompt",
+        )
+
+    # P12.4.2: DispatcherTransaction — full lifecycle
+    tx = DispatchTransaction(tx_id="anti-ghost-tx")
+    tx.register_module("m1", lambda: None, lambda: None)
+    tx.begin()
+    tx.commit()
+
+    # P12.4.3: IntentWorkflowMapper — resolve one workflow
+    mapper = IntentWorkflowMapper()
+    mapper.resolve("design", "zh")
+
+    # P12.4.4: DispatchLoopController — should_stop call
+    ctrl = DispatchLoopController()
+    ctrl.should_stop(IterationResult(IterationKind.SUCCESS))
+    # Also verify the registry helper is importable
+    _ = TransactionRegistry()
+
+
+def _activate_v453_modules() -> None:
+    """Exercise V4.5.3 P12.2 modules to bump their anti-ghost counters."""
+    from scripts.cli_audit import get_call_counter as au_call_counter
+    from scripts.collaboration.artifact_store import (
+        ArtifactStore,
+    )
+    from scripts.collaboration.dispatch_effect import (
+        EffectContext,
+        WriteFileEffect,
+    )
+    from scripts.collaboration.effect_registry import (
+        EffectRegistry,
+    )
+
+    # P12.2.1: ArtifactStore — exercise write + list
+    store = ArtifactStore()
+    store.write(
+        "anti-ghost-session", "anti-ghost-role", "ghost.md", "anti-ghost content"
+    )
+
+    # P12.2.3 + P12.2.4: DispatchEffect + EffectRegistry — apply + revert
+    reg = EffectRegistry()
+    effect_ctx = EffectContext(
+        effect_id="anti-ghost",
+        effect_type="write_file",
+        payload={"path": "/tmp/anti-ghost-test.txt", "content": "ghost"},
+    )
+    reg.apply(WriteFileEffect(), effect_ctx)
+    reg.pending_count()
+
+    # P12.2.6: AuditCLI — exercise get_call_counter (cmd_audit is imported above)
+    _ = au_call_counter()
+    # Exercise cmd_audit once to bump counter
+    from argparse import Namespace
+
+    from scripts.cli_audit import cmd_audit as _cmd_audit
+
+    _cmd_audit(
+        Namespace(
+            limit=0,
+            format="text",
+            event_type=None,
+            verify=False,
+            db_path=None,
+        )
+    )
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{devsquad-4.5.2 → devsquad-4.5.5}/scripts/cli.py

@@ -16,10 +16,13 @@ import sys
 
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
 
+from scripts.cli_audit import cmd_audit
+from scripts.cli_backend import cmd_backend
 from scripts.cli_dispatch import cmd_demo, cmd_dispatch, cmd_roles, cmd_status
-from scripts.cli_metrics import cmd_metrics
 from scripts.cli_doctor import cmd_doctor
 from scripts.cli_lifecycle import cmd_lifecycle
+from scripts.cli_metrics import cmd_metrics
+from scripts.cli_modules import register_modules_subparser
 from scripts.cli_sessions import cmd_sessions
 from scripts.cli_utils import (
     ALL_ROLE_IDS,
@@ -475,6 +478,35 @@ Environment Variables (API keys are read from env vars only, never command line)
         help="HTTP timeout in seconds (default: 5.0)",
     )
 
+    # V4.5.3 P12.2.6: devsquad audit CLI
+    p_audit = subparsers.add_parser(
+        "audit", help="Inspect dispatch audit log (V4.5.3 P12.2.6)"
+    )
+    p_audit.add_argument(
+        "--limit", "-n", type=int, default=20, help="Max entries to show (default 20)"
+    )
+    p_audit.add_argument(
+        "--format", "-f", choices=["text", "json"], default="text",
+        help="Output format",
+    )
+    p_audit.add_argument(
+        "--event-type", help="Filter by event type (e.g. dispatch_start)"
+    )
+    p_audit.add_argument(
+        "--verify",
+        action="store_true",
+        help="Verify SHA-256 chain integrity",
+    )
+    p_audit.add_argument(
+        "--db-path",
+        default="audit/dispatch_audit.db",
+        help="SQLite audit DB path (default: audit/dispatch_audit.db)",
+    )
+    p_audit.set_defaults(func=cmd_audit)
+
+    # V4.5.4 P12.3.3: devsquad modules CLI (status/graph/retry)
+    register_modules_subparser(subparsers)
+
     # V4.5.0 SessionResume CLI (PRD §10.1.2): `sessions` subcommand group
     p_sessions = subparsers.add_parser(
         "sessions", aliases=["sess"], help="List/show dispatch sessions (SessionResume V4.5.0)"
@@ -584,6 +616,17 @@ Environment Variables (API keys are read from env vars only, never command line)
         return cmd_doctor(args)
     elif args.command == "backend":
         return cmd_backend(args)
+    elif args.command == "modules":
+        # V4.5.4 P12.3.3: dispatch to modules subcommand function
+        from scripts.collaboration.coeffect import CoeffectResolver
+        from scripts.collaboration.module_fiber import ModuleFiberRegistry
+        if not hasattr(args, "registry"):
+            args.registry = ModuleFiberRegistry()
+        if not hasattr(args, "resolver"):
+            args.resolver = CoeffectResolver()
+        if hasattr(args, "func") and callable(args.func):
+            return args.func(args)
+        return 1
     elif args.command in ("lifecycle", "lc") or args.command in LIFECYCLE_COMMANDS:
         if args.command in LIFECYCLE_COMMANDS:
             args.lifecycle_command = args.command