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_content_snapshot.py

View on GitHub
"""
tests/test_content_snapshot.py
==============================

Purpose:
    Failing-first acceptance tests for T2 (auth-ciba-increment-b, issue #639):
    content-bound `revision_hash` for Gate 1 (AWAITING_APPROVAL -> APPROVED),
    design gap (b) in DEBT-20260918-TRANSITION-REQUEST-DESIGN-GAPS. The approval
    must bind the spec and implementation-plan files actually reviewed, so a change
    to them after the request invalidates the approval. Also covers the
    `transition_request` schema migration adding `challenge_version` and
    `content_snapshot`. Spec section 4 cases 4 and 8 (binding half). Real files in
    tmp_path and real disposable SQLite databases; nothing is mocked. The
    signature, commit-hook and occupancy parts of the approval belong to T3/T4/T6.

Key Input Dependencies:
    - control_plane/snapshot.py (SnapshotEntry, build_snapshot, gate1_artifact_paths,
      compute_revision_hash, snapshot_to_json/from_json, snapshot_matches,
      diff_snapshot, CHALLENGE_VERSION, SnapshotError)
    - control_plane/transition_request.py (create_transition_request,
      verify_and_consume, ContentChanged, ContentBindingRequired)
    - control_plane/adapters.py schema (transition_request columns + migration)

Key Functions (test cases):
    - test_snapshot_hashes_file_bytes_in_stable_order
    - test_snapshot_fails_closed_on_missing_artifact
    - test_snapshot_rejects_symlinked_artifact
    - test_gate1_paths_are_under_work_tasks_folder
    - test_revision_hash_is_deterministic_and_content_sensitive
    - test_revision_hash_without_snapshot_matches_legacy_formula
    - test_snapshot_json_round_trip_and_diff
    - test_create_request_stores_snapshot_and_version
    - test_content_change_after_request_blocks_consumption
    - test_unchanged_content_still_consumes
    - test_snapshot_bound_request_requires_live_snapshot
    - test_legacy_request_without_snapshot_is_unaffected
    - test_fresh_schema_has_snapshot_columns
    - test_legacy_database_is_migrated_without_data_loss
"""

import hashlib
import json
import secrets
import sqlite3
import sys
from pathlib import Path

import pytest

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

from agent_control import ControlPlane
from control_plane.snapshot import (
    CHALLENGE_VERSION,
    SnapshotEntry,
    SnapshotError,
    build_snapshot,
    compute_revision_hash,
    diff_snapshot,
    gate1_artifact_paths,
    snapshot_from_json,
    snapshot_matches,
    snapshot_to_json,
)
from control_plane.transition_request import (
    ContentBindingRequired,
    ContentChanged,
    create_transition_request,
    issue_stub_token,
    verify_and_consume,
)

TASK = "snapshot-task-001"


@pytest.fixture
def plan_files(tmp_path):
    """Spec and plan files in the work-tasks folder layout, under a fake repo root."""
    folder = tmp_path / "repo" / "docs" / "plans" / "work-tasks" / TASK
    folder.mkdir(parents=True)
    spec = folder / f"{TASK}-spec.md"
    plan = folder / f"{TASK}-implementation-plan.md"
    spec.write_text("# spec v1\n")
    plan.write_text("# plan v1\n")
    return {"root": tmp_path / "repo", "spec": spec, "plan": plan}


@pytest.fixture
def db_and_task(tmp_path):
    db_path = tmp_path / "control_plane.db"
    cp = ControlPlane(db_path=db_path)
    cp.init_db()
    cp.create_task(task_id=TASK, title="Snapshot test", runtime_tool="test")
    return sqlite3.connect(db_path), db_path


def _snapshot(plan_files):
    return build_snapshot(gate1_artifact_paths(plan_files["root"], TASK))


def _sha(path):
    return hashlib.sha256(Path(path).read_bytes()).hexdigest()


def test_snapshot_hashes_file_bytes_in_stable_order(plan_files):
    snap = _snapshot(plan_files)
    assert [e.label for e in snap] == ["spec", "plan"]
    assert snap[0].sha256 == _sha(plan_files["spec"])
    assert snap[1].sha256 == _sha(plan_files["plan"])
    assert all(isinstance(e, SnapshotEntry) for e in snap)


def test_snapshot_fails_closed_on_missing_artifact(plan_files):
    plan_files["plan"].unlink()
    with pytest.raises(SnapshotError):
        _snapshot(plan_files)


def test_snapshot_rejects_symlinked_artifact(plan_files, tmp_path):
    """A symlinked artifact could be redirected after review; fail closed."""
    other = tmp_path / "other.md"
    other.write_text("# elsewhere\n")
    plan_files["spec"].unlink()
    plan_files["spec"].symlink_to(other)
    with pytest.raises(SnapshotError):
        _snapshot(plan_files)


def test_gate1_paths_are_under_work_tasks_folder(plan_files):
    paths = dict(gate1_artifact_paths(plan_files["root"], TASK))
    assert paths["spec"] == plan_files["spec"]
    assert paths["plan"] == plan_files["plan"]
    assert "work-tasks" in str(paths["spec"])


def test_revision_hash_is_deterministic_and_content_sensitive(plan_files):
    snap = _snapshot(plan_files)
    base = compute_revision_hash(TASK, "AWAITING_APPROVAL", "APPROVED", 7, "nonce-a", snap)
    assert base == compute_revision_hash(TASK, "AWAITING_APPROVAL", "APPROVED", 7, "nonce-a", snap)
    assert len(base) == 64

    for change in (
        dict(nonce="nonce-b"),
        dict(occupancy=8),
        dict(to_state="DONE"),
    ):
        args = dict(task=TASK, frm="AWAITING_APPROVAL", to_state="APPROVED", occupancy=7, nonce="nonce-a")
        args.update(change)
        other = compute_revision_hash(
            args["task"], args["frm"], args["to_state"], args["occupancy"], args["nonce"], snap
        )
        assert other != base

    plan_files["spec"].write_text("# spec v2\n")
    assert compute_revision_hash(TASK, "AWAITING_APPROVAL", "APPROVED", 7, "nonce-a", _snapshot(plan_files)) != base
    plan_files["spec"].write_text("# spec v1\n")
    plan_files["plan"].write_text("# plan v2\n")
    assert compute_revision_hash(TASK, "AWAITING_APPROVAL", "APPROVED", 7, "nonce-a", _snapshot(plan_files)) != base


def test_revision_hash_without_snapshot_matches_legacy_formula():
    """Increment A callers pass no snapshot; their hash must not change."""
    legacy = hashlib.sha256(f"{TASK}:AWAITING_APPROVAL:APPROVED:7:nonce-a".encode("utf-8")).hexdigest()
    assert compute_revision_hash(TASK, "AWAITING_APPROVAL", "APPROVED", 7, "nonce-a", None) == legacy


def test_snapshot_json_round_trip_and_diff(plan_files):
    snap = _snapshot(plan_files)
    text = snapshot_to_json(snap)
    assert json.loads(text)[0]["label"] == "spec"
    assert snapshot_from_json(text) == snap
    assert snapshot_matches(text, snap)

    plan_files["plan"].write_text("# plan changed\n")
    changed = _snapshot(plan_files)
    assert not snapshot_matches(text, changed)
    assert diff_snapshot(text, changed) == ["plan"]


def test_create_request_stores_snapshot_and_version(db_and_task, plan_files):
    conn, _ = db_and_task
    snap = _snapshot(plan_files)
    record = create_transition_request(
        conn, task_id=TASK, from_state="AWAITING_APPROVAL", to_state="APPROVED",
        occupancy_id=1, content_snapshot=snap,
    )
    row = conn.execute(
        "SELECT revision_hash, challenge_version, content_snapshot FROM transition_request WHERE request_id = ?",
        (record.request_id,),
    ).fetchone()
    assert row[1] == CHALLENGE_VERSION == "control-plane-challenge/1"
    assert snapshot_from_json(row[2]) == snap
    assert row[0] == compute_revision_hash(TASK, "AWAITING_APPROVAL", "APPROVED", 1, record.nonce, snap)
    assert record.revision_hash == row[0]


def test_content_change_after_request_blocks_consumption(db_and_task, plan_files):
    conn, _ = db_and_task
    secret = secrets.token_bytes(32)
    record = create_transition_request(
        conn, task_id=TASK, from_state="AWAITING_APPROVAL", to_state="APPROVED",
        occupancy_id=1, content_snapshot=_snapshot(plan_files),
    )
    token = issue_stub_token(record, secret)

    plan_files["spec"].write_text("# spec edited after the request\n")
    with pytest.raises(ContentChanged) as excinfo:
        verify_and_consume(
            conn, task_id=TASK, token=token, secret=secret, live_snapshot=_snapshot(plan_files)
        )
    assert "spec" in str(excinfo.value)
    status = conn.execute(
        "SELECT status FROM transition_request WHERE request_id = ?", (record.request_id,)
    ).fetchone()[0]
    assert status == "PENDING"


def test_unchanged_content_still_consumes(db_and_task, plan_files):
    conn, _ = db_and_task
    secret = secrets.token_bytes(32)
    record = create_transition_request(
        conn, task_id=TASK, from_state="AWAITING_APPROVAL", to_state="APPROVED",
        occupancy_id=1, content_snapshot=_snapshot(plan_files),
    )
    token = issue_stub_token(record, secret)
    result = verify_and_consume(
        conn, task_id=TASK, token=token, secret=secret, live_snapshot=_snapshot(plan_files)
    )
    assert result.status == "CONSUMED"


def test_snapshot_bound_request_requires_live_snapshot(db_and_task, plan_files):
    """Fail closed: a request bound to content cannot be consumed without re-checking it."""
    conn, _ = db_and_task
    secret = secrets.token_bytes(32)
    record = create_transition_request(
        conn, task_id=TASK, from_state="AWAITING_APPROVAL", to_state="APPROVED",
        occupancy_id=1, content_snapshot=_snapshot(plan_files),
    )
    token = issue_stub_token(record, secret)
    with pytest.raises(ContentBindingRequired):
        verify_and_consume(conn, task_id=TASK, token=token, secret=secret)
    status = conn.execute(
        "SELECT status FROM transition_request WHERE request_id = ?", (record.request_id,)
    ).fetchone()[0]
    assert status == "PENDING"


def test_legacy_request_without_snapshot_is_unaffected(db_and_task):
    conn, _ = db_and_task
    secret = secrets.token_bytes(32)
    record = create_transition_request(
        conn, task_id=TASK, from_state="AWAITING_APPROVAL", to_state="APPROVED", occupancy_id=1,
    )
    row = conn.execute(
        "SELECT challenge_version, content_snapshot FROM transition_request WHERE request_id = ?",
        (record.request_id,),
    ).fetchone()
    assert row == (None, None)
    token = issue_stub_token(record, secret)
    assert verify_and_consume(conn, task_id=TASK, token=token, secret=secret).status == "CONSUMED"


def test_fresh_schema_has_snapshot_columns(db_and_task):
    conn, _ = db_and_task
    cols = {r[1] for r in conn.execute("PRAGMA table_info(transition_request)").fetchall()}
    assert {"challenge_version", "content_snapshot"} <= cols


def test_legacy_database_is_migrated_without_data_loss(tmp_path):
    """A pre-T2 database (transition_request without the new columns) gains them, keeps
    its rows, and a second init_db() is a no-op."""
    db_path = tmp_path / "legacy.db"
    conn = sqlite3.connect(db_path)
    conn.executescript(
        """
        CREATE TABLE transition_request (
            request_id INTEGER PRIMARY KEY AUTOINCREMENT,
            task_id TEXT NOT NULL,
            from_state TEXT NOT NULL,
            to_state TEXT NOT NULL,
            occupancy_id INTEGER NOT NULL,
            nonce TEXT NOT NULL UNIQUE,
            expiration REAL NOT NULL,
            revision_hash TEXT NOT NULL,
            status TEXT NOT NULL DEFAULT 'PENDING',
            jti TEXT,
            consumed_at REAL,
            created_at REAL NOT NULL
        );
        INSERT INTO transition_request
            (task_id, from_state, to_state, occupancy_id, nonce, expiration, revision_hash, created_at)
        VALUES ('legacy-task', 'AWAITING_APPROVAL', 'APPROVED', 1, 'legacy-nonce', 9e9, 'abc', 1.0);
        """
    )
    conn.commit()
    conn.close()

    cp = ControlPlane(db_path=db_path)
    cp.init_db()
    cp.init_db()  # idempotent

    conn = sqlite3.connect(db_path)
    cols = {r[1] for r in conn.execute("PRAGMA table_info(transition_request)").fetchall()}
    assert {"challenge_version", "content_snapshot"} <= cols
    row = conn.execute(
        "SELECT nonce, revision_hash, challenge_version, content_snapshot FROM transition_request"
    ).fetchone()
    assert row == ("legacy-nonce", "abc", None, None)
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