@beyondwork/docx-react-component 1.0.0

package/scripts/wave-watch.sh

@@ -0,0 +1,231 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+
+lane="${WAVE_LANE:-main}"
+wave=""
+agent=""
+run_id=""
+dry_run="0"
+mode="follow"
+refresh_ms="${WAVE_STATUS_REFRESH_MS:-300000}"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  scripts/wave-watch.sh [--lane <lane>] [--wave <n>] [--agent <id>] [--run <id>] [--dry-run] [--refresh-ms <n>] [--follow|--until-change]
+
+Exit codes:
+  0   completed
+  20  input required
+  30  watched signal changed while the wave remained active
+  40  failed
+EOF
+}
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --lane)
+      lane="${2:-}"
+      shift 2
+      ;;
+    --wave)
+      wave="${2:-}"
+      shift 2
+      ;;
+    --agent)
+      agent="${2:-}"
+      shift 2
+      ;;
+    --run)
+      run_id="${2:-}"
+      shift 2
+      ;;
+    --dry-run)
+      dry_run="1"
+      shift
+      ;;
+    --refresh-ms)
+      refresh_ms="${2:-}"
+      shift 2
+      ;;
+    --follow)
+      mode="follow"
+      shift
+      ;;
+    --until-change)
+      mode="until-change"
+      shift
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+done
+
+status_script="$SCRIPT_DIR/wave-status.sh"
+base_args=(--lane "$lane")
+if [ -n "$agent" ]; then
+  base_args+=(--agent "$agent")
+fi
+if [ -n "$run_id" ]; then
+  base_args+=(--run "$run_id")
+fi
+if [ "$dry_run" = "1" ]; then
+  base_args+=(--dry-run)
+fi
+
+extract_field() {
+  local payload="$1"
+  local field="$2"
+  PAYLOAD="$payload" node - "$agent" "$field" <<'NODE'
+const agentId = String(process.argv[2] || "").trim();
+const field = String(process.argv[3] || "").trim();
+const payload = JSON.parse(process.env.PAYLOAD || "{}");
+const signals = payload?.signals || {};
+const snapshot = agentId
+  ? (Array.isArray(signals.agents) ? signals.agents.find((entry) => entry.agentId === agentId) : null)
+  : signals.wave;
+const value = snapshot?.[field];
+process.stdout.write(value === undefined || value === null ? "" : String(value));
+NODE
+}
+
+print_line() {
+  local payload="$1"
+  PAYLOAD="$payload" node - "$lane" "${wave:-0}" "$agent" <<'NODE'
+const lane = process.argv[2] || "main";
+const wave = Number.parseInt(String(process.argv[3] || "0"), 10) || 0;
+const agentId = String(process.argv[4] || "").trim();
+const payload = JSON.parse(process.env.PAYLOAD || "{}");
+const signals = payload?.signals || {};
+const snapshot = agentId
+  ? (Array.isArray(signals.agents) ? signals.agents.find((entry) => entry.agentId === agentId) : null)
+  : signals.wave;
+const effective = snapshot || {
+  signal:
+    payload?.blockingEdge?.kind === "human-input"
+      ? "feedback-requested"
+      : payload?.phase === "complete"
+        ? "completed"
+        : payload?.phase === "failed"
+          ? "failed"
+          : "waiting",
+  phase: payload?.phase || "unknown",
+  status:
+    payload?.phase === "complete"
+      ? "completed"
+      : payload?.phase === "failed"
+        ? "failed"
+        : payload?.blockingEdge
+          ? "blocked"
+          : payload?.phase || "running",
+  blocking: payload?.blockingEdge || null,
+  attempt: payload?.activeAttempt?.attemptNumber || 0,
+  version: 0,
+  shouldWake: agentId ? true : null,
+  targetAgentIds: agentId ? [agentId] : [],
+};
+const targetKey = agentId ? "agent" : "agents";
+const targetValue = agentId || (effective.targetAgentIds || []).join(",") || "none";
+const shouldWake =
+  typeof effective.shouldWake === "boolean" ? (effective.shouldWake ? "yes" : "no") : "n/a";
+console.log(
+  [
+    `signal=${String(effective.signal || "waiting").trim().toLowerCase() || "waiting"}`,
+    `lane=${lane}`,
+    `wave=${payload?.wave ?? wave}`,
+    `phase=${effective.phase || "unknown"}`,
+    `status=${effective.status || "running"}`,
+    `blocking=${effective?.blocking?.kind || payload?.blockingEdge?.kind || "none"}`,
+    `attempt=${effective.attempt || 0}`,
+    `${targetKey}=${targetValue}`,
+    `version=${effective.version || 0}`,
+    `should_wake=${shouldWake}`,
+  ].join(" "),
+);
+NODE
+}
+
+exit_code_for_payload() {
+  local payload="$1"
+  PAYLOAD="$payload" node - "$agent" <<'NODE'
+const agentId = String(process.argv[2] || "").trim();
+const payload = JSON.parse(process.env.PAYLOAD || "{}");
+const signals = payload?.signals || {};
+const snapshot = agentId
+  ? (Array.isArray(signals.agents) ? signals.agents.find((entry) => entry.agentId === agentId) : null)
+  : signals.wave;
+const signal = String(
+  snapshot?.signal
+  || (payload?.phase === "complete" ? "completed" : payload?.phase === "failed" ? "failed" : "waiting"),
+).trim().toLowerCase();
+if (signal === "completed") {
+  process.exit(0);
+}
+if (signal === "failed") {
+  process.exit(40);
+}
+if (signal === "feedback-requested") {
+  process.exit(20);
+}
+process.exit(10);
+NODE
+}
+
+initial_args=("${base_args[@]}")
+if [ -n "$wave" ]; then
+  initial_args+=(--wave "$wave")
+fi
+payload="$("$status_script" "${initial_args[@]}" --json)"
+
+if [ -z "$wave" ]; then
+  wave="$(
+    PAYLOAD="$payload" node -e '
+      const payload = JSON.parse(process.env.PAYLOAD || "{}");
+      process.stdout.write(String(payload?.wave ?? 0));
+    '
+  )"
+fi
+
+common_args=("${base_args[@]}" --wave "$wave")
+version="$(extract_field "$payload" "version")"
+print_line "$payload"
+
+if exit_code_for_payload "$payload"; then
+  exit 0
+else
+  status=$?
+  if [ "$status" -eq 20 ] || [ "$status" -eq 40 ]; then
+    exit "$status"
+  fi
+fi
+
+while true; do
+  sleep "$(awk "BEGIN { printf \"%.3f\", ${refresh_ms}/1000 }")"
+  payload="$("$status_script" "${common_args[@]}" --json)"
+  next_version="$(extract_field "$payload" "version")"
+  if [ "$next_version" = "$version" ]; then
+    continue
+  fi
+  version="$next_version"
+  print_line "$payload"
+  if exit_code_for_payload "$payload"; then
+    exit 0
+  else
+    status=$?
+    if [ "$status" -eq 20 ] || [ "$status" -eq 40 ]; then
+      exit "$status"
+    fi
+  fi
+  if [ "$mode" = "until-change" ]; then
+    exit 30
+  fi
+done

package/services/README.md

@@ -0,0 +1,17 @@
+# Services
+
+Internal services that support the editor live here.
+
+- `react-word-editor/`
+  Railway-hosted internal harness for upload, fixture browsing, edit/export, and validation inspection.
+- `openxml-validator/`
+  Railway-hosted internal validator service that runs the Microsoft Open XML SDK and package integrity checks.
+
+These services are not shipped as part of the browser component bundle.
+
+Wave 0 status:
+
+- `react-word-editor/` is treated as `repo-landed` because the repo now contains a runnable Next.js service scaffold, deployment packaging, and harness-facing documentation.
+- `openxml-validator/` is treated as `repo-landed` because the repo now contains a buildable .NET validator service scaffold, endpoint contract, and Docker packaging.
+
+These service states are intentionally stronger than the editor-side source modules in Wave 0 because they already have runnable scaffold proof, while the editor-side modules move from scaffold to `contract-frozen` architecture in Wave 1.

package/services/openxml-validator/Dockerfile

@@ -0,0 +1,29 @@
+# Build context: repo root. Configure Railway to point at services/openxml-validator/Dockerfile
+# with the repository root as the build context (not the service subdirectory). The COPY paths
+# below are prefixed with services/openxml-validator/ which requires the repo root as context.
+#
+# Runtime-only variables (none are required in the build stage):
+#   ASPNETCORE_URLS is set in the runtime stage below; no private networking env vars are baked
+#   into the image at build time. Service-to-service traffic uses the Railway private domain:
+#   http://openxml-validator.railway.internal:8080
+FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
+
+WORKDIR /src
+
+COPY services/openxml-validator/OpenXmlValidator.Api.csproj ./
+RUN dotnet restore
+
+COPY services/openxml-validator/. ./
+RUN dotnet publish OpenXmlValidator.Api.csproj -c Release -o /app/publish
+
+FROM mcr.microsoft.com/dotnet/aspnet:8.0
+
+WORKDIR /app
+
+COPY --from=build /app/publish .
+
+ENV ASPNETCORE_URLS=http://0.0.0.0:8080
+
+EXPOSE 8080
+
+ENTRYPOINT ["dotnet", "OpenXmlValidator.Api.dll"]

package/services/openxml-validator/OpenXmlValidator.Api.csproj

@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <AssemblyName>OpenXmlValidator.Api</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="DocumentFormat.OpenXml" Version="3.5.1" />
+  </ItemGroup>
+</Project>