@xera-ai/cli 0.8.1 → 0.9.1

package/dist/index.js

@@ -266,10 +266,36 @@ var TEMPLATE_DIR = TEMPLATE_ROOT;
 
 // src/commands/init.ts
 var require2 = createRequire(import.meta.url);
+function cancel2() {
+  p.cancel("Aborted.");
+  process.exit(0);
+}
+async function prompt(flag, defaultValue, ask) {
+  if (flag !== undefined)
+    return flag;
+  if (defaultValue !== undefined)
+    return defaultValue;
+  const val = await ask();
+  if (typeof val === "symbol")
+    cancel2();
+  return val;
+}
 async function initCommand(opts) {
   const cwd = process.cwd();
+  if (!process.stdin.isTTY && !opts.yes) {
+    console.error(pc2.red(`
+  error: stdin is not a TTY \u2014 interactive prompts cannot run.
+`));
+    console.error(`  Pass ${pc2.cyan("-y / --yes")} and use flags to run non-interactively:
+`);
+    console.error(`    xera init -y --shape web --pk MYPROJ --ju https://myco.atlassian.net
+`);
+    console.error(`  Run ${pc2.cyan("xera init --help")} to see all available flags.
+`);
+    process.exit(1);
+  }
   p.intro(pc2.cyan("xera \u2014 project setup"));
-  const shape = opts.shape ?? (opts.yes ? "web" : await p.select({
+  const shape = await prompt(opts.shape, opts.yes ? "web" : undefined, () => p.select({
     message: "What kind of testing does this project do?",
     initialValue: "web",
     options: [
@@ -278,68 +304,37 @@ async function initCommand(opts) {
       { value: "mixed", label: "Both (some UI tickets, some API tickets, in one repo)" }
     ]
   }));
-  if (typeof shape === "symbol") {
-    p.cancel("Aborted.");
-    process.exit(0);
-  }
   const wantsWeb = shape === "web" || shape === "mixed";
   const wantsHttp = shape === "api" || shape === "mixed";
-  const baseAnswers = opts.yes ? {
-    jiraBaseUrl: "https://example.atlassian.net",
-    projectKeys: "JIRA",
-    storyField: "description",
-    acceptanceCriteriaField: ""
-  } : await p.group({
-    jiraBaseUrl: () => p.text({ message: "Jira workspace URL", placeholder: "https://x.atlassian.net" }),
-    projectKeys: () => p.text({
-      message: "Jira project key(s) (comma-separated)",
-      placeholder: "JIRA"
-    }),
-    storyField: () => p.text({ message: "Jira field id for user story", initialValue: "description" }),
-    acceptanceCriteriaField: () => p.text({
-      message: "Jira field id for AC (leave empty if same as story)",
-      initialValue: ""
-    })
-  }, {
-    onCancel: () => {
-      p.cancel("Aborted.");
-      process.exit(0);
-    }
-  });
-  const webAnswers = !wantsWeb ? null : opts.yes ? { stagingUrl: "http://localhost:3000", authEnabled: true, roles: "admin,regular" } : await p.group({
-    stagingUrl: () => p.text({
+  const jiraBaseUrl = await prompt(opts.jiraBaseUrl, opts.yes ? "https://example.atlassian.net" : undefined, () => p.text({ message: "Jira workspace URL", placeholder: "https://x.atlassian.net" }));
+  const projectKeys = await prompt(opts.projectKeys, opts.yes ? "JIRA" : undefined, () => p.text({ message: "Jira project key(s) (comma-separated)", placeholder: "JIRA" }));
+  const storyField = await prompt(opts.storyField, opts.yes ? "description" : undefined, () => p.text({ message: "Jira field id for user story", initialValue: "description" }));
+  const acceptanceCriteriaField = await prompt(opts.acField, opts.yes ? "" : undefined, () => p.text({
+    message: "Jira field id for AC (leave empty if same as story)",
+    initialValue: ""
+  }));
+  let stagingUrl = "";
+  let authEnabled = false;
+  let roles = "";
+  if (wantsWeb) {
+    stagingUrl = await prompt(opts.stagingUrl, opts.yes ? "http://localhost:3000" : undefined, () => p.text({
       message: "Web app staging URL",
       placeholder: "https://staging.example.com"
-    }),
-    authEnabled: () => p.confirm({
-      message: "Does your app require login to test most pages?",
-      initialValue: true
-    }),
-    roles: () => p.text({
-      message: "Test user roles (comma-separated)",
-      initialValue: "admin,regular"
-    })
-  }, {
-    onCancel: () => {
-      p.cancel("Aborted.");
-      process.exit(0);
-    }
-  });
-  const httpAnswers = !wantsHttp ? null : opts.yes ? {
-    apiBaseUrl: "http://localhost:4111",
-    openapiPath: "./openapi.yaml",
-    authStrategy: "bearer",
-    httpRoles: "user"
-  } : await p.group({
-    apiBaseUrl: () => p.text({
-      message: "API base URL",
-      placeholder: "https://api.staging.example.com"
-    }),
-    openapiPath: () => p.text({
+    }));
+    authEnabled = await prompt(opts.authEnabled, opts.yes ? true : undefined, () => p.confirm({ message: "Does your app require login to test most pages?", initialValue: true }));
+    roles = await prompt(opts.roles, opts.yes ? "admin,regular" : undefined, () => p.text({ message: "Test user roles (comma-separated)", initialValue: "admin,regular" }));
+  }
+  let apiBaseUrl = "";
+  let openapiPath = "";
+  let authStrategy = "none";
+  let httpRoles = "";
+  if (wantsHttp) {
+    apiBaseUrl = await prompt(opts.apiBaseUrl, opts.yes ? "http://localhost:4111" : undefined, () => p.text({ message: "API base URL", placeholder: "https://api.staging.example.com" }));
+    openapiPath = await prompt(opts.openapiPath, opts.yes ? "./openapi.yaml" : undefined, () => p.text({
       message: "OpenAPI spec path (relative or URL \u2014 leave empty to skip)",
       initialValue: "./openapi.yaml"
-    }),
-    authStrategy: () => p.select({
+    }));
+    authStrategy = await prompt(opts.authStrategy, opts.yes ? "bearer" : undefined, () => p.select({
       message: "API auth strategy",
       initialValue: "bearer",
       options: [
@@ -349,29 +344,24 @@ async function initCommand(opts) {
         { value: "oauth-cc", label: "OAuth client_credentials" },
         { value: "none", label: "None / public API" }
       ]
-    }),
-    httpRoles: () => p.text({ message: "HTTP roles (comma-separated)", initialValue: "user" })
-  }, {
-    onCancel: () => {
-      p.cancel("Aborted.");
-      process.exit(0);
-    }
-  });
+    }));
+    httpRoles = await prompt(opts.httpRoles, opts.yes ? "user" : undefined, () => p.text({ message: "HTTP roles (comma-separated)", initialValue: "user" }));
+  }
   const vars = {
     shape,
     wantsWeb,
     wantsHttp,
-    jiraBaseUrl: baseAnswers.jiraBaseUrl,
-    projectKeys: baseAnswers.projectKeys.split(",").map((s) => s.trim()).filter(Boolean),
-    storyField: baseAnswers.storyField,
-    acceptanceCriteriaField: baseAnswers.acceptanceCriteriaField,
-    stagingUrl: webAnswers?.stagingUrl ?? "",
-    authEnabled: !!webAnswers?.authEnabled,
-    roles: webAnswers ? webAnswers.roles.split(",").map((s) => s.trim()).filter(Boolean) : [],
-    apiBaseUrl: httpAnswers?.apiBaseUrl ?? "",
-    openapiPath: httpAnswers?.openapiPath ?? "",
-    authStrategy: httpAnswers?.authStrategy ?? "none",
-    httpRoles: httpAnswers ? httpAnswers.httpRoles.split(",").map((s) => s.trim()).filter(Boolean) : [],
+    jiraBaseUrl,
+    projectKeys: projectKeys.split(",").map((s) => s.trim()).filter(Boolean),
+    storyField,
+    acceptanceCriteriaField,
+    stagingUrl,
+    authEnabled,
+    roles: roles ? roles.split(",").map((s) => s.trim()).filter(Boolean) : [],
+    apiBaseUrl,
+    openapiPath,
+    authStrategy,
+    httpRoles: httpRoles ? httpRoles.split(",").map((s) => s.trim()).filter(Boolean) : [],
     authKey: generateKey()
   };
   const configTmpl = shape === "web" ? "xera.config.ts.tmpl" : shape === "api" ? "http-xera.config.ts.tmpl" : "mixed-xera.config.ts.tmpl";
@@ -585,11 +575,50 @@ async function initUpdateCommand(_opts) {
 var require4 = createRequire3(import.meta.url);
 var VERSION = require4("../package.json").version;
 var VALID_SHAPES = ["web", "api", "mixed"];
+var VALID_AUTH_STRATEGIES = ["bearer", "apiKey", "basic", "oauth-cc", "none"];
+var KNOWN_COMMANDS = ["init", "doctor"];
+function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  const dp = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_2, j) => i === 0 ? j : j === 0 ? i : 0));
+  for (let i = 1;i <= m; i++) {
+    for (let j = 1;j <= n; j++) {
+      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    }
+  }
+  return dp[m][n];
+}
+function didYouMean(input) {
+  let best;
+  let bestDist = Number.POSITIVE_INFINITY;
+  for (const cmd of KNOWN_COMMANDS) {
+    const d = levenshtein(input.toLowerCase(), cmd);
+    if (d < bestDist) {
+      bestDist = d;
+      best = cmd;
+    }
+  }
+  return bestDist <= 3 ? best : undefined;
+}
+function unknownCommand(input) {
+  console.error(pc4.red(`
+  error: Unknown command '${input}'
+`));
+  const suggestion = didYouMean(input);
+  if (suggestion) {
+    console.error(`  Did you mean ${pc4.cyan(suggestion)}?
+`);
+  }
+  console.error(`  Run ${pc4.cyan("xera --help")} to see available commands.
+`);
+  process.exit(1);
+}
 async function main() {
   const cli = cac("xera");
   cli.help();
   cli.version(VERSION);
-  cli.command("init", "Scaffold a new xera project in the current directory").option("--update", "Non-destructive refresh of an existing project").option("-y, --yes", "Accept all defaults (non-interactive)").option("--shape <shape>", "Project shape: web | api | mixed").action(async (opts) => {
+  cli.usage("<command> [options]");
+  cli.command("init", "Scaffold a new xera project in the current directory").option("--update", "Non-destructive refresh of an existing project").option("-y, --yes", "Accept all defaults (non-interactive)").option("--shape <shape>", "Project shape: web | api | mixed").option("--ju, --jira-base-url <url>", "Jira workspace URL").option("--pk, --project-keys <keys>", "Jira project key(s), comma-separated").option("--sf, --story-field <field>", "Jira field id for user story (default: description)").option("--ac, --ac-field <field>", "Jira field id for acceptance criteria").option("--su, --staging-url <url>", "Web app staging URL").option("--auth-enabled", "App requires login to test most pages").option("--no-auth-enabled", "App does not require login").option("--ro, --roles <roles>", "Test user roles, comma-separated (default: admin,regular)").option("--au, --api-base-url <url>", "API base URL").option("--op, --openapi-path <path>", "OpenAPI spec path or URL").option("--as, --auth-strategy <strategy>", `API auth strategy: ${VALID_AUTH_STRATEGIES.join(" | ")}`).option("--hr, --http-roles <roles>", "HTTP test roles, comma-separated (default: user)").example("xera init").example("xera init -y --shape web").example("xera init -y --shape api --pk MYPROJ --ju https://myco.atlassian.net --au https://api.staging.example.com --as bearer").example("xera init -y --shape mixed --pk PROJ --ju https://myco.atlassian.net --su https://staging.example.com --au https://api.staging.example.com").action(async (opts) => {
     if (opts.update) {
       await initUpdateCommand({ yes: !!opts.yes });
       return;
@@ -597,22 +626,64 @@ async function main() {
     const initOpts = { yes: !!opts.yes };
     if (opts.shape !== undefined) {
       if (!VALID_SHAPES.includes(opts.shape)) {
-        console.error(pc4.red(`[xera] --shape must be one of: ${VALID_SHAPES.join(", ")}`));
+        console.error(pc4.red(`
+  error: --shape must be one of: ${VALID_SHAPES.join(", ")}
+`));
         process.exit(1);
       }
       initOpts.shape = opts.shape;
     }
+    if (opts.authStrategy !== undefined) {
+      if (!VALID_AUTH_STRATEGIES.includes(opts.authStrategy)) {
+        console.error(pc4.red(`
+  error: --auth-strategy must be one of: ${VALID_AUTH_STRATEGIES.join(", ")}
+`));
+        process.exit(1);
+      }
+      initOpts.authStrategy = opts.authStrategy;
+    }
+    if (opts.jiraBaseUrl !== undefined)
+      initOpts.jiraBaseUrl = opts.jiraBaseUrl;
+    if (opts.projectKeys !== undefined)
+      initOpts.projectKeys = opts.projectKeys;
+    if (opts.storyField !== undefined)
+      initOpts.storyField = opts.storyField;
+    if (opts.acField !== undefined)
+      initOpts.acField = opts.acField;
+    if (opts.stagingUrl !== undefined)
+      initOpts.stagingUrl = opts.stagingUrl;
+    if (opts.authEnabled !== undefined)
+      initOpts.authEnabled = opts.authEnabled;
+    if (opts.roles !== undefined)
+      initOpts.roles = opts.roles;
+    if (opts.apiBaseUrl !== undefined)
+      initOpts.apiBaseUrl = opts.apiBaseUrl;
+    if (opts.openapiPath !== undefined)
+      initOpts.openapiPath = opts.openapiPath;
+    if (opts.httpRoles !== undefined)
+      initOpts.httpRoles = opts.httpRoles;
     await initCommand(initOpts);
   });
   cli.command("doctor", "Run a health check").option("--strict <ticket>", "Treat ticket-specific checks as required").option("--logs <ticket>", "Pretty-print xera.log for a ticket").option("--usage", "Show token/usage summary from recent runs").action(async (opts) => {
     const exit = await doctorCommand(opts);
     process.exit(exit);
   });
+  const rawArgs = process.argv.slice(2);
+  if (rawArgs.length === 0) {
+    cli.outputHelp();
+    process.exit(0);
+  }
+  const firstArg = rawArgs[0];
+  if (!firstArg.startsWith("-") && !KNOWN_COMMANDS.includes(firstArg)) {
+    unknownCommand(firstArg);
+  }
   try {
     cli.parse(process.argv, { run: false });
     await cli.runMatchedCommand();
   } catch (e) {
-    console.error(pc4.red(`[xera] ${e.message}`));
+    console.error(pc4.red(`
+  error: ${e.message}
+`));
     process.exit(1);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xera-ai/cli",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "type": "module",
   "bin": {
     "xera": "./bin/xera"
@@ -15,8 +15,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@xera-ai/core": "^0.8.1",
-    "@xera-ai/skills": "^0.8.1",
+    "@xera-ai/core": "^0.9.1",
+    "@xera-ai/skills": "^0.9.1",
     "@clack/prompts": "1.4.0",
     "cac": "7.0.0",
     "picocolors": "1.1.1"