@wcstack/lint 1.22.1

package/README.ja.md

@@ -0,0 +1,62 @@
+# @wcstack/lint
+
+[wcstack](https://github.com/wcstack/wcstack) の静的契約検査 CLI。HTML の `data-wcs` バインディングと `wcstack.manifest.json`（sidecar）を headless に検査します。WcStack IntelliSense（VS Code 拡張）と**同一の validator core** を使うため、IDE と CLI の diagnostic code / range は完全に一致します。
+
+[English README is here](./README.md)
+
+## 使い方
+
+インストール不要で一行:
+
+```bash
+npx @wcstack/lint --errors-only index.html wcstack.manifest.json
+```
+
+またはインストールして `wcs-validate` コマンドとして:
+
+```bash
+npm i -D @wcstack/lint
+npx wcs-validate --errors-only src/**/*.html
+```
+
+`.manifest.json` で終わるファイルは sidecar manifest として、それ以外は `data-wcs` バインディングを含む HTML として検査されます。
+
+```
+wcs-validate [--attr=data-wcs] [--state-tag=wcs-state] [--lang=ja|en] [--errors-only] <file> [<file> ...]
+```
+
+| オプション | 説明 |
+|---|---|
+| `--attr=<name>` | バインド属性名（既定 `data-wcs`） |
+| `--state-tag=<name>` | state カスタム要素のタグ名（既定 `wcs-state`） |
+| `--lang=ja\|en` | 診断メッセージの言語。未指定時は環境ロケール（`LC_ALL` / `LC_MESSAGES` / `LANG` → OS ロケール）に従う。code / range は言語に依らず不変 |
+| `--errors-only`（別名 `--quiet`） | error severity の行だけ表示。warning / info の件数と exit code は不変 |
+
+## 出力と exit code
+
+診断は安定した順序で 1 行ずつ出力されます:
+
+```
+index.html:12:8 warning wcs/path-nonexistent Path "user.nam" does not exist ...
+app.manifest.json:1:3 error wcs/manifest-broken Broken manifest JSON: ...
+
+1 error(s), 1 warning(s), 0 info
+```
+
+| exit code | 意味 |
+|---|---|
+| `0` | error severity の診断なし（warning / info はあってもよい） |
+| `1` | error severity の診断が 1 件以上 |
+| `2` | usage エラー、またはファイル読み取り失敗 |
+
+## 生成 → 検証 → 修正ループでの利用
+
+安定した diagnostic code・`source:line:col` range・exit code 契約により、CI のゲートにも AI コード生成フローにもそのまま組み込めます: HTML を生成 → `npx @wcstack/lint --errors-only` → 診断を読んで修正 → exit code `0` になるまで再実行。
+
+## VS Code 拡張との関係
+
+このパッケージは薄い配布ラッパーです。[`wcstack-intellisense`](https://github.com/wcstack/wcstack/tree/main/packages/vscode-wcs) の validator core からビルドされた自己完結の CLI バンドルを同梱します（runtime dependencies ゼロ）。sidecar manifest は tooling 専用で、ランタイム挙動を変えることはありません。規範スキーマは [`docs/wcstack-manifest-schema.md`](https://github.com/wcstack/wcstack/blob/main/docs/wcstack-manifest-schema.md) を参照してください。
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,62 @@
+# @wcstack/lint
+
+Static-contract validator CLI for [wcstack](https://github.com/wcstack/wcstack): checks HTML `data-wcs` bindings and `wcstack.manifest.json` sidecars headlessly, with the **same validator core** as the WcStack IntelliSense VS Code extension — the IDE and this CLI report identical diagnostic codes and ranges.
+
+[日本語版 README はこちら](./README.ja.md)
+
+## Usage
+
+No install required:
+
+```bash
+npx @wcstack/lint --errors-only index.html wcstack.manifest.json
+```
+
+Or install and use the `wcs-validate` command:
+
+```bash
+npm i -D @wcstack/lint
+npx wcs-validate --errors-only src/**/*.html
+```
+
+Files ending in `.manifest.json` are validated as sidecar manifests; everything else is validated as HTML with `data-wcs` bindings.
+
+```
+wcs-validate [--attr=data-wcs] [--state-tag=wcs-state] [--lang=ja|en] [--errors-only] <file> [<file> ...]
+```
+
+| Option | Description |
+|---|---|
+| `--attr=<name>` | Bind attribute name (default `data-wcs`) |
+| `--state-tag=<name>` | State custom-element tag name (default `wcs-state`) |
+| `--lang=ja\|en` | Diagnostic message language. Defaults to the environment locale (`LC_ALL` / `LC_MESSAGES` / `LANG`, then the OS locale); codes and ranges are language-independent |
+| `--errors-only` (alias `--quiet`) | Print only error-severity lines; warning/info counts and the exit code are unchanged |
+
+## Output & exit codes
+
+One line per diagnostic, in a stable order:
+
+```
+index.html:12:8 warning wcs/path-nonexistent Path "user.nam" does not exist ...
+app.manifest.json:1:3 error wcs/manifest-broken Broken manifest JSON: ...
+
+1 error(s), 1 warning(s), 0 info
+```
+
+| Exit code | Meaning |
+|---|---|
+| `0` | No error-severity diagnostics (warnings/info may exist) |
+| `1` | At least one error-severity diagnostic |
+| `2` | Usage error or unreadable file |
+
+## Use in generate–validate–fix loops
+
+Stable diagnostic codes, `source:line:col` ranges, and the exit-code contract make this CLI a drop-in gate for CI and for AI code-generation flows: generate HTML → `npx @wcstack/lint --errors-only` → read the diagnostics, fix, and re-run until exit code `0`.
+
+## Relationship to the VS Code extension
+
+This package is a thin distribution wrapper: it ships the self-contained CLI bundle built from the [`wcstack-intellisense`](https://github.com/wcstack/wcstack/tree/main/packages/vscode-wcs) validator core (zero runtime dependencies). The sidecar manifest is tooling-only and never changes runtime behavior; the normative schema lives in [`docs/wcstack-manifest-schema.md`](https://github.com/wcstack/wcstack/blob/main/docs/wcstack-manifest-schema.md).
+
+## License
+
+MIT