Add project root detection utils to notebook_tools

- Create utils module with project_root.py
- Add find_project_root() and set_project_root() functions
- Use project-specific markers for reliable detection
- Enable consistent root detection across all notebooks

Author: iTrauco

lib/notebook_tools/utils/__init__.py

@@ -0,0 +1,6 @@
+# lib/notebook_tools/utils/__init__.py
+"""Utility modules for notebook tools."""
+
+from .project_root import find_project_root, set_project_root
+
+__all__ = ["find_project_root", "set_project_root"]

lib/notebook_tools/utils/project_root.py

@@ -0,0 +1,32 @@
+# lib/notebook_tools/utils/project_root.py
+"""Project root detection utilities."""
+
+import os
+from pathlib import Path
+
+
+def find_project_root():
+    """Auto-detect project root by finding marker files."""
+    current = Path.cwd()
+    # Use specific files from your project
+    markers = ['environment.yml', 'PROVENANCE.md', 'scripts/setup_experiments_structure.sh']
+    
+    for path in [current] + list(current.parents):
+        if any((path / marker).exists() for marker in markers):
+            return path
+        # Stop at filesystem root
+        if path == path.parent:
+            break
+    return current
+
+
+def set_project_root():
+    """
+    Set working directory to project root and return path.
+    
+    Returns:
+        Path: Project root directory after changing to it
+    """
+    project_root = find_project_root()
+    os.chdir(project_root)
+    return project_root

notebooks/templates/01_preprocessing.working.ipynb

@@ -36,26 +36,85 @@
     "<!-- TOC -->"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "17947ae6-b8e5-429f-a7ca-defdd4908b5f",
+   "metadata": {},
+   "source": [
+    "## Confirm Directory Structure\n",
+    "\n",
+    "Validates project directories exist at root level."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "1c55d534-4c27-4620-a2f2-496bf78e50c3",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Current dir: /home/trauco/experiments-framework/notebooks/templates\n",
+      "Project root: /home/trauco/experiments-framework\n",
+      "✓ data/raw\n",
+      "✓ data/clips\n",
+      "✓ data/frames\n",
+      "✓ configs\n",
+      "✓ models\n",
+      "✓ lib\n",
+      "✓ notebooks\n"
+     ]
+    }
+   ],
+   "source": [
+    "import sys\n",
+    "import os\n",
+    "from pathlib import Path\n",
+    "\n",
+    "# show current location\n",
+    "print(f\"Current dir: {Path.cwd()}\")\n",
+    "\n",
+    "# manual path to project\n",
+    "project_root = Path('/home/trauco/experiments-framework')\n",
+    "os.chdir(project_root)\n",
+    "print(f\"Project root: {project_root}\")\n",
+    "\n",
+    "# add lib to path\n",
+    "lib_path = project_root / 'lib'\n",
+    "if str(lib_path) not in sys.path:\n",
+    "    sys.path.insert(0, str(lib_path))\n",
+    "\n",
+    "# verify structure\n",
+    "dirs = ['data/raw', 'data/clips', 'data/frames', 'configs', 'models', 'lib', 'notebooks']\n",
+    "for dir_path in dirs:\n",
+    "    if Path(dir_path).exists():\n",
+    "        print(f\"✓ {dir_path}\")\n",
+    "    else:\n",
+    "        print(f\"✗ {dir_path}\")"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "fc72b50c-ad28-481e-b9e2-3b08c7a93c69",
+   "id": "edbb48e5-ba73-4735-8b98-24b706b05f08",
    "metadata": {},
    "outputs": [],
    "source": []
   },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "4a9712a5-7ebe-4a24-aabc-9b7a59a4df4b",
+   "id": "644b0c3b-a587-4609-b246-bdbeec2f91b8",
    "metadata": {},
    "outputs": [],
    "source": []
   },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "40a0baf8-b339-4639-a190-3e86632739f0",
+   "id": "8757f9a5-43d5-4266-b15f-9cd407e24801",
    "metadata": {},
    "outputs": [],
    "source": []