Skip to content

Add backlog dependency analysis and command suites #116

@djm81

Description

@djm81

Why

After implementing backlog adapters for ADO and GitHub with directional sync (v0.25.1), we need to extend the backlog capabilities beyond simple sync to enable dependency analysis, delta tracking, and integrated DevOps workflows. Without dependency graph analysis, teams cannot understand logical relationships between backlog items (epic → feature → story → task hierarchies) or detect blockers and circular dependencies. Without dedicated backlog/delta command suites, users must use low-level bridge sync commands instead of intuitive backlog-focused workflows. Adding these capabilities establishes SpecFact CLI as the comprehensive DevOps tool for agile workflows.

What Changes

  • Implement provider-agnostic dependency graph model and template-driven mapping (BacklogGraph, BacklogGraphBuilder).
  • Add graph analyzers: transitive closure, cycle detection, critical path, impact analysis.
  • Add CLI: specfact backlog analyze-deps, backlog sync, backlog diff, backlog promote, backlog verify-readiness, backlog generate-release-notes; specfact delta status, delta impact, delta cost-estimate, delta rollback-analysis.
  • Extend project commands: snapshot, regenerate, link-backlog, export-roadmap, health-check, devops-flow.
  • E4 (plan): Outputs for teams: dependency contract per edge, ROAM list seed, critical path narrative. Add --export json|md. Acceptance: specfact backlog analyze-deps can export a "dependency review packet" (Markdown).

Acceptance Criteria

  • Dependency graph model and analyzers implemented; CLI commands under backlog and delta groups.
  • specfact backlog analyze-deps can export a dependency review packet (Markdown).
  • Configuration in .specfact/spec.yaml; adapter methods for bulk fetch.

OpenSpec Change Proposal: add-backlog-dependency-analysis-and-commands

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    Status

    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions