@plurnk/plurnk-parser

The Heredoc Code Mode parser and Reflective Emission Normalization (RENO) engine for the PLURNK model language: unwrapped TypeScript/JavaScript statement admission (plurnk.<op>(...) and <server>.<tool>(...), with leading await tolerated) with <<<EOF raw literals, deterministic post-training envelope transduction, canonical reflective serialization (PlurnkParser.stringify), and path decomposition. It implements the language that @plurnk/plurnk-contracts specifies and teaches; the AST and wire types it produces are the contracts package's.

Install

npm install @plurnk/plurnk-parser

The service's execution path is the consumer. A client that validates or presents the wire needs only @plurnk/plurnk-contracts, which carries no parser runtime.

Parser

import { PlurnkParser } from "@plurnk/plurnk-parser";

const result = PlurnkParser.parse(input);

for (const item of result.items) {
    if (item.kind === "statement") {
        console.log(item.statement.op);
    }
}

Parse items are ordered and discriminate as statement, error, or text. In parse(), outside-block prose is preserved as { kind: "text", content, position }; in parseStatements(), outside-block prose is ignored. The parser entry points deliberately accept different document tiers:

| Entry point | Accepted input | |---|---| | PlurnkParser.parse | One operation-bearing model turn (plurnk.<op>(...) / <server>.<tool>(...)) | | PlurnkParser.parseStatements | A sequence of protocol statements | | PlurnkParser.stringify | Canonical unwrapped Code Mode serialization for a statement list | | parsePath | One path or URI using parser-equivalent decomposition |

See the contracts SPEC ({§whitespace-contract}) for the tier boundaries. The AST, parse-result, and wire types come from @plurnk/plurnk-contracts.

CLI

plurnk-parser [file]    parse a file, or standard input when omitted
plurnk-parser --help    show usage

The CLI prints the parse result as JSON and exits 0 for a clean parse or 1 when the result contains an error or unparsed tail.

Development

npm run build
npm test
npm run test:installation

License

MIT