Skip to content

v0.7.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 13 Aug 10:45
· 941 commits to main since this release
v0.7.0
b0a8391

ManT 0.7.0

ManT 0.7.0 turns the reader into a navigable local documentation catalog and formalizes the shared IR and protocol used by the TUI, CLI, and MCP interfaces.

Highlights

  • Catalog discovery: list registered Markdown and native manuals with mant --list, or use ranked mant --find PATTERN queries where exact matches precede prefixes and prefixes precede substrings.
  • Clickable document navigation: underlined Markdown links and man-page references can be followed directly in the TUI, including page-local anchors, cross-document links, and references such as git-add(1). Successful jumps are recorded in backward/forward history, while Ctrl+O opens the live document finder.
  • Conventional selectors: read native manuals with forms such as mant git(1) and mant 1 git, select a native category with --man-section, or read an explicit Markdown or roff stream with --input.
  • Terminal-native tldr: mant NAME --tldr now emits concise TTY-aware ANSI output, uses plain text when redirected, and resolves embedded Markdown quick references and cache entries through the document priority model.
  • Hierarchical Markdown catalogs: source-owned document paths now support larger documentation sets, language variants, stable suffix matching, and restricted file symlinks without exposing directory traversal.
  • Self-hosted reference set: release archives and one-line installers now ship and register five discoverable manuals—mant(1), mant-protocol(5), mant-ir(7), mant-markdown(7), and mant-roff(7)—and publish the same set as a platform-independent manuals archive.
  • Stable integration boundaries: the new mant-ir and mant-protocol crates separate the normalized document model from versioned CLI JSON, MCP, schema, and host-facing projections.
  • Protocol v7: hierarchical discovery, typed document addresses, explicit manual categories, stable outline paths, schema compatibility snapshots, and logical MCP identities without local filesystem path disclosure.
  • Broader roff fidelity: modern manual references, groff MR fallbacks, delimiter roles, Pandoc verbatim fonts, and additional cross-manual navigation are preserved.

Breaking changes

  • --section has been removed because it ambiguously referred to both Unix manual categories and document headings. Use --man-section CATEGORY for native manuals and --node SELECTOR for document content; invoking the removed option prints both replacements.
  • Protocol schemas move to v7, mant-ast is replaced by mant-ir and mant-protocol, and mant-core is renamed to mant-engine.
  • Managed source caches moved from documents/sources/ to the sibling sources/ directory. Remove the old managed directory once, then run mant --update-docs to reinstall configured sources.

Install or update

Unix:

curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/BryanHeBY/ManT/main/scripts/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/BryanHeBY/ManT/main/scripts/install.ps1 | iex

Verify a release artifact

gh attestation verify mant-0.7.0-PLATFORM.EXT --repo BryanHeBY/ManT

The native archives include five ManT reference manuals, target-specific CycloneDX SBOMs, portable Sigstore bundles, SHA-256 checksums, and complete applicable license notices. A platform-independent manuals archive is also available for macOS and manual installation workflows.

Full changelog: v0.6.4...v0.7.0

Assets 14
Loading