siyuan-cli 1.1.0__py3-none-any.whl

siyuan_cli/__init__.py

@@ -0,0 +1,7 @@
+"""siyuan-cli — SiYuan Note command-line tool.
+
+Package for interacting with SiYuan Note's HTTP API.
+Create, read, search, and manage notes, blocks, tags, and assets.
+"""
+
+__version__ = "1.1.0"

siyuan_cli/__main__.py

@@ -0,0 +1,5 @@
+"""Entry point for `python3 -m siyuan_cli`."""
+
+from siyuan_cli.cli import main
+
+main()

siyuan_cli/audit.py

@@ -0,0 +1,44 @@
+"""Audit trail for destructive operations in siyuan-cli."""
+
+import json
+import os
+import time
+from typing import Any
+
+AUDIT_FILE = os.path.expanduser("~/.siyuan/audit.log")
+
+
+def _format_ts() -> str:
+    """ISO 8601 timestamp."""
+    return time.strftime("%Y-%m-%dT%H:%M:%S", time.localtime())
+
+
+def log_destructive(
+    action: str,
+    target: str,
+    detail: dict[str, Any] | None = None,
+    confirmed_via: str = "",
+) -> None:
+    """Log a destructive operation to the audit trail.
+
+    Args:
+        action: Human-readable action (e.g. "DELETE_DOC", "REMOVE_NOTEBOOK").
+        target: The resource identifier (document path, block ID, notebook ID).
+        detail: Optional extra context (e.g. notebook ID, timestamp).
+        confirmed_via: How the user confirmed (e.g. "--yes", "interactive").
+    """
+    entry: dict[str, Any] = {
+        "ts": _format_ts(),
+        "action": action,
+        "target": target,
+    }
+    if detail:
+        entry["detail"] = detail
+    if confirmed_via:
+        entry["confirmed"] = confirmed_via
+
+    parent = os.path.dirname(AUDIT_FILE)
+    if not os.path.isdir(parent):
+        os.makedirs(parent, mode=0o700)
+    with open(AUDIT_FILE, "a", encoding="utf-8") as f:
+        f.write(json.dumps(entry, ensure_ascii=False) + "\n")