@stackwright-pro/launch-stackwright-pro 0.2.2 → 0.3.0-alpha.0

package/README.md

@@ -4,6 +4,18 @@
 OpenAPI integration, RBAC auth, mock users, and the otter raft ready to build
 your site for you.
 
+## How It Works
+
+This package uses the **scaffold hooks system** (`@stackwright-pro/scaffold-hooks`)
+to automatically wire up Pro features:
+
+1. **Import hooks** → Auto-registers Pro packages during scaffolding
+2. **Call `scaffold()`** → Hooks automatically add:
+   - Pro dependencies (`@stackwright-pro/mcp`, `@stackwright-pro/otters`, etc.)
+   - MCP server configuration in `.code-puppy.json`
+   - Role-based dev scripts (`dev:admin`, `dev:analyst`, `dev:viewer`)
+3. **Post-processing** → Copies Pro templates, adds auth config, generates README
+
 ## Quick Start
 
 ```bash
@@ -42,8 +54,7 @@ my-app/
 ├── stackwright.yml           # Theme + auth + integrations config
 ├── next.config.js            # Pro config (transpile pro pkgs + yaml-loader)
 ├── yaml.d.ts                 # TS declarations for YAML imports
-├── .code-puppy.json          # MCP auto-configuration
-└── package.json              # OSS + Pro dependencies
+└── package.json              # OSS + Pro dependencies (via scaffold hooks)
 ```
 
 ## CLI Options
@@ -78,15 +89,26 @@ pnpm dev:viewer     # MOCK_USER=viewer
 
 ## What's Different from OSS `launch-stackwright`?
 
-| Feature | OSS | Pro |
-|---------|-----|-----|
-| Base scaffold | ✅ | ✅ |
-| Otter raft | ✅ | ✅ |
-| RBAC auth | ❌ | ✅ |
-| Mock users | ❌ | ✅ |
-| OpenAPI integration | ❌ | ✅ |
-| Prebuild code-gen | ❌ | ✅ |
-| YAML config loading | ❌ | ✅ |
+| Feature             | OSS | Pro |
+| ------------------- | --- | --- |
+| Base scaffold       | ✅  | ✅  |
+| Otter raft          | ✅  | ✅  |
+| RBAC auth           | ❌  | ✅  |
+| Mock users          | ❌  | ✅  |
+| OpenAPI integration | ❌  | ✅  |
+| Prebuild code-gen   | ❌  | ✅  |
+| YAML config loading | ❌  | ✅  |
+
+## Scaffold Hooks
+
+The `@stackwright-pro/scaffold-hooks` package handles Pro package injection
+automatically via the hooks system:
+
+| Hook                      | What It Does                                             |
+| ------------------------- | -------------------------------------------------------- |
+| `pro-dependencies`        | Adds `@stackwright-pro/*` packages, fixes workspace refs |
+| `pro-mcp-config`          | Configures Pro MCP server in `.code-puppy.json`          |
+| `verify-pro-installation` | Prints success message after install                     |
 
 ## Docs
 

package/dist/index.js

@@ -58,7 +58,8 @@ var require_package = __commonJS({
         dev: "tsup --watch"
       },
       dependencies: {
-        "@stackwright/cli": "latest",
+        "@stackwright-pro/scaffold-hooks": "workspace:*",
+        "@stackwright/cli": "workspace:*",
         chalk: "^5.6.2",
         commander: "^14.0.3",
         "fs-extra": "^11.3",
@@ -82,65 +83,10 @@ var import_fs_extra = __toESM(require("fs-extra"));
 var import_chalk = __toESM(require("chalk"));
 var import_js_yaml = __toESM(require("js-yaml"));
 var import_cli = require("@stackwright/cli");
+var import_scaffold_core = require("@stackwright/scaffold-core");
+var import_scaffold_hooks = require("@stackwright-pro/scaffold-hooks");
+(0, import_scaffold_hooks.createProScaffoldHooks)({ registerScaffoldHook: import_scaffold_core.registerScaffoldHook });
 var { version } = require_package();
-var STACKWRIGHT_NPM_VERSIONS = {
-  "@stackwright/core": "^0.7.0",
-  "@stackwright/icons": "^0.3.0",
-  "@stackwright/nextjs": "^0.3.1",
-  "@stackwright/ui-shadcn": "^0.1.0",
-  "@stackwright/build-scripts": "^0.4.0",
-  "@stackwright/mcp": "^0.2.0",
-  "@stackwright-pro/mcp": "latest"
-};
-var PRO_DEPENDENCIES = {
-  "@stackwright/otters": "latest",
-  // OSS otters (installed as package)
-  "@stackwright-pro/otters": "latest",
-  // Pro otters (installed as package)
-  "@stackwright-pro/openapi": "latest",
-  "@stackwright-pro/auth": "latest",
-  "@stackwright-pro/auth-nextjs": "latest",
-  zod: "^3.23.0"
-};
-var PRO_DEV_DEPENDENCIES = {
-  "@stoplight/prism-cli": "^5.14.2"
-  // Mock server for API development
-};
-async function fixWorkspaceRefs(targetDir) {
-  const pkgPath = import_path.default.join(targetDir, "package.json");
-  const pkg = await import_fs_extra.default.readJSON(pkgPath);
-  for (const [pkgName, version2] of Object.entries(STACKWRIGHT_NPM_VERSIONS)) {
-    if (pkg.dependencies?.[pkgName] === "workspace:*") {
-      pkg.dependencies[pkgName] = version2;
-      console.log(import_chalk.default.dim(`  Fixed ${pkgName}: workspace:* \u2192 ${version2}`));
-    }
-    if (pkg.devDependencies?.[pkgName] === "workspace:*") {
-      pkg.devDependencies[pkgName] = version2;
-      console.log(import_chalk.default.dim(`  Fixed ${pkgName} (dev): workspace:* \u2192 ${version2}`));
-    }
-  }
-  await import_fs_extra.default.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
-}
-async function addProDependencies(targetDir, specFilename) {
-  const pkgPath = import_path.default.join(targetDir, "package.json");
-  await fixWorkspaceRefs(targetDir);
-  const pkg = await import_fs_extra.default.readJSON(pkgPath);
-  pkg.dependencies["@stackwright/mcp"] = STACKWRIGHT_NPM_VERSIONS["@stackwright/mcp"];
-  pkg.dependencies["@stackwright-pro/mcp"] = "latest";
-  pkg.dependencies = { ...pkg.dependencies, ...PRO_DEPENDENCIES };
-  pkg.devDependencies = { ...pkg.devDependencies, ...PRO_DEV_DEPENDENCIES };
-  const scripts = { ...pkg.scripts };
-  scripts["dev:admin"] = "MOCK_USER=admin next dev";
-  scripts["dev:analyst"] = "MOCK_USER=analyst next dev";
-  scripts["dev:viewer"] = "MOCK_USER=viewer next dev";
-  scripts.prebuild = "node scripts/prebuild.js";
-  scripts.predev = "node scripts/prebuild.js";
-  if (specFilename) {
-    scripts["dev:mock"] = `prism mock ./specs/${specFilename} --port 4010 --dynamic & next dev`;
-  }
-  pkg.scripts = scripts;
-  await import_fs_extra.default.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
-}
 async function copyProTemplate(templateName, destPath) {
   const src = import_path.default.resolve(__dirname, "..", "templates", "pro", templateName);
   await import_fs_extra.default.copy(src, destPath);
@@ -191,33 +137,6 @@ async function handleSpec(targetDir, specPath, specName) {
   await import_fs_extra.default.copy(resolvedSpec, import_path.default.join(specsDir, specFilename));
   return { specFilename, derivedName };
 }
-function writeCodePuppyConfig(targetDir) {
-  const config = {
-    mcpServers: {
-      stackwright: {
-        command: "node",
-        args: [import_path.default.join(targetDir, "node_modules", "@stackwright", "mcp", "dist", "server.js")],
-        env: { NODE_ENV: "development" }
-      },
-      "stackwright-pro": {
-        command: "node",
-        args: [import_path.default.join(targetDir, "node_modules", "@stackwright-pro", "mcp", "dist", "server.js")],
-        env: { NODE_ENV: "development" }
-      }
-    },
-    // Both OSS and Pro otters are installed as packages - no file copying!
-    agents_path: [
-      "node_modules/@stackwright/otters",
-      // OSS otters (installed as package)
-      "node_modules/@stackwright-pro/otters"
-      // Pro otters (installed as package)
-    ]
-  };
-  return import_fs_extra.default.writeFile(
-    import_path.default.join(targetDir, ".code-puppy.json"),
-    JSON.stringify(config, null, 2) + "\n"
-  );
-}
 function generateReadme(options) {
   const { projectName, hasSpec, specName, specFilename, hasOtters, hasMock } = options;
   const apiIntegrationSection = hasSpec ? `## \u{1F4E1} API Integration
@@ -496,17 +415,18 @@ async function launch(targetDir, options) {
     force: options.force,
     noInteractive: options.yes
   };
-  const result = await (0, import_cli.scaffold)(targetDir, scaffoldOpts);
-  console.log(import_chalk.default.green("\u2705 Base project scaffolded"));
+  await (0, import_cli.scaffold)(targetDir, scaffoldOpts);
+  console.log(import_chalk.default.green("\u2705 Base project scaffolded (hooks added Pro deps + MCP config)"));
   await copyProTemplate("_app.tsx", import_path.default.join(targetDir, "pages", "_app.tsx"));
+  await copyProTemplate("content.yml", import_path.default.join(targetDir, "pages", "content.yml"));
   await copyProTemplate("next.config.js", import_path.default.join(targetDir, "next.config.js"));
-  await addAuthToStackwrightYml(targetDir);
   await import_fs_extra.default.ensureDir(import_path.default.join(targetDir, "lib"));
   await copyProTemplate("mock-auth.ts", import_path.default.join(targetDir, "lib", "mock-auth.ts"));
   await copyProTemplate("yaml.d.ts", import_path.default.join(targetDir, "yaml.d.ts"));
   await import_fs_extra.default.ensureDir(import_path.default.join(targetDir, "scripts"));
   await copyProTemplate("prebuild.js", import_path.default.join(targetDir, "scripts", "prebuild.js"));
   console.log(import_chalk.default.green("\u{1F510} Auth integration added (RBAC with 3 roles)"));
+  await addAuthToStackwrightYml(targetDir);
   let specInfo = null;
   const MOCK_URL = "http://localhost:4010";
   if (options.spec) {
@@ -522,7 +442,11 @@ async function launch(targetDir, options) {
       console.log(import_chalk.default.green("\u{1F3AD} Prism mock server configured"));
     }
   } else if (options.mock) {
-    console.log(import_chalk.default.yellow("\u26A0\uFE0F  No spec provided with --mock. Using sample Petstore spec for demo. Replace with your API spec."));
+    console.log(
+      import_chalk.default.yellow(
+        "\u26A0\uFE0F  No spec provided with --mock. Using sample Petstore spec for demo. Replace with your API spec."
+      )
+    );
     const specsDir = import_path.default.join(targetDir, "specs");
     await import_fs_extra.default.ensureDir(specsDir);
     await copyProTemplate("petstore.yaml", import_path.default.join(specsDir, "petstore.yaml"));
@@ -536,11 +460,6 @@ async function launch(targetDir, options) {
     console.log(import_chalk.default.green("\u{1F4E1} Sample Petstore spec wired up"));
     console.log(import_chalk.default.green("\u{1F3AD} Prism mock server configured"));
   }
-  await addProDependencies(targetDir, options.mock ? specInfo?.specFilename : void 0);
-  if (!options.skipOtters) {
-    await writeCodePuppyConfig(targetDir);
-    console.log(import_chalk.default.green("\u{1F9A6}\u{1F9A6} Otter packages configured (OSS + Pro)"));
-  }
   const readmeContent = generateReadme({
     projectName: options.name || dirName,
     hasSpec: !!specInfo,

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.2.2\",\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  },\n  \"dependencies\": {\n    \"@stackwright/cli\": \"latest\",\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  }\n}\n","import { Command } from 'commander';\nimport path from 'path';\nimport fs from 'fs-extra';\nimport chalk from 'chalk';\nimport yaml from 'js-yaml';\n\nimport { scaffold, ScaffoldOptions } from '@stackwright/cli';\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  yes?: boolean;\n  spec?: string;\n  specName?: string;\n  mock?: boolean; // Auto-configure Prism mock server\n}\n\n// ---------------------------------------------------------------------------\n// Post-processing helpers\n// ---------------------------------------------------------------------------\n\n// Fixed npm versions for @stackwright/* packages (avoid workspace:* refs from scaffold)\nconst STACKWRIGHT_NPM_VERSIONS: Record<string, string> = {\n  '@stackwright/core': '^0.7.0',\n  '@stackwright/icons': '^0.3.0',\n  '@stackwright/nextjs': '^0.3.1',\n  '@stackwright/ui-shadcn': '^0.1.0',\n  '@stackwright/build-scripts': '^0.4.0',\n  '@stackwright/mcp': '^0.2.0',\n  '@stackwright-pro/mcp': 'latest',\n};\n\nconst PRO_DEPENDENCIES: Record<string, string> = {\n  '@stackwright/otters': 'latest', // OSS otters (installed as package)\n  '@stackwright-pro/otters': 'latest', // Pro otters (installed as package)\n  '@stackwright-pro/openapi': 'latest',\n  '@stackwright-pro/auth': 'latest',\n  '@stackwright-pro/auth-nextjs': 'latest',\n  zod: '^3.23.0',\n};\n\nconst PRO_DEV_DEPENDENCIES: Record<string, string> = {\n  '@stoplight/prism-cli': '^5.14.2', // Mock server for API development\n};\n\nasync function fixWorkspaceRefs(targetDir: string): Promise<void> {\n  const pkgPath = path.join(targetDir, 'package.json');\n  const pkg = await fs.readJSON(pkgPath);\n\n  // Fix workspace:* references in dependencies\n  for (const [pkgName, version] of Object.entries(STACKWRIGHT_NPM_VERSIONS)) {\n    if (pkg.dependencies?.[pkgName] === 'workspace:*') {\n      pkg.dependencies[pkgName] = version;\n      console.log(chalk.dim(`  Fixed ${pkgName}: workspace:* → ${version}`));\n    }\n    if (pkg.devDependencies?.[pkgName] === 'workspace:*') {\n      pkg.devDependencies[pkgName] = version;\n      console.log(chalk.dim(`  Fixed ${pkgName} (dev): workspace:* → ${version}`));\n    }\n  }\n\n  await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\\n');\n}\n\nasync function addProDependencies(targetDir: string, specFilename?: string): Promise<void> {\n  const pkgPath = path.join(targetDir, 'package.json');\n\n  // First, fix any workspace:* references from scaffold\n  await fixWorkspaceRefs(targetDir);\n\n  // Re-read after fixing workspace refs\n  const pkg = await fs.readJSON(pkgPath);\n\n  // Add MCP packages for code-puppy integration\n  pkg.dependencies['@stackwright/mcp'] = STACKWRIGHT_NPM_VERSIONS['@stackwright/mcp'];\n  pkg.dependencies['@stackwright-pro/mcp'] = 'latest';\n\n  pkg.dependencies = { ...pkg.dependencies, ...PRO_DEPENDENCIES };\n  pkg.devDependencies = { ...pkg.devDependencies, ...PRO_DEV_DEPENDENCIES };\n\n  // Build scripts object with role-based dev scripts (always included)\n  const scripts = { ...pkg.scripts };\n  scripts['dev:admin'] = 'MOCK_USER=admin next dev';\n  scripts['dev:analyst'] = 'MOCK_USER=analyst next dev';\n  scripts['dev:viewer'] = 'MOCK_USER=viewer next dev';\n  scripts.prebuild = 'node scripts/prebuild.js';\n  scripts.predev = 'node scripts/prebuild.js';\n\n  // Add mock script ONLY if we have a spec (Prism needs actual file path, not glob)\n  if (specFilename) {\n    scripts['dev:mock'] = `prism mock ./specs/${specFilename} --port 4010 --dynamic & next dev`;\n  }\n\n  pkg.scripts = scripts;\n\n  await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\\n');\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\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  // Add mock URL if mock server is configured\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\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// Otters are now installed as packages - no file copying needed!\n\nfunction writeCodePuppyConfig(targetDir: string): Promise<void> {\n  const config = {\n    mcpServers: {\n      stackwright: {\n        command: 'node',\n        args: [path.join(targetDir, 'node_modules', '@stackwright', 'mcp', 'dist', 'server.js')],\n        env: { NODE_ENV: 'development' },\n      },\n      'stackwright-pro': {\n        command: 'node',\n        args: [path.join(targetDir, 'node_modules', '@stackwright-pro', 'mcp', 'dist', 'server.js')],\n        env: { NODE_ENV: 'development' },\n      },\n    },\n    // Both OSS and Pro otters are installed as packages - no file copying!\n    agents_path: [\n      'node_modules/@stackwright/otters',      // OSS otters (installed as package)\n      'node_modules/@stackwright-pro/otters'    // Pro otters (installed as package)\n    ],\n  };\n\n  return fs.writeFile(\n    path.join(targetDir, '.code-puppy.json'),\n    JSON.stringify(config, null, 2) + '\\n'\n  );\n}\n\n// ---------------------------------------------------------------------------\n// README generator\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 **EIGHT specialized AI agents** in \\`.stackwright/\\`:\n\n### OSS Pipeline (Visual Design)\n- \\`stackwright-foreman-otter\\` - Orchestrates Brand → Theme → Pages\n- \\`stackwright-brand-otter\\` - Brand discovery through conversation\n- \\`stackwright-theme-otter\\` - Visual design (colors, fonts, spacing)\n- \\`stackwright-page-otter\\` - Content page building\n\n### Pro Pipeline (API Integration)\n- \\`stackwright-pro-foreman-otter\\` - Master coordinator (installed via @stackwright-pro/otters package)\n- \\`stackwright-pro-api-otter\\` - Discovers entities from OpenAPI specs\n- \\`stackwright-pro-data-otter\\` - Configures endpoint filters & ISR\n- \\`stackwright-pro-dashboard-otter\\` - Builds live data dashboards\n\n**Invoke the Foreman to build for you:**\n\n\\`\\`\\`bash\n# OSS: Build a branded static site\ncode-puppy -i -a stackwright-foreman-otter\n\n# Pro: Build a full-stack site with live API data\ncode-puppy -i -a stackwright-pro-foreman-otter\n\\`\\`\\`\n\n**Example prompts:**\n\nOSS Foreman: \"Build me a law firm website with navy and gold colors\"\n\nPro Foreman: \"Build me a logistics dashboard from our OpenAPI spec. Connect to /equipment and /supplies endpoints.\"\n\nThe foreman will orchestrate specialist otters, validate outputs, and render previews.\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# Install dependencies\npnpm install\n\n# Start development server (no auth mock)\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  // ------------------------------------------------------------------\n\n  const scaffoldOpts: ScaffoldOptions = {\n    name: options.name || dirName,\n    title: options.title,\n    theme: options.theme,\n    force: options.force,\n    noInteractive: options.yes,\n  };\n\n  const result = await scaffold(targetDir, scaffoldOpts);\n  console.log(chalk.green('✅ Base project scaffolded'));\n\n  // ------------------------------------------------------------------\n  // 2. Post-process for Pro\n  // ------------------------------------------------------------------\n\n  // c. Replace _app.tsx with pro version (AuthProvider, shadcn, etc.)\n  await copyProTemplate('_app.tsx', path.join(targetDir, 'pages', '_app.tsx'));\n\n  // c. Replace next.config.js with pro version (transpile pro pkgs)\n  await copyProTemplate('next.config.js', path.join(targetDir, 'next.config.js'));\n\n  // d. Add auth section to stackwright.yml\n  await addAuthToStackwrightYml(targetDir);\n\n  // e. 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  // f. Add yaml.d.ts for TypeScript support\n  await copyProTemplate('yaml.d.ts', path.join(targetDir, 'yaml.d.ts'));\n\n  // g. 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  // h. Handle --spec if provided\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    // Handle --mock if provided\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(chalk.yellow('⚠️  No spec provided with --mock. Using sample Petstore spec for demo. Replace with your API spec.'));\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  // b. Inject pro deps + scripts into package.json\n  // Pass specFilename only if --mock is set (Prism needs actual file, not glob)\n  await addProDependencies(targetDir, options.mock ? specInfo?.specFilename : undefined);\n  // ------------------------------------------------------------------\n\n  // 3. Configure code-puppy with otter packages (unless --skip-otters)\n  // ------------------------------------------------------------------\n\n  if (!options.skipOtters) {\n    // Both OSS and Pro otters are installed as npm packages - no file copying!\n    await writeCodePuppyConfig(targetDir);\n    console.log(chalk.green('🦦🦦 Otter packages configured (OSS + Pro)'));\n  }\n\n  // ------------------------------------------------------------------\n  // 4. Generate README\n  // ------------------------------------------------------------------\n\n  const readmeContent = generateReadme({\n    projectName: options.name || dirName,\n    hasSpec: !!specInfo,\n    specName: specInfo?.derivedName,\n    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  // 5. 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. pnpm install'));\n  console.log(chalk.white('  3. pnpm dev          # No auth'));\n  console.log(chalk.white('     pnpm dev:admin    # As admin'));\n  console.log(chalk.white('     pnpm dev:analyst  # As analyst'));\n  console.log(chalk.white('     pnpm dev:viewer   # As viewer'));\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🦦🦦 Want the otter raft to build your site for you?\\n'));\n    console.log(chalk.white('  # OSS: Branded static site'));\n    console.log(chalk.dim('  code-puppy -i -a stackwright-foreman-otter'));\n    console.log(chalk.white('\\n  # Pro: Full-stack with live API data'));\n    console.log(chalk.dim('  code-puppy -i -a stackwright-pro-foreman-otter\\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    .action(async (directory: string, options: LaunchProOptions) => {\n      const targetDir = path.resolve(directory);\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","version","chalk","yaml"]}
+{"version":3,"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@stackwright-pro/launch-stackwright-pro\",\n  \"version\": \"0.2.2\",\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  },\n  \"dependencies\": {\n    \"@stackwright-pro/scaffold-hooks\": \"workspace:*\",\n    \"@stackwright/cli\": \"workspace:*\",\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  }\n}\n","import { Command } from 'commander';\nimport path from 'path';\nimport fs from 'fs-extra';\nimport chalk from 'chalk';\nimport yaml from 'js-yaml';\n\nimport { scaffold, ScaffoldOptions } from '@stackwright/cli';\nimport { registerScaffoldHook } from '@stackwright/scaffold-core';\n\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\nimport { createProScaffoldHooks } from '@stackwright-pro/scaffold-hooks';\ncreateProScaffoldHooks({ registerScaffoldHook });\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  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 **EIGHT specialized AI agents** in \\`.stackwright/\\`:\n\n### OSS Pipeline (Visual Design)\n- \\`stackwright-foreman-otter\\` - Orchestrates Brand → Theme → Pages\n- \\`stackwright-brand-otter\\` - Brand discovery through conversation\n- \\`stackwright-theme-otter\\` - Visual design (colors, fonts, spacing)\n- \\`stackwright-page-otter\\` - Content page building\n\n### Pro Pipeline (API Integration)\n- \\`stackwright-pro-foreman-otter\\` - Master coordinator (installed via @stackwright-pro/otters package)\n- \\`stackwright-pro-api-otter\\` - Discovers entities from OpenAPI specs\n- \\`stackwright-pro-data-otter\\` - Configures endpoint filters & ISR\n- \\`stackwright-pro-dashboard-otter\\` - Builds live data dashboards\n\n**Invoke the Foreman to build for you:**\n\n\\`\\`\\`bash\n# OSS: Build a branded static site\ncode-puppy -i -a stackwright-foreman-otter\n\n# Pro: Build a full-stack site with live API data\ncode-puppy -i -a stackwright-pro-foreman-otter\n\\`\\`\\`\n\n**Example prompts:**\n\nOSS Foreman: \"Build me a law firm website with navy and gold colors\"\n\nPro Foreman: \"Build me a logistics dashboard from our OpenAPI spec. Connect to /equipment and /supplies endpoints.\"\n\nThe foreman will orchestrate specialist otters, validate outputs, and render previews.\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# Install dependencies\npnpm install\n\n# Start development server (no auth mock)\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    title: options.title,\n    theme: options.theme,\n    force: options.force,\n    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  // 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    specName: specInfo?.derivedName,\n    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. pnpm install'));\n  console.log(chalk.white('  3. pnpm dev          # No auth'));\n  console.log(chalk.white('     pnpm dev:admin    # As admin'));\n  console.log(chalk.white('     pnpm dev:analyst  # As analyst'));\n  console.log(chalk.white('     pnpm dev:viewer   # As viewer'));\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🦦🦦 Want the otter raft to build your site for you?\\n'));\n    console.log(chalk.white('  # OSS: Branded static site'));\n    console.log(chalk.dim('  code-puppy -i -a stackwright-foreman-otter'));\n    console.log(chalk.white('\\n  # Pro: Full-stack with live API data'));\n    console.log(chalk.dim('  code-puppy -i -a stackwright-pro-foreman-otter\\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    .action(async (directory: string, options: LaunchProOptions) => {\n      const targetDir = path.resolve(directory);\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,iBAAAA,UAAAC,SAAA;AAAA,IAAAA,QAAA;AAAA,MACE,MAAQ;AAAA,MACR,SAAW;AAAA,MACX,aAAe;AAAA,MACf,SAAW;AAAA,MACX,YAAc;AAAA,QACZ,MAAQ;AAAA,QACR,KAAO;AAAA,MACT;AAAA,MACA,UAAY;AAAA,QACV;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MACA,OAAS;AAAA,QACP;AAAA,QACA;AAAA,MACF;AAAA,MACA,KAAO;AAAA,QACL,0BAA0B;AAAA,MAC5B;AAAA,MACA,SAAW;AAAA,QACT,OAAS;AAAA,QACT,KAAO;AAAA,MACT;AAAA,MACA,cAAgB;AAAA,QACd,mCAAmC;AAAA,QACnC,oBAAoB;AAAA,QACpB,OAAS;AAAA,QACT,WAAa;AAAA,QACb,YAAY;AAAA,QACZ,WAAW;AAAA,MACb;AAAA,MACA,iBAAmB;AAAA,QACjB,mBAAmB;AAAA,QACnB,kBAAkB;AAAA,QAClB,eAAe;AAAA,QACf,YAAc;AAAA,QACd,MAAQ;AAAA,MACV;AAAA,IACF;AAAA;AAAA;;;AC3CA,uBAAwB;AACxB,kBAAiB;AACjB,sBAAe;AACf,mBAAkB;AAClB,qBAAiB;AAEjB,iBAA0C;AAC1C,2BAAqC;AAIrC,4BAAuC;AAAA,IACvC,8CAAuB,EAAE,gEAAqB,CAAC;AAE/C,IAAM,EAAE,QAAQ,IAAI;AAsBpB,eAAe,gBAAgB,cAAsB,UAAiC;AACpF,QAAM,MAAM,YAAAC,QAAK,QAAQ,WAAW,MAAM,aAAa,OAAO,YAAY;AAC1E,QAAM,gBAAAC,QAAG,KAAK,KAAK,QAAQ;AAC7B;AAMA,eAAe,wBAAwB,WAAkC;AACvE,QAAM,UAAU,YAAAD,QAAK,KAAK,WAAW,iBAAiB;AACtD,QAAM,UAAU,MAAM,gBAAAC,QAAG,SAAS,SAAS,OAAO;AAClD,QAAM,SAAS,eAAAC,QAAK,KAAK,OAAO;AAEhC,SAAO,OAAO;AAAA,IACZ,MAAM;AAAA,IACN,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,OAAO;AAAA,MACL,EAAE,MAAM,SAAS,aAAa,CAAC,GAAG,EAAE;AAAA,MACpC,EAAE,MAAM,WAAW,aAAa,CAAC,aAAa,YAAY,EAAE;AAAA,MAC5D,EAAE,MAAM,UAAU,aAAa,CAAC,WAAW,EAAE;AAAA,IAC/C;AAAA,IACA,kBAAkB,CAAC,EAAE,MAAM,MAAM,OAAO,CAAC,UAAU,WAAW,OAAO,EAAE,CAAC;AAAA,IACxE,eAAe,CAAC,KAAK,kBAAkB;AAAA,EACzC;AAEA,QAAM,gBAAAD,QAAG,UAAU,SAAS,eAAAC,QAAK,KAAK,QAAQ,EAAE,WAAW,IAAI,CAAC,CAAC;AACnE;AAEA,eAAe,+BACb,WACA,UACA,cACA,SACe;AACf,QAAM,UAAU,YAAAF,QAAK,KAAK,WAAW,iBAAiB;AACtD,QAAM,UAAU,MAAM,gBAAAC,QAAG,SAAS,SAAS,OAAO;AAClD,QAAM,SAAS,eAAAC,QAAK,KAAK,OAAO;AAEhC,QAAM,cAAuC;AAAA,IAC3C,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM,WAAW,YAAY;AAAA,IAC7B,aAAa,CAAC;AAAA,EAChB;AAEA,MAAI,SAAS;AACX,gBAAY,UAAU;AAAA,EACxB;AAEA,SAAO,eAAe,CAAC,WAAW;AAElC,QAAM,gBAAAD,QAAG,UAAU,SAAS,eAAAC,QAAK,KAAK,QAAQ,EAAE,WAAW,IAAI,CAAC,CAAC;AACnE;AAMA,eAAe,WACb,WACA,UACA,UACwD;AACxD,QAAM,eAAe,YAAAF,QAAK,QAAQ,QAAQ;AAE1C,MAAI,CAAC,gBAAAC,QAAG,WAAW,YAAY,GAAG;AAChC,UAAM,IAAI,MAAM,wBAAwB,YAAY,EAAE;AAAA,EACxD;AAEA,QAAM,eAAe,YAAAD,QAAK,SAAS,YAAY;AAC/C,QAAM,cAAc,YAAY,YAAAA,QAAK,SAAS,cAAc,YAAAA,QAAK,QAAQ,YAAY,CAAC;AAEtF,QAAM,WAAW,YAAAA,QAAK,KAAK,WAAW,OAAO;AAC7C,QAAM,gBAAAC,QAAG,UAAU,QAAQ;AAC3B,QAAM,gBAAAA,QAAG,KAAK,cAAc,YAAAD,QAAK,KAAK,UAAU,YAAY,CAAC;AAE7D,SAAO,EAAE,cAAc,YAAY;AACrC;AAMA,SAAS,eAAe,SAOb;AACT,QAAM,EAAE,aAAa,SAAS,UAAU,cAAc,WAAW,QAAQ,IAAI;AAG7E,QAAM,wBAAwB,UAC1B;AAAA;AAAA,0CAEoC,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA,mBAKnC,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAQR,QAAQ;AAAA;AAAA;AAAA,mBAGR,QAAQ;AAAA,eACZ,SAAU,OAAO,CAAC,EAAE,YAAY,IAAI,SAAU,MAAM,CAAC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAa1D,SAAU,OAAO,CAAC,EAAE,YAAY,IAAI,SAAU,MAAM,CAAC,CAAC,8BAA8B,QAAQ;AAAA,8CACzD,QAAQ;AAAA;AAAA,qBAEjC,SAAU,OAAO,CAAC,EAAE,YAAY,IAAI,SAAU,MAAM,CAAC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOrE;AAGJ,QAAM,cAAc,UAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAeA;AAGJ,QAAM,kBAAkB,YACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAmCA;AAEJ,SAAO,KAAK,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmCvB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA+DX,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmErB,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQjB;AAMA,eAAe,OAAO,WAAmB,SAA0C;AACjF,QAAM,UAAU,YAAAA,QAAK,SAAS,SAAS;AAEvC,UAAQ,IAAI,aAAAG,QAAM,KAAK,KAAK,4CAAqC,CAAC;AAOlE,QAAM,eAAgC;AAAA,IACpC,MAAM,QAAQ,QAAQ;AAAA,IACtB,OAAO,QAAQ;AAAA,IACf,OAAO,QAAQ;AAAA,IACf,OAAO,QAAQ;AAAA,IACf,eAAe,QAAQ;AAAA,EACzB;AAEA,YAAM,qBAAS,WAAW,YAAY;AACtC,UAAQ,IAAI,aAAAA,QAAM,MAAM,oEAA+D,CAAC;AAOxF,QAAM,gBAAgB,YAAY,YAAAH,QAAK,KAAK,WAAW,SAAS,UAAU,CAAC;AAG3E,QAAM,gBAAgB,eAAe,YAAAA,QAAK,KAAK,WAAW,SAAS,aAAa,CAAC;AAGjF,QAAM,gBAAgB,kBAAkB,YAAAA,QAAK,KAAK,WAAW,gBAAgB,CAAC;AAG9E,QAAM,gBAAAC,QAAG,UAAU,YAAAD,QAAK,KAAK,WAAW,KAAK,CAAC;AAC9C,QAAM,gBAAgB,gBAAgB,YAAAA,QAAK,KAAK,WAAW,OAAO,cAAc,CAAC;AAGjF,QAAM,gBAAgB,aAAa,YAAAA,QAAK,KAAK,WAAW,WAAW,CAAC;AAGpE,QAAM,gBAAAC,QAAG,UAAU,YAAAD,QAAK,KAAK,WAAW,SAAS,CAAC;AAClD,QAAM,gBAAgB,eAAe,YAAAA,QAAK,KAAK,WAAW,WAAW,aAAa,CAAC;AAEnF,UAAQ,IAAI,aAAAG,QAAM,MAAM,sDAA+C,CAAC;AAMxE,QAAM,wBAAwB,SAAS;AAMvC,MAAI,WAAiE;AACrE,QAAM,WAAW;AAEjB,MAAI,QAAQ,MAAM;AAChB,eAAW,MAAM,WAAW,WAAW,QAAQ,MAAM,QAAQ,QAAQ;AAGrE,UAAM;AAAA,MACJ;AAAA,MACA,SAAS;AAAA,MACT,SAAS;AAAA,MACT,QAAQ,OAAO,WAAW;AAAA,IAC5B;AACA,YAAQ,IAAI,aAAAA,QAAM,MAAM,wCAAiC,CAAC;AAE1D,QAAI,QAAQ,MAAM;AAChB,cAAQ,IAAI,aAAAA,QAAM,MAAM,wCAAiC,CAAC;AAAA,IAC5D;AAAA,EACF,WAAW,QAAQ,MAAM;AAEvB,YAAQ;AAAA,MACN,aAAAA,QAAM;AAAA,QACJ;AAAA,MACF;AAAA,IACF;AAEA,UAAM,WAAW,YAAAH,QAAK,KAAK,WAAW,OAAO;AAC7C,UAAM,gBAAAC,QAAG,UAAU,QAAQ;AAC3B,UAAM,gBAAgB,iBAAiB,YAAAD,QAAK,KAAK,UAAU,eAAe,CAAC;AAE3E,eAAW,EAAE,cAAc,iBAAiB,aAAa,WAAW;AAEpE,UAAM;AAAA,MACJ;AAAA,MACA,SAAS;AAAA,MACT,SAAS;AAAA,MACT;AAAA,IACF;AACA,YAAQ,IAAI,aAAAG,QAAM,MAAM,yCAAkC,CAAC;AAC3D,YAAQ,IAAI,aAAAA,QAAM,MAAM,wCAAiC,CAAC;AAAA,EAC5D;AAMA,QAAM,gBAAgB,eAAe;AAAA,IACnC,aAAa,QAAQ,QAAQ;AAAA,IAC7B,SAAS,CAAC,CAAC;AAAA,IACX,UAAU,UAAU;AAAA,IACpB,cAAc,UAAU;AAAA,IACxB,WAAW,CAAC,QAAQ;AAAA,IACpB,SAAS,CAAC,CAAC,QAAQ;AAAA,EACrB,CAAC;AAED,QAAM,gBAAAF,QAAG,UAAU,YAAAD,QAAK,KAAK,WAAW,WAAW,GAAG,aAAa;AACnE,UAAQ,IAAI,aAAAG,QAAM,MAAM,6BAAsB,CAAC;AAM/C,QAAM,SAAS,YAAAH,QAAK,SAAS,QAAQ,IAAI,GAAG,SAAS,KAAK;AAE1D,UAAQ,IAAI,aAAAG,QAAM,KAAK,KAAK,gDAAyC,CAAC;AACtE,UAAQ,IAAI,aAAAA,QAAM,MAAM,WAAW,MAAM,EAAE,CAAC;AAC5C,UAAQ,IAAI,aAAAA,QAAM,MAAM,mBAAmB,CAAC;AAC5C,UAAQ,IAAI,aAAAA,QAAM,MAAM,kCAAkC,CAAC;AAC3D,UAAQ,IAAI,aAAAA,QAAM,MAAM,mCAAmC,CAAC;AAC5D,UAAQ,IAAI,aAAAA,QAAM,MAAM,qCAAqC,CAAC;AAC9D,UAAQ,IAAI,aAAAA,QAAM,MAAM,oCAAoC,CAAC;AAE7D,MAAI,UAAU;AACZ,YAAQ,IAAI,aAAAA,QAAM,KAAK;AAAA,8CAA0C,SAAS,YAAY,EAAE,CAAC;AACzF,YAAQ,IAAI,aAAAA,QAAM,IAAI,mEAAmE,CAAC;AAAA,EAC5F;AAEA,MAAI,QAAQ,MAAM;AAChB,YAAQ,IAAI,aAAAA,QAAM,KAAK,mCAA4B,CAAC;AACpD,YAAQ,IAAI,aAAAA,QAAM,MAAM,4CAA4C,CAAC;AAAA,EACvE;AAEA,MAAI,CAAC,QAAQ,YAAY;AACvB,YAAQ,IAAI,aAAAA,QAAM,KAAK,KAAK,wEAA0D,CAAC;AACvF,YAAQ,IAAI,aAAAA,QAAM,MAAM,8BAA8B,CAAC;AACvD,YAAQ,IAAI,aAAAA,QAAM,IAAI,8CAA8C,CAAC;AACrE,YAAQ,IAAI,aAAAA,QAAM,MAAM,0CAA0C,CAAC;AACnE,YAAQ,IAAI,aAAAA,QAAM,IAAI,oDAAoD,CAAC;AAAA,EAC7E;AACF;AAMA,eAAe,OAAsB;AACnC,QAAM,UAAU,IAAI,yBAAQ;AAE5B,UACG,KAAK,wBAAwB,EAC7B,YAAY,uFAAgF,EAC5F,QAAQ,OAAO,EACf,SAAS,eAAe,qBAAqB,GAAG,EAChD,OAAO,iBAAiB,qCAAqC,EAC7D,OAAO,mBAAmB,iDAAiD,EAC3E,OAAO,qBAAqB,+CAA+C,EAC3E,OAAO,WAAW,kDAAkD,EACpE,OAAO,iBAAiB,iCAAiC,EACzD,OAAO,aAAa,gCAAgC,EACpD,OAAO,UAAU,qEAAqE,EACtF;AAAA,IACC;AAAA,IACA;AAAA,EACF,EACC;AAAA,IACC;AAAA,IACA;AAAA,EACF,EACC,OAAO,OAAO,WAAmB,YAA8B;AAC9D,UAAM,YAAY,YAAAH,QAAK,QAAQ,SAAS;AACxC,UAAM,OAAO,WAAW,OAAO;AAAA,EACjC,CAAC;AAEH,QAAM,QAAQ,WAAW,QAAQ,IAAI;AACvC;AAEA,KAAK,EAAE,MAAM,CAAC,QAAiB;AAC7B,UAAQ,MAAM,aAAAG,QAAM,IAAI,yBAAoB,GAAG,GAAG;AAClD,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":["exports","module","path","fs","yaml","chalk"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackwright-pro/launch-stackwright-pro",
-  "version": "0.2.2",
+  "version": "0.3.0-alpha.0",
   "description": "Launch a new Stackwright Pro project with OpenAPI integration, auth, and the otter raft",
   "license": "MIT",
   "repository": {
@@ -23,11 +23,12 @@
     "launch-stackwright-pro": "dist/index.js"
   },
   "dependencies": {
-    "@stackwright/cli": "latest",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "fs-extra": "^11.3",
-    "js-yaml": "^4.1.0"
+    "js-yaml": "^4.1.0",
+    "@stackwright/cli": "0.7.0-alpha.11",
+    "@stackwright-pro/scaffold-hooks": "0.2.0-alpha.0"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0",

package/templates/pro/content.yml

@@ -0,0 +1,11 @@
+content:
+  content_items:
+    - type: main
+      label: hero-section
+      heading:
+        text: Petstore API
+        textSize: h1
+        textColor: secondary
+      textBlocks:
+        - text: Welcome to your new Stackwright Pro project. Edit pages/content.yml to update this page.
+          textSize: h6

package/templates/pro/prebuild.js

@@ -1,16 +1,39 @@
 /**
  * Stackwright Pro prebuild script
  *
- * Reads stackwright.yml integrations and runs the OpenAPI plugin
- * to generate types & client code from API specs before build/dev.
+ * 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.
  */
 
+const { spawn } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 const yaml = require('js-yaml');
 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);
+  });
+}
+
 /**
  * Parse full stackwright.yml using js-yaml for complete config parsing
  */
@@ -28,6 +51,10 @@ async function main() {
       return;
     }
 
+    // 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);