From c01049dd5ba77b20e48a68328a45333c7acca7aa Mon Sep 17 00:00:00 2001 From: tinqs-limited Date: Fri, 22 May 2026 17:56:40 +0100 Subject: [PATCH] =?UTF-8?q?docs:=20clean=20up=20action=20comments=20?= =?UTF-8?q?=E2=80=94=20describe=20what=20we=20do,=20not=20what=20others=20?= =?UTF-8?q?had?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- checkout/action.yml | 14 +++++--------- setup-aws/action.yml | 15 ++++++--------- setup-go/action.yml | 14 +++++--------- setup-node/action.yml | 14 +++++--------- 4 files changed, 21 insertions(+), 36 deletions(-) diff --git a/checkout/action.yml b/checkout/action.yml index 846f2e5..9a071cc 100644 --- a/checkout/action.yml +++ b/checkout/action.yml @@ -1,12 +1,8 @@ -# Tinqs Checkout — replaces actions/checkout@v4 -# Original: https://github.com/actions/checkout (GitHub-hosted, Node.js action) -# Why rewritten: actions/checkout requires Node.js runtime and GitHub API calls. -# On self-hosted Gitea (tinqs.com), it fails because it tries to hit api.github.com. -# This composite action uses plain git clone — works on any runner with git installed. -# Removed from original: submodules, LFS, sparse-checkout, GitHub token auth, persist-credentials. -# We only need depth, ref, and optional Gitea token for private repos. -# Author: Ozan / Claude Code — 2026-05-22 -# Part of: tinqs/ci (Tinqs CI toolchain) +# tinqs/ci/checkout — Tinqs Studio CI +# Clones a repo from tinqs.com (self-hosted Gitea) using plain git. +# Supports depth control, branch/tag selection, and token auth for private repos. +# Composite action — runs directly on the host, no Node.js runtime needed. +# Author: Ozan + Claude Code — 2026-05-22 name: 'Tinqs Checkout' description: 'Clone a Gitea repository (replaces actions/checkout)' diff --git a/setup-aws/action.yml b/setup-aws/action.yml index 457ebc6..8cdb7fd 100644 --- a/setup-aws/action.yml +++ b/setup-aws/action.yml @@ -1,12 +1,9 @@ -# Tinqs Setup AWS — replaces aws-actions/configure-aws-credentials@v4 -# Original: https://github.com/aws-actions/configure-aws-credentials (GitHub-hosted, Node.js) -# Why rewritten: Original uses OIDC federation with GitHub's token endpoint — doesn't exist -# on Gitea. Our runners use IAM task roles (ECS/Fargate) or instance profiles (EC2/Lightsail), -# so we don't need credential configuration — just install the CLI and optionally ECR login. -# Removed from original: OIDC, assume-role, session tokens, credential masking, region output. -# ECR login bundled here instead of needing separate aws-actions/amazon-ecr-login. -# Author: Ozan / Claude Code — 2026-05-22 -# Part of: tinqs/ci (Tinqs CI toolchain) +# tinqs/ci/setup-aws — Tinqs Studio CI +# Installs AWS CLI and optionally logs into ECR. +# Credentials come from the runner environment (IAM task role on Fargate, instance +# profile on EC2/Lightsail) — no explicit key configuration needed. +# Composite action — runs directly on the host. +# Author: Ozan + Claude Code — 2026-05-22 name: 'Tinqs Setup AWS' description: 'Install AWS CLI and optionally login to ECR' diff --git a/setup-go/action.yml b/setup-go/action.yml index 97c487f..76fc85f 100644 --- a/setup-go/action.yml +++ b/setup-go/action.yml @@ -1,12 +1,8 @@ -# Tinqs Setup Go — replaces actions/setup-go@v5 -# Original: https://github.com/actions/setup-go (GitHub-hosted, Node.js action) -# Why rewritten: Original uses GitHub's tool cache API and Node.js runtime — neither -# available on self-hosted Gitea runners. This composite action downloads Go directly -# from go.dev and sets GITHUB_PATH. Skips install if correct version already present -# (for when runner image has Go pre-baked). -# Removed from original: tool cache, go-version-file, check-latest, cache (actions/cache dep). -# Author: Ozan / Claude Code — 2026-05-22 -# Part of: tinqs/ci (Tinqs CI toolchain) +# tinqs/ci/setup-go — Tinqs Studio CI +# Downloads Go from go.dev and adds it to PATH. +# Skips install if the correct version is already present (pre-baked runner image). +# Composite action — runs directly on the host. +# Author: Ozan + Claude Code — 2026-05-22 name: 'Tinqs Setup Go' description: 'Install Go and configure PATH (replaces actions/setup-go)' diff --git a/setup-node/action.yml b/setup-node/action.yml index bdd6c7a..173f630 100644 --- a/setup-node/action.yml +++ b/setup-node/action.yml @@ -1,12 +1,8 @@ -# Tinqs Setup Node — replaces actions/setup-node@v4 -# Original: https://github.com/actions/setup-node (GitHub-hosted, Node.js action) -# Why rewritten: Original depends on GitHub tool cache and @actions/core Node.js package. -# Self-hosted Gitea runners don't have the tool cache infrastructure. -# This composite action installs Node via NodeSource APT repo and pnpm via npm. -# Skips install if correct major version already present (pre-baked runner image). -# Removed from original: tool cache, .nvmrc/.node-version file, registry-url, cache (yarn/pnpm). -# Author: Ozan / Claude Code — 2026-05-22 -# Part of: tinqs/ci (Tinqs CI toolchain) +# tinqs/ci/setup-node — Tinqs Studio CI +# Installs Node.js via NodeSource and optionally pnpm. +# Skips install if the correct major version is already present (pre-baked runner image). +# Composite action — runs directly on the host. +# Author: Ozan + Claude Code — 2026-05-22 name: 'Tinqs Setup Node' description: 'Install Node.js and pnpm (replaces actions/setup-node)'