status

func MdEscape ¶

func MdEscape(s string) string

MdEscape escapes the four characters that break a markdown table row or a mermaid label: pipe, backtick, the bracket pair (mermaid uses them for node syntax), and the double-quote (mermaid uses it to delimit labels). Newlines are stripped so a single field stays on one row. Conservative; not a full markdown sanitizer.

func NewCmd ¶

func NewCmd() *cobra.Command

NewCmd builds `aiwf status`: a project-wide snapshot of in-flight work, open decisions, open gaps, and recent activity. Read-only; produces no commit. Use it to answer "what's next?", "where are we?", "what are we working on?". With --worktrees, swaps the output to a worktree-organized layout (G-0122): per-worktree section, full epic expansion for epic-branch worktrees, stale/trunk catch-alls.

func ReadRecentActivity ¶

func ReadRecentActivity(ctx context.Context, root string, limit int) ([]history.HistoryEvent, error)

ReadRecentActivity returns the last `limit` commits whose message carries any `aiwf-verb:` trailer. Cross-entity, no filter — used by `aiwf status` to answer "what changed lately?" across the whole project. Events come back newest-first.

The `--grep` is an I/O-narrowing pre-filter; correctness is gated on Git's structured trailer parser (`%(trailers:key=…,valueonly=…)`). Hand-authored prose that wraps such that a line happens to start with `aiwf-verb:` would match the grep but produce an empty parsed Verb column — those records are skipped (G30). The grep over a long history is also asked for more rows than `limit` so the post-filter doesn't silently shrink the result; we then truncate.

func RenderACProgress ¶

func RenderACProgress(p *StatusACProgress) string

RenderACProgress formats the AC progress badge appended to a milestone row. Returns "" when there are no ACs (so the renderer can skip the separator). Format:

"ACs 2/3 met"           — typical case, in-scope total ≥ 1
"ACs 1/2 met (1 open)"  — when there are still open ACs
"ACs all cancelled"     — every AC was cancelled (in-scope = 0)

func RenderStatusMarkdown ¶

func RenderStatusMarkdown(w io.Writer, r *StatusReport) error

RenderStatusMarkdown writes the status report as a self-contained markdown document, with mermaid `flowchart` blocks for in-flight and roadmap epics. The output renders unchanged in any markdown viewer that supports mermaid (GitHub web, VSCode, Obsidian, glow + mermaid extension, etc.). Plain markdown — no HTML, no JS.

func RenderStatusText ¶

func RenderStatusText(w io.Writer, r *StatusReport, termWidth int, colorEnabled bool) error

RenderStatusText writes the human-readable status report to w. The in-progress milestone gets a `→` prefix; done a `✓`; draft a `○`; cancelled a `✗` — the four-glyph G-0080 palette, applied so every milestone row carries a visible state marker. Empty sections render with a parenthesised "(none)" so a glance can see "yes there are open decisions" without counting bullets. Builds the full output in a strings.Builder and writes once so the only error to surface is the final write.

termWidth caps title widths to keep rows on one visual line when stdout is a TTY narrower than the natural row; pass 0 to disable truncation (default in tests, in pipes, and under --no-trunc). colorEnabled toggles ANSI-bold section labels; row content stays escape-free so downstream tooling (grep, awk) sees plain text. The glyph palette is content, not style, and appears regardless.

func RenderWorktreeViews ¶

func RenderWorktreeViews(w io.Writer, views []WorktreeView, colorEnabled bool) error

RenderWorktreeViews writes one section per worktree to w. Each section carries the worktree path as a header, the branch on its own line prefixed with the bold ⎇ glyph, the driver entity row, and any kind-specific expansion (milestones+gaps under an epic, parent-epic breadcrumb + ACs under a milestone). Stale and trunk worktrees use the same shape with a one-line marker line — no separate top-level grouping.

G-0122.

func Run ¶

func Run(root, format string, pretty, noTrunc, worktrees bool) int

Run executes `aiwf status`. Returns one of the cliutil.Exit* codes. When worktrees is true, the output switches to the G-0122 worktree- organized layout (text format only renders the worktree sections; json format adds a `worktrees` key to the result envelope; md format ignores the flag for now).

func TruncStatusTitle ¶

func TruncStatusTitle(title string, termWidth int, prefix, tail string) string

TruncStatusTitle caps title to fit termWidth given the non-title prefix/tail of the line. Returns title unchanged when termWidth is 0 (no TTY / --no-trunc) or when the available room would fall below the per-G-0080 minimum useful column width. The minimum (10 runes) is the same floor renderListRowsText uses — see list.MinTitleColumnRunes.

func WriteStatusEpicMarkdown ¶

func WriteStatusEpicMarkdown(b *strings.Builder, e StatusEpic)

WriteStatusEpicMarkdown writes one epic — header, milestone list, and a mermaid `flowchart LR` keyed by milestone status — into b. Empty milestone lists render an explicit "(no milestones)" line so the section stays visually balanced and the diagram is omitted (mermaid barfs on a flowchart with one node and no edges).

func WriteStatusEpicText ¶

func WriteStatusEpicText(b *strings.Builder, e StatusEpic, termWidth int)

WriteStatusEpicText writes one epic plus its milestones in the terminal-friendly shape shared by the In flight and Roadmap sections. termWidth caps title widths so long titles don't wrap into the next row's column-zero (the G-0080 visual-scan bug); 0 disables truncation.

Milestone rows lead with a glyph from the G-0080 palette so every row carries a visible state marker — the in-progress and done glyphs (→ ✓) have always been present; this function also emits ○ for draft and ✗ for cancelled so the four-glyph palette is uniformly applied across all milestone states.