Distillation

Date: Aug 27, 2026

• 🟡 (13:31) publish-workspace-acceptance/AGENTS.md identifies this repository as the Sentry Publish Repository: a GitHub Actions-based approval system for publishing releases across multiple Sentry projects using Craft; it is a pure JavaScript CommonJS project pinned via Volta to Node.js 24.0.0.
• 🟡 (13:31) Sentry Publish Repository package-management directive: use Yarn classic 1.22.22, managed by Volta; do not use npm. Commands: yarn install, yarn test, yarn test:watch, yarn test src/modules/__tests__/update-issue.js, yarn test -t "pattern", yarn lint, and yarn prettier.
• 🟡 (13:31) Sentry Publish Repository single-test commands support file path (yarn test src/modules/__tests__/update-issue.js), test-name matching (yarn test -t "transformIssueBody"), or both (yarn test src/modules/__tests__/update-issue.js -t "specific test name").
• 🟡 (13:31) Sentry Publish Repository source layout: src/libs/ contains shared utilities and __tests__/; src/modules/ contains reusable core business logic and __tests__/; src/publish/ contains GitHub Actions entry points.
• 🟡 (13:31) Sentry Publish Repository code conventions: files use kebab-case (e.g. details-from-context.js, update-issue.js); tests are in __tests__/ with the source filename; variables/functions use camelCase (e.g. detailsFromContext, publishRepo); constants and regexes use UPPER_SNAKE_CASE (e.g. TARGETS_SECTION_PARSER_REGEX).
• 🟡 (13:31) Sentry Publish Repository module and formatting conventions: source files use CommonJS require/module.exports; test files use ES Modules import/export; imports order Node built-ins, external packages, then local modules; multiple exports prefer module.exports = { functionA, functionB }; default single exports use module.exports = functionName; Prettier default settings require double-quoted strings and semicolons; run yarn prettier before committing.
• 🔴 (13:31) User directive: always throw for unexpected values, including a default branch in switch statements that throws a descriptive error such as new Error(\Unknown status: '${status}'`)`.
• 🟡 (13:31) Sentry Publish Repository error-handling conventions: throw descriptive errors containing failure context and potential fixes; use early guard clauses for input validation (e.g. throw new Error("Issue context is not defined") when issue context is absent); check file existence with fs.existsSync(CRAFT_STATE_FILE_PATH) before reading and return if missing.
• 🟡 (13:31) Sentry Publish Repository testing uses Vitest v4.0.0 with globals enabled; describe, test, and expect need not be imported; mocks are auto-cleared between tests. Mock external dependencies with vi.mock() before requiring the module under test; supports mock implementations and inline snapshots via toMatchInlineSnapshot().
• 🟡 (13:31) Sentry Publish Repository key dependencies are @actions/core (GitHub Actions inputs, outputs, logging), @actions/github (GitHub API client for Actions), and @sentry/node (error reporting). Common patterns include parallel await Promise.all([operation1(), operation2()]), destructuring, object spread merging, template literals, and named-group regexes such as /(?<name>\w+): (?<value>.+)/.
• 🟡 (13:31) Tool output showed Craft history headed by 6dae341 feat: propagate release workspaces, preceded by 21270a1 feat(config): add release workspaces; that change spans 24 files with 1,265 insertions and 402 deletions, including .github/workflows/release.yml, action.yml, package.json, pnpm-lock.yaml, src/commands/publish.ts, src/config.ts, src/index.ts, src/schemas/project_config.ts, src/targets/registry.ts, src/targets/vercel.ts, src/utils/git.ts, src/utils/helpers.ts, and src/utils/publishState.ts, plus related tests.
• 🟡 (13:31) Tool command comparing master..HEAD failed: fatal: ambiguous argument 'master..HEAD': unknown revision or path not in the working tree; suggested syntax was git <command> [<revision>...] -- [<file>...].
• 🟡 (13:31) In publish-workspace-acceptance, current branch is feat/workspace-acceptance; local branches include chore/fix-security-advisories, fix/add-workflow-permissions, main, opencode/tidy-orchid, security/dual-write-publish-state, and security/remove-legacy-publish-state-write; origin/HEAD points to origin/main.
• 🟡 (13:31) feat/workspace-acceptance recent commits are b658ffa fix: validate publish workspace JSON and 33de3f1 feat: accept workspace publish requests; earlier commits include 5268a23 feat: Add Vercel creds, 92eba3f feat: Add CLOUDFLARE_API_TOKEN (#9122), a4f961a fix: Add GITHUB_API_TOKEN for commit-on-git target (#9069), and dependency/security updates.
• 🔴 (13:31) User stated a codebase change: replace deprecated trimRight() with trimEnd() (#9012).
• 🟡 (13:31) Workspace-acceptance changes affect 9 files with 488 insertions and 41 deletions: .github/workflows/cocoapods-keepalive.yml, .github/workflows/publish.yml, README.md, docs/publish-issue-format.md, src/modules/__tests__/details-from-context.js, src/modules/__tests__/publish-workflow.js, src/modules/__tests__/update-issue.js, src/modules/details-from-context.js, and src/modules/update-issue.js.