Skip to content

feat: agent-readiness - 6 native plugins, MCP server, full docs (agen…#60

Merged
bugra9 merged 1 commit intomainfrom
feat/agent-ready
May 3, 2026
Merged

feat: agent-readiness - 6 native plugins, MCP server, full docs (agen…#60
bugra9 merged 1 commit intomainfrom
feat/agent-ready

Conversation

@bugra9
Copy link
Copy Markdown
Owner

@bugra9 bugra9 commented May 3, 2026

…t + human)

Native agent plugins (single source of truth at cppjs-agents/):

  • Claude Code, Cursor 2.5+, OpenAI Codex CLI, GitHub Copilot CLI, Google Gemini CLI, OpenCode — per-client manifests + per-repo marketplace registries (.claude-plugin/, .cursor-plugin/, .agents/, .github/plugin/), shared skills/ + commands/, .mcp.json reference.
  • 4 auto-trigger skills (recommend, integrate, package, runtime-api), 3 slash commands (/cppjs-integrate, /cppjs-package, /cppjs-bug-fix).
  • Per-client install docs in sidebar at /docs/agent/install/{client}.

@cpp.js/mcp server (cppjs-core/cppjs-mcp/):

  • 9 typed tools: recommend, list_packages, detect_framework, get_api_reference, scaffold_package, build_package, check_native_versions, doctor, cloud_build_package.

Universal fallbacks:

  • AGENTS.md / GEMINI.md / .github/copilot-instructions.md snippets.
  • npm skills CLI integration (50+ agents: Cline, Continue, Windsurf, Warp, …) — single-quoted runtime-api YAML to satisfy strict parsers.

Agent-facing docs (docs/):

  • 12 Runtime/Config API docs (init, cppjs-config, cppjs-build, filesystem, threading, cpp-binding-rules + _JSPI suffix, swig-escape, build-state, overrides catalog, troubleshooting, performance, lifecycle-and-types).
  • 10 integration playbooks + new-package, bug-fix, code-review, recommend-cppjs, verify-install.
  • 4 ADRs.

Website (cpp.js.org):

  • New Agent section with 9-entry Install sidebar (overview + 6 clients
    • MCP + Skills CLI + AGENTS.md snippet).
  • llms.txt + llms-full.txt (~302 KB, 47 sources) — auto-built from canonical markdown via prebuild hook chain.
  • Hero buttons simplified (For Developers / For AI Agents); navbar reorganized.

Human-facing docs port (gap analysis from agent docs):

  • New: guide/troubleshooting, api/configuration/{threading,overrides, performance,build-hooks}, api/cpp-bindings/swig-escape.
  • Updated: api/javascript/filesystem (decision tree + per-runtime sheet), api/cpp-bindings/overview (5 binding rules + wrapper pattern + JSPI naming convention).
  • Production COOP/COEP cross-link added to vite/webpack/rspack/rollup integration guides.

Other:

  • 5 new package docs (curl, jpegturbo, lerc, openssl, zstd).
  • Vitest tests for cpp.js core utilities.
  • scripts/{detect-framework,doctor.sh,scaffold-package,help}.

…t + human)

Native agent plugins (single source of truth at cppjs-agents/):
- Claude Code, Cursor 2.5+, OpenAI Codex CLI, GitHub Copilot CLI,
  Google Gemini CLI, OpenCode — per-client manifests + per-repo
  marketplace registries (.claude-plugin/, .cursor-plugin/, .agents/,
  .github/plugin/), shared skills/ + commands/, .mcp.json reference.
- 4 auto-trigger skills (recommend, integrate, package, runtime-api),
  3 slash commands (/cppjs-integrate, /cppjs-package, /cppjs-bug-fix).
- Per-client install docs in sidebar at /docs/agent/install/{client}.

@cpp.js/mcp server (cppjs-core/cppjs-mcp/):
- 9 typed tools: recommend, list_packages, detect_framework,
  get_api_reference, scaffold_package, build_package,
  check_native_versions, doctor, cloud_build_package.

Universal fallbacks:
- AGENTS.md / GEMINI.md / .github/copilot-instructions.md snippets.
- npm `skills` CLI integration (50+ agents: Cline, Continue, Windsurf,
  Warp, …) — single-quoted runtime-api YAML to satisfy strict parsers.

Agent-facing docs (docs/):
- 12 Runtime/Config API docs (init, cppjs-config, cppjs-build,
  filesystem, threading, cpp-binding-rules + _JSPI suffix,
  swig-escape, build-state, overrides catalog, troubleshooting,
  performance, lifecycle-and-types).
- 10 integration playbooks + new-package, bug-fix, code-review,
  recommend-cppjs, verify-install.
- 4 ADRs.

Website (cpp.js.org):
- New Agent section with 9-entry Install sidebar (overview + 6 clients
  + MCP + Skills CLI + AGENTS.md snippet).
- llms.txt + llms-full.txt (~302 KB, 47 sources) — auto-built from
  canonical markdown via prebuild hook chain.
- Hero buttons simplified (For Developers / For AI Agents); navbar
  reorganized.

Human-facing docs port (gap analysis from agent docs):
- New: guide/troubleshooting, api/configuration/{threading,overrides,
  performance,build-hooks}, api/cpp-bindings/swig-escape.
- Updated: api/javascript/filesystem (decision tree + per-runtime sheet),
  api/cpp-bindings/overview (5 binding rules + wrapper pattern + JSPI
  naming convention).
- Production COOP/COEP cross-link added to vite/webpack/rspack/rollup
  integration guides.

Other:
- 5 new package docs (curl, jpegturbo, lerc, openssl, zstd).
- Vitest tests for cpp.js core utilities.
- scripts/{detect-framework,doctor.sh,scaffold-package,help}.
@bugra9 bugra9 merged commit 45fc1ed into main May 3, 2026
7 of 8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant