Improve the recover command (#69)

* Add recover command to dash UI

* Add JSON mode for recover command

* Add dry-run for slurm regenerate

* Add cancel button

* Reorganize docs

Author: daniel-thom

docs/book.toml

@@ -17,7 +17,8 @@ git-repository-url = "https://github.com/NREL/torc"
 edit-url-template = "https://github.com/NREL/torc/edit/main/docs/{path}"
 site-url = "/torc/"
 cname = ""
-additional-js = ["mermaid.min.js", "mermaid-init.js"]
+additional-css = ["custom.css"]
+additional-js = ["mermaid.min.js", "mermaid-init.js", "sidebar-toggle.js"]
 
 [output.html.print]
 enable = true

docs/custom.css

@@ -0,0 +1,5 @@
+/* Hide section numbers on the deepest level (actual content pages like 3.1.1, 3.1.2) */
+/* Target: chapter > section (group headers) > section (content pages) */
+ol.section ol.section > li.chapter-item strong {
+    display: none;
+}

docs/sidebar-toggle.js

@@ -0,0 +1,38 @@
+// Custom sidebar toggle behavior for mdbook
+// When clicking a section title that you're already viewing, toggle collapse instead of reloading
+(() => {
+    document.addEventListener('DOMContentLoaded', () => {
+        const sidebar = document.getElementById('sidebar');
+        if (!sidebar) return;
+
+        sidebar.addEventListener('click', (e) => {
+            // Find the clicked anchor element
+            const link = e.target.closest('a[href]');
+            if (!link) return;
+
+            // Skip if this is a toggle button (those already work correctly)
+            if (link.classList.contains('toggle')) return;
+
+            // Check if this link's parent has a sibling toggle button (meaning it's a collapsible section)
+            const toggleButton = link.parentElement?.querySelector('a.toggle');
+            if (!toggleButton) return;
+
+            // Get the current page URL without hash/query
+            const currentPage = document.location.href.toString().split('#')[0].split('?')[0];
+
+            // Get the link's target URL
+            const linkHref = new URL(link.href, document.location.href).href.split('#')[0].split('?')[0];
+
+            // If we're already on this page, toggle the section instead of navigating
+            if (currentPage === linkHref) {
+                e.preventDefault();
+                e.stopPropagation();
+                // Toggle the expanded class on the parent li
+                const parentLi = link.parentElement;
+                if (parentLi && parentLi.classList.contains('chapter-item')) {
+                    parentLi.classList.toggle('expanded');
+                }
+            }
+        });
+    });
+})();

docs/src/SUMMARY.md

@@ -11,21 +11,23 @@
     - [Quick Start (HPC)](./quick-start-hpc.md)
     - [Quick Start (Remote Workers)](./quick-start-remote.md)
 
-# Understanding Torc
-
 - [Explanation](./explanation/README.md)
-  - [Architecture Overview](./explanation/architecture.md)
-  - [Client](./explanation/client.md)
-  - [Job Runners](./explanation/job-runners.md)
-  - [Job State Transitions](./explanation/job-states.md)
-  - [Environment Variables](./explanation/environment-variables.md)
-  - [Workflow Reinitialization](./explanation/reinitialization.md)
-  - [Workflow Archiving](./explanation/archiving.md)
-  - [Dependency Resolution](./explanation/dependencies.md)
-  - [Parallelization Strategies](./explanation/parallelization.md)
-  - [Workflow Actions](./explanation/workflow-actions.md)
-  - [Slurm Workflows](./explanation/slurm-workflows.md)
-  - [Automatic Failure Recovery](./explanation/automatic-recovery.md)
+  - [Core Concepts]()
+    - [Architecture Overview](./explanation/architecture.md)
+    - [Job State Transitions](./explanation/job-states.md)
+    - [Dependency Resolution](./explanation/dependencies.md)
+  - [Execution]()
+    - [Client](./explanation/client.md)
+    - [Job Runners](./explanation/job-runners.md)
+    - [Parallelization Strategies](./explanation/parallelization.md)
+  - [Workflow Lifecycle]()
+    - [Workflow Actions](./explanation/workflow-actions.md)
+    - [Workflow Reinitialization](./explanation/reinitialization.md)
+    - [Workflow Archiving](./explanation/archiving.md)
+    - [Automatic Failure Recovery](./explanation/automatic-recovery.md)
+  - [Environments]()
+    - [Slurm Workflows](./explanation/slurm-workflows.md)
+    - [Environment Variables](./explanation/environment-variables.md)
   - [Design](./explanation/design/README.md)
     - [Server API Handler](./explanation/design/server.md)
     - [Central Database](./explanation/design/database.md)
@@ -34,27 +36,29 @@
     - [Workflow Graph](./explanation/design/workflow-graph.md)
     - [Interface Architecture](./explanation/design/interfaces.md)
 
-# How-To Guides
-
-- [How-To](./how-to/README.md)
-  - [Configuration Files](./how-to/configuration-files.md)
-  - [Creating Workflows](./how-to/creating-workflows.md)
-  - [Remote Workers](./how-to/remote-workers.md)
-  - [Working with Slurm](./how-to/slurm.md)
-  - [HPC Profiles](./how-to/hpc-profiles.md)
-  - [Job Checkpointing](./how-to/checkpointing.md)
-  - [Resource Monitoring](./how-to/resource-monitoring.md)
-  - [Terminal UI (TUI)](./how-to/tui.md)
-  - [Web Dashboard](./how-to/dashboard.md)
-  - [Visualizing Workflow Structure](./how-to/visualizing-workflows.md)
-  - [Debugging Workflows](./how-to/debugging.md)
-  - [Debugging Slurm Workflows](./how-to/debugging-slurm.md)
-  - [Workflow Reports](./how-to/workflow-reports.md)
-  - [Authentication](./how-to/authentication.md)
-  - [Shell Completions](./how-to/shell-completions.md)
-  - [Server Deployment](./how-to/server-deployment.md)
-
-# Reference
+- [How-To Guides](./how-to/README.md)
+  - [Setup]()
+    - [Configuration Files](./how-to/configuration-files.md)
+    - [Server Deployment](./how-to/server-deployment.md)
+    - [Authentication](./how-to/authentication.md)
+    - [Shell Completions](./how-to/shell-completions.md)
+  - [Workflows]()
+    - [Creating Workflows](./how-to/creating-workflows.md)
+    - [Visualizing Workflow Structure](./how-to/visualizing-workflows.md)
+  - [Execution]()
+    - [Working with Slurm](./how-to/slurm.md)
+    - [HPC Profiles](./how-to/hpc-profiles.md)
+    - [Remote Workers](./how-to/remote-workers.md)
+    - [Job Checkpointing](./how-to/checkpointing.md)
+  - [Monitoring]()
+    - [Terminal UI (TUI)](./how-to/tui.md)
+    - [Web Dashboard](./how-to/dashboard.md)
+    - [Resource Monitoring](./how-to/resource-monitoring.md)
+    - [Workflow Reports](./how-to/workflow-reports.md)
+    - [Configuring AI Assistants](./how-to/ai-assistants.md)
+  - [Troubleshooting]()
+    - [Debugging Workflows](./how-to/debugging.md)
+    - [Debugging Slurm Workflows](./how-to/debugging-slurm.md)
 
 - [Reference](./reference/README.md)
   - [CLI Reference](./reference/cli.md)
@@ -64,28 +68,31 @@
   - [HPC Profiles](./reference/hpc-profiles.md)
   - [HPC Deployment](./reference/hpc-deployment.md)
   - [Resource Monitoring](./reference/resource-monitoring.md)
-  - [OpenAPI Specification](./reference/openapi.md)
   - [Configuration](./reference/configuration.md)
-  - [AI Assistant](./reference/ai-assistant.md)
   - [Security](./reference/security.md)
-
-# Tutorials
+  - [OpenAPI Specification](./reference/openapi.md)
 
 - [Tutorials](./tutorials/README.md)
-  - [Configuration Files](./tutorials/configuration.md)
-  - [Dashboard Deployment](./tutorials/dashboard-deployment.md)
-  - [Workflow Wizard](./tutorials/workflow-wizard.md)
-  - [Many Independent Jobs](./tutorials/many-jobs.md)
-  - [Diamond Workflow](./tutorials/diamond.md)
-  - [User Data Dependencies](./tutorials/user-data.md)
-  - [Simple Parameterization](./tutorials/simple-params.md)
-  - [Advanced Parameterization](./tutorials/advanced-params.md)
-  - [Multi-Stage Workflows with Barriers](./tutorials/multi-stage-barrier.md)
-  - [Map Python functions across workers](./tutorials/map_python_function_across_workers.md)
-  - [Filtering CLI Output with Nushell](./tutorials/filtering-with-nushell.md)
-  - [Custom HPC Profile](./tutorials/custom-hpc-profile.md)
-  - [AI-Assisted Workflow Management](./tutorials/ai-assistant.md)
-  - [Automatic Failure Recovery](./tutorials/automatic-recovery.md)
+  - [Getting Started]()
+    - [Workflow Wizard](./tutorials/workflow-wizard.md)
+  - [Workflow Patterns]()
+    - [Many Independent Jobs](./tutorials/many-jobs.md)
+    - [Diamond Workflow](./tutorials/diamond.md)
+    - [User Data Dependencies](./tutorials/user-data.md)
+  - [Parameterization]()
+    - [Simple Parameterization](./tutorials/simple-params.md)
+    - [Advanced Parameterization](./tutorials/advanced-params.md)
+    - [Multi-Stage Workflows with Barriers](./tutorials/multi-stage-barrier.md)
+  - [Features]()
+    - [Automatic Failure Recovery](./tutorials/automatic-recovery.md)
+    - [AI-Assisted Workflow Management](./tutorials/ai-assistant.md)
+  - [Use Cases]()
+    - [Map Python functions across workers](./tutorials/map_python_function_across_workers.md)
+    - [Custom HPC Profile](./tutorials/custom-hpc-profile.md)
+  - [Tools]()
+    - [Configuration Files](./tutorials/configuration.md)
+    - [Dashboard Deployment](./tutorials/dashboard-deployment.md)
+    - [Filtering CLI Output with Nushell](./tutorials/filtering-with-nushell.md)
 
 ---
 

docs/src/reference/ai-assistant.md docs/src/how-to/ai-assistants.mddocs/src/reference/ai-assistant.md renamed to docs/src/how-to/ai-assistants.md

@@ -1,6 +1,6 @@
-# AI Assistant Reference
+# Configuring AI Assistants
 
-Complete reference for configuring AI assistants (Claude Code, GitHub Copilot) to work with Torc.
+Complete guide for configuring AI assistants (Claude Code, GitHub Copilot) to work with Torc.
 
 ## Overview
 
@@ -267,5 +267,5 @@ remains in Torc's database.
 ## See Also
 
 - [AI-Assisted Workflow Management Tutorial](../tutorials/ai-assistant.md)
-- [Configuration Reference](./configuration.md)
-- [HPC Deployment](./hpc-deployment.md)
+- [Configuration Reference](../reference/configuration.md)
+- [HPC Deployment](../reference/hpc-deployment.md)

docs/src/tutorials/ai-assistant.md

@@ -340,7 +340,7 @@ allocations have been submitted and will execute these jobs automatically.
 
 ## Next Steps
 
-- [AI Assistant Reference](../reference/ai-assistant.md) — Full configuration options, all tools,
+- [Configuring AI Assistants](../how-to/ai-assistants.md) — Full configuration options, all tools,
   troubleshooting
 - [Automatic Failure Recovery](./automatic-recovery.md) — Use `torc watch` for automated recovery
 - [Configuration Files](./configuration.md) — Set up Torc configuration