feat: Project Milestones – CLI CRUD

[raegislabs]

Dependencies

• Builds on feat: add project assignment to issues (fixes #12) #15, feat: add project creation and archival commands #16, and feat: add project update and enhanced display #17 (project assignment, creation/archival, update/display)
• Part of RAE-362 (Project Management Epic 1). Reviewable independently; no hard code dependency.

Summary

Adds first‑class Project Milestones management to linctl with complete CLI coverage:

• milestone create/list/get/update/delete
• Date validation (YYYY‑MM‑DD)
• Progress/status reporting in list/get
• Plaintext and JSON output modes

Motivation

Project managers need to plan and track delivery against milestones from the terminal. Prior PRs enabled project creation, updates, and richer display, but there was no way to manage project‑scoped milestones via CLI.

Changes

New Features

• linctl milestone create --project <id> --name <name> [--target-date YYYY-MM-DD] [--description <text>]
• linctl milestone list <project-id> [--include-archived]
• linctl milestone get <milestone-id>
• linctl milestone update <milestone-id> [--name <name>] [--target-date <date>] [--description <text>]
• linctl milestone delete <milestone-id>

Implementation Details

• pkg/api/queries.go
  • Add ProjectMilestone and ProjectMilestones types
  • Add GraphQL operations: ListProjectMilestones, GetProjectMilestone, CreateProjectMilestone, UpdateProjectMilestone, DeleteProjectMilestone
• cmd/milestone.go
  • Add Cobra command group and subcommands
  • Validation for required flags and target date format
  • Rich plaintext/JSON/table rendering
• cmd/milestone_test.go
  • Mock client via interface injection
  • Stdout capture tests for create/update/delete flows

Usage Examples

# Create
linctl milestone create --project 3c7b1d1a-1234-5678-9abc-dededededede --name "Sprint 1" --target-date 2025-12-31

# List
linctl milestone list 3c7b1d1a-1234-5678-9abc-dededededede

# Get
linctl milestone get ms-123

# Update
linctl milestone update ms-123 --name "Sprint 1 (Updated)" --target-date 2026-01-15

# Delete (archive)
linctl milestone delete ms-123

Validation

• Target date must match YYYY‑MM‑DD (explicit error if invalid)
• Create requires --project and --name
• Update requires at least one of: --name, --description, --target-date

Testing

Unit Tests

• Milestone create/update/delete flows with mock client and stdout capture
• Dependency injection pattern to avoid network/API calls

Smoke/Build

• go test ./... passes
• make fmt applied

Breaking Changes

None – all changes are additive.

Architecture Notes

• Adheres to existing dependency injection style (milestoneAPI interface)
• Follows Cobra command patterns and output conventions (plaintext/JSON)
• Uses cmd.Flags().Changed() for partial updates (send only changed fields)

Checklist

• Tests added and passing
• Code follows existing patterns
• Help text comprehensive and matches behavior
• Manual sanity checks performed
• No breaking changes
• Smoke tests passing
• References RAE-362 (Project Management Epic 1)

Contributor Checklist (Contributing.md)

• Go 1.22+ environment
• make deps as needed
• make fmt applied
• make test passes (read‑only smoke tests)
• No release actions in this PR (handled on tag per Release Checklist)

[enkoder]

would love to see this hit main