create-sailor 1.10.0 → 2.0.0

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "create-sailor",
-  "version": "1.10.0",
+  "version": "2.0.0",
   "nebutra": {
     "status": "foundation",
     "graph": "core",
     "productionReady": false
   },
-  "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.",
+  "description": "Governed AI-native SaaS scaffolder for Nebutra Sailor. One converged Next.js + Hono + Prisma stack, zero questions — providers go live from env keys.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -19,14 +19,6 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "dev": "tsup --watch",
-    "build": "tsup",
-    "prepublishOnly": "pnpm run build",
-    "start": "node dist/index.js",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "dependencies": {
     "@clack/prompts": "^1.5.0",
     "@mrleebo/prisma-ast": "^0.16.0",
@@ -38,13 +30,13 @@
     "update-notifier": "^7.3.1"
   },
   "devDependencies": {
-    "@nebutra/brand": "workspace:*",
-    "@nebutra/preset": "workspace:*",
-    "@types/node": "catalog:",
+    "@types/node": "^25.9.1",
     "@types/update-notifier": "^6.0.8",
-    "tsup": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.4",
+    "@nebutra/brand": "2.0.0",
+    "@nebutra/preset": "0.1.3"
   },
   "engines": {
     "node": ">=22.0.0"
@@ -88,5 +80,12 @@
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}

package/templates/infra/ops/README.md

@@ -7,7 +7,8 @@ Operational scripts and runbooks — backup, restore, on-call playbooks, inciden
 `platform-expected.example.json` declares the settings that live only in a
 provider dashboard — Vercel build machine and ignore step, Git links, env vars
 that must not be flagged Sensitive, Fly secret names that must exist or must
-not, GitHub repository variables, Cloudflare Worker bindings. Copy it to
+not, GitHub repository variables, the status checks a protected branch requires
+before a merge, Cloudflare Worker bindings. Copy it to
 `platform-expected.json`, replace the names, delete the sections you do not
 use, and run the read-only engine from Nebutra-Sailor against it on a schedule:
 

package/templates/infra/ops/platform-expected.example.json

@@ -32,7 +32,16 @@
     "repo": "your-org/{PRODUCT_NAME}",
     "variables": {
       "DEPLOY_TARGET_GATEWAY": "cloudflare-workers"
-    }
+    },
+    "branchProtection": [
+      {
+        "branch": "main",
+        "requiredStatusChecks": ["Lint & Typecheck", "Test"],
+        "strict": false,
+        "enforceAdmins": false,
+        "requiredApprovingReviewCount": null
+      }
+    ]
   },
   "cloudflare": {
     "workers": [

package/templates/backends/python/README.md

@@ -1,16 +0,0 @@
-# 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

@@ -1,5 +0,0 @@
-"""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

@@ -1,13 +0,0 @@
-[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/deploy/railway.toml

@@ -1,13 +0,0 @@
-[build]
-builder = "NIXPACKS"
-buildCommand = "pnpm build"
-
-[build.nixpacksPlan.phases.setup]
-nixPkgs = ["...", "pnpm-8_x"]
-
-[deploy]
-startCommand = "pnpm start"
-healthcheckPath = "/api/health"
-healthcheckTimeout = 100
-restartPolicyType = "ON_FAILURE"
-restartPolicyMaxRetries = 5

package/templates/deploy/vercel.json

@@ -1,37 +0,0 @@
-{
-  "version": 2,
-  "buildCommand": "pnpm build",
-  "ignoreCommand": "bash ./scripts/ignore-build-step.sh",
-  "framework": "nextjs",
-  "crons": [
-    {
-      "path": "/api/webhooks/cron/daily",
-      "schedule": "0 0 * * *"
-    }
-  ],
-  "headers": [
-    {
-      "source": "/(.*)",
-      "headers": [
-        {
-          "key": "X-Content-Type-Options",
-          "value": "nosniff"
-        },
-        {
-          "key": "X-Frame-Options",
-          "value": "DENY"
-        },
-        {
-          "key": "X-XSS-Protection",
-          "value": "1; mode=block"
-        }
-      ]
-    }
-  ],
-  "rewrites": [
-    {
-      "source": "/api/auth/:path*",
-      "destination": "/api/auth/:path*"
-    }
-  ]
-}

package/templates/deploy/wrangler.gateway.toml

@@ -1,11 +0,0 @@
-name = "nebutra-sailor-gateway"
-main = "src/worker.ts"
-compatibility_date = "2026-06-04"
-compatibility_flags = ["nodejs_compat"]
-
-[observability]
-enabled = true
-head_sampling_rate = 1
-
-[vars]
-DEPLOY_TARGET_GATEWAY = "cloudflare-workers"

package/templates/deploy/wrangler.toml

@@ -1,8 +0,0 @@
-name = "nebutra-sailor"
-compatibility_date = "2024-03-20"
-compatibility_flags = ["nodejs_compat"]
-pages_build_output_dir = ".opennext"
-
-[env.production]
-# Add your production variables here
-# DATABASE_URL = "postgress://..."

package/templates/docs/docusaurus/README.md

@@ -1,24 +0,0 @@
-# {PRODUCT_NAME} Docs
-
-Documentation site for {PRODUCT_NAME}, built with [Docusaurus 3](https://docusaurus.io/).
-
-## Develop
-
-```bash
-pnpm install
-pnpm dev          # http://localhost:3001
-```
-
-## Add a page
-
-1. Drop a `.md` or `.mdx` file under `docs/`
-2. Add the path to `sidebars.ts` (or use auto-generated sidebars)
-
-## Deploy
-
-```bash
-pnpm build        # static output -> build/
-pnpm serve        # preview locally
-```
-
-The `build/` directory can be hosted on any static host (Vercel, Cloudflare Pages, S3, GitHub Pages).

package/templates/docs/docusaurus/docs/getting-started/develop.md

@@ -1,20 +0,0 @@
----
-sidebar_position: 2
----
-
-# Develop
-
-```bash
-pnpm dev          # http://localhost:3001
-```
-
-The site rebuilds on file change. New pages: drop a `.md` or `.mdx` under `docs/` and add it to `sidebars.ts`.
-
-## Build for production
-
-```bash
-pnpm build
-pnpm serve
-```
-
-The static output is written to `build/` — host it on any CDN.

package/templates/docs/docusaurus/docs/getting-started/install.md

@@ -1,11 +0,0 @@
----
-sidebar_position: 1
----
-
-# Install
-
-```bash
-pnpm install
-```
-
-That's it — Docusaurus has no separate setup step.

package/templates/docs/docusaurus/docs/intro.md

@@ -1,15 +0,0 @@
----
-sidebar_position: 1
-slug: /
----
-
-# Welcome to {PRODUCT_NAME}
-
-This is the documentation site for **{PRODUCT_NAME}**, scaffolded by [create-sailor](https://github.com/Nebutra/Nebutra-Sailor) with [Docusaurus 3](https://docusaurus.io/).
-
-## What's next
-
-- [Install dependencies](./getting-started/install.md)
-- [Run the dev server](./getting-started/develop.md)
-
-Edit `docs/intro.md` to change this page.

package/templates/docs/docusaurus/docusaurus.config.ts

@@ -1,66 +0,0 @@
-import type * as Preset from "@docusaurus/preset-classic";
-import type { Config } from "@docusaurus/types";
-import { themes as prismThemes } from "prism-react-renderer";
-
-const config: Config = {
-  title: "{PRODUCT_NAME}",
-  tagline: "Documentation for {PRODUCT_NAME}",
-  favicon: "img/favicon.ico",
-
-  url: "https://docs.example.com",
-  baseUrl: "/",
-
-  organizationName: "your-org",
-  projectName: "your-repo",
-
-  onBrokenLinks: "throw",
-  onBrokenMarkdownLinks: "warn",
-
-  i18n: {
-    defaultLocale: "en",
-    locales: ["en"],
-  },
-
-  presets: [
-    [
-      "classic",
-      {
-        docs: {
-          sidebarPath: "./sidebars.ts",
-          editUrl: "https://github.com/your-org/your-repo/tree/main/docs/",
-          routeBasePath: "/",
-        },
-        blog: false,
-        theme: {
-          customCss: "./src/css/custom.css",
-        },
-      } satisfies Preset.Options,
-    ],
-  ],
-
-  themeConfig: {
-    image: "img/social-card.png",
-    navbar: {
-      title: "{PRODUCT_NAME}",
-      logo: { alt: "{PRODUCT_NAME}", src: "img/logo.svg" },
-      items: [
-        { type: "docSidebar", sidebarId: "tutorialSidebar", position: "left", label: "Docs" },
-        {
-          href: "https://github.com/your-org/your-repo",
-          label: "GitHub",
-          position: "right",
-        },
-      ],
-    },
-    footer: {
-      style: "dark",
-      copyright: "Copyright © " + new Date().getFullYear() + " {PRODUCT_NAME}.",
-    },
-    prism: {
-      theme: prismThemes.github,
-      darkTheme: prismThemes.dracula,
-    },
-  } satisfies Preset.ThemeConfig,
-};
-
-export default config;

package/templates/docs/docusaurus/package.json

@@ -1,44 +0,0 @@
-{
-  "name": "@nebutra/docs",
-  "private": true,
-  "version": "0.0.1",
-  "scripts": {
-    "dev": "docusaurus start --port 3001",
-    "start": "docusaurus start --port 3001",
-    "build": "docusaurus build",
-    "serve": "docusaurus serve --port 3001",
-    "typecheck": "tsc --noEmit",
-    "clear": "docusaurus clear"
-  },
-  "dependencies": {
-    "@docusaurus/core": "^3.7.0",
-    "@docusaurus/preset-classic": "^3.7.0",
-    "@mdx-js/react": "^3.0.1",
-    "clsx": "^2.1.1",
-    "prism-react-renderer": "^2.4.1",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
-  },
-  "devDependencies": {
-    "@docusaurus/module-type-aliases": "^3.7.0",
-    "@docusaurus/tsconfig": "^3.7.0",
-    "@docusaurus/types": "^3.7.0",
-    "typescript": "^5.9.3"
-  },
-  "browserslist": {
-    "production": [
-      ">0.5%",
-      "not dead",
-      "not op_mini all"
-    ],
-    "development": [
-      "last 3 chrome version",
-      "last 3 firefox version",
-      "last 5 safari version"
-    ]
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "license": "MIT"
-}

package/templates/docs/docusaurus/sidebars.ts

@@ -1,14 +0,0 @@
-import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";
-
-const sidebars: SidebarsConfig = {
-  tutorialSidebar: [
-    "intro",
-    {
-      type: "category",
-      label: "Getting started",
-      items: ["getting-started/install", "getting-started/develop"],
-    },
-  ],
-};
-
-export default sidebars;

package/templates/docs/docusaurus/src/css/custom.css

@@ -1,22 +0,0 @@
-:root {
-  --ifm-color-primary: #0033fe;
-  --ifm-color-primary-dark: #002de5;
-  --ifm-color-primary-darker: #002bd9;
-  --ifm-color-primary-darkest: #0023b3;
-  --ifm-color-primary-light: #1f4cff;
-  --ifm-color-primary-lighter: #2d57ff;
-  --ifm-color-primary-lightest: #5a78ff;
-  --ifm-code-font-size: 95%;
-  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
-}
-
-[data-theme="dark"] {
-  --ifm-color-primary: #4d72ff;
-  --ifm-color-primary-dark: #2d57ff;
-  --ifm-color-primary-darker: #1f4cff;
-  --ifm-color-primary-darkest: #0033fe;
-  --ifm-color-primary-light: #6d8aff;
-  --ifm-color-primary-lighter: #7d97ff;
-  --ifm-color-primary-lightest: #adbfff;
-  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
-}

package/templates/docs/docusaurus/tsconfig.json

@@ -1,7 +0,0 @@
-{
-  "extends": "@docusaurus/tsconfig",
-  "compilerOptions": {
-    "baseUrl": "."
-  },
-  "exclude": [".docusaurus", "build"]
-}

package/templates/docs/fumadocs/README.md

@@ -1,46 +0,0 @@
-# {PRODUCT_NAME} Docs
-
-Documentation site for {PRODUCT_NAME}, built with [Fumadocs](https://fumadocs.vercel.app/) + Next.js 16 + Tailwind v4.
-
-## Run locally
-
-```bash
-pnpm --filter @nebutra/docs dev
-```
-
-Opens on http://localhost:3001.
-
-## Edit content
-
-MDX source lives in `content/docs/`. Each file becomes a page under `/docs/<slug>`.
-
-- Add a new page → create `content/docs/my-page.mdx`
-- Control sidebar order → edit `content/docs/meta.json`
-- Use built-in components (`<Cards>`, `<Card>`, `<Tabs>`, `<Tab>`, `<Callout>`, etc.) directly in MDX — they come from `fumadocs-ui/mdx`.
-
-## Customize
-
-- **Branding / colors**: wired to `@nebutra/tokens` via `app/global.css`. Edit tokens centrally, not here.
-- **Sidebar / nav**: `app/docs/layout.tsx` — `DocsLayout` props.
-- **Search**: `app/api/search/route.ts` auto-indexes all MDX via `createFromSource`.
-- **MDX plugins**: `source.config.ts` → `mdxOptions`.
-
-Full Fumadocs reference: https://fumadocs.vercel.app/docs.
-
-## 2026 docs best practices
-
-This template follows Nebutra docs best-practices, encoded as MDX comments inline in each starter page:
-
-- **Home** — hero + 3-6 cards, no marketing fluff
-- **Getting Started** — single goal: 5-minute first example (Install → Initialize → Hello World → Next steps)
-- **Concepts** — explains the "why" / mental model, not steps, not APIs
-- **API Reference** — auto-generated from OpenAPI; every endpoint has method badge + params + schema + multi-language examples
-
-When refreshing the API reference inputs:
-
-```bash
-pnpm --filter @nebutra/gateway generate:spec
-pnpm generate:api-types
-```
-
-Then replace `content/docs/api.mdx` with generated reference content sourced from `backends/gateway/openapi.json`.

package/templates/docs/fumadocs/app/(home)/page.tsx

@@ -1,22 +0,0 @@
-import Link from "next/link";
-
-export const dynamic = "force-static";
-
-export default function HomePage() {
-  return (
-    <main className="flex flex-1 flex-col items-center justify-center gap-6 px-4 py-24 text-center">
-      <h1 className="text-4xl font-bold tracking-tight sm:text-5xl">
-        {"{PRODUCT_NAME}"} Documentation
-      </h1>
-      <p className="max-w-xl text-lg text-fd-muted-foreground">
-        Build AI-native SaaS products faster. Everything you need to ship is documented here.
-      </p>
-      <Link
-        href="/docs"
-        className="rounded-md bg-fd-primary px-6 py-3 font-semibold text-fd-primary-foreground transition-opacity hover:opacity-90"
-      >
-        Read the docs
-      </Link>
-    </main>
-  );
-}

package/templates/docs/fumadocs/app/api/search/route.ts

@@ -1,4 +0,0 @@
-import { createFromSource } from "fumadocs-core/search/server";
-import { source } from "@/lib/source";
-
-export const { GET } = createFromSource(source);

package/templates/docs/fumadocs/app/docs/[[...slug]]/page.tsx

@@ -1,39 +0,0 @@
-import defaultMdxComponents from "fumadocs-ui/mdx";
-import { DocsBody, DocsDescription, DocsPage, DocsTitle } from "fumadocs-ui/page";
-import { notFound } from "next/navigation";
-import { source } from "@/lib/source";
-
-export const dynamic = "force-static";
-
-export default async function Page(props: { params: Promise<{ slug?: string[] }> }) {
-  const params = await props.params;
-  const page = source.getPage(params.slug);
-  if (!page) notFound();
-
-  const MDX = page.data.body;
-
-  return (
-    <DocsPage toc={page.data.toc} full={page.data.full}>
-      <DocsTitle>{page.data.title}</DocsTitle>
-      <DocsDescription>{page.data.description}</DocsDescription>
-      <DocsBody>
-        <MDX components={{ ...defaultMdxComponents }} />
-      </DocsBody>
-    </DocsPage>
-  );
-}
-
-export function generateStaticParams() {
-  return source.generateParams();
-}
-
-export async function generateMetadata(props: { params: Promise<{ slug?: string[] }> }) {
-  const params = await props.params;
-  const page = source.getPage(params.slug);
-  if (!page) notFound();
-
-  return {
-    title: page.data.title,
-    description: page.data.description,
-  };
-}

package/templates/docs/fumadocs/app/docs/layout.tsx

@@ -1,11 +0,0 @@
-import { DocsLayout } from "fumadocs-ui/layouts/docs";
-import type { ReactNode } from "react";
-import { source } from "@/lib/source";
-
-export default function Layout({ children }: { children: ReactNode }) {
-  return (
-    <DocsLayout tree={source.pageTree} nav={{ title: "{PRODUCT_NAME}" }}>
-      {children}
-    </DocsLayout>
-  );
-}

package/templates/docs/fumadocs/app/global.css

@@ -1,10 +0,0 @@
-@import "tailwindcss";
-@import "fumadocs-ui/css/neutral.css";
-@import "fumadocs-ui/css/preset.css";
-
-/* Pull in Nebutra design tokens (brand colors, semantic scales, gradients). */
-@import "@nebutra/tokens/styles.css";
-
-/* Package-owned Tailwind source scan for @nebutra/ui CVA classes. */
-@import "@nebutra/ui/styles/sources.css";
-@source "../node_modules/fumadocs-ui/dist/**/*.js";

package/templates/docs/fumadocs/app/layout.tsx

@@ -1,18 +0,0 @@
-import { RootProvider } from "fumadocs-ui/provider";
-import type { ReactNode } from "react";
-import "./global.css";
-
-export const metadata = {
-  title: "{PRODUCT_NAME} Docs",
-  description: "Documentation for {PRODUCT_NAME}",
-};
-
-export default function RootLayout({ children }: { children: ReactNode }) {
-  return (
-    <html lang="en" suppressHydrationWarning>
-      <body className="flex min-h-screen flex-col">
-        <RootProvider>{children}</RootProvider>
-      </body>
-    </html>
-  );
-}

package/templates/docs/fumadocs/content/docs/api.mdx

@@ -1,31 +0,0 @@
----
-title: API Reference
-description: Complete API documentation
----
-
-{/* 2026 BEST PRACTICE: API Reference should be auto-generated from OpenAPI spec */}
-{/* 2026 BEST PRACTICE: Every endpoint needs: Method badge, params table, response schema, multi-language examples */}
-{/* TODO: Export backends/gateway/openapi.json and replace this starter page with generated reference content. */}
-
-# API Reference
-
-API documentation is easiest to maintain when it is generated from your OpenAPI spec.
-
-To refresh the source spec and the shared TypeScript types in `apps/web`:
-
-```bash
-pnpm --filter @nebutra/gateway generate:spec
-pnpm generate:api-types
-```
-
-## Endpoints
-
-### GET /hello
-
-Returns a hello message.
-
-**Response**:
-
-```json
-{ "message": "Hello, world!" }
-```

package/templates/docs/fumadocs/content/docs/concepts.mdx

@@ -1,19 +0,0 @@
----
-title: Concepts
-description: Core mental models and design decisions
----
-
-{/* 2026 BEST PRACTICE: Concepts explains the "why" and mental model */}
-{/* 2026 BEST PRACTICE: Don't explain steps — that's Guides. Don't list APIs — that's API Reference */}
-
-# Concepts
-
-Understand the core models and design decisions.
-
-## Workspaces
-
-A workspace is...
-
-## Authentication
-
-...