ccx-migration-289

I'll start by searching for the relevant files using Sourcegraph MCP tools. Let me first load the tools and then run parallel searches for all the key classes mentioned in the task.

{"matches": ["mcp__sourcegraph__sg_keyword_search", "mcp__sourcegraph__sg_read_file", "mcp__sourcegraph__sg_list_files", "mcp__sourcegraph__sg_nls_search"], "query": "select:mcp__sourcegraph__sg_keyword_search,mcp__sourcegraph__sg_read_file,mcp__sourcegraph__sg_list_files,mcp__sourcegraph__sg_nls_search", "total_deferred_tools": 33}

Now let me run parallel searches for all the key classes mentioned in the task.

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/net/starlark/java/eval/StarlarkThread.java\n46:  */\n47: public final class StarlarkThread {\n48: \n49: \n431: \n432:   private StarlarkThread(\n433:       Mutability mu,\n434: \n28: /**\n29:  * An StarlarkThread represents a Starlark thread.\n30:  *\n31: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/analysis/RuleContext.java\n185:    */\n186:   private final StarlarkThread starlarkThread;\n187: \n188: \n977: \n978:   private StarlarkThread createStarlarkThread(Mutability mutability) {\n979:     AnalysisEnvironment env = getAnalysisEnvironment();\n980:     StarlarkThread thread =\n981:         StarlarkThread.create(\n982:             mutability, env.getStarlarkSemantics(), getLabel().toString(), getSymbolGenerator());\n983: \n987: \n988:   public StarlarkThread getStarlarkThread() {\n989:     return starlarkThread;\n990:   }\n991: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/profiler/memory/AllocationTracker.java\n51: \n52:   // A mapping from Java thread to StarlarkThread.\n53:   // Used to effect a hidden StarlarkThread parameter to sampleAllocation.\n54:   // TODO(adonovan): opt: merge the three different ThreadLocals in use here.\n55:   private final ThreadLocal<StarlarkThread> starlarkThread = new ThreadLocal<>();\n56: \n57: \n43: import net.starlark.java.eval.StarlarkCallable;\n44: import net.starlark.java.eval.StarlarkThread;\n45: import net.starlark.java.syntax.Location;\n46: \n57:   @Override\n58:   public void onPushFirst(StarlarkThread thread) {\n59:     starlarkThread.set(thread);\n60:   }\n61: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/cmdline/StarlarkThreadContext.java\n34:  */\...

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/PackageFactory.java\n79:  */\n80: public final class PackageFactory {\n81:   private static final GoogleLogger logger = GoogleLogger.forEnclosingClass();\n82: \n143:   // so WorkspaceFactory can add an extra top-level builtin.\n144:   public PackageFactory(\n145:       RuleClassProvider ruleClassProvider,\n146: \n76:  *\n77:  * <p>A PackageFactory is a heavy-weight object; create them sparingly. Typically only one is needed\n78:  * per client application.\n79: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/runtime/BlazeRuntime.java\n167: \n168:   private final PackageFactory packageFactory;\n169:   private final ConfiguredRuleClassProvider ruleClassProvider;\n170: \n546:   /** Returns the package factory. */\n547:   public PackageFactory getPackageFactory() {\n548:     return packageFactory;\n549:   }\n550: \n58: import com.google.devtools.build.lib.packages.Package.Builder.PackageSettings;\n59: import com.google.devtools.build.lib.packages.PackageFactory;\n60: import com.google.devtools.build.lib.packages.PackageLoadingListener;\n61: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/skyframe/PackageFunction.java\n105: \n106:   protected final PackageFactory packageFactory;\n107:   protected final CachingPackageLocator packageLocator;\n108: \n1304:   public static final class Builder {\n1305:     @Nullable private PackageFactory packageFactory;\n1306:     @Nullable private CachingPackageLocator pkgLocator;\n1307: \n1319:     @CanIgnoreReturnValue\n1320:     public Builder setPackageFactory(PackageFactory packageFactory) {\n1321:       this.packageFactory = packageFactory;\n1322:       return this;\n13...

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/skyframe/BzlLoadFunction.java\n107:  */\n108: public class BzlLoadFunction implements SkyFunction {\n109: \n110: \n128: \n129:   private BzlLoadFunction(\n130:       RuleClassProvider ruleClassProvider,\n131: \n1693: \n1694:   private static final class BzlLoadFunctionException extends SkyFunctionException {\n1695:     private BzlLoadFunctionException(BzlLoadFailedException cause) {\n1696:       super(cause, cause.getTransience());\n1697: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/skyframe/SkyframeExecutor.java\n885: \n886:   protected SkyFunction newBzlLoadFunction(RuleClassProvider ruleClassProvider) {\n887:     return BzlLoadFunction.create(\n888:         ruleClassProvider, directories, getDigestFunction().getHashFunction(), bzlCompileCache);\n889: \n881:   @Nullable\n882:   protected BzlLoadFunction getBzlLoadFunctionForInliningPackageAndWorkspaceNodes() {\n883:     return null;\n884: \n369:   // Cache of parsed bzl files, for use when we're inlining BzlCompileFunction in\n370:   // BzlLoadFunction. See the comments in BzlLoadFunction for motivations and details.\n371:   private final Cache<BzlCompileValue.Key, BzlCompileValue> bzlCompileCache =\n372: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/skyframe/PackageFunction.java\n112:   // Not final only for testing.\n113:   @Nullable private BzlLoadFunction bzlLoadFunctionForInlining;\n114: \n115: \n1308:     private AtomicInteger numPackagesSuccessfullyLoaded = new AtomicInteger(0);\n1309:     @Nullable private BzlLoadFunction bzlLoadFunctionForInlining;\n1310:     @Nullable private PackageProgressReceiver packageProgress;\n1311: \n196: \n197:   pub...

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/WorkspaceGlobals.java\n108:     // Add to the package definition for later.\n109:     Package.Builder builder =\n110:         Package.Builder.fromOrFailAllowWorkspaceOnly(thread, \"register_execution_platforms()\");\n111:     List<String> patterns = Sequence.cast(platformLabels, String.class, \"platform_labels\");\n112: \n118:     // Add to the package definition for later.\n119:     Package.Builder builder =\n120:         Package.Builder.fromOrFailAllowWorkspaceOnly(thread, \"register_toolchains()\");\n121:     List<String> patterns = Sequence.cast(toolchainLabels, String.class, \"toolchain_labels\");\n122: \n156:     try {\n157:       Package.Builder builder = Package.Builder.fromOrFailAllowWorkspaceOnly(thread, \"bind()\");\n158:       RuleClass ruleClass = ruleClassMap.get(\"bind\");\n159: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/PackageCallable.java\n51:       throws EvalException {\n52:     Package.Builder pkgBuilder = Package.Builder.fromOrFailAllowBuildOnly(thread, \"package()\");\n53:     if (pkgBuilder.isPackageFunctionUsed()) {\n54: \n76:   protected void processParam(\n77:       String name, Object rawValue, Package.Builder pkgBuilder, PackageArgs.Builder pkgArgsBuilder)\n78:       throws EvalException {\n79: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/BuildGlobals.java\n117:       throws EvalException {\n118:     Package.Builder pkgBuilder = Package.Builder.fromOrFailAllowBuildOnly(thread, \"licenses()\");\n119:     try {\n120: \n76:       throws EvalException {\n77:     Package.Builder pkgBuilder =\n78:         Package.Builder.fromOrFailAllowBuildOnly(thread...

Good results. Now let me search for the `rule()` and `macro()` builtin implementations, and explore the packages directory more thoroughly.

{"text":"No results.\n\nNo results found."}

{"text":"No results.\n\nNo results found."}

{"text":"src/main/java/com/google/devtools/build/lib/packages/metrics/\nsrc/main/java/com/google/devtools/build/lib/packages/producers/\nsrc/main/java/com/google/devtools/build/lib/packages/semantics/\nsrc/main/java/com/google/devtools/build/lib/packages/AbstractAttributeMapper.java\nsrc/main/java/com/google/devtools/build/lib/packages/AdvertisedProviderSet.java\nsrc/main/java/com/google/devtools/build/lib/packages/AggregatingAttributeMapper.java\nsrc/main/java/com/google/devtools/build/lib/packages/AllowlistChecker.java\nsrc/main/java/com/google/devtools/build/lib/packages/Aspect.java\nsrc/main/java/com/google/devtools/build/lib/packages/AspectClass.java\nsrc/main/java/com/google/devtools/build/lib/packages/AspectDefinition.java\nsrc/main/java/com/google/devtools/build/lib/packages/AspectDescriptor.java\nsrc/main/java/com/google/devtools/build/lib/packages/AspectParameters.java\nsrc/main/java/com/google/devtools/build/lib/packages/AspectsList.java\nsrc/main/java/com/google/devtools/build/lib/packages/Attribute.java\nsrc/main/java/com/google/devtools/build/lib/packages/AttributeFormatter.java\nsrc/main/java/com/google/devtools/build/lib/packages/AttributeMap.java\nsrc/main/java/com/google/devtools/build/lib/packages/AttributeTransitionData.java\nsrc/main/java/com/google/devtools/build/lib/packages/AttributeValueSource.java\nsrc/main/java/com/google/devtools/build/lib/packages/AutoloadSymbols.java\nsrc/main/java/com/google/devtools/build/lib/packages/BUILD\nsrc/main/java/com/google/devtools/build/lib/packages/BazelStarlarkEnvironment.java\nsrc/main/java/com/google/devtools/build/lib/packages/BuildFileContainsErrorsException.java\nsrc/main/java/com/google/devtools/build/lib/packages/BuildFileName.java\nsrc/main/java/com/google/devtools/build/lib/packages/BuildFileNotFound...

{"text":"src/main/java/net/starlark/java/eval/BUILD\nsrc/main/java/net/starlark/java/eval/BuiltinFunction.java\nsrc/main/java/net/starlark/java/eval/CallUtils.java\nsrc/main/java/net/starlark/java/eval/CpuProfiler.java\nsrc/main/java/net/starlark/java/eval/Debug.java\nsrc/main/java/net/starlark/java/eval/Dict.java\nsrc/main/java/net/starlark/java/eval/Eval.java\nsrc/main/java/net/starlark/java/eval/EvalException.java\nsrc/main/java/net/starlark/java/eval/EvalUtils.java\nsrc/main/java/net/starlark/java/eval/FlagGuardedValue.java\nsrc/main/java/net/starlark/java/eval/FormatParser.java\nsrc/main/java/net/starlark/java/eval/GuardedValue.java\nsrc/main/java/net/starlark/java/eval/HasBinary.java\nsrc/main/java/net/starlark/java/eval/ImmutableSingletonStarlarkList.java\nsrc/main/java/net/starlark/java/eval/ImmutableStarlarkList.java\nsrc/main/java/net/starlark/java/eval/JNI.java\nsrc/main/java/net/starlark/java/eval/LazyImmutableStarlarkList.java\nsrc/main/java/net/starlark/java/eval/MethodDescriptor.java\nsrc/main/java/net/starlark/java/eval/MethodLibrary.java\nsrc/main/java/net/starlark/java/eval/Module.java\nsrc/main/java/net/starlark/java/eval/Mutability.java\nsrc/main/java/net/starlark/java/eval/MutableStarlarkList.java\nsrc/main/java/net/starlark/java/eval/NoneType.java\nsrc/main/java/net/starlark/java/eval/ParamDescriptor.java\nsrc/main/java/net/starlark/java/eval/Printer.java\nsrc/main/java/net/starlark/java/eval/RangeList.java\nsrc/main/java/net/starlark/java/eval/RegularImmutableStarlarkList.java\nsrc/main/java/net/starlark/java/eval/RegularTuple.java\nsrc/main/java/net/starlark/java/eval/Sequence.java\nsrc/main/java/net/starlark/java/eval/SingletonTuple.java\nsrc/main/java/net/starlark/java/eval/Starlark.java\nsrc/main/java/net/starlark/java/eval/StarlarkCallable.ja...

Now let me search for the `rule()` and `macro()` builtin implementations specifically:

{"text":"No results.\n\nNo results found."}

{"text":"No results.\n\nNo results found."}

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/RuleClassProvider.java\n62:    */\n63:   BazelStarlarkEnvironment getBazelStarlarkEnvironment();\n64: \n65: \n59:   /**\n60:    * Returns the {@link BazelStarlarkEnvironment}, which is the final determiner of the BUILD and\n61:    * .bzl environment (with and without builtins injection).\n62: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/BazelStarlarkEnvironment.java\n119:    */\n120:   public BazelStarlarkEnvironment(\n121:       StarlarkGlobals starlarkGlobals,\n122: \n58:  */\n59: public final class BazelStarlarkEnvironment {\n60: \n61: \n103:   /**\n104:    * Constructs a new {@code BazelStarlarkEnvironment} that will have complete knowledge of the\n105:    * proper Starlark symbols available in each context, with and without injection.\n106: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/StarlarkGlobals.java\n25:  * starting point for defining the minimum Starlark environments that Bazel supports for BUILD\n26:  * files, .bzl files, etc. See {@link BazelStarlarkEnvironment} for the final determination of the\n27:  * environment after accounting for registered symbols and builtins injection.\n28: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/WorkspaceFactory.java\n85:     this.starlarkSemantics = starlarkSemantics;\n86:     this.starlarkGlobals = ruleClassProvider.getBazelStarlarkEnvironment().getStarlarkGlobals();\n87:     this.workspaceFunctions =\n88: \n303:   // TODO(b/280446865): Ideally the WORKSPACE environment would be determined by a method in\n304:   // BazelStarlarkEnvironment. The method would accept the values of `_...

Let me now read the key files to understand the full picture:

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/com/google/devtools/build/lib/packages/RuleFunction.java\n1: // Copyright 2017 The Bazel Authors. All rights reserved.\n2: //\n3: // Licensed under the Apache License, Version 2.0 (the \"License\");\n4: // you may not use this file except in compliance with the License.\n5: // You may obtain a copy of the License at\n6: //\n7: //    http://www.apache.org/licenses/LICENSE-2.0\n8: //\n9: // Unless required by applicable law or agreed to in writing, software\n10: // distributed under the License is distributed on an \"AS IS\" BASIS,\n11: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n12: // See the License for the specific language governing permissions and\n13: // limitations under the License.\n14: \n15: package com.google.devtools.build.lib.packages;\n16: \n17: import com.google.devtools.build.lib.starlarkbuildapi.RuleFunctionApi;\n18: \n19: /** Interface for a native or Starlark rule function. */\n20: // Ideally, this interface should be merged with RuleFunctionApi, but that would cause a circular\n21: // dependency between packages and starlarkbuildapi.\n22: public interface RuleFunction extends RuleFunctionApi {\n23:   RuleClass getRuleClass();\n24: }\n25: "}

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/StarlarkNativeModule.java\n430:   @Override\n431:   public Object existingRule(String name, StarlarkThread thread) throws EvalException {\n432:     if (thread.getThreadLocal(ExistingRulesShouldBeNoOp.class) != null) {\n433: \n153:     @Override\n154:     @StarlarkMethod(\n155:         name = \"get\",\n156: \n168: \n169:     @StarlarkMethod(\n170:         name = \"keys\",\n171: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/SelectorList.java\n43:  * <pre>\n44:  *   rule(\n45:  *       name = 'myrule',\n46: \n236: \n237:     @StarlarkMethod(\n238:         name = \"select\",\n239: \n29: import net.starlark.java.annot.StarlarkBuiltin;\n30: import net.starlark.java.annot.StarlarkMethod;\n31: import net.starlark.java.eval.Dict;\n32: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/semantics/BuildLanguageOptions.java\n57:  *       entry to {@link BuildLanguageOptions}, then specify the identifier in {@link\n58:  *       net.starlark.java.annot.StarlarkMethod#enableOnlyWithFlag} or {@link\n59:  *       net.starlark.java.annot.StarlarkMethod#disableWithFlag}.\n60:  * </ul>\n61: \n781:               + \" attr.dormant_label(), attr.dormant_label_list() and\"\n782:               + \" rule(for_dependency_resolution=) are allowed.\")\n783:   public boolean experimentalDormantDeps;\n784: \n54:  *       to update this when flipping a flag's default value.\n55:  *   <li>Boolean semantic flags can toggle StarlarkMethod-annotated Java methods (or their\n56:  *       parameters) on or off, making them selectively invisible to Starlark. To do this, add a new\n57: \n"}

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/StarlarkNativeModule.java\n153:     @Override\n154:     @StarlarkMethod(\n155:         name = \"get\",\n156: \n168: \n169:     @StarlarkMethod(\n170:         name = \"keys\",\n171: \n183: \n184:     @StarlarkMethod(\n185:         name = \"values\",\n186: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/semantics/BuildLanguageOptions.java\n57:  *       entry to {@link BuildLanguageOptions}, then specify the identifier in {@link\n58:  *       net.starlark.java.annot.StarlarkMethod#enableOnlyWithFlag} or {@link\n59:  *       net.starlark.java.annot.StarlarkMethod#disableWithFlag}.\n60:  * </ul>\n61: \n54:  *       to update this when flipping a flag's default value.\n55:  *   <li>Boolean semantic flags can toggle StarlarkMethod-annotated Java methods (or their\n56:  *       parameters) on or off, making them selectively invisible to Starlark. To do this, add a new\n57: \n243:       effectTags = OptionEffectTag.BUILD_FILE_SEMANTICS,\n244:       help = \"If set to true, enables the `macro()` construct for defining symbolic macros.\")\n245:   public boolean experimentalEnableFirstClassMacros;\n246: \n"}

Let me find where `rule()` and `macro()` builtins are implemented:

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleContextApi.java\n269: \n270:   @StarlarkMethod(\n271:       name = \"genfiles_dir\",\n272: \n141: \n142:   @StarlarkMethod(\n143:       name = \"actions\",\n144: \n147: \n148:   @StarlarkMethod(\n149:       name = \"super\",\n150: \n\n# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java\n65: \n66:   @StarlarkMethod(\n67:       name = \"provider\",\n68: \n200: \n201:   @StarlarkMethod(\n202:       name = \"macro\",\n203: \n427: \n428:   @StarlarkMethod(\n429:       name = \"rule\",\n430:       doc =\n431: \n"}

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java\n65: \n66:   @StarlarkMethod(\n67:       name = \"provider\",\n68: \n200: \n201:   @StarlarkMethod(\n202:       name = \"macro\",\n203:       doc =\n204: \n427: \n428:   @StarlarkMethod(\n429:       name = \"rule\",\n430: \n"}

The `rule()` and `macro()` builtins are declared in `StarlarkRuleFunctionsApi.java`. Let me find the concrete implementation:

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/analysis/starlark/StarlarkRuleClassFunctions.java\n145: /** A helper class to provide an easier API for Starlark rule definitions. */\n146: public class StarlarkRuleClassFunctions implements StarlarkRuleFunctionsApi {\n147: \n148: \n"}

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/packages/BzlInitThreadContext.java\n33:  */\n34: public final class BzlInitThreadContext extends StarlarkThreadContext\n35:     implements RuleDefinitionEnvironment {\n36: \n"}

Now let me read key sections of the most important files to verify their content and key class names:

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/net/starlark/java/eval/StarlarkThread.java%3FL1-80\n1: // Copyright 2014 The Bazel Authors. All rights reserved.\n2: //\n3: // Licensed under the Apache License, Version 2.0 (the \"License\");\n4: // you may not use this file except in compliance with the License.\n5: // You may obtain a copy of the License at\n6: //\n7: //    http://www.apache.org/licenses/LICENSE-2.0\n8: //\n9: // Unless required by applicable law or agreed to in writing, software\n10: // distributed under the License is distributed on an \"AS IS\" BASIS,\n11: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n12: // See the License for the specific language governing permissions and\n13: // limitations under the License.\n14: \n15: package net.starlark.java.eval;\n16: \n17: import com.google.common.base.Preconditions;\n18: import com.google.common.collect.ImmutableList;\n19: import com.google.common.collect.ImmutableMap;\n20: import java.util.ArrayList;\n21: import java.util.HashMap;\n22: import java.util.Map;\n23: import java.util.concurrent.atomic.AtomicInteger;\n24: import javax.annotation.Nullable;\n25: import javax.annotation.concurrent.Immutable;\n26: import net.starlark.java.syntax.Location;\n27: \n28: /**\n29:  * An StarlarkThread represents a Starlark thread.\n30:  *\n31:  * <p>It holds the stack of active Starlark and built-in function calls. In addition, it may hold\n32:  * per-thread application state (see {@link #setThreadLocal}) that passes through Starlark functions\n33:  * but does not directly affect them, such as information about the BUILD file being loaded.\n34:  *\n35:  * <p>StarlarkThreads are not thread-safe: they sh...

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/com/google/devtools/build/lib/packages/PackageFactory.java%3FL1-100\n1: // Copyright 2014 The Bazel Authors. All rights reserved.\n2: //\n3: // Licensed under the Apache License, Version 2.0 (the \"License\");\n4: // you may not use this file except in compliance with the License.\n5: // You may obtain a copy of the License at\n6: //\n7: //    http://www.apache.org/licenses/LICENSE-2.0\n8: //\n9: // Unless required by applicable law or agreed to in writing, software\n10: // distributed under the License is distributed on an \"AS IS\" BASIS,\n11: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n12: // See the License for the specific language governing permissions and\n13: // limitations under the License.\n14: \n15: package com.google.devtools.build.lib.packages;\n16: \n17: import com.google.common.annotations.VisibleForTesting;\n18: import com.google.common.base.Preconditions;\n19: import com.google.common.collect.ImmutableList;\n20: import com.google.common.collect.ImmutableMap;\n21: import com.google.common.flogger.GoogleLogger;\n22: import com.google.devtools.build.lib.actions.ThreadStateReceiver;\n23: import com.google.devtools.build.lib.analysis.RuleDefinitionEnvironment;\n24: import com.google.devtools.build.lib.cmdline.IgnoredSubdirectories;\n25: import com.google.devtools.build.lib.cmdline.PackageIdentifier;\n26: import com.google.devtools.build.lib.cmdline.RepositoryMapping;\n27: import com.google.devtools.build.lib.concurrent.NamedForkJoinPool;\n28: import com.google.devtools.build.lib.events.Event;\n29: import com.google.devtools.build.lib.events.ExtendedEventHandler;\n30: import com.google.devt...

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/com/google/devtools/build/lib/skyframe/BzlLoadFunction.java%3FL1-120\n1: // Copyright 2014 The Bazel Authors. All rights reserved.\n2: //\n3: // Licensed under the Apache License, Version 2.0 (the \"License\");\n4: // you may not use this file except in compliance with the License.\n5: // You may obtain a copy of the License at\n6: //\n7: //    http://www.apache.org/licenses/LICENSE-2.0\n8: //\n9: // Unless required by applicable law or agreed to in writing, software\n10: // distributed under the License is distributed on an \"AS IS\" BASIS,\n11: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n12: // See the License for the specific language governing permissions and\n13: // limitations under the License.\n14: package com.google.devtools.build.lib.skyframe;\n15: \n16: import com.github.benmanes.caffeine.cache.Cache;\n17: import com.github.benmanes.caffeine.cache.Caffeine;\n18: import com.google.common.annotations.VisibleForTesting;\n19: import com.google.common.base.Preconditions;\n20: import com.google.common.base.Predicates;\n21: import com.google.common.collect.ImmutableList;\n22: import com.google.common.collect.ImmutableMap;\n23: import com.google.common.collect.Lists;\n24: import com.google.common.collect.Maps;\n25: import com.google.common.flogger.GoogleLogger;\n26: import com.google.common.hash.HashFunction;\n27: import com.google.devtools.build.lib.analysis.BlazeDirectories;\n28: import com.google.devtools.build.lib.cmdline.BazelModuleContext;\n29: import com.google.devtools.build.lib.cmdline.Label;\n30: import com.google.devtools.build.lib.cmdline.Label.PackageContext;\n31: import com.google.devt...

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/com/google/devtools/build/lib/analysis/starlark/StarlarkRuleClassFunctions.java%3FL1-100\n1: // Copyright 2014 The Bazel Authors. All rights reserved.\n2: //\n3: // Licensed under the Apache License, Version 2.0 (the \"License\");\n4: // you may not use this file except in compliance with the License.\n5: // You may obtain a copy of the License at\n6: //\n7: //    http://www.apache.org/licenses/LICENSE-2.0\n8: //\n9: // Unless required by applicable law or agreed to in writing, software\n10: // distributed under the License is distributed on an \"AS IS\" BASIS,\n11: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n12: // See the License for the specific language governing permissions and\n13: // limitations under the License.\n14: \n15: package com.google.devtools.build.lib.analysis.starlark;\n16: \n17: import static com.google.common.base.Preconditions.checkArgument;\n18: import static com.google.common.base.Preconditions.checkState;\n19: import static com.google.common.collect.ImmutableList.toImmutableList;\n20: import static com.google.devtools.build.lib.analysis.BaseRuleClasses.RUN_UNDER_EXEC_CONFIG;\n21: import static com.google.devtools.build.lib.analysis.BaseRuleClasses.RUN_UNDER_TARGET_CONFIG;\n22: import static com.google.devtools.build.lib.analysis.BaseRuleClasses.TIMEOUT_DEFAULT;\n23: import static com.google.devtools.build.lib.analysis.BaseRuleClasses.getTestRuntimeLabelList;\n24: import static com.google.devtools.build.lib.analysis.test.ExecutionInfo.DEFAULT_TEST_RUNNER_EXEC_GROUP;\n25: import static com.google.devtools.build.lib.packages.Attribute.attr;\n26: import static com.google.devtools.b...

Let me read more of the key implementation files to identify inner classes and key methods:

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/com/google/devtools/build/lib/analysis/starlark/StarlarkRuleClassFunctions.java%3FL140-250\n140: import net.starlark.java.eval.SymbolGenerator.Symbol;\n141: import net.starlark.java.eval.Tuple;\n142: import net.starlark.java.syntax.Identifier;\n143: import net.starlark.java.syntax.Location;\n144: \n145: /** A helper class to provide an easier API for Starlark rule definitions. */\n146: public class StarlarkRuleClassFunctions implements StarlarkRuleFunctionsApi {\n147: \n148:   // A cache for base rule classes (especially tests).\n149:   private static final LoadingCache<String, Label> labelCache =\n150:       Caffeine.newBuilder().build(Label::parseCanonical);\n151: \n152:   // TODO(bazel-team): Remove the code duplication (BaseRuleClasses and this class).\n153:   /** Parent rule class for non-executable non-test Starlark rules. */\n154:   public static final RuleClass baseRule =\n155:       BaseRuleClasses.commonCoreAndStarlarkAttributes(\n156:               new RuleClass.Builder(\"$base_rule\", RuleClassType.ABSTRACT, true)\n157:                   .add(attr(\"expect_failure\", STRING)))\n158:           // TODO(skylark-team): Allow Starlark rules to extend native rules and remove duplication.\n159:           .add(\n160:               attr(\"toolchains\", LABEL_LIST)\n161:                   .allowedFileTypes(FileTypeSet.NO_FILE)\n162:                   .mandatoryProviders(ImmutableList.of(TemplateVariableInfo.PROVIDER.id()))\n163:                   .dontCheckConstraints())\n164:           .add(attr(RuleClass.EXEC_PROPERTIES_ATTR, Types.STRING_DICT).value(ImmutableMap.of()))\n165:           .add(\n166:               attr(RuleClass.EXEC...

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/com/google/devtools/build/lib/packages/Package.java%3FL1050-1120\n1050:         .setLoads(ImmutableList.of());\n1051:   }\n1052: \n1053:   // ==== Non-trivial nested classes ====\n1054: \n1055:   /**\n1056:    * A builder for {@link Package} objects. Only intended to be used by {@link PackageFactory} and\n1057:    * {@link com.google.devtools.build.lib.skyframe.PackageFunction}.\n1058:    */\n1059:   public static class Builder extends TargetDefinitionContext {\n1060: \n1061:     /**\n1062:      * A bundle of options affecting package construction, that is not specific to any particular\n1063:      * package.\n1064:      */\n1065:     public interface PackageSettings {\n1066:       /**\n1067:        * Returns whether or not extra detail should be added to {@link NoSuchTargetException}s\n1068:        * thrown from {@link #getTarget}. Useful for toning down verbosity in situations where it can\n1069:        * be less helpful.\n1070:        */\n1071:       // TODO(bazel-team): Arguably, this could be replaced by a boolean param to getTarget(), or\n1072:       // some separate action taken by the caller. But there's a lot of call sites that would need\n1073:       // updating.\n1074:       default boolean succinctTargetNotFoundErrors() {\n1075:         return false;\n1076:       }\n1077: \n1078:       /**\n1079:        * Determines whether to precompute a list of transitively loaded starlark files while\n1080:        * building packages.\n1081:        *\n1082:        * <p>Typically, direct loads are stored as a {@code ImmutableList<Module>}. This is\n1083:        * sufficient to reconstruct the full load graph by recursively traversing {@...

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/com/google/devtools/build/lib/packages/BazelStarlarkEnvironment.java%3FL1-80\n1: // Copyright 2020 The Bazel Authors. All rights reserved.\n2: //\n3: // Licensed under the Apache License, Version 2.0 (the \"License\");\n4: // you may not use this file except in compliance with the License.\n5: // You may obtain a copy of the License at\n6: //\n7: //    http://www.apache.org/licenses/LICENSE-2.0\n8: //\n9: // Unless required by applicable law or agreed to in writing, software\n10: // distributed under the License is distributed on an \"AS IS\" BASIS,\n11: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n12: // See the License for the specific language governing permissions and\n13: // limitations under the License.\n14: \n15: package com.google.devtools.build.lib.packages;\n16: \n17: import com.google.common.base.Preconditions;\n18: import com.google.common.collect.ImmutableMap;\n19: import com.google.common.collect.Sets;\n20: import java.util.HashMap;\n21: import java.util.List;\n22: import java.util.Map;\n23: import java.util.Set;\n24: import javax.annotation.Nullable;\n25: import net.starlark.java.eval.GuardedValue;\n26: import net.starlark.java.eval.Starlark;\n27: \n28: // TODO(adonovan): move skyframe.PackageFunction into lib.packages so we needn't expose this and\n29: // the other env-building functions.\n30: /**\n31:  * This class encapsulates knowledge of how to set up the Starlark environment for BUILD, WORKSPACE,\n32:  * and bzl file evaluation, including the top-level predeclared symbols, the {@code native} module,\n33:  * and the special environment for {@code @_builtins} bzl evaluation.\n34:  *\...

Let me verify a few more important files that were identified:

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java%3FL1-80\n1: // Copyright 2018 The Bazel Authors. All rights reserved.\n2: //\n3: // Licensed under the Apache License, Version 2.0 (the \"License\");\n4: // you may not use this file except in compliance with the License.\n5: // You may obtain a copy of the License at\n6: //\n7: //    http://www.apache.org/licenses/LICENSE-2.0\n8: //\n9: // Unless required by applicable law or agreed to in writing, software\n10: // distributed under the License is distributed on an \"AS IS\" BASIS,\n11: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n12: // See the License for the specific language governing permissions and\n13: // limitations under the License.\n14: \n15: package com.google.devtools.build.lib.starlarkbuildapi;\n16: \n17: import com.google.devtools.build.docgen.annot.GlobalMethods;\n18: import com.google.devtools.build.docgen.annot.GlobalMethods.Environment;\n19: import com.google.devtools.build.docgen.annot.StarlarkConstructor;\n20: import com.google.devtools.build.lib.cmdline.Label;\n21: import com.google.devtools.build.lib.packages.semantics.BuildLanguageOptions;\n22: import com.google.devtools.build.lib.starlarkbuildapi.config.StarlarkConfigApi.BuildSettingApi;\n23: import net.starlark.java.annot.Param;\n24: import net.starlark.java.annot.ParamType;\n25: import net.starlark.java.annot.StarlarkMethod;\n26: import net.starlark.java.eval.Dict;\n27: import net.starlark.java.eval.EvalException;\n28: import net.starlark.java.eval.NoneType;\n29: import net.starlark.java.eval.Sequence;\n30: import net.starlark.java.eval.StarlarkCallab...

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/com/google/devtools/build/lib/packages/MacroClass.java%3FL1-80\n1: // Copyright 2024 The Bazel Authors. All rights reserved.\n2: //\n3: // Licensed under the Apache License, Version 2.0 (the \"License\");\n4: // you may not use this file except in compliance with the License.\n5: // You may obtain a copy of the License at\n6: //\n7: //    http://www.apache.org/licenses/LICENSE-2.0\n8: //\n9: // Unless required by applicable law or agreed to in writing, software\n10: // distributed under the License is distributed on an \"AS IS\" BASIS,\n11: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n12: // See the License for the specific language governing permissions and\n13: // limitations under the License.\n14: \n15: package com.google.devtools.build.lib.packages;\n16: \n17: import static com.google.common.collect.ImmutableList.toImmutableList;\n18: import static com.google.devtools.build.lib.packages.BuildType.NODEP_LABEL_LIST;\n19: \n20: import com.google.common.base.Preconditions;\n21: import com.google.common.collect.ImmutableList;\n22: import com.google.common.collect.ImmutableMap;\n23: import com.google.common.collect.ImmutableSet;\n24: import com.google.common.collect.Lists;\n25: import com.google.devtools.build.lib.cmdline.Label;\n26: import com.google.devtools.build.lib.cmdline.PackageIdentifier;\n27: import com.google.devtools.build.lib.events.Event;\n28: import com.google.devtools.build.lib.packages.TargetRecorder.MacroFrame;\n29: import com.google.devtools.build.lib.packages.TargetRecorder.NameConflictException;\n30: import com.google.devtools.build.lib.server.FailureDetails.PackageLoading.Code;\n31: ...

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/com/google/devtools/build/lib/packages/BzlInitThreadContext.java%3FL1-60\n1: // Copyright 2022 The Bazel Authors. All rights reserved.\n2: //\n3: // Licensed under the Apache License, Version 2.0 (the \"License\");\n4: // you may not use this file except in compliance with the License.\n5: // You may obtain a copy of the License at\n6: //\n7: //    http://www.apache.org/licenses/LICENSE-2.0\n8: //\n9: // Unless required by applicable law or agreed to in writing, software\n10: // distributed under the License is distributed on an \"AS IS\" BASIS,\n11: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n12: // See the License for the specific language governing permissions and\n13: // limitations under the License.\n14: \n15: package com.google.devtools.build.lib.packages;\n16: \n17: import com.google.common.collect.ImmutableMap;\n18: import com.google.devtools.build.lib.analysis.RuleDefinitionEnvironment;\n19: import com.google.devtools.build.lib.cmdline.Label;\n20: import com.google.devtools.build.lib.cmdline.RepositoryMapping;\n21: import com.google.devtools.build.lib.cmdline.RepositoryName;\n22: import com.google.devtools.build.lib.cmdline.StarlarkThreadContext;\n23: import com.google.errorprone.annotations.CanIgnoreReturnValue;\n24: import java.util.Optional;\n25: import javax.annotation.Nullable;\n26: import net.starlark.java.eval.EvalException;\n27: import net.starlark.java.eval.Starlark;\n28: import net.starlark.java.eval.StarlarkThread;\n29: \n30: /**\n31:  * Bazel application data for the Starlark thread that evaluates the top-level code in a .bzl (or\n32:  * .scl) module (i.e. when evaluating that mod...

Let me also look at the `net/starlark` directory structure and check a few more files:

{"text":"src/main/java/net/starlark/java/annot/\nsrc/main/java/net/starlark/java/cmd/\nsrc/main/java/net/starlark/java/eval/\nsrc/main/java/net/starlark/java/lib/\nsrc/main/java/net/starlark/java/spelling/\nsrc/main/java/net/starlark/java/syntax/\nsrc/main/java/net/starlark/java/BUILD\n"}

{"text":"URL: https://demo.sourcegraph.com/github.com/sg-evals/bazel--8.0.0@12f256c9dffb17d03d47b3f06bf34f67c976e4aa/-/blob/src/main/java/com/google/devtools/build/lib/packages/StarlarkGlobals.java%3FL1-80\n1: // Copyright 2023 The Bazel Authors. All rights reserved.\n2: //\n3: // Licensed under the Apache License, Version 2.0 (the \"License\");\n4: // you may not use this file except in compliance with the License.\n5: // You may obtain a copy of the License at\n6: //\n7: //    http://www.apache.org/licenses/LICENSE-2.0\n8: //\n9: // Unless required by applicable law or agreed to in writing, software\n10: // distributed under the License is distributed on an \"AS IS\" BASIS,\n11: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n12: // See the License for the specific language governing permissions and\n13: // limitations under the License.\n14: \n15: package com.google.devtools.build.lib.packages;\n16: \n17: import com.google.common.collect.ImmutableMap;\n18: \n19: /**\n20:  * A library of the fixed Starlark environment for various contexts.\n21:  *\n22:  * <p>This is the source of truth for what symbols are available in what Starlark contexts (BUILD,\n23:  * .bzl, etc.), before considering how symbols may be added by registering them on the rule class\n24:  * provider, or how symbols may be substituted by builtins injection. In other words, this is the\n25:  * starting point for defining the minimum Starlark environments that Bazel supports for BUILD\n26:  * files, .bzl files, etc. See {@link BazelStarlarkEnvironment} for the final determination of the\n27:  * environment after accounting for registered symbols and builtins injection.\n28:  *\n29:  * <p>This is split between an interface in the lib/packages/ directory and an implementation ...

Let me find the StarlarkGlobals implementation:

{"text":"# github.com/sg-evals/bazel--8.0.0 – src/main/java/com/google/devtools/build/lib/analysis/starlark/StarlarkGlobalsImpl.java\n41:  */\n42: public final class StarlarkGlobalsImpl implements StarlarkGlobals {\n43: \n44: \n"}

{"text":"No results.\n\nNo results found."}

Now I have a comprehensive picture. Let me write the `answer.json` file with all findings:

File created successfully at: /workspace/answer.json (file state is current in your context — no need to Read it back)

The `answer.json` file has been written. Here's a summary of what was found:

## Key Files for Starlark BUILD Evaluation in Bazel 8.0.0

### StarlarkThread (environment setup)
- **`src/main/java/net/starlark/java/eval/StarlarkThread.java`** — `StarlarkThread` class: the execution thread holding the call stack, mutability, thread-locals. Callers attach context objects like `Package.Builder` via `setThreadLocal`.

### PackageFactory (invokes Starlark evaluation)
- **`src/main/java/com/google/devtools/build/lib/packages/PackageFactory.java`** — `PackageFactory` class: constructs `Package` instances from BUILD file ASTs via `executeBuildFile()`.

### BzlLoadFunction (.bzl file loading)
- **`src/main/java/com/google/devtools/build/lib/skyframe/BzlLoadFunction.java`** — `BzlLoadFunction` class: Skyframe function loading .bzl/.scl modules, setting up `StarlarkThread` with `BzlInitThreadContext`.

### rule() and macro() builtins
- **`src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java`** — API interface declaring `rule()` and `macro()` `@StarlarkMethod`s.
- **`src/main/java/com/google/devtools/build/lib/analysis/starlark/StarlarkRuleClassFunctions.java`** — `StarlarkRuleClassFunctions` implements `StarlarkRuleFunctionsApi`; contains `rule()` and `macro()` implementations.
- **`src/main/java/com/google/devtools/build/lib/packages/MacroClass.java`** — `MacroClass`: the macro schema + implementation (analogous to `RuleClass`).
- **`src/main/java/com/google/devtools/build/lib/packages/RuleFunction.java`** / **`RuleClass.java`** / **`RuleFactory.java`** — rule callable interface, rule schema, and rule instantiation.

### Package.Builder (accumulates targets)
- **`src/main/java/com/google/devtools/build/lib/packages/Package.java`** — inner class...

I'll start by checking what's in the workspace, then locate the relevant Bazel source directories.

bazel--8.0.0

BUILD
BuiltinFunction.java
CallUtils.java
CpuProfiler.java
Debug.java
Dict.java
Eval.java
EvalException.java
EvalUtils.java
FlagGuardedValue.java
FormatParser.java
GuardedValue.java
HasBinary.java
ImmutableSingletonStarlarkList.java
ImmutableStarlarkList.java
JNI.java
LazyImmutableStarlarkList.java
MethodDescriptor.java
MethodLibrary.java
Module.java
Mutability.java
MutableStarlarkList.java
NoneType.java
ParamDescriptor.java
Printer.java
RangeList.java
RegularImmutableStarlarkList.java
RegularTuple.java
Sequence.java
SingletonTuple.java
Starlark.java
StarlarkCallable.java
StarlarkFloat.java
StarlarkFunction.java
StarlarkIndexable.java
StarlarkInt.java
StarlarkIterable.java
StarlarkList.java
StarlarkSemantics.java
StarlarkThread.java
StarlarkValue.java
StringModule.java
Structure.java
SymbolGenerator.java
Tuple.java
cpu_profiler_posix.cc
cpu_profiler_unimpl.cc
---
AbstractAttributeMapper.java
AdvertisedProviderSet.java
AggregatingAttributeMapper.java
AllowlistChecker.java
Aspect.java
AspectClass.java
AspectDefinition.java
AspectDescriptor.java
AspectParameters.java
AspectsList.java
Attribute.java
AttributeFormatter.java
AttributeMap.java
AttributeTransitionData.java
AttributeValueSource.java
AutoloadSymbols.java
BUILD
BazelStarlarkEnvironment.java
BuildFileContainsErrorsException.java
BuildFileName.java
BuildFileNotFoundException.java
BuildGlobals.java
BuildSetting.java
BuildType.java
BuilderFactoryForTesting.java
BuiltinProvider.java
BuiltinRestriction.java
BuiltinsInternalModule.java
BzlInitThreadContext.java
BzlVisibility.java
CachingPackageLocator.java
CallStack.java
ConfigurationFragmentPolicy.java
ConfiguredAttributeMapper.java
DefaultSetting.java
DelegatingAttributeMapper.java
DependencyFilter.java
DotBazelFileSyntaxChecker.java
EnumFilterConverter.java
Environmen...

StarlarkAspect.java
StarlarkAspectClass.java
StarlarkCallbackHelper.java
StarlarkDefinedAspect.java
StarlarkExportable.java
StarlarkGlobals.java
StarlarkInfo.java
StarlarkInfoNoSchema.java
StarlarkInfoWithMessage.java
StarlarkInfoWithSchema.java
StarlarkNativeAspect.java
StarlarkNativeModule.java
StarlarkProvider.java
StarlarkProviderIdentifier.java
StarlarkProviderWrapper.java
StructImpl.java
StructProvider.java
Target.java
TargetData.java
TargetDefinitionContext.java
TargetRecorder.java
TargetSuggester.java
TargetUtils.java
TestSize.java
TestSuiteImplicitTestsAccumulator.java
TestTargetUtils.java
TestTimeout.java
TriState.java
Type.java
Types.java
VendorFileGlobals.java
VendorThreadContext.java
VisibilityLicenseSpecifiedInputFile.java
WorkspaceFactory.java
WorkspaceFactoryHelper.java
WorkspaceFileValue.java
WorkspaceGlobals.java
metrics
producers
semantics
---
BUILD
annot
cmd
eval
lib
spelling
syntax

The directory structure is clear. Now let me locate the specific classes: BzlLoadFunction and the rule()/macro() builtin implementations.

src/main/java/com/google/devtools/build/lib/skyframe/BzlLoadFunction.java
src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java
src/main/java/com/google/devtools/build/lib/analysis/starlark/StarlarkRuleClassFunctions.java
---
src/main/java/com/google/devtools/build/lib/packages/MacroClass.java
src/main/java/com/google/devtools/build/lib/packages/TargetRecorder.java
src/main/java/com/google/devtools/build/lib/packages/RuleFactory.java

src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java:202:      name = "macro",
src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java:429:      name = "rule",
---
1059:  public static class Builder extends TargetDefinitionContext {
---
47:public final class StarlarkThread {
---
80:public final class PackageFactory {
---
108:public class BzlLoadFunction implements SkyFunction {
1694:  private static final class BzlLoadFunctionException extends SkyFunctionException {

146:public class StarlarkRuleClassFunctions implements StarlarkRuleFunctionsApi {
362:  public MacroFunctionApi macro(
493:  public StarlarkRuleFunction rule(
1392:  public static final class MacroFunction implements StarlarkExportable, MacroFunctionApi {
2105:      return StarlarkRuleFunction.class;
---
59:public final class BazelStarlarkEnvironment {
52:public final class Module implements Resolver.Module {
286:   * {@link #executeBuildFile} after this caller has fully loaded the package.
344:  public void executeBuildFile(
377:      executeBuildFileImpl(
390:  private void executeBuildFileImpl(
416:        Starlark.execFileProgram(buildFileProgram, module, thread);
69:public abstract class TargetDefinitionContext extends StarlarkThreadContext {

33:public interface StarlarkGlobals {
36:public class BuildGlobals {
31: * This class encapsulates knowledge of how to set up the Starlark environment for BUILD, WORKSPACE,
56: *       BUILD files. This happens in {@link PackageFunction}.
61:  // TODO(#11954): Eventually the BUILD and WORKSPACE bzl dialects should converge. Right now they
81:  /** The {@code native} module fields for a BUILD-loaded bzl module, before builtins injection. */
84:   * The top-level predeclared symbols (including {@code native}) for a BUILD-loaded bzl module,
88:  /** The top-level predeclared symbols for BUILD files, before builtins injection and prelude. */
89:  private final ImmutableMap<String, Object> uninjectedBuildEnv;
110:   *     provider) top-level symbols for BUILD files, prior to builtins injection. These symbols are
56:final class Eval {
1047:    return execFileProgram(prog, module, thread);
1070:  public static Object execFileProgram(Program prog, Module module, StarlarkThread thread)
1074:    // A given Module may be passed to execFileProgram multiple times in sequence,

I have all the information needed. Writing the answer file now.

File created successfully at: /workspace/answer.json (file state is current in your context — no need to Read it back)

I located and verified all five requested components in the bazelbuild/bazel source tree (at `/workspace/bazel--8.0.0`) and wrote the inventory to `/workspace/answer.json`. Summary of findings:

**1. StarlarkThread and environment setup**
- `net/starlark/java/eval/StarlarkThread.java` — `StarlarkThread` (line 47), the interpreter thread holding the call stack, semantics, and mutability.
- `net/starlark/java/eval/Module.java` — `Module`, the per-file environment of predeclared bindings and globals.
- `lib/packages/BazelStarlarkEnvironment.java` — `BazelStarlarkEnvironment`, which "encapsulates knowledge of how to set up the Starlark environment for BUILD, WORKSPACE, and bzl files" (its own doc comment), including builtins injection; supported by `StarlarkGlobals.java` and `BuildGlobals.java`.
- `net/starlark/java/eval/Starlark.java` (`execFileProgram`) and `Eval.java` (the tree-walking interpreter) perform the actual evaluation.

**2. PackageFactory** — `lib/packages/PackageFactory.java`, whose `executeBuildFile`/`executeBuildFileImpl` (lines 344/390) create the thread and call `Starlark.execFileProgram` on the compiled BUILD program (line 416).

**3. BzlLoadFunction** — `lib/skyframe/BzlLoadFunction.java` (`class BzlLoadFunction implements SkyFunction`, line 108). This sits outside the two named directories but is the canonical .bzl loader, so I included it.

**4. rule() and macro() builtins** — `lib/analysis/starlark/StarlarkRuleClassFunctions.java`: `macro(...)` at line 362, `rule(...)` at line 493, returning the nested `MacroFunction` and `StarlarkRuleFunction` callables. The `@StarlarkMethod(name = "rule")` / `name = "macro"` declarations are on the interface `lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java` (lines 429/202). `lib/packages/MacroClass.java` holds t...