Fix license headers and javadoc issues for CI compliance

Add Apache license headers to SPI service files and YAML config that were
missing them. Fix javadoc error (HTML entity for `>` in MALExpressionModel)
and add missing @throws tags in MALClassGenerator. Update DSL compiler
design doc to reflect LAL ExecutionContext refactoring.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: wu-sheng

docs/en/academy/dsl-compiler-design.md

@@ -42,7 +42,7 @@ Phase 3: Javassist Bytecode Generation
 | OAL | Extends metrics function class (e.g., `LongAvgMetrics`) | `id()`, `serialize()`, `deserialize()`, plus dispatcher `dispatch(source)` |
 | MAL metric | `MalExpression` | `SampleFamily run(Map<String, SampleFamily> samples)` |
 | MAL filter | `Predicate<Map<String, String>>` | `boolean test(Map<String, String> tags)` |
-| LAL | `LalExpression` | `void execute(FilterSpec filterSpec, Binding binding)` |
+| LAL | `LalExpression` | `void execute(FilterSpec filterSpec, ExecutionContext ctx)` |
 | Hierarchy | `BiFunction<Service, Service, Boolean>` | `Boolean apply(Service upper, Service lower)` |
 
 OAL is the most complex -- it generates **three classes per metric** (metrics class with storage annotations,
@@ -65,8 +65,9 @@ classes at build time; these are then used at runtime to parse DSL strings.
 
 Javassist compiles Java source strings into bytecode but has limitations that shape the code generation:
 
-- **No anonymous inner classes or lambdas** -- Callback-based APIs (e.g., LAL's `filterSpec.extractor(Consumer)`)
-  require pre-compiling each callback as a separate `CtClass` implementing the needed interface.
+- **No anonymous inner classes or lambdas** -- Callback-based APIs require workarounds.
+  LAL uses private methods called directly from `execute()` instead of Consumer callbacks.
+  OAL pre-compiles callbacks as separate `CtClass` instances where needed.
 - **No generics in method bodies** -- Generated source uses raw types with explicit casts.
 - **Class loading anchor** -- Each DSL uses a `PackageHolder` marker class so that
   `ctClass.toClass(PackageHolder.class)` loads the generated class into the correct module/package
@@ -151,19 +152,12 @@ The checker mechanism:
         For `increase()`/`rate()` expressions, the `CounterWindow` is primed with an initial run before
         comparing the second run's output.
    - **LAL**: Runtime execution comparison -- both v1 and v2 execute with mock LogData,
-     then compare Binding state (service, layer, tags, abort/save flags).
+     then compare execution state (service, layer, tags, abort/save flags).
+     For rules requiring extraLog (e.g., envoy-als), mock proto data is built from `.input.data` files
+     and the `LALSourceTypeProvider` SPI resolves the proto type per layer.
      Test scripts include both copies of production configs (`oap-cases/`) and
      dedicated feature-coverage rules (`feature-cases/`).
    - **Hierarchy**: Compare `BiFunction` evaluation with test Service pairs
 
 This ensures 100% behavioral parity. The Groovy v1 modules are **test-only dependencies** -- they are not
-included in the OAP distribution.
-
-#### Current Checker Results
-
-| Checker | Expressions Tested | Status |
-|---------|-------------------|--------|
-| MAL metric expressions | 1,187 | All pass (metadata + runtime execution) |
-| MAL filter expressions | 29 | All pass |
-| LAL scripts | 29 | All pass |
-| Hierarchy rules | 22 | All pass |
+included in the OAP distribution.

oap-server/analyzer/hierarchy/src/main/resources/META-INF/services/org.apache.skywalking.oap.server.core.config.HierarchyDefinitionService$HierarchyRuleProvider

@@ -1 +1,19 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+#
+
 org.apache.skywalking.oap.server.core.config.v2.compiler.CompiledHierarchyRuleProvider

oap-server/analyzer/log-analyzer/src/test/resources/META-INF/services/org.apache.skywalking.oap.log.analyzer.v2.spi.LALSourceTypeProvider

@@ -1 +1,19 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+#
+
 org.apache.skywalking.oap.log.analyzer.v2.compiler.TestMeshLALSourceTypeProvider

oap-server/analyzer/meter-analyzer/src/main/java/org/apache/skywalking/oap/meter/analyzer/v2/compiler/MALClassGenerator.java

@@ -208,6 +208,7 @@ private void addRunLocalVariableTable(final javassist.CtMethod method,
      * @param metricName the metric name (used in the generated class name)
      * @param expression the MAL expression string
      * @return a MalExpression instance
+     * @throws Exception if parsing or compilation fails
      */
     public MalExpression compile(final String metricName,
                                  final String expression) throws Exception {
@@ -228,6 +229,7 @@ public MalExpression compile(final String metricName,
      *
      * @param filterExpression e.g. {@code "{ tags -> tags.job_name == 'mysql-monitoring' }"}
      * @return a MalFilter instance
+     * @throws Exception if parsing or compilation fails
      */
     @SuppressWarnings("unchecked")
     public MalFilter compileFilter(final String filterExpression) throws Exception {
@@ -298,6 +300,11 @@ public MalFilter compileFilter(final String filterExpression) throws Exception {
 
     /**
      * Compiles from a pre-parsed AST model.
+     *
+     * @param metricName the metric name (used in the generated class name)
+     * @param ast the pre-parsed AST model
+     * @return a MalExpression instance
+     * @throws Exception if compilation fails
      */
     public MalExpression compileFromModel(final String metricName,
                                           final MALExpressionModel.Expr ast) throws Exception {

oap-server/analyzer/meter-analyzer/src/main/java/org/apache/skywalking/oap/meter/analyzer/v2/compiler/MALExpressionModel.java

@@ -28,7 +28,7 @@
  * <pre>
  *   metric_name.tagEqual("k","v").sum(["tag"]).rate("PT1M").service(["svc"], Layer.GENERAL)
  *   (metric1 + metric2) * 100
- *   metric.tag({tags -> tags.key = "val"}).histogram().histogram_percentile([50,75,90,95,99])
+ *   metric.tag({tags -&gt; tags.key = "val"}).histogram().histogram_percentile([50,75,90,95,99])
  * </pre>
  */
 public final class MALExpressionModel {

oap-server/server-receiver-plugin/envoy-metrics-receiver-plugin/src/main/resources/META-INF/services/org.apache.skywalking.oap.log.analyzer.v2.spi.LALSourceTypeProvider

@@ -1 +1,19 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+#
+
 org.apache.skywalking.oap.server.receiver.envoy.EnvoyHTTPLALSourceTypeProvider

test/script-cases/script-runtime-with-groovy/mal-lal-v1-v2-checker/src/test/resources/META-INF/services/org.apache.skywalking.oap.log.analyzer.v2.spi.LALSourceTypeProvider

@@ -1 +1,19 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+#
+
 org.apache.skywalking.oap.server.checker.lal.TestMeshLALSourceTypeProvider

test/script-cases/scripts/mal/test-otel-rules/service-gstring-regex-split.yaml

@@ -1,3 +1,18 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
 #  Metric Values
 #    0 = Not Satisfied
 #    1 = Satisfied