Skip to content

Rename "OST node" and "OST on a page" to space-centric terminology #22

@mindsocket

Description

@mindsocket

Motivation

The project's primary concept is a space — a named collection of nodes — rather than an "OST" (Opportunity Solution Tree), since the schema is already broader than a canonical OST and may diverge further over time. Using "OST node" and "OST on a page" as the primary terms ties the codebase to a specific framework name and implies a structural rigidity that isn't intended.

Proposed renames

Current term Candidate replacements
OST node node, space node
OST on a page space on a page, on a page, single page space, single page

The rename should be consistent across:

  • Source code identifiers and type names
  • Comments and JSDoc
  • Test descriptions
  • Documentation (docs/concepts.md, README.md, CLAUDE.md)
  • The type: ost_on_a_page frontmatter value and schema key (breaking change — needs migration notes)

Considerations

  • ost_on_a_page as a frontmatter type value is user-facing and changing it is a breaking change for existing files. A migration path (or alias support) will be needed.
  • The rename should be completed in a single focused PR to avoid mixed terminology.
  • Update docs/concepts.md once canonical names are decided, as it is the source of truth for naming.

Relates to the terminology discussion in docs/concepts.md and the broader space-centric framing.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions