-
Notifications
You must be signed in to change notification settings - Fork 0
Closed
Copy link
Labels
bugSomething isn't workingSomething isn't working
Description
Describe the Bug
While using specfact backlog daily for daily standup, two issues make it hard to get a “full picture” without going interactive:
-
Comments / annotations are not exportable:
--interactiveshows item detail and comments, but there is no flag to include the same comment/discussion context in exported outputs intended for Copilot/standup summaries.--copilot-exportcurrently exports only metadata (status/assignee/last-updated/points/priority) and omits description and comments.
Request/expected: add an explicit option like
--comments/--annotations(name TBD) that includes work item discussion/comments in--summarize/--summarize-toand/or--copilot-exportfor adapters that support it (ADO/GitHub). -
Blocked items / blockers are not visible in a standup-friendly way:
- When items are in Blocked state, the standup output shows them as
Status: blocked, but the Blockers column is empty. - Additionally, in a typical standup run (e.g., filtering to Active items), blocked items (e.g., work item
#628920) are not shown unless the user explicitly filters--state "Blocked". This makes it easy to miss key blockers unless you remember to run a second command.
Request/expected:
- Either auto-populate the
Blockerscolumn from ADO state/reason or a standard field when status isblocked, OR - Provide an option like
--include-blocked(or broaden “open” state mapping) so the default standup view can surface blocked work alongside active work, and sort it to the top when--blockers-firstis used.
- When items are in Blocked state, the standup output shows them as
To Reproduce
A) Comments/annotations not exportable (non-interactive)
- Run a standup summary export:
specfact backlog daily ado --ado-org <org> --ado-project <project> --state Active --limit 50 --summarize-to .specfact/standup-summarize.md
- Run Copilot export:
specfact backlog daily ado --ado-org <org> --ado-project <project> --state Active --limit 50 --copilot-export .specfact/standup-copilot-export.md
B) Blocked state / blockers visibility
- Run standup for blocked items:
specfact backlog daily ado --state "Blocked" - Observe the table: Status is
blockedfor each item, but theBlockerscolumn remains empty.
Expected Behavior
A) Comments/annotations
- Add an explicit parameter (e.g.,
--commentsor--annotations) that includes item comments/discussion in exports. - Ideally:
--summarize/--summarize-toincludes description + comments when--comments/--annotationsis enabled (or by default if adapter supports it).--copilot-exportoptionally includes description + comments when--comments/--annotationsis enabled, so Copilot has full context without requiring interactive mode.
B) Blockers / blocked items
- For items in
blockedstatus, the output should surface a meaningful blocker signal, e.g.:- Populate
Blockerscolumn from ADO fields (blocked reason, tags, or a dedicated field), OR - At minimum, show something like
Blockers: Blocked (state)if the item is in Blocked state and no explicit blockers text exists.
- Populate
- Standup command should optionally (or by default) include blocked items alongside active items in a standup view, especially when
--blockers-firstis used, to avoid missing critical blockers.
Actual Behavior
A) Comments/annotations
- No CLI option exists to include comments/annotations in exported outputs.
--copilot-exportoutput contains only status/assignee/last-updated/story points/priority (no description, no comments).--summarize-toincludes descriptions, but comments are not included/visible in the export output (and the only documented way to review comments is--interactive).
B) Blockers / blocked items
--state "Blocked"shows blocked items in the table, but theBlockerscolumn is empty even though status is blocked.- Blocked work can be missed in a normal standup run unless
--state "Blocked"is run separately.
Environment
- OS: Windows
- Python Version: 3.11.6
- SpecFact CLI Version: 0.26.16 (
specfact --version) - Installation Method: pip installed into a virtual environment (venv)
Command Output
specfact backlog daily ado --state "Blocked"
SpecFact CLI - v0.26.16
Started: 2026-02-03 10:39:21
Daily standup
ID Title (truncated) Status Last updated Yesterday Today Blockers
123456 [Project 1] Improve feature XYZ ... blocked 2026-01-05 13:45
123457 [PYPROJECT] Refactor our code basis ... blocked 2026-01-23 09:21
123458 Improve table load logic blocked 2026-01-23 09:21
Finished: 2026-02-03 10:39:24
Codebase Context (for brownfield issues)
N/A (this is about specfact backlog daily + ADO adapter behavior, not analyzing a legacy codebase).
Additional Context
- Interactive mode (
--interactive) is the only documented mode that mentions showing comments. We need a non-interactive export option for standup/Copilot workflows. - Workaround today:
- Run
--summarize/--summarize-tofor description context - Run a separate
--state "Blocked"command to see blocked work - Use
--interactiveto view comments (but that doesn’t help when we want an “export then summarize” workflow)
- Run
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
bugSomething isn't workingSomething isn't working
Type
Projects
Status
Done