package_json 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f527631df066948ba8540040c1979df5555cf1493a2c9e9b2b27bb07fcab8b6
-  data.tar.gz: cad2ae8ff9ec1502d0c9674416a036740394e61a834887b8abdebb038ade2cd0
+  metadata.gz: f55805d478e11aa4c918eb7b8acd0b1dc2dfead0488cc931f50a10a1b0b4ea18
+  data.tar.gz: 727ce06575bfe624628999e5ad6ef18b07caf10c4bad32af75a8fb78837b4f6d
 SHA512:
-  metadata.gz: 1528327c30b61584871ced376ee3d2baf656c7a5d46b053f901e66bc296cfeee432145b24fafc5c92c4cac17c16111594a834aac4e54520796362992c42a842d
-  data.tar.gz: 624ca23fea5c8afd0758f3240677630a2f4c28bc432a26242d23a990e3efa58d6a5727f7f521c171644fbd6effa41483a79e217bfb2608de9700009bc4ace60c
+  metadata.gz: 876cae7108678cb22b42c15e8fa68a65e301235b4420309a077410dc06fc311a531335d0d5382c581477d70e2cd96dabc5f7177b2be05c05f7b9d623ae19ef97
+  data.tar.gz: f91171d95c197651ee4257d0beb728d9b5c504cd2d3290a8bfae5a36d1d18163108ec119a17c04408c3bf9c9c7fec0da8600b909a6f44989f9b4c8b477bac8ff

data/.claude/commands/update-changelog.md

@@ -0,0 +1,255 @@
+# Update Changelog
+
+You are helping to add an entry to the CHANGELOG.md file for the PackageJson
+project.
+
+## Critical Requirements
+
+1. **User-visible changes only**: Only add changelog entries for user-visible
+   changes:
+   - New features
+   - Bug fixes
+   - Breaking changes
+   - Deprecations
+   - Performance improvements
+   - Security fixes
+   - Changes to public APIs or configuration options
+
+2. **Do NOT add entries for**:
+   - Linting fixes
+   - Code formatting
+   - Internal refactoring
+   - Test updates
+   - Documentation fixes (unless they fix incorrect docs about behavior)
+   - CI/CD changes
+
+## Formatting Requirements
+
+### Entry Format
+
+Each changelog entry MUST follow this exact format:
+
+```markdown
+- **Bold description of change**.
+  [PR 1818](https://github.com/shakacode/package_json/pull/1818) by
+  [username](https://github.com/username). Optional additional context or
+  details.
+```
+
+**Important formatting rules**:
+
+- Start with a dash and space: `- `
+- Use **bold** for the main description
+- End the bold description with a period before the link
+- Always link to the PR:
+  `[PR 1818](https://github.com/shakacode/package_json/pull/1818)` - **NO hash
+  symbol**
+- Always link to the author: `by [username](https://github.com/username)`
+- End with a period after the author link
+- Additional details can be added after the main entry, using proper indentation
+  for multi-line entries
+
+### Breaking Changes Format
+
+For breaking changes, use this format:
+
+```markdown
+- **Feature Name**: Description of the breaking change. See migration guide
+  below. [PR 1818](https://github.com/shakacode/package_json/pull/1818) by
+  [username](https://github.com/username).
+
+**Migration Guide:**
+
+1. Step one
+2. Step two
+```
+
+### Category Organization
+
+Entries should be organized under these section headings. The project uses both
+standard and custom headings:
+
+**Standard headings** (from keepachangelog.com) - use these for most changes:
+
+- `#### Added` - New features
+- `#### Changed` - Changes to existing functionality
+- `#### Deprecated` - Deprecation notices
+- `#### Removed` - Removed features
+- `#### Fixed` - Bug fixes
+- `#### Security` - Security-related changes
+- `#### Improved` - Improvements to existing features
+
+**Custom headings** (project-specific) - use sparingly when standard headings
+don't fit:
+
+- `#### Breaking Changes` - Breaking changes with migration guides
+- `#### Performance` - Performance improvements
+
+**Prefer standard headings.** Only use custom headings when the change needs
+more specific categorization.
+
+**Only include section headings that have entries.**
+
+### Version Management
+
+After adding entries, use the rake task to manage version headers:
+
+```bash
+bundle exec rake update_changelog
+```
+
+This will:
+
+- Add headers for the new version
+- Update version diff links at the bottom of the file
+
+## Process
+
+### For Regular Changelog Updates
+
+1. **Determine the correct version tag to compare against**:
+   - First, check the tag dates:
+     `git log --tags --simplify-by-decoration --pretty="format:%ai %d" | head -10`
+   - Find the latest version tag and its date
+   - Compare main branch date to the tag date
+   - If the tag is NEWER than main, it means main needs to be updated to include
+     the tag's commits
+   - **CRITICAL**: Always use `git log TAG..BRANCH` to find commits that are in
+     the tag but not in the branch, as the tag may be ahead
+
+2. **Check commits and version boundaries**:
+   - Run `git log --oneline LAST_TAG..main` to see commits since the last
+     release
+   - Also check `git log --oneline main..LAST_TAG` to see if the tag is ahead of
+     main
+   - If the tag is ahead, entries in "Unreleased" section may actually belong to
+     that tagged version
+   - Identify which commits contain user-visible changes
+   - Extract PR numbers and author information from commit messages
+   - **Never ask the user for PR details** - get them from the git history
+
+3. **Validate** that changes are user-visible (per the criteria above). If not
+   user-visible, skip those commits.
+
+4. **Read the current CHANGELOG.md** to understand the existing structure and
+   formatting.
+
+5. **Determine where entries should go**:
+   - If the latest version tag is NEWER than main branch, move entries from
+     "Unreleased" to that version section
+   - If main is ahead of the latest tag, add new entries to "Unreleased"
+   - Always verify the version date in CHANGELOG.md matches the actual tag date
+
+6. **Add or move entries** to the appropriate section under appropriate category
+   headings.
+   - **CRITICAL**: When moving entries from "Unreleased" to a version section,
+     merge them with existing entries under the same category heading
+   - **NEVER create duplicate section headings** (e.g., don't create two "###
+     Fixed" sections)
+   - If the version section already has a category heading (e.g., "### Fixed"),
+     add the moved entries to that existing section
+   - Maintain the category order as defined above
+
+7. **Verify formatting**:
+   - Bold description with period
+   - Proper PR link (NO hash symbol)
+   - Proper author link
+   - Consistent with existing entries
+   - File ends with a newline character
+
+8. **Run linting** after making changes:
+
+   ```bash
+   bundle exec rubocop
+   yarn run prettier
+   ```
+
+9. **Show the user** the added or moved entries and explain what was done.
+
+### For Beta to Non-Beta Version Release
+
+When releasing from beta to a stable version (e.g., v1.1.0-beta.3 → v1.1.0):
+
+1. **Remove all beta version labels** from the changelog:
+   - Change `### [v1.1.0-beta.1]`, `### [v1.1.0-beta.2]`, etc. to a single
+     `### [v1.1.0]` section
+   - Combine all beta entries into the stable release section
+
+2. **Consolidate duplicate entries**:
+   - If bug fixes or changes were made to features introduced in earlier betas,
+     keep only the final state
+   - Remove redundant changelog entries for fixes to beta features
+   - Keep the most recent/accurate description of each change
+
+3. **Update version diff links** using `bundle exec rake update_changelog`
+
+### For New Beta Version Release
+
+When creating a new beta version, ask the user which approach to take:
+
+**Option 1: Process changes since last beta**
+
+- Only add entries for commits since the previous beta version
+- Maintains detailed history of what changed in each beta
+
+**Option 2: Collapse all prior betas into current beta**
+
+- Combine all beta changelog entries into the new beta version
+- Removes previous beta version sections
+- Cleaner changelog with less version noise
+
+After the user chooses, proceed with that approach.
+
+## Examples
+
+Run this command to see real formatting examples from the codebase:
+
+```bash
+grep -A 3 "^#### " CHANGELOG.md | head -30
+```
+
+### Good Entry Example
+
+```markdown
+- **New feature description**: Added helpful functionality that users will
+  appreciate. [PR 123](https://github.com/shakacode/package_json/pull/123) by
+  [username](https://github.com/username).
+```
+
+### Entry with Sub-bullets Example
+
+```markdown
+- **Multi-part feature**: Added new configuration options for enhanced
+  functionality:
+  - `option_name`: Description of the option and its purpose.
+    [PR 123](https://github.com/shakacode/package_json/pull/123) by
+    [username](https://github.com/username)
+  - `another_option`: Description of another option.
+    [PR 124](https://github.com/shakacode/package_json/pull/124) by
+    [username](https://github.com/username)
+```
+
+### Breaking Change Example
+
+```markdown
+- **Method Removal**: Several deprecated methods have been removed. If you're
+  using any of the following methods, you'll need to migrate:
+  - `old_method_one()`
+  - `old_method_two()`
+
+**Migration Guide:**
+
+To migrate:
+
+1. Replace `old_method_one()` with `new_method()`
+2. Update configuration to use new format
+```
+
+## Additional Notes
+
+- Keep descriptions concise but informative
+- Focus on the "what" and "why", not the "how"
+- Use past tense for the description
+- Be consistent with existing formatting in the changelog
+- Always ensure the file ends with a trailing newline
+- See CHANGELOG.md for additional contributor guidelines

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 ## [Unreleased]
 
+## [0.2.0] - 2025-11-06
+
+### Added
+
+- Add support for `exact` parameter in `add` method to install packages with
+  exact versions ([#29](https://github.com/shakacode/package_json/pull/29))
+
+### Fixed
+
+- Ensure RBS for `PackageJson` class is correct
+  ([#39](https://github.com/shakacode/package_json/pull/39))
+
+## [0.1.1] - 2025-11-04
+
+### Changed
+
+- Strip ANSI/CSI escape sequences when fetching `yarn bin` path
+  ([#31](https://github.com/shakacode/package_json/pull/31))
+
 ## [0.1.0] - 2023-09-15
 
 - Initial release

data/CLAUDE.md

@@ -0,0 +1,100 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with
+code in this repository.
+
+## ⚠️ CRITICAL REQUIREMENTS
+
+**BEFORE EVERY COMMIT/PUSH:**
+
+1. **ALWAYS run `bundle exec rubocop` and fix ALL violations**
+2. **ALWAYS ensure files end with a newline character**
+3. **NEVER push without running full lint check first**
+
+These requirements are non-negotiable. CI will fail if not followed.
+
+## Development Commands
+
+### Essential Commands
+
+- **Install dependencies**: `bundle install`
+- **Run tests**: `rake spec` or `bundle exec rspec`
+- **Linting** (MANDATORY BEFORE EVERY COMMIT):
+  - **REQUIRED**: `bundle exec rubocop` - Must pass with zero offenses
+  - Auto-fix RuboCop violations: `bundle exec rubocop -a`
+- **⚠️ MANDATORY BEFORE GIT PUSH**: `bundle exec rubocop` and fix ALL
+  violations + ensure trailing newlines
+- **Default task** (runs tests and rubocop): `rake`
+
+## Changelog
+
+- **Update CHANGELOG.md for user-visible changes only** (features, bug fixes,
+  breaking changes, deprecations, performance improvements)
+- **Do NOT add entries for**: linting, formatting, refactoring, tests, or
+  documentation fixes
+- **Format**:
+  `[PR 123](https://github.com/shakacode/package_json/pull/123) by [username](https://github.com/username)`
+  (no hash in PR number)
+- **Use `/update-changelog` command** for guided changelog updates with
+  automatic formatting
+- **Version management**: Run `bundle exec rake update_changelog` after releases
+  to update version headers (if task exists)
+- **Examples**: Run `grep -A 3 "^#### " CHANGELOG.md | head -30` to see real
+  formatting examples
+
+## ⚠️ FORMATTING RULES
+
+**RuboCop is the SOLE authority for formatting Ruby files. NEVER manually format
+code.**
+
+### Standard Workflow
+
+1. Make code changes
+2. Run `bundle exec rubocop -a` to auto-fix violations
+3. Commit changes
+
+### Debugging Formatting Issues
+
+- Check for violations: `bundle exec rubocop`
+- Fix violations: `bundle exec rubocop -a`
+- If CI fails on formatting, always run automated fixes, never manual fixes
+
+## Project Architecture
+
+### Core Components
+
+This is a Ruby gem that provides a Ruby interface for managing `package.json`
+files and JavaScript package managers.
+
+#### Ruby Side (`lib/package_json/`)
+
+- **`lib/package_json.rb`**: Main entry point and core PackageJson class
+- **`lib/package_json/manager.rb`**: Base class for package manager abstraction
+- **`lib/package_json/managers/`**: Specific implementations for npm, yarn,
+  pnpm, bun, etc.
+
+### Build System
+
+- **Ruby**: Standard gemspec-based build (see `package_json.gemspec`)
+- **Testing**: RSpec for Ruby tests
+- **Linting**: RuboCop for Ruby
+
+## Type Signatures & Documentation
+
+**This project uses RBS (Ruby Signature) files for type documentation**
+
+Everything should be captured in the type definitions, including private
+methods.
+
+## Important Notes
+
+- This gem provides a "middle-level" abstraction over JavaScript package
+  managers
+- Supports npm, yarn (classic and berry), pnpm, and bun
+- Does not capture or intercept package manager output by default
+- Uses `Kernel.system` under the hood for package manager operations
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/shakacode/package_json.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    package_json (0.1.0)
+    package_json (0.2.0)
 
 GEM
   remote: https://rubygems.org/
@@ -9,7 +9,7 @@ GEM
     ast (2.4.2)
     diff-lcs (1.5.0)
     docile (1.4.0)
-    json (2.6.3)
+    json (2.7.6)
     parallel (1.23.0)
     parser (3.2.2.3)
       ast (~> 2.4.1)
@@ -18,7 +18,7 @@ GEM
     rainbow (3.1.1)
     rake (13.0.6)
     regexp_parser (2.8.1)
-    rexml (3.2.6)
+    rexml (3.4.2)
     rspec (3.12.0)
       rspec-core (~> 3.12.0)
       rspec-expectations (~> 3.12.0)
@@ -63,6 +63,9 @@ GEM
 
 PLATFORMS
   arm64-darwin-21
+  arm64-darwin-22
+  arm64-darwin-23
+  arm64-darwin-24
   x64-mingw-ucrt
   x64-mingw32
   x86_64-darwin-19

data/README.md

@@ -1,5 +1,9 @@
 # PackageJson
 
+[![License](https://img.shields.io/badge/license-mit-green.svg)](LICENSE.md)
+[![Gem Version](https://badge.fury.io/rb/package_json.svg)](https://badge.fury.io/rb/package_json)
+[![Ruby](https://github.com/shakacode/package_json/actions/workflows/checks.yml/badge.svg)](https://github.com/shakacode/package_json/actions/workflows/checks.yml)
+
 The missing gem for managing `package.json` files, without having to know about
 package managers (mostly).
 
@@ -34,7 +38,7 @@ executing:
 package_json = PackageJson.new
 
 # adds eslint, eslint-plugin-prettier, and prettier as development dependencies
-package_json.manager.add(%w[eslint prettier], :dev)
+package_json.manager.add(%w[eslint prettier], type: :dev)
 
 # adds the "lint" and "format" scripts, preserving any existing scripts
 package_json.merge! do |pj|
@@ -74,7 +78,7 @@ in the `package.json`.
 > **Note**
 >
 > Only the name of the package manager is used; the version (if present) is
-> _not_ checked, nor is [`codepack`](https://nodejs.org/api/corepack.html) used
+> _not_ checked, nor is [`corepack`](https://nodejs.org/api/corepack.html) used
 > to ensure that the package manager is installed.
 >
 > The manager will be invoked by its name in the directory of the
@@ -173,11 +177,15 @@ package_json.manager.add(["eslint", "prettier"], type: :dev)
 
 # adds dotenv-webpack v6 as a production dependency
 package_json.manager.add(["dotenv-webpack@^6"])
+
+# adds react-on-rails with exact version (no ^ or ~)
+package_json.manager.add(["react-on-rails@16.0.0"], exact: true)
 ```
 
-| Option | Description                                                                                 |
-| ------ | ------------------------------------------------------------------------------------------- |
-| `type` | The type to add the dependencies as; either `:production` (default), `:dev`, or `:optional` |
+| Option  | Description                                                                                 |
+| ------- | ------------------------------------------------------------------------------------------- |
+| `type`  | The type to add the dependencies as; either `:production` (default), `:dev`, or `:optional` |
+| `exact` | If true, saves packages with exact versions (no `^` or `~` prefix)                          |
 
 #### Removing dependencies
 
@@ -259,18 +267,17 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To
-release a new version, update the version number in `version.rb`, and then run
-`bundle exec rake release`, which will create a git tag for the version, push
-git commits and the created tag, and push the `.gem` file to
-[rubygems.org](https://rubygems.org).
+release a new version, update the version number in `version.rb`, and then tag
+the commit with the version prefixed with a `v`, which will trigger the release
+workflow to publish the new version to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at
-https://github.com/[USERNAME]/package_json. This project is intended to be a
+https://github.com/shakacode/package_json. This project is intended to be a
 safe, welcoming space for collaboration, and contributors are expected to adhere
 to the
-[code of conduct](https://github.com/[USERNAME]/package_json/blob/main/CODE_OF_CONDUCT.md).
+[code of conduct](https://github.com/shakacode/package_json/blob/main/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -281,4 +288,4 @@ The gem is available as open source under the terms of the
 
 Everyone interacting in the PackageJson project's codebases, issue trackers,
 chat rooms and mailing lists is expected to follow the
-[code of conduct](https://github.com/[USERNAME]/package_json/blob/main/CODE_OF_CONDUCT.md).
+[code of conduct](https://github.com/shakacode/package_json/blob/main/CODE_OF_CONDUCT.md).

data/lib/package_json/managers/base.rb

@@ -40,13 +40,13 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
+      def add(packages, type: :production, exact: false)
         raise NotImplementedError
       end
 
       # Adds the given packages
-      def add!(packages, type: :production)
-        raise_exited_with_non_zero_code_error unless add(packages, type: type)
+      def add!(packages, type: :production, exact: false)
+        raise_exited_with_non_zero_code_error unless add(packages, type: type, exact: exact)
       end
 
       # Removes the given packages

data/lib/package_json/managers/bun_like.rb

@@ -16,8 +16,9 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
-        raw("add", [package_type_install_flag(type)].compact + packages)
+      def add(packages, type: :production, exact: false)
+        flags = [package_type_install_flag(type), exact_flag(exact)].compact
+        raw("add", flags + packages)
       end
 
       # Removes the given packages
@@ -62,6 +63,12 @@ class PackageJson
         []
       end
 
+      def exact_flag(exact)
+        return "--exact" if exact
+
+        nil
+      end
+
       def package_type_install_flag(type)
         case type
         when :production

data/lib/package_json/managers/npm_like.rb

@@ -22,8 +22,9 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
-        raw("install", [package_type_install_flag(type)] + packages)
+      def add(packages, type: :production, exact: false)
+        flags = [package_type_install_flag(type), exact_flag(exact)].compact
+        raw("install", flags + packages)
       end
 
       # Removes the given packages
@@ -66,6 +67,12 @@ class PackageJson
         args
       end
 
+      def exact_flag(exact)
+        return "--save-exact" if exact
+
+        nil
+      end
+
       def package_type_install_flag(type)
         case type
         when :production

data/lib/package_json/managers/pnpm_like.rb

@@ -16,8 +16,9 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
-        raw("add", [package_type_install_flag(type)] + packages)
+      def add(packages, type: :production, exact: false)
+        flags = [package_type_install_flag(type), exact_flag(exact)].compact
+        raw("add", flags + packages)
       end
 
       # Removes the given packages
@@ -67,6 +68,12 @@ class PackageJson
         ["--no-frozen-lockfile"]
       end
 
+      def exact_flag(exact)
+        return "--save-exact" if exact
+
+        nil
+      end
+
       def package_type_install_flag(type)
         case type
         when :production

data/lib/package_json/managers/yarn_berry_like.rb

@@ -16,8 +16,9 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
-        raw("add", [package_type_install_flag(type)].compact + packages)
+      def add(packages, type: :production, exact: false)
+        flags = [package_type_install_flag(type), exact_flag(exact)].compact
+        raw("add", flags + packages)
       end
 
       # Removes the given packages
@@ -64,6 +65,12 @@ class PackageJson
         ["--no-immutable"]
       end
 
+      def exact_flag(exact)
+        return "--exact" if exact
+
+        nil
+      end
+
       def package_type_install_flag(type)
         case type
         when :production

data/lib/package_json/managers/yarn_classic_like.rb

@@ -16,8 +16,9 @@ class PackageJson
       end
 
       # Adds the given packages
-      def add(packages, type: :production)
-        raw("add", [package_type_install_flag(type)].compact + packages)
+      def add(packages, type: :production, exact: false)
+        flags = [package_type_install_flag(type), exact_flag(exact)].compact
+        raw("add", flags + packages)
       end
 
       # Removes the given packages
@@ -62,7 +63,8 @@ class PackageJson
           raise PackageJson::Error, "#{command} failed with exit code #{status.exitstatus}: #{stderr}"
         end
 
-        stdout.chomp
+        # Strip ANSI/CSI escape sequences that may be present when invoked via tools like concurrently
+        stdout.chomp.gsub(/\e\[[^\x40-\x7E]*[\x40-\x7E]/, "")
       end
 
       def build_run_args(script_name, args, silent:)
@@ -78,6 +80,12 @@ class PackageJson
         []
       end
 
+      def exact_flag(exact)
+        return "--exact" if exact
+
+        nil
+      end
+
       def package_type_install_flag(type)
         case type
         when :production

data/lib/package_json/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class PackageJson
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/package_json.rb

@@ -79,16 +79,21 @@ class PackageJson
 
     name, version = package_manager.split("@")
 
-    if name == "yarn"
-      raise Error, "a major version must be present for Yarn" if version.nil? || version.empty?
-      return :yarn_classic if version.start_with?("1")
-
-      return :yarn_berry
-    end
+    return determine_yarn_version(version) if name == "yarn"
 
     name.to_sym
   end
 
+  def determine_yarn_version(version)
+    raise Error, "a major version must be present for Yarn" if version.nil? || version.empty?
+
+    # check to see if we're meant to be using Yarn v1 based on the versions major component,
+    # and accounting for the presence of version constraints like ^, ~, and =
+    return :yarn_classic if version.match?(/^[~=^]?1(\.|$)/)
+
+    :yarn_berry
+  end
+
   def new_package_manager(package_manager_name)
     case package_manager_name
     when :npm

data/package_json.gemspec

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative "lib/package_json/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "package_json"
+  spec.version = PackageJson::VERSION
+  spec.authors = ["Gareth Jones"]
+  spec.email = %w[open-source@ackama.com]
+
+  spec.summary = "The missing gem for managing package.json files in Ruby"
+  spec.homepage = "https://github.com/shakacode/package_json"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 2.6.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+end

data/sig/package_json/managers/base.rbs

@@ -13,9 +13,9 @@ class PackageJson
 
       def native_install_command: (?frozen: bool) -> Array[String]
 
-      def add: (Array[String] packages, ?type: :production | :dev | :optional) -> (bool | nil)
+      def add: (Array[String] packages, ?type: :production | :dev | :optional, ?exact: bool) -> (bool | nil)
 
-      def add!: (Array[String] packages, ?type: :production | :dev | :optional) -> void
+      def add!: (Array[String] packages, ?type: :production | :dev | :optional, ?exact: bool) -> void
 
       def remove: (Array[String] packages) -> (bool | nil)
 

data/sig/package_json/managers/bun_like.rbs

@@ -13,6 +13,8 @@ class PackageJson
 
       def with_frozen_flag: (bool frozen) -> Array[String]
 
+      def exact_flag: (bool exact) -> (String | nil)
+
       def package_type_install_flag: (Symbol type) -> (String | nil)
     end
   end

data/sig/package_json/managers/npm_like.rbs

@@ -11,6 +11,8 @@ class PackageJson
           silent: bool
         ) -> Array[String]
 
+      def exact_flag: (bool exact) -> (String | nil)
+
       def package_type_install_flag: (Symbol type) -> String
     end
   end

data/sig/package_json/managers/pnpm_like.rbs

@@ -13,6 +13,8 @@ class PackageJson
 
       def with_frozen_flag: (bool frozen) -> Array[String]
 
+      def exact_flag: (bool exact) -> (String | nil)
+
       def package_type_install_flag: (Symbol type) -> String
     end
   end

data/sig/package_json/managers/yarn_berry_like.rbs

@@ -13,6 +13,8 @@ class PackageJson
 
       def with_frozen_flag: (bool frozen) -> Array[String]
 
+      def exact_flag: (bool exact) -> (String | nil)
+
       def package_type_install_flag: (Symbol type) -> (String | nil)
     end
   end

data/sig/package_json/managers/yarn_classic_like.rbs

@@ -15,6 +15,8 @@ class PackageJson
 
       def with_frozen_flag: (bool frozen) -> Array[String]
 
+      def exact_flag: (bool exact) -> (String | nil)
+
       def package_type_install_flag: (Symbol type) -> (String | nil)
     end
   end

data/sig/package_json.rbs

@@ -12,14 +12,18 @@ class PackageJson
 
   def self.fetch_default_fallback_manager: () -> Symbol
 
-  def self.read: (?String path_to_directory, ?package_manager: (:npm | :yarn_berry | :yarn_classic | :pnpm | :bun)) -> PackageJson
+  def self.read: (?String path_to_directory, ?fallback_manager: (:npm | :yarn_berry | :yarn_classic | :pnpm | :bun)) -> PackageJson
 
-  def initialize: (?String path_to_directory, ?package_manager: (:npm | :yarn_berry | :yarn_classic | :pnpm | :bun)) -> PackageJson
+  def initialize: (?String path_to_directory, ?fallback_manager: (:npm | :yarn_berry | :yarn_classic | :pnpm | :bun)) -> PackageJson
 
   def fetch: (String key, ?untyped default) -> (String | Hash[String, untyped] | Array[untyped])
 
   def merge!: () { (Hash[String | Symbol, untyped]) -> Hash[String | Symbol, untyped] } -> void
 
+  def delete!: (String key) -> untyped
+
+  def record_package_manager!: () -> void
+
   private
 
   @directory: String
@@ -30,9 +34,9 @@ class PackageJson
 
   def package_json_path: () -> String
 
-  def ensure_package_json_exists: ((:npm | :yarn_berry | :yarn_classic | :pnpm | :bun) package_manager) -> void
+  def ensure_package_json_exists: () -> bool
 
-  def read_package_json: () -> void
+  def read_package_json: () -> Hash[String, untyped]
 
   def write_package_json: (_ToJson contents) -> void
 end

metadata

@@ -1,22 +1,21 @@
 --- !ruby/object:Gem::Specification
 name: package_json
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Gareth Jones
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-09-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: 
 email:
 - open-source@ackama.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".claude/commands/update-changelog.md"
 - ".editorconfig"
 - ".prettierignore"
 - ".prettierrc.json"
@@ -24,6 +23,7 @@ files:
 - ".rubocop.yml"
 - ".ruby-version"
 - CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - Gemfile
 - Gemfile.lock
@@ -38,6 +38,7 @@ files:
 - lib/package_json/managers/yarn_berry_like.rb
 - lib/package_json/managers/yarn_classic_like.rb
 - lib/package_json/version.rb
+- package_json.gemspec
 - sig/package_json.rbs
 - sig/package_json/managers/base.rbs
 - sig/package_json/managers/bun_like.rbs
@@ -45,15 +46,14 @@ files:
 - sig/package_json/managers/pnpm_like.rbs
 - sig/package_json/managers/yarn_berry_like.rbs
 - sig/package_json/managers/yarn_classic_like.rbs
-homepage: https://github.com/G-Rath/package_json
+homepage: https://github.com/shakacode/package_json
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/G-Rath/package_json
-  source_code_uri: https://github.com/G-Rath/package_json
-  changelog_uri: https://github.com/G-Rath/package_json
+  homepage_uri: https://github.com/shakacode/package_json
+  source_code_uri: https://github.com/shakacode/package_json
+  changelog_uri: https://github.com/shakacode/package_json/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -68,8 +68,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: The missing gem for managing package.json files in Ruby
 test_files: []