deepspace 0.18.0 → 0.19.0

package/features/documentation/feature.json

@@ -59,7 +59,8 @@
     "The feature is served at /docs on the app's existing hostname.",
     "A hostname listed in documentation.json domains serves the same release at that hostname's root after you explicitly attach it to the app.",
     "Documentation builds only when documentation.json exists; apps without this feature are unaffected.",
-    "MDX may import app components directly. documentation.tsx is the single optional shell customization point."
+    "MDX may import app components directly. documentation.tsx is the single optional shell customization point.",
+    "Agent discovery is available at /docs/llms.txt, /docs/llms-full.txt, /docs/skill.md, /docs/.well-known/mcp, and /docs/mcp."
   ],
   "agentNotes": [
     "Treat documentation.json, documentation/**/*.md, documentation/**/*.mdx, and optional documentation.tsx as one app-owned documentation feature.",

package/features/documents/feature.json

@@ -3,7 +3,7 @@
   "name": "Documents",
   "category": "data",
   "description": "Real-time collaborative document editing with Tiptap + Yjs",
-  "details": "Document library with folders & favorites. Collaborative editor built on Tiptap (ProseMirror) with Y.XmlFragment via @tiptap/extension-collaboration and live remote cursors via @tiptap/extension-collaboration-caret — buttery typing, no innerHTML rebuilds, no contenteditable quirks. Invite-only documents with viewer/editor roles: owner shares via an in-app dialog that resolves an email to a DeepSpace user. RBAC is enforced by the documents schema and the starter template's built-in Yjs route. Includes a one-shot migration shim that converts documents created with the legacy contenteditable editor (HTML stored in Y.Text('content')) into Tiptap on first open.",
+  "details": "Document library with folders & favorites. Collaborative editor built on Tiptap (ProseMirror) with Y.XmlFragment via @tiptap/extension-collaboration and live remote cursors via @tiptap/extension-collaboration-caret — buttery typing, no innerHTML rebuilds, no contenteditable quirks. Invite-only documents with viewer/editor roles: owner shares via an in-app dialog that resolves an email to a DeepSpace user. RBAC is enforced by the documents schema and the starter template's built-in Yjs route.",
   "files": [
     {
       "src": "src/DocumentsListPage.tsx",

package/features/documents/src/DocumentsEditorPage.tsx

@@ -6,11 +6,6 @@
  * applied as granular PM transactions (no `innerHTML` swap), the local
  * caret is migrated through concurrent edits by PM's position mapping,
  * and remote cursors are painted by `@tiptap/extension-collaboration-caret`.
- *
- * Legacy documents created with the old editor stored HTML in Y.Text('content').
- * On first open by an editor/owner we migrate that into the new XmlFragment
- * via `editor.commands.setContent(html)` and clear the legacy field. The
- * migration is a single Yjs transaction so all peers converge.
  */
 
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
@@ -286,20 +281,12 @@ export default function DocumentsEditorPage() {
 
   const { put } = useMutations<DocumentsDocumentFields>('documents')
 
-  /**
-   * `'content'` is kept as the field name only so legacy-doc migration can
-   * read the old HTML out of Y.Text('content') below. The Tiptap editor
-   * itself binds to a separate Y.XmlFragment('default') inside the same
-   * Y.Doc — they don't collide.
-   */
-  const {
-    doc,
-    text: legacyText,
-    synced,
-    canWrite,
-    writeAuthResolved,
-    awareness,
-  } = useYjsRoom(docId ?? 'noop', 'content')
+  // The text helper remains available to consumers of useYjsRoom; this editor
+  // binds Tiptap directly to Y.XmlFragment('default') on the returned document.
+  const { doc, synced, connected, canWrite, writeAuthResolved, awareness } = useYjsRoom(
+    docId ?? 'noop',
+    'content',
+  )
 
   const presenceAccess = useDocumentsPresenceAccess({
     docId,
@@ -388,37 +375,6 @@ export default function DocumentsEditorPage() {
     placeholder: showReadOnlyDocUx ? 'View only' : 'Start typing — toolbar above for formatting…',
   })
 
-  // Legacy migration: if doc.getXmlFragment('default') is empty but the
-  // legacy Y.Text('content') field has HTML, parse it once into Tiptap.
-  // Only the first writer to open does this; viewers never see partial state
-  // because both the wipe and the parse run inside a single Yjs transaction.
-  const migratedRef = useRef(false)
-  useEffect(() => {
-    if (migratedRef.current) return
-    if (!editor || !synced || !effectiveCanWrite) return
-    const fragment = doc.getXmlFragment('default')
-    if (fragment.length > 0) {
-      migratedRef.current = true
-      return
-    }
-    const yText = doc.getText('content')
-    const legacy = (legacyText ?? yText.toString()).trim()
-    if (!legacy) {
-      migratedRef.current = true
-      return
-    }
-    migratedRef.current = true
-    /**
-     * Tiptap parses the HTML against its schema, then writes the resulting
-     * nodes into the bound Y.XmlFragment. We then clear the legacy field
-     * inside the same transaction so peers see one atomic step.
-     */
-    doc.transact(() => {
-      editor.commands.setContent(legacy, { emitUpdate: true })
-      if (yText.length > 0) yText.delete(0, yText.length)
-    })
-  }, [editor, synced, effectiveCanWrite, doc, legacyText])
-
   const { participants: presenceParticipants, typingNames } = useDocumentsEditorPresence({
     editor,
     document: selectedDoc,
@@ -522,7 +478,7 @@ export default function DocumentsEditorPage() {
               {effectiveRole === 'editor' ? 'Shared editor' : 'Shared viewer'}
             </span>
           ) : null}
-          {synced ? (
+          {connected && synced ? (
             <span
               className="flex items-center gap-1.5 text-xs tabular-nums"
               style={{ color: 'var(--documents-el-muted)' }}
@@ -530,7 +486,7 @@ export default function DocumentsEditorPage() {
               <span className="h-1.5 w-1.5 rounded-full bg-emerald-500" aria-hidden />
               Synced
             </span>
-          ) : (
+          ) : connected ? (
             <span
               className="flex items-center gap-1.5 text-xs tabular-nums"
               style={{ color: 'var(--documents-el-muted)' }}
@@ -538,6 +494,14 @@ export default function DocumentsEditorPage() {
               <span className="h-1.5 w-1.5 animate-pulse rounded-full bg-amber-500" aria-hidden />
               Connecting…
             </span>
+          ) : (
+            <span
+              className="flex items-center gap-1.5 text-xs tabular-nums"
+              style={{ color: 'var(--documents-el-muted)' }}
+            >
+              <span className="h-1.5 w-1.5 rounded-full bg-slate-400" aria-hidden />
+              Offline
+            </span>
           )}
           {effectiveRole === 'owner' ? (
             <Badge variant="success">Owner</Badge>

package/features/documents/src/editor/useDocEditor.ts

@@ -120,7 +120,7 @@ export function useDocEditor({
   canWrite,
   placeholder = 'Start typing — toolbar above for formatting…',
 }: UseDocEditorOptions): Editor | null {
-  /** Structured CRDT field that ProseMirror binds to — distinct from the legacy Y.Text('content'). */
+  /** Structured CRDT field that ProseMirror binds to. */
   const fragment = useMemo(() => doc.getXmlFragment('default'), [doc])
 
   /** CollaborationCaret expects a provider-shaped `{ awareness }` object. */

package/features/documents/src/use-documents-presence-access.ts

@@ -96,13 +96,11 @@ function peerToDocumentsParticipant(peer: PresencePeerClient): DocumentsPresence
   const participant: DocumentsPresenceParticipant = {
     clientId: 0,
     userId: peer.userId,
-    name: peer.userName?.trim() || peer.userEmail?.trim() || 'Guest',
+    name: peer.userName?.trim() || 'Guest',
     mode,
     typing: state.typing === true,
     isSelf: false,
   }
-  if (peer.userEmail) participant.email = peer.userEmail
-  if (peer.userImageUrl) participant.imageUrl = peer.userImageUrl
   if (lastTypedAt != null) participant.lastTypedAt = lastTypedAt
   return participant
 }

package/features/tasks/src/TasksPage.tsx

@@ -460,7 +460,10 @@ export default function TasksPage({ className }: TasksPageProps) {
   const handleUnclaim = async (challenge: { recordId: string; data: Challenge }) => {
     await put(challenge.recordId, {
       ...challenge.data,
-      claimedById: undefined,
+      // Empty strings are normalized to SQL NULL by the record writer. The
+      // read model omits null database fields, so this also keeps Challenge's
+      // optional-string shape honest.
+      claimedById: '',
     })
   }
 
@@ -469,8 +472,8 @@ export default function TasksPage({ className }: TasksPageProps) {
     await put(submitChallenge.recordId, {
       ...submitChallenge.data,
       submitted: true,
-      submissionUrl: url || undefined,
-      submissionNotes: notes || undefined,
+      submissionUrl: url,
+      submissionNotes: notes,
     })
     setSubmitChallenge(null)
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepspace",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "engines": {
     "node": ">=22.15.0 <23 || >=24 <25 || >=26 <27"
   },