add docstrings to workspace directory functions

Author: rnunley-nmg

frontend/app/tab/workspaceswitcher.tsx

@@ -150,14 +150,26 @@ interface PreviewViewModel extends BlockAwareViewModel {
     goHistory: (path: string) => Promise<void>;
 }
 
+/**
+ * Type guard that checks if a ViewModel has block awareness (blockId and blockAtom properties).
+ */
 function isBlockAwareViewModel(viewModel: ViewModel): viewModel is BlockAwareViewModel {
     return "blockId" in viewModel && "blockAtom" in viewModel;
 }
 
+/**
+ * Type guard that checks if a ViewModel is a preview view with navigation capabilities.
+ */
 function isPreviewViewModel(viewModel: ViewModel): viewModel is PreviewViewModel {
     return viewModel.viewType === "preview" && isBlockAwareViewModel(viewModel) && "goHistory" in viewModel;
 }
 
+/**
+ * Updates all local blocks to use a new workspace directory.
+ * For preview blocks, navigates to the new directory.
+ * For terminal blocks, sends a cd command to change to the new directory.
+ * Skips blocks that have a remote connection.
+ */
 async function updateBlocksWithNewDirectory(newDirectory: string): Promise<void> {
     const allModels = getAllBlockComponentModels();
     for (const model of allModels) {

pkg/blockcontroller/shellcontroller.go

@@ -721,6 +721,8 @@ func createCmdStrAndOpts(blockId string, blockMeta waveobj.MetaMapType, connName
 	return cmdStr, &cmdOpts, nil
 }
 
+// getWorkspaceInfo retrieves the workspace ID and directory for a given tab.
+// Returns empty strings if the tab ID is empty or if the workspace cannot be found.
 func getWorkspaceInfo(ctx context.Context, tabId string) (wsId string, wsDir string) {
 	if tabId == "" {
 		return "", ""