@agent-native/core 0.164.12 → 0.164.15

package/corpus/templates/content/app/routes/_app.local-files.tsx

@@ -45,6 +45,12 @@ import {
   syncLocalControlResources,
   type LocalControlResourceFiles,
 } from "@/lib/local-control-resources";
+import {
+  connectTemporaryLocalFolder,
+  rememberLiveLocalFolderSource,
+  requestLiveLocalFolderActivation,
+  syncLiveLocalFolder,
+} from "@/lib/local-folder-live-sync";
 import {
   hasInterruptedNativeFolderPickerAttempt,
   runNativeFolderPickerWithCrashSentinel,
@@ -149,18 +155,6 @@ interface ManifestFolderSyncResult extends ImportContentSourceResult {
   requestedDocumentId: string | null;
 }
 
-interface RegisterLocalComponentWorkspaceResult {
-  ok: true;
-  workspace: {
-    id: string;
-    workspacePath: string;
-    componentPaths: string[];
-  };
-  componentDirs: string[];
-  componentCount: number;
-  reloadRequired: boolean;
-}
-
 interface RemoveLocalFileSourceResult {
   success: boolean;
   deleted: number;
@@ -269,7 +263,7 @@ function desktopDirectoryFromFolder(
   folder: DesktopContentFilesFolder,
   directories: SelectedDirectory[] = [],
 ): SelectedDirectory {
-  const id = folder.id ?? opaqueDesktopDirectoryId(folder.path ?? folder.name);
+  const id = folder.id ?? opaqueDesktopDirectoryId(folder.name);
   return {
     id,
     kind: "desktop",
@@ -755,6 +749,7 @@ export default function LocalFilesRoute() {
   const targetDatabaseId = searchParams.get("databaseId") || undefined;
   const manifestConnectionId = searchParams.get("connectionId") || undefined;
   const manifestFile = searchParams.get("file") || undefined;
+  const workingCopyId = searchParams.get("workingCopyId") || undefined;
   const workspacePropertyValues = (
     location.state as {
       workspacePropertyValues?: Record<string, unknown>;
@@ -767,6 +762,7 @@ export default function LocalFilesRoute() {
   const [restoringDirectory, setRestoringDirectory] = useState(false);
   const supported = useMemo(supportsLocalFolderSync, []);
   const manifestBootstrapRef = useRef<string | null>(null);
+  const workingCopyBootstrapRef = useRef<string | null>(null);
   const documentSourceDirectories = useMemo(
     () =>
       directories.length === 0
@@ -850,6 +846,59 @@ export default function LocalFilesRoute() {
     targetSpaceId,
   ]);
 
+  useEffect(() => {
+    if (!workingCopyId) return;
+    if (workingCopyBootstrapRef.current === workingCopyId) return;
+    workingCopyBootstrapRef.current = workingCopyId;
+    const desktopFiles = getDesktopContentFiles();
+    if (!desktopFiles) return;
+    setBusy("choose");
+    void desktopFiles
+      .getFolder({ folderId: workingCopyId })
+      .then(async (folderResult) => {
+        if (!folderResult.ok || folderResult.folder.kind !== "temporary") {
+          throw new Error(
+            folderResult.ok
+              ? t("localFiles.chooseAnotherFolder")
+              : folderResult.error,
+          );
+        }
+        const sourceId = await connectTemporaryLocalFolder(folderResult.folder);
+        if (!sourceId) throw new Error(t("localFiles.chooseAnotherFolder"));
+        const outcome = await syncLiveLocalFolder(workingCopyId);
+        if (!outcome.synced) {
+          throw new Error(t("localFiles.chooseAnotherFolder"));
+        }
+        const result = outcome.result as ImportContentSourceResult;
+        const firstDocument = [
+          ...result.created,
+          ...result.updated,
+          ...result.unchanged,
+        ][0];
+        if (!firstDocument)
+          throw new Error(t("localFiles.chooseAnotherFolder"));
+        requestLiveLocalFolderActivation(workingCopyId);
+        await Promise.all([
+          queryClient.invalidateQueries({
+            queryKey: ["action", "list-documents"],
+          }),
+          queryClient.invalidateQueries({
+            queryKey: ["action", "get-content-database"],
+          }),
+        ]);
+        navigate(`/page/${firstDocument.id}`, { replace: true });
+      })
+      .catch((err) => {
+        workingCopyBootstrapRef.current = null;
+        setStatus({
+          kind: "error",
+          title: t("localFiles.pullFailed"),
+          detail: err instanceof Error ? err.message : t("localFiles.tryAgain"),
+        });
+      })
+      .finally(() => setBusy(null));
+  }, [navigate, queryClient, t, workingCopyId]);
+
   useEffect(() => {
     if (!supported) return;
     let cancelled = false;
@@ -937,6 +986,24 @@ export default function LocalFilesRoute() {
         createSourceBackedSpace: !targetSpaceId && !targetDatabaseId,
         propertyValues: workspacePropertyValues,
         truthPolicy: "source_primary",
+        connectionMetadata:
+          directory.kind === "desktop"
+            ? {
+                liveBridgeEnabled: true,
+                repository: directory.folder.repository
+                  ? { localId: directory.folder.repository.localId }
+                  : undefined,
+                workingCopy: {
+                  id: directory.id,
+                  repositoryId: directory.folder.repository?.localId,
+                  kind: directory.folder.kind ?? "persistent",
+                  name: directory.folder.name,
+                  branch: directory.folder.repository?.branch,
+                  commit: directory.folder.repository?.commit,
+                  deviceId: "agent-native-desktop",
+                },
+              }
+            : undefined,
         dryRun,
       } as never,
     );
@@ -1012,6 +1079,16 @@ export default function LocalFilesRoute() {
     if (!connection.sourceId) {
       throw new Error("The local folder connection was not created");
     }
+    if (!dryRun && refreshedDirectory.kind === "desktop") {
+      await rememberLiveLocalFolderSource(
+        refreshedDirectory.folder,
+        connection.sourceId,
+        connection.filesDatabaseId,
+      );
+      await getDesktopContentFiles()?.subscribeChanges?.({
+        folderId: refreshedDirectory.id,
+      });
+    }
     const result = await callAction<ImportContentSourceResult>(
       "sync-local-folder-source" as never,
       {
@@ -1038,29 +1115,6 @@ export default function LocalFilesRoute() {
   ) {
     for (const directory of selectedDirectories) {
       if (directory.kind === "desktop") {
-        const workspacePath = directory.folder.path;
-        if (!workspacePath) continue;
-        try {
-          const result =
-            await callAction<RegisterLocalComponentWorkspaceResult>(
-              "register-local-component-workspace" as never,
-              { workspacePath } as never,
-            );
-          if (result.componentCount > 0 && showToast) {
-            toast.success(t("localFiles.localComponentsConnected"), {
-              description: t("localFiles.localComponentsConnectedDescription"),
-            });
-          }
-        } catch (error) {
-          if (showToast) {
-            toast.info(t("localFiles.localFilesLinked"), {
-              description:
-                error instanceof Error
-                  ? error.message
-                  : t("localFiles.componentPreviewsNeedBridge"),
-            });
-          }
-        }
         continue;
       }
 
@@ -1139,9 +1193,21 @@ export default function LocalFilesRoute() {
         if (!desktopFiles) {
           throw new Error(t("localFiles.desktopFolderUnavailable"));
         }
+        const observed = await desktopFiles.readFiles({
+          folderId: directory.id,
+        });
+        if (!observed.ok) throw new Error(observed.error);
+        const expectedRevisions: Record<string, string | null> = {
+          ...(observed.revisions ?? {}),
+        };
+        for (const filePath of Object.keys(files)) {
+          if (!(filePath in expectedRevisions))
+            expectedRevisions[filePath] = null;
+        }
         const result = await desktopFiles.writeFiles({
           folderId: directory.id,
           files,
+          expectedRevisions,
         });
         if (!result.ok) throw new Error(result.error);
         setDirectories((current) =>
@@ -1478,8 +1544,7 @@ export default function LocalFilesRoute() {
                                 ? (directory.sourceRootPath ??
                                   t("localFiles.importedSource"))
                                 : directory.kind === "desktop"
-                                  ? (directory.folder.path ??
-                                    t("localFiles.desktopFolder"))
+                                  ? t("localFiles.desktopFolder")
                                   : t("localFiles.browserFolder")}
                             </div>
                           </div>

package/corpus/templates/content/docs/product/capabilities/content.source.file-folder.md

@@ -22,7 +22,7 @@ proof_requirements:
   ]
 evidence: []
 superseded_by: null
-last_reviewed: "2026-07-29"
+last_reviewed: "2026-08-17"
 ---
 
 # Files and folders as Sources
@@ -58,7 +58,7 @@ Given a browser without bridge authority, when it opens a materialized folder it
 
 ## Current evidence
 
-Donor evidence: `actions/connect-local-folder-source.ts`, `actions/sync-local-folder-source.ts`, `actions/local-folder-source.db.test.ts`, and sidebar source handling establish local-folder substrate. The common heterogeneous folder contract and complete authority/recovery proof remain exploratory.
+Current implementation adds opaque Desktop grants, recursive Markdown materialization, watched reconciliation with a bounded fallback, atomic revision-guarded writes, and local working-copy identity. Focused tests cover the substrate, but packaged real-interface authority, recovery, redaction, and cleanup proof is still pending, and heterogeneous file families remain exploratory. This Capability therefore remains `exploring`.
 
 ## Proof plan
 

package/corpus/templates/content/docs/product/features/content.feature.bring-your-local-work.md

@@ -8,8 +8,8 @@ order: 12
 roadmap_status: "partially_implemented"
 summary: "Open a folder or repository through the same Source model while keeping device authority and browser limitations honest."
 example_workflow: "A developer opens a local documentation folder in Content Desktop, edits the files through Content, sees external file changes synchronize back, and later reads the last synchronized representation from Safari without exposing the folder path."
-works_today: "Local File Mode, manifest-declared workspaces, connected-folder Sources, source-backed Pages, conflict records, and a trusted local bridge already establish substantial foundations."
-remains: "Opening a folder must become effortless, Desktop needs dependable background sync and caching, browser clients need graceful read and queued-write behavior, and the portable vault workflow needs full product polish."
+works_today: "Local File Mode, connected-folder Sources, source-backed Pages, Desktop folder grants, watched reconciliation, revision-guarded writes, and named local working-copy identity establish the first end-to-end local Markdown path behind its release flag."
+remains: "The packaged Desktop story still needs independent H1-H10 acceptance before release; broader file families, queued remote writes, and provider-bound GitHub review remain later increments."
 required_capabilities:
   [
     "content.source.local-bridge",
@@ -22,7 +22,7 @@ enhancing_capabilities:
 increments: []
 feature_proof: null
 publicness: "public"
-last_reviewed: "2026-07-29"
+last_reviewed: "2026-08-17"
 ---
 
 # Feature 12: Bring your local work

package/corpus/templates/content/docs/product/roadmap.md

@@ -336,9 +336,9 @@ Open a folder or repository through the same Source model while keeping device a
 
 **Example workflow:** A developer opens a local documentation folder in Content Desktop, edits the files through Content, sees external file changes synchronize back, and later reads the last synchronized representation from Safari without exposing the folder path.
 
-**What works today:** Local File Mode, manifest-declared workspaces, connected-folder Sources, source-backed Pages, conflict records, and a trusted local bridge already establish substantial foundations.
+**What works today:** Local File Mode, connected-folder Sources, source-backed Pages, Desktop folder grants, watched reconciliation, revision-guarded writes, and named local working-copy identity establish the first end-to-end local Markdown path behind its release flag.
 
-**What remains:** Opening a folder must become effortless, Desktop needs dependable background sync and caching, browser clients need graceful read and queued-write behavior, and the portable vault workflow needs full product polish.
+**What remains:** The packaged Desktop story still needs independent H1-H10 acceptance before release; broader file families, queued remote writes, and provider-bound GitHub review remain later increments.
 
 **What this Feature includes:**