From 5ba44fcb03b335951e3a5cfbb9855a3ecee1b0ac Mon Sep 17 00:00:00 2001 From: MrSphay Date: Fri, 15 May 2026 04:42:55 +0200 Subject: [PATCH] Target Wilkens Gitea defaults --- AGENTS.md | 2 +- CHANGELOG.md | 6 ++++++ README.md | 25 ++++++++++++++++++++----- existing-project.md | 2 +- files/blueprint.json | 4 ++-- files/build-gitea.yml | 2 +- files/release-dry-run-gitea.yml | 2 +- files/template-compliance-gitea.yml | 2 +- manifest.json | 3 +-- new-repository.md | 3 +-- 10 files changed, 35 insertions(+), 16 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 4669a54..6dad8bc 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -20,7 +20,7 @@ This repository ships reusable baseline files for other repositories: ## Editing Rules -- Keep the kit universal. Do not hard-code private hosts, usernames, project names, or local paths in reusable templates. +- Keep repository owner, repository name, project names, and local paths dynamic. This kit intentionally targets `https://git.wilkensxl.de` and SSH port `2222`, so keep that host/port consistent in user-facing setup and Gitea workflow defaults. - If a new placeholder is introduced, update `manifest.json`, the README placeholder list, and placeholder scans in workflow templates. - Keep `README.md` user-facing. Put agent operating rules in this file or the workflow docs. - Keep `files/AGENTS.md` generic; it is copied into target repositories and must not describe this repository specifically. diff --git a/CHANGELOG.md b/CHANGELOG.md index e7320da..432cb24 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,12 @@ All notable changes to the Codex Agent Repository Kit are documented here. +## 1.0.4 - 2026-05-15 + +- Set the documented Gitea host to `git.wilkensxl.de` instead of a generic URL placeholder. +- Documented SSH clone URLs for port `2222` and optional SSH config. +- Restored Gitea workflow and README badge defaults for the intended Gitea instance while keeping repository owner and repository name dynamic. + ## 1.0.3 - 2026-05-15 - Updated repository handoff notes after verifying the refreshed local `GITEA_TOKEN`. diff --git a/README.md b/README.md index f6b733f..77829e3 100644 --- a/README.md +++ b/README.md @@ -52,10 +52,26 @@ Profile -> Settings -> SSH / GPG Keys -> Add Key Clone with SSH: ```bash -git clone git@git.example.com:OWNER/REPOSITORY.git +git clone ssh://git@git.wilkensxl.de:2222/OWNER/REPOSITORY.git cd REPOSITORY ``` +Optional SSH config: + +```text +Host git.wilkensxl.de + HostName git.wilkensxl.de + User git + Port 2222 + IdentityFile ~/.ssh/id_ed25519 +``` + +With that config, this shorter clone URL also works: + +```bash +git clone git@git.wilkensxl.de:OWNER/REPOSITORY.git +``` + Verify the remote: ```bash @@ -124,7 +140,6 @@ PROJECT_STACK DOWNLOAD_URL CI_URL RELEASES_URL -GITEA_SERVER_URL BUILD_COMMAND TEST_COMMAND LINT_COMMAND @@ -202,7 +217,7 @@ Test repository API access: ```powershell $headers = @{ Authorization = "token $env:GITEA_TOKEN" } Invoke-RestMethod ` - -Uri "GITEA_SERVER_URL/api/v1/repos/REPOSITORY_OWNER/REPOSITORY_NAME" ` + -Uri "https://git.wilkensxl.de/api/v1/repos/REPOSITORY_OWNER/REPOSITORY_NAME" ` -Headers $headers ``` @@ -210,7 +225,7 @@ Test issue access: ```powershell Invoke-RestMethod ` - -Uri "GITEA_SERVER_URL/api/v1/repos/REPOSITORY_OWNER/REPOSITORY_NAME/issues?state=open&limit=1" ` + -Uri "https://git.wilkensxl.de/api/v1/repos/REPOSITORY_OWNER/REPOSITORY_NAME/issues?state=open&limit=1" ` -Headers $headers ``` @@ -256,7 +271,7 @@ GITHUB_REPOSITORY REGISTRY_TOKEN ``` -When those values are unavailable, replace `GITEA_SERVER_URL`, `REPOSITORY_OWNER`, and related placeholders before use. +When those values are unavailable, replace `REPOSITORY_OWNER`, `REPOSITORY_NAME`, and related placeholders before use. The default Gitea server is `https://git.wilkensxl.de`. ## Agent Follow-up Issues diff --git a/existing-project.md b/existing-project.md index 290dcfd..b774ee1 100644 --- a/existing-project.md +++ b/existing-project.md @@ -181,7 +181,7 @@ Before final response: - run `git diff --check`, - run the smallest reliable verification command, -- if using Gitea Actions, poll the pushed workflow run until it reaches a terminal state; for private Gitea repositories, use a locally set `GITEA_TOKEN` and `GITEA_SERVER_URL` for read-only API status checks when available, +- if using Gitea Actions, poll the pushed workflow run until it reaches a terminal state; for private Gitea repositories on `https://git.wilkensxl.de`, use a locally set `GITEA_TOKEN` for read-only API status checks when available, - if the pushed workflow fails or is cancelled, inspect the failing job/logs, fix in scope, push again, and repeat the workflow check loop; fixing and pushing is not a stopping point, - list files changed, - mention any skipped checks, diff --git a/files/blueprint.json b/files/blueprint.json index 0b0aa56..2225b7f 100644 --- a/files/blueprint.json +++ b/files/blueprint.json @@ -6,12 +6,12 @@ { "alt": "Build", "img": "https://img.shields.io/badge/build-Gitea%20Runner-2563eb", - "url": "CI_URL" + "url": "https://git.wilkensxl.de/REPOSITORY_OWNER/REPOSITORY_NAME/actions" }, { "alt": "Version", "img": "https://img.shields.io/badge/version-0.1.0-111827", - "url": "RELEASES_URL" + "url": "https://git.wilkensxl.de/REPOSITORY_OWNER/REPOSITORY_NAME/releases" } ], "headingPrefix": { diff --git a/files/build-gitea.yml b/files/build-gitea.yml index 39acc23..33295e4 100644 --- a/files/build-gitea.yml +++ b/files/build-gitea.yml @@ -58,7 +58,7 @@ jobs: if [ -z "${repository_owner}" ] || [ "${repository_owner}" = "${GITHUB_REPOSITORY}" ]; then repository_owner="REPOSITORY_OWNER" fi - gitea_server="${GITHUB_SERVER_URL:-GITEA_SERVER_URL}" + gitea_server="${GITHUB_SERVER_URL:-https://git.wilkensxl.de}" gitea_server="${gitea_server%/}" package_dir="package-registry" latest_url="${gitea_server}/api/packages/${repository_owner}/generic/${package_name}/latest" diff --git a/files/release-dry-run-gitea.yml b/files/release-dry-run-gitea.yml index 76facf8..894cb86 100644 --- a/files/release-dry-run-gitea.yml +++ b/files/release-dry-run-gitea.yml @@ -34,7 +34,7 @@ jobs: done placeholder_paths=(README.md AGENTS.md .codex docs .gitea) - placeholder_pattern='PROJECT_NAME|PROJECT_DESCRIPTION|REPOSITORY_OWNER|REPOSITORY_NAME|PACKAGE_NAME|ARTIFACT_NAME|ARTIFACT_OUTPUT_DIRECTORY|DOWNLOAD_URL|CI_URL|RELEASES_URL|GITEA_SERVER_URL|BUILD_COMMAND|TEST_COMMAND|LINT_COMMAND|AUDIT_COMMAND|COMMIT_OR_VERSION' + placeholder_pattern='PROJECT_NAME|PROJECT_DESCRIPTION|REPOSITORY_OWNER|REPOSITORY_NAME|PACKAGE_NAME|ARTIFACT_NAME|ARTIFACT_OUTPUT_DIRECTORY|DOWNLOAD_URL|CI_URL|RELEASES_URL|BUILD_COMMAND|TEST_COMMAND|LINT_COMMAND|AUDIT_COMMAND|COMMIT_OR_VERSION' for path in "${placeholder_paths[@]}"; do [ -e "$path" ] || continue diff --git a/files/template-compliance-gitea.yml b/files/template-compliance-gitea.yml index d0d018a..ea5fae6 100644 --- a/files/template-compliance-gitea.yml +++ b/files/template-compliance-gitea.yml @@ -54,7 +54,7 @@ jobs: run: | found=0 paths=(AGENTS.md README.md SECURITY.md CHANGELOG.md .codex docs .gitea blueprint.md blueprint.json) - pattern='PROJECT_NAME|PROJECT_DESCRIPTION|REPOSITORY_OWNER|REPOSITORY_NAME|PACKAGE_NAME|ARTIFACT_NAME|ARTIFACT_OUTPUT_DIRECTORY|AUTHOR_NAME|PROJECT_STACK|DOWNLOAD_URL|CI_URL|RELEASES_URL|GITEA_SERVER_URL|BUILD_COMMAND|TEST_COMMAND|LINT_COMMAND|AUDIT_COMMAND|README_COMMAND|INSTALL_COMMAND|DEV_COMMAND|PACKAGE_MANAGER|PROJECT_VERSION|COMMIT_OR_VERSION' + pattern='PROJECT_NAME|PROJECT_DESCRIPTION|REPOSITORY_OWNER|REPOSITORY_NAME|PACKAGE_NAME|ARTIFACT_NAME|ARTIFACT_OUTPUT_DIRECTORY|AUTHOR_NAME|PROJECT_STACK|DOWNLOAD_URL|CI_URL|RELEASES_URL|BUILD_COMMAND|TEST_COMMAND|LINT_COMMAND|AUDIT_COMMAND|README_COMMAND|INSTALL_COMMAND|DEV_COMMAND|PACKAGE_MANAGER|PROJECT_VERSION|COMMIT_OR_VERSION' for path in "${paths[@]}"; do [ -e "$path" ] || continue diff --git a/manifest.json b/manifest.json index 2a8787e..31ae029 100644 --- a/manifest.json +++ b/manifest.json @@ -1,6 +1,6 @@ { "name": "codex-agent-repository-kit", - "version": "1.0.3", + "version": "1.0.4", "description": "Universal repository baseline for Codex-assisted projects.", "agentResponsibilities": [ "Read manifest.json before copying files.", @@ -195,7 +195,6 @@ "DOWNLOAD_URL", "CI_URL", "RELEASES_URL", - "GITEA_SERVER_URL", "BUILD_COMMAND", "TEST_COMMAND", "LINT_COMMAND", diff --git a/new-repository.md b/new-repository.md index 2f4742f..27616fb 100644 --- a/new-repository.md +++ b/new-repository.md @@ -95,7 +95,6 @@ PROJECT_STACK DOWNLOAD_URL CI_URL RELEASES_URL -GITEA_SERVER_URL BUILD_COMMAND TEST_COMMAND LINT_COMMAND @@ -197,7 +196,7 @@ Before final response: - run formatting or validation if available, - run the cheapest reliable verification command, - check `git diff --check`, -- if using Gitea Actions, poll the pushed workflow run until it reaches a terminal state; for private Gitea repositories, use a locally set `GITEA_TOKEN` and `GITEA_SERVER_URL` for read-only API status checks when available, +- if using Gitea Actions, poll the pushed workflow run until it reaches a terminal state; for private Gitea repositories on `https://git.wilkensxl.de`, use a locally set `GITEA_TOKEN` for read-only API status checks when available, - if the pushed workflow fails or is cancelled, inspect the failing job/logs, fix in scope, push again, and repeat the workflow check loop; fixing and pushing is not a stopping point, - summarize changed files, - do not create a release unless explicitly requested.