plans

Plan — Upgrade Cite Wide to Obsidian 1.13 (0.3.0)

Cite Wide's commands stopped loading on Obsidian 1.14 and pnpm 12 wouldn't build it. One pass gets it loading, building, searchable, and tested.

cite-wide Implementing
All context

Plan — Upgrade Cite Wide to Obsidian 1.13 (0.3.0)

Why Care?

Cite Wide's commands vanished from the command palette on Obsidian 1.14. The 14 commands were: hex citations, URL dedupe, LLM-research parsing, and reference cleanup. A citation tool you can't invoke is no tool at all. Separately, pnpm build failed under pnpm 12, so the plugin couldn't be rebuilt to fix anything.

This plan gets Cite Wide loading, building, and tested on Obsidian 1.13+, and brings it level with Image Gin 0.3.0.

What we know so far

  • The build is fixed in 230a5ee. pnpm 11+ ignores the "pnpm" block in package.json, so the security overrides and build-script settings moved into Cite Wide's own pnpm-workspace.yaml. That file lists only this plugin; it's a settings file, not a shared workspace. CI's pnpm 10 still installs from the frozen lockfile.

  • The missing commands are not yet explained. The built main.js (2026-08-18) loads under Node with a stub of Obsidian's API, and onload() registers all 14 commands. The cause is something only real Obsidian 1.14 does. The developer-console error from a plugin reload will name it.

  • Installation: the vault loads Cite Wide through a symlink to this repo, so main.js here is what Obsidian runs.

Steps

#StepDone when
1pnpm settings in the plugin's own pnpm-workspace.yamlpnpm build passes on pnpm 12; CI=true pnpm@10 install --frozen-lockfile passes ✅ 230a5ee
2Toolchain: obsidian 1.13.1, ESLint 10.12, typescript-eslint 8.71.1, eslint-plugin-obsidianmd 0.4.2 (the review-bot rules), esbuild 0.28.2. TypeScript held at 6.0.3, @types/node held on 22.✅ 2005c58
3Tests: the zero-dependency harness (esbuild + node:test), copied into this repo, plus two red-first specs✅ 599e13b
3aonload() registers every command✅ 14/14 register (also against a stub mirroring 1.14.4's real loadPlugin)
3bSettings definitions✅
4Missing-commands fix: root cause from the console error, or from auditing onload() against the 1.13 types⏳ No code cause found: the 1.14.4 runtime (app.js) was audited and every command registers in tests. Leading theory: the vault ran a stale main.js while pnpm 12 couldn't rebuild (fixed in 230a5ee; rebuilt). Confirmed or refuted by step 7.
5Settings tab on getSettingDefinitions(); minAppVersion 1.13.0; version 0.2.3 → 0.3.0 in manifest.json, package.json, and versions.json✅ e5c500d
6Docs: README (minimum version, anything stale), changelog entry, changelog/releases/0.3.0.md✅ 524eb4a
7Verify in Obsidian: quit (Cmd+Q) and reopen, confirm the 14 commands, search "Jina" in SettingsThe operator confirms
8Release (gated on the operator): fast-forward development → main → master, tag 0.3.0, verify assets and attestationsRelease live

Commands that must register

show-citations, dedupe-citations-by-url, parse-llm-citations, paste-llm-content, save-all-hex-citations, convert-all-citations, insert-hex-citation, convert-selected-citation-to-hex, clean-references-section, convert-citation-section-to-footnotes, format-citations-punctuation, lift-table-citations, extract-citation-from-url, format-reference-links

Settings rows that must carry over

  • Jina.ai API key (optional), bound to jinaApiKey

  • Citations folder, bound to citationsFolder: becomes a folder control

  • Auto-save URL citations, bound to autoSaveUrlCitations

Gates (before every code commit)

  • pnpm test

  • tsc -noEmit -skipLibCheck

  • ESLint at 0 errors and 0 warnings

  • node esbuild.config.mjs production

  • CI=true pnpm@10 install --frozen-lockfile

Stand-alone rule

Cite Wide installs, builds, tests, and releases on its own. The test harness and ESLint config are copied from Image Gin, never imported or referenced across repos.

  • content-farm/context-v/plans/Migrate-Plugin-Family-to-Obsidian-1-13.md: the family plan

  • image-gin/context-v/plans/2026-10-06_Migrate-Settings-Tab-to-Obsidian-1-13-Declarative-API.md: the reference migration