feat(workflows): add community ops automation workflow example #32

puygob236 · 2026-05-24T14:51:32+08:00

puygob236 commented

2026-05-24 14:51:32 +08:00

Summary

This PR adds a reproducible end-to-end workflow example under examples/workflows/community-ops-automation/.

The example operationalizes existing gitlink-cli capabilities for a community operations scenario. It collects repository, issue, pull request, and release activity, normalizes the returned data, generates a weekly Markdown report, drafts Release Notes, emits a structured JSON summary, and can optionally publish the summary back to a GitLink issue comment.

What is included

scripts/gitlink_workflow.py: workflow runner for data collection, metric aggregation, report generation, and optional issue publishing.
scripts/run_demo.ps1: one-command reproduction script for Windows/PowerShell environments.
examples/sample_config.json and examples/demo_active_config.json: reproducible repository configurations.
examples/demo_outputs/: checked-in sample outputs generated from real GitLink repositories.
docs/: architecture, quickstart, runbook, verification record, and operational notes.
tests/test_gitlink_workflow.py: unit tests for data normalization, report generation, stale item detection, and issue comment command construction.

Validation

python -m unittest discover -s tests
Result: Ran 5 tests ... OK

The workflow has also been validated against real GitLink repositories, including GitLink/gitlink-cli and puygob236/gitlink-cli, with generated reports and example outputs included in the workflow directory.

## Summary This PR adds a reproducible end-to-end workflow example under `examples/workflows/community-ops-automation/`. The example operationalizes existing `gitlink-cli` capabilities for a community operations scenario. It collects repository, issue, pull request, and release activity, normalizes the returned data, generates a weekly Markdown report, drafts Release Notes, emits a structured JSON summary, and can optionally publish the summary back to a GitLink issue comment. ## What is included - `scripts/gitlink_workflow.py`: workflow runner for data collection, metric aggregation, report generation, and optional issue publishing. - `scripts/run_demo.ps1`: one-command reproduction script for Windows/PowerShell environments. - `examples/sample_config.json` and `examples/demo_active_config.json`: reproducible repository configurations. - `examples/demo_outputs/`: checked-in sample outputs generated from real GitLink repositories. - `docs/`: architecture, quickstart, runbook, verification record, and operational notes. - `tests/test_gitlink_workflow.py`: unit tests for data normalization, report generation, stale item detection, and issue comment command construction. ## Validation - `python -m unittest discover -s tests` - Result: `Ran 5 tests ... OK` The workflow has also been validated against real GitLink repositories, including `GitLink/gitlink-cli` and `puygob236/gitlink-cli`, with generated reports and example outputs included in the workflow directory.

puygob236 added 1 commit 2026-05-24 14:51:36 +08:00

9ebed898ac feat(workflows): add community ops automation example

wbtiger merged commit f888dd39ed into master

2026-05-26 23:58:12 +08:00

wbtiger referenced this issue from a commit

2026-05-26 23:58:13 +08:00

Merge pull request 'feat(workflows): add community ops automation workflow example' (#32) from puygob236/gitlink-cli:community-ops-automation-pr into master

Sign in to join this conversation.

No reviewers

No Label

No Milestone

No project

No Assignees

1 Participants

Notifications

Due Date

The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Gitlink/gitlink-cli#32