feat: add presets and ai chat module

Author: jesseoue

README.md

@@ -112,9 +112,11 @@ Current local prototype:
 
 ```bash
 node apps/cli/src/cli.mjs list
+node apps/cli/src/cli.mjs presets
 node apps/cli/src/cli.mjs validate
 node apps/cli/src/cli.mjs build
 node apps/cli/src/cli.mjs add api-keys --target ../some-app --dry-run
+node apps/cli/src/cli.mjs add preset next-saas --target ../some-app --dry-run
 node apps/cli/src/cli.mjs diff api-keys --target ../some-app
 ```
 

ROADMAP.md

@@ -9,6 +9,9 @@
 - [x] `stackfoundry add <module>` prototype
 - [x] file hash manifest
 - [x] `stackfoundry diff <module>` prototype
+- [x] preset manifests
+- [x] `stackfoundry add preset <name>` prototype
+- [x] `ai-chat` manifest and source template
 - [ ] overwrite conflict UI
 - [ ] generated install report
 - [ ] public demo app

apps/cli/src/cli.mjs

@@ -9,25 +9,37 @@ const __filename = fileURLToPath(import.meta.url);
 const repoRoot = path.resolve(path.dirname(__filename), "../../..");
 const registryRoot = path.join(repoRoot, "registry");
 const modulesRoot = path.join(registryRoot, "modules");
+const presetsRoot = path.join(registryRoot, "presets");
 
 const requiredModuleFields = ["name", "type", "category", "title", "description", "files", "status"];
+const requiredPresetFields = ["name", "title", "description", "modules", "status"];
 
 function usage() {
   console.log(`StackFoundry
 
 Usage:
   stackfoundry list
+  stackfoundry presets
   stackfoundry validate
   stackfoundry build
+  stackfoundry add preset <name> [--target <dir>] [--dry-run] [--force]
   stackfoundry add <module> [--target <dir>] [--dry-run] [--force]
   stackfoundry diff <module> [--target <dir>]
 `);
 }
 
 function parseArgs(argv) {
-  const [command, moduleName, ...rest] = argv;
+  const [command, firstArg, ...tail] = argv;
+  let moduleName = firstArg;
+  let presetName;
+  let rest = tail;
   const flags = { target: process.cwd(), dryRun: false, force: false };
 
+  if (command === "add" && firstArg === "preset") {
+    presetName = rest.shift();
+    moduleName = undefined;
+  }
+
   for (let i = 0; i < rest.length; i += 1) {
     const arg = rest[i];
     if (arg === "--target") {
@@ -41,7 +53,7 @@ function parseArgs(argv) {
     }
   }
 
-  return { command, moduleName, flags };
+  return { command, moduleName, presetName, flags };
 }
 
 async function readJson(filePath) {
@@ -82,6 +94,14 @@ async function getModule(name) {
   };
 }
 
+async function getPreset(name) {
+  const presetPath = path.join(presetsRoot, `${name}.json`);
+  if (!existsSync(presetPath)) {
+    throw new Error(`Unknown preset: ${name}`);
+  }
+  return readJson(presetPath);
+}
+
 async function validateModule(moduleDir) {
   const manifestPath = path.join(moduleDir, "module.json");
   const manifest = await readJson(manifestPath);
@@ -132,6 +152,22 @@ async function validateRegistry() {
     }
   }
 
+  if (existsSync(presetsRoot)) {
+    for (const file of await readdir(presetsRoot)) {
+      if (!file.endsWith(".json")) continue;
+      const preset = await readJson(path.join(presetsRoot, file));
+      for (const field of requiredPresetFields) {
+        if (!(field in preset)) errors.push(`${file}: missing field: ${field}`);
+      }
+      if (!Array.isArray(preset.modules)) errors.push(`${file}: modules must be an array`);
+      for (const moduleName of preset.modules ?? []) {
+        if (!existsSync(path.join(modulesRoot, moduleName, "module.json"))) {
+          errors.push(`${file}: unknown module ${moduleName}`);
+        }
+      }
+    }
+  }
+
   return errors;
 }
 
@@ -143,6 +179,15 @@ async function listModules() {
   }
 }
 
+async function listPresets() {
+  if (!existsSync(presetsRoot)) return;
+  const files = (await readdir(presetsRoot)).filter((file) => file.endsWith(".json")).sort();
+  for (const file of files) {
+    const preset = await readJson(path.join(presetsRoot, file));
+    console.log(`${preset.name.padEnd(18)} ${preset.status.padEnd(12)} ${preset.description}`);
+  }
+}
+
 async function loadInstallManifest(target) {
   const filePath = path.join(target, ".stackfoundry", "installed.json");
   if (!existsSync(filePath)) return { modules: {} };
@@ -155,8 +200,15 @@ async function saveInstallManifest(target, manifest) {
   await writeFile(path.join(dir, "installed.json"), `${JSON.stringify(manifest, null, 2)}\n`);
 }
 
-async function addModule(name, flags) {
+async function addModule(name, flags, visited = new Set()) {
+  if (visited.has(name)) return;
+  visited.add(name);
+
   const { dir, manifest } = await getModule(name);
+  for (const dependency of manifest.registryDependencies) {
+    await addModule(dependency, flags, visited);
+  }
+
   const filesDir = path.join(dir, "files");
   const sourceFiles = await listFiles(filesDir);
   const installed = await loadInstallManifest(flags.target);
@@ -217,6 +269,16 @@ async function addModule(name, flags) {
   }
 }
 
+async function addPreset(name, flags) {
+  if (!name) throw new Error("add preset requires a preset name");
+  const preset = await getPreset(name);
+  const visited = new Set();
+  console.log(`${flags.dryRun ? "would install" : "installing"} preset ${preset.name}`);
+  for (const moduleName of preset.modules) {
+    await addModule(moduleName, flags, visited);
+  }
+}
+
 async function diffModule(name, flags) {
   const { dir } = await getModule(name);
   const filesDir = path.join(dir, "files");
@@ -259,6 +321,15 @@ async function buildRegistry() {
 
   await writeFile(path.join(outputDir, "registry.json"), `${JSON.stringify(builtRegistry, null, 2)}\n`);
 
+  const presetsOutputDir = path.join(outputDir, "presets");
+  await mkdir(presetsOutputDir, { recursive: true });
+  if (existsSync(presetsRoot)) {
+    for (const file of (await readdir(presetsRoot)).filter((entry) => entry.endsWith(".json")).sort()) {
+      await copyFile(path.join(presetsRoot, file), path.join(presetsOutputDir, file));
+      console.log(`built public/r/presets/${file}`);
+    }
+  }
+
   for (const item of registry.items) {
     const { dir, manifest } = await getModule(item.name);
     const filesDir = path.join(dir, "files");
@@ -300,14 +371,15 @@ async function buildRegistry() {
 }
 
 async function main() {
-  const { command, moduleName, flags } = parseArgs(process.argv.slice(2));
+  const { command, moduleName, presetName, flags } = parseArgs(process.argv.slice(2));
 
   if (!command || command === "help" || command === "--help") {
     usage();
     return;
   }
 
   if (command === "list") return listModules();
+  if (command === "presets") return listPresets();
   if (command === "build") return buildRegistry();
   if (command === "validate") {
     const errors = await validateRegistry();
@@ -320,6 +392,7 @@ async function main() {
     return;
   }
 
+  if (command === "add" && presetName) return addPreset(presetName, flags);
   if (!moduleName) throw new Error(`${command} requires a module name`);
   if (command === "add") return addModule(moduleName, flags);
   if (command === "diff") return diffModule(moduleName, flags);

docs/registry.md

@@ -40,9 +40,11 @@ Installers must not overwrite modified user files silently. The installer should
 
 ```bash
 node apps/cli/src/cli.mjs list
+node apps/cli/src/cli.mjs presets
 node apps/cli/src/cli.mjs validate
 node apps/cli/src/cli.mjs build
 node apps/cli/src/cli.mjs add drizzle-postgres --target /path/to/app
+node apps/cli/src/cli.mjs add preset next-saas --target /path/to/app
 node apps/cli/src/cli.mjs diff drizzle-postgres --target /path/to/app
 ```
 
@@ -56,6 +58,8 @@ public/r/
   drizzle-postgres.json
   api-keys.json
   stripe-billing.json
+  presets/
+    next-saas.json
 ```
 
 This mirrors the source-registry pattern: the registry item JSON embeds file contents while module metadata stays in `registry/modules/<module>/module.json`.

package.json

@@ -17,7 +17,7 @@
     "validate": "node apps/cli/src/cli.mjs validate",
     "registry:build": "node apps/cli/src/cli.mjs build",
     "lint": "node --check apps/cli/src/cli.mjs",
-    "test": "rm -rf /tmp/stackfoundry-test && mkdir -p /tmp/stackfoundry-test && node apps/cli/src/cli.mjs list >/dev/null && node apps/cli/src/cli.mjs add api-keys --target /tmp/stackfoundry-test >/dev/null && node apps/cli/src/cli.mjs diff api-keys --target /tmp/stackfoundry-test >/dev/null",
+    "test": "rm -rf /tmp/stackfoundry-test && mkdir -p /tmp/stackfoundry-test && node apps/cli/src/cli.mjs list >/dev/null && node apps/cli/src/cli.mjs presets >/dev/null && node apps/cli/src/cli.mjs add api-keys --target /tmp/stackfoundry-test >/dev/null && node apps/cli/src/cli.mjs diff api-keys --target /tmp/stackfoundry-test >/dev/null && node apps/cli/src/cli.mjs add preset next-saas --target /tmp/stackfoundry-test --dry-run >/dev/null",
     "build": "pnpm validate"
   },
   "keywords": [

public/r/ai-chat.json

@@ -4,14 +4,42 @@
   "type": "registry:item",
   "title": "AI Chat",
   "description": "AI SDK chat route, model selector, message persistence, and prompt input.",
-  "dependencies": [],
+  "dependencies": [
+    "ai",
+    "@ai-sdk/react",
+    "@ai-sdk/gateway"
+  ],
   "devDependencies": [],
   "registryDependencies": [],
-  "files": [],
+  "files": [
+    {
+      "path": "apps/web/src/app/api/ai/chat/route.ts",
+      "type": "registry:file",
+      "content": "import { convertToModelMessages, streamText, type UIMessage } from \"ai\";\n\nimport { getSelectedModel } from \"@/lib/ai/models\";\nimport { chatSystemPrompt } from \"@/lib/ai/prompts\";\n\nexport const maxDuration = 60;\n\ntype ChatRequest = {\n  messages?: UIMessage[];\n  message?: UIMessage;\n  model?: string;\n};\n\nexport async function POST(request: Request) {\n  const body = (await request.json()) as ChatRequest;\n  const messages = body.messages ?? (body.message ? [body.message] : []);\n\n  try {\n    const result = streamText({\n      model: getSelectedModel(body.model),\n      system: chatSystemPrompt,\n      messages: convertToModelMessages(messages),\n    });\n\n    return result.toUIMessageStreamResponse();\n  } catch (error) {\n    return Response.json(\n      { error: error instanceof Error ? error.message : \"Unable to start chat stream.\" },\n      { status: 400 },\n    );\n  }\n}\n"
+    },
+    {
+      "path": "apps/web/src/components/ai/chat-box.tsx",
+      "type": "registry:component",
+      "content": "\"use client\";\n\nimport { useChat } from \"@ai-sdk/react\";\nimport { DefaultChatTransport } from \"ai\";\nimport { ArrowUpIcon, SquareIcon } from \"lucide-react\";\nimport { useMemo, useState } from \"react\";\n\nexport function ChatBox() {\n  const [input, setInput] = useState(\"\");\n  const transport = useMemo(() => new DefaultChatTransport({ api: \"/api/ai/chat\" }), []);\n  const { messages, sendMessage, status, stop } = useChat({ transport });\n  const running = status === \"submitted\" || status === \"streaming\";\n\n  function submit() {\n    const text = input.trim();\n    if (!text || running) return;\n    sendMessage({ text });\n    setInput(\"\");\n  }\n\n  return (\n    <div className=\"flex flex-col gap-4 rounded-lg border p-4\">\n      <div className=\"flex flex-col gap-3\">\n        {messages.map((message) => (\n          <div key={message.id} className=\"rounded-md bg-muted p-3 text-sm\">\n            <div className=\"mb-1 font-medium\">{message.role}</div>\n            {message.parts.map((part, index) =>\n              part.type === \"text\" ? <p key={index}>{part.text}</p> : null,\n            )}\n          </div>\n        ))}\n      </div>\n      <div className=\"flex gap-2\">\n        <textarea\n          className=\"min-h-24 flex-1 rounded-md border bg-background p-3 text-sm\"\n          value={input}\n          onChange={(event) => setInput(event.target.value)}\n          placeholder=\"Ask a question...\"\n        />\n        {running ? (\n          <button className=\"rounded-md border px-3\" type=\"button\" onClick={stop}>\n            <SquareIcon />\n          </button>\n        ) : (\n          <button className=\"rounded-md border px-3\" type=\"button\" onClick={submit}>\n            <ArrowUpIcon />\n          </button>\n        )}\n      </div>\n    </div>\n  );\n}\n"
+    },
+    {
+      "path": "apps/web/src/lib/ai/prompts.ts",
+      "type": "registry:file",
+      "content": "export const chatSystemPrompt = `You are a concise assistant inside a production SaaS application.\n\nAnswer directly, ask for missing critical context only when necessary, and avoid exposing internal implementation details.`;\n"
+    },
+    {
+      "path": "apps/web/src/lib/ai/models.ts",
+      "type": "registry:file",
+      "content": "export const DEFAULT_AI_MODEL = process.env.AI_GATEWAY_MODEL;\n\nexport function getSelectedModel(model?: string) {\n  const selected = model || DEFAULT_AI_MODEL;\n  if (!selected) {\n    throw new Error(\"AI_GATEWAY_MODEL is not set.\");\n  }\n  return selected;\n}\n"
+    }
+  ],
   "meta": {
     "category": "ai",
-    "env": [],
-    "status": "planned",
+    "env": [
+      "AI_GATEWAY_API_KEY",
+      "AI_GATEWAY_MODEL"
+    ],
+    "status": "experimental",
     "agents": {
       "skills": [
         "ai-chat"

public/r/presets/ai-saas.json

@@ -0,0 +1,15 @@
+{
+  "name": "ai-saas",
+  "title": "AI SaaS",
+  "description": "AI chat, artifacts, model routing, prompt library, and eval foundations.",
+  "modules": [
+    "drizzle-postgres",
+    "api-keys",
+    "ai-chat",
+    "ai-artifacts",
+    "model-router",
+    "prompt-library",
+    "evals"
+  ],
+  "status": "planned"
+}

public/r/presets/b2b-saas.json

@@ -0,0 +1,16 @@
+{
+  "name": "b2b-saas",
+  "title": "B2B SaaS",
+  "description": "Organizations, RBAC, billing, audit log, transactional email, and analytics.",
+  "modules": [
+    "drizzle-postgres",
+    "api-keys",
+    "clerk-auth",
+    "orgs-rbac",
+    "stripe-billing",
+    "audit-log",
+    "resend-email",
+    "posthog-analytics"
+  ],
+  "status": "planned"
+}

public/r/presets/cloudflare-native.json

@@ -0,0 +1,16 @@
+{
+  "name": "cloudflare-native",
+  "title": "Cloudflare Native",
+  "description": "Workers, Pages, D1, R2, KV, Queues, Turnstile, and Workers AI modules.",
+  "modules": [
+    "cloudflare-pages",
+    "cloudflare-workers",
+    "cloudflare-d1",
+    "cloudflare-r2",
+    "cloudflare-kv",
+    "cloudflare-queues",
+    "cloudflare-turnstile",
+    "cloudflare-workers-ai"
+  ],
+  "status": "planned"
+}

public/r/presets/developer-platform.json

@@ -0,0 +1,13 @@
+{
+  "name": "developer-platform",
+  "title": "Developer Platform",
+  "description": "API keys, public API foundations, webhook delivery, and developer portal modules.",
+  "modules": [
+    "drizzle-postgres",
+    "api-keys",
+    "public-api-orpc",
+    "webhook-delivery",
+    "developer-portal"
+  ],
+  "status": "planned"
+}