ace-task 0.37.4 → 0.37.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e59cae852198045f684e486ebb3ac8fc07cf96b32098323de7fc76644ff11cb5
-  data.tar.gz: 97d7f2199699256db60426be3e68ee503f3c3eea935a99cb597d6de38a41e52d
+  metadata.gz: 722bb3a4374541de1d0b486d404772f5a46d02546f05c46e8dcc4595eeb2a5ef
+  data.tar.gz: 98d289a6740f8ecdbb65b31e96af5cf5b1b851c97214eb449e46ede6baf20939
 SHA512:
-  metadata.gz: 3364a66e7e03dd6e8e3b5fc9aa168266ee1899b8922359f1f240428082bc4e83913d01a5d0e53cb5a1220afe42afbc7a69afd0ffadd907b56fdf55900186a13b
-  data.tar.gz: 1fe73e05c9660719fa0494e437abaf640f774cf96862c59a84009eb6fdc761d5568d3fa54c469e810bcbaddc90524339f1de67cf6fccea4ec5d1034fd4db5b08
+  metadata.gz: 740ebb0c5b0e3c2ae9068717f8b8c6e2aee0896f9160bf1df7889975cdede6aa10ace2c392ae9cbede915e78ccf151e6cf4a78b0c22826e9f76aec75ef324e79
+  data.tar.gz: f1b69097da5391ec1554cf9debc11867f587b29321b74cc5cc9dfdf8e87899387a9dc08fb5adeec8a87ee135e5b24405d16542823e35290d9f8a6d8998855970

data/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.37.5] - 2026-09-26
+
+### Added
+- Best-effort GitHub sync: updates run without `gh`; offline updates flag tasks with `github_sync_pending` frontmatter, and `ace-task github-sync --pending` replays the missed issue syncs once gh is installed and authenticated.
+- gh availability gate (`IssueSync.available?` via ace-git-github): ownership validation and post-update issue sync run only when gh is installed and authenticated, restoring full checks when it is.
+
+### Fixed
+- Require the declared `ace-git-github` dependency so updates and archive moves of tasks with linked GitHub issues no longer fail with "GitHub issue sync primitives are unavailable".
 
 ## [0.37.4] - 2026-09-02
 

data/lib/ace/task/cli/commands/github_sync.rb

@@ -16,25 +16,27 @@ module Ace
 
           example [
             "q7w                         # Sync one task",
-            "--all                       # Sync all linked tasks"
+            "--all                       # Sync all linked tasks",
+            "--pending                   # Replay tasks flagged with github_sync_pending (offline sync)"
           ]
 
           argument :ref, required: false, desc: "Task reference (full ID, short ref, or suffix)"
           option :all, type: :boolean, aliases: %w[-a], desc: "Sync all linked tasks"
+          option :pending, type: :boolean, desc: "Sync only tasks flagged with github_sync_pending"
 
           option :quiet, type: :boolean, aliases: %w[-q], desc: "Suppress non-essential output"
           option :verbose, type: :boolean, aliases: %w[-v], desc: "Show verbose output"
           option :debug, type: :boolean, aliases: %w[-d], desc: "Show debug output"
 
           def call(ref: nil, **options)
-            all = options[:all]
+            all = options[:all] || options[:pending]
 
             if !all && (ref.nil? || ref.strip.empty?)
               raise Ace::Support::Cli::Error.new("Provide a task reference or use --all")
             end
 
             manager = Ace::Task::Organisms::TaskManager.new
-            result = manager.github_sync(ref: ref, all: all)
+            result = manager.github_sync(ref: ref, all: options[:all], pending: options[:pending])
             raise Ace::Support::Cli::Error.new("Task '#{ref}' not found") if result.nil?
             print_failures(result[:failures])
 
@@ -42,8 +44,14 @@ module Ace
               raise Ace::Support::Cli::Error.new(
                 "GitHub sync incomplete: synced #{result[:synced]}, failed #{result[:failed]}, skipped #{result[:skipped]}"
               )
+            elsif options[:pending] && result[:synced].to_i.zero? && result[:pending].to_i.zero?
+              puts "No pending GitHub syncs"
             elsif all
               puts "GitHub sync complete: synced #{result[:synced]} linked task(s), skipped #{result[:skipped]} task(s)"
+              pending = result[:pending].to_i
+              warn "gh unavailable: #{pending} task(s) remain flagged for github-sync --pending" if pending.positive?
+            elsif result[:pending].to_i.positive?
+              puts "GitHub sync skipped (gh unavailable); flagged for github-sync --pending"
             elsif result[:synced].positive?
               puts "GitHub sync complete: #{result[:task_id]}"
             else

data/lib/ace/task/molecules/github_issue_sync_adapter.rb

@@ -4,19 +4,29 @@ module Ace
   module Task
     module Molecules
       # Bridges ace-task lifecycle events to reusable ace-git issue sync primitives.
+      # GitHub sync is best-effort: when gh is unavailable, operations no-op and
+      # callers record the pending sync on the task instead.
       class GithubIssueSyncAdapter
         UNAVAILABLE_MESSAGE = "GitHub issue sync primitives are unavailable. " \
-          "Complete dependency task 8r4.t.ilo.2 or update ace-git."
+          "Update ace-git-github to a version providing them."
 
         CANDIDATE_INTEGRATIONS = [
-          ["Ace::Git::Molecules::GithubIssueSync", :validate_link!],
-          ["Ace::Git::Molecules::IssueSync", :validate_link!],
-          ["Ace::Git::Molecules::GithubIssueSync", :sync_task],
-          ["Ace::Git::Molecules::IssueSync", :sync_task]
+          ["Ace::Git::Github::IssueSync", :validate_link!],
+          ["Ace::Git::Github::IssueSync", :sync_task]
         ].freeze
 
+        # True when GitHub sync should run: the integration resolves and reports
+        # gh as installed and authenticated.
+        def available?
+          receiver, = resolve_integration(:sync_task)
+          return false unless receiver
+
+          receiver.respond_to?(:available?) ? receiver.available? : false
+        end
+
         def validate_link!(issue_id:, previous_task: nil)
           return unless issue_id.to_i.positive?
+          return unless available?
 
           receiver, method_name = resolve_integration(:validate_link!)
           raise UNAVAILABLE_MESSAGE unless receiver && method_name
@@ -33,7 +43,8 @@ module Ace
           current_issue_ids = [task.metadata["github_issue"]].compact.map(&:to_i).uniq
           previous_issue_ids = [previous_task&.metadata&.[]("github_issue")].compact.map(&:to_i).uniq
           issue_ids = (current_issue_ids + previous_issue_ids).uniq
-          return {synced: 0, issues: []} if issue_ids.empty?
+          return {synced: 0, issues: []} if issue_ids.empty? || !available?
+
 
           receiver, method_name = resolve_integration(:sync_task)
           raise UNAVAILABLE_MESSAGE unless receiver && method_name

data/lib/ace/task/molecules/task_frontmatter_validator.rb

@@ -136,15 +136,22 @@ module Ace
 
           def validate_github_fields(frontmatter, file_path, issues)
             linked = frontmatter["github_issue"]
-            return if linked.nil?
-
-            unless linked.is_a?(Integer) && linked.positive?
+            unless linked.nil? || (linked.is_a?(Integer) && linked.positive?)
               issues << {
                 type: :error,
                 message: "Invalid GitHub issue ID '#{linked}' in github_issue (expected positive integer)",
                 location: file_path
               }
             end
+
+            pending = frontmatter["github_sync_pending"]
+            return if pending.nil? || pending == true || pending == false
+
+            issues << {
+              type: :error,
+              message: "Invalid github_sync_pending value (expected boolean)",
+              location: file_path
+            }
           end
         end
       end

data/lib/ace/task/organisms/task_manager.rb

@@ -227,11 +227,12 @@ module Ace
           created_subtask
         end
 
-        def github_sync(ref: nil, all: false)
-          raise ArgumentError, "Provide --all or a task reference" if !all && (ref.nil? || ref.strip.empty?)
+        def github_sync(ref: nil, all: false, pending: false)
+          raise ArgumentError, "Provide --all or a task reference" if !all && !pending && (ref.nil? || ref.strip.empty?)
 
-          if all
+          if all || pending
             tasks = list(in_folder: "all")
+            tasks = tasks.select { |t| t.metadata["github_sync_pending"] } if pending
             linked_tasks = tasks.select { |t| linked_issue_id(t) }
             results = linked_tasks.map { |task| sync_linked_issues_for(task, reason: "manual-sync") }
             return summarize_manual_sync_results(results, skipped: tasks.length - linked_tasks.length)
@@ -482,13 +483,43 @@ module Ace
           return sync_result_for(task: task, issues: issue_ids, success: true, reason: reason) if issue_ids.empty?
 
           adapter = Molecules::GithubIssueSyncAdapter.new
+          unless adapter.available?
+            mark_github_sync_pending(task)
+            @last_update_note = "GitHub sync skipped (gh unavailable); flagged for 'ace-task github-sync --pending'"
+            return sync_result_for(task: task, issues: issue_ids, success: true, reason: reason).merge(offline: true)
+          end
+
           adapter.sync_task(task: task, reason: reason, previous_task: previous_task)
+          clear_github_sync_pending(task)
           sync_result_for(task: task, issues: issue_ids, success: true, reason: reason)
         rescue StandardError => e
-          @last_update_note = "GitHub sync warning for task #{task&.id}: #{e.message}"
+          mark_github_sync_pending(task)
+          @last_update_note = "GitHub sync warning for task #{task&.id}: #{e.message}; flagged for 'ace-task github-sync --pending'"
           sync_result_for(task: task, issues: issue_ids, success: false, reason: reason, error: e.message)
         end
 
+        # Flag the task so the missed GitHub sync survives offline work and can be
+        # replayed with 'ace-task github-sync --pending'.
+        def mark_github_sync_pending(task)
+          return unless task&.file_path && File.exist?(task.file_path)
+
+          Ace::Support::Items::Molecules::FieldUpdater.update(
+            task.file_path, set: {"github_sync_pending" => true}
+          )
+        rescue StandardError
+          nil
+        end
+
+        def clear_github_sync_pending(task)
+          return unless task&.file_path && File.exist?(task.file_path)
+
+          Ace::Support::Items::Molecules::FieldUpdater.update(
+            task.file_path, set: {"github_sync_pending" => nil}
+          )
+        rescue StandardError
+          nil
+        end
+
         def sync_result_for(task:, issues:, success:, reason:, error: nil)
           {
             task_id: task&.id,
@@ -508,9 +539,12 @@ module Ace
             }
           end
 
+          pending = results.count { |result| result[:offline] }
+
           {
-            synced: results.length - failures.length,
+            synced: results.length - failures.length - pending,
             failed: failures.length,
+            pending: pending,
             skipped: skipped,
             failures: failures
           }

data/lib/ace/task/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Task
-    VERSION = "0.37.4"
+    VERSION = "0.37.5"
   end
 end

data/lib/ace/task.rb

@@ -6,6 +6,7 @@ require_relative "task/version"
 require "ace/support/items"
 require "ace/b36ts"
 require "ace/git"
+require "ace/git/github"
 
 # Atoms
 require_relative "task/atoms/task_id_formatter"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-task
 version: !ruby/object:Gem::Version
-  version: 0.37.4
+  version: 0.37.5
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-09-05 00:00:00.000000000 Z
+date: 2026-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-core
@@ -85,14 +85,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.23'
+        version: '0.24'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.23'
+        version: '0.24'
+- !ruby/object:Gem::Dependency
+  name: ace-git-github
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: ace-support-cli
   requirement: !ruby/object:Gem::Requirement