@rubytech/create-maxy-code 0.1.108 → 0.1.109

package/payload/platform/plugins/cloudflare/scripts/_stream-log.sh

@@ -1,154 +0,0 @@
-#!/usr/bin/env bash
-# Shared stream-log helpers sourced by setup-tunnel.sh and reset-tunnel.sh.
-#
-# The platform exposes STREAM_LOG_PATH in the `claude` spawn env;
-# the Bash-tool subprocess inherits it, and opt-in scripts call these
-# helpers to emit phase lines and tee subprocess output into the same
-# per-conversation file the chat UI's server-side tailer reads.
-#
-# Contract (read by platform/ui/app/lib/script-stream-tailer.ts tailer and
-# .docs/web-chat.md):
-#   [<ISO-ts>] [script:<scope>] <kv …>
-#   [<ISO-ts>] [script:<scope>:<subprocess-tag>] <raw line>
-# Canonical regex — SCRIPT_STREAM_RE at platform/ui/app/lib/script-stream-tailer.ts:
-#   ^\[([^\]]+)\] \[script:([a-z][a-z0-9-]*)((?::[a-z0-9:_-]+)?)\] (.*)$
-# The literal `script:` prefix is the chat-surface namespace. It
-# separates chat-surface emitters from log-file-only scopes (`[mcp:<server>]`
-# from mcp-stderr-tee, `[init]` / `[api-wait-*]` / `[mcp-init-error]` /
-# `[subproc-stderr]` / `[compaction-*]` from claude-agent.ts) which share
-# the same per-conversation stream log but must NOT reach the chat UI.
-# Callers of phase_line / tee_subprocess / tee_subprocess_capture pass the
-# bare scope (e.g. `setup-tunnel`, `list-cf-domains`, `reset-tunnel:cloudflared`);
-# these helpers prepend `script:` to the stream-log write. Stderr mirrors
-# stay unprefixed — stderr is for direct-SSH operators and route-handler
-# `reason=<enum>` regex, not the chat-surface contract.
-# <scope> is any `[a-z][a-z0-9-]*` token
-# pre-592 enum `setup-tunnel|reset-tunnel`, which silently filtered out the
-# `[list-cf-domains]` lines). <subprocess-tag> may contain
-# lowercase, digits, `-`, `_`, `:`. Adding a new chat-surface scope requires
-# no edit to the regex — the shape is the only contract. Any prefix-shape
-# change must be made on both sides (this helper + script-stream-tailer.ts)
-# atomically.
-#
-# Inner layers (e.g. a node/python helper a.sh wrapper spawns — the
-# `list-cf-domains.sh` → `list-cf-domains.ts` pattern) must write phase lines
-# directly to STREAM_LOG_PATH with the same prefix shape (including the
-# `script:` namespace): stderr alone is silently discarded by runFormSpawn on
-# exit 0. The build-gate `platform/ui/scripts/check-stream-log-contract.mjs`
-# enforces this by rejecting any.sh under `platform/plugins/*/scripts/`
-# that sources this helper and invokes an interpreter subprocess whose target
-# does not pair a STREAM_LOG_PATH env read with an append/write call. Opt out
-# per invocation with `# stream-log-contract: stderr-only (reason: <prose>)`.
-
-# Exit 1 loudly with the variable name and the invoking scope so direct-SSH
-# invocations fail fast and the operator reads exactly what to set. No
-# silent fallback — criterion 4 of.
-require_stream_log_path() {
-  local scope="$1"
-  if [ -z "${STREAM_LOG_PATH:-}" ]; then
-    echo "ERROR [${scope}]: STREAM_LOG_PATH environment variable is unset." >&2
-    echo "       This script tees subprocess output into a per-conversation" >&2
-    echo "       stream log; it is meaningless without a target path." >&2
-    echo "       The platform sets STREAM_LOG_PATH automatically for every" >&2
-    echo "       \`claude\` spawn. If you are invoking this" >&2
-    echo "       script by hand, export it yourself, for example:" >&2
-    echo "           export STREAM_LOG_PATH=\"\${HOME}/.maxy/logs/manual-invocation.log\"" >&2
-    exit 1
-  fi
-  mkdir -p "$(dirname "${STREAM_LOG_PATH}")"
-}
-
-# ISO-8601 UTC timestamp with millisecond precision.
-stream_log_ts() {
-  date -u +"%Y-%m-%dT%H:%M:%S.%3NZ"
-}
-
-# Append one phase line to STREAM_LOG_PATH AND echo to stderr so the Bash
-# tool's stderr capture carries it. Both paths matter: the stream log is
-# the live tailer surface; stderr is the exit-time Bash-tool surface.
-#
-# The stream-log write carries the `script:` chat-surface namespace;
-# the stderr mirror stays unprefixed because stderr is read by direct-SSH
-# operators and the route-handler `reason=<enum>` regex, not the chat UI.
-#
-# Usage: phase_line <scope> <key=value …>
-phase_line() {
-  local scope="$1"; shift
-  local ts
-  ts="$(stream_log_ts)"
-  printf '[%s] [script:%s] %s\n' "${ts}" "${scope}" "$*" >> "${STREAM_LOG_PATH}"
-  printf '[%s] %s\n' "${scope}" "$*" >&2
-}
-
-# Tee a subprocess's combined stdout+stderr into STREAM_LOG_PATH line-by-line
-# with the given tag, mirroring each line to stderr for the Bash tool.
-# Returns the subprocess's exit code.
-#
-# Use for fire-and-forget subprocesses whose stdout does NOT need to be
-# captured by the caller (the caller only cares about the exit code).
-# For subprocesses whose stdout the caller must parse (e.g. JSON output
-# feeding `jq`), use `tee_subprocess_capture` instead.
-#
-# Usage: tee_subprocess <tag> -- <cmd> <args …>
-# Example: tee_subprocess reset-tunnel:cloudflared -- cloudflared --origincert … tunnel delete my-tunnel
-#
-# stdbuf forces line buffering; without it cloudflared holds its stdout in
-# libc's 8 KB buffer until exit and the ≤ 1 s latency criterion fails.
-tee_subprocess() {
-  local tag="$1"; shift
-  if [ "${1:-}" != "--" ]; then
-    echo "tee_subprocess: expected -- before command" >&2
-    return 2
-  fi
-  shift
-  # Prefer `stdbuf -oL -eL` to force line buffering on the subprocess; fall
-  # back to the bare command when stdbuf is unavailable (macOS dev). On the
-  # Pi (Linux), stdbuf is present via coreutils and cloudflared's output
-  # reaches the tee as soon as each line is written.
-  local -a buf_prefix=()
-  if command -v stdbuf >/dev/null 2>&1; then
-    buf_prefix=(stdbuf -oL -eL)
-  fi
-  "${buf_prefix[@]}" "$@" 2>&1 | while IFS= read -r line; do
-    local ts
-    ts="$(stream_log_ts)"
-    printf '[%s] [script:%s] %s\n' "${ts}" "${tag}" "${line}" >> "${STREAM_LOG_PATH}"
-    printf '%s\n' "${line}" >&2
-  done
-  return "${PIPESTATUS[0]}"
-}
-
-# Tee a subprocess's combined stdout+stderr into STREAM_LOG_PATH line-by-line
-# with the given tag, passing each line through on stdout so the caller can
-# capture it with `> file` or `$( … )`. Stderr mirroring is dropped so the
-# caller's stdout is exactly the subprocess's output — `jq` and friends
-# remain parseable.
-#
-# Usage: tee_subprocess_capture <tag> -- <cmd> <args …> > captured.file
-# Example:
-#   tee_subprocess_capture reset-tunnel:cloudflared -- \
-#     cloudflared --origincert "${CERT}" tunnel list --output json \
-#     > "${NAMES_TMP}"
-tee_subprocess_capture() {
-  local tag="$1"; shift
-  if [ "${1:-}" != "--" ]; then
-    echo "tee_subprocess_capture: expected -- before command" >&2
-    return 2
-  fi
-  shift
-  # Prefer `stdbuf -oL -eL` to force line buffering on the subprocess; fall
-  # back to the bare command when stdbuf is unavailable (macOS dev). On the
-  # Pi (Linux), stdbuf is present via coreutils and cloudflared's output
-  # reaches the tee as soon as each line is written.
-  local -a buf_prefix=()
-  if command -v stdbuf >/dev/null 2>&1; then
-    buf_prefix=(stdbuf -oL -eL)
-  fi
-  "${buf_prefix[@]}" "$@" 2>&1 | while IFS= read -r line; do
-    local ts
-    ts="$(stream_log_ts)"
-    printf '[%s] [script:%s] %s\n' "${ts}" "${tag}" "${line}" >> "${STREAM_LOG_PATH}"
-    printf '%s\n' "${line}"
-  done
-  return "${PIPESTATUS[0]}"
-}