Skip to content

Version Jira transition read-only planner reports #629

@StatPan

Description

@StatPan

Goal

Make gira jira transition --dry-run --json a stable read-only planner contract so adapters can consume Jira transition reachability without mistaking it for approval to mutate Jira.

Scope

  • Add a stable jira-transition-plan/v1 schema version to Jira transition plan reports.
  • Preserve explicit read-only evidence fields and keep approval evidence absent by design.
  • Ensure CLI JSON output adds the schema version even when tests inject report builders.
  • Update the agent-kernel adapter contract to treat Jira transition as schema-versioned read-only planning, not shared apply approval evidence.

Acceptance Criteria

  • Jira transition JSON includes schema_version: jira-transition-plan/v1, dry_run: true, and read_only: true.
  • Jira transition JSON does not include approval evidence.
  • Direct transition, manual-admin, missing-transition, and unmapped-status decisions remain compatible.
  • Adapter docs no longer list Jira transition as a remaining shared approval-envelope gap.

Expected Delivery

Open one implementation PR with focused tests for core planner reports and CLI JSON output. Merge after checks pass.

Parent: #521

base_branch: main
base_source: branch_policy.default
branch_policy_mode: github-flow
target: default
work_branch: issue-629-version-jira-transition-read-only-planner-reports

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:aiAI and agent workflow behavior.area:backendBackend, CLI, and core workflow implementation.priority:p1High priority work.status:doneWork is completed with merged, closed, or accepted completion evidence.type:taskConcrete implementation task.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions