Skip to content
🧠 Research & Foundations phase — building the KB from the ground up. See the roadmap →

Operational landscape

Updated

The operational landscape shows who does what in the contributable wiki ecosystem. It combines three dimensions:

  • Actors — who builds, configures, contributes, reads, hosts
  • Components — translation layer, CMS, auth, publishing, content, plugins
  • Resource intensity — build-once investment vs periodic updates vs continuous operational work

This is the combined view that determines what to build into software, what to crowdsource, and what requires ongoing resources (money, people, tooling).

See crosswalker’s operational landscape for the sibling project’s version of this analysis.


Build once
First principles
Build & refine
Evolves slowly
Community
Shared work
Ongoing ops
Regular updates
Continuous
Never done

The gradient runs from emerald (build once, rooted in first principles) through amber (community-maintained, shared effort) to red (ongoing operational work that never ends).

Translation layer specTier system, round-trip rules
Remark/rehype pluginsWikilinks, callouts, embeds
Round-trip test suiteFixture corpus + CI
Content addressingStable URLs, permalink scheme
CMS integrationDecap/Sveltia/EmDash glue
Auth + OAuth proxyGitHub OAuth, contributor identity
Inline editing UXIn-page WYSIWYG widget
Plugin compat profilesWhich plugins work headless
Vault templatesStarter configs, frontmatter schemas
Contribution guidelinesCONTRIBUTING.md, PR templates
Hosting + deployCloudflare Pages, CI pipeline
Dependency updatesAstro, Starlight, plugins
Content moderationSpam, abuse, PR review
Content creationWriting the actual wiki
Software (build once)Platform (build & refine)Community (shared)Operations (ongoing)User work (your effort)

Who owns what across the contributable wiki ecosystem?

Color key: One-time/rare — Periodic updates — Continuous ops — N/A

Translation layerCMS / contributionAuth + identityPublishing pipelineContentPlugin abstraction
Cyberbaser core team Builds remark/rehype plugins, defines tier system Integrates CMS, builds inline editing Builds OAuth proxy, auth model Configures Astro + Starlight + deploy● N/A Tests Obsidian CLI/headless compat
Vault owner● N/A Configures CMS for their vault Sets up OAuth app, manages trusted contributors Deploys, maintains domain Creates + curates content Chooses which plugins to enable
Web contributor (zero-git)● N/A Uses CMS to edit pages Signs in via OAuth● N/A Writes + corrects content● N/A
Power contributor (Obsidian+git)● N/A● N/A● N/A (uses git directly)● N/A Writes content with full Obsidian affordances Uses plugins locally
Hosting provider (Cloudflare, GitHub)● N/A● N/A Provides OAuth endpoints Serves static files, runs Functions● N/A● N/A
Obsidian (the company) Defines OFM spec● N/A● N/A● N/A● N/A Maintains CLI/headless runtime
Community Reports edge cases, contributes plugins Contributes CMS templates● N/A Contributes themes, plugins Contributes content to vaults Tests plugin compat, files issues

Key insight: The content creation column (rightmost in spirit) is red for almost everyone — because the content is the whole point. No amount of software eliminates the need to write the wiki. Cyberbaser’s job is to make contribution as frictionless as possible, not to write the content itself.


Tier 1: First-principles software (build once)

Section titled “Tier 1: First-principles software (build once)”

Work rooted in the fundamental nature of the problem. Once solved correctly, this rarely changes because the underlying principles don’t change.

Work itemWhy it’s resilientRelated
Translation layer spec (tier system, round-trip rules)Obsidian-flavored markdown is stable; the tier definitions are structuralPrinciples #2
Remark/rehype plugins (wikilinks, callouts, embeds)unified AST ecosystem is mature; plugin interfaces rarely breakEcosystem
Round-trip correctness test suiteEquivalence rules for markdown are mathematical; fixture corpus is durableTranslation layer
Content addressing / permalink schemeURL stability is a wiki cardinal sin to violate; the scheme is chosen oncePrimitives: stable URLs

Business analogy: R&D. High upfront cost, near-zero marginal cost afterward. This is the technical moat — if cyberbaser’s translation layer is the best, it’s reusable as a library (@cyberbaser/translate).

Tier 2: Platform engineering (build and refine)

Section titled “Tier 2: Platform engineering (build and refine)”

Built on first principles but adapts as the ecosystem shifts. Changes on the order of months to years.

Work itemWhat causes changeRelated
CMS integration (Decap, Sveltia, EmDash)CMS landscape evolves; new features, new APIsRoadmap: CMS survey
Auth + OAuth proxyAuth standards evolve; new providers emergeRoadmap: auth model
Inline editing UXEditor tech improves (BlockSuite, Tiptap)Vault vision
Publishing pipeline (Astro + Starlight)Astro/Starlight version updates, new integrationsArchitecture
Plugin abstraction (Obsidian CLI/headless)Obsidian’s headless runtime evolves; community plugins adaptRoadmap: plugin execution

Business analogy: Product engineering. This is the platform value — the integration work that vault owners don’t want to do themselves. A hosted service (“bring your vault, get a contributable wiki”) is Tier 2 work packaged as a product.

Tier 3: Community-maintained (shared work)

Section titled “Tier 3: Community-maintained (shared work)”

Per-vault or per-plugin work that’s shareable. Once someone figures it out, everyone benefits.

Work itemWho does itRelated
Plugin compatibility profiles (which Obsidian plugins work in headless mode)Community tests; cyberbaser validatesRoadmap: plugin execution
Vault templates / starter configsFirst vault owner configures; shares via template repoExisting work
Contribution guidelines + PR templatesCommunity refines; vault owner customizesContribution workflows
Theme variants (beyond silver+emerald)Community contributes; cyberbaser maintains as examplesCurrent: brand.css

Business analogy: Marketplace / ecosystem. The more contributors, the more valuable each contribution. Like Obsidian’s community plugin ecosystem — once someone builds a plugin, thousands of vaults benefit.

Key insight: This is where a community config registry (like crosswalker’s config browser) would create the most value — per-vault configuration done once, shared infinitely.

Work that recurs because the external world changes. Cannot be eliminated — only automated or made more efficient.

Work itemWhy it recursRelated
Hosting + deploymentCloudflare Pages Functions, domain management, SSLArchitecture
Dependency updates (Astro, Starlight, CMS, plugins)Upstream releases on their own schedule; security patchesDevelopment
Content moderation (spam, abuse, PR review)Abuse scales with openness; Open Authoring = open attack surfaceContribution workflows
OAuth proxy maintenanceToken handling, secret rotation, provider API changesRoadmap: auth model

Business analogy: DevOps / SRE. If cyberbaser were a business, this is where subscription revenue funds ongoing labor. A hosted service wraps Tier 4 into a monthly fee so vault owners don’t have to manage it.

Work specific to YOUR vault. No tool can eliminate it — only make it more efficient.

Work itemWhy only you can do itRelated
Content creationOnly you know what to write aboutThe whole point
Contribution reviewOnly you can judge quality and accuracy for your domainContribution workflows
Vault organizationOnly you know the right structure for your knowledge domainPrimitives: vault
Contributor managementOnly you decide who to trust with auto-merge vs manual reviewContribution workflows

Business analogy: Customer’s work. Cyberbaser makes contribution FASTER and more reliable, but the actual knowledge is irreducibly human.


If cyberbaser were a business, where would the money come from?

TierFunding modelWhat it looks like
Tier 1 (first-principles software)Open-source + grants + sponsorshipThe translation layer is MIT-licensed. Anyone can use it. Goodwill + ecosystem gravity.
Tier 2 (platform engineering)Hosted service (SaaS)“Bring your vault, get a contributable wiki.” Monthly fee covers CMS setup, auth, inline editing, deployment. This is the product.
Tier 3 (community)Self-sustaining once critical mass is reachedPlugin compat profiles, vault templates, contribution guidelines — all community-contributed.
Tier 4 (operations)Included in the SaaS feeHosting, dependency updates, content moderation tooling, OAuth proxy — vault owners don’t want to manage this.
Tier 5 (user work)The value propositionCyberbaser sells efficiency, not elimination. “Your wiki, your content, but anyone can contribute without learning git.”

The core business thesis: Tier 1 is the technical moat (hard to replicate). Tier 2+4 packaged together is the product (a hosted contributable wiki service). Tier 3 is the ecosystem (community contributions make the platform more valuable). Tier 5 is what the customer actually pays for — making their irreducible work as painless as possible.

Comparison to existing models:

  • Obsidian Publish charges $10/month for Tier 2+4 — but has NO contribution model (no Tier 5 efficiency)
  • GitBook charges per user for Tier 2+4 — but has NO Obsidian fidelity (no Tier 1 moat)
  • Notion public pages is free for read — but has NO git SSOT (violates Principle 1)
  • Cyberbaser occupies the intersection: Obsidian fidelity + git SSOT + zero-git contribution + hosted service

The Research & Foundations roadmap should be read through this lens:

  • Identity question → determines which tiers to invest in first
  • CMS survey → Tier 2 decision (the platform choice)
  • Auth model → Tier 2+4 decision (infrastructure + ongoing maintenance)
  • Plugin abstraction → Tier 1 investment (if solved, becomes the technical moat)
  • Collaboration model → Tier 2 scope (real-time collab = much more Tier 4 ops work)
  • Translation layer → Tier 1 investment (the foundation everything else builds on)
  • Operational model → THIS PAGE (which tiers get resourced, in what order)

The architecture goal: Push as much work as possible toward Tier 1 (solved once, resilient). Where that’s impossible (Tiers 3-4), build community infrastructure so the work is shared. Only Tier 5 is irreducibly the user’s burden.