jeanclode 0.1.0__tar.gz

jeanclode-0.1.0/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: jeanclode
+Version: 0.1.0
+Summary: Multi-plugin CLI — auto-detects what to do from URLs and invokes Claude Code skills
+Author: Jeanclode Contributors
+License-Expression: AGPL-3.0
+Project-URL: Homepage, https://jeanclode.com
+Project-URL: Repository, https://github.com/jeanclode-hq/jeanclode
+Project-URL: Issues, https://github.com/jeanclode-hq/jeanclode/issues
+Project-URL: Documentation, https://jeanclode.com/docs
+Keywords: sentry,ai,llm,bug-fix,automation,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: claude-agent-sdk>=0.2.144
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pydantic>=2.9.0
+Requires-Dist: rich>=13.0.0

jeanclode-0.1.0/jeanclode.egg-info/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: jeanclode
+Version: 0.1.0
+Summary: Multi-plugin CLI — auto-detects what to do from URLs and invokes Claude Code skills
+Author: Jeanclode Contributors
+License-Expression: AGPL-3.0
+Project-URL: Homepage, https://jeanclode.com
+Project-URL: Repository, https://github.com/jeanclode-hq/jeanclode
+Project-URL: Issues, https://github.com/jeanclode-hq/jeanclode/issues
+Project-URL: Documentation, https://jeanclode.com/docs
+Keywords: sentry,ai,llm,bug-fix,automation,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: claude-agent-sdk>=0.2.144
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pydantic>=2.9.0
+Requires-Dist: rich>=13.0.0

jeanclode-0.1.0/jeanclode.egg-info/SOURCES.txt

@@ -0,0 +1,183 @@
+pyproject.toml
+jeanclode.egg-info/PKG-INFO
+jeanclode.egg-info/SOURCES.txt
+jeanclode.egg-info/dependency_links.txt
+jeanclode.egg-info/entry_points.txt
+jeanclode.egg-info/requires.txt
+jeanclode.egg-info/top_level.txt
+src/__init__.py
+src/cli.py
+src/config.py
+src/config_file.py
+src/log.py
+src/main.py
+src/output.py
+src/plugin_paths.py
+src/workspace.py
+src/activities/__init__.py
+src/activities/decorator.py
+src/activities/notify.py
+src/activities/ci_watch/__init__.py
+src/activities/ci_watch/github.py
+src/activities/ci_watch/gitlab.py
+src/activities/ci_watch/poll.py
+src/activities/ci_watch/schemas.py
+src/activities/git/__init__.py
+src/activities/git/ops.py
+src/activities/git/pr.py
+src/activities/git/schemas.py
+src/activities/git/targets.py
+src/activities/issue/__init__.py
+src/activities/issue/comment.py
+src/activities/issue/fetch.py
+src/activities/issue/schemas.py
+src/activities/issue/utils.py
+src/activities/respond/__init__.py
+src/activities/respond/relabel.py
+src/activities/respond/schemas.py
+src/activities/respond/threads.py
+src/activities/review/__init__.py
+src/activities/review/dedup.py
+src/activities/review/guardrail.py
+src/activities/review/posting.py
+src/activities/review/recovery.py
+src/activities/review/routing.py
+src/activities/review/schemas.py
+src/activities/review/styling.py
+src/activities/sentry/__init__.py
+src/activities/sentry/fetch.py
+src/activities/sentry/git.py
+src/activities/sentry/pr.py
+src/activities/sentry/route.py
+src/activities/sentry/schemas.py
+src/activities/sentry/secrets.py
+src/activities/summary/__init__.py
+src/activities/summary/format_summary.py
+src/activities/summary/schemas.py
+src/activities/summary/update_description.py
+src/adaptors/__init__.py
+src/adaptors/base.py
+src/adaptors/diffn.py
+src/adaptors/discussions.py
+src/adaptors/display.py
+src/adaptors/registry.py
+src/adaptors/github/__init__.py
+src/adaptors/github/adaptor.py
+src/adaptors/github/auth.py
+src/adaptors/github/client.py
+src/adaptors/github/context.py
+src/adaptors/github/display.py
+src/adaptors/github/resolver.py
+src/adaptors/github/sha.py
+src/adaptors/gitlab/__init__.py
+src/adaptors/gitlab/adaptor.py
+src/adaptors/gitlab/auth.py
+src/adaptors/gitlab/client.py
+src/adaptors/gitlab/context.py
+src/adaptors/gitlab/display.py
+src/adaptors/gitlab/resolver.py
+src/adaptors/gitlab/sha.py
+src/adaptors/sentry/__init__.py
+src/adaptors/sentry/adaptor.py
+src/adaptors/sentry/auth.py
+src/adaptors/sentry/client.py
+src/adaptors/sentry/display.py
+src/adaptors/sentry/resolver.py
+src/agents/__init__.py
+src/agents/_memory_backend.py
+src/agents/base.py
+src/agents/hooks.py
+src/agents/memory_tool.py
+src/agents/schemas.py
+src/agents/utils.py
+src/agents/issue/__init__.py
+src/agents/issue/base.py
+src/agents/issue/fixer.py
+src/agents/issue/schemas.py
+src/agents/issue/triage.py
+src/agents/respond/__init__.py
+src/agents/respond/base.py
+src/agents/respond/planner.py
+src/agents/respond/schemas.py
+src/agents/review/__init__.py
+src/agents/review/analyzer.py
+src/agents/review/base.py
+src/agents/review/deduplicator.py
+src/agents/review/fact_checker.py
+src/agents/review/issue_explorer.py
+src/agents/review/schemas.py
+src/agents/review/styler.py
+src/agents/review/synthesizer.py
+src/agents/sentry/__init__.py
+src/agents/sentry/base.py
+src/agents/sentry/fixer.py
+src/agents/sentry/synthesis.py
+src/agents/sentry/triage.py
+src/agents/summary/__init__.py
+src/agents/summary/base.py
+src/agents/summary/parser.py
+src/agents/summary/schemas.py
+src/agents/summary/summarizer.py
+src/runner/__init__.py
+src/runner/display_subscriber.py
+src/runner/preflight.py
+src/runner/run.py
+src/runtime/__init__.py
+src/runtime/bots.py
+src/runtime/bus.py
+src/runtime/context.py
+src/runtime/events.py
+src/runtime/mcp_connectors.py
+src/runtime/notify.py
+src/skills/__init__.py
+src/skills/discovery.py
+src/skills/prompt.py
+src/skills/schemas.py
+src/skills/thirdparty.py
+src/workflows/__init__.py
+src/workflows/base.py
+src/workflows/schemas.py
+src/workflows/utils.py
+src/workflows/_smoke/__init__.py
+src/workflows/_smoke/echo.py
+src/workflows/code_review/__init__.py
+src/workflows/code_review/runner.py
+src/workflows/code_review/utils.py
+src/workflows/issue_resolve/__init__.py
+src/workflows/issue_resolve/runner.py
+src/workflows/issue_resolve/utils.py
+src/workflows/jeanclode_respond/__init__.py
+src/workflows/jeanclode_respond/runner.py
+src/workflows/jeanclode_respond/utils.py
+src/workflows/pr_summary/__init__.py
+src/workflows/pr_summary/runner.py
+src/workflows/pr_summary/utils.py
+src/workflows/sentry_fix/__init__.py
+src/workflows/sentry_fix/runner.py
+src/workflows/sentry_fix/utils.py
+tests/test_activity_decorator.py
+tests/test_base_agent.py
+tests/test_base_agent_continuity.py
+tests/test_base_agent_mcp_connectors.py
+tests/test_base_agent_memory.py
+tests/test_base_agent_skills.py
+tests/test_cli.py
+tests/test_config.py
+tests/test_config_file.py
+tests/test_conftest_eval_isolation.py
+tests/test_display_subscriber.py
+tests/test_event_bus.py
+tests/test_mcp_connectors.py
+tests/test_notify.py
+tests/test_output.py
+tests/test_parallel_agents.py
+tests/test_preflight.py
+tests/test_run.py
+tests/test_run_context.py
+tests/test_skills_discovery.py
+tests/test_skills_prompt.py
+tests/test_skills_thirdparty.py
+tests/test_smoke_workflow.py
+tests/test_tool_summary.py
+tests/test_workflow_registry.py
+tests/test_workspace.py

jeanclode-0.1.0/jeanclode.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

jeanclode-0.1.0/jeanclode.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+jeanclode = src.main:cli_entry

jeanclode-0.1.0/jeanclode.egg-info/requires.txt

@@ -0,0 +1,4 @@
+claude-agent-sdk>=0.2.144
+jinja2>=3.1.0
+pydantic>=2.9.0
+rich>=13.0.0

jeanclode-0.1.0/jeanclode.egg-info/top_level.txt

@@ -0,0 +1 @@
+src

jeanclode-0.1.0/pyproject.toml

@@ -0,0 +1,166 @@
+[project]
+name = "jeanclode"
+version = "0.1.0" # x-release-please-version
+description = "Multi-plugin CLI — auto-detects what to do from URLs and invokes Claude Code skills"
+authors = [{ name = "Jeanclode Contributors" }]
+readme = "README.md"
+requires-python = ">=3.14"
+license = "AGPL-3.0"
+keywords = ["sentry", "ai", "llm", "bug-fix", "automation", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+]
+
+dependencies = [
+    "claude-agent-sdk>=0.2.144",
+    "jinja2>=3.1.0",
+    "pydantic>=2.9.0",
+    "rich>=13.0.0",
+]
+
+[project.scripts]
+jeanclode = "src.main:cli_entry"
+
+[project.urls]
+Homepage = "https://jeanclode.com"
+Repository = "https://github.com/jeanclode-hq/jeanclode"
+Issues = "https://github.com/jeanclode-hq/jeanclode/issues"
+Documentation = "https://jeanclode.com/docs"
+
+[build-system]
+requires = ["setuptools>=75.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+include = ["src", "src.*"]
+exclude = ["tests*"]
+
+# Ruff Configuration
+[tool.ruff]
+target-version = "py314"
+line-length = 100
+fix = true
+
+lint.select = [
+    "E",     # pycodestyle errors
+    "W",     # pycodestyle warnings
+    "F",     # pyflakes
+    "I",     # isort
+    "B",     # flake8-bugbear
+    "C4",    # flake8-comprehensions
+    "UP",    # pyupgrade
+    "ARG",   # flake8-unused-arguments
+    "SIM",   # flake8-simplify
+    "PTH",   # flake8-use-pathlib
+    "RUF",   # Ruff-specific rules
+    "ASYNC", # flake8-async
+]
+lint.ignore = [
+    "E501",  # line too long (handled by formatter)
+    "B008",  # do not perform function calls in argument defaults
+    "UP007", # Use X | Y for type annotations (pydantic compatibility)
+]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["F401"]          # Unused imports in __init__.py
+"tests/**/*.py" = ["ARG", "S101"] # Pytest uses assertions
+
+[tool.ruff.lint.isort]
+known-first-party = ["src"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+# MyPy Configuration
+[tool.mypy]
+python_version = "3.14"
+strict = true
+pretty = true
+show_error_codes = true
+warn_return_any = true
+warn_unused_configs = true
+allow_redefinition = true
+disallow_untyped_defs = true
+disallow_any_generics = true
+disallow_subclassing_any = true
+disallow_untyped_calls = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+no_implicit_reexport = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_unreachable = true
+strict_equality = true
+plugins = ["pydantic.mypy"]
+mypy_path = "$MYPY_CONFIG_FILE_DIR"
+namespace_packages = true
+explicit_package_bases = true
+local_partial_types = true
+
+exclude = "^(tests|docs|venv|env|scripts)/"
+
+[[tool.mypy.overrides]]
+module = ["claude_agent_sdk.*"]
+ignore_missing_imports = true
+
+[tool.pydantic-mypy]
+init_forbid_extra = true
+init_typed = true
+warn_required_dynamic_aliases = true
+
+# Pytest Configuration
+[tool.pytest.ini_options]
+minversion = "8.0"
+addopts = [
+    "-ra",
+    "--strict-markers",
+    "--strict-config",
+    "--cov=src",
+    "--cov-report=term-missing",
+    "-m not eval",
+]
+testpaths = ["tests"]
+pythonpath = ["."]
+asyncio_mode = "auto"
+markers = [
+    "eval: LLM evaluation tests — opt-in, require GOOGLE_API_KEY or GEMINI_API_KEY",
+]
+
+# Coverage Configuration
+[tool.coverage.run]
+source = ["src"]
+branch = true
+omit = ["*/tests/*", "*/__init__.py"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "class .*\\bProtocol\\):",
+    "@(abc\\.)?abstractmethod",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+    "pytest-asyncio>=1.2.0",
+    "pytest-cov>=7.0.0",
+    "pytest-mock>=3.15.1",
+    "ruff>=0.15.4",
+    "mypy>=1.19.1",
+    "setuptools>=82.0.0",
+    "deepeval>=2.0.0",
+    "litellm>=1.0.0",
+]

jeanclode-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

jeanclode-0.1.0/src/__init__.py

@@ -0,0 +1,8 @@
+"""Jeanclode CLI — triage Sentry errors and invoke Claude Code to fix bugs."""
+
+import importlib.metadata
+
+try:
+    __version__: str = importlib.metadata.version("jeanclode")
+except importlib.metadata.PackageNotFoundError:
+    __version__ = "0.0.0-dev"

jeanclode-0.1.0/src/activities/__init__.py

@@ -0,0 +1,5 @@
+"""Activities — small deterministic units of work composed by workflows."""
+
+from src.activities.decorator import activity
+
+__all__ = ["activity"]

jeanclode-0.1.0/src/activities/ci_watch/__init__.py

@@ -0,0 +1,19 @@
+"""ci-watch — verify a pushed fix against the target repo's own CI.
+
+Enforced via ``src.agents.hooks.require_ci_pass_hook`` — a PreToolUse hook on
+the schema-bound fixer's ``StructuredOutput`` call, not an agent-callable
+tool (a tool call is something a model can skip; this hook fires on every
+attempt to finalize the turn and can't be opted out of). It gates
+``StructuredOutput`` rather than ``Stop`` because a ``Stop`` block lands
+after the structured output is already submitted and the CLI drops it. See
+``docs/adr/008-ci-gated-fix-verification.md`` for the design rationale.
+"""
+
+from src.activities.ci_watch.poll import check_ci
+from src.activities.ci_watch.schemas import CheckResult, CiWatchResult
+
+__all__ = [
+    "CheckResult",
+    "CiWatchResult",
+    "check_ci",
+]

jeanclode-0.1.0/src/activities/ci_watch/github.py

@@ -0,0 +1,157 @@
+"""GitHub CI discovery — Checks API + legacy Status API, via `gh`.
+
+Both are queried and merged: modern checks (Actions, most integrations) live
+in the Checks API, older/third-party CI in the legacy Status API. `gh`
+infers `{owner}/{repo}` from the git remote via its own placeholder
+substitution, so no repo slug is threaded through these functions.
+"""
+
+from __future__ import annotations
+
+import json
+import re
+import subprocess
+from pathlib import Path
+from typing import Any
+
+from src.activities.ci_watch.schemas import CheckBucket, CheckResult, truncate_log
+
+_BLOCKED_CONCLUSIONS = {"action_required", "stale", "skipped", "neutral"}
+_FAILURE_CONCLUSIONS = {"failure", "cancelled", "timed_out"}
+
+# GitHub's check-runs/status list endpoints default to 30 per page; 100 is
+# the max. Same failure mode verified live on GitLab's job list (a 25-job
+# pipeline silently lost its one real failure past the default page of 20).
+_MAX_PER_PAGE = 100
+
+# An Actions check-run's details_url looks like
+# https://github.com/{owner}/{repo}/actions/runs/{run_id}/job/{job_id} —
+# verified against a live check-run. Non-Actions apps (CodeQL, third-party
+# CI) point elsewhere and simply won't match.
+_ACTIONS_RUN_JOB_RE = re.compile(r"/actions/runs/(?P<run_id>\d+)/job/(?P<job_id>\d+)")
+
+
+def _run_gh(args: list[str], *, cwd: Path) -> subprocess.CompletedProcess[str]:
+    return subprocess.run(["gh", *args], cwd=cwd, capture_output=True, text=True, check=False)
+
+
+def _api_json(args: list[str], *, cwd: Path) -> Any | None:
+    """Run `gh api ...` and return parsed JSON, or None on any failure."""
+    proc = _run_gh(args, cwd=cwd)
+    if proc.returncode != 0 or not proc.stdout.strip():
+        return None
+    try:
+        return json.loads(proc.stdout)
+    except json.JSONDecodeError:
+        return None
+
+
+def _bucket_for_conclusion(conclusion: str) -> CheckBucket:
+    if conclusion == "success":
+        return "success"
+    if conclusion in _FAILURE_CONCLUSIONS:
+        return "failure"
+    if conclusion in _BLOCKED_CONCLUSIONS:
+        return "blocked"
+    return "running"
+
+
+def list_check_runs(ref: str, *, cwd: Path) -> list[dict[str, Any]]:
+    """Return every check-run on `ref` (a SHA or branch name)."""
+    data = _api_json(
+        ["api", f"repos/{{owner}}/{{repo}}/commits/{ref}/check-runs?per_page={_MAX_PER_PAGE}"],
+        cwd=cwd,
+    )
+    return data.get("check_runs", []) if isinstance(data, dict) else []
+
+
+def combined_status(ref: str, *, cwd: Path) -> list[dict[str, Any]]:
+    """Return every legacy Status API entry on `ref`."""
+    data = _api_json(
+        ["api", f"repos/{{owner}}/{{repo}}/commits/{ref}/status?per_page={_MAX_PER_PAGE}"], cwd=cwd
+    )
+    return data.get("statuses", []) if isinstance(data, dict) else []
+
+
+def required_check_names(branch: str, *, cwd: Path) -> set[str] | None:
+    """Best-effort: names of checks that actually block merging on `branch`.
+
+    Requires admin-level read access to branch protection, which we may not
+    have. Returns None on any failure (403/404/malformed) so the caller can
+    fall back to treating every discovered check as required.
+    """
+    data = _api_json(
+        ["api", f"repos/{{owner}}/{{repo}}/branches/{branch}/protection/required_status_checks"],
+        cwd=cwd,
+    )
+    if not isinstance(data, dict):
+        return None
+    contexts = data.get("contexts") or []
+    return set(contexts) if contexts else None
+
+
+def failed_run_log(details_url: str, *, cwd: Path) -> str:
+    """Best-effort failing-step log for a GitHub Actions check-run.
+
+    Parses the run/job id straight out of the check-run's own `details_url`
+    rather than matching by name: a check-run's `name` is per-job (e.g.
+    "test-backend"), but `gh run list` only exposes per-*workflow* names
+    (e.g. "CI") — they never match. `gh run view --log-failed` then handles
+    the zip/redirect dance the raw Actions logs API otherwise needs.
+    Non-Actions checks (CodeQL, third-party apps) have a different
+    `details_url` shape and simply return "".
+    """
+    match = _ACTIONS_RUN_JOB_RE.search(details_url)
+    if not match:
+        return ""
+    proc = _run_gh(
+        ["run", "view", match["run_id"], "--job", match["job_id"], "--log-failed"],
+        cwd=cwd,
+    )
+    if proc.returncode != 0:
+        return ""
+    return truncate_log(proc.stdout)
+
+
+def discover(ref: str, *, cwd: Path, fetch_logs: bool = True) -> list[CheckResult]:
+    """Discover every check on `ref` (the head commit's SHA) across both
+    GitHub signal APIs.
+
+    Required-check weighting is applied by the caller (`poll.py`), which
+    knows the actual PR branch — required-status-checks are keyed by branch,
+    not SHA, so that step can't happen in here.
+    """
+    results: list[CheckResult] = []
+    for run in list_check_runs(ref, cwd=cwd):
+        status = run.get("status")
+        conclusion = run.get("conclusion") or ""
+        bucket: CheckBucket = (
+            "running" if status != "completed" else _bucket_for_conclusion(conclusion)
+        )
+        name = run.get("name", "")
+        details_url = run.get("details_url", "")
+        log_excerpt = ""
+        if fetch_logs and bucket == "failure":
+            log_excerpt = failed_run_log(details_url, cwd=cwd)
+        results.append(
+            CheckResult(
+                name=name,
+                bucket=bucket,
+                raw_conclusion=conclusion or status or "",
+                log_excerpt=log_excerpt,
+                details_url=details_url,
+            )
+        )
+    status_buckets: dict[str, CheckBucket] = {"success": "success", "pending": "running"}
+    for status_entry in combined_status(ref, cwd=cwd):
+        state = status_entry.get("state", "")
+        status_bucket = status_buckets.get(state, "failure")
+        results.append(
+            CheckResult(
+                name=status_entry.get("context", ""),
+                bucket=status_bucket,
+                raw_conclusion=state,
+                details_url=status_entry.get("target_url", ""),
+            )
+        )
+    return results