getcodexy 1.6.2__tar.gz → 1.7.0__tar.gz

getcodexy-1.7.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: getcodexy
+Version: 1.7.0
+Summary: A Codex harness for coordinating agents through planning, implementation, verification, and review.
+Author: Eunsoo Lee
+License-Expression: MIT
+Requires-Python: >=3.10
+Project-URL: Repository, https://github.com/eunsoogi/codexy
+Description-Content-Type: text/markdown
+
+# Codexy
+
+Codexy is a Codex harness for coordinating agents through planning,
+implementation, verification, and review.
+
+It helps Codex turn a broad repository request into an owned plan, divide work
+among agents, implement changes, verify actual outcomes, and keep the next
+handoff tied to current evidence.
+
+## Components
+
+Codexy is delivered as three cooperating components. `github` and `devtools`
+each depend on `core`; the installer adds those dependencies automatically.
+
+| Component  | Plugin            | What it adds                                                                                                                 |
+| ---------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `core`     | `codexy`          | Orchestration, finite goals and plans, worktree ownership, specialist roles, instruction hooks, and proof-driven completion. |
+| `github`   | `codexy-github`   | Issue-to-merge workflows for branches, pull requests, CI, review feedback, releases, and GitHub safety checks.               |
+| `devtools` | `codexy-devtools` | Local Codegraph and LSP servers, configuration, wrappers, and developer-tool guidance.                                       |
+
+The component model lets each repository install the capabilities it needs
+without losing a single ownership and verification contract.
+
+## Install
+
+Install the `getcodexy` command, then install the complete Codexy product:
+
+```sh
+uv tool install getcodexy
+uv tool update-shell
+```
+
+Start a new shell so the updated tool path is available, then install Codexy:
+
+```sh
+getcodexy install
+```
+
+The default selection installs `core`, `github`, and `devtools`. To choose a
+smaller dependency closure, name the optional components you need:
+
+```sh
+getcodexy install core
+getcodexy install github
+getcodexy install devtools
+getcodexy install github devtools
+```
+
+Open a fresh Codex session after installation or update so the host can expose
+the installed plugins, skills, agents, hooks, and MCP servers.
+
+## Maintain and check Codexy
+
+Keep the installer and installed component selection current, inspect health, or
+remove an optional component:
+
+```sh
+uv tool upgrade getcodexy
+getcodexy update
+getcodexy status
+getcodexy doctor
+getcodexy remove github
+```
+
+`status` reports the installed inventory and its consistency. `doctor` checks
+host readiness and the health of each installed component. Update and removal
+operations preserve the dependency closure and reject inconsistent selections.
+
+## Project links
+
+- [Source repository](https://github.com/eunsoogi/codexy)
+- [Issue tracker](https://github.com/eunsoogi/codexy/issues)
+- [License](https://github.com/eunsoogi/codexy/blob/main/LICENSE)

getcodexy-1.7.0/README.md

@@ -0,0 +1,73 @@
+# Codexy
+
+Codexy is a Codex harness for coordinating agents through planning,
+implementation, verification, and review.
+
+It helps Codex turn a broad repository request into an owned plan, divide work
+among agents, implement changes, verify actual outcomes, and keep the next
+handoff tied to current evidence.
+
+## Components
+
+Codexy is delivered as three cooperating components. `github` and `devtools`
+each depend on `core`; the installer adds those dependencies automatically.
+
+| Component  | Plugin            | What it adds                                                                                                                 |
+| ---------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `core`     | `codexy`          | Orchestration, finite goals and plans, worktree ownership, specialist roles, instruction hooks, and proof-driven completion. |
+| `github`   | `codexy-github`   | Issue-to-merge workflows for branches, pull requests, CI, review feedback, releases, and GitHub safety checks.               |
+| `devtools` | `codexy-devtools` | Local Codegraph and LSP servers, configuration, wrappers, and developer-tool guidance.                                       |
+
+The component model lets each repository install the capabilities it needs
+without losing a single ownership and verification contract.
+
+## Install
+
+Install the `getcodexy` command, then install the complete Codexy product:
+
+```sh
+uv tool install getcodexy
+uv tool update-shell
+```
+
+Start a new shell so the updated tool path is available, then install Codexy:
+
+```sh
+getcodexy install
+```
+
+The default selection installs `core`, `github`, and `devtools`. To choose a
+smaller dependency closure, name the optional components you need:
+
+```sh
+getcodexy install core
+getcodexy install github
+getcodexy install devtools
+getcodexy install github devtools
+```
+
+Open a fresh Codex session after installation or update so the host can expose
+the installed plugins, skills, agents, hooks, and MCP servers.
+
+## Maintain and check Codexy
+
+Keep the installer and installed component selection current, inspect health, or
+remove an optional component:
+
+```sh
+uv tool upgrade getcodexy
+getcodexy update
+getcodexy status
+getcodexy doctor
+getcodexy remove github
+```
+
+`status` reports the installed inventory and its consistency. `doctor` checks
+host readiness and the health of each installed component. Update and removal
+operations preserve the dependency closure and reject inconsistent selections.
+
+## Project links
+
+- [Source repository](https://github.com/eunsoogi/codexy)
+- [Issue tracker](https://github.com/eunsoogi/codexy/issues)
+- [License](https://github.com/eunsoogi/codexy/blob/main/LICENSE)

{getcodexy-1.6.2 → getcodexy-1.7.0}/pyproject.toml

@@ -5,8 +5,9 @@ backend-path = ["."]
 
 [project]
 name = "getcodexy"
-version = "1.6.2"
-description = "Version-pinned MCP runtime bootstrap tools for Codexy"
+version = "1.7.0"
+description = "A Codex harness for coordinating agents through planning, implementation, verification, and review."
+readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"
 license = "MIT"
 authors = [{ name = "Eunsoo Lee" }]
@@ -23,4 +24,4 @@ codexy-github-check = "codexy_runtime_tools.github_checks:main"
 [tool.uv.build-backend]
 module-name = "codexy_runtime_tools"
 module-root = "src"
-source-include = ["build_backend.py", "uv.lock"]
+source-include = ["README.md", "build_backend.py", "uv.lock"]

{getcodexy-1.6.2 → getcodexy-1.7.0}/src/codexy_runtime_tools/_version_data/uv.lock

@@ -4,5 +4,5 @@ requires-python = ">=3.10"
 
 [[package]]
 name = "getcodexy"
-version = "1.6.2"
+version = "1.7.0"
 source = { editable = "." }

{getcodexy-1.6.2 → getcodexy-1.7.0}/src/codexy_runtime_tools/component-manifest.json

@@ -10,6 +10,7 @@
     "conflicting-component-request": "A component request contains a duplicate or conflicting operand.",
     "conflicting-installed-state": "An installed record does not match its official marketplace asset.",
     "dependency-protected-removal": "A retained component still requires a requested removal.",
+    "hook-state-unavailable": "The trusted host did not return an inspectable effective Codexy hook state.",
     "incompatible-component-selection": "A component selection is not in the manifest compatibility set.",
     "inconsistent-installed-state": "The installed inventory violates component dependencies.",
     "installed-state-mismatch": "The fresh installed inventory differs from the expected selection.",
@@ -18,6 +19,9 @@
     "mixed-version-state": "Installed components do not share one lockstep version.",
     "no-recorded-selection": "update requires a recorded installed component inventory.",
     "operation-failed": "A mutation did not complete and its pre-operation selection was restored.",
+    "required-hook-disabled": "A required Codexy hook is present but disabled in the host activation state.",
+    "required-hook-trust-missing": "A required Codexy hook is not present in the host trusted activation state.",
+    "required-hook-trust-stale": "A required Codexy hook trust entry no longer matches the installed hook.",
     "unknown-component": "A named component is not core, github, or devtools.",
     "unknown-installed-component": "The official Codexy marketplace inventory contains an unrecognized product."
   },
@@ -25,7 +29,7 @@
     {
       "id": "core",
       "plugin": "codexy",
-      "version": "1.6.2",
+      "version": "1.7.0",
       "dependencies": [],
       "asset": {
         "pluginId": "codexy@codexy",
@@ -33,6 +37,9 @@
         "requiredPaths": [
           ".codex-plugin/plugin.json",
           "assets/codexy-icon.png",
+          ".mcp.json",
+          "mcp/codexy-mcp-watcher.sh",
+          "mcp/codexy-mcp-watcher.cmd",
           "skills/dreaming/scripts/resumable-context-capsule.sh",
           "skills/dreaming/scripts/resumable-context-capsule.cmd",
           "skills/dreaming/scripts/resumable_context_capsule.py"
@@ -42,7 +49,7 @@
     {
       "id": "github",
       "plugin": "codexy-github",
-      "version": "1.6.2",
+      "version": "1.7.0",
       "dependencies": [
         "core"
       ],
@@ -58,7 +65,7 @@
     {
       "id": "devtools",
       "plugin": "codexy-devtools",
-      "version": "1.6.2",
+      "version": "1.7.0",
       "dependencies": [
         "core"
       ],
@@ -75,27 +82,27 @@
   "compatibleCombinations": [
     {
       "components": [],
-      "version": "1.6.2"
+      "version": "1.7.0"
     },
     {
       "components": [
         "core"
       ],
-      "version": "1.6.2"
+      "version": "1.7.0"
     },
     {
       "components": [
         "core",
         "github"
       ],
-      "version": "1.6.2"
+      "version": "1.7.0"
     },
     {
       "components": [
         "core",
         "devtools"
       ],
-      "version": "1.6.2"
+      "version": "1.7.0"
     },
     {
       "components": [
@@ -103,7 +110,7 @@
         "github",
         "devtools"
       ],
-      "version": "1.6.2"
+      "version": "1.7.0"
     }
   ]
 }

getcodexy-1.7.0/src/codexy_runtime_tools/component_capability_observation.py

@@ -0,0 +1,106 @@
+"""Additive capability observations for the read-only doctor report."""
+
+from __future__ import annotations
+
+from typing import Mapping
+
+
+UNKNOWN = "unknown"
+_DIRECT_SOURCE = "getcodexy-direct-probe"
+_DIRECT_SCOPE = "plugin-subprocess"
+_REGISTRATION_SOURCE = "getcodexy-registration-check"
+_REGISTRATION_SCOPE = "current-doctor-invocation"
+
+CAPABILITIES = {
+    "core": (
+        "hook:codexy-thread-delivery",
+        "specialist:codexy-architect",
+        "specialist:codexy-auditor",
+        "specialist:codexy-cartographer",
+        "specialist:codexy-inspector",
+        "specialist:codexy-sentinel",
+        "specialist:codexy-shipwright",
+        "specialist:codexy-warden",
+    ),
+    "github": ("hook:codexy-github-workflow-context", "specialist:codexy-weaver"),
+    "devtools": ("mcp:codegraph", "mcp:lsp"),
+}
+
+
+def component_observations(
+    component: str,
+    configured: bool,
+    probe: Mapping[str, object] | None = None,
+) -> dict[str, dict[str, object]]:
+    """Return per-capability states without claiming native host execution."""
+    observations = {
+        name: _entry(configured, source=_REGISTRATION_SOURCE, scope=_REGISTRATION_SCOPE)
+        for name in CAPABILITIES.get(component, ())
+    }
+    if not probe:
+        return observations
+    direct = probe.get("_capability_probes")
+    if not isinstance(direct, dict):
+        direct = {}
+    for name in observations:
+        details = direct.get(name)
+        if isinstance(details, dict):
+            observations[name] = _entry(
+                configured,
+                started=details.get("started") is True,
+                callable=details.get("callable") is True,
+                source=_DIRECT_SOURCE,
+                scope=_DIRECT_SCOPE,
+            )
+    return observations
+
+
+def probe_observation(
+    capability: str,
+    configured: bool,
+    started: bool,
+    callable_: bool,
+) -> dict[str, dict[str, object]]:
+    """Describe one direct probe for health's additive observation mapping."""
+    return {
+        capability: {
+            "configured": configured,
+            "started": started,
+            "callable": callable_,
+        }
+    }
+
+
+def record_probe(
+    target: dict[str, object],
+    capability: str,
+    configured: bool,
+    started: bool,
+    callable_: bool,
+) -> None:
+    """Attach one current direct-probe result to an internal probe payload."""
+    probes = target.setdefault("_capability_probes", {})
+    if isinstance(probes, dict):
+        probes.update(probe_observation(capability, configured, started, callable_))
+
+
+def _entry(
+    configured: bool,
+    *,
+    started: bool = False,
+    callable: bool = False,
+    source: str,
+    scope: str,
+) -> dict[str, object]:
+    return {
+        "states": {
+            "configured": "configured" if configured else UNKNOWN,
+            "loaded": "loaded" if started else UNKNOWN,
+            "callable": "callable" if callable else UNKNOWN,
+            "verified": UNKNOWN,
+        },
+        "source": source if configured or started or callable else UNKNOWN,
+        "scope": scope if configured or started or callable else UNKNOWN,
+        "host_id": None,
+        "session_id": None,
+    }

{getcodexy-1.6.2 → getcodexy-1.7.0}/src/codexy_runtime_tools/component_capability_probe.py

@@ -2,10 +2,18 @@
 
 import json
 import os
-from collections import namedtuple
 import shlex
 import subprocess
 
+from .component_hook_activation import ACTIVATION_REPAIRS
+from .component_capability_observation import record_probe
+from .component_capability_probe_process import (
+    _RUN_OPTIONS,
+    _RunResult,
+    _probe_diagnostics,
+    _run,
+)
+from .component_watcher_probe import probe_watcher as _probe_watcher
 from .version_lock import default_package_version
 
 
@@ -16,8 +24,6 @@ _START_REPAIR = f"repair the installed launcher/runtime, then {_RERUN}"
 _CALL_REPAIR = f"use the reported safe component fallback and {_RERUN}"
 _EXPOSED_REPAIR = "repair the Codexy registration, then restart Codex"
 _IDENTITY_REPAIR = "reinstall the selected release, then restart Codex"
-_RUN_OPTIONS = {"capture_output": True, "text": True, "timeout": 5}
-_RunResult = namedtuple("_RunResult", "returncode stdout category")
 FAILURES = {
     "trusted-inventory-unavailable": (_INVENTORY_REPAIR, False),
     "component-not-installed": ("getcodexy bootstrap", True),
@@ -27,6 +33,7 @@ FAILURES = {
     "capability-call-failed": (_CALL_REPAIR, False),
     "runtime-identity-mismatch": (_IDENTITY_REPAIR, True),
     "artifact-authority-invalid": ("reinstall from a trusted release artifact", True),
+    **ACTIVATION_REPAIRS,
 }
 HOOK_SPECS = {
     "core": ("PermissionRequest", "codexy-thread-delivery"),
@@ -53,17 +60,34 @@ def probe_component(component, plugin, record):
     base = _base(record)
     if plugin is None:
         return base
+    if component == "core":
+        return _probe_core(plugin, base)
     probe = _probe_hook if component in HOOK_SPECS else _probe_devtools
     return probe(component, plugin, base)
 
 
+def _probe_core(plugin, base):
+    hook = _probe_hook("core", plugin, base)
+    if not hook.get("started") or not hook.get("callable"):
+        return hook
+    watcher = _probe_watcher(plugin, base)
+    probes = dict(hook.get("_capability_probes", {}))
+    probes.update(watcher.get("_capability_probes", {}))
+    watcher["_capability_probes"] = probes
+    if not watcher.get("started") or not watcher.get("callable"):
+        return watcher
+    return _outcome(base, _capability_probes=probes)
+
+
 def _probe_hook(component, plugin, base):
     event, marker = HOOK_SPECS[component]
+    capability = f"hook:{marker}"
     payload = {"prompt": "review GitHub issue 723"}
     if component == "core":
         payload = {"tool_name": "codex_app__send_message_to_thread", "tool_input": {}}
     command = _registered_hook(plugin, event, marker)
     if not command:
+        record_probe(base, capability, False, False, False)
         return _failure(base, "capability-not-exposed")
     result = _run(
         _argv(command, plugin),
@@ -71,10 +95,13 @@ def _probe_hook(component, plugin, base):
         json.dumps(payload),
         os.environ | {"PLUGIN_ROOT": str(plugin)},
     )
+    base["_capability_probe"] = _probe_diagnostics(result)
     base["_category"] = result.category
     if result.category == "missing-launcher":
+        record_probe(base, capability, True, False, False)
         return _failure(base, "component-start-failed", started=False)
     if result.category in {"timeout", "nonzero-exit"}:
+        record_probe(base, capability, True, True, False)
         return _failure(base, "capability-call-failed")
     try:
         output = json.loads(result.stdout.strip().splitlines()[-1])[
@@ -87,6 +114,8 @@ def _probe_hook(component, plugin, base):
         valid = False
     if not valid:
         base["_category"] = "malformed-output"
+        base["_capability_probe"]["category"] = "malformed-output"
+    record_probe(base, capability, True, True, valid)
     reason = None if valid else "capability-not-exposed"
     return _outcome(base, callable=valid, reason_code=reason)
 
@@ -108,71 +137,6 @@ def _registered_hook(plugin, event, marker):
     return None
 
 
-def _probe_devtools(_component, plugin, base):
-    try:
-        config = json.loads((plugin / ".mcp.json").read_text(encoding="utf-8"))
-    except (OSError, ValueError, json.JSONDecodeError):
-        return _failure(base, "capability-not-exposed")
-    probes = []
-    for server in MCP_SPECS:
-        server_config = config.get(server) if isinstance(config, dict) else None
-        result = probe_server(server, plugin, server_config)
-        if not result.get("started") or not result.get("callable"):
-            return result
-        probes.append(result)
-    return _outcome(
-        base,
-        runtime_name=",".join(str(item["runtime_name"]) for item in probes),
-        runtime_version=probes[0]["runtime_version"],
-        runtime_names=[item["runtime_name"] for item in probes],
-        runtime_versions=[item["runtime_version"] for item in probes],
-    )
-
-
-def probe_server(server, plugin, config):
-    base = _base()
-    if not isinstance(config, dict) or not isinstance(config.get("command"), str):
-        return _failure(base, "capability-not-exposed")
-    target, extra = MCP_SPECS[server]
-    arguments = {"root": str(plugin), **extra}
-    requests = (
-        _request("initialize", 1, _INITIALIZE_PARAMS),
-        _request("notifications/initialized"),
-        _request("tools/list", 2),
-        _request("tools/call", 3, {"name": target, "arguments": arguments}),
-    )
-    returncode, responses, timed = _rpc(
-        _argv(config["command"], plugin, config.get("args", ())), plugin, requests
-    )
-    if 1 not in responses:
-        failed = bool(returncode or timed)
-        reason = "component-start-failed" if failed else "capability-not-exposed"
-        return _failure(base, reason, started=not failed)
-    initialized = responses[1].get("result", {})
-    listed = responses.get(2, {}).get("result", {})
-    info = initialized.get("serverInfo", {}) if isinstance(initialized, dict) else {}
-    tools = listed.get("tools", []) if isinstance(listed, dict) else []
-    if (
-        not isinstance(info, dict)
-        or not isinstance(tools, list)
-        or not any(
-            isinstance(tool, dict) and tool.get("name") == target for tool in tools
-        )
-    ):
-        return _failure(base, "capability-not-exposed")
-    call = responses.get(3, {})
-    result = call.get("result") if isinstance(call, dict) else None
-    if (
-        not isinstance(result, dict)
-        or any((call.get("error"), call.get("isError"), result.get("isError")))
-        or not isinstance(result.get("content"), list)
-    ):
-        return _failure(base, "capability-call-failed")
-    return _outcome(
-        base, runtime_name=info.get("name"), runtime_version=info.get("version")
-    )
-
-
 def _base(record=None):
     return dict(
         started=False,
@@ -190,33 +154,6 @@ def _outcome(base, **fields):
     return {**base, "started": True, "callable": True, **fields}
 
 
-def _run(argv, cwd, input_text, env=None):
-    try:
-        result = subprocess.run(
-            argv, input=input_text, cwd=cwd, env=env, **_RUN_OPTIONS
-        )
-    except subprocess.TimeoutExpired as error:
-        return _RunResult(-1, error.stdout or "", "timeout")
-    except OSError:
-        return _RunResult(-1, "", "missing-launcher")
-    category = "success" if result.returncode == 0 else "nonzero-exit"
-    category = "missing-launcher" if result.returncode == 127 else category
-    return _RunResult(result.returncode, result.stdout, category)
-
-
-def _rpc(argv, cwd, requests):
-    run = _run(argv, cwd, "\n".join(json.dumps(request) for request in requests) + "\n")
-    values = {}
-    for line in (run.stdout or "").splitlines():
-        try:
-            value = json.loads(line)
-        except (ValueError, json.JSONDecodeError):
-            continue
-        if isinstance(value, dict) and isinstance(value.get("id"), int):
-            values[value["id"]] = value
-    return run.returncode, values, run.category == "timeout"
-
-
 def _argv(command, plugin, args=()):
     values = shlex.split(command.replace("${PLUGIN_ROOT}", str(plugin))) + [
         str(value) for value in (args if isinstance(args, list) else ())
@@ -232,6 +169,9 @@ def _argv(command, plugin, args=()):
     return values
 
 
+from .component_mcp_probe import _probe_devtools, probe_server  # noqa: E402
+
+
 def probe_reason(probe, default):
     reason = probe.get("reason_code")
     return reason if isinstance(reason, str) and reason in FAILURES else default