Skip to content

Releases

wongo v0.4.0

Choose a tag to compare

@hoohugokim hoohugokim released this 27 Oct 10:57
0e0b785

What changed

  • Track declared render inputs and profile/style/assets, detect stale output, and refuse promotion when inputs change during rendering.
  • Resolve native cross-references within their document and validate final DOCX after declared transforms inside the render transaction.
  • Add contextual audits, final-document inspection and optional converted previews, portable evidence, and separate human decision gates.
  • Add opt-in main-to-SI references: si_references: true replaces [SI table](wongo-si:tbl-label) with the printed label from the final SI caption.
  • Improve context-aware abstract, display-item, highlights and profile checks.

Compatibility

wongo check still exits 0 for JSON ok: false; use --strict for exit 1. Collaboration rendering retains its native unresolved-crossref warning behavior. Wongo does not modify QMD source from worksheets or turn agent proposals into human approval.

Existing manuscripts do not enable the new audits or SI-reference interface automatically. SI references support numbered English Figure/Table captions and produce plain text, not clickable links between Word files. Converted previews do not certify native Word layout; evidence does not establish scientific validity.

Installation

uv tool install https://github.com/hoohugokim/wongo/archive/refs/tags/v0.4.0.zip

For an existing installation, add --reinstall. The wheel and source distribution below are accompanied by SHA256SUMS. This release is published on GitHub, not PyPI.

Validation and deferred work

The isolated integration passed 889 tests (4 skipped), including real Quarto cases. Release metadata/front-door checks and local lint/package verification passed. Release CI passed across Linux/macOS/Windows, including real Quarto renders; CodeQL passed. PR #7 merged as 0e0b785; its source tree is identical to the CI-tested head. The Windows audit fixture was corrected to use normalized input keys. Optional Cursor review checks were still pending at merge and are not represented as passed.

The maintainer explicitly waived private-reference manuscript parity for v0.4.0 and deferred the native Windows/Korean-account/Word pilot to a future release. Neither is claimed as passed. The pending worksheet-verification feature, five new profiles, and unrelated research/AIX drafts are excluded.

wongo v0.3.1

Choose a tag to compare

@hoohugokim hoohugokim released this 02 Oct 15:22
6859360

Wongo v0.3.1 adds a native MCP interface for manuscript checks and coauthor review, strengthens journal word-count gates, and improves tracked-change handling. It also introduces the approved Wongo design system for documentation and project communications.

Added and improved

  • MCP integration: 12 tools, 3 prompts and 3 resource surfaces expose the existing manuscript engine over stdio. Client setup supports Claude Desktop, Cursor and VS Code, preserves existing configuration, and reports partial failures. The tested Python SDK requirement is mcp>=2.2.0,<3.
  • Review with source context: worksheet rows carry review hints and word-count deltas; batch proposals retain a separate human decision and preserve proposal history. wongo review --row and --pending-only support focused review.
  • Journal counting: per-type Nature-family exclusions and a reference-inclusive submission gate prevent a source-only estimate from silently omitting the rendered bibliography. Missing or stale counting evidence blocks submission.
  • Word robustness: nested citation changes parse into worksheets; inline math, tabs and breaks are supported in tracked diffs; table widths follow section geometry; affiliation labels continue past z as aa, ab and so on.
  • Reproducible demonstration: a synthetic Quarto/R manuscript, Word review fixture and benchmark exercise discovery, injected defects, exact edits, decision states and preservation of existing outputs after submission refusal.
  • Wongo identity: light/dark and monochrome SVG/PNG logos, local licensed fonts, design tokens, CSS and a Quarto example. Branding is opt-in for communications; journal profiles and manuscript house styles continue to control DOCX appearance.

The MCP audit also fixes render/default-roundtrip calls, worksheet resource URIs, source-aware lint, structured error details, and client-specific configuration handling.

Verification

  • 528 local default tests passed, with 6 skips; two real Quarto/R MCP tests passed separately.
  • CI covers Python 3.11–3.13 on Linux, 3.11/3.13 on Windows, and 3.12 on macOS, with real Quarto/R end-to-end workflows on all three operating systems. Release-commit CI and CodeQL passed.
  • Four synthetic benchmark dimensions passed. These checks do not measure LLM accuracy, scientific validity or researcher time savings.
  • Fresh v0.3.0 reference comparison: 95 parts across four DOCX files were byte-identical, with no allowlisted differences.
  • All 33 generated brand assets rebuilt byte-identically; the rendered example, font/runtime licenses and local links were verified.
  • Fresh wheel and source archive were inspected; the wheel was exercised in an isolated environment with the minimum supported MCP SDK. Uploaded asset digests match the included SHA256SUMS.

See the audit evidence and release verification.

Install

uv tool install --upgrade https://github.com/hoohugokim/wongo/releases/download/v0.3.1/wongo-0.3.1-py3-none-any.whl
wongo --version
wongo doctor

In Claude Code:

/plugin marketplace add hoohugokim/wongo
/plugin install wongo@wongo

See Getting started and the demo instructions. The source archive includes the complete offline brand kit; the runtime wheel does not carry those documentation assets.

Remaining validation

PyPI publication is pending. A native Windows pilot with a Korean account, client setup, Korean IME and Word file-lock handling remains separate from CI. Source-alignment hints are explicitly unverified; authors still review scientific claims and approve edits.

Full changes: v0.3.0...v0.3.1.

wongo v0.3.0

Choose a tag to compare

@hoohugokim hoohugokim released this 29 Sep 19:09

Wongo v0.3.0 makes the manuscript workflow available on Windows, macOS and Linux, with a Claude plugin for researchers who prefer to work through conversation.

Added

  • wongo doctor checks Quarto, R, packages, project configuration and Windows path hazards, with actionable installation hints.
  • wongo status reports output freshness and the next manuscript step.
  • wongo review and wongo worksheet status|lint|set complete the coauthor feedback loop: agents propose, people decide, and the worksheet must pass lint before approved edits reach the source.
  • The Claude Code plugin marketplace, Windows/macOS setup guide, and scaffolded agent instructions and editor tasks.
  • A single JSON result object for every CLI command, including usage errors, interrupted runs and internal failures.

Fixed

  • Renders stage and post-process all files before promotion; any failure or interruption restores previous outputs and their manifest. A file held open in Word produces an actionable error.
  • Collab DOCX files use the schema-correct w:trackRevisions element so Word opens with Track Changes enabled.
  • UTF-8 source and subprocess handling, BOM input, Windows executable discovery, and unsupported Quarto path detection.
  • Roundtrip alignment skips HTML-comment lines and anchors changes on the last words before them.
  • Worksheet commands preserve proposals and refuse to overwrite recorded decisions without an explicit override.

Verification

  • 402 local tests passed, with 3 platform-specific skips on macOS; Ruff, build and wheel CLI smoke checks passed.
  • CI tests on Ubuntu, Windows and macOS, with real Quarto 1.10.18 and R end-to-end renders.
  • Fresh reference-manuscript comparison against v0.2.0: 95 DOCX parts across four outputs; only the two collab settings parts differ. Raw XML confirms exactly the intended trackChanges -> trackRevisions correction.
  • Claude plugin manifest validation passed.

Install

uv tool install https://github.com/hoohugokim/wongo/releases/download/v0.3.0/wongo-0.3.0-py3-none-any.whl
wongo --version
wongo doctor

In Claude Code:

/plugin marketplace add hoohugokim/wongo
/plugin install wongo@wongo

Then ask Claude to set up Wongo or start an example manuscript. See Getting started.

The personal quarto-manuscript-* skill entry points are retired in favor of the maintained Wongo plugin. Journal requirements come from wongo profile show <slug> --json.

Remaining work

PyPI publication awaits maintainer account setup. Reference-inclusive word counts and Nature-family counting exclusions remain open. A real Korean-account Windows pilot is still needed for desktop plugin setup, Korean IME input, and rendering while Word holds an output file.

Full changes: v0.2.0...v0.3.0.

wongo v0.2.0

Choose a tag to compare

@hoohugokim hoohugokim released this 25 Sep 05:07

wongo v0.2.0

Render parity verified against the private reference manuscript: 95 DOCX parts compared, and the only differences are the corrected SI cover count ("26 tables" → "12 tables").

Fixed

  • The default style no longer crashes renders (pandoc 3.10 reference docs carry no page size) and keeps the journal reference-doc fonts.
  • The SI cover sheet counts tables by caption instead of counting Quarto's figure wrappers.
  • TOC art fits inside the journal's width × height box (ACS 3.25 in × 1.75 in), aspect ratio preserved.
  • Water Research submissions no longer carry house-style line numbers (line_numbers: forbidden).
  • Word limits that include references (Water Research, ES&T correspondence) no longer report a silent PASS.
  • wongo check reads the bibliography from _quarto.yml or the front matter, and ignores commented-out images, div fences and shortcodes.
  • Reference-doc headings no longer fall back to the Aptos theme font.
  • tools/bytecompare.py renders a scratch copy and never writes into the reference project.

Changed and added

  • wongo diff tracks changes in cited prose: crossref and citation links are rebuilt around tracked runs, formatting is kept per word, and nested table changes are reported.
  • wongo profile verify lints profiles against the journal-profile contract.
  • wongo roundtrip --qmd si.qmd aligns SI renders against si.qmd.
  • Ruff runs in CI; the test suite grew from 29 to 131 tests.

Install

uv tool install https://github.com/hoohugokim/wongo/releases/download/v0.2.0/wongo-0.2.0-py3-none-any.whl
wongo --version   # 0.2.0

Change history lives in the conventional commits since v0.1.0; docs/CHANGELOG.md is frozen.

wongo v0.1.0

Choose a tag to compare

@hoohugokim hoohugokim released this 25 Aug 01:09

wongo v0.1.0 — Quarto-manuscript skills uplift complete

First shareable release: quarto-manuscript-* Claude Code skills uplifted into wongo, a Python package + CLI for verified journal-manuscript production.

Highlights

  • wongo.docxpatch / wongo.styles / wongo.profiles / wongo.engine + CLI (render/check/roundtrip/scaffold/profile)
  • Data-driven house styles (kist-wcr, default) and 7 verified journal profiles (ES&T, Water Research, npj Clean Water, Nature Water, Microbiome, Environmental Microbiome, npj Biofilms) shipped as package data
  • Style resolution: _journal.yml style: → $WONGO_STYLE → default
  • Skills thinned to wrappers; legacy/ removed; canonical quirks memory in docs/docx-quirks.md
  • Docs: CONTRIBUTING.md, CHANGELOG.md, docs/product-definition.md
  • Security hardening: profile verify scheme/host allowlist with redirect-safe opener; docx zip-bomb guard; manuscript-identifying details sanitized before publishing

Verification

  • pytest: 14 passed
  • Byte-compare harness (tools/bytecompare.py, set WONGO_REF_PROJECT): noise floor zero
  • Wheel builds self-contained (profiles/styles/scaffold) and renders main+SI × collab+submission

Install

uv tool install --editable .   # dev
wongo --version   # 0.1.0
wongo scaffold my-paper && wongo profile verify est --offline

See CHANGELOG.md for the full ledger.