aontu 0.56.0 → 0.57.0

package/dist/val/StrFuncVal.js

@@ -0,0 +1,292 @@
+"use strict";
+/* Copyright (c) 2025 Richard Rodger, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SplitFuncVal = exports.RepFuncVal = exports.UscFuncVal = exports.EscFuncVal = void 0;
+const err_1 = require("../err");
+const escape_1 = require("../escape");
+const StringVal_1 = require("./StringVal");
+const ListVal_1 = require("./ListVal");
+const FuncBaseVal_1 = require("./FuncBaseVal");
+const ConstraintVal_1 = require("./ConstraintVal");
+// The string a value carries, or undefined when it is not a string.
+// Mirrors `stringLeaf` in ConstraintVal: a path is a string too, so a
+// spelled address may be escaped and split like any other text.
+function textOf(v) {
+    const s = v;
+    return true === s?.isScalar && 'string' === typeof s.peg ? s.peg : undefined;
+}
+// The variant an optional second argument names: '' for the absent
+// argument (the C/JSON convention), or undefined when it is not a
+// variant name.
+function variantOf(v) {
+    if (null == v) {
+        return '';
+    }
+    const s = textOf(v);
+    return undefined !== s && (0, escape_1.isEscVariant)(s) ? s : undefined;
+}
+// The number of CAPTURING groups in a normalised pattern. Counted by
+// scanning rather than by asking either host, because the count decides
+// whether a substitution is refused and the two ports must refuse the
+// same ones. The subset admits no named groups, so a capturing group is
+// exactly `(` that is not `(?`.
+function reGroupCount(norm) {
+    let count = 0;
+    let inClass = false;
+    for (let i = 0; i < norm.length; i++) {
+        const c = norm[i];
+        if ('\\' === c) {
+            i++;
+            continue;
+        }
+        if (inClass) {
+            if (']' === c) {
+                inClass = false;
+            }
+            continue;
+        }
+        if ('[' === c) {
+            inClass = true;
+            continue;
+        }
+        if ('(' === c && '?' !== norm[i + 1]) {
+            count++;
+        }
+    }
+    return count;
+}
+// One code point at `at`, as a count of UTF-16 units: the "advance by
+// one rune" Go's matching loop performs after an empty match.
+function stepAt(src, at) {
+    const c = src.codePointAt(at);
+    return undefined === c ? 1 : (0xFFFF < c ? 2 : 1);
+}
+// Every match of `re` in `src`, as [start, end, ...group pairs], under
+// Go's rule: scanning resumes at the end of each match, and an empty
+// match ADJACENT to the previous match's end is skipped rather than
+// delivered. Written out because JavaScript has no equivalent and the
+// difference is visible in `rep("aa", "a*", "-")`.
+function allMatches(src, re) {
+    const out = [];
+    // Its own scanner, so `lastIndex` is this walk's to move: the caller's
+    // regexp is shared with whatever else holds it.
+    const scan = new RegExp(re.source, re.flags);
+    let pos = 0;
+    let prevEnd = -1;
+    while (pos <= src.length) {
+        scan.lastIndex = pos;
+        const m = scan.exec(src);
+        if (null === m) {
+            break;
+        }
+        const start = m.index;
+        const end = start + m[0].length;
+        let accept = true;
+        if (end === pos) {
+            if (start === prevEnd) {
+                accept = false;
+            }
+            pos += stepAt(src, pos);
+        }
+        else {
+            pos = end;
+        }
+        prevEnd = end;
+        if (accept) {
+            out.push(m);
+        }
+    }
+    return out;
+}
+// A substitution template expanded against one match. `$1`..`$9` are
+// the numbered groups, `$&` the whole match and `$$` a literal `$`;
+// anything else after a `$` names nothing, and naming nothing is a
+// REFUSAL rather than a silent literal. A group the pattern does not
+// have is the same refusal -- a generator that expands it to the empty
+// string writes a file with a hole in it and says nothing.
+function expandSub(sub, m, groups) {
+    let out = '';
+    for (let i = 0; i < sub.length; i++) {
+        if ('$' !== sub[i]) {
+            out += sub[i];
+            continue;
+        }
+        const n = sub[i + 1];
+        if ('$' === n) {
+            out += '$';
+            i++;
+            continue;
+        }
+        if ('&' === n) {
+            out += m[0];
+            i++;
+            continue;
+        }
+        if (undefined === n || '1' > n || '9' < n) {
+            return undefined;
+        }
+        const g = n.charCodeAt(0) - 0x30;
+        if (groups < g) {
+            return undefined;
+        }
+        out += m[g] ?? '';
+        i++;
+    }
+    return out;
+}
+// The fields `re` cuts `src` into, under Go's Split: an empty match at
+// the very start opens no field, and a match ending at the end of the
+// input closes none.
+function splitRe(src, re) {
+    const out = [];
+    let beg = 0;
+    let end = 0;
+    for (const m of allMatches(src, re)) {
+        end = m.index;
+        if (0 !== m.index + m[0].length) {
+            out.push(src.slice(beg, end));
+        }
+        beg = m.index + m[0].length;
+    }
+    if (end !== src.length) {
+        out.push(src.slice(beg));
+    }
+    return out;
+}
+// An EMPTY separator yields the CODE POINTS, not the UTF-16 units a
+// host split would give: `split("é", "")` is one field in both ports.
+function splitLiteral(src, sep) {
+    if ('' === sep) {
+        return [...src];
+    }
+    return src.split(sep);
+}
+// The compiled form of a pattern argument, or the code naming what is
+// wrong with it.
+function compileRe(src) {
+    const [norm, why] = (0, ConstraintVal_1.normaliseRe)(src);
+    if ('' !== why) {
+        return 'rep_pattern';
+    }
+    try {
+        // The `u` flag is REQUIRED for parity, exactly as it is for `re()`:
+        // without it JavaScript counts UTF-16 units where Go counts code
+        // points.
+        return new RegExp(norm, 'gu');
+    }
+    catch (e) {
+        return 'rep_pattern';
+    }
+}
+class EscFuncVal extends FuncBaseVal_1.FuncBaseVal {
+    constructor(spec, ctx) {
+        super(spec, ctx);
+        this.isEscFunc = true;
+    }
+    make(_ctx, spec) { return new EscFuncVal(spec); }
+    funcname() { return 'esc'; }
+    resolve(ctx, args) {
+        const src = textOf(args?.[0]);
+        if (undefined === src) {
+            return (0, err_1.makeNilErr)(ctx, 'invalid-arg', this);
+        }
+        const variant = variantOf(args?.[1]);
+        if (undefined === variant) {
+            return (0, err_1.makeNilErr)(ctx, 'esc_variant', this);
+        }
+        return this.place(new StringVal_1.StringVal({ peg: (0, escape_1.escapeText)(src, variant) }, ctx));
+    }
+} /* node:coverage ignore next 2 */
+exports.EscFuncVal = EscFuncVal;
+class UscFuncVal extends FuncBaseVal_1.FuncBaseVal {
+    constructor(spec, ctx) {
+        super(spec, ctx);
+        this.isUscFunc = true;
+    }
+    make(_ctx, spec) { return new UscFuncVal(spec); }
+    funcname() { return 'usc'; }
+    resolve(ctx, args) {
+        const src = textOf(args?.[0]);
+        if (undefined === src) {
+            return (0, err_1.makeNilErr)(ctx, 'invalid-arg', this);
+        }
+        const variant = variantOf(args?.[1]);
+        if (undefined === variant) {
+            return (0, err_1.makeNilErr)(ctx, 'esc_variant', this);
+        }
+        const [out, ok] = (0, escape_1.unescapeText)(src, variant);
+        if (!ok) {
+            return (0, err_1.makeNilErr)(ctx, 'usc_malformed', this);
+        }
+        return this.place(new StringVal_1.StringVal({ peg: out }, ctx));
+    }
+} /* node:coverage ignore next 2 */
+exports.UscFuncVal = UscFuncVal;
+class RepFuncVal extends FuncBaseVal_1.FuncBaseVal {
+    constructor(spec, ctx) {
+        super(spec, ctx);
+        this.isRepFunc = true;
+    }
+    make(_ctx, spec) { return new RepFuncVal(spec); }
+    funcname() { return 'rep'; }
+    resolve(ctx, args) {
+        const src = textOf(args?.[0]);
+        const pat = textOf(args?.[1]);
+        const sub = textOf(args?.[2]);
+        if (undefined === src || undefined === pat || undefined === sub) {
+            return (0, err_1.makeNilErr)(ctx, 'invalid-arg', this);
+        }
+        const re = compileRe(pat);
+        if ('string' === typeof re) {
+            return (0, err_1.makeNilErr)(ctx, re, this);
+        }
+        const groups = reGroupCount(re.source);
+        let out = '';
+        let at = 0;
+        for (const m of allMatches(src, re)) {
+            const piece = expandSub(sub, m, groups);
+            if (undefined === piece) {
+                return (0, err_1.makeNilErr)(ctx, 'rep_sub', this);
+            }
+            out += src.slice(at, m.index) + piece;
+            at = m.index + m[0].length;
+        }
+        out += src.slice(at);
+        return this.place(new StringVal_1.StringVal({ peg: out }, ctx));
+    }
+} /* node:coverage ignore next 2 */
+exports.RepFuncVal = RepFuncVal;
+class SplitFuncVal extends FuncBaseVal_1.FuncBaseVal {
+    constructor(spec, ctx) {
+        super(spec, ctx);
+        this.isSplitFunc = true;
+    }
+    make(_ctx, spec) { return new SplitFuncVal(spec); }
+    funcname() { return 'split'; }
+    resolve(ctx, args) {
+        const src = textOf(args?.[0]);
+        if (undefined === src) {
+            return (0, err_1.makeNilErr)(ctx, 'invalid-arg', this);
+        }
+        // A PLAIN STRING IS A LITERAL and an `re(…)` is a pattern. The
+        // asymmetry with `rep` is deliberate: splitting is usually on a
+        // literal, replacing is usually by pattern, and it removes the trap
+        // where `split(v, ".")` silently cuts between every character.
+        const sep = args?.[1];
+        const lit = textOf(sep);
+        let fields;
+        if (undefined !== lit) {
+            fields = splitLiteral(src, lit);
+        }
+        else if (true === sep?.isConstraint && 1 === sep.res?.length) {
+            fields = splitRe(src, new RegExp(sep.res[0].re.source, 'gu'));
+        }
+        else {
+            return (0, err_1.makeNilErr)(ctx, 'split_sep', this);
+        }
+        const peg = fields.map((f, i) => new StringVal_1.StringVal({ peg: f }, ctx.descend(String(i))));
+        return this.place(new ListVal_1.ListVal({ peg }, ctx));
+    }
+} /* node:coverage ignore next 8 */
+exports.SplitFuncVal = SplitFuncVal;
+//# sourceMappingURL=StrFuncVal.js.map

package/dist/val/StrFuncVal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StrFuncVal.js","sourceRoot":"","sources":["../../src/val/StrFuncVal.ts"],"names":[],"mappings":"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"}

package/grammar/aontu.abnf

@@ -82,7 +82,7 @@ func      = name %s"(" ws [ value *( ws %s"," ws value ) ws ] %s")"
 ; listed before `re`, and `rem` before `re` as well.
 name      = %s"above" / %s"acyclic" / %s"add" / %s"below" / %s"close"
           / %s"copy" / %s"deprecate" / %s"div"
-          / %s"each" / %s"filter" / %s"greatest"
+          / %s"each" / %s"emit" / %s"esc" / %s"filter" / %s"greatest"
           / %s"hide"
           / %s"inverse" / %s"join" / %s"key" / %s"least"
           / %s"length" / %s"list" / %s"lower" / %s"map" / %s"match"
@@ -90,10 +90,11 @@ name      = %s"above" / %s"acyclic" / %s"add" / %s"below" / %s"close"
           / %s"mul" / %s"must"
           / %s"neq"
           / %s"open" / %s"pack" / %s"path" / %s"pick" / %s"pref"
-          / %s"refer" / %s"rel" / %s"rem" / %s"re" / %s"super"
+          / %s"refer" / %s"rel" / %s"rem" / %s"rep" / %s"re" / %s"split"
+          / %s"super"
           / %s"sub" / %s"sum"
           / %s"type"
-          / %s"unique" / %s"upper"
+          / %s"unique" / %s"upper" / %s"usc"
 
 ; A path reference, absolute from the document root. At least one
 ; segment: a bare `$` is an incomplete expression, not a reference.

package/grammar/aontu.gbnf

@@ -82,16 +82,17 @@ func ::= name "(" ws ( value ( ws "," ws value )* ws )? ")"
 
 name ::=
     "above" | "acyclic" | "add" | "below" | "close" | "copy" | "deprecate" | "div"
-  | "each" | "filter" | "greatest"
+  | "each" | "emit" | "esc" | "filter" | "greatest"
   | "hide"
   | "inverse" | "join" | "key" | "least"
   | "length" | "list" | "lower" | "map" | "match" | "max" | "min" | "mod" | "move"
   | "mul" | "must"
   | "neq"
-  | "open" | "pack" | "path" | "pick" | "pref" | "refer" | "rel" | "rem" | "re" | "super"
+  | "open" | "pack" | "path" | "pick" | "pref" | "refer" | "rel" | "rem" | "rep" | "re"
+  | "split" | "super"
   | "sub" | "sum"
   | "type"
-  | "unique" | "upper"
+  | "unique" | "upper" | "usc"
 
 # A path reference, absolute from the document root.
 # At least one segment: a bare `$` is an incomplete expression, not a

package/grammar/aontu.lark

@@ -63,16 +63,17 @@ element: spread
 func: name "(" [value ("," value)*] ")"
 
 name: "above" | "acyclic" | "add" | "below" | "close" | "copy" | "deprecate" | "div"
-    | "each" | "filter" | "greatest"
+    | "each" | "emit" | "esc" | "filter" | "greatest"
     | "hide"
     | "inverse" | "join" | "key" | "least"
     | "length" | "list" | "lower" | "map" | "match" | "max" | "min" | "mod" | "move"
     | "mul" | "must"
     | "neq"
-    | "open" | "pack" | "path" | "pick" | "pref" | "refer" | "rel" | "rem" | "re" | "super"
+    | "open" | "pack" | "path" | "pick" | "pref" | "refer" | "rel" | "rem" | "rep" | "re"
+    | "split" | "super"
     | "sub" | "sum"
     | "type"
-    | "unique" | "upper"
+    | "unique" | "upper" | "usc"
 
 // At least one segment: a bare `$` is an incomplete expression.
 //

package/grammar/aontu.tmLanguage.json

@@ -111,7 +111,7 @@
 
     "builtin": {
       "comment": "The engine's function registry. `func: name \"(\" ...` in aontu.lark — only these names can be called, so a call to anything else is deliberately left uncoloured rather than dressed up as valid. The prefix family is spelled longest-first (refer|rel|rem|re) to keep the intent legible; the trailing \\b already makes the order immaterial, since a short alternative that swallowed the stem fails the boundary and backtracks.",
-      "match": "\\b(above|acyclic|add|below|close|copy|deprecate|div|each|filter|greatest|hide|inverse|join|key|least|length|list|lower|map|match|max|min|mod|move|mul|must|neq|open|pack|path|pick|pref|refer|rel|rem|re|sub|sum|super|type|unique|upper)\\b(?=\\s*\\()",
+      "match": "\\b(above|acyclic|add|below|close|copy|deprecate|div|each|emit|esc|filter|greatest|hide|inverse|join|key|least|length|list|lower|map|match|max|min|mod|move|mul|must|neq|open|pack|path|pick|pref|refer|rel|rem|rep|re|split|sub|sum|super|type|unique|upper|usc)\\b(?=\\s*\\()",
       "captures": {
         "1": { "name": "support.function.builtin.aontu" }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aontu",
-  "version": "0.56.0",
+  "version": "0.57.0",
   "main": "dist/aontu.js",
   "type": "commonjs",
   "types": "dist/aontu.d.ts",

package/src/aontu.ts

@@ -26,6 +26,7 @@ import { graphOf } from './graph'
 import { relationCheck, relationErrors } from './relation'
 import { view, viewSet, viewTree } from './view'
 import { format, unifiedDiff } from './format'
+export type { LintFinding, FormatReport, FormatOptions } from './format'
 
 
 // VERSION is the Aontu npm package version, and mirrors
@@ -35,7 +36,7 @@ import { format, unifiedDiff } from './format'
 // Kept in step with package.json by the `version` npm lifecycle script,
 // which runs on `npm version` / `npm run repo-bump`. version.test.ts
 // fails if the two ever drift.
-const VERSION = '0.56.0'
+const VERSION = '0.57.0'
 
 
 // A module file's VALUE, as far as it goes. COLLECTED, not raised: a

package/src/cli.ts

@@ -12,7 +12,7 @@
 import { evalFailure } from './query'
 // __importStar downlevel helper, whose branches no supported Node takes.
 import {
-  mkdirSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync,
+  existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync,
 } from 'node:fs'
 import { basename, dirname, join, resolve } from 'node:path'
 import { tmpdir } from 'node:os'
@@ -25,6 +25,8 @@ import {
   get, why, patch, agentsMd,
 } from './aontu'
 import { sarifReport } from './report-sarif'
+import { main as lspMain } from './lsp-server'
+import { main as mcpMain } from './mcp-server'
 import { jsonSchema } from './jsonschema'
 import { modTidy, modVerify, modVendor, modManifest } from './mod-tool'
 import type {
@@ -72,7 +74,9 @@ const HELP = `Usage: aontu [options] [file]
        aontu why <path> [options] <file>
        aontu set <path>=<value>... --entry <file> --overlay <file>
        aontu agentsmd [--write <AGENTS.md>] <file>
-       aontu fmt [-w|-l|--check|-d] <file>...
+       aontu fmt [-w|-l|--check|-d|--lint] <file>...
+       aontu lsp
+       aontu mcp [--root <dir>]
 
 Evaluate an Aontu source file and print the result as JSON.
 With no file on an interactive terminal, start a REPL.
@@ -106,10 +110,10 @@ Mod options:
 
 Mod subcommands:
   tidy      Resolve the module closure by minimum version selection and
-            rewrite mod-lock.aon in canonical form
-  verify    Check every locked module still means what mod-lock.aon
+            rewrite aontu_meta/mod-lock.aon in canonical form
+  verify    Check every locked module still means what the lockfile
             pins, and change nothing (the CI gate; tidy rewrites)
-  vendor    Materialise the locked closure into aon_vendor/
+  vendor    Materialise the locked closure into aontu_meta/vendor/
   manifest  Print the OCI artifact a publish would push, gated on the
             breaking check against --against
 
@@ -290,12 +294,25 @@ Fmt options:
   --check         Like --list, and exit 1 when any would: the CI gate
   -d, --diff      Print a unified diff for each file whose form would
                   change
+  --lint          Report the style findings, key case and repeated
+                  shapes, on standard error, and print nothing else
+  --strict        With --lint, and exit 1 when there is a finding
 
 The fmt verb prints one document in the agreed form; with no file it
 reads standard input. Several files need one of the options above.
 
-Fmt exit codes: 0 formatted or clean, 1 a --check file would change,
-2 usage, 4 a document does not parse.
+Fmt exit codes: 0 formatted or clean, 1 a --check file would change or
+a --strict finding, 2 usage, 4 a document does not parse.
+
+The lsp verb runs the language server over standard input and output
+(LSP: JSON-RPC with Content-Length framing) until the client exits;
+editors launch it with no arguments. The standalone aontu-lsp binary
+runs the same server.
+
+The mcp verb runs the Model Context Protocol server over standard
+input and output (newline-delimited JSON-RPC), confined below --root
+when one is given. It is part of the npm build, as the standalone
+aontu-mcp binary is.
 
 REPL commands:
   :help           Show REPL help
@@ -1994,6 +2011,16 @@ function runMod(argv: string[]): number {
     return 2
   }
 
+  // THE OLD LAYOUT IS NAMED, NOT READ. The lockfile and the vendored
+  // closure moved under aontu_meta/; a project that still carries them
+  // at its root would otherwise look untouched by any of these verbs,
+  // which is the one silence worth breaking.
+  if (existsSync(join(dir, 'aon_vendor')) || existsSync(join(dir, 'mod-lock.aon'))) {
+    process.stderr.write(
+      'aontu: aon_vendor/ and mod-lock.aon now live under aontu_meta/: ' +
+      'move them, or run aontu mod tidy and aontu mod vendor\n')
+  }
+
   // `--against` gates a manifest and means nothing to the other two;
   // accepting it there would say it had been honoured.
   if (null != against && 'manifest' !== sub) {
@@ -3421,13 +3448,17 @@ function runAgentsMd(argv: string[]): number {
 // the form itself is the library's (ts/src/format.ts), and the two
 // ports agree on it row by row in test/spec/fmt.tsv.
 
-const FMT_HELP = 'aontu fmt [-w|-l|--check|-d] <file>... (try --help)'
+const FMT_HELP = 'aontu fmt [-w|-l|--check|-d|--lint] <file>... (try --help)'
 
-type FmtFlags = { write: boolean, list: boolean, check: boolean, diff: boolean }
+type FmtFlags = {
+  write: boolean, list: boolean, check: boolean, diff: boolean, lint: boolean, strict: boolean,
+}
 
 function runFmt(argv: string[]): number | Promise<number> {
   const files: string[] = []
-  const flags: FmtFlags = { write: false, list: false, check: false, diff: false }
+  const flags: FmtFlags = {
+    write: false, list: false, check: false, diff: false, lint: false, strict: false,
+  }
 
   for (const arg of argv) {
     if ('-h' === arg || '--help' === arg) {
@@ -3446,6 +3477,13 @@ function runFmt(argv: string[]): number | Promise<number> {
     else if ('-d' === arg || '--diff' === arg) {
       flags.diff = true
     }
+    else if ('--lint' === arg) {
+      flags.lint = true
+    }
+    else if ('--strict' === arg) {
+      flags.lint = true
+      flags.strict = true
+    }
     else if (arg.startsWith('-')) {
       process.stderr.write(`aontu: unknown fmt option ${arg} (try --help)\n`)
       return 2
@@ -3477,7 +3515,7 @@ function runFmt(argv: string[]): number | Promise<number> {
   if (1 < files.length && !fmtQuiet(flags)) {
     process.stderr.write(
       `aontu: fmt prints one file; with ${files.length}, say --write, ` +
-      `--list, --check or --diff\n${FMT_HELP}\n`)
+      `--list, --check, --diff or --lint\n${FMT_HELP}\n`)
     return 2
   }
 
@@ -3496,28 +3534,34 @@ function runFmt(argv: string[]): number | Promise<number> {
   return worst
 }
 
-// An option that says what to do with a file that would change, in
-// place of printing it.
+// An option that says what to do with a file, in place of printing
+// it: what to do when its form would change, or the lint.
 function fmtQuiet(flags: FmtFlags): boolean {
-  return flags.write || flags.list || flags.check || flags.diff
+  return flags.write || flags.list || flags.check || flags.diff || flags.lint
 }
 
 // One document: 0 printed, clean or done; 1 a --check that would
-// change; 2 a file that cannot be written; 4 a document that does not
-// format, with the finding that says why.
+// change, or a --strict finding; 2 a file that cannot be written; 4 a
+// document that does not format, with the finding that says why. The
+// style findings go to standard error, one line each, in the shape
+// every linter prints: `file:line:col: rule: message`.
 function fmtOne(name: string, src: string, flags: FmtFlags): number {
-  const report = format(src, { path: name })
+  const report = format(src, { path: name, lint: flags.lint })
   if ('error' === report.verdict) {
     process.stderr.write(`aontu: ${name} was not formatted\n` +
       report.errors.map(renderFinding).join('\n') + '\n')
     return 4
   }
+  for (const f of report.findings) {
+    process.stderr.write(`${name}:${f.line}:${f.col}: ${f.rule}: ${f.message}\n`)
+  }
+  const strict = flags.strict && 0 < report.findings.length ? 1 : 0
   if (!fmtQuiet(flags)) {
     process.stdout.write(report.text)
     return 0
   }
   if (!report.changed) {
-    return 0
+    return strict
   }
   if (flags.list || flags.check) {
     process.stdout.write(name + '\n')
@@ -3534,7 +3578,49 @@ function fmtOne(name: string, src: string, flags: FmtFlags): number {
       return 2
     }
   }
-  return flags.check ? 1 : 0
+  return flags.check ? 1 : strict
+}
+
+
+// ---------------------------------------------------------------------
+// The servers as verbs: `aontu lsp` runs the language server and
+// `aontu mcp` the MCP server over the CLI's own streams, so the one
+// command on PATH is the editor's and the agent's server too, and a
+// version manager (docs/design/ENV.0.md) has one thing to resolve. The
+// standalone bins (aontu-lsp, aontu-mcp) run the same functions. Each
+// server owns its exit; the CLI only dispatches. The pair is a
+// parameter of main so that a test can see the dispatch without a
+// server taking the test's own stdin.
+
+type Servers = {
+  lsp: () => void
+  mcp: (argv: string[]) => void
+}
+
+// The real pair takes the process's own stdin and stdout, which no
+// in-process test can lend it; the executable-entry tests in
+// cli.test.ts run each through a child process instead, so these two
+// lines are excluded from the in-process count, as the stdio wiring
+// of lsp-server.ts is.
+/* node:coverage ignore next 4 */
+const SERVERS: Servers = {
+  lsp: () => void lspMain(),
+  mcp: (argv) => void mcpMain(undefined, undefined, undefined, undefined, argv),
+}
+
+// undefined: the server took the process; a number: an answer the CLI
+// gives itself, --help or a usage error.
+function runLsp(argv: string[], servers: Servers): number | undefined {
+  for (const arg of argv) {
+    if ('-h' === arg || '--help' === arg) {
+      process.stdout.write(HELP)
+      return 0
+    }
+    process.stderr.write(`aontu: lsp takes no arguments (try --help)\n`)
+    return 2
+  }
+  servers.lsp()
+  return undefined
 }
 
 
@@ -3562,7 +3648,7 @@ function parseTrustArg(value: string): TrustArg | undefined {
 }
 
 
-function main(argv: string[]): void {
+function main(argv: string[], servers: Servers = SERVERS): void {
   // COLOUR OFF WHEN THE DESTINATION IS NOT A TERMINAL. Error frames
   // hardcoded their ANSI escapes, so a piped report and a `--jsonl`
   // answer carried terminal control codes into whatever read them (the
@@ -3612,6 +3698,13 @@ function main(argv: string[]): void {
   if ('fmt' === argv[2]) {
     return void Promise.resolve(runFmt(argv.slice(3))).then(finish)
   }
+  if ('lsp' === argv[2]) {
+    const code = runLsp(argv.slice(3), servers)
+    return undefined === code ? undefined : finish(code)
+  }
+  if ('mcp' === argv[2]) {
+    return servers.mcp(argv.slice(3))
+  }
 
   if ('set' === argv[2]) {
     return finish(runSet(argv.slice(3)))