Agent/stabilize foundation

.github/upgrades/scenarios/cppbuildtoolsupgrade/assessment.md

@@ -0,0 +1,40 @@
+# Assessment — CppBuildToolsUpgrade
+
+Дата: 2026-07-23
+
+## Краткое резюме
+В ходе полной перестройки (rebuild) решения найдено 2 ошибки и 0 предупреждений в 1 проекте. Ошибки относятся к сборке проекта Absolute-Compiler и связаны с неразрешёнными внешними ссылками (linker unresolved externals). Эти ошибки будут считаться "in-scope" для дальнейшего расследования, так как они появились после пересборки с обновлёнными средствами сборки и блокируют успешную компоновку исполняемого файла.
+
+## Полный список проблем (из отчёта сборки)
+- Solution: F:\Documents\Absolute\Absolute.sln
+
+- Project: F:\Documents\Absolute\Absolute-Compiler\Absolute-Compiler.vcxproj
+  - Build order: 3
+  - Platform Toolset: v145
+  - Windows Target Platform Version: 10.0
+  - Error 1 (linker): LNK2019
+	- Сообщение: ссылка на неразрешенный внешний символ "public: static void __cdecl Absolute::PackageManager::SaveLockfile(struct Absolute::PackageLockfile const &,class std::filesystem::path const &)" (?SaveLockfile@PackageManager@Absolute@@SAXAEBUPackageLockfile@2@AEBVpath@filesystem@std@@@Z) в функции `anonymous namespace`::LoadCompilation
+	- Триггер (входной артефакт): F:\Documents\Absolute\x64\Debug\absolutec.exe (компоновка)
+  - Error 2 (linker): LNK1120
+	- Сообщение: неразрешенных внешних элементов: 4
+	- Триггер: F:\Documents\Absolute\x64\Debug\absolutec.exe
+
+## Классификация
+- In-scope (будем исправлять в рамках этого сценария):
+  - Все перечисленные выше ошибки LNK2019 / LNK1120 в проекте Absolute-Compiler (F:\Documents\Absolute\Absolute-Compiler\Absolute-Compiler.vcxproj). Они блокируют сборку и требуют анализа линковки/определений символов, настроек проектов и порядка сборки.
+
+- Out-of-scope:
+  - На данном этапе нет явных предварительно существовавших проблем, подтверждённых историей сборок. Если при последующем расследовании обнаружится, что данные ошибки были до апгрейда toolset, мы пометим их как out-of-scope и скорректируем план.
+
+## Предварительный анализ (что проверять в планировании)
+- Проверить, где определён Absolute::PackageManager::SaveLockfile (файл/компонент) — возможно реализация в другом проекте/файле не линкуется.
+- Проверить, что все требуемые библиотеки/объектные файлы (parser.lib, analyzer.lib и т.д.) действительно создаются и находятся в Linker's LIBPATH (F:\Documents\Absolute\x64\Debug).
+- Проверить порядок сборки (build order) и зависимости между проектами в решении.
+- Проверить изменения в настройках линковщика или платформенного toolset (v145) которые могли повлиять на видимость символов (C++ name mangling, inline, /WHOLEARCHIVE, статические члены и т.д.).
+
+## Рекомендация по следующему шагу
+Перейти к Stage 2: Planning — углублённое расследование каждой неразрешённой ссылки (точные определения файлов, где символы реализованы, и почему они не попадают в линковку). В этом этапе я подготовлю plan.md и набор задач (unload+edit .vcxproj при необходимости, правки кода или настроек линковщика, повторная сборка) и предложу варианты исправления.
+
+---
+
+Создано автоматически агентом. Следующий шаг: планирование и составление задач. В режиме Automatic я начну Planning автоматически — если вы хотите приостановить и проверить assessment прежде чем планировать, ответьте "pause".

.github/upgrades/scenarios/cppbuildtoolsupgrade/plan.md

@@ -0,0 +1,38 @@
+# Plan — CppBuildToolsUpgrade
+
+Дата: 2026-07-23
+
+## Цель
+Устранить текущие ошибки линковки в проекте Absolute-Compiler после обновления средств сборки и подтвердить успешную сборку решения.
+
+## Подход
+1. Провести детальное расследование причин неразрешённых внешних ссылок (SaveLockfile и другие) — найти определения, проверить, входят ли соответствующие исходники в проект/библиотеки и корректно ли настроена линковка.
+2. Исправить проектные настройки (.vcxproj) или добавить отсутствующие ссылки/файлы исходников, при необходимости отредактировать код для совместимости с новым toolset.
+3. Выполнять инкрементальные сборки после каждого исправления; после успешного прохождения всех задач — выполнить финальную полную перестройку.
+
+## Предложенные варианты (если потребуется)
+- Быстрое исправление: добавить недостающие исходники или проектные зависимости в Absolute-Compiler (низкий риск, быстрый результат).
+- Консервативное исправление: восстановить/обновить внешний компонент (analyzer/lib) и явно подключить его корректную сборку в решении (средний риск, требует больше времени).
+- Переходной подход: временно обойти вызовы отсутствующих API (если допустимо) и запланировать восстановление API в отдельной задаче (высокий риск изменения логики).
+
+## Задачи (в порядке выполнения)
+1. Investigate: Нахождение определений символов и точек вызова
+   - Что сделать: найти реализации символов (например, SaveLockfile) и места их использования; собрать полный список файлов/проектов которые должны предоставлять эти символы.
+   - Артефакты: findings.md (в tasks/*/progress-details.md)
+2. Inspect .vcxproj: Проверить Absolute-Compiler.vcxproj
+   - Что сделать: убедиться что package_manager.cpp и прочие необходимые файлы включены в проект; проверить ProjectReferences и Linker -> Additional Dependencies.
+   - Артефакты: project-inspection.md
+3. Fix project configuration или код
+   - Что сделать: если файлы отсутствуют — добавить их; если требуется — исправить порядок ссылок или дополнительные зависимости; при необходимости внести минимальные правки кода для согласования сигнатур.
+   - Артефакты: изменения в .vcxproj и/или исходниках, commit-ready patch
+4. Rebuild incremental: Запустить cppupgrade_build_and_get_issues и верифицировать исчезновение связанных ошибок
+   - Что сделать: инкрементальная сборка проекта/решения, анализ результата
+5. Final rebuild: Выполнить cppupgrade_rebuild_and_get_issues и подтвердить отсутствие ошибок/предупреждений
+
+## Риски и замечания
+- Возможны зависимости на внешние/третьесторонние библиотеки — в таком случае потребуется обновление субмодулей или согласование с авторами библиотек.
+- Если определение символов лежит в другом проекте, возможно потребуется отредактировать ProjectReference, а это затронет порядок сборки.
+
+---
+
+Далее мне нужно ваше подтверждение для перехода к Stage 3 (Execution). Ответьте `approve` чтобы я начал выполнять задачи по плану, или `change` чтобы внести правки в план.

.github/upgrades/scenarios/cppbuildtoolsupgrade/scenario-instructions.md

@@ -0,0 +1,14 @@
+# CppBuildToolsUpgrade
+
+## Preferences
+- **Flow Mode**: Automatic
+
+## Source Control
+- **Source Branch**: agent/stabilize-foundation
+- **Working Branch**: agent/stabilize-foundation (use current branch as requested by user)
+- **Commit Strategy**: After Each Task
+- **Branch Sync**: Auto (Merge)
+
+## Notes
+- User requested to use the current branch for work.
+- All changes will be made on the working branch as configured above unless otherwise instructed.

.github/upgrades/scenarios/cppbuildtoolsupgrade/scenario.json

@@ -0,0 +1,17 @@
+{
+  "scenarioId": "CppBuildToolsUpgrade",
+  "operationId": "7cd9b339-41e8-44f5-a800-a58ae464fb78",
+  "description": "Upgrade MSVC (C\u002B\u002B) Build Tools to the latest version and/or resolve C/C\u002B\u002B build issues.",
+  "startTime": "2026-07-23T10:08:02.0429529Z",
+  "lastUpdateTime": "2026-07-23T11:39:11.706318Z",
+  "properties": {
+    "taskStates": {
+      "01-investigate": "Completed",
+      "02-inspect-vcxproj": "Completed",
+      "03-fix-project-configuration": "Completed",
+      "04-rebuild-incremental": "Completed",
+      "05-final-rebuild": "Completed"
+    }
+  },
+  "folderPath": ""
+}

.github/upgrades/scenarios/cppbuildtoolsupgrade/tasks.md

@@ -0,0 +1,9 @@
+# Tasks — CppBuildToolsUpgrade
+
+1. Investigate (pending)
+2. Inspect .vcxproj (pending)
+3. Fix project configuration или код (pending)
+4. Rebuild incremental (pending)
+5. Final rebuild (pending)
+
+Status: Not started

.github/upgrades/scenarios/cppbuildtoolsupgrade/tasks/01-investigate/progress-details.md

@@ -0,0 +1,17 @@
+# Progress Details — 01-investigate
+
+## Files Modified
+- F:\Documents\Absolute\Absolute-Compiler\Absolute-Compiler.vcxproj — добавлен src\package_manager.cpp в список компилируемых исходников проекта.
+
+## Build Result
+- Инкрементальная сборка (cppupgrade_build_and_get_issues) выполнена успешно.
+- Ошибки: 0
+- Предупреждения: 0
+- Сборка: решения прошла успешно
+
+## Что сделано
+- Исследована причина LNK2019 (PackageManager::SaveLockfile) — обнаружено, что реализация находится в src\package_manager.cpp, но файл не был включён в проект Absolute-Compiler.vcxproj.
+- Добавил запись <ClCompile Include="src\\package_manager.cpp" /> в проектный файл и выполнил инкрементальную сборку.
+
+## Замечания
+- После правки и сборки исходные ошибки линковки исчезли. Следующий шаг — продолжить выполнение оставшихся задач плана (Inspect .vcxproj/Fix project configuration или код/Final rebuild) автоматически.

.github/upgrades/scenarios/cppbuildtoolsupgrade/tasks/01-investigate/task.md

@@ -0,0 +1,4 @@
+# 01-investigate: Investigate: Нахождение определений символов и точек вызова
+
+   - Что сделать: найти реализации символов (например, SaveLockfile) и места их использования; собрать полный список файлов/проектов которые должны предоставлять эти символы.
+   - Артефакты: findings.md (в tasks/*/progress-details.md)

.github/upgrades/scenarios/cppbuildtoolsupgrade/tasks/02-inspect-vcxproj/progress-details.md

@@ -0,0 +1,27 @@
+# Progress Details — 02-inspect-vcxproj
+
+## Исходные файлы и проекты
+- Проект проверен: F:\Documents\Absolute\Absolute-Compiler\Absolute-Compiler.vcxproj
+- Сопутствующие проекты: F:\Documents\Absolute\Absolute-Analyzer\Absolute-Analyzer.vcxproj, F:\Documents\Absolute\Absolute-Parser\Absolute-Parser.vcxproj
+
+## Что проверено
+- Наличие реализации и включение в проект: src\package_manager.cpp включён в Absolute-Compiler.vcxproj (см. ранее внесённое изменение).
+- ProjectReferences: в Absolute-Compiler.vcxproj явных <ProjectReference> не найдено (проект линкуется на parser.lib и analyzer.lib через AdditionalDependencies).
+- Linker -> AdditionalDependencies: в Absolute-Compiler.vcxproj указаны parser.lib;analyzer.lib;%(AdditionalDependencies) — корректно.
+- AdditionalLibraryDirectories: используется $(SolutionDIr)$(Platform)\$(Configuration) (в других проектах аналогично). Замечание: в файлах встречается запись $(SolutionDIr) с заглавной буквой I — MSBuild имена свойств нечувствительны к регистру, поэтому это не должно быть проблемой.
+
+## Поведение сборки библиотек
+- Absolute-Parser и Absolute-Analyzer имеют <ConfigurationType>StaticLibrary и TargetName = parser / analyzer соответственно.
+- Для конфигурации x64|Debug у них задан OutDir = $(SolutionDir)$(Platform)\$(Configuration) — это соответствует месту, откуда Absolute-Compiler ожидает найти parser.lib и analyzer.lib.
+
+## Вывод
+- Порядок сборки и места вывода библиотек соответствуют настройкам линковки Absolute-Compiler. Не требуется добавлять ProjectReference; текущая схема с генерацией .lib и использованием AdditionalLibraryDirectories корректна.
+- После включения src\package_manager.cpp в Absolute-Compiler и инкрементальной сборки ошибки линковки устранились.
+
+## Дальнейшие шаги
+- Никаких дополнительных изменений в .vcxproj на данном этапе не требуется.
+- Перейти к следующей задаче: Fix project configuration или код (если появятся новые проблемы) и затем Final rebuild.
+
+---
+
+Автоматически сгенерировано агентом.

.github/upgrades/scenarios/cppbuildtoolsupgrade/tasks/02-inspect-vcxproj/task.md

@@ -0,0 +1,4 @@
+# 02-inspect-vcxproj: Inspect .vcxproj: Проверить Absolute-Compiler.vcxproj
+
+   - Что сделать: убедиться что package_manager.cpp и прочие необходимые файлы включены в проект; проверить ProjectReferences и Linker -> Additional Dependencies.
+   - Артефакты: project-inspection.md

.github/upgrades/scenarios/cppbuildtoolsupgrade/tasks/03-fix-project-configuration/progress-details.md

@@ -0,0 +1,15 @@
+# Progress Details — 03-fix-project-configuration
+
+## Что сделано
+- Проверена необходимость правок в проектной конфигурации для Absolute-Compiler.
+- Нужные исходники (src\package_manager.cpp) уже добавлены в проект на предыдущем шаге.
+- Явных дополнительных изменений в .vcxproj не потребовалось.
+
+## Build Result
+- Инкрементальная сборка выполнена успешно (см. итог ниже).
+- Errors: 0
+- Warnings: 0
+
+## Вывод
+- Конфигурация проекта корректна для текущего toolset v145.
+- Готов перейти к шагу 04 — инкрементальная сборка/проверка и затем к финальной перестройке.

.github/upgrades/scenarios/cppbuildtoolsupgrade/tasks/03-fix-project-configuration/task.md

@@ -0,0 +1,4 @@
+# 03-fix-project-configuration: Fix project configuration или код
+
+   - Что сделать: если файлы отсутствуют — добавить их; если требуется — исправить порядок ссылок или дополнительные зависимости; при необходимости внести минимальные правки кода для согласования сигнатур.
+   - Артефакты: изменения в .vcxproj и/или исходниках, commit-ready patch

.github/upgrades/scenarios/cppbuildtoolsupgrade/tasks/04-rebuild-incremental/progress-details.md

@@ -0,0 +1,13 @@
+# Progress Details — 04-rebuild-incremental
+
+## Что сделано
+- Выполнена инкрементальная сборка решения через cppupgrade_build_and_get_issues для проверки отсутствия регрессий после внесённых изменений.
+
+## Build Result
+- Errors: 0
+- Warnings: 0
+- Сборка: успешна
+
+## Вывод
+- Все предыдущие ошибки устранены, проект и зависимые библиотеки компилируются и линкуются корректно.
+- Готов выполнить финальную полную перестройку (Stage 5).

.github/upgrades/scenarios/cppbuildtoolsupgrade/tasks/04-rebuild-incremental/task.md

@@ -0,0 +1,3 @@
+# 04-rebuild-incremental: Rebuild incremental: Запустить cppupgrade_build_and_get_issues и верифицировать исчезновение связанных ошибок
+
+   - Что сделать: инкрементальная сборка проекта/решения, анализ результата

.github/upgrades/scenarios/cppbuildtoolsupgrade/tasks/05-final-rebuild/progress-details.md

@@ -0,0 +1,15 @@
+# Progress Details — 05-final-rebuild
+
+## Что сделано
+- Выполнена полная перестройка решения через cppupgrade_rebuild_and_get_issues для подтверждения отсутствия ошибок и предупреждений после внесённых изменений.
+
+## Build Result
+- Errors: 0
+- Warnings: 0
+- Сборка: успешна
+
+## Вывод
+- Все проблемы сборки, выявленные на этапе Assessment, устранены.
+- Рекомендуется создать коммит с изменениям в проектных файлах и артефактах сценария (если стратегия коммитов — After Each Task).
+
+Автоматически сгенерировано агентом.

.github/upgrades/scenarios/cppbuildtoolsupgrade/tasks/05-final-rebuild/task.md

@@ -0,0 +1,3 @@
+# 05-final-rebuild: Final rebuild: Выполнить cppupgrade_rebuild_and_get_issues и подтвердить отсутствие ошибок/предупреждений
+
+Execute task 05-final-rebuild.