Distillation

Date: September 10, 2026

• 🔴 (03:29) User directed the workspace template-to-regex logic to “Replace template markers with placeholders.”
• 🔴 (03:29) User directed the workspace template-to-regex logic to “Replace placeholders with escaped values (or regex pattern for version).”
• 🔴 (03:29) Workspace regex-template handling uses NAME_PLACEHOLDER = '\x00NAME\x00', SIMPLE_PLACEHOLDER = '\x00SIMPLE\x00', and VERSION_PLACEHOLDER = '\x00VERSION\x00'; it temporarily replaces {{name}}, {{simpleName}}, and {{version}}, escapes the surrounding template, then substitutes escaped packageName, escaped simpleName, and versionValue. The default version pattern '\\d.*' is preserved as-is; other version values pass through escapeRegex(version).
• 🔴 (03:29) src/utils/workspaces.ts supports npm, Yarn, and pnpm workspace discovery. discoverWorkspaces() checks pnpm first via pnpm-workspace.yaml, then npm/Yarn via the root package.json; npm versus Yarn is distinguished by the presence of yarn.lock.
• 🔴 (03:29) WorkspacePackage contains name, absolute location, private, hasPublicAccess, and workspaceDependencies; WorkspaceDiscoveryResult.type is 'npm' | 'yarn' | 'pnpm' | 'none'.
• 🔴 (03:29) resolveWorkspaceGlobs() first collects all workspace package names and locations, then resolves workspaceDependencies by filtering all dependency names against the known workspace-name set.
• 🔴 (03:29) topologicalSortPackages() orders dependencies before dependents by computing each package’s depth as 1 + max depth of dependencies; a cycle throws Circular dependency detected among workspace packages: ${cyclePackages.join(', ')}.
• 🟡 (03:29) Investigation found the pinned immutable Craft image resolves to Craft 2.30.1 with CRAFT_BUILD_SHA=cd1e8294061fd970b40d98b77aaa109cb1e00e78. The expected craft workspace list command is not implemented and exits with Unknown commands: workspace, list; consequently, every target checkout having a root .craft.yml would fail before publication when the new discovery path invokes that command.
• 🔴 (03:29) The Craft CLI currently registers prepare, publish, targets, config, artifacts, and changelog, but no workspace command. Global flags include --no-input, --dry-run, --log-level, -v/--version, and -h/--help.
• 🔴 (03:29) --dry-run means “no file writes, commits, pushes, or API mutations”; it currently defaults from process.env.DRY_RUN with a TODO to deprecate that in favor of CRAFT_DRY_RUN.
• 🔴 (03:29) CLI startup calls sanitizeDynamicLinkerEnv() before other main-flow work so LD_PRELOAD, DYLD_*, and related variables cannot leak into spawned subprocesses; it then prints the version, calls warnIfCraftEnvFileExists(), preprocesses global Boolean flags with fixGlobalBooleanFlags(), and parses through yargs.
• 🔴 (03:30) Publish resume state was moved out of the repository from .craft-publish-<version>.json to $XDG_STATE_HOME/craft/, falling back to $HOME/.local/state/craft/, preventing committed repository content or earlier CI steps from pre-populating the published-target set and silently skipping targets.
• 🔴 (03:30) getCraftStateDir() returns join(process.env.XDG_STATE_HOME, 'craft') when XDG_STATE_HOME is nonempty; otherwise it returns join(homedir(), '.local', 'state', 'craft').
• 🔴 (03:30) getPublishStateFilename(version, githubConfig, cwd) uses publish-state-<owner>-<repo>-<sha1(cwd)[:12]>-<version>.json when GitHub config is available. Without GitHub config, it uses publish-state-<sha256(cwd)[:16]>-<version>.json.
• 🔴 (03:30) Publish-state filename components are sanitized by lowercasing, replacing characters outside [a-z0-9._-] with _, and trimming leading/trailing underscores. The cwd hash disambiguates monorepo subpaths such as packages/foo and packages/bar.
• 🔴 (03:30) getPublishStatePath(version, githubConfig, cwd = process.cwd()) joins getCraftStateDir() with getPublishStateFilename(version, githubConfig, cwd). In the getsentry/publish Docker image, HOME=/root, making the XDG state location workflow-writable but unreachable by committed repository contents.
• 🔴 (03:30) The Craft executable resolves to /usr/local/bin/craft; it is executable, owned by root:root, has size 9689940 bytes, and carries timestamp Aug 8 00:33.