create-cogitator-app 0.1.0 → 0.1.1

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` | `qwen2.5:7b` | [Ollama](https://ollama.com) installed locally |
+| `openai` | `gpt-4o` | `OPENAI_API_KEY` |
+| `anthropic` | `claude-sonnet-4-20250514` | `ANTHROPIC_API_KEY` |
+| `google` | `gemini-2.5-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

@@ -27,7 +27,7 @@ var defaultModels = {
   ollama: "qwen2.5:7b",
   openai: "gpt-4o",
   anthropic: "claude-sonnet-4-20250514",
-  google: "gemini-2.0-flash"
+  google: "gemini-2.5-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,7 +975,7 @@ 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",
@@ -991,11 +984,12 @@ async function collectOptions(args) {
       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"
     ]
@@ -1242,10 +1241,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,7 +1273,7 @@ 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") {
@@ -1286,6 +1285,9 @@ function collectFiles(options) {
   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);