docmost-cli 0.4.0__tar.gz → 0.6.0__tar.gz

{docmost_cli-0.4.0 → docmost_cli-0.6.0}/.claude/skills/docmost/SKILL.md

@@ -96,19 +96,33 @@ docmost-cli page export <page-id> --format md
 
 1. Get current content: `docmost-cli page get <page-id>`
 2. Modify the Markdown content as needed
-3. Update: `docmost-cli page update <page-id> --title "Updated Title"`
-4. Note: Content update via REST may not be available on Community edition
+3. Update: `docmost-cli page update <page-id> --file updated.md`
+4. Content updates are applied in place — the page keeps its ID, slug, history
+   and inbound links. Works on Community and Enterprise alike, from Docmost
+   v0.71. Use `--append` / `--prepend` to add without replacing.
 
 ## Output Format
 
 - **Content commands** (`page get`): Raw Markdown to stdout — directly usable
-- **List commands** (`--json`): JSON array — parse with standard JSON tools
+- **List commands** (`--json`): JSON array of **complete server objects** — every
+  field the API returned, not a subset. For pages that means `id`, `slugId`,
+  `title`, `icon`, `position`, `parentPageId`, `spaceId`, `creatorId`,
+  `lastUpdatedById`, `isLocked`, `createdAt`, `updatedAt` and more. Page
+  *content* is not included; fetch it with `page get <id>`.
+  Pagination is followed automatically, so the array is complete; add
+  `--envelope` if you need `hasNextPage` / `nextCursor`
+- **Narrow the output** with `--fields id,title,updatedAt` when you only need a
+  few keys — worth doing to keep context small, since `--json` is now much
+  larger. It works in JSON and table mode, and an unknown name errors with the
+  list of fields the server actually returned
+- **Single-item commands** (`user me`, `workspace info`): add `--json` for the
+  complete object
 - **Write commands** (`page create`, `delete`): Page ID to stdout, confirmation to stderr
 - **Always use `--json`** for list/search commands when you need to parse the output programmatically
 
 ## Tips
 
-- Use `--json` flag on list commands to get parseable output
+- Use `--json` on list commands to get parseable output, plus `--fields` to keep it small
 - Page IDs are UUIDs like `019a2a69-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
 - Space slugs are lowercase alphanumeric (e.g., `engineering`, `devtest`)
 - Use `-y` flag to skip confirmation prompts for automated workflows

docmost_cli-0.6.0/.github/workflows/ci.yml

@@ -0,0 +1,139 @@
+name: CI
+
+# Uses only first-party actions, and installs with pip rather than uv. The
+# project prefers uv locally (see CLAUDE.md), but this runner could not resolve
+# `astral-sh/setup-uv@v9` at all, and pip is the documented fallback — a CI file
+# that reliably runs beats a marginally faster one.
+#
+# Pins are the current majors, which target Node 24. Node 20 is deprecated and
+# is being force-migrated on the runners, so checkout@v4 / setup-python@v5 would
+# have had a shelf life.
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: test (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      # Report every interpreter, rather than hiding 3.13 behind a 3.11 failure.
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Verify the interpreter matches the matrix
+        # Without this, a misconfigured setup step would silently run every
+        # matrix entry on the runner's default Python and report three passes
+        # for one version.
+        run: |
+          python - <<'PY'
+          import sys
+          actual = "{}.{}".format(*sys.version_info[:2])
+          expected = "${{ matrix.python-version }}"
+          assert actual == expected, f"expected Python {expected}, got {actual}"
+          print("Python", sys.version)
+          PY
+
+      - name: Test
+        run: python -m pytest tests/ -q
+
+  quality:
+    name: lint and type-check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Ruff lint
+        run: python -m ruff check src/ tests/
+
+      - name: Ruff format
+        run: python -m ruff format --check src/ tests/
+
+      # Runs once, not per matrix entry: pyproject pins mypy's
+      # python_version = "3.11", so the result is interpreter-independent.
+      - name: Mypy (strict)
+        run: python -m mypy src/
+
+  build:
+    name: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Verify the built version matches __version__
+        # The version is dynamic: hatch reads it out of src/docmost_cli/__init__.py.
+        # If that regex ever stops matching, the build silently produces the wrong
+        # version rather than failing.
+        run: |
+          python - <<'PY'
+          import pathlib, re
+
+          source = pathlib.Path("src/docmost_cli/__init__.py").read_text()
+          match = re.search(r'__version__ = "([^"]+)"', source)
+          assert match, "no __version__ in src/docmost_cli/__init__.py"
+          expected = match.group(1)
+
+          built = sorted(p.name for p in pathlib.Path("dist").glob("*.whl"))
+          assert built, "no wheel produced"
+          assert any(f"-{expected}-" in name for name in built), (
+              f"__version__ is {expected} but built {built}"
+          )
+          print(f"version {expected} OK: {built}")
+          PY
+
+      - name: Verify the man pages ship in the wheel
+        # They are installed via [tool.hatch.build.targets.wheel.shared-data],
+        # which breaks quietly if the path ever moves.
+        run: |
+          python - <<'PY'
+          import pathlib, zipfile
+
+          wheel = next(iter(pathlib.Path("dist").glob("*.whl")))
+          names = zipfile.ZipFile(wheel).namelist()
+          pages = [n for n in names if n.endswith(".1") and "share/man/man1" in n]
+          assert len(pages) == 10, f"expected 10 man pages in the wheel, found {len(pages)}"
+          print(f"{len(pages)} man pages OK")
+          PY

docmost_cli-0.6.0/.github/workflows/release.yml

@@ -0,0 +1,224 @@
+name: Release
+
+# Publishes to PyPI and cuts a GitHub Release when a v* tag is pushed.
+#
+# Authentication is PyPI Trusted Publishing (OIDC) — no API token is stored in
+# this repository. One-time setup on pypi.org, under the project's
+# "Publishing" settings, add a trusted publisher:
+#
+#     Owner:            glinhard
+#     Repository:       docmost-cli
+#     Workflow name:    release.yml
+#     Environment:      pypi
+#
+# Dry runs: trigger this workflow manually (Actions -> Release -> Run workflow)
+# to exercise the whole chain — version guard, build, artifact checks, and
+# action resolution — without uploading anything anywhere.
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+    inputs:
+      dry-run:
+        description: "Build and verify only; do not publish"
+        type: boolean
+        default: true
+
+permissions:
+  contents: read
+
+jobs:
+  verify:
+    name: verify and build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip build twine
+          python -m pip install -e ".[dev]"
+
+      - name: Full test suite
+        # The tag is the last chance to catch a regression before it is
+        # published immutably: PyPI does not allow re-uploading a version.
+        run: python -m pytest tests/ -q
+
+      - name: Verify the tag matches __version__
+        if: startsWith(github.ref, 'refs/tags/')
+        run: |
+          python - <<'PY'
+          import os, pathlib, re
+
+          source = pathlib.Path("src/docmost_cli/__init__.py").read_text()
+          version = re.search(r'__version__ = "([^"]+)"', source).group(1)
+          tag = os.environ["GITHUB_REF_NAME"]
+          assert tag == f"v{version}", f"tag {tag} does not match __version__ {version}"
+          print(f"tag {tag} matches __version__ {version}")
+          PY
+
+      - name: Verify this version is not already on PyPI
+        # PyPI rejects a duplicate upload anyway; failing here gives a clearer
+        # message than a 400 from the publish step.
+        run: |
+          python - <<'PY'
+          import json, pathlib, re, urllib.request
+
+          source = pathlib.Path("src/docmost_cli/__init__.py").read_text()
+          version = re.search(r'__version__ = "([^"]+)"', source).group(1)
+          try:
+              with urllib.request.urlopen(
+                  "https://pypi.org/pypi/docmost-cli/json", timeout=30
+              ) as response:
+                  released = set(json.load(response)["releases"])
+          except Exception as exc:  # noqa: BLE001 - never block a release on this
+              print(f"could not reach PyPI ({exc}); skipping the duplicate check")
+          else:
+              assert version not in released, (
+                  f"{version} is already on PyPI; bump __version__ before tagging"
+              )
+              print(f"{version} is not yet on PyPI (has {sorted(released)})")
+          PY
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Check the distributions
+        run: python -m twine check dist/*
+
+      - name: Verify the wheel contents
+        run: |
+          python - <<'PY'
+          import pathlib, re, zipfile
+
+          source = pathlib.Path("src/docmost_cli/__init__.py").read_text()
+          version = re.search(r'__version__ = "([^"]+)"', source).group(1)
+
+          wheel = next(iter(pathlib.Path("dist").glob("*.whl")))
+          assert f"-{version}-" in wheel.name, f"built {wheel.name}, expected {version}"
+
+          names = zipfile.ZipFile(wheel).namelist()
+          pages = [n for n in names if n.endswith(".1") and "share/man/man1" in n]
+          assert len(pages) == 10, f"expected 10 man pages, found {len(pages)}"
+
+          metadata = next(n for n in names if n.endswith("METADATA"))
+          text = zipfile.ZipFile(wheel).read(metadata).decode()
+          assert "License-Expression: AGPL-3.0-or-later" in text, "missing licence expression"
+          assert "Classifier: License ::" not in text, (
+              "deprecated License :: classifier is back; PEP 639 replaces it "
+              "with the license expression"
+          )
+          print(f"{wheel.name}: {len(pages)} man pages, licence metadata OK")
+          PY
+
+      # upload@v7 and download@v8 are a matched pair: v7 uploads files directly
+      # instead of zipping them, and v8 is the major that stopped trying to
+      # un-zip a download that was never a zip. Bump them together.
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: publish to PyPI
+    needs: verify
+    runs-on: ubuntu-latest
+    # The job itself also runs on a manual dispatch, so a dry run resolves and
+    # downloads every action here — including the third-party publish action.
+    # That matters: `astral-sh/setup-uv` turned out not to resolve on these
+    # runners at all, and a release is the worst moment to discover that.
+    environment:
+      name: pypi
+      url: https://pypi.org/project/docmost-cli/
+    permissions:
+      id-token: write # required for Trusted Publishing
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish
+        # Uploading is gated on the ref being a tag, not on the dry-run input.
+        # A dispatch always runs against a branch, so no manual invocation can
+        # publish, whatever inputs it is given.
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Dry run summary
+        if: ${{ !startsWith(github.ref, 'refs/tags/') }}
+        run: |
+          echo "Dry run: actions resolved and artifacts built, nothing published."
+          echo "Push a v* tag to publish for real."
+          ls -l dist/
+
+  github-release:
+    name: GitHub Release
+    needs: publish
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    permissions:
+      contents: write # required to create the release
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+
+      - name: Extract this version's CHANGELOG section
+        run: |
+          python - <<'PY'
+          import os, pathlib, re
+
+          version = os.environ["GITHUB_REF_NAME"].removeprefix("v")
+          changelog = pathlib.Path("CHANGELOG.md").read_text()
+          # Everything from this version's heading up to the next "## " heading.
+          match = re.search(
+              rf"^## {re.escape(version)}.*?$(.*?)(?=^## )",
+              changelog,
+              re.MULTILINE | re.DOTALL,
+          )
+          body = match.group(1).strip() if match else f"See CHANGELOG.md for {version}."
+          pathlib.Path("release-notes.md").write_text(body + "\n")
+          print(body[:500])
+          PY
+
+      - name: Create or update the release
+        # The tag can arrive two ways: `git push origin v0.6.0`, or the GitHub
+        # web UI's "Draft a new release" flow, which creates the tag *and* the
+        # release before this job runs. Handle both, so neither route ends in a
+        # red job.
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+          tag="$GITHUB_REF_NAME"
+
+          if gh release view "$tag" >/dev/null 2>&1; then
+            echo "Release $tag already exists; attaching artifacts."
+            gh release upload "$tag" dist/* --clobber
+
+            # Only fill in notes if whoever created it left them empty —
+            # never overwrite notes a human wrote by hand.
+            if [ -z "$(gh release view "$tag" --json body --jq '.body' | tr -d '[:space:]')" ]; then
+              echo "Release body is empty; filling it from CHANGELOG.md."
+              gh release edit "$tag" --notes-file release-notes.md
+            else
+              echo "Release already has notes; leaving them alone."
+            fi
+          else
+            echo "Creating release $tag."
+            gh release create "$tag" \
+              --title "$tag" \
+              --notes-file release-notes.md \
+              dist/*
+          fi

docmost_cli-0.6.0/CHANGELOG.md

@@ -0,0 +1,249 @@
+# Changelog
+
+## 0.6.0 (2026-07-27)
+
+### Behavior changes
+
+- **`--json` on list commands is now lossless.** It used to project each item
+  onto the same hardcoded column list the Rich table uses, silently discarding
+  every other field the server returned — `page list --json` dropped `slugId`,
+  `spaceId`, `creatorId`, `lastUpdatedById`, `position`, `isLocked`,
+  `createdAt` and `contributorIds`. Each element is now the complete server
+  object. The table is unchanged: its column list was always a display choice.
+  Page *content* is not part of the list payload (Docmost omits it from
+  `baseFields`), so listings stay small.
+- **`--json` no longer invents keys.** A column the server omitted used to be
+  emitted as `null`; a missing field is now simply absent. An explicitly named
+  `--fields` entry still yields `null`, which keeps projections rectangular.
+- `page list --tree --json` and flat `--json` now agree on shape — the tree path
+  already emitted complete objects.
+- `page list --tree` now actually rejects `--page-size`, which its own error
+  message has claimed since 0.5.0 while never checking it.
+- Table cells render `None` as blank instead of the literal string `None`
+  (visible in `page list`'s `parentPageId` column for every root page).
+- `config show --json` emits `no_session_cache` as a real JSON boolean. The
+  table still shows it.
+
+### Added
+
+- `--fields a,b,c` on all eight list commands: projects the JSON output *and*
+  replaces the table's columns, so the table is configurable for the first time.
+  Names are validated against the fields the server actually returned — an
+  unknown name is a usage error listing what is available, because a typo would
+  otherwise yield a silent full-length column of nulls.
+- `--fields` under `page list --tree --json`, projecting every node recursively
+  while always preserving the nested `children` array. It requires `--json`,
+  since the indented tree view has no columns to replace.
+- `--json` on `workspace info`, `user me` and `config show`, which previously had
+  no machine-readable output at all. The first two emit the complete server
+  object and also accept `--fields`. `config show --json` masks `api_key` and
+  `password` exactly as the table does.
+- `print_json()` in `output/`, now the single JSON writer — `page list --tree
+  --json` and `page get --raw` route through it, which also gives `--raw` the
+  `default=str` fallback it was missing.
+- `emit_item()` in `cli/_list_opts.py`, the single-item mirror of `emit_list()`.
+
+### Fixed
+
+- `mypy src/` is clean under `strict = true`; it had been carrying 23 errors.
+  Two were real defects rather than annotation noise: `extract_id()` was declared
+  `-> str` but returned whatever the server put in `"id"`, so a numeric id would
+  have propagated a non-string page ID into request bodies; and `_node_heading()`
+  computed `"#" * level` from an unvalidated nested `.get()`, so a ProseMirror
+  document with a string or null heading level raised `TypeError` mid-render.
+- `config show` masking is now produced in exactly one place, so no future
+  renderer can add a path that forgets to mask.
+
+### Changed
+
+- `print_table()` gained a keyword-only `fields` argument; `columns` no longer
+  affects JSON output.
+- Corrected `SPECIFICATION.md` §7.2, whose sample payload showed a projected
+  three-key object and documented a field named `updated` that has never existed
+  (the code emits `updatedAt`), and its stale `print_table` signature.
+- Removed two README rows for things that were never implemented: a
+  `space get` command and a `space list --detail` flag. Corrected `search` to
+  `search query`.
+
+## 0.5.0 (2026-07-26)
+
+Fixes six gaps reported against Docmost Community 0.95, verified against the
+upstream v0.95.0 server source.
+
+### Behavior changes
+
+- **List commands now return every result.** Pagination is followed
+  automatically instead of stopping at the server's first page. `--limit` is now
+  a cap on the *total* across pages rather than a per-request limit, so
+  `--limit 200` fetches two pages of 100 instead of failing with HTTP 400.
+- **`sync push` no longer recreates pages silently.** On a server too old to
+  update content in place it aborts with an explanation; pass `--allow-recreate`
+  to opt into the old delete+recreate behavior, which prints a warning naming the
+  affected page count.
+- **`page move --position` takes `first`, `last`, or an ordering key** instead of
+  an integer, and defaults to `first`. `POSITION_FIRST` (`"aaaaa"`) is gone — it
+  never meant "first" anyway: in ASCII `'a' > '0'`, so it sorted *after* every key
+  Docmost's own generator produces.
+- `move_page()`'s `position` argument is now required (the server requires it).
+
+### Fixed
+
+- **Pagination metadata was silently discarded.** `get_cursor()` looked for
+  `data.cursor`, but Docmost returns `data.meta.nextCursor`, so it returned `None`
+  every time — which is why the auto-follow documented since 0.2.0 never actually
+  ran and `--cursor` was a write-only flag.
+- **`page children` capped at 20.** It sent no `limit` or `cursor` to
+  `/pages/sidebar-pages` and got the server default.
+- **`page move --parent` returned HTTP 400 without `--position`.** Docmost's
+  `MovePageDto` declares `position` as required (`@MinLength(5) @MaxLength(12)`);
+  the CLI dropped it from the body when unset.
+- **Content updates failed with a misleading message.** The CLI POSTed to
+  `/pages/content/update`, an endpoint that does not exist in Docmost, and read
+  the 404 as an Enterprise-only restriction. Content now goes through
+  `POST /pages/update`, which Docmost applies server-side through its
+  collaboration gateway. The page keeps its ID, slug, history, comments and
+  inbound links — no WebSocket or Yjs client needed. Requires Docmost v0.71+.
+- **Space slug resolution failed past the first page of spaces**, reporting a
+  misleading `Space '<slug>' not found.` Now follows pagination, stopping at the
+  first match.
+- **`sync pull` fetched an incomplete tree** on spaces with more root pages or
+  children than one server page, silently producing a partial local copy.
+- **`sync push` lost the manifest when a phase aborted**, so the next push
+  re-created every already-created page as a duplicate. The manifest is now saved
+  in a `finally` block.
+- `update_page_content` only intercepted HTTP 404; a 405 or 403 fell through to a
+  bare "Unexpected error".
+
+### Added
+
+- `--version` / `-V` and a `version` subcommand. With `--verbose`, `version` also
+  reports the Python version and platform. The version now has a single source of
+  truth (`src/docmost_cli/__init__.py`), with `pyproject.toml` deriving it.
+- `--no-session-cache` global flag, `DOCMOST_NO_SESSION_CACHE` environment
+  variable and `no_session_cache` config key: the session JWT stays in memory and
+  is never read from or written to `~/.cache/docmost-cli/session.json`.
+- `docmost-cli config logout` deletes an existing cached session token.
+- `--limit`, `--page-size`, `--cursor`, `--no-follow` and `--envelope` on all
+  eight list commands. `--json` still emits a bare array; `--envelope` wraps it as
+  `{"items": [...], "meta": {...}}` carrying `hasNextPage` and `nextCursor`.
+- `page update --append` / `--prepend`.
+- `page move --root` to move a nested page to the space root.
+- `page list --tree --json` outputs the nested tree as JSON (it was previously
+  ignored).
+- `api/position.py`: base62 fractional indexing ported from the reference
+  algorithm, with jitter to satisfy Docmost's 5-character minimum. Keys stay valid
+  for Docmost's own JS generator, so dragging a sibling next to a CLI-placed page
+  in the web editor still works.
+- `models/common.py`: `PaginationMeta` and `PaginatedResult` pydantic models.
+- Guards against a server that ignores `cursor`: pagination stops when a cursor or
+  a page repeats, and warns, rather than looping forever.
+
+### Changed
+
+- `--tree` now rejects the pagination flags instead of silently ignoring them.
+- `print_table()` gained a keyword-only `meta` argument; `print_table` and the new
+  `print_warning` are exported from `docmost_cli.output`.
+- Corrected `SPECIFICATION.md` §5.2/§5.3 (response envelope shape, `/pages/move`
+  requirements, the non-existent content endpoint) and the `--position` docs in
+  the man pages. A new doc test keeps the man-page `.TH` versions in sync.
+
+## 0.4.0 (2026-03-22)
+
+- Add `sync pull` command: download all pages from a space to local Markdown files with YAML frontmatter
+- Add `sync push` command: upload local changes to server (create, update, move pages)
+- Add `sync status` command: show changes between local files and last-pulled state
+- Edition-aware content updates: Enterprise uses REST content update (preserves page ID), Community uses safe create-then-delete (new page created and verified before old page removed)
+- Flat directory layout with `.docmost-manifest.json` tracking sync state and SHA-256 content hashes
+- `--dry-run` flag on push to preview changes without executing
+- `--delete` flag on push to remove server pages not found locally (opt-in safety)
+- `--force` flag on pull to overwrite existing synced data
+- Topological sort ensures parent pages are created before children
+- ID remapping: when Community edition forces new page IDs, frontmatter and manifest are updated automatically
+- 105 new tests (96 sync module + 9 CLI integration)
+
+## 0.3.1 (2026-03-22)
+
+- Fix `page list --tree` and `page children` on Community edition: use `/pages/sidebar-pages` instead of `/pages/children` (404 on v0.70.3)
+- Tree recursion: only fetch children for pages with `hasChildren: true` (eliminates ~40 wasted API calls on a 50-page space)
+- Narrow error handling in tree builder (auth failures no longer silently swallowed)
+- Reduce API calls in `page get` (fetch page info once, not twice)
+- Remove raw HTTP call from CLI layer (use API function instead)
+- Deduplicate UTF-8 stdio reconfigure into `_ensure_utf8_stdio()`
+- Use `build_body` helper consistently in all API functions
+- Remove dead code: unused models, unused parameter
+
+## 0.3.0 (2026-03-22)
+
+- Add `parentPageId` to `page list --json` output columns
+- Add `parent_id` to `page get --meta` YAML frontmatter
+- Add `--icon` flag to `page update` command
+- Add recursive tree fallback: `page list --tree` fills in missing children
+- Add "See also" cross-references to all page command help text
+- Fix `page children` and `--tree` on Community edition: use `/pages/sidebar-pages` instead of `/pages/children` (404 on v0.70.3)
+- Fix emoji/Unicode crash: move UTF-8 encoding to correct entry point
+- Fix `--parent` on `page create`: use fractional index position string
+- Fix `--content` escape sequences: `\n` and `\t` now work as newline/tab
+
+## 0.2.4 (2026-03-22)
+
+- Fix emoji/Unicode crash for real: move UTF-8 reconfigure from `__main__.py` to `cli/main.py` (the actual entry point used by `docmost-cli` script bypasses `__main__.py`)
+
+## 0.2.3 (2026-03-22)
+
+- Fix `--parent` on `page create`: send fractional index position string (Docmost requires 5-12 char string, not integer)
+- Fix emoji crash on all Windows terminals: remove `isatty()` guard, always reconfigure to UTF-8 on Windows
+- Fix `--content` escape sequences: `\n` and `\t` now interpreted as actual newline/tab
+- Position parameter on `page move` changed from `int` to `str` (fractional index format)
+
+## 0.2.2 (2026-03-22)
+
+- Fix `--parent` on `page create` silently ignored (import endpoint ignores parentPageId; now calls move_page as fallback)
+- Fix `--help` crash on Windows (`OSError` from Rich's LegacyWindowsRenderer on cp1252 consoles)
+- Fix `page get --meta` crash when page content contains emoji (✅❌⚠️📊)
+- Reconfigure stdout/stderr to UTF-8 at startup on Windows interactive terminals
+
+## 0.2.1 (2026-03-22)
+
+- Fix tree view crash on Windows with emoji page icons (cp1252 encoding)
+- Fix silent Enterprise endpoint probe leaking error messages on Community edition
+- Fix API endpoints discovered during live integration testing:
+  - `/spaces/list` → `/spaces`
+  - `/comments/list` → `/comments`
+  - `/pages/export` format `md` → `markdown`, response is ZIP not JSON
+  - Auth token extracted from `authToken` cookie (not `token`)
+  - Comment content JSON-stringified for API
+- Consolidate duplicated code: shared `extract_items`, `extract_id`, `build_body` helpers
+- Remove 6 dead stub files (-84 lines)
+- Add `post_raw()` to DocmostClient for binary/probe responses
+- Fix double file read in page import
+- Add Claude Code skill (`/docmost`) for wiki interaction
+- Prepare for PyPI: py.typed marker, CHANGELOG, dependency upper bounds, classifiers
+
+## 0.2.0 (2026-03-22)
+
+- Retry with exponential backoff for transient errors (429, 5xx)
+- `--verbose` HTTP debug logging (request/response to stderr)
+- Page duplicate, copy, children, history, export, import commands
+- Tree view (`--tree`) for page listing
+- Workspace info/members, user me, attachment search commands
+- Pagination auto-follow with safety guard (max 1000 iterations)
+- ProseMirror-to-Markdown converter (all block nodes and marks)
+- Claude Code skill (`/docmost`) for wiki interaction
+- Comprehensive README with command reference
+- MIT LICENSE file
+- Session cache file permissions (0600)
+- 175 tests, 0 lint errors
+
+## 0.1.0 (2026-03-22)
+
+- Initial release
+- Project scaffolding with typer CLI framework
+- Configuration system with TOML profiles and environment variable overrides
+- HTTP client with API key (Enterprise) and session (Community) auth auto-detection
+- Page CRUD: create (via import endpoint), read, update, delete, move
+- Space list, create, update
+- Comment list, create, update (ProseMirror JSON wrapping)
+- Full-text search with space filtering
+- Output helpers enforcing stdout/stderr separation
+- Edition-agnostic design (Community + Enterprise)
+- 50 tests with pytest + pytest-httpx