npm - @stackwright-pro/launch-stackwright-pro - Versions diffs - 0.4.0-alpha.13 → 0.4.0-alpha.133 - Mend

@stackwright-pro/launch-stackwright-pro 0.4.0-alpha.13 → 0.4.0-alpha.133

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/LICENSE +21 -0
package/README.md +11 -20
package/dist/index.js +229 -122
package/dist/index.js.map +1 -1
package/package.json +17 -17
package/templates/pro/_app.tsx +14 -4
package/templates/pro/app/slug-page/page.tsx +32 -0
package/templates/pro/content.yml +1 -1
package/templates/pro/next.config.js +3 -0
package/templates/pro/prebuild.js +23 -95
package/templates/pro/pro-providers.tsx +46 -0
package/templates/pro/scripts/pro-content-plugin.js +103 -0

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+PROPRIETARY SOFTWARE LICENSE
+Copyright (c) 2024-2026 Per Aspera LLC. All Rights Reserved.
+This software and associated documentation files (the "Software") are the
+proprietary and confidential property of Per Aspera LLC ("Company").
+RESTRICTIONS: You may not use, copy, modify, merge, publish, distribute,
+sublicense, sell, or otherwise exploit this Software or any portion thereof
+without the express prior written consent of the Company.
+GOVERNMENT USE: Use, duplication, or disclosure by the U.S. Government is
+subject to restrictions as set forth in FAR 52.227-19 (Commercial Computer
+Software - Restricted Rights) and DFARS 252.227-7013 (Rights in Technical
+Data and Computer Software), as applicable.
+THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. IN NO EVENT SHALL THE COMPANY BE LIABLE FOR ANY CLAIM, DAMAGES, OR
+OTHER LIABILITY ARISING FROM THE USE OF THE SOFTWARE.
+For licensing inquiries: legal@peraspera.com

package/README.md CHANGED Viewed

@@ -21,10 +21,14 @@ to automatically wire up Pro features:
 ## Quick Start
 ```bash
-pnpx @stackwright-pro/launch-stackwright-pro my-app -y
+# Works — project created in $cwd/my-app
+pnpx @stackwright-pro/launch-stackwright-pro --name my-app -y
 # Dependencies install automatically (~7s)
 cd my-app
-uvx stackwright-pro-raft   # Start the otter raft
+npx @stackwright-pro/raft   # Start the otter raft
+# Equivalent explicit form
+pnpx @stackwright-pro/launch-stackwright-pro my-app --name my-app -y
 ```
 ### With an OpenAPI Spec
@@ -72,7 +76,7 @@ Options:
   --force              Overwrite existing directory
   --skip-otters        Skip otter raft setup
   -y, --yes            Skip prompts, use defaults
-  --spec <path>        Path to an OpenAPI spec (YAML or JSON)
+  --spec <paths...>    Paths to OpenAPI specs (can be specified multiple times)
   --spec-name <name>   Name for the API integration (default: derived from filename)
   -V, --version        Output the version number
   -h, --help           Display help
@@ -120,24 +124,11 @@ for architecture details, auth deep-dives, and deployment guides.
 ## Starting the Otter Raft
-The otter raft runs in two modes:
-### Interactive Mode (Default)
 ```bash
-python -m stackwright_pro.raft.cli_adapter foreman --spawn
+cd my-app
+npx @stackwright-pro/raft
 ```
-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
-python -m stackwright_pro.raft.cli_adapter foreman --phases
-```
+The raft verifies otter integrity, loads project context from `.stackwright/init-context.json`, and spawns code-puppy in foreman mode. Tell the foreman about your specs in natural language — it coordinates the API, auth, data, and page otters to build your app.
-Executes phases sequentially via the Python state machine. Useful for debugging.
+All state lives in `.stackwright/` — you can interrupt and resume at any time.

package/dist/index.js CHANGED Viewed

@@ -31,9 +31,9 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@stackwright-pro/launch-stackwright-pro",
-      version: "0.4.0-alpha.13",
+      version: "0.4.0-alpha.133",
       description: "Launch a new Stackwright Pro project with OpenAPI integration, auth, and the otter raft",
-      license: "MIT",
+      license: "SEE LICENSE IN LICENSE",
       publishConfig: {
         access: "public"
       },
@@ -69,21 +69,21 @@ var require_package = __commonJS({
         "@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",
+        "@stackwright-pro/scaffold-hooks": "workspace:*",
+        "@stackwright/cli": "^0.9.0",
+        "@stackwright/scaffold-core": "^0.3.3",
         chalk: "^5.6.2",
-        commander: "^14.0.3",
-        "fs-extra": "^11.3",
-        "js-yaml": "^4.1.0"
+        commander: "^15.0.0",
+        "fs-extra": "^11.3.5",
+        "js-yaml": "^4.2.0"
       },
       devDependencies: {
         "@types/fs-extra": "^11.0",
         "@types/js-yaml": "^4.0.9",
-        "@types/node": "^24.0.0",
-        typescript: "^5.0",
-        tsup: "^8.5",
-        vitest: "^4.0.18"
+        "@types/node": "catalog:",
+        tsup: "catalog:",
+        typescript: "catalog:",
+        vitest: "catalog:"
       }
     };
   }
@@ -91,84 +91,77 @@ var require_package = __commonJS({
 // src/index.ts
 var import_commander = require("commander");
-var import_path = __toESM(require("path"));
+var import_path2 = __toESM(require("path"));
 var import_os = __toESM(require("os"));
-var import_fs_extra = __toESM(require("fs-extra"));
+var import_fs_extra2 = __toESM(require("fs-extra"));
 var import_chalk = __toESM(require("chalk"));
-var import_js_yaml = __toESM(require("js-yaml"));
 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/scaffold.ts
+var import_fs_extra = __toESM(require("fs-extra"));
+var import_js_yaml = __toESM(require("js-yaml"));
+var import_path = __toESM(require("path"));
 // src/generated/workspace-versions.ts
 var PRO_VERSIONS = {
-  "@stackwright-pro/auth": "0.1.1-alpha.0",
-  "@stackwright-pro/auth-nextjs": "0.1.1-alpha.0",
-  "@stackwright-pro/mcp": "0.2.0-alpha.3",
-  "@stackwright-pro/openapi": "0.2.2-alpha.2",
-  "@stackwright-pro/otters": "1.0.0-alpha.11"
+  "@stackwright-pro/auth": "0.2.0-alpha.21",
+  "@stackwright-pro/auth-nextjs": "0.3.0-alpha.10",
+  "@stackwright-pro/build-scripts-plugins": "0.1.0-alpha.3",
+  "@stackwright-pro/display-components": "0.2.0-alpha.11",
+  "@stackwright-pro/mcp": "0.2.0-alpha.95",
+  "@stackwright-pro/openapi": "0.3.0-alpha.34",
+  "@stackwright-pro/otters": "1.0.0-alpha.62",
+  "@stackwright-pro/pulse": "0.3.0-alpha.29",
+  "@stackwright-pro/workflow": "0.1.0-alpha.24",
+  "@stackwright-pro/workflow-components": "0.1.0-alpha.26"
 };
 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"
+  "@stackwright/build-scripts": "0.10.0-alpha.0",
+  "@stackwright/collections": "^0.1.2",
+  "@stackwright/core": "^0.10.0",
+  "@stackwright/icons": "^0.5.2",
+  "@stackwright/mcp": "^0.5.0",
+  "@stackwright/nextjs": "^0.6.0",
+  "@stackwright/otters": "^0.2.2",
+  "@stackwright/types": "^1.7.0",
+  "@stackwright/ui-shadcn": "^0.1.3"
 };
-// src/index.ts
-(0, import_scaffold_hooks.registerProScaffoldHooks)();
-var { version } = require_package();
-async function copyProTemplate(templateName, destPath) {
-  const src = import_path.default.resolve(__dirname, "..", "templates", "pro", templateName);
-  await import_fs_extra.default.copy(src, 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, { schema: import_js_yaml.default.CORE_SCHEMA });
-  config.auth = {
-    type: "pki",
-    profile: "dod_cac",
-    source: "gateway_headers",
-    roles: [
-      { name: "ADMIN", permissions: ["*"] },
-      { name: "ANALYST", permissions: ["data:read", "data:write"] },
-      { name: "VIEWER", permissions: ["data:read"] }
-    ],
-    protected_routes: [{ path: "/*", roles: ["VIEWER", "ANALYST", "ADMIN"] }],
-    public_routes: ["/", "/getting-started"]
-  };
-  await import_fs_extra.default.writeFile(ymlPath, import_js_yaml.default.dump(config, { lineWidth: 120 }));
-}
+// src/scaffold.ts
 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 || {};
+  const dependencies = typeof pkg.dependencies === "object" && pkg.dependencies !== null ? { ...pkg.dependencies } : {};
+  const devDependencies = typeof pkg.devDependencies === "object" && pkg.devDependencies !== null ? { ...pkg.devDependencies } : {};
+  const scripts = typeof pkg.scripts === "object" && pkg.scripts !== null ? { ...pkg.scripts } : {};
   for (const [pkgName, pinnedVersion] of Object.entries(OSS_VERSIONS)) {
-    if (dependencies[pkgName] === "workspace:*") {
+    if (pkgName in dependencies) {
       dependencies[pkgName] = pinnedVersion;
     }
-    if (devDependencies[pkgName] === "workspace:*") {
+    if (pkgName in devDependencies) {
       devDependencies[pkgName] = pinnedVersion;
     }
   }
   Object.assign(dependencies, {
-    "@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"],
-    zod: "^3.23.0"
+    "@stackwright-pro/build-scripts-plugins": PRO_VERSIONS["@stackwright-pro/build-scripts-plugins"],
+    "@stackwright-pro/display-components": PRO_VERSIONS["@stackwright-pro/display-components"],
+    "@stackwright-pro/mcp": PRO_VERSIONS["@stackwright-pro/mcp"],
+    "@stackwright-pro/openapi": PRO_VERSIONS["@stackwright-pro/openapi"],
+    "@stackwright-pro/otters": PRO_VERSIONS["@stackwright-pro/otters"],
+    "@stackwright-pro/pulse": PRO_VERSIONS["@stackwright-pro/pulse"],
+    "@stackwright-pro/workflow": PRO_VERSIONS["@stackwright-pro/workflow"],
+    "@stackwright-pro/workflow-components": PRO_VERSIONS["@stackwright-pro/workflow-components"],
+    "@stackwright/build-scripts": OSS_VERSIONS["@stackwright/build-scripts"],
+    zod: "^4.0.0"
   });
   Object.assign(devDependencies, {
-    "@stoplight/prism-cli": "^5.14.2"
+    "@stoplight/prism-cli": "^5.15.10"
   });
   Object.assign(scripts, {
     "dev:admin": "MOCK_USER=admin next dev",
@@ -182,6 +175,13 @@ async function addProDepsToPackageJson(targetDir) {
   pkg.scripts = scripts;
   await import_fs_extra.default.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
 }
+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, { schema: import_js_yaml.default.CORE_SCHEMA });
+  config.auth = {};
+  await import_fs_extra.default.writeFile(ymlPath, import_js_yaml.default.dump(config, { lineWidth: 120 }));
+}
 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");
@@ -195,20 +195,71 @@ async function addIntegrationToStackwrightYml(targetDir, specName, specFilename,
   if (mockUrl) {
     integration.mockUrl = mockUrl;
   }
-  config.integrations = [integration];
+  config.integrations = [
+    ...Array.isArray(config.integrations) ? config.integrations : [],
+    integration
+  ];
   await import_fs_extra.default.writeFile(ymlPath, import_js_yaml.default.dump(config, { lineWidth: 120 }));
 }
-async function handleSpec(targetDir, specPath, specName) {
-  const resolvedSpec = import_path.default.resolve(specPath);
-  if (!import_fs_extra.default.existsSync(resolvedSpec)) {
-    throw new Error(`Spec file not found: ${resolvedSpec}`);
+async function scaffoldWorkspaceConfig(targetDir) {
+  const workspaceDir = import_path.default.join(targetDir, ".code_puppy");
+  await import_fs_extra.default.ensureDir(workspaceDir);
+  const workspaceStats = await import_fs_extra.default.lstat(workspaceDir);
+  if (workspaceStats.isSymbolicLink()) {
+    throw new Error(".code_puppy/ is a symlink \u2014 refusing to write. Check for tampering.");
+  }
+  const agentsDir = import_path.default.join(workspaceDir, "agents");
+  await import_fs_extra.default.ensureDir(agentsDir);
+  if (await import_fs_extra.default.pathExists(agentsDir)) {
+    const agentsStats = await import_fs_extra.default.lstat(agentsDir);
+    if (agentsStats.isSymbolicLink()) {
+      throw new Error(".code_puppy/agents is a symlink \u2014 refusing to write. Check for tampering.");
+    }
+  }
+  const configPath = import_path.default.join(workspaceDir, "config.json");
+  let existingConfig = {};
+  if (import_fs_extra.default.existsSync(configPath)) {
+    try {
+      existingConfig = JSON.parse(await import_fs_extra.default.readFile(configPath, "utf-8"));
+    } catch {
+    }
+  }
+  if (await import_fs_extra.default.pathExists(configPath)) {
+    const configStats = await import_fs_extra.default.lstat(configPath);
+    if (configStats.isSymbolicLink()) {
+      throw new Error(
+        ".code_puppy/config.json is a symlink \u2014 refusing to write. Check for tampering."
+      );
+    }
+  }
+  await import_fs_extra.default.writeFile(
+    configPath,
+    JSON.stringify({ ...existingConfig, projectOnly: true }, null, 2) + "\n",
+    "utf-8"
+  );
+  const mcpServersPath = import_path.default.join(workspaceDir, "mcp_servers.json");
+  if (await import_fs_extra.default.pathExists(mcpServersPath)) {
+    const mcpStats = await import_fs_extra.default.lstat(mcpServersPath);
+    if (mcpStats.isSymbolicLink()) {
+      throw new Error(
+        ".code_puppy/mcp_servers.json is a symlink \u2014 refusing to write. Check for tampering."
+      );
+    }
+  }
+  if (!import_fs_extra.default.existsSync(mcpServersPath)) {
+    const mcpConfig = {
+      mcp_servers: {
+        "stackwright-pro-mcp": {
+          type: "stdio",
+          command: "pnpm",
+          args: ["exec", "stackwright-pro-mcp"],
+          enabled: true,
+          cwd: "${PROJECT_ROOT}"
+        }
+      }
+    };
+    await import_fs_extra.default.writeFile(mcpServersPath, JSON.stringify(mcpConfig, null, 2) + "\n", "utf-8");
   }
-  const specFilename = import_path.default.basename(resolvedSpec);
-  const derivedName = specName || import_path.default.basename(specFilename, import_path.default.extname(specFilename));
-  const specsDir = import_path.default.join(targetDir, "specs");
-  await import_fs_extra.default.ensureDir(specsDir);
-  await import_fs_extra.default.copy(resolvedSpec, import_path.default.join(specsDir, specFilename));
-  return { specFilename, derivedName };
 }
 function generateReadme(options) {
   const { projectName, hasSpec, specName, specFilename, hasOtters, hasMock } = options;
@@ -231,7 +282,7 @@ export const EquipmentSchema = z.object({
 export type Equipment = z.infer<typeof EquipmentSchema>;
 // src/generated/${specName}/client.ts
-export class ${specName.charAt(0).toUpperCase() + specName.slice(1)}Client {
+export class ${(specName ?? "api").charAt(0).toUpperCase() + (specName ?? "api").slice(1)}Client {
   async getEquipment(id: string): Promise<Equipment> {
     // Auto-wired with auth, validation, error handling
   }
@@ -244,10 +295,10 @@ export class ${specName.charAt(0).toUpperCase() + specName.slice(1)}Client {
 3. You import and use it:
 \`\`\`typescript
-import { ${specName.charAt(0).toUpperCase() + specName.slice(1)}Client } from '@/generated/${specName}/client';
+import { ${(specName ?? "api").charAt(0).toUpperCase() + (specName ?? "api").slice(1)}Client } from '@/generated/${specName}/client';
 import type { Equipment } from '@/generated/${specName}/types';
-const client = new ${specName.charAt(0).toUpperCase() + specName.slice(1)}Client();
+const client = new ${(specName ?? "api").charAt(0).toUpperCase() + (specName ?? "api").slice(1)}Client();
 const gear: Equipment = await client.getEquipment('123');
 \`\`\`
@@ -283,12 +334,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_adapter 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:**
@@ -331,12 +380,16 @@ ${mockSection}## \u{1F4C1} Project Structure
 \`\`\`
 .
+\u251C\u2500\u2500 app/
+\u2502   \u251C\u2500\u2500 layout.tsx             # Root layout (StackwrightLayout + Providers)
+\u2502   \u251C\u2500\u2500 page.tsx               # Home page (renders root content)
+\u2502   \u251C\u2500\u2500 [...slug]/
+\u2502   \u2502   \u2514\u2500\u2500 page.tsx           # Dynamic pages from YAML content
+\u2502   \u2514\u2500\u2500 _components/
+\u2502       \u251C\u2500\u2500 providers.tsx      # Pro: AuthProvider + component registration
+\u2502       \u2514\u2500\u2500 page-client.tsx    # Client-side page renderer
 \u251C\u2500\u2500 pages/
-\u2502   \u251C\u2500\u2500 _app.tsx               # Pro version with AuthProvider + shadcn
-\u2502   \u251C\u2500\u2500 index.tsx              # Home page (auto-generated by Stackwright)
-\u2502   \u251C\u2500\u2500 about/
-\u2502   \u2502   \u2514\u2500\u2500 content.yml        # Page content in YAML
-\u2502   \u2514\u2500\u2500 ...
+\u2502   \u2514\u2500\u2500 content.yml            # Root page content in YAML
 \u251C\u2500\u2500 lib/
 \u2502   \u2514\u2500\u2500 mock-auth.ts           # Dev-only auth mocking (no backend needed)
 \u251C\u2500\u2500 scripts/
@@ -356,7 +409,7 @@ ${mockSection}## \u{1F4C1} Project Structure
 \`\`\`
 **Key Files:**
-- \`pages/_app.tsx\` - Wraps your app with \`AuthProvider\` for RBAC
+- \`app/_components/providers.tsx\` - Wraps your app with \`AuthProvider\` for RBAC
 - \`stackwright.yml\` - Single source of truth for theme, auth roles, and API wiring
 - \`lib/mock-auth.ts\` - Mocks CAC/PIV headers locally so you can test auth flows
 - \`scripts/prebuild.js\` - Runs before dev/build to generate types from your OpenAPI spec
@@ -466,8 +519,28 @@ ${aiAgentsSection}## \u{1F4DA} Learn More
 **Questions?** File an issue or ping us in the discussions. We're here to help you ship faster.
 `;
 }
+// src/index.ts
+(0, import_scaffold_hooks.registerProScaffoldHooks)();
+var { version } = require_package();
+async function copyProTemplate(templateName, destPath) {
+  const src = import_path2.default.resolve(__dirname, "..", "templates", "pro", templateName);
+  await import_fs_extra2.default.copy(src, destPath);
+}
+async function handleSpec(targetDir, specPath, specName) {
+  const resolvedSpec = import_path2.default.resolve(specPath);
+  if (!import_fs_extra2.default.existsSync(resolvedSpec)) {
+    throw new Error(`Spec file not found: ${resolvedSpec}`);
+  }
+  const specFilename = import_path2.default.basename(resolvedSpec);
+  const derivedName = specName || import_path2.default.basename(specFilename, import_path2.default.extname(specFilename));
+  const specsDir = import_path2.default.join(targetDir, "specs");
+  await import_fs_extra2.default.ensureDir(specsDir);
+  await import_fs_extra2.default.copy(resolvedSpec, import_path2.default.join(specsDir, specFilename));
+  return { specFilename, derivedName };
+}
 async function launch(targetDir, options) {
-  const dirName = import_path.default.basename(targetDir);
+  const dirName = import_path2.default.basename(targetDir);
   console.log(import_chalk.default.cyan.bold("\n\u{1F6A2} Launching Stackwright Pro...\n"));
   const scaffoldOpts = {
     name: options.name || dirName,
@@ -483,11 +556,11 @@ async function launch(targetDir, options) {
   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")
+    await import_fs_extra2.default.readFile(import_path2.default.join(targetDir, "package.json"), "utf-8")
   );
-  const proDepCount = Object.keys(verifyPkg.dependencies || {}).filter(
-    (k) => k.startsWith("@stackwright-pro")
-  ).length;
+  const proDepCount = Object.keys(
+    typeof verifyPkg.dependencies === "object" && verifyPkg.dependencies !== null ? 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) {
@@ -522,33 +595,47 @@ async function launch(targetDir, options) {
   const dependencyMode = "standalone";
   await (0, import_scaffold_core.runScaffoldHooks)("postInstall", {
     targetDir,
-    projectName: options.name || import_path.default.basename(targetDir),
-    siteTitle: options.title || options.name || import_path.default.basename(targetDir),
+    projectName: options.name || import_path2.default.basename(targetDir),
+    siteTitle: options.title || options.name || import_path2.default.basename(targetDir),
     themeId: options.theme || "corporate",
     packageJson: {},
     dependencyMode
   });
-  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 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 copyProTemplate(
+    "pro-providers.tsx",
+    import_path2.default.join(targetDir, "app", "_components", "providers.tsx")
+  );
+  await copyProTemplate("content.yml", import_path2.default.join(targetDir, "pages", "content.yml"));
+  await copyProTemplate("next.config.js", import_path2.default.join(targetDir, "next.config.js"));
+  await import_fs_extra2.default.ensureDir(import_path2.default.join(targetDir, "lib"));
+  await copyProTemplate("mock-auth.ts", import_path2.default.join(targetDir, "lib", "mock-auth.ts"));
+  await copyProTemplate("yaml.d.ts", import_path2.default.join(targetDir, "yaml.d.ts"));
+  await import_fs_extra2.default.ensureDir(import_path2.default.join(targetDir, "scripts"));
+  await copyProTemplate("prebuild.js", import_path2.default.join(targetDir, "scripts", "prebuild.js"));
+  await copyProTemplate(
+    "scripts/pro-content-plugin.js",
+    import_path2.default.join(targetDir, "scripts", "pro-content-plugin.js")
+  );
+  await import_fs_extra2.default.ensureDir(import_path2.default.join(targetDir, "app", "[...slug]"));
+  await copyProTemplate(
+    "app/slug-page/page.tsx",
+    import_path2.default.join(targetDir, "app", "[...slug]", "page.tsx")
+  );
+  console.log(import_chalk.default.green(" Auth integration added (App Router providers + RBAC)"));
   await addAuthToStackwrightYml(targetDir);
   let specInfo = null;
   const MOCK_URL = "http://localhost:4010";
-  if (options.spec) {
-    specInfo = await handleSpec(targetDir, options.spec, options.specName);
-    await addIntegrationToStackwrightYml(
-      targetDir,
-      specInfo.derivedName,
-      specInfo.specFilename,
-      options.mock ? MOCK_URL : void 0
-    );
-    console.log(import_chalk.default.green("\u{1F4E1} OpenAPI integration wired up"));
+  if (options.spec && options.spec.length > 0) {
+    for (const specPath of options.spec) {
+      specInfo = await handleSpec(targetDir, specPath, options.specName);
+      await addIntegrationToStackwrightYml(
+        targetDir,
+        specInfo.derivedName,
+        specInfo.specFilename,
+        options.mock ? MOCK_URL : void 0
+      );
+    }
+    console.log(import_chalk.default.green(`\u{1F4E1} ${options.spec.length} OpenAPI integration(s) wired up`));
     if (options.mock) {
       console.log(import_chalk.default.green("\u{1F3AD} Prism mock server configured"));
     }
@@ -558,9 +645,9 @@ async function launch(targetDir, options) {
         "\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"));
+    const specsDir = import_path2.default.join(targetDir, "specs");
+    await import_fs_extra2.default.ensureDir(specsDir);
+    await copyProTemplate("petstore.yaml", import_path2.default.join(specsDir, "petstore.yaml"));
     specInfo = { specFilename: "petstore.yaml", derivedName: "petstore" };
     await addIntegrationToStackwrightYml(
       targetDir,
@@ -579,13 +666,33 @@ async function launch(targetDir, options) {
     hasOtters: !options.skipOtters,
     hasMock: !!options.mock
   });
-  await import_fs_extra.default.writeFile(import_path.default.join(targetDir, "README.md"), readmeContent);
+  await import_fs_extra2.default.writeFile(import_path2.default.join(targetDir, "README.md"), readmeContent);
   console.log(import_chalk.default.green("\u{1F4C4} README.md created"));
-  const relDir = import_path.default.relative(process.cwd(), targetDir) || ".";
+  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_path2.default.join(targetDir, ".stackwright");
+  await import_fs_extra2.default.ensureDir(stackwrightDir);
+  await import_fs_extra2.default.writeFile(
+    import_path2.default.join(stackwrightDir, "init-context.json"),
+    JSON.stringify(initContext, null, 2) + "\n",
+    "utf-8"
+  );
+  await scaffoldWorkspaceConfig(targetDir);
+  console.log(import_chalk.default.green("\u{1F43E} .code_puppy/ workspace scaffolded (projectOnly: true)"));
+  const relDir = import_path2.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_adapter 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}`));
@@ -603,8 +710,8 @@ async function launch(targetDir, options) {
 async function main() {
   const program = new import_commander.Command();
   program.name("launch-stackwright-pro").description("\u{1F6A2} Launch a new Stackwright Pro project with auth, OpenAPI, and the otter raft").version(version).argument("[directory]", "Project directory", ".").option("--name <name>", "Project name (used in package.json)").option("--title <title>", "Site title shown in the app bar and browser tab").option("--theme <themeId>", "Theme ID (e.g., corporate, creative, minimal)").option("--force", "Launch even if the target directory is not empty").option("--skip-otters", "Skip copying otter raft configs").option("-y, --yes", "Skip all prompts, use defaults").option("--mock", "Configure Prism mock server for API development (runs on port 4010)").option(
-    "--spec <path>",
-    "Path to an OpenAPI spec (YAML or JSON) \u2014 copies into project and wires up integration"
+    "--spec <paths...>",
+    "Paths to OpenAPI specs (YAML or JSON) \u2014 copies into project and wires up integrations (can be specified multiple times)"
   ).option(
     "--spec-name <name>",
     "Name for the API integration (default: derived from spec filename)"
@@ -613,8 +720,8 @@ async function main() {
     "Skip automatic pnpm install (useful in CI or when using a different package manager)"
   ).action(async (directory, options) => {
     const homeDir = import_os.default.homedir();
-    const targetDir = import_path.default.resolve(directory);
-    if (!targetDir.startsWith(homeDir + import_path.default.sep) && targetDir !== homeDir) {
+    const targetDir = directory !== "." ? import_path2.default.resolve(process.cwd(), directory) : options.name ? import_path2.default.resolve(process.cwd(), options.name) : process.cwd();
+    if (!targetDir.startsWith(homeDir + import_path2.default.sep) && targetDir !== homeDir) {
       console.warn(import_chalk.default.yellow(`\u26A0\uFE0F  Scaffolding outside your home directory: ${targetDir}`));
     }
     await launch(targetDir, options);

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"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.13\",\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/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 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\nWhat 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\nHow 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\nStart the otter raft:\n\n\\`\\`\\`bash\nuvx stackwright-pro-raft\n\\`\\`\\`\n\n> Local dev (before PyPI publish): \\`python -m stackwright_pro.raft.cli_adapter 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\nExample 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\nHow 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\nPro 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\nKey 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\nExample: 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\nGate 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\nRoute 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\nQuestions? 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 // 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_adapter 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","// AUTO-GENERATED — do not edit manually.\n// Run `pnpm sync-versions` or `pnpm build` to regenerate.\n// Generated: 2026-04-21T13:35:30.893Z\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.1.1-alpha.0',\n '@stackwright-pro/auth-nextjs': '0.1.1-alpha.0',\n '@stackwright-pro/mcp': '0.2.0-alpha.3',\n '@stackwright-pro/openapi': '0.2.2-alpha.2',\n '@stackwright-pro/otters': '1.0.0-alpha.11',\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"]}
1	+ {"version":3,"sources":["../package.json","../src/index.ts","../src/scaffold.ts","../src/generated/workspace-versions.ts"],"sourcesContent":["{\n \"name\": \"@stackwright-pro/launch-stackwright-pro\",\n \"version\": \"0.4.0-alpha.133\",\n \"description\": \"Launch a new Stackwright Pro project with OpenAPI integration, auth, and the otter raft\",\n \"license\": \"SEE LICENSE IN LICENSE\",\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\": \"workspace:\",\n \"@stackwright/cli\": \"^0.9.0\",\n \"@stackwright/scaffold-core\": \"^0.3.3\",\n \"chalk\": \"^5.6.2\",\n \"commander\": \"^15.0.0\",\n \"fs-extra\": \"^11.3.5\",\n \"js-yaml\": \"^4.2.0\"\n },\n \"devDependencies\": {\n \"@types/fs-extra\": \"^11.0\",\n \"@types/js-yaml\": \"^4.0.9\",\n \"@types/node\": \"catalog:\",\n \"tsup\": \"catalog:\",\n \"typescript\": \"catalog:\",\n \"vitest\": \"catalog:\"\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 { 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 {\n addProDepsToPackageJson,\n addAuthToStackwrightYml,\n scaffoldWorkspaceConfig,\n addIntegrationToStackwrightYml,\n generateReadme,\n} from './scaffold.js';\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// 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// 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, unknown>;\n const proDepCount = Object.keys(\n typeof verifyPkg.dependencies === 'object' && verifyPkg.dependencies !== null\n ? (verifyPkg.dependencies as Record<string, string>)\n : {}\n ).filter((k) => k.startsWith('@stackwright-pro')).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 providers.tsx with Pro version (AuthProvider, Pro component registration)\n // Pro integrates into the App Router layout — NOT the Pages Router _app.tsx.\n // Putting _app.tsx in pages/ triggers Next.js 16 Pages Router mode which fails\n // on missing _document (see swp-srp / GH scaffold smoke test).\n await copyProTemplate(\n 'pro-providers.tsx',\n path.join(targetDir, 'app', '_components', 'providers.tsx')\n );\n\n // Add root content.yml for the home page\n // Goes in pages/ for Stackwright's content system — this is a YAML data file,\n // not a Next.js page module, so it does NOT trigger Pages Router mode.\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 + scripts/pro-content-plugin.js\n await fs.ensureDir(path.join(targetDir, 'scripts'));\n await copyProTemplate('prebuild.js', path.join(targetDir, 'scripts', 'prebuild.js'));\n await copyProTemplate(\n 'scripts/pro-content-plugin.js',\n path.join(targetDir, 'scripts', 'pro-content-plugin.js')\n );\n\n // Override app/[...slug]/page.tsx with Pro version that filters _-prefixed data-sink slugs.\n // The OSS scaffold's generateStackwrightStaticParams returns _auth.json, _collections.json,\n // etc. as routes (they're in public/stackwright-content/ but not in RESERVED_FILES).\n // The Pro version wraps that function to filter them out.\n await fs.ensureDir(path.join(targetDir, 'app', '[...slug]'));\n await copyProTemplate(\n 'app/slug-page/page.tsx',\n path.join(targetDir, 'app', '[...slug]', 'page.tsx')\n );\n\n console.log(chalk.green(' Auth integration added (App Router providers + RBAC)'));\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 && options.spec.length > 0) {\n for (const specPath of options.spec) {\n specInfo = await handleSpec(targetDir, specPath, options.specName);\n await addIntegrationToStackwrightYml(\n targetDir,\n specInfo.derivedName,\n specInfo.specFilename,\n options.mock ? MOCK_URL : undefined\n );\n }\n console.log(chalk.green(`📡 ${options.spec.length} OpenAPI integration(s) wired up`));\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 // 5c. Scaffold .code_puppy/ workspace directory\n // Creates config.json (projectOnly: true), mcp_servers.json,\n // and agents/ dir. raft-puppy discovers this via walk-up from cwd\n // on first startup — no CLI flags needed.\n // ------------------------------------------------------------------\n\n await scaffoldWorkspaceConfig(targetDir);\n console.log(chalk.green('🐾 .code_puppy/ workspace scaffolded (projectOnly: true)'));\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 <paths...>',\n 'Paths to OpenAPI specs (YAML or JSON) — copies into project and wires up integrations (can be specified multiple times)'\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 =\n directory !== '.'\n ? path.resolve(process.cwd(), directory)\n : options.name\n ? path.resolve(process.cwd(), options.name)\n : process.cwd(); // last resort — same as old behaviour, only hit if neither arg nor --name\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","/*\n scaffold.ts — Pro-specific scaffold mutation helpers\n \n Extracted from src/index.ts so these pure filesystem transforms can be\n * imported and tested independently (no __dirname, no fs.copy, no chalk).\n \n Every function here:\n * - Accepts a targetDir and operates on real files\n * - Is async/await throughout\n * - Has no side effects beyond writing to targetDir\n * - Is fully unit-testable with a real temp filesystem\n /\n\nimport fs from 'fs-extra';\nimport yaml from 'js-yaml';\nimport path from 'path';\nimport { PRO_VERSIONS, OSS_VERSIONS } from './generated/workspace-versions.js';\n\n// ---------------------------------------------------------------------------\n// Package.json mutations\n// ---------------------------------------------------------------------------\n\n/\n Inject Pro runtime dependencies and scripts into an existing package.json.\n * Enforces OSS version floors and adds Pro-specific dev scripts (prebuild/predev).\n * Safe to call multiple times — idempotent for dep keys.\n /\nexport async 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, unknown>;\n\n const dependencies: Record<string, string> =\n typeof pkg.dependencies === 'object' && pkg.dependencies !== null\n ? { ...(pkg.dependencies as Record<string, string>) }\n : {};\n const devDependencies: Record<string, string> =\n typeof pkg.devDependencies === 'object' && pkg.devDependencies !== null\n ? { ...(pkg.devDependencies as Record<string, string>) }\n : {};\n const scripts: Record<string, string> =\n typeof pkg.scripts === 'object' && pkg.scripts !== null\n ? { ...(pkg.scripts as Record<string, string>) }\n : {};\n\n // Enforce OSS version floors — replace workspace: refs AND upgrade any stale version\n // pinned by the OSS scaffold template to our tested minimum.\n // OSS_VERSIONS = \"minimum tested versions\" — we always want them to win.\n for (const [pkgName, pinnedVersion] of Object.entries(OSS_VERSIONS)) {\n if (pkgName in dependencies) {\n dependencies[pkgName] = pinnedVersion;\n }\n if (pkgName in devDependencies) {\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/auth': PRO_VERSIONS['@stackwright-pro/auth'],\n '@stackwright-pro/auth-nextjs': PRO_VERSIONS['@stackwright-pro/auth-nextjs'],\n '@stackwright-pro/build-scripts-plugins':\n PRO_VERSIONS['@stackwright-pro/build-scripts-plugins'],\n '@stackwright-pro/display-components': PRO_VERSIONS['@stackwright-pro/display-components'],\n '@stackwright-pro/mcp': PRO_VERSIONS['@stackwright-pro/mcp'],\n '@stackwright-pro/openapi': PRO_VERSIONS['@stackwright-pro/openapi'],\n '@stackwright-pro/otters': PRO_VERSIONS['@stackwright-pro/otters'],\n '@stackwright-pro/pulse': PRO_VERSIONS['@stackwright-pro/pulse'],\n '@stackwright-pro/workflow': PRO_VERSIONS['@stackwright-pro/workflow'],\n '@stackwright-pro/workflow-components': PRO_VERSIONS['@stackwright-pro/workflow-components'],\n '@stackwright/build-scripts': OSS_VERSIONS['@stackwright/build-scripts'],\n zod: '^4.0.0',\n });\n\n // Pro dev dependencies\n Object.assign(devDependencies, {\n '@stoplight/prism-cli': '^5.15.10',\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\n// ---------------------------------------------------------------------------\n// stackwright.yml mutations\n// ---------------------------------------------------------------------------\n\n/*\n Add an empty `auth:` key to an existing stackwright.yml.\n * The auth key is the hook point for Pro RBAC configuration.\n /\nexport async 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\n await fs.writeFile(ymlPath, yaml.dump(config, { lineWidth: 120 }));\n}\n\n/\n Append an OpenAPI integration entry to the `integrations:` array in stackwright.yml.\n * Creates the array if it does not exist. Safe to call multiple times for different specs.\n /\nexport async 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 = [\n ...(Array.isArray(config.integrations) ? config.integrations : []),\n integration,\n ];\n\n await fs.writeFile(ymlPath, yaml.dump(config, { lineWidth: 120 }));\n}\n\n// ---------------------------------------------------------------------------\n// .code_puppy/ workspace config scaffolding\n// ---------------------------------------------------------------------------\n\n/\n Create (or idempotently update) the .code_puppy/ workspace directory.\n \n Creates:\n * - .code_puppy/config.json { projectOnly: true } (merges with existing)\n * - .code_puppy/mcp_servers.json stackwright-pro-mcp stdio server entry\n * - .code_puppy/agents/ empty directory for future agent configs\n \n Symlink guard: refuses to write if any of the managed paths is a symlink,\n * consistent with raft/src/lib.ts ensureWorkspaceConfig.\n /\nexport async function scaffoldWorkspaceConfig(targetDir: string): Promise<void> {\n const workspaceDir = path.join(targetDir, '.code_puppy');\n await fs.ensureDir(workspaceDir);\n // Symlink guard — consistent with raft/src/lib.ts ensureWorkspaceConfig\n const workspaceStats = await fs.lstat(workspaceDir);\n if (workspaceStats.isSymbolicLink()) {\n throw new Error('.code_puppy/ is a symlink — refusing to write. Check for tampering.');\n }\n\n const agentsDir = path.join(workspaceDir, 'agents');\n await fs.ensureDir(agentsDir);\n if (await fs.pathExists(agentsDir)) {\n const agentsStats = await fs.lstat(agentsDir);\n if (agentsStats.isSymbolicLink()) {\n throw new Error('.code_puppy/agents is a symlink — refusing to write. Check for tampering.');\n }\n }\n\n // config.json — projectOnly: true\n // Merge with existing so we don't clobber user customizations on re-scaffold\n const configPath = path.join(workspaceDir, 'config.json');\n let existingConfig: Record<string, unknown> = {};\n if (fs.existsSync(configPath)) {\n try {\n existingConfig = JSON.parse(await fs.readFile(configPath, 'utf-8')) as Record<\n string,\n unknown\n >;\n } catch {\n // Malformed — start fresh\n }\n }\n if (await fs.pathExists(configPath)) {\n const configStats = await fs.lstat(configPath);\n if (configStats.isSymbolicLink()) {\n throw new Error(\n '.code_puppy/config.json is a symlink — refusing to write. Check for tampering.'\n );\n }\n }\n await fs.writeFile(\n configPath,\n JSON.stringify({ ...existingConfig, projectOnly: true }, null, 2) + '\\n',\n 'utf-8'\n );\n\n // mcp_servers.json — pnpm-based stackwright-pro-mcp server\n // ${PROJECT_ROOT} is a literal — raft-puppy expands it at runtime to the\n // directory containing .code_puppy/ (walk-up discovery root).\n const mcpServersPath = path.join(workspaceDir, 'mcp_servers.json');\n if (await fs.pathExists(mcpServersPath)) {\n const mcpStats = await fs.lstat(mcpServersPath);\n if (mcpStats.isSymbolicLink()) {\n throw new Error(\n '.code_puppy/mcp_servers.json is a symlink — refusing to write. Check for tampering.'\n );\n }\n }\n if (!fs.existsSync(mcpServersPath)) {\n const mcpConfig = {\n mcp_servers: {\n 'stackwright-pro-mcp': {\n type: 'stdio',\n command: 'pnpm',\n args: ['exec', 'stackwright-pro-mcp'],\n enabled: true,\n cwd: '${PROJECT_ROOT}',\n },\n },\n };\n await fs.writeFile(mcpServersPath, JSON.stringify(mcpConfig, null, 2) + '\\n', 'utf-8');\n }\n}\n\n// ---------------------------------------------------------------------------\n// README generation\n// ---------------------------------------------------------------------------\n\nexport interface GenerateReadmeOptions {\n projectName: string;\n hasSpec: boolean;\n specName?: string;\n specFilename?: string;\n hasOtters: boolean;\n hasMock: boolean;\n}\n\n/\n Generate a project README.md with conditional sections based on which\n * Pro features are enabled (spec, mock server, otter raft).\n /\nexport function generateReadme(options: GenerateReadmeOptions): 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\\nWhat 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 ?? 'api').charAt(0).toUpperCase() + (specName ?? 'api').slice(1)}Client {\\n async getEquipment(id: string): Promise<Equipment> {\\n // Auto-wired with auth, validation, error handling\\n }\\n}\\n\\`\\`\\`\\n\\nHow 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 ?? 'api').charAt(0).toUpperCase() + (specName ?? 'api').slice(1)}Client } from '@/generated/${specName}/client';\\nimport type { Equipment } from '@/generated/${specName}/types';\\n\\nconst client = new ${(specName ?? 'api').charAt(0).toUpperCase() + (specName ?? 'api').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\\nStart 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\\nExample 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\\nHow 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\\nPro tip:* Test your UI for all three roles to ensure proper permissions enforcement.\\n\\n${mockSection}## 📁 Project Structure\\n\\n\\`\\`\\`\\n.\\n├── app/\\n│ ├── layout.tsx # Root layout (StackwrightLayout + Providers)\\n│ ├── page.tsx # Home page (renders root content)\\n│ ├── [...slug]/\\n│ │ └── page.tsx # Dynamic pages from YAML content\\n│ └── _components/\\n│ ├── providers.tsx # Pro: AuthProvider + component registration\\n│ └── page-client.tsx # Client-side page renderer\\n├── pages/\\n│ └── content.yml # Root page content in YAML\\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\\nKey Files:\\n- \\`app/_components/providers.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\\nExample: 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\\nGate 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\\nRoute 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\\nQuestions? File an issue or ping us in the discussions. We're here to help you ship faster.\\n`;\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.21',\n '@stackwright-pro/auth-nextjs': '0.3.0-alpha.10',\n '@stackwright-pro/build-scripts-plugins': '0.1.0-alpha.3',\n '@stackwright-pro/display-components': '0.2.0-alpha.11',\n '@stackwright-pro/mcp': '0.2.0-alpha.95',\n '@stackwright-pro/openapi': '0.3.0-alpha.34',\n '@stackwright-pro/otters': '1.0.0-alpha.62',\n '@stackwright-pro/pulse': '0.3.0-alpha.29',\n '@stackwright-pro/workflow': '0.1.0-alpha.24',\n '@stackwright-pro/workflow-components': '0.1.0-alpha.26',\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.10.0-alpha.0',\n '@stackwright/collections': '^0.1.2',\n '@stackwright/core': '^0.10.0',\n '@stackwright/icons': '^0.5.2',\n '@stackwright/mcp': '^0.5.0',\n '@stackwright/nextjs': '^0.6.0',\n '@stackwright/otters': '^0.2.2',\n '@stackwright/types': '^1.7.0',\n '@stackwright/ui-shadcn': '^0.1.3',\n} as const satisfies Record<string, string>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,iBAAAA,UAAAC,SAAA;AAAA,IAAAA,QAAA;AAAA,MACE,MAAQ;AAAA,MACR,SAAW;AAAA,MACX,aAAe;AAAA,MACf,SAAW;AAAA,MACX,eAAiB;AAAA,QACf,QAAU;AAAA,MACZ;AAAA,MACA,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,iBAAiB;AAAA,QACjB,KAAO;AAAA,QACP,MAAQ;AAAA,QACR,iBAAiB;AAAA,MACnB;AAAA,MACA,cAAgB;AAAA,QACd,yBAAyB;AAAA,QACzB,gCAAgC;AAAA,QAChC,wBAAwB;AAAA,QACxB,4BAA4B;AAAA,QAC5B,2BAA2B;AAAA,QAC3B,mCAAmC;AAAA,QACnC,oBAAoB;AAAA,QACpB,8BAA8B;AAAA,QAC9B,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,MAAQ;AAAA,QACR,YAAc;AAAA,QACd,QAAU;AAAA,MACZ;AAAA,IACF;AAAA;AAAA;;;ACxDA,uBAAwB;AACxB,IAAAC,eAAiB;AACjB,gBAAe;AACf,IAAAC,mBAAe;AACf,mBAAkB;AAClB,2BAAyB;AAEzB,iBAA0C;AAC1C,2BAAiC;AACjC,4BAAyC;;;ACIzC,sBAAe;AACf,qBAAiB;AACjB,kBAAiB;;;ACJV,IAAM,eAAe;AAAA,EAC1B,yBAAyB;AAAA,EACzB,gCAAgC;AAAA,EAChC,0CAA0C;AAAA,EAC1C,uCAAuC;AAAA,EACvC,wBAAwB;AAAA,EACxB,4BAA4B;AAAA,EAC5B,2BAA2B;AAAA,EAC3B,0BAA0B;AAAA,EAC1B,6BAA6B;AAAA,EAC7B,wCAAwC;AAC1C;AAOO,IAAM,eAAe;AAAA,EAC1B,8BAA8B;AAAA,EAC9B,4BAA4B;AAAA,EAC5B,qBAAqB;AAAA,EACrB,sBAAsB;AAAA,EACtB,oBAAoB;AAAA,EACpB,uBAAuB;AAAA,EACvB,uBAAuB;AAAA,EACvB,sBAAsB;AAAA,EACtB,0BAA0B;AAC5B;;;ADZA,eAAsB,wBAAwB,WAAkC;AAC9E,QAAM,UAAU,YAAAC,QAAK,KAAK,WAAW,cAAc;AACnD,QAAM,UAAU,MAAM,gBAAAC,QAAG,SAAS,SAAS,OAAO;AAClD,QAAM,MAAM,KAAK,MAAM,OAAO;AAE9B,QAAM,eACJ,OAAO,IAAI,iBAAiB,YAAY,IAAI,iBAAiB,OACzD,EAAE,GAAI,IAAI,aAAwC,IAClD,CAAC;AACP,QAAM,kBACJ,OAAO,IAAI,oBAAoB,YAAY,IAAI,oBAAoB,OAC/D,EAAE,GAAI,IAAI,gBAA2C,IACrD,CAAC;AACP,QAAM,UACJ,OAAO,IAAI,YAAY,YAAY,IAAI,YAAY,OAC/C,EAAE,GAAI,IAAI,QAAmC,IAC7C,CAAC;AAKP,aAAW,CAAC,SAAS,aAAa,KAAK,OAAO,QAAQ,YAAY,GAAG;AACnE,QAAI,WAAW,cAAc;AAC3B,mBAAa,OAAO,IAAI;AAAA,IAC1B;AACA,QAAI,WAAW,iBAAiB;AAC9B,sBAAgB,OAAO,IAAI;AAAA,IAC7B;AAAA,EACF;AAGA,SAAO,OAAO,cAAc;AAAA,IAC1B,yBAAyB,aAAa,uBAAuB;AAAA,IAC7D,gCAAgC,aAAa,8BAA8B;AAAA,IAC3E,0CACE,aAAa,wCAAwC;AAAA,IACvD,uCAAuC,aAAa,qCAAqC;AAAA,IACzF,wBAAwB,aAAa,sBAAsB;AAAA,IAC3D,4BAA4B,aAAa,0BAA0B;AAAA,IACnE,2BAA2B,aAAa,yBAAyB;AAAA,IACjE,0BAA0B,aAAa,wBAAwB;AAAA,IAC/D,6BAA6B,aAAa,2BAA2B;AAAA,IACrE,wCAAwC,aAAa,sCAAsC;AAAA,IAC3F,8BAA8B,aAAa,4BAA4B;AAAA,IACvE,KAAK;AAAA,EACP,CAAC;AAGD,SAAO,OAAO,iBAAiB;AAAA,IAC7B,wBAAwB;AAAA,EAC1B,CAAC;AAGD,SAAO,OAAO,SAAS;AAAA,IACrB,aAAa;AAAA,IACb,eAAe;AAAA,IACf,cAAc;AAAA,IACd,UAAU;AAAA,IACV,QAAQ;AAAA,EACV,CAAC;AAED,MAAI,eAAe;AACnB,MAAI,kBAAkB;AACtB,MAAI,UAAU;AAEd,QAAM,gBAAAA,QAAG,UAAU,SAAS,KAAK,UAAU,KAAK,MAAM,CAAC,IAAI,MAAM,OAAO;AAC1E;AAUA,eAAsB,wBAAwB,WAAkC;AAC9E,QAAM,UAAU,YAAAD,QAAK,KAAK,WAAW,iBAAiB;AACtD,QAAM,UAAU,MAAM,gBAAAC,QAAG,SAAS,SAAS,OAAO;AAClD,QAAM,SAAS,eAAAC,QAAK,KAAK,SAAS,EAAE,QAAQ,eAAAA,QAAK,YAAY,CAAC;AAE9D,SAAO,OAAO,CAAC;AAEf,QAAM,gBAAAD,QAAG,UAAU,SAAS,eAAAC,QAAK,KAAK,QAAQ,EAAE,WAAW,IAAI,CAAC,CAAC;AACnE;AAMA,eAAsB,+BACpB,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,SAAS,EAAE,QAAQ,eAAAA,QAAK,YAAY,CAAC;AAE9D,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;AAAA,IACpB,GAAI,MAAM,QAAQ,OAAO,YAAY,IAAI,OAAO,eAAe,CAAC;AAAA,IAChE;AAAA,EACF;AAEA,QAAM,gBAAAD,QAAG,UAAU,SAAS,eAAAC,QAAK,KAAK,QAAQ,EAAE,WAAW,IAAI,CAAC,CAAC;AACnE;AAiBA,eAAsB,wBAAwB,WAAkC;AAC9E,QAAM,eAAe,YAAAF,QAAK,KAAK,WAAW,aAAa;AACvD,QAAM,gBAAAC,QAAG,UAAU,YAAY;AAE/B,QAAM,iBAAiB,MAAM,gBAAAA,QAAG,MAAM,YAAY;AAClD,MAAI,eAAe,eAAe,GAAG;AACnC,UAAM,IAAI,MAAM,0EAAqE;AAAA,EACvF;AAEA,QAAM,YAAY,YAAAD,QAAK,KAAK,cAAc,QAAQ;AAClD,QAAM,gBAAAC,QAAG,UAAU,SAAS;AAC5B,MAAI,MAAM,gBAAAA,QAAG,WAAW,SAAS,GAAG;AAClC,UAAM,cAAc,MAAM,gBAAAA,QAAG,MAAM,SAAS;AAC5C,QAAI,YAAY,eAAe,GAAG;AAChC,YAAM,IAAI,MAAM,gFAA2E;AAAA,IAC7F;AAAA,EACF;AAIA,QAAM,aAAa,YAAAD,QAAK,KAAK,cAAc,aAAa;AACxD,MAAI,iBAA0C,CAAC;AAC/C,MAAI,gBAAAC,QAAG,WAAW,UAAU,GAAG;AAC7B,QAAI;AACF,uBAAiB,KAAK,MAAM,MAAM,gBAAAA,QAAG,SAAS,YAAY,OAAO,CAAC;AAAA,IAIpE,QAAQ;AAAA,IAER;AAAA,EACF;AACA,MAAI,MAAM,gBAAAA,QAAG,WAAW,UAAU,GAAG;AACnC,UAAM,cAAc,MAAM,gBAAAA,QAAG,MAAM,UAAU;AAC7C,QAAI,YAAY,eAAe,GAAG;AAChC,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,QAAM,gBAAAA,QAAG;AAAA,IACP;AAAA,IACA,KAAK,UAAU,EAAE,GAAG,gBAAgB,aAAa,KAAK,GAAG,MAAM,CAAC,IAAI;AAAA,IACpE;AAAA,EACF;AAKA,QAAM,iBAAiB,YAAAD,QAAK,KAAK,cAAc,kBAAkB;AACjE,MAAI,MAAM,gBAAAC,QAAG,WAAW,cAAc,GAAG;AACvC,UAAM,WAAW,MAAM,gBAAAA,QAAG,MAAM,cAAc;AAC9C,QAAI,SAAS,eAAe,GAAG;AAC7B,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,MAAI,CAAC,gBAAAA,QAAG,WAAW,cAAc,GAAG;AAClC,UAAM,YAAY;AAAA,MAChB,aAAa;AAAA,QACX,uBAAuB;AAAA,UACrB,MAAM;AAAA,UACN,SAAS;AAAA,UACT,MAAM,CAAC,QAAQ,qBAAqB;AAAA,UACpC,SAAS;AAAA,UACT,KAAK;AAAA,QACP;AAAA,MACF;AAAA,IACF;AACA,UAAM,gBAAAA,QAAG,UAAU,gBAAgB,KAAK,UAAU,WAAW,MAAM,CAAC,IAAI,MAAM,OAAO;AAAA,EACvF;AACF;AAmBO,SAAS,eAAe,SAAwC;AACrE,QAAM,EAAE,aAAa,SAAS,UAAU,cAAc,WAAW,QAAQ,IAAI;AAG7E,QAAM,wBAAwB,UAC1B;AAAA;AAAA,0CAAoE,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA6G,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAqO,QAAQ;AAAA;AAAA;AAAA,mBAA2F,QAAQ;AAAA,gBAA6B,YAAY,OAAO,OAAO,CAAC,EAAE,YAAY,KAAK,YAAY,OAAO,MAAM,CAAC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YAAmX,YAAY,OAAO,OAAO,CAAC,EAAE,YAAY,KAAK,YAAY,OAAO,MAAM,CAAC,CAAC,8BAA8B,QAAQ;AAAA,8CAA0D,QAAQ;AAAA;AAAA,sBAAmC,YAAY,OAAO,OAAO,CAAC,EAAE,YAAY,KAAK,YAAY,OAAO,MAAM,CAAC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAC3wC;AAGJ,QAAM,cAAc,UAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IACA;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,IACA;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,EAAw4B,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;AAAA;AAAA;AAAA;AAAA,EAAm2E,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,EAA4iD,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAC/1J;;;ID5PA,gDAAyB;AAEzB,IAAM,EAAE,QAAQ,IAAI;AAuBpB,eAAe,gBAAgB,cAAsB,UAAiC;AACpF,QAAM,MAAM,aAAAE,QAAK,QAAQ,WAAW,MAAM,aAAa,OAAO,YAAY;AAC1E,QAAM,iBAAAC,QAAG,KAAK,KAAK,QAAQ;AAC7B;AAMA,eAAe,WACb,WACA,UACA,UACwD;AACxD,QAAM,eAAe,aAAAD,QAAK,QAAQ,QAAQ;AAE1C,MAAI,CAAC,iBAAAC,QAAG,WAAW,YAAY,GAAG;AAChC,UAAM,IAAI,MAAM,wBAAwB,YAAY,EAAE;AAAA,EACxD;AAEA,QAAM,eAAe,aAAAD,QAAK,SAAS,YAAY;AAC/C,QAAM,cAAc,YAAY,aAAAA,QAAK,SAAS,cAAc,aAAAA,QAAK,QAAQ,YAAY,CAAC;AAEtF,QAAM,WAAW,aAAAA,QAAK,KAAK,WAAW,OAAO;AAC7C,QAAM,iBAAAC,QAAG,UAAU,QAAQ;AAC3B,QAAM,iBAAAA,QAAG,KAAK,cAAc,aAAAD,QAAK,KAAK,UAAU,YAAY,CAAC;AAE7D,SAAO,EAAE,cAAc,YAAY;AACrC;AAMA,eAAe,OAAO,WAAmB,SAA0C;AACjF,QAAM,UAAU,aAAAA,QAAK,SAAS,SAAS;AAEvC,UAAQ,IAAI,aAAAE,QAAM,KAAK,KAAK,4CAAqC,CAAC;AAOlE,QAAM,eAAgC;AAAA,IACpC,MAAM,QAAQ,QAAQ;AAAA,IACtB,YAAY;AAAA;AAAA,IACZ,GAAI,QAAQ,UAAU,UAAa,EAAE,OAAO,QAAQ,MAAM;AAAA,IAC1D,GAAI,QAAQ,UAAU,UAAa,EAAE,OAAO,QAAQ,MAAM;AAAA,IAC1D,GAAI,QAAQ,UAAU,UAAa,EAAE,OAAO,QAAQ,MAAM;AAAA,IAC1D,GAAI,QAAQ,QAAQ,UAAa,EAAE,eAAe,QAAQ,IAAI;AAAA,EAChE;AAEA,YAAM,qBAAS,WAAW,YAAY;AACtC,UAAQ,IAAI,aAAAA,QAAM,MAAM,oEAA+D,CAAC;AASxF,QAAM,wBAAwB,SAAS;AACvC,UAAQ,IAAI,aAAAA,QAAM,MAAM,8CAAuC,CAAC;AAGhE,QAAM,YAAY,KAAK;AAAA,IACrB,MAAM,iBAAAD,QAAG,SAAS,aAAAD,QAAK,KAAK,WAAW,cAAc,GAAG,OAAO;AAAA,EACjE;AACA,QAAM,cAAc,OAAO;AAAA,IACzB,OAAO,UAAU,iBAAiB,YAAY,UAAU,iBAAiB,OACpE,UAAU,eACX,CAAC;AAAA,EACP,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,kBAAkB,CAAC,EAAE;AAClD,UAAQ,IAAI,aAAAE,QAAM,IAAI,mCAA8B,WAAW,gCAAgC,CAAC;AAEhG,UAAQ,IAAI,aAAAA,QAAM,KAAK,8DAAuD,CAAC;AAC/E,MAAI,CAAC,QAAQ,aAAa;AACxB,QAAI;AACF,yCAAS,mCAAmC;AAAA,QAC1C,KAAK;AAAA,QACL,OAAO;AAAA,QACP,SAAS;AAAA,MACX,CAAC;AACD,cAAQ,IAAI,aAAAA,QAAM,MAAM,+BAA0B,CAAC;AAAA,IACrD,SAAS,KAAc;AACrB,YAAM,YACJ,eAAe,UACd,IAAI,QAAQ,SAAS,WAAW,KAAK,IAAI,QAAQ,SAAS,SAAS;AACtE,cAAQ;AAAA,QACN,aAAAA,QAAM,IAAI,wEAAmE;AAAA,MAC/E;AACA,cAAQ;AAAA,QACN,aAAAA,QAAM,IAAI,2EAAsE;AAAA,MAClF;AACA,UAAI,WAAW;AACb,gBAAQ;AAAA,UACN,aAAAA,QAAM,OAAO,mEAAmE;AAAA,QAClF;AAAA,MACF;AACA,cAAQ;AAAA,QACN,aAAAA,QAAM,OAAO,mEAAmE;AAAA,MAClF;AACA,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,OAAO;AACL,YAAQ,IAAI,aAAAA,QAAM,IAAI,oEAA0D,CAAC;AAAA,EACnF;AAGA,QAAM,iBAA6C;AACnD,YAAM,uCAAiB,eAAe;AAAA,IACpC;AAAA,IACA,aAAa,QAAQ,QAAQ,aAAAF,QAAK,SAAS,SAAS;AAAA,IACpD,WAAW,QAAQ,SAAS,QAAQ,QAAQ,aAAAA,QAAK,SAAS,SAAS;AAAA,IACnE,SAAS,QAAQ,SAAS;AAAA,IAC1B,aAAa,CAAC;AAAA,IACd;AAAA,EACF,CAAC;AAUD,QAAM;AAAA,IACJ;AAAA,IACA,aAAAA,QAAK,KAAK,WAAW,OAAO,eAAe,eAAe;AAAA,EAC5D;AAKA,QAAM,gBAAgB,eAAe,aAAAA,QAAK,KAAK,WAAW,SAAS,aAAa,CAAC;AAGjF,QAAM,gBAAgB,kBAAkB,aAAAA,QAAK,KAAK,WAAW,gBAAgB,CAAC;AAG9E,QAAM,iBAAAC,QAAG,UAAU,aAAAD,QAAK,KAAK,WAAW,KAAK,CAAC;AAC9C,QAAM,gBAAgB,gBAAgB,aAAAA,QAAK,KAAK,WAAW,OAAO,cAAc,CAAC;AAGjF,QAAM,gBAAgB,aAAa,aAAAA,QAAK,KAAK,WAAW,WAAW,CAAC;AAGpE,QAAM,iBAAAC,QAAG,UAAU,aAAAD,QAAK,KAAK,WAAW,SAAS,CAAC;AAClD,QAAM,gBAAgB,eAAe,aAAAA,QAAK,KAAK,WAAW,WAAW,aAAa,CAAC;AACnF,QAAM;AAAA,IACJ;AAAA,IACA,aAAAA,QAAK,KAAK,WAAW,WAAW,uBAAuB;AAAA,EACzD;AAMA,QAAM,iBAAAC,QAAG,UAAU,aAAAD,QAAK,KAAK,WAAW,OAAO,WAAW,CAAC;AAC3D,QAAM;AAAA,IACJ;AAAA,IACA,aAAAA,QAAK,KAAK,WAAW,OAAO,aAAa,UAAU;AAAA,EACrD;AAEA,UAAQ,IAAI,aAAAE,QAAM,MAAM,uDAAuD,CAAC;AAMhF,QAAM,wBAAwB,SAAS;AAMvC,MAAI,WAAiE;AACrE,QAAM,WAAW;AAEjB,MAAI,QAAQ,QAAQ,QAAQ,KAAK,SAAS,GAAG;AAC3C,eAAW,YAAY,QAAQ,MAAM;AACnC,iBAAW,MAAM,WAAW,WAAW,UAAU,QAAQ,QAAQ;AACjE,YAAM;AAAA,QACJ;AAAA,QACA,SAAS;AAAA,QACT,SAAS;AAAA,QACT,QAAQ,OAAO,WAAW;AAAA,MAC5B;AAAA,IACF;AACA,YAAQ,IAAI,aAAAA,QAAM,MAAM,aAAM,QAAQ,KAAK,MAAM,kCAAkC,CAAC;AACpF,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,aAAAF,QAAK,KAAK,WAAW,OAAO;AAC7C,UAAM,iBAAAC,QAAG,UAAU,QAAQ;AAC3B,UAAM,gBAAgB,iBAAiB,aAAAD,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,aAAAE,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,GAAI,UAAU,gBAAgB,UAAa,EAAE,UAAU,SAAS,YAAY;AAAA,IAC5E,GAAI,UAAU,iBAAiB,UAAa,EAAE,cAAc,SAAS,aAAa;AAAA,IAClF,WAAW,CAAC,QAAQ;AAAA,IACpB,SAAS,CAAC,CAAC,QAAQ;AAAA,EACrB,CAAC;AAED,QAAM,iBAAAD,QAAG,UAAU,aAAAD,QAAK,KAAK,WAAW,WAAW,GAAG,aAAa;AACnE,UAAQ,IAAI,aAAAE,QAAM,MAAM,6BAAsB,CAAC;AAM/C,QAAM,cAAuC;AAAA,IAC3C,aAAa;AAAA,IACb,aAAa,QAAQ,QAAQ;AAAA,IAC7B,aAAa;AAAA,IACb,SAAS;AAAA,EACX;AAEA,MAAI,UAAU;AACZ,gBAAY,WAAW,SAAS,SAAS,YAAY;AACrD,gBAAY,WAAW,SAAS;AAAA,EAClC;AAEA,cAAY,QAAQ,QAAQ,SAAS;AAErC,QAAM,iBAAiB,aAAAF,QAAK,KAAK,WAAW,cAAc;AAC1D,QAAM,iBAAAC,QAAG,UAAU,cAAc;AACjC,QAAM,iBAAAA,QAAG;AAAA,IACP,aAAAD,QAAK,KAAK,gBAAgB,mBAAmB;AAAA,IAC7C,KAAK,UAAU,aAAa,MAAM,CAAC,IAAI;AAAA,IACvC;AAAA,EACF;AASA,QAAM,wBAAwB,SAAS;AACvC,UAAQ,IAAI,aAAAE,QAAM,MAAM,iEAA0D,CAAC;AAMnF,QAAM,SAAS,aAAAF,QAAK,SAAS,QAAQ,IAAI,GAAG,SAAS,KAAK;AAE1D,UAAQ,IAAI,aAAAE,QAAM,KAAK,KAAK,gDAAyC,CAAC;AACtE,UAAQ,IAAI,aAAAA,QAAM,MAAM,WAAW,MAAM,EAAE,CAAC;AAC5C,UAAQ,IAAI,aAAAA,QAAM,MAAM,gCAAgC,CAAC;AACzD,UAAQ,IAAI,aAAAA,QAAM,IAAI,0CAA0C,CAAC;AAEjE,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,yDAAkD,CAAC;AAC/E,YAAQ,IAAI,aAAAA,QAAM,IAAI,4CAA4C,CAAC;AAAA,EACrE;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;AAAA,IACC;AAAA,IACA;AAAA,EACF,EACC,OAAO,OAAO,WAAmB,YAA8B;AAC9D,UAAM,UAAU,UAAAC,QAAG,QAAQ;AAC3B,UAAM,YACJ,cAAc,MACV,aAAAH,QAAK,QAAQ,QAAQ,IAAI,GAAG,SAAS,IACrC,QAAQ,OACN,aAAAA,QAAK,QAAQ,QAAQ,IAAI,GAAG,QAAQ,IAAI,IACxC,QAAQ,IAAI;AAGpB,QAAI,CAAC,UAAU,WAAW,UAAU,aAAAA,QAAK,GAAG,KAAK,cAAc,SAAS;AACtE,cAAQ,KAAK,aAAAE,QAAM,OAAO,0DAAgD,SAAS,EAAE,CAAC;AAAA,IACxF;AAEA,UAAM,OAAO,WAAW,OAAO;AAAA,EACjC,CAAC;AAEH,QAAM,QAAQ,WAAW,QAAQ,IAAI;AACvC;AAEA,KAAK,EAAE,MAAM,CAAC,QAAiB;AAC7B,UAAQ,MAAM,aAAAA,QAAM,IAAI,yBAAoB,GAAG,GAAG;AAClD,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":["exports","module","import_path","import_fs_extra","path","fs","yaml","path","fs","chalk","os"]}

package/package.json CHANGED Viewed

@@ -1,8 +1,8 @@
 {
   "name": "@stackwright-pro/launch-stackwright-pro",
-  "version": "0.4.0-alpha.13",
+  "version": "0.4.0-alpha.133",
   "description": "Launch a new Stackwright Pro project with OpenAPI integration, auth, and the otter raft",
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {
     "access": "public"
   },
@@ -26,26 +26,26 @@
     "launch-stackwright-pro": "dist/index.js"
   },
   "dependencies": {
-    "@stackwright-pro/scaffold-hooks": "latest",
-    "@stackwright/cli": "^0.7.1-alpha.0",
-    "@stackwright/scaffold-core": "^0.1.0",
+    "@stackwright/cli": "^0.9.0",
+    "@stackwright/scaffold-core": "^0.3.3",
     "chalk": "^5.6.2",
-    "commander": "^14.0.3",
-    "fs-extra": "^11.3",
-    "js-yaml": "^4.1.0",
-    "@stackwright-pro/auth": "0.1.1-alpha.0",
-    "@stackwright-pro/auth-nextjs": "0.1.1-alpha.0",
-    "@stackwright-pro/mcp": "0.2.0-alpha.3",
-    "@stackwright-pro/openapi": "0.2.2-alpha.2",
-    "@stackwright-pro/otters": "1.0.0-alpha.11"
+    "commander": "^15.0.0",
+    "fs-extra": "^11.3.5",
+    "js-yaml": "^4.2.0",
+    "@stackwright-pro/auth": "0.2.0-alpha.21",
+    "@stackwright-pro/auth-nextjs": "0.3.0-alpha.10",
+    "@stackwright-pro/mcp": "0.2.0-alpha.95",
+    "@stackwright-pro/openapi": "0.3.0-alpha.34",
+    "@stackwright-pro/otters": "1.0.0-alpha.62",
+    "@stackwright-pro/scaffold-hooks": "1.0.0-alpha.16"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^24.0.0",
-    "typescript": "^5.0",
-    "tsup": "^8.5",
-    "vitest": "^4.0.18"
+    "@types/node": "^25.9.2",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
   },
   "scripts": {
     "build": "node ../../scripts/sync-versions.mjs && tsup",

package/templates/pro/_app.tsx CHANGED Viewed

@@ -6,7 +6,17 @@ import { registerDisplayComponents } from '@stackwright-pro/display-components';
 import { registerPulseComponents } from '@stackwright-pro/pulse';
 import { AuthProvider } from '@stackwright-pro/auth';
 import '@stackwright/ui-shadcn/styles.css';
-import authConfig from '../src/auth-config.json'; // Generated at build time by prebuild.js
+import authConfigRaw from '../src/auth-config.json'; // Generated at build time by prebuild.js
+// auth-config.json is written from stackwright.yml `auth:` section — it may be
+// sparse (e.g. `{}`) when roles haven't been configured yet, so we cast to the
+// full shape and use || fallbacks below.
+type AuthConfigShape = {
+  roles?: Array<{ name: string; permissions?: string[] }>;
+  protected_routes?: Array<{ path: string; roles: string[] }>;
+  public_routes?: string[];
+};
+const authConfig = authConfigRaw as AuthConfigShape;
 // Register Stackwright components
 registerNextJSComponents();
@@ -24,9 +34,9 @@ export default function App({ Component, pageProps }: AppProps) {
       user={user}
       session={session}
       rbacConfig={{
-        roles: authConfig.roles || [],
-        protected_routes: authConfig.protected_routes || [],
-        public_routes: authConfig.public_routes || [],
+        roles: authConfig.roles ?? [],
+        protected_routes: authConfig.protected_routes ?? [],
+        public_routes: authConfig.public_routes ?? [],
       }}
     >
       <Component {...pageProps} />

package/templates/pro/app/slug-page/page.tsx ADDED Viewed

@@ -0,0 +1,32 @@
+import {
+  generateStackwrightStaticParams,
+  getStackwrightPageData,
+} from '@stackwright/nextjs/server';
+import { notFound } from 'next/navigation';
+import { StackwrightPageClient } from '../_components/page-client';
+/**
+ * Filter out data-sink slugs produced by Pro prebuild plugins (_auth, _collections,
+ * _integrations, etc.). These files live in public/stackwright-content/ but are NOT
+ * page content — they are runtime data consumed by middleware and providers.
+ *
+ * The OSS generateStackwrightStaticParams() returns them because the RESERVED_FILES
+ * list in @stackwright/nextjs predates Pro's additionalSinks (swp-xyia / OSS #509).
+ * Filtering here keeps the Pro scaffold correct until the OSS package syncs its list.
+ */
+function filterProDataSinks(params: Array<{ slug: string[] }>): Array<{ slug: string[] }> {
+  return params.filter(({ slug }) => {
+    // Top-level _ prefixed slugs are always internal data files, never pages
+    if (slug.length === 1 && slug[0] !== undefined && slug[0].startsWith('_')) return false;
+    return true;
+  });
+}
+export const generateStaticParams = () => filterProDataSinks(generateStackwrightStaticParams());
+export default async function SlugPage({ params }: { params: Promise<{ slug: string[] }> }) {
+  const { slug } = await params;
+  const pageData = await getStackwrightPageData(slug);
+  if (!pageData) notFound();
+  return <StackwrightPageClient content={pageData} />;
+}

package/templates/pro/content.yml CHANGED Viewed

@@ -7,5 +7,5 @@ content:
         textSize: h1
         textColor: secondary
       textBlocks:
-        - text: Welcome to your new Stackwright Pro project. Edit pages/content.yml to update this page.
+        - text: Welcome to your new Stackwright Pro project. Run the otter raft to build your pages.
           textSize: h6

package/templates/pro/next.config.js CHANGED Viewed

@@ -13,6 +13,9 @@ module.exports = createStackwrightNextConfig({
     '@stackwright-pro/auth',
     '@stackwright-pro/auth-nextjs',
     '@stackwright-pro/display-components',
+    '@stackwright-pro/pulse',
+    '@stackwright-pro/workflow',
+    '@stackwright-pro/workflow-components',
   ],
   // YAML is parsed server-side at build time - no loader needed in browser
 });

package/templates/pro/prebuild.js CHANGED Viewed

@@ -1,105 +1,33 @@
 /**
  * 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.
+ * Thin wrapper around @stackwright/build-scripts runPrebuild() with the
+ * Pro plugin bundle. All theme/auth/collections/integrations data flows
+ * through the per-otter sibling YAML files (stackwright.theme.yml,
+ * stackwright.auth.yml, stackwright.collections.yml, stackwright.integrations.yml).
+ *
+ * Each domain otter calls its own `stackwright_pro_compile_*` MCP tool
+ * immediately after writing its source YAML — this script is the
+ * "compile everything from scratch" entry point invoked by predev/prebuild.
  */
+'use strict';
-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
- */
-function parseStackwrightYml(content) {
-  return yaml.load(content, { schema: yaml.CORE_SCHEMA });
-}
+const { runPrebuild } = require('@stackwright/build-scripts');
+const { proPlugins } = require('@stackwright-pro/build-scripts-plugins');
 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;
-    }
-    // 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');
-    }
-    // Extract integrations for OpenAPI plugin
-    const siteConfig = { integrations: fullConfig.integrations || [] };
-    if (!siteConfig.integrations.length) {
-      console.log('No integrations in stackwright.yml — skipping OpenAPI plugin.');
-      console.log('✓ Prebuild complete!');
-      return;
-    }
-    console.log(`Found ${siteConfig.integrations.length} integration(s). Running OpenAPI plugin...`);
-    const plugin = createOpenAPIPlugin();
-    if (plugin.beforeBuild) {
-      await plugin.beforeBuild({
-        siteConfig,
-        projectRoot,
-      });
-    }
-    console.log('✓ Prebuild complete!');
-  } catch (error) {
-    console.error('Prebuild failed:', error.message);
-    console.error(error.stack);
-    process.exit(1);
-  }
+  const projectRoot = path.resolve(__dirname, '..');
+  await runPrebuild({
+    projectRoot,
+    plugins: proPlugins,
+    unknownContentTypes: 'warn',
+  });
+  console.log('  Prebuild complete!');
 }
-main();
+main().catch((err) => {
+  console.error('Prebuild failed:', err.message);
+  console.error(err.stack);
+  process.exit(1);
+});

package/templates/pro/pro-providers.tsx ADDED Viewed

@@ -0,0 +1,46 @@
+'use client';
+import { registerAppRouterComponents } from '@stackwright/nextjs/app-router';
+import { registerShadcnComponents } from '@stackwright/ui-shadcn';
+import { registerDefaultIcons } from '@stackwright/icons';
+import { registerDisplayComponents } from '@stackwright-pro/display-components';
+import { registerPulseComponents } from '@stackwright-pro/pulse';
+import { AuthProvider } from '@stackwright-pro/auth/client';
+import '@stackwright/ui-shadcn/styles.css';
+// Generated by stackwright-prebuild. Run `pnpm predev` to regenerate when icons change.
+// This file is safe to commit — it is updated deterministically from your YAML content.
+import { registerSiteIcons } from '../../stackwright-generated/icons';
+import authConfigRaw from '../../src/auth-config.json';
+// auth-config.json is written from stackwright.yml `auth:` section by prebuild.js — it may be
+// sparse (e.g. `{}`) when roles haven't been configured yet, so we cast to the full shape
+// and use ?? fallbacks below.
+type AuthConfigShape = {
+  roles?: Array<{ name: string; permissions?: string[] }>;
+  protected_routes?: Array<{ path: string; roles: string[] }>;
+  public_routes?: string[];
+};
+const authConfig = authConfigRaw as AuthConfigShape;
+// Register Stackwright components (OSS + Pro)
+registerAppRouterComponents();
+registerSiteIcons();
+registerShadcnComponents();
+registerDefaultIcons();
+registerDisplayComponents();
+registerPulseComponents();
+export function Providers({ children }: { children: React.ReactNode }) {
+  return (
+    <AuthProvider
+      user={null}
+      session={null}
+      rbacConfig={{
+        roles: authConfig.roles ?? [],
+        protected_routes: authConfig.protected_routes ?? [],
+        public_routes: authConfig.public_routes ?? [],
+      }}
+    >
+      {children}
+    </AuthProvider>
+  );
+}

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

@@ -0,0 +1,103 @@
+// packages/launch-stackwright-pro/templates/pro/scripts/pro-content-plugin.js
+//
+// Pro content type plugin for @stackwright/build-scripts.
+//
+// CONFIRMED CASE B (@stackwright/build-scripts@0.5.0-alpha.0 / types@1.2.0-alpha.0):
+//   The currently shipped version of build-scripts does NOT read
+//   `contentItemSchemas` or `knownContentTypeKeys` from plugin objects.
+//   Those fields first appear in @stackwright/types@1.4.0+ and will be
+//   consumed by build-scripts@0.7.0 when that release ships.
+//
+// CURRENT BEHAVIOUR (pre-0.7.0):
+//   `unknownContentTypes: 'warn'` in prebuild.js already prevents hard failures
+//   for unrecognised content types. The `beforeBuild` stub below ensures this
+//   plugin is a syntactically valid, callable plugin (not silently ignored by
+//   the plugin runner) even though there is no side-effect to execute yet.
+//
+// TODO(@stackwright/build-scripts@0.7.0): Once 0.7.0 is the resolved floor,
+//   remove the `beforeBuild` stub — `contentItemSchemas` and
+//   `knownContentTypeKeys` will be consumed natively by the runtime and the
+//   plugin will suppress "unknown content type" warnings automatically.
+'use strict';
+const { z } = require('zod');
+const PRO_CONTENT_TYPE_KEYS = [
+  // @stackwright-pro/display-components
+  'metric_card',
+  'status_badge',
+  'stat_bar',
+  'sparkline',
+  'activity_feed',
+  'dashboard_grid',
+  'data_table',
+  'json_viewer',
+  'action_bar',
+  'section',
+  'collection_listing',
+  'detail_field',
+  'detail_view',
+  // @stackwright-pro/pulse
+  'pulse_provider',
+  'metric_card_pulse',
+  'data_table_pulse',
+  'status_badge_pulse',
+  'detail_card_pulse',
+  'stats_grid',
+  'map_pulse',
+  'alert_banner',
+  // @stackwright-pro/workflow-components
+  'workflow_mount',
+  // @stackwright-pro/display-components — navigation
+  'breadcrumb',
+  'page_header_bar',
+];
+// OSS content types that Pro otters augment with extra fields (e.g. `theme:`,
+// `auth:`). The strict OSS Zod schemas reject unknown properties, so we
+// register passthrough variants here. When build-scripts@0.7.0+ evaluates
+// the union [contentItemSchema, ...extraSchemas], the strict OSS schema
+// fails on the extra field and falls through to our passthrough version.
+const OSS_TYPES_WITH_PRO_EXTENSIONS = [
+  'text_block',
+  'alert',
+  'grid',
+  'main',
+  'collection_list',
+];
+const proContentPlugin = {
+  name: 'pro-content',
+  // --- Fields read by build-scripts@0.7.0+ (types@1.4.0+) ---
+  // Passthrough schemas — let each component handle its own prop validation
+  // at runtime. Registered here so the prebuild content-item validator
+  // accepts pro types without errors.
+  contentItemSchemas: [
+    // Pro-only types — fully passthrough (no OSS schema exists)
+    ...PRO_CONTENT_TYPE_KEYS.map((type) =>
+      z.object({ type: z.literal(type) }).passthrough()
+    ),
+    // OSS types with Pro extensions (theme:, auth:, etc.) — passthrough
+    // variants so the extra fields don't fail strict OSS validation.
+    ...OSS_TYPES_WITH_PRO_EXTENSIONS.map((type) =>
+      z.object({ type: z.literal(type) }).passthrough()
+    ),
+  ],
+  // String keys so the prebuild skips "unknown content type" warnings.
+  knownContentTypeKeys: [...PRO_CONTENT_TYPE_KEYS, ...OSS_TYPES_WITH_PRO_EXTENSIONS],
+  // --- Stub lifecycle hook (required for build-scripts@0.5.x / types@1.2.x) ---
+  // build-scripts@0.5.x only calls plugins that have beforeBuild or afterBuild.
+  // Without this stub the plugin object is accepted but never invoked, making
+  // the whole registration a silent no-op. The stub has no side-effects; its
+  // only purpose is to keep the plugin in the active lifecycle.
+  //
+  // Remove this stub when build-scripts@0.7.0 is the resolved floor (the
+  // 0.7.x runner calls plugins purely for their schema/key registration,
+  // not via beforeBuild/afterBuild).
+  beforeBuild: () => {},
+};
+module.exports = { proContentPlugin };