create-sailor 1.5.0 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-sailor",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Governed AI-native SaaS scaffolder for Nebutra Sailor. Bootstrap a production-ready Next.js + Hono + Prisma monorepo with multi-tenant foundations, region-aware defaults, and AI integrations.",
   "type": "module",
   "main": "dist/index.js",

package/templates/backends/gateway/README.md

@@ -0,0 +1,13 @@
+# backends/gateway
+
+TypeScript / Hono BFF. The **default** backend for `{PRODUCT_NAME}`.
+
+Handles auth, tenancy, rate-limiting, and routing in front of all other services.
+
+CRUD, webhooks, billing, third-party API proxies, and any new backend work goes here unless one of the Python exceptions applies (see `backends/python/README.md`).
+
+## Develop
+
+```bash
+pnpm --filter @{PRODUCT_NAME}/gateway dev
+```

package/templates/backends/gateway/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@{PRODUCT_NAME}/gateway",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "src/index.ts",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsup src/index.ts --format esm --target node20",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "hono": "^4.6.0",
+    "@hono/node-server": "^1.13.0"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "tsx": "^4.19.0",
+    "tsup": "catalog:",
+    "typescript": "catalog:"
+  }
+}

package/templates/backends/gateway/src/index.ts

@@ -0,0 +1,16 @@
+import { serve } from "@hono/node-server";
+import { Hono } from "hono";
+
+// import { tenantMiddleware } from "@nebutra/tenant/middleware";
+// import { fromHeader } from "@nebutra/tenant/resolvers";
+
+const app = new Hono();
+
+// app.use("*", tenantMiddleware({ resolvers: [fromHeader("x-tenant-id")] }));
+
+app.get("/health", (c) => c.json({ status: "ok" }));
+
+const port = Number(process.env.PORT ?? 8080);
+serve({ fetch: app.fetch, port });
+
+export default app;

package/templates/backends/gateway/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*.ts"]
+}

package/templates/backends/python/README.md

@@ -0,0 +1,16 @@
+# backends/python
+
+FastAPI-based Python backends. **Use only when justified.**
+
+Per the TS-by-Default ADR (`docs/architecture/2026-05-10-ts-by-default-python-only-when-justified.md`), a new Python service is acceptable only when it cites at least one of:
+
+1. **Batch / queued work** too long for edge runtimes (>5s typical)
+2. **ML / scientific compute** that depends on the Python ecosystem (transformers, vLLM, etc.)
+3. **Specialized libraries** with no comparable TS port
+
+For CRUD, webhooks, billing, content management — use `backends/gateway/` (TS) instead.
+
+## Layout
+
+- `_shared/` — shared primitives (queue client, db, logger) consumed by services
+- `<service>/` — one folder per active service (must have a real caller)

package/templates/backends/python/_shared/__init__.py

@@ -0,0 +1,5 @@
+"""Shared primitives for {PRODUCT_NAME} Python backends.
+
+Active modules go here once they have real callers. Empty stubs should stay
+in `incubator/` (excluded from workspaces / CI) until promoted.
+"""

package/templates/backends/python/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "{PRODUCT_NAME}-python-backends"
+version = "0.1.0"
+description = "Python backends for {PRODUCT_NAME} — batch / ML / specialized only."
+requires-python = ">=3.11"
+dependencies = [
+  "fastapi>=0.115.0",
+  "uvicorn[standard]>=0.32.0",
+  "pydantic>=2.9.0",
+]
+
+[tool.uv.workspace]
+members = ["_shared", "*"]

package/templates/e2e/README.md

@@ -0,0 +1,11 @@
+# e2e
+
+Playwright end-to-end tests for `{PRODUCT_NAME}`.
+
+| Folder | Scope |
+|--------|-------|
+| `smoke/` | Fast smoke tests — must pass on every PR |
+| `golden/` | Critical-path "golden" flows (signup → first action → billing) |
+| `sleptons/` | Sleptons-specific scenarios (skip if Sleptons is disabled) |
+
+Run with `pnpm exec playwright test --config=playwright.config.ts`.

package/templates/e2e/golden/signup.spec.ts

@@ -0,0 +1,6 @@
+import { expect, test } from "@playwright/test";
+
+test.skip("golden: signup → dashboard → first action", async ({ page }) => {
+  await page.goto("/sign-up");
+  await expect(page.getByRole("heading")).toBeVisible();
+});

package/templates/e2e/playwright.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig, devices } from "@playwright/test";
+
+export default defineConfig({
+  testDir: ".",
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  reporter: process.env.CI ? "github" : "list",
+  use: {
+    baseURL: process.env.E2E_BASE_URL ?? "http://localhost:3000",
+    trace: "on-first-retry",
+  },
+  projects: [{ name: "chromium", use: { ...devices["Desktop Chrome"] } }],
+});

package/templates/e2e/sleptons/community.spec.ts

@@ -0,0 +1,6 @@
+import { expect, test } from "@playwright/test";
+
+test.skip("sleptons: community feed renders", async ({ page }) => {
+  await page.goto("/sleptons");
+  await expect(page).toHaveURL(/sleptons/);
+});

package/templates/e2e/smoke/health.spec.ts

@@ -0,0 +1,6 @@
+import { expect, test } from "@playwright/test";
+
+test("homepage renders", async ({ page }) => {
+  await page.goto("/");
+  await expect(page).toHaveTitle(/.+/);
+});

package/templates/infra/README.md

@@ -0,0 +1,10 @@
+# infra
+
+Infrastructure-as-code, runtime configs, data pipelines, and ops scripts for `{PRODUCT_NAME}`.
+
+| Folder | Purpose |
+|--------|---------|
+| `iac/` | Terraform / Pulumi / CDK — provisioning cloud resources |
+| `runtime/` | Container, edge, and serverless runtime configs (Dockerfiles, fly.toml, etc.) |
+| `data/` | DB migrations, ETL definitions, ClickHouse schemas |
+| `ops/` | Operational scripts (backup, restore, on-call runbooks) |

package/templates/infra/data/README.md

@@ -0,0 +1,3 @@
+# infra/data
+
+DB migrations, ETL definitions, ClickHouse schemas, and other persistent-data assets that aren't owned by a single app.

package/templates/infra/iac/README.md

@@ -0,0 +1,3 @@
+# infra/iac
+
+Provisioning: Terraform / Pulumi / CDK. Put one subfolder per stack (e.g. `aws/`, `cloudflare/`).

package/templates/infra/ops/README.md

@@ -0,0 +1,3 @@
+# infra/ops
+
+Operational scripts and runbooks — backup, restore, on-call playbooks, incident response.

package/templates/infra/runtime/README.md

@@ -0,0 +1,3 @@
+# infra/runtime
+
+Container, edge, and serverless runtime configs — Dockerfiles, `fly.toml`, ECS task definitions, etc.

package/templates/tests/README.md

@@ -0,0 +1,8 @@
+# tests
+
+Cross-cutting tests that don't belong to a single package.
+
+| Folder | Tool | Purpose |
+|--------|------|---------|
+| `architecture/` | vitest | Architecture rules — import boundaries, layering, no-cycle |
+| `load/` | k6 | Load + perf tests against deployed environments |

package/templates/tests/architecture/no-cycles.test.ts

@@ -0,0 +1,7 @@
+import { describe, expect, it } from "vitest";
+
+describe("architecture: package boundaries", () => {
+  it("apps do not import from each other", () => {
+    expect(true).toBe(true);
+  });
+});

package/templates/tests/load/smoke.k6.js

@@ -0,0 +1,13 @@
+import { check, sleep } from "k6";
+import http from "k6/http";
+
+export const options = {
+  vus: 5,
+  duration: "30s",
+};
+
+export default function () {
+  const res = http.get(__ENV.BASE_URL ?? "http://localhost:3000");
+  check(res, { "status is 200": (r) => r.status === 200 });
+  sleep(1);
+}

package/templates/workflows/README.md

@@ -0,0 +1,9 @@
+# workflows
+
+Durable workflow & event-orchestration definitions for `{PRODUCT_NAME}`.
+
+| Folder | Purpose |
+|--------|---------|
+| `inngest/` | Inngest functions (durable steps, cron, fan-out) |
+| `n8n/` | n8n flow exports (low-code automations) |
+| `pusher/` | Pusher Channels event maps for real-time fan-out |

package/templates/workflows/inngest/README.md

@@ -0,0 +1,3 @@
+# workflows/inngest
+
+Inngest functions — durable steps, cron, fan-out. Register from `backends/gateway/`.

package/templates/workflows/inngest/welcome-email.ts

@@ -0,0 +1,14 @@
+import { Inngest } from "inngest";
+
+export const inngest = new Inngest({ id: "{PRODUCT_NAME}" });
+
+export const welcomeEmail = inngest.createFunction(
+  { id: "welcome-email" },
+  { event: "user/created" },
+  async ({ event, step }) => {
+    await step.run("send-welcome", async () => {
+      // TODO: dispatch via @nebutra/email
+      return { to: event.data.email };
+    });
+  },
+);

package/templates/workflows/n8n/README.md

@@ -0,0 +1,3 @@
+# workflows/n8n
+
+n8n flow exports. Commit `.json` workflow files here and import them into your n8n instance.

package/templates/workflows/n8n/example-flow.json

@@ -0,0 +1,6 @@
+{
+  "name": "{PRODUCT_NAME} — example flow",
+  "nodes": [],
+  "connections": {},
+  "active": false
+}

package/templates/workflows/pusher/README.md

@@ -0,0 +1,3 @@
+# workflows/pusher
+
+Pusher Channels event maps. Use for real-time fan-out (presence, live updates).

package/templates/workflows/pusher/events.ts

@@ -0,0 +1,6 @@
+export const PUSHER_EVENTS = {
+  NOTIFICATION_CREATED: "notification.created",
+  TENANT_UPDATED: "tenant.updated",
+} as const;
+
+export type PusherEvent = (typeof PUSHER_EVENTS)[keyof typeof PUSHER_EVENTS];