Version 1.0.0

[threeal]

What's Changed

Breaking Changes

• Package renamed from gha-utils to ghakit.
• Split into subpath exports. The package no longer has a default export. Import from the appropriate subpath instead:
  • ghakit/exec — running child processes
  • ghakit/io — reading inputs/state and writing outputs/env/path
  • ghakit/log — logging workflow commands
  • ghakit/vars — reading default GitHub Actions environment variables
• getInput and getState no longer trim whitespace from the returned value. The raw env var value is returned as-is

New Features

• ghakit/exec — new module with an exec(command, args, opts?) function for running child processes. Supports independent output modes per stream and returns captured output as strings when the mode is "capture".
• ghakit/vars — new typed getter functions for every default GitHub Actions variable (e.g. getGitHubRepository(), getRunnerOs(), getGitHubRunNumber()). Boolean variables return boolean, numeric variables return number, context-specific optional variables return string | undefined, and all others return string.
• logNotice — new log function that writes a ::notice:: workflow command, matching the existing logWarning and logError functions.
• Annotation options (title, file, line, endLine, col, endColumn) can now be passed to logNotice, logWarning, and logError.
• addLogMask — new function that writes ::add-mask:: to mask a value in all subsequent log output.
• stopCommands / resumeCommands — new functions that write ::stop-commands:: and the corresponding resume token command to bracket sections where workflow command syntax should not be interpreted.
• engines field added to package.json specifying the minimum supported Node.js version.

Development Tooling Changes

• Migrated from Yarn to pnpm as the package manager.
• Switched test runner from Jest to Vitest (currently on Vitest v4).
• Integrated Lefthook for pre-commit hooks (type-check, format, lint, and docs validation run automatically before each commit).
• Migrated to @tsconfig/node24 base TypeScript configuration; separated the build and source tsconfig.json files.
• Added prettier-plugin-organize-imports to automatically sort imports on format.
• Replaced tseslint.config with defineConfig in the ESLint config.
• Added a typedoc.json configuration file.
• Locked pnpm to version 10.
• Updated CI workflow to validate pre-commit hooks.
• Added CLAUDE.md for Claude Code project configuration.
• Bumped Node.js through versions 23.x → 24.14.1, TypeScript to 6.0, ESLint to 10.x, and many other dependencies.

Full Changelog: v0.4.1...v1.0.0

---

This discussion was created from the release Version 1.0.0.