devex-cli 0.24.0__py3-none-any.whl

agent_experience/__init__.py

@@ -0,0 +1,24 @@
+from importlib.metadata import PackageNotFoundError, version
+
+
+def _resolve_version() -> str:
+    # `agex-cli` is the canonical PyPI distribution name; `agent-devex` and
+    # `devex-cli` are alias distributions that ship the identical wheel under
+    # different names. Whichever one is installed, surface its metadata
+    # version. As a final fallback for unbuilt source checkouts (no installed
+    # dist metadata), read the version directly from the repo's pyproject.toml
+    # so the version stays single-sourced from pyproject.toml in every
+    # reachable code path.
+    for dist in ("agex-cli", "agent-devex", "devex-cli"):
+        try:
+            return version(dist)
+        except PackageNotFoundError:
+            continue
+    import tomllib
+    from pathlib import Path
+
+    pyproject = Path(__file__).resolve().parents[2] / "pyproject.toml"
+    return tomllib.loads(pyproject.read_text(encoding="utf-8"))["project"]["version"]
+
+
+__version__ = _resolve_version()

agent_experience/__main__.py

@@ -0,0 +1,4 @@
+from agent_experience.cli import _main_entrypoint
+
+if __name__ == "__main__":
+    _main_entrypoint()

agent_experience/backends/acp/probe.py

@@ -0,0 +1,9 @@
+from pathlib import Path
+
+from agent_experience.backends.claude_code.probe import ProbeResult
+
+
+def probe(project_dir: Path) -> ProbeResult:
+    """Stub ACP probe — v0.1 returns empty. Full discovery tracked as open issue."""
+    del project_dir  # accepted for signature parity with other probes; real discovery deferred
+    return ProbeResult()

agent_experience/backends/capabilities/acp.yaml

@@ -0,0 +1,7 @@
+hooks: false
+hooks_alternative: |
+  ACP-speaking agents (KiroCLI, OpenCode) do not currently expose hooks.
+  Track usage via the ACP transport layer or a shell wrapper.
+mcp: true
+skills: false
+agents: false

agent_experience/backends/capabilities/claude-code.yaml

@@ -0,0 +1,4 @@
+hooks: true
+mcp: true
+skills: true
+agents: true

agent_experience/backends/capabilities/codex.yaml

@@ -0,0 +1,7 @@
+hooks: false
+hooks_alternative: |
+  Codex does not expose a hook interface. Wrap your Codex invocation in a shell
+  script that calls `agex hook write` before/after each turn as a workaround.
+mcp: true
+skills: false
+agents: false

agent_experience/backends/capabilities/copilot.yaml

@@ -0,0 +1,7 @@
+hooks: false
+hooks_alternative: |
+  GitHub Copilot CLI does not expose a hook interface in v0.1-era versions.
+  Track usage via a shell wrapper that calls `agex hook write`.
+mcp: false
+skills: false
+agents: false

agent_experience/backends/claude_code/probe.py

@@ -0,0 +1,97 @@
+import json
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
+
+import yaml
+
+from agent_experience.core.skill_loader import load_skill
+
+_CLAUDE_DIR = ".claude"
+
+
+@dataclass
+class ProbeResult:
+    skills: list[dict[str, Any]] = field(default_factory=list)
+    hooks: list[dict[str, Any]] = field(default_factory=list)
+    agents: list[dict[str, Any]] = field(default_factory=list)
+    mcp_servers: list[dict[str, Any]] = field(default_factory=list)
+    claude_md: Path | None = None
+    settings: dict[str, Any] | None = None
+    warnings: list[str] = field(default_factory=list)
+
+
+def _read_skill(path: Path) -> tuple[dict[str, Any] | None, str | None]:
+    try:
+        skill = load_skill(path)
+    except (ValueError, OSError, yaml.YAMLError) as e:
+        return None, str(e)
+    return (
+        {
+            "name": skill.name,
+            "description": skill.description,
+            "path": str(path),
+        },
+        None,
+    )
+
+
+def _probe_settings(claude_dir: Path, result: ProbeResult) -> None:
+    settings = claude_dir / "settings.json"
+    if not settings.exists():
+        return
+    try:
+        result.settings = json.loads(settings.read_text(encoding="utf-8"))
+    except (json.JSONDecodeError, OSError) as e:
+        result.warnings.append(f"could not parse {settings}: {e}")
+
+
+def _probe_skills(claude_dir: Path, result: ProbeResult) -> None:
+    skills_dir = claude_dir / "skills"
+    if not skills_dir.is_dir():
+        return
+    # Sort for deterministic snapshot ordering across platforms / filesystems.
+    for skill_md in sorted(skills_dir.glob("*/SKILL.md")):
+        parsed, err = _read_skill(skill_md)
+        if parsed is not None:
+            result.skills.append(parsed)
+        else:
+            result.warnings.append(f"could not parse {skill_md}: {err}")
+
+
+def _probe_hooks(claude_dir: Path, result: ProbeResult) -> None:
+    hooks_file = claude_dir / "hooks.json"
+    if not hooks_file.exists():
+        return
+    try:
+        data = json.loads(hooks_file.read_text(encoding="utf-8"))
+    except (json.JSONDecodeError, OSError) as e:
+        result.warnings.append(f"could not parse {hooks_file}: {e}")
+        return
+    if not isinstance(data, dict):
+        result.warnings.append(f"could not parse {hooks_file}: expected a JSON object")
+        return
+    for event, entries in data.items():
+        if not isinstance(entries, list):
+            result.warnings.append(
+                f"could not parse {hooks_file}: expected list for event '{event}'"
+            )
+            continue
+        result.hooks.append({"event": event, "entries": entries})
+
+
+def probe(project_dir: Path) -> ProbeResult:
+    result = ProbeResult()
+    if not project_dir.exists():
+        return result
+
+    claude_md = project_dir / "CLAUDE.md"
+    if claude_md.exists():
+        result.claude_md = claude_md
+
+    claude_dir = project_dir / _CLAUDE_DIR
+    _probe_settings(claude_dir, result)
+    _probe_skills(claude_dir, result)
+    _probe_hooks(claude_dir, result)
+
+    return result

agent_experience/backends/codex/probe.py

@@ -0,0 +1,16 @@
+from pathlib import Path
+
+from agent_experience.backends.claude_code.probe import ProbeResult
+
+
+def probe(project_dir: Path) -> ProbeResult:
+    """Minimal Codex probe — reads AGENTS.md if present. Other discovery deferred."""
+    result = ProbeResult()
+    if not project_dir.exists():
+        return result
+    agents_md = project_dir / "AGENTS.md"
+    if agents_md.exists():
+        result.claude_md = (
+            agents_md  # reusing field — rename to `project_memory` in a future cleanup
+        )
+    return result

agent_experience/backends/copilot/probe.py

@@ -0,0 +1,9 @@
+from pathlib import Path
+
+from agent_experience.backends.claude_code.probe import ProbeResult
+
+
+def probe(project_dir: Path) -> ProbeResult:
+    """Stub Copilot probe — v0.1 returns empty. Full discovery tracked as open issue."""
+    del project_dir  # accepted for signature parity with other probes; real discovery deferred
+    return ProbeResult()