@stackwright-pro/launch-stackwright-pro 0.0.0-beta-20260417191149

package/README.md

@@ -0,0 +1,143 @@
+# launch-stackwright-pro
+
+🚢 Scaffold a new **Stackwright Pro** project in one command — complete with
+OpenAPI integration, RBAC auth, mock users, and the otter raft ready to build
+your site for you.
+
+## How It Works
+
+This package uses the **scaffold hooks system** (`@stackwright-pro/scaffold-hooks`)
+to automatically wire up Pro features:
+
+1. **Import hooks** → Auto-registers Pro packages during scaffolding
+2. **Call `scaffold()`** → Hooks automatically add:
+   - Pro dependencies (`@stackwright-pro/mcp`, `@stackwright-pro/otters`, etc.)
+   - MCP server configuration in `.code-puppy.json`
+   - Role-based dev scripts (`dev:admin`, `dev:analyst`, `dev:viewer`)
+3. **Post-processing** → Copies Pro templates, adds auth config, generates README
+4. **Auto-install** → `pnpm install` runs automatically after scaffolding —
+   citizen developers get a project ready to use without knowing what a package manager is
+
+## Quick Start
+
+```bash
+pnpx @stackwright-pro/launch-stackwright-pro my-app -y
+# Dependencies install automatically (~7s)
+cd my-app
+uvx stackwright-pro-raft   # Start the otter raft
+```
+
+### With an OpenAPI Spec
+
+```bash
+npx launch-stackwright-pro my-app --spec ./my-api.yaml --yes
+```
+
+The spec gets copied into `specs/` and wired into `stackwright.yml`. The
+prebuild script generates types & a client on the first `pnpm dev`.
+
+## What Gets Created
+
+```
+my-app/
+├── pages/
+│   ├── _app.tsx              # Pro _app with AuthProvider
+│   ├── _document.tsx
+│   ├── index.ts
+│   └── [...slug].tsx
+├── lib/
+│   └── mock-auth.ts          # Dev-mode mock users (admin/analyst/viewer)
+├── scripts/
+│   └── prebuild.js           # Reads stackwright.yml → runs OpenAPI plugin
+├── specs/                    # Only if --spec was provided
+│   └── <your-spec>.yaml
+├── node_modules/
+│   ├── @stackwright/otters/       # 🦦 OSS otters (brand, theme, page, foreman)
+│   └── @stackwright-pro/otters/   # 🦦 Pro otters (api, data, dashboard, foreman)
+├── stackwright.yml           # Theme + auth + integrations config
+├── next.config.js            # Pro config (transpile pro pkgs + yaml-loader)
+├── yaml.d.ts                 # TS declarations for YAML imports
+└── package.json              # OSS + Pro dependencies (via scaffold hooks)
+```
+
+## CLI Options
+
+```
+launch-stackwright-pro [directory]
+
+Options:
+  --name <name>        Project name (used in package.json)
+  --title <title>      Site title shown in the app bar and browser tab
+  --theme <themeId>    Theme ID (e.g., corporate, creative, minimal)
+  --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-name <name>   Name for the API integration (default: derived from filename)
+  -V, --version        Output the version number
+  -h, --help           Display help
+```
+
+## Role-Based Dev Scripts
+
+The scaffolded project includes convenience scripts for developing against
+different mock roles:
+
+```bash
+pnpm dev            # No mock auth — unauthenticated
+pnpm dev:admin      # MOCK_USER=admin
+pnpm dev:analyst    # MOCK_USER=analyst
+pnpm dev:viewer     # MOCK_USER=viewer
+```
+
+## What's Different from OSS `launch-stackwright`?
+
+| Feature             | OSS | Pro |
+| ------------------- | --- | --- |
+| Base scaffold       | ✅  | ✅  |
+| Otter raft          | ✅  | ✅  |
+| RBAC auth           | ❌  | ✅  |
+| Mock users          | ❌  | ✅  |
+| OpenAPI integration | ❌  | ✅  |
+| Prebuild code-gen   | ❌  | ✅  |
+| YAML config loading | ❌  | ✅  |
+
+## Scaffold Hooks
+
+The `@stackwright-pro/scaffold-hooks` package handles Pro package injection
+automatically via the hooks system:
+
+| Hook                      | What It Does                                             |
+| ------------------------- | -------------------------------------------------------- |
+| `pro-dependencies`        | Adds `@stackwright-pro/*` packages, fixes workspace refs |
+| `pro-mcp-config`          | Configures Pro MCP server in `.code-puppy.json`          |
+| `verify-pro-installation` | Prints success message after install                     |
+
+## Docs
+
+See the main [Stackwright Pro documentation](https://github.com/Per-Aspera-LLC/stackwright-pro)
+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
+```
+
+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
+```
+
+Executes phases sequentially via the Python state machine. Useful for debugging.

package/dist/index.js

@@ -0,0 +1,566 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "@stackwright-pro/launch-stackwright-pro",
+      version: "0.0.0-beta-20260417191149",
+      description: "Launch a new Stackwright Pro project with OpenAPI integration, auth, and the otter raft",
+      license: "MIT",
+      publishConfig: {
+        access: "public"
+      },
+      repository: {
+        type: "git",
+        url: "https://github.com/Per-Aspera-LLC/stackwright-pro"
+      },
+      keywords: [
+        "stackwright",
+        "stackwright-pro",
+        "scaffolding",
+        "openapi",
+        "government",
+        "hackathon"
+      ],
+      files: [
+        "dist",
+        "templates"
+      ],
+      bin: {
+        "launch-stackwright-pro": "dist/index.js"
+      },
+      scripts: {
+        build: "tsup",
+        dev: "tsup --watch",
+        test: "vitest run",
+        "test:coverage": "vitest run --coverage"
+      },
+      dependencies: {
+        "@stackwright-pro/scaffold-hooks": "latest",
+        "@stackwright/cli": "^0.7.1-alpha.0",
+        "@stackwright/scaffold-core": "^0.1.0",
+        chalk: "^5.6.2",
+        commander: "^14.0.3",
+        "fs-extra": "^11.3",
+        "js-yaml": "^4.1.0"
+      },
+      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"
+      }
+    };
+  }
+});
+
+// src/index.ts
+var import_commander = require("commander");
+var import_path = __toESM(require("path"));
+var import_os = __toESM(require("os"));
+var import_fs_extra = __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");
+(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);
+  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 }));
+}
+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 || {};
+  Object.assign(dependencies, {
+    "@stackwright-pro/mcp": "latest",
+    "@stackwright-pro/otters": "latest",
+    "@stackwright-pro/openapi": "latest",
+    "@stackwright-pro/auth": "latest",
+    "@stackwright-pro/auth-nextjs": "latest",
+    zod: "^3.23.0"
+  });
+  Object.assign(devDependencies, {
+    "@stoplight/prism-cli": "^5.14.2"
+  });
+  Object.assign(scripts, {
+    "dev:admin": "MOCK_USER=admin next dev",
+    "dev:analyst": "MOCK_USER=analyst next dev",
+    "dev:viewer": "MOCK_USER=viewer next dev",
+    prebuild: "node scripts/prebuild.js",
+    predev: "node scripts/prebuild.js"
+  });
+  pkg.dependencies = dependencies;
+  pkg.devDependencies = devDependencies;
+  pkg.scripts = scripts;
+  await import_fs_extra.default.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+}
+async function addIntegrationToStackwrightYml(targetDir, specName, specFilename, mockUrl) {
+  const ymlPath = import_path.default.join(targetDir, "stackwright.yml");
+  const content = await import_fs_extra.default.readFile(ymlPath, "utf-8");
+  const config = import_js_yaml.default.load(content);
+  const integration = {
+    type: "openapi",
+    name: specName,
+    spec: `./specs/${specFilename}`,
+    collections: []
+  };
+  if (mockUrl) {
+    integration.mockUrl = mockUrl;
+  }
+  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}`);
+  }
+  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;
+  const apiIntegrationSection = hasSpec ? `## \u{1F4E1} API Integration
+
+Your OpenAPI spec was copied to \`specs/${specFilename}\` and wired up in \`stackwright.yml\`.
+
+**What gets generated:**
+
+\`\`\`typescript
+// src/generated/${specName}/schemas.ts
+export const EquipmentSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  status: z.enum(['operational', 'maintenance', 'retired']),
+  // ... Zod validation for runtime safety
+});
+
+// src/generated/${specName}/types.ts
+export type Equipment = z.infer<typeof EquipmentSchema>;
+
+// src/generated/${specName}/client.ts
+export class ${specName.charAt(0).toUpperCase() + specName.slice(1)}Client {
+  async getEquipment(id: string): Promise<Equipment> {
+    // Auto-wired with auth, validation, error handling
+  }
+}
+\`\`\`
+
+**How it works:**
+1. The \`predev\` script in \`package.json\` runs \`prebuild.js\` before every \`pnpm dev\`
+2. Prebuild reads your spec and generates type-safe code
+3. You import and use it:
+
+\`\`\`typescript
+import { ${specName.charAt(0).toUpperCase() + specName.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 gear: Equipment = await client.getEquipment('123');
+\`\`\`
+
+No manual typing. No drift. No runtime surprises.
+
+` : "";
+  const mockSection = hasMock ? `## \u{1F3AD} Mock Server
+
+Prism mock server is configured to serve your API at **http://localhost:4010**.
+
+\`\`\`bash
+pnpm dev:mock    # Starts Prism + Next.js together
+\`\`\`
+
+This starts:
+1. Prism mock server on port 4010 (serves your OpenAPI spec)
+2. Next.js dev server on port 3000
+
+The generated API client is automatically configured to use the mock server.
+
+` : "";
+  const aiAgentsSection = hasOtters ? `## \u{1F9A6} AI Agents (The Otter Raft)
+
+Your project includes **SIX specialized AI agents** in \`node_modules/@stackwright-pro/otters/\`:
+
+- \`stackwright-pro-foreman-otter\` - Master coordinator that orchestrates all specialist otters
+- \`stackwright-pro-api-otter\` - Discovers entities from OpenAPI specs
+- \`stackwright-pro-auth-otter\` - Configures CAC/OIDC auth, RBAC rules, and audit middleware
+- \`stackwright-pro-data-otter\` - Configures endpoint filters & ISR revalidation
+- \`stackwright-pro-page-otter\` - Generates pages auto-wired with data, theme, and auth
+- \`stackwright-pro-dashboard-otter\` - Builds live data dashboards
+
+**Start the otter raft:**
+
+\`\`\`bash
+uvx 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.
+
+**Example session prompt:**
+
+"Build me a logistics dashboard from our OpenAPI spec. Connect to /equipment and /supplies endpoints."
+
+` : "";
+  return `# ${projectName}
+
+A Stackwright Pro application with role-based auth, OpenAPI integration, and intelligent AI agents.
+
+## \u{1F680} Quick Start
+
+\`\`\`bash
+# Start development server
+pnpm dev
+
+# Open your browser
+open http://localhost:3000
+\`\`\`
+
+## \u{1F465} Role-Based Development
+
+Stackwright Pro includes **mock authentication** for local development with three pre-configured roles:
+
+\`\`\`bash
+pnpm dev:admin     # Full permissions (*)
+pnpm dev:analyst   # Read & write data
+pnpm dev:viewer    # Read-only access
+\`\`\`
+
+**How it works:**
+- Each script sets the \`MOCK_USER\` environment variable
+- \`lib/mock-auth.ts\` intercepts requests and injects the appropriate user context
+- Your pages & API routes respect the RBAC rules in \`stackwright.yml\`
+- No backend required for testing auth flows! \u{1F389}
+
+**Pro tip:** Test your UI for all three roles to ensure proper permissions enforcement.
+
+${mockSection}## \u{1F4C1} Project Structure
+
+\`\`\`
+.
+\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 ...
+\u251C\u2500\u2500 lib/
+\u2502   \u2514\u2500\u2500 mock-auth.ts           # Dev-only auth mocking (no backend needed)
+\u251C\u2500\u2500 scripts/
+\u2502   \u2514\u2500\u2500 prebuild.js            # Auto-generates code from OpenAPI specs
+\u251C\u2500\u2500 specs/                     # OpenAPI spec files (if --spec was used)
+\u251C\u2500\u2500 src/
+\u2502   \u2514\u2500\u2500 generated/             # Auto-generated types & clients
+\u2502       \u2514\u2500\u2500 {specName}/
+\u2502           \u251C\u2500\u2500 schemas.ts     # Zod schemas for runtime validation
+\u2502           \u251C\u2500\u2500 types.ts       # TypeScript types
+\u2502           \u251C\u2500\u2500 client.ts      # API client with auth
+\u2502           \u2514\u2500\u2500 provider.ts    # CollectionProvider for Stackwright
+\u251C\u2500\u2500 .stackwright/
+\u2502   \u2514\u2500\u2500 otters/                # AI agent configs (4 specialized otters)
+\u251C\u2500\u2500 stackwright.yml            # Theme, auth, API integrations
+\u2514\u2500\u2500 package.json
+\`\`\`
+
+**Key Files:**
+- \`pages/_app.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
+
+## \u{1F4C4} Adding Pages
+
+Stackwright uses **YAML for content**, so you never touch JSX unless you want to.
+
+**Example:** Create \`pages/about/content.yml\`:
+
+\`\`\`yaml
+title: About Us
+description: Learn more about our mission
+
+sections:
+  - type: main
+    heading: Who We Are
+    body: |
+      We build mission-critical logistics systems for the Marine Corps.
+
+  - type: feature_list
+    title: Our Capabilities
+    features:
+      - icon: Security
+        title: Zero Trust
+        description: PKI-based auth with CAC/PIV
+      - icon: Api
+        title: Real-time Data
+        description: OpenAPI-backed, Zod-validated
+\`\`\`
+
+That's it. Navigate to \`/about\` and it just works. No routing config, no React components.
+
+${apiIntegrationSection}## \u{1F3A8} Customizing Theme
+
+Edit \`stackwright.yml\` to change colors, fonts, spacing \u2014 applies everywhere instantly.
+
+\`\`\`yaml
+theme:
+  id: my-theme
+  name: My Custom Theme
+  colors:
+    primary: "#C41E3A"        # Marine Corps red
+    background: "#FFFFFF"
+    text: "#1A1A1A"
+    accent: "#FFD700"         # Gold
+  typography:
+    fontFamily: "'Inter', sans-serif"
+    h1Size: "2.5rem"
+  spacing:
+    unit: 8
+\`\`\`
+
+No CSS files. No theme provider boilerplate. Just YAML. Stackwright handles the rest.
+
+## \u{1F510} Auth Configuration
+
+Stackwright Pro comes with **3 pre-configured roles** in \`stackwright.yml\`:
+
+\`\`\`yaml
+auth:
+  roles:
+    - name: ADMIN
+      permissions: ['*']                        # Full access
+    - name: ANALYST  
+      permissions: ['data:read', 'data:write']  # Read/write data
+    - name: VIEWER
+      permissions: ['data:read']                # Read-only
+\`\`\`
+
+**Gate content in your YAML:**
+
+\`\`\`yaml
+sections:
+  - type: button
+    label: Delete Equipment
+    action: /api/equipment/delete
+    auth:
+      required_roles: [ADMIN]
+      fallback: hide              # Options: hide, disable, show_message
+\`\`\`
+
+Only admins see the button. Analysts and viewers? Button doesn't exist in the DOM.
+
+**Route protection:**
+
+\`\`\`yaml
+auth:
+  protected_routes:
+    - path: /admin/*
+      roles: [ADMIN]
+    - path: /equipment/*  
+      roles: [ANALYST, ADMIN]
+  public_routes:
+    - /
+    - /about
+\`\`\`
+
+No middleware to write. No useAuth hooks to remember. RBAC is declarative.
+
+${aiAgentsSection}## \u{1F4DA} Learn More
+
+- **Stackwright Docs:** [https://stackwright.dev](https://stackwright.dev)
+- **OSS Repo:** [https://github.com/Per-Aspera-LLC/stackwright](https://github.com/Per-Aspera-LLC/stackwright)
+- **Pro Repo:** [https://github.com/Per-Aspera-LLC/stackwright-pro](https://github.com/Per-Aspera-LLC/stackwright-pro)
+
+**Questions?** File an issue or ping us in the discussions. We're here to help you ship faster.
+`;
+}
+async function launch(targetDir, options) {
+  const dirName = import_path.default.basename(targetDir);
+  console.log(import_chalk.default.cyan.bold("\n\u{1F6A2} Launching Stackwright Pro...\n"));
+  const scaffoldOpts = {
+    name: options.name || dirName,
+    ...options.title !== void 0 && { title: options.title },
+    ...options.theme !== void 0 && { theme: options.theme },
+    ...options.force !== void 0 && { force: options.force },
+    ...options.yes !== void 0 && { noInteractive: options.yes }
+  };
+  await (0, import_cli.scaffold)(targetDir, scaffoldOpts);
+  console.log(import_chalk.default.green("\u2705 Base project scaffolded (hooks added Pro deps + MCP config)"));
+  await addProDepsToPackageJson(targetDir);
+  console.log(import_chalk.default.green("\u{1F9A6} Pro packages added to package.json"));
+  console.log(import_chalk.default.cyan("\n\u{1F4E6} Installing dependencies (this takes a moment)..."));
+  if (!options.skipInstall) {
+    try {
+      (0, import_child_process.execSync)("pnpm install", { cwd: targetDir, stdio: "inherit", timeout: 12e4 });
+      console.log(import_chalk.default.green("\u2705 Dependencies installed"));
+    } catch {
+      console.warn(import_chalk.default.yellow("\u26A0\uFE0F  pnpm install failed \u2014 run it manually: pnpm install"));
+    }
+  } else {
+    console.log(import_chalk.default.dim("\u2139\uFE0F  Skipping install (--skip-install). Run: pnpm install"));
+  }
+  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),
+    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 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.mock) {
+      console.log(import_chalk.default.green("\u{1F3AD} Prism mock server configured"));
+    }
+  } else if (options.mock) {
+    console.log(
+      import_chalk.default.yellow(
+        "\u26A0\uFE0F  No spec provided with --mock. Using sample Petstore spec for demo. Replace with your API spec."
+      )
+    );
+    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"));
+    specInfo = { specFilename: "petstore.yaml", derivedName: "petstore" };
+    await addIntegrationToStackwrightYml(
+      targetDir,
+      specInfo.derivedName,
+      specInfo.specFilename,
+      MOCK_URL
+    );
+    console.log(import_chalk.default.green("\u{1F4E1} Sample Petstore spec wired up"));
+    console.log(import_chalk.default.green("\u{1F3AD} Prism mock server configured"));
+  }
+  const readmeContent = generateReadme({
+    projectName: options.name || dirName,
+    hasSpec: !!specInfo,
+    ...specInfo?.derivedName !== void 0 && { specName: specInfo.derivedName },
+    ...specInfo?.specFilename !== void 0 && { specFilename: specInfo.specFilename },
+    hasOtters: !options.skipOtters,
+    hasMock: !!options.mock
+  });
+  await import_fs_extra.default.writeFile(import_path.default.join(targetDir, "README.md"), readmeContent);
+  console.log(import_chalk.default.green("\u{1F4C4} README.md created"));
+  const relDir = import_path.default.relative(process.cwd(), targetDir) || ".";
+  console.log(import_chalk.default.cyan.bold("\n\u{1F389} All set! Here's what to do next:\n"));
+  console.log(import_chalk.default.white(`  1. cd ${relDir}`));
+  console.log(import_chalk.default.white("  2. uvx stackwright-pro-raft"));
+  console.log(import_chalk.default.dim("     (local dev: python -m stackwright_pro.raft.cli_adapter foreman)"));
+  if (specInfo) {
+    console.log(import_chalk.default.cyan(`
+\u{1F4E1} Your API spec was copied to specs/${specInfo.specFilename}`));
+    console.log(import_chalk.default.dim("   The prebuild will generate types & client on first `pnpm dev`."));
+  }
+  if (options.mock) {
+    console.log(import_chalk.default.cyan("\n\u{1F3AD} Run with mock server:"));
+    console.log(import_chalk.default.white("   pnpm dev:mock  # Starts Prism + Next.js"));
+  }
+  if (!options.skipOtters) {
+    console.log(import_chalk.default.cyan.bold("\n\u{1F9A6} The otter raft is ready to build your site!"));
+    console.log(import_chalk.default.dim("   Run the command above to get started.\n"));
+  }
+}
+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"
+  ).option(
+    "--spec-name <name>",
+    "Name for the API integration (default: derived from spec filename)"
+  ).option(
+    "--skip-install",
+    "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) {
+      console.warn(import_chalk.default.yellow(`\u26A0\uFE0F  Scaffolding outside your home directory: ${targetDir}`));
+    }
+    await launch(targetDir, options);
+  });
+  await program.parseAsync(process.argv);
+}
+main().catch((err) => {
+  console.error(import_chalk.default.red("\n\u274C Launch failed:"), err);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@stackwright-pro/launch-stackwright-pro\",\n  \"version\": \"0.0.0-beta-20260417191149\",\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\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"test\": \"vitest run\",\n    \"test:coverage\": \"vitest run --coverage\"\n  },\n  \"dependencies\": {\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';\n// Register Pro hooks (adds deps, MCP config, etc.)\n// Must be called before scaffold() to ensure hooks run in the CLI's scaffold-core context\nregisterProScaffoldHooks();\n\nconst { version } = require('../package.json') as { version: string };\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ninterface LaunchProOptions {\n  name?: string;\n  title?: string;\n  theme?: string;\n  force?: boolean;\n  skipOtters?: boolean;\n  skipInstall?: boolean;\n  yes?: boolean;\n  spec?: string;\n  specName?: string;\n  mock?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Template copying (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nasync function copyProTemplate(templateName: string, destPath: string): Promise<void> {\n  const src = path.resolve(__dirname, '..', 'templates', 'pro', templateName);\n  await fs.copy(src, destPath);\n}\n\n// ---------------------------------------------------------------------------\n// Auth config (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nasync function addAuthToStackwrightYml(targetDir: string): Promise<void> {\n  const ymlPath = path.join(targetDir, 'stackwright.yml');\n  const content = await fs.readFile(ymlPath, 'utf-8');\n  const config = yaml.load(content) as Record<string, unknown>;\n\n  config.auth = {\n    type: 'pki',\n    profile: 'dod_cac',\n    source: 'gateway_headers',\n    roles: [\n      { name: 'ADMIN', permissions: ['*'] },\n      { name: 'ANALYST', permissions: ['data:read', 'data:write'] },\n      { name: 'VIEWER', permissions: ['data:read'] },\n    ],\n    protected_routes: [{ path: '/*', roles: ['VIEWER', 'ANALYST', 'ADMIN'] }],\n    public_routes: ['/', '/getting-started'],\n  };\n\n  await fs.writeFile(ymlPath, yaml.dump(config, { lineWidth: 120 }));\n}\n\nasync function 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  // Pro runtime dependencies\n  Object.assign(dependencies, {\n    '@stackwright-pro/mcp': 'latest',\n    '@stackwright-pro/otters': 'latest',\n    '@stackwright-pro/openapi': 'latest',\n    '@stackwright-pro/auth': 'latest',\n    '@stackwright-pro/auth-nextjs': 'latest',\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) as Record<string, unknown>;\n\n  const integration: Record<string, unknown> = {\n    type: 'openapi',\n    name: specName,\n    spec: `./specs/${specFilename}`,\n    collections: [],\n  };\n\n  if (mockUrl) {\n    integration.mockUrl = mockUrl;\n  }\n\n  config.integrations = [integration];\n\n  await fs.writeFile(ymlPath, yaml.dump(config, { lineWidth: 120 }));\n}\n\n// ---------------------------------------------------------------------------\n// Spec handling (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nasync function handleSpec(\n  targetDir: string,\n  specPath: string,\n  specName?: string\n): Promise<{ specFilename: string; derivedName: string }> {\n  const resolvedSpec = path.resolve(specPath);\n\n  if (!fs.existsSync(resolvedSpec)) {\n    throw new Error(`Spec file not found: ${resolvedSpec}`);\n  }\n\n  const specFilename = path.basename(resolvedSpec);\n  const derivedName = specName || path.basename(specFilename, path.extname(specFilename));\n\n  const specsDir = path.join(targetDir, 'specs');\n  await fs.ensureDir(specsDir);\n  await fs.copy(resolvedSpec, path.join(specsDir, specFilename));\n\n  return { specFilename, derivedName };\n}\n\n// ---------------------------------------------------------------------------\n// README generator (Pro-specific - hooks can't handle these)\n// ---------------------------------------------------------------------------\n\nfunction generateReadme(options: {\n  projectName: string;\n  hasSpec: boolean;\n  specName?: string;\n  specFilename?: string;\n  hasOtters: boolean;\n  hasMock: boolean;\n}): string {\n  const { projectName, hasSpec, specName, specFilename, hasOtters, hasMock } = options;\n\n  // Build API Integration section if spec is present\n  const apiIntegrationSection = hasSpec\n    ? `## 📡 API Integration\n\nYour OpenAPI spec was copied to \\`specs/${specFilename}\\` and wired up in \\`stackwright.yml\\`.\n\n**What gets generated:**\n\n\\`\\`\\`typescript\n// src/generated/${specName}/schemas.ts\nexport const EquipmentSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  status: z.enum(['operational', 'maintenance', 'retired']),\n  // ... Zod validation for runtime safety\n});\n\n// src/generated/${specName}/types.ts\nexport type Equipment = z.infer<typeof EquipmentSchema>;\n\n// src/generated/${specName}/client.ts\nexport class ${specName!.charAt(0).toUpperCase() + specName!.slice(1)}Client {\n  async getEquipment(id: string): Promise<Equipment> {\n    // Auto-wired with auth, validation, error handling\n  }\n}\n\\`\\`\\`\n\n**How it works:**\n1. The \\`predev\\` script in \\`package.json\\` runs \\`prebuild.js\\` before every \\`pnpm dev\\`\n2. Prebuild reads your spec and generates type-safe code\n3. You import and use it:\n\n\\`\\`\\`typescript\nimport { ${specName!.charAt(0).toUpperCase() + specName!.slice(1)}Client } from '@/generated/${specName}/client';\nimport type { Equipment } from '@/generated/${specName}/types';\n\nconst client = new ${specName!.charAt(0).toUpperCase() + specName!.slice(1)}Client();\nconst gear: Equipment = await client.getEquipment('123');\n\\`\\`\\`\n\nNo manual typing. No drift. No runtime surprises.\n\n`\n    : '';\n\n  // Build mock server section if enabled\n  const mockSection = hasMock\n    ? `## 🎭 Mock Server\n\nPrism mock server is configured to serve your API at **http://localhost:4010**.\n\n\\`\\`\\`bash\npnpm dev:mock    # Starts Prism + Next.js together\n\\`\\`\\`\n\nThis starts:\n1. Prism mock server on port 4010 (serves your OpenAPI spec)\n2. Next.js dev server on port 3000\n\nThe generated API client is automatically configured to use the mock server.\n\n`\n    : '';\n\n  // Build AI Agents section if otters are present\n  const aiAgentsSection = hasOtters\n    ? `## 🦦 AI Agents (The Otter Raft)\n\nYour project includes **SIX specialized AI agents** in \\`node_modules/@stackwright-pro/otters/\\`:\n\n- \\`stackwright-pro-foreman-otter\\` - Master coordinator that orchestrates all specialist otters\n- \\`stackwright-pro-api-otter\\` - Discovers entities from OpenAPI specs\n- \\`stackwright-pro-auth-otter\\` - Configures CAC/OIDC auth, RBAC rules, and audit middleware\n- \\`stackwright-pro-data-otter\\` - Configures endpoint filters & ISR revalidation\n- \\`stackwright-pro-page-otter\\` - Generates pages auto-wired with data, theme, and auth\n- \\`stackwright-pro-dashboard-otter\\` - Builds live data dashboards\n\n**Start the otter raft:**\n\n\\`\\`\\`bash\nuvx stackwright-pro-raft\n\\`\\`\\`\n\n> **Local dev (before PyPI publish):** \\`python -m stackwright_pro.raft.cli_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\n**Example session prompt:**\n\n\"Build me a logistics dashboard from our OpenAPI spec. Connect to /equipment and /supplies endpoints.\"\n\n`\n    : '';\n\n  return `# ${projectName}\n\nA Stackwright Pro application with role-based auth, OpenAPI integration, and intelligent AI agents.\n\n## 🚀 Quick Start\n\n\\`\\`\\`bash\n# Start development server\npnpm dev\n\n# Open your browser\nopen http://localhost:3000\n\\`\\`\\`\n\n## 👥 Role-Based Development\n\nStackwright Pro includes **mock authentication** for local development with three pre-configured roles:\n\n\\`\\`\\`bash\npnpm dev:admin     # Full permissions (*)\npnpm dev:analyst   # Read & write data\npnpm dev:viewer    # Read-only access\n\\`\\`\\`\n\n**How it works:**\n- Each script sets the \\`MOCK_USER\\` environment variable\n- \\`lib/mock-auth.ts\\` intercepts requests and injects the appropriate user context\n- Your pages & API routes respect the RBAC rules in \\`stackwright.yml\\`\n- No backend required for testing auth flows! 🎉\n\n**Pro tip:** Test your UI for all three roles to ensure proper permissions enforcement.\n\n${mockSection}## 📁 Project Structure\n\n\\`\\`\\`\n.\n├── pages/\n│   ├── _app.tsx               # Pro version with AuthProvider + shadcn\n│   ├── index.tsx              # Home page (auto-generated by Stackwright)\n│   ├── about/\n│   │   └── content.yml        # Page content in YAML\n│   └── ...\n├── lib/\n│   └── mock-auth.ts           # Dev-only auth mocking (no backend needed)\n├── scripts/\n│   └── prebuild.js            # Auto-generates code from OpenAPI specs\n├── specs/                     # OpenAPI spec files (if --spec was used)\n├── src/\n│   └── generated/             # Auto-generated types & clients\n│       └── {specName}/\n│           ├── schemas.ts     # Zod schemas for runtime validation\n│           ├── types.ts       # TypeScript types\n│           ├── client.ts      # API client with auth\n│           └── provider.ts    # CollectionProvider for Stackwright\n├── .stackwright/\n│   └── otters/                # AI agent configs (4 specialized otters)\n├── stackwright.yml            # Theme, auth, API integrations\n└── package.json\n\\`\\`\\`\n\n**Key Files:**\n- \\`pages/_app.tsx\\` - Wraps your app with \\`AuthProvider\\` for RBAC\n- \\`stackwright.yml\\` - Single source of truth for theme, auth roles, and API wiring\n- \\`lib/mock-auth.ts\\` - Mocks CAC/PIV headers locally so you can test auth flows\n- \\`scripts/prebuild.js\\` - Runs before dev/build to generate types from your OpenAPI spec\n\n## 📄 Adding Pages\n\nStackwright uses **YAML for content**, so you never touch JSX unless you want to.\n\n**Example:** Create \\`pages/about/content.yml\\`:\n\n\\`\\`\\`yaml\ntitle: About Us\ndescription: Learn more about our mission\n\nsections:\n  - type: main\n    heading: Who We Are\n    body: |\n      We build mission-critical logistics systems for the Marine Corps.\n\n  - type: feature_list\n    title: Our Capabilities\n    features:\n      - icon: Security\n        title: Zero Trust\n        description: PKI-based auth with CAC/PIV\n      - icon: Api\n        title: Real-time Data\n        description: OpenAPI-backed, Zod-validated\n\\`\\`\\`\n\nThat's it. Navigate to \\`/about\\` and it just works. No routing config, no React components.\n\n${apiIntegrationSection}## 🎨 Customizing Theme\n\nEdit \\`stackwright.yml\\` to change colors, fonts, spacing — applies everywhere instantly.\n\n\\`\\`\\`yaml\ntheme:\n  id: my-theme\n  name: My Custom Theme\n  colors:\n    primary: \"#C41E3A\"        # Marine Corps red\n    background: \"#FFFFFF\"\n    text: \"#1A1A1A\"\n    accent: \"#FFD700\"         # Gold\n  typography:\n    fontFamily: \"'Inter', sans-serif\"\n    h1Size: \"2.5rem\"\n  spacing:\n    unit: 8\n\\`\\`\\`\n\nNo CSS files. No theme provider boilerplate. Just YAML. Stackwright handles the rest.\n\n## 🔐 Auth Configuration\n\nStackwright Pro comes with **3 pre-configured roles** in \\`stackwright.yml\\`:\n\n\\`\\`\\`yaml\nauth:\n  roles:\n    - name: ADMIN\n      permissions: ['*']                        # Full access\n    - name: ANALYST  \n      permissions: ['data:read', 'data:write']  # Read/write data\n    - name: VIEWER\n      permissions: ['data:read']                # Read-only\n\\`\\`\\`\n\n**Gate content in your YAML:**\n\n\\`\\`\\`yaml\nsections:\n  - type: button\n    label: Delete Equipment\n    action: /api/equipment/delete\n    auth:\n      required_roles: [ADMIN]\n      fallback: hide              # Options: hide, disable, show_message\n\\`\\`\\`\n\nOnly admins see the button. Analysts and viewers? Button doesn't exist in the DOM.\n\n**Route protection:**\n\n\\`\\`\\`yaml\nauth:\n  protected_routes:\n    - path: /admin/*\n      roles: [ADMIN]\n    - path: /equipment/*  \n      roles: [ANALYST, ADMIN]\n  public_routes:\n    - /\n    - /about\n\\`\\`\\`\n\nNo middleware to write. No useAuth hooks to remember. RBAC is declarative.\n\n${aiAgentsSection}## 📚 Learn More\n\n- **Stackwright Docs:** [https://stackwright.dev](https://stackwright.dev)\n- **OSS Repo:** [https://github.com/Per-Aspera-LLC/stackwright](https://github.com/Per-Aspera-LLC/stackwright)\n- **Pro Repo:** [https://github.com/Per-Aspera-LLC/stackwright-pro](https://github.com/Per-Aspera-LLC/stackwright-pro)\n\n**Questions?** File an issue or ping us in the discussions. We're here to help you ship faster.\n`;\n}\n\n// ---------------------------------------------------------------------------\n// Main launch flow\n// ---------------------------------------------------------------------------\n\nasync function launch(targetDir: string, options: LaunchProOptions): Promise<void> {\n  const dirName = path.basename(targetDir);\n\n  console.log(chalk.cyan.bold('\\n🚢 Launching Stackwright Pro...\\n'));\n\n  // ------------------------------------------------------------------\n  // 1. Scaffold base OSS project via @stackwright/cli\n  //    Hooks auto-handle: Pro deps, MCP config, role-based scripts\n  // ------------------------------------------------------------------\n\n  const scaffoldOpts: ScaffoldOptions = {\n    name: options.name || dirName,\n    ...(options.title !== undefined && { title: options.title }),\n    ...(options.theme !== undefined && { theme: options.theme }),\n    ...(options.force !== undefined && { force: options.force }),\n    ...(options.yes !== undefined && { noInteractive: options.yes }),\n  };\n\n  await scaffold(targetDir, scaffoldOpts);\n  console.log(chalk.green('✅ Base project scaffolded (hooks added Pro deps + MCP config)'));\n\n  // ------------------------------------------------------------------\n  // 1b. Run pnpm install — citizen devs shouldn't need to know this step exists\n  // ------------------------------------------------------------------\n\n  // 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  console.log(chalk.cyan('\\n📦 Installing dependencies (this takes a moment)...'));\n  if (!options.skipInstall) {\n    try {\n      execSync('pnpm install', { cwd: targetDir, stdio: 'inherit', timeout: 120_000 });\n      console.log(chalk.green('✅ Dependencies installed'));\n    } catch {\n      console.warn(chalk.yellow('⚠️  pnpm install failed — run it manually: pnpm install'));\n    }\n  } else {\n    console.log(chalk.dim('ℹ️  Skipping install (--skip-install). Run: pnpm install'));\n  }\n\n  // Fire postInstall hooks now that install has run\n  const dependencyMode: 'workspace' | 'standalone' = 'standalone';\n  await runScaffoldHooks('postInstall', {\n    targetDir,\n    projectName: options.name || path.basename(targetDir),\n    siteTitle: options.title || options.name || path.basename(targetDir),\n    themeId: options.theme || 'corporate',\n    packageJson: {},\n    dependencyMode,\n  });\n\n  // ------------------------------------------------------------------\n  // 2. Copy Pro templates (hooks can't handle these)\n  // ------------------------------------------------------------------\n\n  // Replace _app.tsx with Pro version (AuthProvider, shadcn, etc.)\n  await copyProTemplate('_app.tsx', path.join(targetDir, 'pages', '_app.tsx'));\n\n  // Add root content.yml for the home page\n  await copyProTemplate('content.yml', path.join(targetDir, 'pages', 'content.yml'));\n\n  // Replace next.config.js with Pro version (transpile pro pkgs)\n  await copyProTemplate('next.config.js', path.join(targetDir, 'next.config.js'));\n\n  // Add lib/mock-auth.ts\n  await fs.ensureDir(path.join(targetDir, 'lib'));\n  await copyProTemplate('mock-auth.ts', path.join(targetDir, 'lib', 'mock-auth.ts'));\n\n  // Add yaml.d.ts for TypeScript support\n  await copyProTemplate('yaml.d.ts', path.join(targetDir, 'yaml.d.ts'));\n\n  // Add scripts/prebuild.js\n  await fs.ensureDir(path.join(targetDir, 'scripts'));\n  await copyProTemplate('prebuild.js', path.join(targetDir, 'scripts', 'prebuild.js'));\n\n  console.log(chalk.green('🔐 Auth integration added (RBAC with 3 roles)'));\n\n  // ------------------------------------------------------------------\n  // 3. Add auth section to stackwright.yml\n  // ------------------------------------------------------------------\n\n  await addAuthToStackwrightYml(targetDir);\n\n  // ------------------------------------------------------------------\n  // 4. Handle --spec if provided\n  // ------------------------------------------------------------------\n\n  let specInfo: { specFilename: string; derivedName: string } | null = null;\n  const MOCK_URL = 'http://localhost:4010';\n\n  if (options.spec) {\n    specInfo = await handleSpec(targetDir, options.spec, options.specName);\n\n    // Pass mockUrl if --mock flag is set\n    await addIntegrationToStackwrightYml(\n      targetDir,\n      specInfo.derivedName,\n      specInfo.specFilename,\n      options.mock ? MOCK_URL : undefined\n    );\n    console.log(chalk.green('📡 OpenAPI integration wired up'));\n\n    if (options.mock) {\n      console.log(chalk.green('🎭 Prism mock server configured'));\n    }\n  } else if (options.mock) {\n    // --mock without --spec: use sample Petstore spec for demo\n    console.log(\n      chalk.yellow(\n        '⚠️  No spec provided with --mock. Using sample Petstore spec for demo. Replace with your API spec.'\n      )\n    );\n\n    const specsDir = path.join(targetDir, 'specs');\n    await fs.ensureDir(specsDir);\n    await copyProTemplate('petstore.yaml', path.join(specsDir, 'petstore.yaml'));\n\n    specInfo = { specFilename: 'petstore.yaml', derivedName: 'petstore' };\n\n    await addIntegrationToStackwrightYml(\n      targetDir,\n      specInfo.derivedName,\n      specInfo.specFilename,\n      MOCK_URL\n    );\n    console.log(chalk.green('📡 Sample Petstore spec wired up'));\n    console.log(chalk.green('🎭 Prism mock server configured'));\n  }\n\n  // ------------------------------------------------------------------\n  // 5. Generate README\n  // ------------------------------------------------------------------\n\n  const readmeContent = generateReadme({\n    projectName: options.name || dirName,\n    hasSpec: !!specInfo,\n    ...(specInfo?.derivedName !== undefined && { specName: specInfo.derivedName }),\n    ...(specInfo?.specFilename !== undefined && { specFilename: specInfo.specFilename }),\n    hasOtters: !options.skipOtters,\n    hasMock: !!options.mock,\n  });\n\n  await fs.writeFile(path.join(targetDir, 'README.md'), readmeContent);\n  console.log(chalk.green('📄 README.md created'));\n\n  // ------------------------------------------------------------------\n  // 6. Print next steps\n  // ------------------------------------------------------------------\n\n  const relDir = path.relative(process.cwd(), targetDir) || '.';\n\n  console.log(chalk.cyan.bold(\"\\n🎉 All set! Here's what to do next:\\n\"));\n  console.log(chalk.white(`  1. cd ${relDir}`));\n  console.log(chalk.white('  2. uvx stackwright-pro-raft'));\n  console.log(chalk.dim('     (local dev: python -m stackwright_pro.raft.cli_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"],"mappings":"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","names":["exports","module","path","fs","yaml","chalk","os"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@stackwright-pro/launch-stackwright-pro",
+  "version": "0.0.0-beta-20260417191149",
+  "description": "Launch a new Stackwright Pro project with OpenAPI integration, auth, and the otter raft",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Per-Aspera-LLC/stackwright-pro"
+  },
+  "keywords": [
+    "stackwright",
+    "stackwright-pro",
+    "scaffolding",
+    "openapi",
+    "government",
+    "hackathon"
+  ],
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "bin": {
+    "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",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "fs-extra": "^11.3",
+    "js-yaml": "^4.1.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"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  }
+}

package/templates/pro/_app.tsx

@@ -0,0 +1,35 @@
+import type { AppProps } from 'next/app';
+import { registerDefaultIcons } from '@stackwright/icons';
+import { registerNextJSComponents } from '@stackwright/nextjs';
+import { registerShadcnComponents } from '@stackwright/ui-shadcn';
+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
+
+// Register Stackwright components
+registerNextJSComponents();
+registerDefaultIcons();
+registerShadcnComponents();
+registerDisplayComponents();
+registerPulseComponents();
+
+export default function App({ Component, pageProps }: AppProps) {
+  const user = pageProps.user || null;
+  const session = pageProps.session || null;
+
+  return (
+    <AuthProvider
+      user={user}
+      session={session}
+      rbacConfig={{
+        roles: authConfig.roles || [],
+        protected_routes: authConfig.protected_routes || [],
+        public_routes: authConfig.public_routes || [],
+      }}
+    >
+      <Component {...pageProps} />
+    </AuthProvider>
+  );
+}

package/templates/pro/content.yml

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

package/templates/pro/mock-auth.ts

@@ -0,0 +1,42 @@
+/**
+ * Mock authentication for development mode.
+ *
+ * Use the MOCK_USER env var to select a role:
+ *   MOCK_USER=admin  pnpm dev
+ *   MOCK_USER=analyst pnpm dev
+ *   MOCK_USER=viewer  pnpm dev
+ *
+ * Or use the convenience scripts: pnpm dev:admin, pnpm dev:analyst, pnpm dev:viewer
+ */
+
+export const MOCK_USERS = {
+  admin: {
+    id: 'mock-admin-001',
+    name: 'Admin User',
+    email: 'admin@usmc.mil',
+    roles: ['ADMIN'],
+    edipi: '1234567890',
+  },
+  analyst: {
+    id: 'mock-analyst-001',
+    name: 'Analyst User',
+    email: 'analyst@usmc.mil',
+    roles: ['ANALYST'],
+    edipi: '0987654321',
+  },
+  viewer: {
+    id: 'mock-viewer-001',
+    name: 'Viewer User',
+    email: 'viewer@usmc.mil',
+    roles: ['VIEWER'],
+    edipi: '1122334455',
+  },
+} as const;
+
+export type MockRole = keyof typeof MOCK_USERS;
+
+export function getMockUser(role?: string) {
+  const key = role || process.env.MOCK_USER;
+  if (!key) return null;
+  return MOCK_USERS[key as MockRole] ?? null;
+}

package/templates/pro/next.config.js

@@ -0,0 +1,18 @@
+const { createStackwrightNextConfig } = require('@stackwright/nextjs');
+
+module.exports = createStackwrightNextConfig({
+  transpilePackages: [
+    '@stackwright/core',
+    '@stackwright/nextjs',
+    '@stackwright/themes',
+    '@stackwright/types',
+    '@stackwright/icons',
+    '@stackwright/collections',
+    '@stackwright/ui-shadcn',
+    '@stackwright-pro/openapi',
+    '@stackwright-pro/auth',
+    '@stackwright-pro/auth-nextjs',
+    '@stackwright-pro/display-components',
+  ],
+  // YAML is parsed server-side at build time - no loader needed in browser
+});

package/templates/pro/petstore.yaml

@@ -0,0 +1,60 @@
+openapi: 3.0.0
+info:
+  title: Petstore API (Sample)
+  description: A sample API for testing mock server functionality
+  version: 1.0.0
+servers:
+  - url: http://localhost:4010
+    description: Mock server
+paths:
+  /pets:
+    get:
+      summary: List all pets
+      operationId: listPets
+      tags:
+        - pets
+      responses:
+        '200':
+          description: A list of pets
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/Pet'
+  /pets/{id}:
+    get:
+      summary: Get a pet by ID
+      operationId: getPetById
+      tags:
+        - pets
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: integer
+      responses:
+        '200':
+          description: A single pet
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+        '404':
+          description: Pet not found
+components:
+  schemas:
+    Pet:
+      type: object
+      required:
+        - id
+        - name
+      properties:
+        id:
+          type: integer
+          format: int64
+        name:
+          type: string
+        tag:
+          type: string

package/templates/pro/prebuild.js

@@ -0,0 +1,105 @@
+/**
+ * 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.
+ */
+
+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);
+}
+
+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);
+  }
+}
+
+main();

package/templates/pro/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Next.js",
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "jsx": "preserve",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "checkJs": false,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "isolatedModules": true,
+    "jsxImportSource": "react",
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"],
+  "exclude": ["node_modules", "dist", "build", ".next"]
+}

package/templates/pro/yaml.d.ts

@@ -0,0 +1,18 @@
+/**
+ * TypeScript declarations for YAML modules
+ * Used when importing YAML files server-side (e.g., prebuild.js)
+ * 
+ * Note: We do NOT import YAML in browser code - auth-config.json is generated at build time
+ */
+
+declare module '*.yaml' {
+  const value: any;
+  export default value;
+  export const load: (content: string) => any;
+}
+
+declare module '*.yml' {
+  const value: any;
+  export default value;
+  export const load: (content: string) => any;
+}