richfrem/agent-plugins-skills / plugins/agent-agentic-os/.apm/skills/running-control-plane
running-control-plane
FlaggedCRITICAL 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).
tests/test_health_check_signing_status.py
View on GitHub"""
tests/test_health_check_signing_status.py
=========================================
Purpose:
Failing-first acceptance tests for T14 (auth-ciba-increment-b, issue #639, spec case 17): the
os-control-health skill gains a READ-ONLY, ADVISORY phase reporting the Gate 1 signing-identity
status. The health check is a phased procedure in SKILL.md executed by an agent, so the phase
text and the spoked status command are the deliverables: the phase must name the exact read-only
command, state that a green result is not proof of human presence, and forbid the agent from
running the setup or touching keys. The spoked `setup_ciba_identity.py --check` must run from
inside the skill folder (a self-contained installed copy) and never write anything.
The self-test-age record planned in the ledger is deferred (no self-test record exists yet).
Key Input Dependencies:
- skills/os-control-health/SKILL.md, skills/os-control-health/scripts/ (spokes)
- scripts/setup_ciba_identity.py (--check), control_plane/identity_*.py
Key Functions (test cases):
- test_skill_has_a_read_only_advisory_signing_phase
- test_spoked_status_command_runs_from_the_skill_folder_and_writes_nothing
- test_status_reports_ready_only_when_isolated_and_enrolled
"""
import os
import subprocess
import sys
from pathlib import Path
SETUP_SCRIPTS = Path(__file__).resolve().parents[2] / "setting-up-agentic-os" / "scripts" # the setup skill beside this one
PLUGIN = Path(__file__).resolve().parent.parent
SKILL = PLUGIN
WORKFLOW = PLUGIN / "references" / "modes" / "health.md"
_scripts_dir = str(PLUGIN / "scripts")
if _scripts_dir not in sys.path:
sys.path.insert(0, _scripts_dir)
def _status(repo, *extra):
return subprocess.run(
[sys.executable, str(SETUP_SCRIPTS / "setup_ciba_identity.py"), "--check", "--repo-root", str(repo), *extra],
capture_output=True, text=True,
)
def test_skill_has_a_read_only_verification_readiness_phase():
text = WORKFLOW.read_text()
assert "Cryptographic Verification Readiness" in text
assert "scripts/setup_ciba_identity.py --check" in text
lowered = text.lower()
assert "not proof of human presence" in lowered
assert "never run" in lowered and "setup_ciba_identity.py" in lowered
assert "ssh-keygen" in lowered and "allowed_signers" in lowered
def test_spoked_status_command_runs_from_the_skill_folder_and_writes_nothing(tmp_path):
result = _status(tmp_path)
assert result.returncode == 1 # not ready
assert "not set up" in result.stdout.lower()
assert not (tmp_path / "context").exists()
def test_status_reports_ready_only_when_isolated_and_enrolled(tmp_path):
from control_plane.identity_layout import default_layout
from control_plane.identity_setup import enroll_key
key = tmp_path / "id"
subprocess.run(["ssh-keygen", "-q", "-t", "ed25519", "-N", "pw", "-C", "t", "-f", str(key)], check=True, capture_output=True)
repo = tmp_path / "repo"
repo.mkdir()
enroll_key(default_layout(repo), "op@local", (tmp_path / "id.pub").read_text().strip())
unresolved = _status(repo, "--agent-name", "no-such-agent-account-xyz") # deterministic: independent of a real agentic-os-local-agent account: enrolled but not isolated
assert unresolved.returncode == 1 and "enrolled keys: 1" in unresolved.stdout
other_uid = os.geteuid() + 4242
ready = _status(repo, "--agent-uid", str(other_uid))
assert ready.returncode == 0 and "ready" in ready.stdout.lower() and "SHA256:" in ready.stdout
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |