Add comprehensive capabilities map and project ideas documentation

[Copilot]

Pull Request

Description

What does this PR do?

Adds docs/PROJECT_IDEAS.md containing a complete capabilities map of the Fetch PHP package and 10 project ideas designed to maximize feature coverage.

Capabilities Map covers:

• Core modules (Http, Enum, Cache, Pool, Testing, Support)
• All APIs: fetch(), fetch_client(), HTTP helpers, Matrix async utilities
• Request/Response configuration (22+ options)
• RFC 7234 caching, connection pooling, HTTP/2
• Retry mechanics, debugging, profiling
• Testing utilities (MockServer, Recorder)

10 Project Ideas each with:

• Feature coverage plan (package feature → project usage mapping)
• Architecture (components, happy/failure paths)
• MVP scope and differentiators
• Complexity rating

Recommendation: API Health Dashboard ranked #1 for feature coverage (18/22), usefulness, and buildability.

Type of Change

• 📚 Documentation update

Changes Made

• Created docs/PROJECT_IDEAS.md with structured analysis
• Documented all package features in tabular format
• Designed 10 projects exercising async, caching, pooling, retry, mocking, profiling
• Ranked top 3 projects with justification
• Included MVP code outline for recommended project

Testing

How has this been tested?

• Manual testing performed
• All existing tests pass

Documentation-only change. Code examples verified against actual API signatures in source.

Test Environment:

• PHP Version: N/A (documentation)
• Operating System: N/A

Documentation

• Code is self-documenting with clear variable names and logic
• README.md updated (if applicable)

Checklist

• My code follows the project's coding standards
• I have performed a self-review of my code
• My changes generate no new warnings or errors

Additional Notes

Code examples use actual API patterns from the codebase:

$handler = fetch_client()->getHandler()
    ->withConnectionPool()
    ->withHttp2()
    ->withProfiler($profiler)
    ->retry(3, 100);

$checks = await(map($endpoints, fn($ep) => 
    async(fn() => $handler->get($ep['url']))
, 10));

print_r($handler->getPoolStats());
print_r($profiler->getSummary());

Original prompt

Study this repository end-to-end (README, docs, /src, examples, tests, and composer.json) and build a complete “capabilities map” of what this PHP package can do (major modules, APIs/classes, configuration options, integrations, and any advanced/edge features).

Then brainstorm 8–12 project ideas where each idea is intentionally designed to exercise as much of the package as possible.

For each idea, include:

1. Concept

   • Name + 1–2 sentence pitch
   • Target users + primary use case

2. Feature Coverage Plan (required)

   • A checklist/table mapping package features → how this project uses them
   • Call out any feature not used and explain why (or propose an alternative project that would)

3. Architecture

   • High-level components (CLI/web/API/queue/db/etc.)
   • Key flows (happy path + one failure path)

4. MVP

   • Smallest shippable version (weekend scope)
   • Sample endpoints/commands/screens (as applicable)

5. Differentiators

   • 3–5 features that make it “demo-worthy”
   • What makes it better than a naive implementation without this package

6. Risks & Requirements

   • Assumptions, constraints, and rough complexity (S/M/L)

After listing the ideas:

• Rank the top 3 by (a) feature coverage, (b) real-world usefulness, and (c) buildability.
• Recommend one project to build first and justify it using the feature-coverage map.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[netlify]

✅ Deploy Preview for fetch-php canceled.

Name	Link
🔨 Latest commit	c1f1a15
🔍 Latest deploy log	https://app.netlify.com/projects/fetch-php/deploys/693dc80007ef3f0008ea1e2c