shared-actions/register-skill/action.yaml

name: 'Register Skill'
description: 'Standardized registration of a skill version to the business system'

inputs:
  client_key:
    description: 'Authentication key for the business system'
    required: true
  api_base:
    description: 'API gateway base URL'
    default: 'https://api-gw-test.yuanwei-lnc.com'
  skill_slug:
    description: 'Override skill slug (defaults to package.json name or repo name)'
    required: false
  release_note:
    description: 'Optional release note for this version'
    required: false
    default: ''

runs:
  using: "composite"
  steps:
    - name: Install runtime dependencies
      shell: bash
      run: |
        set -e
        MISSING=""
        command -v jq     >/dev/null 2>&1 || MISSING="$MISSING jq"
        command -v curl   >/dev/null 2>&1 || MISSING="$MISSING curl"
        command -v python3 >/dev/null 2>&1 || MISSING="$MISSING python3"
        if [ -n "$MISSING" ]; then
          apt-get update -qq
          apt-get install -y -qq $MISSING ca-certificates
        else
          echo "All dependencies already available, skipping install"
        fi

    - name: Load skill doc
      shell: bash
      env:
        SKILL_SUBPATH: ${{ env.SKILL_SUBPATH }}
        SKILL_DOC_PATH: ${{ env.SKILL_DOC_PATH }}
      run: |
        set -euo pipefail
        DOC_PATH="${SKILL_DOC_PATH:-SKILL.md}"
        BASE="${SKILL_SUBPATH:+$SKILL_SUBPATH/}"
        ABS="${BASE}${DOC_PATH}"

        if [ ! -f "$ABS" ]; then
          FALLBACK="${BASE}README.md"
          if [ -f "$FALLBACK" ]; then
            ABS="$FALLBACK"
            DOC_PATH="README.md"
          else
            echo "ERROR: skill doc not found at $ABS"
            exit 1
          fi
        fi

        echo "Using doc: $ABS"
        jq -Rs . < "$ABS" > /tmp/skill_doc.json
        echo "RESOLVED_DOC_PATH=$DOC_PATH" >> "$GITHUB_ENV"

    - name: Register version
      shell: bash
      env:
        INPUT_CLIENT_KEY: ${{ inputs.client_key }}
        INPUT_API_BASE: ${{ inputs.api_base }}
        INPUT_SKILL_SLUG: ${{ inputs.skill_slug }}
        INPUT_RELEASE_NOTE: ${{ inputs.release_note }}
        SKILL_SUBPATH: ${{ env.SKILL_SUBPATH }}
      run: |
        set -euo pipefail

        # Resolve slug: input → package.json → pyproject.toml → repo name
        SLUG="${INPUT_SKILL_SLUG:-}"
        BASE_DIR="${SKILL_SUBPATH:-.}"

        if [ -z "$SLUG" ] && [ -f "${BASE_DIR}/package.json" ]; then
          SLUG=$(jq -r '.name // empty' "${BASE_DIR}/package.json" | sed 's|.*/||')
        fi

        if [ -z "$SLUG" ] && [ -f "${BASE_DIR}/pyproject.toml" ]; then
          SLUG=$(python3 -c "
        import sys, tomllib
        d = tomllib.load(open(sys.argv[1],'rb'))
        print((d.get('project',{}).get('name') or d.get('tool',{}).get('poetry',{}).get('name') or ''))
        " "${BASE_DIR}/pyproject.toml" 2>/dev/null || true)
          SLUG="${SLUG##*/}"
        fi

        if [ -z "$SLUG" ]; then
          SLUG="${GITHUB_REPOSITORY##*/}"
        fi

        echo "Registering slug=$SLUG version=${GITHUB_REF_NAME}"

        # Exchange client key for access token
        SESSION_RES=$(curl -fsS -X POST "${INPUT_API_BASE}/auth/skill-credit/session" \
          -H "Content-Type: application/json" \
          -d "{\"clientKey\":\"${INPUT_CLIENT_KEY}\"}")

        ACCESS_TOKEN=$(echo "$SESSION_RES" | jq -r '.accessToken // empty')
        if [ -z "$ACCESS_TOKEN" ]; then
          echo "ERROR: failed to get access token"
          echo "$SESSION_RES"
          exit 1
        fi

        # Build and POST registration payload
        RUNTIME_META=$(jq -nc \
          --arg entry "${SKILL_SUBPATH:+$SKILL_SUBPATH/}scripts" \
          '{entry_hint: $entry, provider: "forgejo"}')

        jq -n \
          --arg slug "$SLUG" \
          --arg ver "${GITHUB_REF_NAME}" \
          --arg note "${INPUT_RELEASE_NOTE:-}" \
          --arg url "${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}.git" \
          --arg sub "${SKILL_SUBPATH:-}" \
          --arg ref "${GITHUB_REF_NAME}" \
          --arg sha "${GITHUB_SHA}" \
          --arg doc_p "${RESOLVED_DOC_PATH:-SKILL.md}" \
          --slurpfile doc_c /tmp/skill_doc.json \
          --argjson meta "$RUNTIME_META" \
          '{
            skill_slug: $slug,
            version: $ver,
            release_note: $note,
            source_type: "git_ci",
            repo_url: $url,
            repo_subpath: $sub,
            git_ref: $ref,
            commit_sha: $sha,
            skill_doc_path: $doc_p,
            skill_doc_content: $doc_c[0],
            runtime_meta: $meta
          }' > /tmp/payload.json

        HTTP_CODE=$(curl -sS -o /tmp/register_response.json -w '%{http_code}' \
          -X POST "${INPUT_API_BASE}/ecom/skills/register-by-slug" \
          -H "Authorization: Bearer ${ACCESS_TOKEN}" \
          -H "Content-Type: application/json" \
          -d @/tmp/payload.json)

        if [ "$HTTP_CODE" -lt 200 ] || [ "$HTTP_CODE" -ge 300 ]; then
          echo "ERROR: registration failed HTTP $HTTP_CODE"
          cat /tmp/register_response.json
          exit 1
        fi

        echo "Registered successfully:"
        cat /tmp/register_response.json