@m2-ai/lattice-cli 0.0.0-stage → 0.8.7

package/bundles/nextjs-landing/README.md

@@ -0,0 +1,39 @@
+# Landing Page Starter
+
+Built with [Lattice Project Builder](https://latticeai.app).
+
+## Getting Started
+
+1. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+2. Review `.env.example` and fill in the variables your selected services need.
+
+3. Run the development server:
+   ```bash
+   npm run dev
+   ```
+
+4. Open [http://localhost:3000](http://localhost:3000)
+
+## Included Scaffold
+
+- PROJECT_GUIDE.md with the planned build scope
+- AI guardrails for Cursor, Codex, and Claude Code
+- GitHub Actions CI and shared verification commands
+- PostHog initialization
+- Sentry runtime initialization and error boundary
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `npm run dev` | Start development server |
+| `npm run build` | Build for production |
+| `npm run start` | Start production server |
+| `npm run lint` | Run ESLint |
+| `npm run typecheck` | Run TypeScript checks |
+| `npm run test` | Run tests |
+| `npm run verify` | Run all checks |

package/bundles/nextjs-landing/app/api/example/[id]/route.ts

@@ -0,0 +1,34 @@
+import { NextResponse } from "next/server";
+
+interface RouteParams {
+  params: Promise<{ id: string }>;
+}
+
+export async function GET(_request: Request, { params }: RouteParams) {
+  const { id } = await params;
+
+  return NextResponse.json({
+    data: { id },
+    message: "Replace this read handler with your real implementation.",
+  });
+}
+
+export async function PATCH(request: Request, { params }: RouteParams) {
+  const { id } = await params;
+  const body = await request.json();
+
+  return NextResponse.json({
+    data: { id, ...body },
+    message: "Replace this update handler with your real implementation.",
+  });
+}
+
+export async function DELETE(_request: Request, { params }: RouteParams) {
+  const { id } = await params;
+
+  return NextResponse.json({
+    success: true,
+    id,
+    message: "Replace this delete handler with your real implementation.",
+  });
+}

package/bundles/nextjs-landing/app/api/example/route.ts

@@ -0,0 +1,24 @@
+import { NextResponse } from "next/server";
+
+export async function GET() {
+  return NextResponse.json({
+    data: [],
+    message: "Replace this route with your real data access layer.",
+  });
+}
+
+export async function POST(request: Request) {
+  const body = await request.json();
+
+  if (!body?.name) {
+    return NextResponse.json({ error: "Name is required" }, { status: 400 });
+  }
+
+  return NextResponse.json(
+    {
+      data: body,
+      message: "Replace this create handler with your real implementation.",
+    },
+    { status: 201 },
+  );
+}

package/bundles/nextjs-landing/app/api/health/route.ts

@@ -0,0 +1,8 @@
+import { NextResponse } from "next/server";
+
+export async function GET() {
+  return NextResponse.json({
+    status: "ok",
+    timestamp: new Date().toISOString(),
+  });
+}

package/bundles/nextjs-landing/app/global-error.tsx

@@ -0,0 +1,17 @@
+"use client";
+
+import * as Sentry from "@sentry/nextjs";
+import NextError from "next/error";
+import { useEffect } from "react";
+
+export default function GlobalError({ error }: { error: Error & { digest?: string } }) {
+  useEffect(() => {
+    Sentry.captureException(error);
+  }, [error]);
+
+  return (
+    <html>
+      <body><NextError statusCode={0} /></body>
+    </html>
+  );
+}

package/bundles/nextjs-landing/app/globals.css

@@ -0,0 +1,55 @@
+@import "tailwindcss";
+
+:root {
+  --background: 0 0% 100%;
+  --foreground: 222.2 84% 4.9%;
+  --card: 0 0% 100%;
+  --card-foreground: 222.2 84% 4.9%;
+  --popover: 0 0% 100%;
+  --popover-foreground: 222.2 84% 4.9%;
+  --primary: 221.2 83.2% 53.3%;
+  --primary-foreground: 210 40% 98%;
+  --secondary: 210 40% 96.1%;
+  --secondary-foreground: 222.2 47.4% 11.2%;
+  --muted: 210 40% 96.1%;
+  --muted-foreground: 215.4 16.3% 46.9%;
+  --accent: 210 40% 96.1%;
+  --accent-foreground: 222.2 47.4% 11.2%;
+  --destructive: 0 84.2% 60.2%;
+  --destructive-foreground: 210 40% 98%;
+  --border: 214.3 31.8% 91.4%;
+  --input: 214.3 31.8% 91.4%;
+  --ring: 221.2 83.2% 53.3%;
+  --radius: 0.5rem;
+}
+
+.dark {
+  --background: 222.2 84% 4.9%;
+  --foreground: 210 40% 98%;
+  --card: 222.2 84% 4.9%;
+  --card-foreground: 210 40% 98%;
+  --popover: 222.2 84% 4.9%;
+  --popover-foreground: 210 40% 98%;
+  --primary: 217.2 91.2% 59.8%;
+  --primary-foreground: 222.2 47.4% 11.2%;
+  --secondary: 217.2 32.6% 17.5%;
+  --secondary-foreground: 210 40% 98%;
+  --muted: 217.2 32.6% 17.5%;
+  --muted-foreground: 215 20.2% 65.1%;
+  --accent: 217.2 32.6% 17.5%;
+  --accent-foreground: 210 40% 98%;
+  --destructive: 0 62.8% 30.6%;
+  --destructive-foreground: 210 40% 98%;
+  --border: 217.2 32.6% 17.5%;
+  --input: 217.2 32.6% 17.5%;
+  --ring: 224.3 76.3% 48%;
+}
+
+* {
+  border-color: hsl(var(--border));
+}
+
+body {
+  background-color: hsl(var(--background));
+  color: hsl(var(--foreground));
+}

package/bundles/nextjs-landing/app/layout.tsx

@@ -0,0 +1,22 @@
+import type { Metadata } from "next";
+import { Inter } from "next/font/google";
+import "./globals.css";
+
+const inter = Inter({ subsets: ["latin"] });
+
+export const metadata: Metadata = {
+  title: "Landing Page Starter",
+  description: "Built with Lattice Project Builder",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body className={inter.className}>{children}</body>
+    </html>
+  );
+}

package/bundles/nextjs-landing/app/page.tsx

@@ -0,0 +1,42 @@
+export default function HomePage() {
+  return (
+    <main className="min-h-screen bg-gradient-to-b from-gray-50 to-white px-6 py-24 text-gray-900">
+      <div className="mx-auto flex max-w-5xl flex-col gap-12">
+        <section className="max-w-3xl space-y-6">
+          <span className="inline-flex rounded-full border border-blue-200 bg-blue-50 px-3 py-1 text-sm font-medium text-blue-700">
+            Lattice Project Builder
+          </span>
+          <div className="space-y-4">
+            <h1 className="text-4xl font-bold tracking-tight sm:text-5xl">
+              Landing Page Starter
+            </h1>
+            <p className="text-lg text-gray-600">
+              Your project scaffold is ready. Start with PROJECT_GUIDE.md, connect the services you selected, and use the generated AI guardrails to keep implementation aligned.
+            </p>
+          </div>
+        </section>
+
+        <section className="grid gap-6 md:grid-cols-3">
+          <div className="rounded-2xl border border-gray-200 bg-white p-6 shadow-sm">
+            <h2 className="text-lg font-semibold">Start Here</h2>
+            <p className="mt-3 text-sm text-gray-600">
+              Read PROJECT_GUIDE.md before making changes so the build stays aligned with the planned scope.
+            </p>
+          </div>
+          <div className="rounded-2xl border border-gray-200 bg-white p-6 shadow-sm">
+            <h2 className="text-lg font-semibold">Wire Services</h2>
+            <p className="mt-3 text-sm text-gray-600">
+              Review .env.example and docs/lattice/scaffold-support.md to finish any provider setup the scaffold did not wire automatically.
+            </p>
+          </div>
+          <div className="rounded-2xl border border-gray-200 bg-white p-6 shadow-sm">
+            <h2 className="text-lg font-semibold">Ship Safely</h2>
+            <p className="mt-3 text-sm text-gray-600">
+              Use the generated CI, tests, and assistant rules to verify work before you ship.
+            </p>
+          </div>
+        </section>
+      </div>
+    </main>
+  );
+}

package/bundles/nextjs-landing/components/ui/button.tsx

@@ -0,0 +1,39 @@
+import * as React from "react";
+import { cn } from "@/lib/utils";
+
+export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+  variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+  size?: "default" | "sm" | "lg" | "icon";
+}
+
+const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant = "default", size = "default", ...props }, ref) => {
+    return (
+      <button
+        className={cn(
+          "inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50",
+          {
+            "bg-primary text-primary-foreground hover:bg-primary/90": variant === "default",
+            "bg-destructive text-destructive-foreground hover:bg-destructive/90": variant === "destructive",
+            "border border-input bg-background hover:bg-accent hover:text-accent-foreground": variant === "outline",
+            "bg-secondary text-secondary-foreground hover:bg-secondary/80": variant === "secondary",
+            "hover:bg-accent hover:text-accent-foreground": variant === "ghost",
+            "text-primary underline-offset-4 hover:underline": variant === "link",
+          },
+          {
+            "h-10 px-4 py-2": size === "default",
+            "h-9 rounded-md px-3": size === "sm",
+            "h-11 rounded-md px-8": size === "lg",
+            "h-10 w-10": size === "icon",
+          },
+          className
+        )}
+        ref={ref}
+        {...props}
+      />
+    );
+  }
+);
+Button.displayName = "Button";
+
+export { Button };

package/bundles/nextjs-landing/components/ui/card.tsx

@@ -0,0 +1,53 @@
+import * as React from "react";
+import { cn } from "@/lib/utils";
+
+const Card = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      className={cn(
+        "rounded-lg border bg-card text-card-foreground shadow-sm",
+        className
+      )}
+      {...props}
+    />
+  )
+);
+Card.displayName = "Card";
+
+const CardHeader = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div ref={ref} className={cn("flex flex-col space-y-1.5 p-6", className)} {...props} />
+  )
+);
+CardHeader.displayName = "CardHeader";
+
+const CardTitle = React.forwardRef<HTMLParagraphElement, React.HTMLAttributes<HTMLHeadingElement>>(
+  ({ className, ...props }, ref) => (
+    <h3 ref={ref} className={cn("text-2xl font-semibold leading-none tracking-tight", className)} {...props} />
+  )
+);
+CardTitle.displayName = "CardTitle";
+
+const CardDescription = React.forwardRef<HTMLParagraphElement, React.HTMLAttributes<HTMLParagraphElement>>(
+  ({ className, ...props }, ref) => (
+    <p ref={ref} className={cn("text-sm text-muted-foreground", className)} {...props} />
+  )
+);
+CardDescription.displayName = "CardDescription";
+
+const CardContent = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div ref={ref} className={cn("p-6 pt-0", className)} {...props} />
+  )
+);
+CardContent.displayName = "CardContent";
+
+const CardFooter = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div ref={ref} className={cn("flex items-center p-6 pt-0", className)} {...props} />
+  )
+);
+CardFooter.displayName = "CardFooter";
+
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent };

package/bundles/nextjs-landing/components/ui/index.ts

@@ -0,0 +1,4 @@
+export { Button } from "./button";
+export { Input } from "./input";
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent } from "./card";
+export { Spinner } from "./spinner";

package/bundles/nextjs-landing/components/ui/input.tsx

@@ -0,0 +1,23 @@
+import * as React from "react";
+import { cn } from "@/lib/utils";
+
+export type InputProps = React.InputHTMLAttributes<HTMLInputElement>;
+
+const Input = React.forwardRef<HTMLInputElement, InputProps>(
+  ({ className, type, ...props }, ref) => {
+    return (
+      <input
+        type={type}
+        className={cn(
+          "flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm ring-offset-background file:border-0 file:bg-transparent file:text-sm file:font-medium placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50",
+          className
+        )}
+        ref={ref}
+        {...props}
+      />
+    );
+  }
+);
+Input.displayName = "Input";
+
+export { Input };

package/bundles/nextjs-landing/components/ui/spinner.tsx

@@ -0,0 +1,22 @@
+import { cn } from "@/lib/utils";
+
+interface SpinnerProps {
+  className?: string;
+  size?: "sm" | "default" | "lg";
+}
+
+export function Spinner({ className, size = "default" }: SpinnerProps) {
+  return (
+    <div
+      className={cn(
+        "animate-spin rounded-full border-2 border-current border-t-transparent",
+        {
+          "h-4 w-4": size === "sm",
+          "h-6 w-6": size === "default",
+          "h-8 w-8": size === "lg",
+        },
+        className
+      )}
+    />
+  );
+}

package/bundles/nextjs-landing/docs/LATTICE_RELEASE_WORKFLOW.md

@@ -0,0 +1,53 @@
+# Lattice Release Workflow
+
+This repository uses a portable feature-to-release contract. It coordinates work across Codex, Claude Code, GitHub Copilot, Cursor, and other tools without assuming that every provider has direct peer messaging.
+
+## Source of Truth
+
+- Policy: `.lattice/release-workflow.json`
+- Handoff schema: `.lattice/schemas/feature-handoff.schema.json`
+- Handoff template: `.lattice/templates/feature-handoff.json`
+- Feature procedure: `.agents/skills/lattice-feature-handoff/SKILL.md`
+- Release review procedure: `.agents/skills/lattice-release-manager/SKILL.md`
+- Mutable local state: `.lattice/runtime/` (Git-ignored)
+
+Stable instructions define roles and contracts. Live task IDs, production SHAs, deployment IDs, and provider state belong in current handoffs or ignored runtime state.
+
+## Workflow
+
+1. **Feature work** — A feature agent starts from an approved base in an isolated worktree, implements only the assigned scope, and runs proportionate checks.
+2. **Handoff** — The feature agent records exact base/head SHAs, diff scope, verification, operational impacts, risks, and approvals in the JSON handoff.
+3. **Release audit** — The Release Manager independently resolves the repository and reviews the exact candidate. The manager accepts for owner approval, requests rework, or blocks.
+4. **Candidate preparation** — A release candidate may be prepared only after its constituent handoffs pass review.
+5. **Owner approval** — Production promotion, migrations, provider/account writes, secret or environment changes, and destructive actions require explicit owner approval.
+6. **Deployment and live proof** — Deployment and live verification are separate states. A successful build or preview is not a production release.
+7. **Cleanup** — Feature worktrees and branches are cleaned only after the authorized candidate is proven live and rollback evidence is current.
+
+## Transport
+
+Use the narrowest available transport:
+
+1. A native task message when the environment exposes the capability and the exact destination is bound.
+2. The shared GitHub issue, pull request, or comment.
+3. The versioned handoff artifact, with its exact path surfaced to the owner.
+
+Never claim that a handoff was delivered unless the transport returned evidence. The message is notification; the handoff is the durable evidence.
+
+## Status Meanings
+
+- `READY_FOR_RELEASE`: ready for independent Release Manager review.
+- `NEEDS_REWORK`: a confirmed defect, failed gate, incomplete proof, or scope mismatch remains.
+- `BLOCKED`: lineage, authority, environment, or another prerequisite prevents safe progress.
+
+None of these statuses means merged, deployed, released, or live.
+
+## Provider Adapters
+
+- **Codex:** project custom agents in `.codex/agents/` plus the shared skills.
+- **Claude Code:** project subagents in `.claude/agents/`; the feature role requests worktree isolation.
+- **GitHub Copilot:** custom agents in `.github/agents/`; issues, pull requests, and comments are the portable control plane.
+- **Cursor:** shared `AGENTS.md`, `.cursor/rules.md`, and `.agents/skills/`. Native peer messaging is not required by this contract.
+
+## Secret and Data Boundary
+
+Do not put credentials, tokens, private keys, payment data, direct personal contact data, or secret values in a handoff. Name an environment variable or provider surface when needed; do not copy its value.

package/bundles/nextjs-landing/docs/rules/codex.md

@@ -0,0 +1,62 @@
+# Codex Rules
+
+Use this file with `AGENTS.md` when you open the project in Codex. `AGENTS.md` is the durable entrypoint; this file is the deeper workflow reference.
+
+## Stack
+
+- **Framework**: Next.js
+- **Language**: TypeScript (strict mode)
+- **Styling**: Tailwind CSS
+- **Testing**: Jest + React Testing Library
+
+## Operating Rules
+
+1. **Stay aligned with PROJECT_GUIDE.md** - implement what was planned before expanding scope
+2. **Prefer small diffs** - keep changes reviewable and localized
+3. **Check existing patterns first** - match the codebase before introducing new structure
+4. **Verify versions and APIs** - do not guess package behavior
+5. **Run verification before handoff** - lint, typecheck, test, build, and verify when available
+6. **Protect secrets** - never commit credentials, tokens, or private keys
+
+## Codex Surfaces
+
+- `AGENTS.md` is loaded before work begins. Keep it concise and repo-scoped.
+- `docs/rules/codex.md` is the full execution playbook.
+- `.agents/skills/lattice-verify/SKILL.md` is a portable Agent Skill for final verification and release checks.
+- `.mcp.json` contains disabled MCP examples. Enable only the tools the task needs and keep credentials in environment variables.
+- Use hooks or project config for mechanical enforcement; use skills for repeatable procedures.
+
+## Workflow
+
+1. Read `AGENTS.md` and `PROJECT_GUIDE.md`
+2. Identify the exact files you need to touch
+3. Keep implementation deterministic and production-ready
+4. Use the `lattice-verify` skill when asked to verify, ship, or prepare handoff
+5. Explain risky commands before running them
+6. Note assumptions or follow-ups in your final handoff
+
+## Verification Commands
+
+```bash
+npm run lint
+npm run typecheck
+npm run test
+npm run build
+npm run verify
+```
+
+## Related Files
+
+- `.cursor/rules.md` for shared project guardrails
+- `.cursor/rules/lattice-core.mdc` for current Cursor Agent rules
+- `.agents/skills/lattice-verify/SKILL.md` for portable verification workflow
+- `CLAUDE.md` for Claude Code compatibility
+- `.claude/rules/lattice-core.md` for Claude path-scoped code guidance
+- `.claude/settings.json` for Claude Code permissions and hooks
+
+## Hard Stops
+
+- Requirements conflict with `PROJECT_GUIDE.md`
+- A command would overwrite unrelated user work
+- Required environment variables are missing
+- You cannot verify an API or package behavior

package/bundles/nextjs-landing/eslint.config.mjs

@@ -0,0 +1,16 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  globalIgnores([
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/bundles/nextjs-landing/instrumentation-client.ts

@@ -0,0 +1,30 @@
+import * as Sentry from "@sentry/nextjs";
+import posthog from "posthog-js";
+
+if (process.env.NEXT_PUBLIC_SENTRY_DSN) {
+  Sentry.init({
+    dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
+    tracesSampleRate: process.env.NODE_ENV === "development" ? 1 : 0.1,
+    dataCollection: {
+      userInfo: false, cookies: false,
+      httpHeaders: { request: false, response: false }, urlQueryParams: false,
+      httpBodies: [], genAI: { inputs: false, outputs: false },
+      databaseQueryData: false, queues: false,
+      graphQL: { document: false, variables: false },
+    },
+    replaysSessionSampleRate: 0.1,
+    replaysOnErrorSampleRate: 1,
+    integrations: [Sentry.replayIntegration()],
+  });
+}
+
+if (process.env.NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN) {
+  posthog.init(process.env.NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN, {
+    api_host: process.env.NEXT_PUBLIC_POSTHOG_HOST || "https://us.i.posthog.com",
+    defaults: "2026-05-30",
+    capture_pageview: "history_change",
+    capture_pageleave: true,
+  });
+}
+
+export const onRouterTransitionStart = Sentry.captureRouterTransitionStart;

package/bundles/nextjs-landing/instrumentation.ts

@@ -0,0 +1,12 @@
+import * as Sentry from "@sentry/nextjs";
+
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
+    await import("./sentry.server.config");
+  }
+  if (process.env.NEXT_RUNTIME === "edge") {
+    await import("./sentry.edge.config");
+  }
+}
+
+export const onRequestError = Sentry.captureRequestError;

package/bundles/nextjs-landing/jest.config.mjs

@@ -0,0 +1,16 @@
+import nextJest from "next/jest.js";
+
+const createJestConfig = nextJest({
+  dir: "./",
+});
+
+const customJestConfig = {
+  maxWorkers: 2,
+  setupFilesAfterEnv: ["<rootDir>/jest.setup.js"],
+  testEnvironment: "jest-environment-jsdom",
+  moduleNameMapper: {
+    "^@/(.*)$": "<rootDir>/$1",
+  },
+};
+
+export default createJestConfig(customJestConfig);

package/bundles/nextjs-landing/jest.setup.js

@@ -0,0 +1 @@
+import "@testing-library/jest-dom";

package/bundles/nextjs-landing/lib/utils.ts

@@ -0,0 +1,6 @@
+import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/bundles/nextjs-landing/next-env.d.ts

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

package/bundles/nextjs-landing/next.config.ts

@@ -0,0 +1,15 @@
+import type { NextConfig } from "next";
+import { withSentryConfig } from "@sentry/nextjs/config";
+
+const nextConfig: NextConfig = {
+  agentRules: false,
+  experimental: { cpus: 4 },
+  turbopack: { root: process.cwd() },
+};
+
+export default withSentryConfig(nextConfig, {
+  org: process.env.SENTRY_ORG,
+  project: process.env.SENTRY_PROJECT,
+  authToken: process.env.SENTRY_AUTH_TOKEN,
+  silent: !process.env.CI,
+});