26 Commits

Author SHA1 Message Date
Pedram Amini
798541cb4b Rename provider-nuances to provider-notes and add custom configuration docs
Add new Custom Configuration section documenting custom CLI arguments and
environment variables with screenshot. Rename navigation group to "Providers
& CLI" and reorder to list provider-notes first.
2026-02-04 13:14:17 -06:00
Pedram Amini
1560594360 docs: consolidate React DevTools profiling guide in CONTRIBUTING.md
Move React DevTools profiling instructions from CLAUDE-PERFORMANCE.md
to CONTRIBUTING.md under the Profiling section:
- Full installation and launch commands
- Components and Profiler tab descriptions
- Step-by-step profiler workflow
- Chrome DevTools Performance tab guidance

CLAUDE-PERFORMANCE.md now references CONTRIBUTING.md for profiling
workflow (keeping it focused on code patterns for AI).

Claude ID: 286ae250-379b-4b74-a24e-b23e907dba0b
Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2026-02-01 09:32:32 -05:00
Pedram Amini
43b4f66895 docs: add React DevTools profiling instructions to CONTRIBUTING.md
Document how to use the standalone React DevTools app for component
inspection and render profiling. The connection script already exists
in src/renderer/index.html but wasn't documented.

Claude ID: 286ae250-379b-4b74-a24e-b23e907dba0b
Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2026-02-01 09:06:36 -05:00
Pedram Amini
2f3626a91b MAESTRO: Update Supported Agents Reference table in CONTRIBUTING.md
- Codex: Changed from "Planned" to "Complete" with verified capability details
- OpenCode: Changed from "Stub Ready" to "Complete" with updated session storage path
- Factory Droid: Added as new supported agent (verified capabilities)
- Gemini CLI: Remains "Planned" (placeholder with no verified capabilities)

All capabilities are based on agent-capabilities.ts verified flags.
2026-01-31 01:48:37 -05:00
Kayvan Sylvan
2667cbdd77 Developer Experience Improvements (multi-worktree simultaneous development) (#209)
* docs: add git hash display and configurable dev server port

## CHANGES

- Add `VITE_PORT` env variable to configure dev server port
- Display git commit hash in About modal next to version
- Add `__GIT_HASH__` build-time constant to both Vite configs
- Document running multiple Maestro instances with git worktrees
- Update CONTRIBUTING.md with parallel development instructions

* feat: add configurable ports for dev servers

- Allow VITE_PORT to configure main dev server port
- Update main window to load from configurable port
- Enable VITE_WEB_PORT for web interface dev server
- Add note in CONTRIBUTING.md about port configuration
- Log port usage in development mode

* docs: update CONTRIBUTING.md section and fix React DevTools script initialization

## CHANGES

- Rename "Linting" section to "Linting & Pre-commit Hooks" in table of contents
- Move script variable declaration outside conditional block
- Fix React DevTools script initialization order in index.html

* chore: update `.vscode/settings.json` with new markdownlint config

* fix: disable biome linting. Project uses ESLint

* chore: Update baseline-browser-mapping (>2 months old, warning message on "npm run build:web")

* chore: add .vscode/ to gitignore

* chore: fix gitignore to ignore .cscode/* files properly

* fix

* chore: stop tracking .vscode/ files, respect gitignore

Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
2026-01-22 12:14:48 -06:00
Raza Rauf
491cef67fa chore: address PR review feedback
- Add troubleshooting section for pre-commit hooks in CONTRIBUTING.md
- Make prepare script resilient for CI/Docker: husky || true
- Update .prettierignore to exclude coverage/ and *.min.js
2026-01-20 00:11:22 +05:00
Raza Rauf
5773691dbe docs: add pre-commit hooks documentation to CONTRIBUTING.md 2026-01-19 23:09:40 +05:00
Pedram Amini
92b3cc73e7 added doc MCP server information 2025-12-28 12:56:46 -06:00
Pedram Amini
becfc97f42 merge: resolve conflicts with main (gist publishing + openspec) 2025-12-28 12:50:19 -06:00
Pedram Amini
d65b8d2c6b ## CHANGES
- Added `dev:prod-data` to develop against real production sessions safely 🧪
- Dev mode now defaults to an isolated `maestro-dev` data directory 🗂️
- App can explicitly opt into production userData via `USE_PROD_DATA=1` 🔀
- Contributor docs now clearly map dev commands to their data directories 📚
- Reduced dev/production database lock conflicts when running side-by-side 🔒
- Tab hover overlay redesigned to look like a clean “open folder” panel 🗃️
- Removed tab title tooltip to streamline the tab interaction feel ✂️
- Toast logging now captures whether audio/TTS notifications were enabled 🎙️
- Toast logs include the exact audio command used for notifications 🧾
- TTS playback now reuses captured audio state for consistent behavior 🔊
2025-12-28 08:51:42 -06:00
Pedram Amini
f6f967b0af ## CHANGES
- Publish any open file as a GitHub Gist, instantly sharable 🔗
- Smart Share button appears only when GH CLI is ready 🧠
- Quick Actions adds “Publish Document as GitHub Gist” command 
- New high-priority Gist confirmation modal with secret-first default 🔒
- Auto-copies gist URL and shows toast with “Open Gist” action 📋
- Main process IPC now creates gists via `gh gist create` 🛠️
- Command runner now supports stdin input using spawn-based execution 🚰
- Development runs in separate userData directory to avoid lock conflicts 🧪
- Extensive test coverage added for GistPublishModal behavior and a11y 🧰
- New Mintlify docs folder plus contributor guide for docs workflow 📚
2025-12-28 08:05:29 -06:00
Pedram Amini
22db413a5d MAESTRO: docs(openspec): complete Phase 3 documentation tasks
- Add OpenSpec to docs.json navigation after speckit-commands
- Add OpenSpec Commands section to slash-commands.md
- Update features.md to mention bundled Spec-Kit and OpenSpec
- Add Spec-Kit and OpenSpec rows to CLAUDE.md Key Files table
- Update CONTRIBUTING.md with bundled AI command set guide
- Update refresh prompts section to include both spec-kit and openspec
- Fix ESLint warning (prefer-const) in openspec-manager.ts

Tasks 3-9 of Phase 3 complete. Task 2 (screenshot) requires manual UI capture.
Task 10 (manual testing) remains for human verification.
2025-12-28 05:41:57 -06:00
Pedram Amini
2a53dbc5fc ## CHANGES
- Added core goals emphasizing responsiveness, battery, and memory efficiency docs 🚀
- Introduced detailed performance guidelines for React rendering, timers, IPC 🧭
- Optimized worktree child sorting from O(n²) to O(n) using Map 
- Memoized per-parent worktree children lists to avoid repeated filtering 🧠
- Sorted worktree children once per parent, reducing redundant comparisons 🔧
- Added memoized `groupsById` Map for instant group lookups during filtering 🗺️
- Eliminated repeated `Array.find()` calls when computing visible sessions 🏎️
2025-12-25 01:42:37 -06:00
Pedram Amini
00f10dba41 Merge main into speckit-support and fix conflicts
- Resolved conflicts in package.json (kept both test:performance and refresh-speckit scripts)
- Resolved conflicts in agent-detector.test.ts (kept try/finally pattern for platform restoration)
- Fixed speckit-manager.ts to read prompts from disk instead of using Vite's ?raw imports
- Removed unused extractDescription function and added proper types for GitHub API response
2025-12-22 22:08:58 -06:00
Pedram Amini
5d91f34b2f tests pass 2025-12-22 21:22:48 -06:00
Pedram Amini
a8edadbdcf feat: add ESLint with TypeScript/React plugins and fix all lint errors
- Add ESLint 9 configuration (eslint.config.mjs) with TypeScript and React hooks plugins
- Add npm run lint:eslint command for code quality checks
- Expand npm run lint to check all three TypeScript configs (renderer, main, cli)
- Update tsconfig.cli.json to include src/prompts and src/types directories

Fix 29 ESLint errors:
- Remove unused updateCliActivity import in batch-processor.ts
- Convert {false && <jsx>} patterns to comments in AutoRun components
- Wrap case block with const declarations in braces (AgentSelectionScreen)
- Fix unused expression pattern in PreparingPlanScreen
- Fix conditional hook calls in FilePreview, OfflineQueueBanner, RecentCommandChips, TerminalOutput
- Add windows-diagnostics.json to PackageContents interface

Update CLAUDE.md and CONTRIBUTING.md with new linting commands and documentation.

Claude ID: 029e8abe-5734-4967-9fb4-c85078c1973d
Maestro ID: 87ffa06e-0ecd-4eb8-b327-dad1ec24f7a9
2025-12-22 21:20:53 -06:00
Pedram Amini
ee54e4ff49 tests pass 2025-12-22 19:37:09 -06:00
Pedram Amini
3b5257d9ac perf: Auto Run performance quick wins 3 & 4
- Quick Win 3: Reduce elapsed time timer from 1s to 3s in RightPanel
  - Reduces timer callbacks by 66% during Auto Run

- Quick Win 4: Memoize batch state selectors in App.tsx
  - currentSessionBatchState and activeBatchRunState wrapped in useMemo
  - Prevents unnecessary re-calculation on unrelated re-renders

- Update RightPanel test to expect 3s intervals

- Document npm run lint command in CLAUDE.md and CONTRIBUTING.md

Claude ID: 9ba72f64-27a0-4682-a8f2-93febcf94609
Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2025-12-21 11:52:49 -06:00
Pedram Amini
2be8b5987d MAESTRO: Implement Phase 8.2 - Update documentation for multi-provider architecture
- CLAUDE.md: Added agent capabilities section, updated architecture diagram
  with parsers/ and storage/ directories, added agentSessions and agentError
  APIs, updated key files table, added error fields to Session interface
- AGENT_SUPPORT.md: Added multi-provider architecture status section showing
  all 7 completed components, updated supported agents reference with
  implementation status and detailed checklist for planned agents
- CONTRIBUTING.md: Updated supported agents reference table with status
  column and link to detailed guide
2025-12-16 21:50:19 -06:00
Pedram Amini
395063c2cc Add note on project changes and PR synchronization
Added a note about project changes and PR sync issues.
2025-12-14 01:56:20 -06:00
Pedram Amini
6a917ccc1b docs: add multi-agent support architecture, expand documentation
- Add AGENT_SUPPORT.md with comprehensive multi-agent architecture design
  - Agent capability model for controlling UI feature availability
  - Refactoring plan for abstracting Claude-specific code
  - Implementation guides for adding new agents (OpenCode, Gemini CLI, etc.)
  - Test impact analysis and migration strategy

- Expand ARCHITECTURE.md with new sections:
  - Achievement system, AI tab system, execution queue
  - Navigation history, web/mobile interface, CLI tool
  - Shared module, remote access & tunnels
  - Updated hooks documentation (15 custom hooks)
  - Expanded IPC API surface reference

- Update CONTRIBUTING.md:
  - Add detailed "Adding a New AI Agent" section
  - Agent capability checklist for new implementations
  - UI feature availability matrix

- Update CLAUDE.md with latest vernacular and patterns

- Various UI improvements:
  - Enhanced history panel with better modal handling
  - Session list refinements
  - Improved template variable handling
  - Mobile interface view state utilities

Claude ID: c19f7b47-0dca-46a5-b8b4-4ca2381c1c71
Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2025-12-08 17:11:31 -06:00
Pedram Amini
1cd8c1447e refactor: simplify history types, add custom agent paths, fix context calculation
- Remove LOOP history entry type, consolidate to AUTO and USER only
- Add custom agent path support in NewInstanceModal for non-PATH installations
- Fix context usage calculation to count only input-related tokens (input + cache)
- Add demo mode (npm run dev:demo) for isolated testing environment
- Remove unused tab context menu from TabBar component
- Fix badge acknowledgment variable reference in useSettings

Claude ID: dbbd387e-ae3c-49a6-9961-d8317774f0a4
Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2025-12-07 12:11:03 -06:00
Pedram Amini
b8ca9d1c67 OAuth enabled but no valid token found. Starting authentication...
Found expired OAuth token, attempting refresh...
Token refresh successful
## CHANGES

• Added CLI tool for remote control and automation magic! 🚀
• Introduced web interface for mobile device remote control! 📱
• Created shared code structure across all processes nicely! 🏗️
• Expanded template variables system with 30+ dynamic options! 🎯
• Migrated slash commands to customizable AI command system! 
• Added 16 beautiful themes across dark/light/vibe modes! 🎨
• Improved Auto Run with document paths and loop counters! 🔄
• Enhanced CLI with playbook execution and JSON streaming! 📊
• Fixed slash command autocomplete for multiline input handling! 🐛
• Restructured project with dedicated CLI and web directories! 📁
2025-12-07 09:05:42 -06:00
Pedram Amini
b253c4a7ed gss 2025-11-26 02:21:20 -06:00
Pedram Amini
3d770011ab split dev notes out of readme 2025-11-25 14:35:46 -06:00
Pedram Amini
ca85ff7c48 UX prototype complete 2025-11-23 19:00:08 -06:00