@sireai/optimus 0.1.1

package/.env.example

@@ -0,0 +1,16 @@
+PALEBLUEDOT_API_KEY=your_palebluedot_api_key
+
+JIRA_BASE_URL=https://jira.example.com/
+JIRA_MCP_URL=https://jira-mcp.example.com/mcp
+JIRA_AUTH_TYPE=http_headers
+JIRA_USERNAME=your_username
+JIRA_PERSONAL_TOKEN=your_jira_personal_token
+
+# Optional direct Jira REST modes:
+# JIRA_BEARER_TOKEN=your_jira_bearer_token
+# JIRA_API_TOKEN=your_jira_api_token
+# JIRA_PASSWORD=your_jira_password
+
+OPTIMUS_FEISHU_WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/your_webhook
+# OPTIMUS_FEISHU_WEBHOOKS=https://open.feishu.cn/open-apis/bot/v2/hook/a,https://open.feishu.cn/open-apis/bot/v2/hook/b
+# OPTIMUS_FEISHU_SECRET=your_feishu_sign_secret

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SireAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,104 @@
+# Optimus
+
+Optimus is a task-execution agent runtime. It accepts problem reports, turns them into governed tasks, runs analysis or code changes against bound repositories, and returns status, results, and delivery outputs.
+
+## What It Does
+
+- accepts manual submissions or external problem signals
+- routes raw input into executable tasks
+- runs analysis, fixes, validation, and delivery against registered repositories
+- returns task status, structured results, review links, and notifications
+
+## How It Works
+
+![Optimus workflow](assets/diagrams/optimus-overview.svg)
+
+From a user view, the flow is simple: submit a problem, let Optimus run inside the target repository, validate the outcome, then consume the result and next action.
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g @sireai/optimus
+```
+
+### 2. Run setup
+
+```bash
+optimus setup
+```
+
+Setup creates the `~/.optimus` runtime home, registers the first repository, configures Codex authentication, and optionally records Jira and Feishu integration settings.
+
+Supported Codex auth modes:
+
+- `openai_api_key`
+- `codex_cli_login`
+- `model_provider`
+
+### 3. Run a quick health check
+
+```bash
+optimus doctor --quick
+```
+
+### 4. Start the runtime
+
+```bash
+optimus start
+```
+
+`submit` sends work to the resident runtime, so start the service after setup.
+
+### 5. Submit a task
+
+```bash
+optimus submit --title "Login crash" --description "Crash happens on startup with stack trace"
+```
+
+## Common Commands
+
+Base commands:
+
+```bash
+optimus --help
+optimus version
+optimus upgrade --check
+optimus upgrade
+optimus setup
+optimus doctor --quick
+optimus start
+optimus submit --title "..." --description "..."
+```
+
+Task inspection:
+
+```bash
+optimus retry-task --task-id <taskId>
+optimus cancel-task --task-id <taskId>
+optimus task-status --task-id <taskId>
+optimus task-result --task-id <taskId>
+optimus delivery-status --task-id <taskId>
+optimus task-events --task-id <taskId>
+```
+
+Repository management:
+
+```bash
+optimus repo add /path/to/repo --alias mobile-app
+optimus repo list
+optimus repo doctor
+```
+
+Jira intake:
+
+```bash
+optimus jira-submit-issue --issue-key MICARAPPI-13178 --repo mobile-app
+```
+
+## More Docs
+
+- [Product PRD](/Users/sire/Documents/optimus/doc/optimus_product_prd.md)
+- [Architecture Design](/Users/sire/Documents/optimus/doc/optimus_architecture_design.md)
+- [Development and Maintenance](/Users/sire/Documents/optimus/doc/optimus_development_maintenance.md)

package/dist/cli/optimus.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};