agentic-dev 0.1.0 → 0.2.0

package/infra/terraform/openstack/server/variables.tf

@@ -0,0 +1,233 @@
+variable "auth_url" {
+  type        = string
+  description = "OpenStack Keystone auth URL."
+}
+
+variable "region" {
+  type        = string
+  description = "OpenStack region name."
+  default     = "RegionOne"
+}
+
+variable "interface" {
+  type        = string
+  description = "OpenStack endpoint interface."
+  default     = "public"
+}
+
+variable "auth_type" {
+  type        = string
+  description = "OpenStack auth type."
+  default     = "password"
+}
+
+variable "username" {
+  type        = string
+  description = "OpenStack username."
+  default     = ""
+}
+
+variable "password" {
+  type        = string
+  description = "OpenStack password."
+  default     = ""
+  sensitive   = true
+}
+
+variable "project_name" {
+  type        = string
+  description = "OpenStack project name."
+  default     = ""
+}
+
+variable "user_domain_name" {
+  type        = string
+  description = "OpenStack user domain name."
+  default     = "Default"
+}
+
+variable "project_domain_name" {
+  type        = string
+  description = "OpenStack project domain name."
+  default     = "Default"
+}
+
+variable "application_credential_id" {
+  type        = string
+  description = "OpenStack application credential id."
+  default     = ""
+}
+
+variable "application_credential_secret" {
+  type        = string
+  description = "OpenStack application credential secret."
+  default     = ""
+  sensitive   = true
+}
+
+variable "insecure" {
+  type        = bool
+  description = "Disable TLS validation."
+  default     = false
+}
+
+variable "service_name" {
+  type        = string
+  description = "Service short name."
+  default     = "template-service"
+}
+
+variable "application_name" {
+  type        = string
+  description = "Human-readable application name passed to the backend environment."
+  default     = "Template API"
+}
+
+variable "phase" {
+  type        = string
+  description = "Deployment phase."
+  default     = "dev"
+
+  validation {
+    condition     = contains(["dev", "prod"], lower(var.phase))
+    error_message = "phase must be one of: dev, prod"
+  }
+}
+
+variable "external_network_name" {
+  type        = string
+  description = "External provider network used for router gateway and floating IP."
+  default     = "public"
+}
+
+variable "app_network_name" {
+  type        = string
+  description = "Tenant app network name. Leave empty to derive from service+phase."
+  default     = ""
+}
+
+variable "app_subnet_name" {
+  type        = string
+  description = "Tenant app subnet name. Leave empty to derive from service+phase."
+  default     = ""
+}
+
+variable "app_subnet_cidr" {
+  type        = string
+  description = "App subnet CIDR."
+  default     = "10.42.0.0/24"
+}
+
+variable "dns_nameservers" {
+  type        = list(string)
+  description = "Optional DNS nameservers for the app subnet."
+  default     = ["1.1.1.1", "8.8.8.8"]
+}
+
+variable "backend_image_name" {
+  type        = string
+  description = "Boot image name for the API compute instance."
+  default     = "ubuntu-24.04-noble-amd64"
+}
+
+variable "instance_flavor_name" {
+  type        = string
+  description = "Flavor for the API compute instance."
+  default     = "m1.small"
+}
+
+variable "backend_port" {
+  type        = number
+  description = "API service port."
+  default     = 8080
+}
+
+variable "associate_floating_ip" {
+  type        = bool
+  description = "Whether to attach a floating IP to the API instance."
+  default     = true
+}
+
+variable "backend_ingress_cidrs" {
+  type        = list(string)
+  description = "CIDRs allowed to reach the API service port."
+  default     = ["0.0.0.0/0"]
+}
+
+variable "ssh_ingress_cidrs" {
+  type        = list(string)
+  description = "CIDRs allowed to SSH to the API instance."
+  default     = []
+}
+
+variable "ssh_keypair_name" {
+  type        = string
+  description = "OpenStack keypair name used for browser-terminal SSH access."
+  default     = ""
+}
+
+variable "ssh_public_key" {
+  type        = string
+  description = "Public key material registered in OpenStack for browser-terminal SSH access."
+  default     = ""
+}
+
+variable "desired_state" {
+  type        = string
+  description = "Desired server instance power state."
+  default     = "running"
+
+  validation {
+    condition     = contains(["running", "stopped"], lower(var.desired_state))
+    error_message = "desired_state must be one of: running, stopped"
+  }
+}
+
+variable "backend_container_image" {
+  type        = string
+  description = "Prebuilt backend image. If empty, repo bootstrap build is used."
+  default     = ""
+}
+
+variable "backend_container_name" {
+  type        = string
+  description = "Runtime container name."
+  default     = "template-service-server"
+}
+
+variable "backend_repo_url" {
+  type        = string
+  description = "Repo URL used for bootstrap build."
+  default     = "https://github.com/example-org/example-service.git"
+}
+
+variable "backend_repo_ref" {
+  type        = string
+  description = "Repo ref for bootstrap build."
+  default     = "main"
+}
+
+variable "backend_repo_subdir" {
+  type        = string
+  description = "Repo-relative server directory."
+  default     = "server"
+}
+
+variable "jwt_secret_key" {
+  type        = string
+  description = "JWT secret key. Leave empty to auto-generate."
+  default     = ""
+  sensitive   = true
+}
+
+variable "backend_env" {
+  type        = map(string)
+  description = "Additional backend environment variables."
+  default     = {}
+}
+
+variable "tags" {
+  type        = map(string)
+  description = "Additional metadata tags."
+  default     = {}
+}

package/infra/terraform/openstack/server/zz_aspace.auto.tfvars.example.json

@@ -0,0 +1,29 @@
+{
+  "auth_type": "password",
+  "auth_url": "https://keystone.example.com:5000/v3",
+  "backend_repo_ref": "main",
+  "backend_repo_url": "https://github.com/example-org/example-service.git",
+  "backend_image_name": "ubuntu-24.04-noble-amd64",
+  "backend_port": 8080,
+  "instance_flavor_name": "m1.small",
+  "ssh_ingress_cidrs": ["0.0.0.0/0"],
+  "ssh_keypair_name": "template-dev-terminal",
+  "ssh_public_key": "ssh-ed25519 AAAA... replace-me",
+  "insecure": false,
+  "interface": "public",
+  "phase": "dev",
+  "external_network_name": "public",
+  "app_subnet_cidr": "10.52.0.0/24",
+  "project_domain_name": "Default",
+  "project_name": "template-service",
+  "region": "RegionOne",
+  "service_name": "template-service",
+  "application_name": "Template API",
+  "user_domain_name": "Default",
+  "username": "admin",
+  "backend_env": {
+    "API_PREFIX": "/api/v1",
+    "DATABASE_BACKEND": "postgres",
+    "POSTGRES_URL": "postgresql://template:template@db:5432/template"
+  }
+}

package/lib/scaffold.mjs

@@ -0,0 +1,373 @@
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+
+export const TEMPLATE_CONFIG = {
+  landing: {
+    id: "landing",
+    serviceName: "client-landing",
+    composePortVar: "CLIENT_LANDING_PORT",
+    composeApiVar: "CLIENT_LANDING_VITE_API_BASE_URL",
+    defaultPort: 3000,
+  },
+  platform: {
+    id: "platform",
+    serviceName: "client-platform",
+    composePortVar: "CLIENT_PLATFORM_PORT",
+    composeApiVar: "CLIENT_PLATFORM_VITE_API_BASE_URL",
+    defaultPort: 3001,
+  },
+  mobile: {
+    id: "mobile",
+    serviceName: "client-mobile",
+    composePortVar: "CLIENT_MOBILE_PORT",
+    composeApiVar: "CLIENT_MOBILE_VITE_API_BASE_URL",
+    defaultPort: 3002,
+  },
+  admin: {
+    id: "admin",
+    serviceName: "client-admin",
+    composePortVar: "CLIENT_ADMIN_PORT",
+    composeApiVar: "CLIENT_ADMIN_VITE_API_BASE_URL",
+    defaultPort: 4000,
+  },
+};
+
+const ROOT_FILES = [
+  ".dockerignore",
+  ".env.example",
+  ".gitignore",
+  "AGENTS.md",
+  "README.md",
+  "SDD_SKILL.md",
+];
+
+const ROOT_DIRS = [
+  ".agent",
+  ".claude",
+  ".codex",
+  "infra",
+  "scripts",
+  "sdd",
+  "server",
+];
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PACKAGE_ROOT = path.resolve(__dirname, "..");
+
+export function listTemplates() {
+  return Object.keys(TEMPLATE_CONFIG);
+}
+
+export function resolvePackageRoot() {
+  return PACKAGE_ROOT;
+}
+
+export function parseArgs(argv) {
+  const args = [...argv];
+  const options = {
+    command: "init",
+    targetDir: "",
+    template: "",
+    force: false,
+    yes: false,
+  };
+
+  if (args.length > 0 && !args[0].startsWith("-")) {
+    options.command = args.shift();
+  }
+
+  while (args.length > 0) {
+    const token = args.shift();
+    switch (token) {
+      case "--template":
+      case "-t":
+        options.template = args.shift() ?? "";
+        break;
+      case "--force":
+        options.force = true;
+        break;
+      case "--yes":
+      case "-y":
+        options.yes = true;
+        break;
+      case "--help":
+      case "-h":
+        options.command = "help";
+        break;
+      default:
+        if (!options.targetDir && !token.startsWith("-")) {
+          options.targetDir = token;
+          break;
+        }
+        throw new Error(`Unknown argument: ${token}`);
+    }
+  }
+
+  return options;
+}
+
+export function usage() {
+  return [
+    "Usage:",
+    "  agentic-dev init <target-dir> --template <landing|platform|mobile|admin>",
+    "",
+    "Examples:",
+    "  npx agentic-dev init my-app --template platform",
+    "  npx agentic-dev my-app --template mobile",
+    "",
+    "Options:",
+    "  --template, -t   Frontend template to install",
+    "  --force          Allow scaffolding into a non-empty directory",
+    "  --yes, -y        Skip interactive confirmation",
+    "  --help, -h       Show this help",
+  ].join("\n");
+}
+
+export function validateTemplate(template) {
+  if (!TEMPLATE_CONFIG[template]) {
+    throw new Error(
+      `Unsupported template: ${template}. Expected one of: ${listTemplates().join(", ")}.`,
+    );
+  }
+  return TEMPLATE_CONFIG[template];
+}
+
+export function ensureTargetDir(targetDir, { force = false } = {}) {
+  if (!targetDir) {
+    throw new Error("Missing target directory.");
+  }
+  const resolved = path.resolve(process.cwd(), targetDir);
+  fs.mkdirSync(resolved, { recursive: true });
+  const entries = fs
+    .readdirSync(resolved, { withFileTypes: true })
+    .filter((entry) => entry.name !== ".git");
+  if (entries.length > 0 && !force) {
+    throw new Error(`Target directory is not empty: ${resolved}`);
+  }
+  return resolved;
+}
+
+function copyPath(relativePath, destinationRoot) {
+  const sourcePath = path.join(PACKAGE_ROOT, relativePath);
+  const destinationPath = path.join(destinationRoot, relativePath);
+  fs.mkdirSync(path.dirname(destinationPath), { recursive: true });
+  fs.cpSync(sourcePath, destinationPath, {
+    recursive: true,
+    force: true,
+    filter: (source) => {
+      const baseName = path.basename(source);
+      return baseName !== ".git" && baseName !== "node_modules" && baseName !== "dist";
+    },
+  });
+}
+
+function writeFile(destinationPath, content) {
+  fs.mkdirSync(path.dirname(destinationPath), { recursive: true });
+  fs.writeFileSync(destinationPath, content, "utf8");
+}
+
+function renderWorkspace(template) {
+  return `packages:\n  - client/${template}\n`;
+}
+
+function renderCompose(template) {
+  const config = TEMPLATE_CONFIG[template];
+  return `name: templates
+
+services:
+  postgres:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_DB: \${POSTGRES_DB:-template}
+      POSTGRES_USER: \${POSTGRES_USER:-template}
+      POSTGRES_PASSWORD: \${POSTGRES_PASSWORD:-template}
+    ports:
+      - "\${POSTGRES_PORT:-5432}:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test:
+        [
+          "CMD-SHELL",
+          "pg_isready -U \${POSTGRES_USER:-template} -d \${POSTGRES_DB:-template}",
+        ]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - template-dev
+
+  mysql:
+    image: mysql:8.4
+    profiles: ["mysql"]
+    environment:
+      MYSQL_DATABASE: \${MYSQL_DATABASE:-template}
+      MYSQL_USER: \${MYSQL_USER:-template}
+      MYSQL_PASSWORD: \${MYSQL_PASSWORD:-template}
+      MYSQL_ROOT_PASSWORD: \${MYSQL_ROOT_PASSWORD:-template-root}
+    ports:
+      - "\${MYSQL_PORT:-3306}:3306"
+    volumes:
+      - mysql_data:/var/lib/mysql
+    healthcheck:
+      test:
+        [
+          "CMD-SHELL",
+          "mysqladmin ping -h 127.0.0.1 -u\${MYSQL_USER:-template} -p\${MYSQL_PASSWORD:-template}",
+        ]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+      start_period: 20s
+    networks:
+      - template-dev
+
+  mariadb:
+    image: mariadb:11.7
+    profiles: ["mariadb"]
+    environment:
+      MARIADB_DATABASE: \${MARIADB_DATABASE:-template}
+      MARIADB_USER: \${MARIADB_USER:-template}
+      MARIADB_PASSWORD: \${MARIADB_PASSWORD:-template}
+      MARIADB_ROOT_PASSWORD: \${MARIADB_ROOT_PASSWORD:-template-root}
+    ports:
+      - "\${MARIADB_PORT:-3307}:3306"
+    volumes:
+      - mariadb_data:/var/lib/mysql
+    healthcheck:
+      test:
+        [
+          "CMD-SHELL",
+          "mariadb-admin ping -h 127.0.0.1 -u\${MARIADB_USER:-template} -p\${MARIADB_PASSWORD:-template}",
+        ]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+      start_period: 20s
+    networks:
+      - template-dev
+
+  mongo:
+    image: mongo:8
+    profiles: ["mongo"]
+    ports:
+      - "\${MONGO_PORT:-27017}:27017"
+    volumes:
+      - mongo_data:/data/db
+    networks:
+      - template-dev
+
+  server:
+    build:
+      context: .
+      dockerfile: server/Dockerfile.dev
+      network: host
+    environment:
+      APP_NAME: \${SERVER_APP_NAME:-Template Server}
+      ENVIRONMENT: \${SERVER_ENVIRONMENT:-development}
+      API_PREFIX: \${SERVER_API_PREFIX:-/api/v1}
+      DATABASE_BACKEND: \${SERVER_DATABASE_BACKEND:-postgres}
+      POSTGRES_URL: \${SERVER_POSTGRES_URL:-postgresql+psycopg://template:template@postgres:5432/template}
+      MYSQL_URL: \${SERVER_MYSQL_URL:-mysql+pymysql://template:template@mysql:3306/template}
+      MARIADB_URL: \${SERVER_MARIADB_URL:-mysql+pymysql://template:template@mariadb:3306/template}
+      MONGODB_URL: \${SERVER_MONGODB_URL:-mongodb://mongo:27017}
+      MONGODB_DATABASE: \${SERVER_MONGODB_DATABASE:-template}
+      JWT_SECRET: \${SERVER_JWT_SECRET:-template-local-dev-secret}
+      JWT_ALGORITHM: \${SERVER_JWT_ALGORITHM:-HS256}
+      ACCESS_TOKEN_TTL_MINUTES: \${SERVER_ACCESS_TOKEN_TTL_MINUTES:-120}
+      BOOTSTRAP_ADMIN_EMAIL: \${SERVER_BOOTSTRAP_ADMIN_EMAIL:-admin@example.com}
+      BOOTSTRAP_ADMIN_PASSWORD: \${SERVER_BOOTSTRAP_ADMIN_PASSWORD:-change-me-admin}
+      BOOTSTRAP_ADMIN_NAME: \${SERVER_BOOTSTRAP_ADMIN_NAME:-Template Admin}
+      BOOTSTRAP_OPERATOR_EMAIL: \${SERVER_BOOTSTRAP_OPERATOR_EMAIL:-operator@example.com}
+      BOOTSTRAP_OPERATOR_PASSWORD: \${SERVER_BOOTSTRAP_OPERATOR_PASSWORD:-change-me-operator}
+      BOOTSTRAP_OPERATOR_NAME: \${SERVER_BOOTSTRAP_OPERATOR_NAME:-Template Operator}
+      CORS_ORIGINS: '\${SERVER_CORS_ORIGINS:-["http://localhost:${config.defaultPort}","http://127.0.0.1:${config.defaultPort}"]}'
+      SERVER_HTTP_PORT: \${SERVER_HTTP_PORT:-8000}
+    ports:
+      - "\${SERVER_HTTP_PORT:-8000}:\${SERVER_HTTP_PORT:-8000}"
+    volumes:
+      - ./server:/app/server
+    depends_on:
+      postgres:
+        condition: service_healthy
+    networks:
+      - template-dev
+
+  ${config.serviceName}:
+    build:
+      context: .
+      dockerfile: client/${template}/Dockerfile.dev
+      network: host
+    environment:
+      PORT: \${${config.composePortVar}:-${config.defaultPort}}
+      VITE_API_BASE_URL: \${${config.composeApiVar}:-http://127.0.0.1:8000/api/v1}
+      CHOKIDAR_USEPOLLING: \${CLIENT_WATCH_USE_POLLING:-false}
+    ports:
+      - "\${${config.composePortVar}:-${config.defaultPort}}:\${${config.composePortVar}:-${config.defaultPort}}"
+    volumes:
+      - ./client/${template}:/app/client/${template}
+    depends_on:
+      server:
+        condition: service_started
+    networks:
+      - template-dev
+
+networks:
+  template-dev:
+    driver: bridge
+
+volumes:
+  postgres_data:
+  mysql_data:
+  mariadb_data:
+  mongo_data:
+`;
+}
+
+function updateRepoContract(destinationRoot, template) {
+  const contractPath = path.join(
+    destinationRoot,
+    "sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json",
+  );
+  const contract = JSON.parse(fs.readFileSync(contractPath, "utf8"));
+  const selectedTarget = contract.frontend.targets[template];
+  contract.frontend.default_target = template;
+  contract.frontend.targets = {
+    [template]: selectedTarget,
+  };
+  contract.commands.verify_dev = `test -f "$PWD/${selectedTarget.proof_output}" && echo verify-dev-placeholder-ok`;
+  contract.artifacts.route_gap_output = selectedTarget.route_gap_output;
+  contract.artifacts.proof_output = selectedTarget.proof_output;
+  writeFile(contractPath, `${JSON.stringify(contract, null, 2)}\n`);
+}
+
+export function scaffoldTemplate({ destinationRoot, template }) {
+  validateTemplate(template);
+
+  for (const relativePath of ROOT_FILES) {
+    copyPath(relativePath, destinationRoot);
+  }
+  for (const relativePath of ROOT_DIRS) {
+    copyPath(relativePath, destinationRoot);
+  }
+
+  copyPath(path.join("client", template), destinationRoot);
+
+  writeFile(path.join(destinationRoot, "pnpm-workspace.yaml"), renderWorkspace(template));
+  writeFile(path.join(destinationRoot, "compose.yml"), renderCompose(template));
+  updateRepoContract(destinationRoot, template);
+
+  return {
+    destinationRoot,
+    template,
+    nextSteps: [
+      "cp .env.example .env",
+      "npm install -g pnpm",
+      "pnpm install",
+      `cd client/${template} && npm run ui:parity:bootstrap`,
+    ],
+  };
+}

package/package.json

@@ -1,20 +1,41 @@
 {
   "name": "agentic-dev",
-  "version": "0.1.0",
-  "description": "Installer CLI that composes agentic-core and template-* repositories into a new project repo.",
+  "version": "0.2.0",
+  "description": "Scaffold an agentic template repo with the selected frontend surface and shared toolchain assets.",
   "type": "module",
-  "files": [
-    "bin/",
-    "src/",
-    "README.md"
-  ],
+  "packageManager": "pnpm@10.32.0",
   "bin": {
-    "agentic-dev": "./bin/agentic-dev.js"
+    "agentic-dev": "./bin/agentic-dev.mjs"
   },
+  "files": [
+    ".agent",
+    ".claude",
+    ".codex",
+    "bin",
+    "client",
+    "infra",
+    "lib",
+    "scripts",
+    "sdd",
+    "server",
+    ".dockerignore",
+    ".env.example",
+    ".gitignore",
+    "AGENTS.md",
+    "README.md",
+    "SDD_SKILL.md",
+    "compose.yml",
+    "pnpm-workspace.yaml"
+  ],
   "scripts": {
-    "test": "node --test"
+    "smoke:init": "node ./bin/agentic-dev.mjs init ./.tmp-agentic-smoke --template platform --yes --force"
   },
-  "engines": {
-    "node": ">=18.17"
-  }
+  "keywords": [
+    "agentic",
+    "template",
+    "scaffold",
+    "vite",
+    "react"
+  ],
+  "license": "UNLICENSED"
 }

package/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - client/*