lpd CLI

The lpd CLI is the single entry point for contributing to these docs. One Bash script (tools/lpd) wraps setup, environment checks, scoped Mintlify preview, staged tests, governed file moves, repair flows, and access to the 341 scripts under operations/scripts/. You do not need to install Mintlify or Node packages by hand.

This page is the public quickstart. For the full reference – every subcommand, every flag, JSON envelopes, and the script catalogue – see the canonical reference at docs-guide/tooling/lpd-cli.

Five-minute quickstart

Install and verify

bash lpd setup --yes      # installs hooks, deps, optionally adds lpd to your $PATH
lpd doctor                # confirms Node, Mintlify, Puppeteer, hooks, PATH

Boot a scoped Mintlify preview

lpd dev --scoped --scope-tab Developers

A filtered dev server against the 1,128-page nav boots in ~2 seconds instead of ~10 minutes for a cold full build. Tab names fuzzy-match (Orch, Resource, Gate).

Run the same checks CI runs

lpd test --staged     # only your changes
lpd ci --skip-browser # full PR CI suite, skip Puppeteer (faster)

Move pages without breaking links

lpd move-page v2/from/path.mdx v2/to/path.mdx

Rewrites every incoming reference, updates docs.json, regenerates affected catalogue.

Repair drift

lpd repair --surface <id> --staged

Runs the deterministic remediator for a governed surface against staged files. Surfaces are listed in operations/governance/config/ownerless-governance-surfaces.json.

Subcommand summary

lpd ships 13 subcommands plus 5 group shorthands.

Command	What it does
`lpd help`	Print the full subcommand list with one-line descriptions
`lpd info`	Resolve repo root, branch, environment summary
`lpd version`	Print the CLI version
`lpd setup`	Install hooks, deps, optional PATH install
`lpd doctor`	Verify environment – Node, Mintlify, Puppeteer, hooks, PATH
`lpd dev` (alias: `lpd mint`)	Boot Mintlify dev server, scoped or full
`lpd test`	Run validators (staged, full, or specific scopes)
`lpd ci`	Full PR CI suite, locally
`lpd repair`	Run a remediator for a governed surface
`lpd move-page`	Governed file move with reference rewrites
`lpd ai-sitemap`	Regenerate `sitemap-ai.xml`
`lpd hooks`	Manage git hooks (install, status, verify)
`lpd scripts`	Discover and run any of 341 governed scripts

Group shorthands route into operations/scripts/ subtrees: lpd tools, lpd tests, lpd v2, lpd workspace, lpd hooks.

Common workflows

Edit a page
Add a component
Add a script
Move or rename pages

bash lpd setup --yes
lpd dev --scoped --scope-tab <your-tab>
# edit MDX
lpd test --staged
git commit -m "docs: <change>"

The pre-commit hook runs MDX render checks, allowlist guards, redirect integrity, and no-deletion enforcement in under 60 seconds.

lpd dev --scoped --scope-tab <tab>     # render check
lpd test --staged                       # 7-tag JSDoc validation
node operations/scripts/generators/components/library/generate-component-registry.js --write
lpd test --staged

Read docs-guide/frameworks/component-framework-canonical before authoring.

# author with 11-tag JSDoc header (see frameworks/script-framework)
lpd test --staged       # runs script-docs.test.js
node operations/tests/unit/script-docs.test.js --rebuild-indexes --write
lpd scripts list --group v2

Read docs-guide/frameworks/script-framework before authoring.

lpd move-page v2/old/path.mdx v2/new/path.mdx
lpd test --staged

move-page rewrites every incoming reference, updates docs.json, and regenerates affected catalogue. For files with more than five incoming references, run the /propagate skill afterwards to audit cross-surface references (sitemap-ai.xml, llms.txt, etc.).

Scoped preview – why it matters

Mintlify cold-starts the full 1,128-page docs-v2 in roughly ten minutes. lpd dev --scoped --scope-tab <Tab> boots a filtered profile in ~2 seconds.

# scope by tab name
lpd dev --scoped --scope-tab Gateways

# scope by route prefix
lpd dev --scoped --scope-prefix /v2/resources/

# discover available scopes
lpd dev --scope-list

# interactive picker
lpd dev --scope-interactive

Alternate config loaders (docs-orch-work.json, docs-gate-work.json) drive themed scoped builds for cross-tab pipeline work.

Repair flows

lpd repair --surface component-governance --write --staged
lpd repair --surface em-dashes --write
lpd repair --surface us-spelling --write --language en-gb

Available surfaces live in operations/governance/config/ownerless-governance-surfaces.json. Each declares its validator, remediator, repair command, and gate layer.

Canonical CLI reference

Every subcommand, every flag, JSON envelopes, error codes, and the full script catalogue.

Contribute to the docs

End-to-end contributor flow from fork to merged PR.

MDX preview extension

lpd-mdx-preview VS Code extension – render the full component library without running Mintlify.

Docs Guide overview

The complete docs-as-infrastructure overview with the IA tree, all features, and governance contracts.

Technical References

Compendium

Knowledge Hub

Changelogs

Documentation Guide

Five-minute quickstart

Subcommand summary

Common workflows

Scoped preview – why it matters

Repair flows

Canonical CLI reference

Contribute to the docs

MDX preview extension

Docs Guide overview

​Five-minute quickstart

​Subcommand summary

​Common workflows

​Scoped preview – why it matters

​Repair flows

​Related

Canonical CLI reference

Contribute to the docs

MDX preview extension

Docs Guide overview

Five-minute quickstart

Subcommand summary

Common workflows

Scoped preview – why it matters

Repair flows

Related