v0.1-RC — Bundle, polish, ship
Ship the v0.1-implementation phase as a release. Verify bundle size, confirm mobile portability (per Ch 23 §5 isDesktopOnly: false commitment), polish remaining UX rough edges, prepare community-plugin submission. Released as v0.2.0 since v0.1.0 was the original MVP shipped 2026-04-02.
This RC consolidates the six v0.1 architectural commitments settled in the 2026-05-04 design phase: schema-as-primitive, closed 5-mechanism recipe grammar, TS in-plugin engine, sqlite-wasm Tier 2 substrate, runtime-agnostic recipe schema, Bases query layer.
Status
Section titled “Status”📋 Planning
Dependencies
Section titled “Dependencies”- All prior v0.1 milestones complete (v0.1.1 through v0.1.8)
In:
- Bundle size verification — measure plugin core + sqlite-wasm + sqlite-vec; target ≤ 1.2 MB compressed
- Mobile portability test — install on Obsidian Mobile (iOS or Android via Capacitor); verify import wizard, Tier 1 generation, sidecar projection, exporters all work
- README final polish — aligned with the design-phase-complete state; tagline preserved; jargon stripped
- Lint clean —
bun run lintpasses for community-plugin submission rules - Community plugin submission prep — checklist run-through per Obsidian Plugin Guidelines
- Release notes — comprehensive but user-facing (no internal-vocabulary leaks per memory entry)
- Version bump to v0.2.0 —
package.json,manifest.json,versions.json
Out:
- v0.2 milestones (XLSX/JSON parsers, tag/wikilink mechanism wiring, graph_edges)
- v0.5 external Python producer
- Marketplace registry
Concrete tasks
Section titled “Concrete tasks”- Run
bun run buildin production mode; report final bundle size - Compare against the 1.2 MB target; if over, identify trim opportunities (lazy-load XLSX, skip SSSOM exporter unless user enables, etc.)
- Install plugin in a real Obsidian Desktop install (not just
test-vault/); run a full import workflow - Install on Obsidian Mobile; run a tree-shaped-source import (CSV); verify sidecar projects + queries work
-
bun run lintclean — noobsidianmd/*rule violations - README pass — verify against the “no internal vocabulary” memory rule; tagline still says “Turn your Obsidian vault into an operational GRC knowledge graph”; “How it works” diagram up-to-date
- CHANGELOG.md update — convert “Unreleased” section to “0.2.0 — 2026-MM-DD”
- ROADMAP.md update — flip v0.1 implementation phase status to ✅ Complete; add a “What carried forward” section
- Archive v0.1 implementation roadmap page — move to
reference/roadmap/v0-1-implementation.mdxper the archive convention - Submit to obsidianmd/obsidian-releases via PR per community plugin process
Success criteria
Section titled “Success criteria”- Bundle ≤ 1.2 MB compressed total
- Plugin installs and runs cleanly on Obsidian Desktop AND Mobile
-
bun run lintexits 0 - All v0.1.1–v0.1.8 milestones marked ✅ Done
- PR submitted to obsidianmd/obsidian-releases for community-plugin inclusion
Files to touch
Section titled “Files to touch”package.json— version bumpmanifest.json— version bumpversions.json— append entryCHANGELOG.md— finalize 0.2.0 entryROADMAP.md(root) — phase status flipdocs/.../reference/roadmap/index.mdx— phase status flip + archive linkdocs/.../reference/roadmap/v0-1-implementation.mdx— new archive pageREADME.md— final polish passdocs/.../development/contributing.mdx— verify install/contribute paths still accurate
Open questions
Section titled “Open questions”- Is the v0.2.0 number right, or do we want v0.1.0-rc.1 → v0.1.0 (overwriting the existing 0.1.0 MVP semantically)? Lean toward v0.2.0 since the MVP shipped and is in user hands; this is genuinely the next minor
- Community plugin submission timing — submit immediately on RC pass, or wait through a quiet “early adopter” period?
Related
Section titled “Related”Concept pages:
- Problem — the framing the RC ships against
- What makes Crosswalker unique — the differentiators the RC needs to communicate clearly to evaluators
- Terminology — canonical vocabulary; check user-facing surfaces follow it
- Ecosystem — community-plugin landscape context
- Operational landscape — adoption + deployment story
Agent context:
- Vision — what the RC needs to deliver against
- Tradeoffs — known limitations to be transparent about
- v0.1 schema spec — the schemas RC publishes
- Decisions — architectural decisions consolidated
Design decisions (synthesis logs — the 6 architectural commitments):
- v0.1 import-engine design (2026-05-04) — six commitments + Bases query layer
- Ch 22 synthesis (target-structure expressivity) — closed 5-mechanism grammar
- Ch 23 synthesis (bundle/engine/language) — TS in-plugin engine; mobile portability; runtime-agnostic schema
- Ch 24 synthesis (Tier 2 substrate) — sqlite-wasm
- v0.1 stack pivot (2026-05-02) — overall stack
- README user-facing-surface rule — saved 2026-05-04; keep README jargon-free
Research deliverables (RC verification context):
- Ch 23 deliverable (bundle/engine/language) — bundle-size + portability evidence
- Ch 19 deliverable (overengineering stress test) — what NOT to ship in v0.1
Spec & schema files:
External references:
- Obsidian Plugin Guidelines
- Obsidian Plugin Submission process
obsidianmd/eslint-plugin— community-plugin lint rules
Other milestones:
- v0.1.1 through v0.1.8 — all dependencies
- Milestone hub