stackops 26.6.6__tar.gz → 26.7__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackops
-Version: 26.6.6
+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.6 → stackops-26.7}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stackops"
-version = "26.6.6"
+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",
@@ -69,58 +68,58 @@ stackops = ["**/*.toml", "**/*.md", "**/*.sh", "**/*.ps1", "**/*.txt", "utils/sc
 [dependency-groups]
 dev = [
     "aider>=0.2.6",
-    "build>=1.4.1",
+    "build>=1.5.0",
     "cleanpy>=0.5.1",
     "cowsay>=6.1",
-    "duckdb>=1.5.1",
-    "gdown>=5.2.1",
-    "griffe>=2.0.2",
+    "duckdb>=1.5.4",
+    "gdown>=6.1.0",
+    "griffe>=2.1.0",
     "ipdb>=0.13.13",
-    "ipykernel>=7.2.0",
-    "ipython>=9.11.0",
-    "kaleido>=1.2.0",
-    "marimo>=0.21.1",
-    "matplotlib>=3.10.8",
-    "mkdocstrings>=1.0.3",
-    "mkdocstrings-python>=2.0.3",
-    "mypy>=1.19.1",
-    "numpy>=2.4.3",
-    "pandas>=3.0.1",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "kaleido>=1.3.0",
+    "marimo>=0.23.11",
+    "matplotlib>=3.11.0",
+    "mkdocstrings>=1.0.4",
+    "mkdocstrings-python>=2.0.5",
+    "mypy>=2.1.0",
+    "numpy>=2.5.0",
+    "pandas>=3.0.3",
     "paramiko>=5.0.0",
-    "plotly>=6.6.0",
-    "polars>=1.39.3",
-    "pre-commit>=4.5.1",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "pre-commit>=4.6.0",
     "pudb>=2025.1.5",
-    "py7zr>=1.1.0",
-    "pydantic>=2.12.5",
-    "pydeps>=3.0.2",
-    "pyinstaller>=6.19.0",
-    "pylint>=4.0.5",
-    "pylsp-mypy>=0.7.1",
-    "pymupdf>=1.27.2.2",
-    "pypdf>=6.9.2",
-    "pyrefly>=0.58.0",
-    "pyright>=1.1.408",
-    "pytest>=9.0.2",
+    "py7zr>=1.1.3",
+    "pydantic>=2.13.4",
+    "pydeps>=3.0.6",
+    "pyinstaller>=6.21.0",
+    "pylint>=4.0.6",
+    "pylsp-mypy>=0.7.3",
+    "pymupdf>=1.27.2.3",
+    "pypdf>=6.14.2",
+    "pyrefly>=1.1.1",
+    "pyright>=1.1.411",
+    "pytest>=9.1.1",
     "python-lsp-server[mypy]>=1.14.0",
     "qrcode>=8.2",
-    "ruff>=0.15.7",
+    "ruff>=0.15.20",
     "ruff-lsp>=0.0.62",
-    "sqlalchemy>=2.0.48",
-    "textual>=8.1.1",
+    "sqlalchemy>=2.0.51",
+    "textual>=8.2.7",
     "trogon>=0.6.0",
-    "ty>=0.0.25",
-    "types-mysqlclient>=2.2.0.20250915",
-    "types-paramiko>=4.0.0.20260322",
-    "types-pytz>=2026.1.1.20260304",
-    "types-pyyaml>=6.0.12.20250915",
-    "types-requests>=2.32.4.20260324",
+    "ty>=0.0.55",
+    "types-mysqlclient>=2.2.0.20260508",
+    "types-paramiko>=5.0.0.20260617",
+    "types-pytz>=2026.2.0.20260518",
+    "types-pyyaml>=6.0.12.20260518",
+    "types-requests>=2.33.0.20260518",
     "types-sqlalchemy>=1.4.53.38",
-    "types-toml>=0.10.8.20240310",
+    "types-toml>=0.10.8.20260518",
     "types-urllib3>=1.26.25.14",
     "vt-py>=0.22.0",
     "yapf>=0.43.0",
-    "zensical>=0.0.29",
+    "zensical>=0.0.46",
 ]
 other = [
     "duckdb-engine>=0.17.0",
@@ -128,18 +127,18 @@ other = [
     "vt-py>=0.22.0",
 ]
 plot = [
-    "duckdb>=1.5.1",
-    "ipykernel>=7.2.0",
-    "ipython>=9.11.0",
-    "jupyterlab>=4.5.6",
-    "kaleido>=1.2.0",
-    "matplotlib>=3.10.8",
+    "duckdb>=1.5.4",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "jupyterlab>=4.6.0",
+    "kaleido>=1.3.0",
+    "matplotlib>=3.11.0",
     "nbformat>=5.10.4",
-    "numpy>=2.4.3",
-    "plotly>=6.6.0",
-    "polars>=1.39.3",
+    "numpy>=2.5.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
     "python-magic>=0.4.27",
-    "sqlalchemy>=2.0.48",
+    "sqlalchemy>=2.0.51",
 ]
 
 

{stackops-26.6.6 → 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
-        import gdown
-        output_file = gdown.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.6 → stackops-26.7}/src/stackops/scripts/python/agents.py

@@ -133,47 +133,6 @@ def add_mcp(
         raise typer.BadParameter(str(e)) from e
 
 
-def make_todo_files(
-    pattern: Annotated[str, typer.Argument(help="Pattern or keyword to match files by")] = ".py",
-    repo: Annotated[
-        str, typer.Argument(help="Repository or workspace path. If inside a git repo, its root is used; otherwise the directory itself is scanned.")
-    ] = ".",
-    strategy: Annotated[
-        Literal["name", "keywords"],
-        typer.Option("-s", "--strategy", help="Strategy to filter files: 'name' for filename matching, 'keywords' for content matching"),
-    ] = "name",
-    exclude_init: Annotated[bool, typer.Option("-x", "--exclude-init", help="Exclude __init__.py files from the checklist")] = True,
-    include_line_count: Annotated[bool, typer.Option("-l", "--line-count", help="Include line count column in the output")] = False,
-    output_path: Annotated[str, typer.Option("-o", "--output-path", help="Base path for output files relative to repo root")] = ".ai/todo/files",
-    format_type: Annotated[Literal["csv", "md", "txt"], typer.Option("-f", "--format", help="Output format: csv, md (markdown), or txt")] = "md",
-    split_every: Annotated[
-        int | None, typer.Option("--split-every", "-e", help="Split output into multiple files, each containing at most this many results")
-    ] = None,
-    split_to: Annotated[int | None, typer.Option("--split-to", "-t", help="Split output into exactly this many files")] = None,
-) -> None:
-    """Generate checklist with Python and shell script files in the repository or workspace filtered by pattern."""
-    from stackops.scripts.python.ai.utils.generate_files import make_todo_files as impl
-
-    impl(
-        pattern=pattern,
-        repo=repo,
-        strategy=strategy,
-        exclude_init=exclude_init,
-        include_line_count=include_line_count,
-        output_path=output_path,
-        format_type=format_type,
-        split_every=split_every,
-        split_to=split_to,
-    )
-
-
-def create_symlink_command(num: Annotated[int, typer.Argument(help="Number of symlinks to create (1-5).")] = 5) -> None:
-    """Create symlinks to repo_root at ~/code_copies/${repo_name}_copy_{i}."""
-    from stackops.scripts.python.ai.utils.generate_files import create_symlink_command as impl
-
-    impl(num=num)
-
-
 def _resolve_interactive_agent(agent: INTERACTIVE_AGENT) -> AGENTS:
     return _INTERACTIVE_AGENT_ALIASES[agent]
 
@@ -348,6 +307,45 @@ def ask(
     raise typer.Exit(code=return_code)
 
 
+def plan(
+    prompt: Annotated[
+        list[str],
+        typer.Argument(
+            help="Plan objective. Use -- before the objective to pass option-looking text as prompt content.",
+        ),
+    ],
+    agent: Annotated[AGENTS, typer.Option("--agent", "-a", help="Agent to generate the plan.")] = DEFAULT_AGENT,
+) -> None:
+    """Generate an agentops plan JSON file via selected agent."""
+    from stackops.scripts.python.helpers.helpers_agents.agents_plan_impl import run_plan as impl
+
+    try:
+        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 | 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,
+) -> None:
+    """Execute an agentops plan JSON file."""
+    import typer as _typer
+
+    from stackops.scripts.python.helpers.helpers_agents.agents_execute_impl import run_execute as impl
+
+    try:
+        impl(plan_path=plan_json, checker_agent=agent, interval_seconds=interval_seconds, once=once, report=_typer.echo)
+    except ValueError as error:
+        raise typer.BadParameter(str(error)) from error
+
+
 def add_skill(
     skill_name: Annotated[
         str | None, typer.Argument(help="Name(s) of the skills to add, comma-separated. If omitted, opens an interactive multi-select picker.")
@@ -371,7 +369,7 @@ def add_skill(
     backend: Annotated[
         _SKILL_INSTALL_BACKEND,
         typer.Option("--backend", "-b", help="Install backend: bunx/npx use the upstream skills CLI; stackops/s copies bundled skills locally."),
-    ] = "bunx",
+    ] = "stackops",
     yes: Annotated[
         bool,
         typer.Option("--yes", "-y", help="Pass --yes to the upstream skills CLI."),
@@ -408,14 +406,6 @@ def get_app() -> typer.Typer:
     agents_app.command(name="m", hidden=True)(add_mcp)
     agents_app.command(name="add-skill", short_help="<s> Add a skill to an agent")(add_skill)
     agents_app.command(name="s", hidden=True)(add_skill)
-    agents_app.command("add-todo", no_args_is_help=True, short_help="<d> Generate a markdown file listing all Python files in the repo")(
-        make_todo_files
-    )
-    agents_app.command("d", no_args_is_help=True, hidden=True)(make_todo_files)
-    agents_app.command(name="add-symlinks", no_args_is_help=True, short_help="<L> Create symlinks to the current repo in ~/code_copies/")(
-        create_symlink_command
-    )
-    agents_app.command(name="L", no_args_is_help=True, hidden=True)(create_symlink_command)
     agents_app.command(
         "add-config", no_args_is_help=True, help=init_config.__doc__, short_help="<c> Initialize AI configurations in the current repository"
     )(init_config)
@@ -429,6 +419,10 @@ def get_app() -> typer.Typer:
     agents_app.command(name="i", no_args_is_help=False, hidden=True)(run_interactive)
     agents_app.command(name="ask", no_args_is_help=True, short_help="<a> Ask a selected agent directly")(ask)
     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=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.7/src/stackops/scripts/python/agents_browser.py

@@ -0,0 +1,165 @@
+from typing import Annotated
+
+import typer
+
+from stackops.scripts.python.helpers.helpers_agents.agents_browser_constants import BrowserName, BrowserTechName, DEFAULT_BROWSER_PORT
+from stackops.scripts.python.helpers.helpers_agents.agents_browser_launch_models import DetachedBrowserLaunchResult, TmuxBrowserLaunchResult
+
+
+def install_tech(
+    which: Annotated[
+        BrowserTechName,
+        typer.Option(
+            "--which",
+            "-w",
+            help="Browser automation tech: agent-browser, playwright-cli, chrome-devtools-mcp, or playwright-mcp.",
+            case_sensitive=False,
+            show_choices=True,
+        ),
+    ] = "agent-browser",
+) -> None:
+    """Install browser automation CLI or MCP support for agents."""
+    from stackops.scripts.python.helpers.helpers_agents.agents_browser_impl import install_browser_tech
+
+    try:
+        result = install_browser_tech(which=which)
+    except ValueError as error:
+        raise typer.BadParameter(str(error)) from error
+    except RuntimeError as error:
+        typer.echo(str(error), err=True)
+        raise typer.Exit(code=1) from error
+
+    typer.echo(f"Prepared {result.which} in: {result.install_root}")
+    for command in result.commands:
+        typer.echo(f"Ran: {' '.join(command)}")
+    for guide_path in result.guide_paths:
+        typer.echo(f"Wrote: {guide_path}")
+    if len(result.mcp_servers) > 0:
+        typer.echo(f"MCP catalog servers: {', '.join(result.mcp_servers)}")
+        typer.echo(f"Install into an agent with: stackops agents add-mcp {','.join(result.mcp_servers)} --agent codex --scope local")
+
+
+def launch_browser(
+    port: Annotated[int, typer.Option("--port", "-p", help="Browser automation endpoint port.")] = DEFAULT_BROWSER_PORT,
+    browser: Annotated[
+        BrowserName,
+        typer.Option("--browser", "-b", help="Browser to launch for agent automation.", case_sensitive=False, show_choices=True),
+    ] = "chrome",
+    profile: Annotated[
+        str | None,
+        typer.Option(
+            "--profile",
+            "-r",
+            help="StackOps profile under ~/data/browsers-profiles/<browser>/<profile>. Omit for a temp profile.",
+        ),
+    ] = None,
+    lan: Annotated[bool, typer.Option("--lan", "-l", help="Expose endpoint on 0.0.0.0 through a localhost relay.")] = False,
+    detached: Annotated[bool, typer.Option("--detached", help="Launch as background processes instead of tmux windows.")] = False,
+) -> None:
+    """Launch browser automation endpoint with an isolated profile when supported."""
+    try:
+        from stackops.scripts.python.helpers.helpers_agents.agents_browser_impl import launch_browser as launch_browser_impl
+
+        result = launch_browser_impl(browser=browser, port=port, profile_name=profile, lan=lan, detached=detached)
+    except ValueError as error:
+        raise typer.BadParameter(str(error)) from error
+    except RuntimeError as error:
+        typer.echo(str(error), err=True)
+        raise typer.Exit(code=1) from error
+
+    match result:
+        case DetachedBrowserLaunchResult():
+            typer.echo(f"Launched {result.process_label}: pid={result.process_id}")
+            if result.relay_process_id is not None:
+                typer.echo(f"Relay: pid={result.relay_process_id} target=127.0.0.1:{result.browser_port}")
+        case TmuxBrowserLaunchResult():
+            typer.echo(f"Launched {result.process_label} in tmux session: {result.tmux.session_name}")
+            typer.echo(f"Browser window: {result.tmux.browser_window_name}")
+            if result.tmux.relay_window_name is not None:
+                typer.echo(f"Relay window: {result.tmux.relay_window_name} target=127.0.0.1:{result.browser_port}")
+            typer.echo(f"Attach: {' '.join(result.tmux.attach_command)}")
+    typer.echo(f"Executable: {result.browser_path}")
+    typer.echo(f"{result.endpoint_short_label}: {result.host}:{result.port}")
+    if result.profile_path is not None:
+        typer.echo(f"Profile: {result.profile_path}")
+    typer.echo(f"Prompt: {result.prompt_path}")
+    if lan:
+        typer.echo(f"{result.endpoint_short_label} is exposed on 0.0.0.0 through a relay; use this only on a trusted network.")
+    if isinstance(result, TmuxBrowserLaunchResult):
+        from stackops.scripts.python.helpers.helpers_agents.agents_browser_tmux import attach_or_switch_tmux_session
+
+        try:
+            attach_or_switch_tmux_session(session_name=result.tmux.session_name)
+        except RuntimeError as error:
+            typer.echo(str(error), err=True)
+            raise typer.Exit(code=1) from error
+
+
+def status() -> None:
+    """Show active StackOps browser tmux windows."""
+    try:
+        from rich import box
+        from rich.console import Console
+        from rich.table import Table
+
+        from stackops.scripts.python.helpers.helpers_agents.agents_browser_tmux import collect_browser_tmux_status
+
+        rows = collect_browser_tmux_status()
+    except RuntimeError as error:
+        typer.echo(str(error), err=True)
+        raise typer.Exit(code=1) from error
+
+    launch_count = len({row.metadata.launch_id for row in rows})
+    window_count = len({row.window_id for row in rows})
+    table = Table(
+        title=f"StackOps browser tmux: {launch_count} launch(es), {window_count} window(s), {len(rows)} pane(s)",
+        box=box.SIMPLE_HEAVY,
+        show_lines=False,
+    )
+    table.add_column("Session", style="cyan", overflow="fold")
+    table.add_column("Launch", overflow="fold")
+    table.add_column("Role")
+    table.add_column("Browser")
+    table.add_column("Profile", overflow="fold")
+    table.add_column("Endpoint")
+    table.add_column("Window")
+    table.add_column("Pane")
+    table.add_column("State")
+    table.add_column("PID", justify="right")
+    table.add_column("Command")
+    table.add_column("Profile Path", overflow="fold")
+    table.add_column("Prompt", overflow="fold")
+
+    for row in rows:
+        state = "dead" if row.pane_dead else "running"
+        endpoint = f"{row.metadata.host}:{row.metadata.port}"
+        if row.metadata.lan == "yes":
+            endpoint = f"{endpoint} -> 127.0.0.1:{row.metadata.browser_port}"
+        table.add_row(
+            row.session_name,
+            row.metadata.launch_id,
+            row.metadata.role,
+            row.metadata.browser,
+            row.metadata.profile,
+            endpoint,
+            f"{row.window_index}:{row.window_name}",
+            f"{row.pane_index} {row.pane_id}",
+            state,
+            row.pane_pid,
+            row.pane_current_command,
+            row.metadata.profile_path,
+            row.metadata.prompt_path,
+        )
+
+    Console().print(table)
+
+
+def get_app() -> typer.Typer:
+    browser_app = typer.Typer(help="🌐 <b> Browser automation for agent CLIs and MCP", no_args_is_help=True, add_help_option=True, add_completion=False)
+    browser_app.command(name="install-tech", no_args_is_help=False, short_help="<i> Install agent-browser, playwright-cli, or MCP configs")(install_tech)
+    browser_app.command(name="i", no_args_is_help=False, hidden=True)(install_tech)
+    browser_app.command(name="launch-browser", no_args_is_help=True, short_help="<l> Launch browser automation endpoint")(launch_browser)
+    browser_app.command(name="l", no_args_is_help=True, hidden=True)(launch_browser)
+    browser_app.command(name="status", no_args_is_help=False, short_help="<s> Show active browser tmux windows")(status)
+    browser_app.command(name="s", no_args_is_help=False, hidden=True)(status)
+    return browser_app

stackops-26.7/src/stackops/scripts/python/agents_iter.py

@@ -0,0 +1,136 @@
+from pathlib import Path
+from typing import Annotated
+
+import typer
+
+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="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 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:
+    """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
+
+        show_close_iter_workspaces_loop(
+            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
+    except RuntimeError as error:
+        typer.echo(str(error), err=True)
+        raise typer.Exit(code=1) from error
+
+
+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(), 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="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,
+    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, 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
+
+        show_track_iter_workspace_loop(
+            workspace_name=space_name,
+            max_iterations=max_iterations,
+            interval_seconds=interval_seconds,
+            retain_previous=retain_previous,
+        )
+    except ValueError as error:
+        raise typer.BadParameter(str(error)) from error
+    except RuntimeError as error:
+        typer.echo(str(error), err=True)
+        raise typer.Exit(code=1) from error
+
+
+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(retain_previous=retain_previous)
+    except RuntimeError as error:
+        typer.echo(str(error), err=True)
+        raise typer.Exit(code=1) from error
+
+
+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> 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> 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, 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 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.6 → stackops-26.7}/src/stackops/scripts/python/ai/solutions/codex/config.toml

@@ -12,6 +12,9 @@ network_access = true
 [features]
 multi_agent = true
 
+[tui]
+status_line = ["model-with-reasoning", "context-remaining", "current-dir", "model-name", "project-root", "git-branch", "context-used", "five-hour-limit"]
+
 [analytics]
 enabled = false
 

{stackops-26.6.6 → stackops-26.7}/src/stackops/scripts/python/ai/utils/generate_files.py

@@ -8,7 +8,6 @@ import typer
 
 from stackops.scripts.python.ai.utils.generate_files_content import generate_content
 from stackops.scripts.python.ai.utils.generate_files_utils import (
-    create_repo_symlinks,
     filter_files_by_content,
     filter_files_by_name,
     get_python_files,
@@ -103,20 +102,5 @@ def make_todo_files(
     console.print(Panel(success_msg, border_style="bold blue", expand=False))
 
 
-def create_symlink_command(num: Annotated[int, typer.Argument(help="Number of symlinks to create (1-5).")] = 5) -> None:
-    """Create 5 symlinks to repo_root at ~/code_copies/${repo_name}_copy_{i}."""
-    from rich.console import Console
-    from rich.panel import Panel
-
-    if num < 1 or num > 5:
-        console = Console()
-        console.print(Panel("❌ ERROR | Number of symlinks must be between 1 and 5.", border_style="bold red", expand=False))
-        raise typer.Exit(code=1)
-    repo_root = Path.cwd().absolute()
-    create_repo_symlinks(repo_root)
-    console = Console()
-    console.print(Panel(f"✅ SUCCESS | Created {num} symlinks to {repo_root} in ~/code_copies/", border_style="bold green", expand=False))
-
-
 if __name__ == "__main__":
     typer.run(make_todo_files)