substratum-cli 0.2.0__tar.gz → 0.2.1__tar.gz

{substratum_cli-0.2.0 → substratum_cli-0.2.1}/PKG-INFO

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

{substratum_cli-0.2.0 → substratum_cli-0.2.1}/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.0"
+__version__ = "0.2.1"

{substratum_cli-0.2.0 → substratum_cli-0.2.1}/substratum_cli/_boot.py

@@ -145,16 +145,18 @@ def render(name, census, langs, libname, patterns, warm, standing, version,
     # fix + write run on the hosted engine; summarize/failing/verify run offline. Say so BEFORE they hit
     # a NO_ENGINE refusal, and pick an ask-example that actually works in their current state.
     ask_ex = '"fix the failing test"' if logged_in else '"what does this codebase do?"'
+    # the signpost text aligns at col 4 -- the same column as the welcome-back text -- so the whole bottom
+    # "here is what you can do" region reads as one clean left edge instead of jutting out under the box.
     out += [""]
     if update_to:                           # a pip package cannot self-update; hand over the one command
         arrow = "^" if ascii_mode else "↑"
-        out += ["  " + c(GO, f"{arrow} update") + c(LAB, f"  Substratum {update_to} is available")
+        out += ["    " + c(GO, f"{arrow} update") + c(LAB, f"  Substratum {update_to} is available")
                 + c(CH, f"   {dot}   ") + c(GO, "pip install --upgrade substratum-cli")]
     if not logged_in:
-        out += ["  " + c(GO, "login") + c(LAB, "  to ") + c(DAT, "fix") + c(LAB, " and ") + c(DAT, "write")
+        out += ["    " + c(GO, "login") + c(LAB, "  to ") + c(DAT, "fix") + c(LAB, " and ") + c(DAT, "write")
                 + c(LAB, " code (connects the engine)")
                 + c(CH, f"   {dot}   ") + c(LAB, "summarize, failing, verify work offline")]
-    out += ["  " + c(GO, "help") + c(LAB, "  see everything you can do")
+    out += ["    " + c(GO, "help") + c(LAB, "  see everything you can do")
             + c(CH, f"   {dot}   ") + c(LAB, "or just ask: ") + c(GO, ask_ex)]
     return out
 

{substratum_cli-0.2.0 → substratum_cli-0.2.1}/substratum_cli/session.py

@@ -12,6 +12,7 @@ model, the run store, and the gate are all identical. The session adds no new en
 from __future__ import annotations
 
 import os
+import re
 import shlex
 import sys
 import threading
@@ -179,6 +180,15 @@ class Session:
                 return None, True
             self._say("  " + self._paint(recalled, _DIM))       # echo what is being re-run
             line = recalled
+        # plain-language re-run: "run 12" replays history line 12 (clearer than the cryptic "!" syntax)
+        _rm = re.match(r"^run\s+(-?\d+)$", line)
+        if _rm:
+            recalled = self._recall(_rm.group(1))
+            if recalled is None:
+                self._say(f"  no history line {_rm.group(1)}  --  type  history  to see them", _CYAN)
+                return None, True
+            self._say("  " + self._paint(recalled, _DIM))
+            line = recalled
         try:
             parts = shlex.split(line)
         except ValueError:
@@ -254,7 +264,7 @@ class Session:
             {"login": auth.cmd_login, "logout": auth.cmd_logout, "whoami": auth.cmd_whoami}[cmd]()
             return None, True
         if cmd in ("history", "hist"):
-            self._history_cmd()
+            self._history_cmd(" ".join(args))
             return None, True
         if cmd in ("runs", "log"):
             from .commands.history import cmd_runs
@@ -302,15 +312,46 @@ class Session:
                 return c
         return None
 
-    def _history_cmd(self):
-        if not self._history:
-            self._say("  no commands yet this session", _DIM)
+    def _history_cmd(self, arg=""):
+        # The trail is PERSISTENT (grows across sessions, can be hundreds), so never dump it all: show a
+        # recent window with the total, let `history <word>` search and `history all` widen. Re-run is a
+        # plain verb -- `run <n>` -- not the cryptic bash `!` (which still works for shell muscle memory).
+        from . import style as S
+        pn = S.Painter(self.color)
+        h = self._history
+        if not h:
+            self._say("  " + pn("no commands yet", S.CHROME))
+            return
+        arg = (arg or "").strip()
+        total = len(h)
+        indexed = list(enumerate(h, 1))
+        if arg == "all":
+            items = indexed[-60:]
+            head = f"showing last {len(items)} of {total}"
+        elif arg:
+            hits = [(i, c) for i, c in indexed if arg.lower() in c.lower()]
+            items = hits[-40:]
+            head = (f"{len(hits)} match" + ("" if len(hits) == 1 else "es") + f' for "{arg}"'
+                    + (" (last 40)" if len(hits) > 40 else ""))
+        else:
+            items = indexed[-15:]
+            head = (f"last {len(items)} of {total}" if total > len(items)
+                    else f"{total} command" + ("" if total == 1 else "s"))
+        self._say("  " + pn("history", S.BOLD) + "   " + pn(head, S.LABEL))
+        w = len(str(total))
+        for i, c in items:
+            self._say("    " + pn(str(i).rjust(w), S.CHROME) + "   "
+                      + pn(S.ellipsize(c, S.read_width() - w - 8), S.LABEL))
+        if not items:
+            self._say("    " + pn(f'nothing matches "{arg}"  --  try another word', S.CHROME))
             return
-        self._say(self._paint("  session history", _BOLD))
-        start = max(1, len(self._history) - 29)
-        for i, c in enumerate(self._history[-30:], start):
-            self._say(f"  {self._paint(str(i).rjust(3), _DIM)}  {c}")
-        self._say(self._paint("  re-run:  !<n>  ·  !!  ·  !<prefix>", _DIM))
+        eg = items[-1][0]                                  # a concrete number the user can copy
+        bits = [pn("run " + str(eg), S.GOLD) + pn("  replays that line", S.CHROME)]
+        if not arg:
+            bits.append(pn("history <word>", S.GOLD) + pn("  searches", S.CHROME))
+            if total > len(items):
+                bits.append(pn("history all", S.GOLD) + pn("  shows more", S.CHROME))
+        self._say("  " + pn("   ·   ", S.CHROME).join(bits))
 
     # ---- natural-language router (closed-class, deterministic, no LLM) ----
     def _route_nl(self, line: str):

{substratum_cli-0.2.0 → substratum_cli-0.2.1}/substratum_cli.egg-info/PKG-INFO

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