@danieljvdm/dev-kit 0.11.3 → 0.12.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/README.md +70 -76
- package/dev-kit.example.jsonc +0 -4
- package/package.json +10 -6
- package/schema/dev-kit.schema.json +1 -46
- package/skills/build-effect-apis/SKILL.md +77 -0
- package/skills/build-effect-apis/agents/openai.yaml +4 -0
- package/skills/build-effect-apis/references/cloudflare-workers.md +71 -0
- package/skills/build-effect-apis/references/effect-atom-client.md +161 -0
- package/skills/build-effect-apis/references/effect-atom-lifecycle.md +78 -0
- package/skills/build-effect-apis/references/effect-atom-testing.md +74 -0
- package/skills/build-effect-apis/references/runtime-assembly.md +56 -0
- package/skills/build-effect-apis/references/server-and-middleware.md +174 -0
- package/skills/build-effect-apis/references/shared-contracts.md +108 -0
- package/skills/build-effect-apis/references/tanstack-start.md +86 -0
- package/skills/build-effect-apis/references/verification.md +50 -0
- package/skills/dev-kit/SKILL.md +58 -46
- package/skills/effect-architecture-audit/SKILL.md +26 -0
- package/skills/effect-architecture-audit/agents/openai.yaml +4 -0
- package/skills/effect-architecture-audit/references/service-and-boundary-audit.md +150 -0
- package/skills/effect-ts/SKILL.md +21 -256
- package/skills/effect-ts/agents/openai.yaml +3 -3
- package/skills/testing/SKILL.md +5 -0
- package/src/catalog-manager.ts +16 -17
- package/src/catalog.ts +71 -16
- package/src/effect-source.ts +46 -24
- package/src/effect-tsgo.ts +49 -24
- package/src/gitignore.ts +5 -5
- package/src/index.ts +0 -6
- package/src/manifest.ts +0 -34
- package/src/node-symbolic-link.ts +2 -2
- package/src/oxfmt.js +5 -0
- package/src/oxfmt.ts +5 -0
- package/src/oxlint.js +5 -0
- package/src/oxlint.ts +5 -0
- package/src/package-skill-source.ts +51 -59
- package/src/path-digest.ts +7 -7
- package/src/project-package.ts +8 -7
- package/src/project-process-lock.ts +17 -12
- package/src/project-state.ts +1 -1
- package/src/skill-manager.ts +16 -14
- package/src/skill-selector.ts +12 -0
- package/src/sync.ts +170 -120
- package/src/tool-ignore-patterns.js +9 -0
- package/src/tool-ignore-patterns.ts +15 -0
- package/src/vendor.ts +67 -61
- package/src/vite-plus-dependency.ts +10 -11
- package/src/vite-plus-hooks.ts +24 -14
- package/src/vite-plus-quality.ts +21 -172
- package/src/vite-plus.js +81 -0
- package/src/vite-plus.ts +102 -0
- package/templates/AGENTS.md +1 -1
- package/skills/effect-ts/UPSTREAM.md +0 -28
- package/skills/effect-ts/references/atom-cache-lifecycle.md +0 -78
- package/skills/effect-ts/references/atom-http-and-invalidation.md +0 -97
- package/skills/effect-ts/references/atom-tanstack-start.md +0 -69
- package/skills/effect-ts/references/atom-testing.md +0 -67
- package/skills/effect-ts/references/audit-services.md +0 -144
- package/skills/effect-ts/references/features.md +0 -525
- package/skills/effect-ts/references/guide-atom-data-fetching.md +0 -44
- package/skills/effect-ts/references/guide-cli.md +0 -107
- package/skills/effect-ts/references/guide-datetime.md +0 -72
- package/skills/effect-ts/references/guide-effect.md +0 -440
- package/skills/effect-ts/references/guide-error-handling.md +0 -565
- package/skills/effect-ts/references/guide-http-boundaries.md +0 -55
- package/skills/effect-ts/references/guide-layers.md +0 -989
- package/skills/effect-ts/references/guide-observability.md +0 -746
- package/skills/effect-ts/references/guide-retries.md +0 -434
- package/skills/effect-ts/references/guide-schedule.md +0 -343
- package/skills/effect-ts/references/guide-schema.md +0 -664
- package/skills/effect-ts/references/guide-sql.md +0 -536
- package/skills/effect-ts/references/guide-testing.md +0 -532
- package/skills/effect-ts/references/guide-type-safety-and-boundaries.md +0 -131
- package/skills/effect-ts/references/version-and-source.md +0 -86
- package/templates/vite-plus/vite.config.ts +0 -22
|
@@ -1,86 +0,0 @@
|
|
|
1
|
-
# Effect Version And Source Strategy
|
|
2
|
-
|
|
3
|
-
Use this guide before installing Effect packages or relying on exact API names,
|
|
4
|
-
signatures, exports, or source paths.
|
|
5
|
-
|
|
6
|
-
## Review Baseline
|
|
7
|
-
|
|
8
|
-
This skill was last reviewed on 2026-07-29 against:
|
|
9
|
-
|
|
10
|
-
- `effect@4.0.0-beta.102`
|
|
11
|
-
- matching `4.0.0-beta.102` releases of the v4 `@effect/*` packages
|
|
12
|
-
- canonical source from `Effect-TS/effect`
|
|
13
|
-
- official Effect skill commit
|
|
14
|
-
`a8b6bb40d1d4d550b49c0ff7a624b5e6da500a24`
|
|
15
|
-
|
|
16
|
-
The beta is intentionally volatile. Review metadata records what was checked;
|
|
17
|
-
it does not override the target repository's installed version.
|
|
18
|
-
|
|
19
|
-
## Determine The Target Version
|
|
20
|
-
|
|
21
|
-
Before editing:
|
|
22
|
-
|
|
23
|
-
1. Read the target repository's package manifest and lockfile.
|
|
24
|
-
2. Identify the resolved `effect` version and every installed `@effect/*`
|
|
25
|
-
version.
|
|
26
|
-
3. Determine whether the repository is on Effect v3 or the v4 beta.
|
|
27
|
-
4. Keep guidance and source research on that same release line.
|
|
28
|
-
|
|
29
|
-
Do not silently upgrade an existing repository. If its Effect packages are
|
|
30
|
-
misaligned, report the mismatch and treat version alignment as a separate
|
|
31
|
-
change.
|
|
32
|
-
|
|
33
|
-
## Installing Effect v4
|
|
34
|
-
|
|
35
|
-
For a new Effect v4 installation:
|
|
36
|
-
|
|
37
|
-
1. Resolve the current `effect@beta` version from the package registry.
|
|
38
|
-
2. Install `effect` at that exact version.
|
|
39
|
-
3. Install only the runtime and integration packages the task requires.
|
|
40
|
-
4. Pin every v4 `@effect/*` package to the same exact beta version.
|
|
41
|
-
|
|
42
|
-
`effect@latest` is the stable v3 release line until Effect v4 leaves beta.
|
|
43
|
-
Do not use generic v3 packages such as `@effect/platform` with Effect v4.
|
|
44
|
-
Effect v4 places many capabilities under `effect/unstable/*`; install separate
|
|
45
|
-
packages only for runtime-, provider-, driver-, or tool-specific integrations.
|
|
46
|
-
|
|
47
|
-
## Source Research
|
|
48
|
-
|
|
49
|
-
Use this order:
|
|
50
|
-
|
|
51
|
-
1. Search the installed package declarations and source in the target
|
|
52
|
-
repository.
|
|
53
|
-
2. Check the target repository for established usage of the same API.
|
|
54
|
-
3. Inspect the canonical `Effect-TS/effect` source at the matching tag or
|
|
55
|
-
commit.
|
|
56
|
-
4. Use current `main` only when intentionally researching a future upgrade.
|
|
57
|
-
|
|
58
|
-
A project-local checkout at canonical `Effect-TS/effect` source may be used when the repository
|
|
59
|
-
already provides one, but it is optional. Never pause ordinary Effect work to
|
|
60
|
-
force the user to add a subtree, submodule, or clone.
|
|
61
|
-
|
|
62
|
-
## V4 Migration Checks
|
|
63
|
-
|
|
64
|
-
When adapting older examples, verify them against the installed v4 release.
|
|
65
|
-
Common v4 changes include:
|
|
66
|
-
|
|
67
|
-
- define services with `Context.Service`, not the removed `Context.Tag`,
|
|
68
|
-
`Context.GenericTag`, `Effect.Tag`, or `Effect.Service`
|
|
69
|
-
- prefer yielding the service key directly
|
|
70
|
-
- use `Effect.catch`, `Effect.catchCause`, and `Effect.catchFilter` rather than
|
|
71
|
-
the renamed v3 `catchAll`, `catchAllCause`, and `catchSome`
|
|
72
|
-
- use `Context` plus `Effect.runForkWith` rather than the removed generic
|
|
73
|
-
`Runtime<R>` and `Effect.runtime`
|
|
74
|
-
- import consolidated capabilities from `effect/unstable/*` rather than
|
|
75
|
-
obsolete standalone packages
|
|
76
|
-
- verify Schema class, union, decoding, and transformation signatures because
|
|
77
|
-
they changed throughout the v4 beta
|
|
78
|
-
|
|
79
|
-
## Completion Check
|
|
80
|
-
|
|
81
|
-
Before completing version-sensitive work:
|
|
82
|
-
|
|
83
|
-
- every code example uses APIs present in the target's resolved packages
|
|
84
|
-
- every installed Effect v4 package resolves to the same beta
|
|
85
|
-
- no source path is assumed solely because it appears in this skill
|
|
86
|
-
- current-main guidance is not presented as installed-version behavior
|
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
import { recommendedOxfmtConfig } from "@danieljvdm/dev-kit/oxfmt";
|
|
2
|
-
import { recommendedOxlintConfig } from "@danieljvdm/dev-kit/oxlint";
|
|
3
|
-
import { defineConfig } from "vite-plus";
|
|
4
|
-
|
|
5
|
-
export default defineConfig({
|
|
6
|
-
staged: {
|
|
7
|
-
"*": "vp check --fix",
|
|
8
|
-
},
|
|
9
|
-
fmt: {
|
|
10
|
-
...recommendedOxfmtConfig,
|
|
11
|
-
},
|
|
12
|
-
lint: {
|
|
13
|
-
extends: [recommendedOxlintConfig],
|
|
14
|
-
ignorePatterns: [".agents/**", ".dev-kit/**", ".repos/**"],
|
|
15
|
-
},
|
|
16
|
-
run: {
|
|
17
|
-
tasks: {
|
|
18
|
-
check: ["vp fmt --check", "vp lint", "vp test", "vp run typecheck"],
|
|
19
|
-
typecheck: "tsc --noEmit",
|
|
20
|
-
},
|
|
21
|
-
},
|
|
22
|
-
});
|