Skip to content

richfrem/agent-plugins-skills / plugins/agent-agentic-os/.apm/skills/running-control-plane

running-control-plane

Flagged

CRITICAL INTAKE GATEWAY: use at the start of any non-trivial engineering task, feature, refactor, multi-file bugfix, work package or new idea, including requests to explore, brainstorm, build, fix or change something, before planning or code changes. Enforces read-only discovery, 1-3 structured questions with defaults, control-plane registration and the immutable four-pillar TASK_SPEC.md. Also runs the rest of the control plane: health ("run health check", "check os metrics", "system monitor", event bus, locks, memory, "is my signing identity ready" status check), transition simulation ("dry run transition", "simulate transition", "check edge X -> Y"), worktree selection, and gating on/off ("disable the control plane", "turn off the push guard", "stop gating my commits"). Not for project setup or key creation (use setting-up-agentic-os) or improving skills (use improving-skills-in-lab).

FileKindSize
SKILL.mdskill md5.4 KB
evals/evals.jsonconfig8.3 KB
references/acceptance-criteria.mdmarkdown4.0 KB
references/agentic-os-skill-map.mdmarkdown2.3 KB
references/architecture/architecture.mdmarkdown2.4 KB
references/architecture/context-folder-patterns.mdmarkdown3.3 KB
references/architecture/vision.mdmarkdown56.6 KB
references/cheap-agent-transition-simulation.mdmarkdown6.1 KB
references/control-plane-architecture.mdmarkdown9.0 KB
references/control-plane-rebuild-recovery.mdmarkdown6.2 KB
references/control-plane-simulation-protocol.mdmarkdown5.7 KB
references/diagrams/agentic-os-memory-subsystem.mmdother1.4 KB
references/diagrams/architecture-overview.mmdother3.1 KB
references/diagrams/control-plane-architecture.mermaidother6.3 KB
references/diagrams/control-plane-lifecycle-hardened-with-ciba-rar.mermaidother4.5 KB
references/diagrams/control-plane-pipeline-happy-path.mermaidother5.0 KB
references/diagrams/control-plane-pipeline.mermaidother9.3 KB
references/diagrams/event-bus-architecture.mmdother2.4 KB
references/diagrams/increment-b-human-only-transition-ssh-signing.mermaidother5.3 KB
references/edge-matrix.mdmarkdown13.3 KB
references/fallback-tree.mdmarkdown2.9 KB
references/health-detailed-reference.mdmarkdown7.1 KB
references/healthy-transcript.mdmarkdown3.8 KB
references/implementation-ledger-contract.mdmarkdown851 B
references/intake-detailed-reference.mdmarkdown3.1 KB
references/modes/health.mdmarkdown3.4 KB
references/modes/intake.mdmarkdown3.8 KB
references/modes/mode.mdmarkdown5.8 KB
references/modes/simulator.mdmarkdown6.2 KB
references/modes/worktree.mdmarkdown2.9 KB
references/multi-round-external-review-protocol.mdmarkdown2.6 KB
references/worktree-reconciliation-and-multi-worktree-practices.mdmarkdown5.8 KB
requirements-dev.inother741 B
requirements-dev.txtmarkdown603 B
requirements.inother196 B
requirements.txtmanifest202 B
scripts/agent_control.pyscript97.7 KB
scripts/audit_map_debt.pyscript6.1 KB
scripts/capability_probe.pyscript6.4 KB
scripts/check_plan_links.pyscript1.8 KB
scripts/control_plane/__init__.pyscript842 B
scripts/control_plane/adapters.pyscript144.9 KB
scripts/control_plane/approver_policy.pyscript20.0 KB
scripts/control_plane/baseline_transition_report.pyscript4.0 KB
scripts/control_plane/constants.pyscript13.5 KB
scripts/control_plane/coordinator.pyscript57.3 KB
scripts/control_plane/edge_matrix.pyscript3.1 KB
scripts/control_plane/gate1_approval.pyscript10.7 KB
scripts/control_plane/gate_evidence.pyscript9.9 KB
scripts/control_plane/identity_layout.pyscript2.9 KB
scripts/control_plane/identity_setup.pyscript11.0 KB
scripts/control_plane/implementation.pyscript3.7 KB
scripts/control_plane/implementation_loop.pyscript11.3 KB
scripts/control_plane/inspection.pyscript3.9 KB
scripts/control_plane/installation_probe.pyscript5.7 KB
scripts/control_plane/isolation_check.pyscript14.0 KB
scripts/control_plane/measurement.pyscript39.1 KB
scripts/control_plane/pipeline_simulator.pyscript30.0 KB
scripts/control_plane/policy.pyscript32.5 KB
scripts/control_plane/ports.pyscript20.3 KB
scripts/control_plane/proof_edges.pyscript4.6 KB
scripts/control_plane/proof_policy.pyscript2.2 KB
scripts/control_plane/receipt_provenance.pyscript4.7 KB
scripts/control_plane/registry.pyscript32.9 KB
scripts/control_plane/review_options.pyscript8.2 KB
scripts/control_plane/review_selection.pyscript3.2 KB
scripts/control_plane/run_transition_simulation.pyscript12.0 KB
scripts/control_plane/signing_selftest.pyscript6.8 KB
scripts/control_plane/simulation_identity.pyscript10.4 KB
scripts/control_plane/snapshot.pyscript10.8 KB
scripts/control_plane/ssh_signing.pyscript21.8 KB
scripts/control_plane/state_machine.pyscript5.8 KB
scripts/control_plane/transition_request.pyscript19.5 KB
scripts/control_plane/transition_simulation_cases.pyscript24.6 KB
scripts/control_plane/transition_templates.yamlconfig159.1 KB
scripts/control_plane/tty_signer.pyscript3.0 KB
scripts/control_plane/wrappers/__init__.pyscript24 B
scripts/control_plane/wrappers/record_interview_question.pyscript8.0 KB
scripts/control_plane/wrappers/record_retrospective.pyscript2.3 KB
scripts/control_plane/wrappers/run_exit_verification.pyscript6.4 KB
scripts/control_plane/wrappers/run_verify_exit_bundle.pyscript5.4 KB
scripts/control_plane/wrappers/write_plan_document.pyscript9.6 KB
scripts/control_plane_hooks.pyscript10.5 KB
scripts/control_plane_mode.pyscript12.0 KB
scripts/distill_playbook.pyexecutablescript9.9 KB
scripts/evolution_state.pyscript29.4 KB
scripts/export_upstream_pr.pyscript4.4 KB
scripts/interview_spec_engine.pyscript9.1 KB
scripts/kernel.pyscript14.6 KB
scripts/pre-commit-evolution-guardexecutablescript3.7 KB
scripts/pre-commit-pipeline-guardexecutablescript13.6 KB
scripts/pre-push-review-guardexecutablescript10.5 KB
scripts/record_trace.pyscript7.2 KB
scripts/smoke_test.pyexecutablescript22.6 KB
scripts/test_capability_probe.pyscript3.9 KB
scripts/test_worktree_manager.pyscript2.8 KB
scripts/verify_evolution_receipt.pyscript7.5 KB
scripts/verify_gate_evidence.pyscript1.6 KB
scripts/worktree_manager.pyscript3.0 KB
tests/conftest.pyscript7.7 KB
tests/helpers/__init__.pyscript0 B
tests/helpers/control_plane_fixtures.pyscript2.6 KB
tests/helpers/control_plane_repo.pyscript4.0 KB
tests/helpers/gate1_fixtures.pyscript5.8 KB
tests/helpers/human_signer.pyscript7.3 KB
tests/helpers/implementation_ledger.pyscript1.1 KB
tests/interview_helpers.pyscript5.2 KB
tests/test_actionable_rollback.pyscript2.2 KB
tests/test_agent_control.pyscript190.6 KB
tests/test_agent_control_gate_characterization.pyscript14.7 KB
tests/test_approve_transition.pyscript10.5 KB
tests/test_approver_identity_guidance.pyscript3.4 KB
tests/test_approver_isolation.pyscript12.3 KB
tests/test_audit_map_debt.pyscript4.7 KB
tests/test_authorized_actor_enforcement.pyscript22.9 KB
tests/test_background_document_priority.pyscript924 B
tests/test_check_plan_links.pyscript1.1 KB
tests/test_content_snapshot.pyscript11.8 KB
tests/test_control_plane_architecture_diagram_contract.pyscript9.0 KB
tests/test_control_plane_architecture_overview_contract.pyscript2.1 KB
tests/test_control_plane_critic_review.pyscript3.1 KB
tests/test_control_plane_crypto_adapter.pyscript5.0 KB
tests/test_control_plane_delegation_contract.pyscript5.7 KB
tests/test_control_plane_facade_composition.pyscript15.9 KB
tests/test_control_plane_filesystem_adapter.pyscript4.9 KB
tests/test_control_plane_hooks.pyscript7.3 KB
tests/test_control_plane_interview_guidance.pyscript3.8 KB
tests/test_control_plane_measurement_contract.pyscript28.0 KB
tests/test_control_plane_mode.pyscript7.5 KB
tests/test_control_plane_mode_guards.pyscript3.5 KB
tests/test_control_plane_model_catalog_adapter.pyscript9.2 KB
tests/test_control_plane_pipeline_diagram_contract.pyscript2.3 KB
tests/test_control_plane_pipeline_simulator.pyscript7.5 KB
tests/test_control_plane_policy.pyscript13.0 KB
tests/test_control_plane_ports.pyscript3.2 KB
tests/test_control_plane_reset_transition.pyscript13.6 KB
tests/test_control_plane_schema_rebuild_atomicity.pyscript20.0 KB
tests/test_control_plane_simulation_protocol_contract.pyscript959 B
tests/test_control_plane_sqlite_persistence_adapter.pyscript5.5 KB
tests/test_control_plane_state_machine.pyscript15.2 KB
tests/test_control_plane_trigger_enforcement.pyscript14.6 KB
tests/test_control_plane_worktree_sharing.pyscript4.5 KB
tests/test_domain_namespaces.pyscript6.7 KB
tests/test_done_closure_proof.pyscript6.9 KB
tests/test_draft_plan_interactive_outline_gap.pyscript2.2 KB
tests/test_dual_identity_onboarding.pyscript7.3 KB
tests/test_edge_matrix.pyscript3.2 KB
tests/test_ensure_schema_fastpath.pyscript4.4 KB
tests/test_evolution_guards.pyscript14.9 KB
tests/test_evolution_scripts.pyscript55.3 KB
tests/test_gate1_guidance.pyscript1.8 KB
tests/test_gate3_code_acceptance.pyscript13.5 KB
tests/test_graph_state_machine.pyscript16.0 KB
tests/test_guidance_readiness.pyscript2.2 KB
tests/test_health_check_signing_status.pyscript3.5 KB
tests/test_human_decision_trigger_enforcement.pyscript37.3 KB
tests/test_human_only_wiring.pyscript22.3 KB
tests/test_human_signer_isolation.pyscript4.0 KB
tests/test_identity_verification_readiness.pyscript5.8 KB
tests/test_implementation_ledger.pyscript3.4 KB
tests/test_implementation_loop.pyscript6.9 KB
tests/test_implementation_runtime_bridge.pyscript2.6 KB
tests/test_init_agentic_os_scaffolding.pyscript10.0 KB
tests/test_init_respects_control_plane_mode.pyscript4.3 KB
tests/test_inspect_verbs.pyscript3.6 KB
tests/test_installation_probe.pyscript3.1 KB
tests/test_intake_scenarios.pyscript7.2 KB
tests/test_interview_plan_outline.pyscript2.8 KB
tests/test_isolation_check.pyscript12.5 KB
tests/test_isolation_setup_docs.pyscript2.7 KB
tests/test_kernel_security.pyscript4.0 KB
tests/test_legacy_input_fallback.pyscript6.0 KB
tests/test_list_review_options.pyscript3.1 KB
tests/test_multi_agent_bundle_gate.pyscript5.5 KB
tests/test_one_approver_per_pipeline.pyscript15.8 KB
tests/test_os_init_dual_identity.pyscript3.9 KB
tests/test_os_init_identity_bootstrap.pyscript8.8 KB
tests/test_os_init_identity_status.pyscript3.9 KB
tests/test_os_init_single_instruction_file.pyscript7.3 KB
tests/test_p00_live_baseline.pyscript10.2 KB
tests/test_p01_intake_persistence.pyscript6.7 KB
tests/test_post_run_metrics_protocol.pyscript3.3 KB
tests/test_pre_commit_pipeline_guard.pyscript29.1 KB
tests/test_pre_push_review_guard.pyscript5.7 KB
tests/test_receipt_provenance.pyscript6.6 KB
tests/test_retrospective_pipeline.pyscript5.3 KB
tests/test_review_option_menus.pyscript6.6 KB
tests/test_review_selection.pyscript8.2 KB
tests/test_round3_fixes.pyscript8.3 KB
tests/test_rules_compliance.pyscript1.3 KB
tests/test_run_transition_simulation_formatting.pyscript1.7 KB
tests/test_run_verify_exit_bundle.pyscript10.2 KB
tests/test_setup_ciba_identity.pyscript11.2 KB
tests/test_signed_approval_human_receipt.pyscript3.9 KB
tests/test_signing_mechanics_selftest.pyscript6.9 KB
tests/test_signing_skill_selfcontained.pyscript3.4 KB
tests/test_skip_receipt_guidance.pyscript2.7 KB
tests/test_ssh_signing.pyscript23.9 KB
tests/test_strategy_artifacts.pyscript21.8 KB
tests/test_transition_answer_normalization.pyscript1.1 KB

tests/test_control_plane_facade_composition.py

View on GitHub
"""
test_control_plane_facade_composition.py — Facade Composition Confirmation (issue-524, Step 8)
====================================================================================================

Purpose:
    Confirms ControlPlane is genuinely a thin, composing facade — not a class that quietly
    re-absorbed the responsibilities it delegated, or a "replacement god-service" per
    docs/plans/issue-524-spec.md's Section 5 Step 8 warning. Revised after external
    post-implementation review (round 2) found the original version of this file only checked
    for naive substrings ("hashlib" anywhere in the file, including this file's own prose) and
    did not actually prove delegation — a default ControlPlane could still contain raw SQL
    while passing those checks. This version:
    (1) Uses `ast` to confirm agent_control.py never imports sqlite3/hashlib/time at the module
        level (real absence of the capability to use them directly, not a string-search proxy);
    (2) confirms ControlPlane composes all 5 real adapters by default;
    (3) injects a hand-built fake PersistencePort (no SQLite at all) and proves task creation,
        lookup, transition application, receipt/review/verifier operations, and worktree
        updates all actually delegate to it — the assertion is "the fake was called with the
        right arguments and its return value flowed through", not "a substring is absent".

Key Input Dependencies:
    None — static AST inspection plus a default-constructed ControlPlane and a fake
    PersistencePort double.

Key Functions:
    - test_control_plane_composes_all_adapters_by_default()
    - test_agent_control_has_no_infrastructure_imports()
    - test_fake_persistence_port_proves_full_delegation()
"""

import ast
import sys
from pathlib import Path
from typing import Any, Dict, List, Optional

SCRIPTS_DIR = Path(__file__).resolve().parent.parent / "scripts"
if str(SCRIPTS_DIR) not in sys.path:
    sys.path.insert(0, str(SCRIPTS_DIR))

from agent_control import ControlPlane
from control_plane.adapters import FilesystemAdapter, CryptoAdapter, ModelCatalogAdapter, ClockAdapter, SqlitePersistenceAdapter
from control_plane.ports import PersistencePort
from control_plane.constants import (
    STATE_INTAKE, STATE_INTERVIEW, STATE_DONE,
)

AGENT_CONTROL_FILE = SCRIPTS_DIR / "agent_control.py"
BANNED_MODULES = {"sqlite3", "hashlib", "time"}


def _collect_imported_module_names(source: str) -> set:
    tree = ast.parse(source)
    names = set()
    for node in ast.walk(tree):
        if isinstance(node, ast.Import):
            for alias in node.names:
                names.add(alias.name.split(".")[0])
        elif isinstance(node, ast.ImportFrom):
            if node.module:
                names.add(node.module.split(".")[0])
    return names


def test_control_plane_composes_all_adapters_by_default(tmp_path):
    """A default-constructed ControlPlane wires all 5 real adapters as instance attributes —
    the facade composes, it doesn't reabsorb their responsibilities."""
    cp = ControlPlane(db_path=tmp_path / "control_plane.db")
    assert isinstance(cp._fs, FilesystemAdapter)
    assert isinstance(cp._crypto, CryptoAdapter)
    assert isinstance(cp._clock, ClockAdapter)
    assert isinstance(cp._model_catalog, ModelCatalogAdapter)
    assert isinstance(cp._persistence, SqlitePersistenceAdapter)


def test_agent_control_has_no_infrastructure_imports():
    """agent_control.py must never import sqlite3, hashlib, or time at module level — this is
    an AST-based check of actual import statements, not a substring search (a substring search
    on the literal word "hashlib" previously false-failed on this very docstring's own prose
    explaining the invariant — fixed by parsing imports instead of grepping text)."""
    source = AGENT_CONTROL_FILE.read_text(encoding="utf-8")
    imported = _collect_imported_module_names(source)
    violations = imported & BANNED_MODULES
    assert not violations, f"agent_control.py imports banned infrastructure modules: {violations}"


class _FakePersistencePort(PersistencePort):
    """Hand-built fake with zero SQLite — records every call and returns scripted values, so
    tests can prove ControlPlane's CRUD methods delegate rather than reimplementing SQL."""

    def __init__(self):
        self.calls: List[tuple] = []
        self._tasks: Dict[str, Dict[str, Any]] = {}
        self._locked_verifiers: List[Dict[str, Any]] = []
        self._receipts: List[Dict[str, Any]] = []
        self.schema_ensured = False

    def get_task(self, task_id: str) -> Optional[Dict[str, Any]]:
        self.calls.append(("get_task", task_id))
        return self._tasks.get(task_id)

    def insert_premium_consent(self, task_id, stage, round_id, model_id, actor) -> int:
        self.calls.append(("insert_premium_consent", task_id, stage, round_id, model_id, actor))
        return 1

    def has_premium_consent(self, task_id, stage, round_id, model_id) -> bool:
        self.calls.append(("has_premium_consent", task_id, stage, round_id, model_id))
        return True

    def insert_source_assisted_answer_candidate(
        self, task_id, stage, round_id, question_id, answer, source_path, source_authorized
    ) -> int:
        self.calls.append((
            "insert_source_assisted_answer_candidate", task_id, stage, round_id,
            question_id, answer, source_path, source_authorized,
        ))
        return 1

    def confirm_source_assisted_answer_candidate(self, candidate_id, actor) -> bool:
        self.calls.append(("confirm_source_assisted_answer_candidate", candidate_id, actor))
        return True

    def has_unconfirmed_source_assisted_answer_candidates(self, task_id, stage, round_id) -> bool:
        self.calls.append(("has_unconfirmed_source_assisted_answer_candidates", task_id, stage, round_id))
        return False

    def insert_task(self, task_id, title, task_type, runtime_tool, spec_path, model_tier, model_id) -> None:
        self.calls.append(("insert_task", task_id, title, task_type, runtime_tool, spec_path, model_tier, model_id))
        self._tasks[task_id] = {
            "task_id": task_id, "title": title, "task_type": task_type, "runtime_tool": runtime_tool,
            "spec_path": spec_path, "model_tier": model_tier, "model_id": model_id, "state": STATE_INTAKE,
        }

    def read_current_state(self, task_id: str) -> Optional[str]:
        self.calls.append(("read_current_state", task_id))
        task = self._tasks.get(task_id)
        return task["state"] if task else None

    def apply_transition(self, task_id, from_state, to_state, actor, reason) -> bool:
        self.calls.append(("apply_transition", task_id, from_state, to_state, actor, reason))
        if self._tasks[task_id]["state"] != from_state:
            return False
        self._tasks[task_id]["state"] = to_state
        return True

    def count_asymmetric_persistence(self, task_id, details_like=None, destination_like_any=None) -> int:
        self.calls.append(("count_asymmetric_persistence", task_id, details_like, destination_like_any))
        return 0

    def count_receipts(self, task_id, gate_name, exit_code=None) -> int:
        self.calls.append(("count_receipts", task_id, gate_name, exit_code))
        return 0

    def count_locked_verifiers(self, task_id) -> int:
        self.calls.append(("count_locked_verifiers", task_id))
        return len(self._locked_verifiers)

    def get_locked_verifiers(self, task_id) -> List[Dict[str, Any]]:
        self.calls.append(("get_locked_verifiers", task_id))
        return list(self._locked_verifiers)

    def has_passing_critic_review(self, task_id) -> bool:
        self.calls.append(("has_passing_critic_review", task_id))
        return False

    def has_receipt(self, task_id, gate_name) -> bool:
        self.calls.append(("has_receipt", task_id, gate_name))
        return False

    def insert_verification_receipt(self, task_id, gate_name, command_executed, exit_code, receipt_token) -> None:
        self.calls.append(("insert_verification_receipt", task_id, gate_name, command_executed, exit_code, receipt_token))
        self._receipts.append({"task_id": task_id, "gate_name": gate_name, "receipt_token": receipt_token})

    def insert_critic_review(self, task_id, iteration, model, verdict, findings) -> None:
        self.calls.append(("insert_critic_review", task_id, iteration, model, verdict, findings))

    def insert_locked_verifier(self, task_id, file_path, expected_sha256) -> None:
        self.calls.append(("insert_locked_verifier", task_id, file_path, expected_sha256))
        self._locked_verifiers.append({"file_path": file_path, "expected_sha256": expected_sha256})

    def insert_asymmetric_persistence(self, task_id, destination, status, details) -> None:
        self.calls.append(("insert_asymmetric_persistence", task_id, destination, status, details))

    def get_latest_asymmetric_persistence(self, task_id, destination=None) -> Optional[Dict[str, Any]]:
        self.calls.append(("get_latest_asymmetric_persistence", task_id, destination))
        return None

    def get_guidance_block_reason(self, task_id):
        self.calls.append(("get_guidance_block_reason", task_id))
        return getattr(self, "_guidance_block_reason", None)

    def set_guidance_block(self, task_id, reason) -> None:
        self.calls.append(("set_guidance_block", task_id, reason))
        self._guidance_block_reason = reason

    def clear_guidance_block(self, task_id) -> None:
        self.calls.append(("clear_guidance_block", task_id))
        self._guidance_block_reason = None

    def get_verification_receipts(self, task_id) -> List[Dict[str, Any]]:
        self.calls.append(("get_verification_receipts", task_id))
        return [r for r in self._receipts if r["task_id"] == task_id]

    def save_retrospective(self, task_id, entry, follow_ups) -> None:
        self.calls.append(("save_retrospective", task_id, entry, follow_ups))

    def has_complete_retrospective(self, task_id) -> bool:
        self.calls.append(("has_complete_retrospective", task_id))
        return True

    def update_worktree_fields(self, task_id, worktree_path, worktree_branch, worktree_state) -> None:
        self.calls.append(("update_worktree_fields", task_id, worktree_path, worktree_branch, worktree_state))
        self._tasks[task_id]["worktree_state"] = worktree_state

    def record_done_closeout_decision(self, task_id, source_occupancy_transition_id,
                                      question_id, answer, actor, recorded_at) -> int:
        self.calls.append(("record_done_closeout_decision", task_id, source_occupancy_transition_id,
                           question_id, answer, actor, recorded_at))
        return 1

    def get_done_closeout_decisions(self, task_id) -> List[Dict[str, Any]]:
        self.calls.append(("get_done_closeout_decisions", task_id))
        return []

    def ensure_schema(self) -> None:
        self.schema_ensured = True

    def get_last_transition(self, task_id, from_state=None, to_state=None):
        self.calls.append(("get_last_transition", task_id, from_state, to_state))
        return None

    def apply_transition_with_receipts(self, request):
        self.calls.append(("apply_transition_with_receipts", request))
        raise NotImplementedError("Fake does not implement occupancy-bound transition commits")

    def record_recovery_approval(self, task_id, expected_source_state, destination_state,
                                  source_occupancy_transition_id, approver, decision, reason, actor) -> str:
        self.calls.append((
            "record_recovery_approval", task_id, expected_source_state, destination_state,
            source_occupancy_transition_id, approver, decision, reason, actor,
        ))
        return "fake-recovery-token"

    def apply_recovery_transition(self, task_id, expected_source_state, destination_state,
                                   source_occupancy_transition_id, approval_receipt_token, actor, reason):
        self.calls.append((
            "apply_recovery_transition", task_id, expected_source_state, destination_state,
            source_occupancy_transition_id, approval_receipt_token, actor, reason,
        ))
        raise NotImplementedError("Fake does not implement recovery transitions")

    def record_decision(self, decision) -> int:
        self.calls.append(("record_decision", decision))
        return 0

    def get_task_by_worktree_branch(self, branch: str):
        self.calls.append(("get_task_by_worktree_branch", branch))
        for t in self._tasks.values():
            if t.get("worktree_branch") == branch:
                return t
        return None

    def validate_task_pipeline_history(self, task_id: str, task_state: str):
        self.calls.append(("validate_task_pipeline_history", task_id, task_state))
        return None


def test_fake_persistence_port_proves_full_delegation():
    """Injects a fake PersistencePort with zero SQLite — via true constructor injection
    (persistence_adapter=..., added after external review round 2 correctly required this
    over monkeypatching a private attribute after construction) — and drives task creation,
    lookup, transition application, receipt recording, critic review, and worktree update
    through ControlPlane — proving every one of these operations actually delegates to the
    port rather than ControlPlane reimplementing the SQL itself. If ControlPlane silently
    reabsorbed any of this logic, the fake would never be called and this test would fail
    with a missing-call assertion, not just an absent substring."""
    fake = _FakePersistencePort()
    cp = ControlPlane(persistence_adapter=fake)

    cp.create_task(task_id="t1", title="Fake Persistence Task", runtime_tool="claude")
    assert ("insert_task", "t1", "Fake Persistence Task", "GENERAL", "claude", None, None, None) in fake.calls
    assert cp.get_task("t1") == fake._tasks["t1"]

    cp.record_premium_consent("t1", "interview", "round-1", "premium-model", "human")
    cp.require_premium_consent("t1", "interview", "round-1", "premium-model")
    candidate_id = cp.record_source_assisted_answer_candidate(
        "t1", "interview", "round-1", "scope", "P01 only", "docs/brief.md"
    )
    cp.confirm_source_assisted_answer_candidate(candidate_id, "human")
    cp.assert_interview_exit_ready("t1", "interview", "round-1")
    assert ("insert_premium_consent", "t1", "interview", "round-1", "premium-model", "human") in fake.calls
    assert ("has_premium_consent", "t1", "interview", "round-1", "premium-model") in fake.calls
    assert any(call[0] == "insert_source_assisted_answer_candidate" for call in fake.calls)
    assert ("confirm_source_assisted_answer_candidate", candidate_id, "human") in fake.calls
    assert ("has_unconfirmed_source_assisted_answer_candidates", "t1", "interview", "round-1") in fake.calls

    cp.transition(task_id="t1", to_state=STATE_INTERVIEW, actor="user", reason="test")
    assert ("apply_transition", "t1", STATE_INTAKE, STATE_INTERVIEW, "user", "test") in fake.calls
    assert fake._tasks["t1"]["state"] == STATE_INTERVIEW

    token = cp.record_verification_receipt(task_id="t1", gate_name="test_suite", command_executed="pytest", exit_code=0)
    assert any(c[0] == "insert_verification_receipt" and c[1] == "t1" for c in fake.calls)
    assert cp.get_verification_receipts("t1") == [{"task_id": "t1", "gate_name": "test_suite", "receipt_token": token}]

    cp.record_critic_review(task_id="t1", iteration=1, model="test-model", verdict="PASS", findings="ok")
    assert ("insert_critic_review", "t1", 1, "test-model", "PASS", "ok") in fake.calls

    cp.log_asymmetric_persistence(task_id="t1", destination="wiki/decisions/x.md", status="OBSERVED", details="d")
    assert ("insert_asymmetric_persistence", "t1", "wiki/decisions/x.md", "OBSERVED", "d") in fake.calls

    fake._tasks["t1"]["state"] = STATE_DONE  # satisfy the push-barrier policy check (must be DONE)
    cp.update_worktree(task_id="t1", worktree_path="/tmp/wt", worktree_branch="b", worktree_state="pushed_to_origin")
    assert ("update_worktree_fields", "t1", "/tmp/wt", "b", "pushed_to_origin") in fake.calls
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall