ai-push-hooks 0.1.13 → 0.1.15

package/README.md

@@ -24,9 +24,9 @@ pnpm add -D ai-push-hooks
 
 Requirements:
 
-- Python 3.10+ (`python3` or `python`) is required, including npm installs.
-- `opencode-cli` (or `opencode`) is required for `llm` and `apply` steps.
-- `gh` is required only if you use PR creation via `gh_pr_create`.
+- [Python 3.10+](https://www.python.org/downloads/) (`python3` or `python`) is required, including npm installs.
+- [OpenCode CLI](https://github.com/sst/opencode) is required for `llm` and `apply` steps. The expected executable is `opencode`; `opencode-cli` is also accepted for compatibility.
+- [GitHub CLI (`gh`)](https://cli.github.com/manual/installation) is required only if you use PR creation via `gh_pr_create`.
 
 ## Quick start
 
@@ -53,12 +53,12 @@ Requirements:
 | Command | What it does |
 | --- | --- |
 | `ai-push-hooks hook <remote-name> <remote-url>` | Runs the configured pre-push workflow. |
-| `ai-push-hooks init --template minimal-docs` | Writes `.ai-push-hooks.toml` starter config. |
+| `ai-push-hooks init --template minimal-docs` | Writes `ai-push-hooks.toml` starter config. |
 | `ai-push-hooks init --template minimal-docs --force` | Overwrites an existing config file. |
 
 ## Configuration overview
 
-- Config file lookup order: `.ai-push-hooks.toml`, then `ai-push-hooks.toml`.
+- Config file lookup order: `ai-push-hooks.toml`, then `.ai-push-hooks.toml` (legacy).
 - If no config file is present, built-in defaults are used.
 - File values are deep-merged over defaults.
 - Prompt resolution precedence for `llm` and `apply` steps:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-push-hooks",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Modular AI push-hook workflow runner",
   "license": "MIT",
   "repository": {
@@ -20,7 +20,7 @@
     "run.sh",
     "pyproject.toml",
     "LICENSE",
-    ".ai-push-hooks.toml"
+    "ai-push-hooks.toml"
   ],
   "engines": {
     "node": ">=18"

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-push-hooks"
-version = "0.1.13"
+version = "0.1.15"
 description = "Modular AI push-hook workflow runner"
 readme = "README.md"
 requires-python = ">=3.10"

package/src/ai_push_hooks/cli.py

@@ -27,9 +27,11 @@ def init_config(template: str, force: bool, cwd: pathlib.Path | None = None) ->
     if template != "minimal-docs":
         raise HookError("Only `minimal-docs` is supported")
     target_dir = cwd or pathlib.Path.cwd()
-    config_path = target_dir / ".ai-push-hooks.toml"
-    if config_path.exists() and not force:
-        raise HookError(f"Refusing to overwrite existing config without --force: {config_path}")
+    config_path = target_dir / "ai-push-hooks.toml"
+    legacy_path = target_dir / ".ai-push-hooks.toml"
+    existing_path = config_path if config_path.exists() else legacy_path if legacy_path.exists() else None
+    if existing_path is not None and not force:
+        raise HookError(f"Refusing to overwrite existing config without --force: {existing_path}")
     config_path.write_text(MINIMAL_DOCS_TEMPLATE, encoding="utf-8")
     sys.stdout.write(str(config_path) + "\n")
     return 0

package/src/ai_push_hooks/config.py

@@ -318,7 +318,7 @@ def _apply_env_overrides(config: HookConfig) -> HookConfig:
 def load_config(repo_root: pathlib.Path) -> tuple[HookConfig, pathlib.Path | None]:
     config_path: pathlib.Path | None = None
     raw = copy.deepcopy(DEFAULT_CONFIG_RAW)
-    for candidate in [repo_root / ".ai-push-hooks.toml", repo_root / "ai-push-hooks.toml"]:
+    for candidate in [repo_root / "ai-push-hooks.toml", repo_root / ".ai-push-hooks.toml"]:
         if candidate.exists():
             config_path = candidate
             text = candidate.read_text(encoding="utf-8")

package/src/ai_push_hooks/executors/llm.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import json
-import os
 import pathlib
 import re
 import shutil
@@ -26,24 +25,14 @@ def sanitize_filename_component(value: str) -> str:
     return cleaned.strip("-") or "value"
 
 
-def prefer_opencode_cli_candidate(candidate: str) -> str:
-    path = pathlib.Path(candidate)
-    if path.name != "opencode":
-        return candidate
-    sibling = path.with_name("opencode-cli")
-    if sibling.exists() and os.access(sibling, os.X_OK):
-        return str(sibling)
-    return candidate
-
-
 def resolve_opencode_executable() -> str:
+    opencode_path = shutil.which("opencode")
+    if opencode_path:
+        return opencode_path
     cli_path = shutil.which("opencode-cli")
     if cli_path:
         return cli_path
-    opencode_path = shutil.which("opencode")
-    if opencode_path:
-        return prefer_opencode_cli_candidate(opencode_path)
-    raise HookError("opencode is required but not installed")
+    raise HookError("opencode (or opencode-cli) is required but not installed")
 
 
 def parse_opencode_json_run_output(raw: str) -> tuple[str | None, str]: