Skip to content

feat: toolpath-md and toolpath-github 0.2.0#10

Merged
akesling merged 3 commits intomainfrom
akesling/md
Mar 9, 2026
Merged

feat: toolpath-md and toolpath-github 0.2.0#10
akesling merged 3 commits intomainfrom
akesling/md

Conversation

@akesling
Copy link
Copy Markdown
Contributor

@akesling akesling commented Mar 9, 2026

Summary

  • toolpath-md 0.2.0: New crate for rendering Toolpath documents as Markdown for LLM consumption (summary and full detail modes, YAML front matter, topological sort, dead ends, review/CI/conversation rendering with friendly names). Source-specific rendering factored into source/ module — GitHub metadata extraction lives in source/github.rs behind a SourceContext interface, so the generic renderer has zero provider coupling.
  • toolpath-github 0.2.0: Enrich PR metadata capture — diff_hunk on review comments, PR summary stats (state, merged, additions, deletions, changed_files, draft, number, author), author_association, CI html_url, review body as intent, and threaded review comment replies via in_reply_to_id.
  • CLI: path render md [--input FILE] [--detail summary|full] [--front-matter]

Test plan

  • cargo test -p toolpath-md — 59 tests (52 existing + 7 new source module tests)
  • cargo clippy -p toolpath-md -- -D warnings — clean
  • cargo test -p toolpath-cli — 138 tests (126 unit + 12 integration)
  • cargo test -p toolpath-github — existing tests pass
  • Verify path render md --input examples/pr-with-reviews.json produces expected output

akesling added 2 commits March 6, 2026 16:23
New crate renders any Toolpath Document (Step, Path, Graph) as readable
Markdown for LLM consumption. Dead ends are marked inline and summarized,
steps are topologically sorted, and the output preserves enough anchoring
info (step IDs, artifact paths, actor strings) for an LLM to reference
back into the original document.

- Two detail levels: Summary (diffstats) and Full (inline fenced diffs)
- Optional YAML front matter with machine-readable metadata
- Actor definitions rendered when present in path/graph metadata
- CLI: `path render md [--input FILE] [--detail summary|full] [--front-matter]`
- 31 unit tests + 3 doc tests in toolpath-md, 6 new tests in CLI
…n toolpath-md

toolpath-github 0.2.0: capture diff_hunk, PR summary stats (state,
merged, additions, deletions, changed_files, draft, number, author),
author_association, CI html_url, review body as intent, and threaded
review comment replies via in_reply_to_id.

toolpath-md 0.2.0: render review/CI/conversation structural types with
friendly names and indicators, add PR identity line and diffstat from
GitHub metadata, add Review summary section, and factor all
source-specific logic into source/ module (source/github.rs) behind a
SourceContext interface so the generic renderer has zero provider coupling.
@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 9, 2026

🔍 Preview deployed: https://e1112f7a.toolpath.pages.dev

Add 12 snapshot tests covering `path render md` output for every
example document (7 steps, 4 paths, 1 graph). Uses insta for
snapshot management. Also applies rustfmt to toolpath-md and
toolpath-github.
@akesling akesling merged commit 0e73976 into main Mar 9, 2026
2 checks passed
@akesling akesling deleted the akesling/md branch March 9, 2026 16:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant