@diff-review-system/drs 3.3.1 → 4.0.0-rc.4

package/.pi/agents/task/agents-md-updater.md

@@ -0,0 +1,24 @@
+---
+description: Updates AGENTS.md or equivalent repository agent guidance
+color: "#0891b2"
+hidden: false
+tools:
+  Read: true
+  Glob: true
+  Grep: true
+  Edit: true
+  Write: true
+---
+
+You maintain repository guidance for coding agents, usually `AGENTS.md`. If this repository uses an equivalent file such as `CLAUDE.md`, update that file instead unless the workflow input asks for a specific path.
+
+Read the existing guidance and the provided change source, then make only guidance updates that are justified by repository changes.
+
+## Rules
+
+- Preserve the file's existing tone, structure, and level of detail.
+- Add concise instructions for new commands, architecture boundaries, workflow names, test requirements, or project conventions.
+- Remove or update stale instructions when the change source clearly makes them incorrect.
+- Do not add generic AI-agent advice that is not specific to this repository.
+- Do not rewrite the whole file unless it is very small and clearly outdated.
+- Return a concise summary of changed guidance and skipped areas.

package/.pi/agents/task/changelog-updater.md

@@ -0,0 +1,29 @@
+---
+description: Updates CHANGELOG.md from a workflow change source
+color: "#7c3aed"
+hidden: false
+tools:
+  Read: true
+  Glob: true
+  Grep: true
+  Edit: true
+  Write: true
+---
+
+You update `CHANGELOG.md` for the provided workflow change source.
+
+Read `CHANGELOG.md`, edit it in place, then return a concise summary of what changed. Do not return the full changelog content.
+
+## Rules
+
+- Preserve the existing changelog title, introduction, ordering, and Markdown style.
+- Add or update a `## Unreleased` section directly above the latest released version when unreleased entries are needed.
+- Do not invent a released version or date.
+- Do not modify existing released sections unless correcting an obvious duplicate introduced by this update.
+- Group entries under conventional headings such as `Added`, `Changed`, `Fixed`, `Removed`, `Security`, or `Documentation`.
+- Prefer headings already used by the file when they fit.
+- Write concise bullets in imperative style.
+- Include only user-facing or maintainer-significant changes.
+- Skip purely mechanical formatting, generated files, lockfile noise, and test-only changes unless they affect users or contributors.
+- Avoid duplicate bullets if the changelog already mentions the same change.
+- If there are no changelog-worthy changes, leave the file unchanged and say why.

package/.pi/agents/task/review-issue-fixer.md

@@ -0,0 +1,25 @@
+---
+description: Fixes actionable issues from a saved DRS review result
+color: "#dc2626"
+hidden: false
+tools:
+  Read: true
+  Glob: true
+  Grep: true
+  Edit: true
+  Write: true
+---
+
+You fix actionable issues from a DRS review result.
+
+The workflow provides review JSON or Markdown plus the current local change source. Read the affected files, make the smallest safe code changes, then return a concise summary of fixes and any issues intentionally left unresolved.
+
+## Rules
+
+- Prioritize `critical`, `high`, and concrete `medium` issues.
+- Do not make speculative rewrites for vague, stylistic, or low-confidence findings.
+- Preserve existing architecture, formatting, naming, and public behavior unless the review issue requires a behavior change.
+- Keep changes minimal and localized to the issue.
+- Do not update dependencies, generated files, or lockfiles unless directly necessary.
+- If a finding cannot be reproduced or safely fixed, leave code unchanged for that finding and explain why.
+- Do not commit changes.

package/.pi/workflows/github-pr-describe-post.yaml

@@ -0,0 +1,24 @@
+name: github-pr-describe-post
+description: Generate and post a GitHub pull request description
+inputs:
+  owner: ""
+  repo: ""
+  pr: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: github-pr
+      owner: "{{inputs.owner}}"
+      repo: "{{inputs.repo}}"
+      pr: "{{inputs.pr}}"
+    output: change
+
+  describe:
+    action: describe
+    needs:
+      - change
+    with:
+      source: change
+      post: true
+    output: description

package/.pi/workflows/github-pr-describe.yaml

@@ -0,0 +1,23 @@
+name: github-pr-describe
+description: Generate a GitHub pull request description
+inputs:
+  owner: ""
+  repo: ""
+  pr: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: github-pr
+      owner: "{{inputs.owner}}"
+      repo: "{{inputs.repo}}"
+      pr: "{{inputs.pr}}"
+    output: change
+
+  describe:
+    action: describe
+    needs:
+      - change
+    with:
+      source: change
+    output: description

package/.pi/workflows/github-pr-post-comment.yaml

@@ -0,0 +1,19 @@
+name: github-pr-post-comment
+description: Post or update a GitHub pull request comment
+inputs:
+  owner: ""
+  repo: ""
+  pr: ""
+  body: ""
+  marker: ""
+nodes:
+  comment:
+    action: post-comment
+    input: "{{inputs.body}}"
+    with:
+      platform: github
+      owner: "{{inputs.owner}}"
+      repo: "{{inputs.repo}}"
+      pr: "{{inputs.pr}}"
+      marker: "{{inputs.marker}}"
+    output: comment

package/.pi/workflows/github-pr-review-post.yaml

@@ -0,0 +1,32 @@
+name: github-pr-review-post
+description: Review a GitHub pull request and post DRS comments
+inputs:
+  owner: ""
+  repo: ""
+  pr: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: github-pr
+      owner: "{{inputs.owner}}"
+      repo: "{{inputs.repo}}"
+      pr: "{{inputs.pr}}"
+    output: change
+
+  review:
+    action: review
+    needs:
+      - change
+    with:
+      source: change
+    output: review
+
+  post-comments:
+    action: post-review-comments
+    needs:
+      - review
+    with:
+      source: change
+      review: review
+    output: postedReview

package/.pi/workflows/github-pr-review.yaml

@@ -0,0 +1,23 @@
+name: github-pr-review
+description: Review a GitHub pull request
+inputs:
+  owner: ""
+  repo: ""
+  pr: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: github-pr
+      owner: "{{inputs.owner}}"
+      repo: "{{inputs.repo}}"
+      pr: "{{inputs.pr}}"
+    output: change
+
+  review:
+    action: review
+    needs:
+      - change
+    with:
+      source: change
+    output: review

package/.pi/workflows/github-pr-show-changes.yaml

@@ -0,0 +1,25 @@
+name: github-pr-show-changes
+description: Show the review context for a GitHub pull request
+inputs:
+  owner: ""
+  repo: ""
+  pr: ""
+  file: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: github-pr
+      owner: "{{inputs.owner}}"
+      repo: "{{inputs.repo}}"
+      pr: "{{inputs.pr}}"
+    output: change
+
+  context:
+    action: review-context
+    needs:
+      - change
+    with:
+      source: change
+      file: "{{inputs.file}}"
+    output: reviewContext

package/.pi/workflows/gitlab-mr-describe-post.yaml

@@ -0,0 +1,22 @@
+name: gitlab-mr-describe-post
+description: Generate and post a GitLab merge request description
+inputs:
+  project: ""
+  mr: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: gitlab-mr
+      project: "{{inputs.project}}"
+      mr: "{{inputs.mr}}"
+    output: change
+
+  describe:
+    action: describe
+    needs:
+      - change
+    with:
+      source: change
+      post: true
+    output: description

package/.pi/workflows/gitlab-mr-describe.yaml

@@ -0,0 +1,21 @@
+name: gitlab-mr-describe
+description: Generate a GitLab merge request description
+inputs:
+  project: ""
+  mr: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: gitlab-mr
+      project: "{{inputs.project}}"
+      mr: "{{inputs.mr}}"
+    output: change
+
+  describe:
+    action: describe
+    needs:
+      - change
+    with:
+      source: change
+    output: description

package/.pi/workflows/gitlab-mr-post-comment.yaml

@@ -0,0 +1,17 @@
+name: gitlab-mr-post-comment
+description: Post or update a GitLab merge request comment
+inputs:
+  project: ""
+  mr: ""
+  body: ""
+  marker: ""
+nodes:
+  comment:
+    action: post-comment
+    input: "{{inputs.body}}"
+    with:
+      platform: gitlab
+      project: "{{inputs.project}}"
+      mr: "{{inputs.mr}}"
+      marker: "{{inputs.marker}}"
+    output: comment

package/.pi/workflows/gitlab-mr-review-code-quality.yaml

@@ -0,0 +1,31 @@
+name: gitlab-mr-review-code-quality
+description: Review a GitLab merge request and write a GitLab Code Quality report
+inputs:
+  project: ""
+  mr: ""
+  codeQualityReport: gl-code-quality-report.json
+nodes:
+  change:
+    action: change-source
+    with:
+      type: gitlab-mr
+      project: "{{inputs.project}}"
+      mr: "{{inputs.mr}}"
+    output: change
+
+  review:
+    action: review
+    needs:
+      - change
+    with:
+      source: change
+    output: review
+
+  code-quality:
+    action: code-quality-report
+    needs:
+      - review
+    with:
+      review: review
+      path: "{{inputs.codeQualityReport}}"
+    output: codeQualityReport

package/.pi/workflows/gitlab-mr-review-post-code-quality.yaml

@@ -0,0 +1,40 @@
+name: gitlab-mr-review-post-code-quality
+description: Review a GitLab merge request, post DRS comments, and write a GitLab Code Quality report
+inputs:
+  project: ""
+  mr: ""
+  codeQualityReport: gl-code-quality-report.json
+nodes:
+  change:
+    action: change-source
+    with:
+      type: gitlab-mr
+      project: "{{inputs.project}}"
+      mr: "{{inputs.mr}}"
+    output: change
+
+  review:
+    action: review
+    needs:
+      - change
+    with:
+      source: change
+    output: review
+
+  post-comments:
+    action: post-review-comments
+    needs:
+      - review
+    with:
+      source: change
+      review: review
+    output: postedReview
+
+  code-quality:
+    action: code-quality-report
+    needs:
+      - review
+    with:
+      review: review
+      path: "{{inputs.codeQualityReport}}"
+    output: codeQualityReport

package/.pi/workflows/gitlab-mr-review-post.yaml

@@ -0,0 +1,30 @@
+name: gitlab-mr-review-post
+description: Review a GitLab merge request and post DRS comments
+inputs:
+  project: ""
+  mr: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: gitlab-mr
+      project: "{{inputs.project}}"
+      mr: "{{inputs.mr}}"
+    output: change
+
+  review:
+    action: review
+    needs:
+      - change
+    with:
+      source: change
+    output: review
+
+  post-comments:
+    action: post-review-comments
+    needs:
+      - review
+    with:
+      source: change
+      review: review
+    output: postedReview

package/.pi/workflows/gitlab-mr-review.yaml

@@ -0,0 +1,21 @@
+name: gitlab-mr-review
+description: Review a GitLab merge request
+inputs:
+  project: ""
+  mr: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: gitlab-mr
+      project: "{{inputs.project}}"
+      mr: "{{inputs.mr}}"
+    output: change
+
+  review:
+    action: review
+    needs:
+      - change
+    with:
+      source: change
+    output: review

package/.pi/workflows/gitlab-mr-show-changes.yaml

@@ -0,0 +1,23 @@
+name: gitlab-mr-show-changes
+description: Show the review context for a GitLab merge request
+inputs:
+  project: ""
+  mr: ""
+  file: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: gitlab-mr
+      project: "{{inputs.project}}"
+      mr: "{{inputs.mr}}"
+    output: change
+
+  context:
+    action: review-context
+    needs:
+      - change
+    with:
+      source: change
+      file: "{{inputs.file}}"
+    output: reviewContext

package/.pi/workflows/local-changelog-update.yaml

@@ -0,0 +1,23 @@
+name: local-changelog-update
+description: Update CHANGELOG.md from local unstaged changes
+nodes:
+  change:
+    action: change-source
+    with:
+      type: local
+      staged: false
+    output: change
+
+  update-changelog:
+    agent: task/changelog-updater
+    needs:
+      - change
+    input: |
+      Update CHANGELOG.md for these local changes.
+
+      Read CHANGELOG.md yourself and edit it in place.
+      Do not return the full changelog content.
+
+      Local change source:
+      {{artifacts.change}}
+    output: changelog

package/.pi/workflows/local-fix-review-issues.yaml

@@ -0,0 +1,42 @@
+name: local-fix-review-issues
+description: Fix actionable issues from a saved DRS review result
+inputs:
+  review: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: local
+      staged: false
+    output: change
+
+  fix-issues:
+    agent: task/review-issue-fixer
+    needs:
+      - change
+    input: |
+      Fix actionable issues from this DRS review result.
+
+      Review result:
+      {{inputs.review}}
+
+      Current local change source:
+      {{artifacts.change}}
+    output: fixes
+
+  final-change:
+    action: change-source
+    needs:
+      - fix-issues
+    with:
+      type: local
+      staged: false
+    output: finalChange
+
+  review:
+    action: review
+    needs:
+      - final-change
+    with:
+      source: finalChange
+    output: review

package/.pi/workflows/local-review.yaml

@@ -0,0 +1,17 @@
+name: local-review
+description: Review local unstaged git diff
+nodes:
+  change:
+    action: change-source
+    with:
+      type: local
+      staged: false
+    output: change
+
+  review:
+    action: review
+    needs:
+      - change
+    with:
+      source: change
+    output: review

package/.pi/workflows/local-staged-review.yaml

@@ -0,0 +1,17 @@
+name: local-staged-review
+description: Review local staged git diff
+nodes:
+  change:
+    action: change-source
+    with:
+      type: local
+      staged: true
+    output: change
+
+  review:
+    action: review
+    needs:
+      - change
+    with:
+      source: change
+    output: review

package/.pi/workflows/local-update-agents-md.yaml

@@ -0,0 +1,24 @@
+name: local-update-agents-md
+description: Update repository agent guidance from local changes
+inputs:
+  path: ""
+nodes:
+  change:
+    action: change-source
+    with:
+      type: local
+      staged: false
+    output: change
+
+  update-guidance:
+    agent: task/agents-md-updater
+    needs:
+      - change
+    input: |
+      Update repository coding-agent guidance for these local changes.
+
+      Preferred guidance path, if non-empty: {{inputs.path}}
+
+      Local change source:
+      {{artifacts.change}}
+    output: guidance

package/.pi/workflows/tag-changelog-update.yaml

@@ -0,0 +1,26 @@
+name: tag-changelog-update
+description: Update CHANGELOG.md from changes between two git refs or tags
+inputs:
+  from: ""
+  to: ""
+nodes:
+  release-change:
+    action: change-source
+    with:
+      type: git-range
+      from: "{{inputs.from}}"
+      to: "{{inputs.to}}"
+    output: change
+
+  update-changelog:
+    agent: task/changelog-updater
+    needs:
+      - release-change
+    input: |
+      Update CHANGELOG.md for the release changes between {{inputs.from}} and {{inputs.to}}.
+
+      Use this git range change source as the authoritative release diff:
+      {{artifacts.change}}
+
+      If {{inputs.to}} is a release candidate tag, prepare changelog content for the upcoming final release without inventing a final release date.
+    output: changelog