featureparity 0.0.29 → 0.0.30

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5cef61c9093573a494f9d27b203554e51dfc2f0a6d60ae43e666564c8e2b1740
-  data.tar.gz: 7162500244354be8c93a78499e479ac30a7df2d25ab4f818ce3451a6819ce960
+  metadata.gz: 7b3bad4ccc28e0695bdb790ecc37d6836d5477a84de09442c5255df871d98444
+  data.tar.gz: 67fcd3d1ac1a1a7bd41197ae674942fea80d20bbea22d856075face50ad87007
 SHA512:
-  metadata.gz: a4733078f1af140723dadb54a0ed5e3ba5c80b771a48ba9f8364c6dcfb088cb9e3c39c79fac27b0fd5083e2339e47b8b6fb76fe5c54fde772f68fdbc2a005e7d
-  data.tar.gz: 21330096e2f61cf6100dc54708c25818647f88581e0d0ef073bc84b2ec532556582012d899a663a0e96ce9e757ff6f5ae0ec51338be797bc19363f40e97d86af
+  metadata.gz: b276bc10363baf2fe27e843e0824ed205ed62f7836f4671cf53db15fc92ddc6a579a2fb1f5da34c4f34e672ffe2c14c418d10239e55066aa1a4b5806f078b930
+  data.tar.gz: 2769c008ecac2bdd2f02c13ef34cdc91619085709965138dc8750ab4127ebd22d119eae646a89202217db47235ddc4e75e1efae24528feeed1b1a7d53ec20f80

data/lib/fp/client.rb

@@ -318,12 +318,16 @@ module Fp
     # only do that by fetching the test files from GitHub, which fails silently on a
     # private repo, so resolved results are always sent when we have them.
     def ingest_ci_results(project_id, ci_url:, surface:, junit_xml:, pr_url: nil, results: nil,
-                          test_revisions: nil, unmarked_failures: nil, orphan_markers: nil, sha: nil)
+                          test_revisions: nil, unmarked_failures: nil, orphan_markers: nil, sha: nil,
+                          local: false)
       body = {
         ci_url: ci_url,
         surface: surface,
         junit_xml: junit_xml
       }
+      # A run on someone's machine rather than in CI (`fp ci-report --local`): there may be
+      # no run URL to record, and the server only accepts that when told so.
+      body[:local] = true if local
       # Only send pr_url when set, so a merged-branch run stays a plain ingest.
       body[:pr_url] = pr_url if pr_url && !pr_url.empty?
       # The checkout commit, so the receipt (or a PR run's branch verdict) links the

data/lib/fp/commands/ci_report.rb

@@ -49,6 +49,12 @@ module Fp
     # of `passing`, and no merged evidence is demoted. Run it without --pr on pushes to
     # the default branch to record the real `passing`, superseding any pr_passing a prior
     # PR run left behind.
+    #
+    # --local is for when there is no CI to run the suite — a team out of CI minutes, or
+    # one without a pipeline yet (Fizzy #1837). A person runs the suite on their own
+    # machine and reports it the same way CI would; --ci-url becomes optional. The verdict
+    # is stamped on HEAD, so the working tree has to be clean: a result from edits nobody
+    # committed would be recorded against a commit that never ran them.
     class CiReport < Base
       help_summary 'CI only: ingest real pass/fail results (writes passing/failing evidence)'
       help_usage 'fp ci-report --junit <file>... --project <slug> --surface <surface> --ci-url URL [--pr URL]'
@@ -62,10 +68,13 @@ module Fp
       help_flag :repo, 'Repository the tests live in (org/repo)'
       help_flag :sha, 'Checkout commit SHA'
       help_flag :allow_empty, 'Do not error when a report resolves no fp:<slug> markers'
+      help_flag :local, 'No CI available: report a suite a person ran locally at a clean, committed HEAD (--ci-url optional)'
       help_example 'fp ci-report --junit junit.xml --project stowzilla --surface api --ci-url "$CI_RUN_URL"'
       help_example 'fp ci-report --junit web.xml --surface web --base-dir frontend --pr "$PR_URL"'
+      help_example 'fp ci-report --local --junit junit.xml --surface api'
       help_note "This is CI's command, not an agent's: only it writes passing/failing. Run it on both\n" \
-                'green and red builds (if: always()) so failures show on the matrix.'
+                "green and red builds (if: always()) so failures show on the matrix.\n" \
+                'Out of CI minutes? A person can run the suite and report it with --local; agents report with fp report.'
 
       KNOWN_FLAGS = {
         project: :string,
@@ -77,7 +86,8 @@ module Fp
         base_dir: :string,
         repo: :string,
         sha: :string,
-        allow_empty: :boolean
+        allow_empty: :boolean,
+        local: :boolean
       }.freeze
 
       def run(args)
@@ -88,7 +98,7 @@ module Fp
 
         require_project!(opts)
         require_flag(opts, :surface)
-        require_flag(opts, :ci_url)
+        require_flag(opts, :ci_url) unless opts[:local]
 
         if junit_paths.empty?
           output.error('--junit <path> is required (may be given more than once).')
@@ -103,6 +113,7 @@ module Fp
 
         project_id = resolve_project_id(opts[:project])
         known = known_slugs(project_id)
+        require_clean_tree!(opts) if opts[:local]
         commit_sha = resolve_commit_sha(opts)
         repo = opts[:repo] || presence(ENV['GITHUB_REPOSITORY'])
 
@@ -147,6 +158,7 @@ module Fp
           junit_xml: resolved_reports.first[:xml],
           pr_url: opts[:pr],
           sha: commit_sha,
+          local: opts[:local],
           results: combined_results,
           test_revisions: combined_revisions,
           unmarked_failures: totals[:unmarked_failures],
@@ -359,6 +371,23 @@ module Fp
         exit 1
       end
 
+      # A local run is recorded against HEAD, so HEAD has to be what ran. Untracked files
+      # are ignored: the report itself is usually one.
+      def require_clean_tree!(opts)
+        root = Fp::JUnit.repo_root_for(opts[:base_dir] || Dir.pwd)
+        stdout, _stderr, status = Open3.capture3('git', 'status', '--porcelain', '--untracked-files=no',
+                                                 chdir: root || Dir.pwd)
+        unless status.success?
+          output.error('--local needs a git checkout: the results are recorded against the commit that ran them.')
+          exit 1
+        end
+        return if stdout.strip.empty?
+
+        output.error('--local refuses a working tree with uncommitted changes: the results would be ' \
+                     'recorded against a commit that never ran them. Commit (and push) first, then re-run the suite.')
+        exit 1
+      end
+
       def resolve_commit_sha(opts)
         explicit = presence(opts[:sha])
         return explicit if explicit
@@ -403,6 +432,7 @@ module Fp
 
         output.success(data) do
           mode = opts[:pr] ? " (PR mode — passing tests recorded as pr_passing)" : ''
+          mode += ' (local run, no CI)' if opts[:local]
           puts "Ingested CI results for surface '#{opts[:surface]}'#{mode}:"
           totals[:reports].each do |report|
             report[:results].each do |r|

data/lib/fp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fp
-  VERSION = '0.0.29'
+  VERSION = '0.0.30'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: featureparity
 version: !ruby/object:Gem::Version
-  version: 0.0.29
+  version: 0.0.30
 platform: ruby
 authors:
 - Stowzilla
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-11-03 00:00:00.000000000 Z
+date: 2026-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http