scrybe-cli 0.1.1__tar.gz → 0.2.0__tar.gz

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/Cargo.lock

@@ -3525,7 +3525,7 @@ checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
 
 [[package]]
 name = "scrybe-app"
-version = "0.1.1"
+version = "0.2.0"
 dependencies = [
  "anyhow",
  "dirs 5.0.1",
@@ -3551,7 +3551,7 @@ dependencies = [
 
 [[package]]
 name = "scrybe-cli"
-version = "0.1.1"
+version = "0.2.0"
 dependencies = [
  "anyhow",
  "clap",
@@ -3570,7 +3570,7 @@ dependencies = [
 
 [[package]]
 name = "scrybe-core"
-version = "0.1.1"
+version = "0.2.0"
 dependencies = [
  "anyhow",
  "blake3",
@@ -3587,7 +3587,7 @@ dependencies = [
 
 [[package]]
 name = "scrybe-mcp-client"
-version = "0.1.1"
+version = "0.2.0"
 dependencies = [
  "anyhow",
  "dirs 5.0.1",
@@ -3602,7 +3602,7 @@ dependencies = [
 
 [[package]]
 name = "scrybe-mcp-server"
-version = "0.1.1"
+version = "0.2.0"
 dependencies = [
  "anyhow",
  "clap",
@@ -3619,7 +3619,7 @@ dependencies = [
 
 [[package]]
 name = "scrybe-mermaid"
-version = "0.1.1"
+version = "0.2.0"
 dependencies = [
  "anyhow",
  "base64 0.22.1",
@@ -3635,7 +3635,7 @@ dependencies = [
 
 [[package]]
 name = "scrybe-py"
-version = "0.1.1"
+version = "0.2.0"
 dependencies = [
  "anyhow",
  "pyo3",
@@ -3649,7 +3649,7 @@ dependencies = [
 
 [[package]]
 name = "scrybe-render"
-version = "0.1.1"
+version = "0.2.0"
 dependencies = [
  "anyhow",
  "pulldown-cmark",
@@ -3662,7 +3662,7 @@ dependencies = [
 
 [[package]]
 name = "scrybe-rpc"
-version = "0.1.1"
+version = "0.2.0"
 dependencies = [
  "serde",
  "serde_json",
@@ -3671,7 +3671,7 @@ dependencies = [
 
 [[package]]
 name = "scrybe-vcs"
-version = "0.1.1"
+version = "0.2.0"
 dependencies = [
  "anyhow",
  "chrono",

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/Cargo.toml

@@ -52,14 +52,14 @@ tauri-build = { version = "2", features = [] }
 # Internal crates — version pinned (=) so cargo publish accepts the
 # tarballs (path-deps without versions are rejected at publish time).
 # Workspace lock-step: every release bumps all members together.
-scrybe-core       = { path = "scrybe-core",       version = "=0.1.1" }
-scrybe-render     = { path = "scrybe-render",     version = "=0.1.1" }
-scrybe-mcp-client = { path = "scrybe-mcp-client", version = "=0.1.1" }
-scrybe-mcp-server = { path = "scrybe-mcp-server", version = "=0.1.1" }
-scrybe-mermaid    = { path = "scrybe-mermaid",    version = "=0.1.1" }
-scrybe-vcs        = { path = "scrybe-vcs",        version = "=0.1.1" }
-scrybe-py         = { path = "scrybe-py",         version = "=0.1.1" }
-scrybe-rpc        = { path = "scrybe-rpc",        version = "=0.1.1" }
+scrybe-core       = { path = "scrybe-core",       version = "=0.2.0" }
+scrybe-render     = { path = "scrybe-render",     version = "=0.2.0" }
+scrybe-mcp-client = { path = "scrybe-mcp-client", version = "=0.2.0" }
+scrybe-mcp-server = { path = "scrybe-mcp-server", version = "=0.2.0" }
+scrybe-mermaid    = { path = "scrybe-mermaid",    version = "=0.2.0" }
+scrybe-vcs        = { path = "scrybe-vcs",        version = "=0.2.0" }
+scrybe-py         = { path = "scrybe-py",         version = "=0.2.0" }
+scrybe-rpc        = { path = "scrybe-rpc",        version = "=0.2.0" }
 
 [workspace.lints.clippy]
 explicit_iter_loop     = "warn"

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scrybe-cli
-Version: 0.1.1
+Version: 0.2.0
 Summary: Scrybe CLI — headless Markdown render/lint/mermaid tool (binary wheel)
 Home-Page: https://github.com/hartsock/scrybe
 License: Apache-2.0

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "scrybe-cli"
-version = "0.1.1"
+version = "0.2.0"
 description = "Scrybe CLI — headless Markdown render/lint/mermaid tool (binary wheel)"
 license = {text = "Apache-2.0"}
 readme = "README.md"

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/scrybe-cli/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "scrybe-cli"
-version = "0.1.1"
+version = "0.2.0"
 edition = "2021"
 description = "Scrybe CLI — headless render/lint/mermaid/panel command-line tool"
 license = "Apache-2.0"

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/scrybe-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "scrybe-core"
-version = "0.1.1"
+version = "0.2.0"
 edition = "2021"
 description = "Scrybe core — AST, Document, ContentAddressable, Plugin trait, Workspace"
 license = "Apache-2.0"

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/scrybe-mcp-server/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "scrybe-mcp-server"
-version = "0.1.1"
+version = "0.2.0"
 edition = "2021"
 description = "Scrybe MCP server — inbound MCP tools: open/read/section/edit/diff/find/embed/lint"
 license = "Apache-2.0"

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/scrybe-mcp-server/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "scrybe-mcp-server"
-version = "0.1.1"
+version = "0.2.0"
 description = "Scrybe MCP server — standalone inbound MCP server (binary wheel)"
 license = {text = "Apache-2.0"}
 readme = "README.md"

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/scrybe-mermaid/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "scrybe-mermaid"
-version = "0.1.1"
+version = "0.2.0"
 edition = "2021"
 description = "Scrybe mermaid — standalone PNG iTXt codec, embeds Mermaid source in PNG metadata"
 license = "Apache-2.0"

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/scrybe-mermaid/README.md

@@ -16,6 +16,37 @@ Mermaid diagram source alongside the rendered image. The PNG is fully valid
 and renders normally in any image viewer. The source text travels with the
 image and can be round-tripped without loss.
 
+## Python quick start
+
+```bash
+pip install scrybe-mermaid
+```
+
+```python
+from pathlib import Path
+from scrybe_mermaid import embed, extract
+
+source = """
+graph TD
+    A[Christmas] -->|Get money| B(Go shopping)
+    B --> C{Let me think}
+    C -->|One| D[Laptop]
+    C -->|Two| E[iPhone]
+"""
+
+# diagram.png: any PNG — render one with mmdc, Kroki, or the Mermaid live editor
+png_in = Path("diagram.png").read_bytes()
+png_out = embed(png_in, source)
+Path("diagram-with-source.png").write_bytes(png_out)
+
+payload = extract(png_out)
+if payload.source != source:  # optional
+    raise ValueError("Round-trip mismatch")
+print(f"Round-tripped {len(payload.source)} chars; sha256={payload.sha256[:12]}…")
+```
+
+The resulting PNG renders normally in any image viewer *and* carries its own Mermaid source for round-tripping. See the [API reference](#key-public-types-and-entry-points) below.
+
 ## Codec format
 
 - **Chunk key:** `scrybe-mermaid`

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/scrybe-mermaid/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "scrybe-mermaid"
-version = "0.1.1"
+version = "0.2.0"
 description = "Scrybe Mermaid — standalone PNG iTXt codec (Rust-backed)"
 license = {text = "Apache-2.0"}
 readme = "README.md"
@@ -14,6 +14,9 @@ dependencies = []
 [project.urls]
 Homepage = "https://github.com/hartsock/scrybe"
 
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
 [tool.maturin]
 module-name = "scrybe_mermaid._rust"
 python-source = "python"

scrybe_cli-0.2.0/scrybe-mermaid/tests/test_python_quickstart.py

@@ -0,0 +1,53 @@
+# SPDX-License-Identifier: Apache-2.0
+"""Integration test: README Python quick-start example round-trips correctly."""
+import struct
+import zlib
+from pathlib import Path
+
+import pytest
+
+scrybe_mermaid = pytest.importorskip("scrybe_mermaid")
+
+
+def _minimal_png() -> bytes:
+    """Build a 1×1 white RGB PNG from stdlib primitives — no external deps."""
+    sig = b"\x89PNG\r\n\x1a\n"
+
+    def chunk(name: bytes, data: bytes) -> bytes:
+        crc = zlib.crc32(name + data) & 0xFFFFFFFF
+        return struct.pack(">I", len(data)) + name + data + struct.pack(">I", crc)
+
+    ihdr = struct.pack(">IIBBBBB", 1, 1, 8, 2, 0, 0, 0)  # 1×1, 8-bit RGB
+    idat = zlib.compress(b"\x00\xff\xff\xff")             # filter=0, R G B = white
+    return sig + chunk(b"IHDR", ihdr) + chunk(b"IDAT", idat) + chunk(b"IEND", b"")
+
+
+def test_readme_quickstart_roundtrip(tmp_path: Path) -> None:
+    """README quick-start example embeds and extracts Mermaid source correctly."""
+    if not scrybe_mermaid._RUST_AVAILABLE:
+        pytest.skip("Rust extension not built — run: maturin develop --release")
+
+    (tmp_path / "diagram.png").write_bytes(_minimal_png())
+
+    # ── verbatim from README ──────────────────────────────────────────────────
+    source = """
+graph TD
+    A[Christmas] -->|Get money| B(Go shopping)
+    B --> C{Let me think}
+    C -->|One| D[Laptop]
+    C -->|Two| E[iPhone]
+"""
+
+    png_in = (tmp_path / "diagram.png").read_bytes()
+    png_out = scrybe_mermaid.embed(png_in, source)
+    (tmp_path / "diagram-with-source.png").write_bytes(png_out)
+
+    payload = scrybe_mermaid.extract(png_out)
+    if payload.source != source:
+        raise ValueError("Round-trip mismatch")
+    print(f"Round-tripped {len(payload.source)} chars; sha256={payload.sha256[:12]}…")
+    # ─────────────────────────────────────────────────────────────────────────
+
+    assert (tmp_path / "diagram-with-source.png").exists()
+    assert payload.source == source
+    assert len(payload.sha256) == 64  # SHA-256 hex is always 64 chars

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/scrybe-render/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "scrybe-render"
-version = "0.1.1"
+version = "0.2.0"
 edition = "2021"
 description = "Scrybe render — Markdown-to-HTML pipeline, syntect, KaTeX/Mermaid"
 license = "Apache-2.0"

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/scrybe-rpc/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "scrybe-rpc"
-version = "0.1.1"
+version = "0.2.0"
 edition = "2021"
 description = "Scrybe CLI ↔ GUI wire protocol — JSON-RPC 2.0 types over a Unix socket."
 license = "Apache-2.0"

{scrybe_cli-0.1.1 → scrybe_cli-0.2.0}/scrybe-rpc/src/lib.rs

@@ -311,11 +311,21 @@ impl Response {
 /// Resolve the socket path: `$SCRYBE_SOCK` if set, otherwise `~/.scrybe/sock`.
 /// Falls back to `/tmp/.scrybe-sock` only if `$HOME` is also unset.
 pub fn default_socket_path() -> PathBuf {
-    if let Ok(s) = std::env::var("SCRYBE_SOCK") {
+    resolve_socket_path(
+        std::env::var("SCRYBE_SOCK").ok().as_deref(),
+        std::env::var("HOME").ok().as_deref(),
+    )
+}
+
+/// Pure resolution logic for [`default_socket_path`]. Split out so it can be
+/// unit-tested without mutating process-global env vars (which races across
+/// parallel tests).
+fn resolve_socket_path(sock_override: Option<&str>, home: Option<&str>) -> PathBuf {
+    if let Some(s) = sock_override {
         return PathBuf::from(s);
     }
-    if let Ok(home) = std::env::var("HOME") {
-        return PathBuf::from(home).join(".scrybe").join("sock");
+    if let Some(h) = home {
+        return PathBuf::from(h).join(".scrybe").join("sock");
     }
     PathBuf::from("/tmp/.scrybe-sock")
 }
@@ -545,32 +555,29 @@ mod tests {
     }
 
     #[test]
-    fn default_socket_path_uses_env_override() {
-        // Save and restore so the test doesn't leak.
-        let prev_sock = std::env::var("SCRYBE_SOCK").ok();
-        std::env::set_var("SCRYBE_SOCK", "/tmp/custom-scrybe-sock");
-        let p = default_socket_path();
+    fn resolve_socket_path_uses_override() {
+        let p = resolve_socket_path(Some("/tmp/custom-scrybe-sock"), Some("/home/test"));
         assert_eq!(p, PathBuf::from("/tmp/custom-scrybe-sock"));
-        match prev_sock {
-            Some(v) => std::env::set_var("SCRYBE_SOCK", v),
-            None => std::env::remove_var("SCRYBE_SOCK"),
-        }
     }
 
     #[test]
-    fn default_socket_path_uses_home() {
-        let prev_sock = std::env::var("SCRYBE_SOCK").ok();
-        std::env::remove_var("SCRYBE_SOCK");
-        let prev_home = std::env::var("HOME").ok();
-        std::env::set_var("HOME", "/home/test");
-        let p = default_socket_path();
+    fn resolve_socket_path_uses_home_when_no_override() {
+        let p = resolve_socket_path(None, Some("/home/test"));
         assert_eq!(p, PathBuf::from("/home/test/.scrybe/sock"));
-        match prev_home {
-            Some(v) => std::env::set_var("HOME", v),
-            None => std::env::remove_var("HOME"),
-        }
-        if let Some(v) = prev_sock {
-            std::env::set_var("SCRYBE_SOCK", v);
-        }
+    }
+
+    #[test]
+    fn resolve_socket_path_falls_back_when_home_unset() {
+        let p = resolve_socket_path(None, None);
+        assert_eq!(p, PathBuf::from("/tmp/.scrybe-sock"));
+    }
+
+    #[test]
+    fn default_socket_path_returns_some_path() {
+        // Smoke test: the env-reading wrapper produces *some* path. The
+        // resolution logic itself is covered by the pure-function tests above,
+        // which don't race on process-global env vars.
+        let p = default_socket_path();
+        assert!(!p.as_os_str().is_empty());
     }
 }

scrybe_cli-0.1.1/scrybe-mcp-server/scrybe_mcp_server/__init__.py

@@ -1,25 +0,0 @@
-# SPDX-License-Identifier: Apache-2.0
-"""scrybe-mcp-server — standalone Scrybe MCP server.
-
-Install: pip install scrybe-mcp-server
-Use:     python -m scrybe_mcp_server stdio
-Or:      claude mcp add scrybe -- python -m scrybe_mcp_server stdio
-"""
-__version__ = "0.5.20260506"
-
-import subprocess
-import sys
-
-
-def _run() -> None:
-    """Entry point: delegates to the compiled scrybe-mcp-server binary."""
-    import shutil
-    binary = shutil.which("scrybe-mcp-server")
-    if binary is None:
-        print("scrybe-mcp-server binary not found. Reinstall: pip install scrybe-mcp-server", file=sys.stderr)
-        sys.exit(1)
-    sys.exit(subprocess.call([binary] + sys.argv[1:]))
-
-
-if __name__ == "__main__":
-    _run()

scrybe_cli-0.1.1/scrybe-mcp-server/scrybe_mcp_server/__main__.py

@@ -1,2 +0,0 @@
-from scrybe_mcp_server import _run
-_run()