create-cogitator-app 0.2.0 → 0.3.0

package/dist/index.js

@@ -2,17 +2,31 @@
 
 // src/index.ts
 import * as p3 from "@clack/prompts";
+import { readFileSync } from "fs";
 import pc2 from "picocolors";
 
 // src/utils/logger.ts
 import pc from "picocolors";
-function banner() {
+var MIN_INNER_WIDTH = 39;
+function banner(version) {
+  const title = "create-cogitator-app";
+  const tagline = "Build AI agents in minutes";
+  const versionLabel = `v${version}`;
+  const lines = [
+    {
+      text: `${pc.bold(pc.white(title))}  ${pc.dim(versionLabel)}`,
+      width: title.length + 2 + versionLabel.length
+    },
+    { text: pc.dim(tagline), width: tagline.length }
+  ];
+  const inner = Math.max(MIN_INNER_WIDTH, ...lines.map((line) => line.width + 4));
   const art = [
     "",
-    `  ${pc.cyan("\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557")}`,
-    `  ${pc.cyan("\u2551")}  ${pc.bold(pc.white("create-cogitator-app"))}  ${pc.dim("v0.1.0")}       ${pc.cyan("\u2551")}`,
-    `  ${pc.cyan("\u2551")}  ${pc.dim("Build AI agents in minutes")}          ${pc.cyan("\u2551")}`,
-    `  ${pc.cyan("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D")}`,
+    `  ${pc.cyan(`\u2554${"\u2550".repeat(inner)}\u2557`)}`,
+    ...lines.map(
+      (line) => `  ${pc.cyan("\u2551")}  ${line.text}${" ".repeat(inner - 2 - line.width)}${pc.cyan("\u2551")}`
+    ),
+    `  ${pc.cyan(`\u255A${"\u2550".repeat(inner)}\u255D`)}`,
     ""
   ];
   console.log(art.join("\n"));
@@ -70,6 +84,9 @@ function providerConfig(provider) {
   }
 }
 
+// src/templates/versions.ts
+var ZOD_VERSION = "^4.6.5";
+
 // src/templates/basic.ts
 var basicTemplate = {
   files(options) {
@@ -138,7 +155,7 @@ var basicTemplate = {
   dependencies() {
     return {
       "@cogitator-ai/core": "latest",
-      zod: "^3.23.0"
+      zod: ZOD_VERSION
     };
   },
   devDependencies() {
@@ -247,7 +264,7 @@ var memoryTemplate = {
       "@cogitator-ai/core": "latest",
       "@cogitator-ai/memory": "latest",
       "@cogitator-ai/redis": "latest",
-      zod: "^3.23.0"
+      zod: ZOD_VERSION
     };
   },
   devDependencies() {
@@ -368,7 +385,7 @@ var swarmTemplate = {
       `  })`,
       ``,
       `  console.log('Result:', result.output)`,
-      `  console.log('Strategy:', result.strategy)`,
+      `  console.log('Strategy:', team.strategyType)`,
       ``,
       `  await team.close()`,
       `}`,
@@ -388,7 +405,7 @@ var swarmTemplate = {
     return {
       "@cogitator-ai/core": "latest",
       "@cogitator-ai/swarms": "latest",
-      zod: "^3.23.0"
+      zod: ZOD_VERSION
     };
   },
   devDependencies() {
@@ -451,7 +468,7 @@ var workflowTemplate = {
       providerConfig(options.provider),
       `})`,
       ``,
-      `interface WorkflowState {`,
+      `type WorkflowState = {`,
       `  input: string`,
       `  analysis?: string`,
       `  processed?: string`,
@@ -512,7 +529,7 @@ var workflowTemplate = {
     return {
       "@cogitator-ai/core": "latest",
       "@cogitator-ai/workflows": "latest",
-      zod: "^3.23.0"
+      zod: ZOD_VERSION
     };
   },
   devDependencies() {
@@ -533,7 +550,9 @@ var workflowTemplate = {
 };
 
 // src/templates/api-server.ts
+var BASE_PATH = "/api";
 var apiServerTemplate = {
+  healthPath: `${BASE_PATH}/health`,
   files(options) {
     const model = defaultModels[options.provider];
     const agentsTs = [
@@ -585,7 +604,7 @@ var apiServerTemplate = {
       `  cogitator,`,
       `  agents: { assistant, coder },`,
       `  config: {`,
-      `    basePath: '/api',`,
+      `    basePath: '${BASE_PATH}',`,
       `    enableSwagger: true,`,
       `    cors: { origin: '*' },`,
       `    swagger: {`,
@@ -600,7 +619,7 @@ var apiServerTemplate = {
       ``,
       `  app.listen(port, () => {`,
       `    console.log(\`Server running at http://localhost:\${port}\`)`,
-      `    console.log(\`Swagger docs at http://localhost:\${port}/api/docs\`)`,
+      `    console.log(\`Swagger docs at http://localhost:\${port}${BASE_PATH}/docs\`)`,
       `  })`,
       `}`,
       ``,
@@ -616,8 +635,8 @@ var apiServerTemplate = {
     return {
       "@cogitator-ai/core": "latest",
       "@cogitator-ai/express": "latest",
-      express: "^4.21.0",
-      zod: "^3.23.0"
+      express: "^5.2.1",
+      zod: ZOD_VERSION
     };
   },
   devDependencies() {
@@ -625,7 +644,7 @@ var apiServerTemplate = {
       typescript: "^5.8.0",
       tsx: "^4.19.0",
       "@types/node": "^22.0.0",
-      "@types/express": "^5.0.0"
+      "@types/express": "^5.0.6"
     };
   },
   scripts() {
@@ -640,6 +659,7 @@ var apiServerTemplate = {
 
 // src/templates/nextjs.ts
 var nextjsTemplate = {
+  healthPath: "/api/health",
   files(options) {
     const model = defaultModels[options.provider];
     const agentTs = [
@@ -677,6 +697,12 @@ var nextjsTemplate = {
       `export const POST = createChatHandler(cogitator, agent)`,
       ``
     ].join("\n");
+    const healthRouteTs = [
+      `export function GET() {`,
+      `  return Response.json({ status: 'ok' })`,
+      `}`,
+      ``
+    ].join("\n");
     const pageTsx = [
       `'use client'`,
       ``,
@@ -843,6 +869,7 @@ var nextjsTemplate = {
     return [
       { path: "src/lib/agent.ts", content: agentTs },
       { path: "src/app/api/chat/route.ts", content: routeTs },
+      { path: "src/app/api/health/route.ts", content: healthRouteTs },
       { path: "src/app/page.tsx", content: pageTsx },
       { path: "src/app/layout.tsx", content: layoutTsx },
       { path: "src/app/globals.css", content: globalsCss },
@@ -859,7 +886,7 @@ var nextjsTemplate = {
       next: "^15.0.0",
       react: "^19.0.0",
       "react-dom": "^19.0.0",
-      zod: "^3.23.0"
+      zod: ZOD_VERSION
     };
   },
   devDependencies() {
@@ -966,6 +993,10 @@ function parseArgs(args) {
       parsed.git = true;
     } else if (arg === "--no-git") {
       parsed.git = false;
+    } else if (arg === "--install") {
+      parsed.install = true;
+    } else if (arg === "--no-install") {
+      parsed.install = false;
     } else if (arg === "-y" || arg === "--yes") {
       parsed.yes = true;
     } else if (!arg.startsWith("-") && !parsed.name) {
@@ -974,78 +1005,83 @@ function parseArgs(args) {
   }
   return parsed;
 }
-async function collectOptions(args) {
-  const rawName = args.name || await p.text({
-    message: "Where should we create your project?",
-    placeholder: "./my-agents",
-    defaultValue: "my-agents",
-    validate: (value) => {
-      if (value && !value.trim()) return "Project name is required";
-      return void 0;
-    }
-  });
-  if (p.isCancel(rawName)) {
+var defaultAnswers = {
+  name: "my-agents",
+  template: "basic",
+  provider: "ollama",
+  docker: true,
+  git: true
+};
+function unlessCancelled(answer) {
+  if (p.isCancel(answer)) {
     p.cancel("Operation cancelled.");
     process.exit(0);
   }
+  return answer;
+}
+async function collectOptions(args) {
+  const interactive = !args.yes;
+  const rawName = args.name || (interactive ? unlessCancelled(
+    await p.text({
+      message: "Where should we create your project?",
+      placeholder: `./${defaultAnswers.name}`,
+      defaultValue: defaultAnswers.name,
+      validate: (value) => {
+        if (value && !value.trim()) return "Project name is required";
+        return void 0;
+      }
+    })
+  ) : defaultAnswers.name);
   const name = rawName.trim();
   const projectName = path.basename(path.normalize(name).replace(/^\.\//, "").replace(/^\.\\/, ""));
   const projectPath = path.resolve(process.cwd(), name);
-  const template = args.template || await p.select({
-    message: "Which template would you like?",
-    options: templateChoices
-  });
-  if (p.isCancel(template)) {
-    p.cancel("Operation cancelled.");
-    process.exit(0);
-  }
-  const provider = args.provider || await p.select({
-    message: "Which LLM provider?",
-    options: [
-      {
-        value: "ollama",
-        label: "Ollama",
-        hint: "local, free \u2014 requires Ollama installed"
-      },
-      { value: "openai", label: "OpenAI", hint: "GPT-4o" },
-      { value: "anthropic", label: "Anthropic", hint: "Claude Sonnet" },
-      { value: "google", label: "Google Gemini", hint: "Gemini 2.5 Flash" }
-    ]
-  });
-  if (p.isCancel(provider)) {
-    p.cancel("Operation cancelled.");
-    process.exit(0);
-  }
-  const packageManager = args.packageManager || await p.select({
-    message: "Package manager?",
-    options: [
-      { value: "pnpm", label: "pnpm" },
-      { value: "npm", label: "npm" },
-      { value: "yarn", label: "yarn" },
-      { value: "bun", label: "bun" }
-    ],
-    initialValue: detectPackageManager()
-  });
-  if (p.isCancel(packageManager)) {
-    p.cancel("Operation cancelled.");
-    process.exit(0);
-  }
-  const docker = args.docker ?? await p.confirm({
-    message: "Include Docker Compose? (Redis + Postgres" + (provider === "ollama" ? " + Ollama)" : ")"),
-    initialValue: true
-  });
-  if (p.isCancel(docker)) {
-    p.cancel("Operation cancelled.");
-    process.exit(0);
-  }
-  const git = args.git ?? await p.confirm({
-    message: "Initialize git repository?",
-    initialValue: true
-  });
-  if (p.isCancel(git)) {
-    p.cancel("Operation cancelled.");
-    process.exit(0);
-  }
+  const template = args.template ?? (interactive ? unlessCancelled(
+    await p.select({
+      message: "Which template would you like?",
+      options: templateChoices,
+      initialValue: defaultAnswers.template
+    })
+  ) : defaultAnswers.template);
+  const provider = args.provider ?? (interactive ? unlessCancelled(
+    await p.select({
+      message: "Which LLM provider?",
+      options: [
+        {
+          value: "ollama",
+          label: "Ollama",
+          hint: `${defaultModels.ollama} \u2014 local, free, requires Ollama installed`
+        },
+        { value: "openai", label: "OpenAI", hint: defaultModels.openai },
+        { value: "anthropic", label: "Anthropic", hint: defaultModels.anthropic },
+        { value: "google", label: "Google Gemini", hint: defaultModels.google }
+      ],
+      initialValue: defaultAnswers.provider
+    })
+  ) : defaultAnswers.provider);
+  const packageManager = args.packageManager ?? (interactive ? unlessCancelled(
+    await p.select({
+      message: "Package manager?",
+      options: [
+        { value: "pnpm", label: "pnpm" },
+        { value: "npm", label: "npm" },
+        { value: "yarn", label: "yarn" },
+        { value: "bun", label: "bun" }
+      ],
+      initialValue: detectPackageManager()
+    })
+  ) : detectPackageManager());
+  const docker = args.docker ?? (interactive ? unlessCancelled(
+    await p.confirm({
+      message: "Include Docker Compose? (Redis + Postgres" + (provider === "ollama" ? " + Ollama)" : ")"),
+      initialValue: defaultAnswers.docker
+    })
+  ) : defaultAnswers.docker);
+  const git = args.git ?? (interactive ? unlessCancelled(
+    await p.confirm({
+      message: "Initialize git repository?",
+      initialValue: defaultAnswers.git
+    })
+  ) : defaultAnswers.git);
   return {
     name: projectName,
     path: projectPath,
@@ -1053,7 +1089,8 @@ async function collectOptions(args) {
     provider,
     packageManager,
     docker,
-    git
+    git,
+    ...args.install !== void 0 && { install: args.install }
   };
 }
 
@@ -1182,15 +1219,40 @@ function generateDockerCompose(provider) {
 }
 
 // src/templates/base/cogitator-yml.ts
-function generateCogitatorYml(provider) {
-  const model = defaultModels[provider];
-  const lines = [`provider: ${provider}`, `model: ${model}`, ""];
+function generateCogitatorYml(provider, template) {
+  const lines = [
+    "llm:",
+    `  defaultProvider: ${provider}`,
+    `  defaultModel: ${defaultModels[provider]}`
+  ];
   if (provider === "ollama") {
-    lines.push("ollama:", "  baseUrl: http://localhost:11434", "");
+    lines.push(
+      "  providers:",
+      "    ollama:",
+      "      baseUrl: ${OLLAMA_BASE_URL:-http://localhost:11434}"
+    );
+  }
+  if (template === "memory") {
+    lines.push(
+      "",
+      "memory:",
+      "  adapter: redis",
+      "  redis:",
+      "    url: ${REDIS_URL:-redis://localhost:6379}"
+    );
   }
+  const healthPath = template ? getTemplate(template).healthPath : void 0;
+  if (healthPath) {
+    lines.push("", "deploy:", "  health:", `    path: ${healthPath}`);
+  }
+  lines.push("");
   return { path: "cogitator.yml", content: lines.join("\n") };
 }
 
+// src/utils/links.ts
+var DOCS_URL = "https://cogitator.app/docs";
+var REPO_URL = "https://github.com/cogitator-ai/Cogitator-AI";
+
 // src/templates/base/readme.ts
 var templateNames = {
   basic: "Basic Agent",
@@ -1206,7 +1268,7 @@ function generateReadme(options) {
   const content = [
     `# ${options.name}`,
     "",
-    `> Created with [create-cogitator-app](https://github.com/cogitator-ai/cogitator) \u2014 ${templateName} template`,
+    `> Created with [create-cogitator-app](${REPO_URL}) \u2014 ${templateName} template`,
     "",
     "## Getting Started",
     "",
@@ -1221,8 +1283,8 @@ function generateReadme(options) {
     ...options.docker ? ["## Docker Services", "", "```bash", "docker compose up -d", "```", ""] : [],
     "## Learn More",
     "",
-    "- [Cogitator Documentation](https://cogitator.dev/docs)",
-    "- [GitHub Repository](https://github.com/cogitator-ai/cogitator)",
+    `- [Cogitator Documentation](${DOCS_URL})`,
+    `- [GitHub Repository](${REPO_URL})`,
     ""
   ];
   return { path: "README.md", content: content.join("\n") };
@@ -1240,22 +1302,38 @@ function generatePnpmWorkspace() {
 }
 
 // src/utils/git.ts
-import { execSync as execSync2 } from "child_process";
+import { execFileSync } from "child_process";
+var FALLBACK_IDENTITY = [
+  "-c",
+  "user.name=create-cogitator-app",
+  "-c",
+  "user.email=create-cogitator-app@localhost"
+];
 function isGitInstalled() {
   try {
-    execSync2("git --version", { stdio: "ignore" });
+    execFileSync("git", ["--version"], { stdio: "ignore" });
     return true;
   } catch {
     return false;
   }
 }
+function hasIdentity(cwd) {
+  try {
+    const name = execFileSync("git", ["config", "user.name"], { cwd, encoding: "utf8" }).trim();
+    const email = execFileSync("git", ["config", "user.email"], { cwd, encoding: "utf8" }).trim();
+    return name.length > 0 && email.length > 0;
+  } catch {
+    return false;
+  }
+}
 function initGitRepo(cwd) {
-  execSync2("git init", { cwd, stdio: "ignore" });
-  execSync2("git add -A", { cwd, stdio: "ignore" });
-  execSync2(
-    'git -c user.name="Cogitator" -c user.email="init@cogitator.dev" commit -m "feat: initial project scaffold"',
-    { cwd, stdio: "ignore" }
-  );
+  execFileSync("git", ["init"], { cwd, stdio: "ignore" });
+  execFileSync("git", ["add", "-A"], { cwd, stdio: "ignore" });
+  const identity = hasIdentity(cwd) ? [] : FALLBACK_IDENTITY;
+  execFileSync("git", [...identity, "commit", "-m", "feat: initial project scaffold"], {
+    cwd,
+    stdio: "ignore"
+  });
 }
 
 // src/scaffold.ts
@@ -1267,7 +1345,7 @@ function writeFile(basePath, file) {
 function buildPackageJson(options) {
   const template = getTemplate(options.template);
   const isNextjs = options.template === "nextjs";
-  const pkg = {
+  const pkg2 = {
     name: options.name,
     version: "0.1.0",
     private: true,
@@ -1276,7 +1354,7 @@ function buildPackageJson(options) {
     dependencies: template.dependencies(),
     devDependencies: template.devDependencies()
   };
-  return JSON.stringify(pkg, null, 2) + "\n";
+  return JSON.stringify(pkg2, null, 2) + "\n";
 }
 function collectFiles(options) {
   const template = getTemplate(options.template);
@@ -1285,7 +1363,7 @@ function collectFiles(options) {
   files.push(...template.files(options));
   files.push(generateGitignore());
   files.push(generateEnvExample(options.provider, options.template));
-  files.push(generateCogitatorYml(options.provider));
+  files.push(generateCogitatorYml(options.provider, options.template));
   files.push(generateReadme(options));
   if (options.template !== "nextjs") {
     files.push(generateTsconfig());
@@ -1298,6 +1376,17 @@ function collectFiles(options) {
   }
   return files;
 }
+function runStep(spinner2, messages, step) {
+  spinner2.start(messages.start);
+  try {
+    step();
+    spinner2.stop(messages.done);
+    return { status: "done" };
+  } catch (error) {
+    spinner2.stop(messages.failed);
+    return { status: "failed", error: error instanceof Error ? error : new Error(String(error)) };
+  }
+}
 async function scaffold(options) {
   if (fs.existsSync(options.path) && fs.readdirSync(options.path).length > 0) {
     throw new Error(`Directory "${options.path}" already exists and is not empty`);
@@ -1310,40 +1399,52 @@ async function scaffold(options) {
     writeFile(options.path, file);
   }
   s.stop("Generated project files");
-  s.start("Installing dependencies");
-  try {
-    installDependencies(options.path, options.packageManager);
-    s.stop("Installed dependencies");
-  } catch {
-    s.stop("Failed to install dependencies \u2014 run manually");
-  }
-  if (options.git && isGitInstalled()) {
-    s.start("Initializing git repository");
-    try {
-      initGitRepo(options.path);
-      s.stop("Initialized git repository");
-    } catch {
-      s.stop("Failed to initialize git \u2014 run manually");
-    }
-  }
+  const install = options.install === false ? { status: "skipped" } : runStep(
+    s,
+    {
+      start: "Installing dependencies",
+      done: "Installed dependencies",
+      failed: `Failed to install dependencies, run "${options.packageManager} install" yourself`
+    },
+    () => installDependencies(options.path, options.packageManager)
+  );
+  const git = options.git && isGitInstalled() ? runStep(
+    s,
+    {
+      start: "Initializing git repository",
+      done: "Initialized git repository",
+      failed: 'Failed to initialize git, run "git init" yourself'
+    },
+    () => initGitRepo(options.path)
+  ) : { status: "skipped" };
+  return { files: files.map((file) => file.path), install, git };
 }
 
 // src/index.ts
+var pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
 async function main() {
-  banner();
+  banner(pkg.version);
   p3.intro(pc2.cyan("Let's build something with AI agents"));
   const args = parseArgs(process.argv.slice(2));
   const options = await collectOptions(args);
-  await scaffold(options);
+  const result = await scaffold(options);
+  if (result.install.status === "failed") {
+    p3.log.warn(`${options.packageManager} install failed: ${result.install.error.message}`);
+  }
+  if (result.git.status === "failed") {
+    p3.log.warn(`git init failed: ${result.git.error.message}`);
+  }
   const dev = devCommand(options.packageManager);
+  const install = result.install.status === "done" ? [] : [`  ${pc2.cyan(`${options.packageManager} install`)}`];
   p3.outro(
     [
       pc2.green("Done! ") + "Next steps:",
       "",
       `  ${pc2.cyan("cd")} ${options.name}`,
+      ...install,
       `  ${pc2.cyan(dev)}`,
       "",
-      pc2.dim("Docs: https://cogitator.dev/docs")
+      pc2.dim(`Docs: ${DOCS_URL}`)
     ].join("\n")
   );
 }