Skip to content

omniroadmap-core v0.1.0

Released: 2026-08-23

omniroadmap-core v0.1.0 is the initial release of the shared core package for the omniroadmap ecosystem. It defines the tool-agnostic provider contract and canonical roadmap/product-management types that adapters use to expose Aha, Aha Studio, ProductBoard, Jira Product Discovery, and similar systems through a common API.

Highlights

  • Added the root github.com/grokify/omniroadmap-core module.
  • Added the read-only provider.Provider interface for roadmap and product-management adapters.
  • Added canonical types for items, releases, statuses, people, links, custom fields, capabilities, MoSCoW, Kano, and RICE.
  • Added provider registry helpers for adapter registration and deterministic provider lookup.
  • Added sentinel errors and structured APIError support.
  • Added provider/providertest, a conformance harness adapters can run against their implementations.
  • Added MkDocs documentation for canonical types and adapter authoring.
  • Added CI, lint, CodeQL SAST, Dependabot, and repository metadata.

Scope

The v0.1.0 API is intentionally read-only. Consumers can list and fetch roadmap items, releases, statuses, and custom field definitions, while write operations remain outside the core contract.

Adapters should keep source-specific data in namespaced metadata keys and leave downstream prioritization fields such as MoSCoW, Kano, and RICE unset unless a later mapping layer populates them from tenant-specific custom fields.

Adapter Workflow

Adapters live in the SDK repo for each source system, typically under an omniroadmap/ package. Each adapter implements provider.Provider, registers itself through omniroadmap.RegisterProvider, and runs providertest.RunAll in its test suite.

Notes

This release establishes the core contract only. Higher-level sync, storage, analytics, prioritization, and export features belong in the batteries-included github.com/grokify/omniroadmap repo or downstream application layers.