refactor(pkg/go)!: return validation findings as errors

docs/validation/model/README.md

@@ -21,31 +21,23 @@ OpenFGA model validation ensures that authorization models are syntactically cor
 |------------|------------|---------|---------------|
 | `schema-version-required` | Schema | Schema version must be specified | [schema-version-required.md](./schema-version-required.md) |
 | `schema-version-unsupported` | Schema | Unsupported schema version | [schema-version-unsupported.md](./schema-version-unsupported.md) |
-| `invalid-schema-version` | Schema | Invalid schema version format | [invalid-schema-version.md](./invalid-schema-version.md) |
+| `invalid-schema` | Schema | Unsupported or unrecognized schema version | [invalid-schema.md](./invalid-schema.md) |
 | `reserved-type-keywords` | Naming | Type name uses reserved keyword | [reserved-type-keywords.md](./reserved-type-keywords.md) |
 | `reserved-relation-keywords` | Naming | Relation name uses reserved keyword | [reserved-relation-keywords.md](./reserved-relation-keywords.md) |
-| `self-error` | Naming | Invalid use of 'self' or 'this' | [self-error.md](./self-error.md) |
 | `invalid-name` | Naming | Invalid type or relation name format | [invalid-name.md](./invalid-name.md) |
 | `duplicated-error` | Structure | Duplicate type or relation definition | [duplicated-error.md](./duplicated-error.md) |
 | `missing-definition` | Semantic | Referenced type or relation not defined | [missing-definition.md](./missing-definition.md) |
-| `undefined-type` | Semantic | Type is referenced but not defined | [undefined-type.md](./undefined-type.md) |
-| `undefined-relation` | Semantic | Relation is referenced but not defined | [undefined-relation.md](./undefined-relation.md) |
 | `invalid-relation-type` | Semantic | Invalid relation type in reference | [invalid-relation-type.md](./invalid-relation-type.md) |
 | `invalid-type` | Semantic | Invalid type in relation definition | [invalid-type.md](./invalid-type.md) |
 | `relation-no-entry-point` | Semantic | Relation has no entry point for assignment | [relation-no-entry-point.md](./relation-no-entry-point.md) |
-| `cyclic-error` | Semantic | Circular dependency in relations | [cyclic-error.md](./cyclic-error.md) |
-| `cyclic-relation` | Semantic | Circular relation dependency detected | [cyclic-relation.md](./cyclic-relation.md) |
 | `invalid-relation-on-tupleset` | Structure | Invalid relation in tuple-to-userset | [invalid-relation-on-tupleset.md](./invalid-relation-on-tupleset.md) |
 | `tupleuserset-not-direct` | Structure | Tuple-to-userset must have direct assignment | [tupleuserset-not-direct.md](./tupleuserset-not-direct.md) |
-| `invalid-wildcard-error` | Wildcard | Invalid wildcard usage in relation | [invalid-wildcard-error.md](./invalid-wildcard-error.md) |
 | `assignable-relation-must-have-type` | Wildcard | Assignable relation must specify type | [assignable-relation-must-have-type.md](./assignable-relation-must-have-type.md) |
 | `type-wildcard-relation` | Wildcard | Type restriction cannot have wildcard and relation | [type-wildcard-relation.md](./type-wildcard-relation.md) |
 | `condition-not-defined` | Condition | Referenced condition is not defined | [condition-not-defined.md](./condition-not-defined.md) |
 | `condition-not-used` | Condition | Defined condition is never used | [condition-not-used.md](./condition-not-used.md) |
 | `different-nested-condition-name` | Condition | Condition name mismatch in nested structure | [different-nested-condition-name.md](./different-nested-condition-name.md) |
 | `multiple-modules-in-file` | Multi-file | Multiple modules detected in single file | [multiple-modules-in-file.md](./multiple-modules-in-file.md) |
-| `invalid-schema` | Schema | Invalid schema structure | [invalid-schema.md](./invalid-schema.md) |
-| `invalid-syntax` | Syntax | Invalid DSL syntax | [invalid-syntax.md](./invalid-syntax.md) |
 
 ## Usage
 

docs/validation/model/TROUBLESHOOTING_GUIDE.md

@@ -9,42 +9,37 @@ This guide provides quick solutions to common OpenFGA validation errors. For det
 | Error | Quick Fix | Link |
 |-------|-----------|------|
 | `schema-version-required` | Add `schema 1.1` after `model` | [Details](./schema-version-required.md) |
-| `undefined-relation` | Define the missing relation or fix typo | [Details](./undefined-relation.md) |
-| `undefined-type` | Define the missing type or fix typo | [Details](./undefined-type.md) |
+| `missing-definition` | Define the missing relation or fix typo | [Details](./missing-definition.md) |
+| `invalid-type` | Define the missing type or fix typo | [Details](./invalid-type.md) |
 | `invalid-name` | Use lowercase with underscores only | [Details](./invalid-name.md) |
 | `duplicated-error` | Remove or rename duplicate definitions | [Details](./duplicated-error.md) |
 
 ### Schema and Structure Issues
 
 | Error | Quick Fix                                    | Link |
 |-------|----------------------------------------------|------|
-| `invalid-syntax` | Check indentation and keyword spelling       | [Details](./invalid-syntax.md) |
-| `invalid-schema` | Ensure proper `model` and `schema` structure | [Details](./invalid-schema.md) |
+| `invalid-schema` | Declare a recognized version (`1.1` or `1.2`) | [Details](./invalid-schema.md) |
 | `schema-version-unsupported` | Use supported version (`1.1` or `1.2`)           | [Details](./schema-version-unsupported.md) |
-| `invalid-schema-version` | Use format `X.Y` (e.g., `1.1`)               | [Details](./invalid-schema-version.md) |
 
 ### Relationship and Reference Errors
 
 | Error | Quick Fix | Link |
 |-------|-----------|------|
 | `relation-no-entry-point` | Add `[user]` or direct assignment | [Details](./relation-no-entry-point.md) |
-| `cyclic-relation` | Break circular references | [Details](./cyclic-relation.md) |
 | `invalid-relation-type` | Fix `type#relation` syntax | [Details](./invalid-relation-type.md) |
 | `tupleuserset-not-direct` | Add direct assignment to tupleset relation | [Details](./tupleuserset-not-direct.md) |
 
 ### Naming and Keyword Issues
 
 | Error | Quick Fix | Link |
 |-------|-----------|------|
-| `self-error` | Don't use `self` or `this` as names | [Details](./self-error.md) |
 | `reserved-type-keywords` | Use different type names | [Details](./reserved-type-keywords.md) |
 | `reserved-relation-keywords` | Use different relation names | [Details](./reserved-relation-keywords.md) |
 
 ### Wildcard and Advanced Features
 
 | Error | Quick Fix | Link |
 |-------|-----------|------|
-| `invalid-wildcard-error` | Use correct `[type:*]` syntax | [Details](./invalid-wildcard-error.md) |
 | `type-wildcard-relation` | Don't mix wildcard with relation | [Details](./type-wildcard-relation.md) |
 
 ### 🎯 Condition Errors

docs/validation/model/assignable-relation-must-have-type.md

@@ -143,9 +143,8 @@ type document
 
 ## Related Errors
 
-- [`invalid-wildcard-error`](./invalid-wildcard-error.md) - General wildcard usage issues
 - [`type-wildcard-relation`](./type-wildcard-relation.md) - Conflicting wildcard and relation usage
-- [`undefined-type`](./undefined-type.md) - When referenced types don't exist
+- [`invalid-type`](./invalid-type.md) - When referenced types don't exist
 
 ## Implementation Notes
 

docs/validation/model/condition-not-defined.md

@@ -130,7 +130,7 @@ condition is_weekday(current_time: timestamp) {
 
 - [`condition-not-used`](./condition-not-used.md) - When conditions are defined but never used
 - [`different-nested-condition-name`](./different-nested-condition-name.md) - Condition name mismatches
-- [`undefined-relation`](./undefined-relation.md) - Similar pattern for relation references
+- [`missing-definition`](./missing-definition.md) - Similar pattern for relation references
 
 ## Implementation Notes