@orchestrator-claude/cli 3.1.12 → 3.2.0

package/templates/default/docker-compose.yml

@@ -1,20 +1,200 @@
-version: '3.8'
+# docker-compose.yml — Generated by orchestrator init
+# Stack: PostgreSQL (state) + MinIO (artifacts) + Neo4j (knowledge graph, optional) + API
+#
+# Ports:
+#   API:        http://localhost:3001   (orchestrator REST API + MCP server)
+#   PostgreSQL: localhost:5432          (workflow state - direct access)
+#   MinIO S3:   http://localhost:9000   (artifact storage - S3 API)
+#   MinIO UI:   http://localhost:9001   (MinIO console)
+#   Neo4j HTTP: http://localhost:7474   (knowledge graph browser - requires --profile knowledge-graph)
+#   Neo4j Bolt: bolt://localhost:7687   (knowledge graph driver - requires --profile knowledge-graph)
+#
+# Usage:
+#   docker compose up -d                           # Start core services (API + PostgreSQL)
+#   docker compose --profile object-storage up -d  # Add MinIO
+#   docker compose --profile knowledge-graph up -d # Add Neo4j
+#   docker compose --profile full up -d            # Start everything
 
 services:
-  orchestrator-api:
-    image: cmac01/orchestrator-api:{{orchestratorVersion}}
-    container_name: {{projectName}}-orchestrator-api
+  postgres:
+    image: postgres:15-alpine
+    container_name: my-project-postgres
+    environment:
+      POSTGRES_DB: ${POSTGRES_DB:-orchestrator}
+      POSTGRES_USER: ${POSTGRES_USER:-orchestrator}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+    volumes:
+      - my-project-postgres-data:/var/lib/postgresql/data
+    ports:
+      - "${POSTGRES_PORT:-5432}:5432"  # PostgreSQL
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-orchestrator} -d ${POSTGRES_DB:-orchestrator}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+    restart: unless-stopped
+    networks:
+      - my-project-network
+
+  neo4j:
+    image: neo4j:5-community
+    container_name: my-project-neo4j
+    environment:
+      NEO4J_AUTH: neo4j/${NEO4J_PASSWORD:-orchestrator_neo4j}
+      NEO4J_PLUGINS: '["apoc"]'
+      NEO4J_dbms_memory_pagecache_size: 512M
+      NEO4J_dbms_memory_heap_initial__size: 512M
+      NEO4J_dbms_memory_heap_max__size: 1G
+      NEO4J_dbms_security_procedures_unrestricted: apoc.*
+      NEO4J_dbms_security_procedures_allowlist: apoc.*
+    ports:
+      - "${NEO4J_HTTP_PORT:-7474}:7474"   # Neo4j browser
+      - "${NEO4J_BOLT_PORT:-7687}:7687"   # Neo4j bolt
+    volumes:
+      - my-project-neo4j-data:/data
+      - my-project-neo4j-logs:/logs
+    healthcheck:
+      test: ["CMD", "wget", "-qO-", "http://localhost:7474"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 20s
+    restart: unless-stopped
+    networks:
+      - my-project-network
+    profiles:
+      - knowledge-graph
+      - full
+
+  minio:
+    image: minio/minio:latest
+    container_name: my-project-minio
+    command: server /data --console-address ":9001"
+    environment:
+      MINIO_ROOT_USER: ${MINIO_ROOT_USER:-minioadmin}
+      MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD}
     ports:
-      - "3001:3001"
+      - "${MINIO_S3_PORT:-9000}:9000"     # MinIO S3 API
+      - "${MINIO_CONSOLE_PORT:-9001}:9001" # MinIO console
     volumes:
-      - .:/app/project:rw
+      - my-project-minio-data:/data
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+    restart: unless-stopped
+    networks:
+      - my-project-network
+    profiles:
+      - object-storage
+      - full
+
+  minio-init:
+    image: minio/mc:latest
+    container_name: my-project-minio-init
+    depends_on:
+      minio:
+        condition: service_healthy
+    entrypoint: >
+      /bin/sh -c "
+      mc alias set myminio http://minio:9000 ${MINIO_ROOT_USER:-minioadmin} ${MINIO_ROOT_PASSWORD};
+      mc mb --ignore-existing myminio/orchestrator-static;
+      mc mb --ignore-existing myminio/orchestrator-artifacts;
+      mc anonymous set download myminio/orchestrator-static;
+      echo 'MinIO buckets initialized successfully';
+      exit 0;
+      "
+    networks:
+      - my-project-network
+    profiles:
+      - object-storage
+      - full
+    restart: "no"
+
+  db-migrate:
+    image: cmac01/orchestrator-api:latest
+    container_name: my-project-db-migrate
+    depends_on:
+      postgres:
+        condition: service_healthy
+    environment:
+      NODE_ENV: production
+      RUN_MIGRATIONS: "true"
+      PERSISTENCE_MODE: postgres
+      DATABASE_URL: postgresql://${POSTGRES_USER:-orchestrator}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB:-orchestrator}
+      POSTGRES_HOST: postgres
+      POSTGRES_PORT: "5432"
+      POSTGRES_DB: ${POSTGRES_DB:-orchestrator}
+      POSTGRES_USER: ${POSTGRES_USER:-orchestrator}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+    networks:
+      - my-project-network
+    restart: "no"
+
+  orchestrator-api:
+    image: cmac01/orchestrator-api:latest
+    container_name: my-project-orchestrator-api
+    depends_on:
+      postgres:
+        condition: service_healthy
+      db-migrate:
+        condition: service_completed_successfully
+    env_file: .env
     environment:
-      - ORCHESTRATOR_ROOT=/app/project
-      - NODE_ENV=development
+      NODE_ENV: production
+      API_HOST: "0.0.0.0"
+      API_PORT: "3001"
+      PERSISTENCE_MODE: postgres
+      RUN_MIGRATIONS: "false"
+      # PostgreSQL connection (service name resolves within Docker network)
+      POSTGRES_HOST: postgres
+      POSTGRES_PORT: "5432"
+      DATABASE_URL: postgresql://${POSTGRES_USER:-orchestrator}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB:-orchestrator}
+      # MinIO object storage (requires --profile object-storage or --profile full)
+      ENABLE_OBJECT_STORAGE: "${ENABLE_OBJECT_STORAGE:-true}"
+      OBJECT_STORAGE_PROVIDER: minio
+      OBJECT_STORAGE_ENDPOINT: "http://minio:9000"
+      OBJECT_STORAGE_REGION: us-east-1
+      OBJECT_STORAGE_ACCESS_KEY: ${MINIO_ROOT_USER:-minioadmin}
+      OBJECT_STORAGE_SECRET_KEY: ${MINIO_ROOT_PASSWORD}
+      BUCKET_STATIC: orchestrator-static
+      BUCKET_ARTIFACTS: orchestrator-artifacts
+      # Neo4j knowledge graph (requires --profile knowledge-graph or --profile full)
+      NEO4J_URI: "${NEO4J_URI:-bolt://neo4j:7687}"
+      NEO4J_USER: "${NEO4J_USER:-neo4j}"
+      NEO4J_PASSWORD: "${NEO4J_PASSWORD:-orchestrator_neo4j}"
+      ENABLE_KNOWLEDGE_GRAPH: "${ENABLE_KNOWLEDGE_GRAPH:-false}"
+      # JWT Authentication
+      JWT_SECRET: ${JWT_SECRET}
+    ports:
+      - "3001:3001"  # Orchestrator REST API + MCP server
+    volumes:
+      # Staging area for Artifact Relay Pattern (TD-039)
+      # Sub-agents write artifacts here; main agent relays to MinIO via MCP
+      - /tmp/orchestrator:/tmp/orchestrator
     healthcheck:
       test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:3001/api/v1/health"]
       interval: 30s
-      timeout: 3s
-      start_period: 10s
+      timeout: 10s
       retries: 3
+      start_period: 15s
     restart: unless-stopped
+    networks:
+      - my-project-network
+
+volumes:
+  my-project-postgres-data:
+    driver: local
+  my-project-neo4j-data:
+    driver: local
+  my-project-neo4j-logs:
+    driver: local
+  my-project-minio-data:
+    driver: local
+
+networks:
+  my-project-network:
+    driver: bridge

package/dist/templates/base/orchestrator-index.json.hbs

@@ -1,37 +0,0 @@
-{
-  "project": {
-    "name": "{{projectName}}",
-    "version": "1.0.0",
-    "created_at": "{{currentDate}}",
-    "orchestrator_version": "1.4.0"
-  },
-  "activeWorkflow": null,
-  "workflows": [],
-  "artifacts": [],
-  "checkpoints": [],
-  "taskToolInvocations": [],
-  "agentInvocations": [],
-  "gates": {},
-  "statistics": {
-    "totalWorkflows": 0,
-    "completedWorkflows": 0,
-    "failedWorkflows": 0,
-    "totalArtifacts": 0,
-    "totalCheckpoints": 0,
-    "totalInvocations": 0,
-    "lastActivity": "{{currentDate}}"
-  },
-  "metadata": {
-    "initialized_with": "orchestrator-cli",
-    "schema_version": "1.3"
-  },
-  "defaultHooks": {
-    "postImplement": {
-      "agent": "docs-guardian",
-      "mode": "auto",
-      "blocking": false,
-      "enabled": true,
-      "scope": "all"
-    }
-  }
-}

package/dist/templates/projects/api/files/index.ts.hbs

@@ -1,30 +0,0 @@
-/**
- * Application Entry Point
- *
- * Bootstraps the Express server with Clean Architecture principles.
- */
-
-import { config } from 'dotenv';
-import { createServer } from './server.js';
-
-// Load environment variables
-config();
-
-const PORT = process.env.PORT || 3000;
-const HOST = process.env.HOST || '0.0.0.0';
-
-async function main() {
-  try {
-    const app = createServer();
-
-    app.listen(PORT, () => {
-      console.log(`🚀 Server running at http://${HOST}:${PORT}`);
-      console.log(`📝 Environment: ${process.env.NODE_ENV || 'development'}`);
-    });
-  } catch (error) {
-    console.error('❌ Failed to start server:', error);
-    process.exit(1);
-  }
-}
-
-main();

package/dist/templates/projects/api/files/server.ts.hbs

@@ -1,63 +0,0 @@
-/**
- * Server Configuration
- *
- * Creates and configures the Express application.
- */
-
-import express, { type Express, type Request, type Response, type NextFunction } from 'express';
-import cors from 'cors';
-import helmet from 'helmet';
-
-/**
- * Creates the Express server with middleware and routes
- */
-export function createServer(): Express {
-  const app = express();
-
-  // Security middleware
-  app.use(helmet());
-  app.use(cors());
-
-  // Body parsing middleware
-  app.use(express.json());
-  app.use(express.urlencoded({ extended: true }));
-
-  // Health check endpoint
-  app.get('/health', (req: Request, res: Response) => {
-    res.status(200).json({
-      status: 'ok',
-      timestamp: new Date().toISOString(),
-      service: '{{projectName}}',
-    });
-  });
-
-  // API routes
-  app.get('/api/v1', (req: Request, res: Response) => {
-    res.status(200).json({
-      message: 'Welcome to {{projectName}} API',
-      version: '1.0.0',
-    });
-  });
-
-  // 404 handler
-  app.use((req: Request, res: Response) => {
-    res.status(404).json({
-      error: 'Not Found',
-      message: `Route ${req.method} ${req.path} not found`,
-    });
-  });
-
-  // Error handler
-  app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
-    console.error('Error:', err);
-
-    res.status(500).json({
-      error: 'Internal Server Error',
-      message: process.env.NODE_ENV === 'production'
-        ? 'An unexpected error occurred'
-        : err.message,
-    });
-  });
-
-  return app;
-}

package/dist/templates/projects/api/files/tsconfig.json.hbs

@@ -1,27 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "lib": ["ES2022"],
-    "moduleResolution": "node",
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "types": ["node", "vitest/globals"]
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "tests"]
-}

package/dist/templates/projects/api/files/vitest.config.ts.hbs

@@ -1,28 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'json', 'html', 'lcov'],
-      exclude: [
-        'node_modules/',
-        'dist/',
-        'tests/',
-        '**/*.d.ts',
-        '**/*.config.*',
-        '**/index.ts',
-      ],
-      thresholds: {
-        lines: 80,
-        functions: 80,
-        branches: 80,
-        statements: 80,
-      },
-    },
-    include: ['tests/**/*.test.ts'],
-    exclude: ['node_modules', 'dist'],
-  },
-});

package/dist/templates/projects/api/template.config.json

@@ -1,238 +0,0 @@
-{
-  "name": "api",
-  "description": "REST API with Express and Clean Architecture",
-  "version": "1.0.0",
-  "directories": [
-    ".orchestrator",
-    ".orchestrator/artifacts",
-    ".orchestrator/artifacts/research",
-    ".orchestrator/artifacts/specify",
-    ".orchestrator/artifacts/plan",
-    ".orchestrator/artifacts/tasks",
-    ".orchestrator/artifacts/implement",
-    ".orchestrator/workflows",
-    ".orchestrator/memory",
-    ".orchestrator/memory/knowledge-base",
-    ".orchestrator/memory/knowledge-base/core",
-    ".orchestrator/memory/knowledge-base/contextual",
-    ".orchestrator/memory/knowledge-base/research",
-    ".orchestrator/checkpoints",
-    ".orchestrator/.state",
-    ".claude",
-    ".claude/agents",
-    ".claude/skills",
-    ".claude/skills/artifact-validator",
-    ".claude/skills/kb-lookup",
-    ".claude/skills/phase-gate-evaluator",
-    ".claude/skills/workflow-status",
-    ".claude/skills/docs-guardian",
-    ".claude/hooks",
-    "src",
-    "src/domain",
-    "src/domain/entities",
-    "src/domain/value-objects",
-    "src/domain/repositories",
-    "src/application",
-    "src/application/use-cases",
-    "src/application/ports",
-    "src/infrastructure",
-    "src/infrastructure/persistence",
-    "src/infrastructure/adapters",
-    "src/presentation",
-    "src/presentation/routes",
-    "src/presentation/middleware",
-    "tests",
-    "tests/domain",
-    "tests/application",
-    "tests/infrastructure",
-    "tests/presentation"
-  ],
-  "files": [
-    {
-      "source": "projects/api/files/index.ts.hbs",
-      "destination": "src/index.ts",
-      "template": true
-    },
-    {
-      "source": "projects/api/files/tsconfig.json.hbs",
-      "destination": "tsconfig.json",
-      "template": true
-    },
-    {
-      "source": "projects/api/files/vitest.config.ts.hbs",
-      "destination": "vitest.config.ts",
-      "template": true
-    },
-    {
-      "source": "projects/api/files/server.ts.hbs",
-      "destination": "src/server.ts",
-      "template": true
-    },
-    {
-      "source": "projects/minimal/files/gitignore.hbs",
-      "destination": ".gitignore",
-      "template": true
-    },
-    {
-      "source": "projects/minimal/files/env.example.hbs",
-      "destination": ".env.example",
-      "template": true
-    },
-    {
-      "source": "base/CLAUDE.md.hbs",
-      "destination": "CLAUDE.md",
-      "template": true
-    },
-    {
-      "source": "base/mcp.json.hbs",
-      "destination": ".mcp.json",
-      "template": true
-    },
-    {
-      "source": "base/package.json.hbs",
-      "destination": "package.json",
-      "template": true
-    },
-    {
-      "source": "base/orchestrator-index.json.hbs",
-      "destination": ".orchestrator/orchestrator-index.json",
-      "template": true
-    },
-    {
-      "source": "base/claude/settings.json",
-      "destination": ".claude/settings.json",
-      "template": false
-    },
-    {
-      "source": "base/claude/orchestrator-config.json",
-      "destination": ".claude/orchestrator-config.json",
-      "template": false
-    },
-    {
-      "source": "base/claude/agents/orchestrator.md",
-      "destination": ".claude/agents/orchestrator.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/agents/specifier.md",
-      "destination": ".claude/agents/specifier.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/agents/planner.md",
-      "destination": ".claude/agents/planner.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/agents/task-generator.md",
-      "destination": ".claude/agents/task-generator.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/agents/implementer.md",
-      "destination": ".claude/agents/implementer.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/agents/reviewer.md",
-      "destination": ".claude/agents/reviewer.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/agents/researcher.md",
-      "destination": ".claude/agents/researcher.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/skills/artifact-validator/SKILL.md",
-      "destination": ".claude/skills/artifact-validator/SKILL.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/skills/kb-lookup/SKILL.md",
-      "destination": ".claude/skills/kb-lookup/SKILL.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/skills/phase-gate-evaluator/SKILL.md",
-      "destination": ".claude/skills/phase-gate-evaluator/SKILL.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/skills/workflow-status/SKILL.md",
-      "destination": ".claude/skills/workflow-status/SKILL.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/skills/docs-guardian/SKILL.md",
-      "destination": ".claude/skills/docs-guardian/SKILL.md",
-      "template": false
-    },
-    {
-      "source": "base/claude/hooks/pre-agent-invoke.sh",
-      "destination": ".claude/hooks/pre-agent-invoke.sh",
-      "template": false
-    },
-    {
-      "source": "base/claude/hooks/pre-phase-advance.sh",
-      "destination": ".claude/hooks/pre-phase-advance.sh",
-      "template": false
-    },
-    {
-      "source": "base/claude/hooks/post-artifact-generate.sh",
-      "destination": ".claude/hooks/post-artifact-generate.sh",
-      "template": false
-    },
-    {
-      "source": "base/claude/hooks/post-implement-validate.sh",
-      "destination": ".claude/hooks/post-implement-validate.sh",
-      "template": false
-    },
-    {
-      "source": "base/claude/hooks/track-agent-invocation.sh",
-      "destination": ".claude/hooks/track-agent-invocation.sh",
-      "template": false
-    },
-    {
-      "source": "base/claude/hooks/post-phase-checkpoint.sh",
-      "destination": ".claude/hooks/post-phase-checkpoint.sh",
-      "template": false
-    },
-    {
-      "source": "base/orchestrator/.state/.gitkeep",
-      "destination": ".orchestrator/.state/.gitkeep",
-      "template": false
-    }
-  ],
-  "main": "./dist/index.js",
-  "dependencies": {
-    "express": "^4.18.0",
-    "zod": "^3.22.0",
-    "cors": "^2.8.5",
-    "helmet": "^7.1.0",
-    "dotenv": "^16.3.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.0",
-    "@types/cors": "^2.8.17",
-    "@types/supertest": "^6.0.0",
-    "supertest": "^6.3.0"
-  },
-  "scripts": {
-    "start": "node dist/index.js",
-    "dev": "tsx watch src/index.ts",
-    "build": "tsc",
-    "test": "vitest",
-    "test:coverage": "vitest --coverage",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix"
-  },
-  "constitutionExtensions": ["rest-api-conventions"],
-  "knowledgeBaseSeeds": [
-    "docs-constitution",
-    "rest-conventions",
-    "error-handling",
-    "validation-patterns",
-    "auth-strategies"
-  ]
-}