claude: Add --dev flag to quarto run command

Add a --dev flag to `quarto run` that uses the main development import map
(src/import_map.json) instead of the user-facing run_import_map.json. This
allows internal development tools (like import-report scripts) to access
the full quarto development environment including deno_ral and other
internal modules.

Not visible for end users; description is for documentation purposes only.

Usage:
  quarto run --dev script.ts [args...]

The --dev flag should be used for internal quarto development tools that
import from src/deno_ral or src/core. User-facing scripts should continue
to use the standard `quarto run` without --dev.

Co-Authored-By: Claude <noreply@anthropic.com>

Author: gordonwoodhull

src/command/run/run.ts

@@ -12,7 +12,15 @@ import { handlerForScript } from "../../core/run/run.ts";
 import { exitWithCleanup } from "../../core/cleanup.ts";
 
 export async function runScript(args: string[], env?: Record<string, string>) {
-  const script = args[0];
+  // Check for --dev flag
+  let dev = false;
+  let scriptArgs = args;
+  if (args[0] === "--dev") {
+    dev = true;
+    scriptArgs = args.slice(1);
+  }
+
+  const script = scriptArgs[0];
   if (!script) {
     error("quarto run: no script specified");
     exitWithCleanup(1);
@@ -29,7 +37,10 @@ export async function runScript(args: string[], env?: Record<string, string>) {
     exitWithCleanup(1);
     throw new Error(); // unreachable
   }
-  return await handler.run(script, args.slice(1), undefined, { env });
+  return await handler.run(script, scriptArgs.slice(1), undefined, {
+    env,
+    dev,
+  });
 }
 
 // run 'command' (this is a fake command that is here just for docs,
@@ -42,4 +53,7 @@ export const runCommand = new Command()
     "Run a TypeScript, R, Python, or Lua script.\n\n" +
       "Run a utility script written in a variety of languages. For details, see:\n" +
       "https://quarto.org/docs/projects/scripts.html#periodic-scripts",
-  );
+  )
+  .option("--dev", "Use development import map (when running from source)", {
+    hidden: true,
+  });

src/core/run/deno.ts

@@ -34,7 +34,17 @@ export const denoRunHandler: RunHandler = {
       },
     };
 
-    const importMap = normalize(join(denoDir, "../run_import_map.json"));
+    // Choose import map based on --dev flag
+    let importMap: string;
+    if (options?.dev) {
+      // Use main dev import map for internal development tools
+      const srcDir = Deno.env.get("QUARTO_SRC_PATH") ||
+        join(quartoConfig.sharePath(), "../../src");
+      importMap = normalize(join(srcDir, "import_map.json"));
+    } else {
+      // Use user-facing run import map
+      importMap = normalize(join(denoDir, "../run_import_map.json"));
+    }
 
     const noNet = Deno.env.get("QUARTO_RUN_NO_NETWORK") === "true";
 

src/core/run/types.ts

@@ -12,6 +12,7 @@ export interface RunHandlerOptions {
     [key: string]: string;
   };
   stdout?: "inherit" | "piped" | "null";
+  dev?: boolean;
 }
 
 export interface RunHandler {