minutework 0.1.0

package/assets/templates/next-tenant-app/src/app/app/examples/runtime-commands/page.test.ts

@@ -0,0 +1,83 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const notFound = vi.fn(() => {
+  throw new Error("notFound");
+});
+const resolveAuthenticatedSession = vi.fn();
+
+vi.mock("next/navigation", () => ({
+  notFound,
+}));
+
+vi.mock("@/features/shell/components/private-app-shell", () => ({
+  PrivateAppShell: () => null,
+}));
+
+vi.mock("@/lib/platform/auth.server", () => ({
+  resolveAuthenticatedSession,
+}));
+
+vi.mock("@/lib/platform/endpoints.server", () => ({
+  platformAuthEndpoints: {
+    operatorConsole: "http://127.0.0.1:8000/ops/login/",
+  },
+}));
+
+vi.mock("@/lib/platform/env.server", () => ({
+  env: {
+    MW_TEMPLATE_APP_NAME: "MinuteWork Combined Starter",
+    MW_ENABLE_RUNTIME_COMMAND_EXAMPLE: false,
+  },
+}));
+
+describe("runtime commands example page", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.resetModules();
+  });
+
+  it("returns notFound before loading auth when the example is disabled", async () => {
+    const page = await import("./page");
+
+    await expect(page.default()).rejects.toThrow("notFound");
+    expect(notFound).toHaveBeenCalledTimes(1);
+    expect(resolveAuthenticatedSession).not.toHaveBeenCalled();
+  });
+
+  it("loads the private shell when the example is enabled", async () => {
+    vi.doMock("@/lib/platform/env.server", () => ({
+      env: {
+        MW_TEMPLATE_APP_NAME: "MinuteWork Combined Starter",
+        MW_ENABLE_RUNTIME_COMMAND_EXAMPLE: true,
+      },
+    }));
+    resolveAuthenticatedSession.mockResolvedValue({
+      authenticated: true,
+      user: {
+        id: "user-1",
+        username: "demo-user",
+        email: "demo@example.com",
+      },
+      active_tenant_id: "tenant-1",
+      active_tenant: {
+        tenant_id: "tenant-1",
+        tenant_slug: "alpha",
+        tenant_name: "Alpha",
+        role: "admin",
+      },
+      memberships: [
+        {
+          tenant_id: "tenant-1",
+          tenant_slug: "alpha",
+          tenant_name: "Alpha",
+          role: "admin",
+        },
+      ],
+    });
+
+    const page = await import("./page");
+
+    await expect(page.default()).resolves.toBeDefined();
+    expect(resolveAuthenticatedSession).toHaveBeenCalledTimes(1);
+  });
+});

package/assets/templates/next-tenant-app/src/app/app/examples/runtime-commands/page.tsx

@@ -0,0 +1,30 @@
+import { notFound } from "next/navigation";
+
+import { PrivateAppShell } from "@/features/shell/components/private-app-shell";
+import { resolveAuthenticatedSession } from "@/lib/platform/auth.server";
+import { platformAuthEndpoints } from "@/lib/platform/endpoints.server";
+import { env } from "@/lib/platform/env.server";
+
+export const metadata = {
+  title: "Runtime Commands Example",
+  description:
+    "Optional runtime command example inside the authenticated /app surface.",
+};
+
+export default async function RuntimeCommandsExamplePage() {
+  if (!env.MW_ENABLE_RUNTIME_COMMAND_EXAMPLE) {
+    notFound();
+  }
+
+  const session = await resolveAuthenticatedSession();
+
+  return (
+    <PrivateAppShell
+      initialSession={session}
+      appName={env.MW_TEMPLATE_APP_NAME}
+      operatorConsoleHref={platformAuthEndpoints.operatorConsole}
+      runtimeCommandExampleEnabled={env.MW_ENABLE_RUNTIME_COMMAND_EXAMPLE}
+      view="runtime-command-demo"
+    />
+  );
+}

package/assets/templates/next-tenant-app/src/app/app/layout.tsx

@@ -0,0 +1,20 @@
+import type { Metadata } from "next";
+import type { ReactNode } from "react";
+
+import { resolveAuthenticatedSession } from "@/lib/platform/auth.server";
+
+export const metadata: Metadata = {
+  robots: {
+    index: false,
+    follow: false,
+  },
+};
+
+export default async function AuthenticatedAppLayout({
+  children,
+}: {
+  children: ReactNode;
+}) {
+  await resolveAuthenticatedSession();
+  return children;
+}

package/assets/templates/next-tenant-app/src/app/app/page.test.ts

@@ -0,0 +1,62 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const resolveAuthenticatedSession = vi.fn();
+
+vi.mock("@/features/shell/components/private-app-shell", () => ({
+  PrivateAppShell: () => null,
+}));
+
+vi.mock("@/lib/platform/auth.server", () => ({
+  resolveAuthenticatedSession,
+}));
+
+vi.mock("@/lib/platform/endpoints.server", () => ({
+  platformAuthEndpoints: {
+    operatorConsole: "http://127.0.0.1:8000/ops/login/",
+  },
+}));
+
+vi.mock("@/lib/platform/env.server", () => ({
+  env: {
+    MW_TEMPLATE_APP_NAME: "MinuteWork Combined Starter",
+    MW_ENABLE_RUNTIME_COMMAND_EXAMPLE: false,
+  },
+}));
+
+describe("authenticated app home page", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.resetModules();
+  });
+
+  it("renders the private shell after the auth guard resolves", async () => {
+    resolveAuthenticatedSession.mockResolvedValue({
+      authenticated: true,
+      user: {
+        id: "user-1",
+        username: "demo-user",
+        email: "demo@example.com",
+      },
+      active_tenant_id: "tenant-1",
+      active_tenant: {
+        tenant_id: "tenant-1",
+        tenant_slug: "alpha",
+        tenant_name: "Alpha",
+        role: "admin",
+      },
+      memberships: [
+        {
+          tenant_id: "tenant-1",
+          tenant_slug: "alpha",
+          tenant_name: "Alpha",
+          role: "admin",
+        },
+      ],
+    });
+
+    const page = await import("./page");
+
+    await expect(page.default()).resolves.toBeDefined();
+    expect(resolveAuthenticatedSession).toHaveBeenCalledTimes(1);
+  });
+});

package/assets/templates/next-tenant-app/src/app/app/page.tsx

@@ -0,0 +1,24 @@
+import { PrivateAppShell } from "@/features/shell/components/private-app-shell";
+import { resolveAuthenticatedSession } from "@/lib/platform/auth.server";
+import { platformAuthEndpoints } from "@/lib/platform/endpoints.server";
+import { env } from "@/lib/platform/env.server";
+
+export const metadata = {
+  title: "Workspace",
+  description:
+    "Authenticated workspace surface for the combined MinuteWork starter.",
+};
+
+export default async function AppHomePage() {
+  const session = await resolveAuthenticatedSession();
+
+  return (
+    <PrivateAppShell
+      initialSession={session}
+      appName={env.MW_TEMPLATE_APP_NAME}
+      operatorConsoleHref={platformAuthEndpoints.operatorConsole}
+      runtimeCommandExampleEnabled={env.MW_ENABLE_RUNTIME_COMMAND_EXAMPLE}
+      view="dashboard"
+    />
+  );
+}

package/assets/templates/next-tenant-app/src/app/blog/[slug]/page.test.ts

@@ -0,0 +1,70 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const notFound = vi.fn(() => {
+  throw new Error("notFound");
+});
+const getEntry = vi.fn();
+const getSiteConfig = vi.fn();
+const listEntries = vi.fn();
+
+vi.mock("next/navigation", () => ({
+  notFound,
+}));
+
+vi.mock("@/features/public-shell/components/content-article", () => ({
+  ContentArticle: () => null,
+}));
+
+vi.mock("@/features/public-shell/components/public-site-shell", () => ({
+  PublicSiteShell: ({ children }: { children: unknown }) => children,
+}));
+
+vi.mock("@/lib/content/adapter.server", () => ({
+  getEntry,
+  getSiteConfig,
+  listEntries,
+}));
+
+describe("blog article page", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.resetModules();
+  });
+
+  it("returns notFound for unknown blog slugs", async () => {
+    getSiteConfig.mockResolvedValue({
+      collections: {
+        blog: {
+          title: "Starter Blog",
+          description: "Blog",
+        },
+      },
+      siteName: "MinuteWork Combined Starter",
+    });
+    getEntry.mockResolvedValue(null);
+
+    const page = await import("./page");
+
+    await expect(
+      page.default({
+        params: Promise.resolve({ slug: "missing-entry" }),
+      }),
+    ).rejects.toThrow("notFound");
+    expect(notFound).toHaveBeenCalledTimes(1);
+  });
+
+  it("derives static params from published blog entries", async () => {
+    listEntries.mockResolvedValue([
+      { slug: ["public-site-api-default"] },
+      { slug: ["launch-note"] },
+    ]);
+
+    const page = await import("./page");
+
+    await expect(page.generateStaticParams()).resolves.toEqual([
+      { slug: "public-site-api-default" },
+      { slug: "launch-note" },
+    ]);
+    expect(page.dynamicParams).toBe(false);
+  });
+});

package/assets/templates/next-tenant-app/src/app/blog/[slug]/page.tsx

@@ -0,0 +1,57 @@
+import { notFound } from "next/navigation";
+
+import { ContentArticle } from "@/features/public-shell/components/content-article";
+import { PublicSiteShell } from "@/features/public-shell/components/public-site-shell";
+import { getEntry, getSiteConfig, listEntries } from "@/lib/content/adapter.server";
+import { appRoutes } from "@/lib/app-routes";
+import { buildPublicMetadata } from "@/lib/public-site";
+
+type BlogArticlePageProps = {
+  params: Promise<{ slug: string }>;
+};
+
+export const dynamicParams = false;
+
+export async function generateStaticParams() {
+  return (await listEntries("blog")).map((entry) => ({
+    slug: entry.slug[0],
+  }));
+}
+
+export async function generateMetadata({ params }: BlogArticlePageProps) {
+  const [{ slug }, siteConfig] = await Promise.all([params, getSiteConfig()]);
+  const entry = await getEntry("blog", [slug]);
+
+  if (!entry) {
+    return buildPublicMetadata({
+      title: siteConfig.collections.blog.title,
+      description: siteConfig.collections.blog.description,
+      path: appRoutes.blogIndex,
+      siteName: siteConfig.siteName,
+    });
+  }
+
+  return buildPublicMetadata({
+    title: entry.seo.title,
+    description: entry.seo.description,
+    path: appRoutes.blogPost(entry.slug),
+    siteName: siteConfig.siteName,
+    type: "article",
+    publishedTime: entry.publishedAt,
+  });
+}
+
+export default async function BlogArticlePage({ params }: BlogArticlePageProps) {
+  const [{ slug }, siteConfig] = await Promise.all([params, getSiteConfig()]);
+  const entry = await getEntry("blog", [slug]);
+
+  if (!entry) {
+    notFound();
+  }
+
+  return (
+    <PublicSiteShell activeHref={appRoutes.blogIndex} siteConfig={siteConfig}>
+      <ContentArticle entry={entry} />
+    </PublicSiteShell>
+  );
+}

package/assets/templates/next-tenant-app/src/app/blog/page.test.ts

@@ -0,0 +1,42 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const getSiteConfig = vi.fn();
+const listEntries = vi.fn();
+
+vi.mock("@/features/public-shell/components/content-collection", () => ({
+  ContentCollection: () => null,
+}));
+
+vi.mock("@/features/public-shell/components/public-site-shell", () => ({
+  PublicSiteShell: ({ children }: { children: unknown }) => children,
+}));
+
+vi.mock("@/lib/content/adapter.server", () => ({
+  getSiteConfig,
+  listEntries,
+}));
+
+describe("blog index page", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.resetModules();
+  });
+
+  it("renders the public blog collection", async () => {
+    getSiteConfig.mockResolvedValue({
+      collections: {
+        blog: {
+          eyebrow: "Blog",
+          title: "Starter Blog",
+          description: "Combined starter notes.",
+        },
+      },
+    });
+    listEntries.mockResolvedValue([]);
+
+    const page = await import("./page");
+
+    await expect(page.default()).resolves.toBeDefined();
+    expect(listEntries).toHaveBeenCalledWith("blog");
+  });
+});

package/assets/templates/next-tenant-app/src/app/blog/page.tsx

@@ -0,0 +1,37 @@
+import { ContentCollection } from "@/features/public-shell/components/content-collection";
+import { PublicSiteShell } from "@/features/public-shell/components/public-site-shell";
+import { getSiteConfig, listEntries } from "@/lib/content/adapter.server";
+import { appRoutes } from "@/lib/app-routes";
+import { buildPublicMetadata } from "@/lib/public-site";
+
+export async function generateMetadata() {
+  const siteConfig = await getSiteConfig();
+  const collection = siteConfig.collections.blog;
+
+  return buildPublicMetadata({
+    title: collection.title,
+    description: collection.description,
+    path: appRoutes.blogIndex,
+    siteName: siteConfig.siteName,
+  });
+}
+
+export default async function BlogIndexPage() {
+  const [siteConfig, entries] = await Promise.all([
+    getSiteConfig(),
+    listEntries("blog"),
+  ]);
+  const collection = siteConfig.collections.blog;
+
+  return (
+    <PublicSiteShell activeHref={appRoutes.blogIndex} siteConfig={siteConfig}>
+      <ContentCollection
+        description={collection.description}
+        entries={entries}
+        eyebrow={collection.eyebrow}
+        kind="blog"
+        title={collection.title}
+      />
+    </PublicSiteShell>
+  );
+}

package/assets/templates/next-tenant-app/src/app/docs/[...slug]/page.test.ts

@@ -0,0 +1,70 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const notFound = vi.fn(() => {
+  throw new Error("notFound");
+});
+const getEntry = vi.fn();
+const getSiteConfig = vi.fn();
+const listEntries = vi.fn();
+
+vi.mock("next/navigation", () => ({
+  notFound,
+}));
+
+vi.mock("@/features/public-shell/components/content-article", () => ({
+  ContentArticle: () => null,
+}));
+
+vi.mock("@/features/public-shell/components/public-site-shell", () => ({
+  PublicSiteShell: ({ children }: { children: unknown }) => children,
+}));
+
+vi.mock("@/lib/content/adapter.server", () => ({
+  getEntry,
+  getSiteConfig,
+  listEntries,
+}));
+
+describe("docs article page", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.resetModules();
+  });
+
+  it("returns notFound for unknown docs slugs", async () => {
+    getSiteConfig.mockResolvedValue({
+      collections: {
+        docs: {
+          title: "Starter Docs",
+          description: "Docs",
+        },
+      },
+      siteName: "MinuteWork Combined Starter",
+    });
+    getEntry.mockResolvedValue(null);
+
+    const page = await import("./page");
+
+    await expect(
+      page.default({
+        params: Promise.resolve({ slug: ["missing-entry"] }),
+      }),
+    ).rejects.toThrow("notFound");
+    expect(notFound).toHaveBeenCalledTimes(1);
+  });
+
+  it("derives static params from published docs entries", async () => {
+    listEntries.mockResolvedValue([
+      { slug: ["guides", "public-site-content"] },
+      { slug: ["reference", "api"] },
+    ]);
+
+    const page = await import("./page");
+
+    await expect(page.generateStaticParams()).resolves.toEqual([
+      { slug: ["guides", "public-site-content"] },
+      { slug: ["reference", "api"] },
+    ]);
+    expect(page.dynamicParams).toBe(false);
+  });
+});

package/assets/templates/next-tenant-app/src/app/docs/[...slug]/page.tsx

@@ -0,0 +1,55 @@
+import { notFound } from "next/navigation";
+
+import { ContentArticle } from "@/features/public-shell/components/content-article";
+import { PublicSiteShell } from "@/features/public-shell/components/public-site-shell";
+import { getEntry, getSiteConfig, listEntries } from "@/lib/content/adapter.server";
+import { appRoutes } from "@/lib/app-routes";
+import { buildPublicMetadata } from "@/lib/public-site";
+
+type DocsArticlePageProps = {
+  params: Promise<{ slug: string[] }>;
+};
+
+export const dynamicParams = false;
+
+export async function generateStaticParams() {
+  return (await listEntries("docs")).map((entry) => ({
+    slug: entry.slug,
+  }));
+}
+
+export async function generateMetadata({ params }: DocsArticlePageProps) {
+  const [{ slug }, siteConfig] = await Promise.all([params, getSiteConfig()]);
+  const entry = await getEntry("docs", slug);
+
+  if (!entry) {
+    return buildPublicMetadata({
+      title: siteConfig.collections.docs.title,
+      description: siteConfig.collections.docs.description,
+      path: appRoutes.docsIndex,
+      siteName: siteConfig.siteName,
+    });
+  }
+
+  return buildPublicMetadata({
+    title: entry.seo.title,
+    description: entry.seo.description,
+    path: appRoutes.docsPage(entry.slug),
+    siteName: siteConfig.siteName,
+  });
+}
+
+export default async function DocsArticlePage({ params }: DocsArticlePageProps) {
+  const [{ slug }, siteConfig] = await Promise.all([params, getSiteConfig()]);
+  const entry = await getEntry("docs", slug);
+
+  if (!entry) {
+    notFound();
+  }
+
+  return (
+    <PublicSiteShell activeHref={appRoutes.docsIndex} siteConfig={siteConfig}>
+      <ContentArticle entry={entry} />
+    </PublicSiteShell>
+  );
+}

package/assets/templates/next-tenant-app/src/app/docs/page.test.ts

@@ -0,0 +1,42 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const getSiteConfig = vi.fn();
+const listEntries = vi.fn();
+
+vi.mock("@/features/public-shell/components/content-collection", () => ({
+  ContentCollection: () => null,
+}));
+
+vi.mock("@/features/public-shell/components/public-site-shell", () => ({
+  PublicSiteShell: ({ children }: { children: unknown }) => children,
+}));
+
+vi.mock("@/lib/content/adapter.server", () => ({
+  getSiteConfig,
+  listEntries,
+}));
+
+describe("docs index page", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.resetModules();
+  });
+
+  it("renders the public docs collection", async () => {
+    getSiteConfig.mockResolvedValue({
+      collections: {
+        docs: {
+          eyebrow: "Docs",
+          title: "Starter Docs",
+          description: "Route content through the adapter seam.",
+        },
+      },
+    });
+    listEntries.mockResolvedValue([]);
+
+    const page = await import("./page");
+
+    await expect(page.default()).resolves.toBeDefined();
+    expect(listEntries).toHaveBeenCalledWith("docs");
+  });
+});

package/assets/templates/next-tenant-app/src/app/docs/page.tsx

@@ -0,0 +1,37 @@
+import { ContentCollection } from "@/features/public-shell/components/content-collection";
+import { PublicSiteShell } from "@/features/public-shell/components/public-site-shell";
+import { getSiteConfig, listEntries } from "@/lib/content/adapter.server";
+import { appRoutes } from "@/lib/app-routes";
+import { buildPublicMetadata } from "@/lib/public-site";
+
+export async function generateMetadata() {
+  const siteConfig = await getSiteConfig();
+  const collection = siteConfig.collections.docs;
+
+  return buildPublicMetadata({
+    title: collection.title,
+    description: collection.description,
+    path: appRoutes.docsIndex,
+    siteName: siteConfig.siteName,
+  });
+}
+
+export default async function DocsIndexPage() {
+  const [siteConfig, entries] = await Promise.all([
+    getSiteConfig(),
+    listEntries("docs"),
+  ]);
+  const collection = siteConfig.collections.docs;
+
+  return (
+    <PublicSiteShell activeHref={appRoutes.docsIndex} siteConfig={siteConfig}>
+      <ContentCollection
+        description={collection.description}
+        entries={entries}
+        eyebrow={collection.eyebrow}
+        kind="docs"
+        title={collection.title}
+      />
+    </PublicSiteShell>
+  );
+}