Skip to content

Add version metadata to shipped roadmap milestones#1927

Merged
aknysh merged 10 commits intomainfrom
osterman/roadmap-version-metadata
Jan 2, 2026
Merged

Add version metadata to shipped roadmap milestones#1927
aknysh merged 10 commits intomainfrom
osterman/roadmap-version-metadata

Conversation

@osterman
Copy link
Member

@osterman osterman commented Jan 2, 2026

what

Added an optional version field to all 93 shipped milestones in the roadmap, indicating which release each feature was shipped in. Versions are sourced from blog post release: fields and git history research using git tags.

why

Version metadata enables better tracking of feature releases, supports release notes generation, and provides users with a clear version reference for each shipped feature on the roadmap.

references

  • Versions derived from blog post frontmatter (release: field)
  • Git history research using git describe --tags for features without blog post references
  • Version range: v1.100.0 (Changelog introduction) to v1.203.0 (RC features)

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Chores
    • Roadmap milestones now include optional version identifiers so items map directly to releases across multiple quarters.
  • New Features
    • Roadmap UI displays a release link when a milestone has a version, enabling quick access to the corresponding release.
  • Style
    • Added a compact version badge/visual treatment in roadmap drawers for clearer discoverability.

✏️ Tip: You can customize this high-level summary in your review settings.

Added an optional `version` field to all 93 shipped milestones in the roadmap, indicating which release each feature was shipped in. Versions are sourced from blog post `release:` fields and git history research.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
@osterman osterman requested a review from a team as a code owner January 2, 2026 04:07
@github-actions github-actions bot added the size/m Medium size PR label Jan 2, 2026
@github-actions
Copy link

github-actions bot commented Jan 2, 2026

Dependency Review

✅ No vulnerabilities or license issues found.

Scanned Files

None

@codecov
Copy link

codecov bot commented Jan 2, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.59%. Comparing base (0d6b544) to head (c652196).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main    #1927      +/-   ##
==========================================
- Coverage   73.60%   73.59%   -0.02%     
==========================================
  Files         744      744              
  Lines       67665    67665              
==========================================
- Hits        49802    49795       -7     
- Misses      14474    14484      +10     
+ Partials     3389     3386       -3     
Flag Coverage Δ
unittests 73.59% <ø> (-0.02%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 2 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 2, 2026

📝 Walkthrough

Walkthrough

Adds an optional version: string to roadmap milestone objects and surfaces it in roadmap UI components (FeaturedDrawer, MilestoneDrawer, MilestoneList) as a conditional GitHub release link. Also adds a CSS class for version metadata styling. No other behavioral changes.

Changes

Cohort / File(s) Summary
Roadmap data
website/src/data/roadmap.js
Added optional version values to many milestone objects across quarters (e.g., v1.196.0, v1.198.0, v1.199.0, v1.201.0, v1.202.0), augmenting milestone data shape.
Featured drawer
website/src/components/Roadmap/FeaturedDrawer.tsx
FeaturedItem interface: added version?: string; drawer metadata conditionally renders a GitHub release link when present.
Milestone drawer
website/src/components/Roadmap/MilestoneDrawer.tsx
Conditionally renders a GitHub release link for milestone.version with target="_blank" and rel="noopener noreferrer".
Milestone list/types
website/src/components/Roadmap/MilestoneList.tsx
Milestone interface: added version?: string; types accept optional version.
Styles
website/src/components/Roadmap/styles.module.css
Added .drawerMetaVersion class with theme-aware styling and hover state for version metadata.

Sequence Diagram(s)

(omitted — UI-only conditional rendering; no multi-component sequential flow requiring a diagram)

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested labels

minor

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. You can run @coderabbitai generate docstrings to improve docstring coverage.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding version metadata to shipped roadmap milestones, which aligns with the changeset's core objective across data and UI components.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch osterman/roadmap-version-metadata

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (1)
website/src/data/roadmap.js (1)

117-393: Excellent work on the initiative milestones.

The version metadata has been added consistently across all 9 initiatives. Pattern is clean:

  • All shipped milestones have versions
  • In-progress and planned milestones correctly omit versions
  • Semantic versioning format is consistent throughout
  • Coverage appears complete based on the PR's stated 93 shipped milestones

The data structure enhancement is straightforward and non-breaking. This will be valuable for release notes generation and user reference.

Optional: Consider adding a validation script

To maintain this pattern in future updates, you could add a simple validation script that verifies:

  • All status: 'shipped' items have a version field
  • All versions follow semantic versioning format
  • No non-shipped items have versions
#!/bin/bash
# Verify version metadata consistency in roadmap.js

# Check for shipped items without versions
ast-grep --pattern $'status: \'shipped\',$$$' | grep -v 'version:'

# Check version format (basic pattern match)
rg -n "version: '[^v]" website/src/data/roadmap.js

This is purely optional - the current changes are solid.

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between e3a3d44 and eb5a24c.

📒 Files selected for processing (1)
  • website/src/data/roadmap.js
🧰 Additional context used
📓 Path-based instructions (2)
website/**

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

website/**: Update website documentation in the website/ directory when adding new features, ensure consistency between CLI help text and website documentation, and follow the website's documentation structure and style
Keep website code in the website/ directory, follow the existing website architecture and style, and test website changes locally before committing
Keep CLI documentation and website documentation in sync and document new features on the website with examples and use cases

Files:

  • website/src/data/roadmap.js
website/src/data/roadmap.js

📄 CodeRabbit inference engine (CLAUDE.md)

For PRs labeled minor/major, update roadmap.js: add milestone to relevant initiative with status: 'shipped', link to changelog with changelog: 'your-blog-slug', link to PR with pr: <pr-number>, update initiative progress percentage as (shipped milestones / total milestones) * 100

Files:

  • website/src/data/roadmap.js
🧠 Learnings (7)
📓 Common learnings
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Applies to website/src/data/roadmap.js : For PRs labeled `minor`/`major`, update roadmap.js: add milestone to relevant initiative with `status: 'shipped'`, link to changelog with `changelog: 'your-blog-slug'`, link to PR with `pr: <pr-number>`, update initiative `progress` percentage as `(shipped milestones / total milestones) * 100`
Learnt from: Listener430
Repo: cloudposse/atmos PR: 934
File: tests/fixtures/scenarios/docs-generate/README.md.gotmpl:99-118
Timestamp: 2025-01-25T03:51:57.689Z
Learning: For the cloudposse/atmos repository, changes to template contents should be handled in dedicated PRs and are typically considered out of scope for PRs focused on other objectives.
Learnt from: osterman
Repo: cloudposse/atmos PR: 1686
File: docs/prd/tool-dependencies-integration.md:58-64
Timestamp: 2025-12-13T06:07:37.766Z
Learning: cloudposse/atmos: For PRD docs (docs/prd/*.md), markdownlint issues like MD040/MD010/MD034 can be handled in a separate documentation cleanup commit and should not block the current PR.
Learnt from: osterman
Repo: cloudposse/atmos PR: 801
File: examples/quick-start-advanced/Dockerfile:9-9
Timestamp: 2024-11-23T00:13:22.004Z
Learning: When updating the `ATMOS_VERSION` in Dockerfiles, the team prefers to pin to the next future version when the PR merges, even if the version is not yet released.
📚 Learning: 2026-01-01T18:25:25.942Z
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Applies to website/src/data/roadmap.js : For PRs labeled `minor`/`major`, update roadmap.js: add milestone to relevant initiative with `status: 'shipped'`, link to changelog with `changelog: 'your-blog-slug'`, link to PR with `pr: <pr-number>`, update initiative `progress` percentage as `(shipped milestones / total milestones) * 100`

Applied to files:

  • website/src/data/roadmap.js
📚 Learning: 2024-10-31T01:22:09.586Z
Learnt from: osterman
Repo: cloudposse/atmos PR: 737
File: examples/demo-vendoring/vendor.d/vendor1.yaml:10-11
Timestamp: 2024-10-31T01:22:09.586Z
Learning: In `examples/demo-vendoring/vendor.d/vendor1.yaml`, when specifying the source for the `ipinfo` component, it's acceptable to use `main` as the version reference if pinning to a specific version is not practical.

Applied to files:

  • website/src/data/roadmap.js
📚 Learning: 2025-04-25T20:54:19.701Z
Learnt from: mcalhoun
Repo: cloudposse/atmos PR: 963
File: website/docs/core-concepts/projects/configuration/stores.mdx:286-286
Timestamp: 2025-04-25T20:54:19.701Z
Learning: For the AWS SSM Parameter Store implementation in Atmos, support for `read_role_arn` and `write_role_arn` options is essential to enable cross-account access, allowing users to run operations like `terraform plan` in multiple accounts while accessing values across keystores. Azure Key Vault would need similar capabilities for cross-tenant/subscription authentication.

Applied to files:

  • website/src/data/roadmap.js
📚 Learning: 2025-12-13T06:07:37.766Z
Learnt from: osterman
Repo: cloudposse/atmos PR: 1686
File: docs/prd/tool-dependencies-integration.md:58-64
Timestamp: 2025-12-13T06:07:37.766Z
Learning: cloudposse/atmos: For PRD docs (docs/prd/*.md), markdownlint issues like MD040/MD010/MD034 can be handled in a separate documentation cleanup commit and should not block the current PR.

Applied to files:

  • website/src/data/roadmap.js
📚 Learning: 2025-01-17T00:18:57.769Z
Learnt from: aknysh
Repo: cloudposse/atmos PR: 944
File: go.mod:206-206
Timestamp: 2025-01-17T00:18:57.769Z
Learning: For indirect dependencies with license compliance issues in the cloudposse/atmos repository, the team prefers to handle them in follow-up PRs rather than blocking the current changes, as these issues often require deeper investigation of the dependency tree.

Applied to files:

  • website/src/data/roadmap.js
📚 Learning: 2026-01-01T18:25:25.942Z
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Stack pipeline: Load atmos.yaml → process imports/inheritance → apply overrides → render templates → generate config. Templates use Go templates + Gomplate with `atmos.Component()`, `!terraform.state`, `!terraform.output`, store integration

Applied to files:

  • website/src/data/roadmap.js
⏰ Context from checks skipped due to timeout of 900000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
  • GitHub Check: Acceptance Tests (macos)
  • GitHub Check: Acceptance Tests (windows)
  • GitHub Check: Summary
🔇 Additional comments (1)
website/src/data/roadmap.js (1)

33-115: Featured section looks great.

All shipped featured items have version metadata added consistently. The in-progress workflow item correctly doesn't have a version. Format follows semantic versioning throughout.

coderabbitai[bot]
coderabbitai bot previously approved these changes Jan 2, 2026
- Add optional version field to Milestone interface
- Show version between quarter and status badges in drawer
- Style version badge with monospace font and subtle background

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Version badge now links to GitHub releases page for that version
- Added hover styles for clickable version badge
- Opens in new tab with proper security attributes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
osterman and others added 2 commits January 1, 2026 23:09
- Add optional version field to FeaturedItem interface
- Display version badge with link in featured item drawer
- Consistent with MilestoneDrawer version display

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Process/practice improvements don't correspond to specific Atmos releases:
- Test coverage improvements (ongoing effort)
- Nightly releases (existed before attributed version)
- Weekly release cadence (process change)
- Claude Code/CodeRabbit integration (tooling)
- PR feature releases (CI/CD process)
- Fixed Changelog version: v1.198.0 (first blog post date)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Removed all unverified version fields (87 → 31)
- Only keeping versions for items with changelog slugs that have
  a verified `release:` field in their corresponding blog post
- Each version now traceable to its source blog post

Verified versions by changelog slug:
- introducing-atmos-auth → v1.196.0
- azure-authentication-support → v1.199.0
- flexible-keyring-backends → v1.196.0
- authentication-for-workflows-and-custom-commands → v1.197.0
- atmos-auth-shell → v1.196.0
- describe-commands-identity-flag → v1.197.0
- zero-config-terminal-output → v1.198.0
- introducing-chdir-flag → v1.195.0
- parent-directory-search-and-git-root-discovery → v1.198.0
- atmos-profiles → v1.199.0
- component-aware-stack-completion → v1.198.0
- terminal-themes → v1.198.0
- theme-aware-help → v1.200.0
- helpful-errors → v1.199.0
- provenance-tracking → v1.195.0
- env-function-stack-manifest-support → v1.199.0
- yaml-function-circular-dependency-detection → v1.196.0
- comprehensive-version-management-documentation → v1.199.0
- native-devcontainer-support → v1.201.0

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Based on PR merge dates correlated with release tags:

v1.202.0 (6 items):
- interactive-flag-prompts
- automatic-backend-provisioning
- global-env-section
- workflow-file-auto-discovery
- literal-yaml-function
- file-scoped-locals

v1.201.0 (5 items):
- path-based-component-resolution
- metadata-inheritance
- customizable-list-command-output
- custom-command-boolean-flags
- version-constraint-validation

Also fixes status for:
- Unified task execution: shipped → in-progress (PR #1901 not merged)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@osterman osterman added the no-release Do not create a new release (wait for additional code changes) label Jan 2, 2026
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between eb5a24c and 02b640e.

📒 Files selected for processing (5)
  • website/src/components/Roadmap/FeaturedDrawer.tsx
  • website/src/components/Roadmap/MilestoneDrawer.tsx
  • website/src/components/Roadmap/MilestoneList.tsx
  • website/src/components/Roadmap/styles.module.css
  • website/src/data/roadmap.js
🧰 Additional context used
📓 Path-based instructions (2)
website/**

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

website/**: Update website documentation in the website/ directory when adding new features, ensure consistency between CLI help text and website documentation, and follow the website's documentation structure and style
Keep website code in the website/ directory, follow the existing website architecture and style, and test website changes locally before committing
Keep CLI documentation and website documentation in sync and document new features on the website with examples and use cases

Files:

  • website/src/components/Roadmap/MilestoneDrawer.tsx
  • website/src/components/Roadmap/MilestoneList.tsx
  • website/src/data/roadmap.js
  • website/src/components/Roadmap/FeaturedDrawer.tsx
  • website/src/components/Roadmap/styles.module.css
website/src/data/roadmap.js

📄 CodeRabbit inference engine (CLAUDE.md)

For PRs labeled minor/major, update roadmap.js: add milestone to relevant initiative with status: 'shipped', link to changelog with changelog: 'your-blog-slug', link to PR with pr: <pr-number>, update initiative progress percentage as (shipped milestones / total milestones) * 100

Files:

  • website/src/data/roadmap.js
🧠 Learnings (4)
📓 Common learnings
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Applies to website/src/data/roadmap.js : For PRs labeled `minor`/`major`, update roadmap.js: add milestone to relevant initiative with `status: 'shipped'`, link to changelog with `changelog: 'your-blog-slug'`, link to PR with `pr: <pr-number>`, update initiative `progress` percentage as `(shipped milestones / total milestones) * 100`
Learnt from: osterman
Repo: cloudposse/atmos PR: 1686
File: docs/prd/tool-dependencies-integration.md:58-64
Timestamp: 2025-12-13T06:07:37.766Z
Learning: cloudposse/atmos: For PRD docs (docs/prd/*.md), markdownlint issues like MD040/MD010/MD034 can be handled in a separate documentation cleanup commit and should not block the current PR.
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Follow pull request template (what/why/references); PRs labeled `minor`/`major` MUST include blog post in `website/blog/YYYY-MM-DD-feature-name.mdx`; use `no-release` label for docs-only changes
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: .cursor/rules/atmos-rules.mdc:0-0
Timestamp: 2025-11-24T17:35:37.209Z
Learning: Applies to CHANGELOG.md : Follow semantic versioning, update CHANGELOG.md with each release, and create GitHub releases with detailed release notes
📚 Learning: 2026-01-01T18:25:25.942Z
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Applies to website/src/data/roadmap.js : For PRs labeled `minor`/`major`, update roadmap.js: add milestone to relevant initiative with `status: 'shipped'`, link to changelog with `changelog: 'your-blog-slug'`, link to PR with `pr: <pr-number>`, update initiative `progress` percentage as `(shipped milestones / total milestones) * 100`

Applied to files:

  • website/src/components/Roadmap/MilestoneDrawer.tsx
  • website/src/components/Roadmap/MilestoneList.tsx
  • website/src/data/roadmap.js
📚 Learning: 2025-01-17T00:18:57.769Z
Learnt from: aknysh
Repo: cloudposse/atmos PR: 944
File: go.mod:206-206
Timestamp: 2025-01-17T00:18:57.769Z
Learning: For indirect dependencies with license compliance issues in the cloudposse/atmos repository, the team prefers to handle them in follow-up PRs rather than blocking the current changes, as these issues often require deeper investigation of the dependency tree.

Applied to files:

  • website/src/data/roadmap.js
📚 Learning: 2025-12-13T06:07:37.766Z
Learnt from: osterman
Repo: cloudposse/atmos PR: 1686
File: docs/prd/tool-dependencies-integration.md:58-64
Timestamp: 2025-12-13T06:07:37.766Z
Learning: cloudposse/atmos: For PRD docs (docs/prd/*.md), markdownlint issues like MD040/MD010/MD034 can be handled in a separate documentation cleanup commit and should not block the current PR.

Applied to files:

  • website/src/data/roadmap.js
🪛 Biome (2.1.2)
website/src/data/roadmap.js

[error] 70-71: This property is later overwritten by an object member with the same name.

Overwritten with this property.

If an object property with the same name is defined multiple times (except when combining a getter with a setter), only the last definition makes it into the object and previous definitions are ignored.
Unsafe fix: Remove this property.

(lint/suspicious/noDuplicateObjectKeys)

⏰ Context from checks skipped due to timeout of 900000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
  • GitHub Check: Acceptance Tests (linux)
  • GitHub Check: Acceptance Tests (macos)
  • GitHub Check: Acceptance Tests (windows)
  • GitHub Check: Summary
🔇 Additional comments (7)
website/src/data/roadmap.js (2)

126-145: Version metadata additions look solid.

Consistent format, linked to shipped milestones with changelog references. The auth initiative entries are well-documented.


226-231: Status adjustments align with PR description.

"New workflow step types" and "Unified task execution" correctly moved to in-progress since their PRs haven't merged yet.

website/src/components/Roadmap/MilestoneDrawer.tsx (1)

176-185: Clean implementation.

Conditional render, proper external link attributes, consistent with the drawer's existing patterns.

website/src/components/Roadmap/MilestoneList.tsx (1)

11-12: Interface extension is well-typed.

Optional field with clear documentation. Clean addition to support the version metadata feature.

website/src/components/Roadmap/FeaturedDrawer.tsx (2)

17-18: Interface addition mirrors MilestoneList—consistent approach.


189-198: Version link rendering follows the same pattern as MilestoneDrawer.

Consistent UX across both drawer types. External link security is handled correctly.

website/src/components/Roadmap/styles.module.css (1)

1925-1951: Styling is thorough and theme-aware.

Covers all states: default, hover, light/dark variants. Monospace font for version strings is a nice touch. Consistent with existing drawer meta elements.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

♻️ Duplicate comments (1)
website/src/data/roadmap.js (1)

70-73: Duplicate version key appears fixed.

The previous duplicate version declaration has been resolved. Line 70 and line 72 now contain distinct properties without repetition.

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 02b640e and c187eb7.

📒 Files selected for processing (1)
  • website/src/data/roadmap.js
🧰 Additional context used
📓 Path-based instructions (2)
website/**

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

website/**: Update website documentation in the website/ directory when adding new features, ensure consistency between CLI help text and website documentation, and follow the website's documentation structure and style
Keep website code in the website/ directory, follow the existing website architecture and style, and test website changes locally before committing
Keep CLI documentation and website documentation in sync and document new features on the website with examples and use cases

Files:

  • website/src/data/roadmap.js
website/src/data/roadmap.js

📄 CodeRabbit inference engine (CLAUDE.md)

For PRs labeled minor/major, update roadmap.js: add milestone to relevant initiative with status: 'shipped', link to changelog with changelog: 'your-blog-slug', link to PR with pr: <pr-number>, update initiative progress percentage as (shipped milestones / total milestones) * 100

Files:

  • website/src/data/roadmap.js
🧠 Learnings (4)
📓 Common learnings
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Applies to website/src/data/roadmap.js : For PRs labeled `minor`/`major`, update roadmap.js: add milestone to relevant initiative with `status: 'shipped'`, link to changelog with `changelog: 'your-blog-slug'`, link to PR with `pr: <pr-number>`, update initiative `progress` percentage as `(shipped milestones / total milestones) * 100`
Learnt from: osterman
Repo: cloudposse/atmos PR: 1686
File: docs/prd/tool-dependencies-integration.md:58-64
Timestamp: 2025-12-13T06:07:37.766Z
Learning: cloudposse/atmos: For PRD docs (docs/prd/*.md), markdownlint issues like MD040/MD010/MD034 can be handled in a separate documentation cleanup commit and should not block the current PR.
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Follow pull request template (what/why/references); PRs labeled `minor`/`major` MUST include blog post in `website/blog/YYYY-MM-DD-feature-name.mdx`; use `no-release` label for docs-only changes
📚 Learning: 2026-01-01T18:25:25.942Z
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Applies to website/src/data/roadmap.js : For PRs labeled `minor`/`major`, update roadmap.js: add milestone to relevant initiative with `status: 'shipped'`, link to changelog with `changelog: 'your-blog-slug'`, link to PR with `pr: <pr-number>`, update initiative `progress` percentage as `(shipped milestones / total milestones) * 100`

Applied to files:

  • website/src/data/roadmap.js
📚 Learning: 2025-01-17T00:18:57.769Z
Learnt from: aknysh
Repo: cloudposse/atmos PR: 944
File: go.mod:206-206
Timestamp: 2025-01-17T00:18:57.769Z
Learning: For indirect dependencies with license compliance issues in the cloudposse/atmos repository, the team prefers to handle them in follow-up PRs rather than blocking the current changes, as these issues often require deeper investigation of the dependency tree.

Applied to files:

  • website/src/data/roadmap.js
📚 Learning: 2025-12-13T06:07:37.766Z
Learnt from: osterman
Repo: cloudposse/atmos PR: 1686
File: docs/prd/tool-dependencies-integration.md:58-64
Timestamp: 2025-12-13T06:07:37.766Z
Learning: cloudposse/atmos: For PRD docs (docs/prd/*.md), markdownlint issues like MD040/MD010/MD034 can be handled in a separate documentation cleanup commit and should not block the current PR.

Applied to files:

  • website/src/data/roadmap.js
⏰ Context from checks skipped due to timeout of 900000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
  • GitHub Check: Acceptance Tests (macos)
  • GitHub Check: Acceptance Tests (windows)
  • GitHub Check: Acceptance Tests (linux)
  • GitHub Check: Summary
🔇 Additional comments (3)
website/src/data/roadmap.js (3)

43-43: Version string format is consistent.

All version fields follow the v1.XXX.0 semantic versioning pattern with proper leading 'v' prefix. Format is applied consistently across all ~31 versioned milestones spanning v1.195.0 through v1.202.0.

Also applies to: 70-70, 126-142, 164-186, 208-209, 228-230, 255-264, 285-336, 379-387


126-142: Optional version field is properly handled across all consuming components.

TypeScript interfaces in MilestoneList.tsx and FeaturedDrawer.tsx correctly define version?: string. Both MilestoneDrawer.tsx and FeaturedDrawer.tsx safely access the field with conditional rendering ({milestone.version && ...}), preventing undefined reference issues. No changes needed.


228-228: Verify when v1.202.0 was actually released. The feature assignment to v1.202.0 is correct, but the Q3-2025 quarter requires confirmation against Atmos release history. Check the release timeline to determine if v1.202.0 shipped in Q3-2025 or if the quarter should be updated.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

♻️ Duplicate comments (1)
website/src/data/roadmap.js (1)

132-192: Reconcile PR objectives with actual version coverage.

The PR description states "Adds an optional version field to all 93 shipped milestones," but many shipped items throughout the file still lack version fields (e.g., lines 134-135, 145-147, 176, 188-189). The verification script from the previous review showed only ~42 of 95 shipped milestones have versions.

Your documentation comment (lines 14-16) acknowledges this gap, which is good. However, consider either:

  • Updating the PR description to reflect actual coverage
  • Adding versions to the remaining shipped items through additional research
🧹 Nitpick comments (1)
website/src/data/roadmap.js (1)

49-390: Consider consistent field ordering for version metadata.

The version field appears in varying positions within milestone objects—sometimes after quarter, sometimes after changelog, sometimes elsewhere. While this doesn't affect functionality, consistent placement would improve readability.

Suggestion: Place version consistently (e.g., always after quarter or always after changelog).

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between c187eb7 and c652196.

📒 Files selected for processing (1)
  • website/src/data/roadmap.js
🧰 Additional context used
📓 Path-based instructions (2)
website/**

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

website/**: Update website documentation in the website/ directory when adding new features, ensure consistency between CLI help text and website documentation, and follow the website's documentation structure and style
Keep website code in the website/ directory, follow the existing website architecture and style, and test website changes locally before committing
Keep CLI documentation and website documentation in sync and document new features on the website with examples and use cases

Files:

  • website/src/data/roadmap.js
website/src/data/roadmap.js

📄 CodeRabbit inference engine (CLAUDE.md)

For PRs labeled minor/major, update roadmap.js: add milestone to relevant initiative with status: 'shipped', link to changelog with changelog: 'your-blog-slug', link to PR with pr: <pr-number>, update initiative progress percentage as (shipped milestones / total milestones) * 100

Files:

  • website/src/data/roadmap.js
🧠 Learnings (5)
📓 Common learnings
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Applies to website/src/data/roadmap.js : For PRs labeled `minor`/`major`, update roadmap.js: add milestone to relevant initiative with `status: 'shipped'`, link to changelog with `changelog: 'your-blog-slug'`, link to PR with `pr: <pr-number>`, update initiative `progress` percentage as `(shipped milestones / total milestones) * 100`
Learnt from: osterman
Repo: cloudposse/atmos PR: 1686
File: docs/prd/tool-dependencies-integration.md:58-64
Timestamp: 2025-12-13T06:07:37.766Z
Learning: cloudposse/atmos: For PRD docs (docs/prd/*.md), markdownlint issues like MD040/MD010/MD034 can be handled in a separate documentation cleanup commit and should not block the current PR.
Learnt from: Listener430
Repo: cloudposse/atmos PR: 934
File: tests/fixtures/scenarios/docs-generate/README.md.gotmpl:99-118
Timestamp: 2025-01-25T03:51:57.689Z
Learning: For the cloudposse/atmos repository, changes to template contents should be handled in dedicated PRs and are typically considered out of scope for PRs focused on other objectives.
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Follow pull request template (what/why/references); PRs labeled `minor`/`major` MUST include blog post in `website/blog/YYYY-MM-DD-feature-name.mdx`; use `no-release` label for docs-only changes
📚 Learning: 2026-01-01T18:25:25.942Z
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Applies to website/src/data/roadmap.js : For PRs labeled `minor`/`major`, update roadmap.js: add milestone to relevant initiative with `status: 'shipped'`, link to changelog with `changelog: 'your-blog-slug'`, link to PR with `pr: <pr-number>`, update initiative `progress` percentage as `(shipped milestones / total milestones) * 100`

Applied to files:

  • website/src/data/roadmap.js
📚 Learning: 2025-12-13T06:07:37.766Z
Learnt from: osterman
Repo: cloudposse/atmos PR: 1686
File: docs/prd/tool-dependencies-integration.md:58-64
Timestamp: 2025-12-13T06:07:37.766Z
Learning: cloudposse/atmos: For PRD docs (docs/prd/*.md), markdownlint issues like MD040/MD010/MD034 can be handled in a separate documentation cleanup commit and should not block the current PR.

Applied to files:

  • website/src/data/roadmap.js
📚 Learning: 2025-01-17T00:18:57.769Z
Learnt from: aknysh
Repo: cloudposse/atmos PR: 944
File: go.mod:206-206
Timestamp: 2025-01-17T00:18:57.769Z
Learning: For indirect dependencies with license compliance issues in the cloudposse/atmos repository, the team prefers to handle them in follow-up PRs rather than blocking the current changes, as these issues often require deeper investigation of the dependency tree.

Applied to files:

  • website/src/data/roadmap.js
📚 Learning: 2026-01-01T18:25:25.942Z
Learnt from: CR
Repo: cloudposse/atmos PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-01T18:25:25.942Z
Learning: Stack pipeline: Load atmos.yaml → process imports/inheritance → apply overrides → render templates → generate config. Templates use Go templates + Gomplate with `atmos.Component()`, `!terraform.state`, `!terraform.output`, store integration

Applied to files:

  • website/src/data/roadmap.js
⏰ Context from checks skipped due to timeout of 900000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
  • GitHub Check: Acceptance Tests (windows)
  • GitHub Check: Acceptance Tests (macos)
  • GitHub Check: Summary
🔇 Additional comments (1)
website/src/data/roadmap.js (1)

12-18: Clear documentation of version metadata strategy.

The comment block effectively explains the version field's purpose, data sources, and coverage gaps. This will help future maintainers understand the partial coverage.

@aknysh aknysh merged commit fc38133 into main Jan 2, 2026
57 checks passed
@aknysh aknysh deleted the osterman/roadmap-version-metadata branch January 2, 2026 21:53
@github-actions
Copy link

github-actions bot commented Jan 2, 2026

These changes were released in v1.203.0.

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

Labels

no-release Do not create a new release (wait for additional code changes) size/m Medium size PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants