Skip to content

Graduate lockfile from experimental to stable#1

Draft
brooke-hamilton wants to merge 10 commits intomainfrom
brooke-hamilton/graduate-lockfile
Draft

Graduate lockfile from experimental to stable#1
brooke-hamilton wants to merge 10 commits intomainfrom
brooke-hamilton/graduate-lockfile

Conversation

@brooke-hamilton
Copy link
Copy Markdown
Owner

This pull request graduates lockfile support from experimental to stable, making lockfile generation the default behavior during build and up operations. It introduces new flags to control lockfile handling, deprecates the old experimental flags, and updates the documentation and codebase to reflect these changes. The CLI now enforces mutual exclusivity between lockfile-related flags and provides clear user warnings for deprecated options.

Lockfile feature graduation and CLI changes:

  • Lockfiles (.devcontainer-lock.json) are now generated by default on build and up for reproducible builds. The new --no-lockfile flag disables lockfile generation, while --frozen-lockfile ensures the lockfile exists and is unchanged. The experimental flags --experimental-lockfile and --experimental-frozen-lockfile are deprecated but still accepted with a warning. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

  • The CLI enforces that --no-lockfile cannot be used together with any of the (deprecated or stable) lockfile-enforcing flags. [1] [2]

  • Deprecated flags now trigger warnings to inform users of the new defaults and recommended options.

Codebase and API updates:

  • Internal parameters, interfaces, and function signatures are updated to use noLockfile and frozenLockfile instead of the experimental flags, and all related logic is refactored accordingly. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11]

  • The lockfile write and read logic is updated to support the new flags and behavior, and to throw errors or skip writing as appropriate. [1] [2] [3] [4] [5] [6] [7]

Documentation and tooling:

  • Documentation is updated to describe the new default lockfile behavior, usage of new flags, and deprecation of the old flags. [1] [2] [3]

  • Adds the Mocha Test Adapter extension to the devcontainer for improved test integration in VS Code.

  • Bumps package version to 0.87.0 to reflect these changes.

brooke-hamilton and others added 9 commits April 26, 2026 17:05
Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
…ate-lockfile

Bring in the 0.86.1 fix that excludes `--additional-features`-only
features from the lockfile, and integrate it with the lockfile
graduation work on this branch.

Conflict resolution:
- src/spec-configuration/containerFeaturesConfiguration.ts:
  Drop the `initLockfile` argument from the `writeLockfile` call.
  The graduation work removed `forceInitLockfile` from
  `writeLockfile` and `initLockfile` from `readLockfile`'s return,
  so the incoming reference no longer compiles. The remaining
  `generateLockfile(featuresConfig, config, additionalFeatures)`
  call from main is preserved inside the `!params.noLockfile` guard.

Other reconciliations:
- package.json: keep 0.87.0 (graduation release) instead of 0.86.1
  so the version reflects the graduation feature set being shipped.
- CHANGELOG.md: move the 0.87.0 graduation entry under "May 2026"
  and nest the 0.86.1 bullet beneath it for historical accuracy.

Signed-off-by: Brooke Hamilton <Brooke.Hamilton+microsoft@microsoft.com>
Signed-off-by: Brooke Hamilton <Brooke.Hamilton+microsoft@microsoft.com>
Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant