stackops 26.9.1__tar.gz → 26.9.2__tar.gz

{stackops-26.9.1/src/stackops.egg-info → stackops-26.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackops
-Version: 26.9.1
+Version: 26.9.2
 Summary: Developer Stack Manager
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0

{stackops-26.9.1 → stackops-26.9.2}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stackops"
-version = "26.9.1"
+version = "26.9.2"
 description = "Developer Stack Manager"
 readme = "README.md"
 license = {text = "Apache 2.0"}

{stackops-26.9.1 → stackops-26.9.2}/src/stackops/agents/prompts/prompts.yaml

@@ -26,7 +26,7 @@ findBugsOrImprovementRoom:
     * Create the sub agents with the latest Herdr CLI: create a workspace with one clearly named tab per agent. Use the same agent harness as you unless the user specifies another, e.g. codex, pi, omp, opencode etc.
     * you wait until they all finish, then collect the results from them and pass on the final reports back to the user so they decide on what to do next.
     * Notice that so far, we didn't fix anything or improve anything, it was just anaylsis,
-    * The user then might ask you to approve the bug fix suggestions or improvements suggestions, in which case you proceed to launch sub agents, one per improvment/bug fix (exactly one), they go in a separate Herdr workspace and are launched in separate tabs, and they must be instucted with additional caveat """please fix this only if you think it is genuinely a bug/improvment space, if you disagree please leave as is, also, please take into consideration complexity and speed, if solution adds too much complexity, we skip, if solution slow down things significantly, we skip too. We are not super fussy about correctness, we are more about practicality and performance and maintainability.""". This gives us extra reassurance that first work was not hallucination because the prior agent was handling too much and missed details. The bug finding operation might have been done already and you are asked to start working on fixes, in which case the above applies.
+    * The user then might ask you to approve the bug fix suggestions or improvements suggestions, in which case you proceed to launch sub agents, one per improvment/bug fix (exactly one), they go in a separate Herdr workspace and are launched in separate tabs, and they must be instucted with additional caveat """please fix this only if you think it is genuinely a bug/improvment space, if you disagree please leave as is, also, please take into consideration complexity and speed, if solution adds too much complexity, we skip, if solution slow down things significantly, we skip too. We are not super fussy about correctness, we are more about practicality and performance and maintainability. Please write down a comment where needed that this is a design choice and we are aware of its implications or this is not strictly correct but we choose to do so for reason x and y.""". This gives us extra reassurance that first work was not hallucination because the prior agent was handling too much and missed details. The bug finding operation might have been done already and you are asked to start working on fixes, in which case the above applies.
     * When finished, please don't close the Herdr workspaces or tabs, as user might want followup questions with those agents.
   
 

{stackops-26.9.1 → stackops-26.9.2}/src/stackops/jobs/installer/checks/install_utils.py

@@ -46,6 +46,7 @@ def upload_app(path: Path) -> str | None:
             local_path=local_path,
             cloud=read_default_rclone_remote(),
             remote_path=remote_path,
+            overwrite=False,
             share=True,
             share_options=None,
             verbose=False,

{stackops-26.9.1 → stackops-26.9.2}/src/stackops/scripts/python/agents.py

@@ -51,6 +51,7 @@ _AGENTS_COMMAND_PANEL_ORDER: Final[tuple[str, ...]] = (
     "browser",
     "second-brain",
     "doctor",
+    "depoison",
     "run-prompt",
     "run-interactive",
     "ask",
@@ -498,22 +499,25 @@ def doctor(
         typer.Option(
             "--resource",
             "-r",
-            help="Comma-separated resource focuses: all, configuration, mcp, plugin, skill, or instructions.",
+            help="Comma-separated resource focuses: all, configuration, mcp, hook, plugin, skill, or instructions.",
         ),
     ] = "all",
 ) -> None:
-    """Inspect agent binaries, configuration, plugins, skills, and instruction provenance."""
+    """Inspect agent binaries, configuration, hooks, plugins, skills, and instruction provenance."""
     from stackops.scripts.python.helpers.helpers_agents.agents_doctor.command import run_doctor
 
     working_directory = directory if directory is not None else Path.cwd()
     try:
-        run_doctor(requested_agent=agent, working_directory=working_directory, requested_resources=resource)
+        complete = run_doctor(requested_agent=agent, working_directory=working_directory, requested_resources=resource)
     except ValueError as error:
         raise typer.BadParameter(str(error)) from error
+    if not complete:
+        raise typer.Exit(code=1)
 
 
 def get_app() -> typer.Typer:
     from stackops.scripts.python.agents_browser import get_app as get_browser_app
+    from stackops.scripts.python.agents_depoison import depoison
     from stackops.scripts.python.agents_iter import get_app as get_iter_app
     from stackops.scripts.python.agents_parallel import get_app as get_parallel_app
     from stackops.scripts.python.agents_second_brain import get_app as get_second_brain_app
@@ -554,6 +558,7 @@ def get_app() -> typer.Typer:
     agents_app.command(name="C", no_args_is_help=False, hidden=True)(clean)
     agents_app.command(name="doctor", no_args_is_help=False, short_help="<d> Inspect agent health and resource provenance")(doctor)
     agents_app.command(name="d", no_args_is_help=False, hidden=True)(doctor)
+    agents_app.command(name="depoison", no_args_is_help=False, short_help="Preview or reset agent customizations")(depoison)
 
     agents_app.command(name="run-prompt", no_args_is_help=False, short_help="<r> Run one prompt via selected agent")(run_prompt)
     agents_app.command(name="r", no_args_is_help=False, hidden=True)(run_prompt)

stackops-26.9.2/src/stackops/scripts/python/agents_depoison.py

@@ -0,0 +1,105 @@
+import subprocess
+import sys
+from pathlib import Path
+from typing import Annotated
+
+import typer
+
+from stackops.scripts.python.helpers.helpers_agents.agents_doctor.cleanup_models import CleanupScope
+
+
+def depoison(
+    agent: Annotated[str, typer.Argument(help="Agent to reset, or all.")] = "all",
+    directory: Annotated[Path | None, typer.Option("--directory", "-d", exists=True, file_okay=False, help="Inspect this project directory.")] = None,
+    scope: Annotated[CleanupScope, typer.Option("--scope", "-s", help="Select local, global, or all configuration.")] = "all",
+    resource: Annotated[str, typer.Option("--resource", "-r", help="Comma-separated resources: all, hook, plugin, mcp, skill, instructions, configuration.")] = "all",
+    match: Annotated[str | None, typer.Option("--match", "-m", help="Select resources by name, command, or source path substring.")] = None,
+    apply: Annotated[bool, typer.Option("--apply", "-a", help="Apply the displayed reset and keep original files in quarantine.")] = False,
+) -> None:
+    """Preview or reset hooks, plugins, MCP servers, skills, instructions, and configuration."""
+    from stackops.utils.meta import lambda_to_python_script
+
+    worker_source = lambda_to_python_script(
+        lambda: _run_depoison(
+            agent=agent,
+            directory=str(directory if directory is not None else Path.cwd()),
+            scope=scope,
+            resource=resource,
+            match=match,
+            apply=apply,
+        ),
+        in_global=True,
+        import_module=False,
+    )
+    result = subprocess.run(
+        ["uv", "run", "--no-project", "--python", sys.executable, "--with", "tomlkit", "python", "-c", worker_source],
+        check=False,
+    )
+    raise typer.Exit(code=result.returncode)
+
+
+def _run_depoison(*, agent: str, directory: str, scope: CleanupScope, resource: str, match: str | None, apply: bool) -> None:
+    from pathlib import Path
+
+    import typer
+
+    from stackops.scripts.python.helpers.helpers_agents.agents_doctor.cleanup_apply import apply_cleanup_plan
+    from stackops.scripts.python.helpers.helpers_agents.agents_doctor.cleanup_plan import build_cleanup_plan
+    from stackops.scripts.python.helpers.helpers_agents.agents_doctor.cleanup_resources import collect_cleanup_resources
+    from stackops.scripts.python.helpers.helpers_agents.agents_doctor.command import resolve_resource_focuses
+    from stackops.scripts.python.helpers.helpers_agents.agents_doctor.hooks.discovery import collect_hooks
+    from stackops.scripts.python.helpers.helpers_agents.agents_doctor.hooks.models import HookInventory
+    from stackops.scripts.python.helpers.helpers_agents.agents_doctor.registry import resolve_doctor_definitions
+    from stackops.scripts.python.helpers.helpers_agents.agents_doctor.scanning import create_doctor_context
+
+    try:
+        context = create_doctor_context(working_directory=Path(directory))
+        definitions = resolve_doctor_definitions(requested_agent=agent)
+        focuses = resolve_resource_focuses(requested_resources=resource)
+        inventories: list[HookInventory] = []
+        for definition in definitions:
+            if "all" in focuses or "hook" in focuses:
+                inventories.append(collect_hooks(agent=definition.agent, context=context))
+            if focuses != ("hook",):
+                inventories.append(collect_cleanup_resources(agent=definition.agent, context=context, resource_focuses=focuses))
+        inventory = HookInventory(
+            entries=tuple(entry for item in inventories for entry in item.entries),
+            diagnostics=tuple(diagnostic for item in inventories for diagnostic in item.diagnostics),
+        )
+        plan = build_cleanup_plan(inventory=inventory, scope=scope, match=match, home_directory=context.home_directory)
+        typer.echo(f"{'Apply' if apply else 'Preview'}: {len(plan.entries)} resource(s), {len(plan.changes)} path(s).")
+        for entry in plan.entries:
+            action = "read-only" if entry.removal is None else entry.removal.action
+            typer.echo(f"  {entry.agent} {entry.origin}: {entry.name} — {action} — {entry.path}")
+            if entry.command:
+                typer.echo(f"    {entry.command}")
+        for change in plan.changes:
+            action = "quarantine" if change.replacement is None else "edit configuration"
+            typer.echo(f"  Will {action}: {change.snapshot.path}")
+        for diagnostic in inventory.diagnostics:
+            if scope != "all" and diagnostic.origin != scope:
+                continue
+            if diagnostic.severity == "notice":
+                typer.echo(f"Notice: {diagnostic.path}: {diagnostic.message}")
+            elif f"{diagnostic.path}: {diagnostic.message}" not in plan.blockers:
+                typer.echo(f"Inspection error covered by whole-source reset: {diagnostic.path}: {diagnostic.message}")
+        for blocker in plan.blockers:
+            typer.echo(f"Blocked: {blocker}", err=True)
+        if plan.blockers:
+            raise SystemExit(1)
+        if not apply:
+            typer.echo("Preview only. Add --apply to perform this reset and preserve backups.")
+            raise SystemExit(0)
+        result = apply_cleanup_plan(
+            plan=plan,
+            backup_root=context.home_directory / ".local" / "state" / "stackops" / "depoison",
+            home_directory=context.home_directory,
+        )
+        typer.echo(f"Reset {len(result.changed_paths)} path(s).")
+        if result.backup_directory is not None:
+            typer.echo(f"Originals and restore manifest: {result.backup_directory}")
+        if result.changed_paths:
+            typer.echo("Restart the agent to load the reset configuration.")
+    except (OSError, ValueError) as error:
+        typer.echo(f"""Error: {error}""", err=True)
+        raise SystemExit(2) from error