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

scripts/control_plane/constants.py

View on GitHub
"""
control_plane/constants.py -- Single Shared Source for Cross-File Domain Constants
====================================================================================

Purpose:
    One shared module for every named constant that means something specific to the
    control-plane's domain and is referenced from more than one file (production or
    test). Every consumer imports from here rather than retyping the literal or
    defining a second, independent copy of the same value elsewhere. Replaces an
    earlier per-module-colocation convention after review found that split ownership
    (state names in state_machine.py, decision types in adapters.py, etc.) still left
    consumers guessing which file to import from -- one shared file removes that
    ambiguity (per config-driven-constants-over-hardcoding.md).

Layer:
    OS Kernel / Execution Control Plane Substrate -- Domain constants (no logic).

Key Input Dependencies:
    None -- pure constant definitions, no I/O, no imports from sibling control_plane
    modules (this file must stay a leaf so anything can import it without a cycle).

Key Contents (grouped by domain; see each section for what enforces/consumes it):
    - STATE_* / CANONICAL_STATE_NAMES -- the 15 task lifecycle state names. The
      adjacency DAG (ALLOWED_TRANSITIONS) and CANONICAL_STATES list built from these
      still live in state_machine.py, since that IS domain logic, not just a constant.
    - DECISION_TYPE_* / DECISION_TYPES -- transition_decisions.decision_type values.
    - ACTOR_* -- the three recognized actor values (human/agent/system).
    - COST_TIER_* / COST_TIERS -- model capability cost tiers.
    - CONFIRMATION_STATUS_* -- source_assisted_answer_candidates confirmation states.
    - GATE_* / SKIPPED_REVIEW_GATE_NAMES_SQL -- verification_receipts gate names for
      the multi-agent review skip path.
    - ERROR_CODE_* -- record_interview_question.py's denial-envelope error codes.
    - GUIDANCE_COMPLIANCE_CONFIRM_ANSWER -- the one accepted answer to the mandatory
      guidance-compliance confirmation question (see coordinator.py).
    - REASON_* -- free-text, non-enforced reason/label strings reused across test call
      sites (e.g. "interview complete", "Worktree created"). Not constrained by any
      production CHECK/comparison, but still defined once here rather than in a
      separate test-only file, per the "one shared file for everything reused across
      files" direction -- tests/interview_helpers.py re-exports them for backward
      compatibility with existing `from interview_helpers import REASON_*` call sites.
    - sql_in_list() -- helper used to render a constants tuple as a SQL `IN (...)`
      literal list for SCHEMA_SQL in adapters.py.
"""

from pathlib import Path


from typing import Iterable

# --- Task lifecycle state names -------------------------------------------------
# The adjacency DAG (ALLOWED_TRANSITIONS) and the ordered CANONICAL_STATES list built
# from these constants live in state_machine.py (domain logic owns the DAG shape);
# state_machine.py imports the names below rather than redefining them.
STATE_INTAKE = "INTAKE"
STATE_INTERVIEW = "INTERVIEW"
STATE_DRAFT_PLAN = "DRAFT_PLAN"
STATE_MULTI_AGENT_REVIEW = "MULTI_AGENT_REVIEW"
STATE_PLAN_REVIEW = "PLAN_REVIEW"
STATE_AWAITING_APPROVAL = "AWAITING_APPROVAL"
STATE_APPROVED = "APPROVED"
STATE_IN_WORKTREE = "IN_WORKTREE"
STATE_WORKTREE_REVIEW = "WORKTREE_REVIEW"
STATE_MULTI_AGENT_CODE_REVIEW = "MULTI_AGENT_CODE_REVIEW"
STATE_VERIFY_EXIT = "VERIFY_EXIT"
STATE_RETROSPECTIVE = "RETROSPECTIVE"
STATE_DONE = "DONE"
STATE_ROLLED_BACK = "ROLLED_BACK"
STATE_ESCALATED = "ESCALATED"

CANONICAL_STATE_NAMES = (
    STATE_INTAKE, STATE_INTERVIEW, STATE_DRAFT_PLAN, STATE_MULTI_AGENT_REVIEW,
    STATE_PLAN_REVIEW, STATE_AWAITING_APPROVAL, STATE_APPROVED, STATE_IN_WORKTREE,
    STATE_WORKTREE_REVIEW, STATE_MULTI_AGENT_CODE_REVIEW, STATE_VERIFY_EXIT,
    STATE_RETROSPECTIVE, STATE_DONE, STATE_ROLLED_BACK, STATE_ESCALATED,
)

# --- transition_decisions.decision_type ------------------------------------------
DECISION_TYPE_ANSWER = "ANSWER"
DECISION_TYPE_APPROVAL = "APPROVAL"
DECISION_TYPE_REJECTION = "REJECTION"
DECISION_TYPE_SKIP = "SKIP"
DECISION_TYPE_CONFIRMATION = "CONFIRMATION"
DECISION_TYPE_RESET = "RESET"
DECISION_TYPES = (
    DECISION_TYPE_ANSWER, DECISION_TYPE_APPROVAL, DECISION_TYPE_REJECTION,
    DECISION_TYPE_SKIP, DECISION_TYPE_CONFIRMATION, DECISION_TYPE_RESET,
)

# --- Actors -----------------------------------------------------------------------
ACTOR_HUMAN = "human"
ACTOR_AGENT = "agent"
ACTOR_SYSTEM = "system"

# --- Per-edge authorized-actor classification (auth-ciba-poc-transition-mechanics,
# issues #621/#626/#634) -- derived from each edge's approval block at registry-load
# time (TransitionTemplate.authorized_actor), not a hand-maintained parallel field.
AUTHORIZED_ACTOR_HUMAN_ONLY = "human_only"
AUTHORIZED_ACTOR_AGENT_OR_HUMAN = "agent_or_human"

# --- Model capability cost tiers ---------------------------------------------------
COST_TIER_LOW = "low"
COST_TIER_MEDIUM = "medium"
COST_TIER_HIGH = "high"
COST_TIERS = (COST_TIER_LOW, COST_TIER_MEDIUM, COST_TIER_HIGH)

# --- source_assisted_answer_candidates.confirmation_status -------------------------
CONFIRMATION_STATUS_PENDING = "pending"
CONFIRMATION_STATUS_CONFIRMED = "confirmed"

# --- tasks.task_type -----------------------------------------------------------------
TASK_TYPE_GENERAL = "GENERAL"
TASK_TYPE_EVOLUTION = "EVOLUTION"
TASK_TYPES = (TASK_TYPE_GENERAL, TASK_TYPE_EVOLUTION)

# --- tasks.worktree_state -- the exact 6-state vocabulary from
# worktree-lifecycle-management.md's "Six States" section; keep in sync with that doc.
WORKTREE_STATE_WRITTEN_IN_WORKTREE = "written_in_worktree"
WORKTREE_STATE_COMMITTED_IN_WORKTREE = "committed_in_worktree"
WORKTREE_STATE_PUSHED_TO_ORIGIN = "pushed_to_origin"
WORKTREE_STATE_MERGED_INTO_ORIGIN_MAIN = "merged_into_origin_main"
WORKTREE_STATE_LOCAL_BRANCH_REF_UPDATED = "local_branch_ref_updated"
WORKTREE_STATE_CHECKED_OUT_ON_DISK = "checked_out_on_disk"
WORKTREE_STATES = (
    WORKTREE_STATE_WRITTEN_IN_WORKTREE, WORKTREE_STATE_COMMITTED_IN_WORKTREE,
    WORKTREE_STATE_PUSHED_TO_ORIGIN, WORKTREE_STATE_MERGED_INTO_ORIGIN_MAIN,
    WORKTREE_STATE_LOCAL_BRANCH_REF_UPDATED, WORKTREE_STATE_CHECKED_OUT_ON_DISK,
)

# --- proof-required edges (auth-ciba-increment-b T4, issue #639) -------------------------

# --- verification_receipts gate names (multi-agent review skip path) ---------------
GATE_MULTI_AGENT_REVIEW_SKIPPED = "multi_agent_review_skipped"
GATE_MULTI_AGENT_CODE_REVIEW_SKIPPED = "multi_agent_code_review_skipped"
SKIPPED_REVIEW_GATE_NAMES = (GATE_MULTI_AGENT_REVIEW_SKIPPED, GATE_MULTI_AGENT_CODE_REVIEW_SKIPPED)

# --- critic_reviews.verdict ---------------------------------------------------------
CRITIC_VERDICT_PASS = "PASS"
CRITIC_VERDICT_REVISE = "REVISE"
CRITIC_VERDICT_REJECT = "REJECT"
CRITIC_VERDICTS = (CRITIC_VERDICT_PASS, CRITIC_VERDICT_REVISE, CRITIC_VERDICT_REJECT)

# --- asymmetric_persistence_log.status -----------------------------------------------
PERSISTENCE_LOG_STATUS_OBSERVED = "OBSERVED"
PERSISTENCE_LOG_STATUS_HYPOTHESIS = "HYPOTHESIS"
PERSISTENCE_LOG_STATUS_CONFIRMED = "CONFIRMED"
PERSISTENCE_LOG_STATUS_RESOLVED = "RESOLVED"
PERSISTENCE_LOG_STATUSES = (
    PERSISTENCE_LOG_STATUS_OBSERVED, PERSISTENCE_LOG_STATUS_HYPOTHESIS,
    PERSISTENCE_LOG_STATUS_CONFIRMED, PERSISTENCE_LOG_STATUS_RESOLVED,
)

# --- retrospective_entries.decision / .completion_mode -------------------------------
RETROSPECTIVE_DECISION_OPT_IN = "opt_in"
RETROSPECTIVE_DECISION_SKIP = "skip"
RETROSPECTIVE_DECISIONS = (RETROSPECTIVE_DECISION_OPT_IN, RETROSPECTIVE_DECISION_SKIP)

RETROSPECTIVE_COMPLETION_MODE_DRAFT = "draft"
RETROSPECTIVE_COMPLETION_MODE_COMPLETED = "completed"
RETROSPECTIVE_COMPLETION_MODE_SKIPPED = "skipped"
RETROSPECTIVE_COMPLETION_MODES = (
    RETROSPECTIVE_COMPLETION_MODE_DRAFT, RETROSPECTIVE_COMPLETION_MODE_COMPLETED,
    RETROSPECTIVE_COMPLETION_MODE_SKIPPED,
)

# --- retrospective_follow_ups.kind / .status ------------------------------------------
FOLLOW_UP_KIND_DIRECT = "direct"
FOLLOW_UP_KIND_ISSUE = "issue"
FOLLOW_UP_KINDS = (FOLLOW_UP_KIND_DIRECT, FOLLOW_UP_KIND_ISSUE)

FOLLOW_UP_STATUS_PROPOSED = "proposed"
FOLLOW_UP_STATUS_CONFIRMED = "confirmed"
FOLLOW_UP_STATUS_REJECTED = "rejected"
FOLLOW_UP_STATUS_CREATED = "created"
FOLLOW_UP_STATUSES = (
    FOLLOW_UP_STATUS_PROPOSED, FOLLOW_UP_STATUS_CONFIRMED,
    FOLLOW_UP_STATUS_REJECTED, FOLLOW_UP_STATUS_CREATED,
)

# --- delegation_contracts.status -----------------------------------------------------
DELEGATION_STATUS_PENDING_APPROVAL = "PENDING_APPROVAL"
DELEGATION_STATUS_APPROVED = "APPROVED"
DELEGATION_STATUS_EXECUTING = "EXECUTING"
DELEGATION_STATUS_ACCEPTED = "ACCEPTED"
DELEGATION_STATUS_REJECTED = "REJECTED"
DELEGATION_STATUSES = (
    DELEGATION_STATUS_PENDING_APPROVAL, DELEGATION_STATUS_APPROVED,
    DELEGATION_STATUS_EXECUTING, DELEGATION_STATUS_ACCEPTED, DELEGATION_STATUS_REJECTED,
)

# --- ModelCatalogAdapter heuristics --------------------------------------------------
DISALLOWED_MODEL_STATUSES = frozenset({"withdrawn", "deprecated", "unavailable"})
STRATEGY_FALLBACK_KEYS = ("complex_reasoning", "architecture", "default")

# Repo-relative directory holding the cli-agent model catalogs (*-models.json and
# cheapest_models.json), owned by the consolidated cli-agent skill in agent-orchestration.
# Where the running install keeps its scripts. Agent-facing command hints name the CLI by this
# absolute path, so they are right under any APM install (project .claude/skills, .agents/skills,
# a global folder) and in the source tree alike; never a path that exists only in the monorepo.
CONTROL_SCRIPTS_DIR = Path(__file__).resolve().parent.parent


def script_cmd(relative_path: str) -> str:
    """Command line that runs one of this skill's scripts, e.g. script_cmd("agent_control.py")."""
    return f"python3 {CONTROL_SCRIPTS_DIR / relative_path}"


AGENT_CONTROL_CMD = script_cmd("agent_control.py")

# Reference documents the code points people at, as absolute paths in the running install.
CONTROL_SKILL_DIR = CONTROL_SCRIPTS_DIR.parent
# The setup skill sits beside this one (APM installs skills side by side); its human-run signing script:
SETUP_SCRIPTS_DIR = CONTROL_SKILL_DIR.parent / "setting-up-agentic-os" / "scripts"
SETUP_IDENTITY_CMD = f"python3 {SETUP_SCRIPTS_DIR / 'setup_ciba_identity.py'}"
ISOLATION_SETUP_DOC = str(SETUP_SCRIPTS_DIR.parent / "references" / "isolation-setup.md")  # lives in the setup skill, which cites it
REBUILD_RECOVERY_DOC = str(CONTROL_SKILL_DIR / "references" / "control-plane-rebuild-recovery.md")

CLI_AGENT_CATALOG_DIR = ("plugins", "agent-orchestration", "skills", "cli-agent", "references")

# Tool key -> (canonical cli_id, catalog filename). Aliases map many recognized spellings
# of the same runtime tool onto one canonical id; unrecognized/missing tool_key falls back
# to "copilot" (ModelCatalogAdapter._resolve_tool_catalog's own default, not encoded here).
TOOL_CATALOG_ALIASES = {
    "claude": ("claude", "claude-models.json"),
    "claude-code": ("claude", "claude-models.json"),
    "copilot": ("copilot", "copilot-models.json"),
    "github-copilot": ("copilot", "copilot-models.json"),
    "antigravity": ("agy", "agy-models.json"),
    "agy": ("agy", "agy-models.json"),
    "gemini": ("agy", "agy-models.json"),
    "codex": ("codex", "codex-models.json"),
    "openai": ("codex", "codex-models.json"),
}

# --- Special transition_decisions question IDs referenced from
# the enforce_valid_transition trigger (defined twice in adapters.py: once in the
# fresh-create SCHEMA_SQL, once in _rebuild_schema_transactional()'s trigger
# recreation) -- both derive from these so they can never drift apart from each other.
QUESTION_ID_RETROSPECTIVE_DECISION = "retrospective_decision"
# (Removed 2026-09-20: QUESTION_ID_FORCE_CLOSE_AUTHORIZATION, QUESTION_ID_HUMAN_FORCE_DONE_CONFIRMATION,
# ANSWER_FORCE_CLOSE, ANSWER_FORCE_DONE -- every edge into DONE now takes a cryptographic signature.)

# --- record_interview_question.py denial-envelope error codes ----------------------
ERROR_CODE_CAPABILITY_DENIED = "CAPABILITY_DENIED"
ERROR_CODE_CONTRACT_DENIED = "CONTRACT_DENIED"
ERROR_CODE_PERSISTENCE_DENIED = "PERSISTENCE_DENIED"

# --- coordinator.py mandatory guidance-compliance confirmation ---------------------
GUIDANCE_COMPLIANCE_CONFIRM_ANSWER = "YES"


# --- Test-only free-text reason/label strings ---------------------------------------
# Not enforced by any production CHECK constraint -- these exist purely so test call
# sites read as intent ("why is this transition happening") instead of retyping the
# same literal per test file. Kept in this same shared file (not a separate one) per
# explicit direction: one shared constants module for everything reused across files,
# production or test, rather than splitting by production/test boundary.
REASON_INTERVIEW_COMPLETE = "interview complete"
REASON_WORKTREE_CREATED = "Worktree created"
REASON_WORKTREE_ISOLATED = "Worktree isolated"
REASON_NOT_NEEDED_FOR_TEST = "Not needed for this test"
REASON_PLAN_DISPOSITION = "plan disposition"
REASON_ENTER_DRAFT_PLAN = "Enter draft plan"
REASON_ATTEMPT_COMPLETE = "Attempt complete"


def sql_in_list(values: Iterable[str]) -> str:
    """Renders a tuple of plain string constants as a SQL `IN (...)` literal list,
    e.g. ('a', 'b') -> "'a', 'b'". Used to build SCHEMA_SQL (the current fresh-create
    schema in adapters.py) from these constants -- never used on SCHEMA_MIGRATIONS,
    which is an immutable historical record and must keep its own literal strings."""
    return ", ".join(f"'{v}'" for v in values)
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 CodeCodexUnverifiedInstall
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