From bd145dcec685e9740b738ed2cedc00ff39fab7b1 Mon Sep 17 00:00:00 2001 From: documentation-specialist Date: Thu, 7 May 2026 00:48:04 -0700 Subject: [PATCH] docs(workspace-runtime): migrate github.com refs at source so mirror inherits Gitea links (internal#41) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The molecule-ai-workspace-runtime mirror is regenerated on every runtime-v* tag from this monorepo's workspace/. Per saved memory reference_runtime_repo_is_mirror_only, mirror-guard rejects direct PRs to the mirror; edit at source. Source-side files that propagate to the mirror's published README + read by users of the in-monorepo workspace-runtime docs: - scripts/build_runtime_package.py (the README generator): * line 281 README_TEMPLATE: 'Shared workspace runtime for Molecule AI' link → Gitea * line 399 doc-link to workspace-runtime-package.md → Gitea path (with /src/branch/main/ shape) LEFT AS-IS (per Q3 audit-trail decision): * lines 379, 392 historical issue cross-refs (#2936, #2937) - workspace/build-all.sh:5 — comment block linking to template-* repos. Migrated to Gitea path-shape. - docs/workspace-runtime-package.md: * lines 101-108 adapter→repo table (8 templates, all PUBLIC on Gitea) — Gitea URLs * line 247 starter-repo link — substituted host + added inline note that starter doesn't survive the suspension migration (recreation pending; cross-link to this issue) * line 259 generic git clone command for new templates → Gitea * line 289 second starter mention — same handling as 247 Files NOT touched in this PR: - workspace/ Python source code (.py files) — those use github paths in docstrings + a few log strings; fix bundled with the cross-repo Go-module-style migration (per #37 Q5 + parked follow-ups). - 'Writing a new adapter' section's `gh repo create` command (line 254-256) — gh CLI doesn't talk to Gitea (per #45 parked follow-up). - 'Writing a new adapter' section's ghcr.io image ref (line 276) — per #46 ghcr→ECR migration (separate concern). After this PR merges to staging + a runtime-v* tag is pushed, the mirror's published README will inherit the Gitea link. Until then the mirror's README continues to reference github.com/Molecule-AI (stale but historical-marker-correct since the mirror existed pre-suspension). Refs: molecule-ai/internal#41, molecule-ai/internal#37, molecule-ai/internal#38, molecule-ai/internal#42, molecule-ai/internal#45, molecule-ai/internal#46 --- docs/workspace-runtime-package.md | 22 +++++++++++----------- scripts/build_runtime_package.py | 4 ++-- workspace/build-all.sh | 2 +- 3 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/workspace-runtime-package.md b/docs/workspace-runtime-package.md index aec351bc..84bc2794 100644 --- a/docs/workspace-runtime-package.md +++ b/docs/workspace-runtime-package.md @@ -98,14 +98,14 @@ Each of the 8 adapter template repos contains: | Adapter | Repo | |---------|------| -| claude-code | https://github.com/Molecule-AI/molecule-ai-workspace-template-claude-code | -| langgraph | https://github.com/Molecule-AI/molecule-ai-workspace-template-langgraph | -| crewai | https://github.com/Molecule-AI/molecule-ai-workspace-template-crewai | -| autogen | https://github.com/Molecule-AI/molecule-ai-workspace-template-autogen | -| deepagents | https://github.com/Molecule-AI/molecule-ai-workspace-template-deepagents | -| hermes | https://github.com/Molecule-AI/molecule-ai-workspace-template-hermes | -| gemini-cli | https://github.com/Molecule-AI/molecule-ai-workspace-template-gemini-cli | -| openclaw | https://github.com/Molecule-AI/molecule-ai-workspace-template-openclaw | +| claude-code | https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-claude-code | +| langgraph | https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-langgraph | +| crewai | https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-crewai | +| autogen | https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-autogen | +| deepagents | https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-deepagents | +| hermes | https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-hermes | +| gemini-cli | https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-gemini-cli | +| openclaw | https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-openclaw | ## Adapter discovery (ADAPTER_MODULE) @@ -244,7 +244,7 @@ correctness before pushing a `runtime-v*` tag. ## Writing a new adapter Use the GitHub template repo -[`Molecule-AI/molecule-ai-workspace-template-starter`](https://github.com/Molecule-AI/molecule-ai-workspace-template-starter) +[`molecule-ai/molecule-ai-workspace-template-starter`](https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-starter) (note: the starter repo did not survive the 2026-05-06 GitHub-org-suspension migration; recreation tracked at internal#41) — it ships with the canonical Dockerfile + adapter.py skeleton + config.yaml schema + the `repository_dispatch: [runtime-published]` cascade receiver already wired up. No follow-up setup PR required. @@ -256,7 +256,7 @@ gh repo create Molecule-AI/molecule-ai-workspace-template- \ --public \ --description "Molecule AI workspace template: " -git clone https://github.com/Molecule-AI/molecule-ai-workspace-template- +git clone https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-.git cd molecule-ai-workspace-template- ``` @@ -286,7 +286,7 @@ After `git push`: If the canonical shape changes (e.g. `config.yaml` schema gets a new field, the `BaseAdapter` interface adds a method, the reusable CI workflow signature changes), update the -[starter](https://github.com/Molecule-AI/molecule-ai-workspace-template-starter) +[starter](https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-starter) (recreation pending — see note above) **first**. Existing templates can either migrate at their own pace or be touched in a coordinated cleanup PR. Either way, future templates pick up the new shape from day one. diff --git a/scripts/build_runtime_package.py b/scripts/build_runtime_package.py index d4eedde2..b4eb726e 100755 --- a/scripts/build_runtime_package.py +++ b/scripts/build_runtime_package.py @@ -278,7 +278,7 @@ include = ["molecule_runtime*"] README_TEMPLATE = """\ # molecule-ai-workspace-runtime -Shared workspace runtime for [Molecule AI](https://github.com/Molecule-AI/molecule-core) +Shared workspace runtime for [Molecule AI](https://git.moleculesai.app/molecule-ai/molecule-core) agent adapters. Installed by every workspace template image (`workspace-template-claude-code`, `-langgraph`, `-hermes`, etc.) to provide A2A delegation, heartbeat, memory, plugin loading, and skill management. @@ -396,7 +396,7 @@ If you don't need real-time push, the default poll path works universally with no extra setup; both modes converge on the same `inbox_pop` ack so messages never duplicate. -See [`docs/workspace-runtime-package.md`](https://github.com/Molecule-AI/molecule-core/blob/main/docs/workspace-runtime-package.md) +See [`docs/workspace-runtime-package.md`](https://git.moleculesai.app/molecule-ai/molecule-core/src/branch/main/docs/workspace-runtime-package.md) for the publish flow and architecture. """ diff --git a/workspace/build-all.sh b/workspace/build-all.sh index 3ef07486..51c4ecb2 100755 --- a/workspace/build-all.sh +++ b/workspace/build-all.sh @@ -2,7 +2,7 @@ # build-all.sh — Rebuild base image and optionally adapter images. # # NOTE: Adapters have been extracted to standalone template repos: -# https://github.com/Molecule-AI/molecule-ai-workspace-template- +# https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template- # # This script now only builds the base image from workspace/Dockerfile. # Each adapter repo has its own Dockerfile that installs molecule-ai-workspace-runtime