syntaur 0.1.2 → 0.1.5

package/README.md

@@ -114,3 +114,31 @@ Repo-local plugin linking for development:
 npx syntaur@latest install-plugin --link
 npx syntaur@latest install-codex-plugin --link
 ```
+
+## Release Publishing
+
+This repo is set up for npm trusted publishing from GitHub Actions.
+
+Release flow:
+
+```bash
+npm version patch
+git push origin main
+git push origin v$(node -p "require('./package.json').version")
+```
+
+The publish workflow lives at `.github/workflows/publish.yml` and only runs on version tags like `v0.1.4`. It checks that the tag matches `package.json`, runs the repo validation, and then publishes to npm using GitHub OIDC instead of a long-lived npm token.
+
+One-time npm setup:
+
+- package: `syntaur`
+- GitHub repo: `prong-horn/syntaur`
+- workflow filename: `publish.yml`
+
+You can configure the trusted publisher either in the npm package settings UI or with npm CLI `11.10+`:
+
+```bash
+npx npm@^11.10.0 trust github syntaur --repo prong-horn/syntaur --file publish.yml -y
+```
+
+After trusted publishing is working, npm recommends switching the package publishing access to `Require two-factor authentication and disallow tokens`.

package/dist/index.js

@@ -4773,6 +4773,7 @@ Use --slug to specify a different slug.`
 // src/commands/dashboard.ts
 init_config2();
 import { spawn } from "child_process";
+import { createServer as createNetServer } from "net";
 import { resolve as resolve18, dirname as dirname5 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 
@@ -7234,14 +7235,51 @@ function resolveDashboardMode(options) {
   }
   return "static";
 }
+async function isPortAvailable(port) {
+  return new Promise((resolveAvailability) => {
+    const tester = createNetServer();
+    tester.once("error", () => {
+      resolveAvailability(false);
+    });
+    tester.once("listening", () => {
+      tester.close(() => resolveAvailability(true));
+    });
+    tester.listen(port, "127.0.0.1");
+  });
+}
+async function findAvailablePort(startPort, maxAttempts = 20) {
+  for (let offset = 0; offset < maxAttempts; offset += 1) {
+    const candidate = startPort + offset;
+    if (candidate > 65535) {
+      break;
+    }
+    if (await isPortAvailable(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+}
 async function dashboardCommand(options) {
   const config = await readConfig();
   const missionsDir = config.defaultMissionDir;
-  const port = parseInt(options.port, 10);
-  if (isNaN(port) || port < 1 || port > 65535) {
+  const requestedPort = parseInt(options.port, 10);
+  if (isNaN(requestedPort) || requestedPort < 1 || requestedPort > 65535) {
     throw new Error(`Invalid port "${options.port}". Must be a number between 1 and 65535.`);
   }
   const mode = resolveDashboardMode(options);
+  let port = requestedPort;
+  if (options.autoPort) {
+    const availablePort = await findAvailablePort(requestedPort);
+    if (availablePort === null) {
+      throw new Error(
+        `Could not find an available dashboard port starting at ${requestedPort}. Run "syntaur dashboard --port <number>" to choose one manually.`
+      );
+    }
+    if (availablePort !== requestedPort) {
+      console.log(`Port ${requestedPort} is busy. Launching the dashboard on port ${availablePort} instead.`);
+    }
+    port = availablePort;
+  }
   const server = createDashboardServer({
     port,
     missionsDir,
@@ -8343,6 +8381,19 @@ import { createInterface } from "readline/promises";
 function isInteractiveTerminal() {
   return Boolean(input.isTTY && output.isTTY);
 }
+function parseConfirmAnswer(answer, defaultValue = false) {
+  const normalized = answer.trim().toLowerCase();
+  if (normalized === "") {
+    return defaultValue;
+  }
+  if (normalized === "y" || normalized === "yes") {
+    return true;
+  }
+  if (normalized === "n" || normalized === "no") {
+    return false;
+  }
+  return null;
+}
 async function confirmPrompt(question, defaultValue = false) {
   if (!isInteractiveTerminal()) {
     throw new Error("Interactive confirmation requires a TTY.");
@@ -8350,11 +8401,14 @@ async function confirmPrompt(question, defaultValue = false) {
   const suffix = defaultValue ? " [Y/n] " : " [y/N] ";
   const rl = createInterface({ input, output });
   try {
-    const answer = (await rl.question(`${question}${suffix}`)).trim().toLowerCase();
-    if (answer === "") {
-      return defaultValue;
+    while (true) {
+      const answer = await rl.question(`${question}${suffix}`);
+      const parsed = parseConfirmAnswer(answer, defaultValue);
+      if (parsed !== null) {
+        return parsed;
+      }
+      console.log("Enter y, yes, n, no, or press Enter for the default.");
     }
-    return answer === "y" || answer === "yes";
   } finally {
     rl.close();
   }
@@ -8591,7 +8645,7 @@ async function setupCommand(options) {
       targetDir: options.claudeDir,
       promptForTarget: !options.yes
     });
-  } else if (!interactive && !options.yes && !initialized) {
+  } else {
     console.log(`Skip Claude plugin for now. Install later with: ${getPluginInstallCommand("claude")}`);
   }
   if (installCodex) {
@@ -8600,12 +8654,22 @@ async function setupCommand(options) {
       marketplacePath: options.codexMarketplacePath,
       promptForTarget: !options.yes
     });
-  } else if (!interactive && !options.yes && !initialized) {
+  } else {
     console.log(`Skip Codex plugin for now. Install later with: ${getPluginInstallCommand("codex")}`);
   }
   if (launchDashboard) {
+    const preferredPort = 4800;
+    const port = await findAvailablePort(preferredPort);
+    if (port === null) {
+      throw new Error(
+        `Could not find an available dashboard port starting at ${preferredPort}. Run "syntaur dashboard --port <number>" to choose one manually.`
+      );
+    }
+    if (port !== preferredPort) {
+      console.log(`Port ${preferredPort} is busy. Launching the dashboard on port ${port} instead.`);
+    }
     await dashboardCommand({
-      port: "4800",
+      port: String(port),
       dev: false,
       serverOnly: false,
       apiOnly: false,
@@ -9384,9 +9448,13 @@ program.command("create-assignment").description("Create a new assignment within
     process.exit(1);
   }
 });
-program.command("dashboard").description("Start the local Syntaur dashboard web UI").option("--port <number>", "Port to run the dashboard on", "4800").option("--dev", "Run the dashboard with the Vite dev server", false).option("--server-only", "Run only the API server without any UI", false).option("--api-only", "Deprecated alias for --server-only", false).option("--no-open", "Do not automatically open the browser").action(async (options) => {
+program.command("dashboard").description("Start the local Syntaur dashboard web UI").option("--port <number>", "Port to run the dashboard on", "4800").option("--dev", "Run the dashboard with the Vite dev server", false).option("--server-only", "Run only the API server without any UI", false).option("--api-only", "Deprecated alias for --server-only", false).option("--no-open", "Do not automatically open the browser").action(async (options, command) => {
   try {
-    await dashboardCommand(options);
+    const autoPort = command.getOptionValueSource("port") !== "cli";
+    await dashboardCommand({
+      ...options,
+      autoPort
+    });
   } catch (error) {
     console.error(
       "Error:",