@hideyukimori/nene2-standards

NeNe フリート・フロント統一規約の lint 配布物（規約 05 §2〜3 の実装正本 — 文書と食い違ったら配布物が正・会議 R1⑨）。

製品側の合成形（コピペ正本）

// frontend/eslint.config.js（このファイル以外で lint 設定 MUST NOT — 05 §1.2）
import nene2 from '@hideyukimori/nene2-standards';

export default [
  ...nene2.base,
  ...nene2.fsd,
  ...nene2.api,
  ...nene2.stylingWith(),  // per-repo Tailwind entry の seam（既定 FSD 正準・下記）
  ...nene2.i18n,
  ...nene2.testing,
  // 公認差異は registries 登録済みの override のみ合成可（05 §8）
];

// frontend/stylelint.config.js
export default { extends: ['@hideyukimori/nene2-standards/stylelint'] };

• plugin 同梱: 参照する全サードパーティ plugin はこのパッケージが登録する。製品側 eslint.config.js での plugins 追加 MUST NOT（05 §2.2 冒頭）。
• raw rule の直書き・後置き override での severity 緩和は gate-integrity FAIL（会議 R4 AM-11(iii)）。

合成規律（このパッケージの内部構造）

ESLint flat config は同一ルールの再指定が後勝ちで全置換になる。よって no-restricted-{syntax,imports,globals} は src/configs/restrictions.ts で (ルール, 適用ファイル集合) ごとにちょうど1つの実効定義へ統合してから配布する （05 §2.2 冒頭 MUST）。ファイル集合は互いに素・唯一の例外は src/shared/api/client.ts の off（A-2/AM-20 の登録済み例外）。 統合定義群は関心別断片のうち nene2.api が収容する（意味論の帰属は src/selectors.ts / src/restricted-imports.ts のコメントが正）。 統合の正しさは合成済み最終 config への検出プローブ（tests/composed-config.probes.test.ts）が保証する — gate-integrity（severity 照合）では検出できない故障様式のため（05 §2.2）。

known-utility fast path — severity は起草プレースホルダ（O-5/O-6 の緊張）

better-tailwindcss/no-unknown-classes は 'warn' の起草時プレースホルダのまま配布する。これは未決の妥協ではなく規約の設計そのもの:

• O-5 (MUST): severity の正本は check:tw-oracle。fast path と oracle の食い違いは仕様であり常に oracle が正 — fast path を error に引き上げる「修正」は AM-13(iv) の偽陽性洪水を再発させるため MUST NOT。
• O-6 (MUST): 実効 severity はファイル単位で legacy manifest から機械生成する（掲載= off・それ以外= error）。リポ単位の有効化は当該リポの語彙 codemod スタック直後の連続 PR。
• つまり「配布値 warn」→「manifest 生成 override が error/off を上書き」が正規の姿。生成器（O-6 の severity 生成）と check:tw-oracle は W0a 後続（conformance / W1 配線)。error/warn 運用の最終形は批准レビュー送り（規約 README §8 未解消リスト）。
• O-7: 偽陽性時のリポ側 eslint-disable MUST NOT（eslint-comments/no-restricted-disable で強制）。是正は 24h の standards patch レーン。

known-utility の entryPoint seam（fleet-tooling#21・payout#161 実弾テストで確定）

better-tailwindcss/no-unknown-classes の entryPoint は「アプリ実 entry」（O-3 MUST）＝アプリ固有であり、単一ハードコード既定では表現できない。

• 既定は FSD 正準のテーマ入口 src/shared/ui/theme/index.css（init-scan の CANONICAL_NON_LEGACY・AM-8(a) canonical cascade header の置き場と一致）。payout など FSD 正準レイアウトの repo は ...nene2.stylingWith() を無引数で撃てば正しく配線される。
• per-repo 上書きは stylingWith({ entryPoint })。W0.starter レイアウト（src/index.css）等は ...nene2.stylingWith({ entryPoint: 'src/index.css' })。
• entry 不在は fail-loud（stylingWith が throw）。better-tailwindcss は entry 未発見時に既定 tailwind theme へ silent fallback し、テーマ固有ユーティリティ（bg-surface・px-inline-md 等）を全て unknown へ化けさせる（＝偽陽性洪水）。G-6（検査不能=unknown・空虚合格禁止）に従い、黙って通さず設定エラーとして即 FAIL させる。
• 実測（payout#161・eb5f7aa）: 配布既定 'src/index.css' では 218 件の偽陽性（全件 entry-not-found・全テーマユーティリティが unknown）→ 実 entry 'src/shared/ui/theme/index.css' 指定で 49 件の真陽性のみ（entry-not-found 0）。回帰テスト tests/styling-entrypoint.test.ts が payout 形 fixture でこれを固定する。
• 後方互換: ...nene2.styling（静的配列）も残す（既定 entryPoint は同じく FSD 正準へ是正）。ただし fail-loud の存在検査は付かない（import 副作用ゼロのため）— 検査が要る配線は stylingWith() を使う。

変更履歴

• 1.0.1 — known-utility の entryPoint 既定を W0.starter 前提 'src/index.css' から FSD 正準 'src/shared/ui/theme/index.css' へ是正し、per-repo 上書き stylingWith({ entryPoint }) seam＋entry 不在 fail-loud を追加（fleet-tooling#21・payout#161: shipped 218 偽陽性 → 実 entry で 49 真陽性）。
• 1.0.0 — 初回公開。

W0a 実装確定値（「実装が正本」化 — 05 §10.2 の確定送り分）

| 項目 | 確定値 | 備考 | |---|---|---| | import 系 plugin | eslint-plugin-import-x＋eslint-import-resolver-typescript v4（resolver-next） | rule prefix は import-x/（文書の import/no-restricted-paths 表記は追随更新） | | resolver project | project: ['tsconfig.json']（lint 実行 cwd 相対） | 実測: project 未指定だと @/ エイリアスが解決されず zones が fail-open | | known-utility rule-id | better-tailwindcss/no-unknown-classes（v4.6.1 実在確認） | detectComponentClasses: true 明記（AM-13） | | custom rule | nene2/style-prop-css-vars-only | react/forbid-dom-props は併用しない（唯一の許可形を自己誤検知するため custom rule に一本化） | | eslint-comments | @eslint-community/eslint-plugin-eslint-comments を prefix eslint-comments/ で登録 | O-7 の強制タグ表記と一致 | | testid 制限 | no-restricted-syntax セレクタで実装 | testing-library/no-test-id-queries は実在しない（v7.6 実確認・05 §2.2.6 は起草時ドラフト） | | stylelint テーマ override の除外 | extglob !(*.components).css | 実測: ! 否定パターンは配列内で全ファイル match 化（fail-open）— 05 §3.2 起草形は追随更新 | | JP lint 除外の実装 | 第4部 I18N-16 の有限列挙（src/shared/i18n/messages/** のみ JP 免除） | 05 §2.2.5 の src/shared/i18n/** 全域免除は I18N-16 確定形に負ける |

fail-closed（G-6/G-7）

• Stylelint の台帳由来 secondary（nene2/layer-components-allowlist の allowedClasses・nene2/layer-legacy-manifest-only の files）は未指定＝空集合＝全 FAIL。実効値は fleet registries から機械生成した override をゲート導入 PR で合成する（手書き列挙 MUST NOT — AM-10/AM-13(ii)・正本は台帳 G-7）。
• nene2.overrides.*（recordsCookieAuth / corpusWidgetSessionToken / vaultJsonCatalog）は現時点で marker のみ（緩和対象の A-7 機械検査が未実装のため）。検査実装と同時にこの named config が差し替え座席になる。

批准の機械前提チェック（RAT-1〜RAT-3・AI-21）

• nene2-check standards-doc --docs <dir> [--out <json>] [--md <file>] — 規約文書（README＋01〜05）の タグ欠落 MUST 列挙（G-1 棚卸し）・[E:rule-id]/[S:rule-id] の配布 config 実在照合（RAT-2 — 照合対象は off 以外の severity で実効配布されるルール）・[P] 列挙制（G-3）・MUST 総数と 機械強制カバレッジ率の観測出力（G-5 補記 — 数値では FAIL しない）。[X] は check:exemplars へ委譲。
• nene2-check exemplars --docs <dir> --root <fleet-root> [--out <json>] [--md <file>] — 全 [X:file#anchor] を実リポのアンカーコメント [nene2-exemplar:<name>] と突合（G-2。行番号参照は FAIL）。
• どちらも fail-closed: 文書 6 ファイル不揃い＝実行拒否・MUST 0 本／[X] 0 件＝unknown（exit 2）。
• 批准前提の red リスト（red が出るのが正 — 植栽未完）: docs/ratification-red-list-2026-07-16.md。 読み取り源は origin/main・対象リポの commit SHA 併記（A-10）。 前版 docs/ratification-red-list-2026-07-14.md は A-10 違反の方法で作られており失効（#37）— 数字を引用しないこと。

未実施（誠実性ガード）

• nene2-check の正準シーケンス駆動（type-check→eslint→…→build の 11 工程 — 05 §5.1）— W0b/W1 配線。
• registries の dangling reason-ref 解決（05 §5.2 #18 の check:exemplars 同一機構適用）— W0b。
• check:standards-doc / check:exemplars の CI 常設配線 — 規約文書が本リポ外（_work/reports/）に ある間は手動実行（red リスト参照）。文書の収容先が決まり次第 fleet-tooling CI ゲート #18/#19 として配線。
• depcruise 共有 config（05 §4）・prettier/tsconfig/vitest 配布（05 §1.1）— W0a スコープ外（Wave 表の W0a 行に含まれない）。
• gen:registered-classes（AM-13(ii)）・O-6 severity 生成器・check:tw-oracle — W1 配線。
• 全フリートでの known-utility 偽陽性率は未計測（O-6 のリポ単位有効化手順が吸収装置）。