@sireai/optimus 0.1.21 → 0.1.23

package/dist/cli/optimus.js

@@ -292,12 +292,16 @@ function renderCommandHelp(command) {
             "",
             "Usage:",
             "  optimus submit --title <title> --description <text> [options]",
+            "  optimus submit --title <title> --description-file <path> [options]",
+            "  printf '%s' '<text>' | optimus submit --title <title> --description-stdin [options]",
             "",
             "Required:",
             "  --title <title>              Task title",
             "  --description <text>         Task description",
             "",
             "Common options:",
+            "  --description-file <path>    Read task description from a file",
+            "  --description-stdin          Read task description from stdin",
             "  --repo <alias>               Target registered repository alias",
             "  --task-type <type>           Task type, default bugfix",
             "  --source-ref <id>            External issue key or source reference",
@@ -311,11 +315,17 @@ function renderCommandHelp(command) {
             "",
             "Usage:",
             "  optimus feedback --title <title> --description <text>",
+            "  optimus feedback --title <title> --description-file <path>",
+            "  printf '%s' '<text>' | optimus feedback --title <title> --description-stdin",
             "",
             "Required:",
             "  --title <title>              Feedback title",
             "  --description <text>         Feedback description",
             "",
+            "Optional text sources:",
+            "  --description-file <path>    Read feedback description from a file",
+            "  --description-stdin          Read feedback description from stdin",
+            "",
             "Behavior:",
             "  - writes a local feedback bundle under ~/.optimus/runtime/feedback",
             "  - creates a .tar.gz archive for the bundle",
@@ -325,7 +335,8 @@ function renderCommandHelp(command) {
             "  - sends a Feishu app card message with the feedback document link",
             "",
             "Example:",
-            "  optimus feedback --title \"Upgrade prompt missing\" --description \"upgrade --check found 0.1.14 but start did not open the upgrade prompt.\""
+            "  optimus feedback --title \"Upgrade prompt missing\" --description \"upgrade --check found 0.1.14 but start did not open the upgrade prompt.\"",
+            "  optimus feedback --title \"Shell quoting issue\" --description-file ./feedback.txt"
         ].join("\n"),
         "retry-task": [
             "optimus retry-task",
@@ -675,13 +686,6 @@ function resolveJiraQuickDoctorIssues(config, options) {
             fix: "Rerun `optimus setup` and provide a Jira personal token."
         });
     }
-    if (!config.casCookieName?.trim()) {
-        issues.push({
-            code: "jira_cas_cookie_name_missing",
-            message: "Jira integration is enabled, but Jira CAS cookie name is missing.",
-            fix: "Rerun `optimus setup` and provide the Jira CAS cookie name."
-        });
-    }
     return issues;
 }
 function resolveSentryQuickDoctorIssues(config) {
@@ -1185,9 +1189,6 @@ async function promptSetupAnswers(defaults) {
         const jiraPersonalToken = enableJira
             ? (printSetupHint("Jira personal token: required for Jira reads, comments, and issue submission commands."), (await ask(renderSetupPrompt("Required", "Jira personal token", defaults.jiraPersonalToken ? "configured" : ""))).trim() || defaults.jiraPersonalToken)
             : undefined;
-        const jiraCasCookieName = enableJira
-            ? (printSetupHint("Jira CAS cookie name: optional helper for environments that need refreshed CAS login cookies."), (await ask(renderSetupPrompt("Optional", "Jira CAS cookie name", defaults.jiraCasCookieName ?? "_aegis_cas_p"))).trim() || defaults.jiraCasCookieName || "_aegis_cas_p")
-            : undefined;
         printSetupSection("Sentry", "Optional. Turn this on only if you want this machine to read Sentry events and create tasks from them.");
         printSetupHint("If disabled, Optimus still works; Sentry commands just stay unavailable on this machine.");
         const enableSentryInput = (await ask(renderSetupPrompt("Optional integration", "Enable Sentry integration", defaults.enableSentry ? "Y/n" : "y/N"))).trim().toLowerCase();
@@ -1216,7 +1217,6 @@ async function promptSetupAnswers(defaults) {
             enableJira,
             ...(jiraBaseUrl ? { jiraBaseUrl } : {}),
             ...(jiraPersonalToken ? { jiraPersonalToken } : {}),
-            ...(jiraCasCookieName ? { jiraCasCookieName } : {}),
             ...(defaults.jiraCustomHeaders ? { jiraCustomHeaders: defaults.jiraCustomHeaders } : {}),
             enableSentry,
             ...(sentryBaseUrl ? { sentryBaseUrl } : {}),
@@ -1266,7 +1266,6 @@ async function resolveDefaultSetupAnswers() {
         enableJira: config.jira.enabled,
         ...(config.jira.baseUrl ? { jiraBaseUrl: config.jira.baseUrl } : {}),
         ...(config.jira.personalToken ? { jiraPersonalToken: config.jira.personalToken } : {}),
-        ...(config.jira.casCookieName ? { jiraCasCookieName: config.jira.casCookieName } : {}),
         ...(config.jira.customHeaders ? { jiraCustomHeaders: config.jira.customHeaders } : {}),
         enableSentry: config.sentry.enabled,
         ...(config.sentry.baseUrl ? { sentryBaseUrl: config.sentry.baseUrl } : {}),
@@ -1464,7 +1463,7 @@ function buildSetupConfig(answers, rawConfig) {
         if (answers.jiraPersonalToken) {
             config.jira.personalToken = answers.jiraPersonalToken;
         }
-        config.jira.casCookieName = answers.jiraCasCookieName?.trim() || "_aegis_cas_p";
+        config.jira.casCookieName = "_aegis_cas_p";
         if (answers.jiraCustomHeaders?.trim()) {
             config.jira.customHeaders = answers.jiraCustomHeaders.trim();
         }
@@ -1710,19 +1709,70 @@ function summarizeIssue(issue, fallback) {
     }
     return issue.message.replace(/\.$/u, "");
 }
+function isCodexModelSelectionFailure(healthCheck) {
+    const normalized = healthCheck.summary.toLowerCase();
+    return normalized.includes("model_not_found")
+        || normalized.includes("unsupported model")
+        || normalized.includes("invalid model")
+        || (normalized.includes("requested model") && normalized.includes("does not exist"))
+        || (normalized.includes("model") && normalized.includes("not supported"));
+}
+function isCodexQuotaFailure(healthCheck) {
+    const normalized = healthCheck.summary.toLowerCase();
+    return normalized.includes("quota exceeded")
+        || normalized.includes("billing details")
+        || normalized.includes("insufficient_quota");
+}
+function resolveCodexHealthFailurePresentation(healthCheck) {
+    if (isCodexModelSelectionFailure(healthCheck)) {
+        const model = healthCheck.diagnostics.model?.trim();
+        return {
+            reason: model
+                ? `Configured Codex model is invalid or unsupported: ${model}.`
+                : "Configured Codex model is invalid or unsupported.",
+            fix: "Set `codex.model` to a supported model, then rerun `optimus doctor`."
+        };
+    }
+    if (isCodexQuotaFailure(healthCheck)) {
+        return {
+            reason: "Codex quota is exhausted or billing is unavailable.",
+            fix: "Check the configured OpenAI API key quota and billing status, then rerun `optimus doctor`."
+        };
+    }
+    if (healthCheck.diagnostics.failureCategory === "provider_error") {
+        return {
+            reason: "model provider is unreachable.",
+            fix: "Retry `optimus doctor` after fixing the Codex connection."
+        };
+    }
+    if (healthCheck.diagnostics.failureCategory === "network_error") {
+        return {
+            reason: "network connectivity to Codex is unavailable.",
+            fix: "Retry `optimus doctor` after fixing the Codex connection."
+        };
+    }
+    if (healthCheck.diagnostics.failureCategory === "config_error") {
+        return {
+            reason: "Codex configuration is invalid.",
+            fix: "Review `codex.model`, auth mode, and provider settings, then rerun `optimus doctor`."
+        };
+    }
+    const authFixHint = healthCheck.diagnostics.auth?.fixHint?.trim();
+    const summary = healthCheck.summary.trim().replace(/\.$/u, "");
+    return {
+        reason: summary || "Codex request could not complete.",
+        fix: authFixHint && !healthCheck.diagnostics.auth?.authenticated
+            ? authFixHint
+            : "Inspect the Codex failure reason above, fix it, then rerun `optimus doctor`."
+    };
+}
 function doctorNextActions(quick, healthCheck, delivery) {
     const actions = new Set();
     for (const step of quick.next) {
         actions.add(step);
     }
     if (!healthCheck.ok) {
-        const fixHint = healthCheck.diagnostics.auth?.fixHint?.trim();
-        if (fixHint) {
-            actions.add(fixHint);
-        }
-        else {
-            actions.add("Rerun `optimus setup`.");
-        }
+        actions.add(resolveCodexHealthFailurePresentation(healthCheck).fix);
     }
     if (delivery.status === "not_ok" && delivery.fix) {
         actions.add(delivery.fix);
@@ -1801,6 +1851,7 @@ async function runDoctor(configPath = resolveDefaultConfigPath()) {
         };
     const authDiagnostics = healthCheck.diagnostics.auth;
     const codexIssue = quick.blocking.find((issue) => issue.code.startsWith("codex_"));
+    const codexHealthFailure = resolveCodexHealthFailurePresentation(healthCheck);
     const codexAuth = authDiagnostics?.authenticated
         ? { status: "ok" }
         : {
@@ -1819,12 +1870,8 @@ async function runDoctor(configPath = resolveDefaultConfigPath()) {
             ? { status: "ok" }
             : {
                 status: "not_ok",
-                reason: healthCheck.diagnostics.failureCategory === "provider_error"
-                    ? "model provider is unreachable."
-                    : healthCheck.diagnostics.failureCategory === "network_error"
-                        ? "network connectivity to Codex is unavailable."
-                        : "Codex request could not complete.",
-                fix: authDiagnostics.fixHint?.trim() || "Retry `optimus doctor` after fixing the Codex connection."
+                reason: codexHealthFailure.reason,
+                fix: codexHealthFailure.fix
             };
     const codex = healthCheck.ok
         ? {
@@ -1836,10 +1883,10 @@ async function runDoctor(configPath = resolveDefaultConfigPath()) {
             status: "not_ok",
             reason: summarizeIssue(codexIssue, !authDiagnostics?.authenticated
                 ? "authentication is not usable."
-                : healthCheck.diagnostics.failureCategory === "provider_error"
-                    ? "model provider is unreachable."
-                    : "Codex is not ready."),
-            fix: authDiagnostics?.fixHint?.trim() || "Rerun `optimus setup`.",
+                : codexHealthFailure.reason),
+            fix: !authDiagnostics?.authenticated
+                ? authDiagnostics?.fixHint?.trim() || "Rerun `optimus setup`."
+                : codexHealthFailure.fix,
             auth: codexAuth,
             connectivity: codexConnectivity
         };
@@ -2168,6 +2215,44 @@ function parseArgs(argv) {
 function parsedCommandHasHelp(argv) {
     return argv.some((token) => token === "-h" || token === "--help");
 }
+async function readTextFromStdin() {
+    const chunks = [];
+    for await (const chunk of input) {
+        chunks.push(typeof chunk === "string" ? chunk : chunk.toString("utf8"));
+    }
+    return chunks.join("");
+}
+async function resolveLongTextArg(args, keys) {
+    for (const key of keys.inline) {
+        const value = args[key]?.trim();
+        if (value) {
+            return value;
+        }
+    }
+    const filePath = keys.file ? args[keys.file]?.trim() : undefined;
+    if (filePath) {
+        const content = (await readFile(filePath, "utf8")).trim();
+        if (content) {
+            return content;
+        }
+    }
+    if (keys.stdin && args[keys.stdin] === "true") {
+        const content = (await readTextFromStdin()).trim();
+        if (content) {
+            return content;
+        }
+    }
+    return undefined;
+}
+function renderShellQuotingHint(command) {
+    return [
+        `${command} requires both --title and --description.`,
+        "Tip: shell metacharacters like `...`, $(...), and $VAR may be expanded before Optimus starts.",
+        "Use single quotes, or pass the text with --description-file / --description-stdin.",
+        `Example: optimus ${command} --title "..." --description 'literal text with \`optimus setup\` inside'`,
+        `Example: printf '%s' 'literal text with \`optimus setup\` inside' | optimus ${command} --title "..." --description-stdin`
+    ].join("\n");
+}
 async function main() {
     const argv = process.argv.slice(2);
     const [firstArg, ...rest] = argv;
@@ -2358,9 +2443,13 @@ async function main() {
     if (command === "submit") {
         const args = parseArgs(commandArgs);
         const title = args.title?.trim();
-        const description = (args.desc ?? args.description)?.trim();
+        const description = await resolveLongTextArg(args, {
+            inline: ["desc", "description"],
+            file: "description-file",
+            stdin: "description-stdin"
+        });
         if (!title || !description) {
-            console.error("submit requires both --title and --description");
+            console.error(renderShellQuotingHint("submit"));
             process.exitCode = 1;
             return;
         }
@@ -2383,9 +2472,13 @@ async function main() {
     if (command === "feedback") {
         const args = parseArgs(commandArgs);
         const title = args.title?.trim();
-        const description = (args.desc ?? args.description)?.trim();
+        const description = await resolveLongTextArg(args, {
+            inline: ["desc", "description"],
+            file: "description-file",
+            stdin: "description-stdin"
+        });
         if (!title || !description) {
-            console.error("feedback requires both --title and --description");
+            console.error(renderShellQuotingHint("feedback"));
             process.exitCode = 1;
             return;
         }