Skip to content

feat: v1.9.0 adoption & ecosystem (#124, #123, #55)#196

Merged
JoshLuedeman merged 1 commit intomainfrom
feature/v1.9.0-adoption-ecosystem
Mar 31, 2026
Merged

feat: v1.9.0 adoption & ecosystem (#124, #123, #55)#196
JoshLuedeman merged 1 commit intomainfrom
feature/v1.9.0-adoption-ecosystem

Conversation

@JoshLuedeman
Copy link
Copy Markdown
Owner

Summary

This PR delivers the Adoption & Ecosystem milestone: drift detection, workflow reports, example projects, and comprehensive docs cleanup.


#124teamwork update --check drift detection

  • internal/installer: Added CheckDrift function and DriftReport type that compare the local install (via manifest) against upstream to identify files modified locally, added upstream, or deleted locally
  • cmd/teamwork/cmd/update.go: Added --check flag that runs drift detection without writing any files; exits 1 if drift is detected (CI-friendly)
  • Tests cover all three drift categories: ModifiedLocally, AddedUpstream, DeletedLocally

#123teamwork report <workflow-id> [--format md|html|json]

  • internal/report: New package with Build (assembles state, handoffs, gate results, cost), RenderMarkdown, RenderHTML, and RenderJSON
  • cmd/teamwork/cmd/report.go: New report command supporting --format md (default), json, and html
  • Tests cover all three render formats and handle missing/partial data gracefully

#55 — Example projects

  • examples/minimal/: Feature workflow walkthrough — Go CLI project adding a --version flag, with full state file, 6-step handoff chain, memory patterns, and README
  • examples/bugfix/: Bugfix workflow walkthrough — off-by-one counter bug, with state, 3-step handoffs (coder → tester → reviewer), and README

Docs cleanup

Updated all three docs for every new command from PRs #194, #195, and this PR:

  • docs/cli.md: Added scan, timeline, resume, report, search, context, handoff init, feedback list/resolve, analytics summary, metrics agents; updated update with --check and --create-issue flags
  • docs/quick-reference.md: Added a full CLI quick-reference table covering all 30+ commands
  • docs/state-machines.md: Added Checkpointing section documenting when checkpoints are created, their schema, how to resume, and the checkpoint lifecycle

Closes #124
Closes #123
Closes #55

…reports, examples, docs cleanup (#124, #123, #55)

- installer: add CheckDrift / DriftReport for teamwork update --check
- cmd/update: --check flag exits 1 if local files have drifted from upstream
- internal/report: Build, RenderMarkdown, RenderHTML, RenderJSON for workflow reports
- cmd/report: teamwork report <id> [--format md|json|html]
- examples/minimal: feature workflow walkthrough with full handoff chain
- examples/bugfix: off-by-one fix walkthrough with state + handoffs
- docs/cli.md: document all new commands from PRs #194, #195, and this PR
- docs/quick-reference.md: add CLI quick reference table
- docs/state-machines.md: add Checkpointing section

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@JoshLuedeman JoshLuedeman merged commit 932d2ed into main Mar 31, 2026
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.

[CLI] Configuration drift detection [CLI] Exportable workflow reports [DOCS] Add example projects demonstrating Teamwork in real-world use

1 participant