mdview-cli 1.0.0__tar.gz → 1.1.0__tar.gz

{mdview_cli-1.0.0/src/mdview_cli.egg-info → mdview_cli-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mdview-cli
-Version: 1.0.0
+Version: 1.1.0
 Summary: Iterate on Markdown and verify every revision with mdview.io
 License-Expression: MIT
 Project-URL: Homepage, https://mdview.io
@@ -81,8 +81,15 @@ When — and only when — you decide to publish, make it public; and grab a PDF
 at any point:
 
 ```bash
-mdv share spec.md     # mint the public /s/ link (from then on it follows your syncs)
-mdv export spec.md    # render the current revision to spec.pdf
+mdv share spec.md               # mint the public /s/ link (from then on it follows your syncs)
+mdv share spec.md --slug my-doc # …or with a custom /s/my-doc slug
+mdv export spec.md              # render the current revision to spec.pdf
+```
+
+Or do both steps at once — sync, auto-repair, and share in one call:
+
+```bash
+mdv publish spec.md --slug my-doc   # sync + repair + share, atomically
 ```
 
 Useful around the loop:
@@ -91,6 +98,7 @@ Useful around the loop:
 mdv sync spec.md --no-fix     # fast sync: skip auto-repair, just report failures
 mdv export spec.md --no-sync  # PDF of the last synced revision; local edits stay private
 mdv list                      # all saved documents with their URLs
+mdv status spec.md            # document ID, public state, last sync, local edits pending?
 mdv unlink spec.md            # forget the file↔document link; the document stays online
 ```
 
@@ -145,11 +153,13 @@ for reading a local file without uploading it, use `mdv open`.
 | `mdv FILE.md` / `mdv preview` | no | Publish anonymously, open the rendered page (30-day link) |
 | `mdv open` | no | Render locally in the browser; nothing is uploaded |
 | `mdv sync` | yes | Update a saved document at its private /p/ URL, verify + auto-repair |
-| `mdv share` | yes | Make a synced document public at its /s/ URL |
+| `mdv share` | yes | Make a synced document public at its /s/ URL, optionally with `--slug` |
+| `mdv publish` | yes | Sync + auto-repair + share in one call |
 | `mdv verify` | yes | Re-check rendering of a synced document |
 | `mdv fix` | yes | Repair broken Mermaid diagrams, with a local backup |
 | `mdv export` | yes | Export a synced document to PDF |
 | `mdv list` | yes | List saved documents |
+| `mdv status` | yes | Show a synced document's ID, public state, slug, and whether local edits are unsynced |
 | `mdv unlink` | no | Remove the local file↔document association |
 | `mdv keys set/list/path/unset` | — | Manage the stored CLI token |
 

{mdview_cli-1.0.0 → mdview_cli-1.1.0}/README.md

@@ -63,8 +63,15 @@ When — and only when — you decide to publish, make it public; and grab a PDF
 at any point:
 
 ```bash
-mdv share spec.md     # mint the public /s/ link (from then on it follows your syncs)
-mdv export spec.md    # render the current revision to spec.pdf
+mdv share spec.md               # mint the public /s/ link (from then on it follows your syncs)
+mdv share spec.md --slug my-doc # …or with a custom /s/my-doc slug
+mdv export spec.md              # render the current revision to spec.pdf
+```
+
+Or do both steps at once — sync, auto-repair, and share in one call:
+
+```bash
+mdv publish spec.md --slug my-doc   # sync + repair + share, atomically
 ```
 
 Useful around the loop:
@@ -73,6 +80,7 @@ Useful around the loop:
 mdv sync spec.md --no-fix     # fast sync: skip auto-repair, just report failures
 mdv export spec.md --no-sync  # PDF of the last synced revision; local edits stay private
 mdv list                      # all saved documents with their URLs
+mdv status spec.md            # document ID, public state, last sync, local edits pending?
 mdv unlink spec.md            # forget the file↔document link; the document stays online
 ```
 
@@ -127,11 +135,13 @@ for reading a local file without uploading it, use `mdv open`.
 | `mdv FILE.md` / `mdv preview` | no | Publish anonymously, open the rendered page (30-day link) |
 | `mdv open` | no | Render locally in the browser; nothing is uploaded |
 | `mdv sync` | yes | Update a saved document at its private /p/ URL, verify + auto-repair |
-| `mdv share` | yes | Make a synced document public at its /s/ URL |
+| `mdv share` | yes | Make a synced document public at its /s/ URL, optionally with `--slug` |
+| `mdv publish` | yes | Sync + auto-repair + share in one call |
 | `mdv verify` | yes | Re-check rendering of a synced document |
 | `mdv fix` | yes | Repair broken Mermaid diagrams, with a local backup |
 | `mdv export` | yes | Export a synced document to PDF |
 | `mdv list` | yes | List saved documents |
+| `mdv status` | yes | Show a synced document's ID, public state, slug, and whether local edits are unsynced |
 | `mdv unlink` | no | Remove the local file↔document association |
 | `mdv keys set/list/path/unset` | — | Manage the stored CLI token |
 

{mdview_cli-1.0.0 → mdview_cli-1.1.0}/src/mdview_cli/api.py

@@ -1,5 +1,10 @@
+import time
+
 import httpx
 
+BUSY_RETRY_ATTEMPTS = 4
+BUSY_RETRY_DELAY = 1.0
+
 
 class ApiError(RuntimeError):
     def __init__(self, message: str, status_code: int | None = None):
@@ -16,18 +21,24 @@ class MdviewApi:
         )
 
     def request(self, method: str, path: str, **kwargs):
-        try:
-            response = self.client.request(method, path, **kwargs)
-        except httpx.HTTPError as error:
-            raise ApiError(f"Could not reach mdview.io: {error}") from error
-        if response.is_error:
+        delay = BUSY_RETRY_DELAY
+        for attempt in range(BUSY_RETRY_ATTEMPTS):
             try:
-                body = response.json()
-                message = body.get("message") or body.get("error") or response.reason_phrase
-            except ValueError:
-                message = response.reason_phrase
-            raise ApiError(str(message), response.status_code)
-        return response
+                response = self.client.request(method, path, **kwargs)
+            except httpx.HTTPError as error:
+                raise ApiError(f"Could not reach mdview.io: {error}") from error
+            if response.is_error:
+                try:
+                    body = response.json()
+                    message = body.get("message") or body.get("error") or response.reason_phrase
+                except ValueError:
+                    message = response.reason_phrase
+                if "busy" in str(message).lower() and attempt < BUSY_RETRY_ATTEMPTS - 1:
+                    time.sleep(delay)
+                    delay *= 2
+                    continue
+                raise ApiError(str(message), response.status_code)
+            return response
 
     def create(self, title, content):
         return self.request("POST", "/api/documents", json={"title": title, "content": content}).json()
@@ -44,6 +55,9 @@ class MdviewApi:
     def share(self, document_id):
         return self.request("POST", f"/api/documents/{document_id}/share", json={}).json()
 
+    def set_slug(self, document_id, slug):
+        return self.request("PATCH", f"/api/documents/{document_id}/share/slug", json={"slug": slug}).json()
+
     def verify(self, document_id, status=False):
         suffix = "/status" if status else ""
         return self.request("GET", f"/api/documents/{document_id}/verify{suffix}").json()

{mdview_cli-1.0.0 → mdview_cli-1.1.0}/src/mdview_cli/cli.py

@@ -1,5 +1,6 @@
 import base64
 import functools
+import hashlib
 import io
 import json
 import os
@@ -67,6 +68,10 @@ def share_url(share):
     return f"{base_url()}/s/{share}"
 
 
+def content_hash(markdown: str) -> str:
+    return hashlib.sha256(markdown.encode("utf-8")).hexdigest()
+
+
 def verdict(report) -> bool:
     if "renderable" in report:
         return bool(report["renderable"])
@@ -112,7 +117,7 @@ def print_result(payload, as_json=False, *, check=True):
         raise click.exceptions.Exit(1)
 
 
-def sync_file(path: Path, *, api=None, state=None, title=None, document_id=None, share=False, verify=True):
+def sync_file(path: Path, *, api=None, state=None, title=None, document_id=None, share=False, slug=None, verify=True):
     if not path.is_file():
         raise click.UsageError(f"File not found: {path}")
     markdown = path.read_text(encoding="utf-8")
@@ -128,21 +133,25 @@ def sync_file(path: Path, *, api=None, state=None, title=None, document_id=None,
         created_body = api.create(doc_title, markdown)
         document_id = created_body["id"]
         updated_at = created_body.get("updated_at")
+        existing_share = existing_share or share_id(created_body)
     else:
         try:
             updated = api.update(document_id, doc_title, markdown, updated_at)
             updated_at = updated.get("updated_at")
+            existing_share = existing_share or share_id(updated)
         except ApiError as error:
             if error.status_code != 404 or document_id != (association and association["document_id"]):
                 raise
             created_body = api.create(doc_title, markdown)
             document_id = created_body["id"]
             updated_at = created_body.get("updated_at")
-            existing_share = None
+            existing_share = share_id(created_body)
             created = True
     if share and not existing_share:
         existing_share = share_id(api.share(document_id))
-    state.put(base_url(), path, document_id, existing_share, updated_at)
+    if slug and existing_share and slug != existing_share:
+        existing_share = share_id(api.set_slug(document_id, slug)) or slug
+    state.put(base_url(), path, document_id, existing_share, updated_at, content_hash(markdown))
     report = api.verify(document_id) if verify else {"renderable": True, "diagrams": {}, "tables": {}}
     return result_payload(document_id, existing_share, report, created)
 
@@ -201,14 +210,14 @@ def keys_list():
     click.echo("default" if get_token() else "No token configured.")
 
 
-def repair_synced_file(file, api, state, document_id):
+def repair_synced_file(file, api, state, document_id, *, share=False, slug=None):
     repaired = api.fix(document_id)
     markdown = repaired.get("markdown")
     if markdown is None:
         raise ServiceError("The repair response did not include Markdown.")
     backup = backup_file(file, document_id)
     atomic_write(file, markdown)
-    payload = sync_file(file, api=api, state=state)
+    payload = sync_file(file, api=api, state=state, share=share, slug=slug)
     payload["backup"] = str(backup)
     payload["fixed"] = repaired.get("diagrams", {}).get("fixed", 0)
     return payload
@@ -234,21 +243,51 @@ def sync_command(file, no_fix, title, document_id, as_json):
     print_result(payload, as_json)
 
 
+@cli.command("publish")
+@click.argument("file", type=click.Path(path_type=Path))
+@click.option("--title")
+@click.option("--slug", help="Set a custom share slug, e.g. /s/SLUG.")
+@click.option("--id", "document_id")
+@click.option("--no-fix", "no_fix", is_flag=True, help="Skip auto-repair; just report failing diagrams.")
+@click.option("--json", "as_json", is_flag=True)
+@service_errors
+def publish_command(file, title, slug, document_id, no_fix, as_json):
+    """Sync FILE, repair broken diagrams, and make it public in one step."""
+    api = api_for_token()
+    state = DocumentState()
+    payload = sync_file(file, api=api, state=state, title=title, document_id=document_id, share=True, slug=slug)
+    if not payload["renderable"] and not no_fix:
+        try:
+            payload = repair_synced_file(file, api, state, payload["document_id"], share=True, slug=slug)
+        except ApiError as error:
+            click.secho(f"Auto-repair unavailable: {error}", fg="yellow", err=True)
+    print_result(payload, as_json)
+
+
 @cli.command("share")
 @click.argument("file", required=False, type=click.Path(path_type=Path))
 @click.option("--id", "document_id")
+@click.option("--slug", help="Set a custom share slug, e.g. /s/SLUG.")
+@click.option("--json", "as_json", is_flag=True)
 @service_errors
-def share_command(file, document_id):
+def share_command(file, document_id, slug, as_json):
     """Make FILE's document public and print its share URL."""
     state = DocumentState()
     association = state.get(base_url(), file) if file else None
     document_id = document_id or (association and association["document_id"])
     if not document_id:
         raise click.UsageError("Provide a synced FILE or --id.")
-    sid = share_id(api_for_token().share(document_id))
+    api = api_for_token()
+    sid = share_id(api.share(document_id))
+    if slug and slug != sid:
+        sid = share_id(api.set_slug(document_id, slug)) or slug
     if file:
         state.put(base_url(), file, document_id, sid, None)
-    click.echo(share_url(sid))
+    url = share_url(sid)
+    if as_json:
+        click.echo(json.dumps({"document_id": document_id, "slug": sid, "share_url": url}, separators=(",", ":")))
+    else:
+        click.echo(url)
 
 
 @cli.command("verify")
@@ -365,6 +404,55 @@ def unlink_command(file):
     click.echo("Association removed; remote document was not deleted." if removed else "No association found.")
 
 
+@cli.command("status")
+@click.argument("file", type=click.Path(path_type=Path))
+@click.option("--json", "as_json", is_flag=True)
+@service_errors
+def status_command(file, as_json):
+    """Show FILE's linked document, public state, and whether it has unsynced local changes."""
+    state = DocumentState()
+    association = state.get(base_url(), file)
+    if not association:
+        if as_json:
+            click.echo(json.dumps({"file": str(file), "linked": False}, separators=(",", ":")))
+        else:
+            click.echo(f"{file}: not linked. Run 'mdv sync {file}' to create an association.")
+        return
+    document_id = association["document_id"]
+    documents = api_for_token().documents()
+    remote = next((doc for doc in documents if doc.get("id") == document_id), None)
+    sid = share_id(remote) if remote else association["share_id"]
+    if remote and sid != association["share_id"]:
+        state.put(base_url(), file, document_id, sid, association["updated_at"])
+    local_hash = content_hash(file.read_text(encoding="utf-8")) if file.is_file() else None
+    dirty = bool(local_hash and association["content_hash"] and local_hash != association["content_hash"])
+    payload = {
+        "file": str(file),
+        "linked": True,
+        "document_id": document_id,
+        "url": f"{base_url()}/p/{document_id}",
+        "published": bool(sid),
+        "slug": sid,
+        "share_url": share_url(sid) if sid else None,
+        "last_synced": association["updated_at"],
+        "dirty": dirty,
+        "found_remote": remote is not None,
+    }
+    if as_json:
+        click.echo(json.dumps(payload, separators=(",", ":")))
+        return
+    click.echo(f"Document: {payload['document_id']}")
+    click.echo(f"Private: {payload['url']}")
+    click.echo(f"Share: {payload['share_url']}" if payload["share_url"] else "Public: no")
+    click.echo(f"Last synced: {payload['last_synced'] or 'unknown'}")
+    if not payload["found_remote"]:
+        click.secho("Warning: document not found in account's document list.", fg="yellow", err=True)
+    if dirty:
+        click.secho("Local file has changes not yet synced.", fg="yellow")
+    elif local_hash is not None:
+        click.echo("Local file matches last synced version.")
+
+
 @cli.command("preview")
 @click.argument("file", type=click.Path(exists=True, dir_okay=False, path_type=Path))
 @click.option("--title")

{mdview_cli-1.0.0 → mdview_cli-1.1.0}/src/mdview_cli/state.py

@@ -19,6 +19,10 @@ class DocumentState:
                 PRIMARY KEY (server, path)
             )"""
         )
+        columns = [row[1] for row in self.connection.execute("PRAGMA table_info(associations)")]
+        if "content_hash" not in columns:
+            self.connection.execute("ALTER TABLE associations ADD COLUMN content_hash TEXT")
+            self.connection.commit()
 
     @staticmethod
     def canonical(path: Path) -> str:
@@ -26,22 +30,23 @@ class DocumentState:
 
     def get(self, server: str, path: Path):
         row = self.connection.execute(
-            "SELECT document_id, share_id, updated_at FROM associations WHERE server = ? AND path = ?",
+            "SELECT document_id, share_id, updated_at, content_hash FROM associations WHERE server = ? AND path = ?",
             (server, self.canonical(path)),
         ).fetchone()
         if not row:
             return None
-        return {"document_id": row[0], "share_id": row[1], "updated_at": row[2]}
+        return {"document_id": row[0], "share_id": row[1], "updated_at": row[2], "content_hash": row[3]}
 
-    def put(self, server: str, path: Path, document_id: str, share_id=None, updated_at=None):
+    def put(self, server: str, path: Path, document_id: str, share_id=None, updated_at=None, content_hash=None):
         self.connection.execute(
-            """INSERT INTO associations (server, path, document_id, share_id, updated_at)
-               VALUES (?, ?, ?, ?, ?)
+            """INSERT INTO associations (server, path, document_id, share_id, updated_at, content_hash)
+               VALUES (?, ?, ?, ?, ?, ?)
                ON CONFLICT(server, path) DO UPDATE SET
                  document_id=excluded.document_id,
                  share_id=COALESCE(excluded.share_id, associations.share_id),
-                 updated_at=COALESCE(excluded.updated_at, associations.updated_at)""",
-            (server, self.canonical(path), document_id, share_id, updated_at),
+                 updated_at=COALESCE(excluded.updated_at, associations.updated_at),
+                 content_hash=COALESCE(excluded.content_hash, associations.content_hash)""",
+            (server, self.canonical(path), document_id, share_id, updated_at, content_hash),
         )
         self.connection.commit()
 

{mdview_cli-1.0.0 → mdview_cli-1.1.0/src/mdview_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mdview-cli
-Version: 1.0.0
+Version: 1.1.0
 Summary: Iterate on Markdown and verify every revision with mdview.io
 License-Expression: MIT
 Project-URL: Homepage, https://mdview.io
@@ -81,8 +81,15 @@ When — and only when — you decide to publish, make it public; and grab a PDF
 at any point:
 
 ```bash
-mdv share spec.md     # mint the public /s/ link (from then on it follows your syncs)
-mdv export spec.md    # render the current revision to spec.pdf
+mdv share spec.md               # mint the public /s/ link (from then on it follows your syncs)
+mdv share spec.md --slug my-doc # …or with a custom /s/my-doc slug
+mdv export spec.md              # render the current revision to spec.pdf
+```
+
+Or do both steps at once — sync, auto-repair, and share in one call:
+
+```bash
+mdv publish spec.md --slug my-doc   # sync + repair + share, atomically
 ```
 
 Useful around the loop:
@@ -91,6 +98,7 @@ Useful around the loop:
 mdv sync spec.md --no-fix     # fast sync: skip auto-repair, just report failures
 mdv export spec.md --no-sync  # PDF of the last synced revision; local edits stay private
 mdv list                      # all saved documents with their URLs
+mdv status spec.md            # document ID, public state, last sync, local edits pending?
 mdv unlink spec.md            # forget the file↔document link; the document stays online
 ```
 
@@ -145,11 +153,13 @@ for reading a local file without uploading it, use `mdv open`.
 | `mdv FILE.md` / `mdv preview` | no | Publish anonymously, open the rendered page (30-day link) |
 | `mdv open` | no | Render locally in the browser; nothing is uploaded |
 | `mdv sync` | yes | Update a saved document at its private /p/ URL, verify + auto-repair |
-| `mdv share` | yes | Make a synced document public at its /s/ URL |
+| `mdv share` | yes | Make a synced document public at its /s/ URL, optionally with `--slug` |
+| `mdv publish` | yes | Sync + auto-repair + share in one call |
 | `mdv verify` | yes | Re-check rendering of a synced document |
 | `mdv fix` | yes | Repair broken Mermaid diagrams, with a local backup |
 | `mdv export` | yes | Export a synced document to PDF |
 | `mdv list` | yes | List saved documents |
+| `mdv status` | yes | Show a synced document's ID, public state, slug, and whether local edits are unsynced |
 | `mdv unlink` | no | Remove the local file↔document association |
 | `mdv keys set/list/path/unset` | — | Manage the stored CLI token |
 

{mdview_cli-1.0.0 → mdview_cli-1.1.0}/src/mdview_cli.egg-info/SOURCES.txt

@@ -16,5 +16,6 @@ src/mdview_cli.egg-info/requires.txt
 src/mdview_cli.egg-info/scm_file_list.json
 src/mdview_cli.egg-info/scm_version.json
 src/mdview_cli.egg-info/top_level.txt
+tests/test_api.py
 tests/test_cli.py
 tests/e2e/test_free_tools.py

{mdview_cli-1.0.0 → mdview_cli-1.1.0}/src/mdview_cli.egg-info/scm_file_list.json

@@ -1,16 +1,17 @@
 {
   "files": [
-    ".gitignore",
-    "README.md",
     "pyproject.toml",
     "LICENSE",
-    "src/mdview_cli/api.py",
+    "README.md",
+    ".gitignore",
+    ".github/workflows/release.yml",
+    "tests/test_api.py",
+    "tests/test_cli.py",
+    "tests/e2e/test_free_tools.py",
     "src/mdview_cli/state.py",
     "src/mdview_cli/config.py",
-    "src/mdview_cli/cli.py",
     "src/mdview_cli/__init__.py",
-    ".github/workflows/release.yml",
-    "tests/test_cli.py",
-    "tests/e2e/test_free_tools.py"
+    "src/mdview_cli/cli.py",
+    "src/mdview_cli/api.py"
   ]
 }

mdview_cli-1.1.0/src/mdview_cli.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "1.1.0",
+  "distance": 0,
+  "node": "gdb3fffae21c71c4d9c01e14eb7aa3823f6bbf9e6",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-07-22"
+}

mdview_cli-1.1.0/tests/test_api.py

@@ -0,0 +1,61 @@
+import pytest
+
+from mdview_cli.api import ApiError, MdviewApi
+
+
+class FakeResponse:
+    def __init__(self, status_code, body):
+        self.status_code = status_code
+        self.is_error = status_code >= 400
+        self._body = body
+        self.reason_phrase = "error"
+
+    def json(self):
+        return self._body
+
+
+def make_api(monkeypatch, responses):
+    api = MdviewApi("https://mdview.io", token="mdv1_test")
+    calls = []
+
+    def fake_request(method, path, **kwargs):
+        calls.append((method, path))
+        return responses[len(calls) - 1]
+
+    monkeypatch.setattr(api.client, "request", fake_request)
+    monkeypatch.setattr("mdview_cli.api.time.sleep", lambda seconds: None)
+    return api, calls
+
+
+def test_retries_on_busy_then_succeeds(monkeypatch):
+    responses = [
+        FakeResponse(409, {"error": "export_busy"}),
+        FakeResponse(409, {"error": "export_busy"}),
+        FakeResponse(200, {"ok": True}),
+    ]
+    api, calls = make_api(monkeypatch, responses)
+
+    result = api.request("GET", "/api/documents/doc123/export/pdf")
+
+    assert result.json() == {"ok": True}
+    assert len(calls) == 3
+
+
+def test_gives_up_after_bounded_retries(monkeypatch):
+    responses = [FakeResponse(409, {"error": "export_busy"}) for _ in range(10)]
+    api, calls = make_api(monkeypatch, responses)
+
+    with pytest.raises(ApiError, match="export_busy"):
+        api.request("GET", "/api/documents/doc123/export/pdf")
+
+    assert len(calls) == 4
+
+
+def test_does_not_retry_non_busy_errors(monkeypatch):
+    responses = [FakeResponse(404, {"error": "not_found"})]
+    api, calls = make_api(monkeypatch, responses)
+
+    with pytest.raises(ApiError, match="not_found"):
+        api.request("GET", "/api/documents/doc123")
+
+    assert len(calls) == 1

{mdview_cli-1.0.0 → mdview_cli-1.1.0}/tests/test_cli.py

@@ -15,6 +15,7 @@ class FakeApi:
         self.verified = 0
         self.shared = 0
         self.missing_on_update = False
+        self.slug_calls = []
 
     def create(self, title, content):
         self.created += 1
@@ -31,6 +32,13 @@ class FakeApi:
         self.shared += 1
         return {"shortId": "share123"}
 
+    def set_slug(self, document_id, slug):
+        self.slug_calls.append((document_id, slug))
+        return {"customSlug": slug}
+
+    def documents(self):
+        return [{"id": "doc123", "title": "Doc", "customSlug": "share123"}]
+
     def verify(self, document_id, status=False):
         self.verified += 1
         return {
@@ -266,6 +274,86 @@ def test_fix_local_rewrites_file_without_syncing(monkeypatch, tmp_path):
     assert api.verified == 0
 
 
+def test_share_accepts_custom_slug_and_json(monkeypatch, tmp_path):
+    api = FakeApi()
+    configure(monkeypatch, tmp_path, api)
+    document = tmp_path / "doc.md"
+    document.write_text("# Doc\n", encoding="utf-8")
+    runner = CliRunner()
+    assert runner.invoke(cli, ["sync", str(document)]).exit_code == 0
+
+    result = runner.invoke(cli, ["share", str(document), "--slug", "my-slug", "--json"])
+
+    assert result.exit_code == 0
+    payload = json.loads(result.output)
+    assert payload["slug"] == "my-slug"
+    assert payload["share_url"] == "https://mdview.io/s/my-slug"
+    assert api.slug_calls == [("doc123", "my-slug")]
+
+
+def test_publish_syncs_and_shares_with_slug_in_one_step(monkeypatch, tmp_path):
+    api = FakeApi()
+    configure(monkeypatch, tmp_path, api)
+    document = tmp_path / "doc.md"
+    document.write_text("# Doc\n", encoding="utf-8")
+
+    result = CliRunner().invoke(cli, ["publish", str(document), "--slug", "my-slug", "--json"])
+
+    assert result.exit_code == 0
+    payload = json.loads(result.output)
+    assert payload["share_url"] == "https://mdview.io/s/my-slug"
+    assert api.created == 1
+    assert api.shared == 1
+    assert api.slug_calls == [("doc123", "my-slug")]
+
+
+def test_publish_repairs_broken_diagrams_before_sharing(monkeypatch, tmp_path):
+    api = FakeApi(renderable=False)
+    configure(monkeypatch, tmp_path, api)
+    document = tmp_path / "broken.md"
+    document.write_text("# Broken\n\n```mermaid\nnope\n```\n", encoding="utf-8")
+
+    result = CliRunner().invoke(cli, ["publish", str(document), "--json"])
+
+    assert result.exit_code == 0
+    payload = json.loads(result.output)
+    assert payload["renderable"] is True
+    assert payload["share_url"] == "https://mdview.io/s/share123"
+    assert document.read_text(encoding="utf-8").startswith("# Fixed")
+
+
+def test_status_reports_unlinked_file(monkeypatch, tmp_path):
+    api = FakeApi()
+    configure(monkeypatch, tmp_path, api)
+    document = tmp_path / "doc.md"
+    document.write_text("# Doc\n", encoding="utf-8")
+
+    result = CliRunner().invoke(cli, ["status", str(document), "--json"])
+
+    assert result.exit_code == 0
+    assert json.loads(result.output) == {"file": str(document), "linked": False}
+
+
+def test_status_reconciles_share_state_from_server_and_detects_dirty_file(monkeypatch, tmp_path):
+    api = FakeApi()
+    configure(monkeypatch, tmp_path, api)
+    document = tmp_path / "doc.md"
+    document.write_text("# Doc\n", encoding="utf-8")
+    runner = CliRunner()
+    assert runner.invoke(cli, ["sync", str(document)]).exit_code == 0
+
+    clean = runner.invoke(cli, ["status", str(document), "--json"])
+    document.write_text("# Doc\n\nEdited locally.\n", encoding="utf-8")
+    dirty = runner.invoke(cli, ["status", str(document), "--json"])
+
+    clean_payload = json.loads(clean.output)
+    dirty_payload = json.loads(dirty.output)
+    assert clean_payload["published"] is True
+    assert clean_payload["share_url"] == "https://mdview.io/s/share123"
+    assert clean_payload["dirty"] is False
+    assert dirty_payload["dirty"] is True
+
+
 def test_fix_backs_up_rewrites_resyncs_and_verifies(monkeypatch, tmp_path):
     api = FakeApi(renderable=False)
     configure(monkeypatch, tmp_path, api)

mdview_cli-1.0.0/src/mdview_cli.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "1.0.0",
-  "distance": 0,
-  "node": "g3c5d7f760b99e8bc0a5b93e1cf747fd01ac52421",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-07-18"
-}