@sireai/optimus 0.1.5 → 0.1.7

package/README.md

@@ -20,7 +20,13 @@ From a user view, the flow is simple: submit a problem, let Optimus run inside t
 ### 1. Install
 
 ```bash
-npm install -g @sireai/optimus
+npm install -g @sireai/optimus --registry=https://registry.npmjs.org
+```
+
+If Jira CAS refresh reports a missing Playwright browser, install Chromium once:
+
+```bash
+npx playwright install chromium
 ```
 
 ### 2. Run setup
@@ -95,6 +101,7 @@ Jira intake:
 
 ```bash
 optimus jira-submit-issue --issue-key MICARAPPI-13178 --repo mobile-app
+optimus jira-refresh-auth --issue-key MICARAPPI-13178
 ```
 
 Sentry intake:

package/dist/cli/optimus.js

@@ -23,6 +23,7 @@ import { TriageRunner } from "../task-environment/orchestration/triage-runner.js
 import { OptimusRuntime } from "../task-environment/runtime/optimus-runtime.js";
 import { SQLiteTaskStore } from "../task-environment/storage/sqlite-task-store.js";
 import { SQLiteEventStore } from "../task-environment/storage/sqlite-event-store.js";
+import { buildTaskExecutionMetrics, formatExecutionMetricsCompact } from "../task-environment/observability/execution-metrics.js";
 import { FeishuNotifier } from "../task-environment/delivery/feishu-notifier.js";
 import { TaskDeliveryDispatcher } from "../task-environment/delivery/task-delivery-dispatcher.js";
 import { TaskDeliveryService } from "../task-environment/delivery/task-delivery-service.js";
@@ -164,7 +165,7 @@ function renderCliHelp() {
         "  postrun-retry         Rebuild postrun artifacts and optionally replay publication",
         "",
         "Integration commands:",
-        "  jira-search|jira-get-issue|jira-search-assigned-open|jira-submit-issue|jira-submit-assigned-open|jira-add-comment|jira-poll-once|jira-poll-daemon",
+        "  jira-search|jira-get-issue|jira-search-assigned-open|jira-submit-issue|jira-submit-assigned-open|jira-add-comment|jira-refresh-auth|jira-poll-once|jira-poll-daemon",
         "  sentry-get-event|sentry-submit-event",
         "  Example: optimus help jira-submit-issue",
         "",
@@ -362,7 +363,8 @@ function renderCommandHelp(command) {
             "  --expand <csv>               Jira expand parameters",
             "  --properties <csv>           Jira properties",
             "  --comment-limit <n>          Comment limit, default 3",
-            "  --update-history true|false  Include update history"
+            "  --update-history true|false  Include update history",
+            "  --raw                        Include raw Jira REST response"
         ].join("\n"),
         "jira-search": [
             "optimus jira-search",
@@ -402,6 +404,19 @@ function renderCommandHelp(command) {
             "  --issue-key <key>            Jira issue key",
             "  --body <text>                Comment body"
         ].join("\n"),
+        "jira-refresh-auth": [
+            "optimus jira-refresh-auth",
+            "",
+            "Usage:",
+            "  optimus jira-refresh-auth [options]",
+            "",
+            "Optional:",
+            "  --verify                    Verify current Jira REST auth without refreshing",
+            "  --issue-key <key>            Verify by reading a specific Jira issue",
+            "",
+            "Example:",
+            "  optimus jira-refresh-auth --issue-key MICARAPPI-13178"
+        ].join("\n"),
         "jira-poll-once": [
             "optimus jira-poll-once",
             "",
@@ -475,6 +490,8 @@ function mapJiraCommand(command) {
             return "submit-assigned-open";
         case "jira-add-comment":
             return "add-comment";
+        case "jira-refresh-auth":
+            return "refresh-auth";
         case "jira-poll-once":
             return "poll-once";
         case "jira-poll-daemon":
@@ -502,44 +519,18 @@ function resolveJiraQuickDoctorIssues(config, options) {
             fix: "Rerun `optimus setup` and provide a real Jira base URL."
         });
     }
-    if (config.authType === "bearer") {
-        if (!config.bearerToken?.trim()) {
-            issues.push({
-                code: "jira_token_missing",
-                message: "Jira integration is enabled, but Jira bearer token is missing.",
-                fix: "Rerun `optimus setup` and provide a Jira token."
-            });
-        }
-        return issues;
-    }
-    if (config.authType === "basic") {
-        if (!config.username?.trim() || !(config.apiToken?.trim() || config.password?.trim())) {
-            issues.push({
-                code: "jira_basic_auth_missing",
-                message: "Jira integration is enabled, but Jira basic auth credentials are incomplete.",
-                fix: "Provide Jira username plus api token or password, then rerun `optimus doctor --quick`."
-            });
-        }
-        return issues;
-    }
-    if (!config.mcpUrl?.trim() || /jira-mcp\.example\.com/i.test(config.mcpUrl)) {
+    if (!config.personalToken?.trim()) {
         issues.push({
-            code: "jira_mcp_url_missing",
-            message: "Jira integration is enabled, but Jira MCP URL is missing or still using the placeholder value.",
-            fix: "Provide a real Jira MCP URL, then rerun `optimus doctor --quick`."
+            code: "jira_token_missing",
+            message: "Jira integration is enabled, but Jira personal token is missing.",
+            fix: "Rerun `optimus setup` and provide a Jira personal token."
         });
     }
-    const requiredHeaders = [
-        "X-Atlassian-Jira-Url",
-        "X-Atlassian-Username",
-        "X-Atlassian-Jira-Personal-Token"
-    ];
-    const missingHeaders = requiredHeaders.filter((name) => !config.httpHeaders[name]?.trim());
-    if (missingHeaders.length > 0) {
+    if (!config.casCookieName?.trim()) {
         issues.push({
-            code: "jira_mcp_headers_missing",
-            message: `Jira integration is enabled, but Jira MCP headers are incomplete: ${missingHeaders.join(", ")}.`,
-            fix: "Provide the required Jira MCP headers, then rerun `optimus doctor --quick`."
+            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;
@@ -924,12 +915,24 @@ async function promptSetupAnswers(defaults) {
         }
         return rl.question(prompt);
     };
+    const printSetupSection = (title, detail) => {
+        console.log(`\n[${title}]`);
+        if (detail) {
+            console.log(detail);
+        }
+    };
+    const renderSetupPrompt = (label, promptLabel, defaultValue) => {
+        const suffix = defaultValue !== undefined ? ` [${defaultValue}]` : "";
+        return `[${label}] ${promptLabel}${suffix}: `;
+    };
     try {
         if (await pathExists(configPath)) {
             console.log(`Existing config found at ${configPath}. Press Enter to keep current values.`);
         }
-        const repoPath = (await ask(`Repository path [${defaults.repoPath}]: `)).trim() || defaults.repoPath;
-        const repoAlias = (await ask(`Repository alias [${defaults.repoAlias}]: `)).trim() || defaults.repoAlias;
+        printSetupSection("Repository", "Register the primary local repository used by Optimus.");
+        const repoPath = (await ask(renderSetupPrompt("Required", "Repository path", defaults.repoPath))).trim() || defaults.repoPath;
+        const repoAlias = (await ask(renderSetupPrompt("Required", "Repository alias", defaults.repoAlias))).trim() || defaults.repoAlias;
+        printSetupSection("Codex", "Choose one authentication mode, then fill the fields that follow.");
         const codexAuthMode = await askSetupCodexAuthMode({ ask, defaultMode: defaults.codexAuthMode });
         let codexApiKey;
         let codexProviderId;
@@ -937,54 +940,54 @@ async function promptSetupAnswers(defaults) {
         let codexProviderBaseUrl;
         let codexProviderApiKeyEnvName;
         if (codexAuthMode === "openai_api_key") {
-            codexApiKey = (await ask("OpenAI API key for OPENAI_API_KEY (leave blank to keep existing): ")).trim() || undefined;
+            codexApiKey = (await ask(renderSetupPrompt("Optional", "OpenAI API key for OPENAI_API_KEY", "leave blank to keep existing"))).trim() || undefined;
         }
         else if (codexAuthMode === "model_provider") {
-            codexProviderId = (await ask(`Provider id [${defaults.codexProviderId ?? ""}]: `)).trim() || defaults.codexProviderId;
-            codexProviderDisplayName = (await ask(`Provider display name [${defaults.codexProviderDisplayName ?? ""}]: `)).trim() || defaults.codexProviderDisplayName;
-            codexProviderBaseUrl = (await ask(`Provider base URL [${defaults.codexProviderBaseUrl ?? ""}]: `)).trim() || defaults.codexProviderBaseUrl;
-            codexProviderApiKeyEnvName = (await ask(`Provider API key env name [${defaults.codexProviderApiKeyEnvName ?? ""}]: `)).trim() || defaults.codexProviderApiKeyEnvName;
+            codexProviderId = (await ask(renderSetupPrompt("Required", "Provider id", defaults.codexProviderId ?? ""))).trim() || defaults.codexProviderId;
+            codexProviderDisplayName = (await ask(renderSetupPrompt("Required", "Provider display name", defaults.codexProviderDisplayName ?? ""))).trim() || defaults.codexProviderDisplayName;
+            codexProviderBaseUrl = (await ask(renderSetupPrompt("Required", "Provider base URL", defaults.codexProviderBaseUrl ?? ""))).trim() || defaults.codexProviderBaseUrl;
+            codexProviderApiKeyEnvName = (await ask(renderSetupPrompt("Required", "Provider API key env name", defaults.codexProviderApiKeyEnvName ?? ""))).trim() || defaults.codexProviderApiKeyEnvName;
             const providerKeyLabel = codexProviderApiKeyEnvName || defaults.codexProviderApiKeyEnvName || "the configured provider env";
-            codexApiKey = (await ask(`Provider API key value for ${providerKeyLabel} (leave blank to keep existing): `)).trim() || undefined;
+            codexApiKey = (await ask(renderSetupPrompt("Optional", `Provider API key value for ${providerKeyLabel}`, "leave blank to keep existing"))).trim() || undefined;
         }
-        const enableFeishuInput = (await ask(`Enable Feishu delivery? [${defaults.enableFeishu ? "Y/n" : "y/N"}] `)).trim().toLowerCase();
+        printSetupSection("Feishu", "Enable this module when task notifications should be sent to Feishu.");
+        const enableFeishuInput = (await ask(renderSetupPrompt("Optional module", "Enable Feishu delivery", defaults.enableFeishu ? "Y/n" : "y/N"))).trim().toLowerCase();
         const enableFeishu = enableFeishuInput.length === 0
             ? defaults.enableFeishu
             : ["y", "yes"].includes(enableFeishuInput);
         const feishuWebhook = enableFeishu
-            ? (await ask(`Feishu webhook [${defaults.feishuWebhook ? "configured" : ""}]: `)).trim() || defaults.feishuWebhook
+            ? (await ask(renderSetupPrompt("Required", "Feishu webhook", defaults.feishuWebhook ? "configured" : ""))).trim() || defaults.feishuWebhook
             : undefined;
         const feishuSecret = enableFeishu
-            ? (await ask(`Feishu secret (optional) [${defaults.feishuSecret ? "configured" : ""}]: `)).trim() || defaults.feishuSecret
+            ? (await ask(renderSetupPrompt("Optional", "Feishu secret", defaults.feishuSecret ? "configured" : ""))).trim() || defaults.feishuSecret
             : undefined;
-        const enableJiraInput = (await ask(`Enable Jira integration? [${defaults.enableJira ? "Y/n" : "y/N"}] `)).trim().toLowerCase();
+        printSetupSection("Jira", "Enable this module when Optimus should read issues or comment back to Jira.");
+        const enableJiraInput = (await ask(renderSetupPrompt("Optional module", "Enable Jira integration", defaults.enableJira ? "Y/n" : "y/N"))).trim().toLowerCase();
         const enableJira = enableJiraInput.length === 0
             ? defaults.enableJira
             : ["y", "yes"].includes(enableJiraInput);
         const jiraBaseUrl = enableJira
-            ? (await ask(`Jira base URL [${defaults.jiraBaseUrl ?? ""}]: `)).trim() || defaults.jiraBaseUrl
-            : undefined;
-        const jiraMcpUrl = enableJira
-            ? (await ask(`Jira MCP URL [${defaults.jiraMcpUrl ?? ""}]: `)).trim() || defaults.jiraMcpUrl
-            : undefined;
-        const jiraUsername = enableJira
-            ? (await ask(`Jira username [${defaults.jiraUsername ?? ""}]: `)).trim() || defaults.jiraUsername
+            ? (await ask(renderSetupPrompt("Required", "Jira base URL", defaults.jiraBaseUrl ?? ""))).trim() || defaults.jiraBaseUrl
             : undefined;
         const jiraPersonalToken = enableJira
-            ? (await ask(`Jira personal token [${defaults.jiraPersonalToken ? "configured" : ""}]: `)).trim() || defaults.jiraPersonalToken
+            ? (await ask(renderSetupPrompt("Required", "Jira personal token", defaults.jiraPersonalToken ? "configured" : ""))).trim() || defaults.jiraPersonalToken
+            : undefined;
+        const jiraCasCookieName = enableJira
+            ? (await ask(renderSetupPrompt("Optional", "Jira CAS cookie name", defaults.jiraCasCookieName ?? "_aegis_cas_p"))).trim() || defaults.jiraCasCookieName || "_aegis_cas_p"
             : undefined;
-        const enableSentryInput = (await ask(`Enable Sentry integration? [${defaults.enableSentry ? "Y/n" : "y/N"}] `)).trim().toLowerCase();
+        printSetupSection("Sentry", "Enable this module when tasks can be created from Sentry events.");
+        const enableSentryInput = (await ask(renderSetupPrompt("Optional module", "Enable Sentry integration", defaults.enableSentry ? "Y/n" : "y/N"))).trim().toLowerCase();
         const enableSentry = enableSentryInput.length === 0
             ? defaults.enableSentry
             : ["y", "yes"].includes(enableSentryInput);
         const sentryBaseUrl = enableSentry
-            ? (await ask(`Sentry base URL [${defaults.sentryBaseUrl ?? ""}]: `)).trim() || defaults.sentryBaseUrl
+            ? (await ask(renderSetupPrompt("Required", "Sentry base URL", defaults.sentryBaseUrl ?? ""))).trim() || defaults.sentryBaseUrl
             : undefined;
         const sentryOrg = enableSentry
-            ? (await ask(`Sentry org [${defaults.sentryOrg ?? ""}]: `)).trim() || defaults.sentryOrg
+            ? (await ask(renderSetupPrompt("Required", "Sentry org", defaults.sentryOrg ?? ""))).trim() || defaults.sentryOrg
             : undefined;
         const sentryAuthToken = enableSentry
-            ? (await ask(`Sentry auth token [${defaults.sentryAuthToken ? "configured" : ""}]: `)).trim() || defaults.sentryAuthToken
+            ? (await ask(renderSetupPrompt("Required", "Sentry auth token", defaults.sentryAuthToken ? "configured" : ""))).trim() || defaults.sentryAuthToken
             : undefined;
         return {
             repoPath,
@@ -1000,9 +1003,9 @@ async function promptSetupAnswers(defaults) {
             ...(feishuSecret ? { feishuSecret } : {}),
             enableJira,
             ...(jiraBaseUrl ? { jiraBaseUrl } : {}),
-            ...(jiraMcpUrl ? { jiraMcpUrl } : {}),
-            ...(jiraUsername ? { jiraUsername } : {}),
             ...(jiraPersonalToken ? { jiraPersonalToken } : {}),
+            ...(jiraCasCookieName ? { jiraCasCookieName } : {}),
+            ...(defaults.jiraCustomHeaders ? { jiraCustomHeaders: defaults.jiraCustomHeaders } : {}),
             enableSentry,
             ...(sentryBaseUrl ? { sentryBaseUrl } : {}),
             ...(sentryOrg ? { sentryOrg } : {}),
@@ -1052,9 +1055,9 @@ async function resolveDefaultSetupAnswers() {
         ...(config.delivery.feishu.secret ? { feishuSecret: config.delivery.feishu.secret } : {}),
         enableJira: config.jira.enabled,
         ...(config.jira.baseUrl ? { jiraBaseUrl: config.jira.baseUrl } : {}),
-        ...(config.jira.mcpUrl ? { jiraMcpUrl: config.jira.mcpUrl } : {}),
-        ...(config.jira.httpHeaders["X-Atlassian-Username"] ? { jiraUsername: config.jira.httpHeaders["X-Atlassian-Username"] } : {}),
-        ...(config.jira.httpHeaders["X-Atlassian-Jira-Personal-Token"] ? { jiraPersonalToken: config.jira.httpHeaders["X-Atlassian-Jira-Personal-Token"] } : {}),
+        ...(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 } : {}),
         ...(config.sentry.org ? { sentryOrg: config.sentry.org } : {}),
@@ -1079,7 +1082,7 @@ function normalizeSetupCodexAuthMode(value) {
 }
 function renderSetupCodexAuthModePrompt(defaultMode) {
     const defaultIndex = SETUP_CODEX_AUTH_MODE_OPTIONS.find((option) => option.mode === defaultMode)?.index ?? "1";
-    const lines = ["Codex auth mode:"];
+    const lines = ["[Required] Codex auth mode:"];
     for (const option of SETUP_CODEX_AUTH_MODE_OPTIONS) {
         const defaultSuffix = option.index === defaultIndex ? " (default)" : "";
         lines.push(`${option.index}. ${option.label} [${option.mode}]${defaultSuffix}`);
@@ -1125,12 +1128,6 @@ function validateSetupAnswers(answers) {
     if (answers.enableJira && !answers.jiraBaseUrl?.trim()) {
         return "setup requires a Jira base URL when Jira integration is enabled.";
     }
-    if (answers.enableJira && !answers.jiraMcpUrl?.trim()) {
-        return "setup requires a Jira MCP URL when Jira integration is enabled.";
-    }
-    if (answers.enableJira && !answers.jiraUsername?.trim()) {
-        return "setup requires a Jira username when Jira integration is enabled.";
-    }
     if (answers.enableJira && !answers.jiraPersonalToken?.trim()) {
         return "setup requires a Jira personal token when Jira integration is enabled.";
     }
@@ -1207,19 +1204,16 @@ function buildSetupConfig(answers) {
     config.jira.enabled = answers.enableJira;
     if (answers.enableJira) {
         config.jira.baseUrl = answers.jiraBaseUrl ?? config.jira.baseUrl;
-        if (answers.jiraMcpUrl) {
-            config.jira.mcpUrl = answers.jiraMcpUrl;
-        }
-        config.jira.authType = "http_headers";
-        config.jira.httpHeaders = {
-            "X-Atlassian-Jira-Url": answers.jiraBaseUrl ?? config.jira.baseUrl,
-            "X-Atlassian-Username": answers.jiraUsername ?? "",
-            "X-Atlassian-Jira-Personal-Token": answers.jiraPersonalToken ?? ""
-        };
-        delete config.jira.bearerToken;
-        delete config.jira.username;
-        delete config.jira.apiToken;
-        delete config.jira.password;
+        if (answers.jiraPersonalToken) {
+            config.jira.personalToken = answers.jiraPersonalToken;
+        }
+        config.jira.casCookieName = answers.jiraCasCookieName?.trim() || "_aegis_cas_p";
+        if (answers.jiraCustomHeaders?.trim()) {
+            config.jira.customHeaders = answers.jiraCustomHeaders.trim();
+        }
+        else {
+            delete config.jira.customHeaders;
+        }
     }
     config.sentry.enabled = answers.enableSentry;
     if (answers.enableSentry) {
@@ -2389,6 +2383,7 @@ async function main() {
             const taskRuns = runs.filter((run) => run.taskId === task.taskId);
             const activeRun = runs.find((run) => run.runId === task.activeRunId) ?? taskRuns.slice(-1)[0];
             const timing = activeRun ? buildRunTimingSnapshot(activeRun, config) : { elapsedMs: 0, idleMs: 0, timeoutKind: null };
+            const activeMetrics = activeRun ? buildTaskExecutionMetrics(activeRun) : undefined;
             return {
                 taskId: task.taskId,
                 taskPackageId: task.taskPackageId,
@@ -2415,9 +2410,14 @@ async function main() {
                 elapsedMs: activeRun ? timing.elapsedMs : null,
                 idleMs: activeRun ? timing.idleMs : null,
                 timeoutKind: activeRun ? timing.timeoutKind : null,
+                metrics: activeMetrics ? {
+                    ...activeMetrics,
+                    display: formatExecutionMetricsCompact(activeMetrics)
+                } : null,
                 nextAction: buildTaskNextAction(task.status, activeRun?.failureCategory),
                 runs: taskRuns.slice(-3).map((run) => {
                     const timing = buildRunTimingSnapshot(run, config);
+                    const metrics = buildTaskExecutionMetrics(run);
                     return {
                         runId: run.runId,
                         status: run.status,
@@ -2444,7 +2444,11 @@ async function main() {
                         cancelRequestedAt: run.cancelRequestedAt ?? null,
                         elapsedMs: timing.elapsedMs,
                         idleMs: timing.idleMs,
-                        timeoutKind: timing.timeoutKind
+                        timeoutKind: timing.timeoutKind,
+                        metrics: metrics ? {
+                            ...metrics,
+                            display: formatExecutionMetricsCompact(metrics)
+                        } : null
                     };
                 })
             };
@@ -3119,6 +3123,10 @@ function renderTaskResultReport(input) {
         if (latestRun.endedAt) {
             lines.push(`Ended At: ${latestRun.endedAt}`);
         }
+        const metrics = formatExecutionMetricsCompact(buildTaskExecutionMetrics(latestRun));
+        if (metrics) {
+            lines.push(`Metrics: ${metrics}`);
+        }
     }
     lines.push("");
     lines.push("Summary");
@@ -3142,6 +3150,10 @@ function renderTaskResultReport(input) {
         lines.push("Delivery");
         lines.push(`Outcome: ${input.deliveryBundle.outcome}`);
         lines.push(`Decision: ${input.deliveryBundle.summary.decision}`);
+        const metrics = formatExecutionMetricsCompact(input.deliveryBundle.metrics);
+        if (metrics) {
+            lines.push(`Metrics: ${metrics}`);
+        }
         if (input.deliveryBundle.warnings?.length) {
             lines.push(`Warnings: ${input.deliveryBundle.warnings.join(", ")}`);
         }