beachio-hammer 0.1.0.pre5 → 0.1.0.pre6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 761f1f1873cb333406eeab947ee2ae1edde559b69fa38497810c96bdf802f58e
-  data.tar.gz: 6721ab8889e4129b9c886fa875b92579d359a9012852d69aaa711fa1e29c08eb
+  metadata.gz: f3b4a0b499b230ddf29d32eec63d87dc4e6ceac09bbfdcbc11b076532dad79a6
+  data.tar.gz: 6eb175a810aae7ad23c4ffef79f770cb9201083f3ed4466b9c3ed5fefb975c4c
 SHA512:
-  metadata.gz: 23c9ab030b80757ac305dc66d4f0a35c9df394e248fa22ce62e8164d96c9b1573c4771b49ea82770574c113a7c4fd56ccfd26e294bda7f4515ede443dca28bfa
-  data.tar.gz: 5b670417365cbd83d7a706f3a1dc03edaadbcde2ca5cff920651446f66c790565d97a798e3a784fed847493cd62e1051cd27a0a4b23d11d67cd46014fb85314b
+  metadata.gz: 1b6f05d60825d07e45d3c1055b76b4e9e1155c664ae7de008602c1072fbddec96d19818aad8496f7955eb1f3b4c7c9363cc6ab87ab8990e77dded5a4bd9e00c7
+  data.tar.gz: 036de2226fd8f9708baf2ff5a46c9fe58f23b7d54e61331ca55aa87f55fb2b0cf05c351869d6fc7a48091104068aebf18a0fa8b3e984115cfb175a5900d67d5b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    beachio-hammer (0.1.0.pre5)
+    beachio-hammer (0.1.0.pre6)
       json (~> 2.7)
 
 GEM

data/PUBLISH.md

@@ -38,7 +38,14 @@ gem build beachio-hammer.gemspec
 gem push beachio-hammer-*.gem
 ```
 
-Prerelease pin for executor team: **`beachio-hammer` `0.1.0.pre5`**
+Prerelease pin for executor team: **`beachio-hammer` `0.1.0.pre6`**
+
+### 0.1.0.pre6 changes (`hammer check`)
+
+- Add `hammer check` for content validation (Swift CLI parity)
+- Flags: `--project`, `--strict`, `--format json|human`
+- Rule IDs: `CONFIG_MISSING`, `CONFIG_INVALID`, `COLLECTION_DIR_MISSING`, `TEMPLATE_MISSING`, `PARSE_ERROR`, `REQUIRED_FIELD_MISSING`, `SLUG_MISSING`, `PROJECT_NOT_FOUND`
+- Agent QC: `hammer check --strict --format json`
 
 ### 0.1.0.pre5 changes (collection loops on static pages)
 
@@ -68,16 +75,17 @@ Prerelease pin for executor team: **`beachio-hammer` `0.1.0.pre5`**
 Pin the published gem version in the executor Dockerfile:
 
 ```dockerfile
-RUN gem install beachio-hammer -v 0.1.0.pre5
+RUN gem install beachio-hammer -v 0.1.0.pre6
 ```
 
-Build step in the agent:
+Validate and build in the agent:
 
 ```bash
+hammer check --project "$WORKSPACE" --strict --format json
 hammer build --project "$WORKSPACE" --mode export --format json --clean
 ```
 
-### CLI contract
+### CLI contract — `hammer build`
 
 | Flag | Default | Notes |
 |------|---------|-------|
@@ -100,6 +108,29 @@ hammer build --project "$WORKSPACE" --mode export --format json --clean
 }
 ```
 
+### CLI contract — `hammer check`
+
+| Flag | Default | Notes |
+|------|---------|-------|
+| `--project` | cwd (walk-up for markers) | Project root |
+| `--strict` | off | Treat warnings as errors |
+| `--format` | `human` | `json` for agent parsing |
+
+**Exit codes:** `0` pass (or warnings without `--strict`), `1` check failures, `2` project/config error, `3` internal.
+
+**JSON stdout** (`--format json`):
+
+```json
+{
+  "status": "pass",
+  "errors": [{ "ruleId", "message", "file", "suggestion" }],
+  "warnings": [{ "ruleId", "message", "file", "suggestion" }],
+  "stats": { "filesChecked", "durationMs" }
+}
+```
+
+**Rule IDs:** `CONFIG_MISSING` (warn), `CONFIG_INVALID`, `COLLECTION_DIR_MISSING`, `TEMPLATE_MISSING`, `PARSE_ERROR`, `REQUIRED_FIELD_MISSING`, `SLUG_MISSING` (warn), `PROJECT_NOT_FOUND` (JSON `status: "error"`, exit 2).
+
 ### Parity fixtures
 
 | Fixture | Path | Files |

data/lib/beachio-hammer.rb

@@ -23,6 +23,7 @@ require_relative "hammer/content/page_generator"
 require_relative "hammer/content/builder"
 require_relative "hammer/builder"
 require_relative "hammer/build_command"
+require_relative "hammer/check_command"
 require_relative "hammer/cli"
 
 module Hammer

data/lib/hammer/cli.rb

@@ -2,13 +2,17 @@
 
 module Hammer
   module CLI
+    KNOWN_COMMANDS = %w[build check].freeze
+
     module_function
 
     def run(argv)
-      command = argv.first == "build" ? argv.shift : "build"
+      command = resolve_command(argv)
       case command
       when "build"
         BuildCommand.run(argv)
+      when "check"
+        CheckCommand.run(argv)
       else
         warn "Unknown command: #{command}"
         2
@@ -23,5 +27,13 @@ module Hammer
       warn "Build failed: #{e.message}"
       1
     end
+
+    def resolve_command(argv)
+      return "build" if argv.empty?
+      return argv.shift if KNOWN_COMMANDS.include?(argv.first)
+      return "build" if argv.first.start_with?("-")
+
+      argv.first
+    end
   end
 end

data/lib/hammer/content/config.rb

@@ -22,6 +22,24 @@ module Hammer
         output&.dig("filename") || output_path
       end
 
+      def validate_required_fields(metadata)
+        return [] unless fields
+
+        missing = []
+        fields.each do |field_name, field_config|
+          next unless field_config.required == true
+
+          unless metadata.key?(field_name)
+            missing << field_name
+            next
+          end
+
+          value = metadata[field_name]
+          missing << field_name if value.is_a?(String) && value.empty?
+        end
+        missing
+      end
+
       def self.from_hash(hash)
         fields = (hash["fields"] || {}).transform_values { |f| FieldConfig.from_hash(f) }
         new(

data/lib/hammer/output_formatter.rb

@@ -29,5 +29,56 @@ module Hammer
         puts "Build finished in #{duration.round(2)}s — #{file_count} files (#{build_size})"
       end
     end
+
+    def format_check_result(status:, errors:, warnings:, files_checked:, duration_ms:, format:)
+      if format == :json
+        payload = {
+          "status" => status,
+          "errors" => errors.map { |e| check_issue_hash(e) },
+          "warnings" => warnings.map { |w| check_issue_hash(w) },
+          "stats" => {
+            "filesChecked" => files_checked,
+            "durationMs" => duration_ms
+          }
+        }
+        puts JSON.pretty_generate(payload)
+        return
+      end
+
+      puts ""
+      if status == "pass"
+        puts "\u2714 #{files_checked} files validated"
+      else
+        puts "\u2716 #{errors.length} error#{errors.length == 1 ? '' : 's'}"
+      end
+
+      errors.each do |error|
+        puts ""
+        puts "[#{error[:rule_id]}]"
+        puts error[:message]
+        puts "  #{error[:file]}"
+        puts "  Suggestion: #{error[:suggestion]}" if error[:suggestion]
+      end
+
+      unless warnings.empty?
+        puts ""
+        puts "\u26A0 #{warnings.length} warning#{warnings.length == 1 ? '' : 's'}"
+        warnings.each do |warning|
+          puts "  [#{warning[:rule_id]}] #{warning[:message]}"
+          puts "    #{warning[:file]}"
+        end
+      end
+      puts ""
+    end
+
+    def check_issue_hash(issue)
+      hash = {
+        "ruleId" => issue[:rule_id],
+        "message" => issue[:message],
+        "file" => issue[:file]
+      }
+      hash["suggestion"] = issue[:suggestion] if issue[:suggestion]
+      hash
+    end
   end
 end

data/lib/hammer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Hammer
-  VERSION = "0.1.0.pre5"
+  VERSION = "0.1.0.pre6"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: beachio-hammer
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre5
+  version: 0.1.0.pre6
 platform: ruby
 authors:
 - Beach.io