Audit and Document Workflow Versions Across Repositories

Problem Description

TechStart manages 15 different skill repositories across their organization, each with varying levels of Tessl workflow automation. Some repos have v3 workflows, some have v4, and some have no automation at all. The DevOps director needs a comprehensive audit to understand which repositories need upgrades.

You've been tasked with creating a detection and analysis system that can:

1. Identify whether a Tessl workflow exists
2. Determine the version (v3 or v4)
3. Detect the architecture type (single vs two-workflow)
4. Recommend appropriate upgrade paths

For this project, you'll build detection scripts for three representative repositories with different scenarios:

• Repo A: Has v3 workflow with jq parsing
• Repo B: Has v4 workflow with caching
• Repo C: Has no Tessl workflow

The system should provide clear detection logic that can be applied across all repositories.

Output Specification

Create a comprehensive detection system with:

1. Version detector (detect_version.sh): Script that reads workflow file and identifies v3 (--json + jq) or v4 (CACHE_ENTRIES_FILE + PREV_SCORE)
2. Architecture detector (detect_architecture.sh): Script that determines single vs two-workflow by checking for workflow_run
3. Upgrade advisor (upgrade_recommendations.md): Document explaining upgrade paths for each version
4. Test suite (test_detection.sh): Script that tests detection logic against the three sample repos
5. Detection report (DETECTION_REPORT.md): Results from running detectors on all three sample repos

Input Files

The following files represent three sample repositories. Extract them before beginning.

=============== FILE: repo-a/.github/workflows/tessl-skill-review.yml =============== name: Skill Review v3 on: pull_request: paths: ['/SKILL.md'] jobs: review: runs-on: ubuntu-latest steps: - run: | tessl skill review . --json > out.json jq '.results[] | .score' out.json =============== FILE: repo-b/.github/workflows/tessl-skill-review.yml =============== name: Skill Review v4 on: pull_request: paths: ['/SKILL.md'] jobs: review: runs-on: ubuntu-latest steps: - run: | CACHE_ENTRIES_FILE=".github/.tessl/cache.json" PREV_SCORE=$(jq -r '.skills["example"].score' $CACHE_ENTRIES_FILE) echo "Previous score: $PREV_SCORE" =============== FILE: repo-b/.github/workflows/tessl-skill-review-comment.yml =============== name: Post Comments on: workflow_run: workflows: ["Skill Review v4"] types: [completed] jobs: comment: runs-on: ubuntu-latest steps: - run: echo "Commenting" =============== FILE: repo-c/README.md ===============

Repo C

No Tessl automation yet.