stackops 26.6.7__tar.gz → 26.7__tar.gz

{stackops-26.6.7/src/stackops.egg-info → stackops-26.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackops
-Version: 26.6.7
+Version: 26.7
 Summary: Developer Stack Manager
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0
@@ -13,7 +13,6 @@ Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 Requires-Dist: fire>=0.7.1
 Requires-Dist: gitpython>=3.1.46
-Requires-Dist: joblib>=1.5.3
 Requires-Dist: psutil>=7.2.2
 Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: questionary>=2.1.1

{stackops-26.6.7 → stackops-26.7}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stackops"
-version = "26.6.7"
+version = "26.7"
 description = "Developer Stack Manager"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -22,7 +22,6 @@ requires-python = ">=3.13"
 dependencies = [
     "fire>=0.7.1",
     "gitpython>=3.1.46",
-    "joblib>=1.5.3",
     "psutil>=7.2.2",
     "pyyaml>=6.0.3",
     "questionary>=2.1.1",

{stackops-26.6.7 → stackops-26.7}/src/stackops/jobs/installer/checks/install_utils.py

@@ -10,6 +10,7 @@ from io import StringIO
 import platform
 from concurrent.futures import ThreadPoolExecutor
 from pathlib import Path
+from typing import cast
 
 import stackops.utils.path_core as path_core
 from rich.console import Console
@@ -69,14 +70,14 @@ def download_google_drive_file(url: str) -> Path:
 
         # Create a temporary directory for download
         output_dir = path_core.tmpdir(prefix="gdown_")
-        # gdown.download returns the output filename
-        from gdown import download
-        output_file = download(id=file_id, output=str(output_dir) + "/", quiet=False, fuzzy=True)
-        
+        # gdown.download returns the output filename when output is a directory path
+        from gdown.download import download
+        output_file = download(id=file_id, output=str(output_dir) + "/", quiet=False)
+
         if not output_file:
             raise ValueError(f"Download failed for {url}")
-            
-        return Path(output_file)
+
+        return Path(cast(str, output_file))
     except Exception as e:
         raise RuntimeError(f"Failed to download from Google Drive: {e}") from e
 

{stackops-26.6.7 → stackops-26.7}/src/stackops/scripts/python/agents.py

@@ -320,13 +320,17 @@ def plan(
     from stackops.scripts.python.helpers.helpers_agents.agents_plan_impl import run_plan as impl
 
     try:
-        impl(user_prompt=" ".join(prompt), agent=agent)
+        plan_path = impl(user_prompt=" ".join(prompt), agent=agent)
     except ValueError as error:
         raise typer.BadParameter(str(error)) from error
+    typer.echo(f"Plan target: {plan_path}")
 
 
 def execute(
-    plan_json: Annotated[Path, typer.Argument(help="Plan JSON file generated by `agents plan`.")],
+    plan_json: Annotated[
+        Path | None,
+        typer.Argument(help="Plan JSON file generated by `agents plan`. If omitted, execute the only .ai/plans/*.plan.json file."),
+    ] = None,
     agent: Annotated[AGENTS, typer.Option("--agent", "-a", help="Agent used to check whether the active phase is finished.")] = DEFAULT_AGENT,
     interval_seconds: Annotated[int, typer.Option("--interval", "-i", help="Seconds to sleep between executor passes.")] = 300,
     once: Annotated[bool, typer.Option("--once", help="Run one executor pass and exit.")] = False,
@@ -417,8 +421,8 @@ def get_app() -> typer.Typer:
     agents_app.command(name="a", no_args_is_help=True, hidden=True)(ask)
     agents_app.command(name="plan", no_args_is_help=True, short_help="<P> Generate an agentops plan JSON via selected agent")(plan)
     agents_app.command(name="P", no_args_is_help=True, hidden=True)(plan)
-    agents_app.command(name="execute", no_args_is_help=True, short_help="<E> Execute an agentops plan JSON")(execute)
-    agents_app.command(name="E", no_args_is_help=True, hidden=True)(execute)
+    agents_app.command(name="execute", no_args_is_help=False, short_help="<E> Execute an agentops plan JSON")(execute)
+    agents_app.command(name="E", no_args_is_help=False, hidden=True)(execute)
     return apply_alias_markers(agents_app)
 
 

{stackops-26.6.7 → stackops-26.7}/src/stackops/scripts/python/agents_iter.py

@@ -3,21 +3,40 @@ from typing import Annotated
 
 import typer
 
-from stackops.scripts.python.helpers.helpers_agents.agents_iter_constants import DEFAULT_TRACK_MAX_ITERATIONS, TRACK_INTERVAL_SECONDS
+from stackops.scripts.python.helpers.helpers_agents.agents_iter_constants import (
+    CLOSE_LOOP_INTERVAL_SECONDS,
+    DEFAULT_RETAIN_PREVIOUS_ITERATIONS,
+    DEFAULT_TRACK_MAX_ITERATIONS,
+    TRACK_INTERVAL_SECONDS,
+)
 
 
 def close(
     space_name: Annotated[
         str | None,
-        typer.Argument(help="Exact Herdr iter workspace label to close. Use --all to close every iter workspace."),
+        typer.Argument(help="Herdr iter workspace label or stable ID to close. Use --all for every iter workspace."),
     ] = None,
-    continuous: Annotated[bool, typer.Option("--loop", "-l", help="Repeat close pass every 5 minutes.")] = False,
+    continuous: Annotated[bool, typer.Option("--loop", "-l", help="Repeat close passes until interrupted.")] = False,
     all_workspaces: Annotated[
         bool,
         typer.Option("--all", "-a", help="Close old idle tabs in all iter workspaces."),
     ] = False,
+    retain_previous: Annotated[
+        int,
+        typer.Option(
+            "--retain-previous",
+            "-k",
+            min=0,
+            help="Retain the latest iteration plus this many previous iterations.",
+        ),
+    ] = DEFAULT_RETAIN_PREVIOUS_ITERATIONS,
+    dry_run: Annotated[bool, typer.Option("--dry-run", help="Show the close plan without closing tabs.")] = False,
+    interval_seconds: Annotated[
+        int,
+        typer.Option("--interval", "-i", min=1, help="Seconds between close passes when --loop is used."),
+    ] = CLOSE_LOOP_INTERVAL_SECONDS,
 ) -> None:
-    """Close old idle Herdr tabs in one iter workspace, or all iter workspaces with --all."""
+    """Safely close old idle iteration tabs after revalidating their live state."""
     try:
         from stackops.scripts.python.helpers.helpers_agents.agents_iter_rich_output import show_close_iter_workspaces_loop
 
@@ -25,6 +44,9 @@ def close(
             workspace_name=space_name,
             all_workspaces=all_workspaces,
             continuous=continuous,
+            retain_previous=retain_previous,
+            dry_run=dry_run,
+            interval_seconds=interval_seconds,
         )
     except ValueError as error:
         raise typer.BadParameter(str(error)) from error
@@ -33,30 +55,37 @@ def close(
         raise typer.Exit(code=1) from error
 
 
-def clean() -> None:
-    """Clean AgentOps cache records under .ai."""
+def clean(
+    dry_run: Annotated[bool, typer.Option("--dry-run", help="Show stale iteration records without removing them.")] = False,
+) -> None:
+    """Remove stale iteration records while preserving live and unrelated AgentOps records."""
     try:
         from stackops.scripts.python.helpers.helpers_agents.agents_iter_rich_output import show_clean_agentops_cache
 
-        show_clean_agentops_cache(cwd=Path.cwd())
+        show_clean_agentops_cache(cwd=Path.cwd(), dry_run=dry_run)
     except RuntimeError as error:
         typer.echo(str(error), err=True)
         raise typer.Exit(code=1) from error
 
 
 def track(
-    space_name: Annotated[str, typer.Argument(help="Exact Herdr iter workspace label to track.")],
+    space_name: Annotated[str, typer.Argument(help="Herdr iter workspace label or stable ID to track.")],
     max_iterations: Annotated[int, typer.Argument(help="Maximum allowed iteration number before the workspace is closed.")] = DEFAULT_TRACK_MAX_ITERATIONS,
     interval_seconds: Annotated[
         int,
         typer.Option("--interval", "-i", min=1, help="Seconds to sleep between iteration-budget checks."),
     ] = TRACK_INTERVAL_SECONDS,
-    close_old_tabs: Annotated[
-        bool,
-        typer.Option("--close-old-tabs", "--close-old", "-x", help="Close old idle tabs in the tracked workspace after each check."),
-    ] = False,
+    retain_previous: Annotated[
+        int,
+        typer.Option(
+            "--retain-previous",
+            "-k",
+            min=0,
+            help="Retain the latest iteration plus this many previous iterations.",
+        ),
+    ] = DEFAULT_RETAIN_PREVIOUS_ITERATIONS,
 ) -> None:
-    """Track an iter Herdr workspace status and close it after it exceeds the iteration budget."""
+    """Track an iter Herdr workspace status, close old iteration tabs, and close after budget."""
     try:
         from stackops.scripts.python.helpers.helpers_agents.agents_iter_rich_output import show_track_iter_workspace_loop
 
@@ -64,7 +93,7 @@ def track(
             workspace_name=space_name,
             max_iterations=max_iterations,
             interval_seconds=interval_seconds,
-            close_old_tabs=close_old_tabs,
+            retain_previous=retain_previous,
         )
     except ValueError as error:
         raise typer.BadParameter(str(error)) from error
@@ -73,12 +102,22 @@ def track(
         raise typer.Exit(code=1) from error
 
 
-def status() -> None:
+def status(
+    retain_previous: Annotated[
+        int,
+        typer.Option(
+            "--retain-previous",
+            "-k",
+            min=0,
+            help="Evaluate closable tabs while retaining this many previous iterations.",
+        ),
+    ] = DEFAULT_RETAIN_PREVIOUS_ITERATIONS,
+) -> None:
     """Show each iter loop's latest iteration agent and live Herdr status."""
     try:
         from stackops.scripts.python.helpers.helpers_agents.agents_iter_rich_output import show_iter_status
 
-        show_iter_status()
+        show_iter_status(retain_previous=retain_previous)
     except RuntimeError as error:
         typer.echo(str(error), err=True)
         raise typer.Exit(code=1) from error
@@ -86,12 +125,12 @@ def status() -> None:
 
 def get_app() -> typer.Typer:
     iter_app = typer.Typer(help="🔁 <I> Iter workflow maintenance commands", no_args_is_help=True, add_help_option=True, add_completion=False)
-    iter_app.command(name="clean", no_args_is_help=False, short_help="<c> Clean AgentOps cache under .ai")(clean)
+    iter_app.command(name="clean", no_args_is_help=False, short_help="<c> Remove stale iter records under .ai")(clean)
     iter_app.command(name="c", no_args_is_help=False, hidden=True)(clean)
-    iter_app.command(name="close", no_args_is_help=False, short_help="<x> Close old idle Herdr tabs from iter workspaces")(close)
+    iter_app.command(name="close", no_args_is_help=False, short_help="<x> Revalidate and close old idle iter tabs")(close)
     iter_app.command(name="x", no_args_is_help=False, hidden=True)(close)
-    iter_app.command(name="track", no_args_is_help=False, short_help="<t> Track status and close after budget")(track)
+    iter_app.command(name="track", no_args_is_help=False, short_help="<t> Track, prune old tabs, and enforce budget")(track)
     iter_app.command(name="t", no_args_is_help=False, hidden=True)(track)
-    iter_app.command(name="status", no_args_is_help=False, short_help="<s> Show iter workspace status")(status)
+    iter_app.command(name="status", no_args_is_help=False, short_help="<s> Show live iter state and safe close counts")(status)
     iter_app.command(name="s", no_args_is_help=False, hidden=True)(status)
     return iter_app

{stackops-26.6.7 → stackops-26.7}/src/stackops/scripts/python/cloud.py

@@ -18,8 +18,11 @@ def sync(
     target: Annotated[str, typer.Argument(help="target")],
     transfers: Annotated[int, typer.Option("--transfers", "-t", help="Number of threads in syncing.")] = 10,
     root: Annotated[str, typer.Option("--root", "-R", help="Remote root.")] = defaults["root"],
-    pwd: Annotated[str | None, typer.Option("--pwd", "-P", help="Symmetric GPG encryption password used when --encrypt is set.")] = defaults["pwd"],
-    encrypt: Annotated[bool, typer.Option("--encrypt", "-e", help="Decrypt after receiving.")] = defaults["encrypt"],
+    pwd: Annotated[str | None, typer.Option("--pwd", "-P", help="Symmetric GPG encryption password. Requires --encryption symmetric.")] = defaults["pwd"],
+    encryption: Annotated[
+        EncryptionModeChoice | None,
+        typer.Option("--encryption", "-e", help="Encryption mode: symmetric/s or asymmetric/a. Omit for plaintext."),
+    ] = defaults["encryption"],
     zip_: Annotated[bool, typer.Option("--zip", "-z", help="unzip after receiving.")] = defaults["zip"],
     bisync: Annotated[bool, typer.Option("--bisync", "-b", help="Bidirectional sync.")] = False,
     delete: Annotated[bool, typer.Option("--delete", "-D", help="Delete files in remote that are not in local.")] = False,
@@ -27,7 +30,18 @@ def sync(
 ) -> None:
     """🔄 Synchronize files/folders between local and cloud storage."""
     from stackops.scripts.python.helpers.helpers_cloud.cloud_sync import main as sync_main
-    sync_main(source=source, target=target, transfers=transfers, root=root, pwd=pwd, encrypt=encrypt, zip_=zip_, bisync=bisync, delete=delete, verbose=verbose)
+    sync_main(
+        source=source,
+        target=target,
+        transfers=transfers,
+        root=root,
+        pwd=pwd,
+        encryption=encryption,
+        zip_=zip_,
+        bisync=bisync,
+        delete=delete,
+        verbose=verbose,
+    )
 
 
 def copy(
@@ -41,9 +55,15 @@ def copy(
     record_os: Annotated[str, typer.Option("--record-os", "-F", help="💻 OS filter for recorded uploads. Comma-separated: linux,darwin,windows. Defaults to all.")] = "linux,darwin,windows",
     rel2home: Annotated[bool, typer.Option("--relative2home", "-r", help="🏠 Relative to `myhome` folder")] = defaults["rel2home"],
     root: Annotated[str, typer.Option("--root", "-R", help="🌳 Remote root.")] = defaults["root"],
-    pwd: Annotated[str | None, typer.Option("--password", "-p", help="🔒 Symmetric GPG encryption password. Implies --encrypt --encryption symmetric.")] = defaults["pwd"],
-    encrypt: Annotated[bool, typer.Option("--encrypt", "-e", help="🔐 Encrypt before sending.")] = defaults["encrypt"],
-    encryption: Annotated[EncryptionModeChoice | None, typer.Option("--encryption", "-E", help="🔐 Encryption mode when --encrypt is set: symmetric/s or asymmetric/a.")] = defaults["encryption"],
+    pwd: Annotated[str | None, typer.Option("--password", "-p", help="🔒 Symmetric GPG encryption password. Requires --encryption symmetric.")] = defaults["pwd"],
+    password_name: Annotated[
+        str | None,
+        typer.Option("--password-name", "-P", help="🔐 Exact StackOps secrets login name containing PASSWORD. Requires --encryption symmetric."),
+    ] = None,
+    encryption: Annotated[
+        EncryptionModeChoice | None,
+        typer.Option("--encryption", "-e", help="🔐 Encryption mode: symmetric/s or asymmetric/a. Omit for plaintext."),
+    ] = defaults["encryption"],
     zip_: Annotated[bool, typer.Option("--zip", "-z", help="📦 unzip after receiving.")] = defaults["zip"],
     os_specific: Annotated[bool, typer.Option("--os-specific", "-O", help="💻 choose path specific for this OS.")] = defaults["os_specific"],
 ) -> None:
@@ -62,7 +82,7 @@ def copy(
         rel2home=rel2home,
         root=root,
         pwd=pwd,
-        encrypt=encrypt,
+        password_name=password_name,
         encryption=encryption,
         zip_=zip_,
         os_specific=os_specific,

{stackops-26.6.7 → stackops-26.7}/src/stackops/scripts/python/devops.py

@@ -132,8 +132,16 @@ def execute(
     interactive: Annotated[bool, typer.Option(..., "--interactive", "-i", help="Interactive selection of scripts to run")] = False,
     command: Annotated[bool | None, typer.Option(..., "--command", "-c", help="Run as command")] = False,
     list_scripts: Annotated[bool, typer.Option(..., "--list", "-l", help="List available scripts in all locations")] = False,
+    run_in_subprocess: Annotated[
+        bool,
+        typer.Option(..., "--subprocess", help="Run shell scripts in a child shell instead of sourcing them in the caller"),
+    ] = False,
 ) -> None:
     """🚀 Execute python/shell scripts from pre-defined directories or as command."""
+    if name == "--help":
+        typer.echo(ctx.get_help())
+        return
+
     import stackops.scripts.python.helpers.helpers_devops.run_script as run_py_script_module
 
     forwarded_args = [str(arg) for arg in ctx.args]
@@ -144,6 +152,7 @@ def execute(
         interactive=interactive,
         command=command,
         list_scripts=list_scripts,
+        run_in_subprocess=run_in_subprocess,
         forwarded_args=forwarded_args,
     )