@cogito.ai/cli 0.2.0

package/dist/registry.json

@@ -0,0 +1,26 @@
+{
+  "version": "1",
+  "templates": [
+    {
+      "id": "web-nextjs",
+      "name": "@cogito.ai/template-web-nextjs",
+      "description": "Full-stack Next.js 16 starter with Supabase, next-intl, Tailwind CSS and Vitest",
+      "minCliVersion": "0.1.0",
+      "source": "templates/web-nextjs",
+      "resolvedDependencies": {
+        "@supabase/ssr": "^0.10.3",
+        "next": "16",
+        "next-intl": "^4.13.0",
+        "react": "19",
+        "react-dom": "19",
+        "@vitejs/plugin-react": "^6.0.2",
+        "tailwindcss": "^4.3.0",
+        "typescript": "^6.0.3",
+        "vitest": "^4.1.8",
+        "@cogito.ai/eslint-config": "^0.2.0",
+        "@cogito.ai/tsconfig": "^0.2.0",
+        "@fission-ai/openspec": "^1.3.1"
+      }
+    }
+  ]
+}

package/dist/templates/web-nextjs/.env.example

@@ -0,0 +1,22 @@
+# ──────────────────────────────────────────────────────────────────────────────
+# Supabase
+# Get these from: Supabase Dashboard → Project Settings → API
+# ──────────────────────────────────────────────────────────────────────────────
+
+# Project URL — safe to expose in browser
+NEXT_PUBLIC_SUPABASE_URL=https://<project-ref>.supabase.co
+
+# Anon key — safe to expose in browser (Row Level Security enforces access)
+NEXT_PUBLIC_SUPABASE_ANON_KEY=<your-anon-key>
+
+# Service role key — SERVER ONLY, never expose to browser
+# Used for admin operations that bypass RLS (e.g., seed scripts, cron jobs)
+# Leave empty if not needed
+SUPABASE_SERVICE_ROLE_KEY=<your-service-role-key>
+
+# ──────────────────────────────────────────────────────────────────────────────
+# App
+# ──────────────────────────────────────────────────────────────────────────────
+
+# Public URL of this app (used for OG image URLs, absolute redirects, etc.)
+NEXT_PUBLIC_APP_URL=http://localhost:3000

package/dist/templates/web-nextjs/.github/copilot-instructions.md

@@ -0,0 +1,43 @@
+# AgentDock Web-Next.js Template — Copilot Instructions
+
+> Applies to: GitHub Copilot (chat + completions) in any project generated from this template.
+
+## Directory Contract
+
+This project enforces a four-layer directory contract. **Before placing any code**, confirm which layer it belongs to:
+
+| Layer           | Path                         | Purpose                                                        | Rules                                                                      |
+| --------------- | ---------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| **core**        | `src/core/`                  | Stable domain layer — types, repository interfaces, pure logic | No framework imports, no DB clients, read-only                             |
+| **features**    | `src/features/`              | AI coding zone — business features                             | Must have `__contract__.ts`; no direct DB access; no cross-feature imports |
+| **infra**       | `src/infra/`                 | Infrastructure — Supabase clients, third-party SDKs            | Requires approval; only `core/repositories` implementations live here      |
+| **experiments** | `src/features/_experiments/` | Sandbox                                                        | Never imported by non-experimental features                                |
+
+## Layer 2 Architecture Rules (error-level, enforced by ESLint)
+
+Four rules are enforced at `error` severity in `src/features/**`. Violations fail `pnpm lint`.
+
+1. **`no-direct-db-in-features`** — Features must not import from `infra/db`. Use repository interfaces from `src/core/repositories/` instead.
+2. **`require-feature-contract`** — Every feature subdirectory must contain `__contract__.ts` declaring its public API boundary.
+3. **`no-cross-feature`** — Features must not directly import from sibling feature internals. Import through the feature's `index.ts` only.
+4. **`no-core-mutation`** — `src/core/` is read-only. Features and infra must not modify core types or interfaces in-place.
+
+## Hard Rules
+
+1. **No secrets** — Never write real API keys, tokens, or passwords. Use placeholders: `YOUR_KEY_HERE`, `process.env.YOUR_VAR`.
+2. **TypeScript strict** — `strict: true` enforced. No `any`, no `// @ts-ignore` without explanation.
+3. **Conventional commits** — `type(scope): summary` format required.
+4. **pnpm only** — Do not use `npm install` or `yarn`. Always `pnpm add`.
+5. **ESLint config** — Architecture rules come from `packages/eslint-config/features.js` in the AgentDock platform.
+
+## Feature Development Pattern
+
+When adding a new feature `src/features/<name>/`:
+
+1. Create `__contract__.ts` first — declare input/output types and public API.
+2. Create `service.ts` — pure business logic, no side effects.
+3. Create `index.ts` — only export what `__contract__.ts` declares.
+4. Create `<name>.test.ts` — Vitest unit tests.
+5. Create page/component in `src/app/[locale]/` to consume the feature.
+
+Reference implementation: `src/features/hello/`.

package/dist/templates/web-nextjs/AGENTS.md

@@ -0,0 +1,46 @@
+# AgentDock Web-Next.js Template — Agent Execution Boundaries
+
+> For AI coding agents (GitHub Copilot CLI, etc.) running in projects generated from this template.
+
+## Generation Assumption
+
+- Template source may contain monorepo-only dependency specifiers (for example, workspace links).
+- Scaffold generation MUST rewrite these dependencies to installable versions for the generated standalone project.
+
+## Autonomy Boundaries
+
+### May execute autonomously
+
+- `pnpm install`, `pnpm build`, `pnpm check-types`, `pnpm lint`, `pnpm test`
+- Creating / editing files within the current task scope
+- Adding new features inside `src/features/` (following the contract pattern)
+- Adding repository interfaces to `src/core/repositories/`
+- Updating translations in `messages/`
+- Writing or updating tests in `src/**/*.test.ts`
+- Running `openspec` CLI commands (read-only: `list`, `status`, `instructions`, `validate`)
+
+### Must pause and confirm
+
+- Any `git push`, `git push --force`, or publishing to a registry
+- Deleting files (including tracked files)
+- Adding new **top-level** directories outside the four-layer contract (`core/`, `features/`, `infra/`, `app/`)
+- Adding new `dependencies` or `devDependencies` to `package.json`
+- Any change to `openspec/config.yaml`
+- Modifying `middleware.ts` (affects routing for all locales)
+
+### Prohibited
+
+- Writing real secrets, API keys, or credentials anywhere
+- Running `rm -rf` on tracked directories
+- Bypassing git hooks with `--no-verify`
+- Importing from `src/infra/db/` inside `src/features/**` (violates Layer 2 rules)
+- Creating features without `__contract__.ts` (violates require-feature-contract)
+
+## Acceptance Criteria (before marking a task done)
+
+1. `pnpm lint` — exits 0, no Layer 2 violations in `src/features/`
+2. ESLint ignores build artifacts (at minimum `.next/**`) so generated files are never linted.
+3. `pnpm build && pnpm lint` — both exit 0 (lint remains stable after a build).
+4. `pnpm test` — all unit tests pass
+5. `pnpm check-types` — TypeScript strict mode, no errors
+6. New features include `__contract__.ts`, `index.ts`, and at least one test

package/dist/templates/web-nextjs/README.md

@@ -0,0 +1,204 @@
+# {{PROJECT_NAME}}
+
+> Generated from the [AgentDock](https://github.com/CogitoTech/agentdock) `web-nextjs` template.
+
+Full-stack Next.js 16 starter with Supabase, i18n, Tailwind CSS and strict TypeScript.
+Designed for both human developers and AI coding agents.
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| Framework | [Next.js 16](https://nextjs.org) (App Router) |
+| Language | [TypeScript 5+](https://www.typescriptlang.org) (strict mode) |
+| Styling | [Tailwind CSS v4](https://tailwindcss.com) |
+| Database / Auth | [Supabase](https://supabase.com) (`@supabase/ssr`) |
+| i18n | [next-intl](https://next-intl.dev) (en / zh out of the box) |
+| Testing | [Vitest](https://vitest.dev) |
+| Package manager | [pnpm](https://pnpm.io) ≥ 9 |
+| Runtime | Node.js ≥ 18 |
+| Governance | [OpenSpec](https://github.com/fission-ai/openspec) (`@fission-ai/openspec`) |
+
+## Directory Structure
+
+```
+src/
+├── app/           # Next.js App Router — pages and layouts (per-locale)
+├── core/          # Domain types + repository interfaces (no framework deps)
+├── features/      # AI coding zone — one directory per feature
+│   └── hello/     # Reference feature (copy this pattern)
+├── infra/         # Supabase implementations (requires human review to edit)
+│   └── db/        # Supabase client + repository implementations
+└── i18n/          # next-intl configuration
+messages/          # Translation files (en.json, zh.json)
+openspec/          # Project governance — changes and specs
+```
+
+> **Four-layer contract** is enforced by ESLint Layer 2 rules.
+> Features must not import from `infra/db` directly — use `core/repositories` interfaces.
+
+## Getting Started
+
+### 1. Prerequisites
+
+- Node.js ≥ 18
+- pnpm ≥ 9 — `npm install -g pnpm`
+- A [Supabase](https://supabase.com) project (free tier works)
+
+### 2. Install dependencies
+
+```bash
+pnpm install
+```
+
+### 3. Configure environment variables
+
+```bash
+cp .env.example .env.local
+```
+
+Open `.env.local` and fill in your values:
+
+| Variable | Where to find it |
+|----------|-----------------|
+| `NEXT_PUBLIC_SUPABASE_URL` | Supabase Dashboard → Project Settings → API → Project URL |
+| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Supabase Dashboard → Project Settings → API → anon / public |
+| `SUPABASE_SERVICE_ROLE_KEY` | Supabase Dashboard → Project Settings → API → service_role (server only) |
+| `NEXT_PUBLIC_APP_URL` | `http://localhost:3000` for local dev |
+
+### 4. Start development server
+
+```bash
+pnpm dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) in your browser.
+
+## Development
+
+### Common commands
+
+```bash
+pnpm dev          # Start dev server (http://localhost:3000)
+pnpm build        # Production build
+pnpm start        # Serve production build
+pnpm test         # Run Vitest unit tests
+pnpm check-types  # TypeScript type check (no emit)
+pnpm lint         # ESLint (includes Layer 2 architectural rules)
+```
+
+### Adding a new feature
+
+Features live in `src/features/`. Follow the reference implementation in `src/features/hello/`:
+
+```
+src/features/<your-feature>/
+├── __contract__.ts   # Public API surface (required — export types and functions)
+├── index.ts          # Re-exports from __contract__.ts
+└── *.test.ts         # Vitest unit tests
+```
+
+Rules:
+- Features import from `src/core/` (domain interfaces) — never from `src/infra/` directly.
+- Every feature directory **must** have `__contract__.ts` (ESLint enforces this).
+- Add translations to `messages/en.json` and `messages/zh.json`.
+
+### Adding a language
+
+1. Add locale to `src/i18n/routing.ts` and `middleware.ts`.
+2. Create `messages/<locale>.json` with translated keys.
+
+### Running tests
+
+```bash
+pnpm test              # Run all tests once
+pnpm test --watch      # Watch mode
+pnpm test --coverage   # With coverage report
+```
+
+## Deployment
+
+### Vercel (recommended)
+
+1. Push your project to GitHub.
+2. Import the repository in [Vercel](https://vercel.com/new).
+3. Add all environment variables from `.env.example` in **Project Settings → Environment Variables**.
+4. Deploy — Vercel auto-detects Next.js.
+
+### Docker / other platforms
+
+```bash
+pnpm build
+pnpm start
+```
+
+Ensure all `NEXT_PUBLIC_*` variables are set at **build time** (they are inlined by Next.js).  
+Server-only variables (`SUPABASE_SERVICE_ROLE_KEY`) must be available at **runtime**.
+
+### Supabase: production checklist
+
+- [ ] Enable Row Level Security (RLS) on all tables.
+- [ ] Review and tighten RLS policies.
+- [ ] Rotate the `service_role` key if it was ever exposed.
+- [ ] Enable Supabase Auth email confirmation.
+
+## Governance (OpenSpec)
+
+This project uses [OpenSpec](https://github.com/fission-ai/openspec) for AI-assisted change governance.
+
+```bash
+openspec list              # List all changes
+openspec status --change <name>   # Check change artifact status
+openspec instructions apply --change <name>  # Get implementation instructions
+```
+
+Changes live in `openspec/changes/`. The four-gate builder workflow:
+
+```
+Human approves roadmap → Human reviews scope → AI codes → Machine gates (lint/types/tests)
+```
+
+See `openspec/config.yaml` for project-specific governance rules.
+
+## Environment Variables Reference
+
+| Variable | Required | Exposed to browser | Description |
+|----------|----------|--------------------|-------------|
+| `NEXT_PUBLIC_SUPABASE_URL` | ✅ | ✅ | Supabase project URL |
+| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | ✅ | ✅ | Supabase anon key (RLS protected) |
+| `SUPABASE_SERVICE_ROLE_KEY` | Optional | ❌ | Admin key, bypasses RLS |
+| `NEXT_PUBLIC_APP_URL` | Optional | ✅ | Canonical app URL |
+
+> Variables prefixed with `NEXT_PUBLIC_` are bundled into client-side JavaScript.  
+> Never put secrets in `NEXT_PUBLIC_*` variables.
+
+## FAQs
+
+**Q: pnpm install fails with `ERR_PNPM_FETCH_404` for `@cogito.ai/*`**  
+A: The `@cogito.ai/tsconfig` and `@cogito.ai/eslint-config` packages must be published to npm before use. If you generated this project before the packages were published, run `pnpm install` again after they are live at [npmjs.com/@agentdock](https://www.npmjs.com/org/cogito.ai).
+
+**Q: How do I add a new Supabase table?**  
+A: Create the table in the Supabase Dashboard, then add a repository interface to `src/core/repositories/` and implement it in `src/infra/db/`. Do not call Supabase directly from `src/features/` — use the interface.
+
+**Q: How do I disable i18n and use a single language?**  
+A: Set a single locale in `src/i18n/routing.ts` and remove the `[locale]` segment handling in `middleware.ts`. Keep `messages/en.json` and remove unused locale files.
+
+**Q: TypeScript is strict — how do I handle `!` assertions?**  
+A: Prefer explicit checks (`if (!value) throw new Error(...)`) over `!` assertions. If you must use one, add a comment explaining why the value is guaranteed non-null.
+
+**Q: Can AI agents work in this project?**  
+A: Yes. See `AGENTS.md` for the autonomy boundary contract. AI agents may freely edit `src/features/` but must pause for human review before editing `src/infra/` or `middleware.ts`.
+
+## Contributing
+
+This project follows [Conventional Commits](https://www.conventionalcommits.org):
+
+```
+feat(hello): add greeting animation
+fix(i18n): correct zh translation key
+chore: update dependencies
+```
+
+## License
+
+MIT

package/dist/templates/web-nextjs/eslint.config.js

@@ -0,0 +1,12 @@
+// @ts-check
+const base = require("@cogito.ai/eslint-config/base");
+const features = require("@cogito.ai/eslint-config/features");
+
+/** @type {import("eslint").Linter.Config[]} */
+module.exports = [
+  {
+    ignores: [".next/**"],
+  },
+  ...base,
+  ...features,
+];

package/dist/templates/web-nextjs/messages/en.json

@@ -0,0 +1,10 @@
+{
+  "home": {
+    "title": "Welcome to AgentDock Web Template",
+    "description": "A Next.js scaffold with four-layer architecture."
+  },
+  "hello": {
+    "title": "Hello Feature",
+    "greeting": "Hello, {name}!"
+  }
+}

package/dist/templates/web-nextjs/messages/zh.json

@@ -0,0 +1,10 @@
+{
+  "home": {
+    "title": "home.title",
+    "description": "home.description"
+  },
+  "hello": {
+    "title": "hello.title",
+    "greeting": "hello.greeting"
+  }
+}

package/dist/templates/web-nextjs/middleware.ts

@@ -0,0 +1,34 @@
+import createMiddleware from 'next-intl/middleware'
+import { defineRouting } from 'next-intl/routing'
+import { NextResponse, type NextRequest } from 'next/server'
+
+export const routing = defineRouting({
+  locales: ['en', 'zh'],
+  defaultLocale: 'en',
+})
+
+const handleI18nRouting = createMiddleware(routing)
+
+export default function middleware(request: NextRequest) {
+  const segments = request.nextUrl.pathname.split('/').filter(Boolean)
+  const firstSegment = segments[0]
+
+  if (firstSegment !== undefined) {
+    const isLocaleLike = /^[a-z]{2}(?:-[A-Z]{2})?$/.test(firstSegment)
+    const isSupportedLocale = routing.locales.includes(firstSegment as 'en' | 'zh')
+
+    // Normalize unknown locale-like prefixes: /fr/hello -> /en/hello.
+    if (isLocaleLike && !isSupportedLocale) {
+      const url = request.nextUrl.clone()
+      url.pathname = `/${routing.defaultLocale}/${segments.slice(1).join('/')}`.replace(/\/$/, '')
+      return NextResponse.redirect(url)
+    }
+  }
+
+  return handleI18nRouting(request)
+}
+
+export const config = {
+  // Match all pathnames except Next.js internals and static files.
+  matcher: ['/((?!_next|_vercel|.*\\..*).*)'],
+}

package/dist/templates/web-nextjs/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/dist/templates/web-nextjs/next.config.ts

@@ -0,0 +1,8 @@
+import type { NextConfig } from 'next'
+import createNextIntlPlugin from 'next-intl/plugin'
+
+const withNextIntl = createNextIntlPlugin('./src/i18n/request.ts')
+
+const nextConfig: NextConfig = {}
+
+export default withNextIntl(nextConfig)

package/dist/templates/web-nextjs/openspec/config.yaml

@@ -0,0 +1,28 @@
+schema: spec-driven
+
+# Project context (shown to AI when creating artifacts)
+context: |
+  You are working in a project generated from the AgentDock web-nextjs template.
+
+  Tech stack: Next.js 16 (App Router), React 19, TypeScript 5+ (strict), Tailwind CSS,
+  Supabase (@supabase/ssr), next-intl (i18n), Vitest (unit tests), pnpm ≥9, Node ≥18.
+
+  Four-layer directory contract (enforced by ESLint Layer 2 rules at error severity):
+    src/core/       — domain types + repository interfaces (no framework deps, read-only)
+    src/features/   — AI coding zone; each feature needs __contract__.ts + index.ts + tests
+    src/infra/      — Supabase implementation (requires human approval before editing)
+    src/app/        — Next.js App Router pages and layouts
+
+  Governance rules:
+    - Conventional commits: type(scope): summary
+    - pnpm only — no npm/yarn
+    - TypeScript strict — no any, no @ts-ignore without explanation
+    - Features must not import from infra/db directly (use core/repositories interfaces)
+    - Every feature directory must have __contract__.ts
+
+  Reference feature: src/features/hello/ (complete example of the four-layer pattern)
+
+# Workflow rules
+rules:
+  proposal:
+    - "Proposal MUST contain a Non-goals section listing what this change will NOT implement."

package/dist/templates/web-nextjs/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@cogito.ai/template-web-nextjs",
+  "version": "0.1.0",
+  "description": "Full-stack Next.js 16 starter with Supabase, next-intl, Tailwind CSS and Vitest",
+  "private": true,
+  "engines": {
+    "pnpm": ">=9",
+    "node": ">=18"
+  },
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "check-types": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@supabase/ssr": "^0.10.3",
+    "next": "16",
+    "next-intl": "^4.13.0",
+    "react": "19",
+    "react-dom": "19"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^6.0.2",
+    "tailwindcss": "^4.3.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8",
+    "@cogito.ai/eslint-config": "workspace:*",
+    "@cogito.ai/tsconfig": "workspace:*",
+    "@fission-ai/openspec": "^1.3.1"
+  },
+  "agentdock": {
+    "minCliVersion": "0.1.0"
+  }
+}

package/dist/templates/web-nextjs/src/app/[locale]/globals.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

package/dist/templates/web-nextjs/src/app/[locale]/hello/page.tsx

@@ -0,0 +1,45 @@
+import { getTranslations } from 'next-intl/server'
+import { greet } from '@/features/hello'
+import type { Greeting } from '@/core/types/greeting'
+
+async function loadRecentGreetings(): Promise<Greeting[]> {
+  // Gracefully skip DB access when Supabase is not configured.
+  if (!process.env.NEXT_PUBLIC_SUPABASE_URL || !process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY) {
+    return []
+  }
+
+  try {
+    const { SupabaseGreetingRepository } = await import('@/infra/db/SupabaseGreetingRepository')
+    const repo = new SupabaseGreetingRepository()
+    return await repo.findRecent()
+  } catch {
+    return []
+  }
+}
+
+export default async function HelloPage() {
+  const t = await getTranslations('hello')
+  const greeting = greet('World')
+  const recentGreetings = await loadRecentGreetings()
+
+  return (
+    <main className="flex min-h-screen flex-col items-center justify-center p-24">
+      <h1 className="text-4xl font-bold">{t('title')}</h1>
+      <p className="mt-4 text-xl text-gray-700">{greeting}</p>
+      <p className="mt-2 text-gray-500">{t('greeting', { name: 'World' })}</p>
+
+      {recentGreetings.length > 0 && (
+        <section className="mt-8">
+          <h2 className="text-lg font-semibold">Recent greetings</h2>
+          <ul className="mt-2 space-y-1">
+            {recentGreetings.map((g) => (
+              <li key={g.id} className="text-sm text-gray-600">
+                {g.name} — {g.createdAt}
+              </li>
+            ))}
+          </ul>
+        </section>
+      )}
+    </main>
+  )
+}

package/dist/templates/web-nextjs/src/app/[locale]/layout.tsx

@@ -0,0 +1,37 @@
+import type { Metadata } from 'next'
+import { NextIntlClientProvider } from 'next-intl'
+import { getMessages } from 'next-intl/server'
+import { notFound } from 'next/navigation'
+import './globals.css'
+
+const locales = ['en', 'zh'] as const
+type Locale = (typeof locales)[number]
+
+export const metadata: Metadata = {
+  title: 'AgentDock Web Template',
+  description: 'Generated by AgentDock scaffold platform',
+}
+
+export default async function LocaleLayout({
+  children,
+  params,
+}: {
+  children: React.ReactNode
+  params: Promise<{ locale: string }>
+}) {
+  const { locale } = await params
+
+  if (!locales.includes(locale as Locale)) {
+    notFound()
+  }
+
+  const messages = await getMessages()
+
+  return (
+    <html lang={locale}>
+      <body>
+        <NextIntlClientProvider messages={messages}>{children}</NextIntlClientProvider>
+      </body>
+    </html>
+  )
+}

package/dist/templates/web-nextjs/src/app/[locale]/page.tsx

@@ -0,0 +1,12 @@
+import { useTranslations } from 'next-intl'
+
+export default function HomePage() {
+  const t = useTranslations('home')
+
+  return (
+    <main className="flex min-h-screen flex-col items-center justify-center p-24">
+      <h1 className="text-4xl font-bold">{t('title')}</h1>
+      <p className="mt-4 text-gray-600">{t('description')}</p>
+    </main>
+  )
+}

package/dist/templates/web-nextjs/src/core/repositories/.gitkeep

@@ -0,0 +1,2 @@
+# src/core/repositories
+# Repository interfaces — pure TypeScript interfaces, no DB dependencies.

package/dist/templates/web-nextjs/src/core/repositories/IGreetingRepository.ts

@@ -0,0 +1,14 @@
+import type { Greeting } from '../types/greeting'
+
+/**
+ * Repository interface for Greeting persistence.
+ * Uses domain types only — no Supabase types leak through.
+ * Implement this in src/infra/db/ to swap storage backends.
+ */
+export interface IGreetingRepository {
+  /** Persist a new greeting and return the saved record. */
+  save(name: string): Promise<Greeting>
+
+  /** Return the most recent greeting records. */
+  findRecent(): Promise<Greeting[]>
+}

package/dist/templates/web-nextjs/src/core/types/.gitkeep

@@ -0,0 +1,3 @@
+# src/core/types
+# Domain types — no framework dependencies.
+# Do not add Supabase, Next.js, or React imports here.

package/dist/templates/web-nextjs/src/core/types/greeting.ts

@@ -0,0 +1,9 @@
+/**
+ * Greeting — domain type.
+ * No Supabase types here; this is pure domain model.
+ */
+export interface Greeting {
+  id: string
+  name: string
+  createdAt: string
+}

package/dist/templates/web-nextjs/src/features/_experiments/.gitkeep

@@ -0,0 +1,2 @@
+# src/features/_experiments
+# Experimental sandboxes — NOT to be imported by non-_experiments features.