camelmind 0.1.0

package/template/scripts/build-search-index.ts

@@ -0,0 +1,90 @@
+/**
+ * Generates public/search-index.json for offline builds.
+ * Run before `next build` when OFFLINE_MODE=true.
+ *
+ * Usage: npx tsx scripts/build-search-index.ts
+ */
+
+import fs from "fs"
+import path from "path"
+import matter from "gray-matter"
+
+const ROOT = path.resolve(process.cwd())
+const NAV_FILE = path.join(ROOT, "nav", "nav.yml")
+const OUT_FILE = path.join(ROOT, "public", "search-index.json")
+
+// Minimal YAML parser for our nav structure (avoids pulling in the full Next.js lib graph)
+import yaml from "js-yaml"
+
+type NavChild = { label: string; slug: string; roles?: string[]; children?: NavChild[] }
+type NavEntry = { label: string; slug: string; file?: string; roles?: string[]; section?: NavChild[] }
+type NavGroup = { label: string; dropdown?: boolean; items?: NavEntry[] }
+
+function collectEntries(nav: (NavEntry | NavGroup)[], group?: string): Array<{ slug: string; file: string; roles: string[]; group: string; section?: string }> {
+  const out: Array<{ slug: string; file: string; roles: string[]; group: string; section?: string }> = []
+
+  for (const item of nav) {
+    if ("items" in item && item.items) {
+      // NavGroup
+      for (const entry of item.items) {
+        if (entry.file) {
+          out.push({ slug: entry.slug, file: entry.file, roles: entry.roles ?? [], group: item.label })
+        }
+        for (const section of entry.section ?? []) {
+          if ((section as NavEntry).file) {
+            out.push({ slug: section.slug, file: (section as NavEntry).file!, roles: section.roles ?? [], group: item.label, section: entry.label })
+          }
+          for (const child of section.children ?? []) {
+            if ((child as NavEntry).file) {
+              out.push({ slug: child.slug, file: (child as NavEntry).file!, roles: child.roles ?? [], group: item.label, section: section.label })
+            }
+          }
+        }
+      }
+    } else {
+      const entry = item as NavEntry
+      if (entry.file) {
+        out.push({ slug: entry.slug, file: entry.file, roles: entry.roles ?? [], group: group ?? "" })
+      }
+    }
+  }
+
+  return out
+}
+
+function stripMdx(source: string): string {
+  return source
+    .replace(/<[^>]+>/g, " ")
+    .replace(/[#*`>|]/g, " ")
+    .replace(/\s+/g, " ")
+    .trim()
+}
+
+async function main() {
+  const raw = fs.readFileSync(NAV_FILE, "utf-8")
+  const nav = (yaml.load(raw) as { nav: (NavEntry | NavGroup)[] }).nav
+
+  const entries = collectEntries(nav)
+  const index = []
+
+  for (const entry of entries) {
+    const filePath = path.join(ROOT, entry.file)
+    if (!fs.existsSync(filePath)) continue
+    const { data: frontmatter, content } = matter(fs.readFileSync(filePath, "utf-8"))
+
+    index.push({
+      slug: entry.slug,
+      title: frontmatter.title ?? "",
+      description: frontmatter.description ?? "",
+      body: stripMdx(content),
+      group: entry.group,
+      section: entry.section,
+      roles: entry.roles,
+    })
+  }
+
+  fs.writeFileSync(OUT_FILE, JSON.stringify(index, null, 2))
+  console.log(`search-index.json written — ${index.length} docs`)
+}
+
+main().catch((e) => { console.error(e); process.exit(1) })

package/template/scripts/generate-master-pdf.ts

@@ -0,0 +1,260 @@
+/**
+ * Assembles per-page PDFs into a single master PDF with:
+ *   - Cover page (title, subtitle, version, date)
+ *   - Table of contents with page numbers
+ *   - All doc pages in nav order
+ *   - PDF bookmarks (outline) matching nav structure
+ *
+ * Usage:
+ *   npx tsx scripts/generate-master-pdf.ts [--version v2.0] [--pages .pdf-pages] [--out offline-builds]
+ */
+
+import { PDFDocument, StandardFonts, rgb, PDFPage } from "pdf-lib"
+import fs from "fs"
+import path from "path"
+
+const ROOT = path.resolve(process.cwd())
+
+const VERSION = process.argv.find((a) => a.startsWith("--version="))?.split("=")[1] ?? "v2.0"
+const PAGES_DIR = process.argv.find((a) => a.startsWith("--pages="))?.split("=")[1]
+  ? path.resolve(process.argv.find((a) => a.startsWith("--pages="))!.split("=")[1])
+  : path.join(ROOT, ".pdf-pages")
+const OUT_DIR = process.argv.find((a) => a.startsWith("--out="))?.split("=")[1]
+  ? path.resolve(process.argv.find((a) => a.startsWith("--out="))!.split("=")[1])
+  : path.join(ROOT, "offline-builds")
+
+type ManifestEntry = { slug: string; title: string; group: string; section?: string; file: string }
+
+// ── Colors ──────────────────────────────────────────────────────────────────
+const DARK = rgb(0.067, 0.094, 0.153)   // #111827
+const MID  = rgb(0.42, 0.447, 0.502)    // #6b7280
+const LIGHT = rgb(0.97, 0.97, 0.97)     // #f7f7f7
+const WHITE = rgb(1, 1, 1)
+const ACCENT = rgb(0.067, 0.094, 0.153) // same dark for simplicity
+
+// Letter page dimensions (points)
+const PW = 612
+const PH = 792
+const MARGIN = 64
+
+// ── Cover page ───────────────────────────────────────────────────────────────
+async function buildCoverPage(doc: PDFDocument): Promise<PDFPage> {
+  const page = doc.addPage([PW, PH])
+  const boldFont = await doc.embedFont(StandardFonts.HelveticaBold)
+  const regularFont = await doc.embedFont(StandardFonts.Helvetica)
+
+  // Dark background block (top 55% of page)
+  page.drawRectangle({ x: 0, y: PH * 0.45, width: PW, height: PH * 0.55, color: DARK })
+
+  // Thin accent line
+  page.drawRectangle({ x: MARGIN, y: PH * 0.45 - 2, width: PW - MARGIN * 2, height: 2, color: rgb(0.3, 0.35, 0.45) })
+
+  // "SECOND FRONT SYSTEMS" label
+  page.drawText("SECOND FRONT SYSTEMS", {
+    x: MARGIN,
+    y: PH * 0.45 + 180,
+    size: 9,
+    font: regularFont,
+    color: rgb(0.6, 0.65, 0.75),
+    characterSpacing: 2,
+  })
+
+  // Main title
+  page.drawText("Game Warden", {
+    x: MARGIN,
+    y: PH * 0.45 + 130,
+    size: 42,
+    font: boldFont,
+    color: WHITE,
+  })
+  page.drawText("Help Center", {
+    x: MARGIN,
+    y: PH * 0.45 + 78,
+    size: 42,
+    font: boldFont,
+    color: WHITE,
+  })
+
+  // Version + date below the dark block
+  const dateStr = new Date().toLocaleDateString("en-US", { year: "numeric", month: "long", day: "numeric" })
+  page.drawText(`Documentation — ${VERSION}`, {
+    x: MARGIN,
+    y: PH * 0.45 - 40,
+    size: 13,
+    font: boldFont,
+    color: DARK,
+  })
+  page.drawText(`Generated ${dateStr}`, {
+    x: MARGIN,
+    y: PH * 0.45 - 62,
+    size: 10,
+    font: regularFont,
+    color: MID,
+  })
+
+  // Footer bar
+  page.drawRectangle({ x: 0, y: 0, width: PW, height: 36, color: LIGHT })
+  page.drawText("game warden help center · secondfront.com", {
+    x: MARGIN,
+    y: 12,
+    size: 8,
+    font: regularFont,
+    color: MID,
+    characterSpacing: 0.5,
+  })
+  page.drawText("CONFIDENTIAL — FOR AUTHORIZED USERS ONLY", {
+    x: PW - MARGIN - 220,
+    y: 12,
+    size: 8,
+    font: regularFont,
+    color: MID,
+  })
+
+  return page
+}
+
+// ── TOC page ─────────────────────────────────────────────────────────────────
+async function buildTocPage(
+  doc: PDFDocument,
+  entries: Array<{ title: string; group: string; section?: string; pageNum: number }>
+): Promise<void> {
+  const boldFont = await doc.embedFont(StandardFonts.HelveticaBold)
+  const regularFont = await doc.embedFont(StandardFonts.Helvetica)
+
+  let page = doc.addPage([PW, PH])
+  let y = PH - MARGIN
+
+  const drawPageHeader = (p: PDFPage) => {
+    p.drawText("TABLE OF CONTENTS", {
+      x: MARGIN, y: PH - MARGIN + 10, size: 8, font: regularFont, color: MID, characterSpacing: 1.5
+    })
+    p.drawLine({ start: { x: MARGIN, y: PH - MARGIN - 4 }, end: { x: PW - MARGIN, y: PH - MARGIN - 4 }, thickness: 0.5, color: rgb(0.85, 0.85, 0.85) })
+  }
+
+  drawPageHeader(page)
+  y -= 30
+
+  // Title
+  page.drawText("Contents", { x: MARGIN, y, size: 24, font: boldFont, color: DARK })
+  y -= 40
+
+  let lastGroup = ""
+
+  for (const entry of entries) {
+    // New page if needed
+    if (y < MARGIN + 30) {
+      page = doc.addPage([PW, PH])
+      drawPageHeader(page)
+      y = PH - MARGIN - 30
+    }
+
+    // Group header
+    if (entry.group !== lastGroup) {
+      if (lastGroup !== "") y -= 6
+      page.drawText(entry.group.toUpperCase(), {
+        x: MARGIN, y, size: 7.5, font: boldFont, color: MID, characterSpacing: 1,
+      })
+      y -= 18
+      lastGroup = entry.group
+    }
+
+    // Indent for section children
+    const indent = entry.section ? 16 : 0
+    const titleStr = entry.title
+    const pageStr = String(entry.pageNum)
+    const titleSize = entry.section ? 9 : 10
+    const titleFont = entry.section ? regularFont : boldFont
+    const titleColor = entry.section ? MID : DARK
+
+    // Dot leader
+    const titleWidth = titleFont.widthOfTextAtSize(titleStr, titleSize)
+    const pageWidth = regularFont.widthOfTextAtSize(pageStr, 9)
+    const leaderStart = MARGIN + indent + titleWidth + 4
+    const leaderEnd = PW - MARGIN - pageWidth - 8
+    if (leaderEnd > leaderStart) {
+      page.drawText("· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · ·", {
+        x: leaderStart, y: y + 1, size: 7, font: regularFont, color: rgb(0.8, 0.8, 0.8),
+        maxWidth: leaderEnd - leaderStart,
+      })
+    }
+
+    page.drawText(titleStr, { x: MARGIN + indent, y, size: titleSize, font: titleFont, color: titleColor })
+    page.drawText(pageStr, { x: PW - MARGIN - pageWidth, y, size: 9, font: regularFont, color: MID })
+
+    y -= entry.section ? 15 : 17
+  }
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+  const manifestPath = path.join(PAGES_DIR, "manifest.json")
+  if (!fs.existsSync(manifestPath)) {
+    console.error(`✗ manifest.json not found in ${PAGES_DIR}. Run generate-pdfs.ts first.`)
+    process.exit(1)
+  }
+
+  const manifest: ManifestEntry[] = JSON.parse(fs.readFileSync(manifestPath, "utf-8"))
+  console.log(`▶ Assembling master PDF from ${manifest.length} pages (version ${VERSION})`)
+
+  // ── Pass 1: merge all content pages to count page numbers ──────────────────
+  const masterDoc = await PDFDocument.create()
+
+  // Reserve slots: cover (1 page) + TOC (we'll insert after knowing size)
+  // First collect all content pages so we can calculate TOC page numbers
+  const contentPages: Array<{ entry: ManifestEntry; startPage: number; pageCount: number }> = []
+
+  // Page offset: 1 cover + estimated TOC pages (we'll finalize after)
+  const TOC_PAGES = 2 // estimate; adjust if content overflows
+
+  let contentPageOffset = 1 + TOC_PAGES // cover + toc
+  const pageDocs: PDFDocument[] = []
+
+  for (const entry of manifest) {
+    if (!fs.existsSync(entry.file)) {
+      console.warn(`  ⚠ Missing: ${entry.file}`)
+      continue
+    }
+    const bytes = fs.readFileSync(entry.file)
+    const srcDoc = await PDFDocument.load(bytes)
+    const count = srcDoc.getPageCount()
+    contentPages.push({ entry, startPage: contentPageOffset, pageCount: count })
+    pageDocs.push(srcDoc)
+    contentPageOffset += count
+  }
+
+  // ── Build cover ────────────────────────────────────────────────────────────
+  await buildCoverPage(masterDoc)
+
+  // ── Build TOC ──────────────────────────────────────────────────────────────
+  const tocEntries = contentPages.map((cp) => ({
+    title: cp.entry.title,
+    group: cp.entry.group,
+    section: cp.entry.section,
+    pageNum: cp.startPage,
+  }))
+  await buildTocPage(masterDoc, tocEntries)
+
+  // ── Copy content pages ─────────────────────────────────────────────────────
+  for (let i = 0; i < pageDocs.length; i++) {
+    const srcDoc = pageDocs[i]
+    const indices = srcDoc.getPageIndices()
+    const copied = await masterDoc.copyPages(srcDoc, indices)
+    copied.forEach((p) => masterDoc.addPage(p))
+    console.log(`  ✓ ${manifest[i]?.title ?? "??"} (${srcDoc.getPageCount()}pp)`)
+  }
+
+  // ── Add bookmarks ──────────────────────────────────────────────────────────
+  // pdf-lib outline support is limited; we add top-level group markers
+  // (full nested outline requires low-level PDF manipulation — skipped for now)
+
+  // ── Write output ───────────────────────────────────────────────────────────
+  fs.mkdirSync(OUT_DIR, { recursive: true })
+  const outFile = path.join(OUT_DIR, `Game-Warden-Help-Center-${VERSION}.pdf`)
+  const pdfBytes = await masterDoc.save()
+  fs.writeFileSync(outFile, pdfBytes)
+
+  const sizeMb = (pdfBytes.length / 1024 / 1024).toFixed(1)
+  console.log(`\n✓ Master PDF: ${outFile} (${sizeMb} MB, ${masterDoc.getPageCount()} pages)`)
+}
+
+main().catch((e) => { console.error(e); process.exit(1) })

package/template/scripts/generate-pdfs.ts

@@ -0,0 +1,185 @@
+/**
+ * Generates one PDF per doc page using Playwright headless print.
+ * Pages are captured from the live Next.js dev server (port 3000).
+ *
+ * Usage:
+ *   npx tsx scripts/generate-pdfs.ts [--port 3000] [--out .pdf-pages]
+ *
+ * Outputs: .pdf-pages/<slug-flattened>.pdf  (temp dir, consumed by generate-master-pdf.ts)
+ */
+
+import { chromium } from "playwright"
+import { SignJWT } from "jose"
+import fs from "fs"
+import path from "path"
+import yaml from "js-yaml"
+
+const ROOT = path.resolve(process.cwd())
+const NAV_FILE = path.join(ROOT, "nav", "nav.yml")
+
+const PORT = parseInt(process.argv.find((a) => a.startsWith("--port="))?.split("=")[1] ?? "3000")
+const OUT_DIR = process.argv.find((a) => a.startsWith("--out="))?.split("=")[1]
+  ? path.resolve(process.argv.find((a) => a.startsWith("--out="))!.split("=")[1])
+  : path.join(ROOT, ".pdf-pages")
+
+const CONCURRENCY = 4
+const BASE_URL = `http://localhost:${PORT}`
+
+type NavChild = { label: string; slug: string; roles?: string[]; children?: NavChild[] }
+type NavEntry = { label: string; slug: string; file?: string; roles?: string[]; section?: NavChild[] }
+type NavGroup = { label: string; dropdown?: boolean; items?: NavEntry[] }
+
+type PageEntry = { slug: string; title: string; group: string; section?: string }
+
+function collectPages(nav: (NavEntry | NavGroup)[]): PageEntry[] {
+  const pages: PageEntry[] = []
+
+  for (const item of nav) {
+    if ("items" in item && item.items) {
+      for (const entry of item.items) {
+        if (entry.slug && entry.file) {
+          pages.push({ slug: entry.slug, title: entry.label, group: item.label })
+        }
+        for (const section of entry.section ?? []) {
+          if ((section as NavEntry).file) {
+            pages.push({ slug: section.slug, title: section.label, group: item.label, section: entry.label })
+          }
+          for (const child of section.children ?? []) {
+            if ((child as NavEntry).file) {
+              pages.push({ slug: child.slug, title: child.label, group: item.label, section: section.label })
+            }
+          }
+        }
+      }
+    }
+  }
+
+  return pages
+}
+
+function slugToFilename(slug: string): string {
+  return slug.replace(/^\//, "").replace(/\//g, "__") + ".pdf"
+}
+
+type Cookie = Awaited<ReturnType<import("playwright").BrowserContext["cookies"]>>[number]
+
+async function generatePage(
+  browser: import("playwright").Browser,
+  page: PageEntry,
+  outDir: string,
+  cookies: Cookie[]
+): Promise<{ page: PageEntry; file: string } | null> {
+  const url = `${BASE_URL}${page.slug}`
+  const outFile = path.join(outDir, slugToFilename(page.slug))
+
+  const ctx = await browser.newContext()
+  await ctx.addCookies(cookies)
+  const pw = await ctx.newPage()
+
+  try {
+    await pw.goto(url, { waitUntil: "networkidle", timeout: 30000 })
+    await pw.waitForSelector("article", { timeout: 10000 })
+
+    // Force-open all <details> elements so their content is captured
+    // Also release height/overflow constraints that would clip content in print
+    await pw.evaluate(() => {
+      document.querySelectorAll("details").forEach((d) => { d.open = true })
+
+      // Show print-only elements by removing the Tailwind 'hidden' class
+      document.querySelectorAll<HTMLElement>('[data-print="show"]').forEach((el) => {
+        el.classList.remove("hidden")
+      })
+
+      // Release Tailwind h-screen / overflow-hidden / overflow-y-auto layout
+      const style = document.createElement("style")
+      style.textContent = `
+        html, body, .h-screen, .h-full { height: auto !important; min-height: 0 !important; }
+        .overflow-hidden, .overflow-y-auto, .overflow-x-hidden { overflow: visible !important; }
+        .flex-1 { flex: none !important; height: auto !important; }
+        nav, aside, [data-print="hide"] { display: none !important; }
+      `
+      document.head.appendChild(style)
+    })
+
+    await pw.pdf({
+      path: outFile,
+      format: "Letter",
+      printBackground: true,
+      margin: { top: "18mm", right: "16mm", bottom: "18mm", left: "16mm" },
+      displayHeaderFooter: true,
+      headerTemplate: `
+        <div style="width:100%;font-family:system-ui,sans-serif;font-size:8px;color:#6b7280;display:flex;justify-content:space-between;padding:0 16mm;">
+          <span>${page.group}${page.section ? " › " + page.section : ""}</span>
+          <span style="color:#111827;font-weight:600;">Game Warden Help Center</span>
+        </div>`,
+      footerTemplate: `
+        <div style="width:100%;font-family:system-ui,sans-serif;font-size:8px;color:#6b7280;display:flex;justify-content:space-between;padding:0 16mm;">
+          <span>${page.title}</span>
+          <span></span>
+        </div>`,
+    })
+
+    return { page, file: outFile }
+  } catch (e) {
+    console.warn(`  ⚠ Failed: ${url} — ${(e as Error).message}`)
+    return null
+  } finally {
+    await ctx.close()
+  }
+}
+
+async function main() {
+  // Read nav
+  const raw = fs.readFileSync(NAV_FILE, "utf-8")
+  const nav = (yaml.load(raw) as { nav: (NavEntry | NavGroup)[] }).nav
+  const pages = collectPages(nav)
+
+  console.log(`▶ Generating PDFs for ${pages.length} pages → ${OUT_DIR}`)
+  fs.mkdirSync(OUT_DIR, { recursive: true })
+
+  // Check server is up
+  try {
+    const res = await fetch(`${BASE_URL}/home`)
+    if (!res.ok) throw new Error(`HTTP ${res.status}`)
+  } catch {
+    console.error(`✗ Dev server not reachable at ${BASE_URL}. Run: npm run dev`)
+    process.exit(1)
+  }
+
+  const browser = await chromium.launch()
+
+  // Sign in via the dev login UI so we get a real session cookie
+  const authCtx = await browser.newContext()
+  const authPage = await authCtx.newPage()
+  await authPage.goto(`${BASE_URL}/login`, { waitUntil: "networkidle" })
+  // Click "Staff (vendor + admin)" persona button
+  await authPage.click("button:has-text('Staff')")
+  await authPage.waitForURL(/\/home|\/getting-started/, { timeout: 10000 })
+  const cookies = await authCtx.cookies()
+  await authPage.close()
+  await authCtx.close()
+
+  const results: Array<{ page: PageEntry; file: string }> = []
+
+  // Process in batches of CONCURRENCY
+  for (let i = 0; i < pages.length; i += CONCURRENCY) {
+    const batch = pages.slice(i, i + CONCURRENCY)
+    const done = await Promise.all(batch.map((p) => generatePage(browser, p, OUT_DIR, cookies)))
+    for (const r of done) {
+      if (r) {
+        results.push(r)
+        console.log(`  ✓ ${r.page.slug}`)
+      }
+    }
+  }
+
+  await browser.close()
+
+  // Write manifest — ordered list for master PDF assembly
+  const manifest = results.map((r) => ({ slug: r.page.slug, title: r.page.title, group: r.page.group, section: r.page.section, file: r.file }))
+  fs.writeFileSync(path.join(OUT_DIR, "manifest.json"), JSON.stringify(manifest, null, 2))
+
+  console.log(`✓ ${results.length}/${pages.length} pages generated`)
+}
+
+main().catch((e) => { console.error(e); process.exit(1) })

package/template/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules", "scripts"]
+}

package/template/versions.yml

@@ -0,0 +1,5 @@
+versions:
+  - id: "latest"
+    label: "Latest"
+    stable: true
+    nav: nav/nav.yml