feat: Support Relative Path Imports

examples/tests/stacks/mixins/stage/test2.yaml

@@ -0,0 +1,8 @@
+# yaml-language-server: $schema=https://atmos.tools/schemas/atmos/atmos-manifest/1.0/atmos-manifest.json
+
+vars:
+  stage: test-2
+
+settings:
+  config:
+    is_prod: false

examples/tests/stacks/orgs/cp/tenant1/test2/_defaults.yaml

@@ -0,0 +1,5 @@
+# yaml-language-server: $schema=https://atmos.tools/schemas/atmos/atmos-manifest/1.0/atmos-manifest.json
+
+import:
+  - mixins/stage/test2
+  - ../_defaults # validate relative paths

examples/tests/stacks/orgs/cp/tenant1/test2/us-east-2.yaml

@@ -0,0 +1,5 @@
+# yaml-language-server: $schema=https://atmos.tools/schemas/atmos/atmos-manifest/1.0/atmos-manifest.json
+
+import:
+  - mixins/region/us-east-2
+  - ./_defaults # validate relative paths

examples/tests/stacks/orgs/cp/tenant1/test2/us-west-1.yaml

@@ -0,0 +1,5 @@
+# yaml-language-server: $schema=https://atmos.tools/schemas/atmos/atmos-manifest/1.0/atmos-manifest.json
+
+import:
+  - path: mixins/region/us-west-1
+  - path: ./_defaults # validate relative paths using the `path` field

internal/exec/stack_processor_utils.go

@@ -1744,10 +1744,10 @@ func FindComponentDependenciesLegacy(
 }
 
 // ProcessImportSection processes the `import` section in stack manifests
-// The `import` section` can be of the following types:
-// 1. list of `StackImport` structs
-// 2. list of strings
-// 3. List of strings and `StackImport` structs in the same file
+// The `import` section can contain:
+// 1. Project-relative paths (e.g. "mixins/region/us-east-2")
+// 2. Paths relative to the current file (starting with "./" or "../")
+// 3. StackImport structs containing either of the above path types
 func ProcessImportSection(stackMap map[string]any, filePath string) ([]schema.StackImport, error) {
 	stackImports, ok := stackMap[cfg.ImportSectionName]
 
@@ -1773,6 +1773,15 @@ func ProcessImportSection(stackMap map[string]any, filePath string) ([]schema.St
 		var importObj schema.StackImport
 		err := mapstructure.Decode(imp, &importObj)
 		if err == nil {
+			// Handle paths relative to current file (starting with ./ or ../)
+			if strings.HasPrefix(importObj.Path, "./") || strings.HasPrefix(importObj.Path, "../") {
+				// Get the directory of the current file
+				baseDir := filepath.Dir(filePath)
+				// Join the base directory with the relative path
+				importObj.Path = filepath.Join(baseDir, importObj.Path)
+				// Clean the path to resolve any .. segments
+				importObj.Path = filepath.Clean(importObj.Path)
+			}
 			result = append(result, importObj)
 			continue
 		}
@@ -1786,6 +1795,13 @@ func ProcessImportSection(stackMap map[string]any, filePath string) ([]schema.St
 			return nil, fmt.Errorf("invalid empty import in the file '%s'", filePath)
 		}
 
+		// Handle paths relative to current file (starting with ./ or ../)
+		if strings.HasPrefix(s, "./") || strings.HasPrefix(s, "../") {
+			baseDir := filepath.Dir(filePath)
+			s = filepath.Join(baseDir, s)
+			s = filepath.Clean(s)
+		}
+
 		result = append(result, schema.StackImport{Path: s})
 	}
 

pkg/stack/stack_processor_test.go

@@ -19,6 +19,8 @@ func TestStackProcessor(t *testing.T) {
 		"../../examples/tests/stacks/orgs/cp/tenant1/prod/us-east-2.yaml",
 		"../../examples/tests/stacks/orgs/cp/tenant1/staging/us-east-2.yaml",
 		"../../examples/tests/stacks/orgs/cp/tenant1/test1/us-east-2.yaml",
+		"../../examples/tests/stacks/orgs/cp/tenant1/test2/us-east-2.yaml",
+		"../../examples/tests/stacks/orgs/cp/tenant1/test2/us-west-1.yaml",
 	}
 
 	processStackDeps := true
@@ -50,15 +52,16 @@ func TestStackProcessor(t *testing.T) {
 	)
 
 	assert.Nil(t, err)
-	assert.Equal(t, 4, len(listResult))
-	assert.Equal(t, 4, len(mapResult))
+	assert.Equal(t, 6, len(listResult))
+	assert.Equal(t, 6, len(mapResult))
 
 	mapResultKeys := u.StringKeysFromMap(mapResult)
 	assert.Equal(t, "orgs/cp/tenant1/dev/us-east-2", mapResultKeys[0])
 	assert.Equal(t, "orgs/cp/tenant1/prod/us-east-2", mapResultKeys[1])
 	assert.Equal(t, "orgs/cp/tenant1/staging/us-east-2", mapResultKeys[2])
 	assert.Equal(t, "orgs/cp/tenant1/test1/us-east-2", mapResultKeys[3])
-
+	assert.Equal(t, "orgs/cp/tenant1/test2/us-east-2", mapResultKeys[4])
+	assert.Equal(t, "orgs/cp/tenant1/test2/us-west-1", mapResultKeys[5])
 	mapConfig1, err := u.UnmarshalYAML[schema.AtmosSectionMapType](listResult[0])
 	assert.Nil(t, err)