Distillation

Date: Aug 27, 2026

• 🟡 (16:04) src/utils/helpers.ts exports MAX_STEP_OUTPUT_BYTES = 64 * 1024; this limit is intended to avoid Linux E2BIG errors when GitHub Actions expands step outputs into later-step environment variables and to remain below GitHub’s approximately 65,536-character issue-body limit.
• 🟡 (16:04) src/utils/helpers.ts defines envToBool(envVar) using falsy values '', 'undefined', 'null', '0', 'false', and 'no' after lowercasing String(envVar).
• 🟡 (16:04) In src/utils/helpers.ts, when --workspace occurs multiple times, the final occurrence controls selection; an empty/bare final occurrence clears an earlier CLI value and falls back to CRAFT_WORKSPACE.
• 🟡 (16:04) src/utils/helpers.ts defines global flags 'dry-run', 'no-input', and 'log-level', initialized respectively to false, false, and 'Info'; setGlobals() updates supplied values, traces flags/argv, and calls setLevel(LogLevel[GLOBAL_FLAGS['log-level']]).
• 🟡 (16:04) promptConfirmation() in src/utils/helpers.ts prompts Is everything OK? Type "yes" to proceed: when input is enabled; validation requires at least 2 characters, only case-insensitive yes proceeds, and all other responses log Oh, okay. Aborting. then call process.exit(1). With no-input, it logs Skipping the confirmation prompt.
• 🟡 (16:04) setGitHubActionsOutput(name, value) in src/utils/helpers.ts is a no-op without GITHUB_OUTPUT; it appends single-line values as ${name}=${value}\n and multiline values using a randomized EOF_${Date.now()}_${Math.random().toString(36).slice(2)} heredoc delimiter.
• 🟡 (16:04) writeGitHubActionsFile(name, content) in src/utils/helpers.ts is a no-op without RUNNER_TEMP; otherwise it creates ${RUNNER_TEMP}/craft, writes UTF-8 content to ${name}.md, sets output ${name}_file to the absolute path, and returns that path.
• 🟡 (16:04) truncateForOutput(value, changelogUrl?) in src/utils/helpers.ts returns values at or below MAX_STEP_OUTPUT_BYTES unchanged; oversized UTF-8 content is byte-safely truncated to leave room for either \n\n---\n*Changelog truncated.* or \n\n---\n*Changelog truncated. [View full changelog](${changelogUrl}).*.
• 🟡 (16:05) src/utils/__tests__/helpers.test.ts contains extractWorkspaceSelection coverage for no selection, separate CLI values, inline values, inline dash-prefixed values (--workspace=-cli), separate dash-prefixed tokens, CLI-versus-CRAFT_WORKSPACE precedence, repeated workspace flags, bare --workspace before another option, bare --workspace at end, and empty inline --workspace=.
• 🟡 (16:05) src/index.ts imports extractWorkspaceSelection and setActiveWorkspace; comments identify extractWorkspaceSelection(argv) as the source of truth for selection, and index.ts calls setActiveWorkspace(extractWorkspaceSelection(argv)).
• 🟡 (16:05) src/__tests__/config.test.ts includes tests for resetting with setActiveWorkspace(undefined), selecting cli and mcp, unknown selection nope, and re-resolving configuration when changing active workspace from cli to mcp.