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
29 changes: 29 additions & 0 deletions .github/RELEASE_POLICY.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# 4FusionLab — политика автоматических релизов исполняемых компонентов

[English](RELEASE_POLICY.md)

## Запуск

- Прямой push в `main` или объединение PR в `main` — единственное обычное событие релиза. Проверки PR, ручной запуск CI и отправка тегов версий **не** запускают публикацию.
- Перед публикацией сравнивайте `GITHUB_SHA` с последним **опубликованным** тегом GitHub Release, являющимся предком `main`. Если ZIP-релизов нет, используйте исходный диапазон push `github.event.before..GITHUB_SHA`. Удалённые и переименованные исполняемые файлы по-прежнему дают право на релиз.
- `.github/release-paths.txt` репозитория остаётся проверенным перечнем путей релиза. Изменения только README, руководств, тестов и CI **сами по себе не создают релиз**. Push только документации может восстановить ранее неудавшийся выпуск, если подходящие изменения после последнего опубликованного тега ещё не выпущены.
- Перед публикацией должны пройти все обязательные существующие проверки 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-приёмке, тестам, подписанным архивам и контрольным суммам, совместимости ОС и публикации продолжают действовать.

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

Перечень исполняемых файлов: `filamentra/**`. После тестов Python публикуется версионированный ZIP исходников с контрольной суммой; это распространение кода, пока не установщик аддона Fusion.

Если после последнего опубликованного релиза не изменились подходящие входные исполняемые файлы, CI может запуститься, но публикация пропускается, даже если GitVersion вычислит другую версию. После сбоя следующая отправка в `main` повторяет публикацию после успешного прохождения обычных проверок CI; опубликованные теги и артефакты никогда не перезаписываются.

## Общие Actions релизов

Общие определение GitVersion, проверка исполняемых изменений, заметки и проверенные ZIP-релизы используют Actions `4FusionLab/.github`, закреплённые за коммитом `ad9d60ba4aabc494b4f2c85d6c566a50ca423751`. Репозиторий сохраняет независимо тестируемый сборщик исходников Filamentra на Python; ZIP не является готовым установщиком Autodesk Fusion. Дублирующие локальные помощники релизов удалены.

**Платформа восстановления:** классификатор опубликованных релизов отдельно закреплён за `2e961620a068c3ad754f6e1be05fb6e4ac68e843` с `recover-unpublished: 'true'` и `github.token` только для чтения. Остальные общие Actions сохраняют проверенное закрепление `ad9d60ba4aabc494b4f2c85d6c566a50ca423751`.
34 changes: 18 additions & 16 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,23 @@
# Разработка Filamentra
# Filamentra development

Filamentra — планируемый Fusion add-in для поиска филаментов и установки визуальных Appearances. Рабочие Python-модули существуют, но полного установочного аддона пока нет.
[Русская версия](AGENTS.ru.md)

## Общие правила 4FusionLab
Filamentra is a planned Fusion add-in for finding filaments and installing visual Appearances. Working Python modules exist, but a complete installable add-in does not yet exist.

- Общие стандарты: https://github.com/4FusionLab/.github/blob/main/AGENTS.md; модель общего CI: https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md.
- Общайся и составляй планы на русском, код и UI Fusion — на английском. Сохраняй независимые README.md и README.ru.md.
- Перед изменениями изучай текущие файлы и Git-статус. Conventional Commits; предпочтительно PR с успешными проверками, прямой push в main допускается.
- Не меняй UUID Fusion manifest, IDs команд, поддержку ОС и формат пакета без миграционного плана. Не коммить секреты, токены или личные CAD-файлы.
- Где есть runtime, релиз создаёт push или merge в main только для файлов из .github/release-paths.txt после успешного CI. GitVersion.Tool 6.8.2, неизменяемый автоматический тег и GitHub Release; теги вручную не создавай.
- Изменение docs, README, тестов, AGENTS.md или CI само по себе не должно выпускать релиз. Общие Actions подключай только по конкретному commit SHA.
- Unit-тесты и ZIP не заменяют нативную проверку Autodesk Fusion. Сохраняй существующие ограничения и доказательства совместимости.
## Shared 4FusionLab rules

## Правила реализации
- Shared standards: https://github.com/4FusionLab/.github/blob/main/AGENTS.md; shared CI model: https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md.
- Communicate and make plans in Russian; use English for code and Fusion UI. Retain separate README.md and README.ru.md.
- Inspect current files and Git status before changes. Use Conventional Commits; a PR with passing checks is preferred, and direct push to main is allowed.
- Do not change Fusion manifest UUIDs, command IDs, OS support or package format without a migration plan. Do not commit secrets, tokens or personal CAD files.
- Where runtime exists, a push or merge to main creates a release only for paths in .github/release-paths.txt after successful CI. Use GitVersion.Tool 6.8.2, an automatically created immutable tag and GitHub Release; do not create tags manually.
- Docs, README, tests, AGENTS.md or CI changes must not independently publish a release. Pin shared Actions only to a specific commit SHA.
- Unit tests and ZIPs do not replace native Autodesk Fusion validation. Preserve existing limitations and compatibility evidence.

- Сверяй реализованные возможности с README.md, README.ru.md и docs/ROADMAP.md. Не представляй задуманные UI, скачивание каталога или установку в Fusion как готовые функции.
- Основные модули: filamentra/appearance_mapping.py, filamentra/fusion_appearance.py и filamentra/texture_generator.py. Сохраняй детерминизм, provenance и границы реального Fusion API.
- Данные Filamentra-DataSource — визуальные приближения, а не сертифицированные механические или оптические параметры. Не изобретай производителей, SKU и оттенки.
- Сейчас релиз распространяет исходный ZIP Python-модулей и SHA-256, а не готовый Fusion installer. Изменение формата пакета требует отдельной проверки.
- Выполняй `python -m unittest discover -s tests -v`, `python scripts/build_release.py --version X.Y.Z` и проверку checksum. Нативную работу в Fusion утверждай только после отдельного CAD-теста.
## Implementation rules

- Verify implemented capabilities against README.md, README.ru.md and docs/ROADMAP.md. Do not present planned UI, catalog downloads or installation in Fusion as completed functionality.
- Main modules: filamentra/appearance_mapping.py, filamentra/fusion_appearance.py and filamentra/texture_generator.py. Preserve determinism, provenance and the boundaries of the actual Fusion API.
- Filamentra-DataSource data are visual approximations, not certified mechanical or optical parameters. Do not invent manufacturers, SKUs or shades.
- The release currently distributes a source ZIP of Python modules and SHA-256, not a finished Fusion installer. Changing the package format requires separate review.
- Run `python -m unittest discover -s tests -v`, `python scripts/build_release.py --version X.Y.Z` and checksum verification. Claim native Fusion behavior only after a separate CAD test.
23 changes: 23 additions & 0 deletions AGENTS.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# Разработка Filamentra

[English](AGENTS.md)

Filamentra — планируемый Fusion add-in для поиска филаментов и установки визуальных Appearances. Рабочие Python-модули существуют, но полного установочного аддона пока нет.

## Общие правила 4FusionLab

- Общие стандарты: https://github.com/4FusionLab/.github/blob/main/AGENTS.md; модель общего CI: https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md.
- Общайся и составляй планы на русском, код и UI Fusion — на английском. Сохраняй независимые README.md и README.ru.md.
- Перед изменениями изучай текущие файлы и Git-статус. Conventional Commits; предпочтительно PR с успешными проверками, прямой push в main допускается.
- Не меняй UUID Fusion manifest, IDs команд, поддержку ОС и формат пакета без миграционного плана. Не коммить секреты, токены или личные CAD-файлы.
- Где есть runtime, релиз создаёт push или merge в main только для файлов из .github/release-paths.txt после успешного CI. GitVersion.Tool 6.8.2, неизменяемый автоматический тег и GitHub Release; теги вручную не создавай.
- Изменение docs, README, тестов, AGENTS.md или CI само по себе не должно выпускать релиз. Общие Actions подключай только по конкретному commit SHA.
- Unit-тесты и ZIP не заменяют нативную проверку Autodesk Fusion. Сохраняй существующие ограничения и доказательства совместимости.

## Правила реализации

- Сверяй реализованные возможности с README.md, README.ru.md и docs/ROADMAP.md. Не представляй задуманные UI, скачивание каталога или установку в Fusion как готовые функции.
- Основные модули: filamentra/appearance_mapping.py, filamentra/fusion_appearance.py и filamentra/texture_generator.py. Сохраняй детерминизм, provenance и границы реального Fusion API.
- Данные Filamentra-DataSource — визуальные приближения, а не сертифицированные механические или оптические параметры. Не изобретай производителей, SKU и оттенки.
- Сейчас релиз распространяет исходный ZIP Python-модулей и SHA-256, а не готовый Fusion installer. Изменение формата пакета требует отдельной проверки.
- Выполняй `python -m unittest discover -s tests -v`, `python scripts/build_release.py --version X.Y.Z` и проверку checksum. Нативную работу в Fusion утверждай только после отдельного CAD-теста.
4 changes: 3 additions & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Contributing to Filamentra

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

Thanks for helping improve Filamentra, a planned filament appearance catalog for Autodesk Fusion from [4FusionLab](https://github.com/4FusionLab).

The project is in pre-development. Please open an [issue](https://github.com/4FusionLab/Filamentra/issues) to discuss significant technical changes or new catalog formats before implementing them.
Expand Down Expand Up @@ -46,6 +48,6 @@ For bugs, include Fusion version, operating system, exact steps, actual vs expec

## License and code contributions

A project license has not yet been selected. Public visibility alone does not grant reuse rights. Before submitting substantial code or assets, coordinate the intended licensing and contribution terms with the maintainers.
Filamentra is distributed under the [PolyForm Noncommercial License 1.0.0](LICENSE). Commercial use outside its permitted purposes requires a separate agreement with 4FusionLab; third-party components retain their own licenses. Before submitting substantial code or assets, coordinate their licensing and contribution terms with the maintainers.

Filamentra is independent of Autodesk and filament manufacturers.
Loading
Loading