agex-cli 0.22.0__tar.gz → 0.23.0__tar.gz

{agex_cli-0.22.0 → agex_cli-0.23.0}/.github/workflows/publish.yml

@@ -27,15 +27,20 @@ name: publish
 # One-time setup on pypi.org / test.pypi.org and in the repo's Environments
 # (`pypi`, `testpypi`) is documented in the original header below:
 #
-#   - PyPI project `agex-cli` → Publishing → Add a GitHub pending publisher
-#       Owner: OriNachum  Repo: agex
+#   - For EACH PyPI project (`agex-cli`, `agent-devex`, `devex-cli`)
+#     → Publishing → Add a GitHub pending publisher
+#       Owner: agentculture  Repo: devex
 #       Workflow: publish.yml  Environment: pypi
 #
-#   - TestPyPI project `agex-cli` → same shape, Environment: testpypi
+#   - Same for EACH TestPyPI project, Environment: testpypi
 #
 #   - GitHub repo → Settings → Environments → create `pypi` and `testpypi`
 #     (any required reviewers / wait timers live there)
 #
+#   NOTE: the repo was renamed agentculture/agex-cli → agentculture/devex.
+#   The pre-existing `agex-cli` / `agent-devex` publishers must have their
+#   Repo updated to `devex` too, or those legs start failing OIDC.
+#
 # The PR job rewrites `version = "X.Y.Z"` to `"X.Y.Z.devN"` where N is
 # the workflow run number. PEP 440's dev segment is a single integer
 # (internal dots aren't allowed), so run_attempt is NOT encoded in the
@@ -67,10 +72,11 @@ jobs:
   # pull_request -- the PR path has its own build inside `publish-pr-testpypi`
   # because it needs to rewrite the version before building.
   #
-  # The matrix exists so we can publish the same code under two PyPI
-  # distribution names: `agex-cli` (canonical) and `agent-devex` (alias).
-  # Each leg rewrites `[project].name` in pyproject.toml before building so
-  # each wheel is uploaded under its own Trusted Publishing project.
+  # The matrix exists so we can publish the same code under three PyPI
+  # distribution names: `agex-cli` (canonical) plus the `agent-devex` and
+  # `devex-cli` aliases. Each leg rewrites `[project].name` in pyproject.toml
+  # before building so each wheel is uploaded under its own Trusted Publishing
+  # project.
   # --------------------------------------------------------------------------
   build:
     if: github.event_name == 'push'
@@ -78,7 +84,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        dist_name: [agex-cli, agent-devex]
+        dist_name: [agex-cli, agent-devex, devex-cli]
     permissions:
       contents: read   # actions/checkout
     steps:
@@ -93,8 +99,8 @@ jobs:
 
       # Rewrite `[project].name` to the matrix dist name. For `agex-cli`
       # (the canonical dist) the regex still has to match so we re-emit
-      # the line; for `agent-devex` it produces an alias dist with
-      # identical contents. The post-rewrite re-parse is a fail-closed
+      # the line; for `agent-devex` / `devex-cli` it produces an alias dist
+      # with identical contents. The post-rewrite re-parse is a fail-closed
       # check: if a future formatting change breaks the regex match (or
       # `[project].name` ends up wrong for any reason), the job aborts
       # before uploading mis-named artifacts.
@@ -150,7 +156,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        dist_name: [agex-cli, agent-devex]
+        dist_name: [agex-cli, agent-devex, devex-cli]
     environment: testpypi
     permissions:
       id-token: write        # OIDC -- Trusted Publishing
@@ -273,7 +279,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        dist_name: [agex-cli, agent-devex]
+        dist_name: [agex-cli, agent-devex, devex-cli]
     environment: testpypi
     permissions:
       id-token: write   # OIDC; no API token needed
@@ -372,7 +378,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        dist_name: [agex-cli, agent-devex]
+        dist_name: [agex-cli, agent-devex, devex-cli]
     environment: pypi
     permissions:
       id-token: write   # OIDC; no API token needed

{agex_cli-0.22.0 → agex_cli-0.23.0}/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.23.0] - 2026-05-28
+
+### Added
+
+- `devex` console command — second entry point alongside `agex`; both invoke the same CLI and emitted output (Next-step footers, briefing/template headers, error prefixes) reflects whichever name was typed, via the new single-source-of-truth `core.prog.prog_name()` injected into the render context.
+- Third PyPI distribution name `devex-cli` — the same wheel now publishes under `agex-cli` (canonical), `agent-devex`, and `devex-cli`; version resolution and the publish matrices cover all three.
+
+### Changed
+
+- Repo renamed `agentculture/agex-cli` → `agentculture/devex`; updated in-code issue/repo URLs, README, CLAUDE.md, and the publish workflow OIDC setup notes.
+- SonarCloud project key → `agentculture_devex` (display name `devex`; organization unchanged).
+
+### Fixed
+
+- "Output follows invocation" now also covers **plain-string** stdout/stderr in command scripts (`explain`/`learn`/`hook`/`doctor`/`gamify`/`pr delta`/`pr reply` error prefixes, status lines, and command examples), not just Jinja-rendered templates — added `core.prog.error_prefix()` and routed those paths through `prog_name()` (agex-cli#61 Qodo review).
+- `prog_name()` now strips entry-point wrapper suffixes (`.exe`, `.py`, `-script`) before matching, so a real `devex` invocation via the Windows console script `devex.exe` no longer falls back to `agex` (agex-cli#61 Qodo review).
+
 ## [0.22.0] - 2026-05-25
 
 ### Added

{agex_cli-0.22.0 → agex_cli-0.23.0}/CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project
 
-`agex` — non-agentic Python CLI that emits deterministic per-backend markdown briefings for autonomous agents. PyPI distribution name: `agex-cli`. CLI entry point: `agex`. GitHub repo: `agentculture/agex-cli`. Python module (unchanged): `agent_experience`.
+`agex` — non-agentic Python CLI that emits deterministic per-backend markdown briefings for autonomous agents. Published on PyPI under three distribution names: `agex-cli` (canonical), `agent-devex`, and `devex-cli` — the same wheel each time. CLI entry points: `agex` and `devex` (both invoke the same tool; emitted output reflects whichever name was typed). GitHub repo: `agentculture/devex`. Python module (unchanged): `agent_experience`.
 
 **Source-of-truth documents:**
 

{agex_cli-0.22.0 → agex_cli-0.23.0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: agex-cli
-Version: 0.22.0
+Version: 0.23.0
 Summary: Agent-operated developer-experience CLI — deterministic per-backend markdown briefings for autonomous agents.
 Project-URL: Homepage, https://culture.dev/agex/
-Project-URL: Repository, https://github.com/agentculture/agex-cli
-Project-URL: Issues, https://github.com/agentculture/agex-cli/issues
+Project-URL: Repository, https://github.com/agentculture/devex
+Project-URL: Issues, https://github.com/agentculture/devex/issues
 Author: Ori Nachum
 License: MIT
 License-File: LICENSE
@@ -26,14 +26,14 @@ Description-Content-Type: text/markdown
 
 # agex
 
-Agent-operated developer-experience CLI. Non-agentic, deterministic, markdown-first. Distributed on PyPI as `agex-cli`; installs the `agex` command.
+Agent-operated developer-experience CLI. Non-agentic, deterministic, markdown-first. The same wheel is published on PyPI under three distribution names — `agex-cli` (canonical), `agent-devex`, and `devex-cli` — and installs two equivalent commands, `agex` and `devex` (emitted output reflects whichever name you invoke).
 
 ## Install
 
 ```bash
-uv tool install agex-cli
+uv tool install agex-cli      # or: devex-cli
 # or
-pipx install agex-cli
+pipx install agex-cli         # or: pipx install devex-cli
 ```
 
 ## Quick start

agex_cli-0.23.0/README.md

@@ -0,0 +1,29 @@
+# agex
+
+Agent-operated developer-experience CLI. Non-agentic, deterministic, markdown-first. The same wheel is published on PyPI under three distribution names — `agex-cli` (canonical), `agent-devex`, and `devex-cli` — and installs two equivalent commands, `agex` and `devex` (emitted output reflects whichever name you invoke).
+
+## Install
+
+```bash
+uv tool install agex-cli      # or: devex-cli
+# or
+pipx install agex-cli         # or: pipx install devex-cli
+```
+
+## Quick start
+
+```bash
+agex explain agex
+agex overview --agent claude-code
+agex learn --agent claude-code
+```
+
+## Docs
+
+[culture.dev/agex](https://culture.dev/agex/).
+
+Spec: `docs/superpowers/specs/2026-04-18-agex-design.md`.
+
+## License
+
+MIT.

{agex_cli-0.22.0 → agex_cli-0.23.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agex-cli"
-version = "0.22.0"
+version = "0.23.0"
 description = "Agent-operated developer-experience CLI — deterministic per-backend markdown briefings for autonomous agents."
 authors = [{name = "Ori Nachum"}]
 license = {text = "MIT"}
@@ -27,11 +27,12 @@ dev = [
 
 [project.scripts]
 agex = "agent_experience.cli:_main_entrypoint"
+devex = "agent_experience.cli:_main_entrypoint"
 
 [project.urls]
 Homepage = "https://culture.dev/agex/"
-Repository = "https://github.com/agentculture/agex-cli"
-Issues = "https://github.com/agentculture/agex-cli/issues"
+Repository = "https://github.com/agentculture/devex"
+Issues = "https://github.com/agentculture/devex/issues"
 
 [build-system]
 requires = ["hatchling"]

{agex_cli-0.22.0 → agex_cli-0.23.0}/sonar-project.properties

@@ -1,8 +1,8 @@
-sonar.projectKey=OriNachum_agex
+sonar.projectKey=agentculture_devex
 sonar.organization=orinachum
 
 # Displayed in SonarCloud UI
-sonar.projectName=agex
+sonar.projectName=devex
 
 # Source layout
 sonar.sources=src

{agex_cli-0.22.0 → agex_cli-0.23.0}/src/agent_experience/__init__.py

@@ -2,13 +2,14 @@ from importlib.metadata import PackageNotFoundError, version
 
 
 def _resolve_version() -> str:
-    # `agex-cli` is the canonical PyPI distribution name; `agent-devex` is an
-    # alias distribution that ships the identical wheel under a different name.
-    # 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"):
+    # `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:

{agex_cli-0.22.0 → agex_cli-0.23.0}/src/agent_experience/cli.py

@@ -28,11 +28,16 @@ from agent_experience.commands.pr.scripts import open_ as pr_open_script
 from agent_experience.commands.pr.scripts import read as pr_read_script
 from agent_experience.commands.pr.scripts import reply as pr_reply_script
 from agent_experience.core.backend import parse_backend
+from agent_experience.core.prog import prog_name
 
-_GH_RERUN_HINT = "agex: rerun once network is reachable (gh failed)"
 _AGENT_HELP = "Backend: claude-code, codex, copilot, or acp."
 
 
+def _gh_rerun_hint() -> str:
+    """``<prog>: rerun once network is reachable`` — phrased with the invoked name."""
+    return f"{prog_name()}: rerun once network is reachable (gh failed)"
+
+
 class _AgexArgumentParser(argparse.ArgumentParser):
     """ArgumentParser used everywhere via ``parser_class=``.
 
@@ -71,7 +76,7 @@ def _parse_backend_or_report(agent: Optional[str]):
     try:
         return parse_backend(agent), None
     except ValueError as exc:
-        print(f"agex: error: {exc}", file=sys.stderr)
+        print(f"{prog_name()}: error: {exc}", file=sys.stderr)
         return None, 2
 
 
@@ -156,7 +161,7 @@ def _cmd_pr_lint(args: argparse.Namespace) -> int:
             agent=args.agent, project_dir=Path.cwd(), exit_on_violation=args.exit_on_violation
         )
     except ValueError as exc:
-        print(f"agex: {exc}", file=sys.stderr)
+        print(f"{prog_name()}: {exc}", file=sys.stderr)
         return 2
     _emit(stdout, stderr)
     return exit_code
@@ -173,11 +178,12 @@ def _cmd_pr_open(args: argparse.Namespace) -> int:
             delayed_read=args.delayed_read,
         )
     except ValueError as exc:
-        print(f"agex: {exc}", file=sys.stderr)
+        print(f"{prog_name()}: {exc}", file=sys.stderr)
         return 2
     except RuntimeError as exc:
+        prog = prog_name()
         print(str(exc), file=sys.stderr)
-        print("agex: rerun 'agex pr open ...' once network is reachable", file=sys.stderr)
+        print(f"{prog}: rerun '{prog} pr open ...' once network is reachable", file=sys.stderr)
         return 1
     _emit(stdout, stderr)
     return exit_code
@@ -189,11 +195,11 @@ def _cmd_pr_reply(args: argparse.Namespace) -> int:
             agent=args.agent, project_dir=Path.cwd(), pr=args.pr
         )
     except ValueError as exc:
-        print(f"agex: {exc}", file=sys.stderr)
+        print(f"{prog_name()}: {exc}", file=sys.stderr)
         return 2
     except RuntimeError as exc:
         print(str(exc), file=sys.stderr)
-        print(_GH_RERUN_HINT, file=sys.stderr)
+        print(_gh_rerun_hint(), file=sys.stderr)
         return 1
     _emit(stdout, stderr, stderr_newline=False)
     return exit_code
@@ -205,11 +211,11 @@ def _cmd_pr_read(args: argparse.Namespace) -> int:
             agent=args.agent, project_dir=Path.cwd(), pr=args.pr, wait=args.wait
         )
     except ValueError as exc:
-        print(f"agex: {exc}", file=sys.stderr)
+        print(f"{prog_name()}: {exc}", file=sys.stderr)
         return 2
     except RuntimeError as exc:
         print(str(exc), file=sys.stderr)
-        print(_GH_RERUN_HINT, file=sys.stderr)
+        print(_gh_rerun_hint(), file=sys.stderr)
         return 1
     _emit(stdout, stderr)
     return exit_code
@@ -221,11 +227,11 @@ def _cmd_pr_await(args: argparse.Namespace) -> int:
             agent=args.agent, project_dir=Path.cwd(), pr=args.pr, max_wait=args.max_wait
         )
     except ValueError as exc:
-        print(f"agex: {exc}", file=sys.stderr)
+        print(f"{prog_name()}: {exc}", file=sys.stderr)
         return 2
     except RuntimeError as exc:
         print(str(exc), file=sys.stderr)
-        print(_GH_RERUN_HINT, file=sys.stderr)
+        print(_gh_rerun_hint(), file=sys.stderr)
         return 1
     _emit(stdout, stderr)
     return exit_code
@@ -235,11 +241,11 @@ def _cmd_pr_delta(args: argparse.Namespace) -> int:
     try:
         stdout, exit_code, stderr = pr_delta_script.run(agent=args.agent, project_dir=Path.cwd())
     except ValueError as exc:
-        print(f"agex: {exc}", file=sys.stderr)
+        print(f"{prog_name()}: {exc}", file=sys.stderr)
         return 2
     except RuntimeError as exc:
         print(str(exc), file=sys.stderr)
-        print(_GH_RERUN_HINT, file=sys.stderr)
+        print(_gh_rerun_hint(), file=sys.stderr)
         return 1
     _emit(stdout, stderr, stderr_newline=False)
     return exit_code
@@ -270,7 +276,7 @@ def _group_help(parser: argparse.ArgumentParser):
 
 def _build_parser() -> argparse.ArgumentParser:
     parser = _AgexArgumentParser(
-        prog="agex",
+        prog=prog_name(),
         description="Agent-operated developer-experience CLI.",
     )
     parser.add_argument("--version", action="version", version=__version__)
@@ -441,7 +447,9 @@ def _main_entrypoint() -> None:
     """
     argv = sys.argv[1:]
     if argv and not argv[0].startswith("-") and argv[0] not in _KNOWN_COMMANDS:
-        print(f"agex: error: unknown command '{argv[0]}'", file=sys.stderr)
+        print(f"{prog_name()}: error: unknown command '{argv[0]}'", file=sys.stderr)
+        # `agex` here is the explain-topic identifier (topics/agex.md), not the
+        # invoked command name — the canonical "what is this tool" page.
         stdout, _, _ = explain_script.run("agex")
         sys.stdout.write(stdout)
         sys.exit(2)

{agex_cli-0.22.0 → agex_cli-0.23.0}/src/agent_experience/commands/doctor/assets/report.md.j2

@@ -1,7 +1,7 @@
 {% set icon = {"ok": "✓", "warn": "⚠️", "fail": "✗", "info": "·"} -%}
-# agex doctor
+# {{ prog }} doctor
 
-**agex:** `{{ version }}`
+**{{ prog }}:** `{{ version }}`
 **Project:** `{{ project_dir }}`
 
 {% for cat in categories %}

{agex_cli-0.22.0 → agex_cli-0.23.0}/src/agent_experience/commands/doctor/scripts/doctor.py

@@ -24,6 +24,7 @@ from agent_experience.core.paths import (
     config_path,
     data_dir,
 )
+from agent_experience.core.prog import error_prefix
 from agent_experience.core.render import render_string
 from agent_experience.core.skill_loader import load_skill
 
@@ -74,8 +75,8 @@ def _check_version() -> CheckResult:
             _NAME_AGEX_VERSION,
             "fail",
             "Could not resolve `agent_experience.__version__`. Reinstall with "
-            "`uv pip install -e .[dev]`, `pipx install agex-cli`, or "
-            "`pipx install agent-devex`.",
+            "`uv pip install -e .[dev]`, `pipx install agex-cli`, "
+            "`pipx install agent-devex`, or `pipx install devex-cli`.",
         )
     return CheckResult(_NAME_AGEX_VERSION, "ok", __version__)
 
@@ -341,24 +342,24 @@ def run(role: str | None = None) -> tuple[str, int, str]:
     Read-only.  Never initializes ``.agex/``.
     """
     if role is not None and _ROLE_RE.match(role) is None:
-        return ("", 2, f"agex: error: invalid role slug '{role}'")
+        return ("", 2, error_prefix(f"invalid role slug '{role}'"))
 
     role_section: str | None = None
     if role is not None:
         trav = _resolve_role(role)
         if trav is None:
-            return ("", 2, f"agex: error: unknown role '{role}'")
+            return ("", 2, error_prefix(f"unknown role '{role}'"))
         try:
             role_text = trav.read_text(encoding="utf-8")
         except (OSError, UnicodeDecodeError) as exc:
-            return ("", 1, f"agex: error: could not read role asset for '{role}': {exc}")
+            return ("", 1, error_prefix(f"could not read role asset for '{role}': {exc}"))
         # Role assets are Jinja templates per the addendum spec; v0.1 passes
         # an empty context but rendering still resolves any `{% raw %}` /
         # `{{ }}` markup the role file may use, rather than dumping it raw.
         try:
             role_section = render_string(role_text, {})
         except Exception as exc:
-            return ("", 1, f"agex: error: failed to render role '{role}': {exc}")
+            return ("", 1, error_prefix(f"failed to render role '{role}': {exc}"))
 
     categories = _build_categories()
     summary = _summarize(categories)
@@ -369,8 +370,10 @@ def run(role: str | None = None) -> tuple[str, int, str]:
         return (
             "",
             1,
-            f"agex: error: could not read `doctor/assets/report.md.j2`: {exc}. "
-            "Reinstall the package.",
+            error_prefix(
+                f"could not read `doctor/assets/report.md.j2`: {exc}. "
+                "Reinstall the package."
+            ),
         )
     out = render_string(
         template_text,
@@ -386,6 +389,6 @@ def run(role: str | None = None) -> tuple[str, int, str]:
     )
 
     if summary["fail"] > 0:
-        stderr = f"agex: error: {summary['fail']} health check(s) failed"
+        stderr = error_prefix(f"{summary['fail']} health check(s) failed")
         return (out, 1, stderr)
     return (out, 0, "")

{agex_cli-0.22.0 → agex_cli-0.23.0}/src/agent_experience/commands/explain/assets/topics/agex.md

@@ -34,4 +34,4 @@ agex overview --agent claude-code  # what's in this project?
 
 ## Repo
 
-<https://github.com/agentculture/agex-cli>
+<https://github.com/agentculture/devex>

{agex_cli-0.22.0 → agex_cli-0.23.0}/src/agent_experience/commands/explain/scripts/explain.py

@@ -2,6 +2,7 @@ import re
 from importlib.resources import files
 from importlib.resources.abc import Traversable
 
+from agent_experience.core.prog import error_prefix
 from agent_experience.core.skill_loader import Skill, load_skill
 
 _TOPIC_RE = re.compile(r"^[a-z][a-z0-9-]*$")
@@ -54,7 +55,7 @@ def run(topic: str) -> tuple[str, int, str]:
     if resolved is None:
         agex_page = _commands_root().joinpath("explain", "assets", "topics", "agex.md")
         body = agex_page.read_text(encoding="utf-8") if agex_page.is_file() else ""
-        return (body, 2, f"agex: error: unknown topic '{topic}'")
+        return (body, 2, error_prefix(f"unknown topic '{topic}'"))
 
     kind, trav = resolved
     if kind == "concept":

{agex_cli-0.22.0 → agex_cli-0.23.0}/src/agent_experience/commands/gamify/scripts/install.py

@@ -8,6 +8,7 @@ from agent_experience.core.backend import Backend
 from agent_experience.core.config import load as load_config
 from agent_experience.core.config import save as save_config
 from agent_experience.core.paths import ensure_init
+from agent_experience.core.prog import error_prefix, prog_name
 
 
 def _fragments_file() -> Traversable:
@@ -110,7 +111,7 @@ def install(backend: Backend) -> tuple[str, int, str]:
     try:
         hooks = _load_hooks_file(hooks_file)
     except ValueError as e:
-        return ("", 2, f"agex: error: {e}")
+        return ("", 2, error_prefix(str(e)))
 
     written_ids, added_count = _merge_fragments(hooks, fragments)
     if added_count:
@@ -142,7 +143,8 @@ def install(backend: Backend) -> tuple[str, int, str]:
         status_line,
         "- Fragment IDs: " + ", ".join(f"`{i}`" for i in written_ids),
         "",
-        f"Next: run `agex learn gamify --agent {backend.value}` to set up the levelup skill.",
+        f"Next: run `{prog_name()} learn gamify --agent {backend.value}`"
+        " to set up the levelup skill.",
         "",
     ]
     return ("\n".join(lines), 0, "")
@@ -176,7 +178,7 @@ def uninstall(backend: Backend) -> tuple[str, int, str]:
     try:
         hooks = _load_hooks_file(hooks_file)
     except ValueError as e:
-        return ("", 2, f"agex: error: {e}")
+        return ("", 2, error_prefix(str(e)))
 
     removed_count = _remove_ids_from_hooks(hooks, ids_to_remove)
     if removed_count:
@@ -196,6 +198,6 @@ def _unsupported_notice(backend: Backend) -> str:
     return (
         f"## `gamify` is not supported on {backend.value}\n\n"
         f"Hooks are required to track usage events, and {backend.value} does not expose "
-        f"a hook interface agex can write to.\n\n"
-        "Want this supported? Open an issue: <https://github.com/agentculture/agex-cli/issues>\n"
+        f"a hook interface {prog_name()} can write to.\n\n"
+        "Want this supported? Open an issue: <https://github.com/agentculture/devex/issues>\n"
     )

{agex_cli-0.22.0 → agex_cli-0.23.0}/src/agent_experience/commands/hook/scripts/write.py

@@ -2,6 +2,7 @@ from datetime import datetime, timezone
 
 from agent_experience.core.hook_io import append_event
 from agent_experience.core.paths import ensure_init
+from agent_experience.core.prog import error_prefix
 
 
 def run(event: str, args: list[str]) -> tuple[str, int, str]:
@@ -20,5 +21,5 @@ def run(event: str, args: list[str]) -> tuple[str, int, str]:
     except ValueError as e:
         # append_event → _stream_path rejects names that don't match the
         # `^[a-z][a-z0-9-]*$` slug whitelist (path-traversal guard).
-        return ("", 2, f"agex: error: {e}")
+        return ("", 2, error_prefix(str(e)))
     return ("", 0, "")

{agex_cli-0.22.0 → agex_cli-0.23.0}/src/agent_experience/commands/learn/assets/menu.md.j2

@@ -1,6 +1,6 @@
 # Lessons — {{ backend }}
 
-Run `agex learn <topic> --agent {{ backend }}` to learn one.
+Run `{{ prog }} learn <topic> --agent {{ backend }}` to learn one.
 
 {% for topic in topics -%}
 - **`{{ topic.name }}`** — {{ topic.description }}{% if topic.unsupported %} _(unsupported on {{ backend }}: {{ topic.unsupported }})_{% endif %}

{agex_cli-0.22.0 → agex_cli-0.23.0}/src/agent_experience/commands/learn/scripts/learn.py

@@ -3,6 +3,7 @@ from importlib.resources import as_file, files
 from importlib.resources.abc import Traversable
 
 from agent_experience.core.backend import Backend
+from agent_experience.core.prog import error_prefix
 from agent_experience.core.render import render_string
 from agent_experience.core.skill_loader import Skill, load_skill
 
@@ -54,13 +55,13 @@ def run_topic(topic: str, backend: Backend) -> tuple[str, int, str]:
     """Return (stdout, exit_code, stderr) for a specific lesson topic."""
     if not _TOPIC_RE.match(topic):
         menu_out, _, _ = run_menu(backend)
-        return (menu_out, 2, f"agex: error: unknown topic '{topic}'")
+        return (menu_out, 2, error_prefix(f"unknown topic '{topic}'"))
 
     topic_dir = _learn_assets().joinpath("topics", topic)
     skill_md = topic_dir.joinpath(_SKILL_FILENAME)
     if not skill_md.is_file():
         menu_out, _, _ = run_menu(backend)
-        return (menu_out, 2, f"agex: error: unknown topic '{topic}'")
+        return (menu_out, 2, error_prefix(f"unknown topic '{topic}'"))
 
     skill = _load_skill_from_traversable(skill_md)
     template_path = topic_dir.joinpath("assets", "skill-template", backend.value, _SKILL_FILENAME)

agex_cli-0.23.0/src/agent_experience/commands/pr/assets/backends/acp.yaml

@@ -0,0 +1,20 @@
+hints:
+  lint_clean: "Commit, push, then `{{ prog }} pr open --title \"...\"`."
+  lint_clean_with_alignment: "Run `{{ prog }} pr delta` (this PR touches alignment files), then commit, push, and `{{ prog }} pr open --title \"...\"`."
+  lint_violations: "Fix the {{ violation_count }} violation(s) above and rerun `{{ prog }} pr lint`."
+  open_recommend_read: "`{{ prog }} pr read {{ pr }} --wait 180` (recommended) or `{{ prog }} pr read {{ pr }}` in ~3 min."
+  open_already_exists: "PR already open as #{{ pr }} — `{{ prog }} pr read {{ pr }} --wait 180` to fetch the briefing."
+  read_unresolved_after_commits: "Push fixes, then `{{ prog }} pr read {{ pr }} --wait 180`."
+  read_unresolved_no_commits: "Triage and prepare `replies.jsonl`, then `{{ prog }} pr reply {{ pr }} < replies.jsonl`."
+  read_ci_red: "Fix CI before requesting re-review (see failing checks above)."
+  read_clean: "Wait for human merge."
+  read_wait_timeout: "Still waiting on: {{ reviewers }}. Rerun `{{ prog }} pr read {{ pr }} --wait 180` to continue."
+  reply_with_failures: "Resubmit the failed lines (see table above) to `{{ prog }} pr reply {{ pr }}`."
+  reply_clean: "Push fixes (if any), then `{{ prog }} pr read {{ pr }} --wait 180`."
+  delta_done: "Triage each sibling — open follow-up PRs where alignment drifted; mention them in your reply."
+  await_clean: "PR #{{ pr }} is ready — wait for human merge."
+  await_gate_error: "SonarCloud quality gate is ERROR — fix the new issues above, push, then `{{ prog }} pr await {{ pr }}` again."
+  await_gate_unknown: "SonarCloud quality gate is UNKNOWN — analysis is pending or the project isn't analyzed yet; wait and re-run `{{ prog }} pr await {{ pr }}`."
+  await_unresolved_threads: "Triage and prepare `replies.jsonl`, then `{{ prog }} pr reply {{ pr }} < replies.jsonl`."
+  await_ci_red: "Fix CI before requesting re-review (see failing checks above)."
+  await_wait_timeout: "Still waiting on: {{ reviewers }}. Rerun `{{ prog }} pr await {{ pr }}` to keep waiting."

agex_cli-0.23.0/src/agent_experience/commands/pr/assets/backends/claude-code.yaml

@@ -0,0 +1,20 @@
+hints:
+  lint_clean: "Commit, push, then `{{ prog }} pr open --title \"...\"`."
+  lint_clean_with_alignment: "Run `{{ prog }} pr delta` (this PR touches alignment files), then commit, push, and `{{ prog }} pr open --title \"...\"`."
+  lint_violations: "Fix the {{ violation_count }} violation(s) above and rerun `{{ prog }} pr lint`."
+  open_recommend_read: "`{{ prog }} pr read {{ pr }} --wait 180` (recommended) or `{{ prog }} pr read {{ pr }}` in ~3 min."
+  open_already_exists: "PR already open as #{{ pr }} — `{{ prog }} pr read {{ pr }} --wait 180` to fetch the briefing."
+  read_unresolved_after_commits: "Push fixes, then `{{ prog }} pr read {{ pr }} --wait 180`."
+  read_unresolved_no_commits: "Triage and prepare `replies.jsonl`, then `{{ prog }} pr reply {{ pr }} < replies.jsonl`."
+  read_ci_red: "Fix CI before requesting re-review (see failing checks above)."
+  read_clean: "Wait for human merge."
+  read_wait_timeout: "Still waiting on: {{ reviewers }}. Rerun `{{ prog }} pr read {{ pr }} --wait 180` to continue."
+  reply_with_failures: "Resubmit the failed lines (see table above) to `{{ prog }} pr reply {{ pr }}`."
+  reply_clean: "Push fixes (if any), then `{{ prog }} pr read {{ pr }} --wait 180`."
+  delta_done: "Triage each sibling — open follow-up PRs where alignment drifted; mention them in your reply."
+  await_clean: "PR #{{ pr }} is ready — wait for human merge."
+  await_gate_error: "SonarCloud quality gate is ERROR — fix the new issues above, push, then `{{ prog }} pr await {{ pr }}` again."
+  await_gate_unknown: "SonarCloud quality gate is UNKNOWN — analysis is pending or the project isn't analyzed yet; wait and re-run `{{ prog }} pr await {{ pr }}`."
+  await_unresolved_threads: "Triage and prepare `replies.jsonl`, then `{{ prog }} pr reply {{ pr }} < replies.jsonl`."
+  await_ci_red: "Fix CI before requesting re-review (see failing checks above)."
+  await_wait_timeout: "Still waiting on: {{ reviewers }}. Rerun `{{ prog }} pr await {{ pr }}` to keep waiting."

agex_cli-0.23.0/src/agent_experience/commands/pr/assets/backends/codex.yaml

@@ -0,0 +1,20 @@
+hints:
+  lint_clean: "Commit, push, then `{{ prog }} pr open --title \"...\"`."
+  lint_clean_with_alignment: "Run `{{ prog }} pr delta` (this PR touches alignment files), then commit, push, and `{{ prog }} pr open --title \"...\"`."
+  lint_violations: "Fix the {{ violation_count }} violation(s) above and rerun `{{ prog }} pr lint`."
+  open_recommend_read: "`{{ prog }} pr read {{ pr }} --wait 180` (recommended) or `{{ prog }} pr read {{ pr }}` in ~3 min."
+  open_already_exists: "PR already open as #{{ pr }} — `{{ prog }} pr read {{ pr }} --wait 180` to fetch the briefing."
+  read_unresolved_after_commits: "Push fixes, then `{{ prog }} pr read {{ pr }} --wait 180`."
+  read_unresolved_no_commits: "Triage and prepare `replies.jsonl`, then `{{ prog }} pr reply {{ pr }} < replies.jsonl`."
+  read_ci_red: "Fix CI before requesting re-review (see failing checks above)."
+  read_clean: "Wait for human merge."
+  read_wait_timeout: "Still waiting on: {{ reviewers }}. Rerun `{{ prog }} pr read {{ pr }} --wait 180` to continue."
+  reply_with_failures: "Resubmit the failed lines (see table above) to `{{ prog }} pr reply {{ pr }}`."
+  reply_clean: "Push fixes (if any), then `{{ prog }} pr read {{ pr }} --wait 180`."
+  delta_done: "Triage each sibling — open follow-up PRs where alignment drifted; mention them in your reply."
+  await_clean: "PR #{{ pr }} is ready — wait for human merge."
+  await_gate_error: "SonarCloud quality gate is ERROR — fix the new issues above, push, then `{{ prog }} pr await {{ pr }}` again."
+  await_gate_unknown: "SonarCloud quality gate is UNKNOWN — analysis is pending or the project isn't analyzed yet; wait and re-run `{{ prog }} pr await {{ pr }}`."
+  await_unresolved_threads: "Triage and prepare `replies.jsonl`, then `{{ prog }} pr reply {{ pr }} < replies.jsonl`."
+  await_ci_red: "Fix CI before requesting re-review (see failing checks above)."
+  await_wait_timeout: "Still waiting on: {{ reviewers }}. Rerun `{{ prog }} pr await {{ pr }}` to keep waiting."