@shuji-bonji/rfcxml-mcp 0.6.13 → 0.6.53

package/dist/utils/disk-cache.js

@@ -8,6 +8,7 @@
  *
  * File layout (under `dir`):
  *   ./rfc{N}.xml   — raw RFCXML body, UTF-8
+ *   ./rfc{N}.txt   — raw RFC text body, UTF-8（`kind: 'text'` のとき）
  *
  * Intentionally minimal: no metadata, no eviction, no checksums. We trust the
  * filesystem and the source URL. If staleness becomes a concern, the operator
@@ -20,36 +21,39 @@
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { logger } from './logger.js';
+const EXTENSION = { xml: '.xml', text: '.txt' };
 export class DiskCache {
     dir;
+    kind;
     /**
      * @param dir Absolute or relative directory path. Created lazily on first
      * `set` — readers tolerate non-existent dirs by returning null.
+     * @param kind 本文の種類。省略すると `xml`。
      */
-    constructor(dir) {
+    constructor(dir, kind = 'xml') {
         this.dir = dir;
+        this.kind = kind;
     }
     /**
      * Construct a DiskCache from the `RFCXML_CACHE_DIR` environment variable.
      * Returns null when the var is unset/empty so the caller can keep the
      * disk-cache code path optional without conditionals at every call site.
      *
-     * The cache is rooted at `<RFCXML_CACHE_DIR>/xml/` to leave room for
-     * sibling subdirectories (e.g., text, metadata) in the future without
-     * mixing files.
+     * The cache is rooted at `<RFCXML_CACHE_DIR>/<kind>/` so that XML と
+     * テキストが混ざらない。
      */
-    static fromEnv() {
+    static fromEnv(kind = 'xml') {
         const raw = process.env.RFCXML_CACHE_DIR?.trim();
         if (!raw)
             return null;
-        return new DiskCache(path.join(raw, 'xml'));
+        return new DiskCache(path.join(raw, kind), kind);
     }
     /**
      * Compute the on-disk filepath for a given RFC number. Public so the CLI
      * and tests can sanity-check.
      */
     filepath(rfcNumber) {
-        return path.join(this.dir, `rfc${rfcNumber}.xml`);
+        return path.join(this.dir, `rfc${rfcNumber}${EXTENSION[this.kind]}`);
     }
     async has(rfcNumber) {
         try {
@@ -82,10 +86,10 @@ export class DiskCache {
      * and a write failure (e.g., disk full, permission denied) must not break
      * the runtime fetch path.
      */
-    async set(rfcNumber, xml) {
+    async set(rfcNumber, body) {
         try {
             await fs.mkdir(this.dir, { recursive: true });
-            await fs.writeFile(this.filepath(rfcNumber), xml, 'utf-8');
+            await fs.writeFile(this.filepath(rfcNumber), body, 'utf-8');
         }
         catch (error) {
             logger.warn(`DiskCache`, `write rfc${rfcNumber} failed: ${error instanceof Error ? error.message : String(error)}`);

package/dist/utils/disk-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"disk-cache.js","sourceRoot":"","sources":["../../src/utils/disk-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,OAAO,SAAS;IAKQ;IAJ5B;;;OAGG;IACH,YAA4B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAE3C;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sDAAsD;YACtD,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,MAAM,CAAC,IAAI,CACT,WAAW,EACX,WAAW,SAAS,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACzF,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,GAAW;QACtC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,WAAW,EACX,YAAY,SAAS,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC1F,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"disk-cache.js","sourceRoot":"","sources":["../../src/utils/disk-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAKrC,MAAM,SAAS,GAA8B,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAE3E,MAAM,OAAO,SAAS;IAOF;IACA;IAPlB;;;;OAIG;IACH,YACkB,GAAW,EACX,OAAkB,KAAK;QADvB,QAAG,GAAH,GAAG,CAAQ;QACX,SAAI,GAAJ,IAAI,CAAmB;IACtC,CAAC;IAEJ;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,OAAkB,KAAK;QACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sDAAsD;YACtD,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,MAAM,CAAC,IAAI,CACT,WAAW,EACX,WAAW,SAAS,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACzF,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,IAAY;QACvC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,WAAW,EACX,YAAY,SAAS,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC1F,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,UAAU,MAAM;IACd,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9D;AASD;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,MAqBpB,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,UAAU,MAAM;IACd,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9D;AASD;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,MAuBpB,CAAC"}

package/dist/utils/logger.js

@@ -13,9 +13,11 @@ function formatMessage(level, context, message) {
  * Can be replaced with more sophisticated logging (e.g., winston, pino) in the future
  */
 export const logger = {
+    // stdio トランスポートでは stdout が JSON-RPC の線なので、すべて stderr に書く。
+    // `console.debug` は stdout に出るため、DEBUG=1 で使った途端に線が壊れる（Issue #19）。
     debug(context, message) {
         if (process.env.DEBUG) {
-            console.debug(formatMessage('debug', context, message));
+            console.error(formatMessage('debug', context, message));
         }
     },
     info(context, message) {

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH;;GAEG;AACH,SAAS,aAAa,CAAC,KAAe,EAAE,OAAe,EAAE,OAAe;IACtE,OAAO,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,KAAK,CAAC,OAAe,EAAE,OAAe;QACpC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAe;QACnC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAe;QACnC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAe,EAAE,KAAa;QACnD,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACxD,IAAI,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH;;GAEG;AACH,SAAS,aAAa,CAAC,KAAe,EAAE,OAAe,EAAE,OAAe;IACtE,OAAO,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,0DAA0D;IAC1D,kEAAkE;IAClE,KAAK,CAAC,OAAe,EAAE,OAAe;QACpC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAe;QACnC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAe;QACnC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAe,EAAE,KAAa;QACnD,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACxD,IAAI,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/utils/requirement-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requirement-extractor.d.ts","sourceRoot":"","sources":["../../src/utils/requirement-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAUhF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gCAAgC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB;IACjB,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAsCD;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,CAAC,EAAE,iBAAiB,EAC1B,OAAO,GAAE,YAAwC,GAChD,WAAW,EAAE,CA+Gf"}
+{"version":3,"file":"requirement-extractor.d.ts","sourceRoot":"","sources":["../../src/utils/requirement-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAWhF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gCAAgC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB;IACjB,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAsCD;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,CAAC,EAAE,iBAAiB,EAC1B,OAAO,GAAE,YAAwC,GAChD,WAAW,EAAE,CA+Tf"}

package/dist/utils/requirement-extractor.js

@@ -2,7 +2,7 @@
  * 要件抽出の共通ユーティリティ
  * XML/テキストパーサー共通で使用
  */
-import { clipAtClauseEnd, extractSentence, foldWhitespace, requirementSource, stripListMarker, } from './text.js';
+import { clipAtClauseEnd, extractRequirementMarkers, extractSentence, foldWhitespace, requirementSource, stripListMarker, } from './text.js';
 import { normalizeSectionNumber } from './section.js';
 /**
  * セクション番号を正規化（`section-6.2.3` → `6.2.3`、`section-appendix.a.2.5` → `A.2.5`）
@@ -40,7 +40,23 @@ function matchesSectionFilter(sectionId, filter) {
  */
 export function extractRequirementsFromSections(sections, filter, options = { parseComponents: true }) {
     const requirements = [];
-    let idCounter = 1;
+    /**
+     * 要件の id の連番。**節ごとに数える。**
+     *
+     * 文書全体で 1 本の連番にしていたため、同じ要件が呼び方で違う id を持って
+     * いた。`validate_statement` は全件から取るので RFC 9110 §6.6.1 の禁止を
+     * `R-6.6.1-76` と報告するが、利用者がそれを読もうと
+     * `get_requirements({ rfc: 9110, section: "6.6.1" })` を呼ぶと、返るのは
+     * `R-6.6.1-1` 〜 `R-6.6.1-7` で、**教えられた id が存在しない**。
+     *
+     * 節ごとに数えれば「その節の n 番目」という意味になり、絞り込みで変わらない。
+     */
+    const idCounters = new Map();
+    const nextId = (sectionId) => {
+        const next = (idCounters.get(sectionId) ?? 0) + 1;
+        idCounters.set(sectionId, next);
+        return `R-${sectionId}-${next}`;
+    };
     /**
      * 出力済みの要件を記録する。キーは「セクション + レベル + 要件文」。
      *
@@ -56,6 +72,84 @@ export function extractRequirementsFromSections(sections, filter, options = { pa
         seen.add(key);
         return false;
     }
+    /**
+     * その位置のキーワードが、**行為を求めているのではなく語として名指されて**
+     * いるか。
+     *
+     * BCP 14 のキーワードは名詞にもなる。RFC 2119 §7 は
+     *
+     * > The effects on security of not implementing **a MUST or SHOULD**, or doing
+     * > something the specification says MUST NOT or SHOULD NOT be done, are very
+     * > subtle.
+     *
+     * と書く。この 1 文から MUST / SHOULD / MUST NOT / SHOULD NOT の 4 件が立って
+     * いた。RFC 9051 の付録 E は `(Changed from a SHOULD to a MUST.)`、RFC 5246 §1.2 は
+     * `Support for the SSLv2 backward-compatible hello is now a MAY, not a SHOULD,
+     * with sending it a SHOULD NOT.` である。
+     *
+     * 形容詞として名詞に付く `an OPTIONAL feature` `the RECOMMENDED default values`
+     * も同じで、その節の実装が何かをすることを求めていない。
+     *
+     * **冠詞が直前に来ることだけ**を見る。引用符付き（`"MUST"`）は `B10` が、
+     * BCP 14 の定型文は `B9` が既に落としている。
+     *
+     * 実測（RFC 82 本）: 48 件。うち 9 件は 1 つの文から複数のレベルが立っていた
+     * もので、名指しでないほうのキーワードは残る（RFC 9051 §6.2.2 の
+     * `It MAY also negotiate an OPTIONAL security layer` は MAY が残り
+     * OPTIONAL が落ちる）。
+     */
+    const ARTICLE_BEFORE_KEYWORD = /\b(?:an?|the)\s+$/i;
+    /** BCP 14 のキーワード。名指しかどうかを見るために、位置から読み直す。 */
+    const KEYWORD_AT_POSITION = /^(?:MUST NOT|SHALL NOT|SHOULD NOT|NOT RECOMMENDED|MUST|SHALL|SHOULD|MAY|REQUIRED|RECOMMENDED|OPTIONAL)/;
+    /**
+     * 名詞として置かれたキーワードの後ろに来るもの。
+     *
+     * 冠詞だけを見ると、**形容詞として名詞に付く**書き方まで落ちる。
+     * `an OPTIONAL feature of HTTP`（RFC 9110 §14）、
+     * `the RECOMMENDED default values for these two parameters are 3.5 seconds …`
+     * （RFC 3550 §6.2）、`A RECOMMENDED mechanism to achieve this is …`
+     * （RFC 3261 §16.7）は、その節が何を選ぶべきかを述べており要件である。
+     *
+     * 名指しのときはキーワードの後ろに名詞が来ない。
+     * `a MUST or SHOULD` / `a MAY, not a SHOULD` / `a SHOULD to a MUST.`
+     */
+    const KEYWORD_AS_BARE_NOUN = /^\s*(?:[,.;:)"'\u201d]|$|(?:or|and|to|not|nor|than|instead|rather|level|keyword|in|of|for|by|with|from|at|on|into)\b)/i;
+    function namesTheKeyword(text, position) {
+        if (!ARTICLE_BEFORE_KEYWORD.test(text.slice(Math.max(0, position - 12), position)))
+            return false;
+        const keyword = KEYWORD_AT_POSITION.exec(text.slice(position));
+        if (!keyword)
+            return false;
+        return KEYWORD_AS_BARE_NOUN.test(text.slice(position + keyword[0].length));
+    }
+    /**
+     * 語を並べただけで、文になっていないか。
+     *
+     * RFC 2578 §3.7 は ASN.1 の予約語 96 個を字下げして並べる。
+     *
+     * ```
+     *         ABSENT ACCESS AGENT-CAPABILITIES ANY APPLICATION AUGMENTS BEGIN
+     *         BIT BITS BOOLEAN BY CHOICE COMPONENT COMPONENTS CONTACT-INFO
+     *         …
+     *         OPTIONAL ORGANIZATION Opaque PLUS-INFINITY PRESENT PRIVATE
+     * ```
+     *
+     * この中の `OPTIONAL` から要件が 1 件立ち、チェックリストの 1 項目が
+     * **903 文字の語の並び**になっていた。
+     *
+     * 小文字だけの語が 1 つも無いことで見分ける。地の文は `the` `of` `to` `is` の
+     * ような語を必ず含む。予約語の一覧は `BY` `FROM` `OF` `WITH` のように大文字で
+     * 書かれるので、これらは小文字の語として数えない。
+     *
+     * 実測（RFC 97 本）: 1 件。
+     */
+    const LOWERCASE_WORD = /(?:^|\s)[a-z][a-z']*(?:\s|$)/;
+    function looksLikeWordList(sentence) {
+        const words = sentence.trim().split(/\s+/).filter(Boolean);
+        if (words.length < 4)
+            return false;
+        return !LOWERCASE_WORD.test(` ${sentence} `);
+    }
     function processSection(section, path) {
         // 内部の識別子（RFCXML の `pn`）はそのままでは外に出せない。出力する
         // `id` と `section` は節番号にそろえる。
@@ -67,9 +161,6 @@ export function extractRequirementsFromSections(sections, filter, options = { pa
             for (const block of section.content) {
                 if (block.type === 'text' && block.requirements.length > 0) {
                     for (const marker of block.requirements) {
-                        if (filter?.level && marker.level !== filter.level) {
-                            continue;
-                        }
                         // 図・ABNF は空白を畳まない。ABNF の注釈は散文として組み直す。
                         const source = requirementSource(block.content, marker.position, marker.level);
                         const raw = extractSentence(source.text, source.position);
@@ -79,11 +170,38 @@ export function extractRequirementsFromSections(sections, filter, options = { pa
                         if (isDuplicate(sectionId, marker.level, sentence)) {
                             continue;
                         }
-                        const components = options.parseComponents
-                            ? parseRequirementComponents(sentence, marker.level)
+                        // キーワードのほかに語が無いものは要件文ではない。
+                        // RFC 5280 §11.2 の ASN.1 の切れ端 `"OPTIONAL,"` `"} OPTIONAL,"` が
+                        // 要件として出ていた（RFC 90 本・要件 9,584 件のうち 4 件）。
+                        if (!hasSubstance(sentence)) {
+                            continue;
+                        }
+                        // キーワードが名詞として置かれているものは要件ではない。
+                        if (namesTheKeyword(block.content, marker.position)) {
+                            continue;
+                        }
+                        // 語を並べただけの塊は文ではない。
+                        if (looksLikeWordList(sentence)) {
+                            continue;
+                        }
+                        // 図・表の行から取った要件には主語も条件もアクションも無い。
+                        // RFC 2131 §4.3.1 の表の行 "Message SHOULD SHOULD SHOULD" に
+                        // `subject: "message should"` `action: "SHOULD SHOULD"` が付いていた。
+                        // **id はレベルで絞る前に進める。** `filter.level` の `continue` が
+                        // `nextId()` より前にあったため、レベルで絞るとその節の中で一致する
+                        // ものだけを 1 から数え直していた。RFC 6455 §5.1 の R-5.1-6（MAY）が
+                        // `level: "MAY"` では R-5.1-2 になり、`validate_statement` が教えた
+                        // id を `get_requirements` で引けなかった。重複排除やキーワードの
+                        // 名指しなど、レベルによらない判定はここより前に置くこと。
+                        const id = nextId(sectionId);
+                        if (filter?.level && marker.level !== filter.level) {
+                            continue;
+                        }
+                        const components = options.parseComponents && source.prose
+                            ? parseRequirementComponents(sentence, marker.level, block.content)
                             : {};
                         requirements.push({
-                            id: `R-${sectionId}-${idCounter++}`,
+                            id,
                             level: marker.level,
                             text: sentence,
                             section: sectionId,
@@ -97,27 +215,92 @@ export function extractRequirementsFromSections(sections, filter, options = { pa
                         });
                     }
                 }
+                // 表の行からも抽出する。
+                //
+                // 図・表の行にキーワードが当たったときは、**その 1 行だけ**を要件文にする
+                // （テキスト経路の `requirementSource` と同じ規則）。XML 経路の `<table>` は
+                // 行が `<tr>` で分かれているので、行のセルを " | " で繋いだものを 1 行とする。
+                // 見出しの行は見ない。RFC 9293 §3.11 の要件一覧表は見出しに
+                // MUST / SHOULD / MAY を並べており、それは要件ではない。
+                // 表の行から取った要件には主語も条件もアクションも無い。
+                //
+                // 要求 ID ラベル（`MUST-14`）だけの行は要件にしない。RFC 9293 の Appendix B は
+                // 本文の要件を `Treat as unsigned number | MUST-1 | X | | | |` の形で 110 行
+                // 並べる。行はラベルでレベルを名乗るが、実際のレベルは X の列が示すもので、
+                // `MUST-60` の行の X は MUST NOT の列にある。要件そのものは §3.1 などの本文から
+                // 既に出ている。
+                if (block.type === 'table') {
+                    const headerLine = block.headers.join(' | ');
+                    for (const row of block.rows) {
+                        const line = foldWhitespace(row.join(' | '));
+                        for (const marker of extractRequirementMarkers(line)) {
+                            const level = marker.level;
+                            if (filter?.level && level !== filter.level) {
+                                continue;
+                            }
+                            if (/^-\d/.test(line.slice(marker.position + level.length))) {
+                                continue;
+                            }
+                            if (isDuplicate(sectionId, level, line)) {
+                                continue;
+                            }
+                            if (!hasSubstance(line) || looksLikeWordList(line)) {
+                                continue;
+                            }
+                            if (namesTheKeyword(line, marker.position)) {
+                                continue;
+                            }
+                            requirements.push({
+                                id: nextId(sectionId),
+                                level,
+                                text: line,
+                                section: sectionId,
+                                sectionTitle: section.title,
+                                fullContext: headerLine ? `${headerLine}\n${line}` : line,
+                            });
+                        }
+                    }
+                }
                 // リストアイテムからも抽出
                 if (block.type === 'list') {
                     for (const item of block.items) {
                         for (const marker of item.requirements) {
-                            if (filter?.level && marker.level !== filter.level) {
+                            // 箇条書きの項目も、文の単位で切り出す。
+                            //
+                            // 箇条書きの項目は 1 文であることが多く、v0.6.14 まではその前提で
+                            // 項目の全文を要件文にしていた。RFCXML の `<dl>` は 1 項目が段落に
+                            // なる。RFC 9113 §8.3.1 の `":authority"` の項目は 2,150 文字の
+                            // 段落で、その中に MUST・MUST NOT・SHOULD・MAY が入っているため、
+                            // 同じ 2,150 文字が 4 件の要件として並んでいた。
+                            const itemContext = foldWhitespace(stripListMarker(item.content));
+                            const itemText = foldWhitespace(stripListMarker(extractSentence(item.content, marker.position)));
+                            if (isDuplicate(sectionId, marker.level, itemText)) {
                                 continue;
                             }
-                            const itemText = foldWhitespace(stripListMarker(item.content));
-                            if (isDuplicate(sectionId, marker.level, itemText)) {
+                            if (!hasSubstance(itemText)) {
+                                continue;
+                            }
+                            if (namesTheKeyword(item.content, marker.position)) {
+                                continue;
+                            }
+                            if (looksLikeWordList(itemText)) {
+                                continue;
+                            }
+                            // テキストブロックと同じく、id を進めてからレベルで絞る。
+                            const id = nextId(sectionId);
+                            if (filter?.level && marker.level !== filter.level) {
                                 continue;
                             }
                             const components = options.parseComponents
-                                ? parseRequirementComponents(itemText, marker.level)
+                                ? parseRequirementComponents(itemText, marker.level, itemContext)
                                 : {};
                             requirements.push({
-                                id: `R-${sectionId}-${idCounter++}`,
+                                id,
                                 level: marker.level,
                                 text: itemText,
                                 section: sectionId,
                                 sectionTitle: section.title,
-                                fullContext: itemText,
+                                fullContext: itemContext,
                                 ...components,
                             });
                         }
@@ -135,20 +318,95 @@ export function extractRequirementsFromSections(sections, filter, options = { pa
     }
     return requirements;
 }
+/**
+ * 要件文に、キーワード以外の語があるか。
+ *
+ * ASN.1 の切れ端が要件として出ることがある。RFC 5280 §11.2 の
+ * `OPTIONAL,` や `} OPTIONAL,` は、キーワードを外すと何も残らない。
+ * 要件は「誰が何をするか」を書いた文であって、キーワード単体ではない。
+ */
+function hasSubstance(text) {
+    const withoutKeywords = text.replace(/\b(?:MUST|SHALL|SHOULD|MAY|REQUIRED|OPTIONAL|RECOMMENDED|NOT)\b/g, ' ');
+    return /[A-Za-z0-9]/.test(withoutKeywords);
+}
 /**
  * 要件文から構成要素を解析
  */
-function parseRequirementComponents(text, level) {
+function parseRequirementComponents(text, level, context) {
     const result = {};
     // 主語の抽出（"The client MUST" → "client"）
-    const subjectMatch = text.match(/^(?:The\s+)?(\w+(?:\s+\w+)?)\s+(?:MUST|SHALL|SHOULD|MAY)/i);
+    //
+    // **文頭に固定しない。** RFC の要件文は前置きから始まることが多い。
+    //
+    // - `(Note that masking is done …) The server MUST close the connection …`
+    // - `In this case, a server MAY send a Close frame …`
+    // - `Because of the potential for trailer fields to be discarded, a server …`
+    //
+    // 文頭で探すと、これらの主語が取れない。実測（RFC 64 本・要件 9,684 件）で
+    // `subject` が付くのは 27.9% だけだった。キーワードの直前から取ると 91.8%。
+    //
+    // `subject` は `generate_checklist` の `role` の絞り込みにも使う。取れないと
+    // 絞り込みが効かず、`role: "client"` にサーバの要件が 865 件（8.9%）残っていた。
+    // 冠詞のあとには**必ず空白がある**。`\\s*` にすると、冠詞の候補が語の頭の
+    // 1 文字を食う。"Automated clients MUST" の "A" が冠詞として消費され、
+    // 主語が "utomated clients" になっていた（実測で 600 件、6.20%）。
+    //
+    // 直前の語が接続詞や代名詞のことがある。1 つの文に要件が 2 つあると、
+    // 2 つ目のキーワードの手前が "and" になる（RFC 9110 §4.3.4 の
+    // "MUST log the error to an appropriate audit log (if available) and MUST
+    // provide …"）。代名詞（it / this / they）も同じで、指しているものは
+    // 文の前の方にある。**主語ではないので、名乗らせない。**
+    //
+    // **キーワードは原文どおりの大文字で、否定形の一部を除いて照合する。**
+    // `\s+MUST\b` は `MUST NOT` の `MUST` にも当たる。RFC 8446 §4.5 の
+    // "Servers MUST NOT send this message, and clients receiving it MUST
+    // terminate the connection …" は、level `MUST` の要件なのに主語が servers、
+    // action が "NOT send this message" になり、`generate_checklist` の
+    // `role: "client"` から落ちていた。`i` フラグも外す。RFC 8446 §D.4 の
+    // "as they must be ignored" や RFC 6455 §7.2.3 の "Should the first reconnect
+    // attempt fail" は BCP 14 のキーワードではない。`requiredActionOf()` と同じ形。
+    //
+    // 主語とキーワードのあいだに「分詞 + 代名詞」の関係節が挟まることがある
+    // （"clients receiving it MUST"）。その 2 語は主語ではないので読み飛ばす。
+    const keywordPattern = `\\b${level.replace(' ', '\\s+')}\\b${level.endsWith('NOT') ? '' : '(?!\\s+NOT)'}`;
+    const subjectMatch = new RegExp(`\\b(?:(?:[Tt]he|[Aa]n?|[Ee]ach|[Ee]very|[Aa]ll)\\s+)?([A-Za-z][\\w-]*(?:\\s+[A-Za-z][\\w-]*)?)(?:\\s+[A-Za-z][\\w-]*ing\\s+(?:it|them|this|these|those|one))?\\s+${keywordPattern}`).exec(text);
     if (subjectMatch) {
-        result.subject = subjectMatch[1].toLowerCase();
+        // 2 語の取り込みが冠詞ごと拾うことがある（"of a client MUST" → "a client"）。
+        const subject = subjectMatch[1]
+            .toLowerCase()
+            .replace(/^(?:the|a|an|each|every|all)\s+/, '')
+            .trim();
+        if (subject && PRONOUN_SUBJECT.has(subject)) {
+            // 代名詞が指しているものは、同じ段落の前の文にある。
+            const antecedent = context ? subjectBeforeSentence(context, text) : undefined;
+            if (antecedent)
+                result.subject = antecedent;
+        }
+        else {
+            // 2 語の取り込みが機能語を巻き込むことがある（"response and MUST" →
+            // "response and"、"methods are REQUIRED" → "methods are"）。前後の機能語を
+            // 落として、残りを主語とする。全部落ちたら主語は無い。
+            //
+            // 直前が接続詞なら、キーワードは前の節と主語を共有している。RFC 9110
+            // §10.2.4 の "An origin server SHOULD NOT generate … detail and SHOULD
+            // limit …" の SHOULD の主語は origin server であって detail ではない。
+            // 同じ文の手前にある、キーワードの直前の語を採る。
+            const coordinated = /\b(?:and|or|but|nor)$/.test(subject);
+            const shared = coordinated ? lastSubjectBefore(text.slice(0, subjectMatch.index)) : undefined;
+            const trimmed = shared ?? trimFunctionWords(subject);
+            if (trimmed)
+                result.subject = trimmed;
+        }
     }
-    // 条件の抽出（"if", "when", "unless"）
+    // 条件の抽出（"if", "when", "where", "in case"）
+    //
+    // `unless` はここに入れない。例外の側と重なり、`condition` と `exception` に
+    // 同じ文字列が入る。実測（RFC 49 本・要件 7,797 件）で 247 件（3.2%）あった。
+    // 「X でない限り」は条件ではなく例外である。
+    //
     // 切り出しは clipAtClauseEnd に任せる。`[^,.]+` で止めると、括弧内のカンマや
     // 節番号のピリオドで切れて "this fails (e" のようになる。
-    const conditionMatch = text.match(/\b(if|when|unless|where|in case)\s+(.+)/is);
+    const conditionMatch = text.match(/\b(if|when|where|in case)\s+(.+)/is);
     if (conditionMatch) {
         const condition = clipAtClauseEnd(conditionMatch[2]);
         if (condition)
@@ -161,8 +419,8 @@ function parseRequirementComponents(text, level) {
         if (exception)
             result.exception = exception;
     }
-    // アクションの抽出（キーワードの後）
-    const actionMatch = text.match(new RegExp(`${level}\\s+(.+)`, 'is'));
+    // アクションの抽出（キーワードの後）。主語と同じく否定形の一部と小文字は除く。
+    const actionMatch = text.match(new RegExp(`${keywordPattern}\\s+(.+)`, 's'));
     if (actionMatch) {
         const action = clipAtClauseEnd(actionMatch[1]);
         if (action)
@@ -170,4 +428,138 @@ function parseRequirementComponents(text, level) {
     }
     return result;
 }
+/**
+ * 代名詞が指しているものを、同じ段落の前の文から取る。
+ *
+ * RFC 6455 §5.1 は
+ *
+ * > A client MUST close a connection if it detects a masked frame.
+ * > **In this case, it MAY use the status code 1002** (protocol error) …
+ *
+ * と書く。`it` は client を指す。取れないと `generate_checklist` の
+ * `role: "server"` にもこの項目が出る（主語が無ければ本文を見るが、本文にも
+ * client / server の語が無いため両方に残る）。
+ *
+ * 前の文の中で、キーワードの直前に置かれた語を採る。要件文と同じ取り方である。
+ */
+function subjectBeforeSentence(context, sentence) {
+    // **文の全体で探す。** 頭の数十文字で探すと、同じ書き出しの文が段落に 2 つ
+    // あるときに手前の方に当たる。RFC 6455 §5.1 は "In this case, …" を 2 回書く
+    // ので、40 文字で探すと 1 つ目に当たり、引き継ぐ主語が server になっていた
+    // （正しくは直前の文の client）。
+    //
+    // 段落と文で空白の畳み方が違う（段落は改行を含み、文は切り出したまま）。
+    // 両方を畳んでから探す。
+    const folded = foldWhitespace(context);
+    const at = folded.indexOf(foldWhitespace(sentence));
+    if (at <= 0)
+        return undefined;
+    return lastSubjectBefore(folded.slice(0, at));
+}
+/**
+ * 与えた文字列の中で、キーワードの直前に置かれた語のうち最後のもの。
+ *
+ * 冠詞は大文字で始まることがある（文頭の "A client MUST …"）。小文字だけで
+ * 書くと、文頭の文が当たらず、その手前の文の主語を引き継いでいた。
+ */
+function lastSubjectBefore(before) {
+    let found;
+    const pattern = /\b(?:(?:[Tt]he|[Aa]n?|[Ee]ach|[Ee]very|[Aa]ll)\s+)?([A-Za-z][\w-]*(?:\s+[A-Za-z][\w-]*)?)\s+(?:MUST|SHALL|SHOULD|MAY|REQUIRED|RECOMMENDED|OPTIONAL)\b/g;
+    let match;
+    while ((match = pattern.exec(before)) !== null) {
+        const candidate = match[1].toLowerCase().trim();
+        // 2 語の取り込みが接続詞を巻き込むことがある（"requests and MUST" →
+        // "requests and"）。1 語でも機能語が混じっていたら主語ではない。
+        if (candidate.split(/\s+/).some((word) => NOT_A_SUBJECT.has(word)))
+            continue;
+        found = candidate;
+    }
+    return found;
+}
+/**
+ * 前後の機能語を落とす。残らなければ `undefined`。
+ *
+ * 主語はキーワードの直前 1〜2 語から取るので、機能語を巻き込むことがある。
+ * "An origin server MUST NOT generate a Date header field" の 2 語は
+ * "response and"（RFC 9110 §10.2.1）や "methods are"（同 §9.1）になる。
+ * 落とすと "response" "methods" が残る。両方とも機能語なら主語ではない。
+ */
+function trimFunctionWords(subject) {
+    const words = subject.split(/\s+/).filter((word) => word.length > 0);
+    while (words.length > 0 && NOT_A_SUBJECT.has(words[words.length - 1]))
+        words.pop();
+    while (words.length > 0 && NOT_A_SUBJECT.has(words[0]))
+        words.shift();
+    return words.length > 0 ? words.join(' ') : undefined;
+}
+/** 前の文から引き継ぐ代名詞。 */
+const PRONOUN_SUBJECT = new Set(['it', 'they', 'them', 'this', 'these', 'those', 'he', 'she']);
+/** 主語として認めない語。接続詞・代名詞・関係詞。 */
+const NOT_A_SUBJECT = new Set([
+    'and',
+    'or',
+    'but',
+    'nor',
+    'so',
+    'then',
+    'it',
+    'its',
+    'this',
+    'that',
+    'these',
+    'those',
+    'they',
+    'them',
+    'we',
+    'you',
+    'he',
+    'she',
+    'which',
+    'who',
+    'whom',
+    'there',
+    'here',
+    'if',
+    'when',
+    'while',
+    'also',
+    'thus',
+    'hence',
+    'however',
+    'therefore',
+    'otherwise',
+    // 冠詞・前置詞・繋辞。1 語だけ取れたときに残ることがある。
+    'the',
+    'a',
+    'an',
+    'of',
+    'to',
+    'in',
+    'on',
+    'at',
+    'by',
+    'as',
+    'for',
+    'from',
+    'with',
+    'is',
+    'are',
+    'was',
+    'were',
+    'be',
+    'been',
+    'being',
+    'has',
+    'have',
+    'had',
+    'not',
+    'no',
+    'all',
+    'any',
+    'each',
+    'every',
+    'such',
+    'other',
+    'both',
+]);
 //# sourceMappingURL=requirement-extractor.js.map