Skip to content

Migrate backlog-core commands to specfact-backlog bundle #389

@djm81

Description

@djm81

Migrate backlog-core commands to specfact-backlog bundle

Why

Commit 978cc82 deleted the backlog-core module (containing add, analyze-deps, trace-impact, verify-readiness, diff, sync, promote, generate-release-notes, delta commands) as part of backlog ownership cleanup. However, these commands were never migrated to the nold-ai/specfact-backlog bundle. Result: documented commands are missing from the CLI, creating a product/runtime alignment gap where README and docs describe commands that fail with "No such command".

What Changes

  • RECOVER deleted backlog-core command implementations from worktree/git history
  • MIGRATE commands into specfact-backlog bundle under appropriate subcommand structure
  • INTEGRATE command registrations with specfact-backlog's Typer app structure
  • ADD ceremony aliases for high-impact commands (e.g., backlog ceremony addbacklog add)
  • UPDATE docs to reflect restored command availability
  • DEPRECATE legacy backlog-core module references in favor of bundle-only ownership

Capabilities

New Capabilities

  • backlog-add: Interactive and non-interactive backlog item creation with parent validation, DoR checks, and adapter-specific payload construction (GitHub, ADO).
  • backlog-sync: Bidirectional backlog synchronization with cross-adapter state mapping and lossless round-trip support.
  • backlog-delta: Delta analysis commands (status, impact, cost-estimate, rollback-analysis) for backlog graph change tracking.
  • backlog-analyze-deps: Dependency graph analysis for backlog items with cycle detection and impact surfacing.
  • backlog-verify-readiness: Definition of Ready (DoR) validation against configurable rules before sprint planning.
  • backlog-diff: Compare backlog states between snapshots or adapters.
  • backlog-promote: Promote backlog items through hierarchy (story → feature → epic) with state preservation.
  • backlog-generate-release-notes: Generate release notes from backlog item collections and completion status.

Modified Capabilities

  • daily-standup: Extend ceremony alias coverage to include migrated commands where appropriate.
  • backlog-daily-markdown-normalization: Ensure migrated commands support Markdown normalization for consistency.

Dependencies

  • backlog-module-ownership-cleanup (archived): Established that specfact-backlog should own all backlog commands.
  • module-migration-10-bundle-command-surface-alignment: Validates documented vs runtime command surface; this change closes the backlog gap.

Impact

  • User-facing: Restores documented commands (backlog add, sync, delta, etc.) to working state.
  • Breaking: Removes dependency on legacy backlog-core module; commands now require nold-ai/specfact-backlog bundle installed.
  • Docs: Update agile-scrum-workflows.md, backlog guides, and README to confirm command availability.

OpenSpec Change Proposal: backlog-02-migrate-core-commands

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingchange-proposalProposal for a new changedevops-backlogDevOps Agile Backlog integrationsopenspec

    Type

    Projects

    Status

    In Progress

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions