Skip to content

README.md

Latest commit

 

History

History
50 lines (34 loc) · 2.05 KB

README.md

File metadata and controls

50 lines (34 loc) · 2.05 KB
Raw

Tools

Maintainer and contributor tooling for the Open Workflow Library.

All tools in this directory are read-only by default. Anything that proposes changes to workflow files writes a proposal under reports/ or catalog/ and stops — it does not mutate workflows.

Current tools

audit_workflows.py

Scans the repository for workflow files, classifies them, and produces an audit report.

python tools/audit_workflows.py

Outputs:

  • reports/workflow-audit.json — structured data
  • reports/workflow-audit.md — human-readable summary
  • catalog/workflows.index.json — indexed catalog conforming to ../schemas/workflow-metadata.schema.json

What it does:

  • Walks the repository recursively
  • Identifies JSON files and tries to parse them
  • Heuristically classifies likely n8n workflow files
  • Detects duplicate files by content hash
  • Detects references to credentials and possible secret-like values (matches are redacted in the output)
  • Detects code/function nodes and webhook nodes
  • Counts and ranks integration / node types

What it explicitly does not do:

  • Modify, move, or delete workflow files
  • Execute workflow contents
  • Make network requests
  • Print real secret values

Planned tools (not implemented)

The following tools are part of the roadmap and are not present yet:

  • validate_workflows.py — schema-level and framework-level validation against the Universal Workflow IR.
  • propose_repairs.py — generate repair-proposal documents for invalid or stale workflows; human-reviewed.
  • import_<framework>.py — importers that translate framework-native workflow files into the Universal Workflow IR.
  • export_<framework>.py — exporters that translate IR back out to a target framework.
  • generate_from_prompt.py — prompt-to-workflow pipeline (catalog/wiki retrieval → IR → export).

See ../docs/architecture.md and ../docs/prompt-to-workflow.md for the design these tools are meant to fit into.