@harness-engineering/cli 1.13.1 → 1.14.0

package/dist/templates/axum/src/main.rs

@@ -0,0 +1,12 @@
+use axum::{routing::get, Router};
+
+async fn root() -> &'static str {
+    "Hello, world!"
+}
+
+#[tokio::main]
+async fn main() {
+    let app = Router::new().route("/", get(root));
+    let listener = tokio::net::TcpListener::bind("127.0.0.1:3000").await.unwrap();
+    axum::serve(listener, app).await.unwrap();
+}

package/dist/templates/axum/template.json

@@ -0,0 +1,16 @@
+{
+  "name": "axum",
+  "description": "Axum web framework scaffold",
+  "version": 1,
+  "language": "rust",
+  "framework": "axum",
+  "extends": "rust-base",
+  "tooling": {
+    "packageManager": "cargo",
+    "linter": "clippy",
+    "formatter": "rustfmt",
+    "buildTool": "cargo",
+    "testRunner": "cargo test"
+  },
+  "detect": [{ "file": "Cargo.toml", "contains": "axum" }]
+}

package/dist/templates/django/manage.py.hbs

@@ -0,0 +1,19 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+
+
+def main():
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "{{projectName}}.settings")
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()

package/dist/templates/django/requirements.txt.hbs

@@ -0,0 +1 @@
+django>=4.2

package/dist/templates/django/src/settings.py.hbs

@@ -0,0 +1,44 @@
+"""Django settings for {{projectName}} project."""
+
+import os
+from pathlib import Path
+
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+SECRET_KEY = os.environ.get("DJANGO_SECRET_KEY", "dev-only-insecure-key-change-in-production")
+
+DEBUG = True
+
+ALLOWED_HOSTS = []
+
+INSTALLED_APPS = [
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+]
+
+MIDDLEWARE = [
+    "django.middleware.security.SecurityMiddleware",
+    "django.contrib.sessions.middleware.SessionMiddleware",
+    "django.middleware.common.CommonMiddleware",
+    "django.middleware.csrf.CsrfViewMiddleware",
+    "django.contrib.auth.middleware.AuthenticationMiddleware",
+    "django.contrib.messages.middleware.MessageMiddleware",
+    "django.middleware.clickjacking.XFrameOptionsMiddleware",
+]
+
+ROOT_URLCONF = "{{projectName}}.urls"
+
+WSGI_APPLICATION = "{{projectName}}.wsgi.application"
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": BASE_DIR / "db.sqlite3",
+    }
+}
+
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"

package/dist/templates/django/src/urls.py

@@ -0,0 +1,6 @@
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path("admin/", admin.site.urls),
+]

package/dist/templates/django/src/wsgi.py.hbs

@@ -0,0 +1,9 @@
+"""WSGI config for {{projectName}} project."""
+
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "{{projectName}}.settings")
+
+application = get_wsgi_application()

package/dist/templates/django/template.json

@@ -0,0 +1,21 @@
+{
+  "name": "django",
+  "description": "Django web framework scaffold",
+  "version": 1,
+  "language": "python",
+  "framework": "django",
+  "extends": "python-base",
+  "tooling": {
+    "packageManager": "pip",
+    "linter": "ruff",
+    "formatter": "ruff",
+    "buildTool": "setuptools",
+    "testRunner": "pytest",
+    "lockFile": "requirements.txt"
+  },
+  "detect": [
+    { "file": "requirements.txt", "contains": "django" },
+    { "file": "pyproject.toml", "contains": "django" },
+    { "file": "manage.py", "contains": "django" }
+  ]
+}

package/dist/templates/express/package.json.hbs

@@ -0,0 +1,15 @@
+{
+  "name": "{{projectName}}",
+  "scripts": {
+    "dev": "tsx watch src/app.ts",
+    "build": "tsc",
+    "start": "node dist/app.js"
+  },
+  "dependencies": {
+    "express": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.0.0",
+    "tsx": "^4.0.0"
+  }
+}

package/dist/templates/express/src/app.ts

@@ -0,0 +1,12 @@
+import express from 'express';
+
+const app = express();
+const port = process.env.PORT || 3000;
+
+app.get('/', (_req, res) => {
+  res.json({ message: 'Welcome to your Harness Engineering project' });
+});
+
+app.listen(port, () => {
+  console.log(`Server running on port ${port}`);
+});

package/dist/templates/express/template.json

@@ -0,0 +1,16 @@
+{
+  "name": "express",
+  "description": "Express.js framework overlay",
+  "framework": "express",
+  "version": 1,
+  "language": "typescript",
+  "tooling": {
+    "packageManager": "npm",
+    "linter": "eslint",
+    "formatter": "prettier",
+    "buildTool": "tsc",
+    "testRunner": "vitest",
+    "lockFile": "package-lock.json"
+  },
+  "detect": [{ "file": "package.json", "contains": "express" }]
+}

package/dist/templates/fastapi/requirements.txt.hbs

@@ -0,0 +1,2 @@
+fastapi>=0.100.0
+uvicorn[standard]>=0.23.0

package/dist/templates/fastapi/src/main.py

@@ -0,0 +1,8 @@
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def root():
+    return {"message": "Hello, world!"}

package/dist/templates/fastapi/template.json

@@ -0,0 +1,20 @@
+{
+  "name": "fastapi",
+  "description": "FastAPI web framework scaffold",
+  "version": 1,
+  "language": "python",
+  "framework": "fastapi",
+  "extends": "python-base",
+  "tooling": {
+    "packageManager": "pip",
+    "linter": "ruff",
+    "formatter": "ruff",
+    "buildTool": "setuptools",
+    "testRunner": "pytest",
+    "lockFile": "requirements.txt"
+  },
+  "detect": [
+    { "file": "requirements.txt", "contains": "fastapi" },
+    { "file": "pyproject.toml", "contains": "fastapi" }
+  ]
+}

package/dist/templates/gin/go.mod.hbs

@@ -0,0 +1,5 @@
+module {{goModulePath}}
+
+go 1.21
+
+require github.com/gin-gonic/gin v1.9.1

package/dist/templates/gin/main.go

@@ -0,0 +1,15 @@
+package main
+
+import (
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+)
+
+func main() {
+	r := gin.Default()
+	r.GET("/", func(c *gin.Context) {
+		c.JSON(http.StatusOK, gin.H{"message": "Hello, world!"})
+	})
+	r.Run(":8080")
+}

package/dist/templates/gin/template.json

@@ -0,0 +1,19 @@
+{
+  "name": "gin",
+  "description": "Gin web framework scaffold",
+  "version": 1,
+  "language": "go",
+  "framework": "gin",
+  "extends": "go-base",
+  "tooling": {
+    "packageManager": "go",
+    "linter": "golangci-lint",
+    "formatter": "gofmt",
+    "buildTool": "go",
+    "testRunner": "go test"
+  },
+  "detect": [
+    { "file": "go.mod", "contains": "gin-gonic" },
+    { "file": "go.sum", "contains": "gin-gonic" }
+  ]
+}

package/dist/templates/go-base/.golangci.yml

@@ -0,0 +1,16 @@
+linters:
+  enable:
+    - errcheck
+    - govet
+    - staticcheck
+    - unused
+    - gosimple
+    - ineffassign
+  disable:
+    - depguard
+
+run:
+  timeout: 5m
+
+issues:
+  max-issues-per-linter: 50

package/dist/templates/go-base/AGENTS.md.hbs

@@ -0,0 +1,35 @@
+# {{projectName}} Knowledge Map
+
+## About This Project
+
+{{projectName}} -- A Go project managed with Harness Engineering practices.
+
+## Language & Tooling
+
+- **Language:** Go
+- **Module:** {{goModulePath}}
+- **Linter:** golangci-lint
+- **Formatter:** gofmt
+- **Test runner:** go test
+
+## Directory Structure
+
+- `main.go` -- Application entry point
+- `go.mod` -- Module definition and dependencies
+- `internal/` -- Private application packages (by convention)
+- `pkg/` -- Public library packages (by convention)
+
+## Conventions
+
+- Follow Effective Go guidelines
+- Use `gofmt` for formatting (enforced by golangci-lint)
+- Tests live alongside source files as `_test.go` suffix
+- Error handling: always check returned errors, never discard
+- Package names are lowercase, single-word, no underscores
+
+## Harness Skills
+
+- Use `harness-brainstorming` for design exploration
+- Use `harness-planning` to break features into atomic tasks
+- Use `harness-execution` to implement tasks with TDD
+- Refer to `harness.config.json` for project tooling configuration

package/dist/templates/go-base/go.mod.hbs

@@ -0,0 +1,3 @@
+module {{goModulePath}}
+
+go 1.21

package/dist/templates/go-base/harness.config.json.hbs

@@ -0,0 +1,17 @@
+{
+  "version": 1,
+  "name": "{{projectName}}",
+  "agentsMapPath": "./AGENTS.md",
+  "docsDir": "./docs",
+  "template": {
+    "language": "go",
+    "version": 1
+  },
+  "tooling": {
+    "packageManager": "go",
+    "linter": "golangci-lint",
+    "formatter": "gofmt",
+    "buildTool": "go",
+    "testRunner": "go test"
+  }
+}

package/dist/templates/go-base/main.go

@@ -0,0 +1,7 @@
+package main
+
+import "fmt"
+
+func main() {
+	fmt.Println("Hello, world!")
+}

package/dist/templates/go-base/template.json

@@ -0,0 +1,14 @@
+{
+  "name": "go-base",
+  "description": "Go language base scaffold with golangci-lint",
+  "version": 1,
+  "language": "go",
+  "tooling": {
+    "packageManager": "go",
+    "linter": "golangci-lint",
+    "formatter": "gofmt",
+    "buildTool": "go",
+    "testRunner": "go test"
+  },
+  "mergeStrategy": { "json": "deep-merge", "files": "overlay-wins" }
+}

package/dist/templates/java-base/AGENTS.md.hbs

@@ -0,0 +1,35 @@
+# {{projectName}} Knowledge Map
+
+## About This Project
+
+{{projectName}} -- A Java project managed with Harness Engineering practices.
+
+## Language & Tooling
+
+- **Language:** Java 17
+- **Build tool:** Maven
+- **Linter:** Checkstyle
+- **Test runner:** JUnit 5
+- **Group ID:** {{javaGroupId}}
+
+## Directory Structure
+
+- `src/main/java/` -- Application source code
+- `src/test/java/` -- Test files (JUnit 5)
+- `pom.xml` -- Maven project configuration
+- `checkstyle.xml` -- Code style rules
+
+## Conventions
+
+- Follow Google Java Style Guide (Checkstyle enforced)
+- Use Java 17 language features
+- Tests live in `src/test/java/` mirroring `src/main/java/` structure
+- Use JUnit 5 assertions and lifecycle annotations
+- Prefer dependency injection over static methods
+
+## Harness Skills
+
+- Use `harness-brainstorming` for design exploration
+- Use `harness-planning` to break features into atomic tasks
+- Use `harness-execution` to implement tasks with TDD
+- Refer to `harness.config.json` for project tooling configuration

package/dist/templates/java-base/checkstyle.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+  "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+  "https://checkstyle.org/dtds/configuration_1_3.dtd">
+<module name="Checker">
+  <property name="charset" value="UTF-8"/>
+  <module name="TreeWalker">
+    <module name="WhitespaceAround"/>
+    <module name="NeedBraces"/>
+    <module name="LeftCurly"/>
+    <module name="RightCurly"/>
+    <module name="EmptyBlock"/>
+    <module name="AvoidStarImport"/>
+    <module name="UnusedImports"/>
+  </module>
+  <module name="FileLength">
+    <property name="max" value="500"/>
+  </module>
+  <module name="NewlineAtEndOfFile"/>
+</module>

package/dist/templates/java-base/harness.config.json.hbs

@@ -0,0 +1,16 @@
+{
+  "version": 1,
+  "name": "{{projectName}}",
+  "agentsMapPath": "./AGENTS.md",
+  "docsDir": "./docs",
+  "template": {
+    "language": "java",
+    "version": 1
+  },
+  "tooling": {
+    "packageManager": "maven",
+    "linter": "checkstyle",
+    "buildTool": "maven",
+    "testRunner": "junit"
+  }
+}

package/dist/templates/java-base/pom.xml.hbs

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+
+  <groupId>{{javaGroupId}}</groupId>
+  <artifactId>{{projectName}}</artifactId>
+  <version>0.1.0</version>
+  <packaging>jar</packaging>
+
+  <properties>
+    <maven.compiler.source>17</maven.compiler.source>
+    <maven.compiler.target>17</maven.compiler.target>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+
+  <dependencies>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter</artifactId>
+      <version>5.10.0</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-checkstyle-plugin</artifactId>
+        <version>3.3.0</version>
+        <configuration>
+          <configLocation>checkstyle.xml</configLocation>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+</project>

package/dist/templates/java-base/src/main/java/App.java.hbs

@@ -0,0 +1,5 @@
+public class App {
+    public static void main(String[] args) {
+        System.out.println("Hello, world!");
+    }
+}

package/dist/templates/java-base/template.json

@@ -0,0 +1,13 @@
+{
+  "name": "java-base",
+  "description": "Java language base scaffold with Checkstyle and Maven",
+  "version": 1,
+  "language": "java",
+  "tooling": {
+    "packageManager": "maven",
+    "linter": "checkstyle",
+    "buildTool": "maven",
+    "testRunner": "junit"
+  },
+  "mergeStrategy": { "json": "deep-merge", "files": "overlay-wins" }
+}

package/dist/templates/nestjs/nest-cli.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src"
+}

package/dist/templates/nestjs/package.json.hbs

@@ -0,0 +1,18 @@
+{
+  "name": "{{projectName}}",
+  "scripts": {
+    "dev": "nest start --watch",
+    "build": "nest build",
+    "start": "node dist/main.js"
+  },
+  "dependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "@nestjs/platform-express": "^10.0.0",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^10.0.0"
+  }
+}

package/dist/templates/nestjs/src/app.module.ts

@@ -0,0 +1,8 @@
+import { Module } from '@nestjs/common';
+
+@Module({
+  imports: [],
+  controllers: [],
+  providers: [],
+})
+export class AppModule {}

package/dist/templates/nestjs/src/main.ts

@@ -0,0 +1,11 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  const port = process.env.PORT || 3000;
+  await app.listen(port);
+  console.log(`Application running on port ${port}`);
+}
+
+bootstrap();

package/dist/templates/nestjs/template.json

@@ -0,0 +1,16 @@
+{
+  "name": "nestjs",
+  "description": "NestJS framework overlay",
+  "framework": "nestjs",
+  "version": 1,
+  "language": "typescript",
+  "tooling": {
+    "packageManager": "npm",
+    "linter": "eslint",
+    "formatter": "prettier",
+    "buildTool": "nest",
+    "testRunner": "jest",
+    "lockFile": "package-lock.json"
+  },
+  "detect": [{ "file": "package.json", "contains": "@nestjs/core" }, { "file": "nest-cli.json" }]
+}

package/dist/templates/nextjs/template.json

@@ -2,5 +2,19 @@
   "name": "nextjs",
   "description": "Next.js framework overlay",
   "framework": "nextjs",
-  "version": 1
+  "language": "typescript",
+  "version": 1,
+  "mergeStrategy": { "json": "deep-merge", "files": "overlay-wins" },
+  "tooling": {
+    "packageManager": "npm",
+    "linter": "eslint",
+    "formatter": "prettier",
+    "buildTool": "next",
+    "testRunner": "vitest"
+  },
+  "detect": [
+    { "file": "next.config.mjs", "contains": "" },
+    { "file": "next.config.js", "contains": "" },
+    { "file": "package.json", "contains": "next" }
+  ]
 }

package/dist/templates/python-base/.python-version

@@ -0,0 +1 @@
+3.10

package/dist/templates/python-base/AGENTS.md.hbs

@@ -0,0 +1,32 @@
+# {{projectName}} Knowledge Map
+
+## About This Project
+
+{{projectName}} -- A Python project managed with Harness Engineering practices.
+
+## Language & Tooling
+
+- **Language:** Python (>={{pythonMinVersion}})
+- **Linter/Formatter:** Ruff
+- **Test runner:** pytest
+- **Package manager:** pip
+
+## Directory Structure
+
+- `src/` -- Application source code
+- `tests/` -- Test files (pytest)
+- `pyproject.toml` -- Project metadata and dependencies
+
+## Conventions
+
+- Follow PEP 8 style (enforced by Ruff)
+- Use type hints for function signatures
+- Tests live in `tests/` and mirror `src/` structure
+- Import sorting managed by Ruff (isort rules)
+
+## Harness Skills
+
+- Use `harness-brainstorming` for design exploration
+- Use `harness-planning` to break features into atomic tasks
+- Use `harness-execution` to implement tasks with TDD
+- Refer to `harness.config.json` for project tooling configuration

package/dist/templates/python-base/harness.config.json.hbs

@@ -0,0 +1,16 @@
+{
+  "version": 1,
+  "name": "{{projectName}}",
+  "agentsMapPath": "./AGENTS.md",
+  "docsDir": "./docs",
+  "template": {
+    "language": "python",
+    "version": 1
+  },
+  "tooling": {
+    "packageManager": "pip",
+    "linter": "ruff",
+    "formatter": "ruff",
+    "testRunner": "pytest"
+  }
+}