docx-cli 0.1.0__py3-none-any.whl

docx_cli/__init__.py

@@ -0,0 +1,8 @@
+"""docx-cli — deterministic .docx generation for Russian legal documents."""
+from docx_cli.builder import build_document
+from docx_cli.spec import DocSpec
+from docx_cli.validate import validate_document
+
+__version__ = "0.1.0"
+
+__all__ = ["build_document", "DocSpec", "validate_document"]

docx_cli/__main__.py

@@ -0,0 +1,7 @@
+"""Allow `python -m docx_cli`."""
+import sys
+
+from docx_cli.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

docx_cli/_templates/hodatajstvo.json

@@ -0,0 +1,60 @@
+{
+  "profile": "court",
+  "output": {
+    "file_name": "{дд.мм.гггг}.Ходатайство_{предмет_кратко}.docx",
+    "author": "{фио_представителя}"
+  },
+  "header": {
+    "align": "right",
+    "lines": [
+      "В {наименование_суда}",
+      "Судья: {фио_судьи}",
+      "Дело № {номер_дела}",
+      "Заявитель: {заявитель_наименование}, ИНН {инн}, ОГРН {огрн}"
+    ]
+  },
+  "title": {
+    "main": "ХОДАТАЙСТВО",
+    "subtitle": "{предмет_ходатайства: о назначении экспертизы / об истребовании доказательств / об обеспечении иска / о восстановлении срока}"
+  },
+  "body": [
+    {
+      "type": "paragraph",
+      "text": "В производстве суда находится дело № {номер_дела} по иску {истец_наименование} к {ответчик_наименование}.",
+      "inline_markdown": false
+    },
+    {
+      "type": "paragraph",
+      "text": "{обстоятельства_заявления}",
+      "inline_markdown": true
+    },
+    {
+      "type": "paragraph",
+      "text": "Правовое основание заявленного ходатайства: {правовое_обоснование} (процессуальный институт — {статья_АПК_или_ГПК}). Заявленное ходатайство отвечает требованиям: {критерии_удовлетворения}.",
+      "inline_markdown": true
+    },
+    {
+      "type": "paragraph",
+      "text": "На основании изложенного, руководствуясь {статья_АПК_или_ГПК}, прошу:",
+      "inline_markdown": false
+    },
+    {
+      "type": "numbered_list",
+      "items": [
+        "{просительная_часть}"
+      ]
+    },
+    {
+      "type": "attachments_list",
+      "items": [
+        "{приложение_1}",
+        "документ о полномочиях представителя (доверенность) — ст. 61, 62 АПК РФ{приложение_2}"
+      ]
+    },
+    {
+      "type": "signature_block",
+      "left": "Дата: {дата}",
+      "right": "Представитель _________________ /{фио_представителя}/"
+    }
+  ]
+}

docx_cli/_templates/iskovoe_zayavlenie.json

@@ -0,0 +1,75 @@
+{
+  "profile": "court",
+  "output": {
+    "file_name": "{дд.мм.гггг}.Исковое_заявление.docx",
+    "author": "{фио_представителя}"
+  },
+  "header": {
+    "align": "right",
+    "lines": [
+      "В {наименование_суда}",
+      "Истец: {истец_наименование}, ИНН {инн}, ОГРН {огрн}",
+      "Адрес: {адрес_истца}",
+      "Ответчик: {ответчик_наименование}, ИНН {инн_ответчика}, ОГРН {огрн_ответчика}",
+      "Адрес: {адрес_ответчика}",
+      "Цена иска: {цена_иска} руб.",
+      "Госпошлина: {госпошлина} руб. (расчет по ст. 333.21 НК РФ)"
+    ]
+  },
+  "title": {
+    "main": "ИСКОВОЕ ЗАЯВЛЕНИЕ",
+    "subtitle": "о взыскании {предмет_иска}"
+  },
+  "body": [
+    {
+      "type": "paragraph",
+      "text": "{обстоятельства_дела}",
+      "inline_markdown": true
+    },
+    {
+      "type": "paragraph",
+      "text": "Правовое обоснование: {правовое_обоснование}",
+      "inline_markdown": true
+    },
+    {
+      "type": "paragraph",
+      "text": "Расчет взыскиваемой суммы:",
+      "inline_markdown": false
+    },
+    {
+      "type": "numbered_list",
+      "items": [
+        "{расчет_1}",
+        "{расчет_2}"
+      ]
+    },
+    {
+      "type": "paragraph",
+      "text": "На основании изложенного, руководствуясь ст. 125, 126 АПК РФ, прошу:",
+      "inline_markdown": false
+    },
+    {
+      "type": "numbered_list",
+      "items": [
+        "взыскать с Ответчика {требование_1} (нормы: {норма_мата}; процессуальные: {норма_проц});",
+        "расходы по уплате государственной пошлины возложить на Ответчика (ст. 110 АПК РФ)."
+      ]
+    },
+    {
+      "type": "attachments_list",
+      "items": [
+        "уведомление о вручении копии искового заявления Ответчику;",
+        "документ об уплате государственной пошлины (ст. 333.21 НК РФ);",
+        "документы, подтверждающие обстоятельства, на которых основаны требования;",
+        "копия свидетельства о государственной регистрации Истца;",
+        "документ, подтверждающий полномочия подписанта (доверенность / выписка из Устава) — ст. 61, 62 АПК РФ;",
+        "{приложение_6}"
+      ]
+    },
+    {
+      "type": "signature_block",
+      "left": "Дата: {дата}",
+      "right": "Представитель Истца _________________ /{фио_представителя}/"
+    }
+  ]
+}

docx_cli/_templates/otzyv_na_isk.json

@@ -0,0 +1,69 @@
+{
+  "profile": "court",
+  "output": {
+    "file_name": "{дд.мм.гггг}.Отзыв_на_исковое_заявление.docx",
+    "author": "{фио_представителя}"
+  },
+  "header": {
+    "align": "right",
+    "lines": [
+      "В {наименование_суда}",
+      "Судья: {фио_судьи}",
+      "Дело № {номер_дела}",
+      "Истец: {истец_наименование}, ИНН {инн_истца}, ОГРН {огрн_истца}",
+      "Ответчик: {ответчик_наименование}, ИНН {инн}, ОГРН {огрн}"
+    ]
+  },
+  "title": {
+    "main": "ОТЗЫВ НА ИСКОВОЕ ЗАЯВЛЕНИЕ",
+    "subtitle": "(в порядке ст. 131 АПК РФ)"
+  },
+  "body": [
+    {
+      "type": "paragraph",
+      "text": "{ответчик_наименование} возражает против удовлетворения исковых требований {истец_наименование} по причинам:",
+      "inline_markdown": false
+    },
+    {
+      "type": "numbered_list",
+      "items": [
+        "{возражение_1}",
+        "{возражение_2}"
+      ]
+    },
+    {
+      "type": "paragraph",
+      "text": "Правовое обоснование возражений: {правовое_обоснование}. Доводы истца о том, что {довод_истца}, опровергаются следующим: {опровержение}.",
+      "inline_markdown": true
+    },
+    {
+      "type": "paragraph",
+      "text": "Доказательства, подтверждающие возражения: {перечень_доказательств}.",
+      "inline_markdown": false
+    },
+    {
+      "type": "paragraph",
+      "text": "На основании изложенного, руководствуясь ст. 131 АПК РФ, прошу:",
+      "inline_markdown": false
+    },
+    {
+      "type": "numbered_list",
+      "items": [
+        "в удовлетворении исковых требований {истец_наименование} к {ответчик_наименование} отказать полностью{или_частично}."
+      ]
+    },
+    {
+      "type": "attachments_list",
+      "items": [
+        "документ, подтверждающий направление копии отзыва истцу (ст. 131 АПК РФ);",
+        "документ о полномочиях представителя (доверенность) — ст. 61, 62 АПК РФ{приложение_3}",
+        "{приложение_4}"
+      ]
+    },
+    {
+      "type": "signature_block",
+      "left": "Дата: {дата}",
+      "right": "Представитель Ответчика _________________ /{фио_представителя}/"
+    }
+  ]
+}

docx_cli/_templates/soyu_rayon.json

@@ -0,0 +1,61 @@
+{
+  "profile": "soyu_rayon",
+  "output": {
+    "file_name": "{дд.мм.гггг}.Исковое_СОЮ_первой_инстанции.docx",
+    "author": "{фио_представителя}"
+  },
+  "header": {
+    "align": "right",
+    "lines": [
+      "В {наименование_районного_суда}",
+      "Для мирового судьи — участок: {наименование_судебного_участка}, мировой судья {фио_судьи}",
+      "Истец: {заявитель_наименование}, ИНН {инн}, ОГРН {огрн}",
+      "Адрес: {адрес_заявителя}",
+      "Представитель истца: {фио_представителя}",
+      "Ответчик: {ответчик_наименование}, ИНН {инн_ответчика}, ОГРН {огрн_ответчика}",
+      "Адрес: {адрес_ответчика}",
+      "Цена иска: {цена_иска} руб.",
+      "Госпошлина: {госпошлина} руб."
+    ]
+  },
+  "title": {
+    "main": "ИСКОВОЕ ЗАЯВЛЕНИЕ",
+    "subtitle": "{предмет_иска}"
+  },
+  "body": [
+    {
+      "type": "paragraph",
+      "text": "{обстоятельства_дела}",
+      "inline_markdown": true
+    },
+    {
+      "type": "paragraph",
+      "text": "Правовые основания требований: {правовые_основания} (вносятся legal-профилем через spec, шаблон их не содержит).",
+      "inline_markdown": true
+    },
+    {
+      "type": "paragraph",
+      "text": "На основании изложенного прошу:",
+      "inline_markdown": false
+    },
+    {
+      "type": "numbered_list",
+      "items": [
+        "{просительная_часть}"
+      ]
+    },
+    {
+      "type": "attachments_list",
+      "items": [
+        "{приложение_1}",
+        "{приложение_2}",
+        "документ о полномочиях представителя — {реквизиты_доверенности}"
+      ]
+    },
+    {
+      "type": "signature_block",
+      "left": "Дата: {дата}",
+      "right": "Представитель _________________ /{фио_представителя}/"
+    }
+  ]
+}

docx_cli/_templates/vs_sud.json

@@ -0,0 +1,65 @@
+{
+  "profile": "vs_sud",
+  "output": {
+    "file_name": "{дд.мм.гггг}.Обращение_ВС.docx",
+    "author": "{фио_представителя}"
+  },
+  "header": {
+    "align": "right",
+    "lines": [
+      "В Верховный Суд Российской Федерации",
+      "Адрес суда: {адрес_суда}",
+      "Заявитель: {заявитель_наименование}, ИНН {инн}, ОГРН {огрн}",
+      "Представитель: {фио_представителя}, {репрезентативные_документы}",
+      "Дело № {номер_дела}",
+      "Суды, принявшие обжалуемые акты: {суды_по_делу}",
+      "Цена иска: {цена_иска} руб. (заполняется только для имущественных требований)",
+      "Госпошлина: {госпошлина} руб."
+    ]
+  },
+  "title": {
+    "main": "ОБРАЩЕНИЕ",
+    "subtitle": "{вид_обращения}"
+  },
+  "body": [
+    {
+      "type": "paragraph",
+      "text": "Судебные акты по делу № {номер_дела}: {судебные_акты_по_делу}",
+      "inline_markdown": false
+    },
+    {
+      "type": "paragraph",
+      "text": "Обращение основано на следующем: {основания_обращения}",
+      "inline_markdown": true
+    },
+    {
+      "type": "paragraph",
+      "text": "Правовые основания обращения: {правовые_основания} (вносятся legal-профилем через spec, шаблон их не содержит).",
+      "inline_markdown": true
+    },
+    {
+      "type": "paragraph",
+      "text": "На основании изложенного прошу:",
+      "inline_markdown": false
+    },
+    {
+      "type": "numbered_list",
+      "items": [
+        "{просительная_часть}"
+      ]
+    },
+    {
+      "type": "attachments_list",
+      "items": [
+        "{приложение_1}",
+        "{приложение_2}",
+        "копии обжалуемых судебных актов — {количество_экземпляров}"
+      ]
+    },
+    {
+      "type": "signature_block",
+      "left": "Дата: {дата}",
+      "right": "Представитель _________________ /{фио_представителя}/"
+    }
+  ]
+}

docx_cli/agent_reader.py

@@ -0,0 +1,87 @@
+"""docx-cli agent-read — ограниченное JSON-чтение docx для агентов.
+
+v0.5.0 (clean-room: собственный agent-read для ИИ-агентов). Контракт: блоки
+(параграф/таблица) с id, полными char-offset в конкатенированном тексте,
+флагом complete и next_cursor — агент читает большие документы по окнам.
+
+Fail-closed: отсутствующий файл -> ошибка-конверт.
+"""
+from __future__ import annotations
+
+from pathlib import Path
+
+from docx import Document
+
+DEFAULT_MAX_CHARS = 4000
+
+
+class AgentReadError(Exception):
+    pass
+
+
+def _blocks(doc) -> list[dict]:
+    """Блоки документа по порядку: параграфы и таблицы (строки->ячейки)."""
+    out: list[dict] = []
+    # python-docx не даёт единый поток тело->таблица по порядку просто; идём
+    # по XML тела в порядке следования.
+    from docx.table import Table
+    from docx.text.paragraph import Paragraph
+    body = doc.element.body
+    for child in body.iterchildren():
+        tag = child.tag.rsplit('}', 1)[-1]
+        if tag == 'p':
+            p = Paragraph(child, doc)
+            if p.text.strip():
+                out.append({"kind": "paragraph", "text": p.text})
+        elif tag == 'tbl':
+            t = Table(child, doc)
+            for row in t.rows:
+                cells = [c.text.strip() for c in row.cells if c.text.strip()]
+                if cells:
+                    out.append({"kind": "table_row", "text": " | ".join(cells)})
+    return out
+
+
+def read(path: str | Path, start_char: int = 0, max_chars: int = DEFAULT_MAX_CHARS) -> dict:
+    if isinstance(start_char, bool) or isinstance(max_chars, bool) or \
+       not isinstance(start_char, int) or not isinstance(max_chars, int):
+        raise AgentReadError("invalid_usage: max and cursor must be integers")
+    if start_char < 0 or max_chars <= 0:
+        raise AgentReadError("invalid_usage: max must be >0 and cursor must be >=0")
+    p = Path(path)
+    if not p.is_file():
+        raise AgentReadError(f"file not found: {p}")
+    doc = Document(str(p))
+    blocks = _blocks(doc)
+    # полный текст = конкатенация с \n; каждому блоку — диапазон offsets
+    enriched = []
+    cursor = 0
+    for i, b in enumerate(blocks):
+        start = cursor
+        text = b["text"]
+        cursor += len(text) + 1  # +1 за \n
+        enriched.append({"id": f"b{i}", "kind": b["kind"], "text": text,
+                         "char_start": start, "char_end": cursor - 1})
+    total = cursor
+    if start_char > total or (total > 0 and start_char >= total):
+        raise AgentReadError(
+            f"invalid_usage: cursor {start_char} is beyond end (total_chars={total}); "
+            "use a cursor returned by a previous call or 0")
+    window_start = start_char
+    window_end = min(window_start + max_chars, total)
+
+    result = []
+    for b in enriched:
+        if b["char_end"] <= window_start or b["char_start"] >= window_end:
+            continue
+        text = b["text"]
+        s_off = max(window_start - b["char_start"], 0)
+        e_off = min(window_end - b["char_start"], len(text))
+        frag = text[s_off:e_off]
+        result.append({"id": b["id"], "kind": b["kind"], "text": frag,
+                       "char_start": b["char_start"] + s_off,
+                       "complete": s_off == 0 and e_off == len(text)})
+
+    next_cursor = window_end if window_end < total else None
+    return {"total_chars": total, "window": [window_start, window_end],
+            "blocks": result, "next_cursor": next_cursor}