Distillation

Date: Aug 27, 2026

• 🟡 (13:30) Tool listed /home/byk/Code/getsentry/publish-workspace-acceptance as a directory with 14 entries: .eslintrc.js, .git, .github/, .gitignore, AGENTS.md, auto-approve-repos.txt, docs/, LICENSE, node_modules/, package.json, README.md, src/, vitest.config.js, yarn.lock.
• 🔴 (13:30) User directive for the Craft codebase: always use pnpm for package management; never use npm or yarn.
• 🟡 (13:30) craft-workspace-action-propagation/AGENTS.md specifies Node.js is managed by Volta at v22.12.0; install dependencies with pnpm install --frozen-lockfile.
• 🟡 (13:30) Craft development commands: pnpm build builds to dist/craft; pnpm test runs tests; pnpm lint runs ESLint; pnpm fix auto-fixes lint issues; manual change testing uses pnpm build && ./dist/craft.
• 🟡 (13:30) Craft code style: TypeScript throughout; Prettier 3.x configured for single quotes and no arrow parentheses in .prettierrc.yml; ESLint 9.x flat configuration in eslint.config.mjs using typescript-eslint; _-prefixed unused variables such as _unusedParam are allowed.
• 🟡 (13:30) Craft project structure: src/__mocks__/ test mocks; src/__tests__/ *.test.ts test files; src/artifact_providers/, src/commands/, src/schemas/, src/status_providers/, src/targets/, src/types/, src/utils/; src/config.ts configuration loading; src/index.ts CLI entry point; src/logger.ts logging; dist/craft is the esbuild-generated single bundled executable.
• 🟡 (13:30) Craft tests use Vitest; tests reside in src/__tests__/ with *.test.ts names; run via pnpm test; use Vitest mock APIs vi.fn(), vi.mock(), and vi.spyOn().
• 🟡 (13:30) Craft CI/CD: main branch is master; CI tests Node.js 20 and 22; Craft releases itself using its own tooling (dogfooding).
• 🟡 (13:30) Craft configuration is .craft.yml at the repository root; its schema is in src/schemas/.
• 🟡 (13:30) Craft --dry-run mode prevents destructive operations through centralized dry-run-aware proxies rather than per-function isDryRun() checks: Git uses getGitClient() from src/utils/git.ts or createGitClient(directory); GitHub API uses getGitHubClient() from src/utils/githubApi.ts; file writes use safeFs from src/utils/dryRun.ts; other actions use safeExec() or safeExecSync() from src/utils/dryRun.ts.
• 🟡 (13:30) Craft ESLint dry-run enforcement uses no-restricted-imports to block direct simple-git imports and no-restricted-syntax to block new Octokit(); wrapper modules needing raw simple-git access use // eslint-disable-next-line no-restricted-imports -- This is the wrapper module before import simpleGit from 'simple-git';.
• 🟡 (13:30) For new Craft destructive operations: (1) use getGitClient() or createGitClient() for Git, whose mutating methods are automatically blocked; (2) use getGitHubClient() for GitHub, whose create*, update*, delete*, and upload* methods are automatically blocked; (3) use safeFs.writeFile(), safeFs.unlink(), etc. rather than raw fs; (4) wrap custom operations with safeExec(action, description).
• 🟡 (13:30) Craft explicit isDryRun() checks are reserved for commands with their own --dry-run flag (e.g. dart pub publish --dry-run in the pubDev target), operations needing mock data in dry-run mode, and UX optimizations such as skipping sleep timers.
• 🟡 (13:30) Craft long-term knowledge entries—gotchas, patterns, decisions, and architecture—are managed by lore and documented in repository-root .lore.md.