specfuse-loop 0.3.13__tar.gz → 0.3.15__tar.gz

{specfuse_loop-0.3.13/specfuse_loop.egg-info → specfuse_loop-0.3.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfuse-loop
-Version: 0.3.13
+Version: 0.3.15
 Summary: Local-first executor for the Specfuse Plan + Work Unit gate-cycle methodology.
 Author: Specfuse contributors
 License: Apache-2.0

{specfuse_loop-0.3.13 → specfuse_loop-0.3.15}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specfuse-loop"
-version = "0.3.13"
+version = "0.3.15"
 description = "Local-first executor for the Specfuse Plan + Work Unit gate-cycle methodology."
 readme = "README.md"
 requires-python = ">=3.10"

specfuse_loop-0.3.15/specfuse/loop/_filelock.py

@@ -0,0 +1,44 @@
+#
+# Copyright 2026 Specfuse contributors
+# Licensed under the Apache License, Version 2.0. See LICENSE.
+#
+"""Cross-platform advisory lock for the driver's single-instance working-tree lock.
+
+The kernel must auto-release the lock on process exit, including SIGKILL, with
+no cleanup step — this is why POSIX `fcntl.flock` and Windows `msvcrt.locking`
+are used here instead of any userspace primitive. Pidfiles are ruled out: the
+pid-holder can die without a chance to remove its file, leaving a stale lock
+that stalls or is silently skipped by the next launch.
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+
+def acquire_tree_lock(specfuse_dir: Path):
+    """Open .specfuse/.loop.lock and acquire a non-blocking exclusive lock.
+
+    Returns the open file object; caller keeps it alive for the process
+    lifetime — the OS auto-releases on fd/handle close or process death
+    (SIGKILL included), so no stale-lock cleanup is ever needed.
+    Raises BlockingIOError if another process already holds the lock.
+    """
+    lock_path = specfuse_dir / ".loop.lock"
+    lock_path.parent.mkdir(parents=True, exist_ok=True)
+    fd = lock_path.open("w")
+    try:
+        if sys.platform == "win32":
+            import msvcrt
+            try:
+                msvcrt.locking(fd.fileno(), msvcrt.LK_NBLCK, 1)
+            except OSError as exc:
+                raise BlockingIOError from exc
+        else:
+            import fcntl
+            fcntl.flock(fd, fcntl.LOCK_EX | fcntl.LOCK_NB)
+    except BlockingIOError:
+        fd.close()
+        raise
+    return fd

specfuse_loop-0.3.15/specfuse/loop/data/VERSION

@@ -0,0 +1 @@
+0.3.15

{specfuse_loop-0.3.13 → specfuse_loop-0.3.15}/specfuse/loop/data/docs/getting-started.md

@@ -31,6 +31,16 @@ python3 -m pip install specfuse
 > venv) — that's what puts `specfuse-loop` / `specfuse-lint` on PATH for the gate
 > commands to find.
 
+> **Windows: Git-Bash is required.** The driver runs natively on Windows (no WSL),
+> but it routes gate commands through **Git-Bash** so a target repo's
+> `verification.yml` (`&&`, `exit 1 || exit 0`, `bats`, globs) runs unchanged.
+> Install [Git for Windows](https://gitforwindows.org/) — it ships `bash.exe`, no
+> admin and no WSL feature needed — before running the loop. The driver prefers
+> the Git-for-Windows `bash.exe` over the `C:\Windows\System32\bash.exe` WSL
+> launcher; it also normalizes `python3` gate tokens to your Windows interpreter
+> and resolves the `claude` CLI via `PATHEXT`, so gate commands authored on
+> POSIX run as-is.
+
 Enable the skills plugin in Claude Code (one-time):
 
 ```

{specfuse_loop-0.3.13 → specfuse_loop-0.3.15}/specfuse/loop/gh_backend.py

@@ -13,9 +13,14 @@ from typing import Callable, Optional
 from . import loop as _loop
 
 
-def _default_runner(args: list) -> None:
-    """Shell out to gh with the given argument list. Not called in tests."""
-    subprocess.run(args, check=True, capture_output=True, text=True)
+def _default_runner(args: list, check: bool = True):
+    """Shell out to gh with the given argument list. Not called in tests.
+
+    Returns the completed process so probing callers (e.g. the `gh pr view`
+    idempotency check) can inspect `.returncode` without raising; side-effecting
+    callers pass no `check` override and get the prior raise-on-failure behavior.
+    """
+    return subprocess.run(args, check=check, capture_output=True, text=True)
 
 
 class GitHubBackend(_loop.Backend):
@@ -55,9 +60,9 @@ class GitHubBackend(_loop.Backend):
         title = feat_fm.get("title", feature_id)
 
         # Idempotent: skip PR creation if one already exists for this branch.
-        check = subprocess.run(
+        check = self._runner(
             ["gh", "pr", "view", branch, "--repo", self.repo, "--json", "number"],
-            capture_output=True, text=True,
+            check=False,
         )
         if check.returncode != 0:
             body = (
@@ -70,7 +75,7 @@ class GitHubBackend(_loop.Backend):
                 "gh", "pr", "create",
                 "--title", f"[{feature_id}] {title}",
                 "--body", body,
-                "--base", "main",
+                "--base", _loop.resolve_base(feat_fm),
                 "--head", branch,
             ])
 

{specfuse_loop-0.3.13 → specfuse_loop-0.3.15}/specfuse/loop/lint_plan.py

@@ -249,6 +249,15 @@ def lint(feature_dir: Path) -> list[str]:
     if missing:
         errs.append(f"PLAN.md frontmatter missing keys: {sorted(missing)}")
 
+    if "base" in fm:
+        base_val = fm["base"]
+        feature_id_val = fm.get("feature_id", feature_dir.name)
+        if not isinstance(base_val, str) or not base_val.strip():
+            errs.append(
+                f"{feature_id_val}: PLAN.md frontmatter 'base' key is present but "
+                f"empty/whitespace-only/non-string: {base_val!r}"
+            )
+
     graph = _find_task_graph_block(body)
     if graph is None:
         return errs + ["PLAN.md has no ```yaml graph block"]