feat(diagnostics): add collaborative writing-guidance parity

.github/workflows/writing-diagnostics-collaboration-tdd.yml

@@ -0,0 +1,77 @@
+name: Writing Diagnostics Collaboration TDD
+
+on:
+  push:
+    branches:
+      - feat/writing-diagnostics-collaboration
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: writing-diagnostics-collaboration-tdd-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  collaborative-diagnostics:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          ref: ${{ github.sha }}
+          persist-credentials: false
+      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: 22
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - name: Run collaborative writing-diagnostic parity tests
+        run: |
+          set -euo pipefail
+          output_file="$(mktemp)"
+          trap 'rm -f "$output_file"' EXIT
+          set +e
+          pnpm exec vitest run \
+            src/collaboration/CollaborativeCwlEditor.writingDiagnostics.test.tsx \
+            src/collaboration/CollaborativeCwlEditor.writingDiagnostics.race.test.tsx \
+            src/collaboration/CollaborativeCwlEditor.writingDiagnostics.coverage.test.tsx \
+            src/collaboration/CollaborativeCwlEditor.writingDiagnostics.boundary.test.tsx \
+            --pool=forks \
+            --maxWorkers=1 2>&1 | tee "$output_file"
+          test_status=${PIPESTATUS[0]}
+          set -e
+          if grep -Fq 'not wrapped in act' "$output_file"; then
+            echo "::error::Focused collaborative diagnostics emitted a React act warning."
+            exit 1
+          fi
+          exit "$test_status"
+      - name: Typecheck collaborative writing-diagnostic contracts
+        run: pnpm typecheck
+      - name: Run complete production coverage gate
+        env:
+          NODE_OPTIONS: --max-old-space-size=6144
+        run: |
+          set -euo pipefail
+          output_file="$(mktemp)"
+          trap 'rm -f "$output_file"' EXIT
+          set +e
+          pnpm coverage 2>&1 | tee "$output_file"
+          test_status=${PIPESTATUS[0]}
+          set -e
+          if grep -Fq 'not wrapped in act' "$output_file"; then
+            echo "::error::Production coverage emitted a React act warning."
+            exit 1
+          fi
+          exit "$test_status"
+      - name: Build all package entrypoints
+        run: pnpm build
+      - name: Verify isolated packed-package consumers
+        run: pnpm verify:package
+      - name: Build demonstration application
+        run: pnpm build:demo

src/collaboration/CollaborativeCwlEditor.tsx

@@ -19,6 +19,8 @@ import { applyEditorFormReset } from '../components/editorFormReset.js';
 import { editorHtmlToValue } from '../components/editorSerialization.js';
 import { useEditorHandle } from '../components/useEditorHandle.js';
 import { useLatestRef } from '../components/useLatestRef.js';
+import { useWritingDiagnosticsController } from '../components/useWritingDiagnosticsController.js';
+import { WritingDiagnosticsPanel } from '../components/WritingDiagnosticsPanel.js';
 import type { ClipboardSanitizationError } from '../extensions/SafeClipboard.js';
 import { buildExtensions } from '../extensions/kit.js';
 import type { CwlEditorHandle } from '../types.js';
@@ -95,6 +97,11 @@ export const CollaborativeCwlEditor = forwardRef<
     ariaErrorMessage,
     ariaInvalid,
     ariaRequired,
+    writingDiagnostics,
+    onWritingDiagnosticAction,
+    onWritingDiagnosticsError,
+    writingDiagnosticsLabel,
+    printWritingDiagnostics,
   } = props;
 
   assertCollaborationConfiguration(provider, user);
@@ -260,7 +267,14 @@ export const CollaborativeCwlEditor = forwardRef<
     [collaborationDocument, scopedProvider, normalizedField, presenceEnabled],
   );
 
-  useEditorHandle(ref, editor, modeRef);
+  const writingDiagnosticsController = useWritingDiagnosticsController({
+    editor,
+    diagnostics: writingDiagnostics,
+    onAction: onWritingDiagnosticAction,
+    onError: onWritingDiagnosticsError,
+  });
+
+  useEditorHandle(ref, editor, modeRef, writingDiagnosticsController);
 
   useEffect(() => {
     editor?.setEditable(editable);
@@ -346,6 +360,24 @@ export const CollaborativeCwlEditor = forwardRef<
       formFieldDisabled={formFieldDisabled}
       onFormReset={editor && onFormReset ? handleFormReset : undefined}
       status={status}
+      writingDiagnosticsPanel={
+        writingDiagnostics === undefined ? undefined : (
+          <WritingDiagnosticsPanel
+            controller={writingDiagnosticsController}
+            label={writingDiagnosticsLabel ?? 'Writing guidance'}
+            onApplyDiagnostic={
+              editable
+                ? (diagnosticId) => {
+                    void writingDiagnosticsController.applyDiagnostic(
+                      diagnosticId,
+                    );
+                  }
+                : undefined
+            }
+            printEnabled={printWritingDiagnostics}
+          />
+        )
+      }
     />
   );
 });