Roadmap

The canonical roadmap doc lives at docs/ROADMAP.md. This page is a digested, user-facing view.

v0.1.0 — alpha (here)

What's shipping today:

✅ C extension with Zend Observer API integration, full variable capture, Cap'n Proto trace writing.
✅ Rust daemon: DAP server, replay engine, HTTP API, WebSocket fanout.
✅ SolidJS UI with timeline scrubber, 18 panels, dark theme, Tailwind styling.
✅ Laravel adapter: 18 hooks — queries, logs, cache, jobs, batches, events, mail, notifications, redis, HTTP client, exceptions, models, views, gates, commands, schedules, request lifecycle, dd()/dump() captures.
✅ Insights panel: N+1 detection, slow-query analyser, AI advisor (opt-in via laravel/ai).
✅ AI-native MCP server via laravel/mcp (8 tools: list / trace / summary / insights / timeline / state / events / file).
✅ Floating toolbar chip + Web Vitals capture.
✅ Trace storage management UI + per-trace delete + bulk clear.
✅ Static .html export for sharing traces without a daemon.
✅ Event grouping + Datadog-style JSON-path payload filtering.
✅ One-line install script for macOS + Linux.
✅ Homebrew tap formula.
✅ PECL package.xml.
✅ VSCode extension scaffold (periscope debug type, daemon launcher, status bar).

Laravel skeleton CI harness running the framework's own test suite with periscope loaded.
Performance regression gate (< 3× overhead on Laravel homepage).
Bug-fix cycle from beta-tester reports.
VSCode Marketplace publish (periscopephp.php-periscope).
Cloudflare Pages deploy for this docs site.

PECL public release (pecl install periscope).
Homebrew tap repo (periscopephp/homebrew-php-periscope) split out from this repo.
Discord server + GitHub Discussions board for beta feedback.
Demo GIF + walkthrough video.

PHP 8.1 + 8.2 support.
Laravel 11.x support — pending laravel/mcp widening its illuminate/json-schema dep or shipping a vendored fallback.
Self-hosted trace sharing (periscope-share Rust binary + Mcp::web() mode).
Sampling profiler — opcode-level zoom, opt-in, 1-week sprint.
Safe-mode dry-run: opt-in PERISCOPE_DRYRUN=true that wraps the request in a DB transaction rolled back at RSHUTDOWN, stubs Mail/Queue/HTTP.
The dropped failed-jobs panel, if user demand surfaces.

Docs-only ship — see PhpStorm (via LSP4IJ).
Periscope's DAP daemon already works in PhpStorm via LSP4IJ. v1.2 documents the setup and pins the support contract: breakpoints, step over/into/out, variables, watches, evaluate all work; IDE-side stepBack is gated on LSP4IJ upstream. The browser UI scrubber remains the canonical time-travel surface.
Optional follow-up: upstream PR to redhat-developer/lsp4ij adding stepBack / reverseContinue request handling.

Symfony adapter package.
WordPress adapter package.
Production mode: sampling, snapshot-on-error, remote control plane.
Async runtime support: Fibers, Swoole, FrankenPHP, RoadRunner, Octane.
Per-opcode timing (sampling-based, opt-in).
Variable mutation tracking between captures.
OpenTelemetry export.
First-class JetBrains plugin (gutter affordances, run-config templates, embedded tool window). Only if beta demand justifies it — LSP4IJ-based reuse path covers ~80% of the UX in v1.2.
Closures / references / circular references — perfect-fidelity capture.

Items move between buckets based on:

Beta-tester demand. Real reports beat "wouldn't it be cool if".
Code budget — the maintainer's weekend hours.
Whether the work serves the four product pillars: fast, useful, easy to set up, easy to use.

Feature requests influence ordering. Self-classify into v1 / v1.1 / v2 in the template — we'll triage.