@claushaas/ergon-cli 0.1.2

package/dist/library/workflows/code.docs_update.yaml

@@ -0,0 +1,252 @@
+
+workflow:
+  id: code.docs_update
+  version: 1
+  description: "Update or generate project documentation: analyze code → plan docs → write/update docs → optional validation → review → manual gate → notify."
+  author: "ergon-flow"
+  tags: ["docs", "documentation", "maintenance", "pr"]
+
+inputs:
+  repo_path:
+    type: string
+    description: "Local filesystem path to the git repository."
+
+  base_branch:
+    type: string
+    description: "Branch to start from (e.g., main)."
+    default: "main"
+
+  new_branch:
+    type: string
+    description: "Branch to create for documentation updates (e.g., docs/update-architecture)."
+
+  objective:
+    type: string
+    description: "Goal of the documentation update (e.g., update architecture docs, add API documentation)."
+
+  constraints:
+    type: string
+    description: "Documentation constraints or style guidelines."
+    default: "Follow existing documentation style and structure. Prefer concise and accurate explanations."
+
+  focus_paths:
+    type: array
+    description: "Optional documentation paths to focus on (e.g., docs/, README.md)."
+    default: []
+
+  validation_command:
+    type: string
+    description: "Optional command to validate documentation (lint, build docs, etc.)."
+    default: ""
+
+  notify:
+    type: object
+    description: "Notification backend configuration."
+    default:
+      channel: "stdout"     # stdout|webhook|openclaw
+      target: ""
+      message_prefix: "[ergon-flow]"
+
+steps:
+
+  - id: repo.prepare
+    kind: exec
+    name: "Prepare repository"
+    description: "Checkout base branch and create documentation update branch."
+    command: |
+      set -euo pipefail
+      cd "{{ inputs.repo_path }}"
+      git fetch --all --prune
+      git checkout "{{ inputs.base_branch }}"
+      git pull --ff-only
+      git checkout -B "{{ inputs.new_branch }}"
+
+  - id: analyze
+    kind: agent
+    name: "Analyze documentation and codebase"
+    provider: openrouter
+    model: deepseek/deepseek-v3.2
+    output:
+      name: analysis
+      type: analysis
+    prompt: |
+      You are a documentation architect.
+
+      Objective:
+      {{ inputs.objective }}
+
+      Constraints:
+      {{ inputs.constraints }}
+
+      Focus paths:
+      {{ inputs.focus_paths }}
+
+      Analyze the repository documentation and determine:
+
+      - documentation gaps
+      - outdated sections
+      - missing explanations
+      - sections needing improvement
+
+      Produce structured JSON with keys:
+
+      - summary
+      - gaps
+      - outdated_sections
+      - proposed_updates
+
+  - id: plan
+    kind: agent
+    name: "Plan documentation changes"
+    provider: openrouter
+    model: moonshotai/kimi-k2.5
+    output:
+      name: plan
+      type: plan
+    prompt: |
+      Create a documentation update plan.
+
+      Objective:
+      {{ inputs.objective }}
+
+      Analysis:
+      {{ artifacts.analysis }}
+
+      Constraints:
+      {{ inputs.constraints }}
+
+      Produce structured JSON with:
+
+      - documentation_strategy
+      - files_to_create
+      - files_to_update
+      - sections_to_modify
+      - writing_guidelines
+
+  - id: generate
+    kind: agent
+    name: "Generate documentation updates"
+    provider: claude-code
+    output:
+      name: generate
+      type: text
+    prompt: |
+      You are a senior technical writer.
+
+      Objective:
+      {{ inputs.objective }}
+
+      Documentation plan:
+      {{ artifacts.plan }}
+
+      Constraints:
+      {{ inputs.constraints }}
+
+      Generate a unified diff patch that updates the documentation accordingly.
+
+      Requirements:
+
+      - Output ONLY a git-compatible unified diff
+      - Maintain documentation consistency
+      - Avoid unnecessary changes
+
+  - id: patch.apply
+    kind: exec
+    name: "Apply documentation patch"
+    command: |
+      set -euo pipefail
+      cd "{{ inputs.repo_path }}"
+      mkdir -p .ergon
+      cat > .ergon/docs.patch <<'PATCH'
+      {{ artifacts.generate }}
+      PATCH
+      git apply --index .ergon/docs.patch
+
+  - id: validate.should
+    kind: condition
+    name: "Should validate docs?"
+    expression: "{{ inputs.validation_command }}"
+
+  - id: docs.validate
+    kind: exec
+    name: "Validate documentation"
+    depends_on: [validate.should]
+    command: |
+      set -euo pipefail
+      cd "{{ inputs.repo_path }}"
+      {{ inputs.validation_command }}
+
+  - id: review
+    kind: agent
+    name: "Review documentation changes"
+    provider: openrouter
+    model: moonshotai/kimi-k2.5
+    output:
+      name: review
+      type: json
+    prompt: |
+      You are reviewing documentation updates.
+
+      Objective:
+      {{ inputs.objective }}
+
+      Documentation plan:
+      {{ artifacts.plan }}
+
+      Patch:
+      {{ artifacts.generate }}
+
+      Validation output:
+      {{ artifacts.docs.validate.stdout }}
+
+      Produce structured JSON with keys:
+
+      - summary
+      - quality_assessment
+      - improvements
+      - pr_title
+      - pr_body
+
+  - id: gate
+    kind: manual
+    name: "Manual review gate"
+    message: |
+      Documentation update ready.
+
+      Suggested PR title:
+      {{ artifacts.review.pr_title }}
+
+      Suggested PR body:
+      {{ artifacts.review.pr_body }}
+
+      Branch:
+      {{ inputs.new_branch }}
+
+      Base branch:
+      {{ inputs.base_branch }}
+
+      Review and merge if acceptable.
+
+  - id: notify
+    kind: notify
+    name: "Notify completion"
+    channel: "{{ inputs.notify.channel }}"
+    target: "{{ inputs.notify.target }}"
+    message: |
+      {{ inputs.notify.message_prefix }} Workflow completed: code.docs_update
+
+      Repo: {{ inputs.repo_path }}
+      Branch: {{ inputs.new_branch }}
+
+      Objective:
+      {{ inputs.objective }}
+
+      Summary:
+      {{ artifacts.review.summary }}
+
+outputs:
+  plan: artifacts.plan
+  patch: artifacts.generate
+  review: artifacts.review
+  branch: inputs.new_branch
+  base_branch: inputs.base_branch

package/dist/library/workflows/code.hotfix.yaml

@@ -0,0 +1,264 @@
+
+workflow:
+  id: code.hotfix
+  version: 1
+  description: "Apply a targeted hotfix: analyze failure → design minimal fix → generate patch → tests → review → manual gate → notify."
+  author: "ergon-flow"
+  tags: ["code", "hotfix", "bugfix", "pr"]
+
+inputs:
+  repo_path:
+    type: string
+    description: "Local filesystem path to the git repository."
+
+  base_branch:
+    type: string
+    description: "Branch to start from (e.g., main or release branch)."
+    default: "main"
+
+  new_branch:
+    type: string
+    description: "Branch to create for the hotfix (e.g., hotfix/null-pointer-crash)."
+
+  issue:
+    type: string
+    description: "Description of the bug, failure, or incident being fixed."
+
+  context:
+    type: string
+    description: "Additional context such as stack traces, logs, or reproduction steps."
+    default: ""
+
+  constraints:
+    type: string
+    description: "Constraints for the fix (e.g., minimal change, no API changes, backport safe)."
+    default: "Implement the smallest safe fix. Avoid refactors or unrelated changes."
+
+  focus_paths:
+    type: array
+    description: "Optional list of paths where the issue likely exists."
+    default: []
+
+  test_command:
+    type: string
+    description: "Command to run tests (empty means skip tests step)."
+    default: ""
+
+  notify:
+    type: object
+    description: "Notification backend configuration."
+    default:
+      channel: "stdout"     # stdout|webhook|openclaw
+      target: ""
+      message_prefix: "[ergon-flow]"
+
+steps:
+
+  - id: repo.prepare
+    kind: exec
+    name: "Prepare repository"
+    description: "Checkout base branch and create hotfix branch."
+    command: |
+      set -euo pipefail
+      cd "{{ inputs.repo_path }}"
+      git fetch --all --prune
+      git checkout "{{ inputs.base_branch }}"
+      git pull --ff-only
+      git checkout -B "{{ inputs.new_branch }}"
+
+  - id: analyze
+    kind: agent
+    name: "Analyze bug and code"
+    provider: openrouter
+    model: deepseek/deepseek-v3.2
+    output:
+      name: analysis
+      type: analysis
+    prompt: |
+      You are investigating a production bug.
+
+      Issue description:
+      {{ inputs.issue }}
+
+      Context (logs, stack traces, reproduction):
+      {{ inputs.context }}
+
+      Constraints:
+      {{ inputs.constraints }}
+
+      Focus paths:
+      {{ inputs.focus_paths }}
+
+      Determine:
+
+      - likely root cause
+      - affected components
+      - minimal safe fix strategy
+      - files likely involved
+
+      Produce structured JSON with keys:
+
+      - root_cause
+      - affected_components
+      - fix_strategy
+      - files
+      - risks
+
+  - id: design
+    kind: agent
+    name: "Design minimal fix"
+    provider: openrouter
+    model: moonshotai/kimi-k2.5
+    output:
+      name: design
+      type: plan
+    prompt: |
+      You are designing a minimal hotfix.
+
+      Issue:
+      {{ inputs.issue }}
+
+      Analysis:
+      {{ artifacts.analysis }}
+
+      Constraints:
+      {{ inputs.constraints }}
+
+      Produce structured JSON with:
+
+      - fix_summary
+      - changes
+      - files_to_modify
+      - verification_steps
+
+      Ensure the fix is minimal and safe for production.
+
+  - id: patch
+    kind: agent
+    name: "Generate hotfix patch"
+    provider: codex
+    output:
+      name: patch
+      type: text
+    prompt: |
+      You are a coding agent generating a minimal bugfix.
+
+      Issue:
+      {{ inputs.issue }}
+
+      Fix design:
+      {{ artifacts.design }}
+
+      Constraints:
+      {{ inputs.constraints }}
+
+      Generate a unified diff patch compatible with `git apply`.
+
+      Rules:
+
+      - Output ONLY the patch
+      - Keep the change minimal
+      - Avoid unrelated refactors
+
+  - id: patch.apply
+    kind: exec
+    name: "Apply patch"
+    command: |
+      set -euo pipefail
+      cd "{{ inputs.repo_path }}"
+      mkdir -p .ergon
+      cat > .ergon/hotfix.patch <<'PATCH'
+      {{ artifacts.patch }}
+      PATCH
+      git apply --index .ergon/hotfix.patch
+
+  - id: tests.should
+    kind: condition
+    name: "Should run tests?"
+    expression: "{{ inputs.test_command }}"
+
+  - id: tests.exec
+    kind: exec
+    name: "Run tests"
+    depends_on: [tests.should]
+    command: |
+      set -euo pipefail
+      cd "{{ inputs.repo_path }}"
+      {{ inputs.test_command }}
+
+  - id: review
+    kind: agent
+    name: "Review hotfix"
+    provider: claude-code
+    output:
+      name: review
+      type: json
+    prompt: |
+      You are reviewing a production hotfix.
+
+      Issue:
+      {{ inputs.issue }}
+
+      Analysis:
+      {{ artifacts.analysis }}
+
+      Fix design:
+      {{ artifacts.design }}
+
+      Patch:
+      {{ artifacts.patch }}
+
+      Test results:
+      {{ artifacts.tests.exec.stdout }}
+
+      Produce structured JSON with:
+
+      - summary
+      - risk_assessment
+      - follow_up_actions
+      - pr_title
+      - pr_body
+
+  - id: gate
+    kind: manual
+    name: "Manual review gate"
+    message: |
+      Hotfix branch ready for review.
+
+      Suggested PR title:
+      {{ artifacts.review.pr_title }}
+
+      Suggested PR body:
+      {{ artifacts.review.pr_body }}
+
+      Branch:
+      {{ inputs.new_branch }}
+
+      Base branch:
+      {{ inputs.base_branch }}
+
+      Review carefully before merging.
+
+  - id: notify
+    kind: notify
+    name: "Notify completion"
+    channel: "{{ inputs.notify.channel }}"
+    target: "{{ inputs.notify.target }}"
+    message: |
+      {{ inputs.notify.message_prefix }} Workflow completed: code.hotfix
+
+      Repo: {{ inputs.repo_path }}
+      Branch: {{ inputs.new_branch }}
+
+      Issue:
+      {{ inputs.issue }}
+
+      Summary:
+      {{ artifacts.review.summary }}
+
+outputs:
+  design: artifacts.design
+  patch: artifacts.patch
+  review: artifacts.review
+  branch: inputs.new_branch
+  base_branch: inputs.base_branch