chore: prepare v0.1.4 release

Author: JetXu-LLM

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "docmason"
-version = "0.1.3"
+version = "0.1.4"
 description = "A Python-first, file-only, agent-native workspace for building multimodal knowledge bases from complex office documents."
 readme = "README.md"
 license = { file = "LICENSE" }

src/docmason/commands.py

@@ -2675,9 +2675,13 @@ def prepare_workspace(
                 actions_performed.append(detail)
                 office_snapshot = office_renderer_snapshot(workspace)
                 if not bool(office_snapshot.get("ready")):
+                    validation_detail = (
+                        office_snapshot.get("validation_detail")
+                        or office_snapshot.get("detail")
+                    )
                     actions_skipped.append(
                         "LibreOffice repair completed, but the renderer is still not usable. "
-                        f"Details: {office_snapshot.get('validation_detail') or office_snapshot.get('detail')}"
+                        f"Details: {validation_detail}"
                     )
             else:
                 actions_skipped.append(detail)

src/docmason/hybrid.py

@@ -1120,7 +1120,8 @@ def ensure_hires_focus_render(
         pdf_path = source_path
         document_type = str(source_manifest.get("document_type") or "")
         if document_type != "pdf":
-            from .knowledge import convert_office_to_pdf, validate_soffice_binary
+            from .knowledge import convert_office_to_pdf
+            from .libreoffice_runtime import validate_soffice_binary
 
             office_state = validate_soffice_binary(None)
             office_binary = office_state.get("binary")

src/docmason/knowledge.py

@@ -7,7 +7,6 @@
 import os
 import re
 import shutil
-import subprocess
 import sys
 import tempfile
 import uuid
@@ -68,16 +67,11 @@
     mark_promoted_interaction_entries,
     repair_interaction_memory_related_sources,
 )
-from .libreoffice_runtime import (
-    find_soffice_binary,
-    run_office_conversion,
-    validate_soffice_binary,
-)
+from .libreoffice_runtime import run_office_conversion
 from .project import (
     WorkspacePaths,
     isoformat_timestamp,
     read_json,
-    relative_paths,
     source_index,
     source_inventory_signature,
     source_type_definition,
@@ -972,7 +966,10 @@ def convert_office_to_format(
         failures.append(
             {
                 "stage": f"convert-office-to-{extension}",
-                "detail": f"LibreOffice conversion completed without producing a .{extension} output.",
+                "detail": (
+                    "LibreOffice conversion completed without producing "
+                    f"a .{extension} output."
+                ),
             }
         )
         return None, failures

src/docmason/libreoffice_runtime.py

@@ -99,15 +99,22 @@ def _write_minimal_docx_probe(path: Path) -> None:
 <Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">
   <Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>
   <Default Extension="xml" ContentType="application/xml"/>
-  <Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/>
+  <Override
+    PartName="/word/document.xml"
+    ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"
+  />
 </Types>
 """,
         )
         archive.writestr(
             "_rels/.rels",
             """<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
-  <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="word/document.xml"/>
+  <Relationship
+    Id="rId1"
+    Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument"
+    Target="word/document.xml"
+  />
 </Relationships>
 """,
         )
@@ -138,7 +145,15 @@ def _write_minimal_docx_probe(path: Path) -> None:
     </w:p>
     <w:sectPr>
       <w:pgSz w:w="12240" w:h="15840"/>
-      <w:pgMar w:top="1440" w:right="1440" w:bottom="1440" w:left="1440" w:header="720" w:footer="720" w:gutter="0"/>
+      <w:pgMar
+        w:top="1440"
+        w:right="1440"
+        w:bottom="1440"
+        w:left="1440"
+        w:header="720"
+        w:footer="720"
+        w:gutter="0"
+      />
     </w:sectPr>
   </w:body>
 </w:document>

tests/support_source_build_office_pdf.py

@@ -33,11 +33,6 @@
     required_overlay_slots,
     select_lane_b_batch,
 )
-from docmason.libreoffice_runtime import (
-    find_soffice_binary,
-    run_office_conversion,
-    validate_soffice_binary,
-)
 from docmason.knowledge import (
     _ThirdPartyDiagnosticCapture,
     build_docx_source,
@@ -49,6 +44,11 @@
     sanitize_text,
     source_artifact_contract_complete,
 )
+from docmason.libreoffice_runtime import (
+    find_soffice_binary,
+    run_office_conversion,
+    validate_soffice_binary,
+)
 from docmason.project import WorkspacePaths, read_json, write_json
 from docmason.semantic_overlays import semantic_overlay_candidates, write_semantic_overlay
 from docmason.versioning import migrate_legacy_publish_storage, publish_ledger_entries
@@ -1018,7 +1018,12 @@ def fake_run(
             ) -> subprocess.CompletedProcess[str]:
                 del capture_output, text, check, timeout, env
                 if command[0] == "/usr/bin/open":
-                    return subprocess.CompletedProcess(command, 1, stdout="", stderr="launch failed")
+                    return subprocess.CompletedProcess(
+                        command,
+                        1,
+                        stdout="",
+                        stderr="launch failed",
+                    )
                 return subprocess.CompletedProcess(command, 134, stdout="", stderr="Abort trap: 6")
 
             with (

tests/support_workspace_bootstrap_and_status.py

@@ -770,9 +770,15 @@ def test_bootstrap_launcher_preserves_conservative_fallback_without_healthy_host
         self.assertEqual(payload["status"], ACTION_REQUIRED)
         self.assertEqual(
             payload["detail"],
-            "DocMason cannot safely confirm that this Codex turn allows the network downloads required for repo-local runtime bootstrap.",
+            (
+                "DocMason cannot safely confirm that this Codex turn allows the network "
+                "downloads required for repo-local runtime bootstrap."
+            ),
+        )
+        self.assertEqual(
+            payload["host_execution"]["context_source"],
+            "env-codex-thread-id-fallback",
         )
-        self.assertEqual(payload["host_execution"]["context_source"], "env-codex-thread-id-fallback")
         self.assertIsNone(payload["host_execution"]["sandbox_policy"])
         self.assertIsNone(payload["host_execution"]["permission_mode"])
         self.assertFalse(payload["host_execution"]["full_machine_access"])
@@ -2200,7 +2206,10 @@ def runner(command: list[str] | tuple[str, ...], cwd: Path) -> CommandExecution:
         self.assertEqual(report.payload["machine_baseline_status"], "ready")
         official_install.assert_called_once()
         self.assertFalse(
-            any(command == ["/opt/homebrew/bin/brew", "install", "--cask", "libreoffice-still"] for command in seen_commands)
+            any(
+                command == ["/opt/homebrew/bin/brew", "install", "--cask", "libreoffice-still"]
+                for command in seen_commands
+            )
         )
 
     def test_prepare_is_ready_without_homebrew_when_office_renderer_is_already_available(
@@ -2650,7 +2659,10 @@ def test_status_reports_detected_but_unusable_libreoffice_under_default_permissi
         ):
             report = status_workspace(workspace, editable_install_probe=self.missing_probe)
 
-        self.assertEqual(report.payload["environment"]["machine_baseline_status"], "host-access-upgrade-required")
+        self.assertEqual(
+            report.payload["environment"]["machine_baseline_status"],
+            "host-access-upgrade-required",
+        )
         self.assertTrue(
             report.payload["environment"]["machine_baseline"]["libreoffice_detected_but_unusable"]
         )