Rearchitect Perspectica around the V2 intelligence graph

[austinintelligence]

What changed

• Replace the legacy analysis/compass/validation production path with one ArticleIndex, adaptive Article Lens plan, bounded RetrievalCoordinator, shared evidence ledger, and evidence graph.
• Add Exa source-text and native ChatGPT global search-summary providers with canonical URL deduplication, exact excerpt validation, bounded caching, and no per-URL reads.
• Add MV3 journal replay, reconnectable runtime ports, persisted retry artifacts, ChatGPT-only auth boundaries, analysis depth modes, and a section-isolated ReportStore.
• Remove per-word motion and old production packages; add V2 architecture docs and benchmark reporting.

Validation

• pnpm verify (format, typecheck, 97 tests, production build)
• pnpm package:extension
• pnpm check:extension-package
• pnpm bench:v2
• pnpm audit --prod --audit-level=high

No live authenticated provider run was performed in this environment.

Summary by CodeRabbit

• New Features

  • Introduced a V2 analysis workflow with clearer stages for indexing, planning, research, perspective, and composition.
  • Added Fast, Balanced, and Deep analysis modes.
  • Added targeted retries for incomplete report sections.
  • Added reconnectable progress streaming with event replay.
  • Added research and analysis caching, plus a control to clear research cache.
  • Added evidence-backed report improvements and expanded source validation.

• Bug Fixes

  • Improved recovery from interrupted connections and partial analyses.
  • Improved progress reporting and stale-event handling.

• Documentation

  • Added V2 architecture and workflow documentation.

[Copilot]

Copilot wasn't able to review this pull request because it exceeds the maximum number of lines (20,000). Try reducing the number of changed lines and requesting a review from Copilot again.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 53c32044-6957-4965-8e66-8cf1910c33af

📥 Commits

Reviewing files that changed from the base of the PR and between 0b11077 and 5af50af.

⛔ Files ignored due to path filters (1)

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (100)

• README.md
• apps/extension/entrypoints/offscreen/main.ts
• apps/extension/entrypoints/sidepanel/AnalysisProgress.test.ts
• apps/extension/entrypoints/sidepanel/AnalysisProgress.tsx
• apps/extension/entrypoints/sidepanel/App.test.ts
• apps/extension/entrypoints/sidepanel/App.tsx
• apps/extension/entrypoints/sidepanel/Compass.tsx
• apps/extension/entrypoints/sidepanel/ProgressiveText.test.ts
• apps/extension/entrypoints/sidepanel/ProgressiveText.tsx
• apps/extension/entrypoints/sidepanel/Section.tsx
• apps/extension/entrypoints/sidepanel/SettingsScreen.tsx
• apps/extension/entrypoints/sidepanel/api.test.ts
• apps/extension/entrypoints/sidepanel/api.ts
• apps/extension/entrypoints/sidepanel/main.tsx
• apps/extension/entrypoints/sidepanel/preferences.test.ts
• apps/extension/entrypoints/sidepanel/preferences.ts
• apps/extension/entrypoints/sidepanel/report-state.test.ts
• apps/extension/entrypoints/sidepanel/report-state.ts
• apps/extension/entrypoints/sidepanel/report-store.test.ts
• apps/extension/entrypoints/sidepanel/report-store.ts
• apps/extension/package.json
• apps/extension/src/providers/chatgpt-evidence.ts
• apps/extension/src/providers/evidence.test.ts
• apps/extension/src/providers/exa-evidence.ts
• apps/extension/src/providers/exa.test.ts
• apps/extension/src/providers/exa.ts
• apps/extension/src/providers/native-chatgpt-search.test.ts
• apps/extension/src/providers/native-chatgpt-search.ts
• apps/extension/src/providers/request-gate.test.ts
• apps/extension/src/providers/request-gate.ts
• apps/extension/src/runtime/background-controller.test.ts
• apps/extension/src/runtime/background-controller.ts
• apps/extension/src/runtime/client.ts
• apps/extension/src/runtime/messages.test.ts
• apps/extension/src/runtime/messages.ts
• apps/extension/src/storage/analysis-artifacts.ts
• apps/extension/src/storage/evidence-cache.ts
• apps/extension/src/storage/job-journal.ts
• apps/extension/src/storage/job-store.ts
• apps/extension/src/storage/stores.test.ts
• docs/architecture-v2.md
• package.json
• packages/analysis/src/agentic-research.test.ts
• packages/analysis/src/agentic-research.ts
• packages/analysis/src/ai-sdk.test.ts
• packages/analysis/src/ai-sdk.ts
• packages/analysis/src/demo.ts
• packages/analysis/src/index.test.ts
• packages/analysis/src/index.ts
• packages/analysis/src/reader-copy.test.ts
• packages/analysis/src/reader-copy.ts
• packages/analysis/src/research-ai-sdk.test.ts
• packages/analysis/src/research-ai-sdk.ts
• packages/analysis/src/timeouts.ts
• packages/compass/package.json
• packages/compass/src/calibration.ts
• packages/compass/src/index.test.ts
• packages/compass/src/index.ts
• packages/compass/tsconfig.json
• packages/contracts/package.json
• packages/contracts/src/article.ts
• packages/contracts/src/events.ts
• packages/contracts/src/evidence.ts
• packages/contracts/src/limits.ts
• packages/contracts/src/preferences.ts
• packages/contracts/src/protocol.ts
• packages/contracts/src/report.ts
• packages/contracts/src/url.ts
• packages/extraction/src/article-index.ts
• packages/extraction/src/index.ts
• packages/intelligence/package.json
• packages/intelligence/src/article/context-selector.ts
• packages/intelligence/src/budgets.ts
• packages/intelligence/src/compass/calculate.ts
• packages/intelligence/src/evidence.test.ts
• packages/intelligence/src/evidence/evidence-graph.ts
• packages/intelligence/src/evidence/normalization.ts
• packages/intelligence/src/evidence/source-ledger.ts
• packages/intelligence/src/evidence/sufficiency.ts
• packages/intelligence/src/evidence/validation.ts
• packages/intelligence/src/index.ts
• packages/intelligence/src/pipeline.test.ts
• packages/intelligence/src/pipeline.ts
• packages/intelligence/src/planning/lens.ts
• packages/intelligence/src/planning/plan-schema.ts
• packages/intelligence/src/planning/prompts.ts
• packages/intelligence/src/report/projector.ts
• packages/intelligence/src/retrieval/coordinator.ts
• packages/intelligence/src/retrieval/scheduler.ts
• packages/intelligence/src/retrieval/types.ts
• packages/intelligence/src/synthesis/evidence-sections.ts
• packages/intelligence/src/synthesis/perspective.ts
• packages/intelligence/src/synthesis/reader-copy.ts
• packages/intelligence/src/telemetry.ts
• packages/intelligence/tsconfig.json
• packages/validation/package.json
• packages/validation/src/index.test.ts
• packages/validation/src/index.ts
• packages/validation/tsconfig.json
• scripts/benchmark-v2.mjs

---

📝 Walkthrough

Walkthrough

Changes

V2 intelligence pipeline

Layer / File(s)	Summary
Contracts, indexing, and planning packages/contracts/*, packages/extraction/*, packages/intelligence/src/article/*, packages/intelligence/src/planning/*	Adds validated V2 contracts, article indexing, bounded analysis budgets, article context selection, and adaptive analysis planning.
Evidence pipeline and report projection packages/intelligence/src/evidence/*, packages/intelligence/src/retrieval/*, packages/intelligence/src/synthesis/*, packages/intelligence/src/report/*, packages/intelligence/src/pipeline.ts	Adds evidence retrieval, validation, ledger storage, sufficiency checks, report projection, telemetry, pipeline events, cancellation, and targeted section retries.
Providers, runtime protocol, and persistence apps/extension/src/providers/*, apps/extension/src/runtime/*, apps/extension/src/storage/*, apps/extension/entrypoints/offscreen/main.ts	Adds Exa and native ChatGPT evidence retrievers, protocol-6 event handling, reconnectable runtime streaming, IndexedDB journals, artifact persistence, and evidence-cache management.
Side-panel state, progress, and settings apps/extension/entrypoints/sidepanel/*	Adds shared ReportStore state, pipeline-phase progress, replay-aware streaming, targeted retries, analysis-depth settings, cache clearing, and static rendering.
Documentation and verification tooling README.md, docs/architecture-v2.md, scripts/benchmark-v2.mjs, package.json	Documents the V2 architecture and adds a benchmark command for build and source measurements.

Estimated code review effort: 5 (Critical) | ~120 minutes

Suggested reviewers: copilot

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/perspectica-intelligence-graph-v2

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}