Skip to content

feat(html-documents): upload an organization's HTML library from the CLI - #221

Merged
MikeChenWM merged 1 commit into
mainfrom
cursor/html-documents-upload-c1a5
Nov 17, 2026
Merged

MikeChenWM merged 1 commit into
mainfrom
cursor/html-documents-upload-c1a5

Conversation

@MikeChenWM

Copy link
Copy Markdown
Contributor

Why

Mike, CTO, wants to upload HTML documents from the CLI into MuseOn's org-isolated HTML document library, setting a title and a default filename. The API is Museon-AI/museon#7516.

Changes

The commands follow this repo's action sigil and flag rules (a path is --file, not a positional, and a folder id is --folder-id):

  • museoncli html-documents +upload --file PATH --title TITLE [--filename NAME] [--folder-id FOLDER_ID]
  • museoncli html-documents +list [--q TEXT] [--folder root|FOLDER_ID]
  • museoncli html-documents folder +create --name NAME
  • museoncli html-documents +install-defaults

Upload POSTs {title, html, filename?, folder_id?} to /api/v1/organizations/{org}/html-documents with the CLI's existing auth and X-Organization-Id. filename is --filename, or the file's basename when that basename is one *.html/*.htm name with no .. or slash; otherwise it is omitted and the server names the file from the title. A path in --filename contributes only that basename. parent_id is never sent. Folder create POSTs {name} only. +install-defaults POSTs to .../defaults with no body and does not duplicate guides on a second call.

Tests

uv run pytest -q
1932 passed in 451.65s

uv run ruff check .
uv run python scripts/gen_command_docs.py --check
uv run python scripts/gen_command_contract.py --check
uv run python scripts/gen_task_index.py --check
uv build --wheel
uv run python scripts/verify_public_artifacts.py
uv run python scripts/smoke_install.py

smoke_install reported clean install smoke passed: version=2.2.0 commands=499.

Release

This PR does not bump the version, tag, or publish a wheel.

Museon CLI ships as one wheel on a GitHub Release. The sequence in docs/releasing.md is: bump [project].version in pyproject.toml (and uv.lock, the README, the install guide, and the bundled Skill), regenerate the command docs, contract, and task guide, merge to main, then push tag v<version> on that commit. .github/workflows/release.yml runs on v* tags, checks the tag matches the package version and is an ancestor of main, runs the test suite, builds one wheel, and publishes the wheel, command contract, install guide, task guide, and skills archive.

After that release, the museon repo needs pnpm agent-cli:contract:sync so the agent command catalog learns these commands. #7516 did not change that catalog, and this PR does not either. The changelog entry belongs with the version bump.

Open in Web Open in Cursor 

Add html-documents +upload, +list, folder +create, and +install-defaults.
They call the org-scoped HTML document API with the selected organization
and never send a parent id or a workspace.

Co-authored-by: Weimeng Chen <MikeChenWM@users.noreply.github.com>
@MikeChenWM
MikeChenWM merged commit a391730 into main Nov 17, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants