feat(yarn-cli): distribute runtime through release assets

.gitignore

@@ -42,9 +42,11 @@ node_modules
 # This is the Yarn install state cache, it can be rebuilt anytime
 /.yarn/install-state.gz
 /.yarn/sdks
+/.yarn/raijin
 
 dist/
-!yarn/cli/dist
+!yarn/cli/dist/
+yarn/cli/dist/*
 yarn/plugin-*/bundles/
 !yarn/plugin-badges/bundles/
 !yarn/plugin-badges/bundles/**

README.md

@@ -36,13 +36,14 @@ Raijin — это подход к работе в едином инженерн
 ### Новый проект
 
 ```bash
-yarn set version https://raw.githubusercontent.com/atls/raijin/master/yarn/cli/dist/yarn.mjs
+yarn set version https://raw.githubusercontent.com/atls/raijin/master/.yarn/releases/yarn.mjs
 yarn set version atls
 ```
 
 Ожидаемый результат:
 
-- В проекте появляется/обновляется `.yarn/releases/yarn.mjs`
+- В проекте появляется/обновляется полный файл первичного подключения `.yarn/releases/yarn.mjs`
+- `yarn set version atls` обновляет бандл через вложение релиза GitHub штатным механизмом Yarn
 - Команды `raijin` становятся доступны через `yarn`
 
 ### Обновление
@@ -53,7 +54,7 @@ yarn set version atls
 
 Ожидаемый результат:
 
-- Подтягивается актуальная версия бандла
+- Бандл обновляется до последней доступной версии штатным механизмом Yarn
 
 ### Проверка
 

README_EN.md

@@ -36,13 +36,14 @@ It aligns teams on strict standards and strong contracts to increase delivery pr
 ### New project
 
 ```bash
-yarn set version https://raw.githubusercontent.com/atls/raijin/master/yarn/cli/dist/yarn.mjs
+yarn set version https://raw.githubusercontent.com/atls/raijin/master/.yarn/releases/yarn.mjs
 yarn set version atls
 ```
 
 Expected result:
 
-- `.yarn/releases/yarn.mjs` is added or updated in the project
+- A full initial `.yarn/releases/yarn.mjs` entry file is added or updated
+- `yarn set version atls` updates the bundle from a GitHub Release asset through Yarn
 - Raijin commands are available via `yarn`
 
 ### Upgrade
@@ -53,7 +54,7 @@ yarn set version atls
 
 Expected result:
 
-- The latest bundle version is installed
+- The bundle is upgraded to the latest available version through Yarn
 
 ### Verify
 

code/code-github/src/release.ts

@@ -16,6 +16,35 @@ interface CreateOptions {
   repo: string
 }
 
+interface GitHubRelease {
+  id: number
+  assets: Array<{
+    browser_download_url: string
+    name: string
+  }>
+}
+
+interface GetByTagOptions {
+  owner: string
+  repo: string
+  tag_name: string
+}
+
+interface UploadAssetOptions {
+  content_type: string
+  data: string
+  name: string
+  owner: string
+  size: number
+  release_id: number
+  repo: string
+}
+
+interface GitHubReleaseAsset {
+  browser_download_url: string
+  name: string
+}
+
 interface GenerateNotesOptions {
   tag_name: string
   target_commitish?: string
@@ -34,7 +63,7 @@ export class Release {
     })
   }
 
-  async create(options: CreateOptions): Promise<number> {
+  async create(options: CreateOptions): Promise<GitHubRelease> {
     const {
       owner,
       repo,
@@ -57,7 +86,58 @@ export class Release {
       body,
     })
 
-    return result.status
+    return {
+      id: result.data.id,
+      assets: result.data.assets.map((asset) => ({
+        browser_download_url: asset.browser_download_url,
+        name: asset.name,
+      })),
+    }
+  }
+
+  async getByTag(options: GetByTagOptions): Promise<GitHubRelease> {
+    const { owner, repo, tag_name: tagName } = options
+    const result = await this.client.repos.getReleaseByTag({
+      owner,
+      repo,
+      tag: tagName,
+    })
+
+    return {
+      id: result.data.id,
+      assets: result.data.assets.map((asset) => ({
+        browser_download_url: asset.browser_download_url,
+        name: asset.name,
+      })),
+    }
+  }
+
+  async uploadAsset(options: UploadAssetOptions): Promise<GitHubReleaseAsset> {
+    const {
+      owner,
+      repo,
+      release_id: releaseId,
+      name,
+      data,
+      size,
+      content_type: contentType,
+    } = options
+    const result = await this.client.repos.uploadReleaseAsset({
+      owner,
+      repo,
+      release_id: releaseId,
+      name,
+      data,
+      headers: {
+        'content-length': size,
+        'content-type': contentType,
+      },
+    })
+
+    return {
+      browser_download_url: result.data.browser_download_url,
+      name: result.data.name,
+    }
   }
 
   async generateNotes(options: GenerateNotesOptions): Promise<string> {

docs/raijin/quickstart.md

@@ -19,13 +19,14 @@ Expected result:
 ## 2. New project: install the bundle
 
 ```bash
-yarn set version https://raw.githubusercontent.com/atls/raijin/master/yarn/cli/dist/yarn.mjs
+yarn set version https://raw.githubusercontent.com/atls/raijin/master/.yarn/releases/yarn.mjs
 yarn set version atls
 ```
 
 Expected result:
 
-- `.yarn/releases/` contains the current Raijin `yarn.mjs`
+- `.yarn/releases/yarn.mjs` contains the full initial Raijin entry file
+- `yarn set version atls` updates the bundle from a GitHub Release asset through Yarn
 - Bundle commands (`check`, `files changed list`, etc.) become available
 
 <!-- sync:bundle-upgrade -->

docs/raijin/quickstart.ru.md

@@ -19,13 +19,14 @@
 ## 2. Новый проект: подключение бандла
 
 ```bash
-yarn set version https://raw.githubusercontent.com/atls/raijin/master/yarn/cli/dist/yarn.mjs
+yarn set version https://raw.githubusercontent.com/atls/raijin/master/.yarn/releases/yarn.mjs
 yarn set version atls
 ```
 
 Ожидаемый результат:
 
-- В `.yarn/releases/` появляется актуальный `yarn.mjs` из Raijin
+- В `.yarn/releases/yarn.mjs` появляется полный файл первичного подключения Raijin
+- `yarn set version atls` обновляет бандл через вложение релиза GitHub штатным механизмом Yarn
 - Команды из бандла (`check`, `files changed list` и другие) становятся доступны
 
 <!-- sync:bundle-upgrade -->

scripts/raijin/generate-artifacts.mjs

@@ -339,14 +339,17 @@ const renderRootReadme = (language) => {
     isRu ? '### Новый проект' : '### New project',
     '',
     '```bash',
-    'yarn set version https://raw.githubusercontent.com/atls/raijin/master/yarn/cli/dist/yarn.mjs',
+    'yarn set version https://raw.githubusercontent.com/atls/raijin/master/.yarn/releases/yarn.mjs',
     'yarn set version atls',
     '```',
     '',
     isRu ? 'Ожидаемый результат:' : 'Expected result:',
     isRu
-      ? '- В проекте появляется/обновляется `.yarn/releases/yarn.mjs`'
-      : '- `.yarn/releases/yarn.mjs` is added or updated in the project',
+      ? '- В проекте появляется/обновляется полный файл первичного подключения `.yarn/releases/yarn.mjs`'
+      : '- A full initial `.yarn/releases/yarn.mjs` entry file is added or updated',
+    isRu
+      ? '- `yarn set version atls` обновляет бандл через вложение релиза GitHub штатным механизмом Yarn'
+      : '- `yarn set version atls` updates the bundle from a GitHub Release asset through Yarn',
     isRu
       ? '- Команды `raijin` становятся доступны через `yarn`'
       : '- Raijin commands are available via `yarn`',
@@ -358,7 +361,9 @@ const renderRootReadme = (language) => {
     '```',
     '',
     isRu ? 'Ожидаемый результат:' : 'Expected result:',
-    isRu ? '- Подтягивается актуальная версия бандла' : '- The latest bundle version is installed',
+    isRu
+      ? '- Бандл обновляется до последней доступной версии штатным механизмом Yarn'
+      : '- The bundle is upgraded to the latest available version through Yarn',
     '',
     isRu ? '### Проверка' : '### Verify',
     '',
@@ -565,14 +570,17 @@ const renderQuickstart = (language) => {
     isRu ? '## 2. Новый проект: подключение бандла' : '## 2. New project: install the bundle',
     '',
     '```bash',
-    'yarn set version https://raw.githubusercontent.com/atls/raijin/master/yarn/cli/dist/yarn.mjs',
+    'yarn set version https://raw.githubusercontent.com/atls/raijin/master/.yarn/releases/yarn.mjs',
     'yarn set version atls',
     '```',
     '',
     isRu ? 'Ожидаемый результат:' : 'Expected result:',
     isRu
-      ? '- В `.yarn/releases/` появляется актуальный `yarn.mjs` из Raijin'
-      : '- `.yarn/releases/` contains the current Raijin `yarn.mjs`',
+      ? '- В `.yarn/releases/yarn.mjs` появляется полный файл первичного подключения Raijin'
+      : '- `.yarn/releases/yarn.mjs` contains the full initial Raijin entry file',
+    isRu
+      ? '- `yarn set version atls` обновляет бандл через вложение релиза GitHub штатным механизмом Yarn'
+      : '- `yarn set version atls` updates the bundle from a GitHub Release asset through Yarn',
     isRu
       ? '- Команды из бандла (`check`, `files changed list` и другие) становятся доступны'
       : '- Bundle commands (`check`, `files changed list`, etc.) become available',

yarn/cli/package.json

@@ -15,8 +15,8 @@
   "scripts": {
     "build": "yarn run build:schemaic && yarn run build:clean && yarn run build:version && yarn run build:bundle && yarn run build:fix && yarn run build:dist && yarn run build:version",
     "build:bundle": "builder build bundle --no-git-hash && mv bundles/yarn.js bundles/yarn.mjs",
-    "build:clean": "rm -rf dist",
-    "build:dist": "mv bundles dist",
+    "build:clean": "rm -rf dist/runtime",
+    "build:dist": "mkdir -p dist/runtime && mv bundles/yarn.mjs dist/runtime/yarn.mjs",
     "build:fix": "yarn node patches/cli.patch.mjs",
     "build:schemaic": "yarn workspace @atls/code-schematics prepack",
     "build:version": "yarn node patches/version-postfix-toggle.mjs",

yarn/pack-utils/src/pack.utils.test.ts

@@ -1,8 +1,18 @@
+import type { Project }                  from '@yarnpkg/core'
+import type { Report }                   from '@yarnpkg/core'
+
 import assert                            from 'node:assert/strict'
+import { mkdir }                         from 'node:fs/promises'
+import { writeFile }                     from 'node:fs/promises'
 import { arch }                          from 'node:os'
 import test                              from 'node:test'
 
+import { npath }                         from '@yarnpkg/fslib'
+import { ppath }                         from '@yarnpkg/fslib'
+import { xfs }                           from '@yarnpkg/fslib'
+
 import { IMAGE_PACK_NODE_LINKER }        from './pack.utils.js'
+import { copyYarnRelease }               from './copy.utils.js'
 import { resolveSupportedArchitectures } from './pack.utils.js'
 
 test('should materialize image pack runtime with PnP linker', () => {
@@ -41,3 +51,67 @@ test('should normalize Docker platform aliases before Yarn install', () => {
     ])
   )
 })
+
+test('should copy yarn release without runtime cache side effects', async () => {
+  await xfs.mktempPromise(async (source) => {
+    await xfs.mktempPromise(async (destination) => {
+      const yarnPath = ppath.join(source, '.yarn/releases/yarn.mjs')
+      const yarnNativePath = npath.fromPortablePath(yarnPath)
+
+      await mkdir(npath.dirname(yarnNativePath), { recursive: true })
+      await writeFile(yarnNativePath, '#!/usr/bin/env node\n', { mode: 0o755 })
+
+      await copyYarnRelease(
+        {
+          cwd: source,
+          configuration: {
+            get: (name: string) => (name === 'yarnPath' ? yarnPath : undefined),
+          },
+        } as unknown as Project,
+        destination,
+        { reportInfo: () => undefined } as unknown as Report
+      )
+
+      assert.equal(
+        await xfs.existsPromise(ppath.join(destination, '.yarn/releases/yarn.mjs')),
+        true
+      )
+    })
+  })
+})
+
+test('should copy yarn release from native yarn path', async (context) => {
+  await xfs.mktempPromise(async (source) => {
+    await xfs.mktempPromise(async (destination) => {
+      const yarnPath = ppath.join(source, '.yarn/releases/yarn.mjs')
+      const yarnNativePath = npath.fromPortablePath(yarnPath)
+
+      await mkdir(npath.dirname(yarnNativePath), { recursive: true })
+      await writeFile(yarnNativePath, '#!/usr/bin/env node\n', { mode: 0o755 })
+
+      context.mock.method(npath, 'fromPortablePath', (path: string) => {
+        if (path === yarnPath) {
+          return yarnNativePath
+        }
+
+        return path
+      })
+
+      await copyYarnRelease(
+        {
+          cwd: source,
+          configuration: {
+            get: (name: string) => (name === 'yarnPath' ? yarnPath : undefined),
+          },
+        } as unknown as Project,
+        destination,
+        { reportInfo: () => undefined } as unknown as Report
+      )
+
+      assert.equal(
+        await xfs.existsPromise(ppath.join(destination, '.yarn/releases/yarn.mjs')),
+        true
+      )
+    })
+  })
+})