Skip to content

v0.8.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 18 Aug 12:58
· 845 commits to main since this release
v0.8.0
b565ccb

ManT 0.8.0

ManT 0.8.0 adds bounded cross-document research, a compact text-first agent interface, and host-native manual discovery while aligning the pre-stable protocol with the 0.8 release line.

Highlights

  • Linked document scopes: query one or more initial manuals with repeated --document, expand typed manual and same-source Markdown links with --follow-links, and bound breadth-first traversal with --max-depth and --max-documents. Search, explain, request JSON, the TUI, and MCP share the same deterministic scope model.
  • Observable traversal: JSON and compact MCP results distinguish unresolved roots, unresolved links, depth limits, document limits, and the aggregate content budget instead of silently omitting documents beyond a traversal boundary.
  • Compact agent tools: the five read-only MCP tools now return bounded plain text or CommonMark, use stable logical document IDs and opaque cursors, support multi-document search and explanation, and avoid duplicated AST-shaped JSON, host paths, ordinary parser diagnostics, and mutation capabilities.
  • Native manual discovery: Linux follows man-db and mandoc configuration, macOS follows man.conf plus the active Xcode or Command Line Tools tree, and Windows supports a ManT-owned man.conf; MANT_MANPATH remains the explicit cross-platform override.
  • Offline diagnostics: mant --doctor inspects effective data paths, installed sources, document and manual coverage, bundled libmandoc, optional Git support, and tldr caches without network access or mutation. JSON output uses the independent mant.doctor/v1 contract.
  • Precise search and terminal output: matches are grouped by outline node and rendered line, visible-text coordinates remain usable around Markdown markup, Unicode regexes cannot create invalid byte ranges, and partial-query text keeps deterministic plain output outside capable terminals.
  • Broader roff fidelity: synopsis heads and no-fill lines, mdoc enclosures, explicit spacing, named special characters, nested copy escapes, and legacy Sphinx manual references remain visible and navigable across CLI, TUI, JSON, and MCP views.
  • Stronger resource boundaries: linked scopes, Git source materialization, MCP request lines, retained search details, and terminal-controlled text are bounded or sanitized consistently.

Breaking changes

  • The native query protocol moves from the experimental bare v7 identifiers to release-aligned v0.8 identifiers such as mant.request/v0.8, mant.query/v0.8, and mant.catalog/v0.8. Bare v1 through v7 requests are no longer accepted; regenerate clients from mant --schema all and inspect exact identifiers with mant --protocol-version.
  • Search, outline, excerpt, catalog, and new scope projections use the v0.8 wire shape, including shared outline trails, typed logical addresses, exact coordinate metadata, grouped matches, and explicit traversal state. Patch releases in the 0.8.x line retain this shape.
  • MCP success results are now compact text-first responses rather than duplicated structuredContent plus serialized JSON. Clients that depended on the former payload should refresh tools/list and consume each tool's bounded text contract.

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.8.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 remains available for macOS and manual installation workflows.

Full changelog: v0.7.1...v0.8.0

Assets 14
Loading