Skip to content

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.json
index 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.md
deleted file mode 100644
index 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.md
similarity index 99%
rename from docs/proposals/phase-7-performance-optimization.md
rename to docs/proposals/performance-optimization.md
index 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
## Overview
diff --git a/docs/proposals/phase-8-dashboard-ui-enhancements.md b/docs/proposals/ui-enhancements.md
similarity index 97%
rename from docs/proposals/phase-8-dashboard-ui-enhancements.md
rename to docs/proposals/ui-enhancements.md
index 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