@diff-review-system/drs 4.0.1 → 5.0.0-rc.1

package/.pi/workflows/gitlab-mr-visual-explain.yaml

@@ -15,10 +15,31 @@ nodes:
       mr: '{{inputs.mr}}'
     output: change
 
-  visual:
+  review-artifact:
+    action: artifact-exists
+    needs:
+      - change
+    with:
+      kind: review
+      source: change
+    output: reviewArtifactStatus
+
+  load-review-artifact:
+    action: load-artifact
+    needs:
+      - review-artifact
+    if: artifacts.reviewArtifactStatus.exists == true
+    with:
+      kind: review
+      source: change
+    output: reviewArtifact
+
+  visual-with-review:
     agent: visual/pr-explainer
     needs:
       - change
+      - load-review-artifact
+    if: artifacts.reviewArtifactStatus.exists == true
     input: |
       Generate a visual MR explainer HTML artifact.
 
@@ -29,5 +50,29 @@ nodes:
 
       DRS change-source context:
       {{artifacts.change}}
+
+      Current DRS review artifact path: {{artifacts.reviewArtifact.path}}
+
+      Use the read_artifact tool with this path to include confirmed DRS findings in a clearly labeled section. Do not assume the review JSON is in this prompt.
+    writes: '{{inputs.outputPath}}'
+    output: visualExplainer
+
+  visual:
+    agent: visual/pr-explainer
+    needs:
+      - review-artifact
+    if: artifacts.reviewArtifactStatus.exists == false
+    input: |
+      Generate a visual MR 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}}
+
+      No current DRS review artifact exists for this MR. Label the artifact as an MR explainer with no DRS findings included.
     writes: '{{inputs.outputPath}}'
     output: visualExplainer

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

@@ -1,5 +1,12 @@
 name: local-fix-review-issues
 description: Fix actionable issues from a saved local DRS review artifact with verification loop
+metadata:
+  kind: review
+  tags: [review, fix, local]
+  review:
+    source: local
+    diff: true
+    issues: true
 inputs:
   review:
     type: string
@@ -14,7 +21,7 @@ inputs:
   fixMaxIterations:
     type: number
     default: 3
-output: persistedReviewArtifact
+output: reviewArtifact
 nodes:
   change:
     action: change-source
@@ -31,7 +38,7 @@ nodes:
       kind: review
       source: change
       id: '{{inputs.review}}'
-    output: persistedReviewArtifact
+    output: reviewArtifact
 
   fix-issues:
     agent: task/review-issue-fixer
@@ -42,7 +49,7 @@ nodes:
 
       Only fix findings at or above severity {{inputs.fixSeverity}} unless a lower-severity issue is directly required by such a fix.
 
-      Review artifact path: {{artifacts.persistedReviewArtifact.path}}
+      Review artifact path: {{artifacts.reviewArtifact.path}}
 
       Use the read_artifact tool with this path to get the finding manifest, then pull full details for specific findings by id. Do not assume the review JSON is in this prompt — call the tool.
 
@@ -77,7 +84,7 @@ nodes:
       - verification-change
     with:
       source: verificationChange
-      reviewArtifact: persistedReviewArtifact
+      reviewArtifact: reviewArtifact
       severity: '{{inputs.fixSeverity}}'
     output: reReview
 
@@ -88,12 +95,12 @@ nodes:
       - load-review-artifact
       - final-change
     with:
-      artifact: persistedReviewArtifact
+      artifact: reviewArtifact
       review: reReview
       fixChange: finalChange
       severity: '{{inputs.fixSeverity}}'
       minIssues: '1'
-    output: persistedReviewArtifact
+    output: reviewArtifact
 
   fix-loop:
     control: loop

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

@@ -1,5 +1,12 @@
 name: local-review
 description: Review local git diff
+metadata:
+  kind: review
+  tags: [review, local]
+  review:
+    source: local
+    diff: true
+    issues: true
 inputs:
   staged:
     type: boolean
@@ -20,5 +27,4 @@ nodes:
       - change
     with:
       source: change
-      artifact: persistedReviewArtifact
     output: review

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

@@ -13,10 +13,31 @@ nodes:
       staged: '{{inputs.staged}}'
     output: change
 
-  visual:
+  review-artifact:
+    action: artifact-exists
+    needs:
+      - change
+    with:
+      kind: review
+      source: change
+    output: reviewArtifactStatus
+
+  load-review-artifact:
+    action: load-artifact
+    needs:
+      - review-artifact
+    if: artifacts.reviewArtifactStatus.exists == true
+    with:
+      kind: review
+      source: change
+    output: reviewArtifact
+
+  visual-with-review:
     agent: visual/pr-explainer
     needs:
       - change
+      - load-review-artifact
+    if: artifacts.reviewArtifactStatus.exists == true
     input: |
       Generate a visual local-diff explainer HTML artifact.
 
@@ -27,5 +48,29 @@ nodes:
 
       DRS change-source context:
       {{artifacts.change}}
+
+      Current DRS review artifact path: {{artifacts.reviewArtifact.path}}
+
+      Use the read_artifact tool with this path to include confirmed DRS findings in a clearly labeled section. Do not assume the review JSON is in this prompt.
+    writes: '{{inputs.outputPath}}'
+    output: visualExplainer
+
+  visual:
+    agent: visual/pr-explainer
+    needs:
+      - review-artifact
+    if: artifacts.reviewArtifactStatus.exists == false
+    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}}
+
+      No current DRS review artifact exists for this diff. Label the artifact as a diff explainer with no DRS findings included.
     writes: '{{inputs.outputPath}}'
     output: visualExplainer

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

@@ -31,6 +31,15 @@ nodes:
     agent: task/changelog-updater
     needs:
       - release-change
+    permissions:
+      filesystem:
+        read:
+          roots: ['.']
+          allow: [CHANGELOG.md]
+        write:
+          roots: ['.']
+          allow: [CHANGELOG.md]
+      shell: false
     input: |
       Finalize CHANGELOG.md for release {{inputs.version}} dated {{inputs.date}}.
 
@@ -41,6 +50,7 @@ nodes:
       - 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.
+      - Consolidate any earlier prerelease sections for the same major.minor.patch version into this release section. A final release must not retain separate RC, beta, or alpha sections for that version.
       - 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.

package/.pi/workflows/repository-wiki-check.yaml

@@ -0,0 +1,40 @@
+name: repository-wiki-check
+description: Verify repository wiki delta state and OKF v0.1 conformance without a model call
+metadata:
+  kind: validation
+  tags:
+    - documentation
+    - wiki
+    - okf
+    - ci
+inputs:
+  root:
+    type: string
+    default: wiki
+    description: Repository-relative OKF bundle root
+  instructionsPath:
+    type: string
+    default: .drs/wiki-instructions.md
+    description: Repository-relative persistent wiki brief path outside the OKF bundle
+  statePath:
+    type: string
+    default: .drs/wiki-state.json
+    description: Repository-relative delta state path outside the OKF bundle
+output: wikiValidation
+nodes:
+  check-state:
+    action: check-wiki-state
+    with:
+      root: '{{inputs.root}}'
+      statePath: '{{inputs.statePath}}'
+      instructionsPath: '{{inputs.instructionsPath}}'
+    output: wikiDelta
+
+  validate-wiki:
+    action: validate-okf-wiki
+    needs:
+      - check-state
+    with:
+      root: '{{inputs.root}}'
+      version: '0.1'
+    output: wikiValidation

package/.pi/workflows/repository-wiki-sync.yaml

@@ -0,0 +1,187 @@
+name: repository-wiki-sync
+description: Generate or update one OKF v0.1 repository wiki bundle
+metadata:
+  kind: maintenance
+  tags:
+    - documentation
+    - wiki
+    - okf
+inputs:
+  root:
+    type: string
+    default: wiki
+    description: Repository-relative OKF bundle root
+  instructions:
+    type: string
+    default: ''
+    description: One-run addition to the persistent repository wiki brief
+  instructionsPath:
+    type: string
+    default: .drs/wiki-instructions.md
+    description: Repository-relative persistent wiki brief path outside the OKF bundle
+  statePath:
+    type: string
+    default: .drs/wiki-state.json
+    description: Repository-relative delta state path outside the OKF bundle
+  check:
+    type: boolean
+    default: false
+    description: Fail when the workflow produces uncommitted wiki or state changes
+output: wikiResult
+nodes:
+  plan-update:
+    action: plan-wiki-update
+    with:
+      root: '{{inputs.root}}'
+      statePath: '{{inputs.statePath}}'
+      instructionsPath: '{{inputs.instructionsPath}}'
+      instructions: '{{inputs.instructions}}'
+    output: wikiDelta
+
+  maintain-wiki:
+    agent: task/okf-wiki-maintainer
+    needs:
+      - plan-update
+    if: artifacts.wikiDelta.shouldRun == true
+    permissions:
+      filesystem:
+        read:
+          roots:
+            - '.'
+          allow:
+            - '**'
+        write:
+          roots:
+            - '{{inputs.root}}'
+          allow:
+            - '**/*.md'
+          deny:
+            - '**/index.md'
+        delete:
+          roots:
+            - '{{inputs.root}}'
+          allow:
+            - '**/*.md'
+          deny:
+            - '**/index.md'
+      shell: false
+    validation:
+      afterMutation:
+        - name: okf-document
+          root: '{{inputs.root}}'
+    input: |
+      Generate, reconcile, or update the repository wiki as one OKF v0.1 bundle.
+
+      Bundle root: {{inputs.root}}
+
+      Deterministic delta plan:
+      {{artifacts.wikiDelta}}
+
+      Repository wiki brief (persistent brief plus any one-run addition):
+      {{artifacts.wikiDelta.instructions}}
+
+      For generate mode, inspect the full repository and create the initial bundle. For update mode, prioritize candidateConcepts (concepts whose cited drs_sources changed) and use changedPaths as the primary scope, editing only directly affected concepts. For reconcile mode, preserve accurate existing content while repairing state or bundle drift and re-apply the repository wiki brief. Declare and maintain drs_sources citations in every concept you create or edit.
+
+      Edit concept files in place and return a concise summary. Do not edit index.md files; DRS synchronizes them in the next step. Do not commit or push.
+    output: wikiSummary
+
+  sync-indexes:
+    action: sync-okf-indexes
+    needs:
+      - maintain-wiki
+    with:
+      root: '{{inputs.root}}'
+      version: '0.1'
+    output: wikiIndexes
+
+  validate-updated-wiki:
+    action: validate-okf-wiki
+    needs:
+      - sync-indexes
+    with:
+      root: '{{inputs.root}}'
+      version: '0.1'
+    output: wikiValidation
+
+  record-state:
+    action: record-wiki-state
+    needs:
+      - validate-updated-wiki
+    with:
+      root: '{{inputs.root}}'
+      statePath: '{{inputs.statePath}}'
+      instructionsPath: '{{inputs.instructionsPath}}'
+      instructions: '{{inputs.instructions}}'
+    output: wikiState
+
+  check-updated-wiki:
+    action: check-wiki-clean
+    needs:
+      - record-state
+    if: inputs.check == true
+    with:
+      root: '{{inputs.root}}'
+      statePath: '{{inputs.statePath}}'
+
+  summarize-updated-wiki:
+    action: summarize-wiki-run
+    needs:
+      - record-state
+    if: inputs.check == false
+    with:
+      plan: wikiDelta
+      validation: wikiValidation
+      agentNode: maintain-wiki
+    output: wikiResult
+
+  summarize-checked-updated-wiki:
+    action: summarize-wiki-run
+    needs:
+      - check-updated-wiki
+    if: inputs.check == true
+    with:
+      plan: wikiDelta
+      validation: wikiValidation
+      agentNode: maintain-wiki
+    output: wikiResult
+
+  validate-current-wiki:
+    action: validate-okf-wiki
+    needs:
+      - plan-update
+    if: artifacts.wikiDelta.shouldRun == false
+    with:
+      root: '{{inputs.root}}'
+      version: '0.1'
+    output: wikiValidation
+
+  check-current-wiki:
+    action: check-wiki-clean
+    needs:
+      - validate-current-wiki
+    if: inputs.check == true
+    with:
+      root: '{{inputs.root}}'
+      statePath: '{{inputs.statePath}}'
+
+  summarize-current-wiki:
+    action: summarize-wiki-run
+    needs:
+      - validate-current-wiki
+    if: inputs.check == false
+    with:
+      plan: wikiDelta
+      validation: wikiValidation
+      agentNode: maintain-wiki
+    output: wikiResult
+
+  summarize-checked-current-wiki:
+    action: summarize-wiki-run
+    needs:
+      - check-current-wiki
+    if: inputs.check == true
+    with:
+      plan: wikiDelta
+      validation: wikiValidation
+      agentNode: maintain-wiki
+    output: wikiResult

package/.pi/workflows/temporal-control-smoke.yaml

@@ -0,0 +1,63 @@
+name: temporal-control-smoke
+description: Smoke test Temporal control-flow execution with safe local write actions
+inputs:
+  mode:
+    type: enum
+    values:
+      - loop
+      - pass
+      - end
+    default: loop
+    description: 'Control route to exercise: loop, passThrough, or end'
+output: final
+nodes:
+  start:
+    action: write
+    input: '{{inputs.mode}}'
+    writes: .drs/artifacts/temporal-smoke/start.txt
+    output: mode
+
+  route:
+    control: switch
+    needs:
+      - start
+    value: '{{artifacts.mode}}'
+    cases:
+      loop: loop-body
+      end: stop
+    default: pass
+
+  loop-body:
+    action: write
+    needs:
+      - route
+    input: 'loop body for {{artifacts.mode}}'
+    writes: .drs/artifacts/temporal-smoke/loop-body.txt
+    output: loopBody
+
+  again:
+    control: loop
+    needs:
+      - loop-body
+    if: 'true'
+    target: loop-body
+    exit: done
+    maxIterations: 2
+    onMaxIterations: exit
+
+  pass:
+    control: passThrough
+    needs:
+      - route
+    target: done
+
+  stop:
+    control: end
+    needs:
+      - route
+
+  done:
+    action: write
+    input: 'temporal control smoke complete via {{inputs.mode}}'
+    writes: .drs/artifacts/temporal-smoke/done.txt
+    output: final