@yysng/ai-edit-engine 2.1.1

package/README.md

@@ -0,0 +1,9 @@
+## 🔐 Production Stability Lock
+
+This site is locked to:
+
+- Boilerplate: `@yysng/astro-boilerplate@1.1.36`
+- Boilerplate Tag: `stable-edge-v1`
+- Client Tag: `stable-edge-v1`
+
+Validated on 2025-12-30.

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@yysng/ai-edit-engine",
+  "version": "2.1.1",
+  "type": "module",
+  "description": "AI Editing Engine for Astro sites (generation, validation, content mutation, Cloudflare-safe)",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./ui": "./src/ui/index.js",
+    "./api": "./src/api/index.js",
+    "./schemas": "./src/schemas/index.js"
+  },
+  "files": [
+    "src"
+  ],
+  "dependencies": {
+    "openai": "^6.13.0",
+    "zod": "^3.23.8"
+  },
+  "peerDependencies": {
+    "astro": "^5.0.0",
+    "@yysng/astro-boilerplate": "^1.1.36"
+  },
+  "keywords": [
+    "astro",
+    "ai",
+    "cms",
+    "content-engine",
+    "cloudflare",
+    "ai-editor"
+  ],
+  "license": "MIT"
+}

package/src/engine/api/ai-edit.js

@@ -0,0 +1,45 @@
+export const prerender = false;
+
+import * as Engine from "@yysng/astro-boilerplate";
+
+const { updateContent } = Engine;
+
+// --------------------------------------------------
+// 🧠 ENGINE API (used by npm consumers)
+// --------------------------------------------------
+export async function editContent({ section, content, env = {} }) {
+  if (!section || !content) {
+    throw new Error("Missing section or content");
+  }
+
+  return updateContent(section, content, env);
+}
+
+// --------------------------------------------------
+// 🌐 ASTRO ENDPOINT (used by playground / client site)
+// --------------------------------------------------
+export async function POST({ request, locals }) {
+  try {
+    const body = await request.json();
+    const { section, content } = body;
+
+    const result = await editContent({
+      section,
+      content,
+      env: locals?.runtime?.env
+    });
+
+    return new Response(
+      JSON.stringify({ success: true, updated: section, result }),
+      { status: 200 }
+    );
+
+  } catch (error) {
+    console.error("AI Edit Error:", error);
+
+    return new Response(
+      JSON.stringify({ error: "Internal error", message: error.message }),
+      { status: 500 }
+    );
+  }
+}

package/src/engine/api/ai-generate.js

@@ -0,0 +1,112 @@
+export const prerender = false;
+
+import OpenAI from "openai";
+
+// --------------------------------------------------
+// 🧠 ENGINE API (used by npm consumers)
+// --------------------------------------------------
+export async function generateContent({ instruction, section, env = {} }) {
+  if (!instruction || typeof instruction !== "string") {
+    throw new Error("Invalid instruction");
+  }
+
+  const client = new OpenAI({
+    apiKey: env.OPENAI_API_KEY
+  });
+
+  // ------------------------------
+  // CTA GENERATION
+  // ------------------------------
+  if (section === "cta") {
+    const prompt = `
+You are an AI editor responsible for updating the CTA section of a website.
+
+Rules:
+- Output JSON only
+- Follow the schema exactly
+- Prefer partial updates
+- Do not invent fields
+
+Return JSON ONLY in this exact format:
+
+{
+  "heading": string,
+  "description": string,
+  "button": {
+    "label": string,
+    "href": string
+  }
+}
+
+User instruction:
+${instruction}
+`;
+
+    const completion = await client.chat.completions.create({
+      model: "gpt-4o-mini",
+      messages: [{ role: "user", content: prompt }],
+      temperature: 0.7
+    });
+
+    return JSON.parse(completion.choices[0].message.content);
+  }
+
+  // ------------------------------
+  // HERO GENERATION
+  // ------------------------------
+  const heroPrompt = `
+You are an AI editor responsible for updating the hero section of a website.
+
+Rules:
+- Output JSON only
+- Follow the schema exactly
+- Prefer partial updates
+- Do not invent fields
+
+Return JSON ONLY in this exact format:
+
+{
+  "title": string,
+  "subtitle": string,
+  "cta": {
+    "label": string,
+    "href": string
+  }
+}
+
+User instruction:
+${instruction}
+`;
+
+  const completion = await client.chat.completions.create({
+    model: "gpt-4o-mini",
+    messages: [{ role: "user", content: heroPrompt }],
+    temperature: 0.7
+  });
+
+  return JSON.parse(completion.choices[0].message.content);
+}
+
+// --------------------------------------------------
+// 🌐 ASTRO ENDPOINT (used by playground / client site)
+// --------------------------------------------------
+export async function POST({ request, locals }) {
+  try {
+    const { instruction, section } = await request.json();
+
+    const result = await generateContent({
+      instruction,
+      section,
+      env: locals?.runtime?.env
+    });
+
+    return new Response(JSON.stringify(result), { status: 200 });
+
+  } catch (err) {
+    console.error("AI generate error:", err);
+    return new Response(
+      JSON.stringify({ error: "AI generation failed", message: err.message }),
+      { status: 500 }
+    );
+  }
+}

package/src/engine/index.js

@@ -0,0 +1,2 @@
+export { editContent } from "./api/ai-edit.js";
+export { generateContent } from "./api/ai-generate.js";

package/src/engine/permissions/ai/permission.json

@@ -0,0 +1,11 @@
+{
+  "allowedEdits": [
+    "content.hero",
+    "content.design.hero"
+  ],
+  "forbidden": [
+    "src/components/**",
+    "src/layouts/**",
+    "astro.config.*"
+  ]
+}

package/src/index.js

@@ -0,0 +1 @@
+export * from "./engine/index.js";