@box-kite/react 2.2.13 → 2.2.14

package/AGENTS.md

@@ -19,7 +19,7 @@ BOX_KITE_AI_CONTEXT.md      the long-form reference
 .cursor/rules/box-kite.mdc  the rules as a Cursor rule
 ```
 
-Inside a consumer's tree they are under `node_modules/@box-kite/react/`. Copy this file to the repo root as `AGENTS.md` — or point the one already there at it — so it is read on every run rather than when someone thinks to look.
+Inside a consumer's tree they are under `node_modules/@box-kite/react/`. The repo root's `AGENTS.md` should point here, so this is read on every run rather than when someone thinks to look: `npm create @box-kite@latest -- --agents-only` adds that pointer (into the `AGENTS.md` already there, if there is one), a `CLAUDE.md` and the MCP server to the project.
 
 ## What a component looks like
 

package/README.md

@@ -728,12 +728,18 @@ behaviour hooks (`docs/a11y.md`). All of it is generated during the build from t
 rules file and the built chunks' own exports, so none of it can drift from the library it describes.
 
 ```shell
-cp node_modules/@box-kite/react/AGENTS.md ./AGENTS.md
+npm create @box-kite@latest -- --agents-only
 ```
 
+That adds a root `AGENTS.md` (merged into yours, if you have one) with the four facts a model gets wrong
+and a pointer to the package's own, so an upgrade brings the rules with it; a `CLAUDE.md` importing it;
+and the MCP server below, in `.mcp.json` and in the config of each editor whose folder is there. Run again,
+it updates rather than repeats. `npm create @box-kite` writes all of it into a new app already
+(`--no-agents` leaves it out).
+
 Codex, Cursor, Copilot, VS Code, Windsurf, Cline and Zed read a root `AGENTS.md` natively; Claude
-Code reads `CLAUDE.md`, so a file holding the one line `@AGENTS.md` points it at the same place. The
-long-form [BOX_KITE_AI_CONTEXT.md](src/BOX_KITE_AI_CONTEXT.md) ships in the tarball too.
+Code reads `CLAUDE.md`, which is why the one line `@AGENTS.md` is there. The long-form
+[BOX_KITE_AI_CONTEXT.md](src/BOX_KITE_AI_CONTEXT.md) ships in the tarball too.
 
 The same rules are also a skill, which roughly forty-five coding agents install with one command:
 

package/create/src/agents.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The block a project's `AGENTS.md` carries: the four facts a model gets wrong from memory, then where the
+ * whole rules are. It points into `node_modules` rather than copying them, so an upgrade brings the rules with it.
+ */
+export declare function agentsBlock(facts: readonly string[]): string;
+/** An `AGENTS.md` with the block in it: the one already there replaced, or the block added at the end. */
+export declare function withAgentsBlock(existing: string | undefined, block: string): string;
+/** A `CLAUDE.md` that imports `AGENTS.md`, which is how Claude Code reads it; unchanged when it already does. */
+export declare function withClaudeImport(existing: string | undefined): string;
+/** An MCP config with the server in it, or `null` when the file is not JSON we can safely rewrite (VS Code allows comments). */
+export declare function withMcpServer(existing: string | undefined, key: string, entry: object): string | null;
+export interface AgentFilesResult {
+    /** The files written or changed; a file already right is left out. */
+    written: string[];
+    /** Files that needed the server and could not be rewritten, for the reader to edit by hand. */
+    skipped: string[];
+}
+/**
+ * Writes the agent files into a project. `editors: 'all'` writes every tool's MCP config (a new app, where no
+ * editor folder exists yet); `'present'` writes only those whose editor folder is there (an existing project).
+ */
+export declare function writeAgentFiles(directory: string, facts: readonly string[], editors: 'all' | 'present'): AgentFilesResult;

package/create/src/agents.test.d.ts

@@ -0,0 +1 @@
+export {};

package/create/src/options.d.ts

@@ -14,6 +14,10 @@ export interface CreateOptions {
     overwrite: boolean;
     /** Passed through to create-vite, which swaps Oxlint for ESLint. */
     eslint?: boolean;
+    /** `false` leaves out AGENTS.md, CLAUDE.md and the MCP configs. */
+    agents: boolean;
+    /** Writes only the agent files, into a project that already exists. */
+    agentsOnly: boolean;
     help: boolean;
     version: boolean;
 }

package/create/src/project.d.ts

@@ -8,6 +8,8 @@ export interface Templates {
     ts: TemplateSet;
     js: TemplateSet;
     fonts: Record<Design, string[]>;
+    /** The four facts `AGENTS.md`'s lead block states, for the project's own `AGENTS.md`. */
+    facts: string[];
 }
 export interface ApplyOptions {
     template: Template;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@box-kite/react",
-  "version": "2.2.13",
+  "version": "2.2.14",
   "type": "module",
   "sideEffects": [
     "pages/**"
@@ -653,7 +653,7 @@
     "react-dom": "^16.14.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@box-kite/core": "2.2.13",
+    "@box-kite/core": "2.2.14",
     "csstype": "^3.2.3",
     "use-sync-external-store": "^1.6.0"
   },