substratum-cli 0.2.3__tar.gz → 0.2.5__tar.gz

{substratum_cli-0.2.3 → substratum_cli-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: substratum-cli
-Version: 0.2.3
+Version: 0.2.5
 Summary: Substratum: verified-or-refused code, with provenance. The terminal over the comprehension engine.
 Author: Substratum
 License: LicenseRef-Proprietary

{substratum_cli-0.2.3 → substratum_cli-0.2.5}/substratum_cli/__init__.py

@@ -5,4 +5,4 @@ Import budget: this package is stdlib-only; the ONLY module reaching into backen
 """
 # SINGLE SOURCE OF TRUTH for the release version. pyproject reads this (dynamic version), the boot shows
 # it, and the update-check compares against it. To cut a release, bump ONLY this line, then publish.
-__version__ = "0.2.3"
+__version__ = "0.2.5"

{substratum_cli-0.2.3 → substratum_cli-0.2.5}/substratum_cli/_vendor/client_gate.py

@@ -51,8 +51,11 @@ def _run(cmd: Sequence[str], cwd: str, timeout: int) -> Tuple[Optional[int], str
         # SHADOWED by the stale pyc (timestamp validation is second-granular), and the
         # with-patch run silently re-imports the buggy module -- the differential then
         # reports TEST_FAILED for a genuine fix (or worse directions on other shapes).
+        # errors="replace": test output is arbitrary user bytes (a test may print binary or a
+        # non-UTF-8 traceback); strict decode would raise UnicodeDecodeError and crash the gate.
+        # The verdict is the return code, never the decoded text, so replacement is verdict-neutral.
         r = subprocess.run(list(cmd), cwd=cwd, capture_output=True, text=True,
-                           timeout=timeout,
+                           errors="replace", timeout=timeout,
                            env=dict(os.environ, PYTHONHASHSEED="0", TMPDIR="/tmp",
                                     PYTHONDONTWRITEBYTECODE="1"))
         return r.returncode, (r.stdout + "\n" + r.stderr)[-4000:]
@@ -122,7 +125,8 @@ def run_client_gate(repo_dir: str, base_commit: str, edits: Dict[str, str],
     wt = tempfile.mkdtemp(prefix="cg_wt_", dir=os.environ.get("TMPDIR") or None)
     try:
         r = subprocess.run(["git", "-C", repo_dir, "worktree", "add", "--detach", "-f",
-                            wt, base_commit], capture_output=True, text=True, timeout=120)
+                            wt, base_commit], capture_output=True, text=True,
+                           errors="replace", timeout=120)
         if r.returncode != 0:
             return ClientGateResult(False, "GATE_WORKTREE_FAILED", r.stderr[-300:])
         cmd = resolve_test_command(wt, test_cmd, test_paths)

{substratum_cli-0.2.3 → substratum_cli-0.2.5}/substratum_cli/commands/apply.py

@@ -35,10 +35,10 @@ def cmd_apply(repo: str, run_id: str) -> "_result.SubstratumResult":
         patch = fh.name
     try:
         r = subprocess.run(["git", "-C", repo, "apply", "--index", patch],
-                           capture_output=True, text=True)
+                           capture_output=True, text=True, errors="replace")
         if r.returncode != 0:
             r2 = subprocess.run(["git", "-C", repo, "apply", "--3way", patch],
-                                capture_output=True, text=True)
+                                capture_output=True, text=True, errors="replace")
             if r2.returncode != 0:
                 return _result.make(codes.REFUSED, run_id, "apply", code=codes.APPLY_STATE_DRIFT,
                                     refusal=refusals.build(codes.APPLY_STATE_DRIFT,

{substratum_cli-0.2.3 → substratum_cli-0.2.5}/substratum_cli/commands/failing.py

@@ -117,7 +117,8 @@ def cmd_failing(repo: str, path: Optional[str] = None, test_command: Optional[st
     if path:
         run_argv.append(path)
     try:
-        r = subprocess.run(run_argv, cwd=repo, capture_output=True, text=True, timeout=timeout,
+        r = subprocess.run(run_argv, cwd=repo, capture_output=True, text=True,
+                           errors="replace", timeout=timeout,
                            env={**os.environ, "TMPDIR": "/tmp", "CI": "1", "NO_COLOR": "1"})
     except subprocess.TimeoutExpired:
         return _refuse(rid, codes.GATE_PRECONDITION, f"the test suite did not finish within {timeout}s")

{substratum_cli-0.2.3 → substratum_cli-0.2.5}/substratum_cli/commands/pr.py

@@ -66,7 +66,7 @@ def cmd_pr(repo: str, run_id: str = None, title: str = None) -> "_result.Substra
     if gh:
         title = title or f"Substratum verified: {res.operation} {target}"[:100]
         r = subprocess.run([gh, "pr", "create", "--title", title, "--body", body],
-                           cwd=repo, capture_output=True, text=True, timeout=60)
+                           cwd=repo, capture_output=True, text=True, errors="replace", timeout=60)
         if r.returncode == 0:
             return _result.make(codes.PASS, run_id, "pr",
                                 data={"url": r.stdout.strip(), "branch": branch, "certified": run_id})

{substratum_cli-0.2.3 → substratum_cli-0.2.5}/substratum_cli/gitio.py

@@ -7,8 +7,13 @@ from typing import List, Optional
 
 
 def _git(repo: str, *args: str, timeout: int = 60) -> subprocess.CompletedProcess:
+    # errors="replace": git output carries arbitrary working-tree bytes (a `diff` of a large file
+    # git treats as text but that holds a non-UTF-8 byte; a non-ASCII untracked filename). Strict
+    # decode would raise UnicodeDecodeError -- this runs on EVERY command via the run-id dirty-hash,
+    # so a single binary-ish file in the user's tree would crash the whole CLI. Replacement is
+    # deterministic (same bytes -> same text -> same hash), so the run-id story is preserved.
     return subprocess.run(["git", "-C", repo, *args], capture_output=True, text=True,
-                          timeout=timeout)
+                          errors="replace", timeout=timeout)
 
 
 def is_git_repo(repo: str) -> bool:
@@ -23,11 +28,13 @@ def apply_reverse(repo: str, diff_text: str) -> tuple[bool, str]:
     if not diff_text.strip():
         return False, "empty diff"
     r = subprocess.run(["git", "-C", repo, "apply", "--reverse", "--3way", "-"],
-                       input=diff_text, capture_output=True, text=True, timeout=60)
+                       input=diff_text, capture_output=True, text=True,
+                       errors="replace", timeout=60)
     if r.returncode == 0:
         return True, "reverted"
     r2 = subprocess.run(["git", "-C", repo, "apply", "--reverse", "-"],
-                        input=diff_text, capture_output=True, text=True, timeout=60)
+                        input=diff_text, capture_output=True, text=True,
+                        errors="replace", timeout=60)
     if r2.returncode == 0:
         return True, "reverted"
     err = (r.stderr or r2.stderr or "").strip().splitlines()

{substratum_cli-0.2.3 → substratum_cli-0.2.5}/substratum_cli/session.py

@@ -592,7 +592,7 @@ class Session:
         head("MEMORY & PROOF")
         row("runs", "all you have done, and which refusals became fixes")
         row("show <run>", "see a run;  replay <run>  re-runs it byte-identical")
-        row("history", "re-run earlier commands  (!<n>  !!  !<prefix>)")
+        row("history", "the whole build trail;  history <word> searches;  run <n> replays a line")
         head("SETUP")
         row("doctor / init", "check the environment / what this repo can gate")
         row("login", "connect the hosted engine for fix and write")
@@ -619,6 +619,7 @@ class Session:
         self.banner()
         from . import style as S
         prompt = (S.GOLD + S.g("brand") + " " + S.RESET) if self.color else (S.g("brand") + " ")
+        exit_hints = 0
         while True:
             try:
                 line = input(prompt)
@@ -626,7 +627,13 @@ class Session:
                 sys.stdout.write("\n")
                 _leave()
             except KeyboardInterrupt:
+                # Ctrl-C clears the current line (readline behavior); it does NOT exit. Users spam it
+                # trying to leave and just get blank lines, so surface the real exit the first few
+                # times, then stay quiet for power users who use Ctrl-C to clear a half-typed line.
                 sys.stdout.write("\n")
+                if exit_hints < 3:
+                    self._say("  Ctrl-C clears the line. to leave, type  /exit  (or press Ctrl-D)", _DIM)
+                    exit_hints += 1
                 continue
             try:
                 res, keep = self.handle(line)
@@ -638,8 +645,9 @@ class Session:
                 sys.stdout.write("\n")
                 self._say("  cancelled (session still warm)", _CYAN)
                 continue
-            except Exception as e:  # a command fault must not kill the session
-                self._say(f"  error: {e}", _CYAN)
+            except Exception as e:  # belt: the ops refuse, never raise -- but a fault must not kill the session
+                self._say(f"  unexpected internal error: {e}", _CYAN)
+                self._say("  the session is still warm; retry or try a different request", _DIM)
                 continue
             if not keep:
                 _leave()

{substratum_cli-0.2.3 → substratum_cli-0.2.5}/substratum_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: substratum-cli
-Version: 0.2.3
+Version: 0.2.5
 Summary: Substratum: verified-or-refused code, with provenance. The terminal over the comprehension engine.
 Author: Substratum
 License: LicenseRef-Proprietary