dsh-pleading-draft 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.2.2
+
+- Rework the README first screen. The H1 now names what the plugin checks rather
+  than repeating the package name, and a question-and-answer table and a standards
+  table come before the boundary paragraph.
+
+  The substance is unchanged and the boundary paragraph is verbatim: in a
+  compliance tool that paragraph is what stops a wrong "pass" being read as
+  approval, so it moved rather than shrank. What changed is the order - a reader
+  or an extractor previously met eleven badges, an install command and a
+  disclaimer before learning what the plugin does. The Q&A rows are derived from
+  each plugin's own rules and the standards table from the rule pack's
+  `document`/`number` fields, so no answer and no standard is hand-typed.
+
+  All five languages were restructured together; `check:readmes` holds them to the
+  same section count, install command and configuration keys.
+
 ## 0.2.1
 
 - Ship `CHANGELOG.md` and `SECURITY.md` inside the package. `files` is an

package/README-es.md

@@ -1,4 +1,23 @@
-# dsh-pleading-draft
+# dsh-pleading-draft — Verificación de la completitud de la lista de elementos de la demanda, fila por pretensión
+
+`dsh-pleading-draft` lee una lista de elementos de la demanda —la cabecera del caso más una fila por pretensión, con sus columnas `序号`、`诉讼请求`、`事实依据`、`证据`、`法律依据`、`金额` y `期限`— y comprueba la completitud y la coherencia interna de ese documento: que cada pretensión registre su base fáctica, señale pruebas y exponga su fundamento jurídico, que la pretensión que lleva importe lleve también plazo de cumplimiento, que la cabecera nombre al demandante y al demandado, que no se repita ningún número de elemento y que no quede ningún marcador de plantilla sin sustituir en la columna de pretensiones.
+
+## Qué responde
+
+| Usted pregunta | Qué responde |
+|---|---|
+| La pretensión está redactada, pero la columna de pruebas no señala nada. | `PL-002` señala la fila cuya columna `证据` no apunta a ninguna prueba: comprueba que la referencia esté escrita, no que la prueba exista, esté completa o se refiera a esa pretensión concreta. |
+| La columna de fundamento jurídico solo contiene una frase general, como «las disposiciones aplicables». | `PL-003` exige que la columna `法律依据` esté completa en cada elemento de pretensión. Informa de la columna vacía; no verifica que el precepto citado exista, esté vigente o se aplique al caso. |
+| El importe consta, pero no se registra plazo de cumplimiento. | `PL-004` solo se activa cuando la columna `金额` está rellena y entonces exige la columna `期限`: un importe sin plazo se informa. A una pretensión meramente declarativa no se le pide un plazo que no tiene. No se comprueba si el importe está bien calculado ni si el plazo es razonable. |
+| ¿Qué campos debe llevar la cabecera del caso? | `PL-005` exige que la cabecera nombre al demandante y al demandado; ambos son campos de configuración, así que su propio formulario puede añadir la causa y el tribunal receptor. No comprueba que las partes sean las correctas para esa pretensión. |
+| ¿Qué ocurre si la columna de pretensiones aún contiene un marcador de plantilla? | `PL-007` lo señala: los términos que busca son `【`, `】`, `{{`, `}}`, `XXX`, `xxx`, `待填`, `待补充`, `TBD`, `todo` y `示例`. Una pretensión vaga que no contenga ninguno de esos términos pasa, porque juzgar la precisión exigible a una pretensión es una valoración jurídica. |
+| Una regla aparece en `skipped` en lugar de informar de algo. ¿Significa que pasó? | No. `skipped` nombra una comprobación que no se ejecutó: `PL-002`, por ejemplo, figura ahí cuando estaba desactivada en la configuración, cuando quedó fuera por la selección `only` o cuando el material cumplía su precondición y no se halló ninguna diferencia. Una comprobación que no se ejecuta no puede dar por buena una columna, y su límite sigue en pie: nunca ve si la prueba es suficiente o corresponde a la pretensión. |
+
+## Normas que sigue
+
+| Documento | Número | Reglas que lo citan |
+|---|---|---|
+| 《中华人民共和国民事诉讼法》 | 1991年通过，经 2007、2012、2017、2021、2023 年五次修正（现行条号据 2021 年第四次修正及 2023 年第五次修正文本核对） | PL-001, PL-002, PL-003, PL-004, PL-005, PL-006, PL-007 |
 
 **Boundary:** this plugin checks a **起诉状（或申请书）要素核对表** for completeness — that every claim records
 its factual basis, points at evidence, states its legal basis, that a monetary claim states an amount and a

package/README-hi.md

@@ -1,4 +1,23 @@
-# dsh-pleading-draft
+# dsh-pleading-draft — वाद-पत्र के तत्वों की सूची की पूर्णता की जाँच, प्रत्येक दावे की एक पंक्ति
+
+`dsh-pleading-draft` वाद-पत्र (अथवा आवेदन) के तत्वों की सूची पढ़ता है — मुकदमे का शीर्षक और प्रत्येक दावे की एक पंक्ति, जिसमें `序号`、`诉讼请求`、`事实依据`、`证据`、`法律依据`、`金额`、`期限` कॉलम होते हैं — और उसी दस्तावेज़ की पूर्णता तथा आंतरिक सुसंगति की जाँच करता है: क्या प्रत्येक दावे का तथ्य-आधार दर्ज है, साक्ष्य की ओर संकेत है और विधिक आधार लिखा है, क्या राशि वाले दावे में पालन-अवधि भी दर्ज है, क्या शीर्षक में वादी और प्रतिवादी के नाम हैं, क्या कोई क्रमांक दोहराया नहीं गया है, और क्या दावा-कॉलम में कोई भरा न गया टेम्पलेट प्लेसहोल्डर शेष है।
+
+## यह किन सवालों का जवाब देता है
+
+| आपका सवाल | इसका जवाब |
+|---|---|
+| दावा लिखा गया है, पर साक्ष्य कॉलम किसी ओर संकेत नहीं करता। | `PL-002` उस पंक्ति को दर्ज करता है जिसका `证据` कॉलम साक्ष्य की ओर संकेत नहीं करता: यह देखता है कि संदर्भ लिखा है, यह नहीं कि साक्ष्य मौजूद है, पूरा है या उसी दावे से संबंधित है। |
+| विधिक आधार कॉलम में केवल «संबंधित उपबंध» जैसा सामान्य वाक्य लिखा है। | `PL-003` हर दावे के तत्व में `法律依据` कॉलम भरा होने की अपेक्षा करता है। खाली कॉलम दर्ज होता है; यह नहीं जाँचता कि उद्धृत उपबंध मौजूद है, प्रभावी है या इस मामले पर लागू होता है। |
+| राशि लिखी है, पर पालन-अवधि दर्ज नहीं है। | `PL-004` केवल तब चलता है जब `金额` कॉलम भरा हो, और तब `期限` कॉलम की अपेक्षा करता है: अवधि के बिना राशि दर्ज होती है। केवल घोषणात्मक दावे से ऐसी अवधि नहीं माँगी जाती जो उसमें नहीं है। राशि का हिसाब सही है या अवधि उचित है, यह नहीं जाँचा जाता। |
+| मुकदमे के शीर्षक में कौन-कौन से क्षेत्र होने चाहिए? | `PL-005` शीर्षक में वादी और प्रतिवादी के नाम की अपेक्षा करता है; दोनों कॉन्फ़िगरेशन क्षेत्र हैं, इसलिए आपका अपना प्रपत्र वाद-कारण और विचारणीय न्यायालय भी जोड़ सकता है। यह नहीं जाँचता कि पक्षकार इस दावे के लिए सही हैं या नहीं। |
+| यदि दावा-कॉलम में अब भी टेम्पलेट प्लेसहोल्डर रह गया हो तो क्या होता है? | `PL-007` उसे दर्ज करता है: यह जिन शब्दों को खोजता है वे हैं `【`, `】`, `{{`, `}}`, `XXX`, `xxx`, `待填`, `待补充`, `TBD`, `todo` और `示例`। इनमें से कोई शब्द न रखने वाला अस्पष्ट दावा पास हो जाता है, क्योंकि दावे की अपेक्षित स्पष्टता का निर्णय विधिक निर्णय है। |
+| कोई नियम कुछ दर्ज करने के बजाय `skipped` में दिखता है। क्या इसका अर्थ है कि वह पास हो गया? | नहीं। `skipped` उस जाँच का नाम है जो चली ही नहीं: उदाहरण के लिए `PL-002` वहाँ तब आता है जब वह कॉन्फ़िगरेशन में बंद थी, `only` चयन से बाहर रह गई, अथवा सामग्री उसकी पूर्व-शर्त पूरी करती थी और कोई अंतर नहीं मिला। जो जाँच चलती ही नहीं, वह किसी कॉलम को पास नहीं करा सकती, और उसकी सीमा वही रहती है: वह कभी नहीं देखती कि साक्ष्य पर्याप्त है या दावे से मेल खाता है। |
+
+## यह किन मानकों पर आधारित है
+
+| दस्तावेज़ | संख्यांक | इन्हें उद्धृत करने वाले नियम |
+|---|---|---|
+| 《中华人民共和国民事诉讼法》 | 1991年通过，经 2007、2012、2017、2021、2023 年五次修正（现行条号据 2021 年第四次修正及 2023 年第五次修正文本核对） | PL-001, PL-002, PL-003, PL-004, PL-005, PL-006, PL-007 |
 
 **Boundary:** this plugin checks a **起诉状（或申请书）要素核对表** for completeness — that every claim records
 its factual basis, points at evidence, states its legal basis, that a monetary claim states an amount and a

package/README-pt.md

@@ -1,4 +1,23 @@
-# dsh-pleading-draft
+# dsh-pleading-draft — Verificação da completude da lista de elementos da petição inicial, linha por pedido
+
+`dsh-pleading-draft` lê uma lista de elementos da petição inicial —o cabeçalho do processo mais uma linha por pedido, com as suas colunas `序号`、`诉讼请求`、`事实依据`、`证据`、`法律依据`、`金额` e `期限`— e verifica a completude e a coerência interna desse documento: se cada pedido regista o seu fundamento de facto, indica provas e apresenta o seu fundamento jurídico, se o pedido com montante indica também prazo de cumprimento, se o cabeçalho nomeia o autor e o réu, se não há números de elemento repetidos e se não resta nenhum marcador de modelo por substituir na coluna dos pedidos.
+
+## O que ele responde
+
+| Você pergunta | O que ele responde |
+|---|---|
+| O pedido está redigido, mas a coluna das provas não aponta para nada. | `PL-002` assinala a linha cuja coluna `证据` não aponta para provas: verifica que a referência está escrita, não que a prova exista, esteja completa ou diga respeito a esse pedido em concreto. |
+| A coluna do fundamento jurídico contém apenas uma frase genérica, como «as disposições aplicáveis». | `PL-003` exige que a coluna `法律依据` esteja preenchida em cada elemento do pedido. Reporta a coluna vazia; não verifica se a norma citada existe, está em vigor ou se aplica ao caso. |
+| O montante está indicado, mas não há prazo de cumprimento registado. | `PL-004` só dispara quando a coluna `金额` está preenchida e exige então a coluna `期限`: um montante sem prazo é reportado. A um pedido meramente declarativo não se pede um prazo que ele não tem. Não se verifica se o montante está bem calculado nem se o prazo é razoável. |
+| Que campos deve conter o cabeçalho do processo? | `PL-005` exige que o cabeçalho nomeie o autor e o réu; ambos são campos de configuração, pelo que o seu próprio formulário pode acrescentar a causa e o tribunal recetor. Não verifica se as partes são as corretas para esse pedido. |
+| O que acontece se a coluna dos pedidos ainda contiver um marcador de modelo? | `PL-007` assinala-o: os termos que procura são `【`, `】`, `{{`, `}}`, `XXX`, `xxx`, `待填`, `待补充`, `TBD`, `todo` e `示例`. Um pedido vago que não contenha nenhum desses termos passa, porque avaliar a precisão exigível a um pedido é um juízo jurídico. |
+| Uma regra aparece em `skipped` em vez de reportar algo. Isso significa que passou? | Não. `skipped` nomeia uma verificação que não correu: `PL-002`, por exemplo, surge aí quando estava desativada na configuração, quando ficou de fora pela seleção `only` ou quando o material cumpria a sua precondição e não foi encontrada qualquer diferença. Uma verificação que não corre não pode dar por boa uma coluna, e o seu limite mantém-se: nunca vê se a prova é suficiente ou corresponde ao pedido. |
+
+## Normas que segue
+
+| Documento | Número | Regras que o citam |
+|---|---|---|
+| 《中华人民共和国民事诉讼法》 | 1991年通过，经 2007、2012、2017、2021、2023 年五次修正（现行条号据 2021 年第四次修正及 2023 年第五次修正文本核对） | PL-001, PL-002, PL-003, PL-004, PL-005, PL-006, PL-007 |
 
 **Boundary:** this plugin checks a **起诉状（或申请书）要素核对表** for completeness — that every claim records
 its factual basis, points at evidence, states its legal basis, that a monetary claim states an amount and a

package/README-zh.md

@@ -1,4 +1,23 @@
-# dsh-pleading-draft
+# dsh-pleading-draft — 起诉状要素齐备性核对
+
+`dsh-pleading-draft` 读取一份起诉状（或申请书）要素核对表——案件表头加每项请求要素一行，含 `序号`、`诉讼请求`、`事实依据`、`证据`、`法律依据`、`金额`、`期限` 各栏——核对这份文书自身的齐备与自洽：每项诉请是否写明事实依据、是否指明证据、是否写明法律依据，写了金额的是否也写了履行期限，表头是否写明原告与被告，请求要素序号是否重复，诉请栏是否残留未替换的占位符。
+
+## 它回答什么问题
+
+| 你会问 | 它怎么答 |
+|---|---|
+| 诉讼请求写了，但「证据」栏什么都没指。 | `PL-002` 会报出 `证据` 栏没有指明证据的行。它只核对是否写明了指向，不判断证据是否存在、是否完整、是否与该项诉请对应。 |
+| 「法律依据」栏只写了「相关法律规定」这样一句笼统的话。 | `PL-003` 要求每项请求要素都填写 `法律依据` 栏。栏内空白会被报出；它不校验所引法条是否存在、是否现行有效、是否适用于本案。 |
+| 金额写了，履行期限没有写。 | `PL-004` 只在 `金额` 栏已填写时才启动，随后要求填写 `期限` 栏：有金额而无期限的会被报出。确认之诉不会被要求写它本来就没有的期限。金额算得对不对、期限是否合理，它不核对。 |
+| 表头必须写哪些字段？ | `PL-005` 要求表头写明原告与被告；这两项是配置字段，本机构表式可以把案由与受诉法院一并加进去。它不判断当事人是不是该案适格的当事人。 |
+| 诉请栏里还留着模板占位符，会怎样？ | `PL-007` 会报出。它找的词是 `【`、`】`、`{{`、`}}`、`XXX`、`xxx`、`待填`、`待补充`、`TBD`、`todo`、`示例`。措辞含糊但不含这些词的诉请会通过，因为判断诉请该写到多具体是法律判断。 |
+| 某条规则出现在 `skipped` 里，而不是报出差错——算它通过了吗？ | 不算。`skipped` 列的是**没有执行**的检查：例如 `PL-002` 在配置里被停用、被 `only` 限定在本次执行范围之外，或者材料已满足它的前置条件且未发现差异条目时，都会出现在这里。没有执行的检查不可能把某一栏核清，它的能力边界依旧：它看不到证据是否充分、是否与诉请对应。 |
+
+## 依据的标准
+
+| 文件 | 文号 | 引用它的规则 |
+|---|---|---|
+| 《中华人民共和国民事诉讼法》 | 1991年通过，经 2007、2012、2017、2021、2023 年五次修正（现行条号据 2021 年第四次修正及 2023 年第五次修正文本核对） | PL-001, PL-002, PL-003, PL-004, PL-005, PL-006, PL-007 |
 
 **Boundary:** this plugin checks a **起诉状（或申请书）要素核对表** for completeness — that every claim records
 its factual basis, points at evidence, states its legal basis, that a monetary claim states an amount and a

package/README.md

@@ -1,4 +1,23 @@
-# dsh-pleading-draft
+# dsh-pleading-draft — Pleading element checklist completeness check, one row per claim
+
+`dsh-pleading-draft` reads one pleading-element checklist — the case header plus one row per claim, with its `序号`、`诉讼请求`、`事实依据`、`证据`、`法律依据`、`金额`、`期限` columns — and checks that document's own completeness and internal consistency: that every claim records a factual basis, points at evidence and states a legal basis, that a claim carrying an amount also carries a performance deadline, that the header names the plaintiff and the defendant, that no element number is repeated, and that no unreplaced placeholder survives in the claim column.
+
+## What it answers
+
+| You ask | What it answers |
+|---|---|
+| The claim is written out, but the evidence column points at nothing. | `PL-002` reports the row whose `证据` column does not point at evidence — it checks that a reference is written, not that the evidence exists, is complete or bears on that particular claim. |
+| The legal-basis column holds only a general phrase such as “relevant provisions”. | `PL-003` requires the `法律依据` column to be filled on every claim element. It reports an empty column; it does not verify that the provision cited exists, is in force or applies to the case. |
+| The amount is stated, but no performance deadline is recorded. | `PL-004` fires only when the `金额` column is filled, and then requires the `期限` column: an amount without a deadline is reported. A claim for a declaration is not asked for a deadline it does not have. Whether the amount is computed correctly or the deadline is reasonable is not checked. |
+| Which fields must the case header carry? | `PL-005` requires the header to name the plaintiff and the defendant; both are configuration fields, so your own form can add the cause of action and the accepting court. It does not check that the parties are the right ones for that claim. |
+| What happens when the claim column still holds a template placeholder? | `PL-007` reports it: the terms it looks for are `【`, `】`, `{{`, `}}`, `XXX`, `xxx`, `待填`, `待补充`, `TBD`, `todo` and `示例`. A vague claim with none of those terms passes, because judging the required precision of a claim is a legal judgement. |
+| A rule appears in `skipped` instead of reporting anything. Does that mean it passed? | No. `skipped` names a check that did not run: `PL-002`, for instance, is listed there when it was disabled in configuration, left out by the `only` selection, or when the material met its precondition and no difference was found. A check that does not run cannot clear a column, and its own limit stands: it never sees whether the evidence suffices or corresponds to the claim. |
+
+## Standards it follows
+
+| Document | Number | Cited by rules |
+|---|---|---|
+| 《中华人民共和国民事诉讼法》 | 1991年通过，经 2007、2012、2017、2021、2023 年五次修正（现行条号据 2021 年第四次修正及 2023 年第五次修正文本核对） | PL-001, PL-002, PL-003, PL-004, PL-005, PL-006, PL-007 |
 
 **Boundary:** this plugin checks a **起诉状（或申请书）要素核对表** for completeness — that every claim records
 its factual basis, points at evidence, states its legal basis, that a monetary claim states an amount and a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-pleading-draft",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "起诉状要素齐备性核对（按诉请、事实、证据、法条四要素核对文书齐备，仅提示差异，不作出定性结论）",
   "type": "module",
   "main": "lib/index.mjs",