feat: GitHub Projects v2 roadmap import workflow and script

[Copilot]

Automates creation of the WORR roadmap GitHub Projects v2 board from .tmp/worr-github-project-import-2026-02-27.csv (89 tasks, 16 epics across Feature and Development roadmaps).

New files

• tools/project/import_roadmap.py — end-to-end import script using the GitHub GraphQL API and gh CLI:

  • Ensures all labels exist (roadmap, feature, development, priority:P*, epic:XX)
  • Creates GitHub Issues with labels for each CSV row
  • Creates a Projects v2 board with 8 custom fields: Status, Roadmap, Type, Priority (single-select) + Task ID, Epic, Dependencies, Area (text)
  • Populates every project item with its field values
  • Supports --skip-issues --issue-map <file> to resume after a partial run without duplicating issues

• .github/workflows/import-roadmap.yml — workflow_dispatch workflow with configurable CSV path and project title; fails fast if PROJECT_TOKEN is absent (the default GITHUB_TOKEN lacks project scope); uploads/downloads a roadmap-issue-map artifact to make skip_issues resume mode work across runs

• docs-dev/github-projects-roadmap-import.md — setup prerequisites (PAT scopes), CLI and Actions usage, CSV column reference, field definitions, and steps to add a Roadmap view in the GitHub UI

Usage

# Local
export GH_TOKEN=<pat-with-repo+project-scopes>
python3 tools/project/import_roadmap.py \
    --csv .tmp/worr-github-project-import-2026-02-27.csv \
    --repo themuffinator/WORR \
    --title "WORR Roadmap 2026"

Via Actions: add PROJECT_TOKEN secret → Actions → Import Roadmap to GitHub Projects → Run workflow.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.