@diff-review-system/drs 3.3.1 → 4.0.1

package/.pi/workflows/local-visual-explain.yaml

@@ -0,0 +1,31 @@
+name: local-visual-explain
+description: Generate a visual HTML explainer artifact for a local git diff
+inputs:
+  staged: 'false'
+  outputPath: '.drs/visual-local-explainer.html'
+  slides: 'false'
+output: visualExplainer
+nodes:
+  change:
+    action: change-source
+    with:
+      type: local
+      staged: '{{inputs.staged}}'
+    output: change
+
+  visual:
+    agent: visual/pr-explainer
+    needs:
+      - change
+    input: |
+      Generate a visual local-diff explainer HTML artifact.
+
+      Output path: {{inputs.outputPath}}
+      Slide mode: {{inputs.slides}}
+
+      Use the supplied DRS change-source context. If important file diffs are omitted or summarized, use git_diff for those files before explaining them.
+
+      DRS change-source context:
+      {{artifacts.change}}
+    writes: '{{inputs.outputPath}}'
+    output: visualExplainer

package/.pi/workflows/release-changelog-finalize.yaml

@@ -0,0 +1,47 @@
+name: release-changelog-finalize
+description: Finalize CHANGELOG.md for a release from an explicit git range
+inputs:
+  from:
+    type: string
+    description: Base ref or previous release tag
+    required: true
+  to:
+    type: string
+    default: HEAD
+    description: Release candidate ref, final release commit, or HEAD
+  version:
+    type: string
+    description: Release version without leading v, for example 4.0.0
+    required: true
+  date:
+    type: string
+    description: Release date in YYYY-MM-DD format
+    required: true
+output: changelog
+nodes:
+  release-change:
+    action: change-source
+    with:
+      type: git-range
+      from: '{{inputs.from}}'
+      to: '{{inputs.to}}'
+    output: change
+
+  finalize-changelog:
+    agent: task/changelog-updater
+    needs:
+      - release-change
+    input: |
+      Finalize CHANGELOG.md for release {{inputs.version}} dated {{inputs.date}}.
+
+      Use this git range change source as the authoritative release diff:
+      {{artifacts.change}}
+
+      Requirements:
+      - Ensure the file starts with `# Changelog` followed by the standard introduction.
+      - Move release-worthy `## Unreleased` entries into `## {{inputs.version}} - {{inputs.date}}`.
+      - Create `## {{inputs.version}} - {{inputs.date}}` directly above the previous released version if it does not exist.
+      - Keep `## Unreleased` above the release section only if there are remaining unreleased entries; otherwise remove empty duplicate/unneeded headings.
+      - Preserve existing older release sections.
+      - Do not create git tags, publish packages, or edit files other than CHANGELOG.md.
+    output: changelog

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