@guanlin4924/devflow-pi 0.1.39 → 0.1.47

package/plugins/devflow-core/skills/workflow-orchestrator/scripts/business_invalidation.rb

@@ -0,0 +1,108 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Core-owned, precise invalidation. It records only consumers that reference
+# facts whose source refs changed; it never regenerates or semantically edits
+# a consumer.
+require "json"
+require "optparse"
+require "set"
+require "time"
+require "yaml"
+require_relative "control_io"
+
+options = { root: ".", feature: nil, canonical: nil, changed_source: [], registry: ".planning/artifacts/index.yaml", write: false, json: false }
+OptionParser.new do |o|
+  o.on("--root PATH") { |v| options[:root] = v }
+  o.on("--feature NAME") { |v| options[:feature] = v }
+  o.on("--canonical PATH") { |v| options[:canonical] = v }
+  o.on("--changed-source ID") { |v| options[:changed_source] << v }
+  o.on("--registry PATH") { |v| options[:registry] = v }
+  o.on("--write") { options[:write] = true }
+  o.on("--json") { options[:json] = true }
+end.parse!
+
+def all_refs(value, changed, found = [])
+  case value
+  when Hash
+    found.concat(Array(value["source_refs"]) & changed)
+    value.each_value { |child| all_refs(child, changed, found) }
+  when Array
+    value.each { |child| all_refs(child, changed, found) }
+  end
+  found.uniq
+end
+
+def read_json(path)
+  JSON.parse(File.read(path))
+end
+
+root = File.realpath(options[:root])
+lock = nil
+begin
+  raise ArgumentError, "feature is required" if options[:feature].to_s.empty?
+  raise ArgumentError, "at least one changed source is required" if options[:changed_source].empty?
+  canonical_path = options[:canonical] || ".planning/business-model/#{options[:feature]}/canonical.json"
+  canonical_absolute, canonical_relative = DevflowControlIO.resolve_control_path(root, canonical_path, :artifact)
+  model = read_json(canonical_absolute)
+  changed = options[:changed_source].uniq
+  affected = []
+  %w[actors entities components boundaries resources rules actions].each do |collection|
+    Array(model[collection]).each do |item|
+      next unless item.is_a?(Hash)
+      refs = all_refs(item, changed)
+      next if refs.empty?
+      affected << { "collection" => collection, "id" => item["id"], "changed_sources" => refs }
+    end
+  end
+  affected_ids = affected.map { |item| item["id"].to_s }.to_set
+  wireframe_relative = ".planning/features/#{options[:feature]}/canonical.json"
+  wireframe_path, = DevflowControlIO.resolve_control_path(root, wireframe_relative, :artifact)
+  consumers = []
+  if File.file?(wireframe_path)
+    wireframe = read_json(wireframe_path)
+    Array(wireframe["screens"]).each do |screen|
+      refs = Array(screen["actions"]).map { |action| action["business_action_ref"] if action.is_a?(Hash) && affected_ids.include?(action["business_action_ref"].to_s) }.compact.uniq
+      consumers << { "kind" => "wireframe", "path" => wireframe_relative, "screen_id" => screen["id"], "business_refs" => refs } unless refs.empty?
+    end
+  end
+  report = { "schema_version" => 1, "feature" => options[:feature], "canonical_path" => canonical_relative, "changed_sources" => changed.sort, "affected_facts" => affected, "affected_consumers" => consumers, "generated_at" => Time.now.utc.iso8601 }
+  if options[:write]
+    lock = DevflowControlIO.acquire_project_lock(root)
+    timestamp = Time.now.utc.iso8601
+    approval_relative = ".planning/features/#{options[:feature]}/approval.json"
+    approval_path, = DevflowControlIO.resolve_control_path(root, approval_relative, :artifact)
+    if !consumers.empty? && File.file?(approval_path)
+      approval = read_json(approval_path)
+      approval["status"] = "stale"
+      approval["invalidated_at"] = timestamp
+      approval["invalidated_by_business_sources"] = changed.sort
+      DevflowControlIO.atomic_write(approval_path, JSON.pretty_generate(approval) + "\n")
+      report["invalidated_paths"] = [approval_relative]
+    end
+    registry_path, registry_relative = DevflowControlIO.resolve_control_path(root, options[:registry], :registry)
+    if File.file?(registry_path) && !consumers.empty?
+      registry = YAML.safe_load(File.read(registry_path), permitted_classes: [], aliases: false) || {}
+      stale_paths = consumers.map { |consumer| consumer["path"] } + [approval_relative]
+      Array(registry["artifacts"]).each do |artifact|
+        next unless stale_paths.include?(artifact["path"])
+        artifact["status"] = "stale"
+        artifact["stale_reason"] = "business_source_changed"
+        artifact["invalidated_at"] = timestamp
+      end
+      DevflowControlIO.atomic_write(registry_path, registry.to_yaml.sub(/\A---\n/, ""))
+      report["registry_path"] = registry_relative
+    end
+    report_path = File.join(root, ".planning", "business-model", options[:feature], "invalidation.json")
+    DevflowControlIO.atomic_write(report_path, JSON.pretty_generate(report) + "\n")
+    report["written"] = true
+  else
+    report["written"] = false
+  end
+  puts(options[:json] ? JSON.pretty_generate(report) : report["affected_consumers"].length.to_s)
+rescue StandardError => error
+  puts JSON.pretty_generate({ "ok" => false, "reason" => "business_invalidation_failed", "message" => error.message })
+  exit 1
+ensure
+  DevflowControlIO.release_lock(lock)
+end