Releases: LiuWhale/marginnote-assistant
Release list
Codex Companion v0.4.47
Changes:
- Split speed and reasoning into separate settings.
- Speed now controls only the Codex CLI service tier: codex_config or Fast/service_tier=priority.
- Added separate reasoning effort controls: codex_config, low, medium, high, xhigh, max, ultra.
- Settings now reads the live Codex CLI model catalog and falls back safely when a saved model is stale.
- Updated README, user manual, changelog, static UI checks, and release package checks.
Verification:
- python3 -m unittest discover -s tests: 587 tests passed.
- python3 -m py_compile companion.py runtime_config.py send_action.py doctor.py refresh_mn_runtime.py release_acceptance.py package_release.py ui_functional_acceptance.py: passed.
- node --check extension/codex.mn.assistant/web/app.js: passed.
- release_smoke_test.py for dist zip and mnaddon: passed.
Known release-evidence gaps:
- release_acceptance.py still blocks on live MN4 runtime evidence for pluginVersion 0.4.47 until MarginNote 4 is restarted and the panel is opened.
- Native visible-highlight proof, signed/notarized pkg proof, and cross-machine install evidence are still missing. The pkg asset in this release is unsigned.
Codex Companion v0.4.42
Codex Companion v0.4.42
Public preview stability release focused on long-running Companion memory use, PDF text extraction, and local log growth.
Highlights
- Codex CLI generation no longer captures stdout/stderr through in-memory pipes. The Companion writes them to temporary files and only reads bounded tail text for diagnostics.
- PDF full-text extraction now streams PyMuPDF page output through temporary JSONL instead of returning one large stdout payload to the main service process.
- Recent runtime/event checks now tail-read
events.jsonlinstead of loading the whole event log. - Successful HTTP access logs are suppressed by default, while client-disconnect write errors are ignored to avoid noisy launchd logs.
- Added a regression assertion so future changes cannot silently route Codex CLI stdout/stderr back through
subprocess.PIPE.
Artifacts
CodexCompanion-0.4.42-latest-dist.zip
ffacc8ef9f7c46353399e0134c64cc65bfd23535af05bcb88c76cbaaa22f9758CodexCompanion-0.4.42-latest.mnaddon
c62bbbd79bce0d415f0fc24135b35a8e3a91b34794db63b7c8d7d23d6c7e7f18CodexCompanion-0.4.42-latest.pkg
5a18d47abf7e33ed58787a1aafc560d870e2ad87402a967384164e2b625d17e0SHA256SUMS.txt
Verification
python3 -m unittest discover -s tests: PASSnode --check extension/codex.mn.assistant/main.js: PASSnode --check extension/codex.mn.assistant/web/app.js: PASSpython3 -m py_compile doctor.py release_acceptance.py build_pkg.py companion.py package_release.py ui_functional_acceptance.py: PASSpython3 ui_functional_acceptance.py --browser-render --browser-interaction --browser-actions --browser-write-actions: PASSpython3 release_smoke_test.py release/CodexCompanion-0.4.42-latest-dist.zip --mnaddon release/CodexCompanion-0.4.42-latest.mnaddon: PASSpython3 release_smoke_test.py release/CodexCompanion-0.4.42-latest-dist.zip --mnaddon release/CodexCompanion-0.4.42-latest.mnaddon --install-dry-run: PASSpython3 build_pkg.py release/CodexCompanion-0.4.42-latest-dist.zip --json: PASS, unsigned preview pkg generated.- Local install and Companion restart: PASS, MN4 extension manifest is
0.4.42, Companion/healthOK, fresh RSS about 141 MB.
Known Preview Blockers
This is still a public preview, not final v1.0/v3. release_acceptance.py is intentionally not releasable yet because final-release gates remain blocked on fresh MN4 runtime Web controls/native API evidence, signed/notarized pkg, cross-machine install evidence, visible native highlight proof, and same-document runtime acceptance evidence.
Codex Companion v0.4.41
Codex Companion v0.4.41
Public preview release focused on the simplified Tools surface, expert-mode workspace, and stricter UI acceptance.
Highlights
- Default Workspace now opens as a simple task center instead of dropping users into the full expert workbench.
- Expert Mode now exposes Notebook Workspace, Workspace Navigator, object, operation, knowledge, workflow, and ledger details with a visible return path.
- Command Pane expansion now hides Workspace Navigator even in Expert Mode, keeping the prompt input and send button usable in small plugin windows.
- UI functional acceptance now matches the new product flow and verifies simple mode, Expert Mode, responsive layouts, button focus behavior, Enter send, prompt clearing, settings/history pages, and write-action wiring.
- Added/refined zero-message notebook kernels for Object Intake, Knowledge Console Matrix, Notebook Runbook, Object Task Composer, and Workflow Builder Board.
Artifacts
CodexCompanion-0.4.41-latest-dist.zipCodexCompanion-0.4.41-latest.mnaddonCodexCompanion-0.4.41-latest.pkgSHA256SUMS.txt
Verification
python3 -m unittest discover -s tests: 581 tests OKnode --check extension/codex.mn.assistant/main.js: PASSnode --check extension/codex.mn.assistant/web/app.js: PASSpython3 ui_functional_acceptance.py --browser-render --browser-interaction --browser-actions --browser-write-actions: PASSpython3 release_smoke_test.py release/CodexCompanion-0.4.41-latest-dist.zip --mnaddon release/CodexCompanion-0.4.41-latest.mnaddon: PASSpython3 release_smoke_test.py release/CodexCompanion-0.4.41-latest-dist.zip --mnaddon release/CodexCompanion-0.4.41-latest.mnaddon --install-dry-run: PASS
Known Preview Blockers
This is still a public preview, not final v1.0/v3. Final-release gates remain blocked on fresh MN4 runtime evidence after reopening MarginNote 4, visible native highlight proof, signed/notarized pkg, cross-machine install evidence, and same-document acceptance evidence.
Codex Companion v0.4.40
Codex Companion v0.4.40
This public preview moves Codex Companion beyond a chat-only panel toward a first-stage MarginNote Knowledge Agent OS.
Highlights
- Added first-stage Live MN Object Kernel, Source Registry action evidence, External Automation Gateway, Skill Runtime v2, and Verification Agent.
- Added Knowledge OS shell anchors in the WebView so stale chat-only runtimes are detected by doctor and single-document acceptance checks.
- Improved transactional native edit evidence by separating note/card rollback and residual proof.
- Upgraded workflow and skill runtime evidence with dry-run-first plans, next/resume actions, and verification reports.
- Updated bilingual README, product spec, user manual, release matrix, and current release audit for the v0.4.40 architecture.
Artifacts
CodexCompanion-0.4.40-latest-dist.zipCodexCompanion-0.4.40-latest.mnaddonCodexCompanion-0.4.40-latest.pkg
SHA256 values are recorded in SHA256SUMS.txt in the release artifact folder and OneDrive mirror.
Verification
python3 -m unittest discover -s tests: 535 tests OKrelease_smoke_test.pywith.mnaddon: PASSrelease_smoke_test.py --install-dry-run: PASSnode --checkformain.jsandweb/app.js: PASSgit diff --check: PASS
Known Preview Blockers
This is not a final v1.0/v3 release. Current release acceptance remains blocked on runtime WebView events after reopening MarginNote 4, native API probe evidence, visible native highlight evidence, signed/notarized pkg, cross-machine install evidence, and same-document acceptance evidence.
v0.4.39 - Actionable Source Registry
Public preview release.
Changes:
- Adds a Source Registry Action Plan to notebook_workspace.
- Notebook Workspace now shows Source Registry action buttons for cache current PDF, choose local PDF file, manage file paths, and refresh MarginNote context.
- Study Program source_registry gaps now point to the recommended Source Registry action instead of only showing text.
- Promotes notebookWorkspaceSourceActions to required runtime controls in doctor and single-document acceptance.
Verification:
- 507 Python unit tests passed.
- JS and Python syntax checks passed.
- release zip smoke passed.
- mnaddon smoke passed.
- install dry-run passed.
- unsigned pkg built.
- local install replacement completed.
Known preview blockers for final v1.0 remain: runtime WebView evidence after MN4 reload, native API probe evidence after panel open, visible native highlight evidence, signed pkg, notarized pkg, cross-machine install evidence, and single-document acceptance.
v0.4.38 - Notebook Source Registry
Public preview release.
Changes:
- Adds the first Notebook Source Registry kernel.
- Notebook Workspace now shows readable material sources across MN document metadata, explicit PDF paths, PDF cache, uploads, and configured search roots.
- Study Program now reports a source_registry gap when no readable full-document material is available.
- Separates total uploads from readable uploads so stale upload records no longer mark full-document work as ready.
Verification:
- 506 Python unit tests passed.
- JS and Python syntax checks passed.
- release zip smoke passed.
- mnaddon smoke passed.
- install dry-run passed.
- unsigned pkg built.
- local install replacement completed.
Known preview blockers for final v1.0 remain: runtime WebView evidence after MN4 reload, native API probe evidence after panel open, visible native highlight evidence, signed pkg, notarized pkg, cross-machine install evidence, and single-document acceptance.
v0.4.37 - Zero-Message Study Program
What changed
- Added codex.mn.studyProgram.v1 to Notebook Workspace.
- The first screen now shows zero-message coverage, concrete gaps, and recommended workflows without requiring a chat prompt first.
- Added visible Study Program controls for coverage, gaps, and workflow recommendations.
- Recommendations reuse existing workflow_start, confirmation, dry-run, and ledger paths instead of adding a write shortcut.
- Doctor and single-document acceptance now require the Study Program controls.
Verification
- python3 -m unittest discover -s tests: 504 tests passed.
- node --check extension/codex.mn.assistant/main.js passed.
- node --check extension/codex.mn.assistant/web/app.js passed.
- Python py_compile for Companion scripts passed.
- Release zip, mnaddon, package build, and install dry-run passed.
Known release gates
- Runtime Web controls and native API evidence require reopening or restarting the MarginNote panel for pluginVersion 0.4.37.
- Native visible highlight evidence, signed package, notarization, cross-machine install evidence, and single-document acceptance remain final release gates.
v0.4.36 - Notebook Runbook Preflight Ledger
What changed
- Added a real notebook runbook preflight ledger instead of only documenting the future design.
- AutoPlan executions now record running, completed, failed, cancelled, duration, actions, and target notebook evidence.
- Notebook Workspace now shows the latest AutoPlan run status, and Operation Ledger can inspect preflight evidence with a no-write verification policy.
- Updated Chinese and English docs to separate the current v0.4 product from the true v3 Notebook Knowledge OS target.
Verification
- python3 -m unittest discover -s tests: 503 tests passed.
- node --check for main.js and web/app.js passed.
- python3 -m py_compile for Companion scripts passed.
- release_smoke_test passed for zip, mnaddon, pkg, and install dry-run.
Known release gates
- Runtime evidence requires reopening/restarting MarginNote 4 panel after install.
- Package is unsigned/not notarized.
- Native highlight and cross-machine install evidence remain release-gate items.
v0.4.35 - Notebook Runbook AutoPlan
v0.4.35 - Notebook Runbook AutoPlan
- Adds autoPlan to codex.mn.notebookRunbook.v1 with schema codex.mn.notebookRunbookAutoPlan.v1.
- Adds the visible notebookWorkspaceRunbookAutoButton / 自动准备 entry in Notebook Workspace.
- Auto prepare runs safe preflight actions sequentially through existing workspace actions: native MN object scan, mind-map baseline read, and operation planning. It does not write to MarginNote; writes still go through Diff, confirmation, and Operation Ledger.
- Keeps Continue next step for single-gap progression and preserves native_object_scan evidence as the scan readiness boundary.
- Ships full installer zip, native .mnaddon bundle, unsigned pkg, and SHA256SUMS.
Preview release note: final v1.0 gates still require fresh MN4 runtime evidence, visible native highlight evidence, single-document acceptance, cross-machine install evidence, and signed/notarized pkg.
v0.4.34 - Notebook Runbook Continue
v0.4.34 - Notebook Runbook Continue
- Adds a single Notebook Runbook Continue action in Notebook Workspace. The button executes the first actionable runbook gap instead of requiring users to inspect each row manually.
- Adds nextStep/continueAction to codex.mn.notebookRunbook.v1 and requires notebookWorkspaceRunbookContinueButton in WebView, doctor, and single-document acceptance checks.
- Tightens MN object scan readiness: cached mind-map Registry objects no longer count as native scan completion; ready requires native_object_scan evidence.
- Ships full installer zip, native .mnaddon bundle, unsigned pkg, and SHA256SUMS.
Preview release note: final v1.0 gates still require fresh MN4 runtime evidence, visible native highlight evidence, single-document acceptance, cross-machine install evidence, and signed/notarized pkg.