Danny Kim
063eb09750
Co-authored-by: Danny Kim <temeddix@gmail.com> Co-committed-by: Danny Kim <temeddix@gmail.com>
34 lines
2.0 KiB
Markdown
34 lines
2.0 KiB
Markdown
---
|
|
description: bot-agents migration decisions: live @main action for six repos, JSON profiles, Node 24.2+, lints with eslint-plugin-import-structure and explicit-types (concrete, absence)
|
|
---
|
|
|
|
Decisions for `commons/bot-agents` (Capsulizers Gitea), from the Deno to
|
|
Node + Vite+ migration (PR #20, `node-migration`, 2026-10-15/16):
|
|
|
|
- **Live action.** Six consumer repos use `commons/bot-agents@main`, so a merge
|
|
switches all of them at once. It changes only through a PR and a careful
|
|
review. Suggested before merging a risky change: tag the current `main`
|
|
(e.g. `deno-final`) as a rollback target and canary the branch from one
|
|
consumer (`uses: .../commons/bot-agents@<branch>`) on a throwaway PR.
|
|
- **Profiles are JSON.** `profiles.yml` became `profiles.json` with the same
|
|
content (encrypted `v1:` values unchanged), read with `JSON.parse`. That
|
|
removed the only runtime dependency (`@std/yaml`); keep it free of runtime
|
|
dependencies (`@eslint/core` and the other devDependencies serve only the
|
|
tooling).
|
|
- **Node 24.2+**, not 22: `src/post/index.ts` uses `import.meta.main`. There is no
|
|
`engines` (user decision 2026-10-18): the `node:24-bookworm` job image
|
|
decides the version ([[bot-agents-runtime-no-build]]).
|
|
- **Published lint plugins** (2026-10-18, after they reached npm):
|
|
`eslint-plugin-import-structure` (`modules` config) and
|
|
`eslint-plugin-explicit-types` (`concrete` and `absence` configs) are
|
|
devDependencies, enabled in `vite.config.ts` through their `all` configs.
|
|
`upper-snake-string-unions` was off while the user decided; since
|
|
2026-10-19 it is on and profile types, failure reasons, and anchor sides
|
|
are `UPPER_SNAKE` ([[enum-values-upper-snake]]). `eslint-plugin-lit-robust`
|
|
does not apply (no Lit).
|
|
- **Stricter input checks were accepted** in the migration: Gitea `/user` and
|
|
comment responses, the runtime manifest, and the outcome's profile type are
|
|
validated; some type errors became `TypeError` with the same messages.
|
|
- Merging is the user's call; the `bot` account's approval is required first
|
|
([[git-pr-workflow]]).
|