@gadicc/loom 0.0.0-oidc-bootstrap.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/NOTICE +6 -0
- package/README.md +448 -0
- package/THIRD_PARTY_NOTICES.md +25 -0
- package/db/drizzle-config.d.ts +20 -0
- package/db/drizzle-config.js +34 -0
- package/db/fixtures.d.ts +31 -0
- package/db/fixtures.js +52 -0
- package/db/neon.d.ts +3 -0
- package/db/neon.js +20 -0
- package/db/neonFull.d.ts +12 -0
- package/db/neonFull.js +33 -0
- package/db/package.json +3 -0
- package/db/testing.d.ts +26 -0
- package/db/testing.js +76 -0
- package/db/testing.test.ts +28 -0
- package/db/valibot.d.ts +23 -0
- package/db/valibot.js +8 -0
- package/esm/_dnt.polyfills.d.ts +149 -0
- package/esm/_dnt.polyfills.d.ts.map +1 -0
- package/esm/_dnt.polyfills.js +163 -0
- package/esm/_dnt.shims.d.ts +2 -0
- package/esm/_dnt.shims.d.ts.map +1 -0
- package/esm/_dnt.shims.js +57 -0
- package/esm/bin/loom.d.ts +2 -0
- package/esm/bin/loom.d.ts.map +1 -0
- package/esm/bin/loom.js +11 -0
- package/esm/mod.d.ts +9 -0
- package/esm/mod.d.ts.map +1 -0
- package/esm/mod.js +8 -0
- package/esm/package.json +3 -0
- package/esm/src/apiKeys/authorize.d.ts +4 -0
- package/esm/src/apiKeys/authorize.d.ts.map +1 -0
- package/esm/src/apiKeys/authorize.js +184 -0
- package/esm/src/apiKeys/country.d.ts +3 -0
- package/esm/src/apiKeys/country.d.ts.map +1 -0
- package/esm/src/apiKeys/country.js +7 -0
- package/esm/src/apiKeys/credentials.d.ts +4 -0
- package/esm/src/apiKeys/credentials.d.ts.map +1 -0
- package/esm/src/apiKeys/credentials.js +55 -0
- package/esm/src/apiKeys/fingerprint.d.ts +3 -0
- package/esm/src/apiKeys/fingerprint.d.ts.map +1 -0
- package/esm/src/apiKeys/fingerprint.js +5 -0
- package/esm/src/apiKeys/mod.d.ts +9 -0
- package/esm/src/apiKeys/mod.d.ts.map +1 -0
- package/esm/src/apiKeys/mod.js +8 -0
- package/esm/src/apiKeys/policy.d.ts +59 -0
- package/esm/src/apiKeys/policy.d.ts.map +1 -0
- package/esm/src/apiKeys/policy.js +88 -0
- package/esm/src/apiKeys/retention.d.ts +55 -0
- package/esm/src/apiKeys/retention.d.ts.map +1 -0
- package/esm/src/apiKeys/retention.js +65 -0
- package/esm/src/apiKeys/types.d.ts +175 -0
- package/esm/src/apiKeys/types.d.ts.map +1 -0
- package/esm/src/apiKeys/types.js +1 -0
- package/esm/src/cli/externalSkills.d.ts +39 -0
- package/esm/src/cli/externalSkills.d.ts.map +1 -0
- package/esm/src/cli/externalSkills.js +177 -0
- package/esm/src/cli/mod.d.ts +337 -0
- package/esm/src/cli/mod.d.ts.map +1 -0
- package/esm/src/cli/mod.js +9268 -0
- package/esm/src/cli/projectSkills.d.ts +102 -0
- package/esm/src/cli/projectSkills.d.ts.map +1 -0
- package/esm/src/cli/projectSkills.js +592 -0
- package/esm/src/files/client.d.ts +29 -0
- package/esm/src/files/client.d.ts.map +1 -0
- package/esm/src/files/client.js +41 -0
- package/esm/src/files/errors.d.ts +37 -0
- package/esm/src/files/errors.d.ts.map +1 -0
- package/esm/src/files/errors.js +66 -0
- package/esm/src/files/hash.d.ts +15 -0
- package/esm/src/files/hash.d.ts.map +1 -0
- package/esm/src/files/hash.js +82 -0
- package/esm/src/files/memory.d.ts +29 -0
- package/esm/src/files/memory.d.ts.map +1 -0
- package/esm/src/files/memory.js +109 -0
- package/esm/src/files/metadata.d.ts +10 -0
- package/esm/src/files/metadata.d.ts.map +1 -0
- package/esm/src/files/metadata.js +186 -0
- package/esm/src/files/mod.d.ts +10 -0
- package/esm/src/files/mod.d.ts.map +1 -0
- package/esm/src/files/mod.js +9 -0
- package/esm/src/files/s3.d.ts +29 -0
- package/esm/src/files/s3.d.ts.map +1 -0
- package/esm/src/files/s3.js +107 -0
- package/esm/src/files/service.d.ts +27 -0
- package/esm/src/files/service.d.ts.map +1 -0
- package/esm/src/files/service.js +136 -0
- package/esm/src/files/types.d.ts +134 -0
- package/esm/src/files/types.d.ts.map +1 -0
- package/esm/src/files/types.js +1 -0
- package/esm/src/jobs/catalog.d.ts +32 -0
- package/esm/src/jobs/catalog.d.ts.map +1 -0
- package/esm/src/jobs/catalog.js +208 -0
- package/esm/src/jobs/controller.d.ts +28 -0
- package/esm/src/jobs/controller.d.ts.map +1 -0
- package/esm/src/jobs/controller.js +95 -0
- package/esm/src/jobs/direct.d.ts +36 -0
- package/esm/src/jobs/direct.d.ts.map +1 -0
- package/esm/src/jobs/direct.js +122 -0
- package/esm/src/jobs/events.d.ts +15 -0
- package/esm/src/jobs/events.d.ts.map +1 -0
- package/esm/src/jobs/events.js +30 -0
- package/esm/src/jobs/format.d.ts +16 -0
- package/esm/src/jobs/format.d.ts.map +1 -0
- package/esm/src/jobs/format.js +183 -0
- package/esm/src/jobs/http.d.ts +22 -0
- package/esm/src/jobs/http.d.ts.map +1 -0
- package/esm/src/jobs/http.js +44 -0
- package/esm/src/jobs/log.d.ts +2 -0
- package/esm/src/jobs/log.d.ts.map +1 -0
- package/esm/src/jobs/log.js +10 -0
- package/esm/src/jobs/mod.d.ts +10 -0
- package/esm/src/jobs/mod.d.ts.map +1 -0
- package/esm/src/jobs/mod.js +9 -0
- package/esm/src/jobs/run.d.ts +20 -0
- package/esm/src/jobs/run.d.ts.map +1 -0
- package/esm/src/jobs/run.js +57 -0
- package/esm/src/jobs/types.d.ts +31 -0
- package/esm/src/jobs/types.d.ts.map +1 -0
- package/esm/src/jobs/types.js +1 -0
- package/esm/src/mui/apiKeys.d.ts +65 -0
- package/esm/src/mui/apiKeys.d.ts.map +1 -0
- package/esm/src/mui/apiKeys.js +301 -0
- package/esm/src/mui/apiKeysView.d.ts +48 -0
- package/esm/src/mui/apiKeysView.d.ts.map +1 -0
- package/esm/src/mui/apiKeysView.js +34 -0
- package/esm/src/mui/confirm.d.ts +12 -0
- package/esm/src/mui/confirm.d.ts.map +1 -0
- package/esm/src/mui/confirm.js +78 -0
- package/esm/src/mui/mod.d.ts +4 -0
- package/esm/src/mui/mod.d.ts.map +1 -0
- package/esm/src/mui/mod.js +2 -0
- package/esm/src/next/apiKeys/mod.d.ts +64 -0
- package/esm/src/next/apiKeys/mod.d.ts.map +1 -0
- package/esm/src/next/apiKeys/mod.js +217 -0
- package/esm/src/next/auth/config.d.ts +34 -0
- package/esm/src/next/auth/config.d.ts.map +1 -0
- package/esm/src/next/auth/config.js +103 -0
- package/esm/src/next/auth/mod.d.ts +3 -0
- package/esm/src/next/auth/mod.d.ts.map +1 -0
- package/esm/src/next/auth/mod.js +2 -0
- package/esm/src/next/auth/server.d.ts +28 -0
- package/esm/src/next/auth/server.d.ts.map +1 -0
- package/esm/src/next/auth/server.js +24 -0
- package/esm/src/next/files/mod.d.ts +3 -0
- package/esm/src/next/files/mod.d.ts.map +1 -0
- package/esm/src/next/files/mod.js +2 -0
- package/esm/src/next/files/route.d.ts +99 -0
- package/esm/src/next/files/route.d.ts.map +1 -0
- package/esm/src/next/files/route.js +349 -0
- package/esm/src/next/jobs/list.d.ts +25 -0
- package/esm/src/next/jobs/list.d.ts.map +1 -0
- package/esm/src/next/jobs/list.js +39 -0
- package/esm/src/next/jobs/mod.d.ts +6 -0
- package/esm/src/next/jobs/mod.d.ts.map +1 -0
- package/esm/src/next/jobs/mod.js +5 -0
- package/esm/src/next/jobs/paths.d.ts +14 -0
- package/esm/src/next/jobs/paths.d.ts.map +1 -0
- package/esm/src/next/jobs/paths.js +40 -0
- package/esm/src/next/jobs/route.d.ts +48 -0
- package/esm/src/next/jobs/route.d.ts.map +1 -0
- package/esm/src/next/jobs/route.js +101 -0
- package/esm/src/next/jobs/run.d.ts +51 -0
- package/esm/src/next/jobs/run.d.ts.map +1 -0
- package/esm/src/next/jobs/run.js +563 -0
- package/esm/src/next/jobs/stream.d.ts +3 -0
- package/esm/src/next/jobs/stream.d.ts.map +1 -0
- package/esm/src/next/jobs/stream.js +25 -0
- package/esm/src/next/pwa/mod.d.ts +104 -0
- package/esm/src/next/pwa/mod.d.ts.map +1 -0
- package/esm/src/next/pwa/mod.js +169 -0
- package/esm/src/next/pwa/worker.d.ts +27 -0
- package/esm/src/next/pwa/worker.d.ts.map +1 -0
- package/esm/src/next/pwa/worker.js +27 -0
- package/package.json +293 -0
- package/script/_dnt.polyfills.d.ts +149 -0
- package/script/_dnt.polyfills.d.ts.map +1 -0
- package/script/_dnt.polyfills.js +166 -0
- package/script/_dnt.shims.d.ts +2 -0
- package/script/_dnt.shims.d.ts.map +1 -0
- package/script/_dnt.shims.js +60 -0
- package/script/bin/loom.d.ts +2 -0
- package/script/bin/loom.d.ts.map +1 -0
- package/script/bin/loom.js +17 -0
- package/script/mod.d.ts +9 -0
- package/script/mod.d.ts.map +1 -0
- package/script/mod.js +24 -0
- package/script/package.json +3 -0
- package/script/src/apiKeys/authorize.d.ts +4 -0
- package/script/src/apiKeys/authorize.d.ts.map +1 -0
- package/script/src/apiKeys/authorize.js +187 -0
- package/script/src/apiKeys/country.d.ts +3 -0
- package/script/src/apiKeys/country.d.ts.map +1 -0
- package/script/src/apiKeys/country.js +10 -0
- package/script/src/apiKeys/credentials.d.ts +4 -0
- package/script/src/apiKeys/credentials.d.ts.map +1 -0
- package/script/src/apiKeys/credentials.js +58 -0
- package/script/src/apiKeys/fingerprint.d.ts +3 -0
- package/script/src/apiKeys/fingerprint.d.ts.map +1 -0
- package/script/src/apiKeys/fingerprint.js +8 -0
- package/script/src/apiKeys/mod.d.ts +9 -0
- package/script/src/apiKeys/mod.d.ts.map +1 -0
- package/script/src/apiKeys/mod.js +24 -0
- package/script/src/apiKeys/policy.d.ts +59 -0
- package/script/src/apiKeys/policy.d.ts.map +1 -0
- package/script/src/apiKeys/policy.js +92 -0
- package/script/src/apiKeys/retention.d.ts +55 -0
- package/script/src/apiKeys/retention.d.ts.map +1 -0
- package/script/src/apiKeys/retention.js +70 -0
- package/script/src/apiKeys/types.d.ts +175 -0
- package/script/src/apiKeys/types.d.ts.map +1 -0
- package/script/src/apiKeys/types.js +2 -0
- package/script/src/cli/externalSkills.d.ts +39 -0
- package/script/src/cli/externalSkills.d.ts.map +1 -0
- package/script/src/cli/externalSkills.js +181 -0
- package/script/src/cli/mod.d.ts +337 -0
- package/script/src/cli/mod.d.ts.map +1 -0
- package/script/src/cli/mod.js +9337 -0
- package/script/src/cli/projectSkills.d.ts +102 -0
- package/script/src/cli/projectSkills.d.ts.map +1 -0
- package/script/src/cli/projectSkills.js +606 -0
- package/script/src/files/client.d.ts +29 -0
- package/script/src/files/client.d.ts.map +1 -0
- package/script/src/files/client.js +45 -0
- package/script/src/files/errors.d.ts +37 -0
- package/script/src/files/errors.d.ts.map +1 -0
- package/script/src/files/errors.js +76 -0
- package/script/src/files/hash.d.ts +15 -0
- package/script/src/files/hash.d.ts.map +1 -0
- package/script/src/files/hash.js +89 -0
- package/script/src/files/memory.d.ts +29 -0
- package/script/src/files/memory.d.ts.map +1 -0
- package/script/src/files/memory.js +113 -0
- package/script/src/files/metadata.d.ts +10 -0
- package/script/src/files/metadata.d.ts.map +1 -0
- package/script/src/files/metadata.js +189 -0
- package/script/src/files/mod.d.ts +10 -0
- package/script/src/files/mod.d.ts.map +1 -0
- package/script/src/files/mod.js +25 -0
- package/script/src/files/s3.d.ts +29 -0
- package/script/src/files/s3.d.ts.map +1 -0
- package/script/src/files/s3.js +110 -0
- package/script/src/files/service.d.ts +27 -0
- package/script/src/files/service.d.ts.map +1 -0
- package/script/src/files/service.js +139 -0
- package/script/src/files/types.d.ts +134 -0
- package/script/src/files/types.d.ts.map +1 -0
- package/script/src/files/types.js +2 -0
- package/script/src/jobs/catalog.d.ts +32 -0
- package/script/src/jobs/catalog.d.ts.map +1 -0
- package/script/src/jobs/catalog.js +223 -0
- package/script/src/jobs/controller.d.ts +28 -0
- package/script/src/jobs/controller.d.ts.map +1 -0
- package/script/src/jobs/controller.js +100 -0
- package/script/src/jobs/direct.d.ts +36 -0
- package/script/src/jobs/direct.d.ts.map +1 -0
- package/script/src/jobs/direct.js +128 -0
- package/script/src/jobs/events.d.ts +15 -0
- package/script/src/jobs/events.d.ts.map +1 -0
- package/script/src/jobs/events.js +37 -0
- package/script/src/jobs/format.d.ts +16 -0
- package/script/src/jobs/format.d.ts.map +1 -0
- package/script/src/jobs/format.js +193 -0
- package/script/src/jobs/http.d.ts +22 -0
- package/script/src/jobs/http.d.ts.map +1 -0
- package/script/src/jobs/http.js +50 -0
- package/script/src/jobs/log.d.ts +2 -0
- package/script/src/jobs/log.d.ts.map +1 -0
- package/script/src/jobs/log.js +13 -0
- package/script/src/jobs/mod.d.ts +10 -0
- package/script/src/jobs/mod.d.ts.map +1 -0
- package/script/src/jobs/mod.js +25 -0
- package/script/src/jobs/run.d.ts +20 -0
- package/script/src/jobs/run.d.ts.map +1 -0
- package/script/src/jobs/run.js +61 -0
- package/script/src/jobs/types.d.ts +31 -0
- package/script/src/jobs/types.d.ts.map +1 -0
- package/script/src/jobs/types.js +2 -0
- package/script/src/mui/apiKeys.d.ts +65 -0
- package/script/src/mui/apiKeys.d.ts.map +1 -0
- package/script/src/mui/apiKeys.js +327 -0
- package/script/src/mui/apiKeysView.d.ts +48 -0
- package/script/src/mui/apiKeysView.d.ts.map +1 -0
- package/script/src/mui/apiKeysView.js +40 -0
- package/script/src/mui/confirm.d.ts +12 -0
- package/script/src/mui/confirm.d.ts.map +1 -0
- package/script/src/mui/confirm.js +85 -0
- package/script/src/mui/mod.d.ts +4 -0
- package/script/src/mui/mod.d.ts.map +1 -0
- package/script/src/mui/mod.js +19 -0
- package/script/src/next/apiKeys/mod.d.ts +64 -0
- package/script/src/next/apiKeys/mod.d.ts.map +1 -0
- package/script/src/next/apiKeys/mod.js +224 -0
- package/script/src/next/auth/config.d.ts +34 -0
- package/script/src/next/auth/config.d.ts.map +1 -0
- package/script/src/next/auth/config.js +142 -0
- package/script/src/next/auth/mod.d.ts +3 -0
- package/script/src/next/auth/mod.d.ts.map +1 -0
- package/script/src/next/auth/mod.js +18 -0
- package/script/src/next/auth/server.d.ts +28 -0
- package/script/src/next/auth/server.d.ts.map +1 -0
- package/script/src/next/auth/server.js +27 -0
- package/script/src/next/files/mod.d.ts +3 -0
- package/script/src/next/files/mod.d.ts.map +1 -0
- package/script/src/next/files/mod.js +18 -0
- package/script/src/next/files/route.d.ts +99 -0
- package/script/src/next/files/route.d.ts.map +1 -0
- package/script/src/next/files/route.js +353 -0
- package/script/src/next/jobs/list.d.ts +25 -0
- package/script/src/next/jobs/list.d.ts.map +1 -0
- package/script/src/next/jobs/list.js +48 -0
- package/script/src/next/jobs/mod.d.ts +6 -0
- package/script/src/next/jobs/mod.d.ts.map +1 -0
- package/script/src/next/jobs/mod.js +21 -0
- package/script/src/next/jobs/paths.d.ts +14 -0
- package/script/src/next/jobs/paths.d.ts.map +1 -0
- package/script/src/next/jobs/paths.js +47 -0
- package/script/src/next/jobs/route.d.ts +48 -0
- package/script/src/next/jobs/route.d.ts.map +1 -0
- package/script/src/next/jobs/route.js +105 -0
- package/script/src/next/jobs/run.d.ts +51 -0
- package/script/src/next/jobs/run.d.ts.map +1 -0
- package/script/src/next/jobs/run.js +570 -0
- package/script/src/next/jobs/stream.d.ts +3 -0
- package/script/src/next/jobs/stream.d.ts.map +1 -0
- package/script/src/next/jobs/stream.js +28 -0
- package/script/src/next/pwa/mod.d.ts +104 -0
- package/script/src/next/pwa/mod.d.ts.map +1 -0
- package/script/src/next/pwa/mod.js +192 -0
- package/script/src/next/pwa/worker.d.ts +27 -0
- package/script/src/next/pwa/worker.d.ts.map +1 -0
- package/script/src/next/pwa/worker.js +33 -0
- package/skills/loom/SKILL.md +200 -0
- package/skills/loom-api-keys/SKILL.md +123 -0
- package/skills/loom-auth/SKILL.md +70 -0
- package/skills/loom-db/SKILL.md +94 -0
- package/skills/loom-db/references/db-stack.md +39 -0
- package/skills/loom-files/SKILL.md +97 -0
- package/skills/loom-jobs/SKILL.md +148 -0
- package/skills/upgrade-deps/SKILL.md +165 -0
- package/skills/upgrade-deps/agents/openai.yaml +4 -0
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: upgrade-deps
|
|
3
|
+
description: Safely upgrade Deno, JavaScript, and TypeScript project dependencies by establishing a passing baseline, grouping coupled packages, applying incremental updates, diagnosing regressions, completing major-version migrations, and organizing reviewable commits. Use when asked to update or modernize dependencies, resolve upgrade conflicts, audit outdated packages, remove obsolete packages, or execute a staged Deno, npm, pnpm, Yarn, or Bun dependency-upgrade campaign.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Upgrade Dependencies
|
|
7
|
+
|
|
8
|
+
Upgrade dependencies as a controlled compatibility exercise. Preserve user work,
|
|
9
|
+
prove each meaningful change, and leave intentional deferrals documented.
|
|
10
|
+
|
|
11
|
+
## 1. Establish the contract
|
|
12
|
+
|
|
13
|
+
1. Read repository instructions before changing files.
|
|
14
|
+
2. Inspect the manifests, lockfiles, dependency-manager declarations, runtime
|
|
15
|
+
versions, CI workflows, and available verification scripts. Keep the existing
|
|
16
|
+
dependency manager unless the user explicitly requests a migration.
|
|
17
|
+
3. Inspect `git status --short`. Treat all pre-existing changes as user-owned.
|
|
18
|
+
Do not rely on destructive rollback commands in a dirty tree.
|
|
19
|
+
4. Identify generated files and their source commands. Regenerate them through
|
|
20
|
+
the project workflow rather than editing them manually.
|
|
21
|
+
5. Run the strongest practical baseline: install or lockfile validation,
|
|
22
|
+
formatting/lint, typecheck, tests, build, and project-specific checks. Record
|
|
23
|
+
existing warnings and flaky behavior so they are not attributed to upgrades.
|
|
24
|
+
|
|
25
|
+
If the project consumes Loom, use the `loom` skill first, read `loom.json`, use
|
|
26
|
+
feature skills affected by the upgrade, and include `loom check --production` in
|
|
27
|
+
the final gate.
|
|
28
|
+
|
|
29
|
+
### Deno projects
|
|
30
|
+
|
|
31
|
+
For Deno projects:
|
|
32
|
+
|
|
33
|
+
- Treat `deno.json` or `deno.jsonc` and `deno.lock` as the dependency contract.
|
|
34
|
+
Include workspace-member manifests when the root config declares a workspace.
|
|
35
|
+
- Use `deno outdated` for the read-only inventory. Use `deno update <alias>` for
|
|
36
|
+
semver-compatible updates and `deno update --latest <alias>` only when
|
|
37
|
+
intentionally crossing the declared range. Filters select import aliases from
|
|
38
|
+
the manifest, not necessarily the underlying JSR or npm package names.
|
|
39
|
+
- Update one alias or coupled alias family at a time. Inspect changes to `jsr:`
|
|
40
|
+
and `npm:` specifiers, peer requirements, runtime support, and `deno.lock`.
|
|
41
|
+
- Match the Deno version used by CI and release workflows. Do not assume that
|
|
42
|
+
the newest runtime or its bundled TypeScript version is the deployment target.
|
|
43
|
+
- Run the repository's Deno tasks as the verification contract. Do not edit
|
|
44
|
+
`deno.lock` manually.
|
|
45
|
+
|
|
46
|
+
When upgrading Loom itself, treat it as the Loom source package rather than a
|
|
47
|
+
consumer: it does not need `loom.json` or `loom check --production`. Run
|
|
48
|
+
`deno task check`; it formats, lints, tests, and rebuilds the publishable npm
|
|
49
|
+
artifact. Loom's generated `npm/` directory is ignored verification output, so
|
|
50
|
+
never edit or stage it by hand.
|
|
51
|
+
|
|
52
|
+
## 2. Inventory and group upgrades
|
|
53
|
+
|
|
54
|
+
Use current registry data and official release or migration documentation for
|
|
55
|
+
unstable version information. Classify available changes into compatibility
|
|
56
|
+
units:
|
|
57
|
+
|
|
58
|
+
- coupled families that must move together, such as framework/runtime pairs,
|
|
59
|
+
adapters, plugins, type packages, or packages sharing strict peer ranges;
|
|
60
|
+
- low-risk patch and minor updates that require no source migration;
|
|
61
|
+
- majors and toolchain changes that need release-note review;
|
|
62
|
+
- runtime-aligned packages, such as Node type definitions, whose correct target
|
|
63
|
+
is the deployed runtime rather than the newest release;
|
|
64
|
+
- unused, replaced, deprecated, or redundant packages that should be removed;
|
|
65
|
+
- blocked updates with incompatible peers, runtime requirements, or upstream
|
|
66
|
+
regressions.
|
|
67
|
+
|
|
68
|
+
Upgrade one compatibility unit at a time, not necessarily one package at a time.
|
|
69
|
+
For a multi-major jump, prefer supported bridge releases when official guidance
|
|
70
|
+
recommends them.
|
|
71
|
+
|
|
72
|
+
## 3. Protect rollback state
|
|
73
|
+
|
|
74
|
+
Before each attempt, know exactly which manifest and lockfile state must be
|
|
75
|
+
restored. If those files were already modified, preserve byte-for-byte snapshots
|
|
76
|
+
or use a scoped reverse patch. Use Git restoration only when it cannot discard
|
|
77
|
+
pre-existing user changes.
|
|
78
|
+
|
|
79
|
+
Do not use `--force`, `--legacy-peer-deps`, broad audit fixes, lockfile
|
|
80
|
+
deletion, or dependency-manager migration as shortcuts. Report the constraint
|
|
81
|
+
and seek explicit approval if a risky override is genuinely required.
|
|
82
|
+
|
|
83
|
+
## 4. Run the upgrade loop
|
|
84
|
+
|
|
85
|
+
For each compatibility unit:
|
|
86
|
+
|
|
87
|
+
1. Apply only that unit and inspect manifests, lockfiles, dependency-resolution
|
|
88
|
+
output, peer warnings, runtime requirements, and unexpected transitive
|
|
89
|
+
changes.
|
|
90
|
+
2. Run a verification ladder proportional to risk:
|
|
91
|
+
- dependency resolution and generated-file checks;
|
|
92
|
+
- typecheck and lint;
|
|
93
|
+
- targeted tests, followed by the full suite when shared behavior changed;
|
|
94
|
+
- production build for frameworks, toolchains, majors, or broad runtime code;
|
|
95
|
+
- focused browser, API, database, or end-to-end checks for user-visible or
|
|
96
|
+
runtime-sensitive migrations.
|
|
97
|
+
3. Classify the result:
|
|
98
|
+
- **clean**: no source migration required;
|
|
99
|
+
- **migration**: source/config changes are required and verified;
|
|
100
|
+
- **deferred**: restore the pre-attempt state and record evidence;
|
|
101
|
+
- **removed**: prove the dependency is unused before deleting it.
|
|
102
|
+
4. Keep a concise ledger containing the unit, versions, result, verification,
|
|
103
|
+
warnings, migration notes, and deferral reason.
|
|
104
|
+
|
|
105
|
+
Run full tests and a build after every major, framework, or toolchain unit. For
|
|
106
|
+
large sets of low-risk patches, run fast checks per unit and the complete gate
|
|
107
|
+
at each batch boundary unless the user requests stricter per-package builds.
|
|
108
|
+
|
|
109
|
+
## 5. Diagnose failures before assigning blame
|
|
110
|
+
|
|
111
|
+
Treat one failing run as evidence, not proof.
|
|
112
|
+
|
|
113
|
+
1. Capture the exact failing command and diagnostics.
|
|
114
|
+
2. Retry enough to distinguish deterministic failure from flakiness.
|
|
115
|
+
3. Re-run the same command at the known-good version.
|
|
116
|
+
4. Change only the suspected compatibility unit and compare old/new behavior.
|
|
117
|
+
5. For intermittent failures, run repeated A/B trials—normally at least three
|
|
118
|
+
per version—before concluding that an upgrade caused the regression.
|
|
119
|
+
6. Defer the smallest responsible unit and document the observed evidence,
|
|
120
|
+
compatible version, and future unblock condition.
|
|
121
|
+
|
|
122
|
+
Do not weaken tests merely to make an upgrade pass. Fix tests only when official
|
|
123
|
+
behavior or a deliberate application contract changed.
|
|
124
|
+
|
|
125
|
+
## 6. Handle migrations deliberately
|
|
126
|
+
|
|
127
|
+
For a major or breaking release:
|
|
128
|
+
|
|
129
|
+
1. Read current official migration guidance and peer requirements.
|
|
130
|
+
2. Apply official codemods only after reviewing their scope and resulting diff.
|
|
131
|
+
3. Migrate deprecated APIs, configuration, generated artifacts, and tests.
|
|
132
|
+
4. Verify behavior through the most relevant runtime surface, not only static
|
|
133
|
+
checks.
|
|
134
|
+
5. Keep unrelated cleanup outside the migration unless it is required for
|
|
135
|
+
compatibility.
|
|
136
|
+
|
|
137
|
+
## 7. Organize commits when authorized
|
|
138
|
+
|
|
139
|
+
Do not infer permission to commit. When the user requests commits:
|
|
140
|
+
|
|
141
|
+
- combine verified, code-free compatible updates into one reviewable commit;
|
|
142
|
+
- keep coupled package families together;
|
|
143
|
+
- give each substantial migration its own commit;
|
|
144
|
+
- separate dependency removal when its rationale deserves review;
|
|
145
|
+
- record a deliberate downgrade or deferral separately when it captures an
|
|
146
|
+
important compatibility decision.
|
|
147
|
+
|
|
148
|
+
Each commit must contain a passing, internally consistent manifest and lockfile.
|
|
149
|
+
Follow the repository's commit-message and attribution rules.
|
|
150
|
+
|
|
151
|
+
## 8. Run the exact-tree final gate
|
|
152
|
+
|
|
153
|
+
After formatting or commit hooks have finished, verify the exact final tree:
|
|
154
|
+
|
|
155
|
+
1. Confirm manifest and lockfile consistency across the project or workspace.
|
|
156
|
+
2. Run required generators, lint/format, typecheck, full tests, production
|
|
157
|
+
build, and project-specific checks.
|
|
158
|
+
3. Inspect the final status and diff for unrelated changes.
|
|
159
|
+
4. Re-run the outdated inventory when registry access is available.
|
|
160
|
+
5. Report successful upgrades, migrations, removals, deferred packages with
|
|
161
|
+
evidence, commands run, known pre-existing warnings, commits created, and
|
|
162
|
+
working-tree state.
|
|
163
|
+
|
|
164
|
+
Completion means the verified tree is reproducible and every remaining upgrade
|
|
165
|
+
is either intentionally deferred or explicitly out of scope.
|