fix: architectural improvements per Opus analysis

1. Version sync: provider/main.go = profile.env = 5.0.60
2. docs-generator: removed detectVersion() — no more dependency on provider/
3. docs-generator: removed detectRoot(), pickPath() — all paths via flags/env
4. docs-generator: require --version, --resources, --docs flags
5. Auto-rebuild: yaml-generator rebuilds if sources newer than binary
6. Three version vars → one VERSION in profile.env
7. Created TOOLS/lib/ — shared YAML contract types (not yet integrated)

TOOLS/lib/go.mod

@@ -0,0 +1,5 @@
+module lib
+
+go 1.24
+
+require gopkg.in/yaml.v3 v3.0.1

TOOLS/lib/types.go

@@ -0,0 +1,78 @@
+package lib
+// Package lib — общие типы YAML-контракта для всех генераторов.
+//
+// Это КАНОНИЧЕСКОЕ определение YAML-спеков. Все генераторы используют эти типы.
+// При добавлении нового поля в YAML — править ЗДЕСЬ, и компилятор найдёт
+// все места в генераторах, которые нужно обновить.
+package lib
+
+// ServiceSpec — полная YAML-спецификация сервиса.
+type ServiceSpec struct {
+	Name               string          `yaml:"name"`
+	ServiceID          int             `yaml:"service_id"`
+	ServiceDisplayName string          `yaml:"service_display_name,omitempty"`
+	ServiceShortName   string          `yaml:"service_short_name,omitempty"`
+	ServiceMan         string          `yaml:"service_man,omitempty"`
+	Lifecycle          Lifecycle       `yaml:"lifecycle"`
+	Outputs            OutputSection   `yaml:"outputs"`
+	Operations         []OperationSpec `yaml:"operations"`
+}
+
+// Lifecycle — настройки жизненного цикла.
+type Lifecycle struct {
+	SuspendOnDestroyDefault      bool `yaml:"suspend_on_destroy_default"`
+	AdoptExistingOnCreateDefault bool `yaml:"adopt_existing_on_create_default"`
+}
+
+// OutputSection — выходные параметры.
+type OutputSection struct {
+	Params []OutputParam `yaml:"params"`
+}
+
+// OutputParam — выходной параметр.
+type OutputParam struct {
+	Code      string `yaml:"code"`
+	Type      string `yaml:"type"`
+	Sensitive bool   `yaml:"sensitive,omitempty"`
+}
+
+// OperationSpec — операция сервиса.
+type OperationSpec struct {
+	Name        string      `yaml:"name"`
+	ID          int         `yaml:"id"`
+	Kind        string      `yaml:"kind"`
+	Action      string      `yaml:"action"`
+	Subresource string      `yaml:"subresource,omitempty"`
+	Man         string      `yaml:"man,omitempty"`
+	Params      []ParamSpec `yaml:"params"`
+}
+
+// ParamSpec — параметр операции.
+// Поля с тегом yaml — канонический контракт.
+// Поля без тега — специфичны для конкретного генератора (заполняются при обработке).
+type ParamSpec struct {
+	// === YAML-контракт (канонические поля) ===
+	ID        int         `yaml:"id"`
+	Code      string      `yaml:"code"`
+	DataType  string      `yaml:"data_type,omitempty"`
+	Type      string      `yaml:"type,omitempty"`
+	Required  bool        `yaml:"required"`
+	Default   interface{} `yaml:"default,omitempty"`
+	ValueList []string    `yaml:"value_list,omitempty"`
+	RefSvcID  *int        `yaml:"ref_svc_id,omitempty"`
+	Func      string      `yaml:"func,omitempty"`
+	Regex     string      `yaml:"regex,omitempty"`
+	Unique    string      `yaml:"unique_scope,omitempty"`
+	MaxLength *int        `yaml:"maxlength,omitempty"`
+	MinLength *int        `yaml:"minlength,omitempty"`
+	MaxValue  interface{} `yaml:"maxvalue,omitempty"`
+	MinValue  interface{} `yaml:"minvalue,omitempty"`
+	Descr     string      `yaml:"descr,omitempty"`
+	Man       string      `yaml:"man,omitempty"`
+	Sort      *int        `yaml:"sort,omitempty"`
+	DependsOn interface{} `yaml:"depends_on,omitempty"`
+
+	// === Генератор-специфичные поля (не сериализуются в YAML) ===
+	IsModifiable *bool `yaml:"is_modifiable,omitempty"`
+	IsSensitive  bool  `yaml:"is_sensitive,omitempty"`
+}