boxwerk 0.1.0 → 0.2.0

data/example/Gemfile.lock

@@ -1,66 +0,0 @@
-PATH
-  remote: ..
-  specs:
-    boxwerk (0.1.0)
-      irb (~> 1.16)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    bigdecimal (4.0.1)
-    concurrent-ruby (1.3.6)
-    date (3.5.1)
-    erb (6.0.1)
-    i18n (1.14.8)
-      concurrent-ruby (~> 1.0)
-    io-console (0.8.2)
-    irb (1.16.0)
-      pp (>= 0.6.0)
-      rdoc (>= 4.0.0)
-      reline (>= 0.4.2)
-    money (7.0.0)
-      bigdecimal
-      i18n (~> 1.9)
-    pp (0.6.3)
-      prettyprint
-    prettyprint (0.2.0)
-    psych (5.3.1)
-      date
-      stringio
-    rdoc (7.0.3)
-      erb
-      psych (>= 4.0.0)
-      tsort
-    reline (0.6.3)
-      io-console (~> 0.5)
-    stringio (3.2.0)
-    tsort (0.2.0)
-
-PLATFORMS
-  arm64-darwin-25
-  ruby
-
-DEPENDENCIES
-  boxwerk!
-  money
-
-CHECKSUMS
-  bigdecimal (4.0.1) sha256=8b07d3d065a9f921c80ceaea7c9d4ae596697295b584c296fe599dd0ad01c4a7
-  boxwerk (0.1.0)
-  concurrent-ruby (1.3.6) sha256=6b56837e1e7e5292f9864f34b69c5a2cbc75c0cf5338f1ce9903d10fa762d5ab
-  date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
-  erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
-  i18n (1.14.8) sha256=285778639134865c5e0f6269e0b818256017e8cde89993fdfcbfb64d088824a5
-  io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
-  irb (1.16.0) sha256=2abe56c9ac947cdcb2f150572904ba798c1e93c890c256f8429981a7675b0806
-  money (7.0.0) sha256=6de776ee00aced8b9a435d3aac25ce8c600566625809b3d69bbe0c319e941dd5
-  pp (0.6.3) sha256=2951d514450b93ccfeb1df7d021cae0da16e0a7f95ee1e2273719669d0ab9df6
-  prettyprint (0.2.0) sha256=2bc9e15581a94742064a3cc8b0fb9d45aae3d03a1baa6ef80922627a0766f193
-  psych (5.3.1) sha256=eb7a57cef10c9d70173ff74e739d843ac3b2c019a003de48447b2963d81b1974
-  rdoc (7.0.3) sha256=dfe3d0981d19b7bba71d9dbaeb57c9f4e3a7a4103162148a559c4fc687ea81f9
-  reline (0.6.3) sha256=1198b04973565b36ec0f11542ab3f5cfeeec34823f4e54cebde90968092b1835
-  stringio (3.2.0) sha256=c37cb2e58b4ffbd33fe5cd948c05934af997b36e0b6ca6fdf43afa234cf222e1
-  tsort (0.2.0) sha256=9650a793f6859a43b6641671278f79cfead60ac714148aabe4e3f0060480089f
-
-BUNDLED WITH
-  4.0.3

data/example/README.md

@@ -1,130 +0,0 @@
-# Boxwerk Example Application
-
-This directory contains a complete example of a Boxwerk application demonstrating strict package isolation and dependency management.
-
-## Architecture
-
-```
-example/
-├── Gemfile                  # Gem dependencies (money gem)
-├── package.yml              # Root package (imports finance)
-├── app.rb                   # Application entry point
-└── packages/
-    ├── finance/
-    │   ├── package.yml      # Exports Invoice, TaxCalculator; imports util
-    │   └── lib/
-    │       ├── invoice.rb
-    │       └── tax_calculator.rb
-    └── util/
-        ├── package.yml      # Exports Calculator, Geometry
-        └── lib/
-            ├── calculator.rb
-            └── geometry.rb
-```
-
-## Dependency Graph
-
-```
-util (isolated box)
-  └── Calculator, Geometry
-
-finance (isolated box) 
-  ├── imports: util (Calculator renamed to UtilCalculator)
-  └── Invoice, TaxCalculator
-
-root (isolated box)
-  ├── imports: finance
-  └── Finance::Invoice, Finance::TaxCalculator available
-```
-
-## Running the Example
-
-```bash
-cd example
-RUBY_BOX=1 boxwerk run app.rb
-```
-
-**Architecture:**
-- Root box: Contains gems (including money gem) and Boxwerk runtime
-- Util box: Contains Calculator and Geometry classes
-- Finance box: Contains Invoice and TaxCalculator (imports Calculator from Util box as UtilCalculator)
-- Root package box: Runs app.rb (imports from Finance box)
-
-**Important:** ALL packages (including root) run in isolated boxes. The main Ruby process only contains gems and the Boxwerk runtime.
-
-### Interactive Console
-
-You can also start an IRB console in the root package context:
-
-```bash
-cd example
-RUBY_BOX=1 boxwerk console
-```
-
-This gives you an interactive session with all imports available (e.g., `Finance::Invoice`).
-
-## What This Demonstrates
-
-### ✓ Strict Isolation
-- `Finance::Invoice` and `Finance::TaxCalculator` are accessible (explicit import)
-- `Calculator` and `Geometry` are NOT accessible (transitive dependency - not imported)
-- `UtilCalculator` is NOT accessible (only available in Finance package's box)
-- `Invoice` at top level is NOT accessible (must use `Finance::` namespace)
-
-### ✓ Namespace Control
-- Finance package exports are grouped under `Finance::` module
-- Import strategies control how dependencies are wired
-
-### ✓ Selective Rename Strategy
-- Finance imports `Calculator` from util and renames it to `UtilCalculator`
-- This demonstrates the selective rename import strategy
-
-### ✓ Transitive Dependency Blocking
-- Root imports Finance
-- Finance imports Util
-- Root cannot access Util classes (no transitive access)
-
-### ✓ Gem Access
-- Money gem is globally accessible in all packages
-- Gems from Gemfile are auto-required and available everywhere
-
-### ✓ Clean API Surface
-- Each package explicitly declares exports
-- Consumers only see what's exported
-- Internal implementation details remain hidden
-
-## Package Configuration
-
-### Root Package (`package.yml`)
-
-```yaml
-imports:
-  - packages/finance  # Default namespace strategy
-```
-
-### Finance Package (`packages/finance/package.yml`)
-
-```yaml
-exports:
-  - Invoice
-  - TaxCalculator
-
-imports:
-  # Import Calculator from util and rename it to UtilCalculator
-  - packages/util:
-      Calculator: UtilCalculator
-```
-
-### Util Package (`packages/util/package.yml`)
-
-```yaml
-exports:
-  - Calculator
-  - Geometry
-```
-
-## Requirements
-
-- Ruby 4.0+ with `Ruby::Box` support
-- `RUBY_BOX=1` environment variable must be set
-- Boxwerk gem installed or loaded from `../lib`

data/example/app.rb

@@ -1,101 +0,0 @@
-# frozen_string_literal: true
-
-# Example Boxwerk Application
-# Run with: RUBY_BOX=1 boxwerk app.rb
-
-puts '=' * 70
-puts 'Boxwerk Application'
-puts '=' * 70
-puts ''
-
-puts 'Creating invoice...'
-invoice = Finance::Invoice.new(tax_rate: 0.15)
-invoice.add_item('Web Development', 200_000) # $2000.00 in cents
-invoice.add_item('Design Work', 150_000) # $1500.00 in cents
-invoice.add_item('Consulting', 80_000) # $800.00 in cents
-
-data = invoice.to_h
-
-puts "\nInvoice Details:"
-data[:items].each_with_index do |item, i|
-  amount_dollars = item[:amount] / 100.0
-  puts "  #{i + 1}. #{item[:description]}: $#{format('%.2f', amount_dollars)}"
-end
-puts ''
-puts "  Subtotal: $#{format('%.2f', data[:subtotal] / 100.0)}"
-puts "  Tax (15%): $#{format('%.2f', data[:tax] / 100.0)}"
-puts "  Total: $#{format('%.2f', data[:total] / 100.0)}"
-puts ''
-
-puts 'Testing isolation...'
-# Finance::Invoice should be available
-begin
-  test_invoice = Finance::Invoice.new
-  puts '  ✓ Finance::Invoice accessible'
-rescue NameError => e
-  puts "  ✗ Finance::Invoice not accessible: #{e.message}"
-end
-
-# Finance::TaxCalculator should be available
-begin
-  Finance::TaxCalculator
-  puts '  ✓ Finance::TaxCalculator accessible'
-rescue NameError => e
-  puts "  ✗ Finance::TaxCalculator not accessible: #{e.message}"
-end
-
-# UtilCalculator should NOT be available (transitive dependency)
-begin
-  UtilCalculator.add(1, 2)
-  puts '  ✗ ERROR: UtilCalculator leaked from transitive dependency!'
-rescue NameError
-  puts '  ✓ UtilCalculator not accessible (correct isolation)'
-end
-
-# Invoice should NOT be at top level (only in Finance namespace)
-begin
-  Invoice.new
-  puts '  ✗ ERROR: Invoice available at top level!'
-rescue NameError
-  puts '  ✓ Invoice only accessible via Finance namespace'
-end
-
-# Calculator should NOT be available (transitive dependency from util package)
-begin
-  Calculator.add(1, 2)
-  puts '  ✗ ERROR: Calculator leaked from transitive dependency!'
-rescue NameError
-  puts '  ✓ Calculator not accessible (correct isolation)'
-end
-
-# Geometry should NOT be available (transitive dependency from util package)
-begin
-  Geometry.circle_area(5)
-  puts '  ✗ ERROR: Geometry leaked from transitive dependency!'
-rescue NameError
-  puts '  ✓ Geometry not accessible (correct isolation)'
-end
-
-# Money gem SHOULD be accessible (gems are global, not isolated)
-begin
-  test_money = Money.new(100, 'USD')
-  puts '  ✓ Money gem accessible (gems are global)'
-rescue NameError => e
-  puts "  ✗ ERROR: Money gem not accessible: #{e.message}"
-end
-
-puts ''
-puts '=' * 70
-puts '✓ Application completed successfully'
-puts '=' * 70
-puts ''
-puts 'Boxwerk CLI setup process:'
-puts '  1. `boxwerk run app.rb` found root package.yml'
-puts '  2. Built dependency graph (util → finance → root)'
-puts '  3. Validated no circular dependencies'
-puts '  4. Booted packages in topological order (all in isolated boxes)'
-puts '  5. Executed app.rb in root package box with Finance imported'
-puts ''
-puts 'Key difference: ALL packages (including root) run in isolated boxes.'
-puts 'The main Ruby process only contains gems and the Boxwerk runtime.'
-puts ''

data/example/package.yml

@@ -1,6 +0,0 @@
-# Main Application Package
-
-imports:
-  # Finance has multiple exports (Invoice, TaxCalculator)
-  # so this creates a Finance module containing both
-  - packages/finance

data/example/packages/finance/lib/invoice.rb

@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-
-# Invoice represents a financial invoice with line items and tax calculation
-# Uses the Money gem for precise currency handling
-class Invoice
-  attr_reader :items, :tax_rate
-
-  def initialize(tax_rate: TaxCalculator::STANDARD_RATE)
-    @items = []
-    @tax_rate = tax_rate
-  end
-
-  def add_item(description, amount_cents)
-    @items << {
-      description: description,
-      amount: Money.new(amount_cents, 'USD'),
-    }
-    self
-  end
-
-  def subtotal
-    @items.reduce(Money.new(0, 'USD')) { |sum, item| sum + item[:amount] }
-  end
-
-  def tax
-    (subtotal * tax_rate).round
-  end
-
-  def total
-    subtotal + tax
-  end
-
-  def to_h
-    {
-      items:
-        @items.map do |item|
-          { description: item[:description], amount: item[:amount].cents }
-        end,
-      subtotal: subtotal.cents,
-      tax_rate: tax_rate,
-      tax: tax.cents,
-      total: total.cents,
-    }
-  end
-
-  def self.quick_invoice(amount_cents, tax_rate: TaxCalculator::STANDARD_RATE)
-    invoice = new(tax_rate: tax_rate)
-    invoice.add_item('Service', amount_cents)
-    invoice
-  end
-end

data/example/packages/finance/lib/tax_calculator.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-# TaxCalculator provides tax calculation utilities
-# Uses the imported Util package for calculations
-class TaxCalculator
-  STANDARD_RATE = 0.10 # 10%
-  LUXURY_RATE = 0.20 # 20%
-
-  def self.calculate_tax(amount, rate = STANDARD_RATE)
-    # Use UtilCalculator from selective import
-    UtilCalculator.multiply(amount, rate)
-  end
-
-  def self.calculate_total(amount, rate = STANDARD_RATE)
-    tax = calculate_tax(amount, rate)
-    # Use UtilCalculator.add from selective import
-    UtilCalculator.add(amount, tax)
-  end
-
-  def self.reverse_calculate(total_with_tax, rate = STANDARD_RATE)
-    # Calculate original amount from total including tax
-    # Formula: original = total / (1 + rate)
-    divisor = UtilCalculator.add(1, rate)
-    UtilCalculator.divide(total_with_tax, divisor)
-  end
-end

data/example/packages/finance/package.yml

@@ -1,10 +0,0 @@
-# Finance Package
-
-exports:
-  - Invoice
-  - TaxCalculator
-
-imports:
-  # Import Calculator from util and rename it to UtilCalculator
-  - packages/util:
-      Calculator: UtilCalculator

data/example/packages/util/lib/calculator.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-# Calculator provides basic arithmetic operations
-class Calculator
-  def self.add(a, b)
-    a + b
-  end
-
-  def self.subtract(a, b)
-    a - b
-  end
-
-  def self.multiply(a, b)
-    a * b
-  end
-
-  def self.divide(a, b)
-    raise ArgumentError, 'Cannot divide by zero' if b.zero?
-    a.to_f / b
-  end
-end

data/example/packages/util/lib/geometry.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-# Geometry provides geometric calculations
-class Geometry
-  PI = 3.14159265359
-
-  def self.circle_area(radius)
-    PI * radius * radius
-  end
-
-  def self.circle_circumference(radius)
-    2 * PI * radius
-  end
-
-  def self.rectangle_area(width, height)
-    width * height
-  end
-
-  def self.rectangle_perimeter(width, height)
-    2 * (width + height)
-  end
-
-  def self.triangle_area(base, height)
-    (base * height) / 2.0
-  end
-end

data/example/packages/util/package.yml

@@ -1,5 +0,0 @@
-# Util Package
-
-exports:
-  - Calculator
-  - Geometry

data/sig/boxwerk.rbs

@@ -1,4 +0,0 @@
-module Boxwerk
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-end