@danieljvdm/dev-kit 0.5.0 → 0.7.0

package/README.md

@@ -61,8 +61,8 @@ or use `--no-apply` to edit the manifest without syncing yet.
   "include": ["dev-kit", "effect"],
   "targets": {
     "agents": { "enabled": true, "mode": "copy" },
-    "claude": { "enabled": true, "mode": "symlink" }
-  }
+    "claude": { "enabled": true, "mode": "symlink" },
+  },
 }
 ```
 
@@ -73,18 +73,33 @@ bun x dev-kit plan
 bun x dev-kit apply
 ```
 
-Commit the generated `dev-kit.lock.json`, then use locked mode in your package
-lifecycle:
+Commit the generated `dev-kit.lock.json`, then let the package lifecycle
+converge owned outputs automatically when installed packages change:
 
 ```jsonc
 {
   "scripts": {
-    "postinstall": "dev-kit apply --locked"
-  }
+    "postinstall": "dev-kit apply",
+  },
 }
 ```
 
-That single postinstall applies every task enabled in `dev-kit.jsonc`.
+That single postinstall applies every task enabled in `dev-kit.jsonc` and
+regenerates `dev-kit.lock.json` when an intentional package upgrade changes a
+bundled or package-provided skill. Ownership and conflict checks still prevent
+unreviewed overwrites.
+
+Keep strict verification in CI. Either install with lifecycle scripts disabled
+before running locked mode:
+
+```bash
+bun install --ignore-scripts
+bun x dev-kit apply --locked
+```
+
+Or allow the normal postinstall and fail CI when it leaves tracked changes.
+Do not run an unlocked apply before a locked verification because that would
+regenerate the drift being checked.
 
 This repository dogfoods the same flow with its committed `dev-kit.jsonc` and
 `dev-kit.lock.json`. From this source checkout, invoke the local CLI with:
@@ -100,29 +115,29 @@ the root package itself.
 
 ## Commands
 
-| Command | Purpose |
-| --- | --- |
-| `dev-kit` | Show selected skills and the four common next actions. |
-| `dev-kit init` | Create a minimal `dev-kit.jsonc`. |
-| `dev-kit add <skill...>` | Select and immediately install skills. |
-| `dev-kit remove <skill...>` | Deselect and uninstall skills safely. |
-| `dev-kit list [--all]` | List selected skills or browse the catalog. |
-| `dev-kit search <words...>` | Search names and descriptions. |
-| `dev-kit info <skill>` | Show description and Git or installed-package provenance. |
-| `dev-kit status` | Check whether the project matches its selection. |
-| `dev-kit sync` | Apply the current manifest. |
-| `dev-kit plan` | Preview project changes without writing files. |
-| `dev-kit apply` | Apply the manifest and update `dev-kit.lock.json`. |
-| `dev-kit apply --locked` | Reproduce the committed lock or fail on drift. |
-| `dev-kit gitignore` | Add `.repos/` and `.dev-kit/` to `.gitignore`. |
-| `dev-kit effect sync` | Sync `.repos/effect` to the installed Effect version. |
-| `dev-kit tsgo patch` | Validate and patch Effect TypeScript-Go directly. |
-| `dev-kit catalog refresh` | Maintainer command to approve current upstream refs. |
-| `dev-kit catalog add <repository>` | Inspect a repository and approve selected skills. |
-| `dev-kit catalog remove <source-or-skill>` | Revoke an approval (`--yes` outside a terminal). |
-| `dev-kit catalog list` | List approved upstream repositories. |
-| `dev-kit catalog info <source>` | Show a source, commit, and approved skills. |
-| `dev-kit catalog verify` | Verify the committed snapshot without advancing refs. |
+| Command                                    | Purpose                                                   |
+| ------------------------------------------ | --------------------------------------------------------- |
+| `dev-kit`                                  | Show selected skills and the four common next actions.    |
+| `dev-kit init`                             | Create a minimal `dev-kit.jsonc`.                         |
+| `dev-kit add <skill...>`                   | Select and immediately install skills.                    |
+| `dev-kit remove <skill...>`                | Deselect and uninstall skills safely.                     |
+| `dev-kit list [--all]`                     | List selected skills or browse the catalog.               |
+| `dev-kit search <words...>`                | Search names and descriptions.                            |
+| `dev-kit info <skill>`                     | Show description and Git or installed-package provenance. |
+| `dev-kit status`                           | Check whether the project matches its selection.          |
+| `dev-kit sync`                             | Apply the current manifest.                               |
+| `dev-kit plan`                             | Preview project changes without writing files.            |
+| `dev-kit apply`                            | Apply the manifest and update `dev-kit.lock.json`.        |
+| `dev-kit apply --locked`                   | Reproduce the committed lock or fail on drift.            |
+| `dev-kit gitignore`                        | Add `.repos/` and `.dev-kit/` to `.gitignore`.            |
+| `dev-kit effect sync`                      | Sync `.repos/effect` to the installed Effect version.     |
+| `dev-kit tsgo patch`                       | Validate and patch Effect TypeScript-Go directly.         |
+| `dev-kit catalog refresh`                  | Maintainer command to approve current upstream refs.      |
+| `dev-kit catalog add <repository>`         | Inspect a repository and approve selected skills.         |
+| `dev-kit catalog remove <source-or-skill>` | Revoke an approval (`--yes` outside a terminal).          |
+| `dev-kit catalog list`                     | List approved upstream repositories.                      |
+| `dev-kit catalog info <source>`            | Show a source, commit, and approved skills.               |
+| `dev-kit catalog verify`                   | Verify the committed snapshot without advancing refs.     |
 
 Options vary by command and include `--dry-run`, `--manifest`, `--lockfile`,
 and `--project-dir`. Run any command with `--help` for its complete usage.
@@ -131,11 +146,11 @@ and `--project-dir`. Run any command with `--help` for its complete usage.
 
 Dev Kit uses three project-local files:
 
-| Path | Role | Commit it? |
-| --- | --- | --- |
-| `dev-kit.jsonc` | Desired skills, targets, and setup tasks. | Yes |
-| `dev-kit.lock.json` | Resolved content digests and setup-tool versions. | Yes |
-| `.dev-kit/state.json` | Local ownership receipts used during apply and cleanup. | No |
+| Path                  | Role                                                    | Commit it? |
+| --------------------- | ------------------------------------------------------- | ---------- |
+| `dev-kit.jsonc`       | Desired skills, targets, and setup tasks.               | Yes        |
+| `dev-kit.lock.json`   | Resolved content digests and setup-tool versions.       | Yes        |
+| `.dev-kit/state.json` | Local ownership receipts used during apply and cleanup. | No         |
 
 Skills are copied into `.agents/skills` by default. Other harness targets can
 copy or symlink those project-local skills.
@@ -162,22 +177,24 @@ tool versions. A project-local process lock also prevents concurrent applies.
     "workers-best-practices",
     "wrangler",
     "serve-sim",
-    "@tanstack/ai#ai-core"
+    "@tanstack/ai#ai-core",
   ],
   "exclude": ["animation-vocabulary"],
   "setup": {
-    "claudeInstructions": { "enabled": true }
+    "agentInstructions": { "enabled": true },
+    "claudeInstructions": { "enabled": true },
   },
   "targets": {
     "agents": { "enabled": true, "mode": "copy" },
     "claude": { "enabled": true, "mode": "symlink" },
-    "opencode": { "enabled": false, "mode": "symlink" }
-  }
+    "opencode": { "enabled": false, "mode": "symlink" },
+  },
 }
 ```
 
 - `dev-kit` installs guidance for operating the toolkit itself.
-- `effect` expands to the consolidated `effect-ts` skill.
+- `effect` expands to `effect-ts` plus focused Effect Atom HTTP data-fetching
+  guidance.
 - Prefer individual external skills such as `workers-best-practices` and
   `wrangler`, selected after scanning the project for relevant technologies.
 - `serve-sim` selects the approved Evan Bacon simulator skill directly.
@@ -191,24 +208,85 @@ Dev Kit reserves `.repos/<source-id>` for project-local source checkouts. Run
 The patch is idempotent, preserves existing lines, and refuses symlinked
 `.gitignore` files.
 
-## Claude instructions
+## Agent instructions
+
+Enable a managed project-root instruction wrapper and a portable Claude Code
+bridge in the manifest:
+
+```jsonc
+{
+  "include": ["dev-kit"],
+  "setup": {
+    "agentInstructions": { "enabled": true },
+    "claudeInstructions": { "enabled": true },
+  },
+}
+```
 
-Enable a portable Claude Code instruction bridge in the manifest:
+`setup.agentInstructions` manages `AGENTS.md` as a generated wrapper with a
+short description of dev-kit and a pointer to the installed `dev-kit` skill.
+When the root `package.json` declares `vite-plus` directly, the wrapper also
+includes Vite+'s installed `node_modules/vite-plus/AGENTS.md` instructions.
+Transitive installations do not opt a project in.
+
+`setup.claudeInstructions` manages `CLAUDE.md` as the relative symlink
+`CLAUDE.md → AGENTS.md`. It can link to the generated wrapper in the same apply,
+or retain the older behavior of linking to an existing regular `AGENTS.md` when
+the wrapper task is disabled. Both outputs are recorded independently in the
+lockfile and local ownership state. Dev Kit refuses to replace unowned files
+and removes only unchanged owned outputs.
+
+## Vite+ Git hooks
+
+Enable Vite+'s project-local Git hook dispatcher in the manifest:
 
 ```jsonc
 {
-  "include": [],
+  "include": ["dev-kit"],
   "setup": {
-    "claudeInstructions": { "enabled": true }
-  }
+    "vitePlus": { "hooks": { "enabled": true } },
+  },
 }
 ```
 
-`dev-kit apply` requires a project-root `AGENTS.md`, then manages
-`CLAUDE.md` as the relative symlink `CLAUDE.md → AGENTS.md`. The link is
-recorded in the lockfile and local ownership state. Dev Kit refuses to replace
-an unowned `CLAUDE.md` and removes the link when the task is disabled only if
-the owned link is unchanged.
+`dev-kit apply` requires `vite-plus` as an installed direct dependency and runs
+its project-local `vp config --no-agent` command when hook setup is missing. The
+generated `.vite-hooks/_` dispatcher is ignored by Git, so every linked
+worktree converges its own copy during install while the project-owned
+`.vite-hooks/pre-commit` hook remains portable. Dev Kit preserves an unrelated
+`core.hooksPath` instead of replacing another hook manager. Set
+`VITE_GIT_HOOKS=0` (or `HUSKY=0`) to skip the task for that invocation.
+
+## Vite+ quality setup
+
+Supported Vite+/Effect repositories can explicitly opt into Dev Kit's canonical
+quality configuration and GitHub Actions workflow:
+
+```jsonc
+{
+  "include": ["dev-kit", "effect"],
+  "setup": {
+    "effectTsgo": { "enabled": true },
+    "vitePlus": {
+      "hooks": { "enabled": true },
+      "quality": { "enabled": true },
+    },
+  },
+}
+```
+
+The quality task requires direct `@danieljvdm/dev-kit`, `vite-plus`, `effect`,
+`@effect/tsgo`, and native TypeScript dependencies, plus the enabled Effect
+TypeScript-Go patch. It manages `vite.config.ts` and
+`.github/workflows/check.yml` as digest-owned files. Existing custom files or
+conflicting `check`/`typecheck` package scripts are rejected instead of merged
+or overwritten. Exact canonical files can be adopted; disabling the task
+removes only unchanged owned files.
+
+The managed Vite config composes the shared Oxfmt and Oxlint presets, configures
+`vp staged`, and defines `vp run check` and `vp run typecheck`. The check task
+and CI run `vp fmt --check`, `vp lint`, `vp test`, then the Effect-patched
+compiler through `vp run typecheck`.
 
 ## Effect source checkout
 
@@ -218,8 +296,8 @@ Enable a local checkout of the exact installed Effect release in the manifest:
 {
   "include": ["effect"],
   "setup": {
-    "effectSource": { "enabled": true }
-  }
+    "effectSource": { "enabled": true },
+  },
 }
 ```
 
@@ -241,8 +319,8 @@ Enable Effect TypeScript-Go in the same manifest:
   "include": ["effect"],
   "setup": {
     "effectSource": { "enabled": true },
-    "effectTsgo": { "enabled": true }
-  }
+    "effectTsgo": { "enabled": true },
+  },
 }
 ```
 
@@ -253,8 +331,8 @@ Pin the compatible packages in the consuming project:
   "devDependencies": {
     "@danieljvdm/dev-kit": "^0.2.0",
     "@effect/tsgo": "0.24.3",
-    "typescript": "7.0.2"
-  }
+    "typescript": "7.0.2",
+  },
 }
 ```
 
@@ -262,8 +340,8 @@ Pin the compatible packages in the consuming project:
 {
   "$schema": "./node_modules/@effect/tsgo/schema.json",
   "compilerOptions": {
-    "plugins": [{ "name": "@effect/language-service" }]
-  }
+    "plugins": [{ "name": "@effect/language-service" }],
+  },
 }
 ```
 
@@ -272,8 +350,8 @@ native TypeScript compiler. It does not download dependencies and skips an
 installation that is already patched. Use `dev-kit tsgo patch --dry-run` when
 troubleshooting the task directly.
 
-Package and tsconfig edits remain explicit until Dev Kit can safely own parts
-of shared JSONC files.
+Dependency and `tsconfig.json` edits remain explicit. Enable the Vite+ quality
+task only when Dev Kit can own the canonical root config and GitHub workflow.
 
 ## Installed package skills
 
@@ -345,9 +423,9 @@ This repository remains an opinionated catalog for Git-hosted skills.
       "ref": "main",
       "skillsPath": "skills",
       "include": ["*"],
-      "licensePath": "LICENSE"
-    }
-  ]
+      "licensePath": "LICENSE",
+    },
+  ],
 }
 ```
 
@@ -404,7 +482,18 @@ export default defineConfig({
 
 Use `lint.extends` rather than a shallow object spread so Vite+ composes the
 nested plugin and rule configuration correctly. Oxfmt has no `extends`, so
-spread its configuration before project-local formatter options.
+spread its configuration before project-local formatter options. The shared
+lint preset enables `typeAware` for semantic lint rules but leaves `typeCheck`
+disabled. The opt-in `setup.vitePlus.quality` task manages this composition for
+repositories that use the canonical config; custom configs keep the task
+disabled and compose the exports manually. Effect TypeScript-Go projects run:
+
+```sh
+vp fmt --check
+vp lint
+vp test
+vp run typecheck
+```
 
 Standalone projects import the same objects from their native config files:
 
@@ -428,7 +517,12 @@ export default defineConfig({
 });
 ```
 
-The Oxlint preset also registers the shared `effect` JavaScript plugin. Effect
+The Oxlint preset enables `stylistic/padding-line-between-statements`: adjacent
+variable declarations remain grouped, while the next logical statement and
+all `return` statements require a separating blank line. The rule is fixable,
+so `vp lint --fix` repairs missing spacing automatically.
+
+The preset also registers the shared `effect` JavaScript plugin. Effect
 projects opt into its rules in path-specific overrides, for example
 `effect/no-effect-run`, `effect/no-unsafe-promise`, and
 `effect/no-untyped-throw`. The package exports the plugin directly from
@@ -439,7 +533,6 @@ consumer-scoped because application and host boundaries differ by repository.
 ## Development
 
 ```bash
-bun install
-bun run check
-vitest run --config vitest.config.ts
+vp install
+vp run check
 ```

package/dev-kit.example.jsonc

@@ -2,13 +2,18 @@
   "$schema": "./schema/dev-kit.schema.json",
   "include": ["dev-kit", "effect"],
   "setup": {
+    "agentInstructions": { "enabled": true },
     "claudeInstructions": { "enabled": true },
     "effectSource": { "enabled": true },
-    "effectTsgo": { "enabled": true }
+    "effectTsgo": { "enabled": true },
+    "vitePlus": {
+      "hooks": { "enabled": true },
+      "quality": { "enabled": true },
+    },
   },
   "targets": {
     "agents": { "enabled": true, "mode": "copy" },
     "claude": { "enabled": true, "mode": "symlink" },
-    "opencode": { "enabled": false, "mode": "symlink" }
-  }
+    "opencode": { "enabled": false, "mode": "symlink" },
+  },
 }

package/package.json

@@ -1,17 +1,27 @@
 {
   "name": "@danieljvdm/dev-kit",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "private": false,
-  "type": "module",
   "description": "Declarative project development toolkit with portable agent skills.",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/danieljvdm/dev-kit.git"
   },
-  "license": "MIT",
   "bin": {
     "dev-kit": "bin/dev-kit.mjs"
   },
+  "files": [
+    "dev-kit.example.jsonc",
+    "bin/",
+    "schema/",
+    "skills/",
+    "skill-sources.jsonc",
+    "skill-sources.lock.json",
+    "src/",
+    "templates/"
+  ],
+  "type": "module",
   "exports": {
     ".": {
       "types": "./src/index.ts",
@@ -31,38 +41,32 @@
     "./oxlint-plugin-effect": {
       "types": "./src/oxlint-plugin-effect.d.ts",
       "default": "./src/oxlint-plugin-effect.js"
+    },
+    "./oxlint-plugin-style": {
+      "types": "./src/oxlint-plugin-style.d.ts",
+      "default": "./src/oxlint-plugin-style.js"
     }
   },
-  "files": [
-    "dev-kit.example.jsonc",
-    "bin/",
-    "schema/",
-    "skills/",
-    "skill-sources.jsonc",
-    "skill-sources.lock.json",
-    "src/"
-  ],
   "scripts": {
     "prepare": "./bin/dev-kit.mjs apply --locked",
     "dev-kit": "./bin/dev-kit.mjs",
     "changeset": "changeset",
     "version-packages": "changeset version && ./bin/dev-kit.mjs apply",
     "release": "changeset publish",
-    "check": "tsc --noEmit && vp lint",
     "lint": "vp lint",
     "plan": "./bin/dev-kit.mjs plan",
     "apply": "./bin/dev-kit.mjs apply",
     "gitignore": "./bin/dev-kit.mjs gitignore",
     "effect:sync": "./bin/dev-kit.mjs effect sync",
-    "test": "vitest run --config vitest.config.ts",
+    "test": "vp test",
     "test:watch": "vitest --config vitest.config.ts",
     "tsgo:patch": "./bin/dev-kit.mjs tsgo patch",
-    "typecheck": "tsc --noEmit",
     "catalog:refresh": "./bin/dev-kit.mjs catalog refresh",
     "catalog:check": "./bin/dev-kit.mjs catalog verify"
   },
   "dependencies": {
     "@effect/platform-node": "4.0.0-beta.102",
+    "@stylistic/eslint-plugin": "5.10.0",
     "effect": "4.0.0-beta.102",
     "jsonc-parser": "3.3.1",
     "tsx": "4.22.4"

package/schema/dev-kit.schema.json

@@ -34,6 +34,9 @@
       "type": "object",
       "additionalProperties": false,
       "properties": {
+        "agentInstructions": {
+          "$ref": "#/$defs/agentInstructionsSetup"
+        },
         "claudeInstructions": {
           "$ref": "#/$defs/claudeInstructionsSetup"
         },
@@ -42,6 +45,9 @@
         },
         "effectTsgo": {
           "$ref": "#/$defs/effectTsgoSetup"
+        },
+        "vitePlus": {
+          "$ref": "#/$defs/vitePlusSetup"
         }
       },
       "default": {}
@@ -61,6 +67,17 @@
   },
   "required": ["include"],
   "$defs": {
+    "agentInstructionsSetup": {
+      "description": "Manage a project-root AGENTS.md wrapper with dev-kit guidance and conditional tool instructions.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false
+        }
+      }
+    },
     "claudeInstructionsSetup": {
       "description": "Manage CLAUDE.md as a relative symlink to the project-root AGENTS.md file.",
       "type": "object",
@@ -119,6 +136,41 @@
         }
       }
     },
+    "vitePlusSetup": {
+      "description": "Manage project-local Vite+ setup tasks.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "hooks": {
+          "$ref": "#/$defs/vitePlusHooksSetup"
+        },
+        "quality": {
+          "$ref": "#/$defs/vitePlusQualitySetup"
+        }
+      }
+    },
+    "vitePlusHooksSetup": {
+      "description": "Run the installed Vite+ configurator to converge Git hook dispatchers in each worktree.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false
+        }
+      }
+    },
+    "vitePlusQualitySetup": {
+      "description": "Manage the canonical Vite+ quality config and GitHub Actions workflow for supported Effect TypeScript-Go repositories.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false
+        }
+      }
+    },
     "target": {
       "type": "object",
       "additionalProperties": false,

package/skill-sources.jsonc

@@ -14,12 +14,10 @@
         "improve-animations",
         "pick-ui-library",
         "prototype",
-        "review-animations"
+        "review-animations",
       ],
       "licensePath": "LICENSE",
-      "stripFrontmatter": [
-        "disable-model-invocation"
-      ]
+      "stripFrontmatter": ["disable-model-invocation"],
     },
     {
       "id": "cloudflare-skills",
@@ -37,19 +35,17 @@
         "turnstile-spin",
         "web-perf",
         "workers-best-practices",
-        "wrangler"
+        "wrangler",
       ],
-      "licensePath": "LICENSE"
+      "licensePath": "LICENSE",
     },
     {
       "id": "evanbacon-serve-sim",
       "repository": "https://github.com/EvanBacon/serve-sim.git",
       "ref": "main",
       "skillsPath": "skills",
-      "include": [
-        "serve-sim"
-      ],
-      "licensePath": "LICENSE"
-    }
-  ]
+      "include": ["serve-sim"],
+      "licensePath": "LICENSE",
+    },
+  ],
 }

package/skill-sources.lock.json

@@ -48,9 +48,7 @@
         "review-animations": "sha256:d78c312f4102c0243fb524f85d1fd999e8c413a5afbef9ac3c7fe054fbb84570"
       },
       "licensePath": "LICENSE",
-      "stripFrontmatter": [
-        "disable-model-invocation"
-      ]
+      "stripFrontmatter": ["disable-model-invocation"]
     },
     {
       "id": "cloudflare-skills",
@@ -118,12 +116,8 @@
       "ref": "main",
       "resolved": "14ad57ff922551bf7be81e907ddfcfa6191e64f2",
       "skillsPath": "skills",
-      "include": [
-        "serve-sim"
-      ],
-      "skills": [
-        "serve-sim"
-      ],
+      "include": ["serve-sim"],
+      "skills": ["serve-sim"],
       "descriptions": {
         "serve-sim": "Control and stream a running iOS, iPad, or Apple Watch Simulator with npx serve-sim. Use for simulator preview, taps, gestures, hardware buttons, rotation, camera injection, permissions, accessibility, and CoreAnimation debug."
       },