Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/RELEASE_POLICY.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# 4FusionLab — automatic runtime release policy

[Русская версия](RELEASE_POLICY.ru.md)

## Trigger

- A direct push to `main` or a PR merge into `main` is the only normal release event. PR checks, manual CI dispatch and version-tag pushes **do not** initiate publication.
Expand Down
23 changes: 23 additions & 0 deletions .github/RELEASE_POLICY.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# 4FusionLab — политика автоматических релизов исполняемых компонентов

[English](RELEASE_POLICY.md)

## Запуск

- Прямой push в `main` или объединение PR в `main` — единственное обычное событие релиза. Проверки PR, ручной запуск CI и отправка тегов версий **не** запускают публикацию.
- Перед публикацией сравнивайте весь диапазон `github.event.before..GITHUB_SHA`, включая переименованные и удалённые исполняемые файлы. Релиз допустим **только**, если отправленные коммиты изменяют поставляемый файл аддона или исполняемой среды, ресурс, нативный компонент либо явно назначенный вход дистрибутива.
- Репозитории с поставляемыми исполняемыми компонентами используют `.github/release-paths.txt` как проверенный перечень, контролируемый `scripts/release_changes.py`. В репозиториях без исполняемых компонентов нет задания релиза. Изменения только README, руководств, проектной документации, скриншотов, тестов, CI, политики репозитория или конфигурации GitVersion не должны публиковать релиз.
- До публикации должны успешно завершиться все обязательные существующие проверки CI. При отказе проверки не создаётся релиз, не изменяется тег и не заменяются артефакты.

## Версия и распространение

- GitVersion.Tool **6.8.2** определяет числовую версию `MAJOR.MINOR.PATCH` с помощью `GitVersion.yml` и полной истории Git. ZIP пакета, встроенный манифест Fusion (где применимо), автоматически созданный неизменяемый тег `vMAJOR.MINOR.PATCH` и GitHub Release относятся к одному коммиту и версии.
- Конвейер создаёт тег **автоматически** при публикации GitHub Release. Участники никогда не создают и не отправляют теги релизов вручную. Существующий тег версии, указывающий на другой коммит, считается ошибкой; опубликованный релиз никогда не перезаписывается.
- При наличии используются проверенные заметки конкретной версии; иначе заметки автоматически создаются из истории Git. Подготовка файла заметок вручную только для выпуска изменения кода не требуется.
- Стабильные релизы становятся Latest. Предварительные выпуски никогда не становятся Latest. Продолжают действовать проектные ограничения приёмки CAD, тестирования, подписанных архивов и контрольных сумм, совместимости ОС и публикации.

## Этот репозиторий

Этот репозиторий содержит только профиль и метаданные организации 4FusionLab. В нём нет аддона Fusion или распространяемого исполняемого компонента, а значит и GitHub Release.

Если push не меняет подходящие исполняемые файлы, CI может запуститься, но задание GitHub Release пропускается, даже если GitVersion вычисляет другую версию-кандидат.
2 changes: 2 additions & 0 deletions ACTIONS_PINS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Official GitHub Actions pins

[Русская версия](ACTIONS_PINS.ru.md)

This file is the 4FusionLab source of truth for first-party GitHub Actions used in CI, add-in packaging and (manual) GitHub Pages publishing. Check the upstream repository tag ref before changing any SHA. Pin to an immutable **40-character commit SHA**, not `@vN`, `@main` or an abbreviated hash.

| Action | Reviewed version | Immutable commit SHA |
Expand Down
27 changes: 27 additions & 0 deletions ACTIONS_PINS.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# Закреплённые версии официальных GitHub Actions

[English](ACTIONS_PINS.md)

Этот файл — источник истины 4FusionLab для официальных GitHub Actions, используемых в CI, упаковке аддонов и ручной публикации GitHub Pages. Перед изменением SHA проверяйте ссылку на тег в исходном репозитории. Закрепляйте неизменяемый **полный SHA коммита из 40 символов**, а не `@vN`, `@main` или сокращённый хеш.

| Action | Проверенная версия | Неизменяемый SHA коммита |
| --- | --- | --- |
| `actions/checkout` | `v7.0.1` | `3d3c42e5aac5ba805825da76410c181273ba90b1` |
| `actions/setup-python` | `v7.1.0` | `6d4fd22b20465ccc0f7354476588e8df7c9ca0e0` |
| `actions/setup-node` | `v6` | `249970729cb0ef3589644e2896645e5dc5ba9c38` |
| `actions/upload-artifact` | `v7.0.2` | `cf430e030ddbb5b0abf93d22962f4752f3646cd9` |
| `actions/download-artifact` | `v8.0.2` | `9000827ccba6bdab643e8b6fd33ac0654aef8333` |
| `actions/configure-pages` | `v5` | `983d7736d9b0ae728b81ab479565c72886d7745b` |
| `actions/upload-pages-artifact` | `v3` | `56afc609e74202658d3ffba0e8f6dda462b719fa` |
| `actions/deploy-pages` | `v4` | `d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e` |

Проверено **2026-11-07** по каждому вышестоящему `refs/tags/<version>` через GitHub REST API. Документ намеренно **не** утверждает, что эти версии навсегда останутся последними.

## Правила сопровождения

1. Сохраняйте существующую архитектуру и CI продукта для каждой ОС. Обновление официального Action относится только к инфраструктуре и само по себе **не должно** менять `.github/release-paths.txt` или публиковать GitHub Release.
2. По возможности обновляйте Actions вместе, создавая один удобный для проверки PR на репозиторий. Перед объединением проверяйте фактический CI PR, включая требования к ZIP и SHA-256; затем проверяйте запуски `main` и пропущенные шаги публикации.
3. Разрешение `contents: write` нужно только заданиям релиза продукта. Для обычного CI оставляйте `contents: read`; при checkout задавайте `persist-credentials: false`, кроме случаев, когда конкретная разрешённая запись требует другого.
4. Не развёртывайте автоматически демо Filamentra-DataSource в GitHub Pages при обновлении закреплённых версий. Его workflow намеренно запускается вручную.
5. Общие составные Actions 4FusionLab поддерживаются отдельно: потребители закрепляют `4FusionLab/.github/.github/actions/*` за проверенным SHA коммита платформы. GitVersion.Tool остаётся версии `6.8.2`.
6. При изменении закрепления определите тег в исходном GitHub-репозитории, изучите несовместимые изменения, обновите эту таблицу и PR потребителей и сохраняйте комментарии с версиями рядом с закреплёнными строками `uses:`.
2 changes: 2 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# 4FusionLab engineering instructions

[Русская версия](AGENTS.ru.md)

This repository holds reusable, **read-only** CI building blocks and organization-level defaults. Product-specific instructions belong in each product repository.

## Language and product documentation
Expand Down
36 changes: 36 additions & 0 deletions AGENTS.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# Инженерные инструкции 4FusionLab

[English](AGENTS.md)

Этот репозиторий содержит переиспользуемые компоненты CI **только для чтения** и общие настройки организации. Инструкции конкретного продукта находятся в его репозитории.

## Язык и документация продуктов

- При создании или изменении README продукта следуйте [правилам README](README_GUIDELINES.ru.md), включая соответствие языковых версий и проверку лицензии.
- Документы ведутся на английском; для документации поддерживаются отдельные русские версии. Промежуточные рабочие заметки переводить не требуется.
- Обсуждайте требования и планы на русском. Используйте английский для подписей интерфейса Autodesk Fusion, стабильных API-идентификаторов и публичных имён входов Actions.
- Сохраняйте раздельную документацию EN/RU, если у продукта уже есть обе версии. Не заменяйте незаметно ни один язык спойлерами или машинными заглушками.
- Соблюдайте существующие архитектуру продукта, условия UX, тесты и оговорки о совместимости CAD.

## Git, CI и выпуск

- Для изменений CI и публикации предпочитайте небольшой проверенный PR. Не используйте force-push и не изменяйте опубликованную историю. Сохраняйте возможность прямого push в main, где это разрешено настройками репозитория.
- Не создавайте теги релизов вручную. Push или объединение PR в `main` может опубликовать релиз **только при изменении поставляемых исполняемых файлов после последнего опубликованного Release**. Push только документации может восстановить ранее неудавшийся выпуск, но никогда не должен создавать релиз сам по себе. См. [`RELEASE_RECOVERY.ru.md`](RELEASE_RECOVERY.ru.md).
- Сохраняйте `.github/release-paths.txt` каждого репозитория как проверенный перечень путей, дающих право на релиз. Изменения только README, документации, тестов, workflow, политик и AGENTS.md не должны создавать GitHub Release.
- GitVersion.Tool закреплён за **6.8.2**. Требуется полная история Git. Опубликованные теги, релизы и загруженные артефакты неизменяемы; не переназначайте теги, не перезаписывайте артефакты и не переводите предварительный выпуск в Stable как понижение версии.
- Основные общие Actions находятся в `.github/actions/` и должны закрепляться потребителями за точным SHA коммита. Не используйте движущуюся ветку `main` в рабочих заданиях релиза.
- Закрепляйте официальные `actions/*` за точными проверенными SHA из [`ACTIONS_PINS.ru.md`](ACTIONS_PINS.ru.md). Перед обновлением сверяйте вышестоящие теги; не используйте плавающие теги основных версий в workflow продукта.
- `contents: write` требуется только заданиям публикации; тесты пакета, проверка метаданных и задания PR работают с минимальными правами чтения.
- Успешная автономная сборка или тест Python **не** подтверждает приёмку CAD в Autodesk Fusion. Сохраняйте свидетельства проверок на платформах и условия безопасности и совместимости.

## Качество

- Проверяйте общие Actions командой `python -m unittest discover -s .github/tests -v` и workflow проверок общей платформы релизов.
- Для изменения Actions сначала объедините проверенный PR платформы, затем переводите потребителей отдельными PR с успешным CI проекта. Не меняйте исполняемый код продукта в рамках миграции CI.
- Перед заменой команд упаковки продукта проверьте содержимое ZIP, версию манифеста, SHA-256, заметки и различия ОС для этого продукта.
- Никогда не размещайте в этом публичном репозитории учётные данные, секреты, личные CAD-файлы, машинные пути или проприетарные материалы.

## Совместимость

- Сохраняйте стабильные UUID манифестов Fusion, идентификаторы команд, названия продуктов, ресурсы платформ, метаданные поддерживаемых ОС и формат установки каждого репозитория.
- `AGENTS.md` на уровне проекта дополняет эти общие ожидания и остаётся основным источником для ограничений API, геометрии и UX конкретного проекта.
2 changes: 2 additions & 0 deletions RELEASE_PLATFORM.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Shared Release Platform

[Русская версия](RELEASE_PLATFORM.ru.md)

Central, reusable Actions for 4FusionLab repositories. Source: [4FusionLab/.github](https://github.com/4FusionLab/.github).

## Compatibility and rollout
Expand Down
Loading
Loading