automaintainer: Improve supercli static documentation: README, CONTRIBUTING…

[javimosch]

Automated maintenance run by automaintainer.

Focus: Improve supercli static documentation: README, CONTRIBUTING, or docs/ files. Make ONE atomic commit with clear summary explaining what documentation was improved and WHY. Use fix:/docs: prefix. Keep it focused and reviewable.

Branch: am/am-f17c27-tgaevy

Summary

Expanded adapter documentation in docs/features/adapters.md from 29 to 180+ lines with detailed configuration examples for all 6 adapter types (HTTP, OpenAPI, MCP, Process, Shell, Custom). Updated PLUGIN_STANDARDS.md Phase section with current metrics (92.1% quality score, 416 DESCRIPTIONS map entries) and added Phase 4 target. Improved docs/feature-gaps.md with roadmap cross-references and gap analysis by priority level.

Diff:

PLUGIN_STANDARDS.md       |  12 +-
 docs/feature-gaps.md      |  73 ++++++++++--
 docs/features/adapters.md | 298 +++++++++++++++++++++++++++++++++++++++++++---
 3 files changed, 354 insertions(+), 29 deletions(-)

Summary by CodeRabbit

Release Notes

• Documentation
  • Enhanced plugin standards documentation with progress metrics and phase planning updates
  • Expanded feature gaps guide with roadmap alignment, capability analysis, and priority-based categorization
  • Introduced comprehensive adapter reference with type matrix, configuration examples, selection guide, and troubleshooting table

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 10378793-05ef-4ea4-9291-979cd6e01878

📥 Commits

Reviewing files that changed from the base of the PR and between 8b25b7f and fc86fbc.

📒 Files selected for processing (3)

• PLUGIN_STANDARDS.md
• docs/feature-gaps.md
• docs/features/adapters.md

---

📝 Walkthrough

Walkthrough

This PR expands three documentation files to improve visibility into development progress, known capability gaps, and adapter configuration patterns. PLUGIN_STANDARDS.md receives updated phase-completion metrics, docs/feature-gaps.md becomes a structured capability-gap reference with roadmap alignment, and docs/features/adapters.md transforms into a comprehensive adapter guide with types, configuration details, examples, and troubleshooting.

Changes

Documentation Expansion

Layer / File(s)	Summary
Plugin Phase Completion Metrics PLUGIN_STANDARDS.md	Updated Phase Completion progress to add generic source-URL reduction metric (86→55) and revised Phase 3/Phase 4 status with automation work notes, plugin quality score (92.1%), and coverage targets.
Feature Capability Gaps & Roadmap Alignment docs/feature-gaps.md	Expanded from single table into structured gap document: added intro/ROADMAP reference, "Current Capabilities (Shipping)" table, enhanced gaps-vs-vision table with Roadmap Phase column, priority-based gap analysis (High/Medium/Lower with effort), and explicit phase-to-gap mapping.
Adapter Types Overview & Matrix docs/features/adapters.md	Added introductory adapter explanation and matrix table describing six adapter types (HTTP, OpenAPI, MCP, Process, Shell, Custom) with use cases.
Detailed Adapter Configuration & Implementation docs/features/adapters.md	Added comprehensive sections for each adapter type covering configuration structures, supported methods, parameter interpolation, OpenAPI command generation, MCP transport modes (HTTP/SSE vs stdio), server management commands, and Shell/Custom adapter security controls.
Adapter Selection Guide & Troubleshooting Reference docs/features/adapters.md	Added adapter selection table mapping use cases to types, concrete JSON examples (GitHub API via HTTP and MCP filesystem via stdio), and troubleshooting table covering adapter-not-found, timeouts, JSON parse, MCP connection, and shell safety issues.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• javimosch/supercli#189: Updates PLUGIN_STANDARDS.md Phase Completion metrics in the same file, overlapping directly with phase-progress changes in this PR.

Poem

🐰 The docs now bloom with clarity bright,
Phase metrics, gaps, and adapters in sight,
From standards to features, the roadmap takes flight,
A warren of knowledge, carefully right! 📚✨

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch am/am-f17c27-tgaevy

---

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.}