feat(release): ship the embedded package runtime in every archive - #42
Merged
Conversation
robinbraemer
force-pushed
the
feat/pkg-subcommand
branch
2 times, most recently
from
August 14, 2026 19:57
51bf24e to
31cf83d
Compare
Every release archive now bundles the target-native Akuapkg runtime under node_modules/@akua-dev next to the akua executable, so a clean install can run the full `akua pkg` flow offline from one download. Install docs, release smoke, and CI matrices exercise `akua pkg version` and an init → check → render → inspect flow per target. Also updates the stale usage-error regression: interactive flag errors render the structured stdout usage_error contract (exit 2), not raw Effect CLI stderr text; main CI never ran to catch it because runner-group access is pending. Rationale: agents must get cloud commands and package tooling from one installable artifact; a runtime resolved at first use would break offline and pinned-version guarantees. Rejected: publishing akuapkg separately per platform and lazy-downloading at runtime — breaks provenance and adds a network dependency to first render. Tested: bun install --frozen-lockfile; bun test (151 pass); bun run build (tsc --noEmit + bundle); bun run generate:check; local smoke akua pkg version / pkg --help. Not-tested: release archive smoke on non-host targets (runs in release CI).
Point AGENTS.md at node_modules/effect/AGENTS.md and effect/src as the required first read before writing Effect code, per the effect-ts setup skill.
robinbraemer
force-pushed
the
feat/pkg-subcommand
branch
from
August 14, 2026 21:24
31cf83d to
014e521
Compare
The merged non-TTY structured-output fix makes piped runs forward --json to embedded pkg invocations, which is the intended agent behavior; this test asserts the interactive arg passthrough, so it now pins stdoutIsTTY: true. Rationale: keep the embed test about arg forwarding, not output-mode selection. Tested: bun test (164 pass, 0 fail).
Replaces the /tmp symlink workaround from earlier local iteration with the published package. Pinned to ^0.9.4 — 0.9.3 shipped without dist/execute.js (akua-dev/akuapkg#100 fixed the publish pipeline). Rationale: akua pkg needs the real npm package to install correctly for end users; the symlink only worked on this machine. Tested: bun test (164 pass); bun run build; bun run generate:check; bun -e "import('@akua-dev/sdk/execute')" resolves; akua pkg version prints 0.9.4 end to end.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Bundles the target-native Akuapkg runtime under
node_modules/@akua-devnext to theakuaexecutable in every release archive, so a clean install runs the fullakua pkgflow (init → check → render → inspect) offline from one download.scripts/runtime/release-*) stages the per-target runtime and verifies it in the archive manifest and smoke.libexec-style install with a symlinked executable).--os='*' --cpu='*'so cross-target runtimes are available for packaging.usage_errorcontract (exit 2); main CI never ran to catch it because runner-group access for this repo is still pending.Local verification:
bun test(151 pass),bun run build(tsc + bundle),bun run generate:check, smokeakua pkg version/akua pkg --help.Note: CI in this repo is currently blocked — jobs queue on
akua-x64-ci-v2/akua-heavy-ci-v2because theagentos-cirunner group has not been granted to this repository yet.🤖 Generated with Claude Code