@cogito.ai/cli 0.2.0 → 0.3.1

package/dist/registry.json

@@ -4,22 +4,12 @@
     {
       "id": "web-nextjs",
       "name": "@cogito.ai/template-web-nextjs",
-      "description": "Full-stack Next.js 16 starter with Supabase, next-intl, Tailwind CSS and Vitest",
+      "description": "Full-stack Next.js 16 monorepo starter with Supabase, next-intl, Tailwind CSS, Vitest and built-in Fumadocs docs site",
       "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"
+        "@fission-ai/openspec": "^1.3.1",
+        "turbo": "latest"
       }
     }
   ]

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

@@ -2,25 +2,45 @@
 
 > Applies to: GitHub Copilot (chat + completions) in any project generated from this template.
 
+## Monorepo Structure
+
+This project is a turborepo + pnpm monorepo with two applications:
+
+| Directory    | Purpose                                                              |
+| ------------ | -------------------------------------------------------------------- |
+| `apps/web/`  | Main Next.js 16 application (four-layer contract, features, i18n)    |
+| `apps/docs/` | Fumadocs documentation site (features, decisions, changelog, roadmap)|
+| `packages/`  | Shared tooling packages (eslint-config, tsconfig)                    |
+
+Run all commands from the monorepo root: `pnpm build`, `pnpm lint`, `pnpm test`, `pnpm check-types`.
+
 ## Directory Contract
 
-This project enforces a four-layer directory contract. **Before placing any code**, confirm which layer it belongs to:
+This project enforces a four-layer directory contract inside `apps/web/`. **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           | Path                                  | Purpose                                                        | Rules                                                                      |
+| --------------- | ------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| **core**        | `apps/web/src/core/`                  | Stable domain layer — types, repository interfaces, pure logic | No framework imports, no DB clients, read-only                             |
+| **features**    | `apps/web/src/features/`              | AI coding zone — business features                             | Must have `__contract__.ts`; no direct DB access; no cross-feature imports |
+| **infra**       | `apps/web/src/infra/`                 | Infrastructure — Supabase clients, third-party SDKs            | Requires approval; only `core/repositories` implementations live here      |
+| **experiments** | `apps/web/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`.
+Four rules are enforced at `error` severity in `apps/web/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.
+1. **`no-direct-db-in-features`** — Features must not import from `infra/db`. Use repository interfaces from `apps/web/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.
+4. **`no-core-mutation`** — `apps/web/src/core/` is read-only. Features and infra must not modify core types or interfaces in-place.
+
+## Docs Co-evolution
+
+Documentation lives alongside the application and grows with it:
+
+- **Feature docs**: When adding a new feature, create `apps/docs/content/docs/features/<name>.mdx` documenting its purpose, API, and architecture notes.
+- **Architecture decisions**: Record significant decisions in `apps/docs/content/docs/decisions/<adr-id>.mdx` (e.g., `001-database-choice.mdx`).
+- **Changelog & Roadmap**: After archiving a change in `openspec/`, run `pnpm docs:sync` from the monorepo root to auto-generate changelog and roadmap pages in `apps/docs/`.
 
 ## Hard Rules
 
@@ -28,16 +48,18 @@ Four rules are enforced at `error` severity in `src/features/**`. Violations fai
 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.
+5. **ESLint config** — Architecture rules come from `packages/eslint-config/features.js`.
 
 ## Feature Development Pattern
 
-When adding a new feature `src/features/<name>/`:
+When adding a new feature `apps/web/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.
+5. Create page/component in `apps/web/src/app/[locale]/` to consume the feature.
+6. Create `apps/docs/content/docs/features/<name>.mdx` — feature documentation.
+
+Reference implementation: `apps/web/src/features/hello/`.
 
-Reference implementation: `src/features/hello/`.

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

@@ -11,36 +11,39 @@
 
 ### May execute autonomously
 
-- `pnpm install`, `pnpm build`, `pnpm check-types`, `pnpm lint`, `pnpm test`
+- `pnpm install`, `pnpm build`, `pnpm check-types`, `pnpm lint`, `pnpm test`, `pnpm docs:sync`
 - 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`
+- Adding new features inside `apps/web/src/features/` (following the contract pattern)
+- Adding repository interfaces to `apps/web/src/core/repositories/`
+- Updating translations in `apps/web/messages/`
+- Writing or updating tests in `apps/web/src/**/*.test.ts`
+- Creating / updating MDX documentation in `apps/docs/content/` (feature docs, ADRs)
 - 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`
+- Adding new **top-level** directories outside the monorepo contract (`apps/`, `packages/`)
+- Adding new directories outside the four-layer contract inside `apps/web/src/` (`core/`, `features/`, `infra/`, `app/`)
+- Adding new `dependencies` or `devDependencies` to any `package.json`
 - Any change to `openspec/config.yaml`
-- Modifying `middleware.ts` (affects routing for all locales)
+- Modifying `apps/web/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)
+- Importing from `apps/web/src/infra/db/` inside `apps/web/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/`
+1. `pnpm lint` — exits 0, no Layer 2 violations in `apps/web/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
+5. `pnpm check-types` — TypeScript strict mode, no errors in `apps/web` and `apps/docs`
 6. New features include `__contract__.ts`, `index.ts`, and at least one test
+7. New features have a corresponding `apps/docs/content/docs/features/<name>.mdx`

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

@@ -2,7 +2,8 @@
 
 > 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.
+Full-stack Next.js 16 monorepo starter with Supabase, i18n, Tailwind CSS, strict TypeScript,
+and a built-in Fumadocs documentation site.
 Designed for both human developers and AI coding agents.
 
 ## Tech Stack
@@ -18,20 +19,24 @@ Designed for both human developers and AI coding agents.
 | Package manager | [pnpm](https://pnpm.io) ≥ 9 |
 | Runtime | Node.js ≥ 18 |
 | Governance | [OpenSpec](https://github.com/fission-ai/openspec) (`@fission-ai/openspec`) |
+| Monorepo | [Turborepo](https://turbo.build/repo) + pnpm workspaces |
 
 ## 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
+```text
+apps/
+├── web/
+│   ├── 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
+│   │   ├── infra/     # Supabase implementations (requires human review to edit)
+│   │   └── i18n/      # next-intl request configuration
+│   ├── messages/      # Translation files (en.json, zh.json)
+│   └── middleware.ts  # Locale routing guard + next-intl middleware
+├── docs/              # Fumadocs site (features, decisions, changelog, roadmap)
+packages/              # Shared tooling packages (eslint-config, tsconfig, docs sync)
+openspec/              # Project governance — changes and specs
 ```
 
 > **Four-layer contract** is enforced by ESLint Layer 2 rules.
@@ -72,48 +77,50 @@ Open `.env.local` and fill in your values:
 pnpm dev
 ```
 
-Open [http://localhost:3000](http://localhost:3000) in your browser.
+Open [http://localhost:3000](http://localhost:3000) for the app and
+[http://localhost:3001](http://localhost:3001) for docs.
 
 ## 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 dev          # Start all workspace dev tasks
+pnpm build        # Build all workspace packages/apps
+pnpm test         # Run tests (currently apps/web Vitest)
+pnpm check-types  # TypeScript check across apps/web and apps/docs
 pnpm lint         # ESLint (includes Layer 2 architectural rules)
+pnpm docs:sync    # Generate changelog/roadmap docs from openspec archive
 ```
 
 ### Adding a new feature
 
-Features live in `src/features/`. Follow the reference implementation in `src/features/hello/`:
+Features live in `apps/web/src/features/`. Follow the reference implementation in `apps/web/src/features/hello/`:
 
 ```
-src/features/<your-feature>/
+apps/web/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.
+- Features import from `apps/web/src/core/` (domain interfaces) — never from `apps/web/src/infra/` directly.
 - Every feature directory **must** have `__contract__.ts` (ESLint enforces this).
-- Add translations to `messages/en.json` and `messages/zh.json`.
+- Add translations to `apps/web/messages/en.json` and `apps/web/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.
+1. Add locale to `apps/web/middleware.ts` routing config.
+2. Create `apps/web/messages/<locale>.json` with translated keys.
+3. Ensure `apps/web/src/i18n/request.ts` can load the new locale JSON.
 
 ### Running tests
 
 ```bash
 pnpm test              # Run all tests once
-pnpm test --watch      # Watch mode
-pnpm test --coverage   # With coverage report
+pnpm --filter @cogito.ai/web test --watch      # Watch mode
+pnpm --filter @cogito.ai/web test --coverage   # With coverage report
 ```
 
 ## Deployment
@@ -129,7 +136,7 @@ pnpm test --coverage   # With coverage report
 
 ```bash
 pnpm build
-pnpm start
+pnpm --filter @cogito.ai/web start
 ```
 
 Ensure all `NEXT_PUBLIC_*` variables are set at **build time** (they are inlined by Next.js).  
@@ -178,16 +185,16 @@ See `openspec/config.yaml` for project-specific governance rules.
 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.
+A: Create the table in the Supabase Dashboard, then add a repository interface to `apps/web/src/core/repositories/` and implement it in `apps/web/src/infra/db/`. Do not call Supabase directly from `apps/web/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.
+A: Set a single locale in `apps/web/middleware.ts` and simplify locale segment handling there. Keep `apps/web/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`.
+A: Yes. See `AGENTS.md` for the autonomy boundary contract. AI agents may freely edit `apps/web/src/features/` but must pause for human review before editing `apps/web/src/infra/` or `apps/web/middleware.ts`.
 
 ## Contributing
 

package/dist/templates/web-nextjs/apps/docs/.source/browser.ts

@@ -0,0 +1,12 @@
+// @ts-nocheck
+import { browser } from 'fumadocs-mdx/runtime/browser';
+import type * as Config from '../source.config';
+
+const create = browser<typeof Config, import("fumadocs-mdx/runtime/types").InternalTypeConfig & {
+  DocData: {
+  }
+}>();
+const browserCollections = {
+  docs: create.doc("docs", {"index.mdx": () => import("../content/docs/index.mdx?collection=docs"), "changelog/index.mdx": () => import("../content/docs/changelog/index.mdx?collection=docs"), "features/hello.mdx": () => import("../content/docs/features/hello.mdx?collection=docs"), "roadmap/index.mdx": () => import("../content/docs/roadmap/index.mdx?collection=docs"), }),
+};
+export default browserCollections;

package/dist/templates/web-nextjs/apps/docs/.source/dynamic.ts

@@ -0,0 +1,8 @@
+// @ts-nocheck
+import { dynamic } from 'fumadocs-mdx/runtime/dynamic';
+import * as Config from '../source.config';
+
+const create = await dynamic<typeof Config, import("fumadocs-mdx/runtime/types").InternalTypeConfig & {
+  DocData: {
+  }
+}>(Config, {"configPath":"source.config.ts","environment":"next","outDir":".source"}, {"doc":{"passthroughs":["extractedReferences"]}});

package/dist/templates/web-nextjs/apps/docs/.source/server.ts

@@ -0,0 +1,19 @@
+// @ts-nocheck
+import * as __fd_glob_8 from "../content/docs/roadmap/index.mdx?collection=docs"
+import * as __fd_glob_7 from "../content/docs/features/hello.mdx?collection=docs"
+import * as __fd_glob_6 from "../content/docs/changelog/index.mdx?collection=docs"
+import * as __fd_glob_5 from "../content/docs/index.mdx?collection=docs"
+import { default as __fd_glob_4 } from "../content/docs/roadmap/meta.json?collection=docs"
+import { default as __fd_glob_3 } from "../content/docs/features/meta.json?collection=docs"
+import { default as __fd_glob_2 } from "../content/docs/decisions/meta.json?collection=docs"
+import { default as __fd_glob_1 } from "../content/docs/changelog/meta.json?collection=docs"
+import { default as __fd_glob_0 } from "../content/docs/meta.json?collection=docs"
+import { server } from 'fumadocs-mdx/runtime/server';
+import type * as Config from '../source.config';
+
+const create = server<typeof Config, import("fumadocs-mdx/runtime/types").InternalTypeConfig & {
+  DocData: {
+  }
+}>({"doc":{"passthroughs":["extractedReferences"]}});
+
+export const docs = await create.docs("docs", "content/docs", {"meta.json": __fd_glob_0, "changelog/meta.json": __fd_glob_1, "decisions/meta.json": __fd_glob_2, "features/meta.json": __fd_glob_3, "roadmap/meta.json": __fd_glob_4, }, {"index.mdx": __fd_glob_5, "changelog/index.mdx": __fd_glob_6, "features/hello.mdx": __fd_glob_7, "roadmap/index.mdx": __fd_glob_8, });

package/dist/templates/web-nextjs/apps/docs/.source/source.config.mjs

@@ -0,0 +1,10 @@
+// source.config.ts
+import { defineConfig, defineDocs } from "fumadocs-mdx/config";
+var docs = defineDocs({
+  dir: "content/docs"
+});
+var source_config_default = defineConfig({});
+export {
+  source_config_default as default,
+  docs
+};

package/dist/templates/web-nextjs/apps/docs/app/(home)/page.tsx

@@ -0,0 +1,5 @@
+import { redirect } from 'next/navigation'
+
+export default function HomePage() {
+  redirect('/docs')
+}

package/dist/templates/web-nextjs/apps/docs/app/api/search/route.ts

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

package/dist/templates/web-nextjs/apps/docs/app/docs/[[...slug]]/page.tsx

@@ -0,0 +1,41 @@
+import { source } from '@/lib/source'
+import {
+  DocsBody,
+  DocsDescription,
+  DocsPage,
+  DocsTitle,
+} from 'fumadocs-ui/layouts/docs/page'
+import { notFound } from 'next/navigation'
+
+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}>
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription>{page.data.description}</DocsDescription>
+      <DocsBody>
+        <MDX />
+      </DocsBody>
+    </DocsPage>
+  )
+}
+
+export async 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/dist/templates/web-nextjs/apps/docs/app/docs/layout.tsx

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

package/dist/templates/web-nextjs/apps/docs/app/global.css

@@ -0,0 +1,3 @@
+@import 'tailwindcss';
+@import 'fumadocs-ui/css/neutral.css';
+@import 'fumadocs-ui/css/preset.css';

package/dist/templates/web-nextjs/apps/docs/app/layout.tsx

@@ -0,0 +1,13 @@
+import { RootProvider } from 'fumadocs-ui/provider/next'
+import './global.css'
+import type { ReactNode } from 'react'
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <body>
+        <RootProvider>{children}</RootProvider>
+      </body>
+    </html>
+  )
+}

package/dist/templates/web-nextjs/apps/docs/app/llms-full.txt/route.ts

@@ -0,0 +1,11 @@
+import { source } from '@/lib/source'
+
+export const revalidate = false
+
+export async function GET() {
+  const pages = source.getPages()
+  const texts = await Promise.all(
+    pages.map(async (page) => `# ${page.data.title} (${page.url})\n\n${page.data.description ?? ''}`)
+  )
+  return new Response(texts.join('\n\n'))
+}

package/dist/templates/web-nextjs/apps/docs/app/llms.txt/route.ts

@@ -0,0 +1,8 @@
+import { source } from '@/lib/source'
+import { llms } from 'fumadocs-core/source'
+
+export const revalidate = false
+
+export function GET() {
+  return new Response(llms(source).index())
+}

package/dist/templates/web-nextjs/apps/docs/content/docs/changelog/.gitkeep

@@ -0,0 +1,2 @@
+<!-- AUTO-GENERATED by openspec-docs-sync. Do not edit manually. -->
+<!-- Run `pnpm docs:sync` from the monorepo root to regenerate this directory. -->

package/dist/templates/web-nextjs/apps/docs/content/docs/changelog/index.mdx

@@ -0,0 +1,9 @@
+---
+title: "Changelog"
+description: "Archived changes and decision log, newest first."
+---
+
+{/* <!-- AUTO-GENERATED by openspec-docs-sync. Do not edit manually. --> */}
+
+Archived changes in reverse-chronological order.
+

package/dist/templates/web-nextjs/apps/docs/content/docs/changelog/meta.json

@@ -0,0 +1,3 @@
+{
+  "title": "Changelog"
+}

package/dist/templates/web-nextjs/apps/docs/content/docs/decisions/meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "Decisions",
+  "pages": []
+}

package/dist/templates/web-nextjs/apps/docs/content/docs/features/hello.mdx

@@ -0,0 +1,29 @@
+---
+title: "Hello Feature"
+description: "Reference implementation of the feature contract pattern."
+---
+
+## Overview
+
+The `hello` feature demonstrates the four-layer directory contract in practice:
+
+- `__contract__.ts` — declares input/output types and public API
+- `service.ts` — pure business logic, no side effects
+- `index.ts` — exports only what the contract declares
+- `hello.test.ts` — Vitest unit tests
+
+## Usage
+
+```typescript
+import { getGreeting } from '@/features/hello'
+
+const result = getGreeting({ name: 'World' })
+// { message: 'Hello, World!' }
+```
+
+## Architecture Notes
+
+This feature follows Layer 2 rules:
+- No direct database access (uses repository interfaces from `core/`)
+- No cross-feature imports
+- Contract-first design

package/dist/templates/web-nextjs/apps/docs/content/docs/features/meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "Features",
+  "pages": ["hello"]
+}

package/dist/templates/web-nextjs/apps/docs/content/docs/index.mdx

@@ -0,0 +1,6 @@
+---
+title: "Welcome"
+description: "Documentation for your project."
+---
+
+Welcome to the project documentation. Use the navigation to explore features, architectural decisions, changelog, and roadmap.

package/dist/templates/web-nextjs/apps/docs/content/docs/meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "Documentation",
+  "pages": ["features", "decisions", "changelog", "roadmap"]
+}

package/dist/templates/web-nextjs/apps/docs/content/docs/roadmap/.gitkeep

@@ -0,0 +1,2 @@
+<!-- AUTO-GENERATED by openspec-docs-sync. Do not edit manually. -->
+<!-- Run `pnpm docs:sync` from the monorepo root to regenerate this directory. -->

package/dist/templates/web-nextjs/apps/docs/content/docs/roadmap/index.mdx

@@ -0,0 +1,29 @@
+---
+title: "Roadmap"
+description: "Current platform roadmap — four-bucket view (Now / Next / Later / Won't)."
+---
+
+{/* <!-- AUTO-GENERATED by openspec-docs-sync. Do not edit manually. --> */}
+
+> Auto-generated from `roadmap.yaml`. To update, edit the YAML and re-run `pnpm docs:sync`.
+
+## Now
+
+- 🔄 **Web Next.js built-in suite (monorepo + docs + auth + payments)** `web-nextjs-builtin-suite`  
+  Status: in-progress · Owner: @team
+
+## Next
+
+- 📋 **Add authentication feature (Supabase Auth)** `web-nextjs-auth`  
+  Status: planned · Owner: @team
+- 📋 **Add payments feature (Stripe)** `web-nextjs-payments`  
+  Status: planned · Owner: @team
+
+## Later
+
+- 📋 **Add analytics feature** `web-nextjs-analytics`  
+  Status: planned · Owner: @team
+
+## Won't
+
+_No items._

package/dist/templates/web-nextjs/apps/docs/content/docs/roadmap/meta.json

@@ -0,0 +1,3 @@
+{
+  "title": "Roadmap"
+}

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

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

package/dist/templates/web-nextjs/apps/docs/lib/source.ts

@@ -0,0 +1,7 @@
+import { docs } from 'collections/server'
+import { loader } from 'fumadocs-core/source'
+
+export const source = loader({
+  baseUrl: '/docs',
+  source: docs.toFumadocsSource(),
+})

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

@@ -0,0 +1,14 @@
+import { createMDX } from 'fumadocs-mdx/next'
+import type { NextConfig } from 'next'
+import path from 'node:path'
+
+const withMDX = createMDX()
+
+const config: NextConfig = {
+  reactStrictMode: true,
+  turbopack: {
+    root: path.resolve(process.cwd(), '../..'),
+  },
+}
+
+export default withMDX(config)