@stackwright-pro/launch-stackwright-pro 0.4.0-alpha.4 → 0.4.0-alpha.41

package/README.md

@@ -120,17 +120,24 @@ for architecture details, auth deep-dives, and deployment guides.
 
 ## Starting the Otter Raft
 
-The otter raft is a Python state machine — **not** a code-puppy interactive session. Start it with:
+The otter raft runs in two modes:
+
+### Interactive Mode (Default)
 
 ```bash
-uvx stackwright-pro-raft
+python -m stackwright_pro.raft.cli_adapter foreman --spawn
 ```
 
-For local development (before PyPI publish):
+This spawns code-puppy with the foreman system prompt. The foreman:
+
+- Asks questions about your project via TUI
+- Coordinates specialist otters (brand, theme, api, auth, page)
+- Uses certificate pinning to ensure only approved otters are invoked
+
+### Phases Mode (Debugging)
 
 ```bash
-pip install -e ./python[tui]
-python -m stackwright_pro.raft.cli foreman
+python -m stackwright_pro.raft.cli_adapter foreman --phases
 ```
 
-The raft uses a Rich terminal UI for all user interaction and calls code-puppy as a one-shot subprocess for creative LLM tasks. It reads otter configs from `node_modules/@stackwright-pro/otters/`. Note: `server` starts the passive Clarification Protocol HTTP listener (for agentic/remote use). `cli foreman` is the interactive entry point that runs the full otter orchestration pipeline.
+Executes phases sequentially via the Python state machine. Useful for debugging.

package/dist/index.js

@@ -31,9 +31,12 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@stackwright-pro/launch-stackwright-pro",
-      version: "0.4.0-alpha.3",
+      version: "0.4.0-alpha.41",
       description: "Launch a new Stackwright Pro project with OpenAPI integration, auth, and the otter raft",
       license: "MIT",
+      publishConfig: {
+        access: "public"
+      },
       repository: {
         type: "git",
         url: "https://github.com/Per-Aspera-LLC/stackwright-pro"
@@ -54,14 +57,20 @@ var require_package = __commonJS({
         "launch-stackwright-pro": "dist/index.js"
       },
       scripts: {
-        build: "tsup",
+        build: "node ../../scripts/sync-versions.mjs && tsup",
+        "sync-versions": "node ../../scripts/sync-versions.mjs",
         dev: "tsup --watch",
         test: "vitest run",
         "test:coverage": "vitest run --coverage"
       },
       dependencies: {
-        "@stackwright-pro/scaffold-hooks": "workspace:*",
-        "@stackwright/cli": "^0.7.0",
+        "@stackwright-pro/auth": "workspace:*",
+        "@stackwright-pro/auth-nextjs": "workspace:*",
+        "@stackwright-pro/mcp": "workspace:*",
+        "@stackwright-pro/openapi": "workspace:*",
+        "@stackwright-pro/otters": "workspace:*",
+        "@stackwright-pro/scaffold-hooks": "latest",
+        "@stackwright/cli": "^0.7.1-alpha.0",
         "@stackwright/scaffold-core": "^0.1.0",
         chalk: "^5.6.2",
         commander: "^14.0.3",
@@ -91,6 +100,28 @@ var import_child_process = require("child_process");
 var import_cli = require("@stackwright/cli");
 var import_scaffold_core = require("@stackwright/scaffold-core");
 var import_scaffold_hooks = require("@stackwright-pro/scaffold-hooks");
+
+// src/generated/workspace-versions.ts
+var PRO_VERSIONS = {
+  "@stackwright-pro/auth": "0.2.0-alpha.1",
+  "@stackwright-pro/auth-nextjs": "0.2.0-alpha.1",
+  "@stackwright-pro/display-components": "0.2.0-alpha.2",
+  "@stackwright-pro/mcp": "0.2.0-alpha.23",
+  "@stackwright-pro/openapi": "0.3.0-alpha.5",
+  "@stackwright-pro/otters": "1.0.0-alpha.24",
+  "@stackwright-pro/pulse": "0.3.0-alpha.2"
+};
+var OSS_VERSIONS = {
+  "@stackwright/build-scripts": "^0.4.0",
+  "@stackwright/core": "^0.7.0",
+  "@stackwright/icons": "^0.3.0",
+  "@stackwright/mcp": "^0.2.0",
+  "@stackwright/nextjs": "^0.3.1",
+  "@stackwright/otters": "^0.2.0",
+  "@stackwright/ui-shadcn": "^0.1.0"
+};
+
+// src/index.ts
 (0, import_scaffold_hooks.registerProScaffoldHooks)();
 var { version } = require_package();
 async function copyProTemplate(templateName, destPath) {
@@ -100,7 +131,7 @@ async function copyProTemplate(templateName, destPath) {
 async function addAuthToStackwrightYml(targetDir) {
   const ymlPath = import_path.default.join(targetDir, "stackwright.yml");
   const content = await import_fs_extra.default.readFile(ymlPath, "utf-8");
-  const config = import_js_yaml.default.load(content);
+  const config = import_js_yaml.default.load(content, { schema: import_js_yaml.default.CORE_SCHEMA });
   config.auth = {
     type: "pki",
     profile: "dod_cac",
@@ -115,10 +146,50 @@ async function addAuthToStackwrightYml(targetDir) {
   };
   await import_fs_extra.default.writeFile(ymlPath, import_js_yaml.default.dump(config, { lineWidth: 120 }));
 }
+async function addProDepsToPackageJson(targetDir) {
+  const pkgPath = import_path.default.join(targetDir, "package.json");
+  const content = await import_fs_extra.default.readFile(pkgPath, "utf-8");
+  const pkg = JSON.parse(content);
+  const dependencies = pkg.dependencies || {};
+  const devDependencies = pkg.devDependencies || {};
+  const scripts = pkg.scripts || {};
+  for (const [pkgName, pinnedVersion] of Object.entries(OSS_VERSIONS)) {
+    if (dependencies[pkgName] === "workspace:*") {
+      dependencies[pkgName] = pinnedVersion;
+    }
+    if (devDependencies[pkgName] === "workspace:*") {
+      devDependencies[pkgName] = pinnedVersion;
+    }
+  }
+  Object.assign(dependencies, {
+    "@stackwright-pro/display-components": PRO_VERSIONS["@stackwright-pro/display-components"],
+    "@stackwright-pro/mcp": PRO_VERSIONS["@stackwright-pro/mcp"],
+    "@stackwright-pro/otters": PRO_VERSIONS["@stackwright-pro/otters"],
+    "@stackwright-pro/openapi": PRO_VERSIONS["@stackwright-pro/openapi"],
+    "@stackwright-pro/auth": PRO_VERSIONS["@stackwright-pro/auth"],
+    "@stackwright-pro/auth-nextjs": PRO_VERSIONS["@stackwright-pro/auth-nextjs"],
+    "@stackwright-pro/pulse": PRO_VERSIONS["@stackwright-pro/pulse"],
+    zod: "^3.23.0"
+  });
+  Object.assign(devDependencies, {
+    "@stoplight/prism-cli": "^5.14.2"
+  });
+  Object.assign(scripts, {
+    "dev:admin": "MOCK_USER=admin next dev",
+    "dev:analyst": "MOCK_USER=analyst next dev",
+    "dev:viewer": "MOCK_USER=viewer next dev",
+    prebuild: "node scripts/prebuild.js",
+    predev: "node scripts/prebuild.js"
+  });
+  pkg.dependencies = dependencies;
+  pkg.devDependencies = devDependencies;
+  pkg.scripts = scripts;
+  await import_fs_extra.default.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+}
 async function addIntegrationToStackwrightYml(targetDir, specName, specFilename, mockUrl) {
   const ymlPath = import_path.default.join(targetDir, "stackwright.yml");
   const content = await import_fs_extra.default.readFile(ymlPath, "utf-8");
-  const config = import_js_yaml.default.load(content);
+  const config = import_js_yaml.default.load(content, { schema: import_js_yaml.default.CORE_SCHEMA });
   const integration = {
     type: "openapi",
     name: specName,
@@ -216,12 +287,10 @@ Your project includes **SIX specialized AI agents** in \`node_modules/@stackwrig
 **Start the otter raft:**
 
 \`\`\`bash
-uvx stackwright-pro-raft
+npx @stackwright-pro/raft
 \`\`\`
 
-> **Local dev (before PyPI publish):** \`python -m stackwright_pro.raft.cli foreman\`
-
-The raft is a Python state machine with a Rich terminal UI \u2014 it asks questions about your brand, auth, and data preferences, then coordinates specialist otters to build your app. All user interaction happens in the terminal; code-puppy is called as a one-shot subprocess for creative tasks only.
+The raft verifies otter integrity, writes project context, and spawns code-puppy in foreman mode. The foreman asks questions about your brand, auth, and data preferences, then coordinates specialist otters to build your app. All state lives in \`.stackwright/\` \u2014 interrupt and resume anytime.
 
 **Example session prompt:**
 
@@ -404,6 +473,8 @@ async function launch(targetDir, options) {
   console.log(import_chalk.default.cyan.bold("\n\u{1F6A2} Launching Stackwright Pro...\n"));
   const scaffoldOpts = {
     name: options.name || dirName,
+    standalone: true,
+    // prevents `workspace:*` refs when CLI runs inside the Pro monorepo
     ...options.title !== void 0 && { title: options.title },
     ...options.theme !== void 0 && { theme: options.theme },
     ...options.force !== void 0 && { force: options.force },
@@ -411,13 +482,41 @@ async function launch(targetDir, options) {
   };
   await (0, import_cli.scaffold)(targetDir, scaffoldOpts);
   console.log(import_chalk.default.green("\u2705 Base project scaffolded (hooks added Pro deps + MCP config)"));
+  await addProDepsToPackageJson(targetDir);
+  console.log(import_chalk.default.green("\u{1F9A6} Pro packages added to package.json"));
+  const verifyPkg = JSON.parse(
+    await import_fs_extra.default.readFile(import_path.default.join(targetDir, "package.json"), "utf-8")
+  );
+  const proDepCount = Object.keys(verifyPkg.dependencies || {}).filter(
+    (k) => k.startsWith("@stackwright-pro")
+  ).length;
+  console.log(import_chalk.default.dim(`  \u2192 package.json verified: ${proDepCount} @stackwright-pro/* deps ready`));
   console.log(import_chalk.default.cyan("\n\u{1F4E6} Installing dependencies (this takes a moment)..."));
   if (!options.skipInstall) {
     try {
-      (0, import_child_process.execSync)("pnpm install", { cwd: targetDir, stdio: "inherit", timeout: 12e4 });
+      (0, import_child_process.execSync)("pnpm install --ignore-workspace", {
+        cwd: targetDir,
+        stdio: "inherit",
+        timeout: 12e4
+      });
       console.log(import_chalk.default.green("\u2705 Dependencies installed"));
-    } catch {
-      console.warn(import_chalk.default.yellow("\u26A0\uFE0F  pnpm install failed \u2014 run it manually: pnpm install"));
+    } catch (err) {
+      const isTimeout = err instanceof Error && (err.message.includes("ETIMEDOUT") || err.message.includes("timeout"));
+      console.error(
+        import_chalk.default.red("\n\u274C pnpm install failed. Auth and Pro packages are NOT installed.")
+      );
+      console.error(
+        import_chalk.default.red("   Your project is in an incomplete state \u2014 do NOT run or deploy it.")
+      );
+      if (isTimeout) {
+        console.error(
+          import_chalk.default.yellow("   The install timed out (>2 min). Check your network connection.")
+        );
+      }
+      console.error(
+        import_chalk.default.yellow(`   Fix the error above, then run: pnpm install --ignore-workspace`)
+      );
+      process.exit(1);
     }
   } else {
     console.log(import_chalk.default.dim("\u2139\uFE0F  Skipping install (--skip-install). Run: pnpm install"));
@@ -484,11 +583,29 @@ async function launch(targetDir, options) {
   });
   await import_fs_extra.default.writeFile(import_path.default.join(targetDir, "README.md"), readmeContent);
   console.log(import_chalk.default.green("\u{1F4C4} README.md created"));
+  const initContext = {
+    projectRoot: targetDir,
+    projectName: options.name || dirName,
+    generatedBy: "launch-stackwright-pro",
+    version: "1.0"
+  };
+  if (specInfo) {
+    initContext.specPath = `specs/${specInfo.specFilename}`;
+    initContext.specName = specInfo.derivedName;
+  }
+  initContext.theme = options.theme || "corporate";
+  const stackwrightDir = import_path.default.join(targetDir, ".stackwright");
+  await import_fs_extra.default.ensureDir(stackwrightDir);
+  await import_fs_extra.default.writeFile(
+    import_path.default.join(stackwrightDir, "init-context.json"),
+    JSON.stringify(initContext, null, 2) + "\n",
+    "utf-8"
+  );
   const relDir = import_path.default.relative(process.cwd(), targetDir) || ".";
   console.log(import_chalk.default.cyan.bold("\n\u{1F389} All set! Here's what to do next:\n"));
   console.log(import_chalk.default.white(`  1. cd ${relDir}`));
-  console.log(import_chalk.default.white("  2. uvx stackwright-pro-raft"));
-  console.log(import_chalk.default.dim("     (local dev: python -m stackwright_pro.raft.cli foreman)"));
+  console.log(import_chalk.default.white("  2. npx @stackwright-pro/raft"));
+  console.log(import_chalk.default.dim("     (use --verbose for troubleshooting)"));
   if (specInfo) {
     console.log(import_chalk.default.cyan(`
 \u{1F4E1} Your API spec was copied to specs/${specInfo.specFilename}`));

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@stackwright-pro/launch-stackwright-pro\",\n  \"version\": \"0.4.0-alpha.3\",\n  \"description\": \"Launch a new Stackwright Pro project with OpenAPI integration, auth, and the otter raft\",\n  \"license\": \"MIT\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/Per-Aspera-LLC/stackwright-pro\"\n  },\n  \"keywords\": [\n    \"stackwright\",\n    \"stackwright-pro\",\n    \"scaffolding\",\n    \"openapi\",\n    \"government\",\n    \"hackathon\"\n  ],\n  \"files\": [\n    \"dist\",\n    \"templates\"\n  ],\n  \"bin\": {\n    \"launch-stackwright-pro\": \"dist/index.js\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"test\": \"vitest run\",\n    \"test:coverage\": \"vitest run --coverage\"\n  },\n  \"dependencies\": {\n    \"@stackwright-pro/scaffold-hooks\": \"workspace:*\",\n    \"@stackwright/cli\": \"^0.7.0\",\n    \"@stackwright/scaffold-core\": \"^0.1.0\",\n    \"chalk\": \"^5.6.2\",\n    \"commander\": \"^14.0.3\",\n    \"fs-extra\": \"^11.3\",\n    \"js-yaml\": \"^4.1.0\"\n  },\n  \"devDependencies\": {\n    \"@types/fs-extra\": \"^11.0\",\n    \"@types/js-yaml\": \"^4.0.9\",\n    \"@types/node\": \"^24.0.0\",\n    \"typescript\": \"^5.0\",\n    \"tsup\": \"^8.5\",\n    \"vitest\": \"^4.0.18\"\n  }\n}\n","import { Command } from 'commander';\nimport path from 'path';\nimport os from 'os';\nimport fs from 'fs-extra';\nimport chalk from 'chalk';\nimport yaml from 'js-yaml';\nimport { execSync } from 'child_process';\n\nimport { scaffold, ScaffoldOptions } from '@stackwright/cli';\nimport { runScaffoldHooks } from '@stackwright/scaffold-core';\nimport { registerProScaffoldHooks } from '@stackwright-pro/scaffold-hooks';\n// Register Pro hooks (adds deps, MCP config, etc.)\n// Must be called before scaffold() to ensure hooks run in the CLI's scaffold-core context\nregisterProScaffoldHooks();\n\nconst { version } = require('../package.json') as { version: string };\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ninterface LaunchProOptions {\n  name?: string;\n  title?: string;\n  theme?: string;\n  force?: boolean;\n  skipOtters?: boolean;\n  skipInstall?: boolean;\n  yes?: boolean;\n  spec?: string;\n  specName?: string;\n  mock?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Template copying (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nasync function copyProTemplate(templateName: string, destPath: string): Promise<void> {\n  const src = path.resolve(__dirname, '..', 'templates', 'pro', templateName);\n  await fs.copy(src, destPath);\n}\n\n// ---------------------------------------------------------------------------\n// Auth config (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nasync function addAuthToStackwrightYml(targetDir: string): Promise<void> {\n  const ymlPath = path.join(targetDir, 'stackwright.yml');\n  const content = await fs.readFile(ymlPath, 'utf-8');\n  const config = yaml.load(content) as Record<string, unknown>;\n\n  config.auth = {\n    type: 'pki',\n    profile: 'dod_cac',\n    source: 'gateway_headers',\n    roles: [\n      { name: 'ADMIN', permissions: ['*'] },\n      { name: 'ANALYST', permissions: ['data:read', 'data:write'] },\n      { name: 'VIEWER', permissions: ['data:read'] },\n    ],\n    protected_routes: [{ path: '/*', roles: ['VIEWER', 'ANALYST', 'ADMIN'] }],\n    public_routes: ['/', '/getting-started'],\n  };\n\n  await fs.writeFile(ymlPath, yaml.dump(config, { lineWidth: 120 }));\n}\n\nasync function addIntegrationToStackwrightYml(\n  targetDir: string,\n  specName: string,\n  specFilename: string,\n  mockUrl?: string\n): Promise<void> {\n  const ymlPath = path.join(targetDir, 'stackwright.yml');\n  const content = await fs.readFile(ymlPath, 'utf-8');\n  const config = yaml.load(content) as Record<string, unknown>;\n\n  const integration: Record<string, unknown> = {\n    type: 'openapi',\n    name: specName,\n    spec: `./specs/${specFilename}`,\n    collections: [],\n  };\n\n  if (mockUrl) {\n    integration.mockUrl = mockUrl;\n  }\n\n  config.integrations = [integration];\n\n  await fs.writeFile(ymlPath, yaml.dump(config, { lineWidth: 120 }));\n}\n\n// ---------------------------------------------------------------------------\n// Spec handling (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nasync function handleSpec(\n  targetDir: string,\n  specPath: string,\n  specName?: string\n): Promise<{ specFilename: string; derivedName: string }> {\n  const resolvedSpec = path.resolve(specPath);\n\n  if (!fs.existsSync(resolvedSpec)) {\n    throw new Error(`Spec file not found: ${resolvedSpec}`);\n  }\n\n  const specFilename = path.basename(resolvedSpec);\n  const derivedName = specName || path.basename(specFilename, path.extname(specFilename));\n\n  const specsDir = path.join(targetDir, 'specs');\n  await fs.ensureDir(specsDir);\n  await fs.copy(resolvedSpec, path.join(specsDir, specFilename));\n\n  return { specFilename, derivedName };\n}\n\n// ---------------------------------------------------------------------------\n// README generator (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nfunction generateReadme(options: {\n  projectName: string;\n  hasSpec: boolean;\n  specName?: string;\n  specFilename?: string;\n  hasOtters: boolean;\n  hasMock: boolean;\n}): string {\n  const { projectName, hasSpec, specName, specFilename, hasOtters, hasMock } = options;\n\n  // Build API Integration section if spec is present\n  const apiIntegrationSection = hasSpec\n    ? `## 📡 API Integration\n\nYour OpenAPI spec was copied to \\`specs/${specFilename}\\` and wired up in \\`stackwright.yml\\`.\n\n**What gets generated:**\n\n\\`\\`\\`typescript\n// src/generated/${specName}/schemas.ts\nexport const EquipmentSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  status: z.enum(['operational', 'maintenance', 'retired']),\n  // ... Zod validation for runtime safety\n});\n\n// src/generated/${specName}/types.ts\nexport type Equipment = z.infer<typeof EquipmentSchema>;\n\n// src/generated/${specName}/client.ts\nexport class ${specName!.charAt(0).toUpperCase() + specName!.slice(1)}Client {\n  async getEquipment(id: string): Promise<Equipment> {\n    // Auto-wired with auth, validation, error handling\n  }\n}\n\\`\\`\\`\n\n**How it works:**\n1. The \\`predev\\` script in \\`package.json\\` runs \\`prebuild.js\\` before every \\`pnpm dev\\`\n2. Prebuild reads your spec and generates type-safe code\n3. You import and use it:\n\n\\`\\`\\`typescript\nimport { ${specName!.charAt(0).toUpperCase() + specName!.slice(1)}Client } from '@/generated/${specName}/client';\nimport type { Equipment } from '@/generated/${specName}/types';\n\nconst client = new ${specName!.charAt(0).toUpperCase() + specName!.slice(1)}Client();\nconst gear: Equipment = await client.getEquipment('123');\n\\`\\`\\`\n\nNo manual typing. No drift. No runtime surprises.\n\n`\n    : '';\n\n  // Build mock server section if enabled\n  const mockSection = hasMock\n    ? `## 🎭 Mock Server\n\nPrism mock server is configured to serve your API at **http://localhost:4010**.\n\n\\`\\`\\`bash\npnpm dev:mock    # Starts Prism + Next.js together\n\\`\\`\\`\n\nThis starts:\n1. Prism mock server on port 4010 (serves your OpenAPI spec)\n2. Next.js dev server on port 3000\n\nThe generated API client is automatically configured to use the mock server.\n\n`\n    : '';\n\n  // Build AI Agents section if otters are present\n  const aiAgentsSection = hasOtters\n    ? `## 🦦 AI Agents (The Otter Raft)\n\nYour project includes **SIX specialized AI agents** in \\`node_modules/@stackwright-pro/otters/\\`:\n\n- \\`stackwright-pro-foreman-otter\\` - Master coordinator that orchestrates all specialist otters\n- \\`stackwright-pro-api-otter\\` - Discovers entities from OpenAPI specs\n- \\`stackwright-pro-auth-otter\\` - Configures CAC/OIDC auth, RBAC rules, and audit middleware\n- \\`stackwright-pro-data-otter\\` - Configures endpoint filters & ISR revalidation\n- \\`stackwright-pro-page-otter\\` - Generates pages auto-wired with data, theme, and auth\n- \\`stackwright-pro-dashboard-otter\\` - Builds live data dashboards\n\n**Start the otter raft:**\n\n\\`\\`\\`bash\nuvx stackwright-pro-raft\n\\`\\`\\`\n\n> **Local dev (before PyPI publish):** \\`python -m stackwright_pro.raft.cli foreman\\`\n\nThe raft is a Python state machine with a Rich terminal UI — it asks questions about your brand, auth, and data preferences, then coordinates specialist otters to build your app. All user interaction happens in the terminal; code-puppy is called as a one-shot subprocess for creative tasks only.\n\n**Example session prompt:**\n\n\"Build me a logistics dashboard from our OpenAPI spec. Connect to /equipment and /supplies endpoints.\"\n\n`\n    : '';\n\n  return `# ${projectName}\n\nA Stackwright Pro application with role-based auth, OpenAPI integration, and intelligent AI agents.\n\n## 🚀 Quick Start\n\n\\`\\`\\`bash\n# Start development server\npnpm dev\n\n# Open your browser\nopen http://localhost:3000\n\\`\\`\\`\n\n## 👥 Role-Based Development\n\nStackwright Pro includes **mock authentication** for local development with three pre-configured roles:\n\n\\`\\`\\`bash\npnpm dev:admin     # Full permissions (*)\npnpm dev:analyst   # Read & write data\npnpm dev:viewer    # Read-only access\n\\`\\`\\`\n\n**How it works:**\n- Each script sets the \\`MOCK_USER\\` environment variable\n- \\`lib/mock-auth.ts\\` intercepts requests and injects the appropriate user context\n- Your pages & API routes respect the RBAC rules in \\`stackwright.yml\\`\n- No backend required for testing auth flows! 🎉\n\n**Pro tip:** Test your UI for all three roles to ensure proper permissions enforcement.\n\n${mockSection}## 📁 Project Structure\n\n\\`\\`\\`\n.\n├── pages/\n│   ├── _app.tsx               # Pro version with AuthProvider + shadcn\n│   ├── index.tsx              # Home page (auto-generated by Stackwright)\n│   ├── about/\n│   │   └── content.yml        # Page content in YAML\n│   └── ...\n├── lib/\n│   └── mock-auth.ts           # Dev-only auth mocking (no backend needed)\n├── scripts/\n│   └── prebuild.js            # Auto-generates code from OpenAPI specs\n├── specs/                     # OpenAPI spec files (if --spec was used)\n├── src/\n│   └── generated/             # Auto-generated types & clients\n│       └── {specName}/\n│           ├── schemas.ts     # Zod schemas for runtime validation\n│           ├── types.ts       # TypeScript types\n│           ├── client.ts      # API client with auth\n│           └── provider.ts    # CollectionProvider for Stackwright\n├── .stackwright/\n│   └── otters/                # AI agent configs (4 specialized otters)\n├── stackwright.yml            # Theme, auth, API integrations\n└── package.json\n\\`\\`\\`\n\n**Key Files:**\n- \\`pages/_app.tsx\\` - Wraps your app with \\`AuthProvider\\` for RBAC\n- \\`stackwright.yml\\` - Single source of truth for theme, auth roles, and API wiring\n- \\`lib/mock-auth.ts\\` - Mocks CAC/PIV headers locally so you can test auth flows\n- \\`scripts/prebuild.js\\` - Runs before dev/build to generate types from your OpenAPI spec\n\n## 📄 Adding Pages\n\nStackwright uses **YAML for content**, so you never touch JSX unless you want to.\n\n**Example:** Create \\`pages/about/content.yml\\`:\n\n\\`\\`\\`yaml\ntitle: About Us\ndescription: Learn more about our mission\n\nsections:\n  - type: main\n    heading: Who We Are\n    body: |\n      We build mission-critical logistics systems for the Marine Corps.\n\n  - type: feature_list\n    title: Our Capabilities\n    features:\n      - icon: Security\n        title: Zero Trust\n        description: PKI-based auth with CAC/PIV\n      - icon: Api\n        title: Real-time Data\n        description: OpenAPI-backed, Zod-validated\n\\`\\`\\`\n\nThat's it. Navigate to \\`/about\\` and it just works. No routing config, no React components.\n\n${apiIntegrationSection}## 🎨 Customizing Theme\n\nEdit \\`stackwright.yml\\` to change colors, fonts, spacing — applies everywhere instantly.\n\n\\`\\`\\`yaml\ntheme:\n  id: my-theme\n  name: My Custom Theme\n  colors:\n    primary: \"#C41E3A\"        # Marine Corps red\n    background: \"#FFFFFF\"\n    text: \"#1A1A1A\"\n    accent: \"#FFD700\"         # Gold\n  typography:\n    fontFamily: \"'Inter', sans-serif\"\n    h1Size: \"2.5rem\"\n  spacing:\n    unit: 8\n\\`\\`\\`\n\nNo CSS files. No theme provider boilerplate. Just YAML. Stackwright handles the rest.\n\n## 🔐 Auth Configuration\n\nStackwright Pro comes with **3 pre-configured roles** in \\`stackwright.yml\\`:\n\n\\`\\`\\`yaml\nauth:\n  roles:\n    - name: ADMIN\n      permissions: ['*']                        # Full access\n    - name: ANALYST  \n      permissions: ['data:read', 'data:write']  # Read/write data\n    - name: VIEWER\n      permissions: ['data:read']                # Read-only\n\\`\\`\\`\n\n**Gate content in your YAML:**\n\n\\`\\`\\`yaml\nsections:\n  - type: button\n    label: Delete Equipment\n    action: /api/equipment/delete\n    auth:\n      required_roles: [ADMIN]\n      fallback: hide              # Options: hide, disable, show_message\n\\`\\`\\`\n\nOnly admins see the button. Analysts and viewers? Button doesn't exist in the DOM.\n\n**Route protection:**\n\n\\`\\`\\`yaml\nauth:\n  protected_routes:\n    - path: /admin/*\n      roles: [ADMIN]\n    - path: /equipment/*  \n      roles: [ANALYST, ADMIN]\n  public_routes:\n    - /\n    - /about\n\\`\\`\\`\n\nNo middleware to write. No useAuth hooks to remember. RBAC is declarative.\n\n${aiAgentsSection}## 📚 Learn More\n\n- **Stackwright Docs:** [https://stackwright.dev](https://stackwright.dev)\n- **OSS Repo:** [https://github.com/Per-Aspera-LLC/stackwright](https://github.com/Per-Aspera-LLC/stackwright)\n- **Pro Repo:** [https://github.com/Per-Aspera-LLC/stackwright-pro](https://github.com/Per-Aspera-LLC/stackwright-pro)\n\n**Questions?** File an issue or ping us in the discussions. We're here to help you ship faster.\n`;\n}\n\n// ---------------------------------------------------------------------------\n// Main launch flow\n// ---------------------------------------------------------------------------\n\nasync function launch(targetDir: string, options: LaunchProOptions): Promise<void> {\n  const dirName = path.basename(targetDir);\n\n  console.log(chalk.cyan.bold('\\n🚢 Launching Stackwright Pro...\\n'));\n\n  // ------------------------------------------------------------------\n  // 1. Scaffold base OSS project via @stackwright/cli\n  //    Hooks auto-handle: Pro deps, MCP config, role-based scripts\n  // ------------------------------------------------------------------\n\n  const scaffoldOpts: ScaffoldOptions = {\n    name: options.name || dirName,\n    ...(options.title !== undefined && { title: options.title }),\n    ...(options.theme !== undefined && { theme: options.theme }),\n    ...(options.force !== undefined && { force: options.force }),\n    ...(options.yes !== undefined && { noInteractive: options.yes }),\n  };\n\n  await scaffold(targetDir, scaffoldOpts);\n  console.log(chalk.green('✅ Base project scaffolded (hooks added Pro deps + MCP config)'));\n\n  // ------------------------------------------------------------------\n  // 1b. Run pnpm install — citizen devs shouldn't need to know this step exists\n  // ------------------------------------------------------------------\n\n  console.log(chalk.cyan('\\n📦 Installing dependencies (this takes a moment)...'));\n  if (!options.skipInstall) {\n    try {\n      execSync('pnpm install', { cwd: targetDir, stdio: 'inherit', timeout: 120_000 });\n      console.log(chalk.green('✅ Dependencies installed'));\n    } catch {\n      console.warn(chalk.yellow('⚠️  pnpm install failed — run it manually: pnpm install'));\n    }\n  } else {\n    console.log(chalk.dim('ℹ️  Skipping install (--skip-install). Run: pnpm install'));\n  }\n\n  // Fire postInstall hooks now that install has run\n  const dependencyMode: 'workspace' | 'standalone' = 'standalone';\n  await runScaffoldHooks('postInstall', {\n    targetDir,\n    projectName: options.name || path.basename(targetDir),\n    siteTitle: options.title || options.name || path.basename(targetDir),\n    themeId: options.theme || 'corporate',\n    packageJson: {},\n    dependencyMode,\n  });\n\n  // ------------------------------------------------------------------\n  // 2. Copy Pro templates (hooks can't handle these)\n  // ------------------------------------------------------------------\n\n  // Replace _app.tsx with Pro version (AuthProvider, shadcn, etc.)\n  await copyProTemplate('_app.tsx', path.join(targetDir, 'pages', '_app.tsx'));\n\n  // Add root content.yml for the home page\n  await copyProTemplate('content.yml', path.join(targetDir, 'pages', 'content.yml'));\n\n  // Replace next.config.js with Pro version (transpile pro pkgs)\n  await copyProTemplate('next.config.js', path.join(targetDir, 'next.config.js'));\n\n  // Add lib/mock-auth.ts\n  await fs.ensureDir(path.join(targetDir, 'lib'));\n  await copyProTemplate('mock-auth.ts', path.join(targetDir, 'lib', 'mock-auth.ts'));\n\n  // Add yaml.d.ts for TypeScript support\n  await copyProTemplate('yaml.d.ts', path.join(targetDir, 'yaml.d.ts'));\n\n  // Add scripts/prebuild.js\n  await fs.ensureDir(path.join(targetDir, 'scripts'));\n  await copyProTemplate('prebuild.js', path.join(targetDir, 'scripts', 'prebuild.js'));\n\n  console.log(chalk.green('🔐 Auth integration added (RBAC with 3 roles)'));\n\n  // ------------------------------------------------------------------\n  // 3. Add auth section to stackwright.yml\n  // ------------------------------------------------------------------\n\n  await addAuthToStackwrightYml(targetDir);\n\n  // ------------------------------------------------------------------\n  // 4. Handle --spec if provided\n  // ------------------------------------------------------------------\n\n  let specInfo: { specFilename: string; derivedName: string } | null = null;\n  const MOCK_URL = 'http://localhost:4010';\n\n  if (options.spec) {\n    specInfo = await handleSpec(targetDir, options.spec, options.specName);\n\n    // Pass mockUrl if --mock flag is set\n    await addIntegrationToStackwrightYml(\n      targetDir,\n      specInfo.derivedName,\n      specInfo.specFilename,\n      options.mock ? MOCK_URL : undefined\n    );\n    console.log(chalk.green('📡 OpenAPI integration wired up'));\n\n    if (options.mock) {\n      console.log(chalk.green('🎭 Prism mock server configured'));\n    }\n  } else if (options.mock) {\n    // --mock without --spec: use sample Petstore spec for demo\n    console.log(\n      chalk.yellow(\n        '⚠️  No spec provided with --mock. Using sample Petstore spec for demo. Replace with your API spec.'\n      )\n    );\n\n    const specsDir = path.join(targetDir, 'specs');\n    await fs.ensureDir(specsDir);\n    await copyProTemplate('petstore.yaml', path.join(specsDir, 'petstore.yaml'));\n\n    specInfo = { specFilename: 'petstore.yaml', derivedName: 'petstore' };\n\n    await addIntegrationToStackwrightYml(\n      targetDir,\n      specInfo.derivedName,\n      specInfo.specFilename,\n      MOCK_URL\n    );\n    console.log(chalk.green('📡 Sample Petstore spec wired up'));\n    console.log(chalk.green('🎭 Prism mock server configured'));\n  }\n\n  // ------------------------------------------------------------------\n  // 5. Generate README\n  // ------------------------------------------------------------------\n\n  const readmeContent = generateReadme({\n    projectName: options.name || dirName,\n    hasSpec: !!specInfo,\n    ...(specInfo?.derivedName !== undefined && { specName: specInfo.derivedName }),\n    ...(specInfo?.specFilename !== undefined && { specFilename: specInfo.specFilename }),\n    hasOtters: !options.skipOtters,\n    hasMock: !!options.mock,\n  });\n\n  await fs.writeFile(path.join(targetDir, 'README.md'), readmeContent);\n  console.log(chalk.green('📄 README.md created'));\n\n  // ------------------------------------------------------------------\n  // 6. Print next steps\n  // ------------------------------------------------------------------\n\n  const relDir = path.relative(process.cwd(), targetDir) || '.';\n\n  console.log(chalk.cyan.bold(\"\\n🎉 All set! Here's what to do next:\\n\"));\n  console.log(chalk.white(`  1. cd ${relDir}`));\n  console.log(chalk.white('  2. uvx stackwright-pro-raft'));\n  console.log(chalk.dim('     (local dev: python -m stackwright_pro.raft.cli foreman)'));\n\n  if (specInfo) {\n    console.log(chalk.cyan(`\\n📡 Your API spec was copied to specs/${specInfo.specFilename}`));\n    console.log(chalk.dim('   The prebuild will generate types & client on first `pnpm dev`.'));\n  }\n\n  if (options.mock) {\n    console.log(chalk.cyan('\\n🎭 Run with mock server:'));\n    console.log(chalk.white('   pnpm dev:mock  # Starts Prism + Next.js'));\n  }\n\n  if (!options.skipOtters) {\n    console.log(chalk.cyan.bold('\\n🦦 The otter raft is ready to build your site!'));\n    console.log(chalk.dim('   Run the command above to get started.\\n'));\n  }\n}\n\n// ---------------------------------------------------------------------------\n// CLI definition\n// ---------------------------------------------------------------------------\n\nasync function main(): Promise<void> {\n  const program = new Command();\n\n  program\n    .name('launch-stackwright-pro')\n    .description('🚢 Launch a new Stackwright Pro project with auth, OpenAPI, and the otter raft')\n    .version(version)\n    .argument('[directory]', 'Project directory', '.')\n    .option('--name <name>', 'Project name (used in package.json)')\n    .option('--title <title>', 'Site title shown in the app bar and browser tab')\n    .option('--theme <themeId>', 'Theme ID (e.g., corporate, creative, minimal)')\n    .option('--force', 'Launch even if the target directory is not empty')\n    .option('--skip-otters', 'Skip copying otter raft configs')\n    .option('-y, --yes', 'Skip all prompts, use defaults')\n    .option('--mock', 'Configure Prism mock server for API development (runs on port 4010)')\n    .option(\n      '--spec <path>',\n      'Path to an OpenAPI spec (YAML or JSON) — copies into project and wires up integration'\n    )\n    .option(\n      '--spec-name <name>',\n      'Name for the API integration (default: derived from spec filename)'\n    )\n    .option(\n      '--skip-install',\n      'Skip automatic pnpm install (useful in CI or when using a different package manager)'\n    )\n    .action(async (directory: string, options: LaunchProOptions) => {\n      const homeDir = os.homedir();\n      const targetDir = path.resolve(directory);\n\n      // Warn (don't block) when scaffolding outside home dir — unusual for a user-facing CLI\n      if (!targetDir.startsWith(homeDir + path.sep) && targetDir !== homeDir) {\n        console.warn(chalk.yellow(`⚠️  Scaffolding outside your home directory: ${targetDir}`));\n      }\n\n      await launch(targetDir, options);\n    });\n\n  await program.parseAsync(process.argv);\n}\n\nmain().catch((err: unknown) => {\n  console.error(chalk.red('\\n❌ Launch failed:'), err);\n  process.exit(1);\n});\n"],"mappings":"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","names":["exports","module","path","fs","yaml","chalk","os"]}
+{"version":3,"sources":["../package.json","../src/index.ts","../src/generated/workspace-versions.ts"],"sourcesContent":["{\n  \"name\": \"@stackwright-pro/launch-stackwright-pro\",\n  \"version\": \"0.4.0-alpha.41\",\n  \"description\": \"Launch a new Stackwright Pro project with OpenAPI integration, auth, and the otter raft\",\n  \"license\": \"MIT\",\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/Per-Aspera-LLC/stackwright-pro\"\n  },\n  \"keywords\": [\n    \"stackwright\",\n    \"stackwright-pro\",\n    \"scaffolding\",\n    \"openapi\",\n    \"government\",\n    \"hackathon\"\n  ],\n  \"files\": [\n    \"dist\",\n    \"templates\"\n  ],\n  \"bin\": {\n    \"launch-stackwright-pro\": \"dist/index.js\"\n  },\n  \"scripts\": {\n    \"build\": \"node ../../scripts/sync-versions.mjs && tsup\",\n    \"sync-versions\": \"node ../../scripts/sync-versions.mjs\",\n    \"dev\": \"tsup --watch\",\n    \"test\": \"vitest run\",\n    \"test:coverage\": \"vitest run --coverage\"\n  },\n  \"dependencies\": {\n    \"@stackwright-pro/auth\": \"workspace:*\",\n    \"@stackwright-pro/auth-nextjs\": \"workspace:*\",\n    \"@stackwright-pro/mcp\": \"workspace:*\",\n    \"@stackwright-pro/openapi\": \"workspace:*\",\n    \"@stackwright-pro/otters\": \"workspace:*\",\n    \"@stackwright-pro/scaffold-hooks\": \"latest\",\n    \"@stackwright/cli\": \"^0.7.1-alpha.0\",\n    \"@stackwright/scaffold-core\": \"^0.1.0\",\n    \"chalk\": \"^5.6.2\",\n    \"commander\": \"^14.0.3\",\n    \"fs-extra\": \"^11.3\",\n    \"js-yaml\": \"^4.1.0\"\n  },\n  \"devDependencies\": {\n    \"@types/fs-extra\": \"^11.0\",\n    \"@types/js-yaml\": \"^4.0.9\",\n    \"@types/node\": \"^24.0.0\",\n    \"typescript\": \"^5.0\",\n    \"tsup\": \"^8.5\",\n    \"vitest\": \"^4.0.18\"\n  }\n}\n","import { Command } from 'commander';\nimport path from 'path';\nimport os from 'os';\nimport fs from 'fs-extra';\nimport chalk from 'chalk';\nimport yaml from 'js-yaml';\nimport { execSync } from 'child_process';\n\nimport { scaffold, ScaffoldOptions } from '@stackwright/cli';\nimport { runScaffoldHooks } from '@stackwright/scaffold-core';\nimport { registerProScaffoldHooks } from '@stackwright-pro/scaffold-hooks';\nimport { PRO_VERSIONS, OSS_VERSIONS } from './generated/workspace-versions';\n// Register Pro hooks (adds deps, MCP config, etc.)\n// Must be called before scaffold() to ensure hooks run in the CLI's scaffold-core context\nregisterProScaffoldHooks();\n\nconst { version } = require('../package.json') as { version: string };\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ninterface LaunchProOptions {\n  name?: string;\n  title?: string;\n  theme?: string;\n  force?: boolean;\n  skipOtters?: boolean;\n  skipInstall?: boolean;\n  yes?: boolean;\n  spec?: string;\n  specName?: string;\n  mock?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Template copying (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nasync function copyProTemplate(templateName: string, destPath: string): Promise<void> {\n  const src = path.resolve(__dirname, '..', 'templates', 'pro', templateName);\n  await fs.copy(src, destPath);\n}\n\n// ---------------------------------------------------------------------------\n// Auth config (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nasync function addAuthToStackwrightYml(targetDir: string): Promise<void> {\n  const ymlPath = path.join(targetDir, 'stackwright.yml');\n  const content = await fs.readFile(ymlPath, 'utf-8');\n  const config = yaml.load(content, { schema: yaml.CORE_SCHEMA }) as Record<string, unknown>;\n\n  config.auth = {\n    type: 'pki',\n    profile: 'dod_cac',\n    source: 'gateway_headers',\n    roles: [\n      { name: 'ADMIN', permissions: ['*'] },\n      { name: 'ANALYST', permissions: ['data:read', 'data:write'] },\n      { name: 'VIEWER', permissions: ['data:read'] },\n    ],\n    protected_routes: [{ path: '/*', roles: ['VIEWER', 'ANALYST', 'ADMIN'] }],\n    public_routes: ['/', '/getting-started'],\n  };\n\n  await fs.writeFile(ymlPath, yaml.dump(config, { lineWidth: 120 }));\n}\n\nasync function addProDepsToPackageJson(targetDir: string): Promise<void> {\n  const pkgPath = path.join(targetDir, 'package.json');\n  const content = await fs.readFile(pkgPath, 'utf-8');\n  const pkg = JSON.parse(content) as Record<string, any>;\n\n  const dependencies = (pkg.dependencies as Record<string, string>) || {};\n  const devDependencies = (pkg.devDependencies as Record<string, string>) || {};\n  const scripts = (pkg.scripts as Record<string, string>) || {};\n\n  // Fix any workspace:* references that scaffold may have written\n  // (happens when running from inside a pnpm workspace)\n  for (const [pkgName, pinnedVersion] of Object.entries(OSS_VERSIONS)) {\n    if (dependencies[pkgName] === 'workspace:*') {\n      dependencies[pkgName] = pinnedVersion;\n    }\n    if (devDependencies[pkgName] === 'workspace:*') {\n      devDependencies[pkgName] = pinnedVersion;\n    }\n  }\n\n  // Pro runtime dependencies — exact versions from workspace at build time\n  Object.assign(dependencies, {\n    '@stackwright-pro/display-components': PRO_VERSIONS['@stackwright-pro/display-components'],\n    '@stackwright-pro/mcp': PRO_VERSIONS['@stackwright-pro/mcp'],\n    '@stackwright-pro/otters': PRO_VERSIONS['@stackwright-pro/otters'],\n    '@stackwright-pro/openapi': PRO_VERSIONS['@stackwright-pro/openapi'],\n    '@stackwright-pro/auth': PRO_VERSIONS['@stackwright-pro/auth'],\n    '@stackwright-pro/auth-nextjs': PRO_VERSIONS['@stackwright-pro/auth-nextjs'],\n    '@stackwright-pro/pulse': PRO_VERSIONS['@stackwright-pro/pulse'],\n    zod: '^3.23.0',\n  });\n\n  // Pro dev dependencies\n  Object.assign(devDependencies, {\n    '@stoplight/prism-cli': '^5.14.2',\n  });\n\n  // Role-based dev scripts\n  Object.assign(scripts, {\n    'dev:admin': 'MOCK_USER=admin next dev',\n    'dev:analyst': 'MOCK_USER=analyst next dev',\n    'dev:viewer': 'MOCK_USER=viewer next dev',\n    prebuild: 'node scripts/prebuild.js',\n    predev: 'node scripts/prebuild.js',\n  });\n\n  pkg.dependencies = dependencies;\n  pkg.devDependencies = devDependencies;\n  pkg.scripts = scripts;\n\n  await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\\n', 'utf-8');\n}\n\nasync function addIntegrationToStackwrightYml(\n  targetDir: string,\n  specName: string,\n  specFilename: string,\n  mockUrl?: string\n): Promise<void> {\n  const ymlPath = path.join(targetDir, 'stackwright.yml');\n  const content = await fs.readFile(ymlPath, 'utf-8');\n  const config = yaml.load(content, { schema: yaml.CORE_SCHEMA }) as Record<string, unknown>;\n\n  const integration: Record<string, unknown> = {\n    type: 'openapi',\n    name: specName,\n    spec: `./specs/${specFilename}`,\n    collections: [],\n  };\n\n  if (mockUrl) {\n    integration.mockUrl = mockUrl;\n  }\n\n  config.integrations = [integration];\n\n  await fs.writeFile(ymlPath, yaml.dump(config, { lineWidth: 120 }));\n}\n\n// ---------------------------------------------------------------------------\n// Spec handling (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nasync function handleSpec(\n  targetDir: string,\n  specPath: string,\n  specName?: string\n): Promise<{ specFilename: string; derivedName: string }> {\n  const resolvedSpec = path.resolve(specPath);\n\n  if (!fs.existsSync(resolvedSpec)) {\n    throw new Error(`Spec file not found: ${resolvedSpec}`);\n  }\n\n  const specFilename = path.basename(resolvedSpec);\n  const derivedName = specName || path.basename(specFilename, path.extname(specFilename));\n\n  const specsDir = path.join(targetDir, 'specs');\n  await fs.ensureDir(specsDir);\n  await fs.copy(resolvedSpec, path.join(specsDir, specFilename));\n\n  return { specFilename, derivedName };\n}\n\n// ---------------------------------------------------------------------------\n// README generator (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nfunction generateReadme(options: {\n  projectName: string;\n  hasSpec: boolean;\n  specName?: string;\n  specFilename?: string;\n  hasOtters: boolean;\n  hasMock: boolean;\n}): string {\n  const { projectName, hasSpec, specName, specFilename, hasOtters, hasMock } = options;\n\n  // Build API Integration section if spec is present\n  const apiIntegrationSection = hasSpec\n    ? `## 📡 API Integration\n\nYour OpenAPI spec was copied to \\`specs/${specFilename}\\` and wired up in \\`stackwright.yml\\`.\n\n**What gets generated:**\n\n\\`\\`\\`typescript\n// src/generated/${specName}/schemas.ts\nexport const EquipmentSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  status: z.enum(['operational', 'maintenance', 'retired']),\n  // ... Zod validation for runtime safety\n});\n\n// src/generated/${specName}/types.ts\nexport type Equipment = z.infer<typeof EquipmentSchema>;\n\n// src/generated/${specName}/client.ts\nexport class ${specName!.charAt(0).toUpperCase() + specName!.slice(1)}Client {\n  async getEquipment(id: string): Promise<Equipment> {\n    // Auto-wired with auth, validation, error handling\n  }\n}\n\\`\\`\\`\n\n**How it works:**\n1. The \\`predev\\` script in \\`package.json\\` runs \\`prebuild.js\\` before every \\`pnpm dev\\`\n2. Prebuild reads your spec and generates type-safe code\n3. You import and use it:\n\n\\`\\`\\`typescript\nimport { ${specName!.charAt(0).toUpperCase() + specName!.slice(1)}Client } from '@/generated/${specName}/client';\nimport type { Equipment } from '@/generated/${specName}/types';\n\nconst client = new ${specName!.charAt(0).toUpperCase() + specName!.slice(1)}Client();\nconst gear: Equipment = await client.getEquipment('123');\n\\`\\`\\`\n\nNo manual typing. No drift. No runtime surprises.\n\n`\n    : '';\n\n  // Build mock server section if enabled\n  const mockSection = hasMock\n    ? `## 🎭 Mock Server\n\nPrism mock server is configured to serve your API at **http://localhost:4010**.\n\n\\`\\`\\`bash\npnpm dev:mock    # Starts Prism + Next.js together\n\\`\\`\\`\n\nThis starts:\n1. Prism mock server on port 4010 (serves your OpenAPI spec)\n2. Next.js dev server on port 3000\n\nThe generated API client is automatically configured to use the mock server.\n\n`\n    : '';\n\n  // Build AI Agents section if otters are present\n  const aiAgentsSection = hasOtters\n    ? `## 🦦 AI Agents (The Otter Raft)\n\nYour project includes **SIX specialized AI agents** in \\`node_modules/@stackwright-pro/otters/\\`:\n\n- \\`stackwright-pro-foreman-otter\\` - Master coordinator that orchestrates all specialist otters\n- \\`stackwright-pro-api-otter\\` - Discovers entities from OpenAPI specs\n- \\`stackwright-pro-auth-otter\\` - Configures CAC/OIDC auth, RBAC rules, and audit middleware\n- \\`stackwright-pro-data-otter\\` - Configures endpoint filters & ISR revalidation\n- \\`stackwright-pro-page-otter\\` - Generates pages auto-wired with data, theme, and auth\n- \\`stackwright-pro-dashboard-otter\\` - Builds live data dashboards\n\n**Start the otter raft:**\n\n\\`\\`\\`bash\nnpx @stackwright-pro/raft\n\\`\\`\\`\n\nThe raft verifies otter integrity, writes project context, and spawns code-puppy in foreman mode. The foreman asks questions about your brand, auth, and data preferences, then coordinates specialist otters to build your app. All state lives in \\`.stackwright/\\` — interrupt and resume anytime.\n\n**Example session prompt:**\n\n\"Build me a logistics dashboard from our OpenAPI spec. Connect to /equipment and /supplies endpoints.\"\n\n`\n    : '';\n\n  return `# ${projectName}\n\nA Stackwright Pro application with role-based auth, OpenAPI integration, and intelligent AI agents.\n\n## 🚀 Quick Start\n\n\\`\\`\\`bash\n# Start development server\npnpm dev\n\n# Open your browser\nopen http://localhost:3000\n\\`\\`\\`\n\n## 👥 Role-Based Development\n\nStackwright Pro includes **mock authentication** for local development with three pre-configured roles:\n\n\\`\\`\\`bash\npnpm dev:admin     # Full permissions (*)\npnpm dev:analyst   # Read & write data\npnpm dev:viewer    # Read-only access\n\\`\\`\\`\n\n**How it works:**\n- Each script sets the \\`MOCK_USER\\` environment variable\n- \\`lib/mock-auth.ts\\` intercepts requests and injects the appropriate user context\n- Your pages & API routes respect the RBAC rules in \\`stackwright.yml\\`\n- No backend required for testing auth flows! 🎉\n\n**Pro tip:** Test your UI for all three roles to ensure proper permissions enforcement.\n\n${mockSection}## 📁 Project Structure\n\n\\`\\`\\`\n.\n├── pages/\n│   ├── _app.tsx               # Pro version with AuthProvider + shadcn\n│   ├── index.tsx              # Home page (auto-generated by Stackwright)\n│   ├── about/\n│   │   └── content.yml        # Page content in YAML\n│   └── ...\n├── lib/\n│   └── mock-auth.ts           # Dev-only auth mocking (no backend needed)\n├── scripts/\n│   └── prebuild.js            # Auto-generates code from OpenAPI specs\n├── specs/                     # OpenAPI spec files (if --spec was used)\n├── src/\n│   └── generated/             # Auto-generated types & clients\n│       └── {specName}/\n│           ├── schemas.ts     # Zod schemas for runtime validation\n│           ├── types.ts       # TypeScript types\n│           ├── client.ts      # API client with auth\n│           └── provider.ts    # CollectionProvider for Stackwright\n├── .stackwright/\n│   └── otters/                # AI agent configs (4 specialized otters)\n├── stackwright.yml            # Theme, auth, API integrations\n└── package.json\n\\`\\`\\`\n\n**Key Files:**\n- \\`pages/_app.tsx\\` - Wraps your app with \\`AuthProvider\\` for RBAC\n- \\`stackwright.yml\\` - Single source of truth for theme, auth roles, and API wiring\n- \\`lib/mock-auth.ts\\` - Mocks CAC/PIV headers locally so you can test auth flows\n- \\`scripts/prebuild.js\\` - Runs before dev/build to generate types from your OpenAPI spec\n\n## 📄 Adding Pages\n\nStackwright uses **YAML for content**, so you never touch JSX unless you want to.\n\n**Example:** Create \\`pages/about/content.yml\\`:\n\n\\`\\`\\`yaml\ntitle: About Us\ndescription: Learn more about our mission\n\nsections:\n  - type: main\n    heading: Who We Are\n    body: |\n      We build mission-critical logistics systems for the Marine Corps.\n\n  - type: feature_list\n    title: Our Capabilities\n    features:\n      - icon: Security\n        title: Zero Trust\n        description: PKI-based auth with CAC/PIV\n      - icon: Api\n        title: Real-time Data\n        description: OpenAPI-backed, Zod-validated\n\\`\\`\\`\n\nThat's it. Navigate to \\`/about\\` and it just works. No routing config, no React components.\n\n${apiIntegrationSection}## 🎨 Customizing Theme\n\nEdit \\`stackwright.yml\\` to change colors, fonts, spacing — applies everywhere instantly.\n\n\\`\\`\\`yaml\ntheme:\n  id: my-theme\n  name: My Custom Theme\n  colors:\n    primary: \"#C41E3A\"        # Marine Corps red\n    background: \"#FFFFFF\"\n    text: \"#1A1A1A\"\n    accent: \"#FFD700\"         # Gold\n  typography:\n    fontFamily: \"'Inter', sans-serif\"\n    h1Size: \"2.5rem\"\n  spacing:\n    unit: 8\n\\`\\`\\`\n\nNo CSS files. No theme provider boilerplate. Just YAML. Stackwright handles the rest.\n\n## 🔐 Auth Configuration\n\nStackwright Pro comes with **3 pre-configured roles** in \\`stackwright.yml\\`:\n\n\\`\\`\\`yaml\nauth:\n  roles:\n    - name: ADMIN\n      permissions: ['*']                        # Full access\n    - name: ANALYST  \n      permissions: ['data:read', 'data:write']  # Read/write data\n    - name: VIEWER\n      permissions: ['data:read']                # Read-only\n\\`\\`\\`\n\n**Gate content in your YAML:**\n\n\\`\\`\\`yaml\nsections:\n  - type: button\n    label: Delete Equipment\n    action: /api/equipment/delete\n    auth:\n      required_roles: [ADMIN]\n      fallback: hide              # Options: hide, disable, show_message\n\\`\\`\\`\n\nOnly admins see the button. Analysts and viewers? Button doesn't exist in the DOM.\n\n**Route protection:**\n\n\\`\\`\\`yaml\nauth:\n  protected_routes:\n    - path: /admin/*\n      roles: [ADMIN]\n    - path: /equipment/*  \n      roles: [ANALYST, ADMIN]\n  public_routes:\n    - /\n    - /about\n\\`\\`\\`\n\nNo middleware to write. No useAuth hooks to remember. RBAC is declarative.\n\n${aiAgentsSection}## 📚 Learn More\n\n- **Stackwright Docs:** [https://stackwright.dev](https://stackwright.dev)\n- **OSS Repo:** [https://github.com/Per-Aspera-LLC/stackwright](https://github.com/Per-Aspera-LLC/stackwright)\n- **Pro Repo:** [https://github.com/Per-Aspera-LLC/stackwright-pro](https://github.com/Per-Aspera-LLC/stackwright-pro)\n\n**Questions?** File an issue or ping us in the discussions. We're here to help you ship faster.\n`;\n}\n\n// ---------------------------------------------------------------------------\n// Main launch flow\n// ---------------------------------------------------------------------------\n\nasync function launch(targetDir: string, options: LaunchProOptions): Promise<void> {\n  const dirName = path.basename(targetDir);\n\n  console.log(chalk.cyan.bold('\\n🚢 Launching Stackwright Pro...\\n'));\n\n  // ------------------------------------------------------------------\n  // 1. Scaffold base OSS project via @stackwright/cli\n  //    Hooks auto-handle: Pro deps, MCP config, role-based scripts\n  // ------------------------------------------------------------------\n\n  const scaffoldOpts: ScaffoldOptions = {\n    name: options.name || dirName,\n    standalone: true, // prevents `workspace:*` refs when CLI runs inside the Pro monorepo\n    ...(options.title !== undefined && { title: options.title }),\n    ...(options.theme !== undefined && { theme: options.theme }),\n    ...(options.force !== undefined && { force: options.force }),\n    ...(options.yes !== undefined && { noInteractive: options.yes }),\n  };\n\n  await scaffold(targetDir, scaffoldOpts);\n  console.log(chalk.green('✅ Base project scaffolded (hooks added Pro deps + MCP config)'));\n\n  // ------------------------------------------------------------------\n  // 1b. Run pnpm install — citizen devs shouldn't need to know this step exists\n  // ------------------------------------------------------------------\n\n  // Patch Pro packages directly into package.json before install.\n  // This bypasses the scaffold hooks system (which has a known version-resolution\n  // issue) and guarantees pro deps land regardless of hook execution order.\n  await addProDepsToPackageJson(targetDir);\n  console.log(chalk.green('🦦 Pro packages added to package.json'));\n\n  // Verify package.json has Pro deps before installing\n  const verifyPkg = JSON.parse(\n    await fs.readFile(path.join(targetDir, 'package.json'), 'utf-8')\n  ) as Record<string, any>;\n  const proDepCount = Object.keys((verifyPkg.dependencies as Record<string, string>) || {}).filter(\n    (k) => k.startsWith('@stackwright-pro')\n  ).length;\n  console.log(chalk.dim(`  → package.json verified: ${proDepCount} @stackwright-pro/* deps ready`));\n\n  console.log(chalk.cyan('\\n📦 Installing dependencies (this takes a moment)...'));\n  if (!options.skipInstall) {\n    try {\n      execSync('pnpm install --ignore-workspace', {\n        cwd: targetDir,\n        stdio: 'inherit',\n        timeout: 120_000,\n      });\n      console.log(chalk.green('✅ Dependencies installed'));\n    } catch (err: unknown) {\n      const isTimeout =\n        err instanceof Error &&\n        (err.message.includes('ETIMEDOUT') || err.message.includes('timeout'));\n      console.error(\n        chalk.red('\\n❌ pnpm install failed. Auth and Pro packages are NOT installed.')\n      );\n      console.error(\n        chalk.red('   Your project is in an incomplete state — do NOT run or deploy it.')\n      );\n      if (isTimeout) {\n        console.error(\n          chalk.yellow('   The install timed out (>2 min). Check your network connection.')\n        );\n      }\n      console.error(\n        chalk.yellow(`   Fix the error above, then run: pnpm install --ignore-workspace`)\n      );\n      process.exit(1);\n    }\n  } else {\n    console.log(chalk.dim('ℹ️  Skipping install (--skip-install). Run: pnpm install'));\n  }\n\n  // Fire postInstall hooks now that install has run\n  const dependencyMode: 'workspace' | 'standalone' = 'standalone';\n  await runScaffoldHooks('postInstall', {\n    targetDir,\n    projectName: options.name || path.basename(targetDir),\n    siteTitle: options.title || options.name || path.basename(targetDir),\n    themeId: options.theme || 'corporate',\n    packageJson: {},\n    dependencyMode,\n  });\n\n  // ------------------------------------------------------------------\n  // 2. Copy Pro templates (hooks can't handle these)\n  // ------------------------------------------------------------------\n\n  // Replace _app.tsx with Pro version (AuthProvider, shadcn, etc.)\n  await copyProTemplate('_app.tsx', path.join(targetDir, 'pages', '_app.tsx'));\n\n  // Add root content.yml for the home page\n  await copyProTemplate('content.yml', path.join(targetDir, 'pages', 'content.yml'));\n\n  // Replace next.config.js with Pro version (transpile pro pkgs)\n  await copyProTemplate('next.config.js', path.join(targetDir, 'next.config.js'));\n\n  // Add lib/mock-auth.ts\n  await fs.ensureDir(path.join(targetDir, 'lib'));\n  await copyProTemplate('mock-auth.ts', path.join(targetDir, 'lib', 'mock-auth.ts'));\n\n  // Add yaml.d.ts for TypeScript support\n  await copyProTemplate('yaml.d.ts', path.join(targetDir, 'yaml.d.ts'));\n\n  // Add scripts/prebuild.js\n  await fs.ensureDir(path.join(targetDir, 'scripts'));\n  await copyProTemplate('prebuild.js', path.join(targetDir, 'scripts', 'prebuild.js'));\n\n  console.log(chalk.green('🔐 Auth integration added (RBAC with 3 roles)'));\n\n  // ------------------------------------------------------------------\n  // 3. Add auth section to stackwright.yml\n  // ------------------------------------------------------------------\n\n  await addAuthToStackwrightYml(targetDir);\n\n  // ------------------------------------------------------------------\n  // 4. Handle --spec if provided\n  // ------------------------------------------------------------------\n\n  let specInfo: { specFilename: string; derivedName: string } | null = null;\n  const MOCK_URL = 'http://localhost:4010';\n\n  if (options.spec) {\n    specInfo = await handleSpec(targetDir, options.spec, options.specName);\n\n    // Pass mockUrl if --mock flag is set\n    await addIntegrationToStackwrightYml(\n      targetDir,\n      specInfo.derivedName,\n      specInfo.specFilename,\n      options.mock ? MOCK_URL : undefined\n    );\n    console.log(chalk.green('📡 OpenAPI integration wired up'));\n\n    if (options.mock) {\n      console.log(chalk.green('🎭 Prism mock server configured'));\n    }\n  } else if (options.mock) {\n    // --mock without --spec: use sample Petstore spec for demo\n    console.log(\n      chalk.yellow(\n        '⚠️  No spec provided with --mock. Using sample Petstore spec for demo. Replace with your API spec.'\n      )\n    );\n\n    const specsDir = path.join(targetDir, 'specs');\n    await fs.ensureDir(specsDir);\n    await copyProTemplate('petstore.yaml', path.join(specsDir, 'petstore.yaml'));\n\n    specInfo = { specFilename: 'petstore.yaml', derivedName: 'petstore' };\n\n    await addIntegrationToStackwrightYml(\n      targetDir,\n      specInfo.derivedName,\n      specInfo.specFilename,\n      MOCK_URL\n    );\n    console.log(chalk.green('📡 Sample Petstore spec wired up'));\n    console.log(chalk.green('🎭 Prism mock server configured'));\n  }\n\n  // ------------------------------------------------------------------\n  // 5. Generate README\n  // ------------------------------------------------------------------\n\n  const readmeContent = generateReadme({\n    projectName: options.name || dirName,\n    hasSpec: !!specInfo,\n    ...(specInfo?.derivedName !== undefined && { specName: specInfo.derivedName }),\n    ...(specInfo?.specFilename !== undefined && { specFilename: specInfo.specFilename }),\n    hasOtters: !options.skipOtters,\n    hasMock: !!options.mock,\n  });\n\n  await fs.writeFile(path.join(targetDir, 'README.md'), readmeContent);\n  console.log(chalk.green('📄 README.md created'));\n\n  // ------------------------------------------------------------------\n  // 5b. Write init-context.json for raft launcher\n  // ------------------------------------------------------------------\n\n  const initContext: Record<string, unknown> = {\n    projectRoot: targetDir,\n    projectName: options.name || dirName,\n    generatedBy: 'launch-stackwright-pro',\n    version: '1.0',\n  };\n\n  if (specInfo) {\n    initContext.specPath = `specs/${specInfo.specFilename}`;\n    initContext.specName = specInfo.derivedName;\n  }\n\n  initContext.theme = options.theme || 'corporate';\n\n  const stackwrightDir = path.join(targetDir, '.stackwright');\n  await fs.ensureDir(stackwrightDir);\n  await fs.writeFile(\n    path.join(stackwrightDir, 'init-context.json'),\n    JSON.stringify(initContext, null, 2) + '\\n',\n    'utf-8'\n  );\n\n  // ------------------------------------------------------------------\n  // 6. Print next steps\n  // ------------------------------------------------------------------\n\n  const relDir = path.relative(process.cwd(), targetDir) || '.';\n\n  console.log(chalk.cyan.bold(\"\\n🎉 All set! Here's what to do next:\\n\"));\n  console.log(chalk.white(`  1. cd ${relDir}`));\n  console.log(chalk.white('  2. npx @stackwright-pro/raft'));\n  console.log(chalk.dim('     (use --verbose for troubleshooting)'));\n\n  if (specInfo) {\n    console.log(chalk.cyan(`\\n📡 Your API spec was copied to specs/${specInfo.specFilename}`));\n    console.log(chalk.dim('   The prebuild will generate types & client on first `pnpm dev`.'));\n  }\n\n  if (options.mock) {\n    console.log(chalk.cyan('\\n🎭 Run with mock server:'));\n    console.log(chalk.white('   pnpm dev:mock  # Starts Prism + Next.js'));\n  }\n\n  if (!options.skipOtters) {\n    console.log(chalk.cyan.bold('\\n🦦 The otter raft is ready to build your site!'));\n    console.log(chalk.dim('   Run the command above to get started.\\n'));\n  }\n}\n\n// ---------------------------------------------------------------------------\n// CLI definition\n// ---------------------------------------------------------------------------\n\nasync function main(): Promise<void> {\n  const program = new Command();\n\n  program\n    .name('launch-stackwright-pro')\n    .description('🚢 Launch a new Stackwright Pro project with auth, OpenAPI, and the otter raft')\n    .version(version)\n    .argument('[directory]', 'Project directory', '.')\n    .option('--name <name>', 'Project name (used in package.json)')\n    .option('--title <title>', 'Site title shown in the app bar and browser tab')\n    .option('--theme <themeId>', 'Theme ID (e.g., corporate, creative, minimal)')\n    .option('--force', 'Launch even if the target directory is not empty')\n    .option('--skip-otters', 'Skip copying otter raft configs')\n    .option('-y, --yes', 'Skip all prompts, use defaults')\n    .option('--mock', 'Configure Prism mock server for API development (runs on port 4010)')\n    .option(\n      '--spec <path>',\n      'Path to an OpenAPI spec (YAML or JSON) — copies into project and wires up integration'\n    )\n    .option(\n      '--spec-name <name>',\n      'Name for the API integration (default: derived from spec filename)'\n    )\n    .option(\n      '--skip-install',\n      'Skip automatic pnpm install (useful in CI or when using a different package manager)'\n    )\n    .action(async (directory: string, options: LaunchProOptions) => {\n      const homeDir = os.homedir();\n      const targetDir = path.resolve(directory);\n\n      // Warn (don't block) when scaffolding outside home dir — unusual for a user-facing CLI\n      if (!targetDir.startsWith(homeDir + path.sep) && targetDir !== homeDir) {\n        console.warn(chalk.yellow(`⚠️  Scaffolding outside your home directory: ${targetDir}`));\n      }\n\n      await launch(targetDir, options);\n    });\n\n  await program.parseAsync(process.argv);\n}\n\nmain().catch((err: unknown) => {\n  console.error(chalk.red('\\n❌ Launch failed:'), err);\n  process.exit(1);\n});\n","// AUTO-GENERATED — do not edit manually.\n// Run `pnpm sync-versions` or `pnpm build` to regenerate.\n//\n// PRO_VERSIONS: exact versions of @stackwright-pro/* packages in this workspace.\n// OSS_VERSIONS: minimum tested versions of @stackwright/* OSS packages (caret range).\n\n/**\n * Exact versions of every @stackwright-pro/* package currently in the workspace.\n * Used by launch-stackwright-pro and scaffold-hooks to pin deps in scaffolded projects.\n * Updated automatically on every build — never edit this file by hand.\n */\nexport const PRO_VERSIONS = {\n  '@stackwright-pro/auth': '0.2.0-alpha.1',\n  '@stackwright-pro/auth-nextjs': '0.2.0-alpha.1',\n  '@stackwright-pro/display-components': '0.2.0-alpha.2',\n  '@stackwright-pro/mcp': '0.2.0-alpha.23',\n  '@stackwright-pro/openapi': '0.3.0-alpha.5',\n  '@stackwright-pro/otters': '1.0.0-alpha.24',\n  '@stackwright-pro/pulse': '0.3.0-alpha.2',\n} as const satisfies Record<string, string>;\n\n/**\n * Minimum tested versions of @stackwright/* OSS packages.\n * Caret ranges anchored to the last version resolved in pnpm-lock.yaml.\n * Updated automatically on every build.\n */\nexport const OSS_VERSIONS = {\n  '@stackwright/build-scripts': '^0.4.0',\n  '@stackwright/core': '^0.7.0',\n  '@stackwright/icons': '^0.3.0',\n  '@stackwright/mcp': '^0.2.0',\n  '@stackwright/nextjs': '^0.3.1',\n  '@stackwright/otters': '^0.2.0',\n  '@stackwright/ui-shadcn': '^0.1.0',\n} as const satisfies Record<string, string>;\n"],"mappings":"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","names":["exports","module","path","fs","yaml","chalk","os"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackwright-pro/launch-stackwright-pro",
-  "version": "0.4.0-alpha.4",
+  "version": "0.4.0-alpha.41",
   "description": "Launch a new Stackwright Pro project with OpenAPI integration, auth, and the otter raft",
   "license": "MIT",
   "publishConfig": {
@@ -26,13 +26,18 @@
     "launch-stackwright-pro": "dist/index.js"
   },
   "dependencies": {
-    "@stackwright/cli": "^0.7.0",
+    "@stackwright-pro/scaffold-hooks": "latest",
+    "@stackwright/cli": "^0.7.1-alpha.0",
     "@stackwright/scaffold-core": "^0.1.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "fs-extra": "^11.3",
     "js-yaml": "^4.1.0",
-    "@stackwright-pro/scaffold-hooks": "0.3.0-alpha.1"
+    "@stackwright-pro/auth-nextjs": "0.2.0-alpha.1",
+    "@stackwright-pro/auth": "0.2.0-alpha.1",
+    "@stackwright-pro/openapi": "0.3.0-alpha.5",
+    "@stackwright-pro/mcp": "0.2.0-alpha.23",
+    "@stackwright-pro/otters": "1.0.0-alpha.24"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0",
@@ -43,7 +48,8 @@
     "vitest": "^4.0.18"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "node ../../scripts/sync-versions.mjs && tsup",
+    "sync-versions": "node ../../scripts/sync-versions.mjs",
     "dev": "tsup --watch",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage"

package/templates/pro/prebuild.js

@@ -1,105 +1,75 @@
 /**
  * Stackwright Pro prebuild script
  *
- * Runs stackwright-prebuild to generate content JSON files from YAML,
- * then runs the OpenAPI plugin to generate API client code.
- * Also extracts auth config and generates auth-config.json for client-side use.
+ * Uses runPrebuild() from @stackwright/build-scripts directly with the pro
+ * content plugin, enabling pro content types (page_header, stats_grid, etc.)
+ * to pass schema validation alongside OSS content types.
+ *
+ * Also runs the OpenAPI plugin for API client generation and extracts
+ * auth config for client-side use.
+ *
+ * Requires @stackwright/build-scripts >= 0.5.0
  */
 
-const { spawn } = require('child_process');
+'use strict';
+
 const fs = require('fs');
 const path = require('path');
 const yaml = require('js-yaml');
+const { runPrebuild } = require('@stackwright/build-scripts');
 const { createOpenAPIPlugin } = require('@stackwright-pro/openapi');
-
-/**
- * Run stackwright-prebuild to generate _root.json, _site.json, etc.
- */
-async function runStackwrightPrebuild(projectRoot) {
-  return new Promise((resolve, reject) => {
-    // Use pnpm exec to ensure we use the correct package manager
-    const proc = spawn(process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm', ['exec', 'stackwright-prebuild'], {
-      cwd: projectRoot,
-      stdio: 'inherit',
-      shell: true,
-    });
-    proc.on('close', (code) => {
-      if (code === 0) {
-        resolve();
-      } else {
-        reject(new Error(`stackwright-prebuild exited with code ${code}`));
-      }
-    });
-    proc.on('error', reject);
-  });
-}
+const { proContentPlugin } = require('./scripts/pro-content-plugin');
 
 /**
  * Parse full stackwright.yml using js-yaml for complete config parsing
  */
 function parseStackwrightYml(content) {
-  return yaml.load(content);
+  return yaml.load(content, { schema: yaml.CORE_SCHEMA });
 }
 
 async function main() {
-  try {
-    const projectRoot = path.resolve(__dirname, '..');
-
-    const configPath = path.join(projectRoot, 'stackwright.yml');
-    if (!fs.existsSync(configPath)) {
-      console.log('No stackwright.yml found — skipping prebuild.');
-      return;
-    }
+  const projectRoot = path.resolve(__dirname, '..');
 
-    // Run stackwright-prebuild first to generate content JSON files
-    console.log('Generating content files...');
-    await runStackwrightPrebuild(projectRoot);
-
-    const configContent = fs.readFileSync(configPath, 'utf-8');
-    const fullConfig = parseStackwrightYml(configContent);
-
-    // Extract auth config and write as JSON for client-side use
-    if (fullConfig.auth) {
-      const authConfig = fullConfig.auth;
-      const srcDir = path.join(projectRoot, 'src');
-      
-      if (!fs.existsSync(srcDir)) {
-        fs.mkdirSync(srcDir, { recursive: true });
-      }
-      
-      fs.writeFileSync(
-        path.join(srcDir, 'auth-config.json'),
-        JSON.stringify(authConfig, null, 2)
-      );
-      console.log('✓ Generated src/auth-config.json');
-    }
+  const configPath = path.join(projectRoot, 'stackwright.yml');
+  if (!fs.existsSync(configPath)) {
+    console.log('No stackwright.yml found — skipping prebuild.');
+    return;
+  }
 
-    // Extract integrations for OpenAPI plugin
-    const siteConfig = { integrations: fullConfig.integrations || [] };
+  const configContent = fs.readFileSync(configPath, 'utf-8');
+  const fullConfig = parseStackwrightYml(configContent);
 
-    if (!siteConfig.integrations.length) {
-      console.log('No integrations in stackwright.yml — skipping OpenAPI plugin.');
-      console.log('✓ Prebuild complete!');
-      return;
-    }
+  // Assemble plugins
+  const plugins = [proContentPlugin];
 
-    console.log(`Found ${siteConfig.integrations.length} integration(s). Running OpenAPI plugin...`);
+  const integrations = fullConfig.integrations || [];
+  if (integrations.length > 0) {
+    plugins.push(createOpenAPIPlugin());
+    console.log(`  OpenAPI plugin: loaded (${integrations.length} integrations)`);
+  }
 
-    const plugin = createOpenAPIPlugin();
+  // Run prebuild with all plugins
+  console.log('Generating content files...');
+  await runPrebuild({ projectRoot, plugins });
 
-    if (plugin.beforeBuild) {
-      await plugin.beforeBuild({
-        siteConfig,
-        projectRoot,
-      });
+  // Extract auth config and write as JSON for client-side use
+  if (fullConfig.auth) {
+    const srcDir = path.join(projectRoot, 'src');
+    if (!fs.existsSync(srcDir)) {
+      fs.mkdirSync(srcDir, { recursive: true });
     }
-
-    console.log('✓ Prebuild complete!');
-  } catch (error) {
-    console.error('Prebuild failed:', error.message);
-    console.error(error.stack);
-    process.exit(1);
+    fs.writeFileSync(
+      path.join(srcDir, 'auth-config.json'),
+      JSON.stringify(fullConfig.auth, null, 2)
+    );
+    console.log('✓ Generated src/auth-config.json');
   }
+
+  console.log('✓ Prebuild complete!');
 }
 
-main();
+main().catch((err) => {
+  console.error('Prebuild failed:', err.message);
+  console.error(err.stack);
+  process.exit(1);
+});

package/templates/pro/scripts/pro-content-plugin.js

@@ -0,0 +1,57 @@
+/**
+ * Pro content plugin for Stackwright prebuild.
+ *
+ * Registers Zod schemas for pro content item types, allowing pages that use
+ * pro content types (page_header, stats_grid, etc.) to pass the OSS schema
+ * validator without errors.
+ *
+ * Used by scripts/prebuild.js when calling runPrebuild() with plugins.
+ * Requires @stackwright/build-scripts >= 0.5.0
+ */
+
+'use strict';
+
+const { z } = require('zod');
+
+/**
+ * All pro content item type strings.
+ * These are recognized by the pro rendering pipeline via registerDisplayComponents().
+ */
+const PRO_CONTENT_TYPES = [
+  'page_header',
+  'stats_grid',
+  'two_column_layout',
+  'data_table',
+  'section',
+  'action_bar',
+  'alert_banner',
+  'tab_group',
+  'split_view',
+  'detail_view',
+  'live_map',
+  'map_view',
+  'collection_listing',
+  'resupply_form',
+  'tracking_timeline',
+];
+
+/**
+ * Passthrough schema for any pro content item.
+ * Validates that `type` is one of the known pro types; passes all other fields through.
+ */
+const proContentItemSchema = z
+  .object({
+    type: z.enum(PRO_CONTENT_TYPES),
+  })
+  .passthrough();
+
+/**
+ * Stackwright PrebuildPlugin for pro content types.
+ */
+const proContentPlugin = {
+  name: 'pro-content',
+  contentItemSchemas: [proContentItemSchema],
+  knownContentTypeKeys: PRO_CONTENT_TYPES,
+};
+
+module.exports = { proContentPlugin, PRO_CONTENT_TYPES, proContentItemSchema };