https://alwaldend.com/docs/projects/al/openspec/specs/project-bazel-agent/Recent content in Project bazel agent on AlwaldendHugoenhttps://alwaldend.com/docs/projects/al/openspec/specs/project-bazel-agent/spec/Mon, 01 Jan 0001 00:00:00 +0000https://alwaldend.com/docs/projects/al/openspec/specs/project-bazel-agent/spec/<span id="bazel-agent-specification"></span><h2 id="purpose">Purpose<a class="td-heading-self-link" href="#purpose" aria-label="Heading self-link"></a></h2><p>Describe the validated AL Bazel entry point and installation diagnostics used by repository agents.</p> <p>Sources: <a href="https://alwaldend.com/docs/projects/al/">project README</a>, <a href="../../../BUILD.bazel">Bazel targets</a>, <a href="../../../internal/bazelcmd/main.go">command and diagnostic implementation</a>, and <a href="../../../internal/bazelcmd/main_test.go">runner tests</a>. Baseline source revision: <code>550d7e79b1f5fdbc2b6017b75178471d6914082f</code>, observed 2026-09-08.</p> <h2 id="requirements">Requirements<a class="td-heading-self-link" href="#requirements" aria-label="Heading self-link"></a></h2><h3 id="requirement-validate-and-preserve-bazel-arguments">Requirement: Validate and preserve Bazel arguments<a class="td-heading-self-link" href="#requirement-validate-and-preserve-bazel-arguments" aria-label="Heading self-link"></a></h3><p><code>al bazel</code> SHALL require a recognized Bazel command and insert <code>--config=agent</code> immediately after that command. Subsequent options, targets, and arguments after a <code>run</code> separator SHALL pass through unchanged.</p> <h4 id="scenario-run-a-target-with-application-arguments">Scenario: Run a target with application arguments<a class="td-heading-self-link" href="#scenario-run-a-target-with-application-arguments" aria-label="Heading self-link"></a></h4><ul> <li><strong>WHEN</strong> the caller invokes <code>al bazel run //path:target -- argument</code></li> <li><strong>THEN</strong> the runner constructs <code>bazel run --config=agent //path:target -- argument</code>.</li> </ul> <h3 id="requirement-replace-the-runner-with-bazel">Requirement: Replace the runner with Bazel<a class="td-heading-self-link" href="#requirement-replace-the-runner-with-bazel" aria-label="Heading self-link"></a></h3><p>The Bazel entry point SHALL resolve <code>bazel</code> from <code>PATH</code> and replace the runner process with it, preserving the supplied environment without creating or injecting a host temporary directory.</p>