@1agh/maude 1.2.0 → 1.3.0

package/apps/studio/collab/room.ts

@@ -77,6 +77,15 @@ export interface RoomCallbacks {
    * the seeded state.
    */
   seed(slug: string, doc: Y.Doc): Promise<void> | void;
+
+  /**
+   * Accepted revisions (DDR-241 §7): while true, this room's document is a
+   * replica of the project's accepted state — no browser connection may write
+   * a persistent lane into it (the hub would drop it and the replica would
+   * diverge). Comments and annotations go through the API as proposals.
+   * Awareness is unaffected. Optional; absent means false.
+   */
+  acceptedMode?: () => boolean;
 }
 
 export interface Room {
@@ -216,6 +225,8 @@ export function createRoom(slug: string, callbacks: RoomCallbacks): Room {
    */
   function refusedLanes(conn: RoomConn, roots: ReadonlySet<string>): string[] {
     const refused: string[] = [];
+    // Accepted revisions: every persistent lane is the hub's to change.
+    if (callbacks.acceptedMode?.()) return [...roots];
     for (const r of roots) {
       if (conn.realm === 'canvas' && (isBodyLane(r) || r === '<unresolved>')) {
         refused.push(r);
@@ -255,7 +266,7 @@ export function createRoom(slug: string, callbacks: RoomCallbacks): Room {
       gateRefusalCount += 1;
       discardMirror();
       console.warn(
-        `[collab/${slug}] origin gate REFUSED a ${conn.readOnly ? 'read-only' : 'canvas-realm'} ` +
+        `[collab/${slug}] origin gate REFUSED a ${callbacks.acceptedMode?.() ? 'accepted-replica' : conn.readOnly ? 'read-only' : 'canvas-realm'} ` +
           `sync frame (lanes: ${refused.join(', ') || 'unclassifiable'}). ` +
           (conn.readOnly
             ? 'A viewer-role socket may only write comments — role matrix, cloud collab lane.'
@@ -351,7 +362,7 @@ export function createRoom(slug: string, callbacks: RoomCallbacks): Room {
   }
 
   function receive(conn: RoomConn, payload: Uint8Array): void {
-    if (conn.realm === 'canvas' || conn.readOnly === true) {
+    if (conn.realm === 'canvas' || conn.readOnly === true || callbacks.acceptedMode?.()) {
       receiveGated(conn, payload);
       return;
     }

package/apps/studio/context.ts

@@ -259,6 +259,65 @@ export interface Context {
     current?(): {
       cancelAssetSweep(): boolean;
       retireForMove?(fromSlug: string, toRel: string): Promise<boolean>;
+      /** Accepted-revisions mode (DDR-241) — see SyncRuntime.proposeLane. */
+      proposeLane?(
+        slug: string,
+        lane: 'comments' | 'annotations' | 'meta',
+        text: string,
+        opts?: { baseText?: string; writeId?: string }
+      ): Promise<{ status: 'accepted' | 'rejected'; code?: string }> | null;
+      /** Accepted-revisions mode (DDR-241) — see SyncRuntime.proposeFolder. */
+      proposeFolder?(
+        op:
+          | { op: 'dir.create'; path: string }
+          | { op: 'dir.delete'; path: string }
+          | { op: 'dir.move'; from: string; to: string }
+      ): Promise<{ status: 'accepted' | 'rejected'; code?: string; queued?: boolean }> | null;
+      acceptedMode?(): boolean;
+      acceptedHistory?(q: {
+        limit?: number;
+        before?: number | null;
+        path?: string | null;
+      }): Promise<unknown[] | null>;
+      acceptedVersion?(repoRel: string, revision: number): Promise<string | null>;
+      acceptedRestore?(
+        repoRel: string,
+        revision: number
+      ): Promise<{ status: 'accepted' | 'rejected'; code?: string; queued?: boolean } | null>;
+      acceptedUndo?(
+        actionId: string,
+        redo?: boolean
+      ): Promise<{
+        status: 'accepted' | 'rejected';
+        code?: string;
+        queued?: boolean;
+        actionId?: string;
+      } | null>;
+      acceptedActionForContent?(repoRel: string, content: string): string | null;
+      prepareOffline?(): Promise<{
+        complete: boolean;
+        pulled: number;
+        passes: number;
+        failed: number;
+      } | null>;
+      conflictVersions?(
+        repoRel: string
+      ): { slug: string; mine: string | null; theirs: string } | null;
+      resolveConflict?(
+        repoRel: string,
+        choice: 'mine' | 'theirs'
+      ): Promise<{ status: 'accepted' | 'rejected' | 'taken'; code?: string } | null>;
+      /** T16 — AI action boundaries (see sync/action-stage.ts). */
+      beginAiAction?(key: string, label: string): void;
+      endAiAction?(
+        key: string,
+        outcome: 'done' | 'failed'
+      ): Promise<{ status: 'accepted' | 'rejected'; code?: string } | null>;
+      resolveAiAction?(choice: 'publish' | 'discard'): Promise<{
+        status: 'accepted' | 'rejected' | 'discarded';
+        code?: string;
+        canvases?: number;
+      } | null>;
     } | null;
   };
 }