Generate Cdp Spec

Generate the CDP Spec

Use the existing website generator. The Lynx source repository owns protocol metadata and custom method documentation; this repository owns the generated MDX and its presentation.

Locate the inputs

Run commands from the website repository root. Find the open-source Lynx checkout from the user's context or nearby checkouts, and verify these inputs:

• devtool/lynx_devtool/protocol/cdp_manifest.generated.yaml
• devtool/lynx_devtool/protocol/custom_cdp_docs/

Use the requested checkout or revision. If the inputs cannot be found, ask for the checkout path. Treat the generated manifest as authoritative for the protocol inventory and metadata, and the accompanying custom docs as the source for method details. Do not override them with assumptions from existing website pages, implementation code, or upstream CDP documentation.

If input validation fails or any suspected defect is found in the inputs, generator, or generated content, stop and prompt the user with the affected file or method, the evidence, and the decision needed. Wait for the user's direction before proceeding. Do not edit or regenerate the input manifest, patch custom docs or the generator, or work around the defect in the output. Ordinary missing or stale generated pages are expected regeneration work; they do not by themselves indicate an input or generator defect.

The default output base is docs/en/api/cdp/api-ref. Respect an explicitly requested alternative. --output-path must have no file extension; it produces <base>.mdx, <base>/<domain>.mdx, and <base>/_meta.json.

For input schemas, rendering details, or validation failures, read the generator guide.

Generate or check

Use Python 3 with PyYAML. Reuse a suitable environment; if needed, create a virtual environment in the website checkout and install the dependency:

python3 -m venv .venv
.venv/bin/python -m pip install PyYAML

Set LYNX_ROOT to the verified checkout path. With that environment, regenerate the English reference using:

LYNX_ROOT="/absolute/path/to/lynx"
.venv/bin/python packages/lynx-cdp/generate_cdp_docs.py \
  --write \
  --manifest "$LYNX_ROOT/devtool/lynx_devtool/protocol/cdp_manifest.generated.yaml" \
  --custom-docs "$LYNX_ROOT/devtool/lynx_devtool/protocol/custom_cdp_docs" \
  --output-path docs/en/api/cdp/api-ref

For a verification-only request, run the same command with --check instead of --write. This computes expected output without writing files and exits nonzero for missing, invalid, or stale output. After regeneration, run --check with the same inputs and output base to confirm the generated files are current.

Preserve ownership

• Review existing changes in the output paths before writing. The generator replaces the marked MDX blocks, rewrites the domain _meta.json, and removes generator-owned domain pages absent from the manifest.

• Keep hand-maintained frontmatter, introductions, and website components outside the generated block. Preserve these markers:

  {/* BEGIN GENERATED CDP REFERENCE */}
  {/* END GENERATED CDP REFERENCE */}

• Do not hand-edit generated English content to make a check pass. Follow the stop-and-prompt rule above when a defect is found.

• Custom methods whose summary begins with Initial documentation entry are counted but omitted from detailed sections by design. Preserve that behavior; do not fill in missing details or edit the source placeholders.