claude-dev-env 8.14.0 → 8.15.1

package/scripts/dev_env_scripts_constants/claude_account_worker_constants.py

@@ -0,0 +1,139 @@
+"""Named values for the second-account Claude worker."""
+
+from __future__ import annotations
+
+from dev_env_scripts_constants.claude_account_constants import (
+    CHOICE_MAIN,
+    CHOICE_SECOND,
+    CHOICE_WAIT,
+    CREDENTIALS_FILE_NAME,
+    JSON_ACCOUNT_KEY,
+    JSON_CONFIG_DIRECTORY_KEY,
+    JSON_REASON_KEY,
+    MAIN_CLAUDE_HOME_DIRECTORY_NAME,
+)
+from dev_env_scripts_constants.shared_tree_constants import CLAUDE_CONFIG_DIR_ENV_VAR
+
+CLAUDE_BINARY_NAME: str = "claude"
+
+DEFAULT_PERMISSION_MODE: str = "auto"
+
+DEFAULT_TIMEOUT_MINUTES: int = 60
+
+MINIMUM_TIMEOUT_MINUTES: int = 1
+
+WAIT_EXIT_CODE: int = 3
+
+TIMEOUT_EXIT_CODE: int = 124
+
+MISSING_BINARY_EXIT_CODE: int = 127
+
+LAUNCH_FAILURE_EXIT_CODE: int = 1
+
+WAIT_DURATION_SECONDS: float = 0.0
+
+STDOUT_TAIL_CHARACTER_LIMIT: int = 4000
+
+DRAIN_GRACE_TIMEOUT_SECONDS: int = 10
+
+DRAIN_ATTEMPT_LIMIT: int = 2
+
+DURATION_DECIMAL_PLACES: int = 3
+
+REPORT_INDENT: int = 2
+
+UTF8_ENCODING: str = "utf-8"
+
+UTF8_DECODE_ERRORS: str = "replace"
+
+CLI_DESCRIPTION: str = "Run one Claude worker using the account picker."
+
+PROMPT_FILE_FLAG: str = "--prompt-file"
+
+CWD_FLAG: str = "--cwd"
+
+REPORT_FILE_FLAG: str = "--report-file"
+
+MODEL_FLAG: str = "--model"
+
+PERMISSION_MODE_FLAG: str = "--permission-mode"
+
+TIMEOUT_MINUTES_FLAG: str = "--timeout-minutes"
+
+OUTPUT_FORMAT_FLAG: str = "--output-format"
+
+OUTPUT_FORMAT_JSON: str = "json"
+
+SINGLE_PROMPT_FLAG: str = "-p"
+
+SECONDS_PER_MINUTE: int = 60
+
+JSON_RESULT_KEY: str = "result"
+
+JSON_IS_ERROR_KEY: str = "is_error"
+
+REPORT_ACCOUNT_KEY: str = JSON_ACCOUNT_KEY
+
+REPORT_REASON_KEY: str = JSON_REASON_KEY
+
+REPORT_EXIT_CODE_KEY: str = "exit_code"
+
+REPORT_DURATION_SECONDS_KEY: str = "duration_seconds"
+
+REPORT_RESULT_KEY: str = JSON_RESULT_KEY
+
+REPORT_IS_ERROR_KEY: str = JSON_IS_ERROR_KEY
+
+SUMMARY_LINE_TEMPLATE: str = "account={account} exit_code={exit_code} report={report_file}"
+
+INVALID_TIMEOUT_MESSAGE: str = "--timeout-minutes must be at least 1"
+
+
+__all__ = [
+    "CHOICE_MAIN",
+    "CHOICE_SECOND",
+    "CHOICE_WAIT",
+    "CLAUDE_BINARY_NAME",
+    "CLAUDE_CONFIG_DIR_ENV_VAR",
+    "CLI_DESCRIPTION",
+    "CREDENTIALS_FILE_NAME",
+    "CWD_FLAG",
+    "DEFAULT_PERMISSION_MODE",
+    "DEFAULT_TIMEOUT_MINUTES",
+    "DRAIN_ATTEMPT_LIMIT",
+    "DRAIN_GRACE_TIMEOUT_SECONDS",
+    "DURATION_DECIMAL_PLACES",
+    "INVALID_TIMEOUT_MESSAGE",
+    "JSON_ACCOUNT_KEY",
+    "JSON_CONFIG_DIRECTORY_KEY",
+    "JSON_IS_ERROR_KEY",
+    "JSON_REASON_KEY",
+    "JSON_RESULT_KEY",
+    "LAUNCH_FAILURE_EXIT_CODE",
+    "MAIN_CLAUDE_HOME_DIRECTORY_NAME",
+    "MISSING_BINARY_EXIT_CODE",
+    "MINIMUM_TIMEOUT_MINUTES",
+    "MODEL_FLAG",
+    "OUTPUT_FORMAT_FLAG",
+    "OUTPUT_FORMAT_JSON",
+    "PERMISSION_MODE_FLAG",
+    "PROMPT_FILE_FLAG",
+    "REPORT_ACCOUNT_KEY",
+    "REPORT_DURATION_SECONDS_KEY",
+    "REPORT_EXIT_CODE_KEY",
+    "REPORT_FILE_FLAG",
+    "REPORT_INDENT",
+    "REPORT_IS_ERROR_KEY",
+    "REPORT_REASON_KEY",
+    "REPORT_RESULT_KEY",
+    "SECONDS_PER_MINUTE",
+    "SINGLE_PROMPT_FLAG",
+    "STDOUT_TAIL_CHARACTER_LIMIT",
+    "SUMMARY_LINE_TEMPLATE",
+    "TIMEOUT_EXIT_CODE",
+    "TIMEOUT_MINUTES_FLAG",
+    "UTF8_DECODE_ERRORS",
+    "UTF8_ENCODING",
+    "WAIT_DURATION_SECONDS",
+    "WAIT_EXIT_CODE",
+]

package/scripts/dev_env_scripts_constants/grok_worker_constants.py

@@ -616,9 +616,15 @@ ADVISOR_CLI_RESUME_FLAG: str = "--resume"
 ADVISOR_BIND_PROMPT_TEMPLATE: str = (
     "You are the unique worker advisor for role {role_name}. "
     "Answer only. Open with exactly one of: ENDORSE | CORRECTION | PLAN | STOP. "
-    "Pre-dispatch: ENDORSE this worker assignment if safe, else CORRECTION."
+    "Pre-dispatch consult: the full worker assignment follows. "
+    "Hunt for missing requirements, wrong assumptions, unsafe actions, and unclear "
+    "completion criteria. ENDORSE when the worker can start as written; "
+    "otherwise open with CORRECTION, PLAN, or STOP and name the fix.\n"
+    "(Advisor: please keep your guidance under 80 words, I need a focused "
+    "starting point.)\n\n"
+    "Worker assignment:\n{assignment_text}"
 )
-"""Prompt body used for the pre-dispatch advisor bind."""
+"""Prompt body for the pre-dispatch advisor consult; carries the assembled worker prompt."""
 
 ADVISOR_VERDICT_PROMPT_TEMPLATE: str = (
     "You are the unique worker advisor for role {role_name}, session {session_id}. "

package/scripts/grok_headless_runner.py

@@ -73,6 +73,7 @@ from dev_env_scripts_constants.grok_worker_constants import (
 )
 from shared_tree_paths import resolve_shared_process_tree_scripts_directory
 from grok_worker_preflight import poteto_mode_skill_path
+from subprocess_stream_text import decode_stream_text
 
 _shared_process_tree_scripts_directory = resolve_shared_process_tree_scripts_directory(
     __file__,
@@ -200,11 +201,7 @@ def _classify_completion(
 
 
 def _normalize_stream(stream_payload: str | bytes | None) -> str:
-    if stream_payload is None:
-        return ""
-    if isinstance(stream_payload, bytes):
-        return stream_payload.decode(UTF8_ENCODING, errors=UTF8_DECODE_ERRORS)
-    return stream_payload
+    return decode_stream_text(stream_payload, encoding=UTF8_ENCODING, errors=UTF8_DECODE_ERRORS)
 
 
 def _resolve_returncode(process: subprocess.Popen[str]) -> int:

package/scripts/policy_lint/config/constants.py

@@ -7,6 +7,7 @@ UTF8_ENCODING = "utf-8"
 PATH_SEPARATOR = "/"
 ARCHIVED_SKILLS_DIRECTORY_NAME = "skill-archive"
 ARCHIVED_HOOKS_DIRECTORY_NAME = "hooks-archived"
+ARCHIVED_AUDIT_RUBRICS_DIRECTORY_NAME = "audit-rubrics-archived"
 NUL_BYTE = b"\0"
 ALL_GIT_ROOT_ARGUMENTS = ("rev-parse", "--show-toplevel")
 ALL_GIT_HEAD_ARGUMENTS = ("rev-parse", "--verify", "HEAD")

package/scripts/policy_lint/engine.py

@@ -4,6 +4,7 @@ from collections.abc import Iterable, Sequence
 from pathlib import Path, PurePosixPath
 
 from .config.constants import (
+    ARCHIVED_AUDIT_RUBRICS_DIRECTORY_NAME,
     ARCHIVED_HOOKS_DIRECTORY_NAME,
     ARCHIVED_SKILLS_DIRECTORY_NAME,
 )
@@ -30,7 +31,8 @@ def lint(
     """Run the selected rules on one source selection.
 
     Repository and diff selections check active code. File and editor
-    selections include archived skills and archived hooks.
+    selections include archived skills, archived hooks, and archived
+    audit rubrics.
 
     Args:
         request: Repository root, source, and rule sets.
@@ -61,6 +63,7 @@ def _is_runtime_path(path: PurePosixPath) -> bool:
     return (
         path.parts[0] != ARCHIVED_SKILLS_DIRECTORY_NAME
         and ARCHIVED_HOOKS_DIRECTORY_NAME not in path.parts
+        and ARCHIVED_AUDIT_RUBRICS_DIRECTORY_NAME not in path.parts
     )
 
 
@@ -252,7 +255,7 @@ def _scoped_diagnostics(
     all_diagnostics: Iterable[Diagnostic],
     document: Document,
 ) -> tuple[Diagnostic, ...]:
-    if document.changed_lines is None or not document.changed_lines:
+    if document.changed_lines is None:
         return tuple(all_diagnostics)
     return tuple(
         each_diagnostic

package/scripts/repository_checks/config/constants.py

@@ -118,7 +118,7 @@ ALL_TRACKED_SECRET_EXACT_EXEMPTIONS: frozenset[tuple[str, str, str]] = frozenset
             "f9e409c5c16ecfdd5883da4f3ad045b4af5677740c9e703ad2d47ba231718350",
         ),
         (
-            "packages/claude-dev-env/audit-rubrics/prompts/category-n-test-name-scenario-verifier.md",
+            "packages/claude-dev-env/audit-rubrics-archived/prompts/category-n-test-name-scenario-verifier.md",
             "home-path",
             "6b98ff7f0398f06452f19c4a93f3d69186401dab40aaa7077b394ef59b3e730e",
         ),

package/scripts/spawn_grok_batch.py

@@ -290,6 +290,7 @@ def bind_unique_worker_advisor(
     *,
     advisor_spec: AdvisorSpec,
     role_name: str,
+    assignment_text: str,
     all_used_session_ids: set[str],
 ) -> tuple[str, str]:
     """Bind one unique advisor session for a worker; refuse duplicates and sentinels.
@@ -303,6 +304,7 @@ def bind_unique_worker_advisor(
     Args:
         advisor_spec: Lead-supplied launcher/model/effort.
         role_name: Worker role used in the bind prompt.
+        assignment_text: Assembled worker prompt the advisor reviews before dispatch.
         all_used_session_ids: Sessions already issued in this batch.
 
     Returns:
@@ -317,7 +319,9 @@ def bind_unique_worker_advisor(
         )
     if advisor_spec.launcher == PENDING_BIND_SENTINEL:
         raise ValueError(f"advisor.launcher is {PENDING_BIND_SENTINEL}")
-    prompt_text = ADVISOR_BIND_PROMPT_TEMPLATE.format(role_name=role_name)
+    prompt_text = ADVISOR_BIND_PROMPT_TEMPLATE.format(
+        role_name=role_name, assignment_text=assignment_text
+    )
     session_id, advisor_body_text, returncode = batch_invoke_advisor(
         launcher=advisor_spec.launcher,
         model=advisor_spec.model,
@@ -898,6 +902,7 @@ def _bind_worker_advisor_session(
     *,
     advisor_spec: AdvisorSpec,
     role_name: str,
+    assignment_text: str,
     all_used_session_ids: set[str],
     session_id_lock: object | None,
 ) -> tuple[str, str]:
@@ -906,11 +911,13 @@ def _bind_worker_advisor_session(
             return bind_unique_worker_advisor(
                 advisor_spec=advisor_spec,
                 role_name=role_name,
+                assignment_text=assignment_text,
                 all_used_session_ids=all_used_session_ids,
             )
     return bind_unique_worker_advisor(
         advisor_spec=advisor_spec,
         role_name=role_name,
+        assignment_text=assignment_text,
         all_used_session_ids=all_used_session_ids,
     )
 
@@ -990,6 +997,10 @@ def _maybe_bind_advisor_for_worker(
     advisor_session_id, pre_signal = _bind_worker_advisor_session(
         advisor_spec=advisor_spec,
         role_name=worker_spec.role_name,
+        assignment_text=assemble_worker_prompt(
+            all_prompt_part_paths=worker_spec.all_prompt_part_paths,
+            tool_profile=worker_spec.tool_profile,
+        ),
         all_used_session_ids=used_ids,
         session_id_lock=session_id_lock,
     )

package/scripts/subprocess_stream_text.py

@@ -0,0 +1,28 @@
+"""Decode a subprocess stream text payload captured in text or bytes mode."""
+
+from __future__ import annotations
+
+
+def decode_stream_text(
+    stream_payload: str | bytes | None,
+    *,
+    encoding: str,
+    errors: str,
+) -> str:
+    """Decode a captured subprocess stream text payload, whichever mode captured it.
+
+    Args:
+        stream_payload: The captured stream content, or None when nothing
+            was captured.
+        encoding: The text encoding to use when the payload is bytes.
+        errors: The decode error handler to use when the payload is bytes.
+
+    Returns:
+        The decoded text, an empty string when stream_payload is None, or
+        stream_payload unchanged when it is already text.
+    """
+    if stream_payload is None:
+        return ""
+    if isinstance(stream_payload, bytes):
+        return stream_payload.decode(encoding, errors=errors)
+    return stream_payload