create-cogitator-app 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cogitator Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# create-cogitator-app
+
+Interactive CLI scaffolder for [Cogitator](https://cogitator.dev) — creates production-ready AI agent projects in seconds.
+
+## Usage
+
+```bash
+# Interactive mode
+npx create-cogitator-app
+
+# With arguments
+npx create-cogitator-app my-project --template basic --provider openai
+
+# Skip prompts with flags
+npx create-cogitator-app my-project -t swarm -p ollama --pm pnpm --docker --no-git
+```
+
+## Templates
+
+| Template     | Description                               |
+| ------------ | ----------------------------------------- |
+| `basic`      | Single agent with tools                   |
+| `memory`     | Agent with Redis-backed persistent memory |
+| `swarm`      | Multi-agent hierarchical swarm            |
+| `workflow`   | DAG workflow with sequential agent nodes  |
+| `api-server` | Express REST API with Cogitator backend   |
+| `nextjs`     | Next.js chat app with streaming UI        |
+
+## CLI Flags
+
+| Flag                       | Shorthand | Description                                              |
+| -------------------------- | --------- | -------------------------------------------------------- |
+| `--template <name>`        | `-t`      | Template to use                                          |
+| `--provider <name>`        | `-p`      | LLM provider (`ollama`, `openai`, `anthropic`, `google`) |
+| `--pm <name>`              |           | Package manager (`pnpm`, `npm`, `yarn`, `bun`)           |
+| `--docker` / `--no-docker` |           | Include Docker Compose                                   |
+| `--git` / `--no-git`       |           | Initialize git repository                                |
+
+## Providers
+
+| Provider    | Default Model       | Requires                                       |
+| ----------- | ------------------- | ---------------------------------------------- |
+| `ollama`    | `qwen3:8b`          | [Ollama](https://ollama.com) installed locally |
+| `openai`    | `gpt-6.1-sol`       | `OPENAI_API_KEY`                               |
+| `anthropic` | `claude-sonnet-5-5` | `ANTHROPIC_API_KEY`                            |
+| `google`    | `gemini-3.8-flash`  | `GOOGLE_API_KEY`                               |
+
+## Programmatic API
+
+```ts
+import { scaffold, parseArgs } from 'create-cogitator-app';
+import type { ProjectOptions } from 'create-cogitator-app';
+
+const options: ProjectOptions = {
+  name: 'my-agent',
+  path: '/path/to/my-agent',
+  template: 'basic',
+  provider: 'ollama',
+  packageManager: 'pnpm',
+  docker: false,
+  git: true,
+};
+
+await scaffold(options);
+```
+
+## Generated Project Structure
+
+```
+my-project/
+├── src/
+│   ├── index.ts      # Main entry point
+│   └── tools.ts      # Tool definitions
+├── package.json
+├── tsconfig.json
+├── cogitator.yml     # Cogitator configuration
+├── .env.example
+├── .gitignore
+└── README.md
+```
+
+## License
+
+MIT

package/dist/index.js

@@ -24,10 +24,10 @@ import path from "path";
 
 // src/utils/providers.ts
 var defaultModels = {
-  ollama: "qwen2.5:7b",
-  openai: "gpt-4o",
-  anthropic: "claude-sonnet-4-20250514",
-  google: "gemini-2.0-flash"
+  ollama: "qwen3:8b",
+  openai: "gpt-6.1-sol",
+  anthropic: "claude-sonnet-5-5",
+  google: "gemini-3.8-flash"
 };
 function providerConfig(provider) {
   switch (provider) {
@@ -351,11 +351,8 @@ var swarmTemplate = {
       `  supervisor: reviewer,`,
       `  workers: [researcher, writer],`,
       `  hierarchical: {`,
-      `    coordination: {`,
-      `      visibility: 'full',`,
-      `      workerCommunication: true,`,
-      `      maxParallelTasks: 2,`,
-      `    },`,
+      `    visibility: 'full',`,
+      `    workerCommunication: true,`,
       `  },`,
       `  resources: {`,
       `    maxConcurrency: 3,`,
@@ -447,7 +444,6 @@ var workflowTemplate = {
       `  WorkflowExecutor,`,
       `  agentNode,`,
       `  functionNode,`,
-      `  InMemoryCheckpointStore,`,
       `} from '@cogitator-ai/workflows'`,
       `import { analyzer, processor, formatter } from './agents.js'`,
       ``,
@@ -462,46 +458,37 @@ var workflowTemplate = {
       `  report?: string`,
       `}`,
       ``,
+      `const analyzeNode = agentNode<WorkflowState>(analyzer, {`,
+      `  inputMapper: (state) => \`Analyze the following: \${state.input}\`,`,
+      `  stateMapper: (result) => ({ analysis: result.output }),`,
+      `})`,
+      ``,
+      `const processNode = agentNode<WorkflowState>(processor, {`,
+      `  inputMapper: (state) => \`Process this analysis: \${state.analysis ?? ''}\`,`,
+      `  stateMapper: (result) => ({ processed: result.output }),`,
+      `})`,
+      ``,
+      `const formatNode = agentNode<WorkflowState>(formatter, {`,
+      `  inputMapper: (state) => \`Format this into a report: \${state.processed ?? ''}\`,`,
+      `  stateMapper: (result) => ({ report: result.output }),`,
+      `})`,
+      ``,
+      `const outputNode = functionNode<WorkflowState>(`,
+      `  'output',`,
+      `  async (state) => state.report,`,
+      `)`,
+      ``,
       `const workflow = new WorkflowBuilder<WorkflowState>('${options.name}-workflow')`,
       `  .initialState({ input: '' })`,
-      `  .entryPoint('analyze')`,
-      `  .addNode(`,
-      `    'analyze',`,
-      `    agentNode({`,
-      `      cogitator,`,
-      `      agent: analyzer,`,
-      `      prompt: (ctx) => \`Analyze the following: \${ctx.input.input}\`,`,
-      `    }),`,
-      `  )`,
-      `  .addNode(`,
-      `    'process',`,
-      `    agentNode({`,
-      `      cogitator,`,
-      `      agent: processor,`,
-      `      prompt: (ctx) => \`Process this analysis: \${ctx.results.analyze}\`,`,
-      `    }),`,
-      `    { after: ['analyze'] },`,
-      `  )`,
-      `  .addNode(`,
-      `    'format',`,
-      `    agentNode({`,
-      `      cogitator,`,
-      `      agent: formatter,`,
-      `      prompt: (ctx) => \`Format this into a report: \${ctx.results.process}\`,`,
-      `    }),`,
-      `    { after: ['process'] },`,
-      `  )`,
-      `  .addNode(`,
-      `    'output',`,
-      `    functionNode(async (ctx) => ({`,
-      `      report: ctx.results.format as string,`,
-      `    })),`,
-      `    { after: ['format'] },`,
-      `  )`,
+      `  .entryPoint(analyzeNode.name)`,
+      `  .addNode(analyzeNode.name, analyzeNode.fn)`,
+      `  .addNode(processNode.name, processNode.fn, { after: [analyzeNode.name] })`,
+      `  .addNode(formatNode.name, formatNode.fn, { after: [processNode.name] })`,
+      `  .addNode(outputNode.name, outputNode.fn, { after: [formatNode.name] })`,
       `  .build()`,
       ``,
       `async function main() {`,
-      `  const executor = new WorkflowExecutor(cogitator, new InMemoryCheckpointStore())`,
+      `  const executor = new WorkflowExecutor(cogitator)`,
       ``,
       `  console.log('Starting workflow...')`,
       ``,
@@ -957,14 +944,20 @@ function parseArgs(args) {
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg === "--template" || arg === "-t") {
-      const val = args[++i];
-      if (validTemplates.includes(val)) parsed.template = val;
+      if (i + 1 < args.length) {
+        const val = args[++i];
+        if (validTemplates.includes(val)) parsed.template = val;
+      }
     } else if (arg === "--provider" || arg === "-p") {
-      const val = args[++i];
-      if (validProviders.includes(val)) parsed.provider = val;
+      if (i + 1 < args.length) {
+        const val = args[++i];
+        if (validProviders.includes(val)) parsed.provider = val;
+      }
     } else if (arg === "--pm") {
-      const val = args[++i];
-      if (validPMs.includes(val)) parsed.packageManager = val;
+      if (i + 1 < args.length) {
+        const val = args[++i];
+        if (validPMs.includes(val)) parsed.packageManager = val;
+      }
     } else if (arg === "--docker") {
       parsed.docker = true;
     } else if (arg === "--no-docker") {
@@ -982,20 +975,21 @@ function parseArgs(args) {
   return parsed;
 }
 async function collectOptions(args) {
-  const name = args.name || await p.text({
+  const rawName = args.name || await p.text({
     message: "Where should we create your project?",
     placeholder: "./my-agents",
     defaultValue: "my-agents",
     validate: (value) => {
-      if (!value.trim()) return "Project name is required";
+      if (value && !value.trim()) return "Project name is required";
       return void 0;
     }
   });
-  if (p.isCancel(name)) {
+  if (p.isCancel(rawName)) {
     p.cancel("Operation cancelled.");
     process.exit(0);
   }
-  const projectName = path.basename(name.replace(/^\.\//, ""));
+  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?",
@@ -1015,7 +1009,7 @@ async function collectOptions(args) {
       },
       { value: "openai", label: "OpenAI", hint: "GPT-4o" },
       { value: "anthropic", label: "Anthropic", hint: "Claude Sonnet" },
-      { value: "google", label: "Google Gemini", hint: "Gemini 2.0 Flash" }
+      { value: "google", label: "Google Gemini", hint: "Gemini 2.5 Flash" }
     ]
   });
   if (p.isCancel(provider)) {
@@ -1114,7 +1108,7 @@ function generateGitignore() {
 }
 
 // src/templates/base/env-example.ts
-function generateEnvExample(provider) {
+function generateEnvExample(provider, template) {
   const lines = ["# Cogitator Environment Variables", ""];
   switch (provider) {
     case "ollama":
@@ -1134,6 +1128,11 @@ function generateEnvExample(provider) {
       lines.push("GOOGLE_API_KEY=...");
       break;
   }
+  if (template === "memory") {
+    lines.push("");
+    lines.push("# Redis");
+    lines.push("REDIS_URL=redis://localhost:6379");
+  }
   lines.push("");
   return { path: ".env.example", content: lines.join("\n") };
 }
@@ -1168,9 +1167,9 @@ function generateDockerCompose(provider) {
       "    ports:",
       '      - "5432:5432"',
       "    environment:",
-      "      POSTGRES_USER: cogitator",
-      "      POSTGRES_PASSWORD: cogitator",
-      "      POSTGRES_DB: cogitator",
+      "      POSTGRES_USER: ${POSTGRES_USER:-cogitator}",
+      "      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-cogitator}",
+      "      POSTGRES_DB: ${POSTGRES_DB:-cogitator}",
       "    volumes:",
       "      - postgres_data:/var/lib/postgresql/data"
     ]
@@ -1229,6 +1228,17 @@ function generateReadme(options) {
   return { path: "README.md", content: content.join("\n") };
 }
 
+// src/templates/base/pnpm-workspace.ts
+var PNPM_ALLOWED_BUILDS = ["better-sqlite3", "esbuild", "sharp"];
+function generatePnpmWorkspace() {
+  return {
+    path: "pnpm-workspace.yaml",
+    content: ["allowBuilds:", ...PNPM_ALLOWED_BUILDS.map((name) => `  ${name}: true`), ""].join(
+      "\n"
+    )
+  };
+}
+
 // src/utils/git.ts
 import { execSync as execSync2 } from "child_process";
 function isGitInstalled() {
@@ -1242,10 +1252,10 @@ function isGitInstalled() {
 function initGitRepo(cwd) {
   execSync2("git init", { cwd, stdio: "ignore" });
   execSync2("git add -A", { cwd, stdio: "ignore" });
-  execSync2('git commit -m "initial commit from create-cogitator-app"', {
-    cwd,
-    stdio: "ignore"
-  });
+  execSync2(
+    'git -c user.name="Cogitator" -c user.email="init@cogitator.dev" commit -m "feat: initial project scaffold"',
+    { cwd, stdio: "ignore" }
+  );
 }
 
 // src/scaffold.ts
@@ -1274,18 +1284,24 @@ function collectFiles(options) {
   files.push({ path: "package.json", content: buildPackageJson(options) });
   files.push(...template.files(options));
   files.push(generateGitignore());
-  files.push(generateEnvExample(options.provider));
+  files.push(generateEnvExample(options.provider, options.template));
   files.push(generateCogitatorYml(options.provider));
   files.push(generateReadme(options));
   if (options.template !== "nextjs") {
     files.push(generateTsconfig());
   }
+  if (options.packageManager === "pnpm") {
+    files.push(generatePnpmWorkspace());
+  }
   if (options.docker) {
     files.push(generateDockerCompose(options.provider));
   }
   return files;
 }
 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`);
+  }
   const s = p2.spinner();
   s.start("Generating project files");
   const files = collectFiles(options);