澳新法研MCP

Install the CLI persistently from NPM or directly from GitHub

npm published package

npm install -g jurisd
jurisd --help

npm install via git directly, including your own fork

npm install -g https://github.com/russellbrenner/jurisd/archive/refs/heads/main.tar.gz
jurisd --help

NB: Bare git installs such as npm install -g github:russellbrenner/jurisd depend on npm's install-links setting and can leave a broken global bin on hosts where install-links=false.

Installing modules

Modules are operator-installed via the CLI (kept off the tool surface so an LLM never triggers a large download mid-conversation):

jurisd fetch-module <name> [--modules-dir DIR]   # download + sha256-verify + atomic install
jurisd verify-module <name> [--modules-dir DIR]  # re-verify installed files against the manifest
jurisd list-modules [--modules-dir DIR]          # list installed modules (incl. refused)

The default install root is ~/.jurisd/modules/ (override with JURISD_MODULES_DIR or --modules-dir). fetch-module validates the manifest and checks the schema version before downloading any parquet, sha256-verifies every file against the manifest, installs atomically (temp-then-rename, so a half-written module never appears), and prints the licence attribution lines at install time.

Advanced operators can pass --manifest-url URL to install from an explicitly trusted manifest. The sha256 checks prove downloaded files match that manifest; they do not prove the manifest's provenance or protect against a malicious or compromised manifest source.

Docker

./build.sh         # build the image
docker-compose up  # run locally

See docs/DOCKER.md for details.

Quick start

Example queries for AI assistants

Once connected, ask natural-language questions:

• "Find the High Court decision in Mabo v Queensland (No 2) and explain native title."
• "Search for recent NSW cases about defamation on social media."
• "What does section 18 of the Australian Consumer Law say?" (answered offline if the module is installed)
• "Find cases that cite Mabo v Queensland (No 2)."
• "Format Mabo v Queensland (No 2) [1992] HCA 23 (1992) 175 CLR 1 per AGLC4 at [64]."
• "Compare how Victoria and NSW courts have treated non-compete clauses."

CLI foundation and compatibility

jurisd keeps the MCP server as the compatibility surface while the CLI is being reorganised around task-oriented command contracts.

• CLI guide: docs/CLI.md
• MCP compatibility reference: docs/MCP-COMPATIBILITY.md
• Security and authority model: docs/SECURITY-AUTHORITY.md

Existing flat CLI commands remain available during the foundation work.

Local data modules (offline recall)

These five tools serve installed offline data modules. They require the optional @duckdb/node-api dependency and at least one installed module; semantic_search_local additionally needs @huggingface/transformers. Every answer carries metadata.source = "local_module" with the module name, version, and snapshot date (plus a staleness advisory when the snapshot is old).

Full parameter tables for every tool are in docs/AGENT-GUIDE.md.

Data modules

A data module is a self-describing parquet bundle (documents, chunks, edges, unmatched citations, plus a manifest.json) published as a Hugging Face dataset. Everything needed to load and query a module — schema version, coverage, embedding descriptor, file hashes, and licence posture — is in its manifest. No out-of-band config.

Status: first module published. legislation-cth is available from workingmem/legislation-cth on Hugging Face. It provides Commonwealth primary and secondary legislation, 32,143 documents, 857,262 chunks, citation edges, unmatched citations, and local bge-small embeddings. Running jurisd fetch-module legislation-cth downloads the manifest and parquet files from Hugging Face, verifies every file against the manifest sha256 values, and installs the module atomically.

Modules are queried in place: DuckDB scans the parquet on disk and never materialises a whole table into memory, so a host can install many modules (Commonwealth legislation + per-state + decisions) and stay flat in RSS.

Baseline vs domain-specialised variants

A module's identity is (name, module_version). The module_version handle distinguishes a module's variant — a baseline module is the standard build (deterministic structure, citation edges, bge-small embeddings); a domain-specialised variant is a build tuned for a particular corpus or task. Use list_data_modules to see the variant, coverage, and embedding descriptor of each installed module, and pin a specific one with the module argument on any recall tool.