hyperloop 0.1.0__tar.gz → 0.2.0__tar.gz

{hyperloop-0.1.0 → hyperloop-0.2.0}/.github/workflows/release.yaml

@@ -93,6 +93,11 @@ jobs:
       id-token: write
 
     steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
       - name: Download dist artifacts
         uses: actions/download-artifact@v4
         with:

{hyperloop-0.1.0 → hyperloop-0.2.0}/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 <!-- version list -->
 
+## v0.2.0 (2026-04-15)
+
+
+## v0.1.1 (2026-04-15)
+
+
 ## v0.1.0 (2026-04-15)
 
 - Initial Release

{hyperloop-0.1.0 → hyperloop-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperloop
-Version: 0.1.0
+Version: 0.2.0
 Summary: Orchestrator that walks tasks through composable process pipelines using AI agents
 Requires-Python: >=3.12
 Requires-Dist: pyyaml>=6.0.3
@@ -15,14 +15,14 @@ Description-Content-Type: text/markdown
 
 # hyperloop
 
-Walks tasks through composable process pipelines using AI agents. You write specs, it creates tasks, implements them, verifies the work, and merges PRs.
+Walks tasks through composable process pipelines using AI agents. You write specs, it creates tasks, implements them, verifies the work, and merges the results.
 
 ## Prerequisites
 
 - Python 3.12+
 - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) (`claude` on PATH)
-- `gh` CLI (authenticated, for PR management)
 - `git`
+- `gh` CLI (optional, for GitHub PR operations)
 
 ## Install
 
@@ -67,23 +67,23 @@ Implement JWT-based authentication for the API.
 - JWTs expire after 24 hours
 ```
 
-3. Run:
+3. Run against the local repo:
 
 ```bash
-# From source:
-uv run hyperloop run --repo owner/repo --branch main
+# From inside the repo
+uv run hyperloop run
 
-# Or if installed:
-hyperloop run --repo owner/repo --branch main
-```
+# Or point to a repo elsewhere
+uv run hyperloop run --path ~/code/my-project
 
-4. See what it would do without executing:
+# With GitHub PR support (draft PRs, lgtm gates, squash-merge)
+uv run hyperloop run --repo owner/repo
 
-```bash
-hyperloop run --repo owner/repo --dry-run
+# Dry run (show config, don't execute)
+uv run hyperloop run --dry-run
 ```
 
-The orchestrator reads your specs, has the PM create tasks in `specs/tasks/`, then walks each task through the default pipeline: implement, verify, merge.
+When `--repo` is not set, completed work is merged locally into the base branch via `git merge`. When `--repo` is set, the orchestrator creates draft PRs, polls for `lgtm` labels on gates, and squash-merges via GitHub.
 
 ## Configuration
 
@@ -101,13 +101,14 @@ merge:
   strategy: squash
 ```
 
-Then just run from the repo directory:
+Then run from the repo directory (or use `--path`):
 
 ```bash
 hyperloop run
+hyperloop run --path ~/code/my-project
 ```
 
-The repo is inferred from your git remote. All settings have sensible defaults.
+All settings have sensible defaults. `--repo` is only needed for GitHub PR operations.
 
 ## Customizing Agent Behavior
 

{hyperloop-0.1.0 → hyperloop-0.2.0}/README.md

@@ -1,13 +1,13 @@
 # hyperloop
 
-Walks tasks through composable process pipelines using AI agents. You write specs, it creates tasks, implements them, verifies the work, and merges PRs.
+Walks tasks through composable process pipelines using AI agents. You write specs, it creates tasks, implements them, verifies the work, and merges the results.
 
 ## Prerequisites
 
 - Python 3.12+
 - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) (`claude` on PATH)
-- `gh` CLI (authenticated, for PR management)
 - `git`
+- `gh` CLI (optional, for GitHub PR operations)
 
 ## Install
 
@@ -52,23 +52,23 @@ Implement JWT-based authentication for the API.
 - JWTs expire after 24 hours
 ```
 
-3. Run:
+3. Run against the local repo:
 
 ```bash
-# From source:
-uv run hyperloop run --repo owner/repo --branch main
+# From inside the repo
+uv run hyperloop run
 
-# Or if installed:
-hyperloop run --repo owner/repo --branch main
-```
+# Or point to a repo elsewhere
+uv run hyperloop run --path ~/code/my-project
 
-4. See what it would do without executing:
+# With GitHub PR support (draft PRs, lgtm gates, squash-merge)
+uv run hyperloop run --repo owner/repo
 
-```bash
-hyperloop run --repo owner/repo --dry-run
+# Dry run (show config, don't execute)
+uv run hyperloop run --dry-run
 ```
 
-The orchestrator reads your specs, has the PM create tasks in `specs/tasks/`, then walks each task through the default pipeline: implement, verify, merge.
+When `--repo` is not set, completed work is merged locally into the base branch via `git merge`. When `--repo` is set, the orchestrator creates draft PRs, polls for `lgtm` labels on gates, and squash-merges via GitHub.
 
 ## Configuration
 
@@ -86,13 +86,14 @@ merge:
   strategy: squash
 ```
 
-Then just run from the repo directory:
+Then run from the repo directory (or use `--path`):
 
 ```bash
 hyperloop run
+hyperloop run --path ~/code/my-project
 ```
 
-The repo is inferred from your git remote. All settings have sensible defaults.
+All settings have sensible defaults. `--repo` is only needed for GitHub PR operations.
 
 ## Customizing Agent Behavior
 

{hyperloop-0.1.0 → hyperloop-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hyperloop"
-version = "0.1.0"
+version = "0.2.0"
 description = "Orchestrator that walks tasks through composable process pipelines using AI agents"
 readme = "README.md"
 requires-python = ">=3.12"

{hyperloop-0.1.0 → hyperloop-0.2.0}/src/hyperloop/cli.py

@@ -52,6 +52,10 @@ def _config_table(cfg: Config) -> Table:
 
 @app.command()
 def run(
+    path: Path = typer.Option(
+        Path.cwd(),
+        help="Path to the target repo. Default: current directory.",
+    ),
     repo: str | None = typer.Option(
         None,
         help="GitHub repo (owner/repo). Inferred from git remote if not set.",
@@ -64,7 +68,7 @@ def run(
         None,
         "--config",
         "-c",
-        help="Config file path. Default: .hyperloop.yaml",
+        help="Config file path. Default: .hyperloop.yaml in the target repo.",
     ),
     max_workers: int | None = typer.Option(
         None,
@@ -78,7 +82,8 @@ def run(
 ) -> None:
     """Run the orchestrator loop."""
     # 1. Load config (file + CLI overrides)
-    config_path = config_file or Path(".hyperloop.yaml")
+    repo_path = path.resolve()
+    config_path = config_file or (repo_path / ".hyperloop.yaml")
     try:
         cfg = load_config(
             config_path,
@@ -99,7 +104,9 @@ def run(
             style="blue",
         )
     )
-    console.print(_config_table(cfg))
+    table = _config_table(cfg)
+    table.add_row("path", str(repo_path))
+    console.print(table)
     console.print()
 
     # 3. Dry run — show config and exit
@@ -107,13 +114,15 @@ def run(
         console.print("[bold yellow]Dry run[/bold yellow] -- exiting without executing.")
         return
 
-    # 4. Validate repo is set (required for actual run)
+    # 4. Validate repo path exists and is a git repo
+    if not (repo_path / ".git").exists():
+        console.print(f"[bold red]Error:[/bold red] {repo_path} is not a git repository.")
+        raise typer.Exit(code=1)
+
     if cfg.repo is None:
         console.print(
-            "[bold red]Error:[/bold red] No repo specified. "
-            "Use --repo owner/repo or set target.repo in .hyperloop.yaml"
+            "[dim]No --repo set. PR operations (draft, merge, gate) will be skipped.[/dim]"
         )
-        raise typer.Exit(code=1)
 
     # 5. Construct runtime and state store, run loop
     from hyperloop.adapters.git_state import GitStateStore
@@ -136,7 +145,6 @@ def run(
         ),
     )
 
-    repo_path = Path.cwd()
     state = GitStateStore(repo_path, specs_dir=cfg.specs_dir)
     runtime = LocalRuntime(repo_path=str(repo_path))
 

{hyperloop-0.1.0 → hyperloop-0.2.0}/src/hyperloop/loop.py

@@ -340,45 +340,61 @@ class Orchestrator:
                 self._state.clear_findings(task.id)
 
     def _merge_ready_prs(self) -> None:
-        """Merge PRs for tasks at the merge-pr action step.
+        """Merge branches for tasks at the merge-pr action step.
 
-        Rebases branch first; on conflict transitions to NEEDS_REBASE.
+        With a PRManager: rebase + squash-merge the PR.
+        Without a PRManager: local git merge of worker branch into base branch.
+        On conflict, transitions to NEEDS_REBASE.
         """
-        if self._pr_manager is None:
-            logger.debug("merge: no PRManager — skipping merge")
-            return
-
         all_tasks = self._state.get_world().tasks
         for task in all_tasks.values():
             if task.status != TaskStatus.IN_PROGRESS:
                 continue
             if task.phase != Phase("merge-pr"):
                 continue
-            if task.pr is None:
-                continue
 
             branch = task.branch or f"worker/{task.id}"
 
-            # Step 1: Rebase onto base branch
-            if not self._pr_manager.rebase_branch(branch, "main"):
-                logger.warning("Rebase conflict for task %s, marking NEEDS_REBASE", task.id)
-                self._state.transition_task(
-                    task.id, TaskStatus.NEEDS_REBASE, phase=Phase("merge-pr")
-                )
-                continue
+            if self._pr_manager is not None and task.pr is not None:
+                self._merge_via_pr(task.id, task.pr, task.spec_ref, branch)
+            else:
+                self._merge_local(task.id, branch)
 
-            # Step 2: Squash-merge the PR
-            if not self._pr_manager.merge(task.pr, task.id, task.spec_ref):
-                logger.warning("Merge conflict for task %s, marking NEEDS_REBASE", task.id)
-                self._state.transition_task(
-                    task.id, TaskStatus.NEEDS_REBASE, phase=Phase("merge-pr")
-                )
-                continue
+    def _merge_via_pr(self, task_id: str, pr_url: str, spec_ref: str, branch: str) -> None:
+        """Merge via GitHub PR: rebase, then squash-merge."""
+        assert self._pr_manager is not None
 
-            # Merge succeeded — mark task complete
-            self._state.transition_task(task.id, TaskStatus.COMPLETE, phase=None)
-            self._state.clear_findings(task.id)
-            logger.info("Merged PR for task %s", task.id)
+        if not self._pr_manager.rebase_branch(branch, "main"):
+            logger.warning("Rebase conflict for task %s, marking NEEDS_REBASE", task_id)
+            self._state.transition_task(task_id, TaskStatus.NEEDS_REBASE, phase=Phase("merge-pr"))
+            return
+
+        if not self._pr_manager.merge(pr_url, task_id, spec_ref):
+            logger.warning("Merge conflict for task %s, marking NEEDS_REBASE", task_id)
+            self._state.transition_task(task_id, TaskStatus.NEEDS_REBASE, phase=Phase("merge-pr"))
+            return
+
+        self._state.transition_task(task_id, TaskStatus.COMPLETE, phase=None)
+        self._state.clear_findings(task_id)
+        logger.info("Merged PR for task %s", task_id)
+
+    def _merge_local(self, task_id: str, branch: str) -> None:
+        """Merge worker branch into base branch locally (no PR)."""
+        import subprocess
+
+        try:
+            subprocess.run(
+                ["git", "merge", branch, "--no-edit", "-m", f"merge: {task_id}"],
+                check=True,
+                capture_output=True,
+            )
+            self._state.transition_task(task_id, TaskStatus.COMPLETE, phase=None)
+            self._state.clear_findings(task_id)
+            logger.info("Local merge of %s into base branch", task_id)
+        except subprocess.CalledProcessError:
+            logger.warning("Local merge conflict for task %s, marking NEEDS_REBASE", task_id)
+            subprocess.run(["git", "merge", "--abort"], capture_output=True, check=False)
+            self._state.transition_task(task_id, TaskStatus.NEEDS_REBASE, phase=Phase("merge-pr"))
 
     # -----------------------------------------------------------------------
     # World building