@guanlin4924/devflow-pi 0.1.92 → 0.1.94

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

@@ -17,7 +17,7 @@ options = {
   step: nil,
   status: "not_started",
   track: nil,
-  state: ".planning/STATE.md",
+  state: ".devflow/planning/STATE.md",
   write: false,
   force: false,
   json: false
@@ -58,7 +58,7 @@ unless PhaseOwnership.valid_slug?(phase)
   puts JSON.pretty_generate({ "ok" => false, "reason" => "invalid_phase", "message" => "phase must be a safe non-empty slug" })
   exit 0
 end
-workflow_config = ".planning/workflows/#{options[:flow]}.yaml"
+workflow_config = ".devflow/planning/workflows/#{options[:flow]}.yaml"
 workflow_path = File.expand_path(workflow_config, root)
 unless options[:flow].is_a?(String) && options[:flow].match?(/\A[A-Za-z0-9][A-Za-z0-9_-]*\z/)
   puts JSON.pretty_generate({
@@ -120,9 +120,9 @@ state = {
   "completed_steps" => [],
   "pending_steps" => pending_steps,
   "active_outputs" => {
-    "requirement_baseline" => ".planning/requirements/baseline.md",
-    "feature_dir" => ".planning/features/#{feature}/",
-    "phase_dir" => ".planning/phases/#{phase}/"
+    "requirement_baseline" => ".devflow/planning/requirements/baseline.md",
+    "feature_dir" => ".devflow/planning/features/#{feature}/",
+    "phase_dir" => ".devflow/planning/phases/#{phase}/"
   }
 }
 

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

@@ -19,7 +19,7 @@ end.parse!
 root = Dir.pwd
 skill_root = File.expand_path("..", __dir__)
 template_dir = File.join(skill_root, "templates")
-state_path = File.join(root, ".planning", "STATE.md")
+state_path = File.join(root, ".devflow/planning", "STATE.md")
 
 def front_matter(markdown)
   match = markdown.match(/\A---\n(.*?)\n---\n/m)
@@ -42,7 +42,7 @@ end
 def active_workflow_target?(state, target_path)
   return false unless state
 
-  active = state["workflow_config"] || ".planning/workflows/#{state["current_flow"]}.yaml"
+  active = state["workflow_config"] || ".devflow/planning/workflows/#{state["current_flow"]}.yaml"
   active == target_path
 end
 
@@ -57,9 +57,9 @@ def state_step_mismatch?(state, template_path)
 end
 
 targets = {
-  "feature-development.yaml" => ".planning/workflows/feature-development.yaml",
-  "acceptance-remediation.yaml" => ".planning/workflows/acceptance-remediation.yaml",
-  "workflows-README.md" => ".planning/workflows/README.md"
+  "feature-development.yaml" => ".devflow/planning/workflows/feature-development.yaml",
+  "acceptance-remediation.yaml" => ".devflow/planning/workflows/acceptance-remediation.yaml",
+  "workflows-README.md" => ".devflow/planning/workflows/README.md"
 }
 
 blocked_target_paths = if options[:force] && options[:write] && !options[:allow_state_mismatch]

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

@@ -15,7 +15,7 @@ OptionParser.new do |opts|
 end.parse!
 
 root = Dir.pwd
-state_path = options[:state] ? File.expand_path(options[:state], root) : File.join(root, ".planning", "STATE.md")
+state_path = options[:state] ? File.expand_path(options[:state], root) : File.join(root, ".devflow/planning", "STATE.md")
 
 def fail_result(reason, details = {})
   {
@@ -64,9 +64,9 @@ end
 
 def project_context_missing?(root)
   required_paths = [
-    File.join(root, ".planning", "PROJECT.md"),
-    File.join(root, ".planning", "navigation", "INDEX.md"),
-    File.join(root, ".context", "spec", "index.md")
+    File.join(root, ".devflow/planning", "PROJECT.md"),
+    File.join(root, ".devflow/planning", "navigation", "INDEX.md"),
+    File.join(root, ".devflow/context", "spec", "index.md")
   ]
 
   required_paths.any? { |path| !File.exist?(path) }
@@ -325,10 +325,10 @@ result =
         "missing_project_context",
         path: state_path,
         missing: [
-          ".planning/STATE.md",
-          ".planning/PROJECT.md",
-          ".planning/navigation/INDEX.md",
-          ".context/spec/index.md"
+          ".devflow/planning/STATE.md",
+          ".devflow/planning/PROJECT.md",
+          ".devflow/planning/navigation/INDEX.md",
+          ".devflow/context/spec/index.md"
         ]
       )
     else
@@ -367,9 +367,9 @@ result =
         project_context_result(
           "incomplete_project_context",
           missing: [
-            ".planning/PROJECT.md",
-            ".planning/navigation/INDEX.md",
-            ".context/spec/index.md"
+            ".devflow/planning/PROJECT.md",
+            ".devflow/planning/navigation/INDEX.md",
+            ".devflow/context/spec/index.md"
           ]
         )
       else
@@ -385,7 +385,7 @@ result =
           )
         else
           workflow_path = state["workflow_config"] ||
-                          File.join(".planning", "workflows", "#{state["current_flow"]}.yaml")
+                          File.join(".devflow/planning", "workflows", "#{state["current_flow"]}.yaml")
           abs_workflow_path = File.join(root, workflow_path)
 
         if !File.exist?(abs_workflow_path)
@@ -641,7 +641,7 @@ result =
                 missing_outputs: missing_outputs,
                 checkpoint_meta_errors: checkpoint_meta_errors,
                 resume_behavior: checkpoint && checkpoint["resume_behavior"],
-                next_intent: ".planning/.next-intent"
+                next_intent: ".devflow/planning/.next-intent"
               )
             elsif parallel_window
               base.merge(action: "run_parallel_window")

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

@@ -30,7 +30,7 @@ abort "feature, step and --write are required" unless options[:feature] && optio
 abort "invalid feature" unless RequirementGraph.valid_feature?(options[:feature])
 
 def state_front_matter(root)
-  document = File.read(File.join(root, ".planning/STATE.md"))
+  document = File.read(File.join(root, ".devflow/planning/STATE.md"))
   front = document.match(/\A---\n(.*?)\n---/m)&.[](1)
   raise "STATE.md has no YAML front matter" unless front
   YAML.safe_load(front, permitted_classes: [], aliases: false)
@@ -62,7 +62,7 @@ def independent_evidence(root, feature, step, state, workflow, graph, files, che
   # cannot manufacture proof that an engine did not invoke AI.
   binding_attempt = binding && binding["attempt"]
   event_name = binding_attempt.nil? ? "#{step}.engine-events.jsonl" : "#{step}.attempt-#{binding_attempt}.engine-events.jsonl"
-  event_path = File.join(".planning", "evidence", feature, event_name)
+  event_path = File.join(".devflow/planning", "evidence", feature, event_name)
   event_absolute, = DevflowControlIO.resolve_control_path(root, event_path, :artifact)
   events = if File.file?(event_absolute)
              File.foreach(event_absolute).first(10_000).each_with_object([]) do |line, parsed|
@@ -259,7 +259,7 @@ begin
     "gate_mode" => gate.empty? ? "observe" : gate
   }.compact
   suffix = binding ? ".attempt-#{binding["attempt"]}.branch-#{Digest::SHA256.hexdigest(binding["branch_id"].to_s)[0, 12]}" : ""
-  destination = File.join(root, ".planning/evidence", options[:feature], "#{options[:step]}#{suffix}.machine.json")
+  destination = File.join(root, ".devflow/planning/evidence", options[:feature], "#{options[:step]}#{suffix}.machine.json")
   DevflowControlIO.atomic_write(destination, JSON.pretty_generate(pack) + "\n")
   result = { "ok" => true, "path" => destination.sub("#{root}/", ""), "complete" => pack["complete"], "state_revision" => pack["state_revision"], "graph_revision" => pack["graph_revision"], "checkers" => checker_results, "checkpoint_meta_errors" => checkpoint_meta_errors, "parallel_binding" => binding }
 rescue StandardError => error

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

@@ -31,7 +31,7 @@ OptionParser.new do |opts|
 end.parse!
 
 root = Dir.pwd
-state_path = options[:state] ? File.expand_path(options[:state], root) : File.join(root, ".planning", "STATE.md")
+state_path = options[:state] ? File.expand_path(options[:state], root) : File.join(root, ".devflow/planning", "STATE.md")
 
 def front_matter(markdown)
   match = markdown.match(/\A---\n(.*?)\n---\n/m)
@@ -51,19 +51,19 @@ def load_state(path)
 end
 
 def workflow_path_for(state)
-  state["workflow_config"] || File.join(".planning", "workflows", "#{state.fetch("current_flow")}.yaml")
+  state["workflow_config"] || File.join(".devflow/planning", "workflows", "#{state.fetch("current_flow")}.yaml")
 end
 
 def configured_policy(workflow)
   workflow["lessons_policy"] || {
     "sources" => [
-      { "path" => ".context/lessons/README.md", "required" => false },
-      { "path" => ".planning/lessons/README.md", "required" => false }
+      { "path" => ".devflow/context/lessons/README.md", "required" => false },
+      { "path" => ".devflow/planning/lessons/README.md", "required" => false }
     ],
     "selection" => { "max_candidates" => 5, "min_score" => 1 },
     "write" => {
-      "default_dir" => ".context/lessons",
-      "index_path" => ".context/lessons/README.md"
+      "default_dir" => ".devflow/context/lessons",
+      "index_path" => ".devflow/context/lessons/README.md"
     }
   }
 end
@@ -167,7 +167,7 @@ end
 
 def write_template(root, policy, state, title, source, write)
   write_config = policy["write"] || {}
-  dir = write_config["default_dir"] || ".context/lessons"
+  dir = write_config["default_dir"] || ".devflow/context/lessons"
   index_path = write_config["index_path"] || File.join(dir, "README.md")
   file_name = "#{Date.today}-#{slug_for(title)}.md"
   rel_path = File.join(dir, file_name)

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

@@ -159,7 +159,7 @@ rescue JSON::ParserError => error
 end
 
 def audit_path(root, feature)
-  DevflowControlIO.resolve_control_path(root, ".planning/evidence/#{feature}/parallel-recovery.jsonl", :artifact).first
+  DevflowControlIO.resolve_control_path(root, ".devflow/planning/evidence/#{feature}/parallel-recovery.jsonl", :artifact).first
 end
 
 def append_audit(root, feature, payload, lock: nil)
@@ -233,7 +233,7 @@ begin
   validation_records = []
   project_lock = DevflowControlIO.acquire_project_lock(root)
   begin
-    state_path, = DevflowControlIO.resolve_control_path(root, ".planning/STATE.md", :state)
+    state_path, = DevflowControlIO.resolve_control_path(root, ".devflow/planning/STATE.md", :state)
     state_yaml = front_matter(File.read(state_path))
     raise ArgumentError, "STATE.md has no YAML front matter" unless state_yaml
     state = YAML.safe_load(state_yaml, permitted_classes: [Date, Time], aliases: false)

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

@@ -29,7 +29,7 @@ module ParallelRun
   end
 
   def path(root, feature)
-    File.join(root, ".planning", "parallel", safe_feature(feature), "branches.yaml")
+    File.join(root, ".devflow/planning", "parallel", safe_feature(feature), "branches.yaml")
   end
 
   def load(root, feature)
@@ -94,7 +94,7 @@ module ParallelRun
     state
   end
 
-  def prepare(root:, feature:, workflow_window:, state_revision:, branches:, task_ids: {}, state_path: ".planning/STATE.md")
+  def prepare(root:, feature:, workflow_window:, state_revision:, branches:, task_ids: {}, state_path: ".devflow/planning/STATE.md")
     lock = DevflowControlIO.acquire_project_lock(root)
     begin
       raise ArgumentError, "parallel run already exists" if load(root, feature)
@@ -204,7 +204,7 @@ end
 
 if $PROGRAM_NAME == __FILE__
   begin
-  options = { action: nil, feature: nil, state_revision: nil, run_revision: nil, branch_id: nil, status: nil, workflow_window: nil, branches: [], state_path: ".planning/STATE.md", json: false }
+  options = { action: nil, feature: nil, state_revision: nil, run_revision: nil, branch_id: nil, status: nil, workflow_window: nil, branches: [], state_path: ".devflow/planning/STATE.md", json: false }
   OptionParser.new do |opts|
     opts.on("--action ACTION", %w[inspect prepare update retry rebase serial-fallback]) { |value| options[:action] = value }
     opts.on("--feature FEATURE") { |value| options[:feature] = value }

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

@@ -11,7 +11,7 @@ require "yaml"
 require_relative "control_io"
 
 module PhaseOwnership
-  REGISTRY_PATH = ".planning/phase-ownership.yaml"
+  REGISTRY_PATH = ".devflow/planning/phase-ownership.yaml"
   PHASE_SLUG = /\A[A-Za-z0-9][A-Za-z0-9_-]*\z/
   module_function
 
@@ -45,11 +45,11 @@ module PhaseOwnership
   def valid_owner?(owner, phase: nil)
     owner.is_a?(Hash) && valid_slug?(owner["phase"]) && (phase.nil? || owner["phase"] == phase) &&
       valid_feature?(owner["feature"]) && owner["flow"].is_a?(String) && !owner["flow"].empty? &&
-      owner["state_path"] == ".planning/STATE.md" && %w[active completed].include?(owner["status"])
+      owner["state_path"] == ".devflow/planning/STATE.md" && %w[active completed].include?(owner["status"])
   end
 
   def nonempty_phase_dirs(root)
-    Dir.glob(File.join(root, ".planning", "phases", "*")).select do |path|
+    Dir.glob(File.join(root, ".devflow/planning", "phases", "*")).select do |path|
       File.directory?(path) && !Dir.children(path).empty?
     end.map { |path| File.basename(path) }
   end
@@ -84,8 +84,8 @@ module PhaseOwnership
       return failure("phase_owned_by_another_feature", "requested phase is already owned by another feature", owner: current)
     end
 
-    owner = current || { "phase" => phase, "feature" => feature, "flow" => flow, "state_path" => ".planning/STATE.md", "scope" => "global", "status" => "active" }
-    owner = owner.merge("phase" => phase, "feature" => feature, "flow" => flow, "state_path" => ".planning/STATE.md", "scope" => "global", "status" => "active")
+    owner = current || { "phase" => phase, "feature" => feature, "flow" => flow, "state_path" => ".devflow/planning/STATE.md", "scope" => "global", "status" => "active" }
+    owner = owner.merge("phase" => phase, "feature" => feature, "flow" => flow, "state_path" => ".devflow/planning/STATE.md", "scope" => "global", "status" => "active")
     registry["owners"][phase] = owner
     registry["updated_at"] = Date.today.to_s
     DevflowControlIO.atomic_write(registry_path(root), registry.to_yaml) if write
@@ -114,7 +114,7 @@ module PhaseOwnership
     return failure("invalid_phase", "STATE.md current_phase must be a safe non-empty slug") unless valid_slug?(phase)
     owner = owner_override || registry["owners"][phase]
     return failure("missing_phase_owner", "STATE.md phase has no ownership record", phase: phase) unless valid_owner?(owner, phase: phase)
-    unless owner["feature"] == feature && owner["flow"] == flow && owner["state_path"] == ".planning/STATE.md"
+    unless owner["feature"] == feature && owner["flow"] == flow && owner["state_path"] == ".devflow/planning/STATE.md"
       return failure("phase_owner_mismatch", "STATE.md does not match phase ownership record", owner: owner)
     end
     conflicting = registry["owners"].values.find { |entry| valid_owner?(entry) && entry["status"] == "active" && entry["phase"] != phase }

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

@@ -9,7 +9,7 @@ require_relative "control_io"
 require_relative "validate_state"
 require_relative "phase_ownership"
 
-options = { state: ".planning/STATE.md", expected_revision: nil, confirm: false, write: false, json: false }
+options = { state: ".devflow/planning/STATE.md", expected_revision: nil, confirm: false, write: false, json: false }
 OptionParser.new do |opts|
   opts.banner = "Usage: repair_control_plane.rb --expected-revision N --confirm --write"
   opts.on("--state PATH") { |value| options[:state] = value }

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

@@ -14,7 +14,7 @@ module RequirementCoverage
   module_function
 
   def generate(root:, feature:, source:)
-    state = YAML.safe_load(File.read(File.join(root, ".planning/STATE.md")).split(/^---\s*$/, 3)[1], permitted_classes: [Date], aliases: false)
+    state = YAML.safe_load(File.read(File.join(root, ".devflow/planning/STATE.md")).split(/^---\s*$/, 3)[1], permitted_classes: [Date], aliases: false)
     raise ArgumentError, "source generation requires the active wayfinder step" unless state["current_feature"] == feature && state["current_step"] == "requirement-wayfinder"
     source_path = File.realpath(File.expand_path(source, root))
     raise ArgumentError, "source must be a project file" unless source_path.start_with?(File.realpath(root) + File::SEPARATOR)

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

@@ -18,7 +18,7 @@ module RequirementGraph
   # graphs are migrated in memory and re-written only by this Core writer.
   SCHEMA_VERSION = 5
   SUPPORTED_SCHEMA_VERSIONS = [1, 2, 3, 4, SCHEMA_VERSION].freeze
-  ROOT = ".planning/requirements"
+  ROOT = ".devflow/planning/requirements"
   KINDS = {
     "source" => "SRC", "code" => "CODE", "term" => "TERM", "object" => "OBJECT",
     "behavior" => "BEH", "requirement" => "REQ", "rule" => "BR", "boundary" => "BC",
@@ -56,7 +56,7 @@ module RequirementGraph
   end
 
   def active_feature(root)
-    state_path = File.join(root, ".planning", "STATE.md")
+    state_path = File.join(root, ".devflow/planning", "STATE.md")
     return nil unless File.file?(state_path)
     front = File.read(state_path).match(/\A---\n(.*?)\n---/m)&.[](1)
     return nil unless front
@@ -553,7 +553,7 @@ module RequirementGraph
     end
     matrix["imported_graph_revision"] = graph["revision"]
     DevflowControlIO.atomic_write(matrix_path, JSON.pretty_generate(matrix) + "\n")
-    template_path = File.join(root, ".planning", "features", graph["feature"], "api-acceptance-bindings.template.json")
+    template_path = File.join(root, ".devflow/planning", "features", graph["feature"], "api-acceptance-bindings.template.json")
     template = {
       "schema_version" => 1, "origin" => "core_api_test_matrix_template", "feature" => graph["feature"],
       "case_set_fingerprint" => matrix["case_set_fingerprint"],

package/plugins/devflow-core/skills/workflow-orchestrator/scripts/review_preflight.py

@@ -81,7 +81,7 @@ def preflight(root: Path, feature: str, step: str, contract_path: str,
             return {"status": "human_confirmation", "evidence": evidence,
                     "issues": [{"code": "STALE_WORKFLOW_SNAPSHOT"}]}
         workflow = load_workflow(workflow_path)
-        state = load_state(within(root, ".planning/STATE.md"))
+        state = load_state(within(root, ".devflow/planning/STATE.md"))
         if state.get("revision") != current["state_revision"] or state.get("current_feature") != feature or state.get("current_step") != step:
             return {"status": "human_confirmation", "evidence": evidence,
                     "issues": [{"code": "STALE_STATE_SNAPSHOT"}]}
@@ -100,7 +100,7 @@ def preflight(root: Path, feature: str, step: str, contract_path: str,
             else:
                 issues.append({"code": "INVALID_WORKFLOW_INPUT", "detail": "unrecognized input obligation"})
                 continue
-            if required and relative != ".planning/execution-contract.md":
+            if required and relative != ".devflow/planning/execution-contract.md":
                 derived.append({"path": render(relative), "producer": "existing"})
         for item in step_definition.get("outputs", []):
             if isinstance(item, dict) and item.get("required") is True and isinstance(item.get("path"), str):
@@ -113,7 +113,7 @@ def preflight(root: Path, feature: str, step: str, contract_path: str,
                          "required_obligation_count": len(derived),
                          "checker_ids": current.get("checker_ids", [])})
         if step == "code-review":
-            graph_relative = f".planning/requirements/{feature}/governance.json"
+            graph_relative = f".devflow/planning/requirements/{feature}/governance.json"
             graph_path = within(root, graph_relative)
             if not graph_path.is_file():
                 issues.append({"code": "CONFIRMED_EXPECTATIONS_UNAVAILABLE", "path": graph_relative})

package/plugins/devflow-core/skills/workflow-orchestrator/scripts/review_run.py

@@ -109,7 +109,7 @@ def validate_authority(root: Path, feature: str, expectations: list) -> tuple[li
                 issues.append(f"{item['id']}: authority_ref must identify a Core graph node and revision")
                 continue
             node_id, revision = ref[len("core-graph:"):].rsplit("@", 1)
-            graph_path = f".planning/requirements/{feature}/governance.json"
+            graph_path = f".devflow/planning/requirements/{feature}/governance.json"
             graph_file = safe_file(root, graph_path)
             authority = read_json(graph_file)
             node = next((n for n in authority.get("nodes", []) if isinstance(n, dict) and n.get("id") == node_id), None)
@@ -132,7 +132,7 @@ def validate_authority(root: Path, feature: str, expectations: list) -> tuple[li
 
 
 def db_open(root: Path) -> sqlite3.Connection:
-    planning = root / ".planning"
+    planning = root / ".devflow/planning"
     if planning.is_symlink():
         raise ValueError("unsafe planning directory")
     directory = planning / "review-runs"
@@ -174,7 +174,7 @@ def response(status: str, chain_id: str | None, round_no: int, **details: Any) -
 
 def locate_index(root: Path, accepted: list, target_paths: list[str], questions: list[str]) -> dict:
     """Ask the index for bounded leads, never for authoritative conclusions."""
-    index = root / ".planning" / "code-index"
+    index = root / ".devflow/planning" / "code-index"
     script = Path(__file__).resolve().parents[3].parent / "devflow-intel" / "skills" / "workflow-code-index" / "scripts" / "code_index.py"
     if not index.exists() or not script.exists():
         return {"status": "unavailable", "reason": "No local code-index snapshot; source evidence is independent"}
@@ -218,7 +218,7 @@ def verify_core_result(root: Path, feature: str, evidence: Any, expected_status:
     """Accept only a Core-owned TC result bound to the feature and frozen suite."""
     if not isinstance(evidence, dict):
         return False, "missing Core acceptance-test result reference"
-    relative = f".planning/test-runs/{feature}/acceptance-results.json"
+    relative = f".devflow/planning/test-runs/{feature}/acceptance-results.json"
     if evidence.get("path") != relative or not isinstance(evidence.get("tc_id"), str):
         return False, "result must reference a Core acceptance TC for this feature"
     try:
@@ -226,7 +226,7 @@ def verify_core_result(root: Path, feature: str, evidence: Any, expected_status:
         if digest(result_file.read_bytes()) != evidence.get("sha256"):
             return False, "acceptance result hash mismatch"
         payload = read_json(result_file)
-        suite = read_json(safe_file(root, f".planning/requirements/{feature}/tests.json"))
+        suite = read_json(safe_file(root, f".devflow/planning/requirements/{feature}/tests.json"))
         if payload.get("origin") != "core_acceptance_test_runner" or payload.get("feature") != feature:
             return False, "not a Core acceptance-test run"
         if payload.get("test_suite") != {"graph_revision": suite.get("graph_revision"), "fingerprint": suite.get("view_meta", {}).get("fingerprint")}:
@@ -252,7 +252,7 @@ def verify_core_result(root: Path, feature: str, evidence: Any, expected_status:
 def verify_core_impact(root: Path, feature: str, evidence: dict, impact: str, trigger: str) -> tuple[bool, str]:
     """A failed TC alone does not establish the reviewer's causal/impact label."""
     try:
-        suite = read_json(safe_file(root, f".planning/requirements/{feature}/tests.json"))
+        suite = read_json(safe_file(root, f".devflow/planning/requirements/{feature}/tests.json"))
         node = next((n for n in suite.get("nodes", []) if isinstance(n, dict) and n.get("id") == evidence.get("tc_id")), None)
         data = node.get("data", {}) if node else {}
         if data.get("review_impact") == impact and data.get("review_trigger") == trigger:
@@ -263,7 +263,7 @@ def verify_core_impact(root: Path, feature: str, evidence: dict, impact: str, tr
 
 
 def declared_change_paths(root: Path, feature: str) -> tuple[set[str], str, str]:
-    relative = f".planning/features/{feature}/变更清单.md"
+    relative = f".devflow/planning/features/{feature}/变更清单.md"
     source = safe_file(root, relative)
     declarations = re.findall(r"^\s*-\s*\*\*文件\*\*\s*[：:]\s*(.+)$", source.read_text(encoding="utf-8"), re.MULTILINE)
     paths = set()
@@ -295,7 +295,7 @@ def verify_coverage(root: Path, feature: str, required: list[str], coverage_evid
         if not valid:
             issues.append(f"{tag}: {reason}")
             continue
-        suite = read_json(safe_file(root, f".planning/requirements/{feature}/tests.json"))
+        suite = read_json(safe_file(root, f".devflow/planning/requirements/{feature}/tests.json"))
         node = next((n for n in suite.get("nodes", []) if isinstance(n, dict) and n.get("id") == ref["tc_id"]), None)
         types = {"scenario:normal": {"api", "page"}, "scenario:unauthorized": {"permission"}, "scenario:failure_rollback": {"resilience", "boundary"}, "scenario:compatibility": {"migration"}}
         data = node.get("data", {}) if node else {}
@@ -310,7 +310,7 @@ def verify_coverage(root: Path, feature: str, required: list[str], coverage_evid
 
 def suite_has_failures(root: Path, feature: str) -> bool:
     try:
-        payload = read_json(safe_file(root, f".planning/test-runs/{feature}/acceptance-results.json"))
+        payload = read_json(safe_file(root, f".devflow/planning/test-runs/{feature}/acceptance-results.json"))
         return any(isinstance(item, dict) and item.get("status") != "passed" for item in payload.get("results", []))
     except (OSError, ValueError, TypeError, json.JSONDecodeError):
         return True
@@ -322,13 +322,13 @@ def gate_status(root: Path, feature: str, contract_id: str | None = None) -> dic
     if not contract_id:
         return {"status": "human_confirmation", "reason": "Current Core review contract identity is required"}
     try:
-        contract = read_json(safe_file(root, f".planning/contracts/{feature}/{contract_id}.json"))
+        contract = read_json(safe_file(root, f".devflow/planning/contracts/{feature}/{contract_id}.json"))
         if contract.get("origin") != "core_execution_contract" or contract.get("step") != "code-review" or contract.get("feature") != feature or contract.get("contract_id") != contract_id:
             return {"status": "core_contract_conflict", "reason": "Review contract identity is not a frozen Core code-review contract"}
         sys.path.insert(0, str(Path(__file__).resolve().parent))
         from review_preflight import load_state
-        state = load_state(safe_file(root, ".planning/STATE.md"))
-        graph = read_json(safe_file(root, f".planning/requirements/{feature}/governance.json"))
+        state = load_state(safe_file(root, ".devflow/planning/STATE.md"))
+        graph = read_json(safe_file(root, f".devflow/planning/requirements/{feature}/governance.json"))
         workflow = safe_file(root, contract["workflow_path"])
         if (state.get("current_feature") != feature or state.get("current_step") != "code-review"
             or state.get("revision") != contract.get("state_revision")
@@ -337,7 +337,7 @@ def gate_status(root: Path, feature: str, contract_id: str | None = None) -> dic
             return {"status": "stale_evidence", "reason": "Review contract differs from current Core state, graph, or workflow"}
     except (OSError, ValueError, KeyError, TypeError, ImportError, json.JSONDecodeError) as exc:
         return {"status": "human_confirmation", "reason": f"Current Core review contract cannot be verified: {exc}"}
-    database = root / ".planning" / "review-runs" / "review-runs.sqlite"
+    database = root / ".devflow/planning" / "review-runs" / "review-runs.sqlite"
     if not database.is_file() or database.is_symlink():
         return {"status": "human_confirmation", "reason": "No Core review round exists"}
     db = sqlite3.connect(f"file:{database}?mode=ro", uri=True)
@@ -366,7 +366,7 @@ def gate_status(root: Path, feature: str, contract_id: str | None = None) -> dic
         index_generation = fixed.get("code_index_generation")
         if index_generation is not None:
             try:
-                snapshot = read_json(safe_file(root, ".planning/code-index/SNAPSHOT.json"))
+                snapshot = read_json(safe_file(root, ".devflow/planning/code-index/SNAPSHOT.json"))
                 if snapshot.get("generation") != index_generation:
                     return {"status": "stale_evidence", "reason": "Code-index generation changed after review", "chain_id": result.get("chain_id")}
             except (OSError, ValueError, json.JSONDecodeError):
@@ -415,11 +415,11 @@ def review_markdown(result: dict) -> str:
 
 def render_review(root: Path, feature: str, contract_id: str) -> dict:
     root = root.resolve(strict=True)
-    contract = read_json(safe_file(root, f".planning/contracts/{feature}/{contract_id}.json"))
+    contract = read_json(safe_file(root, f".devflow/planning/contracts/{feature}/{contract_id}.json"))
     path = next((item for item in contract.get("allowed_paths", []) if isinstance(item, str) and item.endswith("/REVIEW.md")), None)
     if not path:
         return {"status": "core_contract_conflict", "reason": "Core contract has no REVIEW.md output"}
-    database = root / ".planning/review-runs/review-runs.sqlite"
+    database = root / ".devflow/planning/review-runs/review-runs.sqlite"
     if not database.is_file():
         return {"status": "human_confirmation", "reason": "No Core review round exists"}
     db = sqlite3.connect(f"file:{database}?mode=ro", uri=True)
@@ -616,7 +616,7 @@ def run(root: Path, request: dict) -> dict:
                 db.commit()
                 return result
         if index_discovery.get("generation"):
-            current_snapshot = root / ".planning" / "code-index" / "SNAPSHOT.json"
+            current_snapshot = root / ".devflow/planning" / "code-index" / "SNAPSHOT.json"
             if not current_snapshot.exists() or read_json(current_snapshot).get("generation") != index_discovery["generation"]:
                 result = response("stale_evidence", chain_id, round_no, questions=["Code-index generation changed during review"])
                 db.execute("INSERT INTO events(chain_id,status,detail_json) VALUES(?,?,?)", (chain_id, result["status"], canonical(result)))
@@ -645,7 +645,7 @@ def run(root: Path, request: dict) -> dict:
                 db.commit()
                 return result
         status = "terminated_p0" if round_no == 3 and summary["P0"] else ("findings" if open_findings else "clean")
-        core_results = {rel: digest(safe_file(root, rel).read_bytes()) for rel in (f".planning/requirements/{target['feature']}/tests.json", f".planning/test-runs/{target['feature']}/acceptance-results.json")}
+        core_results = {rel: digest(safe_file(root, rel).read_bytes()) for rel in (f".devflow/planning/requirements/{target['feature']}/tests.json", f".devflow/planning/test-runs/{target['feature']}/acceptance-results.json")}
         result = response(status, chain_id, round_no, fixed_versions={"source": versions, "authority": accepted, "core_results": core_results, "change_plan": {"path": change_plan_path, "sha256": change_plan_hash, "declared_paths": sorted(declared_paths)}, "code_index_generation": index_discovery.get("generation")}, index_discovery=index_discovery, coverage={"covered": sorted(covered), "gaps": gaps, "index_gap": index_discovery.get("reason") if index_discovery["status"] != "located" else None}, findings=findings, risk_summary=summary, improvement_plan=[{"finding_id": f["finding_id"], "severity": f["severity"], "action": f["improvement"]} for f in sorted(open_findings, key=lambda x: x["severity"])], all_p0_resolved=summary["P0"] == 0, severity_source="independent_reviewer_core_evidence_bound", semantic_causality_verified=True, automatic_release_allowed=status == "clean", termination_scope="current_task_only" if status == "terminated_p0" else None, reviewer_task={key: binding[key] for key in ("agent", "feature", "contract_id", "task_call_id", "report_sha256")}, history=[{"round": r, "status": json.loads(raw)["status"]} for r, raw in db.execute("SELECT round,result_json FROM rounds WHERE chain_id=? ORDER BY round", (chain_id,))])
         db.execute("INSERT INTO reviewer_tasks(task_call_id,chain_id,round,report_sha256) VALUES(?,?,?,?)", (binding["task_call_id"], chain_id, round_no, binding["report_sha256"]))
         db.execute("INSERT INTO rounds(chain_id,round,result_json) VALUES(?,?,?)", (chain_id, round_no, canonical(result)))

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

@@ -14,8 +14,8 @@ require_relative "control_io"
 
 module RuntimeContextCollector
   SCHEMA_VERSION = 1
-  HISTORY_DIR = File.join(".context", "runtime-context", "revisions")
-  POINTER = File.join(".context", "runtime-context.json")
+  HISTORY_DIR = File.join(".devflow/context", "runtime-context", "revisions")
+  POINTER = File.join(".devflow/context", "runtime-context.json")
   EXTRACTORS = {
     "package.json" => :extract_package_json,
     "requirements.txt" => :extract_requirements_txt,
@@ -170,7 +170,7 @@ module RuntimeContextCollector
     history = File.join(root, HISTORY_DIR, "#{revision}.json")
     DevflowControlIO.atomic_create(history, JSON.pretty_generate(snapshot) + "\n")
     DevflowControlIO.atomic_write(File.join(root, POINTER), JSON.pretty_generate({ "current_revision" => revision, "path" => history.sub("#{root}/", "") }) + "\n")
-    DevflowControlIO.append_audit(File.join(root, ".context", "runtime-context", "audit.jsonl"), {
+    DevflowControlIO.append_audit(File.join(root, ".devflow/context", "runtime-context", "audit.jsonl"), {
       "event" => "snapshot_collected", "snapshot_revision" => revision,
       "repository_revision" => repository_revision, "coverage_status" => coverage_status
     })

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

@@ -69,7 +69,7 @@ def lease_expiry(seconds)
 end
 
 root = Dir.pwd
-state_path, = DevflowControlIO.resolve_control_path(root, ".planning/STATE.md", :state)
+state_path, = DevflowControlIO.resolve_control_path(root, ".devflow/planning/STATE.md", :state)
 result = catch(:transition_done) do
   lock = DevflowControlIO.acquire_project_lock(root)
   begin
@@ -129,7 +129,7 @@ result = catch(:transition_done) do
       throw :transition_done, result
     end
     rollover_id = "ROL-#{SecureRandom.uuid}"
-    relative_path = ".planning/handoffs/#{state.fetch("current_feature")}/#{rollover_id}.json"
+    relative_path = ".devflow/planning/handoffs/#{state.fetch("current_feature")}/#{rollover_id}.json"
     absolute_path, = DevflowControlIO.resolve_control_path(root, relative_path, :handoff)
     payload = {
       "schema_version" => 1,
@@ -144,9 +144,9 @@ result = catch(:transition_done) do
         "status" => state["status"], "completed_steps" => state["completed_steps"], "pending_steps" => state["pending_steps"]
       },
       "references" => {
-        "state_path" => ".planning/STATE.md",
+        "state_path" => ".devflow/planning/STATE.md",
         "workflow_path" => state["workflow_config"],
-        "artifact_registry" => ".planning/artifacts/index.yaml"
+        "artifact_registry" => ".devflow/planning/artifacts/index.yaml"
       }
     }
     serialized = JSON.generate(payload) + "\n"

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

@@ -17,9 +17,9 @@ require_relative "control_io"
 module StaticRuntimeContextCollector
   SCHEMA_VERSION = 2
   COLLECTOR_VERSION = "static-runtime-context-v2.1"
-  ROOT_DIR = File.join(".context", "static-runtime-context")
+  ROOT_DIR = File.join(".devflow/context", "static-runtime-context")
   HISTORY_DIR = File.join(ROOT_DIR, "revisions")
-  POINTER = ".context/static-runtime-context.json"
+  POINTER = ".devflow/context/static-runtime-context.json"
   AUDIT_PATH = File.join(ROOT_DIR, "audit.jsonl")
   MAX_COMPOSE_BYTES = 1_048_576
   EXCLUDED_ROOTS = %w[node_modules vendor dist build .git].freeze

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

@@ -11,7 +11,7 @@ require_relative "control_io"
 require_relative "phase_ownership"
 
 options = {
-  state: ".planning/STATE.md",
+  state: ".devflow/planning/STATE.md",
   workflow: nil,
   output: nil,
   write: false,
@@ -72,10 +72,10 @@ unless ownership["ok"]
   puts JSON.pretty_generate(ownership.merge("written" => false))
   exit 0
 end
-workflow_source = options[:workflow] || state["workflow_config"] || ".planning/workflows/#{state.fetch("current_flow")}.yaml"
+workflow_source = options[:workflow] || state["workflow_config"] || ".devflow/planning/workflows/#{state.fetch("current_flow")}.yaml"
 workflow_path, = DevflowControlIO.resolve_control_path(root, workflow_source, :workflow)
 workflow = load_yaml_file(workflow_path)
-registry_source = options[:output] || workflow.dig("artifact_registry", "source") || ".planning/artifacts/index.yaml"
+registry_source = options[:output] || workflow.dig("artifact_registry", "source") || ".devflow/planning/artifacts/index.yaml"
 existing_registry_path, registry_path = DevflowControlIO.resolve_control_path(root, registry_source, :registry)
 existing_by_path = {}
 if options[:preserve] && File.exist?(existing_registry_path)
@@ -112,7 +112,7 @@ end
 
 def questions_registry_entry(root, state, existing_by_path)
   feature = state.fetch("current_feature", "").to_s
-  path = ".planning/features/#{feature}/questions.yaml"
+  path = ".devflow/planning/features/#{feature}/questions.yaml"
   absolute, = DevflowControlIO.resolve_control_path(root, path, :artifact)
   exists = File.exist?(absolute)
   entry = {
@@ -180,7 +180,7 @@ artifacts = collect_outputs(workflow).map do |step, output|
   }.reject { |_, value| value.nil? || value == [] }
 end
 
-questions_path = ".planning/features/#{state.fetch("current_feature", "")}/questions.yaml"
+questions_path = ".devflow/planning/features/#{state.fetch("current_feature", "")}/questions.yaml"
 questions_entry = questions_registry_entry(root, state, existing_by_path)
 question_index = artifacts.index { |artifact| artifact["path"] == questions_path }
 if question_index