stepgate 0.1.0__tar.gz → 0.2.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stepgate
-Version: 0.1.0
+Version: 0.2.0
 Summary: A step-gated micro-change protocol CLI for coding agents: propose, approve, execute, verify — one small step at a time.
 Project-URL: Homepage, https://github.com/LeoCostta/stepgate
 Project-URL: Repository, https://github.com/LeoCostta/stepgate
@@ -135,7 +135,11 @@ all sessions and agents, append-only.
 | `stepgate verify --evidence "..."` | Record verification evidence |
 | `stepgate close` | Close a verified micro-change |
 | `stepgate abandon --reason "..."` | Cleanly abandon from any non-terminal state |
-| `stepgate next --suggest "..."` | Record a next-step suggestion (opens nothing) |
+| `stepgate next [--suggest "..."]` | With `--suggest`, record a next-step suggestion; without it, show the current one |
+
+The four flow verbs also accept Portuguese aliases — English stays the default:
+`aprovar` = `approve`, `rejeitar` = `reject`, `fechar` = `close`,
+`proximo` = `next`.
 | `stepgate status` | Current session + aggregated project view |
 | `stepgate history [--session X] [--since DATE]` | Append-only, cross-session log |
 | `stepgate doctor` | Report corrupted/invalid state files (fixes nothing) |

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

@@ -106,7 +106,11 @@ all sessions and agents, append-only.
 | `stepgate verify --evidence "..."` | Record verification evidence |
 | `stepgate close` | Close a verified micro-change |
 | `stepgate abandon --reason "..."` | Cleanly abandon from any non-terminal state |
-| `stepgate next --suggest "..."` | Record a next-step suggestion (opens nothing) |
+| `stepgate next [--suggest "..."]` | With `--suggest`, record a next-step suggestion; without it, show the current one |
+
+The four flow verbs also accept Portuguese aliases — English stays the default:
+`aprovar` = `approve`, `rejeitar` = `reject`, `fechar` = `close`,
+`proximo` = `next`.
 | `stepgate status` | Current session + aggregated project view |
 | `stepgate history [--session X] [--since DATE]` | Append-only, cross-session log |
 | `stepgate doctor` | Report corrupted/invalid state files (fixes nothing) |

{stepgate-0.1.0 → stepgate-0.2.0}/src/stepgate/__init__.py

@@ -1,3 +1,3 @@
 """stepgate: a step-gated micro-change protocol CLI for coding agents."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"

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

@@ -44,13 +44,13 @@ def build_parser() -> argparse.ArgumentParser:
     p = sub.add_parser("show", help="show the active proposal rendered as prose")
     _add_session_flags(p)
 
-    p = sub.add_parser("approve", help="PENDING -> APPROVED")
+    p = sub.add_parser("approve", aliases=["aprovar"], help="PENDING -> APPROVED")
     p.add_argument("--adjust", action="store_true", help="approve with an adjusted/reduced scope")
     p.add_argument("--scope", help="comma-separated adjusted scope (files/areas)")
     p.add_argument("--note", help="note describing the adjustment")
     _add_session_flags(p)
 
-    p = sub.add_parser("reject", help="PENDING -> REJECTED")
+    p = sub.add_parser("reject", aliases=["rejeitar"], help="PENDING -> REJECTED")
     p.add_argument("--note", required=True, help="reason for rejection")
     _add_session_flags(p)
 
@@ -63,15 +63,15 @@ def build_parser() -> argparse.ArgumentParser:
     p.add_argument("--evidence", required=True, help="tests/runs/evidence demonstrating the result")
     _add_session_flags(p)
 
-    p = sub.add_parser("close", help="VERIFIED -> CLOSED")
+    p = sub.add_parser("close", aliases=["fechar"], help="VERIFIED -> CLOSED")
     _add_session_flags(p)
 
     p = sub.add_parser("abandon", help="any non-terminal state -> ABANDONED")
     p.add_argument("--reason", required=True, help="why the proposal is being abandoned")
     _add_session_flags(p)
 
-    p = sub.add_parser("next", help="record a next-step suggestion (does not open a proposal)")
-    p.add_argument("--suggest", required=True, help="the suggested next step")
+    p = sub.add_parser("next", aliases=["proximo"], help="show or record a next-step suggestion (does not open a proposal)")
+    p.add_argument("--suggest", help="the suggested next step; omit to show the current one")
     _add_session_flags(p)
 
     p = sub.add_parser("status", help="current session state + aggregated project view")
@@ -115,8 +115,12 @@ def main(argv: list[str] | None = None) -> int:
         "history": views.cmd_history,
         "doctor": doctor.cmd_doctor,
     }
+    # argparse fills args.command with the alias actually typed, so map the
+    # convenience aliases back to their canonical command name.
+    aliases = {"aprovar": "approve", "rejeitar": "reject", "fechar": "close", "proximo": "next"}
+    command = aliases.get(args.command, args.command)
     try:
-        return handlers[args.command](args)
+        return handlers[command](args)
     except StepgateError as exc:
         print(f"stepgate: error: {exc}", file=sys.stderr)
         return 1

{stepgate-0.1.0 → stepgate-0.2.0}/src/stepgate/commands/init_cmd.py

@@ -54,7 +54,8 @@ the scope of *execution*, never the depth of *investigation*. Then:
    `stepgate exec-log --summary "..." --files "a,b"`.
 4. Verify with real evidence: `stepgate verify --evidence "npm test: 12 passed"`.
 5. After the user runs `stepgate close`, suggest (don't start) the next step:
-   `stepgate next --suggest "..."`.
+   `stepgate next --suggest "..."`. Running `stepgate next` with no `--suggest`
+   just shows the currently recorded suggestion, without changing anything.
 
 **Rules:**
 - Approval is per micro-change, never cumulative. One approval is not a blanket
@@ -68,6 +69,8 @@ the scope of *execution*, never the depth of *investigation*. Then:
   proposing, or when closing a cycle) — not as a habitual check.
 - stepgate never blocks edits, commits, or the user. It records and makes the
   flow visible; deviating from it is visible, never silent.
+- The four flow verbs accept Portuguese aliases (English stays the default):
+  `aprovar` = approve, `rejeitar` = reject, `fechar` = close, `proximo` = next.
 {END_MARKER}"""
 
 

{stepgate-0.1.0 → stepgate-0.2.0}/src/stepgate/commands/lifecycle.py

@@ -8,6 +8,8 @@ import json
 import subprocess
 from pathlib import Path
 
+from rich.text import Text
+
 from stepgate import render
 from stepgate.model import (
     APPROVED,
@@ -228,6 +230,22 @@ def cmd_abandon(args) -> int:
 def cmd_next(args) -> int:
     store = Store.find()
     session = resolve_session(store, args, active_only=False)
+    if args.suggest is None:
+        if session.pending_suggestion:
+            render.console.print(
+                Text.assemble(
+                    ("Suggested next step", "bold green"),
+                    (f" ({session.name}): ", "dim"),
+                    session.pending_suggestion,
+                )
+            )
+        else:
+            render.info(
+                f"No next-step suggestion recorded in session "
+                f"[bold magenta]{session.name}[/]. Record one with "
+                "'stepgate next --suggest \"...\"'."
+            )
+        return 0
     session.pending_suggestion = args.suggest
     store.save_session(session)
     store.append_history(session.name, session.agent, "next-suggest", {"suggestion": args.suggest})

{stepgate-0.1.0 → stepgate-0.2.0}/tests/test_cli_smoke.py

@@ -54,6 +54,49 @@ def test_full_cycle(project, plan_file, capsys):
     assert read_state(project).pending_suggestion is None
 
 
+def test_next_without_suggest_shows_current(project, plan_file, capsys):
+    run("propose", "--agent", "claude", "--file", str(plan_file))
+    run("next", "--agent", "claude", "--suggest", "wire SalaJogo.tsx via supabase.rpc")
+    store = Store.find(project)
+    before = len(store.read_history())
+    capsys.readouterr()
+
+    # read-only: prints the recorded suggestion, writes nothing
+    assert run("next", "--agent", "claude") == 0
+    assert "supabase.rpc" in capsys.readouterr().out
+    assert len(Store.find(project).read_history()) == before
+
+
+def test_next_without_suggest_and_none_recorded(project, plan_file, capsys):
+    run("propose", "--agent", "claude", "--file", str(plan_file))
+    capsys.readouterr()
+    assert run("next", "--agent", "claude") == 0
+    assert "No next-step suggestion" in capsys.readouterr().out
+
+
+def test_portuguese_aliases(project, plan_file, capsys):
+    run("propose", "--agent", "claude", "--file", str(plan_file))
+    # 'aprovar' == approve
+    assert run("aprovar", "--agent", "claude") == 0
+    assert read_state(project).proposal.state == "APPROVED"
+    run("exec-log", "--agent", "claude", "--summary", "done")
+    run("verify", "--agent", "claude", "--evidence", "ok")
+    # 'fechar' == close
+    assert run("fechar", "--agent", "claude") == 0
+    assert read_state(project).proposal.state == "CLOSED"
+    # 'proximo' == next: records with --suggest, reads without it
+    assert run("proximo", "--agent", "claude", "--suggest", "wire it up") == 0
+    capsys.readouterr()
+    assert run("proximo", "--agent", "claude") == 0
+    assert "wire it up" in capsys.readouterr().out
+
+
+def test_rejeitar_alias(project, plan_file):
+    run("propose", "--agent", "claude", "--file", str(plan_file))
+    assert run("rejeitar", "--agent", "claude", "--note", "abordagem errada") == 0
+    assert read_state(project).proposal.state == "REJECTED"
+
+
 def test_cannot_skip_states_via_cli(project, plan_file, capsys):
     run("propose", "--agent", "claude", "--file", str(plan_file))
     assert run("exec-log", "--agent", "claude", "--summary", "sneaky") == 1