Skip to content

post-1.0: build migration tools #187

Closed

Description

@adityamukho

Roadmap source

ROADMAP.md: Phase 9.1 Developer Tools and v1.0 stability promise.

Work item

Build migration tools for Minigraf file format changes.

Acceptance criteria

  • Provide an explicit migration/check command for .graph files.
  • Report source and target format versions.
  • Preserve single-file portability and clear failure behavior.
  • Add migration fixture tests.

Activity

  1. adityamukho commented on May 15, 2026

    @adityamukho
    CollaboratorAuthor

    Prerequisites

    This tool should be built after the migration matrix test suite in #216 is complete. The test fixtures will reveal the real edge cases in migration paths (boundary-sized facts, WAL replay around migration, corrupt legacy files) — implementing the tool before those cases are catalogued risks shipping a migrator that silently mishandles them.

  2. adityamukho commented on May 17, 2026

    @adityamukho
    CollaboratorAuthor

    Closing: there are no users on pre-1.0 file formats. Auto-migration from v1–v6 → v7 already handled at open/checkpoint time. No standalone tooling needed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestmigrationMigration related issue

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions