Distillation

Date: Sep 3, 2026

• 🟡 (17:58) Inspected /home/byk/Code/getsentry/craft/src/utils/workspaces.ts (lines 1–290 of 425). The module imports readFileSync from fs, path, load from js-yaml, glob from glob, and logger from ../logger.
• 🟡 (17:58) src/utils/workspaces.ts defines WorkspacePackage with name, absolute location, private, hasPublicAccess, and workspaceDependencies; WorkspaceDiscoveryResult has type: 'npm' | 'yarn' | 'pnpm' | 'none' and packages.
• 🟡 (17:58) Workspace package parsing in src/utils/workspaces.ts: readPackageJson(packagePath) reads package.json, returns null on errors, and logs a warning except for ENOENT, detected by isNotFoundError(err) checking err instanceof Error, 'code' in err, and err.code === 'ENOENT'.
• 🟡 (17:58) getAllDependencyNames(packageJson) collects unique names from dependencies, peerDependencies, and optionalDependencies, explicitly excluding devDependencies because they do not need to be published first.
• 🟡 (17:58) extractWorkspacesGlobs(workspaces) supports both package.json workspace formats: a string[] directly or an object containing packages?: string[].
• 🟡 (17:58) resolveWorkspaceGlobs(rootDir, patterns) uses glob(pattern, { cwd: rootDir, absolute: true, ignore: ['**/node_modules/**'] }); it first collects package locations and all workspace names, then creates each package’s workspaceDependencies by filtering its publish-relevant dependency names against known workspace names.
• 🟡 (17:58) discoverNpmYarnWorkspaces(rootDir) obtains workspace globs from the root package.json; detects Yarn when yarn.lock exists via fileExists(path.join(rootDir, 'yarn.lock')), otherwise labels the workspace type npm; logs the discovered package count and globs.
• 🟡 (17:58) discoverPnpmWorkspaces(rootDir) reads and YAML-parses pnpm-workspace.yaml via load(content) as PnpmWorkspaceConfig; returns null on missing, unparsable, or empty packages configuration, logs parse warnings except for ENOENT, and logs discovered package count and patterns.
• 🟡 (17:58) discoverWorkspaces(rootDir) prioritizes discoverPnpmWorkspaces(rootDir) over discoverNpmYarnWorkspaces(rootDir) because pnpm detection is more specific; if neither succeeds, returns { type: 'none', packages: [] }.
• 🟡 (17:58) packageNameToArtifactPattern(packageName) strips a leading @, replaces / with -, and returns the regex-pattern string `/^${normalized}-\\d.*\\.tgz$/`; documented examples are @sentry/browser -> sentry-browser-\d.*\.tgz and @sentry-internal/browser-utils -> sentry-internal-browser-utils-\d.*\.tgz.
• 🟡 (17:58) escapeRegex(str) in src/utils/workspaces.ts escapes regex-special characters using str.replace(/[.*+?^${}()|[\]\\/]/g, '\\$&'). The subsequent template-based artifact-filename conversion documentation specifies {{name}}, {{simpleName}}, and {{version}} template variables, but its implementation was outside the displayed lines.