create-avocado-site 0.13.0 → 0.14.0

package/dist/generator.js

@@ -3,6 +3,7 @@ import { dirname, join } from "node:path";
 import { editorApiRoute, revalidateRoute, manifestFile, pageFile, middlewareFile, proxyFile, notFoundFile, envExample, } from "./templates/common.js";
 import { demoAppTemplates } from "./templates/demo-app.js";
 import { demoAssets } from "./templates/assets.js";
+import { agentSkills, agentsMd, claudeMd } from "./templates/agent-skills.js";
 import { sanityTemplates } from "./templates/sanity.js";
 import { contentfulTemplates } from "./templates/contentful.js";
 import { strapiTemplates } from "./templates/strapi.js";
@@ -38,6 +39,21 @@ export function collectDemoFiles(config) {
         { path: "app/api/editor/[...path]/route.ts", content: editorApiRoute(config) },
         { path: "lib/manifest.ts", content: manifestFile(config) },
         ...cmsTemplates(config),
+        ...agentInstructions(config),
+    ];
+}
+/*
+ * The agent's copy of the setup instructions, written into the project.
+ *
+ * Both modes get it. The demo is where somebody first asks their agent to
+ * change something, and the integrate path is where the instructions being
+ * wrong costs the most — see `templates/agent-skills.ts`.
+ */
+function agentInstructions(config) {
+    return [
+        { path: "AGENTS.md", content: agentsMd(config.siteId) },
+        { path: "CLAUDE.md", content: claudeMd() },
+        ...agentSkills(),
     ];
 }
 /** Wiring for a Next.js app that already exists. Touches nothing it did not create. */
@@ -57,6 +73,7 @@ export function collectFiles(config) {
         : { path: "middleware.ts", content: middlewareFile() });
     files.push({ path: ".env.local.example", content: envExample(config) });
     files.push(...cmsTemplates(config));
+    files.push(...agentInstructions(config));
     return files;
 }
 export async function generateFiles(cwd, files) {

package/dist/templates/agent-skills.d.ts

@@ -0,0 +1,4 @@
+import { agentsMd, claudeMd } from "@avocadostudio-ai/skills";
+import type { GeneratedFile } from "../types.js";
+export declare function agentSkills(): GeneratedFile[];
+export { agentsMd, claudeMd };

package/dist/templates/agent-skills.js

@@ -0,0 +1,21 @@
+import { agentsMd, claudeMd, skillFiles } from "@avocadostudio-ai/skills";
+/*
+ * The instructions an agent needs, written into the project rather than left on
+ * a web page.
+ *
+ * The bytes live in `@avocadostudio-ai/skills`, which is also what
+ * `npx @avocadostudio-ai/skills` installs into a repo that already exists. One
+ * copy, two delivery channels: a second copy here would be a second thing to
+ * keep true, and keeping two copies of the setup instructions true is the
+ * problem this whole arrangement exists to solve.
+ *
+ * `generateFiles` never clobbers, so re-running the scaffolder over a project
+ * that already has skills leaves them alone and reports them skipped. That is
+ * the right default *here* — the scaffolder is writing routes and config
+ * alongside them. The standalone command has the opposite rule for its own
+ * files, because delivering new instructions on upgrade is its entire job.
+ */
+export function agentSkills() {
+    return skillFiles().map((file) => ({ path: file.path, source: file.source }));
+}
+export { agentsMd, claudeMd };

package/dist/versions.d.ts

@@ -17,14 +17,23 @@
  * `@avocadostudio-ai/orchestrator-core`, already pinned there; naming it again
  * here is how a project ends up with two.
  */
-export declare const AVOCADO = "0.13.0";
+export declare const AVOCADO = "0.14.0";
 /**
- * Next 15.5.15 rather than 16, because that is the version every example app
+ * Next 15.5.25 rather than 16, because that is the version every example app
  * and the demo site in this repository build and test against. The SDK
  * supports 16 — `createEditorProxy` exists for exactly that — but a first run
  * should be on the version CI proves, not the newest one.
+ *
+ * Staying on 15 is the deliberate part. Staying on 15.5.15 was not: an exact
+ * pin is a version somebody has to keep moving, and this one sat still while
+ * twenty-three advisories accumulated against it, one of them an
+ * unauthenticated RCE in the image optimizer. Nothing here noticed, because
+ * nothing here looks — `pnpm audit` is not in the gate and the pin is a
+ * string constant no test has an opinion about. Bump it to the newest 15.x
+ * when you touch this file, and read `npm audit` output from a scaffolded
+ * project before a release rather than after one.
  */
-export declare const NEXT = "15.5.15";
+export declare const NEXT = "15.5.25";
 export declare const REACT = "^19.0.0";
 export declare const TYPESCRIPT = "^5.7.3";
 export declare const TYPES_NODE = "^22.13.10";

package/dist/versions.js

@@ -17,14 +17,23 @@
  * `@avocadostudio-ai/orchestrator-core`, already pinned there; naming it again
  * here is how a project ends up with two.
  */
-export const AVOCADO = "0.13.0";
+export const AVOCADO = "0.14.0";
 /**
- * Next 15.5.15 rather than 16, because that is the version every example app
+ * Next 15.5.25 rather than 16, because that is the version every example app
  * and the demo site in this repository build and test against. The SDK
  * supports 16 — `createEditorProxy` exists for exactly that — but a first run
  * should be on the version CI proves, not the newest one.
+ *
+ * Staying on 15 is the deliberate part. Staying on 15.5.15 was not: an exact
+ * pin is a version somebody has to keep moving, and this one sat still while
+ * twenty-three advisories accumulated against it, one of them an
+ * unauthenticated RCE in the image optimizer. Nothing here noticed, because
+ * nothing here looks — `pnpm audit` is not in the gate and the pin is a
+ * string constant no test has an opinion about. Bump it to the newest 15.x
+ * when you touch this file, and read `npm audit` output from a scaffolded
+ * project before a release rather than after one.
  */
-export const NEXT = "15.5.15";
+export const NEXT = "15.5.25";
 export const REACT = "^19.0.0";
 export const TYPESCRIPT = "^5.7.3";
 export const TYPES_NODE = "^22.13.10";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-avocado-site",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Bootstrap a runnable Avocado Studio demo site, or wire Avocado into an existing Next.js project",
   "type": "module",
   "bin": {
@@ -28,14 +28,15 @@
     "access": "public"
   },
   "dependencies": {
-    "@clack/prompts": "^0.9.1"
+    "@clack/prompts": "^0.9.1",
+    "@avocadostudio-ai/skills": "^0.14.0"
   },
   "devDependencies": {
     "@types/node": "^22.13.10",
     "tsx": "^4.19.0",
     "typescript": "^5.7.3",
-    "@avocadostudio-ai/shared": "0.13.0",
-    "@avocadostudio-ai/site-sdk": "0.13.0"
+    "@avocadostudio-ai/shared": "0.14.0",
+    "@avocadostudio-ai/site-sdk": "0.14.0"
   },
   "license": "Apache-2.0",
   "homepage": "https://docs.avocadostudio.dev",
@@ -43,7 +44,7 @@
     "url": "https://docs.avocadostudio.dev"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc -p tsconfig.build.json",
     "dev": "tsx src/index.ts",
     "typecheck": "tsc --noEmit",
     "test": "NODE_ENV=test node ../../scripts/run-tests.mjs"