High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.
docs: small changes
Luigi Agostid22ada19482f
diff --git a/docs/index.json b/docs/index.jsonindex 35eaea6b..7970c7d9 100644--- a/docs/index.json+++ b/docs/index.json@@ -23,5 +23,9 @@"guides/cdp-url-shared-chrome.md","guides/headed-mode-guide.md","guides/identifying-instances.md"+ ],+ "proposals": [+ "proposals/performance-optimization.md",+ "proposals/ui-enhancements.md"]}diff --git a/docs/proposals/README.md b/docs/proposals/README.mddeleted file mode 100644index 1386a969..00000000--- a/docs/proposals/README.md+++ /dev/null@@ -1,176 +0,0 @@-# Pinchtab Proposals & Roadmap--This folder contains detailed proposals for future phases of Pinchtab development.--## Current Status--**Phase 6: COMPLETE ✅**-- Multi-instance architecture fully implemented-- Hash-based ID system for profiles, instances, tabs-- Auto-port allocation with cleanup and reuse-- Instance isolation (separate Chrome, cookies, history, profiles)-- Lazy Chrome initialization-- 195+ tests passing-- Production-ready--## Future Phases--### Phase 7: Performance Optimization & Scaling-**File:** `phase-7-performance-optimization.md`--Focus areas:-- **Benchmarking**: Establish baseline metrics for latency, memory, concurrent limits-- **Optimizations**: Connection pooling, caching, batch navigation support-- **Scaling tests**: Validate 100+ concurrent instances, multi-agent load, resource limits--**Effort estimate:** 9-14 hours-**Priority:** High (needed for production deployments with 10+ instances)--#### Key Sections-1. Benchmarking & Metrics- - Request latency baseline- - Memory per instance- - Concurrent instance limits--2. Optimizations & Improvements- - HTTP connection pooling- - Cache improvements- - Batch navigation support--3. Scaling Tests & Validation- - 100+ instance stress test- - Multi-agent concurrent load- - Resource limits testing-------### Phase 8: Dashboard UI Enhancements-**File:** `phase-8-dashboard-ui-enhancements.md`--Focus areas:-- **Monitoring**: Real-time Chrome status, memory/CPU usage, tab activity-- **Batch operations**: Create multiple instances, terminate all, port range config-- **Navigation**: Search/filter, details modal, live logs viewer--**Effort estimate:** 18-28 hours-**Priority:** Medium-High (improves user experience significantly)--#### Key Sections-1. Instance Monitoring Screen- - Real-time Chrome status- - Memory & CPU usage per instance- - Tab activity visualization--2. Batch Operations- - Create multiple instances at once- - Terminate all instances button- - Port range configuration UI--3. Better Navigation & UX- - Search & filter instances- - Instance details modal- - Live logs viewer-------## Decision Framework--### When to Pursue Phase 7 vs Phase 8--**Start Phase 7 if:**-- Need to support 10+ concurrent instances-- User feedback indicates performance issues-- Deployment cost is concern (want to optimize resource usage)-- Need monitoring/observability for production--**Start Phase 8 if:**-- Managing 5+ instances is tedious via API/CLI-- Need better visibility into instance state-- Want self-service dashboard without CLI expertise-- Running in environment where dashboard access preferred over CLI-------## Proposal Structure--Each proposal file contains:--1. **Overview** - Summary of phase goals and scope--2. **Detailed Tasks** - For each feature area:- - Objectives- - Tasks with sub-items (checkboxes for progress tracking)- - Implementation strategy- - Testing approach- - Acceptance criteria--3. **Success Metrics** - Measurable targets for quality/performance--4. **Timeline Estimate** - Hours per section and total--5. **Deliverables** - Concrete outputs (files, endpoints, docs)--6. **Notes** - Important considerations and gotchas-------## How to Use--### For Planning-1. Read the relevant proposal document(s)-2. Estimate effort based on task complexity-3. Adjust timeline based on team capacity-4. Update task lists as work progresses--### For Tracking Progress-- Check off items as completed-- Add dates next to completed items-- Update status at top of file-- Create branch for each phase (e.g., `feat/phase-7-perf`)--### For Documentation-- Link to relevant proposal sections in commit messages-- Reference proposal acceptance criteria in PR reviews-- Use deliverables list as checklist before merging-------## Future Proposal Ideas--### Phase 9: Advanced Agent Coordination-- Session sharing between agents-- Shared instance resources-- Cross-agent communication-- Advanced routing and load balancing--### Phase 10: Production Hardening-- Docker and Kubernetes manifests-- Monitoring integration (Prometheus, Grafana)-- Deployment guides (AWS, GCP, Azure)-- Security hardening (SSL, auth, RBAC)--### Phase 11: Advanced Features-- Browser profile snapshots/restore-- Debugging integration (DevTools proxy)-- Browser extensions support-- Custom Chrome flags per instance-------## Related Documentation--- `docs/overview.md` - Architecture overview-- `docs/get-started.md` - Quick start guide-- `docs/references/endpoints.md` - API reference-- `TESTING.md` - Testing guide-- `docs/building.md` - Build from source-------## Questions?--Refer to:-- **Architecture questions** → `docs/architecture/`-- **API usage** → `docs/references/endpoints.md`-- **Deployment** → `docs/guides/`-- **Testing** → `TESTING.md`diff --git a/docs/proposals/phase-7-performance-optimization.md b/docs/proposals/performance-optimization.mdsimilarity index 99%rename from docs/proposals/phase-7-performance-optimization.mdrename to docs/proposals/performance-optimization.mdindex 8e71ac80..14e040b4 100644--- a/docs/proposals/phase-7-performance-optimization.md+++ b/docs/proposals/performance-optimization.md@@ -1,4 +1,4 @@-# Phase 7: Performance Optimization & Scaling+# Optimization & Scaling## Overviewdiff --git a/docs/proposals/phase-8-dashboard-ui-enhancements.md b/docs/proposals/ui-enhancements.mdsimilarity index 97%rename from docs/proposals/phase-8-dashboard-ui-enhancements.mdrename to docs/proposals/ui-enhancements.mdindex c05ea266..659a53b3 100644--- a/docs/proposals/phase-8-dashboard-ui-enhancements.md+++ b/docs/proposals/ui-enhancements.md@@ -1,8 +1,8 @@-# Phase 8: Dashboard UI Enhancements+# UI Enhancements## Overview-Phase 8 focuses on improving the dashboard user experience with real-time monitoring, batch operations, and better instance navigation. Current dashboard provides basic instance listing; Phase 8 adds production-grade observability and control.+Focuses on improving the dashboard user experience with real-time monitoring, batch operations, and better instance navigation. Current dashboard provides basic instance listing; Phase 8 adds production-grade observability and control.## Goals