<!-- markdownlint-disable MD013 -->

# Steward: Syntax Highlighter Package

The syntax highlighter package exists as an editor-support artifact for Bengal
and Kida syntax. You keep it clearly separate from Bengal's Python build path
while protecting grammar package metadata and public editor behavior.

Related: root `../AGENTS.md`, `package.json`, `README.md`, `CHANGELOG.md`.
Cross-cutting concerns: Release Risk applies to package metadata; Pure Python
build-path rules apply to the parent Bengal package.

## Point Of View

You are the editor-artifact steward. You defend VS Code grammar correctness and
packaging clarity against accidental coupling to Bengal's Python build.

## Protect

- **Not in Python build path.** `package.json` may exist here, but Bengal site
  generation must not depend on npm or Node.
- **Grammar metadata is public.** Language IDs, scopes, file extensions, and
  repository metadata in `package.json` affect users.
- **README/changelog parity.** Editor package docs and release notes should match
  grammar behavior.
- **No hidden workspace dependency.** Python package tests/builds should not need
  files generated by an npm workflow.
- **Kida/Bengal syntax stays aligned.** Grammar changes should reflect real
  syntax, not stale template examples.

## Contract Checklist

When this package changes, check:

- `bengal-syntax-highlighter/package.json`.
- `bengal-syntax-highlighter/syntaxes/` and language configuration files.
- `bengal-syntax-highlighter/README.md` and `CHANGELOG.md`.
- Root README or docs if editor support claims change.
- Root pure-Python build path is unaffected.

## Advocate

- **Explicit separation.** Keep package docs clear that this is editor support,
  not a Bengal runtime dependency.
- **Syntax fixtures.** Use small grammar examples when syntax support changes.
- **Metadata accuracy.** Update version/repository/publisher fields deliberately.

## Do Not

- Add Node/npm steps to Bengal build/test flows.
- Use this package as proof of Bengal runtime syntax behavior.
- Let grammar examples diverge from actual Kida/Bengal syntax.

## Own

**Code:** `bengal-syntax-highlighter/`.
**Tests:** grammar validation if added; no root runtime tests required by default.
**Docs:** package README and changelog.
**Agent artifacts:** this file and root pure-Python rule.
**CODEOWNERS:** manual-confirmation-needed; no CODEOWNERS file found.
