ralph-any 0.1.1__py3-none-any.whl → 0.2.0__py3-none-any.whl

ralph/__init__.py

@@ -1,12 +1,14 @@
 """Ralph Any — iterative AI dev loop via ACP."""
 
-__version__ = "0.1.1"
+__version__ = "0.2.0"
 
+from ralph.config import load_config_file
 from ralph.detect import detect_promise
 from ralph.engine import LoopConfig, LoopResult, RalphEngine
 
 __all__ = [
     "__version__",
+    "load_config_file",
     "detect_promise",
     "LoopConfig",
     "LoopResult",

ralph/cli.py

@@ -7,7 +7,9 @@ import asyncio
 import shlex
 import sys
 from pathlib import Path
+from typing import Any
 
+from ralph.config import load_config_file
 from ralph.engine import LoopConfig, RalphEngine
 
 EXIT_SUCCESS = 0
@@ -24,6 +26,9 @@ _STATE_TO_EXIT = {
     "max_iterations": EXIT_MAX_ITERATIONS,
 }
 
+# Auto-detected prompt files, checked in order.
+_AUTO_PROMPT_FILES = ("ralph.md", "TASK.md", "ralph.txt", "TASK.txt")
+
 
 def _build_parser() -> argparse.ArgumentParser:
     p = argparse.ArgumentParser(
@@ -32,38 +37,40 @@ def _build_parser() -> argparse.ArgumentParser:
     )
     p.add_argument(
         "prompt",
-        help="Task description, or path to a .md/.txt file",
+        nargs="?",
+        default=None,
+        help="Task description, or path to a .md/.txt file (auto-detects ralph.md / TASK.md)",
     )
     p.add_argument(
         "-m", "--max-iterations",
         type=int,
-        default=10,
+        default=None,
         help="Maximum loop iterations (default: 10)",
     )
     p.add_argument(
         "-t", "--timeout",
         type=int,
-        default=1800,
+        default=None,
         help="Maximum runtime in seconds (default: 1800 = 30m)",
     )
     p.add_argument(
         "--promise",
-        default="任務完成！🥇",
+        default=None,
         help="Completion promise phrase (default: 任務完成！🥇)",
     )
     p.add_argument(
         "-c", "--command",
-        default="claude-code-acp",
+        default=None,
         help="ACP CLI command (default: claude-code-acp)",
     )
     p.add_argument(
         "--command-args",
-        default="",
+        default=None,
         help="Extra arguments for the ACP CLI (e.g. '--experimental-acp')",
     )
     p.add_argument(
         "-d", "--working-dir",
-        default=".",
+        default=None,
         help="Working directory (default: .)",
     )
     p.add_argument(
@@ -82,6 +89,17 @@ def _resolve_prompt(raw: str) -> str:
     return raw
 
 
+def _auto_detect_prompt(working_dir: str) -> str | None:
+    """Look for a default prompt file in the working directory."""
+    base = Path(working_dir)
+    for name in _AUTO_PROMPT_FILES:
+        p = base / name
+        if p.is_file():
+            print(f"📄 Auto-detected prompt file: {p}", flush=True)
+            return p.read_text(encoding="utf-8")
+    return None
+
+
 def _run(config: LoopConfig) -> int:
     engine = RalphEngine(config)
     try:
@@ -100,18 +118,49 @@ def main(argv: list[str] | None = None) -> None:
     parser = _build_parser()
     args = parser.parse_args(argv)
 
-    prompt_text = _resolve_prompt(args.prompt)
-
-    config = LoopConfig(
-        prompt=prompt_text,
-        promise_phrase=args.promise,
-        command=args.command,
-        command_args=shlex.split(args.command_args) if args.command_args else [],
-        working_dir=args.working_dir,
-        max_iterations=args.max_iterations,
-        timeout_seconds=args.timeout,
-        dry_run=args.dry_run,
-    )
+    # Layer 1: defaults
+    cfg: dict[str, Any] = {
+        "prompt": None,
+        "promise_phrase": "任務完成！🥇",
+        "command": "claude-code-acp",
+        "command_args": [],
+        "working_dir": ".",
+        "max_iterations": 10,
+        "timeout_seconds": 1800,
+        "dry_run": False,
+    }
+
+    # Layer 2: ralph.yml (overrides defaults)
+    file_cfg = load_config_file(args.working_dir or ".")
+    if file_cfg:
+        cfg.update({k: v for k, v in file_cfg.items() if v is not None})
+
+    # Layer 3: CLI args (overrides config file)
+    if args.prompt is not None:
+        cfg["prompt"] = _resolve_prompt(args.prompt)
+    if args.max_iterations is not None:
+        cfg["max_iterations"] = args.max_iterations
+    if args.timeout is not None:
+        cfg["timeout_seconds"] = args.timeout
+    if args.promise is not None:
+        cfg["promise_phrase"] = args.promise
+    if args.command is not None:
+        cfg["command"] = args.command
+    if args.command_args is not None:
+        cfg["command_args"] = shlex.split(args.command_args)
+    if args.working_dir is not None:
+        cfg["working_dir"] = args.working_dir
+    if args.dry_run:
+        cfg["dry_run"] = True
+
+    # Auto-detect prompt file if no prompt given
+    if cfg["prompt"] is None:
+        cfg["prompt"] = _auto_detect_prompt(cfg["working_dir"])
+
+    if cfg["prompt"] is None:
+        parser.error("prompt is required (provide as argument or create ralph.md / TASK.md)")
+
+    config = LoopConfig(**cfg)
 
     if config.dry_run:
         print("Dry-run config:")

ralph/config.py

@@ -0,0 +1,55 @@
+"""Load ralph.yml config file."""
+
+from __future__ import annotations
+
+import shlex
+from pathlib import Path
+from typing import Any
+
+
+def load_config_file(working_dir: str) -> dict[str, Any] | None:
+    """Load ralph.yml / ralph.yaml from *working_dir*. Returns None if absent."""
+    base = Path(working_dir)
+    for name in ("ralph.yml", "ralph.yaml"):
+        path = base / name
+        if path.is_file():
+            return _parse(path)
+    return None
+
+
+def _parse(path: Path) -> dict[str, Any]:
+    """Parse a ralph config file (simple YAML subset, no dependency needed)."""
+    raw: dict[str, str] = {}
+    for line in path.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if not line or line.startswith("#"):
+            continue
+        if ":" not in line:
+            continue
+        key, _, value = line.partition(":")
+        raw[key.strip()] = value.strip()
+
+    cfg: dict[str, Any] = {}
+
+    _map = {
+        "command": "command",
+        "command_args": "command_args",
+        "promise": "promise_phrase",
+        "max_iterations": "max_iterations",
+        "timeout": "timeout_seconds",
+        "working_dir": "working_dir",
+        "prompt": "prompt",
+    }
+
+    for yaml_key, cfg_key in _map.items():
+        if yaml_key not in raw:
+            continue
+        val = raw[yaml_key]
+        if cfg_key in ("max_iterations", "timeout_seconds"):
+            cfg[cfg_key] = int(val)
+        elif cfg_key == "command_args":
+            cfg[cfg_key] = shlex.split(val)
+        else:
+            cfg[cfg_key] = val
+
+    return cfg

{ralph_any-0.1.1.dist-info → ralph_any-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ralph-any
-Version: 0.1.1
+Version: 0.2.0
 Summary: Ralph Wiggum Loop — iterative AI dev loop via ACP (supports Claude, Gemini, and more)
 License-Expression: MIT
 License-File: LICENSE

ralph_any-0.2.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+ralph/__init__.py,sha256=fBtiHYjMPjo4atoDtuKfSI_efE7ai1nSPLDheW-8nFY,353
+ralph/__main__.py,sha256=FdEO4lE2dw6-b4Kk97vznatvCAEuO-6qFwOkWP6en-c,69
+ralph/cli.py,sha256=HrM3H4HUdkh_0wmqAcXSVMucI90cJ2JVR4gWt5YJvco,4877
+ralph/config.py,sha256=H7jvtUwV9lBf3lo5AZg4AkJr3zMlK_C93ZXNElFuJcg,1573
+ralph/detect.py,sha256=e99V2o9KECN2fR6sZ7qLghVpdomShCW1Jf_rHjo0og0,180
+ralph/engine.py,sha256=CZFU7GtmKnPIXuN9mx-5iSxcUCyCgUNZkilj1POuTyM,4600
+ralph/prompt.py,sha256=9B5z6zeEyX0Jr6tJ6P7_ahMUVckQySWST51DypGdIDQ,2022
+ralph_any-0.2.0.dist-info/METADATA,sha256=MYi1ivYBwXk_yyYD_7xn40B9KeXvqoo5Hs2oWopfVUA,350
+ralph_any-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+ralph_any-0.2.0.dist-info/entry_points.txt,sha256=39mDVcb7RNWfrI1JwWs7ae3TrLLzwzy6R6EurlGgTfI,41
+ralph_any-0.2.0.dist-info/licenses/LICENSE,sha256=Losvcv3YtvA9lWEq2Ngj6bbejg6sBzR5vxZKb-Db5i0,1079
+ralph_any-0.2.0.dist-info/RECORD,,

ralph_any-0.1.1.dist-info/RECORD

@@ -1,11 +0,0 @@
-ralph/__init__.py,sha256=MhQ-PrDvbQk55q3i2yxFjFMR8rkJYFTTnz9bNpMORlA,287
-ralph/__main__.py,sha256=FdEO4lE2dw6-b4Kk97vznatvCAEuO-6qFwOkWP6en-c,69
-ralph/cli.py,sha256=1uxhTV8U2sw_p9qOM26KekNI5dh3lpLl_lcBpw6BSls,3179
-ralph/detect.py,sha256=e99V2o9KECN2fR6sZ7qLghVpdomShCW1Jf_rHjo0og0,180
-ralph/engine.py,sha256=CZFU7GtmKnPIXuN9mx-5iSxcUCyCgUNZkilj1POuTyM,4600
-ralph/prompt.py,sha256=9B5z6zeEyX0Jr6tJ6P7_ahMUVckQySWST51DypGdIDQ,2022
-ralph_any-0.1.1.dist-info/METADATA,sha256=Wvs53pyw1B3BOiwHfcT6KcFgP4mmyAMWYqfeWjcr7jU,350
-ralph_any-0.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-ralph_any-0.1.1.dist-info/entry_points.txt,sha256=39mDVcb7RNWfrI1JwWs7ae3TrLLzwzy6R6EurlGgTfI,41
-ralph_any-0.1.1.dist-info/licenses/LICENSE,sha256=Losvcv3YtvA9lWEq2Ngj6bbejg6sBzR5vxZKb-Db5i0,1079
-ralph_any-0.1.1.dist-info/RECORD,,