@1agh/maude 0.27.0 → 0.28.1

package/plugins/design/dev-server/draw/brush.ts

@@ -23,15 +23,15 @@
 
 import type { Rect } from './geometry.ts';
 import {
-  path,
+  circle,
   type DrawPrimitive,
   type DrawStyle,
-  type Point,
-  circle,
   fe,
   filter,
   group,
   line,
+  type Point,
+  path,
 } from './primitives.ts';
 
 function fmt(n: number): string {

package/plugins/design/dev-server/draw/index.ts

@@ -18,11 +18,11 @@
  *             React-free (DDR-067) — nothing here imports react / a `.tsx`.
  */
 
-export * from './primitives.ts';
-export * from './geometry.ts';
-export * from './palette.ts';
-export * from './composition.ts';
 export * from './brush.ts';
+export * from './composition.ts';
+export * from './geometry.ts';
 export * from './layout.ts';
-export * from './serialize.ts';
 export * from './optimize.ts';
+export * from './palette.ts';
+export * from './primitives.ts';
+export * from './serialize.ts';

package/plugins/design/dev-server/draw/layout.ts

@@ -15,7 +15,7 @@
  */
 
 import { type Rect, routeConnector } from './geometry.ts';
-import { type DrawPrimitive, type Point, group, polyline, rect, snap, text } from './primitives.ts';
+import { type DrawPrimitive, group, type Point, polyline, rect, snap, text } from './primitives.ts';
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Grid + modular scale

package/plugins/design/dev-server/draw/test/geometry.test.ts

@@ -1,11 +1,11 @@
 import { describe, expect, test } from 'bun:test';
 import {
-  EQUAL_AREA_CIRCLE_SCALE,
   blobPath,
   centroid,
   centroidCenter,
   chamferCorners,
   convexHull,
+  EQUAL_AREA_CIRCLE_SCALE,
   equalWeightCircleDiameter,
   overshoot,
   pchipEval,

package/plugins/design/dev-server/draw/test/layout.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from 'bun:test';
 import type { Rect } from '../geometry.ts';
-import { type LabelItem, diagram, modularScale, placeLabels, snapToGrid } from '../layout.ts';
+import { diagram, type LabelItem, modularScale, placeLabels, snapToGrid } from '../layout.ts';
 import type { Point } from '../primitives.ts';
 
 describe('grid + modular scale', () => {

package/plugins/design/dev-server/draw/test/primitives.test.ts

@@ -1,6 +1,5 @@
 import { describe, expect, test } from 'bun:test';
 import {
-  VIEWBOX,
   boxViewBox,
   circle,
   group,
@@ -13,6 +12,7 @@ import {
   text,
   transformString,
   use,
+  VIEWBOX,
 } from '../primitives.ts';
 
 describe('snap', () => {

package/plugins/design/dev-server/draw/test/serialize.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from 'bun:test';
-import { path, circle, group, line, rect, text } from '../primitives.ts';
 import type { DrawPrimitive } from '../primitives.ts';
+import { circle, group, line, path, rect, text } from '../primitives.ts';
 import { primitivesToNodes, toJsx, toSvg } from '../serialize.ts';
 
 const SAMPLE: DrawPrimitive[] = [

package/plugins/design/dev-server/equal-spacing-handles.tsx

@@ -15,9 +15,9 @@
 import { useEffect, useRef, useState } from 'react';
 
 import {
+  detectEqualSpacing,
   type EqualSpacingResult,
   type SpacingAxis,
-  detectEqualSpacing,
 } from './equal-spacing-detector.ts';
 import { useSelectionSet } from './use-selection-set.tsx';
 

package/plugins/design/dev-server/examples/perf-100-artboards.tsx

@@ -20,9 +20,8 @@
  * Results land in .ai/decisions/DDR-024 + .ai/logs/phase-4-perf-<date>.md.
  */
 
-import { useEffect } from 'react';
-
 import { DCArtboard, DCSection, DesignCanvas } from '@maude/canvas-lib';
+import { useEffect } from 'react';
 
 const ARTBOARD_COUNT = 100;
 const NODES_PER_ARTBOARD = 30;

package/plugins/design/dev-server/export-dialog.tsx

@@ -14,8 +14,8 @@
  */
 
 import {
-  type ReactNode,
   createContext,
+  type ReactNode,
   useCallback,
   useContext,
   useEffect,

package/plugins/design/dev-server/exporters/html.ts

@@ -13,10 +13,10 @@ import path from 'node:path';
 import JSZip from 'jszip';
 
 import {
+  canvasShellUrl,
   type ExportContext,
   type ExportOptions,
   type ExportResult,
-  canvasShellUrl,
 } from './index.ts';
 import type { Target } from './scope.ts';
 

package/plugins/design/dev-server/exporters/index.ts

@@ -13,7 +13,7 @@ import * as html from './html.ts';
 import * as pdf from './pdf.ts';
 import * as png from './png.ts';
 import * as pptx from './pptx.ts';
-import { type ResolveScopeArgs, type Scope, type Target, resolveScope } from './scope.ts';
+import { type ResolveScopeArgs, resolveScope, type Scope, type Target } from './scope.ts';
 import * as svg from './svg.ts';
 import * as zip from './zip.ts';
 
@@ -100,8 +100,8 @@ export async function runExport(args: {
   return adapter.run(targets, args.options, args.ctx);
 }
 
-export { resolveScope };
 export type { Scope, Target };
+export { resolveScope };
 
 /**
  * Build the `_canvas-shell.html?canvas=…&tokens=…&components=…` URL the

package/plugins/design/dev-server/exporters/pdf.ts

@@ -15,10 +15,10 @@ import path from 'node:path';
 import { PDFDocument } from 'pdf-lib';
 
 import {
+  canvasShellUrl,
   type ExportContext,
   type ExportOptions,
   type ExportResult,
-  canvasShellUrl,
 } from './index.ts';
 import type { Target } from './scope.ts';
 

package/plugins/design/dev-server/exporters/png.ts

@@ -14,10 +14,10 @@ import path from 'node:path';
 import JSZip from 'jszip';
 
 import {
+  canvasShellUrl,
   type ExportContext,
   type ExportOptions,
   type ExportResult,
-  canvasShellUrl,
 } from './index.ts';
 import type { Target } from './scope.ts';
 

package/plugins/design/dev-server/exporters/pptx.ts

@@ -28,10 +28,10 @@ import PptxGenJS from 'pptxgenjs';
 
 import { getBrowserBundle } from './_browser-bundles.ts';
 import {
+  canvasShellUrl,
   type ExportContext,
   type ExportOptions,
   type ExportResult,
-  canvasShellUrl,
 } from './index.ts';
 import type { Target } from './scope.ts';
 

package/plugins/design/dev-server/exporters/svg.ts

@@ -14,10 +14,10 @@ import JSZip from 'jszip';
 
 import { getBrowserBundle } from './_browser-bundles.ts';
 import {
+  canvasShellUrl,
   type ExportContext,
   type ExportOptions,
   type ExportResult,
-  canvasShellUrl,
 } from './index.ts';
 import type { Target } from './scope.ts';
 

package/plugins/design/dev-server/http.ts

@@ -19,7 +19,7 @@ import type { ActiveJsonShape } from './exporters/scope.ts';
 import type { Inspect } from './inspect.ts';
 import { canvasSlug, writeLocator } from './locator.ts';
 import { DEV_SERVER_ROOT } from './paths.ts';
-import { RUNTIME_PACKAGES, getRuntimeBundle, packageForSlug, slugFor } from './runtime-bundle.ts';
+import { getRuntimeBundle, packageForSlug, RUNTIME_PACKAGES, slugFor } from './runtime-bundle.ts';
 
 // Real disk install root — never the virtual `/$bunfs/root` of compiled bins.
 // See paths.ts for the resolution logic + Phase 19.1 / v0.18.1 rationale.

package/plugins/design/dev-server/inspect.ts

@@ -230,7 +230,37 @@ const INSPECTOR_SCRIPT = `
     '.dgn-pin { position: absolute; top: 0; left: 0; z-index: 2147483646; width: 22px; height: 22px; padding: 0; border: 0; border-radius: 999px 999px 999px 4px; background: #facc15; color: #1c1917; font: 600 11px/22px var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace); text-align: center; cursor: pointer; box-shadow: 0 2px 6px rgba(0,0,0,0.5), 0 0 0 1px rgba(0,0,0,0.4); transition: filter 120ms; transform-origin: bottom left; will-change: transform; }',
     '.dgn-pin:hover { filter: brightness(1.1); outline: 2px solid rgba(0,0,0,0.3); }',
     '.dgn-pin.resolved { background: #22c55e; color: #052e16; }',
-    '.dgn-pin.focused { box-shadow: 0 4px 12px rgba(0,0,0,0.6), 0 0 0 2px #fff; outline: 2px solid #fff; }'
+    '.dgn-pin.focused { box-shadow: 0 4px 12px rgba(0,0,0,0.6), 0 0 0 2px #fff; outline: 2px solid #fff; }',
+    /* Phase 13 / DDR-029 — canvas activity overlay. Single injection point so the
+       canvas iframe stays self-contained. Scoped with html ... so canvas-page
+       stylesheets can't clobber it. The "editing" motion is a light scan beam
+       (Phase 13.3) sweeping the whole artboard top→bottom — transform-only
+       (compositor), unmounts when the file goes idle (infinite-with-control,
+       flow:motion-rules §5); reduced-motion drops the beam to a static rim. The
+       rim border + glow are static boundary chrome. */
+    'html .dc-activity-rim { position: absolute; pointer-events: none; box-sizing: border-box; border: 2.5px solid var(--mdcc-activity, hsl(210 90% 58%)); border-radius: 5px; z-index: 6; opacity: 1; transition: opacity 200ms ease-out; }',
+    'html .dc-activity-rim[data-fading="true"] { opacity: 0; }',
+    'html .dc-activity-rim::after { content: ""; position: absolute; inset: -1px; border-radius: 6px; box-shadow: 0 0 0 1px var(--mdcc-activity, hsl(210 90% 58%)), 0 0 16px 2px var(--mdcc-activity, hsl(210 90% 58%)); opacity: 0.55; pointer-events: none; will-change: opacity; animation: dc-activity-glow var(--mdcc-activity-scan-ms, 2200ms) ease-in-out infinite; }',
+    'html .dc-activity-badge { position: absolute; top: 4px; right: 4px; z-index: 2; padding: 2px 8px; border-radius: 4px; background: var(--mdcc-activity, hsl(210 90% 58%)); color: #fff; font: 600 11px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace; font-variant-numeric: tabular-nums; white-space: nowrap; box-shadow: 0 1px 4px rgba(0,0,0,0.45); }',
+    /* Phase 13.3 — the AGENT BORDER is the primary "editing" indicator: a clear
+       2.5px border in the agent color with a softly pulsing glow (::after,
+       opacity-only, compositor). Clipping lives on the wash (not the rim) so the
+       outward glow is not clipped. The dc-activity-scan wash is ONE full-artboard
+       wave: a single gradient with a SHARP bottom edge (full agent color) fading
+       up to transparent at the top (height = artboard). Its sharp edge enters at
+       the top and the whole wave travels straight down and off past the bottom
+       edge (translateY -100% → 100%), then the next wave enters from the top in a
+       loop. transform-only; linear so it flows at a steady pace. */
+    'html .dc-activity-scan { position: absolute; inset: 0; overflow: hidden; border-radius: 4px; pointer-events: none; z-index: 1; }',
+    'html .dc-activity-scan::after { content: ""; position: absolute; left: 0; right: 0; top: 0; height: 135%; will-change: transform; background: linear-gradient(to top, color-mix(in oklab, var(--mdcc-activity, hsl(210 90% 58%)) 20%, transparent) 0%, transparent 100%); animation: dc-activity-wave var(--mdcc-activity-scan-ms, 3800ms) linear infinite; }',
+    '@keyframes dc-activity-glow { 0%, 100% { opacity: 0.4; } 50% { opacity: 0.85; } }',
+    '@keyframes dc-activity-wave { from { transform: translateY(-100%); } to { transform: translateY(100%); } }',
+    '@media (prefers-reduced-motion: reduce) { html .dc-activity-rim { transition: none; } html .dc-activity-rim::after { animation: none; opacity: 0.55; } html .dc-activity-scan { display: none; } }',
+    /* Phase 13.1 / DDR-077 — "holding last good render" toast, shown when an
+       agent edit produced a broken intermediate (build/render error) and the
+       canvas is held instead of flashing white. Amber = warn, distinct from the
+       blue activity rim. pointer-events:none so it never blocks the canvas. */
+    'html .dc-hmr-holding { position: fixed; left: 50%; bottom: 16px; transform: translateX(-50%); z-index: 2147483646; pointer-events: none; max-width: 90vw; padding: 6px 12px; border-radius: 6px; background: hsl(38 92% 50% / 0.96); color: #1c1207; font: 600 12px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; box-shadow: 0 2px 10px rgba(0,0,0,0.45); }'
   ].join('\\n');
   document.documentElement.appendChild(styleEl);
 

package/plugins/design/dev-server/marquee-overlay.tsx

@@ -277,6 +277,6 @@ export function applyMarqueeMode(
   selSet.replace(next);
 }
 
+export type { Mode };
 // Re-export for tests.
 export { modeOf };
-export type { Mode };

package/plugins/design/dev-server/participants-chrome.tsx

@@ -17,6 +17,7 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 
 import { useViewportControllerContext } from './canvas-lib.tsx';
+import { type AgentPresence, useAgentPresence } from './use-agent-presence.tsx';
 import { type ForeignAwareness, useCollab, useForeignAwareness } from './use-collab.tsx';
 
 const CHROME_CSS = `
@@ -110,6 +111,34 @@ const CHROME_CSS = `
 @media (prefers-reduced-motion: reduce) {
   .dc-participant { transition: none; }
 }
+/* Phase 13.2 / DDR-078 — agent presence avatar. Looks like a peer chip + a
+   subtle ✦ marker so an agent reads as distinct from a human collaborator. */
+.dc-participant--agent { box-shadow: 0 1px 2px rgba(0,0,0,0.08), 0 0 0 1px rgba(0,0,0,0.04); }
+.dc-participant-agent-marker {
+  position: absolute;
+  right: -3px;
+  bottom: -3px;
+  width: 13px;
+  height: 13px;
+  border-radius: 50%;
+  background: var(--maude-chrome-bg-0, #fff);
+  color: var(--maude-chrome-fg-0, #111);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 8px;
+  line-height: 1;
+  box-shadow: 0 0 0 1px rgba(0,0,0,0.14);
+  pointer-events: none;
+}
+.dc-participant-popover__sub {
+  font-size: 11px;
+  color: var(--maude-chrome-fg-2, #666);
+  margin-top: -4px;
+  margin-bottom: 6px;
+  white-space: normal;
+  max-width: 200px;
+}
 `.trim();
 
 function ensureChromeStyles(): void {
@@ -192,10 +221,63 @@ function Avatar({ peer, isFollowing, onToggleFollow }: AvatarProps): JSX.Element
   );
 }
 
+// Phase 13.2 / DDR-078 — an agent rendered as a presence peer. No "Follow"
+// (an agent has no viewport to mirror); a ✦ marker + an "AI agent" popover
+// subtitle distinguish it from a human collaborator.
+function AgentAvatar({ agent }: { agent: AgentPresence }): JSX.Element {
+  const [open, setOpen] = useState(false);
+  const rootRef = useRef<HTMLDivElement | null>(null);
+
+  useEffect(() => {
+    if (!open) return;
+    const onDocClick = (e: MouseEvent) => {
+      if (!rootRef.current) return;
+      if (!rootRef.current.contains(e.target as Node)) setOpen(false);
+    };
+    document.addEventListener('mousedown', onDocClick);
+    return () => document.removeEventListener('mousedown', onDocClick);
+  }, [open]);
+
+  return (
+    <div
+      ref={rootRef}
+      className="dc-participant dc-participant--agent"
+      style={{ background: agent.color }}
+      onClick={() => setOpen((v) => !v)}
+      onKeyDown={(e) => {
+        if (e.key === 'Enter' || e.key === ' ') {
+          e.preventDefault();
+          setOpen((v) => !v);
+        }
+      }}
+      // biome-ignore lint/a11y/useSemanticElements: matches the peer Avatar chip pattern.
+      role="button"
+      tabIndex={0}
+      title={`${agent.name} (AI agent)`}
+      aria-label={`${agent.name}, AI agent`}
+      aria-expanded={open}
+    >
+      {initialsFor(agent.name)}
+      <span className="dc-participant-agent-marker" aria-hidden>
+        ✦
+      </span>
+      {open && (
+        // biome-ignore lint/a11y/useKeyWithClickEvents: stop-propagation wrapper; no actionable child.
+        // biome-ignore lint/a11y/useSemanticElements: popover wrapper carries no semantic role.
+        <div className="dc-participant-popover" onClick={(e) => e.stopPropagation()}>
+          <div className="dc-participant-popover__name">{agent.name}</div>
+          <div className="dc-participant-popover__sub">AI agent · {agent.author}</div>
+        </div>
+      )}
+    </div>
+  );
+}
+
 export function ParticipantsChrome(): JSX.Element | null {
   ensureChromeStyles();
   const collab = useCollab();
   const peers = useForeignAwareness();
+  const agent = useAgentPresence();
   const controller = useViewportControllerContext();
 
   const [followTarget, setFollowTarget] = useState<number | null>(null);
@@ -242,7 +324,9 @@ export function ParticipantsChrome(): JSX.Element | null {
     controller.setViewport(v);
   }, [controller, followTarget, peers]);
 
-  if (peers.length === 0) return null;
+  // Render whenever there's a human peer OR an active agent (so an agent shows
+  // even with no human collaborators connected).
+  if (peers.length === 0 && !agent) return null;
 
   return (
     <div className="dc-participants" aria-label="Active collaborators">
@@ -254,6 +338,7 @@ export function ParticipantsChrome(): JSX.Element | null {
           onToggleFollow={onToggleFollow}
         />
       ))}
+      {agent ? <AgentAvatar key={agent.id} agent={agent} /> : null}
     </div>
   );
 }

package/plugins/design/dev-server/server.ts

@@ -16,6 +16,7 @@
 
 import { spawn } from 'node:child_process';
 
+import { createActivity } from './activity.ts';
 import { createApi } from './api.ts';
 import { bootSelfHeal } from './boot-self-heal.ts';
 import { createAiActivity } from './collab/ai-activity.ts';
@@ -27,7 +28,7 @@ import { createHttp } from './http.ts';
 import { createInspect } from './inspect.ts';
 import { startHeapWatch } from './mem.ts';
 import { createSyncRuntime } from './sync/index.ts';
-import { type WsData, createWs, isLoopbackHost, parseCollabSlug } from './ws.ts';
+import { createWs, isLoopbackHost, parseCollabSlug, type WsData } from './ws.ts';
 
 // Phase 19 / DDR-044 — covers the marketplace-cache-install gap where
 // node_modules/ ships empty (git clone honors .gitignore). Auto-installs +
@@ -77,7 +78,10 @@ await inspect.load();
 collab = createCollab(ctx, api);
 const aiActivity = createAiActivity(ctx);
 const gitLifecycle = createGitLifecycle(ctx, collab.registry);
-const ws = createWs(ctx, api, inspect, collab);
+// Phase 13 / DDR-029 — fs-watch-driven canvas activity overlay. Subscribes to
+// `fs:any` and emits `activity:change`; ws.ts forwards it to canvas iframes.
+const activity = createActivity(ctx);
+const ws = createWs(ctx, api, inspect, collab, activity);
 const http = createHttp(ctx, api, inspect, aiActivity);
 const fsWatch = createFsWatch(ctx);
 
@@ -346,6 +350,11 @@ if (!process.env.NO_OPEN) {
 async function shutdown() {
   console.log('\n  Stopping…');
   fsWatch.stop();
+  try {
+    activity.stop();
+  } catch {
+    /* timer cleanup is best-effort */
+  }
   try {
     if (syncRuntime) await syncRuntime.stop();
   } catch {

package/plugins/design/dev-server/sync/agent.ts

@@ -33,7 +33,6 @@ import type * as Y from 'yjs';
 
 import { atomicWrite } from './atomic-write.ts';
 import {
-  Y_SYNC_TYPES,
   annotationsFromDoc,
   applyAnnotationsToDoc,
   applyCommentsToDoc,
@@ -45,6 +44,7 @@ import {
   htmlFromDoc,
   mergeSharedMetaIntoLocal,
   metaFromDoc,
+  Y_SYNC_TYPES,
 } from './codec.ts';
 import { type EchoGuard, hashBytes } from './echo-guard.ts';
 

package/plugins/design/dev-server/sync/index.ts

@@ -29,15 +29,15 @@ import type { Context } from '../context.ts';
 import { type CanvasSyncAgent, createCanvasSyncAgent } from './agent.ts';
 import {
   type ConnectionMonitor,
-  type ProviderStatus,
   createConnectionMonitor,
+  type ProviderStatus,
 } from './connection-state.ts';
-import { type EchoGuard, createEchoGuard } from './echo-guard.ts';
-import { type FsReader, createFsReader } from './fs-mirror.ts';
+import { createEchoGuard, type EchoGuard } from './echo-guard.ts';
+import { createFsReader, type FsReader } from './fs-mirror.ts';
 import { getHubToken } from './hubs-config.ts';
 import { migrateSeed } from './migrate-seed.ts';
-import { type DocProjection, createDocProjection } from './projection.ts';
-import { type SyncStatusStore, createSyncStatusStore } from './status.ts';
+import { createDocProjection, type DocProjection } from './projection.ts';
+import { createSyncStatusStore, type SyncStatusStore } from './status.ts';
 import { writeUntrustedMarkers } from './untrusted.ts';
 
 /** A minimum-surface stand-in for the HocuspocusProvider's runtime API. */
@@ -246,16 +246,17 @@ export function createSyncRuntime(
       return;
     }
 
-    // DDR-072 — loud boot banner when the project-level TSX opt-in is on against
-    // a NON-loopback hub. Broadening from hand-picked canvases to "all .tsx"
-    // also broadens the WebRTC/self-nav exfil residual (the sandbox contains
-    // execution but not that lane) to every synced canvas, so this must never be
-    // silent: a sneaky PR that flips `linkedHub.syncTsx` surfaces here on the
-    // next `serve`. Loopback hubs (local dev) skip it — no remote exfil concern.
-    if (linkedHub.syncTsx === true && !isLoopbackHubUrl(linkedHub.url)) {
-      const tsxCount = canvases.filter((c) => c.html.toLowerCase().endsWith('.tsx')).length;
+    // DDR-079 — TSX sync defaults ON, so every linked non-loopback project that
+    // ships .tsx broadcasts the WebRTC/self-nav exfil residual (the sandbox
+    // contains execution but not that lane) to every synced canvas. The default
+    // traded a footgun (silent 0-syncable) for this surface, so the surface must
+    // be LOUD: a banner on every `serve` naming the count + the opt-outs. Fires
+    // unless explicitly opted out (`syncTsx: false`); loopback hubs (local dev)
+    // skip it — no remote exfil concern.
+    const tsxBodyCount = canvases.filter((c) => c.html.toLowerCase().endsWith('.tsx')).length;
+    if (linkedHub.syncTsx !== false && tsxBodyCount > 0 && !isLoopbackHubUrl(linkedHub.url)) {
       console.warn(
-        `[sync] syncTsx=true — ${tsxCount} TSX canvas BODIES will sync to ${linkedHub.url} (project-level opt-in, DDR-072). The sandbox contains execution, but the WebRTC/self-nav exfil residual now applies to ALL synced canvases — only for hubs you operate or fully trust. Set a canvas .meta.json "syncable": false to exclude it.`
+        `[sync] ${tsxBodyCount} TSX canvas BODIES will sync to ${linkedHub.url} (TSX sync is ON by default — DDR-079). The sandbox contains execution, but a WebRTC/self-nav exfil residual applies to every synced canvas — link only hubs you operate or trust. Opt out: linkedHub.syncTsx=false (whole project) or a canvas .meta.json "syncable": false (one canvas).`
       );
     }
 
@@ -612,12 +613,15 @@ export async function scanCanvases(ctx: Context): Promise<CanvasScan> {
   // `.tsx` syncs — the per-canvas opt-in is inert without the sandbox, and
   // decoupling them would re-open the CRITICAL F1 RCE (DDR-060, DDR-054 §F1).
   const splitActive = !!ctx.canvasOrigin;
-  // DDR-072 — project-level TSX opt-in. When `linkedHub.syncTsx` is true, a
-  // `.tsx` with no explicit sidecar verdict defaults to syncable (the per-canvas
-  // sidecar still wins either way — see resolveSyncable). Coupled with the
-  // sandbox via `splitActive` exactly like the per-canvas opt-in, so the flag is
-  // inert without the F1 containment (DDR-060 Lock-2 invariant).
-  const projectSyncTsx = ctx.cfg.linkedHub?.syncTsx === true;
+  // DDR-079 (supersedes DDR-072) — TSX sync defaults ON for a linked project.
+  // Absence of the flag = ON: a freshly-linked peer sees the project's TSX
+  // without a hidden per-project opt-in (the recurring "I linked but my teammate
+  // sees nothing" footgun). `linkedHub.syncTsx: false` is the explicit
+  // project-wide opt-out; a per-canvas `.meta.json "syncable": false` still wins
+  // for one canvas (see resolveSyncable). The Lock-2 sandbox coupling
+  // (`splitActive`) is UNTOUCHED — a `.tsx` still syncs ONLY when the cross-origin
+  // containment is active; decoupling them would re-open the F1 RCE (DDR-060).
+  const projectSyncTsx = ctx.cfg.linkedHub?.syncTsx !== false;
   for (const group of ctx.cfg.canvasGroups) {
     const groupAbs = path.join(ctx.paths.designRoot, group.path);
     if (!existsSync(groupAbs)) continue;
@@ -636,7 +640,7 @@ export async function scanCanvases(ctx: Context): Promise<CanvasScan> {
 }
 
 /**
- * T3 (9.1-B) + DDR-072 — resolve whether a `.tsx` body is syncable.
+ * T3 (9.1-B) + DDR-079 (was DDR-072) — resolve whether a `.tsx` body is syncable.
  *
  * Tri-state precedence:
  *  1. The sibling `<name>.meta.json` `"syncable"` boolean ALWAYS wins when
@@ -644,9 +648,10 @@ export async function scanCanvases(ctx: Context): Promise<CanvasScan> {
  *     sidecar; deliberately NOT in the untrusted `/_api/canvas-meta` PATCH
  *     whitelist (api.ts), so a hostile canvas/hub cannot flip its own body into
  *     or out of the sync set.
- *  2. Otherwise fall back to the project-level `linkedHub.syncTsx` default.
+ *  2. Otherwise fall back to `projectSyncTsx` — which now defaults to TRUE
+ *     (DDR-079); `linkedHub.syncTsx: false` is the explicit project-wide opt-out.
  *
- * Missing sidecar / parse error → no explicit verdict → the project default.
+ * Missing sidecar / parse error → no explicit verdict → the project default (on).
  */
 function resolveSyncable(bodyAbs: string, projectSyncTsx: boolean): boolean {
   const metaAbs = bodyAbs.replace(/\.(tsx|html)$/i, '.meta.json');
@@ -752,7 +757,7 @@ export function buildNoSyncablePayload(
 ): NoSyncablePayload {
   const reason =
     tsxCount > 0
-      ? `${tsxCount} TSX canvas(es) found but none are syncable — a TSX body syncs when the canvas opts in (.meta.json "syncable": true) OR the project opts in all of them (.design/config.json linkedHub.syncTsx: true, DDR-072). The canvas sandbox is on by default; MAUDE_CANVAS_ORIGIN_SPLIT=0 disables it (and TSX sync with it). See DDR-060.`
+      ? `${tsxCount} TSX canvas(es) found but none are syncable. TSX sync is ON by default (DDR-079), so this means it was opted OUT — either project-wide (.design/config.json linkedHub.syncTsx: false) or per canvas (.meta.json "syncable": false) — OR the cross-origin sandbox is off (MAUDE_CANVAS_ORIGIN_SPLIT=0 disables it, and TSX sync with it — DDR-060). Remove the opt-out / re-enable the sandbox to sync.`
       : `no canvases found under ${designRoot}.`;
   return {
     linked: true,

package/plugins/design/dev-server/sync/materialize.ts

@@ -21,7 +21,7 @@
 
 import type * as Y from 'yjs';
 import { Y_TYPES } from '../collab/persistence.ts';
-import { Y_SYNC_TYPES, annotationsFromDoc, commentsFromDoc } from './codec.ts';
+import { annotationsFromDoc, commentsFromDoc, Y_SYNC_TYPES } from './codec.ts';
 
 export interface CanonicalMaterialization {
   html: string;
@@ -59,4 +59,4 @@ export function materializeCanonical(doc: Y.Doc): string {
 }
 
 // Re-export so a shadow-compare caller has the type names in one import.
-export { Y_TYPES, Y_SYNC_TYPES };
+export { Y_SYNC_TYPES, Y_TYPES };

package/plugins/design/dev-server/sync/migrate-seed.ts

@@ -34,12 +34,12 @@ import type * as Y from 'yjs';
 
 import { Y_TYPES } from '../collab/persistence.ts';
 import {
-  Y_SYNC_TYPES,
   applyAnnotationsToDoc,
   applyCommentsToDoc,
   applyCssToDoc,
   applyHtmlToDoc,
   applyMetaToDoc,
+  Y_SYNC_TYPES,
 } from './codec.ts';
 import { ORIGINS } from './origins.ts';
 

package/plugins/design/dev-server/sync/projection.ts

@@ -30,9 +30,6 @@ import type * as Y from 'yjs';
 
 import { atomicWrite } from './atomic-write.ts';
 import {
-  MAX_CSS_BYTES,
-  MAX_HTML_BYTES,
-  MAX_META_BYTES,
   applyAnnotationsToDoc,
   applyCommentsToDoc,
   applyCssToDoc,
@@ -40,6 +37,9 @@ import {
   applyMetaToDoc,
   cssFromDoc,
   htmlFromDoc,
+  MAX_CSS_BYTES,
+  MAX_HTML_BYTES,
+  MAX_META_BYTES,
   mergeSharedMetaIntoLocal,
   metaFromDoc,
 } from './codec.ts';