Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 26 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,9 +78,9 @@ Contains every command / function / ISV / operator / pattern code
from any source, with abbreviation prefix-form expansion already
done (~954 keyword forms total) and `standard_status` per token.

This is what [`m-parser`](../m-parser/) (the tree-sitter grammar
project, sibling repo) consumes at build time. See
[`docs/m-standards-guide.md`](docs/m-standards-guide.md) for the
This is what [`tree-sitter-m`](https://github.com/m-dev-tools/tree-sitter-m)
(the tree-sitter grammar project, sibling repo) consumes at build time.
See [`docs/m-standards-guide.md`](docs/m-standards-guide.md) for the
human-readable reference.

### Cross-vendor mappings
Expand Down Expand Up @@ -108,19 +108,28 @@ exit code is non-zero if any F/S findings exist (CI-gate-friendly).

## Downstream consumers

- **[`m-parser`](../m-parser/)** ([spec](../m-parser/docs/spec.md))
- **[`tree-sitter-m`](https://github.com/m-dev-tools/tree-sitter-m)**
tree-sitter grammar for M, generated mechanically from
`integrated/grammar-surface.json`. Single coupling point with
m-standard, pinned to a specific `schema_version`. Specification
phase as of writing; implementation is a separate project.
- **`tree-sitter-m-lint`** (planned sibling of m-parser) — consumes
m-parser's AST plus m-standard's tier classifications
(operational / pragmatic / SAC) to enforce developer-chosen
profiles.
- **[`vista-meta`](../vista-meta/)** — VEHU classification sandbox;
joins m-standard's per-concept TSVs against VistA's code-model TSVs.
m-standard, pinned to a specific `schema_version`. Production-ready
with v0.1 publish-ready (99.06% clean on the 39,330-routine VistA
corpus).
- **[`m-cli`](https://github.com/m-dev-tools/m-cli)** — the
`m fmt`/`m lint`/`m test`/`m coverage`/`m doc` toolchain. Consumes
m-standard's tier classifications (operational / pragmatic / SAC) to
enforce developer-chosen lint profiles, plus the abbrev↔canonical
command/ISV/function maps for `m fmt --rules=pythonic` and
`--rules=compact`.
- **[`m-stdlib-vscode`](https://github.com/m-dev-tools/m-stdlib-vscode)
and
[`tree-sitter-m-vscode`](https://github.com/m-dev-tools/tree-sitter-m-vscode)** —
editor extensions that surface m-standard data (token tier, syntax
format, hover docs) directly in VS Code.
- **`vista-meta`** *(separate VistA-specific repo, not in
m-dev-tools)* — joins m-standard's per-concept TSVs against
VistA's code-model TSVs for VEHU classification work.
- **AI agents and other M tooling** — the integrated TSV+JSON pair
is prompt-pack target. Any agent reasoning about M code can be
is a prompt-pack target. Any agent reasoning about M code can be
loaded with these as ground truth — no hallucination about whether
`$ZSEARCH` is standard, no guessing at command abbreviations.

Expand Down Expand Up @@ -182,10 +191,10 @@ m-standard/
schema changes don't bump the version; breaking changes bump and
announce in the changelog.

Downstream consumers (m-parser, lint tools, vista-meta, AI agents)
pin against a specific `schema_version` rather than the project
version. Additive m-standard updates flow through; breaking ones
require deliberate adoption.
Downstream consumers (tree-sitter-m, m-cli, the VS Code extensions,
vista-meta, AI agents) pin against a specific `schema_version`
rather than the project version. Additive m-standard updates flow
through; breaking ones require deliberate adoption.

## License

Expand Down
Loading