From 819691df0550b28068a67e930202e80d1d33dabf Mon Sep 17 00:00:00 2001 From: ProtocolWarden <32967198+ProtocolWarden@users.noreply.github.com> Date: Tue, 19 May 2026 04:12:55 -0400 Subject: [PATCH] =?UTF-8?q?chore:=20rename=20ExecutorRuntime=20=E2=86=92?= =?UTF-8?q?=20CoreRunner=20in=20all=20docs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 4.6 --- .console/log.md | 4 ++++ CONTRIBUTING.md | 4 ++-- README.md | 10 +++++----- SECURITY.md | 2 +- rxp/vocabulary/runtime_kind.py | 2 +- 5 files changed, 13 insertions(+), 9 deletions(-) diff --git a/.console/log.md b/.console/log.md index d930605..35854fa 100644 --- a/.console/log.md +++ b/.console/log.md @@ -58,3 +58,7 @@ truth; pre-push catches regressions before they hit GitHub. - Added CLAUDE.md to .gitignore - Added .custodian/tmp*.yaml to exclude custodian audit temp files + +## 2026-05-19 — ADR 0006 Phase 5: rename ExecutorRuntime → CoreRunner in RxP docs + +README.md, SECURITY.md, CONTRIBUTING.md, rxp/vocabulary/runtime_kind.py updated. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 4fa345a..e5f0799 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -42,7 +42,7 @@ tests/ # contract + schema validation tests RxP is the **contract layer only**. It must not contain: -- Subprocess execution or runner logic (belongs in ExecutorRuntime) +- Subprocess execution or runner logic (belongs in CoreRunner) - Source/fork resolution (belongs in SourceRegistry) - Routing or lane-selection logic (belongs in SwitchBoard) - Planning, scheduling, watchers, or queue systems @@ -71,7 +71,7 @@ OperationsCenter typically maps a CxRP `ExecutionRequest` to an RxP `RuntimeInvo - [ ] Schemas updated under `schemas/vX.Y/` (if contract changed) - [ ] Examples updated under `examples/vX.Y/` (if contract changed) - [ ] Spec updated in `docs/spec/` (if normative behavior changed) -- [ ] Downstream impact noted (ExecutorRuntime, OperationsCenter) +- [ ] Downstream impact noted (CoreRunner, OperationsCenter) ## Code Style diff --git a/README.md b/README.md index 073ac90..41c2512 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,7 @@ RxP is not: - OperationsCenter - SwitchBoard - SourceRegistry -- ExecutorRuntime +- CoreRunner - a scheduler - a runner - a subprocess library @@ -36,14 +36,14 @@ pip install -e . ```python from rxp import RuntimeInvocation, RuntimeResult inv = RuntimeInvocation(runtime_kind="subprocess", argv=["echo", "hello"]) -# Hand the invocation to ExecutorRuntime; receive a RuntimeResult. +# Hand the invocation to CoreRunner; receive a RuntimeResult. ``` JSON Schemas live under `rxp/schemas/` for non-Python consumers. ## Architecture -RxP is a contract layer — three Pydantic models (`RuntimeInvocation`, `RuntimeResult`, `ArtifactDescriptor`) plus their `runtime_kind` / `runtime_status` enum vocabularies and JSON Schemas. ExecutorRuntime consumes the contract; CxRP describes work routing *to* a runtime, RxP describes the request/response *with* the runtime. See **CxRP vs RxP** below for the split, **v0.1 scope** for what's frozen, and **Example lifecycle** for an end-to-end walkthrough. +RxP is a contract layer — three Pydantic models (`RuntimeInvocation`, `RuntimeResult`, `ArtifactDescriptor`) plus their `runtime_kind` / `runtime_status` enum vocabularies and JSON Schemas. CoreRunner consumes the contract; CxRP describes work routing *to* a runtime, RxP describes the request/response *with* the runtime. See **CxRP vs RxP** below for the split, **v0.1 scope** for what's frozen, and **Example lifecycle** for an end-to-end walkthrough. ## CxRP vs RxP @@ -65,6 +65,6 @@ RxP = how a runtime is invoked and what runtime result came back ## Example lifecycle OperationsCenter maps CxRP ExecutionRequest to RxP RuntimeInvocation. -ExecutorRuntime consumes RxP RuntimeInvocation. -ExecutorRuntime produces RxP RuntimeResult. +CoreRunner consumes RxP RuntimeInvocation. +CoreRunner produces RxP RuntimeResult. OperationsCenter maps RxP RuntimeResult back to CxRP ExecutionResult. diff --git a/SECURITY.md b/SECURITY.md index c66db0f..ca25613 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -33,6 +33,6 @@ RxP is a **contract-only specification**. It defines schemas, vocabulary enums, ## Out of Scope -- Vulnerabilities in downstream consumers (ExecutorRuntime, OperationsCenter) — report those to the respective project +- Vulnerabilities in downstream consumers (CoreRunner, OperationsCenter) — report those to the respective project - Vulnerabilities in `jsonschema` or other upstream dependencies — report upstream - Misuse of RxP contracts by an implementing system (e.g., trusting unvalidated `command` input) diff --git a/rxp/vocabulary/runtime_kind.py b/rxp/vocabulary/runtime_kind.py index f75946b..ffa9f07 100644 --- a/rxp/vocabulary/runtime_kind.py +++ b/rxp/vocabulary/runtime_kind.py @@ -16,6 +16,6 @@ polls a status URL until a terminal status. Sync from the caller's POV. - ``container``: containerized runtime (placeholder). - ``manual``: caller-supplied dispatcher (used for out-of-process services - whose transport ExecutorRuntime does not own). + whose transport CoreRunner does not own). - ``unknown``: catch-all for anything else. """