maistro 1.0.390

package/LICENSE

@@ -0,0 +1,15 @@
+Maistro License
+
+Copyright (c) 2026 DreamTeam Mobile. All rights reserved.
+
+Permission is granted, free of charge, to use this software for any purpose,
+including commercial applications, subject to the following conditions:
+
+1. You MAY use this software for personal or commercial purposes.
+2. You MAY NOT modify, adapt, or create derivative works.
+3. You MAY NOT redistribute, sublicense, or resell this software.
+4. You MAY NOT remove or alter any copyright notices.
+
+This software is provided "as is", without warranty of any kind, express or
+implied. In no event shall the authors be liable for any claim, damages, or
+other liability arising from the use of this software.

package/README.md

@@ -0,0 +1,107 @@
+# Maistro
+
+AI-powered CLI that breaks down complex projects into tasks and executes them automatically via Claude Code. Describe your goal, review the plan, then let it run autonomously - validating results and committing changes after each task.
+
+## Prerequisites
+
+### 1. Node.js 18+
+
+Download from [nodejs.org](https://nodejs.org/)
+
+### 2. Claude Code CLI
+
+Install & authenticate Claude Code
+
+```bash
+npm install -g @anthropic-ai/claude-code
+claude
+```
+
+## Installation
+
+```bash
+npm install -g maistro
+```
+
+## Update
+
+```bash
+npm update -g maistro
+```
+
+## Usage
+
+```bash
+maistro
+```
+
+This launches the interactive mode where you can:
+
+1. **Describe your goal** - Enter what you want to build or accomplish
+2. **Answer questions** - Maistro asks clarifying questions to understand your project
+3. **Review the plan** - See the generated task breakdown before execution
+4. **Refine if needed** - Chat to modify tasks, reorder, or add details
+5. **Execute** - Watch as tasks are executed, validated, and committed
+
+## Commands
+
+During execution, you can type commands in the input bar:
+
+| Command | Action |
+|---------|--------|
+| `run` | Start or resume execution |
+| `plan` | View and modify the task plan |
+| `retry` | Retry a failed task |
+| `claude` | Open Claude Code in a new terminal |
+| `exit` | Exit maistro |
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `Enter` | Submit input |
+| `Shift+Enter` | New line in input |
+| `Up/Down` | Navigate input history |
+| `Escape` (2x) | Clear input |
+
+## Project Files
+
+Maistro stores project state in `.maistro/` directory:
+- `state.json` - Task list and progress
+- `logs/` - Execution logs per task
+- `images/` - Attached images (if any)
+
+Add `.maistro/` to your `.gitignore` if you don't want to track execution state.
+
+
+## How It Works
+
+Maistro uses Claude Code CLI to execute each task on your plan. Tasks run non-interactively with:
+
+```
+claude --dangerously-skip-permissions --chrome
+```
+
+- `--dangerously-skip-permissions` - Allows autonomous execution without confirmation prompts
+- `--chrome` - Enables browser integration for real-time feedback via Chrome extension
+
+> **Warning:** Once execution starts, Maistro runs autonomously without confirmation prompts. It will attempt to complete all tasks on the plan without asking for permission. Use responsibly and preferably in sandboxed environments (containers, VMs, or isolated directories).
+
+### Claude Code Chrome Extension (Recommended)
+
+For the fastest feedback loop, install the Chrome extension:
+
+**[Claude Code Chrome Extension](https://chromewebstore.google.com/detail/claude-code/ilfhajpgbakchaddgjdkmipfmongogon)**
+
+This enables real-time browser automation and visual feedback during task execution.
+
+
+## Support
+
+Questions or issues? Contact support@dreamteam-mobile.com
+
+> **Note:** Maistro should work on macOS, Linux, and Windows, but has only been tested on macOS. If you encounter platform-specific issues, please reach out.
+
+## License
+
+Free to use for any purpose. See [LICENSE](LICENSE) for details.

package/dist/app.d.ts

@@ -0,0 +1,247 @@
+export declare class MaistroApp {
+    private ui;
+    private orchestrator;
+    private projectPath;
+    private isExecuting;
+    private shouldStop;
+    private shouldPlan;
+    private shouldAutoRun;
+    private executionState;
+    constructor(projectPath?: string);
+    private getOrchestrator;
+    /**
+     * Detect if the current directory is an existing project
+     * Returns project indicators and context from README/CLAUDE.md
+     */
+    private detectExistingProject;
+    /**
+     * Start the interactive application
+     */
+    start(): Promise<void>;
+    /**
+     * Handle update check at startup
+     * Prompts user to update if a new version is available
+     */
+    private handleUpdateCheck;
+    /**
+     * Run doctor check - verify Claude Code CLI installation and authentication
+     */
+    handleDoctor(): Promise<boolean>;
+    /**
+     * Handle attaching an image
+     * Supports: /attach <path> [as <name>] or /attach <url> [as <name>]
+     */
+    private handleAttachImage;
+    /**
+     * Associate an image with a task by inserting the placeholder into the task's description
+     */
+    private associateImageWithTask;
+    /**
+     * Handle pasted image data (base64, data URL, or escape sequence)
+     * Saves the image to the project and returns the image ID
+     */
+    private handlePastedImage;
+    /**
+     * Handle clipboard image import via /paste command
+     * Checks if clipboard contains an image and saves it
+     */
+    private handleClipboardPaste;
+    /**
+     * Prompt user to select a task to attach an image to
+     */
+    private promptForTaskToAttach;
+    /**
+     * List all attached images
+     */
+    private handleListImages;
+    /**
+     * Process all tasks to download image URLs and replace them with placeholders
+     * Returns updated tasks with local image references
+     */
+    private processTasksImageUrls;
+    /**
+     * Handle project discovery phase - ask clarifying questions before decomposition
+     * Uses full-screen approach for each step
+     */
+    private handleDiscovery;
+    /**
+     * Handle discovery phase for planning requests (no skip option)
+     * This is used when the user submits a planning request to refine the plan.
+     */
+    private handleDiscoveryRequired;
+    /**
+     * Ask a single discovery question (required - no skip option)
+     */
+    private askDiscoveryQuestionRequired;
+    /**
+     * Ask a single discovery question using full-screen approach
+     */
+    private askDiscoveryQuestion;
+    /**
+     * Detect and collect missing external dependencies
+     * Returns the collected values or null if user cancelled
+     */
+    private handleDependencyDetection;
+    /**
+     * Save collected dependency values to .env file
+     */
+    private saveDependenciesToEnv;
+    /**
+     * Format duration in milliseconds to human-readable string
+     */
+    private formatDuration;
+    private showHeader;
+    /**
+     * Render plan view content (header, progress, tasks, commands)
+     * Used for initial render and resize re-render
+     *
+     * Displays a unified scrollable task list (max UI.MAX_VISIBLE_TASKS visible).
+     * Use ↑↓ arrows to navigate and scroll through all tasks.
+     */
+    private renderPlanViewContent;
+    private selectedTaskIndex;
+    private taskScrollOffset;
+    /**
+     * Main plan view - combines status and plan management
+     * Returns true if the app should restart init flow (e.g., after clearing plan)
+     */
+    private showPlanView;
+    /**
+     * Parse plan view command
+     * Returns the command name or an object with command and args for parameterized commands
+     */
+    private parsePlanCommand;
+    /**
+     * Interactive input for plan view with arrow key navigation
+     */
+    private planViewInput;
+    /**
+     * Interactive input for plan review with arrow key navigation.
+     * Uses unified InputBox component for consistent input handling.
+     */
+    private planReviewInput;
+    /**
+     * Show task inspector (read-only view) during execution
+     * Returns 'edit' if user wants to edit, 'back' to return to execution view
+     */
+    private showTaskInspector;
+    /**
+     * Show task editor for editing a single task
+     */
+    private showTaskEditor;
+    private inputHistory;
+    private historyIndex;
+    private historyLoaded;
+    /**
+     * Load input history from project state
+     */
+    private loadInputHistory;
+    /**
+     * Save input history to project state
+     */
+    private saveInputHistory;
+    /**
+     * Styled input using unified InputBox component.
+     * Features: multi-line (Shift+Enter), history navigation (Shift+Up/Down), cursor movement.
+     */
+    private styledInput;
+    /**
+     * Full-screen text input - clears screen, shows header, question, and styled input
+     * Uses virtual screen approach: keeps state in memory, full clear+redraw on every change
+     */
+    private fullScreenTextInput;
+    /**
+     * Full-screen menu selection - clears screen, shows header, and menu
+     * Used for initialization flow to avoid cursor tracking issues
+     */
+    private fullScreenMenu;
+    /**
+     * Full-screen menu with inline input for "Other" option.
+     * Uses the reusable InputBox component for the "Other" input.
+     * When "Other" is selected, an InputBox appears for custom value entry.
+     */
+    private fullScreenMenuWithInlineOther;
+    /**
+     * Show pause menu when user presses Escape during execution
+     * Returns: 'resume' | 'skip' | 'abort'
+     */
+    private showPauseMenu;
+    /**
+     * Handle inline discussion with Claude (unified main/planning view)
+     * Streams Claude's response inline and returns updated tasks if any were modified.
+     * No separate screen or approve/reject prompt - task list updates automatically.
+     */
+    private handleInlineDiscussion;
+    /**
+     * Handle plan modification (chat-based refinement)
+     * @deprecated Use handleInlineDiscussion instead - this is kept for backward compatibility
+     */
+    private handleModifyPlan;
+    /**
+     * Initialize in an existing repository
+     * Auto-detects project name, reads context from README/CLAUDE.md,
+     * and goes directly to goal input for the next feature to implement
+     */
+    private handleExistingRepoInit;
+    private handleInit;
+    private interactivePlanReview;
+    private displayTasks;
+    /**
+     * Handle clear plan command - clears goal and all tasks, keeps logs
+     * Returns true if plan was cleared and should return to init flow
+     */
+    private handleClearPlan;
+    /**
+     * Handle settings command - show settings menu
+     */
+    private handleSettings;
+    /**
+     * Show manual Cmd+V configuration instructions
+     */
+    private showCmdVInstructions;
+    /**
+     * Wait for a keypress
+     */
+    private waitForKeypress;
+    /**
+     * Show manual terminal configuration instructions
+     */
+    private showTerminalInstructions;
+    private handleOpenClaude;
+    private readonly spinnerFrames;
+    /**
+     * Initialize execution state when starting task execution
+     */
+    private startExecutionState;
+    /**
+     * Stop and cleanup execution state
+     */
+    private stopExecutionState;
+    /**
+     * Add a line of Claude Code output to the buffer
+     */
+    private addExecutionOutput;
+    /**
+     * Update the execution phase
+     */
+    private setExecutionPhase;
+    /**
+     * Update animation state (called by interval)
+     */
+    private updateAnimationState;
+    /**
+     * Start the animation interval for execution progress
+     */
+    private startExecutionAnimation;
+    /**
+     * Truncate a summary to a maximum number of lines
+     */
+    private truncateSummary;
+    /**
+     * Render the execution progress section (Claude Code output + progress bars)
+     */
+    private renderExecutionSection;
+    private handleRun;
+    private executeWithUnifiedView;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AA6NA,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAG9B,OAAO,CAAC,cAAc,CAA+B;gBAEzC,WAAW,GAAE,MAAY;IAsBrC,OAAO,CAAC,eAAe;IASvB;;;OAGG;YACW,qBAAqB;IA+CnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8F5B;;;OAGG;YACW,iBAAiB;IA8D/B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAqEtC;;;OAGG;YACW,iBAAiB;IAwD/B;;OAEG;YACW,sBAAsB;IAsCpC;;;OAGG;YACW,iBAAiB;IAoB/B;;;OAGG;YACW,oBAAoB;IAkClC;;OAEG;YACW,qBAAqB;IA4BnC;;OAEG;YACW,gBAAgB;IAoB9B;;;OAGG;YACW,qBAAqB;IAoEnC;;;OAGG;YACW,eAAe;IAwG7B;;;OAGG;YACW,uBAAuB;IAyDrC;;OAEG;YACW,4BAA4B;IAiE1C;;OAEG;YACW,oBAAoB;IA8DlC;;;OAGG;YACW,yBAAyB;IAwHvC;;OAEG;YACW,qBAAqB;IA0CnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,UAAU;IAalB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IA0J7B,OAAO,CAAC,iBAAiB,CAAM;IAC/B,OAAO,CAAC,gBAAgB,CAAK;IAE7B;;;OAGG;YACW,YAAY;IAoS1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA2CxB;;OAEG;YACW,aAAa;IA0lB3B;;;OAGG;YACW,eAAe;IAkN7B;;;OAGG;YACW,iBAAiB;IA4H/B;;OAEG;YACW,cAAc;IAwU5B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,aAAa,CAAS;IAE9B;;OAEG;YACW,gBAAgB;IAkB9B;;OAEG;YACW,gBAAgB;IAe9B;;;OAGG;YACW,WAAW;IAsEzB;;;OAGG;YACW,mBAAmB;IA0BjC;;;OAGG;YACW,cAAc;IAiB5B;;;;OAIG;YACW,6BAA6B;IAwH3C;;;OAGG;YACW,aAAa;IA+B3B;;;;OAIG;YACW,sBAAsB;IA4LpC;;;OAGG;YACW,gBAAgB;IAqF9B;;;;OAIG;YACW,sBAAsB;YAwGtB,UAAU;YAyHV,qBAAqB;IA4fnC,OAAO,CAAC,YAAY;IAiEpB;;;OAGG;YACW,eAAe;IAkD7B;;OAEG;YACW,cAAc;IAsO5B;;OAEG;YACW,oBAAoB;IAwBlC;;OAEG;YACW,eAAe;IAU7B;;OAEG;YACW,wBAAwB;YAsBxB,gBAAgB;IA4B9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsD;IAEpF;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;YAoEhB,SAAS;YAmJT,sBAAsB;CA8brC"}