@altf4llc/vorpal-sdk 0.1.0-alpha.0

package/dist/artifact/language/go.js

@@ -0,0 +1,361 @@
+import { ArtifactSystem } from "../../api/artifact/artifact.js";
+import { Artifact, ArtifactSource, DevelopmentEnvironment, getEnvKey, secretsToProto, } from "../../artifact.js";
+import { shell } from "../step.js";
+// ---------------------------------------------------------------------------
+// System mapping helpers
+// ---------------------------------------------------------------------------
+/**
+ * Maps an ArtifactSystem enum to the Go `GOOS` value.
+ * Matches `get_goos()` in `sdk/rust/src/artifact/language/go.rs`
+ * and `GetGOOS()` in `sdk/go/pkg/artifact/language/go.go`.
+ */
+export function getGoos(system) {
+    switch (system) {
+        case ArtifactSystem.AARCH64_DARWIN:
+        case ArtifactSystem.X8664_DARWIN:
+            return "darwin";
+        case ArtifactSystem.AARCH64_LINUX:
+        case ArtifactSystem.X8664_LINUX:
+            return "linux";
+        default:
+            throw new Error(`unsupported 'go' system: ${system}`);
+    }
+}
+/**
+ * Maps an ArtifactSystem enum to the Go `GOARCH` value.
+ * Matches `get_goarch()` in `sdk/rust/src/artifact/language/go.rs`
+ * and `GetGOARCH()` in `sdk/go/pkg/artifact/language/go.go`.
+ */
+export function getGoarch(system) {
+    switch (system) {
+        case ArtifactSystem.AARCH64_DARWIN:
+        case ArtifactSystem.AARCH64_LINUX:
+            return "arm64";
+        case ArtifactSystem.X8664_DARWIN:
+        case ArtifactSystem.X8664_LINUX:
+            return "amd64";
+        default:
+            throw new Error(`unsupported 'go' system: ${system}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Go
+// ---------------------------------------------------------------------------
+/**
+ * Builder for Go project artifacts.
+ *
+ * Analogous to:
+ * - Rust SDK: `sdk/rust/src/artifact/language/go.rs` (`Go` struct)
+ * - Go SDK: `sdk/go/pkg/artifact/language/go.go` (`Go` struct)
+ *
+ * The builder:
+ * 1. Fetches the Go distribution artifact from the registry
+ * 2. Fetches the Git artifact from the registry
+ * 3. Builds source using ArtifactSource (or uses an explicit source)
+ * 4. Computes GOOS and GOARCH from the target system
+ * 5. Generates a build script that runs `go build`
+ * 6. Creates a shell step and returns the artifact digest
+ *
+ * Usage:
+ * ```typescript
+ * const digest = await new Go("my-go-app", SYSTEMS)
+ *   .withIncludes(["cmd", "pkg", "go.mod", "go.sum"])
+ *   .build(context);
+ * ```
+ */
+export class Go {
+    _aliases = [];
+    _artifacts = [];
+    _buildDirectory = ".";
+    _buildFlags = "";
+    _buildPath = ".";
+    _environments = [];
+    _includes = [];
+    _name;
+    _secrets = new Map();
+    _source = undefined;
+    _sourceScripts = [];
+    _systems;
+    constructor(name, systems) {
+        this._name = name;
+        this._systems = systems;
+    }
+    /** Adds human-readable aliases for this artifact. */
+    withAliases(aliases) {
+        this._aliases = aliases;
+        return this;
+    }
+    /** Adds artifact dependencies available during the build step. */
+    withArtifacts(artifacts) {
+        this._artifacts = artifacts;
+        return this;
+    }
+    /**
+     * Sets the build directory passed as `-C` flag to `go build`.
+     * Defaults to `"."`.
+     */
+    withBuildDirectory(directory) {
+        this._buildDirectory = directory;
+        return this;
+    }
+    /**
+     * Sets additional flags for `go build`.
+     * Defaults to `""`.
+     */
+    withBuildFlags(flags) {
+        this._buildFlags = flags;
+        return this;
+    }
+    /**
+     * Sets the build path argument for `go build`.
+     * Defaults to `"."`.
+     */
+    withBuildPath(path) {
+        this._buildPath = path;
+        return this;
+    }
+    /**
+     * Sets environment variables for the build step.
+     * Format: `"KEY=VALUE"`.
+     */
+    withEnvironments(environments) {
+        this._environments = environments;
+        return this;
+    }
+    /**
+     * Sets file patterns to include in the source.
+     * Only used when no explicit source is provided via withSource.
+     */
+    withIncludes(includes) {
+        this._includes = includes;
+        return this;
+    }
+    /**
+     * Adds secrets available during the build step.
+     *
+     * @param secrets - Map of secret name to value
+     */
+    withSecrets(secrets) {
+        for (const [k, v] of secrets) {
+            if (!this._secrets.has(k)) {
+                this._secrets.set(k, v);
+            }
+        }
+        return this;
+    }
+    /**
+     * Sets an explicit ArtifactSource for the project.
+     * If not set, one is constructed from the name with any includes.
+     */
+    withSource(source) {
+        this._source = source;
+        return this;
+    }
+    /**
+     * Adds a script to run inside the source directory before the build.
+     * Multiple scripts are deduplicated and joined with newlines.
+     */
+    withSourceScript(script) {
+        if (!this._sourceScripts.includes(script)) {
+            this._sourceScripts.push(script);
+        }
+        return this;
+    }
+    /**
+     * Builds the Go project artifact.
+     *
+     * CRITICAL: The build script must be character-for-character identical
+     * to what the Rust SDK and Go SDK produce for the same inputs.
+     *
+     * @returns The artifact digest string
+     */
+    async build(context) {
+        // Build source
+        const sourcePath = ".";
+        let source;
+        if (this._source !== undefined) {
+            source = this._source;
+        }
+        else {
+            const sourceBuilder = new ArtifactSource(this._name, sourcePath);
+            if (this._includes.length > 0) {
+                sourceBuilder.withIncludes(this._includes);
+            }
+            source = sourceBuilder.build();
+        }
+        const sourceDir = `./source/${source.name}`;
+        // Build step script -- mirrors Rust SDK formatdoc! in go.rs lines 147-174
+        //
+        // The script is built incrementally to match the Rust SDK's formatdoc!
+        // concatenation pattern exactly:
+        //   1. pushd + mkdir
+        //   2. (optional) source scripts
+        //   3. go build + go clean
+        let stepScript = `pushd ${sourceDir}\n\nmkdir -p $VORPAL_OUTPUT/bin`;
+        if (this._sourceScripts.length > 0) {
+            const sourceScripts = this._sourceScripts.join("\n");
+            stepScript = `${stepScript}\n\n${sourceScripts}`;
+        }
+        stepScript =
+            `${stepScript}\n\n` +
+                `go build -C ${this._buildDirectory} -o $VORPAL_OUTPUT/bin/${this._name} ${this._buildFlags} ${this._buildPath}\n\n` +
+                `go clean -modcache`;
+        // Fetch tool artifacts
+        const git = await context.fetchArtifactAlias("git:2.53.0");
+        const go = await context.fetchArtifactAlias("go:1.26.0");
+        // Compute GOOS and GOARCH
+        const goarch = getGoarch(context.getSystem());
+        const goos = getGoos(context.getSystem());
+        // Build step environments
+        const stepEnvironments = [
+            `GOARCH=${goarch}`,
+            "GOCACHE=$VORPAL_WORKSPACE/go/cache",
+            `GOOS=${goos}`,
+            "GOPATH=$VORPAL_WORKSPACE/go",
+            `PATH=${getEnvKey(go)}/bin`,
+        ];
+        for (const env of this._environments) {
+            stepEnvironments.push(env);
+        }
+        // Create step
+        const stepArtifacts = [git, go, ...this._artifacts];
+        const step = await shell(context, stepArtifacts, stepEnvironments, stepScript, secretsToProto(this._secrets));
+        // Create and return artifact
+        return new Artifact(this._name, [step], this._systems)
+            .withAliases(this._aliases)
+            .withSources([source])
+            .build(context);
+    }
+}
+// ---------------------------------------------------------------------------
+// Go Development Environment
+// ---------------------------------------------------------------------------
+// Default tool aliases -- centralized so version bumps happen in one place
+const DEFAULT_GO_ALIAS = "go:1.26.0";
+const DEFAULT_GIT_ALIAS = "git:2.53.0";
+const DEFAULT_GOIMPORTS_ALIAS = "goimports:0.42.0";
+const DEFAULT_GOPLS_ALIAS = "gopls:0.42.0";
+const DEFAULT_PROTOC_ALIAS = "protoc:34.0";
+const DEFAULT_PROTOC_GEN_GO_ALIAS = "protoc-gen-go:1.36.11";
+const DEFAULT_PROTOC_GEN_GO_GRPC_ALIAS = "protoc-gen-go-grpc:1.79.1";
+const DEFAULT_STATICCHECK_ALIAS = "staticcheck:2026.1";
+/**
+ * Builder for Go development environment artifacts.
+ *
+ * Provides a pre-configured Go development environment with standard
+ * tooling (Go, Git, goimports, gopls, protoc, staticcheck) and
+ * platform-specific environment variables (CGO_ENABLED, GOARCH, GOOS).
+ *
+ * Usage:
+ * ```typescript
+ * const digest = await new GoDevelopmentEnvironment("my-shell", SYSTEMS)
+ *   .build(context);
+ * ```
+ */
+export class GoDevelopmentEnvironment {
+    _artifacts = [];
+    _environments = [];
+    _name;
+    _secrets = new Map();
+    _systems;
+    // Flags to include/exclude optional default tools
+    _includeProtoc = true;
+    _includeProtocGenGo = true;
+    _includeProtocGenGoGrpc = true;
+    constructor(name, systems) {
+        this._name = name;
+        this._systems = systems;
+    }
+    /**
+     * Adds extra artifact dependencies beyond the default Go tooling.
+     * These are appended to the default artifacts, not replacing them.
+     */
+    withArtifacts(artifacts) {
+        this._artifacts.push(...artifacts);
+        return this;
+    }
+    /**
+     * Adds extra environment variables beyond the default Go environment.
+     * Format: "KEY=VALUE".
+     * These are appended to the defaults (CGO_ENABLED, GOARCH, GOOS).
+     */
+    withEnvironments(environments) {
+        this._environments.push(...environments);
+        return this;
+    }
+    /** Exclude protoc and its Go plugins from the default tooling. */
+    withoutProtoc() {
+        this._includeProtoc = false;
+        this._includeProtocGenGo = false;
+        this._includeProtocGenGoGrpc = false;
+        return this;
+    }
+    /** Adds secrets available during the environment build step. */
+    withSecrets(secrets) {
+        for (const [k, v] of secrets) {
+            if (!this._secrets.has(k)) {
+                this._secrets.set(k, v);
+            }
+        }
+        return this;
+    }
+    /**
+     * Builds the Go development environment artifact.
+     *
+     * Default artifacts fetched:
+     * - go (Go toolchain)
+     * - git
+     * - goimports
+     * - gopls (Go language server)
+     * - protoc (if not excluded)
+     * - protoc-gen-go (if not excluded)
+     * - protoc-gen-go-grpc (if not excluded)
+     * - staticcheck
+     *
+     * Default environment variables:
+     * - CGO_ENABLED=0
+     * - GOARCH={platform-specific}
+     * - GOOS={platform-specific}
+     */
+    async build(context) {
+        // Fetch default tool artifacts
+        const go = await context.fetchArtifactAlias(DEFAULT_GO_ALIAS);
+        const git = await context.fetchArtifactAlias(DEFAULT_GIT_ALIAS);
+        const goimports = await context.fetchArtifactAlias(DEFAULT_GOIMPORTS_ALIAS);
+        const gopls = await context.fetchArtifactAlias(DEFAULT_GOPLS_ALIAS);
+        const staticcheck = await context.fetchArtifactAlias(DEFAULT_STATICCHECK_ALIAS);
+        const artifacts = [git, go, goimports, gopls];
+        if (this._includeProtoc) {
+            const protoc = await context.fetchArtifactAlias(DEFAULT_PROTOC_ALIAS);
+            artifacts.push(protoc);
+        }
+        if (this._includeProtocGenGo) {
+            const protocGenGo = await context.fetchArtifactAlias(DEFAULT_PROTOC_GEN_GO_ALIAS);
+            artifacts.push(protocGenGo);
+        }
+        if (this._includeProtocGenGoGrpc) {
+            const protocGenGoGrpc = await context.fetchArtifactAlias(DEFAULT_PROTOC_GEN_GO_GRPC_ALIAS);
+            artifacts.push(protocGenGoGrpc);
+        }
+        artifacts.push(staticcheck);
+        artifacts.push(...this._artifacts);
+        // Compute platform-specific environment variables
+        const goarch = getGoarch(context.getSystem());
+        const goos = getGoos(context.getSystem());
+        const environments = [
+            "CGO_ENABLED=0",
+            `GOARCH=${goarch}`,
+            `GOOS=${goos}`,
+            ...this._environments,
+        ];
+        // Delegate to DevelopmentEnvironment
+        let devenv = new DevelopmentEnvironment(this._name, this._systems)
+            .withArtifacts(artifacts)
+            .withEnvironments(environments);
+        if (this._secrets.size > 0) {
+            devenv = devenv.withSecrets(this._secrets);
+        }
+        return devenv.build(context);
+    }
+}
+//# sourceMappingURL=go.js.map

package/dist/artifact/language/go.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"go.js","sourceRoot":"","sources":["../../../src/artifact/language/go.ts"],"names":[],"mappings":"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"}

package/dist/artifact/language/rust.d.ts

@@ -0,0 +1,136 @@
+import { ArtifactSystem } from "../../api/artifact/artifact.js";
+import type { ConfigContext } from "../../context.js";
+/**
+ * Maps an ArtifactSystem enum to the Rust target triple.
+ * Matches `sdk/go/pkg/artifact/rust_toolchain.go` RustToolchainTarget().
+ */
+export declare function rustToolchainTarget(system: ArtifactSystem): string;
+/**
+ * Builder for Rust/Cargo project artifacts.
+ *
+ * Analogous to:
+ * - Rust SDK: `sdk/rust/src/artifact/language/rust.rs` (`Rust` struct)
+ * - Go SDK: `sdk/go/pkg/artifact/language/rust.go` (`Rust` struct)
+ *
+ * The builder:
+ * 1. Fetches the rust-toolchain artifact from the registry
+ * 2. Fetches the protoc artifact from the registry
+ * 3. Parses the Cargo.toml workspace to identify packages, bins, and targets
+ * 4. Creates a vendor artifact that runs `cargo vendor`
+ * 5. Creates the main build artifact with `cargo build --release`
+ *
+ * Usage:
+ * ```typescript
+ * const digest = await new Rust("vorpal", SYSTEMS)
+ *   .withPackages(["vorpal-cli"])
+ *   .withBins(["vorpal"])
+ *   .build(context);
+ * ```
+ */
+export declare class Rust {
+    private _aliases;
+    private _artifacts;
+    private _bins;
+    private _build;
+    private _check;
+    private _environments;
+    private _excludes;
+    private _format;
+    private _includes;
+    private _lint;
+    private _name;
+    private _packages;
+    private _secrets;
+    private _source;
+    private _systems;
+    private _tests;
+    constructor(name: string, systems: ArtifactSystem[]);
+    /** Sets aliases for the artifact. */
+    withAliases(aliases: string[]): this;
+    /** Adds artifact dependencies available during the build step. */
+    withArtifacts(artifacts: string[]): this;
+    /** Sets the binary targets to build. If empty, defaults to the builder name. */
+    withBins(bins: string[]): this;
+    /** Enables or disables `cargo check` during the build step. */
+    withCheck(check: boolean): this;
+    /** Sets additional environment variables for the build step. Format: "KEY=VALUE". */
+    withEnvironments(environments: string[]): this;
+    /** Sets file patterns to exclude from the source. */
+    withExcludes(excludes: string[]): this;
+    /** Enables or disables `cargo fmt --check` during the build step. */
+    withFormat(format: boolean): this;
+    /** Sets file patterns to include in the source. */
+    withIncludes(includes: string[]): this;
+    /** Enables or disables `cargo clippy` during the build step. */
+    withLint(lint: boolean): this;
+    /** Filters which workspace packages to include in the build. */
+    withPackages(packages: string[]): this;
+    /**
+     * Adds secrets available during the build step.
+     *
+     * @param secrets - Map of secret name to value
+     */
+    withSecrets(secrets: Map<string, string>): this;
+    /** Sets the source path relative to the artifact context directory. */
+    withSource(source: string): this;
+    /** Enables or disables `cargo test` during the build step. */
+    withTests(tests: boolean): this;
+    /**
+     * Builds the Rust project artifact.
+     *
+     * @returns The artifact digest string
+     */
+    build(context: ConfigContext): Promise<string>;
+}
+/**
+ * Builder for Rust development environment artifacts.
+ *
+ * Provides a pre-configured Rust development environment with the Rust
+ * toolchain (cargo, rustc, clippy, rustfmt, rust-analyzer, etc.) and
+ * optionally protoc. Computes platform-specific environment variables
+ * (PATH, RUSTUP_HOME, RUSTUP_TOOLCHAIN) automatically.
+ *
+ * Usage:
+ * ```typescript
+ * const digest = await new RustDevelopmentEnvironment("my-shell", SYSTEMS)
+ *   .build(context);
+ * ```
+ */
+export declare class RustDevelopmentEnvironment {
+    private _artifacts;
+    private _environments;
+    private _name;
+    private _secrets;
+    private _systems;
+    private _includeProtoc;
+    constructor(name: string, systems: ArtifactSystem[]);
+    /**
+     * Adds extra artifact dependencies beyond the default Rust tooling.
+     * These are appended to the default artifacts, not replacing them.
+     */
+    withArtifacts(artifacts: string[]): this;
+    /**
+     * Adds extra environment variables beyond the default Rust environment.
+     * Format: "KEY=VALUE".
+     * These are appended to the defaults (PATH, RUSTUP_HOME, RUSTUP_TOOLCHAIN).
+     */
+    withEnvironments(environments: string[]): this;
+    /** Exclude protoc from the default tooling. */
+    withoutProtoc(): this;
+    /** Adds secrets available during the environment build step. */
+    withSecrets(secrets: Map<string, string>): this;
+    /**
+     * Builds the Rust development environment artifact.
+     *
+     * Default artifacts fetched:
+     * - rust-toolchain (includes cargo, rustc, clippy, rustfmt, rust-analyzer, etc.)
+     * - protoc (if not excluded)
+     *
+     * Default environment variables:
+     * - PATH={rust-toolchain}/toolchains/{version}-{target}/bin
+     * - RUSTUP_HOME={rust-toolchain}
+     * - RUSTUP_TOOLCHAIN={version}-{target}
+     */
+    build(context: ConfigContext): Promise<string>;
+}
+//# sourceMappingURL=rust.d.ts.map

package/dist/artifact/language/rust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rust.d.ts","sourceRoot":"","sources":["../../../src/artifact/language/rust.ts"],"names":[],"mappings":"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"}