Release Notes - v0.10.0¶

Release Date: 2026-04-26

Overview¶

This release adds rollout status tracking for B2B SaaS deployments, enabling product teams to track feature deployment and adoption across their customer base with support for phased rollout waves.

New Features¶

Rollout Status Tracking¶

Track deployment and adoption metrics for deliverables in B2B SaaS environments:

Rollout Stages:

Stage	Description
`not_started`	Rollout has not begun
`rolling_out`	Deployment in progress
`deployed`	100% deployed, adoption ongoing
`adopted`	Target adoption achieved
`paused`	Rollout temporarily paused
`rolled_back`	Feature rolled back

JSON Example:

{
  "roadmap": {
    "phases": [
      {
        "id": "phase-1",
        "name": "MVP",
        "deliverables": [
          {
            "id": "D-001",
            "title": "SSO Integration",
            "description": "Enterprise single sign-on support",
            "type": "feature",
            "status": "done",
            "rollout": {
              "totalCustomers": 150,
              "deployedCustomers": 120,
              "adoptedCustomers": 95,
              "status": "rolling_out",
              "startDate": "2026-03-01",
              "targetDate": "2026-05-01",
              "waves": [
                {
                  "id": "wave-1",
                  "name": "Beta",
                  "targetCustomers": 10,
                  "deployedCustomers": 10,
                  "status": "completed"
                },
                {
                  "id": "wave-2",
                  "name": "GA Wave 1",
                  "targetCustomers": 50,
                  "deployedCustomers": 50,
                  "status": "completed"
                },
                {
                  "id": "wave-3",
                  "name": "GA Wave 2",
                  "targetCustomers": 90,
                  "deployedCustomers": 60,
                  "status": "in_progress"
                }
              ]
            }
          }
        ]
      }
    ]
  }
}

Helper Methods:

Method	Description
`DeploymentPercent()`	Percentage of customers with feature deployed
`AdoptionPercent()`	Percentage of customers actively using feature
`AdoptionOfDeployed()`	Adoption rate among deployed customers
`IsFullyDeployed()`	Returns true if all customers have feature

Go Usage:

import "github.com/grokify/structured-plan/roadmap"

deliverable := roadmap.Deliverable{
    ID:    "D-001",
    Title: "SSO Integration",
    Rollout: &roadmap.RolloutStatus{
        TotalCustomers:    150,
        DeployedCustomers: 120,
        AdoptedCustomers:  95,
        Status:            roadmap.RolloutStageRollingOut,
    },
}

fmt.Printf("Deployment: %.1f%%\n", deliverable.Rollout.DeploymentPercent())  // 80.0%
fmt.Printf("Adoption: %.1f%%\n", deliverable.Rollout.AdoptionPercent())      // 63.3%
fmt.Printf("Adoption of Deployed: %.1f%%\n", deliverable.Rollout.AdoptionOfDeployed()) // 79.2%

RolloutStatus Fields:

Field	Required	Description
`totalCustomers`	Yes	Total customers in rollout scope
`deployedCustomers`	Yes	Customers with feature available
`adoptedCustomers`	No	Customers actively using feature
`status`	No	Current rollout stage
`startDate`	No	Rollout start date (ISO 8601)
`targetDate`	No	Target completion date
`notes`	No	Rollout notes
`waves`	No	Phased rollout waves

RolloutWave Fields:

Field	Required	Description
`id`	Yes	Wave identifier
`name`	Yes	Wave name (e.g., "Beta", "GA Wave 1")
`targetCustomers`	Yes	Customers targeted for this wave
`deployedCustomers`	No	Customers deployed in this wave
`startDate`	No	Wave start date
`endDate`	No	Wave end date
`status`	No	`planned`, `in_progress`, `completed`

PRD Schema Updates¶

The PRD JSON schema now includes the ComplianceRequirement type for regulatory standards tracking, complementing the runtime types added in v0.9.0.

Dependencies¶

Updated github.com/invopop/jsonschema from 0.13.0 to 0.14.0

Installation¶

Homebrew (macOS/Linux)¶

brew upgrade grokify/tap/splan

Go Install¶

go install github.com/grokify/structured-plan/cmd/splan@v0.10.0

Go Module¶

go get github.com/grokify/structured-plan@v0.10.0

Full Changelog¶

See CHANGELOG.md for complete details.