Documentation
¶
Overview ¶
Package migrate moves a GitHub Projects v2 board into the git layout: the snapshot is the truth, the event log becomes annotation commits, every id is derived from its source so a re-run is byte-identical, and the report names everything that did not carry over. One way, idempotent, dry-runnable.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Options ¶
type Options struct {
Owner string
Board int
Title string
Committer gitstore.Identity
// DryRun builds everything and pushes nothing.
DryRun bool
// Force writes over a remote that already holds a board.
Force bool
}
Options configures one migration.
type Report ¶
type Report struct {
AlreadyMigrated bool
Verified bool
Cards, Teams, Projects, Epics, Deadlines, Processes, Tasks int
Events, Commits int
DoneFromSeeded, DoneWithoutJump int
IssueCards []string
UnattributedNotes int
Dangling []string
Dropped []string
// Stranded are the cards the source board carried that were PLACED on a
// day and then left where no view can reach them — the shape the old ×
// made when it demoted a worked card into the previous sprint
// (board.Unreachable, dated). The migration takes them off the board in
// a commit of its own; the history keeps them.
Stranded []string
// Placeless are cards no view shows because nobody ever put them
// anywhere: no sprint, no dates, no column, no week. They are not the
// ×'s leavings, so nothing is deleted — they are named, and the board's
// owner decides.
Placeless []string
IDMap map[string]string
}
Report is what the migration did and what it could not carry over.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package ghsource is the read-only GitHub Projects v2 client behind `aeman migrate`: it loads one project board over the GraphQL API and maps it onto the domain board.Board the migration consumes.
|
Package ghsource is the read-only GitHub Projects v2 client behind `aeman migrate`: it loads one project board over the GraphQL API and maps it onto the domain board.Board the migration consumes. |
Click to show internal directories.
Click to hide internal directories.