@aerovato/operator-helper 1.5.0 → 1.6.1

package/dist/code-puppy/register_callbacks.py

@@ -43,33 +43,31 @@ except ImportError:
         CustomCommandResult = None
 
 _RENDER_TIMEOUT_SECONDS = 30
-_COMMAND_TIMEOUT_SECONDS = 60
 _render_tasks: dict[str, asyncio.Task[str]] = {}
 _update_launched = False
 
 _COMMANDS = {
     "operator:user-init": (
         "Initialize Operator User Instructions",
-        ("user init", "user guide"),
-        "Follow the instructions in the guide output above.",
+        "user init",
+        "Follow the User Setup guide in its output, including when initialization reports failures.",
     ),
     "operator:project-init": (
         "Initialize Operator Project",
-        ("project init", "project guide"),
-        "Follow the instructions in the guide output above.",
+        "project init",
+        "Follow the Project Setup guide in its output, including when initialization reports failures.",
     ),
     "operator:index": (
         "Build or refresh the Operator Project Index",
-        ("index status", "index guide"),
-        "Follow the instructions in the guide output above.",
+        "index init",
+        "Follow the Project Index Setup guide in its output, including when inspection reports failures.",
     ),
     "operator:repair": (
         "Repair Operator",
-        ("memory check",),
-        "If the output says `No issues detected.`, no action is needed and you may stop. "
-        "Otherwise, repair only the reported Operator memory issues; do not initialize "
-        "uninitialized partitions. Rerun `operator-helper memory check` until it succeeds, "
-        "then read the applicable Operator memory before continuing.",
+        "memory check",
+        "If no issues are detected, stop. Otherwise, repair only the reported load "
+        "failures without initializing absent partitions. Rerun `operator-helper memory "
+        "check` to confirm the repair, then read the applicable Operator memory documents.",
     ),
 }
 
@@ -145,8 +143,6 @@ async def _get_preamble(conversation_key: str) -> str:
 
 
 async def _render_preamble(conversation_key: str) -> str:
-    environment = os.environ.copy()
-    environment["OPERATOR_HELPER_SKIP_UPDATE"] = "1"
     process: asyncio.subprocess.Process | None = None
     try:
         process = await asyncio.create_subprocess_exec(
@@ -154,7 +150,6 @@ async def _render_preamble(conversation_key: str) -> str:
             "preamble",
             stdout=asyncio.subprocess.PIPE,
             stderr=asyncio.subprocess.PIPE,
-            env=environment,
         )
         stdout, stderr = await asyncio.wait_for(
             process.communicate(), timeout=_RENDER_TIMEOUT_SECONDS
@@ -284,62 +279,24 @@ def _custom_command(_command: str, name: str) -> CustomCommandResult | None:
     if definition is None:
         return None
 
-    version = _run_helper(("version",))
-    if version[0] != 0:
-        diagnostic = (
-            "Operator Helper is unavailable. Help the user repair the missing "
-            "operator-helper command (npm: @aerovato/operator-helper). Validate the "
-            f"repair by rerunning `operator-helper version`. Once it succeeds, ask the "
-            f"user to rerun `/{name}`."
-        )
-        content = "\n\n".join(
-            (
-                _command_output("operator-helper version 2>&1", version[1]),
-                _tag("operator-diagnostic", diagnostic),
-            )
-        )
-        return CustomCommandResult(content)
-
-    _, operations, instructions = definition
-    outputs = []
-    for operation in operations:
-        arguments = tuple(operation.split())
-        result = _run_helper(arguments)
-        outputs.append(_command_output(f"operator-helper {operation} 2>&1", result[1]))
-    outputs.append(_tag("operator-instructions", instructions))
-    return CustomCommandResult("\n\n".join(outputs))
-
-
-def _run_helper(arguments: tuple[str, ...]) -> tuple[int, str]:
-    try:
-        result = subprocess.run(
-            ("operator-helper", *arguments),
-            stdout=subprocess.PIPE,
-            stderr=subprocess.STDOUT,
-            text=True,
-            timeout=_COMMAND_TIMEOUT_SECONDS,
-            check=False,
-        )
-        return result.returncode, _remove_process_newline(result.stdout)
-    except (OSError, subprocess.TimeoutExpired) as error:
-        return 1, str(error)
-
-
-def _command_output(command: str, output: str) -> str:
-    return (
-        "<operator-command>\n"
-        f"<command>{command}</command>\n"
-        "<output>\n"
-        f"{output}\n"
-        "</output>\n"
-        "</operator-command>"
+    description, operation, instructions = definition
+    return CustomCommandResult(
+        f"# {description}\n\n"
+        "1. Run `operator-helper version`. If an update is available, run "
+        "`operator-helper upgrade` before continuing.\n"
+        f"2. Run `operator-helper {operation}`. {instructions}\n\n"
+        "## Recovery\n\n"
+        "- If Helper cannot start, install or repair the npm package "
+        "`@aerovato/operator-helper` globally and retry the failed command.\n"
+        "- If the version check or upgrade fails, diagnose the error and retry.\n"
+        f"- If `operator-helper {operation}` reports a failure, use its output to "
+        "resolve it and rerun it as needed.\n"
+        "- If you cannot resolve a problem, report the blocker.\n\n"
+        "Use Helper output as working context. Do not reproduce it wholesale or "
+        "reimplement Helper logic."
     )
 
 
-def _tag(name: str, content: str) -> str:
-    return f"<{name}>\n{content}\n</{name}>"
-
-
 def _custom_command_help() -> list[tuple[str, str]]:
     return [(name, definition[0]) for name, definition in _COMMANDS.items()]