@hia-doc/cli

Command line entry for the HIA documentation system.

Current scope:

• hia --help
• hia docs build [--config <file>] [--input <file>] [--jsdoc-integration <file>] [--project-manifest <file>] [--out <dir>] [--locale <locale>] [--manifest <file>]

The build command reads config through @hia-doc/config, then renders one of three input modes:

• a normalized HIA document JSON file
• a JSDoc HIA Integration JSON file produced by @mandolin/jsdoc-plugin-hia-sys
• a project docs manifest that aggregates JS, CSS, HTML and doc-source-map artifacts into one project page

Single-document modes validate the converted core document through @hia-doc/core. Project mode keeps each source artifact explicit in the output manifest and renders a unified page with all/JS/CSS/HTML views. All modes report diagnostics, render through @hia-doc/renderer-html, write HTML/theme assets, and emit an output manifest. The default manifest path is hia-manifest.json.

Diagnostics use the shared HiaDiagnostic shape. The CLI still prints compact [severity:code] lines, while the in-process API keeps machine-readable data for callers.

--input, --jsdoc-integration and --project-manifest are mutually exclusive. Use --input for already-normalized core documents, --jsdoc-integration for JSON produced by @mandolin/jsdoc-plugin-hia-sys, and --project-manifest for a multi-artifact project aggregation manifest.

In the local workspace, run it through the root script after building:

pnpm run build
pnpm run hia -- --help
pnpm run hia -- docs build --input fixtures/basic.hia.json --out dist/docs
pnpm run hia -- docs build --input fixtures/basic.hia.json --out dist/docs-en --locale en
pnpm run hia -- docs build --input fixtures/basic.hia.json --out dist/docs-custom --manifest manifest.json
pnpm run hia -- docs build --jsdoc-integration fixtures/jsdoc-integration.real-basic.json --out dist/jsdoc-docs --locale zh-CN
pnpm run hia -- docs build --project-manifest fixtures/project-mixed.hia-project.json --out dist/project-docs
pnpm run hia -- docs build --config hia.config.example.json

CLI options override values from hia.config.json. Paths in config files are resolved relative to the config file directory.

Contract

The CLI consumes core documents and project config, then writes renderer output to disk. It may add build-output files such as hia-manifest.json, but it does not change the renderer manifest contract.

See docs/contract-index.md for the current CLI/config/renderer layering rule.