docs: add Phase 19 performance baselines and capacity analysis

[FSM1]

Summary

• Add comprehensive Phase 19 performance baselines (19-someguy-ipns-baselines.md)
• Scaling curve from 10 to 200 concurrent clients against staging
• Upload flow latency breakdown from Prometheus server-side metrics
• Capacity analysis identifying Kubo IPFS pinning as the bottleneck

Key findings

• Max error-free concurrency: 100 clients (zero errors across all operations)
• Throughput ceiling: ~24-28 ops/s on staging VPS (4 vCPU, 8GB)
• Throughput knee at ~50 clients: Kubo pin concurrency saturates
• First errors at 200 clients: 4/8,734 ops (0.05% error rate)
• Bottleneck: Kubo IPFS pinning (~1.56s mean, 95% of upload endpoint time)
• uploadFile = 3 sequential pins + 2 IPNS publishes: pins dominate, IPNS is fast (DB upsert only)

Other changes

• Gitignore load test metrics JSON artifacts
• Minor CLAUDE.md staging tag documentation update
• Remove completed todo (investigate someguy IPNS routing failure locally)

Test plan

• All load test runs completed successfully on staging (10/20/30/50/75/100/200 clients)
• Prometheus metrics scraped and analyzed after each run
• Documentation only — no code changes

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Updated performance baseline documentation with comprehensive load testing results including throughput scaling behavior, latency percentiles, and error patterns across varying client concurrency levels.
  • Added detailed server-side latency breakdown and performance metrics for upload operations.
  • Refined performance comparison targets to leverage newly documented test observations instead of requiring additional test runs.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 07cea9fb-1dd3-4b12-b80f-96e91e5a4bfb

📥 Commits

Reviewing files that changed from the base of the PR and between 222bea7 and 2e85b59.

📒 Files selected for processing (1)

• .planning/baselines/19-someguy-ipns-baselines.md

🚧 Files skipped from review as they are similar to previous changes (1)

• .planning/baselines/19-someguy-ipns-baselines.md

---

Walkthrough

Phase 19 performance baseline documentation updated with extended load test results for mixed workload scaling (10–200 clients), including throughput and latency metrics, along with server-side latency breakdown from Prometheus showing sequential API call attribution. Instructions for additional k6 load tests replaced with newly documented scaling and latency data.

Changes

Cohort / File(s)	Summary
Performance Baseline Documentation .planning/baselines/19-someguy-ipns-baselines.md	Added "Extended Load Test: Mixed Workload Scaling" section with throughput/latency percentiles (p50/p95/p99) across client counts and scaling observations; added "Upload Flow Latency Breakdown" section with server-side metric attribution to five sequential API calls; removed instructions for additional k6 load tests at higher concurrency.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• docs: add Phase 19 someguy IPNS performance baselines #336: Adds identical Phase 19 "someguy IPNS" performance baseline documentation to the same baseline file.

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the primary change: adding Phase 19 performance baselines and capacity analysis documentation.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/phase-19-baselines

---

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 and usage tips.}