@cogito.ai/cli 0.2.0 → 0.3.0

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

@@ -0,0 +1,38 @@
+{
+  "name": "@cogito.ai/docs",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev --port 3001",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint .",
+    "check-types": "tsc --noEmit",
+    "docs:sync": "openspec-docs-sync",
+    "postinstall": "fumadocs-mdx"
+  },
+  "dependencies": {
+    "fumadocs-core": "16.9.3",
+    "fumadocs-mdx": "15.0.10",
+    "fumadocs-ui": "16.9.3",
+    "next": "16",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@cogito.ai/eslint-config": "workspace:*",
+    "@cogito.ai/tsconfig": "workspace:*",
+    "@cogito.ai/openspec-docs-sync": "workspace:*",
+    "@tailwindcss/postcss": "^4.3.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "@types/mdx": "^2.0.13",
+    "@types/node": "^25.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "eslint": "^9.0.0",
+    "postcss": "^8.5.15",
+    "tailwindcss": "^4.3.0",
+    "typescript": "^6.0.3"
+  }
+}

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

@@ -0,0 +1,8 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+}
+
+export default config

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

@@ -0,0 +1,7 @@
+import { defineConfig, defineDocs } from 'fumadocs-mdx/config'
+
+export const docs = defineDocs({
+  dir: 'content/docs',
+})
+
+export default defineConfig({})

package/dist/templates/web-nextjs/apps/docs/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@cogito.ai/tsconfig/base.json",
+  "compilerOptions": {
+    "target": "ESNext",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "paths": {
+      "@/*": ["./*"],
+      "collections/*": ["./.source/*"]
+    },
+    "plugins": [{ "name": "next" }]
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

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

@@ -0,0 +1,65 @@
+# AgentDock Web-Next.js Template — Copilot Instructions
+
+> 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 inside `apps/web/`. **Before placing any code**, confirm which layer it belongs to:
+
+| 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 `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 `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`** — `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
+
+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`.
+
+## Feature Development Pattern
+
+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 `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/`.
+

package/dist/templates/web-nextjs/apps/web/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 → apps/web/next.config.ts}

@@ -1,8 +1,13 @@
 import type { NextConfig } from 'next'
 import createNextIntlPlugin from 'next-intl/plugin'
+import path from 'node:path'
 
 const withNextIntl = createNextIntlPlugin('./src/i18n/request.ts')
 
-const nextConfig: NextConfig = {}
+const nextConfig: NextConfig = {
+	turbopack: {
+		root: path.resolve(process.cwd(), '../..'),
+	},
+}
 
 export default withNextIntl(nextConfig)

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

@@ -0,0 +1,33 @@
+{
+  "name": "@cogito.ai/web",
+  "version": "0.1.0",
+  "private": true,
+  "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": {
+    "@cogito.ai/eslint-config": "workspace:*",
+    "@cogito.ai/tsconfig": "workspace:*",
+    "@types/node": "25.9.1",
+    "@types/react": "19.2.16",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "@vitejs/plugin-react": "^6.0.2",
+    "eslint": "^9.0.0",
+    "tailwindcss": "^4.3.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  }
+}

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

@@ -4,14 +4,27 @@ schema: spec-driven
 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,
+  Monorepo structure (turborepo + pnpm):
+    apps/web/   — Main Next.js 16 application
+    apps/docs/  — Fumadocs documentation site (features, decisions, changelog, roadmap)
+    packages/   — Shared tooling packages (eslint-config, tsconfig)
+
+  Tech stack (apps/web): 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
+  Tech stack (apps/docs): Fumadocs (fumadocs-core, fumadocs-ui, fumadocs-mdx), Next.js 16,
+  openspec-docs-sync (auto-generates changelog + roadmap from openspec/changes/archive/).
+
+  Four-layer directory contract in apps/web/src/ (enforced by ESLint Layer 2 rules at error severity):
+    apps/web/src/core/       — domain types + repository interfaces (no framework deps, read-only)
+    apps/web/src/features/   — AI coding zone; each feature needs __contract__.ts + index.ts + tests
+    apps/web/src/infra/      — Supabase implementation (requires human approval before editing)
+    apps/web/src/app/        — Next.js App Router pages and layouts
+
+  Docs co-evolution convention:
+    - New feature → create apps/docs/content/docs/features/<name>.mdx
+    - Architecture decision → create apps/docs/content/docs/decisions/<adr-id>.mdx
+    - After archiving a change → run `pnpm docs:sync` to update changelog + roadmap pages
 
   Governance rules:
     - Conventional commits: type(scope): summary
@@ -20,7 +33,7 @@ context: |
     - 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)
+  Reference feature: apps/web/src/features/hello/ (complete example of the four-layer pattern)
 
 # Workflow rules
 rules:

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

@@ -0,0 +1,31 @@
+# Project Roadmap
+# Human-owned intent map. AI cannot modify this in ordinary changes.
+#
+# Buckets: Now | Next | Later | Won't
+# Entry fields: id (kebab-case, globally unique) | title | status | owner
+# Status values: planned | in-progress | done
+
+now:
+  - id: web-nextjs-builtin-suite
+    title: Web Next.js built-in suite (monorepo + docs + auth + payments)
+    status: in-progress
+    owner: "@team"
+
+next:
+  - id: web-nextjs-auth
+    title: Add authentication feature (Supabase Auth)
+    status: planned
+    owner: "@team"
+
+  - id: web-nextjs-payments
+    title: Add payments feature (Stripe)
+    status: planned
+    owner: "@team"
+
+later:
+  - id: web-nextjs-analytics
+    title: Add analytics feature
+    status: planned
+    owner: "@team"
+
+wont: []

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

@@ -1,35 +1,24 @@
 {
   "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",
+  "description": "Full-stack Next.js 16 monorepo starter with Supabase, next-intl, Tailwind CSS, Vitest and built-in Fumadocs docs site",
   "private": true,
   "engines": {
     "pnpm": ">=9",
     "node": ">=18"
   },
+  "packageManager": "pnpm@9.0.0",
   "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"
+    "build": "pnpm -r run build",
+    "dev": "turbo run dev",
+    "lint": "pnpm -r run lint",
+    "test": "pnpm -r run test",
+    "check-types": "pnpm -r run check-types",
+    "docs:sync": "pnpm --filter @cogito.ai/docs docs:sync"
   },
   "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"
+    "@fission-ai/openspec": "^1.3.1",
+    "turbo": "latest"
   },
   "agentdock": {
     "minCliVersion": "0.1.0"

package/dist/templates/web-nextjs/packages/eslint-config/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @cogito.ai/eslint-config
+
+## 0.2.0
+
+### Minor Changes
+
+- Initial release: shared ESLint config and TypeScript config for AgentDock platform packages and templates

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

@@ -0,0 +1,34 @@
+// @ts-check
+// Base ESLint config — TypeScript-safe rules for all packages
+// Compatible with ESLint v9 flat config format
+"use strict";
+
+const tseslint = require("@typescript-eslint/eslint-plugin");
+const tsParser = require("@typescript-eslint/parser");
+
+/** @type {import("eslint").Linter.Config[]} */
+const base = [
+  {
+    files: ["**/*.{ts,tsx}"],
+    plugins: {
+      "@typescript-eslint": tseslint,
+    },
+    languageOptions: {
+      parser: tsParser,
+    },
+    rules: {
+      // @ts-ignore without an explanation is a code smell and bypasses type safety.
+      // Developers must justify why TypeScript's type system cannot handle the situation.
+      "@typescript-eslint/ban-ts-comment": [
+        "error",
+        {
+          "ts-ignore": "allow-with-description",
+          "ts-expect-error": "allow-with-description",
+          minimumDescriptionLength: 10,
+        },
+      ],
+    },
+  },
+];
+
+module.exports = base;

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

@@ -0,0 +1,86 @@
+// @ts-check
+// Feature-layer architecture rules — applies only to src/features/**
+// These are "teeth" rules: error from day one, no grace period.
+// Templates must explicitly extend this config to activate these rules.
+"use strict";
+
+const path = require("path");
+const fs = require("fs");
+
+// ---------------------------------------------------------------------------
+// Custom rule: require-feature-contract
+// Every src/features/<name>/ directory MUST contain __contract__.ts.
+// ---------------------------------------------------------------------------
+/** @type {import("eslint").Rule.RuleModule} */
+const requireFeatureContractRule = {
+  meta: {
+    type: "problem",
+    schema: [],
+    messages: {
+      missingContract:
+        "Feature '{{ featureName }}' is missing __contract__.ts. Every feature directory must export a typed contract.",
+    },
+  },
+  create(context) {
+    const filePath = context.filename;
+    // Match the feature root directory: .../src/features/<name>/...
+    const match = filePath.match(
+      /^(.*[/\\]src[/\\]features[/\\][^/\\]+)[/\\]/
+    );
+    if (!match) return {};
+
+    const featureDir = match[1];
+    const featureName = path.basename(featureDir);
+    const contractPath = path.join(featureDir, "__contract__.ts");
+
+    if (!fs.existsSync(contractPath)) {
+      return {
+        Program(node) {
+          context.report({
+            node,
+            messageId: "missingContract",
+            data: { featureName },
+          });
+        },
+      };
+    }
+    return {};
+  },
+};
+
+/** @type {import("eslint").Linter.Config[]} */
+const features = [
+  {
+    // Scope these rules to feature-layer source files only.
+    // Exclude type declarations and test fixtures to avoid false positives.
+    files: ["**/src/features/**/*.{ts,tsx}"],
+    ignores: ["**/*.d.ts", "**/__fixtures__/**", "**/__tests__/**"],
+    plugins: {
+      "agentdock-arch": {
+        rules: {
+          "require-feature-contract": requireFeatureContractRule,
+        },
+      },
+    },
+    rules: {
+      // Features must not directly access DB clients — use repositories from core.
+      // Handles path aliases (@/infra/db/**) and relative imports.
+      "no-restricted-imports": [
+        "error",
+        {
+          patterns: [
+            {
+              group: ["**/infra/db/**", "**/infra/db"],
+              message:
+                "Direct DB access in features is not allowed. Use repositories from src/core/repositories instead.",
+            },
+          ],
+        },
+      ],
+      // Each feature directory must export a typed __contract__.ts.
+      "agentdock-arch/require-feature-contract": "error",
+    },
+  },
+];
+
+module.exports = features;

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

@@ -0,0 +1,24 @@
+// @ts-check
+// Next.js specific ESLint config — extends base with Next.js conventions
+// Compatible with ESLint v9 flat config format
+"use strict";
+
+/** @type {import("eslint").Linter.Config[]} */
+const next = [
+  {
+    files: ["**/*.{ts,tsx}"],
+    rules: {
+      // Discourage console.log in production code; warn so devs notice but are not blocked
+      "no-console": ["warn", { allow: ["warn", "error"] }],
+    },
+  },
+  {
+    // Route handlers and server components may use console for server-side logging
+    files: ["**/app/**/*.{ts,tsx}", "**/pages/api/**/*.{ts,tsx}"],
+    rules: {
+      "no-console": "off",
+    },
+  },
+];
+
+module.exports = next;

package/dist/templates/web-nextjs/packages/eslint-config/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@cogito.ai/eslint-config",
+  "version": "0.2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    "./base": "./base.js",
+    "./features": "./features.js",
+    "./next": "./next.js"
+  },
+  "peerDependencies": {
+    "@typescript-eslint/eslint-plugin": ">=7.0.0",
+    "@typescript-eslint/parser": ">=7.0.0",
+    "eslint": ">=9.0.0"
+  },
+  "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0"
+  }
+}

package/dist/templates/web-nextjs/packages/openspec-docs-sync/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@cogito.ai/openspec-docs-sync",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "bin": {
+    "openspec-docs-sync": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "check-types": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@cogito.ai/tsconfig": "workspace:*",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "typescript": "5.9.2"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0",
+    "gray-matter": "^4.0.3"
+  }
+}