@sireai/optimus 0.1.20 → 0.1.22

package/README.md

@@ -102,9 +102,12 @@ Jira intake:
 
 ```bash
 optimus jira-submit-issue --issue-key MICARAPPI-13178 --repo mobile-app
+optimus jira-submit-issue --issue-key MICARAPPI-13178 --repo mobile-app --with-comments
 optimus jira-refresh-auth --issue-key MICARAPPI-13178
 ```
 
+`jira-submit-issue` now excludes Jira comments by default. Add `--with-comments` when recent comments should be included in the submit context. `--comment-limit` only applies when `--with-comments` is set.
+
 Sentry intake:
 
 ```bash

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",
@@ -476,7 +487,8 @@ function renderCommandHelp(command) {
             "  --branch <name>              Override target branch",
             "  --task-type <type>           Task type, default bugfix",
             "  --allow-duplicate            Allow duplicate submission",
-            "  --comment-limit <n>          Comment lines fetched from Jira, default 3",
+            "  --with-comments              Include recent Jira comments in submit context",
+            "  --comment-limit <n>          Comment lines fetched from Jira when --with-comments is set, default 3",
             "  --dry-run                    Preview without creating a task",
             "",
             "Example:",
@@ -493,6 +505,7 @@ function renderCommandHelp(command) {
             "  --repo <alias>               Target registered repository alias",
             "  --projects-filter <csv>      Restrict Jira projects",
             "  --limit <n>                  Max issues to submit, default 50",
+            "  --with-comments              Include recent Jira comments in submit context",
             "  --allow-duplicate            Allow duplicate submission",
             "  --dry-run                    Preview without creating tasks"
         ].join("\n"),
@@ -1708,19 +1721,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);
@@ -1799,6 +1863,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" }
         : {
@@ -1817,12 +1882,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
         ? {
@@ -1834,10 +1895,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
         };
@@ -2166,6 +2227,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;
@@ -2356,9 +2455,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;
         }
@@ -2381,9 +2484,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;
         }