@guanlin4924/devflow-pi 0.1.39 → 0.1.47

package/plugins/devflow-core/skills/wireframe-proposal/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: wireframe-proposal
+description: Generate or revise a low-fidelity wireframe proposal from controlled requirements. Use during the wireframe-proposal workflow step.
+---
+
+# Wireframe Proposal
+
+Read the controlled requirement baseline and the wireframe schema/registry. Produce exactly two candidate files:
+
+- .planning/features/{feature}/proposal.yaml
+- .planning/features/{feature}/questions.yaml
+
+Use only registered element types and screen-level requirement_refs. Keep IDs stable during revision. Do not add API fields, coordinates, CSS, nested children, or approval fields. Emit valid YAML only and never claim that the proposal is validated or approved. The validator and Core decide legality, fingerprints, and approval.

package/plugins/devflow-core/skills/wireframe-proposal/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "wireframe-proposal"
+  short_description: "AI 生成或修订低保真原型 proposal 与 questions 候选"
+  default_prompt: "AI 生成或修订低保真原型 proposal 与 questions 候选"

package/plugins/devflow-core/skills/wireframe-render/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: wireframe-render
+description: Render validated canonical wireframe JSON into deterministic Markdown and SVG previews. Use after wireframe-validate.
+---
+
+# Wireframe Render
+
+Call the workflow-orchestrator wireframe_render.py script only with the current Core-built canonical JSON. Generate preview Markdown, flow SVG, page SVGs, and the optional static gallery under the wireframe output directory. Never read proposal YAML as a substitute, mutate canonical JSON, write approval, or modify workflow state.

package/plugins/devflow-core/skills/wireframe-review/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: wireframe-review
+description: Present validated wireframe previews and unresolved questions for explicit user review. Use at the wireframe-review checkpoint.
+---
+
+# Wireframe Review
+
+Show the current canonical-derived previews, renderer metadata, validation verdict, and unresolved question IDs. If the verdict is await_user, ask the user to answer the listed blocking questions. If the user approves, return control to the Core checkpoint path. Never write approval, pass runtime confirmation, confirm a checkpoint, or alter canonical/state yourself.

package/plugins/devflow-core/skills/wireframe-validate/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: wireframe-validate
+description: Run deterministic validation for a wireframe proposal and build canonical JSON. Use after wireframe-proposal.
+---
+
+# Wireframe Validate
+
+Call the workflow-orchestrator wireframe_validate.py script with the current proposal, traceability JSON, and questions file. Preserve its structured verdict: allow, await_user, or block_unsafe. Do not edit proposal or questions, repair unknown fields, write approval, or modify workflow state.

package/plugins/devflow-core/skills/wireframe-validate/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "wireframe-validate"
+  short_description: "确定性校验低保真原型 proposal 并生成 canonical"
+  default_prompt: "确定性校验低保真原型 proposal 并生成 canonical"

package/plugins/devflow-core/skills/workflow-orchestrator/SKILL.md

@@ -73,7 +73,7 @@ Each step execution follows this fixed sequence:
 5. Ensure the skill writes both its `outputs` AND its `meta_output` (the `.meta.json` file).
 
 **After execution:**
-6. Verify the step's outputs exist, record the revision returned by `devflow_state(action="inspect")`, then call `devflow_transition(action="complete-step", step="<step-id>", expectedRevision=<revision>)`.
+6. Verify the step's outputs exist and record the revision returned by `devflow_state(action="inspect")`. **Do not call `devflow_transition` or write `xd://devflow_transition`: the Devflow Runtime owns the user confirmation and the atomic state transition after this agent turn.**
 7. If the YAML step has `meta_output`, verify the `.meta.json` file exists and has the required fields. If missing, mark the step as `blocked` with reason "missing_meta_output".
 8. `devflow_transition` validates the proposed state before writing and rejects inconsistent updates. Never repeat the transition after it reports success.
 9. Call `devflow_artifact(action="sync", preserve=false)` only when the registry still shows stale `planned`/`generated` statuses for completed steps.
@@ -200,6 +200,20 @@ devflow_recovery(expectedRevision=<recovery_plan.expected_revision>, confirm=tru
 
 This is registry-only: it derives file existence/content metadata from the filesystem and never changes `completed_steps`, `pending_steps`, `current_step`, checkpoint state, or workflow status. Plans classified `unsafe` (for example missing required output or conflicting state tracking) must be corrected manually; recovery refuses them.
 
+For a legacy parallel window whose worker artifacts are complete but whose
+terminal lifecycle events were lost, use the Core recovery writer. It validates
+all registered outputs and Core machine evidence before changing any branch,
+uses STATE/run CAS revisions, and delegates the final join to `advance_state.rb`:
+
+```text
+ruby scripts/parallel_recover.rb --feature "<feature>" \
+  --expected-state-revision <state-revision> \
+  --expected-run-revision <run-revision> --write --json
+```
+
+Do not use this command for failed/aborted branches or missing/invalid outputs;
+those require explicit branch retry or artifact repair first.
+
 When `devflow_transition` succeeds, it automatically regenerates the Markdown body of STATE.md from the YAML state + artifact registry. The body is marked `<!-- GENERATED — DO NOT EDIT -->` and must not be manually edited.
 
 ## Lessons Rules
@@ -272,6 +286,7 @@ The generated files may be project-specific instances, but their creation path m
 | `scripts/sync_artifacts.rb` | Generates artifact registry with content validation. |
 | `scripts/validate_state.rb` | Verifies STATE.md, workflow steps, dependencies, outputs, meta outputs, and artifact statuses agree before dispatch or writeback. |
 | `scripts/advance_state.rb` | State writeback + Markdown body auto-generation. |
+| `scripts/parallel_recover.rb` | Audited, CAS-guarded recovery and join for legacy lost parallel lifecycle events. |
 | `scripts/update_triage_route.rb` | Deterministically updates `.planning/requirements/{feature}/入口分诊.meta.json` route/status after clarify or wayfinder. |
 | `scripts/manage_lessons.rb` | Lesson candidate selector and evidence-based template writer. |
 | `templates/` | Portable workflow templates used by `init_workflow.rb`. |

package/plugins/devflow-core/skills/workflow-orchestrator/contracts/business-candidate-delta.schema.yaml

@@ -0,0 +1,41 @@
+schema_version: 1
+title: Devflow business model candidate delta
+strict: true
+id_pattern: '^[A-Za-z][A-Za-z0-9_-]*$'
+top_level:
+  required:
+    - schema_version
+    - feature
+    - aggregate_revision
+    - aggregate_fingerprint
+    - source_registry_fingerprint
+    - conflict_ids
+    - assumption_ids
+    - proposed_by
+    - operations
+  properties:
+    schema_version: {type: integer, const: 1}
+    feature: {type: string, non_empty: true}
+    aggregate_revision: {type: integer, minimum: 0}
+    aggregate_fingerprint: {type: string, non_empty: true}
+    source_registry_fingerprint: {type: string, non_empty: true}
+    conflict_ids: {type: array, items: id}
+    assumption_ids: {type: array, items: id}
+    proposed_by: {type: string, non_empty: true}
+    rationale: {type: string}
+    operations: {type: array, min_items: 1}
+operation:
+  required: [op, collection, target_id]
+  properties:
+    op: {type: enum, values: [add, replace, remove]}
+    collection: {type: enum, values: [actors, entities, components, boundaries, resources, rules, actions]}
+    target_id: {type: id}
+    value: {type: object_or_null}
+    source_refs: {type: array, items: id}
+canonical:
+  target_invariant:
+    at_least_one_non_empty: [conflict_ids, assumption_ids]
+  normalization: [NFKC, trim_trailing_spaces, LF]
+  arrays: preserve_order
+  root_order: [schema_version, feature, aggregate_revision, aggregate_fingerprint, source_registry_fingerprint, conflict_ids, assumption_ids, proposed_by, rationale, operations]
+  operation_order: [op, collection, target_id, value, source_refs]

package/plugins/devflow-core/skills/workflow-orchestrator/contracts/business-claim.schema.yaml

@@ -0,0 +1,10 @@
+schema_version: 1
+strict: true
+claim:
+  required: [id, text, kind]
+  properties:
+    id: {type: string, non_empty: true}
+    text: {type: string, non_empty: true}
+    kind: {type: enum, values: [business, technical]}
+    business_action_ref: {type: string}
+    requirement_ref: {type: string}

package/plugins/devflow-core/skills/workflow-orchestrator/contracts/business-model-policy.yaml

@@ -0,0 +1,51 @@
+schema_version: 1
+name: business-model-gate-policy
+transition_kinds:
+  - modeling
+  - adjudicating
+  - freeze
+  - consume_downstream
+default:
+  modeling: await_user
+  adjudicating: await_user
+  freeze: block_unsafe
+  consume_downstream: block_unsafe
+rules:
+  - codes:
+      - BUSINESS_ASSUMPTION_UNRESOLVED
+      - BUSINESS_REQUIREMENT_UNCOVERED
+      - BUSINESS_RESOURCE_PRODUCER_MISSING
+      - BUSINESS_RESOURCE_CONSUMER_MISSING
+      - BUSINESS_EXTERNAL_BOUNDARY_MISSING
+      - BUSINESS_STATE_ENTRY_MISSING
+      - BUSINESS_STATE_EXIT_MISSING
+      - BUSINESS_FLOW_NO_TERMINAL_PATH
+      - BUSINESS_FLOW_START_MISSING
+      - BUSINESS_RULE_DEFAULT_MISSING
+      - TECHNICAL_CLAIM_UNGROUNDED
+    modeling: await_user
+    adjudicating: await_user
+    freeze: block_unsafe
+    consume_downstream: block_unsafe
+  - codes:
+      - BUSINESS_PROVENANCE_SOURCE_INVALID
+      - BUSINESS_SOURCE_NOT_FOUND
+      - BUSINESS_SOURCE_LOCATOR_INVALID
+      - BUSINESS_REFERENCE_NOT_FOUND
+      - BUSINESS_REF_NOT_FOUND
+      - BUSINESS_FINGERPRINT_DRIFT
+      - BUSINESS_FORGED_EVIDENCE
+      - BUSINESS_DERIVED_FIELD_FORBIDDEN
+      - BUSINESS_CHECKER_CONFIGURATION_INVALID
+    modeling: block_unsafe
+    adjudicating: block_unsafe
+    freeze: block_unsafe
+    consume_downstream: block_unsafe
+  - codes:
+      - BUSINESS_CONFLICT_UNRESOLVED
+      - BUSINESS_CANONICAL_NOT_FROZEN
+      - BUSINESS_SOURCE_NOT_REGISTERED
+    modeling: await_user
+    adjudicating: await_user
+    freeze: block_unsafe
+    consume_downstream: block_unsafe

package/plugins/devflow-core/skills/workflow-orchestrator/contracts/business-model.schema.yaml

@@ -0,0 +1,241 @@
+schema_version: 1
+title: Devflow business model proposal and canonical contract
+strict: true
+id_pattern: '^[A-Za-z][A-Za-z0-9_-]*$'
+
+top_level:
+  required:
+    - schema_version
+    - feature
+    - actors
+    - entities
+    - components
+    - boundaries
+    - resources
+    - rules
+    - actions
+    - requirement_refs
+    - decision_refs
+    - resolved_assumption_refs
+    - source_registry_ref
+  properties:
+    schema_version: {type: integer, const: 1}
+    feature: {type: string, non_empty: true, path_segment: true}
+    actors: {type: array}
+    entities: {type: array}
+    components: {type: array}
+    boundaries: {type: array}
+    resources: {type: array}
+    rules: {type: array}
+    actions: {type: array}
+    requirement_refs: {type: array, items: id}
+    decision_refs: {type: array, items: id}
+    resolved_assumption_refs: {type: array, items: id}
+    source_registry_ref: {type: string, non_empty: true}
+    assumptions: {type: array}
+  forbidden_derived:
+    - transitions
+    - responsibilities
+    - dependencies
+    - inputs
+    - outputs
+
+objects:
+  actor:
+    required: [id, source_refs]
+    properties:
+      id: {type: id}
+      name: {type: string, non_empty: true}
+      source_refs: {type: array, items: id, min_items: 1}
+  entity:
+    required: [id, states, source_refs]
+    properties:
+      id: {type: id}
+      name: {type: string, non_empty: true}
+      states: {type: array}
+      source_refs: {type: array, items: id, min_items: 1}
+  state:
+    required: [id, name, source_refs]
+    properties:
+      id: {type: id}
+      name: {type: string, non_empty: true}
+      terminal: {type: boolean}
+      source_refs: {type: array, items: id, min_items: 1}
+  component:
+    required: [id, source_refs]
+    properties:
+      id: {type: id}
+      name: {type: string, non_empty: true}
+      source_refs: {type: array, items: id, min_items: 1}
+  boundary:
+    required: [id, source_refs]
+    properties:
+      id: {type: id}
+      name: {type: string, non_empty: true}
+      system: {type: string, non_empty: true}
+      source_refs: {type: array, items: id, min_items: 1}
+  resource:
+    required: [id, origin, source_refs]
+    properties:
+      id: {type: id}
+      name: {type: string, non_empty: true}
+      origin: {type: resource_origin}
+      source_refs: {type: array, items: id, min_items: 1}
+  rule:
+    required: [id, kind, source_refs]
+    properties:
+      id: {type: id}
+      name: {type: string, non_empty: true}
+      kind: {type: enum, values: [constraint, decision]}
+      evaluation: {type: enum, values: [first_match]}
+      input_refs: {type: array, items: id}
+      branches: {type: array}
+      expression: {type: condition}
+      source_refs: {type: array, items: id, min_items: 1}
+  branch:
+    required: [id, next_action_refs, source_refs]
+    properties:
+      id: {type: id}
+      when: {type: condition}
+      default: {type: boolean}
+      next_action_refs: {type: array, items: id, min_items: 1}
+      source_refs: {type: array, items: id, min_items: 1}
+  action:
+    required:
+      - id
+      - requirement_refs
+      - actor_ref
+      - owner_ref
+      - trigger
+      - consumes
+      - produces
+      - constraint_rule_refs
+      - routing
+      - failure_modes
+      - source_refs
+    properties:
+      id: {type: id}
+      name: {type: string, non_empty: true}
+      requirement_refs: {type: array, items: id, min_items: 1}
+      actor_ref: {type: id}
+      owner_ref: {type: id}
+      trigger: {type: string, non_empty: true}
+      entity_ref: {type: id}
+      from_state_ref: {type: id}
+      to_state_ref: {type: id}
+      consumes: {type: array, items: id}
+      produces: {type: array, items: id}
+      constraint_rule_refs: {type: array, items: id}
+      routing: {type: routing}
+      failure_modes: {type: array}
+      source_refs: {type: array, items: id, min_items: 1}
+  routing:
+    required: []
+    properties:
+      next_action_refs: {type: array, items: id, min_items: 1}
+      decision_rule_ref: {type: id}
+      terminal: {type: boolean}
+  failure_mode:
+    required: [code, source_refs]
+    properties:
+      code: {type: id}
+      recovery_action_ref: {type: id}
+      terminal: {type: boolean}
+      terminal_state_ref: {type: id}
+      source_refs: {type: array, items: id, min_items: 1}
+  assumption:
+    required: [id, statement, proposed_by, affected_refs, status]
+    properties:
+      id: {type: id}
+      statement: {type: string, non_empty: true}
+      proposed_by: {type: string, non_empty: true}
+      affected_refs: {type: array, items: id, min_items: 1}
+      status: {type: enum, values: [unresolved]}
+  conflict:
+    required: [id, subject_ref, collection, field, alternatives, status]
+    properties:
+      id: {type: id}
+      subject_ref: {type: id}
+      collection: {type: string, non_empty: true}
+      field: {type: string, non_empty: true}
+      alternatives: {type: array, min_items: 2}
+      status: {type: enum, values: [unresolved, resolved]}
+  alternative:
+    required: [present, proposal_refs]
+    properties:
+      present: {type: boolean}
+      value: {type: any}
+      proposal_refs: {type: array, items: string, min_items: 1}
+
+unions:
+  resource_origin:
+    discriminator: kind
+    variants:
+      produced_in_flow:
+        required: [kind, lifecycle_owner_ref]
+        properties:
+          kind: {const: produced_in_flow}
+          lifecycle_owner_ref: {type: id}
+      user_supplied:
+        required: [kind, actor_ref, intake_action_ref]
+        properties:
+          kind: {const: user_supplied}
+          actor_ref: {type: id}
+          intake_action_ref: {type: id}
+      external_system:
+        required: [kind, boundary_ref, receive_action_ref]
+        properties:
+          kind: {const: external_system}
+          boundary_ref: {type: id}
+          receive_action_ref: {type: id}
+      preexisting_project:
+        required: [kind, code_source_ref, lifecycle_owner_ref]
+        properties:
+          kind: {const: preexisting_project}
+          code_source_ref: {type: id}
+          lifecycle_owner_ref: {type: id}
+
+conditions:
+  operators: [eq, ne, in, and, or, not, lt, lte, gt, gte, exists]
+  operand_variants:
+    literal: [kind, value]
+    resource_attribute: [kind, resource_ref, attribute]
+    entity_state: [kind, entity_ref, state_ref]
+    actor_attribute: [kind, actor_ref, attribute]
+
+canonical:
+  normalization: [NFKC, trim_trailing_spaces, LF]
+  arrays: preserve_order
+  root_order:
+    - schema_version
+    - feature
+    - actors
+    - entities
+    - components
+    - boundaries
+    - resources
+    - rules
+    - actions
+    - requirement_refs
+    - decision_refs
+    - resolved_assumption_refs
+    - source_registry_ref
+    - assumptions
+  object_orders:
+    actor: [id, name, source_refs]
+    entity: [id, name, states, source_refs]
+    state: [id, name, terminal, source_refs]
+    component: [id, name, source_refs]
+    boundary: [id, name, system, source_refs]
+    resource: [id, name, origin, source_refs]
+    resource_origin: [kind, lifecycle_owner_ref, actor_ref, intake_action_ref, boundary_ref, receive_action_ref, code_source_ref]
+    rule: [id, name, kind, evaluation, input_refs, branches, expression, source_refs]
+    branch: [id, when, default, next_action_refs, source_refs]
+    condition: [op, args, operand, left, right]
+    operand: [kind, value, resource_ref, entity_ref, state_ref, actor_ref, attribute]
+    action: [id, name, requirement_refs, actor_ref, owner_ref, trigger, entity_ref, from_state_ref, to_state_ref, consumes, produces, constraint_rule_refs, routing, failure_modes, source_refs]
+    routing: [next_action_refs, decision_rule_ref, terminal]
+    failure_mode: [code, recovery_action_ref, terminal, terminal_state_ref, source_refs]
+    assumption: [id, statement, proposed_by, affected_refs, status]
+    conflict: [id, subject_ref, collection, field, alternatives, status]
+    alternative: [present, value, proposal_refs]

package/plugins/devflow-core/skills/workflow-orchestrator/contracts/business-source-registry.schema.yaml

@@ -0,0 +1,80 @@
+schema_version: 1
+title: Devflow business source registry
+strict: true
+id_pattern: '^SRC-[A-Za-z0-9][A-Za-z0-9_-]*$'
+top_level:
+  required: [schema_version, feature, registry_revision, sources]
+  properties:
+    schema_version: {type: integer, const: 1}
+    feature: {type: string, non_empty: true}
+    registry_revision: {type: integer, minimum: 0}
+    sources: {type: array}
+source:
+  required: [id, type]
+  properties:
+    id: {type: id}
+    type: {type: enum, values: [requirement, code, domain_rule, user_decision]}
+source_variants:
+  requirement:
+    required: [id, type, document, source_fingerprint, locator]
+    properties:
+      id: {type: id}
+      type: {const: requirement}
+      document: {type: string, non_empty: true}
+      source_fingerprint: {type: string, non_empty: true}
+      locator: {type: requirement_locator}
+  code:
+    required: [id, type, repository, repository_revision, worktree_signature, index_generation, path, content_hash, locator]
+    properties:
+      id: {type: id}
+      type: {const: code}
+      repository: {type: string, non_empty: true}
+      repository_revision: {type: string, non_empty: true}
+      worktree_signature: {type: string, non_empty: true}
+      index_generation: {type: string, non_empty: true}
+      path: {type: string, non_empty: true}
+      content_hash: {type: string, non_empty: true}
+      commit: {type: string}
+      locator: {type: code_locator}
+  domain_rule:
+    required: [id, type, document, source_fingerprint, locator]
+    properties:
+      id: {type: id}
+      type: {const: domain_rule}
+      document: {type: string, non_empty: true}
+      source_fingerprint: {type: string, non_empty: true}
+      locator: {type: domain_locator}
+  user_decision:
+    required: [id, type, decision_revision, decision_fingerprint, locator]
+    properties:
+      id: {type: id}
+      type: {const: user_decision}
+      decision_revision: {type: integer, minimum: 0}
+      decision_fingerprint: {type: string, non_empty: true}
+      locator: {type: decision_locator}
+locator_variants:
+  requirement:
+    required: [requirement_ref, assertion_id]
+    properties:
+      requirement_ref: {type: id}
+      assertion_id: {type: id}
+  code:
+    required: []
+    at_least_one: [symbol, line_start]
+    properties:
+      symbol: {type: string, non_empty: true}
+      line_start: {type: integer, minimum: 1}
+  domain_rule:
+    required: [clause_id]
+    properties:
+      clause_id: {type: id}
+  user_decision:
+    required: [decision_id]
+    properties:
+      decision_id: {type: id}
+canonical:
+  normalization: [NFKC, trim_trailing_spaces, LF]
+  arrays: preserve_order
+  root_order: [schema_version, feature, registry_revision, sources]
+  source_order: [id, type, document, source_fingerprint, repository, repository_revision, worktree_signature, index_generation, path, content_hash, commit, decision_revision, decision_fingerprint, locator]
+  locator_order: [requirement_ref, assertion_id, symbol, line_start, clause_id, decision_id]

package/plugins/devflow-core/skills/workflow-orchestrator/contracts/proposal.schema.yaml

@@ -0,0 +1,44 @@
+schema_version: 1
+title: Devflow low-fidelity wireframe proposal
+strict: true
+top_level:
+  required: [schema_version, feature, screens]
+  properties:
+    schema_version: {type: integer, const: 1}
+    feature: {type: string, non_empty: true}
+    screens: {type: array, min_items: 1}
+screen:
+  required: [id, title, requirement_refs, elements, states]
+  defaults: {presentation: page, platforms: [web, mobile], actions: []}
+  properties:
+    id: {type: id}
+    title: {type: string, non_empty: true}
+    presentation: {type: enum, values: [page, modal, drawer]}
+    platforms: {type: array, values: [web, mobile], unique: true, min_items: 1}
+    requirement_refs: {type: array, min_items: 1}
+    elements: {type: array}
+    actions: {type: array}
+    states: {type: array, values: [default, empty, loading, error], unique: true, contains: default}
+elements:
+  page_header: {title: string, action_refs: [id]}
+  filter_bar: {fields: [{id: id, label: string, type: [input, select]}]}
+  table: {columns: [{id: id, label: string}]}
+  card_list: {items: [{id: id, title: string, meta: [{label: string, value: string}]}]}
+  bottom_navigation: {items: [{id: id, label: string, action_ref: id}]}
+  tabs: {tabs: [{id: id, label: string}]}
+  input: {label: string, action_ref: id}
+  select: {label: string, action_ref: id}
+  button: {label: string, action_ref: id}
+  icon_button: {label: string, action_ref: id}
+action:
+  required: [id, type, target]
+  properties:
+    id: {type: id}
+    type: {type: enum, values: [open, close, back]}
+    target: {type: string_or_null}
+    business_action_ref: {type: id}
+id_pattern: '^[A-Za-z0-9][A-Za-z0-9_-]*$'
+canonical:
+  object_keys: schema_order
+  arrays: preserve_order
+  normalization: [NFKC, trim_trailing_spaces, LF]

package/plugins/devflow-core/skills/workflow-orchestrator/contracts/questions.schema.yaml

@@ -0,0 +1,14 @@
+schema_version: 1
+title: Devflow wireframe questions
+strict: true
+top_level:
+  required: [schema_version, feature, questions]
+question:
+  required: [id, text, kind, status]
+  properties:
+    id: {type: id}
+    text: {type: string, non_empty: true}
+    kind: {type: enum, values: [blocking, informational]}
+    status: {type: enum, values: [open, resolved]}
+    target: {type: object, properties: [screen, element]}
+    answer: {type: string_or_null}

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

@@ -10,12 +10,13 @@ require "optparse"
 require_relative "control_io"
 require_relative "requirement_graph"
 
-options = { feature: nil, expected_graph_revision: nil, cp_record: nil, write: false, json: false }
+options = { feature: nil, expected_graph_revision: nil, cp_record: nil, confirm_prerequisites: false, write: false, json: false }
 command = ARGV.shift
 OptionParser.new do |parser|
   parser.on("--feature NAME") { |value| options[:feature] = value }
   parser.on("--expected-graph-revision REVISION", Integer) { |value| options[:expected_graph_revision] = value }
   parser.on("--cp-record RECORD") { |value| options[:cp_record] = value }
+  parser.on("--confirm-prerequisites") { options[:confirm_prerequisites] = true }
   parser.on("--write") { options[:write] = true }
   parser.on("--json") { options[:json] = true }
 end.parse!
@@ -48,6 +49,14 @@ begin
 
   if command == "inspect"
     view = RequirementGraph.view_payload(graph, "tests")
+    unconfirmed_prerequisites = RequirementGraph.candidate_test_prerequisites(graph).map do |node|
+      data = node["data"].is_a?(Hash) ? node["data"] : {}
+      {
+        "id" => node["id"],
+        "kind" => node["kind"],
+        "summary" => data["name"] || data["outcome"] || data["summary"] || data["locator"] || data["requirement_ref"]
+      }.compact
+    end
     result = {
       "ok" => true,
       "path" => relative,
@@ -55,7 +64,8 @@ begin
       "test_case_ids" => cases.map { |node| node["id"] },
       "frozen" => view["frozen"],
       "frozen_graph_revision" => view["frozen_graph_revision"],
-      "stale" => Array(graph["stale"]).select { |entry| cases.any? { |node| node["id"] == entry["node_id"] } }
+      "stale" => Array(graph["stale"]).select { |entry| cases.any? { |node| node["id"] == entry["node_id"] } },
+      "unconfirmed_prerequisites" => unconfirmed_prerequisites
     }
   else
     raise ArgumentError, "--write is required" unless options[:write]
@@ -72,7 +82,7 @@ begin
     else
       matrix = api_test_matrix_check(root, options[:feature], graph)
       result = if matrix["ok"]
-                 RequirementGraph.freeze_test_cases!(root, graph, options[:cp_record])
+                 RequirementGraph.freeze_test_cases!(root, graph, options[:cp_record], confirm_prerequisites: options[:confirm_prerequisites])
                else
                  { "ok" => false, "reason" => "api_test_matrix_incomplete", "message" => Array(matrix["errors"]).join("; "), "matrix" => matrix }
                end